@usenaive-sdk/cli 0.12.5 → 0.13.1

package/dist/lib/teams-catalog.js.map

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

package/dist/lib/unknown-command.d.ts

@@ -1,10 +1,11 @@
+import type { Command } from "commander";
 import type { NextStep } from "../output.js";
 /** Structured error emitted when commander sees a command it doesn't recognize. */
 export interface UnknownCommandError {
     success: false;
     action: "unknown_command";
     error: {
-        code: "cli_outdated";
+        code: "cli_outdated" | "unknown_subcommand";
         message: string;
     };
     recovery_steps: NextStep[];
@@ -15,3 +16,56 @@ export interface UnknownCommandError {
  * 0.11.0) gets a `cli_outdated` JSON object instead of commander's raw stderr.
  */
 export declare function buildUnknownCommandError(command: string, currentVersion: string): UnknownCommandError;
+/**
+ * Build the agent-native error for an unknown SUBcommand of a known group
+ * (e.g. `naive trading market-data`). Unlike a bare unknown top-level command,
+ * we know the valid siblings, so we list them — the most useful recovery for a
+ * mistyped/renamed subcommand. See findUnknownSubcommand for why this is needed
+ * (N10): commander's `--help` option otherwise prints the parent's help and exits
+ * 0, masking the mistake.
+ */
+export declare function buildUnknownSubcommandError(group: string, unknown: string, validSubs: string[], currentVersion: string): UnknownCommandError;
+/**
+ * Pre-scan raw argv against the built command tree and return the first operand
+ * that lands on a command GROUP but is not one of its subcommands — i.e. a
+ * mistyped/unknown subcommand.
+ *
+ * WHY (N10): commander already errors on an unknown subcommand (exit 1) — EXCEPT
+ * when `--help`/`-h` is present, where its help option fires on the parent and
+ * exits 0, silently printing the wrong (parent) help. Running this before
+ * `program.parse()` lets us surface a real "unknown command" error consistently,
+ * with or without `--help`.
+ *
+ * A "group" is a NON-ROOT command that has subcommands and declares no positional
+ * args of its own (trading, images, email, …). Leaf commands that take a positional
+ * (`images generate <prompt>`) are left to commander — the first operand there is
+ * legitimate input, not a subcommand.
+ *
+ * 🔴 A VALUE-TAKING OPTION'S VALUE IS NOT A SUBCOMMAND (NV-064). This walk used
+ * to skip the token starting with `-` and then read the NEXT token as a
+ * subcommand name. The docstring claimed that was safe — "the only program-level
+ * options are booleans" and "leaf-command option values never reach the
+ * group-flagging branch" — and it is false for a command that is a group
+ * (`commands.length > 0`), declares its own `<value>` options, and registers no
+ * positional. `jobs` is exactly that shape, so on published CLI 0.13.0:
+ *
+ *     naive jobs --json                    -> the listing
+ *     naive jobs --limit 5 --json          -> unknown_subcommand '5'
+ *     naive jobs --status completed --json -> unknown_subcommand 'completed'
+ *
+ * Both broken forms are what `commands/jobs.ts` help text documents as the
+ * primary usage, and the failure happens before `program.parse()` — no API key,
+ * no network. `brain` has the same shape and would acquire the bug on the day it
+ * ships. So the walk now consumes an option's value, and stops at `--`.
+ *
+ * The ROOT program is deliberately excluded: an unknown TOP-LEVEL command
+ * (`naive bogus`) is handled by commander's `command:*` listener as a
+ * `cli_outdated` error (it may exist in a newer CLI) — a different, and more apt,
+ * message than "unknown subcommand". Only unrecognized children of a real group
+ * are our concern here.
+ */
+export declare function findUnknownSubcommand(program: Command, argv: string[]): {
+    group: string;
+    unknown: string;
+    validSubs: string[];
+} | null;

package/dist/lib/unknown-command.js

@@ -16,4 +16,117 @@ export function buildUnknownCommandError(command, currentVersion) {
         ],
     };
 }
+/**
+ * Build the agent-native error for an unknown SUBcommand of a known group
+ * (e.g. `naive trading market-data`). Unlike a bare unknown top-level command,
+ * we know the valid siblings, so we list them — the most useful recovery for a
+ * mistyped/renamed subcommand. See findUnknownSubcommand for why this is needed
+ * (N10): commander's `--help` option otherwise prints the parent's help and exits
+ * 0, masking the mistake.
+ */
+export function buildUnknownSubcommandError(group, unknown, validSubs, currentVersion) {
+    return {
+        success: false,
+        action: "unknown_command",
+        error: {
+            code: "unknown_subcommand",
+            message: `Unknown subcommand '${unknown}' for 'naive ${group}'. ` +
+                `Valid subcommands: ${validSubs.join(", ")}. ` +
+                `(CLI v${currentVersion}; a newer subcommand may exist in a later version.)`,
+        },
+        recovery_steps: [
+            { command: `naive ${group} --help`, description: `List all '${group}' subcommands and their flags` },
+            ...(validSubs.length > 0
+                ? [{ command: `naive ${group} ${validSubs[0]}`, description: "Run a valid subcommand" }]
+                : []),
+            { command: "npm i -g @usenaive-sdk/cli@latest", description: "Update the CLI if the subcommand should exist" },
+        ],
+    };
+}
+/**
+ * Does `tok` name an option that consumes the NEXT argv token?
+ *
+ * Asked of the command being walked and of the root program, because commander
+ * resolves a flag against both. `--opt=value` carries its own value, so it never
+ * consumes the next token.
+ */
+function consumesNextToken(cmd, program, tok) {
+    if (tok.includes("="))
+        return false;
+    for (const source of cmd === program ? [program] : [cmd, program]) {
+        for (const option of source.options) {
+            if (option.short === tok || option.long === tok)
+                return option.required || option.optional;
+        }
+    }
+    return false;
+}
+/**
+ * Pre-scan raw argv against the built command tree and return the first operand
+ * that lands on a command GROUP but is not one of its subcommands — i.e. a
+ * mistyped/unknown subcommand.
+ *
+ * WHY (N10): commander already errors on an unknown subcommand (exit 1) — EXCEPT
+ * when `--help`/`-h` is present, where its help option fires on the parent and
+ * exits 0, silently printing the wrong (parent) help. Running this before
+ * `program.parse()` lets us surface a real "unknown command" error consistently,
+ * with or without `--help`.
+ *
+ * A "group" is a NON-ROOT command that has subcommands and declares no positional
+ * args of its own (trading, images, email, …). Leaf commands that take a positional
+ * (`images generate <prompt>`) are left to commander — the first operand there is
+ * legitimate input, not a subcommand.
+ *
+ * 🔴 A VALUE-TAKING OPTION'S VALUE IS NOT A SUBCOMMAND (NV-064). This walk used
+ * to skip the token starting with `-` and then read the NEXT token as a
+ * subcommand name. The docstring claimed that was safe — "the only program-level
+ * options are booleans" and "leaf-command option values never reach the
+ * group-flagging branch" — and it is false for a command that is a group
+ * (`commands.length > 0`), declares its own `<value>` options, and registers no
+ * positional. `jobs` is exactly that shape, so on published CLI 0.13.0:
+ *
+ *     naive jobs --json                    -> the listing
+ *     naive jobs --limit 5 --json          -> unknown_subcommand '5'
+ *     naive jobs --status completed --json -> unknown_subcommand 'completed'
+ *
+ * Both broken forms are what `commands/jobs.ts` help text documents as the
+ * primary usage, and the failure happens before `program.parse()` — no API key,
+ * no network. `brain` has the same shape and would acquire the bug on the day it
+ * ships. So the walk now consumes an option's value, and stops at `--`.
+ *
+ * The ROOT program is deliberately excluded: an unknown TOP-LEVEL command
+ * (`naive bogus`) is handled by commander's `command:*` listener as a
+ * `cli_outdated` error (it may exist in a newer CLI) — a different, and more apt,
+ * message than "unknown subcommand". Only unrecognized children of a real group
+ * are our concern here.
+ */
+export function findUnknownSubcommand(program, argv) {
+    let cmd = program;
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        // Everything after `--` is an operand by definition — never a subcommand.
+        if (tok === "--")
+            return null;
+        if (tok.startsWith("-")) {
+            if (consumesNextToken(cmd, program, tok))
+                i++;
+            continue;
+        }
+        const sub = cmd.commands.find((c) => c.name() === tok || c.aliases().includes(tok));
+        if (sub) {
+            cmd = sub;
+            continue;
+        }
+        const isGroup = cmd !== program && cmd.commands.length > 0 && cmd.registeredArguments.length === 0;
+        if (isGroup) {
+            return {
+                group: cmd.name(),
+                unknown: tok,
+                validSubs: cmd.commands.map((c) => c.name()).filter((n) => n !== "help"),
+            };
+        }
+        return null;
+    }
+    return null;
+}
 //# sourceMappingURL=unknown-command.js.map

package/dist/lib/unknown-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"unknown-command.js","sourceRoot":"","sources":["../../src/lib/unknown-command.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,cAAsB;IAEtB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,iBAAiB;QACzB,KAAK,EAAE;YACL,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,oBAAoB,OAAO,yBAAyB,cAAc,8CAA8C;SAC1H;QACD,cAAc,EAAE;YACd,EAAE,OAAO,EAAE,mCAAmC,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAChG;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"unknown-command.js","sourceRoot":"","sources":["../../src/lib/unknown-command.ts"],"names":[],"mappings":"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"}

package/dist/output.d.ts

@@ -13,6 +13,27 @@ export interface NextStep {
     description: string;
     when?: string;
 }
+/**
+ * The SINGLE derivation point for the human-readable "Cost:" hint (N7). Reads
+ * the authoritative `credits_used` off a response/result object — the exact
+ * number the API billed and dropped from the balance — and formats it so the
+ * hint can NEVER drift from what was actually charged. Previously commands
+ * hardcoded strings like "Cost: 1 credit" while the API charged 10; deriving
+ * from the response is the only way to keep them in lockstep.
+ *
+ * Returns undefined when there is nothing (yet) to charge — the field is
+ * absent, or a job is still queued/processing/failed (credits_used is null) —
+ * so callers can spread it into a hints array and no line appears.
+ */
+export declare function creditCostHint(result: unknown): string | undefined;
+/**
+ * The submit-time counterpart of creditCostHint (N6). Reads a job-submission
+ * response's `estimated_credits` — the API's pre-flight quote, derived from the
+ * SAME getFalPrice() + usdToCredits() source that settles the final charge — so
+ * a customer sees the spend before and at submit, and the echoed number tracks
+ * what will actually be billed. Returns undefined when no estimate is present.
+ */
+export declare function creditEstimateHint(result: unknown): string | undefined;
 /** Non-fatal "a newer CLI is available" nudge, attached to the next agentOutput. */
 export interface UpdateInfo {
     current: string;
@@ -20,6 +41,34 @@ export interface UpdateInfo {
     update_command: string;
     note: string;
 }
+/**
+ * The machine half of the deprecation notice (06 §1.9 / §1.10.5). The human half
+ * is a stderr banner; this rides the STDOUT envelope so stdout stays
+ * JSON.parse-able and an agent can branch on it without scraping stderr.
+ *
+ * `replacement` is a CLOSED union on purpose (R-7): a capability that is simply
+ * gone renders as `{kind:"gap", because}` and cannot be rendered as an empty
+ * string, so the reason is required by the type rather than by review.
+ *
+ * `sunset` is likewise closed — `"frozen"` or a date. There is no "removal TBD".
+ */
+export interface DeprecationNotice {
+    id: string;
+    subject: string;
+    status: "deprecated" | "retired";
+    replacement: {
+        kind: "use";
+        what: string;
+    } | {
+        kind: "gap";
+        because: string;
+    };
+    since: string;
+    sunset: "frozen" | {
+        on: string;
+    };
+    guide: string;
+}
 export interface AgentOutput {
     success: boolean;
     action: string;
@@ -29,9 +78,22 @@ export interface AgentOutput {
     related_commands?: string[];
     help_markdown?: string;
     update?: UpdateInfo;
+    deprecation?: DeprecationNotice;
+}
+export interface AgentErrorDetails {
+    code?: string;
+    message?: string;
+    hint?: string;
+    http_status?: number;
+    body_snippet?: string;
+    [key: string]: unknown;
 }
 /** Stash a pending update notice for the next agentOutput call (client layer → output). */
 export declare function setPendingUpdate(info: UpdateInfo | undefined): void;
+/** Stash a pending deprecation notice for the next agentOutput call. */
+export declare function setPendingDeprecation(notice: DeprecationNotice | undefined): void;
+/** Test seam: read the pending notice without emitting it. */
+export declare function peekPendingDeprecation(): DeprecationNotice | undefined;
 export declare function agentOutput(opts: {
     action: string;
     result: unknown;
@@ -40,13 +102,73 @@ export declare function agentOutput(opts: {
     related_commands?: string[];
     help_markdown?: string;
 }): void;
+/**
+ * `agentOutput` plus an explicit process exit code — the mechanism behind the
+ * exit-code ladder of 06 §1.3. Exit 2 is "success, and a diff exists"
+ * (terraform's `-detailed-exitcode`); exit 3 is "success, and the terminal state
+ * is not success" — a CI script reading 0 as "the work is done" would otherwise
+ * count an `unverified` task as a pass.
+ *
+ * It sets `process.exitCode` rather than calling `process.exit()`: the payload it
+ * just wrote may still be buffered when stdout is a pipe, and `process.exit()`
+ * truncates it. Setting the code lets Node drain and then exit with it.
+ */
+export declare function agentOutputExit(opts: {
+    action: string;
+    result: unknown;
+    next_steps: NextStep[];
+    hints?: string[];
+    related_commands?: string[];
+    help_markdown?: string;
+    exitCode?: 0 | 2 | 3;
+}): void;
+/**
+ * THE FAILURE ENVELOPE GOES TO STDOUT, on the same channel as the success one.
+ *
+ * This used to be `console.error`, and stdout was zero bytes on every failure —
+ * so `naive <anything> --json | jq` and any agent reading stdout saw NOTHING when
+ * a command failed, including the `recovery_steps` that are its only route out.
+ *
+ * That contradicted the split the rest of this CLI is built on: stdout is THE
+ * machine document, stderr is human noise. update-notifier is stderr-only "so it
+ * never pollutes the JSON on stdout" (index.ts); the human-mode tip above is
+ * stderr "without polluting stdout (stays parseable JSON)"; a deprecation notice
+ * rides "the STDOUT envelope so stdout stays JSON.parse-able and an agent can
+ * branch on it without scraping stderr" (DeprecationNotice, above). The
+ * `unhandledRejection` net in index.ts exists in so many words because "an agent
+ * parsing stdout would get nothing it can act on" — and then emitted here, to
+ * stderr, so it did not deliver the thing it was written to deliver.
+ *
+ * Written ONCE, not to both channels: `2>&1` is the common way an agent harness
+ * merges these, and a second copy would put two JSON documents in one stream and
+ * break the single-document invariant that makes stdout `JSON.parse`-able.
+ *
+ * `success: false` is in the envelope and the exit code is still 1, so nothing
+ * downstream has to guess whether stdout is data — it must branch on `success`
+ * either way, exactly as it already does for the success envelope.
+ *
+ * HUMAN mode is unchanged: a red ✗ line is a diagnostic for a person, and those
+ * belong on stderr.
+ */
 export declare function agentError(opts: {
     action: string;
-    error: {
-        code?: string;
-        message?: string;
-        hint?: string;
-    };
+    error: AgentErrorDetails;
     recovery_steps: NextStep[];
 }): void;
+/**
+ * 06 §1.8 — when a response body carries a governance `verdict`, the DECISION
+ * POINT knows the recovery and the CLI's local `switch (code)` does not. The
+ * whole point of the denial envelope is that a model recovers instead of
+ * looping, and a hand-written table that overwrites the server's steps defeats
+ * it. So: a body with a `verdict` and a well-formed `recovery[]` renders the
+ * server's steps verbatim, and `getRecoverySteps` is not consulted.
+ *
+ * Both gates are required. `verdict` alone with no recovery falls back (the
+ * server said nothing actionable); `recovery` alone with no verdict is ignored,
+ * so this cannot become a way for any endpoint to rewrite the CLI's advice.
+ * Each step is validated field by field — an entry that is not
+ * `{command:string, description:string}` is dropped rather than printed as
+ * `undefined`.
+ */
+export declare function serverRecoverySteps(data: unknown): NextStep[] | undefined;
 export declare function formatApiError(action: string, data: unknown): void;

package/dist/output.js

@@ -116,6 +116,40 @@ function renderHumanError(o) {
     if (o.error.hint)
         w(chalk.dim("  hint: " + o.error.hint) + "\n");
 }
+/**
+ * The SINGLE derivation point for the human-readable "Cost:" hint (N7). Reads
+ * the authoritative `credits_used` off a response/result object — the exact
+ * number the API billed and dropped from the balance — and formats it so the
+ * hint can NEVER drift from what was actually charged. Previously commands
+ * hardcoded strings like "Cost: 1 credit" while the API charged 10; deriving
+ * from the response is the only way to keep them in lockstep.
+ *
+ * Returns undefined when there is nothing (yet) to charge — the field is
+ * absent, or a job is still queued/processing/failed (credits_used is null) —
+ * so callers can spread it into a hints array and no line appears.
+ */
+export function creditCostHint(result) {
+    const raw = result?.credits_used;
+    if (typeof raw !== "number" || !Number.isFinite(raw) || raw <= 0)
+        return undefined;
+    // Trim binary float noise (e.g. 0.30000000000000004) without inventing precision.
+    const credits = Math.round(raw * 10000) / 10000;
+    return `Cost: ${credits} ${credits === 1 ? "credit" : "credits"}`;
+}
+/**
+ * The submit-time counterpart of creditCostHint (N6). Reads a job-submission
+ * response's `estimated_credits` — the API's pre-flight quote, derived from the
+ * SAME getFalPrice() + usdToCredits() source that settles the final charge — so
+ * a customer sees the spend before and at submit, and the echoed number tracks
+ * what will actually be billed. Returns undefined when no estimate is present.
+ */
+export function creditEstimateHint(result) {
+    const raw = result?.estimated_credits;
+    if (typeof raw !== "number" || !Number.isFinite(raw) || raw <= 0)
+        return undefined;
+    const credits = Math.round(raw * 10000) / 10000;
+    return `Estimated cost: ${credits} ${credits === 1 ? "credit" : "credits"} (charged only on successful completion)`;
+}
 // A pending, non-fatal update notice discovered by the client layer (from the
 // server version handshake). It rides along on the next successful agentOutput
 // and is cleared once emitted, so it surfaces exactly once per command.
@@ -124,11 +158,41 @@ let _pendingUpdate;
 export function setPendingUpdate(info) {
     _pendingUpdate = info;
 }
+// The same one-shot mechanism for a deprecation notice, set by lib/deprecation.ts
+// from a commander preAction hook. It rides the next successful envelope and is
+// cleared once emitted, so it appears exactly once per command.
+let _pendingDeprecation;
+/** Stash a pending deprecation notice for the next agentOutput call. */
+export function setPendingDeprecation(notice) {
+    _pendingDeprecation = notice;
+}
+/** Test seam: read the pending notice without emitting it. */
+export function peekPendingDeprecation() {
+    return _pendingDeprecation;
+}
 export function agentOutput(opts) {
-    // Consume any pending update notice first (so it's cleared even in human mode),
+    agentOutputExit(opts);
+}
+/**
+ * `agentOutput` plus an explicit process exit code — the mechanism behind the
+ * exit-code ladder of 06 §1.3. Exit 2 is "success, and a diff exists"
+ * (terraform's `-detailed-exitcode`); exit 3 is "success, and the terminal state
+ * is not success" — a CI script reading 0 as "the work is done" would otherwise
+ * count an `unverified` task as a pass.
+ *
+ * It sets `process.exitCode` rather than calling `process.exit()`: the payload it
+ * just wrote may still be buffered when stdout is a pipe, and `process.exit()`
+ * truncates it. Setting the code lets Node drain and then exit with it.
+ */
+export function agentOutputExit(opts) {
+    // Consume any pending notices first (so they're cleared even in human mode),
     // then take the human-mode early return.
     const update = _pendingUpdate;
     _pendingUpdate = undefined;
+    const deprecation = _pendingDeprecation;
+    _pendingDeprecation = undefined;
+    if (opts.exitCode)
+        process.exitCode = opts.exitCode;
     if (humanMode()) {
         renderHuman(opts);
         return;
@@ -142,10 +206,39 @@ export function agentOutput(opts) {
         ...(opts.related_commands && { related_commands: opts.related_commands }),
         ...(opts.help_markdown && { help_markdown: opts.help_markdown }),
         ...(update && { update }),
+        ...(deprecation && { deprecation }),
     };
     console.log(JSON.stringify(output, null, 2));
     maybeDiscoveryHint();
 }
+/**
+ * THE FAILURE ENVELOPE GOES TO STDOUT, on the same channel as the success one.
+ *
+ * This used to be `console.error`, and stdout was zero bytes on every failure —
+ * so `naive <anything> --json | jq` and any agent reading stdout saw NOTHING when
+ * a command failed, including the `recovery_steps` that are its only route out.
+ *
+ * That contradicted the split the rest of this CLI is built on: stdout is THE
+ * machine document, stderr is human noise. update-notifier is stderr-only "so it
+ * never pollutes the JSON on stdout" (index.ts); the human-mode tip above is
+ * stderr "without polluting stdout (stays parseable JSON)"; a deprecation notice
+ * rides "the STDOUT envelope so stdout stays JSON.parse-able and an agent can
+ * branch on it without scraping stderr" (DeprecationNotice, above). The
+ * `unhandledRejection` net in index.ts exists in so many words because "an agent
+ * parsing stdout would get nothing it can act on" — and then emitted here, to
+ * stderr, so it did not deliver the thing it was written to deliver.
+ *
+ * Written ONCE, not to both channels: `2>&1` is the common way an agent harness
+ * merges these, and a second copy would put two JSON documents in one stream and
+ * break the single-document invariant that makes stdout `JSON.parse`-able.
+ *
+ * `success: false` is in the envelope and the exit code is still 1, so nothing
+ * downstream has to guess whether stdout is data — it must branch on `success`
+ * either way, exactly as it already does for the success envelope.
+ *
+ * HUMAN mode is unchanged: a red ✗ line is a diagnostic for a person, and those
+ * belong on stderr.
+ */
 export function agentError(opts) {
     if (humanMode()) {
         renderHumanError(opts);
@@ -157,25 +250,82 @@ export function agentError(opts) {
         error: opts.error,
         recovery_steps: opts.recovery_steps,
     };
-    console.error(JSON.stringify(output, null, 2));
+    console.log(JSON.stringify(output, null, 2));
     process.exit(1);
 }
+/**
+ * 06 §1.8 — when a response body carries a governance `verdict`, the DECISION
+ * POINT knows the recovery and the CLI's local `switch (code)` does not. The
+ * whole point of the denial envelope is that a model recovers instead of
+ * looping, and a hand-written table that overwrites the server's steps defeats
+ * it. So: a body with a `verdict` and a well-formed `recovery[]` renders the
+ * server's steps verbatim, and `getRecoverySteps` is not consulted.
+ *
+ * Both gates are required. `verdict` alone with no recovery falls back (the
+ * server said nothing actionable); `recovery` alone with no verdict is ignored,
+ * so this cannot become a way for any endpoint to rewrite the CLI's advice.
+ * Each step is validated field by field — an entry that is not
+ * `{command:string, description:string}` is dropped rather than printed as
+ * `undefined`.
+ */
+export function serverRecoverySteps(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    const body = data;
+    const verdict = body.verdict ?? body.error?.verdict;
+    if (typeof verdict !== "string" || verdict.length === 0)
+        return undefined;
+    const raw = body.recovery ?? body.error?.recovery;
+    if (!Array.isArray(raw))
+        return undefined;
+    const steps = [];
+    for (const entry of raw) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const { command, description, when } = entry;
+        if (typeof command !== "string" || typeof description !== "string")
+            continue;
+        steps.push({ command, description, ...(typeof when === "string" && { when }) });
+    }
+    return steps.length > 0 ? steps : undefined;
+}
 export function formatApiError(action, data) {
-    const err = data;
-    if (err.error) {
-        agentError({
-            action,
-            error: err.error,
-            recovery_steps: getRecoverySteps(err.error.code),
-        });
+    // Accept Naive `{ error: { code, message } }`, proxy shapes where `error` is a
+    // string (Supabase Storage), or a bare `{ message }` — never collapse to opaque
+    // `unknown` when the upstream already said something useful.
+    const payload = data && typeof data === "object" ? data : null;
+    const rawError = payload?.error;
+    let details;
+    if (rawError && typeof rawError === "object" && !Array.isArray(rawError)) {
+        details = rawError;
     }
-    else {
+    else if (typeof rawError === "string" && rawError) {
+        const message = typeof payload?.message === "string" && payload.message ? payload.message : rawError;
+        details = { code: "upstream_error", message };
+    }
+    else if (typeof payload?.message === "string" && payload.message) {
+        details = { code: "upstream_error", message: payload.message };
+    }
+    if (details) {
         agentError({
             action,
-            error: { code: "unknown", message: "Unexpected error response" },
-            recovery_steps: [{ command: "naive status", description: "Check API connectivity and auth status" }],
+            error: details,
+            // A governance denial carries its own recovery — the DECISION POINT knows
+            // the way out and this local table does not. Server steps win when both
+            // gates in serverRecoverySteps() are satisfied.
+            recovery_steps: serverRecoverySteps(data) ?? getRecoverySteps(details.code),
         });
+        return;
     }
+    agentError({
+        action,
+        error: {
+            code: "unknown",
+            message: "Unexpected error response",
+            body_snippet: data == null ? undefined : JSON.stringify(data).slice(0, 300),
+        },
+        recovery_steps: getRecoverySteps("unknown"),
+    });
 }
 function getRecoverySteps(code) {
     switch (code) {
@@ -220,6 +370,18 @@ function getRecoverySteps(code) {
                 { command: "naive voice list", description: "Check the voice's tier/status" },
                 { command: "# the requested tier has no clone", description: "Use the voice's native tier, or have an admin re-clone for that tier in Studio" },
             ];
+        // Transport-level failure: the gateway returned a non-JSON body (502/503/504
+        // HTML page). Idempotent GETs were already retried in the client; a failed POST
+        // (e.g. llm chat) is NOT auto-retried to avoid a double-charge — the user retries.
+        case "upstream_error":
+            return [
+                { command: "# retry — gateway timeouts (502/504) are usually transient", description: "Re-run your command in a moment" },
+                { command: "naive status", description: "Check API connectivity" },
+                {
+                    command: 'naive report "<what failed>" --command "<the command you ran>" --kind error',
+                    description: "Report it to the naive team if it persists",
+                },
+            ];
         // Genuinely-broken-on-our-side codes — these are worth reporting (unlike the
         // self-correctable cases above). Retry first (often transient), then report.
         case "provider_error":
@@ -231,9 +393,24 @@ function getRecoverySteps(code) {
                     description: "Report it to the naive team if it persists",
                 },
             ];
+        // Opaque / unexpected failures (non-JSON gateway body already mapped, or API
+        // returned an untyped error). Agents only file tickets when recovery_steps
+        // tell them to — without this, `unknown` silently becomes "check status".
+        case "unknown":
+            return [
+                { command: "naive status", description: "Check API connectivity and auth status" },
+                {
+                    command: 'naive report "<what failed — paste the error JSON>" --command "<the command you ran>" --kind error',
+                    description: "File a tracked report — unexpected errors are product bugs until proven otherwise",
+                },
+            ];
         default:
             return [
                 { command: "naive status", description: "Check API connectivity and auth status" },
+                {
+                    command: 'naive report "<what failed — paste the error JSON>" --command "<the command you ran>" --kind error',
+                    description: "If this is not a credits/auth/invalid-input issue you can fix yourself, report it",
+                },
             ];
     }
 }