typebulb 0.12.0 → 0.13.1

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

@@ -0,0 +1,65 @@
+/**
+ * OpenRouter API (Chat Completions style with choices[]) — wire types and provider implementation.
+ */
+import type { ChatMessageDto, UpstreamErrorDto, ChatStreamPieceDto, ChatResponseDto, ProviderResponseDto, ProviderStreamEventDto } from '../protocol.js';
+import { AIProvider, type ChatRequestOpts } from '../aiProvider.js';
+export interface OpenRouterMessageDto {
+    content: string;
+    reasoning?: string;
+}
+export interface OpenRouterChoiceDto {
+    message?: OpenRouterMessageDto;
+    text?: string;
+}
+export interface OpenRouterResponseDto extends ProviderResponseDto {
+    choices: OpenRouterChoiceDto[];
+    reasoning?: string;
+}
+export interface OpenRouterDeltaDto {
+    content?: string;
+    reasoning?: string;
+}
+export interface OpenRouterStreamChoiceDto {
+    delta?: OpenRouterDeltaDto;
+    message?: OpenRouterDeltaDto;
+}
+export interface OpenRouterStreamEventDto extends ProviderStreamEventDto {
+    choices: OpenRouterStreamChoiceDto[];
+}
+export interface OpenRouterErrorResponseDto {
+    error: {
+        message: string;
+        type?: string;
+        code?: string;
+    };
+}
+export type OpenRouterSseEventDto = OpenRouterStreamEventDto | OpenRouterErrorResponseDto;
+/** OpenRouter web search plugin */
+interface OpenRouterWebPlugin {
+    id: 'web';
+    max_results?: number;
+}
+/** OpenRouter request payload */
+export type OpenRouterRequestPayload = {
+    model: string;
+    messages: ChatMessageDto[];
+    stream: boolean;
+    reasoning?: {
+        effort: 'low' | 'medium' | 'high';
+    };
+    plugins?: OpenRouterWebPlugin[];
+};
+export declare class OpenRouterProvider extends AIProvider {
+    protected readonly providerName = "OpenRouter";
+    readonly defaultBaseUrl = "https://openrouter.ai/api";
+    readonly path: string;
+    private readonly effortMap;
+    buildHeaders(apiKey: string, origin?: string): Record<string, string>;
+    buildPayload(messages: ChatMessageDto[], model: string, opts: ChatRequestOpts, stream: boolean): OpenRouterRequestPayload;
+    parseError(errorText: string, status: number): UpstreamErrorDto;
+    parseNonStreamingResponse(json: ProviderResponseDto): ChatResponseDto;
+    protected parseProviderStreamChunk(json: ProviderStreamEventDto): ChatStreamPieceDto | null;
+    private hasChoices;
+}
+export {};
+//# sourceMappingURL=openRouter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openRouter.d.ts","sourceRoot":"","sources":["../../../ai/src/providers/openRouter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKnE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,oBAAoB,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAGD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B;AAED,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,OAAO,EAAE,yBAAyB,EAAE,CAAA;CACrC;AAGD,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAGD,MAAM,MAAM,qBAAqB,GAC7B,wBAAwB,GACxB,0BAA0B,CAAA;AAI9B,mCAAmC;AACnC,UAAU,mBAAmB;IAC3B,EAAE,EAAE,KAAK,CAAA;IACT,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,iCAAiC;AACjC,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;KAAE,CAAA;IACjD,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAA;CAChC,CAAA;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,SAAS,CAAC,QAAQ,CAAC,YAAY,gBAAe;IAC9C,QAAQ,CAAC,cAAc,+BAA8B;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAA6B;IAElD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAKzB;IAID,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBrE,YAAY,CACV,QAAQ,EAAE,cAAc,EAAE,EAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,OAAO,GACd,wBAAwB;IAqB3B,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB;IAM/D,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe;IAarE,SAAS,CAAC,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,GAAG,IAAI;IAmB3F,OAAO,CAAC,UAAU;CAGnB"}

package/dist/ai/providers/openRouter.js

@@ -0,0 +1,82 @@
+import { AIProvider } from '../aiProvider.js';
+export class OpenRouterProvider extends AIProvider {
+    constructor() {
+        super(...arguments);
+        this.providerName = 'OpenRouter';
+        this.defaultBaseUrl = 'https://openrouter.ai/api';
+        this.path = '/api/v1/chat/completions';
+        this.effortMap = {
+            0: 'low',
+            1: 'low',
+            2: 'medium',
+            3: 'high'
+        };
+    }
+    // ── Request building ─────────────────────────────────────────────
+    buildHeaders(apiKey, origin) {
+        const headers = {
+            'Authorization': `Bearer ${apiKey}`,
+            'x-api-key': apiKey,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            'X-Title': 'Typebulb'
+        };
+        if (origin) {
+            headers['HTTP-Referer'] = origin;
+            headers['Referer'] = origin;
+            headers['Origin'] = origin;
+        }
+        return headers;
+    }
+    buildPayload(messages, model, opts, stream) {
+        const payload = {
+            model,
+            messages,
+            stream
+        };
+        // Web search disabled for OpenRouter - $0.02/request via Exa.ai is expensive
+        if (opts?.webSearch === true) {
+            payload.plugins = [{ id: 'web' }];
+        }
+        if (this.isReasoningEnabled(opts)) {
+            payload.reasoning = {
+                effort: this.effortMap[opts.reasoning]
+            };
+        }
+        return payload;
+    }
+    parseError(errorText, status) {
+        return this.parseJsonError(errorText, status, true);
+    }
+    // ── Response parsing ─────────────────────────────────────────────
+    parseNonStreamingResponse(json) {
+        if (!this.hasChoices(json)) {
+            return { text: '' };
+        }
+        const resp = json;
+        const choice = resp.choices[0];
+        const text = choice?.message?.content ?? choice?.text ?? '';
+        const reasoning = choice?.message?.reasoning ?? resp.reasoning;
+        return { text, reasoning };
+    }
+    parseProviderStreamChunk(json) {
+        if (!this.hasChoices(json))
+            return null;
+        const choice = json.choices[0];
+        if (!choice)
+            return null;
+        const delta = choice.delta || choice.message;
+        if (!delta)
+            return null;
+        const text = delta.content || undefined;
+        const reasoning = delta.reasoning || undefined;
+        if (!text && !reasoning)
+            return null;
+        return { text, reasoning };
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    hasChoices(json) {
+        return typeof json === 'object' && json !== null && 'choices' in json && Array.isArray(json.choices);
+    }
+}
+//# sourceMappingURL=openRouter.js.map

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

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

package/dist/ai/sseParser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generic utilities for parsing Server-Sent Events (SSE) streams.
+ * Shared between client, CLI, and any other consumer of provider SSE streams.
+ */
+import type { ProviderProtocol } from './protocol.js';
+/**
+ * Parses an SSE block (text between \n\n delimiters) into a data payload.
+ * Handles multiple data: lines and the [DONE] sentinel.
+ */
+export declare function parseSseBlock<T = any>(block: string): T | 'done' | null;
+/**
+ * Reads an SSE stream and emits parsed chunks via callback.
+ * Handles buffering, block splitting, and error recovery.
+ *
+ * @param reader - ReadableStream reader to consume
+ * @param onChunk - Callback invoked for each parsed non-null chunk
+ * @param signal - Optional abort signal for cancellation
+ * @returns Object with whether any data was received
+ */
+export declare function consumeSseStream<T = any>(reader: ReadableStreamDefaultReader<Uint8Array>, onChunk: (chunk: T) => void, signal?: AbortSignal): Promise<{
+    receivedAnyData: boolean;
+}>;
+/**
+ * Consume a provider SSE stream into a single text string.
+ * Handles protocol detection, chunk parsing, and reasoning token filtering.
+ *
+ * @param response - Fetch Response with SSE body (from server or provider directly)
+ * @param protocol - Provider protocol. If omitted, read from X-Provider-Protocol header.
+ * @returns Accumulated text content (reasoning tokens discarded)
+ */
+export declare function consumeStreamText(response: Response, protocol?: ProviderProtocol): Promise<string>;
+//# sourceMappingURL=sseParser.d.ts.map

package/dist/ai/sseParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseParser.d.ts","sourceRoot":"","sources":["../../ai/src/sseParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAYrD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI,CAmBvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAC5C,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,EAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAmDvC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/ai/sseParser.js

@@ -0,0 +1,121 @@
+/**
+ * Generic utilities for parsing Server-Sent Events (SSE) streams.
+ * Shared between client, CLI, and any other consumer of provider SSE streams.
+ */
+import { getProvider } from './aiProviders.js';
+/** Find next SSE block separator (\n\n or \r\n\r\n), returning position and length */
+function findSeparator(buffer) {
+    const rnrn = buffer.indexOf('\r\n\r\n');
+    const nn = buffer.indexOf('\n\n');
+    if (rnrn !== -1 && (nn === -1 || rnrn < nn))
+        return { pos: rnrn, len: 4 };
+    if (nn !== -1)
+        return { pos: nn, len: 2 };
+    return { pos: -1, len: 0 };
+}
+/**
+ * Parses an SSE block (text between \n\n delimiters) into a data payload.
+ * Handles multiple data: lines and the [DONE] sentinel.
+ */
+export function parseSseBlock(block) {
+    const lines = block.split(/\r?\n/);
+    const dataLines = lines.filter(l => l.startsWith('data:'));
+    if (!dataLines.length)
+        return null;
+    const payloadStr = dataLines
+        .map(l => l.replace(/^data:\s?/, ''))
+        .join('\n')
+        .trim();
+    if (!payloadStr)
+        return null;
+    if (payloadStr === '[DONE]')
+        return 'done';
+    try {
+        return JSON.parse(payloadStr);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reads an SSE stream and emits parsed chunks via callback.
+ * Handles buffering, block splitting, and error recovery.
+ *
+ * @param reader - ReadableStream reader to consume
+ * @param onChunk - Callback invoked for each parsed non-null chunk
+ * @param signal - Optional abort signal for cancellation
+ * @returns Object with whether any data was received
+ */
+export async function consumeSseStream(reader, onChunk, signal) {
+    const decoder = new TextDecoder();
+    let buffer = '';
+    let receivedAnyData = false;
+    // reader.read() can block for seconds after cancel; race against abort for immediate exit
+    const abortPromise = signal
+        ? new Promise((_, reject) => {
+            if (signal.aborted)
+                reject(new Error('Aborted'));
+            signal.addEventListener('abort', () => reject(new Error('Aborted')), { once: true });
+        })
+        : null;
+    while (true) {
+        const readResult = abortPromise
+            ? await Promise.race([reader.read(), abortPromise])
+            : await reader.read();
+        const { done, value } = readResult;
+        if (done) {
+            // Process any remaining buffer content
+            if (buffer.trim()) {
+                const parsed = parseSseBlock(buffer);
+                if (parsed !== null && parsed !== 'done') {
+                    onChunk(parsed);
+                }
+            }
+            break;
+        }
+        receivedAnyData = true;
+        buffer += decoder.decode(value, { stream: true });
+        let { pos: sep, len: sepLen } = findSeparator(buffer);
+        while (sep !== -1) {
+            const block = buffer.slice(0, sep);
+            buffer = buffer.slice(sep + sepLen);
+            const parsed = parseSseBlock(block);
+            if (parsed === 'done') {
+                buffer = '';
+                break;
+            }
+            if (parsed !== null) {
+                onChunk(parsed);
+            }
+            ;
+            ({ pos: sep, len: sepLen } = findSeparator(buffer));
+        }
+    }
+    return { receivedAnyData };
+}
+/**
+ * Consume a provider SSE stream into a single text string.
+ * Handles protocol detection, chunk parsing, and reasoning token filtering.
+ *
+ * @param response - Fetch Response with SSE body (from server or provider directly)
+ * @param protocol - Provider protocol. If omitted, read from X-Provider-Protocol header.
+ * @returns Accumulated text content (reasoning tokens discarded)
+ */
+export async function consumeStreamText(response, protocol) {
+    const p = protocol
+        // Header set by server on success. Missing = server-generated error SSE;
+        // any provider parser handles it via checkAndThrowError's unified format.
+        ?? (response.headers.get('X-Provider-Protocol') || 'openai');
+    const spec = getProvider(p);
+    if (!response.body)
+        throw new Error('Response body is missing');
+    const reader = response.body.getReader();
+    let fullText = '';
+    await consumeSseStream(reader, (json) => {
+        const piece = spec.parseStreamChunk(json);
+        if (piece?.text)
+            fullText += piece.text;
+    });
+    return fullText;
+}
+//# sourceMappingURL=sseParser.js.map

package/dist/ai/sseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseParser.js","sourceRoot":"","sources":["../../ai/src/sseParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,sFAAsF;AACtF,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACvC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;IACzE,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;IACzC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAU,KAAa;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;IAE1D,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAElC,MAAM,UAAU,GAAG,SAAS;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;SACpC,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAA;IAET,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAC5B,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IAE1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAM,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA+C,EAC/C,OAA2B,EAC3B,MAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,eAAe,GAAG,KAAK,CAAA;IAE3B,0FAA0F;IAC1F,MAAM,YAAY,GAA0B,MAAM;QAChD,CAAC,CAAC,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/B,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;YAChD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACtF,CAAC,CAAC;QACJ,CAAC,CAAC,IAAI,CAAA;IAER,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,YAAY;YAC7B,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;YACnD,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QACvB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,UAAU,CAAA;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,uCAAuC;YACvC,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,aAAa,CAAI,MAAM,CAAC,CAAA;gBACvC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;oBACzC,OAAO,CAAC,MAAM,CAAC,CAAA;gBACjB,CAAC;YACH,CAAC;YACD,MAAK;QACP,CAAC;QAED,eAAe,GAAG,IAAI,CAAA;QACtB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAEjD,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QACrD,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAClC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,CAAA;YAEnC,MAAM,MAAM,GAAG,aAAa,CAAI,KAAK,CAAC,CAAA;YACtC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,GAAG,EAAE,CAAA;gBACX,MAAK;YACP,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,CAAA;YACjB,CAAC;YAED,CAAC;YAAA,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAkB,EAClB,QAA2B;IAE3B,MAAM,CAAC,GAAG,QAAQ;QAChB,yEAAyE;QACzE,0EAA0E;WACvE,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,QAAQ,CAAqB,CAAA;IAClF,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC/D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IACxC,IAAI,QAAQ,GAAG,EAAE,CAAA;IAEjB,MAAM,gBAAgB,CAAC,MAAM,EAAE,CAAC,IAAS,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,KAAK,EAAE,IAAI;YAAE,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/ai/stream.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared types for SSE streaming across chat and inference endpoints.
+ * Both features use the same error format.
+ */
+/** Error codes for streaming API failures */
+export type StreamErrorCode = 'rate_limit' | 'context_exceeded' | 'parse_error' | 'network' | 'unknown';
+/** Base error payload (shared between SSE responses and postMessage) */
+export interface StreamErrorPayload {
+    code?: StreamErrorCode;
+    message: string;
+    retryable?: boolean;
+}
+/**
+ * SSE error event format (adds type discriminator).
+ * Used by both /api/chat/stream and /api/infer endpoints.
+ */
+export interface StreamErrorDto extends Required<StreamErrorPayload> {
+    type: 'error';
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/ai/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../ai/src/stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,kBAAkB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,CAAA;AAEvG,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ,CAAC,kBAAkB,CAAC;IAClE,IAAI,EAAE,OAAO,CAAA;CACd"}

package/dist/ai/stream.js

@@ -0,0 +1,6 @@
+/**
+ * Shared types for SSE streaming across chat and inference endpoints.
+ * Both features use the same error format.
+ */
+export {};
+//# sourceMappingURL=stream.js.map

package/dist/ai/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../ai/src/stream.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/dts/cache.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Storage interface for cached DTS files and negative URL lookups.
+ *
+ * Implemented by:
+ * - TypesDB (web client) — wraps Dexie/IndexedDB
+ * - FsDtsCache (CLI) — wraps the filesystem under ~/.typebulb/cache/dts/
+ *
+ * The DTS resolver consumes this interface; consumers inject their own
+ * implementation.
+ */
+export interface DtsCache {
+    /** Get cached DTS content + source URL for a package. */
+    getCachedDts(pkg: string): Promise<{
+        content: string;
+        url?: string;
+    } | undefined>;
+    /** Cache DTS content for a package. */
+    setCachedDts(pkg: string, content: string, url?: string): Promise<void>;
+    /** Get cached .d.ts file content by URL. */
+    getCachedFile(url: string): Promise<string | undefined>;
+    /** Cache .d.ts file content by URL. */
+    setCachedFile(url: string, content: string): Promise<void>;
+    /** Check whether a URL is currently in the negative cache. */
+    isNegative(url: string): Promise<boolean>;
+    /** Record a negative lookup for a URL (with exponential backoff TTL). */
+    recordNegative(url: string): Promise<void>;
+    /** Clear a negative lookup for a URL. */
+    clearNegative(url: string): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../dts/src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IACjF,uCAAuC;IACvC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,4CAA4C;IAC5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,uCAAuC;IACvC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,8DAA8D;IAC9D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC,yEAAyE;IACzE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,yCAAyC;IACzC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C"}

package/dist/dts/cache.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache.js.map

package/dist/dts/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../dts/src/cache.ts"],"names":[],"mappings":""}

package/dist/dts/definitelyTypedProvider.d.ts

@@ -0,0 +1,20 @@
+import { type CdnClient } from 'typebulb/resolver';
+import { TypeProvider } from './typeProvider.js';
+import { TarballFetcher } from './tarballFetcher.js';
+import type { DtsCache } from './cache.js';
+import type { FetchDtsWithCache } from './fetchDts.js';
+export declare class DefinitelyTypedProvider extends TypeProvider {
+    private cdnClient;
+    private cache;
+    private tarballFetcher;
+    constructor(fetchDts: FetchDtsWithCache, cdnClient: CdnClient, cache: DtsCache, tarballFetcher?: TarballFetcher);
+    private typesNameCandidates;
+    private selectTypesVersion;
+    private fetchFromVersionedRoot;
+    resolve(pkg: string): Promise<{
+        dts: string;
+        url: string;
+        resolvedPkg: string;
+    } | undefined>;
+}
+//# sourceMappingURL=definitelyTypedProvider.d.ts.map

package/dist/dts/definitelyTypedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitelyTypedProvider.d.ts","sourceRoot":"","sources":["../../dts/src/definitelyTypedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,qBAAa,uBAAwB,SAAQ,YAAY;IAGrD,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,cAAc;gBAHtB,QAAQ,EAAE,iBAAiB,EACnB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,QAAQ,EACf,cAAc,iBAAuB;IAK/C,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,kBAAkB;YAeZ,sBAAsB;IAgC9B,OAAO,CAAC,GAAG,EAAE,MAAM;;;;;CAiB1B"}

package/dist/dts/definitelyTypedProvider.js

@@ -0,0 +1,93 @@
+import { PackageRef, semverService } from 'typebulb/resolver';
+import { TypeProvider } from './typeProvider.js';
+import { TarballFetcher } from './tarballFetcher.js';
+export class DefinitelyTypedProvider extends TypeProvider {
+    constructor(fetchDts, cdnClient, cache, tarballFetcher = new TarballFetcher()) {
+        super(fetchDts);
+        this.cdnClient = cdnClient;
+        this.cache = cache;
+        this.tarballFetcher = tarballFetcher;
+    }
+    typesNameCandidates(name) {
+        const base = name.startsWith('@') ? name.slice(1).replace('/', '__') : name;
+        if (!base.includes('.'))
+            return [base];
+        return [base, base.split('.').join('-'), base.split('.').join('')];
+    }
+    selectTypesVersion(versions, distTags, runtime) {
+        try {
+            if (runtime) {
+                const mj = semverService.majorOf(runtime);
+                const sameMajor = versions.filter(v => semverService.majorOf(v) === mj);
+                if (sameMajor.length)
+                    return sameMajor.sort((a, b) => semverService.cmp(b, a))[0];
+            }
+            const latest = distTags?.latest;
+            if (latest && versions.includes(latest))
+                return latest;
+            return versions[0];
+        }
+        catch {
+            return versions[0];
+        }
+    }
+    async fetchFromVersionedRoot(versionedRoot, parsed) {
+        const ref = new PackageRef(versionedRoot);
+        const version = ref.version;
+        if (!version)
+            return undefined;
+        let allFiles;
+        try {
+            allFiles = await this.tarballFetcher.fetchAndExtract(ref.name, version);
+        }
+        catch {
+            return undefined;
+        }
+        if (!allFiles || allFiles.size === 0)
+            return undefined;
+        for (const [p, content] of allFiles.entries()) {
+            const fileUrl = this.cdnClient.file(versionedRoot, p);
+            try {
+                await this.cache.setCachedFile(fileUrl, content);
+            }
+            catch { }
+        }
+        const candidates = parsed.subpath
+            ? [parsed.subpath + '.d.ts', parsed.subpath + '/index.d.ts']
+            : ['index.d.ts'];
+        for (const p of candidates) {
+            const content = allFiles.get(p);
+            if (content) {
+                return {
+                    dts: content,
+                    url: this.cdnClient.file(versionedRoot, p),
+                    resolvedPkg: parsed.subpath ? new PackageRef(parsed).format() : parsed.name,
+                };
+            }
+        }
+        return undefined;
+    }
+    async resolve(pkg) {
+        const parsed = PackageRef.parse(pkg);
+        if (!parsed.name)
+            return undefined;
+        for (const cand of this.typesNameCandidates(parsed.name)) {
+            const typesRoot = `@types/${cand}`;
+            let idx;
+            try {
+                idx = await this.cdnClient.fetchVersionsIndex(typesRoot);
+            }
+            catch {
+                continue;
+            }
+            if (!idx?.versions?.length)
+                continue;
+            const selected = this.selectTypesVersion(idx.versions, idx.distTags, parsed.version);
+            const res = await this.fetchFromVersionedRoot(`${typesRoot}@${selected}`, parsed);
+            if (res)
+                return res;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=definitelyTypedProvider.js.map

package/dist/dts/definitelyTypedProvider.js.map

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

package/dist/dts/dtsConfig.d.ts

@@ -0,0 +1,12 @@
+export declare const DtsConfig: {
+    readonly maxRelativeTypeRefs: 500;
+    readonly maxBareDeps: 8;
+    readonly maxBareDepth: 3;
+    readonly prefetchConcurrency: 4;
+    readonly negativeTtlMs: 10000;
+};
+export declare const DECLARATION_EXTENSIONS: readonly ["index.d.ts", "index.d.mts"];
+export declare const DTS_REGEX: RegExp;
+export declare function isDtsFile(p: string): boolean;
+export declare function makeDeclarationCandidates(base: string): string[];
+//# sourceMappingURL=dtsConfig.d.ts.map

package/dist/dts/dtsConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtsConfig.d.ts","sourceRoot":"","sources":["../../dts/src/dtsConfig.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAA;AAEV,eAAO,MAAM,sBAAsB,wCAAyC,CAAA;AAC5E,eAAO,MAAM,SAAS,QAAoB,CAAA;AAE1C,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAQ5C;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE"}

package/dist/dts/dtsConfig.js

@@ -0,0 +1,24 @@
+export const DtsConfig = {
+    maxRelativeTypeRefs: 500,
+    maxBareDeps: 8,
+    maxBareDepth: 3,
+    prefetchConcurrency: 4,
+    negativeTtlMs: 10000,
+};
+export const DECLARATION_EXTENSIONS = ['index.d.ts', 'index.d.mts'];
+export const DTS_REGEX = /\.d\.(ts|mts)$/i;
+export function isDtsFile(p) {
+    if (DTS_REGEX.test(p))
+        return true;
+    try {
+        const url = new URL(p, 'file://');
+        return url.search.includes('dts');
+    }
+    catch {
+        return p.includes('?') && p.includes('dts');
+    }
+}
+export function makeDeclarationCandidates(base) {
+    return [`${base}.d.ts`, `${base}.d.mts`];
+}
+//# sourceMappingURL=dtsConfig.js.map

package/dist/dts/dtsConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtsConfig.js","sourceRoot":"","sources":["../../dts/src/dtsConfig.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,mBAAmB,EAAE,GAAG;IACxB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,mBAAmB,EAAE,CAAC;IACtB,aAAa,EAAE,KAAM;CACb,CAAA;AAEV,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,YAAY,EAAE,aAAa,CAAU,CAAA;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG,iBAAiB,CAAA;AAE1C,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;QACjC,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,CAAC,GAAG,IAAI,OAAO,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAA;AAC1C,CAAC"}

package/dist/dts/dtsResolver.d.ts

@@ -0,0 +1,63 @@
+import { type CdnClient, type PackageRanges, type PackageService, type VersionResolver } from 'typebulb/resolver';
+import { VirtualFs } from './virtualFs.js';
+import type { DtsCache } from './cache.js';
+import type { ResolvedTypeDef } from './typeProvider.js';
+export type { TypeFetchResult, ModuleShim, ResolvedTypeFile, ResolvedTypeDef } from './typeProvider.js';
+export interface DtsResolverDeps {
+    cache: DtsCache;
+    cdnClient: CdnClient;
+    versionResolver: VersionResolver;
+    packageService: PackageService;
+}
+/**
+ * Resolves .d.ts files for a bulb's import set. Constructed via
+ * `createDtsResolver(deps)`; each instance owns its own providers, in-flight
+ * map, virtual filesystem, and fetch closure.
+ *
+ * Web client wires Dexie-backed cache + typebulb/resolver web bits.
+ * CLI wires FS-backed cache + typebulb/resolver Node bits.
+ */
+export declare class DtsResolver {
+    private readonly inFlight;
+    private readonly scanner;
+    private readonly cache;
+    private readonly cdnClient;
+    private readonly versionResolver;
+    private readonly packageService;
+    private readonly fetchDts;
+    private readonly typescriptProvider;
+    private readonly definitelyTypedProvider;
+    readonly virtualFs: VirtualFs;
+    constructor(deps: DtsResolverDeps);
+    private withInFlight;
+    /** Reset in-flight requests, e.g. when ranges change reactively in the web client. */
+    invalidate(): void;
+    private capArray;
+    private pushFileIfNew;
+    private createStubDef;
+    private trySubpathWithRootFallback;
+    private fetchViaProviders;
+    private subpathsMatch;
+    private fetchRootDts;
+    private extractPackageRootUrl;
+    private toVirtualPath;
+    private computeEntryPath;
+    private expandRelativeRefs;
+    /**
+     * Resolve one relative ref by trying each declaration-candidate URL in turn.
+     * Exits as soon as one candidate succeeds, but the caller continues to the
+     * next ref. (Subtle: this MUST be a separate function — folding it into the
+     * caller's loop body lets `return` short-circuit all remaining refs.)
+     */
+    private tryRelativeRef;
+    private isDifferentPackage;
+    private ambientlyDeclares;
+    private markFileAmbient;
+    private prefetchBareDeps;
+    private prefetchBareDepsRecursive;
+    resolve(code: string, ranges: PackageRanges, additionalPackages?: string[]): Promise<ResolvedTypeDef[]>;
+    private resolveOne;
+    private buildDefFromContent;
+}
+export declare function createDtsResolver(deps: DtsResolverDeps): DtsResolver;
+//# sourceMappingURL=dtsResolver.d.ts.map

package/dist/dts/dtsResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtsResolver.d.ts","sourceRoot":"","sources":["../../dts/src/dtsResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAIV,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEvG,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;IACpB,eAAe,EAAE,eAAe,CAAA;IAChC,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0D;IACnF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAyB;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;gBAEjB,IAAI,EAAE,eAAe;IAWjC,OAAO,CAAC,YAAY;IAQpB,sFAAsF;IACtF,UAAU,IAAI,IAAI;IAKlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;YAMP,0BAA0B;YAK1B,iBAAiB;IAU/B,OAAO,CAAC,aAAa;YAIP,YAAY;IAuB1B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,gBAAgB;YAUV,kBAAkB;IA0BhC;;;;;OAKG;YACW,cAAc;IAgC5B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,eAAe;YAKT,gBAAgB;YAoBhB,yBAAyB;IA8BjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;YAO/F,UAAU;YAUV,mBAAmB;CA0BlC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAEpE"}