@koda-sl/baker-cli 0.292.0-dev.1d5970764 → 0.293.0-dev.cf9d5462d

package/dist/cli.js

@@ -29824,7 +29824,7 @@ var VIDEO_ROUTING = "In video, a photoreal presenter renders on `google/veo-3.1`
 function castingHints(avatar) {
   if (avatar.status === "generating") {
     return [
-      `Still building. The identity sheet is a ~30s render that settles on its own \u2014 this avatar is castable only once its status is \`ready\`. Do the next piece of work, then check with \`baker avatars get ${avatar.handle}\`. Never sleep waiting on it.`
+      `Still building \u2014 a ~30s render that settles on its own, and this avatar is castable only once it reads \`ready\`. If the next thing you do needs it (a clip, a still, anything with --avatar), block on it: \`baker avatars get ${avatar.handle} --wait\` returns the moment it is ready. Otherwise do other work first and read it back with \`baker avatars get ${avatar.handle}\`. Never write your own sleep or poll loop, and never end the turn waiting \u2014 the user would have to come back and tell you it is ready.`
     ];
   }
   if (avatar.status === "error") {
@@ -30282,6 +30282,28 @@ var deleteCommand = defineCommand97({
 
 // src/commands/avatars/get.ts
 import { defineCommand as defineCommand98 } from "citty";
+
+// src/commands/avatars/wait.ts
+var WAIT_TIMEOUT_MS = 9e4;
+var WAIT_INTERVAL_MS = 3e3;
+function shouldKeepWaiting(status, elapsedMs) {
+  if (status === "ready") return { done: true, reason: "ready" };
+  if (status === "error" || status === "archived") return { done: true, reason: "settled" };
+  if (elapsedMs >= WAIT_TIMEOUT_MS) return { done: false, reason: "expired" };
+  return { done: false, reason: "building" };
+}
+async function waitForSheet(first, read, sleep4 = (ms) => new Promise((resolve5) => setTimeout(resolve5, ms))) {
+  const startedAt = Date.now();
+  let latest = first;
+  while (!shouldKeepWaiting(latest.status, Date.now() - startedAt).done) {
+    if (shouldKeepWaiting(latest.status, Date.now() - startedAt).reason === "expired") return latest;
+    await sleep4(WAIT_INTERVAL_MS);
+    latest = await read();
+  }
+  return latest;
+}
+
+// src/commands/avatars/get.ts
 registerSchema({
   command: "avatars.get",
   description: "Read one avatar by handle \u2014 the command you run before casting it. Returns its status (only `ready` can be cast), the identity sheet URL every render must be grounded on via --reference, and the subject description that goes into the prompt VERBATIM. Add --full for the whole written profile (persona, speech, motion, wardrobe, setting, guardrails, voice, source photos).",
@@ -30305,7 +30327,13 @@ var getCommand2 = defineCommand98({
     "avatar-handle": { type: "string", description: "Avatar handle (alternative to positional)", required: false },
     full: { type: "boolean", description: "Include the whole written profile", required: false, default: 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 }
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    wait: {
+      type: "boolean",
+      description: "Block until the identity sheet has settled (up to 90s), instead of returning while it is still building. Use it when the NEXT thing you do needs this avatar \u2014 a clip, a still, anything with --avatar. Without it you get the current status and have to come back; with it the command returns the moment it is ready. Never write your own sleep/poll loop around this.",
+      required: false,
+      default: false
+    }
   },
   run: async ({ args }) => {
     const handle = (args.handle || args["avatar-handle"])?.trim();
@@ -30315,7 +30343,13 @@ var getCommand2 = defineCommand98({
     try {
       const params = { handle };
       if (args.full) params.full = "1";
-      const avatar = await readAvatars("/api/avatars/get", params);
+      let avatar = await readAvatars("/api/avatars/get", params);
+      if (args.wait) {
+        avatar = await waitForSheet(
+          avatar,
+          () => readAvatars("/api/avatars/get", params)
+        );
+      }
       const hints2 = castingHints(avatar);
       const format = args.output || "json";
       if (format === "json") {