@dcl/sdk-commands 7.31.1-40962203448.commit-c68a75f → 7.31.1-41498712919.commit-5e4cada

package/dist/commands/scene-insights/format.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripControlCharacters = stripControlCharacters;
+exports.formatTimestamp = formatTimestamp;
+exports.formatLogEntry = formatLogEntry;
+exports.formatValue = formatValue;
+exports.sparkline = sparkline;
+exports.formatTable = formatTable;
+exports.formatMetricNames = formatMetricNames;
+exports.formatMetricSeries = formatMetricSeries;
+exports.formatExecutions = formatExecutions;
+const log_1 = require("../../components/log");
+const SPARK = '▁▂▃▄▅▆▇█';
+const identity = (text) => String(text);
+/** C0 and C1 control characters except tab and newline: escape sequences a terminal would act on. */
+const CONTROL_CHARACTERS = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f]/g;
+/** Removes what a terminal would interpret (cursor moves, OSC 8 links, OSC 52 clipboard writes) from service text. */
+function stripControlCharacters(text) {
+    return text.replace(CONTROL_CHARACTERS, '');
+}
+/** `2026-10-12T14:13:02.166Z` → `2026-10-12 14:13:02.166Z`; anything unparseable is returned as is. */
+function formatTimestamp(iso) {
+    const time = Date.parse(iso);
+    return Number.isNaN(time) ? iso : new Date(time).toISOString().replace('T', ' ');
+}
+/**
+ * One log entry as terminal text: time, level, the source when it is not the scene itself, and the
+ * message, with the lines of a multi-line message indented under the first.
+ */
+function formatLogEntry(entry, color) {
+    const paint = {
+        error: color ? log_1.colors.redBright : identity,
+        warn: color ? log_1.colors.yellow : identity,
+        info: identity,
+        debug: color ? log_1.colors.dim : identity
+    }[entry.level] ?? identity;
+    const dim = color ? log_1.colors.dim : identity;
+    const time = stripControlCharacters(formatTimestamp(entry.timestamp));
+    const level = stripControlCharacters(entry.level.toUpperCase()).padEnd(5);
+    const source = entry.source === 'scene' ? '' : `[${stripControlCharacters(entry.source)}] `;
+    const prefix = `${time} ${level} `;
+    const message = stripControlCharacters(entry.message)
+        .split('\n')
+        .join('\n' + ' '.repeat(prefix.length));
+    const truncated = entry.truncated ? dim(' … (truncated)') : '';
+    return `${dim(time)} ${paint(level)} ${dim(source)}${paint(message)}${truncated}`;
+}
+/** A value in its unit: bytes in binary multiples, milliseconds up to seconds, counts as numbers. */
+function formatValue(value, unit) {
+    if (value === null || !Number.isFinite(value))
+        return '-';
+    const round = (n) => (Math.abs(n) >= 100 ? n.toFixed(0) : Math.abs(n) >= 10 ? n.toFixed(1) : n.toFixed(2));
+    const base = unit.split('/')[0];
+    const per = unit.includes('/') ? `/${unit.split('/')[1]}` : '';
+    if (base === 'bytes') {
+        const units = ['B', 'KiB', 'MiB', 'GiB', 'TiB'];
+        let scaled = value;
+        let index = 0;
+        while (Math.abs(scaled) >= 1024 && index < units.length - 1) {
+            scaled /= 1024;
+            index++;
+        }
+        return `${index === 0 ? Math.round(scaled) : round(scaled)} ${units[index]}${per}`;
+    }
+    if (base === 'ms') {
+        return Math.abs(value) >= 1000 ? `${round(value / 1000)} s${per}` : `${round(value)} ms${per}`;
+    }
+    return `${Number.isInteger(value) ? value : round(value)}${per}`;
+}
+/** A one-line chart of the values; gaps are blanks. */
+function sparkline(values) {
+    const present = values.filter((v) => v !== null && Number.isFinite(v));
+    if (present.length === 0)
+        return '';
+    const min = Math.min(...present);
+    const max = Math.max(...present);
+    return values
+        .map((v) => {
+        if (v === null || !Number.isFinite(v))
+            return ' ';
+        if (max === min)
+            return SPARK[0];
+        return SPARK[Math.round(((v - min) / (max - min)) * (SPARK.length - 1))];
+    })
+        .join('');
+}
+/** Left-aligned columns separated by two spaces. */
+function formatTable(header, rawRows) {
+    const rows = rawRows.map((row) => row.map(stripControlCharacters));
+    const widths = header.map((title, column) => Math.max(title.length, ...rows.map((row) => row[column].length)));
+    const line = (cells) => cells
+        .map((cell, column) => (column === cells.length - 1 ? cell : cell.padEnd(widths[column])))
+        .join('  ')
+        .trimEnd();
+    return [line(header), ...rows.map(line)];
+}
+function formatMetricNames(result) {
+    if (result.metrics.length === 0) {
+        return [stripControlCharacters(`No metrics for ${result.sceneKey} between ${result.from} and ${result.to}`)];
+    }
+    return formatTable(['METRIC', 'TYPE', 'UNIT'], result.metrics.map((metric) => [metric.name, metric.type, metric.unit]));
+}
+/**
+ * A metric series: a header, a sparkline, and one row per bucket. Gauges show the average and the
+ * maximum; sums show the bucket total and its rate per second.
+ */
+function formatMetricSeries(series) {
+    const head = stripControlCharacters(`${series.metric} (${series.type ?? 'no data'}, ${series.unit}) every ${series.stepSeconds}s, ${formatTimestamp(series.from)} → ${formatTimestamp(series.to)}`);
+    if (series.type === null || series.points.length === 0) {
+        return [head, 'No data in this range'];
+    }
+    if (series.type === 'gauge') {
+        const points = series.points;
+        return [
+            head,
+            `avg ${sparkline(points.map((p) => p.avg))}`,
+            '',
+            ...formatTable(['TIME', 'AVG', 'MAX'], points.map((p) => [formatTimestamp(p.t), formatValue(p.avg, series.unit), formatValue(p.max, series.unit)]))
+        ];
+    }
+    const points = series.points;
+    const rateUnit = series.rateUnit ?? `${series.unit}/s`;
+    return [
+        head,
+        `sum ${sparkline(points.map((p) => p.sum))}`,
+        '',
+        ...formatTable(['TIME', 'SUM', 'RATE'], points.map((p) => [formatTimestamp(p.t), formatValue(p.sum, series.unit), formatValue(p.rate, rateUnit)]))
+    ];
+}
+function formatExecutions(result) {
+    if (result.executions.length === 0) {
+        return [stripControlCharacters(`No executions of ${result.sceneKey} in this range`)];
+    }
+    return formatTable(['EXECUTION', 'ENTITY', 'FIRST SEEN', 'LAST SEEN', 'LINES', 'INSTANCE'], result.executions.map((execution) => [
+        execution.executionId,
+        execution.entityId,
+        formatTimestamp(execution.firstSeen),
+        formatTimestamp(execution.lastSeen),
+        String(execution.logLines),
+        execution.instanceId || '-'
+    ]));
+}
+//# sourceMappingURL=format.js.map

package/dist/commands/scene-insights/format.js.map

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

package/dist/commands/scene-insights/index.d.ts

@@ -0,0 +1,51 @@
+import { Result } from 'arg';
+import { CliComponents } from '../../components';
+import { CliErrorName } from '../../logic/error';
+interface Options {
+    args: Result<typeof args>;
+    components: CliComponents;
+}
+export declare const args: {
+    '--help': BooleanConstructor;
+    '-h': string;
+    '--dir': StringConstructor;
+    '--world': StringConstructor;
+    '-w': string;
+    '--position': StringConstructor;
+    '--target': StringConstructor;
+    '-t': string;
+    '--trust-target': BooleanConstructor;
+    '--port': NumberConstructor;
+    '-p': string;
+    '--https': BooleanConstructor;
+    '--no-browser': BooleanConstructor;
+    '-b': string;
+    '--from': StringConstructor;
+    '--to': StringConstructor;
+    '--level': StringConstructor;
+    '-l': string;
+    '--source': StringConstructor;
+    '--query': StringConstructor;
+    '-q': string;
+    '--execution': StringConstructor;
+    '--limit': NumberConstructor;
+    '-n': string;
+    '--order': StringConstructor;
+    '--lines': NumberConstructor;
+    '--for': StringConstructor;
+    '--step': NumberConstructor;
+    '--json': BooleanConstructor;
+};
+/**
+ * Exit codes, so a script or an agent can tell what to do next without parsing messages:
+ * 2 fix the arguments, 3 have a person sign in, 4 use an address with access, 5 check the scene,
+ * 6 try again later. Anything else exits with 1.
+ */
+export declare const EXIT_CODES: Partial<Record<CliErrorName, number>>;
+export declare function help(options: Options): void;
+/**
+ * Runs a subcommand. With --json it returns the result for the CLI to print as JSON (the tail
+ * streams its own JSON lines and returns nothing), and an error is written as JSON on stderr.
+ */
+export declare function main(options: Options): Promise<unknown>;
+export {};

package/dist/commands/scene-insights/index.js

@@ -0,0 +1,315 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXIT_CODES = exports.args = void 0;
+exports.help = help;
+exports.main = main;
+const path_1 = require("path");
+const args_1 = require("../../logic/args");
+const error_1 = require("../../logic/error");
+const account_1 = require("../../logic/account");
+const workspace_validations_1 = require("../../logic/workspace-validations");
+const scene_validations_1 = require("../../logic/scene-validations");
+const actions_1 = require("./actions");
+const client_1 = require("./client");
+const inputs_1 = require("./inputs");
+const session_store_1 = require("./session-store");
+const sign_in_1 = require("./sign-in");
+const signature_validation_1 = require("./signature-validation");
+exports.args = (0, args_1.declareArgs)({
+    '--help': Boolean,
+    '-h': '--help',
+    '--dir': String,
+    '--world': String,
+    '-w': '--world',
+    '--position': String,
+    '--target': String,
+    '-t': '--target',
+    '--trust-target': Boolean,
+    '--port': Number,
+    '-p': '--port',
+    '--https': Boolean,
+    '--no-browser': Boolean,
+    '-b': '--no-browser',
+    '--from': String,
+    '--to': String,
+    '--level': String,
+    '-l': '--level',
+    '--source': String,
+    '--query': String,
+    '-q': '--query',
+    '--execution': String,
+    '--limit': Number,
+    '-n': '--limit',
+    '--order': String,
+    '--lines': Number,
+    '--for': String,
+    '--step': Number,
+    '--json': Boolean
+});
+const DEFAULT_SERVER = 'https://multiplayer-scenes-insights-service.decentraland.org';
+const QUERY_SUBCOMMANDS = ['logs', 'tail', 'metrics', 'executions'];
+const SESSION_SUBCOMMANDS = ['login', 'logout', 'session'];
+const TARGET_FLAGS = ['--target', '--trust-target'];
+const SIGN_IN_FLAGS = ['--port', '--no-browser', '--https'];
+const SCENE_FLAGS = [...TARGET_FLAGS, ...SIGN_IN_FLAGS, '--world', '--position', '--dir'];
+/** The flags each subcommand reads, besides --help and --json; any other is refused rather than ignored. */
+const FLAGS_BY_SUBCOMMAND = {
+    login: [...TARGET_FLAGS, ...SIGN_IN_FLAGS],
+    logout: [],
+    session: [...TARGET_FLAGS],
+    logs: [...SCENE_FLAGS, '--from', '--to', '--level', '--source', '--query', '--execution', '--limit', '--order'],
+    tail: [...SCENE_FLAGS, '--for', '--lines', '--level', '--query'],
+    metrics: [...SCENE_FLAGS, '--from', '--to', '--step', '--execution'],
+    executions: [...SCENE_FLAGS, '--from', '--to']
+};
+/**
+ * Exit codes, so a script or an agent can tell what to do next without parsing messages:
+ * 2 fix the arguments, 3 have a person sign in, 4 use an address with access, 5 check the scene,
+ * 6 try again later. Anything else exits with 1.
+ */
+exports.EXIT_CODES = {
+    SCENE_INSIGHTS_INVALID_ARGUMENT: 2,
+    SCENE_INSIGHTS_MISSING_SCENE: 2,
+    SCENE_INSIGHTS_UNSAFE_SESSION_FILE: 2,
+    SCENE_INSIGHTS_SESSION_REQUIRED: 3,
+    SCENE_INSIGHTS_UNAUTHORIZED: 3,
+    SCENE_INSIGHTS_INVALID_SIGNATURE: 3,
+    SCENE_INSIGHTS_UNSUPPORTED_WALLET: 3,
+    SCENE_INSIGHTS_FORBIDDEN: 4,
+    SCENE_INSIGHTS_NOT_FOUND: 5,
+    SCENE_INSIGHTS_UNAVAILABLE: 6
+};
+function help(options) {
+    options.components.logger.log(`
+  Usage: 'sdk-commands scene-insights <subcommand> [options]'
+    Reads the persisted logs and metrics of an authoritative multiplayer scene (kept for 7 days)
+    from multiplayer-scenes-insights-service. The signed-in address must be in the scene's
+    logsPermissions, or be the World's owner or a deployer.
+
+    Sign in once with "login": it opens the browser for your wallet to sign, and the session is
+    saved for 12 hours in ${(0, session_store_1.getSessionFilePath)()} (or in the .dcl folder of ${session_store_1.SESSION_DIR_ENV}).
+    Until it expires it can sign Decentraland requests as your address; "logout" removes it.
+    The .dcl folder is never deployed and ignores itself in git, so the session is never published.
+    With DCL_PRIVATE_KEY set, requests are signed with that key and nothing is saved.
+    Contract wallets use Ethereum RPC: Mainnet for .org, Sepolia for .zone. Use the same --target
+    for login, session and reads. Set DCL_SCENE_INSIGHTS_RPC_URL for a custom target's network.
+    Without a terminal (scripts, AI agents) a missing session is an error, never a browser prompt.
+
+    Runs from any directory with --world and/or --position; otherwise reads scene.json
+    (worldConfiguration.name and scene.base).
+
+    Subcommands:
+      login                     Sign in (always asks for a new signature)
+      session                   Show the signed-in address and when the session expires
+      logout                    Remove the saved session
+      logs                      Search the logs; prints the newest --limit lines, oldest first
+      tail                      Follow new log lines live (reconnects and resumes on its own)
+      metrics [name]            List the metrics with data, or chart one (cpu.run_ms is short
+                                for dcl.scene.cpu.run_ms)
+      executions                List the scene's executions (deployments and restarts)
+
+    Scene:
+      -w, --world       [name]  World name (myworld, myworld.dcl.eth or any ENS name)
+      --position        [x,y]   A parcel of the scene: Genesis City, or one scene of a multi-scene
+                                World (use the =value form for negative coordinates)
+      --dir             [path]  Project directory for the scene.json fallback
+
+    Time range (logs, metrics, executions):
+      --from            [time]  Start: a duration back from now (15m, 2h, 7d), epoch ms, or
+                                ISO-8601 with an offset. Default: 1 hour ago (24 hours for
+                                metric names and executions)
+      --to              [time]  End, same formats. Default: now
+
+    logs:
+      -l, --level       [level] Minimum level: debug, info, warn or error
+      -q, --query       [text]  Literal text to match (case-insensitive)
+      --source          [list]  Comma-separated sources: scene, engine, stderr
+      --execution       [id]    Only this execution (see "executions")
+      -n, --limit       [n]     Lines to print, 1-10000 (default 100)
+      --order           [order] desc (default) prints the newest lines, asc the oldest
+
+    tail:
+      --for             [time]  Stop after this long (30s, 5m, at most 24d); default: until CTRL+C
+      --lines           [n]     Replay the newest n lines first, 0-1000 (default 0)
+      -l, --level, -q, --query  Filter the followed lines
+
+    metrics:
+      --step            [s]     Bucket width in seconds, 10-86400 (default: ~300 buckets)
+      --execution       [id]    Only this execution
+
+    Other options:
+      --json                    Print JSON to stdout (one object per log line), and errors as
+                                {"error":{"code","message","exitCode"}} on stderr
+      -t, --target      [URL]   Insights service URL (default: ${DEFAULT_SERVER}); only
+                                https hosts under decentraland.org or decentraland.zone
+      --trust-target            Allow any --target. It receives signed requests it could replay
+      -p, --port        [port]  Select a custom port for the linker dApp
+      -b, --no-browser          Do not open a new browser window
+      --https                   Use HTTPS for the linker dApp
+      -h, --help                Displays complete help
+
+    Exit codes:
+      0 success, 1 other failure, 2 invalid arguments, 3 sign-in needed (run login),
+      4 the address has no access to the scene, 5 scene not found, 6 service unavailable
+
+    Examples:
+    - Sign in, then read the errors of the last 6 hours of the World in scene.json:
+      $ sdk-commands scene-insights login
+      $ sdk-commands scene-insights logs --from 6h --level error
+
+    - Search a World from any directory:
+      $ sdk-commands scene-insights logs --world myworld --query "player joined" --limit 500
+
+    - Follow a Genesis City scene for 2 minutes, replaying the last 50 lines:
+      $ sdk-commands scene-insights tail --position=-125,-96 --lines 50 --for 2m
+
+    - Chart heap usage over the last day, one point per 10 minutes:
+      $ sdk-commands scene-insights metrics mem.heap_used --from 1d --step 600
+
+    - Use the development (.zone) service, signing with a private key:
+      $ DCL_PRIVATE_KEY=0x... sdk-commands scene-insights executions --world myworld \\
+          --target https://multiplayer-scenes-insights-service.decentraland.zone
+`);
+}
+/** Resolves the scene from --world/--position, falling back to scene.json. */
+async function resolveTarget(options) {
+    const worldArg = options.args['--world'];
+    const positionArg = options.args['--position'];
+    if (worldArg || positionArg) {
+        return (0, inputs_1.buildSceneTarget)(worldArg ? (0, inputs_1.normalizeWorldName)(worldArg) : undefined, positionArg ? (0, inputs_1.normalizeParcel)(positionArg) : undefined);
+    }
+    const projectRoot = (0, path_1.resolve)(process.cwd(), options.args['--dir'] || '.');
+    await (0, workspace_validations_1.getValidWorkspace)(options.components, projectRoot);
+    const sceneJson = await (0, scene_validations_1.getValidSceneJson)(options.components, projectRoot);
+    const world = sceneJson.worldConfiguration?.name;
+    const base = sceneJson.scene?.base;
+    return (0, inputs_1.buildSceneTarget)(world ? (0, inputs_1.normalizeWorldName)(world) : undefined, base ? (0, inputs_1.normalizeParcel)(base) : undefined);
+}
+/**
+ * Runs a subcommand. With --json it returns the result for the CLI to print as JSON (the tail
+ * streams its own JSON lines and returns nothing), and an error is written as JSON on stderr.
+ */
+async function main(options) {
+    const json = !!options.args['--json'];
+    try {
+        return await run(options);
+    }
+    catch (error) {
+        if (!(error instanceof error_1.CliError))
+            throw error;
+        process.exitCode = exports.EXIT_CODES[error.name] ?? 1;
+        if (!json)
+            throw error;
+        process.stderr.write(JSON.stringify({ error: { code: error.name, message: error.message, exitCode: process.exitCode } }) + '\n');
+    }
+}
+async function run(options) {
+    const { components } = options;
+    const a = options.args;
+    const [subcommand, ...positionals] = a._.filter((arg) => !arg.startsWith('-'));
+    if (!subcommand || ![...QUERY_SUBCOMMANDS, ...SESSION_SUBCOMMANDS].includes(subcommand)) {
+        throw new error_1.CliError('SCENE_INSIGHTS_INVALID_ARGUMENT', `${subcommand ? `Unknown subcommand "${subcommand}"` : 'Missing subcommand'}. Use: ` +
+            `${[...SESSION_SUBCOMMANDS, ...QUERY_SUBCOMMANDS].join(', ')}\n` +
+            'Run "sdk-commands scene-insights --help" for more information.');
+    }
+    const maxPositionals = subcommand === 'metrics' ? 1 : 0;
+    if (positionals.length > maxPositionals) {
+        throw new error_1.CliError('SCENE_INSIGHTS_INVALID_ARGUMENT', `Unexpected argument "${positionals[maxPositionals]}" for ${subcommand}`);
+    }
+    const allowed = new Set(['--help', '--json', ...FLAGS_BY_SUBCOMMAND[subcommand]]);
+    const unused = Object.keys(a).filter((flag) => flag !== '_' && !allowed.has(flag));
+    if (unused.length > 0) {
+        throw new error_1.CliError('SCENE_INSIGHTS_INVALID_ARGUMENT', `${unused.join(', ')} ${unused.length === 1 ? 'does' : 'do'} not apply to ${subcommand}`);
+    }
+    const [positional] = positionals;
+    const baseUrl = a['--target'] ? (0, inputs_1.parseTarget)(a['--target'], !!a['--trust-target']) : DEFAULT_SERVER;
+    const file = (0, session_store_1.getSessionFilePath)();
+    const write = (line) => process.stdout.write(line + '\n');
+    const sessionOptions = {
+        file,
+        targetUrl: baseUrl,
+        linkOptions: { linkerPort: a['--port'], openBrowser: !a['--no-browser'], isHttps: !!a['--https'] },
+        interactive: !!process.stdin.isTTY
+    };
+    if (subcommand === 'logout') {
+        const removed = await (0, session_store_1.deleteSession)(components, file);
+        components.logger.info(removed ? `Signed out; removed ${file}` : 'There was no saved session');
+        return { removed, file };
+    }
+    if (subcommand === 'session') {
+        if (process.env.DCL_PRIVATE_KEY) {
+            const { address } = (0, account_1.createWallet)(process.env.DCL_PRIVATE_KEY);
+            if (!a['--json'])
+                write(`Signing as ${address} with DCL_PRIVATE_KEY`);
+            return { address, expiration: null, source: 'DCL_PRIVATE_KEY' };
+        }
+        const saved = await (0, session_store_1.loadSession)(components, file, Date.now(), (0, signature_validation_1.createInsightsProvider)(baseUrl));
+        if (!saved) {
+            throw new error_1.CliError('SCENE_INSIGHTS_SESSION_REQUIRED', 'Not signed in; run "sdk-commands scene-insights login"');
+        }
+        const { address, expiration } = saved.session;
+        if (!a['--json'])
+            write(`Signed in as ${address} until ${expiration.toISOString()} (${file})`);
+        return { address, expiration: expiration.toISOString(), source: file };
+    }
+    if (subcommand === 'login') {
+        const { session, source } = await (0, sign_in_1.getSession)(components, { label: 'scene insights' }, { ...sessionOptions, interactive: true, forceNew: true });
+        if (source === 'private-key') {
+            components.logger.info(`DCL_PRIVATE_KEY is set: requests are signed as ${session.address}, nothing to save`);
+            return { address: session.address, expiration: null, source: 'DCL_PRIVATE_KEY' };
+        }
+        components.logger.info(`Signed in as ${session.address} until ${session.expiration.toISOString()}; saved to ${file}`);
+        return { address: session.address, expiration: session.expiration.toISOString(), source: file };
+    }
+    // validate every flag before resolving the scene or signing
+    const from = a['--from'] ? (0, inputs_1.parseTime)(a['--from'], '--from') : undefined;
+    const to = a['--to'] ? (0, inputs_1.parseTime)(a['--to'], '--to') : undefined;
+    const level = a['--level'] ? (0, inputs_1.parseLevel)(a['--level']) : undefined;
+    const order = a['--order'] ?? 'desc';
+    if (order !== 'asc' && order !== 'desc') {
+        throw new error_1.CliError('SCENE_INSIGHTS_INVALID_ARGUMENT', '--order must be asc or desc');
+    }
+    const limit = (0, inputs_1.parseInteger)(a['--limit'] ?? 100, '--limit', 1, 10000);
+    const lines = a['--lines'] !== undefined ? (0, inputs_1.parseInteger)(a['--lines'], '--lines', 0, 1000) : undefined;
+    const followFor = a['--for'] !== undefined ? (0, inputs_1.parseDuration)(a['--for'], '--for') : undefined;
+    const step = a['--step'] !== undefined ? (0, inputs_1.parseInteger)(a['--step'], '--step', 10, 86400) : undefined;
+    const query = a['--query'];
+    if (query !== undefined && (query.length < 1 || query.length > 256)) {
+        throw new error_1.CliError('SCENE_INSIGHTS_INVALID_ARGUMENT', '--query must be 1 to 256 characters');
+    }
+    const metric = positional ? (0, inputs_1.normalizeMetricName)(positional) : undefined;
+    const target = await resolveTarget(options);
+    components.logger.info(`Scene insights for ${target.label} (${baseUrl})`);
+    const { session } = await (0, sign_in_1.getSession)(components, target, sessionOptions);
+    components.logger.info(`Signed in as ${session.address}`);
+    const client = (0, client_1.createInsightsClient)(components, baseUrl, session, target.metadata);
+    const output = {
+        write,
+        note: (message) => components.logger.info(message),
+        json: !!a['--json'],
+        color: !!process.stdout.isTTY && !process.env.NO_COLOR && process.env.FORCE_COLOR !== '0'
+    };
+    const common = { from, to };
+    switch (subcommand) {
+        case 'logs':
+            return (0, actions_1.runLogs)(client, { ...common, level, source: a['--source'], query, execution: a['--execution'], limit, order }, output);
+        case 'tail': {
+            const controller = new AbortController();
+            const stop = () => controller.abort();
+            process.on('SIGINT', stop);
+            const timer = followFor !== undefined ? setTimeout(stop, followFor) : undefined;
+            try {
+                return await (0, actions_1.runTail)(client, { lines, level, query, signal: controller.signal }, output);
+            }
+            finally {
+                clearTimeout(timer);
+                process.off('SIGINT', stop);
+            }
+        }
+        case 'metrics':
+            return (0, actions_1.runMetrics)(client, { ...common, metric, step, execution: a['--execution'] }, output);
+        case 'executions':
+            return (0, actions_1.runExecutions)(client, common, output);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/scene-insights/index.js.map

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

package/dist/commands/scene-insights/inputs.d.ts

@@ -0,0 +1,49 @@
+/** The scene a request targets, as the insights service reads it from the signed metadata. */
+export interface SceneTarget {
+    /** Human-readable description, for the terminal and the linker dApp */
+    label: string;
+    /** Signed `x-identity-metadata` JSON */
+    metadata: string;
+    /** World name sent as `sceneId`, when the scene is in a World */
+    world?: string;
+    /** Parcel sent as `parcel`, when one was given or read from scene.json */
+    parcel?: string;
+}
+export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+/**
+ * Normalizes a World name the way creators type it: `foo`, `foo.dcl.eth` or any other ENS name
+ * (`foo.eth`). Names without an `.eth` suffix are DCL names.
+ */
+export declare function normalizeWorldName(raw: string): string;
+/** Normalizes `x,y` parcel coordinates (spaces and leading zeros removed). */
+export declare function normalizeParcel(raw: string): string;
+/**
+ * Builds the scene target. A World is addressed by name (`sceneId`), plus the parcel of one of its
+ * scenes when it has several; a Genesis City scene by any of its parcels.
+ */
+export declare function buildSceneTarget(world: string | undefined, parcel: string | undefined): SceneTarget;
+/**
+ * Parses a `--from`/`--to` value into the ISO-8601 form the service expects. Accepts `now`, a
+ * duration back from now (`30s`, `15m`, `2h`, `7d`), epoch milliseconds (13 digits) or ISO-8601
+ * with an explicit offset (`2026-10-01T12:00:00Z`, `2026-10-01T09:00:00-03:00`). A duration of 7
+ * days or more means the whole retention window, ending a minute short of it.
+ */
+export declare function parseTime(raw: string, flag: string, now?: number): string;
+/** Parses a duration (`30s`, `5m`, `2h`, `1d`, up to 24 days) into milliseconds. */
+export declare function parseDuration(raw: string, flag: string): number;
+/**
+ * Validates a `--target` URL. Without `trustAny`, only https Decentraland hosts are accepted: the
+ * signed headers don't name the host, so another server receiving them could replay them.
+ */
+export declare function parseTarget(raw: string, trustAny: boolean): string;
+/** Validates a `--level` value. */
+export declare function parseLevel(raw: string): LogLevel;
+/** Validates an integer flag inside [min, max]. */
+export declare function parseInteger(value: number, flag: string, min: number, max: number): number;
+/**
+ * Expands a metric name, so `cpu.run_ms` can be typed for `dcl.scene.cpu.run_ms`.
+ *
+ * @throws {CliError} SCENE_INSIGHTS_INVALID_ARGUMENT when the result is not `dcl.scene.<group>.<field>`
+ */
+export declare function normalizeMetricName(raw: string): string;