@contractspec/lib.ai-agent 1.45.6 → 1.46.0

package/dist/providers/opencode-sdk/tool-bridge.d.ts

@@ -0,0 +1,81 @@
+import { AgentToolConfig } from "../../spec/spec.js";
+import { ToolExecutionContext, ToolHandler } from "../../types.js";
+import { ExternalToolDefinition } from "../types.js";
+
+//#region src/providers/opencode-sdk/tool-bridge.d.ts
+
+/**
+ * OpenCode SDK tool definition.
+ */
+interface OpenCodeTool {
+  /** Tool name */
+  name: string;
+  /** Tool description */
+  description: string;
+  /** Input parameters schema */
+  parameters: {
+    type: 'object';
+    properties?: Record<string, OpenCodeParameter>;
+    required?: string[];
+  };
+  /** Tool category */
+  category?: string;
+  /** Permission level */
+  permission?: 'allow' | 'ask' | 'deny';
+}
+/**
+ * OpenCode parameter definition.
+ */
+interface OpenCodeParameter {
+  type: string;
+  description?: string;
+  enum?: string[];
+  default?: unknown;
+}
+/**
+ * OpenCode tool call from session.
+ */
+interface OpenCodeToolCall {
+  id: string;
+  name: string;
+  arguments: Record<string, unknown>;
+}
+/**
+ * OpenCode tool result.
+ */
+interface OpenCodeToolResult {
+  tool_call_id: string;
+  output: string;
+  is_error?: boolean;
+}
+/**
+ * Convert a ContractSpec AgentToolConfig to OpenCode tool format.
+ */
+declare function specToolToOpenCodeTool(tool: AgentToolConfig): OpenCodeTool;
+/**
+ * Convert multiple ContractSpec tools to OpenCode format.
+ */
+declare function specToolsToOpenCodeTools(tools: AgentToolConfig[]): OpenCodeTool[];
+/**
+ * Convert an OpenCode tool to ContractSpec AgentToolConfig.
+ */
+declare function openCodeToolToSpecTool(openCodeTool: OpenCodeTool): AgentToolConfig;
+/**
+ * Convert multiple OpenCode tools to ContractSpec format.
+ */
+declare function openCodeToolsToSpecTools(openCodeTools: OpenCodeTool[]): AgentToolConfig[];
+/**
+ * Convert ContractSpec tool to ExternalToolDefinition format for OpenCode.
+ */
+declare function specToolToExternalToolForOpenCode(tool: AgentToolConfig, handler?: ToolHandler, context?: Partial<ToolExecutionContext>): ExternalToolDefinition;
+/**
+ * Create a tool handler map from ExternalToolSet.
+ */
+declare function createToolHandlerMap(tools: Record<string, ExternalToolDefinition>): Map<string, (input: unknown) => Promise<unknown>>;
+/**
+ * Execute a tool call and format the result.
+ */
+declare function executeToolCall(toolCall: OpenCodeToolCall, handlers: Map<string, (input: unknown) => Promise<unknown>>): Promise<OpenCodeToolResult>;
+//#endregion
+export { OpenCodeParameter, OpenCodeTool, OpenCodeToolCall, OpenCodeToolResult, createToolHandlerMap, executeToolCall, openCodeToolToSpecTool, openCodeToolsToSpecTools, specToolToExternalToolForOpenCode, specToolToOpenCodeTool, specToolsToOpenCodeTools };
+//# sourceMappingURL=tool-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.d.ts","names":[],"sources":["../../../src/providers/opencode-sdk/tool-bridge.ts"],"sourcesContent":[],"mappings":";;;;;;AAmCA;AAUA;AASA;AAagB,UApDC,YAAA,CAoDqB;EAatB;EA0BA,IAAA,EAAA,MAAA;EAgBA;EAaA,WAAA,EAAA,MAAA;EACR;EACI,UAAA,EAAA;IACQ,IAAA,EAAA,QAAA;IAAR,UAAA,CAAA,EAnHK,MAmHL,CAAA,MAAA,EAnHoB,iBAmHpB,CAAA;IACT,QAAA,CAAA,EAAA,MAAA,EAAA;EAAsB,CAAA;EAyFT;EACQ,QAAA,CAAA,EAAA,MAAA;EAAf;EAC0B,UAAA,CAAA,EAAA,OAAA,GAAA,KAAA,GAAA,MAAA;;;AAenC;;AAE4C,UApN3B,iBAAA,CAoN2B;EAAhC,IAAA,EAAA,MAAA;EACD,WAAA,CAAA,EAAA,MAAA;EAAR,IAAA,CAAA,EAAA,MAAA,EAAA;EAAO,OAAA,CAAA,EAAA,OAAA;;;;;UA3MO,gBAAA;;;aAGJ;;;;;UAMI,kBAAA;;;;;;;;iBAaD,sBAAA,OAA6B,kBAAkB;;;;iBAa/C,wBAAA,QACP,oBACN;;;;iBAwBa,sBAAA,eACA,eACb;;;;iBAca,wBAAA,gBACC,iBACd;;;;iBAWa,iCAAA,OACR,2BACI,uBACA,QAAQ,wBACjB;;;;iBAyFa,oBAAA,QACP,eAAe,0BACrB,gCAAgC;;;;iBAeb,eAAA,WACV,4BACA,gCAAgC,oBACzC,QAAQ"}

package/dist/providers/opencode-sdk/tool-bridge.js

@@ -0,0 +1,127 @@
+//#region src/providers/opencode-sdk/tool-bridge.ts
+/**
+* Convert a ContractSpec AgentToolConfig to OpenCode tool format.
+*/
+function specToolToOpenCodeTool(tool) {
+	return {
+		name: tool.name,
+		description: tool.description ?? `Execute ${tool.name}`,
+		parameters: normalizeToOpenCodeParameters(tool.schema),
+		permission: getPermissionLevel(tool)
+	};
+}
+/**
+* Convert multiple ContractSpec tools to OpenCode format.
+*/
+function specToolsToOpenCodeTools(tools) {
+	return tools.map(specToolToOpenCodeTool);
+}
+/**
+* Determine permission level from tool config.
+*/
+function getPermissionLevel(tool) {
+	if (tool.requiresApproval) return "ask";
+	if (tool.automationSafe === false) return "ask";
+	return "allow";
+}
+/**
+* Convert an OpenCode tool to ContractSpec AgentToolConfig.
+*/
+function openCodeToolToSpecTool(openCodeTool) {
+	return {
+		name: openCodeTool.name,
+		description: openCodeTool.description,
+		schema: openCodeTool.parameters,
+		requiresApproval: openCodeTool.permission === "ask",
+		automationSafe: openCodeTool.permission === "allow"
+	};
+}
+/**
+* Convert multiple OpenCode tools to ContractSpec format.
+*/
+function openCodeToolsToSpecTools(openCodeTools) {
+	return openCodeTools.map(openCodeToolToSpecTool);
+}
+/**
+* Convert ContractSpec tool to ExternalToolDefinition format for OpenCode.
+*/
+function specToolToExternalToolForOpenCode(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 OpenCode's expected parameter format.
+*/
+function normalizeToOpenCodeParameters(schema) {
+	if (!schema) return { type: "object" };
+	if (schema.type === "object") return {
+		type: "object",
+		properties: schema.properties,
+		required: schema.required
+	};
+	return {
+		type: "object",
+		properties: { value: convertToOpenCodeParameter(schema) },
+		required: ["value"]
+	};
+}
+/**
+* Convert a JSON Schema property to OpenCode parameter format.
+*/
+function convertToOpenCodeParameter(schema) {
+	const param = { type: schema.type ?? "string" };
+	if (schema.description) param.description = schema.description;
+	if (schema.enum) param.enum = schema.enum;
+	if (schema.default !== void 0) param.default = schema.default;
+	return param;
+}
+/**
+* Create a tool handler map from ExternalToolSet.
+*/
+function createToolHandlerMap(tools) {
+	const handlers = /* @__PURE__ */ new Map();
+	for (const [name, tool] of Object.entries(tools)) if (tool.execute) handlers.set(name, tool.execute);
+	return handlers;
+}
+/**
+* Execute a tool call and format the result.
+*/
+async function executeToolCall(toolCall, handlers) {
+	const handler = handlers.get(toolCall.name);
+	if (!handler) return {
+		tool_call_id: toolCall.id,
+		output: `Error: Tool '${toolCall.name}' not found`,
+		is_error: true
+	};
+	try {
+		const result = await handler(toolCall.arguments);
+		return {
+			tool_call_id: toolCall.id,
+			output: typeof result === "string" ? result : JSON.stringify(result)
+		};
+	} catch (error) {
+		return {
+			tool_call_id: toolCall.id,
+			output: `Error: ${error instanceof Error ? error.message : String(error)}`,
+			is_error: true
+		};
+	}
+}
+
+//#endregion
+export { createToolHandlerMap, executeToolCall, openCodeToolToSpecTool, openCodeToolsToSpecTools, specToolToExternalToolForOpenCode, specToolToOpenCodeTool, specToolsToOpenCodeTools };
+//# sourceMappingURL=tool-bridge.js.map

package/dist/providers/opencode-sdk/tool-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.js","names":["param: OpenCodeParameter"],"sources":["../../../src/providers/opencode-sdk/tool-bridge.ts"],"sourcesContent":["/**\n * Tool bridge for converting between ContractSpec and OpenCode SDK tool formats.\n */\n\nimport type { AgentToolConfig } from '../../spec/spec';\nimport type { ToolHandler, ToolExecutionContext } from '../../types';\nimport type { ExternalToolDefinition } from '../types';\n\n// ============================================================================\n// OpenCode SDK Tool Types\n// ============================================================================\n\n/**\n * OpenCode SDK tool definition.\n */\nexport interface OpenCodeTool {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Input parameters schema */\n  parameters: {\n    type: 'object';\n    properties?: Record<string, OpenCodeParameter>;\n    required?: string[];\n  };\n  /** Tool category */\n  category?: string;\n  /** Permission level */\n  permission?: 'allow' | 'ask' | 'deny';\n}\n\n/**\n * OpenCode parameter definition.\n */\nexport interface OpenCodeParameter {\n  type: string;\n  description?: string;\n  enum?: string[];\n  default?: unknown;\n}\n\n/**\n * OpenCode tool call from session.\n */\nexport interface OpenCodeToolCall {\n  id: string;\n  name: string;\n  arguments: Record<string, unknown>;\n}\n\n/**\n * OpenCode tool result.\n */\nexport interface OpenCodeToolResult {\n  tool_call_id: string;\n  output: string;\n  is_error?: boolean;\n}\n\n// ============================================================================\n// ContractSpec → OpenCode Conversion\n// ============================================================================\n\n/**\n * Convert a ContractSpec AgentToolConfig to OpenCode tool format.\n */\nexport function specToolToOpenCodeTool(tool: AgentToolConfig): OpenCodeTool {\n  return {\n    name: tool.name,\n    description: tool.description ?? `Execute ${tool.name}`,\n    parameters: normalizeToOpenCodeParameters(tool.schema),\n    // category property not in AgentToolConfig\n    permission: getPermissionLevel(tool),\n  };\n}\n\n/**\n * Convert multiple ContractSpec tools to OpenCode format.\n */\nexport function specToolsToOpenCodeTools(\n  tools: AgentToolConfig[]\n): OpenCodeTool[] {\n  return tools.map(specToolToOpenCodeTool);\n}\n\n/**\n * Determine permission level from tool config.\n */\nfunction getPermissionLevel(tool: AgentToolConfig): OpenCodeTool['permission'] {\n  if (tool.requiresApproval) {\n    return 'ask';\n  }\n  if (tool.automationSafe === false) {\n    return 'ask';\n  }\n  return 'allow';\n}\n\n// ============================================================================\n// OpenCode → ContractSpec Conversion\n// ============================================================================\n\n/**\n * Convert an OpenCode tool to ContractSpec AgentToolConfig.\n */\nexport function openCodeToolToSpecTool(\n  openCodeTool: OpenCodeTool\n): AgentToolConfig {\n  return {\n    name: openCodeTool.name,\n    description: openCodeTool.description,\n    schema: openCodeTool.parameters,\n    requiresApproval: openCodeTool.permission === 'ask',\n    automationSafe: openCodeTool.permission === 'allow',\n    // category property not in AgentToolConfig\n  };\n}\n\n/**\n * Convert multiple OpenCode tools to ContractSpec format.\n */\nexport function openCodeToolsToSpecTools(\n  openCodeTools: OpenCodeTool[]\n): AgentToolConfig[] {\n  return openCodeTools.map(openCodeToolToSpecTool);\n}\n\n// ============================================================================\n// External Tool Definition Conversion\n// ============================================================================\n\n/**\n * Convert ContractSpec tool to ExternalToolDefinition format for OpenCode.\n */\nexport function specToolToExternalToolForOpenCode(\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 Conversion\n// ============================================================================\n\n/**\n * Normalize a schema to OpenCode's expected parameter format.\n */\nfunction normalizeToOpenCodeParameters(\n  schema?: Record<string, unknown>\n): OpenCodeTool['parameters'] {\n  if (!schema) {\n    return { type: 'object' };\n  }\n\n  // Already in correct format\n  if (schema.type === 'object') {\n    return {\n      type: 'object',\n      properties: schema.properties as\n        | Record<string, OpenCodeParameter>\n        | undefined,\n      required: schema.required as string[] | undefined,\n    };\n  }\n\n  // Wrap non-object schemas\n  return {\n    type: 'object',\n    properties: {\n      value: convertToOpenCodeParameter(schema),\n    },\n    required: ['value'],\n  };\n}\n\n/**\n * Convert a JSON Schema property to OpenCode parameter format.\n */\nfunction convertToOpenCodeParameter(\n  schema: Record<string, unknown>\n): OpenCodeParameter {\n  const param: OpenCodeParameter = {\n    type: (schema.type as string) ?? 'string',\n  };\n\n  if (schema.description) {\n    param.description = schema.description as string;\n  }\n\n  if (schema.enum) {\n    param.enum = schema.enum as string[];\n  }\n\n  if (schema.default !== undefined) {\n    param.default = schema.default;\n  }\n\n  return param;\n}\n\n// ============================================================================\n// Tool Execution Helpers\n// ============================================================================\n\n/**\n * Create a tool handler map from ExternalToolSet.\n */\nexport function createToolHandlerMap(\n  tools: Record<string, ExternalToolDefinition>\n): Map<string, (input: unknown) => Promise<unknown>> {\n  const handlers = new Map<string, (input: unknown) => Promise<unknown>>();\n\n  for (const [name, tool] of Object.entries(tools)) {\n    if (tool.execute) {\n      handlers.set(name, tool.execute);\n    }\n  }\n\n  return handlers;\n}\n\n/**\n * Execute a tool call and format the result.\n */\nexport async function executeToolCall(\n  toolCall: OpenCodeToolCall,\n  handlers: Map<string, (input: unknown) => Promise<unknown>>\n): Promise<OpenCodeToolResult> {\n  const handler = handlers.get(toolCall.name);\n\n  if (!handler) {\n    return {\n      tool_call_id: toolCall.id,\n      output: `Error: Tool '${toolCall.name}' not found`,\n      is_error: true,\n    };\n  }\n\n  try {\n    const result = await handler(toolCall.arguments);\n    return {\n      tool_call_id: toolCall.id,\n      output: typeof result === 'string' ? result : JSON.stringify(result),\n    };\n  } catch (error) {\n    return {\n      tool_call_id: toolCall.id,\n      output: `Error: ${error instanceof Error ? error.message : String(error)}`,\n      is_error: true,\n    };\n  }\n}\n"],"mappings":";;;;AAmEA,SAAgB,uBAAuB,MAAqC;AAC1E,QAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK,eAAe,WAAW,KAAK;EACjD,YAAY,8BAA8B,KAAK,OAAO;EAEtD,YAAY,mBAAmB,KAAK;EACrC;;;;;AAMH,SAAgB,yBACd,OACgB;AAChB,QAAO,MAAM,IAAI,uBAAuB;;;;;AAM1C,SAAS,mBAAmB,MAAmD;AAC7E,KAAI,KAAK,iBACP,QAAO;AAET,KAAI,KAAK,mBAAmB,MAC1B,QAAO;AAET,QAAO;;;;;AAUT,SAAgB,uBACd,cACiB;AACjB,QAAO;EACL,MAAM,aAAa;EACnB,aAAa,aAAa;EAC1B,QAAQ,aAAa;EACrB,kBAAkB,aAAa,eAAe;EAC9C,gBAAgB,aAAa,eAAe;EAE7C;;;;;AAMH,SAAgB,yBACd,eACmB;AACnB,QAAO,cAAc,IAAI,uBAAuB;;;;;AAUlD,SAAgB,kCACd,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;;;;;AAUH,SAAS,8BACP,QAC4B;AAC5B,KAAI,CAAC,OACH,QAAO,EAAE,MAAM,UAAU;AAI3B,KAAI,OAAO,SAAS,SAClB,QAAO;EACL,MAAM;EACN,YAAY,OAAO;EAGnB,UAAU,OAAO;EAClB;AAIH,QAAO;EACL,MAAM;EACN,YAAY,EACV,OAAO,2BAA2B,OAAO,EAC1C;EACD,UAAU,CAAC,QAAQ;EACpB;;;;;AAMH,SAAS,2BACP,QACmB;CACnB,MAAMA,QAA2B,EAC/B,MAAO,OAAO,QAAmB,UAClC;AAED,KAAI,OAAO,YACT,OAAM,cAAc,OAAO;AAG7B,KAAI,OAAO,KACT,OAAM,OAAO,OAAO;AAGtB,KAAI,OAAO,YAAY,OACrB,OAAM,UAAU,OAAO;AAGzB,QAAO;;;;;AAUT,SAAgB,qBACd,OACmD;CACnD,MAAM,2BAAW,IAAI,KAAmD;AAExE,MAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,MAAM,CAC9C,KAAI,KAAK,QACP,UAAS,IAAI,MAAM,KAAK,QAAQ;AAIpC,QAAO;;;;;AAMT,eAAsB,gBACpB,UACA,UAC6B;CAC7B,MAAM,UAAU,SAAS,IAAI,SAAS,KAAK;AAE3C,KAAI,CAAC,QACH,QAAO;EACL,cAAc,SAAS;EACvB,QAAQ,gBAAgB,SAAS,KAAK;EACtC,UAAU;EACX;AAGH,KAAI;EACF,MAAM,SAAS,MAAM,QAAQ,SAAS,UAAU;AAChD,SAAO;GACL,cAAc,SAAS;GACvB,QAAQ,OAAO,WAAW,WAAW,SAAS,KAAK,UAAU,OAAO;GACrE;UACM,OAAO;AACd,SAAO;GACL,cAAc,SAAS;GACvB,QAAQ,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GACxE,UAAU;GACX"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,22 @@
+import { ExternalAgentProvider, ProviderRegistry } from "./types.js";
+
+//#region src/providers/registry.d.ts
+
+/**
+ * Create a new provider registry.
+ */
+declare function createProviderRegistry(): ProviderRegistry & {
+  require: (name: string) => ExternalAgentProvider;
+  clear: () => void;
+};
+/**
+ * Global default provider registry.
+ * Use this for convenience when you don't need multiple registries.
+ */
+declare const defaultProviderRegistry: ProviderRegistry & {
+  require: (name: string) => ExternalAgentProvider;
+  clear: () => void;
+};
+//#endregion
+export { createProviderRegistry, defaultProviderRegistry };
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../src/providers/registry.ts"],"sourcesContent":[],"mappings":";;;;AAqEA;;;iBAXgB,sBAAA,CAAA,GAA0B;6BACb;;;;;;;cAUhB,yBAAuB;6BAVP"}

package/dist/providers/registry.js

@@ -0,0 +1,52 @@
+import { ProviderNotAvailableError } from "./types.js";
+
+//#region src/providers/registry.ts
+/**
+* In-memory implementation of the provider registry.
+*/
+var InMemoryProviderRegistry = class {
+	providers = /* @__PURE__ */ new Map();
+	get(name) {
+		return this.providers.get(name);
+	}
+	register(name, provider) {
+		this.providers.set(name, provider);
+	}
+	list() {
+		return Array.from(this.providers.keys());
+	}
+	isAvailable(name) {
+		const provider = this.providers.get(name);
+		return provider !== void 0 && provider.isAvailable();
+	}
+	/**
+	* Get a provider, throwing if not found or not available.
+	*/
+	require(name) {
+		const provider = this.providers.get(name);
+		if (!provider) throw new ProviderNotAvailableError(name, "not registered");
+		if (!provider.isAvailable()) throw new ProviderNotAvailableError(name, "dependencies not installed or not configured");
+		return provider;
+	}
+	/**
+	* Clear all registered providers.
+	*/
+	clear() {
+		this.providers.clear();
+	}
+};
+/**
+* Create a new provider registry.
+*/
+function createProviderRegistry() {
+	return new InMemoryProviderRegistry();
+}
+/**
+* Global default provider registry.
+* Use this for convenience when you don't need multiple registries.
+*/
+const defaultProviderRegistry = createProviderRegistry();
+
+//#endregion
+export { createProviderRegistry, defaultProviderRegistry };
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/providers/registry.ts"],"sourcesContent":["/**\n * Provider registry for managing external SDK providers.\n */\n\nimport type { ExternalAgentProvider, ProviderRegistry } from './types';\nimport { ProviderNotAvailableError } from './types';\n\n/**\n * In-memory implementation of the provider registry.\n */\nclass InMemoryProviderRegistry implements ProviderRegistry {\n  private providers = new Map<string, ExternalAgentProvider>();\n\n  get(name: string): ExternalAgentProvider | undefined {\n    return this.providers.get(name);\n  }\n\n  register(name: string, provider: ExternalAgentProvider): void {\n    this.providers.set(name, provider);\n  }\n\n  list(): string[] {\n    return Array.from(this.providers.keys());\n  }\n\n  isAvailable(name: string): boolean {\n    const provider = this.providers.get(name);\n    return provider !== undefined && provider.isAvailable();\n  }\n\n  /**\n   * Get a provider, throwing if not found or not available.\n   */\n  require(name: string): ExternalAgentProvider {\n    const provider = this.providers.get(name);\n    if (!provider) {\n      throw new ProviderNotAvailableError(name, 'not registered');\n    }\n    if (!provider.isAvailable()) {\n      throw new ProviderNotAvailableError(\n        name,\n        'dependencies not installed or not configured'\n      );\n    }\n    return provider;\n  }\n\n  /**\n   * Clear all registered providers.\n   */\n  clear(): void {\n    this.providers.clear();\n  }\n}\n\n/**\n * Create a new provider registry.\n */\nexport function createProviderRegistry(): ProviderRegistry & {\n  require: (name: string) => ExternalAgentProvider;\n  clear: () => void;\n} {\n  return new InMemoryProviderRegistry();\n}\n\n/**\n * Global default provider registry.\n * Use this for convenience when you don't need multiple registries.\n */\nexport const defaultProviderRegistry = createProviderRegistry();\n"],"mappings":";;;;;;AAUA,IAAM,2BAAN,MAA2D;CACzD,AAAQ,4BAAY,IAAI,KAAoC;CAE5D,IAAI,MAAiD;AACnD,SAAO,KAAK,UAAU,IAAI,KAAK;;CAGjC,SAAS,MAAc,UAAuC;AAC5D,OAAK,UAAU,IAAI,MAAM,SAAS;;CAGpC,OAAiB;AACf,SAAO,MAAM,KAAK,KAAK,UAAU,MAAM,CAAC;;CAG1C,YAAY,MAAuB;EACjC,MAAM,WAAW,KAAK,UAAU,IAAI,KAAK;AACzC,SAAO,aAAa,UAAa,SAAS,aAAa;;;;;CAMzD,QAAQ,MAAqC;EAC3C,MAAM,WAAW,KAAK,UAAU,IAAI,KAAK;AACzC,MAAI,CAAC,SACH,OAAM,IAAI,0BAA0B,MAAM,iBAAiB;AAE7D,MAAI,CAAC,SAAS,aAAa,CACzB,OAAM,IAAI,0BACR,MACA,+CACD;AAEH,SAAO;;;;;CAMT,QAAc;AACZ,OAAK,UAAU,OAAO;;;;;;AAO1B,SAAgB,yBAGd;AACA,QAAO,IAAI,0BAA0B;;;;;;AAOvC,MAAa,0BAA0B,wBAAwB"}

package/dist/providers/types.d.ts

@@ -0,0 +1,243 @@
+import { AgentSpec } from "../spec/spec.js";
+import { AgentCallOptions, AgentFinishReason, ToolCallInfo, ToolResultInfo } from "../types.js";
+import { McpClientConfig } from "../tools/mcp-client.js";
+
+//#region src/providers/types.d.ts
+
+/**
+ * External SDK provider interface for ContractSpec agents.
+ * Allows external SDKs to be used as execution backends.
+ */
+interface ExternalAgentProvider {
+  /** Provider name identifier */
+  readonly name: string;
+  /** Provider version */
+  readonly version: string;
+  /**
+   * Check if this provider is available (dependencies installed, configured).
+   * Should be a quick synchronous check.
+   */
+  isAvailable(): boolean;
+  /**
+   * Create an execution context from an AgentSpec.
+   * This prepares the provider for execution with the given spec.
+   */
+  createContext(spec: AgentSpec): Promise<ExternalAgentContext>;
+  /**
+   * Execute a prompt using this provider.
+   * Non-streaming execution that returns the complete result.
+   */
+  execute(context: ExternalAgentContext, params: ExternalExecuteParams): Promise<ExternalExecuteResult>;
+  /**
+   * Stream execution with real-time updates.
+   * Returns an async iterable of stream chunks.
+   */
+  stream(context: ExternalAgentContext, params: ExternalExecuteParams): AsyncIterable<ExternalStreamChunk>;
+}
+/**
+ * Execution context created by a provider.
+ * Holds the prepared state for executing prompts.
+ */
+interface ExternalAgentContext {
+  /** Unique context ID */
+  id: string;
+  /** The spec this context was created from */
+  spec: AgentSpec;
+  /** Tools available in this context */
+  tools: ExternalToolSet;
+  /** Cleanup function to release resources */
+  cleanup: () => Promise<void>;
+  /** Provider-specific metadata */
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for executing a prompt.
+ */
+interface ExternalExecuteParams {
+  /** The prompt to execute */
+  prompt: string;
+  /** Optional system prompt override/addition */
+  systemOverride?: string;
+  /** Call options (tenant, actor, session, metadata) */
+  options?: AgentCallOptions;
+  /** Abort signal for cancellation */
+  signal?: AbortSignal;
+  /** Maximum steps/iterations (provider may interpret differently) */
+  maxSteps?: number;
+}
+/**
+ * Result from a non-streaming execution.
+ */
+interface ExternalExecuteResult {
+  /** Final text response */
+  text: string;
+  /** Tool calls made during execution */
+  toolCalls: ToolCallInfo[];
+  /** Results from tool executions */
+  toolResults: ToolResultInfo[];
+  /** Token usage statistics */
+  usage?: ExternalUsage;
+  /** Reason the execution finished */
+  finishReason: AgentFinishReason;
+  /** Provider-specific result metadata */
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Token usage statistics.
+ */
+interface ExternalUsage {
+  inputTokens: number;
+  outputTokens: number;
+  totalTokens?: number;
+}
+/**
+ * Stream chunk from streaming execution.
+ */
+interface ExternalStreamChunk {
+  /** Chunk type */
+  type: 'text' | 'tool-call' | 'tool-result' | 'step-complete' | 'done';
+  /** Text content (for text chunks) */
+  text?: string;
+  /** Tool call info (for tool-call chunks) */
+  toolCall?: ToolCallInfo;
+  /** Tool result info (for tool-result chunks) */
+  toolResult?: ToolResultInfo;
+  /** Step index (for step-complete chunks) */
+  stepIndex?: number;
+  /** Final result (for done chunks) */
+  result?: ExternalExecuteResult;
+}
+/**
+ * Set of tools available to an external provider.
+ */
+type ExternalToolSet = Record<string, ExternalToolDefinition>;
+/**
+ * External tool definition in a provider-agnostic format.
+ */
+interface ExternalToolDefinition {
+  /** Tool name */
+  name: string;
+  /** Tool description */
+  description: string;
+  /** Input schema (JSON Schema format) */
+  inputSchema: Record<string, unknown>;
+  /** Whether tool requires user approval */
+  requiresApproval?: boolean;
+  /** Tool handler function */
+  execute?: (input: unknown) => Promise<unknown>;
+}
+/**
+ * Configuration for Claude Agent SDK provider.
+ */
+interface ClaudeAgentSDKConfig {
+  /** API key (defaults to ANTHROPIC_API_KEY env var) */
+  apiKey?: string;
+  /** Model to use (defaults to claude-sonnet-4-20250514) */
+  model?: string;
+  /** Enable extended thinking mode */
+  extendedThinking?: boolean;
+  /** Enable computer use capabilities (file editing, bash) */
+  computerUse?: boolean;
+  /** MCP servers to connect */
+  mcpServers?: McpClientConfig[];
+  /** Maximum tokens for response */
+  maxTokens?: number;
+  /** Temperature for generation */
+  temperature?: number;
+}
+/**
+ * Claude Agent SDK specific context metadata.
+ */
+interface ClaudeAgentContextMetadata {
+  /** Session ID for Claude Agent SDK */
+  sessionId?: string;
+  /** Whether computer use is enabled */
+  computerUseEnabled: boolean;
+  /** Whether extended thinking is enabled */
+  extendedThinkingEnabled: boolean;
+  /** Connected MCP servers */
+  mcpServerIds?: string[];
+  /** Allow additional metadata properties */
+  [key: string]: unknown;
+}
+/**
+ * Configuration for OpenCode SDK provider.
+ */
+interface OpenCodeSDKConfig {
+  /** Server URL (defaults to http://127.0.0.1:4096) */
+  serverUrl?: string;
+  /** Server port (alternative to full URL) */
+  port?: number;
+  /** Agent type to use */
+  agentType?: OpenCodeAgentType;
+  /** Session ID for resuming sessions */
+  sessionId?: string;
+  /** Model to use */
+  model?: string;
+  /** Temperature for generation */
+  temperature?: number;
+  /** Connection timeout in milliseconds */
+  timeout?: number;
+}
+/**
+ * OpenCode agent types.
+ */
+type OpenCodeAgentType = 'build' | 'plan' | 'general' | 'explore';
+/**
+ * OpenCode SDK specific context metadata.
+ */
+interface OpenCodeContextMetadata {
+  /** Session ID from OpenCode */
+  sessionId: string;
+  /** Agent type being used */
+  agentType: OpenCodeAgentType;
+  /** Server URL */
+  serverUrl: string;
+}
+/**
+ * Factory function type for creating providers.
+ */
+type ExternalProviderFactory<TConfig> = (config: TConfig) => ExternalAgentProvider;
+/**
+ * Registry of available providers.
+ */
+interface ProviderRegistry {
+  /** Get a provider by name */
+  get(name: string): ExternalAgentProvider | undefined;
+  /** Register a provider */
+  register(name: string, provider: ExternalAgentProvider): void;
+  /** List available provider names */
+  list(): string[];
+  /** Check if a provider is registered and available */
+  isAvailable(name: string): boolean;
+}
+/**
+ * Base error for external provider operations.
+ */
+declare class ExternalProviderError extends Error {
+  readonly provider: string;
+  readonly code: string;
+  readonly cause?: Error | undefined;
+  constructor(message: string, provider: string, code: string, cause?: Error | undefined);
+}
+/**
+ * Error when provider is not available.
+ */
+declare class ProviderNotAvailableError extends ExternalProviderError {
+  constructor(provider: string, reason?: string);
+}
+/**
+ * Error when provider execution fails.
+ */
+declare class ProviderExecutionError extends ExternalProviderError {
+  constructor(provider: string, message: string, cause?: Error);
+}
+/**
+ * Error when context creation fails.
+ */
+declare class ContextCreationError extends ExternalProviderError {
+  constructor(provider: string, message: string, cause?: Error);
+}
+//#endregion
+export { ClaudeAgentContextMetadata, ClaudeAgentSDKConfig, ContextCreationError, ExternalAgentContext, ExternalAgentProvider, ExternalExecuteParams, ExternalExecuteResult, ExternalProviderError, ExternalProviderFactory, ExternalStreamChunk, ExternalToolDefinition, ExternalToolSet, ExternalUsage, OpenCodeAgentType, OpenCodeContextMetadata, OpenCodeSDKConfig, ProviderExecutionError, ProviderNotAvailableError, ProviderRegistry };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/providers/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA0DY,UAjCK,qBAAA,CAiCL;EACO;EAAd,SAAA,IAAA,EAAA,MAAA;EAAa;EAWD,SAAA,OAAA,EAAA,MAAoB;EAI7B;;;;EAMW,WAAA,EAAA,EAAA,OAAA;EAMF;AAgBjB;;;EAQU,aAAA,CAAA,IAAA,EArEY,SAqEZ,CAAA,EArEwB,OAqExB,CArEgC,oBAqEhC,CAAA;EAEM;;;AAQhB;EASiB,OAAA,CAAA,OAAA,EAjFJ,oBAiFuB,EAAA,MAAA,EAhFxB,qBAgFwB,CAAA,EA/E/B,OA+E+B,CA/EvB,qBA+EuB,CAAA;EAMvB;;;;EAYD,MAAA,CAAA,OAAA,EA1FC,oBA0FgC,EAAA,MAAA,EAzFjC,qBAyFwB,CAAA,EAxF/B,aAwF+B,CAxFjB,mBAwFiB,CAAA;AAKpC;AAoBA;AAoBA;AAoBA;AAoBA;AAKiB,UAvKA,oBAAA,CAuKuB;EAgB5B;EAOK,EAAA,EAAA,MAAA;EAkBJ;EAKe,IAAA,EAjNpB,SAiNoB;EAAA;EALe,KAAA,EA1MlC,eA0MkC;EAAK;EAenC,OAAA,EAAA,GAAA,GAvNI,OAuNJ,CAAA,IAAA,CAA0B;EAc1B;EAUA,QAAA,CAAA,EA7OA,MA6OA,CAAA,MAAqB,EAAA,OAAA,CAAA;;;;;UAvOjB,qBAAA;;;;;;YAML;;WAED;;;;;;;UAQM,qBAAA;;;;aAIJ;;eAEE;;UAEL;;gBAEM;;aAEH;;;;;UAMI,aAAA;;;;;;;;UASA,mBAAA;;;;;;aAMJ;;eAEE;;;;WAIJ;;;;;KAMC,eAAA,GAAkB,eAAe;;;;UAK5B,sBAAA;;;;;;eAMF;;;;gCAIiB;;;;;UAUf,oBAAA;;;;;;;;;;eAUF;;;;;;;;;UAUE,0BAAA;;;;;;;;;;;;;;;UAoBA,iBAAA;;;;;;cAMH;;;;;;;;;;;;;KAcF,iBAAA;;;;UAKK,uBAAA;;;;aAIJ;;;;;;;KAYD,4CACF,YACL;;;;UAKY,gBAAA;;qBAEI;;mCAEc;;;;;;;;;cActB,qBAAA,SAA8B,KAAA;;;mBAKf;uEAAA;;;;;cAUf,yBAAA,SAAkC,qBAAA;;;;;;cAclC,sBAAA,SAA+B,qBAAA;yDACa;;;;;cAS5C,oBAAA,SAA6B,qBAAA;yDACe"}

package/dist/providers/types.js

@@ -0,0 +1,44 @@
+//#region src/providers/types.ts
+/**
+* Base error for external provider operations.
+*/
+var ExternalProviderError = class extends Error {
+	constructor(message, provider, code, cause) {
+		super(message);
+		this.provider = provider;
+		this.code = code;
+		this.cause = cause;
+		this.name = "ExternalProviderError";
+	}
+};
+/**
+* Error when provider is not available.
+*/
+var ProviderNotAvailableError = class extends ExternalProviderError {
+	constructor(provider, reason) {
+		super(`Provider '${provider}' is not available${reason ? `: ${reason}` : ""}`, provider, "PROVIDER_NOT_AVAILABLE");
+		this.name = "ProviderNotAvailableError";
+	}
+};
+/**
+* Error when provider execution fails.
+*/
+var ProviderExecutionError = class extends ExternalProviderError {
+	constructor(provider, message, cause) {
+		super(message, provider, "EXECUTION_FAILED", cause);
+		this.name = "ProviderExecutionError";
+	}
+};
+/**
+* Error when context creation fails.
+*/
+var ContextCreationError = class extends ExternalProviderError {
+	constructor(provider, message, cause) {
+		super(message, provider, "CONTEXT_CREATION_FAILED", cause);
+		this.name = "ContextCreationError";
+	}
+};
+
+//#endregion
+export { ContextCreationError, ExternalProviderError, ProviderExecutionError, ProviderNotAvailableError };
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["provider: string","code: string","cause?: Error"],"sources":["../../src/providers/types.ts"],"sourcesContent":["/**\n * External SDK provider types for ContractSpec agents.\n *\n * These interfaces define the contract for integrating external agent SDKs\n * (like @anthropic-ai/claude-agent-sdk and @opencode-ai/sdk) with ContractSpec's\n * agent system.\n */\n\nimport type { AgentSpec } from '../spec/spec';\nimport type {\n  AgentCallOptions,\n  AgentFinishReason,\n  ToolCallInfo,\n  ToolResultInfo,\n} from '../types';\nimport type { McpClientConfig } from '../tools/mcp-client';\n\n// ============================================================================\n// Core Provider Interface\n// ============================================================================\n\n/**\n * External SDK provider interface for ContractSpec agents.\n * Allows external SDKs to be used as execution backends.\n */\nexport interface ExternalAgentProvider {\n  /** Provider name identifier */\n  readonly name: string;\n  /** Provider version */\n  readonly version: string;\n\n  /**\n   * Check if this provider is available (dependencies installed, configured).\n   * Should be a quick synchronous check.\n   */\n  isAvailable(): boolean;\n\n  /**\n   * Create an execution context from an AgentSpec.\n   * This prepares the provider for execution with the given spec.\n   */\n  createContext(spec: AgentSpec): Promise<ExternalAgentContext>;\n\n  /**\n   * Execute a prompt using this provider.\n   * Non-streaming execution that returns the complete result.\n   */\n  execute(\n    context: ExternalAgentContext,\n    params: ExternalExecuteParams\n  ): Promise<ExternalExecuteResult>;\n\n  /**\n   * Stream execution with real-time updates.\n   * Returns an async iterable of stream chunks.\n   */\n  stream(\n    context: ExternalAgentContext,\n    params: ExternalExecuteParams\n  ): AsyncIterable<ExternalStreamChunk>;\n}\n\n// ============================================================================\n// Context and Execution Types\n// ============================================================================\n\n/**\n * Execution context created by a provider.\n * Holds the prepared state for executing prompts.\n */\nexport interface ExternalAgentContext {\n  /** Unique context ID */\n  id: string;\n  /** The spec this context was created from */\n  spec: AgentSpec;\n  /** Tools available in this context */\n  tools: ExternalToolSet;\n  /** Cleanup function to release resources */\n  cleanup: () => Promise<void>;\n  /** Provider-specific metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Parameters for executing a prompt.\n */\nexport interface ExternalExecuteParams {\n  /** The prompt to execute */\n  prompt: string;\n  /** Optional system prompt override/addition */\n  systemOverride?: string;\n  /** Call options (tenant, actor, session, metadata) */\n  options?: AgentCallOptions;\n  /** Abort signal for cancellation */\n  signal?: AbortSignal;\n  /** Maximum steps/iterations (provider may interpret differently) */\n  maxSteps?: number;\n}\n\n/**\n * Result from a non-streaming execution.\n */\nexport interface ExternalExecuteResult {\n  /** Final text response */\n  text: string;\n  /** Tool calls made during execution */\n  toolCalls: ToolCallInfo[];\n  /** Results from tool executions */\n  toolResults: ToolResultInfo[];\n  /** Token usage statistics */\n  usage?: ExternalUsage;\n  /** Reason the execution finished */\n  finishReason: AgentFinishReason;\n  /** Provider-specific result metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Token usage statistics.\n */\nexport interface ExternalUsage {\n  inputTokens: number;\n  outputTokens: number;\n  totalTokens?: number;\n}\n\n/**\n * Stream chunk from streaming execution.\n */\nexport interface ExternalStreamChunk {\n  /** Chunk type */\n  type: 'text' | 'tool-call' | 'tool-result' | 'step-complete' | 'done';\n  /** Text content (for text chunks) */\n  text?: string;\n  /** Tool call info (for tool-call chunks) */\n  toolCall?: ToolCallInfo;\n  /** Tool result info (for tool-result chunks) */\n  toolResult?: ToolResultInfo;\n  /** Step index (for step-complete chunks) */\n  stepIndex?: number;\n  /** Final result (for done chunks) */\n  result?: ExternalExecuteResult;\n}\n\n/**\n * Set of tools available to an external provider.\n */\nexport type ExternalToolSet = Record<string, ExternalToolDefinition>;\n\n/**\n * External tool definition in a provider-agnostic format.\n */\nexport interface ExternalToolDefinition {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Input schema (JSON Schema format) */\n  inputSchema: Record<string, unknown>;\n  /** Whether tool requires user approval */\n  requiresApproval?: boolean;\n  /** Tool handler function */\n  execute?: (input: unknown) => Promise<unknown>;\n}\n\n// ============================================================================\n// Claude Agent SDK Configuration\n// ============================================================================\n\n/**\n * Configuration for Claude Agent SDK provider.\n */\nexport interface ClaudeAgentSDKConfig {\n  /** API key (defaults to ANTHROPIC_API_KEY env var) */\n  apiKey?: string;\n  /** Model to use (defaults to claude-sonnet-4-20250514) */\n  model?: string;\n  /** Enable extended thinking mode */\n  extendedThinking?: boolean;\n  /** Enable computer use capabilities (file editing, bash) */\n  computerUse?: boolean;\n  /** MCP servers to connect */\n  mcpServers?: McpClientConfig[];\n  /** Maximum tokens for response */\n  maxTokens?: number;\n  /** Temperature for generation */\n  temperature?: number;\n}\n\n/**\n * Claude Agent SDK specific context metadata.\n */\nexport interface ClaudeAgentContextMetadata {\n  /** Session ID for Claude Agent SDK */\n  sessionId?: string;\n  /** Whether computer use is enabled */\n  computerUseEnabled: boolean;\n  /** Whether extended thinking is enabled */\n  extendedThinkingEnabled: boolean;\n  /** Connected MCP servers */\n  mcpServerIds?: string[];\n  /** Allow additional metadata properties */\n  [key: string]: unknown;\n}\n\n// ============================================================================\n// OpenCode SDK Configuration\n// ============================================================================\n\n/**\n * Configuration for OpenCode SDK provider.\n */\nexport interface OpenCodeSDKConfig {\n  /** Server URL (defaults to http://127.0.0.1:4096) */\n  serverUrl?: string;\n  /** Server port (alternative to full URL) */\n  port?: number;\n  /** Agent type to use */\n  agentType?: OpenCodeAgentType;\n  /** Session ID for resuming sessions */\n  sessionId?: string;\n  /** Model to use */\n  model?: string;\n  /** Temperature for generation */\n  temperature?: number;\n  /** Connection timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * OpenCode agent types.\n */\nexport type OpenCodeAgentType = 'build' | 'plan' | 'general' | 'explore';\n\n/**\n * OpenCode SDK specific context metadata.\n */\nexport interface OpenCodeContextMetadata {\n  /** Session ID from OpenCode */\n  sessionId: string;\n  /** Agent type being used */\n  agentType: OpenCodeAgentType;\n  /** Server URL */\n  serverUrl: string;\n}\n\n// ============================================================================\n// Provider Factory Types\n// ============================================================================\n\n/**\n * Factory function type for creating providers.\n */\nexport type ExternalProviderFactory<TConfig> = (\n  config: TConfig\n) => ExternalAgentProvider;\n\n/**\n * Registry of available providers.\n */\nexport interface ProviderRegistry {\n  /** Get a provider by name */\n  get(name: string): ExternalAgentProvider | undefined;\n  /** Register a provider */\n  register(name: string, provider: ExternalAgentProvider): void;\n  /** List available provider names */\n  list(): string[];\n  /** Check if a provider is registered and available */\n  isAvailable(name: string): boolean;\n}\n\n// ============================================================================\n// Error Types\n// ============================================================================\n\n/**\n * Base error for external provider operations.\n */\nexport class ExternalProviderError extends Error {\n  constructor(\n    message: string,\n    public readonly provider: string,\n    public readonly code: string,\n    public readonly cause?: Error\n  ) {\n    super(message);\n    this.name = 'ExternalProviderError';\n  }\n}\n\n/**\n * Error when provider is not available.\n */\nexport class ProviderNotAvailableError extends ExternalProviderError {\n  constructor(provider: string, reason?: string) {\n    super(\n      `Provider '${provider}' is not available${reason ? `: ${reason}` : ''}`,\n      provider,\n      'PROVIDER_NOT_AVAILABLE'\n    );\n    this.name = 'ProviderNotAvailableError';\n  }\n}\n\n/**\n * Error when provider execution fails.\n */\nexport class ProviderExecutionError extends ExternalProviderError {\n  constructor(provider: string, message: string, cause?: Error) {\n    super(message, provider, 'EXECUTION_FAILED', cause);\n    this.name = 'ProviderExecutionError';\n  }\n}\n\n/**\n * Error when context creation fails.\n */\nexport class ContextCreationError extends ExternalProviderError {\n  constructor(provider: string, message: string, cause?: Error) {\n    super(message, provider, 'CONTEXT_CREATION_FAILED', cause);\n    this.name = 'ContextCreationError';\n  }\n}\n"],"mappings":";;;;AAsRA,IAAa,wBAAb,cAA2C,MAAM;CAC/C,YACE,SACA,AAAgBA,UAChB,AAAgBC,MAChB,AAAgBC,OAChB;AACA,QAAM,QAAQ;EAJE;EACA;EACA;AAGhB,OAAK,OAAO;;;;;;AAOhB,IAAa,4BAAb,cAA+C,sBAAsB;CACnE,YAAY,UAAkB,QAAiB;AAC7C,QACE,aAAa,SAAS,oBAAoB,SAAS,KAAK,WAAW,MACnE,UACA,yBACD;AACD,OAAK,OAAO;;;;;;AAOhB,IAAa,yBAAb,cAA4C,sBAAsB;CAChE,YAAY,UAAkB,SAAiB,OAAe;AAC5D,QAAM,SAAS,UAAU,oBAAoB,MAAM;AACnD,OAAK,OAAO;;;;;;AAOhB,IAAa,uBAAb,cAA0C,sBAAsB;CAC9D,YAAY,UAAkB,SAAiB,OAAe;AAC5D,QAAM,SAAS,UAAU,2BAA2B,MAAM;AAC1D,OAAK,OAAO"}

package/dist/tools/index.d.ts

@@ -1,5 +1,5 @@
+import { McpClientConfig, McpClientResult, createMcpToolsets, mcpServerToTools } from "./mcp-client.js";
 import { buildToolHandlers, createToolHandler, specToolToAISDKTool, specToolsToAISDKTools } from "./tool-adapter.js";
 import { createKnowledgeQueryTool } from "./knowledge-tool.js";
-import { McpClientConfig, McpClientResult, createMcpToolsets, mcpServerToTools } from "./mcp-client.js";
 import { AgentMcpServerConfig, agentToMcpServer, createAgentMcpServer } from "./mcp-server.js";
 export { AgentMcpServerConfig, McpClientConfig, McpClientResult, agentToMcpServer, buildToolHandlers, createAgentMcpServer, createKnowledgeQueryTool, createMcpToolsets, createToolHandler, mcpServerToTools, specToolToAISDKTool, specToolsToAISDKTools };

package/dist/types.d.ts

@@ -142,5 +142,5 @@ interface AgentStepMetrics {
 }
 type AgentEventEmitter = (event: AgentEventName, payload: AgentEventPayload) => void | Promise<void>;
 //#endregion
-export { AgentCallOptions, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentFinishReason, AgentGenerateParams, AgentGenerateResult, AgentMessage, AgentSessionState, AgentStatus, AgentStepMetrics, AgentStreamParams, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolResultInfo };
+export { AgentCallOptions, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentFinishReason, AgentGenerateParams, AgentGenerateResult, AgentMessage, AgentSessionState, AgentStatus, AgentStepMetrics, AgentStreamParams, type LanguageModelUsage, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolResultInfo };
 //# sourceMappingURL=types.d.ts.map