vcoderun · fswair · Jul 8, 2026 · Jul 1, 2026 · Jul 2, 2026 · Jul 2, 2026
diff --git a/.agents/skills/codex-auth-helper/examples/codex_chat_openai_graph.py b/.agents/skills/codex-auth-helper/examples/codex_chat_openai_graph.py
@@ -11,7 +11,6 @@
 
 def describe_codex_surface() -> str:
     """Describe the LangChain-facing Codex helper seam."""
-
     return (
         "This graph uses codex-auth-helper to build a LangChain ChatOpenAI model "
         "backed by the local Codex login."

diff --git a/.gitignore b/.gitignore
@@ -69,10 +69,6 @@ references
 AGENTS.md
 SPEC.md
 
-# Sessions
-.acp-sessions/
-.demo-sessions/
-
 # Temporary
 tmp
 *.snapshot
@@ -89,12 +85,13 @@ coverage.json
 direction.md
 scripts/openrouter*.py
 scripts/check_releases.py
-/.finance-agent
+# Example runtime output
+/agent_demos/
 
 # Scripts
 connect*.py
 expose*.py
+probe*.py
+pydantic_test*.py
 CHANGELOG
 .acprouter-state
-.deepagents-graph
-.workspace-graph
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,39 @@
 ACP Kit uses synchronized versions for `acpkit`, `pydantic-acp`, `langchain-acp`,
 `codex-auth-helper`, and `acpremote`.
 
+## [1.1.0] - 2026-07-07
+
+### Added
+
+- Pydantic AI v2 ACP client provider bridge (`AcpProvider`, `AcpModel`,
+  `AcpHostBridge`) in `pydantic-acp`, enabling ACP agents to be consumed as
+  Pydantic AI providers with model profiles, streaming, tool calls, approvals,
+  sessions, and projections.
+- Public export of the provider bridge surface from `pydantic_acp`.
+
+### Changed
+
+- `pydantic-acp` now requires Pydantic AI v2.
+- Dev dependency aligned with Pydantic AI v2.
+- `AcpProvider` construction now uses the explicit `acp_agent=` keyword for
+  ACP agent instances.
+- `provider.model()` now leaves ACP model selection to the wrapped agent's
+  session default; pass a concrete model name only when the ACP agent accepts
+  that `session/set_model` id.
+- Maintained examples now write generated workspaces and local session state
+  under `agent_demos/`, with `.gitignore` ignoring that single runtime output
+  directory.
+- Workspace packages synchronized to `1.1.0`.
+
+### Fixed
+
+- Type-safety and forward-reference handling in the ACP provider bridge.
+- Default ACP provider models no longer send `session/set_model("agent")` to
+  wrapped ACP agents that reject `"agent"` as an explicit remote model id.
+- `AcpProvider.model(history_mode=...)` no longer mutates the provider-wide
+  default history mode for other model instances created from the same
+  provider.
+
 ## [1.0.0] - 2026-07-03
 
 This is the first stable release of the synchronized ACP Kit workspace.
@@ -46,4 +79,5 @@ This is the first stable release of the synchronized ACP Kit workspace.
   failure paths close every owned resource deterministically.
 - CLI target import failures retain actionable root-cause details.
 
+[1.1.0]: https://github.com/vcoderun/acpkit/releases/tag/v1.1.0
 [1.0.0]: https://github.com/vcoderun/acpkit/releases/tag/v1.0.0
diff --git a/COVERAGE b/COVERAGE
@@ -1,2 +1,2 @@
-Line coverage: 100.00% (9309 / 9309)
-Branch coverage: 100.00% (3078 / 3078)
+Line coverage: 100.00% (9711 / 9711)
+Branch coverage: 100.00% (3216 / 3216)
diff --git a/Makefile b/Makefile
@@ -60,7 +60,7 @@ check-matrix:
 check-pydantic-ai-matrix:
 	@for version in $(PYDANTIC_AI_VERSIONS); do \
 		printf "$(BLUE)==>$(RESET) Checking Pydantic AI $$version compatibility...\n"; \
-		uv run --extra dev --with "pydantic-ai-slim==$$version" pytest tests/pydantic tests/test_acpkit_cli.py tests/test_native_pydantic_agent.py -q || exit $$?; \
+		PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 uv run --extra dev --with "pydantic-ai-slim==$$version" pytest -p pytest_asyncio.plugin tests/pydantic tests/test_acpkit_cli.py tests/test_native_pydantic_agent.py -q || exit $$?; \
 		uv run --extra dev --with "pydantic-ai-slim==$$version" ty check packages/adapters/pydantic-acp/src tests/pydantic examples/pydantic tests/test_acpkit_cli.py tests/test_native_pydantic_agent.py || exit $$?; \
 	done
 	@printf "$(GREEN)✔ Pydantic AI compatibility matrix complete.$(RESET)\n"

diff --git a/README.md b/README.md
@@ -277,6 +277,33 @@ Host-facing utilities include:
 - `BlackBoxHarness` for ACP boundary integration tests
 - `CompatibilityManifest` for documenting the ACP surface an integration truly supports
 
+## ACP Client Provider Bridge
+
+`pydantic-acp` also includes the inverse bridge: an ACP agent can be consumed as a Pydantic AI v2 provider/model pair via `AcpProvider` and `AcpModel`.
+
+```python
+from pydantic_ai import Agent
+from pydantic_acp import AcpProvider
+
+# `remote_acp_agent` can be any object implementing the ACP Agent interface.
+provider = AcpProvider(acp_agent=remote_acp_agent, cwd="/workspace")
+model = provider.model()
+agent = Agent(model)
+
+result = await agent.run("Summarize the current workspace state.")
+print(result.output)
+```
+
+This keeps ownership boundaries explicit:
+
+- Pydantic AI owns the outer agent run, output validation, and normal model/provider lifecycle.
+- ACP owns the delegated agent session, ACP-visible updates, and any editor or host capabilities requested by that agent.
+- `provider.model()` leaves ACP model selection to the wrapped agent's session default; pass `provider.model("zed-agent")` only when the ACP agent accepts that concrete `session/set_model` ID.
+- `AcpHostBridge` records ACP `session_update` messages and can delegate filesystem, terminal, approval, and extension callbacks to a real ACP host client when one is supplied.
+- Pydantic AI function tools are intentionally not executed directly by `AcpModel`; register tools on the ACP agent or expose host capabilities through ACP.
+
+Use this bridge when the thing you have is already an ACP agent and you want it to participate in code that expects a Pydantic AI provider/model. It is not another ACP server adapter and it does not replace `create_acp_agent(...)`.
+
 ## What `langchain-acp` Supports
 
 `langchain-acp` keeps ACP Kit's adapter seams intact while staying graph-centric on the upstream side.

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-1.0.0
+1.1.0
diff --git a/docs/api/pydantic_acp.md b/docs/api/pydantic_acp.md
@@ -24,6 +24,14 @@ This page documents the public surface re-exported by `pydantic_acp`.
 
 ::: pydantic_acp.RuntimeAgent
 
+## ACP Client Provider Bridge
+
+::: pydantic_acp.AcpProvider
+
+::: pydantic_acp.AcpModel
+
+::: pydantic_acp.AcpHostBridge
+
 ## Agent Source Classes And Protocols
 
 ::: pydantic_acp.AgentFactory

diff --git a/docs/examples/finance.md b/docs/examples/finance.md
@@ -41,7 +41,8 @@ acpkit run --addr ws://127.0.0.1:8080/acp/ws
 
 - the module exports `agent`, `config`, `acp_agent`, and `main`; use
   `acp_agent` when CLI or remote hosting must preserve the custom configuration
-- `FinancePlanPersistenceProvider` writes ACP plans into `.acpkit/plans/`
+- `FinancePlanPersistenceProvider` writes ACP plans into
+  `agent_demos/finance-agent/plans/`
 - `PrepareToolsBridge` keeps `ask`, `plan`, and `trade` behaviors explicit instead of scattering them across separate examples
 - `FileSystemProjectionMap` turns note reads and writes into rich ACP diffs
 - `NativeApprovalBridge` keeps mutating writes truthfully approval-gated