@contractspec/lib.ai-agent 1.45.6 → 1.46.0

package/dist/providers/opencode-sdk/adapter.js

@@ -0,0 +1,276 @@
+import { __require } from "../../_virtual/rolldown_runtime.js";
+import { agentKey } from "../../spec/spec.js";
+import { injectStaticKnowledge } from "../../knowledge/injector.js";
+import { ContextCreationError, ProviderExecutionError, ProviderNotAvailableError } from "../types.js";
+import { createToolHandlerMap, executeToolCall, specToolToExternalToolForOpenCode } from "./tool-bridge.js";
+import { inferAgentType } from "./agent-bridge.js";
+
+//#region src/providers/opencode-sdk/adapter.ts
+/**
+* OpenCode SDK Provider implementation.
+*/
+var OpenCodeSDKProvider = class {
+	name = "opencode-sdk";
+	version = "1.0.0";
+	config;
+	sdkAvailable = null;
+	constructor(config = {}) {
+		this.config = {
+			serverUrl: "http://127.0.0.1:4096",
+			port: 4096,
+			agentType: "general",
+			temperature: .7,
+			timeout: 3e4,
+			...config
+		};
+		if (!config.serverUrl && config.port) this.config.serverUrl = `http://127.0.0.1:${config.port}`;
+	}
+	/**
+	* Check if OpenCode SDK is available.
+	*/
+	isAvailable() {
+		if (this.sdkAvailable !== null) return this.sdkAvailable;
+		try {
+			__require.resolve("@opencode-ai/sdk");
+			this.sdkAvailable = true;
+		} catch {
+			this.sdkAvailable = false;
+		}
+		return this.sdkAvailable;
+	}
+	/**
+	* Create an execution context from an AgentSpec.
+	*/
+	async createContext(spec) {
+		if (!this.isAvailable()) throw new ProviderNotAvailableError(this.name, "SDK not installed");
+		try {
+			const { client } = await (await this.loadSDK()).createOpencode({
+				hostname: this.getHostname(),
+				port: this.config.port ?? 4096,
+				timeout: this.config.timeout
+			});
+			const session = await client.session.create({
+				agent: this.config.agentType ?? inferAgentType(spec),
+				model: this.config.model
+			});
+			const toolSet = {};
+			for (const tool of spec.tools) toolSet[tool.name] = specToolToExternalToolForOpenCode(tool);
+			const instructions = await injectStaticKnowledge(spec.instructions, spec.knowledge ?? [], void 0);
+			const contextId = `opencode-${agentKey(spec.meta)}-${Date.now()}`;
+			const metadata = {
+				sessionId: session.id,
+				agentType: this.config.agentType ?? inferAgentType(spec),
+				serverUrl: this.config.serverUrl ?? `http://127.0.0.1:${this.config.port ?? 4096}`
+			};
+			return {
+				id: contextId,
+				spec: {
+					...spec,
+					instructions
+				},
+				tools: toolSet,
+				metadata,
+				cleanup: async () => {
+					try {
+						await client.session.delete({ id: session.id });
+					} catch {}
+				}
+			};
+		} catch (error) {
+			throw new ContextCreationError(this.name, `Failed to create context: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : void 0);
+		}
+	}
+	/**
+	* Execute a prompt using OpenCode SDK.
+	*/
+	async execute(context, params) {
+		try {
+			const sdk = await this.loadSDK();
+			const metadata = context.metadata;
+			const { client } = await sdk.createOpencodeClient({ baseUrl: metadata.serverUrl });
+			const systemPrompt = params.systemOverride ? `${context.spec.instructions}\n\n${params.systemOverride}` : context.spec.instructions;
+			const response = await client.session.prompt({
+				id: metadata.sessionId,
+				body: {
+					content: params.prompt,
+					system: systemPrompt
+				}
+			});
+			const toolCalls = this.extractToolCalls(response);
+			const toolHandlers = createToolHandlerMap(context.tools);
+			const toolResults = await Promise.all(toolCalls.map((tc) => executeToolCall(tc, toolHandlers)));
+			return {
+				text: this.extractTextContent(response),
+				toolCalls: toolCalls.map((tc) => ({
+					type: "tool-call",
+					toolCallId: tc.id,
+					toolName: tc.name,
+					args: tc.arguments
+				})),
+				toolResults: toolResults.map((tr) => ({
+					type: "tool-result",
+					toolCallId: tr.tool_call_id,
+					toolName: toolCalls.find((tc) => tc.id === tr.tool_call_id)?.name ?? "",
+					output: tr.output
+				})),
+				usage: {
+					inputTokens: response.usage?.input_tokens ?? 0,
+					outputTokens: response.usage?.output_tokens ?? 0
+				},
+				finishReason: this.mapFinishReason(response.finish_reason),
+				metadata: {
+					sessionId: metadata.sessionId,
+					agentType: metadata.agentType
+				}
+			};
+		} catch (error) {
+			throw new ProviderExecutionError(this.name, `Execution failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : void 0);
+		}
+	}
+	/**
+	* Stream execution with real-time updates.
+	*/
+	async *stream(context, params) {
+		try {
+			const sdk = await this.loadSDK();
+			const metadata = context.metadata;
+			const { client } = await sdk.createOpencodeClient({ baseUrl: metadata.serverUrl });
+			const systemPrompt = params.systemOverride ? `${context.spec.instructions}\n\n${params.systemOverride}` : context.spec.instructions;
+			const events = client.session.subscribe({ id: metadata.sessionId });
+			await client.session.prompt({
+				id: metadata.sessionId,
+				body: {
+					content: params.prompt,
+					system: systemPrompt
+				}
+			});
+			let fullText = "";
+			const allToolCalls = [];
+			const toolHandlers = createToolHandlerMap(context.tools);
+			let stepIndex = 0;
+			for await (const event of events) {
+				if (event.type === "message.delta") {
+					const text = event.delta?.content ?? "";
+					fullText += text;
+					yield {
+						type: "text",
+						text
+					};
+				}
+				if (event.type === "tool.call") {
+					const toolCall = {
+						id: event.tool_call_id ?? `tc-${Date.now()}`,
+						name: event.tool_name ?? "",
+						arguments: event.arguments ?? {}
+					};
+					allToolCalls.push(toolCall);
+					yield {
+						type: "tool-call",
+						toolCall: {
+							type: "tool-call",
+							toolCallId: toolCall.id,
+							toolName: toolCall.name,
+							args: toolCall.arguments
+						}
+					};
+				}
+				if (event.type === "step.complete") {
+					stepIndex++;
+					yield {
+						type: "step-complete",
+						stepIndex
+					};
+				}
+				if (event.type === "message.complete") break;
+			}
+			for (const toolCall of allToolCalls) {
+				const result = await executeToolCall(toolCall, toolHandlers);
+				yield {
+					type: "tool-result",
+					toolResult: {
+						type: "tool-result",
+						toolCallId: result.tool_call_id,
+						toolName: toolCall.name,
+						output: result.output
+					}
+				};
+			}
+			yield {
+				type: "done",
+				result: {
+					text: fullText,
+					toolCalls: allToolCalls.map((tc) => ({
+						type: "tool-call",
+						toolCallId: tc.id,
+						toolName: tc.name,
+						args: tc.arguments
+					})),
+					toolResults: [],
+					usage: {
+						inputTokens: 0,
+						outputTokens: 0
+					},
+					finishReason: "stop"
+				}
+			};
+		} catch (error) {
+			throw new ProviderExecutionError(this.name, `Stream failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : void 0);
+		}
+	}
+	/**
+	* Load the OpenCode SDK dynamically.
+	*/
+	async loadSDK() {
+		try {
+			return __require("@opencode-ai/sdk");
+		} catch {
+			throw new ProviderNotAvailableError(this.name, "@opencode-ai/sdk is not installed");
+		}
+	}
+	/**
+	* Get hostname from server URL.
+	*/
+	getHostname() {
+		if (!this.config.serverUrl) return "127.0.0.1";
+		try {
+			return new URL(this.config.serverUrl).hostname;
+		} catch {
+			return "127.0.0.1";
+		}
+	}
+	/**
+	* Extract tool calls from response.
+	*/
+	extractToolCalls(response) {
+		if (!response.tool_calls) return [];
+		return response.tool_calls.map((tc) => ({
+			id: tc.id,
+			name: tc.name,
+			arguments: tc.arguments ?? {}
+		}));
+	}
+	/**
+	* Extract text content from response.
+	*/
+	extractTextContent(response) {
+		return response.content ?? response.message?.content ?? "";
+	}
+	/**
+	* Map OpenCode finish reason to ContractSpec finish reason.
+	*/
+	mapFinishReason(finishReason) {
+		switch (finishReason) {
+			case "stop":
+			case "end": return "stop";
+			case "tool_use":
+			case "tool_calls": return "tool-calls";
+			case "length":
+			case "max_tokens": return "length";
+			default: return "stop";
+		}
+	}
+};
+
+//#endregion
+export { OpenCodeSDKProvider };
+//# sourceMappingURL=adapter.js.map

package/dist/providers/opencode-sdk/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":["toolSet: ExternalToolSet","metadata: OpenCodeContextMetadata","allToolCalls: OpenCodeToolCall[]","toolCall: OpenCodeToolCall"],"sources":["../../../src/providers/opencode-sdk/adapter.ts"],"sourcesContent":["/**\n * OpenCode SDK Provider\n *\n * Enables ContractSpec agents to run via OpenCode server:\n * - Session-based execution\n * - Multiple agent types (Build, Plan, General, Explore)\n * - Type-safe client interface\n * - Real-time streaming support\n *\n * This adapter wraps @opencode-ai/sdk to work as a backend\n * for ContractSpec agents.\n */\n\nimport type { AgentSpec } from '../../spec/spec';\nimport { agentKey } from '../../spec/spec';\nimport type {\n  ExternalAgentProvider,\n  ExternalAgentContext,\n  ExternalExecuteParams,\n  ExternalExecuteResult,\n  ExternalStreamChunk,\n  ExternalToolSet,\n  OpenCodeSDKConfig,\n  OpenCodeContextMetadata,\n  OpenCodeAgentType,\n} from '../types';\nimport {\n  ContextCreationError,\n  ProviderExecutionError,\n  ProviderNotAvailableError,\n} from '../types';\nimport {\n  specToolToExternalToolForOpenCode,\n  createToolHandlerMap,\n  executeToolCall,\n  type OpenCodeToolCall,\n} from './tool-bridge';\nimport { inferAgentType } from './agent-bridge';\nimport { injectStaticKnowledge } from '../../knowledge/injector';\n\n// ============================================================================\n// Provider Implementation\n// ============================================================================\n\n/**\n * OpenCode SDK Provider implementation.\n */\nexport class OpenCodeSDKProvider implements ExternalAgentProvider {\n  readonly name = 'opencode-sdk';\n  readonly version = '1.0.0';\n\n  private config: OpenCodeSDKConfig;\n  private sdkAvailable: boolean | null = null;\n\n  constructor(config: OpenCodeSDKConfig = {}) {\n    this.config = {\n      serverUrl: 'http://127.0.0.1:4096',\n      port: 4096,\n      agentType: 'general',\n      temperature: 0.7,\n      timeout: 30000,\n      ...config,\n    };\n\n    // Build server URL from port if not explicitly set\n    if (!config.serverUrl && config.port) {\n      this.config.serverUrl = `http://127.0.0.1:${config.port}`;\n    }\n  }\n\n  /**\n   * Check if OpenCode SDK is available.\n   */\n  isAvailable(): boolean {\n    if (this.sdkAvailable !== null) {\n      return this.sdkAvailable;\n    }\n\n    try {\n      // Check if the SDK is installed\n      require.resolve('@opencode-ai/sdk');\n      this.sdkAvailable = true;\n    } catch {\n      this.sdkAvailable = false;\n    }\n\n    return this.sdkAvailable;\n  }\n\n  /**\n   * Create an execution context from an AgentSpec.\n   */\n  async createContext(spec: AgentSpec): Promise<ExternalAgentContext> {\n    if (!this.isAvailable()) {\n      throw new ProviderNotAvailableError(this.name, 'SDK not installed');\n    }\n\n    try {\n      const sdk = await this.loadSDK();\n\n      // Create or connect to OpenCode client\n      const { client } = await sdk.createOpencode({\n        hostname: this.getHostname(),\n        port: this.config.port ?? 4096,\n        timeout: this.config.timeout,\n      });\n\n      // Create session\n      const session = await client.session.create({\n        agent: this.config.agentType ?? inferAgentType(spec),\n        model: this.config.model,\n      });\n\n      // Build tools set\n      const toolSet: ExternalToolSet = {};\n      for (const tool of spec.tools) {\n        toolSet[tool.name] = specToolToExternalToolForOpenCode(tool);\n      }\n\n      // Inject static knowledge into instructions\n      const instructions = await injectStaticKnowledge(\n        spec.instructions,\n        spec.knowledge ?? [],\n        undefined\n      );\n\n      const contextId = `opencode-${agentKey(spec.meta)}-${Date.now()}`;\n\n      const metadata: OpenCodeContextMetadata = {\n        sessionId: session.id,\n        agentType: this.config.agentType ?? inferAgentType(spec),\n        serverUrl:\n          this.config.serverUrl ??\n          `http://127.0.0.1:${this.config.port ?? 4096}`,\n      };\n\n      return {\n        id: contextId,\n        spec: {\n          ...spec,\n          instructions,\n        },\n        tools: toolSet,\n        metadata: metadata as unknown as Record<string, unknown>,\n        cleanup: async () => {\n          // Cleanup session if needed\n          try {\n            await client.session.delete({ id: session.id });\n          } catch {\n            // Ignore cleanup errors\n          }\n        },\n      };\n    } catch (error) {\n      throw new ContextCreationError(\n        this.name,\n        `Failed to create context: ${error instanceof Error ? error.message : String(error)}`,\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Execute a prompt using OpenCode SDK.\n   */\n  async execute(\n    context: ExternalAgentContext,\n    params: ExternalExecuteParams\n  ): Promise<ExternalExecuteResult> {\n    try {\n      const sdk = await this.loadSDK();\n      const metadata = context.metadata as unknown as OpenCodeContextMetadata;\n\n      // Connect to existing session\n      const { client } = await sdk.createOpencodeClient({\n        baseUrl: metadata.serverUrl,\n      });\n\n      // Build system prompt\n      const systemPrompt = params.systemOverride\n        ? `${context.spec.instructions}\\n\\n${params.systemOverride}`\n        : context.spec.instructions;\n\n      // Execute prompt\n      const response = await client.session.prompt({\n        id: metadata.sessionId,\n        body: {\n          content: params.prompt,\n          system: systemPrompt,\n        },\n      });\n\n      // Extract tool calls from response\n      const toolCalls = this.extractToolCalls(response);\n      const toolHandlers = createToolHandlerMap(context.tools);\n\n      // Execute tools\n      const toolResults = await Promise.all(\n        toolCalls.map((tc) => executeToolCall(tc, toolHandlers))\n      );\n\n      return {\n        text: this.extractTextContent(response),\n        toolCalls: toolCalls.map((tc) => ({\n          type: 'tool-call' as const,\n          toolCallId: tc.id,\n          toolName: tc.name,\n          args: tc.arguments,\n        })),\n        toolResults: toolResults.map((tr) => ({\n          type: 'tool-result' as const,\n          toolCallId: tr.tool_call_id,\n          toolName:\n            toolCalls.find((tc) => tc.id === tr.tool_call_id)?.name ?? '',\n          output: tr.output,\n        })),\n        usage: {\n          inputTokens: response.usage?.input_tokens ?? 0,\n          outputTokens: response.usage?.output_tokens ?? 0,\n        },\n        finishReason: this.mapFinishReason(response.finish_reason),\n        metadata: {\n          sessionId: metadata.sessionId,\n          agentType: metadata.agentType,\n        },\n      };\n    } catch (error) {\n      throw new ProviderExecutionError(\n        this.name,\n        `Execution failed: ${error instanceof Error ? error.message : String(error)}`,\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Stream execution with real-time updates.\n   */\n  async *stream(\n    context: ExternalAgentContext,\n    params: ExternalExecuteParams\n  ): AsyncIterable<ExternalStreamChunk> {\n    try {\n      const sdk = await this.loadSDK();\n      const metadata = context.metadata as unknown as OpenCodeContextMetadata;\n\n      const { client } = await sdk.createOpencodeClient({\n        baseUrl: metadata.serverUrl,\n      });\n\n      const systemPrompt = params.systemOverride\n        ? `${context.spec.instructions}\\n\\n${params.systemOverride}`\n        : context.spec.instructions;\n\n      // Subscribe to session events\n      const events = client.session.subscribe({\n        id: metadata.sessionId,\n      });\n\n      // Send prompt\n      await client.session.prompt({\n        id: metadata.sessionId,\n        body: {\n          content: params.prompt,\n          system: systemPrompt,\n        },\n      });\n\n      let fullText = '';\n      const allToolCalls: OpenCodeToolCall[] = [];\n      const toolHandlers = createToolHandlerMap(context.tools);\n      let stepIndex = 0;\n\n      for await (const event of events) {\n        if (event.type === 'message.delta') {\n          const text = event.delta?.content ?? '';\n          fullText += text;\n          yield { type: 'text', text };\n        }\n\n        if (event.type === 'tool.call') {\n          const toolCall: OpenCodeToolCall = {\n            id: event.tool_call_id ?? `tc-${Date.now()}`,\n            name: event.tool_name ?? '',\n            arguments: event.arguments ?? {},\n          };\n          allToolCalls.push(toolCall);\n          yield {\n            type: 'tool-call',\n            toolCall: {\n              type: 'tool-call',\n              toolCallId: toolCall.id,\n              toolName: toolCall.name,\n              args: toolCall.arguments,\n            },\n          };\n        }\n\n        if (event.type === 'step.complete') {\n          stepIndex++;\n          yield { type: 'step-complete', stepIndex };\n        }\n\n        if (event.type === 'message.complete') {\n          break;\n        }\n      }\n\n      // Execute pending tools\n      for (const toolCall of allToolCalls) {\n        const result = await executeToolCall(toolCall, toolHandlers);\n        yield {\n          type: 'tool-result',\n          toolResult: {\n            type: 'tool-result',\n            toolCallId: result.tool_call_id,\n            toolName: toolCall.name,\n            output: result.output,\n          },\n        };\n      }\n\n      // Final done event\n      yield {\n        type: 'done',\n        result: {\n          text: fullText,\n          toolCalls: allToolCalls.map((tc) => ({\n            type: 'tool-call' as const,\n            toolCallId: tc.id,\n            toolName: tc.name,\n            args: tc.arguments,\n          })),\n          toolResults: [],\n          usage: { inputTokens: 0, outputTokens: 0 },\n          finishReason: 'stop',\n        },\n      };\n    } catch (error) {\n      throw new ProviderExecutionError(\n        this.name,\n        `Stream failed: ${error instanceof Error ? error.message : String(error)}`,\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  // ============================================================================\n  // Private Helpers\n  // ============================================================================\n\n  /**\n   * Load the OpenCode SDK dynamically.\n   */\n  private async loadSDK(): Promise<OpenCodeSDKInterface> {\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const module = require('@opencode-ai/sdk');\n      return module;\n    } catch {\n      throw new ProviderNotAvailableError(\n        this.name,\n        '@opencode-ai/sdk is not installed'\n      );\n    }\n  }\n\n  /**\n   * Get hostname from server URL.\n   */\n  private getHostname(): string {\n    if (!this.config.serverUrl) {\n      return '127.0.0.1';\n    }\n    try {\n      const url = new URL(this.config.serverUrl);\n      return url.hostname;\n    } catch {\n      return '127.0.0.1';\n    }\n  }\n\n  /**\n   * Extract tool calls from response.\n   */\n  private extractToolCalls(response: {\n    tool_calls?: { id: string; name: string; arguments: unknown }[];\n  }): OpenCodeToolCall[] {\n    if (!response.tool_calls) {\n      return [];\n    }\n\n    return response.tool_calls.map((tc) => ({\n      id: tc.id,\n      name: tc.name,\n      arguments: (tc.arguments ?? {}) as Record<string, unknown>,\n    }));\n  }\n\n  /**\n   * Extract text content from response.\n   */\n  private extractTextContent(response: {\n    content?: string;\n    message?: { content?: string };\n  }): string {\n    return response.content ?? response.message?.content ?? '';\n  }\n\n  /**\n   * Map OpenCode finish reason to ContractSpec finish reason.\n   */\n  private mapFinishReason(\n    finishReason?: string\n  ): ExternalExecuteResult['finishReason'] {\n    switch (finishReason) {\n      case 'stop':\n      case 'end':\n        return 'stop';\n      case 'tool_use':\n      case 'tool_calls':\n        return 'tool-calls';\n      case 'length':\n      case 'max_tokens':\n        return 'length';\n      default:\n        return 'stop';\n    }\n  }\n}\n\n// ============================================================================\n// SDK Interface Type (for dynamic import)\n// ============================================================================\n\n/**\n * Interface for OpenCode SDK (used for dynamic import).\n */\ninterface OpenCodeSDKInterface {\n  createOpencode(options: {\n    hostname?: string;\n    port?: number;\n    timeout?: number;\n    config?: unknown;\n  }): Promise<{\n    client: OpenCodeClient;\n  }>;\n\n  createOpencodeClient(options: { baseUrl: string }): Promise<{\n    client: OpenCodeClient;\n  }>;\n}\n\n/**\n * OpenCode client interface.\n */\ninterface OpenCodeClient {\n  session: {\n    create(options: {\n      agent?: OpenCodeAgentType;\n      model?: string;\n    }): Promise<{ id: string }>;\n\n    prompt(options: {\n      id: string;\n      body: {\n        content: string;\n        system?: string;\n      };\n    }): Promise<{\n      content?: string;\n      message?: { content?: string };\n      tool_calls?: { id: string; name: string; arguments: unknown }[];\n      usage?: { input_tokens?: number; output_tokens?: number };\n      finish_reason?: string;\n    }>;\n\n    delete(options: { id: string }): Promise<void>;\n\n    subscribe(options: { id: string }): AsyncIterable<{\n      type: string;\n      delta?: { content?: string };\n      tool_call_id?: string;\n      tool_name?: string;\n      arguments?: Record<string, unknown>;\n    }>;\n  };\n\n  app: {\n    agents(): Promise<{ name: string; type: OpenCodeAgentType }[]>;\n  };\n\n  global: {\n    health(): Promise<{ status: string }>;\n  };\n}\n"],"mappings":";;;;;;;;;;;AA+CA,IAAa,sBAAb,MAAkE;CAChE,AAAS,OAAO;CAChB,AAAS,UAAU;CAEnB,AAAQ;CACR,AAAQ,eAA+B;CAEvC,YAAY,SAA4B,EAAE,EAAE;AAC1C,OAAK,SAAS;GACZ,WAAW;GACX,MAAM;GACN,WAAW;GACX,aAAa;GACb,SAAS;GACT,GAAG;GACJ;AAGD,MAAI,CAAC,OAAO,aAAa,OAAO,KAC9B,MAAK,OAAO,YAAY,oBAAoB,OAAO;;;;;CAOvD,cAAuB;AACrB,MAAI,KAAK,iBAAiB,KACxB,QAAO,KAAK;AAGd,MAAI;AAEF,aAAQ,QAAQ,mBAAmB;AACnC,QAAK,eAAe;UACd;AACN,QAAK,eAAe;;AAGtB,SAAO,KAAK;;;;;CAMd,MAAM,cAAc,MAAgD;AAClE,MAAI,CAAC,KAAK,aAAa,CACrB,OAAM,IAAI,0BAA0B,KAAK,MAAM,oBAAoB;AAGrE,MAAI;GAIF,MAAM,EAAE,WAAW,OAHP,MAAM,KAAK,SAAS,EAGH,eAAe;IAC1C,UAAU,KAAK,aAAa;IAC5B,MAAM,KAAK,OAAO,QAAQ;IAC1B,SAAS,KAAK,OAAO;IACtB,CAAC;GAGF,MAAM,UAAU,MAAM,OAAO,QAAQ,OAAO;IAC1C,OAAO,KAAK,OAAO,aAAa,eAAe,KAAK;IACpD,OAAO,KAAK,OAAO;IACpB,CAAC;GAGF,MAAMA,UAA2B,EAAE;AACnC,QAAK,MAAM,QAAQ,KAAK,MACtB,SAAQ,KAAK,QAAQ,kCAAkC,KAAK;GAI9D,MAAM,eAAe,MAAM,sBACzB,KAAK,cACL,KAAK,aAAa,EAAE,EACpB,OACD;GAED,MAAM,YAAY,YAAY,SAAS,KAAK,KAAK,CAAC,GAAG,KAAK,KAAK;GAE/D,MAAMC,WAAoC;IACxC,WAAW,QAAQ;IACnB,WAAW,KAAK,OAAO,aAAa,eAAe,KAAK;IACxD,WACE,KAAK,OAAO,aACZ,oBAAoB,KAAK,OAAO,QAAQ;IAC3C;AAED,UAAO;IACL,IAAI;IACJ,MAAM;KACJ,GAAG;KACH;KACD;IACD,OAAO;IACG;IACV,SAAS,YAAY;AAEnB,SAAI;AACF,YAAM,OAAO,QAAQ,OAAO,EAAE,IAAI,QAAQ,IAAI,CAAC;aACzC;;IAIX;WACM,OAAO;AACd,SAAM,IAAI,qBACR,KAAK,MACL,6BAA6B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACnF,iBAAiB,QAAQ,QAAQ,OAClC;;;;;;CAOL,MAAM,QACJ,SACA,QACgC;AAChC,MAAI;GACF,MAAM,MAAM,MAAM,KAAK,SAAS;GAChC,MAAM,WAAW,QAAQ;GAGzB,MAAM,EAAE,WAAW,MAAM,IAAI,qBAAqB,EAChD,SAAS,SAAS,WACnB,CAAC;GAGF,MAAM,eAAe,OAAO,iBACxB,GAAG,QAAQ,KAAK,aAAa,MAAM,OAAO,mBAC1C,QAAQ,KAAK;GAGjB,MAAM,WAAW,MAAM,OAAO,QAAQ,OAAO;IAC3C,IAAI,SAAS;IACb,MAAM;KACJ,SAAS,OAAO;KAChB,QAAQ;KACT;IACF,CAAC;GAGF,MAAM,YAAY,KAAK,iBAAiB,SAAS;GACjD,MAAM,eAAe,qBAAqB,QAAQ,MAAM;GAGxD,MAAM,cAAc,MAAM,QAAQ,IAChC,UAAU,KAAK,OAAO,gBAAgB,IAAI,aAAa,CAAC,CACzD;AAED,UAAO;IACL,MAAM,KAAK,mBAAmB,SAAS;IACvC,WAAW,UAAU,KAAK,QAAQ;KAChC,MAAM;KACN,YAAY,GAAG;KACf,UAAU,GAAG;KACb,MAAM,GAAG;KACV,EAAE;IACH,aAAa,YAAY,KAAK,QAAQ;KACpC,MAAM;KACN,YAAY,GAAG;KACf,UACE,UAAU,MAAM,OAAO,GAAG,OAAO,GAAG,aAAa,EAAE,QAAQ;KAC7D,QAAQ,GAAG;KACZ,EAAE;IACH,OAAO;KACL,aAAa,SAAS,OAAO,gBAAgB;KAC7C,cAAc,SAAS,OAAO,iBAAiB;KAChD;IACD,cAAc,KAAK,gBAAgB,SAAS,cAAc;IAC1D,UAAU;KACR,WAAW,SAAS;KACpB,WAAW,SAAS;KACrB;IACF;WACM,OAAO;AACd,SAAM,IAAI,uBACR,KAAK,MACL,qBAAqB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAC3E,iBAAiB,QAAQ,QAAQ,OAClC;;;;;;CAOL,OAAO,OACL,SACA,QACoC;AACpC,MAAI;GACF,MAAM,MAAM,MAAM,KAAK,SAAS;GAChC,MAAM,WAAW,QAAQ;GAEzB,MAAM,EAAE,WAAW,MAAM,IAAI,qBAAqB,EAChD,SAAS,SAAS,WACnB,CAAC;GAEF,MAAM,eAAe,OAAO,iBACxB,GAAG,QAAQ,KAAK,aAAa,MAAM,OAAO,mBAC1C,QAAQ,KAAK;GAGjB,MAAM,SAAS,OAAO,QAAQ,UAAU,EACtC,IAAI,SAAS,WACd,CAAC;AAGF,SAAM,OAAO,QAAQ,OAAO;IAC1B,IAAI,SAAS;IACb,MAAM;KACJ,SAAS,OAAO;KAChB,QAAQ;KACT;IACF,CAAC;GAEF,IAAI,WAAW;GACf,MAAMC,eAAmC,EAAE;GAC3C,MAAM,eAAe,qBAAqB,QAAQ,MAAM;GACxD,IAAI,YAAY;AAEhB,cAAW,MAAM,SAAS,QAAQ;AAChC,QAAI,MAAM,SAAS,iBAAiB;KAClC,MAAM,OAAO,MAAM,OAAO,WAAW;AACrC,iBAAY;AACZ,WAAM;MAAE,MAAM;MAAQ;MAAM;;AAG9B,QAAI,MAAM,SAAS,aAAa;KAC9B,MAAMC,WAA6B;MACjC,IAAI,MAAM,gBAAgB,MAAM,KAAK,KAAK;MAC1C,MAAM,MAAM,aAAa;MACzB,WAAW,MAAM,aAAa,EAAE;MACjC;AACD,kBAAa,KAAK,SAAS;AAC3B,WAAM;MACJ,MAAM;MACN,UAAU;OACR,MAAM;OACN,YAAY,SAAS;OACrB,UAAU,SAAS;OACnB,MAAM,SAAS;OAChB;MACF;;AAGH,QAAI,MAAM,SAAS,iBAAiB;AAClC;AACA,WAAM;MAAE,MAAM;MAAiB;MAAW;;AAG5C,QAAI,MAAM,SAAS,mBACjB;;AAKJ,QAAK,MAAM,YAAY,cAAc;IACnC,MAAM,SAAS,MAAM,gBAAgB,UAAU,aAAa;AAC5D,UAAM;KACJ,MAAM;KACN,YAAY;MACV,MAAM;MACN,YAAY,OAAO;MACnB,UAAU,SAAS;MACnB,QAAQ,OAAO;MAChB;KACF;;AAIH,SAAM;IACJ,MAAM;IACN,QAAQ;KACN,MAAM;KACN,WAAW,aAAa,KAAK,QAAQ;MACnC,MAAM;MACN,YAAY,GAAG;MACf,UAAU,GAAG;MACb,MAAM,GAAG;MACV,EAAE;KACH,aAAa,EAAE;KACf,OAAO;MAAE,aAAa;MAAG,cAAc;MAAG;KAC1C,cAAc;KACf;IACF;WACM,OAAO;AACd,SAAM,IAAI,uBACR,KAAK,MACL,kBAAkB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACxE,iBAAiB,QAAQ,QAAQ,OAClC;;;;;;CAWL,MAAc,UAAyC;AACrD,MAAI;AAGF,oBADuB,mBAAmB;UAEpC;AACN,SAAM,IAAI,0BACR,KAAK,MACL,oCACD;;;;;;CAOL,AAAQ,cAAsB;AAC5B,MAAI,CAAC,KAAK,OAAO,UACf,QAAO;AAET,MAAI;AAEF,UADY,IAAI,IAAI,KAAK,OAAO,UAAU,CAC/B;UACL;AACN,UAAO;;;;;;CAOX,AAAQ,iBAAiB,UAEF;AACrB,MAAI,CAAC,SAAS,WACZ,QAAO,EAAE;AAGX,SAAO,SAAS,WAAW,KAAK,QAAQ;GACtC,IAAI,GAAG;GACP,MAAM,GAAG;GACT,WAAY,GAAG,aAAa,EAAE;GAC/B,EAAE;;;;;CAML,AAAQ,mBAAmB,UAGhB;AACT,SAAO,SAAS,WAAW,SAAS,SAAS,WAAW;;;;;CAM1D,AAAQ,gBACN,cACuC;AACvC,UAAQ,cAAR;GACE,KAAK;GACL,KAAK,MACH,QAAO;GACT,KAAK;GACL,KAAK,aACH,QAAO;GACT,KAAK;GACL,KAAK,aACH,QAAO;GACT,QACE,QAAO"}

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

@@ -0,0 +1,94 @@
+import { AgentSpec } from "../../spec/spec.js";
+import { OpenCodeAgentType } from "../types.js";
+import { OpenCodeTool } from "./tool-bridge.js";
+
+//#region src/providers/opencode-sdk/agent-bridge.d.ts
+
+/**
+ * OpenCode agent configuration in JSON format.
+ */
+interface OpenCodeAgentJSON {
+  /** Agent name */
+  name: string;
+  /** Agent version */
+  version?: string;
+  /** Agent description */
+  description?: string;
+  /** System instructions */
+  instructions?: string;
+  /** Agent type */
+  agent_type: OpenCodeAgentType;
+  /** Available tools */
+  tools?: OpenCodeTool[];
+  /** Configuration options */
+  config?: OpenCodeAgentConfig;
+}
+/**
+ * OpenCode agent configuration options.
+ */
+interface OpenCodeAgentConfig {
+  /** Maximum agentic iterations */
+  max_steps?: number;
+  /** Temperature for generation */
+  temperature?: number;
+  /** Model to use */
+  model?: string;
+  /** Tool permissions */
+  permissions?: Record<string, 'allow' | 'ask' | 'deny'>;
+}
+/**
+ * OpenCode agent markdown format (for .opencode/agent/*.md files).
+ */
+interface OpenCodeAgentMarkdown {
+  /** Frontmatter */
+  frontmatter: {
+    name: string;
+    type: OpenCodeAgentType;
+    version?: string;
+    model?: string;
+    temperature?: number;
+    max_steps?: number;
+    tools?: string[];
+  };
+  /** Body content */
+  body: string;
+}
+/**
+ * Infer the appropriate OpenCode agent type from an AgentSpec.
+ *
+ * The inference is based on:
+ * - Tool capabilities (file editing, bash execution → build)
+ * - Instructions content (planning keywords → plan)
+ * - Exploration keywords (search, find → explore)
+ */
+declare function inferAgentType(spec: AgentSpec): OpenCodeAgentType;
+/**
+ * Convert an AgentSpec to OpenCode agent JSON configuration.
+ */
+declare function specToOpenCodeConfig(spec: AgentSpec, options?: {
+  agentType?: OpenCodeAgentType;
+  model?: string;
+  temperature?: number;
+  maxSteps?: number;
+}): OpenCodeAgentJSON;
+/**
+ * Convert an AgentSpec to OpenCode agent markdown format.
+ */
+declare function specToOpenCodeMarkdown(spec: AgentSpec, options?: {
+  agentType?: OpenCodeAgentType;
+  model?: string;
+  temperature?: number;
+  maxSteps?: number;
+}): OpenCodeAgentMarkdown;
+/**
+ * Serialize OpenCode agent markdown to string.
+ */
+declare function serializeOpenCodeMarkdown(markdown: OpenCodeAgentMarkdown): string;
+/**
+ * Convert OpenCode agent configuration to partial AgentSpec.
+ * Note: This is a partial conversion as OpenCode config may not have all spec fields.
+ */
+declare function openCodeConfigToSpec(config: OpenCodeAgentJSON): Partial<AgentSpec>;
+//#endregion
+export { OpenCodeAgentConfig, OpenCodeAgentJSON, OpenCodeAgentMarkdown, inferAgentType, openCodeConfigToSpec, serializeOpenCodeMarkdown, specToOpenCodeConfig, specToOpenCodeMarkdown };
+//# sourceMappingURL=agent-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-bridge.d.ts","names":[],"sources":["../../../src/providers/opencode-sdk/agent-bridge.ts"],"sourcesContent":[],"mappings":";;;;;;AAkFA;AA0DA;;AAGgB,UA1HC,iBAAA,CA0HD;EAKb;EAAiB,IAAA,EAAA,MAAA;EA2CJ;EACR,OAAA,CAAA,EAAA,MAAA;EAEQ;EAKb,WAAA,CAAA,EAAA,MAAA;EAAqB;EAyER,YAAA,CAAA,EAAA,MAAA;EAgDA;EACN,UAAA,EAlSI,iBAkSJ;EACC;EAAR,KAAA,CAAA,EAjSO,YAiSP,EAAA;EAAO;WA/RC;;;;;UAMM,mBAAA;;;;;;;;gBAQD;;;;;UAMC,qBAAA;;;;UAIP;;;;;;;;;;;;;;;;;;iBAuBM,cAAA,OAAqB,YAAY;;;;iBA0DjC,oBAAA,OACR;cAEQ;;;;IAKb;;;;iBA2Ca,sBAAA,OACR;cAEQ;;;;IAKb;;;;iBAyEa,yBAAA,WACJ;;;;;iBA+CI,oBAAA,SACN,oBACP,QAAQ"}

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

@@ -0,0 +1,165 @@
+import { specToolsToOpenCodeTools } from "./tool-bridge.js";
+
+//#region src/providers/opencode-sdk/agent-bridge.ts
+/**
+* Infer the appropriate OpenCode agent type from an AgentSpec.
+*
+* The inference is based on:
+* - Tool capabilities (file editing, bash execution → build)
+* - Instructions content (planning keywords → plan)
+* - Exploration keywords (search, find → explore)
+*/
+function inferAgentType(spec) {
+	const hasCodeTools = spec.tools.some((tool) => [
+		"write_file",
+		"edit_file",
+		"create_file",
+		"delete_file",
+		"bash",
+		"execute",
+		"run_command",
+		"terminal"
+	].includes(tool.name.toLowerCase()));
+	const instructionsLower = spec.instructions.toLowerCase();
+	const hasPlanningKeywords = /\b(plan|design|architect|strategy|analyze|review|assess|evaluate)\b/.test(instructionsLower);
+	const hasExplorationKeywords = /\b(search|find|explore|discover|locate|grep|pattern)\b/.test(instructionsLower);
+	const hasResearchKeywords = /\b(research|investigate|understand|learn|gather|collect)\b/.test(instructionsLower);
+	if (hasCodeTools) return "build";
+	if (hasPlanningKeywords && !hasCodeTools) return "plan";
+	if (hasExplorationKeywords && !hasResearchKeywords) return "explore";
+	return "general";
+}
+/**
+* Convert an AgentSpec to OpenCode agent JSON configuration.
+*/
+function specToOpenCodeConfig(spec, options) {
+	const agentType = options?.agentType ?? inferAgentType(spec);
+	return {
+		name: spec.meta.key,
+		version: spec.meta.version,
+		description: spec.description ?? spec.meta.description,
+		instructions: spec.instructions,
+		agent_type: agentType,
+		tools: specToolsToOpenCodeTools(spec.tools),
+		config: {
+			max_steps: options?.maxSteps ?? spec.maxSteps ?? 10,
+			temperature: options?.temperature ?? .7,
+			model: options?.model,
+			permissions: buildPermissions(spec)
+		}
+	};
+}
+/**
+* Build tool permissions from spec.
+*/
+function buildPermissions(spec) {
+	const permissions = {};
+	for (const tool of spec.tools) if (tool.requiresApproval) permissions[tool.name] = "ask";
+	else if (tool.automationSafe === false) permissions[tool.name] = "ask";
+	else permissions[tool.name] = "allow";
+	return permissions;
+}
+/**
+* Convert an AgentSpec to OpenCode agent markdown format.
+*/
+function specToOpenCodeMarkdown(spec, options) {
+	const agentType = options?.agentType ?? inferAgentType(spec);
+	return {
+		frontmatter: {
+			name: spec.meta.key,
+			type: agentType,
+			version: spec.meta.version,
+			model: options?.model,
+			temperature: options?.temperature ?? .7,
+			max_steps: options?.maxSteps ?? spec.maxSteps ?? 10,
+			tools: spec.tools.map((t) => t.name)
+		},
+		body: buildMarkdownBody(spec)
+	};
+}
+/**
+* Build markdown body content from spec.
+*/
+function buildMarkdownBody(spec) {
+	const lines = [];
+	lines.push(`# ${spec.meta.key}`);
+	lines.push("");
+	if (spec.description ?? spec.meta.description) {
+		lines.push(spec.description ?? spec.meta.description ?? "");
+		lines.push("");
+	}
+	lines.push("## Instructions");
+	lines.push("");
+	lines.push(spec.instructions);
+	lines.push("");
+	if (spec.tools.length > 0) {
+		lines.push("## Tools");
+		lines.push("");
+		for (const tool of spec.tools) {
+			const permission = tool.requiresApproval ? "(requires approval)" : tool.automationSafe === false ? "(ask mode)" : "";
+			lines.push(`- **${tool.name}**: ${tool.description ?? "No description"} ${permission}`.trim());
+		}
+		lines.push("");
+	}
+	if (spec.knowledge && spec.knowledge.length > 0) {
+		lines.push("## Knowledge Sources");
+		lines.push("");
+		for (const k of spec.knowledge) {
+			const required = k.required ? "(required)" : "(optional)";
+			lines.push(`- ${k.key} ${required}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Serialize OpenCode agent markdown to string.
+*/
+function serializeOpenCodeMarkdown(markdown) {
+	const lines = [];
+	lines.push("---");
+	lines.push(`name: ${markdown.frontmatter.name}`);
+	lines.push(`type: ${markdown.frontmatter.type}`);
+	if (markdown.frontmatter.version) lines.push(`version: ${markdown.frontmatter.version}`);
+	if (markdown.frontmatter.model) lines.push(`model: ${markdown.frontmatter.model}`);
+	if (markdown.frontmatter.temperature !== void 0) lines.push(`temperature: ${markdown.frontmatter.temperature}`);
+	if (markdown.frontmatter.max_steps !== void 0) lines.push(`max_steps: ${markdown.frontmatter.max_steps}`);
+	if (markdown.frontmatter.tools && markdown.frontmatter.tools.length > 0) {
+		lines.push(`tools:`);
+		for (const tool of markdown.frontmatter.tools) lines.push(`  - ${tool}`);
+	}
+	lines.push("---");
+	lines.push("");
+	lines.push(markdown.body);
+	return lines.join("\n");
+}
+/**
+* Convert OpenCode agent configuration to partial AgentSpec.
+* Note: This is a partial conversion as OpenCode config may not have all spec fields.
+*/
+function openCodeConfigToSpec(config) {
+	return {
+		meta: {
+			key: config.name,
+			version: config.version ?? "1.0.0",
+			description: config.description ?? "",
+			stability: "experimental",
+			owners: [],
+			tags: []
+		},
+		description: config.description,
+		instructions: config.instructions ?? "",
+		tools: config.tools?.map((tool) => ({
+			name: tool.name,
+			description: tool.description,
+			schema: tool.parameters,
+			requiresApproval: tool.permission === "ask",
+			automationSafe: tool.permission === "allow"
+		})) ?? [],
+		maxSteps: config.config?.max_steps ?? 10
+	};
+}
+
+//#endregion
+export { inferAgentType, openCodeConfigToSpec, serializeOpenCodeMarkdown, specToOpenCodeConfig, specToOpenCodeMarkdown };
+//# sourceMappingURL=agent-bridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-bridge.js","names":["permissions: Record<string, 'allow' | 'ask' | 'deny'>","lines: string[]"],"sources":["../../../src/providers/opencode-sdk/agent-bridge.ts"],"sourcesContent":["/**\n * Agent bridge for mapping between ContractSpec AgentSpec and OpenCode agent configuration.\n *\n * OpenCode has four built-in agent types:\n * - build: Primary agent with all tools enabled (default for code generation)\n * - plan: Restricted agent for analysis/planning (file edits and bash in \"ask\" mode)\n * - general: Subagent for complex questions and multi-step tasks\n * - explore: Fast subagent for codebase exploration\n */\n\nimport type { AgentSpec } from '../../spec/spec';\nimport type { OpenCodeAgentType } from '../types';\nimport { specToolsToOpenCodeTools, type OpenCodeTool } from './tool-bridge';\n\n// ============================================================================\n// OpenCode Agent Configuration Types\n// ============================================================================\n\n/**\n * OpenCode agent configuration in JSON format.\n */\nexport interface OpenCodeAgentJSON {\n  /** Agent name */\n  name: string;\n  /** Agent version */\n  version?: string;\n  /** Agent description */\n  description?: string;\n  /** System instructions */\n  instructions?: string;\n  /** Agent type */\n  agent_type: OpenCodeAgentType;\n  /** Available tools */\n  tools?: OpenCodeTool[];\n  /** Configuration options */\n  config?: OpenCodeAgentConfig;\n}\n\n/**\n * OpenCode agent configuration options.\n */\nexport interface OpenCodeAgentConfig {\n  /** Maximum agentic iterations */\n  max_steps?: number;\n  /** Temperature for generation */\n  temperature?: number;\n  /** Model to use */\n  model?: string;\n  /** Tool permissions */\n  permissions?: Record<string, 'allow' | 'ask' | 'deny'>;\n}\n\n/**\n * OpenCode agent markdown format (for .opencode/agent/*.md files).\n */\nexport interface OpenCodeAgentMarkdown {\n  /** Frontmatter */\n  frontmatter: {\n    name: string;\n    type: OpenCodeAgentType;\n    version?: string;\n    model?: string;\n    temperature?: number;\n    max_steps?: number;\n    tools?: string[];\n  };\n  /** Body content */\n  body: string;\n}\n\n// ============================================================================\n// Agent Type Inference\n// ============================================================================\n\n/**\n * Infer the appropriate OpenCode agent type from an AgentSpec.\n *\n * The inference is based on:\n * - Tool capabilities (file editing, bash execution → build)\n * - Instructions content (planning keywords → plan)\n * - Exploration keywords (search, find → explore)\n */\nexport function inferAgentType(spec: AgentSpec): OpenCodeAgentType {\n  // Check for code-generation/modification tools\n  const hasCodeTools = spec.tools.some((tool) =>\n    [\n      'write_file',\n      'edit_file',\n      'create_file',\n      'delete_file',\n      'bash',\n      'execute',\n      'run_command',\n      'terminal',\n    ].includes(tool.name.toLowerCase())\n  );\n\n  // Check instructions for planning-related keywords\n  const instructionsLower = spec.instructions.toLowerCase();\n  const hasPlanningKeywords =\n    /\\b(plan|design|architect|strategy|analyze|review|assess|evaluate)\\b/.test(\n      instructionsLower\n    );\n\n  // Check for exploration-related keywords\n  const hasExplorationKeywords =\n    /\\b(search|find|explore|discover|locate|grep|pattern)\\b/.test(\n      instructionsLower\n    );\n\n  // Check for research/general keywords\n  const hasResearchKeywords =\n    /\\b(research|investigate|understand|learn|gather|collect)\\b/.test(\n      instructionsLower\n    );\n\n  // Decision logic\n  if (hasCodeTools) {\n    return 'build';\n  }\n\n  if (hasPlanningKeywords && !hasCodeTools) {\n    return 'plan';\n  }\n\n  if (hasExplorationKeywords && !hasResearchKeywords) {\n    return 'explore';\n  }\n\n  // Default to general for most use cases\n  return 'general';\n}\n\n// ============================================================================\n// Spec to OpenCode Conversion\n// ============================================================================\n\n/**\n * Convert an AgentSpec to OpenCode agent JSON configuration.\n */\nexport function specToOpenCodeConfig(\n  spec: AgentSpec,\n  options?: {\n    agentType?: OpenCodeAgentType;\n    model?: string;\n    temperature?: number;\n    maxSteps?: number;\n  }\n): OpenCodeAgentJSON {\n  const agentType = options?.agentType ?? inferAgentType(spec);\n\n  return {\n    name: spec.meta.key,\n    version: spec.meta.version,\n    description: spec.description ?? spec.meta.description,\n    instructions: spec.instructions,\n    agent_type: agentType,\n    tools: specToolsToOpenCodeTools(spec.tools),\n    config: {\n      max_steps: options?.maxSteps ?? spec.maxSteps ?? 10,\n      temperature: options?.temperature ?? 0.7,\n      model: options?.model,\n      permissions: buildPermissions(spec),\n    },\n  };\n}\n\n/**\n * Build tool permissions from spec.\n */\nfunction buildPermissions(\n  spec: AgentSpec\n): Record<string, 'allow' | 'ask' | 'deny'> {\n  const permissions: Record<string, 'allow' | 'ask' | 'deny'> = {};\n\n  for (const tool of spec.tools) {\n    if (tool.requiresApproval) {\n      permissions[tool.name] = 'ask';\n    } else if (tool.automationSafe === false) {\n      permissions[tool.name] = 'ask';\n    } else {\n      permissions[tool.name] = 'allow';\n    }\n  }\n\n  return permissions;\n}\n\n/**\n * Convert an AgentSpec to OpenCode agent markdown format.\n */\nexport function specToOpenCodeMarkdown(\n  spec: AgentSpec,\n  options?: {\n    agentType?: OpenCodeAgentType;\n    model?: string;\n    temperature?: number;\n    maxSteps?: number;\n  }\n): OpenCodeAgentMarkdown {\n  const agentType = options?.agentType ?? inferAgentType(spec);\n\n  return {\n    frontmatter: {\n      name: spec.meta.key,\n      type: agentType,\n      version: spec.meta.version,\n      model: options?.model,\n      temperature: options?.temperature ?? 0.7,\n      max_steps: options?.maxSteps ?? spec.maxSteps ?? 10,\n      tools: spec.tools.map((t) => t.name),\n    },\n    body: buildMarkdownBody(spec),\n  };\n}\n\n/**\n * Build markdown body content from spec.\n */\nfunction buildMarkdownBody(spec: AgentSpec): string {\n  const lines: string[] = [];\n\n  // Title\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('');\n\n  // Description\n  if (spec.description ?? spec.meta.description) {\n    lines.push(spec.description ?? spec.meta.description ?? '');\n    lines.push('');\n  }\n\n  // Instructions\n  lines.push('## Instructions');\n  lines.push('');\n  lines.push(spec.instructions);\n  lines.push('');\n\n  // Tools\n  if (spec.tools.length > 0) {\n    lines.push('## Tools');\n    lines.push('');\n    for (const tool of spec.tools) {\n      const permission = tool.requiresApproval\n        ? '(requires approval)'\n        : tool.automationSafe === false\n          ? '(ask mode)'\n          : '';\n      lines.push(\n        `- **${tool.name}**: ${tool.description ?? 'No description'} ${permission}`.trim()\n      );\n    }\n    lines.push('');\n  }\n\n  // Knowledge sources\n  if (spec.knowledge && spec.knowledge.length > 0) {\n    lines.push('## Knowledge Sources');\n    lines.push('');\n    for (const k of spec.knowledge) {\n      const required = k.required ? '(required)' : '(optional)';\n      lines.push(`- ${k.key} ${required}`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Serialize OpenCode agent markdown to string.\n */\nexport function serializeOpenCodeMarkdown(\n  markdown: OpenCodeAgentMarkdown\n): string {\n  const lines: string[] = [];\n\n  // Frontmatter\n  lines.push('---');\n  lines.push(`name: ${markdown.frontmatter.name}`);\n  lines.push(`type: ${markdown.frontmatter.type}`);\n\n  if (markdown.frontmatter.version) {\n    lines.push(`version: ${markdown.frontmatter.version}`);\n  }\n\n  if (markdown.frontmatter.model) {\n    lines.push(`model: ${markdown.frontmatter.model}`);\n  }\n\n  if (markdown.frontmatter.temperature !== undefined) {\n    lines.push(`temperature: ${markdown.frontmatter.temperature}`);\n  }\n\n  if (markdown.frontmatter.max_steps !== undefined) {\n    lines.push(`max_steps: ${markdown.frontmatter.max_steps}`);\n  }\n\n  if (markdown.frontmatter.tools && markdown.frontmatter.tools.length > 0) {\n    lines.push(`tools:`);\n    for (const tool of markdown.frontmatter.tools) {\n      lines.push(`  - ${tool}`);\n    }\n  }\n\n  lines.push('---');\n  lines.push('');\n  lines.push(markdown.body);\n\n  return lines.join('\\n');\n}\n\n// ============================================================================\n// OpenCode to Spec Conversion\n// ============================================================================\n\n/**\n * Convert OpenCode agent configuration to partial AgentSpec.\n * Note: This is a partial conversion as OpenCode config may not have all spec fields.\n */\nexport function openCodeConfigToSpec(\n  config: OpenCodeAgentJSON\n): Partial<AgentSpec> {\n  return {\n    meta: {\n      key: config.name,\n      version: config.version ?? '1.0.0',\n      description: config.description ?? '',\n      stability: 'experimental',\n      owners: [],\n      tags: [],\n    },\n    description: config.description,\n    instructions: config.instructions ?? '',\n    tools:\n      config.tools?.map((tool) => ({\n        name: tool.name,\n        description: tool.description,\n        schema: tool.parameters,\n        requiresApproval: tool.permission === 'ask',\n        automationSafe: tool.permission === 'allow',\n        // category not supported in AgentToolConfig\n      })) ?? [],\n    maxSteps: config.config?.max_steps ?? 10,\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+import { OpenCodeSDKProvider } from "./adapter.js";
+import { OpenCodeParameter, OpenCodeTool, OpenCodeToolCall, OpenCodeToolResult, createToolHandlerMap, executeToolCall, openCodeToolToSpecTool, openCodeToolsToSpecTools, specToolToExternalToolForOpenCode, specToolToOpenCodeTool, specToolsToOpenCodeTools } from "./tool-bridge.js";
+import { OpenCodeAgentConfig, OpenCodeAgentJSON, OpenCodeAgentMarkdown, inferAgentType, openCodeConfigToSpec, serializeOpenCodeMarkdown, specToOpenCodeConfig, specToOpenCodeMarkdown } from "./agent-bridge.js";
+export { OpenCodeAgentConfig, OpenCodeAgentJSON, OpenCodeAgentMarkdown, OpenCodeParameter, OpenCodeSDKProvider, OpenCodeTool, OpenCodeToolCall, OpenCodeToolResult, createToolHandlerMap, executeToolCall, inferAgentType, openCodeConfigToSpec, openCodeToolToSpecTool, openCodeToolsToSpecTools, serializeOpenCodeMarkdown, specToOpenCodeConfig, specToOpenCodeMarkdown, specToolToExternalToolForOpenCode, specToolToOpenCodeTool, specToolsToOpenCodeTools };

package/dist/providers/opencode-sdk/index.js

@@ -0,0 +1,5 @@
+import { createToolHandlerMap, executeToolCall, openCodeToolToSpecTool, openCodeToolsToSpecTools, specToolToExternalToolForOpenCode, specToolToOpenCodeTool, specToolsToOpenCodeTools } from "./tool-bridge.js";
+import { inferAgentType, openCodeConfigToSpec, serializeOpenCodeMarkdown, specToOpenCodeConfig, specToOpenCodeMarkdown } from "./agent-bridge.js";
+import { OpenCodeSDKProvider } from "./adapter.js";
+
+export { OpenCodeSDKProvider, createToolHandlerMap, executeToolCall, inferAgentType, openCodeConfigToSpec, openCodeToolToSpecTool, openCodeToolsToSpecTools, serializeOpenCodeMarkdown, specToOpenCodeConfig, specToOpenCodeMarkdown, specToolToExternalToolForOpenCode, specToolToOpenCodeTool, specToolsToOpenCodeTools };