@gatanot/qualia_core 0.1.0

package/dist/tool/tools/edit.js

@@ -0,0 +1,159 @@
+import { readFile } from 'node:fs/promises';
+import { PendingConfirmation } from '../types.js';
+import { stripBom, detectMeta, normalizeToLF, atomicWrite } from './file-utils.js';
+function escapeNewlines(s) {
+    return s.replace(/\r/g, '\\r').replace(/\n/g, '\\n');
+}
+function formatDiff(original, replacement) {
+    return `- ${escapeNewlines(original)}\n+ ${escapeNewlines(replacement)}`;
+}
+function countOccurrences(haystack, needle) {
+    if (!needle)
+        return 0;
+    let count = 0;
+    let pos = 0;
+    while (true) {
+        pos = haystack.indexOf(needle, pos);
+        if (pos === -1)
+            break;
+        count++;
+        pos += needle.length;
+    }
+    return count;
+}
+/**
+ * edit — 精确字符串替换编辑文件
+ *
+ * 在文件中查找 oldString 并替换为 newString。
+ * 使用原子写入，自动保留原文件的 BOM 和行尾格式。
+ * 非 replaceAll 模式下，oldString 必须在文件中恰好出现一次。
+ */
+export const editTool = {
+    name: 'edit',
+    description: 'Perform exact string replacement in a file. Find oldString and replace with newString. In non-replaceAll mode, oldString must appear exactly once (prevents accidental changes). Preserves BOM and line endings (CRLF/LF).',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'File path (relative to workspace or absolute)'
+            },
+            oldString: {
+                type: 'string',
+                description: 'Original text to replace (must match file content exactly, including indentation and blank lines)'
+            },
+            newString: {
+                type: 'string',
+                description: 'Replacement text'
+            },
+            replaceAll: {
+                type: 'boolean',
+                description: 'Replace all occurrences. Default false — oldString must appear exactly once in the file.'
+            }
+        },
+        required: ['path', 'oldString', 'newString']
+    },
+    async execute(args, ctx) {
+        const userPath = args.path;
+        const oldString = args.oldString;
+        const newString = args.newString;
+        const replaceAll = args.replaceAll === true;
+        if (!userPath) {
+            return { success: false, output: '', error: '缺少参数: path' };
+        }
+        if (oldString === undefined || oldString === null) {
+            return { success: false, output: '', error: '缺少参数: oldString' };
+        }
+        if (newString === undefined || newString === null) {
+            return { success: false, output: '', error: '缺少参数: newString' };
+        }
+        if (oldString === '') {
+            return { success: false, output: '', error: 'oldString 不能为空' };
+        }
+        if (oldString === newString) {
+            return { success: false, output: '', error: 'oldString 与 newString 相同，无需替换' };
+        }
+        const resolved = ctx.resolvePath(userPath);
+        const { path: filePath, classification } = resolved;
+        if (!args.__confirmed) {
+            if (classification === 'reject') {
+                return { success: false, output: '', error: `拒绝编辑系统路径: ${userPath}` };
+            }
+            if (classification === 'confirm') {
+                throw new PendingConfirmation('edit', { path: userPath, oldString, newString, replaceAll }, `文件 "${userPath}" 在工作区之外，确认编辑？`);
+            }
+        }
+        try {
+            const raw = await readFile(filePath, 'utf-8');
+            const meta = detectMeta(raw);
+            const content = stripBom(raw);
+            // Strategy 1: exact match on original content
+            let matchCount = countOccurrences(content, oldString);
+            let effectiveOld = oldString;
+            // Strategy 2: line-ending normalized match
+            if (matchCount === 0) {
+                const lfContent = normalizeToLF(content);
+                const lfOld = normalizeToLF(oldString);
+                const lfCount = countOccurrences(lfContent, lfOld);
+                if (lfCount > 0) {
+                    matchCount = lfCount;
+                    effectiveOld = lfOld;
+                    // Apply replacement on LF-normalized content, then restore line endings
+                    const lfNew = normalizeToLF(newString);
+                    let result;
+                    if (replaceAll) {
+                        result = lfContent.split(lfOld).join(lfNew);
+                    }
+                    else {
+                        result = lfContent.replace(lfOld, lfNew);
+                    }
+                    // Re-apply original content's line endings
+                    if (meta.lineEnding === 'CRLF') {
+                        result = result.replace(/\n/g, '\r\n');
+                    }
+                    await atomicWrite(filePath, result, meta);
+                    const actualCount = replaceAll ? matchCount : 1;
+                    return {
+                        success: true,
+                        output: `已编辑: ${userPath}\n替换 ${actualCount} 处:\n${formatDiff(oldString, newString)}`
+                    };
+                }
+            }
+            if (matchCount === 0) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `未在文件中找到 oldString。请确保 oldString 与文件内容完全一致（包括缩进和空行）。\n` +
+                        `文件路径: ${userPath}\n` +
+                        `oldString: ${escapeNewlines(oldString.slice(0, 200))}`
+                };
+            }
+            if (!replaceAll && matchCount > 1) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `oldString 在文件中出现了 ${matchCount} 次。请提供更多上下文使匹配唯一，或设置 replaceAll: true 替换全部。`
+                };
+            }
+            // Strategy 1: exact match, apply directly
+            const result = replaceAll
+                ? content.split(oldString).join(newString)
+                : content.replace(oldString, newString);
+            await atomicWrite(filePath, result, meta);
+            const actualCount = replaceAll ? matchCount : 1;
+            return {
+                success: true,
+                output: `已编辑: ${userPath}\n替换 ${actualCount} 处:\n${formatDiff(oldString, newString)}`
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return { success: false, output: '', error: `文件不存在: ${userPath}` };
+            }
+            if (error instanceof PendingConfirmation)
+                throw error;
+            return { success: false, output: '', error: `编辑失败: ${error.message}` };
+        }
+    }
+};
+//# sourceMappingURL=edit.js.map

package/dist/tool/tools/edit.js.map

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

package/dist/tool/tools/exec.d.ts

@@ -0,0 +1,12 @@
+import type { ToolDef } from '../types.js';
+/**
+ * execute_command — 执行终端命令
+ *
+ * 安全策略：
+ * - 安全命令 + 工作区路径 → 直接执行
+ * - 危险命令 → 需用户确认
+ * - format/diskpart → 拒绝
+ * - 默认超时 5 分钟，输出上限 50KB
+ */
+export declare const execTool: ToolDef;
+//# sourceMappingURL=exec.d.ts.map

package/dist/tool/tools/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AA4BvD;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,OA8ItB,CAAC"}

package/dist/tool/tools/exec.js

@@ -0,0 +1,170 @@
+import { spawn, execSync } from 'node:child_process';
+import { PendingConfirmation } from '../types.js';
+const DEFAULT_TIMEOUT = 300_000;
+const MAX_ALLOWED_TIMEOUT = 3_600_000;
+const MAX_OUTPUT = 50_000;
+const IS_WINDOWS = process.platform === 'win32';
+function killProcessTree(pid) {
+    if (pid == null)
+        return false;
+    if (IS_WINDOWS) {
+        try {
+            execSync(`taskkill /F /T /PID ${pid}`, { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    try {
+        process.kill(pid, 'SIGKILL');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * execute_command — 执行终端命令
+ *
+ * 安全策略：
+ * - 安全命令 + 工作区路径 → 直接执行
+ * - 危险命令 → 需用户确认
+ * - format/diskpart → 拒绝
+ * - 默认超时 5 分钟，输出上限 50KB
+ */
+export const execTool = {
+    name: 'execute_command',
+    description: 'Execute a terminal command in the workspace directory and return output. For development tasks only, non-interactive. Default timeout 5 minutes.',
+    parameters: {
+        type: 'object',
+        properties: {
+            command: {
+                type: 'string',
+                description: 'The terminal command to execute'
+            },
+            timeout: {
+                type: 'number',
+                description: 'Timeout in seconds, default 300 (5 min), max 3600 (1 hour)'
+            }
+        },
+        required: ['command']
+    },
+    async execute(args, ctx) {
+        const command = args.command;
+        if (!command) {
+            return { success: false, output: '', error: '缺少参数: command' };
+        }
+        let timeoutSec = typeof args.timeout === 'number' && args.timeout > 0 ? args.timeout : DEFAULT_TIMEOUT / 1000;
+        if (timeoutSec > MAX_ALLOWED_TIMEOUT / 1000)
+            timeoutSec = MAX_ALLOWED_TIMEOUT / 1000;
+        const timeoutMs = timeoutSec * 1000;
+        const classification = ctx.classifyCommand(command);
+        if (classification === 'reject') {
+            return {
+                success: false,
+                output: '',
+                error: `拒绝执行危险命令: ${command.slice(0, 80)}`
+            };
+        }
+        if (classification === 'confirm' && !args.__confirmed) {
+            throw new PendingConfirmation('execute_command', { ...args }, `需要确认执行命令:\n${command}`);
+        }
+        if (args.__confirmed) {
+            const recheck = ctx.classifyCommand(command);
+            if (recheck === 'reject') {
+                return {
+                    success: false,
+                    output: '',
+                    error: `拒绝执行危险命令: ${command.slice(0, 80)}`
+                };
+            }
+        }
+        return new Promise((resolve) => {
+            const stdoutChunks = [];
+            const stderrChunks = [];
+            let resolved = false;
+            let totalOutput = 0;
+            const resolveResult = (success, error) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timer);
+                const out = Buffer.concat(stdoutChunks).toString();
+                const err = Buffer.concat(stderrChunks).toString();
+                const output = [out, err ? `\n[stderr]\n${err}` : '']
+                    .filter(Boolean)
+                    .join('')
+                    .slice(0, MAX_OUTPUT);
+                resolve({
+                    success,
+                    output: output || '(无输出)',
+                    error
+                });
+            };
+            const timer = setTimeout(() => {
+                if (!resolved) {
+                    if (!killProcessTree(child.pid)) {
+                        try {
+                            child.kill();
+                        }
+                        catch { /* 忽略二次杀死失败 */ }
+                    }
+                    resolveResult(false, `命令执行超时 (${timeoutSec} 秒)`);
+                }
+            }, timeoutMs);
+            const child = spawn(command, [], {
+                cwd: ctx.root,
+                shell: IS_WINDOWS ? 'powershell.exe' : '/bin/bash',
+                stdio: ['ignore', 'pipe', 'pipe']
+            });
+            child.stdout?.on('data', (data) => {
+                stdoutChunks.push(data);
+                totalOutput += data.length;
+                if (totalOutput > MAX_OUTPUT) {
+                    if (!resolved) {
+                        if (!killProcessTree(child.pid)) {
+                            try {
+                                child.kill();
+                            }
+                            catch { /* ignore */ }
+                        }
+                        resolveResult(false, '命令输出超过上限 (50KB)');
+                    }
+                }
+                else {
+                    ctx.onUpdate?.(data.toString());
+                }
+            });
+            child.stderr?.on('data', (data) => {
+                stderrChunks.push(data);
+                totalOutput += data.length;
+                if (totalOutput > MAX_OUTPUT) {
+                    if (!resolved) {
+                        if (!killProcessTree(child.pid)) {
+                            try {
+                                child.kill();
+                            }
+                            catch { /* ignore */ }
+                        }
+                        resolveResult(false, '命令输出超过上限 (50KB)');
+                    }
+                }
+                else {
+                    ctx.onUpdate?.(data.toString());
+                }
+            });
+            child.on('close', (code) => {
+                if (resolved)
+                    return;
+                resolveResult(code === 0, code !== 0 ? `命令退出码: ${code}` : undefined);
+            });
+            child.on('error', (err) => {
+                if (resolved)
+                    return;
+                resolveResult(false, err.message);
+            });
+        });
+    }
+};
+//# sourceMappingURL=exec.js.map

package/dist/tool/tools/exec.js.map

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

package/dist/tool/tools/file-utils.d.ts

@@ -0,0 +1,13 @@
+export type LineEnding = 'LF' | 'CRLF';
+export interface FileMeta {
+    bom: boolean;
+    lineEnding: LineEnding;
+}
+export declare function stripBom(content: string): string;
+export declare function detectLineEnding(content: string): LineEnding;
+export declare function detectMeta(content: string): FileMeta;
+export declare function normalizeLineEndings(content: string, target: LineEnding): string;
+export declare function normalizeToLF(content: string): string;
+export declare function applyMeta(content: string, meta: FileMeta): string;
+export declare function atomicWrite(filePath: string, content: string, meta?: FileMeta): Promise<void>;
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/tool/tools/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/file-utils.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;CACvB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAK5D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAKpD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAKhF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAQjE;AAED,wBAAsB,WAAW,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/tool/tools/file-utils.js

@@ -0,0 +1,65 @@
+import { writeFile, rename, stat, chmod } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { dirname } from 'node:path';
+const BOM = '\uFEFF';
+export function stripBom(content) {
+    if (content.startsWith(BOM)) {
+        return content.slice(1);
+    }
+    return content;
+}
+export function detectLineEnding(content) {
+    if (content.includes('\r\n')) {
+        return 'CRLF';
+    }
+    return 'LF';
+}
+export function detectMeta(content) {
+    return {
+        bom: content.startsWith(BOM),
+        lineEnding: detectLineEnding(content)
+    };
+}
+export function normalizeLineEndings(content, target) {
+    if (target === 'CRLF') {
+        return content.replace(/\r\n/g, '\n').replace(/\n/g, '\r\n');
+    }
+    return content.replace(/\r\n/g, '\n');
+}
+export function normalizeToLF(content) {
+    return content.replace(/\r\n/g, '\n');
+}
+export function applyMeta(content, meta) {
+    let result = normalizeLineEndings(content, meta.lineEnding);
+    if (meta.bom && !result.startsWith(BOM)) {
+        result = BOM + result;
+    }
+    else if (!meta.bom && result.startsWith(BOM)) {
+        result = result.slice(1);
+    }
+    return result;
+}
+export async function atomicWrite(filePath, content, meta) {
+    let finalContent = content;
+    let targetMode = null;
+    try {
+        const info = await stat(filePath);
+        if (info.isFile()) {
+            targetMode = info.mode;
+        }
+    }
+    catch {
+        // new file, no mode to preserve
+    }
+    if (meta) {
+        finalContent = applyMeta(content, meta);
+    }
+    const dir = dirname(filePath);
+    const tmpPath = filePath + '.' + randomUUID() + '.tmp';
+    await writeFile(tmpPath, finalContent, 'utf-8');
+    if (targetMode !== null) {
+        await chmod(tmpPath, targetMode);
+    }
+    await rename(tmpPath, filePath);
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/tool/tools/file-utils.js.map

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

package/dist/tool/tools/read-file.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDef } from '../types.js';
+/**
+ * read_file — 读取文件内容
+ *
+ * 工作区内文件直接读取；工作区外文件需用户确认。
+ * 文件大小限制 1 MB，超限返回错误。
+ * 支持 offset / limit 按行翻页，不指定时默认读前 500 行。
+ */
+export declare const readFileTool: ToolDef;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tool/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/read-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAiBvD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,OA2G1B,CAAC"}

package/dist/tool/tools/read-file.js

@@ -0,0 +1,116 @@
+import { readFile, stat } from 'node:fs/promises';
+import { PendingConfirmation } from '../types.js';
+import { stripBom } from './file-utils.js';
+const MAX_FILE_SIZE = 1024 * 1024;
+const DEFAULT_OFFSET = 1;
+const DEFAULT_LIMIT = 500;
+function validateParam(name, value) {
+    if (value === undefined || value === null)
+        return NaN;
+    const n = Number(value);
+    if (!Number.isInteger(n))
+        return NaN;
+    if (n < 1)
+        return NaN;
+    return n;
+}
+/**
+ * read_file — 读取文件内容
+ *
+ * 工作区内文件直接读取；工作区外文件需用户确认。
+ * 文件大小限制 1 MB，超限返回错误。
+ * 支持 offset / limit 按行翻页，不指定时默认读前 500 行。
+ */
+export const readFileTool = {
+    name: 'read_file',
+    description: 'Read file contents. Supports offset/limit for paginated line-by-line reading. Use for viewing code, config, docs, etc.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'File path (relative to workspace or absolute)'
+            },
+            offset: {
+                type: 'integer',
+                description: 'Starting line number (1-based), default 1'
+            },
+            limit: {
+                type: 'integer',
+                description: 'Max lines to read, default 500'
+            }
+        },
+        required: ['path']
+    },
+    async execute(args, ctx) {
+        const userPath = args.path;
+        if (!userPath) {
+            return { success: false, output: '', error: '缺少参数: path' };
+        }
+        let offset = DEFAULT_OFFSET;
+        let limit = DEFAULT_LIMIT;
+        if ('offset' in args && args.offset !== undefined && args.offset !== null) {
+            const parsed = validateParam('offset', args.offset);
+            if (isNaN(parsed)) {
+                return { success: false, output: '', error: 'offset 必须是大于等于 1 的整数' };
+            }
+            offset = parsed;
+        }
+        if ('limit' in args && args.limit !== undefined && args.limit !== null) {
+            const parsed = validateParam('limit', args.limit);
+            if (isNaN(parsed)) {
+                return { success: false, output: '', error: 'limit 必须是大于等于 1 的整数' };
+            }
+            limit = parsed;
+        }
+        const resolved = ctx.resolvePath(userPath);
+        const { path: filePath, classification } = resolved;
+        if (!args.__confirmed) {
+            if (classification === 'reject') {
+                return { success: false, output: '', error: `拒绝读取系统路径: ${userPath}` };
+            }
+            if (classification === 'confirm') {
+                throw new PendingConfirmation('read_file', { path: userPath, offset, limit }, `文件 "${userPath}" 在工作区之外，确认读取？`);
+            }
+        }
+        try {
+            const info = await stat(filePath);
+            if (!info.isFile()) {
+                return { success: false, output: '', error: `路径不是文件: ${userPath}` };
+            }
+            if (info.size > MAX_FILE_SIZE) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `文件过大 (${(info.size / 1024 / 1024).toFixed(1)} MB)，最大支持 1 MB`
+                };
+            }
+            const rawContent = await readFile(filePath, 'utf-8');
+            const content = stripBom(rawContent);
+            const lines = content.split('\n');
+            const totalLines = lines.length;
+            const startIdx = offset - 1;
+            if (startIdx >= totalLines) {
+                return {
+                    success: true,
+                    output: `=== ${userPath} (第 ${offset}-${offset + limit - 1} 行 / 共 ${totalLines} 行) ===\n\n（起始行号超出文件末尾）`
+                };
+            }
+            const endIdx = Math.min(startIdx + limit, totalLines);
+            const slice = lines.slice(startIdx, endIdx);
+            const atEnd = endIdx >= totalLines;
+            const rangeLabel = `(第 ${offset}-${startIdx + slice.length} 行 / 共 ${totalLines} 行${atEnd ? '，已达文件末尾' : ''})`;
+            return {
+                success: true,
+                output: `=== ${userPath} ${rangeLabel} ===\n${slice.join('\n')}`
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return { success: false, output: '', error: `文件不存在: ${userPath}` };
+            }
+            return { success: false, output: '', error: `读取失败: ${error.message}` };
+        }
+    }
+};
+//# sourceMappingURL=read-file.js.map

package/dist/tool/tools/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../../src/tool/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;AAClC,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,SAAS,aAAa,CAAC,IAAY,EAAE,KAAc;IAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC;IACtD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtB,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAY;IACpC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,wHAAwH;IACrI,UAAU,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,IAAI,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC5D;YACD,MAAM,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,2CAA2C;aACxD;YACD,KAAK,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,gCAAgC;aAC7C;SACD;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KAClB;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,GAAgB;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAC5D,CAAC;QAED,IAAI,MAAM,GAAG,cAAc,CAAC;QAC5B,IAAI,KAAK,GAAG,aAAa,CAAC;QAE1B,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3E,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;YACtE,CAAC;YACD,MAAM,GAAG,MAAM,CAAC;QACjB,CAAC;QAED,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxE,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;YACrE,CAAC;YACD,KAAK,GAAG,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QAEpD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvB,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,QAAQ,EAAE,EAAE,CAAC;YACvE,CAAC;YACD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,IAAI,mBAAmB,CAC5B,WAAW,EACX,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EACjC,OAAO,QAAQ,gBAAgB,CAC/B,CAAC;YACH,CAAC;QACF,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YAElC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,QAAQ,EAAE,EAAE,CAAC;YACrE,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;gBAC/B,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB;iBACpE,CAAC;YACH,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,CAAC;YAE5B,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAC5B,OAAO;oBACN,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,OAAO,QAAQ,OAAO,MAAM,IAAI,MAAM,GAAG,KAAK,GAAG,CAAC,UAAU,UAAU,yBAAyB;iBACvG,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,EAAE,UAAU,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,IAAI,UAAU,CAAC;YACnC,MAAM,UAAU,GAAG,MAAM,MAAM,IAAI,QAAQ,GAAG,KAAK,CAAC,MAAM,UAAU,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YAE7G,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,QAAQ,IAAI,UAAU,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAChE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,QAAQ,EAAE,EAAE,CAAC;YACpE,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAU,KAAe,CAAC,OAAO,EAAE,EAAE,CAAC;QACnF,CAAC;IACF,CAAC;CACD,CAAC"}

package/dist/tool/tools/read-memory.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const readMemoryTool: ToolDef;
+//# sourceMappingURL=read-memory.d.ts.map

package/dist/tool/tools/read-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-memory.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/read-memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAKvD,eAAO,MAAM,cAAc,EAAE,OA0D5B,CAAC"}