@myapihq/cli 1.1.0-wip.5 → 1.2.0

package/dist/commands/{email.d.ts → audience.d.ts}

@@ -1,4 +1,6 @@
 import type { FlagSchema } from '../flags.js';
 import { type Flags } from '../helpers.js';
+import type { Exposes } from '../exposes.js';
+export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/audience.js

@@ -0,0 +1,245 @@
+import { audience as sdkAudience } from '@myapihq/sdk';
+import { requireConfig } from '../config.js';
+import { success, error, printTable, info, printJson } from '../output.js';
+import { requireOrg, requireArg } from '../helpers.js';
+export const EXPOSES = [
+    'POST /audience/orgs/{org_id}/audiences',
+    'GET /audience/orgs/{org_id}/audiences',
+    'GET /audience/orgs/{org_id}/audiences/{audience_id}',
+    'PATCH /audience/orgs/{org_id}/audiences/{audience_id}',
+    'DELETE /audience/orgs/{org_id}/audiences/{audience_id}',
+    'GET /audience/orgs/{org_id}/audiences/{audience_id}/members',
+    'POST /audience/orgs/{org_id}/audiences/{audience_id}/refresh',
+];
+export const SCHEMA = {
+    org: 'string',
+    name: 'string',
+    description: 'string',
+    source: 'string',
+    filter: 'string',
+    limit: 'number',
+    offset: 'number',
+};
+function parseFilter(raw) {
+    if (typeof raw !== 'string' || raw.trim() === '') {
+        error('Missing --filter. Pass a JSON object, e.g.\n  --filter \'{"industry":["saas"],"seniority":["vp","c_level"]}\'');
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            error('--filter must be a JSON object (e.g. {"industry":["saas"]}).');
+        }
+        return parsed;
+    }
+    catch (e) {
+        error(`--filter is not valid JSON: ${e?.message ?? e}`);
+        throw e; // unreachable; error() exits
+    }
+}
+function summarizeAudience(a) {
+    return {
+        id: a.id,
+        name: a.name,
+        source: a.source,
+        members: a.member_count,
+        created_at: a.created_at,
+    };
+}
+async function create(nameArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi audience create <name> --source <people|company> --filter <json>');
+    const name = nameArg || flags.name;
+    if (!name)
+        error('Missing required argument <name>.\nUsage: myapi audience create <name> --source <people|company> --filter <json>');
+    const source = flags.source;
+    if (source !== 'people' && source !== 'company') {
+        error(`--source must be "people" or "company" (got: ${source ?? '<missing>'}).`);
+    }
+    const filter = parseFilter(flags.filter);
+    const description = typeof flags.description === 'string' ? flags.description : undefined;
+    const res = await sdkAudience.createAudience(config.api_key, orgId, {
+        name, source: source, filter, description,
+    });
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    success(`Audience created! ID: ${res.id}\nMembers: ${res.member_count}\nSource: ${res.source}`);
+}
+async function list(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi audience list [--org <id>]');
+    const res = await sdkAudience.listAudiences(config.api_key, orgId);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    printTable(res.map(summarizeAudience), {
+        flags,
+        empty: 'No audiences yet. Create one with: myapi audience create <name> --source <people|company> --filter <json>',
+    });
+}
+async function get(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi audience get <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi audience get <id> [--org <id>]');
+    const res = await sdkAudience.getAudience(config.api_key, orgId, id);
+    printJson(res);
+}
+async function update(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi audience update <id> [--name x] [--description y] [--filter <json>]');
+    requireArg(id, 'id', 'myapi audience update <id> [--name x] [--description y] [--filter <json>]');
+    const patch = {};
+    if (typeof flags.name === 'string')
+        patch.name = flags.name;
+    if (typeof flags.description === 'string')
+        patch.description = flags.description;
+    if (typeof flags.filter === 'string')
+        patch.filter = parseFilter(flags.filter);
+    if (Object.keys(patch).length === 0) {
+        error('Pass at least one of --name / --description / --filter to update.');
+    }
+    const res = await sdkAudience.updateAudience(config.api_key, orgId, id, patch);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    success(`Audience ${res.id} updated. Members: ${res.member_count}`);
+}
+async function del(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi audience delete <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi audience delete <id> [--org <id>]');
+    await sdkAudience.deleteAudience(config.api_key, orgId, id);
+    success(`Audience ${id} deleted`);
+}
+async function members(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi audience members <id> [--limit N] [--offset N] [--org <id>]');
+    requireArg(id, 'id', 'myapi audience members <id> [--limit N] [--offset N] [--org <id>]');
+    const opts = {};
+    if (typeof flags.limit === 'number')
+        opts.limit = flags.limit;
+    if (typeof flags.offset === 'number')
+        opts.offset = flags.offset;
+    const res = await sdkAudience.getAudienceMembers(config.api_key, orgId, id, opts);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    // Response doesn't carry `source` — detect by which array is present.
+    const isPeople = Array.isArray(res.people);
+    const kind = isPeople ? 'people' : 'companies';
+    const count = isPeople ? (res.people?.length ?? 0) : (res.companies?.length ?? 0);
+    info(`${count} of ${res.total} ${kind}${res.has_more ? ' (more available — pass --offset)' : ''}`);
+    if (isPeople) {
+        printTable((res.people ?? []).map(p => ({
+            id: p.id,
+            name: p.full_name,
+            email: p.email ?? '',
+            domain: p.company?.domain ?? '',
+            country: p.location?.country ?? '',
+            link_conf: typeof p.link_confidence === 'number' ? p.link_confidence.toFixed(2) : '',
+        })), { flags, empty: 'Audience has no members.' });
+    }
+    else {
+        printTable((res.companies ?? []).map(c => ({
+            id: c.id,
+            domain: c.domain ?? '',
+            name: c.name,
+            country: c.country ?? '',
+            confidence: c.confidence ?? '',
+            headcount: c.headcount_lower_bound ?? '',
+            sources: c.source_count ?? '',
+        })), { flags, empty: 'Audience has no members.' });
+    }
+}
+async function refresh(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi audience refresh <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi audience refresh <id> [--org <id>]');
+    const res = await sdkAudience.refreshAudience(config.api_key, orgId, id);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    const sign = res.delta > 0 ? '+' : '';
+    success(`Refreshed. ${res.previous} → ${res.total} (${sign}${res.delta})`);
+}
+const SUBCOMMAND_USAGE = {
+    'create': `myapi audience create <name> --source <people|company> --filter <json> [--description <text>] [--org <id>]
+
+The Goldfox filter shape is shared across people/company/audience:
+  {
+    "confidence": ["high"],                    // high (default), low, very_low
+    "country": ["US", "DE"],                   // ISO 3166-1 alpha-2
+    "country_consistent": true,                // TLD+address+phone all agree
+    "seniority": ["c_level", "vp_director"],   // people-source only
+    "email_type": ["corporate"],               // people-source only
+    "tld_class": ["cctld"],                    // cctld/generic/vanity/low_trust/other
+    "has_c_level": true,                       // boolean signals
+    "has_decision_maker": true,
+    "has_careers_page": true,
+    "has_investors_page": false,
+    "has_shop_page": false,
+    "is_registered_entity": true,              // recognised legal suffix
+    "min_headcount": 5,
+    "min_source_count": 3,
+    "min_link_confidence": 0.8,                // people-source only
+    "keyword": "platform",                     // substring match on domain
+    "limit": 100,
+    "offset": 0
+  }
+Within an array → OR. Across fields → AND. Empty filter = all rows in
+source with default confidence=high (Goldfox's curated tier).
+
+Example:
+  myapi audience create "EU decision makers" \\
+    --source people \\
+    --filter '{"seniority":["c_level","vp_director"],"country":["DE","FR","GB"],"email_type":["corporate"]}'`,
+    'list': 'myapi audience list [--org <id>] [--json]',
+    'get': 'myapi audience get <id> [--org <id>]',
+    'update': 'myapi audience update <id> [--name <x>] [--description <y>] [--filter <json>] [--org <id>]',
+    'delete': 'myapi audience delete <id> [--org <id>]',
+    'members': 'myapi audience members <id> [--limit N] [--offset N] [--org <id>] [--json]',
+    'refresh': 'myapi audience refresh <id> [--org <id>]',
+};
+export async function run(subcommand, args, flags) {
+    if (!subcommand || (flags.help && !subcommand)) {
+        info(`Usage: myapi audience <subcommand>
+
+Subcommands:
+  create     Save a filter as a named audience (people or company source)
+  list       List all audiences in the org
+  get        Get a single audience (with its filter + current member_count)
+  update     Patch name / description / filter (re-evaluates count if filter changes)
+  delete     Remove an audience
+  members    Get paged member snapshot (people or companies depending on source)
+  refresh    Re-evaluate filter against current data; returns delta vs previous
+
+All commands accept --org <id> (or set a default: myapi config set-org <id>).
+
+Audiences are saved filter snapshots. Same filter shape as myapi people search /
+company search — see "myapi audience create --help" for the schema.`);
+        return;
+    }
+    if (flags.help) {
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi audience --help" for the list.`);
+        return;
+    }
+    switch (subcommand) {
+        case 'create': return create(args[0], flags);
+        case 'list': return list(flags);
+        case 'get': return get(args[0], flags);
+        case 'update': return update(args[0], flags);
+        case 'delete': return del(args[0], flags);
+        case 'members': return members(args[0], flags);
+        case 'refresh': return refresh(args[0], flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi audience --help" for valid subcommands.`);
+    }
+}

package/dist/commands/auth.d.ts

@@ -1,8 +1,11 @@
 import type { FlagSchema } from '../flags.js';
 import type { Flags } from '../helpers.js';
+import type { Exposes } from '../exposes.js';
+export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
-export declare const HELP = "Usage: myapi auth <subcommand>\n\nSubcommands:\n  setup           Configure your account\n  import-key      Import an existing API key non-interactively\n  whoami          Show current account \u00B7 supports --json\n  link [email]    Upgrade anonymous account to registered (or add a second session)\n                  Use myapi auth setup to create a completely new account\n  switch [index]  Switch active account by index or email\n  config          Manage CLI defaults (org, funnel, domain) \u00B7 supports set-org / set-funnel / set-domain\n  install-skills  Install or update the MyAPI skills pack for AI agents\n  api-keys        Manage API keys \u00B7 list / create / revoke\n  keys            Alias for api-keys";
-export declare const INSTALL_SKILLS_HELP = "Usage: myapi auth install-skills\n\nInstalls the MyAPI skills pack for AI coding agents (Claude, Gemini, Cursor).\n\nThis command writes skill definition files to:\n  ~/.agents/skills/myapi/\n\nAnd creates symlinks in the appropriate agent config directories:\n  ~/.claude/  (Claude)\n  ~/.gemini/  (Gemini)\n  ~/.cursor/  (Cursor, if detected)\n\nThese files teach agents how to use the MyAPI CLI and API directly.\nRun this command again to update existing skills to the latest version.";
+export declare const HELP = "Usage: myapi auth <subcommand>\n\nSubcommands:\n  setup           Configure your account\n  import-key      Import an existing API key non-interactively\n  whoami          Show current account \u00B7 supports --json\n  link [email]    Upgrade anonymous account to registered (or add a second session)\n                  Use myapi auth setup to create a completely new account\n  switch [index]  Switch active account by index or email\n  config          Manage CLI defaults (org, funnel, domain) \u00B7 supports set-org / set-funnel / set-domain\n  registrant      Manage stored WHOIS contact info for domain registration \u00B7 set / get / clear\n  install-skills  DEPRECATED \u2014 use `myapi install-skills` instead\n  api-keys        Manage API keys \u00B7 list / create / revoke\n  keys            Alias for api-keys";
+export declare const INSTALL_SKILLS_HELP = "Usage: myapi install-skills\n\nInstalls the MyAPI skills pack for AI coding agents (Claude, Gemini, Cursor).\n\nThis command writes skill definition files to:\n  ~/.agents/skills/myapi/\n\nAnd creates symlinks in the appropriate agent config directories:\n  ~/.claude/  (Claude)\n  ~/.gemini/  (Gemini)\n  ~/.cursor/  (Cursor, if detected)\n\nThese files teach agents how to use the MyAPI CLI and API directly.\nRun this command again to update existing skills to the latest version.\n\nNote: `myapi auth install-skills` is deprecated and will be removed in the next minor.\nUse `myapi install-skills` going forward.";
 export declare function link(flags?: Flags, emailArg?: string): Promise<void>;
 export declare function whoami(flags?: Flags): Promise<void>;
 export declare function switchCmd(flags?: Flags, indexArg?: string): Promise<void>;
+export declare function registrant(sub: string | undefined, flags?: Flags): Promise<void>;

package/dist/commands/auth.js

@@ -1,8 +1,16 @@
-import { loadConfig, saveConfig, addAccount, switchAccount, listAccounts } from '../config.js';
+import { loadConfig, saveConfig, addAccount, switchAccount, listAccounts, requireConfig } from '../config.js';
 import { info, success, error, printJson } from '../output.js';
 import { ask, confirm, withReadline } from '../prompt.js';
 import { installSkills } from './setup.js';
 import { hq } from '@myapihq/sdk';
+import { promptAndSave as promptAndSaveRegistrant } from '../registrant.js';
+export const EXPOSES = [
+    'PATCH /hq/account/upgrade',
+    'POST /hq/account/send-code',
+    'POST /hq/account/verify-code',
+    'GET /hq/billing/balance',
+    'GET /hq/account/free-tier',
+];
 export const SCHEMA = {
     'install-skills': 'boolean',
     'no-skills': 'boolean',
@@ -19,10 +27,11 @@ Subcommands:
                   Use myapi auth setup to create a completely new account
   switch [index]  Switch active account by index or email
   config          Manage CLI defaults (org, funnel, domain) · supports set-org / set-funnel / set-domain
-  install-skills  Install or update the MyAPI skills pack for AI agents
+  registrant      Manage stored WHOIS contact info for domain registration · set / get / clear
+  install-skills  DEPRECATED — use \`myapi install-skills\` instead
   api-keys        Manage API keys · list / create / revoke
   keys            Alias for api-keys`;
-export const INSTALL_SKILLS_HELP = `Usage: myapi auth install-skills
+export const INSTALL_SKILLS_HELP = `Usage: myapi install-skills
 
 Installs the MyAPI skills pack for AI coding agents (Claude, Gemini, Cursor).
 
@@ -35,7 +44,10 @@ And creates symlinks in the appropriate agent config directories:
   ~/.cursor/  (Cursor, if detected)
 
 These files teach agents how to use the MyAPI CLI and API directly.
-Run this command again to update existing skills to the latest version.`;
+Run this command again to update existing skills to the latest version.
+
+Note: \`myapi auth install-skills\` is deprecated and will be removed in the next minor.
+Use \`myapi install-skills\` going forward.`;
 const LINK_HELP = `Usage: myapi auth link [email]
 
 Behavior depends on whether the email is new or already registered:
@@ -147,10 +159,30 @@ export async function whoami(flags = {}) {
     if (!config?.api_key)
         error('Not configured. Run: myapi auth setup');
     let balance = null;
+    // Backend returns an array of per-service entries, or null. The SDK type
+    // used to lie about this (claimed scalar) — see hq.ts FreeTierEntry.
+    let freeTier = null;
+    // Note any auth-rejection from the balance probe so we don't silently
+    // print stale cached config when the key has actually been invalidated
+    // server-side. Other failures (endpoint missing, transient 500s) stay
+    // swallowed — balance is best-effort, not a key-validation primitive.
+    let keyRejected = false;
     try {
         balance = await hq.getBalance(config.api_key);
     }
-    catch { }
+    catch (err) {
+        if (err?.status === 401 || /invalid api key/i.test(err?.code ?? ''))
+            keyRejected = true;
+    }
+    // Free-tier query is best-effort — backend may not have it for every
+    // account type, and surfacing nothing is better than failing whoami.
+    try {
+        freeTier = await hq.getFreeTier(config.api_key);
+    }
+    catch (err) {
+        if (err?.status === 401 || /invalid api key/i.test(err?.code ?? ''))
+            keyRejected = true;
+    }
     if (flags.json) {
         printJson({
             email: config.email ?? null,
@@ -160,9 +192,16 @@ export async function whoami(flags = {}) {
             is_anonymous: config.is_anonymous ?? false,
             balance: balance?.balance_display ?? null,
             credits: balance?.credits_display ?? null,
+            free_tier: freeTier ?? null,
+            key_rejected: keyRejected,
         });
         return;
     }
+    if (keyRejected) {
+        info('⚠ The backend rejected your API key. The values below are from local config and may not match server state.');
+        info('  Run: myapi auth setup');
+        info('');
+    }
     if (config.email)
         info(`Email:    ${config.email}`);
     info(`Account:  ${config.account_id}`);
@@ -170,6 +209,13 @@ export async function whoami(flags = {}) {
     info(`Funnel:   ${config.default_funnel ?? '(none)'}`);
     info(`Type:     ${config.is_anonymous ? 'anonymous' : 'registered'}`);
     info(`Balance:  ${balance ? `${balance.balance_display}  |  Credits: ${balance.credits_display} (not usable for domains)` : '(unavailable)'}`);
+    if (Array.isArray(freeTier) && freeTier.length > 0) {
+        const parts = freeTier
+            .filter((e) => e && typeof e.service === 'string')
+            .map((e) => `${e.service} ${e.used ?? 0}/${e.allowance ?? '?'}`);
+        if (parts.length > 0)
+            info(`FreeTier: ${parts.join(' · ')}`);
+    }
 }
 // myapi auth switch [index] — switch between saved accounts.
 export async function switchCmd(flags = {}, indexArg) {
@@ -215,3 +261,85 @@ export async function switchCmd(flags = {}, indexArg) {
         success(`› Switched to ${a.email ?? a.account_id}`);
     }
 }
+// ── myapi auth registrant <set|get|clear> ─────────────────────────────────
+//
+// Manages the locally-stored WHOIS registrant info that `myapi domain
+// register` injects into every call. `set` is the one-time interactive
+// setup; `--registrant-json` is the agent-friendly bypass. `get` and
+// `clear` are housekeeping.
+const REGISTRANT_HELP = `Usage: myapi auth registrant <set|get|clear>
+
+Manages the locally-stored WHOIS contact info that \`myapi domain register\`
+requires (ICANN-mandated). Stored in ~/.myapi/config.json under the active
+account; never synced to the backend except as a per-request field.
+
+Subcommands:
+  set       Interactive prompt for all fields. Or pass --registrant-json
+            '<json>' to set non-interactively (agent-friendly).
+  get       Print the stored registrant (or "not set").
+  clear     Remove the stored registrant from the active account.`;
+export async function registrant(sub, flags = {}) {
+    if (flags.help || !sub) {
+        info(REGISTRANT_HELP);
+        return;
+    }
+    const config = requireConfig();
+    switch (sub) {
+        case 'set': {
+            // Agent path: --registrant-json '<inline>' writes directly without prompting.
+            const inlineJson = typeof flags['registrant-json'] === 'string' ? flags['registrant-json'] : null;
+            if (inlineJson) {
+                let parsed;
+                try {
+                    parsed = JSON.parse(inlineJson);
+                }
+                catch (e) {
+                    error(`--registrant-json is not valid JSON: ${e.message}`);
+                }
+                const required = ['name', 'email', 'phone', 'street', 'city', 'postal_code', 'country_code'];
+                const missing = required.filter(k => !parsed[k]);
+                if (missing.length > 0)
+                    error(`Missing required field(s): ${missing.join(', ')}`);
+                saveConfig({ ...config, registrant: parsed });
+                success('Saved registrant from --registrant-json.');
+                return;
+            }
+            const r = await promptAndSaveRegistrant(config, config.registrant);
+            success(`Saved. ${r.name} · ${r.email} · ${r.country_code}`);
+            return;
+        }
+        case 'get': {
+            if (!config.registrant) {
+                info('No registrant stored. Set one with: myapi auth registrant set');
+                return;
+            }
+            if (flags.json) {
+                printJson(config.registrant);
+                return;
+            }
+            const r = config.registrant;
+            info(`Name:        ${r.name}`);
+            info(`Email:       ${r.email}`);
+            info(`Phone:       ${r.phone}`);
+            info(`Street:      ${r.street}`);
+            info(`City:        ${r.city}`);
+            if (r.state)
+                info(`State:       ${r.state}`);
+            info(`Postal code: ${r.postal_code}`);
+            info(`Country:     ${r.country_code}`);
+            return;
+        }
+        case 'clear': {
+            if (!config.registrant) {
+                info('No registrant stored — nothing to clear.');
+                return;
+            }
+            const { registrant: _drop, ...rest } = config;
+            saveConfig(rest);
+            success('Cleared.');
+            return;
+        }
+        default:
+            error(`Unknown subcommand: ${sub}. Run \`myapi auth registrant --help\` for the list.`);
+    }
+}

package/dist/commands/billing.d.ts

@@ -1,6 +1,8 @@
 import type { FlagSchema } from '../flags.js';
 import type { Flags } from '../helpers.js';
+import type { Exposes } from '../exposes.js';
 export declare const SCHEMA: FlagSchema;
+export declare const EXPOSES: Exposes;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;
 export declare function balance(flags: Flags): Promise<void>;
 export declare function history(flags: Flags): Promise<void>;

package/dist/commands/billing.js

@@ -1,9 +1,15 @@
 import { hq } from '@myapihq/sdk';
 import { requireConfig } from '../config.js';
 import { success, error, printTable, info, printJson } from '../output.js';
-import { confirm } from '../prompt.js';
+import { confirm, isNonInteractive } from '../prompt.js';
 import { formatDate } from '../utils.js';
 export const SCHEMA = {};
+export const EXPOSES = [
+    'GET /hq/billing/balance',
+    'GET /hq/billing/history',
+    'POST /hq/billing/setup-payment',
+    'POST /hq/billing/topup',
+];
 const SUBCOMMAND_USAGE = {
     'balance': 'myapi billing balance [--json]',
     'history': 'myapi billing history [--json]',
@@ -57,6 +63,11 @@ export async function balance(flags) {
     const accountType = config.is_anonymous ? 'anonymous' : `registered (${config.email ?? ''})`;
     info(`Account: ${accountType}`);
     info(`Balance: ${result.balance_display}  |  Credits: ${result.credits_display} (not usable for domains)  |  Payment method: ${pm}`);
+    // Anonymous accounts can't transact — paid surface is gated on a
+    // verified email and credits only fund on upgrade. Surface the unblock.
+    if (config.is_anonymous) {
+        info('→ Link an email to unlock $5 free credit + paid actions: myapi auth link <email>');
+    }
 }
 export async function history(flags) {
     const config = requireConfig();
@@ -82,6 +93,12 @@ export async function topup(amountStr, flags) {
         error('Amount must be a positive whole number of dollars (e.g. myapi billing topup 10)');
     }
     if (!flags.yes && !flags.y && amount >= 50) {
+        // Refuse loudly in non-interactive contexts (agent harnesses, CI) instead
+        // of either hanging on a prompt no human will answer, or silently
+        // auto-cancelling with no actionable error. Force the caller to pass --yes.
+        if (isNonInteractive()) {
+            error(`Charge of $${amount} requires confirmation. Re-run with --yes:\n  myapi billing topup ${amount} --yes`);
+        }
         const ok = await confirm(`› Charge $${amount} to your saved payment method? (y/N) `, false);
         if (!ok) {
             info('Cancelled.');

package/dist/commands/company.d.ts

@@ -0,0 +1,6 @@
+import type { FlagSchema } from '../flags.js';
+import { type Flags } from '../helpers.js';
+import type { Exposes } from '../exposes.js';
+export declare const EXPOSES: Exposes;
+export declare const SCHEMA: FlagSchema;
+export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;