acpkit 0.9.2__tar.gz → 0.9.4__tar.gz

{acpkit-0.9.2 → acpkit-0.9.4}/.agents/skills/acpkit-sdk/resources/intro.md

@@ -69,6 +69,10 @@ Use these seams intentionally:
   advertise image, audio, or embedded context unless the runtime can honor them
 - only one `PrepareToolsMode(..., plan_mode=True)` is allowed
 - `plan_tools=True` is how a non-plan execution mode keeps plan progress tools visible
+- `PrepareOutputToolsBridge` is the separate seam for structured-output tool preparation in
+  current Pydantic AI
+- `HookBridge` covers output-tool preparation, output validation, output processing, and
+  deferred tool-call observation
 - `/thinking` only exists when `ThinkingBridge()` is configured
 - native ACP plan state and `PlanProvider` are separate ownership paths
 - permission card rendering is `NativeApprovalBridge.tool_call_builder`, not an `AdapterConfig`

{acpkit-0.9.2 → acpkit-0.9.4}/.agents/skills/pydantic-acp/SKILL.md

@@ -116,6 +116,12 @@ High-value public seams:
 - `NativeApprovalBridge`
 - `PermissionToolCallBuilder`
 - `ApprovalPolicyStore`
+- `PrepareToolsBridge`
+- `PrepareToolsMode`
+- `PrepareOutputToolsBridge`
+- `PrepareOutputToolsMode`
+- `ThinkingBridge`
+- `HookBridge`
 - `SlashCommandProvider`
 - `StaticSlashCommandProvider`
 - `ExternalHookEventBridge`
@@ -128,6 +134,19 @@ Package entrypoint:
 
 - [Package entrypoint](https://github.com/vcoderun/acpkit/blob/main/packages/adapters/pydantic-acp/src/pydantic_acp/__init__.py)
 
+## Current Pydantic AI Compatibility
+
+`pydantic-acp` currently targets `pydantic-ai-slim==1.92.0`.
+
+When working on this surface, remember:
+
+- `PrepareToolsBridge` owns function-tool preparation and mode-specific plan tool visibility
+- `PrepareOutputToolsBridge` owns structured-output tool preparation and session metadata for output-tool modes
+- `HookBridge` covers output-tool preparation, output validation, output processing, and deferred tool-call observation
+- prompt runtime passes ACP session identity through Pydantic AI `conversation_id` and run `metadata`
+- `run_stream_events()` returns an async context manager in current Pydantic AI; keep direct async-iterable fallback only for tests and compatibility fakes
+- `OpenAICompactionBridge` must not pass deprecated `instructions=` into upstream `OpenAICompaction`
+
 ## Module Guide
 
 | Subsystem | Key files | Use them for |
@@ -190,7 +209,7 @@ It supports:
 - mode switching
 - config options
 - ACP-native plans
-- tool-based or structured plan generation
+- `Tool Plans` or `Structured Plans` plan generation
 - custom slash command providers
 - session replay and fork/resume/load/close/list lifecycle
 - slash command discovery and rendering
@@ -205,6 +224,10 @@ This package should be the reference answer whenever the question is:
 
 High-value bridges include:
 
+- `PrepareToolsBridge`
+- `PrepareOutputToolsBridge`
+- `ThinkingBridge`
+- `HookBridge`
 - `ThreadExecutorBridge`
 - `SetToolMetadataBridge`
 - `IncludeToolReturnSchemasBridge`

{acpkit-0.9.2 → acpkit-0.9.4}/.gitignore

@@ -96,6 +96,6 @@ scripts/check_releases.py
 connect*.py
 expose*.py
 CHANGELOG
-/.acprouter-state
-/.deepagents-graph
-/.workspace-graph
+.acprouter-state
+.deepagents-graph
+.workspace-graph

acpkit-0.9.4/COVERAGE

@@ -0,0 +1,2 @@
+Line coverage: 100.00% (8953 / 8953)
+Branch coverage: 100.00% (2996 / 2996)

{acpkit-0.9.2 → acpkit-0.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acpkit
-Version: 0.9.2
+Version: 0.9.4
 Summary: ACP Kit provides a common adapter for Agent Frameworks.
 Project-URL: Homepage, https://vcoderun.github.io/acpkit/
 Project-URL: Issues, https://github.com/vcoderun/acpkit/issues
@@ -16,31 +16,13 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.11
 Requires-Dist: click>=8.1.8
-Requires-Dist: fast-agent-mcp>=0.2.25
-Requires-Dist: mcp>=1.27.0
 Requires-Dist: typing-extensions>=4.12.0
 Provides-Extra: all
 Requires-Dist: acpremote; extra == 'all'
-Requires-Dist: agent-client-protocol>=0.9.0; extra == 'all'
-Requires-Dist: basedpyright; extra == 'all'
 Requires-Dist: codex-auth-helper; extra == 'all'
 Requires-Dist: langchain-acp; extra == 'all'
 Requires-Dist: langchain-acp[deepagents]; extra == 'all'
-Requires-Dist: langchain-openai>=0.3.26; extra == 'all'
-Requires-Dist: mkdocs-material; extra == 'all'
-Requires-Dist: mkdocstrings[python]; extra == 'all'
-Requires-Dist: pre-commit; extra == 'all'
 Requires-Dist: pydantic-acp; extra == 'all'
-Requires-Dist: pydantic-ai-slim; extra == 'all'
-Requires-Dist: pydantic-graph; extra == 'all'
-Requires-Dist: pydantic>=2.7; extra == 'all'
-Requires-Dist: pytest; extra == 'all'
-Requires-Dist: pytest-asyncio; extra == 'all'
-Requires-Dist: pytest-cov; extra == 'all'
-Requires-Dist: python-dotenv; extra == 'all'
-Requires-Dist: ruff; extra == 'all'
-Requires-Dist: ty; extra == 'all'
-Requires-Dist: typing-extensions>=4.12.0; extra == 'all'
 Requires-Dist: uv>=0.8.3; extra == 'all'
 Provides-Extra: codex
 Requires-Dist: codex-auth-helper; extra == 'codex'
@@ -65,6 +47,29 @@ Requires-Dist: python-dotenv; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
 Requires-Dist: ty; extra == 'dev'
 Requires-Dist: typing-extensions>=4.12.0; extra == 'dev'
+Provides-Extra: dev-all
+Requires-Dist: acpremote; extra == 'dev-all'
+Requires-Dist: agent-client-protocol>=0.9.0; extra == 'dev-all'
+Requires-Dist: basedpyright; extra == 'dev-all'
+Requires-Dist: codex-auth-helper; extra == 'dev-all'
+Requires-Dist: langchain-acp; extra == 'dev-all'
+Requires-Dist: langchain-acp[deepagents]; extra == 'dev-all'
+Requires-Dist: langchain-openai>=0.3.26; extra == 'dev-all'
+Requires-Dist: mkdocs-material; extra == 'dev-all'
+Requires-Dist: mkdocstrings[python]; extra == 'dev-all'
+Requires-Dist: pre-commit; extra == 'dev-all'
+Requires-Dist: pydantic-acp; extra == 'dev-all'
+Requires-Dist: pydantic-ai-slim; extra == 'dev-all'
+Requires-Dist: pydantic-graph; extra == 'dev-all'
+Requires-Dist: pydantic>=2.7; extra == 'dev-all'
+Requires-Dist: pytest; extra == 'dev-all'
+Requires-Dist: pytest-asyncio; extra == 'dev-all'
+Requires-Dist: pytest-cov; extra == 'dev-all'
+Requires-Dist: python-dotenv; extra == 'dev-all'
+Requires-Dist: ruff; extra == 'dev-all'
+Requires-Dist: ty; extra == 'dev-all'
+Requires-Dist: typing-extensions>=4.12.0; extra == 'dev-all'
+Requires-Dist: uv>=0.8.3; extra == 'dev-all'
 Provides-Extra: docs
 Requires-Dist: mkdocs-material; extra == 'docs'
 Requires-Dist: mkdocstrings[python]; extra == 'docs'

acpkit-0.9.4/VERSION

@@ -0,0 +1 @@
+0.9.4

{acpkit-0.9.2 → acpkit-0.9.4}/docs/api/pydantic_acp.md

@@ -78,6 +78,10 @@ This page documents the public surface re-exported by `pydantic_acp`.
 
 ::: pydantic_acp.PrepareToolsMode
 
+::: pydantic_acp.PrepareOutputToolsBridge
+
+::: pydantic_acp.PrepareOutputToolsMode
+
 ::: pydantic_acp.ThinkingBridge
 
 ::: pydantic_acp.HookBridge

{acpkit-0.9.2 → acpkit-0.9.4}/docs/bridges.md

@@ -260,6 +260,19 @@ Use it for:
 
 It is the bridge most real coding-agent setups start with.
 
+### `PrepareOutputToolsBridge`
+
+Shapes output-tool availability per mode.
+
+Use it when:
+
+- structured-output tools should be filtered separately from normal function tools
+- ACP session metadata should expose the active output-tool mode
+- output-tool preparation should emit ACP-visible progress and failure updates
+
+This mirrors `PrepareToolsBridge`, but targets Pydantic AI's
+`PrepareOutputTools` capability.
+
 ### `ThinkingBridge`
 
 Exposes Pydantic AI’s `Thinking` capability through ACP session config.
@@ -275,6 +288,10 @@ Adds a `Hooks` capability into the active agent.
 
 Useful when you want ACP-visible hook updates that come from bridge-owned hooks rather than only from hooks already attached to the source agent.
 
+The bridge covers the current Pydantic AI hook surface, including tool
+preparation, output-tool preparation, output validation, output processing, and
+deferred tool-call observation.
+
 You can also suppress noisy default hook rendering with:
 
 ```python

{acpkit-0.9.2 → acpkit-0.9.4}/docs/langchain-acp.md

@@ -82,10 +82,13 @@ called inside `graph_factory=...`.
 - `AdapterConfig`
 - explicit session stores and transcript replay
 - provider-owned models, modes, and config options
+- prompt capability advertisement
 - native ACP plan state with `TaskPlan`
-- approval bridging
+- approval bridging with projection-aware permission cards
 - capability bridges
+- built-in and host-defined slash commands
 - projection maps and event projection maps
+- external hook event projection
 - ACP-facing type exports in `langchain_acp.types`
 
 The important difference is upstream shape, not ACP Kit architecture. On the LangChain side the adapter deals in graphs and middleware instead of model profiles and tool preparers.
@@ -133,6 +136,51 @@ The point is not to make the adapter magical. The point is to keep the host,
 the graph, and the ACP surface aligned without inventing runtime state the graph
 cannot really honor.
 
+## Prompt Capabilities And Slash Commands
+
+Prompt capability advertisement is configurable instead of hardcoded:
+
+```python
+from langchain_acp import AdapterConfig, AdapterPromptCapabilities
+
+config = AdapterConfig(
+    prompt_capabilities=AdapterPromptCapabilities(
+        audio=False,
+        image=False,
+        embedded_context=True,
+    )
+)
+```
+
+The adapter also owns an ACP-native slash-command layer:
+
+- mode commands such as `/ask`
+- `/model`
+- `/tools`
+- `/mcp-servers`
+- custom host commands through `slash_command_provider`
+
+```python
+from acp.schema import AvailableCommand
+from langchain_acp import (
+    AdapterConfig,
+    SlashCommandResult,
+    StaticSlashCommand,
+    StaticSlashCommandProvider,
+)
+
+config = AdapterConfig(
+    slash_command_provider=StaticSlashCommandProvider(
+        commands=[
+            StaticSlashCommand(
+                command=AvailableCommand(name="ping", description="Return pong."),
+                handler=lambda _request: SlashCommandResult(text="pong"),
+            )
+        ]
+    )
+)
+```
+
 ## Session Lifecycle And Replay
 
 Session lifecycle is first-class:
@@ -209,10 +257,23 @@ The adapter surface is:
 
 - `ApprovalBridge`
 - `NativeApprovalBridge`
+- `ProjectionAwareApprovalBridge`
+- `PermissionToolCallBuilder`
+- `ApprovalPolicyStore`
 - ACP permission requests and resume flow
 
 When the runtime really pauses for approval, the ACP session pauses for approval too.
 
+Remembered approval choices and permission card rendering live on `NativeApprovalBridge`:
+
+```python
+from langchain_acp import NativeApprovalBridge
+
+config = AdapterConfig(
+    approval_bridge=NativeApprovalBridge(enable_persistent_choices=True),
+)
+```
+
 ## Capability Bridges And Graph Build Contributions
 
 ACP Kit's bridge architecture remains intact in the LangChain adapter.
@@ -224,6 +285,7 @@ Built-in bridges:
 - `ConfigOptionsBridge`
 - `ToolSurfaceBridge`
 - `DeepAgentsCompatibilityBridge`
+- `ExternalHookEventBridge`
 
 Graph-build contributions are aggregated through:
 

{acpkit-0.9.2 → acpkit-0.9.4}/docs/llms-full.txt

@@ -1362,21 +1362,25 @@ If you are integrating `pydantic-acp` in a real product:
 
 ## Version Compatibility And Private Upstream APIs
 
-`pydantic-acp` currently pins `pydantic-ai-slim==1.83.0`.
+`pydantic-acp` currently pins `pydantic-ai-slim==1.92.0`.
 
 That is not accidental. The adapter relies on a specific, tested Pydantic AI
 surface and should still be upgraded deliberately.
 
-However, ACP Kit no longer imports Pydantic AI private history-processor
-modules directly. History processor support is expressed through ACP Kit's own
-callable aliases and passed into the public
-`Agent(..., history_processors=...)` interface.
+The current compatibility surface includes function-tool preparation,
+output-tool preparation, output validation/processing hooks,
+deferred-tool-call hooks, run metadata, and conversation IDs.
+
+ACP Kit also no longer imports Pydantic AI private history-processor modules
+directly. History processor support is expressed through ACP Kit's own callable
+aliases and passed into the public `Agent(..., history_processors=...)`
+interface.
 
 What this means in practice:
 
 - the adapter is less exposed to private upstream type-module churn
-- upgrades are still compatibility work, but the history-processor integration
-  is no longer a direct private-import dependency
+- upgrades are still compatibility work, but Pydantic AI integration points stay
+  isolated behind ACP Kit bridge and runtime seams
 
 ### LangChain ACP Overview
 URL: https://vcoderun.github.io/acpkit/langchain-acp/
@@ -1464,10 +1468,13 @@ called inside `graph_factory=...`.
 - `AdapterConfig`
 - explicit session stores and transcript replay
 - provider-owned models, modes, and config options
+- prompt capability advertisement
 - native ACP plan state with `TaskPlan`
-- approval bridging
+- approval bridging with projection-aware permission cards
 - capability bridges
+- built-in and host-defined slash commands
 - projection maps and event projection maps
+- external hook event projection
 - ACP-facing type exports in `langchain_acp.types`
 
 The important difference is upstream shape, not ACP Kit architecture. On the LangChain side the adapter deals in graphs and middleware instead of model profiles and tool preparers.
@@ -1513,6 +1520,51 @@ The point is not to make the adapter magical. The point is to keep the host,
 the graph, and the ACP surface aligned without inventing runtime state the graph
 cannot really honor.
 
+## Prompt Capabilities And Slash Commands
+
+Prompt capability advertisement is configurable instead of hardcoded:
+
+```python
+from langchain_acp import AdapterConfig, AdapterPromptCapabilities
+
+config = AdapterConfig(
+    prompt_capabilities=AdapterPromptCapabilities(
+        audio=False,
+        image=False,
+        embedded_context=True,
+    )
+)
+```
+
+The adapter also owns an ACP-native slash-command layer:
+
+- mode commands such as `/ask`
+- `/model`
+- `/tools`
+- `/mcp-servers`
+- custom host commands through `slash_command_provider`
+
+```python
+from acp.schema import AvailableCommand
+from langchain_acp import (
+    AdapterConfig,
+    SlashCommandResult,
+    StaticSlashCommand,
+    StaticSlashCommandProvider,
+)
+
+config = AdapterConfig(
+    slash_command_provider=StaticSlashCommandProvider(
+        commands=[
+            StaticSlashCommand(
+                command=AvailableCommand(name="ping", description="Return pong."),
+                handler=lambda _request: SlashCommandResult(text="pong"),
+            )
+        ]
+    )
+)
+```
+
 ## Session Lifecycle And Replay
 
 Session lifecycle is first-class:
@@ -1589,10 +1641,23 @@ The adapter surface is:
 
 - `ApprovalBridge`
 - `NativeApprovalBridge`
+- `ProjectionAwareApprovalBridge`
+- `PermissionToolCallBuilder`
+- `ApprovalPolicyStore`
 - ACP permission requests and resume flow
 
 When the runtime really pauses for approval, the ACP session pauses for approval too.
 
+Remembered approval choices and permission card rendering live on `NativeApprovalBridge`:
+
+```python
+from langchain_acp import NativeApprovalBridge
+
+config = AdapterConfig(
+    approval_bridge=NativeApprovalBridge(enable_persistent_choices=True),
+)
+```
+
 ## Capability Bridges And Graph Build Contributions
 
 ACP Kit's bridge architecture remains intact in the LangChain adapter.
@@ -1604,6 +1669,7 @@ Built-in bridges:
 - `ConfigOptionsBridge`
 - `ToolSurfaceBridge`
 - `DeepAgentsCompatibilityBridge`
+- `ExternalHookEventBridge`
 
 Graph-build contributions are aggregated through:
 
@@ -3432,6 +3498,19 @@ Use it for:
 
 It is the bridge most real coding-agent setups start with.
 
+### `PrepareOutputToolsBridge`
+
+Shapes output-tool availability per mode.
+
+Use it when:
+
+- structured-output tools should be filtered separately from normal function tools
+- ACP session metadata should expose the active output-tool mode
+- output-tool preparation should emit ACP-visible progress and failure updates
+
+This mirrors `PrepareToolsBridge`, but targets Pydantic AI's
+`PrepareOutputTools` capability.
+
 ### `ThinkingBridge`
 
 Exposes Pydantic AI’s `Thinking` capability through ACP session config.
@@ -3447,6 +3526,10 @@ Adds a `Hooks` capability into the active agent.
 
 Useful when you want ACP-visible hook updates that come from bridge-owned hooks rather than only from hooks already attached to the source agent.
 
+The bridge covers the current Pydantic AI hook surface, including tool
+preparation, output-tool preparation, output validation, output processing, and
+deferred tool-call observation.
+
 You can also suppress noisy default hook rendering with:
 
 ```python
@@ -6169,6 +6252,10 @@ This page documents the public surface re-exported by `pydantic_acp`.
 
 ::: pydantic_acp.PrepareToolsMode
 
+::: pydantic_acp.PrepareOutputToolsBridge
+
+::: pydantic_acp.PrepareOutputToolsMode
+
 ::: pydantic_acp.ThinkingBridge
 
 ::: pydantic_acp.HookBridge

{acpkit-0.9.2 → acpkit-0.9.4}/docs/pydantic-acp.md

@@ -270,18 +270,22 @@ If you are integrating `pydantic-acp` in a real product:
 
 ## Version Compatibility And Private Upstream APIs
 
-`pydantic-acp` currently pins `pydantic-ai-slim==1.83.0`.
+`pydantic-acp` currently pins `pydantic-ai-slim==1.92.0`.
 
 That is not accidental. The adapter relies on a specific, tested Pydantic AI
 surface and should still be upgraded deliberately.
 
-However, ACP Kit no longer imports Pydantic AI private history-processor
-modules directly. History processor support is expressed through ACP Kit's own
-callable aliases and passed into the public
-`Agent(..., history_processors=...)` interface.
+The current compatibility surface includes function-tool preparation,
+output-tool preparation, output validation/processing hooks,
+deferred-tool-call hooks, run metadata, and conversation IDs.
+
+ACP Kit also no longer imports Pydantic AI private history-processor modules
+directly. History processor support is expressed through ACP Kit's own callable
+aliases and passed into the public `Agent(..., history_processors=...)`
+interface.
 
 What this means in practice:
 
 - the adapter is less exposed to private upstream type-module churn
-- upgrades are still compatibility work, but the history-processor integration
-  is no longer a direct private-import dependency
+- upgrades are still compatibility work, but Pydantic AI integration points stay
+  isolated behind ACP Kit bridge and runtime seams

{acpkit-0.9.2 → acpkit-0.9.4}/packages/adapters/langchain-acp/README.md

@@ -105,10 +105,14 @@ acp_agent = create_acp_agent(graph_factory=graph_from_session)
 
 - session stores and transcript replay
 - model, mode, and config-option providers
+- prompt capability advertisement through `prompt_capabilities`
 - native plan state through `TaskPlan`
 - approval bridging from `HumanInTheLoopMiddleware`
+- remembered approval policies and permission card rendering on `NativeApprovalBridge`
 - capability bridges and graph-build contributions
+- built-in and host-defined slash commands
 - tool projection maps and event projection maps
+- external hook/event projection through `ExternalHookEventBridge`
 - `graph`, `graph_factory`, and `graph_source`
 - DeepAgents compatibility helpers where they add truthful ACP behavior
 
@@ -120,6 +124,64 @@ That means the adapter can expose:
 
 without collapsing everything into a bespoke ACP runtime.
 
+## Runtime Controls
+
+The adapter now owns a small ACP-native slash-command layer instead of leaving that surface entirely to the graph:
+
+- mode commands such as `/ask` or `/review` when the session publishes modes
+- `/model` for ACP-owned model selection
+- `/tools` for the active graph tool node
+- `/mcp-servers` for attached session MCP servers
+- custom host commands through `slash_command_provider`
+
+Example:
+
+```python
+from acp.schema import AvailableCommand
+from langchain_acp import (
+    AdapterConfig,
+    SlashCommandResult,
+    StaticSlashCommand,
+    StaticSlashCommandProvider,
+)
+
+config = AdapterConfig(
+    slash_command_provider=StaticSlashCommandProvider(
+        commands=[
+            StaticSlashCommand(
+                command=AvailableCommand(name="ping", description="Return pong."),
+                handler=lambda _request: SlashCommandResult(text="pong"),
+            )
+        ]
+    )
+)
+```
+
+Prompt capability advertisement is also explicit now:
+
+```python
+from langchain_acp import AdapterConfig, AdapterPromptCapabilities
+
+config = AdapterConfig(
+    prompt_capabilities=AdapterPromptCapabilities(
+        audio=False,
+        image=False,
+        embedded_context=True,
+    )
+)
+```
+
+If the graph uses approval middleware, remembered choices and ACP permission presentation stay on
+`NativeApprovalBridge`, not on `AdapterConfig`:
+
+```python
+from langchain_acp import NativeApprovalBridge
+
+config = AdapterConfig(
+    approval_bridge=NativeApprovalBridge(enable_persistent_choices=True),
+)
+```
+
 ## Session-owned Graph Rebuilds
 
 If ACP session state should decide which graph gets built, `graph_factory=` is the intended seam:

acpkit-0.9.4/packages/adapters/langchain-acp/VERSION

@@ -0,0 +1 @@
+0.9.4

{acpkit-0.9.2 → acpkit-0.9.4}/packages/adapters/langchain-acp/pyproject.toml

@@ -18,6 +18,7 @@ dependencies = [
     "agent-client-protocol>=0.9.0",
     "langchain>=1.0.0",
     "langgraph>=1.0.0",
+    "pydantic>=2.7",
     "typing-extensions>=4.12.0",
 ]