zooid 0.9.1 → 0.11.0

package/README.md

@@ -6,10 +6,12 @@ Zooid is an open-source, self-hostable chat app for collaborating with AI agents
 
 **Full docs: [zooid.dev/docs](https://zooid.dev/docs)** · **Join the community server: [community.zoon.eco](https://community.zoon.eco)**
 
-- **Protocol-first.** Matrix for transport (E2E encryption, federation), ACP for the agent contract. Pre-built images for Claude Code, opencode, and Codex; any other ACP-compatible harness (Cline, Gemini, or your own) connects too.
-- **Containerized runtime.** Podman or Docker. Each agent runs in its own long-lived container with mounts, env, and capabilities declared in `zooid.yaml`.
-- **Workforce as code.** Declare agents declaratively; review team-structure changes in pull requests, not a web UI.
+- **Protocol-first.** Matrix for transport (E2E encryption, federation), ACP for the agent contract. Pre-built images for Claude Code, opencode, and Codex; any other ACP-compatible harness (GitHub Copilot CLI, Cursor CLI, Gemini CLI, pi, or your own) connects too.
+- **Run it anywhere.** Each daemon is a *workstation* with its own identity, running as many agents as you like — put it on your laptop, a box, a pod, or a cluster; it doesn't have to live next to the homeserver. Several workstations can share one homeserver.
+- **Containerized runtime.** Docker or Podman. Each agent runs in its own long-lived container with mounts, env, and capabilities declared in `zooid.yaml`.
 - **Multi-agent collaboration.** Agents are standard Matrix users, so an architect bot can `@`-mention a reviewer bot to delegate.
+- **Workforce as code.** Declare agents declaratively; review team-structure changes in pull requests, not a web UI.
+- **Push or pull.** Pick how the daemon and server connect. *Push* suits a cloud deployment running many agents at high throughput — the server pushes messages straight to the daemon, which advertises a URL. *Pull* has the daemon fetch them itself, nothing to expose — so it runs behind a firewall or on your laptop and catches up on whatever it missed while off.
 
 ## Quickstart
 
@@ -34,22 +36,46 @@ Boot the local stack:
 zooid dev
 ```
 
+> **Prerequisite:** `zooid dev` runs Tuwunel inside a container, so you need a container engine installed and running first — either **Docker** (with the daemon started) or **Podman** aliased as `docker`.
+
 `zooid dev` starts a Tuwunel Matrix homeserver in a container, generates the Application Service registration, registers an `admin:admin` user, runs the daemon, and serves the [Zooid web client](https://github.com/zooid-ai/clients).
 
 Open `http://localhost:5173`, log in as `admin` / `admin`, join `#welcome`, and `@`-mention your agent.
 
 For deployment recipes, the `zooid.yaml` reference, and a deeper tour of how the runtime works, see **[zooid.dev/docs](https://zooid.dev/docs)**.
 
+## Workstations & transport modes
+
+A Zooid daemon is a **workstation** — set a top-level `workstation:` in `zooid.yaml` and its agents get an exclusive `@{workstation}.{agent}:server` namespace. Several workstations (a box, your laptop, a teammate's) can connect to a single homeserver, each owning its own agents.
+
+How a workstation connects is set per-transport with `mode:` — the two choices (push/pull above), named by the value you put in the YAML:
+
+- **`appservice` (push)** — the homeserver delivers events to the daemon, so the daemon advertises an address the homeserver can reach: `port` (default `9099`) when they share a host or network, or an `advertise_url` when the daemon lives on a separate machine, pod, or cluster. Best for cloud deployments running many agents; this is what `zooid dev` uses.
+- **`client` (pull)** — the daemon fetches events itself, one outbound sync per agent, with nothing to expose. Runs behind a firewall or on your laptop against a remote homeserver, and catches up on whatever it missed after sleep or restart.
+
+```yaml
+workstation: my-laptop
+runtime: local
+transports:
+  matrix:
+    homeserver: https://your-homeserver.example
+    mode: client
+```
+
+Acting (sending, joining) is identical in both modes — only how the daemon ingests events differs.
+
 ## The stack
 
 Every layer is open and replaceable.
 
-| Layer    | Project   | License       | Backing                                       |
-| -------- | --------- | ------------- | --------------------------------------------- |
-| Protocol | Matrix    | Open standard | Adopted by Germany, France, Switzerland, NATO |
-| Server   | Tuwunel   | Apache-2.0    | Swiss government in production                |
-| Client   | Zooid web | Apache-2.0    | Built on `matrix-js-sdk`                      |
-| Runtime  | **Zooid** | MIT           | This project                                  |
+| Layer          | Project          | License       | Backing                                           |
+| -------------- | ---------------- | ------------- | ------------------------------------------------- |
+| Agent protocol | **ACP**          | Open standard | Backed by Zed and JetBrains                       |
+| Bridge         | **Zooid daemon** | MIT           | This project — the ACP–Matrix bridge              |
+| Server         | **Matrix**       | Open standard | Any homeserver — adopted by Germany, France, NATO |
+| Client         | **Zooid web**    | MIT           | Built on `matrix-js-sdk` (Apache-2.0)             |
+
+`zooid dev` runs [Tuwunel](https://github.com/matrix-construct/tuwunel) (Apache-2.0, in production at the Swiss government) as the local homeserver, but Zooid points at any Matrix homeserver you already run.
 
 ## Agent images
 

package/dist/bin.js

@@ -16,7 +16,7 @@ import {
   renderRegistration,
   startDaemonSocketServer,
   startWorkforcePublisher
-} from "./chunk-PDSJJWQW.js";
+} from "./chunk-OCRQ3LWL.js";
 
 // src/bin.ts
 import { resolve as resolve6 } from "path";

package/dist/{chunk-PDSJJWQW.js → chunk-OCRQ3LWL.js}

@@ -25632,7 +25632,9 @@ var MatrixClient = class {
       ];
     }
     if (opts.userPowerLevels && Object.keys(opts.userPowerLevels).length > 0) {
-      body.power_level_content_override = { users: opts.userPowerLevels };
+      const users = { ...opts.userPowerLevels };
+      if (users[opts.senderUserId] === void 0) users[opts.senderUserId] = 100;
+      body.power_level_content_override = { users };
     }
     const r = await this.fetch(
       `${this.homeserver}/_matrix/client/v3/createRoom?user_id=${encodeURIComponent(opts.senderUserId)}`,
@@ -26088,11 +26090,16 @@ function route(event, agents, threadStates) {
       continue;
     }
     if (threadState) {
-      const lastPoster = threadState.participants.at(-1);
-      if (lastPoster) {
-        if (lastPoster === a.name) matches.push(a);
-      } else if (threadState.rootMentions.includes(a.name)) {
-        matches.push(a);
+      const senderAgent = agents.find((x) => x.userId === event.sender);
+      if (senderAgent) {
+        if (threadState.callers[senderAgent.name] === a.name) matches.push(a);
+      } else {
+        const lastPoster = threadState.participants.at(-1);
+        if (lastPoster) {
+          if (lastPoster === a.name) matches.push(a);
+        } else if (threadState.rootMentions.includes(a.name)) {
+          matches.push(a);
+        }
       }
     }
   }
@@ -26220,14 +26227,20 @@ var BotPool = class {
                   this.agents,
                   room
                 );
-                resolved = await this.client.createRoom({
-                  roomAliasName: aliasLocalpart,
-                  invite: opts.adminUserId ? [opts.adminUserId] : [],
-                  senderUserId: sender,
-                  name: aliasLocalpart,
-                  ...opts.spaceRoomId ? { restrictedToSpaceId: opts.spaceRoomId } : {},
-                  ...userPowerLevels ? { userPowerLevels } : {}
-                });
+                try {
+                  resolved = await this.client.createRoom({
+                    roomAliasName: aliasLocalpart,
+                    invite: opts.adminUserId ? [opts.adminUserId] : [],
+                    senderUserId: sender,
+                    name: aliasLocalpart,
+                    ...opts.spaceRoomId ? { restrictedToSpaceId: opts.spaceRoomId } : {},
+                    ...userPowerLevels ? { userPowerLevels } : {}
+                  });
+                } catch (err) {
+                  const raced = await this.client.resolveAlias(room);
+                  if (!raced) throw err;
+                  resolved = raced;
+                }
               }
               aliasToId.set(room, resolved);
             }
@@ -26942,14 +26955,15 @@ function createMatrixTransport(opts) {
     if (matches.length > 0 && promotedRoot) {
       let st = threadStates.get(promotedRoot);
       if (!st) {
-        st = { participants: [], rootMentions: [] };
+        st = { participants: [], rootMentions: [], callers: {} };
         threadStates.set(promotedRoot, st);
       }
       const msgMentions = new Set(extractMentions(evt));
+      const senderAgent = bindings.find((b) => b.userId === evt.sender);
       for (const a of bindings) {
-        if (msgMentions.has(a.userId) && !st.rootMentions.includes(a.name)) {
-          st.rootMentions.push(a.name);
-        }
+        if (!msgMentions.has(a.userId)) continue;
+        if (!st.rootMentions.includes(a.name)) st.rootMentions.push(a.name);
+        if (senderAgent && a.name !== senderAgent.name) st.callers[a.name] = senderAgent.name;
       }
     }
     for (const a of matches) {
@@ -26958,7 +26972,7 @@ function createMatrixTransport(opts) {
         if (!promotedRoot) return;
         let st = threadStates.get(promotedRoot);
         if (!st) {
-          st = { participants: [], rootMentions: [] };
+          st = { participants: [], rootMentions: [], callers: {} };
           threadStates.set(promotedRoot, st);
         }
         if (st.participants.at(-1) !== a.name) st.participants.push(a.name);
@@ -27134,16 +27148,18 @@ function createMatrixTransport(opts) {
   };
 }
 async function rebuildThreadState(client, roomId, rootEventId, bindings) {
-  const state = { participants: [], rootMentions: [] };
+  const state = { participants: [], rootMentions: [], callers: {} };
   const asUser = (bindings.find((b) => b.rooms.some((r) => r.alias === roomId)) ?? bindings[0])?.userId;
   if (!asUser) return state;
   const root = await client.fetchEvent(roomId, rootEventId, asUser);
   if (root) {
     const rootMentions = new Set(extractMentions(root));
+    const rootSender = root.sender;
+    const rootSenderAgent = rootSender ? bindings.find((b) => b.userId === rootSender) : void 0;
     for (const a of bindings) {
-      if (rootMentions.has(a.userId) && !state.rootMentions.includes(a.name)) {
-        state.rootMentions.push(a.name);
-      }
+      if (!rootMentions.has(a.userId)) continue;
+      if (!state.rootMentions.includes(a.name)) state.rootMentions.push(a.name);
+      if (rootSenderAgent && a.name !== rootSenderAgent.name) state.callers[a.name] = rootSenderAgent.name;
     }
   }
   const { chunk: thread } = await client.fetchThreadRelations({
@@ -27153,15 +27169,16 @@ async function rebuildThreadState(client, roomId, rootEventId, bindings) {
   });
   for (const ev of thread) {
     const mentions = new Set(extractMentions(ev));
+    const evSender = ev.sender;
+    const evSenderAgent = evSender ? bindings.find((b) => b.userId === evSender) : void 0;
     for (const a of bindings) {
-      if (mentions.has(a.userId) && !state.rootMentions.includes(a.name)) {
-        state.rootMentions.push(a.name);
-      }
+      if (!mentions.has(a.userId)) continue;
+      if (!state.rootMentions.includes(a.name)) state.rootMentions.push(a.name);
+      if (evSenderAgent && a.name !== evSenderAgent.name) state.callers[a.name] = evSenderAgent.name;
     }
-    const sender = ev.sender;
     const type = ev.type;
-    if (type === "m.room.message" && sender) {
-      const a = bindings.find((b) => b.userId === sender);
+    if (type === "m.room.message" && evSender) {
+      const a = bindings.find((b) => b.userId === evSender);
       if (a && state.participants.at(-1) !== a.name) state.participants.push(a.name);
     }
   }
@@ -32554,6 +32571,7 @@ var McpZodTypeKind;
 
 // ../context-mcp/src/factory.ts
 import { createRequire } from "module";
+import { dirname } from "path";
 function resolveDefaultBin() {
   const req = createRequire(import.meta.url);
   return req.resolve("@zooid/context-mcp/bin");
@@ -32563,7 +32581,25 @@ function getDefaultBin() {
   if (!cachedDefaultBin) cachedDefaultBin = resolveDefaultBin();
   return cachedDefaultBin;
 }
+var CONTEXT_CONTAINER_BIN_DIR = "/zooid/context-mcp";
+var CONTEXT_CONTAINER_BIN = `${CONTEXT_CONTAINER_BIN_DIR}/bin.js`;
+var CONTEXT_CONTAINER_SOCK = "/zooid/context.sock";
+function contextContainerMounts(opts) {
+  const binFile = opts.binPath ?? getDefaultBin();
+  return [
+    { path: dirname(binFile), target: CONTEXT_CONTAINER_BIN_DIR, mode: "ro" },
+    { path: opts.sockPath, target: CONTEXT_CONTAINER_SOCK, mode: "rw" }
+  ];
+}
 function buildContextServerSpec(opts) {
+  if (opts.containerize) {
+    return {
+      name: "zooid-context",
+      command: "node",
+      args: [CONTEXT_CONTAINER_BIN, "--spawn-id", opts.spawnId],
+      env: [{ name: "ZOOID_DAEMON_SOCK", value: CONTEXT_CONTAINER_SOCK }]
+    };
+  }
   return {
     name: "zooid-context",
     command: process.execPath,
@@ -32713,6 +32749,15 @@ Set agents.<name>.container.image, top-level container.image, or use a preset th
     }
   }
   const contextSpawns = buildContextSpawns(cfg, opts);
+  if (cfg.runtime !== "local" && opts.daemonSockPath && contextSpawns) {
+    for (const name of Object.keys(cfg.agents)) {
+      if (!contextSpawns[name]) continue;
+      mountsByAgent[name] = [
+        ...mountsByAgent[name] ?? [],
+        ...contextContainerMounts({ sockPath: opts.daemonSockPath })
+      ];
+    }
+  }
   return new AcpAgentRegistry({
     runtime,
     agents: cfg.agents,
@@ -32758,7 +32803,11 @@ function buildContextSpawns(cfg, opts) {
           threadRef: { channelId: channelId ?? threadId, threadId },
           provider
         });
-        return buildContextServerSpec({ spawnId, sockPath });
+        return buildContextServerSpec({
+          spawnId,
+          sockPath,
+          containerize: cfg.runtime !== "local"
+        });
       };
     } else {
       result[name] = void 0;
@@ -32795,4 +32844,4 @@ export {
   startDaemonSocketServer,
   buildAcpRegistry
 };
-//# sourceMappingURL=chunk-PDSJJWQW.js.map
+//# sourceMappingURL=chunk-OCRQ3LWL.js.map