aws-runtime-bridge 1.9.33 → 1.9.41

package/package/acode/dist/sub-agent-store.d.ts

@@ -0,0 +1,40 @@
+import type { SubAgentDocument, SubAgentEvent, SubAgentRecord } from "./sub-agent-types.js";
+/**
+ * Sub Agent JSON 文件存储，按 agentId 隔离。
+ * 文件路径：{homedir}/.acode/sub-agents/{agentId}.json
+ *
+ * 设计与 TodoStore 完全同构：
+ *   - 不依赖 agent 工作目录，避免 workspacePath 错误时读取失败
+ *   - sub-agent 跟随 agent（agentId），不跟随项目工作区
+ *   - 写操作通过 Promise 链串行化，tmp + rename 原子替换
+ *
+ * 历史保留策略：全部 sub-agent 记录都持久化（含 completed/failed/cancelled），
+ *   按 startedAt 倒序排列。dashboard 按需分页读取。
+ */
+export declare class SubAgentStore {
+    private readonly dir;
+    private writeChain;
+    constructor();
+    /** 文件路径（按 agentId 隔离，防路径穿越） */
+    private filePath;
+    /** 读取该 agentId 的完整文档。文件不存在或损坏时返回空文档。 */
+    read(agentId: string): Promise<SubAgentDocument>;
+    /** 读取单个 sub-agent 记录 */
+    get(agentId: string, subId: string): Promise<SubAgentRecord | null>;
+    /** 全量替换该 agentId 的文档。串行化以避免并发覆盖。 */
+    write(agentId: string, subAgents: SubAgentRecord[]): Promise<void>;
+    /** 插入或更新单条记录（保留其他记录） */
+    upsert(agentId: string, record: SubAgentRecord): Promise<void>;
+    /** 部分更新单条记录 */
+    updateStatus(agentId: string, subId: string, patch: Partial<SubAgentRecord>): Promise<void>;
+    /** 列出该 agent 的全部 sub-agent（已按 startedAt 倒序） */
+    list(agentId: string): Promise<SubAgentRecord[]>;
+    /** 追加一条事件到指定 sub-agent 的 events 数组（用于 tool_start/tool_end 持久化） */
+    appendEvent(agentId: string, subId: string, event: SubAgentEvent): Promise<void>;
+    /**
+     * 扫描所有 agent 文件，把 status="running"/"pending" 的记录修正为 "failed"。
+     * 在 bridge 启动时调用，清理上次进程异常退出留下的僵尸记录。
+     */
+    reconcileZombies(): Promise<number>;
+}
+//# sourceMappingURL=sub-agent-store.d.ts.map

package/package/acode/dist/sub-agent-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-store.d.ts","sourceRoot":"","sources":["../src/sub-agent-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAoC;;IAMtD,+BAA+B;IAC/B,OAAO,CAAC,QAAQ;IAKhB,wCAAwC;IAClC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBtD,wBAAwB;IAClB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKzE,oCAAoC;IAC9B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE,wBAAwB;IAClB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe;IACT,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAQhB,+CAA+C;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAItD,kEAAkE;IAC5D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtF;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAmC1C"}

package/package/acode/dist/sub-agent-store.js

@@ -0,0 +1,164 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/**
+ * Sub Agent JSON 文件存储，按 agentId 隔离。
+ * 文件路径：{homedir}/.acode/sub-agents/{agentId}.json
+ *
+ * 设计与 TodoStore 完全同构：
+ *   - 不依赖 agent 工作目录，避免 workspacePath 错误时读取失败
+ *   - sub-agent 跟随 agent（agentId），不跟随项目工作区
+ *   - 写操作通过 Promise 链串行化，tmp + rename 原子替换
+ *
+ * 历史保留策略：全部 sub-agent 记录都持久化（含 completed/failed/cancelled），
+ *   按 startedAt 倒序排列。dashboard 按需分页读取。
+ */
+export class SubAgentStore {
+    constructor() {
+        this.writeChain = Promise.resolve();
+        this.dir = path.join(os.homedir(), ".acode", "sub-agents");
+    }
+    /** 文件路径（按 agentId 隔离，防路径穿越） */
+    filePath(agentId) {
+        const safe = String(agentId).replace(/[^a-zA-Z0-9_-]/g, "_");
+        return path.join(this.dir, `${safe}.json`);
+    }
+    /** 读取该 agentId 的完整文档。文件不存在或损坏时返回空文档。 */
+    async read(agentId) {
+        const empty = { agentId, updatedAt: "", subAgents: [] };
+        try {
+            const raw = await fs.readFile(this.filePath(agentId), "utf-8");
+            const doc = JSON.parse(raw);
+            return {
+                agentId,
+                updatedAt: typeof doc.updatedAt === "string" ? doc.updatedAt : "",
+                subAgents: Array.isArray(doc.subAgents)
+                    ? doc.subAgents.filter(isValidRecord)
+                        .sort((a, b) => b.startedAt - a.startedAt)
+                    : [],
+            };
+        }
+        catch (err) {
+            if (err && err.code === "ENOENT")
+                return empty;
+            if (err instanceof SyntaxError)
+                return empty;
+            throw err;
+        }
+    }
+    /** 读取单个 sub-agent 记录 */
+    async get(agentId, subId) {
+        const doc = await this.read(agentId);
+        return doc.subAgents.find((r) => r.subId === subId) ?? null;
+    }
+    /** 全量替换该 agentId 的文档。串行化以避免并发覆盖。 */
+    async write(agentId, subAgents) {
+        const target = this.filePath(agentId);
+        const run = this.writeChain.then(async () => {
+            await fs.mkdir(this.dir, { recursive: true });
+            const doc = {
+                agentId,
+                updatedAt: new Date().toISOString(),
+                subAgents: subAgents.sort((a, b) => b.startedAt - a.startedAt),
+            };
+            const tmp = `${target}.tmp`;
+            await fs.writeFile(tmp, JSON.stringify(doc, null, 2), "utf-8");
+            await fs.rename(tmp, target);
+        });
+        this.writeChain = run.catch(() => { });
+        await run;
+    }
+    /** 插入或更新单条记录（保留其他记录） */
+    async upsert(agentId, record) {
+        const doc = await this.read(agentId);
+        const idx = doc.subAgents.findIndex((r) => r.subId === record.subId);
+        if (idx >= 0) {
+            doc.subAgents[idx] = record;
+        }
+        else {
+            doc.subAgents.unshift(record);
+        }
+        await this.write(agentId, doc.subAgents);
+    }
+    /** 部分更新单条记录 */
+    async updateStatus(agentId, subId, patch) {
+        const doc = await this.read(agentId);
+        const idx = doc.subAgents.findIndex((r) => r.subId === subId);
+        if (idx < 0)
+            return;
+        doc.subAgents[idx] = { ...doc.subAgents[idx], ...patch };
+        await this.write(agentId, doc.subAgents);
+    }
+    /** 列出该 agent 的全部 sub-agent（已按 startedAt 倒序） */
+    async list(agentId) {
+        return (await this.read(agentId)).subAgents;
+    }
+    /** 追加一条事件到指定 sub-agent 的 events 数组（用于 tool_start/tool_end 持久化） */
+    async appendEvent(agentId, subId, event) {
+        const doc = await this.read(agentId);
+        const idx = doc.subAgents.findIndex((r) => r.subId === subId);
+        if (idx < 0)
+            return;
+        const record = doc.subAgents[idx];
+        if (!Array.isArray(record.events)) {
+            record.events = [];
+        }
+        record.events.push(event);
+        await this.write(agentId, doc.subAgents);
+    }
+    /**
+     * 扫描所有 agent 文件，把 status="running"/"pending" 的记录修正为 "failed"。
+     * 在 bridge 启动时调用，清理上次进程异常退出留下的僵尸记录。
+     */
+    async reconcileZombies() {
+        let fixed = 0;
+        let files;
+        try {
+            files = await fs.readdir(this.dir);
+        }
+        catch {
+            return 0;
+        }
+        for (const file of files) {
+            if (!file.endsWith(".json"))
+                continue;
+            const agentId = file.replace(/\.json$/, "");
+            try {
+                const doc = await this.read(agentId);
+                let dirty = false;
+                for (const record of doc.subAgents) {
+                    if (record.status === "running" || record.status === "pending") {
+                        record.status = "failed";
+                        record.errorMessage = record.errorMessage ?? "bridge restarted (zombie reconcile)";
+                        if (!record.endedAt) {
+                            record.endedAt = record.startedAt;
+                            record.durationMs = 0;
+                        }
+                        dirty = true;
+                        fixed++;
+                    }
+                }
+                if (dirty) {
+                    await this.write(agentId, doc.subAgents);
+                }
+            }
+            catch {
+                /* 跳过损坏文件 */
+            }
+        }
+        return fixed;
+    }
+}
+/** 运行时校验记录结构（防损坏文件污染内存） */
+function isValidRecord(r) {
+    return (r !== null &&
+        typeof r === "object" &&
+        typeof r.subId === "string" &&
+        typeof r.parentAgentId === "string" &&
+        typeof r.parentSessionId === "string" &&
+        typeof r.subagentType === "string" &&
+        typeof r.description === "string" &&
+        typeof r.prompt === "string" &&
+        typeof r.status === "string" &&
+        typeof r.startedAt === "number");
+}

package/package/acode/dist/sub-agent-tools.d.ts

@@ -0,0 +1,72 @@
+import type { ACodeBuiltInTool } from "./built-in-file-tools.js";
+import type { SubAgentType, SubAgentStatus } from "./sub-agent-types.js";
+/**
+ * Sub-agent 工具集依赖（由 runtime.ts 注入 SubAgentManager 句柄）。
+ *
+ * 工具集包含 5 个工具：
+ *   1. sub_agent: 非阻塞 spawn 子 agent，立即返回 subId
+ *   2. list_sub_agents: 列出当前 agent 的所有子 agent（运行中 + 历史）
+ *   3. get_sub_agent_status: 查询某子 agent 的实时状态
+ *   4. await_sub_agents: 阻塞等待指定 sub-agent 数组完成
+ *   5. abort_sub_agent: 终止某子 agent
+ */
+export interface ACodeSubAgentToolDeps {
+    /** spawn 子 agent（不阻塞，不自动 start） */
+    spawnSubAgent: (opts: {
+        subagentType: SubAgentType;
+        description: string;
+        prompt: string;
+    }) => Promise<{
+        subId: string;
+    }>;
+    /** 列出当前 agent 的所有子 agent */
+    listSubAgents: () => Promise<{
+        running: Array<SubAgentInfo>;
+        history: Array<SubAgentInfo>;
+    }>;
+    /** 查询某子 agent 的实时状态 */
+    getSubAgentStatus: (subId: string) => Promise<SubAgentDetail | null>;
+    /** 阻塞等待指定 sub-agent 数组完成 */
+    awaitSubAgents: (subIds: string[], timeoutMs?: number) => Promise<Array<{
+        subId: string;
+        output: string;
+        error?: string;
+        status: SubAgentStatus;
+    }>>;
+    /** 终止某子 agent */
+    abortSubAgent: (subId: string) => Promise<void>;
+}
+/** 子 agent 摘要信息（列表用） */
+export interface SubAgentInfo {
+    subId: string;
+    subagentType: SubAgentType;
+    description: string;
+    status: SubAgentStatus;
+    startedAt: number;
+    endedAt?: number;
+    durationMs?: number;
+}
+/** 子 agent 详情（含实时上下文） */
+export interface SubAgentDetail extends SubAgentInfo {
+    prompt: string;
+    result?: string;
+    errorMessage?: string;
+    contextSnapshot?: {
+        currentTool?: string;
+        lastAssistantText?: string;
+        tokenUsage: {
+            input: number;
+            output: number;
+        };
+        messageCount: number;
+        updatedAt: string;
+    };
+}
+export declare function createSubAgentTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
+export declare function createListSubAgentsTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
+export declare function createGetSubAgentStatusTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
+export declare function createAwaitSubAgentsTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
+export declare function createAbortSubAgentTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
+/** 创建全部 5 个 sub-agent 工具（仅当注入了 SubAgentManager 时调用） */
+export declare function createSubAgentTools(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool[];
+//# sourceMappingURL=sub-agent-tools.d.ts.map

package/package/acode/dist/sub-agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-tools.d.ts","sourceRoot":"","sources":["../src/sub-agent-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,aAAa,EAAE,CAAC,IAAI,EAAE;QACpB,YAAY,EAAE,YAAY,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjC,4BAA4B;IAC5B,aAAa,EAAE,MAAM,OAAO,CAAC;QAC3B,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC7B,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;KAC9B,CAAC,CAAC;IAEH,uBAAuB;IACvB,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAErE,4BAA4B;IAC5B,cAAc,EAAE,CACd,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC,CAAC;IAE/F,iBAAiB;IACjB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,wBAAwB;AACxB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yBAAyB;AACzB,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AA4BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,gBAAgB,CAsEhF;AAeD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,gBAAgB,CAsDrF;AAiBD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,qBAAqB,GAAG,gBAAgB,CAoGzF;AAsBD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,gBAAgB,CAsFtF;AAcD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,gBAAgB,CA2CrF;AAID,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,gBAAgB,EAAE,CAQnF"}