openplanr 0.1.0 → 0.3.0

package/dist/ai/prompts/system-prompts.js

@@ -0,0 +1,124 @@
+/**
+ * Expert system prompts for AI-powered agile planning.
+ *
+ * Each prompt establishes the AI as a specialized agile consultant
+ * and instructs it to produce structured JSON output matching our
+ * artifact schemas.
+ */
+const BASE_PERSONA = `You are an expert agile planning consultant with deep experience in software development, product management, and technical architecture. You help teams create clear, actionable, and well-structured planning artifacts.`;
+export const EPIC_SYSTEM_PROMPT = `${BASE_PERSONA}
+
+Your task is to expand a brief description into a complete, detailed epic document.
+
+You MUST respond with a valid JSON object containing these fields:
+- "title": A concise, descriptive epic title (max 80 chars)
+- "owner": The responsible team or role (e.g., "Engineering", "Product", "Platform Team")
+- "businessValue": Why this matters to the business (2-3 sentences)
+- "targetUsers": Who benefits from this (specific user personas)
+- "problemStatement": The problem being solved (2-3 sentences)
+- "solutionOverview": High-level approach to solving it (2-3 sentences)
+- "successCriteria": Array of 3-5 measurable definition-of-done bullet points (e.g., ["Users can X within Y seconds", "System supports Z"])
+- "keyFeatures": Array of 3-7 high-level feature names that compose this epic
+- "dependencies": Known dependencies or "None"
+- "risks": Known risks or "None"
+
+Be specific, avoid generic filler. Ground the epic in the user's brief.
+Respond with JSON only, no markdown or explanation.`;
+export const FEATURES_SYSTEM_PROMPT = `${BASE_PERSONA}
+
+Your task is to decompose an epic into individual features. Read the epic carefully and generate features that fully cover its scope.
+
+You MUST respond with a valid JSON object containing:
+- "features": An array of feature objects, each with:
+  - "title": A clear feature title (max 80 chars)
+  - "overview": What this feature does (2-3 sentences)
+  - "functionalRequirements": Array of 3-6 specific functional requirements
+  - "dependencies": Dependencies on other features or systems, or "None"
+  - "technicalConsiderations": Technical notes for implementation, or "None"
+  - "risks": Feature-specific risks, or "None"
+  - "successMetrics": How to measure success of this feature
+
+Generate features that are:
+- Independently deliverable where possible
+- Roughly equal in scope
+- Non-overlapping (no duplicate functionality)
+
+Respond with JSON only, no markdown or explanation.`;
+export const STORIES_SYSTEM_PROMPT = `${BASE_PERSONA}
+
+Your task is to break a feature into user stories. Read the feature and its parent epic context carefully.
+
+You MUST respond with a valid JSON object containing:
+- "stories": An array of story objects, each with:
+  - "title": Concise story title (max 80 chars)
+  - "role": The user role ("As a <role>")
+  - "goal": What they want to do ("I want to <goal>")
+  - "benefit": Why ("So that <benefit>")
+  - "additionalNotes": Implementation notes or edge cases (optional, can be empty string)
+  - "gherkinScenarios": Array of scenario objects, each with:
+    - "name": Scenario name
+    - "given": Given precondition
+    - "when": When action
+    - "then": Then expected outcome
+
+Each story should:
+- Follow INVEST principles (Independent, Negotiable, Valuable, Estimable, Small, Testable)
+- Include 1-3 Gherkin scenarios (happy path + edge cases)
+- Be specific enough for a developer to implement
+
+Respond with JSON only, no markdown or explanation.`;
+export const TASKS_SYSTEM_PROMPT = `${BASE_PERSONA}
+
+Your task is to generate a comprehensive implementation task list from agile artifacts (user stories, gherkin acceptance criteria, feature specs, epic context, ADRs, and codebase context).
+
+You MUST respond with a valid JSON object containing:
+- "title": A task list title — use the scope ID if provided (e.g., "Tasks for FEAT-001: Feature Name" when scope is a feature, or "Tasks for US-001: Story Name" when scope is a story)
+- "tasks": An array of task group objects, each with:
+  - "id": Numbering like "1.0", "2.0", "3.0"
+  - "title": Task group title
+  - "subtasks": Array of subtask objects, each with:
+    - "id": Numbering like "1.1", "1.2", "2.1"
+    - "title": Specific, actionable subtask description
+- "acceptanceCriteriaMapping": Array of objects mapping acceptance criteria to tasks:
+  - "criterion": The acceptance criterion text (from gherkin scenarios or story requirements)
+  - "sourceStoryId": Which user story this criterion comes from (e.g., "US-001")
+  - "taskIds": Array of task/subtask IDs that satisfy this criterion (e.g., ["1.1", "2.3"])
+- "relevantFiles": Array of files to create or modify:
+  - "path": File path relative to project root (e.g., "src/auth/login.ts")
+  - "reason": Brief explanation of why this file needs changes
+
+Tasks should:
+- Reference actual files/paths from the codebase when possible
+- Follow existing code patterns and conventions
+- Include setup, implementation, testing, and cleanup steps
+- Be ordered logically (dependencies first)
+- Address specific acceptance criteria from gherkin scenarios
+- Respect architectural decisions from ADRs when provided
+- Align with component structure and system architecture
+
+When multiple user stories and gherkin scenarios are provided, ensure every acceptance criterion is covered by at least one task. When codebase context is available, identify specific files to modify in relevantFiles.
+
+Respond with JSON only, no markdown or explanation.`;
+export const REFINE_SYSTEM_PROMPT = `${BASE_PERSONA}
+
+Your task is to review and improve an existing agile artifact. Analyze the content and suggest improvements for:
+- Clarity and specificity
+- Missing details or edge cases
+- Consistency with agile best practices
+- Technical accuracy
+
+You MUST respond with a valid JSON object containing:
+- "suggestions": Array of improvement suggestions (strings)
+- "improved": The improved artifact data as a JSON object with the same fields as the original frontmatter
+- "improvedMarkdown": A raw markdown string that will be written directly to a .md file. It MUST preserve the original file format: YAML frontmatter between --- delimiters followed by the markdown body. Do NOT put JSON in this field.
+
+CRITICAL: The "improvedMarkdown" field must be a plain markdown string, NOT a JSON object. It should look exactly like the original artifact the user provided, but with improvements applied. For example, if the original starts with:
+---
+id: "EPIC-001"
+title: "My Epic"
+---
+# EPIC-001: My Epic
+...then "improvedMarkdown" must also start with --- frontmatter and contain markdown content. Keep the same structure and sections as the original.
+
+Respond with JSON only, no markdown or explanation.`;
+//# sourceMappingURL=system-prompts.js.map

package/dist/ai/prompts/system-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompts.js","sourceRoot":"","sources":["../../../src/ai/prompts/system-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,YAAY,GAAG,4NAA4N,CAAC;AAElP,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;oDAiBG,CAAC;AAErD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;;;oDAmBD,CAAC;AAErD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;oDAsBA,CAAC;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oDA+BE,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;oDAqBC,CAAC"}

package/dist/ai/provider-factory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Factory for creating AI provider instances.
+ *
+ * Uses dynamic imports to lazy-load SDK dependencies — the heavy
+ * @anthropic-ai/sdk and openai packages are only loaded when AI
+ * features are actually invoked.
+ */
+import type { AIProvider, AIProviderConfig } from './types.js';
+export declare function createAIProvider(config: AIProviderConfig): Promise<AIProvider>;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/ai/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/ai/provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG/D,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmCpF"}

package/dist/ai/provider-factory.js

@@ -0,0 +1,33 @@
+/**
+ * Factory for creating AI provider instances.
+ *
+ * Uses dynamic imports to lazy-load SDK dependencies — the heavy
+ * @anthropic-ai/sdk and openai packages are only loaded when AI
+ * features are actually invoked.
+ */
+import { AIError } from './errors.js';
+export async function createAIProvider(config) {
+    switch (config.provider) {
+        case 'anthropic': {
+            if (!config.apiKey) {
+                throw new AIError('Anthropic API key is required. Run `planr config set-key anthropic` or set ANTHROPIC_API_KEY.', 'auth');
+            }
+            const { AnthropicProvider } = await import('./providers/anthropic-provider.js');
+            return new AnthropicProvider(config.apiKey, config.model);
+        }
+        case 'openai': {
+            if (!config.apiKey) {
+                throw new AIError('OpenAI API key is required. Run `planr config set-key openai` or set OPENAI_API_KEY.', 'auth');
+            }
+            const { OpenAIProvider } = await import('./providers/openai-provider.js');
+            return new OpenAIProvider(config.apiKey, config.model, config.baseUrl);
+        }
+        case 'ollama': {
+            const { OllamaProvider } = await import('./providers/ollama-provider.js');
+            return new OllamaProvider(config.model, config.baseUrl);
+        }
+        default:
+            throw new AIError(`Unknown AI provider: ${config.provider}. Supported: anthropic, openai, ollama.`, 'unknown');
+    }
+}
+//# sourceMappingURL=provider-factory.js.map

package/dist/ai/provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.js","sourceRoot":"","sources":["../../src/ai/provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwB;IAC7D,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,IAAI,OAAO,CACf,+FAA+F,EAC/F,MAAM,CACP,CAAC;YACJ,CAAC;YACD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAChF,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,IAAI,OAAO,CACf,sFAAsF,EACtF,MAAM,CACP,CAAC;YACJ,CAAC;YACD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAC1E,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACzE,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAC1E,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QAED;YACE,MAAM,IAAI,OAAO,CACf,wBAAwB,MAAM,CAAC,QAAQ,yCAAyC,EAChF,SAAS,CACV,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/ai/providers/anthropic-provider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Anthropic Claude provider implementation.
+ *
+ * Uses the official @anthropic-ai/sdk with streaming support.
+ * Lazily imported to avoid loading the SDK until actually needed.
+ */
+import type { AIProvider, AIMessage, AIRequestOptions, AIProviderName } from '../types.js';
+export declare class AnthropicProvider implements AIProvider {
+    readonly name: AIProviderName;
+    readonly model: string;
+    private clientPromise;
+    constructor(apiKey: string, model?: string);
+    private initClient;
+    chat(messages: AIMessage[], options?: AIRequestOptions): AsyncIterable<string>;
+    chatSync(messages: AIMessage[], options?: AIRequestOptions): Promise<string>;
+    /**
+     * Anthropic's API uses a separate `system` parameter rather than
+     * a system role in the messages array.
+     */
+    private splitSystemMessage;
+}
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/ai/providers/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3F,qBAAa,iBAAkB,YAAW,UAAU;IAClD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAe;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,aAAa,CAAoE;gBAE7E,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;YAK5B,UAAU;IAKjB,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC;IA6B/E,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BlF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/ai/providers/anthropic-provider.js

@@ -0,0 +1,82 @@
+/**
+ * Anthropic Claude provider implementation.
+ *
+ * Uses the official @anthropic-ai/sdk with streaming support.
+ * Lazily imported to avoid loading the SDK until actually needed.
+ */
+import { wrapProviderError } from '../errors.js';
+export class AnthropicProvider {
+    name = 'anthropic';
+    model;
+    clientPromise;
+    constructor(apiKey, model) {
+        this.model = model || 'claude-sonnet-4-20250514';
+        this.clientPromise = this.initClient(apiKey);
+    }
+    async initClient(apiKey) {
+        const { default: Anthropic } = await import('@anthropic-ai/sdk');
+        return new Anthropic({ apiKey });
+    }
+    async *chat(messages, options) {
+        const client = await this.clientPromise;
+        const { system, userMessages } = this.splitSystemMessage(messages);
+        try {
+            const stream = client.messages.stream({
+                model: this.model,
+                max_tokens: options?.maxTokens || 4096,
+                temperature: options?.temperature ?? 0.7,
+                system: system || undefined,
+                messages: userMessages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+            });
+            for await (const event of stream) {
+                if (event.type === 'content_block_delta' &&
+                    event.delta.type === 'text_delta') {
+                    yield event.delta.text;
+                }
+            }
+        }
+        catch (err) {
+            throw wrapProviderError(err, 'anthropic');
+        }
+    }
+    async chatSync(messages, options) {
+        const client = await this.clientPromise;
+        const { system, userMessages } = this.splitSystemMessage(messages);
+        try {
+            const response = await client.messages.create({
+                model: this.model,
+                max_tokens: options?.maxTokens || 4096,
+                temperature: options?.temperature ?? 0.7,
+                system: system || undefined,
+                messages: userMessages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+            });
+            return response.content
+                .filter((block) => block.type === 'text')
+                .map((block) => {
+                if (block.type === 'text')
+                    return block.text;
+                return '';
+            })
+                .join('');
+        }
+        catch (err) {
+            throw wrapProviderError(err, 'anthropic');
+        }
+    }
+    /**
+     * Anthropic's API uses a separate `system` parameter rather than
+     * a system role in the messages array.
+     */
+    splitSystemMessage(messages) {
+        const systemMsg = messages.find((m) => m.role === 'system');
+        const userMessages = messages.filter((m) => m.role !== 'system');
+        return { system: systemMsg?.content ?? null, userMessages };
+    }
+}
+//# sourceMappingURL=anthropic-provider.js.map

package/dist/ai/providers/anthropic-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.js","sourceRoot":"","sources":["../../../src/ai/providers/anthropic-provider.ts"],"names":[],"mappings":"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"}

package/dist/ai/providers/ollama-provider.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ollama provider implementation.
+ *
+ * Ollama exposes an OpenAI-compatible REST API, so we extend the OpenAI
+ * provider with a custom base URL and a dummy API key.
+ */
+import type { AIProviderName } from '../types.js';
+import { OpenAIProvider } from './openai-provider.js';
+export declare class OllamaProvider extends OpenAIProvider {
+    readonly name: AIProviderName;
+    constructor(model?: string, baseUrl?: string);
+}
+//# sourceMappingURL=ollama-provider.d.ts.map

package/dist/ai/providers/ollama-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/ollama-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,qBAAa,cAAe,SAAQ,cAAc;IAChD,SAAkB,IAAI,EAAE,cAAc,CAAY;gBAEtC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAO7C"}

package/dist/ai/providers/ollama-provider.js

@@ -0,0 +1,16 @@
+/**
+ * Ollama provider implementation.
+ *
+ * Ollama exposes an OpenAI-compatible REST API, so we extend the OpenAI
+ * provider with a custom base URL and a dummy API key.
+ */
+import { OpenAIProvider } from './openai-provider.js';
+const DEFAULT_OLLAMA_URL = 'http://localhost:11434/v1';
+export class OllamaProvider extends OpenAIProvider {
+    name = 'ollama';
+    constructor(model, baseUrl) {
+        super('ollama', // Ollama doesn't require an API key
+        model || 'llama3.1', baseUrl || DEFAULT_OLLAMA_URL);
+    }
+}
+//# sourceMappingURL=ollama-provider.js.map

package/dist/ai/providers/ollama-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-provider.js","sourceRoot":"","sources":["../../../src/ai/providers/ollama-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAEvD,MAAM,OAAO,cAAe,SAAQ,cAAc;IAC9B,IAAI,GAAmB,QAAQ,CAAC;IAElD,YAAY,KAAc,EAAE,OAAgB;QAC1C,KAAK,CACH,QAAQ,EAAE,oCAAoC;QAC9C,KAAK,IAAI,UAAU,EACnB,OAAO,IAAI,kBAAkB,CAC9B,CAAC;IACJ,CAAC;CACF"}

package/dist/ai/providers/openai-provider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * OpenAI provider implementation.
+ *
+ * Uses the official openai SDK with streaming and JSON mode support.
+ * Also serves as the base for the Ollama provider (OpenAI-compatible API).
+ */
+import type { AIProvider, AIMessage, AIRequestOptions, AIProviderName } from '../types.js';
+export declare class OpenAIProvider implements AIProvider {
+    readonly name: AIProviderName;
+    readonly model: string;
+    protected clientPromise: Promise<InstanceType<typeof import('openai').default>>;
+    constructor(apiKey: string, model?: string, baseUrl?: string);
+    private initClient;
+    chat(messages: AIMessage[], options?: AIRequestOptions): AsyncIterable<string>;
+    chatSync(messages: AIMessage[], options?: AIRequestOptions): Promise<string>;
+}
+//# sourceMappingURL=openai-provider.d.ts.map

package/dist/ai/providers/openai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/openai-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3F,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAY;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,YAAY,CAAC,cAAc,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;gBAEpE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;YAK9C,UAAU;IAKjB,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC;IAsB/E,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAiBnF"}

package/dist/ai/providers/openai-provider.js

@@ -0,0 +1,58 @@
+/**
+ * OpenAI provider implementation.
+ *
+ * Uses the official openai SDK with streaming and JSON mode support.
+ * Also serves as the base for the Ollama provider (OpenAI-compatible API).
+ */
+import { wrapProviderError } from '../errors.js';
+export class OpenAIProvider {
+    name = 'openai';
+    model;
+    clientPromise;
+    constructor(apiKey, model, baseUrl) {
+        this.model = model || 'gpt-4o';
+        this.clientPromise = this.initClient(apiKey, baseUrl);
+    }
+    async initClient(apiKey, baseUrl) {
+        const { default: OpenAI } = await import('openai');
+        return new OpenAI({ apiKey, baseURL: baseUrl });
+    }
+    async *chat(messages, options) {
+        const client = await this.clientPromise;
+        try {
+            const stream = await client.chat.completions.create({
+                model: this.model,
+                stream: true,
+                temperature: options?.temperature ?? 0.7,
+                max_tokens: options?.maxTokens || 4096,
+                messages: messages.map((m) => ({ role: m.role, content: m.content })),
+                ...(options?.jsonMode && { response_format: { type: 'json_object' } }),
+            });
+            for await (const chunk of stream) {
+                const delta = chunk.choices[0]?.delta?.content;
+                if (delta)
+                    yield delta;
+            }
+        }
+        catch (err) {
+            throw wrapProviderError(err, this.name);
+        }
+    }
+    async chatSync(messages, options) {
+        const client = await this.clientPromise;
+        try {
+            const response = await client.chat.completions.create({
+                model: this.model,
+                temperature: options?.temperature ?? 0.7,
+                max_tokens: options?.maxTokens || 4096,
+                messages: messages.map((m) => ({ role: m.role, content: m.content })),
+                ...(options?.jsonMode && { response_format: { type: 'json_object' } }),
+            });
+            return response.choices[0]?.message?.content || '';
+        }
+        catch (err) {
+            throw wrapProviderError(err, this.name);
+        }
+    }
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/ai/providers/openai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.js","sourceRoot":"","sources":["../../../src/ai/providers/openai-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,OAAO,cAAc;IAChB,IAAI,GAAmB,QAAQ,CAAC;IAChC,KAAK,CAAS;IAEb,aAAa,CAAyD;IAEhF,YAAY,MAAc,EAAE,KAAc,EAAE,OAAgB;QAC1D,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,QAAQ,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAAgB;QACvD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,CAAC,IAAI,CAAC,QAAqB,EAAE,OAA0B;QAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC;QAExC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;gBAClD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI;gBACZ,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,GAAG;gBACxC,UAAU,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;gBACtC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrE,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,aAAsB,EAAE,EAAE,CAAC;aAChF,CAAC,CAAC;YAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC;gBAC/C,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAqB,EAAE,OAA0B;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC;QAExC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;gBACpD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,GAAG;gBACxC,UAAU,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;gBACtC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrE,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,aAAsB,EAAE,EAAE,CAAC;aAChF,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF"}