@huynle/hub 0.11.0 → 0.11.1

package/packages/cli/dist/hub-cli.js

@@ -7,7 +7,7 @@ import { createInterface } from "readline";
 // packages/cli/package.json
 var package_default = {
   name: "@huynle/hub-cli",
-  version: "0.11.0",
+  version: "0.11.1",
   private: true,
   description: "The hub CLI (`hub` / `hubctl`) for agents and scripts (internal; bundled into @huynle/hub, not published on its own).",
   license: "MIT",
@@ -306,6 +306,12 @@ function showText(s) {
   if (s.roles?.length)
     field("roles", s.roles.map((r) => `@${at(r)}`).join(" "));
   field("now", s.now);
+  if (s.health && s.health.kind !== "ok") {
+    const h = s.health;
+    const reset = typeof h.resetAt === "number" && Number.isFinite(h.resetAt) && Math.abs(h.resetAt) <= 8640000000000000 ? new Date(h.resetAt).toISOString() : undefined;
+    const facts = [h.kind, reset ? `resets ${reset}` : undefined, h.attempt !== undefined ? `attempt ${h.attempt}` : undefined].filter(Boolean).join(", ");
+    field("health", h.detail ? `${facts} — ${oneLine(h.detail, 200)}` : facts);
+  }
   if (s.children)
     field("subagents", s.children);
   if (s.online === false && s.lastSeen !== undefined)
@@ -419,6 +425,74 @@ function parseAddress(addr) {
   const scope = project ? { project } : {};
   return role ? { kind: "role", role: match[1], ...scope } : { kind: "name", name: match[1], ...scope };
 }
+// packages/sdk/src/ask-fields.ts
+var URGENCIES = ["low", "normal", "high"];
+var TIERS = ["confirm", "tap"];
+var KINDS = ["question", "plan", "merge", "release"];
+var DECISION_ASK_PROPERTIES = {
+  options: {
+    type: "array",
+    items: { type: "object", properties: { id: { type: "string" }, label: { type: "string" }, safe: { type: "boolean" } }, required: ["id", "label"] },
+    description: "ask @me: buttons the user taps, [{id, label, safe?}] (at most 8; id: lowercase letters, digits, - or _)."
+  },
+  recommendation: {
+    type: "object",
+    properties: { option: { type: "string" }, why: { type: "string" } },
+    required: ["option"],
+    description: "ask @me: the option you recommend ({option: an option id, why})."
+  },
+  urgency: { type: "string", enum: [...URGENCIES], description: "ask @me: low, normal (default) or high." },
+  tier: { type: "string", enum: [...TIERS], description: "ask @me: confirm (default: any of the user's devices) or tap (only the signed-in console)." },
+  kind: { type: "string", enum: [...KINDS], description: "ask @me: what it is about: question (default), plan, merge or release." },
+  choices: {
+    type: "array",
+    items: {
+      type: "object",
+      properties: {
+        id: { type: "string" },
+        label: { type: "string" },
+        options: { type: "array", items: { type: "object", properties: { id: { type: "string" }, label: { type: "string" }, recommended: { type: "boolean" } }, required: ["id", "label"] } }
+      },
+      required: ["id", "label", "options"]
+    },
+    description: 'ask @me: several points in one ask, instead of options: [{id: "D1", label, options: [{id, label, recommended?}]}], 1–12 groups of 2–6 options, at most one recommended each; the user picks one option per group and you get one "D1: label [a]" line per group.'
+  }
+};
+var DECISION_ASK_FIELDS = Object.keys(DECISION_ASK_PROPERTIES);
+var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function decisionAskFields(args) {
+  const out = {};
+  const { options, recommendation, urgency, tier, kind, choices } = args;
+  const objects = (value, field, shape) => {
+    if (!Array.isArray(value) || !value.every(isObject))
+      throw new Error(`"${field}" must be a list of ${shape}`);
+    return value;
+  };
+  if (options !== undefined)
+    out.options = objects(options, "options", "{id, label, safe?}");
+  if (recommendation !== undefined) {
+    if (!isObject(recommendation) || typeof recommendation.option !== "string")
+      throw new Error(`"recommendation" must be {option, why?}`);
+    out.recommendation = recommendation;
+  }
+  const oneOf = (value, field, allowed) => {
+    if (value === undefined)
+      return;
+    if (typeof value !== "string" || !allowed.includes(value))
+      throw new Error(`"${field}" is one of ${allowed.join(", ")}`);
+    out[field] = value;
+  };
+  oneOf(urgency, "urgency", URGENCIES);
+  oneOf(tier, "tier", TIERS);
+  oneOf(kind, "kind", KINDS);
+  if (choices !== undefined) {
+    const shape = "{id, label, options: [{id, label, recommended?}]}";
+    for (const group of objects(choices, "choices", shape))
+      objects(group.options, "choices", shape);
+    out.choices = choices;
+  }
+  return out;
+}
 // packages/sdk/src/errors.ts
 class HubError extends Error {
   status;
@@ -843,7 +917,7 @@ var segment = (value) => encodeURIComponent(value).replace(/%40/g, "@");
 var bareRole = (role) => role.replace(/^@@/, "");
 var decisionFields = (options) => {
   const out = {};
-  for (const key of ["options", "recommendation", "urgency", "tier", "deadline", "onTimeout", "about"])
+  for (const key of ["options", "recommendation", "choices", "kind", "urgency", "tier", "deadline", "onTimeout", "about"])
     if (options[key] !== undefined)
       out[key] = options[key];
   return out;
@@ -852,6 +926,7 @@ var whyField = (options) => options.why !== undefined ? { why: options.why } : {
 var signalOf = (options) => options.signal ? { signal: options.signal } : {};
 var idempotent = (options) => ({ ...signalOf(options), ...options.idempotencyKey ? { headers: { "idempotency-key": options.idempotencyKey } } : {} });
 var sendFields = (options) => ({
+  ...options.item !== undefined ? { item: options.item } : {},
   ...options.wake !== undefined ? { wake: options.wake } : {},
   ...options.urgent !== undefined ? { urgent: options.urgent } : {},
   ...options.notAfter !== undefined ? { notAfter: options.notAfter } : {}
@@ -1200,7 +1275,7 @@ class HubClient {
 // packages/sdk/src/envelope.ts
 var LABEL_MAX = 120;
 var ANSI = /\u001b\[[0-?]*[ -/]*[@-~]|\u001b\][^\u0007\u001b]*(?:\u0007|\u001b\\)?|\u001b[P^_][^\u001b]*(?:\u001b\\)?|\u001b[ -/]*[0-~]?|\u009b[0-?]*[ -/]*[@-~]/g;
-var CONTROL = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u061c\u200b-\u200f\u2028-\u202e\u2060-\u206f\ufeff]/g;
+var CONTROL = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u061c\u200b-\u200f\u2028-\u202e\u2060-\u206f\ufeff\p{Cf}]/gu;
 function sanitizeText(text) {
   return text.replace(/\r\n?/g, `
 `).replace(ANSI, "").replace(CONTROL, "");
@@ -1247,13 +1322,16 @@ function renderEnvelope(input) {
 var WAKE_SKIP_TEXT = {
   wake_false: "sent without a wake",
   subagent: "subagents are never woken",
-  hop_cap: "hop limit reached (8 agent messages without a human turn)",
-  budget: "wake budget spent (30 per 10 minutes)"
+  hop_cap: "hop limit reached (too many agent messages without a human turn)",
+  budget: "wake budget spent",
+  item_budget: "item wake budget spent",
+  item_loop: "this pair is looping on the item without progress; the user decides"
 };
-function wakeSkipNote({ delivery, woke, wakeSkipped }) {
+function wakeSkipNote({ delivery, woke, wakeSkipped, wakeLimit }) {
   if (woke !== false || !wakeSkipped || delivery === "steer" || delivery === "turn")
     return "";
-  return ` — wake skipped: ${WAKE_SKIP_TEXT[wakeSkipped] ?? wakeSkipped}`;
+  const detail = wakeLimit !== undefined && Number.isFinite(wakeLimit) && wakeLimit >= 1 ? wakeSkipped === "hop_cap" ? `hop limit reached (${wakeLimit} agent messages without a human turn)` : wakeSkipped === "budget" ? `wake budget spent (${wakeLimit} per 10 minutes)` : wakeSkipped === "item_budget" ? `item wake budget spent (${wakeLimit} wakes)` : undefined : undefined;
+  return ` — wake skipped: ${detail ?? WAKE_SKIP_TEXT[wakeSkipped] ?? wakeSkipped}`;
 }
 // packages/cli/src/http.ts
 var EXIT = {
@@ -4868,7 +4946,7 @@ function readConfig(file, machineName) {
     return defaults(machineName);
   }
 }
-var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function readRawConfig(file) {
   let text;
   try {
@@ -4884,7 +4962,7 @@ function readRawConfig(file) {
   } catch {
     parsed = undefined;
   }
-  if (!isObject(parsed))
+  if (!isObject2(parsed))
     throw new Error(`${file} is not a JSON object; fix or remove it first`);
   return parsed;
 }
@@ -5318,7 +5396,7 @@ class ProfileError extends RuntimeError {
     this.code = code;
   }
 }
-var isObject2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject3 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var show = (v) => JSON.stringify(v)?.slice(0, 80) ?? String(v);
 var builtinDefault = () => ({ name: DEFAULT_PROFILE, providers: [], endpoints: [], allowGitRemote: false });
 function egressHost(v) {
@@ -5342,7 +5420,7 @@ function egressEndpoint(v) {
       return;
     host = v.slice(0, colon);
     port = Number(v.slice(colon + 1));
-  } else if (isObject2(v)) {
+  } else if (isObject3(v)) {
     host = v.host;
     port = v.port;
   }
@@ -5399,9 +5477,9 @@ function normalizeOpenShellProfiles(raw) {
   const problems = [];
   const profiles = { [DEFAULT_PROFILE]: builtinDefault() };
   const unsupported = {};
-  if (raw !== undefined && !isObject2(raw))
+  if (raw !== undefined && !isObject3(raw))
     problems.push("openshell.profiles must be an object of profile name to profile");
-  let entries = Object.entries(isObject2(raw) ? raw : {});
+  let entries = Object.entries(isObject3(raw) ? raw : {});
   if (entries.length > PROFILES_MAX) {
     problems.push(`openshell.profiles: at most ${PROFILES_MAX} profiles; the rest are ignored`);
     entries = entries.slice(0, PROFILES_MAX);
@@ -5411,7 +5489,7 @@ function normalizeOpenShellProfiles(raw) {
       problems.push(`openshell.profiles: ${show(name)} is not a profile name (lowercase letters, digits, . _ -; at most ${NAME_MAX})`);
       continue;
     }
-    if (!isObject2(value)) {
+    if (!isObject3(value)) {
       problems.push(`openshell.profiles.${name} must be an object`);
       continue;
     }
@@ -5845,7 +5923,7 @@ var HARNESS = /^[a-z0-9][a-z0-9._-]{0,63}$/;
 function nodeConfigPath(env = process.env, home = homedir2()) {
   return path9.join(path9.dirname(configPath(env, home)), NODE_CONFIG_FILE);
 }
-var isObject3 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject4 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var whole = (v, min, max) => typeof v === "number" && Number.isInteger(v) && v >= min && v <= max;
 var show2 = (v) => JSON.stringify(v)?.slice(0, 80) ?? String(v);
 function configPathOf(raw, options) {
@@ -5867,7 +5945,7 @@ var isRoot = (p) => p === "/" || /^[A-Z]:\/$/.test(p);
 function normalizeNodeConfig(raw, options = {}) {
   const problems = [];
   let r = {};
-  if (isObject3(raw))
+  if (isObject4(raw))
     r = raw;
   else if (raw !== undefined)
     problems.push("node.json must hold a JSON object");
@@ -5959,7 +6037,7 @@ function loopbackOrigin(raw) {
   return url.origin;
 }
 function normalizeOpenCode(raw, problems, options) {
-  if (!isObject3(raw)) {
+  if (!isObject4(raw)) {
     problems.push("opencode must be an object");
     return;
   }
@@ -5970,7 +6048,7 @@ function normalizeOpenCode(raw, problems, options) {
   const list = Array.isArray(raw.servers) ? raw.servers : [];
   list.forEach((entry, i) => {
     const field = `opencode.servers[${i}]`;
-    if (!isObject3(entry))
+    if (!isObject4(entry))
       return void problems.push(`${field} must be an object {url, passwordFile, directories?}`);
     const url = loopbackOrigin(entry.url);
     if (!url)
@@ -5998,7 +6076,7 @@ function normalizeOpenCode(raw, problems, options) {
   return { ...directories ? { directories } : {}, servers, ...timeoutSeconds !== undefined ? { timeoutSeconds } : {} };
 }
 function normalizeHarnesses(raw, problems) {
-  if (!isObject3(raw)) {
+  if (!isObject4(raw)) {
     problems.push("harnesses must be an object of harness names to true or false");
     return;
   }
@@ -6014,7 +6092,7 @@ function normalizeHarnesses(raw, problems) {
   return out;
 }
 function normalizeOpenShell(raw, problems) {
-  if (!isObject3(raw)) {
+  if (!isObject4(raw)) {
     problems.push("openshell must be an object");
     return;
   }
@@ -6256,10 +6334,13 @@ var DECISION_FLAGS = {
   deadline: "string",
   "on-timeout": "string",
   tier: "string",
-  about: "multi"
+  about: "multi",
+  choice: "multi",
+  kind: "string"
 };
-var URGENCIES = ["low", "normal", "high"];
-var TIERS = ["confirm", "tap"];
+var URGENCIES2 = ["low", "normal", "high"];
+var KINDS2 = ["question", "plan", "merge", "release"];
+var TIERS2 = ["confirm", "tap"];
 var STATES = ["open", "answered", "expired", "closed"];
 var DECISION_STATES = STATES;
 function optionArg(value) {
@@ -6275,6 +6356,37 @@ function optionArg(value) {
     throw new UsageError(`--option ${id}: the label is empty`);
   return { id, label, ...safe ? { safe: true } : {} };
 }
+function choiceArg(value) {
+  const usage = `--choice takes GROUP=Label:a=Option*,b=Option (got "${value}")`;
+  const eq = value.indexOf("=");
+  if (eq <= 0)
+    throw new UsageError(usage);
+  const id = value.slice(0, eq);
+  const rest = value.slice(eq + 1);
+  let split = -1;
+  for (let i = rest.lastIndexOf(":");i >= 0; i = rest.lastIndexOf(":", i - 1)) {
+    if (/^[^=,:\s][^=,:]*=/.test(rest.slice(i + 1))) {
+      split = i;
+      break;
+    }
+  }
+  if (split < 0)
+    throw new UsageError(usage);
+  const label = rest.slice(0, split);
+  if (!label.trim())
+    throw new UsageError(`--choice ${id}: the label is empty`);
+  const options = rest.slice(split + 1).split(",").map((option) => {
+    const at = option.indexOf("=");
+    if (at <= 0)
+      throw new UsageError(usage);
+    const recommended = option.endsWith("*");
+    const text = option.slice(at + 1, recommended ? -1 : undefined);
+    if (!text.trim())
+      throw new UsageError(`--choice ${id}: option ${option.slice(0, at)} has an empty label`);
+    return { id: option.slice(0, at), label: text, ...recommended ? { recommended: true } : {} };
+  });
+  return { id, label, options };
+}
 var oneOf2 = (value, allowed, flag) => {
   if (value !== undefined && !allowed.includes(value))
     throw new UsageError(`${flag} is one of ${allowed.join(", ")}`);
@@ -6291,13 +6403,19 @@ function decisionOptions(flags, to) {
   if (why !== undefined && recommend === undefined)
     throw new UsageError("--why explains --recommend");
   const deadline = str(flags, "deadline");
-  const urgency = oneOf2(str(flags, "urgency"), URGENCIES, "--urgency");
-  const tier = oneOf2(str(flags, "tier"), TIERS, "--tier");
+  const urgency = oneOf2(str(flags, "urgency"), URGENCIES2, "--urgency");
+  const tier = oneOf2(str(flags, "tier"), TIERS2, "--tier");
   const onTimeout = str(flags, "on-timeout");
   const options = flags.option;
   const about = flags.about;
+  const choices = flags.choice;
+  if (choices && options)
+    throw new UsageError("--choice and --option don't mix: give one or the other");
+  const kind = oneOf2(str(flags, "kind"), KINDS2, "--kind");
   return {
     ...options ? { options: options.map(optionArg) } : {},
+    ...choices ? { choices: choices.map(choiceArg) } : {},
+    ...kind ? { kind } : {},
     ...recommend !== undefined ? { recommendation: { option: recommend, ...why !== undefined ? { why } : {} } } : {},
     ...urgency ? { urgency } : {},
     ...tier ? { tier } : {},
@@ -6311,6 +6429,10 @@ function stateArg(value) {
 }
 var iso2 = (ms) => new Date(ms).toISOString().replace(/\.\d{3}Z$/, "Z");
 function choicesText(decision) {
+  if (decision.choices?.length) {
+    return decision.choices.map((g) => `${g.id} ${oneLine(g.label, 120)}: ${g.options.map((o) => `${o.id} ${oneLine(o.label, 80)}${o.recommended ? " (recommended)" : ""}`).join(" · ")}`).join(`
+  `);
+  }
   const options = decision.options.map((o) => `${o.id} ${oneLine(o.label, 80)}${o.safe ? " (safe)" : ""}`).join(" · ");
   const r = decision.recommendation;
   const recommended = r ? `recommended: ${r.option}${r.why ? ` (${oneLine(r.why, 200)})` : ""}` : "";
@@ -6319,7 +6441,8 @@ function choicesText(decision) {
 function stateText(decision) {
   if (decision.state === "answered") {
     const a = decision.answer;
-    return `answered${a?.option ? ` ${a.option}` : ""}${a?.answeredBy === "timeout" ? " (timeout)" : ""}`;
+    const picks = a?.picks ? ` ${Object.entries(a.picks).map(([group, option]) => `${group}=${option}`).join(" ")}` : "";
+    return `answered${a?.option ? ` ${a.option}` : ""}${picks}${a?.answeredBy === "timeout" ? " (timeout)" : ""}`;
   }
   if (decision.state === "open" && decision.deadline !== undefined)
     return `open (deadline ${iso2(decision.deadline)})`;
@@ -6496,7 +6619,7 @@ class ToolArgError extends Error {
 
 // packages/cli/src/artifacts-mcp.ts
 var MCP_INLINE_TEXT_BYTES = 256 * 1024;
-var KINDS = ["markdown", "code", "image", "table", "chart", "dashboard", "html", "app", "file"];
+var KINDS3 = ["markdown", "code", "image", "table", "chart", "dashboard", "html", "app", "file"];
 var DEFAULT_MEDIA = { markdown: "text/markdown", html: "text/html", table: "text/csv", chart: "application/json", dashboard: "application/json" };
 var PATH3 = "/api/agent/artifacts";
 var STRING = { type: "string" };
@@ -6592,7 +6715,7 @@ var artifactTools = [
     description: "Create a persistent artifact with its first revision from small inline text or references to staged bytes. Needs scope artifacts:write for an app token.",
     properties: {
       title: STRING,
-      kind: { type: "string", enum: KINDS },
+      kind: { type: "string", enum: KINDS3 },
       description: STRING,
       visibility: { type: "string", enum: ["private", "workspace"] },
       workspaceID: STRING,
@@ -6604,8 +6727,8 @@ var artifactTools = [
     run: async (hub, args, signal) => {
       const title = need(args, "title");
       const kind = need(args, "kind");
-      if (!KINDS.includes(kind))
-        throw new ToolArgError(`"kind" must be one of ${KINDS.join(", ")}`);
+      if (!KINDS3.includes(kind))
+        throw new ToolArgError(`"kind" must be one of ${KINDS3.join(", ")}`);
       const body = files(args, kind);
       const description = optional2(args, "description");
       const visibility = optional2(args, "visibility");
@@ -6640,7 +6763,7 @@ var STRING2 = { type: "string" };
 var ID3 = { type: "string", description: "The artifact's ID (art_…)." };
 var JOB = { type: "string", description: "The job's ID (job_…)." };
 var REVISION = { type: "integer", description: "The job revision you read (from artifact_job)." };
-var KINDS2 = ["ask", "propose-edit", "run-action"];
+var KINDS4 = ["ask", "propose-edit", "run-action"];
 var need2 = (args, key) => {
   const value = args[key];
   if (typeof value !== "string" || !value.trim())
@@ -6717,7 +6840,7 @@ var artifactJobTools = [
       id: ID3,
       baseRevisionID: { type: "string", description: "The revision the job is about (propose-edit: the latest)." },
       instruction: { type: "string", description: "What to do (plain text, at most 8000 characters)." },
-      kind: { type: "string", enum: KINDS2 },
+      kind: { type: "string", enum: KINDS4 },
       action: { type: "string", description: "run-action: one of the artifact's declared actions." },
       machine: { type: "string", description: "Launch a handler session on this machine…" },
       repo: { type: "string", description: "…in this absolute repository path." },
@@ -6732,8 +6855,8 @@ var artifactJobTools = [
     readOnly: false,
     run: async (hub, args, signal) => {
       const kind = optional3(args, "kind");
-      if (kind && !KINDS2.includes(kind))
-        throw new ToolArgError(`"kind" must be one of ${KINDS2.join(", ")}`);
+      if (kind && !KINDS4.includes(kind))
+        throw new ToolArgError(`"kind" must be one of ${KINDS4.join(", ")}`);
       const action = optional3(args, "action");
       const apply = optional3(args, "apply");
       const key = optional3(args, "key");
@@ -6905,7 +7028,7 @@ function notAfterOf(args) {
   }
   throw new ToolArgError(`"notAfter" must be epoch milliseconds or an ISO 8601 date-time like 2027-01-15T12:00:00Z`);
 }
-var line4 = (i) => `${i.id}  ${i.status}${i.progress ? `/${i.progress}` : ""}  ${i.priority}  r${i.revision}  ${sanitizeText(i.title).replace(/\s+/g, " ")}`;
+var line4 = (i) => `${i.id}  ${i.status}${i.progress ? `/${i.progress}` : ""}  ${i.priority}  r${i.revision}  ${sanitizeText(i.title).replace(/\s+/g, " ")}${i.usage ? `  wakes ${i.usage.wakes}/${i.usage.budget.wakes} · ${i.usage.hours.toFixed(1)}/${i.usage.budget.hours}h` : ""}`;
 function intakeText(i) {
   const from = i.source.kind === "user" ? "the user" : i.source.kind === "app" ? `app ${i.source.tokenID}` : `session ${i.source.sessionID}`;
   return [
@@ -6919,7 +7042,8 @@ function intakeText(i) {
     ...i.criteria?.length ? ["done means:", ...i.criteria.map((c) => `- ${sanitizeText(c)}`)] : [],
     ...i.ref ? [`ref: ${sanitizeText(i.ref)}`] : [],
     ...i.reason ? [`reason: ${sanitizeText(i.reason)}`] : [],
-    ...i.lastError ? [`last routing error: ${i.lastError} (retried)`] : []
+    ...i.lastError ? [`last routing error: ${i.lastError} (retried)`] : [],
+    ...i.usage ? [`usage: ${i.usage.wakes}/${i.usage.budget.wakes} wakes · ${i.usage.hours.toFixed(1)}/${i.usage.budget.hours} hours (paused and blocked time counts)${i.usage.chargedTo ? `; last charged to ${i.usage.chargedTo}` : ""}`] : []
   ].join(`
 `);
 }
@@ -7189,7 +7313,7 @@ var STRINGS = { type: "array", items: STRING6 };
 var TEAM2 = { type: "string", description: "The team: its ID (team_…) or its name." };
 var REVISION2 = { type: "integer", minimum: 0, description: "The team's revision you read (team_show); a stale one answers conflict with the current revision." };
 var IDEMPOTENCY = { type: "string", description: "Idempotency-Key: the same key and arguments within 24 h answer the first result again." };
-var KINDS3 = { type: "array", items: { type: "string", enum: ["msg", "ask"] }, description: "What the path permits: msg and/or ask (replies to a permitted ask never need a path)." };
+var KINDS5 = { type: "array", items: { type: "string", enum: ["msg", "ask"] }, description: "What the path permits: msg and/or ask (replies to a permitted ask never need a path)." };
 var DIRECTION = { type: "string", enum: ["one-way", "two-way"], description: "two-way: `to` may also contact `from` with the same kinds." };
 var ROLE_FIELDS = {
   label: { ...STRING6, description: "A display label (confers no authority)." },
@@ -7202,12 +7326,14 @@ var ROLE_FIELDS = {
   maxMembers: { type: "integer", minimum: 1, maximum: 16 }
 };
 var ROLE = { type: "object", properties: { name: { ...STRING6, description: "A slug: lowercase letters, digits, dashes." }, ...ROLE_FIELDS }, required: ["name"] };
-var EDGE = { type: "object", properties: { from: STRING6, to: STRING6, kinds: KINDS3, direction: DIRECTION }, required: ["from", "to", "kinds", "direction"] };
+var EDGE = { type: "object", properties: { from: STRING6, to: STRING6, kinds: KINDS5, direction: DIRECTION }, required: ["from", "to", "kinds", "direction"] };
 var SPEC_FIELDS = {
   title: { ...STRING6, description: "1–120 characters." },
   description: STRING6,
   mode: { type: "string", enum: ["open", "restricted"], description: "open: every member may msg/ask every other member. restricted: only the drawn paths (edges)." },
-  hopLimit: { type: "integer", minimum: 1, maximum: 100, description: "Agent-only wake hop limit between this team's seats; may not exceed the hub-wide agents.hopLimit. Unset uses the global limit." },
+  hopLimit: { type: "integer", minimum: 1, maximum: 1e4, description: "Agent-only wake hop limit between this team's seats; at most the hub's hop ceiling (agent_limits hopCeiling, default 100). The effective limit is the lower of this and the hub-wide hopLimit. Unset uses the hub-wide limit." },
+  itemBudget: { type: "object", properties: { wakes: { type: "integer", minimum: 10, maximum: 5000 }, hours: { type: "integer", minimum: 1, maximum: 720 } }, required: ["wakes", "hours"], description: "User-only per-item budget override: agent wakes and hours in progress." },
+  loop: { type: "object", properties: { messages: { type: "integer", minimum: 4, maximum: 200 }, windowMinutes: { type: "integer", minimum: 5, maximum: 240 } }, required: ["messages", "windowMinutes"], description: "User-only no-progress pair-message threshold and window." },
   roles: { type: "array", items: ROLE, description: "1–32 roles." },
   entryRole: { ...STRING6, description: "The role that receives submitted work (e.g. pm) and supervises members." },
   edges: { type: "array", items: EDGE, description: "Communication paths between roles (restricted mode)." },
@@ -7332,6 +7458,8 @@ function specLines(spec) {
   return [
     `mode: ${spec.mode}${spec.mode === "open" ? " (every member may msg/ask every other)" : " (only the paths below)"}`,
     ...spec.hopLimit !== undefined ? [`hop limit: ${spec.hopLimit}`] : [],
+    ...spec.itemBudget ? [`item budget: ${spec.itemBudget.wakes} wakes, ${spec.itemBudget.hours} hours`] : [],
+    ...spec.loop ? [`loop: ${spec.loop.messages} messages per ${spec.loop.windowMinutes} minutes`] : [],
     `entry role: ${spec.entryRole}`,
     "roles:",
     ...spec.roles.map(role),
@@ -7501,7 +7629,7 @@ var teamTools = [
       need6(args, "name");
       need6(args, "title");
       const key = optional6(args, "idempotencyKey");
-      const spec = picked(args, ["name", "title", "description", "mode", "hopLimit", "roles", "entryRole", "edges", "tags", "metadata", "projects"]);
+      const spec = picked(args, ["name", "title", "description", "mode", "hopLimit", "itemBudget", "loop", "roles", "entryRole", "edges", "tags", "metadata", "projects"]);
       const { team, created } = await hub.teams.create({ ...spec, edges: spec.edges ?? [] }, { signal, ...key ? { idempotencyKey: key } : {} });
       return [`${created ? "created" : "already created (same key)"}: ${teamLine(team)}`, ...specLines(team)].join(`
 `);
@@ -7517,7 +7645,7 @@ var teamTools = [
     idempotent: true,
     run: async (hub, args, signal) => {
       const expectedRevision = revision(args);
-      const patch = picked(args, ["title", "description", "mode", "hopLimit", "roles", "entryRole", "edges", "tags", "metadata", "projects"]);
+      const patch = picked(args, ["title", "description", "mode", "hopLimit", "itemBudget", "loop", "roles", "entryRole", "edges", "tags", "metadata", "projects"]);
       if (Object.keys(patch).length === 0)
         throw new ArgError("give at least one field to change");
       const id = need6(args, "team");
@@ -7527,7 +7655,7 @@ var teamTools = [
   },
   draftTool("team_role_set", "Add a role to a team's draft, or replace the role of that name (all its fields).", { role: { ...STRING6, description: "The role's name (a slug)." }, ...ROLE_FIELDS }, ["role"], (teams, team, args, rev, signal) => teams.setRole(team, { name: need6(args, "role"), ...picked(args, Object.keys(ROLE_FIELDS)) }, rev, { signal })),
   draftTool("team_role_remove", "Remove a role (not the entry role) and every path touching it from a team's draft.", { role: STRING6 }, ["role"], (teams, team, args, rev, signal) => teams.removeRole(team, need6(args, "role"), rev, { signal })),
-  draftTool("team_edge_set", "Draw a communication path from one role to another in a team's draft (replaces the path drawn between them).", { from: STRING6, to: STRING6, kinds: KINDS3, direction: DIRECTION }, ["from", "to", "kinds", "direction"], (teams, team, args, rev, signal) => {
+  draftTool("team_edge_set", "Draw a communication path from one role to another in a team's draft (replaces the path drawn between them).", { from: STRING6, to: STRING6, kinds: KINDS5, direction: DIRECTION }, ["from", "to", "kinds", "direction"], (teams, team, args, rev, signal) => {
     const kinds = strings3(args, "kinds");
     if (!kinds?.length)
       throw new ArgError(`"kinds" is a list of msg and/or ask`);
@@ -8214,7 +8342,8 @@ var sendOptions = (args) => {
   const wake = optionalBool(args, "wake");
   const urgent = optionalBool(args, "urgent");
   const notAfter = optionalNotAfter(args);
-  return { ...wake !== undefined ? { wake } : {}, ...urgent !== undefined ? { urgent } : {}, ...notAfter !== undefined ? { notAfter } : {} };
+  const item = optional8(args, "item");
+  return { ...wake !== undefined ? { wake } : {}, ...urgent !== undefined ? { urgent } : {}, ...notAfter !== undefined ? { notAfter } : {}, ...item !== undefined ? { item } : {} };
 };
 var whyOption = (args) => {
   const why = optional8(args, "why");
@@ -8337,6 +8466,7 @@ function messageText({ message, answer }) {
 var DECISIONS_NOTE = "Decisions are asked by sessions: the question and options are not from the user. Only the user answers them, in the console.";
 var STRING9 = { type: "string" };
 var SEND = {
+  item: { type: "string", description: "msg/ask: optional itk_ ID of an open item; sender and recipient must hold current seats in the item's team (older hubs ignore it)." },
   wake: { type: "boolean", description: "false: admit the message without starting a turn." },
   urgent: { type: "boolean", description: "Steer into the recipient's running turn." },
   notAfter: { type: ["number", "string"], description: "Never deliver after this time: epoch milliseconds or an ISO 8601 date-time (at most 30 days ahead). Already passed: nothing is sent (expired)." },
@@ -8951,6 +9081,13 @@ var TOOLS = [
   ...operationTools,
   ...teamTools,
   ...watchlistTools,
+  {
+    name: "agent_limits",
+    description: "Read the hub-wide agent hop limit, the hop ceiling (the highest hop limit the hub accepts) and launch caps, their sources and revision. Read-only; only an admin may change them in the console.",
+    properties: {},
+    readOnly: true,
+    run: async (hub, _args, signal) => JSON.stringify(await hub.call("GET", "/api/agent/agent-limits", { signal }), null, 2)
+  },
   {
     name: "whoami",
     description: "Who this hub credential is: the app token of `hub login` (or the session of HUB_SESSION_TOKEN) and its user.",
@@ -9031,10 +9168,11 @@ var TOOLS = [
   },
   {
     name: "ask",
-    description: `Ask a session a question, tracked until answered, declined or expired. wait (at most ${WAIT_POLL_MAX_S} s) blocks for the answer; otherwise it shows up in the inbox tool.`,
+    description: `Ask a session a question, tracked until answered, declined or expired. wait (at most ${WAIT_POLL_MAX_S} s) blocks for the answer; otherwise it shows up in the inbox tool. To @me it opens a Decision for the user: give options (buttons) with a recommendation, or choices (several points in one ask), and urgency, tier and kind.`,
     properties: {
       to: TO,
       text: { ...STRING9, description: "The question." },
+      ...DECISION_ASK_PROPERTIES,
       wait: { type: "number", minimum: 0, maximum: WAIT_POLL_MAX_S, description: `Seconds to wait for the answer (0–${WAIT_POLL_MAX_S}).` },
       expires: { type: ["number", "string"], description: "When the ask expires: seconds, or 30s, 5m, 2h, 1d (1 minute to 7 days; default 24 h)." },
       ...SEND,
@@ -9047,7 +9185,13 @@ var TOOLS = [
       const text = need10(args, "text");
       const wait = optionalWait(args);
       const expires = optionalExpires(args);
-      const options = { ...sendOptions(args), ...expires !== undefined ? { expires } : {}, ...idemOption(args), signal };
+      let decision;
+      try {
+        decision = decisionAskFields(args);
+      } catch (cause) {
+        throw new ArgError3(cause.message);
+      }
+      const options = { ...sendOptions(args), ...expires !== undefined ? { expires } : {}, ...idemOption(args), ...decision, signal };
       if (optionalBool(args, "all")) {
         if (wait !== undefined)
           throw new ArgError3(`"wait" cannot be combined with "all"`);
@@ -9311,7 +9455,7 @@ var clean = (text, token) => {
 var toolResult = (text, isError) => ({ content: [{ type: "text", text }], isError });
 var ok2 = (id, result) => ({ jsonrpc: "2.0", id, result });
 var rpcError = (id, code, message) => ({ jsonrpc: "2.0", id, error: { code, message } });
-var isObject4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isObject5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isId = (value) => typeof value === "string" || typeof value === "number" && Number.isFinite(value);
 function createMcpServer(options) {
   const initialize = (params) => {
@@ -9326,7 +9470,7 @@ function createMcpServer(options) {
     if (!tool)
       return rpcError(id, RPC.invalidParams, typeof params.name === "string" ? `unknown tool: ${params.name}` : "params.name (the tool) is required");
     const args = params.arguments ?? {};
-    if (!isObject4(args))
+    if (!isObject5(args))
       return rpcError(id, RPC.invalidParams, "params.arguments must be an object");
     let token;
     const controller = new AbortController;
@@ -9357,7 +9501,7 @@ function createMcpServer(options) {
       inFlight.clear();
     },
     async handle(message) {
-      if (!isObject4(message))
+      if (!isObject5(message))
         return rpcError(null, RPC.invalidRequest, Array.isArray(message) ? "batches are not supported" : "not a JSON-RPC message");
       const hasId = "id" in message;
       const id = isId(message.id) ? message.id : null;
@@ -9368,12 +9512,12 @@ function createMcpServer(options) {
       if (typeof message.method !== "string")
         return rpcError(id, RPC.invalidRequest, "method must be a string");
       if (!hasId) {
-        notify(message.method, isObject4(message.params) ? message.params : {});
+        notify(message.method, isObject5(message.params) ? message.params : {});
         return;
       }
       if (!isId(message.id))
         return rpcError(null, RPC.invalidRequest, "id must be a string or a number");
-      const params = isObject4(message.params) ? message.params : {};
+      const params = isObject5(message.params) ? message.params : {};
       switch (message.method) {
         case "initialize":
           return ok2(id, initialize(params));
@@ -9692,7 +9836,7 @@ import { arch as osArch, platform as osPlatform } from "node:os";
 // packages/node/package.json
 var package_default2 = {
   name: "@huynle/hub-node",
-  version: "0.11.0",
+  version: "0.11.1",
   private: true,
   description: "`hub node`: the per-machine daemon that prepares, collects and cleans up launch workspaces (internal; shipped inside @huynle/hub, not published on its own).",
   license: "MIT",
@@ -11147,7 +11291,7 @@ import path14 from "node:path";
 // packages/runtime-openshell/package.json
 var package_default3 = {
   name: "@huynle/hub-runtime-openshell",
-  version: "0.11.0",
+  version: "0.11.1",
   private: true,
   description: "The `openshell` runtime of `hub node`: launches in NVIDIA OpenShell sandboxes, driven through the openshell CLI (internal; shipped inside @huynle/hub, not published on its own).",
   license: "MIT",
@@ -12887,7 +13031,7 @@ function ask(socketPath, req, options = {}) {
 var ENV_NAME3 = /^[A-Z_][A-Z0-9_]*$/;
 var DROPPED = ["tool_response"];
 var quote = (value) => `'${value.replace(/'/g, `'\\''`)}'`;
-var isObject5 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject6 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function flags(argv) {
   const rewake = argv.includes("--rewake");
   const at = argv.indexOf("--wait");
@@ -12925,16 +13069,16 @@ async function runHook(io) {
     const launch = io.env.HUB_CLAUDE_LAUNCH;
     const req = { v: WIRE_VERSION, kind: "hook", input: sent, ...launch ? { launch } : {}, ...rewake ? { rewake: true } : {}, ...waitMs !== undefined ? { waitMs } : {} };
     const reply = await ask(io.socketPath, req, io.timeoutMs !== undefined ? { timeoutMs: io.timeoutMs } : {});
-    if (!isObject5(reply))
+    if (!isObject6(reply))
       return 0;
-    if (isObject5(reply.env))
+    if (isObject6(reply.env))
       writeEnvFile(io.env.CLAUDE_ENV_FILE, reply.env);
     if (rewake && reply.exit === 2) {
       if (typeof reply.stderr === "string")
         io.stderr(reply.stderr);
       return 2;
     }
-    if (isObject5(reply.output))
+    if (isObject6(reply.output))
       io.stdout(`${JSON.stringify(reply.output)}
 `);
     return 0;
@@ -13828,7 +13972,7 @@ function ensurePrivateDir(dir) {
 import { Socket as Socket2 } from "node:net";
 var MCP_END = { hub: "end" };
 var ACT_TOOLS = new Set(["approve", "deny", "answer", "prompt", "stop"]);
-var isObject6 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject7 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function createMcpRouter(options) {
   const credentials = (pick, what) => () => {
     const sessionID = options.sessionID();
@@ -13841,9 +13985,9 @@ function createMcpRouter(options) {
   const act = createMcpServer({ version: options.version, credentials: credentials(options.actToken, "hub session act token") });
   return {
     async handle(message) {
-      if (isObject6(message) && message.method === "tools/call" && isObject6(message.params) && ACT_TOOLS.has(message.params.name))
+      if (isObject7(message) && message.method === "tools/call" && isObject7(message.params) && ACT_TOOLS.has(message.params.name))
         return act.handle(message);
-      if (isObject6(message) && !("id" in message))
+      if (isObject7(message) && !("id" in message))
         act.handle(message);
       return shell.handle(message);
     },
@@ -14687,9 +14831,10 @@ class ClaudeSessions {
     this.#settle(s, undefined, true);
     s.stopRequested = false;
     const detail = [input.error_details, input.error].find((v) => typeof v === "string" && v.length > 0) ?? "the turn failed";
+    const token = typeof input.error === "string" && /^[a-z][a-z0-9_]{0,40}$/.test(input.error) ? input.error : undefined;
     const turnID = s.turnID;
     s.busy = false;
-    this.#emit({ type: "session.execution.failed", data: { sessionID: s.hubID, ...turnID ? { turnID } : {}, error: { message: cut4(detail, HARNESS_ERROR_MAX) } } });
+    this.#emit({ type: "session.execution.failed", data: { sessionID: s.hubID, ...turnID ? { turnID } : {}, error: { message: cut4(detail, HARNESS_ERROR_MAX), ...token ? { type: `claude.${token}` } : {} } } });
     return {};
   }
   #child(s, input, start = true) {
@@ -15105,7 +15250,7 @@ import path23 from "node:path";
 // packages/claude-code/package.json
 var package_default4 = {
   name: "@huynle/hub-claude-code",
-  version: "0.11.0",
+  version: "0.11.1",
   private: true,
   description: "The Claude Code hooks spoke: per-user daemon, hook bridge, plugin dir, `hub claude` wrapper and daemon-backed MCP server (internal; shipped inside @huynle/hub, not published on its own).",
   license: "MIT",
@@ -15394,7 +15539,7 @@ import path26 from "node:path";
 // packages/preset/package.json
 var package_default5 = {
   name: "@huynle/hub-preset",
-  version: "0.11.0",
+  version: "0.11.1",
   private: true,
   description: "The preset spoke: drives a harness without a spoke of its own through a terminal pane (tmux), described by a data-only preset; official presets in presets/ (internal; shipped inside @huynle/hub, not published on its own).",
   license: "MIT",
@@ -15919,7 +16064,7 @@ import { openSync as openSync6, closeSync as closeSync6, readFileSync as readFil
 // packages/codex/package.json
 var package_default6 = {
   name: "@huynle/hub-codex",
-  version: "0.11.0",
+  version: "0.11.1",
   private: true,
   description: "The Codex app-server spoke: attaches to Codex's app-server (its own over stdio, and the shared daemon's socket when present), and the `hub codex` wrapper (internal; shipped inside @huynle/hub, not published on its own).",
   license: "MIT",
@@ -16269,6 +16414,12 @@ var DEFAULT_TITLE = "Codex session";
 var TOOL_ITEMS = new Set(["commandExecution", "fileChange", "mcpToolCall", "dynamicToolCall", "webSearch"]);
 var APPROVALS = { "item/commandExecution/requestApproval": "shell", "item/fileChange/requestApproval": "edit" };
 var RECENT_TURNS = 50;
+function codexErrorType(info) {
+  const name = typeof info === "string" ? info : isObj3(info) && Object.keys(info).length === 1 ? Object.keys(info)[0] : undefined;
+  if (!name || !/^[a-z][A-Za-z0-9]{0,40}$/.test(name))
+    return;
+  return `codex.${name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)}`;
+}
 var isObj3 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var str6 = (v) => typeof v === "string" && v !== "" ? v : undefined;
 var cut5 = (text, max) => text.length > max ? `${text.slice(0, max - 1)}…` : text;
@@ -16656,7 +16807,8 @@ class CodexSessions {
       return;
     const status = typeof turn.status === "string" ? turn.status : "completed";
     const error = isObj3(turn.error) && typeof turn.error.message === "string" ? cut5(turn.error.message, HARNESS_ERROR_MAX) : undefined;
-    const end = { status, ...error !== undefined ? { error } : {} };
+    const errorType = isObj3(turn.error) ? codexErrorType(turn.error.codexErrorInfo) : undefined;
+    const end = { status, ...error !== undefined ? { error } : {}, ...errorType !== undefined ? { errorType } : {} };
     if (thread.turnID === turnID)
       thread.turnID = undefined;
     thread.ended.set(turnID, end);
@@ -16669,7 +16821,7 @@ class CodexSessions {
     if (status === "interrupted")
       this.#emit({ type: "session.execution.interrupted", data });
     else if (status === "failed")
-      this.#emit({ type: "session.execution.failed", data: { ...data, ...error !== undefined ? { error: { message: error } } : {} } });
+      this.#emit({ type: "session.execution.failed", data: { ...data, ...error !== undefined ? { error: { message: error, ...end.errorType ? { type: end.errorType } : {} } } : {} } });
     else
       this.#emit({ type: "session.execution.succeeded", data });
     thread.items.clear();
@@ -18672,7 +18824,7 @@ function mergeConfigText(text, format, sets) {
       return txFail("manual_edit_required", `the config cannot be edited losslessly (${error instanceof Error ? error.message : "unreadable"}); make the edit by hand`);
     }
     const tree = toValue(current, cst);
-    if (!isObject7(tree))
+    if (!isObject8(tree))
       return txFail("conflict", "the config is not a JSON object");
     const changed = applySet(tree, set);
     if (!changed.ok)
@@ -18687,7 +18839,7 @@ function mergeConfigText(text, format, sets) {
   }
   return txOk(current);
 }
-var isObject7 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject8 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var same = (a, b) => canonicalJSON(a) === canonicalJSON(b);
 var clone = (v) => JSON.parse(JSON.stringify(v));
 function segments(pointer) {
@@ -18711,7 +18863,7 @@ function applySet(root, set) {
       if (index === undefined)
         return txFail("conflict", `${set.pointer}: no array element ${seg}`);
       next = current[index];
-    } else if (isObject7(current)) {
+    } else if (isObject8(current)) {
       next = Object.hasOwn(current, seg) ? current[seg] : undefined;
       if (next === undefined) {
         next = segs[i + 1] === "-" ? [] : {};
@@ -18739,7 +18891,7 @@ function applySet(root, set) {
     current[index] = value;
     return txOk(true);
   }
-  if (!isObject7(current))
+  if (!isObject8(current))
     return txFail("conflict", `${set.pointer}: the parent is not an object or array`);
   if (Object.hasOwn(current, last) && same(current[last], value))
     return txOk(false);
@@ -18908,7 +19060,7 @@ var LEGACY_PLUGIN_PACKAGE = "@huynle/opencode-voice";
 var HUB_MCP_NAME = "hub";
 var MCP_SUBCOMMAND = "mcp";
 var HUB_PROGRAMS = new Set(["hub", "hubctl"]);
-var isObject8 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject9 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var basename = (p) => p.slice(p.lastIndexOf("/") + 1);
 var WINDOWS_PATH = /^[A-Za-z]:[\\/]/;
 var programName = (p) => {
@@ -18943,12 +19095,12 @@ function classifyPluginSpec(spec) {
     return { source: "custom" };
   return;
 }
-var specOf = (entry) => typeof entry === "string" ? entry : isObject8(entry) && typeof entry.package === "string" ? entry.package : undefined;
+var specOf = (entry) => typeof entry === "string" ? entry : isObject9(entry) && typeof entry.package === "string" ? entry.package : undefined;
 var parse3 = (text) => {
   const parsed = parseJsonc(text);
   if (!parsed.ok)
     return txFail("manual_edit_required", `the OpenCode config cannot be edited losslessly (${parsed.message}); make the edit by hand`);
-  if (!isObject8(parsed.value))
+  if (!isObject9(parsed.value))
     return txFail("conflict", "the OpenCode config is not a JSON object");
   return txOk(parsed.value);
 };
@@ -18964,7 +19116,7 @@ function inspectPlugin(config, desired, findings) {
       const spec = specOf(entry);
       const kind = spec === undefined ? undefined : classifyPluginSpec(spec);
       if (kind)
-        found.push({ pointer: `/${key}/${i}`, spec, object: isObject8(entry), ...kind });
+        found.push({ pointer: `/${key}/${i}`, spec, object: isObject9(entry), ...kind });
     });
   }
   if (found.length === 0)
@@ -18995,17 +19147,17 @@ function inspectPlugin(config, desired, findings) {
   findings.push({ code: "plugin-drift", message: `the Hub plugin is pinned to ${entry.version}; it becomes ${pluginSpec(desired)}` });
   return txOk({ state: "drift", ...base, object: entry.object });
 }
-var isHubMcp = (server) => isObject8(server) && server.type === "local" && Array.isArray(server.command) && server.command.length === 2 && server.command.every((w) => typeof w === "string") && HUB_PROGRAMS.has(programName(server.command[0])) && server.command[1] === MCP_SUBCOMMAND;
+var isHubMcp = (server) => isObject9(server) && server.type === "local" && Array.isArray(server.command) && server.command.length === 2 && server.command.every((w) => typeof w === "string") && HUB_PROGRAMS.has(programName(server.command[0])) && server.command[1] === MCP_SUBCOMMAND;
 function inspectMcp(config, desired, findings) {
   const mcp = config.mcp;
   if (mcp === undefined)
     return txOk({ state: "absent" });
-  if (!isObject8(mcp))
+  if (!isObject9(mcp))
     return txFail("conflict", '"mcp" in the OpenCode config is not an object; fix it by hand');
   const servers = mcp.servers;
   if (servers === undefined)
     return txOk({ state: "absent" });
-  if (!isObject8(servers))
+  if (!isObject9(servers))
     return txFail("conflict", '"mcp.servers" in the OpenCode config is not an object; fix it by hand');
   const elsewhere = Object.entries(servers).find(([name, server]) => name !== HUB_MCP_NAME && isHubMcp(server));
   if (elsewhere)
@@ -26474,19 +26626,22 @@ Identity
   hub role release <role[.project]> [--session <addr>]
 
 Messaging (text "-" reads it from stdin)
-  hub msg <addr> "text" [--all] [--no-wake] [--urgent] [--not-after <ms|ISO time>] [--key K]
+  hub msg <addr> "text" [--all] [--no-wake] [--urgent] [--item itk_…] [--not-after <ms|ISO time>] [--key K]
                                       tell: fire and forget; --not-after: never delivered after that time
-  hub ask <addr> "text" [--wait [secs]] [--expires 2h] [--not-after <ms|ISO time>] [--all] [--no-wake] [--urgent] [--key K]
+  hub ask <addr> "text" [--wait [secs]] [--expires 2h] [--item itk_…] [--not-after <ms|ISO time>] [--all] [--no-wake] [--urgent] [--key K]
                                       tracked until answered, declined or expired; --wait alone waits until
                                       it expires; exit 0 answered, 1 declined or no answer yet, 8 expired;
                                       --key (Idempotency-Key): a retry with the same key and text answers
-                                      the first send again and sends nothing (24 h, per credential)
+                                      the first send again and sends nothing (24 h, per credential);
+                                      --item: open team intake item, both members seated (older hubs ignore it)
   hub reply <msgID> "text" [--no-wake]   goes to the real sender
   hub decline <msgID> --why "reason"
   hub ask @me "question" [--option id=label[:safe]]... [--recommend id [--why "…"]] [--urgency low|normal|high]
          [--deadline 2h [--on-timeout <safe id>]] [--tier confirm|tap] [--about <addr>]...
+         [--choice "D1=Label:a=Option*,b=Option"]... [--kind question|plan|merge|release]
                                       opens a Decision for the user (answered in the console; the answer
-                                      comes back as a reply); --on-timeout picks a safe option at the deadline
+                                      comes back as a reply); --on-timeout picks a safe option at the deadline;
+                                      --choice (instead of --option) asks several points, * marks the recommendation
   hub decisions list [--state open|answered|expired|closed]   the Decisions you asked
   hub inbox                           asks to answer, your open asks, recent messages, mutes
   hub mute <addr> · hub unmute <addr>    refuse (or accept again) messages from a session
@@ -26659,11 +26814,13 @@ var whyOf = (flags) => {
 var sendFlags = (flags) => {
   const notAfter = str(flags, "not-after");
   const key = str(flags, "key");
+  const item = str(flags, "item");
   return {
     ...flags["no-wake"] === true ? { wake: false } : {},
     ...flags.urgent === true ? { urgent: true } : {},
     ...notAfter === undefined ? {} : { notAfter: notAfterArg(notAfter, "--not-after") },
-    ...key !== undefined ? { idempotencyKey: key } : {}
+    ...key !== undefined ? { idempotencyKey: key } : {},
+    ...item !== undefined ? { item } : {}
   };
 };
 var nodeIo = (io) => ({
@@ -26787,7 +26944,7 @@ var COMMANDS = {
   },
   msg: {
     args: ["<addr>", "<text>"],
-    flags: { all: "bool", "no-wake": "bool", urgent: "bool", "not-after": "string", key: "string" },
+    flags: { all: "bool", "no-wake": "bool", urgent: "bool", "not-after": "string", item: "string", key: "string" },
     async handle(context) {
       const { flags, args } = context.parsed;
       const text = await textArg(args[1], context.io.stdin);
@@ -26799,7 +26956,7 @@ var COMMANDS = {
   },
   ask: {
     args: ["<addr>", "<text>"],
-    flags: { all: "bool", "no-wake": "bool", urgent: "bool", "not-after": "string", key: "string", expires: "string", wait: "optional", ...DECISION_FLAGS },
+    flags: { all: "bool", "no-wake": "bool", urgent: "bool", "not-after": "string", item: "string", key: "string", expires: "string", wait: "optional", ...DECISION_FLAGS },
     async handle(context) {
       const { flags, args } = context.parsed;
       const decision = decisionOptions(flags, args[0]);