@elliotding/ai-agent-mcp 0.1.0

package/dist/types/errors.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Custom Error Types
+ * Typed errors for different failure scenarios
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemError = exports.ValidationError = exports.APIError = exports.GitError = exports.MCPServerError = void 0;
+exports.createGitError = createGitError;
+exports.createAPIError = createAPIError;
+exports.createValidationError = createValidationError;
+exports.createFileSystemError = createFileSystemError;
+/**
+ * Base Error for MCP Server operations
+ */
+class MCPServerError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.MCPServerError = MCPServerError;
+/**
+ * Git Operation Error
+ */
+class GitError extends MCPServerError {
+    operation;
+    repositoryUrl;
+    constructor(message, operation, repositoryUrl, details) {
+        super(message, 'GIT_ERROR', details);
+        this.operation = operation;
+        this.repositoryUrl = repositoryUrl;
+        // Redact credentials from repository URL
+        if (this.repositoryUrl) {
+            this.repositoryUrl = this.redactCredentials(this.repositoryUrl);
+        }
+    }
+    redactCredentials(url) {
+        return url.replace(/:\/\/([^:]+):([^@]+)@/, '://***:***@');
+    }
+}
+exports.GitError = GitError;
+/**
+ * API Request Error
+ */
+class APIError extends MCPServerError {
+    statusCode;
+    method;
+    url;
+    retryCount;
+    constructor(message, statusCode, method, url, retryCount, details) {
+        super(message, 'API_ERROR', details);
+        this.statusCode = statusCode;
+        this.method = method;
+        this.url = url;
+        this.retryCount = retryCount;
+    }
+}
+exports.APIError = APIError;
+/**
+ * Resource Validation Error
+ */
+class ValidationError extends MCPServerError {
+    filePath;
+    expectedFormat;
+    validationReason;
+    constructor(message, filePath, expectedFormat, validationReason, details) {
+        super(message, 'VALIDATION_ERROR', details);
+        this.filePath = filePath;
+        this.expectedFormat = expectedFormat;
+        this.validationReason = validationReason;
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Filesystem Operation Error
+ */
+class FileSystemError extends MCPServerError {
+    operation;
+    path;
+    systemErrorCode;
+    suggestedResolution;
+    constructor(message, operation, path, systemErrorCode, suggestedResolution, details) {
+        super(message, 'FILESYSTEM_ERROR', details);
+        this.operation = operation;
+        this.path = path;
+        this.systemErrorCode = systemErrorCode;
+        this.suggestedResolution = suggestedResolution;
+    }
+}
+exports.FileSystemError = FileSystemError;
+/**
+ * Error Factory Functions
+ */
+function createGitError(operation, error, repositoryUrl) {
+    return new GitError(`Git ${operation} failed: ${error.message}`, operation, repositoryUrl, { originalError: error });
+}
+function createAPIError(method, url, error, statusCode, retryCount) {
+    const message = `API ${method} ${url} failed: ${error.message}`;
+    return new APIError(message, statusCode, method, url, retryCount, { originalError: error });
+}
+function createValidationError(filePath, expectedFormat, reason) {
+    return new ValidationError(`Resource validation failed: ${reason}`, filePath, expectedFormat, reason);
+}
+function createFileSystemError(operation, path, error, suggestedResolution) {
+    return new FileSystemError(`Filesystem ${operation} failed: ${error.message}`, operation, path, error.code, suggestedResolution, { originalError: error });
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Type Exports
+ */
+export * from './mcp';
+export * from './tools';
+export * from './errors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Type Exports
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mcp"), exports);
+__exportStar(require("./tools"), exports);
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB"}

package/dist/types/mcp.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MCP Protocol Types
+ */
+export interface MCPToolSchema {
+    type: 'object';
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        enum?: string[];
+        default?: unknown;
+    }>;
+    required?: string[];
+}
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: MCPToolSchema;
+}
+export interface MCPInitializeRequest {
+    protocolVersion: string;
+    capabilities: {
+        tools?: Record<string, never>;
+    };
+    clientInfo: {
+        name: string;
+        version: string;
+    };
+}
+export interface MCPInitializeResponse {
+    protocolVersion: string;
+    capabilities: {
+        tools?: Record<string, never>;
+    };
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+}
+export interface MCPToolCallRequest {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+export interface MCPToolCallResponse {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,aAAa,CAAC;CAC5B;AAGD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;KAC/B,CAAC;IACF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAGD,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;KAC/B,CAAC;IACF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAGD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAGD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/mcp.js

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

package/dist/types/mcp.js.map

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

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,147 @@
+/**
+ * MCP Tool Types
+ */
+import type { MCPToolSchema } from './mcp';
+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[];
+}
+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;
+        failed: number;
+    };
+    details: Array<{
+        id: string;
+        name: string;
+        action: string;
+        version: string;
+    }>;
+    /**
+     * MCP servers that were installed/updated but require manual configuration
+     * before they can be used. Present only when at least one server needs setup.
+     */
+    pending_setup?: McpSetupItem[];
+}
+export interface ManageSubscriptionParams {
+    action: 'subscribe' | 'unsubscribe' | 'list' | 'batch_subscribe' | 'batch_unsubscribe';
+    resource_ids?: string[];
+    auto_sync?: boolean;
+    scope?: 'global' | 'workspace';
+    notify?: boolean;
+}
+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;
+}
+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 FileEntry {
+    path: string;
+    content: string;
+}
+export interface UploadResourceParams {
+    resource_id: string;
+    type: 'command' | 'skill' | 'rule' | 'mcp';
+    message: string;
+    /** Human-readable resource name sent to the CSP API. Defaults to resource_id. */
+    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>;
+}
+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;
+}
+export interface UninstallResourceResult {
+    success: boolean;
+    removed_resources: Array<{
+        id: string;
+        name: string;
+        path: string;
+    }>;
+    subscription_removed: boolean;
+    message: string;
+}
+//# 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,49 @@
+/**
+ * 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
+ */
+export declare function getCursorRootDir(): 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;
+//# 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;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;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"}