copass-core 0.1.0

Core client SDK for the Copass platform (Python mirror of @copass/core)

copass-core

Core client SDK for the Copass platform. Python mirror of @copass/core — shared foundation for every Python Copass adapter.

Install

pip install copass-core

Requires httpx>=0.27. Python ≥ 3.10.

Quickstart

import asyncio
from copass_core import CopassClient, ApiKeyAuth

async def main():
    client = CopassClient(auth=ApiKeyAuth(key="olk_..."))

    # Retrieval
    menu = await client.retrieval.discover(
        sandbox_id="sb_...",
        query="How does auth work?",
    )
    print(menu["items"])

    # Context for agent
    context = await client.context.for_agent(
        sandbox_id="sb_...",
        tier="adaptive",
        query="auth flow",
    )
    print(context)

asyncio.run(main())

Auth options

from copass_core import CopassClient, ApiKeyAuth, BearerAuth, ProviderAuth

# Long-lived API key (olk_ prefix)
CopassClient(auth=ApiKeyAuth(key="olk_..."))

# Raw Bearer JWT (caller owns refresh)
CopassClient(auth=BearerAuth(token="eyJ..."))

# Custom AuthProvider implementation
class MyProvider:
    async def get_session(self):
        from copass_core import SessionContext
        return SessionContext(access_token=await _mint_token())

CopassClient(auth=ProviderAuth(provider=MyProvider()))

v0.1.0 scope

Shipped:

• CopassClient top-level entry point
• Auth providers: ApiKeyAuthProvider, BearerAuthProvider
• HttpClient with retry + request/response middleware
• RetrievalResource — discover / interpret / search
• ContextResource — /context/for-agent/{minimal,adaptive,comprehensive}

Deferred to a future release:

• Crypto primitives (HKDF, AES-GCM, session tokens, DEK) + Supabase auth provider
• ContextWindow + SourcesResource + IngestResource
• MatrixResource, SandboxesResource, ProjectsResource, EntitiesResource, VaultResource, UsageResource, ApiKeysResource, UsersResource

Add incrementally when a concrete Python consumer needs each. Opening a PR with a scoped addition is the expected path.

License

MIT.