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

package/README.md

@@ -105,3 +105,36 @@ make sync-deps
 For detailed documentation on using the CLI tools, visit:
 
 - [CLI Documentation](https://docs.decentraland.org/creator/development-guide/sdk7/cli/)
+
+### Scene Insights scoped sessions
+
+`scene-insights login` requests a 12-hour scoped login with only `insights:logs-read`,
+`insights:metrics-read`, and `insights:executions-read`. Browser and `DCL_PRIVATE_KEY`
+sessions use these same explicit grants. They cover scenes the wallet already has
+permission to read; the credential is not restricted to a single scene. No wildcard
+or write operation is granted. Environments sharing the `insights` service identifier
+(including `.org` and `.zone`) accept the same credential when the wallet signatures
+verify on the selected network. The signed headers don't
+name the host, so `--target` only accepts https hosts under `decentraland.org` or
+`decentraland.zone` unless `--trust-target` is passed.
+
+Previously saved full-login sessions require signing in again. A saved scoped
+session expires no later than its parent delegation. Deploy the scoped-login
+Insights server before using this command version.
+
+Smart-contract wallets can sign through the browser linker. Contract signatures are
+validated via Ethereum RPC during login and whenever a saved session is loaded.
+The target selects Mainnet for `.org` and Sepolia for `.zone`; pass the same
+`--target` to `login`, `session`, and read commands. For a custom target, set
+`DCL_SCENE_INSIGHTS_RPC_URL` to its trusted Ethereum RPC endpoint. The endpoint is
+local configuration, never taken from the wallet response, and is ignored for
+`.org`/`.zone` targets so their network mapping stays fixed. Normal EOA sessions
+remain offline during local validation.
+
+Deploy the Insights server with `ETH_RPC_URL` before releasing this CLI version.
+The server independently verifies every request against its configured network,
+read-operation grants, and scene permissions. RPC outages return exit 6, including during browser login, without
+removing the saved session or requesting another login. A new browser delegation is
+validated once, then saved with its validated expiration. Invalid or revoked saved
+sessions, including ones that exceed the RPC-call budget, require a new login. Validation is limited to
+10 chain links, 16 RPC calls and 15 seconds; each RPC request has a 5-second timeout.

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

@@ -0,0 +1,63 @@
+import { InsightsClient } from './client';
+import { LogLevel } from './inputs';
+import { ExecutionsResult, LogEntry, MetricNamesResult, MetricSeries } from './types';
+/**
+ * Where results go: text to `write` (stdout), notes about it to `note` (stderr). With `json`, a
+ * subcommand prints no text and returns its result instead, which the CLI prints as JSON (the
+ * `--json` convention of every sdk-commands command); only the tail, a stream, writes its own
+ * JSON, one entry per line.
+ */
+export interface Output {
+    write(line: string): void;
+    note(message: string): void;
+    json: boolean;
+    color: boolean;
+}
+export interface LogsResult {
+    sceneKey: string;
+    /** Oldest first */
+    logs: LogEntry[];
+    /** Whether more lines matched than were returned */
+    more: boolean;
+}
+export interface LogsParams {
+    from?: string;
+    to?: string;
+    level?: LogLevel;
+    source?: string;
+    query?: string;
+    execution?: string;
+    /** Lines to print in total, across pages */
+    limit: number;
+    /** `desc` prints the newest `limit` lines, `asc` the oldest */
+    order: 'asc' | 'desc';
+}
+/**
+ * Searches the persisted logs, paging until `limit` lines, and prints them oldest first.
+ */
+export declare function runLogs(client: InsightsClient, params: LogsParams, output: Output): Promise<LogsResult>;
+export interface TailParams {
+    /** Replay the newest N lines before following */
+    lines?: number;
+    /** Only print lines at this level or above */
+    level?: LogLevel;
+    /** Only print lines containing this text (case-insensitive) */
+    query?: string;
+    signal?: AbortSignal;
+}
+/** Whether an entry passes the tail's local filters (the tail endpoint has none of its own). */
+export declare function matchesTailFilters(entry: LogEntry, params: Pick<TailParams, 'level' | 'query'>): boolean;
+/** Follows the live tail until interrupted or `signal` aborts. */
+export declare function runTail(client: InsightsClient, params: TailParams, output: Output): Promise<void>;
+export interface MetricsParams {
+    /** A full metric name; without it the metrics with data are listed */
+    metric?: string;
+    from?: string;
+    to?: string;
+    step?: number;
+    execution?: string;
+}
+/** Lists the scene's metrics, or prints one metric's series. */
+export declare function runMetrics(client: InsightsClient, params: MetricsParams, output: Output): Promise<MetricNamesResult | MetricSeries>;
+/** Lists the scene's executions (deployments × process restarts). */
+export declare function runExecutions(client: InsightsClient, params: Pick<MetricsParams, 'from' | 'to'>, output: Output): Promise<ExecutionsResult>;

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

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLogs = runLogs;
+exports.matchesTailFilters = matchesTailFilters;
+exports.runTail = runTail;
+exports.runMetrics = runMetrics;
+exports.runExecutions = runExecutions;
+const format_1 = require("./format");
+const inputs_1 = require("./inputs");
+/** The service's page size cap. */
+const MAX_PAGE = 1000;
+/**
+ * Searches the persisted logs, paging until `limit` lines, and prints them oldest first.
+ */
+async function runLogs(client, params, output) {
+    const entries = [];
+    let cursor;
+    let more = false;
+    let sceneKey = '';
+    do {
+        const page = await client.searchLogs({
+            from: params.from,
+            to: params.to,
+            level: params.level,
+            source: params.source,
+            q: params.query,
+            execution: params.execution,
+            order: params.order,
+            limit: Math.min(MAX_PAGE, params.limit - entries.length),
+            cursor
+        });
+        sceneKey = page.sceneKey;
+        entries.push(...page.logs);
+        // an empty page with a cursor would otherwise be requested forever
+        cursor = page.logs.length > 0 ? (page.nextCursor ?? undefined) : undefined;
+        more = !!cursor;
+    } while (cursor && entries.length < params.limit);
+    const result = { sceneKey, logs: params.order === 'desc' ? entries.reverse() : entries, more };
+    if (output.json)
+        return result;
+    for (const entry of result.logs) {
+        output.write((0, format_1.formatLogEntry)(entry, output.color));
+    }
+    if (entries.length === 0) {
+        output.note('No log lines match');
+    }
+    else if (more) {
+        output.note(`Printed ${entries.length} lines; more match. Raise --limit or narrow --from/--to, --level or --query to see them.`);
+    }
+    return result;
+}
+/** Whether an entry passes the tail's local filters (the tail endpoint has none of its own). */
+function matchesTailFilters(entry, params) {
+    if (params.level && inputs_1.LOG_LEVELS.indexOf(entry.level) < inputs_1.LOG_LEVELS.indexOf(params.level)) {
+        return false;
+    }
+    if (params.query && !entry.message.toLowerCase().includes(params.query.toLowerCase())) {
+        return false;
+    }
+    return true;
+}
+/** Follows the live tail until interrupted or `signal` aborts. */
+async function runTail(client, params, output) {
+    output.note('Following the scene logs');
+    await client.tail({
+        lines: params.lines,
+        signal: params.signal,
+        onLog(entry) {
+            if (matchesTailFilters(entry, params)) {
+                output.write(output.json ? JSON.stringify(entry) : (0, format_1.formatLogEntry)(entry, output.color));
+            }
+        }
+    });
+}
+/** Lists the scene's metrics, or prints one metric's series. */
+async function runMetrics(client, params, output) {
+    if (!params.metric) {
+        const names = await client.listMetrics({ from: params.from, to: params.to });
+        if (output.json)
+            return names;
+        (0, format_1.formatMetricNames)(names).forEach((line) => output.write(line));
+        if (names.metrics.length > 0) {
+            output.note('Chart one with: scene-insights metrics <name>');
+        }
+        return names;
+    }
+    const series = await client.getMetricSeries(params.metric, {
+        from: params.from,
+        to: params.to,
+        step: params.step,
+        execution: params.execution
+    });
+    if (output.json)
+        return series;
+    (0, format_1.formatMetricSeries)(series).forEach((line) => output.write(line));
+    return series;
+}
+/** Lists the scene's executions (deployments × process restarts). */
+async function runExecutions(client, params, output) {
+    const result = await client.listExecutions({ from: params.from, to: params.to });
+    if (output.json)
+        return result;
+    (0, format_1.formatExecutions)(result).forEach((line) => output.write(line));
+    return result;
+}
+//# sourceMappingURL=actions.js.map

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

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

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

@@ -0,0 +1,51 @@
+import { CliComponents } from '../../components';
+import { CliError, CliErrorName } from '../../logic/error';
+import { InsightsSession } from './session';
+import { ExecutionsResult, LogEntry, LogSearchResult, MetricNamesResult, MetricSeries } from './types';
+/** Query parameters; undefined values are left out. */
+export type Query = Record<string, string | number | undefined>;
+export interface InsightsClient {
+    searchLogs(query: Query): Promise<LogSearchResult>;
+    listExecutions(query: Query): Promise<ExecutionsResult>;
+    /** The metrics with data for the scene (`GET /v1/metrics`). */
+    listMetrics(query: Query): Promise<MetricNamesResult>;
+    /** One metric's series (`GET /v1/metrics/<metric>/series`); the metric name is part of the signed path. */
+    getMetricSeries(metric: string, query: Query): Promise<MetricSeries>;
+    /**
+     * Follows the live tail until `signal` aborts or the service ends the stream with an error.
+     * Reconnects on its own after a dropped connection or a server restart, resuming from the last
+     * event, and never delivers the same line twice.
+     */
+    tail(options: {
+        lines?: number;
+        signal?: AbortSignal;
+        onLog: (entry: LogEntry) => void;
+    }): Promise<void>;
+}
+export interface ServerSentEvent {
+    event: string;
+    data: string;
+    id?: string;
+    retry?: number;
+}
+/**
+ * Incremental `text/event-stream` parser: feed it decoded chunks, and it calls `onEvent` for every
+ * complete event. Comments (`: ping`) are skipped.
+ */
+export declare function createSseParser(onEvent: (event: ServerSentEvent) => void): {
+    push(chunk: string): void;
+};
+/** Remembers the most recent ids, forgetting the oldest past its capacity. */
+export declare function createRecentIds(capacity: number): {
+    /** Records the id; false when it was already seen. */
+    add(id: string): boolean;
+};
+/** The Retry-After delay of a response, bounded, in milliseconds. */
+export declare function retryAfterMs(response: Response): number;
+/** Turns an error response into a CliError named after what went wrong, saying what to do about it. */
+export declare function errorFromResponse(response: Response): Promise<CliError<CliErrorName>>;
+/**
+ * Client of multiplayer-scenes-insights-service. Every request is signed with the session for the
+ * target scene (the service reads the scene from the signed metadata, never from the query).
+ */
+export declare function createInsightsClient(components: Pick<CliComponents, 'fetch' | 'logger'>, baseUrl: string, session: InsightsSession, metadata: string): InsightsClient;

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

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSseParser = createSseParser;
+exports.createRecentIds = createRecentIds;
+exports.retryAfterMs = retryAfterMs;
+exports.errorFromResponse = errorFromResponse;
+exports.createInsightsClient = createInsightsClient;
+const error_1 = require("../../logic/error");
+const format_1 = require("./format");
+/** Retries of a request the service refused for capacity (429/503 with Retry-After). */
+const MAX_BUSY_RETRIES = 3;
+const MAX_RETRY_AFTER_MS = 10000;
+/** Reconnect delays of a tail whose connection failed, doubled up to the maximum. */
+const TAIL_RECONNECT_MIN_MS = 1000;
+const TAIL_RECONNECT_MAX_MS = 30000;
+/** Event ids remembered to drop the lines the service sends twice around a reconnect. */
+const TAIL_SEEN_IDS = 10000;
+/**
+ * Incremental `text/event-stream` parser: feed it decoded chunks, and it calls `onEvent` for every
+ * complete event. Comments (`: ping`) are skipped.
+ */
+function createSseParser(onEvent) {
+    let buffer = '';
+    let event = '';
+    let data = [];
+    let id;
+    let retry;
+    function dispatch() {
+        if (data.length > 0 || retry !== undefined) {
+            onEvent({ event: event || 'message', data: data.join('\n'), id, retry });
+        }
+        event = '';
+        data = [];
+        id = undefined;
+        retry = undefined;
+    }
+    return {
+        push(chunk) {
+            buffer += chunk;
+            const lines = buffer.split(/\r\n|\r|\n/);
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                if (line === '') {
+                    dispatch();
+                    continue;
+                }
+                if (line.startsWith(':'))
+                    continue;
+                const separator = line.indexOf(':');
+                const field = separator === -1 ? line : line.slice(0, separator);
+                let value = separator === -1 ? '' : line.slice(separator + 1);
+                if (value.startsWith(' '))
+                    value = value.slice(1);
+                if (field === 'event')
+                    event = value;
+                else if (field === 'data')
+                    data.push(value);
+                else if (field === 'id')
+                    id = value;
+                else if (field === 'retry' && /^\d+$/.test(value))
+                    retry = parseInt(value, 10);
+            }
+        }
+    };
+}
+/** Remembers the most recent ids, forgetting the oldest past its capacity. */
+function createRecentIds(capacity) {
+    const ids = new Set();
+    return {
+        /** Records the id; false when it was already seen. */
+        add(id) {
+            if (ids.has(id))
+                return false;
+            ids.add(id);
+            if (ids.size > capacity) {
+                ids.delete(ids.values().next().value);
+            }
+            return true;
+        }
+    };
+}
+/** The Retry-After delay of a response, bounded, in milliseconds. */
+function retryAfterMs(response) {
+    const seconds = Number(response.headers.get('retry-after'));
+    return Math.min(Number.isFinite(seconds) && seconds > 0 ? seconds * 1000 : 1000, MAX_RETRY_AFTER_MS);
+}
+/** The error name of each status a caller can act on; anything else is a plain request failure. */
+const ERRORS_BY_STATUS = {
+    400: { name: 'SCENE_INSIGHTS_INVALID_ARGUMENT' },
+    401: {
+        name: 'SCENE_INSIGHTS_UNAUTHORIZED',
+        hint: 'the session was refused; run "sdk-commands scene-insights login" to sign a new one'
+    },
+    403: {
+        name: 'SCENE_INSIGHTS_FORBIDDEN',
+        hint: "the signed-in address is not in the scene's logsPermissions, and is not the World's owner or a deployer"
+    },
+    404: { name: 'SCENE_INSIGHTS_NOT_FOUND', hint: 'no deployed scene matches the World or parcel' },
+    429: { name: 'SCENE_INSIGHTS_UNAVAILABLE', hint: 'too many requests; try again shortly' },
+    503: { name: 'SCENE_INSIGHTS_UNAVAILABLE', hint: 'try again shortly' },
+    504: { name: 'SCENE_INSIGHTS_UNAVAILABLE', hint: 'the query timed out; narrow --from/--to or the filters' }
+};
+/** Turns an error response into a CliError named after what went wrong, saying what to do about it. */
+async function errorFromResponse(response) {
+    let reason = '';
+    try {
+        const text = await response.text();
+        try {
+            reason = String(JSON.parse(text).error ?? text);
+        }
+        catch {
+            reason = text;
+        }
+    }
+    catch {
+        // keep the status alone
+    }
+    reason = (0, format_1.stripControlCharacters)(reason);
+    const { name, hint } = ERRORS_BY_STATUS[response.status] ?? { name: 'SCENE_INSIGHTS_REQUEST_FAILED' };
+    const message = `The insights service answered ${response.status}${reason ? `: ${reason}` : ''}${hint ? ` (${hint})` : ''}`;
+    return new error_1.CliError(name, message);
+}
+/** A request that never got an answer (DNS, connection refused, reset). */
+function unreachable(baseUrl, error) {
+    const cause = error?.cause?.code ?? error?.message;
+    return new error_1.CliError('SCENE_INSIGHTS_UNAVAILABLE', `Could not reach ${baseUrl}${cause ? ` (${cause})` : ''}`);
+}
+/** Whether a parsed `log` event has the fields the tail prints and filters on. */
+function isLogEntry(value) {
+    const entry = value;
+    return (typeof entry === 'object' &&
+        entry !== null &&
+        typeof entry.message === 'string' &&
+        typeof entry.level === 'string' &&
+        typeof entry.source === 'string' &&
+        typeof entry.timestamp === 'string');
+}
+const sleep = (ms, signal) => new Promise((resolve) => {
+    const timer = setTimeout(done, ms);
+    function done() {
+        clearTimeout(timer);
+        signal?.removeEventListener('abort', done);
+        resolve();
+    }
+    signal?.addEventListener('abort', done, { once: true });
+});
+/**
+ * Client of multiplayer-scenes-insights-service. Every request is signed with the session for the
+ * target scene (the service reads the scene from the signed metadata, never from the query).
+ */
+function createInsightsClient(components, baseUrl, session, metadata) {
+    const { fetch, logger } = components;
+    const base = baseUrl.replace(/\/+$/, '');
+    function urlFor(pathname, query = {}) {
+        const url = new URL(base + pathname);
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        return url.toString();
+    }
+    async function get(pathname, query) {
+        for (let attempt = 0;; attempt++) {
+            let response;
+            try {
+                response = await fetch.fetch(urlFor(pathname, query), {
+                    headers: { ...session.sign('GET', pathname, metadata), Accept: 'application/json' }
+                });
+            }
+            catch (error) {
+                throw unreachable(base, error);
+            }
+            if (response.ok) {
+                return readJson(response);
+            }
+            if ((response.status === 429 || response.status === 503) && attempt < MAX_BUSY_RETRIES) {
+                const delay = retryAfterMs(response);
+                // an unread body keeps its socket until it is garbage collected
+                await response.body?.cancel();
+                logger.log(`The insights service is busy (${response.status}); retrying in ${Math.ceil(delay / 1000)}s`);
+                await sleep(delay);
+                continue;
+            }
+            throw await errorFromResponse(response);
+        }
+    }
+    async function readJson(response) {
+        let text;
+        try {
+            text = await response.text();
+        }
+        catch (error) {
+            throw unreachable(base, error);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new error_1.CliError('SCENE_INSIGHTS_REQUEST_FAILED', `The insights service answered ${response.status} with a body that is not JSON: ${(0, format_1.stripControlCharacters)(text.slice(0, 200))}`);
+        }
+    }
+    async function tail({ lines, signal, onLog }) {
+        const pathname = '/v1/logs/tail';
+        const seen = createRecentIds(TAIL_SEEN_IDS);
+        let lastEventId;
+        let reconnectMs = TAIL_RECONNECT_MIN_MS;
+        while (!signal?.aborted) {
+            let serverRetryMs;
+            let streamError;
+            try {
+                // Replayed lines carry no resume id: until a live line gives one, a
+                // reconnect asks for the history again and `seen` drops what was shown.
+                const response = await fetch.fetch(urlFor(pathname, !lastEventId && lines ? { lines } : {}), {
+                    headers: {
+                        ...session.sign('GET', pathname, metadata),
+                        Accept: 'text/event-stream',
+                        ...(lastEventId && { 'Last-Event-ID': lastEventId })
+                    },
+                    signal
+                });
+                if (!response.ok) {
+                    if (response.status !== 429 && response.status !== 503) {
+                        throw await errorFromResponse(response);
+                    }
+                    serverRetryMs = retryAfterMs(response);
+                    await response.body?.cancel();
+                    logger.log(`The insights service is busy (${response.status}); reconnecting`);
+                }
+                else if (response.body) {
+                    reconnectMs = TAIL_RECONNECT_MIN_MS;
+                    const decoder = new TextDecoder();
+                    const parser = createSseParser((event) => {
+                        if (event.retry !== undefined)
+                            serverRetryMs = event.retry;
+                        if (event.event === 'error') {
+                            try {
+                                streamError = String(JSON.parse(event.data).error);
+                            }
+                            catch {
+                                streamError = event.data;
+                            }
+                            streamError = (0, format_1.stripControlCharacters)(streamError);
+                        }
+                        else if (event.event === 'log') {
+                            if (event.id)
+                                lastEventId = event.id;
+                            // skipped rather than thrown: a throw here reads as a dropped connection and resumes at the same line
+                            let entry;
+                            try {
+                                entry = JSON.parse(event.data);
+                            }
+                            catch {
+                                entry = undefined;
+                            }
+                            if (!isLogEntry(entry)) {
+                                logger.log(`Skipped a malformed log line from the insights service${event.id ? ` (event ${event.id})` : ''}`);
+                                return;
+                            }
+                            // an empty id means the line has none: never treat it as a repeat
+                            if (!entry.id || seen.add(entry.id))
+                                onLog(entry);
+                        }
+                    });
+                    for await (const chunk of response.body) {
+                        parser.push(decoder.decode(chunk, { stream: true }));
+                    }
+                }
+            }
+            catch (e) {
+                if (signal?.aborted)
+                    return;
+                if (e instanceof error_1.CliError)
+                    throw e;
+                logger.log(`The tail connection dropped (${e.message}); reconnecting`);
+            }
+            if (streamError !== undefined) {
+                throw new error_1.CliError('SCENE_INSIGHTS_STREAM_ENDED', `The insights service ended the tail: ${streamError}`);
+            }
+            if (signal?.aborted)
+                return;
+            const delay = serverRetryMs ?? reconnectMs;
+            reconnectMs = Math.min(reconnectMs * 2, TAIL_RECONNECT_MAX_MS);
+            await sleep(delay, signal);
+        }
+    }
+    return {
+        searchLogs: (query) => get('/v1/logs', query),
+        listExecutions: (query) => get('/v1/executions', query),
+        listMetrics: (query) => get('/v1/metrics', query),
+        getMetricSeries: (metric, query) => get(`/v1/metrics/${encodeURIComponent(metric)}/series`, query),
+        tail
+    };
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { ExecutionsResult, LogEntry, MetricNamesResult, MetricSeries } from './types';
+/** Removes what a terminal would interpret (cursor moves, OSC 8 links, OSC 52 clipboard writes) from service text. */
+export declare function stripControlCharacters(text: string): string;
+/** `2026-10-12T14:13:02.166Z` → `2026-10-12 14:13:02.166Z`; anything unparseable is returned as is. */
+export declare function formatTimestamp(iso: string): string;
+/**
+ * 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.
+ */
+export declare function formatLogEntry(entry: LogEntry, color: boolean): string;
+/** A value in its unit: bytes in binary multiples, milliseconds up to seconds, counts as numbers. */
+export declare function formatValue(value: number | null, unit: string): string;
+/** A one-line chart of the values; gaps are blanks. */
+export declare function sparkline(values: Array<number | null>): string;
+/** Left-aligned columns separated by two spaces. */
+export declare function formatTable(header: string[], rawRows: string[][]): string[];
+export declare function formatMetricNames(result: MetricNamesResult): string[];
+/**
+ * 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.
+ */
+export declare function formatMetricSeries(series: MetricSeries): string[];
+export declare function formatExecutions(result: ExecutionsResult): string[];