@kenkaiiii/gg-ai 4.3.243 → 4.5.0

package/dist/index.d.cts

@@ -23,6 +23,11 @@ interface VideoContent {
     type: "video";
     mediaType: string;
     data: string;
+    /** Moonshot/Kimi file id (e.g. "d4f0…") after uploading via the files API.
+     *  Moonshot rejects inline base64 video; the provider uploads the clip once
+     *  and caches the id here so later turns reference `ms://<fileId>` instead of
+     *  re-sending the bytes. */
+    fileId?: string;
 }
 interface ToolCall {
     type: "tool_call";
@@ -30,7 +35,7 @@ interface ToolCall {
     name: string;
     args: Record<string, unknown>;
 }
-type ToolResultContent = string | (TextContent | ImageContent)[];
+type ToolResultContent = string | (TextContent | ImageContent | VideoContent)[];
 interface ToolResult {
     type: "tool_result";
     toolCallId: string;
@@ -208,6 +213,11 @@ interface StreamOptions {
      *  version should pass it here. Ignored for non-Anthropic providers and for
      *  Anthropic requests using a regular API key. */
     userAgent?: string;
+    /** Extra HTTP headers attached to every model request. Used by providers
+     *  whose endpoint gates on client identity (e.g. Kimi For Coding requires a
+     *  `User-Agent: kimi-code-cli/...` and `X-Msh-*` device headers). Merged
+     *  into the underlying SDK's default headers. */
+    defaultHeaders?: Record<string, string>;
 }
 
 /**
@@ -330,7 +340,7 @@ declare const providerRegistry: ProviderRegistryImpl;
  *     Cannot read property 'foo' of undefined
  *     → This is a ggcoder bug — please report it.
  */
-type ErrorSource = "provider" | "ggcoder" | "network" | "auth";
+type ErrorSource = "provider" | "ggcoder" | "network" | "auth" | "capability";
 interface FormattedError {
     /** Plain-English headline, e.g. "OpenAI returned an error." */
     headline: string;
@@ -404,6 +414,19 @@ declare function formatError(err: unknown): FormattedError;
  */
 declare function formatErrorForDisplay(err: unknown): string;
 
+/**
+ * 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.
+ * Preserves the original message verbatim after the prefix — helpful for
+ * debugging.
+ *
+ * Order matters: context-overflow is checked first because some providers wrap
+ * overflow errors in HTTP 429 envelopes; we want the structural meaning, not
+ * the transport status. Billing comes before auth/rate-limit because "402
+ * Payment Required" must not be mis-routed as a rate-limit retry.
+ */
+declare function classifyProviderError(message: string): string;
+
 /**
  * Provider-level diagnostic hook. Mirrors the pattern used by gg-agent's
  * setStreamDiagnostic — the host app wires a callback (typically writing to
@@ -496,4 +519,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, formatError, formatErrorForDisplay, isHardBillingMessage, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, classifyProviderError, formatError, formatErrorForDisplay, isHardBillingMessage, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };

package/dist/index.d.ts

@@ -23,6 +23,11 @@ interface VideoContent {
     type: "video";
     mediaType: string;
     data: string;
+    /** Moonshot/Kimi file id (e.g. "d4f0…") after uploading via the files API.
+     *  Moonshot rejects inline base64 video; the provider uploads the clip once
+     *  and caches the id here so later turns reference `ms://<fileId>` instead of
+     *  re-sending the bytes. */
+    fileId?: string;
 }
 interface ToolCall {
     type: "tool_call";
@@ -30,7 +35,7 @@ interface ToolCall {
     name: string;
     args: Record<string, unknown>;
 }
-type ToolResultContent = string | (TextContent | ImageContent)[];
+type ToolResultContent = string | (TextContent | ImageContent | VideoContent)[];
 interface ToolResult {
     type: "tool_result";
     toolCallId: string;
@@ -208,6 +213,11 @@ interface StreamOptions {
      *  version should pass it here. Ignored for non-Anthropic providers and for
      *  Anthropic requests using a regular API key. */
     userAgent?: string;
+    /** Extra HTTP headers attached to every model request. Used by providers
+     *  whose endpoint gates on client identity (e.g. Kimi For Coding requires a
+     *  `User-Agent: kimi-code-cli/...` and `X-Msh-*` device headers). Merged
+     *  into the underlying SDK's default headers. */
+    defaultHeaders?: Record<string, string>;
 }
 
 /**
@@ -330,7 +340,7 @@ declare const providerRegistry: ProviderRegistryImpl;
  *     Cannot read property 'foo' of undefined
  *     → This is a ggcoder bug — please report it.
  */
-type ErrorSource = "provider" | "ggcoder" | "network" | "auth";
+type ErrorSource = "provider" | "ggcoder" | "network" | "auth" | "capability";
 interface FormattedError {
     /** Plain-English headline, e.g. "OpenAI returned an error." */
     headline: string;
@@ -404,6 +414,19 @@ declare function formatError(err: unknown): FormattedError;
  */
 declare function formatErrorForDisplay(err: unknown): string;
 
+/**
+ * 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.
+ * Preserves the original message verbatim after the prefix — helpful for
+ * debugging.
+ *
+ * Order matters: context-overflow is checked first because some providers wrap
+ * overflow errors in HTTP 429 envelopes; we want the structural meaning, not
+ * the transport status. Billing comes before auth/rate-limit because "402
+ * Payment Required" must not be mis-routed as a rate-limit retry.
+ */
+declare function classifyProviderError(message: string): string;
+
 /**
  * Provider-level diagnostic hook. Mirrors the pattern used by gg-agent's
  * setStreamDiagnostic — the host app wires a callback (typically writing to
@@ -496,4 +519,4 @@ interface PalsuProviderConfig {
  */
 declare function registerPalsuProvider(config?: PalsuProviderConfig): PalsuProviderHandle;
 
-export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, formatError, formatErrorForDisplay, isHardBillingMessage, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };
+export { type AssistantMessage, type CacheRetention, type ContentPart, type DoneEvent, type ErrorEvent, type ErrorSource, EventStream, type FormattedError, GGAIError, type ImageContent, type Message, type PalsuModelConfig, type PalsuModelHandle, type PalsuProviderConfig, type PalsuProviderHandle, type PalsuProviderState, type PalsuResponse, type PalsuResponseFactory, type Provider, type ProviderDiagnosticFn, type ProviderEntry, ProviderError, type ProviderStreamFn, type RawContent, type ServerToolCall, type ServerToolCallEvent, type ServerToolDefinition, type ServerToolResult, type ServerToolResultEvent, type StopReason, type StreamEvent, type StreamOptions, type StreamResponse, StreamResult, type SystemMessage, type TextContent, type TextDeltaEvent, type ThinkingContent, type ThinkingDeltaEvent, type ThinkingLevel, type Tool, type ToolCall, type ToolCallDeltaEvent, type ToolCallDoneEvent, type ToolChoice, type ToolResult, type ToolResultContent, type ToolResultMessage, type Usage, type UserMessage, type VideoContent, classifyProviderError, formatError, formatErrorForDisplay, isHardBillingMessage, isUsageLimitError, palsuAssistantMessage, palsuText, palsuThinking, palsuToolCall, providerRegistry, registerPalsuProvider, setProviderDiagnostic, stream, toAnthropicMessages, toOpenAIMessages };

package/dist/index.js

@@ -25,6 +25,12 @@ var GGAIError = class extends Error {
     this.hint = options?.hint;
   }
 };
+var VideoUnsupportedError = class extends GGAIError {
+  constructor() {
+    super("This model can't analyze video.", { source: "capability" });
+    this.name = "VideoUnsupportedError";
+  }
+};
 var ProviderError = class extends GGAIError {
   provider;
   statusCode;
@@ -140,6 +146,14 @@ function finaliseBySource(source, message, requestId, hint) {
         guidance: hint ?? providerGuidance(void 0, message, void 0),
         ...requestId ? { requestId } : {}
       };
+    case "capability":
+      return {
+        headline: message,
+        source,
+        message: "",
+        guidance: hint ?? "Only Kimi, Gemini, and MiniMax can analyze video. Switch with /model.",
+        ...requestId ? { requestId } : {}
+      };
     case "ggcoder":
       return {
         headline: "ggcoder hit an unexpected error.",
@@ -500,6 +514,10 @@ function toolResultImages(content) {
   if (typeof content === "string") return [];
   return content.filter((b) => b.type === "image");
 }
+function toolResultVideos(content) {
+  if (typeof content === "string") return [];
+  return content.filter((b) => b.type === "video");
+}
 function toAnthropicCacheControl(retention, baseUrl) {
   const resolved = retention ?? "short";
   if (resolved === "none") return void 0;
@@ -510,6 +528,12 @@ function toAnthropicToolResultContent(content) {
   if (typeof content === "string") return content;
   return content.map((block) => {
     if (block.type === "text") return { type: "text", text: block.text };
+    if (block.type === "video") {
+      return {
+        type: "video",
+        source: { type: "base64", media_type: block.mediaType, data: block.data }
+      };
+    }
     return {
       type: "image",
       source: {
@@ -579,6 +603,8 @@ function toAnthropicMessages(messages, cacheControl) {
     if (msg.role === "tool") {
       out.push({
         role: "user",
+        // Cast covers the video block (used by the Anthropic-compatible MiniMax
+        // API), which isn't in the first-party Anthropic tool_result types.
         content: msg.content.map((result) => ({
           type: "tool_result",
           tool_use_id: remapAnthropicToolCallId(result.toolCallId, idMap),
@@ -719,11 +745,10 @@ function toOpenAIMessages(messages, options) {
             (part) => {
               if (part.type === "text") return { type: "text", text: part.text };
               if (part.type === "video") {
+                const videoUrl = part.fileId ? { url: `ms://${part.fileId}`, id: part.fileId } : { url: `data:${part.mediaType};base64,${part.data}` };
                 return {
                   type: "video_url",
-                  video_url: {
-                    url: `data:${part.mediaType};base64,${part.data}`
-                  }
+                  video_url: videoUrl
                 };
               }
               return {
@@ -768,11 +793,27 @@ function toOpenAIMessages(messages, options) {
       continue;
     }
     if (msg.role === "tool") {
+      const isMoonshot = options?.provider === "moonshot";
       const imageBlocks = [];
       for (const result of msg.content) {
         const text = toolResultText(result.content);
         const images = toolResultImages(result.content);
+        const videos = isMoonshot ? toolResultVideos(result.content) : [];
         const hasText = text.length > 0;
+        if (videos.length > 0) {
+          const parts = [];
+          if (hasText) parts.push({ type: "text", text });
+          const videoParts = videos.map((v) => {
+            const videoUrl = v.fileId ? { url: `ms://${v.fileId}`, id: v.fileId } : { url: `data:${v.mediaType};base64,${v.data}` };
+            return { type: "video_url", video_url: videoUrl };
+          });
+          out.push({
+            role: "tool",
+            tool_call_id: remapToolCallId(result.toolCallId, idMap),
+            content: [...parts, ...videoParts]
+          });
+          continue;
+        }
         out.push({
           role: "tool",
           tool_call_id: remapToolCallId(result.toolCallId, idMap),
@@ -1357,6 +1398,75 @@ function fnv1aHash(value) {
   return (hash >>> 0).toString(16).padStart(8, "0");
 }
 
+// src/utils/diag.ts
+var _diagFn = null;
+function setProviderDiagnostic(fn) {
+  _diagFn = fn;
+}
+function providerDiag(phase, data) {
+  _diagFn?.(phase, data);
+}
+
+// src/providers/moonshot-video.ts
+async function uploadMoonshotVideos(client, messages, signal) {
+  for (const msg of messages) {
+    if (typeof msg.content === "string") continue;
+    for (const part of msg.content) {
+      if (part.type === "video") {
+        await ensureUploaded(client, part, signal);
+        continue;
+      }
+      if (part.type === "tool_result" && Array.isArray(part.content)) {
+        for (const inner of part.content) {
+          if (inner.type === "video") {
+            await ensureUploaded(client, inner, signal);
+          }
+        }
+      }
+    }
+  }
+}
+async function ensureUploaded(client, video, signal) {
+  if (video.fileId) {
+    providerDiag("moonshot_video_cached", { fileId: video.fileId });
+    return;
+  }
+  if (!video.data) {
+    providerDiag("moonshot_video_skipped_no_data", {});
+    return;
+  }
+  providerDiag("moonshot_video_upload_start", {
+    mediaType: video.mediaType,
+    bytes: Math.floor(video.data.length * 3 / 4)
+  });
+  video.fileId = await uploadOne(client, video, signal);
+  providerDiag("moonshot_video_upload_done", { fileId: video.fileId });
+}
+async function uploadOne(client, video, signal) {
+  const bytes = Buffer.from(video.data, "base64");
+  const mediaType = video.mediaType || "video/mp4";
+  const filename = `upload.${extForMime(mediaType)}`;
+  const file = new File([new Uint8Array(bytes)], filename, { type: mediaType });
+  const uploaded = await client.files.create(
+    { file, purpose: "video" },
+    signal ? { signal } : void 0
+  );
+  return uploaded.id;
+}
+var MIME_TO_EXT = {
+  "video/mp4": "mp4",
+  "video/mpeg": "mpeg",
+  "video/quicktime": "mov",
+  "video/webm": "webm",
+  "video/x-matroska": "mkv",
+  "video/x-msvideo": "avi",
+  "video/x-flv": "flv",
+  "video/3gpp": "3gp"
+};
+function extForMime(mediaType) {
+  return MIME_TO_EXT[mediaType.toLowerCase()] ?? "mp4";
+}
+
 // src/utils/env.ts
 function getEnvironment() {
   return globalThis.process?.env;
@@ -1386,7 +1496,8 @@ function createClient2(options) {
   return new OpenAI({
     apiKey: options.apiKey,
     ...options.baseUrl ? { baseURL: options.baseUrl } : {},
-    ...options.fetch ? { fetch: options.fetch } : {}
+    ...options.fetch ? { fetch: options.fetch } : {},
+    ...options.defaultHeaders ? { defaultHeaders: options.defaultHeaders } : {}
   });
 }
 function streamOpenAI(options) {
@@ -1399,6 +1510,13 @@ async function* runStream2(options) {
   const usesThinkingParam = options.provider === "glm" || options.provider === "moonshot" || options.provider === "xiaomi";
   const downgradedImages = downgradeUnsupportedImages(options.messages, options.supportsImages);
   const downgradedMessages = downgradeUnsupportedVideos(downgradedImages, options.supportsVideo);
+  if (options.provider === "moonshot") {
+    try {
+      await uploadMoonshotVideos(client, downgradedMessages, options.signal);
+    } catch (err) {
+      throw toError2(err, providerName);
+    }
+  }
   const messages = toOpenAIMessages(downgradedMessages, {
     provider: options.provider,
     thinking: !!options.thinking,
@@ -1702,15 +1820,6 @@ function toError2(err, provider = "openai") {
 // src/providers/openai-codex.ts
 import os from "os";
 
-// src/utils/diag.ts
-var _diagFn = null;
-function setProviderDiagnostic(fn) {
-  _diagFn = fn;
-}
-function providerDiag(phase, data) {
-  _diagFn?.(phase, data);
-}
-
 // src/utils/sse.ts
 function parseSseBuffer(buffer) {
   const events = [];
@@ -2359,6 +2468,13 @@ ${msg.content}` : msg.content;
             }
           }
         });
+        if (typeof result.content !== "string") {
+          for (const block of result.content) {
+            if (block.type === "video") {
+              parts.push({ inlineData: { mimeType: block.mediaType, data: block.data } });
+            }
+          }
+        }
       }
       if (parts.length > 0) contents.push({ role: "user", parts });
     }
@@ -2756,6 +2872,7 @@ var providerRegistry = new ProviderRegistryImpl();
 
 // src/stream.ts
 var GLM_CODING_BASE_URL = "https://api.z.ai/api/coding/paas/v4";
+var KIMI_CODE_USER_AGENT = `kimi-code-cli/${process.env.KIMI_CODE_VERSION ?? "1.0.11"}`;
 providerRegistry.register("anthropic", {
   stream: (options) => streamAnthropic(options)
 });
@@ -2784,10 +2901,11 @@ providerRegistry.register("glm", {
   })
 });
 providerRegistry.register("moonshot", {
-  stream: (options) => streamOpenAI({
-    ...options,
-    baseUrl: options.baseUrl ?? "https://api.moonshot.ai/v1"
-  })
+  stream: (options) => {
+    const baseUrl = options.baseUrl ?? "https://api.moonshot.ai/v1";
+    const defaultHeaders = baseUrl.includes("api.kimi.com") ? { "User-Agent": KIMI_CODE_USER_AGENT, ...options.defaultHeaders } : options.defaultHeaders;
+    return streamOpenAI({ ...options, baseUrl, defaultHeaders });
+  }
 });
 providerRegistry.register("deepseek", {
   stream: (options) => streamOpenAI({
@@ -2820,8 +2938,113 @@ function stream(options) {
       `Unknown provider: "${options.provider}". Registered: ${providerRegistry.list().join(", ")}`
     );
   }
+  if (options.supportsVideo !== true && messagesContainVideo(options.messages)) {
+    throw new VideoUnsupportedError();
+  }
   return entry.stream(options);
 }
+function messagesContainVideo(messages) {
+  for (const msg of messages) {
+    if (typeof msg.content === "string" || !Array.isArray(msg.content)) continue;
+    for (const part of msg.content) {
+      if (part.type === "video") return true;
+      if (part.type === "tool_result" && Array.isArray(part.content)) {
+        if (part.content.some((block) => block.type === "video")) return true;
+      }
+    }
+  }
+  return false;
+}
+
+// src/error-classification.ts
+var CONTEXT_OVERFLOW_PATTERNS = [
+  /context_length_exceeded/i,
+  /context length exceeded/i,
+  /context window/i,
+  // OpenAI Codex / Responses
+  /maximum context length/i,
+  // OpenAI / OpenRouter / Mistral
+  /prompt is too long/i,
+  // Anthropic
+  /request_too_large/i,
+  // Anthropic HTTP 413
+  /input is too long/i,
+  // Bedrock
+  /input token count.*exceeds the maximum/i,
+  // Gemini
+  /maximum prompt length/i,
+  // xAI / Grok
+  /reduce the length of the messages/i,
+  // Groq
+  /too large for model/i,
+  // Mistral
+  /token limit/i
+  // generic
+];
+var RATE_LIMIT_PATTERNS = [
+  /rate[ _-]?limit/i,
+  /\b429\b/,
+  /too many requests/i,
+  /tokens per minute/i,
+  /requests per minute/i
+];
+var PROVIDER_TRANSIENT_PATTERNS = [
+  /\b5\d\d\b/,
+  /api_error/i,
+  /server_error/i,
+  /internal server error/i,
+  /bad gateway/i,
+  /service unavailable/i,
+  /gateway timeout/i,
+  /overloaded/i,
+  /\b529\b/
+];
+var BILLING_PATTERNS = [
+  /payment required/i,
+  /\b402\b/,
+  /quota_exceeded/i,
+  // underscore variant not in isHardBillingMessage
+  /credit balance/i
+];
+var AUTH_PATTERNS = [
+  /invalid[ _]api[ _]key/i,
+  /unauthorized/i,
+  /\b401\b/,
+  /authentication[ _]failed/i,
+  /please run \/login/i
+  // Anthropic Claude Code-style hint
+];
+function matchesAny(message, patterns) {
+  return patterns.some((p) => p.test(message));
+}
+function classifyProviderError(message) {
+  if (matchesAny(message, CONTEXT_OVERFLOW_PATTERNS)) {
+    return `[context_overflow] Worker context window exceeded \u2014 the conversation is too large to continue. Recovery: call reset_worker(project) to wipe history, then re-prompt with the task. Re-prompting WITHOUT reset will fail the same way.
+
+Original: ${message}`;
+  }
+  if (isHardBillingMessage(message) || matchesAny(message, BILLING_PATTERNS)) {
+    return `[billing] Provider billing/quota issue. Recovery: surface to the user \u2014 they need to top up or switch providers. Do NOT retry.
+
+Original: ${message}`;
+  }
+  if (matchesAny(message, AUTH_PATTERNS)) {
+    return `[auth] Provider authentication failed. Recovery: surface to the user \u2014 they need to re-login. Do NOT retry.
+
+Original: ${message}`;
+  }
+  if (matchesAny(message, RATE_LIMIT_PATTERNS)) {
+    return `[rate_limited] Provider rate limit hit. Recovery: wait ~30s, then re-prompt the same worker (no reset needed).
+
+Original: ${message}`;
+  }
+  if (matchesAny(message, PROVIDER_TRANSIENT_PATTERNS)) {
+    return `[provider_transient] Provider server-side/transient error. Recovery: wait briefly, then re-prompt the same worker (no reset needed). If it keeps happening, switch models/providers or check provider status.
+
+Original: ${message}`;
+  }
+  return message;
+}
 
 // src/providers/palsu.ts
 function palsuText(text) {
@@ -2979,6 +3202,7 @@ export {
   GGAIError,
   ProviderError,
   StreamResult,
+  classifyProviderError,
   formatError,
   formatErrorForDisplay,
   isHardBillingMessage,