@downcity/shell 0.1.4

package/bin/session/ShellActionRuntimeSupport.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Shell action 运行时辅助能力。
+ *
+ * 关键点（中文）
+ * - 统一承载 ShellActionRuntime 的内部共享逻辑：环境组装、持久化、waiter 协调、session 查找。
+ * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 plugin action 编排。
+ */
+import type { ShellHostContext } from "../types/ShellHostContext.js";
+import type { ShellRuntimeState, ShellSessionRuntimeState } from "../session/ShellRuntimeTypes.js";
+import type { ResolvedShellRuntimeOptions, ShellRuntimeOptions } from "../types/ShellRuntimeOptions.js";
+import type { ShellQueryRequest, ShellSessionSnapshot, ShellSessionStatus } from "../types/ShellAction.js";
+export { buildShellEnv, resolveOwnerContextId, resolveShellCwd, } from "./ShellRuntimeEnvironment.js";
+export { buildActionResponse, createOutputChunk, } from "./ShellActionResponse.js";
+/**
+ * shell.start 默认内联等待时间。
+ */
+export declare const DEFAULT_INLINE_WAIT_MS: number;
+/**
+ * shell.wait 默认等待超时。
+ */
+export declare const DEFAULT_WAIT_TIMEOUT_MS: number;
+/**
+ * shell.exec 默认总超时。
+ */
+export declare const DEFAULT_EXEC_TIMEOUT_MS: number;
+/**
+ * 归一化 Shell 可选运行参数。
+ */
+export declare function resolveShellRuntimeOptions(options?: ShellRuntimeOptions): ResolvedShellRuntimeOptions;
+/**
+ * 创建 shell runtime 初始状态。
+ */
+export declare function createShellRuntimeState(options?: ShellRuntimeOptions): ShellRuntimeState;
+/**
+ * 返回当前毫秒时间戳。
+ */
+export declare function nowMs(): number;
+/**
+ * 归一化 wait/timeout 参数。
+ */
+export declare function clampWaitMs(value: number | undefined, fallback: number): number;
+/**
+ * 结合 Shell options 归一化 wait/timeout 参数。
+ */
+export declare function clampWaitMsWithOptions(options: ResolvedShellRuntimeOptions, value: number | undefined, fallback: number): number;
+/**
+ * 判断 shell 是否已进入终态。
+ */
+export declare function isTerminalStatus(status: ShellSessionStatus): boolean;
+/**
+ * 持久化 shell snapshot。
+ */
+export declare function persistSnapshot(session: ShellSessionRuntimeState): Promise<void>;
+/**
+ * 更新 session snapshot 并唤醒等待者。
+ */
+export declare function updateSessionSnapshot(session: ShellSessionRuntimeState, updater: (snapshot: ShellSessionSnapshot) => void | ShellSessionSnapshot): Promise<void>;
+/**
+ * 追加 shell 输出并同步更新快照。
+ */
+export declare function appendSessionOutput(state: ShellRuntimeState, session: ShellSessionRuntimeState, raw: string): Promise<void>;
+/**
+ * 为终态 shell 安排延迟清理。
+ */
+export declare function scheduleCleanup(state: ShellRuntimeState, shellId: string): void;
+/**
+ * 控制 in-memory shell session 容量。
+ */
+export declare function ensureCapacity(state: ShellRuntimeState): void;
+/**
+ * 按 shellId 或 ownerContext 解析目标 session。
+ */
+export declare function resolveSession(state: ShellRuntimeState, context: ShellHostContext, query: ShellQueryRequest): Promise<ShellSessionRuntimeState | {
+    snapshot: ShellSessionSnapshot;
+    outputText: string;
+} | null>;
+/**
+ * 判断解析出的 session 是否仍在内存中活动。
+ */
+export declare function isInMemorySession(value: ShellSessionRuntimeState | {
+    snapshot: ShellSessionSnapshot;
+    outputText: string;
+}): value is ShellSessionRuntimeState;
+/**
+ * 处理 shell 退出后的状态收口。
+ */
+export declare function finalizeExit(state: ShellRuntimeState, session: ShellSessionRuntimeState, exitCode: number): Promise<void>;
+//# sourceMappingURL=ShellActionRuntimeSupport.d.ts.map

package/bin/session/ShellActionRuntimeSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellActionRuntimeSupport.d.ts","sourceRoot":"","sources":["../../src/session/ShellActionRuntimeSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAelC;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAoD,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAqD,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAqD,CAAC;AAY1F;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,mBAAwB,GAChC,2BAA2B,CAgD7B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,CAOnB;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,2BAA2B,EACpC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AAeD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAOpE;AAqBD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtF;AAqBD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,GAAG,oBAAoB,GACvE,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,wBAAwB,EACjC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAY/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAc7D;AAuBD;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,wBAAwB,GAAG;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiCnG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,wBAAwB,GAAG;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvF,KAAK,IAAI,wBAAwB,CAEnC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/bin/session/ShellActionRuntimeSupport.js

@@ -0,0 +1,305 @@
+/**
+ * Shell action 运行时辅助能力。
+ *
+ * 关键点（中文）
+ * - 统一承载 ShellActionRuntime 的内部共享逻辑：环境组装、持久化、waiter 协调、session 查找。
+ * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 plugin action 编排。
+ */
+import path from "node:path";
+import fs from "fs-extra";
+import { getShellOutputPath, getShellSnapshotPath } from "./Paths.js";
+import { resolveOwnerContextId } from "./ShellRuntimeEnvironment.js";
+export { buildShellEnv, resolveOwnerContextId, resolveShellCwd, } from "./ShellRuntimeEnvironment.js";
+export { buildActionResponse, createOutputChunk, } from "./ShellActionResponse.js";
+const DEFAULT_SHELL_RUNTIME_OPTIONS = {
+    maxActiveShells: 64,
+    cleanupDelayMs: 10 * 60 * 1000,
+    maxInMemoryOutputChars: 1_000_000,
+    outputPreviewChars: 280,
+    minWaitMs: 50,
+    maxWaitMs: 30_000,
+    defaultInlineWaitMs: 1_200,
+    defaultWaitTimeoutMs: 10_000,
+    defaultExecTimeoutMs: 60_000,
+    defaultApprovalTimeoutMs: 120_000,
+};
+/**
+ * shell.start 默认内联等待时间。
+ */
+export const DEFAULT_INLINE_WAIT_MS = DEFAULT_SHELL_RUNTIME_OPTIONS.defaultInlineWaitMs;
+/**
+ * shell.wait 默认等待超时。
+ */
+export const DEFAULT_WAIT_TIMEOUT_MS = DEFAULT_SHELL_RUNTIME_OPTIONS.defaultWaitTimeoutMs;
+/**
+ * shell.exec 默认总超时。
+ */
+export const DEFAULT_EXEC_TIMEOUT_MS = DEFAULT_SHELL_RUNTIME_OPTIONS.defaultExecTimeoutMs;
+function readPositiveInteger(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return fallback;
+    }
+    return Math.max(1, Math.floor(value));
+}
+/**
+ * 归一化 Shell 可选运行参数。
+ */
+export function resolveShellRuntimeOptions(options = {}) {
+    const minWaitMs = readPositiveInteger(options.minWaitMs, DEFAULT_SHELL_RUNTIME_OPTIONS.minWaitMs);
+    const maxWaitMs = Math.max(minWaitMs, readPositiveInteger(options.maxWaitMs, DEFAULT_SHELL_RUNTIME_OPTIONS.maxWaitMs));
+    return {
+        maxActiveShells: readPositiveInteger(options.maxActiveShells, DEFAULT_SHELL_RUNTIME_OPTIONS.maxActiveShells),
+        cleanupDelayMs: readPositiveInteger(options.cleanupDelayMs, DEFAULT_SHELL_RUNTIME_OPTIONS.cleanupDelayMs),
+        maxInMemoryOutputChars: readPositiveInteger(options.maxInMemoryOutputChars, DEFAULT_SHELL_RUNTIME_OPTIONS.maxInMemoryOutputChars),
+        outputPreviewChars: readPositiveInteger(options.outputPreviewChars, DEFAULT_SHELL_RUNTIME_OPTIONS.outputPreviewChars),
+        minWaitMs,
+        maxWaitMs,
+        defaultInlineWaitMs: readPositiveInteger(options.defaultInlineWaitMs, DEFAULT_SHELL_RUNTIME_OPTIONS.defaultInlineWaitMs),
+        defaultWaitTimeoutMs: readPositiveInteger(options.defaultWaitTimeoutMs, DEFAULT_SHELL_RUNTIME_OPTIONS.defaultWaitTimeoutMs),
+        defaultExecTimeoutMs: readPositiveInteger(options.defaultExecTimeoutMs, DEFAULT_SHELL_RUNTIME_OPTIONS.defaultExecTimeoutMs),
+        defaultApprovalTimeoutMs: readPositiveInteger(options.defaultApprovalTimeoutMs, DEFAULT_SHELL_RUNTIME_OPTIONS.defaultApprovalTimeoutMs),
+    };
+}
+/**
+ * 创建 shell runtime 初始状态。
+ */
+export function createShellRuntimeState(options = {}) {
+    return {
+        options: resolveShellRuntimeOptions(options),
+        sessions: new Map(),
+        approvals: new Map(),
+        context: null,
+    };
+}
+/**
+ * 返回当前毫秒时间戳。
+ */
+export function nowMs() {
+    return Date.now();
+}
+/**
+ * 归一化 wait/timeout 参数。
+ */
+export function clampWaitMs(value, fallback) {
+    return clampWaitMsWithOptions(DEFAULT_SHELL_RUNTIME_OPTIONS, value, fallback);
+}
+/**
+ * 结合 Shell options 归一化 wait/timeout 参数。
+ */
+export function clampWaitMsWithOptions(options, value, fallback) {
+    const raw = typeof value === "number" && Number.isFinite(value)
+        ? Math.floor(value)
+        : fallback;
+    return Math.min(options.maxWaitMs, Math.max(options.minWaitMs, raw));
+}
+function normalizeOutputChunk(raw) {
+    if (!raw)
+        return "";
+    return raw
+        .replace(/\r\n/g, "\n")
+        .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, "");
+}
+function deriveExitStatus(exitCode) {
+    if (exitCode === -9 || exitCode === 137)
+        return "killed";
+    if (typeof exitCode === "number" && exitCode === 0)
+        return "completed";
+    return "failed";
+}
+/**
+ * 判断 shell 是否已进入终态。
+ */
+export function isTerminalStatus(status) {
+    return (status === "completed" ||
+        status === "failed" ||
+        status === "killed" ||
+        status === "expired");
+}
+function extractExternalRefsFromText(text, current) {
+    const next = [...current];
+    const register = (kind, value, label) => {
+        const normalized = String(value || "").trim();
+        if (!normalized)
+            return;
+        if (next.some((item) => item.kind === kind && item.value === normalized))
+            return;
+        next.push({ kind, value: normalized, ...(label ? { label } : {}) });
+    };
+    const threadIdRegex = /thread_id[:=]\s*([a-zA-Z0-9_-]{6,})/g;
+    for (const match of text.matchAll(threadIdRegex)) {
+        register("thread_id", String(match[1] || ""), "external thread id");
+    }
+    return next;
+}
+/**
+ * 持久化 shell snapshot。
+ */
+export async function persistSnapshot(session) {
+    await fs.ensureDir(path.dirname(session.snapshotFilePath));
+    await fs.writeJson(session.snapshotFilePath, session.snapshot, { spaces: 2 });
+}
+function enqueuePersistedAppend(session, text) {
+    session.writeChain = session.writeChain.then(async () => {
+        await fs.ensureDir(path.dirname(session.outputFilePath));
+        await fs.appendFile(session.outputFilePath, text, "utf-8");
+    });
+    return session.writeChain;
+}
+function notifyWaiters(session) {
+    for (const waiter of Array.from(session.waiters)) {
+        clearTimeout(waiter.timer);
+        session.waiters.delete(waiter);
+        waiter.resolve();
+    }
+}
+/**
+ * 更新 session snapshot 并唤醒等待者。
+ */
+export async function updateSessionSnapshot(session, updater) {
+    const result = updater(session.snapshot);
+    if (result) {
+        session.snapshot = result;
+    }
+    session.snapshot.updatedAt = nowMs();
+    session.snapshot.version += 1;
+    await persistSnapshot(session);
+    notifyWaiters(session);
+}
+/**
+ * 追加 shell 输出并同步更新快照。
+ */
+export async function appendSessionOutput(state, session, raw) {
+    const text = normalizeOutputChunk(raw);
+    if (!text)
+        return;
+    session.outputText += text;
+    if (session.outputText.length > state.options.maxInMemoryOutputChars) {
+        const overflow = session.outputText.length - state.options.maxInMemoryOutputChars;
+        session.outputText = session.outputText.slice(overflow);
+        session.snapshot.droppedChars += overflow;
+    }
+    session.snapshot.outputChars += text.length;
+    session.snapshot.lastOutputAt = nowMs();
+    session.snapshot.lastOutputPreview = session.outputText
+        .slice(-state.options.outputPreviewChars)
+        .trim();
+    session.snapshot.externalRefs = extractExternalRefsFromText(text, session.snapshot.externalRefs);
+    await enqueuePersistedAppend(session, text);
+    await updateSessionSnapshot(session, () => undefined);
+}
+/**
+ * 为终态 shell 安排延迟清理。
+ */
+export function scheduleCleanup(state, shellId) {
+    const session = state.sessions.get(shellId);
+    if (!session)
+        return;
+    if (session.cleanupTimer)
+        clearTimeout(session.cleanupTimer);
+    session.cleanupTimer = setTimeout(() => {
+        const current = state.sessions.get(shellId);
+        if (!current)
+            return;
+        state.sessions.delete(shellId);
+    }, state.options.cleanupDelayMs);
+    if (typeof session.cleanupTimer.unref === "function") {
+        session.cleanupTimer.unref();
+    }
+}
+/**
+ * 控制 in-memory shell session 容量。
+ */
+export function ensureCapacity(state) {
+    if (state.sessions.size < state.options.maxActiveShells)
+        return;
+    const removable = Array.from(state.sessions.values())
+        .filter((item) => item.snapshot.status !== "running" && item.snapshot.status !== "starting")
+        .sort((a, b) => a.snapshot.updatedAt - b.snapshot.updatedAt);
+    for (const item of removable) {
+        if (state.sessions.size < state.options.maxActiveShells)
+            break;
+        state.sessions.delete(item.snapshot.shellId);
+    }
+    if (state.sessions.size >= state.options.maxActiveShells) {
+        throw new Error(`Too many active shell sessions (${state.sessions.size}). Please close or wait older sessions first.`);
+    }
+}
+async function loadPersistedSnapshot(context, shellId) {
+    const file = getShellSnapshotPath(context.rootPath, shellId);
+    if (!(await fs.pathExists(file)))
+        return null;
+    const raw = await fs.readJson(file).catch(() => null);
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const snapshot = raw;
+    return typeof snapshot.shellId === "string" ? snapshot : null;
+}
+async function readPersistedOutput(context, shellId) {
+    const file = getShellOutputPath(context.rootPath, shellId);
+    if (!(await fs.pathExists(file)))
+        return "";
+    return await fs.readFile(file, "utf-8");
+}
+/**
+ * 按 shellId 或 ownerContext 解析目标 session。
+ */
+export async function resolveSession(state, context, query) {
+    const explicitShellId = String(query.shellId || "").trim();
+    if (explicitShellId) {
+        const inMemory = state.sessions.get(explicitShellId);
+        if (inMemory)
+            return inMemory;
+        const snapshot = await loadPersistedSnapshot(context, explicitShellId);
+        if (!snapshot)
+            return null;
+        return {
+            snapshot,
+            outputText: await readPersistedOutput(context, explicitShellId),
+        };
+    }
+    const ownerContextId = resolveOwnerContextId(context, query.ownerContextId);
+    const cmd = String(query.cmd || "").trim().toLowerCase();
+    if (!ownerContextId)
+        return null;
+    const includeCompleted = query.includeCompleted === true;
+    const matched = Array.from(state.sessions.values())
+        .filter((item) => {
+        if (item.snapshot.ownerContextId !== ownerContextId)
+            return false;
+        if (!includeCompleted) {
+            if (item.snapshot.status !== "running" &&
+                item.snapshot.status !== "starting") {
+                return false;
+            }
+        }
+        if (!cmd)
+            return true;
+        return item.snapshot.cmd.toLowerCase().includes(cmd);
+    })
+        .sort((a, b) => b.snapshot.updatedAt - a.snapshot.updatedAt);
+    return matched[0] || null;
+}
+/**
+ * 判断解析出的 session 是否仍在内存中活动。
+ */
+export function isInMemorySession(value) {
+    return "child" in value;
+}
+/**
+ * 处理 shell 退出后的状态收口。
+ */
+export async function finalizeExit(state, session, exitCode) {
+    await updateSessionSnapshot(session, (snapshot) => {
+        snapshot.status = deriveExitStatus(exitCode);
+        snapshot.exitCode = exitCode;
+        snapshot.endedAt = nowMs();
+        snapshot.pid = session.child.pid ?? snapshot.pid;
+    });
+    session.resolveCompletion();
+    scheduleCleanup(state, session.snapshot.shellId);
+    if (session.snapshot.autoNotifyOnExit && session.snapshot.notificationSent === false) {
+        session.snapshot.notificationSent = true;
+        await persistSnapshot(session);
+    }
+}
+//# sourceMappingURL=ShellActionRuntimeSupport.js.map

package/bin/session/ShellActionRuntimeSupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellActionRuntimeSupport.js","sourceRoot":"","sources":["../../src/session/ShellActionRuntimeSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAe1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,MAAM,6BAA6B,GAAgC;IACjE,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IAC9B,sBAAsB,EAAE,SAAS;IACjC,kBAAkB,EAAE,GAAG;IACvB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,MAAM;IACjB,mBAAmB,EAAE,KAAK;IAC1B,oBAAoB,EAAE,MAAM;IAC5B,oBAAoB,EAAE,MAAM;IAC5B,wBAAwB,EAAE,OAAO;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC,mBAAmB,CAAC;AAExF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,6BAA6B,CAAC,oBAAoB,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,6BAA6B,CAAC,oBAAoB,CAAC;AAE1F,SAAS,mBAAmB,CAC1B,KAAyB,EACzB,QAAgB;IAEhB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAA+B,EAAE;IAEjC,MAAM,SAAS,GAAG,mBAAmB,CACnC,OAAO,CAAC,SAAS,EACjB,6BAA6B,CAAC,SAAS,CACxC,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,SAAS,EACT,mBAAmB,CACjB,OAAO,CAAC,SAAS,EACjB,6BAA6B,CAAC,SAAS,CACxC,CACF,CAAC;IACF,OAAO;QACL,eAAe,EAAE,mBAAmB,CAClC,OAAO,CAAC,eAAe,EACvB,6BAA6B,CAAC,eAAe,CAC9C;QACD,cAAc,EAAE,mBAAmB,CACjC,OAAO,CAAC,cAAc,EACtB,6BAA6B,CAAC,cAAc,CAC7C;QACD,sBAAsB,EAAE,mBAAmB,CACzC,OAAO,CAAC,sBAAsB,EAC9B,6BAA6B,CAAC,sBAAsB,CACrD;QACD,kBAAkB,EAAE,mBAAmB,CACrC,OAAO,CAAC,kBAAkB,EAC1B,6BAA6B,CAAC,kBAAkB,CACjD;QACD,SAAS;QACT,SAAS;QACT,mBAAmB,EAAE,mBAAmB,CACtC,OAAO,CAAC,mBAAmB,EAC3B,6BAA6B,CAAC,mBAAmB,CAClD;QACD,oBAAoB,EAAE,mBAAmB,CACvC,OAAO,CAAC,oBAAoB,EAC5B,6BAA6B,CAAC,oBAAoB,CACnD;QACD,oBAAoB,EAAE,mBAAmB,CACvC,OAAO,CAAC,oBAAoB,EAC5B,6BAA6B,CAAC,oBAAoB,CACnD;QACD,wBAAwB,EAAE,mBAAmB,CAC3C,OAAO,CAAC,wBAAwB,EAChC,6BAA6B,CAAC,wBAAwB,CACvD;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAA+B,EAAE;IAEjC,OAAO;QACL,OAAO,EAAE,0BAA0B,CAAC,OAAO,CAAC;QAC5C,QAAQ,EAAE,IAAI,GAAG,EAAoC;QACrD,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK;IACnB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAyB,EAAE,QAAgB;IACrE,OAAO,sBAAsB,CAAC,6BAA6B,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAoC,EACpC,KAAyB,EACzB,QAAgB;IAEhB,MAAM,GAAG,GACP,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC;IACf,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG;SACP,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,iDAAiD,EAAE,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA4B;IACpD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IACzD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IACvE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA0B;IACzD,OAAO,CACL,MAAM,KAAK,WAAW;QACtB,MAAM,KAAK,QAAQ;QACnB,MAAM,KAAK,QAAQ;QACnB,MAAM,KAAK,SAAS,CACrB,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,IAAY,EACZ,OAA6C;IAE7C,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,KAAc,EAAQ,EAAE;QACrE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU;YAAE,OAAO;QACxB,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC;YAAE,OAAO;QACjF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,sCAAsC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAiC;IACrE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAAiC,EACjC,IAAY;IAEZ,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACtD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,UAAU,CAAC;AAC5B,CAAC;AAED,SAAS,aAAa,CAAC,OAAiC;IACtD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAiC,EACjC,OAAwE;IAExE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;IAC9B,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/B,aAAa,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAwB,EACxB,OAAiC,EACjC,GAAW;IAEX,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC;QAClF,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC;IAC5C,CAAC;IAED,OAAO,CAAC,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,GAAG,KAAK,EAAE,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,GAAG,OAAO,CAAC,UAAU;SACpD,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC;SACxC,IAAI,EAAE,CAAC;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY,GAAG,2BAA2B,CACzD,IAAI,EACJ,OAAO,CAAC,QAAQ,CAAC,YAAY,CAC9B,CAAC;IACF,MAAM,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAwB,EAAE,OAAe;IACvE,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,OAAO,CAAC,YAAY;QAAE,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,OAAO,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,IAAI,OAAO,OAAO,CAAC,YAAY,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACrD,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAwB;IACrD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe;QAAE,OAAO;IAChE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;SAClD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC;SAC3F,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe;YAAE,MAAM;QAC/D,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,mCAAmC,KAAK,CAAC,QAAQ,CAAC,IAAI,+CAA+C,CACtG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,OAAyB,EACzB,OAAe;IAEf,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,MAAM,QAAQ,GAAG,GAA2B,CAAC;IAC7C,OAAO,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,OAAyB,EACzB,OAAe;IAEf,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAwB,EACxB,OAAyB,EACzB,KAAwB;IAExB,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACrD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO;YACL,QAAQ;YACR,UAAU,EAAE,MAAM,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC;SAChE,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,KAAK,IAAI,CAAC;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;SAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,KAAK,cAAc;YAAE,OAAO,KAAK,CAAC;QAClE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,IACE,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;gBAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,EACnC,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAwF;IAExF,OAAO,OAAO,IAAI,KAAK,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB,EACxB,OAAiC,EACjC,QAAgB;IAEhB,MAAM,qBAAqB,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QAChD,QAAQ,CAAC,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7C,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC7B,QAAQ,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;QAC3B,QAAQ,CAAC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAC5B,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,KAAK,KAAK,EAAE,CAAC;QACrF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC;QACzC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/bin/session/ShellProcessEvents.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shell 子进程事件绑定辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 stdout/stderr 追加、process error 与 close 事件。
+ * - close 到达时先等待输出写入链 drain，再统一进入终态收口，避免尾部输出丢读。
+ */
+import type { ShellRuntimeState, ShellSessionRuntimeState } from "../session/ShellRuntimeTypes.js";
+/**
+ * 绑定 shell 子进程事件。
+ */
+export declare function attachShellProcessEventHandlers(params: {
+    /**
+     * 当前 shell runtime 状态。
+     */
+    state: ShellRuntimeState;
+    /**
+     * 当前 shell runtime session。
+     */
+    session: ShellSessionRuntimeState;
+}): void;
+//# sourceMappingURL=ShellProcessEvents.d.ts.map

package/bin/session/ShellProcessEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellProcessEvents.d.ts","sourceRoot":"","sources":["../../src/session/ShellProcessEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAsBlG;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD;;OAEG;IACH,KAAK,EAAE,iBAAiB,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,wBAAwB,CAAC;CACnC,GAAG,IAAI,CAsBP"}

package/bin/session/ShellProcessEvents.js

@@ -0,0 +1,41 @@
+/**
+ * Shell 子进程事件绑定辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 stdout/stderr 追加、process error 与 close 事件。
+ * - close 到达时先等待输出写入链 drain，再统一进入终态收口，避免尾部输出丢读。
+ */
+import { appendSessionOutput, finalizeExit, } from "./ShellActionRuntimeSupport.js";
+async function finalizeExitAfterOutputDrain(state, session, exitCode) {
+    // 关键点（中文）
+    // - `close` 事件到达时，stdout / stderr 的异步 append 链可能刚刚开始收尾。
+    // - 这里先让出一个事件循环 tick，再等待当前 writeChain，可显著降低“终态已到但尾部输出尚未可读”的竞态。
+    await new Promise((resolve) => {
+        const timer = setImmediate(resolve);
+        if (typeof timer.unref === "function")
+            timer.unref();
+    });
+    await session.writeChain.catch(() => undefined);
+    await finalizeExit(state, session, exitCode);
+}
+/**
+ * 绑定 shell 子进程事件。
+ */
+export function attachShellProcessEventHandlers(params) {
+    const { state, session } = params;
+    const { child } = session;
+    child.stdout.on("data", (chunk) => {
+        void appendSessionOutput(state, session, String(chunk ?? "")).catch(() => undefined);
+    });
+    child.stderr.on("data", (chunk) => {
+        void appendSessionOutput(state, session, String(chunk ?? "")).catch(() => undefined);
+    });
+    child.on("error", (error) => {
+        void appendSessionOutput(state, session, `\n[process error] ${String(error)}\n`).catch(() => undefined);
+        void finalizeExitAfterOutputDrain(state, session, -1).catch(() => undefined);
+    });
+    child.on("close", (code) => {
+        void finalizeExitAfterOutputDrain(state, session, typeof code === "number" ? code : -1).catch(() => undefined);
+    });
+}
+//# sourceMappingURL=ShellProcessEvents.js.map

package/bin/session/ShellProcessEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellProcessEvents.js","sourceRoot":"","sources":["../../src/session/ShellProcessEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,gCAAgC,CAAC;AAExC,KAAK,UAAU,4BAA4B,CACzC,KAAwB,EACxB,OAAiC,EACjC,QAAgB;IAEhB,UAAU;IACV,wDAAwD;IACxD,+DAA+D;IAC/D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAS/C;IACC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;QACjD,KAAK,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;QACjD,KAAK,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;QACjC,KAAK,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,qBAAqB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CACpF,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,KAAK,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;QACxC,KAAK,4BAA4B,CAC/B,KAAK,EACL,OAAO,EACP,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CACrC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/bin/session/ShellRunScope.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ShellRunScope：shell 工具调用的异步运行作用域。
+ *
+ * 关键点（中文）
+ * - Shell 包不依赖 agent，但 shell approval event 需要知道当前 session / turn。
+ * - 宿主在执行模型 run 时绑定该 scope，Shell tool 在深层回调里自动读取。
+ * - 这让用户只需要 `new Agent({ shell: new Shell() })`，不需要理解 run context wiring。
+ */
+/**
+ * Shell 当前运行上下文。
+ */
+export interface ShellScopedRunContext {
+    /**
+     * 当前宿主 session id。
+     */
+    session_id?: string;
+    /**
+     * 当前宿主 turn id。
+     */
+    turn_id?: string;
+}
+/**
+ * Shell run scope。
+ */
+export interface ShellRunScope {
+    /**
+     * 当前 shell tool 调用可读取的宿主运行上下文。
+     */
+    run_context: ShellScopedRunContext;
+}
+/**
+ * 绑定当前异步链路上的 shell run scope。
+ */
+export declare function withShellRunScope<T>(scope: ShellRunScope, fn: () => T): T;
+/**
+ * 读取当前异步链路上的 shell run scope。
+ */
+export declare function getShellRunScope(): ShellRunScope | undefined;
+/**
+ * 读取当前异步链路上的 shell run context。
+ */
+export declare function getShellRunContext(): ShellScopedRunContext | undefined;
+//# sourceMappingURL=ShellRunScope.d.ts.map

package/bin/session/ShellRunScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellRunScope.d.ts","sourceRoot":"","sources":["../../src/session/ShellRunScope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,EAAE,qBAAqB,CAAC;CACpC;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,GAAG,SAAS,CAEtE"}

package/bin/session/ShellRunScope.js

@@ -0,0 +1,29 @@
+/**
+ * ShellRunScope：shell 工具调用的异步运行作用域。
+ *
+ * 关键点（中文）
+ * - Shell 包不依赖 agent，但 shell approval event 需要知道当前 session / turn。
+ * - 宿主在执行模型 run 时绑定该 scope，Shell tool 在深层回调里自动读取。
+ * - 这让用户只需要 `new Agent({ shell: new Shell() })`，不需要理解 run context wiring。
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+const shell_run_scope_storage = new AsyncLocalStorage();
+/**
+ * 绑定当前异步链路上的 shell run scope。
+ */
+export function withShellRunScope(scope, fn) {
+    return shell_run_scope_storage.run(scope, fn);
+}
+/**
+ * 读取当前异步链路上的 shell run scope。
+ */
+export function getShellRunScope() {
+    return shell_run_scope_storage.getStore();
+}
+/**
+ * 读取当前异步链路上的 shell run context。
+ */
+export function getShellRunContext() {
+    return shell_run_scope_storage.getStore()?.run_context;
+}
+//# sourceMappingURL=ShellRunScope.js.map

package/bin/session/ShellRunScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellRunScope.js","sourceRoot":"","sources":["../../src/session/ShellRunScope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA2BrD,MAAM,uBAAuB,GAAG,IAAI,iBAAiB,EAAiB,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAI,KAAoB,EAAE,EAAW;IACpE,OAAO,uBAAuB,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,uBAAuB,CAAC,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,uBAAuB,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC;AACzD,CAAC"}

package/bin/session/ShellRuntimeEnvironment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shell action 运行环境解析辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 shell 子进程 cwd、env 与 owner context 的解析。
+ * - 这里只做输入归一化，不持有 shell session 状态。
+ */
+import type { ShellHostContext } from "../types/ShellHostContext.js";
+/**
+ * 构造 shell 子进程环境变量。
+ */
+export declare function buildShellEnv(context: ShellHostContext): NodeJS.ProcessEnv;
+/**
+ * 解析 shell 执行目录。
+ */
+export declare function resolveShellCwd(context: ShellHostContext, cwd?: string): string;
+/**
+ * 推断 shell 所属的 owner context。
+ */
+export declare function resolveOwnerContextId(context: ShellHostContext, explicit?: string): string | undefined;
+//# sourceMappingURL=ShellRuntimeEnvironment.d.ts.map

package/bin/session/ShellRuntimeEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellRuntimeEnvironment.d.ts","sourceRoot":"","sources":["../../src/session/ShellRuntimeEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAOpE;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,UAAU,CA+B1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAKpB"}