acp-sdk 0.3.2__tar.gz → 0.4.0__tar.gz

acp_sdk-0.4.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: acp-sdk
+Version: 0.4.0
+Summary: Agent Communication Protocol SDK
+Author: IBM Corp.
+Maintainer-email: Tomas Pilar <thomas7pilar@gmail.com>
+License-Expression: Apache-2.0
+Requires-Python: <4.0,>=3.11
+Requires-Dist: fastapi[standard]>=0.115.8
+Requires-Dist: httpx-sse>=0.4.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: janus>=2.0.0
+Requires-Dist: opentelemetry-api>=1.31.1
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.31.1
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.52b1
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.52b1
+Requires-Dist: opentelemetry-sdk>=1.31.1
+Requires-Dist: pydantic>=2.11.1
+Description-Content-Type: text/markdown
+
+# Agent Communication Protocol SDK for Python
+
+Agent Communication Protocol SDK for Python provides allows developers to serve and consume agents over the Agent Communication Protocol.
+
+## Prerequisites
+
+✅ Python >= 3.11
+
+## Installation
+
+Install with:
+
+```shell
+pip install acp-sdk
+```
+
+## Quickstart
+
+Register an agent and run the server:
+
+```py
+server = Server()
+
+@server.agent()
+async def echo(inputs: list[Message]):
+    """Echoes everything"""
+    for message in inputs:
+        yield message
+
+server.run(port=8000)
+```
+
+From another process, connect to the server and run the agent:
+
+```py
+async with Client(base_url="http://localhost:8000") as client:
+    run = await client.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])])
+    print(run)
+
+```
+
+
+➡️ Explore more in our [examples library](/examples/python).

acp_sdk-0.4.0/README.md

@@ -0,0 +1,43 @@
+# Agent Communication Protocol SDK for Python
+
+Agent Communication Protocol SDK for Python provides allows developers to serve and consume agents over the Agent Communication Protocol.
+
+## Prerequisites
+
+✅ Python >= 3.11
+
+## Installation
+
+Install with:
+
+```shell
+pip install acp-sdk
+```
+
+## Quickstart
+
+Register an agent and run the server:
+
+```py
+server = Server()
+
+@server.agent()
+async def echo(inputs: list[Message]):
+    """Echoes everything"""
+    for message in inputs:
+        yield message
+
+server.run(port=8000)
+```
+
+From another process, connect to the server and run the agent:
+
+```py
+async with Client(base_url="http://localhost:8000") as client:
+    run = await client.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])])
+    print(run)
+
+```
+
+
+➡️ Explore more in our [examples library](/examples/python).

acp_sdk-0.4.0/docs/_sidebar.md

@@ -0,0 +1,7 @@
+- [Python](/python/)
+
+- Modules
+
+  - [Client](client.md)
+  - [Server](server.md)
+  - [Models](models.md)

acp_sdk-0.4.0/docs/client.md

@@ -0,0 +1,99 @@
+# Client
+
+<!-- TOC -->
+## Table of Contents
+- [Client](#client)
+  - [Table of Contents](#table-of-contents)
+  - [Overview](#overview)
+  - [Usage](#usage)
+    - [Setting up a client](#setting-up-a-client)
+    - [Performing discovery](#performing-discovery)
+    - [Running an agent](#running-an-agent)
+    - [Using sessions](#using-sessions)
+<!-- /TOC -->
+
+---
+
+## Overview
+
+The client module provides a thin ACP client that can be integrated into any application that needs to communicate with ACP agents. It provides the following advantages over raw HTTP client:
+
+- Strong typing
+- Error handling
+- Stream decoding
+- Session management
+- Instrumentation
+
+> [!NOTE]
+>
+> Location within the sdk: [client](/python/src/acp_sdk/client)
+
+## Usage
+
+The client is based on the [httpx.AsyncClient](https://www.python-httpx.org/async/). The usage is very similar as demonstrated below.
+
+### Setting up a client
+
+To set up a simple client, simply provide an URL:
+
+```py
+async with Client(base_url="http://localhost:8000") as client:
+  ...
+```
+
+To use advanced HTTP configuration, provide `httpx` async client:
+
+```py
+async with Client(
+  client=httpx.AsyncClient(
+    base_url="http://localhost:8000",
+    headers={"token": "foobar"})
+  ) as client:
+  ...
+```
+
+### Performing discovery
+
+To discover available agents:
+
+```py
+async with Client(base_url="http://localhost:8000") as client:
+  async for agent in client.agents():
+    ...
+```
+
+### Running an agent
+
+Agent run can be invoked in three modes:
+
+```py
+async with Client(base_url="http://localhost:8000") as client:
+  message = Message(parts=[MessagePart(content="Hello")])
+
+  # Async
+  run = await client.run_async(agent_name="agent", inputs=[message])
+  print(run.status)
+
+  # Sync - waits for completion, failure, cancellation or await
+  run = await client.run_sync(agent_name="agent", inputs=[message])
+  print(run.outputs)
+  
+  # Stream - as sync but also receives events
+  async for event in client.run_stream(agent_name="agent", inputs=[message])
+    print(event)
+```
+
+### Using sessions
+
+Sessions are a mechanism to have multi-turn conversations with agents.
+
+To enter a session, create one from the client:
+
+```py
+async with Client(base_url="http://localhost:8000" as client:
+    agents = [agent async for agent in client.agents()]
+
+    async with client.session() as session:
+        for agent in agents:
+            await session.run_sync(agent_name=agent.name, inputs=[Message(parts=[MessagePart(content="Hello!")])])
+```

acp_sdk-0.4.0/docs/index.html

@@ -0,0 +1,104 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>ACP Docs</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+    <meta name="description" content="Description" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0" />
+    <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@4/lib/themes/vue.css" />
+    <link
+      rel="stylesheet"
+      title="docsify-darklight-theme"
+      href="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/style.min.css"
+    />
+    <style>
+      aside.sidebar {
+        padding-top: 0;
+      }
+      .app-name-link img {
+        filter: invert(var(--docs-logo-color-invert));
+      }
+    </style>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script>
+      function fixLinkFactory() {
+        var main = "https://github.com/i-am-bee/acp/tree/main";
+        var exampleRegex = /^[\/]{0,1}examples\/(.*)/;
+        var srcRegex = /^[\/]{0,1}src\/(.*)/;
+        var docsMatch = /^[\/]{0,1}docs\/(.*)/;
+
+        return function (url) {
+          if (url === "LICENSE") {
+            return main.concat("/LICENSE");
+          }
+          if (url.substring(0, 2) === "./") {
+            url = url.substring(2);
+          }
+          if (url.match(docsMatch)) {
+            url = url.replace(docsMatch, "$1");
+          }
+          if (url.match(exampleRegex) || url.match(srcRegex) || url === "/package.json") {
+            url = main.concat(url);
+          }
+          return url;
+        };
+      }
+
+      var fixLink = fixLinkFactory();
+      var basePath = window.location.pathname.replace(/index.html/gi, "").replace("/#/", "") || "/";
+
+      window.$docsify = {
+        "name": "ACP",
+        "basePath": basePath,
+        "darklightTheme": {
+          "defaultTheme": 'dark',
+          "light": {
+            'docs-logo-color-invert': 0,
+          },
+          "dark": {
+            'docs-logo-color-invert': 1,
+          }
+        },
+        "repo": "i-am-bee/acp",
+        "loadSidebar": true,
+        "subMaxLevel": 2,
+        "auto2top": true,
+        "search": {
+          depth: 6,
+          namespace: "acp",
+        },
+        "flexible-alerts": {
+          important: {
+            label: "Important",
+            icon: "icon-note",
+            className: "note",
+          },
+        },
+        "markdown": {
+          smartypants: true,
+          renderer: {
+            link: function (link, renderer, text) {
+              return this.origin.link.apply(this, [fixLink(link), renderer, text]);
+            },
+            html: function (html) {
+              var regex = /(src|href|srcset)\s*=\s*(['"])[\.]{0,1}\/docs\/(.+?)\2/gi;
+              html = html.replace(regex, "$1=$2" + basePath + "$3$2");
+              return html;
+            },
+          },
+        },
+      };
+    </script>
+    <script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
+    <script src="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/index.min.js"></script>
+    <script src="https://unpkg.com/docsify-plugin-flexible-alerts"></script>
+    <script src="https://unpkg.com/docsify-copy-code@3"></script>
+    <script src="//cdn.jsdelivr.net/npm/prismjs@1/components/prism-bash.min.js"></script>
+    <script src="//cdn.jsdelivr.net/npm/prismjs@1/components/prism-python.min.js"></script>
+    <script src="//cdn.jsdelivr.net/npm/prismjs@1/components/prism-sql.min.js"></script>
+    <script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
+  </body>
+</html>

acp_sdk-0.4.0/docs/models.md

@@ -0,0 +1,45 @@
+# Models
+
+<!-- TOC -->
+## Table of Contents
+- [Models](#models)
+  - [Table of Contents](#table-of-contents)
+  - [Overview](#overview)
+  - [Core](#core)
+  - [Schemas](#schemas)
+  - [Errors](#errors)
+<!-- /TOC -->
+
+---
+
+## Overview
+
+The models module provides `pydantic` models describing ACP data structures.
+
+> [!NOTE]
+>
+> Location within the sdk: [models](/python/src/acp_sdk/models)
+
+## Core
+
+Core models are used directly by the SDK consumers. They describe ACP structures like `Message`, `MessagePart` or `Run`. 
+
+> [!NOTE]
+>
+> Location within the sdk: [models.models](/python/src/acp_sdk/models/models.py)
+
+## Schemas
+
+Schema models are used by client and server implementations. They describe payloads of HTTP requests and responses.
+
+> [!NOTE]
+>
+> Location within the sdk: [models.schemas](/python/src/acp_sdk/models/schemas.py)
+
+## Errors
+
+Error model describes errors within the system. SDK consumers can encounter errors in various places, during a stream, as part of the `Run` model or raised inside the `ACPError` exception.
+
+> [!NOTE]
+>
+> Location within the sdk: [models.errors](/python/src/acp_sdk/models/errors.py)

acp_sdk-0.4.0/docs/server.md

@@ -0,0 +1,103 @@
+# Server
+
+<!-- TOC -->
+## Table of Contents
+- [Server](#server)
+  - [Table of Contents](#table-of-contents)
+  - [Overview](#overview)
+  - [Usage](#usage)
+    - [Running a server](#running-a-server)
+    - [Standalone application](#standalone-application)
+<!-- /TOC -->
+
+---
+
+## Overview
+
+The server module aims to expose arbitrary agents over the Agent Commucation Protocol. Consumers can use this module to avoid protocol-specific technicalities and focus on the agent itself. The modules provides Agent abstractions, FastAPI application factory and Uvicorn-based server.
+
+> [!NOTE]
+>
+> Location within the sdk: [server](/python/src/acp_sdk/server).
+
+## Usage
+
+The SDK provides `Agent` abstract class and `agent` decorator. Arbitrary agent can be created in by either inheritance from the class or by using the decorator on a generator, coroutine or a regular function.
+
+> [!NOTE]
+>
+> Location within the sdk: [server.agent](/python/src/acp_sdk/server/agent.py).
+
+### Running a server
+
+The SDK provides `Server` class as a convenience for developers to easily serve agents over ACP. The server allows to easily create and register agents. It sets up logging and optionally telemetry exporters.
+
+<!-- embedme python/examples/servers/echo.py -->
+
+```py
+import asyncio
+from collections.abc import AsyncGenerator
+
+from acp_sdk.models import (
+    Message,
+)
+from acp_sdk.server import Context, RunYield, RunYieldResume, Server
+
+server = Server()
+
+
+@server.agent()
+async def echo(inputs: list[Message], context: Context) -> AsyncGenerator[RunYield, RunYieldResume]:
+    """Echoes everything"""
+    for message in inputs:
+        await asyncio.sleep(0.5)
+        yield {"thought": "I should echo everything"}
+        await asyncio.sleep(0.5)
+        yield message
+
+
+server.run()
+```
+
+> [!NOTE]
+>
+> Location within the sdk: [server.server](/python/src/acp_sdk/server/server.py).
+
+### Standalone application
+
+The SDK provides `create_app` factory that turns agents into `FastAPI` application. The application implements route handlers, error handlers, unified execution environment and more. The application can be served with arbitrary ASGI compatible server.
+
+<!-- embedme python/examples/servers/standalone.py -->
+
+```py
+from collections.abc import AsyncGenerator
+
+from acp_sdk.models import (
+    Message,
+)
+from acp_sdk.server import RunYield, RunYieldResume, agent, create_app
+
+# This example demonstrates how to serve agents with you own server
+
+
+@agent()
+async def echo(inputs: list[Message]) -> AsyncGenerator[RunYield, RunYieldResume]:
+    """Echoes everything"""
+    for message in inputs:
+        yield message
+
+
+app = create_app(echo)
+
+# The app can now be used with any ASGI server
+
+# Run with
+#   1. fastapi run examples/servers/standalone.py
+#   2. uvicorn examples.servers.standalone:app
+#   ...
+
+```
+
+> [!NOTE]
+>
+> Location within the sdk: [server.app](/python/src/acp_sdk/server/app.py).

{acp_sdk-0.3.2 → acp_sdk-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acp-sdk"
-version = "0.3.2"
+version = "0.4.0"
 description = "Agent Communication Protocol SDK"
 license = "Apache-2.0"
 readme = "README.md"

{acp_sdk-0.3.2 → acp_sdk-0.4.0}/src/acp_sdk/models/models.py

@@ -1,4 +1,5 @@
 import uuid
+from datetime import datetime
 from enum import Enum
 from typing import Any, Literal, Optional, Union
 
@@ -7,11 +8,62 @@ from pydantic import AnyUrl, BaseModel, ConfigDict, Field
 from acp_sdk.models.errors import Error
 
 
-class Metadata(BaseModel):
+class AnyModel(BaseModel):
     model_config = ConfigDict(extra="allow")
 
 
-class AnyModel(BaseModel):
+class Author(BaseModel):
+    name: str
+    email: str | None = None
+    url: AnyUrl | None = None
+
+
+class Contributor(BaseModel):
+    name: str
+    email: str | None = None
+    url: AnyUrl | None = None
+
+
+class LinkType(str, Enum):
+    SOURCE_CODE = "source-code"
+    CONTAINER_IMAGE = "container-image"
+    HOMEPAGE = "homepage"
+    DOCUMENTATION = "documentation"
+
+
+class Link(BaseModel):
+    type: LinkType
+    url: AnyUrl
+
+
+class DependencyType(str, Enum):
+    AGENT = "agent"
+    TOOL = "tool"
+    MODEL = "model"
+
+
+class Dependency(BaseModel):
+    type: DependencyType
+    name: str
+
+
+class Metadata(BaseModel):
+    annotations: AnyModel | None = None
+    documentation: str | None = None
+    license: str | None = None
+    programming_language: str | None = None
+    natural_languages: list[str] | None = None
+    framework: str | None = None
+    use_cases: list[str] | None = None
+    tags: list[str] | None = None
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+    author: Author | None = None
+    contributors: list[Contributor] | None = None
+    links: list[Link] | None = None
+    dependencies: list[Dependency] | None = None
+    recommended_models: list[str] | None = None
+
     model_config = ConfigDict(extra="allow")
 
 

{acp_sdk-0.3.2 → acp_sdk-0.4.0}/src/acp_sdk/server/agent.py

@@ -129,7 +129,7 @@ def agent(
 
             @property
             def description(self) -> str:
-                return description or fn.__doc__ or ""
+                return description or inspect.getdoc(fn) or ""
 
             @property
             def metadata(self) -> Metadata:

{acp_sdk-0.3.2 → acp_sdk-0.4.0}/src/acp_sdk/server/errors.py

@@ -33,7 +33,7 @@ def status_code_to_error_code(status_code: int) -> ErrorCode:
 async def acp_error_handler(request: Request, exc: ACPError, *, status_code: int | None = None) -> JSONResponse:
     error = exc.error
     return JSONResponse(
-        status_code=status_code or error_code_to_status_code(error.code), content=error.model_dump_json()
+        status_code=status_code or error_code_to_status_code(error.code), content=error.model_dump(mode="json")
     )
 
 

acp_sdk-0.3.2/PKG-INFO

@@ -1,99 +0,0 @@
-Metadata-Version: 2.4
-Name: acp-sdk
-Version: 0.3.2
-Summary: Agent Communication Protocol SDK
-Author: IBM Corp.
-Maintainer-email: Tomas Pilar <thomas7pilar@gmail.com>
-License-Expression: Apache-2.0
-Requires-Python: <4.0,>=3.11
-Requires-Dist: fastapi[standard]>=0.115.8
-Requires-Dist: httpx-sse>=0.4.0
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: janus>=2.0.0
-Requires-Dist: opentelemetry-api>=1.31.1
-Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.31.1
-Requires-Dist: opentelemetry-instrumentation-fastapi>=0.52b1
-Requires-Dist: opentelemetry-instrumentation-httpx>=0.52b1
-Requires-Dist: opentelemetry-sdk>=1.31.1
-Requires-Dist: pydantic>=2.11.1
-Description-Content-Type: text/markdown
-
-# Agent Communication Protocol SDK for Python
-
-Agent Communication Protocol SDK for Python provides allows developers to serve and consume agents over the Agent Communication Protocol.
-
-## Prerequisites
-
-✅ Python >= 3.11
-
-## Installation
-
-Install with:
-
-```shell
-pip install acp-sdk
-```
-
-## Overview
-
-### Core
-
-The core of the SDK exposes [pydantic](https://docs.pydantic.dev/) data models corresponding to REST API requests, responses, resources, events and errors.
-
-
-### Client
-
-The `client` submodule exposes [httpx](https://www.python-httpx.org/) based client with simple methods for communication over ACP.
-
-```python
-async with Client(base_url="http://localhost:8000") as client:
-    run = await client.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])])
-    print(run)
-
-```
-
-### Server
-
-The `server` submodule exposes `Agent` class and `agent` decorator together with [fastapi](https://fastapi.tiangolo.com/) application factory, making it easy to expose agents over ACP. Additionaly, it exposes [uvicorn](https://www.uvicorn.org/) based server to serve agents with set up logging, [opentelemetry](https://opentelemetry.io/) and more.
-
-```python
-server = Server()
-
-@server.agent()
-async def echo(inputs: list[Message], context: Context) -> AsyncGenerator[RunYield, RunYieldResume]:
-    """Echoes everything"""
-    for message in inputs:
-        yield {"thought": "I should echo everyting"}
-        await asyncio.sleep(0.5)
-        yield message
-
-
-server.run()
-```
-
-➡️ Explore more in our [examples library](/python/examples).
-
-## Architecture
-
-The architecture of the SDK is outlined in the following segment. It focuses on central parts of the SDK without going into much detail.
-
-### Models
-
-The core of the SDK contains pydantic models for requests, responses, resources, events and errors. Users of the SDK are meant to use these models directly or indirectly.
-
-### Server
-
-The server module consists of 3 parts:
-  
-  1. Agent interface
-  2. FastAPI application factory
-  3. Uvicorn based server
-
-Each part builds on top of the previous one. Not all parts need to be used, e.g. users are advised to bring their own ASGI server for production deployments.
-
-### Client
-
-The client module consists of httpx based client with session support. The client is meant to be thin and mimic the REST API. Exception is session management which has been abstracted into a context manager.
-
-
-  

acp_sdk-0.3.2/README.md

@@ -1,79 +0,0 @@
-# Agent Communication Protocol SDK for Python
-
-Agent Communication Protocol SDK for Python provides allows developers to serve and consume agents over the Agent Communication Protocol.
-
-## Prerequisites
-
-✅ Python >= 3.11
-
-## Installation
-
-Install with:
-
-```shell
-pip install acp-sdk
-```
-
-## Overview
-
-### Core
-
-The core of the SDK exposes [pydantic](https://docs.pydantic.dev/) data models corresponding to REST API requests, responses, resources, events and errors.
-
-
-### Client
-
-The `client` submodule exposes [httpx](https://www.python-httpx.org/) based client with simple methods for communication over ACP.
-
-```python
-async with Client(base_url="http://localhost:8000") as client:
-    run = await client.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])])
-    print(run)
-
-```
-
-### Server
-
-The `server` submodule exposes `Agent` class and `agent` decorator together with [fastapi](https://fastapi.tiangolo.com/) application factory, making it easy to expose agents over ACP. Additionaly, it exposes [uvicorn](https://www.uvicorn.org/) based server to serve agents with set up logging, [opentelemetry](https://opentelemetry.io/) and more.
-
-```python
-server = Server()
-
-@server.agent()
-async def echo(inputs: list[Message], context: Context) -> AsyncGenerator[RunYield, RunYieldResume]:
-    """Echoes everything"""
-    for message in inputs:
-        yield {"thought": "I should echo everyting"}
-        await asyncio.sleep(0.5)
-        yield message
-
-
-server.run()
-```
-
-➡️ Explore more in our [examples library](/python/examples).
-
-## Architecture
-
-The architecture of the SDK is outlined in the following segment. It focuses on central parts of the SDK without going into much detail.
-
-### Models
-
-The core of the SDK contains pydantic models for requests, responses, resources, events and errors. Users of the SDK are meant to use these models directly or indirectly.
-
-### Server
-
-The server module consists of 3 parts:
-  
-  1. Agent interface
-  2. FastAPI application factory
-  3. Uvicorn based server
-
-Each part builds on top of the previous one. Not all parts need to be used, e.g. users are advised to bring their own ASGI server for production deployments.
-
-### Client
-
-The client module consists of httpx based client with session support. The client is meant to be thin and mimic the REST API. Exception is session management which has been abstracted into a context manager.
-
-
-  

acp_sdk-0.3.2/examples/clients/advanced.py

@@ -1,21 +0,0 @@
-import asyncio
-
-import httpx
-from acp_sdk.client.client import Client
-from acp_sdk.models import Message, MessagePart
-
-
-async def example() -> None:
-    async with Client(
-        client=httpx.AsyncClient(
-            base_url="http://localhost:8000",
-            auth=httpx.BasicAuth(username="username", password="password"),
-            # Additional client configuration
-        )
-    ) as client:
-        run = await client.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])])
-        print(run)
-
-
-if __name__ == "__main__":
-    asyncio.run(example())

acp_sdk-0.3.2/examples/clients/session.py

@@ -1,18 +0,0 @@
-import asyncio
-
-from acp_sdk.client import Client
-from acp_sdk.models import (
-    Message,
-    MessagePart,
-)
-
-
-async def example() -> None:
-    async with Client(base_url="http://localhost:8000") as client, client.session() as session:
-        run = await session.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])])
-        run = await session.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy again!")])])
-        print(run)
-
-
-if __name__ == "__main__":
-    asyncio.run(example())

acp_sdk-0.3.2/examples/clients/simple.py

@@ -1,17 +0,0 @@
-import asyncio
-
-from acp_sdk.client import Client
-from acp_sdk.models import (
-    Message,
-    MessagePart,
-)
-
-
-async def example() -> None:
-    async with Client(base_url="http://localhost:8000") as client:
-        run = await client.run_sync(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])])
-        print(run)
-
-
-if __name__ == "__main__":
-    asyncio.run(example())

acp_sdk-0.3.2/examples/clients/stream.py

@@ -1,14 +0,0 @@
-import asyncio
-
-from acp_sdk.client import Client
-from acp_sdk.models import Message, MessagePart
-
-
-async def example() -> None:
-    async with Client(base_url="http://localhost:8000") as client:
-        async for event in client.run_stream(agent="echo", inputs=[Message(parts=[MessagePart(content="Howdy!")])]):
-            print(event)
-
-
-if __name__ == "__main__":
-    asyncio.run(example())

acp_sdk-0.3.2/examples/servers/awaiting.py

@@ -1,26 +0,0 @@
-from collections.abc import AsyncGenerator
-
-from acp_sdk.models import (
-    Message,
-    MessageAwaitRequest,
-    MessageAwaitResume,
-    MessagePart,
-)
-from acp_sdk.server import Context, Server
-from acp_sdk.server.types import RunYield, RunYieldResume
-
-server = Server()
-
-
-@server.agent()
-async def awaiting(inputs: list[Message], context: Context) -> AsyncGenerator[RunYield, RunYieldResume]:
-    """Greets and awaits for more data"""
-    yield MessagePart(content="Hello!")
-    resume = yield MessageAwaitRequest(
-        message=Message(parts=[MessagePart(content="Can you provide me with additional configuration?")])
-    )
-    assert isinstance(resume, MessageAwaitResume)
-    yield MessagePart(content=f"Thanks for config: {resume.message}")
-
-
-server.run()

acp_sdk-0.3.2/examples/servers/echo.py

@@ -1,22 +0,0 @@
-import asyncio
-from collections.abc import AsyncGenerator
-
-from acp_sdk.models import (
-    Message,
-)
-from acp_sdk.server import Context, RunYield, RunYieldResume, Server
-
-server = Server()
-
-
-@server.agent()
-async def echo(inputs: list[Message], context: Context) -> AsyncGenerator[RunYield, RunYieldResume]:
-    """Echoes everything"""
-    for message in inputs:
-        await asyncio.sleep(0.5)
-        yield {"thought": "I should echo everyting"}
-        await asyncio.sleep(0.5)
-        yield message
-
-
-server.run()

acp_sdk-0.3.2/examples/servers/standalone.py

@@ -1,25 +0,0 @@
-from collections.abc import AsyncGenerator
-
-from acp_sdk.models import (
-    Message,
-)
-from acp_sdk.server import RunYield, RunYieldResume, agent, create_app
-
-# This example demonstrates how to serve agents with you own server
-
-
-@agent()
-async def echo(inputs: list[Message]) -> AsyncGenerator[RunYield, RunYieldResume]:
-    """Echoes everything"""
-    for message in inputs:
-        yield message
-
-
-app = create_app(echo)
-
-# The app can now be used with any ASGI server
-
-# Run with
-#   1. fastapi run examples/servers/standalone.py
-#   2. uvicorn examples.servers.standalone:app
-#   ...