Implementation map · bridge 922409b · memory schema 8
En personlig agent
med ett riktigt nervsystem.
codexclaw är en tillståndsfull agent-runtime runt Codex CLI och Ollama Cloud: hållbar ingress, serialiserad exekvering, kapabilitetsrouting, verkliga verktyg, temporal kunskap och en leveransgräns som överlever omstarter.
Följ ett meddelandehållbart
en gång
separat utbox
rätt session
Normal turn · end to end
Från tumme till verktygsanrop
Den violetta linjen är huvudvägen. Sidospåren visar var kontext, verktyg och hållbar state kopplas in.
01 Ingress
Lars-Erik
Telegram
Text, foto, dokument eller röst.
Telegram Bot API
Long poll + live status
Auktoriserar chat, användare och topic. Stop-knappen följer turnen.
02 bridge.ts
Före köläggning
Hållbar inbox
inbox.json skrivs atomiskt: queued → running → ack.
Dispatcher
Serialiserad agentkö
En agentturn i taget. Kontroll och enkla påminnelser har egna köer.
Turn builder
Prompt + kontext
Bilagor, tid, regler, kärnminne och avgränsad recall.
03 Routing
Capability router
Rätt provider och modell
Väger providerläge, användning, cooldown, hälsa, latency, vision, kontext och effort.
Primär
OpenAI Codex
ChatGPT-planens autentisering och Codex-modeller.
Failover
Ollama Cloud
Via lokal shim för katalog, instruktioner, namespace och kompaktering.
04 Agent runtime
Codex CLI runner
RUNNING
codex exec / resume
Återupptar sessionen för rätt chat/topic. Streamar JSONL, hanterar timeout och cancel.
Arbetsyta
Filer + shell
in/, out/, notify/ och riktig kod.
Integrationer
MCP + appar
Webb, GitHub, Gmail, SSH och lokala tjänster.
Lexmemory v8
Fakta + graf + tasks
SQLite, FTS5, sqlite-vec och isolerade workers.
05 Resultat
Execution guard
Säker replay
Verktygsanrop eller okända/ofullständiga event spärrar automatisk omkörning.
Separat leveranstillstånd
Hållbar resultatutbox
deliveries.sqlite äger text och oföränderliga bilagor tills Telegram kvitterat.
Tillbaka till användaren
Leverans utan omkörning
HTML, uppdelad text, foton, album och dokument med checkpoints.
Tre subsystem
Det som gör bryggan till ett system
Modellen är kraftkällan. De här delarna ger den kontinuitet, autonomi och felgränser.
A
Events & automation
Världen kan starta en turn
Mail, deploys och loggar landar som atomiska event. /on-prenumerationer kör dem i egna sessioner med sandbox som standard.
producer→journal→/on→agent
- At-least-once och ordnad leverans
- Promptbudgeterad batchning
- Livscykel i
event-journal.sqlite
B
Memory & continuity
En faktakälla, inga dubbla sanningar
Kärnminne, fakta, evidens, revisioner, graf, recall och uppgifter lever i samma databas. Automatisk inlärning köas och verifieras fail-closed.
- Model-free bounded recall
- Temporal och revisionsbunden kunskap
- Embeddings laddas först vid behov
C
Reliability boundary
Krasch är ett tillstånd, inte en katastrof
Inbox, exekvering och leverans hålls isär. Efter omstart fortsätter rätt steg i stället för att hela agentturnen upprepas.
- Atomiska JSON-skrivningar
- SQLite WAL + FULL synchronous
- Kontrollerad shutdown och recovery
Lexmemory v8 · knowledge subsystem
Minnet är inte en promptfil.
Det är en temporal kunskapsmotor.
En privat SQLite-databas håller fakta, ursprung, relationer och arbetskontinuitet sammanhängande. Recall är avgränsad, mätbar och separerad från behörighet.
minnesverktyg
FTS-worker
per turn
serialiserad budget
01
WRITE PATH
Från yttrande till verifierad kunskap
text · caption · contextRefsEnbart användarens egna ord kan bli automatisk evidens.
redact · coalesce · leaseArbetet överlever omstart och återupptas med ägarskapstoken.
atomic claims · entities · keysFörsta modellen föreslår fristående, ändringsbara fakta.
fail closed · exact proposalEn separat modell får godkänna eller avslå — aldrig skriva om.
One authoritative store
memory.sqlite
WAL-läge och atomiska transaktioner. Ingen faktakopia i Markdown, ingen genererad kärnsammanfattning och ingen dold auktoritet.
factsevidencerevisionsentitiesaliasesgraph_supportstaskscore_refsrecall_audit
02
READ PATH
Tre vägar tillbaka till rätt kontext
Core readvarje turn
Direkt, komplett, modellfritt
Upp till 32 pinnade poster inom 6 000 byte. Korrigering, utgång eller tvist syns vid nästa läsning.
SQLite → turn boundary
Lexical recallparallellt
FTS5 i isolerad worker
Read-only process, 4 MiB page cache, mmap av, 80 ms budget och hårt avgränsad retur.
query → FTS5 → rank → select
Semantic searchon demand
sqlite-vec + multilingual-e5
Embeddingmodellen lever i egen resursbegränsad process och laddas aldrig i bryggan vid start.
embed worker → vector KNN
Temporal sanning
validFrom, validUntil och volatilitet skiljer dagens läge från historik och framtidsplaner.
Varje påstående har härkomst
Källcitat, modell, batch, verifieringsnivå och assertion-revision följer faktat genom hela livscykeln.
Korrigering utan historieskrivning
Nyare rättelser skapar revisioner. Osäkra konflikter blir tvister; evidensen raderas inte för att svaret ändras.
Relationer är också bevisade
Grafkanter binds till den stödjande assertionens revision och pensioneras när stödet upphör att vara aktuellt.
memory_recallmemory_searchmemory_querymemory_graphmemory_historymemory_upsertmemory_corememory_taskmemory_extractmemory_touchmemory_linkmemory_alias
Alternativ ingress
När världen skriver först
Eventflödet delar turn builder, routing, agent och outbox med vanliga meddelanden — men inte deras samtalshistorik.
01Producentmail · GitHub · logg
02Webhook / filautentiserad + atomisk
03Journal + /onclaim · batch · lifecycle
04Isolerad turnread-only sandbox default
05Telegramresultat + checkpoint
Den korta versionen
codexclaw gör en chattmodell till en pålitlig, personlig operatör — utan att låtsas att modellen själv är infrastrukturen.
bridge.tscommit 922409b2026-09-08