@hypersocial/decks-cli 0.1.8 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypersocial/decks-cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Command-line client for Hypersocial Decks live analytics and share management.",
   "type": "module",
   "main": "./src/commands.mjs",

package/src/commands.mjs

@@ -227,6 +227,8 @@ commands:
   skill install [--agent codex,claude-code] [--all-agents]
   skills install [--agent codex,claude-code] [--all-agents]
   activity [--deck <slug>] [--limit <n>] [--json]
+  gen-image "<prompt>" [--transparent] [--image <url>] [--size <s>] [--quality <q>] [--count <n>] [--slug <deck>] [--download <file>]
+  image-job <jobId> [--json]
 
 global:
   --json
@@ -244,7 +246,7 @@ async function genImage(pos, opts) {
       'usage: gen-image "<prompt>" [--image <url>] [--transparent] [--size <s>] [--quality <q>] [--count <n>] [--format png|jpeg|webp] [--slug <deck>] [--name <name>] [--download <file>]',
     );
   }
-  const out = await ops.generateImage(opts, {
+  let out = await ops.generateImage(opts, {
     prompt,
     image: opts.image,
     transparent: opts.transparent,
@@ -255,6 +257,16 @@ async function genImage(pos, opts) {
     slug: opts.slug,
     name: opts.name,
   });
+  // Slow requests (high/auto quality, transparent, count>1) come back as a job id;
+  // poll it so gen-image stays one blocking command. Progress prints to stderr so
+  // it doesn't pollute the URL output (or --json).
+  if (out.jobId) {
+    process.stderr.write(`queued ${out.count} image(s) — job ${out.jobId}\n`);
+    out = await ops.pollImageJob(opts, out.jobId, {
+      onProgress: (job) => process.stderr.write(`  ${job.progress} (${job.status})…\r`),
+    });
+    process.stderr.write("\n");
+  }
   const images = out.images || [];
   if (opts.download && images.length) {
     for (let i = 0; i < images.length; i++) {
@@ -267,9 +279,23 @@ async function genImage(pos, opts) {
   if (opts.json) {
     console.log(JSON.stringify(out, null, 2));
   } else {
-    for (const im of images) console.log(im.url);
-    if (opts.download) console.log(`saved ${images.length} file(s)`);
+    for (const im of images) if (im.url) console.log(im.url);
+    if (opts.download) console.log(`\nSaved ${images.length} file(s) to ${opts.download}`);
+  }
+}
+
+async function imageJob(pos, opts) {
+  const [jobId] = pos;
+  if (!jobId) throw new Error("usage: image-job <jobId>");
+  const job = await ops.checkImageJob(opts, jobId);
+  if (opts.json) {
+    console.log(JSON.stringify(job, null, 2));
+    return;
   }
+  console.log(`status:   ${job.status}`);
+  console.log(`progress: ${job.progress}`);
+  if (job.error) console.log(`error:    ${job.error}`);
+  for (const im of job.results || []) if (im.url) console.log(im.url);
 }
 
 export async function runCli(argv = process.argv.slice(2)) {
@@ -307,6 +333,7 @@ export async function runCli(argv = process.argv.slice(2)) {
     "skills install": () => installHyperdecksSkill(opts, rest),
     activity: () => activity(pos.slice(1), opts),
     "gen-image": () => genImage(pos.slice(1), opts),
+    "image-job": () => imageJob(pos.slice(1), opts),
   };
 
   const handler = handlers[`${group} ${cmd}`] || handlers[group];

package/src/ops.mjs

@@ -51,9 +51,41 @@ export async function generateImage(opts, fields = {}) {
   if (fields.quality) args.quality = String(fields.quality);
   if (fields.count != null && fields.count !== "") args.count = Number(fields.count);
   if (fields.format) args.format = String(fields.format);
+  // Returns { images } for fast requests, or { jobId, status, count } for slow ones
+  // (high/auto quality, transparent, count>1). The MCP tool returns this as-is so it
+  // never blocks; the CLI polls with pollImageJob to stay one-command (see commands).
   return (await client(opts)).action(api.imagegen.generateImage, args);
 }
 
+// Read one async image job's status/results. Shared by the MCP check_image_job tool
+// and the CLI poller.
+export async function checkImageJob(opts, jobId) {
+  if (!jobId) throw new Error("jobId is required");
+  return (await client(opts)).query(api.imagegen.checkImageJob, { jobId: String(jobId) });
+}
+
+// Poll an async image job until it finishes. Returns { images, slug } on success
+// (results are the same shape as the inline { images }); throws on job error or
+// timeout. `onProgress(job)` is called each tick. Used by the CLI so gen-image stays
+// a single blocking command even when it routes to a background job.
+export async function pollImageJob(opts, jobId, { intervalMs = 3000, timeoutMs = 900_000, onProgress } = {}) {
+  const c = await client(opts);
+  const start = Date.now();
+  for (;;) {
+    const job = await c.query(api.imagegen.checkImageJob, { jobId: String(jobId) });
+    if (job.status === "done") return { images: job.results || [], slug: job.slug };
+    if (job.status === "error") {
+      // A batch isn't atomic: earlier images may have been generated + saved before
+      // the failure. Surface that so the user knows assets/spend exist despite "error".
+      const ok = (job.results || []).filter((r) => r.url).length;
+      throw new Error(`${job.error || "image job failed"}${ok ? ` (${ok} image(s) completed before the failure)` : ""}`);
+    }
+    if (Date.now() - start > timeoutMs) throw new Error(`image job ${jobId} timed out after ${Math.round(timeoutMs / 1000)}s`);
+    if (onProgress) onProgress(job);
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+}
+
 export async function listShares(opts, slug) {
   if (!slug) throw new Error("slug is required");
   const rows = await (await client(opts)).query(api.shares.listForDeck, { deckSlug: slug });

package/src/runtime.mjs

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
 import { ConvexHttpClient } from "convex/browser";
 import { makeFunctionReference } from "convex/server";
 
-export const VERSION = "0.1.7";
+export const VERSION = "0.1.9";
 const UPLOAD_TIMEOUT_MS = 125_000;
 
 export const PROD = {
@@ -47,6 +47,7 @@ export const api = {
   },
   imagegen: {
     generateImage: makeFunctionReference("imagegen:generateImage"),
+    checkImageJob: makeFunctionReference("imagegen:checkImageJob"),
   },
 };