rbxstudio-mcp 2.3.2 → 2.4.0

package/dist/__tests__/chunker.test.js

@@ -0,0 +1,201 @@
+/**
+ * Chunker unit tests — no network, no model load. Pure string-in /
+ * Chunk[]-out testing of the heading-aware markdown and member-aware
+ * YAML splitters.
+ *
+ * We use the private __test__ export to test the per-format functions
+ * directly, then a small fixture run of the public walkChunks() to
+ * sanity-check the file walk.
+ */
+import { promises as fs } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { __test__, chunkAll } from '../docs/embeddings/chunker.js';
+const { chunkMarkdown, chunkYaml, extractYamlField, splitOversize } = __test__;
+describe('chunker: extractYamlField', () => {
+    test('extracts top-level scalar', () => {
+        expect(extractYamlField('name: Motor6D\ntype: class', 'name')).toBe('Motor6D');
+    });
+    test('strips single quotes', () => {
+        expect(extractYamlField("name: 'Class.Motor6D'", 'name')).toBe('Class.Motor6D');
+    });
+    test('strips double quotes', () => {
+        expect(extractYamlField('name: "with spaces"', 'name')).toBe('with spaces');
+    });
+    test('returns null for missing key', () => {
+        expect(extractYamlField('foo: bar', 'baz')).toBeNull();
+    });
+    test('handles dash-prefixed (list-entry) form', () => {
+        expect(extractYamlField('  - name: C0\n    type: CFrame', 'name')).toBe('C0');
+    });
+});
+describe('chunker: chunkMarkdown', () => {
+    test('splits on top-level headings', () => {
+        // Each section body needs to clear MIN_CHUNK_CHARS (40) for the
+        // chunker to keep it — otherwise stubby sections are dropped on
+        // purpose (we don't want to emit empty "## Examples" stubs).
+        const md = `# Intro
+this is the intro section with enough content to clear the minimum chunk size threshold.
+
+# Body
+the body has more text and explanation that goes well beyond the forty-character bound.
+
+# Conclusion
+closes out the document with a substantial wrap-up paragraph that is also long enough.`;
+        const chunks = chunkMarkdown('en-us/test.md', md);
+        const headings = chunks.map((c) => c.label);
+        expect(headings).toContain('Intro');
+        expect(headings).toContain('Body');
+        expect(headings).toContain('Conclusion');
+    });
+    test('preamble before first heading is preserved', () => {
+        const longBody = 'some preamble text. '.repeat(10);
+        const md = `${longBody}
+
+# First
+hello world hello world hello world hello world hello world`;
+        const chunks = chunkMarkdown('en-us/test.md', md);
+        const preambles = chunks.filter((c) => c.label === '<preamble>');
+        expect(preambles.length).toBe(1);
+        expect(preambles[0].text).toMatch(/some preamble text/);
+    });
+    test('ignores headings inside code fences', () => {
+        const md = `# Real Heading
+\`\`\`lua
+-- # This is not a markdown heading
+local x = 1
+\`\`\`
+more body.`;
+        const chunks = chunkMarkdown('en-us/test.md', md);
+        expect(chunks.length).toBe(1);
+        expect(chunks[0].label).toBe('Real Heading');
+    });
+    test('line ranges roughly align with heading positions', () => {
+        // Bodies again need to clear MIN_CHUNK_CHARS or they're dropped.
+        const md = `# A
+section A body with enough characters to satisfy the minimum chunk size requirement.
+another line of body text for section A so its line range is non-trivial too.
+
+# B
+section B body with more than forty characters of text in it so it sticks.
+another line of body text for section B to make the line range meaningful.`;
+        const chunks = chunkMarkdown('en-us/test.md', md);
+        const aIdx = chunks.findIndex((c) => c.label === 'A');
+        const bIdx = chunks.findIndex((c) => c.label === 'B');
+        expect(aIdx).toBeGreaterThanOrEqual(0);
+        expect(bIdx).toBeGreaterThanOrEqual(0);
+        expect(chunks[bIdx].startLine).toBeGreaterThan(chunks[aIdx].startLine);
+    });
+    test('headed sections carry their kind', () => {
+        const md = `# Long Heading
+${'lorem ipsum '.repeat(20)}`;
+        const chunks = chunkMarkdown('en-us/test.md', md);
+        expect(chunks.every((c) => c.kind === 'md-section')).toBe(true);
+    });
+});
+describe('chunker: chunkYaml', () => {
+    test('splits properties into per-member chunks', () => {
+        const yaml = `name: Motor6D
+type: class
+summary: |
+  A Motor6D is a joint that drives rotation between two parts.
+description: |
+  Motor6D is the workhorse of character animation.
+properties:
+  - name: C0
+    summary: |
+      The CFrame offset of the joint on Part0.
+    type: CFrame
+  - name: C1
+    summary: |
+      The CFrame offset of the joint on Part1.
+    type: CFrame
+methods:
+  - name: SetDesiredAngle
+    summary: |
+      Sets the angle the motor should rotate toward.
+`;
+        const chunks = chunkYaml('en-us/reference/engine/classes/Motor6D.yaml', yaml);
+        const labels = chunks.map((c) => c.label);
+        // Preamble + 2 properties + 1 method = 4 chunks (Motor6D as label).
+        expect(labels).toContain('Motor6D');
+        expect(labels).toContain('Motor6D.C0');
+        expect(labels).toContain('Motor6D.C1');
+        expect(labels).toContain('Motor6D.SetDesiredAngle');
+        // Each member chunk carries the parent name in its text.
+        const c0 = chunks.find((c) => c.label === 'Motor6D.C0');
+        expect(c0.text).toMatch(/Motor6D/);
+        expect(c0.text).toMatch(/C0/);
+        expect(c0.kind).toBe('yaml-member');
+    });
+    test('non-schema yaml falls back to fallback chunker', () => {
+        const yaml = `# this is just yaml frontmatter
+key: value
+another: thing
+`;
+        const chunks = chunkYaml('en-us/misc.yaml', yaml);
+        // Without `properties:` etc the file is too small to chunk at all
+        // (below MIN_CHUNK_CHARS) — that's fine, the test asserts no crash
+        // and zero or more chunks with yaml-misc kind if produced.
+        for (const c of chunks) {
+            expect(c.kind).toBe('yaml-misc');
+        }
+    });
+});
+describe('chunker: splitOversize', () => {
+    test('keeps small text intact', () => {
+        const out = splitOversize('hello world', 0, 0);
+        expect(out.length).toBe(1);
+        expect(out[0].text).toBe('hello world');
+    });
+    test('splits oversize on paragraph boundaries', () => {
+        const para = 'x'.repeat(800);
+        const text = `${para}\n\n${para}\n\n${para}`;
+        const out = splitOversize(text, 0, 10);
+        expect(out.length).toBeGreaterThanOrEqual(2);
+        for (const piece of out) {
+            expect(piece.text.length).toBeLessThanOrEqual(900 + 10); // some slack
+        }
+    });
+});
+describe('chunker: chunkAll on tiny fixture tree', () => {
+    let tmpDir;
+    beforeAll(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'rbxdocs-chunker-'));
+        const content = path.join(tmpDir, 'content', 'en-us');
+        await fs.mkdir(path.join(content, 'reference', 'engine', 'classes'), { recursive: true });
+        await fs.mkdir(path.join(content, 'animation'), { recursive: true });
+        await fs.writeFile(path.join(content, 'animation', 'rigging.md'), `# Rigging guide
+Long explanation about rigging. ${'lorem '.repeat(60)}
+## Anatomy
+A rig has parts. ${'ipsum '.repeat(60)}`, 'utf8');
+        await fs.writeFile(path.join(content, 'reference', 'engine', 'classes', 'Motor6D.yaml'), `name: Motor6D
+type: class
+summary: |
+  Motor6D connects two parts with a rotational joint.
+description: |
+  More detail about Motor6D.
+properties:
+  - name: C0
+    summary: |
+      The CFrame offset on Part0.
+    type: CFrame
+  - name: C1
+    summary: |
+      The CFrame offset on Part1.
+    type: CFrame
+`, 'utf8');
+    });
+    afterAll(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    test('produces both md-section and yaml-member chunks', async () => {
+        const chunks = await chunkAll(tmpDir);
+        const kinds = new Set(chunks.map((c) => c.kind));
+        expect(kinds.has('md-section')).toBe(true);
+        expect(kinds.has('yaml-member')).toBe(true);
+        // Every chunk has a non-empty path.
+        expect(chunks.every((c) => c.path && c.startLine > 0 && c.endLine >= c.startLine)).toBe(true);
+    });
+});
+//# sourceMappingURL=chunker.test.js.map

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

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

package/dist/__tests__/docs-core.test.d.ts

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

package/dist/__tests__/docs-core.test.d.ts.map

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

package/dist/__tests__/docs-core.test.js

@@ -0,0 +1,137 @@
+import { promises as fs } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { approxSizeOnDisk, clearContent, contentRoot, ensureCacheDir, readMeta, writeMeta, } from '../docs/cache';
+import { resolveReference } from '../docs/reference';
+import { listDocs, readDocFile, searchDocs } from '../docs/search';
+describe('docs cache helpers', () => {
+    let dir;
+    beforeEach(async () => {
+        dir = await fs.mkdtemp(path.join(os.tmpdir(), 'rbxdocs-cache-'));
+    });
+    afterEach(async () => {
+        await fs.rm(dir, { recursive: true, force: true });
+    });
+    test('writeMeta/readMeta round-trips current-schema metadata', async () => {
+        await writeMeta(dir, {
+            repo: 'Roblox/creator-docs',
+            branch: 'main',
+            sha: 'abc',
+            downloadedAt: '2026-01-01T00:00:00.000Z',
+            lastCheckedAt: '2026-01-01T00:00:00.000Z',
+            fileCount: 2,
+            bytesOnDisk: 10,
+        });
+        await expect(readMeta(dir)).resolves.toMatchObject({
+            repo: 'Roblox/creator-docs',
+            sha: 'abc',
+            schemaVersion: 1,
+        });
+    });
+    test('readMeta treats missing, corrupt, and stale-schema metadata as empty', async () => {
+        await expect(readMeta(dir)).resolves.toBeNull();
+        await ensureCacheDir(dir);
+        await fs.writeFile(path.join(dir, 'meta.json'), 'not-json', 'utf8');
+        await expect(readMeta(dir)).resolves.toBeNull();
+        await fs.writeFile(path.join(dir, 'meta.json'), JSON.stringify({ schemaVersion: 0 }), 'utf8');
+        await expect(readMeta(dir)).resolves.toBeNull();
+    });
+    test('clearContent removes docs content and approxSizeOnDisk ignores missing paths', async () => {
+        const root = contentRoot(dir);
+        await fs.mkdir(path.join(root, 'nested'), { recursive: true });
+        await fs.writeFile(path.join(root, 'nested', 'file.md'), '12345', 'utf8');
+        await expect(approxSizeOnDisk(root)).resolves.toBe(5);
+        await clearContent(dir);
+        await expect(approxSizeOnDisk(root)).resolves.toBe(0);
+    });
+});
+describe('docs search, listing, and reference resolution', () => {
+    let dir;
+    beforeEach(async () => {
+        dir = await fs.mkdtemp(path.join(os.tmpdir(), 'rbxdocs-core-'));
+        const root = contentRoot(dir);
+        await fs.mkdir(path.join(root, 'en-us', 'reference', 'engine', 'classes'), { recursive: true });
+        await fs.mkdir(path.join(root, 'en-us', 'reference', 'engine', 'datatypes'), { recursive: true });
+        await fs.mkdir(path.join(root, 'en-us', 'guide'), { recursive: true });
+        await fs.writeFile(path.join(root, 'en-us', 'reference', 'engine', 'classes', 'Part.yaml'), `name: Part
+type: class
+summary: A part is a 3D object.
+properties:
+  - name: Anchored
+    summary: Anchored prevents physics from moving the part.
+`, 'utf8');
+        await fs.writeFile(path.join(root, 'en-us', 'reference', 'engine', 'datatypes', 'Vector3.yaml'), `name: Vector3
+type: datatype
+summary: Three dimensional vector.
+`, 'utf8');
+        await fs.writeFile(path.join(root, 'en-us', 'guide', 'physics.md'), `# Physics
+Set Anchored when a part should not move.
+Use constraints when a body must rotate smoothly.
+`, 'utf8');
+    });
+    afterEach(async () => {
+        await fs.rm(dir, { recursive: true, force: true });
+    });
+    test('readDocFile blocks traversal and reads safe files', async () => {
+        await expect(readDocFile(dir, '../meta.json')).resolves.toBeNull();
+        const doc = await readDocFile(dir, 'en-us/guide/physics.md');
+        expect(doc).toMatchObject({
+            path: 'en-us/guide/physics.md',
+        });
+        expect(doc?.content).toContain('Set Anchored');
+    });
+    test('listDocs sorts directories before files and paginates', async () => {
+        const listing = await listDocs(dir, 'en-us/reference/engine', { limit: 1 });
+        expect(listing).toMatchObject({
+            path: 'en-us/reference/engine',
+            totalEntries: 2,
+            offset: 0,
+            limit: 1,
+            truncated: true,
+            entries: [{ name: 'classes', type: 'dir' }],
+        });
+        await expect(listDocs(dir, '../outside')).resolves.toBeNull();
+    });
+    test('searchDocs supports literal, regex, scoped, and token-AND searches', async () => {
+        const literal = await searchDocs(dir, 'Anchored', {
+            scope: 'en-us/reference',
+            contextLines: 1,
+            semantic: false,
+        });
+        expect(literal).toMatchObject({
+            mode: 'literal',
+            totalHits: 2,
+            filesScanned: 2,
+        });
+        expect(literal.hits[0].context).toEqual(expect.arrayContaining([{ line: 4, text: 'properties:' }]));
+        const regex = await searchDocs(dir, 'Vector\\d', { useRegex: true });
+        expect(regex).toMatchObject({ mode: 'literal', totalHits: 1 });
+        const tokenAnd = await searchDocs(dir, 'rotate body smoothly', {
+            semantic: false,
+            windowLines: 2,
+        });
+        expect(tokenAnd).toMatchObject({
+            mode: 'token-and',
+            tokens: ['rotate', 'body', 'smoothly'],
+            totalHits: 1,
+        });
+        expect(tokenAnd.hits[0].path).toBe('en-us/guide/physics.md');
+    });
+    test('resolveReference finds categories case-insensitively and returns raw YAML', async () => {
+        const part = await resolveReference(dir, 'part');
+        expect(part).toMatchObject({
+            category: 'class',
+            name: 'Part',
+            path: 'en-us/reference/engine/classes/Part.yaml',
+            data: { name: 'Part', type: 'class' },
+        });
+        expect(part?.raw).toContain('name: Part');
+        const vector = await resolveReference(dir, 'Vector3', 'datatype');
+        expect(vector).toMatchObject({
+            category: 'datatype',
+            name: 'Vector3',
+        });
+        await expect(resolveReference(dir, 'Missing')).resolves.toBeNull();
+    });
+});
+//# sourceMappingURL=docs-core.test.js.map

package/dist/__tests__/docs-core.test.js.map

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

package/dist/__tests__/docs-fetcher.test.d.ts

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

package/dist/__tests__/docs-fetcher.test.d.ts.map

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

package/dist/__tests__/docs-fetcher.test.js

@@ -0,0 +1,173 @@
+import { promises as fs } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { Readable } from 'stream';
+import * as tar from 'tar';
+import { contentRoot, readMeta, writeMeta } from '../docs/cache';
+import { ensureDocsCache } from '../docs/fetcher';
+function jsonResponse(body) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: 'OK',
+        json: async () => body,
+    };
+}
+function tarballResponse(buffer) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: 'OK',
+        body: Readable.toWeb(Readable.from(buffer)),
+    };
+}
+async function makeCreatorDocsTarball(label) {
+    const src = await fs.mkdtemp(path.join(os.tmpdir(), 'creator-docs-src-'));
+    const tarPath = path.join(src, 'docs.tar.gz');
+    const repo = path.join(src, 'creator-docs-main');
+    await fs.mkdir(path.join(repo, 'content', 'en-us', 'reference', 'engine', 'classes'), {
+        recursive: true,
+    });
+    await fs.mkdir(path.join(repo, 'content', 'en-us', 'animation'), { recursive: true });
+    await fs.mkdir(path.join(repo, 'content', 'en-us', 'unkept'), { recursive: true });
+    await fs.writeFile(path.join(repo, 'content', 'en-us', 'reference', 'engine', 'classes', 'Part.yaml'), `name: Part\nsummary: ${label}\n`, 'utf8');
+    await fs.writeFile(path.join(repo, 'content', 'en-us', 'animation', 'rigging.md'), `# Rigging ${label}\n`, 'utf8');
+    await fs.writeFile(path.join(repo, 'content', 'en-us', 'unkept', 'skip.md'), 'not extracted', 'utf8');
+    await fs.writeFile(path.join(repo, 'content', 'en-us', 'animation', 'skip.txt'), 'wrong extension', 'utf8');
+    await tar.c({ gzip: true, cwd: src, file: tarPath }, ['creator-docs-main']);
+    const buffer = await fs.readFile(tarPath);
+    await fs.rm(src, { recursive: true, force: true });
+    return buffer;
+}
+describe('ensureDocsCache', () => {
+    let cacheDir;
+    let firstTarball;
+    let secondTarball;
+    const originalFetch = global.fetch;
+    beforeAll(async () => {
+        cacheDir = await fs.mkdtemp(path.join(os.tmpdir(), 'rbxdocs-fetcher-'));
+        process.env.RBXSTUDIO_DOCS_DIR = cacheDir;
+        firstTarball = await makeCreatorDocsTarball('first');
+        secondTarball = await makeCreatorDocsTarball('second');
+    });
+    afterAll(async () => {
+        global.fetch = originalFetch;
+        delete process.env.RBXSTUDIO_DOCS_DIR;
+        if (cacheDir)
+            await fs.rm(cacheDir, { recursive: true, force: true });
+    });
+    beforeEach(async () => {
+        jest.restoreAllMocks();
+        await fs.rm(cacheDir, { recursive: true, force: true });
+        await fs.mkdir(cacheDir, { recursive: true });
+    });
+    function mockFetchSequence(...responses) {
+        const fetchMock = jest.fn();
+        for (const response of responses) {
+            fetchMock.mockResolvedValueOnce(response);
+        }
+        global.fetch = fetchMock;
+        return fetchMock;
+    }
+    test('downloads, filters, extracts, writes metadata, and clears stale semantic index files', async () => {
+        await fs.mkdir(path.join(cacheDir, 'index'), { recursive: true });
+        await fs.writeFile(path.join(cacheDir, 'index', 'stale.json'), '{}', 'utf8');
+        const fetchMock = mockFetchSequence(jsonResponse({ sha: 'sha-first' }), tarballResponse(firstTarball));
+        const result = await ensureDocsCache();
+        expect(result).toMatchObject({
+            cacheDir,
+            action: 'first-download',
+            meta: {
+                repo: 'Roblox/creator-docs',
+                branch: 'main',
+                sha: 'sha-first',
+                fileCount: 2,
+                schemaVersion: 1,
+            },
+        });
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        await expect(fs.readFile(path.join(contentRoot(cacheDir), 'en-us', 'reference', 'engine', 'classes', 'Part.yaml'), 'utf8')).resolves.toContain('first');
+        await expect(fs.access(path.join(contentRoot(cacheDir), 'en-us', 'unkept', 'skip.md'))).rejects.toBeTruthy();
+        await expect(fs.access(path.join(cacheDir, 'index', 'stale.json'))).rejects.toBeTruthy();
+    });
+    test('uses fresh metadata without hitting the network', async () => {
+        await writeMeta(cacheDir, {
+            repo: 'Roblox/creator-docs',
+            branch: 'main',
+            sha: 'fresh-sha',
+            downloadedAt: new Date().toISOString(),
+            lastCheckedAt: new Date().toISOString(),
+            fileCount: 1,
+            bytesOnDisk: 5,
+        });
+        const fetchMock = mockFetchSequence();
+        const result = await ensureDocsCache();
+        expect(result.action).toBe('fresh');
+        expect(result.meta.sha).toBe('fresh-sha');
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+    test('short-circuits on expired metadata when upstream SHA is unchanged', async () => {
+        await writeMeta(cacheDir, {
+            repo: 'Roblox/creator-docs',
+            branch: 'main',
+            sha: 'same-sha',
+            downloadedAt: '2000-01-01T00:00:00.000Z',
+            lastCheckedAt: '2000-01-01T00:00:00.000Z',
+            fileCount: 1,
+            bytesOnDisk: 5,
+        });
+        const fetchMock = mockFetchSequence(jsonResponse({ sha: 'same-sha' }));
+        const result = await ensureDocsCache({ ttlMs: 0 });
+        const meta = await readMeta(cacheDir);
+        expect(result.action).toBe('sha-short-circuit');
+        expect(result.meta.sha).toBe('same-sha');
+        expect(meta?.lastCheckedAt).not.toBe('2000-01-01T00:00:00.000Z');
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+    });
+    test('redownloads when forced or when upstream SHA changed', async () => {
+        await writeMeta(cacheDir, {
+            repo: 'Roblox/creator-docs',
+            branch: 'main',
+            sha: 'old-sha',
+            downloadedAt: '2000-01-01T00:00:00.000Z',
+            lastCheckedAt: '2000-01-01T00:00:00.000Z',
+            fileCount: 1,
+            bytesOnDisk: 5,
+        });
+        mockFetchSequence(jsonResponse({ sha: 'new-sha' }), jsonResponse({ sha: 'new-sha' }), tarballResponse(secondTarball));
+        const changed = await ensureDocsCache({ ttlMs: 0 });
+        expect(changed.action).toBe('redownloaded');
+        expect(changed.meta.sha).toBe('new-sha');
+        await expect(fs.readFile(path.join(contentRoot(cacheDir), 'en-us', 'reference', 'engine', 'classes', 'Part.yaml'), 'utf8')).resolves.toContain('second');
+        mockFetchSequence(jsonResponse({ sha: 'forced-sha' }), tarballResponse(firstTarball));
+        const forced = await ensureDocsCache({ force: true });
+        expect(forced.action).toBe('redownloaded');
+        expect(forced.meta.sha).toBe('forced-sha');
+    });
+    test('surfaces GitHub and tarball errors with actionable messages', async () => {
+        mockFetchSequence(jsonResponse({ sha: 'sha' }), {
+            ok: false,
+            status: 500,
+            statusText: 'Server Error',
+            json: async () => ({}),
+        });
+        await expect(ensureDocsCache()).rejects.toThrow('Tarball download failed');
+        await writeMeta(cacheDir, {
+            repo: 'Roblox/creator-docs',
+            branch: 'main',
+            sha: 'old-sha',
+            downloadedAt: '2000-01-01T00:00:00.000Z',
+            lastCheckedAt: '2000-01-01T00:00:00.000Z',
+            fileCount: 1,
+            bytesOnDisk: 5,
+        });
+        mockFetchSequence({
+            ok: false,
+            status: 403,
+            statusText: 'Forbidden',
+            json: async () => ({}),
+        });
+        await expect(ensureDocsCache({ ttlMs: 0 })).rejects.toThrow('GitHub API 403 Forbidden');
+    });
+});
+//# sourceMappingURL=docs-fetcher.test.js.map

package/dist/__tests__/docs-fetcher.test.js.map

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

package/dist/__tests__/helpers.d.ts

@@ -0,0 +1,8 @@
+import type { RobloxStudioTools } from '../tools/index.js';
+export declare function parseToolText(result: any): any;
+export declare function createMockTools(): {
+    tools: RobloxStudioTools;
+    methods: Map<string, jest.Mock>;
+};
+export declare function observeRejection<T>(promise: Promise<T>): Promise<unknown>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/__tests__/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/__tests__/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAI9C;AAED,wBAAgB,eAAe,IAAI;IACjC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;CACjC,CAeA;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzE"}

package/dist/__tests__/helpers.js

@@ -0,0 +1,23 @@
+export function parseToolText(result) {
+    expect(result).toHaveProperty('content');
+    expect(result.content[0]).toMatchObject({ type: 'text' });
+    return JSON.parse(result.content[0].text);
+}
+export function createMockTools() {
+    const methods = new Map();
+    const tools = new Proxy({}, {
+        get(_target, prop) {
+            if (!methods.has(prop)) {
+                methods.set(prop, jest.fn().mockResolvedValue(`${prop}:result`));
+            }
+            return methods.get(prop);
+        },
+    });
+    return { tools, methods };
+}
+export function observeRejection(promise) {
+    return promise.then(() => {
+        throw new Error('Expected promise to reject');
+    }, (error) => error);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/__tests__/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/__tests__/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,MAAW;IACvC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe;IAI7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,EAAE,EACF;QACE,GAAG,CAAC,OAAO,EAAE,IAAY;YACvB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;KACF,CACmB,CAAC;IAEvB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAI,OAAmB;IACrD,OAAO,OAAO,CAAC,IAAI,CACjB,GAAG,EAAE;QACH,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CACjB,CAAC;AACJ,CAAC"}

package/dist/__tests__/http-routes.test.d.ts

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

package/dist/__tests__/http-routes.test.d.ts.map

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