import { BaseFileSystemTool } from './shared/BaseFileSystemTool.js';
import { parsePath, resolveHybridScriptId, fileNameMatches } from '../../api/pathParser.js';
import { ValidationError } from '../../errors/mcpErrors.js';
import { SCRIPT_ID_SCHEMA, PATH_SCHEMA, ACCESS_TOKEN_SCHEMA, FORCE_SCHEMA, EXPECTED_HASH_SCHEMA } from './shared/schemas.js';
import type { RemoveParams, RemoveResult } from './shared/types.js';
import { GitOperationManager } from '../../core/git/GitOperationManager.js';
import { GitPathResolver } from '../../core/git/GitPathResolver.js';
import { SyncStrategyFactory } from '../../core/git/SyncStrategyFactory.js';
import { DeleteOperationStrategy } from '../../core/git/operations/DeleteOperationStrategy.js';
import { checkForConflictOrThrow } from '../../utils/conflictDetection.js';
import { clearGASMetadata } from '../../utils/gasMetadataCache.js';
import { join as pathJoin } from 'path';
/**
* Remove files from Google Apps Script project
*
* ✅ RECOMMENDED - Safe file deletion with local cache cleanup
* Like Unix rm but works with GAS flat file structure
*/
export class RmTool extends BaseFileSystemTool {
public name = 'rm';
public description = '[FILE:DELETE] Remove a file from a GAS project. WHEN: deleting files no longer needed. AVOID: use mv to rename instead of delete+create. Example: rm({scriptId, path: "OldUtils.gs"}). GIT: use git_feature(start) before features, git_feature(commit) after changes.';
public outputSchema = {
type: 'object' as const,
properties: {
success: { type: 'boolean', description: 'Whether the deletion succeeded' },
path: { type: 'string', description: 'Path of deleted file' },
localDeleted: { type: 'boolean', description: 'Whether local cache file was deleted' },
remoteDeleted: { type: 'boolean', description: 'Whether remote GAS file was deleted' },
git: { type: 'object', description: 'Compact git hint (branch, uncommitted count, action)' }
}
};
public inputSchema = {
type: 'object',
properties: {
scriptId: {
...SCRIPT_ID_SCHEMA
},
path: {
...PATH_SCHEMA,
description: 'File path (filename only, or scriptId/filename if scriptId parameter is empty). Extensions are auto-detected and should not be included.'
},
changeReason: {
type: 'string',
description: 'Optional commit message for git integration. If omitted, defaults to "Delete {filename}". Git repo is created automatically if it doesn\'t exist.',
examples: ['Remove unused utility', 'Delete deprecated file', 'Clean up old backup']
},
expectedHash: {
...EXPECTED_HASH_SCHEMA
},
force: {
...FORCE_SCHEMA,
description: 'Bypass hash conflict detection. Use when you want to delete regardless of external changes.'
},
accessToken: {
...ACCESS_TOKEN_SCHEMA
}
},
required: ['scriptId', 'path'],
llmGuidance: {
gitIntegration: 'CRITICAL: does NOT auto-commit. Must call git_feature({operation:"commit"}) after deletion.',
nextSteps: 'git_feature commit→save deletion | ls→verify removal'
}
};
public annotations = {
title: 'Delete File',
readOnlyHint: false,
destructiveHint: true,
openWorldHint: true
};
async execute(params: RemoveParams & { expectedHash?: string; force?: boolean }): Promise<RemoveResult> {
const hybridResolution = resolveHybridScriptId(params.scriptId, params.path);
const fullPath = `${hybridResolution.scriptId}/${hybridResolution.cleanPath}`;
const path = this.validate.filePath(fullPath, 'file operation');
const parsedPath = parsePath(path);
if (!parsedPath.isFile) {
throw new ValidationError('path', path, 'file path (must include filename)');
}
const accessToken = await this.getAuthToken(params);
const filename = parsedPath.filename!;
// === HASH-BASED CONFLICT DETECTION ===
// Only fetch when expectedHash is provided (avoids unnecessary API calls when just force=true)
if (params.expectedHash) {
const currentFiles = await this.gasClient.getProjectContent(parsedPath.scriptId, accessToken);
const existingFile = currentFiles.find((f: any) => fileNameMatches(f.name, filename));
if (existingFile) {
checkForConflictOrThrow({
scriptId: parsedPath.scriptId,
filename,
operation: 'rm',
currentRemoteContent: existingFile.source || '',
expectedHash: params.expectedHash,
hashSource: 'param',
force: params.force
});
}
}
// === END HASH-BASED CONFLICT DETECTION ===
// Always use GitOperationManager for proper workflow:
// 1. Compute changes (read file for backup)
// 2. Validate with hooks (commit deletion)
// 3. Write to remote (delete file)
// Git repo will be created automatically if it doesn't exist
const operation = new DeleteOperationStrategy({
scriptId: parsedPath.scriptId,
path: params.path,
accessToken,
gasClient: this.gasClient
});
const pathResolver = new GitPathResolver();
const syncFactory = new SyncStrategyFactory();
const gitManager = new GitOperationManager(pathResolver, syncFactory, this.gasClient);
// Use provided changeReason or generate default
const defaultMessage = `Delete ${filename}`;
const gitResult = await gitManager.executeWithGit(operation, {
scriptId: parsedPath.scriptId,
files: [filename],
changeReason: params.changeReason || defaultMessage,
accessToken
});
// Clear xattr cache for deleted file (prevents false collision on recreate)
try {
const { LocalFileManager } = await import('../../utils/localFileManager.js');
const projectPath = await LocalFileManager.getProjectDirectory(parsedPath.scriptId);
const fileExtension = LocalFileManager.getFileExtensionFromName(filename);
const localFilePath = pathJoin(projectPath, filename + fileExtension);
await clearGASMetadata(localFilePath);
console.error(`🗑️ [RM] Cleared xattr cache for deleted file`);
} catch (cacheError) {
console.error(`⚠️ [RM] Cache clear failed: ${cacheError}`);
}
// Return response with compact git hints for LLM guidance
return {
success: true,
path,
localDeleted: true, // GitOperationManager handles local deletion
remoteDeleted: gitResult.result.remoteDeleted,
// Compact git hint from GitOperationManager
git: gitResult.git?.hint,
};
}
}
