@contractspec/lib.ai-agent 0.0.0-canary-20260113162409

package/dist/approval/workflow.js

@@ -0,0 +1,160 @@
+import { randomUUID } from "node:crypto";
+
+//#region src/approval/workflow.ts
+/**
+* In-memory approval store for development and testing.
+*/
+var InMemoryApprovalStore = class {
+	items = /* @__PURE__ */ new Map();
+	async create(request) {
+		this.items.set(request.id, request);
+	}
+	async get(id) {
+		return this.items.get(id) ?? null;
+	}
+	async getByToolCallId(toolCallId) {
+		for (const request of this.items.values()) if (request.toolCallId === toolCallId) return request;
+		return null;
+	}
+	async update(id, updates) {
+		const existing = this.items.get(id);
+		if (existing) this.items.set(id, {
+			...existing,
+			...updates
+		});
+	}
+	async list(options) {
+		let results = [...this.items.values()];
+		if (options?.status) results = results.filter((r) => r.status === options.status);
+		if (options?.agentId) results = results.filter((r) => r.agentId === options.agentId);
+		if (options?.tenantId) results = results.filter((r) => r.tenantId === options.tenantId);
+		return results.sort((a, b) => b.requestedAt.getTime() - a.requestedAt.getTime());
+	}
+	clear() {
+		this.items.clear();
+	}
+};
+/**
+* Approval workflow for managing tool execution approvals.
+*
+* Integrates with AI SDK v6's `needsApproval` feature on tools.
+*
+* @example
+* ```typescript
+* const workflow = new ApprovalWorkflow();
+*
+* // When a tool needs approval
+* const request = await workflow.requestApproval({
+*   sessionId: 'sess_123',
+*   agentId: 'support.bot.v1',
+*   toolName: 'delete_account',
+*   toolCallId: 'call_abc',
+*   toolArgs: { userId: 'user_123' },
+*   reason: 'Account deletion requires human approval',
+* });
+*
+* // When approval is granted
+* await workflow.approve(request.id, 'admin@example.com', 'Verified identity');
+*
+* // Or rejected
+* await workflow.reject(request.id, 'admin@example.com', 'Suspicious activity');
+* ```
+*/
+var ApprovalWorkflow = class {
+	constructor(store = new InMemoryApprovalStore()) {
+		this.store = store;
+	}
+	/**
+	* Request approval for a tool execution.
+	*/
+	async requestApproval(params) {
+		const request = {
+			id: randomUUID(),
+			sessionId: params.sessionId,
+			agentId: params.agentId,
+			tenantId: params.tenantId,
+			toolName: params.toolName,
+			toolCallId: params.toolCallId,
+			toolArgs: params.toolArgs,
+			reason: params.reason,
+			requestedAt: /* @__PURE__ */ new Date(),
+			status: "pending",
+			payload: params.payload
+		};
+		await this.store.create(request);
+		return request;
+	}
+	/**
+	* Request approval from an AI SDK tool call.
+	*/
+	async requestApprovalFromToolCall(toolCall, context) {
+		return this.requestApproval({
+			sessionId: context.sessionId,
+			agentId: context.agentId,
+			tenantId: context.tenantId,
+			toolName: toolCall.toolName,
+			toolCallId: toolCall.toolCallId,
+			toolArgs: toolCall.args,
+			reason: context.reason ?? `Tool "${toolCall.toolName}" requires approval`
+		});
+	}
+	/**
+	* Approve a pending request.
+	*/
+	async approve(id, reviewer, notes) {
+		await this.store.update(id, {
+			status: "approved",
+			reviewer,
+			resolvedAt: /* @__PURE__ */ new Date(),
+			notes
+		});
+	}
+	/**
+	* Reject a pending request.
+	*/
+	async reject(id, reviewer, notes) {
+		await this.store.update(id, {
+			status: "rejected",
+			reviewer,
+			resolvedAt: /* @__PURE__ */ new Date(),
+			notes
+		});
+	}
+	/**
+	* Get approval status for a tool call.
+	*/
+	async getStatus(toolCallId) {
+		return (await this.store.getByToolCallId(toolCallId))?.status ?? null;
+	}
+	/**
+	* Check if a tool call is approved.
+	*/
+	async isApproved(toolCallId) {
+		return await this.getStatus(toolCallId) === "approved";
+	}
+	/**
+	* List pending approvals.
+	*/
+	async listPending(options) {
+		return this.store.list({
+			...options,
+			status: "pending"
+		});
+	}
+	/**
+	* Get approval request by ID.
+	*/
+	async get(id) {
+		return this.store.get(id);
+	}
+};
+/**
+* Create an approval workflow instance.
+*/
+function createApprovalWorkflow(store) {
+	return new ApprovalWorkflow(store);
+}
+
+//#endregion
+export { ApprovalWorkflow, InMemoryApprovalStore, createApprovalWorkflow };
+//# sourceMappingURL=workflow.js.map

package/dist/approval/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","names":[],"sources":["../../src/approval/workflow.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { ToolCallInfo } from '../types';\n\nexport type ApprovalStatus = 'pending' | 'approved' | 'rejected';\n\n/**\n * Approval request for a tool execution.\n *\n * When a tool has `needsApproval: true` in AI SDK v6, the agent\n * will pause and wait for approval before executing the tool.\n */\nexport interface ApprovalRequest {\n  /** Unique request ID */\n  id: string;\n  /** Agent session ID */\n  sessionId: string;\n  /** Agent ID */\n  agentId: string;\n  /** Tenant ID for scoping */\n  tenantId?: string;\n  /** Tool name requiring approval */\n  toolName: string;\n  /** Tool call ID from AI SDK */\n  toolCallId: string;\n  /** Tool arguments */\n  toolArgs: unknown;\n  /** Human-readable reason for approval */\n  reason: string;\n  /** When the approval was requested */\n  requestedAt: Date;\n  /** Current status */\n  status: ApprovalStatus;\n  /** Additional context payload */\n  payload?: Record<string, unknown>;\n  /** Who resolved the approval */\n  reviewer?: string;\n  /** When the approval was resolved */\n  resolvedAt?: Date;\n  /** Reviewer notes */\n  notes?: string;\n}\n\n/**\n * Storage interface for approval requests.\n */\nexport interface ApprovalStore {\n  create(request: ApprovalRequest): Promise<void>;\n  get(id: string): Promise<ApprovalRequest | null>;\n  getByToolCallId(toolCallId: string): Promise<ApprovalRequest | null>;\n  update(\n    id: string,\n    updates: Partial<Omit<ApprovalRequest, 'id' | 'sessionId'>>\n  ): Promise<void>;\n  list(options?: {\n    status?: ApprovalStatus;\n    agentId?: string;\n    tenantId?: string;\n  }): Promise<ApprovalRequest[]>;\n}\n\n/**\n * In-memory approval store for development and testing.\n */\nexport class InMemoryApprovalStore implements ApprovalStore {\n  private readonly items = new Map<string, ApprovalRequest>();\n\n  async create(request: ApprovalRequest): Promise<void> {\n    this.items.set(request.id, request);\n  }\n\n  async get(id: string): Promise<ApprovalRequest | null> {\n    return this.items.get(id) ?? null;\n  }\n\n  async getByToolCallId(toolCallId: string): Promise<ApprovalRequest | null> {\n    for (const request of this.items.values()) {\n      if (request.toolCallId === toolCallId) {\n        return request;\n      }\n    }\n    return null;\n  }\n\n  async update(\n    id: string,\n    updates: Partial<Omit<ApprovalRequest, 'id' | 'sessionId'>>\n  ): Promise<void> {\n    const existing = this.items.get(id);\n    if (existing) {\n      this.items.set(id, { ...existing, ...updates });\n    }\n  }\n\n  async list(options?: {\n    status?: ApprovalStatus;\n    agentId?: string;\n    tenantId?: string;\n  }): Promise<ApprovalRequest[]> {\n    let results = [...this.items.values()];\n\n    if (options?.status) {\n      results = results.filter((r) => r.status === options.status);\n    }\n    if (options?.agentId) {\n      results = results.filter((r) => r.agentId === options.agentId);\n    }\n    if (options?.tenantId) {\n      results = results.filter((r) => r.tenantId === options.tenantId);\n    }\n\n    return results.sort(\n      (a, b) => b.requestedAt.getTime() - a.requestedAt.getTime()\n    );\n  }\n\n  clear(): void {\n    this.items.clear();\n  }\n}\n\n/**\n * Approval workflow for managing tool execution approvals.\n *\n * Integrates with AI SDK v6's `needsApproval` feature on tools.\n *\n * @example\n * ```typescript\n * const workflow = new ApprovalWorkflow();\n *\n * // When a tool needs approval\n * const request = await workflow.requestApproval({\n *   sessionId: 'sess_123',\n *   agentId: 'support.bot.v1',\n *   toolName: 'delete_account',\n *   toolCallId: 'call_abc',\n *   toolArgs: { userId: 'user_123' },\n *   reason: 'Account deletion requires human approval',\n * });\n *\n * // When approval is granted\n * await workflow.approve(request.id, 'admin@example.com', 'Verified identity');\n *\n * // Or rejected\n * await workflow.reject(request.id, 'admin@example.com', 'Suspicious activity');\n * ```\n */\nexport class ApprovalWorkflow {\n  constructor(\n    private readonly store: ApprovalStore = new InMemoryApprovalStore()\n  ) {}\n\n  /**\n   * Request approval for a tool execution.\n   */\n  async requestApproval(params: {\n    sessionId: string;\n    agentId: string;\n    tenantId?: string;\n    toolName: string;\n    toolCallId: string;\n    toolArgs: unknown;\n    reason: string;\n    payload?: Record<string, unknown>;\n  }): Promise<ApprovalRequest> {\n    const request: ApprovalRequest = {\n      id: randomUUID(),\n      sessionId: params.sessionId,\n      agentId: params.agentId,\n      tenantId: params.tenantId,\n      toolName: params.toolName,\n      toolCallId: params.toolCallId,\n      toolArgs: params.toolArgs,\n      reason: params.reason,\n      requestedAt: new Date(),\n      status: 'pending',\n      payload: params.payload,\n    };\n\n    await this.store.create(request);\n    return request;\n  }\n\n  /**\n   * Request approval from an AI SDK tool call.\n   */\n  async requestApprovalFromToolCall(\n    toolCall: ToolCallInfo,\n    context: {\n      sessionId: string;\n      agentId: string;\n      tenantId?: string;\n      reason?: string;\n    }\n  ): Promise<ApprovalRequest> {\n    return this.requestApproval({\n      sessionId: context.sessionId,\n      agentId: context.agentId,\n      tenantId: context.tenantId,\n      toolName: toolCall.toolName,\n      toolCallId: toolCall.toolCallId,\n      toolArgs: toolCall.args,\n      reason: context.reason ?? `Tool \"${toolCall.toolName}\" requires approval`,\n    });\n  }\n\n  /**\n   * Approve a pending request.\n   */\n  async approve(id: string, reviewer: string, notes?: string): Promise<void> {\n    await this.store.update(id, {\n      status: 'approved',\n      reviewer,\n      resolvedAt: new Date(),\n      notes,\n    });\n  }\n\n  /**\n   * Reject a pending request.\n   */\n  async reject(id: string, reviewer: string, notes?: string): Promise<void> {\n    await this.store.update(id, {\n      status: 'rejected',\n      reviewer,\n      resolvedAt: new Date(),\n      notes,\n    });\n  }\n\n  /**\n   * Get approval status for a tool call.\n   */\n  async getStatus(toolCallId: string): Promise<ApprovalStatus | null> {\n    const request = await this.store.getByToolCallId(toolCallId);\n    return request?.status ?? null;\n  }\n\n  /**\n   * Check if a tool call is approved.\n   */\n  async isApproved(toolCallId: string): Promise<boolean> {\n    const status = await this.getStatus(toolCallId);\n    return status === 'approved';\n  }\n\n  /**\n   * List pending approvals.\n   */\n  async listPending(options?: {\n    agentId?: string;\n    tenantId?: string;\n  }): Promise<ApprovalRequest[]> {\n    return this.store.list({ ...options, status: 'pending' });\n  }\n\n  /**\n   * Get approval request by ID.\n   */\n  async get(id: string): Promise<ApprovalRequest | null> {\n    return this.store.get(id);\n  }\n}\n\n/**\n * Create an approval workflow instance.\n */\nexport function createApprovalWorkflow(\n  store?: ApprovalStore\n): ApprovalWorkflow {\n  return new ApprovalWorkflow(store);\n}\n"],"mappings":";;;;;;AA+DA,IAAa,wBAAb,MAA4D;CAC1D,AAAiB,wBAAQ,IAAI,KAA8B;CAE3D,MAAM,OAAO,SAAyC;AACpD,OAAK,MAAM,IAAI,QAAQ,IAAI,QAAQ;;CAGrC,MAAM,IAAI,IAA6C;AACrD,SAAO,KAAK,MAAM,IAAI,GAAG,IAAI;;CAG/B,MAAM,gBAAgB,YAAqD;AACzE,OAAK,MAAM,WAAW,KAAK,MAAM,QAAQ,CACvC,KAAI,QAAQ,eAAe,WACzB,QAAO;AAGX,SAAO;;CAGT,MAAM,OACJ,IACA,SACe;EACf,MAAM,WAAW,KAAK,MAAM,IAAI,GAAG;AACnC,MAAI,SACF,MAAK,MAAM,IAAI,IAAI;GAAE,GAAG;GAAU,GAAG;GAAS,CAAC;;CAInD,MAAM,KAAK,SAIoB;EAC7B,IAAI,UAAU,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC;AAEtC,MAAI,SAAS,OACX,WAAU,QAAQ,QAAQ,MAAM,EAAE,WAAW,QAAQ,OAAO;AAE9D,MAAI,SAAS,QACX,WAAU,QAAQ,QAAQ,MAAM,EAAE,YAAY,QAAQ,QAAQ;AAEhE,MAAI,SAAS,SACX,WAAU,QAAQ,QAAQ,MAAM,EAAE,aAAa,QAAQ,SAAS;AAGlE,SAAO,QAAQ,MACZ,GAAG,MAAM,EAAE,YAAY,SAAS,GAAG,EAAE,YAAY,SAAS,CAC5D;;CAGH,QAAc;AACZ,OAAK,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BtB,IAAa,mBAAb,MAA8B;CAC5B,YACE,AAAiB,QAAuB,IAAI,uBAAuB,EACnE;EADiB;;;;;CAMnB,MAAM,gBAAgB,QASO;EAC3B,MAAM,UAA2B;GAC/B,IAAI,YAAY;GAChB,WAAW,OAAO;GAClB,SAAS,OAAO;GAChB,UAAU,OAAO;GACjB,UAAU,OAAO;GACjB,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,QAAQ,OAAO;GACf,6BAAa,IAAI,MAAM;GACvB,QAAQ;GACR,SAAS,OAAO;GACjB;AAED,QAAM,KAAK,MAAM,OAAO,QAAQ;AAChC,SAAO;;;;;CAMT,MAAM,4BACJ,UACA,SAM0B;AAC1B,SAAO,KAAK,gBAAgB;GAC1B,WAAW,QAAQ;GACnB,SAAS,QAAQ;GACjB,UAAU,QAAQ;GAClB,UAAU,SAAS;GACnB,YAAY,SAAS;GACrB,UAAU,SAAS;GACnB,QAAQ,QAAQ,UAAU,SAAS,SAAS,SAAS;GACtD,CAAC;;;;;CAMJ,MAAM,QAAQ,IAAY,UAAkB,OAA+B;AACzE,QAAM,KAAK,MAAM,OAAO,IAAI;GAC1B,QAAQ;GACR;GACA,4BAAY,IAAI,MAAM;GACtB;GACD,CAAC;;;;;CAMJ,MAAM,OAAO,IAAY,UAAkB,OAA+B;AACxE,QAAM,KAAK,MAAM,OAAO,IAAI;GAC1B,QAAQ;GACR;GACA,4BAAY,IAAI,MAAM;GACtB;GACD,CAAC;;;;;CAMJ,MAAM,UAAU,YAAoD;AAElE,UADgB,MAAM,KAAK,MAAM,gBAAgB,WAAW,GAC5C,UAAU;;;;;CAM5B,MAAM,WAAW,YAAsC;AAErD,SADe,MAAM,KAAK,UAAU,WAAW,KAC7B;;;;;CAMpB,MAAM,YAAY,SAGa;AAC7B,SAAO,KAAK,MAAM,KAAK;GAAE,GAAG;GAAS,QAAQ;GAAW,CAAC;;;;;CAM3D,MAAM,IAAI,IAA6C;AACrD,SAAO,KAAK,MAAM,IAAI,GAAG;;;;;;AAO7B,SAAgB,uBACd,OACkB;AAClB,QAAO,IAAI,iBAAiB,MAAM"}

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

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

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

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

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

@@ -0,0 +1,210 @@
+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");
+	}
+};
+/**
+* Export an AgentSpec to Claude Agent SDK format.
+*/
+function exportToClaudeAgent(spec, options) {
+	return new ClaudeAgentExporter().export(spec, options);
+}
+/**
+* Generate CLAUDE.md content from an AgentSpec.
+*/
+function generateClaudeMd(spec, options) {
+	return new ClaudeAgentExporter().export(spec, {
+		...options,
+		generateClaudeMd: true
+	}).claudeMd ?? "";
+}
+/**
+* Validate an AgentSpec for Claude Agent SDK export.
+*/
+function validateForClaudeAgent(spec) {
+	return new ClaudeAgentExporter().validate(spec);
+}
+
+//#endregion
+export { ClaudeAgentExporter, exportToClaudeAgent, generateClaudeMd, validateForClaudeAgent };
+//# sourceMappingURL=claude-agent-exporter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-agent-exporter.js","names":[],"sources":["../../src/exporters/claude-agent-exporter.ts"],"sourcesContent":["/**\n * Claude Agent SDK Exporter\n *\n * Exports ContractSpec AgentSpec definitions to formats compatible with\n * @anthropic-ai/claude-agent-sdk and Claude Code CLI.\n */\n\nimport type { AgentSpec } from '../spec/spec';\nimport { agentKey } from '../spec/spec';\nimport type {\n  Exporter,\n  ClaudeAgentExportOptions,\n  ClaudeAgentExportResult,\n  ClaudeAgentConfig,\n  ClaudeToolDefinition,\n} from './types';\n\n// ============================================================================\n// Exporter Implementation\n// ============================================================================\n\n/**\n * Claude Agent SDK Exporter.\n */\nexport class ClaudeAgentExporter implements Exporter<\n  ClaudeAgentExportOptions,\n  ClaudeAgentExportResult\n> {\n  readonly format = 'claude-agent' as const;\n\n  /**\n   * Export an AgentSpec to Claude Agent SDK format.\n   */\n  export(\n    spec: AgentSpec,\n    options: ClaudeAgentExportOptions = {}\n  ): ClaudeAgentExportResult {\n    const tools = this.exportTools(spec);\n    const config = this.buildConfig(spec, tools, options);\n    const claudeMd = options.generateClaudeMd\n      ? this.generateClaudeMd(spec, options)\n      : undefined;\n\n    return {\n      config,\n      claudeMd,\n      tools,\n      exportedAt: new Date(),\n      sourceSpec: agentKey(spec.meta),\n    };\n  }\n\n  /**\n   * Export multiple specs.\n   */\n  exportMany(\n    specs: AgentSpec[],\n    options: ClaudeAgentExportOptions = {}\n  ): ClaudeAgentExportResult[] {\n    return specs.map((spec) => this.export(spec, options));\n  }\n\n  /**\n   * Validate that a spec can be exported.\n   */\n  validate(spec: AgentSpec): { valid: boolean; errors: string[] } {\n    const errors: string[] = [];\n\n    if (!spec.meta?.key) {\n      errors.push('Spec must have a meta.key');\n    }\n\n    if (!spec.instructions) {\n      errors.push('Spec must have instructions');\n    }\n\n    if (!spec.tools || spec.tools.length === 0) {\n      errors.push('Spec must have at least one tool');\n    }\n\n    for (const tool of spec.tools ?? []) {\n      if (!tool.name) {\n        errors.push('All tools must have a name');\n      }\n      if (!tool.description && !tool.name) {\n        errors.push(`Tool must have a description or name`);\n      }\n    }\n\n    return { valid: errors.length === 0, errors };\n  }\n\n  // ============================================================================\n  // Private Methods\n  // ============================================================================\n\n  /**\n   * Build Claude Agent SDK configuration.\n   */\n  private buildConfig(\n    spec: AgentSpec,\n    tools: ClaudeToolDefinition[],\n    options: ClaudeAgentExportOptions\n  ): ClaudeAgentConfig {\n    const config: ClaudeAgentConfig = {\n      model: options.model ?? 'claude-sonnet-4-20250514',\n      system: this.buildSystemPrompt(spec, options),\n      tools,\n      max_turns: spec.maxSteps ?? 10,\n    };\n\n    if (options.computerUse) {\n      config.computer_use = true;\n    }\n\n    if (options.extendedThinking) {\n      config.extended_thinking = true;\n    }\n\n    if (options.mcpServers && options.mcpServers.length > 0) {\n      config.mcp_servers = options.mcpServers;\n    }\n\n    return config;\n  }\n\n  /**\n   * Build system prompt from spec.\n   */\n  private buildSystemPrompt(\n    spec: AgentSpec,\n    options: ClaudeAgentExportOptions\n  ): string {\n    const parts: string[] = [];\n\n    // Base instructions\n    parts.push(spec.instructions);\n\n    // Add knowledge context if available\n    if (spec.knowledge && spec.knowledge.length > 0) {\n      parts.push('');\n      parts.push('## Knowledge Sources');\n      for (const k of spec.knowledge) {\n        if (k.instructions) {\n          parts.push(`- ${k.key}: ${k.instructions}`);\n        }\n      }\n    }\n\n    // Add policy information if available\n    if (spec.policy) {\n      parts.push('');\n      parts.push('## Policy');\n      if (spec.policy.confidence?.min) {\n        parts.push(`- Minimum confidence: ${spec.policy.confidence.min}`);\n      }\n      if (spec.policy.escalation) {\n        parts.push('- Escalation policy is configured');\n      }\n    }\n\n    // Add custom metadata if provided\n    if (options.metadata) {\n      parts.push('');\n      parts.push('## Additional Context');\n      for (const [key, value] of Object.entries(options.metadata)) {\n        parts.push(`- ${key}: ${String(value)}`);\n      }\n    }\n\n    return parts.join('\\n');\n  }\n\n  /**\n   * Export tools to Claude Agent SDK format.\n   */\n  private exportTools(spec: AgentSpec): ClaudeToolDefinition[] {\n    return spec.tools.map((tool) => ({\n      name: tool.name,\n      description: tool.description ?? `Execute ${tool.name}`,\n      input_schema: this.normalizeSchema(tool.schema),\n      requires_confirmation: tool.requiresApproval ?? !tool.automationSafe,\n    }));\n  }\n\n  /**\n   * Normalize schema to Claude Agent SDK format.\n   */\n  private normalizeSchema(\n    schema?: Record<string, unknown>\n  ): ClaudeToolDefinition['input_schema'] {\n    if (!schema) {\n      return { type: 'object' };\n    }\n\n    if (schema.type === 'object') {\n      return {\n        type: 'object',\n        properties: schema.properties as Record<string, unknown> | undefined,\n        required: schema.required as string[] | undefined,\n      };\n    }\n\n    // Wrap non-object schemas\n    return {\n      type: 'object',\n      properties: { value: schema },\n      required: ['value'],\n    };\n  }\n\n  /**\n   * Generate CLAUDE.md content for Claude Code CLI integration.\n   */\n  private generateClaudeMd(\n    spec: AgentSpec,\n    options: ClaudeAgentExportOptions\n  ): string {\n    const lines: string[] = [];\n\n    // Header\n    lines.push('# Agent Configuration');\n    lines.push('');\n\n    // Description\n    if (spec.description) {\n      lines.push(`> ${spec.description}`);\n      lines.push('');\n    }\n\n    // Metadata\n    lines.push('## Metadata');\n    lines.push('');\n    lines.push(`- **Name**: ${spec.meta.key}`);\n    lines.push(`- **Version**: ${spec.meta.version}`);\n    if (spec.meta.owners && spec.meta.owners.length > 0) {\n      lines.push(`- **Owners**: ${spec.meta.owners.join(', ')}`);\n    }\n    if (options.model) {\n      lines.push(`- **Model**: ${options.model}`);\n    }\n    lines.push('');\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('## Available Tools');\n      lines.push('');\n      for (const tool of spec.tools) {\n        const flags: string[] = [];\n        if (tool.requiresApproval) {\n          flags.push('requires approval');\n        }\n        if (tool.automationSafe === false) {\n          flags.push('not automation safe');\n        }\n        const flagStr = flags.length > 0 ? ` (${flags.join(', ')})` : '';\n\n        lines.push(`### ${tool.name}${flagStr}`);\n        lines.push('');\n        if (tool.description) {\n          lines.push(tool.description);\n          lines.push('');\n        }\n        if (tool.schema) {\n          lines.push('**Parameters:**');\n          lines.push('```json');\n          lines.push(JSON.stringify(tool.schema, null, 2));\n          lines.push('```');\n          lines.push('');\n        }\n      }\n    }\n\n    // Knowledge\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        if (k.instructions) {\n          lines.push(`  - ${k.instructions}`);\n        }\n      }\n      lines.push('');\n    }\n\n    // Policy\n    if (spec.policy) {\n      lines.push('## Policy');\n      lines.push('');\n      if (spec.policy.confidence?.min) {\n        lines.push(`- Minimum confidence: ${spec.policy.confidence.min}`);\n      }\n      if (spec.policy.escalation) {\n        lines.push('- Escalation policy configured');\n      }\n      if (spec.policy.flags && spec.policy.flags.length > 0) {\n        lines.push(`- Feature flags: ${spec.policy.flags.join(', ')}`);\n      }\n      lines.push('');\n    }\n\n    // MCP Servers\n    if (options.mcpServers && options.mcpServers.length > 0) {\n      lines.push('## MCP Servers');\n      lines.push('');\n      for (const server of options.mcpServers) {\n        lines.push(\n          `- **${server.name}**: \\`${server.command}${server.args ? ' ' + server.args.join(' ') : ''}\\``\n        );\n      }\n      lines.push('');\n    }\n\n    // Footer\n    lines.push('---');\n    lines.push('');\n    lines.push(`*Generated from ContractSpec: ${agentKey(spec.meta)}*`);\n\n    return lines.join('\\n');\n  }\n}\n\n// ============================================================================\n// Convenience Functions\n// ============================================================================\n\n/**\n * Export an AgentSpec to Claude Agent SDK format.\n */\nexport function exportToClaudeAgent(\n  spec: AgentSpec,\n  options?: ClaudeAgentExportOptions\n): ClaudeAgentExportResult {\n  const exporter = new ClaudeAgentExporter();\n  return exporter.export(spec, options);\n}\n\n/**\n * Generate CLAUDE.md content from an AgentSpec.\n */\nexport function generateClaudeMd(\n  spec: AgentSpec,\n  options?: Omit<ClaudeAgentExportOptions, 'generateClaudeMd'>\n): string {\n  const exporter = new ClaudeAgentExporter();\n  const result = exporter.export(spec, { ...options, generateClaudeMd: true });\n  return result.claudeMd ?? '';\n}\n\n/**\n * Validate an AgentSpec for Claude Agent SDK export.\n */\nexport function validateForClaudeAgent(spec: AgentSpec): {\n  valid: boolean;\n  errors: string[];\n} {\n  const exporter = new ClaudeAgentExporter();\n  return exporter.validate(spec);\n}\n"],"mappings":"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"}

package/dist/exporters/index.d.ts

@@ -0,0 +1,4 @@
+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 };

package/dist/exporters/index.js

@@ -0,0 +1,4 @@
+import { ClaudeAgentExporter, exportToClaudeAgent, generateClaudeMd, validateForClaudeAgent } from "./claude-agent-exporter.js";
+import { OpenCodeExporter, exportToOpenCode, generateOpenCodeJSON, generateOpenCodeMarkdown, validateForOpenCode } from "./opencode-exporter.js";
+
+export { ClaudeAgentExporter, OpenCodeExporter, exportToClaudeAgent, exportToOpenCode, generateClaudeMd, generateOpenCodeJSON, generateOpenCodeMarkdown, validateForClaudeAgent, validateForOpenCode };

package/dist/exporters/opencode-exporter.d.ts

@@ -0,0 +1,64 @@
+import { AgentSpec } from "../spec/spec.js";
+import { Exporter, OpenCodeAgentJSON, OpenCodeExportOptions, OpenCodeExportResult } from "./types.js";
+
+//#region src/exporters/opencode-exporter.d.ts
+
+/**
+ * OpenCode SDK Exporter.
+ */
+declare class OpenCodeExporter implements Exporter<OpenCodeExportOptions, OpenCodeExportResult> {
+  readonly format: "opencode";
+  /**
+   * Export an AgentSpec to OpenCode SDK format.
+   */
+  export(spec: AgentSpec, options?: OpenCodeExportOptions): OpenCodeExportResult;
+  /**
+   * Export multiple specs.
+   */
+  exportMany(specs: AgentSpec[], options?: OpenCodeExportOptions): OpenCodeExportResult[];
+  /**
+   * Validate that a spec can be exported.
+   */
+  validate(spec: AgentSpec): {
+    valid: boolean;
+    errors: string[];
+  };
+  /**
+   * Build OpenCode agent JSON configuration.
+   */
+  private buildJsonConfig;
+  /**
+   * Export tools to OpenCode format.
+   */
+  private exportTools;
+  /**
+   * Generate markdown agent file content.
+   */
+  private generateMarkdown;
+  /**
+   * Get description for agent type.
+   */
+  private getAgentTypeDescription;
+}
+/**
+ * Export an AgentSpec to OpenCode SDK format.
+ */
+declare function exportToOpenCode(spec: AgentSpec, options?: OpenCodeExportOptions): OpenCodeExportResult;
+/**
+ * Generate OpenCode agent markdown from an AgentSpec.
+ */
+declare function generateOpenCodeMarkdown(spec: AgentSpec, options?: OpenCodeExportOptions): string;
+/**
+ * Generate OpenCode agent JSON from an AgentSpec.
+ */
+declare function generateOpenCodeJSON(spec: AgentSpec, options?: OpenCodeExportOptions): OpenCodeAgentJSON;
+/**
+ * Validate an AgentSpec for OpenCode SDK export.
+ */
+declare function validateForOpenCode(spec: AgentSpec): {
+  valid: boolean;
+  errors: string[];
+};
+//#endregion
+export { OpenCodeExporter, exportToOpenCode, generateOpenCodeJSON, generateOpenCodeMarkdown, validateForOpenCode };
+//# sourceMappingURL=opencode-exporter.d.ts.map

package/dist/exporters/opencode-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-exporter.d.ts","names":[],"sources":["../../src/exporters/opencode-exporter.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAuDa,cA7BA,gBAAA,YAA4B,QA6B5B,CA5BX,qBA4BW,EA3BX,oBA2BW,CAAA,CAAA;EACR,SAAA,MAAA,EAAA,UAAA;EAOY;;;EAgPD,MAAA,CAAA,IAAA,EA3QN,SA2QsB,EAAA,OAAA,CAAA,EA1QnB,qBA0QmB,CAAA,EAzQ3B,oBAyQ2B;EACxB;;;EAEe,UAAA,CAAA,KAAA,EA5PZ,SA4PY,EAAA,EAAA,OAAA,CAAA,EA3PV,qBA2PU,CAAA,EA1PlB,oBA0PkB,EAAA;EAQP;AAYhB;;EAEY,QAAA,CAAA,IAAA,EAzQK,SAyQL,CAAA,EAAA;IACT,KAAA,EAAA,OAAA;IAAiB,MAAA,EAAA,MAAA,EAAA;EASJ,CAAA;;;;;;;;;;;;;;;;;;;;;iBAnCA,gBAAA,OACR,qBACI,wBACT;;;;iBAQa,wBAAA,OACR,qBACI;;;;iBAUI,oBAAA,OACR,qBACI,wBACT;;;;iBASa,mBAAA,OAA0B"}