aws-runtime-bridge 1.9.32 → 1.9.40

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"}

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

@@ -0,0 +1,429 @@
+// ==================== 工具 1: sub_agent ====================
+const SUB_AGENT_TOOL_DESCRIPTION = `Launch a new sub-agent to handle a task autonomously (non-blocking).
+
+Use this tool to:
+1. Delegate research, exploration, or implementation work to a specialized sub-agent
+2. Run multiple independent tasks in parallel (multiple tool calls in one message)
+3. Keep the main context window focused by offloading detailed work
+
+Available subagent types:
+- "general": Full-featured agent for executing multi-step tasks (file ops, bash, etc.)
+- "explore": Read-only agent for codebase exploration (grep, glob, read, bash, web search)
+
+This tool is NON-BLOCKING: it returns immediately with a subId after spawn.
+The sub-agent starts automatically and runs in the background.
+To get the result, call await_sub_agents with the subId.
+To check progress, call get_sub_agent_status with the subId.
+To list all sub-agents, call list_sub_agents.
+
+Guidelines:
+- Provide a concise 3-5 word description for tracking
+- Write a clear, self-contained prompt (the sub-agent starts with a fresh context)
+- Launch multiple agents concurrently when possible (multiple tool calls in one message)
+- Sub-agents cannot spawn further sub-agents (no nesting)
+- Always call await_sub_agents before reporting completion to the user`;
+export function createSubAgentTool(deps) {
+    return {
+        kind: "builtin",
+        toolName: "sub_agent",
+        exposedName: "sub_agent",
+        description: SUB_AGENT_TOOL_DESCRIPTION,
+        inputSchema: {
+            type: "object",
+            properties: {
+                description: {
+                    type: "string",
+                    description: "A short (3-5 words) description of the task.",
+                },
+                prompt: {
+                    type: "string",
+                    description: "The task for the sub-agent to perform (self-contained, fresh context).",
+                },
+                subagent_type: {
+                    type: "string",
+                    enum: ["general", "explore"],
+                    description: "Type of specialized agent: 'general' for multi-step tasks, 'explore' for read-only codebase exploration.",
+                },
+            },
+            required: ["description", "prompt", "subagent_type"],
+        },
+        async execute(args) {
+            const description = typeof args.description === "string" ? args.description.trim() : "";
+            const prompt = typeof args.prompt === "string" ? args.prompt.trim() : "";
+            const subagentType = args.subagent_type;
+            if (!description) {
+                return {
+                    title: "sub_agent validation error",
+                    output: "Invalid input: 'description' is required and must be non-empty.",
+                    metadata: { error: true },
+                };
+            }
+            if (!prompt) {
+                return {
+                    title: "sub_agent validation error",
+                    output: "Invalid input: 'prompt' is required and must be non-empty.",
+                    metadata: { error: true },
+                };
+            }
+            if (subagentType !== "general" && subagentType !== "explore") {
+                return {
+                    title: "sub_agent validation error",
+                    output: `Invalid input: 'subagent_type' must be 'general' or 'explore', got '${subagentType}'.`,
+                    metadata: { error: true },
+                };
+            }
+            try {
+                const { subId } = await deps.spawnSubAgent({ subagentType, description, prompt });
+                return {
+                    title: description,
+                    output: `sub_agent spawned: ${subId}\nstatus: pending\n\nCall await_sub_agents with this subId to get the result.\nCall get_sub_agent_status to check progress.`,
+                    metadata: { subId, spawned: true },
+                };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                return {
+                    title: description,
+                    output: `Failed to spawn sub-agent: ${errorMessage}`,
+                    metadata: { error: true },
+                };
+            }
+        },
+    };
+}
+// ==================== 工具 2: list_sub_agents ====================
+const LIST_SUB_AGENTS_DESCRIPTION = `List all sub-agents for the current agent.
+
+Returns two arrays:
+- running: sub-agents currently in pending/running state
+- history: completed/failed/cancelled sub-agents (most recent first)
+
+Use this to:
+1. Check which sub-agents are still running
+2. Review completed sub-agent history
+3. Find a subId before calling await_sub_agents or get_sub_agent_status`;
+export function createListSubAgentsTool(deps) {
+    return {
+        kind: "builtin",
+        toolName: "list_sub_agents",
+        exposedName: "list_sub_agents",
+        description: LIST_SUB_AGENTS_DESCRIPTION,
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        async execute(_args) {
+            try {
+                const { running, history } = await deps.listSubAgents();
+                const formatEntry = (e) => {
+                    const duration = e.durationMs !== undefined
+                        ? `${(e.durationMs / 1000).toFixed(1)}s`
+                        : e.endedAt
+                            ? `${((e.endedAt - e.startedAt) / 1000).toFixed(1)}s`
+                            : "ongoing";
+                    return `  - ${e.subId} [${e.status}] (${duration}) ${e.description}`;
+                };
+                const lines = [];
+                lines.push(`Running (${running.length}):`);
+                if (running.length === 0) {
+                    lines.push("  (none)");
+                }
+                else {
+                    running.forEach((e) => lines.push(formatEntry(e)));
+                }
+                lines.push("");
+                lines.push(`History (${history.length}):`);
+                if (history.length === 0) {
+                    lines.push("  (none)");
+                }
+                else {
+                    history.forEach((e) => lines.push(formatEntry(e)));
+                }
+                return {
+                    title: "sub-agents list",
+                    output: lines.join("\n"),
+                    metadata: { runningCount: running.length, historyCount: history.length },
+                };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                return {
+                    title: "list_sub_agents error",
+                    output: `Failed to list sub-agents: ${errorMessage}`,
+                    metadata: { error: true },
+                };
+            }
+        },
+    };
+}
+// ==================== 工具 3: get_sub_agent_status ====================
+const GET_SUB_AGENT_STATUS_DESCRIPTION = `Get the current status and context snapshot of a sub-agent.
+
+Returns:
+- status: pending/running/completed/failed/cancelled
+- currentTool: tool currently being executed (if running)
+- lastAssistantText: recent assistant output (truncated)
+- tokenUsage: input/output token counts
+- messageCount: number of messages so far
+- result: final output (if completed)
+- error: error message (if failed)
+
+Use this to check progress of a running sub-agent before awaiting it.`;
+export function createGetSubAgentStatusTool(deps) {
+    return {
+        kind: "builtin",
+        toolName: "get_sub_agent_status",
+        exposedName: "get_sub_agent_status",
+        description: GET_SUB_AGENT_STATUS_DESCRIPTION,
+        inputSchema: {
+            type: "object",
+            properties: {
+                sub_id: {
+                    type: "string",
+                    description: "The sub-agent ID returned by sub_agent tool.",
+                },
+            },
+            required: ["sub_id"],
+        },
+        async execute(args) {
+            const subId = typeof args.sub_id === "string" ? args.sub_id.trim() : "";
+            if (!subId) {
+                return {
+                    title: "get_sub_agent_status validation error",
+                    output: "Invalid input: 'sub_id' is required.",
+                    metadata: { error: true },
+                };
+            }
+            try {
+                const detail = await deps.getSubAgentStatus(subId);
+                if (!detail) {
+                    return {
+                        title: "sub-agent not found",
+                        output: `sub-agent not found: ${subId}`,
+                        metadata: { subId, error: true },
+                    };
+                }
+                const lines = [];
+                lines.push(`subId: ${detail.subId}`);
+                lines.push(`type: ${detail.subagentType}`);
+                lines.push(`description: ${detail.description}`);
+                lines.push(`status: ${detail.status}`);
+                if (detail.startedAt) {
+                    lines.push(`startedAt: ${new Date(detail.startedAt).toISOString()}`);
+                }
+                if (detail.endedAt) {
+                    lines.push(`endedAt: ${new Date(detail.endedAt).toISOString()}`);
+                }
+                if (detail.durationMs !== undefined) {
+                    lines.push(`duration: ${(detail.durationMs / 1000).toFixed(2)}s`);
+                }
+                if (detail.contextSnapshot) {
+                    lines.push("");
+                    lines.push("Context:");
+                    if (detail.contextSnapshot.currentTool) {
+                        lines.push(`  currentTool: ${detail.contextSnapshot.currentTool}`);
+                    }
+                    if (detail.contextSnapshot.lastAssistantText) {
+                        const text = detail.contextSnapshot.lastAssistantText;
+                        lines.push(`  lastOutput: ${text.length > 200 ? text.slice(-200) + "..." : text}`);
+                    }
+                    lines.push(`  tokens: input=${detail.contextSnapshot.tokenUsage.input}, output=${detail.contextSnapshot.tokenUsage.output}`);
+                    lines.push(`  messages: ${detail.contextSnapshot.messageCount}`);
+                    lines.push(`  updatedAt: ${detail.contextSnapshot.updatedAt}`);
+                }
+                if (detail.result) {
+                    lines.push("");
+                    lines.push("Result:");
+                    const result = detail.result;
+                    lines.push(result.length > 500 ? result.slice(0, 500) + "\n... (truncated)" : result);
+                }
+                if (detail.errorMessage) {
+                    lines.push("");
+                    lines.push(`Error: ${detail.errorMessage}`);
+                }
+                return {
+                    title: `status: ${detail.description}`,
+                    output: lines.join("\n"),
+                    metadata: {
+                        subId: detail.subId,
+                        status: detail.status,
+                    },
+                };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                return {
+                    title: "get_sub_agent_status error",
+                    output: `Failed to get status: ${errorMessage}`,
+                    metadata: { subId, error: true },
+                };
+            }
+        },
+    };
+}
+// ==================== 工具 4: await_sub_agents ====================
+const AWAIT_SUB_AGENTS_DESCRIPTION = `Block and wait for one or more sub-agents to complete.
+
+Use this tool after spawning one or more sub-agents (via sub_agent) to get their results.
+All specified sub-agents must complete (completed/failed/cancelled) before this returns.
+
+If a sub-agent is still pending (not started), it will be auto-started.
+
+Returns an array of results, each containing:
+- subId: the sub-agent ID
+- output: the final output text (if completed)
+- error: error message (if failed or cancelled)
+- status: final status
+
+Guidelines:
+- Pass all subIds you want to wait for in one call
+- Use a timeout to avoid waiting forever (0 = no timeout, default 0)
+- After this returns, call poll_message to receive any pending messages`;
+export function createAwaitSubAgentsTool(deps) {
+    return {
+        kind: "builtin",
+        toolName: "await_sub_agents",
+        exposedName: "await_sub_agents",
+        description: AWAIT_SUB_AGENTS_DESCRIPTION,
+        inputSchema: {
+            type: "object",
+            properties: {
+                sub_ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Array of sub-agent IDs to wait for.",
+                },
+                timeout_ms: {
+                    type: "number",
+                    description: "Maximum time to wait in milliseconds. 0 = no timeout (wait forever). Default: 0.",
+                },
+            },
+            required: ["sub_ids"],
+        },
+        async execute(args) {
+            const subIdsRaw = args.sub_ids;
+            const timeoutMs = typeof args.timeout_ms === "number" ? args.timeout_ms : 0;
+            if (!Array.isArray(subIdsRaw) || subIdsRaw.length === 0) {
+                return {
+                    title: "await_sub_agents validation error",
+                    output: "Invalid input: 'sub_ids' must be a non-empty array of sub-agent IDs.",
+                    metadata: { error: true },
+                };
+            }
+            const subIds = subIdsRaw.filter((id) => typeof id === "string" && id.trim().length > 0);
+            if (subIds.length === 0) {
+                return {
+                    title: "await_sub_agents validation error",
+                    output: "Invalid input: 'sub_ids' contains no valid IDs.",
+                    metadata: { error: true },
+                };
+            }
+            try {
+                const results = await deps.awaitSubAgents(subIds, timeoutMs);
+                const lines = [];
+                lines.push(`Awaited ${results.length} sub-agent(s):`);
+                lines.push("");
+                for (const r of results) {
+                    lines.push(`=== ${r.subId} [${r.status}] ===`);
+                    if (r.error) {
+                        lines.push(`<task_error>`);
+                        lines.push(r.error);
+                        lines.push(`</task_error>`);
+                    }
+                    else {
+                        lines.push(`<task_result>`);
+                        lines.push(r.output || "(empty output)");
+                        lines.push(`</task_result>`);
+                    }
+                    lines.push("");
+                }
+                const completedCount = results.filter((r) => r.status === "completed").length;
+                const failedCount = results.filter((r) => r.status === "failed").length;
+                const cancelledCount = results.filter((r) => r.status === "cancelled").length;
+                return {
+                    title: `awaited ${results.length} sub-agent(s)`,
+                    output: lines.join("\n"),
+                    metadata: {
+                        total: results.length,
+                        completed: completedCount,
+                        failed: failedCount,
+                        cancelled: cancelledCount,
+                    },
+                };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                return {
+                    title: "await_sub_agents error",
+                    output: `Failed to await sub-agents: ${errorMessage}`,
+                    metadata: { error: true },
+                };
+            }
+        },
+    };
+}
+// ==================== 工具 5: abort_sub_agent ====================
+const ABORT_SUB_AGENT_DESCRIPTION = `Abort a running sub-agent.
+
+Use this to cancel a sub-agent that is taking too long or is no longer needed.
+Only pending or running sub-agents can be aborted; completed/failed/cancelled are no-ops.
+
+After abort:
+- The sub-agent's status becomes 'cancelled'
+- Its completionPromise resolves with error='aborted'
+- Any await_sub_agents waiting on it will return immediately`;
+export function createAbortSubAgentTool(deps) {
+    return {
+        kind: "builtin",
+        toolName: "abort_sub_agent",
+        exposedName: "abort_sub_agent",
+        description: ABORT_SUB_AGENT_DESCRIPTION,
+        inputSchema: {
+            type: "object",
+            properties: {
+                sub_id: {
+                    type: "string",
+                    description: "The sub-agent ID to abort.",
+                },
+            },
+            required: ["sub_id"],
+        },
+        async execute(args) {
+            const subId = typeof args.sub_id === "string" ? args.sub_id.trim() : "";
+            if (!subId) {
+                return {
+                    title: "abort_sub_agent validation error",
+                    output: "Invalid input: 'sub_id' is required.",
+                    metadata: { error: true },
+                };
+            }
+            try {
+                await deps.abortSubAgent(subId);
+                return {
+                    title: "sub-agent aborted",
+                    output: `sub-agent ${subId} has been aborted.`,
+                    metadata: { subId, aborted: true },
+                };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                return {
+                    title: "abort_sub_agent error",
+                    output: `Failed to abort sub-agent: ${errorMessage}`,
+                    metadata: { subId, error: true },
+                };
+            }
+        },
+    };
+}
+// ==================== 工厂函数：一次创建全部 5 个工具 ====================
+/** 创建全部 5 个 sub-agent 工具（仅当注入了 SubAgentManager 时调用） */
+export function createSubAgentTools(deps) {
+    return [
+        createSubAgentTool(deps),
+        createListSubAgentsTool(deps),
+        createGetSubAgentStatusTool(deps),
+        createAwaitSubAgentsTool(deps),
+        createAbortSubAgentTool(deps),
+    ];
+}

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

@@ -0,0 +1,81 @@
+/**
+ * Sub Agent 类型定义。
+ *
+ * Sub agent 是由主 agent 通过 task 工具 spawn 的轻量级子代理，
+ * 拥有独立的 ACodeRuntime 实例（独立 context window）。
+ * 状态持久化到 ~/.acode/sub-agents/{agentId}.json（与 todo 同构）。
+ */
+/** Sub agent 类型（决定工具权限） */
+export type SubAgentType = "general" | "explore";
+/** Sub agent 状态机 */
+export type SubAgentStatus = "pending" | "running" | "completed" | "failed" | "cancelled";
+/** 实时上下文快照（供 dashboard popup 展示） */
+export interface SubAgentContextSnapshot {
+    /** 当前正在执行的工具名（如 "read_file"），无则 undefined */
+    currentTool?: string;
+    /** 最近一条 assistant 文本（截断 500 字符） */
+    lastAssistantText?: string;
+    /** 累计 token 用量 */
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    /** 已产生的消息数（含 user/assistant/tool） */
+    messageCount: number;
+    /** 最后更新时间（ISO） */
+    updatedAt: string;
+}
+/** 持久化的单条 sub-agent 记录 */
+export interface SubAgentRecord {
+    /** sub-agent 唯一 ID（= sub-session-id） */
+    subId: string;
+    /** 父 agent.id */
+    parentAgentId: string;
+    /** 父 agent 的 runtime_session_id（用于校验归属） */
+    parentSessionId: string;
+    /** sub-agent 类型 */
+    subagentType: SubAgentType;
+    /** LLM 给的 3-5 词任务描述 */
+    description: string;
+    /** LLM 给的完整任务 prompt */
+    prompt: string;
+    /** 当前状态 */
+    status: SubAgentStatus;
+    /** 完成时的最终输出文本（tool output） */
+    result?: string;
+    /** 失败时的错误信息 */
+    errorMessage?: string;
+    /** 开始时间（毫秒时间戳） */
+    startedAt: number;
+    /** 结束时间（毫秒时间戳） */
+    endedAt?: number;
+    /** 运行时长（毫秒） */
+    durationMs?: number;
+    /** 最后一次上下文快照（仅 running 状态有意义，持久化时清空） */
+    contextSnapshot?: SubAgentContextSnapshot;
+}
+/** 持久化的 sub-agent 文档结构 */
+export interface SubAgentDocument {
+    agentId: string;
+    updatedAt: string;
+    /** 全部 sub-agent 记录，按 startedAt 倒序 */
+    subAgents: SubAgentRecord[];
+}
+/** Sub agent 运行时事件（SSE 推送） */
+export interface SubAgentEvent {
+    /** 事件类型 */
+    type: "spawned" | "running" | "tool_start" | "tool_end" | "delta" | "completed" | "failed" | "cancelled";
+    /** sub-agent ID */
+    subId: string;
+    /** 事件时间戳（ISO） */
+    timestamp: string;
+    /** 事件数据（按 type 不同结构不同） */
+    data: {
+        tool?: string;
+        text?: string;
+        result?: string;
+        error?: string;
+        snapshot?: SubAgentContextSnapshot;
+    };
+}
+//# sourceMappingURL=sub-agent-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-types.d.ts","sourceRoot":"","sources":["../src/sub-agent-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2BAA2B;AAC3B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD,oBAAoB;AACpB,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,eAAe,CAAC,EAAE,uBAAuB,CAAC;CAC3C;AAED,0BAA0B;AAC1B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,IAAI,EACA,SAAS,GACT,SAAS,GACT,YAAY,GACZ,UAAU,GACV,OAAO,GACP,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;IAChB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,uBAAuB,CAAC;KACpC,CAAC;CACH"}

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

@@ -0,0 +1,8 @@
+/**
+ * Sub Agent 类型定义。
+ *
+ * Sub agent 是由主 agent 通过 task 工具 spawn 的轻量级子代理，
+ * 拥有独立的 ACodeRuntime 实例（独立 context window）。
+ * 状态持久化到 ~/.acode/sub-agents/{agentId}.json（与 todo 同构）。
+ */
+export {};

package/package/acode/dist/todo-store.d.ts

@@ -0,0 +1,42 @@
+/** 单条 todo 项 */
+export interface TodoItem {
+    /** 任务简短描述（必填） */
+    content: string;
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+    priority: "high" | "medium" | "low";
+}
+/** 持久化的 todo 文档结构 */
+export interface TodoDocument {
+    agentId: string;
+    updatedAt: string;
+    /**
+     * 整个 todo 列表的任务背景（必填）—— 描述该批任务的整体来源、目标、约束。
+     * 写入时由 todo_write 顶层传入，读取时一并返回，便于恢复任务上下文。
+     */
+    background: string;
+    todos: TodoItem[];
+}
+/**
+ * Todo JSON 文件存储，按 agentId 隔离。
+ * 文件路径：{homedir}/.acode/todos/{agentId}.json
+ *
+ * 路径与 bridge 现有 ~/.acode/cmd-dist/ 惯例一致，固定使用家目录：
+ *   - 不依赖 agent 工作目录，避免 workspacePath 错误时读取失败
+ *   - todo 跟随 agent（agentId），不跟随项目工作区
+ *
+ * 并发安全：同一 TodoStore 实例的写操作通过 Promise 链串行化，
+ * 避免同一 agentId 的并发 todo_write 互相覆盖。
+ * 写入采用 tmp + rename 原子替换，防止半写损坏。
+ */
+export declare class TodoStore {
+    private readonly todosDir;
+    private writeChain;
+    constructor();
+    /** 文件路径（按 agentId 隔离） */
+    private filePath;
+    /** 读取该 agentId 的 todo 文档。文件不存在或损坏时返回空文档。 */
+    read(agentId: string): Promise<TodoDocument>;
+    /** 全量替换该 agentId 的 todo 文档（background + todos）。串行化以避免并发覆盖。 */
+    write(agentId: string, background: string, todos: TodoItem[]): Promise<void>;
+}
+//# sourceMappingURL=todo-store.d.ts.map

package/package/acode/dist/todo-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-store.d.ts","sourceRoot":"","sources":["../src/todo-store.ts"],"names":[],"mappings":"AAIA,gBAAgB;AAChB,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9D,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAoC;;IAMtD,yBAAyB;IACzB,OAAO,CAAC,QAAQ;IAMhB,4CAA4C;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBlD,8DAA8D;IACxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBnF"}