@quenty/studio-bridge 0.7.0 → 0.8.0

package/dist/src/commands/connect.test.js

@@ -0,0 +1,46 @@
+/**
+ * Unit tests for the connect command handler.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { connectHandlerAsync } from './connect.js';
+function createMockConnection(sessionInfo) {
+    return {
+        resolveSessionAsync: vi.fn().mockResolvedValue({
+            info: sessionInfo,
+        }),
+    };
+}
+describe('connectHandlerAsync', () => {
+    it('resolves session and returns metadata', async () => {
+        const conn = createMockConnection({
+            sessionId: 'abc-123',
+            context: 'edit',
+            placeName: 'TestPlace',
+        });
+        const result = await connectHandlerAsync(conn, { sessionId: 'abc-123' });
+        expect(result.sessionId).toBe('abc-123');
+        expect(result.context).toBe('edit');
+        expect(result.placeName).toBe('TestPlace');
+        expect(result.summary).toContain('abc-123');
+        expect(result.summary).toContain('TestPlace');
+        expect(result.summary).toContain('edit');
+    });
+    it('passes sessionId to resolveSession', async () => {
+        const conn = createMockConnection({
+            sessionId: 'xyz-789',
+            context: 'server',
+            placeName: 'GamePlace',
+        });
+        await connectHandlerAsync(conn, { sessionId: 'xyz-789' });
+        expect(conn.resolveSessionAsync).toHaveBeenCalledWith('xyz-789');
+    });
+    it('propagates errors from resolveSession', async () => {
+        const conn = {
+            resolveSessionAsync: vi
+                .fn()
+                .mockRejectedValue(new Error('Session not found')),
+        };
+        await expect(connectHandlerAsync(conn, { sessionId: 'bad-id' })).rejects.toThrow('Session not found');
+    });
+});
+//# sourceMappingURL=connect.test.js.map

package/dist/src/commands/connect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.test.js","sourceRoot":"","sources":["../../../src/commands/connect.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,SAAS,oBAAoB,CAAC,WAI7B;IACC,OAAO;QACL,mBAAmB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC7C,IAAI,EAAE,WAAW;SAClB,CAAC;KACI,CAAC;AACX,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,IAAI,GAAG,oBAAoB,CAAC;YAChC,SAAS,EAAE,SAAS;YACpB,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAEzE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,IAAI,GAAG,oBAAoB,CAAC;YAChC,SAAS,EAAE,SAAS;YACpB,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;QAEH,MAAM,mBAAmB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAE1D,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,IAAI,GAAG;YACX,mBAAmB,EAAE,EAAE;iBACpB,EAAE,EAAE;iBACJ,iBAAiB,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;SAC9C,CAAC;QAET,MAAM,MAAM,CACV,mBAAmB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CACnD,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/commands/console/exec/exec.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `console exec` — execute Luau code in a connected Studio session.
+ *
+ * Accepts inline code (positional), a file path (`--file`), or stdin.
+ * This unifies the old `exec` and `run` commands.
+ */
+import type { BridgeSession } from '../../../bridge/index.js';
+export interface ExecOptions {
+    scriptContent: string;
+    timeout?: number;
+}
+export interface ExecResult {
+    success: boolean;
+    output: string[];
+    error?: string;
+    summary: string;
+}
+export interface RunOptions {
+    scriptPath: string;
+    timeout?: number;
+}
+export interface RunResult {
+    success: boolean;
+    output: string[];
+    error?: string;
+    summary: string;
+}
+interface ConsoleExecArgs {
+    code?: string;
+    file?: string;
+    timeout?: number;
+}
+/**
+ * Execute inline Luau code in a connected Studio session.
+ */
+export declare function execHandlerAsync(session: BridgeSession, options: ExecOptions): Promise<ExecResult>;
+/**
+ * Read a Luau script file and execute it in a connected Studio session.
+ */
+export declare function runHandlerAsync(session: BridgeSession, options: RunOptions): Promise<RunResult>;
+export declare const execCommand: import("../../framework/define-command.js").CommandDefinition<ConsoleExecArgs, ExecResult>;
+export {};
+//# sourceMappingURL=exec.d.ts.map

package/dist/src/commands/console/exec/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../../../src/commands/console/exec/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAkBrB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,CAAC,CAgBpB;AAED,eAAO,MAAM,WAAW,4FAoCtB,CAAC"}

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

@@ -0,0 +1,79 @@
+/**
+ * `console exec` — execute Luau code in a connected Studio session.
+ *
+ * Accepts inline code (positional), a file path (`--file`), or stdin.
+ * This unifies the old `exec` and `run` commands.
+ */
+import * as fs from 'fs/promises';
+import { defineCommand } from '../../framework/define-command.js';
+import { arg } from '../../framework/arg-builder.js';
+import { resolveScriptContentAsync } from '../../../cli/resolve-script-content.js';
+/**
+ * Execute inline Luau code in a connected Studio session.
+ */
+export async function execHandlerAsync(session, options) {
+    const result = await session.execAsync(options.scriptContent, options.timeout);
+    const output = (result.output ?? []).map((entry) => typeof entry === 'string' ? entry : entry.body);
+    return {
+        success: result.success,
+        output,
+        error: result.error,
+        summary: result.success
+            ? 'Script executed successfully'
+            : `Script failed: ${result.error}`,
+    };
+}
+/**
+ * Read a Luau script file and execute it in a connected Studio session.
+ */
+export async function runHandlerAsync(session, options) {
+    const scriptContent = await fs.readFile(options.scriptPath, 'utf-8');
+    const result = await session.execAsync(scriptContent, options.timeout);
+    const output = (result.output ?? []).map((entry) => typeof entry === 'string' ? entry : entry.body);
+    return {
+        success: result.success,
+        output,
+        error: result.error,
+        summary: result.success
+            ? `Script ${options.scriptPath} executed successfully`
+            : `Script ${options.scriptPath} failed: ${result.error}`,
+    };
+}
+export const execCommand = defineCommand({
+    group: 'console',
+    name: 'exec',
+    description: 'Execute Luau code in a connected Studio session',
+    category: 'execution',
+    safety: 'mutate',
+    scope: 'session',
+    args: {
+        code: arg.positional({
+            description: 'Inline Luau code to execute',
+            required: false,
+        }),
+        file: arg.option({
+            description: 'Path to a Luau script file to execute',
+            alias: 'f',
+        }),
+        timeout: arg.option({
+            description: 'Execution timeout in milliseconds',
+            type: 'number',
+        }),
+    },
+    cli: {
+        format: (result) => {
+            const lines = result.output.join('\n');
+            if (result.error)
+                return lines + (lines ? '\n' : '') + result.error;
+            return lines || result.summary;
+        },
+    },
+    handler: async (session, args) => {
+        const { scriptContent } = await resolveScriptContentAsync(args);
+        return execHandlerAsync(session, {
+            scriptContent,
+            timeout: args.timeout,
+        });
+    },
+});
+//# sourceMappingURL=exec.js.map

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

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

package/dist/src/commands/console/exec/exec.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the unified exec command handler.
+ */
+export {};
+//# sourceMappingURL=exec.test.d.ts.map

package/dist/src/commands/console/exec/exec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.test.d.ts","sourceRoot":"","sources":["../../../../../src/commands/console/exec/exec.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,191 @@
+/**
+ * Unit tests for the unified exec command handler.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { execHandlerAsync, runHandlerAsync } from './exec.js';
+// Mock fs/promises.readFile for runHandlerAsync
+vi.mock('fs/promises', () => ({
+    readFile: vi.fn(),
+}));
+import * as fs from 'fs/promises';
+function createMockSession(execResult) {
+    return {
+        execAsync: vi.fn().mockResolvedValue(execResult),
+    };
+}
+describe('execHandlerAsync', () => {
+    it('returns success result with summary', async () => {
+        const session = createMockSession({
+            success: true,
+            output: [{ level: 'Print', body: 'Hello world' }],
+        });
+        const result = await execHandlerAsync(session, {
+            scriptContent: 'print("Hello world")',
+        });
+        expect(result.success).toBe(true);
+        expect(result.output).toEqual(['Hello world']);
+        expect(result.error).toBeUndefined();
+        expect(result.summary).toBe('Script executed successfully');
+    });
+    it('returns failure result with error', async () => {
+        const session = createMockSession({
+            success: false,
+            output: [],
+            error: 'Syntax error on line 1',
+        });
+        const result = await execHandlerAsync(session, {
+            scriptContent: 'bad code',
+        });
+        expect(result.success).toBe(false);
+        expect(result.output).toEqual([]);
+        expect(result.error).toBe('Syntax error on line 1');
+        expect(result.summary).toBe('Script failed: Syntax error on line 1');
+    });
+    it('forwards timeout to session.execAsync', async () => {
+        const session = createMockSession({
+            success: true,
+            output: [],
+        });
+        await execHandlerAsync(session, {
+            scriptContent: 'print("test")',
+            timeout: 5000,
+        });
+        expect(session.execAsync).toHaveBeenCalledWith('print("test")', 5000);
+    });
+    it('passes undefined timeout when not specified', async () => {
+        const session = createMockSession({
+            success: true,
+            output: [],
+        });
+        await execHandlerAsync(session, {
+            scriptContent: 'print("test")',
+        });
+        expect(session.execAsync).toHaveBeenCalledWith('print("test")', undefined);
+    });
+    it('captures multiple output lines', async () => {
+        const session = createMockSession({
+            success: true,
+            output: [
+                { level: 'Print', body: 'line 1' },
+                { level: 'Print', body: 'line 2' },
+                { level: 'Warning', body: 'warning line' },
+            ],
+        });
+        const result = await execHandlerAsync(session, {
+            scriptContent: 'print("line 1") print("line 2") warn("warning line")',
+        });
+        expect(result.output).toEqual(['line 1', 'line 2', 'warning line']);
+    });
+    it('handles empty output array', async () => {
+        const session = createMockSession({
+            success: true,
+            output: [],
+        });
+        const result = await execHandlerAsync(session, {
+            scriptContent: 'local x = 1',
+        });
+        expect(result.output).toEqual([]);
+    });
+    it('handles missing output field gracefully', async () => {
+        const session = {
+            execAsync: vi.fn().mockResolvedValue({
+                success: true,
+                output: undefined,
+            }),
+        };
+        const result = await execHandlerAsync(session, {
+            scriptContent: 'local x = 1',
+        });
+        expect(result.output).toEqual([]);
+    });
+    it('propagates errors from session', async () => {
+        const session = {
+            execAsync: vi.fn().mockRejectedValue(new Error('Connection lost')),
+        };
+        await expect(execHandlerAsync(session, { scriptContent: 'print("test")' })).rejects.toThrow('Connection lost');
+    });
+});
+describe('runHandlerAsync', () => {
+    it('reads file and delegates to session.execAsync', async () => {
+        vi.mocked(fs.readFile).mockResolvedValue('print("from file")');
+        const session = createMockSession({
+            success: true,
+            output: [{ level: 'Print', body: 'from file' }],
+        });
+        const result = await runHandlerAsync(session, {
+            scriptPath: '/tmp/test.lua',
+        });
+        expect(fs.readFile).toHaveBeenCalledWith('/tmp/test.lua', 'utf-8');
+        expect(session.execAsync).toHaveBeenCalledWith('print("from file")', undefined);
+        expect(result.success).toBe(true);
+        expect(result.output).toEqual(['from file']);
+        expect(result.summary).toBe('Script /tmp/test.lua executed successfully');
+    });
+    it('returns failure result with script path in summary', async () => {
+        vi.mocked(fs.readFile).mockResolvedValue('bad code');
+        const session = createMockSession({
+            success: false,
+            output: [],
+            error: 'Syntax error',
+        });
+        const result = await runHandlerAsync(session, {
+            scriptPath: '/tmp/broken.lua',
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Syntax error');
+        expect(result.summary).toBe('Script /tmp/broken.lua failed: Syntax error');
+    });
+    it('forwards timeout to session.execAsync', async () => {
+        vi.mocked(fs.readFile).mockResolvedValue('print("test")');
+        const session = createMockSession({
+            success: true,
+            output: [],
+        });
+        await runHandlerAsync(session, {
+            scriptPath: '/tmp/test.lua',
+            timeout: 10_000,
+        });
+        expect(session.execAsync).toHaveBeenCalledWith('print("test")', 10_000);
+    });
+    it('throws when file cannot be read', async () => {
+        vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT: no such file or directory'));
+        const session = createMockSession({
+            success: true,
+            output: [],
+        });
+        await expect(runHandlerAsync(session, { scriptPath: '/tmp/missing.lua' })).rejects.toThrow('ENOENT');
+    });
+    it('captures multiple output lines', async () => {
+        vi.mocked(fs.readFile).mockResolvedValue('print("a") print("b")');
+        const session = createMockSession({
+            success: true,
+            output: [
+                { level: 'Print', body: 'a' },
+                { level: 'Print', body: 'b' },
+            ],
+        });
+        const result = await runHandlerAsync(session, {
+            scriptPath: '/tmp/multi.lua',
+        });
+        expect(result.output).toEqual(['a', 'b']);
+    });
+    it('handles empty output', async () => {
+        vi.mocked(fs.readFile).mockResolvedValue('local x = 1');
+        const session = createMockSession({
+            success: true,
+            output: [],
+        });
+        const result = await runHandlerAsync(session, {
+            scriptPath: '/tmp/silent.lua',
+        });
+        expect(result.output).toEqual([]);
+    });
+    it('propagates errors from session', async () => {
+        vi.mocked(fs.readFile).mockResolvedValue('print("test")');
+        const session = {
+            execAsync: vi.fn().mockRejectedValue(new Error('Connection lost')),
+        };
+        await expect(runHandlerAsync(session, { scriptPath: '/tmp/test.lua' })).rejects.toThrow('Connection lost');
+    });
+});
+//# sourceMappingURL=exec.test.js.map

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

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

package/dist/src/commands/console/logs/logs.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `console logs` — retrieve buffered log history from a connected
+ * Studio session's ring buffer.
+ */
+import type { BridgeSession } from '../../../bridge/index.js';
+import type { LogEntry } from '../../../bridge/index.js';
+import type { OutputLevel } from '../../../server/web-socket-protocol.js';
+export interface LogsResult {
+    entries: LogEntry[];
+    total: number;
+    bufferCapacity: number;
+    summary: string;
+}
+export interface LogsOptions {
+    count?: number;
+    direction?: 'head' | 'tail';
+    levels?: OutputLevel[];
+    includeInternal?: boolean;
+}
+export declare function queryLogsHandlerAsync(session: BridgeSession, options?: LogsOptions): Promise<LogsResult>;
+export declare function formatLogsText(result: LogsResult): string;
+export declare const logsCommand: import("../../framework/define-command.js").CommandDefinition<LogsOptions, LogsResult>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/src/commands/console/logs/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../../../src/commands/console/logs/logs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EACV,QAAQ,EAET,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAaD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAezD;AAED,eAAO,MAAM,WAAW,wFAoCtB,CAAC"}

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

@@ -0,0 +1,80 @@
+/**
+ * `console logs` — retrieve buffered log history from a connected
+ * Studio session's ring buffer.
+ */
+import { defineCommand } from '../../framework/define-command.js';
+import { arg } from '../../framework/arg-builder.js';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+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,
+    });
+    return {
+        entries: result.entries ?? [],
+        total: result.total ?? 0,
+        bufferCapacity: result.bufferCapacity ?? 0,
+        summary: `${(result.entries ?? []).length} entries (${result.total ?? 0} total in buffer)`,
+    };
+}
+function colorizeLevel(level) {
+    switch (level) {
+        case 'Error':
+            return OutputHelper.formatError(level);
+        case 'Warning':
+            return OutputHelper.formatWarning(level);
+        default:
+            return level;
+    }
+}
+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 level = colorizeLevel(e.level);
+        return `[${ts}] [${level}] ${e.body}`;
+    });
+    lines.push(OutputHelper.formatDim(`(${result.entries.length} of ${result.total} entries)`));
+    return lines.join('\n');
+}
+export const logsCommand = defineCommand({
+    group: 'console',
+    name: 'logs',
+    description: 'Retrieve buffered log history from Studio',
+    category: 'execution',
+    safety: 'read',
+    scope: 'session',
+    args: {
+        count: arg.option({
+            description: 'Number of log entries to return',
+            type: 'number',
+            alias: 'n',
+        }),
+        direction: arg.option({
+            description: 'Read from head (oldest) or tail (newest)',
+            choices: ['head', 'tail'],
+        }),
+        levels: arg.option({
+            description: 'Filter by output level (Print, Warning, Error)',
+            array: true,
+        }),
+        includeInternal: arg.flag({
+            description: 'Include internal/system log messages',
+        }),
+    },
+    cli: {
+        format: formatLogsText,
+    },
+    handler: async (session, args) => {
+        return queryLogsHandlerAsync(session, {
+            count: args.count,
+            direction: args.direction,
+            levels: args.levels,
+            includeInternal: args.includeInternal,
+        });
+    },
+});
+//# sourceMappingURL=logs.js.map

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

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

package/dist/src/commands/console/logs/logs.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the logs command handler.
+ */
+export {};
+//# sourceMappingURL=logs.test.d.ts.map

package/dist/src/commands/console/logs/logs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.test.d.ts","sourceRoot":"","sources":["../../../../../src/commands/console/logs/logs.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,111 @@
+/**
+ * Unit tests for the logs command handler.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { queryLogsHandlerAsync } from './logs.js';
+function createMockSession(logsResult) {
+    return {
+        queryLogsAsync: vi.fn().mockResolvedValue(logsResult),
+    };
+}
+describe('queryLogsHandlerAsync', () => {
+    it('returns log entries with summary', async () => {
+        const session = createMockSession({
+            entries: [
+                { level: 'Print', body: 'Hello world', timestamp: 1000 },
+                { level: 'Warning', body: 'Watch out', timestamp: 2000 },
+            ],
+            total: 42,
+            bufferCapacity: 1000,
+        });
+        const result = await queryLogsHandlerAsync(session);
+        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)');
+    });
+    it('passes default options to session', async () => {
+        const session = createMockSession({
+            entries: [],
+            total: 0,
+            bufferCapacity: 1000,
+        });
+        await queryLogsHandlerAsync(session);
+        expect(session.queryLogsAsync).toHaveBeenCalledWith({
+            count: 50,
+            direction: 'tail',
+            levels: undefined,
+            includeInternal: undefined,
+        });
+    });
+    it('passes custom options to session', async () => {
+        const session = createMockSession({
+            entries: [],
+            total: 0,
+            bufferCapacity: 500,
+        });
+        await queryLogsHandlerAsync(session, {
+            count: 100,
+            direction: 'head',
+            levels: ['Error', 'Warning'],
+            includeInternal: true,
+        });
+        expect(session.queryLogsAsync).toHaveBeenCalledWith({
+            count: 100,
+            direction: 'head',
+            levels: ['Error', 'Warning'],
+            includeInternal: true,
+        });
+    });
+    it('handles empty entries', async () => {
+        const session = createMockSession({
+            entries: [],
+            total: 0,
+            bufferCapacity: 1000,
+        });
+        const result = await queryLogsHandlerAsync(session);
+        expect(result.entries).toEqual([]);
+        expect(result.total).toBe(0);
+        expect(result.summary).toBe('0 entries (0 total in buffer)');
+    });
+    it('handles entries with all log levels', async () => {
+        const entries = [
+            { level: 'Print', body: 'info message', timestamp: 1000 },
+            { level: 'Info', body: 'info message', timestamp: 2000 },
+            { level: 'Warning', body: 'warning message', timestamp: 3000 },
+            { level: 'Error', body: 'error message', timestamp: 4000 },
+        ];
+        const session = createMockSession({
+            entries,
+            total: 4,
+            bufferCapacity: 1000,
+        });
+        const result = await queryLogsHandlerAsync(session);
+        expect(result.entries).toHaveLength(4);
+        expect(result.entries[0].level).toBe('Print');
+        expect(result.entries[1].level).toBe('Info');
+        expect(result.entries[2].level).toBe('Warning');
+        expect(result.entries[3].level).toBe('Error');
+    });
+    it('propagates errors from session', async () => {
+        const session = {
+            queryLogsAsync: vi.fn().mockRejectedValue(new Error('Connection lost')),
+        };
+        await expect(queryLogsHandlerAsync(session)).rejects.toThrow('Connection lost');
+    });
+    it('handles missing fields gracefully', async () => {
+        const session = {
+            queryLogsAsync: vi.fn().mockResolvedValue({
+                entries: undefined,
+                total: undefined,
+                bufferCapacity: undefined,
+            }),
+        };
+        const result = await queryLogsHandlerAsync(session);
+        expect(result.entries).toEqual([]);
+        expect(result.total).toBe(0);
+        expect(result.bufferCapacity).toBe(0);
+        expect(result.summary).toBe('0 entries (0 total in buffer)');
+    });
+});
+//# sourceMappingURL=logs.test.js.map

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

@@ -0,0 +1 @@
+{"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,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,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,gCAAgC,CAAC,CAAC;IAChE,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;SAC3B,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;SACtB,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;SACtB,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,+BAA+B,CAAC,CAAC;IAC/D,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,+BAA+B,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}