@prestyj/ai 5.29.1 → 5.30.0

package/dist/index.d.cts

@@ -506,6 +506,14 @@ declare function formatError(err: unknown): FormattedError;
  */
 declare function formatErrorForDisplay(err: unknown): string;
 
+/** Display meaning is separate from retry policy: a hard stop is not always a plan limit. */
+type ChatErrorReason = "usage_limit" | "billing" | "quota" | "rate_limit" | "model_access" | "auth" | "network" | "capability" | "context" | "update" | "provider" | "unknown";
+interface FormattedChatError extends FormattedError {
+    reason: ChatErrorReason;
+}
+/** Compact, factual desktop copy. Raw provider detail never becomes an executable action. */
+declare function formatChatError(error: unknown): FormattedChatError;
+
 /**
  * Inspect a raw provider error message and tag it with a clearer, actionable
  * prefix so a worker orchestrator can route on intent instead of regexing JSON.
@@ -787,4 +795,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type PreparedContext, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, TOOL_CALL_NAME_RULES, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolCallNameRule, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, clampProviderContextImages, classifyProviderError, dropInvalidToolCalls, environmentSecrets, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, isValidToolCallName, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, resolveToolSchema, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText, toolCallNameRuleFor, usesResponsesLite };
+export { type AssistantMessage, type CacheRetention, type ChatErrorReason, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedChatError, type FormattedError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type PreparedContext, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, TOOL_CALL_NAME_RULES, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolCallNameRule, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, clampProviderContextImages, classifyProviderError, dropInvalidToolCalls, environmentSecrets, formatChatError, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, isValidToolCallName, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, resolveToolSchema, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText, toolCallNameRuleFor, usesResponsesLite };

package/dist/index.d.ts

@@ -506,6 +506,14 @@ declare function formatError(err: unknown): FormattedError;
  */
 declare function formatErrorForDisplay(err: unknown): string;
 
+/** Display meaning is separate from retry policy: a hard stop is not always a plan limit. */
+type ChatErrorReason = "usage_limit" | "billing" | "quota" | "rate_limit" | "model_access" | "auth" | "network" | "capability" | "context" | "update" | "provider" | "unknown";
+interface FormattedChatError extends FormattedError {
+    reason: ChatErrorReason;
+}
+/** Compact, factual desktop copy. Raw provider detail never becomes an executable action. */
+declare function formatChatError(error: unknown): FormattedChatError;
+
 /**
  * Inspect a raw provider error message and tag it with a clearer, actionable
  * prefix so a worker orchestrator can route on intent instead of regexing JSON.
@@ -787,4 +795,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type PreparedContext, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, TOOL_CALL_NAME_RULES, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolCallNameRule, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, clampProviderContextImages, classifyProviderError, dropInvalidToolCalls, environmentSecrets, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, isValidToolCallName, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, resolveToolSchema, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText, toolCallNameRuleFor, usesResponsesLite };
+export { type AssistantMessage, type CacheRetention, type ChatErrorReason, type ContentPart, type DoneEvent, EZCoderAIError, type ErrorEvent, type ErrorSource, EventStream, type FormattedChatError, type FormattedError, type ImageContent, type Message, type MessageProvenance, type MessageProvenanceKind, type MessageProvenanceSource, type MessageProvenanceVisibility, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type PreparedContext, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, REDACTED as REDACTION_MARKER, type RawContent, type RedactionOptions, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, TOOL_CALL_NAME_RULES, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolCallNameRule, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, clampProviderContextImages, classifyProviderError, dropInvalidToolCalls, environmentSecrets, formatChatError, formatError, formatErrorForDisplay, hasLoneSurrogate, isHardBillingMessage, isUsageLimitError, isValidToolCallName, localWireModelId, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, prewarmAnthropicCache, providerRegistry, redactText, redactValue, registerPalsuProvider, resolveToolSchema, sanitizeMessagesForWire, setProviderDiagnostic, sliceHead, sliceTail, stream, toAnthropicMessages, toOpenAIMessages, toWellFormedText, toolCallNameRuleFor, usesResponsesLite };

package/dist/index.js

@@ -1426,6 +1426,10 @@ function toLocalReasoningEffort(level) {
 function toGlmReasoningEffort(level) {
   return level === "ultra" ? "max" : level;
 }
+function toCodexReasoningEffort(level, model) {
+  if (level !== "ultra") return level;
+  return model === "gpt-6-astra" || model === "gpt-6.1-sol" ? "xhigh" : "max";
+}
 function toOpenAIReasoningEffort(level, model) {
   const effort = level === "max" || level === "ultra" ? "xhigh" : level;
   if (model.startsWith("fugu") && (effort === "low" || effort === "medium")) {
@@ -2691,7 +2695,7 @@ function toError2(err, provider = "openai") {
     const cleanMessage = isRawHtmlErrorEcho(messageCandidate) ? providerHtmlErrorMessage(err.status) : bodyMessage ? bodyMessage : isRawJsonErrorEcho(err.message) ? emptyProviderErrorMessage(err.status) : err.message;
     let hint;
     if (modelName === "codex-mini-latest" || cleanMessage.includes("codex-mini-latest")) {
-      hint = "codex-mini-latest requires an OpenAI Pro or Max subscription. Your account currently has access to GPT-5.4 and GPT-5.4 Mini.";
+      hint = "This request could not use codex-mini-latest. Check your account access or choose another available model.";
     }
     const requestId = err.request_id ?? (typeof body?.request_id === "string" ? body.request_id : void 0);
     const code = typeof err.code === "string" ? err.code : void 0;
@@ -2897,7 +2901,7 @@ async function* runStream3(options, retriedWithoutReasoning = false) {
     // GPT-5.6/6 require at least low; older models still support thinking off.
     // Apply the floor here for every caller, including one-off prompt rewrites.
     // `ultra` is a client orchestration preset, not a Codex API effort.
-    effort: options.thinking === "ultra" ? "max" : options.thinking ?? (responsesLite ? "low" : "none"),
+    effort: options.thinking ? toCodexReasoningEffort(options.thinking, options.model) : responsesLite ? "low" : "none",
     summary: "auto",
     ...liteShape ? { context: "all_turns" } : {}
   };
@@ -2958,9 +2962,9 @@ async function* runStream3(options, retriedWithoutReasoning = false) {
     if (usageLimit) throw usageLimit;
     let hint;
     if (response.status === 400 && message === `The '${options.model}' model is not supported when using Codex with a ChatGPT account.`) {
-      hint = "This model is not available through your ChatGPT account. Switch to a model listed for OpenAI via the model selector, or check your ChatGPT usage limits.";
+      hint = "This model is not available through your ChatGPT account. Choose another available model using the model selector.";
     } else if (response.status === 404 && text.includes("does not exist")) {
-      hint = "This model is not in OpenAI's current catalog for your ChatGPT account. Switch to GPT-6 Astra, GPT-6.1 Sol, or GPT-6 Luna via the model selector.";
+      hint = "This model is not in OpenAI's current catalog for your ChatGPT account. Choose another available model using the model selector.";
     }
     throw new ProviderError("openai", message, {
       statusCode: response.status,
@@ -3433,6 +3437,7 @@ function codexUsageLimitError(errorObj, statusCode, requestId) {
   const isRateOr429 = CODEX_RATE_LIMIT_CODE.test(code) || statusCode === 429;
   if (!isHardUsage && !(isRateOr429 && resetsAt != null)) return null;
   return new ProviderError("openai", "ChatGPT usage limit reached", {
+    cause: errorObj,
     statusCode: statusCode ?? 429,
     ...requestId ? { requestId } : {},
     ...resetsAt ? { resetsAt } : {}
@@ -4363,6 +4368,157 @@ function messagesContainVideo(messages) {
   return false;
 }
 
+// src/chat-error.ts
+function causeCode(error) {
+  if (!(error instanceof Error) || !error.cause || typeof error.cause !== "object") return "";
+  const cause = error.cause;
+  if ("code" in cause && typeof cause.code === "string") return cause.code;
+  if ("type" in cause && typeof cause.type === "string") return cause.type;
+  return "";
+}
+function formatChatError(error) {
+  const base = formatError(error);
+  const raw = error instanceof Error ? error.message : "";
+  const code = causeCode(error);
+  const text = `${code} ${raw}`.toLowerCase();
+  const provider = /chatgpt/i.test(raw) ? "ChatGPT" : providerLabel(base.provider);
+  const present = (reason, headline, guidance) => ({
+    ...base,
+    ...raw ? { message: raw } : {},
+    reason,
+    headline,
+    guidance
+  });
+  if (error instanceof VideoUnsupportedError) {
+    return present(
+      "capability",
+      "This model can\u2019t read this video",
+      "Choose a model that supports video."
+    );
+  }
+  if (base.source === "capability") {
+    return present(
+      "unknown",
+      "This request isn\u2019t supported",
+      "Open details to check the request requirements."
+    );
+  }
+  if (/requires a newer version of codex/.test(text)) {
+    return present(
+      "update",
+      "EZ Coder needs an update",
+      "Update the app, or choose another model."
+    );
+  }
+  if (/insufficient.*(?:balance|credits?)|(?:balance|credits?).*(?:insufficient|exhausted|depleted)|credit balance is too low|payment_required/.test(
+    text
+  )) {
+    return present(
+      "billing",
+      `${provider} credits are unavailable`,
+      "Check your balance and billing, or use another provider."
+    );
+  }
+  if (/usage_not_included|does not yet include access|not supported when using codex with a chatgpt account|(?:model[^\n]*(?:not found|not available|does not exist))|model_not_found/.test(
+    text
+  )) {
+    return present(
+      "model_access",
+      "This model isn\u2019t available to this account",
+      "Choose another model available to your account."
+    );
+  }
+  if (/insufficient_quota|exceeded your current quota|billing.?limit|spend.?limit|quota.?exceeded/.test(
+    text
+  )) {
+    return present(
+      "quota",
+      `${provider} quota is unavailable`,
+      "Check your plan or billing, or use another provider."
+    );
+  }
+  if (/^rate_limit_exceeded$/i.test(code)) {
+    return present(
+      "rate_limit",
+      `${provider} is limiting requests`,
+      "Wait a moment before trying again."
+    );
+  }
+  if (/usage limit reached|usage_limit_reached/.test(text)) {
+    return present(
+      "usage_limit",
+      `${provider} usage limit reached`,
+      "Wait for the reset, or use another provider."
+    );
+  }
+  if (base.source === "network") {
+    return present(
+      "network",
+      "Couldn\u2019t reach the provider",
+      "Check your connection before trying again."
+    );
+  }
+  if (base.source === "auth" || base.statusCode === 401) {
+    return present(
+      "auth",
+      `${provider} sign-in needs attention`,
+      "Reconnect your account in provider settings."
+    );
+  }
+  if (base.statusCode === 413 || /context[_ ](?:length|window)|maximum context|request_too_large|prompt is too long/.test(text)) {
+    return present(
+      "context",
+      "This conversation is too large",
+      "Compact the conversation or send a smaller request."
+    );
+  }
+  if (base.statusCode === 429 || /rate_limit|rate limit|too many requests/.test(text)) {
+    return present(
+      "rate_limit",
+      `${provider} is limiting requests`,
+      "Wait a moment before trying again."
+    );
+  }
+  if (base.statusCode === 403) {
+    return present(
+      "model_access",
+      "This account can\u2019t use this request",
+      "Check account access or choose another model."
+    );
+  }
+  if (error instanceof ProviderError) {
+    if (base.statusCode != null && base.statusCode >= 500) {
+      return present(
+        "provider",
+        `${provider} couldn\u2019t complete the request`,
+        "Try again later. Check details if it keeps happening."
+      );
+    }
+    return present(
+      "provider",
+      `${provider} didn\u2019t accept the request`,
+      "Check the details before trying again."
+    );
+  }
+  return present("unknown", "Something went wrong", "Open details to see what was reported.");
+}
+function providerLabel(provider) {
+  switch (provider) {
+    case "openai":
+      return "OpenAI";
+    case "anthropic":
+      return "Anthropic";
+    case "gemini":
+      return "Gemini";
+    case "xai":
+      return "xAI";
+    case "local":
+      return "The local server";
+    default:
+      return "The provider";
+  }
+}
+
 // src/error-classification.ts
 var CONTEXT_OVERFLOW_PATTERNS = [
   /context_length_exceeded/i,
@@ -4752,6 +4908,7 @@ export {
   classifyProviderError,
   dropInvalidToolCalls,
   environmentSecrets,
+  formatChatError,
   formatError,
   formatErrorForDisplay,
   hasLoneSurrogate,