mock-mcp 0.5.0 → 0.5.1

package/dist/index.d.cts

@@ -8,7 +8,7 @@
  * - Manage runs, batches, claims with lease-based concurrency control
  * - Clean up expired claims and disconnected runs
  */
-type Logger$2 = Pick<Console, "log" | "warn" | "error"> & {
+type Logger$3 = Pick<Console, "log" | "warn" | "error"> & {
     debug?: (...args: unknown[]) => void;
 };
 interface MockMcpDaemonOptions {
@@ -16,7 +16,7 @@ interface MockMcpDaemonOptions {
     token: string;
     version: string;
     cacheDir?: string;
-    logger?: Logger$2;
+    logger?: Logger$3;
     /** Default lease time for batch claims (ms). Default: 30000 */
     defaultLeaseMs?: number;
     /** Interval for sweeping expired claims (ms). Default: 5000 */
@@ -65,14 +65,15 @@ declare class MockMcpDaemon {
  * Each MCP client (Cursor, Claude Desktop, etc.) spawns one Adapter process.
  * The Adapter:
  * - Exposes MCP tools (claim_next_batch, provide_batch_mock_data, get_status)
- * - Connects to the Daemon via IPC
+ * - Discovers and connects to ALL active Daemons via IPC
  * - Does NOT bind any ports (avoids conflicts)
+ * - Works across projects without requiring --project-root
  */
-type Logger$1 = Pick<Console, "log" | "warn" | "error"> & {
+type Logger$2 = Pick<Console, "log" | "warn" | "error"> & {
     debug?: (...args: unknown[]) => void;
 };
 interface AdapterOptions {
-    logger?: Logger$1;
+    logger?: Logger$2;
     version?: string;
 }
 declare function runAdapter(opts?: AdapterOptions): Promise<void>;
@@ -262,6 +263,127 @@ declare function computeProjectId(projectRoot: string): string;
  * Thread-safe: multiple processes calling this concurrently will only start one daemon.
  */
 declare function ensureDaemonRunning(opts?: EnsureDaemonOptions): Promise<DaemonRegistry>;
+/**
+ * Entry in the global active daemons index.
+ */
+interface ActiveDaemonEntry {
+    projectId: string;
+    projectRoot: string;
+    ipcPath: string;
+    registryPath: string;
+    pid: number;
+    startedAt: string;
+    version: string;
+}
+/**
+ * Global index of all active daemons.
+ */
+interface ActiveDaemonsIndex {
+    daemons: ActiveDaemonEntry[];
+    updatedAt: string;
+}
+/**
+ * Read the global active daemons index.
+ */
+declare function readGlobalIndex(cacheDir?: string): Promise<ActiveDaemonsIndex>;
+/**
+ * Clean up stale entries from the global index.
+ * Removes entries where the daemon is no longer running.
+ */
+declare function cleanupGlobalIndex(cacheDir?: string): Promise<void>;
+/**
+ * Discover all active daemons.
+ * Returns list of daemons with their connection info.
+ */
+declare function discoverAllDaemons(cacheDir?: string): Promise<{
+    registry: DaemonRegistry;
+    healthy: boolean;
+}[]>;
+
+/**
+ * MultiDaemonClient - Aggregates multiple daemon connections for cross-project operation.
+ *
+ * This client discovers all active daemons and can perform operations across them.
+ * It's designed for MCP adapters that need to work without knowing the specific project root.
+ */
+
+type Logger$1 = Pick<Console, "log" | "warn" | "error"> & {
+    debug?: (...args: unknown[]) => void;
+};
+interface MultiDaemonClientOptions {
+    logger?: Logger$1;
+    cacheDir?: string;
+}
+interface DaemonConnection {
+    registry: DaemonRegistry;
+    healthy: boolean;
+}
+interface ExtendedRunInfo extends RunInfo {
+    projectId: string;
+    projectRoot: string;
+}
+interface AggregatedStatusResult {
+    daemons: (GetStatusResult & {
+        healthy: boolean;
+    })[];
+    totalRuns: number;
+    totalPending: number;
+    totalClaimed: number;
+}
+declare class MultiDaemonClient {
+    private readonly logger;
+    private readonly cacheDir?;
+    private readonly adapterId;
+    constructor(opts?: MultiDaemonClientOptions);
+    /**
+     * Discover all active and healthy daemons.
+     */
+    discoverDaemons(): Promise<DaemonConnection[]>;
+    /**
+     * Get aggregated status from all daemons.
+     */
+    getAggregatedStatus(): Promise<AggregatedStatusResult>;
+    /**
+     * List all runs across all daemons.
+     */
+    listAllRuns(): Promise<ExtendedRunInfo[]>;
+    /**
+     * Claim the next available batch from any daemon.
+     * Searches through all daemons in order until finding one with a pending batch.
+     */
+    claimNextBatch(args: {
+        runId?: string;
+        leaseMs?: number;
+    }): Promise<(ClaimNextBatchResult & {
+        projectId: string;
+        projectRoot: string;
+    }) | null>;
+    /**
+     * Provide mock data for a batch.
+     * Automatically routes to the correct daemon based on batchId.
+     */
+    provideBatch(args: {
+        batchId: string;
+        claimToken: string;
+        mocks: MockResponseDescriptor[];
+    }): Promise<ProvideBatchResult>;
+    /**
+     * Release a batch.
+     */
+    releaseBatch(args: {
+        batchId: string;
+        claimToken: string;
+        reason?: string;
+    }): Promise<{
+        ok: boolean;
+        message?: string;
+    }>;
+    /**
+     * Get a specific batch by ID.
+     */
+    getBatch(batchId: string): Promise<GetBatchResult | null>;
+    private rpc;
+}
 
 /**
  * BatchMockCollector - Collects HTTP requests and sends them to the daemon for mock generation.
@@ -381,9 +503,17 @@ declare class BatchMockCollector {
     constructor(options?: BatchMockCollectorOptions);
     /**
      * Resolve projectRoot from options.
-     * Priority: projectRoot > filePath > undefined (auto-detect)
+     * Priority: projectRoot (if valid) > filePath > projectRoot (fallback) > undefined (auto-detect)
+     *
+     * A projectRoot is "valid" if it contains .git or package.json. This prevents
+     * accidentally using a wrong directory (e.g., user's home directory) when the
+     * caller mistakenly passes process.cwd() as projectRoot.
      */
     private resolveProjectRootFromOptions;
+    /**
+     * Check if a directory contains .git or package.json
+     */
+    private hasGitOrPackageJson;
     /**
      * Ensures the underlying connection is ready for use.
      */
@@ -469,4 +599,4 @@ interface MockClient {
  */
 declare const connect: (options?: ConnectOptions) => Promise<MockClient>;
 
-export { type AdapterOptions, BatchMockCollector, type BatchMockCollectorOptions, type ConnectOptions, DaemonClient, type DaemonRegistry, type MockClient, MockMcpDaemon, type MockMcpDaemonOptions, type MockRequestDescriptor, type MockResponseDescriptor, type RequestMockOptions, type ResolvedMock, computeProjectId, connect, ensureDaemonRunning, resolveProjectRoot, runAdapter };
+export { type ActiveDaemonEntry, type ActiveDaemonsIndex, type AdapterOptions, type AggregatedStatusResult, BatchMockCollector, type BatchMockCollectorOptions, type ConnectOptions, DaemonClient, type DaemonRegistry, type ExtendedRunInfo, type MockClient, MockMcpDaemon, type MockMcpDaemonOptions, type MockRequestDescriptor, type MockResponseDescriptor, MultiDaemonClient, type MultiDaemonClientOptions, type RequestMockOptions, type ResolvedMock, cleanupGlobalIndex, computeProjectId, connect, discoverAllDaemons, ensureDaemonRunning, readGlobalIndex, resolveProjectRoot, runAdapter };

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * - Manage runs, batches, claims with lease-based concurrency control
  * - Clean up expired claims and disconnected runs
  */
-type Logger$2 = Pick<Console, "log" | "warn" | "error"> & {
+type Logger$3 = Pick<Console, "log" | "warn" | "error"> & {
     debug?: (...args: unknown[]) => void;
 };
 interface MockMcpDaemonOptions {
@@ -16,7 +16,7 @@ interface MockMcpDaemonOptions {
     token: string;
     version: string;
     cacheDir?: string;
-    logger?: Logger$2;
+    logger?: Logger$3;
     /** Default lease time for batch claims (ms). Default: 30000 */
     defaultLeaseMs?: number;
     /** Interval for sweeping expired claims (ms). Default: 5000 */
@@ -65,14 +65,15 @@ declare class MockMcpDaemon {
  * Each MCP client (Cursor, Claude Desktop, etc.) spawns one Adapter process.
  * The Adapter:
  * - Exposes MCP tools (claim_next_batch, provide_batch_mock_data, get_status)
- * - Connects to the Daemon via IPC
+ * - Discovers and connects to ALL active Daemons via IPC
  * - Does NOT bind any ports (avoids conflicts)
+ * - Works across projects without requiring --project-root
  */
-type Logger$1 = Pick<Console, "log" | "warn" | "error"> & {
+type Logger$2 = Pick<Console, "log" | "warn" | "error"> & {
     debug?: (...args: unknown[]) => void;
 };
 interface AdapterOptions {
-    logger?: Logger$1;
+    logger?: Logger$2;
     version?: string;
 }
 declare function runAdapter(opts?: AdapterOptions): Promise<void>;
@@ -262,6 +263,127 @@ declare function computeProjectId(projectRoot: string): string;
  * Thread-safe: multiple processes calling this concurrently will only start one daemon.
  */
 declare function ensureDaemonRunning(opts?: EnsureDaemonOptions): Promise<DaemonRegistry>;
+/**
+ * Entry in the global active daemons index.
+ */
+interface ActiveDaemonEntry {
+    projectId: string;
+    projectRoot: string;
+    ipcPath: string;
+    registryPath: string;
+    pid: number;
+    startedAt: string;
+    version: string;
+}
+/**
+ * Global index of all active daemons.
+ */
+interface ActiveDaemonsIndex {
+    daemons: ActiveDaemonEntry[];
+    updatedAt: string;
+}
+/**
+ * Read the global active daemons index.
+ */
+declare function readGlobalIndex(cacheDir?: string): Promise<ActiveDaemonsIndex>;
+/**
+ * Clean up stale entries from the global index.
+ * Removes entries where the daemon is no longer running.
+ */
+declare function cleanupGlobalIndex(cacheDir?: string): Promise<void>;
+/**
+ * Discover all active daemons.
+ * Returns list of daemons with their connection info.
+ */
+declare function discoverAllDaemons(cacheDir?: string): Promise<{
+    registry: DaemonRegistry;
+    healthy: boolean;
+}[]>;
+
+/**
+ * MultiDaemonClient - Aggregates multiple daemon connections for cross-project operation.
+ *
+ * This client discovers all active daemons and can perform operations across them.
+ * It's designed for MCP adapters that need to work without knowing the specific project root.
+ */
+
+type Logger$1 = Pick<Console, "log" | "warn" | "error"> & {
+    debug?: (...args: unknown[]) => void;
+};
+interface MultiDaemonClientOptions {
+    logger?: Logger$1;
+    cacheDir?: string;
+}
+interface DaemonConnection {
+    registry: DaemonRegistry;
+    healthy: boolean;
+}
+interface ExtendedRunInfo extends RunInfo {
+    projectId: string;
+    projectRoot: string;
+}
+interface AggregatedStatusResult {
+    daemons: (GetStatusResult & {
+        healthy: boolean;
+    })[];
+    totalRuns: number;
+    totalPending: number;
+    totalClaimed: number;
+}
+declare class MultiDaemonClient {
+    private readonly logger;
+    private readonly cacheDir?;
+    private readonly adapterId;
+    constructor(opts?: MultiDaemonClientOptions);
+    /**
+     * Discover all active and healthy daemons.
+     */
+    discoverDaemons(): Promise<DaemonConnection[]>;
+    /**
+     * Get aggregated status from all daemons.
+     */
+    getAggregatedStatus(): Promise<AggregatedStatusResult>;
+    /**
+     * List all runs across all daemons.
+     */
+    listAllRuns(): Promise<ExtendedRunInfo[]>;
+    /**
+     * Claim the next available batch from any daemon.
+     * Searches through all daemons in order until finding one with a pending batch.
+     */
+    claimNextBatch(args: {
+        runId?: string;
+        leaseMs?: number;
+    }): Promise<(ClaimNextBatchResult & {
+        projectId: string;
+        projectRoot: string;
+    }) | null>;
+    /**
+     * Provide mock data for a batch.
+     * Automatically routes to the correct daemon based on batchId.
+     */
+    provideBatch(args: {
+        batchId: string;
+        claimToken: string;
+        mocks: MockResponseDescriptor[];
+    }): Promise<ProvideBatchResult>;
+    /**
+     * Release a batch.
+     */
+    releaseBatch(args: {
+        batchId: string;
+        claimToken: string;
+        reason?: string;
+    }): Promise<{
+        ok: boolean;
+        message?: string;
+    }>;
+    /**
+     * Get a specific batch by ID.
+     */
+    getBatch(batchId: string): Promise<GetBatchResult | null>;
+    private rpc;
+}
 
 /**
  * BatchMockCollector - Collects HTTP requests and sends them to the daemon for mock generation.
@@ -381,9 +503,17 @@ declare class BatchMockCollector {
     constructor(options?: BatchMockCollectorOptions);
     /**
      * Resolve projectRoot from options.
-     * Priority: projectRoot > filePath > undefined (auto-detect)
+     * Priority: projectRoot (if valid) > filePath > projectRoot (fallback) > undefined (auto-detect)
+     *
+     * A projectRoot is "valid" if it contains .git or package.json. This prevents
+     * accidentally using a wrong directory (e.g., user's home directory) when the
+     * caller mistakenly passes process.cwd() as projectRoot.
      */
     private resolveProjectRootFromOptions;
+    /**
+     * Check if a directory contains .git or package.json
+     */
+    private hasGitOrPackageJson;
     /**
      * Ensures the underlying connection is ready for use.
      */
@@ -469,4 +599,4 @@ interface MockClient {
  */
 declare const connect: (options?: ConnectOptions) => Promise<MockClient>;
 
-export { type AdapterOptions, BatchMockCollector, type BatchMockCollectorOptions, type ConnectOptions, DaemonClient, type DaemonRegistry, type MockClient, MockMcpDaemon, type MockMcpDaemonOptions, type MockRequestDescriptor, type MockResponseDescriptor, type RequestMockOptions, type ResolvedMock, computeProjectId, connect, ensureDaemonRunning, resolveProjectRoot, runAdapter };
+export { type ActiveDaemonEntry, type ActiveDaemonsIndex, type AdapterOptions, type AggregatedStatusResult, BatchMockCollector, type BatchMockCollectorOptions, type ConnectOptions, DaemonClient, type DaemonRegistry, type ExtendedRunInfo, type MockClient, MockMcpDaemon, type MockMcpDaemonOptions, type MockRequestDescriptor, type MockResponseDescriptor, MultiDaemonClient, type MultiDaemonClientOptions, type RequestMockOptions, type ResolvedMock, cleanupGlobalIndex, computeProjectId, connect, discoverAllDaemons, ensureDaemonRunning, readGlobalIndex, resolveProjectRoot, runAdapter };