zooid 0.11.2 → 0.12.0

package/README.md

@@ -2,11 +2,11 @@
 
 > A chat app to collaborate with AI agents, alongside the rest of your team. Open-source, self-hostable, any model, any CLI.
 
-Zooid is an open-source, self-hostable chat app for collaborating with AI agents alongside your team. It brings [ACP](https://agentclientprotocol.com)-compatible agents (Claude Code, [opencode](https://opencode.ai), Codex, …) into [Matrix](https://matrix.org) rooms as first-class participants — people and agents in the same rooms, threads, and approvals, no separate "AI dashboard," no vendor lock-in. Deploy with `zooid init`, run with `zooid dev`.
+Zooid is an open-source, self-hostable chat app for collaborating with AI agents alongside your team. It brings [ACP](https://agentclientprotocol.com)-compatible agents (Claude Code, [opencode](https://opencode.ai), Codex, pi, …) into [Matrix](https://matrix.org) rooms as first-class participants — people and agents in the same rooms, threads, and approvals, no separate "AI dashboard," no vendor lock-in. Deploy with `zooid init`, run with `zooid dev`.
 
 **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 (GitHub Copilot CLI, Cursor CLI, Gemini CLI, pi, or your own) connects too.
+- **Protocol-first.** Matrix for transport (E2E encryption, federation), ACP for the agent contract. Pre-built images for Claude Code, opencode, Codex, and pi; any other ACP-compatible harness (GitHub Copilot CLI, Cursor CLI, Gemini CLI, 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.
@@ -28,7 +28,9 @@ mkdir my-workforce && cd my-workforce
 zooid init
 ```
 
-`zooid init` asks which harness (Claude Code, opencode, Codex, …), which model provider, and how to authenticate. It writes a clean `zooid.yaml` and any `.env` it needs.
+`zooid init` asks which harness (`claude`, `codex`, `opencode`, `pi`), which model provider, and how to authenticate. It writes a clean `zooid.yaml` and any `.env` it needs.
+
+Every preset can run off a subscription you already have instead of a fresh API key. `pi` goes a step further: it only offers that choice once it has actually found a `pi` login, inherits the `defaultProvider` / `defaultModel` you already run, and gives the agent its own relocated config dir (`.pi-agent/`) so it never writes into your `~/.pi`.
 
 Boot the local stack:
 
@@ -85,6 +87,7 @@ Zooid publishes a small set of base images on GHCR. Drop one into `zooid.yaml` u
 - `ghcr.io/zooid-ai/agent-claude-code` — agent-base + the Claude Code ACP shim.
 - `ghcr.io/zooid-ai/agent-codex` — agent-base + the Codex ACP shim.
 - `ghcr.io/zooid-ai/agent-opencode` — agent-base + opencode.
+- `ghcr.io/zooid-ai/agent-pi` — agent-base + pi + pi-acp.
 
 The persona — `CLAUDE.md` / `AGENTS.md`, `.claude/settings.json`, skills, MCP servers — lives in the agent's `workdir` on the host. Zooid bind-mounts that directory into the container at runtime, so the shim picks it up the same way it would on your laptop. No `docker build`, no custom image, no rebuild when you tweak instructions.
 

package/dist/bin.js

@@ -16,7 +16,7 @@ import {
   renderRegistration,
   startDaemonSocketServer,
   startWorkforcePublisher
-} from "./chunk-KGYQ5YNP.js";
+} from "./chunk-3Q4BPAZD.js";
 
 // src/bin.ts
 import { resolve as resolve6 } from "path";
@@ -1494,12 +1494,13 @@ function loadEnvFiles(cwd) {
 }
 
 // src/commands/init.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, readdirSync as readdirSync2, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync5, readdirSync as readdirSync2, symlinkSync, writeFileSync as writeFileSync5 } from "fs";
+import { homedir as homedir2 } from "os";
 import { dirname as dirname7, join as join14, resolve as resolve4 } from "path";
 
 // src/commands/init/generators.ts
 function generateZooidYaml(opts) {
-  const acpBlock = opts.preset === "opencode" || !opts.model ? `    acp: { preset: ${opts.preset} }` : `    acp:
+  const acpBlock = opts.preset === "opencode" || opts.preset === "pi" || !opts.model ? `    acp: { preset: ${opts.preset} }` : `    acp:
       preset: ${opts.preset}
       model: ${opts.model}`;
   return `runtime: local
@@ -1586,7 +1587,10 @@ function generateEnv(opts) {
 `;
 }
 function generateGitignore() {
-  return [".env", "node_modules/", "data/", ""].join("\n");
+  return [".env", ".pi-agent/", "node_modules/", "data/", ""].join("\n");
+}
+function generatePiSettings(opts) {
+  return JSON.stringify({ defaultProvider: opts.provider, defaultModel: opts.model }, null, 2) + "\n";
 }
 function generateOpencodeReadme() {
   return `See https://opencode.ai/config for the full opencode.json schema, including
@@ -1643,18 +1647,59 @@ function findSimplePreset(name) {
 function findOpencodeProvider(id) {
   return OPENCODE_PROVIDERS.find((p) => p.id === id);
 }
+var PI_PROVIDERS = [
+  {
+    id: "openrouter",
+    label: "OpenRouter",
+    description: "many providers via OpenRouter credits",
+    apiKeyEnvVar: "OPENROUTER_API_KEY"
+  },
+  {
+    id: "anthropic",
+    label: "Anthropic",
+    description: "Claude via direct Anthropic API key",
+    apiKeyEnvVar: "ANTHROPIC_API_KEY"
+  },
+  {
+    id: "openai",
+    label: "OpenAI",
+    description: "GPT via direct OpenAI API key",
+    apiKeyEnvVar: "OPENAI_API_KEY"
+  }
+];
+var PI_DEFAULT_PROVIDER = "openrouter";
+var PI_DEFAULT_MODEL = "deepseek/deepseek-v4-pro";
+var PI_AGENT_DIR = ".pi-agent";
+var PI_AUTH_FILE = ".pi/agent/auth.json";
+var PI_SETTINGS_FILE = ".pi/agent/settings.json";
+function findPiProvider(id) {
+  return PI_PROVIDERS.find((p) => p.id === id);
+}
 
 // src/commands/init/sniff.ts
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
 import { homedir } from "os";
 import { join as join13 } from "path";
 function sniffCredentials(preset, home = homedir()) {
-  const meta = findSimplePreset(preset);
-  if (!meta) return { found: false };
-  const full = join13(home, meta.credentialDir);
+  const rel = preset === "pi" ? PI_AUTH_FILE : findSimplePreset(preset)?.credentialDir;
+  if (!rel) return { found: false };
+  const full = join13(home, rel);
   if (existsSync6(full)) return { found: true, path: full };
   return { found: false };
 }
+function sniffPiDefaults(home = homedir()) {
+  const source = join13(home, PI_SETTINGS_FILE);
+  try {
+    const raw = JSON.parse(readFileSync7(source, "utf8"));
+    const provider = raw.defaultProvider;
+    const model = raw.defaultModel;
+    if (typeof provider !== "string" || !provider) return void 0;
+    if (typeof model !== "string" || !model) return void 0;
+    return { provider, model, source };
+  } catch {
+    return void 0;
+  }
+}
 
 // src/commands/init.ts
 var IGNORED_PREEXISTING = /* @__PURE__ */ new Set([
@@ -1680,6 +1725,7 @@ async function runInit(opts) {
     }
   }
   const writes = [];
+  let piInherited;
   if (opts.preset === "claude" || opts.preset === "codex") {
     if (!opts.auth) throw new Error("--auth (subscription|api-key) is required for claude/codex");
     const meta = findSimplePreset(opts.preset);
@@ -1732,6 +1778,34 @@ async function runInit(opts) {
         content: generateEnv({ envVar: providerMeta.apiKeyEnvVar, value: opts.apiKey })
       });
     }
+  } else if (opts.preset === "pi") {
+    if (!opts.auth) throw new Error("--auth (subscription|api-key) is required for pi");
+    if (opts.auth === "subscription" && !sniffCredentials("pi", opts.home).found) {
+      throw new Error(
+        "no pi login found \u2014 run `pi` and /login first, or use --auth api-key"
+      );
+    }
+    if (opts.auth === "api-key" && !opts.provider) {
+      throw new Error("--provider is required for pi --auth api-key");
+    }
+    const providerMeta = opts.provider ? findPiProvider(opts.provider) : void 0;
+    if (opts.provider && !providerMeta) throw new Error(`unknown pi provider: ${opts.provider}`);
+    const inherited = sniffPiDefaults(opts.home);
+    const provider = opts.provider ?? inherited?.provider ?? PI_DEFAULT_PROVIDER;
+    const model = opts.model ?? inherited?.model ?? PI_DEFAULT_MODEL;
+    const settingsProvider = opts.model ? provider : inherited?.provider ?? provider;
+    writes.push({ path: "zooid.yaml", content: generateZooidYaml({ preset: "pi" }) });
+    writes.push({ path: "agents/zooid-assistant/AGENTS.md", content: generateAgentsMd() });
+    writes.push({
+      path: `agents/zooid-assistant/${PI_AGENT_DIR}/settings.json`,
+      content: generatePiSettings({ provider: settingsProvider, model })
+    });
+    const envLines = [`PI_CODING_AGENT_DIR=${PI_AGENT_DIR}`];
+    if (opts.auth === "api-key" && opts.apiKey) {
+      envLines.push(`${providerMeta.apiKeyEnvVar}=${opts.apiKey}`);
+    }
+    writes.push({ path: ".env", content: envLines.join("\n") + "\n" });
+    piInherited = inherited;
   } else {
     throw new Error(`unknown preset: ${String(opts.preset)}`);
   }
@@ -1757,6 +1831,35 @@ async function runInit(opts) {
       );
     }
   }
+  if (opts.preset === "pi") {
+    if (piInherited) {
+      console.log(
+        `\u2713 Inherited defaultProvider=${piInherited.provider} defaultModel=${piInherited.model} from ${piInherited.source}`
+      );
+    } else {
+      console.log(
+        `\u2713 Pinned defaultProvider=${PI_DEFAULT_PROVIDER} defaultModel=${PI_DEFAULT_MODEL} (pi's own default returns an empty turn)`
+      );
+    }
+    const s = sniffCredentials("pi", opts.home);
+    if (opts.auth === "subscription" && s.found) {
+      const authSource = join14(opts.home ?? homedir2(), PI_AUTH_FILE);
+      const linkPath = join14(dir, `agents/zooid-assistant/${PI_AGENT_DIR}/auth.json`);
+      if (!existsSync7(linkPath)) {
+        mkdirSync5(dirname7(linkPath), { recursive: true });
+        symlinkSync(authSource, linkPath);
+      }
+      console.log(
+        `\u2713 Shared pi login from ${s.path} \u2014 the agent uses your subscription via a symlink at ${PI_AGENT_DIR}/auth.json`
+      );
+    } else if (s.found) {
+      console.log(
+        `\u2713 Found pi login at ${s.path} \u2014 the agent gets its own config at ${PI_AGENT_DIR}/ and will not touch it`
+      );
+    } else {
+      console.warn(`\u26A0 No pi login detected \u2014 the agent uses its own API key from .env`);
+    }
+  }
   console.log("\nNext: zooid dev");
 }
 
@@ -1774,10 +1877,11 @@ async function resolveOptions(flags) {
       choices: [
         { name: "claude (Claude Code)", value: "claude" },
         { name: "codex (OpenAI Codex)", value: "codex" },
-        { name: "opencode", value: "opencode" }
+        { name: "opencode", value: "opencode" },
+        { name: "pi", value: "pi" }
       ]
     }),
-    () => "--preset is required (claude | codex | opencode)"
+    () => "--preset is required (claude | codex | opencode | pi)"
   );
   if (preset === "opencode") {
     const provider = flags.provider ?? "opencode-go";
@@ -1806,6 +1910,45 @@ async function resolveOptions(flags) {
       overwrite: flags.overwrite
     };
   }
+  if (preset === "pi") {
+    const loginFound = sniffCredentials("pi").found;
+    const auth2 = flags.auth ?? (loginFound ? await ask(
+      () => select({
+        message: "A pi login was found. How should the agent authenticate?",
+        choices: [
+          { name: "Share my pi login (agent uses my existing subscription)", value: "subscription" },
+          { name: "Give the agent its own key (billed and revoked separately)", value: "api-key" }
+        ]
+      }),
+      () => "--auth is required (subscription | api-key)"
+    ) : "api-key");
+    if (auth2 === "subscription") {
+      return {
+        dir: flags.dir,
+        preset,
+        auth: auth2,
+        force: flags.force,
+        overwrite: flags.overwrite
+      };
+    }
+    const provider = flags.provider ?? PI_DEFAULT_PROVIDER;
+    const providerMeta = findPiProvider(provider);
+    if (!providerMeta) throw new Error(`unknown pi provider: ${provider}`);
+    const apiKey2 = flags.apiKey ?? await ask(
+      () => password({ message: `${providerMeta.label} API key:` }),
+      () => "--api-key is required"
+    );
+    return {
+      dir: flags.dir,
+      preset,
+      auth: auth2,
+      provider,
+      model: flags.model,
+      apiKey: apiKey2,
+      force: flags.force,
+      overwrite: flags.overwrite
+    };
+  }
   const meta = findSimplePreset(preset);
   if (!meta) throw new Error(`unknown preset: ${preset}`);
   const auth = flags.auth ?? await ask(
@@ -1938,7 +2081,7 @@ async function runStart(flags) {
 }
 
 // src/commands/status.ts
-import { readFileSync as readFileSync7 } from "fs";
+import { readFileSync as readFileSync8 } from "fs";
 import { dirname as dirname8 } from "path";
 import chalk2 from "chalk";
 async function probe(url, timeoutMs = 2e3) {
@@ -1963,7 +2106,7 @@ async function collectStatus(opts) {
       agents: []
     };
   }
-  const cfg = loadZooidConfig(readFileSync7(found.path, "utf8"), {
+  const cfg = loadZooidConfig(readFileSync8(found.path, "utf8"), {
     configDir: dirname8(found.path)
   });
   const matrixEntry = Object.entries(cfg.transports).find(
@@ -1994,7 +2137,7 @@ async function runStatus(flags) {
   if (port === void 0) {
     const found = findConfigFile(cwd);
     if (found) {
-      const cfg = loadZooidConfig(readFileSync7(found.path, "utf8"), {
+      const cfg = loadZooidConfig(readFileSync8(found.path, "utf8"), {
         configDir: dirname8(found.path)
       });
       const matrix = findMatrixTransport(cfg);
@@ -2068,7 +2211,7 @@ cli.command("status", "Print Tuwunel + daemon health").option("--data <dir>", "P
     port: flags.port !== void 0 ? Number(flags.port) : void 0
   });
 });
-cli.command("init [dir]", "Scaffold a new zooid workforce in the current (or named) directory").option("--preset <name>", "claude | codex | opencode").option("--auth <mode>", "subscription | api-key (claude/codex only)").option("--model <id>", "Model identifier").option("--provider <id>", "opencode provider: opencode-go | opencode | anthropic | openrouter | custom").option("--api-key <value>", "API key (api-key path; opencode always)").option("--force", "Allow scaffolding into a non-empty directory").option("--overwrite", "With --force, overwrite existing files").option("--no-interactive", "Disable prompts; require all flags up front").action(async (dir, flags) => {
+cli.command("init [dir]", "Scaffold a new zooid workforce in the current (or named) directory").option("--preset <name>", "claude | codex | opencode | pi").option("--auth <mode>", "subscription | api-key (claude/codex/pi only)").option("--model <id>", "Model identifier").option("--provider <id>", "opencode provider: opencode-go | opencode | anthropic | openrouter | custom; pi provider: openrouter | anthropic | openai").option("--api-key <value>", "API key (api-key path; opencode always)").option("--force", "Allow scaffolding into a non-empty directory").option("--overwrite", "With --force, overwrite existing files").option("--no-interactive", "Disable prompts; require all flags up front").action(async (dir, flags) => {
   const resolved = await resolveOptions({
     dir: dir ?? process.cwd(),
     preset: flags.preset,