Skip to main content

copass-agent-router

High-level Copass agent SDK. Python mirror of @copass/agent-router — wraps copass-core + copass-core-agents into a one-import surface that runs a full agent lifecycle: connect an integration, run an agent turn, stream events.

Install

pip install copass-agent-router

Quickstart

import asyncio, webbrowser
from copass_agent_router import AgentRouter, RunAgentOptions
from copass_core import ApiKeyAuth

async def main():
    router = AgentRouter(
        auth=ApiKeyAuth(key="olk_..."),
        sandbox_id="sb_...",
    )

    # Connect an integration (OAuth, local browser, webhook fallback via reconcile).
    result = await router.integrations.connect(
        "github",
        on_connect_url=lambda url: webbrowser.open(url),
    )
    print("connected:", result.connection["app"], result.connection["name"])

    # Run an agent.
    async for event in router.run(RunAgentOptions(
        provider="anthropic",
        model="claude-opus-4-7",
        system="You are a helpful agent.",
        message="Summarize my latest GitHub issues.",
        end_user_id="u-123",
    )):
        t = type(event).__name__
        if t == "AgentTextDelta":
            print(event.text, end="", flush=True)
        elif t == "AgentFinish":
            print(f"\n[done] {event.stop_reason}")

asyncio.run(main())

License

MIT.

Release files for copass-agent-router 1.4.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for copass-agent-router 1.4.9
File Size Uploaded
copass_agent_router-1.4.9.tar.gz 7.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for copass-agent-router 1.4.9
File Interpreter ABI Platform
copass_agent_router-1.4.9-py3-none-any.whl Python 3 none any Details

Total release size: 15.6 kB

Release files / copass_agent_router-1.4.9.tar.gz

Download URL copass_agent_router-1.4.9.tar.gz
Size 7.0 kB
Tags Source
SHA-256 checksum
How to use checksums
bc0dfe43fa617fa2eea68ae366cf351d7f42ca80b500aa29b66cc36f98c51339
BLAKE2b-256 checksum
How to use checksums
e0486850474748b1f0a6260b3e6ec59b23f6cabc2b0450fa378e7b072cad342c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 5, 2026.

Transparency log

Release files / copass_agent_router-1.4.9-py3-none-any.whl

Download URL copass_agent_router-1.4.9-py3-none-any.whl
Size 8.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a8a9179e0cede1ec6ec6f1f2d4c8d80744126b98381f4545d8c9c834ce13d10
BLAKE2b-256 checksum
How to use checksums
8804008eeadc0a6b518ea29a954c645c60e8a3950c4af92423d9fe70463873bf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 5, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.4.9 This release

2 release files

1.4.8

2 release files

1.4.7

2 release files

1.4.6

2 release files

1.4.5

2 release files

1.4.4

2 release files

1.4.3

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page