@contractspec/bundle.workspace 1.46.1 → 1.47.0

package/dist/ai/client.mjs

@@ -0,0 +1,189 @@
+import { getAIProvider } from "./providers.mjs";
+import { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt } from "./prompts/code-generation.mjs";
+import { buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt } from "./prompts/spec-creation.mjs";
+import { generateObject, generateText, streamText } from "ai";
+import * as z$1 from "zod";
+
+//#region src/ai/client.ts
+/**
+* AI Client for spec creation and code generation
+*/
+var AIClient = class {
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Generate operation spec from natural language description
+	*/
+	async generateOperationSpec(description, kind) {
+		return (await generateObject({
+			model: getAIProvider(this.config),
+			schema: z$1.object({
+				name: z$1.string().describe("Dot notation name like \"domain.operation\""),
+				version: z$1.number().int().positive().default(1),
+				description: z$1.string().describe("Clear, concise summary"),
+				goal: z$1.string().describe("Business purpose"),
+				context: z$1.string().describe("Background and constraints"),
+				stability: z$1.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z$1.array(z$1.string()).describe("Team/person owners with @ prefix"),
+				tags: z$1.array(z$1.string()).describe("Categorization tags"),
+				auth: z$1.enum([
+					"anonymous",
+					"user",
+					"admin"
+				]).describe("Required auth level"),
+				inputShape: z$1.string().describe("Description of input structure"),
+				outputShape: z$1.string().describe("Description of output structure"),
+				flags: z$1.array(z$1.string()).describe("Feature flags").default([]),
+				possibleEvents: z$1.array(z$1.string()).describe("Events this may emit").default([]),
+				analytics: z$1.array(z$1.string()).describe("Analytics events to track").default([])
+			}),
+			prompt: buildOperationSpecPrompt(description, kind),
+			system: getSystemPrompt()
+		})).object;
+	}
+	/**
+	* Generate event spec from description
+	*/
+	async generateEventSpec(description) {
+		return (await generateObject({
+			model: getAIProvider(this.config),
+			schema: z$1.object({
+				name: z$1.string().describe("Dot notation name like \"domain.event_name\""),
+				version: z$1.number().int().positive().default(1),
+				description: z$1.string().describe("When this event is emitted"),
+				stability: z$1.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z$1.array(z$1.string()).default([]),
+				tags: z$1.array(z$1.string()).default([]),
+				payloadShape: z$1.string().describe("Description of event payload"),
+				piiFields: z$1.array(z$1.string()).describe("PII field paths").default([])
+			}),
+			prompt: buildEventSpecPrompt(description),
+			system: getSystemPrompt()
+		})).object;
+	}
+	/**
+	* Generate presentation spec from description
+	*/
+	async generatePresentationSpec(description, kind) {
+		return (await generateObject({
+			model: getAIProvider(this.config),
+			schema: z$1.object({
+				name: z$1.string(),
+				version: z$1.number().int().positive().default(1),
+				description: z$1.string(),
+				stability: z$1.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z$1.array(z$1.string()).default([]),
+				tags: z$1.array(z$1.string()).default([]),
+				componentKey: z$1.string().optional(),
+				propsShape: z$1.string().optional(),
+				content: z$1.string().optional(),
+				mimeType: z$1.string().optional(),
+				dataShape: z$1.string().optional()
+			}),
+			prompt: buildPresentationSpecPrompt(description, kind),
+			system: getSystemPrompt()
+		})).object;
+	}
+	/**
+	* Generate handler implementation from spec
+	*/
+	async generateHandler(specCode) {
+		return (await generateText({
+			model: getAIProvider(this.config),
+			prompt: buildHandlerPrompt(specCode),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Generate React component from presentation spec
+	*/
+	async generateComponent(specCode) {
+		return (await generateText({
+			model: getAIProvider(this.config),
+			prompt: buildComponentPrompt(specCode),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Generate form component from form spec
+	*/
+	async generateForm(specCode) {
+		return (await generateText({
+			model: getAIProvider(this.config),
+			prompt: buildFormPrompt(specCode),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Generate tests for implementation
+	*/
+	async generateTests(specCode, implementationCode, testType) {
+		return (await generateText({
+			model: getAIProvider(this.config),
+			prompt: buildTestPrompt(specCode, implementationCode, testType),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Stream code generation for better UX
+	*/
+	async streamCodeGeneration(prompt, onChunk) {
+		const result = await streamText({
+			model: getAIProvider(this.config),
+			prompt,
+			system: getCodeGenSystemPrompt()
+		});
+		let fullText = "";
+		for await (const chunk of result.textStream) {
+			fullText += chunk;
+			onChunk(chunk);
+		}
+		return fullText;
+	}
+	/**
+	* Chat with the AI model
+	*/
+	async chat(messages, system) {
+		return (await generateText({
+			model: getAIProvider(this.config),
+			messages,
+			system: system || getSystemPrompt()
+		})).text;
+	}
+	/**
+	* Stream chat with the AI model
+	*/
+	async streamChat(messages, onChunk, system) {
+		const result = await streamText({
+			model: getAIProvider(this.config),
+			messages,
+			system: system || getSystemPrompt()
+		});
+		let fullText = "";
+		for await (const chunk of result.textStream) {
+			fullText += chunk;
+			onChunk(chunk);
+		}
+		return fullText;
+	}
+};
+
+//#endregion
+export { AIClient };
+//# sourceMappingURL=client.mjs.map

package/dist/ai/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":["z"],"sources":["../../src/ai/client.ts"],"sourcesContent":["import { generateObject, generateText, streamText } from 'ai';\nimport * as z from 'zod';\nimport { getAIProvider } from './providers';\nimport type { Config } from '../types/config';\nimport {\n  buildEventSpecPrompt,\n  buildOperationSpecPrompt,\n  buildPresentationSpecPrompt,\n  getSystemPrompt,\n} from './prompts/spec-creation';\nimport {\n  buildComponentPrompt,\n  buildFormPrompt,\n  buildHandlerPrompt,\n  buildTestPrompt,\n  getCodeGenSystemPrompt,\n} from './prompts/code-generation';\nimport type { OpKind, PresentationKind } from '../types';\n\n/**\n * AI Client for spec creation and code generation\n */\nexport class AIClient {\n  constructor(private config: Config) {}\n\n  /**\n   * Generate operation spec from natural language description\n   */\n  async generateOperationSpec(description: string, kind: OpKind) {\n    const model = getAIProvider(this.config);\n\n    const schema = z.object({\n      name: z.string().describe('Dot notation name like \"domain.operation\"'),\n      version: z.number().int().positive().default(1),\n      description: z.string().describe('Clear, concise summary'),\n      goal: z.string().describe('Business purpose'),\n      context: z.string().describe('Background and constraints'),\n      stability: z\n        .enum(['experimental', 'beta', 'stable', 'deprecated'])\n        .default('beta'),\n      owners: z.array(z.string()).describe('Team/person owners with @ prefix'),\n      tags: z.array(z.string()).describe('Categorization tags'),\n      auth: z\n        .enum(['anonymous', 'user', 'admin'])\n        .describe('Required auth level'),\n      inputShape: z.string().describe('Description of input structure'),\n      outputShape: z.string().describe('Description of output structure'),\n      flags: z.array(z.string()).describe('Feature flags').default([]),\n      possibleEvents: z\n        .array(z.string())\n        .describe('Events this may emit')\n        .default([]),\n      analytics: z\n        .array(z.string())\n        .describe('Analytics events to track')\n        .default([]),\n    });\n\n    const prompt = buildOperationSpecPrompt(description, kind);\n\n    const result = await generateObject({\n      model,\n      schema,\n      prompt,\n      system: getSystemPrompt(),\n    });\n\n    return result.object;\n  }\n\n  /**\n   * Generate event spec from description\n   */\n  async generateEventSpec(description: string) {\n    const model = getAIProvider(this.config);\n\n    const schema = z.object({\n      name: z.string().describe('Dot notation name like \"domain.event_name\"'),\n      version: z.number().int().positive().default(1),\n      description: z.string().describe('When this event is emitted'),\n      stability: z\n        .enum(['experimental', 'beta', 'stable', 'deprecated'])\n        .default('beta'),\n      owners: z.array(z.string()).default([]),\n      tags: z.array(z.string()).default([]),\n      payloadShape: z.string().describe('Description of event payload'),\n      piiFields: z.array(z.string()).describe('PII field paths').default([]),\n    });\n\n    const prompt = buildEventSpecPrompt(description);\n\n    const result = await generateObject({\n      model,\n      schema,\n      prompt,\n      system: getSystemPrompt(),\n    });\n\n    return result.object;\n  }\n\n  /**\n   * Generate presentation spec from description\n   */\n  async generatePresentationSpec(description: string, kind: PresentationKind) {\n    const model = getAIProvider(this.config);\n\n    const schema = z.object({\n      name: z.string(),\n      version: z.number().int().positive().default(1),\n      description: z.string(),\n      stability: z\n        .enum(['experimental', 'beta', 'stable', 'deprecated'])\n        .default('beta'),\n      owners: z.array(z.string()).default([]),\n      tags: z.array(z.string()).default([]),\n      componentKey: z.string().optional(),\n      propsShape: z.string().optional(),\n      content: z.string().optional(),\n      mimeType: z.string().optional(),\n      dataShape: z.string().optional(),\n    });\n\n    const prompt = buildPresentationSpecPrompt(description, kind);\n\n    const result = await generateObject({\n      model,\n      schema,\n      prompt,\n      system: getSystemPrompt(),\n    });\n\n    return result.object;\n  }\n\n  /**\n   * Generate handler implementation from spec\n   */\n  async generateHandler(specCode: string): Promise<string> {\n    const model = getAIProvider(this.config);\n\n    const result = await generateText({\n      model,\n      prompt: buildHandlerPrompt(specCode),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Generate React component from presentation spec\n   */\n  async generateComponent(specCode: string): Promise<string> {\n    const model = getAIProvider(this.config);\n\n    const result = await generateText({\n      model,\n      prompt: buildComponentPrompt(specCode),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Generate form component from form spec\n   */\n  async generateForm(specCode: string): Promise<string> {\n    const model = getAIProvider(this.config);\n\n    const result = await generateText({\n      model,\n      prompt: buildFormPrompt(specCode),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Generate tests for implementation\n   */\n  async generateTests(\n    specCode: string,\n    implementationCode: string,\n    testType: 'handler' | 'component'\n  ): Promise<string> {\n    const model = getAIProvider(this.config);\n\n    const result = await generateText({\n      model,\n      prompt: buildTestPrompt(specCode, implementationCode, testType),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Stream code generation for better UX\n   */\n  async streamCodeGeneration(\n    prompt: string,\n    onChunk: (text: string) => void\n  ): Promise<string> {\n    const model = getAIProvider(this.config);\n\n    const result = await streamText({\n      model,\n      prompt,\n      system: getCodeGenSystemPrompt(),\n    });\n\n    let fullText = '';\n\n    for await (const chunk of result.textStream) {\n      fullText += chunk;\n      onChunk(chunk);\n    }\n\n    return fullText;\n  }\n\n  /**\n   * Chat with the AI model\n   */\n  async chat(\n    messages: { role: 'system' | 'user' | 'assistant'; content: string }[],\n    system?: string\n  ): Promise<string> {\n    const model = getAIProvider(this.config);\n\n    const result = await generateText({\n      model,\n      messages,\n      system: system || getSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Stream chat with the AI model\n   */\n  async streamChat(\n    messages: { role: 'system' | 'user' | 'assistant'; content: string }[],\n    onChunk: (text: string) => void,\n    system?: string\n  ): Promise<string> {\n    const model = getAIProvider(this.config);\n\n    const result = await streamText({\n      model,\n      messages,\n      system: system || getSystemPrompt(),\n    });\n\n    let fullText = '';\n\n    for await (const chunk of result.textStream) {\n      fullText += chunk;\n      onChunk(chunk);\n    }\n\n    return fullText;\n  }\n}\n"],"mappings":"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"}

package/dist/ai/index.d.mts

@@ -0,0 +1,9 @@
+import { AIClient } from "./client.mjs";
+import { getAIProvider, getRecommendedModels, validateProvider } from "./providers.mjs";
+import { AgentConfig, AgentMode, AgentProvider, AgentResult, AgentTask } from "./agents/types.mjs";
+import { AgentOrchestrator } from "./agents/orchestrator.mjs";
+import { SimpleAgent } from "./agents/simple-agent.mjs";
+import { CursorAgent } from "./agents/cursor-agent.mjs";
+import { ClaudeCodeAgent } from "./agents/claude-code-agent.mjs";
+import { OpenAICodexAgent } from "./agents/openai-codex-agent.mjs";
+import { index_d_exports } from "./prompts/index.mjs";

package/dist/ai/index.mjs

@@ -0,0 +1,11 @@
+import { getAIProvider, getRecommendedModels, validateProvider } from "./providers.mjs";
+import { SimpleAgent } from "./agents/simple-agent.mjs";
+import { CursorAgent } from "./agents/cursor-agent.mjs";
+import { ClaudeCodeAgent } from "./agents/claude-code-agent.mjs";
+import { OpenAICodexAgent } from "./agents/openai-codex-agent.mjs";
+import { AgentOrchestrator } from "./agents/orchestrator.mjs";
+import { AIClient } from "./client.mjs";
+import "./agents/index.mjs";
+import { prompts_exports } from "./prompts/index.mjs";
+
+export {  };

package/dist/ai/prompts/code-generation.d.mts

@@ -0,0 +1,26 @@
+declare namespace code_generation_d_exports {
+  export { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt };
+}
+/**
+ * Build prompt for generating handler implementation
+ */
+declare function buildHandlerPrompt(specCode: string): string;
+/**
+ * Build prompt for generating React component from presentation spec
+ */
+declare function buildComponentPrompt(specCode: string): string;
+/**
+ * Build prompt for generating form component
+ */
+declare function buildFormPrompt(specCode: string): string;
+/**
+ * Build prompt for generating tests
+ */
+declare function buildTestPrompt(specCode: string, implementationCode: string, testType: 'handler' | 'component'): string;
+/**
+ * System prompt for code generation
+ */
+declare function getCodeGenSystemPrompt(): string;
+//#endregion
+export { code_generation_d_exports };
+//# sourceMappingURL=code-generation.d.mts.map

package/dist/ai/prompts/code-generation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generation.d.mts","names":[],"sources":["../../../src/ai/prompts/code-generation.ts"],"sourcesContent":[],"mappings":";;;;;;iBAGgB,kBAAA;;;;iBA0BA,oBAAA;;;AA1BhB;AA0BgB,iBA0BA,eAAA,CA1BoB,QAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AA0BpC;AA2BA;AA2CA;iBA3CgB,eAAA;;;;iBA2CA,sBAAA,CAAA"}

package/dist/ai/prompts/code-generation.mjs

@@ -0,0 +1,143 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+
+//#region src/ai/prompts/code-generation.ts
+var code_generation_exports = /* @__PURE__ */ __exportAll({
+	buildComponentPrompt: () => buildComponentPrompt,
+	buildFormPrompt: () => buildFormPrompt,
+	buildHandlerPrompt: () => buildHandlerPrompt,
+	buildTestPrompt: () => buildTestPrompt,
+	getCodeGenSystemPrompt: () => getCodeGenSystemPrompt
+});
+/**
+* Build prompt for generating handler implementation
+*/
+function buildHandlerPrompt(specCode) {
+	return `You are a senior TypeScript developer implementing a handler for a contract specification.
+
+Here is the contract spec:
+
+\`\`\`typescript
+${specCode}
+\`\`\`
+
+Generate a complete handler implementation that:
+
+1. **Matches the spec signature**: Input/output types from the spec
+2. **Handles errors**: Implement error cases defined in spec.io.errors
+3. **Emits events**: Use the events declared in spec.sideEffects.emits
+4. **Validates input**: Use zod validation from the schema
+5. **Follows best practices**: Clean, type-safe TypeScript
+6. **Includes comments**: Explain business logic
+
+The handler should be production-ready with proper error handling, logging points, and clear structure.
+
+Return only the TypeScript code for the handler function.`;
+}
+/**
+* Build prompt for generating React component from presentation spec
+*/
+function buildComponentPrompt(specCode) {
+	return `You are a senior React developer creating a component for a presentation specification.
+
+Here is the presentation spec:
+
+\`\`\`typescript
+${specCode}
+\`\`\`
+
+Generate a complete React component that:
+
+1. **Props interface**: Typed props from the spec
+2. **Accessibility**: Proper ARIA labels, roles, keyboard navigation
+3. **Mobile-first**: Optimized for small screens and touch
+4. **Clean UI**: Simple, intuitive interface
+5. **Type-safe**: Full TypeScript with no 'any' types
+6. **Best practices**: React hooks, proper state management
+
+The component should follow Atomic Design principles and be reusable.
+
+Return only the TypeScript/TSX code for the component.`;
+}
+/**
+* Build prompt for generating form component
+*/
+function buildFormPrompt(specCode) {
+	return `You are a senior React developer creating a form component from a form specification.
+
+Here is the form spec:
+
+\`\`\`typescript
+${specCode}
+\`\`\`
+
+Generate a complete form component using react-hook-form that:
+
+1. **Form validation**: Use zod schema for validation
+2. **Field types**: Proper inputs for each field type
+3. **Conditional logic**: Support visibleWhen, enabledWhen, requiredWhen predicates
+4. **Error handling**: Clear, user-friendly error messages
+5. **Accessibility**: Labels, hints, ARIA attributes
+6. **Mobile-optimized**: Touch-friendly, appropriate input types
+7. **Type-safe**: Full TypeScript
+
+The form should provide excellent UX with real-time validation and helpful feedback.
+
+Return only the TypeScript/TSX code for the form component.`;
+}
+/**
+* Build prompt for generating tests
+*/
+function buildTestPrompt(specCode, implementationCode, testType) {
+	return `You are a senior developer writing comprehensive tests.
+
+Spec:
+\`\`\`typescript
+${specCode}
+\`\`\`
+
+Implementation:
+\`\`\`typescript
+${implementationCode}
+\`\`\`
+
+Generate complete test suite using Vitest that:
+${testType === "handler" ? `
+  - Test all acceptance scenarios from the spec
+  - Test error cases defined in spec.io.errors
+  - Verify events are emitted correctly
+  - Test input validation
+  - Test happy path and edge cases` : `
+  - Test rendering with various props
+  - Test user interactions
+  - Test accessibility (a11y)
+  - Test responsive behavior
+  - Test error states`}
+
+Use clear test descriptions and follow AAA pattern (Arrange, Act, Assert).
+
+Return only the TypeScript test code.`;
+}
+/**
+* System prompt for code generation
+*/
+function getCodeGenSystemPrompt() {
+	return `You are an expert TypeScript developer with deep knowledge of:
+- Type-safe API design
+- React and modern hooks
+- Test-driven development
+- Accessibility best practices
+- Clean code principles
+
+Generate production-ready code that is:
+- Fully typed (no 'any' or type assertions unless absolutely necessary)
+- Well-documented with TSDoc comments
+- Following project conventions
+- Defensive and error-safe
+- Easy to maintain and extend
+
+Always prioritize code quality, safety, and user experience.`;
+}
+
+//#endregion
+export { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, code_generation_exports, getCodeGenSystemPrompt };
+//# sourceMappingURL=code-generation.mjs.map

package/dist/ai/prompts/code-generation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generation.mjs","names":[],"sources":["../../../src/ai/prompts/code-generation.ts"],"sourcesContent":["/**\n * Build prompt for generating handler implementation\n */\nexport function buildHandlerPrompt(specCode: string): string {\n  return `You are a senior TypeScript developer implementing a handler for a contract specification.\n\nHere is the contract spec:\n\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nGenerate a complete handler implementation that:\n\n1. **Matches the spec signature**: Input/output types from the spec\n2. **Handles errors**: Implement error cases defined in spec.io.errors\n3. **Emits events**: Use the events declared in spec.sideEffects.emits\n4. **Validates input**: Use zod validation from the schema\n5. **Follows best practices**: Clean, type-safe TypeScript\n6. **Includes comments**: Explain business logic\n\nThe handler should be production-ready with proper error handling, logging points, and clear structure.\n\nReturn only the TypeScript code for the handler function.`;\n}\n\n/**\n * Build prompt for generating React component from presentation spec\n */\nexport function buildComponentPrompt(specCode: string): string {\n  return `You are a senior React developer creating a component for a presentation specification.\n\nHere is the presentation spec:\n\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nGenerate a complete React component that:\n\n1. **Props interface**: Typed props from the spec\n2. **Accessibility**: Proper ARIA labels, roles, keyboard navigation\n3. **Mobile-first**: Optimized for small screens and touch\n4. **Clean UI**: Simple, intuitive interface\n5. **Type-safe**: Full TypeScript with no 'any' types\n6. **Best practices**: React hooks, proper state management\n\nThe component should follow Atomic Design principles and be reusable.\n\nReturn only the TypeScript/TSX code for the component.`;\n}\n\n/**\n * Build prompt for generating form component\n */\nexport function buildFormPrompt(specCode: string): string {\n  return `You are a senior React developer creating a form component from a form specification.\n\nHere is the form spec:\n\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nGenerate a complete form component using react-hook-form that:\n\n1. **Form validation**: Use zod schema for validation\n2. **Field types**: Proper inputs for each field type\n3. **Conditional logic**: Support visibleWhen, enabledWhen, requiredWhen predicates\n4. **Error handling**: Clear, user-friendly error messages\n5. **Accessibility**: Labels, hints, ARIA attributes\n6. **Mobile-optimized**: Touch-friendly, appropriate input types\n7. **Type-safe**: Full TypeScript\n\nThe form should provide excellent UX with real-time validation and helpful feedback.\n\nReturn only the TypeScript/TSX code for the form component.`;\n}\n\n/**\n * Build prompt for generating tests\n */\nexport function buildTestPrompt(\n  specCode: string,\n  implementationCode: string,\n  testType: 'handler' | 'component'\n): string {\n  const testFocus =\n    testType === 'handler'\n      ? `\n  - Test all acceptance scenarios from the spec\n  - Test error cases defined in spec.io.errors\n  - Verify events are emitted correctly\n  - Test input validation\n  - Test happy path and edge cases`\n      : `\n  - Test rendering with various props\n  - Test user interactions\n  - Test accessibility (a11y)\n  - Test responsive behavior\n  - Test error states`;\n\n  return `You are a senior developer writing comprehensive tests.\n\nSpec:\n\\`\\`\\`typescript\n${specCode}\n\\`\\`\\`\n\nImplementation:\n\\`\\`\\`typescript\n${implementationCode}\n\\`\\`\\`\n\nGenerate complete test suite using Vitest that:\n${testFocus}\n\nUse clear test descriptions and follow AAA pattern (Arrange, Act, Assert).\n\nReturn only the TypeScript test code.`;\n}\n\n/**\n * System prompt for code generation\n */\nexport function getCodeGenSystemPrompt(): string {\n  return `You are an expert TypeScript developer with deep knowledge of:\n- Type-safe API design\n- React and modern hooks\n- Test-driven development\n- Accessibility best practices\n- Clean code principles\n\nGenerate production-ready code that is:\n- Fully typed (no 'any' or type assertions unless absolutely necessary)\n- Well-documented with TSDoc comments\n- Following project conventions\n- Defensive and error-safe\n- Easy to maintain and extend\n\nAlways prioritize code quality, safety, and user experience.`;\n}\n"],"mappings":";;;;;;;;;;;;;AAGA,SAAgB,mBAAmB,UAA0B;AAC3D,QAAO;;;;;EAKP,SAAS;;;;;;;;;;;;;;;;;;;AAoBX,SAAgB,qBAAqB,UAA0B;AAC7D,QAAO;;;;;EAKP,SAAS;;;;;;;;;;;;;;;;;;;AAoBX,SAAgB,gBAAgB,UAA0B;AACxD,QAAO;;;;;EAKP,SAAS;;;;;;;;;;;;;;;;;;;;AAqBX,SAAgB,gBACd,UACA,oBACA,UACQ;AAgBR,QAAO;;;;EAIP,SAAS;;;;;EAKT,mBAAmB;;;;EAvBjB,aAAa,YACT;;;;;sCAMA;;;;;uBAoBI;;;;;;;;;AAUZ,SAAgB,yBAAiC;AAC/C,QAAO"}

package/dist/ai/prompts/index.d.mts

@@ -0,0 +1,10 @@
+import { code_generation_d_exports } from "./code-generation.mjs";
+import { spec_creation_d_exports } from "./spec-creation.mjs";
+
+//#region src/ai/prompts/index.d.ts
+declare namespace index_d_exports {
+  export { code_generation_d_exports as codeGeneration, spec_creation_d_exports as specCreation };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.mts.map

package/dist/ai/prompts/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/ai/prompts/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/ai/prompts/index.mjs

@@ -0,0 +1,13 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+import { code_generation_exports } from "./code-generation.mjs";
+import { spec_creation_exports } from "./spec-creation.mjs";
+
+//#region src/ai/prompts/index.ts
+var prompts_exports = /* @__PURE__ */ __exportAll({
+	codeGeneration: () => code_generation_exports,
+	specCreation: () => spec_creation_exports
+});
+
+//#endregion
+export { prompts_exports };
+//# sourceMappingURL=index.mjs.map

package/dist/ai/prompts/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/ai/prompts/index.ts"],"sourcesContent":["/**\n * AI prompts for ContractSpec.\n */\n\nexport * as codeGeneration from './code-generation';\nexport * as specCreation from './spec-creation';\n"],"mappings":""}

package/dist/ai/prompts/spec-creation.d.mts

@@ -0,0 +1,29 @@
+import { OpKind, PresentationKind } from "../../types.mjs";
+
+//#region src/ai/prompts/spec-creation.d.ts
+declare namespace spec_creation_d_exports {
+  export { addExampleContext, buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt };
+}
+/**
+ * Build prompt for creating operation spec from description
+ */
+declare function buildOperationSpecPrompt(description: string, kind: OpKind): string;
+/**
+ * Build prompt for creating event spec from description
+ */
+declare function buildEventSpecPrompt(description: string): string;
+/**
+ * Build prompt for creating presentation spec from description
+ */
+declare function buildPresentationSpecPrompt(description: string, kind: PresentationKind): string;
+/**
+ * Build system prompt for all spec generation
+ */
+declare function getSystemPrompt(): string;
+/**
+ * Create example-based prompt for better results
+ */
+declare function addExampleContext(basePrompt: string, examples: string[]): string;
+//#endregion
+export { spec_creation_d_exports };
+//# sourceMappingURL=spec-creation.d.mts.map

package/dist/ai/prompts/spec-creation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-creation.d.mts","names":[],"sources":["../../../src/ai/prompts/spec-creation.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAKgB,wBAAA,4BAER;;;;iBA0BQ,oBAAA;;;AA5BhB;AA4BgB,iBAqBA,2BAAA,CArBoB,WAAA,EAAA,MAAA,EAAA,IAAA,EAuB5B,gBAvB4B,CAAA,EAAA,MAAA;AAqBpC;AAoCA;AAiBA;iBAjBgB,eAAA,CAAA;;;;iBAiBA,iBAAA"}

package/dist/ai/prompts/spec-creation.mjs

@@ -0,0 +1,111 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+
+//#region src/ai/prompts/spec-creation.ts
+var spec_creation_exports = /* @__PURE__ */ __exportAll({
+	addExampleContext: () => addExampleContext,
+	buildEventSpecPrompt: () => buildEventSpecPrompt,
+	buildOperationSpecPrompt: () => buildOperationSpecPrompt,
+	buildPresentationSpecPrompt: () => buildPresentationSpecPrompt,
+	getSystemPrompt: () => getSystemPrompt
+});
+/**
+* Build prompt for creating operation spec from description
+*/
+function buildOperationSpecPrompt(description, kind) {
+	return `You are a senior software architect creating a contract specification for an operation.
+
+The operation is a ${kind} (${kind === "command" ? "changes state, has side effects" : "read-only, idempotent"}).
+
+User description: ${description}
+
+Create a complete contract specification following these guidelines:
+
+1. **Name**: Use dot notation like "domain.operationName" (e.g., "user.signup", "payment.charge")
+2. **Version**: Start at 1
+3. **Description**: Clear, concise summary (1-2 sentences)
+4. **Goal**: Business purpose - why this operation exists
+5. **Context**: Background, constraints, scope (what it does and doesn't do)
+6. **Input/Output**: Describe the shape (we'll create schemas separately)
+7. **Auth**: Who can call this - anonymous, user, or admin
+8. **Feature Flags**: Any flags that gate this operation
+9. **Side Effects**: What events might be emitted, analytics to track
+
+Respond with a structured spec.`;
+}
+/**
+* Build prompt for creating event spec from description
+*/
+function buildEventSpecPrompt(description) {
+	return `You are a senior software architect creating an event specification.
+
+User description: ${description}
+
+Create a complete event specification following these guidelines:
+
+1. **Name**: Use dot notation like "domain.event_name" (e.g., "user.signup_completed", "payment.charged")
+2. **Version**: Start at 1
+3. **Description**: Clear description of when this event is emitted
+4. **Payload**: Describe what data the event carries
+5. **PII Fields**: List any personally identifiable information fields (e.g., ["email", "name"])
+
+Events represent things that have already happened and should use past tense.
+
+Respond with a structured spec.`;
+}
+/**
+* Build prompt for creating presentation spec from description
+*/
+function buildPresentationSpecPrompt(description, kind) {
+	return `You are a senior software architect creating a presentation specification.
+
+This is a ${kind} presentation - ${{
+		web_component: "a React component with props schema",
+		markdown: "markdown/MDX documentation or guide",
+		data: "structured data export (JSON/XML)"
+	}[kind]}.
+
+User description: ${description}
+
+Create a complete presentation specification following these guidelines:
+
+1. **Name**: Use dot notation like "domain.presentation_name" (e.g., "user.profile_card", "docs.api_guide")
+2. **Version**: Start at 1
+3. **Description**: What this presentation shows/provides
+4. **Kind-specific details**:
+   ${kind === "web_component" ? "- Component key (symbolic, resolved by host app)\n   - Props structure\n   - Analytics events to track" : kind === "markdown" ? "- Content or resource URI\n   - Target audience" : "- MIME type (e.g., application/json)\n   - Data structure description"}
+
+Respond with a structured spec.`;
+}
+/**
+* Build system prompt for all spec generation
+*/
+function getSystemPrompt() {
+	return `You are an expert software architect specializing in API design and contract-driven development.
+
+You create clear, well-documented specifications that serve as the single source of truth for operations, events, and presentations.
+
+Your specs are:
+- Precise and unambiguous
+- Following TypeScript conventions
+- Business-oriented (capturing the "why" not just "what")
+- Designed for both humans and AI agents to understand
+
+Always use proper dot notation for names and ensure all metadata is meaningful and accurate.`;
+}
+/**
+* Create example-based prompt for better results
+*/
+function addExampleContext(basePrompt, examples) {
+	if (examples.length === 0) return basePrompt;
+	return `${basePrompt}
+
+Here are some good examples for reference:
+
+${examples.join("\n\n")}
+
+Follow this structure and quality level.`;
+}
+
+//#endregion
+export { buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt, spec_creation_exports };
+//# sourceMappingURL=spec-creation.mjs.map

package/dist/ai/prompts/spec-creation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-creation.mjs","names":[],"sources":["../../../src/ai/prompts/spec-creation.ts"],"sourcesContent":["import type { OpKind, PresentationKind } from '../../types';\n\n/**\n * Build prompt for creating operation spec from description\n */\nexport function buildOperationSpecPrompt(\n  description: string,\n  kind: OpKind\n): string {\n  return `You are a senior software architect creating a contract specification for an operation.\n\nThe operation is a ${kind} (${kind === 'command' ? 'changes state, has side effects' : 'read-only, idempotent'}).\n\nUser description: ${description}\n\nCreate a complete contract specification following these guidelines:\n\n1. **Name**: Use dot notation like \"domain.operationName\" (e.g., \"user.signup\", \"payment.charge\")\n2. **Version**: Start at 1\n3. **Description**: Clear, concise summary (1-2 sentences)\n4. **Goal**: Business purpose - why this operation exists\n5. **Context**: Background, constraints, scope (what it does and doesn't do)\n6. **Input/Output**: Describe the shape (we'll create schemas separately)\n7. **Auth**: Who can call this - anonymous, user, or admin\n8. **Feature Flags**: Any flags that gate this operation\n9. **Side Effects**: What events might be emitted, analytics to track\n\nRespond with a structured spec.`;\n}\n\n/**\n * Build prompt for creating event spec from description\n */\nexport function buildEventSpecPrompt(description: string): string {\n  return `You are a senior software architect creating an event specification.\n\nUser description: ${description}\n\nCreate a complete event specification following these guidelines:\n\n1. **Name**: Use dot notation like \"domain.event_name\" (e.g., \"user.signup_completed\", \"payment.charged\")\n2. **Version**: Start at 1\n3. **Description**: Clear description of when this event is emitted\n4. **Payload**: Describe what data the event carries\n5. **PII Fields**: List any personally identifiable information fields (e.g., [\"email\", \"name\"])\n\nEvents represent things that have already happened and should use past tense.\n\nRespond with a structured spec.`;\n}\n\n/**\n * Build prompt for creating presentation spec from description\n */\nexport function buildPresentationSpecPrompt(\n  description: string,\n  kind: PresentationKind\n): string {\n  const kindDescriptions = {\n    web_component: 'a React component with props schema',\n    markdown: 'markdown/MDX documentation or guide',\n    data: 'structured data export (JSON/XML)',\n  };\n\n  return `You are a senior software architect creating a presentation specification.\n\nThis is a ${kind} presentation - ${kindDescriptions[kind]}.\n\nUser description: ${description}\n\nCreate a complete presentation specification following these guidelines:\n\n1. **Name**: Use dot notation like \"domain.presentation_name\" (e.g., \"user.profile_card\", \"docs.api_guide\")\n2. **Version**: Start at 1\n3. **Description**: What this presentation shows/provides\n4. **Kind-specific details**:\n   ${\n     kind === 'web_component'\n       ? '- Component key (symbolic, resolved by host app)\\n   - Props structure\\n   - Analytics events to track'\n       : kind === 'markdown'\n         ? '- Content or resource URI\\n   - Target audience'\n         : '- MIME type (e.g., application/json)\\n   - Data structure description'\n   }\n\nRespond with a structured spec.`;\n}\n\n/**\n * Build system prompt for all spec generation\n */\nexport function getSystemPrompt(): string {\n  return `You are an expert software architect specializing in API design and contract-driven development.\n\nYou create clear, well-documented specifications that serve as the single source of truth for operations, events, and presentations.\n\nYour specs are:\n- Precise and unambiguous\n- Following TypeScript conventions\n- Business-oriented (capturing the \"why\" not just \"what\")\n- Designed for both humans and AI agents to understand\n\nAlways use proper dot notation for names and ensure all metadata is meaningful and accurate.`;\n}\n\n/**\n * Create example-based prompt for better results\n */\nexport function addExampleContext(\n  basePrompt: string,\n  examples: string[]\n): string {\n  if (examples.length === 0) return basePrompt;\n\n  return `${basePrompt}\n\nHere are some good examples for reference:\n\n${examples.join('\\n\\n')}\n\nFollow this structure and quality level.`;\n}\n"],"mappings":";;;;;;;;;;;;;AAKA,SAAgB,yBACd,aACA,MACQ;AACR,QAAO;;qBAEY,KAAK,IAAI,SAAS,YAAY,oCAAoC,wBAAwB;;oBAE3F,YAAY;;;;;;;;;;;;;;;;;;;AAoBhC,SAAgB,qBAAqB,aAA6B;AAChE,QAAO;;oBAEW,YAAY;;;;;;;;;;;;;;;;;AAkBhC,SAAgB,4BACd,aACA,MACQ;AAOR,QAAO;;YAEG,KAAK,kBARU;EACvB,eAAe;EACf,UAAU;EACV,MAAM;EACP,CAIiD,MAAM;;oBAEtC,YAAY;;;;;;;;KAS3B,SAAS,kBACL,2GACA,SAAS,aACP,oDACA,wEACP;;;;;;;AAQJ,SAAgB,kBAA0B;AACxC,QAAO;;;;;;;;;;;;;;;AAgBT,SAAgB,kBACd,YACA,UACQ;AACR,KAAI,SAAS,WAAW,EAAG,QAAO;AAElC,QAAO,GAAG,WAAW;;;;EAIrB,SAAS,KAAK,OAAO,CAAC"}

package/dist/ai/providers.d.mts

@@ -0,0 +1,29 @@
+import { Config } from "../types/config.mjs";
+import { LanguageModel } from "ai";
+
+//#region src/ai/providers.d.ts
+
+/**
+ * Initialize AI provider based on configuration
+ *
+ * @deprecated Use createProvider() from @contractspec/lib.ai-providers instead
+ */
+declare function getAIProvider(config: Config): LanguageModel;
+/**
+ * Validate that the provider is accessible and working
+ *
+ * @deprecated Use validateProvider() from @contractspec/lib.ai-providers instead
+ */
+declare function validateProvider(config: Config): Promise<{
+  success: boolean;
+  error?: string;
+}>;
+/**
+ * Get recommended models for each provider
+ *
+ * @deprecated Use getModelsForProvider() from @contractspec/lib.ai-providers instead
+ */
+declare function getRecommendedModels(provider: Config['aiProvider']): string[];
+//#endregion
+export { getAIProvider, getRecommendedModels, validateProvider };
+//# sourceMappingURL=providers.d.mts.map

package/dist/ai/providers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.mts","names":[],"sources":["../../src/ai/providers.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBAmBgB,aAAA,SAAsB,SAAS;;;;;;iBAczB,gBAAA,SACZ,SACP;;;;;;;;;iBAea,oBAAA,WAA+B"}