aiterm-mcp 0.3.1 → 0.4.0

package/README.ja.md

@@ -179,7 +179,7 @@ claude mcp add --scope user --transport stdio aiterm -- aiterm-mcp
 
 ## 既知の制約（バグではなく仕様）
 
-- **ネスト中（ssh / docker / REPL）は quiescence が原理的に効かない。** 前面コマンドがシェル集合（bash/sh/zsh/fish/dash）の外になるため。完了検出は `until`（プロンプト等の正規表現）か `mark: true`（終了コード付き sentinel）を使う。
+- **ネスト中（ssh / docker / REPL）は quiescence が原理的に効かない。** 前面コマンドがシェル集合（bash/sh/zsh/fish/dash）の外になるため。ネスト中で `until` 未指定のときは、待っても完了を確定できる信号が無いので、`pty_read({ wait: true })` はフル `timeout` を空費せず出力静止時点で `is_complete=False via nested` と早期に返し、`until`（プロンプト等の正規表現）か `mark: true`（終了コード付き sentinel）の指定を促す。
 - **`is_complete=False` は失敗ではない。** 「timeout 内に完了を観測できなかった」という意味。長時間コマンドでは `timeout` を伸ばすか `until`/`mark` を使う。
 - **破壊ゲートはサンドボックスではなく tripwire。** よくある破壊形だけを弾く。相対パスの `rm`、`$VAR` 展開後に危険化するもの、ssh 先で実行されるコマンドは捕捉しない。
 - **`pty_send({ rtk: true })` は単行コマンドのみ＋外部 `rtk` バイナリが必要**（無ければ素通し）。一方 `pty_read({ rtk: true })` の reducer は自前実装で rtk 非依存。

package/README.md

@@ -179,7 +179,7 @@ Before sending, `pty_send` blocks destructive commands (`rm -rf /`, `mkfs`, `dd
 
 ## Known constraints (by design, not bugs)
 
-- **While nested (ssh / docker / REPL), quiescence cannot fire by design**, because the foreground command is no longer in the shell set (bash/sh/zsh/fish/dash). Use `until` (a regex for the prompt etc.) or `mark: true` (an exit-code sentinel) for completion.
+- **While nested (ssh / docker / REPL), quiescence cannot fire by design**, because the foreground command is no longer in the shell set (bash/sh/zsh/fish/dash). When nested with no `until`, `pty_read({ wait: true })` returns early as `is_complete=False via nested` (rather than burning the full `timeout`, since no signal can confirm completion there) with a note to pass `until` (a regex for the prompt) or `mark: true` (an exit-code sentinel) for a confirmed completion.
 - **`is_complete=False` is not a failure.** It means "completion was not observed within `timeout`." For long commands, raise `timeout` or use `until`/`mark`.
 - **The destructive gate is a tripwire, not a sandbox.** It blocks common destructive forms only. It does **not** catch relative-path `rm`, things that become dangerous after `$VAR` expansion, or commands run on the far side of an SSH session.
 - **`pty_send({ rtk: true })` is single-line only and needs the external `rtk` binary** (passthrough without it). The `pty_read({ rtk: true })` reducer, by contrast, is self-contained and rtk-independent.

package/dist/core.js

@@ -332,7 +332,7 @@ async function settleWinLog(name) {
         await sleep(POLL * 1000);
     }
 }
-/** 完了境界の4層: dead / until 一致 / (出力静止 ∧ シェルに戻った) / timeout。 */
+/** 完了境界: dead / until 一致 / (出力静止 ∧ シェル復帰)=quiescent / (ネスト中＋until無しで出力静止)=nested(未確定・早期返却) / timeout。 */
 async function waitCompletion(name, untilRe, timeout) {
     // 締切は単調時計で測る。Date.now() は NTP 補正やサスペンドで巻き戻り、長時間待ちで誤判定する（Python は time.monotonic）。
     const deadline = performance.now() + timeout * 1000;
@@ -362,10 +362,22 @@ async function waitCompletion(name, untilRe, timeout) {
         }
         if (size === lastSize) {
             stable++;
-            if (stable >= STABLE_POLLS && SHELLS.has(paneCurrentCommand(name))) {
-                if (isWin)
-                    await settleWinLog(name);
-                return [true, "quiescent"];
+            if (stable >= STABLE_POLLS) {
+                const fg = paneCurrentCommand(name);
+                if (SHELLS.has(fg)) {
+                    if (isWin)
+                        await settleWinLog(name);
+                    return [true, "quiescent"]; // 出力静止 ∧ シェル復帰 ＝ 確証つき完了
+                }
+                // ネスト中（前面が ssh/docker/REPL 等でシェル集合外）は quiescence の「シェル復帰」条件を
+                // 原理的に満たせない。until 未指定ならこれ以上待っても確証は増えない（until/dead/quiescent の
+                // いずれも発火し得ない）ので、出力が静止した時点で「未確定」のまま早期返却し until/mark を促す。
+                // fg==="" は前面コマンド取得失敗＝ネスト断定不可なので早期返却せず従来どおり timeout まで待つ。
+                if (!until && fg !== "") {
+                    if (isWin)
+                        await settleWinLog(name);
+                    return [false, "nested"];
+                }
             }
         }
         else {
@@ -377,6 +389,17 @@ async function waitCompletion(name, untilRe, timeout) {
         await sleep(POLL * 1000);
     }
 }
+// 完了ステータス → is_complete 表記。確証のある層のみ True（until/dead/quiescent）。
+// timeout と nested（ネスト中・出力静止だが確証なし）は False。nested は until/mark を促す注記を添える。
+function completionSuffix(status) {
+    const complete = status === "until" || status === "dead" || status === "quiescent";
+    let s = ` [is_complete=${complete ? "True" : "False"} via ${status}]`;
+    if (status === "nested")
+        s +=
+            " ネスト中（前面が ssh/docker/REPL 等）は出力静止だけでは完了を確定できません。" +
+                "until（リモートのプロンプト等の正規表現）か mark:true で完了を指定してください。";
+    return s;
+}
 function rtkRewrite(text) {
     if (text.trim().includes("\n"))
         return text;
@@ -506,20 +529,16 @@ export async function readOutput(name, o = {}) {
             const [reduced, rname] = rtk.reduce(cmd, framed);
             if (reduced !== null) {
                 const meta = `[aiterm ${name}: rtk:${rname} 適用 / ~${estimateTokens(reduced)} tok (raw ~${estimateTokens(text)} tok)]`;
-                if (status) {
-                    const complete = status !== "timeout";
-                    return reduced + "\n" + meta + ` [is_complete=${complete ? "True" : "False"} via ${status}]`;
-                }
+                if (status)
+                    return reduced + "\n" + meta + completionSuffix(status);
                 return reduced + "\n" + meta;
             }
         }
         // reducer 非該当 → 汎用削減へフォールバック
     }
     const [body, meta] = reduceOutput(text, name, !o.range);
-    if (status) {
-        const complete = status !== "timeout";
-        return body + "\n" + meta + ` [is_complete=${complete ? "True" : "False"} via ${status}]`;
-    }
+    if (status)
+        return body + "\n" + meta + completionSuffix(status);
     return body + "\n" + meta;
 }
 export function listSessions() {

package/dist/index.js

@@ -12,7 +12,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import * as core from "./core.js";
-const server = new McpServer({ name: "aiterm", version: "0.3.1" });
+const server = new McpServer({ name: "aiterm", version: "0.4.0" });
 function ok(s) {
     return { content: [{ type: "text", text: s }] };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "AI-driven persistent terminal as a local stdio MCP server (tmux-backed). Holds one local PTY; SSH and containers are just commands you send into it. Token-reducing reads.",
   "keywords": [
     "mcp",