@contractspec/bundle.workspace 1.46.2 → 1.48.0

package/dist/ai/agents/openai-codex-agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-codex-agent.mjs","names":[],"sources":["../../../src/ai/agents/openai-codex-agent.ts"],"sourcesContent":["/**\n * OpenAI Codex Agent - Uses OpenAI's code-optimized models\n * Supports GPT-4o and o1 reasoning models for complex code generation\n */\n\nimport { openai } from '@ai-sdk/openai';\nimport { generateText } from 'ai';\nimport type { AgentProvider, AgentResult, AgentTask } from './types';\n\nexport class OpenAICodexAgent implements AgentProvider {\n  name = 'openai-codex' as const;\n  private apiKey: string | undefined;\n\n  constructor() {\n    this.apiKey = process.env.OPENAI_API_KEY;\n  }\n\n  canHandle(_task: AgentTask): boolean {\n    return !!this.apiKey;\n  }\n\n  async generate(task: AgentTask): Promise<AgentResult> {\n    if (!this.apiKey) {\n      return {\n        success: false,\n        errors: [\n          'OPENAI_API_KEY not set. OpenAI Codex agent requires API access.',\n        ],\n      };\n    }\n\n    try {\n      // Use o1 for complex generation, gpt-4o for standard\n      const isComplex = this.isComplexTask(task);\n      const modelName = isComplex ? 'o1' : 'gpt-4o';\n      const model = openai(modelName);\n\n      const systemPrompt = this.buildSystemPrompt(task);\n      const userPrompt = this.buildUserPrompt(task);\n\n      const result = await generateText({\n        model,\n        prompt: userPrompt,\n        system: systemPrompt,\n        temperature: 0.2,\n      });\n\n      const code = this.extractCode(result.text);\n\n      return {\n        success: true,\n        code,\n        metadata: {\n          model: modelName,\n          agentMode: 'openai-codex',\n          usage: result.usage,\n        },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errors: [error instanceof Error ? error.message : String(error)],\n      };\n    }\n  }\n\n  async validate(task: AgentTask): Promise<AgentResult> {\n    if (!this.apiKey) {\n      return {\n        success: false,\n        errors: ['OPENAI_API_KEY not set'],\n      };\n    }\n\n    try {\n      const model = openai('gpt-4o');\n\n      const prompt = `\nReview this code implementation against its specification.\n\nSPECIFICATION:\n\\`\\`\\`typescript\n${task.specCode}\n\\`\\`\\`\n\nIMPLEMENTATION:\n\\`\\`\\`typescript\n${task.existingCode || '// No implementation'}\n\\`\\`\\`\n\nProvide a detailed validation report including:\n1. Specification compliance\n2. Code quality assessment\n3. Potential bugs or issues\n4. Recommendations for improvement\n\nFormat as a structured report.\n`;\n\n      const result = await generateText({\n        model,\n        prompt,\n        system:\n          'You are a senior software engineer performing thorough code review.',\n        temperature: 0.3,\n      });\n\n      const hasIssues = this.detectIssues(result.text);\n\n      return {\n        success: !hasIssues,\n        code: result.text,\n        errors: hasIssues ? this.extractErrors(result.text) : [],\n        warnings: this.extractWarnings(result.text),\n        metadata: {\n          agentMode: 'openai-codex',\n          validationType: 'ai-review',\n        },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errors: [error instanceof Error ? error.message : String(error)],\n      };\n    }\n  }\n\n  private isComplexTask(task: AgentTask): boolean {\n    // Use o1 reasoning model for complex tasks\n    const complexIndicators = [\n      'algorithm',\n      'optimization',\n      'complex logic',\n      'state management',\n      'concurrent',\n      'distributed',\n    ];\n\n    const taskStr = (task.specCode + (task.existingCode || '')).toLowerCase();\n    return complexIndicators.some((indicator) => taskStr.includes(indicator));\n  }\n\n  private buildSystemPrompt(task: AgentTask): string {\n    const basePrompt = `You are an expert TypeScript/JavaScript developer.\n\nGenerate production-quality code that is:\n- Type-safe and well-typed\n- Documented with clear comments\n- Following best practices and SOLID principles\n- Properly handling errors and edge cases\n- Testable and maintainable\n\nOutput only the code without explanations unless specifically asked.`;\n\n    if (task.type === 'test') {\n      return (\n        basePrompt + '\\n\\nGenerate comprehensive test suites using Vitest.'\n      );\n    }\n\n    return basePrompt;\n  }\n\n  private buildUserPrompt(task: AgentTask): string {\n    switch (task.type) {\n      case 'generate':\n        return `Implement this specification:\\n\\n${task.specCode}\\n\\nProvide complete, production-ready TypeScript code.`;\n\n      case 'test':\n        return `Create comprehensive tests:\\n\\nSpec:\\n${task.specCode}\\n\\nImplementation:\\n${task.existingCode}\\n\\nGenerate complete Vitest test suite.`;\n\n      case 'refactor':\n        return `Refactor this code while maintaining functionality:\\n\\n${task.existingCode}\\n\\nSpec:\\n${task.specCode}`;\n\n      default:\n        return task.specCode;\n    }\n  }\n\n  private extractCode(text: string): string {\n    // Extract from markdown code blocks\n    const match = text.match(\n      /```(?:typescript|ts|tsx|javascript|js)?\\n([\\s\\S]*?)\\n```/\n    );\n    return match && match[1] ? match[1] : text;\n  }\n\n  private detectIssues(text: string): boolean {\n    const issueKeywords = [\n      'issue',\n      'problem',\n      'bug',\n      'error',\n      'incorrect',\n      'missing',\n      'fails',\n      'violation',\n    ];\n\n    const lower = text.toLowerCase();\n    return issueKeywords.some((keyword) => lower.includes(keyword));\n  }\n\n  private extractErrors(text: string): string[] {\n    const errors: string[] = [];\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (\n        line.toLowerCase().includes('error') ||\n        line.toLowerCase().includes('bug') ||\n        line.toLowerCase().includes('fails')\n      ) {\n        errors.push(line.trim());\n      }\n    }\n\n    return errors;\n  }\n\n  private extractWarnings(text: string): string[] {\n    const warnings: string[] = [];\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (\n        line.toLowerCase().includes('warning') ||\n        line.toLowerCase().includes('should') ||\n        line.toLowerCase().includes('consider')\n      ) {\n        warnings.push(line.trim());\n      }\n    }\n\n    return warnings;\n  }\n}\n"],"mappings":"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"}

package/dist/ai/agents/orchestrator.d.mts

@@ -0,0 +1,50 @@
+import { Config } from "../../types/config.mjs";
+import { AgentMode, AgentResult, AgentTask } from "./types.mjs";
+
+//#region src/ai/agents/orchestrator.d.ts
+
+declare class AgentOrchestrator {
+  private config;
+  private agents;
+  private defaultAgent;
+  constructor(config: Config);
+  /**
+   * Execute a task using the configured agent with fallback support
+   */
+  executeTask(task: AgentTask): Promise<AgentResult>;
+  /**
+   * Generate code from specification
+   */
+  generate(specCode: string, targetPath?: string): Promise<AgentResult>;
+  /**
+   * Generate tests for implementation
+   */
+  generateTests(specCode: string, implementationCode: string): Promise<AgentResult>;
+  /**
+   * Validate implementation against specification
+   */
+  validate(specCode: string, implementationCode: string): Promise<AgentResult>;
+  /**
+   * Refactor existing code
+   */
+  refactor(specCode: string, existingCode: string): Promise<AgentResult>;
+  /**
+   * List available agents and their status
+   */
+  getAvailableAgents(): Promise<{
+    mode: AgentMode;
+    available: boolean;
+    reason?: string;
+  }[]>;
+  /**
+   * Get the configured agent mode
+   */
+  private getAgentMode;
+  /**
+   * Get fallback mode for an agent
+   */
+  private getFallbackMode;
+}
+//#endregion
+export { AgentOrchestrator };
+//# sourceMappingURL=orchestrator.d.mts.map

package/dist/ai/agents/orchestrator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.mts","names":[],"sources":["../../../src/ai/agents/orchestrator.ts"],"sourcesContent":[],"mappings":";;;;;AAsC0B,cAxBb,iBAAA,CAwBa;EAAoB,QAAA,MAAA;EAAR,QAAA,MAAA;EAuE2B,QAAA,YAAA;EAAR,WAAA,CAAA,MAAA,EA3F3B,MA2F2B;EAc5C;;;EAcR,WAAA,CAAA,IAAA,EAnGqB,SAmGrB,CAAA,EAnGiC,OAmGjC,CAnGyC,WAmGzC,CAAA;EAW6D;;;EAWpC,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,UAAA,CAAA,EAAA,MAAA,CAAA,EAlD2B,OAkD3B,CAlDmC,WAkDnC,CAAA;EAAO;;;+DApChC,QAAQ;;;;0DAcR,QAAQ;;;;oDAW6C,QAAQ;;;;wBAWpC;UAClB"}

package/dist/ai/agents/orchestrator.mjs

@@ -0,0 +1,143 @@
+import { SimpleAgent } from "./simple-agent.mjs";
+import { CursorAgent } from "./cursor-agent.mjs";
+import { ClaudeCodeAgent } from "./claude-code-agent.mjs";
+import { OpenAICodexAgent } from "./openai-codex-agent.mjs";
+import chalk from "chalk";
+import ora from "ora";
+
+//#region src/ai/agents/orchestrator.ts
+/**
+* Agent Orchestrator - Coordinates between different AI agents
+* Selects the appropriate agent based on config and task requirements
+*/
+var AgentOrchestrator = class {
+	agents;
+	defaultAgent;
+	constructor(config) {
+		this.config = config;
+		this.agents = /* @__PURE__ */ new Map();
+		const simpleAgent = new SimpleAgent(config);
+		const cursorAgent = new CursorAgent();
+		const claudeAgent = new ClaudeCodeAgent();
+		const openaiAgent = new OpenAICodexAgent();
+		this.agents.set("simple", simpleAgent);
+		this.agents.set("cursor", cursorAgent);
+		this.agents.set("claude-code", claudeAgent);
+		this.agents.set("openai-codex", openaiAgent);
+		this.defaultAgent = simpleAgent;
+	}
+	/**
+	* Execute a task using the configured agent with fallback support
+	*/
+	async executeTask(task) {
+		const agentMode = this.getAgentMode();
+		const agent = this.agents.get(agentMode);
+		if (!agent) {
+			console.log(chalk.yellow(`⚠️  Agent '${agentMode}' not found, using simple agent`));
+			return this.defaultAgent.generate(task);
+		}
+		if (!agent.canHandle(task)) {
+			console.log(chalk.yellow(`⚠️  Agent '${agentMode}' cannot handle this task, falling back to simple agent`));
+			return this.defaultAgent.generate(task);
+		}
+		const spinner = ora(`Executing with ${agentMode} agent...`).start();
+		try {
+			const result = task.type === "validate" ? await agent.validate(task) : await agent.generate(task);
+			if (result.success) {
+				spinner.succeed(chalk.green(`${agentMode} agent completed successfully`));
+				return result;
+			}
+			spinner.warn(chalk.yellow(`${agentMode} agent failed, trying fallback...`));
+			const fallbackMode = this.getFallbackMode(agentMode);
+			if (fallbackMode && fallbackMode !== agentMode) {
+				const fallbackAgent = this.agents.get(fallbackMode);
+				if (fallbackAgent && fallbackAgent.canHandle(task)) return task.type === "validate" ? await fallbackAgent.validate(task) : await fallbackAgent.generate(task);
+			}
+			spinner.info(chalk.gray("Using simple agent as ultimate fallback"));
+			return task.type === "validate" ? await this.defaultAgent.validate(task) : await this.defaultAgent.generate(task);
+		} catch (_error) {
+			spinner.fail(chalk.red("Agent execution failed"));
+			console.log(chalk.gray("Falling back to simple agent..."));
+			return task.type === "validate" ? await this.defaultAgent.validate(task) : await this.defaultAgent.generate(task);
+		}
+	}
+	/**
+	* Generate code from specification
+	*/
+	async generate(specCode, targetPath) {
+		return this.executeTask({
+			type: "generate",
+			specCode,
+			targetPath
+		});
+	}
+	/**
+	* Generate tests for implementation
+	*/
+	async generateTests(specCode, implementationCode) {
+		return this.executeTask({
+			type: "test",
+			specCode,
+			existingCode: implementationCode
+		});
+	}
+	/**
+	* Validate implementation against specification
+	*/
+	async validate(specCode, implementationCode) {
+		return this.executeTask({
+			type: "validate",
+			specCode,
+			existingCode: implementationCode
+		});
+	}
+	/**
+	* Refactor existing code
+	*/
+	async refactor(specCode, existingCode) {
+		return this.executeTask({
+			type: "refactor",
+			specCode,
+			existingCode
+		});
+	}
+	/**
+	* List available agents and their status
+	*/
+	async getAvailableAgents() {
+		const results = [];
+		for (const [mode, agent] of this.agents) {
+			const canHandle = agent.canHandle({
+				type: "generate",
+				specCode: "test"
+			});
+			results.push({
+				mode,
+				available: canHandle,
+				reason: canHandle ? void 0 : "Not configured or dependencies missing"
+			});
+		}
+		return results;
+	}
+	/**
+	* Get the configured agent mode
+	*/
+	getAgentMode() {
+		return this.config.agentMode || "simple";
+	}
+	/**
+	* Get fallback mode for an agent
+	*/
+	getFallbackMode(mode) {
+		return {
+			cursor: "claude-code",
+			"claude-code": "openai-codex",
+			"openai-codex": "simple",
+			simple: "simple"
+		}[mode];
+	}
+};
+
+//#endregion
+export { AgentOrchestrator };
+//# sourceMappingURL=orchestrator.mjs.map

package/dist/ai/agents/orchestrator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.mjs","names":[],"sources":["../../../src/ai/agents/orchestrator.ts"],"sourcesContent":["/**\n * Agent Orchestrator - Coordinates between different AI agents\n * Selects the appropriate agent based on config and task requirements\n */\n\nimport { SimpleAgent } from './simple-agent';\nimport { CursorAgent } from './cursor-agent';\nimport { ClaudeCodeAgent } from './claude-code-agent';\nimport { OpenAICodexAgent } from './openai-codex-agent';\nimport type { Config } from '../../types/config';\nimport type { AgentMode, AgentProvider, AgentResult, AgentTask } from './types';\nimport chalk from 'chalk';\nimport ora from 'ora';\n\nexport class AgentOrchestrator {\n  private agents: Map<AgentMode, AgentProvider>;\n  private defaultAgent: AgentProvider;\n\n  constructor(private config: Config) {\n    // Initialize all available agents\n    this.agents = new Map();\n\n    const simpleAgent = new SimpleAgent(config);\n    const cursorAgent = new CursorAgent();\n    const claudeAgent = new ClaudeCodeAgent();\n    const openaiAgent = new OpenAICodexAgent();\n\n    this.agents.set('simple', simpleAgent);\n    this.agents.set('cursor', cursorAgent);\n    this.agents.set('claude-code', claudeAgent);\n    this.agents.set('openai-codex', openaiAgent);\n\n    this.defaultAgent = simpleAgent;\n  }\n\n  /**\n   * Execute a task using the configured agent with fallback support\n   */\n  async executeTask(task: AgentTask): Promise<AgentResult> {\n    const agentMode = this.getAgentMode();\n    const agent = this.agents.get(agentMode);\n\n    if (!agent) {\n      console.log(\n        chalk.yellow(`⚠️  Agent '${agentMode}' not found, using simple agent`)\n      );\n      return this.defaultAgent.generate(task);\n    }\n\n    // Check if agent can handle the task\n    if (!agent.canHandle(task)) {\n      console.log(\n        chalk.yellow(\n          `⚠️  Agent '${agentMode}' cannot handle this task, falling back to simple agent`\n        )\n      );\n      return this.defaultAgent.generate(task);\n    }\n\n    // Try primary agent\n    const spinner = ora(`Executing with ${agentMode} agent...`).start();\n\n    try {\n      const result =\n        task.type === 'validate'\n          ? await agent.validate(task)\n          : await agent.generate(task);\n\n      if (result.success) {\n        spinner.succeed(\n          chalk.green(`${agentMode} agent completed successfully`)\n        );\n        return result;\n      }\n\n      // If primary agent failed, try fallback\n      spinner.warn(\n        chalk.yellow(`${agentMode} agent failed, trying fallback...`)\n      );\n\n      const fallbackMode = this.getFallbackMode(agentMode);\n      if (fallbackMode && fallbackMode !== agentMode) {\n        const fallbackAgent = this.agents.get(fallbackMode);\n        if (fallbackAgent && fallbackAgent.canHandle(task)) {\n          return task.type === 'validate'\n            ? await fallbackAgent.validate(task)\n            : await fallbackAgent.generate(task);\n        }\n      }\n\n      // Ultimate fallback to simple agent\n      spinner.info(chalk.gray('Using simple agent as ultimate fallback'));\n      return task.type === 'validate'\n        ? await this.defaultAgent.validate(task)\n        : await this.defaultAgent.generate(task);\n    } catch (_error) {\n      spinner.fail(chalk.red('Agent execution failed'));\n\n      // Fallback on error\n      console.log(chalk.gray('Falling back to simple agent...'));\n      return task.type === 'validate'\n        ? await this.defaultAgent.validate(task)\n        : await this.defaultAgent.generate(task);\n    }\n  }\n\n  /**\n   * Generate code from specification\n   */\n  async generate(specCode: string, targetPath?: string): Promise<AgentResult> {\n    return this.executeTask({\n      type: 'generate',\n      specCode,\n      targetPath,\n    });\n  }\n\n  /**\n   * Generate tests for implementation\n   */\n  async generateTests(\n    specCode: string,\n    implementationCode: string\n  ): Promise<AgentResult> {\n    return this.executeTask({\n      type: 'test',\n      specCode,\n      existingCode: implementationCode,\n    });\n  }\n\n  /**\n   * Validate implementation against specification\n   */\n  async validate(\n    specCode: string,\n    implementationCode: string\n  ): Promise<AgentResult> {\n    return this.executeTask({\n      type: 'validate',\n      specCode,\n      existingCode: implementationCode,\n    });\n  }\n\n  /**\n   * Refactor existing code\n   */\n  async refactor(specCode: string, existingCode: string): Promise<AgentResult> {\n    return this.executeTask({\n      type: 'refactor',\n      specCode,\n      existingCode,\n    });\n  }\n\n  /**\n   * List available agents and their status\n   */\n  async getAvailableAgents(): Promise<\n    { mode: AgentMode; available: boolean; reason?: string }[]\n  > {\n    const results = [];\n\n    for (const [mode, agent] of this.agents) {\n      const testTask: AgentTask = {\n        type: 'generate',\n        specCode: 'test',\n      };\n\n      const canHandle = agent.canHandle(testTask);\n\n      results.push({\n        mode,\n        available: canHandle,\n        reason: canHandle\n          ? undefined\n          : 'Not configured or dependencies missing',\n      });\n    }\n\n    return results;\n  }\n\n  /**\n   * Get the configured agent mode\n   */\n  private getAgentMode(): AgentMode {\n    // Check config for agent mode\n    const mode = this.config.agentMode || 'simple';\n    return mode;\n  }\n\n  /**\n   * Get fallback mode for an agent\n   */\n  private getFallbackMode(mode: AgentMode): AgentMode {\n    const fallbacks: Record<AgentMode, AgentMode> = {\n      cursor: 'claude-code',\n      'claude-code': 'openai-codex',\n      'openai-codex': 'simple',\n      simple: 'simple',\n    };\n\n    return fallbacks[mode];\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAa,oBAAb,MAA+B;CAC7B,AAAQ;CACR,AAAQ;CAER,YAAY,AAAQ,QAAgB;EAAhB;AAElB,OAAK,yBAAS,IAAI,KAAK;EAEvB,MAAM,cAAc,IAAI,YAAY,OAAO;EAC3C,MAAM,cAAc,IAAI,aAAa;EACrC,MAAM,cAAc,IAAI,iBAAiB;EACzC,MAAM,cAAc,IAAI,kBAAkB;AAE1C,OAAK,OAAO,IAAI,UAAU,YAAY;AACtC,OAAK,OAAO,IAAI,UAAU,YAAY;AACtC,OAAK,OAAO,IAAI,eAAe,YAAY;AAC3C,OAAK,OAAO,IAAI,gBAAgB,YAAY;AAE5C,OAAK,eAAe;;;;;CAMtB,MAAM,YAAY,MAAuC;EACvD,MAAM,YAAY,KAAK,cAAc;EACrC,MAAM,QAAQ,KAAK,OAAO,IAAI,UAAU;AAExC,MAAI,CAAC,OAAO;AACV,WAAQ,IACN,MAAM,OAAO,cAAc,UAAU,iCAAiC,CACvE;AACD,UAAO,KAAK,aAAa,SAAS,KAAK;;AAIzC,MAAI,CAAC,MAAM,UAAU,KAAK,EAAE;AAC1B,WAAQ,IACN,MAAM,OACJ,cAAc,UAAU,yDACzB,CACF;AACD,UAAO,KAAK,aAAa,SAAS,KAAK;;EAIzC,MAAM,UAAU,IAAI,kBAAkB,UAAU,WAAW,CAAC,OAAO;AAEnE,MAAI;GACF,MAAM,SACJ,KAAK,SAAS,aACV,MAAM,MAAM,SAAS,KAAK,GAC1B,MAAM,MAAM,SAAS,KAAK;AAEhC,OAAI,OAAO,SAAS;AAClB,YAAQ,QACN,MAAM,MAAM,GAAG,UAAU,+BAA+B,CACzD;AACD,WAAO;;AAIT,WAAQ,KACN,MAAM,OAAO,GAAG,UAAU,mCAAmC,CAC9D;GAED,MAAM,eAAe,KAAK,gBAAgB,UAAU;AACpD,OAAI,gBAAgB,iBAAiB,WAAW;IAC9C,MAAM,gBAAgB,KAAK,OAAO,IAAI,aAAa;AACnD,QAAI,iBAAiB,cAAc,UAAU,KAAK,CAChD,QAAO,KAAK,SAAS,aACjB,MAAM,cAAc,SAAS,KAAK,GAClC,MAAM,cAAc,SAAS,KAAK;;AAK1C,WAAQ,KAAK,MAAM,KAAK,0CAA0C,CAAC;AACnE,UAAO,KAAK,SAAS,aACjB,MAAM,KAAK,aAAa,SAAS,KAAK,GACtC,MAAM,KAAK,aAAa,SAAS,KAAK;WACnC,QAAQ;AACf,WAAQ,KAAK,MAAM,IAAI,yBAAyB,CAAC;AAGjD,WAAQ,IAAI,MAAM,KAAK,kCAAkC,CAAC;AAC1D,UAAO,KAAK,SAAS,aACjB,MAAM,KAAK,aAAa,SAAS,KAAK,GACtC,MAAM,KAAK,aAAa,SAAS,KAAK;;;;;;CAO9C,MAAM,SAAS,UAAkB,YAA2C;AAC1E,SAAO,KAAK,YAAY;GACtB,MAAM;GACN;GACA;GACD,CAAC;;;;;CAMJ,MAAM,cACJ,UACA,oBACsB;AACtB,SAAO,KAAK,YAAY;GACtB,MAAM;GACN;GACA,cAAc;GACf,CAAC;;;;;CAMJ,MAAM,SACJ,UACA,oBACsB;AACtB,SAAO,KAAK,YAAY;GACtB,MAAM;GACN;GACA,cAAc;GACf,CAAC;;;;;CAMJ,MAAM,SAAS,UAAkB,cAA4C;AAC3E,SAAO,KAAK,YAAY;GACtB,MAAM;GACN;GACA;GACD,CAAC;;;;;CAMJ,MAAM,qBAEJ;EACA,MAAM,UAAU,EAAE;AAElB,OAAK,MAAM,CAAC,MAAM,UAAU,KAAK,QAAQ;GAMvC,MAAM,YAAY,MAAM,UALI;IAC1B,MAAM;IACN,UAAU;IACX,CAE0C;AAE3C,WAAQ,KAAK;IACX;IACA,WAAW;IACX,QAAQ,YACJ,SACA;IACL,CAAC;;AAGJ,SAAO;;;;;CAMT,AAAQ,eAA0B;AAGhC,SADa,KAAK,OAAO,aAAa;;;;;CAOxC,AAAQ,gBAAgB,MAA4B;AAQlD,SAPgD;GAC9C,QAAQ;GACR,eAAe;GACf,gBAAgB;GAChB,QAAQ;GACT,CAEgB"}

package/dist/ai/agents/simple-agent.d.mts

@@ -0,0 +1,17 @@
+import { Config } from "../../types/config.mjs";
+import { AgentProvider, AgentResult, AgentTask } from "./types.mjs";
+
+//#region src/ai/agents/simple-agent.d.ts
+
+declare class SimpleAgent implements AgentProvider {
+  private config;
+  name: "simple";
+  constructor(config: Config);
+  canHandle(_task: AgentTask): boolean;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  private buildPrompt;
+}
+//#endregion
+export { SimpleAgent };
+//# sourceMappingURL=simple-agent.d.mts.map

package/dist/ai/agents/simple-agent.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-agent.d.mts","names":[],"sources":["../../../src/ai/agents/simple-agent.ts"],"sourcesContent":[],"mappings":";;;;;AAsBmB,cALN,WAAA,YAAuB,aAKjB,CAAA;EAKI,QAAA,MAAA;EAAoB,IAAA,EAAA,QAAA;EAAR,WAAA,CAAA,MAAA,EAPL,MAOK;EA4BZ,SAAA,CAAA,KAAA,EAjCJ,SAiCI,CAAA,EAAA,OAAA;EAAoB,QAAA,CAAA,IAAA,EA5BpB,SA4BoB,CAAA,EA5BR,OA4BQ,CA5BA,WA4BA,CAAA;EAAR,QAAA,CAAA,IAAA,EAAZ,SAAY,CAAA,EAAA,OAAA,CAAQ,WAAR,CAAA;EAtCC,QAAA,WAAA"}

package/dist/ai/agents/simple-agent.mjs

@@ -0,0 +1,92 @@
+import { getAIProvider } from "../providers.mjs";
+import { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt } from "../prompts/code-generation.mjs";
+import { generateText } from "ai";
+
+//#region src/ai/agents/simple-agent.ts
+/**
+* Simple LLM-based agent using direct API calls
+* This is the default fallback for basic code generation
+*/
+var SimpleAgent = class {
+	name = "simple";
+	constructor(config) {
+		this.config = config;
+	}
+	canHandle(_task) {
+		return true;
+	}
+	async generate(task) {
+		try {
+			const result = await generateText({
+				model: getAIProvider(this.config),
+				prompt: this.buildPrompt(task),
+				system: getCodeGenSystemPrompt()
+			});
+			return {
+				success: true,
+				code: result.text,
+				metadata: {
+					model: this.config.aiModel,
+					provider: this.config.aiProvider,
+					tokens: result.usage
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				errors: [error instanceof Error ? error.message : String(error)]
+			};
+		}
+	}
+	async validate(task) {
+		try {
+			const result = await generateText({
+				model: getAIProvider(this.config),
+				prompt: `
+Review the following implementation against its specification.
+
+Specification:
+${task.specCode}
+
+Implementation:
+${task.existingCode || "// No implementation provided"}
+
+Provide a detailed validation report:
+1. Does the implementation match the spec?
+2. Are there any missing features?
+3. Are there any bugs or issues?
+4. Suggestions for improvement
+`,
+				system: "You are a code review expert. Provide thorough, constructive feedback."
+			});
+			const hasErrors = result.text.toLowerCase().includes("error") || result.text.toLowerCase().includes("missing") || result.text.toLowerCase().includes("incorrect");
+			return {
+				success: !hasErrors,
+				code: result.text,
+				warnings: hasErrors ? ["Implementation may not match specification"] : [],
+				metadata: { validationType: "simple-llm" }
+			};
+		} catch (error) {
+			return {
+				success: false,
+				errors: [error instanceof Error ? error.message : String(error)]
+			};
+		}
+	}
+	buildPrompt(task) {
+		switch (task.type) {
+			case "generate":
+				if (task.specCode.includes(".operation.") || task.specCode.includes("kind:")) return buildHandlerPrompt(task.specCode);
+				else if (task.specCode.includes(".presentation.")) return buildComponentPrompt(task.specCode);
+				else if (task.specCode.includes(".form.")) return buildFormPrompt(task.specCode);
+				return `Generate implementation for:\n${task.specCode}`;
+			case "test": return buildTestPrompt(task.specCode, task.existingCode || "", "handler");
+			case "validate": return `Validate this implementation:\n${task.existingCode}`;
+			default: return task.specCode;
+		}
+	}
+};
+
+//#endregion
+export { SimpleAgent };
+//# sourceMappingURL=simple-agent.mjs.map

package/dist/ai/agents/simple-agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-agent.mjs","names":[],"sources":["../../../src/ai/agents/simple-agent.ts"],"sourcesContent":["/**\n * Simple LLM-based agent using direct API calls\n * This is the default fallback for basic code generation\n */\n\nimport { generateText } from 'ai';\nimport { getAIProvider } from '../providers';\nimport type { Config } from '../../types/config';\nimport type { AgentProvider, AgentResult, AgentTask } from './types';\nimport {\n  buildComponentPrompt,\n  buildFormPrompt,\n  buildHandlerPrompt,\n  buildTestPrompt,\n  getCodeGenSystemPrompt,\n} from '../prompts/code-generation';\n\nexport class SimpleAgent implements AgentProvider {\n  name = 'simple' as const;\n\n  constructor(private config: Config) {}\n\n  canHandle(_task: AgentTask): boolean {\n    // Simple agent can handle all tasks as a fallback\n    return true;\n  }\n\n  async generate(task: AgentTask): Promise<AgentResult> {\n    try {\n      const model = getAIProvider(this.config);\n      const prompt = this.buildPrompt(task);\n\n      const result = await generateText({\n        model,\n        prompt,\n        system: getCodeGenSystemPrompt(),\n      });\n\n      return {\n        success: true,\n        code: result.text,\n        metadata: {\n          model: this.config.aiModel,\n          provider: this.config.aiProvider,\n          tokens: result.usage,\n        },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errors: [error instanceof Error ? error.message : String(error)],\n      };\n    }\n  }\n\n  async validate(task: AgentTask): Promise<AgentResult> {\n    try {\n      const model = getAIProvider(this.config);\n\n      const prompt = `\nReview the following implementation against its specification.\n\nSpecification:\n${task.specCode}\n\nImplementation:\n${task.existingCode || '// No implementation provided'}\n\nProvide a detailed validation report:\n1. Does the implementation match the spec?\n2. Are there any missing features?\n3. Are there any bugs or issues?\n4. Suggestions for improvement\n`;\n\n      const result = await generateText({\n        model,\n        prompt,\n        system:\n          'You are a code review expert. Provide thorough, constructive feedback.',\n      });\n\n      // Parse validation result\n      const hasErrors =\n        result.text.toLowerCase().includes('error') ||\n        result.text.toLowerCase().includes('missing') ||\n        result.text.toLowerCase().includes('incorrect');\n\n      return {\n        success: !hasErrors,\n        code: result.text,\n        warnings: hasErrors\n          ? ['Implementation may not match specification']\n          : [],\n        metadata: {\n          validationType: 'simple-llm',\n        },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errors: [error instanceof Error ? error.message : String(error)],\n      };\n    }\n  }\n\n  private buildPrompt(task: AgentTask): string {\n    switch (task.type) {\n      case 'generate':\n        // Infer what to generate from spec\n        if (\n          task.specCode.includes('.operation.') ||\n          task.specCode.includes('kind:')\n        ) {\n          return buildHandlerPrompt(task.specCode);\n        } else if (task.specCode.includes('.presentation.')) {\n          return buildComponentPrompt(task.specCode);\n        } else if (task.specCode.includes('.form.')) {\n          return buildFormPrompt(task.specCode);\n        }\n        return `Generate implementation for:\\n${task.specCode}`;\n\n      case 'test':\n        return buildTestPrompt(\n          task.specCode,\n          task.existingCode || '',\n          'handler'\n        );\n\n      case 'validate':\n        return `Validate this implementation:\\n${task.existingCode}`;\n\n      default:\n        return task.specCode;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAiBA,IAAa,cAAb,MAAkD;CAChD,OAAO;CAEP,YAAY,AAAQ,QAAgB;EAAhB;;CAEpB,UAAU,OAA2B;AAEnC,SAAO;;CAGT,MAAM,SAAS,MAAuC;AACpD,MAAI;GAIF,MAAM,SAAS,MAAM,aAAa;IAChC,OAJY,cAAc,KAAK,OAAO;IAKtC,QAJa,KAAK,YAAY,KAAK;IAKnC,QAAQ,wBAAwB;IACjC,CAAC;AAEF,UAAO;IACL,SAAS;IACT,MAAM,OAAO;IACb,UAAU;KACR,OAAO,KAAK,OAAO;KACnB,UAAU,KAAK,OAAO;KACtB,QAAQ,OAAO;KAChB;IACF;WACM,OAAO;AACd,UAAO;IACL,SAAS;IACT,QAAQ,CAAC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;IACjE;;;CAIL,MAAM,SAAS,MAAuC;AACpD,MAAI;GAmBF,MAAM,SAAS,MAAM,aAAa;IAChC,OAnBY,cAAc,KAAK,OAAO;IAoBtC,QAlBa;;;;EAInB,KAAK,SAAS;;;EAGd,KAAK,gBAAgB,gCAAgC;;;;;;;;IAY/C,QACE;IACH,CAAC;GAGF,MAAM,YACJ,OAAO,KAAK,aAAa,CAAC,SAAS,QAAQ,IAC3C,OAAO,KAAK,aAAa,CAAC,SAAS,UAAU,IAC7C,OAAO,KAAK,aAAa,CAAC,SAAS,YAAY;AAEjD,UAAO;IACL,SAAS,CAAC;IACV,MAAM,OAAO;IACb,UAAU,YACN,CAAC,6CAA6C,GAC9C,EAAE;IACN,UAAU,EACR,gBAAgB,cACjB;IACF;WACM,OAAO;AACd,UAAO;IACL,SAAS;IACT,QAAQ,CAAC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;IACjE;;;CAIL,AAAQ,YAAY,MAAyB;AAC3C,UAAQ,KAAK,MAAb;GACE,KAAK;AAEH,QACE,KAAK,SAAS,SAAS,cAAc,IACrC,KAAK,SAAS,SAAS,QAAQ,CAE/B,QAAO,mBAAmB,KAAK,SAAS;aAC/B,KAAK,SAAS,SAAS,iBAAiB,CACjD,QAAO,qBAAqB,KAAK,SAAS;aACjC,KAAK,SAAS,SAAS,SAAS,CACzC,QAAO,gBAAgB,KAAK,SAAS;AAEvC,WAAO,iCAAiC,KAAK;GAE/C,KAAK,OACH,QAAO,gBACL,KAAK,UACL,KAAK,gBAAgB,IACrB,UACD;GAEH,KAAK,WACH,QAAO,kCAAkC,KAAK;GAEhD,QACE,QAAO,KAAK"}

package/dist/ai/agents/types.d.mts

@@ -0,0 +1,36 @@
+//#region src/ai/agents/types.d.ts
+/**
+ * Agent types and interfaces for code generation and validation
+ */
+type AgentMode = 'simple' | 'cursor' | 'claude-code' | 'openai-codex';
+interface AgentTask {
+  type: 'generate' | 'validate' | 'refactor' | 'test';
+  specCode: string;
+  existingCode?: string;
+  targetPath?: string;
+  options?: Record<string, unknown>;
+}
+interface AgentResult {
+  success: boolean;
+  code?: string;
+  errors?: string[];
+  warnings?: string[];
+  suggestions?: string[];
+  metadata?: Record<string, unknown>;
+}
+interface AgentProvider {
+  name: AgentMode;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  canHandle(task: AgentTask): boolean;
+}
+interface AgentConfig {
+  mode: AgentMode;
+  fallbackMode?: AgentMode;
+  timeout?: number;
+  retries?: number;
+  options?: Record<string, unknown>;
+}
+//#endregion
+export { AgentConfig, AgentMode, AgentProvider, AgentResult, AgentTask };
+//# sourceMappingURL=types.d.mts.map

package/dist/ai/agents/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/ai/agents/types.ts"],"sourcesContent":[],"mappings":";;AAIA;AAEA;AAQiB,KAVL,SAAA,GAUgB,QAMf,GAAA,QAAM,GAAA,aAAA,GAAA,cAAA;AAGF,UAjBA,SAAA,CAiBa;EACtB,IAAA,EAAA,UAAA,GAAA,UAAA,GAAA,UAAA,GAAA,MAAA;EACS,QAAA,EAAA,MAAA;EAAoB,YAAA,CAAA,EAAA,MAAA;EAAR,UAAA,CAAA,EAAA,MAAA;EACZ,OAAA,CAAA,EAfL,MAeK,CAAA,MAAA,EAAA,OAAA,CAAA;;AAAY,UAZZ,WAAA,CAYY;EACX,OAAA,EAAA,OAAA;EAAS,IAAA,CAAA,EAAA,MAAA;EAGV,MAAA,CAAA,EAAA,MAAW,EAAA;EACpB,QAAA,CAAA,EAAA,MAAA,EAAA;EACS,WAAA,CAAA,EAAA,MAAA,EAAA;EAGL,QAAA,CAAA,EAfC,MAeD,CAAA,MAAA,EAAA,OAAA,CAAA;;UAZK,aAAA;QACT;iBACS,YAAY,QAAQ;iBACpB,YAAY,QAAQ;kBACnB;;UAGD,WAAA;QACT;iBACS;;;YAGL"}

package/dist/ai/client.d.mts

@@ -0,0 +1,97 @@
+import { Config } from "../types/config.mjs";
+import { OpKind, PresentationKind } from "../types.mjs";
+
+//#region src/ai/client.d.ts
+
+/**
+ * AI Client for spec creation and code generation
+ */
+declare class AIClient {
+  private config;
+  constructor(config: Config);
+  /**
+   * Generate operation spec from natural language description
+   */
+  generateOperationSpec(description: string, kind: OpKind): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    goal: string;
+    context: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    auth: "anonymous" | "user" | "admin";
+    inputShape: string;
+    outputShape: string;
+    flags: string[];
+    possibleEvents: string[];
+    analytics: string[];
+  }>;
+  /**
+   * Generate event spec from description
+   */
+  generateEventSpec(description: string): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    payloadShape: string;
+    piiFields: string[];
+  }>;
+  /**
+   * Generate presentation spec from description
+   */
+  generatePresentationSpec(description: string, kind: PresentationKind): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    componentKey?: string | undefined;
+    propsShape?: string | undefined;
+    content?: string | undefined;
+    mimeType?: string | undefined;
+    dataShape?: string | undefined;
+  }>;
+  /**
+   * Generate handler implementation from spec
+   */
+  generateHandler(specCode: string): Promise<string>;
+  /**
+   * Generate React component from presentation spec
+   */
+  generateComponent(specCode: string): Promise<string>;
+  /**
+   * Generate form component from form spec
+   */
+  generateForm(specCode: string): Promise<string>;
+  /**
+   * Generate tests for implementation
+   */
+  generateTests(specCode: string, implementationCode: string, testType: 'handler' | 'component'): Promise<string>;
+  /**
+   * Stream code generation for better UX
+   */
+  streamCodeGeneration(prompt: string, onChunk: (text: string) => void): Promise<string>;
+  /**
+   * Chat with the AI model
+   */
+  chat(messages: {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+  }[], system?: string): Promise<string>;
+  /**
+   * Stream chat with the AI model
+   */
+  streamChat(messages: {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+  }[], onChunk: (text: string) => void, system?: string): Promise<string>;
+}
+//#endregion
+export { AIClient };
+//# sourceMappingURL=client.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../../src/ai/client.ts"],"sourcesContent":[],"mappings":";;;;;;;AAsBA;AAC8B,cADjB,QAAA,CACiB;EAK2B,QAAA,MAAA;EAAM,WAAA,CAAA,MAAA,EALjC,MAKiC;EA6ClB;;;EAiEF,qBAAA,CAAA,WAAA,EAAA,MAAA,EAAA,IAAA,EA9Gc,MA8Gd,CAAA,EA9GoB,OA8GpB,CAAA;IAeE,IAAA,EAAA,MAAA;IAeL,OAAA,EAAA,MAAA;IAmBnC,WAAA,EAAA,MAAA;IAkBA,IAAA,EAAA,MAAA;IAyBA,OAAA,EAAA,MAAA;IAmBA,SAAA,EAAA,cAAA,GAAA,MAAA,GAAA,QAAA,GAAA,YAAA;IAAO,MAAA,EAAA,MAAA,EAAA;;;;;;;;;;;;0CAhLiC;;;;;;;;;;;;;sDA+Be,mBAAgB;;;;;;;;;;;;;;;;qCAkCjC;;;;uCAeE;;;;kCAeL;;;;kGAmBnC;;;;yEAkBA;;;;;;;yBAyBA;;;;;;;0DAmBA"}