Causalor SDK

Standard Python SDK for the hosted or self-hosted Causalor control plane.

Install

pip install causalor-sdk

For release steps and trusted publishing setup, see SDK_RELEASE.md.

For a local pre-PyPI install and a live test-agent run against the deployed Azure control plane:

bash scripts/sdk/install-local.sh
export CAUSALOR_TEST_API_URL=http://<bridge-host>:9001
export CAUSALOR_TEST_API_KEY=<api-key>
bash scripts/sdk/run-test-agent.sh

Quick Start

from causalor import Causalor

sdk = Causalor.init({
    "apiUrl": "https://api.causalor.io",
    "apiKey": "cal_xxx",
    "agentId": "agent-123",
    "tenantId": "default",
})

sdk.sendEvent({
    "user_id": "u1",
    "semantic_type": "ACTION",
    "content": "Approved loan for 185000",
})

Standard Methods

• init({ apiUrl, apiKey, agentId, tenantId? })
• sendEvent(event)
• sendEvents(events[])
• getRepair(userId)
• ackRepair(userId, repairId, success, feedback?)
• registerAgent(metadata)
• startSession(userId, metadata?)
• heartbeat(sessionId, metadata?)
• endSession(sessionId, outcome?)
• preCommit(action, state, policyId?)