@poolzin/pool-bot 2026.1.39 → 2026.2.1

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/transcript-tools.js

@@ -0,0 +1,58 @@
+const TOOL_CALL_TYPES = new Set(["tool_use", "toolcall", "tool_call"]);
+const TOOL_RESULT_TYPES = new Set(["tool_result", "tool_result_error"]);
+const normalizeType = (value) => {
+    if (typeof value !== "string") {
+        return "";
+    }
+    return value.trim().toLowerCase();
+};
+export const extractToolCallNames = (message) => {
+    const names = new Set();
+    const toolNameRaw = message.toolName ?? message.tool_name;
+    if (typeof toolNameRaw === "string" && toolNameRaw.trim()) {
+        names.add(toolNameRaw.trim());
+    }
+    const content = message.content;
+    if (!Array.isArray(content)) {
+        return Array.from(names);
+    }
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object") {
+            continue;
+        }
+        const block = entry;
+        const type = normalizeType(block.type);
+        if (!TOOL_CALL_TYPES.has(type)) {
+            continue;
+        }
+        const name = block.name;
+        if (typeof name === "string" && name.trim()) {
+            names.add(name.trim());
+        }
+    }
+    return Array.from(names);
+};
+export const hasToolCall = (message) => extractToolCallNames(message).length > 0;
+export const countToolResults = (message) => {
+    const content = message.content;
+    if (!Array.isArray(content)) {
+        return { total: 0, errors: 0 };
+    }
+    let total = 0;
+    let errors = 0;
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object") {
+            continue;
+        }
+        const block = entry;
+        const type = normalizeType(block.type);
+        if (!TOOL_RESULT_TYPES.has(type)) {
+            continue;
+        }
+        total += 1;
+        if (block.is_error === true) {
+            errors += 1;
+        }
+    }
+    return { total, errors };
+};

package/dist/utils.js

@@ -3,15 +3,54 @@ import os from "node:os";
 import path from "node:path";
 import { resolveOAuthDir } from "./config/paths.js";
 import { logVerbose, shouldLogVerbose } from "./globals.js";
+import { expandHomePrefix, resolveEffectiveHomeDir, resolveRequiredHomeDir, } from "./infra/home-dir.js";
 export async function ensureDir(dir) {
     await fs.promises.mkdir(dir, { recursive: true });
 }
+/**
+ * Check if a file or directory exists at the given path.
+ */
+export async function pathExists(targetPath) {
+    try {
+        await fs.promises.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 export function clampNumber(value, min, max) {
     return Math.max(min, Math.min(max, value));
 }
 export function clampInt(value, min, max) {
     return clampNumber(Math.floor(value), min, max);
 }
+/** Alias for clampNumber (shorter, more common name) */
+export const clamp = clampNumber;
+/**
+ * Escapes special regex characters in a string so it can be used in a RegExp constructor.
+ */
+export function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Safely parse JSON, returning null on error instead of throwing.
+ */
+export function safeParseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Type guard for Record<string, unknown> (less strict than isPlainObject).
+ * Accepts any non-null object that isn't an array.
+ */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 export function assertWebChannel(input) {
     if (input !== "web") {
         throw new Error("Web channel must be 'web'");
@@ -181,7 +220,11 @@ export function resolveUserPath(input) {
     if (!trimmed)
         return trimmed;
     if (trimmed.startsWith("~")) {
-        const expanded = trimmed.replace(/^~(?=$|[\\/])/, os.homedir());
+        const expanded = expandHomePrefix(trimmed, {
+            home: resolveRequiredHomeDir(process.env, os.homedir),
+            env: process.env,
+            homedir: os.homedir,
+        });
         return path.resolve(expanded);
     }
     return path.resolve(trimmed);
@@ -193,19 +236,7 @@ export function resolveConfigDir(env = process.env, homedir = os.homedir) {
     return path.join(homedir(), ".poolbot");
 }
 export function resolveHomeDir() {
-    const envHome = process.env.HOME?.trim();
-    if (envHome)
-        return envHome;
-    const envProfile = process.env.USERPROFILE?.trim();
-    if (envProfile)
-        return envProfile;
-    try {
-        const home = os.homedir();
-        return home?.trim() ? home : undefined;
-    }
-    catch {
-        return undefined;
-    }
+    return resolveEffectiveHomeDir(process.env, os.homedir);
 }
 export function shortenHomePath(input) {
     if (!input)
@@ -243,5 +274,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/version.js

@@ -1,18 +1,55 @@
 import { createRequire } from "node:module";
-function readVersionFromPackageJson() {
+const CORE_PACKAGE_NAME = "poolbot";
+const PACKAGE_JSON_CANDIDATES = [
+    "../package.json",
+    "../../package.json",
+    "../../../package.json",
+    "./package.json",
+];
+const BUILD_INFO_CANDIDATES = [
+    "../build-info.json",
+    "../../build-info.json",
+    "./build-info.json",
+];
+function readVersionFromJsonCandidates(moduleUrl, candidates, opts = {}) {
     try {
-        const require = createRequire(import.meta.url);
-        const pkg = require("../package.json");
-        return pkg.version ?? null;
+        const require = createRequire(moduleUrl);
+        for (const candidate of candidates) {
+            try {
+                const parsed = require(candidate);
+                const version = parsed.version?.trim();
+                if (!version)
+                    continue;
+                if (opts.requirePackageName && parsed.name !== CORE_PACKAGE_NAME)
+                    continue;
+                return version;
+            }
+            catch {
+                // ignore missing or unreadable candidate
+            }
+        }
+        return null;
     }
     catch {
         return null;
     }
 }
+export function readVersionFromPackageJsonForModuleUrl(moduleUrl) {
+    return readVersionFromJsonCandidates(moduleUrl, PACKAGE_JSON_CANDIDATES, {
+        requirePackageName: true,
+    });
+}
+export function readVersionFromBuildInfoForModuleUrl(moduleUrl) {
+    return readVersionFromJsonCandidates(moduleUrl, BUILD_INFO_CANDIDATES);
+}
+export function resolveVersionFromModuleUrl(moduleUrl) {
+    return (readVersionFromPackageJsonForModuleUrl(moduleUrl) ||
+        readVersionFromBuildInfoForModuleUrl(moduleUrl));
+}
 // Single source of truth for the current poolbot version.
 // - Embedded/bundled builds: injected define or env var.
 // - Dev/npm builds: package.json.
 export const VERSION = (typeof __CLAWDBOT_VERSION__ === "string" && __CLAWDBOT_VERSION__) ||
     process.env.CLAWDBOT_BUNDLED_VERSION ||
-    readVersionFromPackageJson() ||
+    resolveVersionFromModuleUrl(import.meta.url) ||
     "0.0.0";

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