@myapihq/cli 1.1.0-wip.5 → 1.2.1

package/dist/commands/email/campaign.js

@@ -2,6 +2,19 @@ import { email as sdkEmail } from '@myapihq/sdk';
 import { requireConfig } from '../../config.js';
 import { success, error, printTable, printJson, info } from '../../output.js';
 import { requireOrg } from '../../helpers.js';
+export const EXPOSES = [
+    'POST /email/orgs/{org_id}/campaigns',
+    'GET /email/orgs/{org_id}/campaigns',
+    'GET /email/orgs/{org_id}/campaigns/{campaign_id}',
+    'PATCH /email/orgs/{org_id}/campaigns/{campaign_id}',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/contacts/upload-list',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/contacts/upload-file',
+    'GET /email/orgs/{org_id}/campaigns/{campaign_id}/contacts/status',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/start',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/pause',
+    'POST /email/orgs/{org_id}/campaigns/{campaign_id}/resume',
+    'GET /email/orgs/{org_id}/campaigns/{campaign_id}/stats',
+];
 async function create(nameArg, flags) {
     const config = requireConfig();
     const orgId = requireOrg(flags, config, 'myapi email campaign create <name> --template-id <id> --from <email> [--per-day <n>] [--org <id>]');
@@ -61,6 +74,23 @@ async function uploadContacts(id, flags) {
     const res = await sdkEmail.uploadContactList(config.api_key, orgId, id, emails);
     success(`Uploaded ${res.total} contacts (status: ${res.status})`);
 }
+async function uploadContactsFile(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi email campaign upload-contacts-file <campaign_id> --file <path> [--org <id>]');
+    if (!id || !flags.file) {
+        error('Missing required arguments.\nUsage: myapi email campaign upload-contacts-file <campaign_id> --file <path> [--org <id>]');
+    }
+    // Defer fs require to keep the unimported-cost low for users who never
+    // touch this command. Plain JS readFile fits — the SDK accepts a Buffer.
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const filePath = flags.file;
+    if (!fs.existsSync(filePath))
+        error(`File not found: ${filePath}`);
+    const buf = fs.readFileSync(filePath);
+    const res = await sdkEmail.uploadContactsFile(config.api_key, orgId, id, buf, path.basename(filePath));
+    success(`Uploaded ${res.total} contacts from ${filePath} (status: ${res.status})`);
+}
 async function start(id, flags) {
     const config = requireConfig();
     const orgId = requireOrg(flags, config, 'myapi email campaign start <id> [--org <id>]');
@@ -106,6 +136,7 @@ Either form works; the positional name is the recommended shape.`,
     'get': 'myapi email campaign get <id> [--org <id>]',
     'update': 'myapi email campaign update <id> [--name <str>] [--per-day <n>] [--org <id>]',
     'upload-contacts': 'myapi email campaign upload-contacts <campaign_id> --emails <a@x,b@y> [--org <id>]',
+    'upload-contacts-file': 'myapi email campaign upload-contacts-file <campaign_id> --file <path> [--org <id>]',
     'start': 'myapi email campaign start <id> [--org <id>]',
     'pause': 'myapi email campaign pause <id> [--org <id>]',
     'resume': 'myapi email campaign resume <id> [--org <id>]',
@@ -120,7 +151,8 @@ Subcommands:
   list                List campaigns
   get <id>            Get a single campaign
   update <id>         Patch name / per-day-limit
-  upload-contacts <id>  Upload contact list (--emails a@x,b@y)
+  upload-contacts <id>       Upload contact list (--emails a@x,b@y)
+  upload-contacts-file <id>  Upload contacts from a CSV file (--file path/to/contacts.csv)
   start <id>          Start a campaign
   pause <id>          Pause a campaign
   resume <id>         Resume a campaign
@@ -143,6 +175,7 @@ All commands accept --org <id> (or set default: myapi config set-org <id>).`);
         case 'get': return get(args[0], flags);
         case 'update': return update(args[0], flags);
         case 'upload-contacts': return uploadContacts(args[0], flags);
+        case 'upload-contacts-file': return uploadContactsFile(args[0], flags);
         case 'start': return start(args[0], flags);
         case 'pause': return pause(args[0], flags);
         case 'resume': return resume(args[0], flags);

package/dist/commands/email/index.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/email/index.js

@@ -2,11 +2,16 @@
 // namespace lives in its own file in this directory; this index just
 // routes to the right one and handles the deprecated flat aliases.
 import { error, info } from '../../output.js';
+// The email index is a dispatcher only; each subcommand file declares
+// its own EXPOSES. Empty here so the coverage tool can still introspect
+// every file uniformly.
+export const EXPOSES = [];
 import * as mailbox from './mailbox.js';
 import * as message from './message.js';
 import * as warmup from './warmup.js';
 import * as template from './template.js';
 import * as campaign from './campaign.js';
+import * as verify from './verify.js';
 export const SCHEMA = {
     org: 'string',
     domain: 'string',
@@ -27,6 +32,7 @@ export const SCHEMA = {
     name: 'string',
     emails: 'string',
     'per-day': 'number',
+    file: 'string',
 };
 // Old flat subcommand → [namespace, sub]. Kept so existing scripts/skills
 // don't break. Emits a one-line stderr deprecation note then runs the new
@@ -63,6 +69,7 @@ async function dispatchNamespace(ns, sub, restArgs, flags) {
         case 'warmup': return warmup.run(sub, restArgs, flags);
         case 'template': return template.run(sub, restArgs, flags);
         case 'campaign': return campaign.run(sub, restArgs, flags);
+        case 'verify': return verify.run(sub, restArgs, flags);
         default: error(`Unknown namespace: ${ns}. Run "myapi email --help" for the list.`);
     }
 }
@@ -76,12 +83,14 @@ Namespaces:
   warmup     Warmup controls (account-scoped) — start, pause, resume, stop, stats
   template   Email templates (org-scoped) — generate, list, edit, send-test, delete
   campaign   Email campaigns (org-scoped) — create, list, get, update, upload-contacts, start, pause, resume, stats
+  verify     Sync single-address email verification (org-scoped) — syntax + DNS + Microsoft probe
 
 Examples:
   myapi email mailbox create hello@example.com
   myapi email message send --from a@x --to b@y --subject hi --body "hello"
   myapi email template generate welcome --prompt "Welcome email"
   myapi email campaign create "Q2 Launch" --template-id <id> --from a@x
+  myapi email verify alice@example.com
 
 Org-scoped commands accept --org <id> (or set default: myapi config set-org <id>).
 Run "myapi email <namespace> --help" for namespace-specific commands.`);

package/dist/commands/email/mailbox.d.ts

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

package/dist/commands/email/mailbox.js

@@ -1,6 +1,11 @@
 import { email as sdkEmail } from '@myapihq/sdk';
 import { requireConfig } from '../../config.js';
 import { success, error, printTable, info } from '../../output.js';
+export const EXPOSES = [
+    'POST /email/mailboxes/create',
+    'GET /email/mailboxes',
+    'POST /email/sending/activate',
+];
 async function create(addressArg, flags) {
     const config = requireConfig();
     // Convention: first required arg is positional. For mailboxes that's the

package/dist/commands/email/message.d.ts

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

package/dist/commands/email/message.js

@@ -1,6 +1,14 @@
 import { email as sdkEmail } from '@myapihq/sdk';
 import { requireConfig } from '../../config.js';
 import { success, error, printTable, printJson, info } from '../../output.js';
+export const EXPOSES = [
+    'POST /email/send',
+    'GET /email/status/{message_id}',
+    'GET /email/sent',
+    'GET /email/inbox/{address}',
+    'GET /email/outbox/{address}',
+    'GET /email/message/{message_id}',
+];
 async function send(flags) {
     const config = requireConfig();
     if (!flags.from || !flags.to || !flags.subject) {

package/dist/commands/email/template.d.ts

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

package/dist/commands/email/template.js

@@ -3,6 +3,16 @@ import { requireConfig } from '../../config.js';
 import { success, error, printTable, printJson, info } from '../../output.js';
 import { pollJob } from '../../utils.js';
 import { requireOrg } from '../../helpers.js';
+export const EXPOSES = [
+    'POST /email/orgs/{org_id}/templates/generate',
+    'GET /email/orgs/{org_id}/template-jobs/{job_id}',
+    'GET /email/orgs/{org_id}/templates',
+    'GET /email/orgs/{org_id}/templates/{template_id}',
+    'POST /email/orgs/{org_id}/templates/{template_id}/edit',
+    'POST /email/orgs/{org_id}/templates/{template_id}/send-test',
+    'DELETE /email/orgs/{org_id}/templates/{template_id}',
+    'GET /email/templates/{template_id}/preview',
+];
 async function generate(nameArg, flags) {
     const config = requireConfig();
     const orgId = requireOrg(flags, config, 'myapi email template generate <name> --prompt <str> [--org <id>]');
@@ -39,6 +49,44 @@ async function list(flags) {
         empty: 'No templates yet. Generate one with: myapi email template generate --prompt <p> --name <n>',
     });
 }
+async function get(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi email template get <id> [--org <id>]');
+    if (!id)
+        error('Missing required arguments.\nUsage: myapi email template get <id> [--org <id>]');
+    const tmpl = await sdkEmail.getTemplate(config.api_key, orgId, id);
+    if (flags.json) {
+        printJson(tmpl);
+        return;
+    }
+    info(`ID:         ${tmpl.id}`);
+    info(`Name:       ${tmpl.name}`);
+    info(`Subject:    ${tmpl.subject}`);
+    info(`Preview:    ${tmpl.preview_url}`);
+    info(`Created:    ${tmpl.created_at}`);
+    info(`Updated:    ${tmpl.updated_at}`);
+}
+async function preview(id, flags) {
+    if (!id)
+        error('Missing required arguments.\nUsage: myapi email template preview <id> [--json]');
+    // Endpoint is unauthenticated by design — access is gated by the unguessable
+    // template_id, so anyone with the id can render the preview (this matches
+    // the "share-this-link-with-your-marketer" pattern).
+    const res = await sdkEmail.getTemplatePreview(id);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    if (res.preview_url)
+        info(`Preview URL: ${res.preview_url}`);
+    if (res.subject)
+        info(`Subject:     ${res.subject}`);
+    if (res.html)
+        info(`\n--- HTML ---\n${res.html}`);
+    // Fall back to dumping the whole response if we got something unfamiliar.
+    if (!res.preview_url && !res.subject && !res.html)
+        printJson(res);
+}
 async function edit(id, flags) {
     const config = requireConfig();
     const orgId = requireOrg(flags, config, 'myapi email template edit <id> --prompt <str> [--org <id>]');
@@ -69,6 +117,8 @@ const USAGE = {
 
 Either form works; the positional name is the recommended shape.`,
     'list': 'myapi email template list [--org <id>] [--json]',
+    'get': 'myapi email template get <id> [--org <id>] [--json]',
+    'preview': 'myapi email template preview <id> [--json]',
     'edit': 'myapi email template edit <id> --prompt <str> [--org <id>]',
     'send-test': 'myapi email template send-test <template_id> --to <email> [--org <id>]',
     'delete': 'myapi email template delete <id> [--org <id>]',
@@ -80,6 +130,8 @@ export async function run(sub, args, flags) {
 Subcommands:
   generate <name>    Generate AI template (--prompt)
   list               List templates
+  get <id>           Get a template's metadata (subject, preview URL, ...)
+  preview <id>       Get a template's rendered preview (no auth required)
   edit <id>          Edit a template via prompt
   send-test <id>     Send a test email for a template (--to)
   delete <id>        Delete a template
@@ -98,6 +150,8 @@ All commands accept --org <id> (or set default: myapi config set-org <id>).`);
     switch (sub) {
         case 'generate': return generate(args[0], flags);
         case 'list': return list(flags);
+        case 'get': return get(args[0], flags);
+        case 'preview': return preview(args[0], flags);
         case 'edit': return edit(args[0], flags);
         case 'send-test': return sendTest(args[0], flags);
         case 'delete': return del(args[0], flags);

package/dist/commands/email/verify.d.ts

@@ -0,0 +1,7 @@
+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 VERIFY_HELP = "Usage: myapi email verify <email> [--org <id>] [--json]\n\nSync single-address email verification. Cheap layer only: syntax + DNS +\nMicrosoft GetCredentialType. Returns a verdict in <1s for ~50% of inputs;\nthe rest get verdict='unknown' with smtp_recommended=true.\n\nVerdicts:\n  deliverable    high-confidence \u2014 the address accepts mail\n  undeliverable  high-confidence \u2014 syntax bad, DNS missing, or Microsoft rejects\n  unknown        not enough signal; consider an SMTP probe (not in this API)\n\nUse --json for the full check breakdown (syntax / DNS / Microsoft probes).\n";
+export declare function run(emailArg: string | undefined, _rest: string[], flags?: Flags): Promise<void>;

package/dist/commands/email/verify.js

@@ -0,0 +1,52 @@
+import { email as sdkEmail } from '@myapihq/sdk';
+import { requireConfig } from '../../config.js';
+import { error, info, printJson } from '../../output.js';
+import { requireOrg } from '../../helpers.js';
+export const EXPOSES = [
+    'POST /email/orgs/{org_id}/verify',
+];
+export const SCHEMA = {};
+export const VERIFY_HELP = `Usage: myapi email verify <email> [--org <id>] [--json]
+
+Sync single-address email verification. Cheap layer only: syntax + DNS +
+Microsoft GetCredentialType. Returns a verdict in <1s for ~50% of inputs;
+the rest get verdict='unknown' with smtp_recommended=true.
+
+Verdicts:
+  deliverable    high-confidence — the address accepts mail
+  undeliverable  high-confidence — syntax bad, DNS missing, or Microsoft rejects
+  unknown        not enough signal; consider an SMTP probe (not in this API)
+
+Use --json for the full check breakdown (syntax / DNS / Microsoft probes).
+`;
+export async function run(emailArg, _rest, flags = {}) {
+    if (flags.help) {
+        info(VERIFY_HELP);
+        return;
+    }
+    if (!emailArg)
+        error('Missing required argument <email>.\nUsage: myapi email verify <email> [--org <id>] [--json]');
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi email verify <email> [--org <id>]');
+    const res = await sdkEmail.verifyEmail(config.api_key, orgId, emailArg);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    const verdictLabel = res.verdict === 'deliverable' ? '✓ deliverable'
+        : res.verdict === 'undeliverable' ? '✗ undeliverable'
+            : '? unknown';
+    info(`Email:      ${res.email}`);
+    info(`Verdict:    ${verdictLabel}  (confidence ${res.confidence.toFixed(2)})`);
+    info(`SMTP next:  ${res.smtp_recommended ? 'yes — consider an SMTP probe' : 'no — verdict is definitive'}`);
+    info(`Took:       ${res.elapsed_ms}ms`);
+    if (res.checks.syntax.detail)
+        info(`Syntax:     ${res.checks.syntax.detail}`);
+    if (res.checks.dns && res.checks.dns.mx_records && res.checks.dns.mx_records.length > 0) {
+        const mx = res.checks.dns.mx_records.filter(Boolean);
+        if (mx.length > 0)
+            info(`MX:         ${mx.slice(0, 3).join(', ')}${mx.length > 3 ? ` (+${mx.length - 3} more)` : ''}`);
+    }
+    if (res.checks.microsoft)
+        info(`Microsoft:  ${res.checks.microsoft.verdict}`);
+}

package/dist/commands/email/warmup.d.ts

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

package/dist/commands/email/warmup.js

@@ -1,6 +1,13 @@
 import { email as sdkEmail } from '@myapihq/sdk';
 import { requireConfig } from '../../config.js';
 import { success, error, printJson, info } from '../../output.js';
+export const EXPOSES = [
+    'POST /email/warmup/start',
+    'POST /email/warmup/pause',
+    'POST /email/warmup/resume',
+    'POST /email/warmup/stop',
+    'GET /email/warmup/stats/{address}',
+];
 export async function run(sub, args, flags) {
     if (!sub || (flags.help && !sub)) {
         info('Usage: myapi email warmup <start|pause|resume|stop|stats> --address <email>');

package/dist/commands/funnel.d.ts

@@ -1,10 +1,13 @@
 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 list(flags: Flags): Promise<void>;
 export declare function create(flags: Flags): Promise<void>;
 export declare function get(id: string, flags: Flags): Promise<void>;
 export declare function del(id: string, flags: Flags): Promise<void>;
+export declare function pages(funnelArg: string, flags: Flags): Promise<void>;
 export declare function push(slug: string, flags: Flags): Promise<void>;
 export declare function verify(slug: string, flags: Flags): Promise<void>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/funnel.js

@@ -3,6 +3,16 @@ import { requireConfig } from '../config.js';
 import { success, error, printTable, info, printJson } from '../output.js';
 import { formatDate } from '../utils.js';
 import { requireOrg } from '../helpers.js';
+export const EXPOSES = [
+    'POST /funnel/orgs/{org_id}/funnels',
+    'GET /funnel/orgs/{org_id}/funnels',
+    'GET /funnel/orgs/{org_id}/funnels/{funnel_id}',
+    'DELETE /funnel/orgs/{org_id}/funnels/{funnel_id}',
+    'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/push-page',
+    'POST /funnel/orgs/{org_id}/funnels/{funnel_id}/verify',
+    'GET /funnel/orgs/{org_id}/funnels/{funnel_id}/pages',
+    'GET /hq/orgs/{org_id}',
+];
 export const SCHEMA = {
     org: 'string',
     funnel: 'string',
@@ -74,6 +84,24 @@ export async function del(id, flags) {
     await sdkFunnel.deleteFunnel(config.api_key, orgId, id);
     success(`Funnel ${id} deleted`);
 }
+// List the pages currently published to a funnel. Resolves the funnel id
+// from positional arg, --funnel flag, or the user's default funnel.
+export async function pages(funnelArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi funnel pages [funnel_id] [--funnel <id>] [--org <id>]');
+    const funnelId = funnelArg || flags.funnel || config.default_funnel;
+    if (!funnelId)
+        error('Missing funnel id. Pass it as a positional arg, --funnel <id>, or set: myapi config set-funnel <id>');
+    const list = await sdkFunnel.listFunnelPages(config.api_key, orgId, funnelId);
+    if (flags.json) {
+        printJson(list);
+        return;
+    }
+    printTable(list, {
+        flags,
+        empty: 'No pages published to this funnel yet. Push one with: echo "<h1>Hello</h1>" | myapi funnel push /',
+    });
+}
 export async function push(slug, flags) {
     const config = requireConfig();
     const orgId = requireOrg(flags, config, 'myapi funnel push [slug] [--funnel <id>] [--org <id>]');
@@ -158,6 +186,7 @@ const SUBCOMMAND_USAGE = {
     'create': 'myapi funnel create [--org <id>]',
     'get': 'myapi funnel get <id> [--org <id>] [--json]',
     'delete': 'myapi funnel delete <id> [--org <id>]',
+    'pages': 'myapi funnel pages [funnel_id] [--funnel <id>] [--org <id>] [--json]',
     'push': `myapi funnel push [slug] [--funnel <id>] [--slug <path>] [--org <id>] < page.html
 
 Reads HTML from stdin and publishes to <slug> on your funnel. Funnel is resolved
@@ -194,6 +223,7 @@ Subcommands:
   get <id>   Get funnel details
   delete     Delete a funnel
   push       Push a raw HTML page from stdin to a slug
+  pages      List the pages currently published to a funnel
   verify     Verify a published page is reachable
 
 All commands accept --org <id> (or set default: myapi config set-org <id>).`);
@@ -214,6 +244,7 @@ All commands accept --org <id> (or set default: myapi config set-org <id>).`);
         case 'delete': return del(args[0], flags);
         case 'push': return push(args[0], flags);
         case 'verify': return verify(args[0], flags);
+        case 'pages': return pages(args[0], flags);
         default: error(`Unknown subcommand: ${subcommand}. Run "myapi funnel --help" for a list of valid subcommands.`);
     }
 }

package/dist/commands/image.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/image.js

@@ -3,8 +3,16 @@ import { requireConfig } from '../config.js';
 import { success, error, printTable, info, printJson, banner } from '../output.js';
 import { formatDate, pollJob } from '../utils.js';
 import { requireOrg, requireArg } from '../helpers.js';
+export const EXPOSES = [
+    'POST /image/orgs/{org_id}/generate',
+    'GET /image/orgs/{org_id}/jobs/{job_id}',
+    'GET /image/orgs/{org_id}/list',
+    'GET /image/orgs/{org_id}/models',
+    'DELETE /image/orgs/{org_id}/images/{image_id}',
+];
 export const SCHEMA = {
     org: 'string',
+    model: 'string',
     prompt: 'string',
     ratio: 'string',
     style: 'string',
@@ -14,7 +22,6 @@ export const SCHEMA = {
 const VALID_RATIOS = new Set(['1:1', '16:9', '9:16', '4:3', '3:4']);
 // Hex list: optional leading #, 3 or 6 hex digits, comma-separated.
 const HEX_LIST_RE = /^#?[0-9a-fA-F]{3}(?:[0-9a-fA-F]{3})?(?:\s*,\s*#?[0-9a-fA-F]{3}(?:[0-9a-fA-F]{3})?)*$/;
-const PRICE_USD = 0.05;
 function summarizeImage(j) {
     const prompt = (j.prompt || '');
     const truncated = prompt.length > 60 ? prompt.slice(0, 60) + '...' : prompt;
@@ -29,11 +36,11 @@ function summarizeImage(j) {
 }
 async function generate(promptArg, flags) {
     const config = requireConfig();
-    const orgId = requireOrg(flags, config, 'myapi image generate <prompt> [--ratio 1:1|16:9|9:16|4:3|3:4] [--style <s>] [--colors <hex,hex>] [--text] [--org <id>]');
+    const orgId = requireOrg(flags, config, 'myapi image generate <prompt> [--model <id>] [--ratio 1:1|16:9|9:16|4:3|3:4] [--style <s>] [--colors <hex,hex>] [--text] [--org <id>]');
     // Convention: first required arg is positional. --prompt still works for back-compat.
     const prompt = promptArg || flags.prompt;
     if (!prompt) {
-        error('Missing required arguments.\nUsage: myapi image generate <prompt> [--ratio <ratio>] [--style <s>] [--colors <c>] [--text] [--org <id>]\n   or: myapi image generate --prompt "<text>" ...');
+        error('Missing required arguments.\nUsage: myapi image generate <prompt> [--model <id>] [--ratio <ratio>] [--style <s>] [--colors <c>] [--text] [--org <id>]\n   or: myapi image generate --prompt "<text>" ...');
     }
     // Client-side validation: catch typos before they round-trip.
     if (flags.ratio && !VALID_RATIOS.has(flags.ratio)) {
@@ -43,6 +50,8 @@ async function generate(promptArg, flags) {
         error(`Invalid --colors "${flags.colors}". Expected comma-separated hex like "#ff6600,#003366" (3- or 6-digit, # optional).`);
     }
     const payload = { prompt };
+    if (flags.model)
+        payload.model = flags.model;
     if (flags.ratio)
         payload.aspect_ratio = flags.ratio;
     if (flags.style)
@@ -51,9 +60,9 @@ async function generate(promptArg, flags) {
         payload.colors = flags.colors;
     if (flags.text)
         payload.has_text = true;
-    // Cost preview before kickoff. Goes to stderr (banner) so --json output
-    // stays clean for piping.
-    banner(`› Charging $${PRICE_USD.toFixed(2)} for this image generation…`);
+    // Cost is per-model — see `myapi image models`. Banner shown on stderr so
+    // --json output stays clean for piping.
+    banner(`› Generating image${payload.model ? ` (${payload.model})` : ''}…`);
     const job = await sdkImage.generateImage(config.api_key, orgId, payload);
     const final = await pollJob({
         label: 'Generating image',
@@ -124,10 +133,26 @@ async function del(id, flags) {
     await sdkImage.deleteImage(config.api_key, orgId, id);
     success(`Image ${id} deleted (job history retained, URL nullified)`);
 }
+async function models(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi image models [--org <id>]');
+    const res = await sdkImage.listModels(config.api_key, orgId);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    printTable(res.models.map(m => ({
+        id: m.id,
+        kind: m.kind,
+        default_size: m.default_size,
+        aspect_ratios: m.aspect_ratios.join(', '),
+        cost_per_image: `$${m.cost_per_image_usd}`,
+    })), { flags, empty: 'No image models available.' });
+}
 // ── Dispatcher ───────────────────────────────────────────────────────────────
 const SUBCOMMAND_USAGE = {
     'list': 'myapi image list [--org <id>] [--json]',
-    'generate': `myapi image generate <prompt> [--ratio 1:1|16:9|9:16|4:3|3:4] [--style <s>] [--colors <hex,hex>] [--text] [--org <id>]
+    'generate': `myapi image generate <prompt> [--model <id>] [--ratio 1:1|16:9|9:16|4:3|3:4] [--style <s>] [--colors <hex,hex>] [--text] [--org <id>]
        myapi image generate --prompt "<text>" ...
 
 Either form works; the positional prompt is the recommended shape.
@@ -136,9 +161,11 @@ Generation is asynchronous — the CLI polls for up to 90s. If it times out
 the job keeps running server-side; re-fetch with:
   myapi image get <job_id>
 
-Cost: $${PRICE_USD.toFixed(2)} per generation. Failed jobs aren't charged.
+Cost is per-model; run "myapi image models" for the catalog and rates.
+Failed jobs aren't charged.
 
 Flags:
+  --model   Model id from the catalog (default: gemini-2.5-flash-image)
   --ratio   Aspect ratio (allowed: ${[...VALID_RATIOS].join(', ')}; default 1:1)
   --style   Free-form style hint (e.g. "watercolor", "cyberpunk neon")
   --colors  Hex colors comma-separated (e.g. "#ff6600,#003366")
@@ -153,6 +180,11 @@ Prints just the asset URL. Errors if the job hasn't completed yet.
 Curl-friendly:
   curl -O "$(myapi image get-url <id>)"`,
     'delete': 'myapi image delete <job_id> [--org <id>]',
+    'models': `myapi image models [--org <id>] [--json]
+
+Lists available image-generation models with per-image pricing and
+supported aspect ratios. Mirrors "myapi llm models" for the image
+primitive.`,
 };
 export async function run(subcommand, args, flags) {
     if (!subcommand || (flags.help && !subcommand)) {
@@ -160,9 +192,10 @@ export async function run(subcommand, args, flags) {
 
 Subcommands:
   list                List all your generated images
-  generate <prompt>   Generate a new AI image (async, polls up to 90s, $${PRICE_USD.toFixed(2)})
+  generate <prompt>   Generate a new AI image (async, polls up to 90s; pricing per model — see "image models")
   get <job_id>        Fetch full job metadata (JSON or human-readable)
   get-url <job_id>    Print just the asset URL (curl-friendly)
+  models              List available image models with per-image pricing
   delete <job_id>     Delete the asset (job history retained)
 
 All commands accept --org <id> (or set default: myapi config set-org <id>).
@@ -182,6 +215,7 @@ The asset lands in your org's storage and is also visible via "myapi storage lis
         case 'generate': return generate(args[0], flags);
         case 'get': return get(args[0], flags);
         case 'get-url': return getUrl(args[0], flags);
+        case 'models': return models(flags);
         case 'delete': return del(args[0], flags);
         default: error(`Unknown subcommand: ${subcommand}. Run "myapi image --help" for available subcommands.`);
     }

package/dist/commands/keys.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 runApiKeys(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;
 export declare function createNew(flags: Flags): Promise<void>;

package/dist/commands/keys.js

@@ -7,6 +7,11 @@ import { requireArg } from '../helpers.js';
 export const SCHEMA = {
     name: 'string',
 };
+export const EXPOSES = [
+    'POST /hq/account/create/key',
+    'GET /hq/account/keys',
+    'DELETE /hq/account/delete/key/{key_id}',
+];
 const KEYS_HEADER = `Usage: myapi keys <subcommand>
 
 Manage programmatic API keys for your account.

package/dist/commands/llm.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>;