mock-mcp 0.3.1 → 0.5.1

package/dist/adapter/index.d.cts

@@ -0,0 +1,142 @@
+import { GetStatusResult, ListRunsResult, ClaimNextBatchResult, ProvideBatchResult, GetBatchResult, RunInfo } from '../shared/index.cjs';
+import { M as MockResponseDescriptor, D as DaemonRegistry } from '../types-bEGXLBF0.cjs';
+import 'node:fs';
+
+/**
+ * MCP Adapter - The MCP stdio server that bridges AI clients to the Daemon.
+ *
+ * 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)
+ * - 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"> & {
+    debug?: (...args: unknown[]) => void;
+};
+interface AdapterOptions {
+    logger?: Logger$1;
+    version?: string;
+}
+declare function runAdapter(opts?: AdapterOptions): Promise<void>;
+
+/**
+ * Daemon Client - HTTP/JSON-RPC client for communicating with the Daemon.
+ *
+ * Used by the MCP Adapter to call daemon RPC methods.
+ */
+
+declare class DaemonClient {
+    private readonly ipcPath;
+    private readonly token;
+    private readonly adapterId;
+    constructor(ipcPath: string, token: string, adapterId: string);
+    getStatus(): Promise<GetStatusResult>;
+    listRuns(): Promise<ListRunsResult>;
+    claimNextBatch(args: {
+        runId?: string;
+        leaseMs?: number;
+    }): Promise<ClaimNextBatchResult | null>;
+    provideBatch(args: {
+        batchId: string;
+        claimToken: string;
+        mocks: MockResponseDescriptor[];
+    }): Promise<ProvideBatchResult>;
+    releaseBatch(args: {
+        batchId: string;
+        claimToken: string;
+        reason?: string;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    getBatch(batchId: string): Promise<GetBatchResult>;
+    private rpc;
+}
+
+/**
+ * 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 = Pick<Console, "log" | "warn" | "error"> & {
+    debug?: (...args: unknown[]) => void;
+};
+interface MultiDaemonClientOptions {
+    logger?: Logger;
+    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;
+}
+
+export { type AdapterOptions, type AggregatedStatusResult, DaemonClient, type ExtendedRunInfo, MultiDaemonClient, type MultiDaemonClientOptions, runAdapter };

package/dist/adapter/index.d.ts

@@ -0,0 +1,142 @@
+import { GetStatusResult, ListRunsResult, ClaimNextBatchResult, ProvideBatchResult, GetBatchResult, RunInfo } from '../shared/index.js';
+import { M as MockResponseDescriptor, D as DaemonRegistry } from '../types-bEGXLBF0.js';
+import 'node:fs';
+
+/**
+ * MCP Adapter - The MCP stdio server that bridges AI clients to the Daemon.
+ *
+ * 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)
+ * - 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"> & {
+    debug?: (...args: unknown[]) => void;
+};
+interface AdapterOptions {
+    logger?: Logger$1;
+    version?: string;
+}
+declare function runAdapter(opts?: AdapterOptions): Promise<void>;
+
+/**
+ * Daemon Client - HTTP/JSON-RPC client for communicating with the Daemon.
+ *
+ * Used by the MCP Adapter to call daemon RPC methods.
+ */
+
+declare class DaemonClient {
+    private readonly ipcPath;
+    private readonly token;
+    private readonly adapterId;
+    constructor(ipcPath: string, token: string, adapterId: string);
+    getStatus(): Promise<GetStatusResult>;
+    listRuns(): Promise<ListRunsResult>;
+    claimNextBatch(args: {
+        runId?: string;
+        leaseMs?: number;
+    }): Promise<ClaimNextBatchResult | null>;
+    provideBatch(args: {
+        batchId: string;
+        claimToken: string;
+        mocks: MockResponseDescriptor[];
+    }): Promise<ProvideBatchResult>;
+    releaseBatch(args: {
+        batchId: string;
+        claimToken: string;
+        reason?: string;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    getBatch(batchId: string): Promise<GetBatchResult>;
+    private rpc;
+}
+
+/**
+ * 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 = Pick<Console, "log" | "warn" | "error"> & {
+    debug?: (...args: unknown[]) => void;
+};
+interface MultiDaemonClientOptions {
+    logger?: Logger;
+    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;
+}
+
+export { type AdapterOptions, type AggregatedStatusResult, DaemonClient, type ExtendedRunInfo, MultiDaemonClient, type MultiDaemonClientOptions, runAdapter };