@clickraft/cli 0.2.0 → 0.4.0

package/dist/index.js

@@ -285,6 +285,55 @@ var EXIT_CODE_MAP = {
     retryable: false,
     hint: "No such profile. Use `clickraft auth profiles` to list available profiles."
   },
+  // --- 8 brand model resolution codes -----------------------------------------
+  BRAND_MODEL_NOT_FOUND: {
+    exitCode: 1,
+    category: "runtime",
+    retryable: false,
+    hint: "No brand model with that ID. Run `clickraft brand-model list`."
+  },
+  BRAND_MODEL_NOT_A_MODEL: {
+    exitCode: 1,
+    category: "runtime",
+    retryable: false,
+    hint: "The specified asset is not a brand model."
+  },
+  BRAND_MODEL_NOT_ACTIVE: {
+    exitCode: 1,
+    category: "runtime",
+    retryable: false,
+    hint: "Brand model is not active. Check its status in the dashboard."
+  },
+  BRAND_MODEL_NO_REFERENCES: {
+    exitCode: 1,
+    category: "runtime",
+    retryable: false,
+    hint: "Brand model has no reference images. Upload references first."
+  },
+  BRAND_MODEL_POSE_NOT_FOUND: {
+    exitCode: 1,
+    category: "runtime",
+    retryable: false,
+    hint: "Requested pose not found. Valid: front, 3/4-right, right, left, 3/4-left, back, approved."
+  },
+  BRAND_MODEL_DUPLICATE_ID: {
+    exitCode: 2,
+    category: "usage",
+    retryable: false,
+    hint: "Same brand model ID appears more than once."
+  },
+  MODEL_DOES_NOT_SUPPORT_REFERENCES: {
+    exitCode: 2,
+    category: "usage",
+    retryable: false,
+    hint: "This model does not support brand model references."
+  },
+  REFERENCE_LIMIT_EXCEEDED: {
+    exitCode: 2,
+    category: "usage",
+    retryable: false,
+    hint: "Too many reference images. Check model limits."
+  },
   // --- 4 CLI-synthetic codes --------------------------------------------------
   NETWORK_ERROR: {
     exitCode: 6,
@@ -697,7 +746,8 @@ function apiErrorFromServerBody(args) {
     requestId: error.correlationId ?? args.requestId,
     retryable,
     retryAfterMs,
-    redactedBody: args.redactedBody
+    redactedBody: args.redactedBody,
+    details: error.details
   });
 }
 function parseRetryAfterHeader(headerValue) {
@@ -721,6 +771,10 @@ function buildUrl(baseUrl, path, query) {
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       if (value === void 0) continue;
+      if (Array.isArray(value)) {
+        for (const item of value) url.searchParams.append(key, item);
+        continue;
+      }
       url.searchParams.append(key, String(value));
     }
   }
@@ -822,7 +876,8 @@ function errorToEnvelopePayload(err) {
       message: err.message,
       retryable: err.meta.retryable,
       retryAfterMs: err.meta.retryAfterMs,
-      requestId: err.meta.requestId
+      requestId: err.meta.requestId,
+      details: err.meta.details
     });
   }
   if (err instanceof AuthError || err instanceof CredentialsError) {
@@ -851,6 +906,7 @@ function buildPayload(args) {
   if (typeof args.retryAfterMs === "number") payload.retry_after_ms = args.retryAfterMs;
   if (args.requestId) payload.request_id = args.requestId;
   if (mapping?.hint) payload.hint = mapping.hint;
+  if (args.details != null) payload.details = args.details;
   return payload;
 }
 
@@ -1732,7 +1788,15 @@ function buildRequestBody(args) {
   if (args.aspectRatio !== void 0) input.aspectRatio = args.aspectRatio;
   if (args.resolution !== void 0) input.resolution = args.resolution;
   if (args.durationSeconds !== void 0) input.durationSeconds = args.durationSeconds;
-  if (args.brandModel !== void 0) input.providerParams = { brandModelId: args.brandModel };
+  if (args.brandModels !== void 0 && args.brandModels.length > 0) {
+    input.providerParams = {
+      brandModels: args.brandModels.map((spec) => {
+        const entry = { id: spec.id };
+        if (spec.imageType) entry.imageType = spec.imageType;
+        return entry;
+      })
+    };
+  }
   const body = {
     modelSlug: args.modelSlug,
     input
@@ -1769,6 +1833,152 @@ function projectCreateToResult(response, modelSlug) {
   };
 }
 
+// src/cli/args.ts
+var ArgError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ArgError";
+  }
+};
+function parseArgs(argv, spec) {
+  const result = {
+    positional: [],
+    string: {},
+    boolean: {},
+    array: {}
+  };
+  const stringFlags = new Set(spec.string ?? []);
+  const booleanFlags = new Set(spec.boolean ?? []);
+  const arrayFlags = new Set(spec.array ?? []);
+  const aliases = spec.aliases ?? {};
+  let i = 0;
+  let stopFlags = false;
+  while (i < argv.length) {
+    const raw = argv[i];
+    if (raw === void 0) {
+      i += 1;
+      continue;
+    }
+    if (stopFlags) {
+      result.positional.push(raw);
+      i += 1;
+      continue;
+    }
+    if (raw === "--") {
+      stopFlags = true;
+      i += 1;
+      continue;
+    }
+    if (!raw.startsWith("--")) {
+      result.positional.push(raw);
+      i += 1;
+      continue;
+    }
+    const eqIdx = raw.indexOf("=");
+    const flagToken = eqIdx >= 0 ? raw.slice(2, eqIdx) : raw.slice(2);
+    const inlineValue = eqIdx >= 0 ? raw.slice(eqIdx + 1) : void 0;
+    const canonical = resolveCanonical(flagToken, { booleanFlags, aliases });
+    if (booleanFlags.has(canonical)) {
+      if (inlineValue !== void 0) {
+        result.boolean[canonical] = parseBool(inlineValue);
+      } else if (flagToken.startsWith("no-") && booleanFlags.has(flagToken.slice(3))) {
+        result.boolean[flagToken.slice(3)] = false;
+      } else {
+        result.boolean[canonical] = true;
+      }
+      i += 1;
+      continue;
+    }
+    if (stringFlags.has(canonical) || arrayFlags.has(canonical)) {
+      let value;
+      if (inlineValue !== void 0) {
+        value = inlineValue;
+      } else {
+        const next = argv[i + 1];
+        if (next === void 0 || next.startsWith("--")) {
+          throw new ArgError(`Flag --${canonical} requires a value.`);
+        }
+        value = next;
+        i += 1;
+      }
+      if (arrayFlags.has(canonical)) {
+        const existing = result.array[canonical] ?? [];
+        existing.push(value);
+        result.array[canonical] = existing;
+      } else {
+        result.string[canonical] = value;
+      }
+      i += 1;
+      continue;
+    }
+    throw new ArgError(`Unknown flag --${flagToken}`);
+  }
+  return result;
+}
+function resolveCanonical(flagToken, ctx) {
+  if (ctx.aliases[flagToken]) return ctx.aliases[flagToken];
+  if (flagToken.startsWith("no-") && ctx.booleanFlags.has(flagToken.slice(3))) {
+    return flagToken.slice(3);
+  }
+  return flagToken;
+}
+function parseBool(value) {
+  if (value === "true" || value === "1") return true;
+  if (value === "false" || value === "0") return false;
+  throw new ArgError(`Expected boolean value (true/false), got "${value}".`);
+}
+
+// src/commands/generate/parse-brand-model-spec.ts
+var VALID_POSES = [
+  "front",
+  "3/4-right",
+  "right",
+  "left",
+  "3/4-left",
+  "back",
+  "approved"
+];
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function parseBrandModelSpec(raw) {
+  if (!raw) throw new ArgError("--brand-model value cannot be empty.");
+  const colonIdx = raw.indexOf(":");
+  const uuid = colonIdx >= 0 ? raw.slice(0, colonIdx) : raw;
+  const poseRaw = colonIdx >= 0 ? raw.slice(colonIdx + 1) : void 0;
+  if (!UUID_RE.test(uuid)) {
+    throw new ArgError(
+      `Invalid brand model ID: '${uuid}'. Expected a UUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).`
+    );
+  }
+  if (poseRaw !== void 0) {
+    if (!poseRaw) {
+      throw new ArgError(
+        `Empty pose for brand model ${uuid}. Valid poses: ${VALID_POSES.join(", ")}.`
+      );
+    }
+    if (!VALID_POSES.includes(poseRaw)) {
+      throw new ArgError(
+        `Unknown pose '${poseRaw}' for brand model ${uuid}. Valid poses: ${VALID_POSES.join(", ")}.`
+      );
+    }
+    return { id: uuid.toLowerCase(), imageType: poseRaw };
+  }
+  return { id: uuid.toLowerCase() };
+}
+function validateBrandModelSpecs(specs) {
+  if (specs.length > 3) {
+    throw new ArgError(`Too many --brand-model flags (${specs.length}). Maximum is 3.`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const spec of specs) {
+    if (seen.has(spec.id)) {
+      throw new ArgError(
+        `Duplicate brand model ID: ${spec.id}. Each --brand-model must reference a different model.`
+      );
+    }
+    seen.add(spec.id);
+  }
+}
+
 // src/auth/device-flow.ts
 import { setTimeout as delay } from "timers/promises";
 import { request } from "undici";
@@ -2305,21 +2515,112 @@ function inspectTelemetry(options = {}) {
   };
 }
 
-// src/commands/tokens/list.ts
+// src/commands/template/internal.ts
+async function buildTemplateClient(opts) {
+  const cfg = await loadConfig({
+    flagProfile: opts.profile,
+    flagApiBaseUrl: opts.apiBaseUrl,
+    flagToken: opts.token
+  });
+  return new ApiClient({
+    apiBaseUrl: cfg.apiBaseUrl,
+    accessToken: cfg.accessToken,
+    signal: opts.signal,
+    cloudflareAccess: cfg.cloudflareAccess
+  });
+}
+
+// src/schemas/templates.ts
 import { z as z8 } from "zod";
-var TokenRowSchema = z8.object({
+var DeclaredParamSchema = z8.object({
+  name: z8.string(),
+  type: z8.string(),
+  required: z8.boolean(),
+  defaultValue: z8.string().nullable().optional(),
+  enumValues: z8.array(z8.string()).nullable().optional(),
+  description: z8.string().nullable().optional()
+}).strict();
+var TemplateSummarySchema = z8.object({
   id: z8.string().uuid(),
-  organizationId: z8.string().uuid(),
-  userId: z8.string().uuid(),
-  clientId: z8.string().nullable(),
-  tokenPrefix: z8.string(),
-  name: z8.string().nullable(),
-  scopes: z8.array(z8.string()),
-  lastUsedAt: z8.string().nullable(),
-  expiresAt: z8.string(),
+  source: z8.enum(["own", "system"]),
+  name: z8.string(),
+  description: z8.string().nullable(),
+  category: z8.string().nullable(),
+  thumbnailUrl: z8.string().nullable(),
+  tags: z8.array(z8.string()),
   createdAt: z8.string()
 }).strict();
-var TokensListResponseSchema = z8.array(TokenRowSchema);
+var TemplateDetailSchema = TemplateSummarySchema.extend({
+  declaredParams: z8.array(DeclaredParamSchema),
+  timesUsed: z8.number()
+}).strict();
+var TemplatesListResponseSchema = z8.object({
+  templates: z8.array(TemplateSummarySchema),
+  cursor: z8.string().nullable(),
+  hasMore: z8.boolean()
+}).strict();
+
+// src/commands/template/list.ts
+async function listTemplates(opts) {
+  const client = opts.client ?? await buildTemplateClient(opts);
+  const data = await client.request({
+    method: "GET",
+    path: "/templates",
+    query: {
+      q: opts.q,
+      tags: opts.tags,
+      scope: opts.scope,
+      cursor: opts.cursor,
+      limit: opts.limit
+    },
+    responseSchema: TemplatesListResponseSchema,
+    signal: opts.signal
+  });
+  return data;
+}
+
+// src/commands/template/find.ts
+async function findTemplates(opts) {
+  return listTemplates({
+    q: opts.query,
+    tags: opts.tags,
+    scope: opts.scope,
+    limit: opts.limit,
+    cursor: opts.cursor,
+    profile: opts.profile,
+    apiBaseUrl: opts.apiBaseUrl,
+    token: opts.token,
+    signal: opts.signal,
+    client: opts.client
+  });
+}
+
+// src/commands/template/get.ts
+async function getTemplate(opts) {
+  const client = opts.client ?? await buildTemplateClient(opts);
+  return client.request({
+    method: "GET",
+    path: `/templates/${encodeURIComponent(opts.id)}`,
+    responseSchema: TemplateDetailSchema,
+    signal: opts.signal
+  });
+}
+
+// src/commands/tokens/list.ts
+import { z as z9 } from "zod";
+var TokenRowSchema = z9.object({
+  id: z9.string().uuid(),
+  organizationId: z9.string().uuid(),
+  userId: z9.string().uuid(),
+  clientId: z9.string().nullable(),
+  tokenPrefix: z9.string(),
+  name: z9.string().nullable(),
+  scopes: z9.array(z9.string()),
+  lastUsedAt: z9.string().nullable(),
+  expiresAt: z9.string(),
+  createdAt: z9.string()
+}).strict();
+var TokensListResponseSchema = z9.array(TokenRowSchema);
 async function listTokens(options) {
   const config = await loadConfig({
     flagProfile: options.profile,
@@ -2348,23 +2649,33 @@ async function listTokens(options) {
 var FALLBACK_HINT = "See `clickraft --help` or contact support.";
 function formatHumanError(err) {
   const view = errorToView(err);
-  return [
+  const lines = [
     `Error: ${view.message}`,
     `Code: ${view.code}`,
     `Try: ${view.hint}`,
     `Request ID: ${view.requestId ?? "n/a"}`
-  ].join("\n");
+  ];
+  if (view.details) lines.push(`Details: ${view.details}`);
+  return lines.join("\n");
 }
 function formatJsonError(err, ctx) {
   return JSON.stringify(wrapError(err, ctx));
 }
+function formatDetails(details) {
+  if (details == null) return void 0;
+  if (typeof details !== "object") return String(details);
+  const entries = Object.entries(details);
+  if (entries.length === 0) return void 0;
+  return entries.map(([k, v]) => `${k}=${v}`).join(", ");
+}
 function errorToView(err) {
   if (err instanceof ApiError) {
     return {
       code: toEnvelopeCode(err.code),
       message: err.message,
       hint: EXIT_CODE_MAP[err.code]?.hint ?? FALLBACK_HINT,
-      requestId: err.meta.requestId
+      requestId: err.meta.requestId,
+      details: formatDetails(err.meta.details)
     };
   }
   if (err instanceof AuthError || err instanceof CredentialsError) {
@@ -2382,101 +2693,6 @@ function errorToView(err) {
   };
 }
 
-// src/cli/args.ts
-var ArgError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ArgError";
-  }
-};
-function parseArgs(argv, spec) {
-  const result = {
-    positional: [],
-    string: {},
-    boolean: {},
-    array: {}
-  };
-  const stringFlags = new Set(spec.string ?? []);
-  const booleanFlags = new Set(spec.boolean ?? []);
-  const arrayFlags = new Set(spec.array ?? []);
-  const aliases = spec.aliases ?? {};
-  let i = 0;
-  let stopFlags = false;
-  while (i < argv.length) {
-    const raw = argv[i];
-    if (raw === void 0) {
-      i += 1;
-      continue;
-    }
-    if (stopFlags) {
-      result.positional.push(raw);
-      i += 1;
-      continue;
-    }
-    if (raw === "--") {
-      stopFlags = true;
-      i += 1;
-      continue;
-    }
-    if (!raw.startsWith("--")) {
-      result.positional.push(raw);
-      i += 1;
-      continue;
-    }
-    const eqIdx = raw.indexOf("=");
-    const flagToken = eqIdx >= 0 ? raw.slice(2, eqIdx) : raw.slice(2);
-    const inlineValue = eqIdx >= 0 ? raw.slice(eqIdx + 1) : void 0;
-    const canonical = resolveCanonical(flagToken, { booleanFlags, aliases });
-    if (booleanFlags.has(canonical)) {
-      if (inlineValue !== void 0) {
-        result.boolean[canonical] = parseBool(inlineValue);
-      } else if (flagToken.startsWith("no-") && booleanFlags.has(flagToken.slice(3))) {
-        result.boolean[flagToken.slice(3)] = false;
-      } else {
-        result.boolean[canonical] = true;
-      }
-      i += 1;
-      continue;
-    }
-    if (stringFlags.has(canonical) || arrayFlags.has(canonical)) {
-      let value;
-      if (inlineValue !== void 0) {
-        value = inlineValue;
-      } else {
-        const next = argv[i + 1];
-        if (next === void 0 || next.startsWith("--")) {
-          throw new ArgError(`Flag --${canonical} requires a value.`);
-        }
-        value = next;
-        i += 1;
-      }
-      if (arrayFlags.has(canonical)) {
-        const existing = result.array[canonical] ?? [];
-        existing.push(value);
-        result.array[canonical] = existing;
-      } else {
-        result.string[canonical] = value;
-      }
-      i += 1;
-      continue;
-    }
-    throw new ArgError(`Unknown flag --${flagToken}`);
-  }
-  return result;
-}
-function resolveCanonical(flagToken, ctx) {
-  if (ctx.aliases[flagToken]) return ctx.aliases[flagToken];
-  if (flagToken.startsWith("no-") && ctx.booleanFlags.has(flagToken.slice(3))) {
-    return flagToken.slice(3);
-  }
-  return flagToken;
-}
-function parseBool(value) {
-  if (value === "true" || value === "1") return true;
-  if (value === "false" || value === "0") return false;
-  throw new ArgError(`Expected boolean value (true/false), got "${value}".`);
-}
-
 // src/cli/parse-args.ts
 var SHORT_ALIASES = {
   h: "help",
@@ -2717,6 +2933,61 @@ function renderBrandModelsList(models, out) {
   out.write(padRow(headers) + "\n");
   for (const cells of data) out.write(padRow(cells) + "\n");
 }
+function renderTemplatesList(result, out) {
+  const { templates } = result;
+  if (templates.length === 0) {
+    out.write("No templates.\n");
+    return;
+  }
+  const MAX_TAGS = 3;
+  const headers = ["SOURCE", "NAME", "CATEGORY", "TAGS", "CREATED"];
+  const data = templates.map((t) => {
+    const shown = t.tags.slice(0, MAX_TAGS).join(", ");
+    const extra = t.tags.length > MAX_TAGS ? ` +${t.tags.length - MAX_TAGS} more` : "";
+    return [
+      t.source,
+      t.name,
+      t.category ?? "\u2014",
+      t.tags.length > 0 ? shown + extra : "\u2014",
+      t.createdAt.slice(0, 10)
+    ];
+  });
+  const widths = headers.map(
+    (header, i) => Math.max(header.length, ...data.map((cells) => cells[i].length))
+  );
+  const padRow = (cells) => cells.map((cell, i) => cell.padEnd(widths[i])).join("  ").trimEnd();
+  out.write(padRow(headers) + "\n");
+  for (const cells of data) out.write(padRow(cells) + "\n");
+  if (result.hasMore) {
+    out.write("\nMore results available. Use --cursor to fetch the next page.\n");
+  }
+}
+function renderTemplateDetail(detail, out) {
+  const pad = 17;
+  const lines = [
+    detail.name,
+    `${"ID:".padEnd(pad)}${detail.id}`,
+    `${"Source:".padEnd(pad)}${detail.source}`,
+    `${"Category:".padEnd(pad)}${detail.category ?? "\u2014"}`,
+    `${"Tags:".padEnd(pad)}${detail.tags.length > 0 ? detail.tags.join(", ") : "\u2014"}`,
+    `${"Created:".padEnd(pad)}${detail.createdAt.slice(0, 10)}`,
+    `${"Times used:".padEnd(pad)}${detail.timesUsed}`
+  ];
+  if (detail.description) {
+    lines.push("", detail.description);
+  }
+  lines.push("", "Declared parameters:");
+  if (detail.declaredParams.length === 0) {
+    lines.push("  (none)");
+  } else {
+    for (const p of detail.declaredParams) {
+      const req = p.required ? "required" : "optional";
+      const desc = p.description ? `: ${p.description}` : "";
+      lines.push(`  - ${p.name} (${p.type}, ${req})${desc}`);
+    }
+  }
+  out.write(lines.join("\n") + "\n");
+}
 function formatExpiresAt(iso) {
   const ms = Date.parse(iso);
   if (Number.isNaN(ms)) return iso;
@@ -2944,6 +3215,9 @@ function renderRootHelp(version) {
     "  balance                 Show credit balance and rate limits",
     "  brand-model list        List available brand models",
     "  telemetry inspect       Show current telemetry state and payload shape",
+    "  template list            List available templates",
+    "  template get             Fetch a template by ID",
+    "  template find            Search templates by keyword",
     "  generate create         Submit a generation job and wait for completion",
     "  generate wait           Wait for an existing job to reach a terminal state",
     "  generate get            Fetch the current state of a job",
@@ -3027,6 +3301,62 @@ function renderCommandHelp(command) {
         "  --json             Emit JSON envelope instead of human output",
         ""
       ].join("\n");
+    case "template":
+      return [
+        "Usage: clickraft template <subcommand> [options]",
+        "",
+        "Subcommands:",
+        "  list   List available templates",
+        "  get    Fetch a template by ID",
+        "  find   Search templates by keyword",
+        ""
+      ].join("\n");
+    case "template list":
+      return [
+        "Usage: clickraft template list [options]",
+        "",
+        "Options:",
+        "  --scope <scope>       Filter by scope: own, system, or all (default: all)",
+        "  --q <query>           Free-text search query",
+        "  --tags <tag>          Filter by tag (repeatable)",
+        "  --cursor <token>      Pagination cursor from a previous response",
+        "  --limit <n>           Max results per page (1-50, default: 20)",
+        "  --profile <name>",
+        "  --api-base-url <url>",
+        "  --token <token>",
+        "  --json",
+        ""
+      ].join("\n");
+    case "template get":
+      return [
+        "Usage: clickraft template get <id> [options]",
+        "",
+        "Fetches a single template by its ID, including declared parameters.",
+        "",
+        "Options:",
+        "  --profile <name>",
+        "  --api-base-url <url>",
+        "  --token <token>",
+        "  --json",
+        ""
+      ].join("\n");
+    case "template find":
+      return [
+        "Usage: clickraft template find <query> [options]",
+        "",
+        "Searches templates by keyword. Shorthand for `template list --q <query>`.",
+        "",
+        "Options:",
+        "  --tags <tag>          Filter by tag (repeatable)",
+        "  --scope <scope>       Filter by scope: own, system, or all (default: all)",
+        "  --limit <n>           Max results per page (1-50, default: 20)",
+        "  --cursor <token>      Pagination cursor from a previous response",
+        "  --profile <name>",
+        "  --api-base-url <url>",
+        "  --token <token>",
+        "  --json",
+        ""
+      ].join("\n");
     case "generate":
       return [
         "Usage: clickraft generate <subcommand> [options]",
@@ -3047,7 +3377,9 @@ function renderCommandHelp(command) {
         "Options:",
         "  --prompt <text>           Text prompt (or pass as the positional argument)",
         "  --model-slug <slug>       Required model identifier",
-        "  --brand-model <id>        Optional Brand Model reference",
+        "  --brand-model <spec>      Brand Model reference (repeatable, max 3)",
+        "                             Format: <uuid> or <uuid>:<pose>",
+        "                             Poses: front, 3/4-right, right, left, 3/4-left, back, approved",
         "  --reference-image <v>     URL or local path (repeatable, max 8)",
         "  --aspect-ratio <a:b>      e.g. 16:9",
         "  --resolution <WxH>        e.g. 1024x768",
@@ -3148,6 +3480,14 @@ function matchNewCommand(argv) {
     if (sub === void 0 || sub.startsWith("-")) return { kind: "sub-help", verb: "jobs" };
     return { kind: "unknown-sub", verb: "jobs", sub };
   }
+  if (verb === "template") {
+    const sub = argv[1];
+    if (sub === "list") return { kind: "cmd", path: "template.list", verbTokenCount: 2 };
+    if (sub === "get") return { kind: "cmd", path: "template.get", verbTokenCount: 2 };
+    if (sub === "find") return { kind: "cmd", path: "template.find", verbTokenCount: 2 };
+    if (sub === void 0 || sub.startsWith("-")) return { kind: "sub-help", verb: "template" };
+    return { kind: "unknown-sub", verb: "template", sub };
+  }
   return null;
 }
 async function runNewCommand(newCmd, options, stdout, stderr) {
@@ -3198,6 +3538,12 @@ async function runNewCommand(newCmd, options, stdout, stderr) {
         return await runJobsWait(argvAfterVerb, ctx, rc);
       case "upload":
         return await runUploadCmd(argvAfterVerb, ctx, rc);
+      case "template.list":
+        return await runTemplateList(argvAfterVerb, ctx, rc);
+      case "template.get":
+        return await runTemplateGet(argvAfterVerb, ctx, rc);
+      case "template.find":
+        return await runTemplateFind(argvAfterVerb, ctx, rc);
     }
   } catch (err) {
     if (isAbortedError(err, options.signal)) {
@@ -3228,7 +3574,6 @@ async function runGenerateCreate(argv, ctx, rc) {
       ...COMMON_RICH_STRING_FLAGS,
       "prompt",
       "model-slug",
-      "brand-model",
       "aspect-ratio",
       "resolution",
       "duration-seconds",
@@ -3237,10 +3582,13 @@ async function runGenerateCreate(argv, ctx, rc) {
       "timeout"
     ],
     boolean: [...COMMON_RICH_BOOL_FLAGS, "wait", "async"],
-    array: ["reference-image"]
+    array: ["reference-image", "brand-model"]
   });
   const modelSlug = parsed.string["model-slug"];
   if (!modelSlug) throw new ArgError("--model-slug is required.");
+  const rawBrandModels = parsed.array["brand-model"] ?? [];
+  const brandModels = rawBrandModels.length > 0 ? rawBrandModels.map(parseBrandModelSpec) : void 0;
+  if (brandModels) validateBrandModelSpecs(brandModels);
   const result = await generateCreate({
     prompt: parsed.string.prompt ?? parsed.positional[0],
     modelSlug,
@@ -3248,7 +3596,7 @@ async function runGenerateCreate(argv, ctx, rc) {
     aspectRatio: parsed.string["aspect-ratio"],
     resolution: parsed.string.resolution,
     durationSeconds: optionalInt(parsed.string["duration-seconds"], "duration-seconds"),
-    brandModel: parsed.string["brand-model"],
+    brandModels,
     workflowId: parsed.string["workflow-id"],
     nodeId: parsed.string["node-id"],
     wait: computeWaitFlag(parsed),
@@ -3392,6 +3740,87 @@ function exitCodeForResult(result) {
   }
   return 0;
 }
+async function runTemplateList(argv, ctx, rc) {
+  const parsed = parseArgs(argv, {
+    string: [...COMMON_RICH_STRING_FLAGS, "scope", "q", "cursor", "limit"],
+    boolean: [...COMMON_RICH_BOOL_FLAGS],
+    array: ["tags"]
+  });
+  const result = await listTemplates({
+    q: parsed.string.q,
+    tags: parsed.array.tags,
+    scope: parsed.string.scope,
+    cursor: parsed.string.cursor,
+    limit: optionalInt(parsed.string.limit, "limit"),
+    profile: parsed.string.profile,
+    apiBaseUrl: parsed.string["api-base-url"],
+    token: parsed.string.token,
+    signal: rc.signal
+  });
+  ctx.nextCursor = result.cursor ?? void 0;
+  emitTemplateList(result, ctx, rc);
+  return 0;
+}
+async function runTemplateGet(argv, ctx, rc) {
+  const parsed = parseArgs(argv, {
+    string: [...COMMON_RICH_STRING_FLAGS],
+    boolean: [...COMMON_RICH_BOOL_FLAGS]
+  });
+  const id = parsed.positional[0];
+  if (!id) throw new ArgError("Missing required <id> argument.");
+  const detail = await getTemplate({
+    id,
+    profile: parsed.string.profile,
+    apiBaseUrl: parsed.string["api-base-url"],
+    token: parsed.string.token,
+    signal: rc.signal
+  });
+  emitTemplateDetail(detail, ctx, rc);
+  return 0;
+}
+async function runTemplateFind(argv, ctx, rc) {
+  const parsed = parseArgs(argv, {
+    string: [...COMMON_RICH_STRING_FLAGS, "scope", "cursor", "limit"],
+    boolean: [...COMMON_RICH_BOOL_FLAGS],
+    array: ["tags"]
+  });
+  const query = parsed.positional[0];
+  if (!query) throw new ArgError("Missing required <query> argument.");
+  const result = await findTemplates({
+    query,
+    tags: parsed.array.tags,
+    scope: parsed.string.scope,
+    cursor: parsed.string.cursor,
+    limit: optionalInt(parsed.string.limit, "limit"),
+    profile: parsed.string.profile,
+    apiBaseUrl: parsed.string["api-base-url"],
+    token: parsed.string.token,
+    signal: rc.signal
+  });
+  ctx.nextCursor = result.cursor ?? void 0;
+  emitTemplateList(result, ctx, rc);
+  return 0;
+}
+function emitTemplateList(result, ctx, rc) {
+  if (rc.signal?.aborted) {
+    throw new AuthError("AUTH_FLOW_CANCELLED", "Cancelled.");
+  }
+  if (rc.jsonMode) {
+    rc.stdout.write(JSON.stringify(wrapSuccess(result, ctx)) + "\n");
+    return;
+  }
+  renderTemplatesList(result, rc.stdout);
+}
+function emitTemplateDetail(detail, ctx, rc) {
+  if (rc.signal?.aborted) {
+    throw new AuthError("AUTH_FLOW_CANCELLED", "Cancelled.");
+  }
+  if (rc.jsonMode) {
+    rc.stdout.write(JSON.stringify(wrapSuccess(detail, ctx)) + "\n");
+    return;
+  }
+  renderTemplateDetail(detail, rc.stdout);
+}
 
 // src/index.ts
 var __filename2 = fileURLToPath(import.meta.url);