dsh-loop-engine 1.0.0-rc5 → 1.0.0-rc7

package/README.md

@@ -4,8 +4,8 @@
 
 Switch the agent loop engine of **dsh web** the same way you switch a model: a
 "Loop engine" dropdown in Settings chooses which driver runs your agents — the
-built-in in-process loop, the Claude Code CLI, the Codex CLI, or the Pi CLI —
-without changing anything in the main repository.
+built-in in-process loop, the Claude Code CLI, the Codex CLI, the Pi CLI, or the
+Kimi Code CLI — without changing anything in the main repository.
 
 ## Install
 
@@ -28,11 +28,14 @@ Restart `dsh web`, then open **Settings → Loop engine**.
 - For the Pi engine: authenticated the way `pi` expects (its own
   `~/.pi/agent/auth.json` or the provider's API-key environment variable such as
   `ANTHROPIC_API_KEY`).
+- For the Kimi Code engine: the `kimi` CLI installed and logged in on the host
+  (e.g. `kimi login`), and reachable on `PATH` (or pinned to an absolute path
+  via `kimiBin` in the composition entry).
 
 ## Usage
 
 1. Pick an engine in **Settings → Loop engine** — `in-process` (default),
-   `claude-code`, `codex`, or `pi` — then restart `dsh web`.
+   `claude-code`, `codex`, `pi`, or `kimi` — then restart `dsh web`.
 2. To return to the default, pick **In-process** and restart again.
 3. To remove the plugin: `dsh plugin --profile web remove dsh-loop-engine`, then
    restart `dsh web`.
@@ -54,6 +57,24 @@ Restart `dsh web`, then open **Settings → Loop engine**.
   preferred, plus the user-level file under the pi config dir) and its
   `skills/` catalogs (`~/.pi/agent/skills/` and `.pi/skills/`) are surfaced
   through the dsh skill-injection seam.
+- The Kimi Code driver runs a persistent `kimi acp` child (Agent Client
+  Protocol over stdio) and speaks one stateless `session/new` + `session/prompt`
+  per dsh step; the durable dsh session log is the sole model context. It streams
+  assistant text (`agent_message_chunk`) and thinking (`agent_thought_chunk`)
+  incrementally into the log, and maps tool calls/streams (`tool_call` /
+  `tool_call_update`) into `tool/call` + `tool/result`. ACP surfaces tool
+  approvals as `session/request_permission`, which the driver answers from the
+  session's dsh approval knobs (an `ask` policy denies, fail-closed). The child
+  is spawned through the dsh subprocess seam — the only privilege boundary
+  (default read-only sandbox). Its project `AGENTS.md` chain (cwd→git root) and
+  `.kimi-code/skills/` catalogs (user and project) are surfaced through the dsh
+  skill-injection seam, and its slash commands are bridged (built-ins forward the
+  raw `/name` line back to the engine, which expands it). The prompt is an ACP
+  request body — not an argv positional — so there is no command-line length
+  ceiling. Note Kimi's remaining slash-command surface is TUI-only
+  (`/login`, `/provider`, `/settings`, `/sessions`, …); those are not bridged
+  because the ACP prompt surface does not expand them, but `skill:` commands are
+  carried by the skill seam and Kimi's own shorthand.
 
 ## License
 

package/README.zh.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/dsh-loop-engine?color=cb3837)](https://www.npmjs.com/package/dsh-loop-engine)
 
-像切换模型一样切换 **dsh web** 的 agent 循环引擎:设置页的「Loop engine」下拉选择运行 agent 的驱动——内置 in-process 循环、Claude Code CLI、Codex CLI,或 Pi CLI——**无需改动主仓库**。
+像切换模型一样切换 **dsh web** 的 agent 循环引擎:设置页的「Loop engine」下拉选择运行 agent 的驱动——内置 in-process 循环、Claude Code CLI、Codex CLI、Pi CLI,或 Kimi Code CLI——**无需改动主仓库**。
 
 ## 安装
 
@@ -19,10 +19,11 @@ dsh plugin --profile web add dsh-loop-engine
 - 使用 Claude Code 引擎时需要本机已安装并登录 Claude Code CLI。
 - 使用 Codex 引擎时需要完成认证:本机执行过 `codex login`,或配置 `CODEX_API_KEY` 环境变量。
 - 使用 Pi 引擎时需要以 `pi` 要求的方式完成认证(其自身的 `~/.pi/agent/auth.json`,或提供方的 API-key 环境变量,如 `ANTHROPIC_API_KEY`)。
+- 使用 Kimi Code 引擎时需要本机已安装并登录 `kimi` CLI(例如 `kimi login`),且在 `PATH` 上(或在组合条目里用 `kimiBin` 固定为绝对路径)。
 
 ## 使用方法
 
-1. 在 **Settings → Loop engine** 选择引擎——`in-process`(默认)、`claude-code`、`codex` 或 `pi`——然后重启 `dsh web`。
+1. 在 **Settings → Loop engine** 选择引擎——`in-process`(默认)、`claude-code`、`codex`、`pi` 或 `kimi`——然后重启 `dsh web`。
 2. 要切回默认,选 **In-process** 再重启即可。
 3. 卸载插件:`dsh plugin --profile web remove dsh-loop-engine`,然后重启 `dsh web`。
 
@@ -30,7 +31,7 @@ dsh plugin --profile web add dsh-loop-engine
 
 - Codex 驱动运行 `codex app-server`,没有交互式工具审批——权限来自会话的 `sandboxMode` + `approvalPolicy`。
 - Pi 驱动运行 `pi --mode rpc`;Pi 没有权限系统,所以整个子进程经 dsh subprocess 服务做沙箱化(默认 `read-only`)。
-- 两者都往会话日志流式输出,并通过 dsh 技能注入接口暴露 `AGENTS.md`。
+- Kimi Code 驱动运行一个常驻的 `kimi acp` 子进程(Agent Client Protocol over stdio),每步一次无状态的 `session/new` + `session/prompt`;durable 会话日志是唯一模型上下文。它把助手文本(`agent_message_chunk`)与**思考**(`agent_thought_chunk`)**增量**写入日志,并把工具调用/流(`tool_call` / `tool_call_update`)映射为 `tool/call` + `tool/result`。ACP 通过 `session/request_permission` 暴露工具审批,驱动根据会话的 dsh 审批旋钮应答(ask 策略拒绝,失败关闭)。子进程经 dsh subprocess seam 拉起——唯一权限边界(默认只读沙箱)。其项目 `AGENTS.md` 链(cwd→git 根)与 `.kimi-code/skills/` 目录(用户与项目)通过 dsh 技能注入接口暴露,其斜杠命令也已桥接(内置命令把原始 `/name` 行转发回引擎展开)。prompt 是 ACP 请求体而非 argv 位置参数,因此**不存在命令行长度上限**。注意 Kimi 剩余的斜杠命令面是纯 TUI(`/login`、`/provider`、`/settings`、`/sessions`…),这些不桥接(ACP prompt 面不扩展它们);`skill:` 命令由技能接口与 kimi 自身的 shorthand 承载。
 
 ## License
 

package/lib/client.js

@@ -34,7 +34,8 @@ var ENGINE_OPTIONS = [
   { value: "in-process", key: "engineInProcess" },
   { value: "claude-code", key: "engineClaudeCode" },
   { value: "codex", key: "engineCodex" },
-  { value: "pi", key: "enginePi" }
+  { value: "pi", key: "enginePi" },
+  { value: "kimi", key: "engineKimi" }
 ];
 function engineLabelKey(engine) {
   switch (engine) {
@@ -44,6 +45,8 @@ function engineLabelKey(engine) {
       return "engineCodex";
     case "pi":
       return "enginePi";
+    case "kimi":
+      return "engineKimi";
     default:
       return "engineInProcess";
   }
@@ -236,7 +239,7 @@ function LoopEngineBadge(props) {
   const { status, engine } = useSnapshot((state) => state);
   if (status !== "ready") return null;
   const label = t(
-    engine === "claude-code" ? "engineClaudeCode" : engine === "codex" ? "engineCodex" : engine === "pi" ? "enginePi" : "engineInProcess"
+    engine === "claude-code" ? "engineClaudeCode" : engine === "codex" ? "engineCodex" : engine === "pi" ? "enginePi" : engine === "kimi" ? "engineKimi" : "engineInProcess"
   );
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { style: pill, title: t("description"), children: [
     t("nav"),
@@ -253,7 +256,8 @@ var ENGINE_OPTIONS2 = [
   { value: "in-process", key: "engineInProcess" },
   { value: "claude-code", key: "engineClaudeCode" },
   { value: "codex", key: "engineCodex" },
-  { value: "pi", key: "enginePi" }
+  { value: "pi", key: "enginePi" },
+  { value: "kimi", key: "engineKimi" }
 ];
 function engineLabelKey2(engine) {
   switch (engine) {
@@ -263,28 +267,69 @@ function engineLabelKey2(engine) {
       return "engineCodex";
     case "pi":
       return "enginePi";
+    case "kimi":
+      return "engineKimi";
     default:
       return "engineInProcess";
   }
 }
+function engineGlyph(engine, size = 16) {
+  switch (engine) {
+    case "claude-code":
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", "aria-hidden": true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { fill: "currentColor", d: "M21 10.5h3v3h-3v3h-1.5v3H18v-3h-1.5v3H15v-3H9v3H7.5v-3H6v3H4.5v-3H3v-3H0v-3h3v-6h18Zm-15 0h1.5v-3H6Zm10.5 0H18v-3h-1.5z" }) });
+    case "codex":
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("svg", { width: size, height: size, viewBox: "0 0 256 260", fill: "none", "aria-hidden": true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { fill: "currentColor", d: "M239.183914,106.202783 C245.054304,88.5242096 243.02228,69.1733805 233.607599,53.0998864 C219.451678,28.4588021 190.999703,15.7836129 163.213007,21.739505 C147.554077,4.32145883 123.794909,-3.42398554 100.87901,1.41873898 C77.9631105,6.26146349 59.3690093,22.9572536 52.0959621,45.2214219 C33.8436494,48.9644867 18.0901721,60.392749 8.86672513,76.5818033 C-5.443491,101.182962 -2.19544431,132.215255 16.8986662,153.320094 C11.0060865,170.990656 13.0197283,190.343991 22.4238231,206.422991 C36.5975553,231.072344 65.0680342,243.746566 92.8695738,237.783372 C105.235639,251.708249 123.001113,259.630942 141.623968,259.52692 C170.105359,259.552169 195.337611,241.165718 204.037777,214.045661 C222.28734,210.296356 238.038489,198.869783 247.267014,182.68528 C261.404453,158.127515 258.142494,127.262775 239.183914,106.202783 L239.183914,106.202783 Z M141.623968,242.541207 C130.255682,242.559177 119.243876,238.574642 110.519381,231.286197 L112.054146,230.416496 L163.724595,200.590881 C166.340648,199.056444 167.954321,196.256818 167.970781,193.224005 L167.970781,120.373788 L189.815614,133.010026 C190.034132,133.121423 190.186235,133.330564 190.224885,133.572774 L190.224885,193.940229 C190.168603,220.758427 168.442166,242.484864 141.623968,242.541207 Z M37.1575749,197.93062 C31.456498,188.086359 29.4094818,176.546984 31.3766237,165.342426 L32.9113895,166.263285 L84.6329973,196.088901 C87.2389349,197.618207 90.4682717,197.618207 93.0742093,196.088901 L156.255402,159.663793 L156.255402,184.885111 C156.243557,185.149771 156.111725,185.394602 155.89729,185.550176 L103.561776,215.733903 C80.3054953,229.131632 50.5924954,221.165435 37.1575749,197.93062 Z M23.5493181,85.3811273 C29.2899861,75.4733097 38.3511911,67.9162648 49.1287482,64.0478825 L49.1287482,125.438515 C49.0891492,128.459425 50.6965386,131.262556 53.3237748,132.754232 L116.198014,169.025864 L94.3531808,181.662102 C94.1132325,181.789434 93.8257461,181.789434 93.5857979,181.662102 L41.3526015,151.529534 C18.1419426,138.076098 10.1817681,108.385562 23.5493181,85.125333 L23.5493181,85.3811273 Z M203.0146,127.075598 L139.935725,90.4458545 L161.7294,77.8607748 C161.969348,77.7334434 162.256834,77.7334434 162.496783,77.8607748 L214.729979,108.044502 C231.032329,117.451747 240.437294,135.426109 238.871504,154.182739 C237.305714,172.939368 225.050719,189.105572 207.414262,195.67963 L207.414262,134.288998 C207.322521,131.276867 205.650697,128.535853 203.0146,127.075598 Z M224.757116,94.3850867 L223.22235,93.4642272 L171.60306,63.3828173 C168.981293,61.8443751 165.732456,61.8443751 163.110689,63.3828173 L99.9806554,99.8079259 L99.9806554,74.5866077 C99.9533004,74.3254088 100.071095,74.0701869 100.287609,73.9215426 L152.520805,43.7889738 C168.863098,34.3743518 189.174256,35.2529043 204.642579,46.0434841 C220.110903,56.8340638 227.949269,75.5923959 224.757116,94.1804513 L224.757116,94.3850867 Z M88.0606409,139.097931 L66.2158076,126.512851 C65.9950399,126.379091 65.8450965,126.154176 65.8065367,125.898945 L65.8065367,65.684966 C65.8314495,46.8285367 76.7500605,29.6846032 93.8270852,21.6883055 C110.90411,13.6920079 131.063833,16.2835462 145.5632,28.338998 L144.028434,29.2086986 L92.3579852,59.0343142 C89.7419327,60.5687513 88.1282597,63.3683767 88.1117998,66.4011901 L88.0606409,139.097931 Z M99.9294965,113.5185 L128.06687,97.3011417 L156.255402,113.5185 L156.255402,145.953218 L128.169187,162.170577 L99.9806554,145.953218 L99.9294965,113.5185 Z" }) });
+    case "pi":
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("svg", { width: size, height: size, viewBox: "0 0 800 800", fill: "none", "aria-hidden": true, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { fill: "currentColor", fillRule: "evenodd", d: "M165.29 165.29H517.36V400H400V517.36H282.65V634.72H165.29ZM282.65 282.65V400H400V282.65Z" }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { fill: "currentColor", d: "M517.36 400H634.72V634.72H517.36Z" })
+      ] });
+    case "kimi":
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", "aria-hidden": true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { fill: "currentColor", d: "M6 3h2.6v6.5L14.4 3h3.4l-5.6 7.4L17.8 21h-3.4l-5.9-8v8H6z" }) });
+    default:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_dsh_client_ui_primitives2.FishLogo, { size });
+  }
+}
 var trigger2 = {
   appearance: "none",
   boxSizing: "border-box",
   display: "inline-flex",
   alignItems: "center",
-  gap: 6,
-  padding: "4px 8px",
-  border: "1px solid var(--dsw-alias-border-l2)",
-  borderRadius: 10,
-  background: "var(--dsw-alias-bg-layer-1)",
-  color: "var(--dsw-alias-label-primary)",
+  gap: 4,
+  minWidth: 0,
+  maxWidth: 220,
+  height: 28,
+  padding: "0 4px 0 8px",
+  border: "none",
+  borderRadius: 24,
+  outline: "none",
+  background: "transparent",
+  color: "var(--dsw-alias-label-secondary)",
   font: "inherit",
-  fontSize: 12,
+  fontSize: 13,
   lineHeight: "20px",
-  whiteSpace: "nowrap",
+  fontWeight: 500,
   cursor: "pointer"
 };
-var triggerDisabled2 = { ...trigger2, opacity: 0.5, cursor: "default" };
+var triggerHover = { ...trigger2, background: "var(--dsw-alias-interactive-bg-hover)" };
+var triggerDisabled2 = { ...trigger2, color: "var(--dsw-alias-label-dimmed)", cursor: "default" };
+var triggerIcon = {
+  display: "inline-flex",
+  flex: "0 0 auto"
+};
+var triggerLabel = {
+  minWidth: 0,
+  overflow: "hidden",
+  textOverflow: "ellipsis",
+  whiteSpace: "nowrap"
+};
+var chevron = {
+  display: "inline-flex",
+  flex: "0 0 auto",
+  color: "var(--dsw-alias-label-caption)",
+  transition: "transform 120ms ease"
+};
+var chevronOpen = { ...chevron, transform: "rotate(180deg)" };
 var confirmBody2 = {
   margin: 0,
   fontSize: 13,
@@ -295,6 +340,7 @@ function LoopEngineComposerSelect(props) {
   const { controller, useSnapshot, t } = props;
   const { status, engine, showInComposer, writable } = useSnapshot((snapshot) => snapshot);
   const [open, setOpen] = (0, import_react2.useState)(false);
+  const [hovered, setHovered] = (0, import_react2.useState)(false);
   const [pending, setPending] = (0, import_react2.useState)(null);
   const triggerRef = (0, import_react2.useRef)(null);
   if (status !== "ready" || !showInComposer) return null;
@@ -327,7 +373,11 @@ function LoopEngineComposerSelect(props) {
         onClose: () => {
           setOpen(false);
         },
-        items: ENGINE_OPTIONS2.map((option) => ({ id: option.value, label: t(option.key) })),
+        items: ENGINE_OPTIONS2.map((option) => ({
+          id: option.value,
+          label: t(option.key),
+          icon: engineGlyph(option.value)
+        })),
         selectedId: engine,
         onSelect,
         align: "start",
@@ -341,14 +391,21 @@ function LoopEngineComposerSelect(props) {
             "aria-haspopup": "menu",
             "aria-expanded": open,
             disabled,
-            style: disabled ? triggerDisabled2 : trigger2,
+            style: disabled ? triggerDisabled2 : hovered ? triggerHover : trigger2,
             title,
+            onMouseEnter: () => {
+              setHovered(true);
+            },
+            onMouseLeave: () => {
+              setHovered(false);
+            },
             onClick: () => {
               setOpen(!open);
             },
             children: [
-              label,
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_dsh_client_ui_primitives2.IconChevronDownOutline14, { size: 14 })
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { style: triggerIcon, "aria-hidden": true, children: engineGlyph(engine, 14) }),
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { style: triggerLabel, children: label }),
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { style: open ? chevronOpen : chevron, "aria-hidden": true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_dsh_client_ui_primitives2.IconChevronDownOutline14, { size: 14 }) })
             ]
           }
         )
@@ -375,7 +432,7 @@ var import_client = require("@deepseek-ai/dsh-client-runtime/client");
 function decodeLoopEngine(section) {
   if (typeof section !== "object" || section === null || Array.isArray(section)) return void 0;
   const { engine, showInComposer } = section;
-  if (engine !== "in-process" && engine !== "claude-code" && engine !== "codex" && engine !== "pi") {
+  if (engine !== "in-process" && engine !== "claude-code" && engine !== "codex" && engine !== "pi" && engine !== "kimi") {
     return void 0;
   }
   return { engine, showInComposer: showInComposer !== false };
@@ -514,6 +571,7 @@ var zh = {
   engineClaudeCode: "Claude Code CLI",
   engineCodex: "Codex CLI",
   enginePi: "Pi CLI",
+  engineKimi: "Kimi Code CLI",
   showInComposerLabel: "\u5728\u5BF9\u8BDD\u9875\u663E\u793A\u5F15\u64CE\u9009\u62E9\u5668",
   unavailable: "\u5FAA\u73AF\u5F15\u64CE\u8BBE\u7F6E\u4E0D\u53EF\u7528",
   switchNotice: "\u5207\u6362\u5F15\u64CE\u4F1A\u4E2D\u65AD\u5F53\u524D\u4F7F\u7528\u65E7\u5F15\u64CE\u8FD0\u884C\u4E2D\u7684\u4F1A\u8BDD\u3002",
@@ -531,6 +589,7 @@ var en = {
   engineClaudeCode: "Claude Code CLI",
   engineCodex: "Codex CLI",
   enginePi: "Pi CLI",
+  engineKimi: "Kimi Code CLI",
   showInComposerLabel: "Show the engine selector in the chat page",
   unavailable: "Loop engine settings are unavailable",
   switchNotice: "Switching engines interrupts sessions currently running on the previous engine.",