@runcore-sh/runcore 0.1.2

package/dist/llm/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/llm/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAuC,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AASzD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,IAAI,WAAW,CAE9C;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAMrE;AAeD,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD;AAED,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED,uCAAuC;AACvC,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED,qDAAqD;AACrD,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAID;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,EAC1D,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CA4BjB"}

package/dist/llm/cache.js

@@ -0,0 +1,104 @@
+/**
+ * LLM-specific caching layer.
+ *
+ * Delegates to the generic cache system in src/cache/.
+ * Provides backward-compatible function exports and the `completeChatCached` wrapper.
+ */
+import { TieredCache, generateCacheKey as genericCacheKey } from "../cache/index.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("llm-cache");
+// ── Module-level singleton ────────────────────────────────────────────────────
+let cache = new TieredCache();
+/**
+ * Configure (or reconfigure) the LLM cache.
+ * Replaces the module-level cache instance.
+ *
+ * Call `initCache()` after this if file persistence is configured.
+ */
+export function configureCache(config) {
+    cache = new TieredCache(config);
+}
+/**
+ * Initialise file-backed persistence (if configured).
+ * No-op when using memory-only caching.
+ */
+export async function initCache() {
+    await cache.init();
+}
+/** Return the underlying TieredCache instance for advanced use. */
+export function getCacheInstance() {
+    return cache;
+}
+// ── Key generation ────────────────────────────────────────────────────────────
+/**
+ * Generate a cache key from LLM request parameters.
+ * Key is a SHA-256 hash of provider + model + serialised messages.
+ */
+export function generateCacheKey(options) {
+    return genericCacheKey({
+        provider: options.provider,
+        model: options.model ?? "",
+        messages: options.messages.map(normaliseMessage),
+    });
+}
+/** Normalise a ContextMessage to a stable {role, content} form. */
+function normaliseMessage(m) {
+    const content = typeof m.content === "string"
+        ? m.content
+        : m.content
+            .map((b) => ("text" in b ? b.text : b.image_url.url))
+            .join("|");
+    return { role: m.role, content };
+}
+// ── Get / Set / Stats ─────────────────────────────────────────────────────────
+/** Look up a cached response. Returns undefined on miss or expiry. */
+export function cacheGet(key) {
+    return cache.get(key);
+}
+/** Store a response in the cache. */
+export function cacheSet(key, response, ttlMs) {
+    cache.set(key, response, ttlMs);
+}
+/** Return current cache statistics. */
+export function getCacheStats() {
+    return cache.stats();
+}
+/** Clear all cached entries and reset statistics. */
+export function clearCache() {
+    cache.clear();
+    log.debug("cleared");
+}
+// ── Cached completion wrapper ─────────────────────────────────────────────────
+/**
+ * Cached wrapper around any completeChat function.
+ * Checks cache before calling the underlying function; stores the result on miss.
+ */
+export async function completeChatCached(options, completeFn, ttlMs) {
+    const key = generateCacheKey(options);
+    const cached = cacheGet(key);
+    if (cached !== undefined) {
+        log.info("cache hit", {
+            key: key.slice(0, 12),
+            model: options.model ?? "default",
+            provider: options.provider,
+            responseLength: cached.length,
+        });
+        return cached;
+    }
+    log.info("cache miss — calling LLM", {
+        key: key.slice(0, 12),
+        model: options.model ?? "default",
+        provider: options.provider,
+    });
+    const start = Date.now();
+    const response = await completeFn(options);
+    const durationMs = Date.now() - start;
+    cacheSet(key, response, ttlMs);
+    log.debug("cached LLM response", {
+        key: key.slice(0, 12),
+        responseLength: response.length,
+        durationMs,
+    });
+    return response;
+}
+//# sourceMappingURL=cache.js.map

package/dist/llm/cache.js.map

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

package/dist/llm/complete.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Non-streaming LLM completion for Core.
+ * Used by background tasks (e.g. fact extraction) that need a full response, not a token stream.
+ * Routes to the appropriate provider via the provider abstraction layer.
+ * Includes an optional in-memory TTL cache to avoid redundant API calls.
+ */
+import type { ContextMessage } from "../types.js";
+import type { ProviderName } from "./providers/types.js";
+export interface CompleteChatOptions {
+    messages: ContextMessage[];
+    model?: string;
+    provider: ProviderName;
+    /** Skip cache for this request. */
+    noCache?: boolean;
+    /** Override default TTL for this request (ms). */
+    cacheTTLMs?: number;
+}
+/**
+ * Non-streaming chat completion. Returns the full assistant response as a string.
+ * Results are cached by default; pass `noCache: true` to bypass.
+ * 60-second timeout to prevent hung calls.
+ */
+export declare function completeChat(options: CompleteChatOptions): Promise<string>;
+//# sourceMappingURL=complete.d.ts.map

package/dist/llm/complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/llm/complete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AASzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF"}

package/dist/llm/complete.js

@@ -0,0 +1,56 @@
+/**
+ * Non-streaming LLM completion for Core.
+ * Used by background tasks (e.g. fact extraction) that need a full response, not a token stream.
+ * Routes to the appropriate provider via the provider abstraction layer.
+ * Includes an optional in-memory TTL cache to avoid redundant API calls.
+ */
+import { getProvider } from "./providers/index.js";
+import { completeChatCached } from "./cache.js";
+import { LLMError } from "./errors.js";
+import { withRetry } from "./retry.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("llm");
+/**
+ * Non-streaming chat completion. Returns the full assistant response as a string.
+ * Results are cached by default; pass `noCache: true` to bypass.
+ * 60-second timeout to prevent hung calls.
+ */
+export async function completeChat(options) {
+    if (options.noCache)
+        return completeChatUncached(options);
+    return completeChatCached(options, completeChatUncached, options.cacheTTLMs);
+}
+/** Direct LLM call without caching — routes to the configured provider. */
+async function completeChatUncached(options) {
+    const provider = getProvider(options.provider);
+    log.debug("Completion request", {
+        provider: options.provider,
+        model: options.model ?? "default",
+        messageCount: options.messages.length,
+    });
+    try {
+        return await withRetry(() => {
+            const timeout = AbortSignal.timeout(60_000);
+            return provider.completeChat(options.messages, options.model, timeout);
+        }, { maxRetries: 3, baseDelayMs: 1_000, maxDelayMs: 30_000 });
+    }
+    catch (err) {
+        // On credit/billing errors from cloud providers, try Ollama as a fallback
+        if (err instanceof LLMError && err.isCreditsError && options.provider !== "ollama") {
+            const ollama = getProvider("ollama");
+            const ollamaAvailable = await ollama.isAvailable();
+            if (ollamaAvailable) {
+                log.warn("Cloud provider credits exhausted, falling back to Ollama", {
+                    provider: options.provider,
+                    status: err.statusCode,
+                });
+                return withRetry(() => {
+                    const fallbackTimeout = AbortSignal.timeout(120_000);
+                    return ollama.completeChat(options.messages, undefined, fallbackTimeout);
+                }, { maxRetries: 3, baseDelayMs: 1_000, maxDelayMs: 30_000 });
+            }
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=complete.js.map

package/dist/llm/complete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../src/llm/complete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;AAYhC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;AAC/E,CAAC;AAED,2EAA2E;AAC3E,KAAK,UAAU,oBAAoB,CAAC,OAA4B;IAC9D,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/C,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;KACtC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CACpB,GAAG,EAAE;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC,EACD,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAC1D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,0EAA0E;QAC1E,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACnF,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YACnD,IAAI,eAAe,EAAE,CAAC;gBACpB,GAAG,CAAC,IAAI,CAAC,0DAA0D,EAAE;oBACnE,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,MAAM,EAAE,GAAG,CAAC,UAAU;iBACvB,CAAC,CAAC;gBACH,OAAO,SAAS,CACd,GAAG,EAAE;oBACH,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACrD,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;gBAC3E,CAAC,EACD,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAC1D,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/llm/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Structured LLM error types for Core.
+ * Replaces generic Error objects with errors that carry HTTP status,
+ * recoverability, and provider info — enabling smarter retry/fallback decisions.
+ */
+/** Error thrown by LLM providers when an API call fails. */
+export declare class LLMError extends Error {
+    readonly provider: string;
+    readonly statusCode: number | null;
+    readonly recoverable: boolean;
+    constructor(message: string, provider: string, statusCode: number | null, recoverable: boolean);
+    /** True when the error is due to insufficient credits or billing issues. */
+    get isCreditsError(): boolean;
+    /** True when the error is due to rate limiting. */
+    get isRateLimited(): boolean;
+    /** True when the error is an authentication/authorization failure. */
+    get isAuthError(): boolean;
+    /** True when the error is a timeout. */
+    get isTimeout(): boolean;
+    /** Human-readable error message suitable for displaying to the user. */
+    get userMessage(): string;
+}
+/**
+ * Classify an HTTP status code + response body into a structured LLMError.
+ * Used by all providers to convert API error responses consistently.
+ */
+export declare function classifyApiError(provider: string, status: number, body: string, model?: string): LLMError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/llm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/llm/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4DAA4D;AAC5D,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,MAAM;aAChB,UAAU,EAAE,MAAM,GAAG,IAAI;aACzB,WAAW,EAAE,OAAO;gBAHpC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,WAAW,EAAE,OAAO;IAMtC,4EAA4E;IAC5E,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,mDAAmD;IACnD,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,sEAAsE;IACtE,IAAI,WAAW,IAAI,OAAO,CAGzB;IAED,wCAAwC;IACxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,wEAAwE;IACxE,IAAI,WAAW,IAAI,MAAM,CAiBxB;CACF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,GACb,QAAQ,CA0BV"}

package/dist/llm/errors.js

@@ -0,0 +1,82 @@
+/**
+ * Structured LLM error types for Core.
+ * Replaces generic Error objects with errors that carry HTTP status,
+ * recoverability, and provider info — enabling smarter retry/fallback decisions.
+ */
+/** Error thrown by LLM providers when an API call fails. */
+export class LLMError extends Error {
+    provider;
+    statusCode;
+    recoverable;
+    constructor(message, provider, statusCode, recoverable) {
+        super(message);
+        this.provider = provider;
+        this.statusCode = statusCode;
+        this.recoverable = recoverable;
+        this.name = "LLMError";
+    }
+    /** True when the error is due to insufficient credits or billing issues. */
+    get isCreditsError() {
+        return this.statusCode === 402 || /credits|afford|payment.required|billing/i.test(this.message);
+    }
+    /** True when the error is due to rate limiting. */
+    get isRateLimited() {
+        return this.statusCode === 429 || /rate.limit/i.test(this.message);
+    }
+    /** True when the error is an authentication/authorization failure. */
+    get isAuthError() {
+        return this.statusCode === 401 || this.statusCode === 403
+            || /unauthorized|forbidden|invalid.*key|authentication/i.test(this.message);
+    }
+    /** True when the error is a timeout. */
+    get isTimeout() {
+        return /timeout|timed.out/i.test(this.message) || this.statusCode === 408;
+    }
+    /** Human-readable error message suitable for displaying to the user. */
+    get userMessage() {
+        if (this.isCreditsError) {
+            return `${this.provider} credits are exhausted or billing is inactive. Please top up your account or switch providers.`;
+        }
+        if (this.isRateLimited) {
+            return `${this.provider} is rate-limiting requests. Retrying automatically — this may take a moment.`;
+        }
+        if (this.isAuthError) {
+            return `${this.provider} API key is missing or invalid. Please check your credentials.`;
+        }
+        if (this.isTimeout) {
+            return `${this.provider} took too long to respond. The service may be overloaded — try again shortly.`;
+        }
+        if (this.statusCode && this.statusCode >= 500) {
+            return `${this.provider} is experiencing server issues (${this.statusCode}). This is usually temporary.`;
+        }
+        return `${this.provider} returned an error. ${this.recoverable ? "Retrying…" : "Please check your configuration."}`;
+    }
+}
+/**
+ * Classify an HTTP status code + response body into a structured LLMError.
+ * Used by all providers to convert API error responses consistently.
+ */
+export function classifyApiError(provider, status, body, model) {
+    const msg = `${provider} ${status}: ${body}`;
+    // Non-recoverable: auth, billing, bad request
+    if (status === 401 || status === 403) {
+        return new LLMError(msg, provider, status, false);
+    }
+    if (status === 402) {
+        return new LLMError(msg, provider, status, false);
+    }
+    if (status === 400 || status === 404 || status === 422) {
+        return new LLMError(msg, provider, status, false);
+    }
+    // Recoverable: rate limits (retry after backoff)
+    if (status === 429) {
+        return new LLMError(msg, provider, status, true);
+    }
+    // Recoverable: server errors (transient)
+    if (status >= 500) {
+        return new LLMError(msg, provider, status, true);
+    }
+    // Unknown status — assume non-recoverable
+    return new LLMError(msg, provider, status, false);
+}
+//# sourceMappingURL=errors.js.map

package/dist/llm/errors.js.map

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

package/dist/llm/ollama.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Streaming Ollama client for Core.
+ * Local-first language processing — private, no cloud, no API key.
+ * Default model: llama3.2:3b (fits 3060 12GB comfortably).
+ */
+import type { StreamOptions } from "./openrouter.js";
+/**
+ * Check if Ollama is reachable and the model is available.
+ * Returns { available, model, error? }.
+ */
+export declare function checkOllama(model?: string): Promise<{
+    available: boolean;
+    model: string;
+    error?: string;
+}>;
+/**
+ * Stream a chat completion from Ollama (local).
+ * Same interface as OpenRouter's streamChat — drop-in swap.
+ */
+export declare function streamChatLocal(options: StreamOptions): Promise<void>;
+//# sourceMappingURL=ollama.d.ts.map

package/dist/llm/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/llm/ollama.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQrD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBhH;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+E3E"}

package/dist/llm/ollama.js

@@ -0,0 +1,116 @@
+/**
+ * Streaming Ollama client for Core.
+ * Local-first language processing — private, no cloud, no API key.
+ * Default model: llama3.2:3b (fits 3060 12GB comfortably).
+ */
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("llm.ollama");
+const OLLAMA_URL = process.env.OLLAMA_URL ?? "http://localhost:11434";
+const DEFAULT_MODEL = "llama3.1:8b";
+/**
+ * Check if Ollama is reachable and the model is available.
+ * Returns { available, model, error? }.
+ */
+export async function checkOllama(model) {
+    const m = model ?? process.env.OLLAMA_MODEL ?? DEFAULT_MODEL;
+    try {
+        // Check if Ollama is running
+        const res = await fetch(`${OLLAMA_URL}/api/tags`, { signal: AbortSignal.timeout(3000) });
+        if (!res.ok)
+            return { available: false, model: m, error: "Ollama not responding" };
+        const data = await res.json();
+        const models = data.models ?? [];
+        const found = models.some((entry) => entry.name === m || entry.name.startsWith(m + ":"));
+        if (!found) {
+            return { available: false, model: m, error: `Model "${m}" not found. Run: ollama pull ${m}` };
+        }
+        return { available: true, model: m };
+    }
+    catch {
+        log.warn("Ollama not reachable", { url: OLLAMA_URL, model: m });
+        return { available: false, model: m, error: "Ollama not reachable at " + OLLAMA_URL };
+    }
+}
+/**
+ * Stream a chat completion from Ollama (local).
+ * Same interface as OpenRouter's streamChat — drop-in swap.
+ */
+export async function streamChatLocal(options) {
+    const model = options.model ?? process.env.OLLAMA_MODEL ?? DEFAULT_MODEL;
+    log.debug("Ollama streaming chat request", { model, messageCount: options.messages.length });
+    const body = {
+        model,
+        messages: options.messages.map((m) => ({
+            role: m.role,
+            content: m.content, // string or ContentBlock[] — Ollama handles both
+        })),
+        stream: true,
+    };
+    let response;
+    try {
+        response = await fetch(`${OLLAMA_URL}/api/chat`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+            signal: options.signal,
+        });
+    }
+    catch (err) {
+        log.error("Ollama stream connection failed", { model, error: (err instanceof Error ? err : new Error(String(err))).message });
+        options.onError(err instanceof Error ? err : new Error(String(err)));
+        return;
+    }
+    if (!response.ok) {
+        const text = await response.text().catch(() => "unknown error");
+        log.error("Ollama stream API error", { status: response.status, body: text, model });
+        options.onError(new Error(`Ollama ${response.status}: ${text}`));
+        return;
+    }
+    const reader = response.body?.getReader();
+    if (!reader) {
+        options.onError(new Error("No response body"));
+        return;
+    }
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        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 parsed = JSON.parse(line);
+                    // Ollama format: { message: { content: "..." }, done: false }
+                    const content = parsed.message?.content;
+                    if (content) {
+                        options.onToken(content);
+                    }
+                    if (parsed.done) {
+                        options.onDone();
+                        return;
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        // Stream ended without done:true
+        options.onDone();
+    }
+    catch (err) {
+        if (options.signal?.aborted)
+            return;
+        options.onError(err instanceof Error ? err : new Error(String(err)));
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/llm/ollama.js.map

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

package/dist/llm/openrouter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Streaming OpenRouter client.
+ * Sends messages to OpenRouter's chat/completions endpoint and yields SSE tokens.
+ */
+/** @deprecated Import StreamOptions from "./providers/types.js" instead. */
+export type { StreamOptions } from "./providers/types.js";
+import type { StreamOptions } from "./providers/types.js";
+/**
+ * Stream a chat completion from OpenRouter.
+ * Calls onToken for each content delta, onDone when finished, onError on failure.
+ */
+export declare function streamChat(options: StreamOptions): Promise<void>;
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/llm/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../src/llm/openrouter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,4EAA4E;AAC5E,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQ1D;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6FtE"}

package/dist/llm/openrouter.js

@@ -0,0 +1,105 @@
+/**
+ * Streaming OpenRouter client.
+ * Sends messages to OpenRouter's chat/completions endpoint and yields SSE tokens.
+ */
+import { classifyApiError } from "./errors.js";
+import { createLogger } from "../utils/logger.js";
+import { getInstanceName } from "../instance.js";
+const log = createLogger("llm.openrouter");
+const OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";
+const DEFAULT_MODEL = "anthropic/claude-sonnet-4";
+/**
+ * Stream a chat completion from OpenRouter.
+ * Calls onToken for each content delta, onDone when finished, onError on failure.
+ */
+export async function streamChat(options) {
+    const apiKey = process.env.OPENROUTER_API_KEY;
+    if (!apiKey) {
+        options.onError(new Error("OPENROUTER_API_KEY not set"));
+        return;
+    }
+    const model = options.model ?? process.env.OPENROUTER_MODEL ?? DEFAULT_MODEL;
+    log.debug("Streaming chat request", { model, messageCount: options.messages.length });
+    const body = {
+        model,
+        messages: options.messages.map((m) => ({
+            role: m.role,
+            content: m.content, // string or ContentBlock[] — OpenRouter handles both
+        })),
+        stream: true,
+    };
+    let response;
+    try {
+        response = await fetch(OPENROUTER_URL, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+                "HTTP-Referer": "http://localhost:3577",
+                "X-Title": getInstanceName(),
+            },
+            body: JSON.stringify(body),
+            signal: options.signal,
+        });
+    }
+    catch (err) {
+        log.error("Stream connection failed", { model, error: (err instanceof Error ? err : new Error(String(err))).message });
+        options.onError(err instanceof Error ? err : new Error(String(err)));
+        return;
+    }
+    if (!response.ok) {
+        const text = await response.text().catch(() => "unknown error");
+        log.error("OpenRouter stream API error", { status: response.status, body: text, model });
+        options.onError(classifyApiError("OpenRouter", response.status, text, model));
+        return;
+    }
+    const reader = response.body?.getReader();
+    if (!reader) {
+        options.onError(new Error("No response body"));
+        return;
+    }
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            // Keep the last incomplete line in the buffer
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed || !trimmed.startsWith("data: "))
+                    continue;
+                const data = trimmed.slice(6);
+                if (data === "[DONE]") {
+                    options.onDone();
+                    return;
+                }
+                try {
+                    const parsed = JSON.parse(data);
+                    const delta = parsed.choices?.[0]?.delta?.content;
+                    if (delta) {
+                        options.onToken(delta);
+                    }
+                }
+                catch {
+                    // Skip malformed JSON lines
+                }
+            }
+        }
+        // Stream ended without [DONE]
+        options.onDone();
+    }
+    catch (err) {
+        if (options.signal?.aborted)
+            return;
+        options.onError(err instanceof Error ? err : new Error(String(err)));
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/llm/openrouter.js.map

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

package/dist/llm/providers/anthropic.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Direct Anthropic API provider for Core.
+ * Uses the Messages API (https://docs.anthropic.com/en/api/messages).
+ * No SDK dependency — raw fetch with SSE parsing.
+ */
+import type { LLMProvider } from "./types.js";
+export declare const anthropicProvider: LLMProvider;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/llm/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AA4D7D,eAAO,MAAM,iBAAiB,EAAE,WAqJ/B,CAAC"}