@johannes.latzel/llm-chat-file 0.1.0

package/dist/lib/workspace.js

@@ -0,0 +1,168 @@
+import { Mutex } from 'async-mutex';
+import * as fs from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+function isWithin(resolved, dirs) {
+    const real = path.resolve(resolved);
+    for (const dir of dirs) {
+        const d = path.resolve(dir);
+        const rel = path.relative(d, real);
+        if (rel && !rel.startsWith('..') && !path.isAbsolute(rel))
+            return true;
+        if (rel === '')
+            return true;
+    }
+    return false;
+}
+/**
+ * Manages the current workspace path and enforces access control for all file operations.
+ *
+ * Tracks which directories are accessible (read and/or write) and provides methods
+ * to check permissions, resolve paths, and switch the active workspace directory.
+ * Uses a mutex to ensure thread-safe workspace switching.
+ */
+export class Workspace {
+    /** The currently active workspace directory (absolute path). */
+    currentPath;
+    cfg;
+    mutex;
+    /**
+     * @param config - Directory configuration defining accessible paths and their permission levels.
+     * @throws {Error} If the configuration contains no access entries.
+     */
+    constructor(config) {
+        const cleaned = config.deduplicate();
+        if (cleaned.accesses.length === 0) {
+            throw new Error('At least one access directory is required');
+        }
+        this.cfg = cleaned;
+        this.mutex = new Mutex();
+        if (cleaned.workspacePath) {
+            this.currentPath = path.resolve(cleaned.workspacePath);
+        }
+        else {
+            const writeDir = cleaned.accesses.find((a) => a.type === 'write');
+            this.currentPath = writeDir
+                ? path.resolve(writeDir.path)
+                : path.resolve(cleaned.accesses[0].path);
+        }
+        this.currentPath = this.resolvePath(this.currentPath);
+    }
+    /**
+     * Changes the current workspace path to a new directory, thread-safe with a mutex.
+     *
+     * @param target - Path to the new workspace directory (may be relative or absolute).
+     * @throws {Error} If the target is not within any configured accessible directory.
+     */
+    async switchWorkspace(target) {
+        await this.mutex.runExclusive(async () => {
+            let resolved = path.resolve(target);
+            resolved = this.resolvePath(resolved);
+            const allDirs = this.cfg.accesses.map((a) => path.resolve(a.path));
+            if (!isWithin(resolved, allDirs)) {
+                throw new Error(`Path is not within any configured directory: ${target}`);
+            }
+            this.currentPath = resolved;
+        });
+    }
+    /**
+     * Resolves a path against the current workspace. If the input is already absolute, `path.resolve` returns it as-is.
+     *
+     * @param input - Path to resolve (relative or absolute).
+     * @returns The resolved absolute path.
+     */
+    normalize(input) {
+        return this.resolvePath(input);
+    }
+    /**
+     * Checks whether the given absolute path is within any directory configured for read (or write) access.
+     *
+     * @param absPath - Absolute path to check.
+     * @returns `true` if the path is readable.
+     */
+    canRead(absPath) {
+        const pathToCheck = this.resolvePath(absPath);
+        const readDirs = this.cfg.accesses
+            .filter((a) => a.type === 'read')
+            .map((a) => path.resolve(a.path));
+        const writeDirs = this.cfg.accesses
+            .filter((a) => a.type === 'write')
+            .map((a) => path.resolve(a.path));
+        return isWithin(pathToCheck, [...readDirs, ...writeDirs]);
+    }
+    /**
+     * Checks whether the given absolute path is within any directory configured for write access.
+     *
+     * @param absPath - Absolute path to check.
+     * @returns `true` if the path is writable.
+     */
+    canWrite(absPath) {
+        const pathToCheck = this.resolvePath(absPath);
+        const writeDirs = this.cfg.accesses
+            .filter((a) => a.type === 'write')
+            .map((a) => path.resolve(a.path));
+        return isWithin(pathToCheck, writeDirs);
+    }
+    /**
+     * Returns the list of configured directory accesses with their types.
+     */
+    getAccesses() {
+        return this.cfg.accesses.map((a) => ({ type: a.type, path: path.resolve(a.path) }));
+    }
+    /**
+     * Returns the list of directory names to skip when walking (e.g. `node_modules`, `.git`).
+     */
+    get skipDirs() {
+        return this.cfg.skipDirs;
+    }
+    /** Whether symlink resolution is enabled for access checks. */
+    get resolveSymlinks() {
+        return this.cfg.resolveSymlinks;
+    }
+    resolvePath(input) {
+        const abs = path.resolve(this.currentPath, input);
+        if (!this.cfg.resolveSymlinks)
+            return abs;
+        try {
+            return fs.realpathSync.native(abs);
+        }
+        catch {
+            return abs;
+        }
+    }
+    /**
+     * Recursively walks a directory, yielding entries for files and directories.
+     * Skips directories whose names are listed in `cfg.skipDirs`.
+     *
+     * @param dir - Directory to walk.
+     * @param onError - Optional callback invoked when a subdirectory cannot be read.
+     *   Receives the directory path and the error. The walk continues with other subtrees.
+     * @yields {WalkEntry} Entries for each file and subdirectory found.
+     */
+    async *walk(dir, onError) {
+        const resolved = this.resolvePath(dir);
+        if (!this.canRead(resolved))
+            return;
+        let entries;
+        try {
+            entries = await fsp.readdir(resolved, { withFileTypes: true });
+        }
+        catch (e) {
+            onError?.(resolved, e);
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(resolved, entry.name);
+            if (entry.isDirectory()) {
+                if (this.cfg.skipDirs.includes(entry.name))
+                    continue;
+                yield { filePath: fullPath, dirent: entry };
+                yield* this.walk(fullPath, onError);
+            }
+            else if (entry.isFile()) {
+                yield { filePath: fullPath, dirent: entry };
+            }
+        }
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/lib/workspace.js.map

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

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

@@ -0,0 +1,12 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that creates directories within the allowed workspace directories. */
+export declare class CreateFolderTool extends Tool {
+    private ws;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     */
+    constructor(workspace: Workspace);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=create-folder.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/create-folder.js

@@ -0,0 +1,39 @@
+import { 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 {
+    ws;
+    /**
+     * @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']));
+        this.ws = workspace;
+    }
+    async onExecute(args) {
+        const raw = args.path;
+        if (typeof raw !== 'string' || !raw.trim()) {
+            return { result: 'Invalid or inaccessible path', 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)',
+                status: ResultStatus.Error
+            };
+        }
+        try {
+            await fsp.mkdir(resolved, { recursive: true });
+            return { result: `Created directory: ${resolved}/`, status: ResultStatus.Success };
+        }
+        catch (e) {
+            return {
+                result: `Error creating directory: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+    }
+}
+//# sourceMappingURL=create-folder.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,12 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that deletes files and directories within the allowed workspace directories. */
+export declare class DeleteFileTool extends Tool {
+    private ws;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     */
+    constructor(workspace: Workspace);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=delete-file.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/delete-file.js

@@ -0,0 +1,54 @@
+import { 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 {
+    ws;
+    /**
+     * @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'),
+            recursive: new ToolParameterProperty('Delete directories and their contents recursively')
+        }, ['path']));
+        this.ws = workspace;
+    }
+    async onExecute(args) {
+        const raw = args.path;
+        if (typeof raw !== 'string' || !raw.trim()) {
+            return { result: 'Invalid or inaccessible path', 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)',
+                status: ResultStatus.Error
+            };
+        }
+        let stat;
+        try {
+            stat = await fsp.stat(resolved);
+        }
+        catch {
+            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);
+            }
+            else {
+                await fsp.rm(resolved, { recursive: true });
+            }
+            return { result: `Deleted ${label}: ${resolved}`, status: ResultStatus.Success };
+        }
+        catch (e) {
+            return {
+                result: `Error deleting ${label}: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+    }
+}
+//# sourceMappingURL=delete-file.js.map

package/dist/tools/delete-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-file.js","sourceRoot":"","sources":["../../src/tools/delete-file.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,wFAAwF;AACxF,MAAM,OAAO,cAAe,SAAQ,IAAI;IAC5B,EAAE,CAAY;IAEtB;;OAEG;IACH,YAAY,SAAoB;QAC5B,KAAK,CACD,aAAa,EACb,2GAA2G,EAC3G,IAAI,cAAc,CACd;YACI,IAAI,EAAE,IAAI,qBAAqB,CAAC,wBAAwB,CAAC;YACzD,SAAS,EAAE,IAAI,qBAAqB,CAChC,mDAAmD,CACtD;SACJ,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,IAAI,CAAC;QACT,IAAI,CAAC;YACD,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QACzE,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;QAE1C,IAAI,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,KAAK,QAAQ,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;QACrF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO;gBACH,MAAM,EAAE,kBAAkB,KAAK,KAAM,CAAW,CAAC,OAAO,EAAE;gBAC1D,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}

package/dist/tools/entry-info.d.ts

@@ -0,0 +1,9 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that returns metadata about a filesystem entry (file, directory, symlink, etc.). */
+export declare class EntryInfoTool extends Tool {
+    private ws;
+    constructor(workspace: Workspace);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=entry-info.d.ts.map

package/dist/tools/entry-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-info.d.ts","sourceRoot":"","sources":["../../src/tools/entry-info.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAEjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAoDrD,4FAA4F;AAC5F,qBAAa,aAAc,SAAQ,IAAI;IACnC,OAAO,CAAC,EAAE,CAAY;gBAEV,SAAS,EAAE,SAAS;cAchB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA2CvF"}

package/dist/tools/entry-info.js

@@ -0,0 +1,107 @@
+import { ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import * as fsp from 'node:fs/promises';
+import * as fs from 'node:fs';
+/**
+ * Categorises the type of a filesystem entry based on `fs.Stats`.
+ * Used by `EntryInfoTool` to describe the entry in its output.
+ */
+var EntryType;
+(function (EntryType) {
+    /** Regular file. */
+    EntryType["File"] = "file";
+    /** Directory. */
+    EntryType["Directory"] = "directory";
+    /** Symbolic link. */
+    EntryType["Symlink"] = "symlink";
+    /** Named pipe (FIFO). */
+    EntryType["FIFO"] = "FIFO";
+    /** Unix domain socket. */
+    EntryType["Socket"] = "socket";
+    /** Character device. */
+    EntryType["CharacterDevice"] = "character device";
+    /** Block device. */
+    EntryType["BlockDevice"] = "block device";
+    /** Any other entry type not covered above. */
+    EntryType["Unknown"] = "unknown";
+})(EntryType || (EntryType = {}));
+function formatMode(mode) {
+    const usr = (mode & fs.constants.S_IRUSR ? 'r' : '-') +
+        (mode & fs.constants.S_IWUSR ? 'w' : '-') +
+        (mode & fs.constants.S_IXUSR ? 'x' : '-');
+    const grp = (mode & fs.constants.S_IRGRP ? 'r' : '-') +
+        (mode & fs.constants.S_IWGRP ? 'w' : '-') +
+        (mode & fs.constants.S_IXGRP ? 'x' : '-');
+    const oth = (mode & fs.constants.S_IROTH ? 'r' : '-') +
+        (mode & fs.constants.S_IWOTH ? 'w' : '-') +
+        (mode & fs.constants.S_IXOTH ? 'x' : '-');
+    return `${usr}${grp}${oth}`;
+}
+function entryType(stats) {
+    if (stats.isSymbolicLink())
+        return EntryType.Symlink;
+    if (stats.isDirectory())
+        return EntryType.Directory;
+    if (stats.isFile())
+        return EntryType.File;
+    if (stats.isFIFO())
+        return EntryType.FIFO;
+    if (stats.isSocket())
+        return EntryType.Socket;
+    if (stats.isCharacterDevice())
+        return EntryType.CharacterDevice;
+    if (stats.isBlockDevice())
+        return EntryType.BlockDevice;
+    return EntryType.Unknown;
+}
+/** Tool that returns metadata about a filesystem entry (file, directory, symlink, etc.). */
+export class EntryInfoTool extends Tool {
+    ws;
+    constructor(workspace) {
+        super('entry_info', 'Returns metadata about a filesystem entry (file, directory, symlink, etc.) including its type, size, timestamps, permissions, and symlink target if applicable.', new ToolParameters({
+            path: new ToolParameterProperty('File system path')
+        }, ['path']));
+        this.ws = workspace;
+    }
+    async onExecute(args) {
+        const raw = args.path;
+        if (typeof raw !== 'string' || !raw.trim()) {
+            return { result: 'Invalid or inaccessible path', status: ResultStatus.Error };
+        }
+        const resolved = this.ws.normalize(raw.trim());
+        if (!this.ws.canRead(resolved)) {
+            return { result: 'Invalid or inaccessible path', status: ResultStatus.Error };
+        }
+        let stats;
+        try {
+            stats = await fsp.lstat(resolved);
+        }
+        catch (e) {
+            return {
+                result: `Path not found: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+        const type = entryType(stats);
+        const lines = [
+            `Path: ${resolved}`,
+            `Type: ${type}`,
+            `Size: ${stats.size} bytes`,
+            `Permissions: ${formatMode(stats.mode)}`,
+            `Created: ${stats.birthtime.toISOString()}`,
+            `Modified (content): ${stats.mtime.toISOString()}`,
+            `Accessed: ${stats.atime.toISOString()}`,
+            `Changed (metadata): ${stats.ctime.toISOString()}`
+        ];
+        if (stats.isSymbolicLink()) {
+            try {
+                const target = await fsp.readlink(resolved);
+                lines.push(`Symlink target: ${target}`);
+            }
+            catch {
+                lines.push('Symlink target: (unreadable)');
+            }
+        }
+        return { result: lines.join('\n'), status: ResultStatus.Success };
+    }
+}
+//# sourceMappingURL=entry-info.js.map

package/dist/tools/entry-info.js.map

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

package/dist/tools/file-access-info.d.ts

@@ -0,0 +1,12 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that reports which directories are accessible and their access levels. */
+export declare class FileAccessInfoTool extends Tool {
+    private ws;
+    /**
+     * @param workspace - Workspace instance providing access configuration.
+     */
+    constructor(workspace: Workspace);
+    protected onExecute(_args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=file-access-info.d.ts.map

package/dist/tools/file-access-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-info.d.ts","sourceRoot":"","sources":["../../src/tools/file-access-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgB,IAAI,EAAkB,MAAM,2BAA2B,CAAC;AAClG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,IAAI;IACxC,OAAO,CAAC,EAAE,CAAY;IAEtB;;OAEG;gBACS,SAAS,EAAE,SAAS;cAShB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAYxF"}

package/dist/tools/file-access-info.js

@@ -0,0 +1,23 @@
+import { ResultStatus, Tool, ToolParameters } from '@johannes.latzel/llm-chat';
+/** Tool that reports which directories are accessible and their access levels. */
+export class FileAccessInfoTool extends Tool {
+    ws;
+    /**
+     * @param workspace - Workspace instance providing access configuration.
+     */
+    constructor(workspace) {
+        super('file_access_info', 'Returns a list of all configured directories with their access levels (read/write) and indicates which one is the current workspace path. Use this to discover which parts of the filesystem are available for reading and writing.', new ToolParameters({}, []));
+        this.ws = workspace;
+    }
+    async onExecute(_args) {
+        const accesses = this.ws.getAccesses();
+        const current = this.ws.currentPath;
+        const lines = ['Configured file system access:'];
+        for (const a of accesses) {
+            const marker = a.path === current ? '  (current workspace)' : '';
+            lines.push(`  ${a.path.padEnd(60)} ${a.type}${marker}`);
+        }
+        return { result: lines.join('\n'), status: ResultStatus.Success };
+    }
+}
+//# sourceMappingURL=file-access-info.js.map

package/dist/tools/file-access-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-info.js","sourceRoot":"","sources":["../../src/tools/file-access-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGlG,kFAAkF;AAClF,MAAM,OAAO,kBAAmB,SAAQ,IAAI;IAChC,EAAE,CAAY;IAEtB;;OAEG;IACH,YAAY,SAAoB;QAC5B,KAAK,CACD,kBAAkB,EAClB,qOAAqO,EACrO,IAAI,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAC7B,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACxB,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,KAA8B;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC;QAEpC,MAAM,KAAK,GAAa,CAAC,gCAAgC,CAAC,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;IACtE,CAAC;CACJ"}

package/dist/tools/list-directory.d.ts

@@ -0,0 +1,15 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import { SearchConfiguration } from '../lib/config.js';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that lists files and directories in a given path within the workspace. */
+export declare class ListDirectoryTool extends Tool {
+    private ws;
+    private sc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     * @param config - Optional search configuration (display/total entry limits). Defaults to a new `SearchConfiguration`.
+     */
+    constructor(workspace: Workspace, config?: SearchConfiguration);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=list-directory.d.ts.map

package/dist/tools/list-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory.d.ts","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAGjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,kFAAkF;AAClF,qBAAa,iBAAkB,SAAQ,IAAI;IACvC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,EAAE,CAAsB;IAEhC;;;OAGG;gBACS,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,mBAAmB;cAmB9C,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA6GvF"}

package/dist/tools/list-directory.js

@@ -0,0 +1,120 @@
+import { PropertyType, ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { SearchConfiguration } from '../lib/config.js';
+/** Tool that lists files and directories in a given path within the workspace. */
+export class ListDirectoryTool extends Tool {
+    ws;
+    sc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     * @param config - Optional search configuration (display/total entry limits). Defaults to a new `SearchConfiguration`.
+     */
+    constructor(workspace, config) {
+        super('list_directory', 'Lists files and directories in a path. Returns one entry per line; directories are suffixed with "/".', new ToolParameters({
+            path: new ToolParameterProperty('Directory path'),
+            recursive: new ToolParameterProperty('Set to true to list recursively depth-first', PropertyType.Boolean)
+        }, ['path']));
+        this.ws = workspace;
+        this.sc = config ?? new SearchConfiguration();
+    }
+    async onExecute(args) {
+        const raw = args.path;
+        if (typeof raw !== 'string' || !raw.trim()) {
+            return { result: 'Invalid or inaccessible path', status: ResultStatus.Error };
+        }
+        const resolved = this.ws.normalize(raw.trim());
+        if (!this.ws.canRead(resolved)) {
+            return { result: 'Invalid or inaccessible path', status: ResultStatus.Error };
+        }
+        let stat;
+        try {
+            stat = await fsp.stat(resolved);
+        }
+        catch (e) {
+            return {
+                result: `Path not found: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+        if (!stat.isDirectory()) {
+            return { result: 'Path is not a directory', status: ResultStatus.Error };
+        }
+        const recursive = args.recursive === true;
+        const entries = [];
+        let totalEntries = 0;
+        let totalFiles = 0;
+        let totalDirs = 0;
+        const walkErrors = [];
+        try {
+            if (recursive) {
+                for await (const entry of this.ws.walk(resolved, (dirPath, _err) => {
+                    walkErrors.push(dirPath);
+                })) {
+                    totalEntries++;
+                    if (entry.dirent.isDirectory())
+                        totalDirs++;
+                    else
+                        totalFiles++;
+                    if (totalEntries >= this.sc.maxTotalEntries) {
+                        const ew = walkErrors.length > 0
+                            ? `(Warning: could not read ${walkErrors.length} director${walkErrors.length === 1 ? 'y' : 'ies'}, listing may be incomplete)\n\n`
+                            : '';
+                        return {
+                            result: `${ew}Directory contains too many entries (${totalEntries}), refusing to list`,
+                            status: ResultStatus.Error
+                        };
+                    }
+                    if (totalEntries <= this.sc.maxDisplayEntries) {
+                        entries.push(entry.dirent.isDirectory() ? entry.filePath + '/' : entry.filePath);
+                    }
+                }
+            }
+            else {
+                const dir = await fsp.readdir(resolved, { withFileTypes: true });
+                const filtered = dir.filter((d) => !d.isDirectory() || !this.ws.skipDirs.includes(d.name));
+                totalEntries = filtered.length;
+                totalFiles = filtered.filter((d) => d.isFile()).length;
+                totalDirs = totalEntries - totalFiles;
+                if (totalEntries >= this.sc.maxTotalEntries) {
+                    return {
+                        result: `Directory contains too many entries (${totalEntries}), refusing to list`,
+                        status: ResultStatus.Error
+                    };
+                }
+                if (totalEntries <= this.sc.maxDisplayEntries) {
+                    for (const d of filtered) {
+                        const fullPath = path.join(resolved, d.name);
+                        entries.push(d.isDirectory() ? fullPath + '/' : fullPath);
+                    }
+                }
+            }
+            const errorWarning = recursive && walkErrors.length > 0
+                ? `(Warning: could not read ${walkErrors.length} director${walkErrors.length === 1 ? 'y' : 'ies'}, listing may be incomplete)\n\n`
+                : '';
+            if (totalEntries > this.sc.maxDisplayEntries) {
+                return {
+                    result: `${errorWarning}Found ${totalFiles} files and ${totalDirs} directories`,
+                    status: ResultStatus.Success
+                };
+            }
+            if (entries.length === 0) {
+                return {
+                    result: `${errorWarning}(empty directory)`,
+                    status: ResultStatus.Success
+                };
+            }
+            return {
+                result: errorWarning + entries.join('\n'),
+                status: ResultStatus.Success
+            };
+        }
+        catch (e) {
+            return {
+                result: `Error listing directory: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+    }
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/tools/list-directory.js.map

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