@inetafrica/open-claudia 3.0.16 → 3.0.17

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v3.0.17 — Spaces auto-enables on connection; control moves into chat
+
+- **The Spaces conversational plane no longer hides behind an env flag.** `OC_SPACES_CONVERSATIONAL` is gone. Auto-replies now enable themselves the moment the bot is **connected** to Spaces, on a hybrid signal: central authoritatively lists Spaces among the bot's connected apps, **or** the socket has actually received a Spaces notification (which only happens for a task the bot is a member of). Either one flips it on — so it works today over the socket even before the central `/api/principal/applications` endpoint is deployed. It stays self-gating: no Spaces membership ⇒ no notifications ⇒ no replies.
+- **All control is in chat now — nothing to set on the pod.** New owner command `/spaces`: `status` (connection + whether replies are live + task mode), `pause` / `resume` (the off-switch for auto-replies; mentions still hit the radar, I just don't answer), and `mode advisory|autonomous|off` (task-working posture, overriding the env default live). State persists in `spaces-state.json`; the owner never needs filesystem or env access.
+- **The Spaces channel auto-includes whenever `KAZEE_BOT_TOKEN` is set**, even if `CHANNELS` doesn't list it — Spaces is fixed infra on the same token as Kazee chat, so "has token ⇒ Spaces available" is what makes auto-enable reachable without editing env.
+- **Agent-space / OpenClaw:** no new deps, no new env required, no schema change; Docker image builds identically (FROM the pre-baked `:base`). Existing pods pick this up on their next approved upgrade.
+
 ## v3.0.16 — Spaces task loop + approval thread-mirror (dormant)
 
 - **Kazee Spaces connected-apps gains its two remaining pieces, both shipped OFF.** The task-working loop runs in **advisory** mode by default: when the bot engages a Spaces task thread, its turns for that task are serialized (one at a time, while different tasks proceed in parallel), a persistent cursor + cross-restart dedup lives in `spaces-state.json`, and a new `OC_SPACES_TASK_LOOP` mode (`advisory` | `autonomous` | `off`) selects the framing. The **approval thread-mirror** routes any write/destructive action from a Spaces-origin turn to the owner's Telegram Approve/Deny button (fail-closed if no reachable owner channel — the run stays blocked rather than posting a dead button into the thread) and mirrors a non-binding status comment into the task thread on request and on outcome.

package/channels/spaces/adapter.js

@@ -25,14 +25,14 @@ const spacesState = require("./state");
 const ENGAGE_TYPES = new Set(["mention", "reply", "task_assigned"]);
 
 class SpacesAdapter {
-  constructor({ id = "spaces", url = "https://api.spaces.kazee.africa", token, ownerUserId = "", conversational = true, taskLoopMode = "advisory" }) {
+  constructor({ id = "spaces", url = "https://api.spaces.kazee.africa", token, ownerUserId = "", taskLoopMode = "advisory" }) {
     this.id = id;
     this.type = "spaces";
     this.url = url.replace(/\/$/, "");
     this.token = token;
     this.ownerUserId = ownerUserId || "";
-    this.conversational = conversational;
-    this.taskLoopMode = taskLoopMode || "advisory";
+    // Env default posture; the live value is chat-overridable via spacesState.
+    this.taskLoopModeDefault = taskLoopMode || "advisory";
     this.client = new SpacesClient({ baseUrl: this.url, token });
     this._listeners = { message: new Set(), action: new Set() };
     this._socket = null;
@@ -85,6 +85,12 @@ class SpacesAdapter {
     return String(payload?.id || payload?._id || "");
   }
 
+  // Live task-loop posture: chat override (spacesState) wins over the env default.
+  _taskLoopMode() {
+    try { return spacesState.taskLoopMode(this.taskLoopModeDefault); }
+    catch (e) { return this.taskLoopModeDefault; }
+  }
+
   // Notifications arrive in two shapes: the socket payload
   // (broadcastNotification: flat {type,targetType,targetId,actorId,actorName})
   // and the REST row ({category, actorId:{...}, sourceEntityId, data.payload}).
@@ -137,13 +143,21 @@ class SpacesAdapter {
     const n = this._normalize(payload);
     if (!n.taskId) return;
 
+    // Receiving any Spaces notification proves membership → mark connected. This
+    // is the socket half of the hybrid "connected ⇒ conversational" signal; no
+    // env flag needed to turn auto-replies on.
+    try { spacesState.markSocketConnected(); } catch (e) {}
+
     // Advance this task's cursor (awareness events included) so it always
     // reflects the last activity we observed on the task.
     try { spacesState.recordCursor(n.taskId, { notificationId: id, type: n.type }); } catch (e) {}
 
     // Awareness-only types never auto-trigger a turn. They still fire an
     // "awareness" listener (if any) so the poller can track/surface them.
-    const engage = this.conversational && ENGAGE_TYPES.has(n.type);
+    // conversationalActive() = connected (central or socket) AND not owner-muted.
+    let active = false;
+    try { active = spacesState.conversationalActive(); } catch (e) {}
+    const engage = active && ENGAGE_TYPES.has(n.type);
     this._emit("awareness", { adapter: this, notificationId: id, source, ...n });
     if (!engage) return;
 
@@ -157,7 +171,7 @@ class SpacesAdapter {
       text: n.content || `[${n.type} on task ${n.title || n.taskId}]`,
       messageId: id,
       from: { id: n.actorId, name: n.actorName },
-      spaces: { taskId: n.taskId, spaceId: n.spaceId, notificationType: n.type, deepLink: n.deepLink, title: n.title, mode: this.taskLoopMode },
+      spaces: { taskId: n.taskId, spaceId: n.spaceId, notificationType: n.type, deepLink: n.deepLink, title: n.title, mode: this._taskLoopMode() },
       raw: payload,
     };
     // Per-task serialization: a task's turns run one at a time so two comments

package/channels/spaces/state.js

@@ -21,9 +21,28 @@ let store = null;
 function load() {
   if (store) return store;
   const raw = readJsonWithFallback(STATE_FILE, null) || {};
+  const rawConn = raw.connection && typeof raw.connection === "object" ? raw.connection : {};
+  const rawCtrl = raw.control && typeof raw.control === "object" ? raw.control : {};
   store = {
     processed: Array.isArray(raw.processed) ? raw.processed.slice(-PROCESSED_CAP) : [],
     tasks: raw.tasks && typeof raw.tasks === "object" ? raw.tasks : {},
+    // Connection signal (hybrid): central authoritatively lists Spaces among the
+    // bot's connected apps, OR the socket has actually received a Spaces
+    // notification (which only happens for a task the bot is a member of). Either
+    // one means "connected" — no env flag required.
+    connection: {
+      central: !!rawConn.central,
+      centralAt: rawConn.centralAt || 0,
+      socketFirstAt: rawConn.socketFirstAt || 0,
+      socketLastAt: rawConn.socketLastAt || 0,
+    },
+    // Owner control, set from chat (/spaces …) — never from env/filesystem, which
+    // the owner can't reach on a pod. `muted` is the off-switch for auto-replies;
+    // `taskLoopMode` overrides the env default posture.
+    control: {
+      muted: !!rawCtrl.muted,
+      taskLoopMode: rawCtrl.taskLoopMode || null,
+    },
   };
   return store;
 }
@@ -73,4 +92,87 @@ function snapshot() {
   return { tasks: s.tasks, processedCount: s.processed.length };
 }
 
-module.exports = { markProcessed, recordCursor, getCursor, snapshot, STATE_FILE };
+// --- Connection signal -----------------------------------------------------
+
+// Called on every inbound Spaces notification. Receiving one is proof the bot is
+// a member of that task's space, so it flips the socket-connected signal on.
+function markSocketConnected() {
+  const s = load();
+  const now = Date.now();
+  if (!s.connection.socketFirstAt) s.connection.socketFirstAt = now;
+  s.connection.socketLastAt = now;
+  save();
+}
+
+// Called by the connected-apps poller with central's authoritative answer to
+// "is Spaces among my connected apps?". Persisted so a restart keeps the signal
+// until the next poll refreshes it.
+function setCentralConnected(connected) {
+  const s = load();
+  const val = !!connected;
+  if (s.connection.central === val && s.connection.centralAt) return;
+  s.connection.central = val;
+  s.connection.centralAt = Date.now();
+  save();
+}
+
+// Hybrid: connected if central says so, or the socket has ever delivered a
+// Spaces notification. Membership is the real-world gate — you can't receive a
+// notification for a space you're not in — so socket-ever-connected is a safe,
+// sticky signal.
+function isConnected() {
+  const s = load();
+  return !!(s.connection.central || s.connection.socketFirstAt);
+}
+
+// --- Owner control (from chat) ---------------------------------------------
+
+function setMuted(muted) {
+  const s = load();
+  s.control.muted = !!muted;
+  save();
+  return s.control.muted;
+}
+
+function setTaskLoopMode(mode) {
+  const s = load();
+  const m = String(mode || "").toLowerCase();
+  s.control.taskLoopMode = ["advisory", "autonomous", "off"].includes(m) ? m : null;
+  save();
+  return s.control.taskLoopMode;
+}
+
+// The task-working posture for engaged Spaces turns: chat override wins, else the
+// env default the caller passes ("advisory" unless overridden).
+function taskLoopMode(envDefault = "advisory") {
+  const s = load();
+  return s.control.taskLoopMode || String(envDefault || "advisory").toLowerCase();
+}
+
+// The single gate the adapter/loopback/access all read: auto-replies are live
+// when the bot is connected to Spaces AND the owner hasn't paused them.
+function conversationalActive() {
+  const s = load();
+  return isConnected() && !s.control.muted;
+}
+
+// For /spaces status.
+function controlSnapshot() {
+  const s = load();
+  return {
+    connected: isConnected(),
+    central: s.connection.central,
+    socketFirstAt: s.connection.socketFirstAt,
+    socketLastAt: s.connection.socketLastAt,
+    muted: s.control.muted,
+    conversationalActive: conversationalActive(),
+    taskLoopMode: taskLoopMode(),
+    taskLoopOverride: s.control.taskLoopMode,
+  };
+}
+
+module.exports = {
+  markProcessed, recordCursor, getCursor, snapshot, STATE_FILE,
+  markSocketConnected, setCentralConnected, isConnected,
+  setMuted, setTaskLoopMode, taskLoopMode, conversationalActive, controlSnapshot,
+};

package/core/access.js

@@ -54,11 +54,11 @@ function isChatAuthorized(chatId) {
   if (!id) return false;
   // Spaces task threads authorize by participation: the bot only receives a
   // Spaces notification for a task it follows/was mentioned on, so the inbound
-  // itself is the authorization signal. Gated by OC_SPACES_CONVERSATIONAL so
-  // this has zero effect unless the conversational plane is deliberately on.
+  // itself is the authorization signal. Effective only while the conversational
+  // plane is active (connected to Spaces AND the owner hasn't paused replies).
   try {
     if (currentTransport() === "spaces"
-      && require("./project-transcripts").truthy(config.OC_SPACES_CONVERSATIONAL || process.env.OC_SPACES_CONVERSATIONAL, false)) {
+      && require("../channels/spaces/state").conversationalActive()) {
       return true;
     }
   } catch (e) {}

package/core/config.js

@@ -251,15 +251,13 @@ function loadChannels() {
           url,
           token,
           ownerUserId: config.SPACES_OWNER_USER_ID || "",
-          // Two independent gates: constructing the adapter (CHANNELS includes
-          // spaces) starts the socket for awareness; conversational (this flag,
-          // default OFF) is what lets a mention/reply actually run an agent
-          // turn. Keeps auto-replies behind a deliberate opt-in.
-          conversational: configTruthy(config.OC_SPACES_CONVERSATIONAL || process.env.OC_SPACES_CONVERSATIONAL, false),
-          // Task-working posture for engaged Spaces turns: "advisory" (default —
-          // read/reason/recommend, no autonomous write chains), "autonomous"
-          // (work to completion; writes still hit the owner-approval gate), or
-          // "off". Only shapes the agent's framing; approval safety is separate.
+          // Conversational auto-replies are no longer env-gated: the adapter
+          // enables them itself once Spaces is CONNECTED (central lists it, or
+          // the socket receives a notification) and the owner hasn't paused via
+          // /spaces. The socket always starts here for awareness.
+          // taskLoopMode is only the DEFAULT posture; /spaces mode overrides it
+          // live. "advisory" = read/reason/recommend; "autonomous" = work to
+          // completion (writes still hit the owner-approval gate); "off".
           taskLoopMode: String(config.OC_SPACES_TASK_LOOP || process.env.OC_SPACES_TASK_LOOP || "advisory").toLowerCase(),
         },
       });
@@ -283,6 +281,23 @@ function loadChannels() {
       console.error(`Unknown channel type: ${type} — skipping.`);
     }
   }
+  // Auto-include the Spaces channel whenever the bot has its own kzb_ token, even
+  // if CHANNELS didn't list it. Spaces is fixed infra on the same token as Kazee
+  // chat, and the owner can't edit CHANNELS on a pod — so "have token ⇒ Spaces
+  // available" is what makes auto-enable reachable without touching env. It's
+  // self-gating: no Spaces membership ⇒ no notifications ⇒ no replies.
+  if ((config.KAZEE_BOT_TOKEN) && !channels.some((c) => c.type === "spaces")) {
+    channels.push({
+      id: "spaces",
+      type: "spaces",
+      opts: {
+        url: config.SPACES_URL || SPACES_DEFAULT_URL,
+        token: config.KAZEE_BOT_TOKEN,
+        ownerUserId: config.SPACES_OWNER_USER_ID || "",
+        taskLoopMode: String(config.OC_SPACES_TASK_LOOP || process.env.OC_SPACES_TASK_LOOP || "advisory").toLowerCase(),
+      },
+    });
+  }
   return channels;
 }
 

package/core/connected-apps.js

@@ -169,6 +169,18 @@ async function tick() {
       console.error("connected-apps: apps refresh failed:", e.message);
     }
   }
+  // Central's authoritative half of the "connected ⇒ conversational" signal:
+  // tell the Spaces conversational plane whether central lists Spaces among this
+  // bot's apps. The socket half is set independently when a notification lands,
+  // so auto-replies work even before this endpoint is deployed.
+  try {
+    const spacesConnected = store.apps.some((a) => {
+      const c = connectorFor(a);
+      return c && c.appKey === "spaces";
+    });
+    require("../channels/spaces/state").setCentralConnected(spacesConnected);
+  } catch (e) {}
+
   for (const app of store.apps) {
     if (!connectorFor(app)) continue;
     await pollApp(app);

package/core/handlers.js

@@ -793,6 +793,55 @@ register({
   },
 });
 
+register({
+  name: "spaces", description: "Control Kazee Spaces auto-replies (status/pause/resume/mode)",
+  args: "<status | pause | resume | mode advisory|autonomous|off>", ownerOnly: true,
+  handler: async (env, { tail }) => {
+    if (!ownerEnv(env)) return;
+    let spacesState;
+    try { spacesState = require("../channels/spaces/state"); }
+    catch (e) { return send("Spaces state unavailable — the Spaces channel isn't loaded."); }
+    const parts = (tail || "").trim().split(/\s+/).filter(Boolean);
+    const op = (parts[0] || "status").toLowerCase();
+
+    const fmtTime = (ms) => (ms ? new Date(ms).toISOString().replace("T", " ").slice(0, 16) + "Z" : "never");
+    const statusText = () => {
+      const s = spacesState.controlSnapshot();
+      const src = s.central ? "central" : (s.socketFirstAt ? "socket" : "—");
+      const replies = s.conversationalActive ? "ON" : (s.connected ? "paused" : "off (not connected)");
+      const modeLine = s.taskLoopOverride
+        ? `${s.taskLoopMode} (override)`
+        : `${s.taskLoopMode} (default)`;
+      return [
+        "<b>Kazee Spaces</b>",
+        `Connected: ${s.connected ? "yes" : "no"}${s.connected ? ` (via ${src})` : ""}`,
+        `Auto-replies: ${replies}`,
+        `Task mode: ${modeLine}`,
+        `Last notification: ${fmtTime(s.socketLastAt)}`,
+      ].join("\n");
+    };
+
+    if (op === "status") return send(statusText());
+    if (op === "pause") {
+      spacesState.setMuted(true);
+      return send("Spaces auto-replies <b>paused</b>. Mentions/replies still hit the radar; I just won't answer until you /spaces resume.\n\n" + statusText());
+    }
+    if (op === "resume") {
+      spacesState.setMuted(false);
+      return send("Spaces auto-replies <b>resumed</b>.\n\n" + statusText());
+    }
+    if (op === "mode") {
+      const m = (parts[1] || "").toLowerCase();
+      if (!["advisory", "autonomous", "off"].includes(m)) {
+        return send("Usage: /spaces mode <advisory|autonomous|off>\n\n• advisory — read, reason, recommend (no autonomous write chains)\n• autonomous — work to completion (writes still need your approval)\n• off — no task-mode framing");
+      }
+      spacesState.setTaskLoopMode(m);
+      return send(`Spaces task mode set to <b>${m}</b>.\n\n` + statusText());
+    }
+    return send("Usage: /spaces <status | pause | resume | mode advisory|autonomous|off>");
+  },
+});
+
 register({
   name: "cluster", description: "Control this bot's own deployment (status/logs/restart/start/stop/scale/sync)",
   args: "<status|logs|restart|start|stop|scale 0|1|sync>", ownerOnly: true,

package/core/loopback.js

@@ -524,15 +524,14 @@ async function handleJson(req, res, url, kind) {
       // watched by non-owners, so the BINDING Approve/Deny goes to the owner's
       // real button channel (Telegram) while the task thread gets a non-binding
       // status mirror. Origin (channelId/adapter) still records the Spaces thread
-      // so a detached re-run wakes the agent back on the task. Gated by
-      // OC_SPACES_CONVERSATIONAL — off ⇒ byte-identical to the legacy path.
-      const { config: cfg } = require("./config");
+      // so a detached re-run wakes the agent back on the task. A Spaces run only
+      // reaches here when the conversational plane is active (connected + not
+      // muted), so any Spaces-origin approval routes to the owner.
       let buttonAdapter = adapter;
       let buttonChannel = channelId;
       let approverAdapter = "";
       let approverChannel = "";
-      const spacesOrigin = adapter.type === "spaces"
-        && require("./project-transcripts").truthy(cfg.OC_SPACES_CONVERSATIONAL || process.env.OC_SPACES_CONVERSATIONAL, false);
+      const spacesOrigin = adapter.type === "spaces";
       if (spacesOrigin) {
         const owner = require("./relationship").ownerTarget();
         const oa = owner

package/core/system-prompt.js

@@ -779,7 +779,10 @@ function buildSpacesTaskModeBlock() {
   let transport;
   try { transport = require("./context").currentTransport(); } catch (e) { transport = ""; }
   if (transport !== "spaces") return "";
-  const mode = String(config.OC_SPACES_TASK_LOOP ?? process.env.OC_SPACES_TASK_LOOP ?? "advisory").toLowerCase();
+  // Chat override (/spaces mode) wins over the env default posture.
+  const envDefault = String(config.OC_SPACES_TASK_LOOP ?? process.env.OC_SPACES_TASK_LOOP ?? "advisory").toLowerCase();
+  let mode = envDefault;
+  try { mode = require("../channels/spaces/state").taskLoopMode(envDefault); } catch (e) {}
   if (mode === "off") return "";
   if (mode === "autonomous") {
     return [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "3.0.16",
+  "version": "3.0.17",
   "description": "An always-on, provider-agnostic coding-agent harness for Claude Code and OpenAI Codex via chat",
   "main": "bot.js",
   "bin": {
@@ -10,7 +10,7 @@
     "setup": "node setup.js",
     "start": "node bot.js",
     "pretest": "node test-provider-fixture.js && node test-provider-core-prompt.js && node test-provider-prompt-parity.js && node test-provider-env-isolation.js && node test-provider-resume-parity.js && node test-provider-bootstrap.js && node test-provider-registry.js && node test-provider-stream-decoder.js && node test-provider-events.js && node test-provider-claude.js && node test-provider-codex.js && node test-provider-runner.js && node test-provider-run-lifecycle.js && node test-provider-gateway.js && node test-provider-side-chat.js && node test-single-runtime.js && node test-provider-migration-backup.js && node test-provider-state-migration.js && node test-provider-session-history.js && node test-provider-session-commands.js && node test-provider-compaction.js && node test-provider-scheduler.js && node test-cursor-removal.js && node test-utility-provider-policy.js && node test-provider-subagent.js && node test-provider-recall.js && node test-provider-pack-review.js && node test-memory-mutation-queue.js && node test-provider-dream.js && node test-provider-enforcer.js && node test-provider-tool-hooks.js && node test-provider-boot-matrix.js && node test-provider-capabilities.js && node test-provider-language.js && node test-provider-coupling-audit.js && node test-provider-parity-e2e.js && node test-kazee-channel-health.js",
-    "test": "OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node -e \"require('./vault'); console.log('OK')\" && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-runner-watchdog-static.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-usage-accounting.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-engine.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-discoverer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-project-transcripts-smoke.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-abilities.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-extraction.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-couse.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-transfer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-tiers.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-merge-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-learning-e2e.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-pack-nesting.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-journal-dedupe.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-read-signal.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tools.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tooling-mode.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-manifest.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-evolution.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-async.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-unified-identity.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-queue-routing.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-packs.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-persona.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-pipeline.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-relationship-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-relationship.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-enforcer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-identity-prune.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-message-id.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-delivery-contract.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-run-lock.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-web-sessions.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-poll-recovery.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-409-grace.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-conflict-heal-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-single-instance.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-streaming-split.js"
+    "test": "OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node -e \"require('./vault'); console.log('OK')\" && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-runner-watchdog-static.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-usage-accounting.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-engine.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-discoverer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-project-transcripts-smoke.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-abilities.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-extraction.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-couse.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-transfer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-tiers.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-ability-merge-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-learning-e2e.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-pack-nesting.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-journal-dedupe.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-read-signal.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tools.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-graph.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tooling-mode.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-tool-manifest.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-evolution.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-approval-async.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-unified-identity.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-queue-routing.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-packs.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-speaker-persona.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-persona-pipeline.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-recall-relationship-gate.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-relationship.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-enforcer.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-identity-prune.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-kazee-message-id.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-delivery-contract.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-run-lock.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-web-sessions.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-poll-recovery.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-409-grace.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-telegram-conflict-heal-guard.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-single-instance.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-streaming-split.js && OPEN_CLAUDIA_TEST=1 WORKSPACE=/tmp/open-claudia-test CLAUDE_PATH=./test-fixtures/fake-agent-cli.js FAKE_AGENT_KIND=claude AGENT_ENV_PASSTHROUGH=FAKE_AGENT_KIND node test-spaces-autoenable.js"
   },
   "files": [
     "bot.js",

package/test-provider-language.js

@@ -32,12 +32,13 @@ assert.doesNotMatch(setup, /Your Claude Code bot is connected|Description=Claude
 
 const pkg = JSON.parse(read("package.json"));
 assert.match(pkg.description, /provider-agnostic coding-agent harness/i);
-// 3.0.16 approved by Sumeet 2026-07-14 ("I want to upgrade and test"): the
-// Spaces connected-apps task-working loop (advisory) and the approval
-// thread-mirror ship dormant behind the existing OFF flags (OC_CONNECTED_APPS,
-// OC_SPACES_CONVERSATIONAL, OC_SPACES_TASK_LOOP=advisory) — no behaviour change
-// on Telegram/Kazee until a flag is flipped and the bot is a Spaces member.
-assert.strictEqual(pkg.version, "3.0.16", "release version must remain unchanged without explicit approval");
+// 3.0.17 approved by Sumeet 2026-07-14 ("Your call build and push"): Spaces
+// conversational plane now AUTO-ENABLES on connection (hybrid — central lists
+// Spaces OR the socket receives a notification) instead of the OC_SPACES_CONVERSATIONAL
+// env flag the owner can't reach on a pod. Control moves into chat via /spaces
+// (status|pause|resume|mode). The Spaces channel auto-includes whenever
+// KAZEE_BOT_TOKEN is set. Still self-gating: no Spaces membership ⇒ no replies.
+assert.strictEqual(pkg.version, "3.0.17", "release version must remain unchanged without explicit approval");
 for (const keyword of ["claude", "codex", "coding-agent", "provider-agnostic"]) {
   assert.ok(pkg.keywords.includes(keyword), `package keyword missing: ${keyword}`);
 }