rbxstudio-mcp 2.3.2 → 2.4.0

package/dist/__tests__/semantic-search.test.js

@@ -0,0 +1,202 @@
+/**
+ * Semantic-search integration tests with a STUBBED embedder.
+ *
+ * We don't want CI to download a 25MB ONNX model on every run, so
+ * `__setEmbedderForTests` lets us inject a tiny deterministic
+ * pseudo-embedding: hash each token to a 384-dim sparse vector. The
+ * result isn't great for real retrieval but is *deterministic* and
+ * lets us verify:
+ *
+ *   1. Index build → load → query happy path.
+ *   2. SHA mismatch invalidates the on-disk index.
+ *   3. Hybrid mode falls back to keyword when no SHA is provided.
+ *   4. Hybrid mode actually reorders hits when the index is hot.
+ *   5. The `semantic: false` knob bypasses semantic entirely.
+ *   6. Every returned hit still satisfies token-AND (no lexical cheating).
+ */
+import { promises as fs } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { __setEmbedderForTests, EMBED_DIM, } from '../docs/embeddings/embedder.js';
+import { buildIndex, loadIndex } from '../docs/embeddings/index.js';
+import { getOrBuild, __setIndexForTests, invalidate } from '../docs/embeddings/manager.js';
+import { searchDocs } from '../docs/search.js';
+/**
+ * Deterministic fake embedder.
+ *
+ * Build a 384-dim sparse vector by hashing each whitespace-separated
+ * token to a couple of dimensions. Same token → same bits. Two texts
+ * sharing tokens will have positive cosine; texts with no shared
+ * tokens will have ~0 cosine. Good enough to test ranking logic.
+ */
+function fakeEmbed(texts) {
+    const out = [];
+    for (const text of texts) {
+        const v = new Float32Array(EMBED_DIM);
+        const tokens = text.toLowerCase().split(/\s+/).filter(Boolean);
+        for (const tok of tokens) {
+            // Two-hash sparse encoding to spread tokens across the vector.
+            let h1 = 2166136261;
+            let h2 = 5381;
+            for (let i = 0; i < tok.length; i++) {
+                h1 = ((h1 ^ tok.charCodeAt(i)) * 16777619) >>> 0;
+                h2 = ((h2 << 5) + h2 + tok.charCodeAt(i)) >>> 0;
+            }
+            v[h1 % EMBED_DIM] += 1;
+            v[h2 % EMBED_DIM] += 0.5;
+        }
+        // L2-normalize so dot = cosine.
+        let norm = 0;
+        for (let i = 0; i < EMBED_DIM; i++)
+            norm += v[i] * v[i];
+        norm = Math.sqrt(norm) || 1;
+        for (let i = 0; i < EMBED_DIM; i++)
+            v[i] /= norm;
+        out.push(v);
+    }
+    return Promise.resolve(out);
+}
+async function makeFixtureCache() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'rbxdocs-sem-'));
+    const en = path.join(dir, 'content', 'en-us');
+    await fs.mkdir(path.join(en, 'reference', 'engine', 'classes'), { recursive: true });
+    await fs.mkdir(path.join(en, 'animation'), { recursive: true });
+    // A "rotate body part smoothly" query should rank AlignOrientation
+    // higher than a passing mention in an unrelated guide.
+    await fs.writeFile(path.join(en, 'reference', 'engine', 'classes', 'AlignOrientation.yaml'), `name: AlignOrientation
+type: class
+summary: |
+  AlignOrientation smoothly rotates an Attachment toward a target orientation.
+description: |
+  Use AlignOrientation when you want to smoothly rotate one part to face
+  a direction over time. It applies torque to align the orientation.
+properties:
+  - name: MaxTorque
+    summary: |
+      The maximum torque applied to rotate the attachment.
+    type: number
+  - name: Responsiveness
+    summary: |
+      Higher responsiveness rotates the part more aggressively.
+    type: number
+`, 'utf8');
+    await fs.writeFile(path.join(en, 'reference', 'engine', 'classes', 'Motor6D.yaml'), `name: Motor6D
+type: class
+summary: |
+  A Motor6D is a joint that rotates between two parts using C0 and C1 offsets.
+description: |
+  Motor6D drives character animation by rotating Part1 relative to Part0.
+properties:
+  - name: C0
+    summary: |
+      The CFrame offset of the joint on Part0. Setting C0 rotates Part1 around Part0.
+    type: CFrame
+  - name: C1
+    summary: |
+      The CFrame offset of the joint on Part1.
+    type: CFrame
+`, 'utf8');
+    // Unrelated guide that *mentions* rotate / smooth / part in passing
+    // — keyword token-AND will match it, but semantic rerank should
+    // push it down below AlignOrientation.
+    await fs.writeFile(path.join(en, 'animation', 'unrelated-rotate.md'), `# Unrelated guide that happens to mention rotate and part
+This page is about something else entirely.
+It might smoothly rotate a part but only as an aside.
+The main topic is something else: building a UI, scripting a server, configuring inventories.
+You can rotate a part by setting CFrame directly, smoothly or not.
+Most of this page talks about UI buttons and inventory grids and server scripts.
+${'unrelated text '.repeat(40)}
+`, 'utf8');
+    return dir;
+}
+describe('semantic-search: end-to-end with fake embedder', () => {
+    let cacheDir;
+    const FAKE_SHA = 'deadbeefcafe1234';
+    beforeAll(async () => {
+        __setEmbedderForTests(fakeEmbed);
+        cacheDir = await makeFixtureCache();
+    });
+    afterAll(async () => {
+        __setEmbedderForTests(null);
+        __setIndexForTests(null);
+        if (cacheDir)
+            await fs.rm(cacheDir, { recursive: true, force: true });
+    });
+    beforeEach(() => {
+        invalidate(); // clear in-memory manager between tests
+    });
+    test('buildIndex → loadIndex round-trips', async () => {
+        const meta = await buildIndex(cacheDir, FAKE_SHA);
+        expect(meta.sha).toBe(FAKE_SHA);
+        expect(meta.dim).toBe(EMBED_DIM);
+        expect(meta.chunkCount).toBeGreaterThan(0);
+        const loaded = await loadIndex(cacheDir, FAKE_SHA);
+        expect(loaded).not.toBeNull();
+        expect(loaded.chunks.length).toBe(meta.chunkCount);
+        expect(loaded.vectors.length).toBe(meta.chunkCount * meta.dim);
+    });
+    test('loadIndex rejects on SHA mismatch', async () => {
+        await buildIndex(cacheDir, FAKE_SHA);
+        const wrong = await loadIndex(cacheDir, 'different-sha');
+        expect(wrong).toBeNull();
+    });
+    test('getOrBuild memoizes after first call', async () => {
+        const first = await getOrBuild(cacheDir, FAKE_SHA);
+        expect(first).not.toBeNull();
+        // Stash a sentinel; if memoization works the second call returns the
+        // exact same reference.
+        const second = await getOrBuild(cacheDir, FAKE_SHA);
+        expect(second).toBe(first);
+    });
+    test('searchDocs hybrid mode reranks AlignOrientation above unrelated guide', async () => {
+        // Warm the index.
+        await getOrBuild(cacheDir, FAKE_SHA);
+        const result = await searchDocs(cacheDir, 'rotate part smoothly', { maxHits: 20 }, { docsSha: FAKE_SHA });
+        expect(result.mode).toBe('hybrid');
+        expect(result.semanticUsed).toBe(true);
+        expect(result.hits.length).toBeGreaterThan(0);
+        // Find the rank of AlignOrientation vs. the unrelated guide.
+        const alignRank = result.hits.findIndex((h) => h.path.includes('AlignOrientation'));
+        const unrelatedRank = result.hits.findIndex((h) => h.path.includes('unrelated-rotate'));
+        // Both should appear (token-AND filter lets them through).
+        expect(alignRank).toBeGreaterThanOrEqual(0);
+        expect(unrelatedRank).toBeGreaterThanOrEqual(0);
+        // AlignOrientation has more topical density → higher fake-cosine
+        // → should rank above the unrelated guide.
+        expect(alignRank).toBeLessThan(unrelatedRank);
+        // And every hit has a score field.
+        for (const h of result.hits) {
+            expect(typeof h.score).toBe('number');
+        }
+    });
+    test('semantic: false skips rerank and stays in token-AND mode', async () => {
+        const result = await searchDocs(cacheDir, 'rotate part smoothly', { maxHits: 20, semantic: false }, { docsSha: FAKE_SHA });
+        expect(result.mode).toBe('token-and');
+        for (const h of result.hits) {
+            // No score field in plain token-AND mode.
+            expect(h.score).toBeUndefined();
+        }
+    });
+    test('hybrid mode without docsSha falls back to keyword ranking', async () => {
+        const result = await searchDocs(cacheDir, 'rotate part smoothly', {
+            maxHits: 20,
+        });
+        expect(result.mode).toBe('hybrid');
+        expect(result.semanticUsed).toBe(false);
+    });
+    test('hybrid mode preserves token-AND guarantee (every hit contains all tokens)', async () => {
+        await getOrBuild(cacheDir, FAKE_SHA);
+        const result = await searchDocs(cacheDir, 'rotate part smoothly', { maxHits: 20 }, { docsSha: FAKE_SHA });
+        for (const hit of result.hits) {
+            // matchedTokens should be present (carried through from token-AND
+            // pool). The token-AND guarantee is "every token appears in the
+            // window", which the keyword pass already enforced.
+            expect(Array.isArray(hit.matchedTokens)).toBe(true);
+        }
+    });
+    test('single-token query stays in literal mode (no semantic touch)', async () => {
+        const result = await searchDocs(cacheDir, 'Motor6D', { maxHits: 20 }, { docsSha: FAKE_SHA });
+        expect(result.mode).toBe('literal');
+    });
+});
+//# sourceMappingURL=semantic-search.test.js.map

package/dist/__tests__/semantic-search.test.js.map

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

package/dist/__tests__/smoke.test.js

@@ -2,6 +2,7 @@ import { BridgeService } from '../bridge-service.js';
 import { createHttpServer } from '../http-server.js';
 import { RobloxStudioTools } from '../tools/index.js';
 import request from 'supertest';
+import { observeRejection } from './helpers.js';
 describe('Smoke Tests - Connection Fixes', () => {
     test('BridgeService should be instantiable', () => {
         const bridge = new BridgeService();
@@ -23,6 +24,8 @@ describe('Smoke Tests - Connection Fixes', () => {
         // Don't wait for these promises - they'll be rejected
         const promise1 = bridge.sendRequest('/test1', {});
         const promise2 = bridge.sendRequest('/test2', {});
+        const rejection1 = observeRejection(promise1);
+        const rejection2 = observeRejection(promise2);
         // Should have pending requests
         expect(bridge.getPendingRequest()).toBeTruthy();
         // Clear all requests
@@ -30,8 +33,8 @@ describe('Smoke Tests - Connection Fixes', () => {
         // Should have no pending requests
         expect(bridge.getPendingRequest()).toBeNull();
         // Promises should reject
-        await expect(promise1).rejects.toThrow('Connection closed');
-        await expect(promise2).rejects.toThrow('Connection closed');
+        await expect(rejection1).resolves.toThrow('Connection closed');
+        await expect(rejection2).resolves.toThrow('Connection closed');
     });
     test('Disconnect endpoint should clear pending requests', async () => {
         const bridge = new BridgeService();
@@ -39,12 +42,13 @@ describe('Smoke Tests - Connection Fixes', () => {
         const app = createHttpServer(tools, bridge);
         // Add a pending request (don't await it)
         const pendingPromise = bridge.sendRequest('/test', { data: 'test' });
+        const rejection = observeRejection(pendingPromise);
         // Disconnect should clear it
         await request(app)
             .post('/disconnect')
             .expect(200);
         // Request should be rejected
-        await expect(pendingPromise).rejects.toThrow('Connection closed');
+        await expect(rejection).resolves.toThrow('Connection closed');
     });
     test('Connection states should update correctly', async () => {
         const bridge = new BridgeService();

package/dist/__tests__/smoke.test.js.map

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

package/dist/__tests__/studio-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=studio-client.test.d.ts.map

package/dist/__tests__/studio-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/studio-client.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/studio-client.test.js

@@ -0,0 +1,25 @@
+import { StudioHttpClient } from '../tools/studio-client';
+describe('StudioHttpClient', () => {
+    test('returns bridge responses unchanged', async () => {
+        const bridge = {
+            sendRequest: jest.fn().mockResolvedValue({ ok: true }),
+        };
+        await expect(new StudioHttpClient(bridge).request('/api/test', { a: 1 })).resolves.toEqual({
+            ok: true,
+        });
+        expect(bridge.sendRequest).toHaveBeenCalledWith('/api/test', { a: 1 });
+    });
+    test('maps bridge request timeouts to actionable Studio plugin guidance', async () => {
+        const bridge = {
+            sendRequest: jest.fn().mockRejectedValue(new Error('Request timeout')),
+        };
+        await expect(new StudioHttpClient(bridge).request('/api/test', {})).rejects.toThrow('Studio plugin connection timeout');
+    });
+    test('preserves non-timeout bridge errors', async () => {
+        const bridge = {
+            sendRequest: jest.fn().mockRejectedValue(new Error('boom')),
+        };
+        await expect(new StudioHttpClient(bridge).request('/api/test', {})).rejects.toThrow('boom');
+    });
+});
+//# sourceMappingURL=studio-client.test.js.map

package/dist/__tests__/studio-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-client.test.js","sourceRoot":"","sources":["../../src/__tests__/studio-client.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,MAAM,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;SAC3B,CAAC;QAE9B,MAAM,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACzF,EAAE,EAAE,IAAI;SACT,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,MAAM,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;SAC3C,CAAC;QAE9B,MAAM,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACjF,kCAAkC,CACnC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;SAChC,CAAC;QAE9B,MAAM,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/tool-nudges.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-nudges.test.d.ts.map

package/dist/__tests__/tool-nudges.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-nudges.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-nudges.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tool-nudges.test.js

@@ -0,0 +1,60 @@
+import { applyNudge, toolsByName } from '../tools/registry';
+import { INSTRUMENT_OVER_PLAYTEST, RUN_LIVE_LUA_NUDGE, STILL_FRAME_NUDGE, } from '../tools/nudges';
+describe('applyNudge', () => {
+    test('is a no-op when there is no nudge', () => {
+        const result = { content: [{ type: 'text', text: 'body' }] };
+        expect(applyNudge(result, undefined)).toBe(result);
+    });
+    test('appends the nudge as a trailing text block on MCP-shaped results', () => {
+        const result = { content: [{ type: 'text', text: 'body' }] };
+        const out = applyNudge(result, 'be careful');
+        // Original is not mutated.
+        expect(result.content).toHaveLength(1);
+        // New result has the nudge appended last.
+        expect(out.content).toHaveLength(2);
+        expect(out.content[0]).toEqual({ type: 'text', text: 'body' });
+        expect(out.content[1]).toEqual({ type: 'text', text: 'be careful' });
+    });
+    test('preserves sibling result fields (e.g. image blocks, isError)', () => {
+        const result = {
+            isError: false,
+            content: [
+                { type: 'text', text: 'meta' },
+                { type: 'image', data: 'abc', mimeType: 'image/png' },
+            ],
+        };
+        const out = applyNudge(result, 'hint');
+        expect(out.isError).toBe(false);
+        expect(out.content).toHaveLength(3);
+        expect(out.content[2]).toEqual({ type: 'text', text: 'hint' });
+        // Image block survives unchanged.
+        expect(out.content[1]).toEqual({ type: 'image', data: 'abc', mimeType: 'image/png' });
+    });
+    test('returns non-MCP-shaped results untouched even with a nudge', () => {
+        const plain = { foo: 'bar' };
+        expect(applyNudge(plain, 'hint')).toBe(plain);
+        expect(applyNudge('just-a-string', 'hint')).toBe('just-a-string');
+        expect(applyNudge(undefined, 'hint')).toBeUndefined();
+    });
+});
+describe('tool nudge wiring', () => {
+    const expected = {
+        play_solo: INSTRUMENT_OVER_PLAYTEST,
+        get_playtest_output: INSTRUMENT_OVER_PLAYTEST,
+        run_live_lua: RUN_LIVE_LUA_NUDGE,
+        capture_screenshot: STILL_FRAME_NUDGE,
+        render_object_view: STILL_FRAME_NUDGE,
+        render_gui: STILL_FRAME_NUDGE,
+    };
+    test.each(Object.entries(expected))('%s carries the expected nudge', (name, nudge) => {
+        expect(toolsByName[name].nudge).toBe(nudge);
+    });
+    test('non-instrumentation tools do not carry a nudge', () => {
+        // A nudge on every tool would defeat the point (and waste tokens). Spot-check
+        // that read/mutation tools stay quiet.
+        expect(toolsByName['get_instance_properties'].nudge).toBeUndefined();
+        expect(toolsByName['set_property'].nudge).toBeUndefined();
+        expect(toolsByName['edit_script'].nudge).toBeUndefined();
+    });
+});
+//# sourceMappingURL=tool-nudges.test.js.map

package/dist/__tests__/tool-nudges.test.js.map

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

package/dist/__tests__/tool-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-registry.test.d.ts.map

package/dist/__tests__/tool-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-registry.test.ts"],"names":[],"mappings":""}