@inerrata-corporation/errata 2.0.0-dev.39 → 2.0.0-dev.40

package/errata.mjs

@@ -20857,6 +20857,18 @@ var init_client = __esm({
       async me() {
         return this.json("GET", "/v2/me");
       }
+      // ─── acting-agent switching (gateway control plane, #898) ───────────
+      /** Agents the authenticated user may act as, plus their default agent.
+       *  Authenticated with the caller's console-signed gateway JWT. */
+      async actableAgents() {
+        return this.json("GET", "/api/gate/actable-agents");
+      }
+      /** Mint a fresh gateway JWT stamped with `handle` (authz-checked + audited
+       *  server-side). The returned `token` bears the acting-agent identity for
+       *  subsequent cloud calls. Authenticated with the caller's base JWT. */
+      async actAs(handle2) {
+        return this.json("POST", "/api/gate/act-as", { handle: handle2 });
+      }
       // ─── ingest ────────────────────────────────────────────────────────
       /** Upload one outbox batch (projected onto the reconciled wire) and fold
        *  the per-decision response into flush accounting.
@@ -21337,7 +21349,8 @@ function defaultConfig() {
     notifications: true,
     onboardedAt: null,
     machineId: null,
-    updateChannel: "dev"
+    updateChannel: "dev",
+    activeAgent: null
   };
 }
 function loadConfig() {
@@ -21372,6 +21385,19 @@ function machineId() {
   saveConfig({ ...cfg, machineId: id });
   return id;
 }
+function getActiveAgent(cfg = loadConfig()) {
+  return cfg.activeAgent ?? null;
+}
+function setActiveAgent(agent, cfg = loadConfig()) {
+  const next = { ...cfg, activeAgent: { handle: agent.handle, id: agent.id } };
+  saveConfig(next);
+  return next;
+}
+function clearActiveAgent(cfg = loadConfig()) {
+  const next = { ...cfg, activeAgent: null };
+  saveConfig(next);
+  return next;
+}
 var DEFAULT_CLOUD_URL;
 var init_config = __esm({
   "src/config.ts"() {
@@ -37436,8 +37462,8 @@ function buildWebUi(deps) {
         const arrText = Array.isArray(respObj["content"]) ? respObj["content"].map(
           (c2) => c2 && typeof c2 === "object" && typeof c2["text"] === "string" ? c2["text"] : ""
         ).join("\n") : "";
-        const errText = typeof rawResp === "string" ? rawResp : typeof respObj["error"] === "string" ? respObj["error"] : typeof respObj["message"] === "string" ? respObj["message"] : typeof respObj["stderr"] === "string" ? respObj["stderr"] : typeof respObj["content"] === "string" ? respObj["content"] : arrText;
-        const errorTokens = errText.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).slice(0, 20);
+        const errText2 = typeof rawResp === "string" ? rawResp : typeof respObj["error"] === "string" ? respObj["error"] : typeof respObj["message"] === "string" ? respObj["message"] : typeof respObj["stderr"] === "string" ? respObj["stderr"] : typeof respObj["content"] === "string" ? respObj["content"] : arrText;
+        const errorTokens = errText2.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).slice(0, 20);
         if (errorTokens.length > 0) {
           deps.onToolError({
             tool,
@@ -37446,7 +37472,7 @@ function buildWebUi(deps) {
             exitCode: numericExit ?? 1,
             ts: Date.now()
           });
-          recallCtx = recallForError(deps.store, errText);
+          recallCtx = recallForError(deps.store, errText2);
         }
       }
     }
@@ -42478,7 +42504,7 @@ function startLoopLagMonitor(thresholdMs = 1e3) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.0-dev.39" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.0-dev.40" : "2.0.0-alpha.0";
 var IGNORED_PATH = /[\\/](?:\.git|node_modules|\.errata|\.claude|\.codex|\.cursor|\.turbo|\.next|dist|coverage|test-results|playwright-report|__pycache__)(?:[\\/]|$)/;
 var IGNORED_NOISE = /castalia\.db|eventlog\.sqlite|turn-cursors/;
 var GIT_OP_MUTE_MS = 4e3;
@@ -45202,6 +45228,114 @@ init_src4();
 init_config();
 init_src6();
 init_cloud_auth();
+
+// src/agent-switch.ts
+function parseUseArgs(args2) {
+  const positional = [];
+  let clear = false;
+  for (const arg of args2) {
+    if (arg === "--none" || arg === "--clear") {
+      clear = true;
+      continue;
+    }
+    if (arg.startsWith("--")) continue;
+    positional.push(arg);
+  }
+  if (clear) return { kind: "clear" };
+  const handle2 = positional[0];
+  if (!handle2) return { kind: "show" };
+  return { kind: "set", handle: handle2 };
+}
+function normalizeHandle(handle2) {
+  return handle2.trim().replace(/^@/, "").toLowerCase();
+}
+function findActable(agents, handle2) {
+  const want = normalizeHandle(handle2);
+  return agents.find((a) => normalizeHandle(a.handle) === want) ?? null;
+}
+async function runUse(action, ctx) {
+  switch (action.kind) {
+    case "clear":
+      return runClear(ctx);
+    case "show":
+      return runShow(ctx);
+    case "set":
+      return runSet(action.handle, ctx);
+  }
+}
+function runClear(ctx) {
+  const active = ctx.getActiveAgent();
+  ctx.clearActiveAgent();
+  if (active) {
+    ctx.log(`no longer acting as ${active.handle} \u2014 the daemon acts as your default identity`);
+  } else {
+    ctx.log(`already on the default identity \u2014 nothing to clear`);
+  }
+  return 0;
+}
+async function runShow(ctx) {
+  const active = ctx.getActiveAgent();
+  ctx.log(active ? `active agent: ${active.handle} (id ${active.id})` : `active agent: (default identity)`);
+  if (!ctx.loggedIn) {
+    ctx.log(`  log in to list the agents you can act as:  errata login`);
+    return 0;
+  }
+  let resp;
+  try {
+    resp = await ctx.actableAgents();
+  } catch (err2) {
+    ctx.log(`  couldn't list actable agents: ${errText(err2)}`);
+    return 1;
+  }
+  printActable(resp, active, ctx);
+  return 0;
+}
+async function runSet(handle2, ctx) {
+  if (!ctx.loggedIn) {
+    ctx.log(`not logged in \u2014 run \`errata login\` first, then \`errata use ${handle2}\``);
+    return 1;
+  }
+  let resp;
+  try {
+    resp = await ctx.actableAgents();
+  } catch (err2) {
+    ctx.log(`couldn't verify \`${handle2}\`: ${errText(err2)}`);
+    return 1;
+  }
+  const match2 = findActable(resp.agents, handle2);
+  if (!match2) {
+    ctx.log(`unknown agent: ${handle2}`);
+    if (resp.agents.length === 0) {
+      ctx.log(`  you can't act as any agents yet.`);
+    } else {
+      ctx.log(`  agents you can act as: ${resp.agents.map((a) => a.handle).join(", ")}`);
+    }
+    return 2;
+  }
+  ctx.setActiveAgent({ handle: match2.handle, id: match2.id });
+  ctx.log(`now acting as ${match2.handle} (id ${match2.id}) \u2014 saved; persists across daemon restarts`);
+  return 0;
+}
+function printActable(resp, active, ctx) {
+  if (resp.agents.length === 0) {
+    ctx.log(`  (no agents you can act as)`);
+    return;
+  }
+  ctx.log(`  agents you can act as:`);
+  for (const a of resp.agents) {
+    const marks = [];
+    if (active && a.id === active.id) marks.push("active");
+    if (a.id === resp.defaultAgentId) marks.push("default");
+    const suffix = marks.length ? `  (${marks.join(", ")})` : "";
+    const scope = a.scope ? ` \xB7 ${a.scope}` : "";
+    ctx.log(`    ${a.handle}${scope}${suffix}`);
+  }
+}
+function errText(err2) {
+  return err2 instanceof Error ? err2.message : String(err2);
+}
+
+// src/cli.ts
 init_cloud_endpoint_policy();
 
 // src/oauth-login.ts
@@ -45446,6 +45580,8 @@ async function main() {
       return cmdLogin();
     case "logout":
       return cmdLogout();
+    case "use":
+      return cmdUse(rest);
     case "review":
       return cmdReview();
     case "tick":
@@ -45570,6 +45706,9 @@ Commands:
                       surface (navigation, problems, claims, burst, health)
   login               Sign in with the cloud (OAuth by default; --device for legacy device-code)
   logout              Clear local cloud credentials
+  use [<handle>]      Set the sticky session active agent the daemon acts as.
+                      No arg lists the agents you can act as + the current one;
+                      --none (or --clear) reverts to your default identity.
   sync now            Flush outbox to the cloud once
   privacy             Show what is collected/scrubbed + your consent state
   consent <channel> <on|off>
@@ -45772,6 +45911,10 @@ async function cmdStatus() {
   console.log(`  cloud:`);
   console.log(`    url:    ${cfg.cloudUrl}`);
   console.log(`    logged in: ${hasCloudCredential(cfg) ? `yes (${cfg.email})` : "no"}`);
+  const active = getActiveAgent(cfg);
+  console.log(
+    `    active agent: ${active ? `${active.handle} (acting-as; \`errata use --none\` to clear)` : "default identity"}`
+  );
   const inspection = await inspectCloudEndpoint(cfg.cloudUrl);
   const decision = evaluateCloudEndpoint(cfg.cloudUrl, inspection);
   const service = inspection.service ? ` \xB7 service ${inspection.service}` : "";
@@ -46048,6 +46191,24 @@ async function cmdLogout() {
   saveConfig(cfg);
   console.log(`logged out`);
 }
+async function cmdUse(args2) {
+  const cfg = loadConfig();
+  const action = parseUseArgs(args2);
+  const ctx = {
+    loggedIn: hasCloudCredential(cfg),
+    actableAgents: () => authedCloudClient(loadConfig()).actableAgents(),
+    getActiveAgent: () => getActiveAgent(),
+    setActiveAgent: (agent) => {
+      setActiveAgent(agent);
+    },
+    clearActiveAgent: () => {
+      clearActiveAgent();
+    },
+    log: (line) => console.log(line)
+  };
+  const code = await runUse(action, ctx);
+  if (code !== 0) process.exitCode = code;
+}
 async function cmdReview() {
   const paths = workspacePaths(ROOT);
   if (!existsSync20(paths.reviewQueue)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inerrata-corporation/errata",
-  "version": "2.0.0-dev.39",
+  "version": "2.0.0-dev.40",
   "description": "errata - local-first observation engine for AI coding agents",
   "type": "module",
   "bin": {