@quenty/studio-bridge 0.21.0 → 0.22.0

package/dist/src/commands/console/logs/logs.js

@@ -5,18 +5,70 @@
 import { defineCommand } from '../../framework/define-command.js';
 import { arg } from '../../framework/arg-builder.js';
 import { OutputHelper } from '@quenty/cli-output-helpers';
+const DURATION_UNITS_SEC = {
+    s: 1,
+    m: 60,
+    h: 3600,
+    d: 86400,
+};
+/**
+ * The time `--since` names, in epoch seconds: a duration back from `nowMs`
+ * (`30s`, `5m`, `2h`, `1d`) or a date (`2026-10-27T18:00:00`).
+ */
+export function parseSince(value, nowMs = Date.now()) {
+    const duration = /^(\d+(?:\.\d+)?)([smhd])$/.exec(value.trim());
+    if (duration) {
+        return nowMs / 1000 - Number(duration[1]) * DURATION_UNITS_SEC[duration[2]];
+    }
+    const dateMs = Date.parse(value);
+    if (Number.isNaN(dateMs)) {
+        throw new Error(`Can't read --since '${value}'. Use a duration like 30s, 5m, 2h or 1d, or a date.`);
+    }
+    return dateMs / 1000;
+}
+const PLAYTEST_START_SCRIPT = 'return DateTime.now().UnixTimestampMillis / 1000 - time()';
+/** The server's DataModel starts running a moment after Edit starts the playtest. */
+const PLAYTEST_START_SLACK_SEC = 2;
+/**
+ * The `--since-restart` cutoff for `session`, in epoch seconds: none for a
+ * playtest's own session, whose log began with the playtest, and otherwise a
+ * little before the running playtest's server started.
+ */
+export async function getSinceRestartCutoffAsync(connection, session) {
+    if (session.info.context !== 'edit') {
+        return undefined;
+    }
+    const server = connection
+        .listSessions()
+        .find((info) => info.instanceId === session.info.instanceId && info.context === 'server');
+    const serverSession = server && connection.getSession(server.sessionId);
+    if (!serverSession) {
+        throw new Error(`--since-restart needs a running playtest, and '${session.info.instanceId}' has none. Use --since to read back to a time instead.`);
+    }
+    const result = await serverSession.execAsync(PLAYTEST_START_SCRIPT, 10_000);
+    const startedAt = result.returnValues?.[0];
+    if (!result.success || typeof startedAt !== 'number') {
+        throw new Error(`Could not read when the playtest started: ${result.error ?? 'no time returned'}`);
+    }
+    return startedAt - PLAYTEST_START_SLACK_SEC;
+}
 export async function queryLogsHandlerAsync(session, options = {}) {
     const result = await session.queryLogsAsync({
         count: options.count ?? 50,
         direction: options.direction ?? 'tail',
         levels: options.levels,
         includeInternal: options.includeInternal,
+        since: options.since,
+        groupRepeats: options.groupRepeats !== false,
     });
+    const entries = result.entries ?? [];
+    const shown = entries.reduce((sum, e) => sum + (e.repeats ?? 1), 0);
     return {
-        entries: result.entries ?? [],
+        entries,
         total: result.total ?? 0,
         bufferCapacity: result.bufferCapacity ?? 0,
-        summary: `${(result.entries ?? []).length} entries (${result.total ?? 0} total in buffer)`,
+        since: options.since,
+        summary: `${shown} entries (${result.total ?? 0} in buffer)`,
     };
 }
 function colorizeLevel(level) {
@@ -33,11 +85,13 @@ export function formatLogsText(result) {
     if (result.entries.length === 0)
         return result.summary;
     const lines = result.entries.map((e) => {
-        const ts = OutputHelper.formatDim(new Date(e.timestamp).toLocaleTimeString());
+        const ts = OutputHelper.formatDim(new Date(e.timestamp * 1000).toLocaleTimeString());
         const level = colorizeLevel(e.level);
-        return `[${ts}] [${level}] ${e.body}`;
+        const repeats = e.repeats ? OutputHelper.formatDim(` (x${e.repeats})`) : '';
+        return `[${ts}] [${level}] ${e.body}${repeats}`;
     });
-    lines.push(OutputHelper.formatDim(`(${result.entries.length} of ${result.total} entries)`));
+    const shown = result.entries.reduce((sum, e) => sum + (e.repeats ?? 1), 0);
+    lines.push(OutputHelper.formatDim(`(${shown} shown, ${result.total} in buffer)`));
     return lines.join('\n');
 }
 export const logsCommand = defineCommand({
@@ -58,22 +112,43 @@ export const logsCommand = defineCommand({
             choices: ['head', 'tail'],
         }),
         levels: arg.option({
-            description: 'Filter by output level (Print, Warning, Error)',
+            description: 'Filter by output level',
             array: true,
+            choices: ['Print', 'Info', 'Warning', 'Error'],
         }),
         includeInternal: arg.flag({
             description: 'Include internal/system log messages',
         }),
+        since: arg.option({
+            description: 'Only entries logged since a duration ago (30s, 5m, 2h, 1d) or a date',
+        }),
+        sinceRestart: arg.flag({
+            description: 'Only entries logged since the running playtest started',
+        }),
+        groupRepeats: arg.flag({
+            description: 'Collapse identical consecutive entries into one with a repeat count (--no-group-repeats to keep them)',
+            default: true,
+        }),
     },
     cli: {
         format: formatLogsText,
     },
-    handler: async (session, args) => {
+    handler: async (session, args, connection) => {
+        if (args.since && args.sinceRestart) {
+            throw new Error('Use either --since or --since-restart, not both');
+        }
+        const since = args.sinceRestart
+            ? await getSinceRestartCutoffAsync(connection, session)
+            : args.since
+                ? parseSince(args.since)
+                : undefined;
         return queryLogsHandlerAsync(session, {
             count: args.count,
             direction: args.direction,
             levels: args.levels,
             includeInternal: args.includeInternal,
+            since,
+            groupRepeats: args.groupRepeats,
         });
     },
 });

package/dist/src/commands/console/logs/logs.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../../../src/commands/console/logs/logs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../../../src/commands/console/logs/logs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAuC1D,MAAM,kBAAkB,GAA2B;IACjD,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,KAAK;CACT,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IAClE,MAAM,QAAQ,GAAG,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,sDAAsD,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,qBAAqB,GACzB,2DAA2D,CAAC;AAC9D,qFAAqF;AACrF,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAA4B,EAC5B,OAAsB;IAEtB,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,UAAU;SACtB,YAAY,EAAE;SACd,IAAI,CACH,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ,CAC3E,CAAC;IACJ,MAAM,aAAa,GAAG,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,kDAAkD,OAAO,CAAC,IAAI,CAAC,UAAU,yDAAyD,CACnI,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,6CACE,MAAM,CAAC,KAAK,IAAI,kBAClB,EAAE,CACH,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,GAAG,wBAAwB,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAsB,EACtB,UAAuB,EAAE;IAEzB,MAAM,MAAM,GAAqB,MAAM,OAAO,CAAC,cAAc,CAAC;QAC5D,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,OAAO,CAAC,YAAY,KAAK,KAAK;KAC7C,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpE,OAAO;QACL,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,CAAC;QAC1C,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,GAAG,KAAK,aAAa,MAAM,CAAC,KAAK,IAAI,CAAC,aAAa;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAkB;IACvC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACzC,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,YAAY,CAAC,SAAS,CAC/B,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAClD,CAAC;QACF,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CACR,YAAY,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,MAAM,CAAC,KAAK,aAAa,CAAC,CACtE,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAA8B;IACpE,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,2CAA2C;IACxD,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,iCAAiC;YAC9C,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;SACX,CAAC;QACF,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,0CAA0C;YACvD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAU;SACnC,CAAC;QACF,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,wBAAwB;YACrC,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU;SACxD,CAAC;QACF,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC;YACxB,WAAW,EAAE,sCAAsC;SACpD,CAAC;QACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;YAChB,WAAW,EACT,sEAAsE;SACzE,CAAC;QACF,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC;YACrB,WAAW,EAAE,wDAAwD;SACtE,CAAC;QACF,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC;YACrB,WAAW,EACT,uGAAuG;YACzG,OAAO,EAAE,IAAI;SACd,CAAC;KACH;IACD,GAAG,EAAE;QACH,MAAM,EAAE,cAAc;KACvB;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAC3C,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY;YAC7B,CAAC,CAAC,MAAM,0BAA0B,CAAC,UAAU,EAAE,OAAO,CAAC;YACvD,CAAC,CAAC,IAAI,CAAC,KAAK;gBACZ,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;gBACxB,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,qBAAqB,CAAC,OAAO,EAAE;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,KAAK;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/src/commands/console/logs/logs.test.js

@@ -2,7 +2,7 @@
  * Unit tests for the logs command handler.
  */
 import { describe, it, expect, vi } from 'vitest';
-import { queryLogsHandlerAsync } from './logs.js';
+import { formatLogsText, parseSince, queryLogsHandlerAsync } from './logs.js';
 function createMockSession(logsResult) {
     return {
         queryLogsAsync: vi.fn().mockResolvedValue(logsResult),
@@ -22,7 +22,7 @@ describe('queryLogsHandlerAsync', () => {
         expect(result.entries).toHaveLength(2);
         expect(result.total).toBe(42);
         expect(result.bufferCapacity).toBe(1000);
-        expect(result.summary).toBe('2 entries (42 total in buffer)');
+        expect(result.summary).toBe('2 entries (42 in buffer)');
     });
     it('passes default options to session', async () => {
         const session = createMockSession({
@@ -36,6 +36,8 @@ describe('queryLogsHandlerAsync', () => {
             direction: 'tail',
             levels: undefined,
             includeInternal: undefined,
+            since: undefined,
+            groupRepeats: true,
         });
     });
     it('passes custom options to session', async () => {
@@ -49,12 +51,15 @@ describe('queryLogsHandlerAsync', () => {
             direction: 'head',
             levels: ['Error', 'Warning'],
             includeInternal: true,
+            since: 1793125630,
         });
         expect(session.queryLogsAsync).toHaveBeenCalledWith({
             count: 100,
             direction: 'head',
             levels: ['Error', 'Warning'],
             includeInternal: true,
+            since: 1793125630,
+            groupRepeats: true,
         });
     });
     it('handles empty entries', async () => {
@@ -66,7 +71,7 @@ describe('queryLogsHandlerAsync', () => {
         const result = await queryLogsHandlerAsync(session);
         expect(result.entries).toEqual([]);
         expect(result.total).toBe(0);
-        expect(result.summary).toBe('0 entries (0 total in buffer)');
+        expect(result.summary).toBe('0 entries (0 in buffer)');
     });
     it('handles entries with all log levels', async () => {
         const entries = [
@@ -105,7 +110,61 @@ describe('queryLogsHandlerAsync', () => {
         expect(result.entries).toEqual([]);
         expect(result.total).toBe(0);
         expect(result.bufferCapacity).toBe(0);
-        expect(result.summary).toBe('0 entries (0 total in buffer)');
+        expect(result.summary).toBe('0 entries (0 in buffer)');
+    });
+});
+describe('parseSince', () => {
+    const now = Date.parse('2026-10-27T18:00:00Z');
+    it('reads a duration back from now', () => {
+        expect(parseSince('30s', now)).toBe(now / 1000 - 30);
+        expect(parseSince('5m', now)).toBe(now / 1000 - 300);
+        expect(parseSince('2h', now)).toBe(now / 1000 - 7200);
+    });
+    it('reads a date', () => {
+        expect(parseSince('2026-10-27T17:00:00Z', now)).toBe(now / 1000 - 3600);
+    });
+    it('refuses anything else', () => {
+        expect(() => parseSince('yesterday', now)).toThrow(/Can't read --since/);
+    });
+});
+describe('repeat grouping', () => {
+    it('is asked of the plugin unless turned off', async () => {
+        const session = createMockSession({
+            entries: [],
+            total: 0,
+            bufferCapacity: 1000,
+        });
+        await queryLogsHandlerAsync(session);
+        await queryLogsHandlerAsync(session, { groupRepeats: false });
+        expect(session.queryLogsAsync.mock.calls[0][0].groupRepeats).toBe(true);
+        expect(session.queryLogsAsync.mock.calls[1][0].groupRepeats).toBe(false);
+    });
+    it('counts each repeat in the summary', async () => {
+        const session = createMockSession({
+            entries: [
+                { level: 'Print', body: 'tick', timestamp: 1, repeats: 3 },
+                { level: 'Print', body: 'done', timestamp: 4 },
+            ],
+            total: 4,
+            bufferCapacity: 1000,
+        });
+        expect((await queryLogsHandlerAsync(session)).summary).toBe('4 entries (4 in buffer)');
+    });
+});
+describe('formatLogsText', () => {
+    it('shows the repeat count and counts every repeat as shown', () => {
+        const text = formatLogsText({
+            entries: [
+                { level: 'Print', body: 'tick', timestamp: 1793125630, repeats: 3 },
+            ],
+            total: 3,
+            bufferCapacity: 1000,
+            summary: '3 entries (3 in buffer)',
+        });
+        expect(text).toContain('tick');
+        expect(text).toContain('(x3)');
+        expect(text).toContain('(3 shown, 3 in buffer)');
+        expect(text).toContain(new Date(1793125630 * 1000).toLocaleTimeString());
     });
 });
 //# sourceMappingURL=logs.test.js.map

package/dist/src/commands/console/logs/logs.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.test.js","sourceRoot":"","sources":["../../../../../src/commands/console/logs/logs.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logs.test.js","sourceRoot":"","sources":["../../../../../src/commands/console/logs/logs.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE9E,SAAS,iBAAiB,CAAC,UAI1B;IACC,OAAO;QACL,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC;KAC/C,CAAC;AACX,CAAC;AAED,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE;gBACxD,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE;aACzD;YACD,KAAK,EAAE,EAAE;YACT,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC;YACR,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC;YAClD,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,SAAS;YACjB,eAAe,EAAE,SAAS;YAC1B,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC;YACR,cAAc,EAAE,GAAG;SACpB,CAAC,CAAC;QAEH,MAAM,qBAAqB,CAAC,OAAO,EAAE;YACnC,KAAK,EAAE,GAAG;YACV,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;YAC5B,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC;YAClD,KAAK,EAAE,GAAG;YACV,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;YAC5B,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,UAAU;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;QACrC,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC;YACR,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,OAAO,GAAG;YACd,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE;YACzD,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE;YACxD,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI,EAAE;YAC9D,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE;SAC3D,CAAC;QACF,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,OAAO;YACP,KAAK,EAAE,CAAC;YACR,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,OAAO,GAAG;YACd,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;SACjE,CAAC;QAET,MAAM,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC1D,iBAAiB,CAClB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG;YACd,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACxC,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE,SAAS;gBAChB,cAAc,EAAE,SAAS;aAC1B,CAAC;SACI,CAAC;QAET,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAE/C,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC;QACrD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;QACtB,MAAM,CAAC,UAAU,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC;YACR,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,qBAAqB,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QAE9D,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;gBAC1D,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE;aAC/C;YACD,KAAK,EAAE,CAAC;YACR,cAAc,EAAE,IAAI;SACd,CAAC,CAAC;QAEV,MAAM,CAAC,CAAC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CACzD,yBAAyB,CAC1B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,IAAI,GAAG,cAAc,CAAC;YAC1B,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE;aACpE;YACD,KAAK,EAAE,CAAC;YACR,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,yBAAyB;SACnC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/commands/explorer/export/export.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `explorer export` — serialize instances from a connected Studio session
+ * into a binary model (.rbxm).
+ */
+import type { BridgeSession } from '../../../bridge/index.js';
+export interface ExportResult {
+    /** The binary model (.rbxm), base64-encoded. */
+    data: string;
+    paths: string[];
+    bytes: number;
+    summary: string;
+}
+interface ExportArgs {
+    paths: string[];
+}
+export declare function exportInstancesHandlerAsync(session: BridgeSession, paths: string[]): Promise<ExportResult>;
+export declare const exportCommand: import("../../framework/define-command.js").CommandDefinition<ExportArgs, ExportResult>;
+export {};
+//# sourceMappingURL=export.d.ts.map

package/dist/src/commands/explorer/export/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../../src/commands/explorer/export/export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,YAAY,CAAC,CAYvB;AAED,eAAO,MAAM,aAAa,yFAqBxB,CAAC"}

package/dist/src/commands/explorer/export/export.js

@@ -0,0 +1,37 @@
+/**
+ * `explorer export` — serialize instances from a connected Studio session
+ * into a binary model (.rbxm).
+ */
+import { defineCommand } from '../../framework/define-command.js';
+import { arg } from '../../framework/arg-builder.js';
+export async function exportInstancesHandlerAsync(session, paths) {
+    const result = await session.exportInstancesAsync(paths);
+    const bytes = Buffer.from(result.data, 'base64').length;
+    return {
+        data: result.data,
+        paths: result.paths,
+        bytes,
+        summary: `Exported ${result.paths.length} instance(s) (${bytes} bytes): ${result.paths.join(', ')}`,
+    };
+}
+export const exportCommand = defineCommand({
+    group: 'explorer',
+    name: 'export',
+    description: 'Save instances from Studio as a binary model (.rbxm). Use -o to write the file.',
+    category: 'execution',
+    safety: 'read',
+    scope: 'session',
+    args: {
+        paths: arg.positional({
+            description: 'Dot-separated instance paths (e.g. Workspace.Map)',
+            required: true,
+            array: true,
+        }),
+    },
+    cli: {
+        binaryField: 'data',
+        format: (result) => result.summary,
+    },
+    handler: async (session, args) => exportInstancesHandlerAsync(session, args.paths),
+});
+//# sourceMappingURL=export.js.map

package/dist/src/commands/explorer/export/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../../../src/commands/explorer/export/export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AAerD,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAsB,EACtB,KAAe;IAEf,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC;IAExD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK;QACL,OAAO,EAAE,YACP,MAAM,CAAC,KAAK,CAAC,MACf,iBAAiB,KAAK,YAAY,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA2B;IACnE,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,iFAAiF;IACnF,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC;YACpB,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,IAAI;SACZ,CAAC;KACH;IACD,GAAG,EAAE;QACH,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;KACnC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAC/B,2BAA2B,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;CACnD,CAAC,CAAC"}

package/dist/src/commands/explorer/export/export.test.d.ts

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

package/dist/src/commands/explorer/export/export.test.d.ts.map

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

package/dist/src/commands/explorer/export/export.test.js

@@ -0,0 +1,25 @@
+import { describe, it, expect, vi } from 'vitest';
+import { exportInstancesHandlerAsync } from './export.js';
+describe('exportInstancesHandlerAsync', () => {
+    it('returns the model with its size and the exported paths', async () => {
+        const data = Buffer.from('<roblox!model').toString('base64');
+        const session = {
+            exportInstancesAsync: vi
+                .fn()
+                .mockResolvedValue({ data, paths: ['Workspace.Map'] }),
+        };
+        const result = await exportInstancesHandlerAsync(session, [
+            'Workspace.Map',
+        ]);
+        expect(session.exportInstancesAsync).toHaveBeenCalledWith([
+            'Workspace.Map',
+        ]);
+        expect(result).toEqual({
+            data,
+            paths: ['Workspace.Map'],
+            bytes: 13,
+            summary: 'Exported 1 instance(s) (13 bytes): Workspace.Map',
+        });
+    });
+});
+//# sourceMappingURL=export.test.js.map

package/dist/src/commands/explorer/export/export.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.test.js","sourceRoot":"","sources":["../../../../../src/commands/explorer/export/export.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG;YACd,oBAAoB,EAAE,EAAE;iBACrB,EAAE,EAAE;iBACJ,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;SAClD,CAAC;QAET,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE;YACxD,eAAe;SAChB,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,oBAAoB,CAAC;YACxD,eAAe;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI;YACJ,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/commands/explorer/find/find.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `explorer find` — search the DataModel for instances by name, class and tag.
+ */
+import type { BridgeSession } from '../../../bridge/index.js';
+import type { FoundInstance } from '../../../server/web-socket-protocol.js';
+export interface FindOptions {
+    name?: string;
+    exact?: boolean;
+    className?: string;
+    tag?: string;
+    root?: string;
+    limit?: number;
+}
+export interface FindResult {
+    instances: FoundInstance[];
+    searched: number;
+    /** True when the search stopped at --limit; there may be more. */
+    truncated: boolean;
+    summary: string;
+}
+export declare function findInstancesHandlerAsync(session: BridgeSession, options: FindOptions): Promise<FindResult>;
+export declare function formatFindText(result: FindResult): string;
+interface FindArgs extends Omit<FindOptions, 'className'> {
+    class?: string;
+}
+export declare const findCommand: import("../../framework/define-command.js").CommandDefinition<FindArgs, FindResult>;
+export {};
+//# sourceMappingURL=find.d.ts.map

package/dist/src/commands/explorer/find/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../../../src/commands/explorer/find/find.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAWD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAKzD;AAED,UAAU,QAAS,SAAQ,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,WAAW,qFAoCtB,CAAC"}

package/dist/src/commands/explorer/find/find.js

@@ -0,0 +1,75 @@
+/**
+ * `explorer find` — search the DataModel for instances by name, class and tag.
+ */
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { formatTable, } from '@quenty/cli-output-helpers/reporting';
+import { defineCommand } from '../../framework/define-command.js';
+import { arg } from '../../framework/arg-builder.js';
+export async function findInstancesHandlerAsync(session, options) {
+    if (!options.name && !options.className && !options.tag) {
+        throw new Error('Give a name, --class or --tag to search for');
+    }
+    const result = await session.findInstancesAsync({
+        root: options.root,
+        name: options.name,
+        exactName: options.exact,
+        className: options.className,
+        tag: options.tag,
+        limit: options.limit,
+    });
+    return {
+        ...result,
+        summary: result.truncated
+            ? `First ${result.instances.length} matches; raise --limit to see more`
+            : `${result.instances.length} match(es) among ${result.searched} instances`,
+    };
+}
+const columns = [
+    {
+        header: 'Path',
+        value: (i) => i.path,
+        format: (v) => OutputHelper.formatHint(v),
+    },
+    { header: 'Class', value: (i) => i.className },
+];
+export function formatFindText(result) {
+    if (result.instances.length === 0)
+        return 'No instances match';
+    return `${formatTable(result.instances, columns)}\n${OutputHelper.formatDim(result.summary)}`;
+}
+export const findCommand = defineCommand({
+    group: 'explorer',
+    name: 'find',
+    description: 'Find instances by name, class or tag',
+    category: 'execution',
+    safety: 'read',
+    scope: 'session',
+    args: {
+        name: arg.positional({
+            description: 'Text in the instance name (case-insensitive)',
+            required: false,
+        }),
+        exact: arg.flag({
+            description: 'Match the whole name instead of part of it',
+        }),
+        class: arg.option({
+            description: 'Only instances of this class or a subclass (IsA)',
+        }),
+        tag: arg.option({
+            description: 'Only instances with this CollectionService tag',
+        }),
+        root: arg.option({
+            description: 'Dot-separated path to search under (default: the whole DataModel)',
+        }),
+        limit: arg.option({
+            description: 'Stop after this many matches (default: 200)',
+            type: 'number',
+            alias: 'n',
+        }),
+    },
+    cli: {
+        format: formatFindText,
+    },
+    handler: async (session, { class: className, ...args }) => findInstancesHandlerAsync(session, { ...args, className }),
+});
+//# sourceMappingURL=find.js.map

package/dist/src/commands/explorer/find/find.js.map

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

package/dist/src/commands/explorer/find/find.test.d.ts

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

package/dist/src/commands/explorer/find/find.test.d.ts.map

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

package/dist/src/commands/explorer/find/find.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect, vi } from 'vitest';
+import { findInstancesHandlerAsync, formatFindText } from './find.js';
+function createSession(result) {
+    return { findInstancesAsync: vi.fn().mockResolvedValue(result) };
+}
+describe('findInstancesHandlerAsync', () => {
+    it('passes the search through and summarizes it', async () => {
+        const session = createSession({
+            instances: [
+                { path: 'Workspace.RedSpawn', name: 'RedSpawn', className: 'Part' },
+            ],
+            searched: 120,
+            truncated: false,
+        });
+        const result = await findInstancesHandlerAsync(session, {
+            name: 'spawn',
+            className: 'BasePart',
+            exact: true,
+        });
+        expect(session.findInstancesAsync).toHaveBeenCalledWith({
+            name: 'spawn',
+            className: 'BasePart',
+            exactName: true,
+            root: undefined,
+            tag: undefined,
+            limit: undefined,
+        });
+        expect(result.summary).toBe('1 match(es) among 120 instances');
+        expect(formatFindText(result)).toContain('Workspace.RedSpawn');
+    });
+    it('says when it stopped at the limit', async () => {
+        const session = createSession({
+            instances: [{ path: 'Workspace.A', name: 'A', className: 'Part' }],
+            searched: 10,
+            truncated: true,
+        });
+        const result = await findInstancesHandlerAsync(session, { tag: 'Spawn' });
+        expect(result.summary).toBe('First 1 matches; raise --limit to see more');
+    });
+    it('needs something to search for', async () => {
+        await expect(findInstancesHandlerAsync(createSession({}), {})).rejects.toThrow('Give a name, --class or --tag to search for');
+    });
+});
+//# sourceMappingURL=find.test.js.map

package/dist/src/commands/explorer/find/find.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.test.js","sourceRoot":"","sources":["../../../../../src/commands/explorer/find/find.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEtE,SAAS,aAAa,CAAC,MAAe;IACpC,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAS,CAAC;AAC1E,CAAC;AAED,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,SAAS,EAAE;gBACT,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;aACpE;YACD,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,OAAO,EAAE;YACtD,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,UAAU;YACrB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAAC;YACtD,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC/D,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;YAClE,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAE1E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,CACV,yBAAyB,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CACjD,CAAC,OAAO,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/commands/explorer/grep/grep.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `explorer grep` — search the source of every script in Studio.
+ */
+import type { BridgeSession } from '../../../bridge/index.js';
+import type { GrepMatch } from '../../../server/web-socket-protocol.js';
+export interface GrepOptions {
+    pattern: string;
+    root?: string;
+    luaPattern?: boolean;
+    caseSensitive?: boolean;
+    limit?: number;
+}
+export interface GrepResult {
+    matches: GrepMatch[];
+    searched: number;
+    /** True when the search stopped at --limit; there may be more. */
+    truncated: boolean;
+    summary: string;
+}
+export declare function grepScriptsHandlerAsync(session: BridgeSession, options: GrepOptions): Promise<GrepResult>;
+/** `path:line: text`, like grep. */
+export declare function formatGrepText(result: GrepResult): string;
+export declare const grepCommand: import("../../framework/define-command.js").CommandDefinition<GrepOptions, GrepResult>;
+//# sourceMappingURL=grep.d.ts.map

package/dist/src/commands/explorer/grep/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../../../src/commands/explorer/grep/grep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAUzD;AAED,eAAO,MAAM,WAAW,wFAgCtB,CAAC"}