@workser/cli 0.6.17 → 0.6.19

package/dist/index.js

@@ -3663,6 +3663,88 @@ var import_picocolors2 = __toESM(require_picocolors(), 1);
 
 // src/help-content.ts
 var HELP_TOPICS = [
+  {
+    topic: "agent-cloud-media",
+    title: "Pictures, voice, video \u2014 and calling a model without an agent",
+    summary: "What an Agent Cloud agent can make and read, plus one-shot model calls from the app's own code.",
+    commands: ["agent-cloud"],
+    source: "skills/workser/reference/agent-cloud-media.md",
+    body: `# Pictures, voice, video \u2014 and calling a model without an agent
+
+### Models that are not chat models
+
+\`models\` used to list chat models and nothing else \u2014 not by choice, but
+because the catalogue threw every other kind away before anyone could ask for
+one. It no longer does:
+
+\`\`\`
+workser agent-cloud models --kind image          # models that draw
+workser agent-cloud models --kind video
+workser agent-cloud models --kind speech         # text in, a voice out
+workser agent-cloud models --kind transcription  # a voice in, text out
+workser agent-cloud models --kind embedding      # for search by meaning
+workser agent-cloud models --accepts image       # chat models that see photos
+\`\`\`
+
+Prices are shown in the unit the model is SOLD in \u2014 \`4.6 credits each\` for a
+picture, \`credits/1M\` for words. A picture quoted per million would be out by
+six orders of magnitude.
+
+\`default_model\` must stay a **chat model**. It is what the agent thinks with;
+setting it to an image model publishes an agent that never answers anybody.
+The other kinds are reached through abilities, below.
+
+## What the agent can make, and what it can read
+
+These are abilities on the agent, not models you set:
+
+| Ability | The agent gains |
+| --- | --- |
+| \`media_generation.image\` | \`generate_image\` \u2014 answer with a picture, art for a post |
+| \`media_generation.audio.speech\` | \`generate_speech\` \u2014 reply in voice |
+| \`media_generation.audio.sound_effects\` | \`generate_sound_effect\` |
+| \`media_generation.audio.music\` | \`generate_music\` \u2014 a background track |
+| \`media_generation.video\` | \`generate_video\` \u2014 short clips |
+| \`perception.image\` | \`describe_image\` \u2014 read a photo a customer sent |
+| \`perception.video\` | \`describe_video\` |
+| \`perception.audio\` | \`transcribe_audio\` \u2014 a voice note becomes text |
+
+Turn on only what the job needs. **Video costs an order of magnitude more than
+everything else here**, and it is refused outright on a deployment where an
+operator has not priced it \u2014 that refusal is a configuration fact, not the
+user's mistake, so relay it rather than retrying.
+
+Everything these produce comes back as a **URL in the project's storage**, so
+it can go straight into a reply, a post, or the next tool.
+
+## When the app itself needs a model, not an agent
+
+An agent is a sandbox, a tool loop, and minutes of metered runtime. Most of
+what an app needs a model for is one call that takes a second: a product
+description, a thumbnail, a spoken confirmation, search that understands
+meaning. Starting an agent for those is the wrong shape and the wrong price.
+
+Use \`@workser/app\` in the app's own code:
+
+\`\`\`ts
+import { workser } from '@workser/app';
+
+const blurb  = await workser.ai.text('Write a 40-word description of ' + name);
+const art    = await workser.ai.image('product photo of ' + name);
+const audio  = await workser.ai.speech('Your order is confirmed.');
+const vector = await workser.ai.embed(descriptions);   // many in one call
+for await (const word of workser.ai.stream(question)) process.stdout.write(word);
+\`\`\`
+
+Nobody holds a provider key: Workser's own credential is used and the
+organisation's credit ledger is charged, the same wallet an agent run draws on.
+It needs no setup in a Workser-deployed app \u2014 the two environment variables are
+injected at provisioning.
+
+**The rule:** one answer goes to \`workser.ai\`; work that takes minutes and uses
+tools goes to an agent.
+`
+  },
   {
     topic: "agent-cloud",
     title: "Ship an agent inside the app",
@@ -3743,6 +3825,11 @@ 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.
 
+\`default_model\` must stay a **chat model** \u2014 setting it to an image model
+publishes an agent that never answers anybody. Pictures, video, voice and
+transcription are abilities, not models you set, and one call from the app's
+own code needs no agent at all: \`workser help agent-cloud-media\`.
+
 ## Agents need a paid plan \u2014 the trial does not include them
 
 \`create\` and \`run\` both refuse with **402** on a free or trialling
@@ -3750,9 +3837,9 @@ 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.
+files the refusal on the conversation as a clickable step and artifact, so the
+person gets something actionable. Say what you were doing, that agents need a
+plan, and stop.
 
 Do NOT:
 
@@ -7898,21 +7985,37 @@ function registerAgentCloud(program3) {
       });
     })
   );
-  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(
+  cloud.command("models").description("Models this organisation can run an agent on, cheapest first").option("--all", "Include models that need your own provider key").option(
+    "--kind <kind>",
+    "text | image | video | speech | transcription | embedding (comma-separated)"
+  ).option("--accepts <inputs>", "Only models that can read this: image, audio, video, file").action(
     action(async ({ ctx, opts }) => {
-      const res = await api(ctx, "/v1/agent-cloud/catalog/models/live");
+      const q = new URLSearchParams();
+      if (opts.kind) q.set("kind", String(opts.kind));
+      if (opts.accepts) q.set("accepts", String(opts.accepts));
+      if (opts.kind && !String(opts.kind).split(",").includes("text")) {
+        q.set("tools_only", "false");
+      }
+      const suffix = q.toString() ? `?${q.toString()}` : "";
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/catalog/models/gateways${suffix}`
+      );
       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.");
+          warn(
+            opts.kind ? `No ${opts.kind} models are available on your credits. Try --all.` : "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 price = m.price_unit === "each" ? typeof m.credits_each === "number" ? `${m.credits_each} credits each` : "price unknown" : 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}`);
+          const kind = m.kind && m.kind !== "text" ? import_picocolors17.default.dim(`  [${m.kind}]`) : "";
+          line(`${import_picocolors17.default.bold(m.model ?? m.id)}${kind}  ${import_picocolors17.default.dim(price)}${byok}`);
         }
       });
     })
@@ -9912,6 +10015,7 @@ function statusTag2(status) {
 // src/commands/goal.ts
 var import_picocolors32 = __toESM(require_picocolors(), 1);
 var STATUSES3 = ["proposed", "agreed", "working", "delivered", "abandoned"];
+var PACES = ["slice", "phase", "all"];
 function registerGoal(program3) {
   const goal = program3.command("goal").description("Business goals and the phases that deliver them");
   goal.command("list").description("What this project is working towards").action(
@@ -9949,6 +10053,9 @@ function registerGoal(program3) {
   ).option(
     "--criteria <json>",
     `what "done" means per phase, in the OWNER's words: '{"Checkout":["A customer can pay by card and gets a receipt"]}'`
+  ).option(
+    "--pace <value>",
+    `how much to do before checking in \u2014 slice (one task, then show), phase (the current phase, the default), all (${PACES.join(" | ")})`
   ).action(
     action(async ({ ctx, args, opts }) => {
       requireProject(ctx);
@@ -9981,11 +10088,17 @@ function registerGoal(program3) {
           );
         }
       }
+      if (opts.pace !== void 0 && !PACES.includes(opts.pace)) {
+        throw new WorkserError(
+          `Unknown --pace "${opts.pace}". Use one of: ${PACES.join(", ")}.`
+        );
+      }
       const row = await api(ctx, "/v1/project-goals", {
         body: {
           projectId: ctx.projectId,
           title: args[0],
           outcome: opts.outcome,
+          pace: opts.pace,
           phases: phases.map((name) => ({
             name,
             criteria: (criteria[name] ?? []).map((text, i) => ({
@@ -10079,13 +10192,18 @@ function registerGoal(program3) {
       });
     })
   );
-  goal.command("update <id>").description("Change the shape, or move the goal along").option("--title <text>", "the owner's words for what they want").option("--outcome <text>", "what 'done' means").option("--phase <name...>", "replace the ordered phase list").option("--status <value>", `one of: ${STATUSES3.join(" | ")}`).action(
+  goal.command("update <id>").description("Change the shape, or move the goal along").option("--title <text>", "the owner's words for what they want").option("--outcome <text>", "what 'done' means").option("--phase <name...>", "replace the ordered phase list").option("--status <value>", `one of: ${STATUSES3.join(" | ")}`).option("--pace <value>", `how much to do before checking in (${PACES.join(" | ")})`).action(
     action(async ({ ctx, args, opts }) => {
       if (opts.status && !STATUSES3.includes(opts.status)) {
         throw new WorkserError(
           `Unknown status "${opts.status}". Use one of: ${STATUSES3.join(", ")}.`
         );
       }
+      if (opts.pace && !PACES.includes(opts.pace)) {
+        throw new WorkserError(
+          `Unknown --pace "${opts.pace}". Use one of: ${PACES.join(", ")}.`
+        );
+      }
       const row = await api(
         ctx,
         `/v1/project-goals/${encodeURIComponent(String(args[0]))}`,
@@ -10095,7 +10213,8 @@ function registerGoal(program3) {
             title: opts.title,
             outcome: opts.outcome,
             phases: opts.phase,
-            status: opts.status
+            status: opts.status,
+            pace: opts.pace
           }
         }
       );
@@ -10119,6 +10238,7 @@ function printGoal(g) {
   line(statusTag3(g.status));
   if (g.outcome) line(`
 done means: ${g.outcome}`);
+  if (g.pace) line(import_picocolors32.default.dim(`pace: ${paceLine(g.pace)}`));
   const progress = g.progress ?? [];
   if (!progress.length) {
     line(import_picocolors32.default.dim("\nNo phases agreed yet."));
@@ -10162,6 +10282,11 @@ function statusTag3(status) {
       return import_picocolors32.default.yellow("[proposed]");
   }
 }
+function paceLine(pace) {
+  if (pace === "slice") return "slice \u2014 do ONE task, then stop and show the owner";
+  if (pace === "all") return "all \u2014 work through the phases; report at the end";
+  return "phase \u2014 the current phase, task by task";
+}
 
 // src/role-guard.ts
 var READS = [
@@ -11824,7 +11949,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.17" : "0.0.0-dev"
+  version: true ? "0.6.19" : "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.17",
+  "version": "0.6.19",
   "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-media.md

@@ -0,0 +1,81 @@
+---
+topic: agent-cloud-media
+title: Pictures, voice, video — and calling a model without an agent
+summary: What an Agent Cloud agent can make and read, plus one-shot model calls from the app's own code.
+commands: [agent-cloud]
+---
+
+# Pictures, voice, video — and calling a model without an agent
+
+### Models that are not chat models
+
+`models` used to list chat models and nothing else — not by choice, but
+because the catalogue threw every other kind away before anyone could ask for
+one. It no longer does:
+
+```
+workser agent-cloud models --kind image          # models that draw
+workser agent-cloud models --kind video
+workser agent-cloud models --kind speech         # text in, a voice out
+workser agent-cloud models --kind transcription  # a voice in, text out
+workser agent-cloud models --kind embedding      # for search by meaning
+workser agent-cloud models --accepts image       # chat models that see photos
+```
+
+Prices are shown in the unit the model is SOLD in — `4.6 credits each` for a
+picture, `credits/1M` for words. A picture quoted per million would be out by
+six orders of magnitude.
+
+`default_model` must stay a **chat model**. It is what the agent thinks with;
+setting it to an image model publishes an agent that never answers anybody.
+The other kinds are reached through abilities, below.
+
+## What the agent can make, and what it can read
+
+These are abilities on the agent, not models you set:
+
+| Ability | The agent gains |
+| --- | --- |
+| `media_generation.image` | `generate_image` — answer with a picture, art for a post |
+| `media_generation.audio.speech` | `generate_speech` — reply in voice |
+| `media_generation.audio.sound_effects` | `generate_sound_effect` |
+| `media_generation.audio.music` | `generate_music` — a background track |
+| `media_generation.video` | `generate_video` — short clips |
+| `perception.image` | `describe_image` — read a photo a customer sent |
+| `perception.video` | `describe_video` |
+| `perception.audio` | `transcribe_audio` — a voice note becomes text |
+
+Turn on only what the job needs. **Video costs an order of magnitude more than
+everything else here**, and it is refused outright on a deployment where an
+operator has not priced it — that refusal is a configuration fact, not the
+user's mistake, so relay it rather than retrying.
+
+Everything these produce comes back as a **URL in the project's storage**, so
+it can go straight into a reply, a post, or the next tool.
+
+## When the app itself needs a model, not an agent
+
+An agent is a sandbox, a tool loop, and minutes of metered runtime. Most of
+what an app needs a model for is one call that takes a second: a product
+description, a thumbnail, a spoken confirmation, search that understands
+meaning. Starting an agent for those is the wrong shape and the wrong price.
+
+Use `@workser/app` in the app's own code:
+
+```ts
+import { workser } from '@workser/app';
+
+const blurb  = await workser.ai.text('Write a 40-word description of ' + name);
+const art    = await workser.ai.image('product photo of ' + name);
+const audio  = await workser.ai.speech('Your order is confirmed.');
+const vector = await workser.ai.embed(descriptions);   // many in one call
+for await (const word of workser.ai.stream(question)) process.stdout.write(word);
+```
+
+Nobody holds a provider key: Workser's own credential is used and the
+organisation's credit ledger is charged, the same wallet an agent run draws on.
+It needs no setup in a Workser-deployed app — the two environment variables are
+injected at provisioning.
+
+**The rule:** one answer goes to `workser.ai`; work that takes minutes and uses
+tools goes to an agent.

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

@@ -79,6 +79,11 @@ 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.
 
+`default_model` must stay a **chat model** — setting it to an image model
+publishes an agent that never answers anybody. Pictures, video, voice and
+transcription are abilities, not models you set, and one call from the app's
+own code needs no agent at all: `workser help agent-cloud-media`.
+
 ## Agents need a paid plan — the trial does not include them
 
 `create` and `run` both refuse with **402** on a free or trialling
@@ -86,9 +91,9 @@ 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.
+files the refusal on the conversation as a clickable step and artifact, so the
+person gets something actionable. Say what you were doing, that agents need a
+plan, and stop.
 
 Do NOT: