chore(release): 0.2.0 [skip ci]

## 0.2.0 (2026-04-30)

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

Spec: docs/superpowers/specs/2026-04-26-brain-storage-abstraction-design.md
Plan: docs/superpowers/plans/2026-04-26-brain-storage-abstraction-plan.md

Author: semantic-release-bot