@dexto/tools-filesystem 1.5.8 → 1.6.0

package/dist/types.d.ts

@@ -4,11 +4,11 @@
  * Types and interfaces for file system operations including reading, writing,
  * searching, and validation.
  */
-type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
+export type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
 /**
  * File content with metadata
  */
-interface FileContent {
+export interface FileContent {
     content: string;
     lines: number;
     encoding: string;
@@ -19,7 +19,7 @@ interface FileContent {
 /**
  * Options for reading files
  */
-interface ReadFileOptions {
+export interface ReadFileOptions {
     /** Maximum number of lines to read */
     limit?: number | undefined;
     /** Starting line number (1-based) */
@@ -30,7 +30,7 @@ interface ReadFileOptions {
 /**
  * File metadata for glob results
  */
-interface FileMetadata {
+export interface FileMetadata {
     path: string;
     size: number;
     modified: Date;
@@ -39,7 +39,7 @@ interface FileMetadata {
 /**
  * Options for glob operations
  */
-interface GlobOptions {
+export interface GlobOptions {
     /** Base directory to search from */
     cwd?: string | undefined;
     /** Maximum number of results */
@@ -50,7 +50,7 @@ interface GlobOptions {
 /**
  * Glob result
  */
-interface GlobResult {
+export interface GlobResult {
     files: FileMetadata[];
     truncated: boolean;
     totalFound: number;
@@ -58,7 +58,7 @@ interface GlobResult {
 /**
  * Search match with context
  */
-interface SearchMatch {
+export interface SearchMatch {
     file: string;
     lineNumber: number;
     line: string;
@@ -70,7 +70,7 @@ interface SearchMatch {
 /**
  * Options for content search (grep)
  */
-interface GrepOptions {
+export interface GrepOptions {
     /** Base directory to search */
     path?: string | undefined;
     /** Glob pattern to filter files */
@@ -87,7 +87,7 @@ interface GrepOptions {
 /**
  * Search result
  */
-interface SearchResult {
+export interface SearchResult {
     matches: SearchMatch[];
     totalMatches: number;
     truncated: boolean;
@@ -96,7 +96,7 @@ interface SearchResult {
 /**
  * Options for writing files
  */
-interface WriteFileOptions {
+export interface WriteFileOptions {
     /** Create parent directories if they don't exist */
     createDirs?: boolean | undefined;
     /** File encoding (default: utf-8) */
@@ -107,7 +107,7 @@ interface WriteFileOptions {
 /**
  * Write result
  */
-interface WriteResult {
+export interface WriteResult {
     success: boolean;
     path: string;
     bytesWritten: number;
@@ -118,7 +118,7 @@ interface WriteResult {
 /**
  * Edit operation
  */
-interface EditOperation {
+export interface EditOperation {
     oldString: string;
     newString: string;
     replaceAll?: boolean | undefined;
@@ -126,7 +126,7 @@ interface EditOperation {
 /**
  * Options for editing files
  */
-interface EditFileOptions {
+export interface EditFileOptions {
     /** Create backup before editing */
     backup?: boolean;
     /** File encoding */
@@ -135,7 +135,7 @@ interface EditFileOptions {
 /**
  * Edit result
  */
-interface EditResult {
+export interface EditResult {
     success: boolean;
     path: string;
     changesCount: number;
@@ -148,7 +148,7 @@ interface EditResult {
 /**
  * Path validation result
  */
-interface PathValidation {
+export interface PathValidation {
     isValid: boolean;
     error?: string;
     normalizedPath?: string;
@@ -156,7 +156,7 @@ interface PathValidation {
 /**
  * File system configuration
  */
-interface FileSystemConfig {
+export interface FileSystemConfig {
     /** Allowed base paths */
     allowedPaths: string[];
     /** Blocked paths (relative to allowed paths) */
@@ -174,5 +174,4 @@ interface FileSystemConfig {
     /** Working directory for glob/grep operations (defaults to process.cwd()) */
     workingDirectory?: string | undefined;
 }
-
-export type { BufferEncoding, EditFileOptions, EditOperation, EditResult, FileContent, FileMetadata, FileSystemConfig, GlobOptions, GlobResult, GrepOptions, PathValidation, ReadFileOptions, SearchMatch, SearchResult, WriteFileOptions, WriteResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/write-file-tool.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,33 +15,25 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var write_file_tool_exports = {};
 __export(write_file_tool_exports, {
   createWriteFileTool: () => createWriteFileTool
 });
 module.exports = __toCommonJS(write_file_tool_exports);
-var path = __toESM(require("node:path"), 1);
 var import_node_crypto = require("node:crypto");
 var import_zod = require("zod");
 var import_diff = require("diff");
 var import_core = require("@dexto/core");
 var import_error_codes = require("./error-codes.js");
+var import_directory_approval = require("./directory-approval.js");
 const previewContentHashCache = /* @__PURE__ */ new Map();
 const FILE_NOT_EXISTS_MARKER = null;
 function computeContentHash(content) {
   return (0, import_node_crypto.createHash)("sha256").update(content, "utf8").digest("hex");
 }
 const WriteFileInputSchema = import_zod.z.object({
-  file_path: import_zod.z.string().describe("Absolute path where the file should be written"),
+  file_path: import_zod.z.string().min(1).describe("Absolute path where the file should be written"),
   content: import_zod.z.string().describe("Content to write to the file"),
   create_dirs: import_zod.z.boolean().optional().default(false).describe("Create parent directories if they don't exist (default: false)"),
   encoding: import_zod.z.enum(["utf-8", "ascii", "latin1", "utf16le"]).optional().default("utf-8").describe("File encoding (default: utf-8)")
@@ -62,80 +52,51 @@ function generateDiffPreview(filePath, originalContent, newContent) {
     deletions
   };
 }
-function createWriteFileTool(options) {
-  const { fileSystemService, directoryApproval } = options;
-  let pendingApprovalParentDir;
-  return {
+function createWriteFileTool(getFileSystemService) {
+  return (0, import_core.defineTool)({
     id: "write_file",
+    displayName: "Write",
+    aliases: ["write"],
     description: "Write content to a file. Creates a new file or overwrites existing file. Automatically creates backup of existing files before overwriting. Use create_dirs to create parent directories. Requires approval for all write operations. Returns success status, path, bytes written, and backup path if applicable.",
     inputSchema: WriteFileInputSchema,
-    /**
-     * Check if this write operation needs directory access approval.
-     * Returns custom approval request if the file is outside allowed paths.
-     */
-    getApprovalOverride: async (args) => {
-      const { file_path } = args;
-      if (!file_path) return null;
-      const isAllowed = await fileSystemService.isPathWithinConfigAllowed(file_path);
-      if (isAllowed) {
-        return null;
-      }
-      if (directoryApproval?.isSessionApproved(file_path)) {
-        return null;
-      }
-      const absolutePath = path.resolve(file_path);
-      const parentDir = path.dirname(absolutePath);
-      pendingApprovalParentDir = parentDir;
-      return {
-        type: import_core.ApprovalType.DIRECTORY_ACCESS,
-        metadata: {
-          path: absolutePath,
-          parentDir,
-          operation: "write",
-          toolName: "write_file"
-        }
-      };
-    },
-    /**
-     * Handle approved directory access - remember the directory for session
-     */
-    onApprovalGranted: (response) => {
-      if (!directoryApproval || !pendingApprovalParentDir) return;
-      const data = response.data;
-      const rememberDirectory = data?.rememberDirectory ?? false;
-      directoryApproval.addApproved(
-        pendingApprovalParentDir,
-        rememberDirectory ? "session" : "once"
-      );
-      pendingApprovalParentDir = void 0;
-    },
+    ...(0, import_directory_approval.createDirectoryAccessApprovalHandlers)({
+      toolName: "write_file",
+      operation: "write",
+      getFileSystemService,
+      resolvePaths: (input, fileSystemService) => (0, import_directory_approval.resolveFilePath)(fileSystemService.getWorkingDirectory(), input.file_path)
+    }),
     /**
      * Generate preview for approval UI - shows diff or file creation info
      * Stores content hash for change detection in execute phase.
      */
-    generatePreview: async (input, context) => {
+    async generatePreview(input, context) {
       const { file_path, content } = input;
+      const resolvedFileSystemService = await getFileSystemService(context);
+      const { path: resolvedPath } = (0, import_directory_approval.resolveFilePath)(
+        resolvedFileSystemService.getWorkingDirectory(),
+        file_path
+      );
       try {
-        const originalFile = await fileSystemService.readFile(file_path);
+        const originalFile = await resolvedFileSystemService.readFile(resolvedPath);
         const originalContent = originalFile.content;
-        if (context?.toolCallId) {
+        if (context.toolCallId) {
           previewContentHashCache.set(
             context.toolCallId,
             computeContentHash(originalContent)
           );
         }
-        return generateDiffPreview(file_path, originalContent, content);
+        return generateDiffPreview(resolvedPath, originalContent, content);
       } catch (error) {
         if (error instanceof import_core.DextoRuntimeError && error.code === import_error_codes.FileSystemErrorCode.FILE_NOT_FOUND) {
-          if (context?.toolCallId) {
+          if (context.toolCallId) {
             previewContentHashCache.set(context.toolCallId, FILE_NOT_EXISTS_MARKER);
           }
           const lineCount = content.split("\n").length;
           const preview = {
             type: "file",
-            path: file_path,
+            path: resolvedPath,
             operation: "create",
-            size: content.length,
+            size: Buffer.byteLength(content, "utf8"),
             lineCount,
             content
             // Include content for approval preview
@@ -145,12 +106,17 @@ function createWriteFileTool(options) {
         throw error;
       }
     },
-    execute: async (input, context) => {
+    async execute(input, context) {
+      const resolvedFileSystemService = await getFileSystemService(context);
       const { file_path, content, create_dirs, encoding } = input;
+      const { path: resolvedPath } = (0, import_directory_approval.resolveFilePath)(
+        resolvedFileSystemService.getWorkingDirectory(),
+        file_path
+      );
       let originalContent = null;
       let fileExistsNow = false;
       try {
-        const originalFile = await fileSystemService.readFile(file_path);
+        const originalFile = await resolvedFileSystemService.readFile(resolvedPath);
         originalContent = originalFile.content;
         fileExistsNow = true;
       } catch (error) {
@@ -161,24 +127,30 @@ function createWriteFileTool(options) {
           throw error;
         }
       }
-      if (context?.toolCallId && previewContentHashCache.has(context.toolCallId)) {
+      if (context.toolCallId && previewContentHashCache.has(context.toolCallId)) {
         const expectedHash = previewContentHashCache.get(context.toolCallId);
         previewContentHashCache.delete(context.toolCallId);
         if (expectedHash === FILE_NOT_EXISTS_MARKER) {
           if (fileExistsNow) {
-            throw import_core.ToolError.fileModifiedSincePreview("write_file", file_path);
+            throw import_core.ToolError.fileModifiedSincePreview("write_file", resolvedPath);
           }
         } else if (expectedHash !== null) {
           if (!fileExistsNow) {
-            throw import_core.ToolError.fileModifiedSincePreview("write_file", file_path);
+            throw import_core.ToolError.fileModifiedSincePreview("write_file", resolvedPath);
+          }
+          if (originalContent === null) {
+            throw import_core.ToolError.executionFailed(
+              "write_file",
+              "Expected original file content when fileExistsNow is true"
+            );
           }
           const currentHash = computeContentHash(originalContent);
           if (expectedHash !== currentHash) {
-            throw import_core.ToolError.fileModifiedSincePreview("write_file", file_path);
+            throw import_core.ToolError.fileModifiedSincePreview("write_file", resolvedPath);
           }
         }
       }
-      const result = await fileSystemService.writeFile(file_path, content, {
+      const result = await resolvedFileSystemService.writeFile(resolvedPath, content, {
         createDirs: create_dirs,
         encoding
       });
@@ -187,13 +159,13 @@ function createWriteFileTool(options) {
         const lineCount = content.split("\n").length;
         _display = {
           type: "file",
-          path: file_path,
+          path: resolvedPath,
           operation: "create",
           size: result.bytesWritten,
           lineCount
         };
       } else {
-        _display = generateDiffPreview(file_path, originalContent, content);
+        _display = generateDiffPreview(resolvedPath, originalContent, content);
       }
       return {
         success: result.success,
@@ -203,7 +175,7 @@ function createWriteFileTool(options) {
         _display
       };
     }
-  };
+  });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/write-file-tool.d.cts

@@ -1,5 +1,6 @@
-import { InternalTool } from '@dexto/core';
-import { FileToolOptions } from './file-tool-types.cjs';
+import { z } from 'zod';
+import { Tool } from '@dexto/core';
+import { FileSystemServiceGetter } from './file-tool-types.cjs';
 import './filesystem-service.cjs';
 import './types.cjs';
 
@@ -9,9 +10,25 @@ import './types.cjs';
  * Internal tool for writing content to files (requires approval)
  */
 
+declare const WriteFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+    create_dirs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    encoding: z.ZodDefault<z.ZodOptional<z.ZodEnum<["utf-8", "ascii", "latin1", "utf16le"]>>>;
+}, "strict", z.ZodTypeAny, {
+    encoding: "ascii" | "utf-8" | "utf16le" | "latin1";
+    content: string;
+    file_path: string;
+    create_dirs: boolean;
+}, {
+    content: string;
+    file_path: string;
+    encoding?: "ascii" | "utf-8" | "utf16le" | "latin1" | undefined;
+    create_dirs?: boolean | undefined;
+}>;
 /**
  * Create the write_file internal tool with directory approval support
  */
-declare function createWriteFileTool(options: FileToolOptions): InternalTool;
+declare function createWriteFileTool(getFileSystemService: FileSystemServiceGetter): Tool<typeof WriteFileInputSchema>;
 
 export { createWriteFileTool };

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

@@ -1,17 +1,30 @@
-import { InternalTool } from '@dexto/core';
-import { FileToolOptions } from './file-tool-types.js';
-import './filesystem-service.js';
-import './types.js';
-
 /**
  * Write File Tool
  *
  * Internal tool for writing content to files (requires approval)
  */
-
+import { z } from 'zod';
+import type { Tool } from '@dexto/core';
+import type { FileSystemServiceGetter } from './file-tool-types.js';
+declare const WriteFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+    create_dirs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    encoding: z.ZodDefault<z.ZodOptional<z.ZodEnum<["utf-8", "ascii", "latin1", "utf16le"]>>>;
+}, "strict", z.ZodTypeAny, {
+    encoding: "ascii" | "utf-8" | "utf16le" | "latin1";
+    content: string;
+    file_path: string;
+    create_dirs: boolean;
+}, {
+    content: string;
+    file_path: string;
+    encoding?: "ascii" | "utf-8" | "utf16le" | "latin1" | undefined;
+    create_dirs?: boolean | undefined;
+}>;
 /**
  * Create the write_file internal tool with directory approval support
  */
-declare function createWriteFileTool(options: FileToolOptions): InternalTool;
-
-export { createWriteFileTool };
+export declare function createWriteFileTool(getFileSystemService: FileSystemServiceGetter): Tool<typeof WriteFileInputSchema>;
+export {};
+//# sourceMappingURL=write-file-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-file-tool.d.ts","sourceRoot":"","sources":["../src/write-file-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAG9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAuBpE,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;EAeb,CAAC;AAyBd;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,oBAAoB,EAAE,uBAAuB,GAC9C,IAAI,CAAC,OAAO,oBAAoB,CAAC,CA0KnC"}

package/dist/write-file-tool.js

@@ -1,20 +1,16 @@
-import * as path from "node:path";
 import { createHash } from "node:crypto";
 import { z } from "zod";
 import { createPatch } from "diff";
-import {
-  DextoRuntimeError,
-  ApprovalType,
-  ToolError
-} from "@dexto/core";
+import { DextoRuntimeError, ToolError, defineTool } from "@dexto/core";
 import { FileSystemErrorCode } from "./error-codes.js";
+import { createDirectoryAccessApprovalHandlers, resolveFilePath } from "./directory-approval.js";
 const previewContentHashCache = /* @__PURE__ */ new Map();
 const FILE_NOT_EXISTS_MARKER = null;
 function computeContentHash(content) {
   return createHash("sha256").update(content, "utf8").digest("hex");
 }
 const WriteFileInputSchema = z.object({
-  file_path: z.string().describe("Absolute path where the file should be written"),
+  file_path: z.string().min(1).describe("Absolute path where the file should be written"),
   content: z.string().describe("Content to write to the file"),
   create_dirs: z.boolean().optional().default(false).describe("Create parent directories if they don't exist (default: false)"),
   encoding: z.enum(["utf-8", "ascii", "latin1", "utf16le"]).optional().default("utf-8").describe("File encoding (default: utf-8)")
@@ -33,80 +29,51 @@ function generateDiffPreview(filePath, originalContent, newContent) {
     deletions
   };
 }
-function createWriteFileTool(options) {
-  const { fileSystemService, directoryApproval } = options;
-  let pendingApprovalParentDir;
-  return {
+function createWriteFileTool(getFileSystemService) {
+  return defineTool({
     id: "write_file",
+    displayName: "Write",
+    aliases: ["write"],
     description: "Write content to a file. Creates a new file or overwrites existing file. Automatically creates backup of existing files before overwriting. Use create_dirs to create parent directories. Requires approval for all write operations. Returns success status, path, bytes written, and backup path if applicable.",
     inputSchema: WriteFileInputSchema,
-    /**
-     * Check if this write operation needs directory access approval.
-     * Returns custom approval request if the file is outside allowed paths.
-     */
-    getApprovalOverride: async (args) => {
-      const { file_path } = args;
-      if (!file_path) return null;
-      const isAllowed = await fileSystemService.isPathWithinConfigAllowed(file_path);
-      if (isAllowed) {
-        return null;
-      }
-      if (directoryApproval?.isSessionApproved(file_path)) {
-        return null;
-      }
-      const absolutePath = path.resolve(file_path);
-      const parentDir = path.dirname(absolutePath);
-      pendingApprovalParentDir = parentDir;
-      return {
-        type: ApprovalType.DIRECTORY_ACCESS,
-        metadata: {
-          path: absolutePath,
-          parentDir,
-          operation: "write",
-          toolName: "write_file"
-        }
-      };
-    },
-    /**
-     * Handle approved directory access - remember the directory for session
-     */
-    onApprovalGranted: (response) => {
-      if (!directoryApproval || !pendingApprovalParentDir) return;
-      const data = response.data;
-      const rememberDirectory = data?.rememberDirectory ?? false;
-      directoryApproval.addApproved(
-        pendingApprovalParentDir,
-        rememberDirectory ? "session" : "once"
-      );
-      pendingApprovalParentDir = void 0;
-    },
+    ...createDirectoryAccessApprovalHandlers({
+      toolName: "write_file",
+      operation: "write",
+      getFileSystemService,
+      resolvePaths: (input, fileSystemService) => resolveFilePath(fileSystemService.getWorkingDirectory(), input.file_path)
+    }),
     /**
      * Generate preview for approval UI - shows diff or file creation info
      * Stores content hash for change detection in execute phase.
      */
-    generatePreview: async (input, context) => {
+    async generatePreview(input, context) {
       const { file_path, content } = input;
+      const resolvedFileSystemService = await getFileSystemService(context);
+      const { path: resolvedPath } = resolveFilePath(
+        resolvedFileSystemService.getWorkingDirectory(),
+        file_path
+      );
       try {
-        const originalFile = await fileSystemService.readFile(file_path);
+        const originalFile = await resolvedFileSystemService.readFile(resolvedPath);
         const originalContent = originalFile.content;
-        if (context?.toolCallId) {
+        if (context.toolCallId) {
           previewContentHashCache.set(
             context.toolCallId,
             computeContentHash(originalContent)
           );
         }
-        return generateDiffPreview(file_path, originalContent, content);
+        return generateDiffPreview(resolvedPath, originalContent, content);
       } catch (error) {
         if (error instanceof DextoRuntimeError && error.code === FileSystemErrorCode.FILE_NOT_FOUND) {
-          if (context?.toolCallId) {
+          if (context.toolCallId) {
             previewContentHashCache.set(context.toolCallId, FILE_NOT_EXISTS_MARKER);
           }
           const lineCount = content.split("\n").length;
           const preview = {
             type: "file",
-            path: file_path,
+            path: resolvedPath,
             operation: "create",
-            size: content.length,
+            size: Buffer.byteLength(content, "utf8"),
             lineCount,
             content
             // Include content for approval preview
@@ -116,12 +83,17 @@ function createWriteFileTool(options) {
         throw error;
       }
     },
-    execute: async (input, context) => {
+    async execute(input, context) {
+      const resolvedFileSystemService = await getFileSystemService(context);
       const { file_path, content, create_dirs, encoding } = input;
+      const { path: resolvedPath } = resolveFilePath(
+        resolvedFileSystemService.getWorkingDirectory(),
+        file_path
+      );
       let originalContent = null;
       let fileExistsNow = false;
       try {
-        const originalFile = await fileSystemService.readFile(file_path);
+        const originalFile = await resolvedFileSystemService.readFile(resolvedPath);
         originalContent = originalFile.content;
         fileExistsNow = true;
       } catch (error) {
@@ -132,24 +104,30 @@ function createWriteFileTool(options) {
           throw error;
         }
       }
-      if (context?.toolCallId && previewContentHashCache.has(context.toolCallId)) {
+      if (context.toolCallId && previewContentHashCache.has(context.toolCallId)) {
         const expectedHash = previewContentHashCache.get(context.toolCallId);
         previewContentHashCache.delete(context.toolCallId);
         if (expectedHash === FILE_NOT_EXISTS_MARKER) {
           if (fileExistsNow) {
-            throw ToolError.fileModifiedSincePreview("write_file", file_path);
+            throw ToolError.fileModifiedSincePreview("write_file", resolvedPath);
           }
         } else if (expectedHash !== null) {
           if (!fileExistsNow) {
-            throw ToolError.fileModifiedSincePreview("write_file", file_path);
+            throw ToolError.fileModifiedSincePreview("write_file", resolvedPath);
+          }
+          if (originalContent === null) {
+            throw ToolError.executionFailed(
+              "write_file",
+              "Expected original file content when fileExistsNow is true"
+            );
           }
           const currentHash = computeContentHash(originalContent);
           if (expectedHash !== currentHash) {
-            throw ToolError.fileModifiedSincePreview("write_file", file_path);
+            throw ToolError.fileModifiedSincePreview("write_file", resolvedPath);
           }
         }
       }
-      const result = await fileSystemService.writeFile(file_path, content, {
+      const result = await resolvedFileSystemService.writeFile(resolvedPath, content, {
         createDirs: create_dirs,
         encoding
       });
@@ -158,13 +136,13 @@ function createWriteFileTool(options) {
         const lineCount = content.split("\n").length;
         _display = {
           type: "file",
-          path: file_path,
+          path: resolvedPath,
           operation: "create",
           size: result.bytesWritten,
           lineCount
         };
       } else {
-        _display = generateDiffPreview(file_path, originalContent, content);
+        _display = generateDiffPreview(resolvedPath, originalContent, content);
       }
       return {
         success: result.success,
@@ -174,7 +152,7 @@ function createWriteFileTool(options) {
         _display
       };
     }
-  };
+  });
 }
 export {
   createWriteFileTool