@downcity/plugins 1.0.64 → 1.0.71

package/src/task/runtime/TaskRunnerSession.ts

@@ -9,7 +9,7 @@
  */
 
 import path from "node:path";
-import type { LanguageModel } from "ai";
+import type { LanguageModel, Tool } from "ai";
 import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
 import { Executor } from "@downcity/agent/internal/executor/Executor.js";
 import type { SessionRunResult } from "@downcity/agent/internal/executor/types/SessionRun.js";
@@ -20,7 +20,7 @@ import { JsonlSessionHistoryStore } from "@downcity/agent/internal/executor/stor
 import { JsonlSessionCompactionComposer } from "@downcity/agent/internal/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
 import { LocalSessionContextComposer } from "@downcity/agent/internal/executor/composer/context/LocalSessionContextComposer.js";
 import { DefaultSessionSystemComposer } from "@downcity/agent/internal/executor/composer/system/default/DefaultSessionSystemComposer.js";
-import { shellTools } from "@downcity/agent/internal/executor/tools/shell/ShellToolDefinition.js";
+import { Shell } from "@downcity/shell";
 import type { SessionExecutor } from "@downcity/agent/internal/executor/types/SessionExecutor.js";
 
 /**
@@ -83,6 +83,13 @@ export function createTaskSessionRuntimePort(params: {
   const historyStoresBySessionId = new Map<string, JsonlSessionHistoryStore>();
   const historyComposersBySessionId = new Map<string, JsonlSessionHistoryComposer>();
   const runtimesBySessionId = new Map<string, SessionExecutor>();
+  const shell = new Shell({
+    root_path: context.rootPath,
+    env: context.env,
+    sandbox: context.config.sandbox,
+    logger: context.logger,
+  });
+  const shell_tools = shell.tools as unknown as Record<string, Tool>;
 
   const resolveTaskHistoryStore = (sessionId: string): JsonlSessionHistoryStore => {
     const existing = historyStoresBySessionId.get(sessionId);
@@ -145,7 +152,7 @@ export function createTaskSessionRuntimePort(params: {
       const historyComposer = resolveTaskHistoryComposer(key);
       const contextComposer = new LocalSessionContextComposer({
         sessionId: key,
-        getTools: () => shellTools,
+        getTools: () => shell_tools,
       });
       const created = new Executor({
         sessionId: key,
@@ -156,7 +163,7 @@ export function createTaskSessionRuntimePort(params: {
         compactionComposer,
         contextComposer,
         systemComposer,
-        getTools: () => shellTools,
+        getTools: () => shell_tools,
       });
       runtimesBySessionId.set(key, created);
       return created;

package/bin/shell/Index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Shell Plugin 导出入口。
- *
- * 关键点（中文）
- * - Index 只负责导出类实现。
- * - 真正运行时的 per-agent 实例由宿主显式创建并传给 Agent。
- */
-export { ShellPlugin } from "./ShellPlugin.js";
-//# sourceMappingURL=Index.d.ts.map

package/bin/shell/Index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../../src/shell/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/shell/Index.js

@@ -1,9 +0,0 @@
-/**
- * Shell Plugin 导出入口。
- *
- * 关键点（中文）
- * - Index 只负责导出类实现。
- * - 真正运行时的 per-agent 实例由宿主显式创建并传给 Agent。
- */
-export { ShellPlugin } from "./ShellPlugin.js";
-//# sourceMappingURL=Index.js.map

package/bin/shell/Index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../src/shell/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/shell/ShellPlugin.d.ts

@@ -1,65 +0,0 @@
-/**
- * ShellPlugin：shell plugin 的类实现。
- *
- * 关键点（中文）
- * - shell session map 与 bound runtime 都归属于 plugin 实例。
- * - agent 持有 ShellPlugin 实例，从而形成 per-agent shell 状态边界。
- * - ShellActionRuntime 只保留纯运行时流程，不再承载模块级单例状态。
- */
-import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
-import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
-import type { ShellSessionRuntimeState } from "../shell/ShellRuntimeTypes.js";
-import type { ShellPluginOptions } from "../shell/types/ShellPluginOptions.js";
-import type { ShellCloseRequest, ShellExecRequest, ShellQueryRequest, ShellReadRequest, ShellStartRequest, ShellWaitRequest, ShellWriteRequest } from "@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js";
-/**
- * Shell plugin 类实现。
- */
-export declare class ShellPlugin extends BasePlugin {
-    /**
-     * plugin 名称。
-     */
-    readonly name = "shell";
-    /**
-     * 当前实例持有的 shell 状态对象。
-     */
-    private readonly state;
-    /**
-     * 当前实例暴露的 action 定义表。
-     */
-    readonly actions: PluginActions;
-    /**
-     * 当前实例持有的 in-memory shell sessions。
-     */
-    readonly sessions: Map<string, ShellSessionRuntimeState>;
-    constructor(options?: ShellPluginOptions);
-    /**
-     * 启动一个 shell session。
-     */
-    start(context: AgentContext, request: ShellStartRequest): Promise<import("@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js").ShellActionResponse>;
-    /**
-     * 查询 shell session 状态。
-     */
-    status(context: AgentContext, request: ShellQueryRequest): Promise<import("@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js").ShellActionResponse>;
-    /**
-     * 读取 shell session 输出。
-     */
-    read(context: AgentContext, request: ShellReadRequest): Promise<import("@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js").ShellActionResponse>;
-    /**
-     * 向 shell session 写入 stdin。
-     */
-    write(context: AgentContext, request: ShellWriteRequest): Promise<import("@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js").ShellActionResponse>;
-    /**
-     * 等待 shell session 状态变化。
-     */
-    wait(context: AgentContext, request: ShellWaitRequest): Promise<import("@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js").ShellActionResponse>;
-    /**
-     * 关闭 shell session。
-     */
-    close(context: AgentContext, request: ShellCloseRequest): Promise<import("@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js").ShellActionResponse>;
-    /**
-     * 执行一次 one-shot shell command。
-     */
-    exec(context: AgentContext, request: ShellExecRequest): Promise<import("@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js").ShellActionResponse>;
-}
-//# sourceMappingURL=ShellPlugin.d.ts.map

package/bin/shell/ShellPlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellPlugin.d.ts","sourceRoot":"","sources":["../../src/shell/ShellPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAEV,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,oEAAoE,CAAC;AAiB5E;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC;;OAEG;IACH,QAAQ,CAAC,IAAI,WAAW;IAExB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAEzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC;;OAEG;IACH,SAAgB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;gBAEpD,OAAO,GAAE,kBAAuB;IAuG5C;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB;IAK5B;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB;IAK5B;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB;IAK3B;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB;IAK5B;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB;IAK3B;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB;IAK5B;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB;CAI5B"}

package/bin/shell/ShellPlugin.js

@@ -1,175 +0,0 @@
-/**
- * ShellPlugin：shell plugin 的类实现。
- *
- * 关键点（中文）
- * - shell session map 与 bound runtime 都归属于 plugin 实例。
- * - agent 持有 ShellPlugin 实例，从而形成 per-agent shell 状态边界。
- * - ShellActionRuntime 只保留纯运行时流程，不再承载模块级单例状态。
- */
-import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-import { bindShellRuntime, closeAllShellSessions, closeShellSession, createShellPluginState, approveShellApproval, denyShellApproval, execShellCommand, getShellSessionStatus, listShellApprovals, readShellSession, startShellSession, waitShellSession, writeShellSession, } from "./runtime/ShellActionRuntime.js";
-/**
- * Shell plugin 类实现。
- */
-export class ShellPlugin extends BasePlugin {
-    /**
-     * plugin 名称。
-     */
-    name = "shell";
-    /**
-     * 当前实例持有的 shell 状态对象。
-     */
-    state;
-    /**
-     * 当前实例暴露的 action 定义表。
-     */
-    actions;
-    /**
-     * 当前实例持有的 in-memory shell sessions。
-     */
-    sessions;
-    constructor(options = {}) {
-        super();
-        this.state = createShellPluginState(options);
-        this.sessions = this.state.sessions;
-        this.actions = {
-            exec: {
-                execute: async (params) => ({
-                    success: true,
-                    data: await this.exec(params.context, params.payload),
-                }),
-            },
-            start: {
-                execute: async (params) => ({
-                    success: true,
-                    data: await this.start(params.context, params.payload),
-                }),
-            },
-            status: {
-                execute: async (params) => ({
-                    success: true,
-                    data: await this.status(params.context, params.payload),
-                }),
-            },
-            read: {
-                execute: async (params) => ({
-                    success: true,
-                    data: await this.read(params.context, params.payload),
-                }),
-            },
-            write: {
-                execute: async (params) => ({
-                    success: true,
-                    data: await this.write(params.context, params.payload),
-                }),
-            },
-            wait: {
-                execute: async (params) => ({
-                    success: true,
-                    data: await this.wait(params.context, params.payload),
-                }),
-            },
-            close: {
-                execute: async (params) => ({
-                    success: true,
-                    data: await this.close(params.context, params.payload),
-                }),
-            },
-            approvals: {
-                execute: async () => ({
-                    success: true,
-                    data: { approvals: listShellApprovals(this.state) },
-                }),
-            },
-            approve: {
-                execute: async (params) => {
-                    const payload = params.payload;
-                    const approvalId = String(payload?.approvalId || payload?.approval_id || "").trim();
-                    if (!approvalId) {
-                        return { success: false, error: "approvalId is required" };
-                    }
-                    const ok = await approveShellApproval(this.state, params.context, approvalId);
-                    return {
-                        success: ok,
-                        data: { approvalId, approved: ok },
-                        ...(ok ? {} : { error: "approval request not found" }),
-                    };
-                },
-            },
-            deny: {
-                execute: async (params) => {
-                    const payload = params.payload;
-                    const approvalId = String(payload?.approvalId || payload?.approval_id || "").trim();
-                    if (!approvalId) {
-                        return { success: false, error: "approvalId is required" };
-                    }
-                    const ok = await denyShellApproval(this.state, params.context, approvalId);
-                    return {
-                        success: ok,
-                        data: { approvalId, denied: ok },
-                        ...(ok ? {} : { error: "approval request not found" }),
-                    };
-                },
-            },
-        };
-        this.lifecycle = {
-            start: async (context) => {
-                bindShellRuntime(this.state, context);
-            },
-            stop: async () => {
-                await closeAllShellSessions(this.state, true);
-                for (const session of this.state.sessions.values()) {
-                    if (session.cleanupTimer) {
-                        clearTimeout(session.cleanupTimer);
-                    }
-                }
-                this.state.sessions.clear();
-                this.state.approvals.clear();
-                this.state.context = null;
-            },
-        };
-    }
-    /**
-     * 启动一个 shell session。
-     */
-    async start(context, request) {
-        return await startShellSession(this.state, context, request);
-    }
-    /**
-     * 查询 shell session 状态。
-     */
-    async status(context, request) {
-        return await getShellSessionStatus(this.state, context, request);
-    }
-    /**
-     * 读取 shell session 输出。
-     */
-    async read(context, request) {
-        return await readShellSession(this.state, context, request);
-    }
-    /**
-     * 向 shell session 写入 stdin。
-     */
-    async write(context, request) {
-        return await writeShellSession(this.state, context, request);
-    }
-    /**
-     * 等待 shell session 状态变化。
-     */
-    async wait(context, request) {
-        return await waitShellSession(this.state, context, request);
-    }
-    /**
-     * 关闭 shell session。
-     */
-    async close(context, request) {
-        return await closeShellSession(this.state, context, request);
-    }
-    /**
-     * 执行一次 one-shot shell command。
-     */
-    async exec(context, request) {
-        return await execShellCommand(this.state, context, request);
-    }
-}
-//# sourceMappingURL=ShellPlugin.js.map

package/bin/shell/ShellPlugin.js.map

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

package/bin/shell/ShellRuntimeTypes.d.ts

@@ -1,145 +0,0 @@
-/**
- * ShellRuntime 类型定义。
- *
- * 关键点（中文）
- * - 这些类型描述 shell plugin runtime 的实例级运行态。
- * - 状态所有权归属于 `ShellPlugin` 实例，而不是模块级单例。
- * - 统一归档到 `src/shell/` 相邻层级，避免继续分散在跨域目录里。
- */
-import type { ChildProcessWithoutNullStreams } from "node:child_process";
-import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
-import type { ShellApprovalStatus, ShellSessionSnapshot } from "@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js";
-import type { ResolvedShellPluginOptions } from "../shell/types/ShellPluginOptions.js";
-/**
- * unrestricted sandbox 审批运行态。
- */
-export type ShellApprovalRuntimeState = {
-    /**
-     * 当前审批请求 ID。
-     */
-    approvalId: string;
-    /**
-     * 关联的 shell_id。
-     */
-    shellId: string;
-    /**
-     * 所属 session/聊天上下文。
-     */
-    ownerContextId?: string;
-    /**
-     * 关联工具名。
-     */
-    toolName: "shell_exec" | "shell_start";
-    /**
-     * 申请执行的命令。
-     */
-    cmd: string;
-    /**
-     * 命令执行目录。
-     */
-    cwd: string;
-    /**
-     * 申请原因。
-     */
-    reason: string;
-    /**
-     * 当前审批创建时间。
-     */
-    createdAt: number;
-    /**
-     * 审批超时定时器。
-     */
-    timer: NodeJS.Timeout;
-    /**
-     * 兑现审批结果。
-     */
-    resolve: (status: ShellApprovalStatus) => void;
-};
-/**
- * 单个 shell wait 调用挂起时注册的 waiter。
- */
-export type ShellSessionWaiter = {
-    /**
-     * 当前等待完成后的唤醒回调。
-     */
-    resolve: () => void;
-    /**
-     * 当前 waiter 对应的超时定时器。
-     */
-    timer: NodeJS.Timeout;
-};
-/**
- * 单个 shell session 的内存运行态。
- */
-export type ShellSessionRuntimeState = {
-    /**
-     * 当前 shell session 的对外快照。
-     */
-    snapshot: ShellSessionSnapshot;
-    /**
-     * 当前 shell session 对应的子进程句柄。
-     */
-    child: ChildProcessWithoutNullStreams;
-    /**
-     * 当前已缓存的标准输出与标准错误文本。
-     */
-    outputText: string;
-    /**
-     * 当前输出持久化文件路径。
-     */
-    outputFilePath: string;
-    /**
-     * 当前快照持久化文件路径。
-     */
-    snapshotFilePath: string;
-    /**
-     * 串行化文件写入链，避免并发 append 乱序。
-     */
-    writeChain: Promise<void>;
-    /**
-     * 终态后的延迟清理定时器。
-     */
-    cleanupTimer: NodeJS.Timeout | null;
-    /**
-     * 当前挂起等待该 session 状态变化的 waiter 集合。
-     */
-    waiters: Set<ShellSessionWaiter>;
-    /**
-     * 当前 shell 进入终态后的完成 promise。
-     *
-     * 关键点（中文）
-     * - 供 `shell.exec` 这类 one-shot 路径直接等待进程结束。
-     * - 这样可以减少对版本轮询的依赖，降低瞬时命令的竞态超时。
-     */
-    completionPromise: Promise<void>;
-    /**
-     * 当前 shell 进入终态时触发的完成回调。
-     */
-    resolveCompletion: () => void;
-};
-/**
- * `ShellPlugin` 实例级状态。
- */
-export type ShellPluginState = {
-    /**
-     * 当前 shell plugin 归一化后的运行参数。
-     */
-    options: ResolvedShellPluginOptions;
-    /**
-     * 当前实例持有的全部 in-memory shell session。
-     */
-    sessions: Map<string, ShellSessionRuntimeState>;
-    /**
-     * 当前实例持有的全部 pending unrestricted sandbox 审批。
-     */
-    approvals: Map<string, ShellApprovalRuntimeState>;
-    /**
-     * 当前实例最近一次启动时绑定的 agent context。
-     *
-     * 关键点（中文）
-     * - 仅用于 shell 自动通知 chat 的回调路径。
-     * - 这是实例字段，不再是模块级全局变量。
-     */
-    context: AgentContext | null;
-};
-//# sourceMappingURL=ShellRuntimeTypes.d.ts.map

package/bin/shell/ShellRuntimeTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellRuntimeTypes.d.ts","sourceRoot":"","sources":["../../src/shell/ShellRuntimeTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,oEAAoE,CAAC;AAC5E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,EAAE,YAAY,GAAG,aAAa,CAAC;IACvC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAC/B;;OAEG;IACH,KAAK,EAAE,8BAA8B,CAAC;IACtC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACpC;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,iBAAiB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC;;OAEG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,OAAO,EAAE,0BAA0B,CAAC;IACpC;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAChD;;OAEG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAClD;;;;;;OAMG;IACH,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B,CAAC"}

package/bin/shell/ShellRuntimeTypes.js

@@ -1,10 +0,0 @@
-/**
- * ShellRuntime 类型定义。
- *
- * 关键点（中文）
- * - 这些类型描述 shell plugin runtime 的实例级运行态。
- * - 状态所有权归属于 `ShellPlugin` 实例，而不是模块级单例。
- * - 统一归档到 `src/shell/` 相邻层级，避免继续分散在跨域目录里。
- */
-export {};
-//# sourceMappingURL=ShellRuntimeTypes.js.map

package/bin/shell/ShellRuntimeTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellRuntimeTypes.js","sourceRoot":"","sources":["../../src/shell/ShellRuntimeTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/shell/runtime/Paths.d.ts

@@ -1,12 +0,0 @@
-/**
- * Shell service 路径工具。
- *
- * 关键点（中文）
- * - shell 运行产物统一落在 `.downcity/shell/<shellId>/`。
- * - 目录结构简单稳定，便于调试与后续恢复。
- */
-export declare function getShellRootDir(projectRoot: string): string;
-export declare function getShellDir(projectRoot: string, shellId: string): string;
-export declare function getShellSnapshotPath(projectRoot: string, shellId: string): string;
-export declare function getShellOutputPath(projectRoot: string, shellId: string): string;
-//# sourceMappingURL=Paths.d.ts.map

package/bin/shell/runtime/Paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../../src/shell/runtime/Paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E"}

package/bin/shell/runtime/Paths.js

@@ -1,21 +0,0 @@
-/**
- * Shell service 路径工具。
- *
- * 关键点（中文）
- * - shell 运行产物统一落在 `.downcity/shell/<shellId>/`。
- * - 目录结构简单稳定，便于调试与后续恢复。
- */
-import path from "node:path";
-export function getShellRootDir(projectRoot) {
-    return path.join(projectRoot, ".downcity", "shell");
-}
-export function getShellDir(projectRoot, shellId) {
-    return path.join(getShellRootDir(projectRoot), String(shellId || "").trim());
-}
-export function getShellSnapshotPath(projectRoot, shellId) {
-    return path.join(getShellDir(projectRoot, shellId), "snapshot.json");
-}
-export function getShellOutputPath(projectRoot, shellId) {
-    return path.join(getShellDir(projectRoot, shellId), "output.log");
-}
-//# sourceMappingURL=Paths.js.map

package/bin/shell/runtime/Paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Paths.js","sourceRoot":"","sources":["../../../src/shell/runtime/Paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAe;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,OAAe;IAEf,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,OAAe;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC;AACpE,CAAC"}

package/bin/shell/runtime/ShellActionResponse.d.ts

@@ -1,52 +0,0 @@
-/**
- * Shell action 返回结构辅助。
- *
- * 关键点（中文）
- * - 集中处理输出游标、token 近似裁剪与标准 action response。
- * - 这里不读取文件、不修改 session，只基于传入文本构造返回对象。
- */
-import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
-import type { ShellActionResponse, ShellOutputChunk, ShellSessionSnapshot } from "@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js";
-/**
- * 根据游标与 token 限制构造输出块。
- */
-export declare function createOutputChunk(params: {
-    /**
-     * 当前 shell session 标识。
-     */
-    shellId: string;
-    /**
-     * 当前完整输出文本。
-     */
-    outputText: string;
-    /**
-     * 本次读取起始游标。
-     */
-    fromCursor?: number;
-    /**
-     * 当前 Agent 执行上下文。
-     */
-    context: AgentContext;
-    /**
-     * 输出 token 近似上限。
-     */
-    maxOutputTokens?: number;
-}): ShellOutputChunk;
-/**
- * 构造 shell action 标准返回。
- */
-export declare function buildActionResponse(params: {
-    /**
-     * 当前 shell 快照。
-     */
-    shell: ShellSessionSnapshot;
-    /**
-     * 可选输出块。
-     */
-    chunk?: ShellOutputChunk;
-    /**
-     * 可选人类可读提示。
-     */
-    note?: string;
-}): ShellActionResponse;
-//# sourceMappingURL=ShellActionResponse.d.ts.map

package/bin/shell/runtime/ShellActionResponse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellActionResponse.d.ts","sourceRoot":"","sources":["../../../src/shell/runtime/ShellActionResponse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oEAAoE,CAAC;AA+C5E;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,gBAAgB,CA0BnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C;;OAEG;IACH,KAAK,EAAE,oBAAoB,CAAC;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,mBAAmB,CAMtB"}