asap-protocol 0.3.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

asap_protocol-1.0.0.dist-info/METADATA

@@ -0,0 +1,264 @@
+Metadata-Version: 2.4
+Name: asap-protocol
+Version: 1.0.0
+Summary: Async Simple Agent Protocol - A streamlined protocol for agent-to-agent communication
+Project-URL: Homepage, https://github.com/adriannoes/asap-protocol
+Project-URL: Documentation, https://adriannoes.github.io/asap-protocol
+Project-URL: Repository, https://github.com/adriannoes/asap-protocol
+Project-URL: Issues, https://github.com/adriannoes/asap-protocol/issues
+Project-URL: PyPI, https://pypi.org/project/asap-protocol/
+Author: ASAP Protocol Contributors
+License: Apache-2.0
+License-File: LICENSE
+Keywords: a2a,agent,async,communication,mcp,protocol
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: brotli>=1.2.0
+Requires-Dist: fastapi>=0.128.0
+Requires-Dist: httpx[http2]>=0.28.1
+Requires-Dist: jsonschema>=4.23.0
+Requires-Dist: opentelemetry-api>=1.20
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.41
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.41
+Requires-Dist: opentelemetry-sdk>=1.20
+Requires-Dist: packaging>=25.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: python-ulid>=3.0
+Requires-Dist: slowapi>=0.1.9
+Requires-Dist: structlog>=24.1
+Requires-Dist: typer>=0.21.1
+Requires-Dist: uvicorn>=0.34
+Requires-Dist: watchfiles>=0.21.0
+Provides-Extra: dev
+Requires-Dist: brotli>=1.1.0; extra == 'dev'
+Requires-Dist: mypy>=1.19.1; extra == 'dev'
+Requires-Dist: pip-audit>=2.7; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-benchmark>=5.1; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.14.14; extra == 'dev'
+Requires-Dist: types-jsonschema>=4.0.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.27; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# ASAP: Async Simple Agent Protocol
+
+![ASAP Protocol Banner](https://raw.githubusercontent.com/adriannoes/asap-protocol/main/.github/assets/asap-protocol-banner.png)
+
+
+> A streamlined, scalable, asynchronous protocol for agent-to-agent communication and task coordination. Built as a simpler, more powerful alternative to A2A with native MCP integration and stateful orchestration.
+
+**Quick Info**: `v1.0.0` | `Apache 2.0` | `Python 3.13+` | [Documentation](https://github.com/adriannoes/asap-protocol/blob/main/docs/index.md) | [PyPI](https://pypi.org/project/asap-protocol/1.0.0/) | [Changelog](https://github.com/adriannoes/asap-protocol/blob/main/CHANGELOG.md)
+
+**Stable** — ASAP Protocol v1.0.0 is production-ready. We welcome feedback and contributions. See our [Contributing](https://github.com/adriannoes/asap-protocol#contributing) section to get involved!
+
+## Why ASAP?
+
+Building multi-agent systems today suffers from three core technical challenges that existing protocols like A2A don't fully address:
+1. **$N^2$ Connection Complexity**: Most protocols assume static point-to-point HTTP connections that don't scale.
+2. **State Drift**: Lack of native persistence makes it impossible to reliably resume long-running agentic workflows.
+3. **Fragmentation**: No unified way to handle task delegation, artifact exchange, and tool execution (MCP) in a single envelope.
+
+**ASAP** provides a production-ready communication layer that simplifies these complexities. It introduces a standardized, stateful orchestration framework that ensures your agents can coordinate reliably across distributed environments. → [Spec](https://github.com/adriannoes/asap-protocol/blob/main/.cursor/product-specs/v0-original-specs.md)
+
+### Key Features
+
+- **Stateful orchestration** — Task state machine with snapshotting for resumable workflows.
+- **Schema-first** — Pydantic v2 + JSON Schema for cross-agent interoperability.
+- **Async-native** — `asyncio` + `httpx`; sync and async handlers supported.
+- **MCP integration** — Tool execution and coordination in a single envelope.
+- **Observable** — `trace_id` and `correlation_id` for debugging.
+- **Security (v1.0.0)** — Bearer auth, replay prevention, HTTPS, rate limiting (100 req/min). Opt-in.
+
+## Installation
+
+We recommend using [uv](https://github.com/astral-sh/uv) for dependency management:
+
+```bash
+uv add asap-protocol
+```
+
+Or with pip:
+
+```bash
+pip install asap-protocol
+```
+
+📦 **Available on [PyPI](https://pypi.org/project/asap-protocol/1.0.0/)**
+
+For reproducible environments, prefer `uv` when possible.
+
+## Requirements
+
+- **Python**: 3.13 or higher
+- **Dependencies**: Automatically installed via `uv` or `pip`
+- **Optional**: For development, see [Contributing](https://github.com/adriannoes/asap-protocol/blob/main/CONTRIBUTING.md).
+
+## Quick Start
+
+### 1. Create an Agent (Server)
+
+```python
+from asap.models.entities import Capability, Endpoint, Manifest, Skill
+from asap.transport.handlers import HandlerRegistry, create_echo_handler
+from asap.transport.server import create_app
+
+manifest = Manifest(
+    id="urn:asap:agent:echo-agent",
+    name="Echo Agent",
+    version="1.0.0",
+    description="Echoes task input as output",
+    capabilities=Capability(
+        asap_version="0.1",
+        skills=[Skill(id="echo", description="Echo back the input")],
+        state_persistence=False,
+    ),
+    # Development: HTTP localhost is allowed
+    # Production: Always use HTTPS (e.g., "https://api.example.com/asap")
+    endpoints=Endpoint(asap="http://127.0.0.1:8001/asap"),
+)
+
+registry = HandlerRegistry()
+registry.register("task.request", create_echo_handler())
+
+app = create_app(manifest, registry)
+```
+
+### 2. Send a Task (Client)
+
+```python
+import asyncio
+from asap.models.envelope import Envelope
+from asap.models.payloads import TaskRequest
+from asap.transport.client import ASAPClient
+
+async def main():
+    request = TaskRequest(
+        conversation_id="conv_01HX5K3MQVN8",
+        skill_id="echo",
+        input={"message": "hello from client"},
+    )
+    envelope = Envelope(
+        asap_version="0.1",
+        sender="urn:asap:agent:client",
+        recipient="urn:asap:agent:echo-agent",
+        payload_type="task.request",
+        payload=request.model_dump(),
+    )
+    # Development: HTTP localhost is allowed (with warning)
+    # Production: Always use HTTPS (e.g., "https://api.example.com")
+    async with ASAPClient("http://127.0.0.1:8001") as client:
+        response = await client.send(envelope)
+        print(response.payload)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Try it
+
+**Run the multi-agent demo** (echo agent + coordinator, one round-trip):
+
+```bash
+uv run python -m asap.examples.run_demo
+```
+
+**Run any of 14+ examples** (auth, MCP, state migration, etc.):
+
+```bash
+uv run python -m asap.examples.<module_name> [options]
+```
+
+→ Full list: [Examples README](https://github.com/adriannoes/asap-protocol/blob/main/src/asap/examples/README.md)
+
+| Category | Examples |
+|----------|----------|
+| **Core** | `run_demo`, `echo_agent`, `coordinator`, `secure_handler` |
+| **Orchestration** | `orchestration` (multi-agent, task coordination, state tracking) |
+| **State** | `long_running` (checkpoints, resume after crash), `state_migration` (move state between agents) |
+| **Resilience** | `error_recovery` (retry, circuit breaker, fallback) |
+| **Integration** | `mcp_integration` (MCP tools via envelopes) |
+| **Auth & limits** | `auth_patterns` (Bearer, validators, OAuth2 concept), `rate_limiting` (per-sender, per-endpoint) |
+| **Concepts** | `websocket_concept` (WebSocket design), `streaming_response` (TaskUpdate streaming), `multi_step_workflow` (pipeline) |
+
+## Testing
+
+```bash
+uv run pytest -n auto --tb=short
+```
+
+With coverage:
+
+```bash
+uv run pytest --cov=src --cov-report=term-missing
+```
+
+→ [Testing Guide](https://github.com/adriannoes/asap-protocol/blob/main/docs/testing.md) — structure, fixtures, property/load/chaos tests
+→ [Contributing](https://github.com/adriannoes/asap-protocol/blob/main/CONTRIBUTING.md) — dev setup, CI
+
+## Benchmarks
+
+→ [Benchmark Results](https://github.com/adriannoes/asap-protocol/blob/main/benchmarks/RESULTS.md) — Load (1,500+ RPS), stress, memory
+
+## API Overview
+
+Core models: `Envelope`, `TaskRequest`/`TaskResponse`/`TaskUpdate`/`TaskCancel`, `MessageSend`, `ArtifactNotify`, `StateQuery`/`StateRestore`, `McpToolCall`/`McpToolResult`/`McpResourceFetch`/`McpResourceData`. → [API Reference](https://github.com/adriannoes/asap-protocol/blob/main/docs/api-reference.md)
+
+Transport: `create_app`, `HandlerRegistry`, `ASAPClient`. → [Transport](https://github.com/adriannoes/asap-protocol/blob/main/docs/transport.md)
+
+## When to Use ASAP?
+
+ASAP is ideal for:
+- **Multi-agent orchestration**: Coordinate tasks across multiple AI agents
+- **Stateful workflows**: Long-running tasks that need persistence and resumability
+- **MCP integration**: Agents that need to execute tools via Model Context Protocol
+- **Production systems**: High-performance, type-safe agent communication
+
+If you're building simple point-to-point agent communication, a basic HTTP API might suffice. ASAP shines when you need orchestration, state management and multi-agent coordination.
+
+## Documentation
+
+**Learn**
+- [Docs](https://github.com/adriannoes/asap-protocol/blob/main/docs/index.md) | [API Reference](https://github.com/adriannoes/asap-protocol/blob/main/docs/api-reference.md)
+- [Tutorials](https://github.com/adriannoes/asap-protocol/tree/main/docs/tutorials) — First agent → production checklist
+- [Migration from A2A/MCP](https://github.com/adriannoes/asap-protocol/blob/main/docs/migration.md)
+
+**Deep dive**
+- [State Management](https://github.com/adriannoes/asap-protocol/blob/main/docs/state-management.md) | [Error Handling](https://github.com/adriannoes/asap-protocol/blob/main/docs/error-handling.md)
+- [Transport](https://github.com/adriannoes/asap-protocol/blob/main/docs/transport.md) | [Security](https://github.com/adriannoes/asap-protocol/blob/main/docs/security.md)
+- [Observability](https://github.com/adriannoes/asap-protocol/blob/main/docs/observability.md) | [Testing](https://github.com/adriannoes/asap-protocol/blob/main/docs/testing.md)
+
+**Decisions & ops**
+- [ADRs](https://github.com/adriannoes/asap-protocol/tree/main/docs/adr) — 17 Architecture Decision Records
+- [Deployment](https://github.com/adriannoes/asap-protocol/blob/main/docs/deployment/kubernetes.md) | [Troubleshooting](https://github.com/adriannoes/asap-protocol/blob/main/docs/troubleshooting.md)
+
+**Release**
+- [Changelog](https://github.com/adriannoes/asap-protocol/blob/main/CHANGELOG.md) | [PyPI](https://pypi.org/project/asap-protocol/1.0.0/)
+
+## CLI
+
+`asap --version` | `asap export-schemas` | `asap list-schemas` | `asap show-schema` — [CLI docs](https://github.com/adriannoes/asap-protocol/blob/main/docs/index.md#cli) or `asap --help`
+
+## Contributing
+
+We love contributions! Whether it's fixing a bug, improving documentation or proposing a new feature.. your help is welcome.
+
+**Community feedback and contributions are essential** for ASAP Protocol's evolution. We're actively working on improvements and your input helps shape the future of the protocol. Every contribution, from bug reports to feature suggestions, documentation improvements and code contributions, makes a real difference.
+
+Check out our [Contributing Guidelines](https://github.com/adriannoes/asap-protocol/blob/main/CONTRIBUTING.md) to get started. It's easier than you think! 🚀
+
+## License
+
+This project is licensed under the Apache 2.0 License - see the [LICENSE](https://github.com/adriannoes/asap-protocol/blob/main/LICENSE) file for details.

asap_protocol-1.0.0.dist-info/RECORD

@@ -0,0 +1,70 @@
+asap/__init__.py,sha256=K2PhO3EHYthoYxUJgjZEPt_E1c8Uh0Kt2YO3fNa5_fI,169
+asap/cli.py,sha256=1mpk6BdApazJCWY_w5OJQOdcmvmBD9V-ztBVhmAf--I,11280
+asap/errors.py,sha256=pc4QQfseteEujGp3bDH-IiPpr-xh1N6DvDL5faiFY9M,11917
+asap/schemas.py,sha256=c9MttEoI4mgXFHDFzphSRAJhw7cpy2rcnXH31jlo1sQ,6135
+asap/examples/README.md,sha256=ydk02C1tjzSZU3W5yfTgT89tuC5S6BjmzIMu4uiMDMg,4460
+asap/examples/__init__.py,sha256=LaEkmPQ4tpYrkLFjBE_aodjW3_XUcKWoFLGVFD5kuvo,56
+asap/examples/auth_patterns.py,sha256=OC-NOfX3q8-TbJn5Zk-SfbGw52h3hAKwELbMScyXcFw,7171
+asap/examples/coordinator.py,sha256=C5Ugi47PGwtbRao8eD29v2l_9tww2_sL-kXK5jQaWGw,5370
+asap/examples/echo_agent.py,sha256=cmNjEx28jCNcU4waYFOZ8ZcHxth1znMOhmaGXIquJzA,2947
+asap/examples/error_recovery.py,sha256=LI-8ediOqSfoddjgUgvycs28Hk9K-d6uxZq9nRJO2Rk,7822
+asap/examples/long_running.py,sha256=0DGLHsjbOoYU_aUetjPiV3PUzo6Xn-DybmHbI45ajJQ,8841
+asap/examples/mcp_integration.py,sha256=rkKja6kAFnGje2lQMStLybfDi7M3s-0yDId-llhz7aU,7943
+asap/examples/multi_step_workflow.py,sha256=XsVAaqhFCfOktahV1Qcyp7pyr4JusKAjH48V9QrYaYk,4070
+asap/examples/orchestration.py,sha256=idTIDsgoO0WqFCysi58z3NnfQJa5gMhDLTRMGDZcVSo,9904
+asap/examples/rate_limiting.py,sha256=WfETgDsPCB82TxDrFutfDShKlCm_WXrW9P5TWlQogic,4452
+asap/examples/run_demo.py,sha256=kxCsCrX3i34bqc_nsy_QtnBG8FxgC4Hwkyz5JNP8cmo,3953
+asap/examples/secure_handler.py,sha256=SmrgRc0Ntw3FGaip18OwzJIKtrjCvGChNSjMG7tJeZA,3138
+asap/examples/state_migration.py,sha256=IS7P5gbnpuBLJ4OAb__IHLtA3OgkBmGaUPPWI8JI2fk,7915
+asap/examples/streaming_response.py,sha256=Jh-8F6QsEal-xbsk3mSJs_LwacLsegp7sXikqCAe9mY,3254
+asap/examples/websocket_concept.py,sha256=l96gvdEVxZ5yyDZn4fQR3M-a_-zUX4e60eOhljkRRRU,5159
+asap/mcp/__init__.py,sha256=u_F-o9ZlleraUbOo05zkRpZrW06mpuxnO_uFVA22Dr8,1121
+asap/mcp/client.py,sha256=qt71Q1eEkRWrymlz4LKZ3GfMYe8r5Ho2n3TigfGMobk,7958
+asap/mcp/protocol.py,sha256=EwStOJP0Tf7ga6iWGeejD7kNBdV7lbPB4mZnREVEGQ4,5438
+asap/mcp/server.py,sha256=8LnjcloGTp3sH_HsKgeylgo1r97TpU33WZqgc0G_0sc,12458
+asap/mcp/server_runner.py,sha256=cGH3AyiQ3v7SzizwPNMOUSV-TCrI2Az4sudUzFOwKNU,1011
+asap/models/__init__.py,sha256=c9TDscYv-_2U8OlEt7G-Il02flISgGbckZu4RtDwgDk,2643
+asap/models/base.py,sha256=BVydcmBLDU2hD7SzjfROcm1njeqTG82OARMUH5y4wlY,1863
+asap/models/constants.py,sha256=nDlUALrkWM3bKv-MUzqbvJZyJhRXp1bF3vvGa8IDKG8,3271
+asap/models/entities.py,sha256=bePFLqCR7Ikg-cfVqt6U94xOvDAvhriw4lnQiBEYOWU,18342
+asap/models/enums.py,sha256=q8tnW10AT94hxDFoH1Psg1a1x4tzs47x12N7RTGLNRQ,1644
+asap/models/envelope.py,sha256=qVBVQh7nnFURlSz1LbXPXn2EmL4kRcJ28-MkHURhlZA,4297
+asap/models/ids.py,sha256=w8A3SNUkEB_U80C6F4kL30yB9-THh-okVD-wTqCkQZQ,1807
+asap/models/parts.py,sha256=0QxwQJndIPpjOkJ5BCvj6SCRX6hyIxVAIdc4DXGfEu0,7978
+asap/models/payloads.py,sha256=l0taURdWy09BASSJkiCrR6VixbqzD3HrFdVrFad7YqQ,14867
+asap/models/types.py,sha256=ldWyz6gThlK_cxywxfcIiMLD74_BRV0lbfyussvSURg,978
+asap/models/validators.py,sha256=xbLMzP_vao64m-SpM00nBFhWnI7aPUdlOYiSfRZd7Ps,563
+asap/observability/__init__.py,sha256=jJZ3-9OCFjtmb_erz54Gh1bZRGQAeBh8vT71ZnamffQ,1287
+asap/observability/logging.py,sha256=j8pGL_KISvflyYE3koEISu6afp-9khl5HOgVDnR_Y-U,9603
+asap/observability/metrics.py,sha256=YgDJaEF8wsTxEphuBTMP5sNgIH0XtTQOyTd1OVxuK9U,15952
+asap/observability/trace_parser.py,sha256=U4bGYEGA9Z-oNr2Uk94eXztXKDmBeGtY-7w1zl9QQBM,7874
+asap/observability/trace_ui.py,sha256=4gHR2rdo8qEKW4dSBF78bgcIhyfEX3fTVeuXsjf8YS4,7621
+asap/observability/tracing.py,sha256=2adDzwYLbOoitBLUJcXlwCrkoIjduR9b7Jjmiv9a52c,9945
+asap/observability/dashboards/README.md,sha256=lyZ_jyuDKvmiGdLYmWQ_iJzV-bjIdfTpzXDJKmNVQOI,1208
+asap/observability/dashboards/asap-detailed.json,sha256=W6h9BKK3Ss9WHIJXcpQw5U5t2KMcaXl1-_Ghe0jCFyA,5354
+asap/observability/dashboards/asap-red.json,sha256=5nPUkm9ZI88val6cWlsCsNT1ni0qz140DFRn8FMqfpM,5231
+asap/state/__init__.py,sha256=bV1oO86TReF48C5IaglNr8WHczzAWTpw3n7SyDw04nk,565
+asap/state/machine.py,sha256=p5qdA_z3VhiLU448O5WOoBiUsSPPc42JYYAjHHO6fWI,3246
+asap/state/snapshot.py,sha256=INbjRtfsLLXFkbgIySvgG3nKsKAdjPIeCB6gaT6DqtY,8318
+asap/testing/__init__.py,sha256=EQV8-cYvM__NT_0rA3nPvz4_RlRTpIYKzqhGEtpdQhM,1009
+asap/testing/assertions.py,sha256=4KumraQSBolb9db3J4P3rZOT_1JRyS9dLqI4hhbBHDc,4149
+asap/testing/fixtures.py,sha256=OVfsfrgs1P1I2GjsNByKOssOXENwf-nDm2lPV6vZY-A,3114
+asap/testing/mocks.py,sha256=AcCcI3fKKXwpf1nvGR2NZt2RBkCxIhBhJ1dO6ZxzEWc,5045
+asap/transport/__init__.py,sha256=g-A04M9BsDeVF5TCBNcFgFIpJOlRmljs67M8RV8yGK0,3289
+asap/transport/cache.py,sha256=2ccVU9Ki2xn6Yl-mVQ9fqOnWCCqD9VEHtkAAi2OsdxU,5583
+asap/transport/circuit_breaker.py,sha256=8MdEpJqbhpIFdXorpycQIbtnGrTeOdORwfBgT4M9MrU,6302
+asap/transport/client.py,sha256=XX-EZvanEKzfrUHnTjF5_TYVyE3k1gNg5Ki6wKpg_C0,59163
+asap/transport/compression.py,sha256=XGeO1rNURMDqYHDFOI5z3KOrRc06v4LnCtnveZu_eN8,11746
+asap/transport/executors.py,sha256=0UH2cd5fVPGPGtnzmnFq1W8IF9BLjp5grCz3Oucj7CQ,5737
+asap/transport/handlers.py,sha256=AZOTQppMiDHqnPqaz8fenq0SmEc3130gXLP-zspEufY,17794
+asap/transport/jsonrpc.py,sha256=Cnh6ahoXr4Dkmt2KqoXESDKKs_9MwfsgIjn-TDjpkEQ,5800
+asap/transport/middleware.py,sha256=s9PXq4pnTC6fwiME7Tc1h89r-7qJ61luhxyxZJnE6nw,24435
+asap/transport/server.py,sha256=eZDPjbO7axJVKzfvIOCdsAlwyJtNAjIAUl3X-uY0s0s,58103
+asap/transport/validators.py,sha256=UgP13IaLBraRAy4yCqJOymh9EUnXT3OVWBLHDjrefGM,10847
+asap/utils/__init__.py,sha256=aWEjhGOgrzvBjvMVW1Dg5yJH_xixaOqrsilNdU7zz4A,206
+asap/utils/sanitization.py,sha256=Quv9TxVimiD7Ho1RV2RC-LukQgjORNHcbIqXBVQe2cQ,4056
+asap_protocol-1.0.0.dist-info/METADATA,sha256=5-raewZ-1lFgJc5h_Re2GE-R9PevPTlJs4MQ3C59e-4,12087
+asap_protocol-1.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+asap_protocol-1.0.0.dist-info/entry_points.txt,sha256=H_u_JamRG5mGQTXwnCFljBFep6lZPuln9NPLfgq1naM,39
+asap_protocol-1.0.0.dist-info/licenses/LICENSE,sha256=JmjzvAfg8BUP_0y_hu4SQSUgnSniWe2eBS7x2WPTo2A,10771
+asap_protocol-1.0.0.dist-info/RECORD,,

asap_protocol-0.3.0.dist-info/METADATA

@@ -1,227 +0,0 @@
-Metadata-Version: 2.4
-Name: asap-protocol
-Version: 0.3.0
-Summary: Async Simple Agent Protocol - A streamlined protocol for agent-to-agent communication
-Project-URL: Homepage, https://github.com/adriannoes/asap-protocol
-Project-URL: Documentation, https://adriannoes.github.io/asap-protocol
-Project-URL: Repository, https://github.com/adriannoes/asap-protocol
-Project-URL: Issues, https://github.com/adriannoes/asap-protocol/issues
-Project-URL: PyPI, https://pypi.org/project/asap-protocol/
-Author: ASAP Protocol Contributors
-License: Apache-2.0
-License-File: LICENSE
-Keywords: a2a,agent,async,communication,mcp,protocol
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Distributed Computing
-Classifier: Typing :: Typed
-Requires-Python: >=3.13
-Requires-Dist: fastapi>=0.128.0
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: packaging>=25.0
-Requires-Dist: pydantic>=2.12.5
-Requires-Dist: python-ulid>=3.0
-Requires-Dist: slowapi>=0.1.9
-Requires-Dist: structlog>=24.1
-Requires-Dist: typer>=0.21.1
-Requires-Dist: uvicorn>=0.34
-Provides-Extra: dev
-Requires-Dist: mypy>=1.19.1; extra == 'dev'
-Requires-Dist: pip-audit>=2.7; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
-Requires-Dist: pytest-benchmark>=5.1; extra == 'dev'
-Requires-Dist: pytest-cov>=6.0; extra == 'dev'
-Requires-Dist: pytest-xdist>=3.5.0; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Requires-Dist: ruff>=0.14.14; extra == 'dev'
-Provides-Extra: docs
-Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
-Requires-Dist: mkdocstrings[python]>=0.27; extra == 'docs'
-Description-Content-Type: text/markdown
-
-# ASAP: Async Simple Agent Protocol
-
-![ASAP Protocol Banner](.cursor/docs/asap-protocol-banner.png)
-
-> A streamlined, scalable, asynchronous protocol for agent-to-agent communication and task coordination. Built as a simpler, more powerful alternative to A2A with native MCP integration and stateful orchestration.
-
-**Quick Info**: `v0.3.0` | `Apache 2.0` | `Python 3.13+` | [Documentation](docs/index.md) | [PyPI](https://pypi.org/project/asap-protocol/) | [Changelog](CHANGELOG.md)
-
-⚠️ **Alpha Release**: ASAP Protocol is currently in **alpha** (v0.3.0). We're actively developing and improving the protocol based on real-world usage. Your feedback, contributions, and suggestions are essential to help us evolve and make ASAP better for the entire community. See our [Contributing](#contributing) section to get involved!
-
-## Why ASAP?
-
-Building multi-agent systems today suffers from three core technical challenges that existing protocols like A2A don't fully address:
-1. **$N^2$ Connection Complexity**: Most protocols assume static point-to-point HTTP connections that don't scale.
-2. **State Drift**: Lack of native persistence makes it impossible to reliably resume long-running agentic workflows.
-3. **Fragmentation**: No unified way to handle task delegation, artifact exchange, and tool execution (MCP) in a single envelope.
-
-**ASAP** provides a production-ready communication layer that simplifies these complexities. It introduces a standardized, stateful orchestration framework that ensures your agents can coordinate reliably across distributed environments.
-
-### Key Features
-
-- **Stateful Orchestration**: Native task state machine with built-in snapshotting for durable, resumable agent workflows.
-- **Schema-First Design**: Strict Pydantic v2 models providing automatic JSON Schema generation for guaranteed cross-agent interoperability.
-- **High-Performance Core**: Built on Python 3.13+, leveraging `uvloop` (C) and `pydantic-core` (Rust) for ultra-low latency validation and I/O.
-- **Observable Chains**: First-class support for `trace_id` and `correlation_id` to debug complex multi-agent delegation.
-- **MCP Integration**: Uses the Model Context Protocol (MCP) as a tool-execution substrate, wrapped in a high-level coordination envelope.
-- **Async-Native**: Engineered from the ground up for high-concurrency environments using `asyncio` and `httpx`. Supports both sync and async handlers with automatic event loop management.
-- **DoS Protection**: Built-in rate limiting (100 req/min), request size limits (10MB), and thread pool bounds to prevent resource exhaustion attacks.
-
-💡 **Performance Note**: Pure Python codebase leveraging Rust-accelerated dependencies (`pydantic-core`, `orjson`, `python-ulid`) for native-level performance without build complexity.
-
-## Installation
-
-We recommend using [uv](https://github.com/astral-sh/uv) for dependency management:
-
-```bash
-uv add asap-protocol
-```
-
-Or with pip:
-
-```bash
-pip install asap-protocol
-```
-
-📦 **Available on [PyPI](https://pypi.org/project/asap-protocol/)**
-
-For reproducible environments, prefer `uv` when possible.
-
-## Requirements
-
-- **Python**: 3.13 or higher
-- **Dependencies**: Automatically installed via `uv` or `pip`
-- **Optional**: For development, see [Contributing](CONTRIBUTING.md)
-
-## Quick Start
-
-### 1. Create an Agent (Server)
-
-```python
-from asap.models.entities import Capability, Endpoint, Manifest, Skill
-from asap.transport.handlers import HandlerRegistry, create_echo_handler
-from asap.transport.server import create_app
-
-manifest = Manifest(
-    id="urn:asap:agent:echo-agent",
-    name="Echo Agent",
-    version="0.3.0",
-    description="Echoes task input as output",
-    capabilities=Capability(
-        asap_version="0.1",
-        skills=[Skill(id="echo", description="Echo back the input")],
-        state_persistence=False,
-    ),
-    endpoints=Endpoint(asap="http://127.0.0.1:8001/asap"),
-)
-
-registry = HandlerRegistry()
-registry.register("task.request", create_echo_handler())
-
-app = create_app(manifest, registry)
-```
-
-### 2. Send a Task (Client)
-
-```python
-import asyncio
-from asap.models.envelope import Envelope
-from asap.models.payloads import TaskRequest
-from asap.transport.client import ASAPClient
-
-async def main():
-    request = TaskRequest(
-        conversation_id="conv_01HX5K3MQVN8",
-        skill_id="echo",
-        input={"message": "hello from client"},
-    )
-    envelope = Envelope(
-        asap_version="0.1",
-        sender="urn:asap:agent:client",
-        recipient="urn:asap:agent:echo-agent",
-        payload_type="task.request",
-        payload=request.model_dump(),
-    )
-    async with ASAPClient("http://127.0.0.1:8001") as client:
-        response = await client.send(envelope)
-        print(response.payload)
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## API Overview
-
-Core models:
-
-- `Envelope`: protocol wrapper with routing and tracing metadata
-- `TaskRequest`, `TaskResponse`, `TaskUpdate`, `TaskCancel`: task lifecycle payloads
-- `MessageSend`, `ArtifactNotify`: messaging and artifacts
-- `StateQuery`, `StateRestore`: snapshot state operations
-- `McpToolCall`, `McpToolResult`, `McpResourceFetch`, `McpResourceData`: MCP integration
-
-Transport:
-
-- `create_app`: FastAPI application factory
-- `HandlerRegistry`: payload dispatch registry (supports both sync and async handlers)
-- `ASAPClient`: async HTTP client with automatic retry for server errors (5xx)
-
-## Documentation
-
-- [Spec](.cursor/docs/general-specs.md)
-- [Docs](docs/index.md)
-- [API Reference](docs/api-reference.md)
-- [Changelog](CHANGELOG.md)
-- [PyPI Package](https://pypi.org/project/asap-protocol/)
-
-## When to Use ASAP?
-
-ASAP is ideal for:
-- **Multi-agent orchestration**: Coordinate tasks across multiple AI agents
-- **Stateful workflows**: Long-running tasks that need persistence and resumability
-- **MCP integration**: Agents that need to execute tools via Model Context Protocol
-- **Production systems**: High-performance, type-safe agent communication
-
-If you're building simple point-to-point agent communication, a basic HTTP API might suffice. ASAP shines when you need orchestration, state management, and multi-agent coordination.
-
-## Advanced Topics
-
-Explore these guides for detailed information on specific features:
-
-- **[State Management](docs/state-management.md)**: Task lifecycle, state machine, and snapshot persistence for resumable workflows.
-- **[Error Handling](docs/error-handling.md)**: Structured error taxonomy and recovery patterns for robust agent communication.
-- **[Transport Layer](docs/transport.md)**: HTTP/JSON-RPC binding details, async handlers, and server configuration.
-- **[Security](docs/security.md)**: Production security practices, rate limiting, DoS protection, and authentication.
-- **[Observability](docs/observability.md)**: Tracing, metrics, and logging for debugging multi-agent systems.
-- **[Testing](docs/testing.md)**: Testing strategies and utilities for ASAP-based agents.
-
-### Examples & Demos
-
-Run the built-in multi-agent demo to see ASAP in action:
-
-```bash
-uv run python -m asap.examples.run_demo
-```
-
-See [`src/asap/examples/`](src/asap/examples/) for complete example implementations.
-
-### CLI Tools
-
-The ASAP CLI provides utilities for schema management. See [CLI documentation](docs/index.md#cli) or run `asap --help` for available commands.
-
-## Contributing
-
-We love contributions! Whether it's fixing a bug, improving documentation or proposing a new feature.. your help is welcome.
-
-**As an alpha release, community feedback and contributions are essential** for ASAP Protocol's evolution. We're actively working on improvements and your input helps shape the future of the protocol. Every contribution, from bug reports to feature suggestions, documentation improvements and code contributions, makes a real difference.
-
-Check out our [Contributing Guidelines](CONTRIBUTING.md) to get started. It's easier than you think! 🚀
-
-## License
-
-This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.

asap_protocol-0.3.0.dist-info/RECORD

@@ -1,37 +0,0 @@
-asap/__init__.py,sha256=kyqepZHflLpgwKPTQYlSrCZpSa9i9moeiyiaYMTvbHw,169
-asap/cli.py,sha256=JzMA3t2Gn94kunkn5bgAkl6ZgzgwGtL5QFcKLYqWZYA,6621
-asap/errors.py,sha256=Kqj6fLhVjwHWYcZU_U7ZgK75HPGKUq5jAgL1-wQjb40,6396
-asap/schemas.py,sha256=c9MttEoI4mgXFHDFzphSRAJhw7cpy2rcnXH31jlo1sQ,6135
-asap/examples/README.md,sha256=xqMIMcZANi1eML6t4cNJ3rG6MjySf2SchgFiecxKpik,765
-asap/examples/__init__.py,sha256=LaEkmPQ4tpYrkLFjBE_aodjW3_XUcKWoFLGVFD5kuvo,56
-asap/examples/coordinator.py,sha256=C5Ugi47PGwtbRao8eD29v2l_9tww2_sL-kXK5jQaWGw,5370
-asap/examples/echo_agent.py,sha256=cmNjEx28jCNcU4waYFOZ8ZcHxth1znMOhmaGXIquJzA,2947
-asap/examples/run_demo.py,sha256=bFHH4IY-xYXIw66opgKGfmuXSC7_6astkERLtN0a9pw,3700
-asap/models/__init__.py,sha256=iUriI2CN9NcpH1_TyY5PkWiX3Mz7UnJDC9IeJzcWFUI,2511
-asap/models/base.py,sha256=PvLkFinOzfU6DDJ4pXMku7PK_2Xsaprh055mJKbdPUA,2008
-asap/models/constants.py,sha256=AEPklwTNZbYnSRsZ6HIeVI8F8T_zt1nZVzZPkqXo1rY,425
-asap/models/entities.py,sha256=siZCt-XqbOSPleXFBvwCSC9sVfZCrydNrUiKso8RHDo,16742
-asap/models/enums.py,sha256=q8tnW10AT94hxDFoH1Psg1a1x4tzs47x12N7RTGLNRQ,1644
-asap/models/envelope.py,sha256=MTlFEmYcT47gpQhOxWYGEUe99hw_woMWqWdp3rZl-co,3733
-asap/models/ids.py,sha256=ttTebUohYD_7Gmyg1GRi1jnRtnLcAL2SiXuOi4vGtb0,1425
-asap/models/parts.py,sha256=XiNvlEEqqb0W8cvvvLHYfzYzLULg7oFStMxm817-IZo,6939
-asap/models/payloads.py,sha256=l0taURdWy09BASSJkiCrR6VixbqzD3HrFdVrFad7YqQ,14867
-asap/models/types.py,sha256=ldWyz6gThlK_cxywxfcIiMLD74_BRV0lbfyussvSURg,978
-asap/observability/__init__.py,sha256=V1bBAZix7_IAoy09ETTlkSsi-1ENq5_EpBhi599EBxE,1145
-asap/observability/logging.py,sha256=1nK1OP-3BBpOf8d5UFmpSP8_mULF5kZ27YoS3S3U1a0,6733
-asap/observability/metrics.py,sha256=5yvXfvQ8FpigJ6pJ3vTQetSCQhPnoUCKywWigrxgnCI,14778
-asap/state/__init__.py,sha256=bV1oO86TReF48C5IaglNr8WHczzAWTpw3n7SyDw04nk,565
-asap/state/machine.py,sha256=1Obl1BcwwU-Xz20MX-layuPh1BVzcI1Kiowl_CueuU4,2795
-asap/state/snapshot.py,sha256=wPc2pnQD_EdPecEndbjIC9mXJep-LCJwtdazGMJSUJc,8654
-asap/transport/__init__.py,sha256=rX_hcnm0c-XxJKvxc4H2b_APNIVmdvXphRIqDrDWC8U,2506
-asap/transport/client.py,sha256=fHzz8M_qeNMLZhDxsOWeAVMXMNeOHFnmovptBMDsN2I,14325
-asap/transport/executors.py,sha256=0UH2cd5fVPGPGtnzmnFq1W8IF9BLjp5grCz3Oucj7CQ,5737
-asap/transport/handlers.py,sha256=BGnAF-RDiZYjdh0V-AqmvqrAkCh_QfI0yO-x1wzxOGQ,15924
-asap/transport/jsonrpc.py,sha256=Cnh6ahoXr4Dkmt2KqoXESDKKs_9MwfsgIjn-TDjpkEQ,5800
-asap/transport/middleware.py,sha256=pcY3SIynXY2ZrHg4_xlSHrPQeyjfrnOT51bNXevEAqQ,23276
-asap/transport/server.py,sha256=Ev5Q--9ZdEHd2m-xi-TH24HHT0o6UX6pLzlsoU0l29Q,42575
-asap_protocol-0.3.0.dist-info/METADATA,sha256=cjtpIzaR1QND7YiGII29-3PhhrhmDhShMbe2FHtHRQs,9954
-asap_protocol-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-asap_protocol-0.3.0.dist-info/entry_points.txt,sha256=H_u_JamRG5mGQTXwnCFljBFep6lZPuln9NPLfgq1naM,39
-asap_protocol-0.3.0.dist-info/licenses/LICENSE,sha256=JmjzvAfg8BUP_0y_hu4SQSUgnSniWe2eBS7x2WPTo2A,10771
-asap_protocol-0.3.0.dist-info/RECORD,,