@johannes.latzel/llm-chat-file 0.1.1 → 0.2.0

package/README.md

@@ -8,6 +8,7 @@
 [![codecov](https://codecov.io/gh/johanneslatzel/llm-chat-file/graph/badge.svg)](https://codecov.io/gh/johanneslatzel/llm-chat-file)
 [![CI](https://github.com/johanneslatzel/llm-chat-file/actions/workflows/ci.yml/badge.svg)](https://github.com/johanneslatzel/llm-chat-file/actions/workflows/ci.yml)
 [![Socket Badge](https://badge.socket.dev/npm/package/@johannes.latzel/llm-chat-file/latest)](https://badge.socket.dev/npm/package/@johannes.latzel/llm-chat-file/latest)
+[![AI Assisted Yes](https://img.shields.io/badge/AI%20Assisted-Yes-green)](https://github.com/mefengl/made-by-ai)
 
 Filesystem tools for the llm-chat package 
 

package/dist/index.d.ts

@@ -12,4 +12,8 @@ export { MoveFileTool } from './tools/move-file.js';
 export { SwitchWorkspaceTool } from './tools/switch-workspace.js';
 export { FileAccessInfoTool } from './tools/file-access-info.js';
 export { EntryInfoTool } from './tools/entry-info.js';
+export { ReplaceFileLinesTool } from './tools/replace-file-lines.js';
+export { InsertFileContentTool } from './tools/insert-file-content.js';
+export { ReplaceFileContentTool } from './tools/replace-file-content.js';
+export { FileToolPackage } from './packages/tool-package.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -11,4 +11,8 @@ export { MoveFileTool } from './tools/move-file.js';
 export { SwitchWorkspaceTool } from './tools/switch-workspace.js';
 export { FileAccessInfoTool } from './tools/file-access-info.js';
 export { EntryInfoTool } from './tools/entry-info.js';
+export { ReplaceFileLinesTool } from './tools/replace-file-lines.js';
+export { InsertFileContentTool } from './tools/insert-file-content.js';
+export { ReplaceFileContentTool } from './tools/replace-file-content.js';
+export { FileToolPackage } from './packages/tool-package.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/lib/config.d.ts

@@ -80,10 +80,17 @@ export declare class FileConfiguration {
      * Falls back to the `LLM_CHAT_FS_MAX_FILE_SIZE` environment variable, or `10485760` (10 MB) if not set.
      */
     maxFileSize: number;
+    /**
+     * When `true`, write/edit tools require the file to have been read via `read_file`
+     * before modifications are allowed. Falls back to the `LLM_CHAT_FS_REQUIRE_READ_BEFORE_WRITE`
+     * environment variable, or `false` if not set.
+     */
+    requireReadBeforeWrite: boolean;
     /**
      * @param maxCharsPerFile - Maximum chars. Defaults to env `LLM_CHAT_FS_MAX_CHARS_PER_FILE` or `10000`.
      * @param maxFileSize - Maximum file size in bytes. Defaults to env `LLM_CHAT_FS_MAX_FILE_SIZE` or `10485760` (10 MB).
+     * @param requireReadBeforeWrite - Require read before write. Defaults to env `LLM_CHAT_FS_REQUIRE_READ_BEFORE_WRITE` or `true`.
      */
-    constructor(maxCharsPerFile?: number, maxFileSize?: number);
+    constructor(maxCharsPerFile?: number, maxFileSize?: number, requireReadBeforeWrite?: boolean);
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,sGAAsG;AACtG,qBAAa,mBAAmB;IAC5B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;gBAEC,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,SAAS,CAAC,EAAE,MAAM;CAUzB;AAED,gGAAgG;AAChG,qBAAa,sBAAsB;IAC/B,+DAA+D;IAC/D,QAAQ,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE/C,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC;;;;;;;;;OASG;gBAEC,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,EAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,eAAe,CAAC,EAAE,OAAO,EACzB,aAAa,CAAC,EAAE,MAAM;IA8B1B;;;;;OAKG;IACH,WAAW,IAAI,sBAAsB;CAgBxC;AAED,6EAA6E;AAC7E,qBAAa,iBAAiB;IAC1B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;gBACS,eAAe,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAM7D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,sGAAsG;AACtG,qBAAa,mBAAmB;IAC5B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;gBAEC,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,SAAS,CAAC,EAAE,MAAM;CAUzB;AAED,gGAAgG;AAChG,qBAAa,sBAAsB;IAC/B,+DAA+D;IAC/D,QAAQ,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE/C,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC;;;;;;;;;OASG;gBAEC,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,EAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,eAAe,CAAC,EAAE,OAAO,EACzB,aAAa,CAAC,EAAE,MAAM;IA8B1B;;;;;OAKG;IACH,WAAW,IAAI,sBAAsB;CAgBxC;AAED,6EAA6E;AAC7E,qBAAa,iBAAiB;IAC1B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;gBACS,eAAe,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,OAAO;CAQ/F"}

package/dist/lib/config.js

@@ -120,15 +120,24 @@ export class FileConfiguration {
      * Falls back to the `LLM_CHAT_FS_MAX_FILE_SIZE` environment variable, or `10485760` (10 MB) if not set.
      */
     maxFileSize;
+    /**
+     * When `true`, write/edit tools require the file to have been read via `read_file`
+     * before modifications are allowed. Falls back to the `LLM_CHAT_FS_REQUIRE_READ_BEFORE_WRITE`
+     * environment variable, or `false` if not set.
+     */
+    requireReadBeforeWrite;
     /**
      * @param maxCharsPerFile - Maximum chars. Defaults to env `LLM_CHAT_FS_MAX_CHARS_PER_FILE` or `10000`.
      * @param maxFileSize - Maximum file size in bytes. Defaults to env `LLM_CHAT_FS_MAX_FILE_SIZE` or `10485760` (10 MB).
+     * @param requireReadBeforeWrite - Require read before write. Defaults to env `LLM_CHAT_FS_REQUIRE_READ_BEFORE_WRITE` or `true`.
      */
-    constructor(maxCharsPerFile, maxFileSize) {
+    constructor(maxCharsPerFile, maxFileSize, requireReadBeforeWrite) {
         this.maxCharsPerFile =
             maxCharsPerFile ?? parseEnvInt('LLM_CHAT_FS_MAX_CHARS_PER_FILE', 10000);
         this.maxFileSize =
             maxFileSize ?? parseEnvInt('LLM_CHAT_FS_MAX_FILE_SIZE', 10 * 1024 * 1024);
+        this.requireReadBeforeWrite =
+            requireReadBeforeWrite ?? parseEnvBool('LLM_CHAT_FS_REQUIRE_READ_BEFORE_WRITE', true);
     }
 }
 function parseEnvInt(key, fallback, min = 1) {

package/dist/lib/config.js.map

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

package/dist/lib/file-pool.d.ts

@@ -0,0 +1,48 @@
+import { type PartialToolResult } from '@johannes.latzel/llm-chat';
+import { FileConfiguration } from './config.js';
+/**
+ * Tracks file reads and writes to enforce a "require read before write" policy.
+ *
+ * When enabled via {@link FileConfiguration.requireReadBeforeWrite}, files must be
+ * read before they can be modified. A write also counts as a read, so the sequence
+ * read -> write -> write is allowed. This ensures the tool knows the current file
+ * content before applying edits.
+ */
+export declare class FilePool {
+    private mutex;
+    private _timestamps;
+    private fc;
+    /**
+     * @param fileConfig - Configuration that controls whether the read-before-write
+     *   check is enabled.
+     */
+    constructor(fileConfig: FileConfiguration);
+    /**
+     * Records that a file was read at the current time.
+     * This timestamp is later checked by {@link verifyWrite} to detect concurrent
+     * modifications.
+     *
+     * @param resolved - The resolved absolute path to the file.
+     */
+    recordRead(resolved: string): Promise<void>;
+    /**
+     * Verifies that a file is safe to write: it must have been read after the last
+     * on-disk modification, or (if {@link allowNew} is true) must not exist yet.
+     *
+     * @param resolved - The resolved absolute path to the file.
+     * @param allowNew - When true, allows writing to a path that has no read
+     *   timestamp as long as the path does not currently exist.
+     * @returns An error {@link PartialToolResult} if the write should be blocked,
+     *   or `null` if the write is allowed.
+     */
+    verifyWrite(resolved: string, allowNew?: boolean): Promise<PartialToolResult | null>;
+    /**
+     * Records that a file was written at the current time.
+     * A write also counts as a read, so subsequent writes are allowed without
+     * an intervening read_file call.
+     *
+     * @param resolved - The resolved absolute path to the file.
+     */
+    recordWrite(resolved: string): Promise<void>;
+}
+//# sourceMappingURL=file-pool.d.ts.map

package/dist/lib/file-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-pool.d.ts","sourceRoot":"","sources":["../../src/lib/file-pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,EAAE,CAAoB;IAE9B;;;OAGG;gBACS,UAAU,EAAE,iBAAiB;IAIzC;;;;;;OAMG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD;;;;;;;;;OASG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAmCxF;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASrD"}

package/dist/lib/file-pool.js

@@ -0,0 +1,105 @@
+import { Mutex } from 'async-mutex';
+import { ResultStatus } from '@johannes.latzel/llm-chat';
+import * as fsp from 'node:fs/promises';
+/**
+ * Tracks file reads and writes to enforce a "require read before write" policy.
+ *
+ * When enabled via {@link FileConfiguration.requireReadBeforeWrite}, files must be
+ * read before they can be modified. A write also counts as a read, so the sequence
+ * read -> write -> write is allowed. This ensures the tool knows the current file
+ * content before applying edits.
+ */
+export class FilePool {
+    mutex = new Mutex();
+    _timestamps = new Map();
+    fc;
+    /**
+     * @param fileConfig - Configuration that controls whether the read-before-write
+     *   check is enabled.
+     */
+    constructor(fileConfig) {
+        this.fc = fileConfig;
+    }
+    /**
+     * Records that a file was read at the current time.
+     * This timestamp is later checked by {@link verifyWrite} to detect concurrent
+     * modifications.
+     *
+     * @param resolved - The resolved absolute path to the file.
+     */
+    async recordRead(resolved) {
+        if (!this.fc.requireReadBeforeWrite)
+            return;
+        await this.mutex.runExclusive(() => {
+            // +1 provides a 1ms buffer so that filesystem mtime (which may have
+            // sub-ms precision) does not trigger a false "changed since last read"
+            // when the read and a subsequent write fall within the same clock tick.
+            this._timestamps.set(resolved, Date.now() + 1);
+        });
+    }
+    /**
+     * Verifies that a file is safe to write: it must have been read after the last
+     * on-disk modification, or (if {@link allowNew} is true) must not exist yet.
+     *
+     * @param resolved - The resolved absolute path to the file.
+     * @param allowNew - When true, allows writing to a path that has no read
+     *   timestamp as long as the path does not currently exist.
+     * @returns An error {@link PartialToolResult} if the write should be blocked,
+     *   or `null` if the write is allowed.
+     */
+    async verifyWrite(resolved, allowNew = false) {
+        if (!this.fc.requireReadBeforeWrite)
+            return null;
+        return this.mutex.runExclusive(async () => {
+            const lastRead = this._timestamps.get(resolved);
+            if (lastRead === undefined) {
+                if (allowNew) {
+                    try {
+                        await fsp.stat(resolved);
+                    }
+                    catch {
+                        return null;
+                    }
+                }
+                return {
+                    result: `File must be read before writing: ${resolved}`,
+                    status: ResultStatus.Error
+                };
+            }
+            try {
+                const st = await fsp.stat(resolved);
+                if (st.mtime.getTime() > lastRead) {
+                    return {
+                        result: `File has changed since last read: ${resolved}`,
+                        status: ResultStatus.Error
+                    };
+                }
+            }
+            catch {
+                return {
+                    result: `File must be read before writing: ${resolved}`,
+                    status: ResultStatus.Error
+                };
+            }
+            return null;
+        });
+    }
+    /**
+     * Records that a file was written at the current time.
+     * A write also counts as a read, so subsequent writes are allowed without
+     * an intervening read_file call.
+     *
+     * @param resolved - The resolved absolute path to the file.
+     */
+    async recordWrite(resolved) {
+        if (!this.fc.requireReadBeforeWrite)
+            return;
+        await this.mutex.runExclusive(() => {
+            // Same +1 buffer as recordRead — ensures a write that lands in the same
+            // millisecond as verifyWrite's mtime check isn't mistaken for external
+            // modification.
+            this._timestamps.set(resolved, Date.now() + 1);
+        });
+    }
+}
+//# sourceMappingURL=file-pool.js.map

package/dist/lib/file-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-pool.js","sourceRoot":"","sources":["../../src/lib/file-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,YAAY,EAA0B,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAGxC;;;;;;;GAOG;AACH,MAAM,OAAO,QAAQ;IACT,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IACpB,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,EAAE,CAAoB;IAE9B;;;OAGG;IACH,YAAY,UAA6B;QACrC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,sBAAsB;YAAE,OAAO;QAC5C,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAC/B,oEAAoE;YACpE,uEAAuE;YACvE,wEAAwE;YACxE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,QAAQ,GAAG,KAAK;QAChD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,sBAAsB;YAAE,OAAO,IAAI,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,QAAQ,EAAE,CAAC;oBACX,IAAI,CAAC;wBACD,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC7B,CAAC;oBAAC,MAAM,CAAC;wBACL,OAAO,IAAI,CAAC;oBAChB,CAAC;gBACL,CAAC;gBACD,OAAO;oBACH,MAAM,EAAE,qCAAqC,QAAQ,EAAE;oBACvD,MAAM,EAAE,YAAY,CAAC,KAAK;iBAC7B,CAAC;YACN,CAAC;YACD,IAAI,CAAC;gBACD,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACpC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;oBAChC,OAAO;wBACH,MAAM,EAAE,qCAAqC,QAAQ,EAAE;wBACvD,MAAM,EAAE,YAAY,CAAC,KAAK;qBAC7B,CAAC;gBACN,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO;oBACH,MAAM,EAAE,qCAAqC,QAAQ,EAAE;oBACvD,MAAM,EAAE,YAAY,CAAC,KAAK;iBAC7B,CAAC;YACN,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB;QAC9B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,sBAAsB;YAAE,OAAO;QAC5C,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;YAC/B,wEAAwE;YACxE,uEAAuE;YACvE,gBAAgB;YAChB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/lib/workspace.d.ts

@@ -55,6 +55,15 @@ export declare class Workspace {
      * Returns the list of directory names to skip when walking (e.g. `node_modules`, `.git`).
      */
     get skipDirs(): string[];
+    /**
+     * Returns a diagnostic hint when a path fails access checks due to
+     * possible confusion between workspace root and filesystem root.
+     *
+     * @param raw      - The raw user-supplied path string.
+     * @param resolved - The resolved absolute path.
+     * @returns A hint string (empty if no hint applies).
+     */
+    pathHint(raw: string, resolved: string): string;
     /** Whether symlink resolution is enabled for access checks. */
     get resolveSymlinks(): boolean;
     private resolvePath;

package/dist/lib/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/lib/workspace.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAarD;;;;;;GAMG;AACH,qBAAa,SAAS;IAClB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,KAAK,CAAQ;IAErB;;;OAGG;gBACS,MAAM,EAAE,sBAAsB;IAoB1C;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAWjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQlC;;OAEG;IACH,WAAW,IAAI;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAIzD;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,+DAA+D;IAC/D,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,CAAC,WAAW;IAUnB;;;;;;;;OAQG;IACI,IAAI,CACP,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAClD,cAAc,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAqB5E"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/lib/workspace.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAarD;;;;;;GAMG;AACH,qBAAa,SAAS;IAClB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,KAAK,CAAQ;IAErB;;;OAGG;gBACS,MAAM,EAAE,sBAAsB;IAoB1C;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAWjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQlC;;OAEG;IACH,WAAW,IAAI;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAIzD;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAO/C,+DAA+D;IAC/D,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,CAAC,WAAW;IAUnB;;;;;;;;OAQG;IACI,IAAI,CACP,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAClD,cAAc,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAqB5E"}

package/dist/lib/workspace.js

@@ -115,6 +115,20 @@ export class Workspace {
     get skipDirs() {
         return this.cfg.skipDirs;
     }
+    /**
+     * Returns a diagnostic hint when a path fails access checks due to
+     * possible confusion between workspace root and filesystem root.
+     *
+     * @param raw      - The raw user-supplied path string.
+     * @param resolved - The resolved absolute path.
+     * @returns A hint string (empty if no hint applies).
+     */
+    pathHint(raw, resolved) {
+        if (raw.startsWith('/') && !this.canRead(resolved)) {
+            return ' (Tip: paths starting with "/" resolve to filesystem root; use "." or a relative path for workspace root)';
+        }
+        return '';
+    }
     /** Whether symlink resolution is enabled for access checks. */
     get resolveSymlinks() {
         return this.cfg.resolveSymlinks;

package/dist/lib/workspace.js.map

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

package/dist/packages/tool-package.d.ts

@@ -0,0 +1,29 @@
+import { ToolPackage } from '@johannes.latzel/llm-chat';
+import { Workspace } from '../lib/workspace.js';
+import { SearchConfiguration, FileConfiguration } from '../lib/config.js';
+import { FilePool } from '../lib/file-pool.js';
+/**
+ * Aggregates all filesystem tools into a single {@link ToolPackage} for use with
+ * an LLM chat agent.
+ *
+ * Provides tools for reading, writing, searching, listing, creating, deleting,
+ * and moving files and directories within a configured workspace.
+ */
+export declare class FileToolPackage extends ToolPackage {
+    private fileConfig;
+    /**
+     * @param workspace - The workspace for path resolution and access checks.
+     * @param searchConfig - Configuration for search limits.
+     * @param fileConfig - Configuration for file size, character limits, and
+     *   the read-before-write policy.
+     * @param filePool - Optional pool for enforcing read-before-write checks.
+     *   Created from {@link fileConfig} if not provided.
+     */
+    constructor(workspace: Workspace, searchConfig?: SearchConfiguration, fileConfig?: FileConfiguration, filePool?: FilePool);
+    /**
+     * Returns a tutorial string that describes the available filesystem tools,
+     * path resolution rules, and (when enabled) the read-before-write policy.
+     */
+    tutorial(): string | null;
+}
+//# sourceMappingURL=tool-package.d.ts.map

package/dist/packages/tool-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-package.d.ts","sourceRoot":"","sources":["../../src/packages/tool-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAe/C;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC5C,OAAO,CAAC,UAAU,CAAoB;IAEtC;;;;;;;OAOG;gBAEC,SAAS,EAAE,SAAS,EACpB,YAAY,CAAC,EAAE,mBAAmB,EAClC,UAAU,CAAC,EAAE,iBAAiB,EAC9B,QAAQ,CAAC,EAAE,QAAQ;IAsBvB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;CA0C5B"}

package/dist/packages/tool-package.js

@@ -0,0 +1,83 @@
+import { ToolPackage } from '@johannes.latzel/llm-chat';
+import { FileConfiguration } from '../lib/config.js';
+import { FilePool } from '../lib/file-pool.js';
+import { ReadFileTool } from '../tools/read-file.js';
+import { WriteFileTool } from '../tools/write-file.js';
+import { SearchEntriesTool } from '../tools/search.js';
+import { ListDirectoryTool } from '../tools/list-directory.js';
+import { CreateFolderTool } from '../tools/create-folder.js';
+import { DeleteFileTool } from '../tools/delete-file.js';
+import { MoveFileTool } from '../tools/move-file.js';
+import { SwitchWorkspaceTool } from '../tools/switch-workspace.js';
+import { FileAccessInfoTool } from '../tools/file-access-info.js';
+import { EntryInfoTool } from '../tools/entry-info.js';
+import { ReplaceFileLinesTool } from '../tools/replace-file-lines.js';
+import { InsertFileContentTool } from '../tools/insert-file-content.js';
+import { ReplaceFileContentTool } from '../tools/replace-file-content.js';
+/**
+ * Aggregates all filesystem tools into a single {@link ToolPackage} for use with
+ * an LLM chat agent.
+ *
+ * Provides tools for reading, writing, searching, listing, creating, deleting,
+ * and moving files and directories within a configured workspace.
+ */
+export class FileToolPackage extends ToolPackage {
+    fileConfig;
+    /**
+     * @param workspace - The workspace for path resolution and access checks.
+     * @param searchConfig - Configuration for search limits.
+     * @param fileConfig - Configuration for file size, character limits, and
+     *   the read-before-write policy.
+     * @param filePool - Optional pool for enforcing read-before-write checks.
+     *   Created from {@link fileConfig} if not provided.
+     */
+    constructor(workspace, searchConfig, fileConfig, filePool) {
+        const safeConfig = fileConfig ?? new FileConfiguration();
+        filePool ??= new FilePool(safeConfig);
+        super([
+            new SearchEntriesTool(workspace, searchConfig, fileConfig),
+            new ListDirectoryTool(workspace, searchConfig),
+            new ReadFileTool(workspace, safeConfig, filePool),
+            new WriteFileTool(workspace, safeConfig, filePool),
+            new ReplaceFileLinesTool(workspace, safeConfig, filePool),
+            new InsertFileContentTool(workspace, safeConfig, filePool),
+            new ReplaceFileContentTool(workspace, safeConfig, filePool),
+            new EntryInfoTool(workspace),
+            new DeleteFileTool(workspace),
+            new CreateFolderTool(workspace),
+            new MoveFileTool(workspace),
+            new FileAccessInfoTool(workspace),
+            new SwitchWorkspaceTool(workspace)
+        ]);
+        this.fileConfig = safeConfig;
+    }
+    /**
+     * Returns a tutorial string that describes the available filesystem tools,
+     * path resolution rules, and (when enabled) the read-before-write policy.
+     */
+    tutorial() {
+        const lines = [
+            'Filesystem tools for reading, writing, searching, and managing files and directories.',
+            '',
+            'Path resolution:',
+            '  - Relative paths (e.g. ".", "src/index.ts") resolve against the current workspace root.',
+            '  - Absolute paths starting with "/" refer to the filesystem root, not workspace root.',
+            '  - Use "." for the workspace root itself.',
+            '  - Call file_access_info first to see which directories are accessible.',
+            '',
+            'Writing vs editing:',
+            '  - write_file: Creates a new file or replaces the entire content of an existing file.',
+            '  - replace_file_lines: Replaces a specific range of lines (partial edit).',
+            '  - insert_file_content: Inserts new lines at a specific position without deletion.',
+            '  - replace_file_content: Find-and-replace an exact substring.',
+            '  - The three edit tools require the file to already exist; write_file can also create new files.',
+            ''
+        ];
+        if (this.fileConfig.requireReadBeforeWrite) {
+            lines.push('Read before write:', '  - Files must be read with read_file before they can be modified.', '  - A write also counts as a read, so read -> write -> write is allowed.', '  - This ensures the current file content is known before edits are applied.', '');
+        }
+        lines.push('Reading:', '  - read_file: Reads the full content of one or more files.', '  - read_file with start_line/end_line: Reads a specific range of lines only.', '', 'Tips:', '  - Start by listing the workspace root (list_directory with path ".") to explore.', '  - Use search_entries with name_pattern or content_pattern to find files.', '  - Directories are suffixed with "/" in listings and search results.');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=tool-package.js.map

package/dist/packages/tool-package.js.map

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

package/dist/tools/create-folder.d.ts

@@ -8,5 +8,6 @@ export declare class CreateFolderTool extends Tool {
      */
     constructor(workspace: Workspace);
     protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+    private createSingle;
 }
 //# sourceMappingURL=create-folder.d.ts.map

package/dist/tools/create-folder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-folder.d.ts","sourceRoot":"","sources":["../../src/tools/create-folder.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAEjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,8EAA8E;AAC9E,qBAAa,gBAAiB,SAAQ,IAAI;IACtC,OAAO,CAAC,EAAE,CAAY;IAEtB;;OAEG;gBACS,SAAS,EAAE,SAAS;cAchB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAuBvF"}
+{"version":3,"file":"create-folder.d.ts","sourceRoot":"","sources":["../../src/tools/create-folder.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAIjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,8EAA8E;AAC9E,qBAAa,gBAAiB,SAAQ,IAAI;IACtC,OAAO,CAAC,EAAE,CAAY;IAEtB;;OAEG;gBACS,SAAS,EAAE,SAAS;cAiBhB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAYtE,YAAY;CAsB7B"}

package/dist/tools/create-folder.js

@@ -1,4 +1,4 @@
-import { ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import { PropertyType, ResultBuilder, ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
 import * as fsp from 'node:fs/promises';
 /** Tool that creates directories within the allowed workspace directories. */
 export class CreateFolderTool extends Tool {
@@ -7,20 +7,29 @@ export class CreateFolderTool extends Tool {
      * @param workspace - Workspace instance for path resolution and access control.
      */
     constructor(workspace) {
-        super('create_folder', 'Creates a directory and any necessary parent directories.', new ToolParameters({
-            path: new ToolParameterProperty('Directory path')
-        }, ['path']));
+        super('create_folder', 'Creates directories and any necessary parent directories. Paths can be absolute or relative to workspace root.', new ToolParameters({
+            paths: new ToolParameterProperty('Array of directory paths to create', PropertyType.Array)
+        }, ['paths']));
         this.ws = workspace;
     }
     async onExecute(args) {
-        const raw = args.path;
+        const rawPaths = args.paths;
+        if (!Array.isArray(rawPaths)) {
+            return { result: '"paths" must be an array of strings', status: ResultStatus.Error };
+        }
+        if (rawPaths.length === 0) {
+            return { result: '"paths" must be a non-empty array', status: ResultStatus.Error };
+        }
+        return await ResultBuilder.resolveAll(rawPaths.map((p) => this.createSingle(p)));
+    }
+    async createSingle(raw) {
         if (typeof raw !== 'string' || !raw.trim()) {
-            return { result: 'Invalid or inaccessible path', status: ResultStatus.Error };
+            return { result: 'Path must be a non-empty string', status: ResultStatus.Error };
         }
         const resolved = this.ws.normalize(raw.trim());
         if (!this.ws.canWrite(resolved)) {
             return {
-                result: 'Invalid or inaccessible path (must be within writable directory)',
+                result: `Invalid or inaccessible path (must be within writable directory)${this.ws.pathHint(raw, resolved)}`,
                 status: ResultStatus.Error
             };
         }

package/dist/tools/create-folder.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-folder.js","sourceRoot":"","sources":["../../src/tools/create-folder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,YAAY,EACZ,IAAI,EACJ,qBAAqB,EACrB,cAAc,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAGxC,8EAA8E;AAC9E,MAAM,OAAO,gBAAiB,SAAQ,IAAI;IAC9B,EAAE,CAAY;IAEtB;;OAEG;IACH,YAAY,SAAoB;QAC5B,KAAK,CACD,eAAe,EACf,2DAA2D,EAC3D,IAAI,cAAc,CACd;YACI,IAAI,EAAE,IAAI,qBAAqB,CAAC,gBAAgB,CAAC;SACpD,EACD,CAAC,MAAM,CAAC,CACX,CACJ,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACxB,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,IAA6B;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACzC,OAAO,EAAE,MAAM,EAAE,8BAA8B,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QAClF,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACH,MAAM,EAAE,kEAAkE;gBAC1E,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,OAAO,EAAE,MAAM,EAAE,sBAAsB,QAAQ,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO;gBACH,MAAM,EAAE,6BAA8B,CAAW,CAAC,OAAO,EAAE;gBAC3D,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}
+{"version":3,"file":"create-folder.js","sourceRoot":"","sources":["../../src/tools/create-folder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,qBAAqB,EACrB,cAAc,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAGxC,8EAA8E;AAC9E,MAAM,OAAO,gBAAiB,SAAQ,IAAI;IAC9B,EAAE,CAAY;IAEtB;;OAEG;IACH,YAAY,SAAoB;QAC5B,KAAK,CACD,eAAe,EACf,gHAAgH,EAChH,IAAI,cAAc,CACd;YACI,KAAK,EAAE,IAAI,qBAAqB,CAC5B,oCAAoC,EACpC,YAAY,CAAC,KAAK,CACrB;SACJ,EACD,CAAC,OAAO,CAAC,CACZ,CACJ,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACxB,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,IAA6B;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,MAAM,EAAE,qCAAqC,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QACzF,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,mCAAmC,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QACvF,CAAC;QAED,OAAO,MAAM,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,GAAY;QACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACzC,OAAO,EAAE,MAAM,EAAE,iCAAiC,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QACrF,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACH,MAAM,EAAE,mEAAmE,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE;gBAC5G,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,OAAO,EAAE,MAAM,EAAE,sBAAsB,QAAQ,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO;gBACH,MAAM,EAAE,6BAA8B,CAAW,CAAC,OAAO,EAAE;gBAC3D,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}

package/dist/tools/delete-file.d.ts

@@ -8,5 +8,6 @@ export declare class DeleteFileTool extends Tool {
      */
     constructor(workspace: Workspace);
     protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+    private deleteSingle;
 }
 //# sourceMappingURL=delete-file.d.ts.map

package/dist/tools/delete-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-file.d.ts","sourceRoot":"","sources":["../../src/tools/delete-file.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAEjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,wFAAwF;AACxF,qBAAa,cAAe,SAAQ,IAAI;IACpC,OAAO,CAAC,EAAE,CAAY;IAEtB;;OAEG;gBACS,SAAS,EAAE,SAAS;cAiBhB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAqCvF"}
+{"version":3,"file":"delete-file.d.ts","sourceRoot":"","sources":["../../src/tools/delete-file.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAIjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,wFAAwF;AACxF,qBAAa,cAAe,SAAQ,IAAI;IACpC,OAAO,CAAC,EAAE,CAAY;IAEtB;;OAEG;gBACS,SAAS,EAAE,SAAS;cAoBhB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAatE,YAAY;CAkC7B"}

package/dist/tools/delete-file.js

@@ -1,4 +1,4 @@
-import { ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import { PropertyType, ResultBuilder, ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
 import * as fsp from 'node:fs/promises';
 /** Tool that deletes files and directories within the allowed workspace directories. */
 export class DeleteFileTool extends Tool {
@@ -7,21 +7,31 @@ export class DeleteFileTool extends Tool {
      * @param workspace - Workspace instance for path resolution and access control.
      */
     constructor(workspace) {
-        super('delete_file', 'Deletes a file or empty directory. Use recursive=true to delete non-empty directories and their contents.', new ToolParameters({
-            path: new ToolParameterProperty('File or directory path'),
+        super('delete_file', 'Deletes files or empty directories. Use recursive=true to delete non-empty directories and their contents. Paths can be absolute or relative to workspace root.', new ToolParameters({
+            paths: new ToolParameterProperty('Array of file or directory paths to delete', PropertyType.Array),
             recursive: new ToolParameterProperty('Delete directories and their contents recursively')
-        }, ['path']));
+        }, ['paths']));
         this.ws = workspace;
     }
     async onExecute(args) {
-        const raw = args.path;
+        const rawPaths = args.paths;
+        if (!Array.isArray(rawPaths)) {
+            return { result: '"paths" must be an array of strings', status: ResultStatus.Error };
+        }
+        if (rawPaths.length === 0) {
+            return { result: '"paths" must be a non-empty array', status: ResultStatus.Error };
+        }
+        const recursive = args.recursive === true;
+        return await ResultBuilder.resolveAll(rawPaths.map((p) => this.deleteSingle(p, recursive)));
+    }
+    async deleteSingle(raw, recursive) {
         if (typeof raw !== 'string' || !raw.trim()) {
-            return { result: 'Invalid or inaccessible path', status: ResultStatus.Error };
+            return { result: 'Path must be a non-empty string', status: ResultStatus.Error };
         }
         const resolved = this.ws.normalize(raw.trim());
         if (!this.ws.canWrite(resolved)) {
             return {
-                result: 'Invalid or inaccessible path (must be within writable directory)',
+                result: `Invalid or inaccessible path (must be within writable directory)${this.ws.pathHint(raw, resolved)}`,
                 status: ResultStatus.Error
             };
         }
@@ -33,7 +43,6 @@ export class DeleteFileTool extends Tool {
             return { result: 'Path does not exist', status: ResultStatus.Error };
         }
         const label = stat.isDirectory() ? 'directory' : 'file';
-        const recursive = args.recursive === true;
         try {
             if (stat.isDirectory() && !recursive) {
                 await fsp.rmdir(resolved);