limen-ai 1.0.0

package/dist/substrate/transport/adapters/openai_compat.js

@@ -0,0 +1,326 @@
+/**
+ * Shared pure functions for OpenAI-compatible request/response translation.
+ * S ref: §25.4 (LLM Gateway), I-01 (no SDK deps), I-04 (provider independence)
+ *
+ * Phase: 5B (Sprint 5B — OpenAI + Google Adapters)
+ * Used by: openai_adapter.ts (directly), groq_adapter.ts, mistral_adapter.ts (Sprint 5C)
+ *
+ * These functions handle the OpenAI Chat Completions wire format shared by
+ * multiple providers. They are PURE — no state, no side effects, no auth.
+ *
+ * CR-5 ENFORCEMENT (HARD REQUIREMENT — I-49/I-59):
+ *   When usage.completion_tokens_details.reasoning_tokens is present and > 0:
+ *     outputTokens = completion_tokens - reasoning_tokens
+ *     providerOutputTokens = completion_tokens (raw)
+ *     deliberation.deliberationTokens = reasoning_tokens
+ *     deliberation.accountingMode = 'provider_authoritative'
+ *     deliberation.providerReportedThinkingTokens = reasoning_tokens
+ *
+ * C-SEC-P5-22: Provider output is untrusted — validate structure.
+ * C-SEC-P5-23: Tool call structural validation.
+ */
+// ─── Constants ───
+/** C-SEC-P5-23: Valid tool name pattern (same as Anthropic adapter) */
+const TOOL_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+// ─── Tool Call Validation (C-SEC-P5-23) ───
+/**
+ * Validate a tool call's structural integrity for OpenAI-format responses.
+ * C-SEC-P5-23: Non-empty id, name matches pattern, arguments is valid JSON object.
+ * OpenAI uses `function.name` and `function.arguments` (JSON string).
+ */
+function validateToolCall(tc) {
+    const id = tc.id;
+    const fn = tc.function;
+    // Non-empty id
+    if (typeof id !== 'string' || id.length === 0)
+        return null;
+    // Function object must exist
+    if (typeof fn !== 'object' || fn === null)
+        return null;
+    // Name matches valid pattern
+    const name = fn.name;
+    if (typeof name !== 'string' || !TOOL_NAME_PATTERN.test(name))
+        return null;
+    // Arguments must be a JSON string that parses to an object
+    const args = fn.arguments;
+    if (typeof args !== 'string')
+        return null;
+    let parsedArgs;
+    try {
+        parsedArgs = JSON.parse(args);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsedArgs !== 'object' || parsedArgs === null || Array.isArray(parsedArgs)) {
+        return null;
+    }
+    return {
+        id,
+        name,
+        input: parsedArgs,
+    };
+}
+// ─── Request Translation ───
+/**
+ * Build an OpenAI Chat Completions-compatible HTTP request from an LlmRequest.
+ * Pure function — auth headers and URL are provided by the calling adapter.
+ *
+ * @param request - The Limen LlmRequest
+ * @param streaming - Whether to enable streaming
+ * @param url - The full URL for the request (constructed by adapter)
+ * @param headers - HTTP headers including auth (constructed by adapter)
+ */
+export function buildOpenAICompatRequest(request, streaming, url, headers) {
+    // Build messages array
+    const messages = [];
+    // System prompt → system message
+    if (request.systemPrompt) {
+        messages.push({ role: 'system', content: request.systemPrompt });
+    }
+    for (const msg of request.messages) {
+        if (msg.role === 'system') {
+            // System messages go as system role
+            messages.push({
+                role: 'system',
+                content: typeof msg.content === 'string'
+                    ? msg.content
+                    : msg.content
+                        .filter((b) => b.type === 'text')
+                        .map(b => b.text)
+                        .join('\n'),
+            });
+            continue;
+        }
+        // Map Limen content blocks to OpenAI format
+        if (typeof msg.content === 'string') {
+            messages.push({ role: msg.role, content: msg.content });
+        }
+        else {
+            const blocks = msg.content;
+            // Check if all blocks are text — collapse to string
+            const allText = blocks.every(b => b.type === 'text');
+            if (allText) {
+                messages.push({
+                    role: msg.role,
+                    content: blocks
+                        .filter((b) => b.type === 'text')
+                        .map(b => b.text)
+                        .join('\n'),
+                });
+            }
+            else {
+                // Multi-modal content blocks
+                const parts = [];
+                for (const block of blocks) {
+                    switch (block.type) {
+                        case 'text':
+                            parts.push({ type: 'text', text: block.text });
+                            break;
+                        case 'image':
+                            parts.push({
+                                type: 'image_url',
+                                image_url: { url: `data:${block.mediaType};base64,${block.data}` },
+                            });
+                            break;
+                        case 'tool_use':
+                            // Tool use blocks map to assistant messages with tool_calls
+                            // These are handled differently — pass through
+                            parts.push({ type: 'text', text: '' });
+                            break;
+                        case 'tool_result':
+                            // Tool results map to tool role messages
+                            messages.push({
+                                role: 'tool',
+                                tool_call_id: block.toolUseId,
+                                content: block.content,
+                            });
+                            break;
+                    }
+                }
+                if (parts.length > 0) {
+                    messages.push({ role: msg.role, content: parts });
+                }
+            }
+        }
+    }
+    // Build request body
+    const body = {
+        model: request.model,
+        messages,
+        max_tokens: request.maxTokens,
+    };
+    // Temperature
+    if (request.temperature !== undefined) {
+        body.temperature = request.temperature;
+    }
+    // Tools
+    if (request.tools && request.tools.length > 0) {
+        body.tools = request.tools.map((tool) => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.inputSchema,
+            },
+        }));
+    }
+    // Streaming
+    if (streaming) {
+        body.stream = true;
+        // Request usage stats in streaming mode
+        body.stream_options = { include_usage: true };
+    }
+    return {
+        url,
+        method: 'POST',
+        headers,
+        body,
+        stream: streaming,
+    };
+}
+// ─── Response Parsing ───
+/**
+ * Parse an OpenAI Chat Completions-compatible response into a TransportResult.
+ * Pure function — providerId is supplied by the calling adapter.
+ *
+ * CR-5 ENFORCEMENT (HARD REQUIREMENT):
+ *   When completion_tokens_details.reasoning_tokens is present and > 0:
+ *     outputTokens = completion_tokens - reasoning_tokens
+ *     providerOutputTokens = completion_tokens (raw, before subtraction)
+ *     deliberation.deliberationTokens = reasoning_tokens
+ *
+ * C-SEC-P5-22: Provider output is untrusted — validate structure.
+ * C-SEC-P5-23: Tool call structural validation.
+ *
+ * @param httpResponse - Raw HTTP response
+ * @param providerId - Provider identifier for the response
+ */
+export function parseOpenAICompatResponse(httpResponse, providerId) {
+    // C-SEC-P5-07: JSON parse safety
+    let parsed;
+    try {
+        parsed = JSON.parse(httpResponse.body);
+    }
+    catch {
+        throw new Error(`JSON parse error: invalid response body from ${providerId}`);
+    }
+    // C-SEC-P5-22: Validate structure
+    const choices = parsed.choices;
+    if (!Array.isArray(choices) || choices.length === 0) {
+        throw new Error(`${providerId} response missing choices array`);
+    }
+    const firstChoice = choices[0];
+    const message = firstChoice.message;
+    if (!message) {
+        throw new Error(`${providerId} response missing message in first choice`);
+    }
+    // Extract content
+    const rawContent = message.content;
+    const contentText = typeof rawContent === 'string' ? rawContent : '';
+    // Extract tool calls (C-SEC-P5-23)
+    const toolCalls = [];
+    const responseBlocks = [];
+    if (contentText) {
+        responseBlocks.push({ type: 'text', text: contentText });
+    }
+    const rawToolCalls = message.tool_calls;
+    if (Array.isArray(rawToolCalls)) {
+        for (const tc of rawToolCalls) {
+            if (typeof tc !== 'object' || tc === null)
+                continue;
+            const validated = validateToolCall(tc);
+            if (validated) {
+                toolCalls.push(validated);
+                responseBlocks.push({
+                    type: 'tool_use',
+                    id: validated.id,
+                    name: validated.name,
+                    input: validated.input,
+                });
+            }
+            // Invalid tool calls silently dropped — provider output is untrusted
+        }
+    }
+    // Extract usage
+    const usage = parsed.usage;
+    const promptTokens = typeof usage?.prompt_tokens === 'number' ? usage.prompt_tokens : 0;
+    const completionTokens = typeof usage?.completion_tokens === 'number' ? usage.completion_tokens : 0;
+    // ──── CR-5 ENFORCEMENT (HARD REQUIREMENT — I-49/I-59) ────
+    // When completion_tokens_details.reasoning_tokens is present and > 0:
+    //   outputTokens = completion_tokens - reasoning_tokens
+    //   providerOutputTokens = completion_tokens (raw, BEFORE subtraction)
+    //   deliberation.deliberationTokens = reasoning_tokens
+    //   deliberation.accountingMode = 'provider_authoritative'
+    const completionDetails = usage?.completion_tokens_details;
+    const reasoningTokens = typeof completionDetails?.reasoning_tokens === 'number'
+        ? completionDetails.reasoning_tokens
+        : 0;
+    let effectiveOutputTokens;
+    let deliberation;
+    if (reasoningTokens > 0) {
+        // CR-5: Subtract reasoning tokens to avoid double-counting
+        // Floor at 0 to guard against malformed provider responses (C-SEC-P5-22)
+        effectiveOutputTokens = Math.max(0, completionTokens - reasoningTokens);
+        deliberation = {
+            deliberationTokens: reasoningTokens,
+            accountingMode: 'provider_authoritative',
+            providerReportedThinkingTokens: reasoningTokens,
+        };
+    }
+    else {
+        // No reasoning tokens — use raw completion_tokens
+        effectiveOutputTokens = completionTokens;
+        deliberation = {
+            deliberationTokens: 0,
+            accountingMode: 'estimated',
+            providerReportedThinkingTokens: null,
+        };
+    }
+    // Extract finish reason
+    const rawFinishReason = firstChoice.finish_reason;
+    const finishReason = mapOpenAIFinishReason(rawFinishReason);
+    const response = {
+        content: responseBlocks.length === 1 && responseBlocks[0]?.type === 'text'
+            ? responseBlocks[0].text
+            : responseBlocks.length > 0 ? responseBlocks : contentText,
+        toolCalls,
+        finishReason,
+        usage: {
+            inputTokens: promptTokens,
+            outputTokens: effectiveOutputTokens,
+            providerInputTokens: promptTokens,
+            providerOutputTokens: completionTokens, // CR-5: raw value BEFORE subtraction
+        },
+        model: String(parsed.model ?? ''),
+        providerId,
+        latencyMs: 0, // Filled by transport engine
+    };
+    return {
+        response,
+        deliberation,
+        retryCount: 0, // Filled by transport engine
+        totalMs: 0, // Filled by transport engine
+    };
+}
+// ─── Helpers ───
+/**
+ * Map OpenAI finish_reason to Limen finish reason.
+ */
+function mapOpenAIFinishReason(reason) {
+    switch (reason) {
+        case 'stop':
+            return 'stop';
+        case 'length':
+            return 'length';
+        case 'tool_calls':
+            return 'tool_use';
+        case 'content_filter':
+            return 'content_filter';
+        default:
+            return 'stop';
+    }
+}
+// ─── Exported for testing ───
+export { validateToolCall, mapOpenAIFinishReason, TOOL_NAME_PATTERN };
+//# sourceMappingURL=openai_compat.js.map

package/dist/substrate/transport/adapters/openai_compat.js.map

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

package/dist/substrate/transport/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Transport layer re-exports.
+ * S ref: §25.4 (LLM Gateway), I-04 (provider independence)
+ *
+ * Phase: 5A (Sprint 5A — Shared Transport Infrastructure)
+ */
+export type { TransportErrorCode, SSEEvent, TransportHttpRequest, TransportHttpResponse, DeliberationMetrics, TransportResult, TransportStreamResult, ProviderAdapter, TransportExecuteOptions, TransportEngine, UpdateProviderHealthFn, IsCircuitOpenFn, TransportEngineOptions, } from './transport_types.js';
+export { parseSSEStream, parseNDJSONStream } from './stream_parser.js';
+export { createTransportEngine } from './transport_engine.js';
+export { createAnthropicAdapter, createAnthropicAdapterFromEnv } from './adapters/anthropic_adapter.js';
+export { buildOpenAICompatRequest, parseOpenAICompatResponse } from './adapters/openai_compat.js';
+export { createOpenAIAdapter, createOpenAIAdapterFromEnv } from './adapters/openai_adapter.js';
+export { createGeminiAdapter, createGeminiAdapterFromEnv, scrubUrl } from './adapters/gemini_adapter.js';
+export { createGroqAdapter, createGroqAdapterFromEnv } from './adapters/groq_adapter.js';
+export { createMistralAdapter, createMistralAdapterFromEnv } from './adapters/mistral_adapter.js';
+export { createOllamaAdapter } from './adapters/ollama_adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/substrate/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/substrate/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,kBAAkB,EAClB,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAGxG,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGlG,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG/F,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAGzG,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAGlG,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/substrate/transport/index.js

@@ -0,0 +1,25 @@
+/**
+ * Transport layer re-exports.
+ * S ref: §25.4 (LLM Gateway), I-04 (provider independence)
+ *
+ * Phase: 5A (Sprint 5A — Shared Transport Infrastructure)
+ */
+// Stream parsers
+export { parseSSEStream, parseNDJSONStream } from './stream_parser.js';
+// Transport engine
+export { createTransportEngine } from './transport_engine.js';
+// Anthropic adapter
+export { createAnthropicAdapter, createAnthropicAdapterFromEnv } from './adapters/anthropic_adapter.js';
+// OpenAI compat (shared functions for OpenAI-compatible providers)
+export { buildOpenAICompatRequest, parseOpenAICompatResponse } from './adapters/openai_compat.js';
+// OpenAI adapter
+export { createOpenAIAdapter, createOpenAIAdapterFromEnv } from './adapters/openai_adapter.js';
+// Gemini adapter
+export { createGeminiAdapter, createGeminiAdapterFromEnv, scrubUrl } from './adapters/gemini_adapter.js';
+// Groq adapter (Sprint 5C)
+export { createGroqAdapter, createGroqAdapterFromEnv } from './adapters/groq_adapter.js';
+// Mistral adapter (Sprint 5C)
+export { createMistralAdapter, createMistralAdapterFromEnv } from './adapters/mistral_adapter.js';
+// Ollama adapter (Sprint 5C)
+export { createOllamaAdapter } from './adapters/ollama_adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/substrate/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/substrate/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAExG,mEAAmE;AACnE,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAElG,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/F,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEzG,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,8BAA8B;AAC9B,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAElG,6BAA6B;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/substrate/transport/stream_parser.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Stream parsers for SSE and NDJSON protocols.
+ * S ref: §27 (Streaming Protocol), §25.4 (LLM Gateway)
+ *
+ * Phase: 5A (Sprint 5A — Shared Transport Infrastructure)
+ * Implements:
+ *   parseSSEStream() — Server-Sent Events parser
+ *   parseNDJSONStream() — Newline-Delimited JSON parser
+ *
+ * Security constraints enforced:
+ *   C-SEC-P5-10: 1MB max line length
+ *   C-SEC-P5-11: 100K max events
+ *   C-SEC-P5-12: 30s stall detection
+ *   C-SEC-P5-13: Resource cleanup on abort
+ *
+ * I-01: No external dependencies. Uses Web Streams API (Node.js >= 22).
+ */
+import type { SSEEvent, TransportErrorCode } from './transport_types.js';
+import type { TimeProvider } from '../../kernel/interfaces/time.js';
+/** C-SEC-P5-10: Maximum line length (1MB) */
+declare const MAX_LINE_BYTES = 1048576;
+/** C-SEC-P5-11: Maximum number of events */
+declare const MAX_EVENT_COUNT = 100000;
+/** C-SEC-P5-12: Stall detection timeout (30 seconds) */
+declare const STALL_TIMEOUT_MS = 30000;
+declare class TransportStreamError extends Error {
+    readonly code: TransportErrorCode;
+    constructor(code: TransportErrorCode, message: string);
+}
+/**
+ * Parse a Server-Sent Events stream.
+ * S ref: §27 (streaming protocol)
+ *
+ * Follows the SSE specification:
+ * - Lines starting with ':' are comments (ignored)
+ * - Empty lines dispatch the current event
+ * - 'data:' field accumulates (multi-line data joined with \n)
+ * - 'event:', 'id:', 'retry:' fields parsed
+ * - [DONE] sentinel in data terminates the stream
+ *
+ * Security:
+ * - C-SEC-P5-10: Lines > 1MB throw TRANSPORT_SSE_LINE_TOO_LONG
+ * - C-SEC-P5-11: > 100K events throw TRANSPORT_SSE_MAX_EVENTS
+ * - C-SEC-P5-12: 30s with no data throws TRANSPORT_STALL_DETECTED
+ * - C-SEC-P5-13: Abort signal cancels cleanly with reader release
+ *
+ * @param body - ReadableStream from fetch response
+ * @param signal - Optional AbortSignal for cancellation
+ * @param time - Optional TimeProvider for clock injection (Hard Stop #7)
+ */
+export declare function parseSSEStream(body: ReadableStream<Uint8Array>, signal?: AbortSignal, time?: TimeProvider): AsyncIterable<SSEEvent>;
+/**
+ * Parse a Newline-Delimited JSON stream.
+ * S ref: §27 (streaming protocol)
+ *
+ * Each line is a complete JSON object. Empty lines are skipped.
+ *
+ * Security:
+ * - C-SEC-P5-10: Lines > 1MB throw TRANSPORT_NDJSON_LINE_TOO_LONG
+ * - C-SEC-P5-12: 30s with no data throws TRANSPORT_STALL_DETECTED
+ * - C-SEC-P5-13: Abort signal cancels cleanly with reader release
+ *
+ * @param body - ReadableStream from fetch response
+ * @param signal - Optional AbortSignal for cancellation
+ * @param time - Optional TimeProvider for clock injection (Hard Stop #7)
+ */
+export declare function parseNDJSONStream(body: ReadableStream<Uint8Array>, signal?: AbortSignal, time?: TimeProvider): AsyncIterable<Record<string, unknown>>;
+export { TransportStreamError, MAX_LINE_BYTES, MAX_EVENT_COUNT, STALL_TIMEOUT_MS };
+//# sourceMappingURL=stream_parser.d.ts.map

package/dist/substrate/transport/stream_parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream_parser.d.ts","sourceRoot":"","sources":["../../../src/substrate/transport/stream_parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIpE,6CAA6C;AAC7C,QAAA,MAAM,cAAc,UAAY,CAAC;AAEjC,4CAA4C;AAC5C,QAAA,MAAM,eAAe,SAAU,CAAC;AAEhC,wDAAwD;AACxD,QAAA,MAAM,gBAAgB,QAAS,CAAC;AAIhC,cAAM,oBAAqB,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;gBACtB,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM;CAKtD;AAQD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAuB,cAAc,CACnC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,YAAY,GAClB,aAAa,CAAC,QAAQ,CAAC,CAsKzB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAuB,iBAAiB,CACtC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,YAAY,GAClB,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyFxC;AAGD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC"}