aws-runtime-bridge 1.9.79 → 1.9.81

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

@@ -76,4 +76,3 @@ export declare class SubAgentStore {
      */
     reconcileZombies(): Promise<number>;
 }
-//# sourceMappingURL=sub-agent-store.d.ts.map

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

@@ -1,236 +1,4 @@
-import { promises as fs } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { renameWithRetry } from "./fs-utils.js";
-/**
- * Sub Agent JSON 文件存储，按 agentId 隔离。
- *
- * 文件布局：
- *   - 主记录文件：{homedir}/.acode/sub-agents/{agentId}.json
- *       存放 SubAgentRecord[]（不含 events 字段，避免全量读写阻塞终态写入）
- *   - 事件日志文件：{homedir}/.acode/sub-agents/{agentId}.{subId}.events.jsonl
- *       每行一个 SubAgentEvent，append-only，O(1) 追加，不进主 writeChain
- *
- * 设计要点：
- *   - 不依赖 agent 工作目录，避免 workspacePath 错误时读取失败
- *   - sub-agent 跟随 agent（agentId），不跟随项目工作区
- *   - 主记录写操作通过 Promise 链串行化，tmp + rename 原子替换
- *     （rename 在 Windows 上目标被打开时会 EPERM，使用 renameWithRetry 退避重试，
- *      重试仍失败时 fallback 到 copyFile + unlink，彻底规避 EPERM 持续场景）
- *   - events 走独立文件，避免 tool_start/tool_end 高频落盘阻塞终态 updateStatus
- *     （历史教训：events 与 updateStatus 共用 writeChain 时，memory delegate
- *      一次跑数十个工具调用，appendEvent 排队导致 updateStatus 超 5s 超时，
- *      内存已翻终态但 store 仍 running，触发 "status mismatch" 兜底误报）
- *
- * ★ 终态一致性架构（治本方案）：
- *   - 内存态（SubAgentManager）是运行态的唯一真相源
- *   - 终态写入通过 persistFinalStatus 异步重试落盘，不阻塞 completionResolve
- *   - 落盘失败不回滚内存态，前端看到的是真实终态
- *   - 列表接口不再做"磁盘 running/pending + 内存无 → 改写 failed"的兜底
- *     （该兜底是 "status mismatch" 误报的直接来源，已移除）
- *   - bridge 启动时 reconcileZombies 一次性清理上次进程残留的僵尸记录
- *
- * 历史保留策略：全部 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 + subId 隔离，防路径穿越） */
-    eventsFilePath(agentId, subId) {
-        const safeAgent = String(agentId).replace(/[^a-zA-Z0-9_-]/g, "_");
-        const safeSub = String(subId).replace(/[^a-zA-Z0-9_-]/g, "_");
-        return path.join(this.dir, `${safeAgent}.${safeSub}.events.jsonl`);
-    }
-    /** 读取该 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(),
-                // ★ 主记录文件不再存 events 字段（events 走独立 jsonl 文件）。
-                //   剥离 events 避免每次 appendEvent 都全量重写主文件，
-                //   也能显著减小主文件体积（events 是高频大字段）。
-                subAgents: subAgents
-                    .map(({ events: _events, ...rest }) => rest)
-                    .sort((a, b) => b.startedAt - a.startedAt),
-            };
-            const tmp = `${target}.tmp`;
-            await fs.writeFile(tmp, JSON.stringify(doc, null, 2), "utf-8");
-            // ★ Windows 上 fs.rename 目标被 reader 打开时会 EPERM/EBUSY/EACCES，
-            //   瞬时错误，短退避后重试通常即可成功（reader 已释放 fd）。
-            //   POSIX 上 rename 原子，不会触发此类错误。
-            await renameWithRetry(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 的事件日志文件。
-     *
-     * 走独立 jsonl 文件（每行一个事件，append-only），不进主 writeChain：
-     *   - O(1) 追加，无需 read-modify-write 全量主文件
-     *   - 不阻塞终态 updateStatus（避免 status mismatch 兜底误报）
-     *   - 高频 tool_start/tool_end 落盘成本恒定，与历史记录数无关
-     *
-     * 失败时仅打日志（fire-and-forget 语义），不阻断 sub-agent 运行。
-     * 调用方（sub-agent-manager.emitEvent）已用 void + catch 包装。
-     */
-    async appendEvent(agentId, subId, event) {
-        const target = this.eventsFilePath(agentId, subId);
-        await fs.mkdir(this.dir, { recursive: true });
-        // 每行一个 JSON 事件，以 \n 结尾，便于流式读取和解析
-        await fs.appendFile(target, JSON.stringify(event) + "\n", "utf-8");
-    }
-    /**
-     * 读取指定 sub-agent 的全部历史事件（按时间顺序）。
-     *
-     * 优先读独立 jsonl 文件；不存在时回退到主记录文件中的 events 字段
-     * （向后兼容旧版本数据：旧版把 events 内嵌在 SubAgentRecord 中）。
-     * 供 SSE 路由在客户端重连时补发历史 tool 事件。
-     */
-    async readEvents(agentId, subId) {
-        const jsonlPath = this.eventsFilePath(agentId, subId);
-        try {
-            const raw = await fs.readFile(jsonlPath, "utf-8");
-            const events = [];
-            for (const line of raw.split("\n")) {
-                const trimmed = line.trim();
-                if (!trimmed)
-                    continue;
-                try {
-                    events.push(JSON.parse(trimmed));
-                }
-                catch {
-                    /* 跳过损坏行 */
-                }
-            }
-            return events;
-        }
-        catch (err) {
-            if (err && err.code === "ENOENT") {
-                // jsonl 不存在：回退到主记录文件中的 events 字段（旧版本兼容）
-                const record = await this.get(agentId, subId);
-                return Array.isArray(record?.events) ? record.events : [];
-            }
-            throw err;
-        }
-    }
-    /**
-     * 扫描所有 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");
-}
+import{promises as c}from"node:fs";import f from"node:os";import u from"node:path";import{renameWithRetry as h}from"./fs-utils.js";class w{constructor(){this.writeChain=Promise.resolve(),this.dir=u.join(f.homedir(),".acode","sub-agents")}filePath(e){const r=String(e).replace(/[^a-zA-Z0-9_-]/g,"_");return u.join(this.dir,`${r}.json`)}eventsFilePath(e,r){const s=String(e).replace(/[^a-zA-Z0-9_-]/g,"_"),t=String(r).replace(/[^a-zA-Z0-9_-]/g,"_");return u.join(this.dir,`${s}.${t}.events.jsonl`)}async read(e){const r={agentId:e,updatedAt:"",subAgents:[]};try{const s=await c.readFile(this.filePath(e),"utf-8"),t=JSON.parse(s);return{agentId:e,updatedAt:typeof t.updatedAt=="string"?t.updatedAt:"",subAgents:Array.isArray(t.subAgents)?t.subAgents.filter(p).sort((i,o)=>o.startedAt-i.startedAt):[]}}catch(s){if(s&&s.code==="ENOENT"||s instanceof SyntaxError)return r;throw s}}async get(e,r){return(await this.read(e)).subAgents.find(t=>t.subId===r)??null}async write(e,r){const s=this.filePath(e),t=this.writeChain.then(async()=>{await c.mkdir(this.dir,{recursive:!0});const i={agentId:e,updatedAt:new Date().toISOString(),subAgents:r.map(({events:n,...d})=>d).sort((n,d)=>d.startedAt-n.startedAt)},o=`${s}.tmp`;await c.writeFile(o,JSON.stringify(i,null,2),"utf-8"),await h(o,s)});this.writeChain=t.catch(()=>{}),await t}async upsert(e,r){const s=await this.read(e),t=s.subAgents.findIndex(i=>i.subId===r.subId);t>=0?s.subAgents[t]=r:s.subAgents.unshift(r),await this.write(e,s.subAgents)}async updateStatus(e,r,s){const t=await this.read(e),i=t.subAgents.findIndex(o=>o.subId===r);i<0||(t.subAgents[i]={...t.subAgents[i],...s},await this.write(e,t.subAgents))}async list(e){return(await this.read(e)).subAgents}async appendEvent(e,r,s){const t=this.eventsFilePath(e,r);await c.mkdir(this.dir,{recursive:!0}),await c.appendFile(t,JSON.stringify(s)+`
+`,"utf-8")}async readEvents(e,r){const s=this.eventsFilePath(e,r);try{const t=await c.readFile(s,"utf-8"),i=[];for(const o of t.split(`
+`)){const n=o.trim();if(n)try{i.push(JSON.parse(n))}catch{}}return i}catch(t){if(t&&t.code==="ENOENT"){const i=await this.get(e,r);return Array.isArray(i?.events)?i.events:[]}throw t}}async reconcileZombies(){let e=0,r;try{r=await c.readdir(this.dir)}catch{return 0}for(const s of r){if(!s.endsWith(".json"))continue;const t=s.replace(/\.json$/,"");try{const i=await this.read(t);let o=!1;for(const n of i.subAgents)(n.status==="running"||n.status==="pending")&&(n.status="failed",n.errorMessage=n.errorMessage??"bridge restarted (zombie reconcile)",n.endedAt||(n.endedAt=n.startedAt,n.durationMs=0),o=!0,e++);o&&await this.write(t,i.subAgents)}catch{}}return e}}function p(a){return a!==null&&typeof a=="object"&&typeof a.subId=="string"&&typeof a.parentAgentId=="string"&&typeof a.parentSessionId=="string"&&typeof a.subagentType=="string"&&typeof a.description=="string"&&typeof a.prompt=="string"&&typeof a.status=="string"&&typeof a.startedAt=="number"}export{w as SubAgentStore};
+

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

@@ -69,4 +69,3 @@ export declare function createAwaitSubAgentsTool(deps: ACodeSubAgentToolDeps): A
 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