cruo-agent 0.1.10 → 0.1.12

package/README.md

@@ -6,9 +6,26 @@ works them — on your machine, under your own Claude account.
 ```bash
 npx cruo-agent login cruo_pat_…    # the token Cruo showed you once
 npx cruo-agent --dry-run           # what would it pick up? starts no model
-npx cruo-agent                     # let it work
+npx cruo-agent run                 # let it work
 ```
 
+## Before you start
+
+| you need | check it with |
+|---|---|
+| [Claude Code](https://claude.com/claude-code) installed and signed in — it is the harness, and the agent reaches no model without it | `claude -p 'say ok'` |
+| Node 20 or newer | `node -v` |
+
+Worth ten seconds, because both failures are silent. A missing harness exits 127
+with no output; a signed-out one prints `Not logged in` and exits **zero**. The
+supervisor reports either as a run that reached no model and backs off — which
+on the board is indistinguishable from having nothing to do.
+
+`npx cruo-agent …` resolves the package on every run. If you are going to use it
+daily, `npm i -g cruo-agent` puts `cruo` on your PATH and every command below
+gets shorter. Typing `cruo` on its own prints the command list and starts
+nothing: running an agent is `cruo run`, or any command with flags.
+
 ## What this actually is
 
 Three things people tend to run together, kept apart because they fail
@@ -107,6 +124,14 @@ product, revocable from Settings.
 
 The harness still runs under your Claude account, on that box.
 
+`cruo start` survives the terminal closing, not the machine restarting. For that,
+use what the box already has — a launchd agent on macOS, a systemd unit on Linux
+— pointing at the same command. Both files are written out, filled in, at
+<https://cruo.space/docs#agents>, along with the two traps that make them fail
+silently: neither reads your shell profile, so every path must be absolute and
+`PATH` must name wherever `claude` lives; and both restart what dies, so a token
+the service cannot find becomes a crashloop rather than one loud error.
+
 ## The name
 
 The package is `cruo-agent`; the command it installs is `cruo`. npm refuses the

package/dist/VERSION

@@ -1 +1 @@
-0.1.10
+0.1.12

package/dist/cli.js

@@ -36895,12 +36895,13 @@ async function delegatedSessionFor(config3, principal) {
     workspaceName: principal.workspaceName
   };
 }
-async function fetchDelegatedSession(endpoint, token) {
+async function fetchDelegatedSession(endpoint, token, options2 = {}) {
   let response;
   try {
     response = await fetch(endpoint, {
       method: "POST",
-      headers: { authorization: `Bearer ${token}`, accept: "application/json" }
+      headers: { authorization: `Bearer ${token}`, accept: "application/json" },
+      signal: options2.signal
     });
   } catch (error51) {
     throw new Error(`Could not reach ${endpoint}: ${error51 instanceof Error ? error51.message : String(error51)}`);
@@ -48180,15 +48181,21 @@ async function writeConfig(config3) {
   await writeFile3(CONFIG_PATH, JSON.stringify(config3, null, 2) + "\n", { mode: 384 });
   await chmod(CONFIG_PATH, 384);
 }
-async function identify2(token) {
+async function lookup(token, timeoutMs = 5e3) {
   const endpoint = process.env.CRUO_SESSION_URL?.trim() || CRUO_CLOUD.sessionUrl;
   try {
-    const session = await fetchDelegatedSession(endpoint, token);
-    return { email: session.email, workspace: session.workspaceName };
-  } catch {
-    return null;
+    const session = await fetchDelegatedSession(endpoint, token, {
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+    return { state: "known", who: { email: session.email, workspace: session.workspaceName } };
+  } catch (error51) {
+    return error51 instanceof TokenRefused ? { state: "refused" } : { state: "unreachable" };
   }
 }
+async function identify2(token) {
+  const found = await lookup(token);
+  return found.state === "known" ? found.who : null;
+}
 async function login(token, as) {
   if (!token.startsWith("cruo_pat_")) {
     console.error(`
@@ -48196,7 +48203,7 @@ That does not look like a Cruo token \u2014 they begin "cruo_pat_".
 `);
     process.exit(2);
   }
-  const who = as ? null : await identify2(token);
+  const who = await identify2(token);
   const name = as ?? (who ? nameFromEmail(who.email) : null);
   if (!name) {
     console.error(
@@ -48294,12 +48301,32 @@ No tokens stored. \`cruo login <token>\` to add one.
 `);
     return;
   }
+  const found = await Promise.all(names.map((n2) => lookup(config3.agents[n2].token)));
+  let changed = false;
+  found.forEach((f, i) => {
+    if (f.state !== "known") return;
+    const a = config3.agents[names[i]];
+    if (a.email !== f.who.email || a.workspace !== f.who.workspace) {
+      a.email = f.who.email;
+      a.workspace = f.who.workspace;
+      changed = true;
+    }
+  });
+  if (changed) await writeConfig(config3);
   console.log("");
-  for (const name of names) {
+  names.forEach((name, i) => {
     const a = config3.agents[name];
     const mark = config3.default === name ? "*" : " ";
     const who = a.email ? ` \u2014 ${a.email}${a.workspace ? ` in ${a.workspace}` : ""}` : "";
-    console.log(` ${mark} ${name}${who}`);
+    const note = found[i].state === "refused" ? "   (token refused \u2014 revoked? `cruo login` a new one)" : "";
+    console.log(` ${mark} ${name}${who}${note}`);
+  });
+  const unchecked = found.filter((f) => f.state === "unreachable").length;
+  if (unchecked > 0) {
+    console.log(
+      `
+ (${unchecked === names.length ? "Could not reach Cruo" : `${unchecked} could not be checked`} just now \u2014 showing what was stored.)`
+    );
   }
   console.log(`
  * is what \`cruo run\` runs. Use \`--as <name>\` for another.

package/dist/index.js

@@ -43087,12 +43087,13 @@ async function sessionFor(config3, principal) {
   return attempt;
 }
 var DELEGATED_SESSION_ENV = "CRUO_SESSION";
-async function fetchDelegatedSession(endpoint, token) {
+async function fetchDelegatedSession(endpoint, token, options = {}) {
   let response;
   try {
     response = await fetch(endpoint, {
       method: "POST",
-      headers: { authorization: `Bearer ${token}`, accept: "application/json" }
+      headers: { authorization: `Bearer ${token}`, accept: "application/json" },
+      signal: options.signal
     });
   } catch (error51) {
     throw new Error(`Could not reach ${endpoint}: ${error51 instanceof Error ? error51.message : String(error51)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cruo-agent",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Run a Cruo agent: it watches your board, picks up the cards you assign it, and works them.",
   "license": "MIT",
   "homepage": "https://cruo.space/docs#agents",