@nodetool-ai/cli 0.7.0-rc.23 → 0.8.2

package/dist/commands/resource-read.js

@@ -0,0 +1,316 @@
+/**
+ * `workflows list|get`, `jobs list|get`, `assets list|get`.
+ *
+ * Each reads from the local SQLite database, or from a server when `--api-url`
+ * (or `NODETOOL_API_URL`) is set. The two sources return different records —
+ * the local model row carries every column, the server returns its declared
+ * response schema — so both are projected onto one field list per resource
+ * before anything is printed. Without that, `--json` handed an agent a
+ * different key set depending on an environment variable it never set.
+ *
+ * Each field list is the intersection of the model row and the server's
+ * response schema, so every key in the output is real on both paths: the
+ * server's derived fields (`etag`, `get_url`, `thumb_url`, `input_schema`) and
+ * the local-only blobs (a job's `graph` and `logs`) are both left out.
+ */
+import { Workflow, Job, Asset } from "@nodetool-ai/models";
+import { createApiClient } from "../api-client.js";
+import { printCommandError } from "../command-errors.js";
+import { printTable, asJson } from "./output.js";
+const WORKFLOW_FIELDS = [
+    "id",
+    "access",
+    "name",
+    "tool_name",
+    "description",
+    "tags",
+    "thumbnail",
+    "thumbnail_url",
+    "graph",
+    "settings",
+    "package_name",
+    "path",
+    "run_mode",
+    "workspace_id",
+    "html_app",
+    "app_doc",
+    "created_at",
+    "updated_at"
+];
+const JOB_FIELDS = [
+    "id",
+    "user_id",
+    "job_type",
+    "status",
+    "name",
+    "workflow_id",
+    "started_at",
+    "finished_at",
+    "error",
+    "cost"
+];
+const ASSET_FIELDS = [
+    "id",
+    "user_id",
+    "parent_id",
+    "name",
+    "content_type",
+    "size",
+    "duration",
+    "metadata",
+    "sketch_document_id",
+    "workflow_id",
+    "node_id",
+    "job_id",
+    "timeline_id",
+    "created_at"
+];
+/** Missing keys become null so both sources emit the same key set. */
+function project(raw, fields) {
+    const row = {};
+    for (const field of fields) {
+        row[field] = raw[field] ?? null;
+    }
+    return row;
+}
+function emitList(opts, rows, fields, columns) {
+    const projected = rows.map((row) => project(row, fields));
+    if (opts.json) {
+        asJson(projected);
+        return;
+    }
+    printTable(projected, columns);
+}
+function emitOne(opts, raw, fields, columns) {
+    const projected = project(raw, fields);
+    if (opts.json) {
+        asJson(projected);
+        return;
+    }
+    printTable([projected], columns);
+}
+function parseLimit(limit) {
+    return Number.parseInt(limit ?? "100", 10);
+}
+export function registerResourceReadCommands(parents, deps) {
+    const { ensureDb, localUserId } = deps;
+    parents.workflows
+        .command("list")
+        .description("List workflows (reads the local database; --api-url for remote)")
+        .option("--api-url <url>", "Query a remote server instead of the local database", process.env["NODETOOL_API_URL"])
+        .option("--limit <n>", "Max results", "100")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            const limit = parseLimit(opts.limit);
+            let rows;
+            if (opts.apiUrl) {
+                const data = await createApiClient(opts.apiUrl).workflows.list.query({
+                    limit
+                });
+                rows = data.workflows;
+            }
+            else {
+                ensureDb();
+                const [items] = await Workflow.paginate(localUserId, { limit });
+                rows = items.map((w) => ({ ...w }));
+            }
+            emitList(opts, rows, WORKFLOW_FIELDS, ["id", "name", "updated_at"]);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    parents.workflows
+        .command("get <workflow_id>")
+        .description("Get a workflow by ID (reads the local database; --api-url for remote)")
+        .option("--api-url <url>", "Query a remote server instead of the local database", process.env["NODETOOL_API_URL"])
+        .option("--json", "Output as JSON")
+        .action(async (workflowId, opts) => {
+        try {
+            let data;
+            if (opts.apiUrl) {
+                data = await createApiClient(opts.apiUrl).workflows.get.query({
+                    id: workflowId
+                });
+            }
+            else {
+                ensureDb();
+                const wf = await Workflow.find(localUserId, workflowId);
+                if (!wf)
+                    throw new Error(`Workflow not found: ${workflowId}`);
+                data = { ...wf };
+            }
+            emitOne(opts, data, WORKFLOW_FIELDS, [
+                "id",
+                "name",
+                "description",
+                "updated_at"
+            ]);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    parents.jobs
+        .command("list")
+        .description("List jobs (reads the local database; --api-url for remote)")
+        .option("--api-url <url>", "Query a remote server instead of the local database", process.env["NODETOOL_API_URL"])
+        .option("--workflow-id <id>", "Filter by workflow ID")
+        .option("--limit <n>", "Max results", "100")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            const limit = parseLimit(opts.limit);
+            let rows;
+            if (opts.apiUrl) {
+                const query = { limit };
+                if (opts.workflowId) {
+                    query.workflow_id = opts.workflowId;
+                }
+                const data = await createApiClient(opts.apiUrl).jobs.list.query(query);
+                rows = data.jobs;
+            }
+            else {
+                ensureDb();
+                const page = { limit };
+                if (opts.workflowId) {
+                    page.workflowId = opts.workflowId;
+                }
+                const [items] = await Job.paginate(localUserId, page);
+                rows = items.map((j) => ({ ...j }));
+            }
+            emitList(opts, rows, JOB_FIELDS, [
+                "id",
+                "status",
+                "workflow_id",
+                "started_at",
+                "cost"
+            ]);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    parents.jobs
+        .command("get <job_id>")
+        .description("Get a job by ID (reads the local database; --api-url for remote)")
+        .option("--api-url <url>", "Query a remote server instead of the local database", process.env["NODETOOL_API_URL"])
+        .option("--json", "Output as JSON")
+        .action(async (jobId, opts) => {
+        try {
+            let data;
+            if (opts.apiUrl) {
+                data = await createApiClient(opts.apiUrl).jobs.get.query({
+                    id: jobId
+                });
+            }
+            else {
+                ensureDb();
+                const job = await Job.find(localUserId, jobId);
+                if (!job)
+                    throw new Error(`Job not found: ${jobId}`);
+                data = { ...job };
+            }
+            emitOne(opts, data, JOB_FIELDS, [
+                "id",
+                "status",
+                "workflow_id",
+                "error",
+                "cost"
+            ]);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    parents.assets
+        .command("list")
+        .description("List assets (reads the local database; --api-url for remote)")
+        .option("--api-url <url>", "Query a remote server instead of the local database", process.env["NODETOOL_API_URL"])
+        .option("--query <q>", "Search query")
+        .option("--content-type <type>", "Filter by content type")
+        .option("--limit <n>", "Max results", "100")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            const limit = parseLimit(opts.limit);
+            let rows;
+            if (opts.apiUrl) {
+                const query = {
+                    page_size: limit
+                };
+                if (opts.contentType) {
+                    query.content_type = opts.contentType;
+                }
+                const data = await createApiClient(opts.apiUrl).assets.list.query(query);
+                rows = data.assets;
+            }
+            else {
+                ensureDb();
+                const page = { limit };
+                if (opts.contentType) {
+                    page.contentType = opts.contentType;
+                }
+                const [items] = await Asset.paginate(localUserId, page);
+                rows = items.map((a) => ({ ...a }));
+            }
+            // --query has no server-side search; filter by name in memory (matches
+            // the direct path too, which paginates without a search term).
+            if (opts.query) {
+                const q = opts.query.toLowerCase();
+                rows = rows.filter((r) => String(r["name"] ?? "")
+                    .toLowerCase()
+                    .includes(q));
+            }
+            emitList(opts, rows, ASSET_FIELDS, [
+                "id",
+                "name",
+                "content_type",
+                "size"
+            ]);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    parents.assets
+        .command("get <asset_id>")
+        .description("Get an asset by ID (reads the local database; --api-url for remote)")
+        .option("--api-url <url>", "Query a remote server instead of the local database", process.env["NODETOOL_API_URL"])
+        .option("--json", "Output as JSON")
+        .action(async (assetId, opts) => {
+        try {
+            let data;
+            if (opts.apiUrl) {
+                data = await createApiClient(opts.apiUrl).assets.get.query({
+                    id: assetId
+                });
+            }
+            else {
+                ensureDb();
+                const asset = await Asset.find(localUserId, assetId);
+                if (!asset)
+                    throw new Error(`Asset not found: ${assetId}`);
+                data = { ...asset };
+            }
+            emitOne(opts, data, ASSET_FIELDS, [
+                "id",
+                "name",
+                "content_type",
+                "size",
+                "created_at"
+            ]);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=resource-read.js.map

package/dist/commands/resource-read.js.map

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

package/dist/commands/runs.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+export interface RunsCommandDependencies {
+    ensureDb: () => Promise<void>;
+    localUserId: string;
+}
+export declare function registerRunsCommands(program: Command, deps: RunsCommandDependencies): void;
+//# sourceMappingURL=runs.d.ts.map

package/dist/commands/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/commands/runs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,MAAM,WAAW,uBAAuB;IAAG,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;CAAE;AAqJhG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAkF1F"}

package/dist/commands/runs.js

@@ -0,0 +1,302 @@
+import { setTimeout as delay } from "node:timers/promises";
+import { TRPCClientError } from "@trpc/client";
+import { listRuns, getRun, getRunTrace, getRunLogs, readRunUpdates } from "@nodetool-ai/execution";
+import { runGetOptionsSchema, runListOptionsSchema, runTraceOptionsSchema, runLogsOptionsSchema, runUpdatesOptionsSchema, TRACE_SPAN_LIMIT, TRACE_EVENT_LIMIT } from "@nodetool-ai/protocol";
+import { createApiClient } from "../api-client.js";
+import { printCommandError } from "../command-errors.js";
+import { asJson, printKv, printTable } from "./output.js";
+const TERMINAL_DRAIN_IDLE_MS = 1_000;
+const TERMINAL_DRAIN_MAX_MS = 5_000;
+async function reader(apiUrl, deps) {
+    if (apiUrl) {
+        const client = createApiClient(apiUrl);
+        return {
+            list: (options) => client.runs.list.query(options), get: (id, options) => client.runs.get.query({ id, ...options }),
+            trace: (id, options) => client.runs.trace.query({ id, ...options }),
+            logs: (id, options) => client.runs.logs.query({ id, ...options }),
+            updates: (id, options, signal) => client.runs.updates.query({ id, ...options }, { signal })
+        };
+    }
+    await deps.ensureDb();
+    return {
+        list: (options) => listRuns(deps.localUserId, options), get: (id, options) => getRun(deps.localUserId, id, options),
+        trace: (id, options) => getRunTrace(deps.localUserId, id, options),
+        logs: (id, options) => getRunLogs(deps.localUserId, id, options),
+        updates: (id, options) => readRunUpdates(deps.localUserId, id, options)
+    };
+}
+function integer(value, option, minimum, maximum) {
+    const parsed = Number(value);
+    if (!/^\d+$/.test(value) || !Number.isSafeInteger(parsed) || parsed < minimum || parsed > maximum) {
+        throw new Error(`${option} must be an integer between ${minimum} and ${maximum}`);
+    }
+    return parsed;
+}
+function attr(attributes, key) { const value = attributes[key]; return value === undefined || value === null || value === "" ? undefined : String(value); }
+function clip(text, max) { const flat = text.replace(/\s+/g, " "); return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat; }
+/** The most identifying attribute of a span: the node for node spans, provider/model for LLM spans. */
+function spanDetail(attributes) {
+    const node = attr(attributes, "node.id");
+    const type = attr(attributes, "node.type");
+    if (node) {
+        return clip(type ? `${node} (${type})` : node, 48);
+    }
+    const provider = attr(attributes, "llm.provider");
+    const model = attr(attributes, "llm.model");
+    return provider || model ? clip([provider, model].filter(Boolean).join("/"), 48) : "";
+}
+function fail(error, json) { printCommandError(error, json); process.exitCode = 1; }
+function common(command) {
+    return command.option("--api-url <url>", "Read a server instead of the local database", process.env["NODETOOL_API_URL"])
+        .option("--json", "JSON result; tail emits NDJSON");
+}
+/** Follow coalesced durable snapshots. Event frames are emitted once per stable identity. */
+async function tail(reader, id, options) {
+    let cursor = integer(options.cursor, "--cursor", 0, Number.MAX_SAFE_INTEGER);
+    const limit = integer(options.limit, "--limit", 1, 500);
+    const interval = integer(options.pollInterval, "--poll-interval", 10, 5_000);
+    const timeout = options.timeout === undefined ? null : integer(options.timeout, "--timeout", 1, 86_400) * 1_000;
+    const controller = new AbortController();
+    const interrupt = () => { controller.abort("interrupt"); };
+    process.once("SIGINT", interrupt);
+    const timer = timeout === null ? null : setTimeout(() => { controller.abort("timeout"); }, timeout);
+    const seenSpans = new Map();
+    const seenEvents = new Set();
+    const emit = (value, text) => {
+        if (options.json) {
+            console.log(JSON.stringify(value));
+        }
+        else {
+            console.log(text);
+        }
+    };
+    let first = true;
+    let terminalDrainStarted = null;
+    let lastProgressAt = Date.now();
+    let dedupLimitReported = false;
+    const dedupLimit = () => {
+        if (dedupLimitReported) {
+            return;
+        }
+        dedupLimitReported = true;
+        emit({ type: "gap", cursor, reason: "dedup_limit" }, "Deduplication capacity reached. Later replay may repeat records.");
+    };
+    try {
+        while (!controller.signal.aborted) {
+            let page;
+            try {
+                page = await reader.updates(id, runUpdatesOptionsSchema.parse({ cursor, limit, include_content: options.includeContent ?? false }), controller.signal);
+            }
+            catch (error) {
+                if (!options.apiUrl || !(error instanceof TRPCClientError) || error.data) {
+                    throw error;
+                }
+                emit({ type: "reconnecting", cursor }, `Connection lost. Retrying from cursor ${cursor}.`);
+                await delay(interval, undefined, { signal: controller.signal });
+                continue;
+            }
+            controller.signal.throwIfAborted();
+            if (first || page.records.length > 0) {
+                emit({ type: "resnapshot", run_id: page.run.id, after_cursor: cursor, cursor: page.cursor, resnapshot_required: page.resnapshot_required,
+                    content_state: page.content_state, content_expired: page.content_expired, truncated: page.truncated, incomplete: page.incomplete, limited: page.limited }, `Run ${page.run.id}: latest snapshots after cursor ${cursor} (intermediate updates may be coalesced).`);
+                first = false;
+            }
+            for (const update of page.records) {
+                if ((seenSpans.get(update.record.span_id) ?? -1) >= update.cursor) {
+                    continue;
+                }
+                if (seenSpans.has(update.record.span_id) || seenSpans.size < TRACE_SPAN_LIMIT + 1) {
+                    seenSpans.set(update.record.span_id, update.cursor);
+                }
+                else {
+                    dedupLimit();
+                }
+                emit({ type: "span", ...update }, `${update.cursor} ${update.record.name} ${update.record.span_id} ${update.record.status.code}`);
+                for (const [index, event] of update.record.events.entries()) {
+                    const eventId = event.id ?? `${update.record.span_id}:${index}`;
+                    const key = `${update.record.span_id}:${eventId}`;
+                    if (seenEvents.has(key)) {
+                        continue;
+                    }
+                    if (seenEvents.size < TRACE_EVENT_LIMIT) {
+                        seenEvents.add(key);
+                    }
+                    else {
+                        dedupLimit();
+                    }
+                    emit({ type: "event", run_id: update.run_id, span_id: update.record.span_id, cursor: update.cursor, event: { ...event, id: eventId } }, `${event.time_ms} ${event.name} ${JSON.stringify(event.attributes ?? {})}`);
+                }
+            }
+            if (page.cursor > cursor) {
+                lastProgressAt = Date.now();
+            }
+            cursor = Math.max(cursor, page.cursor);
+            if (page.has_more) {
+                continue;
+            }
+            if (page.run.status !== "running") {
+                const now = Date.now();
+                if (terminalDrainStarted === null) {
+                    terminalDrainStarted = now;
+                    lastProgressAt = now;
+                }
+                if (page.trace_settled || now - lastProgressAt >= TERMINAL_DRAIN_IDLE_MS || now - terminalDrainStarted >= TERMINAL_DRAIN_MAX_MS) {
+                    if (!page.trace_settled) {
+                        emit({ type: "gap", cursor, reason: "terminal_trace_incomplete" }, "Run ended before all final span snapshots were stored. Resume from this cursor to check later.");
+                    }
+                    emit({ type: "terminal", run: page.run, cursor, trace_settled: page.trace_settled }, `Run ${page.run.id} ${page.run.status}. Cursor ${cursor}.`);
+                    return;
+                }
+            }
+            await delay(interval, undefined, { signal: controller.signal });
+        }
+    }
+    catch (error) {
+        if (!controller.signal.aborted) {
+            throw error;
+        }
+    }
+    finally {
+        process.removeListener("SIGINT", interrupt);
+        if (timer !== null) {
+            clearTimeout(timer);
+        }
+    }
+    if (controller.signal.reason === "interrupt") {
+        emit({ type: "interrupted", cursor }, `Stopped following at cursor ${cursor}.`);
+        process.exitCode = 130;
+        return;
+    }
+    throw new Error(`Timed out following run ${id} at cursor ${cursor}`);
+}
+export function registerRunsCommands(program, deps) {
+    const runs = program.command("runs").description("Inspect durable app runs, workflow jobs and chat turns");
+    common(runs.command("list").description("List owned runs, newest first")
+        .option("--kind <kind>", "app, workflow or chat").option("--app-id <id>", "App filter")
+        .option("--instance-id <id>", "Instance filter").option("--workflow-id <id>", "Workflow filter")
+        .option("--thread-id <id>", "Chat thread filter").option("--status <status>", "running, completed, failed or cancelled")
+        .option("--origin <origin>", "ui, agent, cli, debug or public").option("--since <iso>", "Inclusive start time")
+        .option("--until <iso>", "Exclusive end time").option("--limit <n>", "Results, 1–100", "20")
+        .option("--cursor <cursor>", "Opaque next_cursor from the previous page"))
+        .action(async (options) => {
+        try {
+            const query = runListOptionsSchema.parse({ kind: options.kind, app_id: options.appId, instance_id: options.instanceId,
+                workflow_id: options.workflowId, thread_id: options.threadId, status: options.status, origin: options.origin,
+                since: options.since, until: options.until, limit: integer(options.limit, "--limit", 1, 100), cursor: options.cursor });
+            const result = await (await reader(options.apiUrl, deps)).list(query);
+            if (options.json) {
+                asJson(result);
+            }
+            else {
+                printTable(result.runs, ["id", "kind", "status", "origin", "started_at", "cost_usd"]);
+                if (result.next_cursor) {
+                    console.log(`next_cursor: ${result.next_cursor}`);
+                }
+            }
+        }
+        catch (error) {
+            fail(error, options.json);
+        }
+    });
+    common(runs.command("show <id>").description("Read the run and bounded diagnostic summary")
+        .option("--include-content", "Read capped app run inputs and outputs"))
+        .action(async (id, options) => {
+        try {
+            const query = runGetOptionsSchema.parse({ include_content: options.includeContent ?? false });
+            const result = await (await reader(options.apiUrl, deps)).get(id, query);
+            if (options.json) {
+                asJson(result);
+                return;
+            }
+            printKv({ id: result.run.id, kind: result.run.kind, status: result.run.status, error: result.run.error,
+                cost_usd: result.run.cost_usd, first_failed_span_id: result.summary.first_failed_span_id,
+                content_state: result.summary.content_state, truncated: result.summary.truncated, incomplete: result.summary.incomplete });
+            if (result.summary.failure_path.length > 0) {
+                printTable(result.summary.failure_path, ["span_id", "name", "status", "duration_ms", "error"]);
+            }
+            if (options.includeContent && result.run.app) {
+                asJson(result.run.app);
+            }
+        }
+        catch (error) {
+            fail(error, options.json);
+        }
+    });
+    common(runs.command("trace <id>").description("Read the span tree")
+        .option("--depth <n>", "Tree depth, 0–64", "4").option("--focus <span-id>", "Focus a full 16-character span ID")
+        .option("--name <name>", "Span name filter").option("--errors-only", "Only failed spans and their ancestors")
+        .option("--limit <n>", "Spans, 1–500", "100").option("--include-content", "Read capped content on the focused span"))
+        .action(async (id, options) => {
+        try {
+            const query = runTraceOptionsSchema.parse({ depth: integer(options.depth, "--depth", 0, 64), focus_span_id: options.focus,
+                name: options.name, errors_only: options.errorsOnly ?? false, limit: integer(options.limit, "--limit", 1, 500), include_content: options.includeContent ?? false });
+            const result = await (await reader(options.apiUrl, deps)).trace(id, query);
+            if (options.json) {
+                asJson(result);
+            }
+            else {
+                printTable(result.nodes.map(({ record, depth }) => ({ span_id: record.span_id, name: `${"  ".repeat(depth)}${record.name}`, status: record.status.code, duration_ms: record.duration_ms, detail: spanDetail(record.attributes) })));
+                printKv({ content_state: result.content_state, truncated: result.truncated, incomplete: result.incomplete, limited: result.limited });
+                if (options.includeContent) {
+                    asJson(result.nodes.map(({ record }) => record));
+                }
+            }
+        }
+        catch (error) {
+            fail(error, options.json);
+        }
+    });
+    common(runs.command("logs <id>").description("Read stored span events, oldest first")
+        .option("--level <level>", "Log level filter").option("--source <source>", "Source filter").option("--span <span-id>", "Full span ID filter")
+        .option("--since-ms <time>", "Inclusive event timestamp in milliseconds").option("--until-ms <time>", "Exclusive event timestamp in milliseconds")
+        .option("--limit <n>", "Events, 1–500", "100").option("--cursor <cursor>", "Opaque next_cursor from previous page")
+        .option("--include-content", "Read capped event content"))
+        .action(async (id, options) => {
+        try {
+            const query = runLogsOptionsSchema.parse({ level: options.level, source: options.source, span_id: options.span,
+                since_ms: options.sinceMs === undefined ? undefined : Number(options.sinceMs), until_ms: options.untilMs === undefined ? undefined : Number(options.untilMs),
+                limit: integer(options.limit, "--limit", 1, 500), cursor: options.cursor, include_content: options.includeContent ?? false });
+            const result = await (await reader(options.apiUrl, deps)).logs(id, query);
+            if (options.json) {
+                asJson(result);
+            }
+            else {
+                if (options.includeContent) {
+                    printTable(result.logs.map((event) => ({ ...event, message: clip(attr(event.attributes, "log.message") ?? "", 80), arguments: clip(attr(event.attributes, "log.arguments") ?? "", 40) })), ["time_ms", "level", "source", "span_id", "message", "arguments"]);
+                }
+                else {
+                    printTable(result.logs, ["time_ms", "level", "source", "span_id", "name"]);
+                    if (result.logs.length > 0) {
+                        console.log("Messages are excluded. Pass --include-content to read them.");
+                    }
+                }
+                printKv({ content_state: result.content_state, truncated: result.truncated, incomplete: result.incomplete, limited: result.limited });
+                if (result.next_cursor) {
+                    console.log(`next_cursor: ${result.next_cursor}`);
+                }
+            }
+        }
+        catch (error) {
+            fail(error, options.json);
+        }
+    });
+    common(runs.command("tail <id>").description("Follow durable span snapshots and events until the run ends")
+        .option("--cursor <n>", "Resume after a durable cursor", "0").option("--limit <n>", "Snapshots per page, 1–500", "100")
+        .option("--poll-interval <ms>", "Polling interval, 10–5000 ms", "250").option("--timeout <seconds>", "Stop waiting after 1–86400 seconds")
+        .option("--include-content", "Read capped owner content"))
+        .action(async (id, options) => {
+        try {
+            await tail(await reader(options.apiUrl, deps), id, options);
+        }
+        catch (error) {
+            if (options.json) {
+                console.log(JSON.stringify({ type: "error", error: error instanceof Error ? error.message : String(error) }));
+                process.exitCode = 1;
+            }
+            else {
+                fail(error);
+            }
+        }
+    });
+}
+//# sourceMappingURL=runs.js.map