arcane-cli 1.19.0 → 1.20.1

package/dist/index.js

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from "node:module";
 const require = __createRequire(import.meta.url);
 
 // src/index.ts
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import { fileURLToPath } from "url";
 import { dirname as dirname15, join as join31 } from "path";
 
@@ -8419,7 +8419,7 @@ var PRESENCE_ENV = { port: "ARCANE_PRESENCE_PORT", token: "ARCANE_PRESENCE_TOKEN
 var LOOPBACK_HOST = "127.0.0.1";
 var MAX_BODY_BYTES = 65536;
 var MAX_LINE_CHARS = 256;
-var MAX_NEEDS_YOU = 20;
+var MAX_REQUIRED_ACTIONS = 20;
 var MAX_SUBSCRIBERS = 32;
 var MAX_SUBSCRIBER_BUFFER_BYTES = 1048576;
 var MAX_CONNECTIONS = 128;
@@ -8438,7 +8438,7 @@ var ALIAS_CONTEXTS = ["openclaw", "slug"];
 var SESSION_EVENTS = [
   "session.started",
   "session.updated",
-  "session.needs_you",
+  "session.action_required",
   "session.stale",
   "session.resumed",
   "session.ended",
@@ -11255,11 +11255,11 @@ function detectHarness(env) {
 }
 
 // src/modules/presence/reporter.ts
-var NEEDS_YOU_SEPARATOR = " \u2014 ";
-function parseNeedsYou(line2) {
-  const at = line2.indexOf(NEEDS_YOU_SEPARATOR);
+var REQUIRED_ACTION_SEPARATOR = " \u2014 ";
+function parseRequiredAction(line2) {
+  const at = line2.indexOf(REQUIRED_ACTION_SEPARATOR);
   if (at < 0) return { action: line2, reason: null };
-  return { action: line2.slice(0, at), reason: line2.slice(at + NEEDS_YOU_SEPARATOR.length) };
+  return { action: line2.slice(0, at), reason: line2.slice(at + REQUIRED_ACTION_SEPARATOR.length) };
 }
 async function quiet(fn) {
   try {
@@ -11315,7 +11315,7 @@ async function sendReport(cwd, flags, deps = {}) {
     agent: agent2,
     repository: located.repository,
     checkout: located.checkout,
-    needs_you: (flags.needsYou ?? []).map(parseNeedsYou)
+    required_actions: (flags.requiredActions ?? []).map(parseRequiredAction)
   };
   if (flags.spell !== void 0) body["spell"] = flags.spell;
   if (flags.task !== void 0) body["task"] = flags.task;
@@ -11364,7 +11364,7 @@ var PRESENCE_TOOLS = [
         task: { ...LINE, description: "What the session is doing, in one line." },
         spell: { ...LINE, description: "The spell running, e.g. spell-implement." },
         message: { ...LINE, description: "A free one-line note; an empty string clears it." },
-        needs_you: { type: "array", maxItems: 20, items: { type: "string" }, description: "Lines of a Needs you block, '<action> \u2014 <reason>'." },
+        required_actions: { type: "array", maxItems: 20, items: { type: "string" }, description: "Lines of the Now tier of an Action required block, '<action> \u2014 <reason>'." },
         agent: { type: "string", description: "The roster agent (a slug or an alias); default: the orchestrator." },
         harness: { type: "string", enum: [...HARNESSES] },
         cwd: { type: "string", description: "The checkout to report for; default: the server's working directory." }
@@ -11421,16 +11421,16 @@ function serveMcp(options) {
   const report = async (args) => {
     const status = stringArg(args, "status");
     if (status === void 0) return text("status is required: one of working, waiting, blocked, idle.", true);
-    const needs = args["needs_you"];
+    const needs = args["required_actions"];
     if (needs !== void 0 && (!Array.isArray(needs) || needs.some((n) => typeof n !== "string"))) {
-      return text("needs_you must be a list of strings.", true);
+      return text("required_actions must be a list of strings.", true);
     }
     const flags = { status };
     for (const key of ["task", "spell", "message", "agent", "harness"]) {
       const v = stringArg(args, key);
       if (v !== void 0) flags[key] = v;
     }
-    if (Array.isArray(needs)) flags.needsYou = needs;
+    if (Array.isArray(needs)) flags.requiredActions = needs;
     if (resolveEndpoint(deps) === null) return text(NOT_CONFIGURED_TEXT);
     const where = stringArg(args, "cwd") ?? cwd;
     const outcome = await sendReport(where, flags, deps);
@@ -11816,13 +11816,14 @@ function checkout(value) {
   }
   return { path: nonEmpty(c["path"], "checkout.path"), branch: line(c["branch"], "checkout.branch", true), linked_worktree: c["linked_worktree"] };
 }
-function needsYou(value) {
-  if (!Array.isArray(value)) throw new Refusal("invalid_field", "needs_you", "needs_you must be a list");
-  if (value.length > MAX_NEEDS_YOU) {
-    throw new Refusal("too_many_lines", "needs_you", `needs_you carries at most ${MAX_NEEDS_YOU} lines; ${value.length} were sent`);
+var LEGACY_REQUIRED_ACTIONS_KEY = "needs_you";
+function requiredActions(value, key = "required_actions") {
+  if (!Array.isArray(value)) throw new Refusal("invalid_field", key, `${key} must be a list`);
+  if (value.length > MAX_REQUIRED_ACTIONS) {
+    throw new Refusal("too_many_lines", key, `${key} carries at most ${MAX_REQUIRED_ACTIONS} lines; ${value.length} were sent`);
   }
   return value.map((item, i) => {
-    const field = `needs_you.${i}`;
+    const field = `${key}.${i}`;
     const n = closed(item, field, ["action", "reason"]);
     return { action: nonEmptyLine(n["action"], `${field}.action`), reason: line(n["reason"], `${field}.reason`, true) };
   });
@@ -11839,7 +11840,7 @@ function refuse(fn) {
 }
 function validateReport(value) {
   return refuse(() => {
-    const b = closed(value, void 0, ["status", "harness", "agent", "repository", "checkout"], ["spell", "task", "message", "needs_you"]);
+    const b = closed(value, void 0, ["status", "harness", "agent", "repository", "checkout"], ["spell", "task", "message", "required_actions", LEGACY_REQUIRED_ACTIONS_KEY]);
     if (b["status"] === "done") {
       throw new Refusal("invalid_field", "status", "status done is set by ending a session: use POST /v0/sessions/end (spell presence end)");
     }
@@ -11853,7 +11854,11 @@ function validateReport(value) {
     for (const key of ["spell", "task", "message"]) {
       if (key in b) out[key] = line(b[key], key, true);
     }
-    if ("needs_you" in b) out.needs_you = needsYou(b["needs_you"]);
+    if ("required_actions" in b && LEGACY_REQUIRED_ACTIONS_KEY in b) {
+      throw new Refusal("invalid_field", LEGACY_REQUIRED_ACTIONS_KEY, "send required_actions only: needs_you is its name before 1.20");
+    }
+    if ("required_actions" in b) out.required_actions = requiredActions(b["required_actions"]);
+    else if (LEGACY_REQUIRED_ACTIONS_KEY in b) out.required_actions = requiredActions(b[LEGACY_REQUIRED_ACTIONS_KEY], LEGACY_REQUIRED_ACTIONS_KEY);
     return out;
   });
 }
@@ -12095,7 +12100,7 @@ data: ${JSON.stringify(hello)}
 function copy(record) {
   return structuredClone(record);
 }
-function sameNeedsYou(a, b) {
+function sameRequiredActions(a, b) {
   if (a.length !== b.length) return false;
   return a.every((item, i) => item.action === b[i]?.action && item.reason === b[i]?.reason);
 }
@@ -12120,7 +12125,7 @@ function createSessionTable(options) {
       const ms = now();
       const at = new Date(ms).toISOString();
       const key = body.checkout.path;
-      const needsYou2 = (body.needs_you ?? []).map((n) => ({ action: n.action, reason: n.reason }));
+      const requiredActions2 = (body.required_actions ?? []).map((n) => ({ action: n.action, reason: n.reason }));
       const existing = entries.get(key);
       if (existing === void 0) {
         const record2 = {
@@ -12133,7 +12138,7 @@ function createSessionTable(options) {
           task: body.task ?? null,
           message: body.message ?? null,
           status: body.status,
-          needs_you: needsYou2,
+          required_actions: requiredActions2,
           started_at: at,
           reported_at: at,
           ended_at: null,
@@ -12145,7 +12150,7 @@ function createSessionTable(options) {
       }
       const record = existing.record;
       const wasStale = record.stale;
-      const needsChanged = !sameNeedsYou(record.needs_you, needsYou2);
+      const needsChanged = !sameRequiredActions(record.required_actions, requiredActions2);
       record.agent = structuredClone(body.agent);
       record.harness = body.harness;
       record.repository = structuredClone(body.repository);
@@ -12154,11 +12159,11 @@ function createSessionTable(options) {
       if (body.task !== void 0) record.task = body.task;
       if (body.message !== void 0) record.message = body.message;
       record.status = body.status;
-      record.needs_you = needsYou2;
+      record.required_actions = requiredActions2;
       record.reported_at = at;
       record.stale = false;
       existing.reportedMs = ms;
-      const event = wasStale ? "session.resumed" : needsChanged ? "session.needs_you" : "session.updated";
+      const event = wasStale ? "session.resumed" : needsChanged ? "session.action_required" : "session.updated";
       emit(event, record);
       return { record: copy(record), created: false, event };
     },
@@ -12380,7 +12385,7 @@ function renderSessionsTable(sessions, now) {
   const out = [line2(header)];
   sessions.forEach((s, i) => {
     out.push(line2(rows[i]));
-    for (const n of s.needs_you) out.push(`  needs you: ${n.reason === null ? n.action : `${n.action} \u2014 ${n.reason}`}`);
+    for (const n of s.required_actions) out.push(`  action required: ${n.reason === null ? n.action : `${n.action} \u2014 ${n.reason}`}`);
   });
   return out;
 }
@@ -12705,8 +12710,9 @@ function collectLine(value, previous) {
   return [...previous, value];
 }
 var exitZero = () => process.exit(0);
-presenceCommand.command("report").description("Report this checkout's session to the presence service. Silent, exit 0, when no channel is configured; never blocks").requiredOption("--status <status>", "working | waiting | blocked | idle").option("--task <line>", "What the session is doing, in one line").option("--spell <id>", "The spell running, e.g. spell-implement").option("--message <line>", "A free one-line note; an empty value clears it").option("--needs-you <line>", "One line of a Needs you block, '<action> \u2014 <reason>'; repeat per line", collectLine, []).option("--agent <slug>", "The roster agent this session reports as (a slug or an alias); default: the orchestrator").option("--harness <id>", "claude-code | copilot | codex | openclaw | cron | other; default: detected, else other").exitOverride(exitZero).action(async (opts) => {
-  const run = await runPresenceReport(process.cwd(), opts);
+presenceCommand.command("report").description("Report this checkout's session to the presence service. Silent, exit 0, when no channel is configured; never blocks").requiredOption("--status <status>", "working | waiting | blocked | idle").option("--task <line>", "What the session is doing, in one line").option("--spell <id>", "The spell running, e.g. spell-implement").option("--message <line>", "A free one-line note; an empty value clears it").option("--required-action <line>", "One open line of the Now tier of an Action required block, '<action> \u2014 <reason>'; repeat per line", collectLine, []).addOption(new Option("--needs-you <line>").argParser(collectLine).default([]).hideHelp()).option("--agent <slug>", "The roster agent this session reports as (a slug or an alias); default: the orchestrator").option("--harness <id>", "claude-code | copilot | codex | openclaw | cron | other; default: detected, else other").exitOverride(exitZero).action(async (opts) => {
+  const { requiredAction, needsYou, ...rest } = opts;
+  const run = await runPresenceReport(process.cwd(), { ...rest, requiredActions: [...requiredAction, ...needsYou] });
   process.exitCode = 0;
   if (run.timedOut) process.exit(0);
 });