@pitboss/cli 0.4.0 → 0.4.1

package/README.md

@@ -19,7 +19,7 @@ On the approval screen you pick:
 | Runtime | Files written |
 |---|---|
 | Claude Code | `.mcp.json` (server `pitboss`), `.claude/settings.local.json` (approves the server and installs the wake-up hooks) |
-| Cursor | `.cursor/mcp.json` (server `pitboss`), `.cursor/hooks.json` (stop hook), `.cursor/rules/pitboss.mdc` (wake-up rule) |
+| Cursor | `.cursor/mcp.json` (server `pitboss`), `.cursor/hooks.json` (stop + prompt hooks), `.cursor/rules/pitboss.mdc` (wake-up rule) |
 
 `.mcp.json` and `.cursor/mcp.json` hold a secret token. `join` adds every file it writes to `.git/info/exclude`, and refuses to write into a file git already tracks.
 
@@ -38,6 +38,8 @@ pitboss watch            # stream events until Ctrl-C (for a human watching a te
 
 `watch --once` reads the agent from the folder's `.mcp.json` or `.cursor/mcp.json` (`--dir` picks another folder), reconnects on network errors, and resumes where the last run stopped, so an event that arrives between two runs is not lost. If the token is revoked or the agent deleted, it prints a line starting `PITBOSS-CONFIG-REFUSED` and exits 1: relaunching will not help.
 
+After three failed relaunches the hooks go quiet so a refused or offline watcher cannot loop. A human prompt re-arms them; a background-command wake does not.
+
 ## Commands
 
 ```bash

package/dist/cli.js

@@ -18343,7 +18343,7 @@ async function taskCreateCommand(options) {
   if (options.reviewBy) {
     verifyKind = "reviewer_agent";
   } else if (options.verifyKind) {
-    if (!["shell", "file_exists", "thread_concluded", "reviewer_agent"].includes(options.verifyKind)) {
+    if (!["shell", "file_exists", "thread_concluded", "reviewer_agent", "human_approval"].includes(options.verifyKind)) {
       console.error(source_default.red(`Invalid --verify-kind "${options.verifyKind}".`));
       process.exit(1);
     }
@@ -19078,7 +19078,35 @@ function registerWatcher(dir, key) {
 
 // src/lib/runtimes.ts
 import { join as join3 } from "node:path";
-var RUNTIMES = ["claude", "cursor", "windsurf", "gemini", "copilot", "gpt", "mcp"];
+
+// ../../shared/types/src/index.ts
+var WORKER_TYPES = ["claude", "copilot", "cursor", "windsurf", "gemini", "gpt", "mcp", "human"];
+var WORKER_TYPE_LABELS = {
+  claude: "Claude Code",
+  copilot: "Copilot",
+  cursor: "Cursor",
+  windsurf: "Devin Desktop (formerly Windsurf)",
+  gemini: "Gemini",
+  gpt: "GPT",
+  mcp: "Other MCP client",
+  human: "Human"
+};
+var RUNTIMES = [
+  { value: "claude", label: WORKER_TYPE_LABELS.claude },
+  { value: "cursor", label: WORKER_TYPE_LABELS.cursor },
+  { value: "gemini", label: WORKER_TYPE_LABELS.gemini },
+  { value: "copilot", label: WORKER_TYPE_LABELS.copilot },
+  { value: "windsurf", label: WORKER_TYPE_LABELS.windsurf },
+  { value: "gpt", label: WORKER_TYPE_LABELS.gpt },
+  { value: "mcp", label: WORKER_TYPE_LABELS.mcp }
+];
+function isWorkerType(value) {
+  return typeof value === "string" && WORKER_TYPES.includes(value);
+}
+var DEFAULT_UNSTARTED_AFTER_MS = 4 * 60 * 60 * 1e3;
+
+// src/lib/runtimes.ts
+var RUNTIMES2 = RUNTIMES.map((r) => r.value);
 function runtimeTargets(workerType, { home, repo: repo2 }) {
   switch (workerType) {
     case "claude":
@@ -19135,7 +19163,7 @@ function dropLegacyPitbossEntry(config) {
   return { ...config, mcpServers: rest };
 }
 function allRuntimeTargets({ home, repo: repo2 }) {
-  const fromRuntimes = RUNTIMES.flatMap((w) => runtimeTargets(w, { home, repo: repo2 }));
+  const fromRuntimes = RUNTIMES2.flatMap((w) => runtimeTargets(w, { home, repo: repo2 }));
   return [.../* @__PURE__ */ new Set([...fromRuntimes, join3(home, ".claude.json")])];
 }
 function holdsRelaiToken(existing, token2) {
@@ -19415,7 +19443,6 @@ function sweepMissingWorkingDirs() {
 }
 
 // src/commands/invite.ts
-var WORKER_TYPES = ["claude", "copilot", "cursor", "windsurf", "gemini", "gpt", "mcp", "human"];
 var SPECIALIZATION_CHOICES = [
   { value: "writer", name: "writer        \u2014 implementation, code changes" },
   { value: "reviewer", name: "reviewer      \u2014 code review, PR feedback" },
@@ -19502,7 +19529,7 @@ async function loginCommand(opts) {
     process.exit(1);
   }
   if (opts.workerType !== void 0) {
-    if (!WORKER_TYPES.includes(opts.workerType)) {
+    if (!isWorkerType(opts.workerType)) {
       console.error(source_default.red(`--worker-type must be one of: ${WORKER_TYPES.join(", ")}`));
       process.exit(1);
     }
@@ -19728,18 +19755,26 @@ function claudeLocalSettings(existing, cli) {
   return {
     ...settings,
     enabledMcpjsonServers: servers.includes("pitboss") ? servers : [...servers, "pitboss"],
-    hooks: { ...hooks, SessionStart: withHook("SessionStart"), Stop: withHook("Stop") }
+    hooks: {
+      ...hooks,
+      SessionStart: withHook("SessionStart"),
+      Stop: withHook("Stop"),
+      UserPromptSubmit: withHook("UserPromptSubmit")
+    }
   };
 }
 function cursorHooks(existing, cli, dir) {
   const file = base(existing);
   const hooks = objectField(file, "hooks");
-  const stop = Array.isArray(hooks.stop) ? hooks.stop : [];
-  const command = `${cli} hook cursor-stop --dir ${shq(dir)}`;
+  const keep = (list) => (Array.isArray(list) ? list : []).filter((h) => !isOurs(h.command));
   return {
     version: 1,
     ...file,
-    hooks: { ...hooks, stop: [...stop.filter((h) => !isOurs(h.command)), { command, loop_limit: null }] }
+    hooks: {
+      ...hooks,
+      stop: [...keep(hooks.stop), { command: `${cli} hook cursor-stop --dir ${shq(dir)}`, loop_limit: null }],
+      beforeSubmitPrompt: [...keep(hooks.beforeSubmitPrompt), { command: `${cli} hook cursor-prompt --dir ${shq(dir)}` }]
+    }
   };
 }
 function cursorRule(cli, dir) {
@@ -20252,11 +20287,21 @@ function summarize(e, bodyChars = 80, agentId) {
       return `new thread: "${threadTitle}"`;
     case "thread.concluded":
       return `thread concluded: "${threadTitle}"`;
+    case "thread.message_ceiling": {
+      const count = e.payload.count;
+      const ceiling = e.payload.ceiling;
+      return `message ceiling on thread (${count ?? "?"}/${ceiling ?? "?"})`;
+    }
     case "agent.idle_unroutable": {
       const name = e.payload.agentName ?? e.targetId;
       const n = Array.isArray(e.payload.tasks) ? e.payload.tasks.length : 0;
       return `idle agent ${name} cannot take ${n} ready task(s)`;
     }
+    case "agent.unavailable": {
+      const name = e.payload.agentName ?? e.targetId;
+      const reason = e.payload.reason ?? "quota";
+      return `agent ${name} unavailable (${reason})`;
+    }
     default:
       return `${e.targetType} ${e.targetId}`;
   }
@@ -20276,7 +20321,8 @@ var KIND_STYLE = {
   "task.review_submitted": source_default.magenta,
   "task.review_overdue": source_default.yellow,
   "thread.created": source_default.cyan,
-  "thread.concluded": source_default.dim
+  "thread.concluded": source_default.dim,
+  "thread.message_ceiling": source_default.yellow
 };
 function clockOf(iso) {
   const d = new Date(iso);
@@ -20409,6 +20455,30 @@ async function watchCommand(options) {
 import { readFileSync as readFileSync10 } from "node:fs";
 import { join as join11 } from "node:path";
 var FOLLOWUP_CAP = 3;
+var CURSOR_BACKGROUND_TASK_PROMPT = "Briefly inform the user about the task result";
+var SYSTEM_REMINDER_ONLY = /^(?:<system-reminder>[\s\S]*?<\/system-reminder>\s*)+$/;
+function promptFromPayload(payload) {
+  try {
+    const p = JSON.parse(payload).prompt;
+    return typeof p === "string" ? p : null;
+  } catch {
+    return null;
+  }
+}
+function isHumanPrompt(prompt) {
+  if (prompt === null) return false;
+  const t = prompt.trim();
+  if (!t) return false;
+  if (t.includes("<task-notification>")) return false;
+  if (SYSTEM_REMINDER_ONLY.test(t)) return false;
+  if (t.includes(CURSOR_BACKGROUND_TASK_PROMPT)) return false;
+  if (t.includes("Your pitboss watcher is not running")) return false;
+  if (t.includes("The pitboss watcher is NOT RUNNING")) return false;
+  return true;
+}
+function maybeResetOnPrompt(payload, reset) {
+  if (isHumanPrompt(promptFromPayload(payload))) reset();
+}
 function wakeInstructions(watch, opening) {
   return `${opening}
 
@@ -20479,11 +20549,16 @@ function wakeStateFor(dir) {
   return {
     watcherAlive: () => watcherAlive(state, key),
     followups: followupCount(state, key),
-    asked: () => recordFollowup(state, key)
+    asked: () => recordFollowup(state, key),
+    reset: () => resetFollowups(state, key)
   };
 }
+function claudeEvent(raw) {
+  if (raw === "Stop" || raw === "UserPromptSubmit") return raw;
+  return "SessionStart";
+}
 function hookClaudeCommand(opts) {
-  const event = opts.event === "Stop" ? "Stop" : "SessionStart";
+  const event = claudeEvent(opts.event);
   const payload = readStdin();
   let cwd;
   try {
@@ -20494,6 +20569,10 @@ function hookClaudeCommand(opts) {
   const dir = process.env.CLAUDE_PROJECT_DIR || typeof cwd === "string" && cwd || process.cwd();
   const wake = wakeStateFor(dir);
   if (!wake) return;
+  if (event === "UserPromptSubmit") {
+    maybeResetOnPrompt(payload, wake.reset);
+    return;
+  }
   const out = claudeHookOutput(event, payload, { cli: pinnedCli(CLI_VERSION), dir, ...wake });
   if (out && event === "Stop") wake.asked();
   if (out) process.stdout.write(JSON.stringify(out));
@@ -20509,6 +20588,12 @@ function hookCursorStopCommand(opts) {
   if ("followup_message" in out) wake.asked();
   process.stdout.write(JSON.stringify(out));
 }
+function hookCursorPromptCommand(opts) {
+  const dir = opts.dir ?? process.cwd();
+  const wake = wakeStateFor(dir);
+  if (wake) maybeResetOnPrompt(readStdin(), wake.reset);
+  process.stdout.write("{}");
+}
 
 // src/commands/node.ts
 import { execFileSync as execFileSync6, spawn as spawnChild } from "node:child_process";
@@ -20545,6 +20630,7 @@ var BASE_TASK_LOOP = (agentId, repoPath) => `You are an AI worker agent (ID: ${a
    with \`toAgent\` set to the sender and no \`threadId\`. To check whether someone answered *you*,
    call \`mcp__relai__get_thread_messages\` on the \`threadId\` \`send_message\` gave you back \u2014 do not
    trawl the unread feed for it.
+   If \`mcp__relai__send_message\` returns 429, batch your updates into one message rather than retrying.
 
    **If you are stuck on something a colleague would know, ask one.** Call
    \`mcp__relai__list_agents\` to see who exists, pick by specialization or domain, prefer someone
@@ -21050,9 +21136,15 @@ import { spawn as spawn3 } from "child_process";
 import { join as join13 } from "path";
 
 // ../claude-worker/src/errors.ts
-var CREDENTIAL_PATTERNS = [
+var QUOTA_PATTERNS = [
   /credit balance is too low/i,
   /insufficient[ _-]?credits?/i,
+  /quota[ _-]?(?:exceeded|exhausted)/i,
+  /exceeded your (?:usage |rate )?quota/i,
+  /usage limit (?:reached|exceeded)/i,
+  /daily (?:limit|quota|cap)/i
+];
+var CREDENTIAL_PATTERNS = [
   /invalid[ _-]?(api[ _-]?key|x-api-key|bearer token)/i,
   /authentication[ _-]?error/i,
   /\bunauthorized\b/i,
@@ -21068,6 +21160,7 @@ var OVERFLOW_PATTERNS = [
 ];
 function classifySessionError(text) {
   if (!text) return "transient";
+  if (QUOTA_PATTERNS.some((re) => re.test(text))) return "quota";
   if (CREDENTIAL_PATTERNS.some((re) => re.test(text))) return "credentials";
   if (OVERFLOW_PATTERNS.some((re) => re.test(text))) return "overflow";
   return "transient";
@@ -21174,7 +21267,7 @@ var claudeAdapter = {
 };
 
 // ../claude-worker/src/adapters/index.ts
-var RUNTIMES2 = ["claude", "cursor"];
+var RUNTIMES3 = ["claude", "cursor"];
 var ADAPTERS = { claude: claudeAdapter, cursor: cursorAdapter };
 function getAdapter(runtime) {
   const adapter = ADAPTERS[runtime];
@@ -21182,6 +21275,9 @@ function getAdapter(runtime) {
   return adapter;
 }
 
+// ../claude-worker/src/unavailable.ts
+var DEFAULT_UNAVAILABLE_UNTIL_MS = 60 * 60 * 1e3;
+
 // ../claude-worker/src/config.ts
 var VALID_SPECIALIZATIONS = ["reviewer", "architect", "writer", "tester", "devops"];
 
@@ -21208,8 +21304,8 @@ function parseSpec(text, specDir) {
     const a = entry ?? {};
     if (typeof a.name !== "string" || !NAME.test(a.name)) throw new Error(`agents[${i}].name must be letters, digits, '.', '_' or '-'`);
     if (typeof a.worktree !== "string" || !a.worktree) throw new Error(`agents[${i}].worktree is required`);
-    if (!RUNTIMES2.includes(a.runtime)) {
-      throw new Error(`agents[${i}]: runtime "${String(a.runtime)}" is not supported (have: ${RUNTIMES2.join(", ")})`);
+    if (!RUNTIMES3.includes(a.runtime)) {
+      throw new Error(`agents[${i}]: runtime "${String(a.runtime)}" is not supported (have: ${RUNTIMES3.join(", ")})`);
     }
     const specialization = a.specialization === void 0 ? "writer" : a.specialization;
     if (!VALID_SPECIALIZATIONS.includes(specialization)) {
@@ -21908,11 +22004,12 @@ program2.command("status").description("Show your agent info, online agents, tas
 program2.command("start").description("Show your session orientation: project context, your open tasks, unread messages, open threads").action(startCommand);
 program2.command("watch").description("Stream live events you're subscribed to (new tasks, messages, reviews) until Ctrl-C").option("--kinds <list>", "Only show these event kinds (comma-separated, e.g. task.created,message.posted)").option("--once", "Block until the next event for this folder's agent, print it as JSON, and exit").option("--dir <path>", "Folder whose agent config --once uses (defaults to the current directory)").action(watchCommand);
 var hook = program2.command("hook", { hidden: true }).description("Agent runtime hooks that keep the watcher running (installed by join)");
-hook.command("claude").description("Claude Code SessionStart/Stop hook").option("--event <event>", "SessionStart | Stop", "SessionStart").action(hookClaudeCommand);
+hook.command("claude").description("Claude Code SessionStart/Stop/UserPromptSubmit hook").option("--event <event>", "SessionStart | Stop | UserPromptSubmit", "SessionStart").action(hookClaudeCommand);
 hook.command("cursor-stop").description("Cursor stop hook").option("--dir <path>", "The agent's folder").action(hookCursorStopCommand);
+hook.command("cursor-prompt").description("Cursor beforeSubmitPrompt hook").option("--dir <path>", "The agent's folder").action(hookCursorPromptCommand);
 program2.command("tasks").description("List tasks assigned to you (default: assigned + in_progress)").option("-a, --all", "Show all tasks in the project, not just yours").option("-s, --status <status>", "Filter by status (comma-separated: pending,assigned,in_progress,pending_verification,completed,blocked)").action(tasksCommand);
 var task = program2.command("task").description("Create or update a task");
-task.command("create").description("Create a new task").option("-t, --title <title>", "Task title").option("-d, --description <description>", "Task description").option("-p, --priority <priority>", "low|normal|high|urgent").option("--to <agent>", "Assign to an agent (id or name)").option("--domains <list>", "Comma-separated domain tags").option("--specialization <s>", "Required specialization").option("-v, --verify <cmd>", "Shell command that must exit 0 to gate the `completed` transition").option("--verify-cwd <path>", "Working directory for --verify (defaults to API server cwd)").option("--verify-kind <kind>", "Verifier kind: shell|file_exists|thread_concluded|reviewer_agent").option("--verify-path <path>", "Path that must exist (--verify-kind file_exists)").option("--verify-thread <id>", "Thread that must be concluded (--verify-kind thread_concluded)").option("--verify-reviewer <agent>", "Agent (id or name) who must approve (--verify-kind reviewer_agent)").option("--review-by <agent>", "Shorthand for --verify-kind reviewer_agent --verify-reviewer <agent>").action(taskCreateCommand);
+task.command("create").description("Create a new task").option("-t, --title <title>", "Task title").option("-d, --description <description>", "Task description").option("-p, --priority <priority>", "low|normal|high|urgent").option("--to <agent>", "Assign to an agent (id or name)").option("--domains <list>", "Comma-separated domain tags").option("--specialization <s>", "Required specialization").option("-v, --verify <cmd>", "Shell command that must exit 0 to gate the `completed` transition").option("--verify-cwd <path>", "Working directory for --verify (defaults to API server cwd)").option("--verify-kind <kind>", "Verifier kind: shell|file_exists|thread_concluded|reviewer_agent|human_approval").option("--verify-path <path>", "Path that must exist (--verify-kind file_exists)").option("--verify-thread <id>", "Thread that must be concluded (--verify-kind thread_concluded)").option("--verify-reviewer <agent>", "Agent (id or name) who must approve (--verify-kind reviewer_agent)").option("--review-by <agent>", "Shorthand for --verify-kind reviewer_agent --verify-reviewer <agent>").action(taskCreateCommand);
 task.command("start <id>").description("Mark a task as in_progress").option("-n, --note <note>", "Optional note to attach").action((id, options) => taskUpdateCommand(id, "in_progress", options));
 task.command("done <id>").description("Mark a task as completed").option("-n, --note <note>", "Optional note to attach").action((id, options) => taskUpdateCommand(id, "completed", options));
 task.command("block <id>").description("Mark a task as blocked").option("-n, --note <note>", "Describe what's blocking you").action((id, options) => taskUpdateCommand(id, "blocked", options));
@@ -21928,7 +22025,7 @@ program2.command("send <threadId>").description("Send a message to a thread").op
 program2.command("inbox").description("Show unread messages").option("-r, --read", "Mark all displayed messages as read").action(inboxCommand);
 program2.command("repos").description("List all repos on this server").action(reposListCommand);
 program2.command("agents").description("List agents in the current repo").action(agentsListCommand);
-program2.command("login").description("Log in to a repo on this machine using an invite code or an agent token").option("--invite <code>", "Invite code from `pitboss repo invite`").option("--token <token>", "Per-agent token (from the cloud dashboard)").option("--api <url>", "API URL (skips prompt)").option("--working-dir <path>", "Override the working directory (defaults to CWD)").option("--worker-type <type>", "Agent runtime: claude, copilot, cursor, windsurf, gemini, gpt, mcp, human (default: human)").option("--name <name>", "Agent name (defaults to the invite's suggestion when not interactive)").option("--specialization <spec>", "Agent specialization: writer, reviewer, tester, architect, devops, orchestrator (defaults to the invite's suggestion)").action(loginCommand);
+program2.command("login").description("Log in to a repo on this machine using an invite code or an agent token").option("--invite <code>", "Invite code from `pitboss repo invite`").option("--token <token>", "Per-agent token (from the cloud dashboard)").option("--api <url>", "API URL (skips prompt)").option("--working-dir <path>", "Override the working directory (defaults to CWD)").option("--worker-type <type>", `Agent runtime: ${WORKER_TYPES.join(", ")} (default: human)`).option("--name <name>", "Agent name (defaults to the invite's suggestion when not interactive)").option("--specialization <spec>", "Agent specialization: writer, reviewer, tester, architect, devops, orchestrator (defaults to the invite's suggestion)").action(loginCommand);
 program2.command("logout").description("Release this directory's local agent claim (does not revoke the server token)").option("--all", "Sweep claims whose working directories no longer exist").action(logoutCommand);
 var repo = program2.command("repo").description("Repo operations");
 repo.command("show [id]").description("Show a repo's details (defaults to the current repo)").action(repoShowCommand);

package/dist/event-worker.js

@@ -26,6 +26,7 @@ var BASE_TASK_LOOP = (agentId, repoPath) => `You are an AI worker agent (ID: ${a
    with \`toAgent\` set to the sender and no \`threadId\`. To check whether someone answered *you*,
    call \`mcp__relai__get_thread_messages\` on the \`threadId\` \`send_message\` gave you back \u2014 do not
    trawl the unread feed for it.
+   If \`mcp__relai__send_message\` returns 429, batch your updates into one message rather than retrying.
 
    **If you are stuck on something a colleague would know, ask one.** Call
    \`mcp__relai__list_agents\` to see who exists, pick by specialization or domain, prefer someone
@@ -531,9 +532,15 @@ import { spawn as spawn2 } from "child_process";
 import { join as join2 } from "path";
 
 // ../claude-worker/src/errors.ts
-var CREDENTIAL_PATTERNS = [
+var QUOTA_PATTERNS = [
   /credit balance is too low/i,
   /insufficient[ _-]?credits?/i,
+  /quota[ _-]?(?:exceeded|exhausted)/i,
+  /exceeded your (?:usage |rate )?quota/i,
+  /usage limit (?:reached|exceeded)/i,
+  /daily (?:limit|quota|cap)/i
+];
+var CREDENTIAL_PATTERNS = [
   /invalid[ _-]?(api[ _-]?key|x-api-key|bearer token)/i,
   /authentication[ _-]?error/i,
   /\bunauthorized\b/i,
@@ -549,6 +556,7 @@ var OVERFLOW_PATTERNS = [
 ];
 function classifySessionError(text) {
   if (!text) return "transient";
+  if (QUOTA_PATTERNS.some((re) => re.test(text))) return "quota";
   if (CREDENTIAL_PATTERNS.some((re) => re.test(text))) return "credentials";
   if (OVERFLOW_PATTERNS.some((re) => re.test(text))) return "overflow";
   return "transient";
@@ -702,6 +710,28 @@ async function blockOverflowedTasks(conn, detail, logPrefix = "[claude-worker]")
   return blocked;
 }
 
+// ../claude-worker/src/unavailable.ts
+var DEFAULT_UNAVAILABLE_UNTIL_MS = 60 * 60 * 1e3;
+function untilMs() {
+  const n = Number(process.env.UNAVAILABLE_UNTIL_MS);
+  return Number.isFinite(n) && n >= 1e3 ? n : DEFAULT_UNAVAILABLE_UNTIL_MS;
+}
+async function reportUnavailable(config2, reason, logPrefix = "[claude-worker]") {
+  const until = new Date(Date.now() + untilMs()).toISOString();
+  await fetch(`${config2.apiUrl}/agents/${config2.agentId}/unavailable`, {
+    method: "PUT",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${config2.apiSecret}` },
+    body: JSON.stringify({ reason: reason.slice(0, 200), until })
+  }).catch((err) => console.warn(`${logPrefix} report unavailable failed:`, err.message));
+}
+async function clearUnavailable(config2, logPrefix = "[claude-worker]") {
+  await fetch(`${config2.apiUrl}/agents/${config2.agentId}/unavailable`, {
+    method: "PUT",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${config2.apiSecret}` },
+    body: JSON.stringify({ until: null })
+  }).catch((err) => console.warn(`${logPrefix} clear unavailable failed:`, err.message));
+}
+
 // ../../shared/git/src/index.ts
 import { execFileSync } from "node:child_process";
 function getGitRoot(cwd) {
@@ -1389,7 +1419,8 @@ var EVENT_KINDS = [
   "thread.created",
   "thread.concluded",
   "task.blocked_overdue",
-  "artifact.published"
+  "artifact.published",
+  "agent.unavailable"
 ];
 async function runEventWorker(config2) {
   console.log(`[event-worker] Starting \u2014 agent ${config2.agentId}, watching ${config2.apiUrl}/events`);
@@ -1416,6 +1447,7 @@ async function runEventWorker(config2) {
     try {
       console.log("[event-worker] Event received \u2014 running session...");
       await getAdapter(config2.runtime).runSession(config2);
+      await clearUnavailable(config2, "[event-worker]");
     } catch (err) {
       const text = err instanceof Error ? err.message : String(err);
       const failure = getAdapter(config2.runtime).classifyError(text);
@@ -1424,11 +1456,17 @@ async function runEventWorker(config2) {
         console.error(
           blocked.length > 0 ? `[event-worker] Session ran out of context \u2014 blocked ${blocked.join(", ")} pending a split.
   ${text}` : `[event-worker] Session ran out of context but no task was in flight to block.
+  ${text}`
+        );
+      } else if (failure === "quota") {
+        await reportUnavailable(config2, "quota_exhausted", "[event-worker]");
+        console.error(
+          `[event-worker] FATAL error (quota or credit exhausted) \u2014 router will skip this agent until the until-time or a successful session.
   ${text}`
         );
       } else if (failure === "credentials") {
         console.error(
-          `[event-worker] FATAL error (likely exhausted credits or bad credentials) \u2014 fix it; the worker keeps listening and will recover on the next event.
+          `[event-worker] FATAL error (likely bad credentials) \u2014 fix it; the worker keeps listening and will recover on the next event.
   ${text}`
         );
       } else {

package/dist/mcp.js

@@ -12378,7 +12378,10 @@ var ApiClient = class {
     return this.request("PUT", `/agents/${agentId}/heartbeat`, {});
   }
   getAgent(id) {
-    return this.request("GET", `/agents/${id}`);
+    return this.request(
+      "GET",
+      `/agents/${id}`
+    );
   }
   listAgents(repoId) {
     const qs = repoId ? `?repoId=${encodeURIComponent(repoId)}` : "";
@@ -12562,7 +12565,7 @@ ${version.body}`
     },
     {
       name: "create_task",
-      description: "Create a new task in this project \u2014 use this to turn a plan into actionable work (e.g. an architect/planner breaking a design into tasks for workers). You are recorded as the task's creator automatically. Assign with assignedTo: an agent ID assigns directly, '@auto' lets the routing scheduler pick (task stays 'pending'), and omitting it means '@auto'. To keep a task yourself, pass your own agent id. Do NOT set status \u2014 it's derived (assigned when there's a concrete assignee, else pending). Optionally add a completion gate via verifyKind: 'reviewer_agent' (set verifyReviewerId \u2014 that agent must approve via submit_review), 'file_exists' (verifyPath), or 'thread_concluded' (verifyThreadId). The 'shell' kind (verifyCommand) is restricted to orchestrator agents and 403s otherwise. Note: if you are a worker (not an orchestrator), this creates a *proposal* \u2014 the task lands in 'proposed' with your assignedTo kept only as a hint, and an orchestrator must commit it before it becomes real work. Orchestrators commit on creation. When creating under an Epic (epicId), the result includes epicSiblings and may include a warning if a sibling already has this title \u2014 that is a warning, not a refusal; the task is still created. A failed create is returned as an error, never as a created-looking payload." + godNote,
+      description: "Create a new task in this project \u2014 use this to turn a plan into actionable work (e.g. an architect/planner breaking a design into tasks for workers). You are recorded as the task's creator automatically. Assign with assignedTo: an agent ID assigns directly, '@auto' lets the routing scheduler pick (task stays 'pending'), and omitting it means '@auto'. To keep a task yourself, pass your own agent id. Do NOT set status \u2014 it's derived (assigned when there's a concrete assignee, else pending). Optionally add a completion gate via verifyKind: 'reviewer_agent' (set verifyReviewerId \u2014 that agent must approve via submit_review), 'file_exists' (verifyPath), 'thread_concluded' (verifyThreadId), or 'human_approval' (the dashboard owner must approve; no agent token can satisfy it). The 'shell' kind (verifyCommand) is restricted to orchestrator agents and 403s otherwise. Note: if you are a worker (not an orchestrator, not tier\u22652), this creates a *proposal* \u2014 the task lands in 'proposed' with your assignedTo kept only as a hint, and an orchestrator must commit it before it becomes real work. Orchestrators and trusted seniors (tier\u22652 only) commit on creation. commit_task stays orchestrator-only. When creating under an Epic (epicId), the result includes epicSiblings and may include a warning if a sibling already has this title \u2014 that is a warning, not a refusal; the task is still created. A failed create is returned as an error, never as a created-looking payload." + godNote,
       inputSchema: external_exports.object({
         ...repoParam,
         title: external_exports.string().min(1).describe("Short, action-oriented task title."),
@@ -12572,7 +12575,7 @@ ${version.body}`
         domains: external_exports.array(external_exports.string()).optional().describe("Domain tags for rules-based routing, e.g. ['database','schema']."),
         specialization: external_exports.string().optional().describe("Specialization the task needs, for routing (e.g. 'writer')."),
         epicId: external_exports.string().optional().describe("Parent Epic (a plan thread). The response lists existing children and warns on a title match."),
-        verifyKind: external_exports.enum(["shell", "file_exists", "thread_concluded", "reviewer_agent"]).optional().describe("Optional completion gate \u2014 see tool description."),
+        verifyKind: external_exports.enum(["shell", "file_exists", "thread_concluded", "reviewer_agent", "human_approval"]).optional().describe("Optional completion gate \u2014 see tool description."),
         verifyReviewerId: external_exports.string().optional().describe("For verifyKind='reviewer_agent': agent ID that must approve."),
         verifyThreadId: external_exports.string().optional().describe("For verifyKind='thread_concluded': thread whose conclusion gates completion."),
         verifyPath: external_exports.string().optional().describe("For verifyKind='file_exists': path that must exist."),
@@ -12686,7 +12689,7 @@ ${version.body}`
     },
     {
       name: "send_message",
-      description: "Send a message to the orchestrator or another agent. Use the correct type: 'handoff' when you finish a task and the next agent needs context; 'finding' when you discover something that affects other work (not your current task); 'decision' to record an agreed-upon decision that all agents should honor; 'question' when you are blocked and need input before proceeding; 'escalation' when a decision needs human judgment; 'status' for routine progress updates. Be specific in the body \u2014 the receiver has no other context. IMPORTANT: if you were asked something via a relai message or task (toAgent=you, or a task assigned to you), your answer belongs here, posted on that same threadId \u2014 not just written in your own session output. The requester only sees what you post through send_message. To start a conversation with a peer you have no thread with, give toAgent and omit threadId: that opens (or reuses) a private direct thread between the two of you. Find the agent with list_agents. A direct thread is readable only by its two participants.",
+      description: "Send a message to the orchestrator or another agent. Use the correct type: 'handoff' when you finish a task and the next agent needs context; 'finding' when you discover something that affects other work (not your current task); 'decision' to record an agreed-upon decision that all agents should honor; 'question' when you are blocked and need input before proceeding; 'escalation' when a decision needs human judgment; 'status' for routine progress updates. Be specific in the body \u2014 the receiver has no other context. IMPORTANT: if you were asked something via a relai message or task (toAgent=you, or a task assigned to you), your answer belongs here, posted on that same threadId \u2014 not just written in your own session output. The requester only sees what you post through send_message. To start a conversation with a peer you have no thread with, give toAgent and omit threadId: that opens (or reuses) a private direct thread between the two of you. Find the agent with list_agents. A direct thread is readable only by its two participants. If the API returns 429, batch your updates into one message rather than retrying.",
       inputSchema: external_exports.object({
         threadId: external_exports.string().optional().describe(
           "The thread to post to. Use list_threads to find or create one. Omit it (with toAgent set) to direct-message that agent \u2014 no thread needed."
@@ -12983,7 +12986,7 @@ ${version.body}`
         priority: external_exports.enum(["low", "normal", "high", "urgent"]).optional().describe("Ratified priority."),
         domains: external_exports.array(external_exports.string()).optional().describe("Ratified domain tags."),
         specialization: external_exports.string().optional().describe("Ratified specialization."),
-        verifyKind: external_exports.enum(["shell", "file_exists", "thread_concluded", "reviewer_agent"]).optional(),
+        verifyKind: external_exports.enum(["shell", "file_exists", "thread_concluded", "reviewer_agent", "human_approval"]).optional(),
         verifyReviewerId: external_exports.string().optional(),
         verifyThreadId: external_exports.string().optional(),
         verifyPath: external_exports.string().optional(),
@@ -13165,7 +13168,7 @@ function buildProvisioningTools(client, opts = {}) {
       inputSchema: external_exports.object({
         repoId: external_exports.string().describe("The repo to invite into. Must be one you own; see list_repos."),
         name: external_exports.string().min(1).describe("Suggested name for the new agent, e.g. 'reviewer'."),
-        workerType: external_exports.enum(["claude", "copilot", "cursor", "windsurf", "gemini", "gpt", "mcp", "human"]).optional().describe("The runtime this agent will run as. Defaults to 'human' at redeem time if omitted."),
+        workerType: external_exports.string().optional().describe("The runtime this agent will run as. Defaults to 'human' at redeem time if omitted."),
         specialization: external_exports.string().optional().describe("What this agent is for, e.g. 'review' or 'frontend'. Used for routing.")
       }),
       handler: async (input) => {
@@ -13659,6 +13662,41 @@ async function deliverAttention(prev, tasks, send) {
   return next;
 }
 
+// ../mcp-server/src/inbox-poll.ts
+var DEFAULT_INBOX_POLL_INTERVAL_MS = 6e4;
+function inboxPollIntervalMs(raw = process.env.INBOX_POLL_INTERVAL_MS) {
+  const n = Number(raw);
+  return Number.isFinite(n) && n >= 1 ? n : DEFAULT_INBOX_POLL_INTERVAL_MS;
+}
+function shouldSkipInboxPoll(agent) {
+  return agent?.listening === true;
+}
+async function runInboxPoll(deps) {
+  let agent;
+  try {
+    agent = await deps.getAgent();
+  } catch {
+    agent = null;
+  }
+  if (shouldSkipInboxPoll(agent)) return "skipped";
+  const [tasks, messages] = await Promise.all([deps.getTasks(), deps.getUnread()]);
+  for (const task of tasks) {
+    if (deps.seenTaskIds.has(task.id)) continue;
+    deps.seenTaskIds.add(task.id);
+    await deps.notify(
+      `\u{1F4CB} New task assigned: "${task.title}" [${task.id}] \u2014 call get_my_tasks to begin`
+    );
+  }
+  for (const msg of messages) {
+    if (deps.seenMessageIds.has(msg.id)) continue;
+    deps.seenMessageIds.add(msg.id);
+    await deps.notify(
+      `\u{1F4AC} New ${msg.type} message from ${msg.fromAgent} in thread ${msg.threadId} \u2014 call get_unread_messages to read`
+    );
+  }
+  return "polled";
+}
+
 // ../../shared/git/src/index.ts
 import { execFileSync } from "node:child_process";
 function getGitRoot(cwd) {
@@ -13867,31 +13905,25 @@ if (!OWNER_MODE) {
     apiClient.heartbeat(AGENT_ID).catch(() => {
     });
   }, HEARTBEAT_INTERVAL_MS);
-  const POLL_INTERVAL_MS = 15e3;
+  const POLL_INTERVAL_MS = inboxPollIntervalMs();
   const seenTaskIds = /* @__PURE__ */ new Set();
   const seenMessageIds = /* @__PURE__ */ new Set();
   async function pollInbox() {
     try {
-      const [tasks, messages] = await Promise.all([
-        apiClient.getTasks({ repoId: REPO_ID, assignedTo: AGENT_ID, status: "assigned" }),
-        apiClient.getUnread(AGENT_ID, REPO_ID).then((r) => r.data ?? [])
-      ]);
-      const newTasks = tasks.filter((t) => !seenTaskIds.has(t.id));
-      const newMessages = messages.filter((m) => !seenMessageIds.has(m.id));
-      for (const task of newTasks) {
-        seenTaskIds.add(task.id);
-        await server.server.sendLoggingMessage({
-          level: "info",
-          data: `\u{1F4CB} New task assigned: "${task.title}" [${task.id}] \u2014 call get_my_tasks to begin`
-        });
-      }
-      for (const msg of newMessages) {
-        seenMessageIds.add(msg.id);
-        await server.server.sendLoggingMessage({
-          level: "info",
-          data: `\u{1F4AC} New ${msg.type} message from ${msg.fromAgent} in thread ${msg.threadId} \u2014 call get_unread_messages to read`
-        });
-      }
+      await runInboxPoll({
+        getAgent: () => apiClient.getAgent(AGENT_ID),
+        getTasks: () => apiClient.getTasks({
+          repoId: REPO_ID,
+          assignedTo: AGENT_ID,
+          status: "assigned"
+        }),
+        getUnread: () => apiClient.getUnread(AGENT_ID, REPO_ID).then(
+          (r) => r.data ?? []
+        ),
+        seenTaskIds,
+        seenMessageIds,
+        notify: (data) => server.server.sendLoggingMessage({ level: "info", data })
+      });
     } catch (err) {
       console.error("[relai-mcp] inbox poll failed:", err instanceof Error ? err.message : err);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitboss/cli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "private": false,
   "description": "Connect your coding agents to a pitboss instance",
   "keywords": [
@@ -13,14 +13,14 @@
     "cli"
   ],
   "license": "UNLICENSED",
-  "homepage": "https://github.com/phillipsio/relai/tree/main/packages/cli",
+  "homepage": "https://github.com/FunctionizeTeam/pitboss/tree/main/packages/cli",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/phillipsio/relai.git",
+    "url": "git+https://github.com/FunctionizeTeam/pitboss.git",
     "directory": "packages/cli"
   },
   "bugs": {
-    "url": "https://github.com/phillipsio/relai/issues"
+    "url": "https://github.com/FunctionizeTeam/pitboss/issues"
   },
   "publishConfig": {
     "access": "public"
@@ -44,6 +44,7 @@
   "devDependencies": {
     "@getrelai/claude-worker": "workspace:*",
     "@getrelai/git": "workspace:*",
+    "@getrelai/types": "workspace:*",
     "@inquirer/prompts": "^8.7.0",
     "@types/node": "^22.0.0",
     "chalk": "^5.3.0",