@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/providers/local-context-ingestion.js

@@ -0,0 +1,119 @@
+/**
+ * local-context-ingestion.ts
+ *
+ * Local provider `max_context_length` ingestion.
+ *
+ * Fetches the /v1/models endpoint for local/custom providers and extracts
+ * per-model `max_context_length` values. Results are keyed by model ID and
+ * stored in an in-memory cache per provider.
+ *
+ * Feature flag: `local-provider-context-ingestion`
+ * When disabled, this module is a no-op and callers fall back to the
+ * statically-configured context window.
+ *
+ * Provenance ladder (highest to lowest):
+ *   provider_api     — value from /v1/models max_context_length
+ *   configured_cap   — explicit contextWindow in custom provider config
+ *   fallback         — DEFAULT_CONTEXT_WINDOW constant
+ */
+import { logger } from '../utils/logger.js';
+import { discoverContextWindows } from './context-discovery.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Default fallback context window when neither the API nor the config
+ * provides a value.
+ */
+export const DEFAULT_CONTEXT_WINDOW = 8_192;
+/**
+ * Grace period between ingestion attempts for the same provider.
+ * Prevents hammering a slow or offline local server.
+ */
+const CACHE_TTL_MS = 60_000; // 1 minute
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Ingest context window data from a local provider's /v1/models endpoint.
+ *
+ * Results are cached in-memory for `CACHE_TTL_MS`. Repeated calls within the
+ * TTL return the cached value immediately without making a network request.
+ *
+ * @param providerName - Unique provider name (used as cache key).
+ * @param baseURL      - Provider base URL (e.g. `http://localhost:11434/v1`).
+ * @param apiKey       - Optional API key sent as Bearer token.
+ * @returns Map of model ID → raw context length from the API, or null if
+ *          the provider is offline or returned an unrecognised response.
+ */
+export class LocalContextIngestionService {
+    providerCache = new Map();
+    async ingestProviderContextWindows(providerName, baseURL, apiKey) {
+        const now = Date.now();
+        const cached = this.providerCache.get(providerName);
+        if (cached && now - cached.fetchedAt < CACHE_TTL_MS) {
+            return cached.failed ? null : cached.models;
+        }
+        // Use multi-endpoint discovery (probes LM Studio, Ollama, OpenAI-compat, llama.cpp, TGI)
+        // Returns an empty Map when all probes fail — treat that as a fetch failure.
+        const discovered = await discoverContextWindows(baseURL, apiKey);
+        const failed = discovered.size === 0;
+        this.providerCache.set(providerName, {
+            fetchedAt: now,
+            models: discovered,
+            failed,
+        });
+        return failed ? null : discovered;
+    }
+    clearProviderCache(providerName) {
+        this.providerCache.delete(providerName);
+    }
+    clearAllCaches() {
+        this.providerCache.clear();
+    }
+    getDiagnostics() {
+        return Array.from(this.providerCache.entries()).map(([providerName, entry]) => ({
+            providerName,
+            fetchedAt: entry.fetchedAt,
+            modelCount: entry.models.size,
+            failed: entry.failed,
+        }));
+    }
+}
+/**
+ * Resolve the effective context window for a single model with provenance.
+ *
+ * Priority ladder:
+ *   1. provider_api  — `apiContextLength` when valid (> 0)
+ *   2. configured_cap — `configuredContextWindow` when valid (> 0)
+ *   3. fallback      — `DEFAULT_CONTEXT_WINDOW`
+ *
+ * @param modelId                - Model ID (for logging).
+ * @param apiContextLength       - Context length from /v1/models (null if not available).
+ * @param configuredContextWindow - Context window from custom provider config (0 if not set).
+ * @returns Resolved context window with provenance metadata.
+ */
+export function resolveContextWindow(modelId, apiContextLength, configuredContextWindow) {
+    if (apiContextLength !== null && apiContextLength > 0) {
+        return {
+            tokens: apiContextLength,
+            provenance: 'provider_api',
+            apiReportedTokens: apiContextLength,
+            safeCap: apiContextLength,
+        };
+    }
+    if (configuredContextWindow > 0) {
+        return {
+            tokens: configuredContextWindow,
+            provenance: 'configured_cap',
+        };
+    }
+    logger.debug('[local-context-ingestion] No context window available, using fallback', {
+        modelId,
+        fallback: DEFAULT_CONTEXT_WINDOW,
+    });
+    return {
+        tokens: DEFAULT_CONTEXT_WINDOW,
+        provenance: 'fallback',
+    };
+}

package/dist/platform/providers/microsoft-foundry-shared.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeFoundryEndpoint(endpoint: string): string;
+export declare function buildFoundryV1BaseUrl(endpoint: string): string;
+//# sourceMappingURL=microsoft-foundry-shared.d.ts.map

package/dist/platform/providers/microsoft-foundry-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft-foundry-shared.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/microsoft-foundry-shared.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAajE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/platform/providers/microsoft-foundry-shared.js

@@ -0,0 +1,20 @@
+export function normalizeFoundryEndpoint(endpoint) {
+    const trimmed = endpoint.trim();
+    if (!trimmed)
+        return trimmed;
+    try {
+        const parsed = new URL(trimmed);
+        parsed.search = '';
+        parsed.hash = '';
+        const normalizedPath = parsed.pathname.replace(/\/openai(?:$|\/).*/i, '').replace(/\/+$/, '');
+        return `${parsed.origin}${normalizedPath && normalizedPath !== '/' ? normalizedPath : ''}`;
+    }
+    catch {
+        const withoutQuery = trimmed.replace(/[?#].*$/, '').replace(/\/+$/, '');
+        return withoutQuery.replace(/\/openai(?:$|\/).*/i, '');
+    }
+}
+export function buildFoundryV1BaseUrl(endpoint) {
+    const base = normalizeFoundryEndpoint(endpoint);
+    return base.endsWith('/openai/v1') ? base : `${base}/openai/v1`;
+}

package/dist/platform/providers/model-benchmarks.d.ts

@@ -0,0 +1,43 @@
+export interface ModelBenchmarks {
+    gpqa?: number;
+    swe?: number;
+    aime?: number;
+    terminal?: number;
+    tool?: number;
+    mcp?: number;
+}
+export interface BenchmarkEntry {
+    modelId: string;
+    name: string;
+    organization: string;
+    benchmarks: ModelBenchmarks;
+}
+export type QualityTier = 'S' | 'A' | 'B' | 'C';
+export declare const S_TIER_THRESHOLD = 0.8;
+export declare const A_TIER_THRESHOLD = 0.65;
+export declare const B_TIER_THRESHOLD = 0.5;
+export declare function compositeScore(benchmarks: ModelBenchmarks): number | null;
+export declare function getQualityTier(benchmarks: ModelBenchmarks): QualityTier;
+export declare function getQualityTierFromScore(score: number): QualityTier;
+export interface BenchmarkStoreOptions {
+    readonly dir: string;
+}
+export declare class BenchmarkStore {
+    private readonly dir;
+    private cache;
+    private nameIndex;
+    private readonly refreshCallbacks;
+    constructor(options: BenchmarkStoreOptions);
+    getCachePath(): string;
+    private getTmpPath;
+    onRefreshed(callback: () => void): () => void;
+    initBenchmarks(): void;
+    refreshBenchmarks(): Promise<void>;
+    getBenchmarks(modelName: string): BenchmarkEntry | undefined;
+    getTopBenchmarkModelIds(n: number): string[];
+    private fetchBenchmarks;
+    private loadCache;
+    private saveCache;
+    private isCacheStale;
+}
+//# sourceMappingURL=model-benchmarks.d.ts.map

package/dist/platform/providers/model-benchmarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-benchmarks.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/model-benchmarks.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AA+ChD,eAAO,MAAM,gBAAgB,MAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,MAAO,CAAC;AAgErC,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAOzE;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,WAAW,CAIvE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAKlE;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;gBAE9C,OAAO,EAAE,qBAAqB;IAI1C,YAAY,IAAI,MAAM;IAItB,OAAO,CAAC,UAAU;IAIlB,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO7C,cAAc,IAAI,IAAI;IAUhB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBxC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAgE5D,uBAAuB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;YAW9B,eAAe;IAiB7B,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,YAAY;CAGrB"}

package/dist/platform/providers/model-benchmarks.js

@@ -0,0 +1,268 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+const ZEROEVAL_URL = 'https://api.zeroeval.com/leaderboard/models/full?justCanonicals=true';
+const FETCH_TIMEOUT_MS = 20_000;
+const CACHE_TTL_MS = 86_400_000;
+export const S_TIER_THRESHOLD = 0.80;
+export const A_TIER_THRESHOLD = 0.65;
+export const B_TIER_THRESHOLD = 0.50;
+function pickFirst(...values) {
+    for (const value of values) {
+        if (value != null)
+            return value;
+    }
+    return undefined;
+}
+function parseScore(value) {
+    if (value == null || Number.isNaN(value))
+        return undefined;
+    return value > 1 ? value / 100 : value;
+}
+function extractBenchmarks(model) {
+    const scores = model.scores ?? {};
+    const raw = {
+        gpqa: pickFirst(model.gpqa_score, model.gpqa_diamond, model.gpqa, scores.gpqa_score, scores.gpqa_diamond, scores.gpqa),
+        swe: pickFirst(model.swe_bench_verified_score, model.swe_bench, model.swe, scores.swe_bench_verified_score, scores.swe_bench, scores.swe),
+        aime: pickFirst(model.aime_2025_score, model.aime_2024, model.aime, scores.aime_2025_score, scores.aime_2024, scores.aime),
+        terminal: pickFirst(model.terminal_bench_score, model.terminal_bench, model.terminal, scores.terminal_bench_score, scores.terminal_bench, scores.terminal),
+        tool: pickFirst(model.toolathlon_score, model.tool_use, model.tool, scores.toolathlon_score, scores.tool_use, scores.tool),
+        mcp: pickFirst(model.mcp_atlas_score, model.mcp_bench, model.mcp, scores.mcp_atlas_score, scores.mcp_bench, scores.mcp),
+    };
+    const benchmarks = {};
+    if (raw.gpqa != null)
+        benchmarks.gpqa = parseScore(raw.gpqa);
+    if (raw.swe != null)
+        benchmarks.swe = parseScore(raw.swe);
+    if (raw.aime != null)
+        benchmarks.aime = parseScore(raw.aime);
+    if (raw.terminal != null)
+        benchmarks.terminal = parseScore(raw.terminal);
+    if (raw.tool != null)
+        benchmarks.tool = parseScore(raw.tool);
+    if (raw.mcp != null)
+        benchmarks.mcp = parseScore(raw.mcp);
+    return benchmarks;
+}
+function parseEntries(json) {
+    const raw = Array.isArray(json)
+        ? json
+        : (json.models ?? json.data ?? json.leaderboard ?? []);
+    if (!Array.isArray(raw)) {
+        logger.warn('[model-benchmarks] Unexpected ZeroEval response shape');
+        return [];
+    }
+    return raw.map((model) => ({
+        modelId: String(model.id ?? model.model_id ?? ''),
+        name: String(model.name ?? model.model_name ?? model.id ?? model.model_id ?? ''),
+        organization: String(model.organization ?? model.org ?? ''),
+        benchmarks: extractBenchmarks(model),
+    }));
+}
+function buildNameIndex(entries) {
+    const index = new Map();
+    for (const entry of entries) {
+        index.set(entry.name.toLowerCase(), entry);
+        if (entry.modelId) {
+            index.set(entry.modelId.toLowerCase(), entry);
+        }
+    }
+    return index;
+}
+export function compositeScore(benchmarks) {
+    let total = 0;
+    let weight = 0;
+    if (benchmarks.swe != null) {
+        total += benchmarks.swe * 0.4;
+        weight += 0.4;
+    }
+    if (benchmarks.gpqa != null) {
+        total += benchmarks.gpqa * 0.4;
+        weight += 0.4;
+    }
+    if (benchmarks.aime != null) {
+        total += benchmarks.aime * 0.2;
+        weight += 0.2;
+    }
+    return weight === 0 ? null : total / weight;
+}
+export function getQualityTier(benchmarks) {
+    const score = compositeScore(benchmarks);
+    if (score == null)
+        return 'C';
+    return getQualityTierFromScore(score);
+}
+export function getQualityTierFromScore(score) {
+    if (score >= S_TIER_THRESHOLD)
+        return 'S';
+    if (score >= A_TIER_THRESHOLD)
+        return 'A';
+    if (score >= B_TIER_THRESHOLD)
+        return 'B';
+    return 'C';
+}
+export class BenchmarkStore {
+    dir;
+    cache = null;
+    nameIndex = null;
+    refreshCallbacks = new Set();
+    constructor(options) {
+        this.dir = options.dir;
+    }
+    getCachePath() {
+        return join(this.dir, 'benchmarks.json');
+    }
+    getTmpPath() {
+        return `${this.getCachePath()}.tmp`;
+    }
+    onRefreshed(callback) {
+        this.refreshCallbacks.add(callback);
+        return () => {
+            this.refreshCallbacks.delete(callback);
+        };
+    }
+    initBenchmarks() {
+        this.cache = this.loadCache();
+        this.nameIndex = this.cache ? buildNameIndex(this.cache.entries) : null;
+        if (!this.cache || this.isCacheStale(this.cache)) {
+            void this.refreshBenchmarks().catch((err) => {
+                logger.debug('[model-benchmarks] Background refresh failed', { error: summarizeError(err) });
+            });
+        }
+    }
+    async refreshBenchmarks() {
+        const entries = await this.fetchBenchmarks();
+        if (entries.length === 0) {
+            logger.warn('[model-benchmarks] Refresh returned 0 entries — keeping existing cache');
+            return;
+        }
+        const next = {
+            version: 1,
+            fetchedAt: Date.now(),
+            ttlMs: CACHE_TTL_MS,
+            entries,
+        };
+        this.saveCache(next);
+        this.cache = next;
+        this.nameIndex = buildNameIndex(entries);
+        for (const callback of this.refreshCallbacks)
+            callback();
+        logger.debug('[model-benchmarks] Cache updated', { count: entries.length });
+    }
+    getBenchmarks(modelName) {
+        const entries = this.cache?.entries;
+        if (!entries || entries.length === 0)
+            return undefined;
+        const index = this.nameIndex ?? buildNameIndex(entries);
+        const exact = entries.find((entry) => entry.name === modelName || entry.modelId === modelName);
+        if (exact)
+            return exact;
+        const lower = modelName.toLowerCase();
+        const indexed = index.get(lower);
+        if (indexed)
+            return indexed;
+        const slug = lower.replace(/[^a-z0-9]/g, '');
+        if (slug.length > 0) {
+            let slugBest;
+            let slugBestLen = Infinity;
+            let slugPrefixBest;
+            let slugPrefixBestLen = Infinity;
+            for (const entry of entries) {
+                const nameSlug = entry.name.toLowerCase().replace(/[^a-z0-9]/g, '');
+                const idSlug = entry.modelId.toLowerCase().replace(/[^a-z0-9]/g, '');
+                if (nameSlug === slug || idSlug === slug) {
+                    const len = Math.min(nameSlug === slug ? entry.name.length : Infinity, idSlug === slug ? entry.modelId.length : Infinity);
+                    if (len < slugBestLen) {
+                        slugBestLen = len;
+                        slugBest = entry;
+                    }
+                }
+                else if (nameSlug.startsWith(slug) || idSlug.startsWith(slug)) {
+                    const len = Math.min(nameSlug.startsWith(slug) ? entry.name.length : Infinity, idSlug.startsWith(slug) ? entry.modelId.length : Infinity);
+                    if (len < slugPrefixBestLen) {
+                        slugPrefixBestLen = len;
+                        slugPrefixBest = entry;
+                    }
+                }
+            }
+            if (slugBest)
+                return slugBest;
+            if (slugPrefixBest)
+                return slugPrefixBest;
+        }
+        let best;
+        let bestLen = Infinity;
+        for (const entry of entries) {
+            const nameLower = entry.name.toLowerCase();
+            const idLower = entry.modelId.toLowerCase();
+            if (nameLower.includes(lower) || idLower.includes(lower)) {
+                const len = Math.min(nameLower.includes(lower) ? entry.name.length : Infinity, idLower.includes(lower) ? entry.modelId.length : Infinity);
+                if (len < bestLen) {
+                    bestLen = len;
+                    best = entry;
+                }
+            }
+        }
+        return best;
+    }
+    getTopBenchmarkModelIds(n) {
+        const entries = this.cache?.entries;
+        if (!entries || entries.length === 0)
+            return [];
+        return entries
+            .map((entry) => ({ id: entry.modelId, score: compositeScore(entry.benchmarks) }))
+            .filter((entry) => entry.score != null)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, n)
+            .map((entry) => entry.id);
+    }
+    async fetchBenchmarks() {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        try {
+            const response = await fetch(ZEROEVAL_URL, {
+                signal: controller.signal,
+                headers: { Accept: 'application/json' },
+            });
+            if (!response.ok) {
+                throw new Error(`ZeroEval API returned ${response.status} ${response.statusText}`);
+            }
+            return parseEntries(await response.json());
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    loadCache() {
+        try {
+            const parsed = JSON.parse(readFileSync(this.getCachePath(), 'utf-8'));
+            if (parsed.version !== 1 || !Array.isArray(parsed.entries))
+                return null;
+            return parsed;
+        }
+        catch (err) {
+            const message = summarizeError(err);
+            if (message.includes('ENOENT') || message.includes('no such file')) {
+                logger.debug('[model-benchmarks] No cache file found (first run)');
+            }
+            else {
+                logger.warn('[model-benchmarks] Cache load failed (corrupted?)', { error: message });
+            }
+            return null;
+        }
+    }
+    saveCache(cache) {
+        try {
+            mkdirSync(this.dir, { recursive: true });
+            writeFileSync(this.getTmpPath(), JSON.stringify(cache, null, 2), 'utf-8');
+            renameSync(this.getTmpPath(), this.getCachePath());
+        }
+        catch (err) {
+            logger.warn('[model-benchmarks] Cache write failed', { error: summarizeError(err) });
+        }
+    }
+    isCacheStale(cache) {
+        return Date.now() - cache.fetchedAt > cache.ttlMs;
+    }
+}

package/dist/platform/providers/openai-stream-delta.d.ts

@@ -0,0 +1,13 @@
+export interface OpenAIStreamTextDelta {
+    content: string[];
+    reasoning: string[];
+}
+export interface OpenAIStreamTextDeltaOptions {
+    allowReasoning?: boolean;
+}
+/**
+ * Normalize the wide variety of OpenAI-compatible streaming delta shapes into
+ * plain content/reasoning text fragments.
+ */
+export declare function extractOpenAIStreamTextDelta(rawChunk: unknown, options?: OpenAIStreamTextDeltaOptions): OpenAIStreamTextDelta;
+//# sourceMappingURL=openai-stream-delta.d.ts.map

package/dist/platform/providers/openai-stream-delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-stream-delta.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/openai-stream-delta.ts"],"names":[],"mappings":"AAmFA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAuCvB"}

package/dist/platform/providers/openai-stream-delta.js

@@ -0,0 +1,121 @@
+function asString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+function collectTextFragments(value, keys) {
+    if (!Array.isArray(value))
+        return [];
+    const fragments = [];
+    for (const entry of value) {
+        if (typeof entry === 'string') {
+            if (entry.length > 0)
+                fragments.push(entry);
+            continue;
+        }
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const record = entry;
+        if (typeof record.type === 'string')
+            continue;
+        for (const key of keys) {
+            const found = asString(record[key]);
+            if (found) {
+                fragments.push(found);
+                break;
+            }
+        }
+    }
+    return fragments;
+}
+function collectContentFragments(value, options) {
+    if (!Array.isArray(value))
+        return [];
+    const fragments = [];
+    for (const entry of value) {
+        if (typeof entry === 'string') {
+            if (entry.length > 0)
+                fragments.push(entry);
+            continue;
+        }
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const record = entry;
+        const type = typeof record.type === 'string' ? record.type.toLowerCase() : '';
+        const text = asString(record.text)
+            ?? asString(record.content)
+            ?? asString(record.reasoning)
+            ?? asString(record.thinking)
+            ?? asString(record.delta);
+        if (!text)
+            continue;
+        if (!type) {
+            fragments.push(text);
+            continue;
+        }
+        const isReasoning = type.includes('reason') || type.includes('think');
+        if (!isReasoning || options.includeTypedReasoning) {
+            fragments.push(text);
+        }
+    }
+    return fragments;
+}
+function collectTypedContentFragments(value, kind) {
+    if (!Array.isArray(value))
+        return [];
+    const fragments = [];
+    for (const entry of value) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const record = entry;
+        const type = typeof record.type === 'string' ? record.type.toLowerCase() : '';
+        const text = asString(record.text)
+            ?? asString(record.content)
+            ?? asString(record.reasoning)
+            ?? asString(record.thinking)
+            ?? asString(record.delta);
+        if (!text)
+            continue;
+        const isReasoning = type.includes('reason') || type.includes('think');
+        if (kind === 'reasoning' && isReasoning)
+            fragments.push(text);
+        if (kind === 'content' && !isReasoning)
+            fragments.push(text);
+    }
+    return fragments;
+}
+/**
+ * Normalize the wide variety of OpenAI-compatible streaming delta shapes into
+ * plain content/reasoning text fragments.
+ */
+export function extractOpenAIStreamTextDelta(rawChunk, options = {}) {
+    const allowReasoning = options.allowReasoning ?? true;
+    const raw = rawChunk;
+    const delta = raw.choices?.[0]?.delta ?? {};
+    const deltaContent = delta.content;
+    const deltaReasoningContent = delta.reasoning_content;
+    const stringContent = asString(deltaContent);
+    const stringReasoning = asString(delta.reasoning);
+    const stringReasoningContent = asString(deltaReasoningContent);
+    const stringReasoningSummary = asString(raw.reasoning_summary);
+    const content = [
+        ...(stringContent ? [stringContent] : []),
+        ...collectContentFragments(deltaContent, { includeTypedReasoning: !allowReasoning }),
+        ...(!allowReasoning
+            ? [
+                ...(stringReasoning ? [stringReasoning] : []),
+                ...(stringReasoningContent ? [stringReasoningContent] : []),
+                ...(stringReasoningSummary ? [stringReasoningSummary] : []),
+                ...collectTextFragments(deltaReasoningContent, ['text', 'content', 'reasoning', 'thinking', 'delta']),
+            ]
+            : []),
+    ];
+    const reasoning = allowReasoning
+        ? [
+            ...(stringReasoning ? [stringReasoning] : []),
+            ...(stringReasoningContent ? [stringReasoningContent] : []),
+            ...(stringReasoningSummary ? [stringReasoningSummary] : []),
+            ...collectTypedContentFragments(deltaContent, 'reasoning'),
+            ...collectTextFragments(deltaReasoningContent, ['text', 'content', 'reasoning', 'thinking', 'delta']),
+        ]
+        : [];
+    return { content, reasoning };
+}

package/dist/platform/runtime/auth/oauth-core.d.ts

@@ -0,0 +1,32 @@
+import type { OAuthProviderConfig } from '../../config/subscriptions.js';
+export interface OAuthStartState {
+    readonly authorizationUrl: string;
+    readonly state: string;
+    readonly verifier: string;
+    readonly redirectUri: string;
+}
+export interface OAuthTokenPayload {
+    readonly accessToken: string;
+    readonly refreshToken?: string;
+    readonly tokenType: string;
+    readonly expiresAt?: number;
+    readonly scopes?: readonly string[];
+}
+export declare function createOAuthState(bytes?: number): string;
+export declare function createPkceVerifier(bytes?: number): string;
+export declare function createPkceChallenge(verifier: string): string;
+export declare function parseOAuthScopes(raw: unknown): readonly string[] | undefined;
+export declare function buildOAuthAuthorizationStart(config: OAuthProviderConfig, input?: {
+    readonly state?: string;
+    readonly verifier?: string;
+    readonly redirectUri?: string;
+}): OAuthStartState;
+export declare function exchangeOAuthAuthorizationCode(config: OAuthProviderConfig, input: {
+    readonly code: string;
+    readonly verifier: string;
+    readonly redirectUri: string;
+    readonly state?: string;
+}): Promise<OAuthTokenPayload>;
+export declare function refreshOAuthAccessToken(config: OAuthProviderConfig, refreshToken: string): Promise<OAuthTokenPayload>;
+export declare function decodeJwtPayload(token: string): Record<string, unknown> | null;
+//# sourceMappingURL=oauth-core.d.ts.map

package/dist/platform/runtime/auth/oauth-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-core.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/auth/oauth-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,SAAK,GAAG,MAAM,CAErD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAI5E;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,KAAK,CAAC,EAAE;IACN,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,GACA,eAAe,CA4BjB;AA4CD,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ9E"}