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

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

@@ -3,50 +3,18 @@
  * Base abstract class is then implemented by each environment
  * (eg: OpenAI, HuggingFace, etc.)
  */
-import { LlumiverseError } from "@llumiverse/common";
-import { DefaultCompletionStream, FallbackCompletionStream } from "./CompletionStream.js";
-import { formatTextPrompt } from "./formatters/index.js";
-import { validateResult } from "./validation.js";
-// Helper to create logger methods that support both message-only and object-first signatures
-function createConsoleLoggerMethod(consoleMethod) {
-    return ((objOrMsg, msgOrNever, ...args) => {
-        if (typeof objOrMsg === 'string') {
-            // Message-only: logger.info("message", ...args)
-            consoleMethod(objOrMsg, msgOrNever, ...args);
-        }
-        else if (msgOrNever !== undefined) {
-            // Object-first: logger.info({ obj }, "message", ...args)
-            consoleMethod(msgOrNever, objOrMsg, ...args);
-        }
-        else {
-            // Object-only: logger.info({ obj })
-            consoleMethod(objOrMsg, ...args);
-        }
-    });
-}
-const ConsoleLogger = {
-    debug: createConsoleLoggerMethod(console.debug.bind(console)),
-    info: createConsoleLoggerMethod(console.info.bind(console)),
-    warn: createConsoleLoggerMethod(console.warn.bind(console)),
-    error: createConsoleLoggerMethod(console.error.bind(console)),
-};
-const noop = () => void 0;
-const NoopLogger = {
-    debug: noop,
-    info: noop,
-    warn: noop,
-    error: noop,
-};
-export function createLogger(logger) {
-    if (logger === "console") {
-        return ConsoleLogger;
-    }
-    else if (logger) {
-        return logger;
-    }
-    else {
-        return NoopLogger;
+import { LlumiverseError, } from '@llumiverse/common';
+import { DefaultCompletionStream, FallbackCompletionStream } from './CompletionStream.js';
+import { formatTextPrompt } from './formatters/index.js';
+import { createAgentBackedFetch, createDriverHttpAgent, createDriverHttpAgentScope, } from './http-agent.js';
+import { createLogger } from './logger.js';
+import { validateResult } from './validation.js';
+export { createLogger } from './logger.js';
+function getObjectProperty(value, key) {
+    if (value && typeof value === 'object' && key in value) {
+        return value[key];
     }
+    return undefined;
 }
 /**
  * To be implemented by each driver
@@ -54,25 +22,61 @@ export function createLogger(logger) {
 export class AbstractDriver {
     options;
     logger;
+    _httpAgent;
+    _driverFetch;
     constructor(opts) {
         this.options = opts;
         this.logger = createLogger(opts.logger);
     }
+    /**
+     * 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}.
+     */
+    getHttpAgent() {
+        if (!this._httpAgent) {
+            this._httpAgent = createDriverHttpAgent(this.options.httpTimeout);
+        }
+        return this._httpAgent;
+    }
+    /**
+     * 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.
+     */
+    getDriverFetch() {
+        if (!this._driverFetch) {
+            this._driverFetch = createAgentBackedFetch(this.getHttpAgent());
+        }
+        return this._driverFetch;
+    }
+    createExecutionHttpAgentScope(options) {
+        return createDriverHttpAgentScope(this.options.httpTimeout, options.httpTimeout);
+    }
     async createTrainingPrompt(options) {
-        const prompt = await this.createPrompt(options.segments, { result_schema: options.schema, model: options.model });
+        const prompt = await this.createPrompt(options.segments, {
+            result_schema: options.schema,
+            model: options.model,
+        });
         return JSON.stringify({
             prompt,
-            completion: typeof options.completion === 'string' ? options.completion : JSON.stringify(options.completion)
+            completion: typeof options.completion === 'string' ? options.completion : JSON.stringify(options.completion),
         });
     }
     startTraining(_dataset, _options) {
-        throw new Error("Method not implemented.");
+        throw new Error('Method not implemented.');
     }
     cancelTraining(_jobId) {
-        throw new Error("Method not implemented.");
+        throw new Error('Method not implemented.');
     }
     getTrainingJob(_jobId) {
-        throw new Error("Method not implemented.");
+        throw new Error('Method not implemented.');
     }
     validateResult(result, options) {
         if (!result.tool_use && !result.error && options.result_schema) {
@@ -80,11 +84,14 @@ export class AbstractDriver {
                 result.result = validateResult(result.result, options.result_schema);
             }
             catch (error) {
-                const errorMessage = `[${this.provider}] [${options.model}] ${error.code ? '[' + error.code + '] ' : ''}Result validation error: ${error.message}`;
+                const validationError = error instanceof Error ? error : new Error(String(error));
+                const rawCode = getObjectProperty(error, 'code');
+                const code = rawCode === 'json_error' || rawCode === 'validation_error' ? rawCode : undefined;
+                const errorMessage = `[${this.provider}] [${options.model}] ${code ? `[${code}] ` : ''}Result validation error: ${validationError.message}`;
                 this.logger.error({ err: error, data: result.result }, errorMessage);
                 result.error = {
-                    code: error.code || error.name,
-                    message: error.message,
+                    code: code || 'validation_error',
+                    message: validationError.message,
                     data: result.result,
                 };
             }
@@ -105,34 +112,48 @@ export class AbstractDriver {
         });
     }
     async _execute(prompt, options) {
+        const httpScope = this.createExecutionHttpAgentScope(options);
         try {
-            const start = Date.now();
-            let result;
-            if (this.isImageModel(options.model)) {
-                this.logger.debug(`[${this.provider}] Executing prompt on ${options.model}, image pathway.`);
-                result = await this.requestImageGeneration(prompt, options);
-            }
-            else {
-                this.logger.debug(`[${this.provider}] Executing prompt on ${options.model}, text pathway.`);
-                result = await this.requestTextCompletion(prompt, options);
-                this.validateResult(result, options);
-            }
-            const execution_time = Date.now() - start;
-            return { ...result, prompt, execution_time };
-        }
-        catch (error) {
-            // Don't wrap if already a LlumiverseError
-            if (LlumiverseError.isLlumiverseError(error)) {
-                throw error;
-            }
-            // Log the original error for debugging
-            this.logger.error({ err: error, data: { provider: this.provider, model: options.model, operation: 'execute', prompt } }, `Error during execution in provider ${this.provider}:`);
-            throw this.formatLlumiverseError(error, {
-                provider: this.provider,
-                model: options.model,
-                operation: 'execute',
+            return await httpScope.run(async () => {
+                try {
+                    const start = Date.now();
+                    let result;
+                    if (this.isImageModel(options.model)) {
+                        this.logger.debug(`[${this.provider}] Executing prompt on ${options.model}, image pathway.`);
+                        result = await this.requestImageGeneration(prompt, options);
+                    }
+                    else {
+                        this.logger.debug(`[${this.provider}] Executing prompt on ${options.model}, text pathway.`);
+                        result = await this.requestTextCompletion(prompt, options);
+                        this.validateResult(result, options);
+                    }
+                    const execution_time = Date.now() - start;
+                    return { ...result, prompt, execution_time };
+                }
+                catch (error) {
+                    // Don't wrap if already a LlumiverseError
+                    if (LlumiverseError.isLlumiverseError(error)) {
+                        throw error;
+                    }
+                    // Log the original error for debugging
+                    this.logger.error({
+                        err: error,
+                        data: { provider: this.provider, model: options.model, operation: 'execute', prompt },
+                    }, `Error during execution in provider ${this.provider}:`);
+                    throw this.formatLlumiverseError(error, {
+                        provider: this.provider,
+                        model: options.model,
+                        operation: 'execute',
+                    });
+                }
             });
         }
+        finally {
+            await httpScope.close();
+        }
+    }
+    formatDebugPrompt(prompt) {
+        return prompt;
     }
     isImageModel(_model) {
         return false;
@@ -162,7 +183,9 @@ export class AbstractDriver {
         return formatTextPrompt(segments, opts.result_schema);
     }
     async createPrompt(segments, opts) {
-        return await (opts.format ? opts.format(segments, opts.result_schema) : this.formatPrompt(segments, opts));
+        return await (opts.format
+            ? opts.format(segments, opts.result_schema)
+            : this.formatPrompt(segments, opts));
     }
     /**
      * Must be overridden if the implementation cannot stream.
@@ -206,8 +229,8 @@ export class AbstractDriver {
      * - 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
@@ -216,18 +239,17 @@ export class AbstractDriver {
     formatLlumiverseError(error, context) {
         // Extract status code from common locations (only if numeric)
         let code;
-        const rawCode = error?.status
-            || error?.statusCode
-            || error?.code;
+        const rawCode = getObjectProperty(error, 'status') ||
+            getObjectProperty(error, 'statusCode') ||
+            getObjectProperty(error, 'code');
         if (typeof rawCode === 'number') {
             code = rawCode;
         }
         // Extract error name if available
-        const errorName = error?.name;
+        const rawErrorName = getObjectProperty(error, 'name');
+        const errorName = typeof rawErrorName === 'string' ? rawErrorName : undefined;
         // Extract message
-        const message = error instanceof Error
-            ? error.message
-            : String(error);
+        const message = error instanceof Error ? error.message : String(error);
         // Determine retryability
         const retryable = this.isRetryableError(code, message);
         return new LlumiverseError(`[${this.provider}] ${message}`, retryable, context, error, code, errorName);
@@ -241,34 +263,24 @@ export class AbstractDriver {
      * @returns True if retryable, false if not retryable, undefined if unknown
      */
     isRetryableError(statusCode, message) {
-        // Numeric status codes
-        if (statusCode !== undefined) {
-            if (statusCode === 429 || statusCode === 408)
-                return true; // Rate limit, timeout
-            if (statusCode === 529)
-                return true; // Overloaded
-            if (statusCode >= 500 && statusCode < 600)
-                return true; // Server errors
-            return false; // 4xx client errors not retryable
-        }
-        // Message-based detection for non-HTTP errors
         const lowerMessage = message.toLowerCase();
-        // Rate limit variations
+        // Provider APIs sometimes surface transient failures under misleading
+        // client status codes, so high-confidence transient message signals
+        // must be honored before the generic 4xx classification below.
+        if (lowerMessage.includes('url_rejected-rejected_client_throttled'))
+            return true;
+        if (lowerMessage.includes('url_rejected-rejected_rate_limited'))
+            return true;
         if (lowerMessage.includes('rate') && lowerMessage.includes('limit'))
             return true;
-        // Timeout variations (timeout, timed out, time out)
         if (lowerMessage.includes('timeout'))
             return true;
         if (lowerMessage.includes('timed') && lowerMessage.includes('out'))
             return true;
         if (lowerMessage.includes('time') && lowerMessage.includes('out'))
             return true;
-        // Resource exhausted variations
         if (lowerMessage.includes('resource') && lowerMessage.includes('exhaust'))
             return true;
-        // Other retryable patterns
-        if (lowerMessage.includes('retry'))
-            return true;
         if (lowerMessage.includes('overload'))
             return true;
         if (lowerMessage.includes('throttl'))
@@ -277,19 +289,52 @@ export class AbstractDriver {
             return true;
         if (lowerMessage.includes('529'))
             return true;
+        // A transport-level abort (request-timeout / dropped connection) or a
+        // deadline-exceeded is transient and should be retried — even when the provider
+        // surfaces it under a misleading 4xx status. A deliberate cancellation is raised
+        // as a Temporal CancelledFailure (not an LLM error), so it never reaches here.
+        if (lowerMessage.includes('aborted'))
+            return true;
+        if (lowerMessage.includes('deadline'))
+            return true;
+        // Explicit auth failures should never be retried even when they arrive without
+        // a numeric status code (for example, google-auth-library invalid_grant errors).
+        if (lowerMessage.includes('invalid_grant'))
+            return false;
+        if (lowerMessage.includes("credential's issuer"))
+            return false;
+        // Numeric status codes
+        if (statusCode !== undefined) {
+            if (statusCode === 429 || statusCode === 408)
+                return true; // Rate limit, timeout
+            if (statusCode === 529)
+                return true; // Overloaded
+            if (statusCode >= 500 && statusCode < 600)
+                return true; // Server errors
+            return false; // 4xx client errors not retryable
+        }
+        // Message-based detection for non-HTTP errors
+        if (lowerMessage.includes('retry'))
+            return true;
         // Unknown errors - let consumer decide retry strategy
         return undefined;
     }
     async requestImageGeneration(_prompt, _options) {
-        throw new Error("Image generation not implemented.");
+        throw new Error('Image generation not implemented.');
         //Cannot be made abstract, as abstract methods are required in the derived class
     }
     /**
      * 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() {
-        // No-op by default
+        this._httpAgent?.close().catch(() => {
+            /* shutdown best-effort */
+        });
+        this._httpAgent = undefined;
+        this._driverFetch = undefined;
     }
 }
 //# sourceMappingURL=Driver.js.map

package/lib/Driver.js.map

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

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

@@ -1,12 +1,12 @@
-import type { ServerSentEvent } from "@vertesia/api-fetch-client";
-import { CompletionChunkObject } from "@llumiverse/common";
+import type { CompletionChunkObject } from '@llumiverse/common';
+import type { ServerSentEvent } from '@vertesia/api-fetch-client';
 export declare function asyncMap<T, R>(asyncIterable: AsyncIterable<T>, callback: (value: T, index: number) => R): AsyncGenerator<Awaited<R>, void, unknown>;
 export declare function oneAsyncIterator<T>(value: T): AsyncIterable<T>;
 /**
  * Given a ReadableStream of server sent events, tran
  */
 export declare function transformSSEStream(stream: ReadableStream<ServerSentEvent>, transform: (data: string) => CompletionChunkObject): ReadableStream<CompletionChunkObject> & AsyncIterable<CompletionChunkObject>;
-export declare class EventStream<T, ReturnT = any> implements AsyncIterable<T> {
+export declare class EventStream<T, ReturnT = unknown> implements AsyncIterable<T> {
     private queue;
     private pending?;
     private done;

package/lib/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../src/async.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,wBAAuB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,6CAG9G;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAM9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,EACvC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,GACnD,cAAc,CAAC,qBAAqB,CAAC,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAiB9E;AAED,qBAAa,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,OAAO,CAAC,CAGd;IACF,OAAO,CAAC,IAAI,CAAS;IAErB,IAAI,CAAC,KAAK,EAAE,CAAC;IAYb;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO;IAQrB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CA0BlE;AAED;;;;IAII;AACJ,wBAAuB,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAC9C,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC,EACnC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACvC,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACpC,aAAa,CAAC,CAAC,CAAC,CAOlB"}

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

@@ -7,7 +7,7 @@ export function oneAsyncIterator(value) {
     return {
         async *[Symbol.asyncIterator]() {
             yield value;
-        }
+        },
     };
 }
 /**
@@ -22,12 +22,12 @@ export function transformSSEStream(stream, transform) {
                     const result = transform(event.data) ?? '';
                     controller.enqueue(result);
                 }
-                catch (err) {
+                catch {
                     // double check for the last event which is not a JSON - at this time togetherai and mistralai returns the string [DONE]
                     // do nothing - happens if data is not a JSON - the last event data is the [DONE] string
                 }
             }
-        }
+        },
     }));
 }
 export class EventStream {
@@ -82,7 +82,7 @@ export class EventStream {
                 }
                 const _value = await value;
                 return { done: true, value: _value };
-            }
+            },
         };
     }
 }

package/lib/async.js.map

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

package/lib/{types/conversation-utils.d.ts → conversation-utils.d.ts}

@@ -39,6 +39,15 @@ export interface StripOptions {
      * - N > 0: Truncate text to approximately N tokens (~4 chars/token)
      */
     textMaxTokens?: number;
+    /**
+     * Number of most-recent messages to leave untouched when truncating large
+     * text (the active working set). Only messages OLDER than the last
+     * `keepRecentMessages` entries get their large strings truncated to
+     * `textMaxTokens`. Requires a conversation with a `messages` array.
+     * - undefined/0: No turn awareness — truncate every large string (legacy).
+     * - N > 0: Keep the last N messages full; truncate older ones.
+     */
+    keepRecentMessages?: number;
 }
 /**
  * Get metadata from a conversation object, or return defaults.

package/lib/conversation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-utils.d.ts","sourceRoot":"","sources":["../src/conversation-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA+JD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,OAAO,GAAG,gBAAgB,CAQ3E;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAS1F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,SAAS,CAQ3F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAGxE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAYzF;AA2BD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAwBlE;AAkDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAW/F;AAmDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CA4B7F;AAuHD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAe7F"}

package/lib/{esm/conversation-utils.js → conversation-utils.js}

@@ -129,9 +129,7 @@ function isOpenAIBase64ImageBlock(obj) {
     if (!o.image_url || typeof o.image_url !== 'object')
         return false;
     const imgUrl = o.image_url;
-    return typeof imgUrl.url === 'string' &&
-        imgUrl.url.startsWith('data:image/') &&
-        imgUrl.url.includes(';base64,');
+    return typeof imgUrl.url === 'string' && imgUrl.url.startsWith('data:image/') && imgUrl.url.includes(';base64,');
 }
 /**
  * Check if an object is an Anthropic base64 image block: { type: "image", source: { type: "base64", data: "...", media_type: "..." } }
@@ -280,7 +278,7 @@ function serializeBinaryForStorage(obj) {
         return { _base64: uint8ArrayToBase64(obj) };
     }
     if (Array.isArray(obj)) {
-        return obj.map(item => serializeBinaryForStorage(item));
+        return obj.map((item) => serializeBinaryForStorage(item));
     }
     if (typeof obj === 'object') {
         const result = {};
@@ -306,7 +304,7 @@ export function deserializeBinaryFromStorage(obj) {
         }
     }
     if (Array.isArray(obj)) {
-        return obj.map(item => deserializeBinaryFromStorage(item));
+        return obj.map((item) => deserializeBinaryFromStorage(item));
     }
     if (typeof obj === 'object') {
         const result = {};
@@ -332,7 +330,7 @@ function stripBinaryFromConversationInternal(obj) {
         }
     }
     if (Array.isArray(obj)) {
-        return obj.map(item => {
+        return obj.map((item) => {
             // Replace entire Bedrock image/document/video blocks with text blocks
             if (isBedrockImageBlock(item) || isSerializedBedrockImageBlock(item)) {
                 return { text: IMAGE_PLACEHOLDER };
@@ -392,7 +390,7 @@ function stripBase64ImagesFromConversationInternal(obj) {
         return IMAGE_PLACEHOLDER;
     }
     if (Array.isArray(obj)) {
-        return obj.map(item => {
+        return obj.map((item) => {
             // Replace entire OpenAI image_url blocks with text blocks
             if (isOpenAIBase64ImageBlock(item)) {
                 return { type: 'text', text: IMAGE_PLACEHOLDER };
@@ -451,24 +449,78 @@ export function truncateLargeTextInConversation(obj, options) {
         return obj;
     }
     const maxChars = maxTokens * CHARS_PER_TOKEN;
+    const keepRecent = options?.keepRecentMessages;
+    // Turn-aware path: keep the most recent `keepRecent` messages untouched (the
+    // agent's active working set — the file it just read/wrote, latest
+    // diagnostics) and truncate large strings only in older messages. This lets
+    // callers use an aggressive cap without blinding the model to current work.
+    if (keepRecent && keepRecent > 0) {
+        const messages = getConversationMessages(obj);
+        if (messages && messages.length > keepRecent) {
+            const cutoff = messages.length - keepRecent;
+            const truncated = messages.map((m, i) => (i < cutoff ? truncateLargeTextInternal(m, maxChars) : m));
+            return setConversationMessages(obj, truncated);
+        }
+        // No identifiable messages array, or short conversation: leave it full.
+        return obj;
+    }
+    // Legacy path: truncate every large string in the conversation.
     return truncateLargeTextInternal(obj, maxChars);
 }
+/**
+ * Extract the message history array from a conversation object, handling the
+ * `{ messages: [...] }` shape (Claude/OpenAI), the wrapped-array shape, and a
+ * plain array. Returns undefined when no message array is identifiable.
+ */
+function getConversationMessages(obj) {
+    if (Array.isArray(obj))
+        return obj;
+    const wrapped = unwrapConversationArray(obj);
+    if (wrapped)
+        return wrapped;
+    if (typeof obj === 'object' && obj !== null) {
+        const messages = obj.messages;
+        if (Array.isArray(messages))
+            return messages;
+    }
+    return undefined;
+}
+/**
+ * Rebuild a conversation with a new message array, matching the shape returned
+ * by getConversationMessages.
+ */
+function setConversationMessages(obj, messages) {
+    if (Array.isArray(obj))
+        return messages;
+    if (unwrapConversationArray(obj)) {
+        return { ...obj, [ARRAY_WRAPPER_KEY]: messages };
+    }
+    if (typeof obj === 'object' && obj !== null) {
+        return { ...obj, messages };
+    }
+    return obj;
+}
 function shouldPreserveMediaPayload(obj) {
     if (typeof obj !== 'object' || obj === null)
         return false;
     const o = obj;
     // Preserved Bedrock binary blocks and their serialized storage wrapper.
-    if (isBedrockImageBlock(obj) || isSerializedBedrockImageBlock(obj) ||
-        isBedrockDocumentBlock(obj) || isSerializedBedrockDocumentBlock(obj) ||
-        isBedrockVideoBlock(obj) || isSerializedBedrockVideoBlock(obj)) {
+    if (isBedrockImageBlock(obj) ||
+        isSerializedBedrockImageBlock(obj) ||
+        isBedrockDocumentBlock(obj) ||
+        isSerializedBedrockDocumentBlock(obj) ||
+        isBedrockVideoBlock(obj) ||
+        isSerializedBedrockVideoBlock(obj)) {
         return true;
     }
     if (typeof o._base64 === 'string' && Object.keys(o).length === 1) {
         return true;
     }
     // Preserved base64 media payloads for OpenAI, Gemini, and Anthropic/Claude.
-    if (isOpenAIBase64ImageBlock(obj) || isGeminiInlineDataBlock(obj) ||
-        isAnthropicBase64ImageBlock(obj) || isAnthropicBase64DocumentBlock(obj)) {
+    if (isOpenAIBase64ImageBlock(obj) ||
+        isGeminiInlineDataBlock(obj) ||
+        isAnthropicBase64ImageBlock(obj) ||
+        isAnthropicBase64DocumentBlock(obj)) {
         return true;
     }
     return false;
@@ -482,12 +534,23 @@ function truncateLargeTextInternal(obj, maxChars) {
             return obj;
         }
         if (obj.length > maxChars) {
-            return obj.substring(0, maxChars) + TEXT_TRUNCATED_MARKER;
+            // Don't cut through a surrogate pair: substring() slices at a UTF-16
+            // code-unit index, so a boundary that lands between the two halves of
+            // a non-BMP character (emoji, CJK-ext, …) leaves a lone high surrogate.
+            // That is invalid Unicode — it can't be UTF-8 encoded losslessly and
+            // strict JSON parsers (e.g. Vertex/Gemini) reject the request body as
+            // "The input data is not valid json". Step back one unit in that case.
+            let end = maxChars;
+            const lastUnit = obj.charCodeAt(end - 1);
+            if (lastUnit >= 0xd800 && lastUnit <= 0xdbff) {
+                end -= 1;
+            }
+            return obj.substring(0, end) + TEXT_TRUNCATED_MARKER;
         }
         return obj;
     }
     if (Array.isArray(obj)) {
-        return obj.map(item => truncateLargeTextInternal(item, maxChars));
+        return obj.map((item) => truncateLargeTextInternal(item, maxChars));
     }
     if (typeof obj === 'object') {
         if (shouldPreserveMediaPayload(obj)) {
@@ -548,7 +611,7 @@ function stripHeartbeatsInternal(obj) {
         return obj;
     }
     if (Array.isArray(obj)) {
-        return obj.map(item => stripHeartbeatsInternal(item));
+        return obj.map((item) => stripHeartbeatsInternal(item));
     }
     if (typeof obj === 'object') {
         const result = {};