aven-ai 0.0.1

package/dist/modules/agent/tools/files/edit-file-operation.js

@@ -0,0 +1,98 @@
+import { dirname } from 'node:path';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { FileToolValidationError } from './file-tool-error.js';
+import { validatedPath } from './file-path-safety.js';
+import { assertFreshRead, assertMutableFile, assertMutationSize, displayPath, fileToolError, MAX_MUTATION_BYTES, occurrences, pathExists, rememberFullFile, throwIfAborted, } from './file-tool-operations.js';
+import { decodeText, encodeText, normalizedContent, withLineEnding } from './text-file-codec.js';
+export const editFileOperation = async (context, input, signal) => {
+    let path = input.file_path;
+    try {
+        path = validatedPath(input.file_path);
+        if (path.toLowerCase().endsWith('.ipynb')) {
+            throw new FileToolValidationError('Notebook files are not supported by Edit.');
+        }
+        if (input.old_string === input.new_string) {
+            throw new FileToolValidationError('old_string and new_string must be different.');
+        }
+        throwIfAborted(signal);
+        const exists = await pathExists(path);
+        if (!exists)
+            return await createWithEdit(context, path, input, signal);
+        const cached = context.cache.get(path);
+        if (!cached)
+            throw new FileToolValidationError('Read the existing file before editing it.');
+        await assertMutableFile(path);
+        const buffer = await readFile(path, { signal });
+        if (buffer.length > MAX_MUTATION_BYTES)
+            throw new FileToolValidationError('The file is too large to edit safely.');
+        const decoded = decodeText(buffer);
+        const before = normalizedContent(decoded.content);
+        await assertFreshRead(path, before, cached);
+        const oldString = normalizedContent(input.old_string);
+        const newString = normalizedContent(input.new_string);
+        if (oldString === newString) {
+            throw new FileToolValidationError('old_string and new_string must be different after line-ending normalization.');
+        }
+        const matchCount = before === '' && oldString === '' ? 1 : occurrences(before, oldString);
+        if (matchCount === 0)
+            throw new FileToolValidationError('old_string was not found in the file.');
+        if (!input.replace_all && matchCount > 1) {
+            throw new FileToolValidationError('old_string is not unique. Provide more context or set replace_all to true.');
+        }
+        const after = oldString === ''
+            ? newString
+            : input.replace_all
+                ? before.split(oldString).join(newString)
+                : before.replace(oldString, newString);
+        throwIfAborted(signal);
+        const encoded = encodeText(withLineEnding(after, decoded.lineEnding), decoded.encoding, decoded.bom);
+        assertMutationSize(encoded);
+        await writeFile(path, encoded, { signal });
+        await rememberFullFile(context, path, after);
+        const operationId = context.mutations.record({ file: path, before, after });
+        const replacements = input.replace_all ? matchCount : 1;
+        return {
+            status: 'success',
+            tool: 'Edit',
+            file_path: displayPath(path),
+            replacements,
+            operation_id: operationId,
+            message: `Replaced ${replacements} occurrence${replacements === 1 ? '' : 's'}.`,
+        };
+    }
+    catch (error) {
+        if (signal.aborted)
+            throw signal.reason ?? error;
+        return fileToolError('Edit', path, error);
+    }
+};
+const createWithEdit = async (context, path, input, signal) => {
+    if (input.old_string !== '') {
+        throw new FileToolValidationError('The file does not exist. Use an empty old_string to create it.');
+    }
+    await mkdir(dirname(path), { recursive: true });
+    throwIfAborted(signal);
+    const encoded = Buffer.from(input.new_string, 'utf8');
+    assertMutationSize(encoded);
+    try {
+        await writeFile(path, encoded, { flag: 'wx', signal });
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            throw new FileToolValidationError('The file changed before Edit could create it. Read it and retry.');
+        }
+        throw error;
+    }
+    const after = normalizedContent(input.new_string);
+    await rememberFullFile(context, path, after);
+    const operationId = context.mutations.record({ file: path, before: '', after });
+    return {
+        status: 'success',
+        tool: 'Edit',
+        file_path: displayPath(path),
+        replacements: 1,
+        operation_id: operationId,
+        message: 'Created file with Edit.',
+    };
+};
+//# sourceMappingURL=edit-file-operation.js.map

package/dist/modules/agent/tools/files/edit-file-operation.js.map

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

package/dist/modules/agent/tools/files/file-path-safety.d.ts

@@ -0,0 +1,2 @@
+export declare const validatedPath: (value: string) => string;
+//# sourceMappingURL=file-path-safety.d.ts.map

package/dist/modules/agent/tools/files/file-path-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-path-safety.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-path-safety.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAI7C,CAAC"}

package/dist/modules/agent/tools/files/file-path-safety.js

@@ -0,0 +1,10 @@
+import { isAbsolute, normalize } from 'node:path';
+import { FileToolValidationError } from './file-tool-error.js';
+export const validatedPath = (value) => {
+    if (/^(?:\\\\|\/\/)/u.test(value))
+        throw new FileToolValidationError('UNC paths are not supported.');
+    if (!isAbsolute(value))
+        throw new FileToolValidationError('file_path must be absolute.');
+    return normalize(value);
+};
+//# sourceMappingURL=file-path-safety.js.map

package/dist/modules/agent/tools/files/file-path-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-path-safety.js","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-path-safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,SAAS,EAAC,MAAM,WAAW,CAAC;AAChD,OAAO,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAE7D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IACtD,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,8BAA8B,CAAC,CAAC;IACrG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,6BAA6B,CAAC,CAAC;IACzF,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC,CAAC"}

package/dist/modules/agent/tools/files/file-state-cache.d.ts

@@ -0,0 +1,21 @@
+export type FileReadState = {
+    content: string;
+    fingerprint: string;
+    timestamp: number;
+    offset?: number;
+    limit?: number;
+    isPartialView?: boolean;
+    totalLines: number;
+    readLines: number;
+};
+export declare class FileStateCache {
+    #private;
+    constructor(maxEntries?: number, maxBytes?: number);
+    get(path: string): FileReadState | undefined;
+    peek(path: string): FileReadState | undefined;
+    set(path: string, state: FileReadState): void;
+    clear(): void;
+    get size(): number;
+    get byteSize(): number;
+}
+//# sourceMappingURL=file-state-cache.d.ts.map

package/dist/modules/agent/tools/files/file-state-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-state-cache.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-state-cache.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAOF,qBAAa,cAAc;;IAM1B,YAAY,UAAU,SAAM,EAAE,QAAQ,SAAmB,EAGxD;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAM3C;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE5C;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAW5C;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;CAUD"}

package/dist/modules/agent/tools/files/file-state-cache.js

@@ -0,0 +1,54 @@
+export class FileStateCache {
+    #maxEntries;
+    #maxBytes;
+    #entries = new Map();
+    #bytes = 0;
+    constructor(maxEntries = 100, maxBytes = 25 * 1024 * 1024) {
+        this.#maxEntries = maxEntries;
+        this.#maxBytes = maxBytes;
+    }
+    get(path) {
+        const entry = this.#entries.get(path);
+        if (!entry)
+            return undefined;
+        this.#entries.delete(path);
+        this.#entries.set(path, entry);
+        return entry.state;
+    }
+    peek(path) {
+        return this.#entries.get(path)?.state;
+    }
+    set(path, state) {
+        const existing = this.#entries.get(path);
+        if (existing) {
+            this.#bytes -= existing.bytes;
+            this.#entries.delete(path);
+        }
+        const bytes = Buffer.byteLength(state.content);
+        if (bytes > this.#maxBytes || this.#maxEntries === 0)
+            return;
+        this.#entries.set(path, { state, bytes });
+        this.#bytes += bytes;
+        this.#evict();
+    }
+    clear() {
+        this.#entries.clear();
+        this.#bytes = 0;
+    }
+    get size() {
+        return this.#entries.size;
+    }
+    get byteSize() {
+        return this.#bytes;
+    }
+    #evict() {
+        while (this.#entries.size > this.#maxEntries || this.#bytes > this.#maxBytes) {
+            const oldest = this.#entries.entries().next().value;
+            if (!oldest)
+                return;
+            this.#entries.delete(oldest[0]);
+            this.#bytes -= oldest[1].bytes;
+        }
+    }
+}
+//# sourceMappingURL=file-state-cache.js.map

package/dist/modules/agent/tools/files/file-state-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-state-cache.js","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-state-cache.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,cAAc;IACjB,WAAW,CAAS;IACpB,SAAS,CAAS;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAClD,MAAM,GAAG,CAAC,CAAC;IAEX,YAAY,UAAU,GAAG,GAAG,EAAE,QAAQ,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;QACxD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,IAAY;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,KAAoB;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC;YAAE,OAAO;QAC7D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,MAAM;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAyC,CAAC;YACxF,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAChC,CAAC;IACF,CAAC;CACD"}

package/dist/modules/agent/tools/files/file-tool-error.d.ts

@@ -0,0 +1,3 @@
+export declare class FileToolValidationError extends Error {
+}
+//# sourceMappingURL=file-tool-error.d.ts.map

package/dist/modules/agent/tools/files/file-tool-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tool-error.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-tool-error.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAwB,SAAQ,KAAK;CAAG"}

package/dist/modules/agent/tools/files/file-tool-error.js

@@ -0,0 +1,3 @@
+export class FileToolValidationError extends Error {
+}
+//# sourceMappingURL=file-tool-error.js.map

package/dist/modules/agent/tools/files/file-tool-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tool-error.js","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-tool-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;CAAG"}

package/dist/modules/agent/tools/files/file-tool-operations.d.ts

@@ -0,0 +1,22 @@
+import type { EditResult, ReadResult, WriteResult } from './contracts.js';
+import type { FileReadState, FileStateCache } from './file-state-cache.js';
+import type { MutationJournal } from './mutation-journal.js';
+export declare const DEFAULT_READ_LIMIT = 2000;
+export declare const MAX_READ_BYTES: number;
+export declare const MAX_MODEL_CONTENT = 100000;
+export declare const MAX_MUTATION_BYTES: number;
+export type FileToolContext = {
+    cache: FileStateCache;
+    mutations: MutationJournal;
+};
+export declare const contentFingerprint: (content: string) => string;
+export declare const displayPath: (path: string) => string;
+export declare const throwIfAborted: (signal: AbortSignal) => void;
+export declare const fileToolError: (tool: 'Read' | 'Edit' | 'Write', path: string, error: unknown) => ReadResult | EditResult | WriteResult;
+export declare const pathExists: (path: string) => Promise<boolean>;
+export declare const assertMutableFile: (path: string) => Promise<void>;
+export declare const assertFreshRead: (path: string, currentContent: string, cached: FileReadState) => Promise<void>;
+export declare const rememberFullFile: (context: FileToolContext, path: string, content: string) => Promise<void>;
+export declare const assertMutationSize: (buffer: Buffer) => void;
+export declare const occurrences: (content: string, search: string) => number;
+//# sourceMappingURL=file-tool-operations.d.ts.map

package/dist/modules/agent/tools/files/file-tool-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tool-operations.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-tool-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAExE,OAAO,KAAK,EAAC,aAAa,EAAE,cAAc,EAAC,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AACxC,eAAO,MAAM,cAAc,QAAa,CAAC;AACzC,eAAO,MAAM,iBAAiB,SAAU,CAAC;AACzC,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,MAAM,KAAG,MAA4D,CAAC;AAElH,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,MAAc,CAAC;AAE1D,eAAO,MAAM,cAAc,WAAY,WAAW,KAAG,IAEpD,CAAC;AAEF,eAAO,MAAM,aAAa,SACnB,MAAM,GAAG,MAAM,GAAG,OAAO,QACzB,MAAM,SACL,OAAO,KACZ,UAAU,GAAG,UAAU,GAAG,WAK3B,CAAC;AAEH,eAAO,MAAM,UAAU,SAAgB,MAAM,KAAG,OAAO,CAAC,OAAO,CAQ9D,CAAC;AAEF,eAAO,MAAM,iBAAiB,SAAgB,MAAM,KAAG,OAAO,CAAC,IAAI,CAKlE,CAAC;AAEF,eAAO,MAAM,eAAe,SAAgB,MAAM,kBAAkB,MAAM,UAAU,aAAa,KAAG,OAAO,CAAC,IAAI,CAQ/G,CAAC;AAEF,eAAO,MAAM,gBAAgB,YAAmB,eAAe,QAAQ,MAAM,WAAW,MAAM,KAAG,OAAO,CAAC,IAAI,CAU5G,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAY,MAAM,KAAG,IAMnD,CAAC;AAEF,eAAO,MAAM,WAAW,YAAa,MAAM,UAAU,MAAM,KAAG,MAS7D,CAAC"}

package/dist/modules/agent/tools/files/file-tool-operations.js

@@ -0,0 +1,73 @@
+import { createHash } from 'node:crypto';
+import { lstat, stat } from 'node:fs/promises';
+import { FileToolValidationError } from './file-tool-error.js';
+export const DEFAULT_READ_LIMIT = 2_000;
+export const MAX_READ_BYTES = 256 * 1024;
+export const MAX_MODEL_CONTENT = 100_000;
+export const MAX_MUTATION_BYTES = 16 * 1024 * 1024;
+export const contentFingerprint = (content) => createHash('sha256').update(content).digest('hex');
+export const displayPath = (path) => path;
+export const throwIfAborted = (signal) => {
+    if (signal.aborted)
+        throw signal.reason ?? new Error('Aborted');
+};
+export const fileToolError = (tool, path, error) => ({
+    status: 'error',
+    tool,
+    file_path: displayPath(path),
+    error: error instanceof Error ? error.message : String(error),
+});
+export const pathExists = async (path) => {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+};
+export const assertMutableFile = async (path) => {
+    const metadata = await lstat(path);
+    if (!metadata.isFile() && !metadata.isSymbolicLink()) {
+        throw new FileToolValidationError('The path must point to a regular file.');
+    }
+};
+export const assertFreshRead = async (path, currentContent, cached) => {
+    const timestamp = Math.floor((await stat(path)).mtimeMs);
+    if (contentFingerprint(currentContent) !== cached.fingerprint) {
+        throw new FileToolValidationError('The file changed since it was read. Read it again before editing or writing.');
+    }
+    if (timestamp > cached.timestamp && cached.isPartialView) {
+        throw new FileToolValidationError('The file changed since it was read. Read it again before editing or writing.');
+    }
+};
+export const rememberFullFile = async (context, path, content) => {
+    const metadata = await stat(path);
+    const lineCount = content.split('\n').length;
+    context.cache.set(path, {
+        content,
+        fingerprint: contentFingerprint(content),
+        timestamp: Math.floor(metadata.mtimeMs),
+        totalLines: lineCount,
+        readLines: lineCount,
+    });
+};
+export const assertMutationSize = (buffer) => {
+    if (buffer.length > MAX_MUTATION_BYTES) {
+        throw new FileToolValidationError(`The resulting file exceeds the ${MAX_MUTATION_BYTES / 1024 / 1024} MiB mutation limit.`);
+    }
+};
+export const occurrences = (content, search) => {
+    if (search === '')
+        return 0;
+    let count = 0;
+    let index = 0;
+    while ((index = content.indexOf(search, index)) !== -1) {
+        count += 1;
+        index += search.length;
+    }
+    return count;
+};
+//# sourceMappingURL=file-tool-operations.js.map

package/dist/modules/agent/tools/files/file-tool-operations.js.map

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

package/dist/modules/agent/tools/files/file-tool-service.d.ts

@@ -0,0 +1,14 @@
+import type { EditInput, EditResult, ReadInput, ReadResult, WriteInput, WriteResult } from './contracts.js';
+import { FileStateCache } from './file-state-cache.js';
+import { MutationJournal, type FileMutation } from './mutation-journal.js';
+export type { FileMutation } from './mutation-journal.js';
+export declare class FileToolService {
+    #private;
+    constructor(cache?: FileStateCache, mutations?: MutationJournal);
+    read(input: ReadInput, signal: AbortSignal): Promise<ReadResult>;
+    edit(input: EditInput, signal: AbortSignal): Promise<EditResult>;
+    write(input: WriteInput, signal: AbortSignal): Promise<WriteResult>;
+    takeMutation(operationId: string): FileMutation | undefined;
+    clear(): void;
+}
+//# sourceMappingURL=file-tool-service.d.ts.map

package/dist/modules/agent/tools/files/file-tool-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tool-service.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-tool-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAE1G,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAC,eAAe,EAAE,KAAK,YAAY,EAAC,MAAM,uBAAuB,CAAC;AAIzE,YAAY,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AAExD,qBAAa,eAAe;;IAG3B,YAAY,KAAK,iBAAuB,EAAE,SAAS,kBAAwB,EAE1E;IAED,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAE/D;IAED,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAE/D;IAED,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAElE;IAED,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1D;IAED,KAAK,IAAI,IAAI,CAGZ;CACD"}

package/dist/modules/agent/tools/files/file-tool-service.js

@@ -0,0 +1,28 @@
+import { editFileOperation } from './edit-file-operation.js';
+import { FileStateCache } from './file-state-cache.js';
+import { MutationJournal } from './mutation-journal.js';
+import { readFileOperation } from './read-file-operation.js';
+import { writeFileOperation } from './write-file-operation.js';
+export class FileToolService {
+    #context;
+    constructor(cache = new FileStateCache(), mutations = new MutationJournal()) {
+        this.#context = { cache, mutations };
+    }
+    read(input, signal) {
+        return readFileOperation(this.#context, input, signal);
+    }
+    edit(input, signal) {
+        return editFileOperation(this.#context, input, signal);
+    }
+    write(input, signal) {
+        return writeFileOperation(this.#context, input, signal);
+    }
+    takeMutation(operationId) {
+        return this.#context.mutations.take(operationId);
+    }
+    clear() {
+        this.#context.cache.clear();
+        this.#context.mutations.clear();
+    }
+}
+//# sourceMappingURL=file-tool-service.js.map

package/dist/modules/agent/tools/files/file-tool-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tool-service.js","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/file-tool-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAC,eAAe,EAAoB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAC,kBAAkB,EAAC,MAAM,2BAA2B,CAAC;AAI7D,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAkB;IAEnC,YAAY,KAAK,GAAG,IAAI,cAAc,EAAE,EAAE,SAAS,GAAG,IAAI,eAAe,EAAE;QAC1E,IAAI,CAAC,QAAQ,GAAG,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,KAAgB,EAAE,MAAmB;QACzC,OAAO,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,KAAgB,EAAE,MAAmB;QACzC,OAAO,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,KAAiB,EAAE,MAAmB;QAC3C,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,YAAY,CAAC,WAAmB;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;CACD"}

package/dist/modules/agent/tools/files/mutation-journal.d.ts

@@ -0,0 +1,12 @@
+export type FileMutation = {
+    file: string;
+    before: string;
+    after: string;
+};
+export declare class MutationJournal {
+    #private;
+    record(mutation: FileMutation): string;
+    take(operationId: string): FileMutation | undefined;
+    clear(): void;
+}
+//# sourceMappingURL=mutation-journal.d.ts.map

package/dist/modules/agent/tools/files/mutation-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-journal.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/mutation-journal.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAAa,eAAe;;IAG3B,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CASrC;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAIlD;IAED,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/dist/modules/agent/tools/files/mutation-journal.js

@@ -0,0 +1,25 @@
+import { randomUUID } from 'node:crypto';
+const MAX_MUTATIONS = 100;
+export class MutationJournal {
+    #mutations = new Map();
+    record(mutation) {
+        const operationId = randomUUID();
+        this.#mutations.set(operationId, mutation);
+        while (this.#mutations.size > MAX_MUTATIONS) {
+            const oldest = this.#mutations.keys().next().value;
+            if (!oldest)
+                break;
+            this.#mutations.delete(oldest);
+        }
+        return operationId;
+    }
+    take(operationId) {
+        const mutation = this.#mutations.get(operationId);
+        this.#mutations.delete(operationId);
+        return mutation;
+    }
+    clear() {
+        this.#mutations.clear();
+    }
+}
+//# sourceMappingURL=mutation-journal.js.map

package/dist/modules/agent/tools/files/mutation-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-journal.js","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/mutation-journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAEvC,MAAM,aAAa,GAAG,GAAG,CAAC;AAQ1B,MAAM,OAAO,eAAe;IAClB,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEtD,MAAM,CAAC,QAAsB;QAC5B,MAAM,WAAW,GAAG,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAA2B,CAAC;YACzE,IAAI,CAAC,MAAM;gBAAE,MAAM;YACnB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,WAAW,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,WAAmB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACD"}

package/dist/modules/agent/tools/files/read-file-operation.d.ts

@@ -0,0 +1,4 @@
+import type { ReadInput, ReadResult } from './contracts.js';
+import { type FileToolContext } from './file-tool-operations.js';
+export declare const readFileOperation: (context: FileToolContext, input: ReadInput, signal: AbortSignal) => Promise<ReadResult>;
+//# sourceMappingURL=read-file-operation.d.ts.map

package/dist/modules/agent/tools/files/read-file-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file-operation.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/read-file-operation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAI1D,OAAO,EAKN,KAAK,eAAe,EAIpB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,iBAAiB,YACpB,eAAe,SACjB,SAAS,UACR,WAAW,KACjB,OAAO,CAAC,UAAU,CAoFpB,CAAC"}

package/dist/modules/agent/tools/files/read-file-operation.js

@@ -0,0 +1,92 @@
+import { readFile, stat } from 'node:fs/promises';
+import { decodeText, normalizedContent } from './text-file-codec.js';
+import { FileToolValidationError } from './file-tool-error.js';
+import { validatedPath } from './file-path-safety.js';
+import { contentFingerprint, DEFAULT_READ_LIMIT, displayPath, fileToolError, MAX_MODEL_CONTENT, MAX_READ_BYTES, throwIfAborted, } from './file-tool-operations.js';
+export const readFileOperation = async (context, input, signal) => {
+    let path = input.file_path;
+    try {
+        path = validatedPath(input.file_path);
+        throwIfAborted(signal);
+        const metadata = await stat(path);
+        if (!metadata.isFile())
+            throw new FileToolValidationError('The path must point to a regular file.');
+        if (metadata.size > MAX_READ_BYTES) {
+            throw new FileToolValidationError(`The file exceeds the ${MAX_READ_BYTES / 1024} KiB Read limit.`);
+        }
+        const decoded = decodeText(await readFile(path, { signal }));
+        throwIfAborted(signal);
+        const normalized = normalizedContent(decoded.content);
+        const fingerprint = contentFingerprint(normalized);
+        const startLine = input.offset ?? 1;
+        const limit = input.limit ?? DEFAULT_READ_LIMIT;
+        const timestamp = Math.floor((await stat(path)).mtimeMs);
+        const cached = context.cache.peek(path);
+        if (cached &&
+            cached.timestamp === timestamp &&
+            cached.fingerprint === fingerprint &&
+            cached.offset === input.offset &&
+            cached.limit === input.limit) {
+            return {
+                status: 'unchanged',
+                tool: 'Read',
+                file_path: displayPath(path),
+                start_line: startLine,
+                num_lines: cached.readLines,
+                total_lines: cached.totalLines,
+                message: 'File contents are unchanged since the previous read of this range.',
+            };
+        }
+        const lines = normalized.split('\n');
+        const selected = lines.slice(startLine - 1, startLine - 1 + limit);
+        const formatted = [];
+        const cachedLines = [];
+        let characters = 0;
+        let outputCapped = false;
+        for (const [index, line] of selected.entries()) {
+            const outputLine = `${startLine + index}\t${line}`;
+            const addition = outputLine.length + (formatted.length === 0 ? 0 : 1);
+            if (characters + addition > MAX_MODEL_CONTENT) {
+                outputCapped = true;
+                break;
+            }
+            formatted.push(outputLine);
+            cachedLines.push(line);
+            characters += addition;
+        }
+        if (selected.length > 0 && formatted.length === 0) {
+            const prefix = `${startLine}\t`;
+            const visible = selected[0]?.slice(0, Math.max(0, MAX_MODEL_CONTENT - prefix.length)) ?? '';
+            formatted.push(prefix + visible);
+            cachedLines.push(visible);
+            outputCapped = visible.length < (selected[0]?.length ?? 0);
+        }
+        const isPartialView = outputCapped || startLine !== 1 || cachedLines.length < lines.length;
+        context.cache.set(path, {
+            content: isPartialView ? cachedLines.join('\n') : normalized,
+            fingerprint,
+            timestamp,
+            ...(input.offset === undefined ? {} : { offset: input.offset }),
+            ...(input.limit === undefined ? {} : { limit: input.limit }),
+            ...(isPartialView ? { isPartialView: true } : {}),
+            totalLines: lines.length,
+            readLines: cachedLines.length,
+        });
+        return {
+            status: 'success',
+            tool: 'Read',
+            file_path: displayPath(path),
+            content: formatted.join('\n'),
+            start_line: startLine,
+            num_lines: cachedLines.length,
+            total_lines: lines.length,
+            truncated: outputCapped,
+        };
+    }
+    catch (error) {
+        if (signal.aborted)
+            throw signal.reason ?? error;
+        return fileToolError('Read', path, error);
+    }
+};
+//# sourceMappingURL=read-file-operation.js.map

package/dist/modules/agent/tools/files/read-file-operation.js.map

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

package/dist/modules/agent/tools/files/text-file-codec.d.ts

@@ -0,0 +1,13 @@
+export type TextEncoding = 'utf8' | 'utf16le';
+export type LineEnding = '\n' | '\r\n' | '\r';
+export type DecodedFile = {
+    content: string;
+    encoding: TextEncoding;
+    bom: boolean;
+    lineEnding: LineEnding;
+};
+export declare const normalizedContent: (content: string) => string;
+export declare const decodeText: (buffer: Buffer) => DecodedFile;
+export declare const encodeText: (content: string, encoding: TextEncoding, bom: boolean) => Buffer;
+export declare const withLineEnding: (content: string, lineEnding: LineEnding) => string;
+//# sourceMappingURL=text-file-codec.d.ts.map

package/dist/modules/agent/tools/files/text-file-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-file-codec.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/text-file-codec.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,YAAa,MAAM,KAAG,MAA0C,CAAC;AAQ/F,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,WAuB3C,CAAC;AAEF,eAAO,MAAM,UAAU,YAAa,MAAM,YAAY,YAAY,OAAO,OAAO,KAAG,MAKlF,CAAC;AAEF,eAAO,MAAM,cAAc,YAAa,MAAM,cAAc,UAAU,KAAG,MACL,CAAC"}

package/dist/modules/agent/tools/files/text-file-codec.js

@@ -0,0 +1,45 @@
+import { FileToolValidationError } from './file-tool-error.js';
+export const normalizedContent = (content) => content.replace(/\r\n?/gu, '\n');
+const lineEndingOf = (content) => {
+    if (content.includes('\r\n'))
+        return '\r\n';
+    if (content.includes('\r'))
+        return '\r';
+    return '\n';
+};
+export const decodeText = (buffer) => {
+    let encoding = 'utf8';
+    let bom = false;
+    let body = buffer;
+    if (buffer.length >= 2 && buffer[0] === 0xff && buffer[1] === 0xfe) {
+        encoding = 'utf16le';
+        bom = true;
+        body = buffer.subarray(2);
+        if (body.length % 2 !== 0)
+            throw new FileToolValidationError('The file is not valid UTF-16LE text.');
+    }
+    else if (buffer.length >= 3 && buffer[0] === 0xef && buffer[1] === 0xbb && buffer[2] === 0xbf) {
+        bom = true;
+        body = buffer.subarray(3);
+    }
+    if (encoding === 'utf8' && body.includes(0)) {
+        throw new FileToolValidationError('Binary files are not supported.');
+    }
+    let content;
+    try {
+        content = new TextDecoder(encoding === 'utf8' ? 'utf-8' : 'utf-16le', { fatal: true }).decode(body);
+    }
+    catch {
+        throw new FileToolValidationError(`The file is not valid ${encoding === 'utf8' ? 'UTF-8' : 'UTF-16LE'} text.`);
+    }
+    return { content, encoding, bom, lineEnding: lineEndingOf(content) };
+};
+export const encodeText = (content, encoding, bom) => {
+    const body = Buffer.from(content, encoding);
+    if (!bom)
+        return body;
+    const marker = encoding === 'utf16le' ? Buffer.from([0xff, 0xfe]) : Buffer.from([0xef, 0xbb, 0xbf]);
+    return Buffer.concat([marker, body]);
+};
+export const withLineEnding = (content, lineEnding) => lineEnding === '\n' ? content : content.replace(/\n/gu, lineEnding);
+//# sourceMappingURL=text-file-codec.js.map