@proteinjs/conversation 2.6.0 → 2.7.1

package/dist/src/OpenAiResponses.js

@@ -1,4 +1,19 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -45,14 +60,17 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenAiResponses = exports.DEFAULT_MAX_TOOL_CALLS = exports.DEFAULT_RESPONSES_MODEL = void 0;
+exports.OpenAiResponsesError = exports.OpenAiResponses = exports.DEFAULT_MAX_BACKGROUND_WAIT_MS = exports.DEFAULT_MAX_TOOL_CALLS = exports.DEFAULT_RESPONSES_MODEL = void 0;
 var openai_1 = require("openai");
 var logger_1 = require("@proteinjs/logger");
 var UsageData_1 = require("./UsageData");
 var ChatCompletionMessageParamFactory_1 = require("./ChatCompletionMessageParamFactory");
-var OpenAi_1 = require("./OpenAi");
 exports.DEFAULT_RESPONSES_MODEL = 'gpt-5.2';
 exports.DEFAULT_MAX_TOOL_CALLS = 50;
+/** Default hard cap for background-mode polling duration (ms): 1 hour. */
+exports.DEFAULT_MAX_BACKGROUND_WAIT_MS = 60 * 60 * 1000;
+/** Best-effort timeout for cancel calls (avoid hanging abort/timeout paths). */
+var DEFAULT_CANCEL_TIMEOUT_MS = 10000;
 /**
  * OpenAI Responses API wrapper (tool-loop + usage tracking + ConversationModules).
  * - Uses Responses API directly
@@ -74,13 +92,19 @@ var OpenAiResponses = /** @class */ (function () {
         this.logger = new logger_1.Logger({ name: 'OpenAiResponses', logLevel: opts.logLevel });
         this.modules = (_a = opts.modules) !== null && _a !== void 0 ? _a : [];
         this.allowedFunctionNames = opts.allowedFunctionNames;
-        this.defaultModel = ((_b = opts.defaultModel) !== null && _b !== void 0 ? _b : exports.DEFAULT_RESPONSES_MODEL).trim();
+        this.defaultModel = (_b = opts.defaultModel) !== null && _b !== void 0 ? _b : exports.DEFAULT_RESPONSES_MODEL;
         this.defaultMaxToolCalls = typeof opts.maxToolCalls === 'number' ? opts.maxToolCalls : exports.DEFAULT_MAX_TOOL_CALLS;
+        this.defaultMaxBackgroundWaitMs =
+            typeof opts.maxBackgroundWaitMs === 'number' &&
+                Number.isFinite(opts.maxBackgroundWaitMs) &&
+                opts.maxBackgroundWaitMs > 0
+                ? Math.floor(opts.maxBackgroundWaitMs)
+                : exports.DEFAULT_MAX_BACKGROUND_WAIT_MS;
     }
     /** Plain text generation (supports tool calling). */
     OpenAiResponses.prototype.generateText = function (args) {
         return __awaiter(this, void 0, void 0, function () {
-            var model, backgroundMode, maxToolCalls, result;
+            var model, backgroundMode, maxToolCalls, maxBackgroundWaitMs, result;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0: return [4 /*yield*/, this.ensureModulesProcessed()];
@@ -93,6 +117,7 @@ var OpenAiResponses = /** @class */ (function () {
                             reasoningEffort: args.reasoningEffort,
                         });
                         maxToolCalls = typeof args.maxToolCalls === 'number' ? args.maxToolCalls : this.defaultMaxToolCalls;
+                        maxBackgroundWaitMs = this.resolveMaxBackgroundWaitMs(args.maxBackgroundWaitMs);
                         return [4 /*yield*/, this.run({
                                 model: model,
                                 messages: args.messages,
@@ -104,7 +129,9 @@ var OpenAiResponses = /** @class */ (function () {
                                 reasoningEffort: args.reasoningEffort,
                                 maxToolCalls: maxToolCalls,
                                 backgroundMode: backgroundMode,
+                                maxBackgroundWaitMs: maxBackgroundWaitMs,
                                 textFormat: undefined,
+                                serviceTier: args.serviceTier,
                             })];
                     case 2:
                         result = _a.sent();
@@ -129,7 +156,7 @@ var OpenAiResponses = /** @class */ (function () {
     /** Structured object generation (supports tool calling). */
     OpenAiResponses.prototype.generateObject = function (args) {
         return __awaiter(this, void 0, void 0, function () {
-            var model, backgroundMode, maxToolCalls, textFormat, result, object, outcome;
+            var model, backgroundMode, maxToolCalls, maxBackgroundWaitMs, textFormat, result, object, outcome;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0: return [4 /*yield*/, this.ensureModulesProcessed()];
@@ -142,6 +169,7 @@ var OpenAiResponses = /** @class */ (function () {
                             reasoningEffort: args.reasoningEffort,
                         });
                         maxToolCalls = typeof args.maxToolCalls === 'number' ? args.maxToolCalls : this.defaultMaxToolCalls;
+                        maxBackgroundWaitMs = this.resolveMaxBackgroundWaitMs(args.maxBackgroundWaitMs);
                         textFormat = this.buildTextFormat(args.schema);
                         return [4 /*yield*/, this.run({
                                 model: model,
@@ -154,11 +182,18 @@ var OpenAiResponses = /** @class */ (function () {
                                 reasoningEffort: args.reasoningEffort,
                                 maxToolCalls: maxToolCalls,
                                 backgroundMode: backgroundMode,
+                                maxBackgroundWaitMs: maxBackgroundWaitMs,
                                 textFormat: textFormat,
+                                serviceTier: args.serviceTier,
                             })];
                     case 2:
                         result = _a.sent();
-                        object = this.parseAndValidateStructuredOutput(result.message, args.schema);
+                        object = this.parseAndValidateStructuredOutput(result.message, args.schema, {
+                            model: model,
+                            maxOutputTokens: args.maxTokens,
+                            requestedServiceTier: args.serviceTier,
+                            serviceTier: result.serviceTier,
+                        });
                         outcome = {
                             object: object,
                             usageData: result.usagedata,
@@ -182,7 +217,7 @@ var OpenAiResponses = /** @class */ (function () {
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
-                        usage = new UsageData_1.UsageDataAccumulator({ model: OpenAi_1.DEFAULT_MODEL });
+                        usage = new UsageData_1.UsageDataAccumulator({ model: args.model });
                         toolInvocations = [];
                         tools = this.buildResponseTools(this.functions);
                         _a = this.buildInstructionsAndInput(args.messages), instructions = _a.instructions, input = _a.input;
@@ -191,7 +226,8 @@ var OpenAiResponses = /** @class */ (function () {
                         _b.label = 1;
                     case 1: return [4 /*yield*/, this.createResponseAndMaybeWait({
                             model: args.model,
-                            instructions: previousResponseId ? undefined : instructions,
+                            // Always pass instructions; they are not carried over with previous_response_id.
+                            instructions: instructions,
                             input: nextInput,
                             previousResponseId: previousResponseId,
                             tools: tools,
@@ -201,18 +237,34 @@ var OpenAiResponses = /** @class */ (function () {
                             reasoningEffort: args.reasoningEffort,
                             textFormat: args.textFormat,
                             backgroundMode: args.backgroundMode,
+                            maxBackgroundWaitMs: args.maxBackgroundWaitMs,
                             abortSignal: args.abortSignal,
+                            serviceTier: args.serviceTier,
                         })];
                     case 2:
                         response = _b.sent();
-                        this.addUsageFromResponse(response, usage);
+                        this.addUsageFromResponse(response, usage, { requestedServiceTier: args.serviceTier });
+                        // For structured outputs we should not attempt to parse incomplete/failed/cancelled responses.
+                        // For plain-text generation, we allow "incomplete" to pass through (partial output),
+                        // but still fail on other non-completed statuses.
+                        this.throwIfResponseUnusable(response, {
+                            allowIncomplete: !args.textFormat,
+                            model: args.model,
+                            maxOutputTokens: args.maxTokens,
+                            requestedServiceTier: args.serviceTier,
+                        });
                         functionCalls = this.extractFunctionCalls(response);
                         if (functionCalls.length < 1) {
                             message = this.extractAssistantText(response);
                             if (!message) {
                                 throw new Error("Response was empty");
                             }
-                            return [2 /*return*/, { message: message, usagedata: usage.usageData, toolInvocations: toolInvocations }];
+                            return [2 /*return*/, {
+                                    message: message,
+                                    usagedata: usage.usageData,
+                                    toolInvocations: toolInvocations,
+                                    serviceTier: response.service_tier ? response.service_tier : undefined,
+                                }];
                         }
                         if (toolCallsExecuted + functionCalls.length > args.maxToolCalls) {
                             throw new Error("Max tool calls (".concat(args.maxToolCalls, ") reached. Stopping execution."));
@@ -243,11 +295,215 @@ var OpenAiResponses = /** @class */ (function () {
             });
         });
     };
-    OpenAiResponses.prototype.createResponseAndMaybeWait = function (args) {
+    OpenAiResponses.prototype.throwIfResponseUnusable = function (response, opts) {
+        var _a;
+        var statusRaw = typeof (response === null || response === void 0 ? void 0 : response.status) === 'string' ? String(response.status) : '';
+        var status = statusRaw.toLowerCase();
+        if (!status || status === 'completed') {
+            return;
+        }
+        if (status === 'incomplete' && opts.allowIncomplete) {
+            return;
+        }
+        var id = typeof (response === null || response === void 0 ? void 0 : response.id) === 'string' ? response.id : '';
+        var reason = (_a = response === null || response === void 0 ? void 0 : response.incomplete_details) === null || _a === void 0 ? void 0 : _a.reason;
+        var apiErr = response === null || response === void 0 ? void 0 : response.error;
+        var serviceTier = typeof (response === null || response === void 0 ? void 0 : response.service_tier) === 'string' && response.service_tier.trim() ? response.service_tier.trim() : '';
+        var directOutputText = typeof (response === null || response === void 0 ? void 0 : response.output_text) === 'string' ? response.output_text : '';
+        var assistantText = this.extractAssistantText(response);
+        var outTextLen = directOutputText ? directOutputText.length : 0;
+        var assistantLen = assistantText ? assistantText.length : 0;
+        var usage = response === null || response === void 0 ? void 0 : response.usage;
+        var inputTokens = typeof (usage === null || usage === void 0 ? void 0 : usage.input_tokens) === 'number' ? usage.input_tokens : undefined;
+        var outputTokens = typeof (usage === null || usage === void 0 ? void 0 : usage.output_tokens) === 'number' ? usage.output_tokens : undefined;
+        var totalTokens = typeof (usage === null || usage === void 0 ? void 0 : usage.total_tokens) === 'number'
+            ? usage.total_tokens
+            : typeof inputTokens === 'number' && typeof outputTokens === 'number'
+                ? inputTokens + outputTokens
+                : undefined;
+        var msg = "Responses API returned status=\"".concat(status, "\"");
+        if (id) {
+            msg += " (id=".concat(id, ")");
+        }
+        msg += ".";
+        var details = {
+            response_id: id || undefined,
+            status: status,
+            model: typeof opts.model === 'string' && opts.model.trim() ? opts.model : undefined,
+            max_output_tokens: typeof opts.maxOutputTokens === 'number' ? opts.maxOutputTokens : undefined,
+            requested_service_tier: typeof opts.requestedServiceTier === 'string' && opts.requestedServiceTier.trim()
+                ? opts.requestedServiceTier.trim()
+                : undefined,
+            service_tier: serviceTier || undefined,
+            incomplete_reason: typeof reason === 'string' && reason.trim() ? reason : undefined,
+            api_error: apiErr !== null && apiErr !== void 0 ? apiErr : undefined,
+            usage_input_tokens: inputTokens,
+            usage_output_tokens: outputTokens,
+            usage_total_tokens: totalTokens,
+            output_text_len: outTextLen || undefined,
+            output_text_tail: outTextLen > 0 ? truncateTail(directOutputText, 400) : undefined,
+            assistant_text_len: assistantLen || undefined,
+            assistant_text_tail: assistantLen > 0 ? truncateTail(assistantText, 400) : undefined,
+        };
+        var extra = [];
+        if (details.model) {
+            extra.push("model=".concat(details.model));
+        }
+        if (typeof details.max_output_tokens === 'number') {
+            extra.push("max_output_tokens=".concat(details.max_output_tokens));
+        }
+        if (typeof details.requested_service_tier === 'string') {
+            extra.push("requested_service_tier=".concat(details.requested_service_tier));
+        }
+        if (typeof details.service_tier === 'string') {
+            extra.push("service_tier=".concat(details.service_tier));
+        }
+        if (details.incomplete_reason) {
+            extra.push("reason=".concat(details.incomplete_reason));
+        }
+        if (typeof details.output_text_len === 'number') {
+            extra.push("output_text_len=".concat(details.output_text_len));
+        }
+        if (typeof details.assistant_text_len === 'number') {
+            extra.push("assistant_text_len=".concat(details.assistant_text_len));
+        }
+        if (extra.length > 0) {
+            msg += " ".concat(extra.join(' '), ".");
+        }
+        throw new OpenAiResponsesError({
+            code: 'RESPONSE_STATUS',
+            message: msg,
+            details: details,
+        });
+    };
+    OpenAiResponses.prototype.toOpenAiApiError = function (error, meta) {
+        var status = extractHttpStatus(error);
+        var requestId = extractRequestId(error);
+        var retryable = isRetryableHttpStatus(status);
+        var errMsg = error instanceof Error ? error.message : String(error !== null && error !== void 0 ? error : '');
+        var errName = error instanceof Error ? error.name : undefined;
+        var aborted = meta.aborted === true || isAbortError(error);
+        var msg = "OpenAI ".concat(meta.operation, " failed.");
+        var extra = [];
+        if (aborted) {
+            extra.push("aborted=true");
+        }
+        if (typeof status === 'number') {
+            extra.push("status=".concat(status));
+        }
+        if (requestId) {
+            extra.push("requestId=".concat(requestId));
+        }
+        if (meta.responseId) {
+            extra.push("responseId=".concat(meta.responseId));
+        }
+        if (meta.backgroundMode) {
+            extra.push("background=true");
+        }
+        if (typeof meta.pollAttempt === 'number') {
+            extra.push("pollAttempt=".concat(meta.pollAttempt));
+        }
+        if (typeof meta.waitedMs === 'number') {
+            extra.push("waitedMs=".concat(meta.waitedMs));
+        }
+        if (typeof meta.maxWaitMs === 'number') {
+            extra.push("maxWaitMs=".concat(meta.maxWaitMs));
+        }
+        if (typeof meta.lastStatus === 'string' && meta.lastStatus.trim()) {
+            extra.push("lastStatus=".concat(meta.lastStatus.trim()));
+        }
+        if (typeof meta.model === 'string' && meta.model.trim()) {
+            extra.push("model=".concat(meta.model.trim()));
+        }
+        if (meta.reasoningEffort) {
+            extra.push("reasoningEffort=".concat(meta.reasoningEffort));
+        }
+        if (typeof meta.requestedServiceTier === 'string' && meta.requestedServiceTier.trim()) {
+            extra.push("requested_service_tier=".concat(meta.requestedServiceTier.trim()));
+        }
+        if (typeof meta.serviceTier === 'string' && meta.serviceTier.trim()) {
+            extra.push("service_tier=".concat(meta.serviceTier.trim()));
+        }
+        if (extra.length > 0) {
+            msg += " ".concat(extra.join(' '), ".");
+        }
+        if (errMsg) {
+            msg += " error=".concat(JSON.stringify(errMsg), ".");
+        }
+        var details = {
+            operation: meta.operation,
+            status: typeof status === 'number' ? status : undefined,
+            request_id: requestId,
+            response_id: meta.responseId,
+            previous_response_id: meta.previousResponseId,
+            background: meta.backgroundMode ? true : undefined,
+            poll_attempt: meta.pollAttempt,
+            waited_ms: meta.waitedMs,
+            max_wait_ms: meta.maxWaitMs,
+            last_status: typeof meta.lastStatus === 'string' && meta.lastStatus.trim() ? meta.lastStatus.trim() : undefined,
+            model: typeof meta.model === 'string' && meta.model.trim() ? meta.model.trim() : undefined,
+            reasoning_effort: meta.reasoningEffort,
+            requested_service_tier: typeof meta.requestedServiceTier === 'string' && meta.requestedServiceTier.trim()
+                ? meta.requestedServiceTier.trim()
+                : undefined,
+            service_tier: typeof meta.serviceTier === 'string' && meta.serviceTier.trim() ? meta.serviceTier.trim() : undefined,
+            error_name: errName,
+            aborted: aborted ? true : undefined,
+        };
+        return new OpenAiResponsesError({
+            code: 'OPENAI_API',
+            message: msg,
+            details: details,
+            cause: error,
+            retryable: retryable,
+        });
+    };
+    OpenAiResponses.prototype.resolveMaxBackgroundWaitMs = function (ms) {
+        var n = typeof ms === 'number' && Number.isFinite(ms) && ms > 0 ? Math.floor(ms) : this.defaultMaxBackgroundWaitMs;
+        // Ensure we never return a non-positive number even if misconfigured elsewhere.
+        return n > 0 ? n : exports.DEFAULT_MAX_BACKGROUND_WAIT_MS;
+    };
+    OpenAiResponses.prototype.cancelResponseBestEffort = function (responseId) {
         return __awaiter(this, void 0, void 0, function () {
-            var body, created;
+            var resp, e_1;
             return __generator(this, function (_a) {
                 switch (_a.label) {
+                    case 0:
+                        if (!responseId) {
+                            return [2 /*return*/, { attempted: false }];
+                        }
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.client.responses.cancel(responseId)];
+                    case 2:
+                        resp = _a.sent();
+                        // Docs show cancelled as the post-cancel status.
+                        if ((resp === null || resp === void 0 ? void 0 : resp.status) === 'cancelled') {
+                            return [2 /*return*/, { attempted: true, ok: true }];
+                        }
+                        return [2 /*return*/, {
+                                attempted: true,
+                                ok: false,
+                                error: {
+                                    message: 'Cancel did not return status=cancelled',
+                                    status: resp === null || resp === void 0 ? void 0 : resp.status,
+                                },
+                            }];
+                    case 3:
+                        e_1 = _a.sent();
+                        return [2 /*return*/, { attempted: true, ok: false, error: safeErrorSummary(e_1) }];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    OpenAiResponses.prototype.createResponseAndMaybeWait = function (args) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var body, created, error_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         body = {
                             model: args.model,
@@ -277,52 +533,191 @@ var OpenAiResponses = /** @class */ (function () {
                         if (args.textFormat) {
                             body.text = { format: args.textFormat };
                         }
+                        if (typeof args.serviceTier === 'string' && args.serviceTier.trim()) {
+                            body.service_tier = args.serviceTier.trim();
+                        }
                         if (args.backgroundMode) {
                             body.background = true;
                             body.store = true;
                         }
-                        return [4 /*yield*/, this.client.responses.create(body, args.abortSignal ? { signal: args.abortSignal } : undefined)];
+                        _b.label = 1;
                     case 1:
-                        created = _a.sent();
+                        _b.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.client.responses.create(body, args.abortSignal ? { signal: args.abortSignal } : undefined)];
+                    case 2:
+                        created = _b.sent();
+                        return [3 /*break*/, 4];
+                    case 3:
+                        error_1 = _b.sent();
+                        throw this.toOpenAiApiError(error_1, {
+                            operation: 'responses.create',
+                            model: args.model,
+                            reasoningEffort: args.reasoningEffort,
+                            backgroundMode: args.backgroundMode,
+                            previousResponseId: args.previousResponseId,
+                            aborted: ((_a = args.abortSignal) === null || _a === void 0 ? void 0 : _a.aborted) ? true : undefined,
+                            requestedServiceTier: args.serviceTier,
+                        });
+                    case 4:
                         if (!args.backgroundMode) {
                             return [2 /*return*/, created];
                         }
                         if (!(created === null || created === void 0 ? void 0 : created.id)) {
                             return [2 /*return*/, created];
                         }
-                        return [4 /*yield*/, this.waitForCompletion(created.id, args.abortSignal)];
-                    case 2: return [2 /*return*/, _a.sent()];
+                        return [4 /*yield*/, this.waitForCompletion(created.id, args.abortSignal, {
+                                model: args.model,
+                                reasoningEffort: args.reasoningEffort,
+                                maxWaitMs: this.resolveMaxBackgroundWaitMs(args.maxBackgroundWaitMs),
+                                requestedServiceTier: args.serviceTier,
+                            })];
+                    case 5: return [2 /*return*/, _b.sent()];
                 }
             });
         });
     };
-    OpenAiResponses.prototype.waitForCompletion = function (responseId, abortSignal) {
+    OpenAiResponses.prototype.waitForCompletion = function (responseId, abortSignal, ctx) {
         return __awaiter(this, void 0, void 0, function () {
-            var delayMs, resp, status_1;
+            var maxWaitMs, startedAtMs, delayMs, pollAttempt, lastStatus, cancelAttempted, warnEveryMs, nextWarnAtMs, throwPollingStop, waitedMs, resp, error_2, status_1;
+            var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        delayMs = 500;
+                        this.logger.debug({ message: 'Waiting for completion', obj: { responseId: responseId } });
+                        maxWaitMs = this.resolveMaxBackgroundWaitMs(ctx === null || ctx === void 0 ? void 0 : ctx.maxWaitMs);
+                        startedAtMs = Date.now();
+                        delayMs = 1000;
+                        pollAttempt = 0;
+                        lastStatus = '';
+                        cancelAttempted = false;
+                        warnEveryMs = 10 * 60 * 1000;
+                        nextWarnAtMs = warnEveryMs;
+                        throwPollingStop = function (args) { return __awaiter(_this, void 0, void 0, function () {
+                            var waitedMs, cancel, baseDetails, msg;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0:
+                                        waitedMs = Date.now() - startedAtMs;
+                                        cancel = undefined;
+                                        if (!!cancelAttempted) return [3 /*break*/, 2];
+                                        cancelAttempted = true;
+                                        return [4 /*yield*/, this.cancelResponseBestEffort(responseId)];
+                                    case 1:
+                                        cancel = _a.sent();
+                                        _a.label = 2;
+                                    case 2:
+                                        baseDetails = {
+                                            operation: 'responses.retrieve',
+                                            response_id: responseId,
+                                            background: true,
+                                            poll_attempt: pollAttempt,
+                                            waited_ms: waitedMs,
+                                            max_wait_ms: maxWaitMs,
+                                            last_status: lastStatus || undefined,
+                                            model: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.model) === 'string' && ctx.model.trim() ? ctx.model.trim() : undefined,
+                                            reasoning_effort: ctx === null || ctx === void 0 ? void 0 : ctx.reasoningEffort,
+                                            requested_service_tier: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.requestedServiceTier) === 'string' && ctx.requestedServiceTier.trim()
+                                                ? ctx.requestedServiceTier.trim()
+                                                : undefined,
+                                            aborted: args.kind === 'aborted' ? true : undefined,
+                                            timeout: args.kind === 'timeout' ? true : undefined,
+                                            cancel_attempted: (cancel === null || cancel === void 0 ? void 0 : cancel.attempted) ? true : undefined,
+                                            cancel_ok: cancel && cancel.attempted && 'ok' in cancel ? cancel.ok : undefined,
+                                            cancel_timed_out: cancel && cancel.attempted && cancel.timedOut ? true : undefined,
+                                            cancel_error: cancel && cancel.attempted && cancel.error ? cancel.error : undefined,
+                                        };
+                                        if (args.cause) {
+                                            baseDetails.polling_cause = safeErrorSummary(args.cause);
+                                        }
+                                        msg = args.kind === 'timeout'
+                                            ? "Background response exceeded max wait (maxWaitMs=".concat(maxWaitMs, ") while polling (id=").concat(responseId, ").")
+                                            : "Background polling aborted (id=".concat(responseId, ").");
+                                        throw new OpenAiResponsesError({
+                                            code: 'OPENAI_API',
+                                            message: msg,
+                                            details: baseDetails,
+                                            cause: args.cause,
+                                        });
+                                }
+                            });
+                        }); };
                         _a.label = 1;
                     case 1:
-                        if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
-                            throw new Error("Request aborted");
+                        waitedMs = Date.now() - startedAtMs;
+                        if (!(abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted)) return [3 /*break*/, 3];
+                        return [4 /*yield*/, throwPollingStop({ kind: 'aborted' })];
+                    case 2:
+                        _a.sent();
+                        _a.label = 3;
+                    case 3:
+                        if (!(waitedMs >= maxWaitMs)) return [3 /*break*/, 5];
+                        return [4 /*yield*/, throwPollingStop({ kind: 'timeout' })];
+                    case 4:
+                        _a.sent();
+                        _a.label = 5;
+                    case 5:
+                        // Warn every 10 minutes elapsed (best-effort; may log slightly after the boundary).
+                        if (waitedMs >= nextWarnAtMs) {
+                            nextWarnAtMs += warnEveryMs;
+                            this.logger.warn({
+                                message: "Background polling still in progress",
+                                obj: {
+                                    responseId: responseId,
+                                    status: lastStatus || undefined,
+                                    waitedMs: waitedMs,
+                                    pollAttempt: pollAttempt,
+                                    model: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.model) === 'string' && ctx.model.trim() ? ctx.model.trim() : undefined,
+                                    reasoningEffort: ctx === null || ctx === void 0 ? void 0 : ctx.reasoningEffort,
+                                    serviceTier: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.requestedServiceTier) === 'string' && ctx.requestedServiceTier.trim()
+                                        ? ctx.requestedServiceTier.trim()
+                                        : undefined,
+                                },
+                            });
                         }
+                        pollAttempt += 1;
+                        resp = void 0;
+                        _a.label = 6;
+                    case 6:
+                        _a.trys.push([6, 8, , 11]);
                         return [4 /*yield*/, this.client.responses.retrieve(responseId, undefined, abortSignal ? { signal: abortSignal } : undefined)];
-                    case 2:
+                    case 7:
                         resp = _a.sent();
-                        status_1 = typeof (resp === null || resp === void 0 ? void 0 : resp.status) === 'string' ? String(resp.status).toLowerCase() : '';
-                        if (status_1 === 'completed' || status_1 === 'failed' || status_1 === 'cancelled' || status_1 === 'incomplete') {
+                        return [3 /*break*/, 11];
+                    case 8:
+                        error_2 = _a.sent();
+                        if (!((abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) || isAbortError(error_2))) return [3 /*break*/, 10];
+                        return [4 /*yield*/, throwPollingStop({ kind: 'aborted', cause: error_2 })];
+                    case 9:
+                        _a.sent();
+                        _a.label = 10;
+                    case 10: throw this.toOpenAiApiError(error_2, {
+                        operation: 'responses.retrieve',
+                        model: ctx === null || ctx === void 0 ? void 0 : ctx.model,
+                        reasoningEffort: ctx === null || ctx === void 0 ? void 0 : ctx.reasoningEffort,
+                        backgroundMode: true,
+                        responseId: responseId,
+                        pollAttempt: pollAttempt,
+                        waitedMs: waitedMs,
+                        maxWaitMs: maxWaitMs,
+                        lastStatus: lastStatus,
+                        requestedServiceTier: ctx === null || ctx === void 0 ? void 0 : ctx.requestedServiceTier,
+                    });
+                    case 11:
+                        status_1 = typeof (resp === null || resp === void 0 ? void 0 : resp.status) === 'string' ? resp.status : '';
+                        lastStatus = status_1;
+                        // Terminal states
+                        if (status_1 === 'completed' || status_1 === 'failed' || status_1 === 'incomplete' || status_1 === 'cancelled') {
                             return [2 /*return*/, resp];
                         }
-                        this.logger.debug({ message: "Polling response", obj: { responseId: responseId, status: status_1, delayMs: delayMs } });
-                        return [4 /*yield*/, sleep(delayMs)];
-                    case 3:
+                        this.logger.debug({ message: "Polling response", obj: { responseId: responseId, status: status_1, delayMs: delayMs, pollAttempt: pollAttempt, waitedMs: waitedMs } });
+                        // Sleep but wake early if aborted, so abort latency is low.
+                        return [4 /*yield*/, sleepWithAbort(delayMs, abortSignal)];
+                    case 12:
+                        // Sleep but wake early if aborted, so abort latency is low.
                         _a.sent();
-                        delayMs = Math.min(5000, Math.floor(delayMs * 1.5));
-                        _a.label = 4;
-                    case 4: return [3 /*break*/, 1];
-                    case 5: return [2 /*return*/];
+                        _a.label = 13;
+                    case 13: return [3 /*break*/, 1];
+                    case 14: return [2 /*return*/];
                 }
             });
         });
@@ -407,7 +802,7 @@ var OpenAiResponses = /** @class */ (function () {
     OpenAiResponses.prototype.executeFunctionCall = function (args) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         return __awaiter(this, void 0, void 0, function () {
-            var callId, rawName, shortName, functionToCall, startedAt, parsedArgs, finishedAt, rec, argsObj, returnObject, finishedAt, rec, output, error_1, finishedAt, errMessage, errStack, rec;
+            var callId, rawName, shortName, functionToCall, startedAt, parsedArgs, finishedAt, rec, argsObj, returnObject, finishedAt, rec, output, error_3, finishedAt, errMessage, errStack, rec;
             return __generator(this, function (_m) {
                 switch (_m.label) {
                     case 0:
@@ -483,10 +878,10 @@ var OpenAiResponses = /** @class */ (function () {
                                 output: output,
                             }];
                     case 4:
-                        error_1 = _m.sent();
+                        error_3 = _m.sent();
                         finishedAt = new Date();
-                        errMessage = error_1 instanceof Error ? error_1.message : String(error_1);
-                        errStack = error_1 instanceof Error ? error_1.stack : undefined;
+                        errMessage = error_3 instanceof Error ? error_3.message : String(error_3);
+                        errStack = error_3 instanceof Error ? error_3.stack : undefined;
                         rec = {
                             id: callId,
                             name: functionToCall.definition.name,
@@ -498,7 +893,7 @@ var OpenAiResponses = /** @class */ (function () {
                         };
                         args.toolInvocations.push(rec);
                         (_l = args.onToolInvocation) === null || _l === void 0 ? void 0 : _l.call(args, { type: 'finished', result: rec });
-                        throw error_1;
+                        throw error_3;
                     case 5: return [2 /*return*/];
                 }
             });
@@ -533,41 +928,22 @@ var OpenAiResponses = /** @class */ (function () {
     // -----------------------------------------
     // Usage + text extraction
     // -----------------------------------------
-    OpenAiResponses.prototype.addUsageFromResponse = function (response, usage) {
-        var u = response.usage;
-        if (!u || typeof u !== 'object') {
+    OpenAiResponses.prototype.addUsageFromResponse = function (response, usage, ctx) {
+        var _a;
+        if (!response.usage) {
             return;
         }
-        var rec = u;
-        var input = typeof rec.input_tokens === 'number' ? rec.input_tokens : 0;
-        var output = typeof rec.output_tokens === 'number' ? rec.output_tokens : 0;
-        var total = typeof rec.total_tokens === 'number' ? rec.total_tokens : input + output;
-        var cached = 0;
-        var reasoning = 0;
-        var inputDetails = rec.input_tokens_details;
-        if (inputDetails && typeof inputDetails === 'object') {
-            var id = inputDetails;
-            cached = typeof id.cached_tokens === 'number' ? id.cached_tokens : 0;
-        }
-        var outputDetails = rec.output_tokens_details;
-        if (outputDetails && typeof outputDetails === 'object') {
-            var od = outputDetails;
-            reasoning = typeof od.reasoning_tokens === 'number' ? od.reasoning_tokens : 0;
-        }
         usage.addTokenUsage({
-            promptTokens: input,
-            cachedPromptTokens: cached,
-            completionTokens: output,
-            reasoningTokens: reasoning,
-            totalTokens: total,
-        });
+            inputTokens: response.usage.input_tokens,
+            cachedInputTokens: response.usage.input_tokens_details.cached_tokens,
+            outputTokens: response.usage.output_tokens,
+            reasoningTokens: response.usage.output_tokens_details.reasoning_tokens,
+            totalTokens: response.usage.total_tokens,
+        }, { serviceTier: (_a = response.service_tier) !== null && _a !== void 0 ? _a : ctx === null || ctx === void 0 ? void 0 : ctx.requestedServiceTier });
     };
     OpenAiResponses.prototype.extractAssistantText = function (response) {
-        var direct = typeof response.output_text === 'string' ? response.output_text.trim() : '';
-        if (direct) {
-            return direct;
-        }
         var out = Array.isArray(response.output) ? response.output : [];
+        var lastJoined = '';
         for (var _i = 0, out_2 = out; _i < out_2.length; _i++) {
             var item = out_2[_i];
             if (!item || typeof item !== 'object') {
@@ -601,9 +977,16 @@ var OpenAiResponses = /** @class */ (function () {
             }
             var joined = pieces.join('\n').trim();
             if (joined) {
-                return joined;
+                lastJoined = joined;
             }
         }
+        if (lastJoined) {
+            return lastJoined;
+        }
+        var direct = typeof response.output_text === 'string' ? response.output_text.trim() : '';
+        if (direct) {
+            return direct;
+        }
         return '';
     };
     // -----------------------------------------
@@ -623,8 +1006,8 @@ var OpenAiResponses = /** @class */ (function () {
             schema: this.strictifyJsonSchema(schema),
         };
     };
-    OpenAiResponses.prototype.parseAndValidateStructuredOutput = function (text, schema) {
-        var parsed = this.parseJson(text);
+    OpenAiResponses.prototype.parseAndValidateStructuredOutput = function (text, schema, ctx) {
+        var parsed = this.parseJson(text, ctx);
         if (this.isZodSchema(schema)) {
             var res = schema.safeParse(parsed);
             if (!(res === null || res === void 0 ? void 0 : res.success)) {
@@ -640,7 +1023,8 @@ var OpenAiResponses = /** @class */ (function () {
         }
         return typeof schema.safeParse === 'function';
     };
-    OpenAiResponses.prototype.parseJson = function (text) {
+    OpenAiResponses.prototype.parseJson = function (text, ctx) {
+        var _a;
         var cleaned = String(text !== null && text !== void 0 ? text : '')
             .trim()
             .replace(/^```(?:json)?/i, '')
@@ -649,7 +1033,8 @@ var OpenAiResponses = /** @class */ (function () {
         try {
             return JSON.parse(cleaned);
         }
-        catch (_a) {
+        catch (err1) {
+            var firstErrMsg = err1 instanceof Error ? err1.message : String(err1);
             var s = cleaned;
             var firstObj = s.indexOf('{');
             var firstArr = s.indexOf('[');
@@ -658,9 +1043,77 @@ var OpenAiResponses = /** @class */ (function () {
             var lastArr = s.lastIndexOf(']');
             var end = Math.max(lastObj, lastArr);
             if (start >= 0 && end > start) {
-                return JSON.parse(s.slice(start, end + 1));
+                var candidate = s.slice(start, end + 1);
+                try {
+                    return JSON.parse(candidate);
+                }
+                catch (err2) {
+                    var secondErrMsg = err2 instanceof Error ? err2.message : String(err2);
+                    var pos2rel = extractJsonParsePosition(secondErrMsg);
+                    var pos2 = typeof pos2rel === 'number' ? start + pos2rel : undefined;
+                    var pos1 = extractJsonParsePosition(firstErrMsg);
+                    var pos_1 = typeof pos2 === 'number' ? pos2 : pos1;
+                    var lc_1 = (_a = extractJsonParseLineCol(secondErrMsg)) !== null && _a !== void 0 ? _a : extractJsonParseLineCol(firstErrMsg);
+                    var details_1 = {
+                        model: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.model) === 'string' && ctx.model.trim() ? ctx.model : undefined,
+                        max_output_tokens: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.maxOutputTokens) === 'number' ? ctx.maxOutputTokens : undefined,
+                        requested_service_tier: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.requestedServiceTier) === 'string' && String(ctx.requestedServiceTier).trim()
+                            ? String(ctx.requestedServiceTier).trim()
+                            : undefined,
+                        service_tier: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.serviceTier) === 'string' && ctx.serviceTier.trim() ? ctx.serviceTier.trim() : undefined,
+                        cleaned_len: s.length,
+                        cleaned_head: truncateHead(s, 250),
+                        cleaned_tail: truncateTail(s, 500),
+                        json_start: start,
+                        json_end: end,
+                        json_candidate_len: candidate.length,
+                        first_error: firstErrMsg,
+                        second_error: secondErrMsg,
+                        error_pos: typeof pos_1 === 'number' ? pos_1 : undefined,
+                        error_line: lc_1 === null || lc_1 === void 0 ? void 0 : lc_1.line,
+                        error_column: lc_1 === null || lc_1 === void 0 ? void 0 : lc_1.column,
+                        error_context: typeof pos_1 === 'number' ? snippetAround(s, pos_1, 160) : undefined,
+                    };
+                    var msg_1 = "Failed to parse model output as JSON. " +
+                        "cleaned_len=".concat(s.length, " json_start=").concat(start, " json_end=").concat(end, ". ") +
+                        "first_error=".concat(JSON.stringify(firstErrMsg), " second_error=").concat(JSON.stringify(secondErrMsg), ".");
+                    throw new OpenAiResponsesError({
+                        code: 'JSON_PARSE',
+                        message: msg_1,
+                        details: details_1,
+                        cause: err2,
+                    });
+                }
             }
-            throw new Error("Failed to parse model output as JSON");
+            var pos = extractJsonParsePosition(firstErrMsg);
+            var lc = extractJsonParseLineCol(firstErrMsg);
+            var details = {
+                model: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.model) === 'string' && ctx.model.trim() ? ctx.model : undefined,
+                max_output_tokens: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.maxOutputTokens) === 'number' ? ctx.maxOutputTokens : undefined,
+                requested_service_tier: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.requestedServiceTier) === 'string' && String(ctx.requestedServiceTier).trim()
+                    ? String(ctx.requestedServiceTier).trim()
+                    : undefined,
+                service_tier: typeof (ctx === null || ctx === void 0 ? void 0 : ctx.serviceTier) === 'string' && ctx.serviceTier.trim() ? ctx.serviceTier.trim() : undefined,
+                cleaned_len: s.length,
+                cleaned_head: truncateHead(s, 250),
+                cleaned_tail: truncateTail(s, 500),
+                json_start: start >= 0 ? start : undefined,
+                json_end: end >= 0 ? end : undefined,
+                first_error: firstErrMsg,
+                error_pos: typeof pos === 'number' ? pos : undefined,
+                error_line: lc === null || lc === void 0 ? void 0 : lc.line,
+                error_column: lc === null || lc === void 0 ? void 0 : lc.column,
+                error_context: typeof pos === 'number' ? snippetAround(s, pos, 160) : undefined,
+            };
+            var msg = "Failed to parse model output as JSON. " +
+                "cleaned_len=".concat(s.length, ". ") +
+                "error=".concat(JSON.stringify(firstErrMsg), ".");
+            throw new OpenAiResponsesError({
+                code: 'JSON_PARSE',
+                message: msg,
+                details: details,
+                cause: err1,
+            });
         }
     };
     /**
@@ -798,7 +1251,7 @@ var OpenAiResponses = /** @class */ (function () {
     };
     OpenAiResponses.prototype.ensureModulesProcessed = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var error_2;
+            var error_4;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -818,9 +1271,9 @@ var OpenAiResponses = /** @class */ (function () {
                         this.modulesProcessed = true;
                         return [3 /*break*/, 4];
                     case 3:
-                        error_2 = _a.sent();
+                        error_4 = _a.sent();
                         this.processingModulesPromise = null;
-                        throw error_2;
+                        throw error_4;
                     case 4: return [2 /*return*/];
                 }
             });
@@ -909,8 +1362,7 @@ var OpenAiResponses = /** @class */ (function () {
     // Model/background defaults
     // -----------------------------------------
     OpenAiResponses.prototype.resolveModel = function (model) {
-        var m = (model !== null && model !== void 0 ? model : this.defaultModel).trim();
-        return m.length > 0 ? m : exports.DEFAULT_RESPONSES_MODEL;
+        return model !== null && model !== void 0 ? model : this.defaultModel;
     };
     OpenAiResponses.prototype.resolveBackgroundMode = function (args) {
         if (typeof args.requested === 'boolean') {
@@ -935,7 +1387,235 @@ var OpenAiResponses = /** @class */ (function () {
     return OpenAiResponses;
 }());
 exports.OpenAiResponses = OpenAiResponses;
+var OpenAiResponsesError = /** @class */ (function (_super) {
+    __extends(OpenAiResponsesError, _super);
+    function OpenAiResponsesError(args) {
+        var _newTarget = this.constructor;
+        var _a;
+        var _this = _super.call(this, args.message) || this;
+        _this.name = 'OpenAiResponsesError';
+        _this.code = args.code;
+        _this.details = (_a = args.details) !== null && _a !== void 0 ? _a : {};
+        _this.cause = args.cause;
+        _this.retryable = typeof args.retryable === 'boolean' ? args.retryable : true;
+        Object.setPrototypeOf(_this, _newTarget.prototype);
+        return _this;
+    }
+    return OpenAiResponsesError;
+}(Error));
+exports.OpenAiResponsesError = OpenAiResponsesError;
+function truncateHead(text, max) {
+    var s = String(text !== null && text !== void 0 ? text : '');
+    if (max <= 0) {
+        return '';
+    }
+    if (s.length <= max) {
+        return s;
+    }
+    return s.slice(0, max) + '...';
+}
+function truncateTail(text, max) {
+    var s = String(text !== null && text !== void 0 ? text : '');
+    if (max <= 0) {
+        return '';
+    }
+    if (s.length <= max) {
+        return s;
+    }
+    return '...' + s.slice(s.length - max);
+}
+function extractJsonParsePosition(errMsg) {
+    var m = String(errMsg !== null && errMsg !== void 0 ? errMsg : '').match(/at position\s+(\d+)/i);
+    if (!m) {
+        return undefined;
+    }
+    var n = Number(m[1]);
+    return Number.isFinite(n) ? n : undefined;
+}
+function extractJsonParseLineCol(errMsg) {
+    var m = String(errMsg !== null && errMsg !== void 0 ? errMsg : '').match(/line\s+(\d+)\s+column\s+(\d+)/i);
+    if (!m) {
+        return undefined;
+    }
+    var line = Number(m[1]);
+    var column = Number(m[2]);
+    return {
+        line: Number.isFinite(line) ? line : undefined,
+        column: Number.isFinite(column) ? column : undefined,
+    };
+}
+function snippetAround(text, pos, radius) {
+    var s = String(text !== null && text !== void 0 ? text : '');
+    var p = Math.max(0, Math.min(s.length, Number.isFinite(pos) ? pos : 0));
+    var r = Math.max(0, radius);
+    var start = Math.max(0, p - r);
+    var end = Math.min(s.length, p + r);
+    var before = s.slice(start, p);
+    var after = s.slice(p, end);
+    var left = start > 0 ? '...' : '';
+    var right = end < s.length ? '...' : '';
+    return "".concat(left).concat(before, "<<HERE>>").concat(after).concat(right);
+}
 function sleep(ms) {
     return new Promise(function (resolve) { return setTimeout(resolve, ms); });
 }
+/**
+ * Sleep, but wake early if the signal is aborted.
+ * (We do not throw here; the caller should check `signal.aborted` and act.)
+ */
+function sleepWithAbort(ms, signal) {
+    if (!signal) {
+        return sleep(ms);
+    }
+    if (signal.aborted) {
+        return Promise.resolve();
+    }
+    return new Promise(function (resolve) {
+        var _a;
+        var t = setTimeout(function () {
+            cleanup();
+            resolve();
+        }, ms);
+        var onAbort = function () {
+            cleanup();
+            resolve();
+        };
+        var cleanup = function () {
+            var _a;
+            try {
+                clearTimeout(t);
+            }
+            catch (_b) {
+                // ignore
+            }
+            try {
+                (_a = signal.removeEventListener) === null || _a === void 0 ? void 0 : _a.call(signal, 'abort', onAbort);
+            }
+            catch (_c) {
+                // ignore
+            }
+        };
+        try {
+            (_a = signal.addEventListener) === null || _a === void 0 ? void 0 : _a.call(signal, 'abort', onAbort, { once: true });
+        }
+        catch (_b) {
+            // If addEventListener isn't available, fall back to plain sleep.
+        }
+    });
+}
+function extractHttpStatus(error) {
+    if (!error || typeof error !== 'object') {
+        return undefined;
+    }
+    var rec = error;
+    var status = rec.status;
+    if (typeof status === 'number' && Number.isFinite(status)) {
+        return status;
+    }
+    var statusCode = rec.statusCode;
+    if (typeof statusCode === 'number' && Number.isFinite(statusCode)) {
+        return statusCode;
+    }
+    return undefined;
+}
+function extractRequestId(error) {
+    var _a;
+    if (!error || typeof error !== 'object') {
+        return undefined;
+    }
+    var rec = error;
+    var direct = (_a = rec.request_id) !== null && _a !== void 0 ? _a : rec.requestId;
+    if (typeof direct === 'string' && direct.trim()) {
+        return direct.trim();
+    }
+    var headers = rec.headers;
+    if (!headers) {
+        return undefined;
+    }
+    if (typeof headers.get === 'function') {
+        var v = headers.get('x-request-id');
+        return typeof v === 'string' && v.trim() ? v.trim() : undefined;
+    }
+    if (typeof headers === 'object' && !Array.isArray(headers)) {
+        for (var _i = 0, _b = Object.keys(headers); _i < _b.length; _i++) {
+            var k = _b[_i];
+            if (String(k).toLowerCase() !== 'x-request-id') {
+                continue;
+            }
+            var v = headers[k];
+            return typeof v === 'string' && v.trim() ? v.trim() : undefined;
+        }
+    }
+    return undefined;
+}
+function isRetryableHttpStatus(status) {
+    if (typeof status !== 'number') {
+        return true;
+    }
+    if (status === 408 || status === 409 || status === 429) {
+        return true;
+    }
+    if (status >= 500) {
+        return true;
+    }
+    return false;
+}
+function isAbortError(error) {
+    var _a, _b;
+    if (!error) {
+        return false;
+    }
+    // Most fetch implementations:
+    //  - error.name === 'AbortError'
+    //  - or error.code === 'ABORT_ERR'
+    if (error instanceof Error) {
+        var name_3 = String((_a = error.name) !== null && _a !== void 0 ? _a : '').toLowerCase();
+        if (name_3 === 'aborterror') {
+            return true;
+        }
+        var msg = String((_b = error.message) !== null && _b !== void 0 ? _b : '').toLowerCase();
+        // Keep this conservative; don't treat every "abort" substring as abort.
+        if (msg === 'aborted' || msg === 'request aborted') {
+            return true;
+        }
+    }
+    if (typeof error === 'object') {
+        var rec = error;
+        var code = rec.code;
+        if (typeof code === 'string' && code.toUpperCase() === 'ABORT_ERR') {
+            return true;
+        }
+    }
+    return false;
+}
+function safeErrorSummary(error) {
+    if (!error) {
+        return { message: 'Unknown error' };
+    }
+    var status = extractHttpStatus(error);
+    var requestId = extractRequestId(error);
+    if (error instanceof OpenAiResponsesError) {
+        return {
+            name: error.name,
+            message: error.message,
+            code: error.code,
+            details: error.details,
+            status: typeof status === 'number' ? status : undefined,
+            request_id: requestId,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            status: typeof status === 'number' ? status : undefined,
+            request_id: requestId,
+        };
+    }
+    return {
+        message: String(error),
+        status: typeof status === 'number' ? status : undefined,
+        request_id: requestId,
+    };
+}
 //# sourceMappingURL=OpenAiResponses.js.map