ima2-gen 1.1.21 → 1.1.23

package/bin/commands/cancel.ts

@@ -1,48 +0,0 @@
-import { parseArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, dieWithError, color, json } from "../lib/output.js";
-
-import { errInfo } from "../../lib/errInfo.js";
-const SPEC = {
-  flags: {
-    json: { type: "boolean" },
-    server: { type: "string" },
-    help: { short: "h", type: "boolean" },
-  },
-};
-
-const HELP = `
-  ima2 cancel <requestId> [--json]
-
-  Mark an in-flight job as canceled in the local ima2 server registry.
-`;
-
-export default async function cancelCmd(argv: string[]) {
-  const args = parseArgs(argv, SPEC);
-  if (args.help) { out(HELP); return; }
-
-  const requestId = args.positional[0];
-  if (!requestId) die(2, "requestId required");
-
-  let server;
-  try { server = await resolveServer({ serverFlag: args.server }); }
-  catch (e) {
-    const err = errInfo(e);
-    if (args.json) json({ ok: false, requestId, error: err.message, code: err.code, status: err.status });
-    dieWithError(e);
-  }
-
-  try {
-    await request(server.base, `/api/inflight/${encodeURIComponent(requestId)}`, {
-      method: "DELETE",
-      timeoutMs: 30_000,
-    });
-  } catch (e) {
-    const err = errInfo(e);
-    if (args.json) json({ ok: false, requestId, error: err.message, code: err.code, status: err.status });
-    dieWithError(e);
-  }
-
-  if (args.json) json({ ok: true, requestId });
-  else out(color.green("✓ ") + `canceled ${requestId}`);
-}

package/bin/commands/canvas-versions.ts

@@ -1,80 +0,0 @@
-import { readFile } from "fs/promises";
-import { parseArgs, type ParsedArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, color, json, exitCodeForError } from "../lib/output.js";
-
-const HELP = `
-  ima2 canvas-versions <subcommand> [options]
-
-  Subcommands:
-    save <imagefile> [--source <filename>] [--prompt <text>]
-    update <filename> <imagefile> [--source <filename>] [--prompt <text>]
-
-  Notes: server only exposes POST /api/canvas-versions (collection) and
-  PUT /api/canvas-versions/:filename. No GET, no DELETE.
-`;
-
-const FLAGS = {
-  json: { type: "boolean" },
-  server: { type: "string" },
-  source: { type: "string" },
-  prompt: { type: "string" },
-  help: { short: "h", type: "boolean" },
-};
-
-async function getServer(args: ParsedArgs) {
-  try { return await resolveServer({ serverFlag: args.server }); }
-  catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
-}
-
-function buildHeaders(args: ParsedArgs) {
-  const h: Record<string, string> = { "Content-Type": "image/png" };
-  if (args.source) h["X-Ima2-Canvas-Source-Filename"] = String(args.source);
-  if (args.prompt) h["X-Ima2-Canvas-Prompt"] = String(args.prompt);
-  return h;
-}
-
-async function saveSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const file = args.positional[0];
-  if (!file) die(2, "image file required");
-  const buf = await readFile(file);
-  const server = await getServer(args);
-  const resp = await request(server.base, "/api/canvas-versions", {
-    method: "POST",
-    body: buf,
-    raw: true,
-    headers: buildHeaders(args),
-  }).catch((e: unknown) => { const err = e as { message?: string; code?: string }; die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`); });
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ saved canvas version"));
-}
-
-async function updateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const [filename, file] = args.positional;
-  if (!filename || !file) die(2, "usage: canvas-versions update <filename> <imagefile>");
-  const buf = await readFile(file);
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/canvas-versions/${encodeURIComponent(filename)}`, {
-    method: "PUT",
-    body: buf,
-    raw: true,
-    headers: buildHeaders(args),
-  }).catch((e: unknown) => { const err = e as { message?: string; code?: string }; die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`); });
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ updated"));
-}
-
-const SUB: Record<string, (argv: any[]) => Promise<void>> = {
-  save: saveSub,
-  update: updateSub,
-};
-
-export default async function canvasVersionsCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-  const handler = SUB[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}

package/bin/commands/capabilities.ts

@@ -1,110 +0,0 @@
-import { readFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { config } from "../../config.js";
-import { buildIma2Capabilities } from "../../lib/capabilities.js";
-import { parseArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { color, dieWithError, json, out } from "../lib/output.js";
-
-const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
-const PACKAGE_PATH = join(ROOT, "package.json");
-
-const HELP = `
-  ima2 capabilities [--json] [--server <url>] [--require-server]
-
-  Print agent-friendly capability metadata.
-
-  Options:
-    --json             Print JSON
-    --server <url>     Query a specific running server
-    --require-server   Fail instead of falling back to local package metadata
-`;
-
-const FLAGS = {
-  json: { type: "boolean" },
-  server: { type: "string" },
-  "require-server": { type: "boolean" },
-  help: { short: "h", type: "boolean" },
-};
-
-function packageVersion(): string {
-  try {
-    const pkg = JSON.parse(readFileSync(PACKAGE_PATH, "utf-8")) as { version?: string };
-    return pkg.version || "?";
-  } catch {
-    return "?";
-  }
-}
-
-function localCapabilities() {
-  return buildIma2Capabilities({
-    appConfig: config,
-    packageVersion: packageVersion(),
-    source: "local",
-    server: null,
-  });
-}
-
-async function readCapabilities(args: ReturnType<typeof parseArgs>) {
-  try {
-    const server = await resolveServer({ serverFlag: args.server });
-    return await request(server.base, "/api/capabilities", { timeoutMs: 5000 });
-  } catch (error) {
-    if (args.server || args["require-server"]) throw error;
-    return localCapabilities();
-  }
-}
-
-function printText(capabilities: any): void {
-  out(`ima2 capabilities (${capabilities.source})`);
-  out(`version: ${capabilities.version}`);
-  out(`server: ${capabilities.server || "none"}`);
-  out("");
-  out("defaults:");
-  out(`  gpt-oauth model: ${capabilities.defaults?.oauth?.model}`);
-  out(`  gpt-oauth reasoning: ${capabilities.defaults?.oauth?.reasoningEffort}`);
-  out(`  api model: ${capabilities.defaults?.api?.model}`);
-  out(`  api reasoning: ${capabilities.defaults?.api?.reasoningEffort}`);
-  out(`  grok model: ${capabilities.defaults?.grok?.model}`);
-  out(`  grok planner: ${capabilities.defaults?.grok?.plannerModel}`);
-  out("");
-  out("valid:");
-  out(`  models: ${capabilities.valid?.imageModels?.supported?.join(", ")}`);
-  if (capabilities.valid?.imageModels?.grokSupported?.length) {
-    out(`  grok models: ${capabilities.valid.imageModels.grokSupported.join(", ")}`);
-  }
-  if (capabilities.valid?.videoModels?.supported?.length) {
-    out(`  video models: ${capabilities.valid.videoModels.supported.join(", ")}`);
-    out(`  video resolutions: ${capabilities.valid.videoModels.resolutions?.join(", ")}`);
-    out(`  video aspect ratios: ${capabilities.valid.videoModels.aspectRatios?.join(", ")}`);
-    out(`  video duration: ${capabilities.valid.videoModels.durationRange?.[0]}-${capabilities.valid.videoModels.durationRange?.[1]}s`);
-  }
-  out(`  reasoning: ${capabilities.valid?.reasoningEfforts?.join(", ")}`);
-  out(`  quality: ${capabilities.valid?.quality?.join(", ")}`);
-  out(`  modes: ${capabilities.valid?.modes?.join(", ")}`);
-  out(`  moderation: ${capabilities.valid?.moderation?.join(", ")}`);
-  out(`  providers: ${capabilities.valid?.providers?.join(", ")}`);
-  out("");
-  out(`config keys: ${capabilities.configKeys?.writable?.length ?? 0} writable`);
-  out(color.dim("run: ima2 config keys --json"));
-  out("");
-  out(`limits: refs=${capabilities.limits?.maxRefCount}, images=${capabilities.limits?.maxGeneratedImages}`);
-  out(color.dim(`maxParallel: ${capabilities.limits?.maxParallel?.value} (${capabilities.limits?.maxParallel?.note})`));
-}
-
-export default async function capabilitiesCmd(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  if (args.help) {
-    out(HELP);
-    return;
-  }
-
-  try {
-    const capabilities = await readCapabilities(args);
-    if (args.json) json(capabilities);
-    else printText(capabilities);
-  } catch (error) {
-    dieWithError(error);
-  }
-}

package/bin/commands/cardnews.ts

@@ -1,249 +0,0 @@
-import { parseArgs, type ParsedArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, color, json, exitCodeForError } from "../lib/output.js";
-import { config as runtimeConfig } from "../../config.js";
-
-const HELP = `
-  ima2 cardnews <subcommand> [options]
-
-  Subcommands:
-    templates                              List image-templates + role-templates
-    template preview <templateId>          Preview an image template
-    sets                                   List card news sets
-    set show <setId>                       Show a set
-    set manifest <setId>                   Show a set manifest
-    draft [--data <json>]                  Create a draft
-    generate [--data <json>]               Run generation
-    job create [--data <json>]             Create and start a job
-    job show <jobId>                       Show a job
-    job retry <jobId> [--cards <id,...>]   Retry a job (optionally specific cards)
-    card regenerate <cardId> [--data <json>]  Regenerate a single card
-    export [--data <json>]                 Export a bundle
-
-  Note: Card News must be enabled (IMA2_CARD_NEWS=1 or features.cardNews: true in config.json).
-
-  Options:
-    --data <json>   JSON body to send (for draft/generate/job create/card regenerate/export)
-    --cards <ids>   Comma-separated card IDs for job retry
-    --json          Output raw JSON
-    --server <url>  Override server URL
-`;
-
-const FLAGS = {
-  json:   { type: "boolean" },
-  server: { type: "string" },
-  data:   { type: "string" },
-  cards:  { type: "string" },
-  help:   { short: "h", type: "boolean" },
-};
-
-function ensureCardNewsEnabled() {
-  if (!runtimeConfig.features?.cardNews) {
-    die(2, "Card News feature is disabled. Set IMA2_CARD_NEWS=1 (or features.cardNews: true in config.json) and restart the server.");
-  }
-}
-
-async function getServer(args: ParsedArgs) {
-  try { return await resolveServer({ serverFlag: args.server }); }
-  catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
-}
-
-function parseData(raw: unknown): any {
-  if (!raw) return {};
-  if (typeof raw !== "string") return {};
-  try { return JSON.parse(raw); }
-  catch { die(2, `--data must be valid JSON`); }
-}
-
-async function templatesSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  if (args.help) { out(HELP); return; }
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const [imgTemplates, roleTemplates] = await Promise.all([
-    request(server.base, "/api/cardnews/image-templates")
-      .catch((e) => die(exitCodeForError(e), e.message)),
-    request(server.base, "/api/cardnews/role-templates")
-      .catch((e) => die(exitCodeForError(e), e.message)),
-  ]);
-  if (args.json) { json({ imageTemplates: imgTemplates, roleTemplates }); return; }
-  out(color.bold("Image templates:"));
-  out(JSON.stringify(imgTemplates, null, 2));
-  out(color.bold("Role templates:"));
-  out(JSON.stringify(roleTemplates, null, 2));
-}
-
-async function templatePreviewSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const templateId = args.positional[0];
-  if (!templateId) die(2, "templateId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/image-templates/${encodeURIComponent(templateId)}/preview`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function setsSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, "/api/cardnews/sets")
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function setShowSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const setId = args.positional[0];
-  if (!setId) die(2, "setId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/sets/${encodeURIComponent(setId)}`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function setManifestSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const setId = args.positional[0];
-  if (!setId) die(2, "setId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/sets/${encodeURIComponent(setId)}/manifest`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function draftSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/draft", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function generateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/generate", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function jobCreateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/jobs", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function jobShowSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const jobId = args.positional[0];
-  if (!jobId) die(2, "jobId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/cardnews/jobs/${encodeURIComponent(jobId)}`)
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(JSON.stringify(resp, null, 2));
-}
-
-async function jobRetrySub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const jobId = args.positional[0];
-  if (!jobId) die(2, "jobId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body: any = {};
-  if (args.cards) body.cardIds = String(args.cards).split(",").map((s: string) => s.trim()).filter(Boolean);
-  const resp = await request(server.base, `/api/cardnews/jobs/${encodeURIComponent(jobId)}/retry`, { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ ") + "retry requested");
-  if (resp && typeof resp === "object" && Object.keys(resp).length > 0) out(JSON.stringify(resp, null, 2));
-}
-
-async function cardRegenerateSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const cardId = args.positional[0];
-  if (!cardId) die(2, "cardId required");
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, `/api/cardnews/cards/${encodeURIComponent(cardId)}/regenerate`, { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ ") + "regeneration started");
-  if (resp && typeof resp === "object" && Object.keys(resp).length > 0) out(JSON.stringify(resp, null, 2));
-}
-
-async function exportSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  ensureCardNewsEnabled();
-  const server = await getServer(args);
-  const body = parseData(args.data);
-  const resp = await request(server.base, "/api/cardnews/export", { method: "POST", body })
-    .catch((e) => die(exitCodeForError(e), e.message));
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ ") + "export requested");
-  if (resp && typeof resp === "object" && Object.keys(resp).length > 0) out(JSON.stringify(resp, null, 2));
-}
-
-type Sub = (argv: any[]) => Promise<void>;
-
-export default async function cardnewsCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-
-  if (sub === "template") {
-    const s2 = argv[1];
-    if (s2 === "preview") return templatePreviewSub(argv.slice(2));
-    die(2, `unknown subcommand: template ${s2 || ""}\n${HELP}`);
-  }
-  if (sub === "set") {
-    const s2 = argv[1];
-    const SET_SUB: Record<string, Sub> = { show: setShowSub, manifest: setManifestSub };
-    const handler = SET_SUB[s2];
-    if (!handler) die(2, `unknown subcommand: set ${s2 || ""}\n${HELP}`);
-    return handler(argv.slice(2));
-  }
-  if (sub === "job") {
-    const s2 = argv[1];
-    const JOB_SUB: Record<string, Sub> = { create: jobCreateSub, show: jobShowSub, retry: jobRetrySub };
-    const handler = JOB_SUB[s2];
-    if (!handler) die(2, `unknown subcommand: job ${s2 || ""}\n${HELP}`);
-    return handler(argv.slice(2));
-  }
-  if (sub === "card") {
-    const s2 = argv[1];
-    if (s2 === "regenerate") return cardRegenerateSub(argv.slice(2));
-    die(2, `unknown subcommand: card ${s2 || ""}\n${HELP}`);
-  }
-
-  const FLAT: Record<string, Sub> = {
-    templates: templatesSub,
-    sets: setsSub,
-    draft: draftSub,
-    generate: generateSub,
-    export: exportSub,
-  };
-  const handler = FLAT[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}

package/bin/commands/comfy.ts

@@ -1,54 +0,0 @@
-import { writeFile, access } from "fs/promises";
-import { parseArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, color, json, exitCodeForError } from "../lib/output.js";
-
-const HELP = `
-  ima2 comfy <subcommand> [options]
-
-  Subcommands:
-    export <filename> [-o <out>] [--force]
-`;
-
-const FLAGS = {
-  json: { type: "boolean" },
-  server: { type: "string" },
-  out: { short: "o", type: "string" },
-  force: { type: "boolean" },
-  help: { short: "h", type: "boolean" },
-};
-
-async function exportSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  const filename = args.positional[0];
-  if (!filename) die(2, "filename required");
-  let server;
-  try { server = await resolveServer({ serverFlag: args.server }); }
-  catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
-  const resp: any = await request(server.base, "/api/comfy/export-image", {
-    method: "POST",
-    body: { filename },
-  }).catch((e: unknown) => { const err = e as { message?: string; code?: string }; die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`); });
-  const target = String(args.out || `${filename}.workflow.json`);
-  if (!args.force) {
-    try {
-      await access(target);
-      die(2, `${target} already exists. Pass --force to overwrite.`);
-    } catch { /* file does not exist — proceed */ }
-  }
-  await writeFile(target, JSON.stringify(resp, null, 2));
-  if (args.json) { json({ path: target }); return; }
-  out(color.green("✓ ") + target);
-}
-
-const SUB: Record<string, (argv: any[]) => Promise<void>> = {
-  export: exportSub,
-};
-
-export default async function comfyCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-  const handler = SUB[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}