@usenaive-sdk/cli 0.12.2 → 0.13.0

package/dist/output.js

@@ -2,8 +2,201 @@
  * Agent-native structured output for CLI responses.
  * Every tool call returns JSON with result data + contextual guidance
  * following the Meow/Lindy pattern for agentic CLI usage.
+ *
+ * Output mode is OPT-IN human (default machine JSON). Human mode is NEVER inferred from isTTY —
+ * a pty-wrapped caller (Claude Code's Bash tool, script(1), tmux, ssh -t, CI runners) reports
+ * isTTY===true with no human present, so auto-detect would hang agents in prompts and break their
+ * JSON.parse. Machine overrides (--json / NAIVE_JSON / CI) always win.
  */
+import chalk from "chalk";
+import { loadConfig, saveConfig } from "./config.js";
+let _flagJson = false;
+let _flagHuman = false;
+/** Set by the global --json / --human options in index.ts, parsed before any action runs. */
+export function setOutputFlags(opts) {
+    if (opts.json)
+        _flagJson = true;
+    if (opts.human)
+        _flagHuman = true;
+}
+function machineForced() {
+    return _flagJson || !!process.env.NAIVE_JSON || !!process.env.CI;
+}
+/** TRUE only on an explicit opt-in; default false. Controls OUTPUT FORMAT. */
+export function humanMode() {
+    if (machineForced())
+        return false;
+    if (_flagHuman || process.env.NAIVE_HUMAN === "1")
+        return true;
+    try {
+        return loadConfig().output === "human";
+    }
+    catch {
+        return false;
+    }
+}
+/** Prompts (wizard, destructive confirm) require human mode AND a real interactive stdin — a
+ *  separate predicate from output format, so a human piping stdout to `tee` still gets the confirm. */
+export function isInteractive() {
+    return humanMode() && !!process.stdin.isTTY;
+}
+// One-time stderr nudge so a founder discovers human mode without polluting stdout (stays parseable JSON).
+function maybeDiscoveryHint() {
+    if (!process.stdout.isTTY)
+        return;
+    if (_flagJson || _flagHuman || process.env.NAIVE_JSON || process.env.NAIVE_HUMAN || process.env.CI)
+        return;
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch {
+        return;
+    }
+    if (cfg.output !== undefined || cfg.human_hint_shown)
+        return;
+    process.stderr.write(chalk.dim("\n💡 tip: run `naive config output human` for friendly, readable output.\n"));
+    try {
+        saveConfig({ human_hint_shown: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+// Secret guard (security HIGH-2): a key must be shown ONCE, clearly labeled, and NEVER rendered as a
+// runnable/highlighted command (the copy-into-shell-history footgun).
+const SECRET_TOKEN_RE = /nv_sk_[A-Za-z0-9_]+/;
+function isSecretField(key) {
+    return key === "api_key" || key === "session_token" || key === "token";
+}
+function fmtVal(v) {
+    if (v === null || v === undefined)
+        return chalk.dim("—");
+    if (typeof v === "object")
+        return chalk.dim(JSON.stringify(v));
+    return String(v);
+}
+function renderHuman(o) {
+    const w = (s) => process.stdout.write(s);
+    w(chalk.green.bold(`✓ ${o.action}\n`));
+    if (o.result && typeof o.result === "object") {
+        for (const [k, v] of Object.entries(o.result)) {
+            if (isSecretField(k) && typeof v === "string") {
+                w("\n" + chalk.yellow.bold(`  ⚠ ${k} — save this now, it won't be shown again:`) + "\n");
+                w("    " + chalk.cyan(v) + "\n\n");
+            }
+            else {
+                w("  " + chalk.dim(`${k}:`) + " " + fmtVal(v) + "\n");
+            }
+        }
+    }
+    else if (o.result !== null && o.result !== undefined) {
+        w("  " + String(o.result) + "\n");
+    }
+    if (o.hints?.length) {
+        w("\n");
+        for (const h of o.hints)
+            w(chalk.dim(`  • ${h}`) + "\n");
+    }
+    // next_steps as suggested commands — but NEVER one carrying a raw key (secret guard).
+    const safe = (o.next_steps ?? []).filter((s) => !SECRET_TOKEN_RE.test(s.command));
+    if (safe.length) {
+        w("\n" + chalk.dim("  Next:") + "\n");
+        for (const s of safe)
+            w("    " + chalk.cyan(s.command) + chalk.dim(`  — ${s.description}`) + "\n");
+    }
+    // help_markdown is intentionally NOT rendered in human mode: it's verbose and (in keys create) the
+    // place a raw secret would live. The JSON path keeps it for agents.
+}
+function renderHumanError(o) {
+    const w = (s) => process.stderr.write(s);
+    w(chalk.red.bold(`✗ ${o.action} failed`) + "\n");
+    if (o.error.message)
+        w("  " + o.error.message + "\n");
+    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.
+let _pendingUpdate;
+/** Stash a pending update notice for the next agentOutput call (client layer → output). */
+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) {
+    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;
+    }
     const output = {
         success: true,
         action: opts.action,
@@ -12,10 +205,17 @@ export function agentOutput(opts) {
         ...(opts.hints && { hints: opts.hints }),
         ...(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();
 }
 export function agentError(opts) {
+    if (humanMode()) {
+        renderHumanError(opts);
+        process.exit(1);
+    }
     const output = {
         success: false,
         action: opts.action,
@@ -25,22 +225,79 @@ export function agentError(opts) {
     console.error(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 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 };
     }
-    else {
+    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) {
@@ -51,15 +308,15 @@ function getRecoverySteps(code) {
             ];
         case "insufficient_credits":
             return [
-                { command: "naive billing topup --pack medium", description: "Buy 50 credits for $23 (Popular)" },
-                { command: "naive billing topup --pack large", description: "Buy 100 credits for $44 (Best Value)" },
-                { command: "naive billing upgrade --plan pro", description: "Upgrade to Pro (200 credits/mo, $149/mo)" },
+                { command: "naive billing topup --pack medium", description: "Buy 500 credits for $23 (Popular)" },
+                { command: "naive billing topup --pack large", description: "Buy 1000 credits for $44 (Best Value)" },
+                { command: "naive billing upgrade --plan pro", description: "Upgrade to Pro (2000 credits/mo, $149/mo)" },
                 { command: "naive billing packs", description: "See all available credit packs" },
             ];
         case "billing_blocked":
             return [
-                { command: "naive billing subscribe --plan starter", description: "Subscribe to Starter ($49/mo, 50 credits)" },
-                { command: "naive billing subscribe --plan pro", description: "Subscribe to Pro ($149/mo, 200 credits)" },
+                { command: "naive billing subscribe --plan starter", description: "Subscribe to Starter ($49/mo, 500 credits)" },
+                { command: "naive billing subscribe --plan pro", description: "Subscribe to Pro ($149/mo, 2000 credits)" },
                 { command: "naive billing plans", description: "Compare all plans" },
             ];
         case "rate_limited":
@@ -75,6 +332,28 @@ function getRecoverySteps(code) {
             return [
                 { command: "naive <command> --help", description: "See required parameters and examples" },
             ];
+        case "voice_revoked":
+            return [
+                { command: "naive voice list", description: "List voices that are still available" },
+                { command: "# this voice's consent was revoked", description: "Pick another voice, or have an admin re-create it in the Studio UI" },
+            ];
+        case "voice_reclone_required":
+            return [
+                { 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":
@@ -86,9 +365,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",
+                },
             ];
     }
 }

package/dist/output.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,17 @@
+/** Free-text answer. Returns null on timeout/abort. */
+export declare function ask(label: string, opts?: {
+    default?: string;
+}): Promise<string | null>;
+/** Yes/No. Default NO (returns false on timeout, empty, or anything not starting with y). */
+export declare function confirm(label: string): Promise<boolean>;
+/** Affirmation: Enter (empty) OR 'y' = affirm; 'n'/anything else/timeout = cancel. For consent
+ *  disclosures where the user has read the terms and presses Enter to take responsibility. */
+export declare function affirm(label: string): Promise<boolean>;
+/** Type-to-confirm for irreversible actions (GitHub-delete pattern). True only if the typed text
+ *  matches `expected` exactly. Default-deny on timeout/mismatch. */
+export declare function confirmExact(label: string, expected: string): Promise<boolean>;
+/** Numbered single-select. Returns the chosen value, or null on timeout/invalid. */
+export declare function select(label: string, choices: {
+    value: string;
+    label: string;
+}[]): Promise<string | null>;

package/dist/prompt.js

@@ -0,0 +1,70 @@
+// Minimal interactive prompts built on Node's built-in readline/promises — NO new dependency
+// (deliberate: this is a credential-handling CLI; a prompt lib would run in the same process as the
+// session token + api_key). Every prompt has a hard timeout that resolves to a SAFE default, so a
+// pty-wrapped caller that somehow reaches a prompt times out into abort instead of hanging forever.
+// Callers MUST gate these on isInteractive() (human mode + interactive stdin) — these helpers do not
+// re-check that themselves.
+import * as readline from "node:readline/promises";
+const DEFAULT_TIMEOUT_MS = 30_000;
+async function question(q, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let timer;
+    try {
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                process.stdout.write("\n(timed out — aborting)\n");
+                resolve(null);
+            }, timeoutMs);
+        });
+        const answer = rl.question(q).then((a) => a);
+        const result = await Promise.race([answer, timeout]);
+        return result;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        rl.close();
+    }
+}
+/** Free-text answer. Returns null on timeout/abort. */
+export async function ask(label, opts = {}) {
+    const suffix = opts.default ? ` [${opts.default}]` : "";
+    const a = await question(`${label}${suffix}: `);
+    if (a === null)
+        return null;
+    const trimmed = a.trim();
+    return trimmed === "" && opts.default !== undefined ? opts.default : trimmed;
+}
+/** Yes/No. Default NO (returns false on timeout, empty, or anything not starting with y). */
+export async function confirm(label) {
+    const a = await question(`${label} (y/N): `);
+    return a !== null && a.trim().toLowerCase().startsWith("y");
+}
+/** Affirmation: Enter (empty) OR 'y' = affirm; 'n'/anything else/timeout = cancel. For consent
+ *  disclosures where the user has read the terms and presses Enter to take responsibility. */
+export async function affirm(label) {
+    const a = await question(`${label} [Enter to affirm, 'n' to cancel]: `);
+    if (a === null)
+        return false; // timeout = cancel (safe)
+    const t = a.trim().toLowerCase();
+    return t === "" || t.startsWith("y");
+}
+/** Type-to-confirm for irreversible actions (GitHub-delete pattern). True only if the typed text
+ *  matches `expected` exactly. Default-deny on timeout/mismatch. */
+export async function confirmExact(label, expected) {
+    const a = await question(`${label}: `);
+    return a !== null && a.trim() === expected;
+}
+/** Numbered single-select. Returns the chosen value, or null on timeout/invalid. */
+export async function select(label, choices) {
+    process.stdout.write(`${label}\n`);
+    choices.forEach((c, i) => process.stdout.write(`  ${i + 1}) ${c.label}\n`));
+    const a = await question(`Choose 1-${choices.length}: `);
+    if (a === null)
+        return null;
+    const n = parseInt(a.trim(), 10);
+    if (Number.isNaN(n) || n < 1 || n > choices.length)
+        return null;
+    return choices[n - 1].value;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usenaive-sdk/cli",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "type": "module",
   "description": "Naïve CLI — provision and govern a real-world agent profile per agent (identity, card, comms, runtime). Formerly @usenaive/cli.",
   "license": "MIT",
@@ -14,18 +14,23 @@
     "access": "public"
   },
   "dependencies": {
-    "commander": "^13.1.0",
     "chalk": "^5.4.1",
-    "jiti": "^2.4.2"
+    "commander": "^13.1.0",
+    "jiti": "^2.4.2",
+    "semver": "^7.6.3",
+    "update-notifier": "^7.3.1"
   },
   "devDependencies": {
-    "@types/node": "^22.15.3",
+    "@types/node": "^22.19.17",
+    "@types/semver": "^7.5.8",
     "tsx": "^4.19.4",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9"
   },
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsc",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
   }
 }

package/dist/commands/billing-client.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare const billingClientCmd: Command;