@elliotding/ai-agent-mcp 0.1.3 → 0.1.4

package/dist/prompts/cache.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * PromptCache: manages the .prompt-cache/ directory inside the MCP Server's
+ * runtime working directory.
+ *
+ * Cache files hold the fully-expanded Prompt content for each Command/Skill
+ * resource so that the MCP Prompt handler can serve them without re-generating
+ * on every invocation.
+ *
+ * The cache directory is intentionally NOT committed to Git — it is regenerated
+ * from the canonical source files after every git pull or resource upload.
+ *
+ * File naming: {type}-{resource_id}.md
+ *   e.g.  cmd-client-sdk-generate-testcase.md
+ *         skill-client-sdk-analyze-sdk-log.md
+ */
+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.promptCache = exports.PromptCache = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_js_1 = require("../utils/logger.js");
+/** Relative directory name inside the MCP Server CWD for cached Prompt files. */
+const CACHE_DIR_NAME = '.prompt-cache';
+class PromptCache {
+    cacheDir;
+    /**
+     * @param baseDir  Absolute base directory (defaults to process.cwd()).
+     */
+    constructor(baseDir = process.cwd()) {
+        this.cacheDir = path.join(baseDir, CACHE_DIR_NAME);
+    }
+    /** Absolute path to the cache directory. */
+    get directory() {
+        return this.cacheDir;
+    }
+    /** Ensure the cache directory exists (idempotent). */
+    ensureDir() {
+        fs.mkdirSync(this.cacheDir, { recursive: true });
+    }
+    /**
+     * Derive the cache file name for a resource.
+     * @param resourceType  'command' | 'skill'
+     * @param resourceId    Canonical resource ID
+     */
+    cacheFileName(resourceType, resourceId) {
+        // Normalise type prefix: 'command' → 'cmd', 'skill' → 'skill'
+        const prefix = resourceType === 'command' ? 'cmd' : resourceType;
+        // Sanitise resourceId — remove characters unsafe in filenames.
+        const safeId = resourceId.replace(/[/\\:*?"<>|]/g, '-');
+        return `${prefix}-${safeId}.md`;
+    }
+    /** Absolute path to the cache file for a given resource. */
+    cachePath(resourceType, resourceId) {
+        return path.join(this.cacheDir, this.cacheFileName(resourceType, resourceId));
+    }
+    /**
+     * Write (or overwrite) a resource's Prompt content to the cache.
+     * Uses atomic write-then-rename to prevent partial reads.
+     *
+     * @param resourceType  'command' | 'skill'
+     * @param resourceId    Canonical resource ID
+     * @param content       Fully-expanded Prompt Markdown content
+     */
+    write(resourceType, resourceId, content) {
+        this.ensureDir();
+        const dest = this.cachePath(resourceType, resourceId);
+        const tmp = `${dest}.${process.pid}.tmp`;
+        try {
+            fs.writeFileSync(tmp, content, 'utf8');
+            fs.renameSync(tmp, dest);
+            logger_js_1.logger.debug({ resourceId, resourceType, path: dest }, 'Prompt cache written');
+        }
+        catch (err) {
+            // Best-effort cleanup of temp file
+            try {
+                fs.unlinkSync(tmp);
+            }
+            catch { /* ignore */ }
+            throw new Error(`Failed to write prompt cache for ${resourceId}: ${err.message}`);
+        }
+    }
+    /**
+     * Read the cached Prompt content for a resource.
+     * Returns null if the cache file does not exist or cannot be read.
+     *
+     * @param resourceType  'command' | 'skill'
+     * @param resourceId    Canonical resource ID
+     */
+    read(resourceType, resourceId) {
+        const p = this.cachePath(resourceType, resourceId);
+        try {
+            return fs.readFileSync(p, 'utf8');
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Delete the cache file for a resource.
+     * Silently succeeds if the file does not exist.
+     *
+     * @param resourceType  'command' | 'skill'
+     * @param resourceId    Canonical resource ID
+     */
+    delete(resourceType, resourceId) {
+        const p = this.cachePath(resourceType, resourceId);
+        try {
+            fs.unlinkSync(p);
+            logger_js_1.logger.debug({ resourceId, resourceType }, 'Prompt cache deleted');
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                logger_js_1.logger.warn({ resourceId, error: err.message }, 'Failed to delete prompt cache file');
+            }
+        }
+    }
+    /**
+     * Check whether a valid cache entry exists for a resource.
+     *
+     * @param resourceType  'command' | 'skill'
+     * @param resourceId    Canonical resource ID
+     */
+    exists(resourceType, resourceId) {
+        return fs.existsSync(this.cachePath(resourceType, resourceId));
+    }
+}
+exports.PromptCache = PromptCache;
+/** Singleton cache instance using the process CWD as the base directory. */
+exports.promptCache = new PromptCache();
+//# sourceMappingURL=cache.js.map

package/dist/prompts/cache.js.map

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

package/dist/prompts/generator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * PromptGenerator: converts raw Command/Skill Markdown assets into MCP Prompt content.
+ *
+ * Two-step pipeline:
+ *  1. parseMarkdownWithImports — recursively inline `import 'path'` directives.
+ *  2. replaceMDVariables       — substitute ${VAR} placeholders with runtime values.
+ *
+ * The resulting string is returned to the caller who can pass it directly as
+ * the MCP Prompt message text, or write it to the .prompt-cache/ directory.
+ */
+/**
+ * Recursively resolve and inline all `import 'path'` statements in a Markdown
+ * file.  Each imported file's content replaces its import statement in the
+ * parent document.
+ *
+ * @param filePath  Absolute path to the root Markdown file.
+ * @param depth     Current recursion depth (used for cycle detection).
+ * @returns         Fully expanded Markdown string.
+ */
+export declare function parseMarkdownWithImports(filePath: string, depth?: number): Promise<string>;
+/**
+ * Replace ${VARIABLE_NAME} placeholders in content with values from the
+ * provided variable map.  Variables not found in the map are left unchanged so
+ * they remain visible in the output for debugging.
+ *
+ * @param content   Markdown string (after import expansion).
+ * @param variables Key-value map of variable names to their replacement strings.
+ * @returns         Content with placeholders substituted.
+ */
+export declare function replaceMDVariables(content: string, variables: Record<string, string>): string;
+/**
+ * High-level entry point: expand imports then substitute variables.
+ *
+ * @param filePath  Absolute path to the root Markdown file.
+ * @param variables Optional variable substitution map (defaults to empty).
+ * @returns         Final Prompt content ready for MCP registration.
+ */
+export declare function generatePromptContent(filePath: string, variables?: Record<string, string>): Promise<string>;
+/**
+ * Generate Prompt content from a raw Markdown string (no file I/O).
+ * Used when the resource content has already been downloaded from the API.
+ *
+ * @param rawContent Raw Markdown string.
+ * @param basePath   Absolute directory used to resolve relative `import` paths.
+ * @param variables  Optional variable substitution map.
+ * @returns          Final Prompt content.
+ */
+export declare function generatePromptContentFromString(rawContent: string, basePath: string, variables?: Record<string, string>): Promise<string>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/prompts/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/prompts/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAOR;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/prompts/generator.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * PromptGenerator: converts raw Command/Skill Markdown assets into MCP Prompt content.
+ *
+ * Two-step pipeline:
+ *  1. parseMarkdownWithImports — recursively inline `import 'path'` directives.
+ *  2. replaceMDVariables       — substitute ${VAR} placeholders with runtime values.
+ *
+ * The resulting string is returned to the caller who can pass it directly as
+ * the MCP Prompt message text, or write it to the .prompt-cache/ directory.
+ */
+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.parseMarkdownWithImports = parseMarkdownWithImports;
+exports.replaceMDVariables = replaceMDVariables;
+exports.generatePromptContent = generatePromptContent;
+exports.generatePromptContentFromString = generatePromptContentFromString;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_js_1 = require("../utils/logger.js");
+// Maximum import recursion depth to guard against circular imports.
+const MAX_IMPORT_DEPTH = 20;
+// Matches lines like:  import 'relative/path/to/file.md'
+const IMPORT_REGEX = /^import\s+['"]([^'"]+)['"]\s*$/gm;
+/**
+ * Recursively resolve and inline all `import 'path'` statements in a Markdown
+ * file.  Each imported file's content replaces its import statement in the
+ * parent document.
+ *
+ * @param filePath  Absolute path to the root Markdown file.
+ * @param depth     Current recursion depth (used for cycle detection).
+ * @returns         Fully expanded Markdown string.
+ */
+async function parseMarkdownWithImports(filePath, depth = 0) {
+    if (depth > MAX_IMPORT_DEPTH) {
+        throw new Error(`Import depth exceeded ${MAX_IMPORT_DEPTH} levels at ${filePath}. ` +
+            'Check for circular imports.');
+    }
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read Markdown file: ${filePath} — ${err.message}`);
+    }
+    const fileDir = path.dirname(filePath);
+    const matches = [];
+    let match;
+    // Reset lastIndex before each exec loop (regex is stateful with 'g' flag).
+    IMPORT_REGEX.lastIndex = 0;
+    while ((match = IMPORT_REGEX.exec(content)) !== null) {
+        const importPath = match[1];
+        if (importPath) {
+            matches.push({
+                statement: match[0],
+                resolvedPath: path.resolve(fileDir, importPath),
+            });
+        }
+    }
+    // Process imports sequentially to preserve insertion order.
+    for (const { statement, resolvedPath } of matches) {
+        try {
+            const importedContent = await parseMarkdownWithImports(resolvedPath, depth + 1);
+            content = content.replace(statement, importedContent);
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ importPath: resolvedPath, parentFile: filePath, error: err.message }, 'Failed to resolve import — leaving placeholder in place');
+        }
+    }
+    return content;
+}
+/**
+ * Replace ${VARIABLE_NAME} placeholders in content with values from the
+ * provided variable map.  Variables not found in the map are left unchanged so
+ * they remain visible in the output for debugging.
+ *
+ * @param content   Markdown string (after import expansion).
+ * @param variables Key-value map of variable names to their replacement strings.
+ * @returns         Content with placeholders substituted.
+ */
+function replaceMDVariables(content, variables) {
+    let result = content;
+    for (const [key, value] of Object.entries(variables)) {
+        const regex = new RegExp(`\\$\\{${key}\\}`, 'g');
+        result = result.replace(regex, value);
+    }
+    return result;
+}
+/**
+ * High-level entry point: expand imports then substitute variables.
+ *
+ * @param filePath  Absolute path to the root Markdown file.
+ * @param variables Optional variable substitution map (defaults to empty).
+ * @returns         Final Prompt content ready for MCP registration.
+ */
+async function generatePromptContent(filePath, variables = {}) {
+    const expanded = await parseMarkdownWithImports(filePath);
+    return replaceMDVariables(expanded, variables);
+}
+/**
+ * Generate Prompt content from a raw Markdown string (no file I/O).
+ * Used when the resource content has already been downloaded from the API.
+ *
+ * @param rawContent Raw Markdown string.
+ * @param basePath   Absolute directory used to resolve relative `import` paths.
+ * @param variables  Optional variable substitution map.
+ * @returns          Final Prompt content.
+ */
+async function generatePromptContentFromString(rawContent, basePath, variables = {}) {
+    // Write to a temp file so parseMarkdownWithImports can resolve relative imports.
+    const tmpPath = path.join(basePath, `.tmp-prompt-${Date.now()}-${process.pid}.md`);
+    let result;
+    try {
+        fs.mkdirSync(basePath, { recursive: true });
+        fs.writeFileSync(tmpPath, rawContent, 'utf8');
+        result = await parseMarkdownWithImports(tmpPath);
+    }
+    finally {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { /* best-effort cleanup */ }
+    }
+    return replaceMDVariables(result, variables);
+}
+//# sourceMappingURL=generator.js.map

package/dist/prompts/generator.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * prompts module — public API
+ *
+ * Exports:
+ *  - PromptGenerator utilities (parseMarkdownWithImports, replaceMDVariables,
+ *    generatePromptContent, generatePromptContentFromString)
+ *  - PromptCache class and the shared singleton `promptCache`
+ *  - PromptManager class and the shared singleton `promptManager`
+ */
+export { parseMarkdownWithImports, replaceMDVariables, generatePromptContent, generatePromptContentFromString, } from './generator.js';
+export { PromptCache, promptCache } from './cache.js';
+export { PromptManager, promptManager } from './manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,+BAA+B,GAChC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * prompts module — public API
+ *
+ * Exports:
+ *  - PromptGenerator utilities (parseMarkdownWithImports, replaceMDVariables,
+ *    generatePromptContent, generatePromptContentFromString)
+ *  - PromptCache class and the shared singleton `promptCache`
+ *  - PromptManager class and the shared singleton `promptManager`
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptManager = exports.PromptManager = exports.promptCache = exports.PromptCache = exports.generatePromptContentFromString = exports.generatePromptContent = exports.replaceMDVariables = exports.parseMarkdownWithImports = void 0;
+var generator_js_1 = require("./generator.js");
+Object.defineProperty(exports, "parseMarkdownWithImports", { enumerable: true, get: function () { return generator_js_1.parseMarkdownWithImports; } });
+Object.defineProperty(exports, "replaceMDVariables", { enumerable: true, get: function () { return generator_js_1.replaceMDVariables; } });
+Object.defineProperty(exports, "generatePromptContent", { enumerable: true, get: function () { return generator_js_1.generatePromptContent; } });
+Object.defineProperty(exports, "generatePromptContentFromString", { enumerable: true, get: function () { return generator_js_1.generatePromptContentFromString; } });
+var cache_js_1 = require("./cache.js");
+Object.defineProperty(exports, "PromptCache", { enumerable: true, get: function () { return cache_js_1.PromptCache; } });
+Object.defineProperty(exports, "promptCache", { enumerable: true, get: function () { return cache_js_1.promptCache; } });
+var manager_js_1 = require("./manager.js");
+Object.defineProperty(exports, "PromptManager", { enumerable: true, get: function () { return manager_js_1.PromptManager; } });
+Object.defineProperty(exports, "promptManager", { enumerable: true, get: function () { return manager_js_1.promptManager; } });
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+CAKwB;AAJtB,wHAAA,wBAAwB,OAAA;AACxB,kHAAA,kBAAkB,OAAA;AAClB,qHAAA,qBAAqB,OAAA;AACrB,+HAAA,+BAA+B,OAAA;AAGjC,uCAAsD;AAA7C,uGAAA,WAAW,OAAA;AAAE,uGAAA,WAAW,OAAA;AAEjC,2CAA4D;AAAnD,2GAAA,aAAa,OAAA;AAAE,2GAAA,aAAa,OAAA"}

package/dist/prompts/manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * PromptManager: manages the lifecycle of MCP Prompts for Command and Skill resources.
+ *
+ * Design decisions:
+ * - Uses the low-level MCP SDK `Server` class (same as the rest of this project)
+ *   via `setRequestHandler` for `ListPromptsRequestSchema` and `GetPromptRequestSchema`.
+ * - Maintains an in-memory registry of registered prompts so list/get handlers
+ *   can be served without touching the disk on every request.
+ * - Prompt content is read from the `.prompt-cache/` directory written by
+ *   PromptGenerator.  If the cache file is missing, a fallback message is returned.
+ * - `jira_id` is an optional Prompt argument; when provided it is forwarded to
+ *   TelemetryManager so usage can be correlated with a Jira issue.
+ *
+ * Prompt naming convention: `{type}/{team}/{resource-name}`
+ *   e.g.  command/client-sdk/generate-testcase
+ *         skill/client-sdk/analyze-sdk-log
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export interface PromptResourceMeta {
+    /** Canonical resource ID from the CSP platform (e.g. "cmd-client-sdk-001"). */
+    resource_id: string;
+    /** 'command' | 'skill' */
+    resource_type: 'command' | 'skill';
+    /** Human-readable resource name. */
+    resource_name: string;
+    /** Team that owns the resource. */
+    team: string;
+    /** Description shown in the Cursor slash command menu. */
+    description: string;
+    /** Raw Markdown content of the resource (from API download). */
+    rawContent: string;
+}
+export declare class PromptManager {
+    /** In-memory store: prompt name → prompt metadata. */
+    private readonly prompts;
+    /**
+     * Tracks which Server instances already have handlers installed.
+     * Each SSE connection creates a new Server instance, so we track per-instance
+     * rather than using a global boolean flag (which would skip registration on
+     * subsequent connections and cause "Method not found" errors).
+     */
+    private readonly installedServers;
+    /**
+     * Build the MCP Prompt name for a resource.
+     * Format: `{type}/{resource-name}`
+     *
+     * We deliberately omit the team segment: Cursor prepends the MCP server name
+     * already (e.g. "user-csp-ai-agent/"), so adding team would create an
+     * unnecessarily deep slash path in the UI.  type + name is sufficient to be
+     * unique across commands and skills on this server.
+     */
+    buildPromptName(meta: Pick<PromptResourceMeta, 'resource_type' | 'resource_name'>): string;
+    /**
+     * Install `ListPrompts` and `GetPrompt` request handlers on the given MCP
+     * `Server` instance.  Must be called once after the server is created, before
+     * `server.connect()`.
+     *
+     * @param server    The MCP Server instance for this SSE connection.
+     * @param userToken The authenticated token for this connection's user.
+     *                  Used to attribute telemetry invocations to the correct user.
+     *
+     * Calling this a second time with the same server is a no-op.
+     */
+    installHandlers(server: Server, userToken?: string): void;
+    /**
+     * Register (or refresh) a single resource as an MCP Prompt.
+     * Generates the intermediate cache file and adds the prompt to the registry.
+     * Safe to call for an already-registered prompt — it will update the entry.
+     */
+    /**
+     * Build the telemetry header that is prepended to every Command/Skill prompt.
+     *
+     * When the AI receives this prompt it must call `track_usage` first so that
+     * the server records the invocation even though Cursor's slash command menu
+     * does not trigger `prompts/get`.  The header is deliberately short and
+     * authoritative so the AI does not skip it.
+     */
+    private buildTrackingHeader;
+    registerPrompt(meta: PromptResourceMeta): Promise<void>;
+    /**
+     * Unregister a prompt and delete its cache file.
+     * @param resourceId   The canonical resource ID.
+     * @param resourceType 'command' | 'skill'
+     * @param resourceName Resource name (used to reconstruct the prompt name).
+     */
+    unregisterPrompt(resourceId: string, resourceType: 'command' | 'skill', resourceName: string): void;
+    /**
+     * Refresh a prompt's cached content and description.
+     * Equivalent to calling registerPrompt() again.
+     */
+    refreshPrompt(meta: PromptResourceMeta): Promise<void>;
+    /**
+     * Re-register all provided resources as MCP Prompts.
+     * Existing prompts NOT in the list are NOT removed (use unregisterPrompt for that).
+     */
+    refreshAllPrompts(resources: PromptResourceMeta[]): Promise<void>;
+    /** Return the number of currently registered prompts. */
+    get size(): number;
+    /** Check if a prompt with the given name is currently registered. */
+    has(promptName: string): boolean;
+    /** Return a snapshot of all registered prompt names. */
+    promptNames(): string[];
+}
+/** Singleton PromptManager shared across the server process. */
+export declare const promptManager: PromptManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/prompts/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/prompts/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMxE,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,aAAa,EAAE,SAAS,GAAG,OAAO,CAAC;IACnC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD,qBAAa,aAAa;IACxB,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAM1D;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,eAAe,CAAC,GAAG,MAAM;IAU1F;;;;;;;;;;OAUG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IA0HzD;;;;OAIG;IACH;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAgBrB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7D;;;;;OAKG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,GAAG,OAAO,EACjC,YAAY,EAAE,MAAM,GACnB,IAAI;IAOP;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;OAGG;IACG,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE,yDAAyD;IACzD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qEAAqE;IACrE,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC,wDAAwD;IACxD,WAAW,IAAI,MAAM,EAAE;CAGxB;AAED,gEAAgE;AAChE,eAAO,MAAM,aAAa,eAAsB,CAAC"}