@linghun/tui 0.1.0

package/dist/chunk-CRW3636S.js

@@ -0,0 +1,214 @@
+import {
+  classifyProviderVerificationLevel,
+  classifyRunnerVerificationLevel,
+  detectVerificationInflation
+} from "./chunk-CRSLDQOA.js";
+import {
+  detectRuntimePathInflation
+} from "./chunk-VIBENDE3.js";
+import {
+  validateChangeDeclaration
+} from "./chunk-HAEU6OTS.js";
+
+// src/guard-wiring.ts
+function formatRuntimePathDoctor(marker, language) {
+  if (marker.isMainPath) {
+    return {
+      id: "runtime-path",
+      label: language === "en-US" ? "TUI rendering" : "TUI \u6E32\u67D3",
+      ok: true,
+      summary: language === "en-US" ? "Ink main path active. TUI maturity claims are valid for this session." : "Ink \u4E3B\u8DEF\u5F84\u5DF2\u6FC0\u6D3B\u3002\u672C\u6B21\u4F1A\u8BDD\u7684 TUI \u6210\u719F\u5EA6\u58F0\u660E\u6709\u6548\u3002",
+      nextAction: language === "en-US" ? "No action needed for TUI path." : "TUI \u8DEF\u5F84\u65E0\u9700\u989D\u5916\u64CD\u4F5C\u3002"
+    };
+  }
+  const reason = explainDegradedReason(marker.degradedReason, language);
+  return {
+    id: "runtime-path",
+    label: language === "en-US" ? "TUI rendering" : "TUI \u6E32\u67D3",
+    ok: false,
+    summary: language === "en-US" ? `Fallback path "${marker.path}" is active. ${reason} TUI maturity cannot be claimed.` : `\u5F53\u524D\u4F7F\u7528\u964D\u7EA7\u8DEF\u5F84"${marker.path}"\u3002${reason}\u4E0D\u80FD\u58F0\u79F0 TUI \u5DF2\u6210\u719F\u3002`,
+    nextAction: language === "en-US" ? "Run in a real terminal with Ink support to verify TUI maturity." : "\u5728\u652F\u6301 Ink \u7684\u771F\u5B9E\u7EC8\u7AEF\u4E2D\u8FD0\u884C\u4EE5\u9A8C\u8BC1 TUI \u6210\u719F\u5EA6\u3002"
+  };
+}
+function formatStartupPathDoctor(marker, language) {
+  if (marker.isVerifiedCurrent) {
+    return {
+      id: "startup-path",
+      label: language === "en-US" ? "CLI entry" : "CLI \u5165\u53E3",
+      ok: true,
+      summary: language === "en-US" ? "Running from source. Verification results reflect current code." : "\u4ECE\u6E90\u7801\u8FD0\u884C\u3002\u9A8C\u8BC1\u7ED3\u679C\u53CD\u6620\u5F53\u524D\u4EE3\u7801\u3002",
+      nextAction: language === "en-US" ? "No action needed." : "\u65E0\u9700\u989D\u5916\u64CD\u4F5C\u3002"
+    };
+  }
+  return {
+    id: "startup-path",
+    label: language === "en-US" ? "CLI entry" : "CLI \u5165\u53E3",
+    ok: false,
+    summary: language === "en-US" ? `Entry kind "${marker.entryKind}" may be outdated. ${marker.staleReason ?? "Cannot confirm this is current code."}` : `\u5165\u53E3\u7C7B\u578B"${marker.entryKind}"\u53EF\u80FD\u5DF2\u8FC7\u65F6\u3002${translateStaleReason(marker.staleReason, language)}`,
+    nextAction: language === "en-US" ? "Rebuild or run from source to ensure verification reflects current code." : "\u91CD\u65B0\u6784\u5EFA\u6216\u4ECE\u6E90\u7801\u8FD0\u884C\uFF0C\u786E\u4FDD\u9A8C\u8BC1\u53CD\u6620\u5F53\u524D\u4EE3\u7801\u3002"
+  };
+}
+function formatVerificationLevelDoctor(classification, language) {
+  if (classification.canClaimMature) {
+    return {
+      id: "verification-level",
+      label: language === "en-US" ? "verification level" : "\u9A8C\u8BC1\u7B49\u7EA7",
+      ok: true,
+      summary: language === "en-US" ? "Real smoke verification achieved. Maturity claims are valid." : "\u5DF2\u8FBE\u5230\u771F\u5B9E smoke \u9A8C\u8BC1\u3002\u6210\u719F\u5EA6\u58F0\u660E\u6709\u6548\u3002",
+      nextAction: language === "en-US" ? "No action needed." : "\u65E0\u9700\u989D\u5916\u64CD\u4F5C\u3002"
+    };
+  }
+  const levelExplanation = explainLevel(classification.level, language);
+  const needed = explainRequiredForMature(classification.requiredForMature, language);
+  return {
+    id: "verification-level",
+    label: language === "en-US" ? "verification level" : "\u9A8C\u8BC1\u7B49\u7EA7",
+    ok: false,
+    summary: language === "en-US" ? `Current level: ${levelExplanation}. Cannot claim mature or production-ready.` : `\u5F53\u524D\u7B49\u7EA7\uFF1A${levelExplanation}\u3002\u4E0D\u80FD\u58F0\u79F0\u5DF2\u6210\u719F\u6216\u53EF\u4E0A\u7EBF\u3002`,
+    nextAction: language === "en-US" ? `Need: ${needed}` : `\u9700\u8981\uFF1A${needed}`
+  };
+}
+function formatRunnerGuardSummary(adapter, status, fallbackReason, language) {
+  const classification = classifyRunnerVerificationLevel(adapter, status, fallbackReason);
+  if (classification.canClaimMature) {
+    return language === "en-US" ? "Native runner completed successfully. Runner maturity verified." : "\u539F\u751F runner \u5DF2\u6210\u529F\u5B8C\u6210\u3002Runner \u6210\u719F\u5EA6\u5DF2\u9A8C\u8BC1\u3002";
+  }
+  if (adapter === "node" || fallbackReason) {
+    return language === "en-US" ? `Runner is using Node fallback${fallbackReason ? ` (${fallbackReason})` : ""}. This does not prove native runner maturity. Real native runner smoke is required.` : `Runner \u6B63\u5728\u4F7F\u7528 Node \u964D\u7EA7\u65B9\u6848${fallbackReason ? `\uFF08${fallbackReason}\uFF09` : ""}\u3002\u8FD9\u4E0D\u80FD\u8BC1\u660E\u539F\u751F runner \u5DF2\u6210\u719F\u3002\u9700\u8981\u771F\u5B9E\u539F\u751F runner smoke \u9A8C\u8BC1\u3002`;
+  }
+  return language === "en-US" ? `Runner status "${status}" is not a maturity proof. Real smoke verification is required.` : `Runner \u72B6\u6001"${status}"\u4E0D\u662F\u6210\u719F\u5EA6\u8BC1\u660E\u3002\u9700\u8981\u771F\u5B9E smoke \u9A8C\u8BC1\u3002`;
+}
+function formatProviderGuardSummary(input, language) {
+  const classification = classifyProviderVerificationLevel(input);
+  if (classification.canClaimMature) {
+    return language === "en-US" ? "Provider endpoint verified with real response. Provider readiness confirmed." : "Provider \u7AEF\u70B9\u5DF2\u901A\u8FC7\u771F\u5B9E\u54CD\u5E94\u9A8C\u8BC1\u3002Provider \u5C31\u7EEA\u72B6\u6001\u5DF2\u786E\u8BA4\u3002";
+  }
+  if (input.cooldownActive) {
+    return language === "en-US" ? "Provider is in cooldown. Cannot claim provider ready until cooldown expires and a real request succeeds." : "Provider \u6B63\u5728\u51B7\u5374\u4E2D\u3002\u51B7\u5374\u7ED3\u675F\u4E14\u771F\u5B9E\u8BF7\u6C42\u6210\u529F\u524D\uFF0C\u4E0D\u80FD\u58F0\u79F0 provider \u5DF2\u5C31\u7EEA\u3002";
+  }
+  if (input.mockUsed) {
+    return language === "en-US" ? "Provider verification used mocks. Real endpoint hit is required to confirm provider readiness." : "Provider \u9A8C\u8BC1\u4F7F\u7528\u4E86 mock\u3002\u9700\u8981\u771F\u5B9E\u7AEF\u70B9\u8BF7\u6C42\u6765\u786E\u8BA4 provider \u5C31\u7EEA\u72B6\u6001\u3002";
+  }
+  if (input.fallbackUsed) {
+    return language === "en-US" ? "Provider is using a fallback. Main provider path must succeed to claim readiness." : "Provider \u6B63\u5728\u4F7F\u7528\u964D\u7EA7\u65B9\u6848\u3002\u4E3B provider \u8DEF\u5F84\u5FC5\u987B\u6210\u529F\u624D\u80FD\u58F0\u79F0\u5C31\u7EEA\u3002";
+  }
+  return language === "en-US" ? "Provider status is inconclusive. A real endpoint request is needed." : "Provider \u72B6\u6001\u4E0D\u786E\u5B9A\u3002\u9700\u8981\u771F\u5B9E\u7AEF\u70B9\u8BF7\u6C42\u3002";
+}
+function validateCompletionClaim(claimedStatus, actualLevel, runtimePath, language) {
+  const warnings = [];
+  const levelInflation = detectVerificationInflation(claimedStatus, actualLevel);
+  if (levelInflation) {
+    warnings.push(
+      language === "en-US" ? `Cannot claim "${claimedStatus}": actual verification is ${explainLevel(actualLevel, "en-US")}. Real smoke is required for mature/ready claims.` : `\u4E0D\u80FD\u58F0\u79F0"${claimedStatus}"\uFF1A\u5B9E\u9645\u9A8C\u8BC1\u7B49\u7EA7\u4E3A${explainLevel(actualLevel, "zh-CN")}\u3002\u6210\u719F/\u5C31\u7EEA\u58F0\u660E\u9700\u8981\u771F\u5B9E smoke \u9A8C\u8BC1\u3002`
+    );
+  }
+  if (runtimePath) {
+    const pathInflation = detectRuntimePathInflation(claimedStatus, runtimePath);
+    if (pathInflation) {
+      warnings.push(
+        language === "en-US" ? `Cannot claim "${claimedStatus}": TUI is running on fallback path "${runtimePath.path}". Ink main path verification is required.` : `\u4E0D\u80FD\u58F0\u79F0"${claimedStatus}"\uFF1ATUI \u6B63\u5728\u964D\u7EA7\u8DEF\u5F84"${runtimePath.path}"\u4E0A\u8FD0\u884C\u3002\u9700\u8981 Ink \u4E3B\u8DEF\u5F84\u9A8C\u8BC1\u3002`
+      );
+    }
+  }
+  if (warnings.length === 0) {
+    return {
+      valid: true,
+      warnings: [],
+      humanSummary: language === "en-US" ? "Claim is consistent with available evidence." : "\u58F0\u660E\u4E0E\u73B0\u6709\u8BC1\u636E\u4E00\u81F4\u3002"
+    };
+  }
+  return {
+    valid: false,
+    warnings,
+    humanSummary: language === "en-US" ? `Claim "${claimedStatus}" cannot be made: ${warnings.length} issue(s) found.` : `\u4E0D\u80FD\u505A\u51FA"${claimedStatus}"\u58F0\u660E\uFF1A\u53D1\u73B0 ${warnings.length} \u4E2A\u95EE\u9898\u3002`
+  };
+}
+function validateChangeDeclarationHuman(declaration, language) {
+  const raw = validateChangeDeclaration(declaration);
+  return raw.map((warning) => translateDeclarationWarning(warning, language));
+}
+function explainDegradedReason(reason, language) {
+  if (!reason) return "";
+  if (reason === "non-tty-output") {
+    return language === "en-US" ? "Output is not a TTY (piped or redirected)." : "\u8F93\u51FA\u4E0D\u662F TTY\uFF08\u88AB\u7BA1\u9053\u6216\u91CD\u5B9A\u5411\uFF09\u3002";
+  }
+  if (reason === "ci-environment") {
+    return language === "en-US" ? "Running in CI environment." : "\u6B63\u5728 CI \u73AF\u5883\u4E2D\u8FD0\u884C\u3002";
+  }
+  if (reason === "ink-unavailable") {
+    return language === "en-US" ? "Ink renderer is not available." : "Ink \u6E32\u67D3\u5668\u4E0D\u53EF\u7528\u3002";
+  }
+  if (reason === "forced-legacy-by-config") {
+    return language === "en-US" ? "Legacy mode forced by configuration." : "\u914D\u7F6E\u5F3A\u5236\u4F7F\u7528 legacy \u6A21\u5F0F\u3002";
+  }
+  if (reason.startsWith("env-override=")) {
+    return language === "en-US" ? "Overridden by environment variable." : "\u88AB\u73AF\u5883\u53D8\u91CF\u8986\u76D6\u3002";
+  }
+  return language === "en-US" ? `Degraded: ${reason}.` : `\u964D\u7EA7\u539F\u56E0\uFF1A${reason}\u3002`;
+}
+function explainLevel(level, language) {
+  const map = {
+    mock: ["mock/simulated tests only", "\u4EC5 mock/\u6A21\u62DF\u6D4B\u8BD5"],
+    source: ["source code analysis only", "\u4EC5\u6E90\u7801\u5206\u6790"],
+    local: ["local test runner (vitest/jest)", "\u672C\u5730\u6D4B\u8BD5\u8FD0\u884C\u5668\uFF08vitest/jest\uFF09"],
+    build: ["build passed", "\u6784\u5EFA\u901A\u8FC7"],
+    "real-smoke": ["real smoke verified", "\u771F\u5B9E smoke \u5DF2\u9A8C\u8BC1"]
+  };
+  return language === "en-US" ? map[level][0] : map[level][1];
+}
+function explainRequiredForMature(required, language) {
+  if (required === "already-mature") {
+    return language === "en-US" ? "Already at mature level." : "\u5DF2\u8FBE\u5230\u6210\u719F\u7B49\u7EA7\u3002";
+  }
+  const parts = required.split("+");
+  const translated = parts.map((part) => {
+    if (part === "real-smoke-observation") {
+      return language === "en-US" ? "real process/provider/TUI observation" : "\u771F\u5B9E\u8FDB\u7A0B/provider/TUI \u89C2\u6D4B";
+    }
+    if (part === "main-path-execution") {
+      return language === "en-US" ? "main path execution (not fallback)" : "\u4E3B\u8DEF\u5F84\u6267\u884C\uFF08\u975E\u964D\u7EA7\uFF09";
+    }
+    if (part === "real-dependency-verification") {
+      return language === "en-US" ? "real dependency verification (not mocked)" : "\u771F\u5B9E\u4F9D\u8D56\u9A8C\u8BC1\uFF08\u975E mock\uFF09";
+    }
+    if (part === "real-smoke-required") {
+      return language === "en-US" ? "real smoke test execution" : "\u771F\u5B9E smoke \u6D4B\u8BD5\u6267\u884C";
+    }
+    return part;
+  });
+  return translated.join(language === "en-US" ? " + " : " + ");
+}
+function translateStaleReason(reason, _language) {
+  if (!reason) return "\u65E0\u6CD5\u786E\u8BA4\u662F\u5426\u4E3A\u5F53\u524D\u4EE3\u7801\u3002";
+  if (reason === "dist-may-be-outdated") return "dist \u6784\u5EFA\u53EF\u80FD\u5DF2\u8FC7\u65F6\u3002";
+  if (reason === "global-bin-may-be-outdated") return "\u5168\u5C40 bin \u94FE\u63A5\u53EF\u80FD\u5DF2\u8FC7\u65F6\u3002";
+  if (reason === "desktop-cmd-may-be-outdated") return "\u684C\u9762 cmd \u811A\u672C\u53EF\u80FD\u5DF2\u8FC7\u65F6\u3002";
+  if (reason === "unknown-entry-point") return "\u672A\u77E5\u5165\u53E3\u70B9\u3002";
+  return "\u65E0\u6CD5\u786E\u8BA4\u662F\u5426\u4E3A\u5F53\u524D\u4EE3\u7801\u3002";
+}
+function translateDeclarationWarning(warning, language) {
+  if (language === "en-US") return warning;
+  if (warning.includes("files list is empty")) {
+    return "\u53D8\u66F4\u58F0\u660E\u7F3A\u5931\uFF1A\u6587\u4EF6\u5217\u8868\u4E3A\u7A7A\u3002";
+  }
+  if (warning.includes("mainPath not specified")) {
+    return "\u53D8\u66F4\u58F0\u660E\u7F3A\u5931\uFF1A\u672A\u6307\u5B9A\u4E3B\u8DEF\u5F84\u3002";
+  }
+  if (warning.includes("verificationLevel not specified")) {
+    return "\u53D8\u66F4\u58F0\u660E\u7F3A\u5931\uFF1A\u672A\u6307\u5B9A\u9A8C\u8BC1\u7B49\u7EA7\u3002";
+  }
+  if (warning.includes("Large change")) {
+    return "\u5927\u6539\u52A8\uFF08>3 \u6587\u4EF6\uFF09\u672A\u58F0\u660E realSmokeRequired \u9879\u3002\u8BF7\u58F0\u660E\u54EA\u4E9B\u5185\u5BB9\u9700\u8981\u771F\u5B9E smoke \u9A8C\u8BC1\u3002";
+  }
+  return warning;
+}
+
+export {
+  formatRuntimePathDoctor,
+  formatStartupPathDoctor,
+  formatVerificationLevelDoctor,
+  formatRunnerGuardSummary,
+  formatProviderGuardSummary,
+  validateCompletionClaim,
+  validateChangeDeclarationHuman
+};

package/dist/chunk-D3UTL2QX.js

@@ -0,0 +1,86 @@
+import {
+  createShellTheme
+} from "./chunk-GC55DMZV.js";
+import {
+  fitText
+} from "./chunk-APJIC2O5.js";
+
+// src/shell/components/HelpPanel.tsx
+import { Box, Text, useInput } from "@linghun/ink-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
+var MAX_VISIBLE = 10;
+var HINT_TEXT = {
+  "zh-CN": {
+    title: "/help",
+    nav: "\u2191\u2193 \u9009\u62E9 \xB7 Enter \u6267\u884C \xB7 Tab/\u2190\u2192 \u5207\u6362\u5206\u7EC4 \xB7 Esc \u5173\u95ED",
+    groupCore: "\u6838\u5FC3",
+    groupAdvanced: "\u8FDB\u9636",
+    groupDetails: "\u8BE6\u60C5",
+    count: (start, end, total) => `\u7B2C ${start}-${end} \u9879\uFF0C\u5171 ${total} \u9879`
+  },
+  "en-US": {
+    title: "/help",
+    nav: "\u2191\u2193 select \xB7 Enter dispatch \xB7 Tab/\u2190\u2192 switch group \xB7 Esc close",
+    groupCore: "Core",
+    groupAdvanced: "Advanced",
+    groupDetails: "Details",
+    count: (start, end, total) => `${start}-${end} of ${total}`
+  }
+};
+function HelpPanel({
+  panel,
+  controller: _controller,
+  width: _width,
+  noColor,
+  language
+}) {
+  const theme = createShellTheme(noColor);
+  const hint = HINT_TEXT[language] ?? HINT_TEXT["zh-CN"];
+  useInput(() => void 0, { isActive: false });
+  const total = panel.entries.length;
+  const maxOffset = Math.max(0, total - MAX_VISIBLE);
+  const scrollOffset = Math.max(0, Math.min(panel.scrollOffset, maxOffset));
+  const visible = panel.entries.slice(scrollOffset, scrollOffset + MAX_VISIBLE);
+  const visibleEnd = Math.min(scrollOffset + MAX_VISIBLE, total);
+  const groupTabs = ["core", "advanced", "details"];
+  const accent = theme.help ?? theme.accent;
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 1, marginTop: 1, children: [
+    /* @__PURE__ */ jsx(Text, { color: accent, bold: true, children: fitText(hint.title, 76) }),
+    /* @__PURE__ */ jsx(Box, { marginTop: 1, children: groupTabs.map((g, i) => {
+      const active = g === panel.group;
+      const label = g === "core" ? hint.groupCore : g === "advanced" ? hint.groupAdvanced : hint.groupDetails;
+      return /* @__PURE__ */ jsxs(Box, { children: [
+        i > 0 ? /* @__PURE__ */ jsx(Text, { color: theme.dim ?? theme.muted, children: "  " }) : null,
+        active ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+          /* @__PURE__ */ jsx(Text, { color: accent, bold: true, children: label }),
+          /* @__PURE__ */ jsx(Text, { color: accent, children: "\u2500".repeat([...label].length) })
+        ] }) : /* @__PURE__ */ jsx(Text, { color: theme.muted, dimColor: true, children: label })
+      ] }, g);
+    }) }),
+    total > 0 ? /* @__PURE__ */ jsx(Text, { color: theme.dim ?? theme.muted, dimColor: true, children: hint.count(scrollOffset + 1, visibleEnd, total) }) : null,
+    /* @__PURE__ */ jsx(Text, { color: theme.dim ?? theme.muted, dimColor: true, children: fitText(hint.nav, 76) }),
+    total === 0 ? /* @__PURE__ */ jsx(Text, { color: theme.dim ?? theme.muted, dimColor: true, children: language === "en-US" ? "(no commands in this group)" : "\uFF08\u6B64\u5206\u7EC4\u6CA1\u6709\u547D\u4EE4\uFF09" }) : /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: visible.map((entry, vi) => {
+      const realIdx = scrollOffset + vi;
+      const active = realIdx === panel.cursor;
+      const slashWidth = Math.min(
+        22,
+        Math.max(12, ...panel.entries.map((e) => [...e.slash].length)) + 2
+      );
+      const slashCol = entry.slash.padEnd(slashWidth);
+      const line = `${active ? "\u25B8" : " "} ${slashCol}${entry.description}`;
+      return /* @__PURE__ */ jsx(
+        Text,
+        {
+          color: active ? accent : void 0,
+          bold: active,
+          children: fitText(line, 76)
+        },
+        entry.slash
+      );
+    }) })
+  ] });
+}
+
+export {
+  HelpPanel
+};

package/dist/chunk-D7TCSOAZ.js

@@ -0,0 +1,331 @@
+import {
+  applyModelSetupValues,
+  formatModelSetupFallbackError,
+  formatModelSetupMessage,
+  formatModelSetupSaved,
+  formatModelSetupSummary,
+  getModelSetupPromptMessage,
+  getNextModelSetupStep,
+  normalizeModelSetupReasoningLevel,
+  parseModelSetupPrefill
+} from "./chunk-NMNOAFFT.js";
+import {
+  showCommandPanel
+} from "./chunk-JO5ANTMR.js";
+import {
+  snapshotDeferredToolsSummary,
+  snapshotDiscoveredDeferredToolsSummary
+} from "./chunk-I3NTAIMF.js";
+import {
+  getContextWindowForModel
+} from "./chunk-K4FSYBSY.js";
+import {
+  getSelectedModelRuntime,
+  resolveInitialModel
+} from "./chunk-3LT6OWQ2.js";
+import {
+  formatModelRouteDoctor,
+  formatModelRouteSummary,
+  formatModelRoutes,
+  getRoleRoute,
+  isModelRole
+} from "./chunk-2YL5VKJ5.js";
+import {
+  writeLine
+} from "./chunk-OMZYPQVA.js";
+
+// src/model-command-runtime.ts
+import {
+  ensureProviderEnvTemplate,
+  getProviderEnvPath,
+  loadConfig,
+  providerEnvExists,
+  resolveModelSelection,
+  saveModelRoute,
+  saveProviderEnvSetup
+} from "@linghun/config";
+var runtimeDeps;
+function configureModelCommandRuntime(deps2) {
+  runtimeDeps = deps2;
+}
+function deps() {
+  if (!runtimeDeps) {
+    throw new Error("model-command-runtime deps not configured");
+  }
+  return runtimeDeps;
+}
+async function handleModelCommand(args, context, output) {
+  const action = args[0];
+  if (action === "route") {
+    await handleModelRouteCommand(args.slice(1), context, output);
+    return;
+  }
+  if (action === "setup") {
+    await startModelSetup(context, output);
+    return;
+  }
+  if (action === "doctor") {
+    const isEn2 = context.language === "en-US";
+    showCommandPanel(context, output, {
+      title: "/model doctor",
+      tone: "neutral",
+      summary: [
+        isEn2 ? "Model route doctor \u2014 Ctrl+O for full diagnostics." : "\u6A21\u578B\u8DEF\u7531\u8BCA\u65AD \u2014 Ctrl+O \u67E5\u770B\u5B8C\u6574\u8BCA\u65AD\u3002"
+      ],
+      detailsText: await formatModelRouteDoctor({
+        ...context,
+        deferredToolsSummary: snapshotDeferredToolsSummary(context),
+        discoveredDeferredToolsSummary: snapshotDiscoveredDeferredToolsSummary(context)
+      })
+    });
+    return;
+  }
+  if (action === "set") {
+    const model = args[1];
+    if (!model) {
+      writeLine(output, "\u7528\u6CD5\uFF1A/model set <model>");
+      return;
+    }
+    let resolved;
+    try {
+      resolved = resolveModelSelection(model, context.config.providers);
+    } catch (error) {
+      writeLine(output, `\u9519\u8BEF\uFF1A${error instanceof Error ? error.message : "\u6A21\u578B\u4E0D\u53EF\u7528\u3002"}`);
+      return;
+    }
+    context.config = await saveModelRoute("executor", model, context.projectPath);
+    context.model = resolved.model;
+    const route = getRoleRoute(context.config, "executor");
+    writeLine(
+      output,
+      `\u5DF2\u8BBE\u7F6E\u9ED8\u8BA4\u6A21\u578B\u4E3A ${resolved.model}\uFF08provider ${route.provider}\uFF0Crole executor\uFF09`
+    );
+    if (resolved.legacyAlias) {
+      writeLine(
+        output,
+        `\u8BF4\u660E\uFF1A${resolved.inputModel} \u662F legacy/display alias\uFF0C\u5DF2\u4FDD\u5B58\u4E3A ${resolved.model}`
+      );
+    }
+    if (context.config.defaultModel !== resolved.model) {
+      writeLine(
+        output,
+        `\u8BF4\u660E\uFF1Aexecutor role \u5DF2\u8BBE\u7F6E\u4E3A ${resolved.model}\uFF0Cdefault model ${context.config.defaultModel}`
+      );
+    }
+    return;
+  }
+  const runtime = getSelectedModelRuntime(context);
+  const isEn = context.language === "en-US";
+  const reasoningSegment = `reasoning ${runtime.reasoningStatus}`;
+  const contextWindow = getContextWindowForModel(runtime.model, {
+    maxInputTokens: getRoleRoute(context.config, runtime.role).maxInputTokens
+  });
+  const summary = [
+    isEn ? `Model \xB7 ${runtime.provider}/${runtime.model}` : `\u6A21\u578B \xB7 ${runtime.provider}/${runtime.model}`,
+    isEn ? `Role: ${runtime.role} \xB7 ${reasoningSegment}` : `\u89D2\u8272\uFF1A${runtime.role} \xB7 ${reasoningSegment}`,
+    isEn ? `Context window: ${formatModelWindow(contextWindow)}` : `\u4E0A\u4E0B\u6587\u7A97\u53E3\uFF1A${formatModelWindow(contextWindow)}`
+  ];
+  if (context.config.defaultModel && context.config.defaultModel !== runtime.model) {
+    summary.push(
+      isEn ? `default model ${context.config.defaultModel} (executor stays on ${runtime.model})` : `default model ${context.config.defaultModel}\uFF08\u5B9E\u9645 executor ${runtime.model}\uFF09`
+    );
+  }
+  showCommandPanel(context, output, {
+    title: "/model",
+    tone: "neutral",
+    summary,
+    actions: ["/model doctor", "/model route", "/model setup"],
+    detailsText: `${deps().currentModelText(context)}\uFF1Arole ${runtime.role} provider ${runtime.provider} model ${runtime.model} ${reasoningSegment}; contextWindow ${contextWindow}
+
+Aliases: deepseek-v4-flash -> deepseek-chat; deepseek-v4-pro -> deepseek-reasoner
+
+${formatModelRouteSummary(context.config)}`
+  });
+}
+function formatModelWindow(tokens) {
+  return tokens >= 1e3 ? `${Math.round(tokens / 1e3)}k tokens` : `${tokens} tokens`;
+}
+async function startModelSetup(context, output, prefill = {}) {
+  const existed = await providerEnvExists();
+  const providerEnvPath = existed ? getProviderEnvPath() : await ensureProviderEnvTemplate();
+  const values = { reasoningLevel: "Medium", ...prefill };
+  context.pendingModelSetup = {
+    step: getNextModelSetupStep(values),
+    providerEnvPath,
+    createdTemplate: !existed,
+    values
+  };
+  writeLine(output, formatModelSetupMessage("intro", context.language, context.pendingModelSetup));
+  if (context.pendingModelSetup.step === "confirm") {
+    writeLine(output, formatModelSetupSummary(context.pendingModelSetup, context.language));
+    return;
+  }
+  writeLine(output, getModelSetupPromptMessage(context.pendingModelSetup, context.language));
+}
+async function handleModelSetupInput(text, context, output) {
+  const setup = context.pendingModelSetup;
+  if (!setup) return;
+  const trimmed = text.trim();
+  const value = setup.step === "apiKey" ? text : trimmed;
+  if (/^(cancel|no|n|取消|否)$/iu.test(trimmed)) {
+    context.pendingModelSetup = void 0;
+    writeLine(output, formatModelSetupMessage("cancelled", context.language, setup));
+    return;
+  }
+  if (/^(details|detail|详情)$/iu.test(trimmed)) {
+    writeLine(output, formatModelSetupMessage("details", context.language, setup));
+    writeLine(output, getModelSetupPromptMessage(setup, context.language));
+    return;
+  }
+  try {
+    const parsed = parseModelSetupPrefill(text);
+    if (Object.keys(parsed).length > 0) {
+      applyModelSetupValues(setup, parsed);
+      setup.step = getNextModelSetupStep(setup.values);
+      if (setup.step === "confirm") {
+        writeLine(output, formatModelSetupSummary(setup, context.language));
+        return;
+      }
+      writeLine(output, getModelSetupPromptMessage(setup, context.language));
+      return;
+    }
+    if (setup.step === "baseUrl") {
+      applyModelSetupValues(setup, { baseUrl: value });
+      setup.step = "apiKey";
+      writeLine(output, getModelSetupPromptMessage(setup, context.language));
+      return;
+    }
+    if (setup.step === "apiKey") {
+      applyModelSetupValues(setup, { apiKey: value });
+      setup.step = "model";
+      writeLine(output, getModelSetupPromptMessage(setup, context.language));
+      return;
+    }
+    if (setup.step === "model") {
+      applyModelSetupValues(setup, { model: value });
+      setup.step = "reasoning";
+      writeLine(output, getModelSetupPromptMessage(setup, context.language));
+      return;
+    }
+    if (setup.step === "reasoning") {
+      applyModelSetupValues(setup, {
+        reasoningLevel: normalizeModelSetupReasoningLevel(value || "Medium")
+      });
+      setup.step = "auxModel";
+      writeLine(output, getModelSetupPromptMessage(setup, context.language));
+      return;
+    }
+    if (setup.step === "auxModel") {
+      applyModelSetupValues(setup, { auxModel: value || void 0 });
+      setup.step = "confirm";
+      writeLine(output, formatModelSetupSummary(setup, context.language));
+      return;
+    }
+    if (setup.step === "confirm") {
+      if (/^(yes|y|save|ok|confirm|确认|保存|是)$/iu.test(value)) {
+        const savedPath = await saveProviderEnvSetup(setup.values);
+        context.pendingModelSetup = void 0;
+        context.config = await loadConfig(context.projectPath);
+        context.model = resolveInitialModel(context.config);
+        writeLine(output, formatModelSetupSaved(savedPath, context.language));
+        return;
+      }
+      context.pendingModelSetup = void 0;
+      writeLine(output, formatModelSetupMessage("cancelled", context.language, setup));
+      return;
+    }
+  } catch (error) {
+    writeLine(
+      output,
+      error instanceof Error ? error.message : formatModelSetupFallbackError(context.language)
+    );
+    writeLine(output, getModelSetupPromptMessage(setup, context.language));
+  }
+}
+async function handleModelRouteCommand(args, context, output) {
+  const action = args[0];
+  if (!action) {
+    const isEn = context.language === "en-US";
+    showCommandPanel(context, output, {
+      title: "/model route",
+      tone: "neutral",
+      summary: [
+        isEn ? `Model routes \xB7 ${context.config.modelRoutes.routes.length} roles \u2014 Ctrl+O for details.` : `\u6A21\u578B\u8DEF\u7531 \xB7 ${context.config.modelRoutes.routes.length} \u4E2A\u89D2\u8272 \u2014 Ctrl+O \u67E5\u770B\u8BE6\u60C5\u3002`
+      ],
+      actions: ["/model route doctor"],
+      detailsText: formatModelRoutes(context.config)
+    });
+    return;
+  }
+  if (action === "doctor") {
+    const isEn = context.language === "en-US";
+    showCommandPanel(context, output, {
+      title: "/model route doctor",
+      tone: "neutral",
+      summary: [
+        isEn ? "Model route doctor \u2014 Ctrl+O for full diagnostics." : "\u6A21\u578B\u8DEF\u7531\u8BCA\u65AD \u2014 Ctrl+O \u67E5\u770B\u5B8C\u6574\u8BCA\u65AD\u3002"
+      ],
+      detailsText: await formatModelRouteDoctor({
+        ...context,
+        deferredToolsSummary: snapshotDeferredToolsSummary(context),
+        discoveredDeferredToolsSummary: snapshotDiscoveredDeferredToolsSummary(context)
+      })
+    });
+    return;
+  }
+  if (action === "set") {
+    const role = args[1];
+    const model = args[2];
+    if (!role || !isModelRole(role) || !model) {
+      writeLine(
+        output,
+        "\u7528\u6CD5\uFF1A/model route set <planner|executor|reviewer|verifier|summarizer|vision|image> <model>"
+      );
+      return;
+    }
+    let resolved;
+    try {
+      resolved = resolveModelSelection(model, context.config.providers);
+    } catch (error) {
+      writeLine(output, `\u9519\u8BEF\uFF1A${error instanceof Error ? error.message : "\u6A21\u578B\u4E0D\u53EF\u7528\u3002"}`);
+      return;
+    }
+    context.config = await saveModelRoute(role, model, context.projectPath);
+    const route = getRoleRoute(context.config, role);
+    if (role === "executor") {
+      context.model = route.primaryModel || context.model;
+    }
+    writeLine(
+      output,
+      `\u5DF2\u8BBE\u7F6E ${role} role\uFF1Aprovider ${route.provider || "\u672A\u914D\u7F6E"} model ${route.primaryModel || "\u672A\u914D\u7F6E"}`
+    );
+    if (resolved.legacyAlias) {
+      writeLine(
+        output,
+        `\u8BF4\u660E\uFF1A${resolved.inputModel} \u662F legacy/display alias\uFF0C\u5DF2\u4FDD\u5B58\u4E3A ${resolved.model}`
+      );
+    }
+    if (role === "executor" && context.config.defaultModel !== route.primaryModel) {
+      writeLine(
+        output,
+        `\u8BF4\u660E\uFF1Adefault model ${context.config.defaultModel}\uFF0C\u666E\u901A\u5F00\u53D1\u8BF7\u6C42\u5C06\u6309 executor route ${route.provider}/${route.primaryModel} \u6267\u884C\u3002`
+      );
+    }
+    if (role === "vision") {
+      writeLine(output, "vision role \u53EA\u8F93\u51FA VisionObservation evidence\uFF0C\u4E0D\u5199\u4EE3\u7801\u3001\u4E0D\u6267\u884C Bash\u3002");
+    }
+    if (role === "image") {
+      writeLine(output, "image role \u53EA\u751F\u6210\u672C\u5730\u8D44\u4EA7\u8DEF\u5F84\u548C evidence\uFF0C\u4E0D\u6539\u4EE3\u7801\u3001\u4E0D\u6267\u884C Bash\u3002");
+    }
+    return;
+  }
+  writeLine(output, "\u7528\u6CD5\uFF1A/model route | /model route doctor | /model route set <role> <model>");
+}
+
+export {
+  configureModelCommandRuntime,
+  handleModelCommand,
+  startModelSetup,
+  handleModelSetupInput,
+  handleModelRouteCommand
+};