sema-core 1.0.14 → 2.0.1

package/dist/tools/PatchFile.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatchFile = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const zod_1 = require("zod");
+const file_1 = require("../util/file");
+const diff_1 = require("../util/diff");
+const cwd_1 = require("../util/cwd");
+const tool_1 = require("../prompt/tool");
+const edit_1 = require("../util/edit");
+const StateManager_1 = require("../manager/StateManager");
+const toolParams = zod_1.z.strictObject({
+    file_path: zod_1.z.string().describe('Absolute path of the file to edit'),
+    search_text: zod_1.z.string().describe('The exact text in the file that should be replaced (must differ from replacement)'),
+    replacement: zod_1.z.string().describe('The new text to substitute in place of search_text (must differ from search_text)'),
+    global_replace: zod_1.z.boolean().optional().default(false).describe('When true, replace every occurrence of search_text in the file. Defaults to false (single match only).')
+});
+// 辅助函数：生成显示标题
+function getTitle(input) {
+    if (input?.file_path) {
+        return (0, path_1.relative)((0, cwd_1.readInitialCwd)(), input.file_path);
+    }
+    return tool_1.TOOL_NAME_PATCH_FILE;
+}
+// 构建 diff 类型的 content 对象
+function makeDiffContent(patch) {
+    return { type: 'diff', patch, diffText: '' };
+}
+exports.PatchFile = {
+    name: tool_1.TOOL_NAME_PATCH_FILE,
+    description() {
+        return `Replace an exact snippet in a file with new text.
+You must read the file first. When copying text from its output, skip the line-number prefix — only match content after the tab.
+\`search_text\` must be unique in the file. If not, include more surrounding lines to disambiguate, or set \`global_replace: true\` to replace every occurrence (useful for renames).
+Always edit existing files rather than creating new ones. Never add emojis unless asked.`;
+    },
+    toolParams,
+    isSafe() {
+        return false;
+    },
+    genToolPermission(input) {
+        const title = getTitle(input);
+        // 读取原文件内容，生成diff预览（不应用编辑）
+        // 统一转为 LF，保证 diff 计算与前端展示一致
+        const fullFilePath = (0, file_1.canonicalizeFilePath)(input.file_path);
+        const enc = (0, file_1.inferFileEncoding)(fullFilePath);
+        const originalContent = (0, edit_1.normalizeLF)((0, fs_1.readFileSync)(fullFilePath, enc));
+        const normalizedOldStr = (0, edit_1.normalizeLF)(input.search_text);
+        const normalizedNewStr = (0, edit_1.normalizeLF)(input.replacement);
+        const patch = (0, diff_1.getPatch)({
+            filePath: fullFilePath,
+            fileContents: originalContent,
+            oldStr: normalizedOldStr,
+            newStr: normalizedNewStr,
+        });
+        return { title, content: makeDiffContent(patch) };
+    },
+    genToolResultMessage({ filePath, structuredPatch }) {
+        const title = getTitle({ file_path: filePath });
+        const summary = (0, diff_1.getUpdateSummary)(filePath, structuredPatch);
+        return { title, summary, content: makeDiffContent(structuredPatch) };
+    },
+    getDisplayTitle(input) {
+        return getTitle(input);
+    },
+    async validateInput({ file_path, search_text, replacement, global_replace }, agentContext) {
+        // 通过 agentContext 访问隔离状态
+        const stateManager = (0, StateManager_1.getStateManager)();
+        const agentState = stateManager.forAgent(agentContext);
+        const readFileTimestamps = agentState.getReadFileTimestamps();
+        if (search_text === replacement) {
+            return {
+                result: false,
+                message: 'search_text and replacement are identical — nothing to change.',
+                meta: {
+                    search_text,
+                },
+            };
+        }
+        const fullFilePath = (0, file_1.canonicalizeFilePath)(file_path);
+        if ((0, fs_1.existsSync)(fullFilePath) && search_text === '') {
+            return {
+                result: false,
+                message: 'The file already exists; cannot create it again.',
+            };
+        }
+        if (!(0, fs_1.existsSync)(fullFilePath) && search_text === '') {
+            return {
+                result: true,
+            };
+        }
+        if (!(0, fs_1.existsSync)(fullFilePath)) {
+            const similarFilename = (0, file_1.findFileWithDifferentExt)(fullFilePath);
+            let message = 'The specified file was not found.';
+            if (similarFilename) {
+                message += ` Perhaps you meant ${similarFilename}?`;
+            }
+            return {
+                result: false,
+                message,
+            };
+        }
+        if (fullFilePath.endsWith('.ipynb')) {
+            return {
+                result: false,
+                message: `This is a Jupyter Notebook — please use ${tool_1.TOOL_NAME_EDIT_NOTEBOOK} instead.`,
+            };
+        }
+        const readTimestamp = readFileTimestamps[fullFilePath];
+        if (!readTimestamp) {
+            return {
+                result: false,
+                message: 'You need to read the file before editing it.',
+                meta: {
+                    isFilePathAbsolute: String((0, path_1.isAbsolute)(file_path)),
+                },
+            };
+        }
+        const stats = (0, fs_1.statSync)(fullFilePath);
+        const lastWriteTime = stats.mtimeMs;
+        if (lastWriteTime > readTimestamp) {
+            return {
+                result: false,
+                message: 'The file was modified externally since last read. Please re-read it before editing.',
+            };
+        }
+        const enc = (0, file_1.inferFileEncoding)(fullFilePath);
+        const rawFile = (0, fs_1.readFileSync)(fullFilePath, enc);
+        const file = (0, edit_1.normalizeLF)(rawFile);
+        const normalizedSearchText = (0, edit_1.normalizeLF)(search_text);
+        if (!file.includes(normalizedSearchText)) {
+            // 生成诊断信息：显示 search_text 的前 100 个字符和文件开头 500 字符
+            const searchTextPreview = normalizedSearchText.slice(0, 100).replace(/\n/g, '\\n');
+            const filePreview = file.slice(0, 500).replace(/\n/g, '\\n');
+            const fileLineEnding = rawFile.includes('\r\n') ? 'CRLF' : rawFile.includes('\r') ? 'CR' : 'LF';
+            return {
+                result: false,
+                message: `The specified search_text does not exist in the file.\n\nDiagnostics:\n- Line endings: ${fileLineEnding}\n- search_text preview (100 chars): ${searchTextPreview}\n- File preview (500 chars): ${filePreview}`,
+                meta: {
+                    isFilePathAbsolute: String((0, path_1.isAbsolute)(file_path)),
+                    fileLineEnding,
+                    searchTextLength: search_text.length,
+                    normalizedSearchTextLength: normalizedSearchText.length,
+                    fileLength: file.length,
+                },
+            };
+        }
+        const matches = file.split(normalizedSearchText).length - 1;
+        if (matches > 1 && !global_replace) {
+            return {
+                result: false,
+                message: `Detected ${matches} occurrences of search_text. By default only a single unique match is allowed. Either include more surrounding context to narrow it down, or set global_replace to true.`,
+                meta: {
+                    isFilePathAbsolute: String((0, path_1.isAbsolute)(file_path)),
+                },
+            };
+        }
+        return { result: true };
+    },
+    async *call({ file_path, search_text, replacement, global_replace }, agentContext) {
+        const { patch, updatedFile } = (0, edit_1.applyEdit)(file_path, search_text, replacement, global_replace);
+        const stateManager = (0, StateManager_1.getStateManager)();
+        const agentState = stateManager.forAgent(agentContext);
+        const fullFilePath = (0, file_1.canonicalizeFilePath)(file_path);
+        const dir = (0, path_1.dirname)(fullFilePath);
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+        const fileExists = (0, fs_1.existsSync)(fullFilePath);
+        const enc = fileExists ? (0, file_1.inferFileEncoding)(fullFilePath) : 'utf8';
+        const endings = fileExists ? (agentState.getFileLineEnding(fullFilePath) ?? (0, file_1.inferLineEndings)(fullFilePath)) : 'LF';
+        const originalFile = fileExists
+            ? (0, edit_1.normalizeLF)((0, fs_1.readFileSync)(fullFilePath, enc))
+            : '';
+        // 权限确认后二次校验时间戳，防止用户在权限对话框期间修改文件
+        if (fileExists) {
+            const readTimestamp = agentState.getReadFileTimestamps()[fullFilePath];
+            const currentMtime = (0, fs_1.statSync)(fullFilePath).mtimeMs;
+            if (readTimestamp && currentMtime > readTimestamp) {
+                throw new Error('The file changed while awaiting permission. Please re-read it before editing.');
+            }
+        }
+        (0, file_1.writeTextFile)(fullFilePath, updatedFile, enc, endings);
+        agentState.setReadFileTimestamp(fullFilePath, (0, fs_1.statSync)(fullFilePath).mtimeMs);
+        const data = {
+            filePath: file_path,
+            oldString: search_text,
+            newString: replacement,
+            originalFile,
+            structuredPatch: patch,
+        };
+        yield {
+            type: 'result',
+            data,
+            resultForAssistant: this.genResultForAssistant(data),
+        };
+    },
+    genResultForAssistant({ filePath, originalFile, oldString, newString }) {
+        const CONTEXT_LINES = 4;
+        const file = originalFile || '';
+        const targetIdx = file.indexOf(oldString);
+        const targetLine = targetIdx === -1
+            ? 0
+            : file.substring(0, targetIdx).split(/\r?\n/).length - 1;
+        const allLines = file.replace(oldString, newString).split(/\r?\n/);
+        const replacementLineCount = newString ? newString.split(/\r?\n/).length : 0;
+        const start = Math.max(0, Math.min(targetLine - CONTEXT_LINES, allLines.length));
+        const end = Math.max(0, Math.min(targetLine + CONTEXT_LINES + replacementLineCount, allLines.length));
+        const snippet = allLines.slice(start, end).join('\n');
+        const startLine = start + 1;
+        return `Successfully edited ${filePath}. Below is the updated snippet with line numbers:
+${(0, file_1.formatWithLineNumbers)({ content: snippet, startLine })}`;
+    },
+};
+//# sourceMappingURL=PatchFile.js.map

package/dist/tools/PatchFile.js.map

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

package/dist/tools/PeekBgJob.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+export declare const toolParams: z.ZodObject<{
+    job_id: z.ZodString;
+    wait: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    wait_timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strict", z.ZodTypeAny, {
+    job_id: string;
+    wait: boolean;
+    wait_timeout: number;
+}, {
+    job_id: string;
+    wait?: boolean | undefined;
+    wait_timeout?: number | undefined;
+}>;
+type ToolOut = {
+    taskId: string;
+    retrievalStatus: string;
+    taskStatus: string;
+    taskType: string;
+    output: string;
+};
+export declare const PeekBgJob: {
+    name: string;
+    description(): string;
+    isSafe(): true;
+    supportsInterrupt(): true;
+    toolParams: z.ZodObject<{
+        job_id: z.ZodString;
+        wait: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        wait_timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strict", z.ZodTypeAny, {
+        job_id: string;
+        wait: boolean;
+        wait_timeout: number;
+    }, {
+        job_id: string;
+        wait?: boolean | undefined;
+        wait_timeout?: number | undefined;
+    }>;
+    genToolResultMessage(data: ToolOut): {
+        title: string;
+        summary: string;
+        content: string;
+    };
+    getDisplayTitle(input: any): string;
+    genResultForAssistant(data: ToolOut): string;
+    call({ job_id, wait, wait_timeout }: {
+        job_id: string;
+        wait?: boolean;
+        wait_timeout?: number;
+    }, agentContext: any): AsyncGenerator<{
+        type: "result";
+        data: ToolOut;
+        resultForAssistant: string | (import("@anthropic-ai/sdk/resources").TextBlockParam | import("@anthropic-ai/sdk/resources").ImageBlockParam)[] | undefined;
+    }, void, unknown>;
+};
+export {};
+//# sourceMappingURL=PeekBgJob.d.ts.map

package/dist/tools/PeekBgJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeekBgJob.d.ts","sourceRoot":"","sources":["../../src/tools/PeekBgJob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AASvB,eAAO,MAAM,UAAU;;;;;;;;;;;;EAYrB,CAAA;AAGF,KAAK,OAAO,GAAG;IACb,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;+BAYO,OAAO;;;;;2BAOX,GAAG;gCAGE,OAAO,GAAG,MAAM;yCAKe;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,gBAAgB,GAAG;;;;;CA0C5G,CAAA"}

package/dist/tools/PeekBgJob.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeekBgJob = exports.toolParams = void 0;
+const zod_1 = require("zod");
+const TaskManager_1 = require("../manager/TaskManager");
+const EventSystem_1 = require("../events/EventSystem");
+const StateManager_1 = require("../manager/StateManager");
+const shell_1 = require("../util/shell");
+const tool_1 = require("../prompt/tool");
+exports.toolParams = zod_1.z.strictObject({
+    job_id: zod_1.z.string().describe('ID of the background task whose output you want'),
+    wait: zod_1.z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('When true (default), waits until the task finishes before returning. Set to false to get a snapshot of the current output immediately.'),
+    wait_timeout: zod_1.z
+        .number()
+        .optional()
+        .default(30000)
+        .describe('How long to wait (in ms) for task completion when wait is true. Defaults to 30000 (30 seconds).'),
+});
+exports.PeekBgJob = {
+    name: tool_1.TOOL_NAME_PEEK_BG_JOB,
+    description() {
+        return `Retrieve the output of a background task started by the ${tool_1.TOOL_NAME_RUN_SHELL} tool with background=true. Use wait=true (default) to wait for completion, or wait=false to get the current snapshot immediately.`;
+    },
+    isSafe() {
+        return true;
+    },
+    supportsInterrupt() {
+        return true;
+    },
+    toolParams: exports.toolParams,
+    genToolResultMessage(data) {
+        return {
+            title: data.taskId,
+            summary: '',
+            content: data.output || '(no content)',
+        };
+    },
+    getDisplayTitle(input) {
+        return `${input?.job_id}`;
+    },
+    genResultForAssistant(data) {
+        return `[${tool_1.TOOL_NAME_PEEK_BG_JOB}] task_id=${data.taskId} task_type=${data.taskType} status=${data.taskStatus} retrieval=${data.retrievalStatus}
+- output:
+${data.output}`;
+    },
+    async *call({ job_id, wait = true, wait_timeout = 30000 }, agentContext) {
+        const manager = (0, TaskManager_1.getTaskManager)();
+        const record = manager.getTask(job_id);
+        if (!record) {
+            const data = { taskId: job_id, retrievalStatus: 'not_found', taskStatus: 'not_found', taskType: '', output: '' };
+            yield { type: 'result', data, resultForAssistant: this.genResultForAssistant(data) };
+            return;
+        }
+        // wait=false 或任务已完成，直接返回当前快照
+        // 已结束任务的 output 已被清空，getTaskOutput 会回退读取输出文件
+        if (!wait || record.status !== 'running') {
+            const output = truncateOutput(manager.getTaskOutput(job_id));
+            const data = { taskId: job_id, retrievalStatus: record.status, taskStatus: record.status, taskType: record.type, output };
+            yield { type: 'result', data, resultForAssistant: this.genResultForAssistant(data) };
+            return;
+        }
+        // wait=true，等待任务完成
+        // SubAgent 任务无增量输出，只有 Bash 任务才流式推送
+        const isMainAgent = agentContext?.agentId === StateManager_1.MAIN_AGENT_ID;
+        const onChunk = (isMainAgent && record.type !== 'SubAgent') ? (delta) => {
+            const chunkData = {
+                agentId: agentContext.agentId,
+                toolId: agentContext.currentToolUseID || '',
+                toolName: tool_1.TOOL_NAME_PEEK_BG_JOB,
+                title: `${job_id}`,
+                summary: '',
+                content: delta,
+            };
+            (0, EventSystem_1.getEventBus)().emit('tool:execution:chunk', chunkData, agentContext.sessionId);
+        } : undefined;
+        const abortSignal = agentContext?.abortController?.signal;
+        const finalRecord = await manager.waitForTask(job_id, wait_timeout, onChunk, abortSignal);
+        const interrupted = abortSignal?.aborted ?? false;
+        const output = truncateOutput(manager.getTaskOutput(job_id));
+        const retrievalStatus = interrupted ? 'not_ready' : (finalRecord.status === 'running' ? 'timeout' : 'completed');
+        const data = { taskId: job_id, retrievalStatus, taskStatus: finalRecord.status, taskType: finalRecord.type, output };
+        yield { type: 'result', data, resultForAssistant: this.genResultForAssistant(data) };
+    },
+};
+function truncateOutput(output) {
+    const { truncatedContent } = (0, shell_1.formatOutput)(output);
+    return truncatedContent;
+}
+//# sourceMappingURL=PeekBgJob.js.map

package/dist/tools/PeekBgJob.js.map

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