@inspectr/mcplab 1.28.4 → 1.29.0

package/dist/app-server/rover-connection.js

@@ -0,0 +1,172 @@
+import { WebSocketServer, WebSocket } from 'ws';
+import { randomUUID } from 'node:crypto';
+import { ROVER_CAPABILITIES, ROVER_PROTOCOL_VERSION as CORE_ROVER_PROTOCOL_VERSION } from '@inspectr/mcplab-core';
+export const ROVER_ASSIGNMENT_LEASE_CAPABILITY = ROVER_CAPABILITIES[1];
+export const ROVER_PROTOCOL_VERSION = CORE_ROVER_PROTOCOL_VERSION;
+export function validateRoverRegistration(message) {
+    if (message.type !== 'register' ||
+        message.protocolVersion !== ROVER_PROTOCOL_VERSION ||
+        typeof message.provider !== 'string' ||
+        typeof message.pageUrl !== 'string' ||
+        typeof message.extensionVersion !== 'string') {
+        return { ok: false, code: 'invalid_registration', message: 'Rover registration required' };
+    }
+    if (!Array.isArray(message.capabilities) ||
+        !message.capabilities.includes(ROVER_ASSIGNMENT_LEASE_CAPABILITY)) {
+        return { ok: false, code: 'lease_required', message: 'Rover assignment leases are required' };
+    }
+    return { ok: true };
+}
+function timestampedLog(message) {
+    return `[mcplab-app] [${new Date().toISOString()}] ${message}`;
+}
+export function createRoverConnectionService(options = {}) {
+    const log = options.log ?? console.log;
+    const wss = new WebSocketServer({ noServer: true });
+    let current = null;
+    let closed = false;
+    const heartbeat = setInterval(() => {
+        if (closed || !current)
+            return;
+        if (Date.now() - Date.parse(current.lastSeenAt) > 45_000) {
+            current.socket.terminate();
+            return;
+        }
+        if (current.socket.readyState === WebSocket.OPEN)
+            current.socket.ping();
+    }, 15_000);
+    const parse = (raw) => {
+        try {
+            const value = JSON.parse(raw.toString());
+            return value &&
+                typeof value === 'object' &&
+                typeof value.type === 'string'
+                ? value
+                : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const send = (socket, message) => {
+        if (socket.readyState !== WebSocket.OPEN)
+            return false;
+        socket.send(JSON.stringify(message));
+        return true;
+    };
+    wss.on('connection', (socket) => {
+        let connection = null;
+        socket.on('message', (raw) => {
+            const message = parse(raw);
+            if (!message) {
+                socket.close(1003, 'Invalid Rover message');
+                return;
+            }
+            if (!connection) {
+                const registrationError = validateRoverRegistration(message);
+                if (!registrationError.ok && registrationError.code === 'invalid_registration') {
+                    socket.close(1008, registrationError.message);
+                    return;
+                }
+                if (!registrationError.ok) {
+                    send(socket, { type: 'rejected', reason: registrationError.message });
+                    socket.close(1008, registrationError.message);
+                    return;
+                }
+                if (current && current.socket.readyState === WebSocket.OPEN) {
+                    send(socket, { type: 'rejected', reason: 'another Rover is already connected' });
+                    socket.close(1008, 'Another Rover is already connected');
+                    return;
+                }
+                const now = new Date().toISOString();
+                const provider = message.provider;
+                const pageUrl = message.pageUrl;
+                const extensionVersion = message.extensionVersion;
+                connection = {
+                    connectionId: randomUUID(),
+                    registrationVersion: 1,
+                    registration: {
+                        protocolVersion: ROVER_PROTOCOL_VERSION,
+                        provider,
+                        ...(typeof message.providerRevision === 'string'
+                            ? { providerRevision: message.providerRevision }
+                            : {}),
+                        pageUrl,
+                        extensionVersion,
+                        capabilities: Array.isArray(message.capabilities)
+                            ? message.capabilities.filter((value) => typeof value === 'string')
+                            : []
+                    },
+                    socket,
+                    connectedAt: now,
+                    lastSeenAt: now
+                };
+                current = connection;
+                const registeredConnection = connection;
+                send(socket, {
+                    type: 'registered',
+                    protocolVersion: ROVER_PROTOCOL_VERSION,
+                    connectedAt: now,
+                    capabilities: [ROVER_ASSIGNMENT_LEASE_CAPABILITY]
+                });
+                log(timestampedLog(`Rover connected: ${registeredConnection.registration.provider}`));
+                void options.onRegister?.(registeredConnection);
+                return;
+            }
+            connection.lastSeenAt = new Date().toISOString();
+            if (message.type === 'register_update') {
+                if (typeof message.provider !== 'string' || !message.provider.trim())
+                    return;
+                connection.registrationVersion += 1;
+                connection.registration = {
+                    ...connection.registration,
+                    provider: message.provider,
+                    ...(typeof message.providerRevision === 'string'
+                        ? { providerRevision: message.providerRevision }
+                        : {}),
+                    pageUrl: String(message.pageUrl ?? connection.registration.pageUrl)
+                };
+                send(socket, {
+                    type: 'registered',
+                    protocolVersion: ROVER_PROTOCOL_VERSION,
+                    connectedAt: connection.connectedAt,
+                    capabilities: [ROVER_ASSIGNMENT_LEASE_CAPABILITY]
+                });
+                log(timestampedLog(`Rover provider updated: ${connection.registration.provider} (${connection.registration.pageUrl})`));
+            }
+            void options.onMessage?.(connection, message);
+        });
+        socket.on('close', () => {
+            if (current?.socket !== socket)
+                return;
+            const disconnected = current;
+            current = null;
+            log(timestampedLog(`Rover disconnected: ${disconnected.registration.provider}`));
+            void options.onDisconnect?.(disconnected);
+        });
+        socket.on('pong', () => {
+            if (connection)
+                connection.lastSeenAt = new Date().toISOString();
+        });
+        socket.on('error', () => undefined);
+    });
+    return {
+        upgrade(req, socket, head) {
+            if (closed || req.url?.split('?')[0] !== '/api/rover/ws')
+                return false;
+            wss.handleUpgrade(req, socket, head, (upgraded) => wss.emit('connection', upgraded, req));
+            return true;
+        },
+        connection: () => current,
+        send: (message) => (current ? send(current.socket, message) : false),
+        broadcast: (message) => (current ? send(current.socket, message) : false),
+        close: () => {
+            closed = true;
+            clearInterval(heartbeat);
+            current?.socket.close(1001, 'MCPLab shutting down');
+            current = null;
+            wss.close();
+        }
+    };
+}
+//# sourceMappingURL=rover-connection.js.map

package/dist/app-server/rover-connection.js.map

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

package/dist/app-server/run-agent-selection.d.ts

@@ -1,6 +1,3 @@
 import type { EvalConfig } from '@inspectr/mcplab-core';
-export declare function resolveRunSelectedAgents(
-  config: EvalConfig,
-  requestedAgents?: string[]
-): string[];
-//# sourceMappingURL=run-agent-selection.d.ts.map
+export declare function resolveRunSelectedAgents(config: EvalConfig, requestedAgents?: string[]): string[];
+//# sourceMappingURL=run-agent-selection.d.ts.map

package/dist/app-server/run-queue-domain.d.ts

@@ -1,80 +1,104 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { AppRouteDeps, AppRouteRequestContext } from './app-context.js';
 import { buildQueueState } from './run-queue-events.js';
-import {
-  type QueueAdvanceOptions,
-  type RunJob,
-  type RunParams,
-  type RunQueueState
-} from './run-queue-state.js';
+import { type QueueAdvanceOptions, type RunJob, type RunParams, type RunQueueState } from './run-queue-state.js';
 import type { OAuthSessionManager } from './oauth-session-manager.js';
-export type QueueServiceDeps = Pick<
-  AppRouteDeps,
-  | 'addJobEvent'
-  | 'sendSseEvent'
-  | 'getScenarioRunTraceRecords'
-  | 'selectScenarioIds'
-  | 'expandConfigForAgents'
-  | 'resolveRunSelectedAgents'
-  | 'readLibraries'
-  | 'pkgVersion'
->;
+import type { RoverSocketMessage } from './rover-connection.js';
+export type QueueServiceDeps = Pick<AppRouteDeps, 'addJobEvent' | 'sendSseEvent' | 'getScenarioRunTraceRecords' | 'selectScenarioIds' | 'expandConfigForAgents' | 'resolveRunSelectedAgents' | 'readLibraries' | 'pkgVersion' | 'getRunResults'>;
 export type EnqueueResult = {
-  jobId: string;
-  queued?: boolean;
-  position?: number;
+    jobId: string;
+    queued?: boolean;
+    position?: number;
+};
+export type RoverAssignmentWorker = {
+    connectionId: string;
+    registrationVersion?: number;
+    provider: string;
+    providerRevision?: string;
+    capabilities?: string[];
 };
 export interface RunQueueService {
-  jobs: Map<string, RunJob>;
-  state: RunQueueState;
-  enqueueRun(
-    runParams: RunParams,
-    options?: {
-      hostHeader?: string;
-    }
-  ): EnqueueResult;
-  stopJob(
-    jobId: string,
-    options?: {
-      hostHeader?: string;
-    }
-  ): {
-    ok: boolean;
-    status: string;
-  } | null;
-  removeQueuedJob(
-    jobId: string,
-    options?: {
-      hostHeader?: string;
-    }
-  ):
-    | {
+    jobs: Map<string, RunJob>;
+    state: RunQueueState;
+    enqueueRun(runParams: RunParams, options?: {
+        hostHeader?: string;
+    }): EnqueueResult;
+    stopJob(jobId: string, options?: {
+        hostHeader?: string;
+    }): {
+        ok: boolean;
+        status: string;
+    } | null;
+    stopEvaluationRun(evaluationRunId: string, options?: {
+        hostHeader?: string;
+    }): {
+        ok: true;
+        stopped: number;
+    } | null;
+    removeEvaluationRun(evaluationRunId: string, options?: {
+        hostHeader?: string;
+    }): {
         ok: true;
+        removed: number;
+    } | {
+        error: string;
+        statusCode: number;
+    } | null;
+    removeQueuedJob(jobId: string, options?: {
+        hostHeader?: string;
+    }): {
+        ok: true;
+        jobId: string;
+        status: 'stopped';
+    } | {
+        error: string;
+        statusCode: number;
+    } | null;
+    resumeBlockedJobs(options?: {
+        hostHeader?: string;
+    }): void;
+    getQueueState(): ReturnType<typeof buildQueueState>;
+    getWaitingRoverJobs(provider: string): Array<{
         jobId: string;
+        evaluationName?: string;
+        provider: string;
+        position: number;
+    }>;
+    subscribeQueue(req: IncomingMessage, res: ServerResponse): void;
+    advance(options?: QueueAdvanceOptions): Promise<void>;
+    setWorkerCount(workerCount: number, options?: {
+        hostHeader?: string;
+    }): void;
+    closeSubscribers(): void;
+    assignRoverJob(provider: string, send: (message: RoverSocketMessage) => boolean, worker?: RoverAssignmentWorker): RunJob | null;
+    rebindRoverLeases(provider: string, worker: RoverAssignmentWorker): void;
+    pauseRoverJob(jobId: string, connectionId?: string): void;
+    resumeRoverJob(jobId: string): boolean;
+    completeRoverJob(jobId: string, payload?: Record<string, unknown>): void;
+    stopRoverScenario(jobId: string, scenarioId: string): {
+        ok: true;
+        status: 'stopped';
+    } | {
+        error: string;
+        statusCode: number;
+    } | null;
+    stopScenario(jobId: string, scenarioId: string, agentName?: string): {
+        ok: true;
         status: 'stopped';
-      }
-    | {
+    } | {
         error: string;
         statusCode: number;
-      }
-    | null;
-  resumeBlockedJobs(options?: { hostHeader?: string }): void;
-  getQueueState(): ReturnType<typeof buildQueueState>;
-  subscribeQueue(req: IncomingMessage, res: ServerResponse): void;
-  advance(options?: QueueAdvanceOptions): Promise<void>;
-  setWorkerCount(
-    workerCount: number,
-    options?: {
-      hostHeader?: string;
-    }
-  ): void;
-  closeSubscribers(): void;
+    } | null;
+    handleRoverMessage(message: RoverSocketMessage, provider: string, send: (message: RoverSocketMessage) => boolean, worker?: RoverAssignmentWorker): string | null;
 }
 export declare function createRunQueueService(params: {
-  settings: AppRouteRequestContext['settings'];
-  oauthSessionManager: OAuthSessionManager;
-  deps: QueueServiceDeps;
-  jobs?: Map<string, RunJob>;
-  state?: RunQueueState;
+    settings: AppRouteRequestContext['settings'];
+    oauthSessionManager: OAuthSessionManager;
+    deps: QueueServiceDeps;
+    jobs?: Map<string, RunJob>;
+    state?: RunQueueState;
+    sendRoverMessage?: (message: RoverSocketMessage) => boolean;
+    assignRoverJob?: (provider: string, worker?: RoverAssignmentWorker) => RunJob | null;
+    onRoverJobReleased?: (provider: string, jobId: string) => void;
 }): RunQueueService;
-//# sourceMappingURL=run-queue-domain.d.ts.map
+//# sourceMappingURL=run-queue-domain.d.ts.map

package/dist/app-server/run-queue-domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-queue-domain.d.ts","sourceRoot":"","sources":["../../src/app-server/run-queue-domain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAkB,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AAEzF,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,YAAY,EACV,aAAa,GACb,cAAc,GACd,4BAA4B,GAC5B,mBAAmB,GACnB,uBAAuB,GACvB,0BAA0B,GAC1B,eAAe,GACf,YAAY,CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC;IACnF,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClG,eAAe,CACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAChC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjG,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,aAAa,IAAI,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IACpD,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAChE,OAAO,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7E,gBAAgB,IAAI,IAAI,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,eAAe,CAkZlB"}
+{"version":3,"file":"run-queue-domain.d.ts","sourceRoot":"","sources":["../../src/app-server/run-queue-domain.ts"],"names":[],"mappings":"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"}