v5.0.0

5.0.0 (2026-08-22)

⚠ BREAKING CHANGES

• agentkit: remove MCPCallEntry from mcp_toolkit

Features

• add steward hosted dependency gate (3b91408)
• agentkit: complete in-repo integration gate (Bar D follow-up) (58df0fe)
• agentkit: complete Phase 2 transport-free tool handlers (76e0209)
• agentkit: complete Phase 3 adapters and transport-free resources (111c0bf)
• agentkit: consolidate MCP attach via AgentRuntime (Phase 5-B) (8eaeb1b)
• agentkit: enhance input schema validation and dynamic registry functionality (8a6bcee)
• agentkit: enhance Phase 7 extract and integration tooling (bdfe2a0)
• agentkit: migrate agent-entries CLI and docs (0910443)
• agentkit: native platform sync emitters (0633da3)
• agentkit: Phase 1 core, MCP adapter, and Phase 3 stubs (007fa5e)
• agentkit: Phase 5-C authoring and optional @agenttool codegen (e340db8)
• agentkit: registry-backed app errors resource template (7677239)
• agentkit: remove MCPCallEntry from mcp_toolkit (9823430)
• agentkit: server fmt tool via @agenttool codegen (d835a02)
• agentkit: web platform sync (WebMCP JS + manifest + Dart path) (f3614b0)
• capability_core: migrate debug_dump_* tools (gated on dumps_supported) (397b1eb)
• capability_core: migrate enter_text, scroll, long_press, swipe, drag, hover, press_key to CoreCapability (0613295)
• capability_core: migrate fill_form with pattern-A handler (9e71dd0)
• capability_core: migrate get_screenshots, capture_ui_snapshot with onSuccess multi-content translation (0042aeb)
• capability_core: migrate hot_restart_flutter, evaluate_dart_expression, hot_reload_and_capture (1cff622)
• capability_core: migrate navigation, log, semantic, inspection tools (T4-C) (0ebe466)
• capability_core: migrate tap_widget as the pattern reference (9c6ac55)
• capability_core: migrate wait_for with pattern-A handler (97ae074)
• capability_core: scaffold package with empty CoreCapability (eed7099)
• capability-core: T4-D-3 — migrate 5 Flutter inspector tools (79b0268)
• cli/codegen_snippets: bundle Flutter main.dart init snippet (38e6b51)
• cli/init_mode_detector: pure mode-decision logic (d4293b4)
• cli/init_mode: InitMode enum + parse (977b78e)
• cli/init_target: InitTarget enum (2f26f43)
• cli/init_writers: write skills + manifests per target (191ac83)
• cli/mode_prelude: substitute prelude marker by mode (0157c01)
• cli: codegen-init command emits Flutter main.dart snippet (99e21ac)
• cli: expose 'init' subcommand (b46a394)
• cli: runInit dispatches to per-target writers (b349ad9)
• contracts: restore Apple runner compile gate (b48c92a)
• contracts: tool-surface snapshot pinned to expected_tool_surface.txt (be97780)
• core_capability: rename MCP tool prefix core_ → fmt_ (5c18563)
• enhance visual capture capabilities for macOS and web (8d5b199)
• gestures: platform-appropriate pointer kind for drag (d80ff25)
• gestures: platform-appropriate pointer kind for drag. Made by hi @dipsy in #117 (f062b3e)
• initial native capture (3ff2d73)
• kernel: define Capability + CapabilityContext + HostService contracts (494656c)
• kernel: expose FakeCommandRunner via testing library (I2) (2995f2a)
• kernel: id + prefix validators with full test coverage (9dfeefa)
• kernel: scaffold mcp_capability_kernel package (69ae09c)
• live_edit_models: scaffold pure-Dart shared models package (020e848)
• mcp_capability_core: rewrite tap_widget handler to use CommandRunner (f0c2ccf)
• mcp_capability_kernel: add CommandRunner HostService interface (c8cd135)
• mcp_server_dart: wire DefaultCommandRunner into McpHost; migrate type files to re-export mcp_shared_core (e2d6f48)
• mcp_shared_core: scaffold pure-Dart package with CoreCommand hierarchy and value types (24bb65c)
• mcp_toolkit: expose isSelected flag in semantic snapshot nodes (64a35af)
• mcp_toolkit: pump frames manually while the host window is backgrounded (729519e)
• mcp_toolkit: pump frames manually while the host window is backgrounded. Contributed by https://github.com/dipsy (thank you!) (8264cde)
• mcp: harden boundary validation across agentkit and gateways (2e00439)
• p1: handle_dialog (dismiss) tool (5832b93)
• p1: MCPToolkitBinding.setNavigatorKey opt-in API (822f376)
• p1: navigate tool (push/pop/popUntil) (4f63d74)
• p1: press_key tool + ControlFlowService (9b5009b)
• p1: scaffold press_key, handle_dialog, navigate commands (fe13ceb)
• p1: server executors + handlers + registrations (0fe69db)
• p2: hover tool via PointerHoverEvent (e798554)
• p2: scaffold fill_form and hover commands (a031e2e)
• p2: server executors + handlers + registrations (daf27e6)
• plugin: add Codex plugin manifest (d389604)
• plugin: add Cursor plugin manifest (f1f9322)
• plugin: add MCP server config for Cursor + Codex (1c4b8b9)
• plugin: revise setup skill for post-v3.0.0 surface (620a58e)
• plugin: scaffold 5 skill files with frontmatter (95bf869)
• plugin: write control skill body (bfec8d9)
• plugin: write debug skill body (b7be59e)
• plugin: write guide skill body (49bee46)
• plugin: write inspect skill body (2e2b132)
• plugin: write setup skill body (9cd8a85)
• promo: consolidate promo branch work (eca2764)
• promote hosted dependency steward gate (82868e8)
• server: flip --use-capability-kernel default to on (the cut) (849c812)
• server: McpHost capability registrar with prefix + collision enforcement (2098282)
• server: wire --use-capability-kernel flag with McpHost dispatch (default off) (44b476b)
• server: wire CoreCapability into server binary via capability kernel flag (0f577c1)
• server: wire kernel dispatch bridge + gate legacy tools on !flag (ae9139a)
• shared_core: add CoreResult.toErrorEnvelopeJson + tests (I1) (9d5b489)
• skill_assets: bundle skill bodies into mcp_server_dart (e41bc77)
• wait_for: expose via interaction_toolkit MCP entry (2c541da)
• wait_for: noText predicate (06e48ce)
• wait_for: register command + error codes (no behavior) (3383168)
• wait_for: server executor + handler + tool registration (f44c03a)
• wait_for: stable predicate (98f85d6)
• wait_for: text predicate + peekSemanticSnapshot (e0350ce)
• wait_for: WaitPredicateService time predicate (5a6b222)
• wait: add a node predicate to wait_for (f20b712)
• wait: add a node predicate to wait_for. Made by @dipsy #121 (cb749d7)
• web CDP capture and cross-platform platform view showcase (3771315)

Bug Fixes

• add FMT_MODE_PRELUDE to boundary-audit skill and sync assets (81f788c)
• add missing closing parenthesis in dynamic tools registration (72f4c90)
• agentkit: align fmt tool docs and tests after Phase 6g (059e501)
• agentkit: drop path dep on flutter_mcp_toolkit_core for publish (32d6307)
• agentkit: restore dynamic registry VM guard imports (91762e5)
• agentkit: restore xsoulspace_lints dependency in pubspec.yaml files (4f398fc)
• agents (2124310)
• agetn (08e3c29)
• align release checks with Flutter SDK pins (175ca58)
• capability_core: align scroll/swipe schemas with legacy (number distance, no direction enum) (f9e264d)
• changelog (fbdcf74)
• cli: clean StateError handling for init auto-detect; rename serverInfo to flutter-mcp-toolkit-server (34f5a8c)
• cli: validate-runtime flutter_layer fallback with platform views (d69eeaf)
• codegen-init: add correct pubspec dependency (dbbb32d)
• codegen-init: add correct pubspec dependency (0fb5230)
• codegen-init: use published mcp_toolkit package name (9d46ba3)
• codegen-init: use published mcp_toolkit package name (#1) (a53a908)
• contracts: point error_code_playbook checker at mcp_shared_core (c4df607)
• contracts: repair error_code_playbook check path + backfill playbook (a0e2d4b)
• dart (2e5568d)
• deps (5ac04bc)
• docs (468a76e)
• docs (890b2b9)
• docs: release 3.0.4 — docs.page branding and SEO (4fc98cc)
• errors summarization (9252699)
• format (1da5f5d)
• formatting (35a7e94)
• gestures: keep synthetic pointers off the platform mouse device (4fe9886)
• gestures: keep synthetic pointers off the platform mouse device. Made by @dipsy #120 (9fc64e9)
• gestures: release the synthetic device after a scroll too (62a96e9)
• https://github.com/drown0315 broken link (48fe450)
• json (c67e8fe)
• kernel: code review fixes (final params, config tests, barrel imports, immutable) (981a2ff)
• lints (288ce18)
• lints (8e2ea60)
• live edit (5facbd7)
• mcp_toolkit: don't double-dispatch tap on desktop when semantic action succeeds (ab6fc27)
• mcp_toolkit: preserve mid-frame microtask phase in suspended pump (3d6ee73)
• mcp_toolkit: tap double-dispatch on desktop + expose isSelected in semantic snapshot (af2da1a)
• mcp_toolkit: VM isolateId causes tool validation error (37fcaa8)
• mcp-registry: address PR 123 review comments (7866c28)
• mdc (7fa2976)
• p2: fill_form actually stops on first toolkit-side failure (4173a74)
• perf changelog (7eef42e)
• plugin (85e8f78)
• promo (54d981c)
• pub.dev (5a17df2)
• pubspec (bb8f573)
• readme (b95e8b3)
• readme (0aa1c00)
• release: bump Dockerfile SDK pin to dart:3.11.0-sdk (887f88f)
• release: exercise release token for 4.0.0-dev.3 (142e2b4)
• release: include package changelogs in release sync (cd7dbfd)
• release: ship macOS binaries for Apple Silicon only (b0d3422)
• release: sync generated release touchpoints (a552b30)
• release: sync package changelogs for pub publish (6dfca08)
• server: address PR #115 review comments (d2cea26)
• server: address PR 115 review comments (7f140dc)
• server: clean up Windows machine discovery process trees (11d5d02)
• server: clean up Windows machine discovery process trees. Made by @wenyue in #115 (b510de0)
• server: complete host_flag_smoke_test deletion + tighten catch clauses (27a81a4)
• server: handle already-exited root in Windows tree terminator (aa076e7)
• server: harden Windows machine discovery cleanup (4810a33)
• server: return capture_ui_snapshot images as ImageContent (043dc7a)
• server: return capture_ui_snapshot images as ImageContent. Made by https://github.com/dipsy (3667891)
• server: T2 review fixes (seal tests, partial-state rollback, dispose isolation, doc updates) (b45a706)
• server: update tools/list assertions for prefixed names (post-cut) (4103744)
• shared cor (baaf163)
• sync skill_assets.g.dart after 3.0.4 plugin bump (a618201)
• tool: detect repo root from a linked worktree in build_skill_assets (87c5cc8)
• tool: detect repo root from a linked worktree in build_skill_assets (3ea5433)
• toolkit: resolveCenter/resolveBounds return logical (not physical) coords (340e729)
• use deterministic dogfood tracker merge (3e07d3a)

Documentation

• add agentkit architecture design spec (371aa16)
• add agentkit Phase 1 implementation plan (f56c83a)
• Add Ask DeepWiki badge to README (6975f88)
• add chrstphe as a contributor for doc, and platform (9b6fd6b)
• add CONTRIBUTING maintainer section for binary releases (2c93235)
• add dipsy as a contributor for code, and maintenance (fea5eab)
• add dipsy as a contributor for code, maintenance, and bug (99d669e)
• add drown0315 as a contributor for code, maintenance, and bug (192cba5)
• add druyang as a contributor for code, maintenance, and bug (3da354e)
• add tekboxs as a contributor for code, and maintenance (0cab8cd)
• add v2 → v3 migration guide (d514710)
• add v3.0.0 spec + 4 implementation plans (c7c94aa)
• add wenyue as a contributor for code, and maintenance (41fc0e6)
• agentkit: add ecsly client DX patterns to spec and plan (f2a56da)
• agentkit: add phase6 pre-extract row to tracker (5578777)
• agentkit: add self-closing implementer/closer loop (0ff6f44)
• agentkit: align tracker and rollout after phase 4 (c4d61ba)
• agentkit: archive phase plans and refresh rollout for phase 6. (a269a26)
• agentkit: drop engineering-loop from self-closing loop (3ba7916)
• agentkit: Phase 6 Bar D spec and implementation plan. (eb30405)
• agentkit: Phase 6 platform scope — Web C, skip HarmonyOS. (a86c513)
• agentkit: Phase 6g skills and skill_assets for AgentCallEntry (893ffee)
• agentkit: Phase 6h complete_in_repo gate and closure (910d182)
• agentkit: split descriptor vs RegisteredAgentIntent (2aafb7e)
• ai_agents: redirect execution_playbook to plugin skills (a6be2dc)
• ai_agents: rewrite overview around the plugin (28c6c9d)
• append steward cascading governance instructions (880bfa4)
• architecture cleanup, intentcall, flutter mcp toolkit purpose (b1609bf)
• changelog: document v3.0.0 capability-prefix breaking change (dee690e)
• code: update lingering core_ tool-name references in code comments (fe5cece)
• contributing: add section on editing skills (26e2e2a)
• core: document DragPointerKind members and parser contract (a834cdb)
• core: remove built_in_tools + error_code_playbook (migrated to skills) (4c96a83)
• mcp_server_dart: update CHANGELOG + README for v3.0.0 names (f3842d1)
• mcp_toolkit: update README for AgentCallEntry API (5fda437)
• p1: mark P1 shipped in roadmap (3ed54d1)
• p2: close audit gap matrix + persist DPR bug as todo (94b98ca)
• p2: mark P2 shipped, note select_option deferral in audit (465d172)
• p3: defer network introspection — move spec to todo/ (7a49850)
• p3: network introspection design (48248b3)
• p4: consolidation research — defer set A/C, drop set B from candidates (2cc95e0)
• persist steward proof summaries (339b20f)
• plan: scope down v3.0.0 — defer live_edit to post-release (afc06ba)
• plugin: add plugin source README (3e2ef37)
• plugin: update flutter-mcp plugin surfaces for core_* tool names (a6251f7)
• prepare runtime text input steward proof (87c493c)
• readme: rewrite hero around the four-step install (14c8fb2)
• record bounded steward h5 adoption (bf21f6f)
• record steward adoption evidence (fd0c059)
• refresh direct steward proof summaries (638b970)
• refresh steward h5 proof summary (d74a524)
• remove deleted-page entries from navigation (1703a92)
• remove manual install/client-setup docs (superseded by install.sh + init) (f4bc18d)
• remove per-agent setup docs (superseded by 'flutter-mcp-toolkit init <agent>') (200834b)
• server: document --use-capability-kernel requirement on McpHost services (I3) (ae71960)
• start_here: refresh migration_v2_to_v3 for v3.0.0 names (bb8c74f)
• start_here: refresh names + reference init command (5b48c5c)
• start_here: replace step 1 with four-step install (ca73616)
• update .all-contributorsrc (35101e0)
• update .all-contributorsrc (1ccbbce)
• update .all-contributorsrc (57e2178)
• update .all-contributorsrc (1f670f2)
• update .all-contributorsrc (a24a9ff)
• update .all-contributorsrc (33c1495)
• update .all-contributorsrc (2bfae74)
• update CLAUDE.md + ARCHITECTURE.md for v3.0.0 names (465d7c9)
• update GitNexus project details and enhance harness engineering lifecycle documentation (9245d8f)
• update README.md (3d4399f)
• update README.md (c055f5a)
• update README.md (a15e2bc)
• update README.md (d078171)
• update README.md (54bbf4d)
• update README.md (52fd2d5)
• update README.md (faf051e)
• update repo docs for v3.0.0 capability-kernel cut (d08ce16)
• update star history chart to README (46e5d89)
• update video walkthroughs with improved titles and punctuation (7c47074)
• wait_for: mark P0 shipped in roadmap (db5fa06)