@inetafrica/open-claudia 3.0.18 → 3.0.20

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # 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.
+- **Removed the folder-picker surface.** Gone: `/projects`, `/session`, the project-selection inline keyboard, and the `show:projects` / `s:<name>` button callbacks. Also removed the four media "Pick a project first." gates (voice/audio/photo/document) and the text-handler gate in the router — all dead once a session always exists. `core/projects.js` is deleted.
+- **Conversation-level controls are unchanged.** `/sessions` (list past conversations), `/new` (fresh conversation), `/continue` (resume), `/end` (end current conversation — now resets to the root instead of clearing to null) all work as before, just always scoped to the one top-level workspace.
+- **`/cron add` no longer takes a `<project>` argument** — it schedules at the workspace root: `/cron add "<schedule>" "<prompt>"`. Existing crons with a stored project still resolve via the scheduler's descriptor.
+- **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.18 — Spaces reconciles its task list (assigned tasks no longer silently missed)
 
 - **Assigning a task to the bot now actually engages it.** An assignment creates the task but emits **no notification**, and the conversational plane only woke on a socket "notification" push — so a task assigned to the bot could sit there while the bot never noticed (confirmed live: bot could `listTasks` its assigned task, but had 0 notifications and never engaged). The adapter now runs a self-contained **reconciliation poll**: on its own timer it calls `listTasks()` (bot-scoped to its assigned tasks) and synthesises a `task_assigned` engage for any active task it hasn't engaged yet.

package/README.md

@@ -145,15 +145,16 @@ Each provider keeps its own persistent project session. Switching doesn't lose y
 
 ### Session management
 
+The bot runs at the top-level workspace; there is no per-folder project selection.
+
 | Command | Description |
 |---------|-------------|
-| `/session [<project>]` | Pick a project to work on |
-| `/sessions` | List past conversations for current project |
-| `/projects` | Browse all workspace projects |
+| `/new` | Start a fresh conversation |
+| `/sessions` | List past conversations |
 | `/continue` | Resume last conversation explicitly |
 | `/compact` | Summarize conversation context now |
 | `/compactwindow [<tokens> \| off \| default]` | Set the auto-compact token threshold |
-| `/end` | End current session |
+| `/end` | End the current conversation |
 
 When you select a project, the last conversation is automatically resumed. Tap "New conversation" to start fresh.
 
@@ -352,7 +353,7 @@ Foreground turns never silently fall back to a different provider. Utility work
 
 Conversation identity is the tuple of canonical user, project, provider, and native session ID. Claude Code and Codex histories and active pointers stay separate: switching providers restores only that provider's project session and never passes one provider's native session ID to another. Session-history entries are provider-tagged; ambiguous legacy records remain visible but non-selectable.
 
-Model, effort, budget, permission mode, and worktree settings are stored per provider. `/new` clears only the selected project/provider pointer, while `/end` closes the project selection without deleting history. Compaction and scheduled jobs capture an immutable provider/session tuple; an explicitly configured scheduled fallback starts fresh from a provider-neutral archived brief.
+Model, effort, budget, permission mode, and worktree settings are stored per provider. `/new` clears only the active provider's conversation pointer, while `/end` ends the current conversation (resetting to the top-level workspace) without deleting history. Compaction and scheduled jobs capture an immutable provider/session tuple; an explicitly configured scheduled fallback starts fresh from a provider-neutral archived brief.
 
 ## Provider migration and rollback
 
@@ -517,9 +518,9 @@ For direct npm installs, `/upgrade` updates Open Claudia itself and does not ins
 Schedule recurring tasks:
 
 ```
-/cron add "0 9 * * 1-5" myproject "Morning standup: summarize git changes since yesterday"
-/cron add "0 18 * * *" myproject "Git digest: what changed today?"
-/cron add "*/30 * * * *" myproject "Health check: verify the API is responding"
+/cron add "0 9 * * 1-5" "Morning standup: summarize git changes since yesterday"
+/cron add "0 18 * * *" "Git digest: what changed today?"
+/cron add "*/30 * * * *" "Health check: verify the API is responding"
 ```
 
 Presets available via `/cron` menu. The agent can also schedule its own jobs with `open-claudia cron-add` / `schedule-wakeup` (see Background Work).

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/actions.js

@@ -12,7 +12,6 @@ const {
   userOwnsProviderSession,
 } = require("./state");
 const { admitRunContext, runAgent } = require("./runner");
-const { listProjects, projectKeyboard } = require("./projects");
 const { isChatOwner, approveAuthRequest, denyAuthRequest, authRequestLabel } = require("./access");
 const accessStore = require("./access");
 const peopleStore = require("./people");
@@ -282,8 +281,6 @@ async function handleAction(envelope) {
 
   if (d.startsWith("ob:")) { finishOnboarding(d.slice(3)); return; }
 
-  if (d === "show:projects") { await send("Pick:", { keyboard: projectKeyboard() }); return; }
-  if (d.startsWith("s:")) { startSession(d.slice(2)); return; }
   if (d.startsWith("ss:")) {
     const resolved = resolveSessionCallbackAction(d.slice(3), state);
     if (resolved.status !== "ok") {
@@ -299,7 +296,7 @@ async function handleAction(envelope) {
     const expected = proj === "__workspace__" ? "Workspace" : proj;
     const result = startNewConversation({ state, projectName: expected });
     if (!result.ok) return send("That new-conversation button is stale. Open /sessions again.");
-    await send(`Session: ${state.currentSession.name}\nNew conversation\n\nSend text, voice, or images.\n\n/sessions — switch conversation\n/session — switch project`);
+    await send("New conversation\n\nSend text, voice, or images.\n\n/sessions — switch conversation");
     return;
   }
   if (d === "a:continue") {
@@ -310,11 +307,9 @@ async function handleAction(envelope) {
     });
   }
   if (d === "a:end") {
-    if (state.currentSession) {
-      const result = endCurrentSession({ state });
-      if (!result.ok) return send(`Could not end session: ${result.error.message}`);
-      await send(`Ended: ${result.project}`, { keyboard: { inline_keyboard: [[{ text: "New", callback_data: "show:projects" }]] } });
-    }
+    const result = endCurrentSession({ state });
+    if (!result.ok) return send(`Could not end conversation: ${result.error.message}`);
+    await send("Ended. Send anything to start a fresh conversation.");
     return;
   }
   if (d === "noop") return;

package/core/handlers.js

@@ -14,7 +14,7 @@ const {
 const { register } = require("./commands");
 const { send, deleteMessage } = require("./io");
 const {
-  currentState, saveState,
+  currentState, saveState, rootSession,
   freshUsage, getActiveProvider, getProviderSession, setProviderSession, clearProviderSession,
   getProviderSettings,
   getProjectSessions, getLastProjectSession, userOwnsProviderSession,
@@ -23,7 +23,6 @@ const {
 const { canonicalForChannel, canonicalForTelegram, normalizeCanonicalUserId, channelKey, identities, isConfiguredOwnerChannel, removeIdentityMapping } = require("./identity");
 const { isChatAuthorized, isChatOwner, recordPendingAuthRequest, authRequestLabel, hasOwner, bootstrapOwner } = require("./access");
 const { isOnboarded, startOnboarding } = require("./onboarding");
-const { listProjects, findProject, projectKeyboard } = require("./projects");
 const { vault } = require("./vault-store");
 const keyring = require("./keyring");
 const { redactSensitive, registerSecrets } = require("./redact");
@@ -60,10 +59,13 @@ function ownerEnv(envelope) {
   return isChatOwner(envelope.channelId);
 }
 
+// Everything runs at the top-level workspace now, so there is nothing to gate
+// on: ensure a root session exists and always proceed.
 function requireSession() {
-  if (!currentState().currentSession) {
-    send("Pick a project first:", { keyboard: projectKeyboard() });
-    return false;
+  const state = currentState();
+  if (!state.currentSession) {
+    state.currentSession = rootSession();
+    saveState();
   }
   return true;
 }
@@ -274,11 +276,10 @@ function startNewConversation(options = {}) {
 
 function endCurrentSession(options = {}) {
   const state = options.state || currentState();
-  if (!state.currentSession) return { ok: false, error: Object.assign(new Error("No session"), { code: "NO_SESSION" }) };
   const previous = { currentSession: state.currentSession, isFirstMessage: state.isFirstMessage };
-  const project = state.currentSession.name;
-  clearTransientQueue(state, "The project session ended before the queued run started");
-  state.currentSession = null;
+  const project = state.currentSession?.name || "Workspace";
+  clearTransientQueue(state, "The conversation ended before the queued run started");
+  state.currentSession = rootSession();
   state.isFirstMessage = true;
   state.cancelRequested = false;
   const persisted = persistSessionControl(state, options, () => {
@@ -295,29 +296,21 @@ function activeContinueOptions(state = currentState()) {
   return sessionId ? { provider, resumeSessionId: sessionId } : null;
 }
 
+// Resume a past conversation at the top-level workspace. Folder selection is
+// gone; `name` is retained for the recorded project key (always "Workspace").
 function startSession(name, resumeSessionId, options = {}) {
   const state = currentState();
   const provider = options.provider || getActiveProvider(state);
-  let projectName, projectDir;
-  if (name === "__workspace__") {
-    projectName = "Workspace";
-    projectDir = WORKSPACE;
-  } else {
-    const result = findProject(name);
-    if (!result) return send(`No match for "${name}".`, { keyboard: projectKeyboard() });
-    if (Array.isArray(result)) return send("Multiple matches:", { keyboard: { inline_keyboard: result.map((p) => [{ text: p, callback_data: `s:${p}` }]) } });
-    projectName = result;
-    projectDir = path.join(WORKSPACE, result);
-  }
+  const projectName = "Workspace";
 
-  if (!provider) return send("Choose Claude Code or OpenAI Codex with /backend before opening a project session.");
+  if (!provider) return send("Choose Claude Code or OpenAI Codex with /backend before starting a conversation.");
 
   if (resumeSessionId && !userOwnsProviderSession(state.userId, projectName, provider, resumeSessionId)) {
-    return send("That conversation is unavailable for this project and provider. Open /sessions again.");
+    return send("That conversation is unavailable for this provider. Open /sessions again.");
   }
 
-  const selected = selectProjectState({ name: projectName, dir: projectDir }, { state, persist: false });
-  if (!selected.ok) return send(`Could not select project: ${selected.error.message}`);
+  const selected = selectProjectState(rootSession(), { state, persist: false });
+  if (!selected.ok) return send(`Could not start conversation: ${selected.error.message}`);
 
   if (resumeSessionId) {
     setProviderSession(state, provider, projectName, resumeSessionId);
@@ -326,21 +319,21 @@ function startSession(name, resumeSessionId, options = {}) {
     const title = s ? s.title : "";
     state.isFirstMessage = false;
     saveState();
-    send(`Session: ${projectName}\nResumed: ${title || resumeSessionId.slice(0, 8)}\n\nSend text, voice, or images.\n\n/sessions — switch conversation\n/session — switch project`);
+    send(`Resumed: ${title || resumeSessionId.slice(0, 8)}\n\nSend text, voice, or images.\n\n/sessions — switch conversation`);
   } else {
     const last = getLastProjectSession(state.userId, projectName, provider);
     if (last) {
       setProviderSession(state, provider, projectName, last.id);
       state.isFirstMessage = false;
       saveState();
-      send(`Session: ${projectName}\nResumed: ${last.title}\n\nSend text, voice, or images.\n\n/sessions — switch conversation\n/session — switch project`, {
+      send(`Resumed: ${last.title}\n\nSend text, voice, or images.\n\n/sessions — switch conversation`, {
         keyboard: { inline_keyboard: [[{ text: "New conversation", callback_data: `new:${projectName}` }]] },
       });
     } else {
       const existing = getProviderSession(state, provider, projectName);
       state.isFirstMessage = !existing;
       saveState();
-      send(`Session: ${projectName}${existing ? `\nResumed: ${existing.slice(0, 8)}` : ""}\n\nSend text, voice, or images.\n\n/sessions — switch conversation\n/session — switch project`);
+      send(`Ready.${existing ? `\nResumed: ${existing.slice(0, 8)}` : ""}\n\nSend text, voice, or images.\n\n/sessions — switch conversation`);
     }
   }
 }
@@ -361,7 +354,8 @@ register({
   handler: async (env) => {
     if (!authorized(env)) return;
     if (!isOnboarded()) return startOnboarding();
-    send("Pick a project to start:", { keyboard: { inline_keyboard: [[{ text: "Pick a project", callback_data: "show:projects" }]] } });
+    requireSession();
+    send("Ready. Send text, voice, or images.\n\n/sessions — switch conversation · /new — fresh conversation");
   },
 });
 
@@ -370,7 +364,7 @@ register({
   handler: async (env) => {
     if (!authorized(env)) return;
     send([
-      "Session: /session /sessions /projects /continue /status /stop /end",
+      "Session: /new /sessions /continue /status /stop /end",
       "Settings: /model /effort /budget /plan /compact /compactwindow /worktree /mode /engine /recall /tooltrace /toolmode /verbose",
       "Identity: /whoami /link",
       "Team: /people /intros /auth (owner)",
@@ -890,23 +884,7 @@ register({
 });
 
 register({
-  name: "projects", description: "Browse all workspace projects",
-  handler: async (env) => { if (authorized(env)) send("Pick:", { keyboard: projectKeyboard() }); },
-});
-
-register({
-  name: "session", description: "Pick a project to work on", args: "[<project>]",
-  handler: async (env, { tail }) => {
-    if (!authorized(env)) return;
-    if (tail) return startSession(tail);
-    const cs = currentState().currentSession;
-    if (cs) send(`Active: ${cs.name}\n\nSwitch?`, { keyboard: projectKeyboard() });
-    else send("Pick:", { keyboard: projectKeyboard() });
-  },
-});
-
-register({
-  name: "sessions", description: "List conversations for this project",
+  name: "sessions", description: "List past conversations",
   handler: async (env) => {
     if (!authorized(env)) return;
     if (!requireSession()) return;
@@ -1452,15 +1430,13 @@ register({
 });
 
 register({
-  name: "end", description: "End current session",
+  name: "end", description: "End the current conversation",
   handler: async (env) => {
     if (!authorized(env)) return;
     const state = currentState();
-    if (state.currentSession) {
-      const result = endCurrentSession({ state });
-      if (!result.ok) return send(`Could not end session: ${result.error.message}`);
-      send(`Ended: ${result.project}`, { keyboard: { inline_keyboard: [[{ text: "New session", callback_data: "show:projects" }]] } });
-    } else send("No session.");
+    const result = endCurrentSession({ state });
+    if (!result.ok) return send(`Could not end conversation: ${result.error.message}`);
+    send("Ended. Send anything to start a fresh conversation.");
   },
 });
 
@@ -1980,7 +1956,7 @@ register({
     if (!tail) {
       const list = channelJobs();
       if (list.length === 0) {
-        return send("No crons." + archivedNote() + "\n\nAdd: /cron add \"<schedule>\" <project> \"<prompt>\"\n\nOr pick a preset:", {
+        return send("No crons." + archivedNote() + "\n\nAdd: /cron add \"<schedule>\" \"<prompt>\"\n\nOr pick a preset:", {
           keyboard: { inline_keyboard: [
             [{ text: "Standup 9am", callback_data: "cp:standup" }, { text: "Git digest 6pm", callback_data: "cp:git" }],
             [{ text: "Dep check Mon", callback_data: "cp:deps" }, { text: "Health 30min", callback_data: "cp:health" }],
@@ -1990,24 +1966,23 @@ register({
       return send("Crons:\n\n" + list.map((c, i) => `${i + 1}. ${c.label} (${c.schedule}) — ${c.project || ""}`).join("\n") + archivedNote() + "\n\nRemove: /cron remove <#>");
     }
 
-    const addMatch = tail.match(/^add\s+"(.+)"\s+(\S+)\s+"(.+)"$/);
+    const addMatch = tail.match(/^add\s+"(.+)"\s+"(.+)"$/);
     if (addMatch) {
       if (!cronLib.validate(addMatch[1])) return send("Invalid cron schedule.");
-      const proj = findProject(addMatch[2]);
-      if (!proj || Array.isArray(proj)) return send("Project not found.");
       scheduler.addJob({
         kind: "cron",
         adapter: env.adapter.id,
         adapterType: env.adapter.type,
         channelId: String(env.channelId),
         canonicalUserId: env.canonicalUserId,
-        project: proj,
-        prompt: addMatch[3],
-        label: addMatch[3].slice(0, 50),
+        project: "Workspace",
+        projectDir: WORKSPACE,
+        prompt: addMatch[2],
+        label: addMatch[2].slice(0, 50),
         source: "user",
         schedule: addMatch[1],
       });
-      return send(`Added: ${addMatch[3].slice(0, 50)} (${addMatch[1]}) for ${proj}`);
+      return send(`Added: ${addMatch[2].slice(0, 50)} (${addMatch[1]})`);
     }
 
     const removeMatch = tail.match(/^remove\s+(\d+)$/);
@@ -2019,7 +1994,7 @@ register({
       return send(`Removed: ${removed ? removed.label : "(unknown)"}`);
     }
 
-    send('Usage: /cron | /cron add "<schedule>" <project> "<prompt>" | /cron remove <#>');
+    send('Usage: /cron | /cron add "<schedule>" "<prompt>" | /cron remove <#>');
   },
 });
 

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/core/onboarding.js

@@ -89,9 +89,7 @@ You are ${data.name}'s personal AI coding assistant, running 24/7 across chat ch
   saveEnvKey("ONBOARDED", "true");
   config.ONBOARDED = "true";
 
-  send(`All set, ${data.name}! I'm configured and ready.\n\nTap /session to pick a project and start working.`, {
-    keyboard: { inline_keyboard: [[{ text: "Pick a project", callback_data: "show:projects" }]] },
-  });
+  send(`All set, ${data.name}! I'm configured and ready.\n\nSend text, voice, or images to get started. /help lists everything.`);
 }
 
 module.exports = { isOnboarded, startOnboarding, handleOnboarding, finishOnboarding };

package/core/router.js

@@ -155,7 +155,6 @@ async function onAction(envelope) {
 async function handleVoice(envelope) {
   if (isDuplicate(envelope)) return;
   const state = currentState();
-  if (!state.currentSession) return send("Pick a project first.");
   try {
     const media = envelope.media?.[0];
     if (!media) return;
@@ -190,7 +189,6 @@ async function handleVoice(envelope) {
 async function handleAudio(envelope) {
   if (isDuplicate(envelope)) return;
   const state = currentState();
-  if (!state.currentSession) return send("Pick a project first.");
   try {
     const media = envelope.media?.[0];
     if (!media) return;
@@ -214,7 +212,6 @@ async function handleAudio(envelope) {
 async function handlePhoto(envelope) {
   if (isDuplicate(envelope)) return;
   const state = currentState();
-  if (!state.currentSession) return send("Pick a project first.");
   try {
     const items = envelope.media || [];
     if (!items.length) return;
@@ -244,7 +241,6 @@ async function handlePhoto(envelope) {
 async function handleDocument(envelope) {
   if (isDuplicate(envelope)) return;
   const state = currentState();
-  if (!state.currentSession) return send("Pick a project first.");
   try {
     const media = envelope.media?.[0];
     if (!media) return;
@@ -399,11 +395,6 @@ async function handleText(envelope) {
     return;
   }
 
-  if (!state.currentSession) {
-    const { projectKeyboard } = require("./projects");
-    return send("Pick a project first:", { keyboard: projectKeyboard() });
-  }
-
   const text = envelope.text || "";
   const runContext = admitRunContext(text, state.currentSession.dir, envelope.messageId, { purpose: "foreground" });
   const attachments = [];

package/core/state.js

@@ -7,7 +7,7 @@ const path = require("path");
 const crypto = require("crypto");
 const {
   STATE_FILE, SESSIONS_FILE, IDENTITIES_FILE, CONFIG_DIR, CHAT_ID, UNIFIED_IDENTITY,
-  JOBS_FILE, CRONS_FILE,
+  JOBS_FILE, CRONS_FILE, WORKSPACE,
 } = require("./config");
 const {
   normalizeCanonicalUserId,
@@ -292,7 +292,7 @@ function migrateSavedUser(value) {
 
   const result = {
     ...source,
-    currentSession: isRecord(source.currentSession) ? { ...source.currentSession } : null,
+    currentSession: isRecord(source.currentSession) ? { ...source.currentSession } : rootSession(),
     settings,
     activeSessions,
     providerSettings,
@@ -496,6 +496,14 @@ function attachRuntimeAccessors(state) {
   return state;
 }
 
+// The bot runs at a single top-level working directory. There is no per-folder
+// project picker anymore, so every state starts already "in" the workspace
+// root and currentSession is never null — readers (cwd, transcripts, usage) can
+// rely on it being present on every channel, including the Spaces poller.
+function rootSession() {
+  return { name: "Workspace", dir: WORKSPACE || process.cwd() };
+}
+
 function createUserState(userId) {
   const saved = (savedState.users && savedState.users[userId]) || {};
   const hasSavedUser = hadPersistedStateFile
@@ -510,7 +518,7 @@ function createUserState(userId) {
   const state = {
     userId: String(userId),
     channelId: currentChannelId(),
-    currentSession: saved.currentSession || null,
+    currentSession: saved.currentSession || rootSession(),
     runningProcess: null,
     preparingRun: false,
     cancelRequested: false,
@@ -1296,6 +1304,7 @@ module.exports = {
   getActiveUsage,
   getUsageForSession,
   usageSessionKey,
+  rootSession,
   createUserState,
   getUserState,
   currentState,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "3.0.18",
+  "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.18 approved by Sumeet 2026-07-14 ("Yeah, go for it build it push it out"):
-// the Spaces conversational plane now also RECONCILES against its task list. An
-// assignment creates a task but emits NO notification, and the socket-push-only
-// path missed it — so the adapter drives its own timer that calls listTasks()
-// (bot-scoped to assigned tasks) and synthesises a task_assigned engage for any
-// active task it hasn't engaged, with per-task dedup so the socket path isn't
-// doubled. A successful listTasks() is a third connection leg (markRestConnected)
-// that survives socket churn. Builds on 3.0.17's connection-based auto-enable.
-assert.strictEqual(pkg.version, "3.0.18", "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}`);
 }

package/test-provider-session-commands.js

@@ -96,7 +96,7 @@ function newEndAndContinueProbe() {
 
   const ended = handlers.endCurrentSession({ state, persist: false });
   assert.strictEqual(ended.ok, true);
-  assert.strictEqual(state.currentSession, null);
+  assert.strictEqual(state.currentSession.name, "Workspace", "ending resets to the top-level workspace, never null");
   assert.strictEqual(stateApi.getProviderSession(state, "codex", "alpha"), "codex-alpha");
   assert.strictEqual(stateApi.getProviderSession(state, "claude", "alpha"), "claude-alpha");
   assert.strictEqual(stateApi.userOwnsProviderSession(state.userId, "alpha", "codex", "codex-alpha"), true);

package/core/projects.js

@@ -1,43 +0,0 @@
-// Workspace project utilities. Reads filesystem; no IO dependencies.
-
-const fs = require("fs");
-const path = require("path");
-const { WORKSPACE } = require("./config");
-
-function listProjects() {
-  try {
-    return fs.readdirSync(WORKSPACE, { withFileTypes: true })
-      .filter((d) => d.isDirectory())
-      .map((d) => d.name)
-      .filter((n) => !n.startsWith("."));
-  } catch (e) { return []; }
-}
-
-function findProject(query) {
-  const projects = listProjects();
-  const q = query.toLowerCase();
-  const exact = projects.find((p) => p.toLowerCase() === q);
-  if (exact) return exact;
-  const startsWith = projects.filter((p) => p.toLowerCase().startsWith(q));
-  if (startsWith.length === 1) return startsWith[0];
-  const contains = projects.filter((p) => p.toLowerCase().includes(q));
-  if (contains.length === 1) return contains[0];
-  return contains.length > 0 ? contains : null;
-}
-
-function projectKeyboard() {
-  const projects = listProjects();
-  const rows = [[{ text: "\u{1F4C1} Workspace (root)", callback_data: "s:__workspace__" }]];
-  for (let i = 0; i < projects.length; i += 2) {
-    const row = [{ text: projects[i], callback_data: `s:${projects[i]}` }];
-    if (projects[i + 1]) row.push({ text: projects[i + 1], callback_data: `s:${projects[i + 1]}` });
-    rows.push(row);
-  }
-  return { inline_keyboard: rows };
-}
-
-function workspacePath(name) {
-  return name === "__workspace__" ? WORKSPACE : path.join(WORKSPACE, name);
-}
-
-module.exports = { listProjects, findProject, projectKeyboard, workspacePath };