deft-subspace-acp 0.1.0a1__tar.gz

deft_subspace_acp-0.1.0a1/.gitignore

@@ -0,0 +1,16 @@
+node_modules/
+dist/
+coverage/
+*.tsbuildinfo
+.DS_Store
+.env
+.env.*
+!.env.example
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/
+.ruff_cache/
+
+# A stray self-symlink to the checkout
+/subspace

deft_subspace_acp-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deft_subspace_acp-0.1.0a1/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.5
+Name: deft-subspace-acp
+Version: 0.1.0a1
+Summary: ACP for apps: one model over protocol v1 and v2, turns you can await, cancellation that works, permissions that fail closed. Types come from the official agent-client-protocol SDK.
+Project-URL: Homepage, https://github.com/deftai/subspace/tree/main/python
+Project-URL: Source, https://github.com/deftai/subspace
+Project-URL: Issues, https://github.com/deftai/subspace/issues
+Project-URL: Changelog, https://github.com/deftai/subspace/blob/main/python/CHANGELOG.md
+Author: Deft
+License-Expression: MIT
+License-File: LICENSE
+Keywords: acp,agent-client-protocol,agents,asyncio,llm,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: agent-client-protocol<2,>=1.0
+Requires-Dist: deft-subspace-kernel==0.1.0a1
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.3; extra == 'mcp'
+Provides-Extra: otel
+Requires-Dist: opentelemetry-api>=1.27; extra == 'otel'
+Description-Content-Type: text/markdown
+
+# deft-subspace-acp
+
+[Agent Client Protocol](https://agentclientprotocol.com) (ACP) for Python apps, for both clients and agents. Part of [Deft Subspace](https://github.com/deftai/subspace/tree/main/python).
+
+- **One model for v1 and v2.** The client asks for v2 and accepts v1, and your code sees the same events either way.
+- **Turns you can await:** `async for event in turn`, and `await turn` for the result.
+- **Cancellation that works**, and **permissions that fail closed.**
+- **Tested against real agents:** Grok Build, the Claude and Codex ACP adapters, and agents built with the official SDK.
+
+```python
+import asyncio
+from deft_subspace.acp import run
+
+async def main():
+    result = await run("claude", "What does this repo do?", permissions="reject")
+    print(result.text)
+
+asyncio.run(main())
+```
+
+Extras: `otel` (OpenTelemetry spans) and `mcp` (MCP servers over http and sse).
+
+See the [README](https://github.com/deftai/subspace/tree/main/python) for clients, agents, and how this differs from the TypeScript packages. MIT licensed.

deft_subspace_acp-0.1.0a1/README.md

@@ -0,0 +1,23 @@
+# deft-subspace-acp
+
+[Agent Client Protocol](https://agentclientprotocol.com) (ACP) for Python apps, for both clients and agents. Part of [Deft Subspace](https://github.com/deftai/subspace/tree/main/python).
+
+- **One model for v1 and v2.** The client asks for v2 and accepts v1, and your code sees the same events either way.
+- **Turns you can await:** `async for event in turn`, and `await turn` for the result.
+- **Cancellation that works**, and **permissions that fail closed.**
+- **Tested against real agents:** Grok Build, the Claude and Codex ACP adapters, and agents built with the official SDK.
+
+```python
+import asyncio
+from deft_subspace.acp import run
+
+async def main():
+    result = await run("claude", "What does this repo do?", permissions="reject")
+    print(result.text)
+
+asyncio.run(main())
+```
+
+Extras: `otel` (OpenTelemetry spans) and `mcp` (MCP servers over http and sse).
+
+See the [README](https://github.com/deftai/subspace/tree/main/python) for clients, agents, and how this differs from the TypeScript packages. MIT licensed.

deft_subspace_acp-0.1.0a1/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "deft-subspace-acp"
+version = "0.1.0a1"
+description = "ACP for apps: one model over protocol v1 and v2, turns you can await, cancellation that works, permissions that fail closed. Types come from the official agent-client-protocol SDK."
+keywords = ["agent-client-protocol", "acp", "agents", "llm", "asyncio", "mcp"]
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Deft" }]
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+# The kernel is released with acp, at the same version.
+dependencies = ["deft-subspace-kernel==0.1.0a1", "agent-client-protocol>=1.0,<2"]
+
+[project.urls]
+Homepage = "https://github.com/deftai/subspace/tree/main/python"
+Source = "https://github.com/deftai/subspace"
+Issues = "https://github.com/deftai/subspace/issues"
+Changelog = "https://github.com/deftai/subspace/blob/main/python/CHANGELOG.md"
+
+[project.optional-dependencies]
+otel = ["opentelemetry-api>=1.27"]
+mcp = ["mcp>=2.3,<3"]
+
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/deft_subspace"]

deft_subspace_acp-0.1.0a1/src/deft_subspace/acp/__init__.py

@@ -0,0 +1,535 @@
+"""ACP for apps: one model over protocol v1 and v2, turns you can await, cancellation that works,
+permissions that fail closed. Both sides: `AcpClient` (and `start()`) for clients, `serve_agent`
+(and `serve_stdio()`) for agents.
+
+    from deft_subspace.acp import start
+
+    agent = await start("claude", on_permission=lambda r, _s: "allow" if r.tool_call and r.tool_call.kind == "read" else "reject")
+    try:
+        await agent.run("What does this repo do?", on_message=lambda delta, info, _e: print(info.separator + delta, end=""))
+    finally:
+        await agent.close()
+
+Where to start (everything is imported from `deft_subspace.acp`):
+
+- Run an agent: `start()`, `run()`, `StartedAgent`; blocking: `deft_subspace.acp.sync.run()`.
+- Client: `AcpClient`, `Session`, `Turn`, `TurnResult`, `TurnHandlers`; events: `TurnEvent`,
+  `MessageEvent`, `ToolCallEvent`, `PermissionEvent`.
+- Permissions: `allow`, `reject`, `read_only`, `allow_inside`, `first_of`, `PermissionRequest`.
+- Agents: `serve_stdio()`, `serve_agent()`, `AgentTurn`, `tool()`, `model_agent()`.
+- Agent names: `list_agents()`, `load_catalog()`.
+- MCP: `mcp_connector()`, `StdioMcpServer`, `HttpMcpServer`.
+- Errors: every exception class is a `deft_subspace.kernel.SubspaceError`.
+
+The official SDK's pydantic schemas are `v1` and `v2` (loaded on first use).
+"""
+
+from typing import TYPE_CHECKING, Any
+
+from ._conveniences import (
+    JsonAnswerError,
+    SessionConveniences,
+    conveniences,
+    find_json,
+)
+from ._mcp_connector import (
+    mcp_connector,
+)
+from ._model_agent import (
+    ConversationSetup,
+    ModelAdapter,
+    ModelConversation,
+    ModelInput,
+    ModelPromptInput,
+    ModelReply,
+    ModelStream,
+    ModelTool,
+    ModelToolCall,
+    ToolResult,
+    ToolResultsInput,
+    model_agent,
+)
+from ._start import (
+    AgentCommand,
+    StartedAgent,
+    agent_by_name,
+    run,
+    serve_stdio,
+    start,
+)
+from .agent import (
+    AgentTurn,
+    ElicitAnswer,
+    LoadSessionRequest,
+    NewSessionRequest,
+    PermissionAnswer,
+    PermissionDenied,
+    ReplayWriter,
+    TerminalDisplay,
+    TerminalHandle,
+    ToolCallHandle,
+    serve_agent,
+)
+from .agents import (
+    BUILTIN_AGENTS,
+    AgentCatalog,
+    AgentDefinition,
+    CatalogLayer,
+    Quirk,
+    ResolvedAgent,
+    builtin_catalog,
+    list_agents,
+    resolve_agent,
+)
+from .auth import (
+    AuthMethod,
+)
+from .capabilities import (
+    AgentSupport,
+    CapabilityError,
+    ClientSupport,
+    agent_support,
+    client_support,
+)
+from .catalog import (
+    AgentFileError,
+    agent_files,
+    load_catalog,
+    load_catalog_async,
+    load_registry,
+    parse_agent_file,
+    parse_agent_table,
+    refresh_registry,
+    registry_cache_path,
+)
+from .client import (
+    AcpClient,
+    AgentInfo,
+    ElicitationRequest,
+    FileHandlers,
+    Session,
+    SessionInfo,
+    SessionSummary,
+    TerminalHandlers,
+    Timeouts,
+    prompt_blocks,
+)
+from .config import (
+    BooleanConfigOption,
+    ConfigChoice,
+    OtherConfigOption,
+    SelectConfigOption,
+    config_options_from,
+)
+from .content import (
+    file,
+    image,
+)
+from .elicitation import (
+    validate_elicitation,
+)
+from .endpoint import (
+    AgentEndpoint,
+    AgentLayer,
+    CallContext,
+    EndpointCall,
+    EndpointClient,
+    EndpointContext,
+    StateKey,
+    agent_endpoint,
+    state_key,
+)
+from .extensions import (
+    ExtensionHandler,
+    ExtensionNotification,
+    ExtensionRequest,
+    extension_notification,
+    extension_request,
+    handle,
+)
+from .handlers import (
+    TextEndInfo,
+    TextInfo,
+    ToolCallInfo,
+    TurnHandlers,
+)
+from .install import (
+    Installed,
+    InstallError,
+    binaries_path,
+    install_agent,
+    installed_binaries,
+)
+from .mcp import (
+    MCP_PROTOCOL_VERSION,
+    AcpMcpServer,
+    HttpMcpServer,
+    McpBindingError,
+    McpOperationContext,
+    McpRegistration,
+    SseMcpServer,
+    StdioMcpServer,
+    mcp_servers_param,
+    parse_mcp_servers,
+)
+from .mcp_caller import (
+    McpCaller,
+    McpCallOptions,
+    McpError,
+    McpServerClient,
+    server_client,
+)
+from .mcp_connections import (
+    McpConnectContext,
+    McpConnection,
+    McpConnector,
+)
+from .model import (
+    BackgroundItem,
+    ContentBlock,
+    ExhaustedEvent,
+    Exhaustion,
+    MessageEndEvent,
+    MessageEvent,
+    OtherWork,
+    PermissionCommand,
+    PermissionEvent,
+    PermissionOption,
+    PermissionOutcome,
+    PermissionRequest,
+    PlanEntry,
+    PlanEvent,
+    ProtocolVersion,
+    SessionInfoEvent,
+    StateEvent,
+    StopReason,
+    SubagentWork,
+    TerminalEvent,
+    TerminalWork,
+    ThoughtEndEvent,
+    ThoughtEvent,
+    ToolCall,
+    ToolCallContent,
+    ToolCallEvent,
+    ToolCallStatus,
+    ToolCallWork,
+    TurnEnd,
+    TurnEvent,
+    TurnLimits,
+    TurnResult,
+    UpdateEvent,
+    UsageEvent,
+    UserMessageEndEvent,
+    UserMessageEvent,
+    turn_end,
+)
+from .modes import (
+    SessionMode,
+    SessionModes,
+    modes_from,
+)
+from .node import (
+    ConnectedAgent,
+    WorkspaceFiles,
+    WorkspaceTerminals,
+    connect_agent,
+    inside_workspace,
+    workspace_files,
+    workspace_terminals,
+)
+from .open import (
+    ConnectedSession,
+    OpenedSession,
+    connect_session,
+    open_session,
+)
+from .permissions import (
+    OptionId,
+    PermissionDecision,
+    PermissionHandler,
+    PermissionPolicy,
+    decide,
+    resolve_decision,
+)
+from .policies import (
+    READ_KINDS,
+    PermissionRule,
+    allow,
+    allow_inside,
+    first_of,
+    inside,
+    read_only,
+    reject,
+    request_command,
+    request_paths,
+)
+from .projection import (
+    TurnProjection,
+)
+from .registry import (
+    REGISTRY_URL,
+    Registry,
+    RegistryAgent,
+    registry_target,
+    trim_registry,
+)
+from .telemetry import (
+    OtelTap,
+    otel_tap,
+    spans_from_trace,
+)
+from .terminal_ui import (
+    ask_in_terminal,
+    terminal,
+)
+from .terminals import (
+    TerminalExit,
+    Terminals,
+    TerminalSize,
+    TerminalState,
+    terminal_text,
+)
+from .tools import (
+    ToolContext,
+    ToolDefinition,
+    ToolSet,
+    check_tool_input,
+    tool,
+    tool_input_schema,
+    tool_output_text,
+)
+from .turn import (
+    Turn,
+    TurnHistory,
+)
+
+if TYPE_CHECKING:
+    from acp import schema as v1
+    from acp.experimental.v2 import schema as v2
+
+
+if not TYPE_CHECKING:
+    # Hidden from type checkers, which see `v1` and `v2` above: a module `__getattr__` makes them
+    # accept any name imported from the package, typos included.
+    def __getattr__(name: str) -> Any:
+        if name in ("v1", "v2"):
+            from . import model
+
+            return getattr(model, name)
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    "ConversationSetup",
+    "ModelInput",
+    "ModelPromptInput",
+    "ToolResultsInput",
+    "AcpClient",
+    "AcpMcpServer",
+    "AgentCatalog",
+    "AgentCommand",
+    "AgentDefinition",
+    "AgentEndpoint",
+    "AgentFileError",
+    "AgentInfo",
+    "AgentLayer",
+    "AgentSupport",
+    "AgentTurn",
+    "AuthMethod",
+    "BUILTIN_AGENTS",
+    "BackgroundItem",
+    "BooleanConfigOption",
+    "CallContext",
+    "CapabilityError",
+    "CatalogLayer",
+    "ClientSupport",
+    "ConfigChoice",
+    "ConnectedAgent",
+    "ConnectedSession",
+    "ContentBlock",
+    "ElicitAnswer",
+    "ElicitationRequest",
+    "EndpointCall",
+    "EndpointClient",
+    "EndpointContext",
+    "ExhaustedEvent",
+    "Exhaustion",
+    "ExtensionHandler",
+    "ExtensionNotification",
+    "ExtensionRequest",
+    "FileHandlers",
+    "HttpMcpServer",
+    "InstallError",
+    "Installed",
+    "JsonAnswerError",
+    "LoadSessionRequest",
+    "MCP_PROTOCOL_VERSION",
+    "McpBindingError",
+    "McpCallOptions",
+    "McpCaller",
+    "McpConnectContext",
+    "McpConnection",
+    "McpConnector",
+    "McpError",
+    "McpOperationContext",
+    "McpRegistration",
+    "McpServerClient",
+    "MessageEndEvent",
+    "MessageEvent",
+    "ModelAdapter",
+    "ModelConversation",
+    "ModelReply",
+    "ModelStream",
+    "ModelTool",
+    "ModelToolCall",
+    "NewSessionRequest",
+    "OpenedSession",
+    "OptionId",
+    "OtelTap",
+    "OtherConfigOption",
+    "OtherWork",
+    "PermissionAnswer",
+    "PermissionCommand",
+    "PermissionDecision",
+    "PermissionDenied",
+    "PermissionEvent",
+    "PermissionHandler",
+    "PermissionOption",
+    "PermissionOutcome",
+    "PermissionPolicy",
+    "PermissionRequest",
+    "PermissionRule",
+    "PlanEntry",
+    "PlanEvent",
+    "ProtocolVersion",
+    "Quirk",
+    "READ_KINDS",
+    "REGISTRY_URL",
+    "Registry",
+    "RegistryAgent",
+    "ReplayWriter",
+    "ResolvedAgent",
+    "SelectConfigOption",
+    "Session",
+    "SessionConveniences",
+    "SessionInfo",
+    "SessionInfoEvent",
+    "SessionMode",
+    "SessionModes",
+    "SessionSummary",
+    "SseMcpServer",
+    "StartedAgent",
+    "StateEvent",
+    "StateKey",
+    "StdioMcpServer",
+    "StopReason",
+    "SubagentWork",
+    "TerminalDisplay",
+    "TerminalEvent",
+    "TerminalExit",
+    "TerminalHandle",
+    "TerminalHandlers",
+    "TerminalSize",
+    "TerminalState",
+    "TerminalWork",
+    "Terminals",
+    "TextEndInfo",
+    "TextInfo",
+    "ThoughtEndEvent",
+    "ThoughtEvent",
+    "Timeouts",
+    "ToolCall",
+    "ToolCallContent",
+    "ToolCallEvent",
+    "ToolCallHandle",
+    "ToolCallInfo",
+    "ToolCallStatus",
+    "ToolCallWork",
+    "ToolContext",
+    "ToolDefinition",
+    "ToolResult",
+    "ToolSet",
+    "Turn",
+    "TurnHistory",
+    "TurnEnd",
+    "TurnEvent",
+    "TurnHandlers",
+    "TurnLimits",
+    "TurnProjection",
+    "TurnResult",
+    "UpdateEvent",
+    "UsageEvent",
+    "UserMessageEndEvent",
+    "UserMessageEvent",
+    "WorkspaceFiles",
+    "WorkspaceTerminals",
+    "agent_by_name",
+    "agent_endpoint",
+    "agent_files",
+    "agent_support",
+    "allow",
+    "allow_inside",
+    "ask_in_terminal",
+    "binaries_path",
+    "builtin_catalog",
+    "check_tool_input",
+    "client_support",
+    "config_options_from",
+    "connect_agent",
+    "connect_session",
+    "conveniences",
+    "decide",
+    "extension_notification",
+    "extension_request",
+    "file",
+    "find_json",
+    "first_of",
+    "handle",
+    "image",
+    "inside",
+    "inside_workspace",
+    "install_agent",
+    "installed_binaries",
+    "list_agents",
+    "load_catalog",
+    "load_catalog_async",
+    "load_registry",
+    "mcp_connector",
+    "mcp_servers_param",
+    "model_agent",
+    "modes_from",
+    "open_session",
+    "otel_tap",
+    "parse_agent_file",
+    "parse_agent_table",
+    "parse_mcp_servers",
+    "prompt_blocks",
+    "read_only",
+    "refresh_registry",
+    "registry_cache_path",
+    "registry_target",
+    "reject",
+    "request_command",
+    "request_paths",
+    "resolve_agent",
+    "resolve_decision",
+    "run",
+    "serve_agent",
+    "serve_stdio",
+    "server_client",
+    "spans_from_trace",
+    "start",
+    "state_key",
+    "terminal",
+    "terminal_text",
+    "tool",
+    "tool_input_schema",
+    "tool_output_text",
+    "trim_registry",
+    "turn_end",
+    "v1",
+    "v2",
+    "validate_elicitation",
+    "workspace_files",
+    "workspace_terminals",
+]