@makaio/ai-adapters-anthropic-sdk

Anthropic SDK AI adapter for the Makaio framework. Provides direct access to Claude models via the @anthropic-ai/sdk streaming API.

Quick Start

import { createAnthropicSdkAdapter } from '@makaio/ai-adapters-anthropic-sdk';
import { MakaioBus } from '@makaio/bus-core';
import { AdapterSubjects } from '@makaio/contracts';

const adapter = await createAnthropicSdkAdapter();

const result = await MakaioBus.request(AdapterSubjects.startAgent, {
  adapterId: adapter.adapterId,
  role: 'lead',
  initialMessage: 'Inspect this repository',
});

Architecture

Three-layer design matching the framework adapter contract:

Layer	Class	Responsibility
Domain	`AnthropicSdkAdapter`	Handles `adapter.*` bus subjects, lifecycle
Agent	`AnthropicSdkAgent`	Handles `agent.*` subjects, routes connector events
Connector	`AnthropicSdkConnector`	Owns the SDK streaming session, tool calling

The connector drives an AnthropicSdkSession and AnthropicSdkConnectorTurn pair for each user turn, streaming events into the framework event bus.

Configuration

Provider configuration is resolved from the ProviderContext supplied on adapter.startAgent and the canonical provider definitions in provider.ts. The public package root does not expose a config factory for callers to use directly.

Runtime discovery loads @makaio/ai-adapters-anthropic-sdk/server, whose default export is a MakaioExtension package descriptor with an adapters[] contribution.

Tool Approval

Tool approval is wired internally by the agent layer. The connector emits the scoped tool_approval RPC, and AnthropicSdkAgent forwards it to the global AgentSubjects.toolApprove subject with the full approval context (adapterId, adapterName, agentId, adapterSessionId, and sessionId).

Capabilities

Runtime capabilities declared by the adapter:

Capability	Meaning
`tools`	Tool/function calling support
`streaming`	Incremental stream events
`systemPrompt:override`	Replace/set the system prompt
`systemPrompt:append`	Append to the adapter’s default system prompt

Conformance-test capabilities returned by createTestConfig():

Feature	Supported
`supportsReplace`	Yes — streaming replace delivery mode
`supportsInterrupt`	Yes — `connector.interrupt()`
`supportsUsageMetrics`	Yes — token usage tracked via stream events

Conformance Testing

import { createTestConfig } from '@makaio/ai-adapters-anthropic-sdk';

// Returns a ConformanceTestConfig ready for the shared adapter test suite
const config = await createTestConfig();

File Index

File	Purpose
`src/adapter.ts`	`AnthropicSdkAdapter` and `createAnthropicSdkAdapter` factory
`src/agent.ts`	`AnthropicSdkAgent` — event routing layer
`src/connector.ts`	`AnthropicSdkConnector` — SDK streaming bridge
`src/session.ts`	`AnthropicSdkSession` — session state for a single agent run
`src/turn.ts`	`AnthropicSdkConnectorTurn` — turn state machine for one user/assistant exchange
`src/stream-bridge.ts`	Streaming event parsing bridge
`src/provider.ts`	Provider presets and model configuration
`src/config.ts`	Internal adapter config factory
`src/schemas.ts`	`AnthropicSdkProviderConfigSchema` and credential schema
`src/tool-handling.ts`	Tool approval bridging and tool format conversion
`src/definition.ts`	Internal adapter definition consumed by the package descriptor
`src/package.ts`	`MakaioExtension` package descriptor with `adapters[]` contribution
`src/server.ts`	Server entrypoint that re-exports the package descriptor as default
`src/namespaces/`	Bus namespace, subjects, and event schemas
`src/types/`	Internal type definitions
`src/utils/`	Utility functions (message history, error classification, etc.)