@koda-sl/baker-cli 0.2.0

package/README.md

@@ -0,0 +1,229 @@
+# @koda-sl/baker-cli
+
+AI-agent-first CLI for interacting with Baker. Designed for programmatic use by AI agents with structured JSON output, schema introspection, and input hardening.
+
+## Installation
+
+```bash
+npm install @koda-sl/baker-cli
+# or
+pnpm add @koda-sl/baker-cli
+```
+
+## Authentication
+
+Set two environment variables:
+
+```bash
+export BAKER_API_KEY="bk_your_api_key_here"
+export BAKER_API_URL="https://your-baker-instance.convex.site"
+```
+
+- `BAKER_API_KEY` must start with `bk_`
+- `BAKER_API_URL` is your Convex site URL
+
+## Output Format
+
+All commands return a JSON envelope:
+
+```json
+// Success
+{ "ok": true, "data": { ... } }
+
+// Error
+{ "ok": false, "error": { "code": "NOT_FOUND", "message": "Image not found" } }
+
+// Dry-run
+{ "ok": true, "dryRun": true, "operation": "images.delete", "params": { "id": "abc123" } }
+```
+
+Use `--output` to change format:
+
+| Format  | Description                        | Best for        |
+|---------|------------------------------------|-----------------|
+| `json`  | Structured JSON envelope (default) | AI agents       |
+| `files` | Tab-separated, one row per result  | Piping / shell  |
+| `md`    | Markdown table                     | Human reading   |
+
+## Commands
+
+### `baker status`
+
+Check API key validity and connection health.
+
+```bash
+baker status
+# { "ok": true, "data": { "authenticated": true, "apiUrl": "https://..." } }
+```
+
+### `baker images list`
+
+List images with optional filters.
+
+```bash
+# List all ready images
+baker images list --status ready
+
+# Filter by tags and limit results
+baker images list --tags logo,illustration --limit 10
+
+# Compact tab-separated output
+baker images list --output files
+
+# Only return specific fields
+baker images list --fields _id,name,status
+
+# Include full metadata (dimensions, colors, etc.)
+baker images list --full
+
+# Paginate through results
+baker images list --limit 20 --cursor <cursor_from_previous_response>
+```
+
+**Flags:**
+
+| Flag       | Description                                        |
+|------------|----------------------------------------------------|
+| `--status` | Filter: `ready`, `processing`, `uploading`, `error`|
+| `--tags`   | Comma-separated tag names                          |
+| `--source` | Filter by source                                   |
+| `--limit`  | Max results (default 50)                           |
+| `--cursor` | Pagination cursor from previous response           |
+| `--output` | Output format: `json` \| `files` \| `md`           |
+| `--fields` | Comma-separated field names to include             |
+| `--full`   | Include full metadata                              |
+
+### `baker images get <id>`
+
+Get a single image by ID.
+
+```bash
+baker images get j571abc123def
+
+# With full metadata
+baker images get j571abc123def --full
+
+# Alternative flag syntax
+baker images get --image-id j571abc123def
+```
+
+### `baker images search <query>`
+
+Semantic search using hybrid BM25 + vector + reranking.
+
+```bash
+# Basic search
+baker images search "hero banner"
+
+# Limit results and set minimum relevance
+baker images search "team photo" --limit 5 --min-score 0.3
+
+# Include scoring explanation (BM25, vector, rerank scores)
+baker images search "logo" --explain
+
+# Full metadata with markdown output
+baker images search "product shot" --full --output md
+```
+
+**Flags:**
+
+| Flag          | Description                              |
+|---------------|------------------------------------------|
+| `--limit`     | Max results (default 20)                 |
+| `--min-score` | Minimum relevance score, 0-1             |
+| `--explain`   | Include per-result scoring breakdown     |
+| `--output`    | Output format: `json` \| `files` \| `md` |
+| `--fields`    | Comma-separated field names to include   |
+| `--full`      | Include full metadata                    |
+
+### `baker images upload <file>`
+
+Upload an image file. Content type is auto-detected from the file extension.
+
+```bash
+# Upload with auto-detected content type
+baker images upload ./logo.png
+
+# Specify source
+baker images upload ./banner.jpg --source uploaded
+
+# Override content type
+baker images upload ./image.bin --content-type image/webp
+
+# Preview what would happen without uploading
+baker images upload ./logo.png --dry-run
+```
+
+**Flags:**
+
+| Flag             | Description                                    |
+|------------------|------------------------------------------------|
+| `--source`       | Source identifier                              |
+| `--content-type` | MIME type (auto-detected from extension)        |
+| `--dry-run`      | Preview the operation without executing        |
+
+Supported extensions: `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`, `.avif`
+
+### `baker images delete <id>`
+
+Delete an image by ID.
+
+```bash
+# Preview deletion
+baker images delete j571abc123def --dry-run
+# { "ok": true, "dryRun": true, "operation": "images.delete", "params": { "id": "j571abc123def" } }
+
+# Execute deletion
+baker images delete j571abc123def
+```
+
+**Flags:**
+
+| Flag        | Description                              |
+|-------------|------------------------------------------|
+| `--dry-run` | Preview the operation without executing  |
+
+### `baker schema [command]`
+
+Inspect command argument schemas for AI agent introspection.
+
+```bash
+# List all available commands
+baker schema
+# { "ok": true, "data": { "commands": ["images.list", "images.get", ...] } }
+
+# Get schema for a specific command
+baker schema images.search
+# { "ok": true, "data": { "command": "images.search", "args": { ... } } }
+```
+
+## Compact vs Full Output
+
+By default, image responses include only essential fields to minimize token usage:
+
+| Mode      | Fields                                    |
+|-----------|-------------------------------------------|
+| Default   | `_id`, `name`, `imageUrl`, `status`, `tags` |
+| `--full`  | All fields: dimensions, colors, palette, source, timestamps |
+
+## Error Codes
+
+| Code               | Description                          |
+|--------------------|--------------------------------------|
+| `UNAUTHORIZED`     | Invalid or missing API key           |
+| `NOT_FOUND`        | Resource not found                   |
+| `VALIDATION_ERROR` | Invalid input (bad ID, missing args) |
+| `RATE_LIMITED`     | Too many requests                    |
+| `NETWORK_ERROR`    | Connection failed                    |
+| `INTERNAL_ERROR`   | Unexpected server error              |
+
+## For AI Agents
+
+This CLI is designed for AI agent consumption. Key patterns:
+
+1. **Start with `baker schema`** to discover available commands and their arguments
+2. **Use `--dry-run`** on mutations to preview before executing
+3. **Use `--fields`** to request only the data you need (context window discipline)
+4. **Parse the JSON envelope** — check `ok` field before accessing `data`
+5. **Use `--output files`** for compact, pipe-friendly output
+6. **Check `baker status`** first to verify connectivity

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import { imagesCommand } from "./commands/images/index.js";
+import { schemaCommand } from "./commands/schema.js";
+import { statusCommand } from "./commands/status.js";
+const main = defineCommand({
+    meta: {
+        name: "baker",
+        version: "0.1.0",
+        description: `AI-agent-first CLI for Baker.
+
+Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.
+Output: All commands return JSON envelopes: { ok: true, data: ... } or { ok: false, error: { code, message } }.
+Formats: Use --output json|files|md to control output format. Default: json.
+Introspection: Run 'baker schema <command>' to inspect argument schemas.`,
+    },
+    subCommands: {
+        images: imagesCommand,
+        schema: schemaCommand,
+        status: statusCommand,
+    },
+});
+runMain(main);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE;;;;;yEAKwD;KACtE;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;KACtB;CACF,CAAC,CAAC;AAEH,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+type ErrorCode = "UNAUTHORIZED" | "NOT_FOUND" | "VALIDATION_ERROR" | "RATE_LIMITED" | "INTERNAL_ERROR" | "NETWORK_ERROR";
+export declare class ApiError extends Error {
+    code: ErrorCode;
+    constructor(code: ErrorCode, message: string);
+}
+export declare function validateConvexId(id: string): void;
+export declare function apiGet<T>(path: string, params?: Record<string, string>): Promise<T>;
+export declare function apiPost<T>(path: string, body: unknown): Promise<T>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GACV,cAAc,GACd,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,gBAAgB,GAChB,eAAe,CAAC;AAEpB,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,SAAS,CAAC;gBAEJ,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM;CAK7C;AAqBD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIjD;AAkDD,wBAAsB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBzF;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBxE"}

package/dist/client.js

@@ -0,0 +1,119 @@
+import { getEnv } from "./env.js";
+export class ApiError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ApiError";
+        this.code = code;
+    }
+}
+const CONVEX_ID_RE = /^[a-zA-Z0-9_]+$/;
+function hasControlCharacters(value) {
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        // Allow tab (9), newline (10), carriage return (13)
+        if (code < 32 && code !== 9 && code !== 10 && code !== 13) {
+            return true;
+        }
+    }
+    return false;
+}
+function validateStringValue(value) {
+    if (hasControlCharacters(value)) {
+        throw new ApiError("VALIDATION_ERROR", "String value contains invalid control characters");
+    }
+}
+export function validateConvexId(id) {
+    if (!CONVEX_ID_RE.test(id)) {
+        throw new ApiError("VALIDATION_ERROR", `Invalid ID format: "${id}". Expected alphanumeric string.`);
+    }
+}
+function sanitizeParams(params) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(params)) {
+        validateStringValue(value);
+        sanitized[key] = value;
+    }
+    return sanitized;
+}
+function mapHttpError(status) {
+    if (status === 401 || status === 403) {
+        return "UNAUTHORIZED";
+    }
+    if (status === 404) {
+        return "NOT_FOUND";
+    }
+    if (status === 422 || status === 400) {
+        return "VALIDATION_ERROR";
+    }
+    if (status === 429) {
+        return "RATE_LIMITED";
+    }
+    return "INTERNAL_ERROR";
+}
+async function handleResponse(response) {
+    const body = await response.text();
+    if (!response.ok) {
+        let message = `HTTP ${response.status}: ${response.statusText}`;
+        try {
+            const parsed = JSON.parse(body);
+            if (parsed.error?.message) {
+                message = parsed.error.message;
+            }
+        }
+        catch {
+            // Use default message
+        }
+        throw new ApiError(mapHttpError(response.status), message);
+    }
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new ApiError("INTERNAL_ERROR", "Failed to parse API response as JSON");
+    }
+}
+export async function apiGet(path, params) {
+    const env = getEnv();
+    const url = new URL(path, env.BAKER_API_URL);
+    if (params) {
+        const clean = sanitizeParams(params);
+        for (const [key, value] of Object.entries(clean)) {
+            url.searchParams.set(key, value);
+        }
+    }
+    let response;
+    try {
+        response = await fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${env.BAKER_API_KEY}`,
+                Accept: "application/json",
+            },
+        });
+    }
+    catch (err) {
+        throw new ApiError("NETWORK_ERROR", `Request failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+    }
+    return handleResponse(response);
+}
+export async function apiPost(path, body) {
+    const env = getEnv();
+    let response;
+    try {
+        response = await fetch(new URL(path, env.BAKER_API_URL).toString(), {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${env.BAKER_API_KEY}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        throw new ApiError("NETWORK_ERROR", `Request failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+    }
+    return handleResponse(response);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/commands/images/delete.d.ts

@@ -0,0 +1,19 @@
+export declare const deleteCommand: import("citty").CommandDef<{
+    readonly id: {
+        readonly type: "positional";
+        readonly description: "Image ID";
+        readonly required: false;
+    };
+    readonly "image-id": {
+        readonly type: "string";
+        readonly description: "Image ID (alternative to positional)";
+        readonly required: false;
+    };
+    readonly "dry-run": {
+        readonly type: "boolean";
+        readonly description: "Preview without executing";
+        readonly required: false;
+        readonly default: false;
+    };
+}>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/images/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/images/delete.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;EAyCxB,CAAC"}

package/dist/commands/images/delete.js

@@ -0,0 +1,58 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost, validateConvexId } from "../../client.js";
+import { writeJson } from "../../output.js";
+import { registerSchema } from "../../schemas.js";
+registerSchema({
+    command: "images.delete",
+    description: "Delete an image by ID",
+    args: {
+        id: { type: "string", description: "Image ID", required: true },
+        "dry-run": {
+            type: "boolean",
+            description: "Preview the operation without executing",
+            required: false,
+            default: false,
+        },
+    },
+});
+export const deleteCommand = defineCommand({
+    meta: {
+        name: "delete",
+        description: "Delete an image by ID. Use --dry-run to preview. Example: baker images delete j571abc123 --dry-run",
+    },
+    args: {
+        id: { type: "positional", description: "Image ID", required: false },
+        "image-id": { type: "string", description: "Image ID (alternative to positional)", required: false },
+        "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false },
+    },
+    run: async ({ args }) => {
+        try {
+            const id = args.id || args["image-id"];
+            if (!id) {
+                writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Image ID is required" } });
+                process.exit(1);
+            }
+            validateConvexId(id);
+            if (args["dry-run"]) {
+                writeJson({
+                    ok: true,
+                    dryRun: true,
+                    operation: "images.delete",
+                    params: { id },
+                });
+                return;
+            }
+            const data = await apiPost("/api/images/delete", { id });
+            writeJson({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeJson({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=delete.js.map

package/dist/commands/images/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/images/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,cAAc,CAAC;IACb,OAAO,EAAE,eAAe;IACxB,WAAW,EAAE,uBAAuB;IACpC,IAAI,EAAE;QACJ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/D,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACf;KACF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oGAAoG;KAClH;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE;QACpE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE,QAAQ,EAAE,KAAK,EAAE;QACpG,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;KAC1G;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,GAAI,IAAI,CAAC,EAAyB,IAAK,IAAI,CAAC,UAAU,CAAwB,CAAC;YACvF,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;gBAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAErB,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpB,SAAS,CAAC;oBACR,EAAE,EAAE,IAAI;oBACR,MAAM,EAAE,IAAI;oBACZ,SAAS,EAAE,eAAe;oBAC1B,MAAM,EAAE,EAAE,EAAE,EAAE;iBACf,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAU,oBAAoB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAClE,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;gBAC5B,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/images/get.d.ts

@@ -0,0 +1,30 @@
+export declare const getCommand: import("citty").CommandDef<{
+    readonly id: {
+        readonly type: "positional";
+        readonly description: "Image ID";
+        readonly required: false;
+    };
+    readonly "image-id": {
+        readonly type: "string";
+        readonly description: "Image ID (alternative to positional)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format: json|files|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly fields: {
+        readonly type: "string";
+        readonly description: "Comma-separated field names to include";
+        readonly required: false;
+    };
+    readonly full: {
+        readonly type: "boolean";
+        readonly description: "Include full metadata";
+        readonly required: false;
+        readonly default: false;
+    };
+}>;
+//# sourceMappingURL=get.d.ts.map

package/dist/commands/images/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/images/get.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCrB,CAAC"}

package/dist/commands/images/get.js

@@ -0,0 +1,42 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet, validateConvexId } from "../../client.js";
+import { writeJson, writeOutput } from "../../output.js";
+import { registerSchema } from "../../schemas.js";
+registerSchema({
+    command: "images.get",
+    description: "Get a single image by ID",
+    args: {
+        id: { type: "string", description: "Image ID", required: true },
+    },
+});
+export const getCommand = defineCommand({
+    meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
+    args: {
+        id: { type: "positional", description: "Image ID", required: false },
+        "image-id": { type: "string", description: "Image ID (alternative to positional)", required: false },
+        output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+        fields: { type: "string", description: "Comma-separated field names to include", required: false },
+        full: { type: "boolean", description: "Include full metadata", required: false, default: false },
+    },
+    run: async ({ args }) => {
+        try {
+            const id = args.id || args["image-id"];
+            if (!id) {
+                writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Image ID is required" } });
+                process.exit(1);
+            }
+            validateConvexId(id);
+            const data = await apiGet("/api/images/get", { id });
+            writeOutput({ ok: true, data }, args.output || "json", args.fields ? args.fields.split(",") : undefined, args.full);
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeJson({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=get.js.map

package/dist/commands/images/get.js.map

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

package/dist/commands/images/index.d.ts

@@ -0,0 +1,2 @@
+export declare const imagesCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/images/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/images/index.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,qDAmBxB,CAAC"}

package/dist/commands/images/index.js

@@ -0,0 +1,27 @@
+import { defineCommand } from "citty";
+import { deleteCommand } from "./delete.js";
+import { getCommand } from "./get.js";
+import { listCommand } from "./list.js";
+import { searchCommand } from "./search.js";
+import { uploadCommand } from "./upload.js";
+export const imagesCommand = defineCommand({
+    meta: {
+        name: "images",
+        description: `Manage images in Baker. Subcommands: list, get, search, upload, delete.
+
+Examples:
+  baker images list --status ready
+  baker images search "hero banner" --limit 5
+  baker images get <image-id>
+  baker images upload ./logo.png --source uploaded
+  baker images delete <image-id> --dry-run`,
+    },
+    subCommands: {
+        list: listCommand,
+        get: getCommand,
+        search: searchCommand,
+        upload: uploadCommand,
+        delete: deleteCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/commands/images/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/images/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;;;2CAO0B;KACxC;IACD,WAAW,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;KACtB;CACF,CAAC,CAAC"}

package/dist/commands/images/list.d.ts

@@ -0,0 +1,45 @@
+export declare const listCommand: import("citty").CommandDef<{
+    readonly status: {
+        readonly type: "string";
+        readonly description: "Filter by status (ready|processing|uploading|error)";
+        readonly required: false;
+    };
+    readonly tags: {
+        readonly type: "string";
+        readonly description: "Comma-separated tag names";
+        readonly required: false;
+    };
+    readonly source: {
+        readonly type: "string";
+        readonly description: "Filter by source";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (default 50)";
+        readonly required: false;
+    };
+    readonly cursor: {
+        readonly type: "string";
+        readonly description: "Pagination cursor";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format: json|files|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly fields: {
+        readonly type: "string";
+        readonly description: "Comma-separated field names to include";
+        readonly required: false;
+    };
+    readonly full: {
+        readonly type: "boolean";
+        readonly description: "Include full metadata";
+        readonly required: false;
+        readonly default: false;
+    };
+}>;
+//# sourceMappingURL=list.d.ts.map