mock-mcp 0.5.0 → 0.5.1

package/dist/shared/index.cjs

@@ -60,6 +60,27 @@ var __curDirname = (() => {
   }
   return process.cwd();
 })();
+function hasValidProjectMarker(dir) {
+  try {
+    const gitPath = path__default.default.join(dir, ".git");
+    try {
+      const stat = fssync__default.default.statSync(gitPath);
+      if (stat.isDirectory() || stat.isFile()) {
+        return true;
+      }
+    } catch {
+    }
+    const pkgPath = path__default.default.join(dir, "package.json");
+    try {
+      fssync__default.default.accessSync(pkgPath, fssync__default.default.constants.F_OK);
+      return true;
+    } catch {
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
 function resolveProjectRoot(startDir = process.cwd()) {
   let current = path__default.default.resolve(startDir);
   const root = path__default.default.parse(current).root;
@@ -194,7 +215,28 @@ function getDaemonEntryPath() {
   return path__default.default.join(process.cwd(), "dist", "index.js");
 }
 async function ensureDaemonRunning(opts = {}) {
-  const projectRoot = opts.projectRoot ?? resolveProjectRoot();
+  let projectRoot = opts.projectRoot ?? resolveProjectRoot();
+  if (!hasValidProjectMarker(projectRoot)) {
+    const resolved = resolveProjectRoot(projectRoot);
+    if (resolved !== projectRoot && hasValidProjectMarker(resolved)) {
+      console.error(`[mock-mcp] Warning: projectRoot "${projectRoot}" doesn't look like a project root`);
+      console.error(`[mock-mcp]   Found .git/package.json at: "${resolved}"`);
+      projectRoot = resolved;
+    } else {
+      console.error(`[mock-mcp] \u26A0\uFE0F  WARNING: Could not find a valid project root!`);
+      console.error(`[mock-mcp]   Current path: "${projectRoot}"`);
+      console.error(`[mock-mcp]   This path doesn't contain .git or package.json.`);
+      console.error(`[mock-mcp]   This may cause project mismatch issues.`);
+      console.error(`[mock-mcp]   `);
+      console.error(`[mock-mcp]   For MCP adapters, please specify --project-root explicitly:`);
+      console.error(`[mock-mcp]     mock-mcp adapter --project-root /path/to/your/project`);
+      console.error(`[mock-mcp]   `);
+      console.error(`[mock-mcp]   In your MCP client config (Cursor, Claude Desktop, etc.):`);
+      console.error(`[mock-mcp]   {`);
+      console.error(`[mock-mcp]     "args": ["-y", "mock-mcp", "adapter", "--project-root", "/path/to/your/project"]`);
+      console.error(`[mock-mcp]   }`);
+    }
+  }
   const projectId = computeProjectId(projectRoot);
   const { base, registryPath, lockPath, ipcPath } = getPaths(
     projectId,
@@ -302,6 +344,77 @@ ${daemonStderr}`);
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function getGlobalIndexPath(cacheDir) {
+  const base = path__default.default.join(getCacheDir(cacheDir), "mock-mcp");
+  return path__default.default.join(base, "active-daemons.json");
+}
+async function readGlobalIndex(cacheDir) {
+  const indexPath = getGlobalIndexPath(cacheDir);
+  try {
+    const txt = await fs__default.default.readFile(indexPath, "utf-8");
+    return JSON.parse(txt);
+  } catch {
+    return { daemons: [], updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  }
+}
+async function writeGlobalIndex(index, cacheDir) {
+  const indexPath = getGlobalIndexPath(cacheDir);
+  const base = path__default.default.dirname(indexPath);
+  await fs__default.default.mkdir(base, { recursive: true });
+  await fs__default.default.writeFile(indexPath, JSON.stringify(index, null, 2), {
+    encoding: "utf-8",
+    mode: 384
+  });
+}
+async function registerDaemonGlobally(entry, cacheDir) {
+  const index = await readGlobalIndex(cacheDir);
+  index.daemons = index.daemons.filter((d) => d.projectId !== entry.projectId);
+  index.daemons.push(entry);
+  index.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await writeGlobalIndex(index, cacheDir);
+  debugLog(`Registered daemon ${entry.projectId} in global index`);
+}
+async function unregisterDaemonGlobally(projectId, cacheDir) {
+  const index = await readGlobalIndex(cacheDir);
+  index.daemons = index.daemons.filter((d) => d.projectId !== projectId);
+  index.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await writeGlobalIndex(index, cacheDir);
+}
+async function cleanupGlobalIndex(cacheDir) {
+  const index = await readGlobalIndex(cacheDir);
+  const validDaemons = [];
+  for (const entry of index.daemons) {
+    try {
+      process.kill(entry.pid, 0);
+      const healthy = await healthCheck(entry.ipcPath, 1e3);
+      if (healthy) {
+        validDaemons.push(entry);
+      } else {
+        debugLog(`Removing unhealthy daemon ${entry.projectId} (pid ${entry.pid})`);
+      }
+    } catch {
+      debugLog(`Removing dead daemon ${entry.projectId} (pid ${entry.pid})`);
+    }
+  }
+  if (validDaemons.length !== index.daemons.length) {
+    index.daemons = validDaemons;
+    index.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    await writeGlobalIndex(index, cacheDir);
+  }
+}
+async function discoverAllDaemons(cacheDir) {
+  await cleanupGlobalIndex(cacheDir);
+  const index = await readGlobalIndex(cacheDir);
+  const results = [];
+  for (const entry of index.daemons) {
+    const registry = await readRegistry(entry.registryPath);
+    if (registry) {
+      const healthy = await healthCheck(entry.ipcPath, 2e3);
+      results.push({ registry, healthy });
+    }
+  }
+  return results;
+}
 
 // src/shared/protocol.ts
 var HELLO_TEST = "HELLO_TEST";
@@ -367,10 +480,13 @@ exports.RPC_GET_STATUS = RPC_GET_STATUS;
 exports.RPC_LIST_RUNS = RPC_LIST_RUNS;
 exports.RPC_PROVIDE_BATCH = RPC_PROVIDE_BATCH;
 exports.RPC_RELEASE_BATCH = RPC_RELEASE_BATCH;
+exports.cleanupGlobalIndex = cleanupGlobalIndex;
 exports.computeProjectId = computeProjectId;
+exports.discoverAllDaemons = discoverAllDaemons;
 exports.ensureDaemonRunning = ensureDaemonRunning;
 exports.getCacheDir = getCacheDir;
 exports.getDaemonEntryPath = getDaemonEntryPath;
+exports.getGlobalIndexPath = getGlobalIndexPath;
 exports.getPaths = getPaths;
 exports.healthCheck = healthCheck;
 exports.isBatchMockRequestMessage = isBatchMockRequestMessage;
@@ -378,9 +494,13 @@ exports.isHeartbeatMessage = isHeartbeatMessage;
 exports.isHelloTestMessage = isHelloTestMessage;
 exports.isJsonRpcRequest = isJsonRpcRequest;
 exports.randomToken = randomToken;
+exports.readGlobalIndex = readGlobalIndex;
 exports.readRegistry = readRegistry;
+exports.registerDaemonGlobally = registerDaemonGlobally;
 exports.releaseLock = releaseLock;
 exports.resolveProjectRoot = resolveProjectRoot;
 exports.sleep = sleep;
 exports.tryAcquireLock = tryAcquireLock;
+exports.unregisterDaemonGlobally = unregisterDaemonGlobally;
+exports.writeGlobalIndex = writeGlobalIndex;
 exports.writeRegistry = writeRegistry;

package/dist/shared/index.d.cts

@@ -1,4 +1,241 @@
-export { j as DaemonPaths, D as DaemonRegistry, E as EnsureDaemonOptions, c as computeProjectId, i as ensureDaemonRunning, g as getCacheDir, f as getDaemonEntryPath, a as getPaths, h as healthCheck, e as randomToken, b as readRegistry, d as releaseLock, r as resolveProjectRoot, s as sleep, t as tryAcquireLock, w as writeRegistry } from '../discovery-Dc2LdF8q.cjs';
-export { B as BATCH_MOCK_REQUEST, b as BATCH_MOCK_RESULT, y as BatchMockRequestMessage, z as BatchMockResultMessage, W as BatchRecord, U as BatchStatus, G as ClaimNextBatchParams, I as ClaimNextBatchResult, M as GetBatchParams, S as GetBatchResult, N as GetStatusResult, c as HEARTBEAT, d as HEARTBEAT_ACK, a as HELLO_ACK, H as HELLO_TEST, C as HeartbeatAckMessage, A as HeartbeatMessage, x as HelloAckMessage, w as HelloTestMessage, F as JsonRpcError, J as JsonRpcRequest, E as JsonRpcResponse, O as ListRunsResult, P as ProvideBatchParams, K as ProvideBatchResult, f as RPC_CLAIM_NEXT_BATCH, q as RPC_ERROR_CONFLICT, r as RPC_ERROR_EXPIRED, n as RPC_ERROR_INTERNAL, m as RPC_ERROR_INVALID_PARAMS, k as RPC_ERROR_INVALID_REQUEST, l as RPC_ERROR_METHOD_NOT_FOUND, o as RPC_ERROR_NOT_FOUND, j as RPC_ERROR_PARSE, p as RPC_ERROR_UNAUTHORIZED, i as RPC_GET_BATCH, R as RPC_GET_STATUS, e as RPC_LIST_RUNS, g as RPC_PROVIDE_BATCH, h as RPC_RELEASE_BATCH, L as ReleaseBatchParams, Q as RunInfo, V as RunRecord, T as TestChannelIncomingMessage, D as TestChannelOutgoingMessage, t as isBatchMockRequestMessage, u as isHeartbeatMessage, s as isHelloTestMessage, v as isJsonRpcRequest } from '../protocol-xZu-wb0n.cjs';
+import { a as MockRequestDescriptor, M as MockResponseDescriptor } from '../types-bEGXLBF0.cjs';
+export { A as ActiveDaemonEntry, v as ActiveDaemonsIndex, q as DaemonPaths, D as DaemonRegistry, E as EnsureDaemonOptions, o as cleanupGlobalIndex, c as computeProjectId, p as discoverAllDaemons, j as ensureDaemonRunning, g as getCacheDir, i as getDaemonEntryPath, k as getGlobalIndexPath, b as getPaths, h as healthCheck, f as randomToken, l as readGlobalIndex, d as readRegistry, n as registerDaemonGlobally, e as releaseLock, r as resolveProjectRoot, s as sleep, t as tryAcquireLock, u as unregisterDaemonGlobally, m as writeGlobalIndex, w as writeRegistry } from '../types-bEGXLBF0.cjs';
 import 'node:fs';
-import '../types-BKREdsyr.cjs';
+
+/**
+ * Protocol definitions for mock-mcp Daemon communication.
+ *
+ * Defines message types for:
+ * - Test channel (WebSocket /test): Test process ↔ Daemon
+ * - Control channel (HTTP /control): Adapter ↔ Daemon (JSON-RPC)
+ */
+
+declare const HELLO_TEST: "HELLO_TEST";
+declare const HELLO_ACK: "HELLO_ACK";
+declare const BATCH_MOCK_REQUEST: "BATCH_MOCK_REQUEST";
+declare const BATCH_MOCK_RESULT: "BATCH_MOCK_RESULT";
+declare const HEARTBEAT: "HEARTBEAT";
+declare const HEARTBEAT_ACK: "HEARTBEAT_ACK";
+declare const RPC_GET_STATUS: "getStatus";
+declare const RPC_LIST_RUNS: "listRuns";
+declare const RPC_CLAIM_NEXT_BATCH: "claimNextBatch";
+declare const RPC_PROVIDE_BATCH: "provideBatch";
+declare const RPC_RELEASE_BATCH: "releaseBatch";
+declare const RPC_GET_BATCH: "getBatch";
+/**
+ * HELLO message from test process to daemon.
+ * Must be the first message after WebSocket connection.
+ */
+interface HelloTestMessage {
+    type: typeof HELLO_TEST;
+    token: string;
+    runId: string;
+    pid: number;
+    cwd: string;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Acknowledgment of HELLO from daemon.
+ */
+interface HelloAckMessage {
+    type: typeof HELLO_ACK;
+    runId: string;
+}
+/**
+ * Batch mock request from test process.
+ */
+interface BatchMockRequestMessage {
+    type: typeof BATCH_MOCK_REQUEST;
+    runId: string;
+    requests: MockRequestDescriptor[];
+}
+/**
+ * Batch mock result from daemon to test process.
+ */
+interface BatchMockResultMessage {
+    type: typeof BATCH_MOCK_RESULT;
+    batchId: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Heartbeat from test process.
+ */
+interface HeartbeatMessage {
+    type: typeof HEARTBEAT;
+    runId: string;
+}
+/**
+ * Heartbeat acknowledgment from daemon.
+ */
+interface HeartbeatAckMessage {
+    type: typeof HEARTBEAT_ACK;
+    runId: string;
+}
+/**
+ * Union type for all test channel messages (from test process).
+ */
+type TestChannelIncomingMessage = HelloTestMessage | BatchMockRequestMessage | HeartbeatMessage;
+/**
+ * Union type for all test channel messages (from daemon).
+ */
+type TestChannelOutgoingMessage = HelloAckMessage | BatchMockResultMessage | HeartbeatAckMessage;
+/**
+ * JSON-RPC 2.0 request structure.
+ */
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * JSON-RPC 2.0 response structure.
+ */
+interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare const RPC_ERROR_PARSE = -32700;
+declare const RPC_ERROR_INVALID_REQUEST = -32600;
+declare const RPC_ERROR_METHOD_NOT_FOUND = -32601;
+declare const RPC_ERROR_INVALID_PARAMS = -32602;
+declare const RPC_ERROR_INTERNAL = -32603;
+declare const RPC_ERROR_NOT_FOUND = -32000;
+declare const RPC_ERROR_UNAUTHORIZED = -32001;
+declare const RPC_ERROR_CONFLICT = -32002;
+declare const RPC_ERROR_EXPIRED = -32003;
+/**
+ * Parameters for claimNextBatch RPC.
+ */
+interface ClaimNextBatchParams {
+    adapterId: string;
+    runId?: string;
+    leaseMs?: number;
+}
+/**
+ * Result of claimNextBatch RPC.
+ */
+interface ClaimNextBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    claimToken: string;
+    leaseUntil: number;
+}
+/**
+ * Parameters for provideBatch RPC.
+ */
+interface ProvideBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Result of provideBatch RPC.
+ */
+interface ProvideBatchResult {
+    ok: boolean;
+    message?: string;
+}
+/**
+ * Parameters for releaseBatch RPC.
+ */
+interface ReleaseBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    reason?: string;
+}
+/**
+ * Parameters for getBatch RPC.
+ */
+interface GetBatchParams {
+    batchId: string;
+}
+/**
+ * Result of getStatus RPC.
+ */
+interface GetStatusResult {
+    version: string;
+    projectId: string;
+    projectRoot: string;
+    pid: number;
+    uptime: number;
+    runs: number;
+    pending: number;
+    claimed: number;
+    totalBatches: number;
+}
+/**
+ * Result of listRuns RPC.
+ */
+interface ListRunsResult {
+    runs: RunInfo[];
+}
+interface RunInfo {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    pendingBatches: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Result of getBatch RPC.
+ */
+interface GetBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    status: BatchStatus;
+    createdAt: number;
+    claim?: {
+        adapterId: string;
+        leaseUntil: number;
+    };
+}
+type BatchStatus = "pending" | "claimed" | "fulfilled" | "expired";
+interface RunRecord {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+interface BatchRecord {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    createdAt: number;
+    status: BatchStatus;
+    claim?: {
+        adapterId: string;
+        claimToken: string;
+        leaseUntil: number;
+    };
+}
+declare function isHelloTestMessage(msg: unknown): msg is HelloTestMessage;
+declare function isBatchMockRequestMessage(msg: unknown): msg is BatchMockRequestMessage;
+declare function isHeartbeatMessage(msg: unknown): msg is HeartbeatMessage;
+declare function isJsonRpcRequest(msg: unknown): msg is JsonRpcRequest;
+
+export { BATCH_MOCK_REQUEST, BATCH_MOCK_RESULT, type BatchMockRequestMessage, type BatchMockResultMessage, type BatchRecord, type BatchStatus, type ClaimNextBatchParams, type ClaimNextBatchResult, type GetBatchParams, type GetBatchResult, type GetStatusResult, HEARTBEAT, HEARTBEAT_ACK, HELLO_ACK, HELLO_TEST, type HeartbeatAckMessage, type HeartbeatMessage, type HelloAckMessage, type HelloTestMessage, type JsonRpcError, type JsonRpcRequest, type JsonRpcResponse, type ListRunsResult, type ProvideBatchParams, type ProvideBatchResult, RPC_CLAIM_NEXT_BATCH, RPC_ERROR_CONFLICT, RPC_ERROR_EXPIRED, RPC_ERROR_INTERNAL, RPC_ERROR_INVALID_PARAMS, RPC_ERROR_INVALID_REQUEST, RPC_ERROR_METHOD_NOT_FOUND, RPC_ERROR_NOT_FOUND, RPC_ERROR_PARSE, RPC_ERROR_UNAUTHORIZED, RPC_GET_BATCH, RPC_GET_STATUS, RPC_LIST_RUNS, RPC_PROVIDE_BATCH, RPC_RELEASE_BATCH, type ReleaseBatchParams, type RunInfo, type RunRecord, type TestChannelIncomingMessage, type TestChannelOutgoingMessage, isBatchMockRequestMessage, isHeartbeatMessage, isHelloTestMessage, isJsonRpcRequest };

package/dist/shared/index.d.ts

@@ -1,4 +1,241 @@
-export { j as DaemonPaths, D as DaemonRegistry, E as EnsureDaemonOptions, c as computeProjectId, i as ensureDaemonRunning, g as getCacheDir, f as getDaemonEntryPath, a as getPaths, h as healthCheck, e as randomToken, b as readRegistry, d as releaseLock, r as resolveProjectRoot, s as sleep, t as tryAcquireLock, w as writeRegistry } from '../discovery-Dc2LdF8q.js';
-export { B as BATCH_MOCK_REQUEST, b as BATCH_MOCK_RESULT, y as BatchMockRequestMessage, z as BatchMockResultMessage, W as BatchRecord, U as BatchStatus, G as ClaimNextBatchParams, I as ClaimNextBatchResult, M as GetBatchParams, S as GetBatchResult, N as GetStatusResult, c as HEARTBEAT, d as HEARTBEAT_ACK, a as HELLO_ACK, H as HELLO_TEST, C as HeartbeatAckMessage, A as HeartbeatMessage, x as HelloAckMessage, w as HelloTestMessage, F as JsonRpcError, J as JsonRpcRequest, E as JsonRpcResponse, O as ListRunsResult, P as ProvideBatchParams, K as ProvideBatchResult, f as RPC_CLAIM_NEXT_BATCH, q as RPC_ERROR_CONFLICT, r as RPC_ERROR_EXPIRED, n as RPC_ERROR_INTERNAL, m as RPC_ERROR_INVALID_PARAMS, k as RPC_ERROR_INVALID_REQUEST, l as RPC_ERROR_METHOD_NOT_FOUND, o as RPC_ERROR_NOT_FOUND, j as RPC_ERROR_PARSE, p as RPC_ERROR_UNAUTHORIZED, i as RPC_GET_BATCH, R as RPC_GET_STATUS, e as RPC_LIST_RUNS, g as RPC_PROVIDE_BATCH, h as RPC_RELEASE_BATCH, L as ReleaseBatchParams, Q as RunInfo, V as RunRecord, T as TestChannelIncomingMessage, D as TestChannelOutgoingMessage, t as isBatchMockRequestMessage, u as isHeartbeatMessage, s as isHelloTestMessage, v as isJsonRpcRequest } from '../protocol-CiwaQFOt.js';
+import { a as MockRequestDescriptor, M as MockResponseDescriptor } from '../types-bEGXLBF0.js';
+export { A as ActiveDaemonEntry, v as ActiveDaemonsIndex, q as DaemonPaths, D as DaemonRegistry, E as EnsureDaemonOptions, o as cleanupGlobalIndex, c as computeProjectId, p as discoverAllDaemons, j as ensureDaemonRunning, g as getCacheDir, i as getDaemonEntryPath, k as getGlobalIndexPath, b as getPaths, h as healthCheck, f as randomToken, l as readGlobalIndex, d as readRegistry, n as registerDaemonGlobally, e as releaseLock, r as resolveProjectRoot, s as sleep, t as tryAcquireLock, u as unregisterDaemonGlobally, m as writeGlobalIndex, w as writeRegistry } from '../types-bEGXLBF0.js';
 import 'node:fs';
-import '../types-BKREdsyr.js';
+
+/**
+ * Protocol definitions for mock-mcp Daemon communication.
+ *
+ * Defines message types for:
+ * - Test channel (WebSocket /test): Test process ↔ Daemon
+ * - Control channel (HTTP /control): Adapter ↔ Daemon (JSON-RPC)
+ */
+
+declare const HELLO_TEST: "HELLO_TEST";
+declare const HELLO_ACK: "HELLO_ACK";
+declare const BATCH_MOCK_REQUEST: "BATCH_MOCK_REQUEST";
+declare const BATCH_MOCK_RESULT: "BATCH_MOCK_RESULT";
+declare const HEARTBEAT: "HEARTBEAT";
+declare const HEARTBEAT_ACK: "HEARTBEAT_ACK";
+declare const RPC_GET_STATUS: "getStatus";
+declare const RPC_LIST_RUNS: "listRuns";
+declare const RPC_CLAIM_NEXT_BATCH: "claimNextBatch";
+declare const RPC_PROVIDE_BATCH: "provideBatch";
+declare const RPC_RELEASE_BATCH: "releaseBatch";
+declare const RPC_GET_BATCH: "getBatch";
+/**
+ * HELLO message from test process to daemon.
+ * Must be the first message after WebSocket connection.
+ */
+interface HelloTestMessage {
+    type: typeof HELLO_TEST;
+    token: string;
+    runId: string;
+    pid: number;
+    cwd: string;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Acknowledgment of HELLO from daemon.
+ */
+interface HelloAckMessage {
+    type: typeof HELLO_ACK;
+    runId: string;
+}
+/**
+ * Batch mock request from test process.
+ */
+interface BatchMockRequestMessage {
+    type: typeof BATCH_MOCK_REQUEST;
+    runId: string;
+    requests: MockRequestDescriptor[];
+}
+/**
+ * Batch mock result from daemon to test process.
+ */
+interface BatchMockResultMessage {
+    type: typeof BATCH_MOCK_RESULT;
+    batchId: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Heartbeat from test process.
+ */
+interface HeartbeatMessage {
+    type: typeof HEARTBEAT;
+    runId: string;
+}
+/**
+ * Heartbeat acknowledgment from daemon.
+ */
+interface HeartbeatAckMessage {
+    type: typeof HEARTBEAT_ACK;
+    runId: string;
+}
+/**
+ * Union type for all test channel messages (from test process).
+ */
+type TestChannelIncomingMessage = HelloTestMessage | BatchMockRequestMessage | HeartbeatMessage;
+/**
+ * Union type for all test channel messages (from daemon).
+ */
+type TestChannelOutgoingMessage = HelloAckMessage | BatchMockResultMessage | HeartbeatAckMessage;
+/**
+ * JSON-RPC 2.0 request structure.
+ */
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * JSON-RPC 2.0 response structure.
+ */
+interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare const RPC_ERROR_PARSE = -32700;
+declare const RPC_ERROR_INVALID_REQUEST = -32600;
+declare const RPC_ERROR_METHOD_NOT_FOUND = -32601;
+declare const RPC_ERROR_INVALID_PARAMS = -32602;
+declare const RPC_ERROR_INTERNAL = -32603;
+declare const RPC_ERROR_NOT_FOUND = -32000;
+declare const RPC_ERROR_UNAUTHORIZED = -32001;
+declare const RPC_ERROR_CONFLICT = -32002;
+declare const RPC_ERROR_EXPIRED = -32003;
+/**
+ * Parameters for claimNextBatch RPC.
+ */
+interface ClaimNextBatchParams {
+    adapterId: string;
+    runId?: string;
+    leaseMs?: number;
+}
+/**
+ * Result of claimNextBatch RPC.
+ */
+interface ClaimNextBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    claimToken: string;
+    leaseUntil: number;
+}
+/**
+ * Parameters for provideBatch RPC.
+ */
+interface ProvideBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Result of provideBatch RPC.
+ */
+interface ProvideBatchResult {
+    ok: boolean;
+    message?: string;
+}
+/**
+ * Parameters for releaseBatch RPC.
+ */
+interface ReleaseBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    reason?: string;
+}
+/**
+ * Parameters for getBatch RPC.
+ */
+interface GetBatchParams {
+    batchId: string;
+}
+/**
+ * Result of getStatus RPC.
+ */
+interface GetStatusResult {
+    version: string;
+    projectId: string;
+    projectRoot: string;
+    pid: number;
+    uptime: number;
+    runs: number;
+    pending: number;
+    claimed: number;
+    totalBatches: number;
+}
+/**
+ * Result of listRuns RPC.
+ */
+interface ListRunsResult {
+    runs: RunInfo[];
+}
+interface RunInfo {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    pendingBatches: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Result of getBatch RPC.
+ */
+interface GetBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    status: BatchStatus;
+    createdAt: number;
+    claim?: {
+        adapterId: string;
+        leaseUntil: number;
+    };
+}
+type BatchStatus = "pending" | "claimed" | "fulfilled" | "expired";
+interface RunRecord {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+interface BatchRecord {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    createdAt: number;
+    status: BatchStatus;
+    claim?: {
+        adapterId: string;
+        claimToken: string;
+        leaseUntil: number;
+    };
+}
+declare function isHelloTestMessage(msg: unknown): msg is HelloTestMessage;
+declare function isBatchMockRequestMessage(msg: unknown): msg is BatchMockRequestMessage;
+declare function isHeartbeatMessage(msg: unknown): msg is HeartbeatMessage;
+declare function isJsonRpcRequest(msg: unknown): msg is JsonRpcRequest;
+
+export { BATCH_MOCK_REQUEST, BATCH_MOCK_RESULT, type BatchMockRequestMessage, type BatchMockResultMessage, type BatchRecord, type BatchStatus, type ClaimNextBatchParams, type ClaimNextBatchResult, type GetBatchParams, type GetBatchResult, type GetStatusResult, HEARTBEAT, HEARTBEAT_ACK, HELLO_ACK, HELLO_TEST, type HeartbeatAckMessage, type HeartbeatMessage, type HelloAckMessage, type HelloTestMessage, type JsonRpcError, type JsonRpcRequest, type JsonRpcResponse, type ListRunsResult, type ProvideBatchParams, type ProvideBatchResult, RPC_CLAIM_NEXT_BATCH, RPC_ERROR_CONFLICT, RPC_ERROR_EXPIRED, RPC_ERROR_INTERNAL, RPC_ERROR_INVALID_PARAMS, RPC_ERROR_INVALID_REQUEST, RPC_ERROR_METHOD_NOT_FOUND, RPC_ERROR_NOT_FOUND, RPC_ERROR_PARSE, RPC_ERROR_UNAUTHORIZED, RPC_GET_BATCH, RPC_GET_STATUS, RPC_LIST_RUNS, RPC_PROVIDE_BATCH, RPC_RELEASE_BATCH, type ReleaseBatchParams, type RunInfo, type RunRecord, type TestChannelIncomingMessage, type TestChannelOutgoingMessage, isBatchMockRequestMessage, isHeartbeatMessage, isHelloTestMessage, isJsonRpcRequest };