@llumiverse/core 1.2.0 → 1.4.0-dev.20260629.090753Z

package/lib/CompletionStream.d.ts

@@ -0,0 +1,48 @@
+import { type CompletionStream, type DriverOptions, type ExecutionOptions, type ExecutionResponse, type ToolUse } from '@llumiverse/common';
+import type { AbstractDriver } from './Driver.js';
+type StreamingToolUse = ToolUse<unknown> & {
+    _actual_id?: string;
+};
+/**
+ * Merge a single streamed `tool_use` fragment into the accumulator map keyed by tool id.
+ *
+ * Providers stream a tool call across several chunks. Different fields arrive in
+ * different chunks and must be reassembled:
+ * - `tool_input` arrives as string pieces (concatenated) or partial objects (merged).
+ * - `tool_name` and the provider's real id (`_actual_id`) may only appear in a later chunk.
+ * - `thought_signature` (Gemini 2.5+/3.x thinking models) is an opaque base64 byte string
+ *   that must be passed back verbatim with the assistant turn on the next request.
+ *
+ * Before this helper existed, the inline accumulator merged `tool_input`/`tool_name`/`_actual_id`
+ * but silently dropped `thought_signature` for any chunk after the first for a given tool id.
+ * When a provider delivers the signature in pieces (large high-effort signatures are split
+ * across chunks) or only on a later chunk, the accumulated signature was left truncated or
+ * absent — producing an invalid base64 byte value that the provider rejects with a
+ * "Base64 decoding failed" (TYPE_BYTES) error when the assistant turn is threaded back.
+ *
+ * The signature is therefore reassembled by concatenating fragments in arrival order, exactly
+ * like `tool_input` string pieces. When the whole signature arrives in a single chunk there is
+ * only one fragment, so concatenation is a no-op and the value round-trips byte-identically.
+ *
+ * Exported for unit testing the round-trip in isolation (no network / no full driver).
+ */
+export declare function accumulateToolUseChunk(accumulatedToolUse: Map<string, StreamingToolUse>, tool: StreamingToolUse): void;
+export declare class DefaultCompletionStream<PromptT = unknown> implements CompletionStream<PromptT> {
+    driver: AbstractDriver<DriverOptions, PromptT>;
+    prompt: PromptT;
+    options: ExecutionOptions;
+    chunks: number;
+    completion: ExecutionResponse<PromptT> | undefined;
+    constructor(driver: AbstractDriver<DriverOptions, PromptT>, prompt: PromptT, options: ExecutionOptions);
+    [Symbol.asyncIterator](): AsyncGenerator<string, void, unknown>;
+}
+export declare class FallbackCompletionStream<PromptT = unknown> implements CompletionStream<PromptT> {
+    driver: AbstractDriver<DriverOptions, PromptT>;
+    prompt: PromptT;
+    options: ExecutionOptions;
+    completion: ExecutionResponse<PromptT> | undefined;
+    constructor(driver: AbstractDriver<DriverOptions, PromptT>, prompt: PromptT, options: ExecutionOptions);
+    [Symbol.asyncIterator](): AsyncGenerator<string, void, unknown>;
+}
+export {};
+//# sourceMappingURL=CompletionStream.d.ts.map

package/lib/CompletionStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompletionStream.d.ts","sourceRoot":"","sources":["../src/CompletionStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGtB,KAAK,OAAO,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,KAAK,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAClC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACjD,IAAI,EAAE,gBAAgB,GACvB,IAAI,CAqCN;AAED,qBAAa,uBAAuB,CAAC,OAAO,GAAG,OAAO,CAAE,YAAW,gBAAgB,CAAC,OAAO,CAAC;IAK7E,MAAM,EAAE,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC;IAC9C,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,gBAAgB;IANpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;gBAGxC,MAAM,EAAE,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,EAC9C,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,gBAAgB;IAK7B,CAAC,MAAM,CAAC,aAAa,CAAC;CA2PhC;AAED,qBAAa,wBAAwB,CAAC,OAAO,GAAG,OAAO,CAAE,YAAW,gBAAgB,CAAC,OAAO,CAAC;IAI9E,MAAM,EAAE,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC;IAC9C,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,gBAAgB;IALpC,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;gBAGxC,MAAM,EAAE,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,EAC9C,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,gBAAgB;IAG7B,CAAC,MAAM,CAAC,aAAa,CAAC;CA0ChC"}

package/lib/{esm/CompletionStream.js → CompletionStream.js}

@@ -1,4 +1,67 @@
-import { LlumiverseError } from "@llumiverse/common";
+import { LlumiverseError, } from '@llumiverse/common';
+/**
+ * Merge a single streamed `tool_use` fragment into the accumulator map keyed by tool id.
+ *
+ * Providers stream a tool call across several chunks. Different fields arrive in
+ * different chunks and must be reassembled:
+ * - `tool_input` arrives as string pieces (concatenated) or partial objects (merged).
+ * - `tool_name` and the provider's real id (`_actual_id`) may only appear in a later chunk.
+ * - `thought_signature` (Gemini 2.5+/3.x thinking models) is an opaque base64 byte string
+ *   that must be passed back verbatim with the assistant turn on the next request.
+ *
+ * Before this helper existed, the inline accumulator merged `tool_input`/`tool_name`/`_actual_id`
+ * but silently dropped `thought_signature` for any chunk after the first for a given tool id.
+ * When a provider delivers the signature in pieces (large high-effort signatures are split
+ * across chunks) or only on a later chunk, the accumulated signature was left truncated or
+ * absent — producing an invalid base64 byte value that the provider rejects with a
+ * "Base64 decoding failed" (TYPE_BYTES) error when the assistant turn is threaded back.
+ *
+ * The signature is therefore reassembled by concatenating fragments in arrival order, exactly
+ * like `tool_input` string pieces. When the whole signature arrives in a single chunk there is
+ * only one fragment, so concatenation is a no-op and the value round-trips byte-identically.
+ *
+ * Exported for unit testing the round-trip in isolation (no network / no full driver).
+ */
+export function accumulateToolUseChunk(accumulatedToolUse, tool) {
+    const existing = accumulatedToolUse.get(tool.id);
+    if (!existing) {
+        // New tool call
+        accumulatedToolUse.set(tool.id, { ...tool });
+        return;
+    }
+    // Merge tool input (for streaming where arguments come as string pieces)
+    if (tool.tool_input !== null && tool.tool_input !== undefined) {
+        const existingInput = existing.tool_input;
+        const newInput = tool.tool_input;
+        if (typeof existingInput === 'string' && typeof newInput === 'string') {
+            // Concatenate string arguments
+            existing.tool_input = (existingInput + newInput);
+        }
+        else if (existingInput && typeof existingInput === 'object' && newInput && typeof newInput === 'object') {
+            // Merge objects
+            existing.tool_input = {
+                ...existingInput,
+                ...newInput,
+            };
+        }
+        else {
+            existing.tool_input = tool.tool_input;
+        }
+    }
+    // Update tool name if provided (might come in later chunk)
+    if (tool.tool_name) {
+        existing.tool_name = tool.tool_name;
+    }
+    // Reassemble the thought signature: concatenate fragments in arrival order so a
+    // signature split across chunks is restored byte-for-byte instead of being truncated.
+    if (tool.thought_signature) {
+        existing.thought_signature = (existing.thought_signature ?? '') + tool.thought_signature;
+    }
+    // Update actual ID if provided (OpenAI sends id only in first chunk)
+    if (tool._actual_id) {
+        existing._actual_id = tool._actual_id;
+    }
+}
 export class DefaultCompletionStream {
     driver;
     prompt;
@@ -19,22 +82,34 @@ export class DefaultCompletionStream {
         const accumulatedToolUse = new Map(); // Accumulate tool_use by id
         this.driver.logger.debug(`[${this.driver.provider}] Streaming Execution of ${this.options.model} with prompt`);
         const start = Date.now();
-        let finish_reason = undefined;
+        let finish_reason;
         let promptTokens = 0;
-        let resultTokens = undefined;
-        let promptCachedTokens = undefined;
-        let promptCacheWriteTokens = undefined;
-        let promptNewTokens = undefined;
+        let resultTokens;
+        let promptCachedTokens;
+        let promptCacheWriteTokens;
+        let promptNewTokens;
+        const httpScope = this.driver.createExecutionHttpAgentScope(this.options);
+        let sourceIterator;
+        let streamCompleted = false;
         try {
-            const stream = await this.driver.requestTextCompletionStream(this.prompt, this.options);
-            for await (const chunk of stream) {
+            const stream = await httpScope.run(() => this.driver.requestTextCompletionStream(this.prompt, this.options));
+            const iterator = stream[Symbol.asyncIterator]();
+            sourceIterator = iterator;
+            while (true) {
+                const next = await httpScope.run(() => iterator.next());
+                if (next.done) {
+                    streamCompleted = true;
+                    break;
+                }
+                const chunk = next.value;
                 if (chunk) {
                     if (typeof chunk === 'string') {
                         this.chunks++;
                         yield chunk;
                     }
                     else {
-                        if (chunk.finish_reason) { //Do not replace non-null values with null values
+                        if (chunk.finish_reason) {
+                            //Do not replace non-null values with null values
                             finish_reason = chunk.finish_reason; //Used to skip empty finish_reason chunks coming after "stop" or "length"
                         }
                         if (chunk.token_usage) {
@@ -54,37 +129,7 @@ export class DefaultCompletionStream {
                         // Note: During streaming, tool_input comes as string chunks that need concatenation
                         if (chunk.tool_use && chunk.tool_use.length > 0) {
                             for (const tool of chunk.tool_use) {
-                                const existing = accumulatedToolUse.get(tool.id);
-                                if (existing) {
-                                    // Merge tool input (for streaming where arguments come as string pieces)
-                                    if (tool.tool_input !== null && tool.tool_input !== undefined) {
-                                        const existingInput = existing.tool_input;
-                                        const newInput = tool.tool_input;
-                                        if (typeof existingInput === 'string' && typeof newInput === 'string') {
-                                            // Concatenate string arguments
-                                            existing.tool_input = existingInput + newInput;
-                                        }
-                                        else if (existingInput && typeof existingInput === 'object' && newInput && typeof newInput === 'object') {
-                                            // Merge objects
-                                            existing.tool_input = { ...existingInput, ...newInput };
-                                        }
-                                        else {
-                                            existing.tool_input = tool.tool_input;
-                                        }
-                                    }
-                                    // Update tool name if provided (might come in later chunk)
-                                    if (tool.tool_name) {
-                                        existing.tool_name = tool.tool_name;
-                                    }
-                                    // Update actual ID if provided (OpenAI sends id only in first chunk)
-                                    if (tool._actual_id) {
-                                        existing._actual_id = tool._actual_id;
-                                    }
-                                }
-                                else {
-                                    // New tool call
-                                    accumulatedToolUse.set(tool.id, { ...tool });
-                                }
+                                accumulateToolUseChunk(accumulatedToolUse, tool);
                             }
                         }
                         if (Array.isArray(chunk.result) && chunk.result.length > 0) {
@@ -104,15 +149,21 @@ export class DefaultCompletionStream {
                                         try {
                                             const lastParsed = lastResult.value;
                                             const currentParsed = result.value;
-                                            if (lastParsed !== null && typeof lastParsed === 'object' &&
-                                                currentParsed !== null && typeof currentParsed === 'object') {
+                                            if (lastParsed !== null &&
+                                                typeof lastParsed === 'object' &&
+                                                currentParsed !== null &&
+                                                typeof currentParsed === 'object') {
                                                 const combined = { ...lastParsed, ...currentParsed };
                                                 lastResult.value = combined;
                                             }
                                             else {
                                                 // If not objects, convert to string and concatenate
-                                                const lastStr = typeof lastParsed === 'string' ? lastParsed : JSON.stringify(lastParsed);
-                                                const currentStr = typeof currentParsed === 'string' ? currentParsed : JSON.stringify(currentParsed);
+                                                const lastStr = typeof lastParsed === 'string'
+                                                    ? lastParsed
+                                                    : JSON.stringify(lastParsed);
+                                                const currentStr = typeof currentParsed === 'string'
+                                                    ? currentParsed
+                                                    : JSON.stringify(currentParsed);
                                                 lastResult.value = lastStr + currentStr;
                                             }
                                         }
@@ -129,20 +180,26 @@ export class DefaultCompletionStream {
                             }
                             // Convert CompletionResult[] to string for streaming
                             // Only yield if we have results to show
-                            const resultText = chunk.result.map(r => {
+                            const resultText = chunk.result
+                                .map((r) => {
                                 switch (r.type) {
                                     case 'text':
                                         return r.value;
                                     case 'json':
                                         return JSON.stringify(r.value);
-                                    case 'image':
-                                        // Show truncated image placeholder for streaming
-                                        const truncatedValue = typeof r.value === 'string' ? r.value.slice(0, 10) : String(r.value).slice(0, 10);
+                                    case 'image': {
+                                        const truncatedValue = typeof r.value === 'string'
+                                            ? r.value.slice(0, 10)
+                                            : String(r.value).slice(0, 10);
                                         return `\n[Image: ${truncatedValue}...]\n`;
-                                    default:
-                                        return String(r.value || '');
+                                    }
+                                    default: {
+                                        const _exhaustive = r;
+                                        return String(_exhaustive);
+                                    }
                                 }
-                            }).join('');
+                            })
+                                .join('');
                             if (resultText) {
                                 this.chunks++;
                                 yield resultText;
@@ -163,16 +220,30 @@ export class DefaultCompletionStream {
                 operation: 'stream',
             });
         }
+        finally {
+            if (!streamCompleted && sourceIterator?.return) {
+                const returnIterator = sourceIterator.return.bind(sourceIterator);
+                try {
+                    await httpScope.run(() => returnIterator());
+                }
+                catch {
+                    /* stream cleanup best-effort */
+                }
+            }
+            await httpScope.close();
+        }
         // Return undefined only if we never received any token data from the provider.
         // Use !== undefined (not truthiness) because resultTokens === 0 is valid (e.g. empty output with stop).
-        const tokens = resultTokens !== undefined ? {
-            prompt: promptTokens,
-            result: resultTokens,
-            total: resultTokens + promptTokens,
-            ...(promptCachedTokens != null && { prompt_cached: promptCachedTokens }),
-            ...(promptCacheWriteTokens != null && { prompt_cache_write: promptCacheWriteTokens }),
-            ...(promptNewTokens != null && { prompt_new: promptNewTokens }),
-        } : undefined;
+        const tokens = resultTokens !== undefined
+            ? {
+                prompt: promptTokens,
+                result: resultTokens,
+                total: resultTokens + promptTokens,
+                ...(promptCachedTokens != null && { prompt_cached: promptCachedTokens }),
+                ...(promptCacheWriteTokens != null && { prompt_cache_write: promptCacheWriteTokens }),
+                ...(promptNewTokens != null && { prompt_new: promptNewTokens }),
+            }
+            : undefined;
         // Convert accumulated tool_use Map to array
         let toolUseArray = accumulatedToolUse.size > 0 ? Array.from(accumulatedToolUse.values()) : undefined;
         // Finalize tool calls: restore actual IDs and parse JSON arguments
@@ -200,7 +271,7 @@ export class DefaultCompletionStream {
             // If finish_reason is "length" (max_tokens hit), drop truncated tool calls entirely —
             // they were cut off mid-generation and would produce invalid results.
             if (finish_reason === 'length' && truncatedToolIds.size > 0) {
-                toolUseArray = toolUseArray.filter(t => !truncatedToolIds.has(t.id));
+                toolUseArray = toolUseArray.filter((t) => !truncatedToolIds.has(t.id));
                 if (toolUseArray.length === 0) {
                     toolUseArray = undefined;
                 }
@@ -208,7 +279,7 @@ export class DefaultCompletionStream {
         }
         this.completion = {
             result: accumulatedResults, // Return the accumulated CompletionResult[] instead of text
-            prompt: this.prompt,
+            prompt: this.driver.formatDebugPrompt(this.prompt),
             execution_time: Date.now() - start,
             token_usage: tokens,
             finish_reason: finish_reason,
@@ -255,20 +326,24 @@ export class FallbackCompletionStream {
         try {
             const completion = await this.driver._execute(this.prompt, this.options);
             // For fallback streaming, yield the text content but keep the original completion
-            const content = completion.result.map(r => {
+            const content = completion.result
+                .map((r) => {
                 switch (r.type) {
                     case 'text':
                         return r.value;
                     case 'json':
                         return JSON.stringify(r.value);
-                    case 'image':
-                        // Show truncated image placeholder for streaming
+                    case 'image': {
                         const truncatedValue = typeof r.value === 'string' ? r.value.slice(0, 10) : String(r.value).slice(0, 10);
                         return `[Image: ${truncatedValue}...]`;
-                    default:
-                        return String(r.value || '');
+                    }
+                    default: {
+                        const _exhaustive = r;
+                        return String(_exhaustive);
+                    }
                 }
-            }).join('');
+            })
+                .join('');
             yield content;
             this.completion = completion; // Return the original completion with untouched CompletionResult[]
         }

package/lib/CompletionStream.js.map

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

package/lib/{types/Driver.d.ts → Driver.d.ts}

@@ -3,8 +3,10 @@
  * Base abstract class is then implemented by each environment
  * (eg: OpenAI, HuggingFace, etc.)
  */
-import { AIModel, Completion, CompletionChunkObject, CompletionStream, DataSource, DriverOptions, EmbeddingsOptions, EmbeddingsResult, ExecutionOptions, ExecutionResponse, LlumiverseErrorContext, Logger, ModelSearchPayload, PromptOptions, PromptSegment, Providers, TrainingJob, TrainingOptions, TrainingPromptOptions, LlumiverseError } from "@llumiverse/common";
-export declare function createLogger(logger: Logger | "console" | undefined): Logger;
+import { type AIModel, type Completion, type CompletionChunkObject, type CompletionStream, type DataSource, type DriverOptions, type EmbeddingsOptions, type EmbeddingsResult, type ExecutionOptions, type ExecutionResponse, LlumiverseError, type LlumiverseErrorContext, type Logger, type ModelSearchPayload, type PromptOptions, type PromptSegment, type Providers, type TrainingJob, type TrainingOptions, type TrainingPromptOptions } from '@llumiverse/common';
+import type { Agent } from 'undici';
+import { type DriverHttpAgentScope } from './http-agent.js';
+export { createLogger } from './logger.js';
 export interface Driver<PromptT = unknown> {
     /**
      *
@@ -22,6 +24,13 @@ export interface Driver<PromptT = unknown> {
     listModels(params?: ModelSearchPayload): Promise<AIModel[]>;
     listTrainableModels(): Promise<AIModel[]>;
     validateConnection(): Promise<boolean>;
+    /**
+     * Generate embeddings for one or more inputs.
+     * Inputs may be text, image, video, or audio depending on the model and
+     * provider. Returns one result item per input, each with one or more
+     * output vectors (single-vector for text/image, multi-vector for
+     * segmented video/audio or joint-multimodal models).
+     */
     generateEmbeddings(options: EmbeddingsOptions): Promise<EmbeddingsResult>;
     /**
      * Optional cleanup method called when the driver is evicted from the cache.
@@ -36,7 +45,28 @@ export declare abstract class AbstractDriver<OptionsT extends DriverOptions = Dr
     options: OptionsT;
     logger: Logger;
     abstract provider: Providers | string;
+    private _httpAgent?;
+    private _driverFetch?;
     constructor(opts: OptionsT);
+    /**
+     * Lazily-created undici `Agent` driven by `options.httpTimeout`.
+     * Pools sockets for the lifetime of the driver. Subclasses can
+     * either pass this directly to an SDK that accepts a `dispatcher`
+     * option (rare), or — much more commonly — use {@link getDriverFetch}
+     * to get a fetch implementation backed by it.
+     *
+     * Released via {@link destroy}.
+     */
+    protected getHttpAgent(): Agent;
+    /**
+     * Fetch-compatible function backed by the driver's HTTP agent.
+     * Pass to any SDK that accepts a custom `fetch` option (OpenAI,
+     * Anthropic, `@google/genai`, Bedrock via Smithy, …) or use as a
+     * drop-in replacement for the global `fetch` in drivers that make
+     * raw HTTP calls.
+     */
+    protected getDriverFetch(): typeof fetch;
+    createExecutionHttpAgentScope(options: Pick<ExecutionOptions, 'httpTimeout'>): DriverHttpAgentScope;
     createTrainingPrompt(options: TrainingPromptOptions): Promise<string>;
     startTraining(_dataset: DataSource, _options: TrainingOptions): Promise<TrainingJob>;
     cancelTraining(_jobId: string): Promise<TrainingJob>;
@@ -44,6 +74,7 @@ export declare abstract class AbstractDriver<OptionsT extends DriverOptions = Dr
     validateResult(result: Completion, options: ExecutionOptions): void;
     execute(segments: PromptSegment[], options: ExecutionOptions): Promise<ExecutionResponse<PromptT>>;
     _execute(prompt: PromptT, options: ExecutionOptions): Promise<ExecutionResponse<PromptT>>;
+    formatDebugPrompt(prompt: PromptT): PromptT;
     protected isImageModel(_model: string): boolean;
     stream(segments: PromptSegment[], options: ExecutionOptions): Promise<CompletionStream<PromptT>>;
     /**
@@ -89,8 +120,8 @@ export declare abstract class AbstractDriver<OptionsT extends DriverOptions = Dr
      * - Status 429, 408: retryable (rate limit, timeout)
      * - Status 529: retryable (overloaded)
      * - Status 5xx: retryable (server errors)
-     * - Status 4xx (except above): not retryable (client errors)
-     * - Error messages containing "rate limit", "timeout", etc.: retryable
+     * - High-confidence transient messages containing "rate limit", "timeout", etc.: retryable
+     * - Status 4xx (except above and transient provider quirks): not retryable (client errors)
      *
      * @param error - The error to format
      * @param context - Context about where the error occurred
@@ -114,7 +145,9 @@ export declare abstract class AbstractDriver<OptionsT extends DriverOptions = Dr
     abstract generateEmbeddings(options: EmbeddingsOptions): Promise<EmbeddingsResult>;
     /**
      * Cleanup method called when the driver is evicted from the cache.
-     * Override this in driver implementations that need to release resources.
+     * Releases the lazily-created HTTP agent socket pool. Override this
+     * in driver implementations that need to release additional resources
+     * — MUST call `super.destroy()` to avoid leaking sockets.
      */
     destroy(): void;
 }

package/lib/Driver.d.ts.map

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