@linghun/tui 0.1.0

package/dist/chunk-OMZYPQVA.js

@@ -0,0 +1,298 @@
+import {
+  charWidth
+} from "./chunk-APJIC2O5.js";
+
+// src/startup-runtime.ts
+import { homedir } from "os";
+import { basename, relative } from "path";
+import { clearLine, cursorTo, emitKeypressEvents } from "readline";
+import { createInterface } from "readline/promises";
+function writeLine(output, text) {
+  try {
+    output.write(`${text}
+`);
+  } catch (error) {
+    if (isBenignWriteError(error)) {
+      return;
+    }
+    throw error;
+  }
+}
+function isBenignWriteError(error) {
+  const code = error && typeof error === "object" ? error.code : void 0;
+  return code === "EPIPE" || code === "ERR_STREAM_DESTROYED" || code === "ERR_STREAM_WRITE_AFTER_END";
+}
+function readOutputColumns(output) {
+  const columns = output.columns;
+  return typeof columns === "number" && Number.isFinite(columns) ? columns : 80;
+}
+function readOutputRows(output) {
+  const rows = output.rows;
+  return typeof rows === "number" && Number.isFinite(rows) ? rows : 24;
+}
+function truncateDisplay(text, maxWidth) {
+  let width = 0;
+  let result = "";
+  for (const char of stripAnsi(text)) {
+    const cw = charWidth(char);
+    if (width + cw > maxWidth) {
+      return `${result}\u2026`;
+    }
+    width += cw;
+    result += char;
+  }
+  return result;
+}
+function stripAnsi(text) {
+  const escapeChar = String.fromCharCode(27);
+  return text.replace(new RegExp(`${escapeChar}\\[[0-9;]*m`, "g"), "");
+}
+function uniqueStrings(items) {
+  return [...new Set(items)];
+}
+function sanitizeDiagnosticText(text) {
+  return text.replace(/prompt=[^\s&]+/giu, "prompt=***").replace(/api[_-]?key=[^\s&]+/giu, "api_key=***").replace(/Bearer\s+[A-Za-z0-9._~-]+/giu, "Bearer ***").replace(/sk-[A-Za-z0-9_-]+/gu, "sk-***");
+}
+function formatDisplayPath(path, projectPath) {
+  if (!path) return "-";
+  const normalized = path.replaceAll("\\", "/");
+  if (!isAbsoluteDisplayPath(normalized)) {
+    return normalized;
+  }
+  const project = projectPath?.replaceAll("\\", "/").replace(/\/+$/u, "");
+  if (project && (normalized === project || normalized.startsWith(`${project}/`))) {
+    const rel = relative(projectPath ?? "", path).replaceAll("\\", "/");
+    return rel && rel !== "" ? rel : ".";
+  }
+  const home = homedir().replaceAll("\\", "/").replace(/\/+$/u, "");
+  if (home && (normalized === home || normalized.startsWith(`${home}/`))) {
+    return `[user-home]/.../${basename(path)}`;
+  }
+  return `[local-path]/${basename(path)}`;
+}
+function isAbsoluteDisplayPath(path) {
+  return /^[A-Za-z]:\//u.test(path) || path.startsWith("/");
+}
+function sanitizeDisplayPaths(text, projectPath) {
+  let output = text;
+  const protectedSegments = [];
+  const protectSegment = (match) => {
+    const token = `__LINGHUN_DISPLAY_PATH_PROTECTED_${protectedSegments.length}__`;
+    protectedSegments.push(match);
+    return token;
+  };
+  output = output.replace(/\bhttps?:\/\/[^\r\n\s"'<>{}]+/giu, protectSegment).replace(/\bendpointPath=\/[^\r\n\s"'<>{}]+/giu, protectSegment).replace(/\bendpoint\s+path\s+\/[^\r\n\s"'<>{}]+/giu, protectSegment);
+  if (projectPath) {
+    const normalizedProject = createFlexiblePathPattern(projectPath);
+    output = output.replace(
+      new RegExp(`${normalizedProject}[^\r
+\\s"'<>{}]*`, "giu"),
+      (match) => formatDisplayPath(match, projectPath)
+    );
+  }
+  const home = createFlexiblePathPattern(homedir());
+  output = output.replace(
+    new RegExp(`${home}[^\r
+\\s"'<>{}]*`, "giu"),
+    (match) => formatDisplayPath(match, projectPath)
+  );
+  output = output.replace(
+    /[A-Za-z]:[\\/][^\r\n\s"'<>{}]+/gu,
+    (match) => formatDisplayPath(match, projectPath)
+  );
+  output = output.replace(
+    /(^|[\s([{:=,])((?:\/[^\r\n\s"'<>{}/]+){2,})/gu,
+    (_match, prefix, path) => `${prefix}${formatDisplayPath(path, projectPath)}`
+  );
+  protectedSegments.forEach((segment, index) => {
+    output = output.replaceAll(`__LINGHUN_DISPLAY_PATH_PROTECTED_${index}__`, segment);
+  });
+  return output;
+}
+function createFlexiblePathPattern(path) {
+  return escapeRegExp(path.replaceAll("\\", "/").replace(/\/+$/u, "")).replaceAll("/", "[\\\\/]");
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
+function sanitizeUserFacingError(value) {
+  return sanitizeDiagnosticText(value).replace(/gateId=[^\s,;]+/giu, "gateId=***").replace(/request[_-]?id=[^\s,;]+/giu, "requestId=***").replace(/token=[^\s&]+/giu, "token=***").replace(/Authorization:\s*[^\s]+/giu, "Authorization: ***");
+}
+function formatError(error, language = "zh-CN") {
+  const rawMessage = error instanceof Error ? error.message : language === "en-US" ? "unknown error" : "\u672A\u77E5\u9519\u8BEF";
+  const message = sanitizeUserFacingError(rawMessage);
+  const suggestion = error instanceof Error && "suggestion" in error && typeof error.suggestion === "string" ? sanitizeUserFacingError(error.suggestion) : language === "en-US" ? "open the related details/debug command if you need the full trace" : "\u5982\u9700\u5B8C\u6574 trace\uFF0C\u8BF7\u6253\u5F00\u5BF9\u5E94 details/debug \u5165\u53E3";
+  if (language === "en-US") {
+    return [
+      "Something went wrong.",
+      `- what happened: ${message}`,
+      "- impact: the current action did not complete.",
+      `- next: ${suggestion}`,
+      "- details: use the related /details or doctor command for the full record."
+    ].join("\n");
+  }
+  return [
+    "\u51FA\u9519\u4E86\u3002",
+    `- \u53D1\u751F\u4E86\u4EC0\u4E48\uFF1A${message}`,
+    "- \u5F71\u54CD\u8303\u56F4\uFF1A\u5F53\u524D\u64CD\u4F5C\u672A\u5B8C\u6210\u3002",
+    `- \u4E0B\u4E00\u6B65\uFF1A${suggestion}`,
+    "- \u8BE6\u60C5\uFF1A\u7528\u5BF9\u5E94 /details \u6216 doctor \u547D\u4EE4\u67E5\u770B\u5B8C\u6574\u8BB0\u5F55\u3002"
+  ].join("\n");
+}
+function shouldEnterProductShellCandidate(input, output) {
+  if (process.env.LINGHUN_TUI_PLAIN === "1") return false;
+  if (process.env.TERM === "dumb") return false;
+  return input.isTTY === true && output.isTTY === true;
+}
+function formatProviderEnvWarning(reason, language) {
+  return language === "en-US" ? `provider.env could not be read: ${reason}. Fix it and restart Linghun, or run /model setup to reconfigure the user provider.` : `provider.env \u8BFB\u53D6\u5931\u8D25\uFF1A${reason}\u3002\u8BF7\u4FEE\u6B63\u540E\u91CD\u542F Linghun\uFF0C\u6216\u8FD0\u884C /model setup \u91CD\u65B0\u914D\u7F6E\u672C\u673A\u7528\u6237 provider\u3002`;
+}
+function formatProjectRouteProblem(problem, language) {
+  return language === "en-US" ? [
+    "Project model route needs attention.",
+    `- ${problem}`,
+    "- This is a project-scoped route/settings issue, not a reason to re-enter your user API key.",
+    "- Check /model doctor or update this repo's .linghun/settings.json route/model settings."
+  ].join("\n") : [
+    "\u9879\u76EE\u6A21\u578B\u8DEF\u7531\u9700\u8981\u5904\u7406\u3002",
+    `- ${problem}`,
+    "- \u8FD9\u662F\u5F53\u524D\u9879\u76EE\u7684 route/settings \u95EE\u9898\uFF0C\u4E0D\u662F\u8BA9\u4F60\u91CD\u590D\u586B\u5199\u672C\u673A\u7528\u6237 API key\u3002",
+    "- \u53EF\u7528 /model doctor \u68C0\u67E5\uFF0C\u6216\u8C03\u6574\u672C\u4ED3\u5E93 .linghun/settings.json \u91CC\u7684 route/model \u914D\u7F6E\u3002"
+  ].join("\n");
+}
+function formatUserScopedSetupNeeded(providerEnvPath, language) {
+  return language === "en-US" ? [
+    "Model setup needed: one-time setup for this computer.",
+    "- This saves provider settings in your user config, not in this repository.",
+    "- After saving once, other repositories will reuse the same user provider.env by default.",
+    '- Say "configure provider" or press Enter to start; /model setup remains the advanced recovery entry.',
+    `- User provider.env path: ${providerEnvPath}`
+  ].join("\n") : [
+    "\u9700\u8981\u914D\u7F6E\u6A21\u578B\uFF1A\u8FD9\u662F\u672C\u673A\u4E00\u6B21\u914D\u7F6E\uFF0C\u4E0D\u662F\u5F53\u524D\u4ED3\u5E93\u914D\u7F6E\u3002",
+    "- \u914D\u7F6E\u4F1A\u4FDD\u5B58\u5230\u672C\u673A\u7528\u6237\u76EE\u5F55\uFF0C\u4E0D\u4F1A\u5199\u5165\u8FD9\u4E2A\u4ED3\u5E93\u3002",
+    "- \u914D\u7F6E\u4E00\u6B21\u540E\uFF0C\u4E4B\u540E\u8FDB\u5165\u5176\u4ED6\u4ED3\u5E93\u4E5F\u4F1A\u9ED8\u8BA4\u590D\u7528\u540C\u4E00\u4E2A\u7528\u6237 provider.env\u3002",
+    "- \u53EF\u4EE5\u76F4\u63A5\u8BF4\u201C\u6211\u8981\u914D\u7F6E\u6A21\u578B\u201D\u6216\u6309 Enter \u5F00\u59CB\uFF1B/model setup \u4FDD\u7559\u4E3A\u9AD8\u7EA7/\u6062\u590D\u5165\u53E3\u3002",
+    `- \u7528\u6237 provider.env \u4F4D\u7F6E\uFF1A${providerEnvPath}`
+  ].join("\n");
+}
+function createShellLimitations(input) {
+  const limitations = [];
+  if (input.providerEnvWarning) {
+    limitations.push(
+      input.language === "en-US" ? "Provider env could not be read; run /model setup or /model doctor." : "provider.env \u8BFB\u53D6\u5931\u8D25\uFF1B\u53EF\u7528 /model setup \u6216 /model doctor \u5904\u7406\u3002"
+    );
+  }
+  return limitations;
+}
+async function* readInputLines(input, output, keyHandlers = {}) {
+  if (input.isTTY !== true) {
+    const chunks = [];
+    for await (const chunk of input) {
+      chunks.push(toInputBuffer(chunk));
+    }
+    const text = decodeInput(Buffer.concat(chunks));
+    for (const line of text.split(/\r?\n/)) {
+      yield line;
+    }
+    return;
+  }
+  if ("setEncoding" in input && typeof input.setEncoding === "function") {
+    input.setEncoding("utf8");
+  }
+  const rawInput = input;
+  const wasRaw = rawInput.isRaw === true;
+  if (typeof rawInput.setRawMode === "function") {
+    rawInput.setRawMode(true);
+  }
+  const rl = createInterface({ input, output });
+  const cleanupKeypress = installInputKeyHandlers(input, output, rl, keyHandlers);
+  const prompt = keyHandlers.prompt ?? "\u4F60> ";
+  let skipNextEmptyLine = false;
+  try {
+    output.write(prompt);
+    for await (const line of rl) {
+      if (skipNextEmptyLine && line.trim() === "") {
+        skipNextEmptyLine = false;
+        output.write(prompt);
+        continue;
+      }
+      yield line;
+      output.write(prompt);
+    }
+  } finally {
+    cleanupKeypress();
+    if (typeof rawInput.setRawMode === "function" && !wasRaw) {
+      rawInput.setRawMode(false);
+    }
+    rl.close();
+  }
+  function installInputKeyHandlers(target, out, readline, handlers) {
+    if (!handlers.onEsc && !handlers.onEnter && !handlers.onShiftTab) {
+      return () => void 0;
+    }
+    const onKeypress = (_str, key = {}) => {
+      if (key.name === "escape" && handlers.onEsc) {
+        void handlers.onEsc();
+        return;
+      }
+      if (key.name === "tab" && key.shift && handlers.onShiftTab) {
+        void handlers.onShiftTab();
+        return;
+      }
+      if (handlers.shouldMaskInput?.()) {
+        const currentLine = readline.line ?? "";
+        clearLine(out, 0);
+        cursorTo(out, 0);
+        out.write(`${prompt}${"*".repeat(currentLine.length)}`);
+      }
+      if (key.name === "return" && handlers.onEnter) {
+        const currentLine = readline.line ?? "";
+        if ((currentLine ?? "").trim() === "") {
+          skipNextEmptyLine = true;
+          void handlers.onEnter();
+        }
+      }
+    };
+    emitKeypressEvents(target);
+    target.on("keypress", onKeypress);
+    return () => target.off("keypress", onKeypress);
+  }
+}
+function toInputBuffer(chunk) {
+  if (Buffer.isBuffer(chunk)) {
+    return chunk;
+  }
+  if (chunk instanceof Uint8Array) {
+    return Buffer.from(chunk);
+  }
+  return Buffer.from(String(chunk), "utf8");
+}
+function decodeInput(bytes) {
+  const utf8 = new TextDecoder("utf-8", { fatal: false }).decode(bytes);
+  if (!utf8.includes("\uFFFD")) {
+    return utf8;
+  }
+  return new TextDecoder("gb18030", { fatal: false }).decode(bytes);
+}
+
+export {
+  writeLine,
+  readOutputColumns,
+  readOutputRows,
+  truncateDisplay,
+  stripAnsi,
+  uniqueStrings,
+  sanitizeDiagnosticText,
+  formatDisplayPath,
+  sanitizeDisplayPaths,
+  sanitizeUserFacingError,
+  formatError,
+  shouldEnterProductShellCandidate,
+  formatProviderEnvWarning,
+  formatProjectRouteProblem,
+  formatUserScopedSetupNeeded,
+  createShellLimitations,
+  readInputLines,
+  toInputBuffer,
+  decodeInput
+};

package/dist/chunk-OZMX3E35.js

@@ -0,0 +1,248 @@
+// src/request-lifecycle-presenter.ts
+function formatRequestActivity(phase, language, values = {}) {
+  const reportPath = values.reportPath ?? "report.md";
+  const toolName = values.toolName ?? "tool";
+  if (language === "en-US") {
+    if (phase === "request_started_report") {
+      return `Inspecting project evidence, then saving the report to ${reportPath}.`;
+    }
+    if (phase === "waiting_first_delta") {
+      return "Still waiting for the model. Use /interrupt to stop this request.";
+    }
+    if (phase === "tool_running") {
+      return `Running ${toolName}\u2026`;
+    }
+    if (phase === "continuing_after_tool") {
+      return "Continuing after the tool result\u2026";
+    }
+    if (phase === "permission_waiting") {
+      return "Waiting for your approval; the model request is paused.";
+    }
+    if (phase === "verifying_final_answer") {
+      return "Verifying the final answer before showing it.";
+    }
+    if (phase === "provider_retrying") {
+      const attempt = values.retryAttempt ?? 1;
+      const max = values.retryMax ?? 3;
+      const delay = values.retryDelaySec ?? 1;
+      return `Retrying (${attempt}/${max})\u2026 retry in ${delay}s`;
+    }
+    return "Thinking\u2026";
+  }
+  if (phase === "request_started_report") {
+    return `\u6B63\u5728\u68C0\u67E5\u9879\u76EE\u8BC1\u636E\uFF0C\u968F\u540E\u628A\u62A5\u544A\u4FDD\u5B58\u5230 ${reportPath}\u3002`;
+  }
+  if (phase === "waiting_first_delta") {
+    return "\u6A21\u578B\u4ECD\u5728\u7B49\u5F85\u54CD\u5E94\u3002\u53EF\u7528 /interrupt \u4E2D\u65AD\u672C\u6B21\u8BF7\u6C42\u3002";
+  }
+  if (phase === "tool_running") {
+    return `\u6B63\u5728\u8FD0\u884C ${toolName}\u2026`;
+  }
+  if (phase === "continuing_after_tool") {
+    return "\u5DE5\u5177\u7ED3\u679C\u5DF2\u56DE\u4F20\uFF0C\u6B63\u5728\u7EE7\u7EED\u751F\u6210\u2026";
+  }
+  if (phase === "permission_waiting") {
+    return "\u6B63\u5728\u7B49\u5F85\u4F60\u7684\u6279\u51C6\uFF1B\u6A21\u578B\u8BF7\u6C42\u5DF2\u6682\u505C\u3002";
+  }
+  if (phase === "verifying_final_answer") {
+    return "\u6B63\u5728\u9A8C\u8BC1\u6700\u7EC8\u56DE\u7B54\uFF0C\u9A8C\u8BC1\u540E\u518D\u663E\u793A\u3002";
+  }
+  if (phase === "provider_retrying") {
+    const attempt = values.retryAttempt ?? 1;
+    const max = values.retryMax ?? 3;
+    const delay = values.retryDelaySec ?? 1;
+    return `\u91CD\u8BD5\u4E2D (${attempt}/${max})\u2026${delay}s \u540E\u91CD\u8BD5`;
+  }
+  return "\u6B63\u5728\u601D\u8003\u2026";
+}
+function formatProviderFailurePrimary(error, language) {
+  const kind = classifyProviderFailure(error);
+  if (language === "en-US") {
+    if (kind === "rate_limit") {
+      return "The model service is rate limited. Slow down or retry later; a configured fallback model can be used when available. Run /model doctor for details.";
+    }
+    if (kind === "quota_or_balance_exhausted") {
+      return "The model service reported exhausted quota, credits, or account balance. Add billing or credits, or switch key/provider/model. Linghun has not queried your balance. Run /model doctor for details.";
+    }
+    if (kind === "reasoning_unsupported") {
+      return "This gateway or model does not accept reasoning params. Lower the reasoning level or switch the gateway/model. Run /model doctor for details.";
+    }
+    if (kind === "auth") {
+      return "The model service rejected the API key or permission. Check the key, account permissions, or selected provider/model. Run /model doctor for details.";
+    }
+    if (kind === "not_found") {
+      return "The endpoint or model was not found. Check the base URL, endpoint profile, and model name. Run /model doctor for details.";
+    }
+    if (kind === "gateway") {
+      return "The upstream model service or gateway is temporarily unavailable, so this request did not complete. Retry later or run /model doctor for details.";
+    }
+    if (kind === "transit") {
+      return "The response stream failed in transit, so this request did not complete. This is a service or network transport issue, not a local Linghun bug. Retry later or run /model doctor for details.";
+    }
+    if (kind === "timeout") {
+      return "The model took too long to respond, so this request did not complete. Retry later or run /model doctor for details.";
+    }
+    if (kind === "abort") {
+      return "This request was interrupted. Input is ready again.";
+    }
+    if (kind === "schema") {
+      return "The model service rejected the request shape: schema, tool choice, tool result, or reasoning settings are incompatible. Run /model doctor for details.";
+    }
+    return "The model request did not complete. Run /model doctor for details, then retry.";
+  }
+  if (kind === "rate_limit") {
+    return "\u6A21\u578B\u670D\u52A1\u89E6\u53D1\u9650\u6D41\u3002\u672C\u6B21\u8BF7\u6C42\u672A\u5B8C\u6210\uFF1B\u8BF7\u964D\u4F4E\u8BF7\u6C42\u9891\u7387\u6216\u7A0D\u540E\u91CD\u8BD5\u3002\u82E5\u5DF2\u914D\u7F6E\u5907\u7528\u6A21\u578B\uFF0CLinghun \u4F1A\u5C1D\u8BD5\u5207\u6362\u3002\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "quota_or_balance_exhausted") {
+    return "\u6A21\u578B\u670D\u52A1\u8FD4\u56DE\u989D\u5EA6\u3001\u70B9\u6570\u6216\u8D26\u6237\u4F59\u989D\u4E0D\u8DB3\u3002\u672C\u6B21\u8BF7\u6C42\u672A\u5B8C\u6210\uFF1B\u8BF7\u5145\u503C\u6216\u68C0\u67E5\u8D26\u5355\uFF0C\u6216\u5207\u6362\u5BC6\u94A5\u3001\u670D\u52A1\u5546\u6216\u6A21\u578B\u3002Linghun \u6CA1\u6709\u67E5\u8BE2\u4F59\u989D\uFF0C\u53EA\u662F\u6839\u636E\u4E0A\u6E38\u9519\u8BEF\u5206\u7C7B\u3002\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "reasoning_unsupported") {
+    return "\u5F53\u524D\u7F51\u5173\u6216\u6A21\u578B\u4E0D\u63A5\u53D7\u63A8\u7406\u53C2\u6570\u3002\u8BF7\u964D\u4F4E\u63A8\u7406\u7B49\u7EA7\u6216\u66F4\u6362\u7F51\u5173/\u6A21\u578B\u3002\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "auth") {
+    return "\u6A21\u578B\u670D\u52A1\u62D2\u7EDD\u4E86\u5BC6\u94A5\u6216\u6743\u9650\u3002\u672C\u6B21\u8BF7\u6C42\u672A\u5B8C\u6210\uFF1B\u8BF7\u68C0\u67E5\u5BC6\u94A5\u3001\u8D26\u53F7\u6743\u9650\u6216\u5F53\u524D\u670D\u52A1\u5546/\u6A21\u578B\u914D\u7F6E\u3002\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "not_found") {
+    return "\u63A5\u53E3\u6216\u6A21\u578B\u4E0D\u5B58\u5728\u3002\u672C\u6B21\u8BF7\u6C42\u672A\u5B8C\u6210\uFF1B\u8BF7\u68C0\u67E5\u670D\u52A1\u5730\u5740\u3001\u63A5\u53E3\u7C7B\u578B\u548C\u6A21\u578B\u540D\u79F0\u3002\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "gateway") {
+    return "\u4E0A\u6E38\u6A21\u578B\u670D\u52A1\u6216\u7F51\u5173\u6682\u65F6\u5F02\u5E38\uFF0C\u672C\u6B21\u8BF7\u6C42\u672A\u5B8C\u6210\u3002\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF0C\u6216\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "transit") {
+    return "\u54CD\u5E94\u6D41\u4F20\u8F93\u5931\u8D25\uFF0C\u672C\u6B21\u8BF7\u6C42\u672A\u5B8C\u6210\u3002\u53EF\u80FD\u662F\u6A21\u578B\u670D\u52A1\u3001\u7F51\u5173\u4F20\u8F93\u6216\u672C\u5730\u517C\u5BB9\u5C42\u95EE\u9898\uFF1B\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF0C\u6216\u8FD0\u884C /model doctor \u548C /details evidence \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "timeout") {
+    return "\u7B49\u5F85\u6A21\u578B\u54CD\u5E94\u8FC7\u4E45\uFF0C\u672C\u6B21\u8BF7\u6C42\u672A\u5B8C\u6210\u3002\u7A0D\u540E\u91CD\u8BD5\uFF0C\u6216\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  if (kind === "abort") {
+    return "\u5DF2\u4E2D\u65AD\u672C\u6B21\u8BF7\u6C42\uFF0C\u53EF\u4EE5\u7EE7\u7EED\u8F93\u5165\u3002";
+  }
+  if (kind === "schema") {
+    return "\u6A21\u578B\u670D\u52A1\u62D2\u7EDD\u4E86\u8BF7\u6C42\u683C\u5F0F\uFF1A\u63A5\u53E3\u7C7B\u578B\u3001\u5DE5\u5177\u9009\u62E9\u3001\u5DE5\u5177\u7ED3\u679C\u6216\u63A8\u7406\u8BBE\u7F6E\u4E0D\u517C\u5BB9\u3002\u8BF7\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+  }
+  return "\u6A21\u578B\u8BF7\u6C42\u672A\u5B8C\u6210\u3002\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u540E\u91CD\u8BD5\u3002";
+}
+function formatProviderFallbackAttemptSummary(input, language) {
+  if (language === "en-US") {
+    return `Fallback attempt: the primary model failed with ${formatProviderFailureKindLabel(input.reasonKind, language)}; trying a backup model.`;
+  }
+  return `\u6B63\u5728\u5C1D\u8BD5\u5907\u7528\u6A21\u578B\uFF1A\u4E3B\u6A21\u578B\u56E0${formatProviderFailureKindLabel(input.reasonKind, language)}\u5931\u8D25\uFF0C\u6B63\u5728\u5207\u6362\u3002`;
+}
+function formatProviderFailureKindLabel(kind, language) {
+  const labels = {
+    rate_limit: { zh: "\u9650\u6D41", en: "rate limit" },
+    quota_or_balance_exhausted: { zh: "\u989D\u5EA6\u6216\u4F59\u989D\u4E0D\u8DB3", en: "quota or balance exhausted" },
+    schema: { zh: "\u8BF7\u6C42\u683C\u5F0F\u4E0D\u517C\u5BB9", en: "schema/tool compatibility" },
+    auth: { zh: "\u5BC6\u94A5\u6216\u6743\u9650\u95EE\u9898", en: "API key or permission" },
+    not_found: { zh: "\u63A5\u53E3\u6216\u6A21\u578B\u4E0D\u5B58\u5728", en: "endpoint or model not found" },
+    gateway: { zh: "\u670D\u52A1\u7AEF\u6216\u7F51\u5173\u5F02\u5E38", en: "server or gateway failure" },
+    transit: { zh: "\u4F20\u8F93\u5931\u8D25", en: "stream or transit failure" },
+    timeout: { zh: "\u54CD\u5E94\u8D85\u65F6", en: "timeout" },
+    abort: { zh: "\u8BF7\u6C42\u5DF2\u4E2D\u65AD", en: "interrupted request" },
+    reasoning_unsupported: { zh: "\u63A8\u7406\u8BBE\u7F6E\u4E0D\u517C\u5BB9", en: "reasoning settings unsupported" },
+    generic: { zh: "\u6A21\u578B\u8BF7\u6C42\u5931\u8D25", en: "model request failure" }
+  };
+  const label = labels[kind] ?? labels.generic;
+  return language === "en-US" ? label.en : label.zh;
+}
+function formatProviderEmptyResponsePrimary(language) {
+  return language === "en-US" ? "The model returned no answer. Run /model doctor for details, then retry." : "\u6A21\u578B\u6CA1\u6709\u8FD4\u56DE\u6709\u6548\u56DE\u7B54\u3002\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u540E\u91CD\u8BD5\u3002";
+}
+function formatProviderThinkingOnlyResponsePrimary(language) {
+  return language === "en-US" ? "The model returned a thinking stream but no final text. Retry, lower the reasoning level, or run /model doctor for details." : "\u6A21\u578B\u5DF2\u8FD4\u56DE\u601D\u8003\u6D41\u4F46\u6CA1\u6709\u6700\u7EC8\u6587\u672C\u3002\u8BF7\u91CD\u8BD5\u6216\u964D\u4F4E\u63A8\u7406\u7B49\u7EA7\uFF0C\u53EF\u8FD0\u884C /model doctor \u67E5\u770B\u8BE6\u60C5\u3002";
+}
+function formatReportEvidenceRequired(language) {
+  return language === "en-US" ? "Read key project evidence before writing the report. Mark missing README/package/config items as unconfirmed in the report." : "\u5199\u62A5\u544A\u524D\u9700\u8981\u5148\u8BFB\u53D6\u5173\u952E\u9879\u76EE\u8BC1\u636E\uFF1B\u672A\u53D1\u73B0 README/package/config \u65F6\uFF0C\u8BF7\u5728\u62A5\u544A\u4E2D\u6807\u8BB0\u4E3A\u672A\u786E\u8BA4\u3002";
+}
+function formatReportIncompletePrimary(path, language) {
+  return language === "en-US" ? `Report generation is blocked: no saved report was produced at ${path}.` : `\u62A5\u544A\u751F\u6210\u53D7\u963B\uFF1A\u5C1A\u672A\u5728 ${path} \u751F\u6210\u62A5\u544A\u6587\u4EF6\u3002`;
+}
+function classifyProviderFailure(error) {
+  const code = readStringField(error, "code");
+  const name = readStringField(error, "name");
+  const status = readNumberField(error, "status") ?? readNumberField(error, "statusCode");
+  const message = error instanceof Error ? error.message : readStringField(error, "message") ?? String(error ?? "");
+  const text = `${code ?? ""} ${name ?? ""} ${status ?? ""} ${message}`;
+  if (code === "PROVIDER_STREAM_DECODE_ERROR" || code === "PROVIDER_RETRY_EXHAUSTED" || code === "PROVIDER_NON_SSE_STREAM" || code === "PROVIDER_MALFORMED_STREAM" || code === "PROVIDER_PARTIAL_TOOL_CALL") {
+    return "transit";
+  }
+  if (code === "PROVIDER_QUOTA_EXHAUSTED" || /insufficient[_\s-]?quota|quota\s*(?:exhausted|exceeded|limit|reached)|credits?\s*(?:exhausted|used\s*up|insufficient|limit)|balance\s*(?:exhausted|insufficient|too\s*low|不足)|billing\s*(?:hard\s*limit|limit|required|payment)|payment[_\s-]?required|account\s+balance|余额不足|额度不足|欠费|充值/iu.test(
+    text
+  )) {
+    return "quota_or_balance_exhausted";
+  }
+  if (code === "PROVIDER_RATE_LIMITED" || status === 429 || /\brate\s*limit(?:ed)?\b|too many requests|请求过快|限流/iu.test(text)) {
+    return "rate_limit";
+  }
+  if (/thinking|extended_thinking|reasoning|unsupported_param|不支持.*推理|推理.*不支持/iu.test(text)) {
+    return "reasoning_unsupported";
+  }
+  if (/prompt[_\s-]?too[_\s-]?long|context[_\s-]?length|maximum context|input too large|上下文.*过长|提示词.*过长/iu.test(text)) {
+    return "schema";
+  }
+  if (/pdf[_\s-]?too[_\s-]?large|file too large|payload too large|request entity too large/iu.test(text)) {
+    return "schema";
+  }
+  if (/tool[_\s-]?use[_\s-]?mismatch|duplicate[_\s-]?tool[_\s-]?use[_\s-]?id|duplicate[_\s-]?tool[_\s-]?call|tool result.*mismatch|invalid tool_call_id/iu.test(text)) {
+    return "schema";
+  }
+  if (/overload|overloaded|server overloaded|capacity|temporarily overloaded|服务器.*过载/iu.test(text)) {
+    return "gateway";
+  }
+  if (/ssl|certificate|cert[_\s-]?error|tls handshake|self signed|证书/iu.test(text)) {
+    return "transit";
+  }
+  if (/crc|checksum|eventstream|event[-\s]?stream|stream\s*decode|decode\s*(?:error|failed|mismatch)|malformed\s*(?:sse|stream|chunk)|retry\s*exhausted|重试.*耗尽|流.*解码|解码.*失败/iu.test(
+    text
+  )) {
+    return "transit";
+  }
+  if (code === "PROVIDER_API_KEY_ERROR" || code === "PROVIDER_AUTH_ERROR" || status === 401 || status === 403 || /api\s*key|permission|forbidden|unauthorized|authentication|权限|鉴权|密钥/iu.test(text)) {
+    return "auth";
+  }
+  if (code === "PROVIDER_NOT_FOUND" || code === "MODEL_NOT_FOUND" || status === 404 || /not[_\s-]?found|model.*not.*found|endpoint.*not.*found|不存在|未找到/iu.test(text)) {
+    return "not_found";
+  }
+  if (/\b(?:502|503|504)\b/u.test(text) || code === "PROVIDER_SERVER_ERROR" || /an error occurred while processing your request|upstream.*(?:error|failed)|gateway.*(?:error|failed)|service unavailable/iu.test(
+    text
+  )) {
+    return "gateway";
+  }
+  if (/TIMEOUT|timeout|超时|等待.*过久/iu.test(text)) {
+    return "timeout";
+  }
+  if (/AbortError|aborted|abort|中断/iu.test(text) || code === "ABORT_ERR") {
+    return "abort";
+  }
+  if (code === "PROVIDER_BAD_REQUEST" || code === "MODEL_TOOLS_UNSUPPORTED" || code === "PROVIDER_PROFILE_MISMATCH" || /schema|tool_choice|tools?|tool_result|profile mismatch|endpointProfile|请求格式|工具.*不支持/iu.test(
+    text
+  )) {
+    return "schema";
+  }
+  if (code === "PROVIDER_STREAM_ERROR") {
+    return "transit";
+  }
+  return "generic";
+}
+function readStringField(value, key) {
+  if (!value || typeof value !== "object") return void 0;
+  const field = value[key];
+  return typeof field === "string" ? field : void 0;
+}
+function readNumberField(value, key) {
+  if (!value || typeof value !== "object") return void 0;
+  const field = value[key];
+  return typeof field === "number" ? field : void 0;
+}
+
+export {
+  formatRequestActivity,
+  formatProviderFailurePrimary,
+  formatProviderFallbackAttemptSummary,
+  formatProviderFailureKindLabel,
+  formatProviderEmptyResponsePrimary,
+  formatProviderThinkingOnlyResponsePrimary,
+  formatReportEvidenceRequired,
+  formatReportIncompletePrimary,
+  classifyProviderFailure
+};