theorum 0.1.15 → 1.1.3

package/esm/src/providers/local/mod.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Direct entry for local OpenAI-compat providers (Ollama, vLLM, etc.).
+ * Importing this module loads the local adapter graph — prefer `createProvider`
+ * when routing from a profile unless you intentionally bypass the factory.
+ *
+ * @module
+ */
+import "../../../_dnt.polyfills.js";
+export { createLocalProvider, DEFAULT_LOCAL_BASE_URL } from './local.js';

package/esm/src/providers/local/mod.js

@@ -0,0 +1,9 @@
+/**
+ * Direct entry for local OpenAI-compat providers (Ollama, vLLM, etc.).
+ * Importing this module loads the local adapter graph — prefer `createProvider`
+ * when routing from a profile unless you intentionally bypass the factory.
+ *
+ * @module
+ */
+import "../../../_dnt.polyfills.js";
+export { createLocalProvider, DEFAULT_LOCAL_BASE_URL } from './local.js';

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

@@ -4,11 +4,14 @@
  * Host apps should use `createProvider(profile, options)` — the single door.
  * Credentials are always supplied by the host application.
  *
+ * For direct local adapter access (bypassing the factory), import
+ * `@theorum/core/providers/local`.
+ *
  * @module
  */
 import "../../_dnt.polyfills.js";
+export type { KeyVault } from '../kernel/types.js';
 export type { CreateProviderOptions } from './create-provider.js';
 export { createProvider } from './create-provider.js';
-export type { GeminiTransport, GeminiVault } from './keys.js';
-export type { LocalProviderConfig } from './local.js';
-export { createLocalProvider, DEFAULT_LOCAL_BASE_URL } from './local.js';
+export type { GeminiTransport } from './google/keys.js';
+export type { LocalProviderConfig, OpenAiGatewayConfig } from './types.js';

package/esm/src/providers/mod.js

@@ -4,8 +4,10 @@
  * Host apps should use `createProvider(profile, options)` — the single door.
  * Credentials are always supplied by the host application.
  *
+ * For direct local adapter access (bypassing the factory), import
+ * `@theorum/core/providers/local`.
+ *
  * @module
  */
 import "../../_dnt.polyfills.js";
 export { createProvider } from './create-provider.js';
-export { createLocalProvider, DEFAULT_LOCAL_BASE_URL } from './local.js';

package/esm/src/providers/openrouter/cache-control.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared OpenRouter `cache_control` directive from a profile CacheSpec.
+ *
+ * Used by AI SDK `providerOptionsFor` and REST `toOpenAiChatPayload` so both
+ * paths share one wire shape.
+ *
+ * @module
+ */
+import type { CacheTtl } from '../../kernel/schema.js';
+import type { CacheSpec } from '../../kernel/types.js';
+/** Anthropic / OpenRouter ephemeral cache_control object. */
+export interface CacheControlDirective {
+    type: 'ephemeral';
+    ttl?: CacheTtl;
+}
+/** Map a profile CacheSpec to the upstream cache_control body fragment. */
+export declare function cacheControlFromSpec(spec: CacheSpec): CacheControlDirective;
+/**
+ * Plain JSON object for AI SDK `providerOptions` (needs string index signature).
+ * Same values as `cacheControlFromSpec`.
+ */
+export declare function cacheControlJson(spec: CacheSpec): {
+    [key: string]: string;
+};

package/esm/src/providers/openrouter/cache-control.js

@@ -0,0 +1,23 @@
+/**
+ * Shared OpenRouter `cache_control` directive from a profile CacheSpec.
+ *
+ * Used by AI SDK `providerOptionsFor` and REST `toOpenAiChatPayload` so both
+ * paths share one wire shape.
+ *
+ * @module
+ */
+/** Map a profile CacheSpec to the upstream cache_control body fragment. */
+export function cacheControlFromSpec(spec) {
+    if (spec.ttl) {
+        return { type: 'ephemeral', ttl: spec.ttl };
+    }
+    return { type: 'ephemeral' };
+}
+/**
+ * Plain JSON object for AI SDK `providerOptions` (needs string index signature).
+ * Same values as `cacheControlFromSpec`.
+ */
+export function cacheControlJson(spec) {
+    const directive = cacheControlFromSpec(spec);
+    return directive.ttl ? { type: directive.type, ttl: directive.ttl } : { type: directive.type };
+}

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

@@ -0,0 +1,107 @@
+/**
+ * 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. Message assembly delegates to `openai/sdk-messages.ts`.
+ *
+ * @module
+ */
+import { type ModelMessage, type TextStreamPart, type ToolSet } from 'ai';
+import type { ModelProvider, ProviderCompleteRequest, TurnEvent, TurnTokens, WireFunctionTool } from '../../kernel/types.js';
+import type { OpenAiGatewayConfig } from '../types.js';
+export interface StreamAccumulator {
+    text: string;
+    evidenceSeen: boolean;
+    emittedTokens: boolean;
+    errored: boolean;
+    finishReason?: string | null;
+    nativeFinishReason?: string | null;
+}
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type ProviderOptions = Record<string, {
+    [key: string]: JsonValue;
+}>;
+export declare function trimApiKey(explicitKey?: string): string | undefined;
+export declare function createAccumulator(): StreamAccumulator;
+export declare function sourceEvent(part: {
+    sourceType?: string;
+    title?: string | null;
+    url?: string;
+}): TurnEvent;
+export declare function schemaForTool(decl: WireFunctionTool): Record<string, unknown>;
+export declare function buildTools(wireTools?: WireFunctionTool[]): ToolSet | undefined;
+export declare function tokensFromUsage(usage: {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    totalTokens?: number | null;
+    inputTokenDetails?: {
+        cacheReadTokens?: number | null;
+        cacheWriteTokens?: number | null;
+    } | null;
+    cachedInputTokens?: number | null;
+}): TurnTokens | undefined;
+export declare function rawRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function stringArray(value: unknown): string[] | undefined;
+export declare function metadataRecord(raw: Record<string, unknown>, key: string): Record<string, unknown> | undefined;
+export declare function citationCandidates(raw: Record<string, unknown>): unknown[];
+export declare function nestedCitations(raw: Record<string, unknown>): string[] | undefined;
+export declare function metadataAnnotations(raw: Record<string, unknown>): unknown[] | undefined;
+export declare function evidenceFromMetadata(metadata: unknown, acc: StreamAccumulator): TurnEvent | undefined;
+export declare function toolArguments(input: unknown): Record<string, unknown> | undefined;
+export declare function toolResultData(output: unknown): Record<string, unknown> | undefined;
+export declare function rawThoughtEvent(raw: Record<string, unknown>): TurnEvent | undefined;
+export declare function rawChoiceMessageEvidence(raw: Record<string, unknown>, acc: StreamAccumulator): TurnEvent | undefined;
+export declare function rawEvents(raw: unknown, acc: StreamAccumulator): TurnEvent[];
+export declare function toolCallEvent(part: {
+    toolName: string;
+    toolCallId: string;
+    input?: unknown;
+}): TurnEvent;
+export declare function toolResultEvent(part: {
+    toolName: string;
+    toolCallId: string;
+    input?: unknown;
+    output?: unknown;
+}): TurnEvent;
+export declare function tokenEvent(part: {
+    totalUsage: {
+        inputTokens?: number | null;
+        outputTokens?: number | null;
+        totalTokens?: number | null;
+        inputTokenDetails?: {
+            cacheReadTokens?: number | null;
+            cacheWriteTokens?: number | null;
+        } | null;
+        cachedInputTokens?: number | null;
+    };
+}): TurnEvent | undefined;
+export declare function providerMetadataEvent(part: TextStreamPart<ToolSet>, acc: StreamAccumulator): TurnEvent | undefined;
+export declare function eventFromPart(part: TextStreamPart<ToolSet>, acc: StreamAccumulator): TurnEvent[];
+export declare function primaryEventFromPart(part: TextStreamPart<ToolSet>, acc: StreamAccumulator): TurnEvent | undefined;
+export declare function finishEvent(part: {
+    finishReason?: string | null;
+    totalUsage?: {
+        inputTokens?: number | null;
+        outputTokens?: number | null;
+        totalTokens?: number | null;
+        inputTokenDetails?: {
+            cacheReadTokens?: number | null;
+            cacheWriteTokens?: number | null;
+        } | null;
+        cachedInputTokens?: number | null;
+    };
+}, acc: StreamAccumulator): TurnEvent | undefined;
+export declare function finalEvents(req: ProviderCompleteRequest, acc: StreamAccumulator): Generator<TurnEvent>;
+/** System via instructions XOR a cache-marked system message — never both. */
+export declare function systemDelivery(req: ProviderCompleteRequest): {
+    instructions?: string;
+    systemMessage?: ModelMessage;
+};
+export declare function missingOpenRouterKey(): TurnEvent;
+export declare function providerOptionsFor(req: ProviderCompleteRequest): ProviderOptions | undefined;
+/** Create a `ModelProvider` backed by OpenRouter through AI SDK Core. */
+export declare function createOpenRouterProvider(config?: OpenAiGatewayConfig): ModelProvider;
+export type { OpenAiGatewayConfig };