@workser/cli 0.6.16 → 0.6.17

package/dist/index.js

@@ -3663,6 +3663,158 @@ var import_picocolors2 = __toESM(require_picocolors(), 1);
 
 // src/help-content.ts
 var HELP_TOPICS = [
+  {
+    topic: "agent-cloud",
+    title: "Ship an agent inside the app",
+    summary: "Create an AI agent that runs on Workser and can be called from this project's apps.",
+    commands: ["agent-cloud"],
+    source: "skills/workser/reference/agent-cloud.md",
+    body: `# Ship an agent inside the app
+
+\`workser agent-cloud\` creates an AI agent that runs on **Workser's**
+infrastructure, keeps its own memory and tools, and can be called from the web,
+mobile, API or Python apps in this project.
+
+**This is not \`workser agent\`.** That one hands a subtask to a coding agent on
+this machine \u2014 a teammate helping you build. This one is a thing the project
+*ships*: it works for the user after you are gone.
+
+\`\`\`
+workser agent-cloud list
+workser agent-cloud create "Order desk" --instructions "..."
+workser agent-cloud show <agentId>
+workser agent-cloud run <agentId> "<what to do>"
+workser agent-cloud runs <agentId>        # recent runs
+workser agent-cloud runs <runId>          # one run, with what it cost
+\`\`\`
+
+Every call is scoped to the project this folder belongs to.
+
+## Creating one is not finishing one
+
+An agent created with a name and a sentence knows nothing about the business.
+Teaching it is the actual work, and it is all here:
+
+\`\`\`
+workser agent-cloud set <id> system_prompt="..." handle="orderdesk"
+workser agent-cloud add <id> skill name="Refunds" instructions_md="..."
+workser agent-cloud add <id> knowledge name="Price list" content_text="..."
+workser agent-cloud add <id> tool display_name="Send email" provider="gmail" \\
+                             provider_tool_id="GMAIL_SEND_EMAIL"
+workser agent-cloud add <id> secret key="STRIPE_KEY" value="..."
+workser agent-cloud add <id> subagent subagent_id=<otherId> name="researcher"
+workser agent-cloud get <id> skill          # what it has
+workser agent-cloud remove <id> skill <itemId>
+\`\`\`
+
+\`add\` takes \`key=value\` pairs and REFUSES a field it does not know, rather than
+sending it. That matters: the API silently drops unknown fields, so a typo
+would otherwise be accepted, dropped, and reported as success \u2014 leaving an
+agent that had been told nothing.
+
+## Nothing takes effect until you publish
+
+**This is the step to not forget.** The runtime resolves the PUBLISHED version
+of an agent and never the draft, so every \`set\` and \`add\` above is inert until:
+
+\`\`\`
+workser agent-cloud publish <id> --note "taught it refunds"
+\`\`\`
+
+Before publishing, try the setup without putting it live:
+
+\`\`\`
+workser agent-cloud try <id> "a customer wants a refund on order 1042"
+\`\`\`
+
+A \`try\` runs the draft, costs the same as a real run, and changes nothing that
+customers can reach.
+
+## Choosing how it thinks and what it runs on
+
+\`\`\`
+workser agent-cloud models            # cheapest first, on Workser credit
+workser agent-cloud models --all      # includes ones needing your own key
+workser agent-cloud set <id> default_provider=openrouter default_model=...
+
+workser agent-cloud machines          # video, data analysis, design, ...
+\`\`\`
+
+A model marked "needs your own key" will make \`publish\` FAIL unless a matching
+secret is stored first. Add the key with \`add <id> secret\` before setting it.
+
+## Agents need a paid plan \u2014 the trial does not include them
+
+\`create\` and \`run\` both refuse with **402** on a free or trialling
+organisation. That is a rule, not a fault: every run buys model tokens and
+holds a machine, so it costs real money the moment it happens.
+
+**When you hit it, hand the plan over \u2014 do not just describe it.** Workser
+files the refusal on the conversation as a step and an artifact the user can
+click, so the person you are helping gets something actionable rather than a
+paragraph. Say plainly what you were doing, that agents need a plan, and stop.
+
+Do NOT:
+
+- retry the call, or try a different agent \u2014 the answer is the same
+- try to work around it by running the job yourself as a coding agent; that is
+  a different product and it will not be there when the user closes the window
+- guess at prices, discounts or trial extensions
+
+If the user asks how much: it is per minute of run time plus the model, and the
+plan page has the current figures. You do not have them.
+
+## When to reach for this
+
+When the user describes a job that **keeps happening** and needs judgement:
+"check every order for stock and email me the problems", "read the LINE
+messages and file them", "reconcile these invoices". That is an agent.
+
+A one-off transformation is not an agent \u2014 write the code. A fixed sequence of
+steps with no judgement in it is not an agent either \u2014 that is \`workser
+workflow\`.
+
+## Calling it from the app you are building
+
+Do NOT shell out to the CLI from app code. Use the SDK, which streams:
+
+\`\`\`ts
+import { workser } from '@workser/app';
+
+const run = await workser.agents.run(agentId, { message }, {
+  referenceUserId: user.id,   // who it is acting for
+});
+
+for await (const event of workser.agents.stream(run.id)) {
+  // event.type, event.data \u2014 forward these to the browser
+}
+\`\`\`
+
+\`stream()\` reconnects itself through dropped connections, so the person
+watching sees the agent think. See the \`workser-sdk\` skill, \`reference/agents.md\`.
+
+## Things that will bite you
+
+1. **A run costs money by the minute.** It is metered \u2014 runtime, workspace, and
+   a per-run fee \u2014 so a loop that starts agents is a loop that spends. Cancel
+   what you abandon: \`workser agent-cloud runs <runId>\` shows the cost.
+
+2. **Instructions are the product.** The agent does what its instructions say,
+   in the user's own words. Write them the way you would brief a new colleague:
+   what to do, what to leave alone, when to ask. Vague instructions are the
+   single biggest cause of an agent that "doesn't work".
+
+3. **Free plans cannot run agents at all**, and a trial has a small allowance.
+   A \`402\` with \`spend_limit_reached\` is not a bug \u2014 tell the user what it says
+   and point them at their plan.
+
+4. **Say who it is for.** An agent acting for one of the app's customers needs
+   \`referenceUserId\`, or its memory and audit trail belong to nobody.
+
+5. **Do not invent an agent the user did not ask for.** Creating one is cheap;
+   an agent nobody wanted, quietly costing money per run, is not.
+`
+  },
   {
     topic: "analysis",
     title: "Analysis \u2014 running Python on this project's data",
@@ -7459,8 +7611,366 @@ function formatRole(r) {
   return `${label}  ${agent}  ${enabled}  ${ready}${tail}`;
 }
 
-// src/commands/verify.ts
+// src/commands/agent-cloud.ts
 var import_picocolors17 = __toESM(require_picocolors(), 1);
+function registerAgentCloud(program3) {
+  const cloud = program3.command("agent-cloud").description(
+    "Agents that run in the cloud and can be called from this project's apps (not the local coding agents \u2014 that's `workser agent`)"
+  );
+  cloud.command("list").description("List this project's cloud agents").action(
+    action(async ({ ctx }) => {
+      const res = await api(ctx, "/v1/agent-cloud");
+      const agents = res?.agents ?? res ?? [];
+      ok(res, () => {
+        if (!agents.length) {
+          line(import_picocolors17.default.dim("No cloud agents yet."));
+          line(
+            import_picocolors17.default.dim("Create one: ") + import_picocolors17.default.bold('workser agent-cloud create "Order desk" --instructions "..."')
+          );
+          return;
+        }
+        for (const a of agents) {
+          line(
+            `${import_picocolors17.default.bold(a.name ?? a.id)}  ${import_picocolors17.default.dim(a.id)}` + (a.status ? `  ${import_picocolors17.default.dim(a.status)}` : "")
+          );
+          if (a.description) line("  " + import_picocolors17.default.dim(a.description));
+        }
+      });
+    })
+  );
+  cloud.command("create <name>").description("Create a cloud agent in this project").option("--description <text>", "What it is for, in the owner's words").option(
+    "--instructions <text>",
+    "The agent's standing instructions \u2014 what it should always do"
+  ).action(
+    action(async ({ ctx, args, opts }) => {
+      const res = await api(ctx, "/v1/agent-cloud", {
+        method: "POST",
+        body: {
+          name: args[0],
+          description: opts.description,
+          instructions: opts.instructions
+        }
+      });
+      ok(res, () => {
+        line(import_picocolors17.default.green("Created ") + import_picocolors17.default.bold(res?.name ?? args[0]));
+        if (res?.id) line(import_picocolors17.default.dim(res.id));
+        line("");
+        line(
+          import_picocolors17.default.dim("Give it work: ") + import_picocolors17.default.bold(`workser agent-cloud run ${res?.id ?? "<id>"} "..."`)
+        );
+      });
+    })
+  );
+  cloud.command("show <agentId>").description("One cloud agent, with its configuration").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(ctx, `/v1/agent-cloud/${encodeURIComponent(args[0])}`);
+      ok(res, () => {
+        line(import_picocolors17.default.bold(res?.name ?? args[0]));
+        if (res?.description) line(import_picocolors17.default.dim(res.description));
+        if (res?.instructions) {
+          line("");
+          line(import_picocolors17.default.bold("instructions:"));
+          line(res.instructions);
+        }
+      });
+    })
+  );
+  cloud.command("run <agentId> <message>").description("Give a cloud agent something to do").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(args[0])}/runs`,
+        { method: "POST", body: { input: { message: args[1] } } }
+      );
+      ok(res, () => {
+        line(import_picocolors17.default.green("Started run ") + import_picocolors17.default.bold(res?.id ?? ""));
+        line(
+          import_picocolors17.default.dim("Follow it: ") + import_picocolors17.default.bold(`workser agent-cloud runs ${res?.id ?? "<runId>"}`)
+        );
+      });
+    })
+  );
+  cloud.command("runs [agentIdOrRunId]").description("Recent runs for an agent, or one run in detail").option("--limit <n>", "How many to list", "10").action(
+    action(async ({ ctx, args, opts }) => {
+      const id = args[0];
+      if (!id) {
+        warn("Give an agent id to list its runs, or a run id to inspect one.");
+        return;
+      }
+      try {
+        const run = await api(
+          ctx,
+          `/v1/agent-cloud/runs/${encodeURIComponent(id)}`
+        );
+        ok(run, () => printRun(run));
+        return;
+      } catch {
+      }
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(id)}/runs`,
+        { query: { limit: opts.limit } }
+      );
+      const runs = res?.runs ?? res ?? [];
+      ok(res, () => {
+        if (!runs.length) {
+          line(import_picocolors17.default.dim("No runs yet."));
+          return;
+        }
+        for (const r of runs) printRun(r, true);
+      });
+    })
+  );
+  const COLLECTIONS = {
+    skill: {
+      path: "skills",
+      key: "skills",
+      label: "skill",
+      fields: ["name", "description", "instructions_md"],
+      required: ["name"]
+    },
+    tool: {
+      path: "tools",
+      key: "tools",
+      label: "action",
+      fields: ["display_name", "provider", "provider_tool_id", "description"],
+      required: ["display_name"]
+    },
+    mcp: {
+      path: "mcp-servers",
+      key: "servers",
+      label: "MCP server",
+      fields: ["name", "url"],
+      required: ["name", "url"]
+    },
+    knowledge: {
+      path: "resources",
+      key: "resources",
+      label: "reference material",
+      fields: ["name", "content_text"],
+      required: ["name"]
+    },
+    secret: {
+      path: "secrets",
+      key: "secrets",
+      label: "stored key",
+      fields: ["key", "value", "description"],
+      required: ["key", "value"]
+    },
+    subagent: {
+      path: "subagents",
+      key: "subagents",
+      label: "team member",
+      fields: ["subagent_id", "name", "description"],
+      required: ["subagent_id", "name"]
+    },
+    workflow: {
+      path: "workflows",
+      key: "workflows",
+      label: "workflow",
+      fields: ["workflow_id", "description"],
+      required: ["workflow_id"]
+    }
+  };
+  const kinds = Object.keys(COLLECTIONS).join(" | ");
+  cloud.command("get <agentId> <kind>").description(`What an agent has been given (${kinds})`).action(
+    action(async ({ ctx, args }) => {
+      const spec = COLLECTIONS[args[1]];
+      if (!spec) throw new Error(`Unknown kind "${args[1]}". One of: ${kinds}`);
+      const res = await api(ctx, `/v1/agent-cloud/${encodeURIComponent(args[0])}/${spec.path}`);
+      const items = res?.[spec.key] ?? [];
+      ok(res, () => {
+        if (!items.length) {
+          line(import_picocolors17.default.dim(`No ${spec.label} yet.`));
+          return;
+        }
+        for (const i of items) {
+          const title = i.name ?? i.display_name ?? i.key ?? i.workflow_id ?? i.id;
+          line(`${import_picocolors17.default.bold(title)}  ${import_picocolors17.default.dim(i.id)}`);
+          if (i.description) line("  " + import_picocolors17.default.dim(i.description));
+          if (i.is_enabled === false) line("  " + import_picocolors17.default.yellow("turned off"));
+        }
+      });
+    })
+  );
+  cloud.command("add <agentId> <kind> [pairs...]").description(
+    `Give an agent something (${kinds}). Pairs are key=value, e.g. name="Refunds"`
+  ).action(
+    action(async ({ ctx, args }) => {
+      const spec = COLLECTIONS[args[1]];
+      if (!spec) throw new Error(`Unknown kind "${args[1]}". One of: ${kinds}`);
+      const body = parsePairs(args[2] ?? [], spec.fields);
+      const missing = spec.required.filter((f) => !body[f]);
+      if (missing.length) {
+        throw new Error(
+          `A ${spec.label} needs ${missing.join(" and ")}. Accepted: ${spec.fields.join(", ")}`
+        );
+      }
+      const res = await api(ctx, `/v1/agent-cloud/${encodeURIComponent(args[0])}/${spec.path}`, {
+        method: "POST",
+        body
+      });
+      ok(res, () => {
+        line(import_picocolors17.default.green(`Added the ${spec.label}.`) + "  " + import_picocolors17.default.dim(res?.id ?? ""));
+        line(
+          import_picocolors17.default.dim("Not live yet \u2014 run ") + import_picocolors17.default.bold(`workser agent-cloud publish ${args[0]}`) + import_picocolors17.default.dim(" when the setup is ready.")
+        );
+      });
+    })
+  );
+  cloud.command("remove <agentId> <kind> <itemId>").description(`Take something away from an agent (${kinds})`).action(
+    action(async ({ ctx, args }) => {
+      const spec = COLLECTIONS[args[1]];
+      if (!spec) throw new Error(`Unknown kind "${args[1]}". One of: ${kinds}`);
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(args[0])}/${spec.path}/${encodeURIComponent(args[2])}`,
+        { method: "DELETE" }
+      );
+      ok(res, () => line(import_picocolors17.default.green(`Removed the ${spec.label}.`)));
+    })
+  );
+  cloud.command("set <agentId> [pairs...]").description(
+    "Change the brief or the model. Pairs: name, description, system_prompt, handle, default_provider, default_model"
+  ).action(
+    action(async ({ ctx, args }) => {
+      const body = parsePairs(args[1] ?? [], [
+        "name",
+        "description",
+        "system_prompt",
+        "handle",
+        "default_provider",
+        "default_model"
+      ]);
+      if (!Object.keys(body).length) {
+        throw new Error(
+          'Nothing to change. Example: workser agent-cloud set <id> system_prompt="Always check stock first"'
+        );
+      }
+      const res = await api(ctx, `/v1/agent-cloud/${encodeURIComponent(args[0])}`, {
+        method: "PATCH",
+        body
+      });
+      ok(res, () => {
+        line(import_picocolors17.default.green("Saved."));
+        line(
+          import_picocolors17.default.dim("Not live yet \u2014 run ") + import_picocolors17.default.bold(`workser agent-cloud publish ${args[0]}`) + import_picocolors17.default.dim(".")
+        );
+      });
+    })
+  );
+  cloud.command("publish <agentId>").description("Put the current setup live \u2014 nothing takes effect until this runs").option("--note <text>", "What changed, for the version history").action(
+    action(async ({ ctx, args, opts }) => {
+      const res = await api(ctx, `/v1/agent-cloud/${encodeURIComponent(args[0])}/publish`, {
+        method: "POST",
+        body: { changelog: opts.note }
+      });
+      ok(
+        res,
+        () => line(import_picocolors17.default.green(`Live${res?.version ? ` \u2014 version ${res.version}` : ""}.`))
+      );
+    })
+  );
+  cloud.command("try <agentId> <message>").description("Run the current setup WITHOUT publishing it").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(ctx, `/v1/agent-cloud/${encodeURIComponent(args[0])}/test-runs`, {
+        method: "POST",
+        body: { input: { message: args[1] } }
+      });
+      ok(res, () => {
+        line(import_picocolors17.default.green("Trying it \u2014 nothing has gone live."));
+        if (res?.run_id) {
+          line(
+            import_picocolors17.default.dim("Watch it: ") + import_picocolors17.default.bold(`workser agent-cloud runs ${res.run_id}`)
+          );
+        }
+      });
+    })
+  );
+  cloud.command("machines").description("The pre-built machines an agent can run on").action(
+    action(async ({ ctx }) => {
+      const res = await api(ctx, "/v1/agent-cloud/catalog/machines");
+      ok(res, () => {
+        for (const m of res?.machines ?? []) {
+          line(`${import_picocolors17.default.bold(m.label)}  ${import_picocolors17.default.dim(m.alias)}`);
+          line("  " + import_picocolors17.default.dim(m.description));
+        }
+      });
+    })
+  );
+  cloud.command("models").description("Models this organisation can run an agent on, cheapest first").option("--all", "Include models that need your own provider key").action(
+    action(async ({ ctx, opts }) => {
+      const res = await api(ctx, "/v1/agent-cloud/catalog/models/live");
+      const models = (res?.models ?? []).filter(
+        (m) => opts.all || m.credit_tier === "PLATFORM_CREDITS"
+      );
+      ok(res, () => {
+        if (!models.length) {
+          warn("The live model list could not be read.");
+          return;
+        }
+        for (const m of models.slice(0, 40)) {
+          const price = typeof m.input_price_per_million_usd === "number" ? `$${m.input_price_per_million_usd.toFixed(2)}/M in` : "price unknown";
+          const byok = m.credit_tier === "PLATFORM_CREDITS" ? "" : import_picocolors17.default.yellow("  needs your own key");
+          line(`${import_picocolors17.default.bold(m.id)}  ${import_picocolors17.default.dim(price)}${byok}`);
+        }
+      });
+    })
+  );
+}
+function printRun(run, compact = false) {
+  const status = String(run?.status ?? "").toLowerCase();
+  const colour2 = status === "completed" ? import_picocolors17.default.green : status === "failed" ? import_picocolors17.default.red : import_picocolors17.default.yellow;
+  line(
+    `${colour2(status || "unknown")}  ${import_picocolors17.default.bold(run?.id ?? "")}` + (run?.duration_ms ? `  ${import_picocolors17.default.dim(formatDuration(run.duration_ms))}` : "")
+  );
+  const breakdown = run?.cost_breakdown;
+  if (breakdown) {
+    if (!breakdown.settled) {
+      line("  " + import_picocolors17.default.dim("cost: still being worked out"));
+    } else {
+      line("  " + import_picocolors17.default.dim(`cost: $${Number(breakdown.total_usd).toFixed(4)}`));
+      line(
+        "    " + import_picocolors17.default.dim(
+          `model $${Number(breakdown.model_usd).toFixed(4)} \xB7 infrastructure $${Number(breakdown.infrastructure_usd).toFixed(4)}`
+        )
+      );
+    }
+  } else if (run?.cost_usd !== void 0 && run?.cost_usd !== null) {
+    line("  " + import_picocolors17.default.dim(`model cost: $${Number(run.cost_usd).toFixed(4)}`));
+  }
+  if (!compact && run?.output) {
+    line("");
+    line(typeof run.output === "string" ? run.output : JSON.stringify(run.output, null, 2));
+  }
+  if (run?.error?.message) line("  " + import_picocolors17.default.red(run.error.message));
+}
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  const seconds = Math.round(ms / 1e3);
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  return `${minutes}m ${seconds % 60}s`;
+}
+function parsePairs(pairs, allowed) {
+  const out = {};
+  for (const raw of pairs) {
+    const at = raw.indexOf("=");
+    if (at < 1) {
+      throw new Error(`"${raw}" is not a key=value pair.`);
+    }
+    const key = raw.slice(0, at).trim();
+    const value = raw.slice(at + 1);
+    if (!allowed.includes(key)) {
+      throw new Error(`"${key}" is not a field here. Accepted: ${allowed.join(", ")}`);
+    }
+    if (value) out[key] = value;
+  }
+  return out;
+}
+
+// src/commands/verify.ts
+var import_picocolors18 = __toESM(require_picocolors(), 1);
 function registerVerify(program3) {
   program3.command("verify").description(
     "Run the project's checks (typecheck/lint/build) \u2014 use before declaring a task done"
@@ -7482,23 +7992,23 @@ function registerVerify(program3) {
 function printVerify(res) {
   if (!res) return;
   if (!res.checks?.length) {
-    line(import_picocolors17.default.dim(res.note ?? "No checks detected."));
+    line(import_picocolors18.default.dim(res.note ?? "No checks detected."));
     return;
   }
   for (const c of res.checks) {
     line(
-      `  ${c.ok ? import_picocolors17.default.green("\u2713") : import_picocolors17.default.red("\u2717")} ${c.name}${c.ok ? "" : import_picocolors17.default.dim(` (exit ${c.exitCode})`)}`
+      `  ${c.ok ? import_picocolors18.default.green("\u2713") : import_picocolors18.default.red("\u2717")} ${c.name}${c.ok ? "" : import_picocolors18.default.dim(` (exit ${c.exitCode})`)}`
     );
   }
   if (res.ok) success("All checks passed");
   else
     line(
-      import_picocolors17.default.red("Some checks failed \u2014 fix the errors above and re-run ") + import_picocolors17.default.bold("workser verify") + import_picocolors17.default.red(".")
+      import_picocolors18.default.red("Some checks failed \u2014 fix the errors above and re-run ") + import_picocolors18.default.bold("workser verify") + import_picocolors18.default.red(".")
     );
 }
 
 // src/commands/checkpoint.ts
-var import_picocolors18 = __toESM(require_picocolors(), 1);
+var import_picocolors19 = __toESM(require_picocolors(), 1);
 function registerCheckpoint(program3) {
   program3.command("checkpoint [label]").description(
     "Save the current state of this folder so you can come back to it"
@@ -7515,8 +8025,8 @@ function registerCheckpoint(program3) {
       ok(res, () => {
         const p = res?.point;
         success(`Saved a checkpoint${p?.label ? `: ${p.label}` : ""}`);
-        if (p?.ref) line(import_picocolors18.default.dim(`  ${p.ref.slice(0, 7)}`));
-        line(import_picocolors18.default.dim("  Come back to it with `workser restore`."));
+        if (p?.ref) line(import_picocolors19.default.dim(`  ${p.ref.slice(0, 7)}`));
+        line(import_picocolors19.default.dim("  Come back to it with `workser restore`."));
       });
     })
   );
@@ -7542,12 +8052,12 @@ function registerCheckpoint(program3) {
         );
         if (res?.filesChanged) {
           line(
-            import_picocolors18.default.dim(
+            import_picocolors19.default.dim(
               `  ${res.filesChanged} file${res.filesChanged === 1 ? "" : "s"} changed`
             )
           );
         }
-        line(import_picocolors18.default.dim("  This is reversible: `workser restore` again."));
+        line(import_picocolors19.default.dim("  This is reversible: `workser restore` again."));
       });
     })
   );
@@ -7564,25 +8074,25 @@ function registerCheckpoint(program3) {
 function printPoints(points) {
   if (!points.length) {
     info("No checkpoints yet for this folder.");
-    line(import_picocolors18.default.dim("  Take one with `workser checkpoint`."));
+    line(import_picocolors19.default.dim("  Take one with `workser checkpoint`."));
     return;
   }
-  line(import_picocolors18.default.bold("Checkpoints"));
+  line(import_picocolors19.default.bold("Checkpoints"));
   for (const p of points) {
     const when = p.at ? new Date(p.at).toLocaleString() : "";
     line(
-      `  ${import_picocolors18.default.dim(p.ref.slice(0, 7))}  ${p.label}${when ? import_picocolors18.default.dim(`  ${when}`) : ""}`
+      `  ${import_picocolors19.default.dim(p.ref.slice(0, 7))}  ${p.label}${when ? import_picocolors19.default.dim(`  ${when}`) : ""}`
     );
   }
   line(
-    import_picocolors18.default.dim(
+    import_picocolors19.default.dim(
       "\nGo back with `workser restore <ref>`, or just `workser restore` for the newest."
     )
   );
 }
 
 // src/commands/sync.ts
-var import_picocolors19 = __toESM(require_picocolors(), 1);
+var import_picocolors20 = __toESM(require_picocolors(), 1);
 function registerSync(program3) {
   program3.command("sync").description(
     "Reconcile this folder with the copy Workser holds (pull, then push)"
@@ -7609,7 +8119,7 @@ function registerSync(program3) {
           warn(res?.message ?? "Couldn't sync this folder.");
           if (res?.state === "diverged") {
             line(
-              import_picocolors19.default.dim(
+              import_picocolors20.default.dim(
                 "  This folder and Workser's copy have both changed. Open Workser to resolve it."
               )
             );
@@ -7621,7 +8131,7 @@ function registerSync(program3) {
           return;
         }
         success("Synced");
-        if (res?.ref) line(import_picocolors19.default.dim(`  ${String(res.ref).slice(0, 7)}`));
+        if (res?.ref) line(import_picocolors20.default.dim(`  ${String(res.ref).slice(0, 7)}`));
       });
       if (refused) process.exitCode = 1;
     })
@@ -7629,7 +8139,7 @@ function registerSync(program3) {
 }
 
 // src/commands/workflow.ts
-var import_picocolors20 = __toESM(require_picocolors(), 1);
+var import_picocolors21 = __toESM(require_picocolors(), 1);
 function registerWorkflow(program3) {
   const wf = program3.command("workflow").description("Create, run, and inspect workflow automations for the project");
   wf.command("list").description("List the project's workflows").action(
@@ -7637,10 +8147,10 @@ function registerWorkflow(program3) {
       const projectId = requireProject(ctx);
       const items = await api(ctx, `/v1/projects/${projectId}/workflows`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors20.default.dim("No workflows yet. `workser workflow create`."));
+        if (!items?.length) return line(import_picocolors21.default.dim("No workflows yet. `workser workflow create`."));
         for (const w of items) {
-          const status = w.is_active ? import_picocolors20.default.green("active") : import_picocolors20.default.dim("inactive");
-          line(`${w.id}  ${import_picocolors20.default.bold(w.name ?? "Untitled")}  ${status}`);
+          const status = w.is_active ? import_picocolors21.default.green("active") : import_picocolors21.default.dim("inactive");
+          line(`${w.id}  ${import_picocolors21.default.bold(w.name ?? "Untitled")}  ${status}`);
         }
       });
     })
@@ -7652,7 +8162,7 @@ function registerWorkflow(program3) {
       const res = await api(ctx, `/v1/projects/${projectId}/workflows`, {
         body: { name: args[0], ...extra }
       });
-      ok(res, () => line(`Created workflow ${import_picocolors20.default.bold(res.id)}.`));
+      ok(res, () => line(`Created workflow ${import_picocolors21.default.bold(res.id)}.`));
     })
   );
   wf.command("get <id>").description("Show a workflow's full definition").action(
@@ -7687,8 +8197,8 @@ function registerWorkflow(program3) {
     action(async ({ ctx, args }) => {
       const items = await api(ctx, `/v1/workflows/${args[0]}/executions`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors20.default.dim("No runs yet."));
-        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors20.default.dim(e.started_at ?? "")}`);
+        if (!items?.length) return line(import_picocolors21.default.dim("No runs yet."));
+        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors21.default.dim(e.started_at ?? "")}`);
       });
     })
   );
@@ -7696,15 +8206,15 @@ function registerWorkflow(program3) {
     action(async ({ ctx, args }) => {
       const items = await api(ctx, `/v1/node-types`, { query: { q: args[0] } });
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors20.default.dim("No matching node types."));
-        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors20.default.dim(n.category ?? "")}`);
+        if (!items?.length) return line(import_picocolors21.default.dim("No matching node types."));
+        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors21.default.dim(n.category ?? "")}`);
       });
     })
   );
 }
 
 // src/commands/connection.ts
-var import_picocolors21 = __toESM(require_picocolors(), 1);
+var import_picocolors22 = __toESM(require_picocolors(), 1);
 function registerConnection(program3) {
   const connection = program3.command("connection").description("Connect and use third-party app connections (Gmail, Slack, Stripe, ...)");
   connection.command("list").description("List connectable toolkits and this project's existing connections").option("--toolkit <slug>", "filter connections to one toolkit").action(
@@ -7717,8 +8227,8 @@ function registerConnection(program3) {
       ok({ catalog, connections }, () => {
         const connected = new Set((connections ?? []).map((c) => c.toolkit ?? c.composio_app));
         for (const t of catalog ?? []) {
-          const status = connected.has(t.slug) ? import_picocolors21.default.green("connected") : import_picocolors21.default.dim("not connected");
-          line(`${t.slug}  ${import_picocolors21.default.bold(t.name ?? t.slug)}  ${status}`);
+          const status = connected.has(t.slug) ? import_picocolors22.default.green("connected") : import_picocolors22.default.dim("not connected");
+          line(`${t.slug}  ${import_picocolors22.default.bold(t.name ?? t.slug)}  ${status}`);
         }
       });
     })
@@ -7730,9 +8240,9 @@ function registerConnection(program3) {
         query: { q: args[0], toolkit: opts.toolkit, limit: opts.limit }
       });
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors21.default.dim("No matching actions."));
+        if (!items?.length) return line(import_picocolors22.default.dim("No matching actions."));
         for (const t of items) {
-          line(`${t.slug}  ${import_picocolors21.default.dim(`[${t.toolkit}]`)}  ${t.description ?? ""}`);
+          line(`${t.slug}  ${import_picocolors22.default.dim(`[${t.toolkit}]`)}  ${t.description ?? ""}`);
         }
       });
     })
@@ -7749,7 +8259,7 @@ function registerConnection(program3) {
       });
       ok(
         res,
-        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors21.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
+        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors22.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
       );
     })
   );
@@ -7767,8 +8277,8 @@ function registerConnection(program3) {
       const projectId = requireProject(ctx);
       const items = await api(ctx, `/v1/projects/${projectId}/integrations/${args[0]}/tools`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors21.default.dim("No tools found."));
-        for (const t of items) line(`${t.slug}  ${import_picocolors21.default.dim(t.description ?? "")}`);
+        if (!items?.length) return line(import_picocolors22.default.dim("No tools found."));
+        for (const t of items) line(`${t.slug}  ${import_picocolors22.default.dim(t.description ?? "")}`);
       });
     })
   );
@@ -7784,7 +8294,7 @@ function registerConnection(program3) {
 }
 
 // src/commands/tool.ts
-var import_picocolors22 = __toESM(require_picocolors(), 1);
+var import_picocolors23 = __toESM(require_picocolors(), 1);
 function registerTool(program3) {
   const tool = program3.command("tool").description(
     "Computer-use tools: filesystem, shell, screenshot, input control, clipboard, notifications, basic browser"
@@ -7793,7 +8303,7 @@ function registerTool(program3) {
     action(async ({ ctx }) => {
       const tools = await api(ctx, "/v1/tool/list");
       ok(tools, () => {
-        if (!tools?.length) return line(import_picocolors22.default.dim("No tools available."));
+        if (!tools?.length) return line(import_picocolors23.default.dim("No tools available."));
         const byCategory = /* @__PURE__ */ new Map();
         for (const t of tools) {
           const list = byCategory.get(t.category) ?? [];
@@ -7801,9 +8311,9 @@ function registerTool(program3) {
           byCategory.set(t.category, list);
         }
         for (const [category, items] of byCategory) {
-          line(import_picocolors22.default.bold(category) + ":");
+          line(import_picocolors23.default.bold(category) + ":");
           for (const t of items) {
-            line(`  ${t.name}  ${import_picocolors22.default.dim(t.description ?? "")}`);
+            line(`  ${t.name}  ${import_picocolors23.default.dim(t.description ?? "")}`);
           }
         }
       });
@@ -7821,7 +8331,7 @@ function registerTool(program3) {
 }
 
 // src/commands/memory.ts
-var import_picocolors23 = __toESM(require_picocolors(), 1);
+var import_picocolors24 = __toESM(require_picocolors(), 1);
 function registerMemory(program3) {
   const memory = program3.command("memory").description("Durable, cross-conversation project memory (shared with cloud agents on the same project)");
   memory.command("add <content>").description("Store something worth remembering across future conversations").option("--metadata <json>", "extra metadata for filtering, as a JSON string").option("--id <customId>", "custom id for dedup/updates").action(
@@ -7845,9 +8355,9 @@ function registerMemory(program3) {
       });
       ok(res, () => {
         const results = res?.results ?? res ?? [];
-        if (!results?.length) return line(import_picocolors23.default.dim("No matching memories."));
+        if (!results?.length) return line(import_picocolors24.default.dim("No matching memories."));
         for (const r of results) {
-          line(`${import_picocolors23.default.dim(r.id ?? "?")}  ${memoryText(r)}`);
+          line(`${import_picocolors24.default.dim(r.id ?? "?")}  ${memoryText(r)}`);
         }
       });
     })
@@ -7867,11 +8377,11 @@ function memoryText(r) {
   if (typeof text === "string" && text.trim()) return text;
   const title = r?.documents?.[0]?.title;
   if (typeof title === "string" && title.trim()) return title;
-  return import_picocolors23.default.dim("(no readable text on this row)");
+  return import_picocolors24.default.dim("(no readable text on this row)");
 }
 
 // src/commands/note.ts
-var import_picocolors24 = __toESM(require_picocolors(), 1);
+var import_picocolors25 = __toESM(require_picocolors(), 1);
 function registerNote(program3) {
   program3.command("note <text>").description("Leave a fact the rest of the team will need").addHelpText(
     "after",
@@ -7908,14 +8418,14 @@ function registerNote(program3) {
       }
       ok(res, () => {
         success("Noted for the team.");
-        line(import_picocolors24.default.dim(`  ${text}`));
+        line(import_picocolors25.default.dim(`  ${text}`));
       });
     })
   );
 }
 
 // src/commands/business.ts
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 var RESOURCE_PATHS = {
   "business-config": "business-config",
   "business-settings": "business-settings",
@@ -7975,7 +8485,7 @@ function registerBusiness(program3) {
       const projectId = requireProject(ctx);
       const [resource] = args;
       const res = await api(ctx, businessPath(projectId, resource), { body: JSON.parse(opts.body) });
-      ok(res, () => line(`Created ${resource} ${import_picocolors25.default.bold(res?.id ?? "")}.`));
+      ok(res, () => line(`Created ${resource} ${import_picocolors26.default.bold(res?.id ?? "")}.`));
     })
   );
   biz.command("update <resource> <id>").description("Update a record by id (PATCH/PUT \u2014 matches the underlying route)").option("--body <json>", "changed fields as a JSON object string", "{}").action(
@@ -8017,7 +8527,7 @@ function businessPath(projectId, resource, subpath) {
 }
 
 // src/commands/artifact.ts
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors27 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync2, statSync } from "fs";
 import { resolve as resolve3, basename as basename3 } from "path";
 var KINDS = [
@@ -8114,7 +8624,7 @@ function registerArtifact(program3) {
       ok(
         res,
         () => success(
-          `Recorded ${import_picocolors26.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors26.default.dim(` (${res.kind})`) : ""}`
+          `Recorded ${import_picocolors27.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors27.default.dim(` (${res.kind})`) : ""}`
         )
       );
     })
@@ -8146,13 +8656,13 @@ function registerArtifact(program3) {
   artifact.command("run").description("Show the task/conversation this agent run is attached to").action(
     action(async ({ ctx }) => {
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}`);
-      ok(res, () => printRun(res));
+      ok(res, () => printRun2(res));
     })
   );
 }
 function printArtifacts(rows) {
   if (!rows.length) {
-    line(import_picocolors26.default.dim("Nothing produced yet."));
+    line(import_picocolors27.default.dim("Nothing produced yet."));
     return;
   }
   const byStep = /* @__PURE__ */ new Map();
@@ -8162,26 +8672,26 @@ function printArtifacts(rows) {
     byStep.set(r.subtask_id, list);
   }
   for (const [stepId, items] of byStep) {
-    line(import_picocolors26.default.bold(`step ${stepId}`));
+    line(import_picocolors27.default.bold(`step ${stepId}`));
     for (const a of items) {
-      const flag = a.promoted_at ? import_picocolors26.default.green(" *") : "  ";
+      const flag = a.promoted_at ? import_picocolors27.default.green(" *") : "  ";
       const where = a.local_path || a.cloud_url || "";
       line(
-        `${flag} ${import_picocolors26.default.dim(`[${a.kind}]`)} ${a.title ?? "(untitled)"}` + (where ? import_picocolors26.default.dim(`  ${where}`) : "")
+        `${flag} ${import_picocolors27.default.dim(`[${a.kind}]`)} ${a.title ?? "(untitled)"}` + (where ? import_picocolors27.default.dim(`  ${where}`) : "")
       );
-      if (a.description) line(import_picocolors26.default.dim(`     ${a.description}`));
+      if (a.description) line(import_picocolors27.default.dim(`     ${a.description}`));
     }
     line("");
   }
-  line(import_picocolors26.default.dim("* = handed over as a deliverable; the rest is working material."));
+  line(import_picocolors27.default.dim("* = handed over as a deliverable; the rest is working material."));
 }
-function printRun(run) {
+function printRun2(run) {
   if (!run) return;
-  line(`  run      ${import_picocolors26.default.bold(run.runId)}`);
+  line(`  run      ${import_picocolors27.default.bold(run.runId)}`);
   if (run.taskId) line(`  task     ${run.taskId}`);
   if (run.conversationId) line(`  chat     ${run.conversationId}`);
   if (run.projectId) line(`  project  ${run.projectId}`);
-  if (run.cwd) line(`  folder   ${import_picocolors26.default.dim(run.cwd)}`);
+  if (run.cwd) line(`  folder   ${import_picocolors27.default.dim(run.cwd)}`);
 }
 
 // src/commands/image.ts
@@ -8259,7 +8769,7 @@ function registerImage(program3) {
       );
       const res = await api(
         ctx,
-        `/projects/${projectId}/images/generate`,
+        `/v1/projects/${projectId}/images/generate`,
         {
           method: "POST",
           body: {
@@ -8299,7 +8809,7 @@ function registerImage(program3) {
     action(async ({ ctx, opts, args }) => {
       const projectId = requireProject(ctx);
       const source = await resolveMediaSource({ url: opts.url, file: opts.file });
-      const res = await api(ctx, `/projects/${projectId}/images/understand`, {
+      const res = await api(ctx, `/v1/projects/${projectId}/images/understand`, {
         method: "POST",
         body: { source, query: args[0], task: opts.task }
       });
@@ -8332,7 +8842,7 @@ function registerVideo(program3) {
     action(async ({ ctx, opts, args }) => {
       const projectId = requireProject(ctx);
       const source = await resolveMediaSource({ url: opts.url, file: opts.file });
-      const res = await api(ctx, `/projects/${projectId}/video/understand`, {
+      const res = await api(ctx, `/v1/projects/${projectId}/video/understand`, {
         method: "POST",
         body: { source, query: args[0], task: opts.task }
       });
@@ -8352,7 +8862,7 @@ function registerAudio(program3) {
     action(async ({ ctx, opts, args }) => {
       const projectId = requireProject(ctx);
       const source = await resolveMediaSource({ url: opts.url, file: opts.file });
-      const res = await api(ctx, `/projects/${projectId}/audio/understand`, {
+      const res = await api(ctx, `/v1/projects/${projectId}/audio/understand`, {
         method: "POST",
         body: { source, query: args[0], task: opts.task }
       });
@@ -8362,7 +8872,7 @@ function registerAudio(program3) {
 }
 
 // src/commands/ask.ts
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors28 = __toESM(require_picocolors(), 1);
 var TYPES = [
   "input",
   "choice",
@@ -8440,7 +8950,7 @@ function registerAsk(program3) {
           code: "bad_request"
         });
       }
-      info(import_picocolors27.default.dim("Waiting for the user to answer\u2026"));
+      info(import_picocolors28.default.dim("Waiting for the user to answer\u2026"));
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}/ask`, {
         body: {
           type,
@@ -8468,12 +8978,12 @@ function deriveTitle(message) {
 function printAnswer(res) {
   if (!res) return;
   if (res.status === "answered") {
-    line(`  ${import_picocolors27.default.green("answered")}`);
+    line(`  ${import_picocolors28.default.green("answered")}`);
     const value = extract(res.response);
     if (value) line(`  ${value}`);
     return;
   }
-  line(`  ${import_picocolors27.default.yellow(res.status)}  ${import_picocolors27.default.dim(res.reason ?? "")}`);
+  line(`  ${import_picocolors28.default.yellow(res.status)}  ${import_picocolors28.default.dim(res.reason ?? "")}`);
 }
 function extract(response) {
   if (response == null) return "";
@@ -8492,7 +9002,7 @@ function extract(response) {
 }
 
 // src/commands/search.ts
-var import_picocolors28 = __toESM(require_picocolors(), 1);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
 function registerSearch(program3) {
   program3.command("search <query>").description("Search the web (Google-grounded, server-side)").option("-n, --max-results <n>", "max results", "5").action(
     action(async ({ ctx, args, opts }) => {
@@ -8505,9 +9015,9 @@ function registerSearch(program3) {
           line("");
         }
         const results = res?.results ?? [];
-        if (!results.length) return line(import_picocolors28.default.dim("No results."));
+        if (!results.length) return line(import_picocolors29.default.dim("No results."));
         for (const r of results) {
-          line(`${r.title || import_picocolors28.default.dim("(untitled)")}  ${import_picocolors28.default.dim(r.url)}`);
+          line(`${r.title || import_picocolors29.default.dim("(untitled)")}  ${import_picocolors29.default.dim(r.url)}`);
         }
       });
     })
@@ -8515,7 +9025,7 @@ function registerSearch(program3) {
 }
 
 // src/commands/board.ts
-var import_picocolors29 = __toESM(require_picocolors(), 1);
+var import_picocolors30 = __toESM(require_picocolors(), 1);
 
 // src/commands/record-step.ts
 async function recordEntityStep(ctx, opts) {
@@ -8554,7 +9064,7 @@ function registerBoard(program3) {
       }
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors29.default.dim("No cards on the Board yet."));
+          line(import_picocolors30.default.dim("No cards on the Board yet."));
           return;
         }
         for (const r of rows) line(formatRow(r));
@@ -8569,7 +9079,7 @@ function registerBoard(program3) {
         `/v1/projects/${projectId}/work-items/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors29.default.bold(row.title)}  ${import_picocolors29.default.dim(row.id)}`);
+        line(`${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.id)}`);
         line(`${statusTag(row.status)}  priority ${row.priority}`);
         if (row.ownerHuman) line(`owner: ${row.ownerHuman}`);
         if (row.labels?.length) line(`labels: ${row.labels.join(", ")}`);
@@ -8610,7 +9120,7 @@ ${row.description}`);
         refId: row?.id,
         output: { workItem: row }
       });
-      ok(row, () => line(`Created work item ${import_picocolors29.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created work item ${import_picocolors30.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   board.command("update <id>").description("Change fields on a card \u2014 pass only what changes").option("--title <text>", "new title").option("--description <text>", "new description").option("--status <value>", STATUSES.join(" | ")).option("--priority <value>", PRIORITIES.join(" | ")).option(
@@ -8644,7 +9154,7 @@ ${row.description}`);
         );
       }
       const row = await patchItem(ctx, projectId, String(args[0]), body);
-      ok(row, () => line(`Updated ${import_picocolors29.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
+      ok(row, () => line(`Updated ${import_picocolors30.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
     })
   );
   board.command("move <id> <status>").description(
@@ -8655,14 +9165,14 @@ ${row.description}`);
       const status = String(args[1]);
       assertStatus(status);
       const row = await patchItem(ctx, projectId, String(args[0]), { status });
-      ok(row, () => line(`Moved ${import_picocolors29.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
+      ok(row, () => line(`Moved ${import_picocolors30.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
     })
   );
   board.command("close <id>").description("Shorthand for `board move <id> done`").action(
     action(async ({ ctx, args }) => {
       const projectId = requireProject(ctx);
       const row = await patchItem(ctx, projectId, String(args[0]), { status: "done" });
-      ok(row, () => line(`Closed ${import_picocolors29.default.bold(row.title)} ${statusTag(row.status)}`));
+      ok(row, () => line(`Closed ${import_picocolors30.default.bold(row.title)} ${statusTag(row.status)}`));
     })
   );
 }
@@ -8695,23 +9205,23 @@ function assertPriority(value) {
   }
 }
 function formatRow(r) {
-  const labels = r.labels?.length ? import_picocolors29.default.dim(` [${r.labels.join(", ")}]`) : "";
-  const owner = r.ownerHuman ? import_picocolors29.default.dim(` @${r.ownerHuman}`) : "";
-  return `${import_picocolors29.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
+  const labels = r.labels?.length ? import_picocolors30.default.dim(` [${r.labels.join(", ")}]`) : "";
+  const owner = r.ownerHuman ? import_picocolors30.default.dim(` @${r.ownerHuman}`) : "";
+  return `${import_picocolors30.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
 }
 function statusTag(status) {
   const label = status.padEnd(11);
-  if (status === "done") return import_picocolors29.default.green(label);
-  if (status === "in-progress") return import_picocolors29.default.yellow(label);
-  if (status === "in-review") return import_picocolors29.default.cyan(label);
-  return import_picocolors29.default.dim(label);
+  if (status === "done") return import_picocolors30.default.green(label);
+  if (status === "in-progress") return import_picocolors30.default.yellow(label);
+  if (status === "in-review") return import_picocolors30.default.cyan(label);
+  return import_picocolors30.default.dim(label);
 }
 function collect2(value, previous) {
   return [...previous, value];
 }
 
 // src/commands/task.ts
-var import_picocolors30 = __toESM(require_picocolors(), 1);
+var import_picocolors31 = __toESM(require_picocolors(), 1);
 
 // src/subtask-attachments.ts
 var MAX_REF_NOTE = 500;
@@ -8773,6 +9283,7 @@ var STATUSES2 = [
 ];
 var PRIORITIES2 = ["urgent", "high", "normal", "low"];
 var SIZES = ["small", "standard"];
+var ESTIMATES = ["10m", "30m", "45m", "1h", "1h+"];
 var ROLES = [
   "pm",
   "architect",
@@ -8825,7 +9336,7 @@ function registerTask(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors30.default.dim("No tasks on the board yet."));
+          line(import_picocolors31.default.dim("No tasks on the board yet."));
           return;
         }
         for (const r of rows) line(formatRow2(r));
@@ -8855,6 +9366,9 @@ function registerTask(program3) {
   ).option("--priority <value>", `how urgent (${PRIORITIES2.join(" | ")})`).option(
     "--size <value>",
     `small lets the channel start it without asking; standard asks (${SIZES.join(" | ")})`
+  ).option(
+    "--estimate <value>",
+    `roughly how long this should take, shown on the plan (${ESTIMATES.join(" | ")})`
   ).option(
     "--status <value>",
     `start it somewhere other than 'todo' \u2014 use 'backlog' for a later phase's work (${STATUSES2.join(" | ")})`
@@ -8865,6 +9379,8 @@ function registerTask(program3) {
       if (opts.priority !== void 0)
         assertOneOf("--priority", opts.priority, PRIORITIES2);
       if (opts.size !== void 0) assertOneOf("--size", opts.size, SIZES);
+      if (opts.estimate !== void 0)
+        assertOneOf("--estimate", opts.estimate, ESTIMATES);
       if (opts.status !== void 0)
         assertOneOf("--status", opts.status, STATUSES2);
       const hasChannelOrigin = Boolean(
@@ -8882,6 +9398,7 @@ function registerTask(program3) {
           phase: opts.phase,
           priority: opts.priority,
           size: opts.size,
+          estimate: opts.estimate,
           // `backlog` for a later phase's work: written down so the owner can
           // read the whole plan, with nothing for the runner to pick up.
           status: opts.status,
@@ -8934,10 +9451,10 @@ function registerTask(program3) {
       };
       ok(result, () => {
         line(
-          `${import_picocolors30.default.green("opened")} ${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.key ?? row.id)}`
+          `${import_picocolors31.default.green("opened")} ${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`
         );
         if (channelMessage)
-          line(import_picocolors30.default.dim("posted to the channel as Project Manager"));
+          line(import_picocolors31.default.dim("posted to the channel as Project Manager"));
         if (channelMessageError) {
           warn(
             `Task opened, but its Project Manager card could not be posted: ${channelMessageError.message}`
@@ -9016,12 +9533,12 @@ function registerTask(program3) {
       ) : null;
       ok(runner ?? row, () => {
         line(
-          `${import_picocolors30.default.green("added")} ${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.key ?? row.id)}`
+          `${import_picocolors31.default.green("added")} ${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`
         );
-        if (row.role) line(import_picocolors30.default.dim(`role: ${row.role}`));
+        if (row.role) line(import_picocolors31.default.dim(`role: ${row.role}`));
         if (runner) {
           line(
-            import_picocolors30.default.dim(
+            import_picocolors31.default.dim(
               `runs on: ${[opts.agent, opts.model, opts.effort].filter(Boolean).join(" \xB7 ")}`
             )
           );
@@ -9039,7 +9556,7 @@ function registerTask(program3) {
       const rows = row.subtasks ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors30.default.dim("No subtasks yet."));
+          line(import_picocolors31.default.dim("No subtasks yet."));
           return;
         }
         rows.forEach((r, i) => line(formatSubtask(r, i + 1)));
@@ -9087,7 +9604,7 @@ function registerTask(program3) {
           }
         }
       );
-      ok(row, () => line(`${import_picocolors30.default.green("updated")} ${import_picocolors30.default.bold(row.title)}`));
+      ok(row, () => line(`${import_picocolors31.default.green("updated")} ${import_picocolors31.default.bold(row.title)}`));
     })
   );
   subtask.command("remove <id>").description("Remove a subtask (only before the work starts)").action(
@@ -9095,7 +9612,7 @@ function registerTask(program3) {
       await api(ctx, `/v1/project-tasks/${encodeURIComponent(args[0])}`, {
         method: "DELETE"
       });
-      ok({ removed: args[0] }, () => line(import_picocolors30.default.green("removed")));
+      ok({ removed: args[0] }, () => line(import_picocolors31.default.green("removed")));
     })
   );
   task.command("move <id> <status>").description(
@@ -9110,7 +9627,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors30.default.green("moved")} ${import_picocolors30.default.bold(row.title)} \u2192 ${args[1]}`)
+        () => line(`${import_picocolors31.default.green("moved")} ${import_picocolors31.default.bold(row.title)} \u2192 ${args[1]}`)
       );
     })
   );
@@ -9126,18 +9643,18 @@ function registerTask(program3) {
       );
       ok(row, () => {
         if (!row?.queued) {
-          line(import_picocolors30.default.yellow("could not resume it \u2014 check the step id"));
+          line(import_picocolors31.default.yellow("could not resume it \u2014 check the step id"));
           return;
         }
         const started = row.started ?? 0;
         if (started > 0) {
           line(
-            `${import_picocolors30.default.green("resumed")} \u2014 ${started} step${started === 1 ? "" : "s"} started`
+            `${import_picocolors31.default.green("resumed")} \u2014 ${started} step${started === 1 ? "" : "s"} started`
           );
           return;
         }
         line(
-          `${import_picocolors30.default.green("resumed")} \u2014 it is queued, but nothing started yet. Check the plan is approved and that no step is blocking the rest.`
+          `${import_picocolors31.default.green("resumed")} \u2014 it is queued, but nothing started yet. Check the plan is approved and that no step is blocking the rest.`
         );
       });
     })
@@ -9151,11 +9668,11 @@ function registerTask(program3) {
       );
       ok(row, () => {
         if (row?.reopened) {
-          line(`${import_picocolors30.default.green("sent back")} \u2014 it will be picked up again`);
+          line(`${import_picocolors31.default.green("sent back")} \u2014 it will be picked up again`);
           return;
         }
         line(
-          import_picocolors30.default.yellow(
+          import_picocolors31.default.yellow(
             row?.reason === "already_open" ? "already waiting to be picked up \u2014 nothing to send back" : row?.reason === "still_working" ? "still working \u2014 let it finish before sending it back" : "could not send that step back"
           )
         );
@@ -9172,7 +9689,7 @@ function registerTask(program3) {
         `/v1/project-tasks/${encodeURIComponent(id)}/dispatch-check`,
         { method: "POST" }
       );
-      ok(row, () => line(import_picocolors30.default.green("approved \u2014 you may start")));
+      ok(row, () => line(import_picocolors31.default.green("approved \u2014 you may start")));
     })
   );
   task.command("start [id]").description(
@@ -9187,13 +9704,13 @@ function registerTask(program3) {
         const started = row?.started ?? null;
         if (started && started > 0) {
           line(
-            import_picocolors30.default.green(
+            import_picocolors31.default.green(
               `started ${started} step${started === 1 ? "" : "s"} \u2014 they are running now`
             )
           );
           return;
         }
-        line(import_picocolors30.default.yellow(row?.note ?? "Nothing started."));
+        line(import_picocolors31.default.yellow(row?.note ?? "Nothing started."));
       });
     })
   );
@@ -9208,7 +9725,7 @@ function registerTask(program3) {
         );
         ok({ awaiting: row2.approval_state === "awaiting", task: row2 }, () => {
           line(
-            row2.approval_state === "awaiting" ? import_picocolors30.default.yellow(
+            row2.approval_state === "awaiting" ? import_picocolors31.default.yellow(
               "The plan is waiting on the owner. They see it in the task."
             ) : `Already ${row2.approval_state}.`
           );
@@ -9233,7 +9750,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors30.default.green(row.approval_state)} ${import_picocolors30.default.bold(row.title)}`)
+        () => line(`${import_picocolors31.default.green(row.approval_state)} ${import_picocolors31.default.bold(row.title)}`)
       );
     })
   );
@@ -9249,7 +9766,7 @@ function registerTask(program3) {
         `/v1/project-tasks/${encodeURIComponent(id)}/move`,
         { body: { status: "ready" } }
       );
-      ok(row, () => line(`${import_picocolors30.default.green("ready")} ${import_picocolors30.default.bold(row.title)}`));
+      ok(row, () => line(`${import_picocolors31.default.green("ready")} ${import_picocolors31.default.bold(row.title)}`));
     })
   );
 }
@@ -9294,24 +9811,24 @@ function assertOneOf(flag, value, allowed) {
   }
 }
 function formatRow2(r) {
-  const key = import_picocolors30.default.dim((r.key ?? r.id.slice(0, 8)).padEnd(10));
-  const steps = r.subtaskTotal ? import_picocolors30.default.dim(` ${r.subtaskDone}/${r.subtaskTotal}`) : "";
-  const gate = r.approval_state === "awaiting" ? import_picocolors30.default.yellow(" awaiting approval") : "";
+  const key = import_picocolors31.default.dim((r.key ?? r.id.slice(0, 8)).padEnd(10));
+  const steps = r.subtaskTotal ? import_picocolors31.default.dim(` ${r.subtaskDone}/${r.subtaskTotal}`) : "";
+  const gate = r.approval_state === "awaiting" ? import_picocolors31.default.yellow(" awaiting approval") : "";
   return `${key} ${statusTag2(r.status)} ${r.title}${steps}${gate}`;
 }
 function formatSubtask(r, index) {
-  const n = import_picocolors30.default.dim(String(index).padStart(2, "0"));
-  const role = r.role ? import_picocolors30.default.dim(` [${r.role}]`) : "";
-  const scope = r.scope_paths?.length ? import_picocolors30.default.dim(`  owns: ${r.scope_paths.join(", ")}`) : "";
+  const n = import_picocolors31.default.dim(String(index).padStart(2, "0"));
+  const role = r.role ? import_picocolors31.default.dim(` [${r.role}]`) : "";
+  const scope = r.scope_paths?.length ? import_picocolors31.default.dim(`  owns: ${r.scope_paths.join(", ")}`) : "";
   const head = `${n} ${statusTag2(r.status)} ${r.title}${role}${scope}`;
   const summary = (r.result_summary ?? "").trim();
   if (!summary) return head;
   const wrapped = summary.split("\n").map((l) => `      ${l}`).join("\n");
   return `${head}
-${import_picocolors30.default.dim(wrapped)}`;
+${import_picocolors31.default.dim(wrapped)}`;
 }
 function printTask(row, goal) {
-  line(`${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.key ?? row.id)}`);
+  line(`${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`);
   line(`${statusTag2(row.status)}  approval: ${row.approval_state}`);
   if (row.summary) line(`
 ${row.summary}`);
@@ -9324,53 +9841,53 @@ touches: ${row.targets.map((t) => t.appName ?? t.ref ?? t.kind).join(", ")}`
   }
   if (row.subtasks?.length) {
     line(`
-${import_picocolors30.default.bold("subtasks")}`);
+${import_picocolors31.default.bold("subtasks")}`);
     row.subtasks.forEach((s, i) => line(formatSubtask(s, i + 1)));
     line(
-      import_picocolors30.default.dim(
+      import_picocolors31.default.dim(
         `
 Run \`workser artifact list\` to see what these subtasks produced,`
       )
     );
     line(
-      import_picocolors30.default.dim(
+      import_picocolors31.default.dim(
         `or \`workser artifact list --step <id>\` for one subtask's output alone.`
       )
     );
   } else {
-    line(import_picocolors30.default.dim("\nNo subtasks yet."));
+    line(import_picocolors31.default.dim("\nNo subtasks yet."));
   }
 }
 function printGoalContext(row, goal) {
   const mine = row.phase ?? null;
   line(`
-${import_picocolors30.default.bold("part of")}: ${goal.title}`);
-  if (goal.outcome) line(import_picocolors30.default.dim(`done means: ${goal.outcome}`));
+${import_picocolors31.default.bold("part of")}: ${goal.title}`);
+  if (goal.outcome) line(import_picocolors31.default.dim(`done means: ${goal.outcome}`));
   const progress = goal.progress ?? [];
   for (const p of progress) {
     const where = p.total === 0 ? "not started" : `${p.done} of ${p.total} done`;
-    const here = mine && p.name === mine ? import_picocolors30.default.cyan("  <- this task") : "";
-    const mark = p.state === "done" ? import_picocolors30.default.green("*") : import_picocolors30.default.dim("-");
+    const here = mine && p.name === mine ? import_picocolors31.default.cyan("  <- this task") : "";
+    const mark = p.state === "done" ? import_picocolors31.default.green("*") : import_picocolors31.default.dim("-");
     line(`  ${mark} ${p.name} \u2014 ${where}${here}`);
   }
   const next = progress.find((p) => p.state !== "done");
   const running = progress.some((p) => p.state === "working");
   if (next && !running) {
     line(
-      import_picocolors30.default.dim(
+      import_picocolors31.default.dim(
         `
 Nothing is running. The next part waiting is "${next.name}" \u2014 offer it to them in a sentence rather than starting it unasked.`
       )
     );
   } else if (!next) {
     line(
-      import_picocolors30.default.dim(
+      import_picocolors31.default.dim(
         "\nEvery part of this plan is done. Say so, and offer to wrap it up."
       )
     );
   }
   line(
-    import_picocolors30.default.dim(
+    import_picocolors31.default.dim(
       "The plan is a reference for what was agreed, not a rule about what may run. Work can start on any part at any time if they ask for it."
     )
   );
@@ -9378,22 +9895,22 @@ Nothing is running. The next part waiting is "${next.name}" \u2014 offer it to t
 function statusTag2(status) {
   switch (status) {
     case "ready":
-      return import_picocolors30.default.green("[ready]");
+      return import_picocolors31.default.green("[ready]");
     case "working":
-      return import_picocolors30.default.blue("[working]");
+      return import_picocolors31.default.blue("[working]");
     case "checking":
-      return import_picocolors30.default.cyan("[checking]");
+      return import_picocolors31.default.cyan("[checking]");
     case "accepted":
-      return import_picocolors30.default.green("[accepted]");
+      return import_picocolors31.default.green("[accepted]");
     case "archived":
-      return import_picocolors30.default.dim("[archived]");
+      return import_picocolors31.default.dim("[archived]");
     default:
-      return import_picocolors30.default.dim("[todo]");
+      return import_picocolors31.default.dim("[todo]");
   }
 }
 
 // src/commands/goal.ts
-var import_picocolors31 = __toESM(require_picocolors(), 1);
+var import_picocolors32 = __toESM(require_picocolors(), 1);
 var STATUSES3 = ["proposed", "agreed", "working", "delivered", "abandoned"];
 function registerGoal(program3) {
   const goal = program3.command("goal").description("Business goals and the phases that deliver them");
@@ -9405,7 +9922,7 @@ function registerGoal(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors31.default.dim("No goals yet \u2014 every task here stands on its own."));
+          line(import_picocolors32.default.dim("No goals yet \u2014 every task here stands on its own."));
           return;
         }
         for (const g of rows) line(formatGoal(g));
@@ -9482,10 +9999,10 @@ function registerGoal(program3) {
         }
       });
       ok(row, () => {
-        success(`Proposed ${import_picocolors31.default.bold(row?.title ?? "goal")}`);
+        success(`Proposed ${import_picocolors32.default.bold(row?.title ?? "goal")}`);
         printGoal(row);
         line(
-          import_picocolors31.default.dim(
+          import_picocolors32.default.dim(
             "\nNothing has been created yet. The owner agrees the shape first."
           )
         );
@@ -9514,7 +10031,7 @@ function registerGoal(program3) {
       ok(
         row,
         () => line(
-          row?.recorded ? met === true ? import_picocolors31.default.green("recorded \u2014 met") : met === false ? import_picocolors31.default.yellow("recorded \u2014 not met") : import_picocolors31.default.dim("recorded \u2014 back to unchecked") : import_picocolors31.default.yellow(
+          row?.recorded ? met === true ? import_picocolors32.default.green("recorded \u2014 met") : met === false ? import_picocolors32.default.yellow("recorded \u2014 not met") : import_picocolors32.default.dim("recorded \u2014 back to unchecked") : import_picocolors32.default.yellow(
             "couldn't record it \u2014 check the goal id, the phase name and the criterion id"
           )
         )
@@ -9557,7 +10074,7 @@ function registerGoal(program3) {
       }
       ok({ goalId, phase, filed }, () => {
         success(
-          `Filed ${filed.length} ${filed.length === 1 ? "task" : "tasks"} under ${import_picocolors31.default.bold(phase)}`
+          `Filed ${filed.length} ${filed.length === 1 ? "task" : "tasks"} under ${import_picocolors32.default.bold(phase)}`
         );
       });
     })
@@ -9589,42 +10106,42 @@ function registerGoal(program3) {
 function appScope(g) {
   const n = g.appIds?.length ?? 0;
   if (!n) return "";
-  return import_picocolors31.default.dim(`  ${n} part${n === 1 ? "" : "s"} of the system`);
+  return import_picocolors32.default.dim(`  ${n} part${n === 1 ? "" : "s"} of the system`);
 }
 function formatGoal(g) {
-  const where = g.currentPhase && g.status !== "delivered" ? import_picocolors31.default.dim(`  now: ${g.currentPhase}`) : "";
-  const count = g.taskTotal != null ? import_picocolors31.default.dim(`  ${g.taskDone}/${g.taskTotal} done`) : "";
-  return `${statusTag3(g.status)} ${g.title}${appScope(g)}${where}${count}  ${import_picocolors31.default.dim(g.id)}`;
+  const where = g.currentPhase && g.status !== "delivered" ? import_picocolors32.default.dim(`  now: ${g.currentPhase}`) : "";
+  const count = g.taskTotal != null ? import_picocolors32.default.dim(`  ${g.taskDone}/${g.taskTotal} done`) : "";
+  return `${statusTag3(g.status)} ${g.title}${appScope(g)}${where}${count}  ${import_picocolors32.default.dim(g.id)}`;
 }
 function printGoal(g) {
   if (!g) return;
-  line(`${import_picocolors31.default.bold(g.title)}  ${import_picocolors31.default.dim(g.id)}`);
+  line(`${import_picocolors32.default.bold(g.title)}  ${import_picocolors32.default.dim(g.id)}`);
   line(statusTag3(g.status));
   if (g.outcome) line(`
 done means: ${g.outcome}`);
   const progress = g.progress ?? [];
   if (!progress.length) {
-    line(import_picocolors31.default.dim("\nNo phases agreed yet."));
+    line(import_picocolors32.default.dim("\nNo phases agreed yet."));
     return;
   }
   line(`
-${import_picocolors31.default.bold("phases")}`);
+${import_picocolors32.default.bold("phases")}`);
   for (const p of progress) {
-    const bar2 = p.total > 0 ? `${p.done}/${p.total} done` : import_picocolors31.default.dim("nothing filed yet");
-    const mark = p.state === "done" ? import_picocolors31.default.green("done") : p.state === "working" ? import_picocolors31.default.blue("working") : import_picocolors31.default.dim("waiting");
+    const bar2 = p.total > 0 ? `${p.done}/${p.total} done` : import_picocolors32.default.dim("nothing filed yet");
+    const mark = p.state === "done" ? import_picocolors32.default.green("done") : p.state === "working" ? import_picocolors32.default.blue("working") : import_picocolors32.default.dim("waiting");
     line(
-      `  ${import_picocolors31.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors31.default.dim(bar2)}`
+      `  ${import_picocolors32.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors32.default.dim(bar2)}`
     );
     for (const c of p.criteria ?? []) {
-      const tick = c.met === true ? import_picocolors31.default.green("\u2713") : c.met === false ? import_picocolors31.default.red("\u2717") : import_picocolors31.default.dim("\xB7");
-      line(`       ${tick} ${c.text}  ${import_picocolors31.default.dim(c.id)}`);
-      if (c.note) line(import_picocolors31.default.dim(`         ${c.note}`));
+      const tick = c.met === true ? import_picocolors32.default.green("\u2713") : c.met === false ? import_picocolors32.default.red("\u2717") : import_picocolors32.default.dim("\xB7");
+      line(`       ${tick} ${c.text}  ${import_picocolors32.default.dim(c.id)}`);
+      if (c.note) line(import_picocolors32.default.dim(`         ${c.note}`));
     }
   }
   const current = progress.find((p) => p.name === g.currentPhase);
   if (current) {
     line(
-      import_picocolors31.default.dim(
+      import_picocolors32.default.dim(
         `
 ${current.name} \u2014 ${current.done} of ${current.total} done (phase ${current.index} of ${progress.length}).`
       )
@@ -9634,15 +10151,15 @@ ${current.name} \u2014 ${current.done} of ${current.total} done (phase ${current
 function statusTag3(status) {
   switch (status) {
     case "agreed":
-      return import_picocolors31.default.cyan("[agreed]");
+      return import_picocolors32.default.cyan("[agreed]");
     case "working":
-      return import_picocolors31.default.blue("[working]");
+      return import_picocolors32.default.blue("[working]");
     case "delivered":
-      return import_picocolors31.default.green("[delivered]");
+      return import_picocolors32.default.green("[delivered]");
     case "abandoned":
-      return import_picocolors31.default.dim("[abandoned]");
+      return import_picocolors32.default.dim("[abandoned]");
     default:
-      return import_picocolors31.default.yellow("[proposed]");
+      return import_picocolors32.default.yellow("[proposed]");
   }
 }
 
@@ -9826,7 +10343,7 @@ function stripLeadingGlobalOptions(argv) {
 }
 
 // src/commands/decision.ts
-var import_picocolors32 = __toESM(require_picocolors(), 1);
+var import_picocolors33 = __toESM(require_picocolors(), 1);
 function registerDecision(program3) {
   const decision = program3.command("decision").description("Read and record the project's architecture decisions");
   decision.command("list").description("Every decision on record \u2014 read this before changing how something works").option("--limit <n>", "cap the number returned (newest first)").action(
@@ -9839,11 +10356,11 @@ function registerDecision(program3) {
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors32.default.dim("No decisions recorded yet."));
+          line(import_picocolors33.default.dim("No decisions recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors32.default.dim(r.id)}  ${import_picocolors32.default.dim(shortDate(r.createdAt))}  ${r.title}`);
+          line(`${import_picocolors33.default.dim(r.id)}  ${import_picocolors33.default.dim(shortDate(r.createdAt))}  ${r.title}`);
           line(`    ${truncate(r.decision, 100)}`);
         }
       });
@@ -9857,16 +10374,16 @@ function registerDecision(program3) {
         `/v1/projects/${projectId}/architecture-decisions/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.id)}`);
-        line(import_picocolors32.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
+        line(import_picocolors33.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
-${import_picocolors32.default.bold("Context")}
+${import_picocolors33.default.bold("Context")}
 ${row.context}`);
         line(`
-${import_picocolors32.default.bold("Decision")}
+${import_picocolors33.default.bold("Decision")}
 ${row.decision}`);
         if (row.consequences) line(`
-${import_picocolors32.default.bold("Consequences")}
+${import_picocolors33.default.bold("Consequences")}
 ${row.consequences}`);
       });
     })
@@ -9895,7 +10412,7 @@ ${row.consequences}`);
         refId: row?.id,
         output: { decision: row }
       });
-      ok(row, () => line(`Recorded decision ${import_picocolors32.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded decision ${import_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   const requirement = program3.command("requirement").description("Read and record the project's requirements");
@@ -9907,11 +10424,11 @@ ${row.consequences}`);
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors32.default.dim("No requirements recorded yet."));
+          line(import_picocolors33.default.dim("No requirements recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors32.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
+          line(`${import_picocolors33.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
         }
       });
     })
@@ -9924,8 +10441,8 @@ ${row.consequences}`);
         `/v1/projects/${projectId}/requirements/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.id)}`);
-        line(import_picocolors32.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
+        line(import_picocolors33.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
 ${row.body}`);
       });
@@ -9951,7 +10468,7 @@ ${row.body}`);
         refId: row?.id,
         output: { requirement: row }
       });
-      ok(row, () => line(`Recorded requirement ${import_picocolors32.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded requirement ${import_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   requirement.command("update <id>").description(
@@ -9980,7 +10497,7 @@ ${row.body}`);
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated requirement ${import_picocolors32.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
+      ok(row, () => line(`Updated requirement ${import_picocolors33.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
     })
   );
 }
@@ -10003,7 +10520,7 @@ function shortDate(iso) {
 }
 
 // src/commands/doc.ts
-var import_picocolors33 = __toESM(require_picocolors(), 1);
+var import_picocolors34 = __toESM(require_picocolors(), 1);
 
 // src/mermaid-fences.ts
 function hasDiagram(code) {
@@ -10048,13 +10565,13 @@ function registerDoc(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors33.default.dim("No documents yet."));
+          line(import_picocolors34.default.dim("No documents yet."));
           return;
         }
         for (const r of rows) {
-          const link = r.workItemId ? import_picocolors33.default.dim(` \u21B3 ${r.workItemId}`) : "";
-          const file = r.filePath ? import_picocolors33.default.dim(`  ${r.filePath}`) : "";
-          line(`${import_picocolors33.default.dim(r.id)}  ${r.title}${link}${file}`);
+          const link = r.workItemId ? import_picocolors34.default.dim(` \u21B3 ${r.workItemId}`) : "";
+          const file = r.filePath ? import_picocolors34.default.dim(`  ${r.filePath}`) : "";
+          line(`${import_picocolors34.default.dim(r.id)}  ${r.title}${link}${file}`);
         }
       });
     })
@@ -10068,17 +10585,17 @@ function registerDoc(program3) {
       );
       if (opts.markdown) {
         ok({ id: row.id, title: row.title, filePath: row.filePath }, () => {
-          line(`${import_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
+          line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
           line(
-            row.filePath ? `Read it at ${import_picocolors33.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors33.default.dim("This document has no markdown mirror on disk yet.")
+            row.filePath ? `Read it at ${import_picocolors34.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors34.default.dim("This document has no markdown mirror on disk yet.")
           );
         });
         return;
       }
       ok(row, () => {
-        line(`${import_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
-        if (row.workItemId) line(import_picocolors33.default.dim(`linked to work item ${row.workItemId}`));
-        if (row.filePath) line(import_picocolors33.default.dim(`markdown mirror: ${row.filePath}`));
+        line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
+        if (row.workItemId) line(import_picocolors34.default.dim(`linked to work item ${row.workItemId}`));
+        if (row.filePath) line(import_picocolors34.default.dim(`markdown mirror: ${row.filePath}`));
         line("");
         line(row.contentJson);
       });
@@ -10107,7 +10624,7 @@ function registerDoc(program3) {
         refId: row?.id,
         output: { document: row }
       });
-      ok(row, () => line(`Created document ${import_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created document ${import_picocolors34.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   doc.command("diagram <id>").description(
@@ -10133,19 +10650,19 @@ function registerDoc(program3) {
         diagrams: diagrams.map((code) => ({ kind: diagramKind(code), code }))
       };
       ok(payload, () => {
-        line(`${import_picocolors33.default.bold(row.title)}  ${import_picocolors33.default.dim(row.id)}`);
+        line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
         if (markdown === null) {
           line(
-            import_picocolors33.default.dim(
+            import_picocolors34.default.dim(
               row.filePath ? `Could not read ${row.filePath} from this folder.` : "This document has no markdown mirror on disk yet."
             )
           );
         } else if (!diagrams.length) {
-          line(import_picocolors33.default.dim("No diagrams in this document."));
+          line(import_picocolors34.default.dim("No diagrams in this document."));
         } else {
           for (const [i, code] of diagrams.entries()) {
             const kind = diagramKind(code) ?? "diagram";
-            line(`${import_picocolors33.default.dim(String(i + 1))}  ${kind}  ${import_picocolors33.default.dim(`${code.split("\n").length} lines`)}`);
+            line(`${import_picocolors34.default.dim(String(i + 1))}  ${kind}  ${import_picocolors34.default.dim(`${code.split("\n").length} lines`)}`);
           }
         }
       });
@@ -10181,7 +10698,7 @@ function registerDoc(program3) {
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated document ${import_picocolors33.default.bold(row.id)} \u2014 ${row.title}`));
+      ok(row, () => line(`Updated document ${import_picocolors34.default.bold(row.id)} \u2014 ${row.title}`));
     })
   );
 }
@@ -10195,9 +10712,9 @@ function readMirror(cwd, filePath) {
 }
 
 // src/commands/design.ts
-var import_picocolors34 = __toESM(require_picocolors(), 1);
+var import_picocolors35 = __toESM(require_picocolors(), 1);
 function registerDesign(program3) {
-  const design = program3.command("design").description("Read the project's brand (colours, fonts, logo)");
+  const design = program3.command("design").description("The project's brand, and pictures of the screens you draw");
   design.command("show").description("Show this project's brand \u2014 read it before writing any UI").option("--raw", "print the generated token files verbatim instead of a summary").action(
     action(async ({ ctx, opts }) => {
       const projectId = requireProject(ctx);
@@ -10209,11 +10726,11 @@ function registerDesign(program3) {
       if (opts.raw) {
         ok(files, () => {
           if (!files.length) {
-            line(import_picocolors34.default.dim("No brand set for this project."));
+            line(import_picocolors35.default.dim("No brand set for this project."));
             return;
           }
           for (const f of files) {
-            line(import_picocolors34.default.bold(f.path));
+            line(import_picocolors35.default.bold(f.path));
             line(f.contents);
             line("");
           }
@@ -10230,27 +10747,62 @@ function registerDesign(program3) {
       } : { hasBrand: false, colors: {}, fonts: {}, brand: {}, files: [] };
       ok(summary, () => {
         if (!tokens) {
-          line(import_picocolors34.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
+          line(import_picocolors35.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
           return;
         }
         for (const [name, value] of Object.entries(tokens.brand)) {
-          line(`${import_picocolors34.default.dim(name.padEnd(12))} ${value}`);
+          line(`${import_picocolors35.default.dim(name.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.color)) {
-          line(`${import_picocolors34.default.dim(`color.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors35.default.dim(`color.${name}`.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.font)) {
-          line(`${import_picocolors34.default.dim(`font.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors35.default.dim(`font.${name}`.padEnd(12))} ${value}`);
         }
         line("");
         line(
-          import_picocolors34.default.dim(
+          import_picocolors35.default.dim(
             `Generated into the working tree as ${files.map((f) => f.path).join(", ")} \u2014 wire those in, never edit them.`
           )
         );
       });
     })
   );
+  design.command("shot").argument("<files...>", "the HTML screens to photograph, relative to the project folder").description("Render a design screen to a PNG beside it, for surfaces that can't run a page").option("--width <px>", "artboard width (default 1440)", (v) => Number(v)).option("--height <px>", "artboard height (default 900)", (v) => Number(v)).action(
+    action(async ({ ctx, args, opts }) => {
+      const projectId = requireProject(ctx);
+      const res = await api(ctx, "/v1/design-shot", {
+        method: "POST",
+        body: {
+          projectId,
+          files: args,
+          width: opts.width,
+          height: opts.height
+        }
+      });
+      ok(res, () => {
+        for (const shot of res.shots ?? []) {
+          if (shot.out) {
+            line(`${import_picocolors35.default.green("\u2713")} ${shot.file} ${import_picocolors35.default.dim("\u2192")} ${shot.out}`);
+          } else {
+            line(`${import_picocolors35.default.red("\u2717")} ${shot.file} ${import_picocolors35.default.dim(shot.error ?? "no image")}`);
+          }
+        }
+        for (const path of res.refused ?? []) {
+          line(import_picocolors35.default.dim(`skipped ${path} \u2014 not a page inside this project`));
+        }
+        const made = (res.shots ?? []).filter((s) => s.out).length;
+        if (made) {
+          line("");
+          line(
+            import_picocolors35.default.dim(
+              `Record each one so it shows up: workser artifact add <file>.png --kind design -d "<what this screen is>"`
+            )
+          );
+        }
+      });
+    })
+  );
 }
 function parseTokens(files) {
   const doc = files.find((f) => f.path.endsWith("tokens.json"));
@@ -10275,7 +10827,7 @@ function unwrap(group) {
 }
 
 // src/commands/api.ts
-var import_picocolors35 = __toESM(require_picocolors(), 1);
+var import_picocolors36 = __toESM(require_picocolors(), 1);
 import { readdirSync, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { join as join3, relative, sep } from "path";
 
@@ -10389,10 +10941,10 @@ function registerApi(program3) {
       const appId = requireApp2(opts.app);
       const res = await api(ctx, `/v1/apps/${encodeURIComponent(appId)}/api/requests`);
       ok(res, () => {
-        for (const note of res?.notes ?? []) line(import_picocolors35.default.dim(note));
+        for (const note of res?.notes ?? []) line(import_picocolors36.default.dim(note));
         for (const r of res?.requests ?? []) {
           line(
-            `${import_picocolors35.default.dim(r.method.padEnd(6))}${r.path}${r.note ? import_picocolors35.default.dim(`  ${r.note}`) : ""}`
+            `${import_picocolors36.default.dim(r.method.padEnd(6))}${r.path}${r.note ? import_picocolors36.default.dim(`  ${r.note}`) : ""}`
           );
         }
       });
@@ -10426,14 +10978,14 @@ function registerApi(program3) {
       );
       ok(res, () => {
         if (!res?.ok) {
-          line(import_picocolors35.default.red(res?.error ?? "The service did not answer."));
+          line(import_picocolors36.default.red(res?.error ?? "The service did not answer."));
           return;
         }
         const code = `${res.status}${res.statusText ? ` ${res.statusText}` : ""}`;
-        const colour2 = res.status && res.status < 300 ? import_picocolors35.default.green : res.status && res.status < 500 ? import_picocolors35.default.yellow : import_picocolors35.default.red;
-        line(`${colour2(code)}  ${import_picocolors35.default.dim(`${res.durationMs}ms  ${res.url}`)}`);
+        const colour2 = res.status && res.status < 300 ? import_picocolors36.default.green : res.status && res.status < 500 ? import_picocolors36.default.yellow : import_picocolors36.default.red;
+        line(`${colour2(code)}  ${import_picocolors36.default.dim(`${res.durationMs}ms  ${res.url}`)}`);
         if (res.body) line(res.body);
-        if (res.truncated) line(import_picocolors35.default.dim("(answer truncated)"));
+        if (res.truncated) line(import_picocolors36.default.dim("(answer truncated)"));
       });
       if (!res?.ok) process.exitCode = 1;
     })
@@ -10453,15 +11005,15 @@ function registerApi(program3) {
         for (const r of report.routes) {
           const known = report.missing.some((m) => m.path === r.path);
           line(
-            `${known ? import_picocolors35.default.yellow("undocumented") : import_picocolors35.default.green("documented  ")}  ${r.path}${import_picocolors35.default.dim(`  ${r.file}`)}`
+            `${known ? import_picocolors36.default.yellow("undocumented") : import_picocolors36.default.green("documented  ")}  ${r.path}${import_picocolors36.default.dim(`  ${r.file}`)}`
           );
         }
         for (const p of report.stale) {
-          line(`${import_picocolors35.default.dim("in spec only ")}  ${p}`);
+          line(`${import_picocolors36.default.dim("in spec only ")}  ${p}`);
         }
         line("");
         if (report.ok && specFile) success(summary);
-        else line(import_picocolors35.default.yellow(summary));
+        else line(import_picocolors36.default.yellow(summary));
       });
       if (opts.check && !report.ok) {
         throw new WorkserError(summary, { code: "bad_request" });
@@ -10532,7 +11084,7 @@ function listRepoFiles(root, maxDepth = 8) {
 }
 
 // src/commands/analysis.ts
-var import_picocolors36 = __toESM(require_picocolors(), 1);
+var import_picocolors37 = __toESM(require_picocolors(), 1);
 import { readFileSync as readFileSync4 } from "fs";
 function registerAnalysis(program3) {
   const cmd = program3.command("analysis").description("Run Python analysis locally, recorded in the task");
@@ -10542,14 +11094,14 @@ function registerAnalysis(program3) {
       const res = await api(ctx, path);
       ok(res, () => {
         line(
-          `${res?.available ? import_picocolors36.default.green("python") : import_picocolors36.default.red("python")}  ${res?.version ?? "not found"}  ${import_picocolors36.default.dim(res?.python ?? "")}`
+          `${res?.available ? import_picocolors37.default.green("python") : import_picocolors37.default.red("python")}  ${res?.version ?? "not found"}  ${import_picocolors37.default.dim(res?.python ?? "")}`
         );
         for (const lib of res?.libraries ?? []) {
           line(
-            `${lib.present ? import_picocolors36.default.green(lib.name) : import_picocolors36.default.yellow(lib.name)}${import_picocolors36.default.dim(lib.present ? "" : "  missing")}`
+            `${lib.present ? import_picocolors37.default.green(lib.name) : import_picocolors37.default.yellow(lib.name)}${import_picocolors37.default.dim(lib.present ? "" : "  missing")}`
           );
         }
-        for (const note of res?.notes ?? []) line(import_picocolors36.default.dim(note));
+        for (const note of res?.notes ?? []) line(import_picocolors37.default.dim(note));
       });
       if (!res?.available) process.exitCode = 1;
     })
@@ -10571,15 +11123,15 @@ function registerAnalysis(program3) {
       );
       ok(res, () => {
         if (res?.stdout) line(res.stdout.replace(/\n$/, ""));
-        if (res?.stderr) line(import_picocolors36.default.dim(res.stderr.replace(/\n$/, "")));
-        if (res?.truncated) line(import_picocolors36.default.dim("(output truncated)"));
+        if (res?.stderr) line(import_picocolors37.default.dim(res.stderr.replace(/\n$/, "")));
+        if (res?.truncated) line(import_picocolors37.default.dim("(output truncated)"));
         const took = `${Math.round((res?.durationMs ?? 0) / 100) / 10}s`;
         line(
-          res?.ok ? import_picocolors36.default.green(`\u2713 ${res.summary ?? "It finished."}`) + import_picocolors36.default.dim(`  ${took}`) : import_picocolors36.default.yellow(res?.summary ?? "It did not finish.") + import_picocolors36.default.dim(`  ${took}`)
+          res?.ok ? import_picocolors37.default.green(`\u2713 ${res.summary ?? "It finished."}`) + import_picocolors37.default.dim(`  ${took}`) : import_picocolors37.default.yellow(res?.summary ?? "It did not finish.") + import_picocolors37.default.dim(`  ${took}`)
         );
         if (res && !res.sandboxed) {
           line(
-            import_picocolors36.default.dim(
+            import_picocolors37.default.dim(
               "This platform has no OS sandbox, so the script ran with your own file access."
             )
           );
@@ -10607,7 +11159,7 @@ function readCode(file, inline) {
 }
 
 // src/commands/scan.ts
-var import_picocolors37 = __toESM(require_picocolors(), 1);
+var import_picocolors38 = __toESM(require_picocolors(), 1);
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync3, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync3 } from "fs";
 import { join as join4, relative as relative2, sep as sep2 } from "path";
@@ -10891,22 +11443,22 @@ function runPermissions(cwd, findings, checked, skipped) {
 }
 function print2(report, summary) {
   for (const s of report.skipped) {
-    line(`${import_picocolors37.default.yellow("not checked")}  ${s.check}${import_picocolors37.default.dim(` \u2014 ${s.reason}`)}`);
+    line(`${import_picocolors38.default.yellow("not checked")}  ${s.check}${import_picocolors38.default.dim(` \u2014 ${s.reason}`)}`);
   }
   for (const f of report.findings) {
-    const where = f.file ? import_picocolors37.default.dim(`  ${f.file}${f.line ? `:${f.line}` : ""}`) : "";
+    const where = f.file ? import_picocolors38.default.dim(`  ${f.file}${f.line ? `:${f.line}` : ""}`) : "";
     line(`${severityTag(f.severity)}  ${f.title}${where}`);
-    line(`             ${import_picocolors37.default.dim(f.fix)}`);
+    line(`             ${import_picocolors38.default.dim(f.fix)}`);
   }
   if (report.findings.length || report.skipped.length) line("");
   if (report.ok && !report.skipped.length) success(summary);
-  else if (report.ok) line(import_picocolors37.default.yellow(summary));
-  else line(import_picocolors37.default.red(summary));
+  else if (report.ok) line(import_picocolors38.default.yellow(summary));
+  else line(import_picocolors38.default.red(summary));
 }
 function severityTag(severity) {
-  if (severity === "high") return import_picocolors37.default.red("serious    ");
-  if (severity === "medium") return import_picocolors37.default.yellow("worth fixing");
-  return import_picocolors37.default.dim("minor      ");
+  if (severity === "high") return import_picocolors38.default.red("serious    ");
+  if (severity === "medium") return import_picocolors38.default.yellow("worth fixing");
+  return import_picocolors38.default.dim("minor      ");
 }
 function git(cwd, args) {
   try {
@@ -10967,7 +11519,7 @@ function listRepoFiles2(root, maxDepth = 8) {
 }
 
 // src/commands/health.ts
-var import_picocolors38 = __toESM(require_picocolors(), 1);
+var import_picocolors39 = __toESM(require_picocolors(), 1);
 function registerHealth(program3) {
   program3.command("health").description("Check that the published apps in this project are still answering").option("--app <webAppId>", "check one app rather than all of them").action(
     action(async ({ ctx, opts }) => {
@@ -10981,16 +11533,16 @@ function registerHealth(program3) {
 }
 function print3(res) {
   if (!res?.checks?.length) {
-    line(import_picocolors38.default.dim(res?.note ?? "Nothing to check."));
+    line(import_picocolors39.default.dim(res?.note ?? "Nothing to check."));
     return;
   }
   for (const c of res.checks) {
-    const mark = c.ok ? import_picocolors38.default.green("up  ") : import_picocolors38.default.red("down");
-    const timing = import_picocolors38.default.dim(`${c.ms}ms`);
-    const detail = c.ok ? timing : import_picocolors38.default.dim(`${c.error ?? "no answer"}${c.failures > 1 ? ` \xB7 ${c.failures} in a row` : ""}`);
-    line(`  ${mark}  ${c.appName} ${import_picocolors38.default.dim(`(${c.environment})`)}  ${c.url}  ${detail}`);
+    const mark = c.ok ? import_picocolors39.default.green("up  ") : import_picocolors39.default.red("down");
+    const timing = import_picocolors39.default.dim(`${c.ms}ms`);
+    const detail = c.ok ? timing : import_picocolors39.default.dim(`${c.error ?? "no answer"}${c.failures > 1 ? ` \xB7 ${c.failures} in a row` : ""}`);
+    line(`  ${mark}  ${c.appName} ${import_picocolors39.default.dim(`(${c.environment})`)}  ${c.url}  ${detail}`);
     if (c.incidentOpened) {
-      line(import_picocolors38.default.yellow(`        An incident has been opened on the board for this.`));
+      line(import_picocolors39.default.yellow(`        An incident has been opened on the board for this.`));
     }
   }
   const down = res.checks.filter((c) => !c.ok);
@@ -11003,14 +11555,14 @@ function print3(res) {
   }
   const production = down.filter((c) => c.environment === "production").length;
   line(
-    import_picocolors38.default.red(
+    import_picocolors39.default.red(
       `${down.length} of ${res.checks.length} not answering` + (production ? ` \u2014 ${production} customer-facing.` : " (preview only).")
     )
   );
 }
 
 // src/commands/urls.ts
-var import_picocolors39 = __toESM(require_picocolors(), 1);
+var import_picocolors40 = __toESM(require_picocolors(), 1);
 function registerUrls(program3) {
   program3.command("urls").description("The stable preview and production addresses of every app in this project").option("--app <webAppId>", "just one app").action(
     action(async ({ ctx, opts }) => {
@@ -11024,20 +11576,20 @@ function registerUrls(program3) {
       const summary = urlsSummary(rows);
       ok({ rows, summary }, () => {
         for (const row of rows) {
-          const label = import_picocolors39.default.dim(row.environment.padEnd(10));
-          const value = row.url ? import_picocolors39.default.cyan(row.url) : import_picocolors39.default.dim(row.note ?? "not published");
+          const label = import_picocolors40.default.dim(row.environment.padEnd(10));
+          const value = row.url ? import_picocolors40.default.cyan(row.url) : import_picocolors40.default.dim(row.note ?? "not published");
           line(`  ${row.appName.padEnd(22)} ${label} ${value}`);
         }
         line("");
         if (rows.some((r) => r.url)) success(summary);
-        else line(import_picocolors39.default.yellow(summary));
+        else line(import_picocolors40.default.yellow(summary));
       });
     })
   );
 }
 
 // src/commands/deployments.ts
-var import_picocolors40 = __toESM(require_picocolors(), 1);
+var import_picocolors41 = __toESM(require_picocolors(), 1);
 function registerDeployments(program3) {
   const cmd = program3.command("deployments").description("Deployment history, and putting a build in front of customers");
   cmd.command("list").description("What has been built, newest first").option("--app <webAppId>", "just one app (default: every app in the project)").option("--env <environment>", "preview or production").option("--limit <n>", "how many to show", "20").action(
@@ -11055,7 +11607,7 @@ function registerDeployments(program3) {
       ok(res, () => {
         if (!items.length) {
           return line(
-            import_picocolors40.default.dim(
+            import_picocolors41.default.dim(
               environment ? `Nothing has been deployed to ${environment} yet.` : "Nothing has been deployed yet. `workser deploy` builds the first one."
             )
           );
@@ -11075,13 +11627,13 @@ function registerDeployments(program3) {
       ).catch(() => null) : null;
       ok({ ...dep, logs }, () => {
         line(formatDeployment(dep));
-        if (dep?.error_message) line(import_picocolors40.default.red(`  ${dep.error_message}`));
+        if (dep?.error_message) line(import_picocolors41.default.red(`  ${dep.error_message}`));
         const events = logs?.events ?? [];
         for (const e of events) {
-          line(`  ${import_picocolors40.default.dim(String(e.type ?? "log"))}  ${e.text ?? ""}`);
+          line(`  ${import_picocolors41.default.dim(String(e.type ?? "log"))}  ${e.text ?? ""}`);
         }
         if (opts.logs && !events.length) {
-          line(import_picocolors40.default.dim("  That build produced no output."));
+          line(import_picocolors41.default.dim("  That build produced no output."));
         }
       });
     })
@@ -11125,16 +11677,16 @@ function printPromoted(res, version) {
   const what = version === null ? "the latest build" : `version ${version}`;
   const url = res.url ?? res.vercel_url;
   success(`Production is being rebuilt from ${what}.`);
-  if (url) line(import_picocolors40.default.dim(`It will be at ${url}`));
-  line(import_picocolors40.default.dim("`workser deploy status` follows it."));
+  if (url) line(import_picocolors41.default.dim(`It will be at ${url}`));
+  line(import_picocolors41.default.dim("`workser deploy status` follows it."));
 }
 function formatDeployment(d) {
   if (!d) return "";
-  const version = d.version !== void 0 ? import_picocolors40.default.yellow(`v${d.version}`) : import_picocolors40.default.dim("v?");
-  const env = import_picocolors40.default.dim((d.environment ?? "?").padEnd(10));
+  const version = d.version !== void 0 ? import_picocolors41.default.yellow(`v${d.version}`) : import_picocolors41.default.dim("v?");
+  const env = import_picocolors41.default.dim((d.environment ?? "?").padEnd(10));
   const app = d.webAppName ? `${d.webAppName}  ` : "";
-  const when = import_picocolors40.default.dim(formatTime2(d.created_at));
-  const url = d.url ? "  " + import_picocolors40.default.cyan(d.url) : "";
+  const when = import_picocolors41.default.dim(formatTime2(d.created_at));
+  const url = d.url ? "  " + import_picocolors41.default.cyan(d.url) : "";
   return `${version}  ${env} ${colorStatus(d.status ?? "")}  ${app}${when}${url}`;
 }
 function formatTime2(t) {
@@ -11144,7 +11696,7 @@ function formatTime2(t) {
 }
 
 // src/commands/usage.ts
-var import_picocolors41 = __toESM(require_picocolors(), 1);
+var import_picocolors42 = __toESM(require_picocolors(), 1);
 
 // src/usage.ts
 var NEAR_LIMIT_FRACTION = 0.8;
@@ -11239,7 +11791,7 @@ function registerUsage(program3) {
 function print4(report) {
   const dims = report.dimensions ?? [];
   if (!dims.length) {
-    return line(import_picocolors41.default.dim("Nothing to measure for this project yet."));
+    return line(import_picocolors42.default.dim("Nothing to measure for this project yet."));
   }
   const width = Math.max(...dims.map((d) => d.label.length));
   for (const d of dims) {
@@ -11248,23 +11800,23 @@ function print4(report) {
   line("");
   const summary = usageSummary(report);
   const worst = dims.map(usageState);
-  if (worst.includes("over")) line(import_picocolors41.default.red(summary));
+  if (worst.includes("over")) line(import_picocolors42.default.red(summary));
   else if (worst.includes("near") || worst.includes("unknown"))
-    line(import_picocolors41.default.yellow(summary));
+    line(import_picocolors42.default.yellow(summary));
   else success(summary);
 }
 function gauge(d, _labelWidth) {
   const drawn = bar(d);
-  return drawn ? `  ${import_picocolors41.default.dim(drawn)}` : "";
+  return drawn ? `  ${import_picocolors42.default.dim(drawn)}` : "";
 }
 function colour(d) {
   switch (usageState(d)) {
     case "over":
-      return d.kind === "hard" ? import_picocolors41.default.red : import_picocolors41.default.yellow;
+      return d.kind === "hard" ? import_picocolors42.default.red : import_picocolors42.default.yellow;
     case "near":
-      return import_picocolors41.default.yellow;
+      return import_picocolors42.default.yellow;
     case "unknown":
-      return import_picocolors41.default.dim;
+      return import_picocolors42.default.dim;
     default:
       return (s) => s;
   }
@@ -11272,7 +11824,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.16" : "0.0.0-dev"
+  version: true ? "0.6.17" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(
@@ -11305,6 +11857,7 @@ registerDomain(program2);
 registerOpen(program2);
 registerDoctor(program2);
 registerAgent(program2);
+registerAgentCloud(program2);
 registerVerify(program2);
 registerApi(program2);
 registerAnalysis(program2);