Din AI-agent kontrollerer nå ethvert nettsted.
Med en full audit trail.
Drop en linje inn iCLAUDE.md, AGENTS.md, or .cursorrulesog din AI får ekte nettleserautomasjon: Gmail, Slack, LinkedIn, GitHub og andre nettsteder. Hvert klikk er signert, forseglet og verifiserbart. MCP-serveren er live.
Legg til trøst til ethvert prosjekt i ett kommando
curl -fsSL https://solaceagi.com/agents/claude.md >> CLAUDE.md
Solace legger til nettleserautomasjon instruksjoner til Código Claude-prosjektet ditt.
Step 0: Download & Install Solace Browser
Solace Browser is a desktop app that runs on your machine. Download it first, then your AI agent can control it via localhost:8888.
Download Solace Browser
Visit solaceagi.com/download and download the version for your operating system.
# Linux (one-line install): curl -sf https://storage.googleapis.com/solace-downloads/install.sh | bash # macOS / Windows: download the installer from # https://www.solaceagi.com/download
The download includes Solace Hub (desktop app) + Solace Runtime (local API on port 8888) + Solace Browser (Chromium fork with Yinyang sidebar).
Launch Solace Hub
# Start the Hub — it launches everything automatically ~/.solace/bin/solace-hub
The Hub sits in your system tray. It starts the local API server on port 8888 and opens the browser when ready.
Verify it's running
curl http://localhost:8888/api/v1/system/status
→ {"app_count": 22, "cloud_connected": false, "evidence_count": 0, "uptime_seconds": 5}
If you see JSON, your agent is ready to use Solace. No account needed. Free forever for local use.
Hver stor AI-koderingsagent, støttet
Last ned det riktige formatet for din AI-assistent. Hver fil forteller AI nøyaktig hvordan man bruker Solace navigere, klikke, fylle, ta skjermbilder og fange bevis. 21 formater støttes ut av boksen.
Código Claude
Dropp inn i dinCLAUDE.mdCódigo Claude vil bruke Solace Browser for enhver webautomasjon oppgave automatisk.
Codex de OpenAI
Dropp inn i dinAGENTS.mdCodex de OpenAI og ChatGPT-agenter leser denne filen for å forstå tilgjengelige verktøy og muligheter.
Mauszeiger
Dropp inn i din.cursorrulesMauszeiger vil nå Solace når du ber det om å samhandle med et nettsted.
Windsurfenen
Dropp inn i din.윈드서핑 규칙Windsurfen (Codeium) tar opp Solace-funksjoner akkurat som Mauszeiger samme format, null friktion.
Copilot på GitHub
Drop ind i.github/copilot-instructions.mdCopilot vil foreslå Solace API-opphør for nettleseroppgaver.
Hjelper
Pass som system prompt med--system-prompt solace-aider.mdHjelper vil røre alle nettinteraksjoner gjennom Solace Browser automatisk.
Weiterentwickeln.dev
Legg til din.continue/config.jsonFortsatt kommer Solace-browserautomasjon som et nativt verktøy i VS Code og JetBrains.
克莱恩
Dropp inn i dinدليل. يقرأ 克莱恩 قواعد المشروع عند بداية الجلسة — يتم تحميل khảیات Solace تلقائيًا لكل محادثة.克莱恩 leser prosjektreglene ved sesjonsstart Solace-funksjonene lastes automatisk for hver samtale.
根码
Plase i plass.roocode/Regeln/根码 (tidligere Roo-克莱恩) arver Solace-browserfunksjoner sammen med sine agentic kodingstilstand.
Gemini CLI:n är en av Googles mest populära.
Tillegg tilGEMINI.mdGoogles open-source-agent CLI tar opp Solace-instruksjonene på samme måte som den leser Claude'sCLAUDE.md.
Jules Jules Google Jules
Jules leserAGENTS.mdSolace-instruktioner vises automatisk når Jules håndterer en web-relatert oppgave i repoen din.
Redaktør Zed
Plasser regler i92Zeds AI-panel leser disse innfødt Solace blir tilgjengelig for Zed AI-assistenten umiddelbart.
Amazon Q-utvikler
Tillegg til.amazonq/rules/solace.mdAmazon Q-utvikler leser markdown-reglemfiler fra dette kataloget for hver kodingsøkt i prosjektet ditt.
JetBrains KI
Tillegg til.idea/ai-guidelines.mdJetBrains KI Assistant leser denne filen over IntelliJ, PyCharm, WebStorm og alle JetBrains IDEs.
O fonte de dados Cody
Placerer sammenheng i sammenheng.cody/context/solace.mdCody inkluderer denne filen i sin henting kontekst Solace instruksjoner vises i hver Cody samtale.
塔比尼
Konfigurere via. ملف تخصيص 塔比尼 يسمح لك بتعليم فريقك أدواته — بما في ذلك أتمتة متصفح Solace Browser.塔比尼's personaliseringsfil lar deg lære det ditt teams verktøykjede, inkludert Solace-browserautomasjon.
Répondre à l'AI
Legg til din.replit をreplitする をreplitするFilen er i filen.[ai]Repliser AI leser prosjektkontext fra her Solace blir tilgjengelig i hvert Repliseringsarbeidsområde.
Devin est un homme. est un homme.
Plase i plass.devin/Handling-Anleitungen/Devin est un homme. leser prosjektspillbøker før han starter langtidsoppgaver Solace-browserverktøy er tilgjengelige for enhver webarbeidsflyt.
Fabrikdroid
Fabrikken leserAGENTS.md Og og og og .fabrik/Droid-agenter arver Solace-funksjoner når de automatiserer programvareutviklingsarbeidsflyter.
Kilo Code Kilo Kilo
Tillegg til.kilocode/rules/ . .Kilo Code Kilo følger samme prosjektreglermønster som 克莱恩 Solace instruksjonslast for hver agentisk kodingsøkt.
llms.txt
Jeremy Howard standard for LLM-lesbare nettstedbeskrivelser.Drop i prosjektroten for enhver LLM for å forstå Solace.
Download llms.txtHva er Inside the CLAUDE.md Snippet
Her er Código Claude-snippet og legger den inn i prosjektet ditt, og agenten din forstår umiddelbart alle 14 Solace-API'er, MCP-serveren, e-signing og beste praksis.
# Solace Browser Integration # Source: solaceagi.com/agents/claude.md ## What Solace Is Chromium fork with a native Yinyang sidebar. Solace Hub starts first and exposes Yinyang Server on port 8888. Sessions persist. Evidence is hash-chained. MCP: 8 tools live now. ## Quick Start curl http://localhost:8888/api/status # → {"running": true, "status": "ready"} ## Core API (all POST, JSON body) navigate {"url": "...", "wait_for": "networkidle"} click {"selector": "..."} fill {"selector": "...", "value": "..."} screenshot {"full_page": true} → {"filepath": "artifacts/..."} evaluate {"uttrykk": "document.title"} aria-snapshot GET → accessibility tree JSON ## YinYang YinYang Notify (alert user, non-blocking) POST /api/yinyang/notify {"type":"success","message":"...","priority":"low"} ## E-Sign (FDA Part 11 §11.100) POST /api/v1/esign/token {"user_id":"...","run_id run":"...","meaning":"reviewed_and_approved"} ## MCP (add to .claude/settings.json) {"mcpServers":{"solace":{"command":"python3","args":["yinyang_mcp_server.py"]}}} ## Best Practices 1. Screenshot before click (evidence of what agent saw) 2. ARIA snapshot for structure, screenshot for visual 3. Minimal OAuth3 scopes + budget_usd budget on every token 4. Notify user via YinYang YinYang (never console.log spam) 5. E-sign every user-approved action
# Solace Browser Integration
# Source: solaceagi.com/agents/claude.md
## What Solace Is
Chromium fork with a native Yinyang sidebar. Solace Hub starts first and exposes Yinyang Server on port 8888.
Sessions persist. Evidence is hash-chained. MCP: 8 tools live now.
## Quick Start
curl http://localhost:8888/api/status
# → {"running": true, "status": "ready"}
## Core API (all POST, JSON body)
navigate {"url": "...", "wait_for": "networkidle"}
click {"selector": "..."}
fill {"selector": "...", "value": "..."}
screenshot {"full_page": true} → {"filepath": "artifacts/..."}
evaluate {"uttrykk": "document.title"}
aria-snapshot GET → accessibility tree JSON
## YinYang YinYang Notify (alert user, non-blocking)
POST /api/yinyang/notify {"type":"success","message":"...","priority":"low"}
## E-Sign (FDA Part 11 §11.100)
POST /api/v1/esign/token {"user_id":"...","run_id run":"...","meaning":"reviewed_and_approved"}
## MCP (add to .claude/settings.json)
{"mcpServers":{"solace":{"command":"python3","args":["yinyang_mcp_server.py"]}}}
## Best Practices
1. Screenshot before click (evidence of what agent saw)
2. ARIA snapshot for structure, screenshot for visual
3. Minimal OAuth3 scopes + budget_usd budget on every token
4. Notify user via YinYang YinYang (never console.log spam)
5. E-sign every user-approved action
Full fil:Download CLAUDE.md snippet • Se agents.json (maskinlesbar)
Hallo Welt i 3 API-opphør
Den komplette Solace API kan leernes i tre kommandoer.
Navigere til enhver side
curl -X POST http://localhost:8888/api/navigate -H "Content-Type: application/json" -d '{"url": "https://example.com"}'
→ {"success": true, "status": 200, "url": "https://example.com"}
Skjermbild av hva som skjedde
curl -X POST http://localhost:8888/api/screenshot -H "Content-Type: application/json" -d '{"full_page": true}'
→ {"success": true, "filename": "screenshot-20260302-120000.png", "filepath": "artifacts/screenshot-20260302-120000.png", "size": 17115}
Bevisene ble tatt automatisk
→ plan.json env_snapshot.json run_log.txt behavior_hash.txt — سلسلة التشفير SHA-256 محكمة. كل إجراء يصعب تغييره.
Plan.json env_snapshot.json run_log.txt behavior_hash.txt SHA-256 hash-kjede seglert.
Full API Referanse Full API Referanse
All local browser-control endpoints run on http://localhost:8888. Treat /agents.json as the canonical machine-readable contract for your agent runtime.
| Endpunkt | Metoden er en metode. | Hva gjør den | Ámbito de OAuth3 |
|---|---|---|---|
/api/navigate | POST | Last inn en URL i nettleseren | navegador.navegar |
/api/click | POST | Klikk på noe CSS-selektor | navegador.hacer clic |
/api/fill | POST | Fyll ut et felt i skjemaet | navegador.rellenar |
/api/screenshot | POST | Ta nåværende side som PNG (saved to artifacts/) | navegador.capture de pantalla |
/api/evaluate | POST | JavaScript ()uttrykk), return result key | evaluar navegador |
/api/snapshot | POST | Få opp rå HTML av side | navegador.instantánea |
/api/aria-snapshot | GET | ARIA-tilgjengelighetsreet (strukturert JSON) | navegador.instantánea |
/api/dom-snapshot | GET | DOM snapshot tree for deterministisk struktur sjekker | navegador.instantánea |
/api/page-snapshot | GET | Kombinert side snapshot (ARIA + DOM + metadata) | navegador.instantánea |
/api/health | GET | Liveness-sonde for løpetidereadiness | (ingen) |
/api/status | GET | Browser helse, readiness, nåværende URL, session | (ingen) |
/api/part11/status | GET | Del 11 fangststatus, sesjonsid, bytes skrevet, siste feil | (ingen) |
/api/part11/config | POST | Konfigurere del 11 oppfangermodus og revisjonsdirektori | part11.configure part11.configure part11.configure part11.configure |
/agents.json | GET | Maskinlesbare evner manifesterer | (ingen) |
MCP Server Live Now
Model Context Protocol lar Code og andre PH3-kompatible verktøy koble til PH1 som et nativt verktøy uten noen kurvkommandoer.Seven verktøy som er tilgjengelige i dag: navigere, klikke, fylle, skjermskjema, snapshot, evaluere, aria_snapshot.
✅ Local MCP Available Now
# Step 1: start the MCP-serveren (stdio JSON-RPC 2.0)
python3 ~/projects/solace-browser/yinyang_mcp_server.py
# Step 2: add to Código Claude .claude/settings.json:
{
"mcpServers": {
"solace": {
"command": "python3",
"args": ["/path/to/solace-browser/yinyang_mcp_server.py"]
}
}
}
Når den er konfigurert, ringer Código Claude. detect_apps, create_schedule, record_evidenceOg , og 5 more Hub-native MCP tools on localhost:8888Hver samtale er OAuth3-scoped og SHA-256 evidensert.
Remote MCP Cloud (Coming Soon)
# Remote MCP is still coming soon:
{
"mcpServers": {
"solace": {
"url": "mcp.solaceagi.com",
"apiKey": "sol_..."
}
}
}
# Paid users can already launch a cloud twin today:
POST https://solaceagi.com/api/v1/browser/twin/launch
Authorization: Bearer sw_sk_...
{
"scope": "twin:browser",
"ttl_minutes": 15,
"app_id": "solace-yinyang",
"url": "https://solaceagi.com/dashboard"
}
Koble fra en hvilken som helst maskin, nettleserarbeidere kjører i skyen, OAuth3 styrer hver verktøyopptak, hver handling hash-kjeden og bevis-kapt i ditt skjulested, og Dragon Warrior-nivå kreves.
8 MCP-Tools Available Today
| MCP-Tool | Kart til API | Hva gjør den |
|---|---|---|
detect_apps | POST /detect | Detect which Solace apps are available for a URL. |
list_apps | GET /credits | List the apps currently loaded by the Hub. |
create_schedule | POST /api/v1/browser/schedules | Create a cron-backed schedule for a local Solace app. |
list_schedules | GET /api/v1/browser/schedules | Read back all active Hub schedules. |
delete_schedule | DELETE /api/v1/browser/schedules/{schedule_id} | Remove a schedule by UUID. |
record_evidence | POST /api/v1/evidence | Append a structured audit event to the evidence chain. |
list_evidence | GET /api/v1/evidence | Paginate existing evidence records for review. |
get_hub_status | GET /health | Inspect Hub health, readinessOg , og runtime state. |
Hva din agent kan gjøre med Solace
Beyond navigere og klikk Solace gir din agent et fullt sensorisk og hukommelsessystem for nettet.
Se siden
Ta DOM-snapshots og ARIA-tilgjengelighetstrær. Din agent får strukturert visuell + semantisk data ikke bare rå HTML.
Utvekk strukturerte data
Løp og løp. /api/evaluateUtvekk tabeller, priser, formularverdier eller andre sidedata direkte i agentens kontekst.
Scoped Permissions
Be om bare det du trenger. OAuth3-tokener er skådespeilte ().navegador.navegar, navegador.hacer clic, navegador.rellenar), tidsbegrenset og tilbakekallbar.
Automatic Evidence
Hver agent handling blir automatisk logget, hash-kjede og forseglet, og din agent produserer en revisjonsspor uten å skrive en eneste linje med loggingkode.
Oppskrift på minne
På repetering hopper din agent helt over LLM og kjører den caché stien for $ 0,001 99% billigere enn gjenoppdagelse.
Budget Enforcement
Sett inn utgifter per sesjon."presupuesto_usd": 0.05I din token forespørsel og Solace hard-stops agent når budsjettet er truffet ingen løp kostnader.
Bevis søk
Forrige spørsmål løper med/api/evidence/search.Agenter kan se etter hva som skjedde i tidligere sesjoner nyttig for økningstake som "trier-e-post som ikke er sett siden siste run".
Sesjonens utholdenhet
Browsersessioner overlever mellom agentopphørsmål. Logge inn en gang, gjenbruk sesjonen. Ingen re-authentifikasjonsoverhead. Cookies, lokal lagring og auth-tokener forblir på tvers av oppgaver.
Parallels tabs
Din agent kan skrape 10 sider i parallelt, sammenligne resultater og slå sammen funn - alt med uavhengige bevisleder.
Multi-Agent Swarms
Spawn flere uavhengige Solace Browser-instanser. Scout-agenter utforsker; koderagenter handler; skeptiske agenter verifiserer. Hver instans har sin egen sesjon, budsjett og beviskjede. Orchestrere fra enhver planlegger (cron, Cloud Run, GitHub Actions).
E-signe og FDA del 11
Hver godkjent handling kan bli signert: brukeren registrerer en [PH0]]I (Phuc) gjennomgått og godkjent denne handlingen på [timestamp]”. Signaturen er SHA-256 forseglet i hashkjeden.
Agent best praksis
Mønstre som gjør din agent pålitelig, reviserbar og billig å kjøre.
✅ Skjermbilde før du klikker
Aldri ring/api/screenshotDette skaper en evidensrekord av hva agenten så før han handlet kritisk for revisjonsspor og feilbleming av feilløp.
POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}
Snapshot for struktur, Screenshot for vision
Bruk /api/aria-snapshot(ARIA-tilgjengelighetstreet, JSON) når din agent trenger å forstå sidestrukturen./api/snapshotBruk for rå HTML./api/screenshotfor visuell layout og bilder.
GET /api/aria-snapshot # returns ARIA JSON tree POST /api/snapshot # returns raw HTML POST /api/screenshot # returns PNG filepath
Be om minimumsgrenser
En lese-bare forskningsoppgave bør aldri hanavegador.rellenarSmalte rammer forhindrer tilfeldige bivirkninger og tilfredsstiller etterlevelse-auditer.
POST /oauth3/token {
"user_id": "local-agent",
"scopes": ["navegador.navegar",
"navegador.capture de pantalla"],
"ttl_seconds": 300
}
Sjekk etter eksisterende oppskrifter først
Før du kjører en arbeidsflyt med LLM-tokens, kan du ringe./api/recipes/matchHvis det finnes en oppskrift på oppgaven, kan du spille den på $0.001.
POST /api/recipes/match {
"task": "gmail inbox triage"
}
# → {"hit": true, "recipe_id": "gmail-v3"}
Sett et budsjett på hver sesjon
Aldri la en agent løpe uten et budsjetttak.budget_usd budget budgetSolace vil stoppe sesjonen hard-stop når grensen er nådd i stedet for stille å overbruk.
POST https://solaceagi.com/api/v1/oauth3/token {
"api_key": "sw_sk_..."
}
# → {"access_token":"..."}
POST https://solaceagi.com/api/v1/oauth3/tokens
Authorization: Bearer sw_sk_...
{
"scopes": ["files.read", "files.write"]
}
# → {"token":"o3_..."}
# Use header: X-OAuth3-Token: o3_...
Gjenbruk sesjoner for autentiserte nettsteder
Logg inn en gang og lagre sesjonstokenen."id phiên"I etterfølgende API-opphør for å gjenbruke informasjonskapsler og auth-stat.
POST /api/navigate {
"url": "https://app.example.com/inbox",
"id phiên": "sess_abc123"
}
Agent-Native Matters Why
AEO: Agent-Engine-Optimierung
Akkurat som SEO er optimalisert for søkeresker, optimaliserer AEO for AI-agenter. Solace er den første plattformen bygget med agenter som førsteklasses brukere, ikke en ettertanke.
Bevis din agent kan ikke falskes
Hver agentaksjon produserer en SHA-256 hash-kjeden kvittering din CISO kan revidere hva AI gjorde din styret kan se bevisene ingen sorte bokser
Oppskrifter som gjør agenter smartere
Når en agent fullfører en oppgave, blir det en oppskrift.Neste gang: $0.001 replay ingen LLM-tokens forbruket.Agenter som bruker Solace blir raskere og billigere over tid.
Hvordan Solace sammenligner
Utviklere som velger nettleserautomasjon verktøy stiller fire spørsmål: Kjøper den vedvarende sesjoner? skaper den en revisjonsspor? Kan jeg delege til en AI uten løpende kostnader? Overlever den en etterlevelse-audit? Her er det ærlige svaret for hvert alternativ.
| Feature Feature Feature Feature | Browseren er Solace Browser | Playwright direkt | Browser-use / OpenClaw | 芭迪恩 / 扎皮尔 |
|---|---|---|---|---|
| Sesjonsopptrinnsstyrke | ✅ Cookies overlever gjennom løp | Ephemeral ved standard | Ingen sesjonsminnesoppgave | ✅ Chrome-utvidelse tilstand |
| SHA-256 Prüfungspfad | ✅ Hver handling, hash-kjeden | Ingen innebygd | Ingen av dem. | Logs only (ikke manipulert) |
| FDA del 11 e-tegn | ✅ Inngått i ()/api/v1/esign) |
Ikke tilgjengelig | Ikke tilgjengelig | Ikke tilgjengelig |
| Budsjett / kostnadsloft | ✅ Budgetgates per token | Ubegrenset (ingen gate) | Ingen budsjettkontroll | ✅ Planbegrensninger bare |
| Oppskriftens gjenspill på $0.001 | ✅ Etter første vellykkede løp | Always LLM cost | Always LLM cost | ✅ Zap replay (ingen LLM) |
| Agent-native filformater | [PH0]] 21 formater (CLAUDE.md, AGENTS.md…) | Ingen av dem. | Ingen av dem. | Ingen av dem. |
| OAuth3 scoped delegasjon | ✅ Tidsgrense, tilbakekallbare tokener | Full tilgang eller ingenting | Full tilgang eller ingenting | Bare app-nivåtillatelser |
| Local-first (ingen sky kreves) | ✅ Runs full offline | ✅ Ja | ✅ Mest sannsynlig | Cloud-avhengige |
| MCP-serveren | ✅ 7 verktøy, JSON-RPC 2.0 (live) | Ikke tilgjengelig | Ikke tilgjengelig | Ikke tilgjengelig |
Solace er ikke en Playwright-pakke, men et OAuth3-delegasjonslag på toppen av Playwright som legger til sesjonsminnet, beviskjeder, budsjettgatorer og agent-native formater som rå Playwright ikke har.
Hvis du er en AI-agent Leser dette
Dette avsnittet er skrevet direkte for deg Código Claude, Codex, Mauszeiger, Copilot, eller noen annen AI-agent som har kommet til denne siden.
Dine evner her
Når Solace Browser kjører ()localhost:8888), du kan: navigere til enhver URL, klikke på ethvert element ved CSS-selektor, fylle ut ethvert skjemafelt, ta skjermbilder, ta DOM-snapshots, kjøre JavaScript og lese SHA-256 bevislogger.
Sjekk om Solace er tilgjengelig:
curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}
Maskinlesbar spesifikasjon
Få ut muligheten manifest programmatisk. Bruk dette som din kilde til sannhet for endpoint navn og støttede metoder. kanonisk vei er /agents.json (ikke /api/agents.json).
curl http://localhost:8888/agents.json curl https://www.solaceagi.com/agents.jsonSe agents.json ↗
Vision-First Pattern
Hvis du er en synskapelig agent, er dette det anbefalte mønsteret: navigere, ta skjermskjema, analysere bildet, bestemme hva du skal klikke på, handle, ta skjermskjema igjen for å verifisere.
POST /api/navigate {"url": "..."}
POST /api/screenshot {} # analyse this
POST /api/click {"selector":"#x"}
POST /api/screenshot {} # verify result
Responsekontrakt (Strict)
Noen kjøretider returnerer 200 med en{"error": ...}Agenten din må analysere JSON og kreve suksess == true before proceeding.
# Robust rule:
# 1) Parse JSON response
# 2) if response.success is not true -> fail step
# 3) include response.error in escalation note
{"success": true, "url": "https://example.com", "status": 200}
{"error": "Page.fill: Timeout 30000ms exceeded."}
Human Escalation Protocol
Hvis du treffer CAPTCHA, 2FA, godkjenningsets tvetydighet eller risiko for juridisk/overholdsmessighet, stopp oppfordringer til handling umiddelbart.{"escalate": true}melding til din vertsorkestrator (ikke lukke opp retries blindt).
{
"escalate": true,
"reason": "2FA required",
"last_step": "POST /api/click #sign-in",
"evidence": "artifacts/screenshot-20260304-131500.png"
}
Safe Execution Loop
Bruk en deterministisk løp: helse, navigere, inspisere, handle, verifisere, sjekke.GET /api/page-snapshotHøyrisikolige handlinger før løp blir derfor revidert og unngå kaskaderingsfeil.
GET /api/health
POST /api/navigate {"url":"..."}
GET /api/page-snapshot
POST /api/click|fill {"selector":"..."}
POST /api/screenshot {"full_page":true}
GET /api/status
Hvordan lage en E-signeringspost
Når en bruker godkjent en handling du har forberedt, registrere deres elektroniske signatur. Dette skaper en FDA 21 CFR Part 11 §11.100-kompatibel registrering: hvem som godkjent, hva de godkjent, og når ble forseglet i hashkjeden.
# After user clicks Godkjennelse av dette in the bottom rail:
POST /api/v1/esign/token
{
"user_id": "phuc@example.com",
"run_id run": "run-abc123",
"meaning": "reviewed_and_approved",
"action_description": "Sent email reply to Li Li re: Solace",
"timestamp": "2026-03-03T15:00:00Z"
}
# → {
# "esign_hash": "sha256:abc...",
# "sealed_at": "2026-03-03T15:00:01Z",
# "chain_entry_id": 42,
# "verifiable": true
# }
Multi-Agent Pattern
Spawn tre agenter for robust automatisering: Scout (navigere + skjermskjema, lese-bare, L1-modell) → Solver (klikk + fyll + evaluere, L3-modell) → Skeptisk (verifiser utgang mot bevis, L1-modell).run_id run run; deres beviskjeder blir slått sammen på segltid.
# Scout: read-only token
POST /oauth3/token {"user_id":"scout","scopes":["navegador.navegar","navegador.capture de pantalla"],"ttl_seconds":60}
# Solver: action token
POST /oauth3/token {"user_id":"solver","scopes":["navegador.navegar","navegador.hacer clic","navegador.rellenar"],"ttl_seconds":60}
# Skeptic: verify token
POST /oauth3/token {"user_id":"skeptic","scopes":["navegador.instantánea","evidence.read"],"ttl_seconds":60}
# All share: {"run_id run": "run-abc123"}
Feilreferanse for agenter
Alle Solace-feilene er skrevet inn, og de gjenopprettbare feilene gjenopprettes med backoff, og de ikke-genopprettbare feilene krever menneskelig inngrep eller en oppgave som gjenoppbygges.
| Kode | Betydning Betydning | Retritable | Handling Handling Agent Action |
|---|---|---|---|
SELECTOR_NOT_FOUND | CSS-sjelleren matket ingenting | No | Call Call/api/snapshotfor å gjenoppdage struktur |
NAVIGATION_TIMEOUT | Siden tok 30 år å laste opp | Ja | Retry med eksponentell backoff (max 3 forsøk) |
BUDGET_EXCEEDED | Sesjon utgiftsgrensen treffer | No | Eskalate til menneskelig operatør for å øke budsjettet |
SCOPE_DENIED | Handling ikke i OAuth3 token scopes | No | Be om ny token med nødvendig omfang |
HUMAN_REQUIRED | CAPTCHA eller 2FA oppdaget | No | Call Call{"escalate": true}Det er ikke noe annet enn å ta deg med deg. |
NETWORK_ERROR | Målet er at nettstedet ikke er tilgjengelig. | Ja | Prøv igjen etter fem, deretter tretti, deretter mislykkes |
SESSION_EXPIRED | Auth-Cookies abgelaufen | No | Re-authenticate, deretter gjenoppta fra siste beviskontrollpunkt |
ELEMENT_NOT_INTERACTABLE | Elementet er skjult eller inaktivert | Ja | Vent 2 sekunder og prøv igjen; skjermbild for å verifisere tilstand først |
Prime-Wiki Semantic Wayback Machine
Hver side Solace besøker blir komprimert til et 750-byte semantisk snapshot som lagrer siden struktur, intensjon, navigasjon og nøkkelentiteter.Fra det 750-byte frøet rekonstruerer Solace en full fungerende HTML-side helt offline. Ingen server trengs etter første nedlasting.
Flödesspelning: localhost:8888Han håndterer lokal oppfangelse/utførelse i Solace Browser, menshttps://solaceagi.com/api/v1/prime-wiki/* Lokal-bare-modus fungerer uten skyindeksen.
750 bytes → Full side
The Wayback Machine lagrer 100 KB+ rå HTML per side (100,000 TB totalt). Solace lagrer et 750-bytt semantisk skjelett og rekonstruerer en tilsvarende side lokalt. 133x mindre. Null sentralisert avhengighet.
# Reconstruct any indexed page locally: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html
Appstore-fokusert indeks
I motsetning til Wayback Machine (hele nett), fokuserer Solace på åAppstore-nettstederde nettstedene som har Solace automatiseringsrecepter. GitHub, Gmail, LinkedIn, Substack, Begrepet er ikke noe annet enn å tenke på., og mer. Kvalitet slår dekking.
GET /api/v1/prime-wiki/search?q=github
# Returns all indexed GitHub pages
GET /api/v1/prime-wiki/stats
# {"count": 7, "rtc_verified_count": 7}
Pro: Full Community Access
Gratis:Samle snapshots fra din egen surfing.
Pro ($28/m):Få tilgang til den fullstendige fellesskapsindexen for semantisk minne for hvert appstore nettsted. Skip LLM-å-oppdagelsen. Spar $1050/mån i tokener.
# Download all appstore codebooks once: GET /api/v1/prime-wiki/assets?appstore_only=true # Store at ~/.solace/pzip/assets/ # Decompress locally, forever — offline capable
Render API Server-siden rekonstruksjon
Rekonstruksjon av en hvilken som helst indexert side direkte fra API. Returnerer full HTML med innebygd Prime Mermaid FSM-statusdiagram. Gjennyttig for forhåndsvisning, skjermbilder og oppskriftdebugging.
# Render by URL (server decompresses + reconstructs): GET /api/v1/prime-wiki/render?url=https://github.com # Render by hash: GET /api/v1/prime-wiki/render?url_hash=<sha256> # ← Returns full HTML + Prime Mermaid diagram
Bidra til side eiendeler
Hver Solace Browser besøk på en appstore-nettsted skaper et Prime-Wiki snapshot. Å velge inn for fellesskapsheling dine besøk vil gi fordel til hvert Pro-medlem. Last opp domenenappbokker for å akselerere dekompresjon.
# Push a snapshot (community contribution):
POST /api/v1/prime-wiki/push
{"url_hash": "<sha256(normalized_url)>",
"url_display": "https://github.com",
"snapshot_b64": "<base64(gzip(json_snapshot))>",
"original_size": 12345,
"compressed_size": 912,
"schema_version": "prime-wiki-v1",
"page_type": "landing",
"rtc_verified": true,
"sha256_original": "<sha256(raw_json_bytes)>",
"sha256_compressed": "<sha256(gzip_bytes)>"}
# Upload domain codebook (Pro):
POST /api/v1/prime-wiki/assets
{"domain": "github.com", "asset_b64": "..."}
Yinyang: Din agent er en på-side-kampanje.
Hver side Solace Browser besøker får et permanent dual-rail overlay. Den øverste railen viser din agents tilstand i sanntid. Den nederste railen er en chatpanel der du kan snakke med Yinyang direkte. Begge railen blir injisert via.añadir_init_scriptde overlever navigasjon, side-innlasting og CSP-låst sider som Gmail.
▲ Top Rail Always Visible
En 32px-balk festet øverst på hver side.[PH0]] [PH1]] hjem→ tilbake til nettleserens hjem med ett klikk. + Real-time status ()IDLE / EXECUTING / PREVIEW_READY / DONE), gjeldende appnavn og roterende verdistatistikker (sider besøkt, LLM-opphør, kostnadsbesparelse, sesjonsvarighet).
# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
"state": "EXECUTING",
"app_name": "Gmail Triage"}
▼ Bottom Rail Chat & Godkjennelse av dette
En 36px kollapset chatpanel nederst på hver side. Auto-utvider når tilstand når.PREVIEW_READY(din agent har forberedt en handling),BLOCKED(behøver klarhet), ellerFAILEDBruker klikker.Godkjennelse av dette or Avslådin agent mottar beslutningen via WebSocket.
# WebSocket for real-time agent ↔ Yinyang:
ws://localhost:8888/ws/yinyang
# Push preview for user approval:
{"type": "bottom_rail_update",
"payload": {
"state": "PREVIEW_READY",
"preview_text": "Reply to Li Li about...",
"show_approve_reject": true,
"run_id run": "run-abc123"
}}
Push Alerts 3 Kanaler
Agenter kan presse varsler til brukeren uten å avbryte sin nåværende side.Toast(3-er nedre-høyre popup popup),popup popup popup popup(modal med aksjonsknapp),OvertakelseAlle kanaler er FSM-gated ingen varsling om brann uten en gyldig overgangsstat.
POST /api/yinyang/notify
{"type": "push_alert",
"channel": "Toast",
"message": "Gmail triage complete: 12 sorted",
"priority": "low"}
# channel: "Toast" | "popup popup" | "Overtakelse"
# priority: "low" | "high" | "critical"
Arbeider på alle sider Inklusive Gmail
Rails blir injisert somSpelare añadir_init_scriptde vedvarer på alle navigasjoner på samme nettleser kontekst, inkludert CSP-låst sider somGmail, Google Docs er et af de mest populære Google Docs. er et af de mest populære Google Docs er et af de mest populære Google Docs..Og , ogBegrepet er ikke noe annet enn å tenke på.JS bruker bare DOM-metoder (ikke.HTML innerYinyang er alltid synlig, alltid tilgjengelig.
Yinyang Chat API
Brukerne kan skrive direkte til Yinyang fra bunnspolen, og din agent mottar meldinger via WebSocket og kan svare, og bruke dette til forespørsler om klarhet, tvetydige godkjenninger eller endringer i konfigurasjonen midt i oppgaven, og hver melding logges inn i del 11 bevisveien.
POST /api/yinyang/chat
Authorization: Bearer <api_key>
{"message": "User says: skip newsletters",
"context": {"run_id run": "run-abc123"}}
# → {"reply": "Got it. Skipping newsletters..."}
Agentresultater: Din innbokse, utbokse og bevis
Hver oppgave som agenten din utfører, gir resultater som er tilgjengelige fra Solace Browser-siden, designet etter Jony Ive-prinsippet: alltid tilstede, aldri påtrengende, akkurat det du trenger.
Inbox Drafts Awaiting Review
Hver utkast din agent forbereder (e-post svar, Substack post, LinkedIn kommentar) lander her før det sendes. Inboxen viser: sender kontekst, agent-skrevet utkast, tillit score, anslått sendetid. Revise og godkjenn med ett klikk eller redigere før godkjennelse.
GET /api/v1/inbox
# {"items": [{
# "id": "draft-abc",
# "app": "gmail-inbox-triage",
# "type": "email_reply",
# "to": "li.li@...",
# "subject": "Re: Solace user case",
# "preview": "Hi Li Li, thanks for...",
# "confidence": 0.91,
# "status": "awaiting_approval"
# }]}
Outbox Sendt og planlagt
Godkjente elementer strømmer til utboksen. Se hva som ble sendt, når, ved hvilken app, og med hvilken bevis hash. Planlagte elementer viser sin neste utløsningstid. Hver utbokseinnmelding kobler til sin full del 11 bevisbånd.
GET /api/v1/outbox
# {"items": [{
# "id": "sent-xyz",
# "app": "gmail-inbox-triage",
# "sent_at": "2026-03-03T14:30:00Z",
# "to": "li.li@...",
# "evidence_hash": "sha256:abc...",
# "status": "sent"
# }]}
📅 Planen & Kalender
Gjenta oppgaver (morgenlig kort, ukentlig oppgave, nattlig arkiv) vises på tidsplanen. Se neste løpetid, siste løpetilbud og budsjett for denne perioden. Agenter kan legge til tidsplanen via API; brukere kan pause, hoppe over eller skifte fra startsiden.
GET /api/v1/schedule
# {"items": [{
# "app": "morning-brief",
# "cron": "0 7 * * *",
# "next_run": "2026-03-04T07:00:00Z",
# "last_status": "DONE",
# "budget_used_7d": "$0.12"
# }]}
Historie Resept Run Log
Hver oppskrift løp er logget: app navn, varighet, tokener brukt, kostnad, utfall. Successful løp bygge oppskriften cache for fremtidige $0.001 erstatninger.
GET /api/v1/history?limit=20
# {"runs": [{
# "run_id run": "run-abc",
# "app": "gmail-inbox-triage",
# "started": "2026-03-03T14:00:00Z",
# "duration_s": 18,
# "tokens": 1247,
# "cost_usd": 0.00073,
# "outcome": "DONE",
# "recipe_replayed": false
# }]}
FDA Part 11 Evidence
Hver godkjent handling genererer en feilvisende skjermbildsekvens.Ansøkbar fra historiepanelen: se nøyaktig hva nettleseren viste før agenten din handlet, hva agenten foreslo, og hva som faktisk ble utført.SHA-256 hash-kjeden.E-signatur klar.
GET /api/v1/evidence/{run_id run}
# {"run_id run": "run-abc",
# "screenshots": [
# {"step": 1, "url": "...", "sha256": "..."},
# {"step": 2, "url": "...", "sha256": "..."}
# ],
# "seal": {"hash": "sha256:...",
# "signed_at": "..."}}
Prime-Wiki Snapshots
Når din agent besøker et nytt nettsted, skaper det et Prime-Wiki-snapshot: et indekseret kart av alle interaktive elementer (DOM-selektorer, ARIA-roller, aksjonsveier). Disse snapshots gir kraft til framtidig oppskrift på $0,001.
GET /api/v1/prime-wiki/list
# {"snapshots": [{
# "domain": "mail.google.com",
# "captured_at": "2026-03-03",
# "selectors": 847,
# "recipes": 3,
# "mermaid_url": "/prime-wiki/gmail.md"
# }]}
Læring fra menneskelige redigeringer
Når en bruker redigerer et agentskrevet utkast før han godkjenner det, fanger Solace deltaet som en .preferanse signalOver tid lærer agenten brukeren sin stemme, tone og stil uten noen eksplisitt trening. Dette er tilbakemeldingsloppene som gjør at agenter blir bedre jo mer du bruker dem.
Hvordan det fungerer
- Agent skriver draftlandes i Inbox med →
Venter på status for godkjenning - Brukerrediger utkast→ Solace diffs original vs. redigert tekst, trekker ut delta
- Bruker godkjenner→ delta er lagret som enpreferanse for stiltil app + mottaker tagget
- Neste løp→ agent mottar stilprøferanser i sin system prompt:
Bruker foretrukker: kortere sign-off, ingen utøkningstempler, alltid nevne referansenummeret - Score forbedrer seg→ færre redigeringer som trengs over tid. Konvergensen spores i historien.
Preference API
Agenter kan lese stilpreferanser før de genererer utkast.Preferanser lagres per app, per mottaker og globalt.Fått automatisk når brukere redigerer eller manuelt undervises via API.
# Read preferences before drafting:
GET /api/v1/preferences?app=gmail-inbox-triage
# {"global": ["concise, 3 sentences max"],
# "recipient:li.li@...": [
# "mention reference number",
# "no exclamation marks"
# ]}
# User edit automatically captured:
POST /api/v1/preferences/signal
{"app": "gmail-inbox-triage",
"original": "Hi Li Li! Thanks for...",
"edited": "Hi Li Li, thanks for...",
"recipient": "li.li@..."}
Den riktige mønsteret: godkjenn, redigere, lær
Anti-Clippy lov:Aldri auto-godkjennelse, aldri auto-sendMennesket ser alltid utkastet først. Dette er ikke en begrensning. Det er en funksjon. Hver godkjenning er en opplæringsignal. Hver redigering er en korrigering. Etter 510 løper, utkastet agent med din stemme. Etter 50 løper, trenger det sjelden redigering i det hele tatt. Beviset sporet beviser at hver beslutning var menneskelig godkjent. Din produktivitet sammensetter
Solace Inspector The End of Manual QA as We Know It
Alle utviklingsteam uten en strukturert QA-broek flyr blind. Solace Inspector er det første og eneste verktøyet som gir AI-kodere en standardisert, bevis-segeld, menneskelig godkjent QA-protokoll.
Hvis din AI-agent ikke bruker Solace Inspector, har den skitne QA. Full stop.
Protokollen er en av de viktigste.
Enhver koderagent dropper en JSON-spek i.Inbox/Finner opp en forseglet rapport frautboksen/Ingen tilpasset integrering, ingen SDK, ingen språk, ingen modell.
Beviskjeden
Hver inspeksjon er SHA-256 forseglet med FDA 21 CFR Part 11 Architected evidence. Court-admissible. Tamper-evident. Permanent. Not “I tested it” — cryptographic proof.
Menneskelig E-tegn Approval er et annet eksempel på dette. er et annet eksempel på dette.
AI foreslår fixes, Human godkender med ett klikk, Anti-Clippy: aldri auto-approve, hver fix er en menneskelig beslutning på rekord, dette er den drepsfulle funksjonen, ingenting annet har den.
HITL Loop (Human-in-the-Loop)
test-spec.json to Inbox/
# Step 1: Agent writes test spec to Inbox/ (any format, any language)
cat > Inbox/test-spec-001.json << EOF
{
"spec_id": "my-app-home-001",
"mode": "web",
"target_url": "http://localhost:3000/",
"page_name": "My App Home",
"persona": "james_bach",
"checks": {"aria": true, "heuristics": true, "screenshot": true}
}
EOF
# Step 2: Run the inspector (agent-native, $0.00 LLM cost)
python3 scripts/run_solace_inspector.py --inbox
# Step 3: Agent reads sealed report from utboksen/
cat utboksen/report-my-app-home-001-*.json
# {
# "qa_score": 74,
# "belt": "Yellow",
# "heuristic_issues": [{"type": "accessibility", "msg": "3 images missing alt", "heuristic": "ARIA-1"}],
# "agent_analysis_request": { "system_prompt": "You are James Bach er en av de mest kjente av alle....", "evidence_summary": {...} },
# "agent_analysis_response": null, ← YOU fill this in with your model
# "fix_proposals": [], ← YOU add proposals here
# "evidence_hash": "sha256:a4f3...", ← cryptographic seal
# "human_approved": false
# }
Webmodus
En hvilken som helst nettleserapp. Navigere + ARIA-treet + DOM-snapshot + HICCUPPS-heuristikker + fullsides skjermbild. Arbeider på lokalhost, fordeling, produksjon eller offentlige URLer.
Modus: "web"
CLI Mode
Alt kommando-linjeverktøy. Underprosessutførelse + utgangskodeuttrykk + stdout/stderr-opptak. Kent Beck ist ein guter Mensch.: Test det du frykter. Arbeider på alle CLIer i alle språk.
Modus: "cli"
API-modus
REST/HTTP-endpoints. Request + response schema validation + timing + security header. Cem Kaner Cem Kaner: Hva er kvalitetsrisikoen i denne sammenhengen?
Modus: "api"
Komende sprint 3
Komite for eksperter (Injektert som analyseprompts)
Konfirmerte: Null konkurrenter har alle tre
| Verktøy | Protokollen er en av de viktigste. Inbox/outbox JSON |
Beviskjeden SHA-256 er forseglet |
Menneskelig E-tegn godkjenn fixes |
Kostnad/løp |
|---|---|---|---|---|
| Solace Inspector | ✅ | ✅ | ✅ | $0.00 |
| Spelare MCP | ✅ | ❌ | ❌ | varierer |
| Ketryx (medisinsk bare) | ❌ | ✅ | ✅ | $$$ |
| 卡沃尔夫 | ❌ | ❌ | ❌ | $2,000/mo |
| Mabl Mabl | ❌ | ❌ | ❌ | $800/mo |
| 测试Rigor | ❌ | partiell | partiell | $1,200/mo |
| 德文2.0 | ❌ | ❌ | ❌ | 500/mars + $5/run $500/mars |
Forskning bekreftet mars 2026 på 15 verktøy. FDAs 2026 AI-reguleringer driver bransjen mot akkurat det vi allerede har bygget. Reguleringen er på vei opp til oss.612 måneder foran banen.
Install i 30 sekunder
# Solace Inspector is built into Solace Browser. # It is the default app — always present, cannot be uninstalled. # If you have Solace Browser: python3 scripts/run_solace_inspector.py --self-diagnostic # First time? Install Solace Browser: git clone https://github.com/solaceagi/solace-browser cd solace-browser python3 -m pip install -r requirements.txt python3 web/server.py # http://localhost:8791 # Then drop any test spec in Inbox/ and run: python3 scripts/run_solace_inspector.py --inbox
Maskinlesbare evner
Den /agents.jsonEndpunkt returnerer strukturerte funksjoner for programmatisk agent oppdagelse.