aws-runtime-bridge 1.9.32 → 1.9.40

package/dist/services/event-delta-pusher.js

@@ -22,10 +22,10 @@ function runtimeAuthHeaders(authOptions, callbackBaseUrl) {
  * 暂以单次 push 模式实现，后续可按需改为批量/定时 flush。
  */
 export async function scheduleEventPush(agentId, _entry, authOptions) {
-    // 当前实现为 placeholder — 事件已写入 agentEventStore 的 ring buffer，
-    // 调度中心可通过 /runtime/events/:agentId 端点拉取。
-    // 后续可演进为 WebSocket 实时推送或定时批量 flush。
-    // 此处仅记录统计信息，不做实际 HTTP 推送。
+    // 事件传输由 sendStatus() / sendOutput() 中的 HTTP 回调直接完成（POST /api/runtime/callback/status|output），
+    // 调度中心收到回调后持久化到 DB SSOT 并通过 WebSocket AGENT_EVENTS_DELTA 广播给前端。
+    // 此函数仅用于记录推送统计，不做实际 HTTP 推送。
+    // 桥接侧 ring buffer 作为本地事件备份，可用于调试面板和增量查询。
     const state = getOrCreatePushState(agentId);
     state.success++;
     state.consecutiveFailures = 0;

package/dist/services/session-output.d.ts

@@ -31,6 +31,7 @@ export interface BridgeEventPayload {
     readonly actionInput?: string;
     readonly actionResult?: string;
     readonly actionId?: string;
+    readonly parentId?: string;
     readonly inputTokens?: number;
     readonly outputTokens?: number;
     readonly sourceEventType?: string;
@@ -57,6 +58,8 @@ interface RuntimeStatusActionInfo {
     actionInput?: string;
     actionResult?: string;
     actionId?: string;
+    /** 父事件 ID，用于事件父子层级（如压缩子事件关联到父压缩事件） */
+    parentId?: string;
 }
 export interface RuntimeCallbackAuthOptions {
     runtimeAccessToken?: string;

package/dist/services/session-output.d.ts.map

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

package/dist/services/session-output.js

@@ -105,6 +105,8 @@ export async function sendStatus(agentId, sessionId, status, actionInfo, usage,
             payload.actionResult = actionInfo.actionResult;
         if (actionInfo.actionId)
             payload.actionId = actionInfo.actionId;
+        if (actionInfo.parentId)
+            payload.parentId = actionInfo.parentId;
     }
     // 添加 token 用量信息
     if (usage) {
@@ -124,8 +126,29 @@ export async function sendStatus(agentId, sessionId, status, actionInfo, usage,
         logger.warn("Skip runtime status callback because runtime token is missing", { agentId, sessionId, status, schedulerBaseUrl: callbackBaseUrl });
         return undefined;
     }
+    // ★ 诊断日志：为 context_compaction 事件记录发送过程，排查间歇性丢失
+    const isCompactionEvent = actionInfo?.actionType === "context_compaction";
+    if (isCompactionEvent) {
+        logger.info("[compaction-diag] sendStatus enter", {
+            agentId, sessionId, status,
+            actionId: actionInfo?.actionId,
+            parentId: actionInfo?.parentId,
+            actionLabel: actionInfo?.actionLabel,
+        });
+    }
     try {
-        return await axios.post(`${callbackBaseUrl}/api/runtime/callback/status`, payload, { headers });
+        const response = await axios.post(`${callbackBaseUrl}/api/runtime/callback/status`, payload, { headers, timeout: 15000 });
+        if (isCompactionEvent) {
+            const data = response?.data;
+            logger.info("[compaction-diag] sendStatus success", {
+                agentId, actionId: actionInfo?.actionId,
+                actionLabel: actionInfo?.actionLabel,
+                httpStatus: response?.status,
+                ignored: data?.ignored,
+                responseBody: data,
+            });
+        }
+        return response;
     }
     catch (error) {
         if (getAxiosStatusCode(error) === 401) {
@@ -134,7 +157,17 @@ export async function sendStatus(agentId, sessionId, status, actionInfo, usage,
                 const retryHeaders = runtimeAuthHeaders(authOptions, callbackBaseUrl);
                 if (retryHeaders) {
                     try {
-                        return await axios.post(`${callbackBaseUrl}/api/runtime/callback/status`, payload, { headers: retryHeaders });
+                        const retryResponse = await axios.post(`${callbackBaseUrl}/api/runtime/callback/status`, payload, { headers: retryHeaders, timeout: 15000 });
+                        if (isCompactionEvent) {
+                            const data = retryResponse?.data;
+                            logger.info("[compaction-diag] sendStatus retry success", {
+                                agentId, actionId: actionInfo?.actionId,
+                                actionLabel: actionInfo?.actionLabel,
+                                httpStatus: retryResponse?.status,
+                                ignored: data?.ignored,
+                            });
+                        }
+                        return retryResponse;
                     }
                     catch (retryError) {
                         logger.warn("Runtime status callback retry failed after token refresh", {
@@ -167,6 +200,9 @@ export async function sendStatus(agentId, sessionId, status, actionInfo, usage,
             actionInput: actionInfo?.actionInput,
             actionResult: actionInfo?.actionResult,
             actionId: actionInfo?.actionId,
+            // ★ 必须写入 parentId，否则子事件（如压缩 phase/end 子事件）在前端
+            //    buildEventTreeFromFlat 中找不到父事件，会作为孤儿子事件扁平化渲染。
+            parentId: actionInfo?.parentId,
             inputTokens: usage?.inputTokens,
             outputTokens: usage?.outputTokens,
             sourceEventType,

package/dist/services/sub-agent-manager-instance.d.ts

@@ -0,0 +1,4 @@
+import { SubAgentManager, SubAgentStore } from "@agentswork/acode";
+export declare const subAgentManager: SubAgentManager;
+export declare const subAgentStore: SubAgentStore;
+//# sourceMappingURL=sub-agent-manager-instance.d.ts.map

package/dist/services/sub-agent-manager-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-manager-instance.d.ts","sourceRoot":"","sources":["../../src/services/sub-agent-manager-instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWnE,eAAO,MAAM,eAAe,iBAAiC,CAAC;AAC9D,eAAO,MAAM,aAAa,eAAQ,CAAC"}

package/dist/services/sub-agent-manager-instance.js

@@ -0,0 +1,12 @@
+import { SubAgentManager, SubAgentStore } from "@agentswork/acode";
+/**
+ * Bridge 层 SubAgentManager 单例。
+ *
+ * 每个 bridge 进程持有一个 SubAgentManager 实例，
+ * 所有 ACodeRuntime 实例共享（通过 ACodeRuntimeConfig.subAgentManager 注入）。
+ *
+ * SubAgentStore 同样单例，所有 agent 共用（按 agentId 文件隔离）。
+ */
+const store = new SubAgentStore();
+export const subAgentManager = new SubAgentManager({ store });
+export const subAgentStore = store;

package/dist/services/workspace-files.d.ts

@@ -134,6 +134,7 @@ export declare function readWorkspaceFile(params: WorkspaceFileParams): Promise<
 /**
  * 读取工作区条目的属性信息。
  * 主流程：解析安全路径 -> 读取 stat/lstat -> 文件额外尝试解析图片尺寸。
+ * 对于目录，stat.size 只是目录项元数据大小，需要递归统计子文件总和。
  */
 export declare function getWorkspaceEntryProperties(params: DeleteWorkspaceEntryParams): Promise<WorkspaceEntryPropertiesResult>;
 /**

package/dist/services/workspace-files.d.ts.map

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

package/dist/services/workspace-files.js

@@ -475,9 +475,61 @@ export async function readWorkspaceFile(params) {
         content
     };
 }
+/**
+ * 目录大小计算上限，避免在工作区体量异常时长时间阻塞属性查询。
+ */
+const DIRECTORY_SIZE_LIMITS = {
+    maxEntries: 100_000,
+    maxDepth: 32,
+};
+/**
+ * 递归累加目录内所有普通文件的总大小。
+ * 跳过符号链接以避免跟随循环，访问失败的单个条目直接忽略。
+ */
+async function calculateDirectorySize(workspaceRoot, directoryPath) {
+    let total = 0;
+    let entriesProcessed = 0;
+    async function walk(dirPath, depth) {
+        if (depth >= DIRECTORY_SIZE_LIMITS.maxDepth) {
+            return;
+        }
+        let entries;
+        try {
+            entries = await fs.readdir(dirPath, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            entriesProcessed += 1;
+            if (entriesProcessed > DIRECTORY_SIZE_LIMITS.maxEntries) {
+                return;
+            }
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            const entryPath = ensureInsideWorkspace(workspaceRoot, path.join(dirPath, entry.name));
+            try {
+                if (entry.isDirectory()) {
+                    await walk(entryPath, depth + 1);
+                }
+                else if (entry.isFile()) {
+                    const stat = await fs.stat(entryPath);
+                    total += stat.size;
+                }
+            }
+            catch {
+                // 单个条目失败不影响整体统计
+            }
+        }
+    }
+    await walk(directoryPath, 0);
+    return total;
+}
 /**
  * 读取工作区条目的属性信息。
  * 主流程：解析安全路径 -> 读取 stat/lstat -> 文件额外尝试解析图片尺寸。
+ * 对于目录，stat.size 只是目录项元数据大小，需要递归统计子文件总和。
  */
 export async function getWorkspaceEntryProperties(params) {
     const { workspaceRoot, resolvedTargetPath } = await resolveEntryTarget(params, { allowWorkspaceRoot: true });
@@ -485,7 +537,11 @@ export async function getWorkspaceEntryProperties(params) {
         fs.stat(resolvedTargetPath),
         fs.lstat(resolvedTargetPath),
     ]);
+    const isDirectory = stat.isDirectory();
     const image = stat.isFile() ? await readImageProperties(resolvedTargetPath) : undefined;
+    const size = isDirectory
+        ? await calculateDirectorySize(workspaceRoot, resolvedTargetPath)
+        : stat.size;
     return {
         workspacePath: toDisplayPath(workspaceRoot),
         targetPath: toDisplayPath(resolvedTargetPath),
@@ -493,7 +549,7 @@ export async function getWorkspaceEntryProperties(params) {
         isDirectory: stat.isDirectory(),
         isFile: stat.isFile(),
         isSymbolicLink: linkStat.isSymbolicLink(),
-        size: stat.size,
+        size,
         mode: stat.mode,
         modeOctal: formatModeOctal(stat.mode),
         permissions: formatPermissions(stat.mode),

package/package/acode/dist/ask-user-question-tool.d.ts

@@ -0,0 +1,47 @@
+import { type ACodeBuiltInTool } from "./built-in-file-tools.js";
+/**
+ * ask_user_question 工具的依赖：由 ACodeRuntime 注入，
+ * 让工具的 execute() 能通知 runtime 发出 question_request 事件，
+ * 并阻塞等待 runtime 通过 submitQuestionAnswer() 回传答案。
+ */
+export interface AcodeAskUserQuestionDeps {
+    /**
+     * 当工具被调用时，runtime 应发出 question_request 事件，
+     * 携带 questions 与 toolCallId，让适配器转发到前端。
+     */
+    onQuestion(toolCallId: string, questions: AcodeQuestionItem[]): void;
+    /**
+     * 阻塞等待用户回答。runtime 内部用 questionWaiters Map 管理 Promise，
+     * submitQuestionAnswer() 调用时 resolve，abort/stop 时 reject。
+     */
+    waitForAnswer(toolCallId: string, contextVersion: number): Promise<Record<string, string>>;
+}
+export interface AcodeQuestionOption {
+    label: string;
+    description?: string;
+    requiresCustomInput?: boolean;
+}
+export interface AcodeQuestionItem {
+    question: string;
+    header?: string;
+    options: AcodeQuestionOption[];
+    multiple?: boolean;
+}
+export interface AcodeAskUserQuestionResult {
+    ok: true;
+    tool: "ask_user_question";
+    answers: Record<string, string>;
+    summary: string;
+}
+/** 工具名常量，供 runtime/adapter 引用 */
+export declare const ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
+/**
+ * 创建 ask_user_question 内置工具。
+ * 由 ACodeRuntime.start() 调用并注入 deps。
+ */
+export declare function createAskUserQuestionTool(deps: AcodeAskUserQuestionDeps, contextVersionProvider: () => number): ACodeBuiltInTool;
+/** 类型守卫：判断一个值是否为 ask_user_question 工具的成功结果 */
+export declare function isAskUserQuestionResult(value: unknown): value is AcodeAskUserQuestionResult;
+/** 将成功结果转为 JSON 字符串（供 toToolResultText 调用） */
+export declare function serializeAskUserQuestionResult(result: AcodeAskUserQuestionResult): string;
+//# sourceMappingURL=ask-user-question-tool.d.ts.map

package/package/acode/dist/ask-user-question-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question-tool.d.ts","sourceRoot":"","sources":["../src/ask-user-question-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,iBAAiB,EAAE,GAC7B,IAAI,CAAC;IAER;;;OAGG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iCAAiC;AACjC,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAU/D;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,wBAAwB,EAC9B,sBAAsB,EAAE,MAAM,MAAM,GACnC,gBAAgB,CAwDlB;AA2JD,8CAA8C;AAC9C,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,0BAA0B,CAUrC;AAED,8CAA8C;AAC9C,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAQR"}

package/package/acode/dist/ask-user-question-tool.js

@@ -0,0 +1,233 @@
+/** 工具名常量，供 runtime/adapter 引用 */
+export const ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
+const TOOL_DESCRIPTION = [
+    "向用户提出结构化问题以收集偏好、澄清需求、做决策或提供方向选择。",
+    "每次最多 4 个问题，每个问题 2-4 个选项；UI 会自动追加“其它”选项供用户自定义输入。",
+    "工具调用会阻塞当前轮次直到用户回答；用户回答后答案会作为 tool result 回传给你。",
+    "请勿用此工具请求计划审批——那是 plan 工具的职责。",
+    "如果推荐某个选项，把它放在第一位并在 label 末尾加“（推荐）”。",
+].join("\n");
+/**
+ * 创建 ask_user_question 内置工具。
+ * 由 ACodeRuntime.start() 调用并注入 deps。
+ */
+export function createAskUserQuestionTool(deps, contextVersionProvider) {
+    return {
+        kind: "builtin",
+        toolName: ASK_USER_QUESTION_TOOL_NAME,
+        exposedName: ASK_USER_QUESTION_TOOL_NAME,
+        description: TOOL_DESCRIPTION,
+        inputSchema: buildInputSchema(),
+        async execute(args, context) {
+            const toolCallId = context?.toolCallId;
+            if (!toolCallId) {
+                return {
+                    ok: false,
+                    tool: ASK_USER_QUESTION_TOOL_NAME,
+                    error: "missing toolCallId in execution context",
+                };
+            }
+            const questions = normalizeQuestions(args.questions);
+            if (questions.length === 0) {
+                return {
+                    ok: false,
+                    tool: ASK_USER_QUESTION_TOOL_NAME,
+                    error: "questions must be a non-empty array (1-4 items)",
+                };
+            }
+            // 通知 runtime 发出 question_request 事件
+            deps.onQuestion(toolCallId, questions);
+            // 阻塞等待用户回答；abort/stop/supersede 时会 reject
+            const contextVersion = contextVersionProvider();
+            let answers;
+            try {
+                answers = await deps.waitForAnswer(toolCallId, contextVersion);
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                return {
+                    ok: false,
+                    tool: ASK_USER_QUESTION_TOOL_NAME,
+                    error: reason,
+                };
+            }
+            const summary = formatAnswerSummary(questions, answers);
+            const result = {
+                ok: true,
+                tool: ASK_USER_QUESTION_TOOL_NAME,
+                answers,
+                summary,
+            };
+            return result;
+        },
+    };
+}
+function buildInputSchema() {
+    return {
+        type: "object",
+        properties: {
+            questions: {
+                type: "array",
+                description: "要提问的问题列表（1-4 个）",
+                minItems: 1,
+                maxItems: 4,
+                items: {
+                    type: "object",
+                    properties: {
+                        question: {
+                            type: "string",
+                            description: "完整问题文本，建议以问号结尾",
+                        },
+                        header: {
+                            type: "string",
+                            description: "≤12 字符的简短标签，用于 UI chip 显示",
+                        },
+                        options: {
+                            type: "array",
+                            description: "2-4 个互斥选项（multiSelect=true 时可不互斥）",
+                            minItems: 2,
+                            maxItems: 4,
+                            items: {
+                                type: "object",
+                                properties: {
+                                    label: {
+                                        type: "string",
+                                        description: "1-5 词的简短标签",
+                                    },
+                                    description: {
+                                        type: "string",
+                                        description: "选项含义或权衡说明",
+                                    },
+                                    requiresCustomInput: {
+                                        type: "boolean",
+                                        description: "选中此项时 UI 显示自定义输入框",
+                                    },
+                                },
+                                required: ["label"],
+                            },
+                        },
+                        multiple: {
+                            type: "boolean",
+                            description: "是否允许多选；默认 false",
+                        },
+                    },
+                    required: ["question", "options"],
+                },
+            },
+            custom: {
+                type: "boolean",
+                description: "是否允许用户补充自定义输入；默认 true",
+            },
+        },
+        required: ["questions"],
+    };
+}
+function normalizeQuestions(raw) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        return [];
+    }
+    const items = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const obj = entry;
+        const question = typeof obj.question === "string" ? obj.question.trim() : "";
+        if (!question)
+            continue;
+        const options = normalizeOptions(obj.options);
+        if (options.length < 2)
+            continue;
+        const header = typeof obj.header === "string" && obj.header.trim()
+            ? obj.header.trim()
+            : undefined;
+        const multiple = obj.multiple === true || obj.multiSelect === true;
+        items.push({ question, header, options, multiple });
+        if (items.length >= 4)
+            break;
+    }
+    return items;
+}
+function normalizeOptions(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const options = [];
+    for (const entry of raw) {
+        if (typeof entry === "string") {
+            const label = entry.trim();
+            if (label)
+                options.push({ label });
+            continue;
+        }
+        if (!entry || typeof entry !== "object")
+            continue;
+        const obj = entry;
+        const label = typeof obj.label === "string"
+            ? obj.label.trim()
+            : typeof obj.value === "string"
+                ? obj.value.trim()
+                : typeof obj.text === "string"
+                    ? obj.text.trim()
+                    : "";
+        if (!label)
+            continue;
+        const description = typeof obj.description === "string" && obj.description.trim()
+            ? obj.description.trim()
+            : undefined;
+        const requiresCustomInput = obj.requiresCustomInput === true ||
+            obj.requireCustomInput === true ||
+            obj.allowCustomInput === true;
+        options.push({
+            label,
+            ...(description ? { description } : {}),
+            ...(requiresCustomInput ? { requiresCustomInput } : {}),
+        });
+        if (options.length >= 4)
+            break;
+    }
+    return options;
+}
+/**
+ * 将答案格式化为可读摘要，确保即使 answers 序列化丢字段，
+ * LLM 也能从 summary 文本读到答案。
+ */
+function formatAnswerSummary(questions, answers) {
+    const lines = ["用户已回答了您的问题："];
+    questions.forEach((q, index) => {
+        const key = String(index);
+        const answer = answers[key] ||
+            (q.header ? answers[q.header] : "") ||
+            answers[q.question] ||
+            "（未填写）";
+        const prefix = q.header || q.question;
+        lines.push(`• ${prefix}：${answer}`);
+    });
+    return lines.join("\n");
+}
+/** 类型守卫：判断一个值是否为 ask_user_question 工具的成功结果 */
+export function isAskUserQuestionResult(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const obj = value;
+    return (obj.ok === true &&
+        obj.tool === ASK_USER_QUESTION_TOOL_NAME &&
+        typeof obj.answers === "object" &&
+        obj.answers !== null &&
+        typeof obj.summary === "string");
+}
+/** 将成功结果转为 JSON 字符串（供 toToolResultText 调用） */
+export function serializeAskUserQuestionResult(result) {
+    const json = {
+        ok: true,
+        tool: ASK_USER_QUESTION_TOOL_NAME,
+        answers: answersToJsonObject(result.answers),
+        summary: result.summary,
+    };
+    return JSON.stringify(json);
+}
+function answersToJsonObject(answers) {
+    const out = {};
+    for (const [key, value] of Object.entries(answers)) {
+        out[key] = value;
+    }
+    return out;
+}

package/package/acode/dist/built-in-file-tools.d.ts

@@ -15,6 +15,8 @@ export interface ACodeBuiltInTool {
 }
 export interface ACodeBuiltInToolExecutionContext {
     readonly onOutput?: CommandOutputSink;
+    /** 当前工具调用的 ID（toolCall.id），用于需要关联请求与响应的工具（如 ask_user_question） */
+    readonly toolCallId?: string;
 }
 export declare function createBuiltInFileTools(workingDirectory: string, agentId?: string): ACodeBuiltInTool[];
 //# sourceMappingURL=built-in-file-tools.d.ts.map

package/package/acode/dist/built-in-file-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAufD,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,EAAE,CAQpB"}
+{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAufD,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,EAAE,CAQpB"}