@contractspec/lib.ai-agent 1.57.0 → 1.59.0

package/dist/exporters/claude-agent-exporter.js

@@ -1,210 +1,265 @@
-import { agentKey } from "../spec/spec.js";
-
-//#region src/exporters/claude-agent-exporter.ts
-/**
-* Claude Agent SDK Exporter.
-*/
-var ClaudeAgentExporter = class {
-	format = "claude-agent";
-	/**
-	* Export an AgentSpec to Claude Agent SDK format.
-	*/
-	export(spec, options = {}) {
-		const tools = this.exportTools(spec);
-		return {
-			config: this.buildConfig(spec, tools, options),
-			claudeMd: options.generateClaudeMd ? this.generateClaudeMd(spec, options) : void 0,
-			tools,
-			exportedAt: /* @__PURE__ */ new Date(),
-			sourceSpec: agentKey(spec.meta)
-		};
-	}
-	/**
-	* Export multiple specs.
-	*/
-	exportMany(specs, options = {}) {
-		return specs.map((spec) => this.export(spec, options));
-	}
-	/**
-	* Validate that a spec can be exported.
-	*/
-	validate(spec) {
-		const errors = [];
-		if (!spec.meta?.key) errors.push("Spec must have a meta.key");
-		if (!spec.instructions) errors.push("Spec must have instructions");
-		if (!spec.tools || spec.tools.length === 0) errors.push("Spec must have at least one tool");
-		for (const tool of spec.tools ?? []) {
-			if (!tool.name) errors.push("All tools must have a name");
-			if (!tool.description && !tool.name) errors.push(`Tool must have a description or name`);
-		}
-		return {
-			valid: errors.length === 0,
-			errors
-		};
-	}
-	/**
-	* Build Claude Agent SDK configuration.
-	*/
-	buildConfig(spec, tools, options) {
-		const config = {
-			model: options.model ?? "claude-sonnet-4-20250514",
-			system: this.buildSystemPrompt(spec, options),
-			tools,
-			max_turns: spec.maxSteps ?? 10
-		};
-		if (options.computerUse) config.computer_use = true;
-		if (options.extendedThinking) config.extended_thinking = true;
-		if (options.mcpServers && options.mcpServers.length > 0) config.mcp_servers = options.mcpServers;
-		return config;
-	}
-	/**
-	* Build system prompt from spec.
-	*/
-	buildSystemPrompt(spec, options) {
-		const parts = [];
-		parts.push(spec.instructions);
-		if (spec.knowledge && spec.knowledge.length > 0) {
-			parts.push("");
-			parts.push("## Knowledge Sources");
-			for (const k of spec.knowledge) if (k.instructions) parts.push(`- ${k.key}: ${k.instructions}`);
-		}
-		if (spec.policy) {
-			parts.push("");
-			parts.push("## Policy");
-			if (spec.policy.confidence?.min) parts.push(`- Minimum confidence: ${spec.policy.confidence.min}`);
-			if (spec.policy.escalation) parts.push("- Escalation policy is configured");
-		}
-		if (options.metadata) {
-			parts.push("");
-			parts.push("## Additional Context");
-			for (const [key, value] of Object.entries(options.metadata)) parts.push(`- ${key}: ${String(value)}`);
-		}
-		return parts.join("\n");
-	}
-	/**
-	* Export tools to Claude Agent SDK format.
-	*/
-	exportTools(spec) {
-		return spec.tools.map((tool) => ({
-			name: tool.name,
-			description: tool.description ?? `Execute ${tool.name}`,
-			input_schema: this.normalizeSchema(tool.schema),
-			requires_confirmation: tool.requiresApproval ?? !tool.automationSafe
-		}));
-	}
-	/**
-	* Normalize schema to Claude Agent SDK format.
-	*/
-	normalizeSchema(schema) {
-		if (!schema) return { type: "object" };
-		if (schema.type === "object") return {
-			type: "object",
-			properties: schema.properties,
-			required: schema.required
-		};
-		return {
-			type: "object",
-			properties: { value: schema },
-			required: ["value"]
-		};
-	}
-	/**
-	* Generate CLAUDE.md content for Claude Code CLI integration.
-	*/
-	generateClaudeMd(spec, options) {
-		const lines = [];
-		lines.push("# Agent Configuration");
-		lines.push("");
-		if (spec.description) {
-			lines.push(`> ${spec.description}`);
-			lines.push("");
-		}
-		lines.push("## Metadata");
-		lines.push("");
-		lines.push(`- **Name**: ${spec.meta.key}`);
-		lines.push(`- **Version**: ${spec.meta.version}`);
-		if (spec.meta.owners && spec.meta.owners.length > 0) lines.push(`- **Owners**: ${spec.meta.owners.join(", ")}`);
-		if (options.model) lines.push(`- **Model**: ${options.model}`);
-		lines.push("");
-		lines.push("## Instructions");
-		lines.push("");
-		lines.push(spec.instructions);
-		lines.push("");
-		if (spec.tools.length > 0) {
-			lines.push("## Available Tools");
-			lines.push("");
-			for (const tool of spec.tools) {
-				const flags = [];
-				if (tool.requiresApproval) flags.push("requires approval");
-				if (tool.automationSafe === false) flags.push("not automation safe");
-				const flagStr = flags.length > 0 ? ` (${flags.join(", ")})` : "";
-				lines.push(`### ${tool.name}${flagStr}`);
-				lines.push("");
-				if (tool.description) {
-					lines.push(tool.description);
-					lines.push("");
-				}
-				if (tool.schema) {
-					lines.push("**Parameters:**");
-					lines.push("```json");
-					lines.push(JSON.stringify(tool.schema, null, 2));
-					lines.push("```");
-					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}`);
-				if (k.instructions) lines.push(`  - ${k.instructions}`);
-			}
-			lines.push("");
-		}
-		if (spec.policy) {
-			lines.push("## Policy");
-			lines.push("");
-			if (spec.policy.confidence?.min) lines.push(`- Minimum confidence: ${spec.policy.confidence.min}`);
-			if (spec.policy.escalation) lines.push("- Escalation policy configured");
-			if (spec.policy.flags && spec.policy.flags.length > 0) lines.push(`- Feature flags: ${spec.policy.flags.join(", ")}`);
-			lines.push("");
-		}
-		if (options.mcpServers && options.mcpServers.length > 0) {
-			lines.push("## MCP Servers");
-			lines.push("");
-			for (const server of options.mcpServers) lines.push(`- **${server.name}**: \`${server.command}${server.args ? " " + server.args.join(" ") : ""}\``);
-			lines.push("");
-		}
-		lines.push("---");
-		lines.push("");
-		lines.push(`*Generated from ContractSpec: ${agentKey(spec.meta)}*`);
-		return lines.join("\n");
-	}
+// @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
 };
-/**
-* Export an AgentSpec to Claude Agent SDK format.
-*/
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/spec/spec.ts
+function defineAgent(spec) {
+  if (!spec.meta?.key) {
+    throw new Error("Agent key is required");
+  }
+  if (typeof spec.meta.version !== "string") {
+    throw new Error(`Agent ${spec.meta.key} is missing a string version`);
+  }
+  if (!spec.instructions?.trim()) {
+    throw new Error(`Agent ${spec.meta.key} requires instructions`);
+  }
+  if (!spec.tools?.length) {
+    throw new Error(`Agent ${spec.meta.key} must expose at least one tool`);
+  }
+  const toolNames = new Set;
+  for (const tool of spec.tools) {
+    if (toolNames.has(tool.name)) {
+      throw new Error(`Agent ${spec.meta.key} has duplicate tool name: ${tool.name}`);
+    }
+    toolNames.add(tool.name);
+  }
+  return Object.freeze(spec);
+}
+function agentKey(meta) {
+  return `${meta.key}.v${meta.version}`;
+}
+
+// src/exporters/claude-agent-exporter.ts
+class ClaudeAgentExporter {
+  format = "claude-agent";
+  export(spec, options = {}) {
+    const tools = this.exportTools(spec);
+    const config = this.buildConfig(spec, tools, options);
+    const claudeMd = options.generateClaudeMd ? this.generateClaudeMd(spec, options) : undefined;
+    return {
+      config,
+      claudeMd,
+      tools,
+      exportedAt: new Date,
+      sourceSpec: agentKey(spec.meta)
+    };
+  }
+  exportMany(specs, options = {}) {
+    return specs.map((spec) => this.export(spec, options));
+  }
+  validate(spec) {
+    const errors = [];
+    if (!spec.meta?.key) {
+      errors.push("Spec must have a meta.key");
+    }
+    if (!spec.instructions) {
+      errors.push("Spec must have instructions");
+    }
+    if (!spec.tools || spec.tools.length === 0) {
+      errors.push("Spec must have at least one tool");
+    }
+    for (const tool of spec.tools ?? []) {
+      if (!tool.name) {
+        errors.push("All tools must have a name");
+      }
+      if (!tool.description && !tool.name) {
+        errors.push(`Tool must have a description or name`);
+      }
+    }
+    return { valid: errors.length === 0, errors };
+  }
+  buildConfig(spec, tools, options) {
+    const config = {
+      model: options.model ?? "claude-sonnet-4-20250514",
+      system: this.buildSystemPrompt(spec, options),
+      tools,
+      max_turns: spec.maxSteps ?? 10
+    };
+    if (options.computerUse) {
+      config.computer_use = true;
+    }
+    if (options.extendedThinking) {
+      config.extended_thinking = true;
+    }
+    if (options.mcpServers && options.mcpServers.length > 0) {
+      config.mcp_servers = options.mcpServers;
+    }
+    return config;
+  }
+  buildSystemPrompt(spec, options) {
+    const parts = [];
+    parts.push(spec.instructions);
+    if (spec.knowledge && spec.knowledge.length > 0) {
+      parts.push("");
+      parts.push("## Knowledge Sources");
+      for (const k of spec.knowledge) {
+        if (k.instructions) {
+          parts.push(`- ${k.key}: ${k.instructions}`);
+        }
+      }
+    }
+    if (spec.policy) {
+      parts.push("");
+      parts.push("## Policy");
+      if (spec.policy.confidence?.min) {
+        parts.push(`- Minimum confidence: ${spec.policy.confidence.min}`);
+      }
+      if (spec.policy.escalation) {
+        parts.push("- Escalation policy is configured");
+      }
+    }
+    if (options.metadata) {
+      parts.push("");
+      parts.push("## Additional Context");
+      for (const [key, value] of Object.entries(options.metadata)) {
+        parts.push(`- ${key}: ${String(value)}`);
+      }
+    }
+    return parts.join(`
+`);
+  }
+  exportTools(spec) {
+    return spec.tools.map((tool) => ({
+      name: tool.name,
+      description: tool.description ?? `Execute ${tool.name}`,
+      input_schema: this.normalizeSchema(tool.schema),
+      requires_confirmation: tool.requiresApproval ?? !tool.automationSafe
+    }));
+  }
+  normalizeSchema(schema) {
+    if (!schema) {
+      return { type: "object" };
+    }
+    if (schema.type === "object") {
+      return {
+        type: "object",
+        properties: schema.properties,
+        required: schema.required
+      };
+    }
+    return {
+      type: "object",
+      properties: { value: schema },
+      required: ["value"]
+    };
+  }
+  generateClaudeMd(spec, options) {
+    const lines = [];
+    lines.push("# Agent Configuration");
+    lines.push("");
+    if (spec.description) {
+      lines.push(`> ${spec.description}`);
+      lines.push("");
+    }
+    lines.push("## Metadata");
+    lines.push("");
+    lines.push(`- **Name**: ${spec.meta.key}`);
+    lines.push(`- **Version**: ${spec.meta.version}`);
+    if (spec.meta.owners && spec.meta.owners.length > 0) {
+      lines.push(`- **Owners**: ${spec.meta.owners.join(", ")}`);
+    }
+    if (options.model) {
+      lines.push(`- **Model**: ${options.model}`);
+    }
+    lines.push("");
+    lines.push("## Instructions");
+    lines.push("");
+    lines.push(spec.instructions);
+    lines.push("");
+    if (spec.tools.length > 0) {
+      lines.push("## Available Tools");
+      lines.push("");
+      for (const tool of spec.tools) {
+        const flags = [];
+        if (tool.requiresApproval) {
+          flags.push("requires approval");
+        }
+        if (tool.automationSafe === false) {
+          flags.push("not automation safe");
+        }
+        const flagStr = flags.length > 0 ? ` (${flags.join(", ")})` : "";
+        lines.push(`### ${tool.name}${flagStr}`);
+        lines.push("");
+        if (tool.description) {
+          lines.push(tool.description);
+          lines.push("");
+        }
+        if (tool.schema) {
+          lines.push("**Parameters:**");
+          lines.push("```json");
+          lines.push(JSON.stringify(tool.schema, null, 2));
+          lines.push("```");
+          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}`);
+        if (k.instructions) {
+          lines.push(`  - ${k.instructions}`);
+        }
+      }
+      lines.push("");
+    }
+    if (spec.policy) {
+      lines.push("## Policy");
+      lines.push("");
+      if (spec.policy.confidence?.min) {
+        lines.push(`- Minimum confidence: ${spec.policy.confidence.min}`);
+      }
+      if (spec.policy.escalation) {
+        lines.push("- Escalation policy configured");
+      }
+      if (spec.policy.flags && spec.policy.flags.length > 0) {
+        lines.push(`- Feature flags: ${spec.policy.flags.join(", ")}`);
+      }
+      lines.push("");
+    }
+    if (options.mcpServers && options.mcpServers.length > 0) {
+      lines.push("## MCP Servers");
+      lines.push("");
+      for (const server of options.mcpServers) {
+        lines.push(`- **${server.name}**: \`${server.command}${server.args ? " " + server.args.join(" ") : ""}\``);
+      }
+      lines.push("");
+    }
+    lines.push("---");
+    lines.push("");
+    lines.push(`*Generated from ContractSpec: ${agentKey(spec.meta)}*`);
+    return lines.join(`
+`);
+  }
+}
 function exportToClaudeAgent(spec, options) {
-	return new ClaudeAgentExporter().export(spec, options);
+  const exporter = new ClaudeAgentExporter;
+  return exporter.export(spec, options);
 }
-/**
-* Generate CLAUDE.md content from an AgentSpec.
-*/
 function generateClaudeMd(spec, options) {
-	return new ClaudeAgentExporter().export(spec, {
-		...options,
-		generateClaudeMd: true
-	}).claudeMd ?? "";
+  const exporter = new ClaudeAgentExporter;
+  const result = exporter.export(spec, { ...options, generateClaudeMd: true });
+  return result.claudeMd ?? "";
 }
-/**
-* Validate an AgentSpec for Claude Agent SDK export.
-*/
 function validateForClaudeAgent(spec) {
-	return new ClaudeAgentExporter().validate(spec);
+  const exporter = new ClaudeAgentExporter;
+  return exporter.validate(spec);
 }
-
-//#endregion
-export { ClaudeAgentExporter, exportToClaudeAgent, generateClaudeMd, validateForClaudeAgent };
-//# sourceMappingURL=claude-agent-exporter.js.map
+export {
+  validateForClaudeAgent,
+  generateClaudeMd,
+  exportToClaudeAgent,
+  ClaudeAgentExporter
+};

package/dist/exporters/index.d.ts

@@ -1,4 +1,28 @@
-import { ClaudeAgentConfig, ClaudeAgentExportOptions, ClaudeAgentExportResult, ClaudeToolDefinition, ExportFormat, ExportOptions, Exporter, MCPExportOptions, MCPExportResult, MCPPromptDefinition, MCPResourceDefinition, MCPServerDefinition, MCPToolDefinition, OpenCodeAgentJSON, OpenCodeExportOptions, OpenCodeExportResult, OpenCodeToolJSON } from "./types.js";
-import { ClaudeAgentExporter, exportToClaudeAgent, generateClaudeMd, validateForClaudeAgent } from "./claude-agent-exporter.js";
-import { OpenCodeExporter, exportToOpenCode, generateOpenCodeJSON, generateOpenCodeMarkdown, validateForOpenCode } from "./opencode-exporter.js";
-export { ClaudeAgentConfig, ClaudeAgentExportOptions, ClaudeAgentExportResult, ClaudeAgentExporter, ClaudeToolDefinition, ExportFormat, ExportOptions, Exporter, MCPExportOptions, MCPExportResult, MCPPromptDefinition, MCPResourceDefinition, MCPServerDefinition, MCPToolDefinition, OpenCodeAgentJSON, OpenCodeExportOptions, OpenCodeExportResult, OpenCodeExporter, OpenCodeToolJSON, exportToClaudeAgent, exportToOpenCode, generateClaudeMd, generateOpenCodeJSON, generateOpenCodeMarkdown, validateForClaudeAgent, validateForOpenCode };
+/**
+ * Spec exporters for ContractSpec agents.
+ *
+ * Exporters convert ContractSpec AgentSpec definitions into formats
+ * compatible with external agent SDKs.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   exportToClaudeAgent,
+ *   exportToOpenCode,
+ * } from '@contractspec/lib.ai-agent/exporters';
+ *
+ * // Export to Claude Agent SDK format
+ * const claudeResult = exportToClaudeAgent(agentSpec, {
+ *   generateClaudeMd: true,
+ * });
+ *
+ * // Export to OpenCode SDK format
+ * const openCodeResult = exportToOpenCode(agentSpec, {
+ *   agentType: 'build',
+ * });
+ * ```
+ */
+export * from './types';
+export { ClaudeAgentExporter, exportToClaudeAgent, generateClaudeMd, validateForClaudeAgent, } from './claude-agent-exporter';
+export { OpenCodeExporter, exportToOpenCode, generateOpenCodeMarkdown, generateOpenCodeJSON, validateForOpenCode, } from './opencode-exporter';
+//# sourceMappingURL=index.d.ts.map

package/dist/exporters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exporters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}