aiterm-mcp 0.12.2 → 0.15.0

package/dist/index.js

@@ -33,6 +33,7 @@ function fail(e) {
  */
 async function factoryDiagnostics() {
     const ptyList = core.readOnlyPtyListDiagnostic();
+    const claude = core.vendorLauncherDiagnostic("claude");
     const codex = core.vendorLauncherDiagnostic("codex");
     const grok = core.vendorLauncherDiagnostic("grok");
     const runtimeErrors = await runtimeErrorStoreDiagnostic();
@@ -45,6 +46,11 @@ async function factoryDiagnostics() {
         pty_list: { access: "read_only", ...ptyList },
         runtime_error_store: runtimeErrors,
         vendor_dependencies: {
+            claude: {
+                status: claude,
+                optional: true,
+                required_for: ["claude_agent"],
+            },
             codex: {
                 status: codex,
                 optional: true,
@@ -81,18 +87,26 @@ server.registerTool("pty_open", {
 });
 server.registerTool("pty_send", {
     description: "セッションへテキスト(コマンド)を送る。通常は送信だけ行い、出力は pty_read で取得する。" +
-        "agent_done:true で起動した Codex/Grok/Composer セッションは wait:'agent_done' で Stop hook まで待てる。",
+        "agent_done:true で起動した Claude/Codex/Grok/Composer セッションは wait:'agent_done' で Stop hook まで待てる。" +
+        "managed Claude sessionはturn相関のためwait:'agent_done'を必須とし、通常送信を拒否する。",
     inputSchema: {
         session_id: z.string(),
-        text: z.string().describe("送る文字列（コマンド）"),
+        text: z
+            .string()
+            .describe("送る文字列（コマンド）。UTF-8で最大64KiB"),
         enter: z.boolean().default(true).describe("末尾で Enter を送る"),
         wait: z
             .enum(["none", "agent_done"])
             .default("none")
-            .describe("none=従来通り送信のみ。agent_done=agent Stop hook まで待って最終画面を返す"),
+            .describe("none=従来通り送信のみ（managed Claudeでは拒否）。agent_done=agent Stop hook まで待って最終画面を返す"),
         timeout: z.number().default(600).describe("wait:'agent_done' の最大待ち秒数"),
         screen: z.boolean().default(true).describe("wait:'agent_done' の返り値を描画済みスクリーンにする"),
         lines: z.number().int().nullish().describe("wait:'agent_done' で返す末尾 N 行"),
+        operation_id: z
+            .string()
+            .regex(/^sha256:[0-9a-f]{64}$/)
+            .nullish()
+            .describe("Claudeのdurable caller operation ID。wait:'agent_done'時だけ指定し、timeout後の同一結果回収へ使う"),
         mark: z
             .boolean()
             .default(false)
@@ -106,7 +120,7 @@ server.registerTool("pty_send", {
         rtk: z.boolean().default(false).describe("既知コマンドを rtk 形へ委譲して送る（rtk 不在なら素通し）"),
         raw: z.boolean().default(false).describe("送信前サニタイズを無効化"),
     },
-}, async ({ session_id, text, enter, wait, timeout, screen, lines, mark, force, rtk, raw }) => {
+}, async ({ session_id, text, enter, wait, timeout, screen, lines, operation_id, mark, force, rtk, raw }) => {
     try {
         if (wait === "agent_done") {
             return ok(await core.sendAndWaitAgentDone(session_id, text, {
@@ -118,8 +132,11 @@ server.registerTool("pty_send", {
                 timeout,
                 screen,
                 lines: lines ?? null,
+                operation_id: operation_id ?? null,
             }));
         }
+        if (operation_id != null)
+            throw new Error("operation_idはwait:'agent_done'時だけ指定できます");
         return ok(core.send(session_id, text, { enter, mark, force, rtk, raw }));
     }
     catch (e) {
@@ -129,7 +146,7 @@ server.registerTool("pty_send", {
 server.registerTool("pty_read", {
     description: "セッションの出力をトークン削減して読む（既定は前回読取位置からの増分）。" +
         "削減: 制御文字除去 / 反復圧縮 / head+tail 折りたたみ＋復元ヒント＋メタ併記。" +
-        "agent_transcript:true は agent session の直近完了ターンの最終 assistant メッセージを vendor transcript から平文で返す。" +
+        "agent_transcript:true は agent session の直近完了ターンの最終 assistant メッセージを公開されたvendor記録から平文で返す。" +
         "長い回答が screen tail で切れた時の回収用。",
     inputSchema: {
         session_id: z.string(),
@@ -155,16 +172,26 @@ server.registerTool("pty_read", {
         agent_transcript: z
             .boolean()
             .default(false)
-            .describe("agent session の直近完了ターンの最終 assistant メッセージを vendor transcript から平文で返す。長い回答が screen tail で切れた時の回収用"),
+            .describe("agent session の直近完了ターンの最終 assistant メッセージを返す。Claudeはmanaged Stop hook result、他vendorはtranscriptを使う。長い回答がscreen tailで切れた時の回収用"),
+        operation_id: z
+            .string()
+            .regex(/^sha256:[0-9a-f]{64}$/)
+            .nullish()
+            .describe("Claude operationの期待ID。agent_transcript:true時だけ指定し、古い別operationの結果を拒否する"),
     },
-}, async ({ session_id, wait, until, until_regex, timeout, screen, full, lines, line_range, raw, rtk, agent_transcript }) => {
+}, async ({ session_id, wait, until, until_regex, timeout, screen, full, lines, line_range, raw, rtk, agent_transcript, operation_id }) => {
     try {
         if (agent_transcript) {
             if (screen || full || rtk || wait || line_range != null) {
                 throw new Error("agent_transcript:true は screen / full / rtk / line_range / wait と併用できません。lines のみ指定できます。");
             }
-            return ok(await core.readAgentTranscript(session_id, { lines: lines ?? null }));
+            return ok(await core.readAgentTranscript(session_id, {
+                lines: lines ?? null,
+                operation_id: operation_id ?? null,
+            }));
         }
+        if (operation_id != null)
+            throw new Error("operation_idはagent_transcript:true時だけ指定できます");
         let range = null;
         if (line_range) {
             const idx = line_range.indexOf(":");
@@ -199,7 +226,7 @@ server.registerTool("pty_read", {
     }
 });
 server.registerTool("pty_key", {
-    description: "制御キーを送る（C-c, C-d, Enter, Tab, Up, Down... の別名に対応）。",
+    description: "制御キーを送る（C-c, C-d, Enter, Tab, Up, Down... の別名に対応）。managed Claude sessionではturn相関を守るためC-cだけを許可する。",
     inputSchema: {
         session_id: z.string(),
         key: z.string().describe('キー名（例 "C-c", "Enter", "Up"）'),
@@ -213,11 +240,21 @@ server.registerTool("pty_key", {
     }
 });
 server.registerTool("pty_close", {
-    description: "セッションを閉じ、ログ／読取位置を破棄する。",
+    description: "セッションを閉じ、ログ／読取位置を破棄する。同じsession_idへの再試行は安全で、" +
+        "closed／already_closedのstructured receiptを返す。",
     inputSchema: { session_id: z.string() },
+    outputSchema: {
+        schema: z.literal("aiterm.pty-close-result.v1"),
+        session_id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/),
+        outcome: z.enum(["closed", "already_closed"]),
+    },
 }, async ({ session_id }) => {
     try {
-        return ok(core.closeSession(session_id));
+        const result = core.closeSessionResult(session_id);
+        return {
+            content: [{ type: "text", text: `closed ${session_id}` }],
+            structuredContent: { ...result },
+        };
     }
     catch (e) {
         return fail(e);
@@ -234,20 +271,61 @@ server.registerTool("pty_list", {
         return fail(e);
     }
 });
+server.registerTool("claude_turn", {
+    description: "managed Claude sessionのdurable operationを構造化issue／recoverするmachine-caller専用面。" +
+        "pending／unknown／completedを人間向けerror文字列の解析なしで返し、Observer固有ロジックは持たない。",
+    inputSchema: {
+        action: z.enum(["issue", "recover"]),
+        session_id: z.string(),
+        operation_id: z.string().regex(/^sha256:[0-9a-f]{64}$/),
+        text: z.string().optional().describe("issueだけに指定するbounded turn本文"),
+        timeout: z.number().min(0).max(3600).optional().describe("issueだけに指定するStop待ち秒数"),
+    },
+    outputSchema: {
+        schema: z.literal("aiterm.claude-operation-result.v1"),
+        action: z.enum(["issue", "recover"]),
+        status: z.enum(["accepted", "pending", "completed", "unknown"]),
+        session_id: z.string(),
+        operation_id: z.string().regex(/^sha256:[0-9a-f]{64}$/),
+        raw_output: z.string().nullable(),
+        reason: z.enum(["operation_not_found", "result_unknown"]).nullable(),
+    },
+}, async ({ action, session_id, operation_id, text, timeout }) => {
+    try {
+        const result = await core.runClaudeOperation({
+            action,
+            session_id,
+            operation_id,
+            text: text ?? undefined,
+            timeout,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+            structuredContent: { ...result },
+        };
+    }
+    catch (e) {
+        return fail(e);
+    }
+});
 // 対話型エージェント起動ツール（モデルごとに1つ＝ツール名/説明でどのモデルか一目で分かる）。
 // いずれも永続端末に TUI を起動し session_id を返す。以後 pty_read/pty_send で対話操作する。
-const agentModelDesc = (kind) => kind === "codex"
-    ? "起動モデル（例: gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna）。省略時は端末 config／CLI 既定を継承" +
-        "（端末側のピンがそのまま効く。実効値は起動応答に明示される）"
-    : `起動モデル。省略時は ${kind === "grok" ? "grok-4.5" : "grok-composer-2.5-fast"}`;
-const agentEffortDesc = (grokLike) => grokLike
-    ? "指定不可（grok CLI の --effort は headless 専用で、対話 TUI では警告の上無視される。" +
-        "composer は effort 自体非対応）。指定すると起動前にエラーを返す"
-    : "reasoning effort（思考レベル）。low/medium/high/xhigh/max/ultra（CLI 版依存）。" +
-        "ultra は max 推論＋proactive 自動委譲 ON＝使用量急増注意（明示要求時のみ）。省略時は端末 config／CLI 既定。";
-function registerAgentTool(toolName, kind, desc, grokLike) {
+const agentModelDesc = (kind) => kind === "claude"
+    ? "起動モデル（例: claude-sonnet-4-6）。省略時はClaude CLI既定"
+    : kind === "codex"
+        ? "起動モデル（例: gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna）。省略時は端末 config／CLI 既定を継承" +
+            "（端末側のピンがそのまま効く。実効値は起動応答に明示される）"
+        : `起動モデル。省略時は ${kind === "grok" ? "grok-4.5" : "grok-composer-2.5-fast"}`;
+const agentEffortDesc = (kind) => kind === "claude"
+    ? "Claude Code reasoning effort。low/medium/high/xhigh/max。省略時はCLI既定"
+    : kind === "grok" || kind === "composer"
+        ? "指定不可（grok CLI の --effort は headless 専用で、対話 TUI では警告の上無視される。" +
+            "composer は effort 自体非対応）。指定すると起動前にエラーを返す"
+        : "reasoning effort（思考レベル）。low/medium/high/xhigh/max/ultra（CLI 版依存）。" +
+            "ultra は max 推論＋proactive 自動委譲 ON＝使用量急増注意（明示要求時のみ）。省略時は端末 config／CLI 既定。";
+function registerAgentTool(toolName, kind, desc) {
     const initialPromptWaitSchema = {};
-    if (kind === "codex") {
+    if (kind === "codex" || kind === "claude") {
         initialPromptWaitSchema.wait = z
             .enum(["none", "agent_done"])
             .default("none")
@@ -256,6 +334,14 @@ function registerAgentTool(toolName, kind, desc, grokLike) {
         initialPromptWaitSchema.screen = z.boolean().default(true).describe("wait:'agent_done' の返り値を描画済みスクリーンにする");
         initialPromptWaitSchema.lines = z.number().int().nullish().describe("wait:'agent_done' で返す末尾 N 行");
     }
+    const correlatedLaunchSchema = {};
+    if (kind === "claude") {
+        correlatedLaunchSchema.launch_operation_id = z
+            .string()
+            .regex(/^sha256:[0-9a-f]{64}$/)
+            .optional()
+            .describe("promptless managed launchのexact replay相関ID。session_nameとagent_done:trueが必須");
+    }
     server.registerTool(toolName, {
         description: desc,
         inputSchema: {
@@ -263,16 +349,23 @@ function registerAgentTool(toolName, kind, desc, grokLike) {
             model: z.string().nullish().describe(agentModelDesc(kind)),
             // grok/composer の effort は対話 TUI で無効（headless 専用）＝core 側が起動前に明示エラーで拒否。
             // codex は CLI 側の値集合が版で変わるため縛らない（core 側も同方針）。
-            reasoning_effort: z.string().nullish().describe(agentEffortDesc(grokLike)),
+            reasoning_effort: z.string().nullish().describe(agentEffortDesc(kind)),
             cwd: z.string().nullish().describe("作業ディレクトリ（対象リポのルート等・任意）"),
             session_name: z.string().nullish().describe("セッション名（省略で自動採番）"),
             agent_done: z
                 .boolean()
                 .default(false)
                 .describe("managed Stop hook を有効化し、pty_send(wait:'agent_done') を使えるようにする"),
+            ...correlatedLaunchSchema,
             ...initialPromptWaitSchema,
         },
-    }, async ({ prompt, model, reasoning_effort, cwd, session_name, agent_done, wait, timeout, screen, lines }) => {
+        outputSchema: {
+            schema: z.literal("aiterm.agent-launch-result.v1"),
+            provider: z.literal(kind),
+            session_id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/),
+            managed_completion: z.boolean(),
+        },
+    }, async ({ prompt, model, reasoning_effort, cwd, session_name, agent_done, launch_operation_id, wait, timeout, screen, lines }) => {
         try {
             const [sid, hint] = await core.openAgentWithInitialPrompt(kind, {
                 prompt: prompt ?? undefined,
@@ -281,25 +374,37 @@ function registerAgentTool(toolName, kind, desc, grokLike) {
                 cwd: cwd ?? undefined,
                 session_name: session_name ?? undefined,
                 agent_done: agent_done ?? false,
+                launch_operation_id: launch_operation_id ?? undefined,
                 wait: wait ?? "none",
                 timeout,
                 screen,
                 lines,
             });
-            return ok(`session_id: ${sid}\n${hint}`);
+            const structured = {
+                schema: "aiterm.agent-launch-result.v1",
+                provider: kind,
+                session_id: sid,
+                managed_completion: agent_done ?? false,
+            };
+            return {
+                content: [{ type: "text", text: `session_id: ${sid}\n${hint}` }],
+                structuredContent: structured,
+            };
         }
         catch (e) {
             return fail(e);
         }
     });
 }
+registerAgentTool("claude_agent", "claude", "【Claude Code (Anthropic)】の対話エージェントTUIを永続端末に起動する。`claude -p`ではなく、" +
+    "同じ利用者可視sessionへpty_sendで継続入力する。agent_done:trueではisolated settingsのmanaged Stop hookで完了と結果を回収する。");
 registerAgentTool("codex_agent", "codex", "【Codex (OpenAI)】の対話エージェント TUI を永続端末に起動する。実装・レビュー・調査を対話で回す。" +
     "起動後は pty_read で画面を読み pty_send で操作する。model / reasoning_effort を引数で指定可" +
-    "（省略時は端末 config／CLI 既定を継承。実効値は起動応答に明示）。", false);
+    "（省略時は端末 config／CLI 既定を継承。実効値は起動応答に明示）。");
 registerAgentTool("grok_agent", "grok", "【Grok Build の Grok モデル (既定 grok-4.5)】の対話エージェント TUI を永続端末に起動する。" +
-    "起動後は pty_read/pty_send で対話操作。model を引数で指定可。reasoning_effort は対話 TUI 非対応（指定はエラー）。", true);
+    "起動後は pty_read/pty_send で対話操作。model を引数で指定可。reasoning_effort は対話 TUI 非対応（指定はエラー）。");
 registerAgentTool("composer_agent", "composer", "【Grok Build の Composer モデル (既定 grok-composer-2.5-fast)】の対話エージェント TUI を永続端末に起動する。" +
-    "起動後は pty_read/pty_send で対話操作。model を引数で指定可。reasoning_effort は非対応（指定はエラー）。", true);
+    "起動後は pty_read/pty_send で対話操作。model を引数で指定可。reasoning_effort は非対応（指定はエラー）。");
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/runtime-error-store.js

@@ -31,6 +31,11 @@ const RECORD_KEYS = [
 const DIAGNOSTIC_KEYS = ["status", "collection", "record_count", "unacknowledged_count"];
 const ARCHES = new Set(["x64", "arm64", "arm", "ia32"]);
 const EMPTY_STATE = () => ({ schema_version: STORE_SCHEMA, cursor: 0, acknowledged_cursor: 0, records: [] });
+// readLock と queue scan の内部だけで使う。entry 本文など外部入力の Error message で
+// disappearance を判定しないため、公開せず型そのものを識別子にする。
+class LockDisappearedOrReplacedError extends Error {
+    constructor() { super("runtime error store lock が消滅または置換されました"); }
+}
 function isObject(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -426,6 +431,10 @@ export class RuntimeErrorStore {
         }
         else {
             const before = fs.lstatSync(lock);
+            // APFS の高競合では readdir snapshot 後、正当に unlink 済みの entry が pre-open
+            // lstat で nlink=0 と観測される。これは置換／消滅として caller の既存 skip 経路へ渡す。
+            if (before.nlink === 0)
+                throw new LockDisappearedOrReplacedError();
             if (!before.isFile() || before.isSymbolicLink() || before.nlink < 1 || before.nlink > 2
                 || before.uid !== process.getuid() || (before.mode & 0o777) !== 0o600 || before.size > 4096) {
                 throw new Error("runtime error store lock が不正です");
@@ -433,9 +442,10 @@ export class RuntimeErrorStore {
             const fd = fs.openSync(lock, fs.constants.O_RDONLY | fs.constants.O_NONBLOCK | (fs.constants.O_NOFOLLOW ?? 0));
             try {
                 const after = fs.fstatSync(fd);
-                if (before.dev !== after.dev || before.ino !== after.ino || after.nlink < 1 || after.nlink > 2) {
-                    throw new Error("runtime error store lock が置換されました");
-                }
+                if (before.dev !== after.dev || before.ino !== after.ino || after.nlink === 0)
+                    throw new LockDisappearedOrReplacedError();
+                if (after.nlink < 1 || after.nlink > 2)
+                    throw new Error("runtime error store lock が不正です");
                 text = fs.readFileSync(fd, "utf8");
             }
             finally {
@@ -532,8 +542,7 @@ export class RuntimeErrorStore {
                         current = this.readLock(currentPath);
                     }
                     catch (error) {
-                        if (error.code === "ENOENT"
-                            || (error instanceof Error && error.message.includes("置換されました")))
+                        if (error.code === "ENOENT" || error instanceof LockDisappearedOrReplacedError)
                             continue;
                         throw error;
                     }
@@ -568,8 +577,7 @@ export class RuntimeErrorStore {
                         current = this.readLock(currentPath);
                     }
                     catch (error) {
-                        if (error.code === "ENOENT"
-                            || (error instanceof Error && error.message.includes("置換されました")))
+                        if (error.code === "ENOENT" || error instanceof LockDisappearedOrReplacedError)
                             continue;
                         throw error;
                     }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.12.2",
+  "version": "0.15.0",
   "mcpName": "io.github.kitepon-rgb/aiterm-mcp",
-  "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. Also launches interactive Codex/Grok/Composer agent TUIs in a persistent terminal. Token-reducing reads.",
+  "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. Also launches interactive Claude/Codex/Grok/Composer agent TUIs in a persistent terminal. Token-reducing reads.",
   "keywords": [
     "mcp",
     "mcp-server",
@@ -33,7 +33,8 @@
   "type": "module",
   "bin": {
     "aiterm-mcp": "dist/index.js",
-    "aiterm-runtime-errors": "dist/runtime-errors-cli.js"
+    "aiterm-runtime-errors": "dist/runtime-errors-cli.js",
+    "aiterm-wait": "dist/aiterm-wait-cli.js"
   },
   "files": [
     "dist",