@poolzin/pool-bot 2026.1.38 → 2026.2.0

package/dist/test-utils/channel-plugins.js

@@ -0,0 +1,82 @@
+import { imessageOutbound } from "../channels/plugins/outbound/imessage.js";
+import { normalizeIMessageHandle } from "../imessage/targets.js";
+export const createTestRegistry = (channels = []) => ({
+    plugins: [],
+    tools: [],
+    hooks: [],
+    typedHooks: [],
+    channels,
+    providers: [],
+    gatewayHandlers: {},
+    httpHandlers: [],
+    httpRoutes: [],
+    cliRegistrars: [],
+    services: [],
+    commands: [],
+    diagnostics: [],
+});
+export const createIMessageTestPlugin = (params) => ({
+    id: "imessage",
+    meta: {
+        id: "imessage",
+        label: "iMessage",
+        selectionLabel: "iMessage (imsg)",
+        docsPath: "/channels/imessage",
+        blurb: "iMessage test stub.",
+        aliases: ["imsg"],
+    },
+    capabilities: { chatTypes: ["direct", "group"], media: true },
+    config: {
+        listAccountIds: () => [],
+        resolveAccount: () => ({}),
+    },
+    status: {
+        collectStatusIssues: (accounts) => accounts.flatMap((account) => {
+            const lastError = typeof account.lastError === "string" ? account.lastError.trim() : "";
+            if (!lastError)
+                return [];
+            return [
+                {
+                    channel: "imessage",
+                    accountId: account.accountId,
+                    kind: "runtime",
+                    message: `Channel error: ${lastError}`,
+                },
+            ];
+        }),
+    },
+    outbound: params?.outbound ?? imessageOutbound,
+    messaging: {
+        targetResolver: {
+            looksLikeId: (raw) => {
+                const trimmed = raw.trim();
+                if (!trimmed)
+                    return false;
+                if (/^(imessage:|sms:|auto:|chat_id:|chat_guid:|chat_identifier:)/i.test(trimmed)) {
+                    return true;
+                }
+                if (trimmed.includes("@"))
+                    return true;
+                return /^\+?\d{3,}$/.test(trimmed);
+            },
+            hint: "<handle|chat_id:ID>",
+        },
+        normalizeTarget: (raw) => normalizeIMessageHandle(raw),
+    },
+});
+export const createOutboundTestPlugin = (params) => ({
+    id: params.id,
+    meta: {
+        id: params.id,
+        label: params.label ?? String(params.id),
+        selectionLabel: params.label ?? String(params.id),
+        docsPath: params.docsPath ?? `/channels/${params.id}`,
+        blurb: "test stub.",
+    },
+    capabilities: params.capabilities ?? { chatTypes: ["direct"] },
+    config: {
+        listAccountIds: () => [],
+        resolveAccount: () => ({}),
+    },
+    outbound: params.outbound,
+});

package/dist/test-utils/ports.js

@@ -0,0 +1,73 @@
+import { createServer } from "node:net";
+import { isMainThread, threadId } from "node:worker_threads";
+async function isPortFree(port) {
+    if (!Number.isFinite(port) || port <= 0 || port > 65535)
+        return false;
+    return await new Promise((resolve) => {
+        const server = createServer();
+        server.once("error", () => resolve(false));
+        server.listen(port, "127.0.0.1", () => {
+            server.close(() => resolve(true));
+        });
+    });
+}
+async function getOsFreePort() {
+    return await new Promise((resolve, reject) => {
+        const server = createServer();
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            if (!addr || typeof addr === "string") {
+                server.close();
+                reject(new Error("failed to acquire free port"));
+                return;
+            }
+            const port = addr.port;
+            server.close((err) => (err ? reject(err) : resolve(port)));
+        });
+    });
+}
+let nextTestPortOffset = 0;
+/**
+ * Allocate a deterministic per-worker port block.
+ *
+ * Motivation: many tests spin up gateway + related services that use derived ports
+ * (e.g. +1/+2/+3/+4). If each test just grabs an OS free port, parallel test runs
+ * can collide on derived ports and get flaky EADDRINUSE.
+ */
+export async function getDeterministicFreePortBlock(params) {
+    const offsets = params?.offsets ?? [0, 1, 2, 3, 4];
+    const maxOffset = Math.max(...offsets);
+    const workerIdRaw = process.env.VITEST_WORKER_ID ?? process.env.VITEST_POOL_ID ?? "";
+    const workerId = Number.parseInt(workerIdRaw, 10);
+    const shard = Number.isFinite(workerId)
+        ? Math.max(0, workerId)
+        : isMainThread
+            ? Math.abs(process.pid)
+            : Math.abs(threadId);
+    const rangeSize = 1000;
+    const shardCount = 30;
+    const base = 30_000 + (Math.abs(shard) % shardCount) * rangeSize; // <= 59_999
+    const usable = rangeSize - maxOffset;
+    // Allocate in blocks to avoid derived-port overlaps (e.g. port+3).
+    const blockSize = Math.max(maxOffset + 1, 8);
+    for (let attempt = 0; attempt < usable; attempt += 1) {
+        const start = base + ((nextTestPortOffset + attempt) % usable);
+        // eslint-disable-next-line no-await-in-loop
+        const ok = (await Promise.all(offsets.map((offset) => isPortFree(start + offset)))).every(Boolean);
+        if (!ok)
+            continue;
+        nextTestPortOffset = (nextTestPortOffset + attempt + blockSize) % usable;
+        return start;
+    }
+    // Fallback: let the OS pick a port block (best effort).
+    for (let attempt = 0; attempt < 25; attempt += 1) {
+        // eslint-disable-next-line no-await-in-loop
+        const port = await getOsFreePort();
+        // eslint-disable-next-line no-await-in-loop
+        const ok = (await Promise.all(offsets.map((offset) => isPortFree(port + offset)))).every(Boolean);
+        if (ok)
+            return port;
+    }
+    throw new Error("failed to acquire a free port block");
+}

package/dist/utils/shell-argv.js

@@ -0,0 +1,61 @@
+export function splitShellArgs(raw) {
+    const tokens = [];
+    let buf = "";
+    let inSingle = false;
+    let inDouble = false;
+    let escaped = false;
+    const pushToken = () => {
+        if (buf.length > 0) {
+            tokens.push(buf);
+            buf = "";
+        }
+    };
+    for (let i = 0; i < raw.length; i += 1) {
+        const ch = raw[i];
+        if (escaped) {
+            buf += ch;
+            escaped = false;
+            continue;
+        }
+        if (!inSingle && !inDouble && ch === "\\") {
+            escaped = true;
+            continue;
+        }
+        if (inSingle) {
+            if (ch === "'") {
+                inSingle = false;
+            }
+            else {
+                buf += ch;
+            }
+            continue;
+        }
+        if (inDouble) {
+            if (ch === '"') {
+                inDouble = false;
+            }
+            else {
+                buf += ch;
+            }
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            pushToken();
+            continue;
+        }
+        buf += ch;
+    }
+    if (escaped || inSingle || inDouble) {
+        return null;
+    }
+    pushToken();
+    return tokens;
+}

package/dist/utils.js

@@ -243,5 +243,15 @@ export function formatTerminalLink(label, url, opts) {
     }
     return `\u001b]8;;${safeUrl}\u0007${safeLabel}\u001b]8;;\u0007`;
 }
+/**
+ * Strict plain-object check — returns true only for `Object.create(null)` or `{}` literals.
+ * Arrays, Dates, RegExps, class instances, and null/undefined all return false.
+ */
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
 // Configuration root; can be overridden via CLAWDBOT_STATE_DIR.
 export const CONFIG_DIR = resolveConfigDir();

package/dist/web/qr-image.js

@@ -1,6 +1,6 @@
-import { deflateSync } from "node:zlib";
 import QRCodeModule from "qrcode-terminal/vendor/QRCode/index.js";
 import QRErrorCorrectLevelModule from "qrcode-terminal/vendor/QRCode/QRErrorCorrectLevel.js";
+import { encodePngRgba, fillPixel } from "../media/png-encode.js";
 const QRCode = QRCodeModule;
 const QRErrorCorrectLevel = QRErrorCorrectLevelModule;
 function createQrMatrix(input) {
@@ -9,66 +9,6 @@ function createQrMatrix(input) {
     qr.make();
     return qr;
 }
-function fillPixel(buf, x, y, width, r, g, b, a = 255) {
-    const idx = (y * width + x) * 4;
-    buf[idx] = r;
-    buf[idx + 1] = g;
-    buf[idx + 2] = b;
-    buf[idx + 3] = a;
-}
-function crcTable() {
-    const table = new Uint32Array(256);
-    for (let i = 0; i < 256; i += 1) {
-        let c = i;
-        for (let k = 0; k < 8; k += 1) {
-            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
-        }
-        table[i] = c >>> 0;
-    }
-    return table;
-}
-const CRC_TABLE = crcTable();
-function crc32(buf) {
-    let crc = 0xffffffff;
-    for (let i = 0; i < buf.length; i += 1) {
-        crc = CRC_TABLE[(crc ^ buf[i]) & 0xff] ^ (crc >>> 8);
-    }
-    return (crc ^ 0xffffffff) >>> 0;
-}
-function pngChunk(type, data) {
-    const typeBuf = Buffer.from(type, "ascii");
-    const len = Buffer.alloc(4);
-    len.writeUInt32BE(data.length, 0);
-    const crc = crc32(Buffer.concat([typeBuf, data]));
-    const crcBuf = Buffer.alloc(4);
-    crcBuf.writeUInt32BE(crc, 0);
-    return Buffer.concat([len, typeBuf, data, crcBuf]);
-}
-function encodePngRgba(buffer, width, height) {
-    const stride = width * 4;
-    const raw = Buffer.alloc((stride + 1) * height);
-    for (let row = 0; row < height; row += 1) {
-        const rawOffset = row * (stride + 1);
-        raw[rawOffset] = 0; // filter: none
-        buffer.copy(raw, rawOffset + 1, row * stride, row * stride + stride);
-    }
-    const compressed = deflateSync(raw);
-    const signature = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
-    const ihdr = Buffer.alloc(13);
-    ihdr.writeUInt32BE(width, 0);
-    ihdr.writeUInt32BE(height, 4);
-    ihdr[8] = 8; // bit depth
-    ihdr[9] = 6; // color type RGBA
-    ihdr[10] = 0; // compression
-    ihdr[11] = 0; // filter
-    ihdr[12] = 0; // interlace
-    return Buffer.concat([
-        signature,
-        pngChunk("IHDR", ihdr),
-        pngChunk("IDAT", compressed),
-        pngChunk("IEND", Buffer.alloc(0)),
-    ]);
-}
 export async function renderQrPngBase64(input, opts = {}) {
     const { scale = 6, marginModules = 4 } = opts;
     const qr = createQrMatrix(input);

package/dist/wizard/onboarding.finalize.js

@@ -269,8 +269,8 @@ export async function finalizeOnboardingWizard(options) {
             await prompter.note([
                 `Dashboard link (with token): ${authedUrl}`,
                 controlUiOpened
-                    ? "Opened in your browser. Keep that tab to control Moltbot."
-                    : "Copy/paste this URL in a browser on this machine to control Moltbot.",
+                    ? "Opened in your browser. Keep that tab to control Poolbot."
+                    : "Copy/paste this URL in a browser on this machine to control Poolbot.",
                 controlUiOpenHint,
             ]
                 .filter(Boolean)
@@ -314,8 +314,8 @@ export async function finalizeOnboardingWizard(options) {
         await prompter.note([
             `Dashboard link (with token): ${authedUrl}`,
             controlUiOpened
-                ? "Opened in your browser. Keep that tab to control Moltbot."
-                : "Copy/paste this URL in a browser on this machine to control Moltbot.",
+                ? "Opened in your browser. Keep that tab to control Poolbot."
+                : "Copy/paste this URL in a browser on this machine to control Poolbot.",
             controlUiOpenHint,
         ]
             .filter(Boolean)
@@ -336,7 +336,7 @@ export async function finalizeOnboardingWizard(options) {
         : [
             "If you want your agent to be able to search the web, you’ll need an API key.",
             "",
-            "Moltbot uses Brave Search for the `web_search` tool. Without a Brave Search API key, web search won’t work.",
+            "Poolbot uses Brave Search for the `web_search` tool. Without a Brave Search API key, web search won’t work.",
             "",
             "Set it up interactively:",
             `- Run: ${formatCliCommand("poolbot configure --section web")}`,
@@ -347,8 +347,8 @@ export async function finalizeOnboardingWizard(options) {
         ].join("\n"), "Web search (optional)");
     await prompter.note('What now: https://molt.bot/showcase ("What People Are Building").', "What now");
     await prompter.outro(controlUiOpened
-        ? "Onboarding complete. Dashboard opened with your token; keep that tab to control Moltbot."
+        ? "Onboarding complete. Dashboard opened with your token; keep that tab to control Poolbot."
         : seededInBackground
             ? "Onboarding complete. Web UI seeded in the background; open it anytime with the tokenized link above."
-            : "Onboarding complete. Use the tokenized dashboard link above to control Moltbot.");
+            : "Onboarding complete. Use the tokenized dashboard link above to control Poolbot.");
 }

package/dist/wizard/onboarding.js

@@ -22,11 +22,11 @@ async function requireRiskAcknowledgement(params) {
     await params.prompter.note([
         "Security warning — please read.",
         "",
-        "Moltbot is a hobby project and still in beta. Expect sharp edges.",
+        "Poolbot is a hobby project and still in beta. Expect sharp edges.",
         "This bot can read files and run actions if tools are enabled.",
         "A bad prompt can trick it into doing unsafe things.",
         "",
-        "If you’re not comfortable with basic security and access control, don’t run Moltbot.",
+        "If you’re not comfortable with basic security and access control, don’t run Poolbot.",
         "Ask someone experienced to help before enabling tools or exposing it to the internet.",
         "",
         "Recommended baseline:",
@@ -51,7 +51,7 @@ async function requireRiskAcknowledgement(params) {
 }
 export async function runOnboardingWizard(opts, runtime = defaultRuntime, prompter) {
     printWizardHeader(runtime);
-    await prompter.intro("Moltbot onboarding");
+    await prompter.intro("Poolbot onboarding");
     await requireRiskAcknowledgement({ opts, prompter });
     const snapshot = await readConfigFileSnapshot();
     let baseConfig = snapshot.valid ? snapshot.config : {};

package/docs/RELEASE_WORKFOTS_COMPARISON.md

@@ -5,7 +5,7 @@
 Existem **dois workflows de release** diferentes no pool-bot:
 
 ### 1. `release.yml` - Binários CLI
-- **O que faz:** Gera binários standalone do Moltbot CLI
+- **O que faz:** Gera binários standalone do Poolbot CLI
 - **Ferramenta:** `pkg`
 - **Saída:**
   - Windows: `poolbot-win-x64.exe` (CLI)
@@ -38,13 +38,13 @@ Existem **dois workflows de release** diferentes no pool-bot:
 ## Quando Usar Cada Workflow
 
 ### release.yml (CLI)
-- Quando você quer instalar o Moltbot como ferramenta de CLI
+- Quando você quer instalar o Poolbot como ferramenta de CLI
 - Quando você quer executar `poolbot gateway`, `poolbot tui`, etc.
 - Quando você quer integrar em scripts de automação
 - Para desenvolvedores e usuários técnicos
 
 ### release-apps.yml (Apps)
-- Quando você quer usar o Moltbot como app normal
+- Quando você quer usar o Poolbot como app normal
 - Quando você quer notificações nativas no Windows
 - Quando você quer Canvas, Chat e Camera no Android
 - Para usuários finais, não técnicos

package/docs/_config.yml

@@ -1,4 +1,4 @@
-title: "Moltbot Docs"
+title: "Poolbot Docs"
 description: "A TypeScript/Node gateway + macOS/iOS/Android companions for WhatsApp (web) and Telegram (bot)."
 markdown: kramdown
 highlighter: rouge
@@ -22,7 +22,7 @@ defaults:
 nav:
   - title: "Home"
     url: "/"
-  - title: "Moltbot Assistant"
+  - title: "Poolbot Assistant"
     url: "/start/clawd/"
   - title: "Gateway"
     url: "/gateway/"

package/docs/_layouts/default.html

@@ -17,7 +17,7 @@
     <script>
       (() => {
         try {
-          const stored = localStorage.getItem("moltbot:theme");
+          const stored = localStorage.getItem("poolbot:theme");
           if (stored === "light" || stored === "dark") document.documentElement.dataset.theme = stored;
         } catch {
           // ignore
@@ -35,7 +35,7 @@
     <header class="shell">
       <div class="shell__frame" role="banner">
         <div class="shell__titlebar">
-          <div class="brand" aria-label="Moltbot docs terminal">
+          <div class="brand" aria-label="Poolbot docs terminal">
             <img
               class="brand__logo"
               src="{{ "/assets/pixel-lobster.svg" | relative_url }}"
@@ -45,17 +45,17 @@
               decoding="async"
             />
             <div class="brand__text">
-              <div class="brand__name">Moltbot</div>
+              <div class="brand__name">Poolbot</div>
               <div class="brand__hint">docs // lobster terminal</div>
             </div>
           </div>
 
           <div class="titlebar__actions">
-            <a class="titlebar__cta" href="https://github.com/moltbot/moltbot">
+            <a class="titlebar__cta" href="https://github.com/poolbot/poolbot">
               <span class="titlebar__cta-label">GitHub</span>
               <span class="titlebar__cta-meta">repo</span>
             </a>
-            <a class="titlebar__cta titlebar__cta--accent" href="https://github.com/moltbot/moltbot/releases/latest">
+            <a class="titlebar__cta titlebar__cta--accent" href="https://github.com/poolbot/poolbot/releases/latest">
               <span class="titlebar__cta-label">Download</span>
               <span class="titlebar__cta-meta">latest</span>
             </a>
@@ -90,7 +90,7 @@
     <main id="content" class="content" role="main">
       <div class="terminal">
         <div class="terminal__prompt" aria-hidden="true">
-          <span class="prompt__user">clawd</span>@<span class="prompt__host">moltbot</span>:<span class="prompt__path">~/docs</span>$<span class="prompt__cmd">
+          <span class="prompt__user">clawd</span>@<span class="prompt__host">poolbot</span>:<span class="prompt__path">~/docs</span>$<span class="prompt__cmd">
             {% if page.url == "/" %}cat index.md{% else %}less {{ page.path }}{% endif %}
           </span>
         </div>
@@ -116,11 +116,11 @@
 
         <footer class="terminal__footer" role="contentinfo">
           <div class="footer__line">
-            <span class="footer__sig">moltbot.ai</span>
+            <span class="footer__sig">poolbot.ai</span>
             <span class="footer__sep">·</span>
-            <a href="https://github.com/moltbot/moltbot">source</a>
+            <a href="https://github.com/poolbot/poolbot">source</a>
             <span class="footer__sep">·</span>
-            <a href="https://github.com/moltbot/moltbot/releases">releases</a>
+            <a href="https://github.com/poolbot/poolbot/releases">releases</a>
           </div>
           <div class="footer__hint" aria-hidden="true">
             tip: press <kbd>F2</kbd> (Mac: <kbd>fn</kbd>+<kbd>F2</kbd>) to flip

package/docs/concepts/typebox.md

@@ -58,7 +58,7 @@ Authoritative list lives in `src/gateway/server.ts` (`METHODS`, `EVENTS`).
 - Server handshake + method dispatch: `src/gateway/server.ts`
 - Node client: `src/gateway/client.ts`
 - Generated JSON Schema: `dist/protocol.schema.json`
-- Generated Swift models: `apps/macos/Sources/ClawdbotProtocol/GatewayModels.swift`
+- Generated Swift models: `apps/macos/Sources/Pool-BotProtocol/GatewayModels.swift`
 
 ## Current pipeline
 

package/docs/docs.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://mintlify.com/docs.json",
-  "name": "Moltbot",
+  "name": "Poolbot",
   "theme": "mint",
   "logo": {
     "light": "/assets/pixel-lobster.svg",

package/docs/northflank.mdx

@@ -2,25 +2,25 @@
 title: Deploy on Northflank
 ---
 
-Deploy Moltbot on Northflank with a one-click template and finish setup in your browser.
+Deploy Poolbot on Northflank with a one-click template and finish setup in your browser.
 This is the easiest “no terminal on the server” path: Northflank runs the Gateway for you,
 and you configure everything via the `/setup` web wizard.
 
 ## How to get started
 
-1. Click [Deploy Moltbot](https://northflank.com/stacks/deploy-moltbot) to open the template.  
+1. Click [Deploy Poolbot](https://northflank.com/stacks/deploy-moltbot) to open the template.  
 2. Create an [account on Northflank](https://app.northflank.com/signup) if you don’t already have one.  
-3. Click **Deploy Moltbot now**.  
+3. Click **Deploy Poolbot now**.  
 4. Set the required environment variable: `SETUP_PASSWORD`.
-5. Click **Deploy stack** to build and run the Moltbot template.
+5. Click **Deploy stack** to build and run the Poolbot template.
 6. Wait for the deployment to complete, then click **View resources**.
-7. Open the Moltbot service.
-8. Open the public Moltbot URL and complete setup at `/setup`.
+7. Open the Poolbot service.
+8. Open the public Poolbot URL and complete setup at `/setup`.
 9. Open the Control UI at `/moltbot`.
 
 ## What you get
 
-- Hosted Moltbot Gateway + Control UI
+- Hosted Poolbot Gateway + Control UI
 - Web setup wizard at `/setup` (no terminal commands)
 - Persistent storage via Northflank Volume (`/data`) so config/credentials/workspace survive redeploys
 

package/docs/railway.mdx

@@ -2,7 +2,7 @@
 title: Deploy on Railway
 ---
 
-Deploy Moltbot on Railway with a one-click template and finish setup in your browser.
+Deploy Poolbot on Railway with a one-click template and finish setup in your browser.
 This is the easiest “no terminal on the server” path: Railway runs the Gateway for you,
 and you configure everything via the `/setup` web wizard.
 
@@ -31,7 +31,7 @@ Then open:
 
 ## What you get
 
-- Hosted Moltbot Gateway + Control UI
+- Hosted Poolbot Gateway + Control UI
 - Web setup wizard at `/setup` (no terminal commands)
 - Persistent storage via Railway Volume (`/data`) so config/credentials/workspace survive redeploys
 - Backup export at `/setup/export` to migrate off Railway later
@@ -93,4 +93,4 @@ Download a backup at:
 
 - `https://<your-railway-domain>/setup/export`
 
-This exports your Moltbot state + workspace so you can migrate to another host without losing config or memory.
+This exports your Poolbot state + workspace so you can migrate to another host without losing config or memory.

package/docs/render.mdx

@@ -2,7 +2,7 @@
 title: Deploy on Render
 ---
 
-Deploy Moltbot on Render using Infrastructure as Code. The included `render.yaml` Blueprint defines your entire stack declaratively, service, disk, environment variables, so you can deploy with a single click and version your infrastructure alongside your code.
+Deploy Poolbot on Render using Infrastructure as Code. The included `render.yaml` Blueprint defines your entire stack declaratively, service, disk, environment variables, so you can deploy with a single click and version your infrastructure alongside your code.
 
 ## Prerequisites
 
@@ -24,7 +24,7 @@ Once deployed, your service URL follows the pattern `https://<service-name>.onre
 ## Understanding the Blueprint
 
 Render Blueprints are YAML files that define your infrastructure. The `render.yaml` in this
-repository configures everything needed to run Moltbot:
+repository configures everything needed to run Poolbot:
 
 ```yaml
 services:
@@ -104,7 +104,7 @@ Modify variables in **Dashboard → your service → Environment**. Changes trig
 
 ### Auto-deploy
 
-If you use the original Moltbot repository, Render will not auto-deploy your Moltbot. To update it, run a manual Blueprint sync from the dashboard.
+If you use the original Poolbot repository, Render will not auto-deploy your Poolbot. To update it, run a manual Blueprint sync from the dashboard.
 
 ## Custom domain
 
@@ -120,7 +120,7 @@ Render supports horizontal and vertical scaling:
 - **Vertical**: Change the plan to get more CPU/RAM
 - **Horizontal**: Increase instance count (Standard plan and above)
 
-For Moltbot, vertical scaling is usually sufficient. Horizontal scaling requires sticky sessions or external state management.
+For Poolbot, vertical scaling is usually sufficient. Horizontal scaling requires sticky sessions or external state management.
 
 ## Backups and migration
 
@@ -130,7 +130,7 @@ Export your configuration and workspace at any time:
 https://<your-service>.onrender.com/setup/export
 ```
 
-This downloads a portable backup you can restore on any Moltbot host.
+This downloads a portable backup you can restore on any Poolbot host.
 
 ## Troubleshooting
 

package/docs/start/lore.md

@@ -13,7 +13,7 @@ In the beginning, there was **Warelay** — a sensible name for a WhatsApp gatew
 
 But then came a space lobster.
 
-For a while, the lobster was called **Clawd**, living in a **Clawdbot**. But in January 2026, Anthropic sent a polite email asking for a name change (trademark stuff). And so the lobster did what lobsters do best:
+For a while, the lobster was called **Clawd**, living in a **Pool-Bot**. But in January 2026, Anthropic sent a polite email asking for a name change (trademark stuff). And so the lobster did what lobsters do best:
 
 **It molted.**
 
@@ -94,7 +94,7 @@ Then the chaos began.
 
 **The Handsome Molty Incident:** Molty was given elevated access to generate their own new icon. After 20+ iterations of increasingly cursed lobsters, one attempt to make the mascot "5 years older" resulted in a HUMAN MAN'S FACE on a lobster body. Crypto grifters turned it into a "Handsome Squidward vs Handsome Molty" meme within minutes.
 
-**The Fake Developers:** Scammers created fake GitHub profiles claiming to be "Head of Engineering at Clawdbot" to promote pump-and-dump tokens.
+**The Fake Developers:** Scammers created fake GitHub profiles claiming to be "Head of Engineering at Pool-Bot" to promote pump-and-dump tokens.
 
 Peter, watching the chaos unfold: *"this is cinema"* 🎬
 

package/extensions/bluebubbles/index.ts

@@ -1,4 +1,4 @@
-import type { MoltbotPluginApi } from "poolbot/plugin-sdk";
+import type { PoolbotPluginApi } from "poolbot/plugin-sdk";
 import { emptyPluginConfigSchema } from "poolbot/plugin-sdk";
 
 import { bluebubblesPlugin } from "./src/channel.js";
@@ -10,7 +10,7 @@ const plugin = {
   name: "BlueBubbles",
   description: "BlueBubbles channel plugin (macOS app)",
   configSchema: emptyPluginConfigSchema(),
-  register(api: MoltbotPluginApi) {
+  register(api: PoolbotPluginApi) {
     setBlueBubblesRuntime(api.runtime);
     api.registerChannel({ plugin: bluebubblesPlugin });
     api.registerHttpHandler(handleBlueBubblesWebhookRequest);

package/extensions/bluebubbles/package.json

@@ -2,7 +2,7 @@
   "name": "@poolbot/bluebubbles",
   "version": "2026.1.26",
   "type": "module",
-  "description": "Moltbot BlueBubbles channel plugin",
+  "description": "Poolbot BlueBubbles channel plugin",
   "poolbot": {
     "extensions": [
       "./index.ts"