@myapihq/cli 1.1.0-wip.4 → 1.2.0

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>;

package/dist/commands/llm.js

@@ -0,0 +1,156 @@
+import * as fs from 'fs';
+import { llm as sdkLlm } from '@myapihq/sdk';
+import { requireConfig } from '../config.js';
+import { error, info, printTable, printJson } from '../output.js';
+import { requireOrg } from '../helpers.js';
+export const EXPOSES = [
+    'POST /llm/orgs/{org_id}/complete',
+    'POST /llm/orgs/{org_id}/embed',
+    'GET /llm/orgs/{org_id}/models',
+];
+export const SCHEMA = {
+    org: 'string',
+    model: 'string',
+    system: 'string',
+    'max-tokens': 'number',
+    temperature: 'number',
+    stop: 'string',
+    file: 'string',
+    kind: 'string',
+};
+function readPromptArg(promptArg, flags) {
+    if (typeof flags.file === 'string' && flags.file) {
+        return fs.readFileSync(flags.file, 'utf-8');
+    }
+    if (promptArg === '-') {
+        return fs.readFileSync(0, 'utf-8');
+    }
+    return promptArg ?? '';
+}
+const DEFAULT_CHAT_MODEL = 'gemini-3.1-flash-lite-preview';
+async function complete(promptArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi llm complete "<prompt>" [--model <id>] [--system <s>] [--max-tokens N] [--temperature 0..1] [--stop <csv>] [--org <id>]');
+    const model = typeof flags.model === 'string' && flags.model ? flags.model : DEFAULT_CHAT_MODEL;
+    const prompt = readPromptArg(promptArg, flags);
+    if (!prompt.trim())
+        error('Empty prompt. Pass <prompt> as an argument, "-" to read stdin, or --file <path>.');
+    const messages = [];
+    if (typeof flags.system === 'string' && flags.system) {
+        messages.push({ role: 'system', content: flags.system });
+    }
+    messages.push({ role: 'user', content: prompt });
+    const stop = typeof flags.stop === 'string' && flags.stop
+        ? flags.stop.split(',').map(s => s.trim()).filter(Boolean)
+        : undefined;
+    const res = await sdkLlm.complete(config.api_key, orgId, {
+        model,
+        messages,
+        max_tokens: typeof flags['max-tokens'] === 'number' ? flags['max-tokens'] : undefined,
+        temperature: typeof flags.temperature === 'number' ? flags.temperature : undefined,
+        stop,
+    });
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    info(res.content);
+    // Usage footer on stderr so it doesn't pollute piped output.
+    process.stderr.write(`\n— ${res.model} · ${res.usage.input_tokens}+${res.usage.output_tokens} tokens · $${res.usage.cost_usd.toFixed(6)} · ${res.finish_reason}\n`);
+}
+async function embed(inputArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi llm embed "<text>" --model <id> [--org <id>]');
+    const model = typeof flags.model === 'string' ? flags.model : '';
+    if (!model)
+        error('Missing required flag: --model. Run "myapi llm models" to list embed models.');
+    const text = readPromptArg(inputArg, flags);
+    if (!text.trim())
+        error('Empty input. Pass <text> as an argument, "-" to read stdin, or --file <path>.');
+    const res = await sdkLlm.embed(config.api_key, orgId, { model, input: text });
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    const first = res.embeddings[0] ?? [];
+    info(`${res.model} · dim=${first.length} · ${res.usage.input_tokens} tokens · $${res.usage.cost_usd.toFixed(6)}`);
+    info(`first 5: [${first.slice(0, 5).map(n => n.toFixed(6)).join(', ')}${first.length > 5 ? ', ...' : ''}]`);
+    info(`(pass --json for the full vector)`);
+}
+async function listModels(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi llm models [--kind chat|embed] [--org <id>]');
+    const res = await sdkLlm.listModels(config.api_key, orgId);
+    const kind = typeof flags.kind === 'string' ? flags.kind : '';
+    const models = kind ? res.models.filter(m => m.kind === kind) : res.models;
+    if (flags.json) {
+        printJson({ models });
+        return;
+    }
+    printTable(models.map(m => ({
+        id: m.id,
+        kind: m.kind,
+        context: m.context ?? '',
+        dimensions: m.dimensions ?? '',
+        in_per_1m: `$${m.input_per_1m}`,
+        out_per_1m: m.output_per_1m != null ? `$${m.output_per_1m}` : '',
+    })), { flags, empty: 'No models available.' });
+}
+const SUBCOMMAND_USAGE = {
+    complete: `myapi llm complete "<prompt>" [--model <id>]
+       [--system "<system msg>"] [--max-tokens N] [--temperature 0..1]
+       [--stop <csv>] [--file <path>] [--org <id>] [--json]
+
+  Default model: gemini-3.1-flash-lite-preview (cheap + fast). Pass --model
+  to override; run "myapi llm models" to see the catalog.
+
+  Pass "-" as the prompt to read from stdin. The reply goes to stdout;
+  a one-line usage footer (tokens + cost) goes to stderr so it doesn't
+  pollute piped output.
+
+  Examples:
+    myapi llm complete "summarize: $(cat README.md)"
+    cat draft.md | myapi llm complete - --model gemini-3.1-pro-preview --system "You are an editor"
+    myapi llm complete --file prompt.txt --max-tokens 200`,
+    embed: `myapi llm embed "<text>" --model <id> [--file <path>] [--org <id>] [--json]
+
+  Returns a vector summary by default; pass --json for the full vector.
+
+  Examples:
+    myapi llm embed "the quick brown fox" --model gemini-embedding-001
+    myapi llm embed --file doc.txt --model gemini-embedding-001 --json > doc.vec.json`,
+    models: `myapi llm models [--kind chat|embed] [--org <id>] [--json]
+
+  Lists the model catalog with per-1M-token pricing at upstream rates.
+  Models prefixed with vendor name pass through to that vendor; un-prefixed
+  models (when available) run on MyAPI's own inference.`,
+};
+export async function run(subcommand, args, flags) {
+    if (!subcommand || (flags.help && !subcommand)) {
+        info(`Usage: myapi llm <subcommand>
+
+Subcommands:
+  complete   Chat completion — returns reply + usage (default model: gemini-3.1-flash-lite-preview)
+  embed      Text embedding — returns vector + usage
+  models     List available models (chat + embed) with pricing
+
+All commands accept --org <id> (or set default: myapi config set-org <id>).
+Use this for workflow steps and scripted pipelines — not as a replacement
+for your own reasoning. The agent has its own model already.`);
+        return;
+    }
+    if (flags.help) {
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi llm --help" for the list.`);
+        return;
+    }
+    switch (subcommand) {
+        case 'complete': return complete(args[0], flags);
+        case 'embed': return embed(args[0], flags);
+        case 'models': return listModels(flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi llm --help" for valid subcommands.`);
+    }
+}

package/dist/commands/org.d.ts

@@ -1,9 +1,12 @@
 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 create(restArgs: string[], flags: Flags): Promise<void>;
 export declare function list(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 update(restArgs: string[], flags: Flags): Promise<void>;
 export declare function importOrg(args: string[], flags: Flags): Promise<void>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;