@specverse/engines 5.1.0 → 6.0.0

package/dist/ai/index.js

@@ -1,32 +1,52 @@
 /**
- * SpecVerse AI Module
- * Main export point for all AI functionality
+ * SpecVerse AI Module — public surface.
+ *
+ * Post AI-SDK replatform (2026-04, engines 6.0):
+ *   - Provider abstraction is Vercel AI SDK (`ai` + `@ai-sdk/*`).
+ *   - SpecVerse-specific: model-resolver picks claude-cli | anthropic |
+ *     openai-compatible | stub based on SPECVERSE_AI_PROVIDER.
+ *   - Behaviour generation at realize time delegates to generateText()
+ *     through the resolved model; skill-aware system-prompt assembly.
+ *
+ * What was removed in 6.0:
+ *   - LLMProvider, LLMProviderRegistry, ProviderFactory
+ *   - OpenAIProvider, AnthropicProvider, InteractiveProvider
+ *   - SpecVerseOrchestrator, InteractiveWorkflow (dead code, no consumers)
+ *   - ConfigLoader / SpecVerseConfig (consumed only by the orchestrator)
+ *   - config-loader.ts (no consumers)
+ * Consumers on those APIs should migrate to resolveModel() + generateText()
+ * from 'ai'. See docs/guides/SPECVERSE-AI.md.
  */
+// Commands — prompt-text generators for `spv ai {enhance,fill,suggest,template}`.
 export * from './commands/index.js';
+// Ecosystem prompt manager — used internally by enhance/suggest to surface
+// library hints.
 export * from './core/ecosystem-prompt-manager.js';
+// Types.
 export * from './types/index.js';
-export * from './config-loader.js';
+// Sessions — tracked job queue for multi-step spec generation.
 export { SessionManager } from './session/session-manager.js';
-// Behavior AI service — session-based Claude conversation for realize-time code generation
+// Behaviour generation — session-aware, provider-agnostic LLM call for
+// unmatched behavior steps. Used by ai-behaviors-generator at realize time.
 export { BehaviorAIService } from './behavior-ai-service.js';
 // Regenerate a single owner's AI behaviors file on demand.
 // Used by `specverse ai regenerate <Owner.fn>`.
 export { regenerateBehavior } from './behavior-regenerate.js';
-// Providers — LLM execution layer
-export { LLMProvider, LLMProviderRegistry } from './providers/llm-provider.js';
-export { ProviderFactory } from './providers/provider-factory.js';
-export { OpenAIProvider } from './providers/openai-provider.js';
-export { AnthropicProvider } from './providers/anthropic-provider.js';
-export { InteractiveProvider } from './providers/interactive-provider.js';
-// Orchestrator — multi-step workflow engine
-export { SpecVerseOrchestrator } from './orchestrator/specverse-orchestrator.js';
-export { InteractiveWorkflow } from './orchestrator/interactive-workflow.js';
-// Config — provider and workflow configuration
-export { ConfigLoader, configLoader } from './config/index.js';
+// Model resolver — pick a LanguageModelV3 from SPECVERSE_AI_PROVIDER env.
+export { resolveModel, resolveProviderId, describeActiveProvider } from './model-resolver.js';
+// Custom providers — thin wrappers around claude CLI and no-op stub. Most
+// consumers should use resolveModel() rather than calling these directly.
+export { claudeCli, isClaudeCliAvailable, detectClaudePath } from './providers/claude-cli.js';
+export { stubModel } from './providers/stub.js';
+// Skill detection — true if the SpecVerse skill is installed in a location
+// Claude Code will auto-load. Used by behavior-ai-service to decide whether
+// to skip the fullContext block in the system prompt.
+export { detectInstalledSkill } from './skill-detection.js';
+import { BehaviorAIService } from './behavior-ai-service.js';
 class SpecVerseAIEngine {
     name = 'ai';
-    version = '3.5.2';
-    capabilities = ['ai-prompts', 'ai-suggestions', 'ai-templates', 'ai-orchestration', 'ai-execution'];
+    version = '6.0.0';
+    capabilities = ['ai-prompts', 'ai-suggestions', 'ai-templates', 'ai-behaviour'];
     manager = null;
     async initialize(config) {
         try {
@@ -52,7 +72,6 @@ class SpecVerseAIEngine {
             if (component.description)
                 lines.push(`\n${component.description}`);
             lines.push('');
-            // Models
             const models = component.models || [];
             if (models.length > 0) {
                 lines.push(`### Models (${models.length})`);
@@ -81,7 +100,6 @@ class SpecVerseAIEngine {
                     lines.push('');
                 }
             }
-            // Controllers
             const controllers = component.controllers || [];
             if (controllers.length > 0) {
                 lines.push(`### Controllers (${controllers.length})`);
@@ -90,7 +108,6 @@ class SpecVerseAIEngine {
                 }
                 lines.push('');
             }
-            // Services
             const services = component.services || [];
             if (services.length > 0) {
                 lines.push(`### Services (${services.length})`);
@@ -104,7 +121,6 @@ class SpecVerseAIEngine {
                 }
                 lines.push('');
             }
-            // Events
             const events = component.events || [];
             if (events.length > 0) {
                 lines.push(`### Events (${events.length})`);
@@ -117,7 +133,7 @@ class SpecVerseAIEngine {
         lines.push('## Implementation Guidelines');
         lines.push('');
         lines.push('1. Create database models matching the attribute and relationship specifications');
-        lines.push('2. Implement CRUD controllers for each controller listed');
+        lines.push('2. Implement CURVED controllers for each controller listed');
         lines.push('3. Add service methods as specified, with proper error handling');
         lines.push('4. Wire event handlers for cross-model communication');
         lines.push('5. Follow the relationship types: belongsTo (FK on this model), hasMany (FK on related model), hasOne, manyToMany');
@@ -130,15 +146,11 @@ class SpecVerseAIEngine {
     }
     /**
      * Generate a TypeScript function body for an unmatched behavior step.
-     * Delegates to BehaviorAIService which holds a session-based conversation
-     * with Claude (mirrors app-demo's runtime AI guard generation).
-     *
-     * For best results, callers should reuse the same BehaviorAIService instance
-     * across multiple steps in a controller — the conversation accumulates context.
+     * Delegates to BehaviorAIService which resolves the active provider
+     * (claude-cli / anthropic / openai-compatible / stub) based on env.
      */
     async generateBehavior(step, context) {
         try {
-            const { BehaviorAIService } = await import('./behavior-ai-service.js');
             const service = new BehaviorAIService();
             if (!service.isAvailable)
                 return null;
@@ -186,7 +198,6 @@ class SpecVerseAIEngine {
             return lines.join('\n');
         }
         catch (error) {
-            // Template loading failed (prompts not available) — return a useful default
             return `# Template: ${operation}\n\nPrompt templates are not available. Install prompts with: specverse init\n\nError: ${error instanceof Error ? error.message : String(error)}`;
         }
     }

package/dist/ai/index.js.map

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

package/dist/ai/model-resolver.d.ts

@@ -0,0 +1,13 @@
+import type { LanguageModelV3 } from '@ai-sdk/provider';
+export type ProviderId = 'claude-cli' | 'anthropic' | 'openai-compatible' | 'stub';
+/** Return the configured provider id, resolving defaults if unset. */
+export declare function resolveProviderId(): ProviderId;
+export interface ResolveModelOptions {
+    /** Model name override; if omitted, picks a sensible provider default. */
+    model?: string;
+}
+/** Resolve an AI SDK v3 LanguageModel based on environment + options. */
+export declare function resolveModel(options?: ResolveModelOptions): LanguageModelV3;
+/** Best-effort diagnostic description of the active provider + model. */
+export declare function describeActiveProvider(): string;
+//# sourceMappingURL=model-resolver.d.ts.map

package/dist/ai/model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/ai/model-resolver.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAEnF,sEAAsE;AACtE,wBAAgB,iBAAiB,IAAI,UAAU,CAc9C;AAED,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,eAAe,CAwC/E;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,IAAI,MAAM,CAc/C"}

package/dist/ai/model-resolver.js

@@ -0,0 +1,87 @@
+/**
+ * Model resolver — picks the right LanguageModel implementation based on
+ * environment configuration. One call site, four providers:
+ *
+ *   SPECVERSE_AI_PROVIDER=claude-cli          Max user, spawns claude --print
+ *   SPECVERSE_AI_PROVIDER=anthropic           API-keyed Claude (metered)
+ *   SPECVERSE_AI_PROVIDER=openai-compatible   DeepSeek/Groq/Together/Ollama/etc.
+ *   SPECVERSE_AI_PROVIDER=stub                No LLM; emit prompt for ambient executor
+ *
+ * Defaults:
+ *   - Inside an MCP server context (MCP_SERVER=1) → stub
+ *   - Claude CLI available on PATH → claude-cli
+ *   - ANTHROPIC_API_KEY set → anthropic
+ *   - Else → stub (with a clear diagnostic comment)
+ */
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { claudeCli, isClaudeCliAvailable } from './providers/claude-cli.js';
+import { stubModel } from './providers/stub.js';
+/** Return the configured provider id, resolving defaults if unset. */
+export function resolveProviderId() {
+    const explicit = process.env.SPECVERSE_AI_PROVIDER;
+    if (explicit) {
+        if (['claude-cli', 'anthropic', 'openai-compatible', 'stub'].includes(explicit)) {
+            return explicit;
+        }
+        throw new Error(`SPECVERSE_AI_PROVIDER="${explicit}" is not recognized. Use one of: claude-cli, anthropic, openai-compatible, stub.`);
+    }
+    if (process.env.MCP_SERVER === '1')
+        return 'stub';
+    if (isClaudeCliAvailable())
+        return 'claude-cli';
+    if (process.env.ANTHROPIC_API_KEY)
+        return 'anthropic';
+    return 'stub';
+}
+/** Resolve an AI SDK v3 LanguageModel based on environment + options. */
+export function resolveModel(options = {}) {
+    const provider = resolveProviderId();
+    const modelOverride = options.model ?? process.env.SPECVERSE_AI_MODEL;
+    switch (provider) {
+        case 'claude-cli':
+            return claudeCli({ model: modelOverride });
+        case 'anthropic': {
+            const apiKey = process.env.ANTHROPIC_API_KEY;
+            if (!apiKey) {
+                throw new Error('SPECVERSE_AI_PROVIDER=anthropic requires ANTHROPIC_API_KEY. ' +
+                    'Set it or pick a different provider (claude-cli, openai-compatible, stub).');
+            }
+            const anthropic = createAnthropic({ apiKey });
+            return anthropic(modelOverride ?? 'claude-3-5-sonnet-latest');
+        }
+        case 'openai-compatible': {
+            const baseURL = process.env.SPECVERSE_AI_BASE_URL;
+            if (!baseURL) {
+                throw new Error('SPECVERSE_AI_PROVIDER=openai-compatible requires SPECVERSE_AI_BASE_URL ' +
+                    '(e.g. https://api.together.xyz/v1 or http://localhost:11434/v1 for Ollama).');
+            }
+            const apiKey = process.env.SPECVERSE_AI_API_KEY;
+            const openaiCompatible = createOpenAICompatible({
+                name: 'specverse-ai',
+                baseURL,
+                apiKey,
+            });
+            return openaiCompatible(modelOverride ?? 'deepseek-chat');
+        }
+        case 'stub':
+            return stubModel();
+    }
+}
+/** Best-effort diagnostic description of the active provider + model. */
+export function describeActiveProvider() {
+    const provider = resolveProviderId();
+    const model = process.env.SPECVERSE_AI_MODEL;
+    const modelStr = model ? ` (${model})` : '';
+    switch (provider) {
+        case 'claude-cli':
+            return `claude-cli${modelStr} — local Claude CLI, using your Max subscription auth`;
+        case 'anthropic':
+            return `anthropic${modelStr} — Anthropic API (metered tokens)`;
+        case 'openai-compatible':
+            return `openai-compatible${modelStr} — ${process.env.SPECVERSE_AI_BASE_URL ?? '(no BASE_URL)'}`;
+        case 'stub':
+            return 'stub — no LLM calls; prompt emitted verbatim for ambient executor';
+    }
+}
+//# sourceMappingURL=model-resolver.js.map

package/dist/ai/model-resolver.js.map

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

package/dist/ai/providers/claude-cli.d.ts

@@ -0,0 +1,25 @@
+import type { LanguageModelV3 } from '@ai-sdk/provider';
+export interface ClaudeCliOptions {
+    /** Explicit path to the claude binary. Auto-detected if omitted. */
+    claudePath?: string;
+    /** Model override (e.g. "claude-opus-4", "claude-sonnet-4-5"). Defaults to whatever claude CLI picks. */
+    model?: string;
+    /** Timeout in milliseconds for each call. Default: 120_000. */
+    timeout?: number;
+}
+/**
+ * Find the first working `claude` binary. Tries:
+ *   1. Explicit path override if given
+ *   2. ~/.claude/local/claude (Claude Code's user install)
+ *   3. `claude` on PATH (Homebrew / manual installs)
+ * Returns null if none respond to `--version`.
+ */
+export declare function detectClaudePath(override?: string): string | null;
+/** True if any candidate claude binary responds to --version. */
+export declare function isClaudeCliAvailable(override?: string): boolean;
+/**
+ * Factory for a claude-cli-backed LanguageModelV3. Session state is held
+ * inside the closure, so each call to claudeCli() gets its own session.
+ */
+export declare function claudeCli(options?: ClaudeCliOptions): LanguageModelV3;
+//# sourceMappingURL=claude-cli.d.ts.map

package/dist/ai/providers/claude-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-cli.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/claude-cli.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yGAAyG;IACzG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjE;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/D;AAmCD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA0GzE"}

package/dist/ai/providers/claude-cli.js

@@ -0,0 +1,185 @@
+/**
+ * claude-cli provider — wraps the locally-installed `claude` binary as an
+ * AI SDK v3 LanguageModel. Preserves the Max-subscription zero-cost path
+ * by spawning `claude --print` with the user's authenticated session.
+ *
+ * Session caching: first call uses `--session-id <uuid>`, subsequent calls
+ * `--resume <uuid>` — gives the same 98% token savings the Claude Code
+ * session mechanism provides.
+ *
+ * If the user has run `spv skill install --global`, the SpecVerse skill is
+ * auto-loaded by Claude Code into every session started by this provider.
+ * See detectInstalledSkill() in ../skill-detection.ts.
+ */
+import { spawn, execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { randomUUID } from 'crypto';
+import { join } from 'path';
+/**
+ * Find the first working `claude` binary. Tries:
+ *   1. Explicit path override if given
+ *   2. ~/.claude/local/claude (Claude Code's user install)
+ *   3. `claude` on PATH (Homebrew / manual installs)
+ * Returns null if none respond to `--version`.
+ */
+export function detectClaudePath(override) {
+    const home = process.env.HOME || '';
+    const candidates = override
+        ? [override]
+        : [join(home, '.claude', 'local', 'claude'), 'claude'];
+    for (const candidate of candidates) {
+        // For explicit paths, require existence on disk before exec.
+        if (candidate !== 'claude' && !existsSync(candidate))
+            continue;
+        try {
+            execSync(`${candidate} --version`, { stdio: 'ignore', timeout: 5000 });
+            return candidate;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return null;
+}
+/** True if any candidate claude binary responds to --version. */
+export function isClaudeCliAvailable(override) {
+    return detectClaudePath(override) !== null;
+}
+/**
+ * Extract a flat { system, user } pair from the AI SDK's message array.
+ * The claude CLI's --system-prompt / -p flags only accept one string each.
+ * For now we concatenate any system messages, and join all user turns with
+ * blank lines. (In practice behavior generation is single-turn; this
+ * provider isn't targeting multi-turn conversational use.)
+ */
+function flattenPrompt(messages) {
+    const systemChunks = [];
+    const userChunks = [];
+    for (const msg of messages) {
+        if (msg.role === 'system') {
+            systemChunks.push(msg.content);
+        }
+        else if (msg.role === 'user') {
+            for (const part of msg.content) {
+                if (part.type === 'text')
+                    userChunks.push(part.text);
+            }
+        }
+        else if (msg.role === 'assistant') {
+            // Prior assistant turns get included into the user prompt as context
+            // so the CLI can see them. Unusual for our use case.
+            const text = msg.content
+                .filter((p) => p.type === 'text')
+                .map((p) => p.text)
+                .join('');
+            if (text)
+                userChunks.push(`[Assistant previously said]\n${text}`);
+        }
+    }
+    return {
+        system: systemChunks.join('\n\n').trim(),
+        user: userChunks.join('\n\n').trim(),
+    };
+}
+/**
+ * Factory for a claude-cli-backed LanguageModelV3. Session state is held
+ * inside the closure, so each call to claudeCli() gets its own session.
+ */
+export function claudeCli(options = {}) {
+    const claudePath = options.claudePath || detectClaudePath() || 'claude';
+    const timeout = options.timeout ?? 120_000;
+    const modelId = options.model ?? 'default';
+    const sessionId = randomUUID();
+    let initialized = false;
+    async function spawnClaude(args, stdinPrompt) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn(claudePath, args, {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                env: { ...process.env },
+            });
+            let out = '';
+            let err = '';
+            const timer = setTimeout(() => {
+                proc.kill();
+                reject(new Error(`claude-cli timed out after ${timeout}ms`));
+            }, timeout);
+            proc.stdout?.on('data', (d) => {
+                out += d.toString();
+            });
+            proc.stderr?.on('data', (d) => {
+                err += d.toString();
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                if (code !== 0) {
+                    reject(new Error(`claude-cli exited ${code}: ${err || out}`));
+                    return;
+                }
+                resolve(out);
+            });
+            proc.on('error', (e) => {
+                clearTimeout(timer);
+                reject(e);
+            });
+        });
+    }
+    const model = {
+        specificationVersion: 'v3',
+        provider: 'claude-cli',
+        modelId,
+        supportedUrls: {},
+        async doGenerate(opts) {
+            const { system, user } = flattenPrompt(opts.prompt);
+            const args = ['--print'];
+            if (!initialized) {
+                args.push('--session-id', sessionId);
+                if (system)
+                    args.push('--system-prompt', system);
+            }
+            else {
+                args.push('--resume', sessionId);
+            }
+            if (modelId !== 'default')
+                args.push('--model', modelId);
+            args.push('-p', user);
+            const out = await spawnClaude(args, user);
+            initialized = true;
+            return {
+                content: [{ type: 'text', text: out.trim() }],
+                finishReason: { unified: 'stop', raw: undefined },
+                usage: {
+                    // The CLI doesn't expose token counts in --print mode.
+                    inputTokens: { total: undefined, noCache: undefined, cacheRead: undefined, cacheWrite: undefined },
+                    outputTokens: { total: undefined, text: undefined, reasoning: undefined },
+                },
+                warnings: [],
+            };
+        },
+        async doStream(opts) {
+            // v1 of this provider: no real streaming — buffer the doGenerate result
+            // and emit it as a single chunk. Revisit if behavior-service ever wants
+            // partial-output UX.
+            const result = await model.doGenerate(opts);
+            const text = result.content
+                .filter((c) => c.type === 'text')
+                .map((c) => c.text)
+                .join('');
+            const parts = [
+                { type: 'text-start', id: 'single' },
+                { type: 'text-delta', id: 'single', delta: text },
+                { type: 'text-end', id: 'single' },
+                { type: 'finish', finishReason: { unified: 'stop', raw: undefined }, usage: result.usage },
+            ];
+            const stream = new ReadableStream({
+                start(controller) {
+                    for (const part of parts)
+                        controller.enqueue(part);
+                    controller.close();
+                },
+            });
+            return { stream };
+        },
+    };
+    return model;
+}
+//# sourceMappingURL=claude-cli.js.map

package/dist/ai/providers/claude-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-cli.js","sourceRoot":"","sources":["../../../src/ai/providers/claude-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAmB5B;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,QAAQ;QACzB,CAAC,CAAC,CAAC,QAAQ,CAAC;QACZ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEzD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,6DAA6D;QAC7D,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS;QAC/D,IAAI,CAAC;YACH,QAAQ,CAAC,GAAG,SAAS,YAAY,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,QAAiB;IACpD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,QAAkC;IACvD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;oBAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACpC,qEAAqE;YACrE,qDAAqD;YACrD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;iBACrE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI,IAAI;gBAAE,UAAU,CAAC,IAAI,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QACxC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;KACrC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,UAA4B,EAAE;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,EAAE,IAAI,QAAQ,CAAC;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;IAE3C,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,UAAU,WAAW,CAAC,IAAc,EAAE,WAAmB;QAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE;gBACnC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;aACxB,CAAC,CAAC;YAEH,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,OAAO,IAAI,CAAC,CAAC,CAAC;YAC/D,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACpC,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACtB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACpC,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACtB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;oBAC9D,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACrB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAoB;QAC7B,oBAAoB,EAAE,IAAI;QAC1B,QAAQ,EAAE,YAAY;QACtB,OAAO;QACP,aAAa,EAAE,EAAE;QAEjB,KAAK,CAAC,UAAU,CAAC,IAAgC;YAC/C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEpD,MAAM,IAAI,GAAa,CAAC,SAAS,CAAC,CAAC;YACnC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;gBACrC,IAAI,MAAM;oBAAE,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAEtB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,WAAW,GAAG,IAAI,CAAC;YAEnB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7C,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE;gBACjD,KAAK,EAAE;oBACL,uDAAuD;oBACvD,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;oBAClG,YAAY,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;iBAC1E;gBACD,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,IAAgC;YAC7C,wEAAwE;YACxE,wEAAwE;YACxE,qBAAqB;YACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO;iBACxB,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;iBACrE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,EAAE,CAAC,CAAC;YAEZ,MAAM,KAAK,GAAgC;gBACzC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE;gBACpC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;gBACjD,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE;gBAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;aAC3F,CAAC;YAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAA4B;gBAC3D,KAAK,CAAC,UAAU;oBACd,KAAK,MAAM,IAAI,IAAI,KAAK;wBAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBACnD,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;aACF,CAAC,CAAC;YAEH,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/ai/providers/index.d.ts

@@ -1,6 +1,9 @@
-export * from './llm-provider.js';
-export * from './provider-factory.js';
-export * from './openai-provider.js';
-export * from './anthropic-provider.js';
-export * from './interactive-provider.js';
+/**
+ * AI providers — custom LanguageModelV3 implementations that plug into the
+ * Vercel AI SDK. Most consumers should call `resolveModel()` from the parent
+ * module rather than instantiating these directly.
+ */
+export { claudeCli, isClaudeCliAvailable, detectClaudePath } from './claude-cli.js';
+export type { ClaudeCliOptions } from './claude-cli.js';
+export { stubModel } from './stub.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ai/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/ai/providers/index.js

@@ -1,6 +1,8 @@
-export * from './llm-provider.js';
-export * from './provider-factory.js';
-export * from './openai-provider.js';
-export * from './anthropic-provider.js';
-export * from './interactive-provider.js';
+/**
+ * AI providers — custom LanguageModelV3 implementations that plug into the
+ * Vercel AI SDK. Most consumers should call `resolveModel()` from the parent
+ * module rather than instantiating these directly.
+ */
+export { claudeCli, isClaudeCliAvailable, detectClaudePath } from './claude-cli.js';
+export { stubModel } from './stub.js';
 //# sourceMappingURL=index.js.map

package/dist/ai/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/ai/providers/stub.d.ts

@@ -0,0 +1,15 @@
+/**
+ * stub provider — an AI SDK v3 LanguageModel that doesn't call any LLM.
+ * Emits the user prompt verbatim with a marker comment so the ambient
+ * runtime (MCP client, user's editor, etc.) can see what was asked and
+ * execute it themselves.
+ *
+ * Used in two scenarios:
+ * 1. Inside an MCP server context (MCP_SERVER=1) — the Claude Desktop /
+ *    client session IS the LLM; calling a separate API would be wasteful.
+ * 2. As the safe default when no provider is configured — gives a clear
+ *    diagnostic instead of a silent failure or a cryptic auth error.
+ */
+import type { LanguageModelV3 } from '@ai-sdk/provider';
+export declare function stubModel(): LanguageModelV3;
+//# sourceMappingURL=stub.d.ts.map

package/dist/ai/providers/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/stub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,kBAAkB,CAAC;AAkB1B,wBAAgB,SAAS,IAAI,eAAe,CAqD3C"}

package/dist/ai/providers/stub.js

@@ -0,0 +1,64 @@
+function formatAsText(messages) {
+    const sections = [];
+    for (const msg of messages) {
+        if (msg.role === 'system') {
+            sections.push(`--- system ---\n${msg.content}`);
+        }
+        else if (msg.role === 'user') {
+            const text = msg.content
+                .filter((p) => p.type === 'text')
+                .map((p) => p.text)
+                .join('');
+            sections.push(`--- user ---\n${text}`);
+        }
+    }
+    return sections.join('\n\n');
+}
+export function stubModel() {
+    const model = {
+        specificationVersion: 'v3',
+        provider: 'specverse-stub',
+        modelId: 'stub',
+        supportedUrls: {},
+        async doGenerate(opts) {
+            const text = '// SPECVERSE_AI_PROVIDER=stub — no LLM was called.\n' +
+                '// The ambient runtime (MCP client, agent, or user) is expected to\n' +
+                '// execute the prompt below. To enable real generation, set\n' +
+                '// SPECVERSE_AI_PROVIDER to one of: claude-cli, anthropic, openai-compatible.\n' +
+                '\n' +
+                formatAsText(opts.prompt);
+            return {
+                content: [{ type: 'text', text }],
+                finishReason: { unified: 'stop', raw: undefined },
+                usage: {
+                    inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: 0 },
+                    outputTokens: { total: 0, text: 0, reasoning: 0 },
+                },
+                warnings: [],
+            };
+        },
+        async doStream(opts) {
+            const result = await model.doGenerate(opts);
+            const text = result.content
+                .filter((c) => c.type === 'text')
+                .map((c) => c.text)
+                .join('');
+            const parts = [
+                { type: 'text-start', id: 'stub' },
+                { type: 'text-delta', id: 'stub', delta: text },
+                { type: 'text-end', id: 'stub' },
+                { type: 'finish', finishReason: { unified: 'stop', raw: undefined }, usage: result.usage },
+            ];
+            const stream = new ReadableStream({
+                start(controller) {
+                    for (const part of parts)
+                        controller.enqueue(part);
+                    controller.close();
+                },
+            });
+            return { stream };
+        },
+    };
+    return model;
+}
+//# sourceMappingURL=stub.js.map