@atelierai/uco 1.0.0

package/dist/util/output.js

@@ -0,0 +1,302 @@
+// Output formatting — JSON for machines, pretty for humans.
+//
+// Commands return data; the CLI shell chooses format based on the global
+// --json flag. JSON output is stable contract for agents and scripts.
+import kleur from 'kleur';
+import { TransportError, CliError } from './errors.js';
+import { redactSensitiveText, redactSensitiveValue } from './redaction.js';
+export function printResult(ctx, data) {
+    if (ctx.json) {
+        process.stdout.write(JSON.stringify(redactSensitiveValue(data), null, 2) + '\n');
+        return;
+    }
+    printPretty(data);
+}
+export function printError(ctx, err) {
+    if (ctx.json) {
+        const payload = serializeError(err);
+        process.stderr.write(JSON.stringify(payload, null, 2) + '\n');
+        return;
+    }
+    if (err instanceof Error) {
+        process.stderr.write(kleur.red('Error: ') + redactSensitiveText(displayMessage(err)) + '\n');
+        if (ctx.verbose && err.stack)
+            process.stderr.write(redactSensitiveText(err.stack) + '\n');
+        const extra = err.toJSON?.();
+        if (extra && typeof extra === 'object') {
+            process.stderr.write(kleur.gray(JSON.stringify(redactSensitiveValue(extra), null, 2)) + '\n');
+            const retry = confirmationRetry(extra);
+            if (retry !== undefined)
+                process.stderr.write(kleur.yellow(`Retry: ${retry}\n`));
+            const hint = transportHint(extra);
+            if (hint !== undefined)
+                process.stderr.write(kleur.yellow(`Hint: ${redactSensitiveText(hint)}\n`));
+        }
+    }
+    else {
+        process.stderr.write(kleur.red('Error: ') + redactSensitiveText(String(err)) + '\n');
+    }
+}
+export function printInfo(ctx, msg) {
+    if (ctx.json)
+        return; // info messages are noise in JSON mode
+    process.stderr.write(kleur.gray(redactSensitiveText(msg)) + '\n');
+}
+function printPretty(data) {
+    if (data === undefined || data === null) {
+        process.stdout.write('(no data)\n');
+        return;
+    }
+    if (typeof data === 'string') {
+        process.stdout.write(redactSensitiveText(data) + '\n');
+        return;
+    }
+    if (typeof data === 'number' || typeof data === 'boolean') {
+        process.stdout.write(String(data) + '\n');
+        return;
+    }
+    process.stdout.write(JSON.stringify(redactSensitiveValue(data), null, 2) + '\n');
+}
+export function serializeError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const serialized = serializedErrorDetails(err);
+    const code = errorCode(err, serialized);
+    const retryable = err instanceof CliError
+        ? err.retryable
+        : err instanceof TransportError && ['timeout', 'connection-refused', 'connection-reset', 'dns'].includes(err.kind)
+            || httpBodyRetryable(err);
+    const details = err instanceof CliError && err.details !== undefined
+        ? err.details
+        : removeEnvelopeFields(serialized);
+    const error = {
+        code,
+        message: redactSensitiveText(message),
+        retryable,
+        ...(details !== undefined && !isEmptyRecord(details)
+            ? { details: redactSensitiveValue(details) }
+            : {}),
+    };
+    // Timeout semantics (COCli-09): an observed transport timeout never means
+    // the tool did not run — the plugin keeps executing after the CLI stops
+    // waiting. Say so explicitly and point at the durable call record when the
+    // logical call id is known, so automation does not blindly retry a
+    // side-effecting call.
+    if (err instanceof TransportError && err.kind === 'timeout') {
+        const callId = err.callId;
+        const mergedDetails = asRecord(error['details']) ?? {};
+        error['details'] = {
+            ...mergedDetails,
+            resultUnknown: true,
+            ...(callId !== undefined ? { callId } : {}),
+        };
+        error['message'] = callId !== undefined
+            ? `${message} — result unknown: the tool may still be running in the Unity Editor. Check \`uco call get ${callId}\` before retrying.`
+            : `${message} — result unknown: the tool may still be running in the Unity Editor. Find the call with \`uco call list\` before retrying.`;
+    }
+    // Structured control failures carry logical-call identity at the same
+    // positions as the server's wire error; mirror them so a cancelled or
+    // deadline-exceeded envelope identifies its logical call without digging
+    // through `details`.
+    const structuredCallId = typeof serialized['callId'] === 'string' ? serialized['callId'] : undefined;
+    const structuredCorrelationId = typeof serialized['correlationId'] === 'string' ? serialized['correlationId'] : undefined;
+    if (structuredCallId !== undefined)
+        error['callId'] = structuredCallId;
+    if (structuredCorrelationId !== undefined)
+        error['correlationId'] = structuredCorrelationId;
+    // Retry continuity (COCli-02): a confirmation-retryable failure always
+    // exposes `error.requestId` plus a redaction-bounded, size-capped
+    // `error.details.retryWith` so automation resumes without parsing the
+    // human-readable `Retry:` hint.
+    if (code === 'confirmation_required') {
+        const continuity = retryContinuity(details ?? serialized);
+        if (continuity.requestId !== undefined)
+            error['requestId'] = continuity.requestId;
+        if (continuity.retryWith !== undefined) {
+            const merged = asRecord(error['details']) ?? {};
+            error['details'] = { ...merged, retryWith: continuity.retryWith };
+        }
+    }
+    return { ok: false, error };
+}
+/**
+ * Locate the retry inputs for a confirmation-retryable failure. The upstream
+ * control failure nests them as `details.retryWith = { requestID, control }`;
+ * CliError details may carry one less or one more envelope level, so both
+ * shapes are probed. Values are redaction-checked and size-capped before
+ * being surfaced at the documented positions.
+ */
+function retryContinuity(details) {
+    const retryWith = asRecord(asRecord(details)?.['retryWith'])
+        ?? asRecord(asRecord(asRecord(details)?.['details'])?.['retryWith'])
+        ?? asRecord(asRecord(asRecord(asRecord(details)?.['details'])?.['details'])?.['retryWith']);
+    if (retryWith === undefined)
+        return {};
+    const requestId = retryWith['requestID'] ?? retryWith['requestId'];
+    if (typeof requestId !== 'string' || requestId.length === 0)
+        return {};
+    if (!boundedSafeValue(retryWith)) {
+        // Keep the resume id but drop an oversized control payload rather than
+        // emit an unbounded envelope member.
+        return { requestId, retryWith: { requestID: requestId, control: { omitted: 'size-exceeded' } } };
+    }
+    return { requestId, retryWith: redactSensitiveValue(retryWith) };
+}
+function serializedErrorDetails(err) {
+    if (err && typeof err === 'object' && 'toJSON' in err && typeof err.toJSON === 'function') {
+        const value = err.toJSON();
+        return value && typeof value === 'object' && !Array.isArray(value)
+            ? value
+            : {};
+    }
+    return {};
+}
+function errorCode(err, details) {
+    if (err instanceof CliError)
+        return err.code;
+    if (err instanceof TransportError)
+        return `transport-${err.kind}`;
+    if (typeof details['code'] === 'string')
+        return details['code'];
+    if (typeof details['kind'] === 'string')
+        return String(details['kind']);
+    return 'unexpected-error';
+}
+function removeEnvelopeFields(details) {
+    const result = Object.fromEntries(Object.entries(details).filter(([key]) => !['error', 'code', 'message', 'retryable'].includes(key)));
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+const MAX_RETRY_COMMAND_BYTES = 16_384;
+const MAX_RETRY_DEPTH = 6;
+const MAX_RETRY_MEMBERS = 48;
+const MAX_RETRY_ARRAY_ITEMS = 32;
+const MAX_RETRY_NODES = 256;
+const MAX_RETRY_STRING_LENGTH = 160;
+function confirmationRetry(value) {
+    const root = asRecord(value);
+    const body = asRecord(root?.['body']);
+    const nested = asRecord(body?.['error']);
+    const error = nested?.['code'] === 'confirmation_required'
+        ? nested
+        : root?.['code'] === 'confirmation_required' ? root : undefined;
+    if (error === undefined)
+        return undefined;
+    const details = asRecord(error['details']);
+    const retryWith = asRecord(details?.['retryWith']);
+    const control = asRecord(retryWith?.['control']);
+    const token = asRecord(control?.['confirmation']);
+    const requestID = retryWith?.['requestID'];
+    if (control === undefined || typeof requestID !== 'string')
+        return undefined;
+    if (control['confirm'] !== true || control['dryRun'] !== 'none' || token === undefined)
+        return undefined;
+    if (typeof token['planId'] !== 'string' || typeof token['planHash'] !== 'string'
+        || typeof token['expiresAtUnixMs'] !== 'number')
+        return undefined;
+    if (!boundedSafeValue(retryWith))
+        return undefined;
+    const controlJson = JSON.stringify(control);
+    const command = `--request-id ${quoteCliValue(requestID)} --control ${quoteCliValue(controlJson)}`;
+    return Buffer.byteLength(command, 'utf8') <= MAX_RETRY_COMMAND_BYTES ? command : undefined;
+}
+function boundedSafeValue(value) {
+    let remainingNodes = MAX_RETRY_NODES;
+    const visit = (entry, depth) => {
+        if (depth > MAX_RETRY_DEPTH || --remainingNodes < 0)
+            return false;
+        if (typeof entry === 'string') {
+            return entry.length <= MAX_RETRY_STRING_LENGTH && redactSensitiveText(entry) === entry;
+        }
+        if (entry === null || typeof entry === 'number' || typeof entry === 'boolean')
+            return true;
+        if (Array.isArray(entry)) {
+            return entry.length <= MAX_RETRY_ARRAY_ITEMS && entry.every((item) => visit(item, depth + 1));
+        }
+        const record = asRecord(entry);
+        if (record === undefined)
+            return false;
+        const entries = Object.entries(record);
+        if (entries.length > MAX_RETRY_MEMBERS)
+            return false;
+        return entries.every(([key, item]) => key.length <= MAX_RETRY_STRING_LENGTH
+            && JSON.stringify(redactSensitiveValue({ [key]: item })) === JSON.stringify({ [key]: item })
+            && visit(item, depth + 1));
+    };
+    return visit(value, 0);
+}
+function quoteCliValue(value) {
+    return `'${value.replace(/'/g, "'\"'\"'")}'`;
+}
+function asRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+const GENERIC_FAILURE_MESSAGES = new Set([
+    'Tool call failed.',
+    'Tool execution failed.',
+    'Tool call failed for tool.',
+]);
+/**
+ * Human-mode headline: when the transport message is a generic placeholder
+ * ("HTTP 500", "Tool call failed."), surface the bounded diagnostic the
+ * failure actually carried (tool error text, exception message, compile
+ * error) instead of making the user dig through details.
+ */
+function displayMessage(err) {
+    if (err instanceof TransportError && err.kind === 'http') {
+        const bodyMessage = asRecord(asRecord(err.body)?.['error'])?.['message'];
+        if (typeof bodyMessage === 'string' && bodyMessage.trim().length > 0
+            && !GENERIC_FAILURE_MESSAGES.has(bodyMessage)) {
+            return bodyMessage;
+        }
+    }
+    if (!GENERIC_FAILURE_MESSAGES.has(err.message))
+        return err.message;
+    const serialized = serializedErrorDetails(err);
+    const diagnostic = firstDiagnosticText(serialized)
+        ?? firstDiagnosticText(asRecord(err instanceof TransportError ? err.body : undefined)?.['error']);
+    return diagnostic !== undefined && diagnostic.length > 0 ? diagnostic : err.message;
+}
+/** First bounded actionable text inside a structured error envelope. */
+function firstDiagnosticText(envelope) {
+    const record = asRecord(envelope);
+    if (record === undefined)
+        return undefined;
+    const details = asRecord(record['details']);
+    const candidates = [
+        typeof record['diagnostic'] === 'string' ? record['diagnostic'] : undefined,
+        typeof details?.['diagnostic'] === 'string' ? details['diagnostic'] : undefined,
+        typeof details?.['exceptionMessage'] === 'string' ? details['exceptionMessage'] : undefined,
+        typeof record['exceptionMessage'] === 'string' ? record['exceptionMessage'] : undefined,
+    ];
+    for (const candidate of candidates) {
+        if (candidate === undefined)
+            continue;
+        const trimmed = candidate.trim();
+        if (trimmed.length > 0 && !GENERIC_FAILURE_MESSAGES.has(trimmed))
+            return trimmed;
+    }
+    return undefined;
+}
+/** Server-provided hint from a normalized HTTP error body. */
+function transportHint(extra) {
+    const record = asRecord(extra);
+    const body = asRecord(record?.['body']);
+    const hint = asRecord(body?.['error'])?.['hint'] ?? asRecord(body?.['error'])?.['details'];
+    const hintText = asRecord(hint)?.['hint'];
+    return typeof hintText === 'string' && hintText.length > 0 ? hintText : undefined;
+}
+/** Honor an explicit retryable classification from a normalized HTTP body. */
+function httpBodyRetryable(err) {
+    if (!(err instanceof TransportError) || err.kind !== 'http')
+        return false;
+    const retryable = asRecord(asRecord(err.body)?.['error'])?.['retryable'];
+    return retryable === true;
+}
+function isEmptyRecord(value) {
+    return value !== null
+        && typeof value === 'object'
+        && !Array.isArray(value)
+        && Object.keys(value).length === 0;
+}
+//# sourceMappingURL=output.js.map

package/dist/util/output.js.map

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

package/dist/util/readiness.d.ts

@@ -0,0 +1,18 @@
+import { TransportError } from './errors.js';
+export declare const READINESS_STAGES: readonly ["process", "http", "webSocket", "handshake", "capabilities", "toolRunner"];
+export interface RegistrationReadiness {
+    ready: boolean;
+    stage: string;
+    cause: string;
+}
+/** Evaluate the server-side bridge stages from a readiness health response. */
+export declare function registrationReadiness(value: unknown): RegistrationReadiness;
+export declare function stageReason(value: unknown): string;
+export declare function editorReadiness(value: unknown): {
+    ready: boolean;
+    stage: 'editor' | 'probe';
+    cause: string;
+};
+export declare function failureCause(record: Record<string, unknown>): string;
+export declare function transportStage(error: TransportError): string;
+export declare function asRecord(value: unknown): Record<string, unknown> | undefined;

package/dist/util/readiness.js

@@ -0,0 +1,129 @@
+// Shared readiness-stage evaluation — the single source for both
+// `uco wait-for-ready` and the post-call idle wait so the two waits can
+// never disagree about what "idle" means.
+import { toolPayloadRecords } from './tool-payload.js';
+export const READINESS_STAGES = ['process', 'http', 'webSocket', 'handshake', 'capabilities', 'toolRunner'];
+/** Evaluate the server-side bridge stages from a readiness health response. */
+export function registrationReadiness(value) {
+    const record = asRecord(value);
+    if (record === undefined) {
+        return { ready: false, stage: 'http', cause: 'invalid-health-response' };
+    }
+    const stages = asRecord(record['stages']);
+    if (stages === undefined) {
+        return { ready: false, stage: 'http', cause: 'missing-health-stages' };
+    }
+    for (const stage of READINESS_STAGES) {
+        const entry = asRecord(stages[stage]);
+        if (entry?.['ready'] !== true) {
+            return { ready: false, stage, cause: stageReason(entry) };
+        }
+    }
+    return { ready: true, stage: 'toolRunner', cause: 'ready' };
+}
+export function stageReason(value) {
+    if (value && typeof value === 'object') {
+        const reason = value['reason'];
+        if (typeof reason === 'string' && reason)
+            return reason;
+    }
+    return 'not-ready';
+}
+export function editorReadiness(value) {
+    const records = [...toolPayloadRecords(value)];
+    for (const record of records) {
+        if (record['Ok'] === false || record['ok'] === false) {
+            return { ready: false, stage: 'probe', cause: failureCause(record) };
+        }
+    }
+    const candidate = records.reverse().find(hasEditorStateKey);
+    if (candidate === undefined) {
+        return { ready: false, stage: 'editor', cause: 'invalid-editor-state' };
+    }
+    const readiness = records
+        .map((record) => asRecord(record['Readiness'] ?? record['readiness']))
+        .find((record) => record !== undefined);
+    if (readiness !== undefined) {
+        const state = readString(readiness, 'State', 'state');
+        const ready = readBoolean(readiness, 'Ready', 'ready');
+        if (state === undefined || ready === undefined) {
+            return { ready: false, stage: 'editor', cause: 'invalid-readiness-snapshot' };
+        }
+        if (!ready || state !== 'ready') {
+            return { ready: false, stage: 'editor', cause: state };
+        }
+        return { ready: true, stage: 'probe', cause: 'ready' };
+    }
+    const required = {
+        isPlaying: readBoolean(candidate, 'IsPlaying', 'isPlaying'),
+        isPaused: readBoolean(candidate, 'IsPaused', 'isPaused'),
+        isCompiling: readBoolean(candidate, 'IsCompiling', 'isCompiling'),
+        isUpdating: readBoolean(candidate, 'IsUpdating', 'isUpdating'),
+        isPlayingOrWillChange: readBoolean(candidate, 'IsPlayingOrWillChangePlaymode', 'IsPlayingOrWillChangePlayMode', 'isPlayingOrWillChangePlaymode', 'isPlayingOrWillChangePlayMode'),
+    };
+    const missing = Object.entries(required)
+        .filter(([, entry]) => entry === undefined)
+        .map(([key]) => key);
+    if (missing.length > 0) {
+        return { ready: false, stage: 'editor', cause: `missing-editor-state-fields:${missing.join(',')}` };
+    }
+    if (required.isCompiling)
+        return { ready: false, stage: 'editor', cause: 'compiling' };
+    if (required.isUpdating)
+        return { ready: false, stage: 'editor', cause: 'updating-or-importing' };
+    if (readBoolean(candidate, 'IsImporting', 'isImporting') === true) {
+        return { ready: false, stage: 'editor', cause: 'importing' };
+    }
+    if (readBoolean(candidate, 'IsReloading', 'isReloading') === true) {
+        return { ready: false, stage: 'editor', cause: 'domain-reloading' };
+    }
+    if (required.isPlaying !== required.isPlayingOrWillChange) {
+        return { ready: false, stage: 'editor', cause: 'play-mode-transition' };
+    }
+    const blockers = readStringArray(candidate, 'Blockers', 'blockers');
+    const transitionBlocker = blockers?.find((entry) => /compil|updat|import|reload|transition/i.test(entry));
+    if (transitionBlocker !== undefined) {
+        return { ready: false, stage: 'editor', cause: transitionBlocker };
+    }
+    return { ready: true, stage: 'probe', cause: 'ready' };
+}
+export function failureCause(record) {
+    const detail = [record['Error'], record['error'], record['Message'], record['message']]
+        .find((entry) => typeof entry === 'string' && entry.trim().length > 0);
+    return detail === undefined ? 'editor-probe-failed' : `editor-probe-failed:${detail}`;
+}
+export function transportStage(error) {
+    return error.kind === 'http' ? 'http' : 'process';
+}
+export function asRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function hasEditorStateKey(record) {
+    return ['IsPlaying', 'isPlaying', 'IsCompiling', 'isCompiling', 'IsUpdating', 'isUpdating']
+        .some((key) => key in record);
+}
+function readBoolean(record, ...keys) {
+    for (const key of keys) {
+        if (typeof record[key] === 'boolean')
+            return record[key];
+    }
+    return undefined;
+}
+function readString(record, ...keys) {
+    for (const key of keys) {
+        if (typeof record[key] === 'string' && record[key])
+            return record[key];
+    }
+    return undefined;
+}
+function readStringArray(record, ...keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (Array.isArray(value) && value.every((entry) => typeof entry === 'string'))
+            return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=readiness.js.map

package/dist/util/readiness.js.map

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

package/dist/util/redaction.d.ts

@@ -0,0 +1,3 @@
+/** Remove credential material without needing the original secret value. */
+export declare function redactSensitiveValue(value: unknown): unknown;
+export declare function redactSensitiveText(value: string): string;

package/dist/util/redaction.js

@@ -0,0 +1,59 @@
+const REDACTED = '[REDACTED]';
+const SENSITIVE_KEY = /^(?:access[-_]?token|authorization|bearer|token|password|secret|api[-_]?key|android[-_]?(?:keystore|key[-_]?alias)[-_]?(?:base64|password))$/i;
+const SENSITIVE_OPTION = /^-{1,2}(?:access[-_]?token|token|password|secret|api[-_]?key|android-(?:keystore-base64|keystore-password|key-alias-password))$/i;
+/** Remove credential material without needing the original secret value. */
+export function redactSensitiveValue(value) {
+    return visit(value, new WeakSet());
+}
+export function redactSensitiveText(value) {
+    let result = value;
+    result = result.replace(/(\bAuthorization\s*:\s*Bearer\s+)[^\s,;"']+/gi, `$1${REDACTED}`);
+    result = result.replace(/(\bBearer\s+)[A-Za-z0-9._~+/=-]+/gi, `$1${REDACTED}`);
+    result = result.replace(/((?:[?&]|\b)(?:access_token|accessToken|token|api_key)=)[^&#\s"']+/gi, `$1${encodeURIComponent(REDACTED)}`);
+    result = result.replace(/("(?:accessToken|access_token|authorization|token|password|secret|apiKey|api_key)"\s*:\s*")[^"]*(")/gi, `$1${REDACTED}$2`);
+    result = result.replace(/((?:^|\s)-{1,2}(?:accessToken|access-token|token|password|secret|api-key|android-(?:keystore-base64|keystore-password|key-alias-password))(?:=|\s+))(?:(?!\s-{1,2})[^\r\n])+/gi, `$1${REDACTED}`);
+    return result;
+}
+function visit(value, seen, key) {
+    if (key !== undefined && SENSITIVE_KEY.test(normalizeKey(key)))
+        return REDACTED;
+    if (typeof value === 'string')
+        return redactSensitiveText(value);
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (seen.has(value))
+        return '[Circular]';
+    seen.add(value);
+    if (Array.isArray(value)) {
+        const output = [];
+        for (let index = 0; index < value.length; index += 1) {
+            const entry = value[index];
+            if (typeof entry === 'string' && SENSITIVE_OPTION.test(entry.split('=', 1)[0] ?? entry)) {
+                const equals = entry.indexOf('=');
+                if (equals >= 0) {
+                    output.push(`${entry.slice(0, equals + 1)}${REDACTED}`);
+                }
+                else {
+                    output.push(entry);
+                    if (index + 1 < value.length) {
+                        output.push(REDACTED);
+                        index += 1;
+                    }
+                }
+            }
+            else {
+                output.push(visit(entry, seen));
+            }
+        }
+        return output;
+    }
+    const output = {};
+    for (const [entryKey, entryValue] of Object.entries(value)) {
+        output[entryKey] = visit(entryValue, seen, entryKey);
+    }
+    return output;
+}
+function normalizeKey(key) {
+    return key.replace(/[._\s]/g, '-');
+}
+//# sourceMappingURL=redaction.js.map

package/dist/util/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/util/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,YAAY,CAAC;AAC9B,MAAM,aAAa,GAAG,+IAA+I,CAAC;AACtK,MAAM,gBAAgB,GAAG,kIAAkI,CAAC;AAE5J,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,OAAO,EAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,+CAA+C,EAAE,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC1F,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,oCAAoC,EAAE,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC/E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,sEAAsE,EAAE,KAAK,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrI,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uGAAuG,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC;IACpJ,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gLAAgL,EAAE,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC3N,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,KAAK,CAAC,KAAc,EAAE,IAAqB,EAAE,GAAY;IAChE,IAAI,GAAG,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACxF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;oBAChB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC;gBAC1D,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACnB,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;wBAC7B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBACtB,KAAK,IAAI,CAAC,CAAC;oBACb,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QACtF,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/dist/util/timeout.d.ts

@@ -0,0 +1,9 @@
+/** Maximum delay accepted by Node's timer APIs without truncation. */
+export declare const MAX_TIMER_MILLISECONDS = 2147483647;
+export declare const MAX_TIMER_SECONDS: number;
+export declare function parseBoundedInteger(raw: string, options: {
+    option: string;
+    unit: 'milliseconds' | 'seconds';
+    maximum: number;
+    code?: string;
+}): number;

package/dist/util/timeout.js

@@ -0,0 +1,16 @@
+import { CliError } from './errors.js';
+/** Maximum delay accepted by Node's timer APIs without truncation. */
+export const MAX_TIMER_MILLISECONDS = 2_147_483_647;
+export const MAX_TIMER_SECONDS = Math.floor(MAX_TIMER_MILLISECONDS / 1_000);
+export function parseBoundedInteger(raw, options) {
+    const message = `Invalid ${options.option}: ${raw}. Expected an integer in ${options.unit} from 1 to ${options.maximum}.`;
+    if (!/^[0-9]+$/.test(raw)) {
+        throw new CliError(message, options.code ?? 'invalid-timeout');
+    }
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value < 1 || value > options.maximum) {
+        throw new CliError(message, options.code ?? 'invalid-timeout');
+    }
+    return value;
+}
+//# sourceMappingURL=timeout.js.map

package/dist/util/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/util/timeout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,sEAAsE;AACtE,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,KAAK,CAAC,CAAC;AAE5E,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,OAKC;IAED,MAAM,OAAO,GAAG,WAAW,OAAO,CAAC,MAAM,KAAK,GAAG,4BAA4B,OAAO,CAAC,IAAI,cAAc,OAAO,CAAC,OAAO,GAAG,CAAC;IAC1H,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,iBAAiB,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACzE,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,iBAAiB,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/util/tool-payload.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Visit only the bridge's known response wrappers. This intentionally does not
+ * recurse through arbitrary result data, so an application object's `Ok`
+ * property cannot be mistaken for the tool's own status contract.
+ */
+export declare function toolPayloadRecords(value: unknown, maxDepth?: number): ReadonlyArray<Record<string, unknown>>;
+/** Follow the first known wrapper at each level and return the deepest record. */
+export declare function unwrapToolPayload(value: unknown, maxDepth?: number): Record<string, unknown>;