@usenaive-sdk/cli 0.12.2 → 0.12.5

package/dist/lib/version-check.js

@@ -0,0 +1,21 @@
+import semver from "semver";
+/**
+ * Pure decision function so the staleness policy is unit-testable without a
+ * live API. Any missing/invalid version is treated as "ok" — we never block or
+ * nag on data we can't trust.
+ */
+export function evaluateCliVersion(current, min, latest) {
+    const cur = semver.valid(semver.coerce(current) ?? current);
+    if (!cur)
+        return { kind: "ok" };
+    const minValid = min ? semver.valid(semver.coerce(min) ?? min) : null;
+    if (minValid && semver.lt(cur, minValid)) {
+        return { kind: "block", current: cur, min: minValid, latest: latest ?? undefined };
+    }
+    const latestValid = latest ? semver.valid(semver.coerce(latest) ?? latest) : null;
+    if (latestValid && semver.lt(cur, latestValid)) {
+        return { kind: "notice", current: cur, latest: latestValid, min: min ?? undefined };
+    }
+    return { kind: "ok" };
+}
+//# sourceMappingURL=version-check.js.map

package/dist/lib/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/lib/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAc5B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,GAAY,EACZ,MAAe;IAEf,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC;IAC5D,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEhC,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,IAAI,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;IACrF,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,IAAI,WAAW,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI,SAAS,EAAE,CAAC;IACtF,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/output.d.ts

@@ -1,13 +1,25 @@
-/**
- * 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.
- */
+/** Set by the global --json / --human options in index.ts, parsed before any action runs. */
+export declare function setOutputFlags(opts: {
+    json?: boolean;
+    human?: boolean;
+}): void;
+/** TRUE only on an explicit opt-in; default false. Controls OUTPUT FORMAT. */
+export declare function humanMode(): boolean;
+/** 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 declare function isInteractive(): boolean;
 export interface NextStep {
     command: string;
     description: string;
     when?: string;
 }
+/** Non-fatal "a newer CLI is available" nudge, attached to the next agentOutput. */
+export interface UpdateInfo {
+    current: string;
+    latest: string;
+    update_command: string;
+    note: string;
+}
 export interface AgentOutput {
     success: boolean;
     action: string;
@@ -16,7 +28,10 @@ export interface AgentOutput {
     hints?: string[];
     related_commands?: string[];
     help_markdown?: string;
+    update?: UpdateInfo;
 }
+/** Stash a pending update notice for the next agentOutput call (client layer → output). */
+export declare function setPendingUpdate(info: UpdateInfo | undefined): void;
 export declare function agentOutput(opts: {
     action: string;
     result: unknown;

package/dist/output.js

@@ -2,8 +2,137 @@
  * 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");
+}
+// 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;
+}
 export function agentOutput(opts) {
+    // Consume any pending update notice first (so it's cleared even in human mode),
+    // then take the human-mode early return.
+    const update = _pendingUpdate;
+    _pendingUpdate = undefined;
+    if (humanMode()) {
+        renderHuman(opts);
+        return;
+    }
     const output = {
         success: true,
         action: opts.action,
@@ -12,10 +141,16 @@ 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 }),
     };
     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,
@@ -51,15 +186,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 +210,16 @@ 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" },
+            ];
         // 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":

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.12.5",
   "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",
@@ -16,16 +16,21 @@
   "dependencies": {
     "commander": "^13.1.0",
     "chalk": "^5.4.1",
-    "jiti": "^2.4.2"
+    "jiti": "^2.4.2",
+    "semver": "^7.6.3",
+    "update-notifier": "^7.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.15.3",
+    "@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;