› cavi-ai/
GitHub ↗

Claude (Anthropic) operations

This client mirrors and verifies upstream-compatible behavior. Upstream runtimes remain the canonical protocol owners.

Runtime-only provider over the Anthropic Messages API. Auth: x-api-key + anthropic-version. Messages runs are synchronous; getRun/cancelRun return the client-remembered terminal status via SynchronousRunStore. Supports the batch surface over Anthropic Message Batches.

Capability (CLAUDE_RUNTIME_SUPPORT): runs ✅ · getRun ✅ (client-local) · cancelRun ✅ (client-local) · streamRun ✅ · batch ✅.

startRun

Signature
client.startRun(body: RuntimeRunStartBody): Promise<RuntimeRunStatus>
HTTP
POST /v1/messages
Capability
supports.runs

Maps input→messages, instructions→system, model→model. Response output/tokens normalized from the Messages response. See runtime · startRun for the full field tables.

Example

ts
import { createClaudeProviderModule } from "@cavi-ai/api-client/providers/claude";
// … construct the runtime client, then:
const run = await client.startRun({ input: "Hi", model: "claude-opus-4-8" });

getRun / cancelRun

Signature
client.getRun(runId: string): Promise<RuntimeRunStatus> · client.cancelRun(runId: string): Promise<{ status: string }>
HTTP
n/a (client-local SynchronousRunStore)
Capability
supports.runs

Messages is synchronous — the run is terminal when startRun returns. getRun/cancelRun degrade to the remembered terminal result. Field tables per runtime · getRun / cancelRun.

submitBatch / getBatch / cancelBatch / getBatchResults

HTTP
POST /v1/messages/batches · GET /v1/messages/batches/:id · POST /v1/messages/batches/:id/cancel · GET /v1/messages/batches/:id/results
Capability
supports.batch

Field tables per runtime · batch operations.