@soulcraft/sdk 3.5.0 → 3.6.1

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

@@ -35,21 +35,27 @@
  */
 import type { AiModule } from './types.js';
 /**
- * Creates an `AiModule` backed by the Anthropic Claude API.
+ * Creates an `AiModule` with pluggable provider support.
  *
- * Reads `ANTHROPIC_API_KEY` from the environment. In production, throws if
- * the key is absent so misconfigured deployments fail loudly at startup.
+ * By default, uses the Anthropic Claude API. Set `AI_DEFAULT_PROVIDER=local`
+ * or pass `provider: 'local'` per-call to route to Ollama instead.
  *
  * @returns A configured {@link AiModule} instance.
- * @throws {Error} If `ANTHROPIC_API_KEY` is absent in production.
  *
- * @example
+ * @example Default (Claude)
+ * ```typescript
+ * const ai = createAiModule()
+ * const result = await ai.complete({ messages: [...] }) // → Claude
+ * ```
+ *
+ * @example Mixed providers
  * ```typescript
  * const ai = createAiModule()
- * const result = await ai.complete({ messages: [...], model: 'claude-sonnet-4-6' })
+ * const plan = await ai.complete({ provider: 'anthropic', model: 'opus', messages }) // → Claude
+ * const exec = await ai.complete({ provider: 'local', model: 'haiku', messages })    // → Ollama
  * ```
  */
 export declare function createAiModule(): AiModule;
-export type { AiModule, AiCompleteOptions, AiCompleteResult, AiStreamOptions, AiStreamEvent, AiToolCall, AiMessage, AiContentBlock, AiTool, AiModel, } from './types.js';
-export { AI_MODELS } from './types.js';
+export type { AiModule, AiCompleteOptions, AiCompleteResult, AiStreamOptions, AiStreamEvent, AiToolCall, AiMessage, AiContentBlock, AiTool, AiModel, AiProvider, AiTier, } from './types.js';
+export { AI_MODELS, AI_TIERS, PROVIDER_MODELS, resolveModelId } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EACV,QAAQ,EAMT,MAAM,YAAY,CAAA;AAOnB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CA0CzC;AA6MD,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,MAAM,EACN,OAAO,GACR,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EACV,QAAQ,EAOT,MAAM,YAAY,CAAA;AAgDnB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAqDzC;AA6MD,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,MAAM,EACN,OAAO,EACP,UAAU,EACV,MAAM,GACP,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/modules/ai/index.js

@@ -34,7 +34,8 @@
  * ```
  */
 import Anthropic from '@anthropic-ai/sdk';
-import { AI_MODELS } from './types.js';
+import { AI_MODELS, resolveModelId } from './types.js';
+import { ollamaComplete, ollamaStream } from './ollama.js';
 // ─────────────────────────────────────────────────────────────────────────────
 // Factory
 // ─────────────────────────────────────────────────────────────────────────────
@@ -53,31 +54,83 @@ import { AI_MODELS } from './types.js';
  * const result = await ai.complete({ messages: [...], model: 'claude-sonnet-4-6' })
  * ```
  */
+/**
+ * @description Resolve the Ollama base URL for a given provider type.
+ * @param provider - 'local' or 'remote'.
+ * @returns The Ollama API base URL.
+ */
+function _resolveOllamaUrl(provider) {
+    if (provider === 'local') {
+        return process.env['AI_LOCAL_URL'] || 'http://localhost:11434';
+    }
+    if (provider === 'remote') {
+        const url = process.env['AI_REMOTE_URL'];
+        if (!url)
+            throw new Error('AI_REMOTE_URL is required when using provider: "remote"');
+        return url;
+    }
+    throw new Error(`Unknown provider: ${provider}`);
+}
+/**
+ * @description Resolve which provider to use for a given call.
+ * Per-call `options.provider` overrides the `AI_DEFAULT_PROVIDER` env var.
+ */
+function _resolveProvider(options) {
+    return options.provider ?? process.env['AI_DEFAULT_PROVIDER'] ?? 'anthropic';
+}
+/**
+ * Creates an `AiModule` with pluggable provider support.
+ *
+ * By default, uses the Anthropic Claude API. Set `AI_DEFAULT_PROVIDER=local`
+ * or pass `provider: 'local'` per-call to route to Ollama instead.
+ *
+ * @returns A configured {@link AiModule} instance.
+ *
+ * @example Default (Claude)
+ * ```typescript
+ * const ai = createAiModule()
+ * const result = await ai.complete({ messages: [...] }) // → Claude
+ * ```
+ *
+ * @example Mixed providers
+ * ```typescript
+ * const ai = createAiModule()
+ * const plan = await ai.complete({ provider: 'anthropic', model: 'opus', messages }) // → Claude
+ * const exec = await ai.complete({ provider: 'local', model: 'haiku', messages })    // → Ollama
+ * ```
+ */
 export function createAiModule() {
     const apiKey = process.env['ANTHROPIC_API_KEY'];
-    if (!apiKey && process.env['NODE_ENV'] === 'production') {
-        throw new Error('ANTHROPIC_API_KEY is required in production. ' +
-            'Set this environment variable to your Anthropic API key.');
+    const defaultProvider = process.env['AI_DEFAULT_PROVIDER'] ?? 'anthropic';
+    if (!apiKey && defaultProvider === 'anthropic' && process.env['NODE_ENV'] === 'production') {
+        throw new Error('ANTHROPIC_API_KEY is required when AI_DEFAULT_PROVIDER is "anthropic" in production.');
     }
-    if (!apiKey) {
-        console.warn('[SDK/ai] ANTHROPIC_API_KEY is not set. ' +
-            'sdk.ai.complete() and sdk.ai.stream() will throw until it is configured.');
+    if (!apiKey && defaultProvider === 'anthropic') {
+        console.warn('[SDK/ai] ANTHROPIC_API_KEY is not set. Anthropic provider will throw on use. ' +
+            'Set AI_DEFAULT_PROVIDER=local to use Ollama instead.');
     }
-    // When the API key is absent in non-production, we defer the error to call time
-    // so the SDK can be constructed (e.g. for testing non-AI paths) without throwing.
     const client = apiKey ? new Anthropic({ apiKey }) : null;
     return {
         async complete(options) {
+            const provider = _resolveProvider(options);
+            if (provider === 'local' || provider === 'remote') {
+                return ollamaComplete(_resolveOllamaUrl(provider), options);
+            }
             if (!client) {
                 throw new Error('ANTHROPIC_API_KEY is not set. ' +
-                    'Configure this environment variable to use sdk.ai.complete().');
+                    'Set it, or use provider: "local" / AI_DEFAULT_PROVIDER=local for Ollama.');
             }
             return _complete(client, options);
         },
         async *stream(options) {
+            const provider = _resolveProvider(options);
+            if (provider === 'local' || provider === 'remote') {
+                yield* ollamaStream(_resolveOllamaUrl(provider), options);
+                return;
+            }
             if (!client) {
                 throw new Error('ANTHROPIC_API_KEY is not set. ' +
-                    'Configure this environment variable to use sdk.ai.stream().');
+                    'Set it, or use provider: "local" / AI_DEFAULT_PROVIDER=local for Ollama.');
             }
             yield* _stream(client, options);
         },
@@ -96,7 +149,7 @@ export function createAiModule() {
 async function _complete(client, options) {
     const { messages, systemPrompt, model, tools, maxTokens = 8192, temperature } = options;
     const params = {
-        model: model ?? AI_MODELS.sonnet,
+        model: resolveModelId(model, 'anthropic'),
         max_tokens: maxTokens,
         messages: messages.map(_toAnthropicMessage),
         ...(systemPrompt ? { system: systemPrompt } : {}),
@@ -124,7 +177,7 @@ async function _complete(client, options) {
 async function* _stream(client, options) {
     const { messages, systemPrompt, model, tools, maxTokens = 8192, temperature } = options;
     const params = {
-        model: model ?? AI_MODELS.sonnet,
+        model: resolveModelId(model, 'anthropic'),
         max_tokens: maxTokens,
         stream: true,
         messages: messages.map(_toAnthropicMessage),
@@ -273,5 +326,5 @@ function _parseResponse(response) {
         },
     };
 }
-export { AI_MODELS } from './types.js';
+export { AI_MODELS, AI_TIERS, PROVIDER_MODELS, resolveModelId } from './types.js';
 //# sourceMappingURL=index.js.map

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

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

package/dist/modules/ai/ollama.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module modules/ai/ollama
+ * @description Ollama provider for the SDK AI module. Translates Anthropic-format
+ * requests to Ollama's OpenAI-compatible API and back.
+ *
+ * Supports:
+ * - Non-streaming completion via `/api/chat`
+ * - Streaming completion via `/api/chat` with `stream: true`
+ * - Tool calling (Ollama supports OpenAI-format tools)
+ * - Automatic model tier mapping (claude-* → Ollama model names)
+ */
+import type { AiCompleteOptions, AiCompleteResult, AiStreamEvent } from './types.js';
+/**
+ * @description Execute a non-streaming completion against Ollama.
+ * @param baseUrl - The Ollama API base URL (e.g. 'http://localhost:11434').
+ * @param options - SDK completion options.
+ * @returns SDK-formatted completion result.
+ */
+export declare function ollamaComplete(baseUrl: string, options: AiCompleteOptions): Promise<AiCompleteResult>;
+/**
+ * @description Execute a streaming completion against Ollama.
+ * @param baseUrl - The Ollama API base URL.
+ * @param options - SDK completion options.
+ * @yields SDK-formatted stream events.
+ */
+export declare function ollamaStream(baseUrl: string, options: AiCompleteOptions): AsyncIterable<AiStreamEvent>;
+//# sourceMappingURL=ollama.d.ts.map

package/dist/modules/ai/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/modules/ai/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EAEd,MAAM,YAAY,CAAA;AAiEnB;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA6D3B;AAED;;;;;GAKG;AACH,wBAAuB,YAAY,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,aAAa,CAAC,aAAa,CAAC,CAgG9B"}

package/dist/modules/ai/ollama.js

@@ -0,0 +1,221 @@
+/**
+ * @module modules/ai/ollama
+ * @description Ollama provider for the SDK AI module. Translates Anthropic-format
+ * requests to Ollama's OpenAI-compatible API and back.
+ *
+ * Supports:
+ * - Non-streaming completion via `/api/chat`
+ * - Streaming completion via `/api/chat` with `stream: true`
+ * - Tool calling (Ollama supports OpenAI-format tools)
+ * - Automatic model tier mapping (claude-* → Ollama model names)
+ */
+import { resolveModelId } from './types.js';
+/**
+ * @description Convert SDK messages to Ollama/OpenAI chat format.
+ */
+function toOllamaMessages(messages, systemPrompt) {
+    const result = [];
+    if (systemPrompt) {
+        result.push({ role: 'system', content: systemPrompt });
+    }
+    for (const msg of messages) {
+        if (typeof msg.content === 'string') {
+            result.push({ role: msg.role, content: msg.content });
+        }
+        else {
+            // Flatten content blocks to text + handle tool results
+            const textParts = [];
+            for (const block of msg.content) {
+                if (block.type === 'text') {
+                    textParts.push(block.text);
+                }
+                else if (block.type === 'tool_result') {
+                    result.push({ role: 'tool', content: block.content });
+                }
+                else if (block.type === 'tool_use') {
+                    // Assistant's tool call — reconstruct as OpenAI format
+                    result.push({
+                        role: 'assistant',
+                        content: '',
+                        tool_calls: [{
+                                id: block.id,
+                                type: 'function',
+                                function: { name: block.name, arguments: JSON.stringify(block.input) },
+                            }],
+                    });
+                    continue;
+                }
+            }
+            if (textParts.length > 0) {
+                result.push({ role: msg.role, content: textParts.join('\n') });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * @description Convert SDK tool definitions to Ollama/OpenAI format.
+ */
+function toOllamaTools(tools) {
+    if (!tools || tools.length === 0)
+        return undefined;
+    return tools.map((t) => ({
+        type: 'function',
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: t.inputSchema,
+        },
+    }));
+}
+/**
+ * @description Execute a non-streaming completion against Ollama.
+ * @param baseUrl - The Ollama API base URL (e.g. 'http://localhost:11434').
+ * @param options - SDK completion options.
+ * @returns SDK-formatted completion result.
+ */
+export async function ollamaComplete(baseUrl, options) {
+    const model = resolveModelId(options.model, 'ollama');
+    const messages = toOllamaMessages(options.messages, options.systemPrompt);
+    const tools = toOllamaTools(options.tools);
+    const body = {
+        model,
+        messages,
+        stream: false,
+        options: {
+            num_predict: options.maxTokens ?? 8192,
+            ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),
+        },
+    };
+    if (tools)
+        body.tools = tools;
+    const res = await fetch(`${baseUrl}/api/chat`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Ollama error (${res.status}): ${text}`);
+    }
+    const data = await res.json();
+    const toolCalls = [];
+    if (data.message.tool_calls) {
+        for (const tc of data.message.tool_calls) {
+            let input = {};
+            try {
+                input = JSON.parse(tc.function.arguments);
+            }
+            catch { }
+            toolCalls.push({
+                id: `tool_${crypto.randomUUID().slice(0, 8)}`,
+                name: tc.function.name,
+                input,
+            });
+        }
+    }
+    return {
+        text: data.message.content || null,
+        toolCalls: toolCalls.length > 0 ? toolCalls : null,
+        stopReason: toolCalls.length > 0 ? 'tool_use' : 'end_turn',
+        usage: {
+            inputTokens: data.prompt_eval_count ?? 0,
+            outputTokens: data.eval_count ?? 0,
+        },
+    };
+}
+/**
+ * @description Execute a streaming completion against Ollama.
+ * @param baseUrl - The Ollama API base URL.
+ * @param options - SDK completion options.
+ * @yields SDK-formatted stream events.
+ */
+export async function* ollamaStream(baseUrl, options) {
+    const model = resolveModelId(options.model, 'ollama');
+    const messages = toOllamaMessages(options.messages, options.systemPrompt);
+    const tools = toOllamaTools(options.tools);
+    const body = {
+        model,
+        messages,
+        stream: true,
+        options: {
+            num_predict: options.maxTokens ?? 8192,
+            ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),
+        },
+    };
+    if (tools)
+        body.tools = tools;
+    const res = await fetch(`${baseUrl}/api/chat`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Ollama error (${res.status}): ${text}`);
+    }
+    const reader = res.body?.getReader();
+    if (!reader)
+        throw new Error('No response body from Ollama');
+    const decoder = new TextDecoder();
+    let buffer = '';
+    let accumulatedText = '';
+    const accumulatedToolCalls = [];
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const chunk = JSON.parse(line);
+                if (chunk.message?.content) {
+                    accumulatedText += chunk.message.content;
+                    yield { type: 'text', text: chunk.message.content };
+                }
+                if (chunk.message?.tool_calls) {
+                    for (const tc of chunk.message.tool_calls) {
+                        let input = {};
+                        try {
+                            input = JSON.parse(tc.function.arguments);
+                        }
+                        catch { }
+                        const toolCall = {
+                            id: `tool_${crypto.randomUUID().slice(0, 8)}`,
+                            name: tc.function.name,
+                            input,
+                        };
+                        accumulatedToolCalls.push(toolCall);
+                        yield { type: 'tool_use', toolCall };
+                    }
+                }
+                if (chunk.done) {
+                    totalInputTokens = chunk.prompt_eval_count ?? 0;
+                    totalOutputTokens = chunk.eval_count ?? 0;
+                }
+            }
+            catch {
+                // Skip malformed NDJSON lines
+            }
+        }
+    }
+    yield {
+        type: 'done',
+        result: {
+            text: accumulatedText || null,
+            toolCalls: accumulatedToolCalls.length > 0 ? accumulatedToolCalls : null,
+            stopReason: accumulatedToolCalls.length > 0 ? 'tool_use' : 'end_turn',
+            usage: {
+                inputTokens: totalInputTokens,
+                outputTokens: totalOutputTokens,
+            },
+        },
+    };
+}
+//# sourceMappingURL=ollama.js.map

package/dist/modules/ai/ollama.js.map

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

package/dist/modules/ai/types.d.ts

@@ -16,16 +16,66 @@
  * Use these constants instead of hardcoding model strings to ensure consistency
  * across products and easier future upgrades.
  */
+/**
+ * @description Abstract model tiers. Callers use these tier names — each
+ * provider maps them to its own concrete model automatically.
+ *
+ * - `fast` — speed-optimized, simple tasks, data extraction
+ * - `balanced` — general purpose, most operations (default)
+ * - `powerful` — complex reasoning, long-form synthesis, multi-step planning
+ *
+ * Raw model strings (e.g. 'claude-sonnet-4-6', 'qwen2.5:7b') are passed
+ * through to the provider unchanged for backwards compatibility.
+ */
+export declare const AI_TIERS: {
+    readonly fast: "fast";
+    readonly balanced: "balanced";
+    readonly powerful: "powerful";
+};
+export type AiTier = typeof AI_TIERS[keyof typeof AI_TIERS];
+/**
+ * @description Concrete model IDs per provider, indexed by tier.
+ */
+export declare const PROVIDER_MODELS: {
+    readonly anthropic: {
+        readonly fast: "claude-haiku-4-5-20251001";
+        readonly balanced: "claude-sonnet-4-6";
+        readonly powerful: "claude-opus-4-6";
+    };
+    readonly ollama: {
+        readonly fast: "qwen2.5:7b";
+        readonly balanced: "qwen2.5:32b-instruct-q4_K_M";
+        readonly powerful: "llama3.1:70b";
+    };
+};
+/**
+ * @description Legacy model constants for backwards compatibility.
+ * New code should use `AI_TIERS.fast`, `AI_TIERS.balanced`, `AI_TIERS.powerful`.
+ */
 export declare const AI_MODELS: {
-    /** Fast, affordable — routine lookups, data extraction, simple Q&A. */
-    readonly haiku: "claude-haiku-4-5-20251001";
-    /** Balanced — most kit operations, content generation, analysis. */
-    readonly sonnet: "claude-sonnet-4-6";
-    /** Most capable — complex reasoning, long-form synthesis, multi-step planning. */
-    readonly opus: "claude-opus-4-6";
+    haiku: "fast";
+    sonnet: "balanced";
+    opus: "powerful";
 };
-/** A valid Soulcraft Claude model tier ID. */
-export type AiModel = typeof AI_MODELS[keyof typeof AI_MODELS] | string;
+/**
+ * @description AI provider identifiers.
+ *
+ * - `anthropic` — Claude via Anthropic API (default)
+ * - `local` — Ollama on localhost (CPU/GPU inference)
+ * - `remote` — Ollama on a remote server (e.g. llm.bxl9000.com)
+ */
+export type AiProvider = 'anthropic' | 'local' | 'remote';
+/**
+ * @description Resolve a model tier or raw model string to a concrete model ID.
+ * @param model - A tier name ('fast', 'balanced', 'powerful'), a legacy name
+ *   ('haiku', 'sonnet', 'opus'), or a raw model string.
+ * @param providerType - 'anthropic' or 'ollama'.
+ * @returns The concrete model ID for the provider.
+ */
+export declare function resolveModelId(model: string | undefined, providerType: 'anthropic' | 'ollama'): string;
+/** A valid model identifier — tier name ('fast', 'balanced', 'powerful'),
+ *  legacy name ('haiku', 'sonnet', 'opus'), or raw model string. */
+export type AiModel = AiTier | 'haiku' | 'sonnet' | 'opus' | string;
 /**
  * A single message in a Claude conversation.
  */
@@ -106,6 +156,26 @@ export interface AiCompleteOptions {
      * @default AI_MODELS.sonnet
      */
     model?: AiModel;
+    /**
+     * AI provider to use for this specific call. Overrides the default provider
+     * set via `AI_DEFAULT_PROVIDER` environment variable.
+     *
+     * - `'anthropic'` — Claude via Anthropic API (default)
+     * - `'local'` — Ollama on localhost (`AI_LOCAL_URL`, default `http://localhost:11434`)
+     * - `'remote'` — Ollama on a remote server (`AI_REMOTE_URL`)
+     *
+     * Enables mixing providers in a single workflow — e.g. Claude for planning,
+     * local models for fast execution tasks.
+     *
+     * @example
+     * ```typescript
+     * // Deep reasoning with Claude
+     * const plan = await ai.complete({ provider: 'anthropic', model: 'opus', messages })
+     * // Fast execution with local LLM
+     * const result = await ai.complete({ provider: 'local', model: 'haiku', messages })
+     * ```
+     */
+    provider?: AiProvider;
     /**
      * Tools available to Claude during this completion.
      *

package/dist/modules/ai/types.d.ts.map

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

package/dist/modules/ai/types.js

@@ -19,12 +19,73 @@
  * Use these constants instead of hardcoding model strings to ensure consistency
  * across products and easier future upgrades.
  */
+/**
+ * @description Abstract model tiers. Callers use these tier names — each
+ * provider maps them to its own concrete model automatically.
+ *
+ * - `fast` — speed-optimized, simple tasks, data extraction
+ * - `balanced` — general purpose, most operations (default)
+ * - `powerful` — complex reasoning, long-form synthesis, multi-step planning
+ *
+ * Raw model strings (e.g. 'claude-sonnet-4-6', 'qwen2.5:7b') are passed
+ * through to the provider unchanged for backwards compatibility.
+ */
+export const AI_TIERS = {
+    fast: 'fast',
+    balanced: 'balanced',
+    powerful: 'powerful',
+};
+/**
+ * @description Concrete model IDs per provider, indexed by tier.
+ */
+export const PROVIDER_MODELS = {
+    anthropic: {
+        fast: 'claude-haiku-4-5-20251001',
+        balanced: 'claude-sonnet-4-6',
+        powerful: 'claude-opus-4-6',
+    },
+    ollama: {
+        fast: 'qwen2.5:7b',
+        balanced: 'qwen2.5:32b-instruct-q4_K_M',
+        powerful: 'llama3.1:70b',
+    },
+};
+/**
+ * @description Legacy model constants for backwards compatibility.
+ * New code should use `AI_TIERS.fast`, `AI_TIERS.balanced`, `AI_TIERS.powerful`.
+ */
 export const AI_MODELS = {
-    /** Fast, affordable — routine lookups, data extraction, simple Q&A. */
-    haiku: 'claude-haiku-4-5-20251001',
-    /** Balanced — most kit operations, content generation, analysis. */
-    sonnet: 'claude-sonnet-4-6',
-    /** Most capable — complex reasoning, long-form synthesis, multi-step planning. */
-    opus: 'claude-opus-4-6',
+    haiku: 'fast',
+    sonnet: 'balanced',
+    opus: 'powerful',
 };
+/**
+ * @description Resolve a model tier or raw model string to a concrete model ID.
+ * @param model - A tier name ('fast', 'balanced', 'powerful'), a legacy name
+ *   ('haiku', 'sonnet', 'opus'), or a raw model string.
+ * @param providerType - 'anthropic' or 'ollama'.
+ * @returns The concrete model ID for the provider.
+ */
+export function resolveModelId(model, providerType) {
+    const tier = model ?? 'balanced';
+    const models = PROVIDER_MODELS[providerType];
+    // Check tier names first
+    if (tier in models)
+        return models[tier];
+    // Legacy names (haiku/sonnet/opus → tier)
+    const legacyMap = { haiku: 'fast', sonnet: 'balanced', opus: 'powerful' };
+    if (tier in legacyMap)
+        return models[legacyMap[tier]];
+    // Legacy Claude model IDs → map to tier for Ollama
+    if (providerType === 'ollama') {
+        if (tier.includes('haiku'))
+            return models.fast;
+        if (tier.includes('sonnet'))
+            return models.balanced;
+        if (tier.includes('opus'))
+            return models.powerful;
+    }
+    // Raw model string — pass through unchanged
+    return tier;
+}
 //# sourceMappingURL=types.js.map

package/dist/modules/ai/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,uEAAuE;IACvE,KAAK,EAAE,2BAA2B;IAClC,oEAAoE;IACpE,MAAM,EAAE,mBAAmB;IAC3B,kFAAkF;IAClF,IAAI,EAAE,iBAAiB;CACf,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;GAKG;AACH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;CACZ,CAAA;AAIV;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE;QACT,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,mBAAmB;QAC7B,QAAQ,EAAE,iBAAiB;KAC5B;IACD,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,6BAA6B;QACvC,QAAQ,EAAE,cAAc;KACzB;CACO,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,MAAe;IACtB,MAAM,EAAE,UAAmB;IAC3B,IAAI,EAAE,UAAmB;CAC1B,CAAA;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAyB,EACzB,YAAoC;IAEpC,MAAM,IAAI,GAAG,KAAK,IAAI,UAAU,CAAA;IAChC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;IAE5C,yBAAyB;IACzB,IAAI,IAAI,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,IAA2B,CAAC,CAAA;IAE9D,0CAA0C;IAC1C,MAAM,SAAS,GAA2B,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IACjG,IAAI,IAAI,IAAI,SAAS;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAwB,CAAC,CAAA;IAE5E,mDAAmD;IACnD,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAA;QAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAA;QACnD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAA;IACnD,CAAC;IAED,4CAA4C;IAC5C,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/sdk",
-  "version": "3.5.0",
+  "version": "3.6.1",
   "description": "The unified Soulcraft platform SDK — data, auth, AI, billing, and notifications",
   "type": "module",
   "publishConfig": {