acp-sdk 0.0.6__py3-none-any.whl → 1.0.0rc1__py3-none-any.whl

acp_sdk/server/telemetry.py

@@ -0,0 +1,45 @@
+import logging
+from importlib.metadata import version
+
+from opentelemetry import trace
+from opentelemetry.sdk.resources import (
+    Resource,
+    SERVICE_NAME,
+    SERVICE_NAMESPACE,
+    SERVICE_VERSION,
+)
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor, SpanExportResult
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+
+logger = logging.getLogger("uvicorn.error")
+
+
+class SilentOTLPSpanExporter(OTLPSpanExporter):
+    def export(self, spans):
+        try:
+            return super().export(spans)
+        except Exception as e:
+            logger.warning(f"OpenTelemetry Exporter failed silently: {e}")
+            return SpanExportResult.FAILURE
+
+
+def configure_telemetry():
+    current_provider = trace.get_tracer_provider()
+
+    # Detect default provider and override
+    if isinstance(current_provider, trace.ProxyTracerProvider):
+        provider = TracerProvider(
+            resource=Resource(
+                attributes={
+                    SERVICE_NAME: "acp-server",
+                    SERVICE_NAMESPACE: "acp",
+                    SERVICE_VERSION: version("acp-sdk"),
+                }
+            )
+        )
+
+        processor = BatchSpanProcessor(SilentOTLPSpanExporter())
+        provider.add_span_processor(processor)
+
+        trace.set_tracer_provider(provider)

acp_sdk/server/utils.py

@@ -0,0 +1,12 @@
+from pydantic import BaseModel
+
+from acp_sdk.server.bundle import RunBundle
+
+
+def encode_sse(model: BaseModel):
+    return f"data: {model.model_dump_json()}\n\n"
+
+
+async def stream_sse(bundle: RunBundle):
+    async for event in bundle.stream():
+        yield encode_sse(event)

acp_sdk-1.0.0rc1.dist-info/METADATA

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: acp-sdk
+Version: 1.0.0rc1
+Summary: Agent Communication Protocol SDK
+Requires-Python: <4.0,>=3.13
+Requires-Dist: opentelemetry-api>=1.31.1
+Requires-Dist: pydantic>=2.11.1
+Provides-Extra: client
+Requires-Dist: httpx-sse>=0.4.0; extra == 'client'
+Requires-Dist: httpx>=0.28.1; extra == 'client'
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.52b1; extra == 'client'
+Provides-Extra: server
+Requires-Dist: fastapi[standard]>=0.115.8; extra == 'server'
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.31.1; extra == 'server'
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.52b1; extra == 'server'
+Requires-Dist: opentelemetry-sdk>=1.31.1; extra == 'server'
+Description-Content-Type: text/markdown
+
+# Agent Communication Protocol SDK for Python
+
+## Prerequisites
+
+✅ Python >= 3.13
+
+## Installation
+
+Install using pip:
+
+```shell
+pip install acp-sdk
+```
+
+## Example
+
+The SDK can be used to implement both clients and servers.
+
+### Server
+
+To run an example server use [FastAPI CLI](https://fastapi.tiangolo.com/fastapi-cli/) or other [deployment strategies](https://fastapi.tiangolo.com/deployment/):
+
+```shell
+fastapi dev examples/servers/echo.py
+```
+
+### Client
+
+To run an example client:
+
+```shell
+python examples/clients/simple.py
+```
+
+➡️ Explore more in our [examples library](/python/examples).

acp_sdk-1.0.0rc1.dist-info/RECORD

@@ -0,0 +1,15 @@
+acp_sdk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+acp_sdk/models.py,sha256=0B_jdMxM7sYO9USTZzM1hvCS-qsO6lUKfqLTpGdkRQQ,4315
+acp_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+acp_sdk/client/__init__.py,sha256=h3uraY7H5vbtiz5i3N9kIpjF_bu7Nor6LJu_li-aiVc,41
+acp_sdk/client/client.py,sha256=EDcV6DhnDFJF58zAyzi4cgoNkb3znMSw7dZkiN7KKbY,4557
+acp_sdk/server/__init__.py,sha256=2bgh6BqT6I0w9GmN8GWdHa52HL64ZpbcICbxKZbInNY,84
+acp_sdk/server/agent.py,sha256=G3gmUDzb_msK0w4EuUe8hTbZRFCb8xy-bqpVFIAx9sU,687
+acp_sdk/server/bundle.py,sha256=cZmd39uYkykKOyQpVcXHtH_-N2y9PJX9jWEvO9bzlA8,4841
+acp_sdk/server/context.py,sha256=h8SY0-1DMHAMluOMni981EXXM2kAuBQcqrofK-qyi4s,155
+acp_sdk/server/server.py,sha256=dUZ-aDsNzSHnEeY3vOtbixrgr86JT2JUkTue6_9IVak,4443
+acp_sdk/server/telemetry.py,sha256=ZxiZUJm9PuZoc6rIl0MvaQkzIX3E4ENiwsxxqDZtfRo,1383
+acp_sdk/server/utils.py,sha256=VoqEZ1fZ7_NYSKmDIwBz2UwSL17NKTZ5k760ALgimE4,277
+acp_sdk-1.0.0rc1.dist-info/METADATA,sha256=0ddoScvUqT8HuRpVgBFNdtxQt8gxzyMU7ujyimZ5s1c,1350
+acp_sdk-1.0.0rc1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+acp_sdk-1.0.0rc1.dist-info/RECORD,,

acp/__init__.py

@@ -1,138 +0,0 @@
-from .client.session import ClientSession
-from .client.stdio import StdioServerParameters, stdio_client
-from .server.session import ServerSession
-from .server.stdio import stdio_server
-from .shared.exceptions import McpError
-from .types import (
-    Agent,
-    AgentTemplate,
-    CallToolRequest,
-    ClientCapabilities,
-    ClientNotification,
-    ClientRequest,
-    ClientResult,
-    CompleteRequest,
-    CreateAgentRequest,
-    CreateAgentResult,
-    CreateMessageRequest,
-    CreateMessageResult,
-    DestroyAgentRequest,
-    DestroyAgentResult,
-    ErrorData,
-    GetPromptRequest,
-    GetPromptResult,
-    Implementation,
-    IncludeContext,
-    InitializedNotification,
-    InitializeRequest,
-    InitializeResult,
-    JSONRPCError,
-    JSONRPCRequest,
-    JSONRPCResponse,
-    ListAgentsRequest,
-    ListAgentsResult,
-    ListAgentTemplatesRequest,
-    ListAgentTemplatesResult,
-    ListPromptsRequest,
-    ListPromptsResult,
-    ListResourcesRequest,
-    ListResourcesResult,
-    ListToolsResult,
-    LoggingLevel,
-    LoggingMessageNotification,
-    Notification,
-    PingRequest,
-    ProgressNotification,
-    PromptsCapability,
-    ReadResourceRequest,
-    ReadResourceResult,
-    Resource,
-    ResourcesCapability,
-    ResourceUpdatedNotification,
-    RootsCapability,
-    RunAgentRequest,
-    RunAgentResult,
-    SamplingMessage,
-    ServerCapabilities,
-    ServerNotification,
-    ServerRequest,
-    ServerResult,
-    SetLevelRequest,
-    StopReason,
-    SubscribeRequest,
-    Tool,
-    ToolsCapability,
-    UnsubscribeRequest,
-)
-from .types import (
-    Role as SamplingRole,
-)
-
-__all__ = [
-    "CallToolRequest",
-    "ClientCapabilities",
-    "ClientNotification",
-    "ClientRequest",
-    "ClientResult",
-    "ClientSession",
-    "CreateMessageRequest",
-    "CreateMessageResult",
-    "ErrorData",
-    "GetPromptRequest",
-    "GetPromptResult",
-    "Implementation",
-    "IncludeContext",
-    "InitializeRequest",
-    "InitializeResult",
-    "InitializedNotification",
-    "JSONRPCError",
-    "JSONRPCRequest",
-    "ListPromptsRequest",
-    "ListPromptsResult",
-    "ListResourcesRequest",
-    "ListResourcesResult",
-    "ListToolsResult",
-    "LoggingLevel",
-    "LoggingMessageNotification",
-    "McpError",
-    "Notification",
-    "PingRequest",
-    "ProgressNotification",
-    "PromptsCapability",
-    "ReadResourceRequest",
-    "ReadResourceResult",
-    "ResourcesCapability",
-    "ResourceUpdatedNotification",
-    "Resource",
-    "RootsCapability",
-    "SamplingMessage",
-    "SamplingRole",
-    "ServerCapabilities",
-    "ServerNotification",
-    "ServerRequest",
-    "ServerResult",
-    "ServerSession",
-    "SetLevelRequest",
-    "StdioServerParameters",
-    "StopReason",
-    "SubscribeRequest",
-    "Tool",
-    "ToolsCapability",
-    "UnsubscribeRequest",
-    "stdio_client",
-    "stdio_server",
-    "CompleteRequest",
-    "JSONRPCResponse",
-    "AgentTemplate",
-    "ListAgentTemplatesRequest",
-    "ListAgentTemplatesResult",
-    "Agent",
-    "ListAgentsRequest",
-    "ListAgentsResult",
-    "CreateAgentRequest",
-    "CreateAgentResult",
-    "DestroyAgentRequest",
-    "DestroyAgentResult",
-    "RunAgentRequest",
-    "RunAgentResult",
-]

acp/cli/__init__.py

@@ -1,6 +0,0 @@
-"""FastMCP CLI package."""
-
-from .cli import app
-
-if __name__ == "__main__":
-    app()

acp/cli/claude.py

@@ -1,139 +0,0 @@
-"""Claude app integration utilities."""
-
-import json
-import sys
-from pathlib import Path
-
-from acp.server.highlevel.utilities.logging import get_logger
-
-logger = get_logger(__name__)
-
-MCP_PACKAGE = "acp[cli]"
-
-
-def get_claude_config_path() -> Path | None:
-    """Get the Claude config directory based on platform."""
-    if sys.platform == "win32":
-        path = Path(Path.home(), "AppData", "Roaming", "Claude")
-    elif sys.platform == "darwin":
-        path = Path(Path.home(), "Library", "Application Support", "Claude")
-    else:
-        return None
-
-    if path.exists():
-        return path
-    return None
-
-
-def update_claude_config(
-    file_spec: str,
-    server_name: str,
-    *,
-    with_editable: Path | None = None,
-    with_packages: list[str] | None = None,
-    env_vars: dict[str, str] | None = None,
-) -> bool:
-    """Add or update a FastMCP server in Claude's configuration.
-
-    Args:
-        file_spec: Path to the server file, optionally with :object suffix
-        server_name: Name for the server in Claude's config
-        with_editable: Optional directory to install in editable mode
-        with_packages: Optional list of additional packages to install
-        env_vars: Optional dictionary of environment variables. These are merged with
-            any existing variables, with new values taking precedence.
-
-    Raises:
-        RuntimeError: If Claude Desktop's config directory is not found, indicating
-            Claude Desktop may not be installed or properly set up.
-    """
-    config_dir = get_claude_config_path()
-    if not config_dir:
-        raise RuntimeError(
-            "Claude Desktop config directory not found. Please ensure Claude Desktop"
-            " is installed and has been run at least once to initialize its config."
-        )
-
-    config_file = config_dir / "claude_desktop_config.json"
-    if not config_file.exists():
-        try:
-            config_file.write_text("{}")
-        except Exception as e:
-            logger.error(
-                "Failed to create Claude config file",
-                extra={
-                    "error": str(e),
-                    "config_file": str(config_file),
-                },
-            )
-            return False
-
-    try:
-        config = json.loads(config_file.read_text())
-        if "mcpServers" not in config:
-            config["mcpServers"] = {}
-
-        # Always preserve existing env vars and merge with new ones
-        if (
-            server_name in config["mcpServers"]
-            and "env" in config["mcpServers"][server_name]
-        ):
-            existing_env = config["mcpServers"][server_name]["env"]
-            if env_vars:
-                # New vars take precedence over existing ones
-                env_vars = {**existing_env, **env_vars}
-            else:
-                env_vars = existing_env
-
-        # Build uv run command
-        args = ["run"]
-
-        # Collect all packages in a set to deduplicate
-        packages = {MCP_PACKAGE}
-        if with_packages:
-            packages.update(pkg for pkg in with_packages if pkg)
-
-        # Add all packages with --with
-        for pkg in sorted(packages):
-            args.extend(["--with", pkg])
-
-        if with_editable:
-            args.extend(["--with-editable", str(with_editable)])
-
-        # Convert file path to absolute before adding to command
-        # Split off any :object suffix first
-        if ":" in file_spec:
-            file_path, server_object = file_spec.rsplit(":", 1)
-            file_spec = f"{Path(file_path).resolve()}:{server_object}"
-        else:
-            file_spec = str(Path(file_spec).resolve())
-
-        # Add fastmcp run command
-        args.extend(["acp", "run", file_spec])
-
-        server_config = {
-            "command": "uv",
-            "args": args,
-        }
-
-        # Add environment variables if specified
-        if env_vars:
-            server_config["env"] = env_vars
-
-        config["mcpServers"][server_name] = server_config
-
-        config_file.write_text(json.dumps(config, indent=2))
-        logger.info(
-            f"Added server '{server_name}' to Claude config",
-            extra={"config_file": str(config_file)},
-        )
-        return True
-    except Exception as e:
-        logger.error(
-            "Failed to update Claude config",
-            extra={
-                "error": str(e),
-                "config_file": str(config_file),
-            },
-        )
-        return False