@quenty/studio-bridge 0.21.1 → 0.22.0

package/dist/src/cli/script-executor.js

@@ -7,6 +7,8 @@ import * as path from 'path';
 import { OutputHelper } from '@quenty/cli-output-helpers';
 import { CompositeReporter, SimpleReporter, SpinnerReporter, } from '@quenty/cli-output-helpers/reporting';
 import { StudioBridgeServer, } from '../server/studio-bridge-server.js';
+import { isPersistentPluginInstalled } from '../plugin/plugin-discovery.js';
+import { runInManagedStudioAsync } from './managed-studio-run.js';
 /**
  * Resolves and validates a place file path. Returns undefined if no place
  * was specified, or the resolved absolute path if it exists.
@@ -33,10 +35,10 @@ export async function executeScriptAsync(options) {
     if (await shouldDelegateToDockerAsync()) {
         OutputHelper.verbose('[StudioBridge] No Wine detected, delegating to Docker');
         await delegateToDockerAsync(options);
-        return; // unreachable — delegateToDockerAsync calls process.exit
+        throw new Error('delegateToDockerAsync returned without exiting');
     }
-    const { scriptContent, packageName, placePath, timeoutMs, verbose, showLogs, } = options;
-    const useSpinner = !!process.stdout.isTTY && !verbose;
+    const { scriptContent, packageName, placePath, timeoutMs, verbose, showLogs, quiet = false, } = options;
+    const useSpinner = !quiet && !!process.stdout.isTTY && !verbose;
     const reporter = new CompositeReporter([packageName], (state) => [
         useSpinner
             ? new SpinnerReporter(state, {
@@ -44,57 +46,77 @@ export async function executeScriptAsync(options) {
                 actionVerb: 'Running',
             })
             : new SimpleReporter(state, {
-                alwaysShowLogs: showLogs,
+                alwaysShowLogs: false,
                 successMessage: 'Script completed successfully.',
                 failureMessage: 'Script failed.',
             }),
     ]);
-    await reporter.startAsync();
-    reporter.onPackageStart(packageName);
+    if (!quiet) {
+        await reporter.startAsync();
+        reporter.onPackageStart(packageName);
+    }
     const startTime = performance.now();
     // Suppress verbose output during spinner rendering
     if (useSpinner) {
         OutputHelper.setVerbose(false);
     }
     const outputLines = [];
+    const onOutput = (level, body) => {
+        // Filter internal plugin messages that leak through LogService
+        if (body.startsWith('[StudioBridge]')) {
+            return;
+        }
+        // Collect output for the result logs
+        outputLines.push(body);
+        // In verbose/simple mode, print output in real-time
+        if (!useSpinner && !quiet) {
+            switch (level) {
+                case 'Warning':
+                    OutputHelper.warn(body);
+                    break;
+                case 'Error':
+                    OutputHelper.error(body);
+                    break;
+                default:
+                    console.log(body);
+                    break;
+            }
+        }
+    };
+    const onPhase = (phase) => {
+        if (phase === 'done' || quiet)
+            return;
+        reporter.onPackagePhaseChange(packageName, phase);
+    };
     let server;
     let result;
     try {
-        server = new StudioBridgeServer({
-            placePath,
-            timeoutMs,
-            onPhase: (phase) => {
-                if (phase === 'done')
-                    return;
-                reporter.onPackagePhaseChange(packageName, phase);
-            },
-        });
-        await server.startAsync();
-        result = await server.executeAsync({
-            scriptContent,
-            onOutput: (level, body) => {
-                // Filter internal plugin messages that leak through LogService
-                if (body.startsWith('[StudioBridge]')) {
-                    return;
-                }
-                // Collect output for the result logs
-                outputLines.push(body);
-                // In verbose/simple mode, print output in real-time
-                if (!useSpinner) {
-                    switch (level) {
-                        case 'Warning':
-                            OutputHelper.warn(body);
-                            break;
-                        case 'Error':
-                            OutputHelper.error(body);
-                            break;
-                        default:
-                            console.log(body);
-                            break;
-                    }
-                }
-            },
-        });
+        if (isPersistentPluginInstalled()) {
+            const execResult = await runInManagedStudioAsync({
+                scriptContent,
+                placePath,
+                timeoutMs,
+                onPhase,
+                args: options.args,
+            });
+            for (const entry of execResult.output) {
+                onOutput(entry.level, entry.body);
+            }
+            result = {
+                success: execResult.success,
+                logs: execResult.error ?? '',
+                returnValues: execResult.returnValues,
+            };
+        }
+        else {
+            server = new StudioBridgeServer({ placePath, timeoutMs, onPhase });
+            await server.startAsync();
+            result = await server.executeAsync({
+                scriptContent,
+                onOutput,
+                args: options.args,
+            });
+        }
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
@@ -107,13 +129,21 @@ export async function executeScriptAsync(options) {
         await server?.stopAsync();
     }
     const elapsed = performance.now() - startTime;
-    reporter.onPackageResult({
-        packageName,
+    if (!quiet) {
+        reporter.onPackageResult({
+            packageName,
+            success: result.success,
+            logs: outputLines.length > 0 ? outputLines.join('\n') : result.logs,
+            durationMs: elapsed,
+        });
+        await reporter.stopAsync();
+    }
+    return {
         success: result.success,
-        logs: outputLines.length > 0 ? outputLines.join('\n') : result.logs,
+        output: outputLines,
+        error: result.success || !result.logs ? undefined : result.logs,
+        returnValues: result.returnValues,
         durationMs: elapsed,
-    });
-    await reporter.stopAsync();
-    process.exit(result.success ? 0 : 1);
+    };
 }
 //# sourceMappingURL=script-executor.js.map

package/dist/src/cli/script-executor.js.map

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

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

@@ -5,14 +5,19 @@
  * This unifies the old `exec` and `run` commands.
  */
 import type { BridgeSession } from '../../../bridge/index.js';
+import type { SerializedReturnValue } from '../../../server/web-socket-protocol.js';
 export interface ExecOptions {
     scriptContent: string;
     timeout?: number;
+    /** Passed to the script as `...`. */
+    args?: string[];
 }
 export interface ExecResult {
     success: boolean;
     output: string[];
     error?: string;
+    traceback?: string;
+    returnValues?: SerializedReturnValue[];
     summary: string;
 }
 export interface RunOptions {
@@ -23,12 +28,15 @@ export interface RunResult {
     success: boolean;
     output: string[];
     error?: string;
+    traceback?: string;
+    returnValues?: SerializedReturnValue[];
     summary: string;
 }
 interface ConsoleExecArgs {
     code?: string;
     file?: string;
     timeout?: number;
+    scriptArgs?: string[];
 }
 /**
  * Execute inline Luau code in a connected Studio session.
@@ -38,6 +46,15 @@ export declare function execHandlerAsync(session: BridgeSession, options: ExecOp
  * 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 function formatReturnValues(returnValues: SerializedReturnValue[]): string;
+/** Render an exec result as its output, then its return values, then its error. */
+export declare function formatExecText(result: {
+    output: string[];
+    returnValues?: SerializedReturnValue[];
+    error?: string;
+    traceback?: string;
+    summary: string;
+}): string;
 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

@@ -1 +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"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../../../src/commands/console/exec/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,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,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,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;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,CAAC,CAkBpB;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,qBAAqB,EAAE,GACpC,MAAM,CAeR;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAST;AAED,eAAO,MAAM,WAAW,4FAsCtB,CAAC"}

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

@@ -5,6 +5,7 @@
  * This unifies the old `exec` and `run` commands.
  */
 import * as fs from 'fs/promises';
+import { OutputHelper } from '@quenty/cli-output-helpers';
 import { defineCommand } from '../../framework/define-command.js';
 import { arg } from '../../framework/arg-builder.js';
 import { resolveScriptContentAsync } from '../../../cli/resolve-script-content.js';
@@ -12,12 +13,14 @@ import { resolveScriptContentAsync } from '../../../cli/resolve-script-content.j
  * 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 result = await session.execAsync(options.scriptContent, options.timeout, options.args);
     const output = (result.output ?? []).map((entry) => typeof entry === 'string' ? entry : entry.body);
     return {
         success: result.success,
         output,
         error: result.error,
+        traceback: result.traceback,
+        returnValues: result.returnValues,
         summary: result.success
             ? 'Script executed successfully'
             : `Script failed: ${result.error}`,
@@ -34,17 +37,47 @@ export async function runHandlerAsync(session, options) {
         success: result.success,
         output,
         error: result.error,
+        traceback: result.traceback,
+        returnValues: result.returnValues,
         summary: result.success
             ? `Script ${options.scriptPath} executed successfully`
             : `Script ${options.scriptPath} failed: ${result.error}`,
     };
 }
+export function formatReturnValues(returnValues) {
+    return returnValues
+        .map((value) => {
+        if (typeof value === 'string')
+            return value;
+        if (typeof value === 'object' &&
+            value !== null &&
+            !Array.isArray(value) &&
+            value.type === 'Nil') {
+            return 'nil';
+        }
+        return JSON.stringify(value);
+    })
+        .join('\t');
+}
+/** Render an exec result as its output, then its return values, then its error. */
+export function formatExecText(result) {
+    const lines = [...result.output];
+    if (result.returnValues && result.returnValues.length > 0) {
+        lines.push(formatReturnValues(result.returnValues));
+    }
+    if (result.error)
+        lines.push(result.error);
+    if (result.traceback)
+        lines.push(OutputHelper.formatDim(result.traceback.trimEnd()));
+    return lines.length > 0 ? lines.join('\n') : result.summary;
+}
 export const execCommand = defineCommand({
     group: 'console',
     name: 'exec',
     description: 'Execute Luau code in a connected Studio session',
     category: 'execution',
     safety: 'mutate',
+    changesDataModel: true,
     scope: 'session',
     args: {
         code: arg.positional({
@@ -59,20 +92,19 @@ export const execCommand = defineCommand({
             description: 'Execution timeout in milliseconds',
             type: 'number',
         }),
+        scriptArgs: arg.passthrough({
+            description: 'Arguments after --, passed to the script as ... (all strings)',
+        }),
     },
     cli: {
-        format: (result) => {
-            const lines = result.output.join('\n');
-            if (result.error)
-                return lines + (lines ? '\n' : '') + result.error;
-            return lines || result.summary;
-        },
+        format: formatExecText,
     },
     handler: async (session, args) => {
         const { scriptContent } = await resolveScriptContentAsync(args);
         return execHandlerAsync(session, {
             scriptContent,
             timeout: args.timeout,
+            args: args.scriptArgs,
         });
     },
 });

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

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

@@ -2,7 +2,7 @@
  * Unit tests for the unified exec command handler.
  */
 import { describe, it, expect, vi } from 'vitest';
-import { execHandlerAsync, runHandlerAsync } from './exec.js';
+import { execCommand, execHandlerAsync, runHandlerAsync, } from './exec.js';
 // Mock fs/promises.readFile for runHandlerAsync
 vi.mock('fs/promises', () => ({
     readFile: vi.fn(),
@@ -50,7 +50,21 @@ describe('execHandlerAsync', () => {
             scriptContent: 'print("test")',
             timeout: 5000,
         });
-        expect(session.execAsync).toHaveBeenCalledWith('print("test")', 5000);
+        expect(session.execAsync).toHaveBeenCalledWith('print("test")', 5000, undefined);
+    });
+    it('forwards script args to session.execAsync', async () => {
+        const session = createMockSession({
+            success: true,
+            output: [],
+        });
+        await execHandlerAsync(session, {
+            scriptContent: 'return ...',
+            args: ['Player1', '3'],
+        });
+        expect(session.execAsync).toHaveBeenCalledWith('return ...', undefined, [
+            'Player1',
+            '3',
+        ]);
     });
     it('passes undefined timeout when not specified', async () => {
         const session = createMockSession({
@@ -60,7 +74,7 @@ describe('execHandlerAsync', () => {
         await execHandlerAsync(session, {
             scriptContent: 'print("test")',
         });
-        expect(session.execAsync).toHaveBeenCalledWith('print("test")', undefined);
+        expect(session.execAsync).toHaveBeenCalledWith('print("test")', undefined, undefined);
     });
     it('captures multiple output lines', async () => {
         const session = createMockSession({
@@ -104,6 +118,51 @@ describe('execHandlerAsync', () => {
         };
         await expect(execHandlerAsync(session, { scriptContent: 'print("test")' })).rejects.toThrow('Connection lost');
     });
+    it('carries the return values through', async () => {
+        const session = {
+            execAsync: vi.fn().mockResolvedValue({
+                success: true,
+                output: [],
+                returnValues: [12345, { type: 'Nil' }],
+            }),
+        };
+        const result = await execHandlerAsync(session, {
+            scriptContent: 'return game.PlaceId, nil',
+        });
+        expect(result.returnValues).toEqual([12345, { type: 'Nil' }]);
+    });
+});
+describe('execCommand text format', () => {
+    const format = execCommand.cli.format;
+    function formatResult(result) {
+        return format({
+            success: true,
+            output: [],
+            summary: 'Script executed successfully',
+            ...result,
+        });
+    }
+    it('prints a returned string raw so returned JSON stays parseable', () => {
+        expect(formatResult({ returnValues: ['{"ok":true}'] })).toBe('{"ok":true}');
+    });
+    it('prints output lines before the return values', () => {
+        expect(formatResult({ output: ['hello'], returnValues: [42, true] })).toBe('hello\n42\ttrue');
+    });
+    it('spells a returned nil and JSON-encodes tables and datatypes', () => {
+        expect(formatResult({
+            returnValues: [
+                { type: 'Nil' },
+                [1, 2],
+                { type: 'Vector3', value: [1, 2, 3] },
+            ],
+        })).toBe('nil\t[1,2]\t{"type":"Vector3","value":[1,2,3]}');
+    });
+    it('falls back to the summary when nothing was printed or returned', () => {
+        expect(formatResult({ returnValues: [] })).toBe('Script executed successfully');
+    });
+    it('appends the error after any output', () => {
+        expect(formatResult({ success: false, output: ['before'], error: 'boom' })).toBe('before\nboom');
+    });
 });
 describe('runHandlerAsync', () => {
     it('reads file and delegates to session.execAsync', async () => {

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

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

@@ -2,13 +2,16 @@
  * `console logs` — retrieve buffered log history from a connected
  * Studio session's ring buffer.
  */
-import type { BridgeSession } from '../../../bridge/index.js';
+import type { BridgeConnection, BridgeSession } from '../../../bridge/index.js';
 import type { LogEntry } from '../../../bridge/index.js';
 import type { OutputLevel } from '../../../server/web-socket-protocol.js';
 export interface LogsResult {
+    /** With repeats grouped, a run of identical entries is one with `repeats` and `lastTimestamp`. */
     entries: LogEntry[];
     total: number;
     bufferCapacity: number;
+    /** The cutoff `--since` or `--since-restart` applied, in epoch seconds. */
+    since?: number;
     summary: string;
 }
 export interface LogsOptions {
@@ -16,8 +19,33 @@ export interface LogsOptions {
     direction?: 'head' | 'tail';
     levels?: OutputLevel[];
     includeInternal?: boolean;
+    /** Only entries logged at or after this time, in epoch seconds. */
+    since?: number;
+    /** Collapse identical consecutive entries. Defaults to true. */
+    groupRepeats?: boolean;
 }
+interface ConsoleLogsArgs {
+    count?: number;
+    direction?: 'head' | 'tail';
+    levels?: OutputLevel[];
+    includeInternal?: boolean;
+    since?: string;
+    sinceRestart?: boolean;
+    groupRepeats?: boolean;
+}
+/**
+ * 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 declare function parseSince(value: string, nowMs?: number): number;
+/**
+ * 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 declare function getSinceRestartCutoffAsync(connection: BridgeConnection, session: BridgeSession): Promise<number | undefined>;
 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>;
+export declare const logsCommand: import("../../framework/define-command.js").CommandDefinition<ConsoleLogsArgs, LogsResult>;
+export {};
 //# sourceMappingURL=logs.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../../../src/commands/console/logs/logs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EACV,QAAQ,EAET,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,kGAAkG;IAClG,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,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;IAC1B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,UAAU,eAAe;IACvB,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;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AASD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM,CAa5E;AAOD;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4B7B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAaD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAezD;AAED,eAAO,MAAM,WAAW,4FA6DtB,CAAC"}