@autonome-research/thread-phase-agents 3.0.0

package/dist/acp/transport.js

@@ -0,0 +1,199 @@
+/**
+ * NDJSON JSON-RPC 2.0 transport over a child-process stdio pair.
+ *
+ * ACP frames messages as newline-delimited JSON — one JSON-RPC envelope
+ * per line, no Content-Length headers. The transport owns the byte-level
+ * framing, request/response correlation, and notification dispatch. The
+ * adapter layer above translates ACP-specific messages into canonical
+ * `AgentEvent`s.
+ *
+ * Single-process scope: each transport instance binds to one subprocess.
+ * Disposing it ends the child's stdin and (optionally) signals the child.
+ *
+ * @internal
+ */
+/** @internal */
+export class JsonRpcCallError extends Error {
+    method;
+    rpcError;
+    constructor(method, rpcError) {
+        super(`JSON-RPC error from ${method}: ${rpcError.message} (code ${rpcError.code})`);
+        this.method = method;
+        this.rpcError = rpcError;
+        this.name = 'JsonRpcCallError';
+    }
+}
+/**
+ * Build a transport bound to the given child's stdio. The transport
+ * starts reading immediately. Call `dispose()` to release listeners and
+ * close stdin.
+ *
+ * @internal
+ */
+export function createAcpTransport(opts) {
+    const { child, onNotification, onRequest, onTransportError } = opts;
+    const pending = new Map();
+    let nextId = 1;
+    let buffer = '';
+    let disposed = false;
+    const writeMessage = (msg) => {
+        if (disposed)
+            return;
+        const line = JSON.stringify(msg) + '\n';
+        // child.stdin is Writable; back-pressure is the caller's problem
+        // (we don't await drain — ACP messages are small). Write callback
+        // catches EPIPE etc. when the subprocess has already exited — those
+        // are surfaced via onTransportError, not as uncaught exceptions.
+        try {
+            child.stdin.write(line, (err) => {
+                if (err && !disposed)
+                    onTransportError?.(err);
+            });
+        }
+        catch (err) {
+            if (!disposed && err instanceof Error)
+                onTransportError?.(err);
+        }
+    };
+    const handleParsed = (msg) => {
+        if (!isJsonRpcMessage(msg)) {
+            onTransportError?.(new Error(`malformed JSON-RPC message: ${JSON.stringify(msg).slice(0, 200)}`));
+            return;
+        }
+        if ('id' in msg && 'method' in msg) {
+            // Request from agent to client.
+            void handleAgentRequest(msg.id, msg.method, msg.params);
+            return;
+        }
+        if ('id' in msg && ('result' in msg || 'error' in msg)) {
+            const entry = pending.get(msg.id);
+            if (!entry) {
+                // Late or unsolicited response — drop quietly. Logging would
+                // be the caller's concern if they want it.
+                return;
+            }
+            pending.delete(msg.id);
+            if ('error' in msg) {
+                entry.reject(new JsonRpcCallError(entry.method, msg.error));
+            }
+            else {
+                entry.resolve(msg.result);
+            }
+            return;
+        }
+        if ('method' in msg) {
+            // Notification from agent.
+            onNotification?.(msg.method, msg.params);
+            return;
+        }
+        onTransportError?.(new Error(`unknown JSON-RPC message shape: ${JSON.stringify(msg).slice(0, 200)}`));
+    };
+    const handleAgentRequest = async (id, method, params) => {
+        if (!onRequest) {
+            writeMessage({
+                jsonrpc: '2.0',
+                id,
+                error: { code: -32601, message: `Method not found: ${method}` },
+            });
+            return;
+        }
+        try {
+            const result = await onRequest(method, params);
+            writeMessage({ jsonrpc: '2.0', id, result });
+        }
+        catch (err) {
+            writeMessage({
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: err instanceof Error ? err.message : String(err),
+                },
+            });
+        }
+    };
+    const consumeBuffer = () => {
+        while (true) {
+            const newlineIdx = buffer.indexOf('\n');
+            if (newlineIdx === -1)
+                return;
+            const line = buffer.slice(0, newlineIdx);
+            buffer = buffer.slice(newlineIdx + 1);
+            if (line.trim().length === 0)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch (err) {
+                onTransportError?.(new Error(`JSON parse error on line: ${line.slice(0, 200)}`));
+                continue;
+            }
+            handleParsed(parsed);
+        }
+    };
+    const onStdoutData = (chunk) => {
+        buffer += typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+        consumeBuffer();
+    };
+    const onStdoutEnd = () => {
+        if (buffer.trim().length > 0)
+            consumeBuffer();
+        // Reject any still-pending requests so callers don't hang.
+        for (const [id, entry] of pending) {
+            entry.reject(new Error(`subprocess stdout closed while waiting on ${entry.method}`));
+            pending.delete(id);
+        }
+    };
+    child.stdout.setEncoding('utf8');
+    child.stdout.on('data', onStdoutData);
+    child.stdout.on('end', onStdoutEnd);
+    child.stdout.on('error', (err) => onTransportError?.(err));
+    // EPIPE / EBADF on stdin after the child exits would otherwise bubble
+    // as an uncaught exception — route to onTransportError instead.
+    child.stdin.on('error', (err) => {
+        if (!disposed)
+            onTransportError?.(err);
+    });
+    return {
+        request(method, params) {
+            if (disposed) {
+                return Promise.reject(new Error('transport disposed'));
+            }
+            const id = nextId++;
+            const promise = new Promise((resolve, reject) => {
+                pending.set(id, { resolve, reject, method });
+            });
+            writeMessage({ jsonrpc: '2.0', id, method, params });
+            return promise;
+        },
+        notify(method, params) {
+            writeMessage({ jsonrpc: '2.0', method, params });
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            child.stdout.removeListener('data', onStdoutData);
+            child.stdout.removeListener('end', onStdoutEnd);
+            try {
+                child.stdin.end();
+            }
+            catch {
+                // already closed
+            }
+            // Reject any remaining pending so callers unblock.
+            for (const [id, entry] of pending) {
+                entry.reject(new Error('transport disposed'));
+                pending.delete(id);
+            }
+        },
+    };
+}
+function isJsonRpcMessage(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'jsonrpc' in value &&
+        value.jsonrpc === '2.0');
+}
+//# sourceMappingURL=transport.js.map

package/dist/acp/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/acp/transport.ts"],"names":[],"mappings":"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"}

package/dist/acp/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Agent Client Protocol — TypeScript types for the subset this chassis
+ * implements. Faithful to the ACP spec at
+ * https://agentclientprotocol.com/protocol — field names are literal.
+ *
+ * We model only the messages the chassis sends or receives: initialize,
+ * session/new, session/prompt, session/update notifications, and
+ * session/cancel. Optional features (filesystem ops, terminals,
+ * session/request_permission, MCP transport configuration) are out of
+ * scope for v1 and surface as `native` events when encountered.
+ *
+ * @internal
+ */
+/** Negotiated at initialize time; the spec is currently at v1. */
+export declare const ACP_PROTOCOL_VERSION = 1;
+export type SessionId = string;
+export interface Implementation {
+    name: string;
+    version: string;
+}
+export interface ClientCapabilities {
+    fs?: {
+        readTextFile?: boolean;
+        writeTextFile?: boolean;
+    };
+    terminal?: boolean;
+}
+export interface AgentCapabilities {
+    promptCapabilities?: {
+        image?: boolean;
+        audio?: boolean;
+        embeddedContext?: boolean;
+    };
+    loadSession?: boolean;
+    [key: string]: unknown;
+}
+export interface AuthMethod {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface InitializeRequest {
+    protocolVersion: number;
+    clientInfo?: Implementation;
+    clientCapabilities?: ClientCapabilities;
+}
+export interface InitializeResponse {
+    protocolVersion: number;
+    agentInfo?: Implementation;
+    agentCapabilities?: AgentCapabilities;
+    authMethods?: AuthMethod[];
+}
+export interface McpServer {
+    name?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface NewSessionRequest {
+    cwd: string;
+    mcpServers: McpServer[];
+}
+export interface NewSessionResponse {
+    sessionId: SessionId;
+}
+export interface LoadSessionRequest {
+    sessionId: SessionId;
+    cwd: string;
+    mcpServers: McpServer[];
+}
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+    uri?: string;
+} | {
+    type: 'audio';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    mimeType?: string;
+} | {
+    type: 'resource';
+    resource: unknown;
+};
+/** Extract plain text from a single content block (best-effort). */
+export declare function contentBlockToText(block: ContentBlock): string;
+export interface PromptRequest {
+    sessionId: SessionId;
+    prompt: ContentBlock[];
+}
+export type StopReason = 'end_turn' | 'max_tokens' | 'max_turn_requests' | 'refusal' | 'cancelled';
+export interface PromptResponse {
+    stopReason: StopReason;
+}
+export type ToolCallStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Known session/update variants. Unknown variants (future versions, vendor
+ * extensions) are represented at runtime by the same shape with an
+ * unrecognized `sessionUpdate` string — the adapter routes those to
+ * `native` events without narrowing.
+ */
+export type SessionUpdate = {
+    sessionUpdate: 'agent_message_chunk';
+    content: ContentBlock;
+} | {
+    sessionUpdate: 'agent_thought_chunk';
+    content: ContentBlock;
+} | {
+    sessionUpdate: 'user_message_chunk';
+    content: ContentBlock;
+} | {
+    sessionUpdate: 'tool_call';
+    toolCallId: string;
+    title?: string;
+    kind?: string;
+    status?: ToolCallStatus;
+    content?: ContentBlock[];
+    rawInput?: unknown;
+} | {
+    sessionUpdate: 'tool_call_update';
+    toolCallId: string;
+    status?: ToolCallStatus;
+    content?: ContentBlock[];
+    title?: string;
+    rawInput?: unknown;
+    rawOutput?: unknown;
+} | {
+    sessionUpdate: 'plan';
+    entries?: unknown[];
+} | {
+    sessionUpdate: 'mode';
+    mode?: unknown;
+};
+export interface SessionNotificationParams {
+    sessionId: SessionId;
+    update: SessionUpdate;
+}
+export interface CancelNotificationParams {
+    sessionId: SessionId;
+}
+export declare const ACP_METHODS: {
+    readonly initialize: "initialize";
+    readonly newSession: "session/new";
+    readonly loadSession: "session/load";
+    readonly prompt: "session/prompt";
+    readonly cancel: "session/cancel";
+    readonly sessionUpdate: "session/update";
+    readonly requestPermission: "session/request_permission";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/acp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/acp/types.ts"],"names":[],"mappings":"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"}

package/dist/acp/types.js

@@ -0,0 +1,34 @@
+/**
+ * Agent Client Protocol — TypeScript types for the subset this chassis
+ * implements. Faithful to the ACP spec at
+ * https://agentclientprotocol.com/protocol — field names are literal.
+ *
+ * We model only the messages the chassis sends or receives: initialize,
+ * session/new, session/prompt, session/update notifications, and
+ * session/cancel. Optional features (filesystem ops, terminals,
+ * session/request_permission, MCP transport configuration) are out of
+ * scope for v1 and surface as `native` events when encountered.
+ *
+ * @internal
+ */
+/** Negotiated at initialize time; the spec is currently at v1. */
+export const ACP_PROTOCOL_VERSION = 1;
+/** Extract plain text from a single content block (best-effort). */
+export function contentBlockToText(block) {
+    if (block.type === 'text')
+        return block.text;
+    if (block.type === 'resource_link')
+        return `[resource: ${block.name} (${block.uri})]`;
+    return `[${block.type}]`;
+}
+// --- ACP method names (string literals so call sites are uniform) ---
+export const ACP_METHODS = {
+    initialize: 'initialize',
+    newSession: 'session/new',
+    loadSession: 'session/load',
+    prompt: 'session/prompt',
+    cancel: 'session/cancel',
+    sessionUpdate: 'session/update',
+    requestPermission: 'session/request_permission',
+};
+//# sourceMappingURL=types.js.map

package/dist/acp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/acp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AA8EtC,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,cAAc,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC;IACtF,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;AAC3B,CAAC;AAuED,uEAAuE;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,cAAc;IAC3B,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,gBAAgB;IACxB,aAAa,EAAE,gBAAgB;IAC/B,iBAAiB,EAAE,4BAA4B;CACvC,CAAC"}

package/dist/anthropic/adapter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Anthropic adapter — in-process via `@anthropic-ai/sdk`.
+ *
+ * Single-turn. The adapter streams from `client.messages.stream(...)`,
+ * translates Anthropic's RawMessageStreamEvent union to canonical
+ * `AgentEvent`s, and returns when the stream ends. Tool-use loops are
+ * the caller's responsibility — the adapter surfaces `tool_call` events
+ * but does not execute tools; on subsequent calls the caller passes the
+ * tool result back in `messages` as a user `tool_result` block.
+ *
+ * Capabilities:
+ *   streaming        'text'
+ *   cancellation     'cooperative'  (Anthropic SDK accepts an AbortSignal)
+ *   resumption       'none'         (no native session id; pass history)
+ *   structuredOutput 'prompted'     (uses thread-phase's <response> parser)
+ *
+ * Extended thinking surfaces as canonical `thinking` events. Vision /
+ * citations / cache-control blocks pass through transparently in
+ * config.messages; we don't intercept them.
+ *
+ * @internal
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import type { MessageParam, Tool as AnthropicTool, ToolChoice, ThinkingConfigParam } from '@anthropic-ai/sdk/resources/messages.js';
+import { type AgentAdapterMeta, type StructuredOutputConfig } from '@autonome-research/thread-phase/agents';
+/** @internal */
+export interface AnthropicAgentConfig {
+    /** Model name, e.g. 'claude-opus-4-7' or 'claude-sonnet-4-6'. */
+    model: string;
+    /** Conversation messages. The adapter prepends/appends nothing. */
+    messages: MessageParam[];
+    /** System prompt. */
+    systemPrompt?: string;
+    /** Optional tools the model may call. The adapter emits tool_call events; the caller executes and feeds tool_result back on the next call. */
+    tools?: AnthropicTool[];
+    /** Tool-choice control. */
+    toolChoice?: ToolChoice;
+    /** max_tokens — default 4096. */
+    maxTokens?: number;
+    /** Temperature. */
+    temperature?: number;
+    /** Optional thinking config (extended thinking). */
+    thinking?: ThinkingConfigParam;
+    /** Optional pre-built client. Useful for DI in tests. */
+    client?: Anthropic;
+    /** API key. Defaults to ANTHROPIC_API_KEY env var. */
+    apiKey?: string;
+    /** Base URL override. */
+    baseURL?: string;
+    /** Optional structured-output spec (prompted path). */
+    outputSchema?: StructuredOutputConfig;
+}
+/** @internal */
+export declare const anthropicAgent: AgentAdapterMeta<AnthropicAgentConfig>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/anthropic/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/anthropic/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EACV,YAAY,EACZ,IAAI,IAAI,aAAa,EACrB,UAAU,EAEV,mBAAmB,EACpB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EASL,KAAK,gBAAgB,EAKrB,KAAK,sBAAsB,EAC5B,MAAM,wCAAwC,CAAC;AAKhD,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8IAA8I;IAC9I,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,yDAAyD;IACzD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED,gBAAgB;AAChB,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAAC,oBAAoB,CAShE,CAAC"}