@meterapp/car-image 1.0.0

package/dist/commands/catalog.js

@@ -0,0 +1,169 @@
+import { COLORS, VIEWS } from "@meterapp/car-image-sdk";
+import { flagChoice, flagInteger, flagString } from "../args.js";
+import { CliError } from "../errors.js";
+import { cliCommandFor } from "../mcp/server.js";
+import { keyValues, paint, printJson, table } from "../output.js";
+function yearsLabel(years) {
+    if (!years || years.length === 0)
+        return "—";
+    const min = Math.min(...years);
+    const max = Math.max(...years);
+    return min === max ? String(min) : `${min}–${max}`;
+}
+export const searchCommand = {
+    name: "search",
+    summary: "Fuzzy-search the vehicle catalog (free, no key needed)",
+    usage: "car-image search <query…> [--limit 10] [--year <year>] [--json]",
+    async run(ctx) {
+        const query = ctx.args.positionals.join(" ").trim();
+        if (!query)
+            throw new CliError("Missing search query", 2, "Example: car-image search porsche 911");
+        const limit = flagInteger(ctx.args.flags, "limit", { min: 1, max: 100 });
+        const year = flagInteger(ctx.args.flags, "year", { min: 1900, max: 2100 });
+        const result = await ctx.clientContext.client.searchVehicles(query, { limit, year });
+        if (ctx.io.json) {
+            printJson(ctx.io, result);
+            return 0;
+        }
+        const results = result.data.results;
+        if (results.length === 0) {
+            ctx.io.stdout(`No catalog matches for "${query}". Try fewer words or a different spelling.\n`);
+            return 1;
+        }
+        const rows = results.map((hit) => {
+            const view = searchHitView(hit);
+            return [view.kind, view.make, view.model ?? paint(ctx.io, "dim", "(make)"), yearsLabel(view.years), view.match, view.type];
+        });
+        ctx.io.stdout(`${table(rows, ["kind", "make", "model", "years", "match", "type"])}\n`);
+        const first = results.map(searchHitView).find((hit) => hit.kind === "model" && hit.model);
+        if (first?.model) {
+            const year = first.years?.length ? Math.max(...first.years) : new Date().getFullYear();
+            ctx.io.stdout(`\n${paint(ctx.io, "dim", `Try: ${cliCommandFor({ make: first.make, model: first.model, year })}`)}\n`);
+        }
+        return 0;
+    },
+};
+export const resolveCommand = {
+    name: "resolve",
+    summary: "Turn free text into exact image parameters and a ready-to-run command",
+    usage: "car-image resolve <free text…> [--json]\n  e.g. car-image resolve red 2024 porsche 911 side view",
+    async run(ctx) {
+        const query = ctx.args.positionals.join(" ").trim();
+        if (!query)
+            throw new CliError("Missing text to resolve", 2, "Example: car-image resolve red 2024 porsche 911 side view");
+        if (!ctx.clientContext.apiKey)
+            throw new CliError("Not signed in.", 1, "Run `car-image login` or set CAR_IMAGE_API_KEY.");
+        const result = await ctx.clientContext.client.resolve(query);
+        const params = result.data.params;
+        const command = cliCommandFor(params);
+        if (ctx.io.json) {
+            printJson(ctx.io, { ...result, cli: command });
+            return 0;
+        }
+        const rows = [
+            ["make", params.make],
+            ["model", params.model],
+            ["year", String(params.year)],
+            ["view", params.view],
+            ["color", params.color],
+        ];
+        if (params.size)
+            rows.push(["size", params.size]);
+        if (params.width)
+            rows.push(["width", String(params.width)]);
+        if (params.format)
+            rows.push(["format", params.format]);
+        rows.push(["confidence", String(result.data.confidence)]);
+        ctx.io.stdout(`${keyValues(ctx.io, rows)}\n\nRun:\n  ${command}\n`);
+        const candidates = result.data.candidates ?? [];
+        if (candidates.length > 1) {
+            const alternatives = candidates.slice(0, 6).map((candidate) => [
+                String(candidate.make_name ?? candidate.make_slug ?? ""),
+                String(candidate.model_name ?? candidate.model_slug ?? ""),
+                yearsLabel(Array.isArray(candidate.years) ? candidate.years.map(Number) : undefined),
+                String(candidate.match_kind ?? ""),
+            ]);
+            ctx.io.stdout(`\nOther candidates:\n${table(alternatives, ["make", "model", "years", "match"])}\n`);
+        }
+        return 0;
+    },
+};
+export const optionsCommand = {
+    name: "options",
+    summary: "List views, colors, sizes, formats, pricing and catalog coverage",
+    usage: "car-image options [--json]",
+    async run(ctx) {
+        const result = await ctx.clientContext.client.options();
+        if (ctx.io.json) {
+            printJson(ctx.io, result);
+            return 0;
+        }
+        const { data } = result;
+        const io = ctx.io;
+        io.stdout(`${paint(io, "bold", "Views")}\n${table(data.views.map((view) => [view.id, `${view.yaw_degrees}°`, view.label, view.description, view.aliases.length ? `aliases: ${view.aliases.join(", ")}` : ""]), ["id", "yaw", "label", "description", ""])}\n\n`);
+        io.stdout(`${paint(io, "bold", "Colors")}\n${table(data.colors.map((color) => [color.name, color.hex]), ["name", "hex"])}\n\n`);
+        io.stdout(`${paint(io, "bold", "Sizes")}\n${table(Object.entries(data.sizes.presets).map(([name, px]) => [name, `${px} px`]).concat([["max", `${data.sizes.max} px (use --width/--height for exact sizes)`]]), ["preset", "size"])}\n\n`);
+        io.stdout(`${paint(io, "bold", "Formats")}  ${data.formats.join(", ")} (png keeps transparency)\n\n`);
+        io.stdout(`${paint(io, "bold", "Pricing")}  ${data.pricing.credits_per_image} credit per image · $1 = ${data.pricing.credits_per_dollar.toLocaleString("en-US")} credits · ${data.pricing.free_credits} free credits · no subscription\n`);
+        io.stdout(`${paint(io, "bold", "Catalog")}  ${data.catalog.makes.toLocaleString("en-US")} makes, ${data.catalog.models.toLocaleString("en-US")} models, ${data.catalog.years[0]}–${data.catalog.years[1]}${data.catalog.sources?.length ? ` · sources: ${data.catalog.sources.join(", ")}` : ""}\n`);
+        return 0;
+    },
+};
+export const feedbackCommand = {
+    name: "feedback",
+    summary: "Rate a delivered image (by request id or by vehicle) to improve renders",
+    usage: "car-image feedback (--request-id <id> | --make <make> --model <model> --year <year> [--view] [--color])\n                   (--rating 1-5 | --good | --bad) [--reason <text>] [--json]",
+    async run(ctx) {
+        const { flags } = ctx.args;
+        if (!ctx.clientContext.apiKey)
+            throw new CliError("Not signed in.", 1, "Run `car-image login` or set CAR_IMAGE_API_KEY.");
+        const rating = flagInteger(flags, "rating", { min: 1, max: 5 });
+        const verdict = flags.good === true ? "good" : flags.bad === true ? "bad" : undefined;
+        if (flags.good === true && flags.bad === true)
+            throw new CliError("Choose either --good or --bad", 2);
+        if (rating === undefined && verdict === undefined)
+            throw new CliError("Provide --rating 1-5, --good or --bad", 2);
+        const reason = flagString(flags, "reason");
+        const requestId = flagString(flags, "request-id");
+        const base = { rating, verdict, reason };
+        const result = requestId
+            ? await ctx.clientContext.client.feedback({ requestId, ...base })
+            : await (async () => {
+                const make = flagString(flags, "make");
+                const model = flagString(flags, "model");
+                const year = flagString(flags, "year");
+                if (!make || !model || !year)
+                    throw new CliError("Identify the image with --request-id or with --make, --model and --year", 2);
+                const view = flagChoice(flags, "view", VIEWS);
+                const color = flagChoice(flags, "color", COLORS);
+                return ctx.clientContext.client.feedback({ make, model, year, view, color, ...base });
+            })();
+        if (ctx.io.json) {
+            printJson(ctx.io, result);
+            return 0;
+        }
+        ctx.io.stdout(`Thanks — feedback recorded (${verdict ?? `rating ${rating}`}${reason ? `: ${reason}` : ""}). request ${result.request_id}\n`);
+        return 0;
+    },
+};
+/** Search hits may arrive camelCase (catalog lib) or snake_case (REST); normalize for display. */
+export function searchHitView(hit) {
+    const pick = (...keys) => {
+        for (const key of keys) {
+            const value = hit[key];
+            if (typeof value === "string" && value)
+                return value;
+        }
+        return undefined;
+    };
+    const years = Array.isArray(hit.years) ? hit.years.map(Number).filter(Number.isFinite) : undefined;
+    return {
+        kind: pick("kind") ?? "model",
+        make: pick("makeName", "make_name", "make") ?? "",
+        model: pick("modelName", "model_name", "model"),
+        years,
+        match: pick("matchKind", "match_kind", "match") ?? "",
+        type: pick("vehicleType", "vehicle_type", "type") ?? "",
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/commands/catalog.js.map

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

package/dist/commands/describe.js

@@ -0,0 +1,52 @@
+import { formatApiReference } from "@meterapp/car-image-sdk/mcp";
+import { findEndpoints, formatAll, formatEndpoint, formatEndpointList } from "../describe.js";
+import { printJson, warn } from "../output.js";
+export const describeCommand = {
+    name: "describe",
+    summary: "Explain the REST API from /openapi.json (endpoints, params, headers, errors, agent notes)",
+    usage: "car-image describe [<operationId>|<path>|all] [--json]\n  e.g. car-image describe getCarImage · car-image describe /api/v1/image-urls · car-image describe all",
+    async run(ctx) {
+        const { io, clientContext } = ctx;
+        const target = ctx.args.positionals.join(" ").trim();
+        let doc;
+        try {
+            doc = await clientContext.client.openapi();
+        }
+        catch (error) {
+            if (io.json)
+                throw error;
+            io.stderr(`${warn(io, `Could not fetch ${clientContext.baseUrl}/openapi.json (${error instanceof Error ? error.message : String(error)}); showing the built-in reference.`)}\n\n`);
+            io.stdout(`${formatApiReference(target && target !== "all" ? target : undefined)}\n`);
+            return 0;
+        }
+        if (!target) {
+            if (io.json) {
+                printJson(io, findEndpoints(doc, "all").map(({ method, path, operationId, summary }) => ({ method, path, operationId, summary })));
+            }
+            else {
+                io.stdout(`${formatEndpointList(doc)}\n`);
+            }
+            return 0;
+        }
+        if (target === "all") {
+            if (io.json)
+                printJson(io, doc);
+            else
+                io.stdout(`${formatAll(doc)}\n`);
+            return 0;
+        }
+        const matches = findEndpoints(doc, target);
+        if (matches.length === 0) {
+            io.stderr(`No endpoint matches "${target}".\n\n`);
+            io.stdout(`${formatEndpointList(doc)}\n`);
+            return 1;
+        }
+        if (io.json) {
+            printJson(io, matches.map(({ method, path, operationId, operation }) => ({ method, path, operationId, operation })));
+            return 0;
+        }
+        io.stdout(`${matches.map((endpoint) => formatEndpoint(doc, endpoint)).join("\n\n")}\n`);
+        return 0;
+    },
+};
+//# sourceMappingURL=describe.js.map

package/dist/commands/describe.js.map

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

package/dist/commands/doctor.js

@@ -0,0 +1,53 @@
+import { doctorSummary, renderDoctorTable, runDoctor } from "../doctor.js";
+import { fail, ok, paint, printJson } from "../output.js";
+import { confirm } from "../prompts.js";
+import { simpleEvent } from "../telemetry.js";
+/** Shared by `doctor` and onboarding. Returns the exit code. */
+export async function runDoctorCommand(ctx, options = {}) {
+    const { io, clientContext } = ctx;
+    const yes = ctx.args.flags.yes === true;
+    const noImage = ctx.args.flags.image === false || options.quick === true;
+    let includeImage = false;
+    if (!noImage && clientContext.apiKey) {
+        includeImage = yes ? true : await confirm(io, "Also fetch one keyed image to test GET /api/v1/images/car? Costs 1 credit.", false);
+    }
+    if (!io.json && !io.quiet) {
+        io.stderr(`Checking ${clientContext.baseUrl}${options.quick ? " (quick: no paid checks)" : ""}…\n`);
+    }
+    const checks = await runDoctor({
+        client: clientContext.client,
+        publicFetch: (url, init) => fetch(url, { ...init, headers: { ...init?.headers, "User-Agent": clientContext.userAgent } }),
+        hasKey: Boolean(clientContext.apiKey),
+        now: () => Date.now(),
+        includeImage,
+        quick: options.quick === true,
+        onCheck: (check) => {
+            if (io.json || io.quiet || !io.isTTY)
+                return;
+            const mark = check.status === "pass" ? paint(io, "green", "✓") : check.status === "fail" ? paint(io, "red", "✗") : paint(io, "dim", "·");
+            io.stderr(`${mark} ${check.name}${check.latencyMs !== null ? paint(io, "dim", ` ${check.latencyMs} ms`) : ""}\n`);
+        },
+    });
+    const summary = doctorSummary(checks);
+    if (ctx.telemetry.enabled && ctx.telemetry.anonymousId) {
+        ctx.emit(simpleEvent(ctx.telemetry.anonymousId, "cli_doctor", { passed: summary.passed, failed: summary.failed, skipped: summary.skipped, quick: options.quick === true }));
+    }
+    if (io.json) {
+        printJson(io, { ok: summary.ok, base_url: clientContext.baseUrl, summary, checks });
+        return summary.ok ? 0 : 1;
+    }
+    if (io.isTTY && !io.quiet)
+        io.stderr("\n");
+    io.stdout(`${renderDoctorTable(checks, io)}\n\n`);
+    const spent = checks.reduce((total, check) => total + (check.credits ?? 0), 0);
+    const line = `${summary.passed} passed, ${summary.failed} failed, ${summary.skipped} skipped · ${spent} credit${spent === 1 ? "" : "s"} spent`;
+    io.stdout(summary.ok ? `${ok(io, line)}\n` : `${fail(io, line)}\n`);
+    return summary.ok ? 0 : 1;
+}
+export const doctorCommand = {
+    name: "doctor",
+    summary: "Smoke-test every endpoint with your key (spends up to 2 credits; exit 1 on failure)",
+    usage: "car-image doctor [--json] [--yes] [--no-image]\n  --yes       fetch one keyed image without asking (1 credit)\n  --no-image  skip the keyed image fetch",
+    run: (ctx) => runDoctorCommand(ctx),
+};
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/help.js

@@ -0,0 +1,58 @@
+import { BIN_NAME, CLI_VERSION, PACKAGE_NAME } from "../version.js";
+export function helpText(entries, command) {
+    if (command) {
+        const entry = entries.find((candidate) => candidate.name === command);
+        if (entry) {
+            return `${BIN_NAME} ${entry.name} — ${entry.summary}\n\nUsage:\n  ${entry.usage.split("\n").join("\n  ")}\n\nGlobal options: --json --quiet --base-url <url> --api-key <key> --no-color -h/--help -v/--version\n`;
+        }
+    }
+    const width = Math.max(...entries.map((entry) => entry.name.length));
+    const commands = entries.map((entry) => `  ${entry.name.padEnd(width)}  ${entry.summary}`).join("\n");
+    return `${BIN_NAME} ${CLI_VERSION} — Car Image API by Meter (${PACKAGE_NAME})
+Studio-quality, transparent-background renders of any vehicle. 1 credit per image, $1 = 1,000 credits, 100 free.
+
+Usage:
+  ${BIN_NAME}                      interactive onboarding (login, account, quick check)
+  ${BIN_NAME} <command> [options]
+
+Commands:
+${commands}
+
+Global options:
+  --json               machine-readable output on stdout
+  --quiet, -q          only errors and essential output
+  --base-url <url>     API origin (default https://car-imgs.vercel.app; env CAR_IMAGE_API_URL)
+  --api-key <key>      override the stored key for this run (env CAR_IMAGE_API_KEY)
+  --no-color           disable colors (env NO_COLOR)
+  -h, --help           show help (also \`${BIN_NAME} <command> --help\`)
+  -v, --version        print the version
+
+Environment:
+  CAR_IMAGE_API_KEY    API key (takes priority over the saved credential)
+  CAR_IMAGE_API_URL    API origin
+  CAR_IMAGE_CONFIG     path to config.json (default $XDG_CONFIG_HOME/car-image-api/config.json)
+  CAR_IMAGE_TELEMETRY  set to 0 to disable anonymous usage events
+
+Examples:
+  ${BIN_NAME} login
+  ${BIN_NAME} get --make Porsche --model 911 --year 2024 --view side --color red --out porsche.png
+  ${BIN_NAME} url --make BMW --model M3 --year 2022 --ttl 86400
+  ${BIN_NAME} resolve red 2024 porsche 911 side view
+  ${BIN_NAME} agent-config --host claude-code
+  ${BIN_NAME} doctor --yes
+
+Exit codes: 0 ok, 1 failure, 2 usage error. Docs: https://car-imgs.vercel.app/docs
+`;
+}
+export function helpCommand(entries) {
+    return {
+        name: "help",
+        summary: "Show help for all commands or one command",
+        usage: "car-image help [command]",
+        async run(ctx) {
+            ctx.io.stdout(helpText(entries(), ctx.args.positionals[0] ?? null));
+            return 0;
+        },
+    };
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQpE,MAAM,UAAU,QAAQ,CAAC,OAAoB,EAAE,OAAuB;IACpE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QACtE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,iBAAiB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,yGAAyG,CAAC;QACpN,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtG,OAAO,GAAG,QAAQ,IAAI,WAAW,8BAA8B,YAAY;;;;IAIzE,QAAQ;IACR,QAAQ;;;EAGV,QAAQ;;;;;;;;2CAQiC,QAAQ;;;;;;;;;;IAU/C,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;;;CAGX,CAAC;AACF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,2CAA2C;QACpD,KAAK,EAAE,0BAA0B;QACjC,KAAK,CAAC,GAAG,CAAC,GAAmB;YAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/images.js

@@ -0,0 +1,168 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { COLORS, FORMATS, SIZES, VIEWS, suggestedFileName } from "@meterapp/car-image-sdk";
+import { flagBoolean, flagChoice, flagInteger, flagString, requireString } from "../args.js";
+import { CliError } from "../errors.js";
+import { ok, paint, printJson } from "../output.js";
+const SIZE_NAMES = Object.keys(SIZES);
+/** Builds ImageParams from --make/--model/--year/--view/--color/--size/--width/--height/--format. */
+export function imageParamsFromFlags(flags, options = {}) {
+    const require = options.requireVehicle !== false;
+    const make = require ? requireString(flags, "make", "Example: --make Porsche --model 911 --year 2024") : flagString(flags, "make");
+    const model = require ? requireString(flags, "model", "Example: --make Porsche --model 911 --year 2024") : flagString(flags, "model");
+    const year = require ? requireString(flags, "year", "Example: --make Porsche --model 911 --year 2024") : flagString(flags, "year");
+    const params = { make: make ?? "", model: model ?? "", year: year ?? "" };
+    const view = flagChoice(flags, "view", VIEWS);
+    if (view)
+        params.view = view;
+    const color = flagChoice(flags, "color", COLORS);
+    if (color)
+        params.color = color;
+    const size = flagChoice(flags, "size", SIZE_NAMES);
+    if (size)
+        params.size = size;
+    const width = flagInteger(flags, "width", { min: 1, max: 1024 });
+    if (width !== undefined)
+        params.width = width;
+    const height = flagInteger(flags, "height", { min: 1, max: 1024 });
+    if (height !== undefined)
+        params.height = height;
+    const rawFormat = flagString(flags, "format");
+    if (rawFormat) {
+        const normalized = rawFormat.toLowerCase() === "jpeg" ? "jpg" : rawFormat.toLowerCase();
+        if (!FORMATS.includes(normalized))
+            throw new CliError(`Invalid --format "${rawFormat}". Choose one of: ${FORMATS.join(", ")}`, 2);
+        params.format = normalized;
+    }
+    return params;
+}
+export const getCommand = {
+    name: "get",
+    summary: "Download one image (1 credit) or print a signed URL with --url",
+    usage: "car-image get --make <make> --model <model> --year <year> [--view front-3-4] [--color silver]\n               [--size thumb|small|medium|large | --width <px> --height <px>] [--format png|webp|jpg]\n               [--out <file> | --out -] [--url] [--json]",
+    async run(ctx) {
+        const { io, clientContext } = ctx;
+        const params = imageParamsFromFlags(ctx.args.flags);
+        if (!clientContext.apiKey)
+            throw new CliError("Not signed in.", 1, "Run `car-image login` or set CAR_IMAGE_API_KEY.");
+        if (flagBoolean(ctx.args.flags, "url")) {
+            const result = await clientContext.client.getImageUrl(params);
+            if (io.json) {
+                printJson(io, result);
+            }
+            else {
+                io.stdout(`${result.data.url}\n`);
+                if (!io.quiet) {
+                    io.stderr(`Expires ${result.data.expires_at} · charged ${result.billing.credits_charged} credit, ${result.billing.credits_remaining.toLocaleString("en-US")} remaining · request ${result.request_id}\n`);
+                }
+            }
+            return 0;
+        }
+        const image = await clientContext.client.getImage(params);
+        const out = flagString(ctx.args.flags, "out") ?? suggestedFileName({ ...params, format: params.format ?? formatFromContentType(image.contentType) });
+        if (out === "-") {
+            process.stdout.write(Buffer.from(image.bytes));
+        }
+        else {
+            await writeFile(out, Buffer.from(image.bytes));
+        }
+        const meta = {
+            file: out === "-" ? null : out,
+            bytes: image.bytes.byteLength,
+            content_type: image.contentType,
+            width: image.width,
+            height: image.height,
+            source: image.source,
+            credits_charged: image.creditsCharged,
+            credits_remaining: image.creditsRemaining,
+            request_id: image.requestId,
+        };
+        if (io.json) {
+            if (out === "-")
+                io.stderr(`${JSON.stringify(meta)}\n`);
+            else
+                printJson(io, meta);
+            return 0;
+        }
+        const size = image.width && image.height ? `${image.width}×${image.height} ` : "";
+        const line = `${out === "-" ? "Wrote image to stdout" : `Saved ${out}`} (${size}${image.contentType.replace("image/", "")}, ${(image.bytes.byteLength / 1024).toFixed(1)} KB, ${image.source ?? "unknown"}) — charged ${image.creditsCharged ?? "?"} credit, ${image.creditsRemaining?.toLocaleString("en-US") ?? "?"} remaining${image.requestId ? ` · request ${image.requestId}` : ""}`;
+        (out === "-" ? io.stderr : io.stdout)(`${ok(io, line)}\n`);
+        if (!io.quiet && image.requestId && out !== "-") {
+            io.stdout(paint(io, "dim", `Rate it: car-image feedback --request-id ${image.requestId} --good|--bad\n`));
+        }
+        return 0;
+    },
+};
+function formatFromContentType(contentType) {
+    if (contentType.includes("webp"))
+        return "webp";
+    if (contentType.includes("jpeg") || contentType.includes("jpg"))
+        return "jpg";
+    return "png";
+}
+async function readBatch(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (error) {
+        throw new CliError(`Cannot read batch file ${path}: ${error instanceof Error ? error.message : String(error)}`, 2);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new CliError(`Batch file ${path} is not valid JSON`, 2, 'Expected an array of {"make","model","year",...} objects or {"images":[...]}.');
+    }
+    const list = Array.isArray(parsed) ? parsed : parsed && typeof parsed === "object" && Array.isArray(parsed.images) ? parsed.images : null;
+    if (!list)
+        throw new CliError(`Batch file ${path} must contain an array or an {"images": [...]} object`, 2);
+    if (list.length < 1 || list.length > 50)
+        throw new CliError(`Batch file must contain 1 to 50 images (found ${list.length})`, 2);
+    return list.map((entry, index) => {
+        if (!entry || typeof entry !== "object")
+            throw new CliError(`Batch entry ${index} is not an object`, 2);
+        const record = entry;
+        const make = record.make ?? record.brand;
+        if (typeof make !== "string" || typeof record.model !== "string" || (typeof record.year !== "number" && typeof record.year !== "string")) {
+            throw new CliError(`Batch entry ${index} needs make, model and year`, 2);
+        }
+        const params = { make, model: record.model, year: record.year };
+        for (const key of ["view", "color", "size", "format"]) {
+            if (typeof record[key] === "string")
+                params[key] = record[key];
+        }
+        for (const key of ["width", "height"]) {
+            if (typeof record[key] === "number")
+                params[key] = record[key];
+        }
+        return params;
+    });
+}
+export const urlCommand = {
+    name: "url",
+    summary: "Create signed, key-free delivery URLs (1 credit each) for browsers and documents",
+    usage: "car-image url --make <make> --model <model> --year <year> [--view] [--color] [--size|--width|--height] [--format]\n               [--ttl 3600] [--max-uses 0] [--json]\ncar-image url --batch images.json [--ttl 3600] [--max-uses 0] [--json]",
+    async run(ctx) {
+        const { io, clientContext } = ctx;
+        if (!clientContext.apiKey)
+            throw new CliError("Not signed in.", 1, "Run `car-image login` or set CAR_IMAGE_API_KEY.");
+        const batchPath = flagString(ctx.args.flags, "batch");
+        const images = batchPath ? await readBatch(batchPath) : [imageParamsFromFlags(ctx.args.flags)];
+        const ttlSeconds = flagInteger(ctx.args.flags, "ttl", { min: 60, max: 604800 });
+        const maxUses = flagInteger(ctx.args.flags, "max-uses", { min: 0 });
+        const result = await clientContext.client.createImageUrls(images, { ttlSeconds, maxUses });
+        if (io.json) {
+            printJson(io, result);
+            return 0;
+        }
+        for (const entry of result.data)
+            io.stdout(`${entry.url}\n`);
+        if (!io.quiet) {
+            const first = result.data[0];
+            io.stderr(`${result.data.length} URL${result.data.length === 1 ? "" : "s"}${first ? `, expire ${first.expires_at}, max uses ${first.max_uses === 0 ? "unlimited" : first.max_uses}` : ""} · charged ${result.billing.credits_charged} credit${result.billing.credits_charged === 1 ? "" : "s"}, ${result.billing.credits_remaining.toLocaleString("en-US")} remaining · request ${result.request_id}\n`);
+        }
+        return 0;
+    },
+};
+//# sourceMappingURL=images.js.map

package/dist/commands/images.js.map

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

package/dist/commands/index.js

@@ -0,0 +1,44 @@
+import { agentConfigCommand, mcpCommand } from "./agents.js";
+import { billingCommand } from "./billing.js";
+import { feedbackCommand, optionsCommand, resolveCommand, searchCommand } from "./catalog.js";
+import { describeCommand } from "./describe.js";
+import { doctorCommand } from "./doctor.js";
+import { helpCommand } from "./help.js";
+import { getCommand, urlCommand } from "./images.js";
+import { loginCommand, logoutCommand } from "./login.js";
+import { configCommand, telemetryCommand, updateCommand } from "./maintenance.js";
+import { onboardCommand } from "./onboard.js";
+import { whoamiCommand } from "./whoami.js";
+export const COMMANDS = [
+    loginCommand,
+    logoutCommand,
+    whoamiCommand,
+    doctorCommand,
+    getCommand,
+    urlCommand,
+    searchCommand,
+    resolveCommand,
+    optionsCommand,
+    describeCommand,
+    feedbackCommand,
+    billingCommand,
+    mcpCommand,
+    agentConfigCommand,
+    updateCommand,
+    configCommand,
+    telemetryCommand,
+    onboardCommand,
+    helpCommand(() => helpEntries()),
+];
+export function helpEntries() {
+    return COMMANDS.filter((command) => command.name !== "onboard").map(({ name, summary, usage, aliases }) => ({
+        name: aliases?.length ? `${name} (${aliases.join(", ")})` : name,
+        summary,
+        usage,
+    }));
+}
+export function findCommand(name) {
+    const needle = name.toLowerCase();
+    return COMMANDS.find((command) => command.name === needle || command.aliases?.includes(needle));
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAkB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,QAAQ,GAAwB;IAC3C,YAAY;IACZ,aAAa;IACb,aAAa;IACb,aAAa;IACb,UAAU;IACV,UAAU;IACV,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,eAAe;IACf,cAAc;IACd,UAAU;IACV,kBAAkB;IAClB,aAAa;IACb,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1G,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QAChE,OAAO;QACP,KAAK;KACN,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAClG,CAAC"}