theorum 0.1.15 → 1.0.0

package/esm/src/providers/openrouter-payload.js

@@ -1,195 +0,0 @@
-/**
- * OpenRouter payload builder.
- *
- * Converts THEORUM provider requests into OpenAI-compatible chat completion
- * payloads for OpenRouter and compatible gateways.
- *
- * @module
- */
-import { getTool } from '../kernel/registry/catalog.js';
-import { getStructured } from '../kernel/registry/schemas.js';
-/**
- * Resolve a THEORUM model id to an OpenRouter model string.
- * Prefer `openRouterId` / `apiId` from the profile model spec on the request.
- */
-function resolveOpenRouterModel(modelId, customMap, wire) {
-    if (customMap?.[modelId]) {
-        return customMap[modelId];
-    }
-    if (wire?.openRouterId) {
-        return wire.openRouterId;
-    }
-    if (wire?.apiId?.includes('/')) {
-        return wire.apiId;
-    }
-    if (wire?.apiId) {
-        return `google/${wire.apiId}`;
-    }
-    if (String(modelId).includes('/')) {
-        return String(modelId);
-    }
-    return String(modelId);
-}
-/** Map THEORUM thinking level to OpenRouter/OpenAI `reasoning.effort`. */
-function mapThinkingEffort(thinking) {
-    return thinking;
-}
-function wireAudioPart(part) {
-    let format = 'mp3';
-    if (part.mimeType.includes('wav')) {
-        format = 'wav';
-    }
-    return {
-        type: 'input_audio',
-        input_audio: {
-            data: part.data,
-            format,
-        },
-    };
-}
-function wireMessageContent(parts) {
-    const isAllText = parts.every((p) => p.type === 'text');
-    if (isAllText) {
-        return parts
-            .map((p) => {
-            if (p.type === 'text') {
-                return p.text;
-            }
-            return '';
-        })
-            .join('\n');
-    }
-    return parts.map((part) => {
-        if (part.type === 'text') {
-            return { type: 'text', text: part.text };
-        }
-        if (part.type === 'image') {
-            return {
-                type: 'image_url',
-                image_url: { url: `data:${part.mimeType};base64,${part.data}` },
-            };
-        }
-        if (part.type === 'audio') {
-            return wireAudioPart(part);
-        }
-        return { type: 'text', text: '' };
-    });
-}
-function wireHistoryMessage(msg) {
-    let content = msg.content ?? '';
-    if (msg.parts && msg.parts.length > 0) {
-        content = wireMessageContent(msg.parts);
-    }
-    const wired = {
-        role: msg.role,
-        content,
-    };
-    if (msg.tool_calls && msg.tool_calls.length > 0) {
-        wired.tool_calls = msg.tool_calls;
-    }
-    if (msg.tool_call_id) {
-        wired.tool_call_id = msg.tool_call_id;
-    }
-    if (msg.name) {
-        wired.name = msg.name;
-    }
-    return wired;
-}
-function wireTools(dynamicTools) {
-    if (!dynamicTools || dynamicTools.length === 0) {
-        return [];
-    }
-    return dynamicTools.map((t) => ({
-        type: 'function',
-        function: {
-            name: t.name,
-            description: t.description ?? '',
-            parameters: t.parameters ?? { type: 'object', properties: {} },
-        },
-    }));
-}
-function buildMessages(req) {
-    const messages = [];
-    if (req.system) {
-        messages.push({ role: 'system', content: req.system });
-    }
-    if (req.history && req.history.length > 0) {
-        for (const h of req.history) {
-            messages.push(wireHistoryMessage(h));
-        }
-    }
-    if (req.input.length > 0) {
-        messages.push({
-            role: 'user',
-            content: wireMessageContent(req.input),
-        });
-    }
-    return messages;
-}
-function resolveResponseFormat(structured) {
-    if (!structured) {
-        return undefined;
-    }
-    const spec = getStructured(structured);
-    if (!spec.jsonSchema) {
-        return undefined;
-    }
-    return {
-        type: 'json_schema',
-        json_schema: {
-            name: String(structured),
-            strict: true,
-            schema: spec.jsonSchema,
-        },
-    };
-}
-/** Convert a provider-neutral request into an OpenRouter chat completion payload. */
-function toOpenRouterPayload(req, config) {
-    const model = resolveOpenRouterModel(req.model, config.modelMap, {
-        apiId: req.apiId,
-        openRouterId: req.openRouterId,
-    });
-    const messages = buildMessages(req);
-    const payload = {
-        model,
-        stream: true,
-        messages,
-        temperature: req.temperature,
-        max_tokens: req.maxOutputTokens,
-    };
-    const effort = mapThinkingEffort(req.thinking);
-    payload.reasoning = { effort };
-    const responseFormat = resolveResponseFormat(req.structured);
-    if (responseFormat) {
-        payload.response_format = responseFormat;
-    }
-    const tools = wireTools(req.dynamicTools);
-    if (tools.length > 0) {
-        payload.tools = tools;
-    }
-    const resolved = resolveOpenRouterPlugins(req.builtins);
-    if (resolved.webSearch) {
-        payload.web_search_options = {};
-    }
-    if (resolved.plugins.length > 0) {
-        payload.plugins = resolved.plugins;
-    }
-    return payload;
-}
-function resolveOpenRouterPlugins(builtins) {
-    let webSearch = false;
-    const plugins = [];
-    for (const id of builtins) {
-        const pluginId = getTool(id)?.openRouterPlugin;
-        if (!pluginId)
-            continue;
-        if (pluginId === 'web') {
-            webSearch = true;
-        }
-        else {
-            plugins.push({ id: pluginId });
-        }
-    }
-    return { plugins, webSearch };
-}
-export { resolveOpenRouterModel, resolveOpenRouterPlugins, toOpenRouterPayload };

package/esm/src/providers/openrouter.d.ts

@@ -1,15 +0,0 @@
-/**
- * OpenRouter provider adapter powered by Vercel AI SDK Core.
- *
- * THEORUM keeps the public `ModelProvider` and `TurnEvent` contract; AI SDK
- * owns the OpenRouter call, stream parsing, provider compatibility, and tool
- * call normalization.
- *
- * @module
- */
-import type { ModelProvider } from '../kernel/types.js';
-import { type OpenRouterConfig, resolveOpenRouterModel, toOpenRouterPayload } from './openrouter-payload.js';
-/** Create a `ModelProvider` backed by OpenRouter through AI SDK Core. */
-declare function createOpenRouterProvider(config?: OpenRouterConfig): ModelProvider;
-export type { OpenRouterConfig };
-export { createOpenRouterProvider, resolveOpenRouterModel, toOpenRouterPayload };

package/esm/src/providers/pcm.d.ts

@@ -1,7 +0,0 @@
-/**
- * PCM → WAV helpers shared by speech transports.
- *
- * @module
- */
-/** Wrap raw PCM bytes in a RIFF/WAVE container. */
-export declare function wrapPcmAsWav(pcm: Uint8Array, sampleRate?: number): Uint8Array;

package/esm/src/providers/provider.d.ts

@@ -1,15 +0,0 @@
-/**
- * Google Interactions provider adapter.
- *
- * This adapter converts THEORUM's provider-neutral request into the Google
- * Interactions wire format and streams normalized `TurnEvent` objects.
- * Speech-role turns use `response_format: audio` + `speech_config` (same
- * transport as chat/image).
- *
- * @module
- */
-import type { ModelProvider } from '../kernel/types.js';
-import { type GeminiTransport } from './keys.js';
-/** Create a `ModelProvider` backed by Google Interactions streaming. */
-declare function createInteractionsProvider(transport: GeminiTransport): ModelProvider;
-export { createInteractionsProvider };

package/esm/src/providers/provider.js

@@ -1,202 +0,0 @@
-/**
- * Google Interactions provider adapter.
- *
- * This adapter converts THEORUM's provider-neutral request into the Google
- * Interactions wire format and streams normalized `TurnEvent` objects.
- * Speech-role turns use `response_format: audio` + `speech_config` (same
- * transport as chat/image).
- *
- * @module
- */
-import { isAbortError, TheorumError, toErrorEvent } from '../guardrails/error.js';
-import { eventsFromComplete, eventsFromDelta, extractTokenEvent, groundingFromEvent, tryStructured, } from '../kernel/engine/delta.js';
-import { asRecord } from '../kernel/engine/record.js';
-import { exposeForTests } from './expose-for-tests.js';
-import { tapFetch } from './google-tap.js';
-import { toInteractionsBody } from './interactions.js';
-import { fetchGemini } from './keys.js';
-import { wrapPcmAsWav } from './pcm.js';
-import { INTERACTIONS_URL, takeSsePayloads } from './sse.js';
-const HTTP_OK = 200;
-function base64ToBytes(data) {
-    const bin = atob(data);
-    const out = new Uint8Array(bin.length);
-    for (let i = 0; i < bin.length; i++)
-        out[i] = bin.charCodeAt(i);
-    return out;
-}
-function bytesToBase64(bytes) {
-    let bin = '';
-    for (let i = 0; i < bytes.length; i++)
-        bin += String.fromCharCode(bytes[i]);
-    return btoa(bin);
-}
-function isRawPcmMime(mime) {
-    const lower = mime.toLowerCase();
-    return lower === 'audio/pcm' || lower === 'audio/l16' || lower === 'audio/raw';
-}
-/** Google TTS returns raw PCM; wrap as WAV for hosts (matches OpenRouter pcm path). */
-function normalizeSpeechMedia(event, speech) {
-    if (!(speech && event.type === 'media' && event.media)) {
-        return event;
-    }
-    const { mimeType, data } = event.media;
-    if (!isRawPcmMime(mimeType)) {
-        return event;
-    }
-    const wav = wrapPcmAsWav(base64ToBytes(data));
-    return {
-        type: 'media',
-        media: { mimeType: 'audio/wav', data: bytesToBase64(wav) },
-    };
-}
-async function* readSseRecords(res) {
-    if (!res.body) {
-        throw new TheorumError('empty Gemini stream');
-    }
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    yield* pumpSse(reader, decoder, '', '');
-}
-async function* pumpSse(reader, decoder, buffer, pendingEvent) {
-    const { done, value } = await reader.read();
-    if (done) {
-        return;
-    }
-    const next = buffer + decoder.decode(value, { stream: true });
-    const taken = takeSsePayloads(next, pendingEvent);
-    for (const payload of taken.payloads) {
-        yield payload;
-    }
-    yield* pumpSse(reader, decoder, taken.rest, taken.pendingEvent);
-}
-function eventType(event) {
-    return String(event.event_type ?? event.type ?? '');
-}
-function isDeltaEvent(kind) {
-    return kind === 'content.delta' || kind === 'step.delta';
-}
-function isCompleteEvent(kind) {
-    return (kind === 'interaction.complete' ||
-        kind === 'interaction.completed' ||
-        kind.startsWith('interaction.'));
-}
-function foldDeltaPayload(event, acc) {
-    const deltaEvents = eventsFromDelta(event.delta);
-    for (const item of deltaEvents) {
-        if (item.type === 'text' && item.text) {
-            acc.text += item.text;
-        }
-    }
-    return deltaEvents;
-}
-function foldPayload(event, acc) {
-    const kind = eventType(event);
-    const events = [];
-    if (isDeltaEvent(kind)) {
-        events.push(...foldDeltaPayload(event, acc));
-    }
-    else if (isCompleteEvent(kind)) {
-        events.push(...eventsFromComplete(event, acc.text.length > 0));
-    }
-    // Also check if usage was included on the event directly
-    if (!events.some((e) => e.type === 'tokens')) {
-        const tokenEvent = extractTokenEvent(event);
-        if (tokenEvent) {
-            events.push(tokenEvent);
-        }
-    }
-    const groundingEvent = groundingFromEvent(event);
-    if (groundingEvent && !events.some((e) => e.type === 'grounding')) {
-        events.push(groundingEvent);
-    }
-    const evidenceEvent = evidenceFromGooglePayload(event);
-    if (evidenceEvent && !events.some((e) => e.type === 'evidence')) {
-        events.push(evidenceEvent);
-    }
-    return events;
-}
-/** Preserve raw Google Interactions tool payloads so hosts can inspect everything returned. */
-function evidenceFromGooglePayload(event) {
-    for (const key of ['delta', 'step']) {
-        const payload = asRecord(event[key]);
-        if (!payload) {
-            continue;
-        }
-        const type = String(payload.type ?? '');
-        if (type === 'google_search_result' ||
-            type === 'google_maps' ||
-            type === 'google_maps_result' ||
-            type.startsWith('google_')) {
-            return {
-                type: 'evidence',
-                evidence: { provider: 'google', raw: payload },
-            };
-        }
-    }
-    return undefined;
-}
-function withTap(req, transport) {
-    return {
-        ...transport,
-        fetch: tapFetch(req.tapGemini, transport.fetch),
-    };
-}
-async function* streamComplete(req, transport) {
-    if (!req.geminiBucket) {
-        yield toErrorEvent('missing Gemini vault bucket for Interactions');
-        return;
-    }
-    const res = await fetchGemini(INTERACTIONS_URL, { method: 'POST', body: JSON.stringify(toInteractionsBody(req)), signal: req.signal }, req.geminiBucket, withTap(req, transport));
-    if (res.status !== HTTP_OK) {
-        const errorBody = await res.text().catch(() => '');
-        yield toErrorEvent(`Gemini HTTP ${String(res.status)}: ${errorBody}`);
-        return;
-    }
-    const acc = { text: '' };
-    const speech = Boolean(req.speech);
-    for await (const payload of readSseRecords(res)) {
-        req.tapGemini?.(payload);
-        const events = foldPayload(payload, acc);
-        for (const event of events) {
-            yield normalizeSpeechMedia(event, speech);
-        }
-    }
-    if (req.structured && acc.text) {
-        const structured = tryStructured(acc.text);
-        if (structured) {
-            yield structured;
-        }
-    }
-}
-async function* streamGuarded(req, transport) {
-    try {
-        yield* streamComplete(req, transport);
-    }
-    catch (err) {
-        if (isAbortError(err)) {
-            throw err;
-        }
-        yield toErrorEvent(err);
-    }
-}
-/** Create a `ModelProvider` backed by Google Interactions streaming. */
-function createInteractionsProvider(transport) {
-    return {
-        complete: (req) => streamGuarded(req, transport),
-    };
-}
-export { createInteractionsProvider };
-exposeForTests('provider', {
-    base64ToBytes,
-    bytesToBase64,
-    isRawPcmMime,
-    normalizeSpeechMedia,
-    eventType,
-    isDeltaEvent,
-    isCompleteEvent,
-    foldDeltaPayload,
-    foldPayload,
-    evidenceFromGooglePayload,
-    withTap,
-});

package/esm/src/providers/speech.d.ts

@@ -1,23 +0,0 @@
-/**
- * OpenAI-compatible `/audio/speech` transport (internal).
- *
- * Hosts use `createProvider(profile, { openRouter })` — this module is selected
- * when the profile is an openAi speech role. Not a separate public door.
- *
- * @module
- */
-import type { ModelProvider, ProviderCompleteRequest, TurnEvent } from '../kernel/types.js';
-/** Credentials for the openAi speech path (same shape as OpenRouter chat config + voice). */
-export interface SpeechProviderConfig {
-    apiKey?: string;
-    /** Fallback TTS voice when the profile does not pin `outputs.speech.voice`. */
-    voice?: string;
-    baseUrl?: string;
-    siteUrl?: string;
-    siteName?: string;
-    fetch?: typeof fetch;
-}
-declare function streamSpeech(req: ProviderCompleteRequest, config?: SpeechProviderConfig): AsyncGenerator<TurnEvent>;
-/** Internal ModelProvider for openAi speech roles. */
-declare function createSpeechProvider(config?: SpeechProviderConfig): ModelProvider;
-export { createSpeechProvider, streamSpeech };

package/esm/src/providers/sse.d.ts

@@ -1,7 +0,0 @@
-declare const INTERACTIONS_URL = "https://generativelanguage.googleapis.com/v1beta/interactions?alt=sse";
-declare function takeSsePayloads(buffer: string, pendingEvent?: string): {
-    rest: string;
-    payloads: Record<string, unknown>[];
-    pendingEvent: string;
-};
-export { INTERACTIONS_URL, takeSsePayloads };

package/esm/src/providers/sse.js

@@ -1,55 +0,0 @@
-import { exposeForTests } from './expose-for-tests.js';
-const INTERACTIONS_URL = 'https://generativelanguage.googleapis.com/v1beta/interactions?alt=sse';
-const DATA_PREFIX = 'data: ';
-const EVENT_PREFIX = 'event: ';
-const DONE = '[DONE]';
-function asObject(parsed) {
-    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-        return parsed;
-    }
-    return undefined;
-}
-function dataRecord(raw, sseEvent) {
-    const data = raw.slice(DATA_PREFIX.length).trim();
-    const row = {};
-    if (sseEvent) {
-        row.sseEvent = sseEvent;
-    }
-    if (!data || data === DONE) {
-        row.eventType = 'sse_done';
-        return row;
-    }
-    try {
-        const parsed = JSON.parse(data);
-        const obj = asObject(parsed);
-        if (obj) {
-            return { ...obj, ...row };
-        }
-        row.eventType = 'sse_unparsed';
-        row.data = parsed;
-        return row;
-    }
-    catch {
-        row.eventType = 'sse_unparsed';
-        row.data = data;
-        return row;
-    }
-}
-function takeSsePayloads(buffer, pendingEvent = '') {
-    const payloads = [];
-    const chunks = buffer.split('\n');
-    const rest = chunks.pop() ?? '';
-    let sseEvent = pendingEvent;
-    for (const line of chunks) {
-        if (line.startsWith(EVENT_PREFIX)) {
-            sseEvent = line.slice(EVENT_PREFIX.length).trim();
-        }
-        else if (line.startsWith(DATA_PREFIX)) {
-            payloads.push(dataRecord(line, sseEvent));
-            sseEvent = '';
-        }
-    }
-    return { rest, payloads, pendingEvent: sseEvent };
-}
-export { INTERACTIONS_URL, takeSsePayloads };
-exposeForTests('sse', { asObject, dataRecord, takeSsePayloads });

package/esm/src/streaming/mod.d.ts

@@ -1,9 +0,0 @@
-/**
- * Structured-output streaming helpers and turn-stop classification.
- *
- * @module
- */
-import "../../_dnt.polyfills.js";
-export type { ProfileResumeSpec, TurnContinueFrom, TurnStop, TurnStopKind, } from '../kernel/stop.js';
-export { AUTO_CONTINUE_DELAY_MS, CONTINUE_INSTRUCTION, DEFAULT_AUTO_CONTINUE, GenerationStopError, isGenerationStopError, isResumeableStop, isUserCancelledStop, shouldAutoContinue, turnStopFromClientStreamEnd, turnStopFromInteractionStatus, turnStopFromOpenRouter, } from '../kernel/stop.js';
-export { readStreamingJsonStringField } from './readStreamingJsonStringField.js';

package/esm/src/streaming/mod.js

@@ -1,8 +0,0 @@
-/**
- * Structured-output streaming helpers and turn-stop classification.
- *
- * @module
- */
-import "../../_dnt.polyfills.js";
-export { AUTO_CONTINUE_DELAY_MS, CONTINUE_INSTRUCTION, DEFAULT_AUTO_CONTINUE, GenerationStopError, isGenerationStopError, isResumeableStop, isUserCancelledStop, shouldAutoContinue, turnStopFromClientStreamEnd, turnStopFromInteractionStatus, turnStopFromOpenRouter, } from '../kernel/stop.js';
-export { readStreamingJsonStringField } from './readStreamingJsonStringField.js';