@downcity/shell 0.1.4

package/bin/session/actions/ShellLifecycleActions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shell runtime 生命周期 action。
+ *
+ * 关键点（中文）
+ * - 负责绑定宿主上下文与关闭当前 state 下的所有 shell。
+ * - 不处理单个 shell 的 start/read/write 等业务动作。
+ */
+import type { ShellHostContext } from "../../types/ShellHostContext.js";
+import type { ShellRuntimeState } from "../../session/ShellRuntimeTypes.js";
+/**
+ * 绑定当前 shell runtime 实例的 execution runtime。
+ */
+export declare function bindShellRuntime(state: ShellRuntimeState, context: ShellHostContext): void;
+/**
+ * 关闭当前实例持有的所有活动 shell。
+ */
+export declare function closeAllShellSessions(state: ShellRuntimeState, force?: boolean): Promise<void>;
+//# sourceMappingURL=ShellLifecycleActions.d.ts.map

package/bin/session/actions/ShellLifecycleActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellLifecycleActions.d.ts","sourceRoot":"","sources":["../../../src/session/actions/ShellLifecycleActions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAOxE;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/bin/session/actions/ShellLifecycleActions.js

@@ -0,0 +1,53 @@
+/**
+ * Shell runtime 生命周期 action。
+ *
+ * 关键点（中文）
+ * - 负责绑定宿主上下文与关闭当前 state 下的所有 shell。
+ * - 不处理单个 shell 的 start/read/write 等业务动作。
+ */
+import { nowMs, updateSessionSnapshot, } from "../ShellActionRuntimeSupport.js";
+import { resolveApproval } from "../../approval/ShellApprovalRuntime.js";
+/**
+ * 绑定当前 shell runtime 实例的 execution runtime。
+ */
+export function bindShellRuntime(state, context) {
+    state.context = context;
+}
+/**
+ * 关闭当前实例持有的所有活动 shell。
+ */
+export async function closeAllShellSessions(state, force = false) {
+    for (const approval of Array.from(state.approvals.values())) {
+        if (state.context) {
+            await resolveApproval({
+                state,
+                context: state.context,
+                approvalId: approval.approvalId,
+                decision: "expired",
+            }).catch(() => undefined);
+            continue;
+        }
+        clearTimeout(approval.timer);
+        state.approvals.delete(approval.approvalId);
+        approval.resolve("expired");
+    }
+    const closing = Array.from(state.sessions.values()).map(async (session) => {
+        if (session.snapshot.status !== "running" &&
+            session.snapshot.status !== "starting") {
+            return;
+        }
+        try {
+            session.child.kill(force ? "SIGKILL" : "SIGTERM");
+        }
+        catch {
+            // ignore
+        }
+        await updateSessionSnapshot(session, (snapshot) => {
+            snapshot.status = force ? "killed" : "failed";
+            snapshot.exitCode = force ? -9 : -15;
+            snapshot.endedAt = nowMs();
+        });
+    });
+    await Promise.all(closing);
+}
+//# sourceMappingURL=ShellLifecycleActions.js.map

package/bin/session/actions/ShellLifecycleActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellLifecycleActions.js","sourceRoot":"","sources":["../../../src/session/actions/ShellLifecycleActions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,KAAK,EACL,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAwB,EACxB,OAAyB;IAEzB,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAwB,EACxB,KAAK,GAAG,KAAK;IAEb,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QAC5D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,eAAe,CAAC;gBACpB,KAAK;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxE,IACE,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;YACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,EACtC,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,qBAAqB,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YAChD,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC9C,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,QAAQ,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/bin/session/actions/ShellQueryActions.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shell query/read/wait/close actions。
+ *
+ * 关键点（中文）
+ * - 聚合不创建新进程的 session 操作。
+ * - close 只负责单个 session，runtime shutdown 使用 lifecycle action。
+ */
+import type { ShellHostContext } from "../../types/ShellHostContext.js";
+import type { ShellRuntimeState } from "../../session/ShellRuntimeTypes.js";
+import type { ShellActionResponse, ShellCloseRequest, ShellQueryRequest, ShellReadRequest, ShellWaitRequest } from "../../types/ShellAction.js";
+/**
+ * 查询 shell session 状态。
+ */
+export declare function getShellSessionStatus(state: ShellRuntimeState, context: ShellHostContext, request: ShellQueryRequest): Promise<ShellActionResponse>;
+/**
+ * 读取 shell session 输出。
+ */
+export declare function readShellSession(state: ShellRuntimeState, context: ShellHostContext, request: ShellReadRequest): Promise<ShellActionResponse>;
+/**
+ * 等待 shell session 状态变化。
+ */
+export declare function waitShellSession(state: ShellRuntimeState, context: ShellHostContext, request: ShellWaitRequest): Promise<ShellActionResponse>;
+/**
+ * 关闭 shell session。
+ */
+export declare function closeShellSession(state: ShellRuntimeState, context: ShellHostContext, request: ShellCloseRequest): Promise<ShellActionResponse>;
+//# sourceMappingURL=ShellQueryActions.d.ts.map

package/bin/session/actions/ShellQueryActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellQueryActions.d.ts","sourceRoot":"","sources":["../../../src/session/actions/ShellQueryActions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAahC;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAW9B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAmB9B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAiE9B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAuC9B"}

package/bin/session/actions/ShellQueryActions.js

@@ -0,0 +1,151 @@
+/**
+ * Shell query/read/wait/close actions。
+ *
+ * 关键点（中文）
+ * - 聚合不创建新进程的 session 操作。
+ * - close 只负责单个 session，runtime shutdown 使用 lifecycle action。
+ */
+import { buildActionResponse, clampWaitMsWithOptions, createOutputChunk, isInMemorySession, isTerminalStatus, nowMs, resolveSession, scheduleCleanup, updateSessionSnapshot, } from "../ShellActionRuntimeSupport.js";
+/**
+ * 查询 shell session 状态。
+ */
+export async function getShellSessionStatus(state, context, request) {
+    const session = await resolveSession(state, context, {
+        ...request,
+        includeCompleted: request.includeCompleted !== false,
+    });
+    if (!session) {
+        throw new Error("shell session not found");
+    }
+    return buildActionResponse({
+        shell: session.snapshot,
+    });
+}
+/**
+ * 读取 shell session 输出。
+ */
+export async function readShellSession(state, context, request) {
+    const session = await resolveSession(state, context, {
+        ...request,
+        includeCompleted: request.includeCompleted !== false,
+    });
+    if (!session) {
+        throw new Error("shell session not found");
+    }
+    const chunk = createOutputChunk({
+        shellId: session.snapshot.shellId,
+        outputText: session.outputText,
+        fromCursor: request.fromCursor,
+        context,
+        maxOutputTokens: request.maxOutputTokens,
+    });
+    return buildActionResponse({
+        shell: session.snapshot,
+        chunk,
+    });
+}
+/**
+ * 等待 shell session 状态变化。
+ */
+export async function waitShellSession(state, context, request) {
+    const shellId = String(request.shellId || "").trim();
+    if (!shellId)
+        throw new Error("shell.wait requires shellId");
+    const session = await resolveSession(state, context, {
+        shellId,
+        includeCompleted: true,
+    });
+    if (!session)
+        throw new Error("shell session not found");
+    if (isInMemorySession(session) &&
+        typeof request.afterVersion === "number" &&
+        session.snapshot.version <= request.afterVersion &&
+        (session.snapshot.status === "running" || session.snapshot.status === "starting")) {
+        const afterVersion = request.afterVersion;
+        await new Promise((resolve) => {
+            let settled = false;
+            let waiter;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(waiter.timer);
+                session.waiters.delete(waiter);
+                resolve();
+            };
+            const timer = setTimeout(() => {
+                finish();
+            }, clampWaitMsWithOptions(state.options, request.timeoutMs, state.options.defaultWaitTimeoutMs));
+            waiter = {
+                resolve: finish,
+                timer,
+            };
+            session.waiters.add(waiter);
+            // 关键点（中文）：注册 waiter 后立刻复查，避免状态变化发生在判断和注册之间。
+            if (session.snapshot.version > afterVersion ||
+                isTerminalStatus(session.snapshot.status)) {
+                finish();
+            }
+        });
+    }
+    const refreshed = await resolveSession(state, context, {
+        shellId,
+        includeCompleted: true,
+    });
+    if (!refreshed)
+        throw new Error("shell session not found after wait");
+    const chunk = createOutputChunk({
+        shellId,
+        outputText: refreshed.outputText,
+        fromCursor: request.fromCursor,
+        context,
+        maxOutputTokens: request.maxOutputTokens,
+    });
+    return buildActionResponse({
+        shell: refreshed.snapshot,
+        chunk,
+    });
+}
+/**
+ * 关闭 shell session。
+ */
+export async function closeShellSession(state, context, request) {
+    const shellId = String(request.shellId || "").trim();
+    if (!shellId)
+        throw new Error("shell.close requires shellId");
+    const session = await resolveSession(state, context, {
+        shellId,
+        includeCompleted: true,
+    });
+    if (!session)
+        throw new Error("shell session not found");
+    if (!isInMemorySession(session)) {
+        return buildActionResponse({
+            shell: session.snapshot,
+            note: "shell already completed and only persisted snapshot remains",
+        });
+    }
+    if (session.cleanupTimer) {
+        clearTimeout(session.cleanupTimer);
+        session.cleanupTimer = null;
+    }
+    if (session.snapshot.status === "running" || session.snapshot.status === "starting") {
+        try {
+            session.child.kill(request.force === true ? "SIGKILL" : "SIGTERM");
+        }
+        catch {
+            // ignore
+        }
+        await updateSessionSnapshot(session, (snapshot) => {
+            snapshot.status = request.force === true ? "killed" : "failed";
+            snapshot.exitCode = request.force === true ? -9 : -15;
+            snapshot.endedAt = nowMs();
+        });
+    }
+    scheduleCleanup(state, shellId);
+    return buildActionResponse({
+        shell: session.snapshot,
+        note: "shell close requested",
+    });
+}
+//# sourceMappingURL=ShellQueryActions.js.map

package/bin/session/actions/ShellQueryActions.js.map

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

package/bin/session/actions/ShellStartActions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shell start action。
+ *
+ * 关键点（中文）
+ * - 负责创建 shell session、发起 unrestricted 审批、启动子进程并返回初始输出。
+ * - 长轮询与读取逻辑仍由 query actions 提供。
+ */
+import type { ShellHostContext } from "../../types/ShellHostContext.js";
+import type { ShellRuntimeState } from "../../session/ShellRuntimeTypes.js";
+import type { ShellActionResponse, ShellStartRequest } from "../../types/ShellAction.js";
+/**
+ * 启动一个 shell session。
+ */
+export declare function startShellSession(state: ShellRuntimeState, context: ShellHostContext, request: ShellStartRequest): Promise<ShellActionResponse>;
+//# sourceMappingURL=ShellStartActions.d.ts.map

package/bin/session/actions/ShellStartActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellStartActions.d.ts","sourceRoot":"","sources":["../../../src/session/actions/ShellStartActions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AA2BhC;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA+J9B"}

package/bin/session/actions/ShellStartActions.js

@@ -0,0 +1,167 @@
+/**
+ * Shell start action。
+ *
+ * 关键点（中文）
+ * - 负责创建 shell session、发起 unrestricted 审批、启动子进程并返回初始输出。
+ * - 长轮询与读取逻辑仍由 query actions 提供。
+ */
+import fs from "fs-extra";
+import { spawnShellProcess } from "../../sandbox/SandboxRunner.js";
+import { generateId } from "../../utils/Id.js";
+import { getShellDir, getShellOutputPath, getShellSnapshotPath } from "../Paths.js";
+import { buildActionResponse, buildShellEnv, clampWaitMsWithOptions, createOutputChunk, ensureCapacity, isInMemorySession, persistSnapshot, resolveOwnerContextId, resolveSession, resolveShellCwd, } from "../ShellActionRuntimeSupport.js";
+import { attachShellProcessEventHandlers } from "../ShellProcessEvents.js";
+import { requestUnrestrictedApproval, validateUnrestrictedRequest, } from "../../approval/ShellApprovalRuntime.js";
+import { buildDeniedApprovalResponse, resolveDefaultShellPath, resolveSandboxMode, } from "./ShellActionShared.js";
+import { bindShellRuntime } from "./ShellLifecycleActions.js";
+import { waitShellSession } from "./ShellQueryActions.js";
+/**
+ * 启动一个 shell session。
+ */
+export async function startShellSession(state, context, request) {
+    const cmd = String(request.cmd || "").trim();
+    if (!cmd)
+        throw new Error("shell.start requires a non-empty cmd");
+    ensureCapacity(state);
+    bindShellRuntime(state, context);
+    const shellId = `sh_${generateId()}`;
+    const cwd = resolveShellCwd(context, request.cwd);
+    const shellPath = String(request.shell || resolveDefaultShellPath()).trim() || resolveDefaultShellPath();
+    const login = request.login !== false;
+    const sandboxMode = resolveSandboxMode(request.sandbox);
+    const reason = String(request.reason || "").trim();
+    const ownerContextId = resolveOwnerContextId(context, request.ownerContextId);
+    const shellDir = getShellDir(context.rootPath, shellId);
+    const snapshotFilePath = getShellSnapshotPath(context.rootPath, shellId);
+    const outputFilePath = getShellOutputPath(context.rootPath, shellId);
+    await fs.ensureDir(shellDir);
+    await fs.writeFile(outputFilePath, "", "utf-8");
+    let approvalId;
+    let approvalStatus;
+    if (sandboxMode === "unrestricted") {
+        const validationError = validateUnrestrictedRequest({ cmd, reason });
+        if (validationError)
+            throw new Error(validationError);
+        const approval = await requestUnrestrictedApproval({
+            state,
+            context,
+            shellId,
+            toolName: request.approvalToolName || "shell_start",
+            cmd,
+            cwd,
+            reason,
+            ...(ownerContextId ? { ownerContextId } : {}),
+        });
+        approvalId = approval.approvalId;
+        approvalStatus = approval.status;
+        if (approval.status !== "approved") {
+            return buildDeniedApprovalResponse({
+                shellId,
+                ...(ownerContextId ? { ownerContextId } : {}),
+                cmd,
+                cwd,
+                shellPath,
+                approvalId: approval.approvalId,
+                reason,
+                approvalStatus: approval.status,
+            });
+        }
+    }
+    const spawnResult = await spawnShellProcess({
+        context,
+        shellId,
+        shellDir,
+        cmd,
+        cwd,
+        shellPath,
+        login,
+        baseEnv: buildShellEnv(context),
+        sandboxMode,
+    });
+    const child = spawnResult.child;
+    const actualCwd = spawnResult.cwd;
+    const startedAt = Date.now();
+    let resolveCompletion = () => { };
+    const completionPromise = new Promise((resolve) => {
+        resolveCompletion = resolve;
+    });
+    const session = {
+        snapshot: {
+            shellId,
+            ...(ownerContextId ? { ownerContextId } : {}),
+            cmd,
+            cwd: actualCwd,
+            shellPath,
+            sandboxed: spawnResult.sandboxed,
+            sandboxMode: spawnResult.sandboxMode || sandboxMode,
+            sandboxBackend: spawnResult.backend,
+            sandboxNetworkMode: spawnResult.networkMode,
+            sandboxDir: spawnResult.sandboxDir,
+            sandboxHomeDir: spawnResult.homeDir,
+            sandboxTmpDir: spawnResult.tmpDir,
+            sandboxCacheDir: spawnResult.cacheDir,
+            ...(approvalStatus ? { approvalStatus } : {}),
+            ...(approvalId ? { approvalId } : {}),
+            ...(reason ? { approvalReason: reason } : {}),
+            stdinWritable: true,
+            status: "running",
+            ...(typeof child.pid === "number" ? { pid: child.pid } : {}),
+            startedAt,
+            updatedAt: startedAt,
+            outputChars: 0,
+            droppedChars: 0,
+            version: 1,
+            autoNotifyOnExit: request.autoNotifyOnExit === true,
+            notificationSent: false,
+            externalRefs: [],
+        },
+        child,
+        outputText: "",
+        outputFilePath,
+        snapshotFilePath,
+        writeChain: Promise.resolve(),
+        cleanupTimer: null,
+        waiters: new Set(),
+        completionPromise,
+        resolveCompletion,
+    };
+    state.sessions.set(shellId, session);
+    // 关键点（中文）：监听器必须先挂上，避免瞬时命令在 snapshot 持久化期间退出而丢失 close 事件。
+    attachShellProcessEventHandlers({ state, session });
+    await persistSnapshot(session);
+    const inlineWaitMs = clampWaitMsWithOptions(state.options, request.inlineWaitMs, state.options.defaultInlineWaitMs);
+    await waitShellSession(state, context, {
+        shellId,
+        afterVersion: 1,
+        fromCursor: 0,
+        timeoutMs: inlineWaitMs,
+        maxOutputTokens: request.maxOutputTokens,
+    }).catch(() => undefined);
+    const latest = await resolveSession(state, context, { shellId, includeCompleted: true });
+    if (!latest) {
+        throw new Error(`shell session disappeared unexpectedly: ${shellId}`);
+    }
+    if (isInMemorySession(latest) &&
+        latest.snapshot.status === "running" &&
+        latest.snapshot.autoNotifyOnExit === false &&
+        request.autoNotifyOnExit !== false &&
+        Boolean(ownerContextId)) {
+        latest.snapshot.autoNotifyOnExit = true;
+        await persistSnapshot(latest);
+    }
+    const chunk = createOutputChunk({
+        shellId,
+        outputText: latest.outputText,
+        fromCursor: 0,
+        context,
+        maxOutputTokens: request.maxOutputTokens,
+    });
+    return buildActionResponse({
+        shell: latest.snapshot,
+        chunk,
+        note: latest.snapshot.status === "running"
+            ? "shell started and is still running"
+            : "shell finished during inline wait",
+    });
+}
+//# sourceMappingURL=ShellStartActions.js.map

package/bin/session/actions/ShellStartActions.js.map

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

package/bin/session/actions/ShellWriteActions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shell write action。
+ *
+ * 关键点（中文）
+ * - safe shell 可直接写入 stdin。
+ * - unrestricted shell 每次写入都必须带 reason 并完成审批。
+ */
+import type { ShellHostContext } from "../../types/ShellHostContext.js";
+import type { ShellRuntimeState } from "../../session/ShellRuntimeTypes.js";
+import type { ShellActionResponse, ShellWriteRequest } from "../../types/ShellAction.js";
+/**
+ * 向 shell session 写入 stdin。
+ */
+export declare function writeShellSession(state: ShellRuntimeState, context: ShellHostContext, request: ShellWriteRequest): Promise<ShellActionResponse>;
+//# sourceMappingURL=ShellWriteActions.d.ts.map

package/bin/session/actions/ShellWriteActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellWriteActions.d.ts","sourceRoot":"","sources":["../../../src/session/actions/ShellWriteActions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAYhC;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAqE9B"}

package/bin/session/actions/ShellWriteActions.js

@@ -0,0 +1,85 @@
+/**
+ * Shell write action。
+ *
+ * 关键点（中文）
+ * - safe shell 可直接写入 stdin。
+ * - unrestricted shell 每次写入都必须带 reason 并完成审批。
+ */
+import { buildActionResponse, isInMemorySession, resolveSession, } from "../ShellActionRuntimeSupport.js";
+import { requestUnrestrictedApproval, validateUnrestrictedRequest, } from "../../approval/ShellApprovalRuntime.js";
+import { buildDeniedWriteApprovalResponse } from "./ShellActionShared.js";
+/**
+ * 向 shell session 写入 stdin。
+ */
+export async function writeShellSession(state, context, request) {
+    const shellId = String(request.shellId || "").trim();
+    const chars = String(request.chars ?? "");
+    if (!shellId)
+        throw new Error("shell.write requires shellId");
+    const session = await resolveSession(state, context, {
+        shellId,
+        includeCompleted: true,
+    });
+    if (!session || !isInMemorySession(session)) {
+        throw new Error("shell session is not active in memory");
+    }
+    if (session.snapshot.status !== "running" && session.snapshot.status !== "starting") {
+        throw new Error(`shell session ${shellId} is not running`);
+    }
+    if (!session.child.stdin.writable) {
+        throw new Error(`shell session ${shellId} stdin is closed`);
+    }
+    if (session.snapshot.stdinWritable === false) {
+        throw new Error(`shell session ${shellId} stdin is closed`);
+    }
+    let approvalId;
+    let approvalStatus;
+    const reason = String(request.reason || "").trim();
+    if (session.snapshot.sandboxMode === "unrestricted") {
+        const validationError = validateUnrestrictedRequest({ cmd: chars, reason });
+        if (validationError)
+            throw new Error(validationError);
+        const approval = await requestUnrestrictedApproval({
+            state,
+            context,
+            shellId,
+            toolName: "shell_write",
+            cmd: chars,
+            cwd: session.snapshot.cwd,
+            reason,
+            ...(session.snapshot.ownerContextId ? { ownerContextId: session.snapshot.ownerContextId } : {}),
+            inputPreview: chars,
+            inputChars: chars.length,
+        });
+        approvalId = approval.approvalId;
+        approvalStatus = approval.status;
+        if (approval.status !== "approved") {
+            return buildDeniedWriteApprovalResponse({
+                session,
+                approvalId: approval.approvalId,
+                reason,
+                approvalStatus: approval.status,
+            });
+        }
+    }
+    await new Promise((resolve, reject) => {
+        session.child.stdin.write(chars, (error) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+    return buildActionResponse({
+        shell: {
+            ...session.snapshot,
+            ...(approvalStatus ? { approvalStatus } : {}),
+            ...(approvalId ? { approvalId } : {}),
+            ...(reason ? { approvalReason: reason } : {}),
+            stdinWritable: true,
+        },
+        note: chars ? "stdin written" : "no chars written",
+    });
+}
+//# sourceMappingURL=ShellWriteActions.js.map

package/bin/session/actions/ShellWriteActions.js.map

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

package/bin/tool/ShellToolFormatting.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shell tool 辅助函数。
+ *
+ * 关键点（中文）
+ * - 这里只保留 shell tool 自身的输入保护逻辑。
+ * - 不解析 Agent 私有输出协议，不向 session 注入消息。
+ */
+/**
+ * 对聊天发送命令做前置安全校验。
+ */
+export declare function validateChatSendCommand(cmd: string): string | null;
+//# sourceMappingURL=ShellToolFormatting.d.ts.map

package/bin/tool/ShellToolFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellToolFormatting.d.ts","sourceRoot":"","sources":["../../src/tool/ShellToolFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBlE"}

package/bin/tool/ShellToolFormatting.js

@@ -0,0 +1,31 @@
+/**
+ * Shell tool 辅助函数。
+ *
+ * 关键点（中文）
+ * - 这里只保留 shell tool 自身的输入保护逻辑。
+ * - 不解析 Agent 私有输出协议，不向 session 注入消息。
+ */
+/**
+ * 对聊天发送命令做前置安全校验。
+ */
+export function validateChatSendCommand(cmd) {
+    const source = String(cmd ?? "");
+    if (!/\b(?:bay|town)\s+chat\s+send\b/.test(source))
+        return null;
+    if (!/[\r\n]/.test(source))
+        return null;
+    if (/\b(?:bay|town)\s+chat\s+send\b[\s\S]*\s--stdin(?:\s|$)/.test(source)) {
+        return null;
+    }
+    if (/\b(?:bay|town)\s+chat\s+send\b[\s\S]*\s--text(?:\s|$)/.test(source)) {
+        return null;
+    }
+    if (/\b(?:bay|town)\s+chat\s+send\b[\s\S]*\s--text-file(?:\s|$)/.test(source)) {
+        return null;
+    }
+    return [
+        "Unsafe chat send command: real newlines are not allowed.",
+        "If your message is multi-line, use chat send --stdin, --text-file, or explicit --text.",
+    ].join(" ");
+}
+//# sourceMappingURL=ShellToolFormatting.js.map

package/bin/tool/ShellToolFormatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellToolFormatting.js","sourceRoot":"","sources":["../../src/tool/ShellToolFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,wDAAwD,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,uDAAuD,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,4DAA4D,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,0DAA0D;QAC1D,wFAAwF;KACzF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}