@workser/cli 0.6.15 → 0.6.17

package/dist/index.js

@@ -3743,6 +3743,27 @@ 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:
@@ -8336,7 +8357,7 @@ function registerMemory(program3) {
         const results = res?.results ?? res ?? [];
         if (!results?.length) return line(import_picocolors24.default.dim("No matching memories."));
         for (const r of results) {
-          line(`${import_picocolors24.default.dim(r.id ?? "?")}  ${r.memory ?? r.content ?? ""}`);
+          line(`${import_picocolors24.default.dim(r.id ?? "?")}  ${memoryText(r)}`);
         }
       });
     })
@@ -8351,6 +8372,13 @@ function registerMemory(program3) {
     })
   );
 }
+function memoryText(r) {
+  const text = r?.memory ?? r?.chunk ?? r?.content ?? r?.text;
+  if (typeof text === "string" && text.trim()) return text;
+  const title = r?.documents?.[0]?.title;
+  if (typeof title === "string" && title.trim()) return title;
+  return import_picocolors24.default.dim("(no readable text on this row)");
+}
 
 // src/commands/note.ts
 var import_picocolors25 = __toESM(require_picocolors(), 1);
@@ -8741,7 +8769,7 @@ function registerImage(program3) {
       );
       const res = await api(
         ctx,
-        `/projects/${projectId}/images/generate`,
+        `/v1/projects/${projectId}/images/generate`,
         {
           method: "POST",
           body: {
@@ -8781,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 }
       });
@@ -8814,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 }
       });
@@ -8834,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 }
       });
@@ -9255,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",
@@ -9337,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(" | ")})`
@@ -9347,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(
@@ -9364,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,
@@ -10679,7 +10714,7 @@ function readMirror(cwd, filePath) {
 // src/commands/design.ts
 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);
@@ -10733,6 +10768,41 @@ function registerDesign(program3) {
       });
     })
   );
+  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"));
@@ -11754,7 +11824,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.15" : "0.0.0-dev"
+  version: true ? "0.6.17" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workser/cli",
-  "version": "0.6.15",
+  "version": "0.6.17",
   "description": "Workser CLI — give your local AI agent native DevOps & infrastructure on Workser. The agent runs `workser …` to provision, deploy, and manage real apps.",
   "license": "MIT",
   "type": "module",

package/skills/workser/reference/agent-cloud.md

@@ -79,6 +79,27 @@ 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 — 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 — 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 — 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: