@downcity/plugins 1.0.4

package/bin/memory/types/Memory.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Memory Service 类型定义。
+ *
+ * 关键点（中文）
+ * - 只保留 Memory V2 所需协议。
+ * - 字段注释完整，供 CLI/API/运行时统一复用。
+ */
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+/**
+ * 记忆来源类型。
+ */
+export type MemorySourceType = "longterm" | "daily" | "working";
+/**
+ * 查询模式。
+ *
+ * 说明（中文）
+ * - 当前实现直接扫描 Markdown 文件，不再维护额外索引库。
+ */
+export type MemorySearchMode = "scan";
+/**
+ * 单条记忆检索结果。
+ */
+export interface MemorySearchResultItem {
+    /**
+     * 片段来源路径（相对项目根目录）。
+     */
+    path: string;
+    /**
+     * 片段起始行号（1-based）。
+     */
+    startLine: number;
+    /**
+     * 片段结束行号（1-based）。
+     */
+    endLine: number;
+    /**
+     * 归一化分数（0~1，越高越相关）。
+     */
+    score: number;
+    /**
+     * 返回给模型/用户的片段文本（已按预算裁剪）。
+     */
+    snippet: string;
+    /**
+     * 记忆来源分类（长期/每日/工作记忆）。
+     */
+    source: MemorySourceType;
+    /**
+     * 引用标记（例如：`.downcity/memory/MEMORY.md#L12-L20`）。
+     */
+    citation: string;
+}
+/**
+ * 记忆检索请求。
+ */
+export interface MemorySearchPayload {
+    /**
+     * 查询语句。
+     */
+    query: string;
+    /**
+     * 可选返回条数上限，未传使用内置默认值。
+     */
+    maxResults?: number;
+    /**
+     * 可选分数阈值，未传使用内置默认值。
+     */
+    minScore?: number;
+}
+/**
+ * 记忆检索响应。
+ */
+export interface MemorySearchResponse {
+    /**
+     * 返回结果集合。
+     */
+    results: MemorySearchResultItem[];
+    /**
+     * 当前检索模式。
+     */
+    mode: MemorySearchMode;
+    /**
+     * 当前后端标识。
+     */
+    backend: "builtin";
+    /**
+     * 若不可用则标记为 true。
+     */
+    disabled?: boolean;
+    /**
+     * 错误原因文本（失败场景）。
+     */
+    error?: string;
+    /**
+     * 建议动作（失败场景）。
+     */
+    action?: string;
+}
+/**
+ * 读取记忆片段请求。
+ */
+export interface MemoryGetPayload {
+    /**
+     * 相对项目根目录的目标路径。
+     */
+    path: string;
+    /**
+     * 可选起始行（1-based）。
+     */
+    from?: number;
+    /**
+     * 可选读取行数。
+     */
+    lines?: number;
+}
+/**
+ * 读取记忆片段响应。
+ */
+export interface MemoryGetResponse {
+    /**
+     * 目标路径（回显）。
+     */
+    path: string;
+    /**
+     * 读取内容；文件缺失时为空字符串。
+     */
+    text: string;
+    /**
+     * 文件不存在时为 true。
+     */
+    missing?: boolean;
+}
+/**
+ * 显式写入请求。
+ */
+export interface MemoryStorePayload {
+    /**
+     * 要写入的文本内容。
+     */
+    content: string;
+    /**
+     * 目标记忆层，默认 `daily`。
+     */
+    target?: MemorySourceType;
+    /**
+     * 目标会话 ID（`working` 目标必填）。
+     */
+    sessionId?: string;
+}
+/**
+ * 显式写入响应。
+ */
+export interface MemoryStoreResponse {
+    /**
+     * 实际写入路径（相对项目根目录）。
+     */
+    path: string;
+    /**
+     * 实际写入目标层。
+     */
+    target: MemorySourceType;
+    /**
+     * 写入字节长度（UTF-16 字符计数）。
+     */
+    writtenChars: number;
+}
+/**
+ * Flush 请求。
+ */
+export interface MemoryFlushPayload {
+    /**
+     * 目标会话 ID。
+     */
+    sessionId: string;
+    /**
+     * 可选最大提取消息条数。
+     */
+    maxMessages?: number;
+}
+/**
+ * Flush 响应。
+ */
+export interface MemoryFlushResponse {
+    /**
+     * 写入路径（相对项目根目录）。
+     */
+    path: string;
+    /**
+     * 参与 flush 的消息条数。
+     */
+    messageCount: number;
+    /**
+     * 写入内容字符数。
+     */
+    writtenChars: number;
+}
+/**
+ * 按来源统计。
+ */
+export interface MemorySourceStat {
+    /**
+     * 来源分类。
+     */
+    source: MemorySourceType;
+    /**
+     * 文件数量。
+     */
+    files: number;
+    /**
+     * 片段数量。
+     */
+    chunks: number;
+}
+/**
+ * status 返回结构。
+ */
+export interface MemoryStatusResponse {
+    /**
+     * Memory 功能是否启用。
+     */
+    enabled: boolean;
+    /**
+     * 后端标识。
+     */
+    backend: "builtin";
+    /**
+     * 当前检索模式。
+     */
+    mode: MemorySearchMode;
+    /**
+     * 文件总数。
+     */
+    files: number;
+    /**
+     * chunk 总数。
+     */
+    chunks: number;
+    /**
+     * 按来源统计。
+     */
+    sourceCounts: MemorySourceStat[];
+}
+/**
+ * Memory service 内置默认配置（不暴露复杂用户配置）。
+ */
+export interface MemoryDefaults {
+    /**
+     * 检索默认返回条数。
+     */
+    maxResults: number;
+    /**
+     * 检索默认最小分数。
+     */
+    minScore: number;
+    /**
+     * 注入预算（字符）。
+     */
+    maxInjectedChars: number;
+}
+/**
+ * Memory action payload 联合。
+ */
+export type MemoryActionPayload = MemorySearchPayload | MemoryGetPayload | MemoryStorePayload | MemoryFlushPayload | Record<string, JsonValue>;
+//# sourceMappingURL=Memory.d.ts.map

package/bin/memory/types/Memory.d.ts.map

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

package/bin/memory/types/Memory.js

@@ -0,0 +1,9 @@
+/**
+ * Memory Service 类型定义。
+ *
+ * 关键点（中文）
+ * - 只保留 Memory V2 所需协议。
+ * - 字段注释完整，供 CLI/API/运行时统一复用。
+ */
+export {};
+//# sourceMappingURL=Memory.js.map

package/bin/memory/types/Memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Memory.js","sourceRoot":"","sources":["../../../src/memory/types/Memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/shell/Index.d.ts

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

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

@@ -0,0 +1 @@
+{"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

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

package/bin/shell/Index.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,65 @@
+/**
+ * ShellPlugin：shell plugin 的类实现。
+ *
+ * 关键点（中文）
+ * - shell session map 与 bound runtime 都归属于 plugin 实例。
+ * - agent 持有 ShellPlugin 实例，从而形成 per-agent shell 状态边界。
+ * - ShellActionRuntime 只保留纯运行时流程，不再承载模块级单例状态。
+ */
+import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
+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 { 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(agent: AgentRuntime | null);
+    /**
+     * 启动一个 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

@@ -0,0 +1 @@
+{"version":3,"file":"ShellPlugin.d.ts","sourceRoot":"","sources":["../../src/shell/ShellPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,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,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,oEAAoE,CAAC;AAc5E;;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,KAAK,EAAE,YAAY,GAAG,IAAI;IAkEtC;;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

@@ -0,0 +1,138 @@
+/**
+ * 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, execShellCommand, getShellSessionStatus, 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(agent) {
+        super(agent);
+        this.state = createShellPluginState();
+        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),
+                }),
+            },
+        };
+        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.boundRuntime = 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

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

package/bin/shell/ShellRuntimeTypes.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 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 { ShellSessionSnapshot } from "@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js";
+/**
+ * 单个 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 = {
+    /**
+     * 当前实例持有的全部 in-memory shell session。
+     */
+    sessions: Map<string, ShellSessionRuntimeState>;
+    /**
+     * 当前实例最近一次绑定的 execution runtime。
+     *
+     * 关键点（中文）
+     * - 仅用于 shell 自动通知 chat 的回调路径。
+     * - 这是实例字段，不再是模块级全局变量。
+     */
+    boundRuntime: AgentContext | null;
+};
+//# sourceMappingURL=ShellRuntimeTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"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,EAAE,oBAAoB,EAAE,MAAM,oEAAoE,CAAC;AAE/G;;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,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAChD;;;;;;OAMG;IACH,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC,CAAC"}

package/bin/shell/ShellRuntimeTypes.js

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

package/bin/shell/ShellRuntimeTypes.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,21 @@
+/**
+ * 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