@contractspec/lib.ai-agent 1.45.6 → 1.46.1

package/dist/_virtual/rolldown_runtime.js

@@ -0,0 +1,8 @@
+//#region rolldown:runtime
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function.");
+});
+
+//#endregion
+export { __require };

package/dist/agent/index.d.ts

@@ -1,3 +1,3 @@
 import { ContractSpecAgent, ContractSpecAgentConfig } from "./contract-spec-agent.js";
-import { AgentFactory, AgentFactoryConfig, CreateAgentOptions, createAgentFactory } from "./agent-factory.js";
-export { AgentFactory, AgentFactoryConfig, ContractSpecAgent, ContractSpecAgentConfig, CreateAgentOptions, createAgentFactory };
+import { UnifiedAgent, UnifiedAgentBackend, UnifiedAgentBackendConfig, UnifiedAgentConfig, UnifiedAgentRunOptions, UnifiedAgentState, createAISDKAgent, createClaudeAgentSDKAgent, createOpenCodeSDKAgent, createUnifiedAgent, getAvailableBackends } from "./unified-agent.js";
+export { ContractSpecAgent, ContractSpecAgentConfig, UnifiedAgent, UnifiedAgentBackend, UnifiedAgentBackendConfig, UnifiedAgentConfig, UnifiedAgentRunOptions, UnifiedAgentState, createAISDKAgent, createClaudeAgentSDKAgent, createOpenCodeSDKAgent, createUnifiedAgent, getAvailableBackends };

package/dist/agent/index.js

@@ -1,4 +1,4 @@
 import { ContractSpecAgent } from "./contract-spec-agent.js";
-import { AgentFactory, createAgentFactory } from "./agent-factory.js";
+import { UnifiedAgent, createAISDKAgent, createClaudeAgentSDKAgent, createOpenCodeSDKAgent, createUnifiedAgent, getAvailableBackends } from "./unified-agent.js";
 
-export { AgentFactory, ContractSpecAgent, createAgentFactory };
+export { ContractSpecAgent, UnifiedAgent, createAISDKAgent, createClaudeAgentSDKAgent, createOpenCodeSDKAgent, createUnifiedAgent, getAvailableBackends };

package/dist/agent/unified-agent.d.ts

@@ -0,0 +1,131 @@
+import { AgentSpec } from "../spec/spec.js";
+import { AgentCallOptions, AgentGenerateResult, ToolHandler } from "../types.js";
+import { ClaudeAgentSDKConfig, OpenCodeSDKConfig } from "../providers/types.js";
+
+//#region src/agent/unified-agent.d.ts
+
+/** Supported backend types */
+type UnifiedAgentBackend = 'ai-sdk' | 'claude-agent-sdk' | 'opencode-sdk';
+/** Backend-specific configuration */
+interface UnifiedAgentBackendConfig {
+  'ai-sdk'?: {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+  };
+  'claude-agent-sdk'?: ClaudeAgentSDKConfig;
+  'opencode-sdk'?: OpenCodeSDKConfig;
+}
+/** Unified agent configuration */
+interface UnifiedAgentConfig {
+  /** Backend to use */
+  backend: UnifiedAgentBackend;
+  /** Backend-specific configuration */
+  config?: UnifiedAgentBackendConfig[UnifiedAgentBackend];
+  /** Tool handlers for the agent */
+  tools?: Map<string, ToolHandler>;
+  /** Fallback backend if primary fails */
+  fallbackBackend?: UnifiedAgentBackend;
+  /** Enable verbose logging */
+  verbose?: boolean;
+}
+/** Unified agent run options */
+interface UnifiedAgentRunOptions extends AgentCallOptions {
+  /** Override backend for this call */
+  backend?: UnifiedAgentBackend;
+}
+/** Unified agent state */
+interface UnifiedAgentState {
+  backend: UnifiedAgentBackend;
+  isReady: boolean;
+  sessionId?: string;
+  messageCount: number;
+  lastError?: Error;
+}
+/**
+ * Unified agent that works across multiple backends.
+ */
+declare class UnifiedAgent {
+  private readonly spec;
+  private readonly config;
+  private readonly tools;
+  private provider?;
+  private context?;
+  private state;
+  constructor(spec: AgentSpec, config: UnifiedAgentConfig);
+  /**
+   * Initialize the agent with its backend.
+   */
+  initialize(): Promise<void>;
+  private initializeClaudeAgentSDK;
+  private initializeOpenCodeSDK;
+  /**
+   * Run the agent with a message.
+   */
+  run(message: string, options?: UnifiedAgentRunOptions): Promise<AgentGenerateResult>;
+  private runWithAISDK;
+  private runWithExternalProvider;
+  private convertExternalResult;
+  /**
+   * Get agent state.
+   */
+  getState(): UnifiedAgentState;
+  /**
+   * Get the agent spec.
+   */
+  getSpec(): AgentSpec;
+  /**
+   * Get the current backend.
+   */
+  getBackend(): UnifiedAgentBackend;
+  /**
+   * Check if a specific backend is available.
+   */
+  isBackendAvailable(backend: UnifiedAgentBackend): Promise<boolean>;
+  /**
+   * Switch to a different backend.
+   */
+  switchBackend(backend: UnifiedAgentBackend): Promise<void>;
+  /**
+   * Reset the agent state.
+   */
+  reset(): void;
+  /**
+   * Add a tool handler.
+   */
+  addTool(name: string, handler: ToolHandler): void;
+  /**
+   * Remove a tool handler.
+   */
+  removeTool(name: string): boolean;
+}
+/**
+ * Create a unified agent.
+ */
+declare function createUnifiedAgent(spec: AgentSpec, config: UnifiedAgentConfig): UnifiedAgent;
+/**
+ * Create a unified agent with AI SDK backend (default).
+ */
+declare function createAISDKAgent(spec: AgentSpec, options?: {
+  tools?: Map<string, ToolHandler>;
+  model?: string;
+}): UnifiedAgent;
+/**
+ * Create a unified agent with Claude Agent SDK backend.
+ */
+declare function createClaudeAgentSDKAgent(spec: AgentSpec, config?: ClaudeAgentSDKConfig & {
+  tools?: Map<string, ToolHandler>;
+}): UnifiedAgent;
+/**
+ * Create a unified agent with OpenCode SDK backend.
+ */
+declare function createOpenCodeSDKAgent(spec: AgentSpec, config?: OpenCodeSDKConfig & {
+  tools?: Map<string, ToolHandler>;
+}): UnifiedAgent;
+/**
+ * Get available backends.
+ */
+declare function getAvailableBackends(): Promise<UnifiedAgentBackend[]>;
+//#endregion
+export { UnifiedAgent, UnifiedAgentBackend, UnifiedAgentBackendConfig, UnifiedAgentConfig, UnifiedAgentRunOptions, UnifiedAgentState, createAISDKAgent, createClaudeAgentSDKAgent, createOpenCodeSDKAgent, createUnifiedAgent, getAvailableBackends };
+//# sourceMappingURL=unified-agent.d.ts.map

package/dist/agent/unified-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-agent.d.ts","names":[],"sources":["../../src/agent/unified-agent.ts"],"sourcesContent":[],"mappings":";;;;;;;AAoZiC,KAtWrB,mBAAA,GAsWqB,QAAA,GAAA,kBAAA,GAAA,cAAA;;AAmBjB,UAnXC,yBAAA,CAmXiB;EAC1B,QAAA,CAAA,EAAA;IACE,KAAA,CAAA,EAAA,MAAA;IACP,WAAA,CAAA,EAAA,MAAA;IAAY,SAAA,CAAA,EAAA,MAAA;EAOC,CAAA;EACR,kBAAA,CAAA,EAxXe,oBAwXf;EAEgB,cAAA,CAAA,EAzXL,iBAyXK;;;AAGT,UAxXE,kBAAA,CAwXF;EAWC;EACR,OAAA,EAlYG,mBAkYH;EACG;EACa,MAAA,CAAA,EAlYb,yBAkYa,CAlYa,mBAkYb,CAAA;EAAZ;EAET,KAAA,CAAA,EAlYO,GAkYP,CAAA,MAAA,EAlYmB,WAkYnB,CAAA;EAAY;EAYC,eAAA,CAAA,EA5YI,mBA4YkB;EAC9B;EACG,OAAA,CAAA,EAAA,OAAA;;;AAGR,UA3Yc,sBAAA,SAA+B,gBA2Y7C,CAAA;EAAY;EAYO,OAAA,CAAA,EArZV,mBAqZ8B;;;UAjZzB,iBAAA;WACN;;;;cAIG;;;;;cAUD,YAAA;;;;;;;oBAQO,mBAAmB;;;;gBAcjB;;;;;;iCA+FR,yBACT,QAAQ;;;;;;;cA4GC;;;;aAOD;;;;gBAOG;;;;8BAOoB,sBAAsB;;;;yBAiC3B,sBAAsB;;;;;;;;iCA0BpB;;;;;;;;;iBAmBjB,kBAAA,OACR,mBACE,qBACP;;;;iBAOa,gBAAA,OACR;UAEI,YAAY;;IAGrB;;;;iBAWa,yBAAA,OACR,oBACG;UACC,YAAY;IAErB;;;;iBAYa,sBAAA,OACR,oBACG;UACC,YAAY;IAErB;;;;iBAYmB,oBAAA,CAAA,GAAwB,QAAQ"}

package/dist/agent/unified-agent.js

@@ -0,0 +1,267 @@
+//#region src/agent/unified-agent.ts
+/**
+* Unified agent that works across multiple backends.
+*/
+var UnifiedAgent = class {
+	spec;
+	config;
+	tools;
+	provider;
+	context;
+	state;
+	constructor(spec, config) {
+		this.spec = spec;
+		this.config = config;
+		this.tools = config.tools ?? /* @__PURE__ */ new Map();
+		this.state = {
+			backend: config.backend,
+			isReady: false,
+			messageCount: 0
+		};
+	}
+	/**
+	* Initialize the agent with its backend.
+	*/
+	async initialize() {
+		const backend = this.config.backend;
+		try {
+			switch (backend) {
+				case "ai-sdk":
+					this.state.isReady = true;
+					break;
+				case "claude-agent-sdk":
+					await this.initializeClaudeAgentSDK();
+					break;
+				case "opencode-sdk":
+					await this.initializeOpenCodeSDK();
+					break;
+				default: throw new Error(`Unknown backend: ${backend}`);
+			}
+		} catch (error) {
+			this.state.lastError = error instanceof Error ? error : new Error(String(error));
+			if (this.config.fallbackBackend && this.config.fallbackBackend !== backend) {
+				console.warn(`[UnifiedAgent] ${backend} failed, falling back to ${this.config.fallbackBackend}`);
+				this.state.backend = this.config.fallbackBackend;
+				await this.initialize();
+			} else throw error;
+		}
+	}
+	async initializeClaudeAgentSDK() {
+		try {
+			const { ClaudeAgentSDKProvider } = await import("../providers/claude-agent-sdk/index.js");
+			const config = this.config.config;
+			this.provider = new ClaudeAgentSDKProvider(config ?? {});
+			if (!this.provider.isAvailable()) throw new Error("Claude Agent SDK not available. Install @anthropic-ai/claude-agent-sdk");
+			this.context = await this.provider.createContext(this.spec);
+			this.state.isReady = true;
+		} catch (error) {
+			if (error.code === "MODULE_NOT_FOUND") throw new Error("Claude Agent SDK not installed. Run: npm install @anthropic-ai/claude-agent-sdk");
+			throw error;
+		}
+	}
+	async initializeOpenCodeSDK() {
+		try {
+			const { OpenCodeSDKProvider } = await import("../providers/opencode-sdk/index.js");
+			const config = this.config.config;
+			this.provider = new OpenCodeSDKProvider(config ?? {});
+			if (!this.provider.isAvailable()) throw new Error("OpenCode SDK not available. Install @opencode-ai/sdk");
+			this.context = await this.provider.createContext(this.spec);
+			this.state.isReady = true;
+		} catch (error) {
+			if (error.code === "MODULE_NOT_FOUND") throw new Error("OpenCode SDK not installed. Run: npm install @opencode-ai/sdk");
+			throw error;
+		}
+	}
+	/**
+	* Run the agent with a message.
+	*/
+	async run(message, options) {
+		if (!this.state.isReady) await this.initialize();
+		const backend = options?.backend ?? this.state.backend;
+		this.state.messageCount++;
+		try {
+			switch (backend) {
+				case "ai-sdk": return await this.runWithAISDK(message, options);
+				case "claude-agent-sdk":
+				case "opencode-sdk": return await this.runWithExternalProvider(message, options);
+				default: throw new Error(`Unknown backend: ${backend}`);
+			}
+		} catch (error) {
+			this.state.lastError = error instanceof Error ? error : new Error(String(error));
+			throw error;
+		}
+	}
+	async runWithAISDK(message, options) {
+		const { ContractSpecAgent } = await import("./contract-spec-agent.js");
+		const { anthropic } = await import("@ai-sdk/anthropic");
+		const backendConfig = this.config.backend === "ai-sdk" ? this.config.config : {};
+		return await (await ContractSpecAgent.create({
+			spec: this.spec,
+			model: anthropic(backendConfig?.model ?? "claude-3-5-sonnet-20240620"),
+			toolHandlers: this.tools
+		})).generate({
+			prompt: message,
+			options
+		});
+	}
+	async runWithExternalProvider(message, options) {
+		if (!this.provider || !this.context) throw new Error("Provider not initialized");
+		const result = await this.provider.execute(this.context, {
+			prompt: message,
+			options
+		});
+		return this.convertExternalResult(result);
+	}
+	convertExternalResult(result) {
+		return {
+			text: result.text,
+			steps: [],
+			toolCalls: result.toolCalls.map((tc) => ({
+				type: "tool-call",
+				toolCallId: tc.toolCallId,
+				toolName: tc.toolName,
+				args: tc.args
+			})),
+			toolResults: result.toolResults.map((tr) => ({
+				type: "tool-result",
+				toolCallId: tr.toolCallId,
+				toolName: tr.toolName,
+				output: tr.output
+			})),
+			finishReason: result.finishReason,
+			usage: result.usage ? {
+				promptTokens: result.usage.inputTokens,
+				completionTokens: result.usage.outputTokens,
+				totalTokens: result.usage.totalTokens ?? result.usage.inputTokens + result.usage.outputTokens
+			} : void 0
+		};
+	}
+	/**
+	* Get agent state.
+	*/
+	getState() {
+		return { ...this.state };
+	}
+	/**
+	* Get the agent spec.
+	*/
+	getSpec() {
+		return this.spec;
+	}
+	/**
+	* Get the current backend.
+	*/
+	getBackend() {
+		return this.state.backend;
+	}
+	/**
+	* Check if a specific backend is available.
+	*/
+	async isBackendAvailable(backend) {
+		switch (backend) {
+			case "ai-sdk": return true;
+			case "claude-agent-sdk": try {
+				const { ClaudeAgentSDKProvider } = await import("../providers/claude-agent-sdk/index.js");
+				return new ClaudeAgentSDKProvider({}).isAvailable();
+			} catch {
+				return false;
+			}
+			case "opencode-sdk": try {
+				const { OpenCodeSDKProvider } = await import("../providers/opencode-sdk/index.js");
+				return new OpenCodeSDKProvider({}).isAvailable();
+			} catch {
+				return false;
+			}
+			default: return false;
+		}
+	}
+	/**
+	* Switch to a different backend.
+	*/
+	async switchBackend(backend) {
+		if (backend === this.state.backend) return;
+		this.state.backend = backend;
+		this.state.isReady = false;
+		this.provider = void 0;
+		this.context = void 0;
+		await this.initialize();
+	}
+	/**
+	* Reset the agent state.
+	*/
+	reset() {
+		this.state.messageCount = 0;
+		this.state.sessionId = void 0;
+		this.state.lastError = void 0;
+		this.context = void 0;
+	}
+	/**
+	* Add a tool handler.
+	*/
+	addTool(name, handler) {
+		this.tools.set(name, handler);
+	}
+	/**
+	* Remove a tool handler.
+	*/
+	removeTool(name) {
+		return this.tools.delete(name);
+	}
+};
+/**
+* Create a unified agent.
+*/
+function createUnifiedAgent(spec, config) {
+	return new UnifiedAgent(spec, config);
+}
+/**
+* Create a unified agent with AI SDK backend (default).
+*/
+function createAISDKAgent(spec, options) {
+	return new UnifiedAgent(spec, {
+		backend: "ai-sdk",
+		tools: options?.tools,
+		config: { model: options?.model }
+	});
+}
+/**
+* Create a unified agent with Claude Agent SDK backend.
+*/
+function createClaudeAgentSDKAgent(spec, config) {
+	const { tools, ...sdkConfig } = config ?? {};
+	return new UnifiedAgent(spec, {
+		backend: "claude-agent-sdk",
+		tools,
+		config: sdkConfig
+	});
+}
+/**
+* Create a unified agent with OpenCode SDK backend.
+*/
+function createOpenCodeSDKAgent(spec, config) {
+	const { tools, ...sdkConfig } = config ?? {};
+	return new UnifiedAgent(spec, {
+		backend: "opencode-sdk",
+		tools,
+		config: sdkConfig
+	});
+}
+/**
+* Get available backends.
+*/
+async function getAvailableBackends() {
+	const backends = ["ai-sdk"];
+	try {
+		const { ClaudeAgentSDKProvider } = await import("../providers/claude-agent-sdk/index.js");
+		if (new ClaudeAgentSDKProvider({}).isAvailable()) backends.push("claude-agent-sdk");
+	} catch {}
+	try {
+		const { OpenCodeSDKProvider } = await import("../providers/opencode-sdk/index.js");
+		if (new OpenCodeSDKProvider({}).isAvailable()) backends.push("opencode-sdk");
+	} catch {}
+	return backends;
+}
+
+//#endregion
+export { UnifiedAgent, createAISDKAgent, createClaudeAgentSDKAgent, createOpenCodeSDKAgent, createUnifiedAgent, getAvailableBackends };
+//# sourceMappingURL=unified-agent.js.map

package/dist/agent/unified-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-agent.js","names":["result: ExternalExecuteResult","backends: UnifiedAgentBackend[]"],"sources":["../../src/agent/unified-agent.ts"],"sourcesContent":["/**\n * Unified Agent Wrapper\n *\n * Provides a single API surface for running agents regardless of backend:\n * - AI SDK v6 (existing ContractSpec implementation)\n * - Claude Agent SDK (@anthropic-ai/claude-agent-sdk)\n * - OpenCode SDK (@opencode-ai/sdk)\n *\n * @example\n * ```typescript\n * import { UnifiedAgent, createUnifiedAgent } from '@contractspec/lib.ai-agent';\n *\n * // Create agent with AI SDK backend (default)\n * const agent = createUnifiedAgent(mySpec, {\n *   backend: 'ai-sdk',\n * });\n *\n * // Create agent with Claude Agent SDK backend\n * const claudeAgent = createUnifiedAgent(mySpec, {\n *   backend: 'claude-agent-sdk',\n *   config: { extendedThinking: true },\n * });\n *\n * // All agents use the same API\n * const response = await agent.run('Hello');\n * ```\n */\nimport type { AgentSpec } from '../spec/spec';\nimport type {\n  AgentCallOptions,\n  AgentGenerateResult,\n  ToolHandler,\n  LanguageModelUsage,\n} from '../types';\nimport type {\n  ExternalAgentProvider,\n  ClaudeAgentSDKConfig,\n  OpenCodeSDKConfig,\n  ExternalExecuteResult,\n} from '../providers/types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/** Supported backend types */\nexport type UnifiedAgentBackend =\n  | 'ai-sdk'\n  | 'claude-agent-sdk'\n  | 'opencode-sdk';\n\n/** Backend-specific configuration */\nexport interface UnifiedAgentBackendConfig {\n  'ai-sdk'?: {\n    model?: string;\n    temperature?: number;\n    maxTokens?: number;\n  };\n  'claude-agent-sdk'?: ClaudeAgentSDKConfig;\n  'opencode-sdk'?: OpenCodeSDKConfig;\n}\n\n/** Unified agent configuration */\nexport interface UnifiedAgentConfig {\n  /** Backend to use */\n  backend: UnifiedAgentBackend;\n  /** Backend-specific configuration */\n  config?: UnifiedAgentBackendConfig[UnifiedAgentBackend];\n  /** Tool handlers for the agent */\n  tools?: Map<string, ToolHandler>;\n  /** Fallback backend if primary fails */\n  fallbackBackend?: UnifiedAgentBackend;\n  /** Enable verbose logging */\n  verbose?: boolean;\n}\n\n/** Unified agent run options */\nexport interface UnifiedAgentRunOptions extends AgentCallOptions {\n  /** Override backend for this call */\n  backend?: UnifiedAgentBackend;\n}\n\n/** Unified agent state */\nexport interface UnifiedAgentState {\n  backend: UnifiedAgentBackend;\n  isReady: boolean;\n  sessionId?: string;\n  messageCount: number;\n  lastError?: Error;\n}\n\n// =============================================================================\n// Unified Agent Implementation\n// =============================================================================\n\n/**\n * Unified agent that works across multiple backends.\n */\nexport class UnifiedAgent {\n  private readonly spec: AgentSpec;\n  private readonly config: UnifiedAgentConfig;\n  private readonly tools: Map<string, ToolHandler>;\n  private provider?: ExternalAgentProvider;\n  private context?: unknown;\n  private state: UnifiedAgentState;\n\n  constructor(spec: AgentSpec, config: UnifiedAgentConfig) {\n    this.spec = spec;\n    this.config = config;\n    this.tools = config.tools ?? new Map();\n    this.state = {\n      backend: config.backend,\n      isReady: false,\n      messageCount: 0,\n    };\n  }\n\n  /**\n   * Initialize the agent with its backend.\n   */\n  async initialize(): Promise<void> {\n    const backend = this.config.backend;\n\n    try {\n      switch (backend) {\n        case 'ai-sdk':\n          // AI SDK is always available\n          this.state.isReady = true;\n          break;\n\n        case 'claude-agent-sdk':\n          await this.initializeClaudeAgentSDK();\n          break;\n\n        case 'opencode-sdk':\n          await this.initializeOpenCodeSDK();\n          break;\n\n        default:\n          throw new Error(`Unknown backend: ${backend}`);\n      }\n    } catch (error) {\n      this.state.lastError =\n        error instanceof Error ? error : new Error(String(error));\n\n      // Try fallback if configured\n      if (\n        this.config.fallbackBackend &&\n        this.config.fallbackBackend !== backend\n      ) {\n        console.warn(\n          `[UnifiedAgent] ${backend} failed, falling back to ${this.config.fallbackBackend}`\n        );\n        this.state.backend = this.config.fallbackBackend;\n        await this.initialize();\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  private async initializeClaudeAgentSDK(): Promise<void> {\n    // Dynamic import to avoid requiring the dependency\n    try {\n      const { ClaudeAgentSDKProvider } =\n        await import('../providers/claude-agent-sdk');\n      const config = this.config.config as ClaudeAgentSDKConfig | undefined;\n      this.provider = new ClaudeAgentSDKProvider(config ?? {});\n\n      if (!this.provider.isAvailable()) {\n        throw new Error(\n          'Claude Agent SDK not available. Install @anthropic-ai/claude-agent-sdk'\n        );\n      }\n\n      this.context = await this.provider.createContext(this.spec);\n      this.state.isReady = true;\n    } catch (error) {\n      if ((error as { code?: string }).code === 'MODULE_NOT_FOUND') {\n        throw new Error(\n          'Claude Agent SDK not installed. Run: npm install @anthropic-ai/claude-agent-sdk'\n        );\n      }\n      throw error;\n    }\n  }\n\n  private async initializeOpenCodeSDK(): Promise<void> {\n    // Dynamic import to avoid requiring the dependency\n    try {\n      const { OpenCodeSDKProvider } = await import('../providers/opencode-sdk');\n      const config = this.config.config as OpenCodeSDKConfig | undefined;\n      this.provider = new OpenCodeSDKProvider(config ?? {});\n\n      if (!this.provider.isAvailable()) {\n        throw new Error('OpenCode SDK not available. Install @opencode-ai/sdk');\n      }\n\n      this.context = await this.provider.createContext(this.spec);\n      this.state.isReady = true;\n    } catch (error) {\n      if ((error as { code?: string }).code === 'MODULE_NOT_FOUND') {\n        throw new Error(\n          'OpenCode SDK not installed. Run: npm install @opencode-ai/sdk'\n        );\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Run the agent with a message.\n   */\n  async run(\n    message: string,\n    options?: UnifiedAgentRunOptions\n  ): Promise<AgentGenerateResult> {\n    if (!this.state.isReady) {\n      await this.initialize();\n    }\n\n    const backend = options?.backend ?? this.state.backend;\n    this.state.messageCount++;\n\n    try {\n      switch (backend) {\n        case 'ai-sdk':\n          return await this.runWithAISDK(message, options);\n\n        case 'claude-agent-sdk':\n        case 'opencode-sdk':\n          return await this.runWithExternalProvider(message, options);\n\n        default:\n          throw new Error(`Unknown backend: ${backend}`);\n      }\n    } catch (error) {\n      this.state.lastError =\n        error instanceof Error ? error : new Error(String(error));\n      throw error;\n    }\n  }\n\n  private async runWithAISDK(\n    message: string,\n    options?: UnifiedAgentRunOptions\n  ): Promise<AgentGenerateResult> {\n    // Import the existing ContractSpec agent factory\n    const { ContractSpecAgent } = await import('./contract-spec-agent');\n    const { anthropic } = await import('@ai-sdk/anthropic');\n\n    // Use factory method create() instead of new\n    const backendConfig =\n      this.config.backend === 'ai-sdk'\n        ? (this.config.config as Record<string, unknown>)\n        : {};\n\n    const agent = await ContractSpecAgent.create({\n      spec: this.spec,\n      model: anthropic(\n        (backendConfig?.model as string) ?? 'claude-3-5-sonnet-20240620'\n      ),\n      toolHandlers: this.tools,\n    });\n\n    return await agent.generate({\n      prompt: message,\n      options,\n    });\n  }\n\n  private async runWithExternalProvider(\n    message: string,\n    options?: UnifiedAgentRunOptions\n  ): Promise<AgentGenerateResult> {\n    if (!this.provider || !this.context) {\n      throw new Error('Provider not initialized');\n    }\n\n    const result: ExternalExecuteResult = await this.provider.execute(\n      this.context as Parameters<ExternalAgentProvider['execute']>[0],\n      {\n        prompt: message,\n        options,\n      }\n    );\n\n    return this.convertExternalResult(result);\n  }\n\n  private convertExternalResult(\n    result: ExternalExecuteResult\n  ): AgentGenerateResult {\n    return {\n      text: result.text,\n      steps: [],\n      toolCalls: result.toolCalls.map((tc) => ({\n        type: 'tool-call' as const,\n        toolCallId: tc.toolCallId,\n        toolName: tc.toolName,\n        args: tc.args,\n      })),\n      toolResults: result.toolResults.map((tr) => ({\n        type: 'tool-result' as const,\n        toolCallId: tr.toolCallId,\n        toolName: tr.toolName,\n        output: tr.output,\n      })),\n      finishReason: result.finishReason,\n      usage: result.usage\n        ? ({\n            promptTokens: result.usage.inputTokens,\n            completionTokens: result.usage.outputTokens,\n            totalTokens:\n              result.usage.totalTokens ??\n              result.usage.inputTokens + result.usage.outputTokens,\n          } as unknown as LanguageModelUsage)\n        : undefined,\n    };\n  }\n\n  /**\n   * Get agent state.\n   */\n  getState(): UnifiedAgentState {\n    return { ...this.state };\n  }\n\n  /**\n   * Get the agent spec.\n   */\n  getSpec(): AgentSpec {\n    return this.spec;\n  }\n\n  /**\n   * Get the current backend.\n   */\n  getBackend(): UnifiedAgentBackend {\n    return this.state.backend;\n  }\n\n  /**\n   * Check if a specific backend is available.\n   */\n  async isBackendAvailable(backend: UnifiedAgentBackend): Promise<boolean> {\n    switch (backend) {\n      case 'ai-sdk':\n        return true;\n\n      case 'claude-agent-sdk':\n        try {\n          const { ClaudeAgentSDKProvider } =\n            await import('../providers/claude-agent-sdk');\n          const provider = new ClaudeAgentSDKProvider({});\n          return provider.isAvailable();\n        } catch {\n          return false;\n        }\n\n      case 'opencode-sdk':\n        try {\n          const { OpenCodeSDKProvider } =\n            await import('../providers/opencode-sdk');\n          const provider = new OpenCodeSDKProvider({});\n          return provider.isAvailable();\n        } catch {\n          return false;\n        }\n\n      default:\n        return false;\n    }\n  }\n\n  /**\n   * Switch to a different backend.\n   */\n  async switchBackend(backend: UnifiedAgentBackend): Promise<void> {\n    if (backend === this.state.backend) {\n      return;\n    }\n\n    this.state.backend = backend;\n    this.state.isReady = false;\n    this.provider = undefined;\n    this.context = undefined;\n\n    await this.initialize();\n  }\n\n  /**\n   * Reset the agent state.\n   */\n  reset(): void {\n    this.state.messageCount = 0;\n    this.state.sessionId = undefined;\n    this.state.lastError = undefined;\n    this.context = undefined;\n  }\n\n  /**\n   * Add a tool handler.\n   */\n  addTool(name: string, handler: ToolHandler): void {\n    this.tools.set(name, handler);\n  }\n\n  /**\n   * Remove a tool handler.\n   */\n  removeTool(name: string): boolean {\n    return this.tools.delete(name);\n  }\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Create a unified agent.\n */\nexport function createUnifiedAgent(\n  spec: AgentSpec,\n  config: UnifiedAgentConfig\n): UnifiedAgent {\n  return new UnifiedAgent(spec, config);\n}\n\n/**\n * Create a unified agent with AI SDK backend (default).\n */\nexport function createAISDKAgent(\n  spec: AgentSpec,\n  options?: {\n    tools?: Map<string, ToolHandler>;\n    model?: string;\n  }\n): UnifiedAgent {\n  return new UnifiedAgent(spec, {\n    backend: 'ai-sdk',\n    tools: options?.tools,\n    config: { model: options?.model },\n  });\n}\n\n/**\n * Create a unified agent with Claude Agent SDK backend.\n */\nexport function createClaudeAgentSDKAgent(\n  spec: AgentSpec,\n  config?: ClaudeAgentSDKConfig & {\n    tools?: Map<string, ToolHandler>;\n  }\n): UnifiedAgent {\n  const { tools, ...sdkConfig } = config ?? {};\n  return new UnifiedAgent(spec, {\n    backend: 'claude-agent-sdk',\n    tools,\n    config: sdkConfig,\n  });\n}\n\n/**\n * Create a unified agent with OpenCode SDK backend.\n */\nexport function createOpenCodeSDKAgent(\n  spec: AgentSpec,\n  config?: OpenCodeSDKConfig & {\n    tools?: Map<string, ToolHandler>;\n  }\n): UnifiedAgent {\n  const { tools, ...sdkConfig } = config ?? {};\n  return new UnifiedAgent(spec, {\n    backend: 'opencode-sdk',\n    tools,\n    config: sdkConfig,\n  });\n}\n\n/**\n * Get available backends.\n */\nexport async function getAvailableBackends(): Promise<UnifiedAgentBackend[]> {\n  const backends: UnifiedAgentBackend[] = ['ai-sdk'];\n\n  try {\n    const { ClaudeAgentSDKProvider } =\n      await import('../providers/claude-agent-sdk');\n    const provider = new ClaudeAgentSDKProvider({});\n    if (provider.isAvailable()) {\n      backends.push('claude-agent-sdk');\n    }\n  } catch {\n    // Not available\n  }\n\n  try {\n    const { OpenCodeSDKProvider } = await import('../providers/opencode-sdk');\n    const provider = new OpenCodeSDKProvider({});\n    if (provider.isAvailable()) {\n      backends.push('opencode-sdk');\n    }\n  } catch {\n    // Not available\n  }\n\n  return backends;\n}\n"],"mappings":"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"}

package/dist/exporters/claude-agent-exporter.d.ts

@@ -0,0 +1,64 @@
+import { AgentSpec } from "../spec/spec.js";
+import { ClaudeAgentExportOptions, ClaudeAgentExportResult, Exporter } from "./types.js";
+
+//#region src/exporters/claude-agent-exporter.d.ts
+
+/**
+ * Claude Agent SDK Exporter.
+ */
+declare class ClaudeAgentExporter implements Exporter<ClaudeAgentExportOptions, ClaudeAgentExportResult> {
+  readonly format: "claude-agent";
+  /**
+   * Export an AgentSpec to Claude Agent SDK format.
+   */
+  export(spec: AgentSpec, options?: ClaudeAgentExportOptions): ClaudeAgentExportResult;
+  /**
+   * Export multiple specs.
+   */
+  exportMany(specs: AgentSpec[], options?: ClaudeAgentExportOptions): ClaudeAgentExportResult[];
+  /**
+   * Validate that a spec can be exported.
+   */
+  validate(spec: AgentSpec): {
+    valid: boolean;
+    errors: string[];
+  };
+  /**
+   * Build Claude Agent SDK configuration.
+   */
+  private buildConfig;
+  /**
+   * Build system prompt from spec.
+   */
+  private buildSystemPrompt;
+  /**
+   * Export tools to Claude Agent SDK format.
+   */
+  private exportTools;
+  /**
+   * Normalize schema to Claude Agent SDK format.
+   */
+  private normalizeSchema;
+  /**
+   * Generate CLAUDE.md content for Claude Code CLI integration.
+   */
+  private generateClaudeMd;
+}
+/**
+ * Export an AgentSpec to Claude Agent SDK format.
+ */
+declare function exportToClaudeAgent(spec: AgentSpec, options?: ClaudeAgentExportOptions): ClaudeAgentExportResult;
+/**
+ * Generate CLAUDE.md content from an AgentSpec.
+ */
+declare function generateClaudeMd(spec: AgentSpec, options?: Omit<ClaudeAgentExportOptions, 'generateClaudeMd'>): string;
+/**
+ * Validate an AgentSpec for Claude Agent SDK export.
+ */
+declare function validateForClaudeAgent(spec: AgentSpec): {
+  valid: boolean;
+  errors: string[];
+};
+//#endregion
+export { ClaudeAgentExporter, exportToClaudeAgent, generateClaudeMd, validateForClaudeAgent };
+//# sourceMappingURL=claude-agent-exporter.d.ts.map

package/dist/exporters/claude-agent-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-agent-exporter.d.ts","names":[],"sources":["../../src/exporters/claude-agent-exporter.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAyDa,cAjCA,mBAAA,YAA+B,QAiC/B,CAhCX,wBAgCW,EA/BX,uBA+BW,CAAA,CAAA;EACR,SAAA,MAAA,EAAA,cAAA;EAOY;;;EAgRD,MAAA,CAAA,IAAA,EA/SN,SA+SyB,EAAA,OAAA,CAAA,EA9StB,wBA8SsB,CAAA,EA7S9B,uBA6S8B;EAC3B;;;EAEkB,UAAA,CAAA,KAAA,EA5Rf,SA4Re,EAAA,EAAA,OAAA,CAAA,EA3Rb,wBA2Ra,CAAA,EA1RrB,uBA0RqB,EAAA;EAQV;;;EAEJ,QAAA,CAAA,IAAA,EA7RK,SA6RL,CAAA,EAAA;IAAI,KAAA,EAAA,OAAA;IAUA,MAAA,EAAA,MAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;iBAvBA,mBAAA,OACR,qBACI,2BACT;;;;iBAQa,gBAAA,OACR,qBACI,KAAK;;;;iBAUD,sBAAA,OAA6B"}