@contractspec/lib.ai-agent 1.45.6 → 1.46.0

package/dist/providers/claude-agent-sdk/index.d.ts

@@ -0,0 +1,4 @@
+import { ClaudeAgentSDKProvider } from "./adapter.js";
+import { ClaudeAgentTool, ClaudeAgentToolResult, ClaudeAgentToolResultContent, claudeAgentToolToSpecTool, claudeAgentToolsToSpecTools, extractToolCalls, specToolToClaudeAgentTool, specToolToExternalTool, specToolsToClaudeAgentTools } from "./tool-bridge.js";
+import { ClaudeAgentContentBlock, ClaudeAgentMessage, ClaudeAgentSession, ClaudeAgentSessionState, appendAssistantMessage, appendUserMessage, buildClaudeAgentContext, clearSession, createClaudeAgentSession, createEmptyClaudeSession, createToolResultBlock, estimateTokens, extractToolUseBlocks, getMessageCount, getRecentMessages, summarizeSession, toClaudeAgentSession, updateSessionMetadata } from "./session-bridge.js";
+export { ClaudeAgentContentBlock, ClaudeAgentMessage, ClaudeAgentSDKProvider, ClaudeAgentSession, ClaudeAgentSessionState, ClaudeAgentTool, ClaudeAgentToolResult, ClaudeAgentToolResultContent, appendAssistantMessage, appendUserMessage, buildClaudeAgentContext, claudeAgentToolToSpecTool, claudeAgentToolsToSpecTools, clearSession, createClaudeAgentSession, createEmptyClaudeSession, createToolResultBlock, estimateTokens, extractToolCalls, extractToolUseBlocks, getMessageCount, getRecentMessages, specToolToClaudeAgentTool, specToolToExternalTool, specToolsToClaudeAgentTools, summarizeSession, toClaudeAgentSession, updateSessionMetadata };

package/dist/providers/claude-agent-sdk/index.js

@@ -0,0 +1,5 @@
+import { claudeAgentToolToSpecTool, claudeAgentToolsToSpecTools, extractToolCalls, specToolToClaudeAgentTool, specToolToExternalTool, specToolsToClaudeAgentTools } from "./tool-bridge.js";
+import { appendAssistantMessage, appendUserMessage, buildClaudeAgentContext, clearSession, createClaudeAgentSession, createEmptyClaudeSession, createToolResultBlock, estimateTokens, extractToolUseBlocks, getMessageCount, getRecentMessages, summarizeSession, toClaudeAgentSession, updateSessionMetadata } from "./session-bridge.js";
+import { ClaudeAgentSDKProvider } from "./adapter.js";
+
+export { ClaudeAgentSDKProvider, appendAssistantMessage, appendUserMessage, buildClaudeAgentContext, claudeAgentToolToSpecTool, claudeAgentToolsToSpecTools, clearSession, createClaudeAgentSession, createEmptyClaudeSession, createToolResultBlock, estimateTokens, extractToolCalls, extractToolUseBlocks, getMessageCount, getRecentMessages, specToolToClaudeAgentTool, specToolToExternalTool, specToolsToClaudeAgentTools, summarizeSession, toClaudeAgentSession, updateSessionMetadata };

package/dist/providers/claude-agent-sdk/session-bridge.d.ts

@@ -0,0 +1,101 @@
+import { AgentCallOptions, AgentSessionState } from "../../types.js";
+
+//#region src/providers/claude-agent-sdk/session-bridge.d.ts
+
+/**
+ * Claude Agent SDK content block (text or tool use).
+ */
+interface ClaudeAgentContentBlock {
+  type: 'text' | 'tool_use' | 'tool_result';
+  text?: string;
+  id?: string;
+  name?: string;
+  input?: unknown;
+  tool_use_id?: string;
+  content?: string | ClaudeAgentContentBlock[];
+  is_error?: boolean;
+}
+/**
+ * Claude Agent SDK message format.
+ */
+interface ClaudeAgentMessage {
+  role: 'user' | 'assistant';
+  content: string | ClaudeAgentContentBlock[];
+}
+/**
+ * Claude Agent SDK session state.
+ */
+interface ClaudeAgentSession {
+  sessionId?: string;
+  messages: ClaudeAgentMessage[];
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Claude Agent SDK session state (alias).
+ */
+type ClaudeAgentSessionState = ClaudeAgentSession;
+/**
+ * Convert ContractSpec session to Claude Agent SDK session.
+ */
+declare function toClaudeAgentSession(state: AgentSessionState): ClaudeAgentSession;
+/**
+ * Create a new Claude Agent session from call options.
+ */
+declare function createClaudeAgentSession(options?: AgentCallOptions): ClaudeAgentSession;
+/**
+ * Create an empty Claude Agent session.
+ */
+declare function createEmptyClaudeSession(): ClaudeAgentSession;
+/**
+ * Build Claude Agent context metadata from call options.
+ */
+declare function buildClaudeAgentContext(options?: AgentCallOptions): Record<string, unknown>;
+/**
+ * Append a user message to the session.
+ */
+declare function appendUserMessage(session: ClaudeAgentSession, content: string): ClaudeAgentSession;
+/**
+ * Append an assistant message to the session.
+ */
+declare function appendAssistantMessage(session: ClaudeAgentSession, content: string | ClaudeAgentContentBlock[]): ClaudeAgentSession;
+/**
+ * Clear the session history.
+ */
+declare function clearSession(session: ClaudeAgentSession): ClaudeAgentSession;
+/**
+ * Get the last N messages from the session.
+ */
+declare function getRecentMessages(session: ClaudeAgentSession, count: number): ClaudeAgentMessage[];
+/**
+ * Extract tool calls from a message content.
+ */
+declare function extractToolUseBlocks(content: string | ClaudeAgentContentBlock[]): ClaudeAgentContentBlock[];
+/**
+ * Create a tool result block.
+ */
+declare function createToolResultBlock(toolUseId: string, result: unknown, isError?: boolean): ClaudeAgentContentBlock;
+/**
+ * Update session metadata.
+ */
+declare function updateSessionMetadata(session: ClaudeAgentSession, metadata: Record<string, unknown>): ClaudeAgentSession;
+/**
+ * Get session message count.
+ */
+declare function getMessageCount(session: ClaudeAgentSession): number;
+/**
+ * Get the total token estimate for the session.
+ * This is a rough estimate based on character count.
+ */
+declare function estimateTokens(session: ClaudeAgentSession): number;
+/**
+ * Summarize the session for logging.
+ */
+declare function summarizeSession(session: ClaudeAgentSession): {
+  messageCount: number;
+  userMessages: number;
+  assistantMessages: number;
+  estimatedTokens: number;
+};
+//#endregion
+export { ClaudeAgentContentBlock, ClaudeAgentMessage, ClaudeAgentSession, ClaudeAgentSessionState, appendAssistantMessage, appendUserMessage, buildClaudeAgentContext, clearSession, createClaudeAgentSession, createEmptyClaudeSession, createToolResultBlock, estimateTokens, extractToolUseBlocks, getMessageCount, getRecentMessages, summarizeSession, toClaudeAgentSession, updateSessionMetadata };
+//# sourceMappingURL=session-bridge.d.ts.map

package/dist/providers/claude-agent-sdk/session-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bridge.d.ts","names":[],"sources":["../../../src/providers/claude-agent-sdk/session-bridge.ts"],"sourcesContent":[],"mappings":";;;;AAwFA;AAiBA;AAOA;AAcgB,UA9GC,uBAAA,CA+GN;EAYK,IAAA,EAAA,MAAA,GAAA,UAAsB,GAAA,aAAA;EAC3B,IAAA,CAAA,EAAA,MAAA;EACS,EAAA,CAAA,EAAA,MAAA;EACjB,IAAA,CAAA,EAAA,MAAA;EAAkB,KAAA,CAAA,EAAA,OAAA;EAUL,WAAA,CAAA,EAAA,MAAY;EAUZ,OAAA,CAAA,EAAA,MAAA,GA3IK,uBA4IV,EAAA;EASK,QAAA,CAAA,EAAA,OAAA;AAYhB;AAoBA;;;AAGG,UAjLc,kBAAA,CAiLd;EAAkB,IAAA,EAAA,MAAA,GAAA,WAAA;EAaL,OAAA,EAAA,MAAA,GA5LI,uBA4LqB,EAAA;AAQzC;AAgBA;;;UA9MiB,kBAAA;;YAEL;aACC;;;;;KAUD,uBAAA,GAA0B;;;;iBAKtB,oBAAA,QACP,oBACN;;;;iBA8Ba,wBAAA,WACJ,mBACT;;;;iBAea,wBAAA,CAAA,GAA4B;;;;iBAO5B,uBAAA,WACJ,mBACT;;;;iBAYa,iBAAA,UACL,sCAER;;;;iBAUa,sBAAA,UACL,sCACS,4BACjB;;;;iBAUa,YAAA,UAAsB,qBAAqB;;;;iBAU3C,iBAAA,UACL,oCAER;;;;iBAOa,oBAAA,mBACI,4BACjB;;;;iBAUa,qBAAA,yDAIb;;;;iBAgBa,qBAAA,UACL,8BACC,0BACT;;;;iBAaa,eAAA,UAAyB;;;;;iBAQzB,cAAA,UAAwB;;;;iBAgBxB,gBAAA,UAA0B"}

package/dist/providers/claude-agent-sdk/session-bridge.js

@@ -0,0 +1,158 @@
+//#region src/providers/claude-agent-sdk/session-bridge.ts
+/**
+* Convert ContractSpec session to Claude Agent SDK session.
+*/
+function toClaudeAgentSession(state) {
+	const messages = [];
+	for (const msg of state.messages) if (msg.role === "user" || msg.role === "assistant") {
+		const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+		messages.push({
+			role: msg.role,
+			content
+		});
+	}
+	return {
+		sessionId: state.sessionId,
+		messages,
+		metadata: {
+			agentId: state.agentId,
+			tenantId: state.tenantId,
+			actorId: state.actorId
+		}
+	};
+}
+/**
+* Create a new Claude Agent session from call options.
+*/
+function createClaudeAgentSession(options) {
+	return {
+		sessionId: options?.sessionId,
+		messages: [],
+		metadata: {
+			tenantId: options?.tenantId,
+			actorId: options?.actorId,
+			...options?.metadata
+		}
+	};
+}
+/**
+* Create an empty Claude Agent session.
+*/
+function createEmptyClaudeSession() {
+	return createClaudeAgentSession();
+}
+/**
+* Build Claude Agent context metadata from call options.
+*/
+function buildClaudeAgentContext(options) {
+	return {
+		tenantId: options?.tenantId,
+		actorId: options?.actorId,
+		sessionId: options?.sessionId,
+		...options?.metadata
+	};
+}
+/**
+* Append a user message to the session.
+*/
+function appendUserMessage(session, content) {
+	return {
+		...session,
+		messages: [...session.messages, {
+			role: "user",
+			content
+		}]
+	};
+}
+/**
+* Append an assistant message to the session.
+*/
+function appendAssistantMessage(session, content) {
+	return {
+		...session,
+		messages: [...session.messages, {
+			role: "assistant",
+			content
+		}]
+	};
+}
+/**
+* Clear the session history.
+*/
+function clearSession(session) {
+	return {
+		...session,
+		messages: []
+	};
+}
+/**
+* Get the last N messages from the session.
+*/
+function getRecentMessages(session, count) {
+	return session.messages.slice(-count);
+}
+/**
+* Extract tool calls from a message content.
+*/
+function extractToolUseBlocks(content) {
+	if (typeof content === "string") return [];
+	return content.filter((block) => block.type === "tool_use");
+}
+/**
+* Create a tool result block.
+*/
+function createToolResultBlock(toolUseId, result, isError = false) {
+	return {
+		type: "tool_result",
+		tool_use_id: toolUseId,
+		content: typeof result === "string" ? result : JSON.stringify(result),
+		is_error: isError
+	};
+}
+/**
+* Update session metadata.
+*/
+function updateSessionMetadata(session, metadata) {
+	return {
+		...session,
+		metadata: {
+			...session.metadata,
+			...metadata
+		}
+	};
+}
+/**
+* Get session message count.
+*/
+function getMessageCount(session) {
+	return session.messages.length;
+}
+/**
+* Get the total token estimate for the session.
+* This is a rough estimate based on character count.
+*/
+function estimateTokens(session) {
+	let chars = 0;
+	for (const msg of session.messages) if (typeof msg.content === "string") chars += msg.content.length;
+	else chars += JSON.stringify(msg.content).length;
+	return Math.ceil(chars / 4);
+}
+/**
+* Summarize the session for logging.
+*/
+function summarizeSession(session) {
+	let userMessages = 0;
+	let assistantMessages = 0;
+	for (const msg of session.messages) if (msg.role === "user") userMessages++;
+	else assistantMessages++;
+	return {
+		messageCount: session.messages.length,
+		userMessages,
+		assistantMessages,
+		estimatedTokens: estimateTokens(session)
+	};
+}
+
+//#endregion
+export { appendAssistantMessage, appendUserMessage, buildClaudeAgentContext, clearSession, createClaudeAgentSession, createEmptyClaudeSession, createToolResultBlock, estimateTokens, extractToolUseBlocks, getMessageCount, getRecentMessages, summarizeSession, toClaudeAgentSession, updateSessionMetadata };
+//# sourceMappingURL=session-bridge.js.map

package/dist/providers/claude-agent-sdk/session-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bridge.js","names":["messages: ClaudeAgentMessage[]"],"sources":["../../../src/providers/claude-agent-sdk/session-bridge.ts"],"sourcesContent":["/**\n * Session bridge for mapping between ContractSpec and Claude Agent SDK sessions.\n *\n * Handles session state synchronization, message history conversion,\n * and context preservation across the two systems.\n */\nimport type { AgentSessionState } from '../../types';\nimport type { AgentCallOptions } from '../../types';\n\n// =============================================================================\n// Claude Agent SDK Session Types\n// =============================================================================\n\n/**\n * Claude Agent SDK content block (text or tool use).\n */\nexport interface ClaudeAgentContentBlock {\n  type: 'text' | 'tool_use' | 'tool_result';\n  text?: string;\n  id?: string;\n  name?: string;\n  input?: unknown;\n  tool_use_id?: string;\n  content?: string | ClaudeAgentContentBlock[];\n  is_error?: boolean;\n}\n\n/**\n * Claude Agent SDK message format.\n */\nexport interface ClaudeAgentMessage {\n  role: 'user' | 'assistant';\n  content: string | ClaudeAgentContentBlock[];\n}\n\n/**\n * Claude Agent SDK session state.\n */\nexport interface ClaudeAgentSession {\n  sessionId?: string;\n  messages: ClaudeAgentMessage[];\n  metadata?: Record<string, unknown>;\n}\n\n// =============================================================================\n// Session Conversion\n// =============================================================================\n\n/**\n * Claude Agent SDK session state (alias).\n */\nexport type ClaudeAgentSessionState = ClaudeAgentSession;\n\n/**\n * Convert ContractSpec session to Claude Agent SDK session.\n */\nexport function toClaudeAgentSession(\n  state: AgentSessionState\n): ClaudeAgentSession {\n  const messages: ClaudeAgentMessage[] = [];\n\n  for (const msg of state.messages) {\n    if (msg.role === 'user' || msg.role === 'assistant') {\n      const content =\n        typeof msg.content === 'string'\n          ? msg.content\n          : JSON.stringify(msg.content);\n      messages.push({\n        role: msg.role,\n        content,\n      });\n    }\n  }\n\n  return {\n    sessionId: state.sessionId,\n    messages,\n    metadata: {\n      agentId: state.agentId,\n      tenantId: state.tenantId,\n      actorId: state.actorId,\n    },\n  };\n}\n\n/**\n * Create a new Claude Agent session from call options.\n */\nexport function createClaudeAgentSession(\n  options?: AgentCallOptions\n): ClaudeAgentSession {\n  return {\n    sessionId: options?.sessionId,\n    messages: [],\n    metadata: {\n      tenantId: options?.tenantId,\n      actorId: options?.actorId,\n      ...options?.metadata,\n    },\n  };\n}\n\n/**\n * Create an empty Claude Agent session.\n */\nexport function createEmptyClaudeSession(): ClaudeAgentSession {\n  return createClaudeAgentSession();\n}\n\n/**\n * Build Claude Agent context metadata from call options.\n */\nexport function buildClaudeAgentContext(\n  options?: AgentCallOptions\n): Record<string, unknown> {\n  return {\n    tenantId: options?.tenantId,\n    actorId: options?.actorId,\n    sessionId: options?.sessionId,\n    ...options?.metadata,\n  };\n}\n\n/**\n * Append a user message to the session.\n */\nexport function appendUserMessage(\n  session: ClaudeAgentSession,\n  content: string\n): ClaudeAgentSession {\n  return {\n    ...session,\n    messages: [...session.messages, { role: 'user', content }],\n  };\n}\n\n/**\n * Append an assistant message to the session.\n */\nexport function appendAssistantMessage(\n  session: ClaudeAgentSession,\n  content: string | ClaudeAgentContentBlock[]\n): ClaudeAgentSession {\n  return {\n    ...session,\n    messages: [...session.messages, { role: 'assistant', content }],\n  };\n}\n\n/**\n * Clear the session history.\n */\nexport function clearSession(session: ClaudeAgentSession): ClaudeAgentSession {\n  return {\n    ...session,\n    messages: [],\n  };\n}\n\n/**\n * Get the last N messages from the session.\n */\nexport function getRecentMessages(\n  session: ClaudeAgentSession,\n  count: number\n): ClaudeAgentMessage[] {\n  return session.messages.slice(-count);\n}\n\n/**\n * Extract tool calls from a message content.\n */\nexport function extractToolUseBlocks(\n  content: string | ClaudeAgentContentBlock[]\n): ClaudeAgentContentBlock[] {\n  if (typeof content === 'string') {\n    return [];\n  }\n  return content.filter((block) => block.type === 'tool_use');\n}\n\n/**\n * Create a tool result block.\n */\nexport function createToolResultBlock(\n  toolUseId: string,\n  result: unknown,\n  isError = false\n): ClaudeAgentContentBlock {\n  return {\n    type: 'tool_result',\n    tool_use_id: toolUseId,\n    content: typeof result === 'string' ? result : JSON.stringify(result),\n    is_error: isError,\n  };\n}\n\n// =============================================================================\n// Session Metadata\n// =============================================================================\n\n/**\n * Update session metadata.\n */\nexport function updateSessionMetadata(\n  session: ClaudeAgentSession,\n  metadata: Record<string, unknown>\n): ClaudeAgentSession {\n  return {\n    ...session,\n    metadata: {\n      ...session.metadata,\n      ...metadata,\n    },\n  };\n}\n\n/**\n * Get session message count.\n */\nexport function getMessageCount(session: ClaudeAgentSession): number {\n  return session.messages.length;\n}\n\n/**\n * Get the total token estimate for the session.\n * This is a rough estimate based on character count.\n */\nexport function estimateTokens(session: ClaudeAgentSession): number {\n  let chars = 0;\n  for (const msg of session.messages) {\n    if (typeof msg.content === 'string') {\n      chars += msg.content.length;\n    } else {\n      chars += JSON.stringify(msg.content).length;\n    }\n  }\n  // Rough estimate: ~4 chars per token\n  return Math.ceil(chars / 4);\n}\n\n/**\n * Summarize the session for logging.\n */\nexport function summarizeSession(session: ClaudeAgentSession): {\n  messageCount: number;\n  userMessages: number;\n  assistantMessages: number;\n  estimatedTokens: number;\n} {\n  let userMessages = 0;\n  let assistantMessages = 0;\n\n  for (const msg of session.messages) {\n    if (msg.role === 'user') {\n      userMessages++;\n    } else {\n      assistantMessages++;\n    }\n  }\n\n  return {\n    messageCount: session.messages.length,\n    userMessages,\n    assistantMessages,\n    estimatedTokens: estimateTokens(session),\n  };\n}\n"],"mappings":";;;;AAwDA,SAAgB,qBACd,OACoB;CACpB,MAAMA,WAAiC,EAAE;AAEzC,MAAK,MAAM,OAAO,MAAM,SACtB,KAAI,IAAI,SAAS,UAAU,IAAI,SAAS,aAAa;EACnD,MAAM,UACJ,OAAO,IAAI,YAAY,WACnB,IAAI,UACJ,KAAK,UAAU,IAAI,QAAQ;AACjC,WAAS,KAAK;GACZ,MAAM,IAAI;GACV;GACD,CAAC;;AAIN,QAAO;EACL,WAAW,MAAM;EACjB;EACA,UAAU;GACR,SAAS,MAAM;GACf,UAAU,MAAM;GAChB,SAAS,MAAM;GAChB;EACF;;;;;AAMH,SAAgB,yBACd,SACoB;AACpB,QAAO;EACL,WAAW,SAAS;EACpB,UAAU,EAAE;EACZ,UAAU;GACR,UAAU,SAAS;GACnB,SAAS,SAAS;GAClB,GAAG,SAAS;GACb;EACF;;;;;AAMH,SAAgB,2BAA+C;AAC7D,QAAO,0BAA0B;;;;;AAMnC,SAAgB,wBACd,SACyB;AACzB,QAAO;EACL,UAAU,SAAS;EACnB,SAAS,SAAS;EAClB,WAAW,SAAS;EACpB,GAAG,SAAS;EACb;;;;;AAMH,SAAgB,kBACd,SACA,SACoB;AACpB,QAAO;EACL,GAAG;EACH,UAAU,CAAC,GAAG,QAAQ,UAAU;GAAE,MAAM;GAAQ;GAAS,CAAC;EAC3D;;;;;AAMH,SAAgB,uBACd,SACA,SACoB;AACpB,QAAO;EACL,GAAG;EACH,UAAU,CAAC,GAAG,QAAQ,UAAU;GAAE,MAAM;GAAa;GAAS,CAAC;EAChE;;;;;AAMH,SAAgB,aAAa,SAAiD;AAC5E,QAAO;EACL,GAAG;EACH,UAAU,EAAE;EACb;;;;;AAMH,SAAgB,kBACd,SACA,OACsB;AACtB,QAAO,QAAQ,SAAS,MAAM,CAAC,MAAM;;;;;AAMvC,SAAgB,qBACd,SAC2B;AAC3B,KAAI,OAAO,YAAY,SACrB,QAAO,EAAE;AAEX,QAAO,QAAQ,QAAQ,UAAU,MAAM,SAAS,WAAW;;;;;AAM7D,SAAgB,sBACd,WACA,QACA,UAAU,OACe;AACzB,QAAO;EACL,MAAM;EACN,aAAa;EACb,SAAS,OAAO,WAAW,WAAW,SAAS,KAAK,UAAU,OAAO;EACrE,UAAU;EACX;;;;;AAUH,SAAgB,sBACd,SACA,UACoB;AACpB,QAAO;EACL,GAAG;EACH,UAAU;GACR,GAAG,QAAQ;GACX,GAAG;GACJ;EACF;;;;;AAMH,SAAgB,gBAAgB,SAAqC;AACnE,QAAO,QAAQ,SAAS;;;;;;AAO1B,SAAgB,eAAe,SAAqC;CAClE,IAAI,QAAQ;AACZ,MAAK,MAAM,OAAO,QAAQ,SACxB,KAAI,OAAO,IAAI,YAAY,SACzB,UAAS,IAAI,QAAQ;KAErB,UAAS,KAAK,UAAU,IAAI,QAAQ,CAAC;AAIzC,QAAO,KAAK,KAAK,QAAQ,EAAE;;;;;AAM7B,SAAgB,iBAAiB,SAK/B;CACA,IAAI,eAAe;CACnB,IAAI,oBAAoB;AAExB,MAAK,MAAM,OAAO,QAAQ,SACxB,KAAI,IAAI,SAAS,OACf;KAEA;AAIJ,QAAO;EACL,cAAc,QAAQ,SAAS;EAC/B;EACA;EACA,iBAAiB,eAAe,QAAQ;EACzC"}

package/dist/providers/claude-agent-sdk/tool-bridge.d.ts

@@ -0,0 +1,110 @@
+import { AgentToolConfig } from "../../spec/spec.js";
+import { ToolExecutionContext, ToolHandler } from "../../types.js";
+import { ExternalToolDefinition } from "../types.js";
+
+//#region src/providers/claude-agent-sdk/tool-bridge.d.ts
+
+/**
+ * Claude Agent SDK tool definition.
+ * Based on Anthropic's tool format.
+ */
+interface ClaudeAgentTool {
+  /** Tool name */
+  name: string;
+  /** Tool description */
+  description: string;
+  /** Input schema in JSON Schema format */
+  input_schema: {
+    type: 'object';
+    properties?: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean;
+  };
+  /** Whether tool requires confirmation before execution */
+  requires_confirmation?: boolean;
+  /** Tool category for organization */
+  category?: string;
+}
+/**
+ * Claude Agent SDK tool result.
+ */
+interface ClaudeAgentToolResult {
+  /** Tool call ID this result corresponds to */
+  tool_use_id: string;
+  /** Result content */
+  content: string | ClaudeAgentToolResultContent[];
+  /** Whether the tool execution failed */
+  is_error?: boolean;
+}
+/**
+ * Claude Agent SDK tool result content block.
+ */
+interface ClaudeAgentToolResultContent {
+  type: 'text' | 'image';
+  text?: string;
+  source?: {
+    type: 'base64';
+    media_type: string;
+    data: string;
+  };
+}
+/**
+ * Convert a ContractSpec AgentToolConfig to Claude Agent SDK tool format.
+ *
+ * @param tool - ContractSpec tool configuration
+ * @param handler - Tool handler function
+ * @param context - Partial execution context to inject
+ * @returns Claude Agent SDK tool definition with execute function
+ */
+declare function specToolToClaudeAgentTool(tool: AgentToolConfig, handler: ToolHandler, context: Partial<ToolExecutionContext>): ClaudeAgentTool & {
+  execute: (input: unknown) => Promise<unknown>;
+};
+/**
+ * Convert multiple ContractSpec tools to Claude Agent SDK format.
+ */
+declare function specToolsToClaudeAgentTools(tools: AgentToolConfig[], handlers: Map<string, ToolHandler>, context: Partial<ToolExecutionContext>): (ClaudeAgentTool & {
+  execute: (input: unknown) => Promise<unknown>;
+})[];
+/**
+ * Convert a Claude Agent SDK tool to ContractSpec AgentToolConfig.
+ * This enables importing tools defined in Claude Agent SDK format.
+ *
+ * @param claudeTool - Claude Agent SDK tool definition
+ * @param execute - Optional execute function to wrap
+ * @returns ContractSpec tool config and optional handler
+ */
+declare function claudeAgentToolToSpecTool(claudeTool: ClaudeAgentTool, execute?: (input: unknown) => Promise<unknown>): {
+  config: AgentToolConfig;
+  handler?: ToolHandler;
+};
+/**
+ * Convert multiple Claude Agent SDK tools to ContractSpec format.
+ */
+declare function claudeAgentToolsToSpecTools(claudeTools: (ClaudeAgentTool & {
+  execute?: (input: unknown) => Promise<unknown>;
+})[]): {
+  configs: AgentToolConfig[];
+  handlers: Map<string, ToolHandler>;
+};
+/**
+ * Convert ContractSpec tool to ExternalToolDefinition format.
+ */
+declare function specToolToExternalTool(tool: AgentToolConfig, handler?: ToolHandler, context?: Partial<ToolExecutionContext>): ExternalToolDefinition;
+/**
+ * Extract tool call info from Claude Agent SDK response.
+ */
+declare function extractToolCalls(response: {
+  content?: {
+    type: string;
+    id?: string;
+    name?: string;
+    input?: unknown;
+  }[];
+}): {
+  toolCallId: string;
+  toolName: string;
+  args: unknown;
+}[];
+//#endregion
+export { ClaudeAgentTool, ClaudeAgentToolResult, ClaudeAgentToolResultContent, claudeAgentToolToSpecTool, claudeAgentToolsToSpecTools, extractToolCalls, specToolToClaudeAgentTool, specToolToExternalTool, specToolsToClaudeAgentTools };
+//# sourceMappingURL=tool-bridge.d.ts.map

package/dist/providers/claude-agent-sdk/tool-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.d.ts","names":[],"sources":["../../../src/providers/claude-agent-sdk/tool-bridge.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA+EoD,UA3DnC,eAAA,CA2DmC;EAAO;EAuB3C,IAAA,EAAA,MAAA;EACP;EACe,WAAA,EAAA,MAAA;EAAZ;EACO,YAAA,EAAA;IAAR,IAAA,EAAA,QAAA;IACP,UAAA,CAAA,EA9Ea,MA8Eb,CAAA,MAAA,EAAA,OAAA,CAAA;IAAiD,QAAA,CAAA,EAAA,MAAA,EAAA;IAAO,oBAAA,CAAA,EAAA,OAAA;EAwB5C,CAAA;EACF;EACkB,qBAAA,CAAA,EAAA,OAAA;EAEtB;EACE,QAAA,CAAA,EAAA,MAAA;;AAoBZ;;;AAKW,UAvHM,qBAAA,CAuHN;EACa;EAAZ,WAAA,EAAA,MAAA;EAAG;EA0BC,OAAA,EAAA,MAAA,GA9II,4BA8IkB,EAAA;EAC9B;EACI,QAAA,CAAA,EAAA,OAAA;;;;;AAyDI,UAjMC,4BAAA,CAiMe;;;;;;;;;;;;;;;;;iBA3KhB,yBAAA,OACR,0BACG,sBACA,QAAQ,wBAChB;+BAAiD;;;;;iBAuBpC,2BAAA,QACP,6BACG,YAAY,uBACb,QAAQ,yBACf;+BAAiD;;;;;;;;;;iBAwBrC,yBAAA,aACF,+CACkB;UAEtB;YACE;;;;;iBAoBI,2BAAA,eACA;gCACkB;;WAGvB;YACC,YAAY;;;;;iBA0BR,sBAAA,OACR,2BACI,uBACA,QAAQ,wBACjB;;;;iBAuDa,gBAAA"}

package/dist/providers/claude-agent-sdk/tool-bridge.js

@@ -0,0 +1,122 @@
+//#region src/providers/claude-agent-sdk/tool-bridge.ts
+/**
+* Convert a ContractSpec AgentToolConfig to Claude Agent SDK tool format.
+*
+* @param tool - ContractSpec tool configuration
+* @param handler - Tool handler function
+* @param context - Partial execution context to inject
+* @returns Claude Agent SDK tool definition with execute function
+*/
+function specToolToClaudeAgentTool(tool, handler, context) {
+	return {
+		name: tool.name,
+		description: tool.description ?? `Execute ${tool.name}`,
+		input_schema: normalizeSchema(tool.schema),
+		requires_confirmation: tool.requiresApproval ?? !tool.automationSafe,
+		execute: async (input) => {
+			return handler(input, {
+				agentId: context.agentId ?? "unknown",
+				sessionId: context.sessionId ?? "unknown",
+				tenantId: context.tenantId,
+				actorId: context.actorId,
+				metadata: context.metadata,
+				signal: context.signal
+			});
+		}
+	};
+}
+/**
+* Convert multiple ContractSpec tools to Claude Agent SDK format.
+*/
+function specToolsToClaudeAgentTools(tools, handlers, context) {
+	return tools.filter((tool) => handlers.has(tool.name)).map((tool) => {
+		const handler = handlers.get(tool.name);
+		if (!handler) throw new Error(`Handler not found for tool ${tool.name}`);
+		return specToolToClaudeAgentTool(tool, handler, context);
+	});
+}
+/**
+* Convert a Claude Agent SDK tool to ContractSpec AgentToolConfig.
+* This enables importing tools defined in Claude Agent SDK format.
+*
+* @param claudeTool - Claude Agent SDK tool definition
+* @param execute - Optional execute function to wrap
+* @returns ContractSpec tool config and optional handler
+*/
+function claudeAgentToolToSpecTool(claudeTool, execute) {
+	return {
+		config: {
+			name: claudeTool.name,
+			description: claudeTool.description,
+			schema: claudeTool.input_schema,
+			requiresApproval: claudeTool.requires_confirmation,
+			automationSafe: !claudeTool.requires_confirmation
+		},
+		handler: execute ? async (input, _ctx) => String(await execute(input)) : void 0
+	};
+}
+/**
+* Convert multiple Claude Agent SDK tools to ContractSpec format.
+*/
+function claudeAgentToolsToSpecTools(claudeTools) {
+	const configs = [];
+	const handlers = /* @__PURE__ */ new Map();
+	for (const claudeTool of claudeTools) {
+		const { config, handler } = claudeAgentToolToSpecTool(claudeTool, claudeTool.execute);
+		configs.push(config);
+		if (handler) handlers.set(config.name, handler);
+	}
+	return {
+		configs,
+		handlers
+	};
+}
+/**
+* Convert ContractSpec tool to ExternalToolDefinition format.
+*/
+function specToolToExternalTool(tool, handler, context) {
+	return {
+		name: tool.name,
+		description: tool.description ?? `Execute ${tool.name}`,
+		inputSchema: tool.schema ?? { type: "object" },
+		requiresApproval: tool.requiresApproval ?? !tool.automationSafe,
+		execute: handler ? async (input) => {
+			return handler(input, {
+				agentId: context?.agentId ?? "unknown",
+				sessionId: context?.sessionId ?? "unknown",
+				tenantId: context?.tenantId,
+				actorId: context?.actorId,
+				metadata: context?.metadata,
+				signal: context?.signal
+			});
+		} : void 0
+	};
+}
+/**
+* Normalize a schema to Claude Agent SDK's expected format.
+* Ensures the schema is a valid JSON Schema object type.
+*/
+function normalizeSchema(schema) {
+	if (!schema) return { type: "object" };
+	if (schema.type === "object") return schema;
+	return {
+		type: "object",
+		properties: { value: schema },
+		required: ["value"]
+	};
+}
+/**
+* Extract tool call info from Claude Agent SDK response.
+*/
+function extractToolCalls(response) {
+	if (!response.content) return [];
+	return response.content.filter((block) => block.type === "tool_use").map((block) => ({
+		toolCallId: block.id ?? "",
+		toolName: block.name ?? "",
+		args: block.input
+	}));
+}
+
+//#endregion
+export { claudeAgentToolToSpecTool, claudeAgentToolsToSpecTools, extractToolCalls, specToolToClaudeAgentTool, specToolToExternalTool, specToolsToClaudeAgentTools };
+//# sourceMappingURL=tool-bridge.js.map

package/dist/providers/claude-agent-sdk/tool-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.js","names":["configs: AgentToolConfig[]"],"sources":["../../../src/providers/claude-agent-sdk/tool-bridge.ts"],"sourcesContent":["/**\n * Tool bridge for converting between ContractSpec and Claude Agent SDK tool formats.\n *\n * Provides bidirectional conversion:\n * - ContractSpec AgentToolConfig → Claude Agent SDK tool\n * - Claude Agent SDK tool → ContractSpec AgentToolConfig\n */\n\nimport type { AgentToolConfig } from '../../spec/spec';\nimport type { ToolHandler, ToolExecutionContext } from '../../types';\nimport type { ExternalToolDefinition } from '../types';\n\n// ============================================================================\n// Claude Agent SDK Tool Types (based on SDK API)\n// ============================================================================\n\n/**\n * Claude Agent SDK tool definition.\n * Based on Anthropic's tool format.\n */\nexport interface ClaudeAgentTool {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Input schema in JSON Schema format */\n  input_schema: {\n    type: 'object';\n    properties?: Record<string, unknown>;\n    required?: string[];\n    additionalProperties?: boolean;\n  };\n  /** Whether tool requires confirmation before execution */\n  requires_confirmation?: boolean;\n  /** Tool category for organization */\n  category?: string;\n}\n\n/**\n * Claude Agent SDK tool result.\n */\nexport interface ClaudeAgentToolResult {\n  /** Tool call ID this result corresponds to */\n  tool_use_id: string;\n  /** Result content */\n  content: string | ClaudeAgentToolResultContent[];\n  /** Whether the tool execution failed */\n  is_error?: boolean;\n}\n\n/**\n * Claude Agent SDK tool result content block.\n */\nexport interface ClaudeAgentToolResultContent {\n  type: 'text' | 'image';\n  text?: string;\n  source?: {\n    type: 'base64';\n    media_type: string;\n    data: string;\n  };\n}\n\n// ============================================================================\n// ContractSpec → Claude Agent SDK Conversion\n// ============================================================================\n\n/**\n * Convert a ContractSpec AgentToolConfig to Claude Agent SDK tool format.\n *\n * @param tool - ContractSpec tool configuration\n * @param handler - Tool handler function\n * @param context - Partial execution context to inject\n * @returns Claude Agent SDK tool definition with execute function\n */\nexport function specToolToClaudeAgentTool(\n  tool: AgentToolConfig,\n  handler: ToolHandler,\n  context: Partial<ToolExecutionContext>\n): ClaudeAgentTool & { execute: (input: unknown) => Promise<unknown> } {\n  return {\n    name: tool.name,\n    description: tool.description ?? `Execute ${tool.name}`,\n    input_schema: normalizeSchema(tool.schema),\n    requires_confirmation: tool.requiresApproval ?? !tool.automationSafe,\n    execute: async (input: unknown) => {\n      const fullContext: ToolExecutionContext = {\n        agentId: context.agentId ?? 'unknown',\n        sessionId: context.sessionId ?? 'unknown',\n        tenantId: context.tenantId,\n        actorId: context.actorId,\n        metadata: context.metadata,\n        signal: context.signal,\n      };\n      return handler(input, fullContext);\n    },\n  };\n}\n\n/**\n * Convert multiple ContractSpec tools to Claude Agent SDK format.\n */\nexport function specToolsToClaudeAgentTools(\n  tools: AgentToolConfig[],\n  handlers: Map<string, ToolHandler>,\n  context: Partial<ToolExecutionContext>\n): (ClaudeAgentTool & { execute: (input: unknown) => Promise<unknown> })[] {\n  return tools\n    .filter((tool) => handlers.has(tool.name))\n    .map((tool) => {\n      const handler = handlers.get(tool.name);\n      if (!handler) {\n        throw new Error(`Handler not found for tool ${tool.name}`);\n      }\n      return specToolToClaudeAgentTool(tool, handler, context);\n    });\n}\n\n// ============================================================================\n// Claude Agent SDK → ContractSpec Conversion\n// ============================================================================\n\n/**\n * Convert a Claude Agent SDK tool to ContractSpec AgentToolConfig.\n * This enables importing tools defined in Claude Agent SDK format.\n *\n * @param claudeTool - Claude Agent SDK tool definition\n * @param execute - Optional execute function to wrap\n * @returns ContractSpec tool config and optional handler\n */\nexport function claudeAgentToolToSpecTool(\n  claudeTool: ClaudeAgentTool,\n  execute?: (input: unknown) => Promise<unknown>\n): {\n  config: AgentToolConfig;\n  handler?: ToolHandler;\n} {\n  const config: AgentToolConfig = {\n    name: claudeTool.name,\n    description: claudeTool.description,\n    schema: claudeTool.input_schema,\n    requiresApproval: claudeTool.requires_confirmation,\n    automationSafe: !claudeTool.requires_confirmation,\n  };\n\n  const handler: ToolHandler | undefined = execute\n    ? async (input, _ctx) => String(await execute(input))\n    : undefined;\n\n  return { config, handler };\n}\n\n/**\n * Convert multiple Claude Agent SDK tools to ContractSpec format.\n */\nexport function claudeAgentToolsToSpecTools(\n  claudeTools: (ClaudeAgentTool & {\n    execute?: (input: unknown) => Promise<unknown>;\n  })[]\n): {\n  configs: AgentToolConfig[];\n  handlers: Map<string, ToolHandler>;\n} {\n  const configs: AgentToolConfig[] = [];\n  const handlers = new Map<string, ToolHandler>();\n\n  for (const claudeTool of claudeTools) {\n    const { config, handler } = claudeAgentToolToSpecTool(\n      claudeTool,\n      claudeTool.execute\n    );\n    configs.push(config);\n    if (handler) {\n      handlers.set(config.name, handler);\n    }\n  }\n\n  return { configs, handlers };\n}\n\n// ============================================================================\n// External Tool Definition Conversion\n// ============================================================================\n\n/**\n * Convert ContractSpec tool to ExternalToolDefinition format.\n */\nexport function specToolToExternalTool(\n  tool: AgentToolConfig,\n  handler?: ToolHandler,\n  context?: Partial<ToolExecutionContext>\n): ExternalToolDefinition {\n  return {\n    name: tool.name,\n    description: tool.description ?? `Execute ${tool.name}`,\n    inputSchema: tool.schema ?? { type: 'object' },\n    requiresApproval: tool.requiresApproval ?? !tool.automationSafe,\n    execute: handler\n      ? async (input) => {\n          const fullContext: ToolExecutionContext = {\n            agentId: context?.agentId ?? 'unknown',\n            sessionId: context?.sessionId ?? 'unknown',\n            tenantId: context?.tenantId,\n            actorId: context?.actorId,\n            metadata: context?.metadata,\n            signal: context?.signal,\n          };\n          return handler(input, fullContext);\n        }\n      : undefined,\n  };\n}\n\n// ============================================================================\n// Schema Normalization\n// ============================================================================\n\n/**\n * Normalize a schema to Claude Agent SDK's expected format.\n * Ensures the schema is a valid JSON Schema object type.\n */\nfunction normalizeSchema(\n  schema?: Record<string, unknown>\n): ClaudeAgentTool['input_schema'] {\n  if (!schema) {\n    return { type: 'object' };\n  }\n\n  // If it's already an object type schema, return as-is with type assertion\n  if (schema.type === 'object') {\n    return schema as ClaudeAgentTool['input_schema'];\n  }\n\n  // Wrap non-object schemas in an object\n  return {\n    type: 'object',\n    properties: {\n      value: schema,\n    },\n    required: ['value'],\n  };\n}\n\n/**\n * Extract tool call info from Claude Agent SDK response.\n */\nexport function extractToolCalls(response: {\n  content?: {\n    type: string;\n    id?: string;\n    name?: string;\n    input?: unknown;\n  }[];\n}): {\n  toolCallId: string;\n  toolName: string;\n  args: unknown;\n}[] {\n  if (!response.content) {\n    return [];\n  }\n\n  return response.content\n    .filter((block) => block.type === 'tool_use')\n    .map((block) => ({\n      toolCallId: block.id ?? '',\n      toolName: block.name ?? '',\n      args: block.input,\n    }));\n}\n"],"mappings":";;;;;;;;;AA2EA,SAAgB,0BACd,MACA,SACA,SACqE;AACrE,QAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK,eAAe,WAAW,KAAK;EACjD,cAAc,gBAAgB,KAAK,OAAO;EAC1C,uBAAuB,KAAK,oBAAoB,CAAC,KAAK;EACtD,SAAS,OAAO,UAAmB;AASjC,UAAO,QAAQ,OAR2B;IACxC,SAAS,QAAQ,WAAW;IAC5B,WAAW,QAAQ,aAAa;IAChC,UAAU,QAAQ;IAClB,SAAS,QAAQ;IACjB,UAAU,QAAQ;IAClB,QAAQ,QAAQ;IACjB,CACiC;;EAErC;;;;;AAMH,SAAgB,4BACd,OACA,UACA,SACyE;AACzE,QAAO,MACJ,QAAQ,SAAS,SAAS,IAAI,KAAK,KAAK,CAAC,CACzC,KAAK,SAAS;EACb,MAAM,UAAU,SAAS,IAAI,KAAK,KAAK;AACvC,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,8BAA8B,KAAK,OAAO;AAE5D,SAAO,0BAA0B,MAAM,SAAS,QAAQ;GACxD;;;;;;;;;;AAeN,SAAgB,0BACd,YACA,SAIA;AAaA,QAAO;EAAE,QAZuB;GAC9B,MAAM,WAAW;GACjB,aAAa,WAAW;GACxB,QAAQ,WAAW;GACnB,kBAAkB,WAAW;GAC7B,gBAAgB,CAAC,WAAW;GAC7B;EAMgB,SAJwB,UACrC,OAAO,OAAO,SAAS,OAAO,MAAM,QAAQ,MAAM,CAAC,GACnD;EAEsB;;;;;AAM5B,SAAgB,4BACd,aAMA;CACA,MAAMA,UAA6B,EAAE;CACrC,MAAM,2BAAW,IAAI,KAA0B;AAE/C,MAAK,MAAM,cAAc,aAAa;EACpC,MAAM,EAAE,QAAQ,YAAY,0BAC1B,YACA,WAAW,QACZ;AACD,UAAQ,KAAK,OAAO;AACpB,MAAI,QACF,UAAS,IAAI,OAAO,MAAM,QAAQ;;AAItC,QAAO;EAAE;EAAS;EAAU;;;;;AAU9B,SAAgB,uBACd,MACA,SACA,SACwB;AACxB,QAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK,eAAe,WAAW,KAAK;EACjD,aAAa,KAAK,UAAU,EAAE,MAAM,UAAU;EAC9C,kBAAkB,KAAK,oBAAoB,CAAC,KAAK;EACjD,SAAS,UACL,OAAO,UAAU;AASf,UAAO,QAAQ,OAR2B;IACxC,SAAS,SAAS,WAAW;IAC7B,WAAW,SAAS,aAAa;IACjC,UAAU,SAAS;IACnB,SAAS,SAAS;IAClB,UAAU,SAAS;IACnB,QAAQ,SAAS;IAClB,CACiC;MAEpC;EACL;;;;;;AAWH,SAAS,gBACP,QACiC;AACjC,KAAI,CAAC,OACH,QAAO,EAAE,MAAM,UAAU;AAI3B,KAAI,OAAO,SAAS,SAClB,QAAO;AAIT,QAAO;EACL,MAAM;EACN,YAAY,EACV,OAAO,QACR;EACD,UAAU,CAAC,QAAQ;EACpB;;;;;AAMH,SAAgB,iBAAiB,UAW7B;AACF,KAAI,CAAC,SAAS,QACZ,QAAO,EAAE;AAGX,QAAO,SAAS,QACb,QAAQ,UAAU,MAAM,SAAS,WAAW,CAC5C,KAAK,WAAW;EACf,YAAY,MAAM,MAAM;EACxB,UAAU,MAAM,QAAQ;EACxB,MAAM,MAAM;EACb,EAAE"}

package/dist/providers/index.d.ts

@@ -0,0 +1,7 @@
+import { ClaudeAgentContextMetadata, ClaudeAgentSDKConfig, ContextCreationError, ExternalAgentContext, ExternalAgentProvider, ExternalExecuteParams, ExternalExecuteResult, ExternalProviderError, ExternalProviderFactory, ExternalStreamChunk, ExternalToolDefinition, ExternalToolSet, ExternalUsage, OpenCodeAgentType, OpenCodeContextMetadata, OpenCodeSDKConfig, ProviderExecutionError, ProviderNotAvailableError, ProviderRegistry } from "./types.js";
+import { ClaudeAgentSDKProvider } from "./claude-agent-sdk/adapter.js";
+import "./claude-agent-sdk/index.js";
+import { OpenCodeSDKProvider } from "./opencode-sdk/adapter.js";
+import "./opencode-sdk/index.js";
+import { createProviderRegistry, defaultProviderRegistry } from "./registry.js";
+export { ClaudeAgentContextMetadata, ClaudeAgentSDKConfig, ClaudeAgentSDKProvider, ContextCreationError, ExternalAgentContext, ExternalAgentProvider, ExternalExecuteParams, ExternalExecuteResult, ExternalProviderError, ExternalProviderFactory, ExternalStreamChunk, ExternalToolDefinition, ExternalToolSet, ExternalUsage, OpenCodeAgentType, OpenCodeContextMetadata, OpenCodeSDKConfig, OpenCodeSDKProvider, ProviderExecutionError, ProviderNotAvailableError, ProviderRegistry, createProviderRegistry, defaultProviderRegistry };

package/dist/providers/index.js

@@ -0,0 +1,8 @@
+import { ContextCreationError, ExternalProviderError, ProviderExecutionError, ProviderNotAvailableError } from "./types.js";
+import { ClaudeAgentSDKProvider } from "./claude-agent-sdk/adapter.js";
+import "./claude-agent-sdk/index.js";
+import { OpenCodeSDKProvider } from "./opencode-sdk/adapter.js";
+import "./opencode-sdk/index.js";
+import { createProviderRegistry, defaultProviderRegistry } from "./registry.js";
+
+export { ClaudeAgentSDKProvider, ContextCreationError, ExternalProviderError, OpenCodeSDKProvider, ProviderExecutionError, ProviderNotAvailableError, createProviderRegistry, defaultProviderRegistry };

package/dist/providers/opencode-sdk/adapter.d.ts

@@ -0,0 +1,54 @@
+import { AgentSpec } from "../../spec/spec.js";
+import { ExternalAgentContext, ExternalAgentProvider, ExternalExecuteParams, ExternalExecuteResult, ExternalStreamChunk, OpenCodeSDKConfig } from "../types.js";
+
+//#region src/providers/opencode-sdk/adapter.d.ts
+
+/**
+ * OpenCode SDK Provider implementation.
+ */
+declare class OpenCodeSDKProvider implements ExternalAgentProvider {
+  readonly name = "opencode-sdk";
+  readonly version = "1.0.0";
+  private config;
+  private sdkAvailable;
+  constructor(config?: OpenCodeSDKConfig);
+  /**
+   * Check if OpenCode SDK is available.
+   */
+  isAvailable(): boolean;
+  /**
+   * Create an execution context from an AgentSpec.
+   */
+  createContext(spec: AgentSpec): Promise<ExternalAgentContext>;
+  /**
+   * Execute a prompt using OpenCode SDK.
+   */
+  execute(context: ExternalAgentContext, params: ExternalExecuteParams): Promise<ExternalExecuteResult>;
+  /**
+   * Stream execution with real-time updates.
+   */
+  stream(context: ExternalAgentContext, params: ExternalExecuteParams): AsyncIterable<ExternalStreamChunk>;
+  /**
+   * Load the OpenCode SDK dynamically.
+   */
+  private loadSDK;
+  /**
+   * Get hostname from server URL.
+   */
+  private getHostname;
+  /**
+   * Extract tool calls from response.
+   */
+  private extractToolCalls;
+  /**
+   * Extract text content from response.
+   */
+  private extractTextContent;
+  /**
+   * Map OpenCode finish reason to ContractSpec finish reason.
+   */
+  private mapFinishReason;
+}
+//#endregion
+export { OpenCodeSDKProvider };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/opencode-sdk/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../../src/providers/opencode-sdk/adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA+C4C,cAA/B,mBAAA,YAA+B,qBAAA,CAAA;EAAqB,SAAA,IAAA,GAAA,cAAA;;;;uBAO3C;;;;;;;;sBAsCM,YAAY,QAAQ;;;;mBA0EnC,8BACD,wBACP,QAAQ;;;;kBAuEA,8BACD,wBACP,cAAc"}