theorum 0.1.4 → 0.1.5

package/src/providers/openrouter-payload.ts

@@ -1,232 +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.ts';
-import { getStructured } from '../kernel/registry/schemas.ts';
-import type {
-  DynamicToolDeclaration,
-  InteractionMediaPart,
-  InteractionPart,
-  ModelId,
-  ProviderCompleteRequest,
-  StructuredSchemaId,
-  ThinkingLevel,
-  TurnHistoryMessage,
-} from '../kernel/types.ts';
-
-/** Configuration supplied by the host app when creating OpenRouter providers. */
-interface OpenRouterConfig {
-  apiKey?: string;
-  baseUrl?: string;
-  siteUrl?: string;
-  siteName?: string;
-  fetch?: typeof fetch;
-  modelMap?: Record<string, string>;
-}
-
-/** Host-owned wire ids used when resolving an OpenRouter model string. */
-interface OpenRouterWireIds {
-  apiId?: string;
-  openRouterId?: string;
-}
-
-/**
- * Resolve a THEORUM model id to an OpenRouter model string.
- * Prefer `openRouterId` / `apiId` from the profile model spec on the request.
- */
-function resolveOpenRouterModel(
-  modelId: ModelId | string,
-  customMap?: Record<string, string>,
-  wire?: OpenRouterWireIds,
-): string {
-  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: ThinkingLevel): ThinkingLevel {
-  return thinking;
-}
-
-function wireAudioPart(part: InteractionMediaPart): Record<string, unknown> {
-  let format = 'mp3';
-  if (part.mimeType.includes('wav')) {
-    format = 'wav';
-  }
-  return {
-    type: 'input_audio',
-    input_audio: {
-      data: part.data,
-      format,
-    },
-  };
-}
-
-function wireMessageContent(parts: InteractionPart[]): unknown {
-  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: TurnHistoryMessage): Record<string, unknown> {
-  let content: unknown = msg.content ?? '';
-  if (msg.parts && msg.parts.length > 0) {
-    content = wireMessageContent(msg.parts);
-  }
-  const wired: Record<string, unknown> = {
-    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?: DynamicToolDeclaration[]): Record<string, unknown>[] {
-  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: ProviderCompleteRequest): Record<string, unknown>[] {
-  const messages: Record<string, unknown>[] = [];
-  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: StructuredSchemaId | null,
-): Record<string, unknown> | undefined {
-  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: ProviderCompleteRequest,
-  config: OpenRouterConfig,
-): Record<string, unknown> {
-  const model = resolveOpenRouterModel(req.model, config.modelMap, {
-    apiId: req.apiId,
-    openRouterId: req.openRouterId,
-  });
-  const messages = buildMessages(req);
-
-  const payload: Record<string, unknown> = {
-    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 plugins = req.builtins
-    .map((id) => getTool(id)?.openRouterPlugin)
-    .filter((id): id is string => Boolean(id))
-    .map((id) => ({ id }));
-  if (plugins.length > 0) {
-    payload.plugins = plugins;
-  }
-
-  return payload;
-}
-
-export type { OpenRouterConfig, OpenRouterWireIds };
-export { resolveOpenRouterModel, toOpenRouterPayload };