@usenaive-sdk/cli 0.12.5 → 0.13.1

package/dist/lib/deprecation.js

@@ -0,0 +1,140 @@
+import { agentError, setPendingDeprecation } from "../output.js";
+/**
+ * The eight names the legacy orchestration runtime answers to in this tree.
+ * Exported so a staleness check can hold it against the source rather than
+ * against memory — a list like this becomes folklore the moment nothing reads it.
+ */
+export const LEGACY_RUNTIME_ALIASES = [
+    "orchestration",
+    "warm pool",
+    "instance pool",
+    "Hermes",
+    "sidecar",
+    "container runtime",
+    "hosted runtime",
+    "runtime.pool",
+];
+const MIGRATION_GUIDE = "https://usenaive.ai/docs/migration-guides/legacy-orchestration-to-durable-teams";
+/** Build the full record from the commander command plus its spec. */
+export function deprecationRecord(cmd, spec) {
+    return { ...spec, subject: `naive ${cmd.name()}` };
+}
+/** The machine half — what rides the stdout envelope. */
+export function deprecationNotice(rec, status) {
+    return {
+        id: rec.id,
+        subject: rec.subject,
+        status,
+        replacement: rec.replacement,
+        since: rec.since,
+        sunset: rec.sunset.kind === "frozen" ? "frozen" : { on: rec.sunset.date },
+        guide: rec.guide,
+    };
+}
+function sunsetLine(rec) {
+    return rec.sunset.kind === "frozen"
+        ? "frozen, no sunset date"
+        : `sunset ${rec.sunset.date}`;
+}
+function replacementLines(rec) {
+    if (rec.replacement.kind === "use") {
+        return [`  Use instead:  ${rec.replacement.what}`];
+    }
+    // The honest row. There is no replacement, and the reason is mandatory.
+    return [
+        "  Use instead:  nothing — this capability has no replacement.",
+        `  Because:      ${rec.replacement.because}`,
+    ];
+}
+/**
+ * The banner, as a string. Pure, so the wording is a test rather than a habit.
+ * The first line carries the two facts an operator needs before anything else:
+ * it is deprecated, and it KEEPS WORKING.
+ */
+export function renderDeprecationBanner(rec) {
+    const lines = [];
+    lines.push(`⚠ \`${rec.subject}\` is DEPRECATED and will keep working.        [${rec.id}]`);
+    lines.push(`  It drives ${rec.drives}`);
+    if (rec.alsoCalled.length > 0) {
+        lines.push(`  (also called: ${rec.alsoCalled.join(", ")})`);
+    }
+    lines.push(...replacementLines(rec));
+    lines.push(`  Why:          ${rec.why}`);
+    for (const gap of rec.gaps ?? []) {
+        lines.push(`  No replacement for \`${rec.subject} ${gap.sub}\`: ${gap.because}`);
+    }
+    lines.push(`  Since ${rec.since} · ${sunsetLine(rec)} · migration guide:`);
+    lines.push(`  ${rec.guide}`);
+    return lines.join("\n") + "\n";
+}
+/**
+ * Emitted ids, so the banner appears ONCE per process even when a group's hook
+ * and a future subcommand's hook both fire. Exported for tests only.
+ */
+const _emitted = new Set();
+export function _resetDeprecationBannersForTest() {
+    _emitted.clear();
+}
+/**
+ * Mark a command group deprecated. The group keeps working; every invocation
+ * writes the banner to stderr (once per process) and attaches the machine notice
+ * to the next stdout envelope.
+ *
+ * Returns the record so the caller can assert on it — the registry in index.ts is
+ * built from the return values, which is what makes the set of deprecations a
+ * value a test can read instead of a side effect it has to observe.
+ */
+export function markDeprecated(cmd, spec) {
+    const rec = deprecationRecord(cmd, spec);
+    cmd.hook("preAction", () => {
+        setPendingDeprecation(deprecationNotice(rec, "deprecated"));
+        if (!_emitted.has(rec.id)) {
+            _emitted.add(rec.id);
+            process.stderr.write(renderDeprecationBanner(rec));
+        }
+        // and then nothing. The action runs.
+    });
+    return rec;
+}
+/**
+ * A RETIRED command: it no longer does anything, and saying so is the whole
+ * behaviour. Distinct from `markDeprecated`, which never refuses.
+ *
+ * ── WHY THE CODE IS `deprecated_command` AND WHY IT IS NOT IN THE SERVER UNION ──
+ *
+ * `platform/kernel/src/errors.ts` holds a 25-member `ErrorCode` union typed as
+ * `Record<ErrorCode, number>` in `STATUS_MAP` — it is the set of codes an HTTP
+ * RESPONSE can carry, and every member owes a status. `deprecated_command` is
+ * minted here, by the CLI, for a command that makes no request at all: there is
+ * no response and therefore no status to map. Adding it to that union would put
+ * a code the server can never emit into the type that says what the server emits.
+ *
+ * It is instead the fourth member of the CLI-LOCAL code namespace that already
+ * exists in this package and is already relied on by callers:
+ * `cli_outdated` and `unknown_subcommand` (lib/unknown-command.ts:8) and
+ * `upstream_error` (client.ts:97). All three are minted client-side and none is
+ * in the server union. `CLI_LOCAL_ERROR_CODES` below names the set so it stays a
+ * declared four rather than a habit.
+ */
+export const CLI_LOCAL_ERROR_CODES = [
+    "cli_outdated",
+    "unknown_subcommand",
+    "upstream_error",
+    "deprecated_command",
+];
+export function retiredCommand(opts) {
+    if (opts.notice)
+        setPendingDeprecation(opts.notice);
+    // A retired command's notice cannot ride a success envelope — there isn't one —
+    // so in machine mode the id travels on the error object instead.
+    agentError({
+        action: opts.action,
+        error: {
+            code: "deprecated_command",
+            message: opts.message,
+            ...(opts.notice && { deprecation: opts.notice }),
+        },
+        recovery_steps: opts.recovery_steps,
+    });
+}
+//# sourceMappingURL=deprecation.js.map

package/dist/lib/deprecation.js.map

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

package/dist/lib/duration.d.ts

@@ -0,0 +1,8 @@
+export type DurationParse = {
+    ok: true;
+    value: number;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function parseDurationArg(raw: string): DurationParse;

package/dist/lib/duration.js

@@ -0,0 +1,11 @@
+export function parseDurationArg(raw) {
+    const n = Number(raw);
+    if (raw.trim() === "" || !Number.isFinite(n) || n <= 0) {
+        return {
+            ok: false,
+            message: `--duration must be a positive number of seconds (e.g. 5 or 10); got "${raw}"`,
+        };
+    }
+    return { ok: true, value: n };
+}
+//# sourceMappingURL=duration.js.map

package/dist/lib/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/lib/duration.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,wEAAwE,GAAG,GAAG;SACxF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAChC,CAAC"}

package/dist/lib/http-response.d.ts

@@ -0,0 +1,11 @@
+export interface ParsedHttpResponse {
+    status: number;
+    data: unknown;
+}
+/**
+ * Parse an API response without assuming every proxy/error page is JSON.
+ * Empty successful responses remain valid; every other non-JSON response is
+ * converted to the same structured error shape the CLI already understands.
+ */
+export declare function parseHttpResponse(response: Response): Promise<ParsedHttpResponse>;
+export declare function networkErrorResponse(error: unknown): ParsedHttpResponse;

package/dist/lib/http-response.js

@@ -0,0 +1,96 @@
+const MAX_RESPONSE_PREVIEW = 240;
+function redactSecrets(value) {
+    return value
+        .replace(/\b((?:nv|dr)_sk_)[A-Za-z0-9._-]+/gi, "$1[redacted]")
+        .replace(/\b(Bearer\s+)[A-Za-z0-9._~-]+/gi, "$1[redacted]");
+}
+function safePreview(value) {
+    const preview = redactSecrets(value)
+        .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/[\u0000-\u001f\u007f]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, MAX_RESPONSE_PREVIEW);
+    return preview || undefined;
+}
+function codeForStatus(status) {
+    if (status === 401)
+        return "unauthorized";
+    if (status === 403)
+        return "forbidden";
+    if (status === 404)
+        return "resource_not_found";
+    if (status === 429)
+        return "rate_limited";
+    if (status >= 500)
+        return "internal_error";
+    return "invalid_input";
+}
+/**
+ * Parse an API response without assuming every proxy/error page is JSON.
+ * Empty successful responses remain valid; every other non-JSON response is
+ * converted to the same structured error shape the CLI already understands.
+ */
+export async function parseHttpResponse(response) {
+    const contentType = response.headers.get("content-type")?.split(";", 1)[0]?.trim() || undefined;
+    const text = await response.text();
+    const jsonText = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    if (!text.trim()) {
+        if (response.ok || response.status === 204)
+            return { status: response.status, data: {} };
+        return {
+            status: response.status,
+            data: {
+                error: {
+                    code: codeForStatus(response.status),
+                    message: `Naive API returned an empty error response (HTTP ${response.status}).`,
+                    hint: "Retry once; if this persists, the API route or upstream proxy may be unavailable.",
+                    upstream_status: response.status,
+                    ...(contentType && { content_type: contentType }),
+                },
+            },
+        };
+    }
+    const looksJson = /(?:^|[+/])json$/i.test(contentType ?? "") || /^[\[{]/.test(jsonText.trim());
+    if (looksJson) {
+        try {
+            return { status: response.status, data: JSON.parse(jsonText) };
+        }
+        catch {
+            // Fall through to the structured invalid-response envelope below.
+        }
+    }
+    const normalizedStatus = response.ok ? 502 : response.status;
+    const preview = safePreview(text);
+    return {
+        status: normalizedStatus,
+        data: {
+            error: {
+                code: codeForStatus(normalizedStatus),
+                message: `Naive API returned ${contentType ?? "a non-JSON response"} instead of JSON (HTTP ${response.status}).`,
+                hint: response.status === 404
+                    ? "The requested API route may not be deployed yet. Check the target environment and retry."
+                    : "Retry once; if this persists, check API or upstream-provider health.",
+                upstream_status: response.status,
+                ...(contentType && { content_type: contentType }),
+                ...(preview && { response_preview: preview }),
+            },
+        },
+    };
+}
+export function networkErrorResponse(error) {
+    return {
+        status: 503,
+        data: {
+            error: {
+                code: "network_error",
+                message: "Could not reach the Naive API.",
+                hint: "Check your connection and NAIVE_BASE_URL, then retry.",
+                cause: error instanceof Error ? error.message : String(error),
+            },
+        },
+    };
+}
+//# sourceMappingURL=http-response.js.map

package/dist/lib/http-response.js.map

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

package/dist/lib/pricing.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Fixed public prices mirrored from the API meters, so CLI copy cannot silently
+ * drift from billing. Keep dynamic model costs out of this table.
+ *
+ * The source of truth is `FIXED_CREDIT_COSTS` in platform/billing/src/pricing.ts
+ * and `pricing-parity.test.ts` holds the two equal. This header used to name
+ * packages/api/src/lib/pricing.ts — a path the #497 restructure deleted — and
+ * to promise a "dogfood contract test" that no file in the repo implemented.
+ */
+export declare const FIXED_CREDIT_COSTS: {
+    readonly emailSend: 0.016;
+    readonly webSearch: 0.2;
+    readonly urlRead: 0.05;
+    readonly researchQuick: 0.5;
+    readonly researchThorough: 1;
+    readonly researchExhaustive: 1.6;
+    readonly brainQuery: 0.08;
+    readonly brainIngestBase: 0.1;
+    readonly brainIngestPerKb: 0.0002;
+    readonly brainIngestMaxCredits: 10;
+    readonly socialPost: 2.5;
+    readonly socialXPost: 0.5;
+    readonly socialXPostWithLink: 5;
+};
+/**
+ * The DataForSEO-backed data primitives (seo / aeo / app-data / business /
+ * ecommerce), mirrored from `DATA_API_CREDIT_COSTS` in
+ * platform/billing/src/pricing.ts, which is where the reasoning, the vendor list
+ * price behind each number and the market anchor live. Held equal to it by
+ * packages/api/src/__tests__/credit-price-parity.test.ts.
+ *
+ * These are LIST prices. A charge is additionally floored at 1.2× what the call
+ * cost us upstream, so a row-heavy response can settle above the figure quoted
+ * here — which is why every CLI hint renders the response's own `credits_used`
+ * and only the `--help` epilogues quote this table.
+ */
+export declare const DATA_API_CREDIT_COSTS: {
+    readonly seoKeywordsAdsLive: 2;
+    readonly seoKeywordsAdsStandard: 1.5;
+    readonly seoKeywordsTrendsLive: 0.25;
+    readonly seoKeywordsTrendsStandard: 0.2;
+    readonly seoBacklinksStandard: 1.8;
+    readonly seoBacklinksBulk: 17;
+    readonly seoLabsStandard: 0.75;
+    readonly seoLabsBulk: 5.4;
+    readonly seoLabsHistorical: 10;
+    readonly aeoLlmResponsesLive: 1.2;
+    readonly aeoLlmResponsesStandard: 1.2;
+    readonly aeoLlmScraperLive: 0.16;
+    readonly aeoLlmScraperStandard: 0.08;
+    readonly appDataAppSearches: 0.85;
+    readonly appDataAppList: 0.85;
+    readonly appDataAppInfo: 0.05;
+    readonly appDataAppReviews: 6;
+    readonly businessGoogleInfoLive: 0.13;
+    readonly businessGoogleInfoStandard: 0.09;
+    readonly businessGoogleUpdatesStandard: 3;
+    readonly businessGoogleReviewsStandard: 1.5;
+    readonly businessGoogleQaLive: 0.3;
+    readonly businessGoogleQaStandard: 0.18;
+    readonly businessGoogleHotelLive: 0.1;
+    readonly businessGoogleHotelStandard: 0.07;
+    readonly businessTrustpilotSearchStandard: 0.34;
+    readonly businessTrustpilotReviewsStandard: 0.85;
+    readonly businessTripadvisorSearchStandard: 0.85;
+    readonly businessTripadvisorReviewsStandard: 1.25;
+    readonly businessSocialLive: 0.1;
+    readonly ecommerceGoogleProducts: 0.15;
+    readonly ecommerceGoogleProductInfo: 0.14;
+    readonly ecommerceGoogleSellers: 0.24;
+    readonly ecommerceGoogleReviews: 2.2;
+    readonly ecommerceAmazonProducts: 0.14;
+    readonly ecommerceAmazonAsin: 0.04;
+    readonly ecommerceAmazonSellers: 0.14;
+};
+/**
+ * The two row-metered families, whose price is a base plus a per-row rate rather
+ * than a flat figure. Mirrored from the same module; `appListingsCredits` /
+ * `aeoLlmMentionsCredits` there are the functions that bill.
+ */
+export declare const METERED_DATA_API_CREDITS: {
+    readonly llmMentionsBase: 2.4;
+    readonly llmMentionsPerRow: 0.024;
+    readonly llmMentionsMaxRows: 1000;
+    readonly llmMentionsDefaultRows: 100;
+    readonly appListingsBase: 2.4;
+    readonly appListingsPerItem: 0.024;
+    readonly aiKeywordsBase: 0.4;
+    readonly aiKeywordsPerKeyword: 0.004;
+};
+/** `2.4 + 0.024 × rows`, the LLM Mentions price the API charges for `rows` rows. */
+export declare function llmMentionsCredits(rows: number): number;
+/** `2.4 + 0.024 × limit`, the live app-listings price for a given `--limit`. */
+export declare function appListingsCredits(limit: number): number;
+export declare function reportedCreditsUsed(data: unknown, fallback: number): number;
+export interface CreditPack {
+    id: string;
+    credits: number;
+    priceInCents: number;
+    badge?: string;
+}
+/**
+ * The one-time credit packs, mirrored field-for-field from `CREDIT_PACKS` in
+ * platform/billing/src/billing.ts — the table `createTopupCheckout` bills
+ * Stripe from. The CLI ships to npm with five runtime dependencies and cannot
+ * import the billing package, so this is a mirror; `pricing-parity.test.ts`
+ * imports both and fails on any divergence.
+ *
+ * 🔴 EVERY pack figure the CLI prints must come from here. The `--help`
+ * epilogue and the `--pack` option description used to carry two independent
+ * hand-typed copies, and one of them drifted to a tenth of the real price.
+ */
+export declare const CREDIT_PACKS: readonly CreditPack[];
+/** `$23` — whole dollars, matching how the API renders `getCreditPacks().price`. */
+export declare function packPrice(pack: CreditPack): string;
+/** `medium (500 credits, $23)` — the inline form for an option description. */
+export declare function packInline(pack: CreditPack): string;
+/** One column-aligned row of the pack table in `naive billing --help`. */
+export declare function packRow(pack: CreditPack): string;
+/**
+ * The flat 9:16 vertical-reframe / face-tracking fee, in credits, mirrored from
+ * `usdToBillableCredits(REFRAME_FEE_USD_PER_JOB)` in
+ * platform/billing/src/pricing.ts — the value clipCost() adds to a reframed
+ * job's subtotal. Charged once per job, not per clip.
+ *
+ * The CLI used to advertise this as "typically $0.05–$0.30 per job", which is
+ * the band clip-job-cost-audit.md records the CLI advertising while the code
+ * charged nothing at all. It is now a flat fee, billed in credits like every
+ * other driver, and this constant is held equal to the meter by
+ * packages/api/src/__tests__/credit-price-parity.test.ts.
+ */
+export declare const REFRAME_FEE_CREDITS = 4;

package/dist/lib/pricing.js

@@ -0,0 +1,148 @@
+/**
+ * Fixed public prices mirrored from the API meters, so CLI copy cannot silently
+ * drift from billing. Keep dynamic model costs out of this table.
+ *
+ * The source of truth is `FIXED_CREDIT_COSTS` in platform/billing/src/pricing.ts
+ * and `pricing-parity.test.ts` holds the two equal. This header used to name
+ * packages/api/src/lib/pricing.ts — a path the #497 restructure deleted — and
+ * to promise a "dogfood contract test" that no file in the repo implemented.
+ */
+export const FIXED_CREDIT_COSTS = {
+    emailSend: 0.016,
+    webSearch: 0.2,
+    urlRead: 0.05,
+    researchQuick: 0.5,
+    researchThorough: 1,
+    researchExhaustive: 1.6,
+    brainQuery: 0.08,
+    brainIngestBase: 0.1,
+    brainIngestPerKb: 0.0002,
+    brainIngestMaxCredits: 10,
+    socialPost: 2.5,
+    socialXPost: 0.5,
+    socialXPostWithLink: 5,
+};
+/**
+ * The DataForSEO-backed data primitives (seo / aeo / app-data / business /
+ * ecommerce), mirrored from `DATA_API_CREDIT_COSTS` in
+ * platform/billing/src/pricing.ts, which is where the reasoning, the vendor list
+ * price behind each number and the market anchor live. Held equal to it by
+ * packages/api/src/__tests__/credit-price-parity.test.ts.
+ *
+ * These are LIST prices. A charge is additionally floored at 1.2× what the call
+ * cost us upstream, so a row-heavy response can settle above the figure quoted
+ * here — which is why every CLI hint renders the response's own `credits_used`
+ * and only the `--help` epilogues quote this table.
+ */
+export const DATA_API_CREDIT_COSTS = {
+    seoKeywordsAdsLive: 2,
+    seoKeywordsAdsStandard: 1.5,
+    seoKeywordsTrendsLive: 0.25,
+    seoKeywordsTrendsStandard: 0.2,
+    seoBacklinksStandard: 1.8,
+    seoBacklinksBulk: 17,
+    seoLabsStandard: 0.75,
+    seoLabsBulk: 5.4,
+    seoLabsHistorical: 10,
+    aeoLlmResponsesLive: 1.2,
+    aeoLlmResponsesStandard: 1.2,
+    aeoLlmScraperLive: 0.16,
+    aeoLlmScraperStandard: 0.08,
+    appDataAppSearches: 0.85,
+    appDataAppList: 0.85,
+    appDataAppInfo: 0.05,
+    appDataAppReviews: 6,
+    businessGoogleInfoLive: 0.13,
+    businessGoogleInfoStandard: 0.09,
+    businessGoogleUpdatesStandard: 3,
+    businessGoogleReviewsStandard: 1.5,
+    businessGoogleQaLive: 0.3,
+    businessGoogleQaStandard: 0.18,
+    businessGoogleHotelLive: 0.1,
+    businessGoogleHotelStandard: 0.07,
+    businessTrustpilotSearchStandard: 0.34,
+    businessTrustpilotReviewsStandard: 0.85,
+    businessTripadvisorSearchStandard: 0.85,
+    businessTripadvisorReviewsStandard: 1.25,
+    businessSocialLive: 0.1,
+    ecommerceGoogleProducts: 0.15,
+    ecommerceGoogleProductInfo: 0.14,
+    ecommerceGoogleSellers: 0.24,
+    ecommerceGoogleReviews: 2.2,
+    ecommerceAmazonProducts: 0.14,
+    ecommerceAmazonAsin: 0.04,
+    ecommerceAmazonSellers: 0.14,
+};
+/**
+ * The two row-metered families, whose price is a base plus a per-row rate rather
+ * than a flat figure. Mirrored from the same module; `appListingsCredits` /
+ * `aeoLlmMentionsCredits` there are the functions that bill.
+ */
+export const METERED_DATA_API_CREDITS = {
+    llmMentionsBase: 2.4,
+    llmMentionsPerRow: 0.024,
+    llmMentionsMaxRows: 1000,
+    llmMentionsDefaultRows: 100,
+    appListingsBase: 2.4,
+    appListingsPerItem: 0.024,
+    aiKeywordsBase: 0.4,
+    aiKeywordsPerKeyword: 0.004,
+};
+/** `2.4 + 0.024 × rows`, the LLM Mentions price the API charges for `rows` rows. */
+export function llmMentionsCredits(rows) {
+    const capped = Math.min(Math.max(rows, 1), METERED_DATA_API_CREDITS.llmMentionsMaxRows);
+    return Math.ceil((METERED_DATA_API_CREDITS.llmMentionsBase + METERED_DATA_API_CREDITS.llmMentionsPerRow * capped) * 100) / 100;
+}
+/** `2.4 + 0.024 × limit`, the live app-listings price for a given `--limit`. */
+export function appListingsCredits(limit) {
+    return Math.ceil((METERED_DATA_API_CREDITS.appListingsBase + METERED_DATA_API_CREDITS.appListingsPerItem * Math.max(limit, 1)) * 100) / 100;
+}
+export function reportedCreditsUsed(data, fallback) {
+    const value = data?.credits_used;
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+/**
+ * The one-time credit packs, mirrored field-for-field from `CREDIT_PACKS` in
+ * platform/billing/src/billing.ts — the table `createTopupCheckout` bills
+ * Stripe from. The CLI ships to npm with five runtime dependencies and cannot
+ * import the billing package, so this is a mirror; `pricing-parity.test.ts`
+ * imports both and fails on any divergence.
+ *
+ * 🔴 EVERY pack figure the CLI prints must come from here. The `--help`
+ * epilogue and the `--pack` option description used to carry two independent
+ * hand-typed copies, and one of them drifted to a tenth of the real price.
+ */
+export const CREDIT_PACKS = [
+    { id: "small", credits: 200, priceInCents: 1000 },
+    { id: "medium", credits: 500, priceInCents: 2300, badge: "Popular" },
+    { id: "large", credits: 1000, priceInCents: 4400, badge: "Best Value" },
+    { id: "xl", credits: 2500, priceInCents: 10000 },
+];
+/** `$23` — whole dollars, matching how the API renders `getCreditPacks().price`. */
+export function packPrice(pack) {
+    return `$${(pack.priceInCents / 100).toFixed(0)}`;
+}
+/** `medium (500 credits, $23)` — the inline form for an option description. */
+export function packInline(pack) {
+    return `${pack.id} (${pack.credits} credits, ${packPrice(pack)})`;
+}
+/** One column-aligned row of the pack table in `naive billing --help`. */
+export function packRow(pack) {
+    const credits = `${pack.credits} credits`.padEnd(15);
+    const price = pack.badge ? `${packPrice(pack).padEnd(6)}(${pack.badge})` : packPrice(pack);
+    return `  ${pack.id.padEnd(10)}${credits}${price}`;
+}
+/**
+ * The flat 9:16 vertical-reframe / face-tracking fee, in credits, mirrored from
+ * `usdToBillableCredits(REFRAME_FEE_USD_PER_JOB)` in
+ * platform/billing/src/pricing.ts — the value clipCost() adds to a reframed
+ * job's subtotal. Charged once per job, not per clip.
+ *
+ * The CLI used to advertise this as "typically $0.05–$0.30 per job", which is
+ * the band clip-job-cost-audit.md records the CLI advertising while the code
+ * charged nothing at all. It is now a flat fee, billed in credits like every
+ * other driver, and this constant is held equal to the meter by
+ * packages/api/src/__tests__/credit-price-parity.test.ts.
+ */
+export const REFRAME_FEE_CREDITS = 4;
+//# sourceMappingURL=pricing.js.map

package/dist/lib/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/lib/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,GAAG;IAClB,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,GAAG;IACvB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,MAAM;IACxB,qBAAqB,EAAE,EAAE;IACzB,UAAU,EAAE,GAAG;IACf,WAAW,EAAE,GAAG;IAChB,mBAAmB,EAAE,CAAC;CACd,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,kBAAkB,EAAE,CAAC;IACrB,sBAAsB,EAAE,GAAG;IAC3B,qBAAqB,EAAE,IAAI;IAC3B,yBAAyB,EAAE,GAAG;IAC9B,oBAAoB,EAAE,GAAG;IACzB,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,GAAG;IAChB,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,GAAG;IACxB,uBAAuB,EAAE,GAAG;IAC5B,iBAAiB,EAAE,IAAI;IACvB,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,CAAC;IACpB,sBAAsB,EAAE,IAAI;IAC5B,0BAA0B,EAAE,IAAI;IAChC,6BAA6B,EAAE,CAAC;IAChC,6BAA6B,EAAE,GAAG;IAClC,oBAAoB,EAAE,GAAG;IACzB,wBAAwB,EAAE,IAAI;IAC9B,uBAAuB,EAAE,GAAG;IAC5B,2BAA2B,EAAE,IAAI;IACjC,gCAAgC,EAAE,IAAI;IACtC,iCAAiC,EAAE,IAAI;IACvC,iCAAiC,EAAE,IAAI;IACvC,kCAAkC,EAAE,IAAI;IACxC,kBAAkB,EAAE,GAAG;IACvB,uBAAuB,EAAE,IAAI;IAC7B,0BAA0B,EAAE,IAAI;IAChC,sBAAsB,EAAE,IAAI;IAC5B,sBAAsB,EAAE,GAAG;IAC3B,uBAAuB,EAAE,IAAI;IAC7B,mBAAmB,EAAE,IAAI;IACzB,sBAAsB,EAAE,IAAI;CACpB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,eAAe,EAAE,GAAG;IACpB,iBAAiB,EAAE,KAAK;IACxB,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,GAAG;IAC3B,eAAe,EAAE,GAAG;IACpB,kBAAkB,EAAE,KAAK;IACzB,cAAc,EAAE,GAAG;IACnB,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IACxF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,wBAAwB,CAAC,eAAe,GAAG,wBAAwB,CAAC,iBAAiB,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACjI,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,wBAAwB,CAAC,eAAe,GAAG,wBAAwB,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC9I,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAa,EAAE,QAAgB;IACjE,MAAM,KAAK,GAAI,IAA0C,EAAE,YAAY,CAAC;IACxE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChF,CAAC;AASD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE;IACjD,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;IACpE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE;IACvE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE;CACjD,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,aAAa,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;AACpE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,OAAO,CAAC,IAAgB;IACtC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3F,OAAO,KAAK,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC"}