@elliotding/ai-agent-mcp 0.1.24 → 0.1.26

package/dist/tools/sync-resources.js

@@ -1,733 +0,0 @@
-"use strict";
-/**
- * sync_resources Tool
- *
- * Synchronises the user's subscribed AI resources.
- *
- * Resource delivery strategy (v1.5):
- *   - Command / Skill : registered as MCP Prompts (NOT written to local filesystem).
- *                       Content is generated into .prompt-cache/ and registered via PromptManager.
- *   - Rule            : downloaded to ~/.cursor/rules/ (Cursor engine requires local files).
- *   - MCP             : downloaded to ~/.cursor/mcp-servers/ and registered in mcp.json.
- *
- * Flow:
- *   1. Fetch subscription list from CSP server (REST API).
- *   2. (non-check) Trigger Git sync on server side via multiSourceGitManager.
- *   3. For each subscription: handle per type as above.
- *   4. Update telemetry: subscribed_rules + configured_mcps lists.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.syncResourcesTool = void 0;
-exports.syncResources = syncResources;
-const fs = __importStar(require("fs/promises"));
-const path = __importStar(require("path"));
-const logger_1 = require("../utils/logger");
-const client_1 = require("../api/client");
-const multi_source_manager_1 = require("../git/multi-source-manager");
-const cursor_paths_1 = require("../utils/cursor-paths");
-const errors_1 = require("../types/errors");
-const index_js_1 = require("../telemetry/index.js");
-const index_js_2 = require("../prompts/index.js");
-const downloadCache = new Map();
-function syncCacheKey(userToken, resourceId) {
-    return `${userToken}::${resourceId}`;
-}
-/**
- * Extract the `description` field from YAML frontmatter in a Markdown file.
- * Frontmatter is delimited by leading `---` and closing `---` lines.
- * Returns undefined if no frontmatter or no description key is found.
- */
-function extractFrontmatterDescription(content) {
-    if (!content.startsWith('---'))
-        return undefined;
-    const end = content.indexOf('\n---', 3);
-    if (end === -1)
-        return undefined;
-    const frontmatter = content.slice(3, end);
-    for (const line of frontmatter.split('\n')) {
-        const match = /^description:\s*(.+)$/.exec(line.trim());
-        if (match)
-            return match[1].trim().replace(/^['"]|['"]$/g, '');
-    }
-    return undefined;
-}
-async function syncResources(params) {
-    const startTime = Date.now();
-    const typedParams = params;
-    logger_1.logger.info({
-        tool: 'sync_resources',
-        params: typedParams,
-        timestamp: new Date().toISOString()
-    }, 'sync_resources tool invoked');
-    (0, logger_1.logToolStep)('sync_resources', 'Tool invocation started', { params: typedParams });
-    try {
-        const mode = typedParams.mode || 'incremental';
-        const scope = typedParams.scope || 'global';
-        const types = typedParams.types;
-        const userToken = typedParams.user_token;
-        const configuredMcpServers = new Set(typedParams.configured_mcp_servers || []);
-        (0, logger_1.logToolStep)('sync_resources', 'Parameters validated', {
-            mode,
-            scope,
-            types,
-            configuredMcpCount: configuredMcpServers.size,
-        });
-        // ── Step 1: Fetch subscription list ────────────────────────────────────
-        (0, logger_1.logToolStep)('sync_resources', 'Step 1: Fetching subscriptions from API', { scope, types });
-        const t1 = Date.now();
-        const subscriptions = await client_1.apiClient.getSubscriptions({ types }, userToken);
-        (0, logger_1.logToolStep)('sync_resources', 'Subscriptions fetched', {
-            total: subscriptions.total,
-            duration: Date.now() - t1,
-            ids: subscriptions.subscriptions.map(s => s.id),
-        });
-        // ── Step 2: Server-side Git sync (skip in check mode) ──────────────────
-        (0, logger_1.logToolStep)('sync_resources', 'Step 2: Server-side Git sync');
-        if (mode === 'check') {
-            const statuses = await multi_source_manager_1.multiSourceGitManager.checkAllSources();
-            (0, logger_1.logToolStep)('sync_resources', 'Repository status check completed', {
-                sources: statuses.map(s => ({ name: s.source, exists: s.exists, hasRemote: s.hasRemote })),
-            });
-        }
-        else {
-            const t2 = Date.now();
-            const gitResults = await multi_source_manager_1.multiSourceGitManager.syncAllSources();
-            (0, logger_1.logToolStep)('sync_resources', 'Server-side Git sync completed', {
-                duration: Date.now() - t2,
-                summary: {
-                    cloned: gitResults.filter(r => r.action === 'cloned').length,
-                    pulled: gitResults.filter(r => r.action === 'pulled').length,
-                    upToDate: gitResults.filter(r => r.action === 'up-to-date').length,
-                    skipped: gitResults.filter(r => r.action === 'skipped').length,
-                },
-            });
-        }
-        // ── Step 3: Download each subscribed resource ──────────────────────────
-        // Command / Skill  → registered as MCP Prompts on the server (no local I/O)
-        // Rule / MCP       → file content is returned as LocalAction instructions
-        //                    so that the AI Agent executes the writes on the user's
-        //                    LOCAL machine (not on this potentially remote server).
-        (0, logger_1.logToolStep)('sync_resources', 'Step 3: Processing subscribed resources', {
-            count: subscriptions.total,
-        });
-        const tally = { total: subscriptions.total, synced: 0, cached: 0, failed: 0 };
-        const details = [];
-        // Accumulated local file-system actions the AI must perform on the user's machine.
-        const localActions = [];
-        // Track which prompt names are expected from the current subscription list.
-        // After the loop, any prompt registered in PromptManager but NOT in this set
-        // is stale (from a previous connection / subscription change) and will be pruned.
-        const expectedPromptNames = new Set();
-        for (let i = 0; i < subscriptions.subscriptions.length; i++) {
-            const sub = subscriptions.subscriptions[i];
-            if (!sub)
-                continue;
-            // Safe access — `resource` metadata is only present when detail=true was requested.
-            const resourceVersion = sub.resource?.version ?? 'unknown';
-            (0, logger_1.logToolStep)('sync_resources', `Processing ${i + 1}/${tally.total}`, {
-                resourceId: sub.id,
-                resourceName: sub.name,
-                resourceType: sub.type,
-            });
-            try {
-                // Resolve the destination path inside the Cursor directory.
-                // getCursorResourcePath throws for unrecognised types, caught below.
-                const destPath = (0, cursor_paths_1.getCursorResourcePath)(sub.type, sub.name);
-                // In check mode: report whether the resource is already available.
-                // Command/Skill: check the in-memory Prompt registry (no local files).
-                // Rule/MCP: check whether the local file / mcp.json entry exists.
-                if (mode === 'check') {
-                    if (sub.type === 'command' || sub.type === 'skill') {
-                        const meta = {
-                            resource_id: sub.id,
-                            resource_type: sub.type,
-                            resource_name: sub.name,
-                            team: sub.team ?? 'general',
-                        };
-                        const isRegistered = index_js_2.promptManager.has(index_js_2.promptManager.buildPromptName(meta), userToken ?? '');
-                        if (isRegistered) {
-                            tally.cached++;
-                            details.push({ id: sub.id, name: sub.name, action: 'cached', version: resourceVersion });
-                        }
-                        else {
-                            tally.failed++;
-                            details.push({ id: sub.id, name: sub.name, action: 'failed', version: resourceVersion });
-                        }
-                    }
-                    else {
-                        try {
-                            await fs.access(destPath);
-                            tally.cached++;
-                            details.push({ id: sub.id, name: sub.name, action: 'cached', version: resourceVersion });
-                            (0, logger_1.logToolStep)('sync_resources', 'Resource already present (check mode)', {
-                                resourceId: sub.id, destPath,
-                            });
-                        }
-                        catch {
-                            tally.failed++;
-                            details.push({ id: sub.id, name: sub.name, action: 'failed', version: resourceVersion });
-                            (0, logger_1.logToolStep)('sync_resources', 'Resource missing (check mode)', {
-                                resourceId: sub.id, destPath,
-                            });
-                        }
-                    }
-                    continue;
-                }
-                // ── Command / Skill: MCP Prompt mode (no local file write) ──────────
-                // Download content → generate intermediate cache → register as MCP Prompt.
-                if (sub.type === 'command' || sub.type === 'skill') {
-                    (0, logger_1.logToolStep)('sync_resources', `Registering ${sub.type} as MCP Prompt`, {
-                        resourceId: sub.id,
-                        resourceName: sub.name,
-                    });
-                    try {
-                        const tDl = Date.now();
-                        const downloadResult = await client_1.apiClient.downloadResource(sub.id, userToken);
-                        (0, logger_1.logToolStep)('sync_resources', 'Download complete (Prompt mode)', {
-                            resourceId: sub.id,
-                            fileCount: downloadResult.files.length,
-                            duration: Date.now() - tDl,
-                        });
-                        // When the API returns no files (expected for Command/Skill in MCP Prompt
-                        // mode — content lives in the server-side git repo, not the API), fall back
-                        // to reading the files directly from the local git checkout.
-                        let sourceFiles = downloadResult.files;
-                        if (sourceFiles.length === 0) {
-                            sourceFiles = await multi_source_manager_1.multiSourceGitManager.readResourceFiles(sub.name, sub.type);
-                            if (sourceFiles.length > 0) {
-                                (0, logger_1.logToolStep)('sync_resources', 'Loaded resource files from local git checkout', {
-                                    resourceId: sub.id,
-                                    fileCount: sourceFiles.length,
-                                });
-                            }
-                            else {
-                                logger_1.logger.warn({ resourceId: sub.id, resourceName: sub.name }, 'No files found via API or local git — prompt will have empty content');
-                            }
-                        }
-                        // Primary Markdown content selection:
-                        //   - skill: prefer SKILL.md (canonical entrypoint for all skill content)
-                        //   - command: prefer the file whose name matches the resource name
-                        //   - fallback: first .md file, then first file of any type
-                        const isSkill = sub.type === 'skill';
-                        const primaryFile = isSkill
-                            ? (sourceFiles.find((f) => path.basename(f.path) === 'SKILL.md') ??
-                                sourceFiles.find((f) => f.path.endsWith('.md')) ??
-                                sourceFiles[0])
-                            : (sourceFiles.find((f) => path.basename(f.path).replace(/\.md$/, '') === sub.name) ??
-                                sourceFiles.find((f) => f.path.endsWith('.md')) ??
-                                sourceFiles[0]);
-                        const rawContent = primaryFile?.content ?? '';
-                        // Extract description from frontmatter (---\ndescription: ...\n---)
-                        // falling back to the subscription's description field or resource name.
-                        const frontmatterDesc = extractFrontmatterDescription(rawContent);
-                        const description = frontmatterDesc ??
-                            sub.description ??
-                            sub.name;
-                        const meta = {
-                            resource_id: sub.id,
-                            resource_type: sub.type,
-                            resource_name: sub.name,
-                            team: sub.team ?? 'general',
-                            description,
-                            rawContent,
-                        };
-                        // userToken is required so the prompt is scoped to this user's namespace.
-                        const effectiveToken = userToken ?? '';
-                        await index_js_2.promptManager.registerPrompt(meta, effectiveToken);
-                        // Track this prompt name so stale prompts can be pruned after the loop.
-                        expectedPromptNames.add(index_js_2.promptManager.buildPromptName(meta));
-                        // Clean up any legacy local files that may have been written by an
-                        // older version of sync_resources.  Command/Skill resources are now
-                        // served exclusively as MCP Prompts; stale local files would cause
-                        // the AI to read outdated content (without the track_usage header).
-                        try {
-                            const legacyPath = (0, cursor_paths_1.getCursorResourcePath)(sub.type, `${sub.name}.md`);
-                            await fs.unlink(legacyPath);
-                            logger_1.logger.info({ resourceId: sub.id, legacyPath }, 'Removed legacy local file for Command/Skill resource');
-                        }
-                        catch {
-                            // File didn't exist — nothing to clean up.
-                        }
-                        tally.synced++;
-                        details.push({ id: sub.id, name: sub.name, action: 'synced', version: resourceVersion });
-                        (0, logger_1.logToolStep)('sync_resources', `${sub.type} registered as MCP Prompt`, {
-                            resourceId: sub.id,
-                            promptCount: index_js_2.promptManager.sizeFor(userToken ?? ''),
-                        });
-                    }
-                    catch (promptErr) {
-                        logger_1.logger.error({ resourceId: sub.id, error: promptErr.message }, 'Failed to register Command/Skill as MCP Prompt');
-                        tally.failed++;
-                        details.push({ id: sub.id, name: sub.name, action: 'failed', version: resourceVersion });
-                    }
-                    continue;
-                }
-                // ── Download (with server-session cache) ─────────────────────────────
-                // The download cache avoids redundant API calls when the same resource
-                // is synced multiple times within one server session without any content
-                // change.  It ONLY caches the network response; LocalAction generation
-                // always proceeds so that users can recover deleted local files by
-                // re-running sync — even when the resource content is unchanged.
-                const cacheKey = syncCacheKey(userToken ?? '', sub.id);
-                let downloadResult;
-                const cached = downloadCache.get(cacheKey);
-                if (mode === 'incremental' && cached) {
-                    // Reuse the previously downloaded content without hitting the API.
-                    // full mode always bypasses this branch to guarantee a fresh download.
-                    downloadResult = cached;
-                    (0, logger_1.logToolStep)('sync_resources', 'Using cached download (no API call)', {
-                        resourceId: sub.id,
-                        cachedHash: cached.hash,
-                    });
-                }
-                else {
-                    (0, logger_1.logToolStep)('sync_resources', 'Downloading resource', {
-                        resourceId: sub.id,
-                        resourceType: sub.type,
-                    });
-                    const tDl = Date.now();
-                    const apiResult = await client_1.apiClient.downloadResource(sub.id, userToken);
-                    (0, logger_1.logToolStep)('sync_resources', 'Download complete', {
-                        resourceId: sub.id,
-                        fileCount: apiResult.files.length,
-                        duration: Date.now() - tDl,
-                    });
-                    downloadResult = { hash: apiResult.hash, files: apiResult.files };
-                    // Refresh cache with the latest download.
-                    downloadCache.set(cacheKey, downloadResult);
-                }
-                // When the API returns no files (expected when the MCP server is deployed
-                // remotely and content lives in the server-side git repo), fall back to
-                // reading the files directly from the local git checkout.
-                let resourceFiles = downloadResult.files;
-                if (resourceFiles.length === 0) {
-                    logger_1.logger.info({ resourceId: sub.id, resourceName: sub.name, type: sub.type }, 'sync_resources: API returned no files — triggering git-checkout fallback');
-                    const gitType = sub.type;
-                    const gitFiles = await multi_source_manager_1.multiSourceGitManager.readResourceFiles(sub.name, gitType);
-                    if (gitFiles.length > 0) {
-                        resourceFiles = gitFiles;
-                        logger_1.logger.info({
-                            resourceId: sub.id,
-                            resourceName: sub.name,
-                            type: sub.type,
-                            fileCount: resourceFiles.length,
-                            files: resourceFiles.map((f) => f.path),
-                        }, 'sync_resources: git-checkout fallback succeeded');
-                        (0, logger_1.logToolStep)('sync_resources', 'Loaded resource files from local git checkout', {
-                            resourceId: sub.id,
-                            fileCount: resourceFiles.length,
-                        });
-                    }
-                    else {
-                        logger_1.logger.warn({ resourceId: sub.id, resourceName: sub.name, type: sub.type }, 'sync_resources: git-checkout fallback found no files — marking resource failed');
-                        tally.failed++;
-                        details.push({ id: sub.id, name: sub.name, action: 'failed', version: resourceVersion });
-                        continue;
-                    }
-                }
-                // ── MCP resource ──────────────────────────────────────────────────────
-                // Read mcp-config.json to determine Format A (local executable, has
-                // "command" field) vs Format B (remote URL map, no "command" field).
-                //
-                // IMPORTANT: all paths in LocalAction instructions must use the CLIENT-side
-                // helper (tilde-based) so they resolve correctly on the user's machine,
-                // not on this (possibly remote Linux) server.
-                if (sub.type === 'mcp') {
-                    const mcpConfigFile = resourceFiles.find((f) => path.basename(f.path) === 'mcp-config.json');
-                    // ~/.cursor/mcp.json on the user's machine
-                    const mcpJsonPath = `${(0, cursor_paths_1.getCursorRootDirForClient)()}/mcp.json`;
-                    // ── Optimization: skip if already configured (incremental mode only) ────
-                    // In incremental mode, if the AI Agent reports this MCP server is already
-                    // in ~/.cursor/mcp.json, skip downloading and generating write_file actions.
-                    // This reduces API calls, network traffic, and AI Agent execution overhead.
-                    // In full mode, always proceed to allow file recovery.
-                    if (mode === 'incremental' && mcpConfigFile) {
-                        let cfg = {};
-                        try {
-                            cfg = JSON.parse(mcpConfigFile.content);
-                        }
-                        catch { /* ignore parse errors, proceed to download */ }
-                        // Format A: check if the single server is configured
-                        if (typeof cfg['command'] === 'string') {
-                            const serverName = cfg['name'] ?? sub.name;
-                            if (configuredMcpServers.has(serverName)) {
-                                logger_1.logger.info({ resourceId: sub.id, resourceName: sub.name, serverName }, 'sync_resources: MCP server already configured — skipping download');
-                                tally.cached++;
-                                details.push({ id: sub.id, name: sub.name, action: 'cached', version: resourceVersion });
-                                continue;
-                            }
-                        }
-                        // Format B: check if all servers in the map are configured
-                        else if (Object.keys(cfg).length > 0) {
-                            const allConfigured = Object.keys(cfg).every((k) => configuredMcpServers.has(k));
-                            if (allConfigured) {
-                                logger_1.logger.info({ resourceId: sub.id, resourceName: sub.name, serverKeys: Object.keys(cfg) }, 'sync_resources: All MCP servers already configured — skipping download');
-                                tally.cached++;
-                                details.push({ id: sub.id, name: sub.name, action: 'cached', version: resourceVersion });
-                                continue;
-                            }
-                        }
-                    }
-                    logger_1.logger.info({
-                        resourceId: sub.id,
-                        resourceName: sub.name,
-                        mcpJsonPath,
-                        hasMcpConfigFile: !!mcpConfigFile,
-                        availableFiles: resourceFiles.map((f) => f.path),
-                    }, 'sync_resources: processing MCP resource');
-                    if (mcpConfigFile) {
-                        let cfg = {};
-                        try {
-                            cfg = JSON.parse(mcpConfigFile.content);
-                        }
-                        catch {
-                            logger_1.logger.warn({ resourceId: sub.id, resourceName: sub.name }, 'sync_resources: failed to parse mcp-config.json — treating as empty config');
-                        }
-                        if (typeof cfg['command'] === 'string') {
-                            // ── Format A: local executable ──────────────────────────────────
-                            const installDir = `${(0, cursor_paths_1.getCursorTypeDirForClient)('mcp')}/${sub.name}`;
-                            const writeActions = [];
-                            for (const file of resourceFiles) {
-                                const normalised = path.normalize(file.path);
-                                if (normalised.startsWith('..'))
-                                    continue;
-                                const fileDest = `${installDir}/${normalised}`;
-                                localActions.push({
-                                    action: 'write_file',
-                                    path: fileDest,
-                                    content: file.content,
-                                });
-                                writeActions.push(fileDest);
-                            }
-                            const env = (cfg['env'] ?? {});
-                            const missingEnv = Object.entries(env).filter(([, v]) => v === '').map(([k]) => k);
-                            const looksLikePath = (a) => a.startsWith('./') || a.startsWith('../') || a.includes('/') || /\.\w+$/.test(a);
-                            const args = (cfg['args'] ?? []).map((a) => path.isAbsolute(a) || !looksLikePath(a) ? a : `${installDir}/${a.replace(/^\.\//, '')}`);
-                            const serverName = cfg['name'] ?? sub.name;
-                            localActions.push({
-                                action: 'merge_mcp_json',
-                                mcp_json_path: mcpJsonPath,
-                                server_name: serverName,
-                                entry: { ...cfg, args },
-                                // skip_if_exists: preserve user-edited env values; the entry
-                                // is already configured if the key exists in mcp.json.
-                                skip_if_exists: true,
-                                ...(missingEnv.length > 0 ? {
-                                    missing_env: missingEnv,
-                                    setup_hint: `Fill in env vars in ${mcpJsonPath} under mcpServers["${sub.name}"]: ${missingEnv.join(', ')}.`,
-                                } : {}),
-                            });
-                            logger_1.logger.info({
-                                resourceId: sub.id,
-                                resourceName: sub.name,
-                                format: 'A',
-                                installDir,
-                                mcpJsonPath,
-                                serverName,
-                                writeFiles: writeActions,
-                                missingEnv,
-                            }, 'sync_resources: MCP Format A — write_file + merge_mcp_json actions queued');
-                            (0, logger_1.logToolStep)('sync_resources', 'Local-executable MCP: write_file + merge_mcp_json queued', { resourceId: sub.id });
-                        }
-                        else {
-                            // ── Format B: remote URL map ────────────────────────────────────
-                            const queuedServers = [];
-                            for (const [serverName, entry] of Object.entries(cfg)) {
-                                const e = entry;
-                                const env = (e['env'] ?? {});
-                                const missingEnv = Object.entries(env).filter(([, v]) => v === '').map(([k]) => k);
-                                localActions.push({
-                                    action: 'merge_mcp_json',
-                                    mcp_json_path: mcpJsonPath,
-                                    server_name: serverName,
-                                    entry: e,
-                                    // skip_if_exists: user may have customised env values; do
-                                    // not overwrite an existing entry on every incremental sync.
-                                    skip_if_exists: true,
-                                    ...(missingEnv.length > 0 ? {
-                                        missing_env: missingEnv,
-                                        setup_hint: `Fill in env vars in ${mcpJsonPath} under mcpServers["${serverName}"]: ${missingEnv.join(', ')}.`,
-                                    } : {}),
-                                });
-                                queuedServers.push(serverName);
-                            }
-                            logger_1.logger.info({
-                                resourceId: sub.id,
-                                resourceName: sub.name,
-                                format: 'B',
-                                mcpJsonPath,
-                                serverKeys: queuedServers,
-                            }, 'sync_resources: MCP Format B — merge_mcp_json actions queued');
-                            (0, logger_1.logToolStep)('sync_resources', 'Remote-URL MCP: merge_mcp_json queued', {
-                                resourceId: sub.id, serverKeys: Object.keys(cfg),
-                            });
-                        }
-                    }
-                    else {
-                        // No mcp-config.json: heuristic fallback
-                        const installDir = `${(0, cursor_paths_1.getCursorTypeDirForClient)('mcp')}/${sub.name}`;
-                        const writeActions = [];
-                        for (const file of resourceFiles) {
-                            const normalised = path.normalize(file.path);
-                            if (normalised.startsWith('..'))
-                                continue;
-                            const fileDest = `${installDir}/${normalised}`;
-                            localActions.push({
-                                action: 'write_file',
-                                path: fileDest,
-                                content: file.content,
-                            });
-                            writeActions.push(fileDest);
-                        }
-                        const jsEntry = resourceFiles.find((f) => f.path.endsWith('.js'));
-                        const pyEntry = resourceFiles.find((f) => f.path.endsWith('.py'));
-                        const entryFile = jsEntry ?? pyEntry ?? resourceFiles[0];
-                        const cmd = jsEntry ? 'node' : 'python3';
-                        const entryPath = `${installDir}/${entryFile?.path ?? ''}`;
-                        localActions.push({
-                            action: 'merge_mcp_json',
-                            mcp_json_path: mcpJsonPath,
-                            server_name: sub.name,
-                            entry: { command: cmd, args: [entryPath] },
-                            skip_if_exists: true,
-                        });
-                        logger_1.logger.info({
-                            resourceId: sub.id,
-                            resourceName: sub.name,
-                            format: 'heuristic',
-                            installDir,
-                            mcpJsonPath,
-                            cmd,
-                            entryPath,
-                            writeFiles: writeActions,
-                        }, 'sync_resources: MCP heuristic fallback — write_file + merge_mcp_json actions queued');
-                        (0, logger_1.logToolStep)('sync_resources', 'MCP heuristic fallback: write_file + merge_mcp_json queued', { resourceId: sub.id });
-                    }
-                    tally.synced++;
-                    details.push({ id: sub.id, name: sub.name, action: 'synced', version: resourceVersion });
-                    continue;
-                }
-                // ── Rule resource ─────────────────────────────────────────────────────
-                // Return write_file actions; the AI Agent executes them on the user's
-                // LOCAL machine. The AI compares file content directly (string equality)
-                // against the existing local file and skips the write when content is
-                // identical — avoiding unnecessary disk I/O. If the local file is missing
-                // or has different content, the AI writes it unconditionally, which also
-                // recovers files that were accidentally deleted by the user.
-                if (sub.type === 'rule') {
-                    const typeDir = (0, cursor_paths_1.getCursorTypeDirForClient)(sub.type);
-                    const writeActions = [];
-                    for (const file of resourceFiles) {
-                        const normalised = path.normalize(file.path);
-                        if (normalised.startsWith('..')) {
-                            logger_1.logger.warn({ resourceId: sub.id, filePath: file.path }, 'Skipping suspicious file path');
-                            continue;
-                        }
-                        const destPath = `${typeDir}/${normalised}`;
-                        localActions.push({
-                            action: 'write_file',
-                            path: destPath,
-                            content: file.content,
-                        });
-                        writeActions.push({ destPath, contentLength: file.content.length });
-                    }
-                    logger_1.logger.info({
-                        resourceId: sub.id,
-                        resourceName: sub.name,
-                        typeDir,
-                        fileCount: writeActions.length,
-                        files: writeActions,
-                        clientSideNote: 'AI will compare file content directly; write is skipped if content is identical',
-                    }, 'sync_resources: Rule — write_file actions queued for AI (client-side content comparison)');
-                    tally.synced++;
-                    details.push({ id: sub.id, name: sub.name, action: 'synced', version: resourceVersion });
-                    (0, logger_1.logToolStep)('sync_resources', 'Rule: write_file actions queued for AI', {
-                        resourceId: sub.id,
-                        fileCount: resourceFiles.length,
-                    });
-                    continue;
-                }
-                // Fallback for any unrecognised types (should not happen in practice).
-                logger_1.logger.warn({ resourceId: sub.id, type: sub.type }, 'Unrecognised resource type — skipping');
-                tally.failed++;
-                details.push({ id: sub.id, name: sub.name, action: 'failed', version: resourceVersion });
-            }
-            catch (error) {
-                logger_1.logger.error({
-                    resourceId: sub.id,
-                    resourceName: sub.name,
-                    error: error instanceof Error ? error.message : String(error),
-                }, 'Failed to sync resource');
-                tally.failed++;
-                details.push({ id: sub.id, name: sub.name, action: 'failed', version: sub.resource?.version ?? 'unknown' });
-            }
-        }
-        // ── Step 4: Prune stale prompts ────────────────────────────────────────
-        // Remove any prompt registered in a previous session that is no longer in
-        // the current subscription list.  This prevents prompt count from growing
-        // unboundedly across reconnections.
-        // In 'check' mode we skip pruning — we never registered any prompts above.
-        if (mode !== 'check') {
-            index_js_2.promptManager.pruneStalePrompts(expectedPromptNames, userToken ?? '');
-        }
-        // ── Step 5: Health score ───────────────────────────────────────────────
-        const healthScore = tally.total > 0
-            ? Math.round(((tally.synced + tally.cached) / tally.total) * 100)
-            : 100;
-        const result = {
-            mode,
-            health_score: healthScore,
-            summary: tally,
-            details,
-            ...(localActions.length > 0 ? { local_actions_required: localActions } : {}),
-        };
-        const duration = Date.now() - startTime;
-        (0, logger_1.logToolCall)('sync_resources', 'user-id', params, duration);
-        (0, logger_1.logToolResult)('sync_resources', true, result);
-        logger_1.logger.info({
-            tool: 'sync_resources',
-            mode,
-            total: tally.total,
-            synced: tally.synced,
-            cached: tally.cached,
-            failed: tally.failed,
-            healthScore,
-            duration,
-            timestamp: new Date().toISOString()
-        }, 'sync_resources completed successfully');
-        // Update telemetry snapshot lists (fire-and-forget).
-        // Rules: cannot track individual invocations; report subscription list only.
-        const subscribedRules = subscriptions.subscriptions
-            .filter((s) => s.type === 'rule')
-            .map((s) => ({
-            resource_id: s.id,
-            resource_name: s.name,
-            subscribed_at: s.subscribed_at ?? new Date().toISOString(),
-        }));
-        if (userToken)
-            index_js_1.telemetry.updateSubscribedRules(subscribedRules, userToken).catch(() => { });
-        // MCPs: individual invocation tracking is each MCP server's own responsibility.
-        const configuredMcps = subscriptions.subscriptions
-            .filter((s) => s.type === 'mcp')
-            .map((s) => ({
-            resource_id: s.id,
-            resource_name: s.name,
-            configured_at: s.subscribed_at ?? new Date().toISOString(),
-        }));
-        if (userToken)
-            index_js_1.telemetry.updateConfiguredMcps(configuredMcps, userToken).catch(() => { });
-        return { success: true, data: result };
-    }
-    catch (error) {
-        const duration = Date.now() - startTime;
-        logger_1.logger.error({
-            tool: 'sync_resources',
-            error: error instanceof Error
-                ? { message: error.message, stack: error.stack, name: error.name }
-                : String(error),
-            duration,
-            timestamp: new Date().toISOString()
-        }, 'sync_resources failed with error');
-        (0, logger_1.logToolResult)('sync_resources', false, undefined, error instanceof Error ? error : new Error(String(error)));
-        return {
-            success: false,
-            error: {
-                code: error instanceof errors_1.MCPServerError ? error.code : 'UNKNOWN_ERROR',
-                message: error instanceof Error ? error.message : String(error),
-            },
-        };
-    }
-}
-// Tool definition for registry
-exports.syncResourcesTool = {
-    name: 'sync_resources',
-    description: 'Synchronize subscribed AI resources. ' +
-        'Command and Skill resources are registered as MCP Prompts on the server. ' +
-        'Rule and MCP resources are returned as `local_actions_required` — an ordered list of ' +
-        'write_file, merge_mcp_json, or other actions that the AI Agent MUST execute on the ' +
-        'USER\'S LOCAL MACHINE after receiving the response. ' +
-        'Execute every action in the list in order before reporting success to the user. ' +
-        'OPTIMIZATION: Before calling this tool in incremental mode, read ~/.cursor/mcp.json ' +
-        'and pass Object.keys(mcpServers || {}) as `configured_mcp_servers` parameter. ' +
-        'This allows the server to skip downloading MCP resources that are already configured, ' +
-        'significantly reducing API calls, network traffic, and local action overhead. ' +
-        'For write_file actions: ' +
-        '  (1) Read the existing file at `path` (if it exists) using fs.readFile() or equivalent. ' +
-        '  (2) Compare the file content directly (string equality) against the `content` field. ' +
-        '  (3) SKIP the write if they are EXACTLY equal — the file is already up-to-date. ' +
-        '  (4) Otherwise, create any missing parent directories and write the file. ' +
-        'For merge_mcp_json actions: ' +
-        '  (1) If the action has `skip_if_exists: true` AND `mcpServers[server_name]` already exists ' +
-        '      in ~/.cursor/mcp.json, SKIP this action entirely — the server is already configured ' +
-        '      and any user-edited env values must not be overwritten. ' +
-        '  (2) Otherwise read the existing ~/.cursor/mcp.json, smart-merge the provided entry ' +
-        '      (preserve existing user env values), then write the file back.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            mode: {
-                type: 'string',
-                description: 'Sync mode: check (status only), incremental (updates only), full (all)',
-                enum: ['check', 'incremental', 'full'],
-                default: 'incremental',
-            },
-            scope: {
-                type: 'string',
-                description: 'Installation scope: global (~/.cursor/), workspace (.cursor/), or all',
-                enum: ['global', 'workspace', 'all'],
-                default: 'global',
-            },
-            types: {
-                type: 'array',
-                description: 'Filter by resource types (empty = all types)',
-            },
-            user_token: {
-                type: 'string',
-                description: 'DO NOT set this field — it is automatically injected by the MCP server from ' +
-                    'the authenticated SSE connection. The server always provides the correct token.',
-            },
-            configured_mcp_servers: {
-                type: 'array',
-                description: 'List of MCP server names already configured in ~/.cursor/mcp.json. ' +
-                    'In incremental mode, the server skips downloading these MCP resources to reduce overhead. ' +
-                    'To populate this: read ~/.cursor/mcp.json and extract Object.keys(mcpServers || {}). ' +
-                    'Example: ["github", "gitlab", "postgres"]. Ignored in full mode (always downloads).',
-            },
-        },
-    },
-    handler: syncResources,
-};
-//# sourceMappingURL=sync-resources.js.map