@dexto/core 1.8.3 → 1.8.4

package/dist/llm/executor/provider-error.js

@@ -0,0 +1,190 @@
+import "../../chunk-C6A6W6XS.js";
+import { APICallError } from "ai";
+import { DextoRuntimeError } from "../../errors/DextoRuntimeError.js";
+import { ErrorScope, ErrorType } from "../../errors/types.js";
+import { LLMErrorCode } from "../error-codes.js";
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseJsonObject(value) {
+  if (isRecord(value)) return value;
+  if (typeof value !== "string") return null;
+  try {
+    const parsed = JSON.parse(value);
+    return isRecord(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function readStringOrNumber(value) {
+  return typeof value === "string" || typeof value === "number" ? value : void 0;
+}
+function readString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function readRetryAfter(headers) {
+  const retryAfter = headers?.["retry-after"];
+  if (retryAfter === void 0) return void 0;
+  const value = Number(retryAfter);
+  return Number.isFinite(value) ? value : void 0;
+}
+function stringifyBody(value) {
+  if (typeof value === "string") return value;
+  if (value === void 0 || value === null) return void 0;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function readErrorEnvelope(body) {
+  const error = body?.error;
+  return isRecord(error) ? error : null;
+}
+function addOpenRouterDetails(details, responseBody) {
+  const body = parseJsonObject(responseBody);
+  const errorEnvelope = readErrorEnvelope(body);
+  if (errorEnvelope === null) return;
+  const code = readStringOrNumber(errorEnvelope.code);
+  if (code !== void 0) details.openRouterErrorCode = code;
+  const message = readString(errorEnvelope.message);
+  if (message !== void 0) details.openRouterErrorMessage = message;
+  const metadata = isRecord(errorEnvelope.metadata) ? errorEnvelope.metadata : null;
+  if (metadata === null) return;
+  const providerName = readString(metadata.provider_name);
+  if (providerName !== void 0) details.openRouterProviderName = providerName;
+  if (Reflect.has(metadata, "raw")) {
+    details.openRouterProviderRaw = metadata.raw;
+  }
+  const rawObject = parseJsonObject(metadata.raw);
+  const rawError = readErrorEnvelope(rawObject);
+  const rawMessage = readString(rawError?.message);
+  if (rawMessage !== void 0) details.openRouterProviderRawMessage = rawMessage;
+  const rawParam = readString(rawError?.param);
+  if (rawParam !== void 0) details.openRouterProviderRawParam = rawParam;
+  const rawCode = readStringOrNumber(rawError?.code);
+  if (rawCode !== void 0) details.openRouterProviderRawCode = rawCode;
+  const previousErrors = metadata.previous_errors;
+  if (Array.isArray(previousErrors)) {
+    details.openRouterPreviousErrorCount = previousErrors.length;
+  }
+}
+function providerMessage(details, fallback) {
+  return details.openRouterProviderRawMessage ?? details.openRouterErrorMessage ?? details.responseBody ?? fallback;
+}
+function messageFromUnknown(value) {
+  return value instanceof Error ? value.message : String(value);
+}
+function isInvalidSchemaMessage(message) {
+  return message.includes("Invalid schema for function") || message.includes("invalid_function_parameters") || message.includes("schema must have type");
+}
+function readNumericField(value, field) {
+  if (!isRecord(value)) return void 0;
+  const fieldValue = value[field];
+  return typeof fieldValue === "number" && Number.isFinite(fieldValue) ? fieldValue : void 0;
+}
+function extractBalance(value) {
+  if (!isRecord(value)) return void 0;
+  const direct = readNumericField(value, "balance") ?? readNumericField(value, "balanceUsd") ?? readNumericField(value, "creditsUsd");
+  if (direct !== void 0) return direct;
+  for (const nested of Object.values(value)) {
+    const balance = extractBalance(nested);
+    if (balance !== void 0) return balance;
+  }
+  return void 0;
+}
+function errorTypeForStatus(status) {
+  if (status === 402) return ErrorType.PAYMENT_REQUIRED;
+  if (status === 403) return ErrorType.FORBIDDEN;
+  if (status === 408) return ErrorType.TIMEOUT;
+  if (status === 429) return ErrorType.RATE_LIMIT;
+  if (status !== void 0 && status >= 400 && status < 500) return ErrorType.USER;
+  return ErrorType.THIRD_PARTY;
+}
+function errorCodeForStatus(status, details) {
+  if (status === 402) return LLMErrorCode.INSUFFICIENT_CREDITS;
+  if (status === 429) return LLMErrorCode.RATE_LIMIT_EXCEEDED;
+  if (status === 400 && (details.openRouterProviderRawCode === "invalid_function_parameters" || isInvalidSchemaMessage(providerMessage(details, "")))) {
+    return LLMErrorCode.REQUEST_INVALID_SCHEMA;
+  }
+  return LLMErrorCode.GENERATION_FAILED;
+}
+function buildContext(input, details) {
+  return {
+    ...input.sessionId === void 0 ? {} : { sessionId: input.sessionId },
+    provider: input.provider,
+    model: input.model,
+    ...details
+  };
+}
+function extractProviderErrorDetails(input) {
+  const details = {
+    provider: input.provider,
+    model: input.model
+  };
+  if (!APICallError.isInstance?.(input.error)) return details;
+  const responseHeaders = input.error.responseHeaders || {};
+  const responseBody = stringifyBody(input.error.responseBody);
+  if (input.error.statusCode !== void 0) details.statusCode = input.error.statusCode;
+  const retryAfter = readRetryAfter(responseHeaders);
+  if (retryAfter !== void 0) details.retryAfter = retryAfter;
+  if (responseBody !== void 0) details.responseBody = responseBody;
+  if (input.error.url !== void 0) details.url = input.error.url;
+  details.isRetryable = input.error.isRetryable;
+  if (responseBody !== void 0) {
+    addOpenRouterDetails(details, responseBody);
+  }
+  return details;
+}
+function mapProviderError(input) {
+  if (input.error instanceof DextoRuntimeError) return input.error;
+  if (!APICallError.isInstance?.(input.error)) {
+    const message2 = messageFromUnknown(input.error);
+    if (isInvalidSchemaMessage(message2)) {
+      return new DextoRuntimeError(
+        LLMErrorCode.REQUEST_INVALID_SCHEMA,
+        ErrorScope.LLM,
+        ErrorType.USER,
+        message2,
+        buildContext(input, extractProviderErrorDetails(input))
+      );
+    }
+    return new DextoRuntimeError(
+      LLMErrorCode.GENERATION_FAILED,
+      ErrorScope.LLM,
+      ErrorType.THIRD_PARTY,
+      message2,
+      buildContext(input, extractProviderErrorDetails(input))
+    );
+  }
+  const details = extractProviderErrorDetails(input);
+  const status = input.error.statusCode;
+  const message = providerMessage(details, input.error.message);
+  const code = errorCodeForStatus(status, details);
+  const type = errorTypeForStatus(status);
+  if (status === 402) {
+    const balance = extractBalance(parseJsonObject(details.responseBody));
+    return new DextoRuntimeError(
+      code,
+      ErrorScope.LLM,
+      type,
+      `Insufficient Dexto credits. Balance: ${balance === void 0 ? "low" : `$${balance.toFixed(2)}`}`,
+      {
+        ...buildContext(input, details),
+        ...balance === void 0 ? {} : { balance }
+      },
+      "Run `dexto billing` to check your balance"
+    );
+  }
+  return new DextoRuntimeError(
+    code,
+    ErrorScope.LLM,
+    type,
+    status === void 0 ? message : `Provider error ${status}: ${message}`,
+    buildContext(input, details)
+  );
+}
+export {
+  extractProviderErrorDetails,
+  mapProviderError
+};

package/dist/llm/executor/stream-processor.cjs

@@ -23,6 +23,7 @@ __export(stream_processor_exports, {
 module.exports = __toCommonJS(stream_processor_exports);
 var import_types2 = require("../../logger/v2/types.js");
 var import_usage_metadata = require("../usage-metadata.js");
+var import_provider_error = require("./provider-error.js");
 function finiteUsageCount(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -34,13 +35,16 @@ class StreamProcessor {
    * @param config Provider/model configuration
    * @param logger Logger instance
    * @param streaming If true, emits llm:chunk events. Default true.
+   * @param emitFatalErrors If true, emits terminal llm:error events. TurnExecutor owns
+   * terminal run errors and disables this to avoid duplicate events.
    */
-  constructor(contextManager, eventBus, abortSignal, config, logger, streaming = true) {
+  constructor(contextManager, eventBus, abortSignal, config, logger, streaming = true, emitFatalErrors = true) {
     this.contextManager = contextManager;
     this.eventBus = eventBus;
     this.abortSignal = abortSignal;
     this.config = config;
     this.streaming = streaming;
+    this.emitFatalErrors = emitFatalErrors;
     this.logger = logger.createChild(import_types2.DextoLogComponent.EXECUTOR);
     this.usageScopeId = config.usageScopeId;
   }
@@ -267,9 +271,13 @@ class StreamProcessor {
             break;
           }
           case "error": {
-            const err = event.error instanceof Error ? event.error : new Error(String(event.error));
+            const err = (0, import_provider_error.mapProviderError)({
+              error: event.error,
+              provider: this.config.provider,
+              model: this.config.model
+            });
             await this.persistFailedToolResults(err.message);
-            throw err;
+            throw event.error;
           }
           case "abort": {
             this.logger.debug("Stream aborted, emitting partial response");
@@ -325,8 +333,29 @@ class StreamProcessor {
           toolCalls: this.modelToolCalls
         };
       }
-      this.logger.error("Stream processing failed", { error });
-      throw error;
+      const mappedError = (0, import_provider_error.mapProviderError)({
+        error,
+        provider: this.config.provider,
+        model: this.config.model
+      });
+      if (!this.emitFatalErrors) {
+        this.logger.error("Stream processing failed", { error: mappedError });
+        throw error;
+      }
+      if (this.emitFatalErrors) {
+        this.eventBus.emit("llm:error", {
+          error: mappedError,
+          context: "StreamProcessor",
+          recoverable: false,
+          details: (0, import_provider_error.extractProviderErrorDetails)({
+            error,
+            provider: this.config.provider,
+            model: this.config.model
+          })
+        });
+      }
+      this.logger.error("Stream processing failed", { error: mappedError });
+      throw mappedError;
     }
     return {
       text: this.accumulatedText,

package/dist/llm/executor/stream-processor.d.ts

@@ -21,6 +21,7 @@ export declare class StreamProcessor {
     private abortSignal;
     private config;
     private streaming;
+    private emitFatalErrors;
     private assistantMessageId;
     private actualTokens;
     private finishReason;
@@ -44,8 +45,10 @@ export declare class StreamProcessor {
      * @param config Provider/model configuration
      * @param logger Logger instance
      * @param streaming If true, emits llm:chunk events. Default true.
+     * @param emitFatalErrors If true, emits terminal llm:error events. TurnExecutor owns
+     * terminal run errors and disables this to avoid duplicate events.
      */
-    constructor(contextManager: ContextManager, eventBus: SessionEventBus, abortSignal: AbortSignal, config: StreamProcessorConfig, logger: Logger, streaming?: boolean);
+    constructor(contextManager: ContextManager, eventBus: SessionEventBus, abortSignal: AbortSignal, config: StreamProcessorConfig, logger: Logger, streaming?: boolean, emitFatalErrors?: boolean);
     process(streamFn: () => StreamTextResult<VercelToolSet, unknown>): Promise<StreamProcessorResult>;
     private getCacheTokensFromProviderMetadata;
     private normalizeUsage;

package/dist/llm/executor/stream-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-processor.d.ts","sourceRoot":"","sources":["../../../src/llm/executor/stream-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAKvD,OAAO,KAAK,EAAE,WAAW,EAAoB,gBAAgB,EAAc,MAAM,YAAY,CAAC;AAgD9F,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gFAAgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,eAAe;IA2BpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,SAAS;IA/BrB,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,YAAY,CAAmE;IACvF,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,cAAc,CAAuB;IAC7C;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,gBAAgB,CAAkE;IAE1F;;;;;;;OAOG;gBAES,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,qBAAqB,EACrC,MAAM,EAAE,MAAM,EACN,SAAS,GAAE,OAAc;IAM/B,OAAO,CACT,QAAQ,EAAE,MAAM,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACzD,OAAO,CAAC,qBAAqB,CAAC;IAiYjC,OAAO,CAAC,kCAAkC;IAoB1C,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,eAAe;YA8BT,gCAAgC;IA0B9C,OAAO,CAAC,sBAAsB;YAwChB,sBAAsB;YAKtB,gBAAgB;IAO9B;;;;OAIG;YACW,2BAA2B;IAQzC;;OAEG;YACW,wBAAwB;YAQxB,yBAAyB;CAuC1C"}
+{"version":3,"file":"stream-processor.d.ts","sourceRoot":"","sources":["../../../src/llm/executor/stream-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAKvD,OAAO,KAAK,EAAE,WAAW,EAAoB,gBAAgB,EAAc,MAAM,YAAY,CAAC;AAiD9F,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gFAAgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,eAAe;IA6BpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,eAAe;IAlC3B,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,YAAY,CAAmE;IACvF,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,cAAc,CAAuB;IAC7C;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,gBAAgB,CAAkE;IAE1F;;;;;;;;;OASG;gBAES,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,qBAAqB,EACrC,MAAM,EAAE,MAAM,EACN,SAAS,GAAE,OAAc,EACzB,eAAe,GAAE,OAAc;IAMrC,OAAO,CACT,QAAQ,EAAE,MAAM,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACzD,OAAO,CAAC,qBAAqB,CAAC;IAwZjC,OAAO,CAAC,kCAAkC;IAoB1C,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,eAAe;YA8BT,gCAAgC;IA0B9C,OAAO,CAAC,sBAAsB;YAwChB,sBAAsB;YAKtB,gBAAgB;IAO9B;;;;OAIG;YACW,2BAA2B;IAQzC;;OAEG;YACW,wBAAwB;YAQxB,yBAAyB;CAuC1C"}

package/dist/llm/executor/stream-processor.js

@@ -1,6 +1,7 @@
 import "../../chunk-C6A6W6XS.js";
 import { DextoLogComponent } from "../../logger/v2/types.js";
 import { getUsagePricingMetadata } from "../usage-metadata.js";
+import { extractProviderErrorDetails, mapProviderError } from "./provider-error.js";
 function finiteUsageCount(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -12,13 +13,16 @@ class StreamProcessor {
    * @param config Provider/model configuration
    * @param logger Logger instance
    * @param streaming If true, emits llm:chunk events. Default true.
+   * @param emitFatalErrors If true, emits terminal llm:error events. TurnExecutor owns
+   * terminal run errors and disables this to avoid duplicate events.
    */
-  constructor(contextManager, eventBus, abortSignal, config, logger, streaming = true) {
+  constructor(contextManager, eventBus, abortSignal, config, logger, streaming = true, emitFatalErrors = true) {
     this.contextManager = contextManager;
     this.eventBus = eventBus;
     this.abortSignal = abortSignal;
     this.config = config;
     this.streaming = streaming;
+    this.emitFatalErrors = emitFatalErrors;
     this.logger = logger.createChild(DextoLogComponent.EXECUTOR);
     this.usageScopeId = config.usageScopeId;
   }
@@ -245,9 +249,13 @@ class StreamProcessor {
             break;
           }
           case "error": {
-            const err = event.error instanceof Error ? event.error : new Error(String(event.error));
+            const err = mapProviderError({
+              error: event.error,
+              provider: this.config.provider,
+              model: this.config.model
+            });
             await this.persistFailedToolResults(err.message);
-            throw err;
+            throw event.error;
           }
           case "abort": {
             this.logger.debug("Stream aborted, emitting partial response");
@@ -303,8 +311,29 @@ class StreamProcessor {
           toolCalls: this.modelToolCalls
         };
       }
-      this.logger.error("Stream processing failed", { error });
-      throw error;
+      const mappedError = mapProviderError({
+        error,
+        provider: this.config.provider,
+        model: this.config.model
+      });
+      if (!this.emitFatalErrors) {
+        this.logger.error("Stream processing failed", { error: mappedError });
+        throw error;
+      }
+      if (this.emitFatalErrors) {
+        this.eventBus.emit("llm:error", {
+          error: mappedError,
+          context: "StreamProcessor",
+          recoverable: false,
+          details: extractProviderErrorDetails({
+            error,
+            provider: this.config.provider,
+            model: this.config.model
+          })
+        });
+      }
+      this.logger.error("Stream processing failed", { error: mappedError });
+      throw mappedError;
     }
     return {
       text: this.accumulatedText,