Metadata-Version: 2.4
Name: opencoat-runtime-host
Version: 0.1.2
Summary: Host-side integration for OpenCOAT Runtime — joinpoint emitter, injection consumer, and first-party framework adapters (openclaw, hermes, langgraph, autogen, crewai, custom).
Project-URL: Homepage, https://github.com/HyperdustLabs/OpenCOAT
Project-URL: Repository, https://github.com/HyperdustLabs/OpenCOAT
Project-URL: Issues, https://github.com/HyperdustLabs/OpenCOAT/issues
Project-URL: Documentation, https://github.com/HyperdustLabs/OpenCOAT/tree/main/docs
Project-URL: Changelog, https://github.com/HyperdustLabs/OpenCOAT/releases
Author: HyperdustLabs
License-Expression: Apache-2.0
Keywords: agent-runtime,aop,concerns,dcn,host-adapter,joinpoint,opencoat,pointcut,weaving
Classifier: Development Status :: 3 - Alpha
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: opencoat-runtime-protocol<0.2.0,>=0.1.0
Requires-Dist: opencoat-runtime<0.2.0,>=0.1.0
Provides-Extra: autogen
Provides-Extra: crewai
Provides-Extra: hermes
Provides-Extra: langgraph
Requires-Dist: langgraph>=0.2; extra == 'langgraph'
Provides-Extra: openclaw
Description-Content-Type: text/markdown

# opencoat-runtime-host

Host-side integration for the OpenCOAT Runtime — the library you embed inside an
agent framework so it can emit joinpoints to OpenCOAT and consume concern
injections back.

This package ships:

| Module                                | Role                                                              |
| ------------------------------------- | ----------------------------------------------------------------- |
| `opencoat_runtime_host_sdk`           | joinpoint emitter, injection consumer, transports (inproc, socket, http) |
| `opencoat_runtime_host_openclaw`      | OpenClaw adapter (events, tool guard, memory bridge, install hooks) |
| `opencoat_runtime_host_hermes`        | Hermes adapter                                                    |
| `opencoat_runtime_host_langgraph`     | LangGraph adapter                                                 |
| `opencoat_runtime_host_autogen`       | AutoGen adapter                                                   |
| `opencoat_runtime_host_crewai`        | CrewAI adapter                                                    |
| `opencoat_runtime_host_custom`        | scaffold for a fully custom host                                  |

Pulls in [`opencoat-runtime-protocol`](https://pypi.org/project/opencoat-runtime-protocol/) (the wire contract) and [`opencoat-runtime`](https://pypi.org/project/opencoat-runtime/) (for the `HostAdapter` protocol type and the joinpoint catalog the adapters import at module load). You do not need to run a daemon process just to use the SDK — the transports talk to whichever daemon is live, but importing the package only requires the wheels above.

## Install

```bash
pip install "opencoat-runtime-host[openclaw]"
pip install "opencoat-runtime-host[langgraph]"   # pulls langgraph itself
pip install "opencoat-runtime-host[hermes,autogen,crewai]"
pip install "opencoat-runtime-host[http]"        # SDK with httpx transport
```

## Quick start

```python
from opencoat_runtime_host_sdk import Client, joinpoint

client = Client.from_env()          # picks transport from OPENCOAT_TRANSPORT

@joinpoint("before_response", client=client, level=1)
def generate(ctx: dict) -> str:
    return llm.complete(ctx["prompt"])
```

For framework-specific adapters see the per-module READMEs and
<https://github.com/HyperdustLabs/OpenCOAT/tree/main/docs>.

## License

Apache-2.0.
