@elliotding/ai-agent-mcp 0.1.26 → 0.1.28

package/dist/types/resources.d.ts

@@ -0,0 +1,109 @@
+/**
+ * AI Resources Type Definitions
+ * Defines types for multi-source AI resource management
+ */
+/**
+ * Resource type enumeration
+ */
+export type ResourceType = 'commands' | 'skills' | 'mcp' | 'rules';
+/**
+ * Resource source configuration
+ */
+export interface ResourceSource {
+    /** Source name (identifier) */
+    name: string;
+    /** Relative path to AI-Resources root */
+    path: string;
+    /** Whether this source is enabled */
+    enabled: boolean;
+    /** Priority (higher number = higher priority) */
+    priority: number;
+    /** Mapping of resource types to subdirectories */
+    resources: Partial<Record<ResourceType, string>>;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * AI Resources configuration
+ */
+export interface AIResourcesConfig {
+    /** Configuration version */
+    version: string;
+    /** Optional description */
+    description?: string;
+    /** Default resource source (always loaded) */
+    default_source: ResourceSource;
+    /** Extended resource sources */
+    extended_sources: ResourceSource[];
+    /** Supported resource types */
+    resource_types: ResourceType[];
+    /** Loading order strategy */
+    loading_order: 'priority_desc' | 'priority_asc' | 'name_asc';
+    /** Conflict resolution strategy */
+    conflict_resolution: 'highest_priority_wins' | 'merge' | 'error';
+    /** Cache configuration */
+    cache?: {
+        enabled: boolean;
+        ttl: number;
+    };
+}
+/**
+ * Resource metadata
+ */
+export interface ResourceMetadata {
+    /** Resource ID */
+    id: string;
+    /** Resource name */
+    name: string;
+    /** Resource type */
+    type: ResourceType;
+    /** Source name */
+    source: string;
+    /** Source priority */
+    priority: number;
+    /** Full file path */
+    path: string;
+    /** Version (if available) */
+    version?: string;
+    /** Description (if available) */
+    description?: string;
+    /** Tags (if available) */
+    tags?: string[];
+}
+/**
+ * Resource conflict information
+ */
+export interface ResourceConflict {
+    /** Resource name */
+    name: string;
+    /** Resource type */
+    type: ResourceType;
+    /** Conflicting resources */
+    conflicts: Array<{
+        source: string;
+        priority: number;
+        path: string;
+    }>;
+    /** Selected resource (after conflict resolution) */
+    selected: {
+        source: string;
+        priority: number;
+        path: string;
+    };
+}
+/**
+ * Resource loader statistics
+ */
+export interface LoaderStats {
+    /** Total sources loaded */
+    sourcesLoaded: number;
+    /** Total resources indexed */
+    resourcesIndexed: number;
+    /** Resources by type */
+    byType: Record<ResourceType, number>;
+    /** Conflicts detected */
+    conflictsDetected: number;
+    /** Load duration (ms) */
+    loadDuration: number;
+}
+//# sourceMappingURL=resources.d.ts.map

package/dist/types/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/types/resources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IAEjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IAEjB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjD,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,cAAc,EAAE,cAAc,CAAC;IAE/B,gCAAgC;IAChC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAEnC,+BAA+B;IAC/B,cAAc,EAAE,YAAY,EAAE,CAAC;IAE/B,6BAA6B;IAC7B,aAAa,EAAE,eAAe,GAAG,cAAc,GAAG,UAAU,CAAC;IAE7D,mCAAmC;IACnC,mBAAmB,EAAE,uBAAuB,GAAG,OAAO,GAAG,OAAO,CAAC;IAEjE,0BAA0B;IAC1B,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IAEX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,YAAY,CAAC;IAEnB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,YAAY,CAAC;IAEnB,4BAA4B;IAC5B,SAAS,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IAEH,oDAAoD;IACpD,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IAEtB,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAErC,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/resources.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * AI Resources Type Definitions
+ * Defines types for multi-source AI resource management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=resources.js.map

package/dist/types/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/types/resources.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/tools.d.ts

@@ -0,0 +1,274 @@
+/**
+ * MCP Tool Types
+ */
+import type { MCPToolSchema } from './mcp';
+export interface WriteFileAction {
+    action: 'write_file';
+    /** Absolute path on the user's local machine (may start with ~). */
+    path: string;
+    /** File content to write. */
+    content: string;
+    /** File encoding (default: utf8). Set to base64 for binary files. */
+    encoding?: 'utf8' | 'base64';
+    /** File permissions in octal string format (e.g. "0755" for executable, "0644" for regular). Unix only. */
+    mode?: string;
+    /**
+     * Special marker for SKILL.md files in complex skills.
+     * When true, client should check this file's content FIRST.
+     * If content matches local file exactly (string equality), skip this action AND all subsequent write_file actions until next skill or different action type.
+     * This enables atomic skill-level updates (skip all or download all).
+     */
+    is_skill_manifest?: boolean;
+}
+export interface DeleteFileAction {
+    action: 'delete_file';
+    /** Absolute path on the user's local machine (may start with ~). */
+    path: string;
+    /** When true, recursively delete a directory. */
+    recursive?: boolean;
+}
+export interface MergeMcpJsonAction {
+    action: 'merge_mcp_json';
+    /** Absolute path to the user's mcp.json file. */
+    mcp_json_path: string;
+    /** Key under mcpServers to add or update. */
+    server_name: string;
+    /** The MCP server entry object to merge in. */
+    entry: Record<string, unknown>;
+    /** env keys that are currently empty and must be filled by the user. */
+    missing_env?: string[];
+    /** Human-readable hint when manual env configuration is required. */
+    setup_hint?: string;
+    /** Path to a local setup/readme doc if one exists in the install dir. */
+    setup_doc?: string;
+    /**
+     * When true, the AI MUST skip this action if `mcpServers[server_name]`
+     * already exists in mcp.json (regardless of content).
+     * Use this for idempotent installs where re-writing would clobber
+     * user-customised values (e.g. env vars the user has already filled in).
+     */
+    skip_if_exists?: boolean;
+}
+export interface RemoveMcpJsonEntryAction {
+    action: 'remove_mcp_json_entry';
+    /** Absolute path to the user's mcp.json file. */
+    mcp_json_path: string;
+    /** Key under mcpServers to remove. */
+    server_name: string;
+}
+export type LocalAction = WriteFileAction | DeleteFileAction | MergeMcpJsonAction | RemoveMcpJsonEntryAction;
+export type ToolHandler = (params: unknown) => Promise<ToolResult>;
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: MCPToolSchema;
+    handler: ToolHandler;
+}
+export interface ToolResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export interface SyncResourcesParams {
+    mode?: 'check' | 'incremental' | 'full';
+    scope?: 'global' | 'workspace' | 'all';
+    types?: string[];
+    /**
+     * CSP API token from the user's mcp.json env configuration.
+     * Overrides the server-level fallback token so that each user
+     * makes API calls with their own identity.
+     */
+    user_token?: string;
+    /**
+     * List of MCP server names that are already configured in the user's
+     * ~/.cursor/mcp.json. The server will skip downloading and generating
+     * write_file actions for these MCP resources to reduce overhead.
+     *
+     * Set this to the keys from mcpServers in ~/.cursor/mcp.json:
+     * Object.keys(JSON.parse(fs.readFileSync('~/.cursor/mcp.json')).mcpServers || {})
+     *
+     * Only applies in 'incremental' mode; 'full' mode always downloads everything.
+     */
+    configured_mcp_servers?: string[];
+}
+export interface McpSetupItem {
+    /** MCP server name as it appears in mcp.json */
+    server_name: string;
+    /** Human-readable path to mcp.json on this platform */
+    mcp_json_path: string;
+    /** env keys that are currently empty and need user input */
+    missing_env: string[];
+    /** true when the registered command might not be correct for this machine */
+    command_needs_verification: boolean;
+    /** the command string that was registered */
+    command: string;
+    /** freeform guidance shown to the user */
+    setup_hint: string;
+    /** absolute path to a local setup/readme doc found in the install directory, if any */
+    setup_doc?: string;
+}
+export interface SyncResourcesResult {
+    mode: string;
+    health_score: number;
+    summary: {
+        total: number;
+        synced: number;
+        cached: number;
+        /** Number of resources skipped due to no local changes (incremental mode only). */
+        skipped: number;
+        failed: number;
+    };
+    details: Array<{
+        id: string;
+        name: string;
+        action: string;
+        version: string;
+    }>;
+    /**
+     * List of resource names that were skipped during incremental sync because
+     * local files are already up-to-date (hash match). Present only when skipped > 0.
+     */
+    skipped_resources?: Array<{
+        name: string;
+        reason: 'already_up_to_date' | 'no_local_sync_needed' | 'mcp_already_configured';
+    }>;
+    /**
+     * MCP servers that were installed/updated but require manual configuration
+     * before they can be used. Present only when at least one server needs setup.
+     * @deprecated use local_actions_required MergeMcpJsonAction.missing_env instead
+     */
+    pending_setup?: McpSetupItem[];
+    /**
+     * Ordered list of file-system and mcp.json operations the AI Agent must
+     * execute on the user's LOCAL machine after receiving this response.
+     * Present only when at least one Rule or MCP resource was synced.
+     *
+     * The AI MUST execute every action in order before reporting success to the
+     * user.  See LocalAction type variants for details.
+     */
+    local_actions_required?: LocalAction[];
+}
+export interface ManageSubscriptionParams {
+    action: 'subscribe' | 'unsubscribe' | 'list' | 'batch_subscribe' | 'batch_unsubscribe';
+    resource_ids?: string[];
+    auto_sync?: boolean;
+    scope?: 'global' | 'workspace';
+    notify?: boolean;
+    /** CSP API token from the user's mcp.json env configuration. */
+    user_token?: string;
+}
+export interface ManageSubscriptionResult {
+    action: string;
+    success: boolean;
+    subscriptions?: Array<{
+        id: string;
+        name: string;
+        type: string;
+        subscribed_at: string;
+    }>;
+    message?: string;
+    /** Sync results for each resource after auto-sync on subscribe */
+    sync_details?: Array<{
+        id: string;
+        name: string;
+        action: string;
+    }>;
+    /** MCP servers that need manual configuration after auto-sync */
+    pending_setup?: unknown[];
+}
+export interface SearchResourcesParams {
+    team?: string;
+    type?: string;
+    keyword: string;
+    /** CSP API token from the user's mcp.json env configuration. */
+    user_token?: string;
+}
+export interface SearchResourcesResult {
+    total: number;
+    results: Array<{
+        id: string;
+        name: string;
+        type: string;
+        team: string;
+        version: string;
+        description: string;
+        score: number;
+        is_subscribed: boolean;
+        is_installed: boolean;
+    }>;
+}
+export interface ResolvePromptContentParams {
+    prompt_name?: string;
+    resource_id?: string;
+    /** CSP API token from the user's mcp.json env configuration. */
+    user_token?: string;
+    /** Optional Jira Issue ID for usage correlation. */
+    jira_id?: string;
+}
+export interface ResolvePromptContentResult {
+    prompt_name: string;
+    resource_id: string;
+    resource_type: 'command' | 'skill';
+    resource_name: string;
+    description: string;
+    content: string;
+    content_source: 'cache' | 'generated' | 'raw_fallback';
+    usage_tracked: boolean;
+}
+export interface FileEntry {
+    path: string;
+    content: string;
+}
+export interface UploadResourceParams {
+    resource_id: string;
+    /** Resource category. Optional — auto-detected from file structure when omitted. */
+    type?: 'command' | 'skill' | 'rule' | 'mcp';
+    message: string;
+    /** Human-readable resource name sent to the CSP API. Defaults to the primary file name (without extension). */
+    name?: string;
+    /** Target source repo from ai-resources-config.json (e.g. "csp", "client-sdk-ai-hub"). Defaults to default_source. */
+    target_source?: string;
+    team?: string;
+    /** File list to upload. Paths are relative to the type subdir of the chosen source. Any file extension allowed. */
+    files: FileEntry[];
+    title?: string;
+    metadata?: Record<string, unknown>;
+    /** CSP API token from the user's mcp.json env configuration. */
+    user_token?: string;
+}
+export interface UploadResourceResult {
+    resource_id: string;
+    version: string;
+    url: string;
+    commit_hash: string;
+    message: string;
+}
+export interface UninstallResourceParams {
+    resource_id_or_name: string;
+    remove_from_account?: boolean;
+    /** When known, the resource type — narrows which local_actions are emitted. */
+    resource_type?: 'command' | 'skill' | 'rule' | 'mcp';
+    /** CSP API token from the user's mcp.json env configuration. */
+    user_token?: string;
+}
+export interface UninstallResourceResult {
+    success: boolean;
+    removed_resources: Array<{
+        id: string;
+        name: string;
+        path: string;
+    }>;
+    subscription_removed: boolean;
+    message: string;
+    /**
+     * Ordered list of file-system and mcp.json operations the AI Agent must
+     * execute on the user's LOCAL machine after receiving this response.
+     * Present only for Rule and local-executable MCP resources.
+     */
+    local_actions_required?: LocalAction[];
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/types/tools.d.ts.map

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

package/dist/types/tools.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * MCP Tool Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/cursor-paths.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Cursor IDE standard directory path resolver.
+ *
+ * Cursor stores user-level assets in platform-specific locations:
+ *   macOS / Linux : ~/.cursor/<type>/
+ *   Windows       : %APPDATA%\Cursor\User\<type>\
+ *                   (typically C:\Users\<user>\AppData\Roaming\Cursor\User\<type>\)
+ *
+ * Resource type → subdirectory mapping mirrors the actual Cursor directory layout.
+ */
+/** Supported Cursor resource types and their directory names. */
+export declare const CURSOR_TYPE_DIRS: Record<string, string>;
+/**
+ * Returns the root of the Cursor user directory on the current platform.
+ *
+ * macOS / Linux : ~/.cursor
+ * Windows       : %APPDATA%\Cursor\User
+ *
+ * NOTE: Only use this when running code on the USER's local machine.
+ * When generating paths for LocalAction instructions (which are executed by the
+ * AI on the user's machine, not on this server), use getCursorRootDirForClient()
+ * instead to avoid returning the server's home directory.
+ */
+export declare function getCursorRootDir(): string;
+/**
+ * Returns a platform-neutral Cursor root path for use in LocalAction instructions.
+ *
+ * LocalAction paths are sent to the AI Agent running on the USER's local machine,
+ * not executed on this (possibly remote) server.  Using os.homedir() here would
+ * produce the server's home directory (e.g. /root/.cursor on a Linux server),
+ * which is wrong when the user is on macOS or Windows.
+ *
+ * We return a tilde-prefixed path ("~/.cursor") which the AI / shell on the
+ * user's machine will expand to the correct home directory automatically.
+ * For Windows we still return the APPDATA-relative form as a hint, but note
+ * that the AI is expected to expand %APPDATA% on the client side.
+ */
+export declare function getCursorRootDirForClient(): string;
+/**
+ * Returns the Cursor subdirectory for a given resource type, using a
+ * client-side portable path (tilde-based).  Use this when building paths
+ * that will be included in LocalAction instructions.
+ */
+export declare function getCursorTypeDirForClient(resourceType: string): string;
+/**
+ * Returns the Cursor subdirectory for a given resource type.
+ *
+ * @param resourceType  - API resource type string (e.g. 'skill', 'command', 'rule', 'mcp')
+ * @returns Absolute path to the matching Cursor directory
+ * @throws  Error if the resource type is not recognised
+ *
+ * @example
+ *   getCursorTypeDir('skill')   // ~/.cursor/skills
+ *   getCursorTypeDir('command') // ~/.cursor/commands
+ *   getCursorTypeDir('rule')    // ~/.cursor/rules
+ *   getCursorTypeDir('mcp')     // ~/.cursor/mcp-servers
+ */
+export declare function getCursorTypeDir(resourceType: string): string;
+/**
+ * Returns the install path for a specific named resource.
+ *
+ * For directory-based resources (skill, mcp) the result is a directory:
+ *   ~/.cursor/skills/<name>/
+ *
+ * For file-based resources (command, rule) the result is the file path
+ * preserving the original filename (caller should pass name with extension):
+ *   ~/.cursor/commands/<name>         (e.g. generate-testcase.md)
+ *   ~/.cursor/rules/<name>            (e.g. elliotTest.mdc)
+ *
+ * @param resourceType  - Resource type string
+ * @param resourceName  - Resource name (with or without extension)
+ */
+export declare function getCursorResourcePath(resourceType: string, resourceName: string): string;
+/**
+ * Returns the path to the local AI resource telemetry file.
+ *
+ * Stored at the Cursor root level (not inside a resource-type subdirectory)
+ * so it persists independently of individual resource installs/uninstalls.
+ *
+ * macOS / Linux : ~/.cursor/ai-resource-telemetry.json
+ * Windows       : %APPDATA%\Cursor\User\ai-resource-telemetry.json
+ */
+export declare function getTelemetryFilePath(): string;
+//# sourceMappingURL=cursor-paths.d.ts.map

package/dist/utils/cursor-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-paths.d.ts","sourceRoot":"","sources":["../../src/utils/cursor-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASnD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAStE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAExF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/utils/cursor-paths.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Cursor IDE standard directory path resolver.
+ *
+ * Cursor stores user-level assets in platform-specific locations:
+ *   macOS / Linux : ~/.cursor/<type>/
+ *   Windows       : %APPDATA%\Cursor\User\<type>\
+ *                   (typically C:\Users\<user>\AppData\Roaming\Cursor\User\<type>\)
+ *
+ * Resource type → subdirectory mapping mirrors the actual Cursor directory layout.
+ */
+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.CURSOR_TYPE_DIRS = void 0;
+exports.getCursorRootDir = getCursorRootDir;
+exports.getCursorRootDirForClient = getCursorRootDirForClient;
+exports.getCursorTypeDirForClient = getCursorTypeDirForClient;
+exports.getCursorTypeDir = getCursorTypeDir;
+exports.getCursorResourcePath = getCursorResourcePath;
+exports.getTelemetryFilePath = getTelemetryFilePath;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/** Supported Cursor resource types and their directory names. */
+exports.CURSOR_TYPE_DIRS = {
+    skill: 'skills',
+    skills: 'skills',
+    command: 'commands',
+    commands: 'commands',
+    rule: 'rules',
+    rules: 'rules',
+    mcp: 'mcp-servers',
+    'mcp-servers': 'mcp-servers',
+};
+/**
+ * Returns the root of the Cursor user directory on the current platform.
+ *
+ * macOS / Linux : ~/.cursor
+ * Windows       : %APPDATA%\Cursor\User
+ *
+ * NOTE: Only use this when running code on the USER's local machine.
+ * When generating paths for LocalAction instructions (which are executed by the
+ * AI on the user's machine, not on this server), use getCursorRootDirForClient()
+ * instead to avoid returning the server's home directory.
+ */
+function getCursorRootDir() {
+    if (process.platform === 'win32') {
+        // APPDATA is always set on Windows; fall back to USERPROFILE as a safety net
+        const appData = process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
+        return path.join(appData, 'Cursor', 'User');
+    }
+    // macOS and Linux both use ~/.cursor
+    return path.join(os.homedir(), '.cursor');
+}
+/**
+ * Returns a platform-neutral Cursor root path for use in LocalAction instructions.
+ *
+ * LocalAction paths are sent to the AI Agent running on the USER's local machine,
+ * not executed on this (possibly remote) server.  Using os.homedir() here would
+ * produce the server's home directory (e.g. /root/.cursor on a Linux server),
+ * which is wrong when the user is on macOS or Windows.
+ *
+ * We return a tilde-prefixed path ("~/.cursor") which the AI / shell on the
+ * user's machine will expand to the correct home directory automatically.
+ * For Windows we still return the APPDATA-relative form as a hint, but note
+ * that the AI is expected to expand %APPDATA% on the client side.
+ */
+function getCursorRootDirForClient() {
+    // Return a portable ~-based path; the AI on the user's machine expands it.
+    return '~/.cursor';
+}
+/**
+ * Returns the Cursor subdirectory for a given resource type, using a
+ * client-side portable path (tilde-based).  Use this when building paths
+ * that will be included in LocalAction instructions.
+ */
+function getCursorTypeDirForClient(resourceType) {
+    const subdir = exports.CURSOR_TYPE_DIRS[resourceType.toLowerCase()];
+    if (!subdir) {
+        throw new Error(`Unknown resource type "${resourceType}". ` +
+            `Supported types: ${Object.keys(exports.CURSOR_TYPE_DIRS).join(', ')}`);
+    }
+    return `${getCursorRootDirForClient()}/${subdir}`;
+}
+/**
+ * Returns the Cursor subdirectory for a given resource type.
+ *
+ * @param resourceType  - API resource type string (e.g. 'skill', 'command', 'rule', 'mcp')
+ * @returns Absolute path to the matching Cursor directory
+ * @throws  Error if the resource type is not recognised
+ *
+ * @example
+ *   getCursorTypeDir('skill')   // ~/.cursor/skills
+ *   getCursorTypeDir('command') // ~/.cursor/commands
+ *   getCursorTypeDir('rule')    // ~/.cursor/rules
+ *   getCursorTypeDir('mcp')     // ~/.cursor/mcp-servers
+ */
+function getCursorTypeDir(resourceType) {
+    const subdir = exports.CURSOR_TYPE_DIRS[resourceType.toLowerCase()];
+    if (!subdir) {
+        throw new Error(`Unknown resource type "${resourceType}". ` +
+            `Supported types: ${Object.keys(exports.CURSOR_TYPE_DIRS).join(', ')}`);
+    }
+    return path.join(getCursorRootDir(), subdir);
+}
+/**
+ * Returns the install path for a specific named resource.
+ *
+ * For directory-based resources (skill, mcp) the result is a directory:
+ *   ~/.cursor/skills/<name>/
+ *
+ * For file-based resources (command, rule) the result is the file path
+ * preserving the original filename (caller should pass name with extension):
+ *   ~/.cursor/commands/<name>         (e.g. generate-testcase.md)
+ *   ~/.cursor/rules/<name>            (e.g. elliotTest.mdc)
+ *
+ * @param resourceType  - Resource type string
+ * @param resourceName  - Resource name (with or without extension)
+ */
+function getCursorResourcePath(resourceType, resourceName) {
+    return path.join(getCursorTypeDir(resourceType), resourceName);
+}
+/**
+ * Returns the path to the local AI resource telemetry file.
+ *
+ * Stored at the Cursor root level (not inside a resource-type subdirectory)
+ * so it persists independently of individual resource installs/uninstalls.
+ *
+ * macOS / Linux : ~/.cursor/ai-resource-telemetry.json
+ * Windows       : %APPDATA%\Cursor\User\ai-resource-telemetry.json
+ */
+function getTelemetryFilePath() {
+    return path.join(getCursorRootDir(), 'ai-resource-telemetry.json');
+}
+//# sourceMappingURL=cursor-paths.js.map