xc-mcp/dist/tools/simctl/delete.d.ts

MCP server that wraps Xcode command-line tools for iOS/macOS development workflows

/**
 * Permanently delete iOS simulator devices
 *
 * **What it does:**
 * Permanently removes a simulator device and all its data from the system. This action
 * cannot be undone. The simulator must be shut down before deletion.
 *
 * **Why you'd use it:**
 * - Clean up unused simulators to save disk space (simulators can be 5-10GB each)
 * - Quick operation for fast permanent deletion
 * - Safety checks prevent accidental deletion of booted devices
 * - Automated cleanup workflows for CI/CD environments
 *
 * **Parameters:**
 * - `deviceId` (string): Device UDID to delete (from simctl-list)
 *
 * **Returns:**
 * Deletion status with device information and confirmation that action is permanent
 *
 * **Example:**
 * ```typescript
 * // Delete specific simulator
 * await simctlDeleteTool({ deviceId: 'ABC-123-DEF' })
 * ```
 *
 * **Full documentation:** See simctl/delete.md for safety considerations and best practices
 *
 * @param args Deletion configuration (requires deviceId)
 * @returns Tool result with deletion status and guidance
 * @throws McpError for invalid device ID, booted device, or deletion failure
 */
export declare function simctlDeleteTool(args: any): Promise<{
    content: {
        type: "text";
        text: string;
    }[];
    isError: boolean;
}>;
export declare const SIMCTL_DELETE_DOCS = "\n# simctl-delete\n\nPermanently delete iOS simulator devices.\n\n## Overview\n\nPermanently removes a simulator device and all its data from the system. This action cannot be undone. The simulator must be shut down before deletion. Useful for cleaning up unused simulators to save disk space (simulators can be 5-10GB each).\n\n## Parameters\n\n### Required\n- **deviceId** (string): Device UDID to delete (from simctl-list)\n\n## Returns\n\nDeletion status with device information, confirmation that action is permanent, success indicator, command output, and guidance emphasizing permanent nature of deletion.\n\n## Examples\n\n### Delete specific simulator\n```typescript\nawait simctlDeleteTool({ deviceId: 'ABC-123-DEF' });\n```\n\n### Clean up old test device\n```typescript\nawait simctlDeleteTool({ deviceId: 'OLD-TEST-DEVICE-UDID' });\n```\n\n## Related Tools\n\n- simctl-list: Find device UDID to delete\n- simctl-shutdown: Shutdown device before deletion (required)\n- simctl-create: Create new simulator after deletion\n\n## Notes\n\n- This action cannot be undone - device and all data permanently removed\n- Device must be shut down before deletion (safety check)\n- Simulators can be 5-10GB each - deletion frees significant disk space\n- Use simctl-erase instead if you want to keep device but reset state\n- Fast operation - completes in seconds\n";
//# sourceMappingURL=delete.d.ts.map