Metadata-Version: 2.4
Name: couplet-core
Version: 0.1.2
Summary: Couplet agent engine — ACS v1, harness, LLM client, tools, and skills
Project-URL: Documentation, https://github.com/couplet-dev/couplet/tree/main/packages/core
Author: Couplet Contributors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: acs,agent,harness,llm,streaming
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: httpx>=0.28.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Description-Content-Type: text/markdown

# couplet-core

Framework-agnostic Couplet agent engine for Python.

## Install

```bash
pip install couplet-core
```

## What's included

- **ACS v1** — typed streaming events and SSE serialization
- **Agent harness** — tool loop with context compaction
- **LLM client** — OpenAI-compatible API with retry/resilience
- **Skillpacks** — handler registry and Skillpack loader (`couplet_core.skillpack`)

See [couplet-runtime](https://github.com/couplet-dev/couplet) for the reference FastAPI service and [skillpack-spec.md](../../docs/skillpack-spec.md) for the Skillpack layout.

## Minimal embed

```python
from couplet_core.acs import event_to_sse
from couplet_core.agent.harness import run_agent_turn
from couplet_core.agent.types import AgentTurn

async for event in run_agent_turn(turn, store=my_session_store):
    print(event_to_sse(event))
```
