Function executeFileEditOperation

src/node/services/tools/file_edit_operation.ts:107–276

({
  config,
  filePath,
  operation,
  abortSignal,
}: ExecuteFileEditOperationOptions<TMetadata>)

 * Handles validation, file IO, diff generation, and common error handling.
 */
export async function executeFileEditOperation<TMetadata>({
  config,
  filePath,
  operation,
  abortSignal,
}: ExecuteFileEditOperationOptions<TMetadata>): Promise<
  FileEditErrorResult | (FileEditDiffSuccessBase & TMetadata)
> {
  try {
    const {
      correctedPath: validatedPath,
      warning: pathWarning,
      resolvedPath,
    } = resolvePathWithinCwd(filePath, config.cwd, config.runtime);
    filePath = validatedPath;

    // Validate plan mode access restrictions
    const planModeError = await validatePlanModeAccess(filePath, config);
    if (planModeError) {
      return planModeError;
    }

    const abortedBeforeLock = getAbortedFileEditResult(abortSignal);
    if (abortedBeforeLock) {
      return abortedBeforeLock;
    }

    // Serialize same-file edits so a later operation re-reads the file after the
    // earlier write lands instead of racing on stale content or temp-file writes.
    let writeStarted = false;
    const lockedEditPromise: Promise<ExecuteFileEditReturn<TMetadata>> = getFileEditLocks(
      config.runtime
    ).withLock(resolvedPath, async () => {
      // Abort can fire while we wait on the lock, and local runtime file I/O does
      // not observe abort signals on its own, so re-check before touching disk.
      const abortedAfterLock = getAbortedFileEditResult(abortSignal);
      if (abortedAfterLock) {
        return abortedAfterLock;
      }

      // Check if file exists and get stats using runtime
      let fileStat;
      try {
        fileStat = await config.runtime.stat(resolvedPath, abortSignal);
      } catch (err) {
        if (err instanceof RuntimeError) {
          return {
            success: false,
            error: err.message,
          };
        }
        throw err;
      }

      if (fileStat.isDirectory) {
        return {
          success: false,
          error: `Path is a directory, not a file: ${resolvedPath}`,