@johannes.latzel/llm-chat-file 0.1.0

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

@@ -0,0 +1,12 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that moves or renames files and directories within the allowed workspace directories. */
+export declare class MoveFileTool 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=move-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"move-file.d.ts","sourceRoot":"","sources":["../../src/tools/move-file.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAEjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,iGAAiG;AACjG,qBAAa,YAAa,SAAQ,IAAI;IAClC,OAAO,CAAC,EAAE,CAAY;IAEtB;;OAEG;gBACS,SAAS,EAAE,SAAS;cAehB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAsDvF"}

package/dist/tools/move-file.js

@@ -0,0 +1,71 @@
+import { ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+/** Tool that moves or renames files and directories within the allowed workspace directories. */
+export class MoveFileTool extends Tool {
+    ws;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     */
+    constructor(workspace) {
+        super('move_file', 'Moves or renames a file or directory.', new ToolParameters({
+            source: new ToolParameterProperty('Source path'),
+            destination: new ToolParameterProperty('Destination path')
+        }, ['source', 'destination']));
+        this.ws = workspace;
+    }
+    async onExecute(args) {
+        const srcRaw = args.source;
+        if (typeof srcRaw !== 'string' || !srcRaw.trim()) {
+            return {
+                result: 'Invalid or inaccessible source path (must be within writable directory)',
+                status: ResultStatus.Error
+            };
+        }
+        const src = this.ws.normalize(srcRaw.trim());
+        if (!this.ws.canWrite(src)) {
+            return {
+                result: 'Invalid or inaccessible source path (must be within writable directory)',
+                status: ResultStatus.Error
+            };
+        }
+        const destRaw = args.destination;
+        if (typeof destRaw !== 'string' || !destRaw.trim()) {
+            return {
+                result: 'Invalid or inaccessible destination path (must be within writable directory)',
+                status: ResultStatus.Error
+            };
+        }
+        const dest = this.ws.normalize(destRaw.trim());
+        if (!this.ws.canWrite(dest)) {
+            return {
+                result: 'Invalid or inaccessible destination path (must be within writable directory)',
+                status: ResultStatus.Error
+            };
+        }
+        try {
+            const srcStat = await fsp.stat(src);
+            if (!srcStat.isFile() && !srcStat.isDirectory()) {
+                return { result: 'Source is not a file or directory', status: ResultStatus.Error };
+            }
+        }
+        catch (e) {
+            return {
+                result: `Source not found: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+        try {
+            await fsp.mkdir(path.dirname(dest), { recursive: true });
+            await fsp.rename(src, dest);
+            return {
+                result: `Moved: ${src} -> ${dest}`,
+                status: ResultStatus.Success
+            };
+        }
+        catch (e) {
+            return { result: `Error moving: ${e.message}`, status: ResultStatus.Error };
+        }
+    }
+}
+//# sourceMappingURL=move-file.js.map

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

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

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

@@ -0,0 +1,14 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import { FileConfiguration } from '../lib/config.js';
+import type { Workspace } from '../lib/workspace.js';
+export declare class ReadFileTool extends Tool {
+    private ws;
+    private fc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     * @param fileConfig - Optional file configuration (character limits). Defaults to a new `FileConfiguration`.
+     */
+    constructor(workspace: Workspace, fileConfig?: FileConfiguration);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=read-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAGjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,qBAAa,YAAa,SAAQ,IAAI;IAClC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,EAAE,CAAoB;IAE9B;;;OAGG;gBACS,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,iBAAiB;cA2BhD,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmEvF"}

package/dist/tools/read-file.js

@@ -0,0 +1,86 @@
+import { PropertyType, ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import * as fsp from 'node:fs/promises';
+import { FileConfiguration } from '../lib/config.js';
+import { isBinary } from '../lib/helpers.js';
+/** Tool that reads the contents of a text file within the allowed workspace directories. */
+const TRUNCATION_SUFFIX = '\n... [truncated]';
+export class ReadFileTool extends Tool {
+    ws;
+    fc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     * @param fileConfig - Optional file configuration (character limits). Defaults to a new `FileConfiguration`.
+     */
+    constructor(workspace, fileConfig) {
+        super('read_file', 'Reads the contents of a text file. Supports optional max characters and line ranges (start_line/end_line, 1-indexed).', new ToolParameters({
+            path: new ToolParameterProperty('File path'),
+            max_chars: new ToolParameterProperty('Maximum number of characters to return (default: config max)', PropertyType.Integer),
+            start_line: new ToolParameterProperty('First line number to read (1-indexed, inclusive)', PropertyType.Integer),
+            end_line: new ToolParameterProperty('Last line number to read (1-indexed, inclusive)', PropertyType.Integer)
+        }, ['path']));
+        this.ws = workspace;
+        this.fc = fileConfig ?? new FileConfiguration();
+    }
+    async onExecute(args) {
+        const raw = args.path;
+        if (typeof raw !== 'string' || !raw.trim()) {
+            return { result: 'Path must be a non-empty string', 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: `File not found: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+        if (!stat.isFile()) {
+            return { result: 'Path is not a file', status: ResultStatus.Error };
+        }
+        if (stat.size > this.fc.maxFileSize) {
+            return {
+                result: `File too large (${stat.size} bytes, max ${this.fc.maxFileSize})`,
+                status: ResultStatus.Error
+            };
+        }
+        if (await isBinary(resolved)) {
+            return {
+                result: 'File appears to be binary; use read_file for text files only',
+                status: ResultStatus.Error
+            };
+        }
+        const maxChars = typeof args.max_chars === 'number'
+            ? Math.max(1, Math.min(args.max_chars, this.fc.maxCharsPerFile))
+            : this.fc.maxCharsPerFile;
+        const startLine = typeof args.start_line === 'number' ? Math.max(1, args.start_line) : undefined;
+        const endLine = typeof args.end_line === 'number' && args.end_line > 0 ? args.end_line : undefined;
+        try {
+            const content = await fsp.readFile(resolved, 'utf-8');
+            const lines = content.split('\n');
+            const sliceStart = startLine ? startLine - 1 : 0;
+            const sliceEnd = endLine ? Math.min(endLine, lines.length) : lines.length;
+            const sliced = lines.slice(sliceStart, sliceEnd);
+            let result = sliced.join('\n');
+            if (result.length > maxChars) {
+                result = result.slice(0, maxChars - TRUNCATION_SUFFIX.length) + TRUNCATION_SUFFIX;
+            }
+            return {
+                result: `--- ${resolved} (lines ${sliceStart + 1}-${Math.min(sliceEnd, lines.length)} of ${lines.length}) ---\n${result}`,
+                status: ResultStatus.Success
+            };
+        }
+        catch (e) {
+            return {
+                result: `Error reading file: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+    }
+}
+//# sourceMappingURL=read-file.js.map

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

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

package/dist/tools/search.d.ts

@@ -0,0 +1,17 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import { FileConfiguration, SearchConfiguration } from '../lib/config.js';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that searches for files and directories by name pattern, content pattern, and/or timestamps within the allowed workspace directories. */
+export declare class SearchEntriesTool extends Tool {
+    private ws;
+    private sc;
+    private fc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access checks.
+     * @param searchConfig - Optional search configuration (limits, timeout).
+     * @param fileConfig - Optional file configuration (max chars, max file size).
+     */
+    constructor(workspace: Workspace, searchConfig?: SearchConfiguration, fileConfig?: FileConfiguration);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAGjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAerD,iJAAiJ;AACjJ,qBAAa,iBAAkB,SAAQ,IAAI;IACvC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,EAAE,CAAsB;IAChC,OAAO,CAAC,EAAE,CAAoB;IAE9B;;;;OAIG;gBAEC,SAAS,EAAE,SAAS,EACpB,YAAY,CAAC,EAAE,mBAAmB,EAClC,UAAU,CAAC,EAAE,iBAAiB;cAgDlB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmNvF"}

package/dist/tools/search.js

@@ -0,0 +1,237 @@
+import { PropertyType, ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import * as fsp from 'node:fs/promises';
+import { FileConfiguration, SearchConfiguration } from '../lib/config.js';
+import { isBinary } from '../lib/helpers.js';
+var SearchType;
+(function (SearchType) {
+    SearchType["File"] = "file";
+    SearchType["Directory"] = "directory";
+    SearchType["Both"] = "both";
+})(SearchType || (SearchType = {}));
+function parseType(raw) {
+    if (raw === SearchType.File)
+        return SearchType.File;
+    if (raw === SearchType.Directory)
+        return SearchType.Directory;
+    if (raw === undefined || raw === null)
+        return SearchType.Both;
+    return null;
+}
+/** Tool that searches for files and directories by name pattern, content pattern, and/or timestamps within the allowed workspace directories. */
+export class SearchEntriesTool extends Tool {
+    ws;
+    sc;
+    fc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access checks.
+     * @param searchConfig - Optional search configuration (limits, timeout).
+     * @param fileConfig - Optional file configuration (max chars, max file size).
+     */
+    constructor(workspace, searchConfig, fileConfig) {
+        super('search_entries', 'Searches for files and directories by name and/or content pattern. If no pattern is given, returns all entries. File content matches show the matching line; file name matches show the path; directories are suffixed with "/".', new ToolParameters({
+            path: new ToolParameterProperty('Directory to search in (default: workspace root)'),
+            type: new ToolParameterProperty('Type of entries to search. Accepted values: "file", "directory", "both" (default).'),
+            name_pattern: new ToolParameterProperty('JavaScript regex to match file/directory names against (case-insensitive)'),
+            content_pattern: new ToolParameterProperty('JavaScript regex to search file contents (files only, case-insensitive)'),
+            max_results: new ToolParameterProperty('Maximum number of results to return', PropertyType.Integer),
+            max_size: new ToolParameterProperty('Maximum file size in bytes (capped by configuration max)', PropertyType.Integer),
+            created_after: new ToolParameterProperty('ISO date string — files created after this time'),
+            created_before: new ToolParameterProperty('ISO date string — files created before this time'),
+            modified_after: new ToolParameterProperty('ISO date string — files modified after this time'),
+            modified_before: new ToolParameterProperty('ISO date string — files modified before this time')
+        }, []));
+        this.ws = workspace;
+        this.sc = searchConfig ?? new SearchConfiguration();
+        this.fc = fileConfig ?? new FileConfiguration();
+    }
+    async onExecute(args) {
+        const namePatternRaw = args.name_pattern;
+        const contentPatternRaw = args.content_pattern;
+        const hasName = typeof namePatternRaw === 'string' && namePatternRaw.trim().length > 0;
+        const hasContent = typeof contentPatternRaw === 'string' && contentPatternRaw.trim().length > 0;
+        let nameRegex;
+        if (hasName) {
+            try {
+                nameRegex = new RegExp(namePatternRaw.trim(), 'iu');
+            }
+            catch (e) {
+                return {
+                    result: `Invalid name_pattern regex: ${e.message}`,
+                    status: ResultStatus.Error
+                };
+            }
+        }
+        let contentRegex;
+        if (hasContent) {
+            try {
+                contentRegex = new RegExp(contentPatternRaw.trim(), 'iu');
+            }
+            catch (e) {
+                return {
+                    result: `Invalid content_pattern regex: ${e.message}`,
+                    status: ResultStatus.Error
+                };
+            }
+        }
+        const searchType = parseType(args.type);
+        if (searchType === null) {
+            return {
+                result: 'Invalid type parameter. Accepted values: "file", "directory", "both".',
+                status: ResultStatus.Error
+            };
+        }
+        const raw = args.path;
+        let searchDir;
+        if (typeof raw === 'string' && raw.trim()) {
+            searchDir = this.ws.normalize(raw.trim());
+            if (!this.ws.canRead(searchDir)) {
+                return { result: 'Invalid or inaccessible path', status: ResultStatus.Error };
+            }
+        }
+        else {
+            searchDir = this.ws.currentPath;
+        }
+        const maxResults = typeof args.max_results === 'number'
+            ? Math.max(1, args.max_results)
+            : this.sc.maxSearchResults;
+        const maxSize = typeof args.max_size === 'number'
+            ? Math.max(1, Math.min(args.max_size, this.fc.maxFileSize))
+            : undefined;
+        const createdAfter = typeof args.created_after === 'string' ? new Date(args.created_after) : undefined;
+        const createdBefore = typeof args.created_before === 'string' ? new Date(args.created_before) : undefined;
+        const modifiedAfter = typeof args.modified_after === 'string' ? new Date(args.modified_after) : undefined;
+        const modifiedBefore = typeof args.modified_before === 'string' ? new Date(args.modified_before) : undefined;
+        if (createdAfter && isNaN(createdAfter.getTime()))
+            return { result: 'Invalid created_after date', status: ResultStatus.Error };
+        if (createdBefore && isNaN(createdBefore.getTime()))
+            return { result: 'Invalid created_before date', status: ResultStatus.Error };
+        if (modifiedAfter && isNaN(modifiedAfter.getTime()))
+            return { result: 'Invalid modified_after date', status: ResultStatus.Error };
+        if (modifiedBefore && isNaN(modifiedBefore.getTime()))
+            return { result: 'Invalid modified_before date', status: ResultStatus.Error };
+        const hasTimestampFilter = !!(createdAfter ||
+            createdBefore ||
+            modifiedAfter ||
+            modifiedBefore);
+        const deadline = Date.now() + this.sc.timeoutMs;
+        const results = [];
+        let visited = 0;
+        const maxChars = this.fc.maxCharsPerFile;
+        const walkErrors = [];
+        try {
+            for await (const entry of this.ws.walk(searchDir, (dirPath, _err) => {
+                walkErrors.push(dirPath);
+            })) {
+                if (Date.now() > deadline) {
+                    return {
+                        result: `Search timed out after ${visited} entries, found ${results.length} matches`,
+                        status: ResultStatus.Success
+                    };
+                }
+                visited++;
+                if (visited >= this.sc.maxTotalEntries) {
+                    return {
+                        result: `Searched too many entries (${visited}), aborting. Found ${results.length} matches.`,
+                        status: ResultStatus.Error
+                    };
+                }
+                if (results.length >= maxResults)
+                    break;
+                const isDir = entry.dirent.isDirectory();
+                const isFile = entry.dirent.isFile();
+                if (searchType === SearchType.File && !isFile)
+                    continue;
+                if (searchType === SearchType.Directory && !isDir)
+                    continue;
+                if (nameRegex && !nameRegex.test(entry.dirent.name))
+                    continue;
+                if (isDir) {
+                    if (nameRegex) {
+                        results.push(entry.filePath + '/');
+                    }
+                }
+                else if (isFile) {
+                    let st;
+                    const needsStat = hasTimestampFilter || (contentRegex && maxSize !== undefined);
+                    if (needsStat) {
+                        try {
+                            st = await fsp.stat(entry.filePath);
+                        }
+                        catch {
+                            continue;
+                        }
+                    }
+                    if (contentRegex && maxSize !== undefined && st && st.size > maxSize)
+                        continue;
+                    if (hasTimestampFilter && st) {
+                        if (createdAfter && st.birthtime.getTime() < createdAfter.getTime())
+                            continue;
+                        if (createdBefore && st.birthtime.getTime() > createdBefore.getTime())
+                            continue;
+                        if (modifiedAfter && st.mtime.getTime() < modifiedAfter.getTime())
+                            continue;
+                        if (modifiedBefore && st.mtime.getTime() > modifiedBefore.getTime())
+                            continue;
+                    }
+                    if (contentRegex) {
+                        if (await isBinary(entry.filePath))
+                            continue;
+                        try {
+                            const content = await fsp.readFile(entry.filePath, 'utf-8');
+                            const truncated = content.slice(0, maxChars);
+                            const lines = truncated.split('\n');
+                            for (let i = 0; i < lines.length; i++) {
+                                if (results.length >= maxResults)
+                                    break;
+                                const line = lines[i];
+                                if (line === undefined)
+                                    continue;
+                                if (contentRegex.test(line)) {
+                                    const ts = hasTimestampFilter && st
+                                        ? `  (created: ${st.birthtime.toISOString()}, modified: ${st.mtime.toISOString()})`
+                                        : '';
+                                    results.push(`${entry.filePath}:${i + 1}: ${line.trim().slice(0, 200)}${ts}`);
+                                }
+                            }
+                        }
+                        catch {
+                            // skip unreadable files
+                        }
+                    }
+                    else {
+                        const ts = hasTimestampFilter && st
+                            ? `  (created: ${st.birthtime.toISOString()}, modified: ${st.mtime.toISOString()})`
+                            : '';
+                        results.push(entry.filePath + ts);
+                    }
+                }
+            }
+            const errorWarning = walkErrors.length > 0
+                ? `(Warning: could not read ${walkErrors.length} director${walkErrors.length === 1 ? 'y' : 'ies'}, results may be incomplete)\n\n`
+                : '';
+            if (visited > this.sc.maxDisplayEntries) {
+                return {
+                    result: `${errorWarning}Searched ${visited} entries, found ${results.length} matches`,
+                    status: ResultStatus.Success
+                };
+            }
+            if (results.length === 0) {
+                return {
+                    result: `${errorWarning}No matching entries found`,
+                    status: ResultStatus.Success
+                };
+            }
+            return {
+                result: errorWarning + results.join('\n'),
+                status: ResultStatus.Success
+            };
+        }
+        catch (e) {
+            return {
+                result: `Error searching: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/switch-workspace.d.ts

@@ -0,0 +1,12 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that changes the current workspace path to a new directory within configured accessible directories. */
+export declare class SwitchWorkspaceTool extends Tool {
+    private ws;
+    /**
+     * @param workspace - Workspace instance for path resolution and workspace switching.
+     */
+    constructor(workspace: Workspace);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=switch-workspace.d.ts.map

package/dist/tools/switch-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-workspace.d.ts","sourceRoot":"","sources":["../../src/tools/switch-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAEjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,gHAAgH;AAChH,qBAAa,mBAAoB,SAAQ,IAAI;IACzC,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;CAkBvF"}

package/dist/tools/switch-workspace.js

@@ -0,0 +1,34 @@
+import { ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+/** Tool that changes the current workspace path to a new directory within configured accessible directories. */
+export class SwitchWorkspaceTool extends Tool {
+    ws;
+    /**
+     * @param workspace - Workspace instance for path resolution and workspace switching.
+     */
+    constructor(workspace) {
+        super('switch_workspace', 'Changes the current workspace path to a new directory within configured accessible directories. Must be called before any other filesystem tool when changing workspace. Do NOT call this tool in parallel with any other filesystem tool — call it first, then call the other tools sequentially.', new ToolParameters({
+            path: new ToolParameterProperty('Target directory path')
+        }, ['path']));
+        this.ws = workspace;
+    }
+    async onExecute(args) {
+        const raw = args.path;
+        if (typeof raw !== 'string' || !raw.trim()) {
+            return { result: 'path must be a non-empty string', status: ResultStatus.Error };
+        }
+        try {
+            await this.ws.switchWorkspace(raw.trim());
+            return {
+                result: `Switched workspace to: ${this.ws.currentPath}`,
+                status: ResultStatus.Success
+            };
+        }
+        catch (e) {
+            return {
+                result: e.message,
+                status: ResultStatus.Error
+            };
+        }
+    }
+}
+//# sourceMappingURL=switch-workspace.js.map

package/dist/tools/switch-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-workspace.js","sourceRoot":"","sources":["../../src/tools/switch-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,YAAY,EACZ,IAAI,EACJ,qBAAqB,EACrB,cAAc,EACjB,MAAM,2BAA2B,CAAC;AAGnC,gHAAgH;AAChH,MAAM,OAAO,mBAAoB,SAAQ,IAAI;IACjC,EAAE,CAAY;IAEtB;;OAEG;IACH,YAAY,SAAoB;QAC5B,KAAK,CACD,kBAAkB,EAClB,oSAAoS,EACpS,IAAI,cAAc,CACd;YACI,IAAI,EAAE,IAAI,qBAAqB,CAAC,uBAAuB,CAAC;SAC3D,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,iCAAiC,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QACrF,CAAC;QACD,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,OAAO;gBACH,MAAM,EAAE,0BAA0B,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE;gBACvD,MAAM,EAAE,YAAY,CAAC,OAAO;aAC/B,CAAC;QACN,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO;gBACH,MAAM,EAAG,CAAW,CAAC,OAAO;gBAC5B,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}

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

@@ -0,0 +1,15 @@
+import { PartialToolResult, Tool } from '@johannes.latzel/llm-chat';
+import { FileConfiguration } from '../lib/config.js';
+import type { Workspace } from '../lib/workspace.js';
+/** Tool that writes text content to a file within the allowed workspace directories. */
+export declare class WriteFileTool extends Tool {
+    private ws;
+    private fc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     * @param fileConfig - Optional file configuration (character limits). Defaults to a new `FileConfiguration`.
+     */
+    constructor(workspace: Workspace, fileConfig?: FileConfiguration);
+    protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
+}
+//# sourceMappingURL=write-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAEjB,IAAI,EAGP,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,wFAAwF;AACxF,qBAAa,aAAc,SAAQ,IAAI;IACnC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,EAAE,CAAoB;IAE9B;;;OAGG;gBACS,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,iBAAiB;cAgBhD,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAkCvF"}

package/dist/tools/write-file.js

@@ -0,0 +1,56 @@
+import { ResultStatus, Tool, ToolParameterProperty, ToolParameters } from '@johannes.latzel/llm-chat';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { FileConfiguration } from '../lib/config.js';
+/** Tool that writes text content to a file within the allowed workspace directories. */
+export class WriteFileTool extends Tool {
+    ws;
+    fc;
+    /**
+     * @param workspace - Workspace instance for path resolution and access control.
+     * @param fileConfig - Optional file configuration (character limits). Defaults to a new `FileConfiguration`.
+     */
+    constructor(workspace, fileConfig) {
+        super('write_file', 'Writes text content to a file. Creates parent directories automatically. Only for text files.', new ToolParameters({
+            path: new ToolParameterProperty('File path'),
+            content: new ToolParameterProperty('Text content to write')
+        }, ['path', 'content']));
+        this.ws = workspace;
+        this.fc = fileConfig ?? new FileConfiguration();
+    }
+    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
+            };
+        }
+        const content = args.content;
+        if (typeof content !== 'string') {
+            return { result: 'content must be a string', status: ResultStatus.Error };
+        }
+        if (content.length > this.fc.maxCharsPerFile) {
+            return {
+                result: `Content exceeds max length of ${this.fc.maxCharsPerFile}`,
+                status: ResultStatus.Error
+            };
+        }
+        try {
+            await fsp.mkdir(path.dirname(resolved), { recursive: true });
+            await fsp.writeFile(resolved, content, 'utf-8');
+            return { result: `Written: ${resolved}`, status: ResultStatus.Success };
+        }
+        catch (e) {
+            return {
+                result: `Error writing file: ${e.message}`,
+                status: ResultStatus.Error
+            };
+        }
+    }
+}
+//# sourceMappingURL=write-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/tools/write-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;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,wFAAwF;AACxF,MAAM,OAAO,aAAc,SAAQ,IAAI;IAC3B,EAAE,CAAY;IACd,EAAE,CAAoB;IAE9B;;;OAGG;IACH,YAAY,SAAoB,EAAE,UAA8B;QAC5D,KAAK,CACD,YAAY,EACZ,+FAA+F,EAC/F,IAAI,cAAc,CACd;YACI,IAAI,EAAE,IAAI,qBAAqB,CAAC,WAAW,CAAC;YAC5C,OAAO,EAAE,IAAI,qBAAqB,CAAC,uBAAuB,CAAC;SAC9D,EACD,CAAC,MAAM,EAAE,SAAS,CAAC,CACtB,CACJ,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;QACpB,IAAI,CAAC,EAAE,GAAG,UAAU,IAAI,IAAI,iBAAiB,EAAE,CAAC;IACpD,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;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QAC9E,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC;YAC3C,OAAO;gBACH,MAAM,EAAE,iCAAiC,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE;gBAClE,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,EAAE,MAAM,EAAE,YAAY,QAAQ,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;QAC5E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO;gBACH,MAAM,EAAE,uBAAwB,CAAW,CAAC,OAAO,EAAE;gBACrD,MAAM,EAAE,YAAY,CAAC,KAAK;aAC7B,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}