@contractspec/lib.ai-agent 1.45.6 → 1.46.0

package/dist/interop/spec-consumer.js

@@ -0,0 +1,287 @@
+import { agentKey } from "../spec/spec.js";
+
+//#region src/interop/spec-consumer.ts
+/**
+* ContractSpec consumer for external agents.
+*
+* @example
+* ```typescript
+* const consumer = createSpecConsumer({
+*   specs: [myAgentSpec, anotherSpec],
+*   includeMetadata: true,
+* });
+*
+* // Get markdown representation
+* const markdown = consumer.getSpecMarkdown('my-agent.v1.0.0');
+*
+* // Get prompt for LLM
+* const prompt = consumer.getSpecPrompt('my-agent.v1.0.0', {
+*   includeTools: true,
+* });
+* ```
+*/
+var ContractSpecConsumer = class {
+	specs;
+	includeMetadata;
+	baseUrl;
+	constructor(config) {
+		this.specs = /* @__PURE__ */ new Map();
+		this.includeMetadata = config.includeMetadata ?? true;
+		this.baseUrl = config.baseUrl;
+		for (const spec of config.specs) {
+			const key = agentKey(spec.meta);
+			this.specs.set(key, spec);
+		}
+	}
+	/**
+	* Get a spec as markdown.
+	*/
+	getSpecMarkdown(specKey, options) {
+		const spec = this.specs.get(specKey);
+		if (!spec) throw new Error(`Spec not found: ${specKey}`);
+		const sections = [];
+		const opts = {
+			includeToc: options?.includeToc ?? true,
+			includeTools: options?.includeTools ?? true,
+			...options
+		};
+		if (opts.customHeader) {
+			sections.push(opts.customHeader);
+			sections.push("");
+		}
+		const specName = spec.meta.key;
+		sections.push(`# ${specName}`);
+		sections.push("");
+		if (spec.description) {
+			sections.push(spec.description);
+			sections.push("");
+		}
+		if (opts.includeToc) {
+			sections.push("## Table of Contents");
+			sections.push("");
+			sections.push("- [Overview](#overview)");
+			sections.push("- [Instructions](#instructions)");
+			if (opts.includeTools && spec.tools && spec.tools.length > 0) sections.push("- [Tools](#tools)");
+			if (spec.knowledge && spec.knowledge.length > 0) sections.push("- [Knowledge](#knowledge)");
+			sections.push("");
+		}
+		sections.push("## Overview");
+		sections.push("");
+		if (this.includeMetadata) {
+			sections.push(`- **Key**: \`${spec.meta.key}\``);
+			sections.push(`- **Version**: ${spec.meta.version}`);
+			if (spec.meta.stability) sections.push(`- **Stability**: ${spec.meta.stability}`);
+			if (spec.meta.owners && spec.meta.owners.length > 0) sections.push(`- **Owners**: ${spec.meta.owners.join(", ")}`);
+			if (spec.tags && spec.tags.length > 0) sections.push(`- **Tags**: ${spec.tags.join(", ")}`);
+		}
+		sections.push("");
+		sections.push("## Instructions");
+		sections.push("");
+		sections.push(spec.instructions);
+		sections.push("");
+		if (opts.includeTools && spec.tools && spec.tools.length > 0) {
+			sections.push("## Tools");
+			sections.push("");
+			for (const tool of spec.tools) {
+				sections.push(`### ${tool.name}`);
+				sections.push("");
+				if (tool.description) {
+					sections.push(tool.description);
+					sections.push("");
+				}
+				if (tool.schema) {
+					sections.push("**Schema:**");
+					sections.push("");
+					sections.push("```json");
+					sections.push(JSON.stringify(tool.schema, null, 2));
+					sections.push("```");
+					sections.push("");
+				}
+				if (tool.automationSafe !== void 0) {
+					sections.push(`**Automation Safe**: ${tool.automationSafe ? "Yes" : "No"}`);
+					sections.push("");
+				}
+			}
+		}
+		if (spec.knowledge && spec.knowledge.length > 0) {
+			sections.push("## Knowledge");
+			sections.push("");
+			for (const k of spec.knowledge) {
+				sections.push(`- **${k.key}**${k.required ? " (required)" : ""}`);
+				if (k.instructions) sections.push(`  - ${k.instructions}`);
+			}
+			sections.push("");
+		}
+		if (spec.policy) {
+			sections.push("## Policy");
+			sections.push("");
+			if (spec.policy.confidence) sections.push(`- **Minimum Confidence**: ${spec.policy.confidence.min ?? .7}`);
+			if (spec.policy.escalation) {
+				const esc = spec.policy.escalation;
+				if (esc.confidenceThreshold) sections.push(`- **Escalation Threshold**: ${esc.confidenceThreshold}`);
+				if (esc.onToolFailure) sections.push("- **Escalate on Tool Failure**: Yes");
+				if (esc.onTimeout) sections.push("- **Escalate on Timeout**: Yes");
+			}
+			sections.push("");
+		}
+		return sections.join("\n");
+	}
+	/**
+	* Get a spec as an LLM prompt.
+	*/
+	getSpecPrompt(specKey, options) {
+		const spec = this.specs.get(specKey);
+		if (!spec) throw new Error(`Spec not found: ${specKey}`);
+		const sections = [];
+		const opts = {
+			includeTools: options?.includeTools ?? true,
+			format: options?.format ?? "structured",
+			...options
+		};
+		sections.push("# Agent Identity");
+		sections.push("");
+		sections.push(`You are ${spec.meta.key} (v${spec.meta.version}).`);
+		sections.push("");
+		if (spec.description) {
+			sections.push("## Description");
+			sections.push("");
+			sections.push(spec.description);
+			sections.push("");
+		}
+		sections.push("## Instructions");
+		sections.push("");
+		sections.push(spec.instructions);
+		sections.push("");
+		if (opts.includeTools && spec.tools && spec.tools.length > 0) {
+			sections.push("## Available Tools");
+			sections.push("");
+			sections.push("You have access to the following tools:");
+			sections.push("");
+			for (const tool of spec.tools) {
+				sections.push(`### ${tool.name}`);
+				sections.push("");
+				if (tool.description) {
+					sections.push(tool.description);
+					sections.push("");
+				}
+				if (tool.schema && opts.format === "structured") {
+					sections.push("Parameters:");
+					sections.push("```json");
+					sections.push(JSON.stringify(tool.schema, null, 2));
+					sections.push("```");
+					sections.push("");
+				}
+			}
+		}
+		if (spec.knowledge && spec.knowledge.length > 0) {
+			const requiredKnowledge = spec.knowledge.filter((k) => k.required);
+			if (requiredKnowledge.length > 0) {
+				sections.push("## Knowledge Context");
+				sections.push("");
+				for (const k of requiredKnowledge) if (k.instructions) {
+					sections.push(k.instructions);
+					sections.push("");
+				}
+			}
+		}
+		if (options?.customContext) {
+			sections.push("## Additional Context");
+			sections.push("");
+			sections.push(options.customContext);
+			sections.push("");
+		}
+		return sections.join("\n");
+	}
+	/**
+	* List available specs.
+	*/
+	listSpecs(options) {
+		const results = [];
+		for (const [key, spec] of this.specs) {
+			if (options?.stability && spec.meta.stability !== options.stability) continue;
+			if (options?.tags && options.tags.length > 0) {
+				const specTags = spec.tags ?? [];
+				if (!options.tags.some((tag) => specTags.includes(tag))) continue;
+			}
+			results.push({
+				key,
+				name: spec.meta.key,
+				version: spec.meta.version,
+				description: spec.description,
+				stability: spec.meta.stability,
+				tags: spec.tags,
+				toolCount: spec.tools?.length ?? 0
+			});
+		}
+		return results;
+	}
+	/**
+	* Query a spec by key.
+	*/
+	querySpec(specKey) {
+		const spec = this.specs.get(specKey);
+		if (!spec) return;
+		return {
+			key: specKey,
+			spec,
+			markdown: this.getSpecMarkdown(specKey),
+			prompt: this.getSpecPrompt(specKey)
+		};
+	}
+	/**
+	* Check if a spec exists.
+	*/
+	hasSpec(specKey) {
+		return this.specs.has(specKey);
+	}
+	/**
+	* Get a spec by key.
+	*/
+	getSpec(specKey) {
+		return this.specs.get(specKey);
+	}
+	/**
+	* Get all specs.
+	*/
+	getAllSpecs() {
+		return Array.from(this.specs.values());
+	}
+	/**
+	* Get spec count.
+	*/
+	getSpecCount() {
+		return this.specs.size;
+	}
+	/**
+	* Add a spec to the consumer.
+	*/
+	addSpec(spec) {
+		const key = agentKey(spec.meta);
+		this.specs.set(key, spec);
+	}
+	/**
+	* Remove a spec from the consumer.
+	*/
+	removeSpec(specKey) {
+		return this.specs.delete(specKey);
+	}
+};
+/**
+* Create a new spec consumer.
+*/
+function createSpecConsumer(config) {
+	return new ContractSpecConsumer(config);
+}
+/**
+* Create a spec consumer from a single spec.
+*/
+function createSingleSpecConsumer(spec, options) {
+	return new ContractSpecConsumer({
+		specs: [spec],
+		...options
+	});
+}
+
+//#endregion
+export { ContractSpecConsumer, createSingleSpecConsumer, createSpecConsumer };
+//# sourceMappingURL=spec-consumer.js.map

package/dist/interop/spec-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-consumer.js","names":["sections: string[]","results: SpecListResult[]"],"sources":["../../src/interop/spec-consumer.ts"],"sourcesContent":["/**\n * Spec consumer for external agents.\n *\n * Enables external agent SDKs to consume ContractSpec specs:\n * - Read spec definitions as markdown/prompts\n * - List available specs\n * - Query spec metadata\n */\nimport type { AgentSpec } from '../spec/spec';\nimport { agentKey } from '../spec/spec';\nimport type {\n  SpecConsumer,\n  SpecConsumerConfig,\n  SpecMarkdownOptions,\n  SpecPromptOptions,\n  SpecQueryResult,\n  SpecListOptions,\n  SpecListResult,\n} from './types';\n\n// =============================================================================\n// Spec Consumer Implementation\n// =============================================================================\n\n/**\n * ContractSpec consumer for external agents.\n *\n * @example\n * ```typescript\n * const consumer = createSpecConsumer({\n *   specs: [myAgentSpec, anotherSpec],\n *   includeMetadata: true,\n * });\n *\n * // Get markdown representation\n * const markdown = consumer.getSpecMarkdown('my-agent.v1.0.0');\n *\n * // Get prompt for LLM\n * const prompt = consumer.getSpecPrompt('my-agent.v1.0.0', {\n *   includeTools: true,\n * });\n * ```\n */\nexport class ContractSpecConsumer implements SpecConsumer {\n  private readonly specs: Map<string, AgentSpec>;\n  private readonly includeMetadata: boolean;\n  private readonly baseUrl?: string;\n\n  constructor(config: SpecConsumerConfig) {\n    this.specs = new Map();\n    this.includeMetadata = config.includeMetadata ?? true;\n    this.baseUrl = config.baseUrl;\n\n    // Index specs by key\n    for (const spec of config.specs) {\n      const key = agentKey(spec.meta);\n      this.specs.set(key, spec);\n    }\n  }\n\n  /**\n   * Get a spec as markdown.\n   */\n  getSpecMarkdown(specKey: string, options?: SpecMarkdownOptions): string {\n    const spec = this.specs.get(specKey);\n    if (!spec) {\n      throw new Error(`Spec not found: ${specKey}`);\n    }\n\n    const sections: string[] = [];\n    const opts = {\n      includeToc: options?.includeToc ?? true,\n      includeTools: options?.includeTools ?? true,\n      ...options,\n    };\n\n    // Custom header\n    if (opts.customHeader) {\n      sections.push(opts.customHeader);\n      sections.push('');\n    }\n\n    // Header - use key as name\n    const specName = spec.meta.key;\n    sections.push(`# ${specName}`);\n    sections.push('');\n\n    if (spec.description) {\n      sections.push(spec.description);\n      sections.push('');\n    }\n\n    // Table of contents\n    if (opts.includeToc) {\n      sections.push('## Table of Contents');\n      sections.push('');\n      sections.push('- [Overview](#overview)');\n      sections.push('- [Instructions](#instructions)');\n      if (opts.includeTools && spec.tools && spec.tools.length > 0) {\n        sections.push('- [Tools](#tools)');\n      }\n      if (spec.knowledge && spec.knowledge.length > 0) {\n        sections.push('- [Knowledge](#knowledge)');\n      }\n      sections.push('');\n    }\n\n    // Overview\n    sections.push('## Overview');\n    sections.push('');\n    if (this.includeMetadata) {\n      sections.push(`- **Key**: \\`${spec.meta.key}\\``);\n      sections.push(`- **Version**: ${spec.meta.version}`);\n      if (spec.meta.stability) {\n        sections.push(`- **Stability**: ${spec.meta.stability}`);\n      }\n      if (spec.meta.owners && spec.meta.owners.length > 0) {\n        sections.push(`- **Owners**: ${spec.meta.owners.join(', ')}`);\n      }\n      if (spec.tags && spec.tags.length > 0) {\n        sections.push(`- **Tags**: ${spec.tags.join(', ')}`);\n      }\n    }\n    sections.push('');\n\n    // Instructions\n    sections.push('## Instructions');\n    sections.push('');\n    sections.push(spec.instructions);\n    sections.push('');\n\n    // Tools\n    if (opts.includeTools && spec.tools && spec.tools.length > 0) {\n      sections.push('## Tools');\n      sections.push('');\n      for (const tool of spec.tools) {\n        sections.push(`### ${tool.name}`);\n        sections.push('');\n        if (tool.description) {\n          sections.push(tool.description);\n          sections.push('');\n        }\n        if (tool.schema) {\n          sections.push('**Schema:**');\n          sections.push('');\n          sections.push('```json');\n          sections.push(JSON.stringify(tool.schema, null, 2));\n          sections.push('```');\n          sections.push('');\n        }\n        if (tool.automationSafe !== undefined) {\n          sections.push(\n            `**Automation Safe**: ${tool.automationSafe ? 'Yes' : 'No'}`\n          );\n          sections.push('');\n        }\n      }\n    }\n\n    // Knowledge\n    if (spec.knowledge && spec.knowledge.length > 0) {\n      sections.push('## Knowledge');\n      sections.push('');\n      for (const k of spec.knowledge) {\n        sections.push(`- **${k.key}**${k.required ? ' (required)' : ''}`);\n        if (k.instructions) {\n          sections.push(`  - ${k.instructions}`);\n        }\n      }\n      sections.push('');\n    }\n\n    // Policy\n    if (spec.policy) {\n      sections.push('## Policy');\n      sections.push('');\n      if (spec.policy.confidence) {\n        sections.push(\n          `- **Minimum Confidence**: ${spec.policy.confidence.min ?? 0.7}`\n        );\n      }\n      if (spec.policy.escalation) {\n        const esc = spec.policy.escalation;\n        if (esc.confidenceThreshold) {\n          sections.push(\n            `- **Escalation Threshold**: ${esc.confidenceThreshold}`\n          );\n        }\n        if (esc.onToolFailure) {\n          sections.push('- **Escalate on Tool Failure**: Yes');\n        }\n        if (esc.onTimeout) {\n          sections.push('- **Escalate on Timeout**: Yes');\n        }\n      }\n      sections.push('');\n    }\n\n    return sections.join('\\n');\n  }\n\n  /**\n   * Get a spec as an LLM prompt.\n   */\n  getSpecPrompt(specKey: string, options?: SpecPromptOptions): string {\n    const spec = this.specs.get(specKey);\n    if (!spec) {\n      throw new Error(`Spec not found: ${specKey}`);\n    }\n\n    const sections: string[] = [];\n    const opts = {\n      includeTools: options?.includeTools ?? true,\n      format: options?.format ?? 'structured',\n      ...options,\n    };\n\n    // Identity section\n    sections.push('# Agent Identity');\n    sections.push('');\n    sections.push(`You are ${spec.meta.key} (v${spec.meta.version}).`);\n    sections.push('');\n\n    // Description\n    if (spec.description) {\n      sections.push('## Description');\n      sections.push('');\n      sections.push(spec.description);\n      sections.push('');\n    }\n\n    // Instructions\n    sections.push('## Instructions');\n    sections.push('');\n    sections.push(spec.instructions);\n    sections.push('');\n\n    // Tools\n    if (opts.includeTools && spec.tools && spec.tools.length > 0) {\n      sections.push('## Available Tools');\n      sections.push('');\n      sections.push('You have access to the following tools:');\n      sections.push('');\n\n      for (const tool of spec.tools) {\n        sections.push(`### ${tool.name}`);\n        sections.push('');\n        if (tool.description) {\n          sections.push(tool.description);\n          sections.push('');\n        }\n        if (tool.schema && opts.format === 'structured') {\n          sections.push('Parameters:');\n          sections.push('```json');\n          sections.push(JSON.stringify(tool.schema, null, 2));\n          sections.push('```');\n          sections.push('');\n        }\n      }\n    }\n\n    // Knowledge instructions\n    if (spec.knowledge && spec.knowledge.length > 0) {\n      const requiredKnowledge = spec.knowledge.filter((k) => k.required);\n      if (requiredKnowledge.length > 0) {\n        sections.push('## Knowledge Context');\n        sections.push('');\n        for (const k of requiredKnowledge) {\n          if (k.instructions) {\n            sections.push(k.instructions);\n            sections.push('');\n          }\n        }\n      }\n    }\n\n    // Custom context\n    if (options?.customContext) {\n      sections.push('## Additional Context');\n      sections.push('');\n      sections.push(options.customContext);\n      sections.push('');\n    }\n\n    return sections.join('\\n');\n  }\n\n  /**\n   * List available specs.\n   */\n  listSpecs(options?: SpecListOptions): SpecListResult[] {\n    const results: SpecListResult[] = [];\n\n    for (const [key, spec] of this.specs) {\n      // Apply filters\n      if (options?.stability && spec.meta.stability !== options.stability) {\n        continue;\n      }\n      if (options?.tags && options.tags.length > 0) {\n        const specTags = spec.tags ?? [];\n        const hasMatchingTag = options.tags.some((tag) =>\n          specTags.includes(tag)\n        );\n        if (!hasMatchingTag) {\n          continue;\n        }\n      }\n\n      results.push({\n        key,\n        name: spec.meta.key,\n        version: spec.meta.version,\n        description: spec.description,\n        stability: spec.meta.stability,\n        tags: spec.tags,\n        toolCount: spec.tools?.length ?? 0,\n      });\n    }\n\n    return results;\n  }\n\n  /**\n   * Query a spec by key.\n   */\n  querySpec(specKey: string): SpecQueryResult | undefined {\n    const spec = this.specs.get(specKey);\n    if (!spec) {\n      return undefined;\n    }\n\n    return {\n      key: specKey,\n      spec,\n      markdown: this.getSpecMarkdown(specKey),\n      prompt: this.getSpecPrompt(specKey),\n    };\n  }\n\n  /**\n   * Check if a spec exists.\n   */\n  hasSpec(specKey: string): boolean {\n    return this.specs.has(specKey);\n  }\n\n  /**\n   * Get a spec by key.\n   */\n  getSpec(specKey: string): AgentSpec | undefined {\n    return this.specs.get(specKey);\n  }\n\n  /**\n   * Get all specs.\n   */\n  getAllSpecs(): AgentSpec[] {\n    return Array.from(this.specs.values());\n  }\n\n  /**\n   * Get spec count.\n   */\n  getSpecCount(): number {\n    return this.specs.size;\n  }\n\n  /**\n   * Add a spec to the consumer.\n   */\n  addSpec(spec: AgentSpec): void {\n    const key = agentKey(spec.meta);\n    this.specs.set(key, spec);\n  }\n\n  /**\n   * Remove a spec from the consumer.\n   */\n  removeSpec(specKey: string): boolean {\n    return this.specs.delete(specKey);\n  }\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Create a new spec consumer.\n */\nexport function createSpecConsumer(config: SpecConsumerConfig): SpecConsumer {\n  return new ContractSpecConsumer(config);\n}\n\n/**\n * Create a spec consumer from a single spec.\n */\nexport function createSingleSpecConsumer(\n  spec: AgentSpec,\n  options?: Omit<SpecConsumerConfig, 'specs'>\n): SpecConsumer {\n  return new ContractSpecConsumer({\n    specs: [spec],\n    ...options,\n  });\n}\n"],"mappings":"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"}

package/dist/interop/tool-consumer.d.ts

@@ -0,0 +1,68 @@
+import { AgentToolConfig } from "../spec/spec.js";
+import { ToolExecutionContext, ToolHandler } from "../types.js";
+import { ToolConsumer, ToolConsumerConfig, ToolExportFormat, ToolServer, ToolServerConfig } from "./types.js";
+
+//#region src/interop/tool-consumer.d.ts
+
+/**
+ * ContractSpec tool consumer for external agents.
+ */
+declare class ContractSpecToolConsumer implements ToolConsumer {
+  private readonly tools;
+  constructor(config: ToolConsumerConfig);
+  /**
+   * Create an MCP server exposing the tools.
+   */
+  createToolServer(config?: Partial<ToolServerConfig>): ToolServer;
+  /**
+   * Export tools for a specific SDK format.
+   */
+  exportToolsForSDK(format: ToolExportFormat): unknown[];
+  /**
+   * Create a bridged handler for a specific SDK.
+   */
+  createBridgedHandler(toolName: string, _format: ToolExportFormat): ((args: Record<string, unknown>) => Promise<unknown>) | undefined;
+  /**
+   * Get all tools.
+   */
+  getTools(): AgentToolConfig[];
+  /**
+   * Get a specific tool.
+   */
+  getTool(name: string): AgentToolConfig | undefined;
+  /**
+   * Check if a tool exists.
+   */
+  hasTool(name: string): boolean;
+  /**
+   * Execute a tool.
+   */
+  executeTool(name: string, args: Record<string, unknown>, context?: ToolExecutionContext): Promise<string>;
+  /**
+   * Add a tool.
+   */
+  addTool(config: AgentToolConfig, handler?: ToolHandler): void;
+  /**
+   * Remove a tool.
+   */
+  removeTool(name: string): boolean;
+  /**
+   * Get tool count.
+   */
+  getToolCount(): number;
+}
+/**
+ * Create a new tool consumer.
+ */
+declare function createToolConsumer(config: ToolConsumerConfig): ToolConsumer;
+/**
+ * Create an MCP tool server from tools.
+ */
+declare function createToolServer(config: ToolServerConfig): ToolServer;
+/**
+ * Export tools to a specific SDK format.
+ */
+declare function exportToolsForExternalSDK(tools: AgentToolConfig[], format: ToolExportFormat): unknown[];
+//#endregion
+export { ContractSpecToolConsumer, createToolConsumer, createToolServer, exportToolsForExternalSDK };
+//# sourceMappingURL=tool-consumer.d.ts.map

package/dist/interop/tool-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-consumer.d.ts","names":[],"sources":["../../src/interop/tool-consumer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAoQc,cA1GD,wBAAA,YAAoC,YA0GnC,CAAA;EAOW,iBAAA,KAAA;EAgBf,WAAA,CAAA,MAAA,EA3HY,kBA2HZ;EACI;;;EA0B+B,gBAAA,CAAA,MAAA,CAAA,EA1IjB,OA0IiB,CA1IT,gBA0IS,CAAA,CAAA,EA1IW,UA0IX;EA5JI;;AAsLjD;EAOgB,iBAAA,CAAA,MAAgB,EAjKJ,gBAiKa,CAAA,EAAA,OAAmB,EAAA;EAO5C;;;kDAlHH,2BACA,4BAA4B;;;;cAuB3B;;;;yBAOW;;;;;;;;kCAgBf,mCACI,uBACT;;;;kBAyBa,2BAA2B;;;;;;;;;;;;;iBA0B7B,kBAAA,SAA2B,qBAAqB;;;;iBAOhD,gBAAA,SAAyB,mBAAmB;;;;iBAO5C,yBAAA,QACP,2BACC"}

package/dist/interop/tool-consumer.js

@@ -0,0 +1,220 @@
+import { specToolToClaudeAgentTool } from "../providers/claude-agent-sdk/tool-bridge.js";
+import { specToolToOpenCodeTool } from "../providers/opencode-sdk/tool-bridge.js";
+
+//#region src/interop/tool-consumer.ts
+/**
+* Simple MCP-compatible tool server.
+*/
+var MCPToolServer = class {
+	tools;
+	name;
+	version;
+	running = false;
+	constructor(config) {
+		this.tools = /* @__PURE__ */ new Map();
+		this.name = config.name ?? "contractspec-tools";
+		this.version = config.version ?? "1.0.0";
+		for (const tool of config.tools) this.tools.set(tool.config.name, tool);
+	}
+	async start() {
+		if (this.running) return;
+		this.running = true;
+		console.log(`[MCPToolServer] Started ${this.name}@${this.version} with ${this.tools.size} tools`);
+	}
+	async stop() {
+		if (!this.running) return;
+		this.running = false;
+		console.log(`[MCPToolServer] Stopped ${this.name}`);
+	}
+	isRunning() {
+		return this.running;
+	}
+	getTools() {
+		return Array.from(this.tools.values()).map((t) => t.config);
+	}
+	async executeTool(toolName, args, context) {
+		const tool = this.tools.get(toolName);
+		if (!tool) throw new Error(`Tool not found: ${toolName}`);
+		if (!tool.handler) throw new Error(`No handler registered for tool: ${toolName}`);
+		const fullContext = {
+			agentId: context?.agentId ?? "mcp-server",
+			sessionId: context?.sessionId ?? "mcp-session",
+			tenantId: context?.tenantId,
+			actorId: context?.actorId,
+			metadata: context?.metadata,
+			signal: context?.signal
+		};
+		return await tool.handler(args, fullContext);
+	}
+	/**
+	* Get MCP-compatible tool definitions.
+	*/
+	getMCPToolDefinitions() {
+		const definitions = [];
+		for (const [name, tool] of this.tools) definitions.push({
+			name,
+			description: tool.config.description ?? "",
+			inputSchema: tool.config.schema ?? {
+				type: "object",
+				properties: {}
+			}
+		});
+		return definitions;
+	}
+	/**
+	* Get server info for MCP.
+	*/
+	getServerInfo() {
+		return {
+			name: this.name,
+			version: this.version,
+			tools: this.tools.size,
+			running: this.running
+		};
+	}
+};
+/**
+* ContractSpec tool consumer for external agents.
+*/
+var ContractSpecToolConsumer = class {
+	tools;
+	constructor(config) {
+		this.tools = /* @__PURE__ */ new Map();
+		for (const tool of config.tools) this.tools.set(tool.config.name, tool);
+	}
+	/**
+	* Create an MCP server exposing the tools.
+	*/
+	createToolServer(config) {
+		return new MCPToolServer({
+			tools: Array.from(this.tools.values()),
+			...config
+		});
+	}
+	/**
+	* Export tools for a specific SDK format.
+	*/
+	exportToolsForSDK(format) {
+		const tools = Array.from(this.tools.values());
+		const defaultContext = {
+			agentId: "export",
+			sessionId: "export"
+		};
+		switch (format) {
+			case "claude-agent": return tools.filter((tool) => !!tool.handler).map((tool) => specToolToClaudeAgentTool(tool.config, tool.handler, defaultContext));
+			case "opencode": return tools.map((tool) => specToolToOpenCodeTool(tool.config));
+			case "mcp": return tools.map((tool) => ({
+				name: tool.config.name,
+				description: tool.config.description ?? "",
+				inputSchema: tool.config.schema ?? {
+					type: "object",
+					properties: {}
+				}
+			}));
+			case "openai": return tools.map((tool) => ({
+				type: "function",
+				function: {
+					name: tool.config.name,
+					description: tool.config.description ?? "",
+					parameters: tool.config.schema ?? {
+						type: "object",
+						properties: {}
+					}
+				}
+			}));
+			default: throw new Error(`Unknown export format: ${format}`);
+		}
+	}
+	/**
+	* Create a bridged handler for a specific SDK.
+	*/
+	createBridgedHandler(toolName, _format) {
+		const tool = this.tools.get(toolName);
+		if (!tool || !tool.handler) return;
+		const handler = tool.handler;
+		return async (args) => {
+			return handler(args, {
+				agentId: "bridge",
+				sessionId: "bridge"
+			});
+		};
+	}
+	/**
+	* Get all tools.
+	*/
+	getTools() {
+		return Array.from(this.tools.values()).map((t) => t.config);
+	}
+	/**
+	* Get a specific tool.
+	*/
+	getTool(name) {
+		return this.tools.get(name)?.config;
+	}
+	/**
+	* Check if a tool exists.
+	*/
+	hasTool(name) {
+		return this.tools.has(name);
+	}
+	/**
+	* Execute a tool.
+	*/
+	async executeTool(name, args, context) {
+		const tool = this.tools.get(name);
+		if (!tool) throw new Error(`Tool not found: ${name}`);
+		if (!tool.handler) throw new Error(`No handler for tool: ${name}`);
+		const fullContext = {
+			agentId: context?.agentId ?? "consumer",
+			sessionId: context?.sessionId ?? "consumer-session",
+			tenantId: context?.tenantId,
+			actorId: context?.actorId,
+			metadata: context?.metadata,
+			signal: context?.signal
+		};
+		return await tool.handler(args, fullContext);
+	}
+	/**
+	* Add a tool.
+	*/
+	addTool(config, handler) {
+		this.tools.set(config.name, {
+			config,
+			handler
+		});
+	}
+	/**
+	* Remove a tool.
+	*/
+	removeTool(name) {
+		return this.tools.delete(name);
+	}
+	/**
+	* Get tool count.
+	*/
+	getToolCount() {
+		return this.tools.size;
+	}
+};
+/**
+* Create a new tool consumer.
+*/
+function createToolConsumer(config) {
+	return new ContractSpecToolConsumer(config);
+}
+/**
+* Create an MCP tool server from tools.
+*/
+function createToolServer(config) {
+	return new MCPToolServer(config);
+}
+/**
+* Export tools to a specific SDK format.
+*/
+function exportToolsForExternalSDK(tools, format) {
+	return new ContractSpecToolConsumer({ tools: tools.map((config) => ({ config })) }).exportToolsForSDK(format);
+}
+
+//#endregion
+export { ContractSpecToolConsumer, createToolConsumer, createToolServer, exportToolsForExternalSDK };
+//# sourceMappingURL=tool-consumer.js.map

package/dist/interop/tool-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-consumer.js","names":["fullContext: ToolExecutionContext","definitions: {\n      name: string;\n      description: string;\n      inputSchema: Record<string, unknown>;\n    }[]","defaultContext: Partial<ToolExecutionContext>"],"sources":["../../src/interop/tool-consumer.ts"],"sourcesContent":["/**\n * Tool consumer for external agents.\n *\n * Enables external agent SDKs to consume ContractSpec tools:\n * - Create MCP servers exposing tools\n * - Export tools for specific SDK formats\n * - Bridge tool execution\n */\nimport type { AgentToolConfig } from '../spec/spec';\nimport type { ToolHandler, ToolExecutionContext } from '../types';\nimport type {\n  ToolConsumer,\n  ToolConsumerConfig,\n  ToolServerConfig,\n  ToolServer,\n  ToolExportFormat,\n} from './types';\nimport { specToolToClaudeAgentTool } from '../providers/claude-agent-sdk/tool-bridge';\nimport { specToolToOpenCodeTool } from '../providers/opencode-sdk/tool-bridge';\n\n// =============================================================================\n// Tool Server Implementation\n// =============================================================================\n\n/**\n * Simple MCP-compatible tool server.\n */\nclass MCPToolServer implements ToolServer {\n  private readonly tools: Map<\n    string,\n    { config: AgentToolConfig; handler?: ToolHandler }\n  >;\n  private readonly name: string;\n  private readonly version: string;\n  private running = false;\n\n  constructor(config: ToolServerConfig) {\n    this.tools = new Map();\n    this.name = config.name ?? 'contractspec-tools';\n    this.version = config.version ?? '1.0.0';\n\n    // Register tools\n    for (const tool of config.tools) {\n      this.tools.set(tool.config.name, tool);\n    }\n  }\n\n  async start(): Promise<void> {\n    if (this.running) {\n      return;\n    }\n\n    // In a real implementation, this would start an HTTP/stdio server\n    // For now, we just mark as running\n    this.running = true;\n\n    console.log(\n      `[MCPToolServer] Started ${this.name}@${this.version} with ${this.tools.size} tools`\n    );\n  }\n\n  async stop(): Promise<void> {\n    if (!this.running) {\n      return;\n    }\n\n    this.running = false;\n    console.log(`[MCPToolServer] Stopped ${this.name}`);\n  }\n\n  isRunning(): boolean {\n    return this.running;\n  }\n\n  getTools(): AgentToolConfig[] {\n    return Array.from(this.tools.values()).map((t) => t.config);\n  }\n\n  async executeTool(\n    toolName: string,\n    args: Record<string, unknown>,\n    context?: ToolExecutionContext\n  ): Promise<string> {\n    const tool = this.tools.get(toolName);\n    if (!tool) {\n      throw new Error(`Tool not found: ${toolName}`);\n    }\n\n    if (!tool.handler) {\n      throw new Error(`No handler registered for tool: ${toolName}`);\n    }\n\n    const fullContext: ToolExecutionContext = {\n      agentId: context?.agentId ?? 'mcp-server',\n      sessionId: context?.sessionId ?? 'mcp-session',\n      tenantId: context?.tenantId,\n      actorId: context?.actorId,\n      metadata: context?.metadata,\n      signal: context?.signal,\n    };\n\n    return await tool.handler(args, fullContext);\n  }\n\n  /**\n   * Get MCP-compatible tool definitions.\n   */\n  getMCPToolDefinitions(): {\n    name: string;\n    description: string;\n    inputSchema: Record<string, unknown>;\n  }[] {\n    const definitions: {\n      name: string;\n      description: string;\n      inputSchema: Record<string, unknown>;\n    }[] = [];\n\n    for (const [name, tool] of this.tools) {\n      definitions.push({\n        name,\n        description: tool.config.description ?? '',\n        inputSchema: tool.config.schema ?? { type: 'object', properties: {} },\n      });\n    }\n\n    return definitions;\n  }\n\n  /**\n   * Get server info for MCP.\n   */\n  getServerInfo(): {\n    name: string;\n    version: string;\n    tools: number;\n    running: boolean;\n  } {\n    return {\n      name: this.name,\n      version: this.version,\n      tools: this.tools.size,\n      running: this.running,\n    };\n  }\n}\n\n// =============================================================================\n// Tool Consumer Implementation\n// =============================================================================\n\n/**\n * ContractSpec tool consumer for external agents.\n */\nexport class ContractSpecToolConsumer implements ToolConsumer {\n  private readonly tools: Map<\n    string,\n    { config: AgentToolConfig; handler?: ToolHandler }\n  >;\n\n  constructor(config: ToolConsumerConfig) {\n    this.tools = new Map();\n\n    // Register tools\n    for (const tool of config.tools) {\n      this.tools.set(tool.config.name, tool);\n    }\n  }\n\n  /**\n   * Create an MCP server exposing the tools.\n   */\n  createToolServer(config?: Partial<ToolServerConfig>): ToolServer {\n    return new MCPToolServer({\n      tools: Array.from(this.tools.values()),\n      ...config,\n    });\n  }\n\n  /**\n   * Export tools for a specific SDK format.\n   */\n  exportToolsForSDK(format: ToolExportFormat): unknown[] {\n    const tools = Array.from(this.tools.values());\n    const defaultContext: Partial<ToolExecutionContext> = {\n      agentId: 'export',\n      sessionId: 'export',\n    };\n\n    switch (format) {\n      case 'claude-agent':\n        return tools\n          .filter(\n            (\n              tool\n            ): tool is typeof tool & {\n              handler: NonNullable<typeof tool.handler>;\n            } => !!tool.handler\n          )\n          .map((tool) =>\n            specToolToClaudeAgentTool(tool.config, tool.handler, defaultContext)\n          );\n\n      case 'opencode':\n        return tools.map((tool) => specToolToOpenCodeTool(tool.config));\n\n      case 'mcp':\n        return tools.map((tool) => ({\n          name: tool.config.name,\n          description: tool.config.description ?? '',\n          inputSchema: tool.config.schema ?? { type: 'object', properties: {} },\n        }));\n\n      case 'openai':\n        return tools.map((tool) => ({\n          type: 'function',\n          function: {\n            name: tool.config.name,\n            description: tool.config.description ?? '',\n            parameters: tool.config.schema ?? {\n              type: 'object',\n              properties: {},\n            },\n          },\n        }));\n\n      default:\n        throw new Error(`Unknown export format: ${format}`);\n    }\n  }\n\n  /**\n   * Create a bridged handler for a specific SDK.\n   */\n  createBridgedHandler(\n    toolName: string,\n    _format: ToolExportFormat\n  ): ((args: Record<string, unknown>) => Promise<unknown>) | undefined {\n    const tool = this.tools.get(toolName);\n    if (!tool || !tool.handler) {\n      return undefined;\n    }\n\n    const handler = tool.handler;\n\n    // Return a simple wrapper that works for any format\n    return async (args: Record<string, unknown>) => {\n      const context: ToolExecutionContext = {\n        agentId: 'bridge',\n        sessionId: 'bridge',\n      };\n      // ToolHandler returns Promise<string>, but bridge expects Promise<unknown>\n      // The types are compatible in this direction\n      return handler(args, context);\n    };\n  }\n\n  /**\n   * Get all tools.\n   */\n  getTools(): AgentToolConfig[] {\n    return Array.from(this.tools.values()).map((t) => t.config);\n  }\n\n  /**\n   * Get a specific tool.\n   */\n  getTool(name: string): AgentToolConfig | undefined {\n    return this.tools.get(name)?.config;\n  }\n\n  /**\n   * Check if a tool exists.\n   */\n  hasTool(name: string): boolean {\n    return this.tools.has(name);\n  }\n\n  /**\n   * Execute a tool.\n   */\n  async executeTool(\n    name: string,\n    args: Record<string, unknown>,\n    context?: ToolExecutionContext\n  ): Promise<string> {\n    const tool = this.tools.get(name);\n    if (!tool) {\n      throw new Error(`Tool not found: ${name}`);\n    }\n\n    if (!tool.handler) {\n      throw new Error(`No handler for tool: ${name}`);\n    }\n\n    const fullContext: ToolExecutionContext = {\n      agentId: context?.agentId ?? 'consumer',\n      sessionId: context?.sessionId ?? 'consumer-session',\n      tenantId: context?.tenantId,\n      actorId: context?.actorId,\n      metadata: context?.metadata,\n      signal: context?.signal,\n    };\n\n    return await tool.handler(args, fullContext);\n  }\n\n  /**\n   * Add a tool.\n   */\n  addTool(config: AgentToolConfig, handler?: ToolHandler): void {\n    this.tools.set(config.name, { config, handler });\n  }\n\n  /**\n   * Remove a tool.\n   */\n  removeTool(name: string): boolean {\n    return this.tools.delete(name);\n  }\n\n  /**\n   * Get tool count.\n   */\n  getToolCount(): number {\n    return this.tools.size;\n  }\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Create a new tool consumer.\n */\nexport function createToolConsumer(config: ToolConsumerConfig): ToolConsumer {\n  return new ContractSpecToolConsumer(config);\n}\n\n/**\n * Create an MCP tool server from tools.\n */\nexport function createToolServer(config: ToolServerConfig): ToolServer {\n  return new MCPToolServer(config);\n}\n\n/**\n * Export tools to a specific SDK format.\n */\nexport function exportToolsForExternalSDK(\n  tools: AgentToolConfig[],\n  format: ToolExportFormat\n): unknown[] {\n  const consumer = new ContractSpecToolConsumer({\n    tools: tools.map((config) => ({ config })),\n  });\n  return consumer.exportToolsForSDK(format);\n}\n"],"mappings":"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"}