@nocobase/app-cli-client 0.0.0-stage → 0.1.0-beta.1

package/dist/dynamic/index.js

@@ -0,0 +1,197 @@
+// Business commands from the server's manifest (`<bin> issue comment add …`): the CLI ships none of them. oclif hands
+// an unknown command to the `command_not_found` hook (src/hooks/command-not-found.ts) and `--help` for one to the help
+// class (src/dynamic/help.ts); both come here with the original argv, which `runAppCli` records, since oclif folds and
+// splits the words.
+//
+// Each command is sent to its API route (`rest.ts`). `--json` prints the cli-envelope, success or failure, and nothing
+// else on stdout.
+import { Errors } from '@oclif/core';
+import { EXIT_CODES } from '@nocobase/agent-protocol';
+import { appCliConfig } from "../config.js";
+import { asCliError, UsageError } from "../lib/command.js";
+import { CliCommandError, failureEnvelope, successEnvelope, } from "../lib/envelope.js";
+import { globalFlags } from "../lib/globals.js";
+import { AppApiError } from "../lib/http.js";
+import { askUpdateHint, printUpdateHint } from "../lib/update-hint.js";
+import { loadManifest } from "./manifest.js";
+import { renderAnswer, renderCommandHelp, renderTopicHelp } from "./output.js";
+import { leadingWords } from "./parse.js";
+import { executeRest, parseRestCall } from "./rest.js";
+import { currentSession } from "./session.js";
+let originalArgv;
+/** Records the argv the CLI was started with (`runAppCli`). */
+export function setOriginalArgv(argv) {
+    originalArgv = [...argv];
+}
+export function getOriginalArgv() {
+    return originalArgv ?? process.argv.slice(2);
+}
+function unknownCommand(argv, hint) {
+    const typed = leadingWords(argv).join(' ');
+    const { bin } = appCliConfig();
+    return new Errors.CLIError(`Unknown command: ${bin} ${typed}. ${hint ?? `Run \`${bin} --help\` for the list.`}`, { exit: EXIT_CODES.notFound });
+}
+/**
+ * Why a command the line names is not offered, when the server describes it: another identity's, or needing an
+ * action the caller does not hold. Undefined when the server knows no such command.
+ */
+export function withheldCommand(manifest, argv) {
+    const words = leadingWords(argv);
+    const byId = new Map((manifest.withheld ?? []).map((command) => [command.id, command]));
+    const { bin, displayName } = appCliConfig();
+    for (let count = words.length; count > 0; count -= 1) {
+        const found = byId.get(words.slice(0, count).join(':'));
+        if (!found)
+            continue;
+        const typed = `${bin} ${found.id.split(':').join(' ')}`;
+        const run = manifest.identity.kind === 'run';
+        if (found.reason === 'action')
+            return new CliCommandError('ACTION_REQUIRED', run
+                ? `\`${typed}\` needs the action ${found.action}, which this run's agent is not given.`
+                : `\`${typed}\` needs the action ${found.action}, which you do not hold.`, {
+                exit: EXIT_CODES.auth,
+                suggestions: [
+                    {
+                        message: run
+                            ? `Ask whoever configures the agent to give it ${found.action}, or a person to do it.`
+                            : `Ask whoever manages permissions in ${displayName} for ${found.action}.`,
+                    },
+                    {
+                        message: 'See who you act as and the actions you hold.',
+                        run: { command: bin, args: ['whoami'] },
+                    },
+                ],
+                details: { command: found.id, action: found.action },
+            });
+        return new CliCommandError('IDENTITY_MISMATCH', run
+            ? `\`${typed}\` is a person's command; an agent's run cannot call it.`
+            : `\`${typed}\` is only for an agent's run, with its run token.`, {
+            exit: EXIT_CODES.auth,
+            suggestions: [],
+            details: { command: found.id, identities: found.identities },
+        });
+    }
+    return undefined;
+}
+/** The session and its manifest, or undefined when the CLI is neither in a run nor signed in. */
+export async function loadDynamic(options = {}) {
+    const session = await currentSession();
+    if (!session)
+        return undefined;
+    return { session, manifest: await loadManifest(session, options) };
+}
+/**
+ * The manifest command the line starts with, by its longest match. oclif splits words holding `:` and folds positional
+ * words into the command id, so the original argv is the only exact source.
+ */
+export function resolveCommand(manifest, argv) {
+    const words = leadingWords(argv);
+    const byId = new Map(manifest.commands.map((command) => [command.id, command]));
+    for (let count = words.length; count > 0; count -= 1) {
+        const command = byId.get(words.slice(0, count).join(':'));
+        if (command)
+            return { command, rest: argv.slice(count) };
+    }
+    return undefined;
+}
+/** The help for a business command or a topic of them; undefined when the manifest has neither. */
+export function dynamicHelp(manifest, argv) {
+    const resolved = resolveCommand(manifest, argv);
+    if (resolved)
+        return renderCommandHelp(resolved.command);
+    return renderTopicHelp(manifest, leadingWords(argv));
+}
+async function runResolved(session, { command, rest }) {
+    const call = await parseRestCall(command, rest);
+    if (call.help)
+        return { help: renderCommandHelp(command), json: call.json };
+    return {
+        answer: await executeRest(session, command, call),
+        json: call.json,
+    };
+}
+function exitCodeOf(error) {
+    if (error instanceof AppApiError)
+        return error.exitCode;
+    if (error instanceof UsageError)
+        return error.exit;
+    if (error instanceof CliCommandError)
+        return error.exit;
+    return EXIT_CODES.general;
+}
+/** Runs the business command `argv` names; writes its output; throws a `CLIError` on failure. */
+export async function runDynamic(argv, write = (text) => process.stdout.write(`${text}\n`)) {
+    const json = argv.includes('--json');
+    const typed = leadingWords(argv).join(' ');
+    const fail = (error) => {
+        if (!json)
+            return asCliError(error);
+        write(JSON.stringify(failureEnvelope(typed, error, [], appCliConfig().bin), null, 2));
+        return new Errors.ExitError(exitCodeOf(error));
+    };
+    let context;
+    try {
+        context = await loadDynamic({
+            offline: argv.includes('--help') || argv.includes('-h'),
+        });
+    }
+    catch (error) {
+        throw fail(error);
+    }
+    if (!context) {
+        const error = unknownCommand(argv, `Business commands need a run, or \`${appCliConfig().bin} login\` first.`);
+        throw json
+            ? fail(new UsageError(error.message, EXIT_CODES.notFound))
+            : error;
+    }
+    // A person's command asks whether a newer CLI is served, and says so after its own output.
+    const hint = context.session.kind === 'user'
+        ? askUpdateHint(context.session)
+        : Promise.resolve(undefined);
+    try {
+        await runContext(context, argv, json, write, fail);
+    }
+    finally {
+        await printUpdateHint(hint);
+    }
+}
+async function runContext(context, argv, json, write, fail) {
+    const resolved = resolveCommand(context.manifest, argv);
+    if (!resolved) {
+        if (argv.includes('--help') || argv.includes('-h')) {
+            const topic = renderTopicHelp(context.manifest, leadingWords(argv));
+            if (topic) {
+                write(topic);
+                return;
+            }
+        }
+        const withheld = withheldCommand(context.manifest, argv);
+        if (withheld)
+            throw fail(withheld);
+        const error = unknownCommand(argv);
+        throw json
+            ? fail(new UsageError(error.message, EXIT_CODES.notFound))
+            : error;
+    }
+    const name = resolved.command.id.split(':').join(' ');
+    try {
+        const outcome = await runResolved(context.session, resolved);
+        if (outcome.help !== undefined) {
+            write(outcome.help);
+            return;
+        }
+        const answer = outcome.answer ?? { data: null };
+        const { dryRun, quiet } = globalFlags();
+        if (outcome.json)
+            write(JSON.stringify(successEnvelope(name, answer, [], dryRun ? 'success-noop' : 'success'), null, 2));
+        else if (!quiet)
+            write(renderAnswer(resolved.command, answer));
+    }
+    catch (error) {
+        if (!json)
+            throw asCliError(error);
+        write(JSON.stringify(failureEnvelope(name, error, [], appCliConfig().bin), null, 2));
+        throw new Errors.ExitError(exitCodeOf(error));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/dynamic/index.js.map

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

package/dist/dynamic/manifest.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { type AppCliPaths } from '../config.ts';
+import type { CliCommand, CliManifest, CliParameter } from '../parse/manifest.ts';
+import { type Session } from './session.ts';
+export type { CliCommand, CliManifest, CliParameter, CliWithheldCommand, } from '../parse/manifest.ts';
+export declare const CliParameterSchema: z.ZodType<CliParameter>;
+export declare const CliCommandSchema: z.ZodType<CliCommand>;
+export declare const CliManifestSchema: z.ZodType<CliManifest>;
+export declare function manifestCacheFile(paths: AppCliPaths, session: Pick<Session, 'server' | 'cacheKey'>): string;
+/** The cached manifest of a session, without asking the server; undefined when none is cached. */
+export declare function readCachedManifest(session: Pick<Session, 'server' | 'cacheKey'>, paths?: AppCliPaths): Promise<CliManifest | undefined>;
+export interface ManifestOptions {
+    readonly paths?: AppCliPaths;
+    /** Use the cached manifest when the server cannot be reached. */
+    readonly offline?: boolean;
+    readonly timeoutMs?: number;
+    readonly fetch?: typeof fetch;
+}
+/** The session's manifest; `AppApiError` when the server refuses or cannot be reached (and nothing is cached). */
+export declare function loadManifest(session: Session, options?: ManifestOptions): Promise<CliManifest>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/dynamic/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/dynamic/manifest.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAEpD,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAuDrD,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAuBjD,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAsBnD,CAAC;AAOH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC,GAC5C,MAAM,CAMR;AAED,kGAAkG;AAClG,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC,EAC7C,KAAK,GAAE,WAA2B,GACjC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAMlC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAED,kHAAkH;AAClH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAyDtB"}

package/dist/dynamic/manifest.js

@@ -0,0 +1,175 @@
+// The command manifest of the current session (`GET /api/cli/manifest`): the commands the application's API document
+// describes for the caller, each a request to one of its routes. Cached by etag in `<state dir>/cache/manifests/`: each fetch sends the
+// cached etag (`If-None-Match`) and a 304 reuses the cached manifest. When the server cannot be reached, a cached
+// manifest still serves `--help`; running a command needs the server anyway.
+//
+// The schema here is the client's reading of the wire format the server's `CliManifest` (`@nocobase/app-server/router`)
+// writes; it ignores members it does not know, so a newer server does not break an older CLI.
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { readErrorBody } from '@nocobase/agent-protocol';
+import { z } from 'zod';
+import { appCliPaths } from "../config.js";
+import { readJson, writeJsonAtomic } from "../lib/files.js";
+import { AppApiError, dataOf } from "../lib/http.js";
+import { urlFor } from "./session.js";
+const Identity = z.enum(['person', 'run']);
+export const CliParameterSchema = z.object({
+    name: z.string(),
+    field: z.string(),
+    in: z.enum(['path', 'query', 'body', 'file']),
+    position: z.number().int().optional(),
+    type: z.enum([
+        'string',
+        'number',
+        'integer',
+        'boolean',
+        'string[]',
+        'number[]',
+        'json',
+    ]),
+    required: z.boolean(),
+    description: z.string().optional(),
+    enum: z.array(z.string()).optional(),
+    default: z.unknown().optional(),
+    alias: z.string().optional(),
+    contentFile: z.boolean().optional(),
+    prompt: z.boolean().optional(),
+    fromEnv: z.string().optional(),
+    env: z
+        .array(z.union([z.string(), z.object({ file: z.string(), path: z.string() })]))
+        .optional(),
+    upload: z
+        .object({
+        method: z.string(),
+        path: z.string(),
+        part: z.string(),
+        field: z.string(),
+        multiple: z.boolean(),
+        maxBytes: z.number().int().optional(),
+    })
+        .optional(),
+    ticket: z
+        .object({
+        maxBytes: z.number().int(),
+        accept: z.array(z.string()).optional(),
+        optional: z.boolean().optional(),
+    })
+        .optional(),
+    changed: z
+        .object({
+        dir: z.string(),
+        manifest: z.string(),
+        maxBytes: z.number().int(),
+        maxFiles: z.number().int(),
+        accept: z.array(z.string()).optional(),
+    })
+        .optional(),
+    binary: z.boolean().optional(),
+    multiple: z.boolean().optional(),
+});
+export const CliCommandSchema = z.object({
+    id: z.string().min(1),
+    summary: z.string(),
+    description: z.string().optional(),
+    operationId: z.string().optional(),
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']),
+    path: z.string(),
+    parameters: z.array(CliParameterSchema),
+    body: z
+        .object({
+        media: z.enum(['application/json', 'multipart/form-data']),
+        file: z.string().optional(),
+        required: z.boolean().optional(),
+    })
+        .optional(),
+    output: z.object({
+        kind: z.enum(['data', 'list', 'empty', 'download']),
+        columns: z.array(z.string()).optional(),
+    }),
+    confirm: z.string().optional(),
+    examples: z.array(z.string()).optional(),
+    identities: z.array(Identity),
+    action: z.string().optional(),
+});
+export const CliManifestSchema = z.object({
+    version: z.number().int(),
+    etag: z.string().min(1),
+    identity: z.object({
+        kind: Identity,
+        userId: z.string(),
+        displayName: z.string(),
+        runId: z.string().optional(),
+        actions: z.array(z.string()).optional(),
+    }),
+    commands: z.array(CliCommandSchema),
+    withheld: z
+        .array(z.object({
+        id: z.string(),
+        summary: z.string(),
+        reason: z.enum(['identity', 'action']),
+        identities: z.array(Identity),
+        action: z.string().optional(),
+    }))
+        .optional(),
+});
+export function manifestCacheFile(paths, session) {
+    const key = createHash('sha256')
+        .update(`${session.server}\u0000${session.cacheKey}`)
+        .digest('hex')
+        .slice(0, 24);
+    return path.join(paths.manifestCache, `${key}.json`);
+}
+/** The cached manifest of a session, without asking the server; undefined when none is cached. */
+export async function readCachedManifest(session, paths = appCliPaths()) {
+    const cached = await readJson(manifestCacheFile(paths, session)).catch(() => undefined);
+    const parsed = CliManifestSchema.safeParse(cached?.manifest);
+    return parsed.success ? parsed.data : undefined;
+}
+/** The session's manifest; `AppApiError` when the server refuses or cannot be reached (and nothing is cached). */
+export async function loadManifest(session, options = {}) {
+    const paths = options.paths ?? appCliPaths();
+    const file = manifestCacheFile(paths, session);
+    const cached = await readJson(file).catch(() => undefined);
+    // A manifest cached by an older CLI is fetched again rather than misread.
+    const usable = cached && CliManifestSchema.safeParse(cached.manifest).success
+        ? cached
+        : undefined;
+    const url = urlFor(session.server, session.manifestPath);
+    let response;
+    try {
+        response = await (options.fetch ?? fetch)(url, {
+            headers: {
+                accept: 'application/json',
+                ...session.headers,
+                ...(usable ? { 'if-none-match': `"${usable.etag}"` } : {}),
+            },
+            signal: AbortSignal.timeout(options.timeoutMs ?? 15_000),
+        });
+    }
+    catch (error) {
+        if (usable && options.offline)
+            return usable.manifest;
+        throw new AppApiError(0, 'NETWORK', `Could not reach ${url.origin}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (response.status === 304 && usable)
+        return usable.manifest;
+    const text = await response.text().catch(() => '');
+    let body;
+    try {
+        body = text === '' ? undefined : JSON.parse(text);
+    }
+    catch {
+        body = undefined;
+    }
+    if (!response.ok) {
+        const error = readErrorBody(body);
+        if (error)
+            throw new AppApiError(response.status, error.reason, error.message, error.metadata, error.status);
+        throw new AppApiError(response.status, `HTTP_${response.status}`, `GET ${url.pathname} answered ${response.status}`);
+    }
+    const manifest = CliManifestSchema.parse(dataOf(body));
+    await writeJsonAtomic(file, { etag: manifest.etag, manifest }, 0o600).catch(() => undefined);
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/dynamic/manifest.js.map

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

package/dist/dynamic/output.d.ts

@@ -0,0 +1,14 @@
+import type { CliCommand, CliManifest } from './manifest.ts';
+import type { ApiAnswer } from './rest.ts';
+/** The value at a dotted path (`owner.name`, `replies.length`). */
+export declare function valueAt(row: unknown, column: string): unknown;
+export declare function renderTable(rows: readonly unknown[], columns: readonly string[]): string;
+/** An object's fields, one per line: scalars as they are, anything else on one line. */
+export declare function renderFields(data: Readonly<Record<string, unknown>>): string;
+/** What a person reads of an answer. */
+export declare function renderAnswer(command: CliCommand, answer: ApiAnswer): string;
+export declare function renderCommandHelp(command: CliCommand): string;
+/** The manifest's commands under `prefix` (all with an empty prefix), one line each. */
+export declare function renderCommandList(manifest: CliManifest, prefix?: readonly string[]): string | undefined;
+export declare function renderTopicHelp(manifest: CliManifest, prefix: readonly string[]): string | undefined;
+//# sourceMappingURL=output.d.ts.map

package/dist/dynamic/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/dynamic/output.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAc3C,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAO7D;AAKD,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,CAiBR;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAS5E;AAeD,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAsB3E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAU7D;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EACrB,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,GAAG,SAAS,CAEpB"}

package/dist/dynamic/output.js

@@ -0,0 +1,103 @@
+// What a business command prints, and its help, built from the manifest.
+//
+// `--json` prints the cli-envelope (`envelope.ts`), whose `result` is the API's answer, `{ data, meta? }`. Otherwise a
+// list prints a table, a column per `output.columns` (paths such as `owner.name`) or its items' first scalar fields; an
+// answer with `meta.message` prints the message; an object prints its fields, one per line; nothing prints `Done.`.
+import { appCliConfig } from "../config.js";
+import { GLOBAL_FLAG_HELP } from "../lib/globals.js";
+import { renderCommandHelp as renderSharedHelp, renderCommandList as renderSharedList, renderTopicHelp as renderSharedTopic, } from "../parse/help.js";
+function cell(value) {
+    if (value === null || value === undefined)
+        return '';
+    const text = typeof value === 'string'
+        ? value
+        : typeof value === 'number' || typeof value === 'boolean'
+            ? String(value)
+            : JSON.stringify(value);
+    const line = text.replace(/\s+/gu, ' ').trim();
+    return line.length > 80 ? `${line.slice(0, 79)}…` : line;
+}
+/** The value at a dotted path (`owner.name`, `replies.length`). */
+export function valueAt(row, column) {
+    let current = row;
+    for (const key of column.split('.')) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+const isScalar = (value) => value === null || ['string', 'number', 'boolean'].includes(typeof value);
+export function renderTable(rows, columns) {
+    if (rows.length === 0)
+        return '(none)';
+    const cells = rows.map((row) => columns.map((column) => cell(valueAt(row, column))));
+    const widths = columns.map((column, index) => Math.max(column.length, ...cells.map((row) => row[index].length)));
+    const line = (values) => values
+        .map((value, index) => value.padEnd(widths[index]))
+        .join('  ')
+        .trimEnd();
+    return [
+        line(columns.map((column) => column.toUpperCase())),
+        ...cells.map(line),
+    ].join('\n');
+}
+/** An object's fields, one per line: scalars as they are, anything else on one line. */
+export function renderFields(data) {
+    const entries = Object.entries(data).filter(([, value]) => value !== undefined);
+    if (entries.length === 0)
+        return '(empty)';
+    const width = Math.max(...entries.map(([key]) => key.length));
+    return entries
+        .map(([key, value]) => `${key.padEnd(width)}  ${cell(value)}`)
+        .join('\n');
+}
+function columnsOf(command, rows) {
+    if (command.output.columns?.length)
+        return command.output.columns;
+    const first = rows[0];
+    if (!first || typeof first !== 'object')
+        return ['value'];
+    return Object.entries(first)
+        .filter(([, value]) => isScalar(value))
+        .map(([key]) => key)
+        .slice(0, 6);
+}
+/** What a person reads of an answer. */
+export function renderAnswer(command, answer) {
+    const message = typeof answer.meta?.message === 'string' ? answer.meta.message : undefined;
+    const { data } = answer;
+    if (Array.isArray(data)) {
+        const table = renderTable(data, columnsOf(command, data).length > 0
+            ? columnsOf(command, data)
+            : ['value']);
+        const more = typeof answer.meta?.nextPageToken === 'string'
+            ? `\n(more: --page-token ${answer.meta.nextPageToken})`
+            : '';
+        return `${message ? `${message}\n` : ''}${table}${more}`;
+    }
+    if (message)
+        return message;
+    if (data === null || data === undefined)
+        return 'Done.';
+    if (typeof data === 'object')
+        return renderFields(data);
+    return typeof data === 'string' ? data : JSON.stringify(data);
+}
+export function renderCommandHelp(command) {
+    return renderSharedHelp(command, {
+        bin: appCliConfig().bin,
+        globalFlags: GLOBAL_FLAG_HELP.filter(([flag]) => 
+        // A command with a dry run lists its own `--dry-run` among its flags.
+        (flag !== '-y, --yes' || command.confirm !== undefined) &&
+            flag !== '--dry-run'),
+    });
+}
+/** The manifest's commands under `prefix` (all with an empty prefix), one line each. */
+export function renderCommandList(manifest, prefix = []) {
+    return renderSharedList(manifest.commands, prefix);
+}
+export function renderTopicHelp(manifest, prefix) {
+    return renderSharedTopic(appCliConfig().bin, manifest.commands, prefix);
+}
+//# sourceMappingURL=output.js.map

package/dist/dynamic/output.js.map

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

package/dist/dynamic/parse.d.ts

@@ -0,0 +1,3 @@
+/** The words before the first flag. */
+export declare function leadingWords(argv: readonly string[]): string[];
+//# sourceMappingURL=parse.d.ts.map

package/dist/dynamic/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/dynamic/parse.ts"],"names":[],"mappings":"AAGA,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAO9D"}

package/dist/dynamic/parse.js

@@ -0,0 +1,13 @@
+// The command words of a line: those before its first flag. oclif splits words holding `:` and folds positional words
+// into the command id, so the manifest's commands are resolved from the original argv.
+/** The words before the first flag. */
+export function leadingWords(argv) {
+    const words = [];
+    for (const word of argv) {
+        if (word.startsWith('-'))
+            break;
+        words.push(word);
+    }
+    return words;
+}
+//# sourceMappingURL=parse.js.map

package/dist/dynamic/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/dynamic/parse.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,uFAAuF;AAEvF,uCAAuC;AACvC,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM;QAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/dynamic/rest.d.ts

@@ -0,0 +1,29 @@
+import { type CliCall, type CliParseIo } from '../parse/arguments.ts';
+import { type LocalFile } from './files.ts';
+import type { CliCommand, CliParameter } from './manifest.ts';
+import { type Session } from './session.ts';
+/** What a command answered: the API's `{ data, meta? }`. */
+export interface ApiAnswer {
+    readonly data: unknown;
+    readonly meta?: Readonly<Record<string, unknown>>;
+}
+export type LocalUpload = LocalFile;
+/** A line read on this machine: its files found, and `--out` resolved against the working directory. */
+export type RestCall = CliCall<LocalUpload>;
+/** This machine, as the parser reads it: files relative to `cwd`, this process's environment, and its terminal. */
+export declare function localIo(cwd: string): CliParseIo<LocalUpload>;
+/** Reads the rest of the line against the command's parameters; files are read relative to `cwd`. */
+export declare function parseRestCall(command: CliCommand, rest: readonly string[], cwd?: string): Promise<RestCall>;
+export interface RestOptions {
+    readonly fetch?: typeof fetch;
+    readonly timeoutMs?: number;
+}
+/** The request a call makes: its URL, and its body. */
+export declare function buildRequest(session: Session, command: CliCommand, call: RestCall, uploadedIds?: ReadonlyMap<CliParameter, readonly string[]>): Promise<{
+    url: URL;
+    body?: string | FormData;
+    type?: string;
+}>;
+/** Sends the call; the API's answer, or for a download the saved file. */
+export declare function executeRest(session: Session, command: CliCommand, call: RestCall, options?: RestOptions): Promise<ApiAnswer>;
+//# sourceMappingURL=rest.d.ts.map

package/dist/dynamic/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../src/dynamic/rest.ts"],"names":[],"mappings":"AAoBA,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAGpD,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AAEpC,wGAAwG;AACxG,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AA4B5C,mHAAmH;AACnH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAe5D;AAED,qGAAqG;AACrG,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAwBnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AA+DD,uDAAuD;AACvD,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,QAAQ,EACd,WAAW,GAAE,WAAW,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAa,GACpE,OAAO,CAAC;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmChE;AAED,0EAA0E;AAC1E,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,SAAS,CAAC,CAyDpB"}