@workser/cli 0.6.27 → 0.6.29

package/dist/index.js

@@ -3810,6 +3810,12 @@ 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 starts it until you give it a trigger
+
+A published agent runs when asked and at no other time. A time, a chat message
+or an app event is a **trigger**, and it works the moment it is saved \u2014 it is
+not part of the agent's version. \`workser help agent-triggers\`.
+
 ## Nothing takes effect until you publish
 
 **This is the step to not forget.** The runtime resolves the PUBLISHED version
@@ -3857,26 +3863,28 @@ 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
+## Every plan can use Agent Cloud \u2014 runs use credits
 
-\`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.
+Creating, teaching and publishing an agent are available on free, trial and paid
+plans. A \`try\` or live \`run\` spends real money on model usage and hosted runtime,
+so it starts only when the organisation's shared AI-credit wallet clears the
+minimum balance shown in the refusal.
 
-**When you hit it, hand the plan over \u2014 do not just describe it.** Workser
+**When you hit a 402, hand the credit top-up over \u2014 do not just describe it.** Workser
 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.
+person gets something actionable. Say what you were doing, that the wallet needs
+credits, and stop. The same rule applies when the owner supplies their own model
+key because the hosted runtime and fallback path still cost money.
 
 Do NOT:
 
-- retry the call, or try a different agent \u2014 the answer is the same
+- retry the call, or try a different agent \u2014 the wallet is shared
 - 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
+- guess at prices, discounts or free usage
 
 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.
+Agent Cloud usage view has the current figures. You do not have them.
 
 ## When to reach for this
 
@@ -3897,7 +3905,7 @@ workflow\`.
 ## If Agent Cloud is ruled out, there is an order
 
 Propose Agent Cloud first, every time. If it genuinely does not fit \u2014 the owner
-has said no to the plan, or wants their own code in their own framework \u2014 go
+does not want a managed runtime, or wants their own code in their own framework \u2014 go
 down this list in order, and say which rung you took and why you skipped the
 ones above it:
 
@@ -3952,15 +3960,86 @@ watching sees the agent think. See the \`workser-sdk\` skill, \`reference/agents
    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.
+3. **Every plan can run agents once the shared wallet has enough credits.** A
+   \`402\` with \`insufficient_credits\` needs a top-up; \`spend_limit_reached\` means
+   the owner reached the guard rail they set. Tell them exactly what it says and
+   hand over the matching action; never suggest a subscription upgrade.
 
 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: "agent-triggers",
+    title: "What starts an Agent Cloud agent",
+    summary: "Schedules, chat channels and app events \u2014 a trigger works the moment it is saved, unlike everything else on an agent.",
+    commands: [],
+    source: "skills/workser/reference/agent-triggers.md",
+    body: `# What starts an Agent Cloud agent
+
+A published agent runs when somebody asks it to and at no other time. A trigger
+is what makes it start on its own \u2014 a time, a chat message, or an event in a
+connected app.
+
+\`\`\`
+workser agent-cloud triggers <id>                       # what starts it today
+workser agent-cloud trigger-add <id> schedule cron="0 9 * * 1-5" name="Morning report"
+workser agent-cloud trigger-add <id> chat app_type=line
+workser agent-cloud trigger-add <id> app_event event_type=GMAIL_NEW_GMAIL_MESSAGE connected_account_id=<id>
+workser agent-cloud trigger-setup <id> <triggerId>      # the webhook URL to paste
+workser agent-cloud trigger-events <id>                 # what fired, and what it started
+workser agent-cloud trigger-remove <id> <triggerId>
+\`\`\`
+
+**A trigger works the moment it is saved** \u2014 unlike everything above, it is not
+part of the agent's version and does not wait for a publish.
+
+\`rule=\` is optional and is the FIRING rule, not the agent's instructions:
+\`rule="only when the message mentions an order"\`. Leave it empty on a chat
+channel and every message reaches the agent, which is what a support agent
+wants \u2014 the agent decides what to do with each one.
+
+For a chat trigger, **\`trigger-setup\` is not optional**: it returns the webhook
+URL to paste into LINE's or Slack's console, and it says whether anything has
+arrived yet. Without that step the trigger sits there looking finished and
+never receives anything.
+
+To let the agent ANSWER on that channel, the project also needs the account
+connected \u2014 \`workser line connect --token \u2026\`. See \`workser help chat-channels\`.
+
+## The two halves of a chat agent
+
+Receiving and answering are separate, and each has its own setup:
+
+| | What it does | How |
+| --- | --- | --- |
+| The trigger | a message STARTS the agent | \`trigger-add <id> chat app_type=line\`, then \`trigger-setup\` |
+| The connection | the agent can ANSWER | \`workser line connect --token \u2026\` |
+
+Do only the first and the agent listens and never speaks. Do only the second and
+nothing ever wakes it up.
+
+With both in place, a run started by a message is handed the reply token and the
+sender, and gets every operation of that account as a tool \u2014 \`line_reply\`,
+\`slack_send_message\` and the rest. Sends go through the agent's approval gate;
+reads do not.
+
+## Schedules, in plain words
+
+\`cron=\` takes a standard five-field expression. The four people ask for:
+
+\`\`\`
+cron="0 9 * * 1-5"    every weekday at 9am
+cron="0 9 * * *"      every day at 9am
+cron="0 * * * *"      every hour
+cron="0 9 * * 1"      every Monday at 9am
+\`\`\`
+
+\`timezone=\` defaults to UTC, which is almost never what somebody means by "9am".
+Set it: \`timezone="Asia/Bangkok"\`.
 `
   },
   {
@@ -4378,6 +4457,113 @@ copy is the current one.
 \`workser business\` is how **you** inspect and fix data while building. The app reads
 the same records at runtime through \`workser.business\` in \`@workser/app\` \u2014 see the
 \`workser-sdk\` skill. An app shelling out to this CLI per request is wrong.
+`
+  },
+  {
+    topic: "chat-channels",
+    title: "LINE, Telegram, Discord, Slack",
+    summary: "Connect a chat account once, then send, reply and read from the CLI or from an agent \u2014 LINE gets its whole Messaging API.",
+    commands: ["line", "telegram", "discord", "slack"],
+    source: "skills/workser/reference/chat-channels.md",
+    body: `# LINE, Telegram, Discord, Slack
+
+Connect the business's chat account to this project **once**. After that it is
+reachable from here, from Workser Code, and from any Agent Cloud agent in this
+project \u2014 including the one a chat message starts.
+
+Every provider takes the same six verbs:
+
+\`\`\`
+workser <provider> status                       # is anything connected?
+workser <provider> connect --token <token>
+workser <provider> verify                       # does the credential still work?
+workser <provider> disconnect
+workser <provider> ops [--group <name>]         # everything it can do
+workser <provider> call <operation> --params '<json>'
+\`\`\`
+
+where \`<provider>\` is \`line\`, \`telegram\`, \`discord\` or \`slack\`.
+
+## Getting the token
+
+| Provider | Where | Flag |
+| --- | --- | --- |
+| LINE | Developers console \u2192 Messaging API \u2192 Channel access token | \`--token\`, plus \`--secret\` for the channel secret |
+| Telegram | @BotFather \u2192 \`/newbot\` or \`/token\` | \`--token\` |
+| Discord | Developer Portal \u2192 your app \u2192 Bot \u2192 Reset Token | \`--token\` (the bot must also be invited to the server) |
+| Slack | Your app \u2192 OAuth & Permissions \u2192 Bot User OAuth Token (\`xoxb-\`) | \`--token\`, plus \`--signing-secret\` |
+
+\`connect\` calls the provider immediately to prove the credential works, so a
+mistyped token fails right there instead of an hour later as a customer message
+nobody answered.
+
+## \`call\` is the whole API
+
+\`ops\` prints every operation with a one-line summary. The \`\u25CF\` marks the ones
+that send something, spend quota, or change the account.
+
+\`\`\`
+workser line call push --params '{"to":"U4af\u2026","messages":[{"type":"text","text":"Your order shipped"}]}'
+workser line call richmenu_list
+workser telegram call send_chat_action --params '{"chat_id":123,"action":"typing"}'
+workser slack call list_conversations --params '{"types":"public_channel"}'
+workser discord call create_thread --params '{"channel_id":"\u2026","message_id":"\u2026","name":"Order #4021"}'
+\`\`\`
+
+Parameters are flat \u2014 path, query and body fields all go in \`--params\` together
+and the server sorts them. Fields it has never heard of are **forwarded
+untouched**, so a flex component or a Slack block the vendor shipped last week
+works today.
+
+## Shortcuts
+
+\`\`\`
+workser line send <to> "<text>" | reply <replyToken> "<text>" | broadcast "<text>"
+workser line quota | profile <userId>
+workser telegram send <chatId> "<text>"
+workser discord send <channelId> "<text>"
+workser slack send <channel> "<text>"
+\`\`\`
+
+## Reply beats push, on LINE
+
+\`reply\` uses the token that came with the incoming message. It is **free** and
+does not touch the monthly quota; \`push\` costs one message per recipient. The
+token is single-use and expires within a minute or so, so reply first and fall
+back to push.
+
+\`broadcast\` sends to every follower and spends one message each. On a large
+account that is the most expensive call available \u2014 say what it will cost
+before running it.
+
+## How complete each one is
+
+**LINE is the deep one** \u2014 its entire Messaging API, about seventy operations:
+messaging, rich menus, audiences and narrowcast, insight, quota, content,
+groups and rooms, and the webhook endpoint itself.
+
+**Telegram, Discord and Slack carry what a chat agent needs** \u2014 send, reply,
+edit, delete, react, typing indicator, threads and DMs, plus reading people and
+conversations. Not their whole APIs. \`ops\` is the truth; ask it rather than
+assuming an operation exists.
+
+## Rich menus, in order (LINE)
+
+A rich menu does nothing until it has both a picture and a place to appear:
+
+1. \`richmenu_create\` \u2014 the layout and tappable areas. Returns an id.
+2. \`richmenu_upload_image\` \u2014 \`content\` is the file **base64-encoded**, with
+   \`content_type\`. The image must match the declared size exactly.
+3. \`richmenu_set_default\` (everybody) or \`richmenu_link_user\` (one person).
+
+\`richmenu_validate\` checks a layout without creating it.
+
+## When it is an agent doing this
+
+An Agent Cloud agent in a project with a connected account gets these as tools
+automatically \u2014 there is nothing to bind, and no capability to switch on. Sends
+go through the agent's approval gate; reads do not. See
+\`workser help agent-cloud\`.
 `
   },
   {
@@ -5045,7 +5231,8 @@ that URL directly in the app.
 
 \`\`\`bash
 workser image generate "flat illustration of a farm delivery van, brand colors" --json
-workser image gen "same van, from the side" -r https://\u2026 -o ./public/van.png --json
+workser image gen "same van, from the side" -r https://\u2026 --json     # use .data.url
+workser image gen "van, rear view" -o /tmp/van.png --json           # only if you must
 \`\`\`
 
 ## Notes that matter (generation)
@@ -5056,6 +5243,16 @@ workser image gen "same van, from the side" -r https://\u2026 -o ./public/van.pn
   question comes back as text rather than an image. Check that you actually got an
   image before wiring the URL into a page; an empty result is not a transport error
   to retry.
+- **The URL is the deliverable \u2014 don't download it into the app folder.** This
+  example used to write to \`./public/van.png\`, which is the single most common way
+  generated art ends up committed to the user's repository: in every deploy bundle
+  for ever, unreplaceable without a redeploy, against a 25MB publish cap. The
+  returned URL is already public and already served. Reference it.
+
+  When a file genuinely has to exist \u2014 an asset the build reads, something to hand
+  the user \u2014 \`-o\` into a temp path and \`workser storage put\` it into the bucket
+  (or whatever store the owner chose; the repo is never it). See
+  \`reference/storage.md\`.
 - **\`--output\` writes only the first image.** If you asked for several, the rest
   exist only as URLs.
 - **Placeholder art is not a deliverable.** Generating a hero image to unblock a
@@ -5533,6 +5730,40 @@ workser storage put <local> <key>   # upload a file into the bucket
 workser storage get <key> [dest]    # download an object (or print its URL)
 \`\`\`
 
+## This is where media goes \u2014 the folder is for code
+
+Every project has this bucket, provisioned and paid for, served over a CDN, and
+visible to the owner on the Files screen. It is the **default** home for generated
+art, product photography, PDFs, exports, avatars and anything a user uploads.
+
+**Default, not mandate.** An owner who wants Cloudinary, their own S3, or anything
+else is entitled to it \u2014 build it and don't argue. What is not yours to do is pick
+the alternative for them, or drift into one because it was quicker. If you think
+there is a real reason to go outside, say so and let them answer, then
+\`workser decision create\` it so the next agent doesn't quietly reverse it.
+
+**The repo is not one of the options.** Whichever provider the owner chose, files
+under \`public/\`, \`assets/\` or \`static/\` cost them four things, none recoverable
+later:
+
+- **They are committed.** Publishing runs \`git add -A\` over the app folder, so
+  every image enters the repository's history. Deleting it afterwards does not
+  remove it.
+- **They ride in every deploy.** The source bundle has a 25MB cap; enough media
+  and publishing stops working outright, with an error about the bundle rather
+  than about the images.
+- **They cannot change without a redeploy.** A photo the owner wants swapped
+  becomes a code change and a build. From the bucket it is one \`storage put\`.
+- **They are invisible.** The Files screen lists the bucket. Nothing there shows
+  what is sitting in the repo, so the owner cannot find, replace or delete it.
+
+Small build-time assets \u2014 a logo, a favicon, an icon, an SVG the bundler inlines \u2014
+are the exception. Anything that is content, or that a user produced, is not.
+
+\`\`\`bash
+workser storage put ./out/hero.png products/hero.png --json   # \u2192 .data.url
+\`\`\`
+
 ## Notes that matter
 
 - **One bucket per project, shared by its apps.** Namespace your keys by app or
@@ -5542,7 +5773,9 @@ workser storage get <key> [dest]    # download an object (or print its URL)
 - **This is not where app uploads should go through you.** At runtime the app uses
   \`workser.storage\` from \`@workser/app\`, and for anything large it should request a
   presigned upload URL so the bytes never pass through Workser. See the
-  \`workser-sdk\` skill.
+  \`workser-sdk\` skill. Writing an upload handler that saves into the app's own
+  filesystem is the same mistake as above, plus one more: on a serverless host the
+  file is gone at the end of the request.
 
 ## Not the same as \`workser neon storage\`
 
@@ -7537,7 +7770,12 @@ function registerVersions(program3) {
       }
       const items = await api(ctx, `/v1/projects/${projectId}/versions`, {
         query: {
-          ...opts.app ? { webAppId: String(opts.app) } : {},
+          // `--app` wins; otherwise the app this folder is linked to (`ctx.appId`,
+          // from `.workser-app`). Standing in an app folder and being told
+          // "needs a webAppId" was the CLI refusing to read the marker it had
+          // already read for `status`. Outside any app folder this stays unset
+          // and the server's own refusal (never the primary-app guess) applies.
+          ...opts.app || ctx.appId ? { webAppId: String(opts.app ?? ctx.appId) } : {},
           ...parsed.value ? { environment: parsed.value } : {}
         }
       });
@@ -7579,7 +7817,12 @@ function registerLogs(program3) {
         throw new WorkserError(parsed.error, { code: "bad_input" });
       }
       const scope = {
-        ...opts.app ? { webAppId: String(opts.app) } : {},
+        // `--app` wins; otherwise the app this folder is linked to (`ctx.appId`,
+        // from `.workser-app`). Standing in an app folder and being told
+        // "needs a webAppId" was the CLI refusing to read the marker it had
+        // already read for `status`. Outside any app folder this stays unset
+        // and the server's own refusal (never the primary-app guess) applies.
+        ...opts.app || ctx.appId ? { webAppId: String(opts.app ?? ctx.appId) } : {},
         ...parsed.value ? { environment: parsed.value } : {}
       };
       const first = await api(ctx, `/v1/projects/${projectId}/logs`, {
@@ -7750,7 +7993,7 @@ function registerDoctor(program3) {
       const endpointSource = opts.endpoint ? "--endpoint" : process.env.WORKSER_DAEMON_URL ? "$WORKSER_DAEMON_URL" : session.endpoint ? "session" : process.env.WORKSER_API_URL ? "$WORKSER_API_URL" : `cloud-default: ${env}`;
       const projectSource = opts.project ? "--project" : link?.projectId ? ".workser link" : session.defaultProjectId ? "session" : void 0;
       const git2 = gitVersion();
-      const report = {
+      const report2 = {
         endpoint: ctx.endpoint,
         endpointSource,
         env,
@@ -7770,7 +8013,7 @@ function registerDoctor(program3) {
         cwd: ctx.cwd,
         workspace: session.workspaceName ?? null
       };
-      ok(report, () => {
+      ok(report2, () => {
         line(import_picocolors15.default.bold("workser doctor"));
         line(`  endpoint:  ${ctx.endpoint} ${import_picocolors15.default.dim(`(${endpointSource})`)}`);
         line(
@@ -8231,6 +8474,118 @@ function registerAgentCloud(program3) {
       });
     })
   );
+  cloud.command("triggers <agentId>").description("What starts this agent \u2014 schedules, chat channels, app events").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(args[0])}/triggers`
+      );
+      const items = res?.triggers ?? [];
+      ok(res, () => {
+        if (!items.length) {
+          return line(
+            import_picocolors17.default.dim("Nothing starts this agent yet \u2014 it only runs when asked.")
+          );
+        }
+        for (const t of items) {
+          const state = t.status === "active" ? import_picocolors17.default.green("on") : import_picocolors17.default.yellow(t.status);
+          const when = t.schedule_config?.cron_expression ?? t.app_event_config?.event_source ?? t.app_event_config?.event_type ?? "";
+          line(
+            `${import_picocolors17.default.bold(t.name ?? t.trigger_type)}  ${state}  ${import_picocolors17.default.dim(when)}`
+          );
+          line("  " + import_picocolors17.default.dim(t.id));
+        }
+      });
+    })
+  );
+  cloud.command("trigger-add <agentId> <kind> [pairs...]").description(
+    "Start an agent on a schedule, a chat channel or an app event. kind is schedule | chat | app_event. e.g. trigger-add <id> chat app_type=line"
+  ).action(
+    action(async ({ ctx, args }) => {
+      const kind = String(args[1]);
+      const pairs = parsePairs(
+        args[2] ?? [],
+        [
+          "name",
+          "rule",
+          "cron",
+          "timezone",
+          "app_type",
+          "event_type",
+          "connected_account_id"
+        ]
+      );
+      const body = buildTriggerBody(kind, pairs);
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(args[0])}/triggers`,
+        { method: "POST", body }
+      );
+      ok(res, () => {
+        line(import_picocolors17.default.green("Added.") + "  " + import_picocolors17.default.dim(res?.trigger?.id ?? ""));
+        if (kind === "chat") {
+          line(
+            import_picocolors17.default.dim("Now get the webhook URL to paste into the platform: ") + import_picocolors17.default.bold(
+              `workser agent-cloud trigger-setup ${args[0]} ${res?.trigger?.id ?? "<triggerId>"}`
+            )
+          );
+        }
+      });
+    })
+  );
+  cloud.command("trigger-setup <agentId> <triggerId>").description("The webhook URL and console steps for a chat trigger").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(args[0])}/triggers/${encodeURIComponent(args[1])}/setup`
+      );
+      ok(res, () => {
+        line(import_picocolors17.default.bold(`Connect ${res?.label ?? "this channel"}`));
+        line("");
+        line(import_picocolors17.default.bold("Webhook URL"));
+        line("  " + (res?.webhook_url ?? import_picocolors17.default.dim("\u2014")));
+        if (res?.verify_token) {
+          line(import_picocolors17.default.bold("Verify token"));
+          line("  " + res.verify_token);
+        }
+        line("");
+        for (const step of res?.setup_steps ?? []) line("  " + import_picocolors17.default.dim(step));
+        line("");
+        line(
+          res?.is_verified ? import_picocolors17.default.green(`Receiving \u2014 ${res.event_count ?? 0} events so far.`) : import_picocolors17.default.yellow("Nothing has arrived yet.")
+        );
+      });
+    })
+  );
+  cloud.command("trigger-remove <agentId> <triggerId>").description("Stop something from starting this agent").action(
+    action(async ({ ctx, args }) => {
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(args[0])}/triggers/${encodeURIComponent(args[1])}`,
+        { method: "DELETE" }
+      );
+      ok(res, () => line("Removed."));
+    })
+  );
+  cloud.command("trigger-events <agentId>").description("What has fired lately, and whether it started the agent").option("--limit <n>", "how many to show").action(
+    action(async ({ ctx, args, opts }) => {
+      const res = await api(
+        ctx,
+        `/v1/agent-cloud/${encodeURIComponent(args[0])}/trigger-events`,
+        { query: { limit: opts.limit } }
+      );
+      const items = res?.events ?? [];
+      ok(res, () => {
+        if (!items.length) return line(import_picocolors17.default.dim("Nothing has fired yet."));
+        for (const e of items) {
+          const state = e.status === "matched" ? import_picocolors17.default.green("started the agent") : e.status === "failed" ? import_picocolors17.default.red("failed") : import_picocolors17.default.yellow(e.status);
+          line(`${state}  ${e.summary ?? e.trigger_name ?? ""}`);
+          if (e.error_message) line("  " + import_picocolors17.default.red(e.error_message));
+          else if (e.reasoning) line("  " + import_picocolors17.default.dim(e.reasoning));
+        }
+      });
+    })
+  );
   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`, {
@@ -8413,6 +8768,60 @@ function parsePairs(pairs, allowed) {
   }
   return out;
 }
+function buildTriggerBody(kind, pairs) {
+  const base = {
+    name: pairs.name,
+    rule: pairs.rule
+  };
+  if (kind === "schedule") {
+    if (!pairs.cron) {
+      throw new Error(
+        'A schedule needs cron=, e.g. cron="0 9 * * 1-5" for every weekday at 9am.'
+      );
+    }
+    return {
+      ...base,
+      trigger_type: "schedule",
+      name: pairs.name ?? "Scheduled run",
+      schedule_config: {
+        cron_expression: pairs.cron,
+        timezone: pairs.timezone ?? "UTC"
+      }
+    };
+  }
+  if (kind === "chat") {
+    if (!pairs.app_type) {
+      throw new Error(
+        "A chat trigger needs app_type=, one of: line, telegram, discord, slack, facebook_messenger, instagram, whatsapp, twitter, custom."
+      );
+    }
+    return {
+      ...base,
+      trigger_type: "chat_webhook",
+      chat_webhook_config: {
+        app_type: pairs.app_type,
+        event_type: pairs.event_type ?? "message"
+      }
+    };
+  }
+  if (kind === "app_event") {
+    if (!pairs.event_type || !pairs.connected_account_id) {
+      throw new Error(
+        "An app-event trigger needs event_type= and connected_account_id= (see `workser connection list`)."
+      );
+    }
+    return {
+      ...base,
+      trigger_type: "app_event",
+      name: pairs.name ?? pairs.event_type,
+      app_event_config: {
+        event_type: pairs.event_type,
+        connected_account_id: pairs.connected_account_id
+      }
+    };
+  }
+  throw new Error(`Unknown kind "${kind}". One of: schedule | chat | app_event`);
+}
 
 // src/commands/verify.ts
 var import_picocolors18 = __toESM(require_picocolors(), 1);
@@ -8738,8 +9147,273 @@ function registerConnection(program3) {
   );
 }
 
-// src/commands/tool.ts
+// src/commands/channel.ts
 var import_picocolors23 = __toESM(require_picocolors(), 1);
+var SHAPES = [
+  {
+    id: "line",
+    label: "LINE",
+    description: "Connect a LINE Official Account and use the LINE Messaging API",
+    tokenField: "channel_access_token",
+    tokenHelp: "Messaging API tab \u2192 Channel access token",
+    extra: {
+      flag: "--secret <channelSecret>",
+      field: "channel_secret",
+      help: "Basic settings \u2192 Channel secret (for webhook signatures)"
+    },
+    send: {
+      operation: "push",
+      build: (to, text) => ({ to, messages: [{ type: "text", text }] })
+    },
+    reply: {
+      operation: "reply",
+      build: (replyToken, text) => ({
+        replyToken,
+        messages: [{ type: "text", text }]
+      })
+    }
+  },
+  {
+    id: "telegram",
+    label: "Telegram",
+    description: "Connect a Telegram bot and message chats, groups and channels",
+    tokenField: "bot_token",
+    tokenHelp: "The token @BotFather gave you",
+    send: {
+      operation: "send_message",
+      build: (chat_id, text) => ({ chat_id, text })
+    }
+  },
+  {
+    id: "discord",
+    label: "Discord",
+    description: "Connect a Discord bot and post in servers and DMs",
+    tokenField: "bot_token",
+    tokenHelp: "Developer Portal \u2192 your application \u2192 Bot \u2192 Reset Token",
+    send: {
+      operation: "send_message",
+      build: (channel_id, content) => ({ channel_id, content })
+    }
+  },
+  {
+    id: "slack",
+    label: "Slack",
+    description: "Connect a Slack app and post in channels and DMs",
+    tokenField: "bot_token",
+    tokenHelp: "OAuth & Permissions \u2192 Bot User OAuth Token (starts xoxb-)",
+    extra: {
+      flag: "--signing-secret <secret>",
+      field: "signing_secret",
+      help: "Basic Information \u2192 Signing Secret (for event signatures)"
+    },
+    send: {
+      operation: "send_message",
+      build: (channel, text) => ({ channel, text })
+    }
+  }
+];
+function registerChannels(program3) {
+  for (const shape of SHAPES) register(program3, shape);
+}
+function register(program3, shape) {
+  const cmd = program3.command(shape.id).description(shape.description);
+  const path = (suffix = "") => (projectId) => `/v1/projects/${projectId}/channels/${shape.id}${suffix}`;
+  cmd.command("status").description(`Show this project's ${shape.label} connection`).action(
+    action(async ({ ctx }) => {
+      const projectId = requireProject(ctx);
+      const res = await api(ctx, path()(projectId));
+      ok(res, () => {
+        const c = res?.connection;
+        if (!c) {
+          return line(
+            import_picocolors23.default.dim(
+              `No ${shape.label} account connected. Run \`workser ${shape.id} connect\`.`
+            )
+          );
+        }
+        const state = c.status === "connected" ? import_picocolors23.default.green(c.status) : import_picocolors23.default.yellow(c.status);
+        line(`${import_picocolors23.default.bold(c.display_name ?? shape.label)}  ${state}`);
+        for (const [k, v] of Object.entries(c.public_config ?? {})) {
+          if (v) line(import_picocolors23.default.dim(`  ${k}: ${v}`));
+        }
+        if (c.last_error) line(import_picocolors23.default.red(`  ${c.last_error}`));
+      });
+    })
+  );
+  const connect = cmd.command("connect").description(`Connect a ${shape.label} account to this project`).requiredOption("--token <token>", shape.tokenHelp);
+  if (shape.extra) connect.option(shape.extra.flag, shape.extra.help);
+  connect.action(
+    action(async ({ ctx, opts }) => {
+      const projectId = requireProject(ctx);
+      const body = {};
+      body[shape.tokenField] = String(opts.token);
+      if (shape.extra) {
+        const key = shape.extra.flag.split(" ")[0].replace(/^--/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        if (opts[key]) body[shape.extra.field] = opts[key];
+      }
+      const res = await api(ctx, path("/connect")(projectId), { body });
+      ok(
+        res,
+        () => line(
+          `Connected ${import_picocolors23.default.bold(res?.connection?.display_name ?? shape.label)}.`
+        )
+      );
+    })
+  );
+  cmd.command("verify").description(`Ask ${shape.label} whether the stored credential still works`).action(
+    action(async ({ ctx }) => {
+      const projectId = requireProject(ctx);
+      const res = await api(ctx, path("/verify")(projectId), { body: {} });
+      ok(res, () => {
+        const c = res?.connection;
+        line(
+          c?.status === "connected" ? import_picocolors23.default.green("The credential still works.") : import_picocolors23.default.red(c?.last_error ?? `${shape.label} refused it.`)
+        );
+      });
+    })
+  );
+  cmd.command("disconnect").description(`Disconnect ${shape.label} from this project`).action(
+    action(async ({ ctx }) => {
+      const projectId = requireProject(ctx);
+      const res = await api(ctx, path()(projectId), { method: "DELETE" });
+      ok(res, () => line("Disconnected."));
+    })
+  );
+  cmd.command("ops").description(`List every ${shape.label} operation`).option("--group <name>", "filter to one group").action(
+    action(async ({ ctx, opts }) => {
+      const projectId = requireProject(ctx);
+      const res = await api(ctx, path("/operations")(projectId));
+      const all = res?.operations ?? [];
+      const items = opts.group ? all.filter((o) => o.group === opts.group) : all;
+      ok(items, () => {
+        if (!items.length) return line(import_picocolors23.default.dim("No operations matched."));
+        let group = "";
+        for (const o of items) {
+          if (o.group !== group) {
+            group = o.group;
+            line(import_picocolors23.default.dim(`
+${group}`));
+          }
+          const mark = o.writes ? import_picocolors23.default.yellow(" \u25CF") : "  ";
+          line(`${mark} ${import_picocolors23.default.bold(o.id.padEnd(28))} ${o.summary}`);
+        }
+        line(
+          import_picocolors23.default.dim(
+            "\n\u25CF sends something, spends quota, or changes the account."
+          )
+        );
+        for (const note of res?.excludes ?? []) {
+          line(import_picocolors23.default.dim(`  not included \u2014 ${note}`));
+        }
+      });
+    })
+  );
+  cmd.command("call <operation>").description(`Run any ${shape.label} operation \u2014 see \`workser ${shape.id} ops\``).option("--params <json>", "the operation's parameters as a JSON string", "{}").action(
+    action(async ({ ctx, args, opts }) => {
+      const projectId = requireProject(ctx);
+      const res = await call(ctx, projectId, shape, args[0], parseParams(opts.params));
+      ok(res, () => line(JSON.stringify(res?.data ?? res, null, 2)));
+    })
+  );
+  if (shape.send) {
+    const send = shape.send;
+    cmd.command("send <to> <text>").description(
+      shape.id === "discord" ? "Post a text message in a Discord channel id" : shape.id === "slack" ? "Post a text message in a Slack channel or DM id" : "Send a text message to a chat, user, group or room id"
+    ).action(
+      action(async ({ ctx, args }) => {
+        const projectId = requireProject(ctx);
+        const res = await call(
+          ctx,
+          projectId,
+          shape,
+          send.operation,
+          send.build(args[0], args[1])
+        );
+        ok(res, () => report(res, "Sent."));
+      })
+    );
+  }
+  if (shape.reply) {
+    const reply = shape.reply;
+    cmd.command("reply <token> <text>").description("Answer a message using its reply token \u2014 free, and single-use").action(
+      action(async ({ ctx, args }) => {
+        const projectId = requireProject(ctx);
+        const res = await call(
+          ctx,
+          projectId,
+          shape,
+          reply.operation,
+          reply.build(args[0], args[1])
+        );
+        ok(res, () => report(res, "Replied."));
+      })
+    );
+  }
+  if (shape.id === "line") {
+    cmd.command("broadcast <text>").description("Send a text message to EVERY follower \u2014 spends one message each").action(
+      action(async ({ ctx, args }) => {
+        const projectId = requireProject(ctx);
+        const res = await call(ctx, projectId, shape, "broadcast", {
+          messages: [{ type: "text", text: args[0] }]
+        });
+        ok(res, () => report(res, "Broadcast sent."));
+      })
+    );
+    cmd.command("quota").description("How much of this month's message allowance is left").action(
+      action(async ({ ctx }) => {
+        const projectId = requireProject(ctx);
+        const [quota, used] = await Promise.all([
+          call(ctx, projectId, shape, "quota", {}),
+          call(ctx, projectId, shape, "quota_consumption", {})
+        ]);
+        ok({ quota: quota?.data, consumption: used?.data }, () => {
+          const limit = quota?.data?.value;
+          const spent = used?.data?.totalUsage;
+          if (limit === void 0) {
+            return line(JSON.stringify(quota?.data ?? quota, null, 2));
+          }
+          line(`${spent ?? "?"} of ${limit} messages used this month.`);
+        });
+      })
+    );
+    cmd.command("profile <userId>").description("Look up one follower").action(
+      action(async ({ ctx, args }) => {
+        const projectId = requireProject(ctx);
+        const res = await call(ctx, projectId, shape, "profile", {
+          userId: args[0]
+        });
+        ok(res, () => line(JSON.stringify(res?.data ?? res, null, 2)));
+      })
+    );
+  }
+}
+function parseParams(raw) {
+  try {
+    const parsed = JSON.parse(raw || "{}");
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch {
+  }
+  throw new Error(
+    `--params must be a JSON object, e.g. --params '{"chat_id":123,"text":"hi"}'`
+  );
+}
+async function call(ctx, projectId, shape, operation, params) {
+  return api(ctx, `/v1/projects/${projectId}/channels/${shape.id}/call`, {
+    body: { operation, params }
+  });
+}
+function report(res, success2) {
+  if (res?.ok === false) {
+    line(import_picocolors23.default.red(res.message ?? "That was refused."));
+    return;
+  }
+  line(success2);
+}
+
+// src/commands/tool.ts
+var import_picocolors24 = __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"
@@ -8748,7 +9422,7 @@ function registerTool(program3) {
     action(async ({ ctx }) => {
       const tools = await api(ctx, "/v1/tool/list");
       ok(tools, () => {
-        if (!tools?.length) return line(import_picocolors23.default.dim("No tools available."));
+        if (!tools?.length) return line(import_picocolors24.default.dim("No tools available."));
         const byCategory = /* @__PURE__ */ new Map();
         for (const t of tools) {
           const list = byCategory.get(t.category) ?? [];
@@ -8756,9 +9430,9 @@ function registerTool(program3) {
           byCategory.set(t.category, list);
         }
         for (const [category, items] of byCategory) {
-          line(import_picocolors23.default.bold(category) + ":");
+          line(import_picocolors24.default.bold(category) + ":");
           for (const t of items) {
-            line(`  ${t.name}  ${import_picocolors23.default.dim(t.description ?? "")}`);
+            line(`  ${t.name}  ${import_picocolors24.default.dim(t.description ?? "")}`);
           }
         }
       });
@@ -8776,7 +9450,7 @@ function registerTool(program3) {
 }
 
 // src/commands/memory.ts
-var import_picocolors24 = __toESM(require_picocolors(), 1);
+var import_picocolors25 = __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(
@@ -8800,9 +9474,9 @@ function registerMemory(program3) {
       });
       ok(res, () => {
         const results = res?.results ?? res ?? [];
-        if (!results?.length) return line(import_picocolors24.default.dim("No matching memories."));
+        if (!results?.length) return line(import_picocolors25.default.dim("No matching memories."));
         for (const r of results) {
-          line(`${import_picocolors24.default.dim(r.id ?? "?")}  ${memoryText(r)}`);
+          line(`${import_picocolors25.default.dim(r.id ?? "?")}  ${memoryText(r)}`);
         }
       });
     })
@@ -8822,11 +9496,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_picocolors24.default.dim("(no readable text on this row)");
+  return import_picocolors25.default.dim("(no readable text on this row)");
 }
 
 // src/commands/note.ts
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 function registerNote(program3) {
   program3.command("note <text>").description("Leave a fact the rest of the team will need").addHelpText(
     "after",
@@ -8863,14 +9537,14 @@ function registerNote(program3) {
       }
       ok(res, () => {
         success("Noted for the team.");
-        line(import_picocolors25.default.dim(`  ${text}`));
+        line(import_picocolors26.default.dim(`  ${text}`));
       });
     })
   );
 }
 
 // src/commands/business.ts
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors27 = __toESM(require_picocolors(), 1);
 var RESOURCE_PATHS = {
   "business-config": "business-config",
   "business-settings": "business-settings",
@@ -8930,7 +9604,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_picocolors26.default.bold(res?.id ?? "")}.`));
+      ok(res, () => line(`Created ${resource} ${import_picocolors27.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(
@@ -8972,7 +9646,7 @@ function businessPath(projectId, resource, subpath) {
 }
 
 // src/commands/artifact.ts
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors28 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync2, statSync } from "fs";
 import { resolve as resolve3, basename as basename3 } from "path";
 var KINDS = [
@@ -9069,7 +9743,7 @@ function registerArtifact(program3) {
       ok(
         res,
         () => success(
-          `Recorded ${import_picocolors27.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors27.default.dim(` (${res.kind})`) : ""}`
+          `Recorded ${import_picocolors28.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors28.default.dim(` (${res.kind})`) : ""}`
         )
       );
     })
@@ -9107,7 +9781,7 @@ function registerArtifact(program3) {
 }
 function printArtifacts(rows) {
   if (!rows.length) {
-    line(import_picocolors27.default.dim("Nothing produced yet."));
+    line(import_picocolors28.default.dim("Nothing produced yet."));
     return;
   }
   const byStep = /* @__PURE__ */ new Map();
@@ -9117,26 +9791,26 @@ function printArtifacts(rows) {
     byStep.set(r.subtask_id, list);
   }
   for (const [stepId, items] of byStep) {
-    line(import_picocolors27.default.bold(`step ${stepId}`));
+    line(import_picocolors28.default.bold(`step ${stepId}`));
     for (const a of items) {
-      const flag = a.promoted_at ? import_picocolors27.default.green(" *") : "  ";
+      const flag = a.promoted_at ? import_picocolors28.default.green(" *") : "  ";
       const where = a.local_path || a.cloud_url || "";
       line(
-        `${flag} ${import_picocolors27.default.dim(`[${a.kind}]`)} ${a.title ?? "(untitled)"}` + (where ? import_picocolors27.default.dim(`  ${where}`) : "")
+        `${flag} ${import_picocolors28.default.dim(`[${a.kind}]`)} ${a.title ?? "(untitled)"}` + (where ? import_picocolors28.default.dim(`  ${where}`) : "")
       );
-      if (a.description) line(import_picocolors27.default.dim(`     ${a.description}`));
+      if (a.description) line(import_picocolors28.default.dim(`     ${a.description}`));
     }
     line("");
   }
-  line(import_picocolors27.default.dim("* = handed over as a deliverable; the rest is working material."));
+  line(import_picocolors28.default.dim("* = handed over as a deliverable; the rest is working material."));
 }
 function printRun2(run) {
   if (!run) return;
-  line(`  run      ${import_picocolors27.default.bold(run.runId)}`);
+  line(`  run      ${import_picocolors28.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_picocolors27.default.dim(run.cwd)}`);
+  if (run.cwd) line(`  folder   ${import_picocolors28.default.dim(run.cwd)}`);
 }
 
 // src/commands/image.ts
@@ -9343,7 +10017,7 @@ function registerAudio(program3) {
 }
 
 // src/commands/ask.ts
-var import_picocolors28 = __toESM(require_picocolors(), 1);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
 var TYPES = [
   "input",
   "choice",
@@ -9440,7 +10114,7 @@ function registerAsk(program3) {
           code: "bad_request"
         });
       }
-      info(import_picocolors28.default.dim("Waiting for the user to answer\u2026"));
+      info(import_picocolors29.default.dim("Waiting for the user to answer\u2026"));
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}/ask`, {
         body: {
           type,
@@ -9468,12 +10142,12 @@ function deriveTitle(message) {
 function printAnswer(res) {
   if (!res) return;
   if (res.status === "answered") {
-    line(`  ${import_picocolors28.default.green("answered")}`);
+    line(`  ${import_picocolors29.default.green("answered")}`);
     const value = extract(res.response);
     if (value) line(`  ${value}`);
     return;
   }
-  line(`  ${import_picocolors28.default.yellow(res.status)}  ${import_picocolors28.default.dim(res.reason ?? "")}`);
+  line(`  ${import_picocolors29.default.yellow(res.status)}  ${import_picocolors29.default.dim(res.reason ?? "")}`);
 }
 function extract(response) {
   if (response == null) return "";
@@ -9492,7 +10166,7 @@ function extract(response) {
 }
 
 // src/commands/search.ts
-var import_picocolors29 = __toESM(require_picocolors(), 1);
+var import_picocolors30 = __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 }) => {
@@ -9505,9 +10179,9 @@ function registerSearch(program3) {
           line("");
         }
         const results = res?.results ?? [];
-        if (!results.length) return line(import_picocolors29.default.dim("No results."));
+        if (!results.length) return line(import_picocolors30.default.dim("No results."));
         for (const r of results) {
-          line(`${r.title || import_picocolors29.default.dim("(untitled)")}  ${import_picocolors29.default.dim(r.url)}`);
+          line(`${r.title || import_picocolors30.default.dim("(untitled)")}  ${import_picocolors30.default.dim(r.url)}`);
         }
       });
     })
@@ -9515,7 +10189,7 @@ function registerSearch(program3) {
 }
 
 // src/commands/board.ts
-var import_picocolors30 = __toESM(require_picocolors(), 1);
+var import_picocolors31 = __toESM(require_picocolors(), 1);
 
 // src/commands/record-step.ts
 async function recordEntityStep(ctx, opts) {
@@ -9554,7 +10228,7 @@ function registerBoard(program3) {
       }
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors30.default.dim("No cards on the Board yet."));
+          line(import_picocolors31.default.dim("No cards on the Board yet."));
           return;
         }
         for (const r of rows) line(formatRow(r));
@@ -9569,7 +10243,7 @@ function registerBoard(program3) {
         `/v1/projects/${projectId}/work-items/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors30.default.bold(row.title)}  ${import_picocolors30.default.dim(row.id)}`);
+        line(`${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.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(", ")}`);
@@ -9610,7 +10284,7 @@ ${row.description}`);
         refId: row?.id,
         output: { workItem: row }
       });
-      ok(row, () => line(`Created work item ${import_picocolors30.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created work item ${import_picocolors31.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(
@@ -9644,7 +10318,7 @@ ${row.description}`);
         );
       }
       const row = await patchItem(ctx, projectId, String(args[0]), body);
-      ok(row, () => line(`Updated ${import_picocolors30.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
+      ok(row, () => line(`Updated ${import_picocolors31.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
     })
   );
   board.command("move <id> <status>").description(
@@ -9655,14 +10329,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_picocolors30.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
+      ok(row, () => line(`Moved ${import_picocolors31.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_picocolors30.default.bold(row.title)} ${statusTag(row.status)}`));
+      ok(row, () => line(`Closed ${import_picocolors31.default.bold(row.title)} ${statusTag(row.status)}`));
     })
   );
 }
@@ -9695,23 +10369,23 @@ function assertPriority(value) {
   }
 }
 function formatRow(r) {
-  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}`;
+  const labels = r.labels?.length ? import_picocolors31.default.dim(` [${r.labels.join(", ")}]`) : "";
+  const owner = r.ownerHuman ? import_picocolors31.default.dim(` @${r.ownerHuman}`) : "";
+  return `${import_picocolors31.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
 }
 function statusTag(status) {
   const label = status.padEnd(11);
-  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);
+  if (status === "done") return import_picocolors31.default.green(label);
+  if (status === "in-progress") return import_picocolors31.default.yellow(label);
+  if (status === "in-review") return import_picocolors31.default.cyan(label);
+  return import_picocolors31.default.dim(label);
 }
 function collect2(value, previous) {
   return [...previous, value];
 }
 
 // src/commands/task.ts
-var import_picocolors31 = __toESM(require_picocolors(), 1);
+var import_picocolors32 = __toESM(require_picocolors(), 1);
 
 // src/subtask-attachments.ts
 var MAX_REF_NOTE = 500;
@@ -9826,7 +10500,7 @@ function registerTask(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors31.default.dim("No tasks on the board yet."));
+          line(import_picocolors32.default.dim("No tasks on the board yet."));
           return;
         }
         for (const r of rows) line(formatRow2(r));
@@ -9941,10 +10615,10 @@ function registerTask(program3) {
       };
       ok(result, () => {
         line(
-          `${import_picocolors31.default.green("opened")} ${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`
+          `${import_picocolors32.default.green("opened")} ${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.key ?? row.id)}`
         );
         if (channelMessage)
-          line(import_picocolors31.default.dim("posted to the channel as Project Manager"));
+          line(import_picocolors32.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}`
@@ -10023,12 +10697,12 @@ function registerTask(program3) {
       ) : null;
       ok(runner ?? row, () => {
         line(
-          `${import_picocolors31.default.green("added")} ${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`
+          `${import_picocolors32.default.green("added")} ${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.key ?? row.id)}`
         );
-        if (row.role) line(import_picocolors31.default.dim(`role: ${row.role}`));
+        if (row.role) line(import_picocolors32.default.dim(`role: ${row.role}`));
         if (runner) {
           line(
-            import_picocolors31.default.dim(
+            import_picocolors32.default.dim(
               `runs on: ${[opts.agent, opts.model, opts.effort].filter(Boolean).join(" \xB7 ")}`
             )
           );
@@ -10046,7 +10720,7 @@ function registerTask(program3) {
       const rows = row.subtasks ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors31.default.dim("No subtasks yet."));
+          line(import_picocolors32.default.dim("No subtasks yet."));
           return;
         }
         rows.forEach((r, i) => line(formatSubtask(r, i + 1)));
@@ -10094,7 +10768,7 @@ function registerTask(program3) {
           }
         }
       );
-      ok(row, () => line(`${import_picocolors31.default.green("updated")} ${import_picocolors31.default.bold(row.title)}`));
+      ok(row, () => line(`${import_picocolors32.default.green("updated")} ${import_picocolors32.default.bold(row.title)}`));
     })
   );
   subtask.command("remove <id>").description("Remove a subtask (only before the work starts)").action(
@@ -10102,7 +10776,7 @@ function registerTask(program3) {
       await api(ctx, `/v1/project-tasks/${encodeURIComponent(args[0])}`, {
         method: "DELETE"
       });
-      ok({ removed: args[0] }, () => line(import_picocolors31.default.green("removed")));
+      ok({ removed: args[0] }, () => line(import_picocolors32.default.green("removed")));
     })
   );
   task.command("move <id> <status>").description(
@@ -10117,7 +10791,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors31.default.green("moved")} ${import_picocolors31.default.bold(row.title)} \u2192 ${args[1]}`)
+        () => line(`${import_picocolors32.default.green("moved")} ${import_picocolors32.default.bold(row.title)} \u2192 ${args[1]}`)
       );
     })
   );
@@ -10133,18 +10807,18 @@ function registerTask(program3) {
       );
       ok(row, () => {
         if (!row?.queued) {
-          line(import_picocolors31.default.yellow("could not resume it \u2014 check the step id"));
+          line(import_picocolors32.default.yellow("could not resume it \u2014 check the step id"));
           return;
         }
         const started = row.started ?? 0;
         if (started > 0) {
           line(
-            `${import_picocolors31.default.green("resumed")} \u2014 ${started} step${started === 1 ? "" : "s"} started`
+            `${import_picocolors32.default.green("resumed")} \u2014 ${started} step${started === 1 ? "" : "s"} started`
           );
           return;
         }
         line(
-          `${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.`
+          `${import_picocolors32.default.green("resumed")} \u2014 it is queued, but nothing started yet. Check the plan is approved and that no step is blocking the rest.`
         );
       });
     })
@@ -10158,11 +10832,11 @@ function registerTask(program3) {
       );
       ok(row, () => {
         if (row?.reopened) {
-          line(`${import_picocolors31.default.green("sent back")} \u2014 it will be picked up again`);
+          line(`${import_picocolors32.default.green("sent back")} \u2014 it will be picked up again`);
           return;
         }
         line(
-          import_picocolors31.default.yellow(
+          import_picocolors32.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"
           )
         );
@@ -10179,7 +10853,7 @@ function registerTask(program3) {
         `/v1/project-tasks/${encodeURIComponent(id)}/dispatch-check`,
         { method: "POST" }
       );
-      ok(row, () => line(import_picocolors31.default.green("approved \u2014 you may start")));
+      ok(row, () => line(import_picocolors32.default.green("approved \u2014 you may start")));
     })
   );
   task.command("start [id]").description(
@@ -10194,13 +10868,13 @@ function registerTask(program3) {
         const started = row?.started ?? null;
         if (started && started > 0) {
           line(
-            import_picocolors31.default.green(
+            import_picocolors32.default.green(
               `started ${started} step${started === 1 ? "" : "s"} \u2014 they are running now`
             )
           );
           return;
         }
-        line(import_picocolors31.default.yellow(row?.note ?? "Nothing started."));
+        line(import_picocolors32.default.yellow(row?.note ?? "Nothing started."));
       });
     })
   );
@@ -10215,7 +10889,7 @@ function registerTask(program3) {
         );
         ok({ awaiting: row2.approval_state === "awaiting", task: row2 }, () => {
           line(
-            row2.approval_state === "awaiting" ? import_picocolors31.default.yellow(
+            row2.approval_state === "awaiting" ? import_picocolors32.default.yellow(
               "The plan is waiting on the owner. They see it in the task."
             ) : `Already ${row2.approval_state}.`
           );
@@ -10240,7 +10914,7 @@ function registerTask(program3) {
       );
       ok(
         row,
-        () => line(`${import_picocolors31.default.green(row.approval_state)} ${import_picocolors31.default.bold(row.title)}`)
+        () => line(`${import_picocolors32.default.green(row.approval_state)} ${import_picocolors32.default.bold(row.title)}`)
       );
     })
   );
@@ -10256,7 +10930,7 @@ function registerTask(program3) {
         `/v1/project-tasks/${encodeURIComponent(id)}/move`,
         { body: { status: "ready" } }
       );
-      ok(row, () => line(`${import_picocolors31.default.green("ready")} ${import_picocolors31.default.bold(row.title)}`));
+      ok(row, () => line(`${import_picocolors32.default.green("ready")} ${import_picocolors32.default.bold(row.title)}`));
     })
   );
 }
@@ -10301,24 +10975,24 @@ function assertOneOf(flag, value, allowed) {
   }
 }
 function formatRow2(r) {
-  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") : "";
+  const key = import_picocolors32.default.dim((r.key ?? r.id.slice(0, 8)).padEnd(10));
+  const steps = r.subtaskTotal ? import_picocolors32.default.dim(` ${r.subtaskDone}/${r.subtaskTotal}`) : "";
+  const gate = r.approval_state === "awaiting" ? import_picocolors32.default.yellow(" awaiting approval") : "";
   return `${key} ${statusTag2(r.status)} ${r.title}${steps}${gate}`;
 }
 function formatSubtask(r, index) {
-  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 n = import_picocolors32.default.dim(String(index).padStart(2, "0"));
+  const role = r.role ? import_picocolors32.default.dim(` [${r.role}]`) : "";
+  const scope = r.scope_paths?.length ? import_picocolors32.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_picocolors31.default.dim(wrapped)}`;
+${import_picocolors32.default.dim(wrapped)}`;
 }
 function printTask(row, goal) {
-  line(`${import_picocolors31.default.bold(row.title)}  ${import_picocolors31.default.dim(row.key ?? row.id)}`);
+  line(`${import_picocolors32.default.bold(row.title)}  ${import_picocolors32.default.dim(row.key ?? row.id)}`);
   line(`${statusTag2(row.status)}  approval: ${row.approval_state}`);
   if (row.summary) line(`
 ${row.summary}`);
@@ -10331,53 +11005,53 @@ touches: ${row.targets.map((t) => t.appName ?? t.ref ?? t.kind).join(", ")}`
   }
   if (row.subtasks?.length) {
     line(`
-${import_picocolors31.default.bold("subtasks")}`);
+${import_picocolors32.default.bold("subtasks")}`);
     row.subtasks.forEach((s, i) => line(formatSubtask(s, i + 1)));
     line(
-      import_picocolors31.default.dim(
+      import_picocolors32.default.dim(
         `
 Run \`workser artifact list\` to see what these subtasks produced,`
       )
     );
     line(
-      import_picocolors31.default.dim(
+      import_picocolors32.default.dim(
         `or \`workser artifact list --step <id>\` for one subtask's output alone.`
       )
     );
   } else {
-    line(import_picocolors31.default.dim("\nNo subtasks yet."));
+    line(import_picocolors32.default.dim("\nNo subtasks yet."));
   }
 }
 function printGoalContext(row, goal) {
   const mine = row.phase ?? null;
   line(`
-${import_picocolors31.default.bold("part of")}: ${goal.title}`);
-  if (goal.outcome) line(import_picocolors31.default.dim(`done means: ${goal.outcome}`));
+${import_picocolors32.default.bold("part of")}: ${goal.title}`);
+  if (goal.outcome) line(import_picocolors32.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_picocolors31.default.cyan("  <- this task") : "";
-    const mark = p.state === "done" ? import_picocolors31.default.green("*") : import_picocolors31.default.dim("-");
+    const here = mine && p.name === mine ? import_picocolors32.default.cyan("  <- this task") : "";
+    const mark = p.state === "done" ? import_picocolors32.default.green("*") : import_picocolors32.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_picocolors31.default.dim(
+      import_picocolors32.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_picocolors31.default.dim(
+      import_picocolors32.default.dim(
         "\nEvery part of this plan is done. Say so, and offer to wrap it up."
       )
     );
   }
   line(
-    import_picocolors31.default.dim(
+    import_picocolors32.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."
     )
   );
@@ -10385,22 +11059,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_picocolors31.default.green("[ready]");
+      return import_picocolors32.default.green("[ready]");
     case "working":
-      return import_picocolors31.default.blue("[working]");
+      return import_picocolors32.default.blue("[working]");
     case "checking":
-      return import_picocolors31.default.cyan("[checking]");
+      return import_picocolors32.default.cyan("[checking]");
     case "accepted":
-      return import_picocolors31.default.green("[accepted]");
+      return import_picocolors32.default.green("[accepted]");
     case "archived":
-      return import_picocolors31.default.dim("[archived]");
+      return import_picocolors32.default.dim("[archived]");
     default:
-      return import_picocolors31.default.dim("[todo]");
+      return import_picocolors32.default.dim("[todo]");
   }
 }
 
 // src/commands/goal.ts
-var import_picocolors32 = __toESM(require_picocolors(), 1);
+var import_picocolors33 = __toESM(require_picocolors(), 1);
 var STATUSES3 = ["proposed", "agreed", "working", "delivered", "abandoned"];
 var PACES = ["slice", "phase", "all"];
 function registerGoal(program3) {
@@ -10413,7 +11087,7 @@ function registerGoal(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors32.default.dim("No goals yet \u2014 every task here stands on its own."));
+          line(import_picocolors33.default.dim("No goals yet \u2014 every task here stands on its own."));
           return;
         }
         for (const g of rows) line(formatGoal(g));
@@ -10499,10 +11173,10 @@ function registerGoal(program3) {
         }
       });
       ok(row, () => {
-        success(`Proposed ${import_picocolors32.default.bold(row?.title ?? "goal")}`);
+        success(`Proposed ${import_picocolors33.default.bold(row?.title ?? "goal")}`);
         printGoal(row);
         line(
-          import_picocolors32.default.dim(
+          import_picocolors33.default.dim(
             "\nNothing has been created yet. The owner agrees the shape first."
           )
         );
@@ -10531,7 +11205,7 @@ function registerGoal(program3) {
       ok(
         row,
         () => line(
-          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(
+          row?.recorded ? met === true ? import_picocolors33.default.green("recorded \u2014 met") : met === false ? import_picocolors33.default.yellow("recorded \u2014 not met") : import_picocolors33.default.dim("recorded \u2014 back to unchecked") : import_picocolors33.default.yellow(
             "couldn't record it \u2014 check the goal id, the phase name and the criterion id"
           )
         )
@@ -10574,7 +11248,7 @@ function registerGoal(program3) {
       }
       ok({ goalId, phase, filed }, () => {
         success(
-          `Filed ${filed.length} ${filed.length === 1 ? "task" : "tasks"} under ${import_picocolors32.default.bold(phase)}`
+          `Filed ${filed.length} ${filed.length === 1 ? "task" : "tasks"} under ${import_picocolors33.default.bold(phase)}`
         );
       });
     })
@@ -10612,43 +11286,43 @@ function registerGoal(program3) {
 function appScope(g) {
   const n = g.appIds?.length ?? 0;
   if (!n) return "";
-  return import_picocolors32.default.dim(`  ${n} part${n === 1 ? "" : "s"} of the system`);
+  return import_picocolors33.default.dim(`  ${n} part${n === 1 ? "" : "s"} of the system`);
 }
 function formatGoal(g) {
-  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)}`;
+  const where = g.currentPhase && g.status !== "delivered" ? import_picocolors33.default.dim(`  now: ${g.currentPhase}`) : "";
+  const count = g.taskTotal != null ? import_picocolors33.default.dim(`  ${g.taskDone}/${g.taskTotal} done`) : "";
+  return `${statusTag3(g.status)} ${g.title}${appScope(g)}${where}${count}  ${import_picocolors33.default.dim(g.id)}`;
 }
 function printGoal(g) {
   if (!g) return;
-  line(`${import_picocolors32.default.bold(g.title)}  ${import_picocolors32.default.dim(g.id)}`);
+  line(`${import_picocolors33.default.bold(g.title)}  ${import_picocolors33.default.dim(g.id)}`);
   line(statusTag3(g.status));
   if (g.outcome) line(`
 done means: ${g.outcome}`);
-  if (g.pace) line(import_picocolors32.default.dim(`pace: ${paceLine(g.pace)}`));
+  if (g.pace) line(import_picocolors33.default.dim(`pace: ${paceLine(g.pace)}`));
   const progress = g.progress ?? [];
   if (!progress.length) {
-    line(import_picocolors32.default.dim("\nNo phases agreed yet."));
+    line(import_picocolors33.default.dim("\nNo phases agreed yet."));
     return;
   }
   line(`
-${import_picocolors32.default.bold("phases")}`);
+${import_picocolors33.default.bold("phases")}`);
   for (const p of progress) {
-    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");
+    const bar2 = p.total > 0 ? `${p.done}/${p.total} done` : import_picocolors33.default.dim("nothing filed yet");
+    const mark = p.state === "done" ? import_picocolors33.default.green("done") : p.state === "working" ? import_picocolors33.default.blue("working") : import_picocolors33.default.dim("waiting");
     line(
-      `  ${import_picocolors32.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors32.default.dim(bar2)}`
+      `  ${import_picocolors33.default.dim(String(p.index).padStart(2, "0"))} ${p.name}  ${mark}  ${import_picocolors33.default.dim(bar2)}`
     );
     for (const c of p.criteria ?? []) {
-      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 tick = c.met === true ? import_picocolors33.default.green("\u2713") : c.met === false ? import_picocolors33.default.red("\u2717") : import_picocolors33.default.dim("\xB7");
+      line(`       ${tick} ${c.text}  ${import_picocolors33.default.dim(c.id)}`);
+      if (c.note) line(import_picocolors33.default.dim(`         ${c.note}`));
     }
   }
   const current = progress.find((p) => p.name === g.currentPhase);
   if (current) {
     line(
-      import_picocolors32.default.dim(
+      import_picocolors33.default.dim(
         `
 ${current.name} \u2014 ${current.done} of ${current.total} done (phase ${current.index} of ${progress.length}).`
       )
@@ -10658,15 +11332,15 @@ ${current.name} \u2014 ${current.done} of ${current.total} done (phase ${current
 function statusTag3(status) {
   switch (status) {
     case "agreed":
-      return import_picocolors32.default.cyan("[agreed]");
+      return import_picocolors33.default.cyan("[agreed]");
     case "working":
-      return import_picocolors32.default.blue("[working]");
+      return import_picocolors33.default.blue("[working]");
     case "delivered":
-      return import_picocolors32.default.green("[delivered]");
+      return import_picocolors33.default.green("[delivered]");
     case "abandoned":
-      return import_picocolors32.default.dim("[abandoned]");
+      return import_picocolors33.default.dim("[abandoned]");
     default:
-      return import_picocolors32.default.yellow("[proposed]");
+      return import_picocolors33.default.yellow("[proposed]");
   }
 }
 function paceLine(pace) {
@@ -10720,7 +11394,7 @@ function stripLeadingGlobalOptions(argv) {
 }
 
 // src/commands/decision.ts
-var import_picocolors33 = __toESM(require_picocolors(), 1);
+var import_picocolors34 = __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)").option("--search <text>", "match the title, case-insensitively").option("--label <name>", "only decisions carrying this label").option("--app <id>", "only decisions about this app").option("--infra <name>", "only decisions touching this part of the infrastructure").option("--status <name>", "proposed | accepted | superseded").action(
@@ -10743,13 +11417,13 @@ function registerDecision(program3) {
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors33.default.dim("No decisions recorded yet."));
+          line(import_picocolors34.default.dim("No decisions recorded yet."));
           return;
         }
         for (const r of rows) {
           const tags = [...r.labels ?? [], ...r.infraRefs ?? []];
-          const meta = tags.length ? import_picocolors33.default.dim(`  [${tags.join(", ")}]`) : "";
-          line(`${import_picocolors33.default.dim(r.id)}  ${import_picocolors33.default.dim(shortDate(r.createdAt))}  ${r.title}${meta}`);
+          const meta = tags.length ? import_picocolors34.default.dim(`  [${tags.join(", ")}]`) : "";
+          line(`${import_picocolors34.default.dim(r.id)}  ${import_picocolors34.default.dim(shortDate(r.createdAt))}  ${r.title}${meta}`);
           line(`    ${truncate(r.decision, 100)}`);
         }
       });
@@ -10763,16 +11437,16 @@ function registerDecision(program3) {
         `/v1/projects/${projectId}/architecture-decisions/${args[0]}`
       );
       ok(row, () => {
-        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_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
+        line(import_picocolors34.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
-${import_picocolors33.default.bold("Context")}
+${import_picocolors34.default.bold("Context")}
 ${row.context}`);
         line(`
-${import_picocolors33.default.bold("Decision")}
+${import_picocolors34.default.bold("Decision")}
 ${row.decision}`);
         if (row.consequences) line(`
-${import_picocolors33.default.bold("Consequences")}
+${import_picocolors34.default.bold("Consequences")}
 ${row.consequences}`);
       });
     })
@@ -10789,7 +11463,7 @@ ${row.consequences}`);
       const path = `/v1/projects/${projectId}/architecture-decisions/${id}`;
       if (opts.delete) {
         await api(ctx, path, { method: "DELETE" });
-        ok({ deleted: true, id }, () => line(`Deleted decision ${import_picocolors33.default.bold(id)}.`));
+        ok({ deleted: true, id }, () => line(`Deleted decision ${import_picocolors34.default.bold(id)}.`));
         return;
       }
       const row = await api(ctx, path, {
@@ -10799,7 +11473,7 @@ ${row.consequences}`);
       ok(
         row,
         () => line(
-          `Marked ${import_picocolors33.default.bold(row?.title ?? id)} superseded.` + (opts.reason ? ` Record the replacement with \`decision create\`.` : "")
+          `Marked ${import_picocolors34.default.bold(row?.title ?? id)} superseded.` + (opts.reason ? ` Record the replacement with \`decision create\`.` : "")
         )
       );
     })
@@ -10820,7 +11494,7 @@ ${row.consequences}`);
         `/v1/projects/${projectId}/architecture-decisions/${id}`,
         { method: "PATCH", body }
       );
-      ok(row, () => line(`Filed decision ${import_picocolors33.default.bold(row?.title ?? id)}.`));
+      ok(row, () => line(`Filed decision ${import_picocolors34.default.bold(row?.title ?? id)}.`));
     })
   );
   decision.command("create <title>").description(
@@ -10851,7 +11525,7 @@ ${row.consequences}`);
         refId: row?.id,
         output: { decision: row }
       });
-      ok(row, () => line(`Recorded decision ${import_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded decision ${import_picocolors34.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   const requirement = program3.command("requirement").description("Read and record the project's requirements");
@@ -10863,11 +11537,11 @@ ${row.consequences}`);
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors33.default.dim("No requirements recorded yet."));
+          line(import_picocolors34.default.dim("No requirements recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors33.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
+          line(`${import_picocolors34.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
         }
       });
     })
@@ -10880,8 +11554,8 @@ ${row.consequences}`);
         `/v1/projects/${projectId}/requirements/${args[0]}`
       );
       ok(row, () => {
-        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_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
+        line(import_picocolors34.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
 ${row.body}`);
       });
@@ -10907,7 +11581,7 @@ ${row.body}`);
         refId: row?.id,
         output: { requirement: row }
       });
-      ok(row, () => line(`Recorded requirement ${import_picocolors33.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded requirement ${import_picocolors34.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   requirement.command("update <id>").description(
@@ -10936,7 +11610,7 @@ ${row.body}`);
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated requirement ${import_picocolors33.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
+      ok(row, () => line(`Updated requirement ${import_picocolors34.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
     })
   );
 }
@@ -10975,7 +11649,7 @@ function toList(value) {
 }
 
 // src/commands/doc.ts
-var import_picocolors34 = __toESM(require_picocolors(), 1);
+var import_picocolors35 = __toESM(require_picocolors(), 1);
 
 // src/mermaid-fences.ts
 function hasDiagram(code) {
@@ -11062,16 +11736,16 @@ function registerDoc(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors34.default.dim("No documents yet."));
+          line(import_picocolors35.default.dim("No documents yet."));
           return;
         }
         for (const r of rows) {
-          const link = r.workItemId ? import_picocolors34.default.dim(` \u21B3 ${r.workItemId}`) : "";
-          const file = r.filePath ? import_picocolors34.default.dim(`  ${r.filePath}`) : "";
+          const link = r.workItemId ? import_picocolors35.default.dim(` \u21B3 ${r.workItemId}`) : "";
+          const file = r.filePath ? import_picocolors35.default.dim(`  ${r.filePath}`) : "";
           const tags = [...r.labels ?? [], ...r.infraRefs ?? []];
-          const meta = tags.length ? import_picocolors34.default.dim(`  [${tags.join(", ")}]`) : "";
-          const kind = r.docKind ? import_picocolors34.default.dim(`${r.docKind}  `) : "";
-          line(`${import_picocolors34.default.dim(r.id)}  ${kind}${r.title}${meta}${link}${file}`);
+          const meta = tags.length ? import_picocolors35.default.dim(`  [${tags.join(", ")}]`) : "";
+          const kind = r.docKind ? import_picocolors35.default.dim(`${r.docKind}  `) : "";
+          line(`${import_picocolors35.default.dim(r.id)}  ${kind}${r.title}${meta}${link}${file}`);
         }
       });
     })
@@ -11085,17 +11759,17 @@ function registerDoc(program3) {
       );
       if (opts.markdown) {
         ok({ id: row.id, title: row.title, filePath: row.filePath }, () => {
-          line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
+          line(`${import_picocolors35.default.bold(row.title)}  ${import_picocolors35.default.dim(row.id)}`);
           line(
-            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.")
+            row.filePath ? `Read it at ${import_picocolors35.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors35.default.dim("This document has no markdown mirror on disk yet.")
           );
         });
         return;
       }
       ok(row, () => {
-        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(`${import_picocolors35.default.bold(row.title)}  ${import_picocolors35.default.dim(row.id)}`);
+        if (row.workItemId) line(import_picocolors35.default.dim(`linked to work item ${row.workItemId}`));
+        if (row.filePath) line(import_picocolors35.default.dim(`markdown mirror: ${row.filePath}`));
         line("");
         line(row.contentJson);
       });
@@ -11128,7 +11802,7 @@ function registerDoc(program3) {
         refId: row?.id,
         output: { document: row }
       });
-      ok(row, () => line(`Created document ${import_picocolors34.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created document ${import_picocolors35.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   doc.command("file <id>").description("File an existing document \u2014 its kind, labels, app, infrastructure").option("--kind <kind>", `what this document IS \u2014 ${KIND_HELP2}`).option("--label <name...>", "tag it \u2014 shares the project's label vocabulary").option("--app <id>", "which app this document is about").option("--infra <name...>", "what it touches: database, storage, auth, \u2026").action(
@@ -11147,7 +11821,7 @@ function registerDoc(program3) {
         `/v1/projects/${projectId}/documents/${id}`,
         { method: "PATCH", body }
       );
-      ok(row, () => line(`Filed ${import_picocolors34.default.bold(row?.title ?? id)}.`));
+      ok(row, () => line(`Filed ${import_picocolors35.default.bold(row?.title ?? id)}.`));
     })
   );
   doc.command("diagram <id>").description(
@@ -11173,19 +11847,19 @@ function registerDoc(program3) {
         diagrams: diagrams.map((code) => ({ kind: diagramKind(code), code }))
       };
       ok(payload, () => {
-        line(`${import_picocolors34.default.bold(row.title)}  ${import_picocolors34.default.dim(row.id)}`);
+        line(`${import_picocolors35.default.bold(row.title)}  ${import_picocolors35.default.dim(row.id)}`);
         if (markdown === null) {
           line(
-            import_picocolors34.default.dim(
+            import_picocolors35.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_picocolors34.default.dim("No diagrams in this document."));
+          line(import_picocolors35.default.dim("No diagrams in this document."));
         } else {
           for (const [i, code] of diagrams.entries()) {
             const kind = diagramKind(code) ?? "diagram";
-            line(`${import_picocolors34.default.dim(String(i + 1))}  ${kind}  ${import_picocolors34.default.dim(`${code.split("\n").length} lines`)}`);
+            line(`${import_picocolors35.default.dim(String(i + 1))}  ${kind}  ${import_picocolors35.default.dim(`${code.split("\n").length} lines`)}`);
           }
         }
       });
@@ -11221,7 +11895,7 @@ function registerDoc(program3) {
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated document ${import_picocolors34.default.bold(row.id)} \u2014 ${row.title}`));
+      ok(row, () => line(`Updated document ${import_picocolors35.default.bold(row.id)} \u2014 ${row.title}`));
     })
   );
 }
@@ -11235,7 +11909,7 @@ function readMirror(cwd, filePath) {
 }
 
 // src/commands/design.ts
-var import_picocolors35 = __toESM(require_picocolors(), 1);
+var import_picocolors36 = __toESM(require_picocolors(), 1);
 function registerDesign(program3) {
   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(
@@ -11249,11 +11923,11 @@ function registerDesign(program3) {
       if (opts.raw) {
         ok(files, () => {
           if (!files.length) {
-            line(import_picocolors35.default.dim("No brand set for this project."));
+            line(import_picocolors36.default.dim("No brand set for this project."));
             return;
           }
           for (const f of files) {
-            line(import_picocolors35.default.bold(f.path));
+            line(import_picocolors36.default.bold(f.path));
             line(f.contents);
             line("");
           }
@@ -11270,21 +11944,21 @@ function registerDesign(program3) {
       } : { hasBrand: false, colors: {}, fonts: {}, brand: {}, files: [] };
       ok(summary, () => {
         if (!tokens) {
-          line(import_picocolors35.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
+          line(import_picocolors36.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_picocolors35.default.dim(name.padEnd(12))} ${value}`);
+          line(`${import_picocolors36.default.dim(name.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.color)) {
-          line(`${import_picocolors35.default.dim(`color.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors36.default.dim(`color.${name}`.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.font)) {
-          line(`${import_picocolors35.default.dim(`font.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors36.default.dim(`font.${name}`.padEnd(12))} ${value}`);
         }
         line("");
         line(
-          import_picocolors35.default.dim(
+          import_picocolors36.default.dim(
             `Generated into the working tree as ${files.map((f) => f.path).join(", ")} \u2014 wire those in, never edit them.`
           )
         );
@@ -11306,19 +11980,19 @@ function registerDesign(program3) {
       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}`);
+            line(`${import_picocolors36.default.green("\u2713")} ${shot.file} ${import_picocolors36.default.dim("\u2192")} ${shot.out}`);
           } else {
-            line(`${import_picocolors35.default.red("\u2717")} ${shot.file} ${import_picocolors35.default.dim(shot.error ?? "no image")}`);
+            line(`${import_picocolors36.default.red("\u2717")} ${shot.file} ${import_picocolors36.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`));
+          line(import_picocolors36.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(
+            import_picocolors36.default.dim(
               `Record each one so it shows up: workser artifact add <file>.png --kind design -d "<what this screen is>"`
             )
           );
@@ -11350,7 +12024,7 @@ function unwrap(group) {
 }
 
 // src/commands/api.ts
-var import_picocolors36 = __toESM(require_picocolors(), 1);
+var import_picocolors37 = __toESM(require_picocolors(), 1);
 import { readdirSync, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { join as join3, relative, sep } from "path";
 
@@ -11444,16 +12118,16 @@ function specReport(routes, documented) {
     ok: missing.length === 0
   };
 }
-function specSummary(report, specFile) {
+function specSummary(report2, specFile) {
   if (!specFile) {
     return `This service has no API description. Write one at ${SPEC_FILES[0]} listing the routes it serves.`;
   }
-  if (report.ok) {
-    const n = report.routes.length;
+  if (report2.ok) {
+    const n = report2.routes.length;
     return n === 1 ? `The one route this service has is described in ${specFile}.` : `All ${n} routes are described in ${specFile}.`;
   }
-  const names = report.missing.map((m) => m.path).join(", ");
-  return `${report.missing.length} route${report.missing.length === 1 ? " is" : "s are"} not described in ${specFile}: ${names}`;
+  const names = report2.missing.map((m) => m.path).join(", ");
+  return `${report2.missing.length} route${report2.missing.length === 1 ? " is" : "s are"} not described in ${specFile}: ${names}`;
 }
 
 // src/commands/api.ts
@@ -11464,10 +12138,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_picocolors36.default.dim(note));
+        for (const note of res?.notes ?? []) line(import_picocolors37.default.dim(note));
         for (const r of res?.requests ?? []) {
           line(
-            `${import_picocolors36.default.dim(r.method.padEnd(6))}${r.path}${r.note ? import_picocolors36.default.dim(`  ${r.note}`) : ""}`
+            `${import_picocolors37.default.dim(r.method.padEnd(6))}${r.path}${r.note ? import_picocolors37.default.dim(`  ${r.note}`) : ""}`
           );
         }
       });
@@ -11501,14 +12175,14 @@ function registerApi(program3) {
       );
       ok(res, () => {
         if (!res?.ok) {
-          line(import_picocolors36.default.red(res?.error ?? "The service did not answer."));
+          line(import_picocolors37.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_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}`)}`);
+        const colour2 = res.status && res.status < 300 ? import_picocolors37.default.green : res.status && res.status < 500 ? import_picocolors37.default.yellow : import_picocolors37.default.red;
+        line(`${colour2(code)}  ${import_picocolors37.default.dim(`${res.durationMs}ms  ${res.url}`)}`);
         if (res.body) line(res.body);
-        if (res.truncated) line(import_picocolors36.default.dim("(answer truncated)"));
+        if (res.truncated) line(import_picocolors37.default.dim("(answer truncated)"));
       });
       if (!res?.ok) process.exitCode = 1;
     })
@@ -11522,23 +12196,23 @@ function registerApi(program3) {
       const routes = discoverRoutes(files);
       const specFile = SPEC_FILES.find((f) => files.includes(f)) ?? null;
       const documented = specFile ? specPaths(readIfPresent(join3(ctx.cwd, specFile))) : [];
-      const report = specReport(routes, documented);
-      const summary = specSummary(report, specFile);
-      ok({ ...report, specFile, summary }, () => {
-        for (const r of report.routes) {
-          const known = report.missing.some((m) => m.path === r.path);
+      const report2 = specReport(routes, documented);
+      const summary = specSummary(report2, specFile);
+      ok({ ...report2, specFile, summary }, () => {
+        for (const r of report2.routes) {
+          const known = report2.missing.some((m) => m.path === r.path);
           line(
-            `${known ? import_picocolors36.default.yellow("undocumented") : import_picocolors36.default.green("documented  ")}  ${r.path}${import_picocolors36.default.dim(`  ${r.file}`)}`
+            `${known ? import_picocolors37.default.yellow("undocumented") : import_picocolors37.default.green("documented  ")}  ${r.path}${import_picocolors37.default.dim(`  ${r.file}`)}`
           );
         }
-        for (const p of report.stale) {
-          line(`${import_picocolors36.default.dim("in spec only ")}  ${p}`);
+        for (const p of report2.stale) {
+          line(`${import_picocolors37.default.dim("in spec only ")}  ${p}`);
         }
         line("");
-        if (report.ok && specFile) success(summary);
-        else line(import_picocolors36.default.yellow(summary));
+        if (report2.ok && specFile) success(summary);
+        else line(import_picocolors37.default.yellow(summary));
       });
-      if (opts.check && !report.ok) {
+      if (opts.check && !report2.ok) {
         throw new WorkserError(summary, { code: "bad_request" });
       }
       if (opts.check && !specFile) {
@@ -11607,7 +12281,7 @@ function listRepoFiles(root, maxDepth = 8) {
 }
 
 // src/commands/analysis.ts
-var import_picocolors37 = __toESM(require_picocolors(), 1);
+var import_picocolors38 = __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");
@@ -11617,14 +12291,14 @@ function registerAnalysis(program3) {
       const res = await api(ctx, path);
       ok(res, () => {
         line(
-          `${res?.available ? import_picocolors37.default.green("python") : import_picocolors37.default.red("python")}  ${res?.version ?? "not found"}  ${import_picocolors37.default.dim(res?.python ?? "")}`
+          `${res?.available ? import_picocolors38.default.green("python") : import_picocolors38.default.red("python")}  ${res?.version ?? "not found"}  ${import_picocolors38.default.dim(res?.python ?? "")}`
         );
         for (const lib of res?.libraries ?? []) {
           line(
-            `${lib.present ? import_picocolors37.default.green(lib.name) : import_picocolors37.default.yellow(lib.name)}${import_picocolors37.default.dim(lib.present ? "" : "  missing")}`
+            `${lib.present ? import_picocolors38.default.green(lib.name) : import_picocolors38.default.yellow(lib.name)}${import_picocolors38.default.dim(lib.present ? "" : "  missing")}`
           );
         }
-        for (const note of res?.notes ?? []) line(import_picocolors37.default.dim(note));
+        for (const note of res?.notes ?? []) line(import_picocolors38.default.dim(note));
       });
       if (!res?.available) process.exitCode = 1;
     })
@@ -11646,15 +12320,15 @@ function registerAnalysis(program3) {
       );
       ok(res, () => {
         if (res?.stdout) line(res.stdout.replace(/\n$/, ""));
-        if (res?.stderr) line(import_picocolors37.default.dim(res.stderr.replace(/\n$/, "")));
-        if (res?.truncated) line(import_picocolors37.default.dim("(output truncated)"));
+        if (res?.stderr) line(import_picocolors38.default.dim(res.stderr.replace(/\n$/, "")));
+        if (res?.truncated) line(import_picocolors38.default.dim("(output truncated)"));
         const took = `${Math.round((res?.durationMs ?? 0) / 100) / 10}s`;
         line(
-          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}`)
+          res?.ok ? import_picocolors38.default.green(`\u2713 ${res.summary ?? "It finished."}`) + import_picocolors38.default.dim(`  ${took}`) : import_picocolors38.default.yellow(res?.summary ?? "It did not finish.") + import_picocolors38.default.dim(`  ${took}`)
         );
         if (res && !res.sandboxed) {
           line(
-            import_picocolors37.default.dim(
+            import_picocolors38.default.dim(
               "This platform has no OS sandbox, so the script ran with your own file access."
             )
           );
@@ -11682,7 +12356,7 @@ function readCode(file, inline) {
 }
 
 // src/commands/scan.ts
-var import_picocolors38 = __toESM(require_picocolors(), 1);
+var import_picocolors39 = __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";
@@ -11840,15 +12514,15 @@ function buildReport(input) {
 function rank(s) {
   return s === "high" ? 3 : s === "medium" ? 2 : 1;
 }
-function scanSummary(report) {
-  const ran = report.checked.length;
+function scanSummary(report2) {
+  const ran = report2.checked.length;
   if (!ran) return "Nothing could be checked \u2014 see the reasons above.";
-  const what = report.checked.join(", ");
-  const total = report.findings.length;
+  const what = report2.checked.join(", ");
+  const total = report2.findings.length;
   if (!total) {
     return `Checked ${what} \u2014 nothing found.`;
   }
-  const high = report.counts.high;
+  const high = report2.counts.high;
   return `Checked ${what} \u2014 ${total} ${total === 1 ? "thing" : "things"} to look at` + (high ? `, ${high} of them serious.` : ".");
 }
 
@@ -11870,10 +12544,10 @@ function registerScan(program3) {
       if (only.has("secrets")) runSecrets(ctx.cwd, !!opts.staged, findings, checked, skipped);
       if (only.has("deps")) runDeps(ctx.cwd, findings, checked, skipped);
       if (only.has("permissions")) runPermissions(ctx.cwd, findings, checked, skipped);
-      const report = buildReport({ findings, checked, skipped });
-      const summary = scanSummary(report);
-      ok({ ...report, summary }, () => print2(report, summary));
-      if (opts.check && !report.ok) {
+      const report2 = buildReport({ findings, checked, skipped });
+      const summary = scanSummary(report2);
+      ok({ ...report2, summary }, () => print2(report2, summary));
+      if (opts.check && !report2.ok) {
         throw new WorkserError(summary, { code: "bad_request" });
       }
     })
@@ -11964,24 +12638,24 @@ function runPermissions(cwd, findings, checked, skipped) {
     });
   }
 }
-function print2(report, summary) {
-  for (const s of report.skipped) {
-    line(`${import_picocolors38.default.yellow("not checked")}  ${s.check}${import_picocolors38.default.dim(` \u2014 ${s.reason}`)}`);
+function print2(report2, summary) {
+  for (const s of report2.skipped) {
+    line(`${import_picocolors39.default.yellow("not checked")}  ${s.check}${import_picocolors39.default.dim(` \u2014 ${s.reason}`)}`);
   }
-  for (const f of report.findings) {
-    const where = f.file ? import_picocolors38.default.dim(`  ${f.file}${f.line ? `:${f.line}` : ""}`) : "";
+  for (const f of report2.findings) {
+    const where = f.file ? import_picocolors39.default.dim(`  ${f.file}${f.line ? `:${f.line}` : ""}`) : "";
     line(`${severityTag(f.severity)}  ${f.title}${where}`);
-    line(`             ${import_picocolors38.default.dim(f.fix)}`);
+    line(`             ${import_picocolors39.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_picocolors38.default.yellow(summary));
-  else line(import_picocolors38.default.red(summary));
+  if (report2.findings.length || report2.skipped.length) line("");
+  if (report2.ok && !report2.skipped.length) success(summary);
+  else if (report2.ok) line(import_picocolors39.default.yellow(summary));
+  else line(import_picocolors39.default.red(summary));
 }
 function severityTag(severity) {
-  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      ");
+  if (severity === "high") return import_picocolors39.default.red("serious    ");
+  if (severity === "medium") return import_picocolors39.default.yellow("worth fixing");
+  return import_picocolors39.default.dim("minor      ");
 }
 function git(cwd, args) {
   try {
@@ -12042,7 +12716,7 @@ function listRepoFiles2(root, maxDepth = 8) {
 }
 
 // src/commands/health.ts
-var import_picocolors39 = __toESM(require_picocolors(), 1);
+var import_picocolors40 = __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 }) => {
@@ -12056,16 +12730,16 @@ function registerHealth(program3) {
 }
 function print3(res) {
   if (!res?.checks?.length) {
-    line(import_picocolors39.default.dim(res?.note ?? "Nothing to check."));
+    line(import_picocolors40.default.dim(res?.note ?? "Nothing to check."));
     return;
   }
   for (const c of res.checks) {
-    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}`);
+    const mark = c.ok ? import_picocolors40.default.green("up  ") : import_picocolors40.default.red("down");
+    const timing = import_picocolors40.default.dim(`${c.ms}ms`);
+    const detail = c.ok ? timing : import_picocolors40.default.dim(`${c.error ?? "no answer"}${c.failures > 1 ? ` \xB7 ${c.failures} in a row` : ""}`);
+    line(`  ${mark}  ${c.appName} ${import_picocolors40.default.dim(`(${c.environment})`)}  ${c.url}  ${detail}`);
     if (c.incidentOpened) {
-      line(import_picocolors39.default.yellow(`        An incident has been opened on the board for this.`));
+      line(import_picocolors40.default.yellow(`        An incident has been opened on the board for this.`));
     }
   }
   const down = res.checks.filter((c) => !c.ok);
@@ -12078,14 +12752,14 @@ function print3(res) {
   }
   const production = down.filter((c) => c.environment === "production").length;
   line(
-    import_picocolors39.default.red(
+    import_picocolors40.default.red(
       `${down.length} of ${res.checks.length} not answering` + (production ? ` \u2014 ${production} customer-facing.` : " (preview only).")
     )
   );
 }
 
 // src/commands/urls.ts
-var import_picocolors40 = __toESM(require_picocolors(), 1);
+var import_picocolors41 = __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 }) => {
@@ -12099,20 +12773,20 @@ function registerUrls(program3) {
       const summary = urlsSummary(rows);
       ok({ rows, summary }, () => {
         for (const row of rows) {
-          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");
+          const label = import_picocolors41.default.dim(row.environment.padEnd(10));
+          const value = row.url ? import_picocolors41.default.cyan(row.url) : import_picocolors41.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_picocolors40.default.yellow(summary));
+        else line(import_picocolors41.default.yellow(summary));
       });
     })
   );
 }
 
 // src/commands/deployments.ts
-var import_picocolors41 = __toESM(require_picocolors(), 1);
+var import_picocolors42 = __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(
@@ -12130,7 +12804,7 @@ function registerDeployments(program3) {
       ok(res, () => {
         if (!items.length) {
           return line(
-            import_picocolors41.default.dim(
+            import_picocolors42.default.dim(
               environment ? `Nothing has been deployed to ${environment} yet.` : "Nothing has been deployed yet. `workser deploy` builds the first one."
             )
           );
@@ -12150,13 +12824,13 @@ function registerDeployments(program3) {
       ).catch(() => null) : null;
       ok({ ...dep, logs }, () => {
         line(formatDeployment(dep));
-        if (dep?.error_message) line(import_picocolors41.default.red(`  ${dep.error_message}`));
+        if (dep?.error_message) line(import_picocolors42.default.red(`  ${dep.error_message}`));
         const events = logs?.events ?? [];
         for (const e of events) {
-          line(`  ${import_picocolors41.default.dim(String(e.type ?? "log"))}  ${e.text ?? ""}`);
+          line(`  ${import_picocolors42.default.dim(String(e.type ?? "log"))}  ${e.text ?? ""}`);
         }
         if (opts.logs && !events.length) {
-          line(import_picocolors41.default.dim("  That build produced no output."));
+          line(import_picocolors42.default.dim("  That build produced no output."));
         }
       });
     })
@@ -12200,16 +12874,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_picocolors41.default.dim(`It will be at ${url}`));
-  line(import_picocolors41.default.dim("`workser deploy status` follows it."));
+  if (url) line(import_picocolors42.default.dim(`It will be at ${url}`));
+  line(import_picocolors42.default.dim("`workser deploy status` follows it."));
 }
 function formatDeployment(d) {
   if (!d) return "";
-  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 version = d.version !== void 0 ? import_picocolors42.default.yellow(`v${d.version}`) : import_picocolors42.default.dim("v?");
+  const env = import_picocolors42.default.dim((d.environment ?? "?").padEnd(10));
   const app = d.webAppName ? `${d.webAppName}  ` : "";
-  const when = import_picocolors41.default.dim(formatTime2(d.created_at));
-  const url = d.url ? "  " + import_picocolors41.default.cyan(d.url) : "";
+  const when = import_picocolors42.default.dim(formatTime2(d.created_at));
+  const url = d.url ? "  " + import_picocolors42.default.cyan(d.url) : "";
   return `${version}  ${env} ${colorStatus(d.status ?? "")}  ${app}${when}${url}`;
 }
 function formatTime2(t) {
@@ -12219,7 +12893,7 @@ function formatTime2(t) {
 }
 
 // src/commands/usage.ts
-var import_picocolors42 = __toESM(require_picocolors(), 1);
+var import_picocolors43 = __toESM(require_picocolors(), 1);
 
 // src/usage.ts
 var NEAR_LIMIT_FRACTION = 0.8;
@@ -12266,22 +12940,22 @@ function dimensionLine(d) {
   }
   return `${d.label}: ${used} of ${limit}`;
 }
-function usageSummary(report) {
-  const dims = report.dimensions ?? [];
+function usageSummary(report2) {
+  const dims = report2.dimensions ?? [];
   const unknown = dims.filter((d) => d.used === null);
   const over = dims.filter((d) => usageState(d) === "over");
   const near = dims.filter((d) => usageState(d) === "near");
   const parts = [];
   if (over.length) {
     parts.push(
-      `${over.length === 1 ? "One thing is" : `${over.length} things are`} over the ${report.tier} plan's limit`
+      `${over.length === 1 ? "One thing is" : `${over.length} things are`} over the ${report2.tier} plan's limit`
     );
   } else if (near.length) {
     parts.push(
-      `${near.length === 1 ? "One thing is" : `${near.length} things are`} close to the ${report.tier} plan's limit`
+      `${near.length === 1 ? "One thing is" : `${near.length} things are`} close to the ${report2.tier} plan's limit`
     );
   } else if (dims.some((d) => d.used !== null)) {
-    parts.push(`Everything is comfortably inside the ${report.tier} plan`);
+    parts.push(`Everything is comfortably inside the ${report2.tier} plan`);
   }
   if (unknown.length) {
     parts.push(
@@ -12291,8 +12965,8 @@ function usageSummary(report) {
   if (!parts.length) return "Nothing could be measured.";
   return `${parts.join("; ")}.`;
 }
-function shouldFail(report) {
-  return (report.dimensions ?? []).some(
+function shouldFail(report2) {
+  return (report2.dimensions ?? []).some(
     (d) => d.kind === "hard" && usageState(d) === "over"
   );
 }
@@ -12302,12 +12976,12 @@ function registerUsage(program3) {
   const usage = program3.command("usage").description("What this project and your plan are using \u2014 storage, projects, apps").action(
     action(async ({ ctx }) => {
       const projectId = requireProject(ctx);
-      const report = await api(
+      const report2 = await api(
         ctx,
         `/v1/projects/${projectId}/usage`
       );
-      ok(report, () => print4(report));
-      if (shouldFail(report)) process.exitCode = 1;
+      ok(report2, () => print4(report2));
+      if (shouldFail(report2)) process.exitCode = 1;
     })
   );
   usage.command("infra").description(
@@ -12332,15 +13006,15 @@ function printInfra(usage) {
   ];
   const width = Math.max(...rows.map(([label]) => label.length));
   for (const [label, dim, unit] of rows) {
-    const value = dim.value === null ? import_picocolors42.default.dim("not measured") : `${dim.value}${unit ? ` ${unit}` : ""}`;
-    const when = dim.live ? import_picocolors42.default.dim("now") : import_picocolors42.default.dim(`through ${shortDay(dim.asOf)}`);
+    const value = dim.value === null ? import_picocolors43.default.dim("not measured") : `${dim.value}${unit ? ` ${unit}` : ""}`;
+    const when = dim.live ? import_picocolors43.default.dim("now") : import_picocolors43.default.dim(`through ${shortDay(dim.asOf)}`);
     line(`  ${label.padEnd(width)}  ${value}  ${when}`);
   }
   const stale = rows.find(([, dim]) => !dim.live && dim.nextUpdate);
   if (stale) {
     line("");
     line(
-      import_picocolors42.default.dim(
+      import_picocolors43.default.dim(
         `Bandwidth is reported by the host in closed days, so it updates once a day \u2014 next around ${shortTime(
           stale[1].nextUpdate
         )}.`
@@ -12356,35 +13030,35 @@ function shortTime(iso) {
   const d = new Date(iso);
   return Number.isFinite(d.getTime()) ? `${d.toISOString().slice(11, 16)} UTC` : "\u2014";
 }
-function print4(report) {
-  const dims = report.dimensions ?? [];
+function print4(report2) {
+  const dims = report2.dimensions ?? [];
   if (!dims.length) {
-    return line(import_picocolors42.default.dim("Nothing to measure for this project yet."));
+    return line(import_picocolors43.default.dim("Nothing to measure for this project yet."));
   }
   const width = Math.max(...dims.map((d) => d.label.length));
   for (const d of dims) {
     line(`  ${colour(d)(dimensionLine(d).padEnd(0))}${gauge(d, width)}`);
   }
   line("");
-  const summary = usageSummary(report);
+  const summary = usageSummary(report2);
   const worst = dims.map(usageState);
-  if (worst.includes("over")) line(import_picocolors42.default.red(summary));
+  if (worst.includes("over")) line(import_picocolors43.default.red(summary));
   else if (worst.includes("near") || worst.includes("unknown"))
-    line(import_picocolors42.default.yellow(summary));
+    line(import_picocolors43.default.yellow(summary));
   else success(summary);
 }
 function gauge(d, _labelWidth) {
   const drawn = bar(d);
-  return drawn ? `  ${import_picocolors42.default.dim(drawn)}` : "";
+  return drawn ? `  ${import_picocolors43.default.dim(drawn)}` : "";
 }
 function colour(d) {
   switch (usageState(d)) {
     case "over":
-      return d.kind === "hard" ? import_picocolors42.default.red : import_picocolors42.default.yellow;
+      return d.kind === "hard" ? import_picocolors43.default.red : import_picocolors43.default.yellow;
     case "near":
-      return import_picocolors42.default.yellow;
+      return import_picocolors43.default.yellow;
     case "unknown":
-      return import_picocolors42.default.dim;
+      return import_picocolors43.default.dim;
     default:
       return (s) => s;
   }
@@ -12392,7 +13066,7 @@ function colour(d) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.6.27" : "0.0.0-dev"
+  version: true ? "0.6.29" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(
@@ -12438,6 +13112,7 @@ registerCheckpoint(program2);
 registerSync(program2);
 registerWorkflow(program2);
 registerConnection(program2);
+registerChannels(program2);
 registerTool(program2);
 registerMemory(program2);
 registerNote(program2);