agent-engine: v0.4.1

0.4.1 (2026-08-01)

Bug Fixes

• lint: import Any and format import blocks (a897dc1)
• widget: show context-limit message on HTTP 429 token budget exceeded and disable composer (e49e814)

---

Container image:

docker pull ghcr.io/extra-org/extra:agent-engine-v0.4.1

agent-engine: v0.4.0

0.4.0 (2026-07-31)

Features

• add agent auto mode config (a1d1016)
• add approval lifecycle primitives (5a9422f)
• add data class for hidm (6b0d71a)
• add examples/starter — a small, complete reference system (a27d072)
• add scoped session approval repository (ad5d487)
• approvals: propagate identity and grant metadata through HITL (3f46464)
• build first layer engine for hidm (3fa3b49)
• cli: handle tool approvals in local chat (03e26de)
• cli: share session approvals across application lifetime (621d8c4)
• composition: manage session approval repository lifetime (db5b0e3)
• coordinate function that decide when to invoke tool or wait for approve (be30aee)
• enable auto mode in enterprise knowledge example (62c1b87)
• examples: add deterministic approval demo (a69ac63)
• examples: add real LLM local MCP approval flow (854cae2)
• examples: demonstrate MCP session approvals (4597748)
• execute tool after approve (c690438)
• expose approval resume API (e633f98)
• fail startup validation on declared-but-unimplemented plugin stubs (0b6ee39)
• one-command local dev stack for the flagship example (b88ed5f)
• scaffold missing prompt files during generate and validate them at startup (#18) (cdefacb)
• startup validation fails on declared-but-unimplemented plugin stubs (89355a1)
• support fallback models and automatic retries on LLM failure (#25) (cfce637)
• support fallback models and automatic retries on LLM failure (#25) (b6b5018)
• widget: context-usage meter backed by the agent manager (160813d)
• widget: context-usage meter backed by the agent manager (2239cd5)
• widget: conversation thread list — list, new, switch, auto-title (40175e1)
• widget: conversation thread list — list, new, switch, auto-title (6a3d111)
• widget: fluent assistant-ui-style UI and internal refactor (ee6ec09)
• widget: fluent assistant-ui-style UI and internal refactor (5dde997)
• wire approvals into langgraph runtime (2b325ed)

Bug Fixes

• approvals: harden interrupted tool resumption (4da978b)
• bundle all built-in providers and optional integrations into base deps (d2284bb)
• bundle all built-in providers and optional integrations into base deps (c862e54)
• change the pending object property to description (9186999)
• deploy: publish multi-arch container image and optimize Docker layer caching (d1be5de)
• deploy: revert Dockerfile layer caching optimization to fix build backend lookup (73fb756)
• generate: derive the plugin package from import_roots, not the folder name (56f24f3)
• generate: derive the plugin package from import_roots, not the folder name (50e1db9)
• GHSA-f4xh-w4cj-qxq8 security vulnerability (3529eaf)
• hooks: log only meaningful hook actions (25b25f2)
• make hidm docs simple (2fda83d)
• orchestrator: load both system and orchestrator prompt files (65b2812)
• orchestrator: load both system and orchestrator prompt files (677cca2), closes #38
• orchestrator: load both system and orchestrator prompt files (8b1eec5), closes #38
• persistence: make create_session insert atomically (506d21d)
• persistence: write nothing when the conversation id is taken (144cb4c)
• publish multi-arch container image (linux/amd64 + linux/arm64) — closes #37 (cbd37c0)
• resolve pre-existing lint and mypy errors so CI lands green (7976bdc)
• runtime: pass structured conversation history (19f8281)
• support backward compatible for auto mode (cb4b695)
• test: repair the header name in the conversation listing test (2f44394)
• upgrade langsmith to >=0.8.18 to address GHSA-f4xh-w4cj-qxq8 (9ba25f8)
• upgrade langsmith to 0.8.18 (GHSA-f4xh-w4cj-qxq8) (3399cfd)
• use typing_extensions.TypedDict in local MCP tools for Python 3.11 (98cd6c1)
• widget: authorize conversations against the caller, not the id (3aa5b40)
• widget: close the remaining ownership-write and identity edges (ea80caf)
• widget: derive turn identity from the session, scope storage per user (f074134)
• widget: fix the owner of a conversation at creation (eb998d2)
• widget: name the meter for what it measures — a token budget (e4705b0)

Reverts

• leave the enterprise example exactly as it was (be900bf)

Documentation

• add human-in-the-loop approval guide (c1e78d1)
• add human-in-the-loop approval guide ([d249b6f](https:...

agent-engine: v0.3.1

0.3.1 (2026-07-12)

Bug Fixes

• Docker entrypoint can't launch agent-manager (documented widget quickstart is broken) (ae2a8d6)

---

Container image:

docker pull ghcr.io/extra-org/extra:agent-engine-v0.3.1

agent-engine: v0.3.0

0.3.0 (2026-07-12)

Features

• add support in gemini client (1592c92)
• add support in openai client (66a3f90)

Bug Fixes

• AccessFilter fails open (run crash) when the access resolver raises (02cfdd1)
• fail closed when the access resolver raises (5846ef4)
• navbar.primary.href needs a leading slash (e5c019b)
• pin numpy<2.2 in dev extras so mypy passes on fresh installs (e4ce294)
• pin numpy<2.2 in dev extras so mypy passes on fresh installs (a139d31)
• secret scan rejects benign prose ("password reset") while missing real keys (sk-...) (8fd8445)
• stop secret scan from rejecting prose that mentions secret words (7c2c3b9)
• use current Mintlify docs.json schema for navbar/footer GitHub link (93a0c10)
• validate agent temperature configuration (6f5ec15)
• validate agent temperature configuration (4fd6618)

Documentation

• add agent prompts to README example (781d2bc)
• add mkdir command for prompt subdirectories in tutorial Step 9 (02df686)
• API reference examples don't match the implemented contract (9f68c75)
• claude code setup skill (8921568)
• make the HTTP API reference match the implemented contract (d3640e1)
• remove stray character in CLAUDE.md heading (69c7e6d)
• remove stray character in CLAUDE.md heading (5da01bb)
• update repo and image references to extra-org (d0be7d1)

---

Container image:

docker pull ghcr.io/extra-org/extra:agent-engine-v0.3.0

agent-engine: v0.2.2

0.2.2 (2026-07-10)

Bug Fixes

• remove static version field conflicting with dynamic hatch versioning (136feaf)

---

Container image:

docker pull ghcr.io/extra-org/extra:agent-engine-v0.2.2

agent-engine: v0.2.1

0.2.1 (2026-07-10)

Bug Fixes

• build container in the same run as release-please, not on release event (ae7181c)

agent-engine: v0.2.0

0.2.0 (2026-07-10)

Features

• add init_ file to mark it as python package and enable imporing (ea07e64)
• add --log-llm flag for on-demand LLM conversation tracing (c2694db)
• add "transform_tool_result" hook that enable to add manipulation and logic on the response before reach to the llm (d49677a)
• add Amazon Bedrock model provider support (f67a836)
• add chat for demo propose (de41c29)
• add cli.py with validate/generate/run commands (9384c94)
• add command to generate agents: (7f9df43)
• add core/ layer — spec dataclasses, parser ABC, validator (018cc5f)
• add engine/langgraph/engine.py with RouteFilter (4962369)
• add engine/types.py + engine/engine.py ABC (54bd8e1)
• add example mcp server (81160ab)
• add example of usage in langGraph (9bb264e)
• add generate/generator.py (8669583)
• add loaders/ + migrate resolver plugins to class Resolver convention (6eb0093)
• add more plugins (c68e272)
• add parsers/yaml_parser.py (fd30d09)
• add per-MCP auth plugin system (858ceef)
• add pluggable observability via LangChain callbacks (bf47e48)
• add prompts example (293bbac)
• add sessionId to the flow (32a8361)
• add tool usage summary to CLI run output (850440c)
• build resolvers flow (5438a4d)
• build yaml validator (0c02a9f)
• change config and YAML file base on the expected schema (8280fd1)
• clean mcp resource when done (51c8fdf)
• cli: add offline validate and inspect commands (7a1fde3)
• configure logger (6f31c59)
• create general mcp client (2c95572)
• create tool adapter to invoke tool base on the state(remote-mcp, or local tool) (97bc1f3)
• create tool registry that each tool in the system (mcp or local tool) register and abstract the work with langGraph (24d6cc8)
• demo: real widget->agent->sub-agent flow demo page (d30ef54)
• dev runtime hooks (2d8dab3)
• engine: real token tracking and conversation budget enforcement (0e8e84e)
• examples: deterministic widget sub-agent demo config (4ba5100)
• extend the database-backed conversation persistence layer (a5fd4e6)
• first phase of engine (cf19eb8)
• generate examples files that need to be implemented by the client (7bd43ba)
• invoke hooks base on stage (c50810d)
• modularize agent chat widget (3883dfe)
• replace MCPManager with langchain-mcp-adapters (ab80719)
• restore shared vs agent resolver scope with inheritance (c4f1550)
• runtime-enforced execution limits (c710fcc)
• serve agent systems over HTTP via agentctl serve (4deb2ed)
• streaming support (e697430)
• structured logging and always-on observability (226f8ac)
• support tags in agent YAML and also support tags in transport (if provided) (5ca80bb)
• update runtime to generate resolver classes base on the agents names (79ad5f9)
• validate hooks (42de791)
• widget: add browser demos, e2e tests, and accessibility polish (5cd7e29)
• widget: emit safe routing metadata as agent-chat:answer (f8218a4)
• widget: render chat with React (3a26a4e)
• widget: stream agent responses (4531602)
• widget: use shadcn AI chat primitives (c38e3ea)

Bug Fixes

• add generic context to GraphState (6fc979d)
• local-mcp: disable uvicorn websockets to silence deprecation warnings (aa907b2)
• make the config JSON Schema's $id resolvable (4f094ad)
• preserve application logging during database migrations (9b1b9da)
• remove not used tables (fcc0f39)
• resolve MCP auth headers per request, not once at startup (b35b181)
• tool registry hold providers, he is not provider (fa3c11b)
• widget: recover stale agent conversations (64523b9)

Documentation

• add foundational documentation for the Declarative Agent Platform, including AGENTS.md, CLAUDE.md, and various design documents in the docs directory (a4a8cbe)
• add Mintlify documentation site (7cb81b2)
• add observability page — structured logging and Langfuse tracing (46b3436)
• add runtime hooks (073f264)
• add theme field to docs.json (c6a46b8)
• align with supervisor pattern and current engine/MCP reality (de0f5af)
• alignment with the actual logic (42a4bb8)
• clarify executi...