@atelierai/uco 1.0.0

package/dist/util/idle-wait.js

@@ -0,0 +1,93 @@
+// Post-call idle wait (COCli-05) — reuse the readiness stages and the
+// read-only editor probe from `uco wait-for-ready` so a mutating call that
+// triggered a refresh/compile/domain-reload can be followed by "wait until the
+// Editor is idle again" instead of caller-side sleep loops.
+import { CliError, TransportError } from './errors.js';
+import { editorReadiness, registrationReadiness, transportStage, } from './readiness.js';
+const DEFAULT_INTERVAL_MS = 1_000;
+const PROBE_BUDGET_MS = 10_000;
+/**
+ * Poll the readiness health stages and the editor state probe until the Editor
+ * reports not compiling, not updating, not importing, not domain-reloading,
+ * and no play-mode transition. Resolves when idle; throws the documented
+ * wait-timeout failure (exit 3) naming the last blocking stage and cause when
+ * the bound expires.
+ */
+export async function waitForEditorIdle(transport, options) {
+    const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+    const deadline = Date.now() + options.timeoutMs;
+    const probeTimeout = Math.min(intervalMs, PROBE_BUDGET_MS, Math.max(50, options.timeoutMs));
+    let attempt = 0;
+    let lastStage = 'http';
+    let lastCause = 'not-started';
+    while (Date.now() < deadline) {
+        attempt++;
+        let activeStage = 'http';
+        try {
+            const health = await transport.health({
+                timeoutMs: remainingBudget(deadline, probeTimeout, activeStage),
+            });
+            const registration = registrationReadiness(health);
+            if (!registration.ready) {
+                lastStage = registration.stage;
+                lastCause = registration.cause;
+                throw pendingError(`${registration.stage}: ${registration.cause}`);
+            }
+            activeStage = 'editor';
+            lastStage = activeStage;
+            const state = await transport.callTool('editor-application-get-state', {}, {
+                timeoutMs: remainingBudget(deadline, probeTimeout, activeStage),
+            });
+            const editor = editorReadiness(state);
+            if (!editor.ready) {
+                lastStage = editor.stage;
+                lastCause = editor.cause;
+                throw pendingError(`${editor.stage}: ${editor.cause}`);
+            }
+            return;
+        }
+        catch (err) {
+            if (err instanceof IdlePending) {
+                // fall through to the bounded sleep below
+            }
+            else if (err instanceof TransportError) {
+                lastStage = activeStage === 'editor' ? activeStage : transportStage(err);
+                lastCause = err.kind;
+            }
+            else {
+                throw err;
+            }
+            const remainingMs = deadline - Date.now();
+            const sleepMs = Math.min(intervalMs, Math.max(0, remainingMs));
+            if (sleepMs <= 0)
+                break;
+            await new Promise((resolve) => setTimeout(resolve, sleepMs));
+        }
+    }
+    throw new CliError(`Editor did not become idle within ${(options.timeoutMs / 1000).toFixed(1)}s; last blocking stage: ${lastStage} (${lastCause}).`, 'idle-wait-timeout', 3, true, {
+        stage: lastStage,
+        cause: lastCause,
+        attempts: attempt,
+    });
+}
+function remainingBudget(deadline, probeLimitMs, stage) {
+    const remainingMs = deadline - Date.now();
+    if (remainingMs <= 0) {
+        throw new CliError(`Idle wait budget exhausted at stage ${stage}.`, 'idle-wait-timeout', 3, true, {
+            stage,
+            cause: 'budget-exhausted',
+        });
+    }
+    return Math.min(probeLimitMs, remainingMs);
+}
+/** Internal control-flow marker for "not idle yet, sleep and re-probe". */
+class IdlePending extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'IdlePending';
+    }
+}
+function pendingError(message) {
+    return new IdlePending(message);
+}
+//# sourceMappingURL=idle-wait.js.map

package/dist/util/idle-wait.js.map

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

package/dist/util/input.d.ts

@@ -0,0 +1,10 @@
+/** Read a path or `-` as strict UTF-8. Invalid byte sequences are rejected. */
+export declare function readUtf8Source(source: string, optionName: string): string;
+/** Resolve mutually exclusive inline text and path/stdin text sources. */
+export declare function resolveTextInput(inline: unknown, source: unknown, inlineName: string, sourceName: string): string;
+/** Parse a complete JSON object from inline text or path/stdin. */
+export declare function resolveJsonObjectInput(inline: unknown, source: unknown, inlineName?: string, sourceName?: string): Record<string, unknown>;
+/** Resolve `@path` / `@-` before a generated structured-value parser runs. */
+export declare function expandStructuredReference(raw: string): string;
+/** Test hook; production processes normally consume stdin only once. */
+export declare function resetStdinCacheForTests(): void;

package/dist/util/input.js

@@ -0,0 +1,86 @@
+import { readFileSync, readSync } from 'node:fs';
+import { Buffer } from 'node:buffer';
+import { CliError } from './errors.js';
+let stdinBytes;
+/** Read a path or `-` as strict UTF-8. Invalid byte sequences are rejected. */
+export function readUtf8Source(source, optionName) {
+    let bytes;
+    try {
+        bytes = source === '-' ? readStdinBytesOnce() : readFileSync(source);
+    }
+    catch (err) {
+        throw new CliError(`Failed to read ${optionName} ${source}: ${err.message}`, 'input-read');
+    }
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    catch (err) {
+        throw new CliError(`${optionName} ${source} is not valid UTF-8: ${err.message}`, 'input-invalid-utf8');
+    }
+}
+/** Resolve mutually exclusive inline text and path/stdin text sources. */
+export function resolveTextInput(inline, source, inlineName, sourceName) {
+    const hasInline = typeof inline === 'string';
+    const hasSource = typeof source === 'string' && source.length > 0;
+    if (hasInline && hasSource) {
+        throw new CliError(`${inlineName} and ${sourceName} are mutually exclusive`, 'input-conflict');
+    }
+    if (hasSource)
+        return readUtf8Source(source, sourceName);
+    if (hasInline && inline.length > 0)
+        return inline;
+    throw new CliError(`Provide ${inlineName} or ${sourceName} <path|->`, 'input-required');
+}
+/** Parse a complete JSON object from inline text or path/stdin. */
+export function resolveJsonObjectInput(inline, source, inlineName = '--args', sourceName = '--args-file') {
+    const hasInline = typeof inline === 'string';
+    const hasSource = typeof source === 'string' && source.length > 0;
+    if (hasInline && hasSource) {
+        throw new CliError(`${inlineName} and ${sourceName} are mutually exclusive`, 'input-conflict');
+    }
+    const raw = hasSource
+        ? readUtf8Source(source, sourceName)
+        : hasInline
+            ? inline
+            : '{}';
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new CliError(`${hasSource ? sourceName : inlineName} must contain a JSON object`, 'args-not-object');
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new CliError(`Invalid JSON in ${hasSource ? sourceName : inlineName}: ${err.message}`, 'args-invalid-json');
+    }
+}
+/** Resolve `@path` / `@-` before a generated structured-value parser runs. */
+export function expandStructuredReference(raw) {
+    if (!raw.startsWith('@'))
+        return raw;
+    const source = raw.slice(1);
+    if (!source)
+        throw new CliError('Structured @ reference requires a path or @-', 'input-reference');
+    return readUtf8Source(source, '@reference');
+}
+function readStdinBytesOnce() {
+    if (stdinBytes !== undefined)
+        return stdinBytes;
+    const chunks = [];
+    const buffer = Buffer.alloc(64 * 1024);
+    while (true) {
+        const bytes = readSync(0, buffer, 0, buffer.length, null);
+        if (bytes === 0)
+            break;
+        chunks.push(Buffer.from(buffer.subarray(0, bytes)));
+    }
+    stdinBytes = Buffer.concat(chunks);
+    return stdinBytes;
+}
+/** Test hook; production processes normally consume stdin only once. */
+export function resetStdinCacheForTests() {
+    stdinBytes = undefined;
+}
+//# sourceMappingURL=input.js.map

package/dist/util/input.js.map

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

package/dist/util/multi-select.d.ts

@@ -0,0 +1,29 @@
+export interface MultiSelectChoice {
+    value: string;
+    label: string;
+    /** Checked by default; an empty Enter answer resolves to exactly these. */
+    preSelected: boolean;
+    /** Listed with a "detected" marker (advisory presence at the target). */
+    detected?: boolean;
+}
+export interface MultiSelectOptions {
+    message: string;
+    choices: readonly MultiSelectChoice[];
+    /** Defaults to `process.stdin`; injectable for tests. */
+    input?: NodeJS.ReadableStream;
+    /** Defaults to `process.stderr`; injectable for tests. */
+    output?: NodeJS.WritableStream;
+}
+export interface MultiSelectResult {
+    /** Selected values in choice order. */
+    selected: string[];
+    /** The raw answer line that produced the selection. */
+    answer: string;
+}
+/** The user explicitly chose nothing (`none`, or Enter with nothing pre-selected). */
+export declare class EmptyMultiSelectionError extends Error {
+    constructor(message: string);
+}
+export declare function promptMultiSelect(options: MultiSelectOptions): Promise<MultiSelectResult>;
+/** Parse one answer line. Throws EmptyMultiSelectionError for `none`. */
+export declare function parseAnswer(answer: string, choices: readonly MultiSelectChoice[]): string[];

package/dist/util/multi-select.js

@@ -0,0 +1,108 @@
+// A numbered multi-select prompt built on Node's built-in readline — no new
+// runtime dependency (uco bundles its deps into the tgz; a prompt library
+// is not worth the bytes). Rendering goes to stderr so stdout stays clean for
+// JSON output.
+//
+// Answer grammar: a comma-separated list of numbers (`1,3,5`), `all`, `none`,
+// or an empty line to accept the pre-selected set. Selection requires at
+// least one choice; an explicit `none` (or an empty answer with nothing
+// pre-selected) fails with {@link EmptyMultiSelectionError} so the command
+// can surface "at least one agent must be selected".
+import * as readline from 'node:readline';
+import process from 'node:process';
+import kleur from 'kleur';
+/** The user explicitly chose nothing (`none`, or Enter with nothing pre-selected). */
+export class EmptyMultiSelectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EmptyMultiSelectionError';
+    }
+}
+export async function promptMultiSelect(options) {
+    if (options.choices.length === 0) {
+        throw new EmptyMultiSelectionError('Nothing to select: the choice list is empty.');
+    }
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stderr;
+    const preSelectedIndexes = options.choices
+        .map((choice, index) => (choice.preSelected ? index + 1 : 0))
+        .filter((index) => index > 0);
+    const lines = [
+        `${options.message}`,
+        ...options.choices.map((choice, index) => {
+            const marker = choice.preSelected
+                ? kleur.green('(pre-selected)')
+                : choice.detected
+                    ? kleur.yellow('(detected)')
+                    : '';
+            const markerText = marker ? ` ${marker}` : '';
+            return `  ${kleur.cyan(String(index + 1).padStart(2))}. ${choice.label}${markerText}`;
+        }),
+    ];
+    const hint = preSelectedIndexes.length > 0
+        ? kleur.dim(`Enter to accept [${preSelectedIndexes.join(',')}]`)
+        : kleur.dim('Enter is not a shortcut here — nothing is pre-selected');
+    const promptLine = `Answer with numbers (e.g. 1,3), 'all', 'none' — ${hint}: `;
+    const rl = readline.createInterface({ input, output, terminal: false });
+    const write = (line) => {
+        output.write(line + '\n');
+    };
+    try {
+        write(lines.join('\n'));
+        for (;;) {
+            const answer = await new Promise((resolve) => {
+                rl.question(promptLine, (value) => resolve(value));
+            });
+            try {
+                return { selected: parseAnswer(answer, options.choices), answer: answer.trim() };
+            }
+            catch (error) {
+                if (error instanceof EmptyMultiSelectionError)
+                    throw error;
+                write(kleur.yellow(`  ${error instanceof Error ? error.message : String(error)}`));
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Parse one answer line. Throws EmptyMultiSelectionError for `none`. */
+export function parseAnswer(answer, choices) {
+    const trimmed = answer.trim();
+    if (trimmed === '') {
+        const preSelected = choices.filter((choice) => choice.preSelected).map((choice) => choice.value);
+        if (preSelected.length === 0) {
+            throw new EmptyMultiSelectionError('At least one option must be selected.');
+        }
+        return preSelected;
+    }
+    const normalized = trimmed.toLowerCase();
+    if (normalized === 'all') {
+        return choices.map((choice) => choice.value);
+    }
+    if (normalized === 'none') {
+        throw new EmptyMultiSelectionError('At least one option must be selected.');
+    }
+    const tokens = trimmed.split(/[,\s]+/).filter((token) => token.length > 0);
+    if (tokens.some((token) => token.toLowerCase() === 'all' || token.toLowerCase() === 'none')) {
+        throw new Error(`'all' and 'none' cannot be combined with numbers — answer again, e.g. 1,3.`);
+    }
+    const indexes = [];
+    for (const token of tokens) {
+        if (!/^\d+$/.test(token)) {
+            throw new Error(`Not a number: "${token}" — answer again, e.g. 1,3, or 'all' / 'none'.`);
+        }
+        const index = Number.parseInt(token, 10);
+        if (index < 1 || index > choices.length) {
+            throw new Error(`No option ${index} (valid: 1-${choices.length}) — answer again.`);
+        }
+        if (!indexes.includes(index - 1))
+            indexes.push(index - 1);
+    }
+    if (indexes.length === 0) {
+        throw new EmptyMultiSelectionError('At least one option must be selected.');
+    }
+    return indexes.sort((left, right) => left - right).map((index) => choices[index].value);
+}
+//# sourceMappingURL=multi-select.js.map

package/dist/util/multi-select.js.map

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

package/dist/util/operation-wait.d.ts

@@ -0,0 +1,35 @@
+import type { UnityCoTransport } from '../transport/index.js';
+export interface OperationWaitOptions {
+    /** Absolute bound for the whole wait. */
+    timeoutMs: number;
+    /** Poll interval (default 1s, reusing the readiness interval discipline). */
+    intervalMs?: number;
+}
+export interface TerminalOperation {
+    record: Record<string, unknown>;
+    operationId: string;
+    status: string;
+}
+/** Follow the first record that carries a durable operation handle. */
+export declare function extractOperationHandle(result: unknown): {
+    operationId: string;
+} | undefined;
+export interface InitialOperationState {
+    operationId?: string;
+    /** Terminal status already present in the initial response payload, if any. */
+    terminalStatus?: string;
+}
+/**
+ * Inspect an initial tool-call response for a durable handle and/or an
+ * already-terminal status. `--wait` uses this to degrade gracefully: a call
+ * that returned its final answer inline (older non-durable tools, fast
+ * failures) must not be reported as a wait-protocol error.
+ */
+export declare function inspectInitialOperationState(result: unknown): InitialOperationState;
+/**
+ * Poll `editor-operation-get` until the operation reaches a terminal status.
+ * Resolves with the terminal record (the envelope to print); throws the
+ * documented wait-timeout failure (exit 3) with the last observed status and
+ * phase when the bound expires.
+ */
+export declare function waitForDurableOperation(transport: UnityCoTransport, result: unknown, options: OperationWaitOptions): Promise<TerminalOperation>;

package/dist/util/operation-wait.js

@@ -0,0 +1,96 @@
+// Terminal-state wait for durable operations (COCli-03) — after a tool call
+// returns a durable operation handle, poll the authoritative record through
+// the generic operation query surface until a terminal status or a caller
+// bound, then hand the terminal envelope back so the CLI exits by the
+// documented map without caller-side polling loops.
+import { CliError } from './errors.js';
+import { toolPayloadRecords, unwrapToolPayload } from './tool-payload.js';
+const DEFAULT_INTERVAL_MS = 1_000;
+/** Follow the first record that carries a durable operation handle. */
+export function extractOperationHandle(result) {
+    for (const payload of toolPayloadRecords(result)) {
+        const operationId = readOperationId(payload);
+        if (operationId !== undefined)
+            return { operationId };
+    }
+    return undefined;
+}
+function readOperationId(record) {
+    const value = record['OperationId'] ?? record['operationId'];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function readString(record, ...keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+function isTerminalStatus(status) {
+    return status === 'succeeded' || status === 'failed'
+        || status === 'cancelled' || status === 'interrupted';
+}
+/**
+ * Inspect an initial tool-call response for a durable handle and/or an
+ * already-terminal status. `--wait` uses this to degrade gracefully: a call
+ * that returned its final answer inline (older non-durable tools, fast
+ * failures) must not be reported as a wait-protocol error.
+ */
+export function inspectInitialOperationState(result) {
+    for (const payload of toolPayloadRecords(result)) {
+        const operationId = readOperationId(payload);
+        const status = readString(payload, 'Status', 'status');
+        if (operationId !== undefined) {
+            return { operationId, terminalStatus: isTerminalStatus(status) ? status : undefined };
+        }
+        if (isTerminalStatus(status)) {
+            return { terminalStatus: status };
+        }
+    }
+    return {};
+}
+/**
+ * Poll `editor-operation-get` until the operation reaches a terminal status.
+ * Resolves with the terminal record (the envelope to print); throws the
+ * documented wait-timeout failure (exit 3) with the last observed status and
+ * phase when the bound expires.
+ */
+export async function waitForDurableOperation(transport, result, options) {
+    const handle = extractOperationHandle(result);
+    if (handle === undefined) {
+        throw new CliError('The call did not return a durable operation handle; --wait needs an operationId to poll.', 'operation-wait-invalid', 1, false);
+    }
+    const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+    const deadline = Date.now() + options.timeoutMs;
+    let lastStatus = 'unknown';
+    let lastPhase = 'unknown';
+    while (true) {
+        const query = await transport.callTool('editor-operation-get', {
+            operationId: handle.operationId,
+        });
+        const record = unwrapToolPayload(query);
+        const status = readString(record, 'Status', 'status');
+        const phase = readString(record, 'Phase', 'phase');
+        if (status !== undefined)
+            lastStatus = status;
+        if (phase !== undefined)
+            lastPhase = phase;
+        if (readOperationId(record) === undefined && Object.keys(record).length === 0) {
+            throw new CliError(`Editor operation '${handle.operationId}' was not found while waiting.`, 'operation_not_found', 4, false, { operationId: handle.operationId });
+        }
+        if (isTerminalStatus(status)) {
+            return { record, operationId: handle.operationId, status: status };
+        }
+        const remainingMs = deadline - Date.now();
+        if (remainingMs <= 0) {
+            throw new CliError(`Operation '${handle.operationId}' did not reach a terminal state within ${(options.timeoutMs / 1000).toFixed(1)}s; last status: ${lastStatus} (${lastPhase}).`, 'operation-wait-timeout', 3, true, {
+                operationId: handle.operationId,
+                lastStatus,
+                lastPhase,
+            });
+        }
+        await new Promise((resolve) => setTimeout(resolve, Math.min(intervalMs, remainingMs)));
+    }
+}
+//# sourceMappingURL=operation-wait.js.map

package/dist/util/operation-wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-wait.js","sourceRoot":"","sources":["../../src/util/operation-wait.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,sEAAsE;AACtE,oDAAoD;AAGpD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAe1E,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CAAC,MAAe;IACpD,KAAK,MAAM,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,MAA+B;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU,CAAC,MAA+B,EAAE,GAAG,IAAc;IACpE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA0B;IAClD,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ;WAC/C,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,aAAa,CAAC;AAC1D,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAe;IAC1D,KAAK,MAAM,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACxF,CAAC;QACD,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAA2B,EAC3B,MAAe,EACf,OAA6B;IAE7B,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAChB,0FAA0F,EAC1F,wBAAwB,EACxB,CAAC,EACD,KAAK,CACN,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAChD,IAAI,UAAU,GAAG,SAAS,CAAC;IAC3B,IAAI,SAAS,GAAG,SAAS,CAAC;IAE1B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE;YAC7D,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS;YAAE,UAAU,GAAG,MAAM,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS,GAAG,KAAK,CAAC;QAE3C,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,QAAQ,CAChB,qBAAqB,MAAM,CAAC,WAAW,gCAAgC,EACvE,qBAAqB,EACrB,CAAC,EACD,KAAK,EACL,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CACpC,CAAC;QACJ,CAAC;QACD,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAO,EAAE,CAAC;QACtE,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,QAAQ,CAChB,cAAc,MAAM,CAAC,WAAW,2CAA2C,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,UAAU,KAAK,SAAS,IAAI,EAC/J,wBAAwB,EACxB,CAAC,EACD,IAAI,EACJ;gBACE,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU;gBACV,SAAS;aACV,CACF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;AACH,CAAC"}

package/dist/util/output.d.ts

@@ -0,0 +1,8 @@
+export interface OutputContext {
+    json: boolean;
+    verbose: boolean;
+}
+export declare function printResult(ctx: OutputContext, data: unknown): void;
+export declare function printError(ctx: OutputContext, err: unknown): void;
+export declare function printInfo(ctx: OutputContext, msg: string): void;
+export declare function serializeError(err: unknown): Record<string, unknown>;