@inetafrica/open-claudia 3.0.19 → 3.0.20

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v3.0.20 — Spaces answers tags, and knows the owner
+
+- **A tag now actually gets a reply.** The Spaces server labels notifications with **plural** categories (`mentions`, `comments`, `reactions`, `task_updated`), but the conversational plane's engage set only matched the singular `mention` — so every real `@`-tag was silently downgraded to awareness-only and the bot never spoke. `ENGAGE_TYPES` now matches the plural forms (`mentions`/`replies`, singular aliases kept for safety). Plain comments, reactions and task updates stay awareness-only, so the "untagged comments hit the radar without auto-answering" rule is unchanged. Confirmed live: a real `mentions` notification was arriving and being dropped.
+- **The owner is recognised on Spaces.** Spaces principals are central/Kazee user ids, but `isConfiguredOwnerChannel` had no `spaces` branch, so the owner's own comments resolved to a fresh `spaces:<id>` canonical instead of their owner identity — classing the owner as **external** (default-deny) on every Spaces task. Added a `spaces` branch mapping to `KAZEE_OWNER_USER_ID` (the same id Spaces/Kazee/central share), so the owner is recognised, their Spaces turns unify into their one canonical brain, and the relationship guardrail no longer misfires on them.
+- **Agent-space / OpenClaw:** no new deps, no new env, no schema change; Docker image builds identically (FROM the pre-baked `:base`). Existing pods pick this up on their next approved upgrade.
+
 ## v3.0.19 — flattened to the top level (the folder-project model is gone)
 
 - **The bot always runs at the top-level workspace now — no more "Pick a project first."** The per-folder session model (pick a subfolder of `WORKSPACE`, scope the conversation to it) has been removed. `currentSession` defaults to the workspace root (`{ name: "Workspace", dir: WORKSPACE }`) at state creation and on every migration/load, so it is never null. This directly fixes Spaces (and any non-Telegram channel that never picked a folder) replying with a dead "Pick a project first:" project-picker instead of engaging — the picker gate was the only thing blocking it.

package/channels/spaces/adapter.js

@@ -21,8 +21,14 @@ const { SpacesClient, contentText } = require("./client");
 const { createSpacesSocket } = require("./socket");
 const spacesState = require("./state");
 
-// Notification `type`/`category` values that warrant a full agent turn.
-const ENGAGE_TYPES = new Set(["mention", "reply", "task_assigned"]);
+// Notification `type`/`category` values that warrant a full agent turn. The
+// Spaces server emits PLURAL categories (mentions, comments, reactions,
+// task_updated), so the engage set must match the plural forms — matching only
+// the singular "mention" silently dropped every real tag. Singular aliases are
+// kept in case a socket payload ever uses them. Awareness-only types (comments,
+// reactions, task_updated) are deliberately absent: they update the cursor but
+// never auto-reply.
+const ENGAGE_TYPES = new Set(["mention", "mentions", "reply", "replies", "task_assigned"]);
 
 class SpacesAdapter {
   constructor({ id = "spaces", url = "https://api.spaces.kazee.africa", token, ownerUserId = "", taskLoopMode = "advisory", pollMs }) {

package/core/identity.js

@@ -46,6 +46,10 @@ function isConfiguredOwnerChannel(transport, channelId) {
   try { cfg = require("./config"); } catch (e) { return false; }
   if (t === "telegram") return (cfg.CHAT_IDS || []).map(String).includes(c);
   if (t === "kazee") return !!cfg.config.KAZEE_OWNER_USER_ID && c === String(cfg.config.KAZEE_OWNER_USER_ID);
+  // Spaces principals are central/Kazee user ids, so the owner's Spaces actor id
+  // is the same configured Kazee owner id — recognise them on Spaces too, else
+  // the owner's own comments are classed external (default-deny).
+  if (t === "spaces") return !!cfg.config.KAZEE_OWNER_USER_ID && c === String(cfg.config.KAZEE_OWNER_USER_ID);
   if (t === "voice") return c === String(cfg.config.VOICE_OWNER_USER_ID || "voice-owner");
   // Web dashboard chat: fixed single-owner channel gated by the dashboard
   // session, so its identity is operator-implied rather than env-declared.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "3.0.19",
+  "version": "3.0.20",
   "description": "An always-on, provider-agnostic coding-agent harness for Claude Code and OpenAI Codex via chat",
   "main": "bot.js",
   "bin": {

package/test-provider-language.js

@@ -32,15 +32,14 @@ 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.19 approved by Sumeet 2026-07-14 ("Rip it out"): the per-folder
-// project/session model is removed. The bot always runs at the top-level
-// workspace — currentSession defaults to { name: "Workspace", dir: WORKSPACE }
-// and is never null — which fixes Spaces (and any channel that never picked a
-// folder) replying with a dead "Pick a project first:" picker. Removed
-// /projects, /session, the project keyboard, the show:projects/s: callbacks,
-// the router's five session gates, and core/projects.js. Conversation-level
-// controls (/sessions, /new, /continue, /end) are unchanged.
-assert.strictEqual(pkg.version, "3.0.19", "release version must remain unchanged without explicit approval");
+// 3.0.20 approved by Sumeet 2026-07-14 ("Yeh push it"): two Spaces fixes. (1)
+// The Spaces server emits PLURAL notification categories (mentions/comments/
+// reactions), so ENGAGE_TYPES now matches "mentions"/"replies" — matching only
+// singular "mention" silently dropped every real tag. (2) isConfiguredOwnerChannel
+// gained a "spaces" branch mapping to KAZEE_OWNER_USER_ID (Spaces principals are
+// central/Kazee ids), so the owner is no longer classed external (default-deny)
+// on their own Spaces comments. 3.0.19 flattened the folder-project model.
+assert.strictEqual(pkg.version, "3.0.20", "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}`);
 }