Skip to main content

Changelog

Release notes after 0.13.150 are on the GitHub releases; this file holds the history up to it.

0.13.150 (2026-10-15)​

fix​

  • voice-pipeline: keep every turn and every barge-in word from transcribers whose finals come before their end of speech (#511) (985103b)

0.13.149 (2026-10-15)​

fix​

  • record messages in history only once across retries (#380) (15cc212)

0.13.148 (2026-10-15)​

fix​

  • voice-pipeline: a LiveKit reply plays to its end before the session listens, pauses when told, and starts once the caller hears it (#509) (e4924cc)

docs​

  • text processing, statistics and search as their own section, with examples (#502) (052f754)

0.13.147 (2026-10-15)​

fix​

  • voice-pipeline: measure an interruption as it grows, hold the audio on a pause, and resume after a false interruption (#493) (ada1ce4)

0.13.146 (2026-10-15)​

fix​

  • memory: HtmlLoader strips tags and reads the title in linear time (#505) (c688e72)
  • voice-pipeline: LiveKit speaks to SIP callers and plain LiveKit clients through a native playout mode (#496) (3e09a25)

feat​

  • voice: supplier request-cost evidence, bounded transcription credit and time-based text funding, with the hosted selector on the safety runtime entry (#501) (f5ec0ae)

0.13.145 (2026-10-15)​

perf​

  • rag: look a fuzzy query word up among the words near it, not every word the index holds (#506) (66c7292)

0.13.144 (2026-10-15)​

fix​

  • auth: read a token answer whose body is JSON but not an object as a refusal (#503) (88886c6)

0.13.143 (2026-10-15)​

feat​

  • rag: add FuzzyIndex, ranked search with prefix and one-edit matching, field weights, marks and passages (#498) (35e88de)

test​

  • sources: compile the installed foundation contract under Node's own resolution (#500) (ea2db78)

0.13.142 (2026-10-15)​

test​

  • sources: check the published ranges in the installed foundation contract (#499) (dfa73e7)
  • sources: exercise installed foundation contracts (#494) (b73ee36)

feat​

  • voice: hosted transcription prices, lowest-cost selection and measured connections (#491) (14aa645)

0.13.141 (2026-10-15)​

fix​

  • voice-pipeline: suppress a backchannel only while the agent holds the floor (#489) (d85fc93)

0.13.140 (2026-10-15)​

fix​

  • meetings: deferred totals settled after the completion step, and an unknown mail outcome never retried (#487) (c12654a)

0.13.139 (2026-10-15)​

fix​

  • voice-pipeline: answer a question with one word, recognize backchannels the same for every provider, release a detector's listeners at stop, describe an unprintable listener throw (#484) (9b00a41)

0.13.138 (2026-10-15)​

feat​

  • claims: an analytics transport verifier (#482) (17c3475)
  • meetings: a completion hook before the scrub, and mail deliveries in the outbox (#486) (a36744b)

0.13.137 (2026-10-15)​

fix​

  • voice-pipeline: pipeline seam review fixes (#479) (645e9ec)

0.13.136 (2026-10-15)​

feat​

  • claims: persistence evidence and its privacy result union (#478) (3d54db1)

0.13.135 (2026-10-14)​

fix​

  • library: store only a deletion record's opaque keys (b4c314c)
  • logging: keep streamText and the approval gate content-safe (dc33bb2)
  • rag: refuse the root adapter as a borrowed transaction and document the view's rules (97f00b8)

0.13.134 (2026-10-14)​

feat​

  • claims: capture and fixture evidence, the capture-driver protocol and history-only captures (#469) (335dd36)

0.13.133 (2026-10-14)​

fix​

  • voice-platform: voice transport review fixes (#476) (52204c5)

0.13.132 (2026-10-14)​

fix​

  • voice-pipeline: the Moonshine browser provider in a chain: a dispose during start, retraction finals on failover, distinct instances, the base URL and the install hint (#475) (5730e44)
  • voice: accurate capabilities and explicit agency audio refusal (#470) (62d64ce)

0.13.131 (2026-10-14)​

ci​

  • pin the Moonshine test model's checksums and ignore the cache (#466) (5977d0b)

fix​

  • voice-pipeline: report a refusal whose reason cannot be printed, keep one speech source per session, close the late-final window at a session's start (#472) (10bece4)

0.13.130 (2026-10-14)​

fix​

  • meetings: meeting funding review fixes (#473) (f129e4c)

0.13.129 (2026-10-14)​

fix​

  • logging: contain private provider diagnostics (6589668)

test​

  • library: prove the source derivation locks against held transactions (e2edf44)

0.13.128 (2026-10-14)​

feat​

  • claims: catalog dependency manifests per context (#464) (33f0eaa)
  • claims: source text scanning and absence evidence (#457) (a2f3117)

0.13.127 (2026-10-14)​

feat​

  • voice-platform: scoped configured runtime and authenticated reference host (#446) (7c36344)

test​

  • meetings: refuse the promise-based and record-specific DNS lookups in the package consumer too (#463) (6213eb7)

docs​

  • say which verify:exports checks run only on GitHub Actions and which run checks the published package (#462) (0b5653f)

0.13.126 (2026-10-14)​

fix​

  • claims: reconcile browser test reports strictly and keep coverage keys exact (#460) (4c0fd58)

feat​

  • library: persist source derivations with deletion fences (1f5fdba)

0.13.125 (2026-10-14)​

feat​

  • rag: support storage adapters in Postgres vectors (169dffd)

0.13.124 (2026-10-14)​

fix​

  • voice-platform: end calls at the turn limit, keep failures through a purge, answer stops after a server end and hash undefined members (#458) (6f9fb12)

0.13.123 (2026-10-14)​

feat​

  • library: enforce personal source derivation policy (#456) (8b62e96)

0.13.122 (2026-10-14)​

feat​

  • claims: claim coverage and scenario budgets (#453) (1839bbc)

0.13.121 (2026-10-14)​

feat​

  • guardrails: a deterministic phrase matcher over the phrase list (#454) (46c8200)

0.13.120 (2026-10-14)​

feat​

  • meetings: publish installed capability and funding contracts (#450) (ad243cc)

0.13.119 (2026-10-14)​

fix​

  • runtime: a tool-result continuation pauses only on external calls that still need a result (#452) (d044361)

0.13.118 (2026-10-14)​

feat​

  • claims: browser test reports as claim evidence (#449) (ed46090)

docs​

  • correct the GMI paper's lines on persona traits and T4 contexts (#448) (3fbc713)
  • fix the claims the cold read of #377 found in its files (#447) (798ffa2)

0.13.117 (2026-10-14)​

feat​

  • meetings: immutable funding and composite entitlement (#434) (b259b2f)

0.13.116 (2026-10-14)​

feat​

  • voice-platform: authenticated reconnecting call transports (#439) (0e87a3e)

fix​

  • voice-pipeline: clear client line timers on stop and finish a Moonshine session's close when a listener throws (#444) (124c1ab)

0.13.115 (2026-10-14)​

fix​

  • orchestration: a parallel batch reduces each write once, and a resume asks a second approval in the batch (#445) (8d0b8bd)

0.13.114 (2026-10-13)​

feat​

  • voice-pipeline: add on-device Moonshine speech-to-text for the browser, the STT chain in the browser entry and a client transcript message (#300) (3ec472e)

0.13.113 (2026-10-13)​

fix​

  • voice-pipeline: drop a late final that arrives while the next utterance is spoken (#442) (653c38d)

0.13.112 (2026-10-13)​

fix​

  • telephony: keep carrier transports compatible with the voice pipeline and keep local call changes (#437) (4837b05)

0.13.111 (2026-10-13)​

fix​

  • orchestration: a parallel batch keeps every branch artifact and state, and a branch interrupt is yielded once (#398) (b0f6208)
  • safety: recheck the fence before a legacy reconcile settles an expired hold (#440) (8a8a151)

0.13.110 (2026-10-13)​

fix​

  • safety: serialize supplier admission, enforce lot eligibility and bind refunds (#435) (633d5b2)

0.13.109 (2026-10-13)​

fix​

  • agency: the beforeAgent check reads the task and earlier agents' output on their own under graph, review-loop and debate (#397) (26d1eb8)
  • meetings: fold of the meeting channel's review findings: the purged event's fields, the report time, the guide and the pricing note (#436) (b86bb29)

0.13.108 (2026-10-13)​

feat​

  • voice-platform: durable calls and scoped credentials (#431) (32a2106)

0.13.107 (2026-10-13)​

feat​

  • voice-pipeline: scoped call runtime seams (#421) (c85e884)

test​

  • meetings: pin the kill deadline a later pass arms for a leave or a purge written without one, and the stamp of lastReportAt (#433) (f78495f)

0.13.106 (2026-10-13)​

fix​

  • meetings: a fenced outbox sends outside its run's guard, so an enqueue and a participant's stop never wait for a destination (#432) (e1eb4da)

0.13.105 (2026-10-13)​

feat​

  • safety: compound credit with funding lots, every-attempt budgets and a margin report (#415) (ca25ebb)

0.13.104 (2026-10-13)​

fix​

  • telephony: carrier protocols and replay-safe call processing (#419) (f9ab0fd)

0.13.103 (2026-10-13)​

fix​

  • claims: read each array length and member once in the canonical JSON (#430) (734249d)

test​

  • meetings: pin the delivery fence's unfenced answer and the sealed creation context's run binding (#429) (faab961)

0.13.102 (2026-10-13)​

fix​

  • claims: write array holes as null in the canonical JSON (#428) (a55d13b)

0.13.101 (2026-10-13)​

feat​

  • safety: a checked egress module for outbound HTTPS (#424) (46ad2e9)

fix​

  • meetings: an exported, idempotent upgrade of the meeting stores' schema (#427) (8f4f62a)
  • rag: the Hnswlib store takes only its own file names from its manifest, and the manifest scanner checks each file against its capability's folder (#426) (e757c15)

0.13.100 (2026-10-13)​

feat​

  • auth: content keys and independent deletion journal (#422) (217d315)
  • claims: a deterministic evidence verifier for published claims (#420) (0477b13)
  • meetings: recoverable creation and adjusted dispatch allowances (#412) (37a0d82)
  • safety: a deferred outcome for expired holds in the spend meters (#418) (c9bada5)
  • voice-platform: closed call contracts and generated OpenAPI (#417) (5cea06f)

docs​

  • voice: Deepgram's add-ons are billed on top of the priced row (#425) (156e162)

0.13.99 (2026-10-13)​

fix​

  • meetings: end runs whose worker cannot be reached (#403) (e487054)

feat​

  • meetings: visitor-bound demonstration capabilities (#416) (636ab30)

0.13.98 (2026-10-13)​

fix​

  • meetings: fence an outbox so a purge cancels the run's sends under way and later deliveries carry no content (#414) (7bce8f7)

0.13.97 (2026-10-13)​

feat​

  • meetings: an outbox dispatcher for signed deliveries (#401) (79219ea)

0.13.96 (2026-10-13)​

fix​

  • skills: read skill and soul files without following links (#404) (fdd5515)

0.13.95 (2026-10-13)​

fix​

  • voice-pipeline: report transport sends that reject instead of leaving them unhandled (#399) (a7f3175)

0.13.94 (2026-10-13)​

fix​

  • voice-pipeline: pair a speech end with the final that came before it, and drop a final left over from a completed turn (#396) (97e2b3b)

0.13.93 (2026-10-13)​

feat​

  • voice-pipeline: Deepgram's streaming price a minute (#402) (6186e70)

0.13.92 (2026-10-13)​

fix​

  • discovery: a capability's files are read only inside its folder, agent workspace folders stay inside the base folder, and follow-ups from the cold read of #338 (#392) (5c6539b)

0.13.91 (2026-10-13)​

fix​

  • agency: graph, review-loop and debate gate the input each agent receives, and a replaced final text meets the output check (#393) (c1e716a)

0.13.90 (2026-10-13)​

fix​

  • voice-pipeline: keep each clause of a turn whose finals arrive after the next utterance starts (#306) (e58b14a)

0.13.89 (2026-10-13)​

fix​

  • meetings: follow-ups to #376: the provenance helpers' prefix bound, NoCapacityError's TSDoc and LifecycleSerial's ordering tests (#389) (bcf37db)

0.13.88 (2026-10-13)​

fix​

  • guardrails: close a blocked stream even when its refusal cannot be saved (#387) (864941b)
  • meetings: the follow-ups' forward fixes: the interlock's order on the worker's clock, the loop's two passes, handlers before destinations, the late notice first, finals during startCapture (#388) (16dce24)

0.13.87 (2026-10-13)​

fix​

  • meetings: a dispatch the provider refuses for good, and a report that arrives during dispatch (#376) (df4f0b2)

0.13.86 (2026-10-13)​

fix​

  • guardrails: a blocked tool call is refused before it runs, and a blocked external call leaves the saved pause (#384) (dcfe023)
  • meetings: the channel's follow-ups: lease, delivery, store and transport edge cases (#386) (d925ceb)

docs​

  • correct the GMI paper's T1 grading, preset moods and gate re-run cap (#385) (4f649e6)
  • fourteenth round of audit follow-ups (the P2 leftovers of the cold reads) (#377) (0a7da7d)

0.13.85 (2026-10-13)​

fix​

  • api: embedText checks every input's size before the first request (#381) (318d26a)

0.13.84 (2026-10-13)​

feat​

  • api: embedText sends a long list in requests the provider takes (#379) (35592b7)

0.13.83 (2026-10-13)​

feat​

  • api: verify session citations, validate generate output and add working-memory blocks (#378) (2d61bd6)

docs​

  • correct the GMI paper's data statement and its fallback memory endpoint (#374) (4bd20b1)
  • correct the GMI study's user-data and report lines (#372) (ed49ab2)

0.13.82 (2026-10-12)​

feat​

  • meetings: export the meeting channel, the meeting-provider extension kind and its page (#373) (cf49a2d)

0.13.81 (2026-10-12)​

fix​

  • agency: the post-approval check also reads the agent's input without the approval's instructions (#360) (b382c69)

0.13.80 (2026-10-12)​

feat​

  • meetings: Postgres stores for the meeting channel (#368) (98bf43a)
  • voice-pipeline: the LiveKit transport holds a bounded buffer while paused and reports the gap (#369) (a893837)

fix​

  • logging: keep people's words, model output, keys and phone numbers off the log lines (#370) (e8bf3af)

0.13.79 (2026-10-12)​

feat​

  • voice-pipeline: a listen-only session and a transcriber that reconnects (#367) (6a4c7c6)

0.13.78 (2026-10-12)​

fix​

  • orchestration: the graph saves its checkpoint before yielding an interrupt, and the communication bus retry cap holds (#354) (40f7960)
  • voice-pipeline: the orchestrator re-emits turn_complete, so waitForUserTurn resolves (#356) (a7a00d9)

0.13.77 (2026-10-12)​

fix​

  • images: the delete of a Replicate upload is given ten seconds (#359) (f0d5864)

0.13.76 (2026-10-12)​

fix​

  • images: Replicate gets an input image from 1 MB through its Files API, and each image as its own type (#358) (3839eb3)

0.13.75 (2026-10-12)​

feat​

  • meetings: the meeting manager: a run's life from the request to the content-free record (#337) (3d4b5fc)

0.13.74 (2026-10-12)​

fix​

  • runtime: a multimodal turn's retrieval feedback carries its text, not its image data (#355) (7cc36c9)

0.13.73 (2026-10-12)​

fix​

  • api: a key goes only to the provider the call names, and each key has its own breaker (#350) (4653d9d)

0.13.72 (2026-10-12)​

fix​

  • runtime: a turn's vision inputs reach the model as image parts, and memory keeps its text (#352) (2942b1a)

0.13.71 (2026-10-12)​

fix​

  • images: Fal edits run on Flux Dev's edit endpoints, and Flux Redux takes its reference as redux_image (#351) (164d242), closes included

docs​

  • add the method draft of the GMI versus agent() paper (#349) (288c3ca)
  • correct the sources of the GMI paper's result tables (#353) (51f6a71)

0.13.70 (2026-10-12)​

fix​

  • vision: the cloud tier keeps the image on its configured provider, performOCR uses its key and transcribes (#347) (2adb4cd)

0.13.69 (2026-10-12)​

fix​

  • gateway: onFallback reports the most recent error, as the walkers do (#348) (c1b4847)
  • gemini: read data URLs in linear time, send https images for Gemini to fetch, and read every block as a content filter (#342) (ad4df66)

0.13.68 (2026-10-12)​

fix​

  • gateway: gmi() forwards the failed hop's error, the walk reads the walkers' tier, and its skips wait for a walk (#346) (5444af5)

0.13.67 (2026-10-12)​

fix​

  • agency: the post-approval check reads the approved input, and output guards receive tool-call chunks (#340) (a81d09d)
  • api: send the routing keys of customModelParams with the planning call (#329) (7271cc3)
  • gateway: the completion gateway resolves and walks its chain as generateText and streamText do (#341) (b4c8280)

0.13.66 (2026-10-12)​

fix​

  • emergent: forged tool names are held to the name rule and skill exports write only inside their folder, and export follow-ups from the cold read of #332 (#338) (ff8e6c5)

docs​

  • name the late calls charged to a later turn on the GMI study page (#339) (b2957fa)

0.13.65 (2026-10-12)​

fix​

  • memory: Markdown and Obsidian exports write only inside the export folder, and wiki follow-ups from the cold read of #323 (#332) (4f64750)

0.13.64 (2026-10-12)​

feat​

  • meetings: a meeting-participant channel: types, provider interface, stores and signing (#327) (1fe6ad6)

docs​

  • add the GMI versus agent() study page (#333) (0d2aab0)
  • correct claims in the files #319 changed (bus retries, HITL, API types) (#331) (be2e82f)

0.13.63 (2026-10-12)​

fix​

  • images: edits keep sending GIF as PNG, a typed raw answer is kept, and Fal lists its FLUX.2 generation models (#330) (d6e4625)

0.13.62 (2026-10-12)​

fix​

  • images: style transfer follow-ups from the cold read of #322 (#328) (dc7fb4c)

0.13.61 (2026-10-12)​

fix​

  • memory: wiki page ids stay inside the memory folder (#323) (45e9d5a)

0.13.60 (2026-10-12)​

fix​

  • images: an edit sends its image as its own type, and an answer without an image fails (#324) (3de2f82)

0.13.59 (2026-10-12)​

fix​

  • images: transferStyle sends the source and the style reference (#322) (32761ce)

docs​

  • providers: a Gemini CLI tool-call block whose body is not JSON streams as text (#320) (76c0fe7)
  • thirteenth round of audit follow-ups (diagram alt texts, the PII page, HITL gaps) (#319) (01dfe54)

0.13.58 (2026-10-12)​

fix​

  • providers: structured-output replies always reach stream consumers, and Gemini tool-call markup never streams as text (#315) (48d82bb)

0.13.57 (2026-10-12)​

feat​

  • hearing: add a LiveKit room audio source and a LiveKit stream transport (#282) (11a41a3)

docs​

  • correct claims in the files #264 changed (levels table, guardrail examples, CLI registry steps) (#316) (5ac50dc)

0.13.56 (2026-10-11)​

feat​

  • learning: personality section on every GMI turn behind the learning flag (#294) (b9abbff)

0.13.55 (2026-10-11)​

fix​

  • memory: guardedFetch tries the next checked address when the first cannot be reached (#314) (a48b696)

0.13.54 (2026-10-11)​

fix​

  • providers: structured-output text replies reach stream consumers, and execute() guards its error-result parse (#310) (e88581f)

0.13.53 (2026-10-11)​

fix​

  • providers: a caller's abort after a CLI has exited still ends its stream as an abort (#307) (a08104f)

docs​

  • correct the ecosystem guide and the docs-alignment test's descriptions (#308) (4e1e79f)

0.13.52 (2026-10-11)​

fix​

  • providers: CLI bridges decode split UTF-8, keep the timeout on the child, and read the Gemini session id (#304) (fe4dcee)

0.13.51 (2026-10-11)​

fix​

  • memory: guardedFetch reads an answer with no Content-Type as application/octet-stream (#305) (f8fd71f)

0.13.50 (2026-10-11)​

feat​

  • vision: a cloudTask option asks the cloud tier for the text alone (#301) (2552104)

fix​

  • deps: bump @framers/* deps to latest published versions (#303) (6278c44)

ci​

  • weekly pull request that bumps the @framers/* dependencies (#266) (a9cad59)

0.13.49 (2026-10-11)​

fix​

  • memory: the fixed cut moves on at every turn (#298) (c3090c5)

0.13.48 (2026-10-11)​

fix​

  • sandbox: a CLI run that fails while the stream's consumer waits is no unhandled rejection (#296) (babc568)

0.13.47 (2026-10-11)​

fix​

  • memory: review follow-ups for front matter read as data (#293) (a4ee306)

0.13.46 (2026-10-11)​

feat​

  • hearing: audio pieces in the page, by packet copy or decoded to 16 kHz mono (#285) (ba2b7d9)

0.13.45 (2026-10-11)​

fix​

  • providers: CLI bridges read the current stream shapes, end the child on early close, and keep error causes (#289) (371f88e)

0.13.44 (2026-10-11)​

docs​

  • twelfth round of audit follow-ups (the docs-alignment routes, the manifest paths) (#288) (65268a8)

fix​

  • memory: guardedFetch counts the body on the wire and reads the network's NAT64 prefixes (#287) (984997f)

test​

  • vision: the model check runs the layout tier through process with its tier named (#286) (7886ac2)

0.13.43 (2026-10-11)​

fix​

  • images: the inline size limit counts characters outside ASCII, which Node decodes by their low byte (#284) (26acf47)

0.13.42 (2026-10-11)​

feat​

  • hearing: a batch transcription job: pieces in order, retries, merged seams (#262) (9d6eb3c)
  • storage: add a browser key-value store, an outbox and list reconciliation (#275) (91377cf)

0.13.41 (2026-10-11)​

fix​

  • providers: health checks draw one key, CLI bridges classify errors by case and abort, stream results carry is_error (#277) (e888fa8)

0.13.40 (2026-10-11)​

feat​

  • auth: OAuth for a web server: a redirect flow, sealed secrets and a sealed token store (#242) (59a20d1)
  • voice-pipeline: build a speech-to-text chain from provider entries (#176) (29046f2)

fix​

  • images: a local A1111 edit reports the checkpoint the server rendered with (#279) (3744044)
  • images: the untrusted image fetch closes six gaps a security review found (#278) (b99ecbc)
  • memory: the guarded fetch's deadline covers decoding, and a network refusal names no resolver detail (#280) (7d8bc9e)

docs​

  • eleventh round of audit follow-ups (two pages published, the agent() and gmi() guides aligned) (#264) (d4d3c6d)

0.13.39 (2026-10-11)​

feat​

  • voice: phraseHeard, a given sentence found in a transcript's first lines (#244) (973f118)

fix​

  • images: OpenAI image calls default to GPT Image 2.5, off the models OpenAI retires on 23 October and 1 December (#273) (971161d)

0.13.38 (2026-10-11)​

feat​

  • voice-pipeline: add an OpenAI Realtime transcription provider with item-keyed transcripts and connection rollover (#200) (c253939)

0.13.37 (2026-10-10)​

fix​

  • images: edit, upscale and variation calls use the provider's own default model, and OpenAI variations go through the edits endpoint (#261) (08005cf)

0.13.36 (2026-10-10)​

fix​

  • memory: read and write front matter as data, never as code (#265) (af3801b)

0.13.35 (2026-10-10)​

feat​

  • memory: a guarded fetch, and UrlLoader over any loader source (#249) (a531e02)

ci​

  • links: the online link check takes github.com's 429 and 503 as reachable (#259) (90ca3c7)

0.13.34 (2026-10-10)​

feat​

  • rag: add LexicalIndex, the BM25 engine without Node, saved and restored, with BM25Index on top of it (#246) (5c71e81)

0.13.33 (2026-10-10)​

fix​

  • library: a search with anyOf is documented as the index runs it: one embedding, and a fused score only when both legs run (#256) (9bf616c)

test​

  • vision: Gemini detection through the real generateText and Gemini provider (#255) (1deb685)

0.13.32 (2026-10-10)​

fix​

  • vision: the OCR tiers read ppu-paddle-ocr 6 and tesseract.js 7, and Gemini detection names the gemini provider (#253) (3e903f6)

0.13.31 (2026-10-10)​

feat​

  • library: a search narrowed to several folders, and several narrowings at once (#251) (6ba17b9)
  • memory: read a document in a worker thread with a heap cap and a deadline (#248) (46b109d)

docs​

  • tenth round of audit follow-ups to the guides (#228) (1b8ad33)

0.13.30 (2026-10-10)​

fix​

  • vision: the local model tiers load and run, and a failed tier is reported (#252) (4da8895)

0.13.29 (2026-10-10)​

feat​

  • library: add LibraryIndex over any vector store, chunkTurns and lexicalTokens (#224) (2397507)

0.13.28 (2026-10-10)​

fix​

  • api: an abort during a call's last tool round or its after-generation hook ends the call on the signal's reason (#233) (2270cf0)

0.13.27 (2026-10-10)​

fix​

  • rag: return a hybrid search's score as a number (#235) (7981a08)

0.13.26 (2026-10-10)​

fix​

  • safety: review follow-ups for the SQL spend meter's prefix (#232) (0b50624)

0.13.25 (2026-10-10)​

feat​

  • api: cancel generation and embedding calls with an AbortSignal (#231) (59c8bdf)

0.13.24 (2026-10-10)​

feat​

  • safety: SqlSpendMeter's tables named by a prefix (#226) (379c8e6)

0.13.23 (2026-10-10)​

fix​

  • gmi: follow-ups from the reviews of #193 and #199 (#217) (2bacb69)
  • gmi: manager shutdown waits for creations in flight, bounds each GMI and runs once (#222) (d99b126)
  • images: the untrusted fetch settles on a protocol upgrade, and four review follow-ups (#227) (9efb4b5)
  • vision: the TrOCR and Florence-2 tiers get a Buffer image as a Blob (#229) (7fe444a)

0.13.22 (2026-10-10)​

feat​

  • memory: bound DocxLoader by what a Word file's archive inflates to (#205) (b9931bf)

docs​

  • ninth round of audit follow-ups to the guides (#221) (c105869)

0.13.21 (2026-10-10)​

feat​

  • api: a spend budget for a run of calls (#185) (6220c21)

0.13.20 (2026-10-10)​

feat​

  • rag: make PostgresVectorStore serve many tenants in one collection (#203) (92c9806)
  • safety: a rolling window and a purge for the SQL spend meter (#216) (9aea463)

0.13.19 (2026-10-09)​

fix​

  • export: a Feishu channel's encryptKey is redacted (#218) (cde68cf)
  • routing: the policy router matches a required capability under either spelling (#213) (e8ab3b6)

0.13.18 (2026-10-09)​

fix​

  • speech: a whisper-compatible server's model is asked for verbose_json by default (#214) (e355fcb)

docs​

  • eighth round of audit follow-ups to the guides (#208) (e178ecf)

0.13.17 (2026-10-09)​

fix​

  • openrouter: the wait after a content_filter finish is bounded (#212) (c9f60f7)

0.13.16 (2026-10-09)​

feat​

  • images: imageToBuffer reads untrusted input from public addresses only (#211) (31805b1)

0.13.15 (2026-10-09)​

fix​

  • gmi: shut every GMI down when the manager shuts down (#210) (e4df6dd)

0.13.14 (2026-10-09)​

fix​

  • tools: tool arguments and output previews reach the console only when tool-call logging is on (#207) (ef8efd4)

0.13.13 (2026-10-09)​

fix​

  • gmi: follow-ups from the review of the gmi() guide (#199) (e002c5b)

docs​

  • seventh round of audit follow-ups to the guides (#201) (31219f0)

0.13.12 (2026-10-09)​

feat​

  • hearing: carry the finals' times on the LiveKit transcription streams (#198) (9a65feb)

docs​

  • sixth round of audit follow-ups to the guides (#195) (002b4ee)

0.13.11 (2026-10-09)​

fix​

  • gmi: follow-ups from the review of #175 (#193) (d9f0dd8)

0.13.10 (2026-10-09)​

fix​

  • config: honor provider model and timeout defaults (#194) (c5860d4)

docs​

  • fifth round of audit follow-ups to the guides (#171) (e64d2d6)
  • publication: publish the structured reply guide (#191) (a5f0d51)
  • the gmi() guide and agent({ runtime: 'gmi' }) (#192) (e6c6305)

0.13.9 (2026-10-09)​

feat​

  • hearing: capture a page's microphone through an AudioWorklet (#182) (ea5ca2f)

0.13.8 (2026-10-09)​

fix​

  • gmi: structured sends, tool hooks and close() follow-ups (#175) (4628852)

feat​

  • evaluation: score a transcript by its word error rate (#187) (3fc3fc5)

0.13.7 (2026-10-09)​

fix​

  • guardrails: the review's remaining findings on the required guards (#189) (c3e37a9)

0.13.6 (2026-10-09)​

feat​

  • voice-pipeline: an input level and a watch for an input that carries no sound (#180) (7afa875)

0.13.5 (2026-10-09)​

feat​

  • api: a schema-validated structured reply on processRequest (#177) (710f266)

0.13.4 (2026-10-09)​

docs​

  • the capability ceiling and the effect capabilities in the self-extension and architecture pages (#188) (8bf953d)

feat​

  • emergent: writes, deletes and state-changing requests for code-forged tools (#183) (2ca7fa2)
  • voice-pipeline: write transcripts into a LiveKit room as transcription streams, and read them back (#174) (a20ff4f)

0.13.3 (2026-10-08)​

feat​

  • guardrails: required guards, hold-until-final output, phrase lists and hard limits (#169) (032fcbf)

fix​

  • emergent: QuickJSExecutor follow-ups from the cold read of #160 (#178) (2ec4535)

0.13.2 (2026-10-08)​

fix​

  • api: gmi() follow-ups (session privacy, stream stop, usage on errors) (4e80849)

ci​

  • a gate that holds a breaking change until a maintainer approves it (#170) (c288e60)

docs​

  • fourth round of audit follow-ups to the guides (#162) (a7ab6c2)

0.13.1 (2026-10-08)​

fix​

  • emergent: bound what QuickJSExecutor copies out of the guest (#168) (5dd510e)

0.13.0 (2026-10-08)​

⚠ BREAKING CHANGE​

  • speech: URL output (providerSpecificOptions.outputFormat 'url') downloads only from hosts listed in audioUrlHosts, or in MINIMAX_TTS_AUDIO_URL_HOSTS through SpeechRuntime; without one, synthesize() throws instead of fetching. MiniMaxAsyncSpeechResponse.task_id is number | string instead of string, and file_id is number | string instead of number.

feat​

  • safety: a persisted spend meter that processRequest reserves against before any provider call (#167) (b9c2e91)

fix​

  • api: five defects from a cold read of the gmi() session runner (#165) (5eec49c)
  • speech: download MiniMax URL output only from allowed hosts, query async tasks with GET (#166) (14b86bf)

0.12.24 (2026-10-08)​

fix​

  • llm: map Requesty's model list from the shape its API returns (#164) (bbcabc3)

0.12.23 (2026-10-08)​

fix​

  • channels: accept a Plivo callback once and sign V3 as plivo-python does (#163) (fe31524)

0.12.22 (2026-10-08)​

feat​

  • emergent: QuickJSExecutor, an isolating executor for forged code (#160) (598d041)

0.12.21 (2026-10-08)​

docs​

  • third round of audit follow-ups to the guides (#158) (2aa186b)

feat​

  • add LiteLLM as AI gateway provider (#15) (068e6ce)
  • api: agent({ runtime: 'gmi' }) routes its sessions through gmi() (cf3a637)

0.12.20 (2026-10-08)​

feat​

  • add MiniMax TTS provider (#39) (b7f03ad)

0.12.19 (2026-10-08)​

feat​

  • add Requesty as an OpenAI-compatible LLM provider (#17) (58f90a1)

0.12.18 (2026-10-08)​

feat​

  • channels: add Plivo SMS channel adapter (#20) (d5ff215)

0.12.17 (2026-10-08)​

feat​

  • add MiniMax image generation provider (#56) (9d21348)

0.12.16 (2026-10-08)​

fix​

  • llm: Gemini sends image parts; transferStyle sends a key only to a provider the call names (#156) (e8b4d5f)

0.12.15 (2026-10-08)​

fix​

  • emergent: five defects from a second cold read of the stored-tool and composition code (#155) (3229b10)

ci​

  • a workflow that resolves the lockfile for a branch (#157) (4457a40)

0.12.14 (2026-10-08)​

docs​

  • second round of audit follow-ups to the guides (#150) (3b74c6c)

feat​

  • api: gmi(), an agent whose sessions are GMIs (daa9273)

fix​

  • vision: the cloud tier sends the image as an image part; vision and style transfer take a key (#154) (1a4db02)

0.12.13 (2026-10-08)​

fix​

  • hitl: close the review findings on the approval gate (#153) (53547bc)

0.12.12 (2026-10-08)​

fix​

  • sandbox: the output limit is measured in bytes, and a forged call that passes it on either stream fails (#151) (b83f058)

0.12.11 (2026-10-08)​

fix​

  • emergent: a forged tool's result past the in-process output limit fails the call instead of coming back cut (#149) (45570bb)

0.12.10 (2026-10-08)​

feat​

  • emergent: forged code runs through an executor interface, and a CI run measures QuickJS (#148) (3c5832a)

docs​

  • audit follow-ups to the GMI step contract and gateway docs (#147) (000547a)
  • gmi: correct the step contract and document completion options, history and the gateway (#145) (ff883a4)

ci​

  • check that package exports point at built files (#146) (fee43be)

0.12.9 (2026-10-08)​

fix​

  • emergent: six hardening fixes for the forged-tool ceiling (#144) (06a8a96)

0.12.8 (2026-10-08)​

fix​

  • agency: a seat that sets provider: undefined is judged by the provider its calls use before it inherits the agency key (#120) (65b1be1)
  • export: a credentials object inside an item of a tools list is redacted (#119) (d95b5cf)
  • openrouter: the wait for a choice-level error's usage line is bounded, ends on the error event, and reads the abort line (#143) (f4479cd)

0.12.7 (2026-10-08)​

fix​

  • emergent: fifteen defects from a cold read of the stored-tool and composition code (#140) (f515e1b)
  • openrouter: a choice-level stream error waits for its usage line, and the written-id exclusion is pinned (#141) (91dce0d)

0.12.6 (2026-10-08)​

chore​

  • examples: the Mars example's forged code runs under a ceiling (#138) (a95ce08)

fix​

  • images: a processing instruction in a DOCTYPE subset is read whole (#137) (1452648)

0.12.5 (2026-10-08)​

fix​

  • openrouter: a choice-level stream error walks on, an error event keeps its usage, and leg checks read the sent model (#136) (5815f26)

feat​

  • emergent: a ceiling for forged code, a broker for its capabilities, and a record of every capability call (#134) (52f1f83)

0.12.4 (2026-10-07)​

feat​

  • fallback: the policy chain follows the catalog ladder, legs run as named, oversized requests skip small models (547973d)
  • runtime: completion gateway and the GMI step contract (#129) (fa936a7)

0.12.3 (2026-10-07)​

fix​

  • images: a DOCTYPE's quoted literals no longer end it early (#133) (b2c3646)

0.12.2 (2026-10-07)​

fix​

  • images: SVG detection reads the root element, and error previews stop at 40 characters (#132) (9b0fb44)
  • speech: a streaming feature requirement follows the streaming capability (#131) (2ddb996)

0.12.1 (2026-10-07)​

fix​

  • emergent: stored chains load at any depth, admissions of a tool run in turn, and inner refusals stay inner (d853bfd)

0.12.0 (2026-10-07)​

⚠ BREAKING CHANGE​

  • emergent: a composition or workflow step no longer chains a tool with side effects unless the host lists it in emergent.compose.sideEffectingTools, and never chains a tool whose hasSideEffects is unset; ComposableToolBuilder needs a StepGate to compose (a bare callback still constructs but composes nothing, compose_needs_gate); allowSandboxTools: false now also loads stored code tools suspended (sandbox_tools_off); a composed tool's approval moves from the composed call to its side-effecting steps.

feat​

  • emergent: compose mode runs every step through a gate (0c637aa)

test​

  • openrouter: streamText keeps the text that arrives with the finish reason (#127) (04df6e8)

0.11.7 (2026-10-07)​

fix​

  • emergent: a load adopts only rows unchanged since its read, and settlement re-checks (d1bda8e)

0.11.6 (2026-10-07)​

fix​

  • emergent: legacy owners load suspended, and a per-tool generation guards adoption (b6b61c9)
  • images: do not attach the payload-carrying read error as cause (#124) (a3eb89e)
  • openrouter: keep the text and tool-argument deltas of the finish chunk (#125) (eb5fc8d)
  • speech: take a provider's streaming capability from the instance, and a catalog entry only of its own kind (#126) (0f0bfbc)

0.11.5 (2026-10-07)​

fix​

  • speech: build every keyed core provider in SpeechRuntime, and make its register methods reach the resolver (#123) (346b2f7)

0.11.4 (2026-10-07)​

fix​

  • anthropic: drop strict mode for a schema over the strict complexity limits (#121) (88507ea)
  • images: decode raw base64 BMP, ICO, JPEG 2000, JPEG XL and SVG, and stop echoing base64 in errors (#122) (ed6bf45)

0.11.3 (2026-10-07)​

fix​

  • speech: read a real ExtensionManager on refresh, and drop stale preference boosts (#117) (a10a51f)

0.11.2 (2026-10-07)​

fix​

  • llm: keep every variant's schema for a property the Anthropic union merge shares (#114) (ca60ae1)

0.11.1 (2026-10-07)​

fix​

  • images: decode raw base64 that contains "/" instead of reading it as a file path (#110) (3bc42c1)
  • model: split a colon-qualified model id only on a known provider prefix, never under ollama (#106) (6f68209)
  • openrouter: keep the role of the final streamed message (#112) (ffeb2f1)
  • speech: keep registered providers on refresh and never resolve one without an instance (#109) (48b5e53)

feat​

  • speech: current provider defaults for speech and transcription (#115) (c9147b6)

docs​

  • agency: describe what agency() shares (#111) (5b9f428)

0.11.0 (2026-10-07)​

⚠ BREAKING CHANGE​

  • export: redact secrets by default, mark instances and pre-built seats, take secrets and values on import (#99)

fix​

  • emergent: stored tools load through one checked path, and a suspension holds (d640311)
  • export: redact secrets by default, mark instances and pre-built seats, take secrets and values on import (#99) (7afad92)
  • hitl: enforce approvals.beforeTool through a per-call gate on every tool loop (#107) (6ed4ed9)

0.10.40 (2026-10-07)​

feat​

  • gmi: reasoning trace size set per persona or runtime config (#98) (b544794)

docs​

  • concept pages for the two API paths, the turn lifecycle, memory, self-extension and agencies; architecture and emergent pages corrected (#100) (abdf22e)

0.10.39 (2026-10-07)​

fix​

  • hierarchical: delegate and spawn tools return output the manager can read (#101) (4be9e5f)

0.10.38 (2026-10-07)​

feat​

  • personas: define personas inline with a built-in in-memory loader (#97) (6785eb2)

docs​

  • say what a GMI adds over a plain agent and put GMIs first in Concepts (#96) (f38e5fc)

0.10.37 (2026-10-07)​

fix​

  • api: let structured calls turn thinking off and run the Anthropic rescue leg on Sonnet 5.5 (#88) (1c9afbf)

0.10.36 (2026-10-07)​

fix​

  • nlp: decide language by script before trigram scoring (#80) (84ea2d0)

0.10.35 (2026-10-07)​

fix​

  • api: agent() warns on cognitiveMechanisms, agency().connect() rejects (#95) (6f53042)

docs​

  • correct the GMI page and repair moved source links (#92) (fc799ec)
  • say how sponsors are featured in the provider list (#81) (d9ae8e9)
  • say that a failed publish is not retried (#73) (c32014c)
  • say what the in-process executor does and does not do (#82) (15e411e)

chore​

  • deps: move every dependency to the newest version its range admits (#71) (f3871c2)
  • deps: runtime majors: execa 10, minimatch 10, pino 10, uuid 14 (#78) (d487abf)
  • deps: semantic-release 25 and its plugins (#77) (42ab9ad)
  • deps: tooling majors: eslint 10, rimraf 6, better-sqlite3 13, Node 22 types (#75) (a61fca1)
  • deps: vitest 5 (#76) (f2bc9a2)

ci​

0.10.34 (2026-10-05)​

0.10.33 (2026-10-05)​

0.10.32 (2026-10-05)​

0.10.31 (2026-10-04)​

0.10.30 (2026-10-04)​

0.10.29 (2026-10-04)​

0.10.28 (2026-10-02)​

0.10.27 (2026-10-02)​

0.10.26 (2026-10-01)​

0.10.25 (2026-10-01)​

0.10.24 (2026-09-30)​

0.10.23 (2026-09-30)​

0.10.22 (2026-09-30)​

0.10.21 (2026-09-30)​

0.10.20 (2026-09-29)​

0.10.19 (2026-09-27)​

0.10.18 (2026-09-12)​

0.10.17 (2026-09-11)​

0.10.16 (2026-09-10)​

0.10.15 (2026-09-10)​

0.10.14 (2026-08-07)​

0.10.13 (2026-08-07)​

0.10.12 (2026-08-07)​

0.10.11 (2026-08-05)​

0.10.10 (2026-08-05)​

0.10.9 (2026-08-05)​

0.10.8 (2026-08-05)​

0.10.7 (2026-08-05)​

0.10.6 (2026-08-05)​

0.10.5 (2026-08-05)​

0.10.4 (2026-07-29)​

0.10.3 (2026-07-28)​

0.10.2 (2026-07-28)​

0.10.1 (2026-07-26)​

0.10.0 (2026-07-22)​

BREAKING CHANGE​

  • sessions on memory:false agents now retain conversation history by default; pass history: false for the previous stateless behavior. Session histories default to bounded eviction past 120K estimated tokens on every agent. AgentSession.messages() returns the transcript-typed view.

0.9.164 (2026-07-20)​

0.9.163 (2026-07-20)​

0.9.162 (2026-07-20)​

0.9.161 (2026-07-20)​

0.9.160 (2026-07-20)​

0.9.159 (2026-07-20)​

0.9.158 (2026-07-20)​

0.9.157 (2026-07-20)​

0.9.156 (2026-07-18)​

0.9.155 (2026-07-16)​

0.9.154 (2026-07-16)​

0.9.153 (2026-07-16)​

0.9.152 (2026-07-16)​

0.9.151 (2026-07-16)​

0.9.150 (2026-07-16)​

0.9.149 (2026-07-16)​

0.9.148 (2026-07-16)​

0.9.147 (2026-07-16)​

0.9.146 (2026-07-15)​

0.9.145 (2026-07-15)​

0.9.144 (2026-07-15)​

0.9.143 (2026-07-15)​

0.9.142 (2026-07-15)​

0.9.141 (2026-07-15)​

0.9.140 (2026-07-14)​

0.9.139 (2026-07-14)​

0.9.138 (2026-07-12)​

0.9.137 (2026-07-12)​

0.9.136 (2026-07-12)​

0.9.135 (2026-07-11)​

0.9.134 (2026-07-11)​

0.9.133 (2026-07-11)​

0.9.132 (2026-07-10)​

0.9.131 (2026-07-10)​

0.9.130 (2026-07-10)​

0.9.129 (2026-07-10)​

0.9.128 (2026-07-09)​

0.9.127 (2026-07-09)​

0.9.126 (2026-07-09)​

0.9.125 (2026-07-09)​

0.9.124 (2026-07-09)​

0.9.123 (2026-07-09)​

0.9.122 (2026-07-09)​

0.9.121 (2026-07-08)​

0.9.120 (2026-07-08)​

0.9.119 (2026-07-08)​

0.9.118 (2026-07-08)​

0.9.117 (2026-07-07)​

0.9.116 (2026-07-07)​

0.9.115 (2026-07-07)​

0.9.114 (2026-07-06)​

0.9.113 (2026-07-06)​

0.9.112 (2026-07-06)​

0.9.111 (2026-07-06)​

0.9.110 (2026-07-06)​

0.9.109 (2026-07-06)​

0.9.108 (2026-07-06)​

0.9.107 (2026-07-06)​

0.9.106 (2026-07-06)​

0.9.105 (2026-07-05)​

0.9.104 (2026-07-05)​

0.9.103 (2026-07-05)​

0.9.102 (2026-07-05)​

0.9.101 (2026-07-05)​

0.9.100 (2026-07-04)​

0.9.99 (2026-07-04)​

0.9.98 (2026-07-03)​

0.9.97 (2026-07-03)​

0.9.96 (2026-07-03)​

0.9.95 (2026-07-03)​

0.9.94 (2026-07-02)​

0.9.93 (2026-07-02)​

0.9.92 (2026-07-02)​

0.9.91 (2026-07-01)​

0.9.90 (2026-07-01)​

0.9.89 (2026-06-30)​

0.9.88 (2026-06-28)​

0.9.87 (2026-06-27)​

0.9.86 (2026-06-27)​

0.9.85 (2026-06-26)​

0.9.84 (2026-06-26)​

0.9.83 (2026-06-25)​

0.9.82 (2026-06-25)​

0.9.81 (2026-06-25)​

0.9.80 (2026-06-25)​

0.9.79 (2026-06-24)​

0.9.78 (2026-06-22)​

0.9.77 (2026-06-20)​

0.9.76 (2026-06-20)​

0.9.75 (2026-06-19)​

0.9.74 (2026-06-19)​

0.9.73 (2026-06-18)​

0.9.72 (2026-06-18)​

0.9.71 (2026-06-18)​

0.9.70 (2026-06-18)​

0.9.69 (2026-06-18)​

0.9.68 (2026-06-18)​

0.9.67 (2026-06-18)​

0.9.66 (2026-06-18)​

0.9.65 (2026-06-18)​

0.9.64 (2026-06-18)​

0.9.63 (2026-06-14)​

0.9.62 (2026-06-13)​

0.9.61 (2026-06-13)​

0.9.60 (2026-06-12)​

0.9.59 (2026-06-12)​

0.9.58 (2026-06-12)​

0.9.57 (2026-06-10)​

0.9.56 (2026-06-09)​

0.9.55 (2026-06-09)​

0.9.54 (2026-06-09)​

0.9.53 (2026-06-08)​

0.9.52 (2026-06-08)​

0.9.51 (2026-06-08)​

0.9.50 (2026-06-08)​

0.9.49 (2026-06-08)​

0.9.48 (2026-06-06)​

0.9.47 (2026-06-06)​

0.9.46 (2026-06-05)​

0.9.45 (2026-06-05)​

0.9.44 (2026-06-04)​

0.9.43 (2026-06-04)​

0.9.42 (2026-06-04)​

0.9.41 (2026-06-04)​

0.9.40 (2026-06-04)​

0.9.39 (2026-06-04)​

0.9.38 (2026-06-04)​

0.9.37 (2026-06-04)​

0.9.36 (2026-06-03)​

0.9.35 (2026-06-03)​

0.9.34 (2026-06-03)​

0.9.33 (2026-06-02)​

0.9.32 (2026-06-02)​

0.9.31 (2026-06-01)​

0.9.30 (2026-05-31)​

0.9.29 (2026-05-30)​

0.9.28 (2026-05-30)​

0.9.27 (2026-05-30)​

0.9.26 (2026-05-30)​

0.9.25 (2026-05-29)​

0.9.24 (2026-05-29)​

0.9.23 (2026-05-28)​

0.9.22 (2026-05-28)​

0.9.21 (2026-05-27)​

0.9.20 (2026-05-22)​

0.9.19 (2026-05-21)​

0.9.18 (2026-05-18)​

0.9.17 (2026-05-18)​

0.9.16 (2026-05-17)​

0.9.15 (2026-05-17)​

0.9.14 (2026-05-17)​

0.9.13 (2026-05-17)​

0.9.12 (2026-05-15)​

0.9.11 (2026-05-15)​

0.9.10 (2026-05-14)​

0.9.9 (2026-05-12)​

0.9.8 (2026-05-12)​

0.9.7 (2026-05-12)​

0.9.6 (2026-05-12)​

0.9.5 (2026-05-12)​

0.9.4 (2026-05-11)​

0.9.3 (2026-05-11)​

0.9.2 (2026-05-11)​

0.9.1 (2026-05-10)​

0.9.0 (2026-05-10)​

BREAKING CHANGE​

  • anything importing @framers/agentos/orchestration/agents/* must update to @framers/agentos/agents/*. The main @framers/agentos barrel re-exports the same surface so consumers using the package root are unaffected.

0.8.0 (2026-05-10)​

  • feat!: drop VerifiedResponse.summary, expose formatVerifiedResponse helper (ca9f5d1)
  • docs: voice + SEO frontmatter on cognitive-pipeline, cognitive-mechanisms, agency-api (c12aff6)
  • docs: voice rewrite safety-primitives + hexaco SEO keywords (4b9a980)

BREAKING CHANGE​

  • VerifiedResponse no longer includes summary. Replace result.summary with formatVerifiedResponse(result) from @framers/agentos.

0.7.7 (2026-05-10)​

  • fix(docs): repair 4 stale links to deleted emergent-agency-system + COGNITIVE_MEMORY_GUIDE pages (Wa (f49b5c7)
  • docs: convert remaining ASCII flows to themed Mermaid (emergent observability, memory data flow, vis (fad0f1a)
  • docs: drop multi-gmi-collaboration + emergent-agency-system pages (already sidebar-hidden, content c (41c2282)
  • docs: drop redundant cognitive-memory-guide; consolidate into cognitive-memory hero. fix 5 inbound l (45882d2)
  • docs: GMI hero SVG embed; convert cognitive-pipeline + capability-discovery ASCII to themed Mermaid (d12c058)
  • docs: surface SoulLoader across docs (publication-manifest, ARCHITECTURE, EXAMPLES, HIGH_LEVEL_API, (4c2a83a)
  • docs: voice rewrite + SEO frontmatter for memory-system-overview, agent-communication, planning-engi (358123a)
  • docs(cognitive-memory): voice polish - tighten Overview opener, sharpen Encoding/Mastra section titl (2d91d83)
  • docs(emergent-capabilities): voice rewrite of lead - McLuhan epigraph + first-person hook + footgun (b4991c2)
  • docs(gmi): add reflective close ('what this means in practice') + fix dead link from emergent-agency (c236a15)
  • docs(system-architecture): convert all 5 remaining ASCII diagrams - GMI lifecycle (Mermaid stateDiag (8c831b7)
  • docs(system-architecture): voice rewrite of lead - Maslow epigraph + scar-set narrative; tighten GMI (451e910)
  • seo: add meta descriptions + keywords frontmatter to system-architecture, cognitive-memory, emergent (35d0009)
  • Merge branch 'master' of https://github.com/framerslab/agentos (196d3e2)
  • refactor!: remove _aliases deprecation shims, canonical paths only (f76ad47)

0.7.6 (2026-05-10)​

  • fix(lint): replace require() with static import in soul loader; drop unused eslint-disable directive (3fa2311)
  • docs(agent-communication): bus hero SVG; replace ASCII three-layer stack (217877c)
  • docs(ecosystem): convert ASCII stack to themed Mermaid (6bdfdec)
  • docs(emergent-capabilities): forge-loop hero SVG; replace ASCII flow (e86d805)
  • docs(memory): convert end-to-end 3-lane ASCII to themed Mermaid (ingest · recall · read) (0f2e7aa)
  • docs(memory): convert ingest pipeline to themed Mermaid; flatten 12-table grid to a clean table (2dd286e)
  • docs(memory): three-tier hero SVG; replace ASCII stack (d958d5a)
  • docs(planning-engine): hero SVG; replace ASCII stack (9604490)
  • docs(recursive-self-building): convert ASCII loop to themed Mermaid (70ba126)
  • docs(telephony): convert ASCII media-stream pipeline to themed Mermaid (f41bf15)

0.7.5 (2026-05-10)​

  • feat(personas): wire SoulLoader into agent() factory — soul: 'path' | { content } | { path } short (159efe7)
  • docs: replace deleted blog references with docs links (46842c1)
  • docs(memory): memory-system-overview hero SVG; replace 80-line ASCII flow chart (868344f)

0.7.4 (2026-05-10)​

0.7.3 (2026-05-10)​

0.7.2 (2026-05-10)​

  • feat(api): policy-aware fallback chain for content_policy refusals (99131c4)

0.7.1 (2026-05-10)​

  • fix(exports): expose ./memory/* wildcard for backward-compat deep imports (ee250db)
  • docs: hoist diagrams to top of cognitive-memory, hexaco, and paracosm pages (64d45fc)
  • docs: regroup guides hierarchy into 20 sections (Concepts, Cognitive Pipeline, Personas, Tools, Capa (b8cc09e)
  • docs: remove backward-compat hedging from public docs and JSDoc (db7588f)
  • docs(architecture): system-architecture hero SVG; replace ASCII layered stack (23ef7ad)

0.7.0 (2026-05-09)​

  • fix(kernel): apply codemod-driven import path fixes to 32 previously skip-worktree files (5b019b0)
  • merge: integrate origin/master 0.6.30 release (55206de)
  • feat!: kernel restructure into 7 parent dirs (api, core, orchestration, cognition, io, extensions, safety) (ecd868f)
  • docs: remove dead links to nonexistent extension-loading.md and skills-engine.md (e11d2c2)
  • kernel: add 16 deprecation aliases + barrel index.ts files + new exports map (07d4dd0)
  • kernel: add seven parent-dir READMEs as new layout scaffolding (62e8f40)
  • kernel: regroup src/ into 7 parent dirs (api, core, orchestration, cognition, io, extensions, safety (a361b68)
  • scripts: add codemod-restructure for kernel reorg import rewrites (9ce2160)

BREAKING CHANGE​

  • subpath imports under @framers/agentos/ have been moved to new locations under api/, core/, orchestration/, cognition/, io/, extensions/, or safety/. Sixteen specific legacy subpaths continue to work in 0.7.x via deprecation aliases that emit a one-shot dev-mode console warning. Migrate to the new canonical paths before 0.8.0 (where the aliases will be removed).

0.6.30 (2026-05-09)​

  • fix(image): normalize null replicate option to undefined in editImage (f52ebb4)

0.6.29 (2026-05-09)​

  • fix(image): respect caller-pinned model on mature/private-adult routing (00baef3)

0.6.28 (2026-05-09)​

  • fix(memory-reflector): tighten type-classification prompt for 'remember X' inputs (d6067e3)
  • docs(memory): embed SVG diagrams in HEXACO + cognitive memory; reorder Memory sidebar by logical flo (a9a7bb2)
  • docs(paracosm): embed world-model split, turn-flow, and divergence SVGs (5fc71cd)

0.6.27 (2026-05-07)​

0.6.26 (2026-05-07)​

  • feat(orchestration): plannerConfig.plan accepts pre-generated SimplePlan (0723be6)
  • docs(memory): add HEXACO personality guide and surface cognitive memory guide in sidebar (e81a05e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (addb645)
  • test(orchestration): pin parallel-branch telemetry forwarding + compound-goal classifier behaviour (b3f94dd)

0.6.25 (2026-05-07)​

0.6.24 (2026-05-07)​

0.6.23 (2026-05-07)​

0.6.22 (2026-05-07)​

0.6.21 (2026-05-07)​

0.6.20 (2026-05-07)​

0.6.19 (2026-05-07)​

0.6.18 (2026-05-07)​

  • fix(orchestration): goal-aware, phase-distinct stub mission planner (b6f4007)
  • docs(memory): add high-level 'how it connects' summary near top of overview (92b80b3)

0.6.17 (2026-05-06)​

  • fix(docs): register MEMORY_SYSTEM_OVERVIEW.md in publication manifest (5bdc01f)
  • docs: register Wunderland sidebar section + add Wunderland row to README ecosystem (705ef1a)

0.6.16 (2026-05-06)​

  • fix(docs): update compileScenario typedoc link path after paracosm regen (914d202)
  • chore: untrack 25 mars-genesis output fixtures + generalize internal-doc gitignore (ecba5c3)
  • docs: update paracosm integration surface (63bb531)
  • docs(memory): add MEMORY_SYSTEM_OVERVIEW.md study writeup (3d2a51f)

0.6.15 (2026-05-06)​

  • fix(docs): correct multi-channel cookbook imports + adapter API (0434dd3)

0.6.14 (2026-05-05)​

  • fix: stop saying 'same crises' for paracosm — Event Director is LLM-driven, events diverge per leade (9fe4930)
  • docs(paracosm): two-world-model framing — visual vs structured + open-source-first positioning (379c013)
  • docs(readme): drop Paracosm-flavored 'turn six' phrasing (514c48a)

0.6.13 (2026-05-05)​

  • perf(routing): prefer Hermes 70B over 405B for mature tier + expose stream provider/model (adda611)

0.6.12 (2026-05-03)​

  • fix(api): isRetryableError reads httpStatus + matches credit/quota phrases (52ddad7)

0.6.11 (2026-05-03)​

  • fix(openrouter): prefix HTTP status in error message so isRetryableError catches 402/429 (3271ba5)

0.6.10 (2026-05-03)​

  • fix(openrouter): default max_tokens to 4096 to avoid OR credit-reservation 402 on short prompts (0a139a9)

0.6.9 (2026-05-03)​

  • fix(api): strip date suffix when remapping anthropic models to OpenRouter fallback (6512a50)

0.6.8 (2026-05-03)​

  • fix: route /extensions and /skills to canonical section pages (369f418)

0.6.7 (2026-05-03)​

  • feat(seo): expand npm metadata — homepage, repository, bugs, richer description and keywords (860e69a)
  • chore(coderabbit): skip internal planning docs to prevent 300-file cap (739ee50)
  • chore(deps): bump @framers/* to latest npm versions (1c682f0)
  • add core concepts overview before level-based examples (c28f15b)
  • add live run screenshot to emergent capabilities doc (b6a6853)
  • add live-run gallery references to feature docs (c3fe2f5)
  • drop broken actorconfig link to unblock live-docs build (59485d8)
  • fix three broken examples and drop dead blog links (b4d9109)
  • fix(config,docs): default DATABASE_URL + finish COST_OPTIMIZATION rewrite (39dfc23)
  • fix(personas,docs): tolerate missing personas dir + accept personaSource alias (07bbc8b)
  • lead readme with tool generation and specialist spawning (b27495b)
  • standardize provider config across getting-started examples (5185216)
  • streamline readme: hoist ecosystem, compress emergent and benchmarks (734aeba)
  • docs: add LongMemEval-S 85.6% + LongMemEval-M 70.2% + agentos-bench badges (c522da7)
  • docs: bump stale model id + add helper stubs for tutorial-style snippets (17119b6)
  • docs: stub host-side dependencies in router/RAG/discovery snippets (9b7892d)
  • docs(paracosm): align tagline with agent-swarm + world-modeling positioning + swarm API surface (9110b36)
  • docs(paracosm): fix LeaderConfig→ActorConfig stale type reference (17b590f)

0.6.6 (2026-05-02)​

  • feat(api): AgentOS.create() factory + z re-export + doc rewrites (f7aea7a)
  • fix(exports,docs): expose subpath modules + names referenced by docs (17685ee)

0.6.5 (2026-05-02)​

  • fix(generateObject): use OpenAI strict json_schema mode + extract helpers (6680847)
  • fix(usage,generateObject): in-memory usage tally + auto-sized output budget (e166147)

0.6.4 (2026-05-02)​

  • fix(provider-defaults): bump default Anthropic model to claude-sonnet-4-5-20250929 (16ca82c)

0.6.3 (2026-05-01)​

  • feat(api): add setProviderPriority() to reorder the auto-detect chain (786c565)
  • docs: clarify Emergence licensing in router docs (8c1f632)
  • docs: surface setDefaultProvider() across README/LLM_PROVIDERS/HIGH_LEVEL_API; consolidate READ/READ (fd54a29)

0.6.2 (2026-05-01)​

  • feat(api): add setDefaultProvider() module-level default + AgentOSConfig integration (c7ef009)

0.6.1 (2026-05-01)​

  • fix(docs): remove accidentally-created top-level reference stubs (c2a1e03)
  • docs: add References sections to 3 flagship docs (cognitive-memory, gmi, multimodal-rag) (3cc60da)
  • docs: add References sections to 8 more research-grounded docs (5de9ad9)
  • docs: cross-reference spawn_specialist in README + ARCHITECTURE (124fe0f)
  • docs(agency): set explicit scope — single-request multi-agent only (068a5af)

0.6.0 (2026-05-01)​

  • fix(tests): unblock CI — soften docs-alignment + update vision/image test expectations (2d20da0)

0.5.15 (2026-05-01)​

  • feat(emergent): finalize spawn_specialist — judge model defaults, HITL gate, runnable example (8c77cbd)
  • docs: cross-reference spawn_specialist in AGENCY_API + GMI (2a71c15)

0.5.14 (2026-05-01)​

  • feat(emergent): add EmergentAgentForge for runtime agent synthesis (5f9bc28)
  • feat(emergent): add EmergentAgentJudge for spec-level safety review (db0e499)
  • feat(strategies): hierarchical agency can spawn specialists when emergent (b061fb8)
  • feat(strategies): wire EmergentAgentJudge gate into spawn_specialist (5e97f05)
  • feat(types): add EmergentPlannerConfig to EmergentConfig (6f33705)
  • docs: add GMI architecture overview page (68dac3c)
  • docs: narrative voice + accuracy pass on architecture + cognitive memory (37a600e)
  • docs: narrative voice intro for LLM Providers and Voice Pipeline (280f471)
  • docs: narrative-voice intros across orchestration + channels + observability (bbb8289)
  • docs: rewrite GMI page line-by-line against actual source (1059cf5)

0.5.13 (2026-05-01)​

  • fix(README): correct V8 isolate / 10-second / no-network overclaims to actual node:vm specs (98bcfb9)
  • docs: add Emergent Design section explaining Runtime Tool Forging + optional HEXACO (e586adc)
  • docs: add intro section, generalize Emergent Design, drop Mars Genesis specifics (a813fbf)
  • docs: drop application-layer comparison paragraph from intro (a0ccb05)
  • docs: drop broken /api/modules#emergent typedoc anchor link (4f87578), closes api/modules#emergent
  • docs: HEXACO example now a long-running career coach with annotated traits (8558b3a)
  • docs: link transparency audit post + add brief summary of what it covers (9904e3c)
  • docs: memory benchmark callout on RAG / cognitive / multimodal pages (5731fe0)
  • docs: rename to UPPER_SNAKE convention + drop superseded mars-genesis v2 (70fddc2)
  • docs: replace Mars-colony HEXACO example with a parallel companion example (baca085)
  • docs: rewrite Emergent Design + Ecosystem table in calmer voice (011beea)
  • docs: rewrite Emergent Design intro for clarity (8546bb7)
  • docs: rewrite Emergent Design subsections in third-person declarative voice (d537242)
  • docs: route the AgentOS-side paracosm page to paracosm.agentos.sh/docs (feaeee6)
  • docs: streamline Memory Benchmarks section, keep every metric (05abd08)
  • drop redundant 'matched reader' qualifier — reader model already specified (7609e16)
  • Merge branch 'master' of https://github.com/framerslab/agentos (b44ccb6)
  • chore: gitignore + untrack mars-genesis planning docs, scrub CHANGELOG (e49e1fb)

0.5.12 (2026-04-30)​

  • fix(release): anchor next release after orphaned-tag recovery (a73dc2b)
  • chore(release): 0.2.0 [skip ci] (107749f)

0.2.0 (2026-04-30)​

  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (0b38000)
  • Merge branch 'master' of https://github.com/framerslab/agentos (264e19f)
  • Merge branch 'master' of https://github.com/framerslab/agentos (f9f9cae)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add extension auto-pickup + skills auto-discovery summary, license clarification (22add48)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: redirect /benchmarks links to LEADERBOARD.md, soften SOTA wording to benchmark tables (84dd048)
  • docs: remove broken markdown links to internal superpowers/ specs (5832156)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: realign package.json with npm latest after orphaned v0.5.x tags (44cc5f0)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (bec2c96)
  • chore(release): 0.2.0 [skip ci] (71277c4)
  • chore(release): 0.2.0 [skip ci] (1d60c00)
  • chore(release): 0.2.0 [skip ci] (b48919d)
  • chore(release): 0.2.0 [skip ci] (0c3ed89)
  • chore(release): 0.2.0 [skip ci] (8ebe616)
  • chore(release): 0.2.0 [skip ci] (a25afa3)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(orchestration): wire runtime deps + auto-promote outputs to artifacts (21fb704)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • readme: correct LongMemEval-M paper baseline (was 65.7, actual paper best is 72.0); soften S framing (51a65a7)
  • readme: drop range notation, lead with Mastra +1.4 win, drop memory-library mispositioning (08fab79)
  • readme: redirect broken transparency-audit link to agentos.sh canonical post (ed2965e)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(openrouter): consumer loop must wait for [DONE] not finish_reason; add usage tests (7e28324)
  • fix(openrouter): include usage in streaming responses + recognize trailing usage-only chunk (a699c5c)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(orchestration): wire runtime deps + auto-promote outputs to artifacts (21fb704)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • chore: bump version to 0.1.192 (2374475)
  • chore: realign package.json with npm latest after orphaned v0.5.x tags (44cc5f0)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (71277c4)
  • chore(release): 0.2.0 [skip ci] (1d60c00)
  • chore(release): 0.2.0 [skip ci] (b48919d)
  • chore(release): 0.2.0 [skip ci] (0c3ed89)
  • chore(release): 0.2.0 [skip ci] (8ebe616)
  • chore(release): 0.2.0 [skip ci] (a25afa3)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • readme: correct LongMemEval-M paper baseline (was 65.7, actual paper best is 72.0); soften S framing (51a65a7)
  • readme: drop range notation, lead with Mastra +1.4 win, drop memory-library mispositioning (08fab79)
  • readme: redirect broken transparency-audit link to agentos.sh canonical post (ed2965e)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (264e19f)
  • Merge branch 'master' of https://github.com/framerslab/agentos (f9f9cae)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add extension auto-pickup + skills auto-discovery summary, license clarification (22add48)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(openrouter): consumer loop must wait for [DONE] not finish_reason; add usage tests (7e28324)
  • fix(openrouter): include usage in streaming responses + recognize trailing usage-only chunk (a699c5c)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • readme: correct LongMemEval-M paper baseline (was 65.7, actual paper best is 72.0); soften S framing (51a65a7)
  • readme: drop range notation, lead with Mastra +1.4 win, drop memory-library mispositioning (08fab79)
  • readme: redirect broken transparency-audit link to agentos.sh canonical post (ed2965e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: realign package.json with npm latest after orphaned v0.5.x tags (44cc5f0)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (1d60c00)
  • chore(release): 0.2.0 [skip ci] (b48919d)
  • chore(release): 0.2.0 [skip ci] (0c3ed89)
  • chore(release): 0.2.0 [skip ci] (8ebe616)
  • chore(release): 0.2.0 [skip ci] (a25afa3)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (264e19f)
  • Merge branch 'master' of https://github.com/framerslab/agentos (f9f9cae)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add extension auto-pickup + skills auto-discovery summary, license clarification (22add48)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(openrouter): consumer loop must wait for [DONE] not finish_reason; add usage tests (7e28324)
  • fix(openrouter): include usage in streaming responses + recognize trailing usage-only chunk (a699c5c)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • readme: correct LongMemEval-M paper baseline (was 65.7, actual paper best is 72.0); soften S framing (51a65a7)
  • readme: drop range notation, lead with Mastra +1.4 win, drop memory-library mispositioning (08fab79)
  • chore: bump version to 0.1.192 (2374475)
  • chore: realign package.json with npm latest after orphaned v0.5.x tags (44cc5f0)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (b48919d)
  • chore(release): 0.2.0 [skip ci] (0c3ed89)
  • chore(release): 0.2.0 [skip ci] (8ebe616)
  • chore(release): 0.2.0 [skip ci] (a25afa3)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (264e19f)
  • Merge branch 'master' of https://github.com/framerslab/agentos (f9f9cae)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add extension auto-pickup + skills auto-discovery summary, license clarification (22add48)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(openrouter): consumer loop must wait for [DONE] not finish_reason; add usage tests (7e28324)
  • fix(openrouter): include usage in streaming responses + recognize trailing usage-only chunk (a699c5c)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (264e19f)
  • Merge branch 'master' of https://github.com/framerslab/agentos (f9f9cae)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • chore: bump version to 0.1.192 (2374475)
  • chore: realign package.json with npm latest after orphaned v0.5.x tags (44cc5f0)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (0c3ed89)
  • chore(release): 0.2.0 [skip ci] (8ebe616)
  • chore(release): 0.2.0 [skip ci] (a25afa3)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add extension auto-pickup + skills auto-discovery summary, license clarification (22add48)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(openrouter): consumer loop must wait for [DONE] not finish_reason; add usage tests (7e28324)
  • fix(openrouter): include usage in streaming responses + recognize trailing usage-only chunk (a699c5c)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • readme: drop range notation, lead with Mastra +1.4 win, drop memory-library mispositioning (08fab79)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(openrouter): consumer loop must wait for [DONE] not finish_reason; add usage tests (7e28324)
  • fix(openrouter): include usage in streaming responses + recognize trailing usage-only chunk (a699c5c)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • readme: drop range notation, lead with Mastra +1.4 win, drop memory-library mispositioning (08fab79)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (8ebe616)
  • chore(release): 0.2.0 [skip ci] (a25afa3)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (f9f9cae)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (f9f9cae)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(openrouter): include usage in streaming responses + recognize trailing usage-only chunk (a699c5c)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (a25afa3)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (7f4ee6b)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): include usage in streaming responses (was always 0 tokens) (1c9b8a3)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (729a381)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(channels): use registerAdapter consistently + add missing register calls (30ee5c1)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (86647d9)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix channel adapter constructor + mockPrisma stub (post-coderabbit) (681b7d6)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (66336be)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite multi-doc API examples against real exports (a9945ad)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (1db7c03)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: fix createAgent fiction + stale demo path (d0d665e)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (3ce037d)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: drop agentos-cli fiction in MEMORY_SCALING + TELEPHONY_PROVIDERS (2438ff3)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (77957ce)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.2.0 (2026-04-30)​

  • docs: add 0.3.1 hardening pass changelog entry (3daea7e)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (f99a1ce)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (93afcde), closes hi#level
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (aaae802)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (d5b71e8)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (2a1cd7a)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (d8df3b6)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (e77b3c9)
  • docs: clarify cognitive mechanism count and persona drift as optional (e672137)
  • docs: document API key rotation as core AgentOS feature (6dddff1)
  • docs: document slash-format model strings and update model table (2ba056b)
  • docs: domain-neutral naming in paracosm + ecosystem guides (eba6133)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (2690c4c)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (78be02a)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (d89fa6d)
  • docs: streamline README for SEO and LLM crawling, unify Discord link (07bf5b6)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (d25fdaf)
  • docs: update model names and document slash-format support (adba9ce)
  • docs: update README with cognitive memory completion and LLM validation layer (da302e3)
  • docs(agent-config-export): drop CLI fiction, point at programmatic API (a395905)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (b9e1489)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (c198713)
  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (0c60245)
  • docs(memory): architecture doc for SessionRetriever (de57958)
  • docs(memory): document archived_traces brain_id source caveat (f3c3dfc)
  • docs(memory): document pool contention semantics for shared adapter brains (62a86e6)
  • docs(memory): explain Brain factory naming asymmetry (443b2aa)
  • docs(memory): HybridRetriever architecture doc (d5f1a84)
  • docs(memory): note importFromSqlite mutates the source file in-place (0dd21ce)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (af94abb)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (883cd09)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (127e036)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (8a3fe46)
  • docs(paracosm): reposition PARACOSM doc as structured world model (d2e8aed)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (99752af)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (5565b15)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (8ff2575)
  • docs(readme): document memoryProvider auto-wire on direct calls (f57c21e)
  • docs(readme): replace ratio with absolute cost-at-scale framing (a2652f1)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (0fb7ac5)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (34d4e09)
  • docs(readme): tighten Mastra comparison framing (68a071e)
  • chore: bump version to 0.1.192 (2374475)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (b6d83de)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (a2ac33b)
  • chore: untrack build artifacts and local db_data (a597991)
  • chore: update Discord invite link (f972c5c)
  • chore: update Discord invite to permanent link (cc9140b)
  • chore: update gitignore and db (14f732b)
  • chore(build): rebuild dist for provider catalog updates (edcc858)
  • chore(IProvider): tighten responseFormat type to admit json_schema shape (9ffac9d)
  • chore(pinecone): continue vector store refinements (65833a7)
  • chore(release): 0.1.178 [skip ci] (49b44de)
  • chore(release): 0.1.179 [skip ci] (8e42dfd)
  • chore(release): 0.1.180 [skip ci] (fcc04de)
  • chore(release): 0.1.181 [skip ci] (c497cf9)
  • chore(release): 0.1.182 (649a806)
  • chore(release): 0.1.182 [skip ci] (845cb12)
  • chore(release): 0.1.183 [skip ci] (c3db02d)
  • chore(release): 0.1.184 [skip ci] (7fe7e5a)
  • chore(release): 0.1.185 [skip ci] (0ce5c61)
  • chore(release): 0.1.186 [skip ci] (2b08d21)
  • chore(release): 0.1.187 [skip ci] (c779c8a)
  • chore(release): 0.1.188 [skip ci] (e613a63)
  • chore(release): 0.1.189 [skip ci] (4cf4cf2)
  • chore(release): 0.1.190 [skip ci] (92e2b1c)
  • chore(release): 0.1.191 [skip ci] (5868452)
  • chore(release): 0.1.192 [skip ci] (c909714)
  • chore(release): 0.1.193 [skip ci] (6119864)
  • chore(release): 0.1.194 [skip ci] (eb141cc)
  • chore(release): 0.1.195 [skip ci] (bec9f35)
  • chore(release): 0.1.196 [skip ci] (66eb9e3)
  • chore(release): 0.1.197 [skip ci] (9b38bb3)
  • chore(release): 0.1.198 [skip ci] (5326749)
  • chore(release): 0.1.199 [skip ci] (7f75a6d)
  • chore(release): 0.1.200 [skip ci] (66a0ba5)
  • chore(release): 0.1.201 [skip ci] (3202b45)
  • chore(release): 0.1.202 [skip ci] (b48330d)
  • chore(release): 0.1.203 [skip ci] (3c1e6b5)
  • chore(release): 0.1.204 [skip ci] (16b57c8)
  • chore(release): 0.1.205 [skip ci] (0cbff1f)
  • chore(release): 0.1.206 [skip ci] (16f6190)
  • chore(release): 0.1.207 [skip ci] (bb68274)
  • chore(release): 0.1.208 [skip ci] (926fd8f)
  • chore(release): 0.1.209 [skip ci] (684e61a)
  • chore(release): 0.1.210 [skip ci] (cf65bd3)
  • chore(release): 0.1.211 [skip ci] (ab9b100)
  • chore(release): 0.1.212 [skip ci] (3767771)
  • chore(release): 0.1.213 [skip ci] (148c444)
  • chore(release): 0.1.214 [skip ci] (5546ba0)
  • chore(release): 0.1.215 [skip ci] (5c393af)
  • chore(release): 0.1.216 [skip ci] (87c0509)
  • chore(release): 0.1.217 [skip ci] (b7ae370)
  • chore(release): 0.1.218 [skip ci] (cb7417f)
  • chore(release): 0.1.219 [skip ci] (c4b7ac2)
  • chore(release): 0.1.220 [skip ci] (5346933)
  • chore(release): 0.1.221 [skip ci] (1118731)
  • chore(release): 0.1.222 [skip ci] (3894437)
  • chore(release): 0.1.223 [skip ci] (1e0bb3f)
  • chore(release): 0.1.224 [skip ci] (2adc9f8)
  • chore(release): 0.1.225 [skip ci] (b771f43)
  • chore(release): 0.1.226 [skip ci] (1171e87)
  • chore(release): 0.1.227 [skip ci] (69ced36)
  • chore(release): 0.1.228 [skip ci] (81d9444)
  • chore(release): 0.1.229 [skip ci] (9879574)
  • chore(release): 0.1.230 [skip ci] (5e0f2eb)
  • chore(release): 0.1.231 [skip ci] (98c1cbd)
  • chore(release): 0.1.232 [skip ci] (64bf559)
  • chore(release): 0.1.233 [skip ci] (d11b769)
  • chore(release): 0.1.234 [skip ci] (81365a8)
  • chore(release): 0.1.235 [skip ci] (8ca0d2f)
  • chore(release): 0.1.236 [skip ci] (da40e83)
  • chore(release): 0.1.237 [skip ci] (a392103)
  • chore(release): 0.1.238 [skip ci] (b40bf06)
  • chore(release): 0.1.239 [skip ci] (cf6f081)
  • chore(release): 0.1.240 [skip ci] (7885a91)
  • chore(release): 0.1.241 [skip ci] (9f25c28)
  • chore(release): 0.1.242 [skip ci] (ff19dae)
  • chore(release): 0.1.243 [skip ci] (a341ceb)
  • chore(release): 0.1.244 [skip ci] (a6ebdfc)
  • chore(release): 0.1.245 [skip ci] (617fd05)
  • chore(release): 0.1.246 [skip ci] (62ad19d)
  • chore(release): 0.1.247 [skip ci] (fc3476d)
  • chore(release): 0.1.248 [skip ci] (8bbdfd1)
  • chore(release): 0.1.249 [skip ci] (057e8f7)
  • chore(release): 0.1.250 [skip ci] (72183d7)
  • chore(release): 0.1.251 [skip ci] (72406bf)
  • chore(release): 0.1.252 [skip ci] (efa0dae)
  • chore(release): 0.1.253 [skip ci] (cfd4480)
  • chore(release): 0.1.254 [skip ci] (689c4da)
  • chore(release): 0.1.255 [skip ci] (9d83878)
  • chore(release): 0.2.0 [skip ci] (2b3ffd5)
  • chore(release): 0.2.1 [skip ci] (69940c9)
  • chore(release): 0.2.10 [skip ci] (d3c2424)
  • chore(release): 0.2.11 [skip ci] (faa0cc5)
  • chore(release): 0.2.12 [skip ci] (35dede0)
  • chore(release): 0.2.2 [skip ci] (9e45e66)
  • chore(release): 0.2.3 [skip ci] (62c5938)
  • chore(release): 0.2.4 [skip ci] (574a95e)
  • chore(release): 0.2.5 [skip ci] (9fae662)
  • chore(release): 0.2.6 [skip ci] (9ec5e62)
  • chore(release): 0.2.7 [skip ci] (bb14d70)
  • chore(release): 0.2.8 [skip ci] (c108108)
  • chore(release): 0.2.9 [skip ci] (e664a26)
  • chore(release): 0.3.0 [skip ci] (b08e78a)
  • chore(release): 0.3.1 [skip ci] (af3a44f)
  • chore(release): 0.3.2 [skip ci] (40ebdb8)
  • chore(release): 0.3.3 [skip ci] (86d7fd5)
  • chore(release): 0.3.4 [skip ci] (662623c)
  • chore(release): 0.4.0 [skip ci] (bbf93d8)
  • chore(release): 0.4.1 [skip ci] (ca8aeb2)
  • chore(release): 0.5.0 [skip ci] (f8c14e8)
  • chore(release): 0.5.1 [skip ci] (2b4ad36)
  • chore(release): 0.5.10 [skip ci] (ce48428)
  • chore(release): 0.5.2 [skip ci] (dad86c2)
  • chore(release): 0.5.3 [skip ci] (131cb0b)
  • chore(release): 0.5.4 [skip ci] (3dc2991)
  • chore(release): 0.5.5 [skip ci] (6f0fa9d)
  • chore(release): 0.5.6 [skip ci] (42a01fd)
  • chore(release): 0.5.7 [skip ci] (6eda803)
  • chore(release): 0.5.8 [skip ci] (0aa71ec)
  • chore(release): 0.5.9 [skip ci] (610acb2)
  • feat: add API class citations and related links to emergent capabilities doc (f11968c)
  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (8264fed)
  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (b9e9abc)
  • feat: add ElevenLabsBatchTTS provider (58de6c7)
  • feat: add fallback + JSON mode + retry cap to generateObject (fd24737)
  • feat: add host llm policy routing (003204a)
  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (6934e8b)
  • feat: add key pool rotation to all 5 ElevenLabs providers (3a38ec5)
  • feat: add key pool rotation to all 6 OpenAI providers (c86de9a)
  • feat: add key pool rotation to all remaining providers (20 files) (cfaeef6)
  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (45b8c81)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (3e3e134)
  • feat: add OpenAIRealtimeTTS streaming provider (cb9a7d4)
  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (61c0be9)
  • feat: add quota error detection, singleton key pool registry, barrel export (6b5a600)
  • feat: add shared memory retrieval policy contract (1aadcf3)
  • feat: add shared retrieval confidence evaluation (3c94c89)
  • feat: default-on auto-fallback in generateText (aa5b83b)
  • feat: default-on auto-fallback in streamText (b9787e3)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (ac61159)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (83980e6)
  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (42cd22f)
  • feat: support provider/model slash format in model strings (14ef34e)
  • feat: thread retrieval policy through cognitive memory (73af9e5)
  • feat: unify retrieval policies across rag entrypoints (074fe9e)
  • feat: unify standalone and runtime long-term retrieval policy (384804e)
  • feat: update README to reference Paracosm instead of mars-genesis-simulation (714b87c)
  • feat: widen agent session send/stream to accept MessageContent (6e31b54)
  • feat: widen Message.content to MessageContent for multimodal support (65823fe)
  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (418baf7)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (3183bca)
  • feat(agent): expose per-call maxTokens on agent() config (cecb36c), closes hi#volume
  • feat(agent): session.send accepts responseSchema for typed structured output (0280c1a)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (7201e79)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (c615ed3)
  • feat(api): first-class policyTier routing for editImage + generateImage (150f105)
  • feat(api): structured telemetry on provider fallback chain (0a55b3a)
  • feat(docs): register /benchmarks page in publication manifest (6d834e3)
  • feat(emergent): forge observability utilities (6630291)
  • feat(emergent): optional generateTextWithSystem callback for judge prompt caching (a5a5f5e)
  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (b49619f)
  • feat(examples): add Mars Genesis entry points, README, and output dir (1770f01)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (518a329)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (d87ecb2)
  • feat(examples): add verified Mars Genesis output logs with live web search citations (278818a)
  • feat(examples): emergent tool forging fully working in Mars Genesis (6865e90)
  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (db17806)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (6f83a20)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (221dde5)
  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (3dc8158)
  • feat(image): character consistency, style transfer, provider modernization (d13e6dd), closes hi#level
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (485280b)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (cb2282e)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (3d92efb)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (7e0ba1b)
  • feat(ingest-router): types for summarized + entity-linking executors (1c41478)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (4c64a1d)
  • feat(mars-genesis): add canonical simulation state types (e6c1213)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (788f6d1)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (a92c9ec)
  • feat(mars-genesis): add seeded colonist population generator (6175aec)
  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (ab96a5b)
  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (ddff2b8)
  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (d5fabb7)
  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (94382dc)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (a11cba8)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (b1972e6)
  • feat(memory-router): add S-tuned per-category retrieval router preset (861f270)
  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (281031f)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (543fa84)
  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fb247d5)
  • feat(memory-router): productionize ReaderRouter primitive (211688b)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (d06172c)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (b316a24)
  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (4057ac7)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (c10d000)
  • feat(memory): add migrations/index.ts registry (219b89f)
  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (4574fe6)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (18e5259)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (2a61ac5)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (28a4376)
  • feat(memory): add subpath export for typed-network module (c1b26b7)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (abaefce)
  • feat(memory): auto-register commitment and intention notes as prospective items (12930fd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (a34c37d)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (800dfb3)
  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (6c81f17)
  • feat(memory): Brain storage abstraction v2 (universal SQLite + Postgres backbone) (cb4646d)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (1c1691a)
  • feat(memory): export AgentMemoryProvider type from public barrel (1fc8c9c)
  • feat(memory): export fact-graph module from memory barrel (e21e6ac)
  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (0565fa5)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (c473799)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (eba4c9f)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (6a24376)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (00ee687)
  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (7f49091)
  • feat(memory): heuristic entity extraction + graph activation wire-up (c2a250a)
  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (c8df078)
  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (31fb8f0)
  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (a193d1a)
  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (87f132f)
  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (b12f111)
  • feat(memory): re-export typed-network primitives from memory barrel (be7ded8)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (a3baf68)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (995bfbe)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a6d6917)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (3ca839a), closes hi#relevance
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (ad2e7ba)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (e0492b9)
  • feat(memory): wire Brain._initialize to MigrationRunner (fd42186)
  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (515b7c8)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (c04e4c8)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (95efa3a)
  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (ce3ab97)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (e0a0b1d)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (367057f)
  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (baf8e17)
  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (95a00e2)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (b72c5ce)
  • feat(validation): add centralized extractJson for LLM output parsing (b8c2302)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (27ac6f6)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (4527b87)
  • feat(voice): all existing providers implement HealthyProvider (8f68bbd)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (af9f387)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (4cffb37)
  • feat(voice): export new resilience symbols from package barrel (e8801ea)
  • feat(voice): HealthyProvider trait + capability helpers (41368b1)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (bddcb6a)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (0a3d102)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (918ceda)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (d9cf23c)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (ebd2c8a)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (01968dc)
  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (31c7d98)
  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (74289f4)
  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (e46a617)
  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (0477c26)
  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (a290958), closes #2
  • fix: align runtime contracts and docs publication (3ce9279)
  • fix: calibrate standalone recall confidence (99b5982)
  • fix: correct IKnowledgeGraph import path in memory specs (48a3bc0)
  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (ea5b58a)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (72ad9ec)
  • fix: resolve CI lint failures (unused imports, require() style) (0b8149f)
  • fix: skip voice transport adapter test that stalls on dynamic import (529f8f9)
  • fix: streamline Paracosm section in README (30f6c3b)
  • fix: update comparison blog URL to dated Docusaurus path (454601f)
  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (72a77d0)
  • fix(agency): UsageTotals carries + accumulates cache-token fields (235e380)
  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (3438769)
  • fix(api): autoDetectProvider prioritizes openrouter over openai (ce8a33d)
  • fix(api): correct ILogger signature on fallback telemetry calls (b68efcd)
  • fix(api): generateObject propagates prompt-cache tokens (0e33f38)
  • fix(api): streamText + streamObject propagate prompt-cache tokens (ad43257)
  • fix(build): handle multi-line import statements in fix-esm-imports (677e9c7)
  • fix(build): rewrite agentos self-package imports (d4715b3)
  • fix(ci): postgres adapter capabilities + drop unused vars (37f2da7)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (0409dc7)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (a906d2a)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (461a8cf)
  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (65de7dc)
  • fix(emergent): wrap-forge-tool tests pass strict tsc (c4c05e7)
  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (3c9a9e4)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (cc24bc5)
  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (957c37d)
  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (fed1428)
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (175a442)
  • fix(judge): tighten creation-review rubric to eliminate false rejects (103dbaf)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (f20adc3)
  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (d2431b5)
  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (dd55493)
  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (5953efa)
  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (0ca333e)
  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (6076635)
  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (2a2f6cc)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (fc7743a)
  • fix(memory): honour consolidation.enabled=false + unref timer (c08e6f0)
  • fix(memory): make Brain.close best-effort with logged failures (4c2ae83)
  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (ca8381f)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (885d2b9)
  • fix(memory): redact password in Brain.openPostgres connection errors (0c66a81)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (b694067)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (cdab6e1)
  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (bc6ae8b)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (afd2783)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f4abd37)
  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (86ca65c)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (207f887)
  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (fb602a1)
  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (19059ee)
  • fix(rag): export MetadataScan types + align Pinecone config contract (6fee364)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (0d622cf)
  • fix(read-router): typecheck failure on result.outcome.answer access (1b29049)
  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (45804f9)
  • fix(routing): remove dead uncensored text models from catalog (54b7ef0)
  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (8ea03c1)
  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (10aecc9)
  • fix(storage): ITokenUsage carries optional cache-token fields (21fe589)
  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (f403fc6)
  • fix(strategies): propagate cache tokens in all agency accumulators (1a5660b)
  • fix(structured-output): address coderabbit findings on session.send overload (b5da210), closes hi#relevance
  • fix(usage): UsageLedger forwards Anthropic cache-token counters (3631903)
  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (651bb98)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (2ccdacc)
  • feat(ingest-router,memory-router): Stage I entity-linking executors + ranker (678fef3)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (0cbb397)
  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (a30bbca)
  • Merge branch 'master' of https://github.com/framerslab/agentos (bec68fa)
  • Merge branch 'master' of https://github.com/framerslab/agentos (e0d858e)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a56d8fd)
  • Merge branch 'master' of https://github.com/framerslab/agentos (3378eeb)
  • Merge branch 'master' of https://github.com/framerslab/agentos (a50ed76)
  • Merge pull request #3 from framerslab/docs/auto-fallback-default (3e1cb5a), closes #3
  • Merge remote-tracking branch 'origin/master' (fa616b0)
  • Merge remote-tracking branch 'origin/master' (9687f05)
  • Merge remote-tracking branch 'origin/master' (8f65ca5)
  • Merge remote-tracking branch 'origin/master' (edc0073)
  • test: add integration tests for provider key rotation (0eba1a8)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (a4801b8)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (66f8987)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (dd11d6a)
  • test(memory): add full pipeline integration test for cognitive memory (cb8b20f)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (f0e0894)
  • test(memory): log Postgres test cleanup errors instead of swallowing (103b527)
  • test(storage): lock in SqlStorageAdapter cache-token migration (b986b94)
  • test(validation): add integration test for full validation pipeline (74e17e4)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (1ec8a52)
  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (9e042f6)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (bf204b2)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (b55d934)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (3ecce42)
  • refactor(memory): session.send uses applyMemoryProvider helper (50c828f)
  • refactor(memory): session.stream uses applyMemoryProvider helper (5dcc0a6)
  • refactor(memory): use ECMAScript private field syntax for #brainId (8ca6746), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (44b6820)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (5eff081)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (f1bd977)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (be9585e)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (414dd6a)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (18eca94)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (ca44097)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (b70b527)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (6c2efa3)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (cc83791)
  • memory: SessionRetriever for two-stage hierarchical retrieval (1e45e16)
  • memory: SessionRetriever integration tests with real in-memory components (3f72c55)
  • memory: SessionSummaryStore for session-level vector indexing (2d02fb2)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (3521e4a)
  • merge: integrate remote 0.1.224 release tag (d2c6276)
  • wip: save in-progress image changes (d1fdae9)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).
  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.
  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.5.10 (2026-04-30)​

  • feat(strategies): accumulate costUSD/cache tokens, render debate as judge verdict (494fbe4)
  • fix(ci): postgres adapter capabilities + drop unused vars (404e328)
  • docs(readme): replace ratio with absolute cost-at-scale framing (01ea3ff)
  • docs(readme): streamline from 551 to 258 lines, lead with SOTA numbers + CTAs (9b12b6a)
  • docs(readme): tighten Mastra comparison framing (bd44032)

0.5.9 (2026-04-29)​

  • feat(docs): register /benchmarks page in publication manifest (b3dc29b)
  • docs(readme): add quantitative SOTA benchmark tables (matched gpt-4o reader) (79da2ce)
  • docs(emergent,sandbox): clarify sandbox memory-limit enforcement is nominal not preemptive (ed2839a)

0.5.8 (2026-04-29)​

  • feat(memory): inject persistent markdown into prompt assembly + normalize Postgres DDL (0d27268)

0.5.7 (2026-04-29)​

  • feat(memory-router): productionize ReaderRouter primitive (162d7ab)

0.5.6 (2026-04-29)​

  • feat(memory-router): add topk50-mult5-on-MS S-tuned preset (follow-up to refuted HyDE preset) (fb79c65)

0.5.5 (2026-04-29)​

  • feat(memory-router): add S-tuned per-category retrieval router preset (9690d0f)
  • docs: surface 3-stage classifier-driven memory pipeline + add READER_ROUTER source doc (99ac99a)
  • docs(READER_ROUTER): add 'Why the default classifier is gpt-5-mini and not gpt-4o' subsection (ff1e26b)
  • docs(README): surface the classifier-driven memory pipeline as a top-level section (1aa864c)
  • chore: stop tracking tmp-parity.sqlite + ignore local sqlite test artifacts (6bc1dc7)

0.5.4 (2026-04-27)​

  • Merge pull request #3 from framerslab/docs/auto-fallback-default (b872c85), closes #3
  • fix(generate-text): document auto-fallback default; flag strict mode opt-out (2146a98)

0.5.3 (2026-04-27)​

  • fix(memory/typed-network): per-attempt 30s timeout on observer LLM invoke (4f41a8d)
  • feat(memory-router): augmented routing for backend × retrieval-config dispatch (fa14f7f)
  • Merge remote-tracking branch 'origin/master' (1dceecd)
  • docs(memory/typed-network): expand W/E/O/S abbreviation to full bank names (73cb557)

0.5.2 (2026-04-26)​

  • Merge remote-tracking branch 'origin/master' (297ec9e)
  • fix(memory/typed-network): tolerant observer parsing for gpt-5-mini extraction (7ee0ff5)

0.5.1 (2026-04-26)​

  • feat(memory): re-export typed-network primitives from memory barrel (f597978)
  • fix(structured-output): address coderabbit findings on session.send overload (198b0a0), closes hi#relevance

0.5.0 (2026-04-26)​

  • fix(memory): Stage E coderabbit C1+C2 - gate extractAtEncode + delegate retrieve to TypedNetworkRetr (01ea591)

BREAKING CHANGE​

  • CognitiveRetrievalResult.diagnostics.retrievedTypedFacts renamed to retrievedTypedTraces and now ScoredMemoryTrace[] instead of TypedFact[]. Stage E typed-network manager-side encoding now requires opt-in via config.typedNetwork.extractAtEncode (default false).

0.4.1 (2026-04-26)​

  • feat(memory/typed-network): TypedNetworkRetriever for canonical-shaped retrieval (230c6ae)

0.4.0 (2026-04-26)​

  • fix(agent+memory): unblock CI build (TS errors in 0.3.4 release commit) (cf045fa)
  • fix(memory): place retrievedTypedFacts inside diagnostics + add ScoredMemoryTrace import (64a5e69)
  • feat(agent): session.send accepts responseSchema for typed structured output (827b6b9)
  • feat(AnthropicProvider): forced tool-use for schema-enforced structured output (0ba00b9)
  • feat(GeminiProvider): responseSchema for schema-enforced structured output (b5e1bcb)
  • feat(memory): add subpath export for typed-network module (db9ea8b)
  • feat(memory): Stage E Phase 4.3 - retrieve() runs typed spreading activation (d0ab11c)

0.3.4 (2026-04-26)​

  • chore(IProvider): tighten responseFormat type to admit json_schema shape (1e5c4ac)
  • feat(memory): Stage E Phase 4.1 - typedNetwork config field + manager wiring (cac63c2)
  • feat(memory): Stage E Phase 4.2 - encode() routes through typed-network observer (a604d86)
  • feat(structured-output): provider-format adapter for session-aware schema enforcement (17f7198)
  • docs(spec+plan): session-aware structured output for agent.session.send (bcbdcf5)
  • Merge branch 'master' of https://github.com/framerslab/agentos (72a25d8)
  • Merge pull request #2 from framerslab/structured-output-spec (7c4d0e6), closes #2

0.3.3 (2026-04-26)​

  • fix(memory): MigrationRunner._readSchemaVersion handles v1 schema (no brain_id column) (794649a)
  • fix(memory): redact passwords in keyword-form Postgres connection strings (f4bc827)
  • fix(memory): use adapter.transaction in _bulkCopy to fix Postgres atomicity (e72d7cf)
  • fix(memory/typed-network): broaden stripCodeFence regex to any alphabetic language tag (f7ecef3)

0.3.2 (2026-04-26)​

  • feat(memory/typed-network): Phase 1 primitives (types + store + temporal overlap) (ebdf565)
  • feat(memory/typed-network): Phase 2 LLM observer (6-step extraction prompt + zod schema) (ee8f463)
  • feat(memory/typed-network): Phase 3 retrieval (spreading activation + 4-way RRF) (d867849)

0.3.1 (2026-04-26)​

  • docs: add 0.3.1 hardening pass changelog entry (6d72d2f)
  • docs(memory): document archived_traces brain_id source caveat (9efe4aa)
  • docs(memory): document pool contention semantics for shared adapter brains (8fd929f)
  • docs(memory): explain Brain factory naming asymmetry (fd3f3d3)
  • docs(memory): note importFromSqlite mutates the source file in-place (16c6b2b)
  • test(memory): add cross-dialect round-trip test (sqlite->postgres->sqlite) (3f6e2e0)
  • test(memory): add Postgres tests for concurrent open + FK + rollback (3e9001d)
  • test(memory): log Postgres test cleanup errors instead of swallowing (e71ce1d)
  • fix(memory): guard agent_id column existence in Postgres v1->v2 migration (ca31c3d)
  • fix(memory): make Brain.close best-effort with logged failures (09e4125)
  • fix(memory): redact password in Brain.openPostgres connection errors (75d00c3)
  • fix(memory): reject multi-brain source in Brain.importFromSqlite (9e51f3d)
  • refactor(memory): assert V2_TABLES order matches PORTABLE_TABLES (d9adf1a)
  • refactor(memory): hoist PORTABLE_TABLES to shared module (6b058a3)
  • refactor(memory): use ECMAScript private field syntax for #brainId (611d04a), closes #brainId
  • refactor(memory): use shared PORTABLE_TABLES in Brain.postgres test (b7a3ae9)
  • feat(memory): add MigrationRunner with transaction + lock + version-bump (f309028)
  • feat(memory): add migrations/index.ts registry (5963d1c)
  • feat(memory): export v1ToV2 as Migration object alongside legacy function (3e06300)
  • feat(memory): wire Brain._initialize to MigrationRunner (76cd58a)

0.3.1 (2026-04-25)​

Hardening pass for the Brain storage abstraction shipped in 0.3.0. Closes 16 correctness, maintainability, and polish gaps from the post-0.3.0 code review.

Critical fixes​

  • Schema migration is now fully transactional. Failure rolls back to the prior schema version cleanly. (C1)
  • Concurrent first-opens against the same brainId serialize via per-brain pg_advisory_xact_lock (Postgres) or BEGIN IMMEDIATE (SQLite). Two workers booting against the same brain no longer race. (C2)
  • Brain.importFromSqlite validates the source file contains exactly one brain_id and throws on multi-brain sources. Previously it silently collapsed all rows into the target brain. (C3)
  • schema_version is bumped atomically inside the migration transaction. Was previously stuck at '1' after a v1 to v2 migration because the seed used INSERT OR IGNORE. (C5)
  • Postgres archived_traces migration now checks for agent_id column existence before referencing it. Mirrors the SQLite path's existing guard. (I6)

Maintainability​

  • New MigrationRunner centralizes transaction wrapping, advisory locking, and version detection. Future schema migrations register a Migration object instead of re-implementing this logic.
  • PORTABLE_TABLES hoisted to a single shared module (store/portable-tables.ts). Adding a portable table now requires touching one file.
  • New migrations/index.ts registry exposes MIGRATIONS and LATEST_SCHEMA_VERSION constants. Both Brain._initialize and Brain._seedMeta derive from the registry.
  • Cross-dialect round-trip test (sqlite to postgres to sqlite) verifies the portability contract.

Polish​

  • Brain.openPostgres redacts the password segment from connection-failure error messages.
  • Brain.close is best-effort with logged failures: pool drain timeouts no longer propagate to shutdown callers.
  • _brainId private field uses ECMAScript # syntax (true private) instead of underscore convention.
  • Brain factory naming asymmetry (openSqlite/openPostgres vs openWithAdapter) documented in class JSDoc as intentional: by-dialect entry points vs by-pre-built-adapter escape hatch.
  • Postgres integration tests log cleanup errors to stderr instead of silently swallowing them.

Documentation​

  • docs/memory/POSTGRES_BACKEND.md documents pool-contention semantics for shared adapter brains.
  • Brain.importFromSqlite JSDoc warns that the source SQLite file is mutated in-place by the auto-migration.
  • archived_traces brain_id-from-agent_id behavior documented as a migration caveat.

Downgrade warning​

This release auto-migrates v1 schemas to v2 on first open. Downgrading from 0.3.x to 0.2.x is not supported by automatic migration. Restore from a pre-0.3.0 backup or use Brain.exportToSqlite and Brain.importFromSqlite to round-trip data through a portable file.

Out of scope​

  • A --rebrand-archives migration option (write archived_traces brain_id to the explicit override). Tracked as a follow-up.
  • A Postgres vs SQLite benchmark sweep on the agentos-bench suite. Tracked as a follow-up.

0.3.0 (2026-04-25)​

BREAKING CHANGE​

  • SqliteBrain, SqliteKnowledgeGraph, SqliteMemoryGraph, Brain.open(path), Brain.create(path), Memory.create({path}) all removed. Postgres deployments require brainId on every brain operation. Existing SQLite files auto-migrate on first open.

0.3.0 (2026-04-26)​

BREAKING CHANGES​

Brain storage abstraction (universal SQLite + Postgres backbone)​

The cognitive memory storage layer is dialect-agnostic. The class-name lie is fixed. Postgres is now a first-class backend.

Renames​
OldNew
SqliteBrainBrain
SqliteBrain.open(path)Brain.openSqlite(path)
SqliteBrain.create(path)Brain.openSqlite(path)
n/aBrain.openPostgres(connStr, { brainId, poolSize? })
n/aBrain.openWithAdapter(adapter, { brainId? })
SqliteKnowledgeGraphSqlKnowledgeGraph
SqliteMemoryGraphSqlMemoryGraph
Memory.create({ path, ... })Memory.createSqlite(path, opts?) (also accepts a config object for back-compat)
n/aMemory.createPostgres(connStr, { brainId, poolSize?, graph?, selfImprove?, ... })
n/aMemory.createWithAdapter(adapter, opts?)

SqliteImporter and SqliteExporter keep their names because they actually require the better-sqlite3 native module.

Schema v2: brain_id discriminator​

Every brain-owned table (14 total: 12 in the main DDL + 2 in the archive subsystem) gains a brain_id TEXT NOT NULL column with composite primary keys (brain_id, id) and indexes leading with brain_id. This enables multi-tenant brain storage in Postgres (many brains share one schema, scoped per query) without changing the per-file SQLite isolation model.

Existing SQLite files auto-migrate on first Brain.openSqlite() call. The migration is idempotent for both SQLite (uses the recreate-table dance) and Postgres (uses ALTER TABLE ADD COLUMN + new primary key constraint). Subsequent opens are no-ops once the schema is at v2.

Portable export / import​

Brain.exportToSqlite(path) materialises any brain (regardless of live backend) to a portable SQLite file. Brain.importFromSqlite(path, opts?) loads that file into a receiving Brain, rewriting brain_id to the receiving brain's identity. This means importing a snapshot under a different brainId produces a fork. The .wildsoul portability format stays SQLite-based even when production runs on Postgres.

const liveBrain = await Brain.openPostgres(connStr, { brainId: 'alice' });
await liveBrain.exportToSqlite('/tmp/alice-snapshot.sqlite');

const forkBrain = await Brain.openPostgres(connStr, { brainId: 'alice-fork' });
await forkBrain.importFromSqlite('/tmp/alice-snapshot.sqlite'); // fork
Postgres CI integration tests​

Brain.postgres.test.ts is gated on the AGENTOS_TEST_POSTGRES_URL env var. CI now provisions a pgvector/pgvector:pg16 service container and runs the suite against it. Local contributors without Postgres see all 5 postgres tests skipped (suite stays green).

Migration guide​

Most consumers upgrade with one-line search-replace:

// Before
await Memory.create({ path: './brain.sqlite', graph: true });

// After
await Memory.createSqlite('./brain.sqlite', { graph: true });
// (or pass the config object: Memory.createSqlite({ path, graph }) — both work)

For Postgres deployments (new):

const mem = await Memory.createPostgres(process.env.DATABASE_URL, {
brainId: 'companion-alice',
graph: true,
});

For sharing an adapter across foundation tables and brains:

const adapter = await createDatabase({ postgres: { connectionString } });
const brain = await Brain.openWithAdapter(adapter, { brainId: 'agent-1' });

0.2.12 (2026-04-25)​

  • Merge branch 'master' of https://github.com/framerslab/agentos (fc7cf50)
  • refactor(ingest-router): SummarizedIngestExecutor wraps existing SessionSummarizer (dbb3d31)
  • feat(ingest-router): add executors sub-barrel + top-level re-exports (7aaf38d)
  • feat(ingest-router): implement session summarizer with verbatim Anthropic prompt (a62a716)
  • feat(ingest-router): RawChunks + Skip reference executors + uniform outcome shape (8c4fa6f)
  • feat(ingest-router): SummarizedIngestExecutor with per-session caching (995954d)
  • feat(ingest-router): types for summarized + entity-linking executors (8823792)
  • test(ingest-router): SummarizedIngestExecutor + FunctionIngestDispatcher integration (d44f1e8)

0.2.11 (2026-04-25)​

  • docs(ingest-router): correct fact-graph attribution per Mem0 v3 graph removal (1fdef22)
  • docs(paracosm): note prompt/URL-grounded scenario authoring (630d913)
  • refactor(cognitive-pipeline): finish rename + clean lingering JSDoc refs (bbb46d8)

0.2.10 (2026-04-25)​

  • fix(read-router): typecheck failure on result.outcome.answer access (1651180)
  • docs(architecture): add Cognitive Pipeline section to ARCHITECTURE.md (425a9fc)

0.2.9 (2026-04-25)​

  • refactor(cognitive-pipeline): rename multi-stage-guardrails → cognitive-pipeline + ship 5 canonical (fc0dadb)

0.2.8 (2026-04-25)​

  • feat: ship multi-stage guardrails — ingest-router + read-router + adaptive memory-router + compositi (7866f7a)

0.2.7 (2026-04-24)​

  • feat(memory-router): LLM-as-judge orchestrator for per-query memory-architecture routing (fc4792c)

0.2.6 (2026-04-24)​

  • fix(sandbox): expand CodeSandbox hardening to block realm intrinsics (c748b26)

0.2.5 (2026-04-24)​

  • fix(sandbox): consolidate SandboxedToolForge to delegate to hardened CodeSandbox (eb7a812)

0.2.4 (2026-04-24)​

  • fix(anthropic-provider): drop temperature for Claude Opus 4.7 (9a7d90f)

0.2.3 (2026-04-24)​

  • fix(paracosm-doc): coderabbit review. correct Kirfel citation (39000de)
  • docs(paracosm): reposition PARACOSM doc as structured world model (aec39a3)
  • chore: untrack build artifacts and local db_data (d8f7bfc)

0.2.2 (2026-04-23)​

  • docs: domain-neutral naming in paracosm + ecosystem guides (49cb85b)
  • docs(emergent): add forge-observability section covering 5-utility telemetry API (45ef25e)
  • docs(paracosm): cover 0.6.0 universal schema + list as ecosystem app (0cb3fae)
  • docs(paracosm): P1 rename drift \u2014 colony \u2192 unit + finalState.colony \u2192 finalState.syst (2e3406d)
  • docs(paracosm): update scenario example for 0.7.0 time-unit field names (80fcc22)
  • fix(ecosystem): coderabbit review - point live demo to /sim path (49495b6)

0.2.1 (2026-04-22)​

  • Merge remote-tracking branch 'origin/master' (126d6e3)
  • fix(build): handle multi-line import statements in fix-esm-imports (72ddc75)
  • fix(deps): bump @framers/sql-storage-adapter peer + dev pin to ^0.6.3 (3ea2f3d)

0.2.0 (2026-04-22)​

  • fix(build): rewrite agentos self-package imports (cd22430)
  • fix(lint): drop unnecessary $ escape in MemoryReflector template literal (a472a53)
  • fix(rag): export MetadataScan types + align Pinecone config contract (fc724a8)
  • fix(rag): vector-store implementations handle number+string MetadataFieldCondition (a2030ba)
  • docs(plan): implementation plan for memoryProvider direct-call autowire (0.2.0) (307de07)
  • docs(readme): document memoryProvider auto-wire on direct calls (ad8988d)
  • docs(spec): mark memoryProvider-direct-call-autowire implemented (e2a2d43)
  • docs(spec): memoryProvider auto-wire on direct agent calls (0.2.0) (8bde92a)
  • feat(memory)!: memoryProvider auto-wires on all four agent call paths (d866ad4)
  • feat(memory): applyMemoryProvider helper + 10 unit tests (392c1bd)
  • feat(memory): auto-wire memoryProvider on direct agent.generate() (ab3a2d9)
  • feat(memory): auto-wire memoryProvider on direct agent.stream() + drop dead MEMORY_TIMEOUT_MS (13efc85)
  • feat(memory): export AgentMemoryProvider type from public barrel (9250da4)
  • feat(memory): heuristic entity extraction + graph activation wire-up (796467c)
  • feat(memory): thread enableGraphActivation through CognitiveMemoryConfig (d568b62)
  • feat(memory): type memoryProvider as AgentMemoryProvider interface (3a1785d)
  • feat(pinecone): add metadata scan, retry with backoff, and expanded tests (0cb6ba9)
  • refactor(memory): session.send uses applyMemoryProvider helper (4156084)
  • refactor(memory): session.stream uses applyMemoryProvider helper (38f0cf8)
  • chore: update Discord invite to permanent link (fb6fcb0)
  • chore(pinecone): continue vector store refinements (7021709)

BREAKING CHANGE​

  • Direct agent.stream() / agent.generate() now invoke memoryProvider.getContext before the LLM call and memoryProvider.observe after. Callers who passed memoryProvider on createAgent but did not want it to fire on direct calls (no legitimate use case) will see behavior change. Callers using .session() paths are unaffected — behavior unchanged.

Type change: memoryProvider: any is now typed as AgentMemoryProvider interface with optional getContext + observe methods. Callers passing malformed providers will see TypeScript errors at the provider boundary.

Migration:

  • .session() path: no change required, behavior unchanged.
  • Direct path wanting memory: already passed memoryProvider; now it works. Remove any manual onBeforeGeneration wiring that previously worked around the silent-ignore.
  • Direct path not wanting memory: remove memoryProvider from the createAgent config.

0.1.255 (2026-04-21)​

  • feat(memory): export REFLECTOR_PROMPT_HASH for content-addressed cache keys (c1fb669)

0.1.254 (2026-04-21)​

  • feat(memory): MemoryReflector prompt preserves literal tokens verbatim (35b75ae)

0.1.253 (2026-04-21)​

  • feat(memory): HybridRetriever fact-graph integration + synthetic trace prepending (1147043)

0.1.252 (2026-04-21)​

  • fix(llm-routing): drop MythoMax L2 13B from uncensored catalog (ef21e90)
  • feat(memory): export fact-graph module from memory barrel (7f05f56)
  • feat(memory): fact-graph canonicalization + 25-predicate closed schema (7f3af44)
  • feat(memory): FactExtractor — LLM fact extraction with closed schema + session cache (af4bbcc)
  • feat(memory): FactStore — in-memory fact-graph keyed by scope/subject/predicate (4d7b8fc)

0.1.251 (2026-04-21)​

  • feat(memory): HybridRetriever emits per-stage candidate IDs in diagnostics (b36c015)

0.1.250 (2026-04-21)​

  • fix(memory): flushReflection scopeOverride param — ensures reflection traces land in caller's scope, (1ac24cb)

0.1.249 (2026-04-21)​

  • feat(memory): getReflector() accessor + flushReflection() for forced reflection at caller boundaries (e21e08e)

0.1.248 (2026-04-21)​

  • feat(memory): HybridRetriever + progressive enhancement flags ship as v0.1.248 (5657f31)
  • memory: barrel exports + CognitiveMemoryManager.getRerankerService getter (e6ac741)
  • memory: barrel-export SessionSummaryStore + SessionRetriever; fix PADState import (a563cf0)
  • memory: FactSupersession post-retrieval LLM filter (drops superseded traces) (30ae52a)
  • memory: HybridRetriever for BM25 + dense RRF retrieval (b32099d)
  • memory: HybridRetriever integration tests with real MemoryStore + BM25Index (d44001a)
  • memory: HybridRetriever split-on-ambiguous rerank refinement (monotonic, additive) (c2c0a52)
  • memory: optional HyDE retriever in HybridRetriever (hypothesis for dense+sparse, original query for (3781d75)
  • memory: reciprocalRankFusion for rank-based fusion of retrievers (9c4a6f4)
  • memory: restore SessionSummarizer + tests (tracked file missing from prior push — unblocks CI) (1472981)
  • memory: SessionRetriever for two-stage hierarchical retrieval (b6aa1ef)
  • memory: SessionRetriever integration tests with real in-memory components (c9374e2)
  • memory: SessionSummaryStore for session-level vector indexing (aecfc85)
  • memory(test): fix typecheck — test stubs cast as interface at usage sites, PADState from core/config (732d475)
  • docs(memory): architecture doc for SessionRetriever (a41c4f9)
  • docs(memory): HybridRetriever architecture doc (38f1d5f)

0.1.247 (2026-04-19)​

  • fix(memory): emit real scoringTimeMs + vectorSearchTimeMs diagnostics (fc0b25c)

0.1.246 (2026-04-19)​

  • fix: add missing Required fields (enabled, syntax_error) unblocking CI (b60eb31), closes #2
  • fix: correct IKnowledgeGraph import path in memory specs (e4705ed)
  • fix(emergent): pre-parse syntax validation + actionable hints + classifier category (b9f4d65)
  • fix(memory): honour consolidation.enabled=false + unref timer (bfc8c1b)
  • chore: rebuild dist (consolidation.enabled fix + scoringWeights override) (3442fac)
  • feat: expose public CognitiveMemoryManager.getTraceCount() (5929380)
  • feat(memory): scoringWeights override on CognitiveRetrievalOptions (e48cd64)
  • test: pin tag round-trip through CognitiveMemoryManager encode/retrieve (9433dad)

0.1.245 (2026-04-19)​

  • feat: add shared memory retrieval policy contract (d70ab08)
  • feat: add shared retrieval confidence evaluation (1efdd5a)
  • feat: thread retrieval policy through cognitive memory (15ed10d)
  • feat: unify retrieval policies across rag entrypoints (da3cd13)
  • feat: unify standalone and runtime long-term retrieval policy (9cc8905)
  • feat(llm): gate provider init logs behind AGENTOS_DEBUG, memoize createProviderManager (76b05ed)
  • fix: calibrate standalone recall confidence (4be8755)

0.1.244 (2026-04-19)​

0.1.243 (2026-04-19)​

  • fix(judge): tighten creation-review rubric to eliminate false rejects (9cd8765)

0.1.242 (2026-04-19)​

  • fix(openai): use max_completion_tokens for gpt-5 + o-series models (675c004)

0.1.241 (2026-04-18)​

  • fix(replicate-image): editImage now routes unpinned models to modern endpoint (5099f31)
  • feat(agent): expose per-call maxTokens on agent() config (cfd0d6d), closes hi#volume

0.1.240 (2026-04-18)​

  • fix(api): autoDetectProvider prioritizes openrouter over openai (6465974)

0.1.239 (2026-04-18)​

  • fix(agency): UsageTotals carries + accumulates cache-token fields (89b99f2)
  • test(storage): lock in SqlStorageAdapter cache-token migration (d75b736)

0.1.238 (2026-04-18)​

  • fix(storage): SqlStorageAdapter persists + aggregates cache tokens (b78ade8)

0.1.237 (2026-04-18)​

  • fix(storage): ITokenUsage carries optional cache-token fields (e2ab9ed)

0.1.236 (2026-04-18)​

  • fix(usage): UsageLedger forwards Anthropic cache-token counters (7245b23)

0.1.235 (2026-04-18)​

  • fix(emergent): wrap-forge-tool tests pass strict tsc (b18bd21)

0.1.234 (2026-04-18)​

  • fix(strategies): propagate cache tokens in all agency accumulators (2daa6a3)

0.1.233 (2026-04-18)​

  • fix(api): streamText + streamObject propagate prompt-cache tokens (2a78b66)

0.1.232 (2026-04-18)​

  • fix(api): generateObject propagates prompt-cache tokens (cee0eaa)

0.1.231 (2026-04-18)​

  • fix(voice-pipeline): resolve 2 lint errors unblocking CI (43fd59a)

0.1.230 (2026-04-18)​

  • fix(emergent): strict build — cast LLM-origin args to ForgeToolInput (52cad99)
  • feat(emergent): forge observability utilities (42108b0)

0.1.229 (2026-04-18)​

  • feat(api): first-class policyTier routing for editImage + generateImage (00bd595)

0.1.228 (2026-04-18)​

  • chore(build): rebuild dist for provider catalog updates (e72831f)
  • feat(providers): add Claude Opus 4.7 + Sonnet 4.6 models + updated pricing (625e0b2)
  • feat(voice): all existing providers implement HealthyProvider (3c2a4bc)
  • feat(voice): AudioRingBuffer for mid-utterance failover replay (ab2e41e)
  • feat(voice): createVoiceProvidersFromEnv batteries-included constructor (ab9a130)
  • feat(voice): export new resilience symbols from package barrel (0a9401a)
  • feat(voice): HealthyProvider trait + capability helpers (122585e)
  • feat(voice): per-provider CircuitBreaker with auth-permanent + cooldown recovery (b2a58bd)
  • feat(voice): StreamingSTTChain with init-time fallback + mid-utterance failover (f214cb6)
  • feat(voice): StreamingTTSChain with init-time + mid-synthesis failover (028ec7f)
  • feat(voice): TranscriptDedupe for cross-provider overlap suppression (271defd)
  • feat(voice): VoiceMetricsReporter typed event bus with isolated listeners (4c327a3)
  • feat(voice): VoicePipelineError + AggregateVoiceError with structured classification (be0f66a)

0.1.227 (2026-04-18)​

  • fix(face): graceful synthetic embedding when Replicate InsightFace 422s (63fb853)
  • Merge remote-tracking branch 'origin/master' (d530634)
  • docs: Paracosm feature guide with HEXACO, forge/reuse, cost safety, API, SSE (6dcca61)

0.1.226 (2026-04-17)​

0.1.225 (2026-04-16)​

  • merge: integrate remote 0.1.224 release tag (b8be2bf)
  • feat(anthropic): cache-aware estimateCost + surface cacheRead/CreationInputTokens (ae63c16)

0.1.224 (2026-04-16)​

  • fix(api): correct ILogger signature on fallback telemetry calls (8898c0c)
  • feat(api): structured telemetry on provider fallback chain (a802d0c)
  • feat(generateObject): accept SystemContentBlock[] for prompt caching (391779a)

0.1.223 (2026-04-16)​

  • feat: add fallback + JSON mode + retry cap to generateObject (4c9dd9b)
  • feat: default-on auto-fallback in generateText (3292fbf)
  • feat: default-on auto-fallback in streamText (76369b3)

0.1.222 (2026-04-15)​

  • chore: update gitignore and db (b76b2f7)
  • feat: export extractJson from barrel for centralized LLM JSON extraction (397210a)
  • docs: add capability discovery, skills, and self-improvement tools to README feature table (0809af1)
  • docs: add self-improvement tools and SkillExporter to emergent capabilities docs (1965d06)

0.1.221 (2026-04-15)​

  • fix: streamline Paracosm section in README (d7e3034)

0.1.220 (2026-04-15)​

  • feat: update README to reference Paracosm instead of mars-genesis-simulation (da1522e)
  • fix: align runtime contracts and docs publication (a4bba1a)
  • docs: add Mars Genesis featured demo section, update Discord to wilds.ai (6fd85d6)
  • docs: clarify cognitive mechanism count and persona drift as optional (c3150c4)
  • chore: update Discord invite link (3d55abe)

0.1.219 (2026-04-12)​

  • feat(mars-genesis): v3 orchestrator with Turn 0 promotion, personality drift, outcome classification (3678aa0)
  • feat(mars-genesis): v3 smoke test passed - promotions, drift, outcome classification all working (9271c95)
  • feat(mars-genesis): v3 state types, HEXACO generation, drift, outcome classification, scenarios, con (55efd96)
  • docs: add Mars Genesis v3 design spec (dynamic promotion, personality drift, trait trajectories) (7396604)
  • docs: add Mars Genesis v3 implementation plan (9 tasks, personality drift) (676f0bb)
  • docs: document slash-format model strings and update model table (fdeea31)
  • docs: rewrite v3 spec after full cross-check against v2 principles and Codex review (3ab3509)
  • docs: update model names and document slash-format support (1df3c32)

0.1.218 (2026-04-12)​

  • fix(mars-genesis): fix forge success rate (permissive schemas, code wrapping, mode normalization) (0d51b77)

0.1.217 (2026-04-12)​

  • feat: support provider/model slash format in model strings (266daf0)

0.1.216 (2026-04-12)​

  • fix(mars-genesis): normalize OpenAI forge_tool args (code->sandbox, default allowlist), strengthen d (39adc0e)

0.1.215 (2026-04-12)​

  • feat(mars-genesis): v2 smoke test passed - multi-agent orchestrator working end-to-end (1279218)

0.1.214 (2026-04-12)​

  • feat(mars-genesis): add v2 multi-agent orchestrator with department routing, kernel integration, and (5efa348)

0.1.213 (2026-04-12)​

  • feat(mars-genesis): add simulation kernel, typed contracts, and curated research packets (turns 1-12 (6afe124)

0.1.212 (2026-04-12)​

  • fix: LLMVisionProvider passes ContentPart[] directly instead of JSON.stringify (8bdc0e0)
  • feat: widen agent session send/stream to accept MessageContent (eee6e8c)
  • feat: widen Message.content to MessageContent for multimodal support (e6823e5)
  • feat(mars-genesis): add canonical simulation state types (de520ee)
  • feat(mars-genesis): add deterministic between-turn progression (aging, births, deaths, careers) (42e98c2)
  • feat(mars-genesis): add deterministic seeded RNG (mulberry32) (75fd3e3)
  • feat(mars-genesis): add seeded colonist population generator (62f639e)
  • docs: add Mars Genesis v2 Phase 1 implementation plan (kernel + state) (ee543c9)
  • docs: rewrite Mars Genesis v2 spec incorporating Codex review (8cbb755)

0.1.211 (2026-04-12)​

  • feat(examples): emergent tool forging fully working in Mars Genesis (8b73dbb)

0.1.210 (2026-04-12)​

  • feat(examples): wire EmergentCapabilityEngine + ForgeToolMetaTool into Mars Genesis (78deae8)

0.1.209 (2026-04-12)​

  • feat(examples): add verified Mars Genesis output logs with live web search citations (115684f)

0.1.208 (2026-04-12)​

  • fix(examples): add Brave Search fallback, add tool execution logging, debug Serper credit issue (d3c7b82)
  • fix(examples): add real web_search ITool via Serper API, fix citation instructions to require inline (58a5b83)

0.1.207 (2026-04-12)​

  • fix(examples): fix personality type (honesty not honestyHumility), switch to Opus, add maxTurns CLI (89e39a9)

0.1.206 (2026-04-12)​

  • feat(examples): add 12 Mars Genesis crisis scenarios with research keywords (5892bf5)
  • feat(examples): add Mars Genesis entry points, README, and output dir (71ab5ea)
  • feat(examples): add Mars Genesis simulation runner with citation extraction (a512ec4)
  • feat(examples): add Mars Genesis types, leader constants, gitignore superpowers (1ca6b3c)

0.1.205 (2026-04-12)​

  • fix: skip voice transport adapter test that stalls on dynamic import (bebc07b)

0.1.204 (2026-04-12)​

  • feat: add API class citations and related links to emergent capabilities doc (5c794cc)

0.1.203 (2026-04-11)​

  • feat(memory): add PerspectiveObserver for multi-agent subjective encoding (17c5c1c)
  • spec: PerspectiveObserver — multi-agent subjective memory encoding (cf2362d)

0.1.202 (2026-04-11)​

  • feat(memory): add IMemoryArchive for lossless verbatim preservation and on-demand rehydration (12516c4)

0.1.201 (2026-04-10)​

  • fix: update comparison blog URL to dated Docusaurus path (022155a)
  • docs: add inline apiKey/baseUrl examples to quick start and API guides (3b9da2f), closes hi#level
  • docs: streamline README for SEO and LLM crawling, unify Discord link (583ab5a)

0.1.200 (2026-04-10)​

  • fix: validate OpenAI TTS voice names, fall back to nova for unknown IDs (87687cf)

0.1.199 (2026-04-10)​

  • fix: add missing ApiKeyPool imports and fix broken field declaration in StabilityImageProvider (4a295de)
  • test: add integration tests for provider key rotation (98438ff)
  • docs: document API key rotation as core AgentOS feature (9436051)
  • feat: add key pool rotation to all remaining providers (20 files) (8d952cb)

0.1.198 (2026-04-10)​

  • feat: add key pool rotation to Anthropic, OpenRouter, and fix import paths (7e95c01)

0.1.197 (2026-04-10)​

  • feat: add key pool rotation to all 6 OpenAI providers (b6f23d3)

0.1.196 (2026-04-10)​

  • feat: add key pool rotation to all 5 ElevenLabs providers (fa38ec5)

0.1.195 (2026-04-10)​

  • feat: add quota error detection, singleton key pool registry, barrel export (e18fa18)

0.1.194 (2026-04-10)​

  • feat: add ApiKeyPool with weighted round-robin and quota cooldown (fa81f1d)

0.1.193 (2026-04-10)​

  • fix(memory): add missing knowledgeGraph + collectionPrefix to getBrain test config (000c48c)
  • chore: bump version to 0.1.192 (d016aec)

0.1.192 (2026-04-10)​

  • feat(memory): brain export/import pipeline + transplant + cross-platform SqliteImporter (8f4b77e)

0.1.191 (2026-04-09)​

  • feat(routing): PolicyAwareRouter respects requiredCapabilities + agent() forwards routerParams (5a68820)

0.1.190 (2026-04-09)​

  • feat(agency): robust structured output with brace-matched JSON extraction and validation retries (3824708)

0.1.189 (2026-04-08)​

  • fix: resolve CI lint failures (unused imports, require() style) (a52a73f)

0.1.188 (2026-04-08)​

  • feat: add optional reranker stage to CognitiveMemoryManager.retrieve() (ee11490)

0.1.187 (2026-04-08)​

  • feat: add OpenAIRealtimeTTS streaming provider (87b2808)

0.1.186 (2026-04-08)​

  • feat: add BatchTTSFallback wrapper for multi-provider TTS failover (5296a86)

0.1.185 (2026-04-08)​

  • feat: add ElevenLabsBatchTTS provider (be750f6)

0.1.184 (2026-04-08)​

  • wip: save in-progress image changes (3674be5)
  • feat: add OpenAIBatchTTS provider for one-shot narration synthesis (952fcbe)

0.1.183 (2026-04-08)​

  • feat: add IBatchTTS, BatchTTSConfig, and BatchTTSResult interfaces (babe6aa)

0.1.182 (2026-04-08)​

  • fix: add ignoreDeprecations 6.0 for TS 7.0 baseUrl warning (b011e7f)
  • fix: remove ignoreDeprecations for TS 7.0 compat, fix Zod v4 type errors (696806c)
  • chore(release): 0.1.182 (073b439)
  • docs: update README with cognitive memory completion and LLM validation layer (9c3270a)
  • test(memory): add full pipeline integration test for cognitive memory (94b8720)
  • test(validation): add integration test for full validation pipeline (57fe60a)
  • feat(agent): add responseSchema option to agent() factory for Zod validation (486e01d)
  • feat(memory): add default MemoryHydeRetriever, auto-attach when LLM available (381902f)
  • feat(memory): add full API surface to AgentMemory (graph, stats, export, prospective) (8e9ec45)
  • feat(memory): add relational type, CoT reasoning, personality bias to MemoryReflector (f4fc891)
  • feat(memory): add response guidance preamble to MemoryPromptAssembler (8562c8a)
  • feat(memory): add SqliteBrain write-through persistence for cognitive path (b80e2a9)
  • feat(memory): auto-register commitment and intention notes as prospective items (684645a)
  • feat(memory): enable KnowledgeGraph by default, add disabled opt-out flag (9500059)
  • feat(validation): add centralized extractJson for LLM output parsing (6156cdc)
  • feat(validation): add LlmOutputValidationError and Zod schema primitives (c1f5694)
  • feat(validation): add ValidatedLlmInvoker with Zod validation, retry, and barrel export (f5422bd)

0.1.181 (2026-04-07)​

  • fix: add missing API exports (generateImage, generateObject, generateMusic, generateSFX, generateVid (16dd3c4)

0.1.180 (2026-04-07)​

  • feat(web-search): add multi-provider web search module with RRF fusion, semantic dedup, reranking (37d2abf)

0.1.179 (2026-04-06)​

  • feat(image): build dist for v0.1.178 — character consistency, style transfer, provider modernization (7c519be)

0.1.178 (2026-04-06)​

  • feat(image): character consistency, style transfer, provider modernization (22a90da), closes hi#level

[Unreleased]​

Added​

  • transferStyle() high-level API for image-guided style transfer via Flux Redux
  • Character consistency fields on ImageGenerationRequest: referenceImageUrl, faceEmbedding, consistencyMode
  • Replicate: dual-endpoint support (modern /models/.../predictions + legacy /predictions)
  • Replicate: 10 new models in catalog (Flux 1.1 Pro, Ultra, Redux, Canny, Depth, Fill Pro, Pulid, SDXL Lightning, SDXL, Real-ESRGAN)
  • Replicate: character consistency via Pulid auto-selection when consistencyMode: 'strict'
  • Replicate: ControlNet image input (controlImage, controlType) for Flux Canny/Depth
  • Fal: editImage() support (img2img + inpainting)
  • Fal: 4 new models in catalog (Pro 1.1, Ultra, LoRA, Realism)
  • Fal: IP-Adapter character consistency mapping
  • SD-Local: IP-Adapter character consistency via ControlNet injection
  • PolicyAwareImageRouter: 'character-consistency' capability filtering
  • AvatarPipeline: per-stage consistency mode (strict for expressions, balanced for body)
  • docs/features/CHARACTER_CONSISTENCY.md
  • docs/features/STYLE_TRANSFER.md
  • 59 new tests across providers, APIs, and integration scenarios
  • OpenAI, Stability, OpenRouter, BFL: graceful debug warning when referenceImageUrl is set but unsupported

Changed​

  • Replicate: default inpaint model upgraded from flux-fill to flux-fill-pro

0.1.177 (2026-04-04)​

  • fix(api): include systemBlocks on exported AgentOptions interface (d79ddab)

0.1.176 (2026-04-04)​

  • feat: add PersonaDriftMechanism (9th cognitive mechanism) with heuristic personality drift (739fafd)
  • feat(api): replace flat HEXACO trait dump with behavioral descriptions (a42d72f)

0.1.175 (2026-04-04)​

  • fix(api): remove duplicate dead branches in system prompt construction (32d5e5f)
  • docs(voice-pipeline): add provider options, sentiment, keyword boosting docs (b376cbf)

0.1.174 (2026-04-04)​

  • feat: add prompt caching support (SystemContentBlock, cache_control, cache metrics) (23586f3)

0.1.173 (2026-04-04)​

  • feat(voice-pipeline): Deepgram sentiment, keywords, smart formatting support (a7d7266)

0.1.172 (2026-04-04)​

  • fix(orchestration): validate and route conditional/discovery edges correctly (47b213f)
  • feat(nlp): implement trigram-based language detection in StatisticalUtilityAI (54ea468)
  • test: add classify, sentiment, similarity, trainModel, and hybrid delegation tests (9c5a3be)
  • test(nlp): add classifyText, sentiment, and similarity tests for StatisticalUtilityAI (24a6378)

0.1.171 (2026-04-04)​

  • feat: export NLP ai_utilities from barrel file and package.json (08da179)
  • feat(nlp): improve syllable counting in calculateReadability (35e60b1)

0.1.170 (2026-04-04)​

  • feat(voice-pipeline): forward ttsOptions to ElevenLabs as expressiveness params (9c31206)

0.1.169 (2026-04-04)​

  • feat(agentos): wire VoiceTransportAdapter to pipeline TTS and turn detection (69d337f)

0.1.168 (2026-04-03)​

  • feat(routing): update uncensored model catalog for private-adult tier (f4c6bea)

0.1.167 (2026-04-03)​

  • fix: disable require-yield on stub generator that only throws (2899cfd)
  • docs: add 3-line minimal agent example + all 6 agency strategies shown (88e4eec)
  • chore: bump version to 0.1.166, align sql-storage-adapter to ^0.6.1 (6fcf301)

0.1.166 (2026-04-01)​

  • fix(agentos): prioritize truly uncensored models for private-adult tier (f03491e)

0.1.165 (2026-04-01)​

  • fix: resolve cosineSimilarity export collision in images barrel (05e321f)
  • feat: add AvatarIdentityPackage, face embedding service, avatar generation pipeline (5cbf5b0)

0.1.164 (2026-04-01)​

  • feat: wire PolicyAwareImageRouter into generateImage, update barrel exports (886dedf)

0.1.163 (2026-04-01)​

  • feat: add PolicyAwareRouter, UncensoredModelCatalog, PolicyAwareImageRouter (74fff3e)

0.1.162 (2026-04-01)​

  • feat: add getAvatarBindings and setAvatarBindingOverrides to agent() (2989397)

0.1.161 (2026-04-01)​

  • feat: add AvatarConfig to BaseAgentConfig with identity, style projections, and runtime bindings (d1a0e63)

0.1.160 (2026-04-01)​

  • fix(agentos): remove eager usage-ledger imports from lightweight API paths (580b169)

0.1.159 (2026-03-31)​

  • fix: add relational to tracesPerType (MemoryType completeness) (a0e42f3)
  • fix: use 'as any' cast for Message/Record interop in generation hooks (TS2352) (ac1e60f)
  • feat: add ModelRouter, generation hooks, memory/skills to agent() (ed1b436)
  • feat: add relational memory type for companion relationship tracking (e0989c3)
  • docs: citation verification README section + example (dd23816)

0.1.159 (2026-03-31)​

Features​

  • ModelRouter integration: generateText(), streamText(), and agent() accept an optional router field (IModelRouter) for intelligent model/provider selection. Router errors fall back gracefully.
  • Generation lifecycle hooks: onBeforeGeneration, onAfterGeneration, and onBeforeToolExecution hooks on GenerateTextOptions and AgentOptions. Enables guardrail injection, memory context assembly, and tool permission gating without the full AgentOS runtime.
  • Memory integration for agent(): agent() accepts memoryProvider for automatic memory recall before each turn and observation after each turn. Includes 5s timeout for non-blocking operation.
  • Skills integration for agent(): agent() accepts skills (SkillEntry[]) to inject skill content into system prompts.
  • New public exports: ModelRouter, IModelRouter, ModelRouteParams, ModelRouteResult, AgentMemory, IPromptEngine, SkillEntry, SkillRegistry, GenerationHookContext, GenerationHookResult, ToolCallHookInfo.

0.1.158 (2026-03-31)​

  • fix: add originalDocumentId to rerankChain test chunks (d6b84a9)
  • fix: verifyCitations default + resolved config type + dedupe cosineSimilarity export (209a2ac)
  • feat(citation): add grounding field to QueryResult + verifyCitations config + exports (246ea44)
  • feat(citation): CitationVerifier with cosine similarity verification + tests (3f745a0)
  • test: add rerankChain() multi-stage pipeline tests (4fe5c4d)
  • docs: move Ebbinghaus from intro to memory section, add DOI hyperlinks to all 8 APA citations (7740a15)

0.1.157 (2026-03-31)​

  • fix: logger.warn signature — string not Record (408b37d)
  • feat: expose cognitive mechanisms in agent() API + APA citations in README (b3edd61)
  • feat(reranking): export LlmJudgeReranker + RerankChainStage (b4716e5)
  • feat(reranking): LLM-as-judge reranker + rerankChain multi-stage pipeline (e9e615c)
  • docs: add Adaptive Intelligence & Metacognition section to README (9a3dc33)
  • docs: complete README rewrite -- fix broken examples, real feature counts, streamlined structure (d5a7208)
  • docs: fix generateText example — honest about auto-detection (env var priority, not LLM-chosen) (1cbcf69)
  • docs: generateText example — auto-detect best provider+model by default, show override as comment (ff28f48)

0.1.156 (2026-03-30)​

  • fix(ci): add type assertions for TS 5.4 compatibility in humanNode builder and executor (3877175)

0.1.155 (2026-03-30)​

  • feat: HITL guardrail override support + agency docs update + tests (fe117e6)
  • feat(hitl): add post-approval guardrail override for destructive actions (ce2ee69)
  • feat(knowledge): add HITL FAQ, API, and guardrail-override corpus entries (5cc3d2e)
  • fix: strip changelog notes, vaporware diagram, and fake pseudo-code from architecture docs (e06ec6b)
  • fix(ci): retrigger build (3919254)
  • docs: expand architecture doc to ~1200 lines with diagrams, code examples, tables (889c811)
  • docs: rewrite High-Level API intro — clean table, no changelog language (9d45059), closes Hi#Level
  • docs: strip 3000+ lines of vaporware from architecture doc (03c12fb)
  • docs: unified API reference — one import, quick reference table, no artificial levels (db1f5fc)

0.1.154 (2026-03-30)​

  • fix: remove all downstream references from AgentOS docs (961c4af)

0.1.153 (2026-03-30)​

  • docs: add llmJudge API reference and humanNode options table (5427fc8)
  • test(hitl): add unit + integration tests for llmJudge and humanNode options (2bd74b8)
  • feat(hitl): add llmJudge() handler factory (0f9a865)
  • feat(orchestration): add humanNode autoAccept/autoReject/judge/onTimeout options (6941058)

0.1.152 (2026-03-30)​

  • fix: remove docs.wunderland.sh links and Wunderland-specific language from agentos docs (24fe36f)

0.1.151 (2026-03-30)​

  • feat(readme): add adaptive intelligence + emergent behaviors sections (304fb79)
  • test(knowledge): add credential discovery tests + update QueryRouter docs (720ae2f)
  • docs: rewrite orchestration pages — authoritative tone, Mermaid diagrams, no hedging (b5fd83c)

0.1.150 (2026-03-29)​

  • feat(knowledge): add credential setup workflow entries to platform corpus (71c922c)

0.1.149 (2026-03-29)​

  • fix: reorder auto-detect priority (OpenAI first) + warn on Anthropic fallback (646dab3)

0.1.148 (2026-03-29)​

  • fix(examples): fix 3 broken examples — import path, provider notes, shutdown (81c5062)

0.1.147 (2026-03-29)​

  • fix(typecheck): use direct imports for SqliteExporter/Importer in tests (bd855ba)

0.1.146 (2026-03-29)​

  • fix: remove eager SqliteImporter/Exporter barrel exports to avoid better-sqlite3 crash (3242f31)

0.1.145 (2026-03-29)​

  • fix(memory): prevent raw profanity/slurs from being stored as user facts (c17b49f)
  • docs: add content-policy-rewriter to guardrails table + ecosystem (563be3f)

0.1.144 (2026-03-29)​

  • feat(query-router): capability recommendations + discovery engine integration (1df5a12)
  • docs: rewrite quickstart — personality, memory, RAG, workflows, agency, voice, guardrails (3270358)

0.1.143 (2026-03-29)​

  • feat: add fallbackProviders + buildFallbackChain to generateText/streamText/agent (800edae)

0.1.142 (2026-03-29)​

  • fix(docs): remove highlightLanguages (unsupported in TypeDoc 0.25) (07af1b9)
  • chore(deps): bump agentos-extensions-registry to ^0.15.0 (a30ef70)

0.1.141 (2026-03-29)​

  • fix(ci): resolve typecheck errors — add finishReason to mock, import afterEach (88a3f18)

0.1.140 (2026-03-29)​

  • fix(ci): make badge green — typecheck gates CI, tests report to codecov (b7028e5)
  • fix(tests): resolve 58 test file failures from hierarchy restructuring (3b1ea11)

0.1.139 (2026-03-29)​

  • fix(lint): replace dynamic require() with static imports in QueryClassifier (3925405)

0.1.138 (2026-03-29)​

  • feat(query-router): wire capability catalog into plan-aware classifier + surface recommendations (3fdf26d)
  • docs: add personality on/off examples to getting-started guide (1b2e682)
  • docs: add runnable examples table with all 13 .mjs files + descriptions (4ed2b24)
  • docs: platform knowledge documentation + integration and e2e tests (2f6cdcf)

0.1.137 (2026-03-29)​

  • fix: use darker green for tests badge (readable with white text) (9a9d566)

0.1.136 (2026-03-29)​

  • fix(ci): exclude onnxruntime native tests, add test count badge (858cb7b)
  • docs: add DOI hyperlinks to all cognitive mechanism citations in README (3ae7ccb)
  • docs: comprehensive memory types, 4-tier hierarchy, 8 cognitive mechanisms (8eb9ab1)
  • docs: multi-provider examples, provider-first pattern, default models table (c346007)

0.1.135 (2026-03-29)​

  • fix(ci): resolve sql-storage-adapter in standalone CI without monorepo sibling (1087b02)

0.1.134 (2026-03-29)​

  • feat(query-router): bundled platform knowledge system (dab1e3f)

0.1.133 (2026-03-29)​

  • feat(discovery): hydrate capability index from extensions catalog (cc9f25d)

0.1.132 (2026-03-29)​

  • fix(ci): add sql-storage-adapter to devDependencies for test resolution (3568e48)
  • docs: multi-agent quickstart examples and emergent agency patterns (255ad25)

0.1.131 (2026-03-29)​

  • fix: guardrails core module + orchestration test + runtime updates (f438e7b)

0.1.130 (2026-03-28)​

  • fix(lint): suppress prefer-const for organizationIdForMemory (assigned in later phase) (12b12de)

0.1.129 (2026-03-28)​

  • fix(build): restore let declarations and add unknown casts for strict type safety (6693e00)
  • fix(lint): prefer-const for organizationIdForMemory and currentToolForges (8afba95)

0.1.128 (2026-03-28)​

  • fix(ci): add @framers/agentos-extensions-registry as devDependency (11e6151)

0.1.127 (2026-03-28)​

  • fix: resolve 16 TODO stubs across GMI, agency, memory, and RAG (e1c4822)
  • fix: resolve all import paths broken by core/ restructuring (89aec7b)
  • fix: resolve CI build errors from TODO stub implementations (39e5008)
  • fix: resolve remaining TODO stubs — UtilityAI, AudioProcessor, RAG stubs (185d11b)
  • fix: resolve stale services/auth imports and QueryRouter type error (ee7b475)
  • fix: resolve test failures and typecheck errors in query-router, vision, emergent (cbf8491)
  • fix: set noEmitOnError false to allow build with pending type stubs (e776aca)
  • fix(ci): resolve all build errors — vendor stubs + type casts (db9f6ee)
  • fix(gmi): update tests for extracted GMI subsystems and fix case-insensitive mood matching (3db2ec0)
  • feat: add MissionPlanner — Tree of Thought decomposition with evaluation and refinement (e900d04)
  • feat: add planning types — autonomy, provider strategy, graph expansion, mission events (1647a71)
  • feat: add ProviderAssignmentEngine and GraphExpander with tests (5194183)
  • feat: add RequestExpansionTool and ManageGraphTool for dynamic graph modification (ec7f3f9)
  • feat: extend MissionBuilder and GraphEvent for self-expanding missions (7dd0827)
  • feat: extract CLI registry to JSON files, expand to 49 CLIs (abb644d)
  • feat: integration test + barrel exports for mission orchestrator (dd89dbe)
  • feat: loadable flag in capability discovery results (5b6911d)
  • feat: runtime extension loading in ToolOrchestrator (04b403a)
  • feat: universal provider support for mission planner + execution model split (c3c33f5)
  • feat: universal provider support for QueryRouter (1a5993a)
  • feat(memory): add cognitive mechanisms module — 8 neuroscience-grounded mechanisms (48aaa6b)
  • feat(sandbox): real Python/Shell execution + hardened JS sandbox with node:vm (50df221)
  • refactor: absorb core/ui,usage into core/utils, move core/vector-search into rag/ (23beffe)
  • refactor: consolidate graph systems — move neo4j/, rag/graphrag/ → knowledge/ (da0b4f5)
  • refactor: create hearing/ module (audio processing + STT/VAD providers) (130fd6f)
  • refactor: delete stale AgentOrchestrator, merge HNSW sidecars (dfe5c6e)
  • refactor: extract core/agents,agency into agents/ (b652aac)
  • refactor: extract core/audio,images,video,vision,media into media/ (a15938a)
  • refactor: extract core/guardrails,safety into safety/ (3c7a6a9)
  • refactor: extract core/provenance into provenance/ (53c742f)
  • refactor: extract core/text-processing,language,ai_utilities into nlp/ (7a7395e)
  • refactor: extract evaluation,knowledge,planning,sandbox,structured,marketplace from core/ (6f0381f)
  • refactor: extract IEmbeddingManager, IVectorStore to core/ — break memory/rag circular dependency (d1b5f5d)
  • refactor: extract IEmbeddingManager, IVectorStore to core/ — break memory↔rag circular dep (7ecad07)
  • refactor: flatten rag/implementations/vector_stores → rag/vector_stores (24fd16e)
  • refactor: hierarchy phase 1 — dissolve junk drawers, fix split-brain, slim core (46a382b)
  • refactor: merge planning/ into orchestration/ (509c819)
  • refactor: move social-posting/ → channels/social-posting/ (318f77a)
  • refactor: move telephony/ → channels/telephony/ (d7457b1)
  • refactor: promote media/vision/ to top-level vision/ (perception module) (df7e943)
  • refactor: rename voice/ → telephony/ (phone call control) (adb71f9)
  • refactor: split api/ monolith — move 19 internal runtime files to api/runtime/ (3f8d223)
  • refactor: update barrel exports for perception module reorganization (206453e)
  • refactor: update skills engine JSDoc and docs-alignment test (949c09d)
  • refactor(api): extract CapabilityDiscoveryInitializer from AgentOS.ts (1fd780d)
  • refactor(api): extract ExternalToolResultHandler from AgentOSOrchestrator (f5bef1f)
  • refactor(api): extract GMIChunkTransformer from AgentOSOrchestrator (1caff11)
  • refactor(api): extract RagMemoryInitializer from AgentOS.ts (735434a)
  • refactor(api): extract SelfImprovementSessionManager from AgentOS.ts (b8104ca)
  • refactor(api): extract TurnExecutionPipeline from AgentOSOrchestrator (d245a0c)
  • refactor(api): extract WorkflowFacade from AgentOS.ts (0de273c)
  • refactor(gmi): extract CognitiveMemoryBridge from GMI.ts (c949978)
  • refactor(gmi): extract ConversationHistoryManager from GMI.ts (051c886)
  • refactor(gmi): extract MetapromptExecutor from GMI.ts (4181176)
  • refactor(gmi): extract SentimentTracker from GMI.ts (616af33)
  • refactor(memory): reorganize 20 flat subdirs into 4-tier hierarchy (f7e969a)
  • docs: add CLI Registry documentation (f437e57)
  • docs: add cognitive mechanisms to README and COGNITIVE_MEMORY cross-reference (14a1a80)
  • docs: add mission planning prompts — decomposition, evaluation, refinement, expansion (c57a5aa)
  • docs: remove duplicate api/media/ and organize 72 flat docs into subfolders (a7e7846), closes hi#level
  • docs: update all documentation for new directory structure after core/ flattening (43ed93d)
  • docs: update architecture, diagrams, and references for restructured hierarchy (3488e0e)
  • chore: delete orphaned services/ directory, move auth types to types/auth (b3fe9bb)
  • chore: remove dead dirs, build artifacts, absorb services/ and memory_lifecycle/ (a72572b)
  • test: add CLIRegistry → CapabilityDescriptor integration contract test (b07bcf0)
  • ci: trigger fresh CI run with all fixes (a3b753d)

0.1.126 (2026-03-27)​

  • fix: replace top-level await with synchronous require in AgentKeyManager (0bcf573)
  • fix: use npm sql-storage-adapter >=0.6.0 (now published), remove GitHub devDep hack (d48a32c)
  • fix(ci): add sql-storage-adapter 0.6.0 from GitHub as devDep for CI builds (c59cb9d)
  • test: close all RAG text-processing coverage gaps + fix preset stop word inconsistency (89036be)
  • feat: add TextProcessingPipeline and HnswIndexSidecar core modules (a9248d4)
  • feat: use natural's 170-word stop word list as default across all tokenizers (883763d)
  • feat: wire TextProcessingPipeline + HnswIndexSidecar into RAG system (ffb4e77)
  • feat(memory): browser compatibility + cross-platform crypto + string I/O (c2541ca)
  • feat(memory): wire SqlDialect, FTS, BlobCodec, Exporter into memory subsystem (6f32269)
  • refactor: use shared ENGLISH_STOP_WORDS from text-processing — remove duplicated stop word lists (d384d7e)
  • docs: add cross-references to wunderland CLI docs (84a39a9)

0.1.125 (2026-03-27)​

  • feat(agentos): wire self-improvement tools into emergent bootstrap (d4b7a80)

0.1.124 (2026-03-27)​

  • fix(lint): remove unnecessary escape characters in BM25 tokenizer regex (caf2be9)

0.1.123 (2026-03-27)​

  • feat: self-improvement tool factory, consolidation personality decay, barrel exports (c580042)
  • feat(api): add text-based tool-call fallback parser for non-native models (c136f25)
  • feat(api): wire PlanningEngine into generateText tool loop (a97e059)
  • feat(emergent): add self-improvement tools — personality adaptation, skill management, workflow crea (3614f50)
  • feat(gmi): make tool-loop safety break configurable via maxToolLoopIterations (d9c4767)
  • feat(memory): migrate from better-sqlite3 to cross-platform StorageAdapter (aaab1b8)
  • docs(gmi): document LoopController duplication and future refactor path (337f539)

0.1.122 (2026-03-27)​

  • feat(emergent): add AdaptPersonalityTool for runtime HEXACO trait mutation (f7a75ae)
  • feat(emergent): add CreateWorkflowTool for multi-step tool composition (9f1cd6b)
  • feat(emergent): add ManageSkillsTool for runtime skill enable/disable/search (be0a5aa)
  • feat(emergent): add PersonalityMutationStore with SQLite persistence and decay (cbe058a)
  • feat(emergent): add SelfEvaluateTool for response quality evaluation and parameter adjustment (4d46b85)
  • feat(emergent): add SelfImprovementConfig types and defaults (8b77827)
  • docs: explain why type stubs exist for optional native dependencies (64411c5)

0.1.121 (2026-03-27)​

  • fix: align Pinecone/Postgres vector stores with IVectorStore interface (0055bd6)
  • fix(build): add sharp type stub for VideoAnalyzer dynamic import (8c23c6a)
  • fix(types): resolve Agent interface stream return type mismatches (7b80ed6)
  • fix(types): resolve all TypeScript compilation errors across codebase (33e19ef), closes cast-throu#unknown
  • feat: add barrel exports for audio generation, ProviderPreferences, generateMusic, generateSFX (66ce977)
  • feat: add claude-code-cli provider + generalized CLI subprocess bridge (e4db654)
  • feat: add gemini-cli provider + env support in CLISubprocessBridge (c761915)
  • feat: add generateMusic() and generateSFX() high-level APIs (1a6f5c2), closes hi#level
  • feat: add stream buffer, scene detector, media providers, agency streaming, and CLI subprocess bridg (5dd1e1b)
  • feat: register all 8 audio providers in the factory registry (927a59d)
  • feat: retrofit ProviderPreferences into generateImage and generateVideo (1cf2211)
  • feat(api): add high-level video APIs — generateVideo, analyzeVideo, detectScenes (3238cfe), closes hi#level
  • feat(api): add top-level performOCR() high-level API (a0a5ebb), closes hi#level
  • feat(api): export performOCR from barrel index (f63e517)
  • feat(audio): add audio types, IAudioGenerator interface, FallbackAudioProxy, and provider factory re (3784092)
  • feat(audio): add MusicGenLocalProvider and AudioGenLocalProvider (3ca041a)
  • feat(audio): add ReplicateAudioProvider and FalAudioProvider (2ae0121)
  • feat(audio): add StableAudioProvider and ElevenLabsSFXProvider (2f83d6d)
  • feat(audio): add SunoProvider and UdioProvider (e2f5b76)
  • feat(images): add FallbackImageProxy for automatic provider failover (9cfa1c8)
  • feat(media): add ProviderPreferences shared resolver (a4fe778)
  • feat(memory): query-time embedding generation — embed() config enables HNSW vector recall (2a8ac44)
  • feat(memory): wire HNSW sidecar into Memory facade — hybrid FTS5+ANN recall with RRF fusion (e2b9eab)
  • feat(query-router): add githubRepos config with background ecosystem indexing (7b0a4a3)
  • feat(query-router): extend RetrievalPlan to ExecutionPlan with skill/tool/extension recommendations (2f50784)
  • feat(rag): add BM25 sparse index and hybrid dense+sparse search with RRF fusion (65dca28)
  • feat(rag): add RetrievalPlan types and plan builder (db5d962)
  • feat(rag): add UnifiedRetriever orchestrating all sources with memory feedback (6808aab)
  • feat(rag): barrel exports for migration engine, setup, vectorMath + extend MemoryConfig for Postgres (81ebc9b)
  • feat(rag): Docker auto-setup for Qdrant and Postgres with cloud detection and health polling (4927430)
  • feat(rag): enhance QueryClassifier with plan-based output and wire into router (5f4bc2d)
  • feat(rag): multi-hypothesis HyDE for improved recall via diverse perspectives (67b3201)
  • feat(rag): Pinecone vector store adapter with fetch-based API, metadata filtering, migration source (65dcde4)
  • feat(rag): PostgresVectorStore with pgvector HNSW + RRF hybrid search, feature parity test suite (717b1b9)
  • feat(rag): RAPTOR recursive abstractive tree for hierarchical corpus summarization (0f94ae9)
  • feat(rag): semantic chunker with paragraph/sentence/heading boundary detection (94eb74b)
  • feat(rag): universal MigrationEngine with SQLite, Postgres, and Qdrant adapters (00d5650)
  • feat(rag): wire HyDE retrieval into RetrievalAugmentor, multimodal search, and memory recall (313e586)
  • feat(rag): wire strategy-based dispatch into QueryRouter, add graph expansion to complex pipeline (28fb7f7)
  • feat(video): add analysis types, progress events, and scene description (23318a6)
  • feat(video): add FalVideoProvider with queue-based API support (5aef6ac)
  • feat(video): add provider factory registry and barrel exports (61476fe)
  • feat(video): add ReplicateVideoProvider with predictions API support (c4b0ccb)
  • feat(video): update RunwayVideoProvider to match canonical types (b17ba6b)
  • feat(vision): add SceneDetector with histogram-based scene boundary detection (aab90ce)
  • docs: add CLI providers reference, update LLM providers and OAuth docs (e4c5379)
  • docs: add HyDE retrieval configuration guide (dcecbdb)
  • docs: add PostgresVectorStore, PineconeVectorStore, and memory scaling section to README (22011e3)
  • docs: memory scaling guide — 4-tier path, migration CLI, backend comparison, Docker auto-setup (ab6b408)
  • docs: per-backend guides for Postgres, Qdrant, and Pinecone vector stores (17427fc)
  • refactor: remove agentos-ext-skills dependency, skills discovered directly via SkillRegistry (823bbab)
  • test: comprehensive mocked tests for Postgres, Pinecone, Qdrant, and Memory embedding flow (a7191ae)

0.1.120 (2026-03-27)​

  • fix(ci): add better-sqlite3 to devDependencies for memory tests (0c15534)
  • feat(memory): HNSW sidecar index — O(log n) ANN alongside brain.sqlite, auto-activates at 1K vectors (b171a61)

0.1.119 (2026-03-27)​

  • perf(rag): SQL-level metadata filtering via json_extract — avoid loading unmatched rows (9f3618a)

0.1.118 (2026-03-27)​

  • perf(rag): binary blob embeddings in SqlVectorStore — 3-4x faster queries, shared vectorMath utils (5d040a0)

0.1.117 (2026-03-27)​

  • feat(rag): shared vectorMath utils — cosine similarity, dot product, euclidean distance, binary blob (97b19cb)
  • test: add QueryRouter E2E integration test (2b69b3e)

0.1.116 (2026-03-26)​

  • fix(lint): resolve unreachable else-if branch in orchestrator tool result handler (ec1acb2)

0.1.115 (2026-03-26)​

  • fix(lint): suppress require imports in multimodal indexer, use const for embeddedImages (8c3a18d)

0.1.114 (2026-03-26)​

  • fix(build): add query-router to tsconfig.build.json include list (6903904)
  • fix(build): resolve all CI errors — missing modules, Buffer types, sharp import, query-router (72031e8)
  • fix(emergent): input validation, sandbox crypto leak, strict mode, nullish coalescing (825e641)
  • fix(emergent): validate full JSON schema in reuse checks, prevent promotion after validation failure (2cdc1e4)
  • fix(guardrails): resolve integration test failures and lint issues (03a0ab8)
  • fix(types): resolve typecheck errors in tests and vision pipeline (bf098c8)
  • feat: add ./query-router sub-export to package exports map (ce70333)
  • feat: add query-router module to barrel exports (c072bfa)
  • feat: add QueryRouter orchestrator — classify/dispatch/generate pipeline (7e28b89)
  • feat(api): add agent config export/import with JSON and YAML support (7f335c4)
  • feat(api): add editImage with img2img, inpainting, and outpainting support (f5bc775)
  • feat(api): add embedText for direct embedding generation (a86f847)
  • feat(api): add generateObject and streamObject for Zod-validated structured output (67a8fd5)
  • feat(api): add upscaleImage and variateImage for image post-processing (d13952a)
  • feat(emergent): add SKILL.md and CAPABILITY.yaml export for forged tools (cd29461)
  • feat(images): add Flux (BFL) and Fal.ai image providers with async polling (2f6e8c1)
  • feat(llm): add Anthropic provider with native Messages API, tool calling, and streaming (407a0ee)
  • feat(llm): add Google Gemini provider with native API, tool calling, and streaming (552f20d)
  • feat(llm): add Groq, Together, Mistral, and xAI providers via OpenAI-compatible adapters (c841a3c)
  • feat(orchestration): add parallel node execution and agent-level graph builder (0629d3c)
  • feat(orchestration): compile agency strategies to CompiledExecutionGraph for real DAG execution (6690dfe), closes hi#level
  • feat(query-router): add KeywordFallback for degraded-mode retrieval (38c9cb4)
  • feat(query-router): add QueryGenerator — tier-appropriate prompt construction and LLM generation (3064a53)
  • feat(query-router): add TopicExtractor with dedup, sort, cap, and prompt formatting (81ad93f)
  • feat(query-router): add types, interfaces, and barrel exports (de99953)
  • feat(rag): add multimodal indexer for image and audio content (62f2653)
  • feat(rag): add multimodal memory bridge for image, audio, video, and PDF ingestion (fc986a7)
  • feat(rag): share STT and vision providers between voice pipeline and multimodal RAG (293be37)
  • feat(vision): add unified vision pipeline with PaddleOCR, TrOCR, Florence-2, CLIP, and cloud fallbac (1238f66)
  • feat(vision): wire pipeline into multimodal indexer and add IVisionProvider implementations (4011279)
  • feat(voice-pipeline): add WebRTC DataChannel transport for low-latency audio streaming (28dfd1b)
  • docs: add 6 memory system guide pages — ingestion, import/export, consolidation, tools, storage, arc (4d08f7f)
  • docs: add image editing, vision pipeline, LLM providers, structured output, and export guides (94e9a23)
  • test: add full pipeline E2E integration test covering all high-level APIs (d903d35), closes hi#level

0.1.113 (2026-03-26)​

  • feat(memory): add observational compression, reflection, and temporal reasoning (b424f68)
  • refactor(api): Opus rewrite — agency API, strategies, HITL with comprehensive TSDoc (d550c12)
  • refactor(orchestration): Opus rewrite — voice-graph integration TSDoc + inline comments (1ce41fe)

0.1.112 (2026-03-26)​

  • refactor(voice): Opus rewrite — comprehensive TSDoc on telephony providers, parsers, transport (da5ef9b)

0.1.111 (2026-03-26)​

  • refactor(speech): Opus rewrite — comprehensive TSDoc, inline comments, stricter types across provide (9b745cd)
  • fix: audit fixes — memory + agency critical/high issues (7d0591c)

0.1.110 (2026-03-26)​

  • fix: add ternary support and boolean result handling to safe expression evaluator (ac4137e)

0.1.109 (2026-03-26)​

  • refactor(voice-pipeline): Opus rewrite — comprehensive TSDoc, inline comments, stricter types (4de7f16)

0.1.108 (2026-03-26)​

  • fix(memory): resolve cosine similarity division-by-zero and path traversal bugs (17347fa)

0.1.107 (2026-03-26)​

  • fix: resolve 5 critical bugs in orchestration and API layers (6002b28)
  • security: replace new Function() with safe expression evaluator in orchestration layer (3052c7f)

0.1.106 (2026-03-26)​

  • feat(memory): commit Memory facade integration, tools, extension bridge, tests (1e19688)

0.1.105 (2026-03-26)​

  • fix(ci): add better-sqlite3 to test.server.deps.external in vitest config (9a9d986)

0.1.104 (2026-03-26)​

  • fix(ci): mark better-sqlite3 as external in vitest config — native addon cannot be transformed by Vi (f2c5546)

0.1.103 (2026-03-26)​

  • fix: resolve 4 ESLint errors — prefer-const, no-this-alias, no-useless-escape (ff171a1)

0.1.102 (2026-03-26)​

  • fix(memory): add @types/better-sqlite3 and fix implicit any parameters for CI (98945c3)
  • feat(memory): add 6 agent memory editor tools — add, update, delete, merge, search, reflect (7531a2c)
  • feat(memory): add ChunkingEngine — fixed, semantic, hierarchical, and layout strategies (fdf4e5e)
  • feat(memory): add ConsolidationLoop — self-improving prune/merge/strengthen/derive/compact/reindex (e174869)
  • feat(memory): add facade types and extend ConsolidationConfig (ae8c04b)
  • feat(memory): add FolderScanner, MultimodalAggregator, UrlLoader (c12546d)
  • feat(memory): add IDocumentLoader interface, TextLoader, MarkdownLoader, HtmlLoader, LoaderRegistry (f871a3b)
  • feat(memory): add import/export — JSON, Markdown, Obsidian vault, SQLite, ChatGPT (c815b4a)
  • feat(memory): add Memory facade — unified public API for the complete memory system (155586a)
  • feat(memory): add PdfLoader (unpdf), OcrPdfLoader (tesseract.js), DoclingLoader, DocxLoader (6af478d)
  • feat(memory): add RetrievalFeedbackSignal and DecayModel.penalizeUnused() (e4daa7a)
  • feat(memory): add SqliteBrain — unified SQLite connection with schema and WAL mode (9a7d91d)
  • feat(memory): add SqliteKnowledgeGraph — IKnowledgeGraph backed by SQLite with recursive CTE travers (da4b0c6)
  • feat(memory): add SqliteMemoryGraph — IMemoryGraph with spreading activation and cluster detection (dc538ef)
  • feat(memory): integrate Memory facade — barrel exports, deps verified, full test suite passing (c19e99c)
  • docs: add comprehensive guides for all AgentOS components — getting started, orchestration, channels (3c3f770)
  • docs(agency): add graph strategy docs, README, and example (997cbc9)

0.1.101 (2026-03-26)​

  • feat(agency): add graph strategy with explicit dependsOn agent dependencies (c7c2c44)

0.1.100 (2026-03-26)​

  • fix(api): fix WebSocketServer import and implicit any in agency.ts (946012e)
  • feat(api): add real streaming with per-agent events for sequential strategy, session stream history (eace3d2)
  • feat(api): wire listen() for voice transport and connect() for channels on agency (a37bf45)
  • feat(api): wire RAG context injection placeholder into agency execution (e67304c)

0.1.99 (2026-03-25)​

  • test(api): add full agency integration test (1931af1)
  • test(api): add HITL beforeAgent, guardrail, and structured output tests (8d8df48)
  • test(api): add nested agency and emergent validation tests (318a463)
  • feat(api): add agency() factory function with validation, resource controls, and session management (aa2d66c)
  • feat(api): add BaseAgentConfig, AgencyOptions, and extended result types (bb3d417)
  • feat(api): add debate, review-loop, and hierarchical strategy compilers with adaptive mode (ec174de)
  • feat(api): add HITL approval handlers (cli, webhook, slack, auto) (8ceb66d)
  • feat(api): add sequential and parallel strategy compilers (a398b73)
  • feat(api): wire beforeAgent HITL into strategy compilers, forward beforeTool to sub-agents (3332209)
  • feat(api): wire guardrail input/output evaluation into agency execution (cc917f9)
  • docs: add AGENCY_API.md and update README with high-level API showcase (9807c1e), closes hi#level
  • refactor(api): unify agent() with BaseAgentConfig, remove guardrails throw (b2a9b33)

0.1.98 (2026-03-25)​

  • fix(emergent): add missing ToolPackage.ts — fixes CI build (322139a)
  • docs: fix HIGH_LEVEL_API.md — use provider-first style, add local providers (281cfbd)
  • docs(emergent): expand EMERGENT_CAPABILITIES.md with comprehensive examples (007005a)

0.1.97 (2026-03-25)​

  • docs: add EMERGENT_CAPABILITIES.md, update README + registry (16a7a1f)
  • fix(ci): fix emergent test mock types for generateText (f742ae9)

0.1.96 (2026-03-25)​

  • fix(ci): suppress empty-object-type lint error in usageLedger (4029e70)

0.1.95 (2026-03-25)​

  • feat(discovery): wire emergent tools into CapabilityDiscoveryEngine (d60308a)
  • feat(emergent): add EmergentJudge — LLM-as-judge for forged tool evaluation (dea5600)
  • feat(emergent): commit EmergentCapabilityEngine, ForgeToolMetaTool, and integration wiring (30b3895)
  • feat(emergent): wire EmergentCapabilityEngine into ToolOrchestrator and AgentOSConfig (4608dc2)
  • test(voice): add E2E voice pipeline tests with real Deepgram + OpenAI TTS (b86b333)
  • docs: add Emergent Capabilities section to README (4e87a17)

0.1.94 (2026-03-25)​

  • feat(api): add observability + usage tracking, update provider APIs, fix CI type errors (cec6339)

0.1.93 (2026-03-25)​

  • feat(emergent): add EmergentToolRegistry with tiered lifecycle management (74bdb4f)

0.1.92 (2026-03-25)​

  • feat(emergent): add SandboxedToolForge for isolated code execution (c6bbee7)
  • feat(emergent): Task 2 — ComposableToolBuilder with pipeline resolution and tests (f237352)

0.1.91 (2026-03-25)​

  • feat(emergent): Task 1 — define all types and interfaces for Emergent Capability Engine (8f80f98)

0.1.90 (2026-03-25)​

  • fix(ci): resolve typecheck errors in test files (8dc9b14)

0.1.89 (2026-03-25)​

  • fix(ci): add ./voice subpath export to resolve @framers/agentos/voice imports (457159a)
  • docs: update README tagline (5d09422)

0.1.88 (2026-03-25)​

  • fix(ci): resolve TS errors in voice test files — null assertions, return types, provider config (b2caecf)

0.1.87 (2026-03-25)​

  • feat(images): add local Stable Diffusion provider with A1111 and ComfyUI support (dc3fdeb)

0.1.86 (2026-03-25)​

  • fix(ci): prefer-const in NodeExecutor, prefix unused params, remove unused import (1e44d7c)
  • docs: add voice-graph integration guide to VOICE_PIPELINE.md (fdeab10)
  • test(orchestration): add voice graph integration tests (b39539a)

0.1.85 (2026-03-25)​

  • feat(orchestration): add voice step support to WorkflowBuilder configToNode (c7ed210)
  • feat(orchestration): add voiceNode() builder DSL and WorkflowBuilder.transport() (8310ac5)
  • feat(orchestration): add VoiceTransportAdapter for voice transport mode (8725b4c)

0.1.84 (2026-03-25)​

  • feat(orchestration): add 5 voice event variants to GraphEvent union (5286b3a)
  • feat(orchestration): add voice variant to NodeExecutorConfig + VoiceNodeConfig type (1b44b8b)
  • feat(orchestration): add VoiceNodeExecutor with exit-condition racing and barge-in abort (d4631a2)
  • feat(orchestration): add VoiceTurnCollector for voice node transcript buffering (16ff7e8)
  • feat(voice-pipeline): add VoiceInterruptError and public waitForUserTurn/pushToTTS methods (57b351a)

0.1.83 (2026-03-24)​

  • feat(orchestration): implement real extension node execution via extensionExecutor dep (4782a63)

0.1.82 (2026-03-24)​

  • fix(ci): update generateText test to match new provider-defaults error message (4212cb0)

0.1.81 (2026-03-24)​

  • fix(ci): skip docs-alignment tests when cross-repo files are unavailable (36a5d46)

0.1.80 (2026-03-24)​

  • feat(orchestration): implement real gmi/subgraph execution, expression eval, discovery/personality r (cdd908c)

0.1.79 (2026-03-24)​

  • fix(lint): exclude stale .js from lint, suppress this-alias in VoicePipeline (5c0527c)

0.1.78 (2026-03-24)​

  • docs: add known limitations section to VOICE_PIPELINE.md (ea7de63)
  • docs: soften claims where implementation is lighter than described (06433c0)
  • docs: update VOICE_PIPELINE.md and add orchestration examples (d422c57)
  • refactor(builders): tighten builder validation and type safety (3e62502)
  • fix(orchestration): stop on node failure, persist skippedNodes in checkpoints, fix branch resume (15656c8)

0.1.77 (2026-03-24)​

  • docs: update examples and README for provider-first API (6aa8387)
  • feat(api): add provider option to generateText, streamText, generateImage, agent (bd4bd1a), closes hi#level
  • feat(api): add provider-defaults registry and resolveModelOption (ae0076a)

0.1.76 (2026-03-24)​

  • fix: update package.json deps and orchestration runtime exports (378aa06)
  • fix(build): cast audio.data to BodyInit, add voice-pipeline to tsconfig include (1d3006b)
  • fix(build): rename LoopToolCallRequest/Result to avoid barrel collision, fix Buffer→Uint8Array in sp (ad768bf)
  • fix(build): widen PipelineState comparison to avoid TS2367 narrowing error (129c1d6)
  • fix(test): correct import paths in tests/api/ spec files (4b3823e)
  • docs: add speech provider ecosystem guide (de920a9)
  • docs: add telephony provider setup and configuration guide (49063d6)
  • test(speech): add resolver integration test with full discovery and fallback (d3a972f)
  • test(voice): add telephony integration test with full Twilio media stream flow (323bd97)
  • feat(agency): improve AgentCommunicationBus with typed events and examples (f4b2c71)
  • feat(speech): add AssemblyAISTTProvider with upload+poll flow (967ef65)
  • feat(speech): add AzureSpeechSTTProvider (ce6f05b)
  • feat(speech): add AzureSpeechTTSProvider with SSML synthesis (fdfcbc8)
  • feat(speech): add DeepgramBatchSTTProvider (0f9233a)
  • feat(speech): add FallbackSTTProxy and FallbackTTSProxy for provider chain fallback (76d65e2)
  • feat(speech): add resolver types, catalog updates, mark unavailable providers (ced86db)
  • feat(speech): add SpeechProviderResolver with capability-based resolution and fallback (8a3ac6b)
  • feat(speech): wire SpeechProviderResolver into SpeechRuntime (e21c728)
  • feat(voice): add MediaStreamParser interface and types (2c1c6f0)
  • feat(voice): add NormalizedDtmfReceived event type and CallManager DTMF handling (3bd70c2)
  • feat(voice): add PlivoMediaStreamParser (d0573b1)
  • feat(voice): add PlivoVoiceProvider with REST API and HMAC-SHA256 webhook verification (62ba185)
  • feat(voice): add TelephonyStreamTransport bridging phone audio to streaming pipeline (71b36c2)
  • feat(voice): add TelnyxMediaStreamParser (a7c8519)
  • feat(voice): add TelnyxVoiceProvider with REST API and Ed25519 webhook verification (1cfe26c)
  • feat(voice): add TwilioMediaStreamParser (9593ce2)
  • feat(voice): add TwilioVoiceProvider with REST API and webhook verification (ff455d7)
  • feat(voice): add TwiML/XML generation helpers for Twilio, Telnyx, Plivo (bd8cc87)
  • feat(voice): export all telephony providers, parsers, and transport (b8db4bc)
  • feat(voice): update HeuristicEndpointDetector and voice pipeline types (dbcdf52)

0.1.75 (2026-03-24)​

  • feat(orchestration): add judgeNode builder for LLM-as-judge evaluation (3e176cc)
  • test(voice-pipeline): add full conversational loop integration test (6c79487)

0.1.74 (2026-03-24)​

  • docs: add voice pipeline architecture and configuration guide (99dfabd)
  • feat(voice-pipeline): add barrel exports and update provider catalog with streaming flags (56806ae)
  • feat(voice-pipeline): add VoicePipelineOrchestrator state machine (f37a25b)
  • feat(voice-pipeline): add WebSocketStreamTransport implementing IStreamTransport (f05469e)

0.1.73 (2026-03-24)​

  • feat(voice-pipeline): add AcousticEndpointDetector wrapping silence detection (c683997)
  • feat(voice-pipeline): add core interfaces and types for streaming voice pipeline (25d2dc6)
  • feat(voice-pipeline): add HardCut and SoftFade barge-in handlers (e6cde06)
  • feat(voice-pipeline): add HeuristicEndpointDetector with punctuation and silence detection (1d820bc)
  • docs: add unified orchestration layer section to README (1214ebd)

0.1.72 (2026-03-24)​

  • chore: update package.json with image provider dependencies (96a58d3)
  • feat(api): expose generateImage and image provider config on AgentOS (74fde7d)
  • feat(images): add image generation provider abstraction (OpenAI, Stability, Replicate, OpenRouter) (dd6df60)
  • feat(providers): add Ollama image generation and provider tests (9f6b6f8)
  • refactor(gmi): update GMI interfaces for image generation support (d817ec0)
  • refactor(memory): update memory exports and store interfaces (1cca340)
  • docs: add high-level API guide and runnable examples (a66861a), closes hi#level
  • docs: update README and ecosystem docs for high-level API and image generation (12a60ab), closes hi#level
  • test(api): add agent, streamText, generateImage, and docs-alignment tests (f1b29ef)
  • fix(api): restore generateImage imports now that core/images exists (1efde67)

0.1.71 (2026-03-24)​

  • fix(lint): const instead of let, remove unused eslint-disable directives (a827082)

0.1.70 (2026-03-24)​

  • fix(build): add orchestration directory to tsconfig.build.json include (25bcdcb)
  • fix(build): resolve CI errors — stub generateImage, rename GraphMemoryScope, fix EventEmitter type n (89266b6)
  • docs: add unified orchestration layer guides (AgentGraph, workflow, mission, checkpointing) (96437bf)
  • docs(api): add comprehensive JSDoc to high-level API functions and rename tool-adapter to toolAdapte (029d4a8), closes hi#level
  • test(orchestration): add integration tests, compiler tests, and node builder tests (c4a7eac)
  • feat(orchestration): add AgentGraph builder with all edge types and compilation (e56bdbb)
  • feat(orchestration): add mission() API with goal interpolation, anchors, and PlanningEngine bridge (769b5be)
  • feat(orchestration): add SchemaLowering and GraphValidator (e2695a9)
  • feat(orchestration): add typed node builder factories (bb2762e)
  • feat(orchestration): add workflow() DSL with step, branch, parallel, and DAG enforcement (76f3eb0)
  • feat(orchestration): complete unified orchestration layer — all 4 phases (cef73ce)

0.1.69 (2026-03-23)​

  • feat(orchestration): add GraphRuntime with execute, stream, resume, and conditional edges (00a51e6)

0.1.68 (2026-03-23)​

  • feat(orchestration): add LoopController with configurable ReAct loop (db43313)
  • feat(orchestration): add NodeExecutor with type-based dispatch and timeout (7a9b6f7)

0.1.67 (2026-03-23)​

  • feat(orchestration): add NodeScheduler with topological sort and cycle detection (90fffbf)
  • feat(orchestration): add StateManager with partition management and reducers (08db90e)

0.1.66 (2026-03-23)​

  • feat(orchestration): add ICheckpointStore interface and InMemoryCheckpointStore (8a64e8f)

0.1.65 (2026-03-23)​

  • feat(orchestration): add GraphEvent types and EventEmitter (f948644)

0.1.64 (2026-03-23)​

  • feat(orchestration): add CompiledExecutionGraph IR types (0e13ac6)
  • docs: update README tagline and overview for AgentOS rebrand (bf24204)
  • ci: trigger docs rebuild after release (e890865)

0.1.63 (2026-03-23)​

  • fix(api): cast finishReason to union type (de7cf97)
  • fix(api): use camelCase ModelCompletionResponse fields (finishReason, promptTokens) (7479f34)
  • fix(api): use correct IProvider method signatures (generateCompletion/generateCompletionStream) (6d63c7d)
  • feat(api): add agent() factory with sessions and multi-turn memory (69dc854)
  • feat(api): add generateText — stateless text generation with tool support (7d4d708)
  • feat(api): add model string parser with env key resolution (75b2810)
  • feat(api): add streamText — stateless streaming with async iterables (6347aa6)
  • feat(api): add tool adapter for Zod/JSON Schema/ITool normalization (eb4c324)
  • feat(api): export generateText, streamText, agent from package root (8898a9e)
  • feat(guardrails): add sentence boundary buffering for streaming evaluation (5a92dd3)

0.1.62 (2026-03-23)​

  • feat: add multi-agent workflow example with parallel + sequential DAG execution (348570a)

0.1.61 (2026-03-23)​

  • fix(test): correct import path in MarkdownWorkingMemory.spec.ts (53bb6ac)
  • docs: add memory auto-ingest pipeline guide (0644faf)
  • docs: add persistent markdown working memory guide (a41447f)
  • docs: add persistent working memory cross-reference to cognitive memory guide (4520ee1)
  • test(memory): add unit tests for working memory tools (c9f670c)

0.1.60 (2026-03-22)​

  • feat(memory): add MarkdownWorkingMemory — persistent .md file for agent context (0ed30c4)
  • feat(memory): add update_working_memory and read_working_memory tools (3fe1840)
  • feat(memory): export MarkdownWorkingMemory and tools from barrel (1117e23)
  • feat(memory): inject persistent markdown memory into prompt assembler (4ed34d1)
  • docs: add sql-storage-adapter as persistence layer in README (71fbfa8)
  • docs: convert all remaining ASCII diagrams to Mermaid (c95afb1)
  • docs: replace ASCII architecture diagrams with Mermaid (d5f9937)

0.1.59 (2026-03-22)​

  • refactor: rename @framers/agentos-ext-skills to @framers/agentos-skills (7ae18a7)
  • docs: add comprehensive Creating Custom Guardrails authoring guide (0ee68e5)
  • docs: add ecosystem table with all packages and links (9464cb8)
  • docs: agentos-extensions is "Extension source" not "Extensions Catalog" (bdec7af)
  • docs: clarify agentos-ext-skills description in ecosystem table (4401372)
  • docs: move ecosystem after overview, remove external apps (a2f06c1)
  • docs: simplify guardrails table to 3 columns to fix overflow on docs site (f25178e)
  • docs: update factory function names from createPack to createGuardrail (2bb37f8)

0.1.58 (2026-03-21)​

  • fix(lint): resolve 2 prefer-const errors in ParallelGuardrailDispatcher (56468b0)
  • docs: update import paths to @framers/agentos-ext-* packages, promote PII extension as primary examp (95d6ede)

0.1.57 (2026-03-21)​

  • refactor: move 5 guardrail extension packs to agentos-extensions/registry/curated/safety/ (7599983)
  • refactor(guardrails): export helper functions for reuse by ParallelGuardrailDispatcher (04a57b5)
  • docs: add createPiiRedactionGuardrail callout after custom guardrail regex example (4f125c1)
  • docs: update core AgentOS docs to match shipped guardrail runtime (acd09d5)
  • fix(topicality): clear guardrail-owned drift tracker on deactivation (d509dda)
  • feat: add cosineSimilarity to shared text-utils (9241c26)
  • feat: add shared text-utils module (clamp, parseJsonResponse, tokenize, normalizeText, estimateToken (5ba9940)
  • feat(code-safety): add ~25 default rules covering OWASP Top 10 (4dabccb)
  • feat(code-safety): add barrel export + package.json exports path (4c78266)
  • feat(code-safety): add CodeSafetyGuardrail with fence-boundary buffering + tool call scanning (eadcfc2)
  • feat(code-safety): add CodeSafetyScanner with language-aware pattern matching (a72e7cf)
  • feat(code-safety): add createCodeSafetyGuardrail factory (f07b636)
  • feat(code-safety): add ScanCodeTool for on-demand scanning (7873a29)
  • feat(code-safety): add types, CodeFenceExtractor with language detection (ddbe847)
  • feat(grounding): add barrel export + package.json exports path (702cbcf)
  • feat(grounding): add CheckGroundingTool for on-demand verification (9e468fa)
  • feat(grounding): add createGroundingGuardrail factory (4df52f5)
  • feat(grounding): add GroundingGuardrail with streaming + final verification (9659e41)
  • feat(grounding): add types, ClaimExtractor with heuristic split + LLM decomposition (9247445)
  • feat(guardrails): add canSanitize and timeoutMs to GuardrailConfig (934228c)
  • feat(guardrails): add ParallelGuardrailDispatcher with two-phase execution (1ed3ed4)
  • feat(guardrails): add ragSources plumbing from response chunks to guardrail payloads (cf26569)
  • feat(guardrails): delegate to ParallelGuardrailDispatcher, extract normalizeServices (bfc22a0)
  • feat(ml-classifiers): add barrel export + package.json exports path (267219d)
  • feat(ml-classifiers): add ClassifierOrchestrator with parallel execution and worst-wins (69efbd3)
  • feat(ml-classifiers): add ClassifyContentTool for on-demand classification (69e5df6)
  • feat(ml-classifiers): add core types, config interfaces, and IContentClassifier (931e60e)
  • feat(ml-classifiers): add createMLClassifierGuardrail factory with guardrail + tool (ae999fe)
  • feat(ml-classifiers): add MLClassifierGuardrail with sliding window + 3 streaming modes (31fb998)
  • feat(ml-classifiers): add SlidingWindowBuffer with context carry-forward (68e0aee)
  • feat(ml-classifiers): add Toxicity, Injection, and Jailbreak classifiers (4e96f92)
  • feat(ml-classifiers): add WorkerClassifierProxy for browser Web Worker support (2dc4417)
  • feat(pii): add canSanitize: true to PiiRedactionGuardrail config (4894e0a)
  • feat(topicality): add barrel export + package.json exports path (f575358)
  • feat(topicality): add CheckTopicTool and createTopicalityGuardrail factory (95da69d)
  • feat(topicality): add core types, TopicDescriptor, DriftConfig, and TOPIC_PRESETS (341db10)
  • feat(topicality): add TopicalityGuardrail with forbidden/allowed/drift detection (4a030db)
  • feat(topicality): add TopicDriftTracker with EMA drift detection (fbbeca7)
  • feat(topicality): add TopicEmbeddingIndex with centroid embedding and matchByVector (c6fb1db)

0.1.56 (2026-03-20)​

  • feat: add ISharedServiceRegistry + wire into ExtensionManager (e9ff33c)
  • feat(pii): add barrel export + package.json exports path for PII pack (1cd9b51)
  • feat(pii): add core PII types, entity types, and config interfaces (7b740f0)
  • feat(pii): add createPiiRedactionGuardrail factory with guardrail + tools (bba05f1)
  • feat(pii): add EntityMerger with overlap resolution and allow/denylist (0daf331)
  • feat(pii): add IEntityRecognizer internal interface (ea6116e)
  • feat(pii): add LlmJudgeRecognizer (Tier 4) with CoT prompt and LRU cache (58050d0)
  • feat(pii): add NerModelRecognizer (Tier 3) with HuggingFace transformers (d1d8d64)
  • feat(pii): add NlpPrefilterRecognizer (Tier 2) with compromise (c7ecc9b)
  • feat(pii): add PiiDetectionPipeline with 4-tier gating and context enhancement (fba6878)
  • feat(pii): add PiiRedactionGuardrail with streaming sentence-boundary buffer (56bd1e1)
  • feat(pii): add PiiScanTool and PiiRedactTool (21a4fd4)
  • feat(pii): add RedactionEngine with 4 redaction styles (a99de2a)
  • feat(pii): add RegexRecognizer (Tier 1) with openredaction (e8ade47)
  • docs: update guardrails with PII redaction extension example + shared services (a4d6ace)
  • chore: add openredaction + optional NLP deps for PII extension (d3ca7f5)

0.1.55 (2026-03-18)​

  • fix: quote mermaid labels with parentheses (Docusaurus parse error) (b11a0ff)

0.1.54 (2026-03-17)​

  • fix: update SkillRegistry emoji encoding + add ecosystem doc (9f30ce2)
  • docs(skills): clarify skills barrel export + relationship to @framers/agentos-skills (fa0a66b)

0.1.53 (2026-03-17)​

  • fix: codex audit — barrel exports, type fixes, AgentOS cleanup (fc1918f)
  • docs: add all guide links to TypeDoc sidebar (bacb388)
  • docs: add observational memory section to RAG guide (80a47e3)
  • docs: update RAG guide — document AgentMemory facade, HydeRetriever (bad35ab)

0.1.52 (2026-03-16)​

  • feat(memory): add AgentMemory high-level facade (9eae701), closes hi#level

0.1.51 (2026-03-16)​

  • fix(telegram): resolve 409 Conflict from stale polling sessions (ec30f23)

0.1.50 (2026-03-16)​

  • feat: add barrel exports for 6 core subsystems (6075721)
  • feat: add core/tools barrel export (fixes published path) (6ca59dd)
  • feat: add domain-organized barrel for core subsystems (42b819c)
  • feat: extract TaskOutcomeTelemetryManager delegate class (7dee359)
  • feat: implement HybridUtilityAI (was empty placeholder) (189f090)
  • fix: correct test type mismatches against actual interfaces (9e038bc)
  • refactor: extract 4 turn-phase helpers + wire StreamChunkEmitter (006934c)
  • refactor: extract AgentOSServiceError and AsyncStreamClientBridge (8764f53)
  • refactor: extract orchestrator config types to OrchestratorConfig.ts (c3ad19e)
  • refactor: extract StreamChunkEmitter delegate from orchestrator (a9b6444)
  • refactor: remove dead code from AgentOSOrchestrator (f966c76)
  • refactor: wire TaskOutcomeTelemetryManager into orchestrator (d80bd95)
  • test: add 122 tests for extracted modules (0023ce0)
  • chore(release): v0.1.50 — HyDE retriever, quiet EmbeddingManager (68eea3c)

0.1.49 (2026-03-16)​

  • fix(hyde): adaptive threshold counting, config validation, quiet logs (7dae907)
  • test: add HyDE retriever unit tests (409 lines) (dc72810)

0.1.48 (2026-03-15)​

  • feat: add HyDE (Hypothetical Document Embedding) retriever (bf621b4)
  • chore: linter fixes — OllamaProvider, CapabilityIndex, SpeechRuntime (15cc6f0)

0.1.47 (2026-03-15)​

  • fix: downgrade embedding batch errors to console.debug (197f21e)
  • chore(release): v0.1.47 — add speech + memory subpath exports (8a8b441)

0.1.46 (2026-03-14)​

  • fix: add logo assets and fix README image URLs (3609985)
  • docs: fix README logos, remove stale file counts, add speech module (1eec2cf)

0.1.45 (2026-03-14)​

  • feat(memory): add infinite context window system (Batch 3) (f12587b)
  • docs: add document tools to guardrails usage overview (ba43843)

0.1.44 (2026-03-13)​

  • feat(memory): enhance cognitive memory — typed taxonomy, scope hydration, prospective API (833adb0)

0.1.43 (2026-03-13)​

  • fix(memory): resolve lint errors — prefer-const and no-misleading-character-class (e7e93a9)
  • fix(memory): revert semanticBudget to let — it is reassigned downstream (10931e8)

0.1.42 (2026-03-13)​

  • fix(build): add src/memory/**/*.ts to tsconfig.build.json include list (a5c61d2)
  • feat(memory): add cognitive memory system — episodic, semantic, procedural, prospective traces (d4c6ba7)
  • chore(deps): bump sql-storage-adapter peer dep to >=0.5.0 (911bc3e)

0.1.41 (2026-03-08)​

  • feat(auth): browser-based PKCE OAuth for OpenAI + API key exchange (a9177ea)
  • Add social abstract service, OAuth flows, and expanded secret catalog (bad9841)

0.1.40 (2026-03-05)​

  • feat(social-posting): add SocialPostManager, ContentAdaptationEngine, and new ChannelPlatform types (c26feb6)

0.1.39 (2026-03-04)​

  • feat(auth): add browser-based OAuth 2.0 flows for Twitter/X and Instagram (75af64d)
  • feat(config): add Twitter OAuth and Meta OAuth extension secrets (6036de2)

0.1.38 (2026-03-04)​

  • feat(config): add github.token to extension secrets (d505070)

0.1.37 (2026-03-04)​

  • fix: resolve CapabilityGraph test failures and lint warnings (f9e6c08)

0.1.36 (2026-03-04)​

  • fix(config): add Twitter/X env var aliases to extension-secrets.json (8ac68ef)

0.1.35 (2026-03-02)​

  • fix: lint errors + bump to 0.1.34 (67d55a6)

0.1.34 (2026-03-02)​

  • fix: lazy-load graphology to prevent crash when optional peer dep missing (9ab5e61)

0.1.33 (2026-03-01)​

  • fix(build): avoid unused ts-expect-error in optional neo4j import (f9cc8b1)
  • docs(rag): document neo4j memory providers and unreleased notes (214bc0d)
  • feat(memory): add neo4j stores and adaptive task-outcome telemetry (536c249)

[Unreleased]​

Added​

  • feat(memory): Neo4j-backed memory providers for RAG (Neo4jVectorStore, Neo4jGraphRAGEngine) plus adaptive task-outcome telemetry hooks.

0.1.32 (2026-02-24)​

  • feat(auth): add OAuth authentication module for LLM providers (b72a33f)

0.1.31 (2026-02-23)​

  • fix(lint): merge duplicate 'embed' case labels in channel adapters (047b33a)

0.1.30 (2026-02-23)​

  • fix: include discovery/ in tsconfig.build.json and fix type errors (3ddf297)
  • docs(discovery): add CAPABILITY_DISCOVERY.md architecture documentation (3550f33)
  • docs(rag): document combined vector+GraphRAG search, debug tracing, HNSW config (1f3e2ea)
  • feat(discovery): add Capability Discovery Engine — semantic, tiered capability discovery (790364c)
  • feat(discovery): integrate with ToolOrchestrator, update CHANGELOG and exports (dff5cb0)
  • test(discovery): add unit tests for all discovery module components (c69962e)

[0.1.30] - 2026-02-21​

Added​

  • Capability Discovery Engine — Semantic, tiered capability discovery system that reduces context tokens by ~90% (from ~20,000 to ~1,850 tokens)
    • CapabilityDiscoveryEngine: Main orchestrator coordinating index, graph, and assembler
    • CapabilityIndex: Vector index over tools, skills, extensions, and channels using IEmbeddingManager + IVectorStore
    • CapabilityGraph: Graphology-based relationship graph with DEPENDS_ON, COMPOSED_WITH, SAME_CATEGORY, TAGGED_WITH edges
    • CapabilityContextAssembler: Token-budgeted three-tier context builder (Tier 0: always, Tier 1: retrieved, Tier 2: full)
    • CapabilityEmbeddingStrategy: Intent-oriented embedding text construction
    • CapabilityManifestScanner: File-based CAPABILITY.yaml discovery with hot-reload
    • createDiscoverCapabilitiesTool(): Meta-tool factory for agent self-discovery (~80 tokens)
  • IToolOrchestrator.listDiscoveredTools() — Filter tool list to only discovery-relevant tools
  • PromptBuilder.buildCapabilitiesSection() — Render tiered discovery context in system prompts

0.1.29 (2026-02-21)​

  • fix: remove userApiKeys from conversation metadata (f774f4b)

0.1.28 (2026-02-20)​

  • fix: resolve CI build errors in channel adapters (144bd14)
  • feat: P0+P1 channel adapters for 13 messaging platforms (5e546df)

0.1.27 (2026-02-19)​

  • fix: resolve all lint errors and warnings from CI #186 (9a5ba08), closes #186

0.1.26 (2026-02-19)​

  • feat: 28-channel parity — add IRC + Zalo Personal types, Telegram forum-topic routing (ff33916), closes chatId#topicId

0.1.25 (2026-02-18)​

  • feat(channels): expand platform types and secrets schema (badf375)

0.1.24 (2026-02-16)​

  • feat: RAG audit trail — types, collector, pipeline instrumentation, tests (e40fe00)

0.1.23 (2026-02-12)​

  • feat: add per-agent workspace directory helpers (f4f8617)
  • chore: bump version to 0.1.23 (workspace exports in dist) (d9d342c)

0.1.22 (2026-02-10)​

  • feat: expand README, fix schema-on-demand pack, update ecosystem docs (d2d6b26)
  • docs: add folder-level permissions & safe guardrails to docs (97ec2f0)
  • docs(releasing): align docs with conservative 0.x rules (ebeb8e6)

0.1.21 (2026-02-09)​

  • feat(rag): add HNSW persistence + multimodal guide (9a45d84)
  • docs: document GraphRAG updates + deletions (a9b7f56)
  • docs: update skills references to consolidated registry package (7d344f3)
  • test: relax fetch mock typing (b8647a2)

0.1.20 (2026-02-08)​

  • fix: add explicit exports for rag/reranking, rag/graphrag, core/hitl (d90340d)
  • feat(graphrag): support document removal (cca2f52)

0.1.19 (2026-02-08)​

  • fix: add ./rag and ./config/* exports to package.json (27dba19)

0.1.18 (2026-02-08)​

  • feat(graphrag): re-ingest updates (13700b8)
  • docs: update README with safety primitives details (496b172)
  • agentos: tool calling + safety + observability (00b9187)

0.1.17 (2026-02-08)​

  • feat: safety primitives — GuardedToolResult rename, tests & docs (3ca722d)

0.1.16 (2026-02-08)​

  • fix: remove all 47 stale .d.ts files from src/ that duplicate .ts sources (bdf3a56)
  • fix: remove stale .d.ts files from src/core/tools/ (6c9e307)
  • fix: use explicit type exports for ITool to avoid TS2308 ambiguity (e506d79)
  • docs: rewrite README with accurate API examples and streamlined structure (d7e5157)
  • feat: Qdrant vector store, content safety service, otel improvements (dbd7cb2)

0.1.15 (2026-02-08)​

  • fix: update skills count from 16+ to 18 (a50185e)

0.1.14 (2026-02-08)​

  • fix: provide fallback for optional personaId in pushErrorChunk call (d779a7e)
  • feat: enhanced RAG pipeline, observability, schema-on-demand extension (b6e98e4)

0.1.13 (2026-02-07)​

  • feat: add AutonomyGuard + PolicyProfiles tests, skills ecosystem improvements (36a99eb)

0.1.12 (2026-02-07)​

  • feat: add 7 P3 channel platforms for OpenClaw parity (5a988ce)

0.1.11 (2026-02-07)​

  • feat: append-only persistence, skills system, provenance hooks (73f9afb)

0.1.10 (2026-02-07)​

  • fix: remove marketing copy from architecture docs (6feb377)

0.1.9 (2026-02-07)​

  • fix: make ExtensionPackContext fields optional, add logger/getSecret (991ca25)

0.1.8 (2026-02-07)​

  • fix: add ExtensionPack onActivate/onDeactivate union type for backwards compat (c8c64e9)
  • docs: add extensions-registry package to ecosystem guide (eeb0b6a)

0.1.7 (2026-02-07)​

  • feat: channel system, extension secrets, messaging types, docs (63487ed)

0.1.6 (2026-02-06)​

  • refactor: rename extension packages to @framers/agentos-ext-* convention (233e9a4)
  • refactor: rename extension packages to @framers/agentos-ext-* convention (a6e40ac)
  • refactor: rename extension packages to @framers/agentos-ext-* convention (64b03b7)

0.1.5 (2026-02-05)​

  • fix(tests): resolve test failures with proper mocks (ce8e2bf)
  • docs: fix sidebar links for markdown pages (451ab8c)
  • docs: update sidebar links to point to .html instead of .md (d11c2ce)
  • ci(docs): ship changelog + markdown pages (be2a7bd)

0.1.4 (2026-01-25)​

  • test(api): cover generator return final response (758df4b)
  • fix(api): use generator return value for final response (0f46ab8)
  • chore: add docs/api and coverage to .gitignore, fix path reference (ef94f7a)

0.1.2 (2025-12-17)​

  • docs: add comprehensive GUARDRAILS_USAGE.md (a42d91d)
  • docs: add guardrail examples and link to usage guide (b955fd1)
  • docs: add TypeDoc API documentation for v0.1.3 (74cdb3c)
  • docs: cleanup docs/README.md links (a4e90fc)
  • docs: expand AGENT_COMMUNICATION.md with implementation details [skip release] (6033bdd)
  • docs: expand PLANNING_ENGINE.md with implementation details (ee98839)
  • docs: remove MIGRATION_TO_STORAGE_ADAPTER.md (430c92a)
  • docs: remove redundant AGENTOS_ARCHITECTURE_DEEP_DIVE.md (b4e0fe2)
  • docs: update README with guardrails link and cleanup (a322f4b)
  • docs(guardrails): add TSDoc to guardrailDispatcher (de0557d)
  • docs(guardrails): add TSDoc to IGuardrailService (e973302)
  • fix: add EXTENSION_SECRET_DEFINITIONS export and fix atlas persona (692e596)
  • fix: add NODE_AUTH_TOKEN for npm auth compatibility (afe7b96)
  • fix: atlas persona schema and add orchestrator tests (10533e0)
  • fix: enable automatic semantic-release and expand docs links (86e204d)
  • fix: improve test coverage for model selection options propagation (1d86154)
  • fix: reset version to 0.1.3 from incorrect 1.0.3 [skip ci] (62697cc)
  • fix: trigger release with improved model options test coverage (18820fc), closes #1
  • fix: trigger release with updated npm token (332395f)
  • fix: trigger semantic-release with v0.1.1 tag baseline (0a5733f)
  • fix(orchestration): Correctly propagate model selection options to GMI (4342283)
  • chore: trigger CI/CD for test coverage (dae6b3f)
  • chore: trigger docs rebuild (0e5655f)
  • chore(release): 1.0.0 [skip ci] (14ea3c3)
  • chore(release): 1.0.1 [skip ci] (4daf1ff)
  • chore(release): 1.0.2 [skip ci] (3054903)
  • chore(release): 1.0.3 [skip ci] (5cd684c)
  • ci: disable semantic-release workflow (4c44a1b)
  • ci: re-enable semantic-release workflow (3dac31a)
  • test: add AgentOrchestrator unit tests (77fb28d)
  • test: add cross-agent guardrails tests (2a93c7f)
  • test: add tests for model selection options propagation in API AgentOSOrchestrator [skip release] (5960167)
  • Merge pull request #1 from Victor-Evogor/master (99eeafa), closes #1
  • feat(guardrails): add crossAgentGuardrailDispatcher (20fdf57)
  • feat(guardrails): add guardrails module exports (83480a6)
  • feat(guardrails): add ICrossAgentGuardrailService interface (f4a19c0)
  • revert: set version back to 0.1.1 (1.0.1 was premature) (e5af05f)

0.1.3 (2025-12-15)​

  • fix: atlas persona schema and add orchestrator tests (10533e0)
  • fix: improve test coverage for model selection options propagation (1d86154)
  • fix: trigger release with improved model options test coverage (18820fc), closes #1
  • fix(orchestration): Correctly propagate model selection options to GMI (4342283)
  • ci: disable semantic-release workflow (4c44a1b)
  • ci: re-enable semantic-release workflow (3dac31a)
  • chore: trigger CI/CD for test coverage (dae6b3f)
  • test: add cross-agent guardrails tests (2a93c7f)
  • test: add tests for model selection options propagation in API AgentOSOrchestrator [skip release] (5960167)
  • Merge pull request #1 from Victor-Evogor/master (99eeafa), closes #1
  • docs: add comprehensive GUARDRAILS_USAGE.md (a42d91d)
  • docs: add guardrail examples and link to usage guide (b955fd1)
  • docs: cleanup docs/README.md links (a4e90fc)
  • docs: expand AGENT_COMMUNICATION.md with implementation details [skip release] (6033bdd)
  • docs: expand PLANNING_ENGINE.md with implementation details (ee98839)
  • docs: remove MIGRATION_TO_STORAGE_ADAPTER.md (430c92a)
  • docs: remove redundant AGENTOS_ARCHITECTURE_DEEP_DIVE.md (b4e0fe2)
  • docs: update README with guardrails link and cleanup (a322f4b)
  • docs(guardrails): add TSDoc to guardrailDispatcher (de0557d)
  • docs(guardrails): add TSDoc to IGuardrailService (e973302)
  • feat(guardrails): add crossAgentGuardrailDispatcher (20fdf57)
  • feat(guardrails): add guardrails module exports (83480a6)
  • feat(guardrails): add ICrossAgentGuardrailService interface (f4a19c0)

0.1.2 (2025-12-13)​

  • fix: add EXTENSION_SECRET_DEFINITIONS export and fix atlas persona (692e596)
  • fix: add missing pino dependency (0f4afdc)
  • fix: add NODE_AUTH_TOKEN for npm auth compatibility (afe7b96)
  • fix: align AgencyMemoryManager with IVectorStore interface (3ea6131)
  • fix: clean up CodeSandbox lint issues (76ff4c3)
  • fix: clean up unused imports and params in AgentOrchestrator (ac32855)
  • fix: clean up unused variables in extension loaders (d660b03)
  • fix: correct IVectorStoreManager import path and add type annotation (487f5b5)
  • fix: enable automatic semantic-release and expand docs links (86e204d)
  • fix: guard stream responses to satisfy ts (1d2e4f7)
  • fix: ignore pushes to closed streams (3c70fa2)
  • fix: import MetadataValue from IVectorStore to resolve type conflict (2f90071)
  • fix: make sql-storage-adapter optional peer dep for standalone repo (4be6628)
  • fix: remove unused imports and variables from LLM providers (f21759d)
  • fix: remove unused imports from ModelRouter (ea2baa5)
  • fix: remove unused imports from PlanningEngine (283c42f)
  • fix: remove unused imports from storage and RAG modules (36c2b3f)
  • fix: rename unused options param in Marketplace (2071869)
  • fix: resolve all ESLint errors and warnings (093ab03)
  • fix: resolve all TypeScript build errors and update tests for new API patterns (6b34237)
  • fix: resolve critical parsing error in MemoryLifecycleManager (c5c1fb6)
  • fix: resolve iterator type errors in streaming batcher (1048fd1)
  • fix: resolve TypeScript errors in tests and config (f34ea5e)
  • fix: restore RetrievalAugmentor and ToolPermissionManager formatting (f4e881a)
  • fix: restore variables that were incorrectly marked as unused (5282d39)
  • fix: set version to 0.1.0 for initial release (e980895)
  • fix: trigger release with updated npm token (332395f)
  • fix: type cast checkHealth to avoid TS error (8683217)
  • fix: unignore eslint.config.js in gitignore (9c82ab1)
  • fix: update AgencyMemoryManager tests to match implementation (853d16f)
  • fix: update Frame.dev logo to use SVG version (128001f)
  • fix: use workspace:* for sql-storage-adapter dependency (2d3a88a)
  • fix(agentos): use import attributes with { type: 'json' } for Node 20+ (9e95660)
  • fix(build): decouple tsconfig from root to fix CI path resolution (dd14c6a)
  • fix(build): include JSON; exclude tests; add getConversation/listContexts; safe casts (86e4610)
  • fix(build): inline tsconfig base to support standalone build (161f5a0)
  • fix(build): resolve tsconfig inheritance paths (c2bd9e7)
  • fix(ci): add pnpm version to release workflow (9b64eca)
  • fix(ci): include docs workflow in path triggers (d67005f)
  • fix(ci): remove frozen-lockfile from docs workflow (fbb33b0)
  • fix(ci): remove pnpm cache requirement from release workflow (d1c90ef)
  • fix(esm): make AgentOS dist Node ESM compatible (783b0e9)
  • fix(guardrails): add type guard for evaluateOutput to satisfy TS (0381ca6)
  • fix(guardrails): avoid undefined in streaming eval; add loadPackFromFactory (e2c4d6d)
  • fix(hitl): remove unused imports in HITL module (3d5e67f)
  • test: add AgentOrchestrator unit tests (77fb28d)
  • test: add comprehensive tests for workflows, extensions, and config - coverage ~67% (672ac31)
  • test: add logging tests and configure coverage thresholds (511237e)
  • test: add tests for EmbeddingManager, uuid and error utilities (979b3e2)
  • test: add ToolExecutor coverage (6cb2b8c)
  • test: fix flaky timestamp ordering test in Evaluator (56b560d)
  • test(integration): add marketplace-evaluation integration tests (035c646)
  • ci: add CI, release, and typedoc Pages workflows (f3abfea)
  • ci: add CNAME for docs.agentos.sh custom domain (11229ce)
  • ci: add codecov coverage reporting and badge (18b8224)
  • ci: add coverage badge and CI workflow, update README (3824c78)
  • ci: add docs auto-deployment to agentos-live-docs branch (e445b15)
  • ci: add NODE_AUTH_TOKEN for npm publish (4dec42f)
  • ci: add npm token debug step (32a65c3)
  • ci: coverage badge (12ce466)
  • ci: enforce lint and typecheck quality gates (8d51aff)
  • ci: manual releases, pnpm CI, add RELEASING.md (0ee6fb6)
  • ci: replace semantic-release with direct npm publish (b3a7072)
  • chore: add ESLint v9 flat config dependencies (75556b7)
  • chore: add release workflow (semantic-release) on master (811a718)
  • chore: bootstrap repo (license, CI, docs templates) (5965a4e)
  • chore: exclude config files from codecov coverage (8dae2e3)
  • chore: fix lint findings (a60b3dd)
  • chore: fix lint findings (f55c22b)
  • chore: fix negotiation test types (4f6da15)
  • chore: include release config and dev deps (7b8e6c1)
  • chore: initial import from monorepo (b75cd7a)
  • chore: normalize file endings (9e9a534)
  • chore: pin sql-storage-adapter to ^0.4.0 (cec73d8)
  • chore: remove internal investigation docs (12f7725)
  • chore: silence unused vars in negotiation test (16ec2bf)
  • chore: sync agentos (08a25e1)
  • chore: sync agentos configs (18c46b6)
  • chore: sync changes (0f67907)
  • chore: trigger ci (8abf707)
  • chore: trigger release (c0c7a1e)
  • chore: trigger release (189e9ba)
  • chore: trigger release build (9b1b59e)
  • chore: trigger release build with codecov fix (174bec9)
  • chore: trigger v0.1.0 release (990efbb)
  • chore: type mock negotiation test (230b6e7)
  • chore: use latest @framers/sql-storage-adapter (e9fb6a9)
  • chore(build): fail agentos dist on TS errors (f7670f0)
  • chore(extensions): export multi-registry types and loaders (8ddc2d7)
  • chore(npm): rename package to @framers/agentos; add alias; update config (f4875b1)
  • chore(release): 1.0.0 [skip ci] (a2d74f2)
  • docs: add architecture deep dive and recursive self-building analysis (ce2982b)
  • docs: add changelog, typedoc config, docs index, semantic-release (1df5e43)
  • docs: add ecosystem page with related repos (f6ebb02)
  • docs: add mood evolution and contextual prompt adaptation examples (964aa72)
  • docs: add multi-agent and non-streaming examples to README (b570322)
  • docs: add Planning Engine and Agent Communication Bus documentation (8264310)
  • docs: add Planning, HITL, Communication Bus documentation and update ARCHITECTURE.md (9f25592)
  • docs: add STRUCTURED_OUTPUT.md documentation (7bd271d)
  • docs: fix empty RAG config, add eslint.config.js, improve README examples (0e595d9)
  • docs: header/footer with AgentOS + Frame logos (7ca834b)
  • docs: professional open-source README with architecture, roadmap (7e91dc3)
  • docs: remove emojis, add standalone CI workflows, fix workspace dep (9584cee)
  • docs: trigger docs workflow test (279cb2d)
  • docs: unify Frame.dev header logo (consistent with sql-storage-adapter) (1cc314b)
  • docs: update cost optimization guide (718370c)
  • docs: update README examples with structured output, HITL, and planning (05a8af2), closes hi#risk
  • docs(agentos): add LLM cost optimization guide (13acef0)
  • docs(architecture): add production emergent agency system section (0f4ed92)
  • docs(branding): use frame-logo-green-transparent-4x.png in header/footer (43b655b)
  • docs(evaluation): add LLM-as-Judge documentation (4df4181)
  • feat: automate releases with semantic-release (cced945)
  • feat: export AgencyMemoryManager from public API (207d22b)
  • feat: export RAG module from public API (43385cf)
  • feat(agency): add cross-GMI context sharing methods (23e8b0b)
  • feat(agency): add shared RAG memory for multi-GMI collectives (a62e3ae)
  • feat(config): allow custom registry configuration (1f93932)
  • feat(evaluation): add agent evaluation framework with built-in scorers (a3891ff)
  • feat(evaluation): add LLM-as-Judge scorer with criteria presets (885a6b4)
  • feat(extensions): add multi-registry loader (npm/github/git/file/url) (7109b1e)
  • feat(extensions): add persona extension kind support (96001b4)
  • feat(hitl): add Human-in-the-Loop manager interface and implementation (f12a2d0)
  • feat(knowledge): add knowledge graph for entity-relationship and episodic memory (7d199d4)
  • feat(marketplace): add agent marketplace for publishing and discovering agents (3fdcf3f)
  • feat(observability): add distributed tracing with span exporter (cb81b29)
  • feat(permissions): default allow when subscription service missing (18f8373)
  • feat(personas): allow access when subscription service missing (f5eb9cd)
  • feat(planning): add IPlanningEngine with ReAct pattern and goal decomposition (493752d)
  • feat(rag): Add RAG memory documentation and unit tests (c12d9fa)
  • feat(rag): add SqlVectorStore using sql-storage-adapter (b32f424)
  • feat(sandbox): add code execution sandbox with security controls (2f4ce03)
  • feat(structured): add StructuredOutputManager for JSON schema validation and function calling (ca6f7e8)
  • expand extension workflow runtime (88fdb87)
  • Fix lint warnings for AgentOS types (4c6b5cf)
  • Stabilize AgentOS tests and streaming (98d33cb)

0.1.0 (2025-12-11)​

  • docs: add architecture deep dive and recursive self-building analysis (ce2982b)
  • docs: add changelog, typedoc config, docs index, semantic-release (1df5e43)
  • docs: add ecosystem page with related repos (f6ebb02)
  • docs: add mood evolution and contextual prompt adaptation examples (964aa72)
  • docs: add multi-agent and non-streaming examples to README (b570322)
  • docs: add Planning Engine and Agent Communication Bus documentation (8264310)
  • docs: add Planning, HITL, Communication Bus documentation and update ARCHITECTURE.md (9f25592)
  • docs: add STRUCTURED_OUTPUT.md documentation (7bd271d)
  • docs: fix empty RAG config, add eslint.config.js, improve README examples (0e595d9)
  • docs: header/footer with AgentOS + Frame logos (7ca834b)
  • docs: professional open-source README with architecture, roadmap (7e91dc3)
  • docs: remove emojis, add standalone CI workflows, fix workspace dep (9584cee)
  • docs: trigger docs workflow test (279cb2d)
  • docs: unify Frame.dev header logo (consistent with sql-storage-adapter) (1cc314b)
  • docs: update cost optimization guide (718370c)
  • docs: update README examples with structured output, HITL, and planning (05a8af2), closes hi#risk
  • docs(agentos): add LLM cost optimization guide (13acef0)
  • docs(architecture): add production emergent agency system section (0f4ed92)
  • docs(branding): use frame-logo-green-transparent-4x.png in header/footer (43b655b)
  • docs(evaluation): add LLM-as-Judge documentation (4df4181)
  • ci: add CI, release, and typedoc Pages workflows (f3abfea)
  • ci: add CNAME for docs.agentos.sh custom domain (11229ce)
  • ci: add codecov coverage reporting and badge (18b8224)
  • ci: add coverage badge and CI workflow, update README (3824c78)
  • ci: add docs auto-deployment to agentos-live-docs branch (e445b15)
  • ci: add NODE_AUTH_TOKEN for npm publish (4dec42f)
  • ci: add npm token debug step (32a65c3)
  • ci: coverage badge (12ce466)
  • ci: enforce lint and typecheck quality gates (8d51aff)
  • ci: manual releases, pnpm CI, add RELEASING.md (0ee6fb6)
  • chore: add ESLint v9 flat config dependencies (75556b7)
  • chore: add release workflow (semantic-release) on master (811a718)
  • chore: bootstrap repo (license, CI, docs templates) (5965a4e)
  • chore: exclude config files from codecov coverage (8dae2e3)
  • chore: fix lint findings (a60b3dd)
  • chore: fix lint findings (f55c22b)
  • chore: fix negotiation test types (4f6da15)
  • chore: include release config and dev deps (7b8e6c1)
  • chore: initial import from monorepo (b75cd7a)
  • chore: normalize file endings (9e9a534)
  • chore: pin sql-storage-adapter to ^0.4.0 (cec73d8)
  • chore: remove internal investigation docs (12f7725)
  • chore: silence unused vars in negotiation test (16ec2bf)
  • chore: sync agentos (08a25e1)
  • chore: sync agentos configs (18c46b6)
  • chore: sync changes (0f67907)
  • chore: trigger ci (8abf707)
  • chore: trigger release (c0c7a1e)
  • chore: trigger release (189e9ba)
  • chore: trigger release build (9b1b59e)
  • chore: trigger release build with codecov fix (174bec9)
  • chore: type mock negotiation test (230b6e7)
  • chore: use latest @framers/sql-storage-adapter (e9fb6a9)
  • chore(build): fail agentos dist on TS errors (f7670f0)
  • chore(extensions): export multi-registry types and loaders (8ddc2d7)
  • chore(npm): rename package to @framers/agentos; add alias; update config (f4875b1)
  • feat: automate releases with semantic-release (cced945)
  • feat: export AgencyMemoryManager from public API (207d22b)
  • feat: export RAG module from public API (43385cf)
  • feat(agency): add cross-GMI context sharing methods (23e8b0b)
  • feat(agency): add shared RAG memory for multi-GMI collectives (a62e3ae)
  • feat(config): allow custom registry configuration (1f93932)
  • feat(evaluation): add agent evaluation framework with built-in scorers (a3891ff)
  • feat(evaluation): add LLM-as-Judge scorer with criteria presets (885a6b4)
  • feat(extensions): add multi-registry loader (npm/github/git/file/url) (7109b1e)
  • feat(extensions): add persona extension kind support (96001b4)
  • feat(hitl): add Human-in-the-Loop manager interface and implementation (f12a2d0)
  • feat(knowledge): add knowledge graph for entity-relationship and episodic memory (7d199d4)
  • feat(marketplace): add agent marketplace for publishing and discovering agents (3fdcf3f)
  • feat(observability): add distributed tracing with span exporter (cb81b29)
  • feat(permissions): default allow when subscription service missing (18f8373)
  • feat(personas): allow access when subscription service missing (f5eb9cd)
  • feat(planning): add IPlanningEngine with ReAct pattern and goal decomposition (493752d)
  • feat(rag): Add RAG memory documentation and unit tests (c12d9fa)
  • feat(rag): add SqlVectorStore using sql-storage-adapter (b32f424)
  • feat(sandbox): add code execution sandbox with security controls (2f4ce03)
  • feat(structured): add StructuredOutputManager for JSON schema validation and function calling (ca6f7e8)
  • fix: add missing pino dependency (0f4afdc)
  • fix: align AgencyMemoryManager with IVectorStore interface (3ea6131)
  • fix: clean up CodeSandbox lint issues (76ff4c3)
  • fix: clean up unused imports and params in AgentOrchestrator (ac32855)
  • fix: clean up unused variables in extension loaders (d660b03)
  • fix: correct IVectorStoreManager import path and add type annotation (487f5b5)
  • fix: guard stream responses to satisfy ts (1d2e4f7)
  • fix: ignore pushes to closed streams (3c70fa2)
  • fix: import MetadataValue from IVectorStore to resolve type conflict (2f90071)
  • fix: make sql-storage-adapter optional peer dep for standalone repo (4be6628)
  • fix: remove unused imports and variables from LLM providers (f21759d)
  • fix: remove unused imports from ModelRouter (ea2baa5)
  • fix: remove unused imports from PlanningEngine (283c42f)
  • fix: remove unused imports from storage and RAG modules (36c2b3f)
  • fix: rename unused options param in Marketplace (2071869)
  • fix: resolve all ESLint errors and warnings (093ab03)
  • fix: resolve all TypeScript build errors and update tests for new API patterns (6b34237)
  • fix: resolve critical parsing error in MemoryLifecycleManager (c5c1fb6)
  • fix: resolve iterator type errors in streaming batcher (1048fd1)
  • fix: resolve TypeScript errors in tests and config (f34ea5e)
  • fix: restore RetrievalAugmentor and ToolPermissionManager formatting (f4e881a)
  • fix: restore variables that were incorrectly marked as unused (5282d39)
  • fix: type cast checkHealth to avoid TS error (8683217)
  • fix: unignore eslint.config.js in gitignore (9c82ab1)
  • fix: update AgencyMemoryManager tests to match implementation (853d16f)
  • fix: update Frame.dev logo to use SVG version (128001f)
  • fix: use workspace:* for sql-storage-adapter dependency (2d3a88a)
  • fix(agentos): use import attributes with { type: 'json' } for Node 20+ (9e95660)
  • fix(build): decouple tsconfig from root to fix CI path resolution (dd14c6a)
  • fix(build): include JSON; exclude tests; add getConversation/listContexts; safe casts (86e4610)
  • fix(build): inline tsconfig base to support standalone build (161f5a0)
  • fix(build): resolve tsconfig inheritance paths (c2bd9e7)
  • fix(ci): add pnpm version to release workflow (9b64eca)
  • fix(ci): include docs workflow in path triggers (d67005f)
  • fix(ci): remove frozen-lockfile from docs workflow (fbb33b0)
  • fix(ci): remove pnpm cache requirement from release workflow (d1c90ef)
  • fix(esm): make AgentOS dist Node ESM compatible (783b0e9)
  • fix(guardrails): add type guard for evaluateOutput to satisfy TS (0381ca6)
  • fix(guardrails): avoid undefined in streaming eval; add loadPackFromFactory (e2c4d6d)
  • fix(hitl): remove unused imports in HITL module (3d5e67f)
  • expand extension workflow runtime (88fdb87)
  • Fix lint warnings for AgentOS types (4c6b5cf)
  • Stabilize AgentOS tests and streaming (98d33cb)
  • test: add comprehensive tests for workflows, extensions, and config - coverage ~67% (672ac31)
  • test: add logging tests and configure coverage thresholds (511237e)
  • test: add tests for EmbeddingManager, uuid and error utilities (979b3e2)
  • test: add ToolExecutor coverage (6cb2b8c)
  • test: fix flaky timestamp ordering test in Evaluator (56b560d)
  • test(integration): add marketplace-evaluation integration tests (035c646)

Changelog

All notable changes to @framers/agentos are documented in this file.

This changelog is automatically generated by semantic-release based on Conventional Commits.


[0.1.0] - 2024-12-10​

Fixes (Pre-release)​

  • Resolved all ESLint errors and 100+ warnings across codebase
  • Fixed TypeScript strict mode violations in test files
  • Corrected MemoryLifecycleManager configuration interface
  • Fixed ExtensionLoader test API compatibility
  • Updated eslint.config.js with proper ignore patterns for underscore-prefixed variables
  • Added automated docs deployment to agentos-live-docs branch

Features​

Core Runtime​

  • AgentOS Orchestrator — Unified entry point for AI agent operations
  • GMI Manager — Generalized Mind Instance lifecycle management
  • Streaming Manager — Real-time token-level response streaming
  • Conversation Manager — Multi-turn context handling with history

Planning Engine​

  • Multi-step execution plans — Generate structured plans from high-level goals
  • Task decomposition — Break complex tasks into manageable subtasks
  • Plan refinement — Adapt plans based on execution feedback
  • Autonomous loops — Continuous plan-execute-reflect cycles (ReAct pattern)
  • Confidence scoring — Track plan reliability metrics

Human-in-the-Loop (HITL)​

  • Approval system — Request human approval for high-risk actions
  • Clarification requests — Resolve ambiguous situations
  • Output review — Submit drafts for human editing
  • Escalation handling — Transfer control to humans when uncertain
  • Workflow checkpoints — Progress reviews during long-running tasks

Agent Communication Bus​

  • Direct messaging — Point-to-point communication between agents
  • Broadcasting — Send messages to all agents in an agency
  • Topic pub/sub — Subscribe to channels for specific message types
  • Request/response — Query agents and await responses with timeouts
  • Structured handoffs — Transfer context between agents

RAG & Memory​

  • Vector storage — Embed and retrieve semantic memories
  • SQL storage adapter — Persistent storage with SQLite/PostgreSQL
  • Context management — Automatic context window optimization
  • Knowledge graph — Entity-relationship storage and traversal

Extensions System​

  • Tool extensions — Custom capabilities with permission management
  • Guardrail extensions — Safety and validation rules
  • Workflow extensions — Multi-step process definitions
  • Planning strategies — Customizable planning behaviors
  • Memory providers — Pluggable vector/SQL backends

Evaluation Framework​

  • Test case management — Define expected behaviors
  • Scoring functions — Exact match, semantic similarity, BLEU, ROUGE
  • LLM-as-Judge — AI-powered evaluation scoring
  • Report generation — JSON, Markdown, HTML outputs

Documentation​

  • ARCHITECTURE.md — System architecture overview
  • PLANNING_ENGINE.md — Planning and task decomposition guide
  • HUMAN_IN_THE_LOOP.md — HITL integration guide
  • AGENT_COMMUNICATION.md — Inter-agent messaging guide
  • EVALUATION_FRAMEWORK.md — Testing and evaluation guide
  • STRUCTURED_OUTPUT.md — JSON schema validation guide
  • RAG_MEMORY_CONFIGURATION.md — Memory system setup
  • SQL_STORAGE_QUICKSTART.md — Database integration guide

Infrastructure​

  • TypeScript 5.4+ with full ESM support
  • Vitest testing with 67%+ coverage
  • TypeDoc API documentation generation
  • Semantic-release for automated versioning
  • GitHub Actions CI/CD pipeline

Previous Development​

For changes prior to the public release, see the voice-chat-assistant repository commit history.