[github-actions]

🤖 I have created a release beep boop

1.0.0 (2026-10-30)

⚠ BREAKING CHANGES

• adr: GET /conversations response shape changed from flat list [ConversationSummary] to paginated envelope { items: [ConversationSummary], next_cursor: str | null }
• manager: X-Agent-Chat-User and the widget's user attribute are removed. Every conversation route now requires a verified token; requests without one are 401. Conversations already stored under unverified ids become unreachable rather than exposed.

Features

• agent_manager: add pagination and lazy loading for chat history (#116) (4e005be)
• agent_manager: add pagination and lazy loading for chat history (#116) (984eb09)
• agent-manager: auto-generate conversation titles from the first message (5f7257b)
• agent-manager: auto-generate conversation titles from the first message (279b040), closes #117
• approvals: add can_run_transition predicate (6c8e0e9)
• auth: carry the caller's own credential through to plugin code (90aadab)
• auth: carry the caller's own credential through to plugin code (52b146d)
• cli: handle tool approvals in remote chat (917ba1d)
• cli: handle tool approvals in remote chat (c53199c)
• dev: native development loop with watch and IDE debugging (11faa51)
• dev: native development loop with watch and IDE debugging (53ea8bf)
• engine: add resumable approval lifecycle (6fa8554)
• engine: make the repository the source of truth for tool usage (2c13948)
• engine: preserve structured tool results (dfedaac)
• engine: resolve prompt variables for orchestrators, not just agents (aae8238)
• engine: resolve prompt variables for orchestrators, not just agents (d87b3f5)
• examples: add WhatsApp pilot example, runbook, and rehearsal (675c874)
• expose manager playground route (82c405f)
• manager: add durable channel storage (b2c467d)
• manager: add immutable conversation lifecycle (1122e83)
• manager: add WhatsApp channel and durable run token accounting (6b9ada3)
• manager: adopt a visitor's conversations when they sign in (81c40c1)
• manager: choose the tool-usage backend in the composition root (3667456)
• manager: connect WhatsApp webhook, worker, and delivery (63033b8)
• manager: log channel status and webhook rejections (b13f7ee)
• manager: prepare conversation turns idempotently (53ad584)
• manager: require a verified identity on every conversation route (6e3c9ef)
• manager: resume and persist approval decisions (ee6d98c)
• manager: WhatsApp Cloud API channel (cb71fd1)
• manager: WhatsApp pilot packaging and operations (WA-06) (85e1063)
• mcp: expose Extra as an MCP server over stdio (023b0a0)
• mcp: expose Extra as an MCP server over stdio (8e3e771)
• prompts: introduce provider-agnostic prompt provenance foundation (87d7acb)
• prompts: introduce provider-agnostic prompt provenance metadata (5a7c8c0)
• runtime: persist normalized tool execution results (e1d0427)
• tool-usage: own execution metadata in a dedicated subsystem (f41df6c)
• widget: add human approval actions (ca416af)
• widget: report identity failures instead of silently degrading (b2e28ea)
• widget: report identity failures instead of silently degrading (9d3d6cc)

Bug Fixes

• agent_manager: address review feedback on pagination for PR #124 (#116) (3b2c7b0)
• agent-manager: deliver the generated title over SSE instead of racing it (71f332e)
• agent-manager: forward full model config to the title generator (058d190)
• agent-manager: make title delivery lifecycle-safe (57da8f8)
• api: allow empty body on approve/reject endpoints (712b7d7)
• api: recover the original result on a retried approval decision (0078ca1)
• api: recover the original result on a retried approval decision (5b0e219)
• api: sanitize raw tool exception text to generic error in ToolRecord (4959cfc)
• api: sanitize raw tool exception text to generic error in ToolRecord (24cd005)
• api: santize unexpected failures during approval recovery (a81c797)
• approvals: make run registration atomic (5b67303)
• approvals: refresh authorization context before replay (7fe53b5), closes #151
• auth: accept the host token shapes the sub bug was hiding (d8e1db1)
• auth: let an explicit host bearer token outrank the session cookie (3a49342)
• auth: let the host session cookie outrank a visitor pass (c09d3bf)
• auth: stop unconditionally requiring the sub claim before ClaimMapping runs (4697e1a)
• bind HITL resumes to the reviewed tool invocation (c276763)
• bind HITL resumes to the reviewed tool invocation (1121881)
• cli: expect agentctl's local caller id in its digested form (0f6bb5b)
• cli: forward current context when approving local tools (eb5a460)
• cli: validate config before serving (b172b1a)
• cli: validate config before serving (5f1442f)
• config: rename AGENT_* env vars to EXTRA_* with backward-compat deprecation warnings (a2f20d1)
• config: rename AGENT_env vars to EXTRA_ with backward-compat deprecation warning (c6d2015)
• correctly bind async local plugins as coroutines (9811f5e)
• correctly bind async local plugins as coroutines (3410554)
• engine: align run repository and stream contracts (374874f)
• engine: cancel abandoned streaming runs (5d9c5f1)
• engine: enforce access checks before protected root execution (d30bcbf)
• engine: enforce access checks before protected root execution (4831142), closes #151
• engine: extract clean text from MCP tool results instead of stri… (c8667a4)
• engine: extract clean text from MCP tool results instead of stringifying content blocks (763a514)
• engine: give the model a final answer turn when max_iterations i… (ffe1d2f)
• engine: give the model a final answer turn when max_iterations is hit (890674f)
• engine: unify streamed resume cancellation (3b82d7b)
• explain why using extra (d72f8a2)
• forward the approver's credential on the engine's own approval endpoints (3593608)
• generate: report unreferenced tools (2581c0e)
• generate: report unreferenced tools (cc80456)
• hitl: address approval review feedback (41fc836)
• keep the credential out of AuthContext's repr (bec5c30)
• logging: align uvicorn/third-party logs with structured formatter (90711ab)
• logging: make configure_logging own the root handler unconditionally (861c60f)
• manager: account for unfinished run token usage (93281a8), closes #140
• manager: adapt cancellation errors after rebase (f2834b1)
• manager: adapt two upstream tests to the Principal signature (9d762ac)
• manager: charge ambiguous usage writes once and stream pending usage (840c592)
• manager: close two cancellation gaps on the resume and failure paths (c312837)
• manager: enforce channel controls while sending is paused (05b31af)
• manager: key token usage per execution leg (2aa617a)
• manager: let post-final stream failures propagate (2e1a392)
• manager: log failed identity verification (87087eb)
• manager: persist and sanitize final stream failures (73be056)
• manager: share one token resolution, and bundle what the HTTP edge needs (08f23f6)
• mcp: align runtime composition, migrations, HITL, and identity boundary (97911af)
• mcp: chain InvalidDecision explicitly in parse_decision wrapper (423ef7c)
• parser: reject unknown and misplaced YAML keys during spec validation (016f89d)
• parser: reject unknown and misplaced YAML keys during spec validation (c981c57)
• prompts: normalize Windows-style relative paths on POSIX (47bc125)
• reject unconsumed approval resumes (c39c2dd)
• runs: expire terminal in-memory run records (8193ad8)
• runs: expire terminal in-memory run records (e4b2484)
• runs: require atomic keyed token accounting (201530c)
• runtime: address structured result review findings (a92b9a1)
• runtime: preserve successful result on cancellation (828b6de)
• skills: complete React rule corrections from re-review (85abf45)
• skills: correct unsafe React rule examples from review (c3e4c23)
• skills: resolve remaining React rule review findings (dbfb99f)
• test: resolve mypy typecheck errors in test_repository_contract.py (a8f8352)
• tests: annotate yield fixture as Iterator[None] (3e27ab0)
• tool-usage: address review feedback (00d587c)
• type run status as RunStatus end to end (143adcd)
• widget: add drawer error notice and retry UI, and expand contract tests (b5e7578)
• widget: always clear visitor pass after successful cookie-mode link (5429976)
• widget: avoid crypto.randomUUID crash outside secure contexts (46a98ce)
• widget: avoid crypto.randomUUID crash outside secure contexts (da666bc)
• widget: enable zero-code cookie mode visitor history hand-off (68c776f)
• widget: ensure same-SPA cookie login hand-off and await visitor pass claim (41ce7ae)
• widget: express an off boolean by absence, as HTML means it (590dff7)
• widget: hide internal tool provider labels (5166956)
• widget: hide tool provider labels (3a5f3a2)
• widget: honour an explicit require-identity="false", and stop claiming an outcome (d5d56a1)
• widget: keep active resume controls available (572740c)
• widget: merge anonymous visitor history in cookie authentication mode (#104) (18a4c04)
• widget: merge anonymous visitor history in cookie authentication mode (#104) (4682781)
• widget: merge anonymous visitor history in cookie authentication mode (#104) (8b3884b)
• widget: prevent per-request token resolution race in cookie mode while keeping same-SPA cookie login hand-off (408cb43)
• widget: re-resolve identity when a SPA signs a user in (5ea7134)
• widget: re-resolve identity when a SPA signs a user in (2d8a037)
• widget: replace magic cooldown with event-driven cookie tracking and deterministic history hand-off (852be0c)
• widget: restrict automatic visitor pass claim in tokenSource to cookie mode (e29329d)
• widget: throttle unauthenticated claimVisitorHistory retries in cookie mode (8d05239)

Performance Improvements

• manager: make reading history cost one branch walk and one run lookup (2600ee2)
• parser: optimize _validate_unknown_keys loop (d821d6b)

Reverts

• manager: restore the persistent SQLite default (0d8b4ae)

Documentation

• adr: add ADR 0003 for chat history keyset pagination (ace375d)
• adr: rename ADR 0003 to 0003-cursor-pagination-and-list-response-envelope.md (df28800)
• align architecture with modular packages (28dd390)
• document the WhatsApp integration (dd29578)
• hitl: document approval actions and lifecycle (6e221ac)
• lifecycle: record cancellation and branch contracts (cac3c15)
• make the identity page a task, not a reference (59a7fce)
• readme: address PR #47 review — product hero, graph value, runnable quick start (24de784)
• readme: reposition around "Make your product queryable" (1f39527)
• refine README mark the word zero in the subtitle (651591e)
• refine README messaging and simplify value proposition (20362d8)
• refine README quick start section (0552bb4)
• refine README remove agentctl command (d499f85)
• refine the hero README messaging and simplify value proposition (59e5bd9)
• restore architectural rationale flagged in review (bf9d25b)
• runs: document repository coordination boundary (7f099a1)
• runtime: define structured tool result contract (6206ec1)
• runtime: document review-driven result safeguards (91f90c3)
• simplify README messaging and clarify Extra's AI specialist architecture (127199b)
• state what begin_execution's boolean return means (15a9ad4)
• tool-usage: record the execution-metadata architecture (f9d88e9)
• trim the identity page to the happy path (d604aeb)

---

This PR was generated with Release Please. See documentation.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
extra-c586718a	🟢 Ready	View Preview	Oct 30, 2026, 11:31 AM

💡 Tip: Enable Automations to automatically generate PRs for you.