tailii-host 0.1.0

package/dist/subagentTailer.js

@@ -0,0 +1,399 @@
+// subagentTailer.ts
+// tailii (TS host) — サブエージェント進捗ツリー tail
+// Swift 版 SubagentTailer.swift の移植。
+// claude の `<sessionId>/subagents/agent-*.meta.json` と main/subagent transcript を監視し、
+// subagent_node（spawn/running → completed/error）を engine チャネルへ流す。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { PROTOCOL_V2 } from "./protocol.js";
+import { abortableSleep } from "./sleep.js";
+import { extractToolActivities, TranscriptTailer } from "./transcriptTailer.js";
+/** サブエージェント meta/jsonl と親 transcript の tool_result を監視する。 */
+export class SubagentTailer {
+    pollIntervalMs;
+    tailIndefinitely;
+    constructor(options = {}) {
+        this.pollIntervalMs = options.pollIntervalMs ?? 50;
+        this.tailIndefinitely = options.tailIndefinitely ?? true;
+    }
+    async *streamProjectDir(projectDir, preferredSessionId, newerThanMs = null, signal) {
+        const start = Date.now();
+        let mainTranscript = null;
+        while (!signal?.aborted) {
+            mainTranscript = TranscriptTailer.resolveJsonl(projectDir, preferredSessionId, newerThanMs);
+            if (mainTranscript !== null)
+                break;
+            if (!this.tailIndefinitely)
+                return;
+            await abortableSleep(this.pollIntervalMs, signal);
+            if (!this.tailIndefinitely && Date.now() - start > this.pollIntervalMs)
+                return;
+        }
+        if (mainTranscript === null || signal?.aborted)
+            return;
+        yield* this.streamSession(mainTranscript, signal);
+    }
+    async *streamSession(mainTranscript, signal) {
+        const sessionId = path.basename(mainTranscript, ".jsonl");
+        const subagentsDir = path.join(path.dirname(mainTranscript), sessionId, "subagents");
+        const tracked = new Map();
+        const fileStates = new Map();
+        const ownerByToolUseId = new Map();
+        const resultByToolUseId = new Map();
+        let aggregateDirty = true;
+        while (!signal?.aborted) {
+            if (discoverMetaFiles(subagentsDir, tracked))
+                aggregateDirty = true;
+            const transcriptOwners = transcriptFiles(mainTranscript, tracked);
+            for (const transcript of transcriptOwners) {
+                const read = readNewLines(transcript.path, fileStates);
+                const node = transcript.nodeId === null ? null : (tracked.get(transcript.nodeId) ?? null);
+                if (read.reset) {
+                    aggregateDirty = true;
+                    if (node !== null)
+                        node.currentActivity = null;
+                }
+                if (node !== null)
+                    node.firstJsonlTimestampMs = read.state.firstTimestampMs;
+                if (read.lines.length > 0)
+                    aggregateDirty = true;
+                for (const line of read.lines) {
+                    if (read.state.firstTimestampMs === null) {
+                        const ts = timestampMs(line);
+                        if (ts !== null)
+                            read.state.firstTimestampMs = ts;
+                    }
+                    if (node !== null)
+                        node.firstJsonlTimestampMs = read.state.firstTimestampMs;
+                    for (const id of extractSpawnToolUseIds(line))
+                        read.state.ownerByToolUseId.set(id, transcript.owner);
+                    for (const hit of extractToolResults(line)) {
+                        read.state.resultByToolUseId.set(hit.id, { isError: hit.isError, ts: hit.ts });
+                    }
+                    if (node !== null) {
+                        const activity = latestActivitySummary(line);
+                        if (activity !== null)
+                            node.currentActivity = activity;
+                    }
+                }
+            }
+            if (aggregateDirty) {
+                ownerByToolUseId.clear();
+                resultByToolUseId.clear();
+                for (const transcript of transcriptOwners) {
+                    const state = fileStates.get(transcript.path);
+                    if (state === undefined)
+                        continue;
+                    for (const [id, owner] of state.ownerByToolUseId)
+                        ownerByToolUseId.set(id, owner);
+                    for (const [id, result] of state.resultByToolUseId)
+                        resultByToolUseId.set(id, result);
+                }
+                aggregateDirty = false;
+            }
+            for (const node of tracked.values()) {
+                const result = resultByToolUseId.get(node.meta.toolUseId) ?? null;
+                const status = result === null ? "running" : (result.isError ? "error" : "completed");
+                const ts = result?.ts ?? node.firstJsonlTimestampMs ?? mtimeMs(node.metaPath);
+                const parentNodeId = ownerByToolUseId.get(node.meta.toolUseId) ?? fallbackParent(node.meta.spawnDepth);
+                const messageNode = {
+                    nodeId: node.nodeId,
+                    toolUseId: node.meta.toolUseId,
+                    parentNodeId,
+                    agentType: node.meta.agentType,
+                    label: node.meta.description,
+                    depth: node.meta.spawnDepth,
+                    status,
+                    currentActivity: status === "running" ? node.currentActivity : null,
+                    ts,
+                };
+                const key = stableNodeKey(messageNode);
+                if (key === node.lastKey)
+                    continue;
+                node.lastKey = key;
+                yield { type: "subagent_node", v: PROTOCOL_V2, node: messageNode };
+            }
+            if (!this.tailIndefinitely)
+                return;
+            await abortableSleep(this.pollIntervalMs, signal);
+        }
+    }
+}
+function discoverMetaFiles(dir, tracked) {
+    let files;
+    try {
+        files = fs.readdirSync(dir);
+    }
+    catch {
+        return false;
+    }
+    let changed = false;
+    for (const file of files.sort()) {
+        const match = /^agent-(.+)\.meta\.json$/.exec(file);
+        if (match === null)
+            continue;
+        const nodeId = match[1];
+        const existing = tracked.get(nodeId);
+        if (existing !== undefined) {
+            const jsonlPath = siblingJsonl(existing.metaPath);
+            if (existing.jsonlPath !== jsonlPath) {
+                existing.jsonlPath = jsonlPath;
+                changed = true;
+            }
+            continue;
+        }
+        const metaPath = path.join(dir, file);
+        const meta = readMeta(metaPath);
+        if (meta === null)
+            continue;
+        tracked.set(nodeId, {
+            nodeId,
+            meta,
+            metaPath,
+            jsonlPath: siblingJsonl(metaPath),
+            firstJsonlTimestampMs: null,
+            currentActivity: null,
+            lastKey: null,
+        });
+        changed = true;
+    }
+    return changed;
+}
+function readMeta(metaPath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(metaPath, "utf8"));
+        if (typeof parsed["agentType"] !== "string" ||
+            typeof parsed["description"] !== "string" ||
+            typeof parsed["toolUseId"] !== "string" ||
+            typeof parsed["spawnDepth"] !== "number") {
+            return null;
+        }
+        return {
+            agentType: parsed["agentType"],
+            description: parsed["description"],
+            toolUseId: parsed["toolUseId"],
+            spawnDepth: parsed["spawnDepth"],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function siblingJsonl(metaPath) {
+    const jsonl = metaPath.replace(/\.meta\.json$/, ".jsonl");
+    return fs.existsSync(jsonl) ? jsonl : null;
+}
+function transcriptFiles(mainTranscript, tracked) {
+    const out = [
+        { path: mainTranscript, owner: "root", nodeId: null },
+    ];
+    for (const node of tracked.values()) {
+        if (node.jsonlPath !== null)
+            out.push({ path: node.jsonlPath, owner: node.nodeId, nodeId: node.nodeId });
+    }
+    return out;
+}
+function readNewLines(file, states) {
+    let stat;
+    try {
+        stat = fs.statSync(file);
+    }
+    catch {
+        const state = ensureFileState(file, states);
+        return { lines: [], reset: false, state };
+    }
+    const state = ensureFileState(file, states);
+    let reset = false;
+    if (stat.size < state.position) {
+        state.position = 0;
+        state.lineBuf = Buffer.alloc(0);
+        state.ownerByToolUseId.clear();
+        state.resultByToolUseId.clear();
+        state.firstTimestampMs = null;
+        reset = true;
+    }
+    let fd;
+    try {
+        fd = fs.openSync(file, "r");
+    }
+    catch {
+        return { lines: [], reset, state };
+    }
+    const out = [];
+    const chunk = Buffer.alloc(4096);
+    try {
+        for (;;) {
+            const bytesRead = fs.readSync(fd, chunk, 0, chunk.length, state.position);
+            if (bytesRead === 0)
+                break;
+            state.position += bytesRead;
+            state.lineBuf = Buffer.concat([state.lineBuf, chunk.subarray(0, bytesRead)]);
+            let nl = state.lineBuf.indexOf(0x0a);
+            while (nl >= 0) {
+                const line = state.lineBuf.subarray(0, nl).toString("utf8").replaceAll("\r", "");
+                state.lineBuf = state.lineBuf.subarray(nl + 1);
+                if (line.length > 0)
+                    out.push(line);
+                nl = state.lineBuf.indexOf(0x0a);
+            }
+        }
+    }
+    catch {
+        return { lines: out, reset, state };
+    }
+    finally {
+        // Subagent tailing watches a changing set of files, so each tick opens only for
+        // the incremental read and closes immediately. Offsets and partial lines stay cached.
+        try {
+            fs.closeSync(fd);
+        }
+        catch {
+            // 二重 close 等は無視。
+        }
+    }
+    return { lines: out, reset, state };
+}
+function ensureFileState(file, states) {
+    let state = states.get(file);
+    if (state === undefined) {
+        state = {
+            position: 0,
+            lineBuf: Buffer.alloc(0),
+            ownerByToolUseId: new Map(),
+            resultByToolUseId: new Map(),
+            firstTimestampMs: null,
+        };
+        states.set(file, state);
+    }
+    return state;
+}
+function extractSpawnToolUseIds(line) {
+    const content = messageContent(line);
+    if (!Array.isArray(content))
+        return [];
+    const ids = [];
+    for (const block of content) {
+        if (typeof block !== "object" || block === null)
+            continue;
+        const rec = block;
+        if (rec["type"] !== "tool_use")
+            continue;
+        // 実データでは Agent、brief のサンプル/旧名では Task。どちらも同じ spawn path として扱う。
+        if (rec["name"] !== "Task" && rec["name"] !== "Agent")
+            continue;
+        if (typeof rec["id"] === "string")
+            ids.push(rec["id"]);
+    }
+    return ids;
+}
+function extractToolResults(line) {
+    const content = messageContent(line);
+    const ts = timestampMs(line);
+    if (!Array.isArray(content))
+        return [];
+    const out = [];
+    for (const block of content) {
+        if (typeof block !== "object" || block === null)
+            continue;
+        const rec = block;
+        if (rec["type"] !== "tool_result")
+            continue;
+        if (typeof rec["tool_use_id"] === "string") {
+            out.push({ id: rec["tool_use_id"], isError: rec["is_error"] === true, ts });
+        }
+    }
+    return out;
+}
+function latestActivitySummary(line) {
+    const activities = extractToolActivities(messageContent(line));
+    const latest = activities.at(-1);
+    return latest === undefined ? null : truncateActivityLabel(formatActivityLabel(latest));
+}
+function formatActivityLabel(activity) {
+    switch (activity.name) {
+        case "Bash":
+            return `Bash: ${activity.command ?? activity.description ?? stripActivityPrefix(activity.label, activity.name)}`;
+        case "Edit":
+        case "MultiEdit":
+            return `${activity.name} ${displayActivityTarget(activity)}`;
+        case "Write":
+        case "NotebookEdit":
+            return `${activity.name} ${displayActivityTarget(activity)}`;
+        case "Read":
+            return `Read ${displayActivityTarget(activity)}`;
+        case "TodoWrite":
+            return "Todo更新";
+        default: {
+            const detail = displayActivityTarget(activity);
+            return detail === activity.name ? activity.name : `${activity.name}: ${detail}`;
+        }
+    }
+}
+function displayActivityTarget(activity) {
+    if (activity.file !== undefined && activity.file.length > 0) {
+        const base = path.basename(activity.file);
+        return base.length > 0 ? base : activity.file;
+    }
+    return stripActivityPrefix(activity.label, activity.name);
+}
+function stripActivityPrefix(label, fallback) {
+    const stripped = label
+        .replace(/^(実行済み|編集済み|作成済み|既読|検索済み)\s*/, "")
+        .replace(/^Todoを更新しました$/, "Todo更新")
+        .trim();
+    return stripped.length > 0 ? stripped : fallback;
+}
+function truncateActivityLabel(label) {
+    const limit = 60;
+    return label.length <= limit ? label : `${label.slice(0, limit - 1)}…`;
+}
+function messageContent(line) {
+    try {
+        const obj = JSON.parse(line);
+        const message = obj["message"];
+        if (typeof message === "object" && message !== null) {
+            return message["content"];
+        }
+        return obj["content"];
+    }
+    catch {
+        return null;
+    }
+}
+function timestampMs(line) {
+    try {
+        const obj = JSON.parse(line);
+        if (typeof obj["timestamp"] !== "string")
+            return null;
+        const ms = Date.parse(obj["timestamp"]);
+        return Number.isFinite(ms) ? ms : null;
+    }
+    catch {
+        return null;
+    }
+}
+function mtimeMs(file) {
+    try {
+        return Math.floor(fs.statSync(file).mtimeMs);
+    }
+    catch {
+        return 0;
+    }
+}
+function fallbackParent(depth) {
+    return depth <= 1 ? "root" : null;
+}
+function stableNodeKey(node) {
+    return JSON.stringify([
+        node.nodeId,
+        node.toolUseId,
+        node.parentNodeId ?? null,
+        node.agentType,
+        node.label,
+        node.depth,
+        node.status,
+        node.currentActivity ?? null,
+        node.ts,
+    ]);
+}
+//# sourceMappingURL=subagentTailer.js.map

package/dist/subagentTailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentTailer.js","sourceRoot":"","sources":["../src/subagentTailer.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,wCAAwC;AACxC,oCAAoC;AACpC,sFAAsF;AACtF,kEAAkE;AAElE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAsF,MAAM,eAAe,CAAC;AAChI,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAuChF,6DAA6D;AAC7D,MAAM,OAAO,cAAc;IACR,cAAc,CAAS;IACvB,gBAAgB,CAAU;IAE3C,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,CAAC,gBAAgB,CACrB,UAAkB,EAClB,kBAAiC,EACjC,cAA6B,IAAI,EACjC,MAAoB;QAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,cAAc,GAAkB,IAAI,CAAC;QACzC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACxB,cAAc,GAAG,gBAAgB,CAAC,YAAY,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC;YAC5F,IAAI,cAAc,KAAK,IAAI;gBAAE,MAAM;YACnC,IAAI,CAAC,IAAI,CAAC,gBAAgB;gBAAE,OAAO;YACnC,MAAM,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,cAAc;gBAAE,OAAO;QACjF,CAAC;QACD,IAAI,cAAc,KAAK,IAAI,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO;QACvD,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,CAAC,aAAa,CAClB,cAAsB,EACtB,MAAoB;QAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACrF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;QACpD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACnD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAyB,CAAC;QAC3D,IAAI,cAAc,GAAG,IAAI,CAAC;QAE1B,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACxB,IAAI,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC;gBAAE,cAAc,GAAG,IAAI,CAAC;YAEpE,MAAM,gBAAgB,GAAG,eAAe,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAClE,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACvD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;gBAC1F,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,cAAc,GAAG,IAAI,CAAC;oBACtB,IAAI,IAAI,KAAK,IAAI;wBAAE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBACjD,CAAC;gBACD,IAAI,IAAI,KAAK,IAAI;oBAAE,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC;gBAC5E,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,cAAc,GAAG,IAAI,CAAC;gBACjD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;wBACzC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;wBAC7B,IAAI,EAAE,KAAK,IAAI;4BAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC;oBACpD,CAAC;oBACD,IAAI,IAAI,KAAK,IAAI;wBAAE,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC;oBAC5E,KAAK,MAAM,EAAE,IAAI,sBAAsB,CAAC,IAAI,CAAC;wBAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;oBACrG,KAAK,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC3C,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjF,CAAC;oBACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBAClB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;wBAC7C,IAAI,QAAQ,KAAK,IAAI;4BAAE,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;oBACzD,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,cAAc,EAAE,CAAC;gBACnB,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBACzB,iBAAiB,CAAC,KAAK,EAAE,CAAC;gBAC1B,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;oBAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBAC9C,IAAI,KAAK,KAAK,SAAS;wBAAE,SAAS;oBAClC,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,gBAAgB;wBAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;oBAClF,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB;wBAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACxF,CAAC;gBACD,cAAc,GAAG,KAAK,CAAC;YACzB,CAAC;YAED,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;gBAClE,MAAM,MAAM,GAAuB,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;gBAC1G,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,IAAI,CAAC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9E,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACvG,MAAM,WAAW,GAAiB;oBAChC,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;oBAC9B,YAAY;oBACZ,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;oBAC9B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;oBAC5B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;oBAC3B,MAAM;oBACN,eAAe,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI;oBACnE,EAAE;iBACH,CAAC;gBACF,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;gBACvC,IAAI,GAAG,KAAK,IAAI,CAAC,OAAO;oBAAE,SAAS;gBACnC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;gBACnB,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACrE,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,gBAAgB;gBAAE,OAAO;YACnC,MAAM,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,GAAW,EAAE,OAAiC;IACvE,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACrC,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC/B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;YAClB,MAAM;YACN,IAAI;YACJ,QAAQ;YACR,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC;YACjC,qBAAqB,EAAE,IAAI;YAC3B,eAAe,EAAE,IAAI;YACrB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA4B,CAAC;QACxF,IACE,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ;YACvC,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ;YACzC,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ;YACvC,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ,EACxC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;YAC9B,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;YAC9B,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC;SACjC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CACtB,cAAsB,EACtB,OAAiC;IAEjC,MAAM,GAAG,GAA6D;QACpE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;KACtD,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CACnB,IAAY,EACZ,MAAkC;IAElC,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;QACnB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC9B,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;IAED,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QACH,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC1E,IAAI,SAAS,KAAK,CAAC;gBAAE,MAAM;YAC3B,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC;YAC5B,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;YAC7E,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;gBACf,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACjF,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;YAAS,CAAC;QACT,gFAAgF;QAChF,sFAAsF;QACtF,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,MAAkC;IACvE,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG;YACN,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxB,gBAAgB,EAAE,IAAI,GAAG,EAAE;YAC3B,iBAAiB,EAAE,IAAI,GAAG,EAAE;YAC5B,gBAAgB,EAAE,IAAI;SACvB,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC1D,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,UAAU;YAAE,SAAS;QACzC,8DAA8D;QAC9D,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,OAAO;YAAE,SAAS;QAChE,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,GAAG,GAA0D,EAAE,CAAC;IACtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC1D,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,aAAa;YAAE,SAAS;QAC5C,IAAI,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3C,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,qBAAqB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAsB;IACjD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,SAAS,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,WAAW,IAAI,mBAAmB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnH,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW;YACd,OAAO,GAAG,QAAQ,CAAC,IAAI,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/D,KAAK,OAAO,CAAC;QACb,KAAK,cAAc;YACjB,OAAO,GAAG,QAAQ,CAAC,IAAI,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/D,KAAK,MAAM;YACT,OAAO,QAAQ,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC;QAClB,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAC/C,OAAO,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClF,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAsB;IACnD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAChD,CAAC;IACD,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa,EAAE,QAAgB;IAC1D,MAAM,QAAQ,GAAG,KAAK;SACnB,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC;SAC3C,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC;SAClC,IAAI,EAAE,CAAC;IACV,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;AACzE,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACxD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,OAAQ,OAAmC,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACxD,IAAI,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACtD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpC,CAAC;AAED,SAAS,aAAa,CAAC,IAAkB;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,YAAY,IAAI,IAAI;QACzB,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,eAAe,IAAI,IAAI;QAC5B,IAAI,CAAC,EAAE;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/tmux.d.ts

@@ -0,0 +1,62 @@
+import { type ControlMessage, type SessionInfo } from "./protocol.js";
+import { SessionMetadataStore } from "./sessionMetadataStore.js";
+/** tmux コマンド 1 回分の実行結果。 */
+export interface TmuxCommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+/** tmux コマンド実行の注入可能な抽象（テストはモックを注入する）。 */
+export type TmuxCommandRunner = (args: string[]) => Promise<TmuxCommandResult>;
+/** tmux 実行ファイルの既定絶対パス（PATH 外のため絶対指定）。 */
+export declare const DEFAULT_TMUX_PATH = "/opt/homebrew/bin/tmux";
+/** 実 tmux を絶対パスで起動する既定ランナー。tmux 非0 exit は throw せず結果で表現する。 */
+export declare function processTmuxCommandRunner(tmuxPath?: string): TmuxCommandRunner;
+/** TmuxSessionManager が投げる型付きエラー。 */
+export declare class TmuxFailedError extends Error {
+    readonly args: string[];
+    readonly exitCode: number;
+    readonly stderr: string;
+    constructor(args: string[], exitCode: number, stderr: string);
+}
+/** reattach の型付き結果。 */
+export type ReattachResult = {
+    kind: "attached";
+    info: SessionInfo;
+    recentOutput: string;
+} | {
+    kind: "notFound";
+    error: ControlMessage;
+};
+/** tmux セッションの list / reattach / kill とメタデータ統合。 */
+export declare class TmuxSessionManager {
+    private readonly runner;
+    readonly store: SessionMetadataStore;
+    private readonly captureLines;
+    private readonly protocolVersion;
+    constructor(options?: {
+        runner?: TmuxCommandRunner;
+        store?: SessionMetadataStore;
+        captureLines?: number;
+        protocolVersion?: number;
+    });
+    /** 現存する各セッションを name/cwd/alive で列挙する（name 昇順、メタのみは alive:false）。 */
+    list(): Promise<SessionInfo[]>;
+    /** 既存セッションへ reattach（生存: attached / 不在: session_not_found エラー封筒）。 */
+    reattach(name: string): Promise<ReattachResult>;
+    /** 指定セッションのみを終了する（tmux kill-session -t <name>）。 */
+    kill(name: string): Promise<void>;
+    /** 指定セッションの pane へ tmux send-keys を発行する（literal は -l）。 */
+    sendKeys(name: string, keys: string[], literal?: boolean): Promise<void>;
+    /** `capture-pane -p -t <name> -S -<N>` で末尾 N 行のペイン内容を返す（末尾空行は削る）。 */
+    capturePane(name: string): Promise<string>;
+    /** `tmux ls` の生存セッション名集合。サーバ未起動 = 空集合として扱う。 */
+    private liveSessionNames;
+    /**
+     * `tmux ls` の生存セッションと最終活動時刻（Unix 秒）を返す。サーバ未起動 = 空。
+     * `#{session_activity}` はセッション個別の最終活動時刻で、一覧の updatedAt 権威に使う
+     * （同一 cwd でも共有トランスクリプト mtime に潰されず正しく最近使用順で並ぶ）。
+     * 活動時刻を伴わない出力（name のみ）は値 null とし、呼び出し側のフォールバックに委ねる。
+     */
+    private liveSessions;
+}

package/dist/tmux.js

@@ -0,0 +1,163 @@
+// tmux.ts
+// tailii (TS host) — tmux セッションの list / reattach / kill / send-keys / capture-pane
+// Swift 版 TmuxSessionManager.swift の移植。
+// 生存集合は `tmux ls -F '#{session_name}'`、cwd は SessionMetadataStore を権威とする。
+import { execFile } from "node:child_process";
+import { PROTOCOL_V1 } from "./protocol.js";
+import { SessionMetadataStore, validateSessionName } from "./sessionMetadataStore.js";
+/** tmux 実行ファイルの既定絶対パス（PATH 外のため絶対指定）。 */
+export const DEFAULT_TMUX_PATH = "/opt/homebrew/bin/tmux";
+/** 実 tmux を絶対パスで起動する既定ランナー。tmux 非0 exit は throw せず結果で表現する。 */
+export function processTmuxCommandRunner(tmuxPath = DEFAULT_TMUX_PATH) {
+    return (args) => new Promise((resolve, reject) => {
+        execFile(tmuxPath, args, { maxBuffer: 16 * 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error && typeof error.code === "string") {
+                // 実行ファイル起動自体の失敗（ENOENT 等）のみ throw（Swift 版と同じ境界）。
+                reject(error);
+                return;
+            }
+            const exitCode = error && typeof error.code === "number" ? error.code : error ? 1 : 0;
+            resolve({ exitCode, stdout: String(stdout), stderr: String(stderr) });
+        });
+    });
+}
+/** TmuxSessionManager が投げる型付きエラー。 */
+export class TmuxFailedError extends Error {
+    args;
+    exitCode;
+    stderr;
+    constructor(args, exitCode, stderr) {
+        super(`tmux ${args.join(" ")} failed (exit ${exitCode}): ${stderr}`);
+        this.args = args;
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+        this.name = "TmuxFailedError";
+    }
+}
+/** tmux セッションの list / reattach / kill とメタデータ統合。 */
+export class TmuxSessionManager {
+    runner;
+    store;
+    captureLines;
+    protocolVersion;
+    constructor(options = {}) {
+        this.runner = options.runner ?? processTmuxCommandRunner();
+        this.store = options.store ?? new SessionMetadataStore();
+        this.captureLines = options.captureLines ?? 50;
+        this.protocolVersion = options.protocolVersion ?? PROTOCOL_V1;
+    }
+    /** 現存する各セッションを name/cwd/alive で列挙する（name 昇順、メタのみは alive:false）。 */
+    async list() {
+        const alive = await this.liveSessions();
+        const metas = this.store.all();
+        const cwdByName = new Map();
+        for (const meta of metas)
+            cwdByName.set(meta.name, meta.cwd);
+        const names = new Set(alive.keys());
+        for (const meta of metas)
+            names.add(meta.name);
+        const infos = [...names].map((name) => {
+            const base = {
+                name,
+                cwd: cwdByName.get(name) ?? "",
+                alive: alive.has(name),
+            };
+            // tmux のセッション個別の活動時刻を updatedAt（Unix 秒）の権威にする。
+            const activity = alive.get(name);
+            return activity === undefined || activity === null ? base : { ...base, updatedAt: activity };
+        });
+        return infos.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    }
+    /** 既存セッションへ reattach（生存: attached / 不在: session_not_found エラー封筒）。 */
+    async reattach(name) {
+        validateSessionName(name);
+        const aliveNames = await this.liveSessionNames();
+        if (!aliveNames.has(name)) {
+            return {
+                kind: "notFound",
+                error: {
+                    type: "error",
+                    v: this.protocolVersion,
+                    code: "session_not_found",
+                    message: `セッション '${name}' は存在しません。新規に起動できます。`,
+                },
+            };
+        }
+        const cwd = this.store.get(name)?.cwd ?? "";
+        const recent = await this.capturePane(name);
+        return { kind: "attached", info: { name, cwd, alive: true }, recentOutput: recent };
+    }
+    /** 指定セッションのみを終了する（tmux kill-session -t <name>）。 */
+    async kill(name) {
+        validateSessionName(name);
+        const args = ["kill-session", "-t", name];
+        const result = await this.runner(args);
+        if (result.exitCode !== 0) {
+            throw new TmuxFailedError(args, result.exitCode, result.stderr);
+        }
+    }
+    /** 指定セッションの pane へ tmux send-keys を発行する（literal は -l）。 */
+    async sendKeys(name, keys, literal = false) {
+        validateSessionName(name);
+        if (keys.length === 0)
+            return;
+        const args = ["send-keys", "-t", name];
+        if (literal)
+            args.push("-l");
+        args.push(...keys);
+        const result = await this.runner(args);
+        if (result.exitCode !== 0) {
+            throw new TmuxFailedError(args, result.exitCode, result.stderr);
+        }
+    }
+    /** `capture-pane -p -t <name> -S -<N>` で末尾 N 行のペイン内容を返す（末尾空行は削る）。 */
+    async capturePane(name) {
+        const args = ["capture-pane", "-p", "-t", name, "-S", `-${this.captureLines}`];
+        const result = await this.runner(args);
+        if (result.exitCode !== 0) {
+            throw new TmuxFailedError(args, result.exitCode, result.stderr);
+        }
+        const lines = result.stdout.split("\n");
+        while (lines.length > 0 && (lines[lines.length - 1] ?? "").trim() === "") {
+            lines.pop();
+        }
+        return lines.join("\n");
+    }
+    /** `tmux ls` の生存セッション名集合。サーバ未起動 = 空集合として扱う。 */
+    async liveSessionNames() {
+        return new Set((await this.liveSessions()).keys());
+    }
+    /**
+     * `tmux ls` の生存セッションと最終活動時刻（Unix 秒）を返す。サーバ未起動 = 空。
+     * `#{session_activity}` はセッション個別の最終活動時刻で、一覧の updatedAt 権威に使う
+     * （同一 cwd でも共有トランスクリプト mtime に潰されず正しく最近使用順で並ぶ）。
+     * 活動時刻を伴わない出力（name のみ）は値 null とし、呼び出し側のフォールバックに委ねる。
+     */
+    async liveSessions() {
+        const args = ["ls", "-F", "#{session_name} #{session_activity}"];
+        const result = await this.runner(args);
+        if (result.exitCode !== 0) {
+            const combined = (result.stdout + result.stderr).toLowerCase();
+            if (combined.includes("no server running") || combined.includes("no sessions")) {
+                return new Map();
+            }
+            throw new TmuxFailedError(args, result.exitCode, result.stderr);
+        }
+        const out = new Map();
+        for (const raw of result.stdout.split("\n")) {
+            const line = raw.trim();
+            if (line.length === 0)
+                continue;
+            const sep = line.lastIndexOf(" ");
+            if (sep < 0) {
+                out.set(line, null); // 活動時刻なし（name のみ）
+                continue;
+            }
+            const name = line.slice(0, sep).trim();
+            const secs = Number.parseInt(line.slice(sep + 1).trim(), 10);
+            out.set(name, Number.isFinite(secs) ? secs : null);
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=tmux.js.map

package/dist/tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.js","sourceRoot":"","sources":["../src/tmux.ts"],"names":[],"mappings":"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"}