v0.8.1_2026-04-18

• Improve README file

v0.8.0_2026-04-18

Release Summary — 2026-04-18

This release upgrades pydantic-acp to pydantic-ai-slim==1.83.0, expands the upstream
capability bridge surface, improves ACP-native plan mode behavior, and tightens documentation,
projection coverage, and runtime compatibility seams.

Highlights

• Upgraded pydantic-acp to pydantic-ai-slim==1.83.0.
• Hardened hook observation and introspection against upstream private API drift.
• Added a generic bridge capability seam through CapabilityBridge.build_agent_capabilities(...).
• Expanded the built-in capability bridge surface to cover:
  • ThreadExecutorBridge
  • SetToolMetadataBridge
  • IncludeToolReturnSchemasBridge
  • WebSearchBridge
  • WebFetchBridge
  • ImageGenerationBridge
  • McpCapabilityBridge
  • ToolsetBridge
  • PrefixToolsBridge
  • OpenAICompactionBridge
  • AnthropicCompactionBridge
• Re-exported the new bridges from the public pydantic_acp package surface.

ACP Projection And UX

• Added WebToolProjectionMap and BuiltinToolProjectionMap.
• Added richer ACP tool-card projection for:
  • web search starts and results
  • web fetch starts, previews, and binary fetch fallbacks
  • image generation starts and summaries
  • upstream MCP capability calls and tool-list responses
• Added visible transcript updates for provider-owned compaction, including OpenAI preflight
  compaction visibility and Anthropic CompactionPart projection.
• Fixed builtin tool result projection from ModelResponse history.
• Expanded the default tool classifier to recognize common web, image, and mcp_server:* builtin
  tool names.

Native Plan Mode

• Added TaskPlan as the structured native-plan output surface for ACP plan mode.
• Added a session-local plan_generation_type config option for PrepareToolsBridge with
  structured and tools modes.
• Made structured the default plan-mode behavior so native plan mode can require structured plan
  generation without exposing acp_set_plan.
• Restored tool-based native plan recording behind plan_generation_type="tools".
• Kept plan progress tools (acp_update_plan_entry, acp_mark_plan_done) tied to
  plan_tools=True execution flows.

Runtime And Maintainability

• Moved remaining private and semi-private hook access behind a dedicated compatibility layer.
• Preserved hook ordering when wrapping Hooks(...) capabilities.
• Split the large runtime/adapter.py delegation surface into dedicated runtime mixins.
• Added focused inline docstrings on the public ACP-facing adapter methods and runtime mixins.

Docs And Examples

• Extended the maintained bridges example to cover the new bridge and projection surfaces.
• Updated API and bridge docs to reflect the generic capability seam and the current bridge set.
• Clarified CLI ownership boundaries between acpkit run ..., run_acp(...), and
  create_acp_agent(...).
• Expanded the factory example docs with explicit session-derived input handling and fallback
  guidance.
• Documented native plan persistence wiring and clarified how ACP-native plan rendering already
  works through AgentPlanUpdate plus acp_get_plan.
• Clarified FileSessionStore recovery guarantees versus host-owned recovery metrics.

Verification

• Added regression coverage for the new capability bridges, hook compatibility paths, projection
  updates, native plan generation modes, and adapter runtime mixin delegation paths.
• Added helper-path tests to keep coverage above the repository thresholds.

v0.7.0_2026-04-15

What's Changed

• Bump codecov/codecov-action from 5 to 6 by @dependabot[bot] in #6

Full Changelog: v0.6.0_2026-04-11...v0.7.0_2026-04-15

v0.6.0_2026-04-11

Full Changelog: v0.5.0_2026-04-10...v0.6.0_2026-04-11

v0.5.0_2026-04-10

Changelog since v0.4.2

SDK / runtime

• Added native ACP thinking capability with session-local effort selection
• Added slash commands for dynamic mode switching and thinking effort control
• Added dynamic mode-derived slash commands instead of hard-coded ask/plan/agent commands
• Added reserved mode-id validation to prevent collisions with built-in slash commands
• Added real ACP run cancellation with preserved transcript/state on stop
• Added native plan persistence hooks and automatic plan-state syncing
• Separated native plan mode from agent-mode plan progress tooling
• Improved runtime internals with dedicated agent/session/prompt runtime modules
• Added bridge model-settings support and a new ThinkingBridge
• Added HookBridge hide-all mode for quiet integrations

Pydantic ACP examples

• Simplified strong agent examples and reduced unnecessary hook/projection noise
• Fixed workspace path handling so session cwd is authoritative
• Removed agent-managed plan file writing from example tool surfaces
• Hid .acpkit plan storage from normal repo search/read flows
• Restricted plan mode so shell/write surfaces are not exposed

Docs

• Reworked docs into a fuller production-grade docs site with better structure and styling
• Added getting started, adapter config, runtime controls, plans/thinking/approvals, providers, bridges, host backends, helpers, testing, and example guides
• Added API reference pages and maintained example walkthroughs
• Added/updated llms.txt and llms-full.txt with published docs URLs
• Added a Pydantic ACP overview page and fixed strict MkDocs nav/link issues
• Improved README and skill guidance around ACP Kit’s role as an SDK for exposing existing agent surfaces through ACP

Skills

• Added packaged .agents/skills/acpkit-sdk skill structure
• Split lightweight orchestration skill from longform root SKILL.md reference
• Added skill resources, references, helper scripts, and published llms links

Tooling / quality

• Added save-coverage and check-coverage flows plus COVERAGE summary generation
• Added coverage threshold enforcement (line and branch)
• Reworked pre-commit so heavy gates run only for major changes
• Fixed docs workflow/build setup and tightened MkDocs config
• Removed stale mypy-specific config and cleaned pyright/type-ignore handling

v0.4.2_2026-04-07

Full Changelog: v0.4.1_2026-04-07...v0.4.2_2026-04-07

v0.4.1_2026-04-07

Full Changelog: v0.4.0_2026-04-07...v0.4.1_2026-04-07

v0.4.0_2026-04-07

Full Changelog: v0.3.0_2026-04-06...v0.4.0_2026-04-07

v0.3.0_2026-04-06

Full Changelog: v0.2.0_2026-04-05...v0.3.0_2026-04-06

v0.2.0_2026-04-05

What's Changed

• Bump astral-sh/setup-uv from 5 to 7 by @dependabot[bot] in #2
• Bump actions/checkout from 4 to 6 by @dependabot[bot] in #1

New Contributors

• @dependabot[bot] made their first contribution in #2

Full Changelog: https://github.com/vcoderun/acpkit/commits/v0.2.0_2026-04-05