rbxstudio-mcp 2.3.1 → 2.4.0

package/dist/bridge-service.d.ts

@@ -3,12 +3,43 @@ export interface TestSessionLogEntry {
     message: string;
     messageType: string;
     timestamp: number;
-    source: 'server' | 'plugin';
+    source: 'server' | 'plugin' | 'client';
 }
 export interface TestSessionCommand {
-    cmd: 'end';
+    cmd: 'end' | 'eval';
     args?: any;
 }
+export interface EvalReplyPayload {
+    ok: boolean;
+    values?: any[];
+    errorType?: 'compile_error' | 'runtime_error' | 'timeout' | 'loadstring_disabled' | 'companion_error';
+    error?: string;
+    traceback?: string;
+    logs?: Array<{
+        message: string;
+        messageType: string;
+        timestamp: number;
+    }>;
+    durationMs?: number;
+}
+export interface TestClientState {
+    userId: number;
+    name: string;
+    loadstringReady: boolean;
+    ready: boolean;
+    registeredAt: number;
+    lastPolledAt: number;
+    pendingCommands: TestSessionCommand[];
+}
+interface PendingEvalReply {
+    resolve: (payload: EvalReplyPayload) => void;
+    timeoutHandle: ReturnType<typeof setTimeout>;
+    target: 'server' | {
+        client: number;
+    };
+    claimed: boolean;
+    startedAt: number;
+}
 export interface TestSessionState {
     sessionId: string;
     status: 'active' | 'ended';
@@ -16,9 +47,14 @@ export interface TestSessionState {
     endedAt: number | null;
     endReason: string | null;
     endValue: any;
-    pendingCommands: TestSessionCommand[];
+    serverReady: boolean;
+    serverLoadstringReady: boolean;
+    serverLastPolledAt: number;
+    clients: Map<number, TestClientState>;
+    pendingCommandsServer: TestSessionCommand[];
     outputBuffer: TestSessionLogEntry[];
     outputSeq: number;
+    evalReplies: Map<string, PendingEvalReply>;
     endWaiters: Array<(ended: boolean) => void>;
 }
 export declare class BridgeService {
@@ -56,22 +92,38 @@ export declare class BridgeService {
      */
     endTestSession(sessionId: string, reason: string, value?: any): boolean;
     /**
-     * Queue a command for the companion to pick up on its next poll.
-     * Currently the only command is 'end'.
+     * Queue a command for either the server companion or a specific client
+     * companion. Defaults to the server queue (preserves prior call-site
+     * behavior for the existing 'end' command path).
+     *
+     * Returns false if the targeted queue doesn't exist (e.g. no such
+     * client), the session is null/ended, etc.
      */
-    enqueueTestCommand(cmd: TestSessionCommand): boolean;
+    enqueueTestCommand(cmd: TestSessionCommand, target?: 'server' | {
+        client: number;
+    }): boolean;
     /**
-     * Companion poll: returns the oldest pending command, or null if none.
-     * If the session was already marked ended, signals that so the companion
-     * stops polling.
+     * Companion poll: returns the oldest pending command for this target,
+     * or null if none. If the session was already marked ended, signals
+     * that so the companion stops polling.
+     *
+     * The hello payload (sent by a companion on its first poll) registers
+     * its readiness state. Server companion sends `{ loadstringReady }`;
+     * client companions add `{ userId, name, loadstringReady }`.
      */
-    popTestCommand(sessionId: string): {
+    popTestCommand(sessionId: string, target?: 'server' | 'client', options?: {
+        userId?: number;
+        playerName?: string;
+        hello?: {
+            loadstringReady?: boolean;
+        };
+    }): {
         command: TestSessionCommand | null;
         ended: boolean;
         sessionMatch: boolean;
     };
     /**
-     * Append a batch of log entries from the companion. Drops oldest entries
+     * Append a batch of log entries from a companion. Drops oldest entries
      * if the buffer would exceed MAX_OUTPUT_BUFFER. Each entry gets a
      * monotonically increasing seq for "since" cursor support.
      */
@@ -79,7 +131,7 @@ export declare class BridgeService {
         message: string;
         messageType: string;
         timestamp: number;
-    }>, source?: 'server' | 'plugin'): {
+    }>, source?: 'server' | 'plugin' | 'client'): {
         accepted: number;
         sessionMatch: boolean;
     };
@@ -107,5 +159,40 @@ export declare class BridgeService {
      * active session, resolves true immediately.
      */
     waitForTestEnd(timeoutMs: number): Promise<boolean>;
+    /**
+     * Snapshot of companion readiness for diagnostic / pre-flight callers.
+     * Returns null if no session is tracked.
+     */
+    getTestSessionStatus(): null | {
+        sessionId: string;
+        status: 'active' | 'ended';
+        serverReady: boolean;
+        serverLoadstringReady: boolean;
+        clients: Array<{
+            userId: number;
+            name: string;
+            ready: boolean;
+            loadstringReady: boolean;
+        }>;
+    };
+    /**
+     * Register a pending eval and return a Promise that resolves with the
+     * companion's reply (or a synthetic timeout reply).
+     *
+     * The watchdog fires at `timeoutMs + EVAL_GRACE_MS`, capped at
+     * EVAL_HARD_CAP_MS. If the command was never claimed by a companion,
+     * we surface `companion_error` (companion unreachable) rather than
+     * `timeout` so the AI can distinguish "infinite loop in user code"
+     * from "no companion picked up the work".
+     */
+    registerEvalReply(replyId: string, target: 'server' | {
+        client: number;
+    }, timeoutMs: number): Promise<EvalReplyPayload>;
+    /**
+     * Companion-side eval result delivery. Idempotent w.r.t. the same
+     * replyId. Returns true if the reply was matched and dispatched.
+     */
+    resolveEvalReply(sessionId: string, replyId: string, payload: EvalReplyPayload): boolean;
 }
+export {};
 //# sourceMappingURL=bridge-service.d.ts.map

package/dist/bridge-service.d.ts.map

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

package/dist/bridge-service.js

@@ -1,5 +1,11 @@
-import { v4 as uuidv4 } from 'uuid';
+import { randomUUID } from 'node:crypto';
 const MAX_OUTPUT_BUFFER = 5000;
+// How long after the user-supplied timeoutMs we keep waiting before giving
+// up entirely. Accounts for HTTP RTT + companion poll latency.
+const EVAL_GRACE_MS = 1500;
+// Hard cap on how long a single eval can take before we abandon the reply
+// slot regardless of what the companion claims.
+const EVAL_HARD_CAP_MS = 60_000;
 export class BridgeService {
     pendingRequests = new Map();
     requestTimeout = 30000; // 30 seconds timeout
@@ -8,24 +14,24 @@ export class BridgeService {
     // startTestSession call.
     testSession = null;
     async sendRequest(endpoint, data) {
-        const requestId = uuidv4();
+        const requestId = randomUUID();
         return new Promise((resolve, reject) => {
+            const timeoutHandle = setTimeout(() => {
+                if (this.pendingRequests.has(requestId)) {
+                    this.pendingRequests.delete(requestId);
+                    reject(new Error('Request timeout'));
+                }
+            }, this.requestTimeout);
             const request = {
                 id: requestId,
                 endpoint,
                 data,
                 timestamp: Date.now(),
+                timeoutHandle,
                 resolve,
                 reject
             };
             this.pendingRequests.set(requestId, request);
-            // Set timeout
-            setTimeout(() => {
-                if (this.pendingRequests.has(requestId)) {
-                    this.pendingRequests.delete(requestId);
-                    reject(new Error('Request timeout'));
-                }
-            }, this.requestTimeout);
         });
     }
     getPendingRequest() {
@@ -51,6 +57,7 @@ export class BridgeService {
         const request = this.pendingRequests.get(requestId);
         if (request) {
             this.pendingRequests.delete(requestId);
+            clearTimeout(request.timeoutHandle);
             request.resolve(response);
         }
     }
@@ -58,6 +65,7 @@ export class BridgeService {
         const request = this.pendingRequests.get(requestId);
         if (request) {
             this.pendingRequests.delete(requestId);
+            clearTimeout(request.timeoutHandle);
             request.reject(error);
         }
     }
@@ -67,6 +75,7 @@ export class BridgeService {
         for (const [id, request] of this.pendingRequests.entries()) {
             if (now - request.timestamp > this.requestTimeout) {
                 this.pendingRequests.delete(id);
+                clearTimeout(request.timeoutHandle);
                 request.reject(new Error('Request timeout'));
             }
         }
@@ -74,6 +83,7 @@ export class BridgeService {
     // Force cleanup all pending requests (used on disconnect)
     clearAllPendingRequests() {
         for (const [, request] of this.pendingRequests.entries()) {
+            clearTimeout(request.timeoutHandle);
             request.reject(new Error('Connection closed'));
         }
         this.pendingRequests.clear();
@@ -94,7 +104,7 @@ export class BridgeService {
         if (this.testSession && this.testSession.status === 'active') {
             this.markTestSessionEnded('superseded');
         }
-        const sessionId = uuidv4();
+        const sessionId = randomUUID();
         this.testSession = {
             sessionId,
             status: 'active',
@@ -102,9 +112,14 @@ export class BridgeService {
             endedAt: null,
             endReason: null,
             endValue: null,
-            pendingCommands: [],
+            serverReady: false,
+            serverLoadstringReady: false,
+            serverLastPolledAt: 0,
+            clients: new Map(),
+            pendingCommandsServer: [],
             outputBuffer: [],
             outputSeq: 0,
+            evalReplies: new Map(),
             endWaiters: [],
         };
         return sessionId;
@@ -121,6 +136,17 @@ export class BridgeService {
         session.endedAt = Date.now();
         session.endReason = reason;
         session.endValue = value ?? null;
+        // Reject any in-flight eval waiters — the test died before the
+        // companion could reply. Clear their watchdog timers too.
+        for (const [replyId, pending] of session.evalReplies.entries()) {
+            clearTimeout(pending.timeoutHandle);
+            pending.resolve({
+                ok: false,
+                errorType: 'companion_error',
+                error: `Play test ended (${reason}) before eval reply could be delivered.`,
+            });
+            session.evalReplies.delete(replyId);
+        }
         const waiters = session.endWaiters.splice(0);
         for (const w of waiters) {
             try {
@@ -144,34 +170,107 @@ export class BridgeService {
         return true;
     }
     /**
-     * Queue a command for the companion to pick up on its next poll.
-     * Currently the only command is 'end'.
+     * Queue a command for either the server companion or a specific client
+     * companion. Defaults to the server queue (preserves prior call-site
+     * behavior for the existing 'end' command path).
+     *
+     * Returns false if the targeted queue doesn't exist (e.g. no such
+     * client), the session is null/ended, etc.
      */
-    enqueueTestCommand(cmd) {
+    enqueueTestCommand(cmd, target = 'server') {
         const session = this.testSession;
         if (!session || session.status !== 'active')
             return false;
-        session.pendingCommands.push(cmd);
+        if (target === 'server') {
+            session.pendingCommandsServer.push(cmd);
+            return true;
+        }
+        const client = session.clients.get(target.client);
+        if (!client)
+            return false;
+        client.pendingCommands.push(cmd);
         return true;
     }
     /**
-     * Companion poll: returns the oldest pending command, or null if none.
-     * If the session was already marked ended, signals that so the companion
-     * stops polling.
+     * Companion poll: returns the oldest pending command for this target,
+     * or null if none. If the session was already marked ended, signals
+     * that so the companion stops polling.
+     *
+     * The hello payload (sent by a companion on its first poll) registers
+     * its readiness state. Server companion sends `{ loadstringReady }`;
+     * client companions add `{ userId, name, loadstringReady }`.
      */
-    popTestCommand(sessionId) {
+    popTestCommand(sessionId, target = 'server', options = {}) {
         const session = this.testSession;
         if (!session || session.sessionId !== sessionId) {
             return { command: null, ended: true, sessionMatch: false };
         }
+        // Update handshake/poll-time bookkeeping regardless of status, so
+        // late polls after end still update lastPolledAt for diagnostics.
+        if (target === 'server') {
+            if (!session.serverReady) {
+                session.serverReady = true;
+                session.serverLoadstringReady = !!options.hello?.loadstringReady;
+            }
+            else if (options.hello && typeof options.hello.loadstringReady === 'boolean') {
+                // Allow re-handshake (e.g. companion re-checked).
+                session.serverLoadstringReady = options.hello.loadstringReady;
+            }
+            session.serverLastPolledAt = Date.now();
+        }
+        else {
+            // Client target: require userId for routing.
+            const userId = typeof options.userId === 'number' ? options.userId : null;
+            if (userId === null) {
+                return { command: null, ended: session.status === 'ended', sessionMatch: true };
+            }
+            let client = session.clients.get(userId);
+            if (!client) {
+                client = {
+                    userId,
+                    name: options.playerName || `User_${userId}`,
+                    loadstringReady: !!options.hello?.loadstringReady,
+                    ready: true,
+                    registeredAt: Date.now(),
+                    lastPolledAt: Date.now(),
+                    pendingCommands: [],
+                };
+                session.clients.set(userId, client);
+            }
+            else {
+                client.lastPolledAt = Date.now();
+                if (options.playerName)
+                    client.name = options.playerName;
+                if (options.hello && typeof options.hello.loadstringReady === 'boolean') {
+                    client.loadstringReady = options.hello.loadstringReady;
+                }
+            }
+        }
         if (session.status === 'ended') {
             return { command: null, ended: true, sessionMatch: true };
         }
-        const command = session.pendingCommands.shift() ?? null;
+        let command = null;
+        if (target === 'server') {
+            command = session.pendingCommandsServer.shift() ?? null;
+        }
+        else {
+            const userId = typeof options.userId === 'number' ? options.userId : null;
+            if (userId !== null) {
+                const client = session.clients.get(userId);
+                command = client?.pendingCommands.shift() ?? null;
+            }
+        }
+        // If we just popped an eval, mark its reply slot as claimed so the
+        // watchdog knows the companion at least picked it up.
+        if (command && command.cmd === 'eval' && command.args && typeof command.args.replyId === 'string') {
+            const slot = session.evalReplies.get(command.args.replyId);
+            if (slot)
+                slot.claimed = true;
+        }
         return { command, ended: false, sessionMatch: true };
     }
     /**
-     * Append a batch of log entries from the companion. Drops oldest entries
+     * Append a batch of log entries from a companion. Drops oldest entries
      * if the buffer would exceed MAX_OUTPUT_BUFFER. Each entry gets a
      * monotonically increasing seq for "since" cursor support.
      */
@@ -260,5 +359,123 @@ export class BridgeService {
             setTimeout(() => finish(false), timeoutMs);
         });
     }
+    // ==========================================================================
+    // run_live_lua eval reply tracking
+    // ==========================================================================
+    /**
+     * Snapshot of companion readiness for diagnostic / pre-flight callers.
+     * Returns null if no session is tracked.
+     */
+    getTestSessionStatus() {
+        const session = this.testSession;
+        if (!session)
+            return null;
+        return {
+            sessionId: session.sessionId,
+            status: session.status,
+            serverReady: session.serverReady,
+            serverLoadstringReady: session.serverLoadstringReady,
+            clients: [...session.clients.values()].map((c) => ({
+                userId: c.userId,
+                name: c.name,
+                ready: c.ready,
+                loadstringReady: c.loadstringReady,
+            })),
+        };
+    }
+    /**
+     * Register a pending eval and return a Promise that resolves with the
+     * companion's reply (or a synthetic timeout reply).
+     *
+     * The watchdog fires at `timeoutMs + EVAL_GRACE_MS`, capped at
+     * EVAL_HARD_CAP_MS. If the command was never claimed by a companion,
+     * we surface `companion_error` (companion unreachable) rather than
+     * `timeout` so the AI can distinguish "infinite loop in user code"
+     * from "no companion picked up the work".
+     */
+    registerEvalReply(replyId, target, timeoutMs) {
+        const session = this.testSession;
+        if (!session || session.status !== 'active') {
+            return Promise.resolve({
+                ok: false,
+                errorType: 'companion_error',
+                error: 'No active play test session.',
+            });
+        }
+        const watchdogMs = Math.min(EVAL_HARD_CAP_MS, Math.max(1000, timeoutMs + EVAL_GRACE_MS));
+        return new Promise((resolve) => {
+            let done = false;
+            const finish = (payload) => {
+                if (done)
+                    return;
+                done = true;
+                const cur = this.testSession;
+                if (cur && cur.sessionId === session.sessionId) {
+                    const slot = cur.evalReplies.get(replyId);
+                    if (slot) {
+                        clearTimeout(slot.timeoutHandle);
+                        cur.evalReplies.delete(replyId);
+                    }
+                }
+                resolve(payload);
+            };
+            const timeoutHandle = setTimeout(() => {
+                const cur = this.testSession;
+                if (!cur || cur.sessionId !== session.sessionId) {
+                    finish({
+                        ok: false,
+                        errorType: 'companion_error',
+                        error: 'Play test session changed while waiting for eval reply.',
+                    });
+                    return;
+                }
+                const slot = cur.evalReplies.get(replyId);
+                if (!slot) {
+                    // Reply already arrived and removed the slot — race with timeout.
+                    finish({
+                        ok: false,
+                        errorType: 'companion_error',
+                        error: 'Eval reply slot vanished before resolution (internal race).',
+                    });
+                    return;
+                }
+                if (!slot.claimed) {
+                    finish({
+                        ok: false,
+                        errorType: 'companion_error',
+                        error: 'Companion never picked up the eval command within the watchdog window. The injected companion script may have died, or its HTTP polling is blocked.',
+                    });
+                }
+                else {
+                    finish({
+                        ok: false,
+                        errorType: 'timeout',
+                        error: `Eval did not complete within ${timeoutMs}ms (watchdog fired after ${watchdogMs}ms grace).`,
+                    });
+                }
+            }, watchdogMs);
+            session.evalReplies.set(replyId, {
+                resolve: finish,
+                timeoutHandle,
+                target,
+                claimed: false,
+                startedAt: Date.now(),
+            });
+        });
+    }
+    /**
+     * Companion-side eval result delivery. Idempotent w.r.t. the same
+     * replyId. Returns true if the reply was matched and dispatched.
+     */
+    resolveEvalReply(sessionId, replyId, payload) {
+        const session = this.testSession;
+        if (!session || session.sessionId !== sessionId)
+            return false;
+        const slot = session.evalReplies.get(replyId);
+        if (!slot)
+            return false;
+        slot.resolve(payload);
+        return true;
+    }
 }
 //# sourceMappingURL=bridge-service.js.map

package/dist/bridge-service.js.map

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

package/dist/docs/cache.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Cache layout for the Roblox creator-docs mirror.
+ *
+ *   <cacheDir>/
+ *     meta.json                 ← bookkeeping (sha, downloadedAt, …)
+ *     content/                  ← extracted, scope-filtered docs tree
+ *       en-us/
+ *         reference/engine/classes/Part.yaml
+ *         reference/engine/datatypes/CFrame.yaml
+ *         …
+ *
+ * Cache directory is resolved by `env-paths` (cross-platform) but can be
+ * overridden via `RBXSTUDIO_DOCS_DIR` for tests, sandboxes, or users with
+ * non-standard layouts.
+ */
+export interface DocsMeta {
+    /** Repo we cloned from, e.g. "Roblox/creator-docs". */
+    repo: string;
+    /** Branch/ref we tracked, e.g. "main". */
+    branch: string;
+    /** Commit SHA of the snapshot on disk. Empty if cache is empty. */
+    sha: string;
+    /** ISO timestamp of when the tarball was last extracted. */
+    downloadedAt: string;
+    /** ISO timestamp of when we last hit the GitHub API to check freshness. */
+    lastCheckedAt: string;
+    /** How many files survived scope-filtering and are sitting in `content/`. */
+    fileCount: number;
+    /** Approximate bytes-on-disk for the extracted tree. */
+    bytesOnDisk: number;
+    /** Schema version — bump if we change the layout incompatibly. */
+    schemaVersion: number;
+}
+export declare function resolveCacheDir(): string;
+export declare function metaPath(cacheDir: string): string;
+export declare function contentRoot(cacheDir: string): string;
+export declare function readMeta(cacheDir: string): Promise<DocsMeta | null>;
+export declare function writeMeta(cacheDir: string, meta: Omit<DocsMeta, 'schemaVersion'>): Promise<void>;
+export declare function ensureCacheDir(cacheDir: string): Promise<void>;
+/**
+ * Wipe the extracted content tree (but keep the cacheDir itself, so users
+ * can `tail -F` it if they want to).
+ */
+export declare function clearContent(cacheDir: string): Promise<void>;
+/**
+ * Best-effort byte-count of the content tree. Used for status reporting
+ * only; not safety-critical, so errors are swallowed.
+ */
+export declare function approxSizeOnDisk(dir: string): Promise<number>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/docs/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/docs/cache.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAkBD,wBAAgB,eAAe,IAAI,MAAM,CAYxC;AAqBD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAezE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAItG;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBnE"}