@poolzin/pool-bot 2026.2.25 → 2026.2.26

package/dist/gateway/server-startup-memory.js

@@ -1,16 +1,22 @@
-import { resolveDefaultAgentId } from "../agents/agent-scope.js";
+import { listAgentIds } from "../agents/agent-scope.js";
+import { resolveMemorySearchConfig } from "../agents/memory-search.js";
 import { resolveMemoryBackendConfig } from "../memory/backend-config.js";
 import { getMemorySearchManager } from "../memory/index.js";
 export async function startGatewayMemoryBackend(params) {
-    const agentId = resolveDefaultAgentId(params.cfg);
-    const resolved = resolveMemoryBackendConfig({ cfg: params.cfg, agentId });
-    if (resolved.backend !== "qmd" || !resolved.qmd) {
-        return;
+    const agentIds = listAgentIds(params.cfg);
+    for (const agentId of agentIds) {
+        if (!resolveMemorySearchConfig(params.cfg, agentId)) {
+            continue;
+        }
+        const resolved = resolveMemoryBackendConfig({ cfg: params.cfg, agentId });
+        if (resolved.backend !== "qmd" || !resolved.qmd) {
+            continue;
+        }
+        const { manager, error } = await getMemorySearchManager({ cfg: params.cfg, agentId });
+        if (!manager) {
+            params.log.warn(`qmd memory startup initialization failed for agent "${agentId}": ${error ?? "unknown error"}`);
+            continue;
+        }
+        params.log.info?.(`qmd memory startup initialization armed for agent "${agentId}"`);
     }
-    const { manager, error } = await getMemorySearchManager({ cfg: params.cfg, agentId });
-    if (!manager) {
-        params.log.warn(`qmd memory startup initialization failed for agent "${agentId}": ${error ?? "unknown error"}`);
-        return;
-    }
-    params.log.info?.(`qmd memory startup initialization armed for agent "${agentId}"`);
 }

package/dist/gateway/session-utils.fs.js

@@ -4,6 +4,7 @@ import path from "node:path";
 import { resolveSessionFilePath, resolveSessionTranscriptPath, resolveSessionTranscriptPathInDir, } from "../config/sessions.js";
 import { resolveRequiredHomeDir } from "../infra/home-dir.js";
 import { hasInterSessionUserProvenance } from "../sessions/input-provenance.js";
+import { stripInlineDirectiveTagsForDisplay } from "../utils/directive-tags.js";
 import { extractToolCallNames, hasToolCall } from "../utils/transcript-tools.js";
 import { stripEnvelope } from "./chat-sanitize.js";
 const sessionTitleFieldsCache = new Map();
@@ -284,7 +285,8 @@ export function readSessionTitleFieldsFromTranscript(sessionId, storePath, sessi
 }
 function extractTextFromContent(content) {
     if (typeof content === "string") {
-        return content.trim() || null;
+        const normalized = stripInlineDirectiveTagsForDisplay(content).text.trim();
+        return normalized || null;
     }
     if (!Array.isArray(content)) {
         return null;
@@ -294,9 +296,9 @@ function extractTextFromContent(content) {
             continue;
         }
         if (part.type === "text" || part.type === "output_text" || part.type === "input_text") {
-            const trimmed = part.text.trim();
-            if (trimmed) {
-                return trimmed;
+            const normalized = stripInlineDirectiveTagsForDisplay(part.text).text.trim();
+            if (normalized) {
+                return normalized;
             }
         }
     }
@@ -336,20 +338,15 @@ function extractFirstUserMessageFromTranscriptChunk(chunk, opts) {
     }
     return null;
 }
-export function readFirstUserMessageFromTranscript(sessionId, storePath, sessionFile, agentId, opts) {
+function findExistingTranscriptPath(sessionId, storePath, sessionFile, agentId) {
     const candidates = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId);
-    const filePath = candidates.find((p) => fs.existsSync(p));
-    if (!filePath) {
-        return null;
-    }
+    return candidates.find((p) => fs.existsSync(p)) ?? null;
+}
+function withOpenTranscriptFd(filePath, read) {
     let fd = null;
     try {
         fd = fs.openSync(filePath, "r");
-        const chunk = readTranscriptHeadChunk(fd);
-        if (!chunk) {
-            return null;
-        }
-        return extractFirstUserMessageFromTranscriptChunk(chunk, opts);
+        return read(fd);
     }
     catch {
         // file read error
@@ -361,6 +358,19 @@ export function readFirstUserMessageFromTranscript(sessionId, storePath, session
     }
     return null;
 }
+export function readFirstUserMessageFromTranscript(sessionId, storePath, sessionFile, agentId, opts) {
+    const filePath = findExistingTranscriptPath(sessionId, storePath, sessionFile, agentId);
+    if (!filePath) {
+        return null;
+    }
+    return withOpenTranscriptFd(filePath, (fd) => {
+        const chunk = readTranscriptHeadChunk(fd);
+        if (!chunk) {
+            return null;
+        }
+        return extractFirstUserMessageFromTranscriptChunk(chunk, opts);
+    });
+}
 const LAST_MSG_MAX_BYTES = 16384;
 const LAST_MSG_MAX_LINES = 20;
 function readLastMessagePreviewFromOpenTranscript(params) {
@@ -391,30 +401,18 @@ function readLastMessagePreviewFromOpenTranscript(params) {
     return null;
 }
 export function readLastMessagePreviewFromTranscript(sessionId, storePath, sessionFile, agentId) {
-    const candidates = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId);
-    const filePath = candidates.find((p) => fs.existsSync(p));
+    const filePath = findExistingTranscriptPath(sessionId, storePath, sessionFile, agentId);
     if (!filePath) {
         return null;
     }
-    let fd = null;
-    try {
-        fd = fs.openSync(filePath, "r");
+    return withOpenTranscriptFd(filePath, (fd) => {
         const stat = fs.fstatSync(fd);
         const size = stat.size;
         if (size === 0) {
             return null;
         }
         return readLastMessagePreviewFromOpenTranscript({ fd, size });
-    }
-    catch {
-        // file error
-    }
-    finally {
-        if (fd !== null) {
-            fs.closeSync(fd);
-        }
-    }
-    return null;
+    });
 }
 const PREVIEW_READ_SIZES = [64 * 1024, 256 * 1024, 1024 * 1024];
 const PREVIEW_MAX_LINES = 200;
@@ -446,20 +444,20 @@ function truncatePreviewText(text, maxChars) {
 }
 function extractPreviewText(message) {
     if (typeof message.content === "string") {
-        const trimmed = message.content.trim();
-        return trimmed ? trimmed : null;
+        const normalized = stripInlineDirectiveTagsForDisplay(message.content).text.trim();
+        return normalized ? normalized : null;
     }
     if (Array.isArray(message.content)) {
         const parts = message.content
-            .map((entry) => (typeof entry?.text === "string" ? entry.text : ""))
+            .map((entry) => typeof entry?.text === "string" ? stripInlineDirectiveTagsForDisplay(entry.text).text : "")
             .filter((text) => text.trim().length > 0);
         if (parts.length > 0) {
             return parts.join("\n").trim();
         }
     }
     if (typeof message.text === "string") {
-        const trimmed = message.text.trim();
-        return trimmed ? trimmed : null;
+        const normalized = stripInlineDirectiveTagsForDisplay(message.text).text.trim();
+        return normalized ? normalized : null;
     }
     return null;
 }

package/dist/gateway/sessions-resolve.js

@@ -1,8 +1,8 @@
-import { loadSessionStore } from "../config/sessions.js";
+import { loadSessionStore, updateSessionStore } from "../config/sessions.js";
 import { parseSessionLabel } from "../sessions/session-label.js";
 import { ErrorCodes, errorShape, } from "./protocol/index.js";
-import { listSessionsFromStore, loadCombinedSessionStoreForGateway, resolveGatewaySessionStoreTarget, } from "./session-utils.js";
-export function resolveSessionKeyFromResolveParams(params) {
+import { listSessionsFromStore, loadCombinedSessionStoreForGateway, pruneLegacyStoreKeys, resolveGatewaySessionStoreTarget, } from "./session-utils.js";
+export async function resolveSessionKeyFromResolveParams(params) {
     const { cfg, p } = params;
     const key = typeof p.key === "string" ? p.key.trim() : "";
     const hasKey = key.length > 0;
@@ -25,13 +25,25 @@ export function resolveSessionKeyFromResolveParams(params) {
     if (hasKey) {
         const target = resolveGatewaySessionStoreTarget({ cfg, key });
         const store = loadSessionStore(target.storePath);
-        const existingKey = target.storeKeys.find((candidate) => store[candidate]);
-        if (!existingKey) {
+        if (store[target.canonicalKey]) {
+            return { ok: true, key: target.canonicalKey };
+        }
+        const legacyKey = target.storeKeys.find((candidate) => store[candidate]);
+        if (!legacyKey) {
             return {
                 ok: false,
                 error: errorShape(ErrorCodes.INVALID_REQUEST, `No session found: ${key}`),
             };
         }
+        await updateSessionStore(target.storePath, (s) => {
+            const liveTarget = resolveGatewaySessionStoreTarget({ cfg, key, store: s });
+            const canonicalKey = liveTarget.canonicalKey;
+            // Migrate the first legacy entry to the canonical key.
+            if (!s[canonicalKey] && s[legacyKey]) {
+                s[canonicalKey] = s[legacyKey];
+            }
+            pruneLegacyStoreKeys({ store: s, canonicalKey, candidates: liveTarget.storeKeys });
+        });
         return { ok: true, key: target.canonicalKey };
     }
     if (hasSessionId) {

package/dist/gateway/test-helpers.openai-mock.js

@@ -1,8 +1,9 @@
 function extractLastUserText(input) {
     for (let i = input.length - 1; i >= 0; i -= 1) {
         const item = input[i];
-        if (!item || item.role !== "user")
+        if (!item || item.role !== "user") {
             continue;
+        }
         const content = item.content;
         if (Array.isArray(content)) {
             const text = content
@@ -13,8 +14,9 @@ function extractLastUserText(input) {
                 .map((c) => c.text)
                 .join("\n")
                 .trim();
-            if (text)
+            if (text) {
                 return text;
+            }
         }
     }
     return "";
@@ -22,8 +24,9 @@ function extractLastUserText(input) {
 function extractToolOutput(input) {
     for (const itemRaw of input) {
         const item = itemRaw;
-        if (!item || item.type !== "function_call_output")
+        if (!item || item.type !== "function_call_output") {
             continue;
+        }
         return typeof item.output === "string" ? item.output : "";
     }
     return "";
@@ -98,14 +101,18 @@ async function* fakeOpenAIResponsesStream(params) {
     };
 }
 function decodeBodyText(body) {
-    if (!body)
+    if (!body) {
         return "";
-    if (typeof body === "string")
+    }
+    if (typeof body === "string") {
         return body;
-    if (body instanceof Uint8Array)
+    }
+    if (body instanceof Uint8Array) {
         return Buffer.from(body).toString("utf8");
-    if (body instanceof ArrayBuffer)
+    }
+    if (body instanceof ArrayBuffer) {
         return Buffer.from(new Uint8Array(body)).toString("utf8");
+    }
     return "";
 }
 async function buildOpenAIResponsesSse(params) {

package/dist/gateway/tools-invoke-http.js

@@ -11,7 +11,7 @@ import { getPluginToolMeta } from "../plugins/tools.js";
 import { isSubagentSessionKey } from "../routing/session-key.js";
 import { DEFAULT_GATEWAY_HTTP_TOOL_DENY } from "../security/dangerous-tools.js";
 import { normalizeMessageChannel } from "../utils/message-channel.js";
-import { authorizeGatewayConnect } from "./auth.js";
+import { authorizeHttpGatewayConnect } from "./auth.js";
 import { readJsonBodyOrError, sendGatewayAuthFailure, sendInvalidRequest, sendJson, sendMethodNotAllowed, } from "./http-common.js";
 import { getBearerToken, getHeader } from "./http-utils.js";
 const DEFAULT_BODY_BYTES = 2 * 1024 * 1024;
@@ -71,14 +71,23 @@ function getErrorMessage(err) {
     }
     return String(err);
 }
-function isToolInputError(err) {
+function resolveToolInputErrorStatus(err) {
     if (err instanceof ToolInputError) {
-        return true;
+        const status = err.status;
+        return typeof status === "number" ? status : 400;
+    }
+    if (typeof err !== "object" || err === null || !("name" in err)) {
+        return null;
+    }
+    const name = err.name;
+    if (name !== "ToolInputError" && name !== "ToolAuthorizationError") {
+        return null;
     }
-    return (typeof err === "object" &&
-        err !== null &&
-        "name" in err &&
-        err.name === "ToolInputError");
+    const status = err.status;
+    if (typeof status === "number") {
+        return status;
+    }
+    return name === "ToolAuthorizationError" ? 403 : 400;
 }
 export async function handleToolsInvokeHttpRequest(req, res, opts) {
     const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
@@ -91,11 +100,12 @@ export async function handleToolsInvokeHttpRequest(req, res, opts) {
     }
     const cfg = loadConfig();
     const token = getBearerToken(req);
-    const authResult = await authorizeGatewayConnect({
+    const authResult = await authorizeHttpGatewayConnect({
         auth: opts.auth,
         connectAuth: token ? { token, password: token } : null,
         req,
         trustedProxies: opts.trustedProxies ?? cfg.gateway?.trustedProxies,
+        allowRealIpFallback: opts.allowRealIpFallback ?? cfg.gateway?.allowRealIpFallback,
         rateLimiter: opts.rateLimiter,
     });
     if (!authResult.ok) {
@@ -216,8 +226,9 @@ export async function handleToolsInvokeHttpRequest(req, res, opts) {
         sendJson(res, 200, { ok: true, result });
     }
     catch (err) {
-        if (isToolInputError(err)) {
-            sendJson(res, 400, {
+        const inputStatus = resolveToolInputErrorStatus(err);
+        if (inputStatus !== null) {
+            sendJson(res, inputStatus, {
                 ok: false,
                 error: { type: "tool_error", message: getErrorMessage(err) || "invalid tool arguments" },
             });

package/dist/hooks/bundled/bootstrap-extra-files/handler.js

@@ -1,7 +1,9 @@
 import { filterBootstrapFilesForSession, loadExtraBootstrapFiles, } from "../../../agents/workspace.js";
+import { createSubsystemLogger } from "../../../logging/subsystem.js";
 import { resolveHookConfig } from "../../config.js";
 import { isAgentBootstrapEvent } from "../../hooks.js";
 const HOOK_KEY = "bootstrap-extra-files";
+const log = createSubsystemLogger("bootstrap-extra-files");
 function normalizeStringArray(value) {
     if (!Array.isArray(value)) {
         return [];
@@ -40,7 +42,7 @@ const bootstrapExtraFilesHook = async (event) => {
         context.bootstrapFiles = filterBootstrapFilesForSession([...context.bootstrapFiles, ...extras], context.sessionKey);
     }
     catch (err) {
-        console.warn(`[bootstrap-extra-files] failed: ${String(err)}`);
+        log.warn(`failed: ${String(err)}`);
     }
 };
 export default bootstrapExtraFilesHook;

package/dist/hooks/bundled/command-logger/handler.js

@@ -25,6 +25,9 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import os from "node:os";
+import { resolveStateDir } from "../../../config/paths.js";
+import { createSubsystemLogger } from "../../../logging/subsystem.js";
+const log = createSubsystemLogger("command-logger");
 /**
  * Log all command events to a file
  */
@@ -35,7 +38,8 @@ const logCommand = async (event) => {
     }
     try {
         // Create log directory
-        const logDir = path.join(os.homedir(), ".poolbot", "logs");
+        const stateDir = resolveStateDir(process.env, os.homedir);
+        const logDir = path.join(stateDir, "logs");
         await fs.mkdir(logDir, { recursive: true });
         // Append to command log file
         const logFile = path.join(logDir, "commands.log");
@@ -49,7 +53,8 @@ const logCommand = async (event) => {
         await fs.appendFile(logFile, logLine, "utf-8");
     }
     catch (err) {
-        console.error("[command-logger] Failed to log command:", err instanceof Error ? err.message : String(err));
+        const message = err instanceof Error ? err.message : String(err);
+        log.error(`Failed to log command: ${message}`);
     }
 };
 export default logCommand;

package/dist/hooks/bundled/session-memory/handler.js

@@ -1,7 +1,7 @@
 /**
  * Session memory hook handler
  *
- * Saves session context to memory when /new command is triggered
+ * Saves session context to memory when /new or /reset command is triggered
  * Creates a new dated memory file with LLM-generated slug
  */
 import fs from "node:fs/promises";
@@ -137,15 +137,16 @@ async function findPreviousSessionFile(params) {
     return undefined;
 }
 /**
- * Save session context to memory when /new command is triggered
+ * Save session context to memory when /new or /reset command is triggered
  */
 const saveSessionToMemory = async (event) => {
-    // Only trigger on 'new' command
-    if (event.type !== "command" || event.action !== "new") {
+    // Only trigger on reset/new commands
+    const isResetCommand = event.action === "new" || event.action === "reset";
+    if (event.type !== "command" || !isResetCommand) {
         return;
     }
     try {
-        log.debug("Hook triggered for /new command");
+        log.debug("Hook triggered for reset/new command", { action: event.action });
         const context = event.context || {};
         const cfg = context.cfg;
         const agentId = resolveAgentIdFromSessionKey(event.sessionKey);

package/dist/hooks/frontmatter.js

@@ -1,10 +1,10 @@
 import { parseFrontmatterBlock } from "../markdown/frontmatter.js";
-import { getFrontmatterString, normalizeStringList, parsePoolbotManifestInstallBase, parseFrontmatterBool, resolvePoolbotManifestBlock, resolvePoolbotManifestInstall, resolvePoolbotManifestOs, resolvePoolbotManifestRequires, } from "../shared/frontmatter.js";
+import { getFrontmatterString, normalizeStringList, parsePoolBotManifestInstallBase, parseFrontmatterBool, resolvePoolBotManifestBlock, resolvePoolBotManifestInstall, resolvePoolBotManifestOs, resolvePoolBotManifestRequires, } from "../shared/frontmatter.js";
 export function parseFrontmatter(content) {
     return parseFrontmatterBlock(content);
 }
 function parseInstallSpec(input) {
-    const parsed = parsePoolbotManifestInstallBase(input, ["bundled", "npm", "git"]);
+    const parsed = parsePoolBotManifestInstallBase(input, ["bundled", "npm", "git"]);
     if (!parsed) {
         return undefined;
     }
@@ -30,13 +30,13 @@ function parseInstallSpec(input) {
     return spec;
 }
 export function resolvePoolbotMetadata(frontmatter) {
-    const metadataObj = resolvePoolbotManifestBlock({ frontmatter });
+    const metadataObj = resolvePoolBotManifestBlock({ frontmatter });
     if (!metadataObj) {
         return undefined;
     }
-    const requires = resolvePoolbotManifestRequires(metadataObj);
-    const install = resolvePoolbotManifestInstall(metadataObj, parseInstallSpec);
-    const osRaw = resolvePoolbotManifestOs(metadataObj);
+    const requires = resolvePoolBotManifestRequires(metadataObj);
+    const install = resolvePoolBotManifestInstall(metadataObj, parseInstallSpec);
+    const osRaw = resolvePoolBotManifestOs(metadataObj);
     const eventsRaw = normalizeStringList(metadataObj.events);
     return {
         always: typeof metadataObj.always === "boolean" ? metadataObj.always : undefined,

package/dist/hooks/gmail-watcher.js

@@ -8,8 +8,8 @@ import { spawn } from "node:child_process";
 import { hasBinary } from "../agents/skills.js";
 import { createSubsystemLogger } from "../logging/subsystem.js";
 import { runCommandWithTimeout } from "../process/exec.js";
-import { buildGogWatchServeArgs, buildGogWatchStartArgs, resolveGmailHookRuntimeConfig, } from "./gmail.js";
 import { ensureTailscaleEndpoint } from "./gmail-setup-utils.js";
+import { buildGogWatchServeArgs, buildGogWatchStartArgs, resolveGmailHookRuntimeConfig, } from "./gmail.js";
 const log = createSubsystemLogger("gmail-watcher");
 const ADDRESS_IN_USE_RE = /address already in use|EADDRINUSE/i;
 export function isAddressInUseError(line) {
@@ -58,13 +58,15 @@ function spawnGogServe(cfg) {
     });
     child.stdout?.on("data", (data) => {
         const line = data.toString().trim();
-        if (line)
+        if (line) {
             log.info(`[gog] ${line}`);
+        }
     });
     child.stderr?.on("data", (data) => {
         const line = data.toString().trim();
-        if (!line)
+        if (!line) {
             return;
+        }
         if (isAddressInUseError(line)) {
             addressInUse = true;
         }
@@ -74,8 +76,9 @@ function spawnGogServe(cfg) {
         log.error(`gog process error: ${String(err)}`);
     });
     child.on("exit", (code, signal) => {
-        if (shuttingDown)
+        if (shuttingDown) {
             return;
+        }
         if (addressInUse) {
             log.warn("gog serve failed to bind (address already in use); stopping restarts. " +
                 "Another watcher is likely running. Set POOLBOT_SKIP_GMAIL_WATCHER=1 or stop the other process.");
@@ -85,8 +88,9 @@ function spawnGogServe(cfg) {
         log.warn(`gog exited (code=${code}, signal=${signal}); restarting in 5s`);
         watcherProcess = null;
         setTimeout(() => {
-            if (shuttingDown || !currentConfig)
+            if (shuttingDown || !currentConfig) {
                 return;
+            }
             watcherProcess = spawnGogServe(currentConfig);
         }, 5000);
     });
@@ -146,8 +150,9 @@ export async function startGmailWatcher(cfg) {
     // Set up renewal interval
     const renewMs = runtimeConfig.renewEveryMinutes * 60_000;
     renewInterval = setInterval(() => {
-        if (shuttingDown)
+        if (shuttingDown) {
             return;
+        }
         void startGmailWatch(runtimeConfig);
     }, renewMs);
     log.info(`gmail watcher started for ${runtimeConfig.account} (renew every ${runtimeConfig.renewEveryMinutes}m)`);

package/dist/hooks/internal-hooks.js

@@ -4,8 +4,10 @@
  * Provides an extensible event-driven hook system for agent events
  * like command processing, session lifecycle, etc.
  */
+import { createSubsystemLogger } from "../logging/subsystem.js";
 /** Registry of hook handlers by event key */
 const handlers = new Map();
+const log = createSubsystemLogger("internal-hooks");
 /**
  * Register a hook handler for a specific event type or event:action combination
  *
@@ -87,7 +89,8 @@ export async function triggerInternalHook(event) {
             await handler(event);
         }
         catch (err) {
-            console.error(`Hook error [${event.type}:${event.action}]:`, err instanceof Error ? err.message : String(err));
+            const message = err instanceof Error ? err.message : String(err);
+            log.error(`Hook error [${event.type}:${event.action}]: ${message}`);
         }
     }
 }
@@ -122,6 +125,13 @@ export function isAgentBootstrapEvent(event) {
     }
     return Array.isArray(context.bootstrapFiles);
 }
+export function isGatewayStartupEvent(event) {
+    if (event.type !== "gateway" || event.action !== "startup") {
+        return false;
+    }
+    const context = event.context;
+    return Boolean(context && typeof context === "object");
+}
 export function isMessageReceivedEvent(event) {
     if (event.type !== "message" || event.action !== "received") {
         return false;

package/dist/hooks/llm-slug-generator.js

@@ -6,6 +6,8 @@ import os from "node:os";
 import path from "node:path";
 import { runEmbeddedPiAgent } from "../agents/pi-embedded.js";
 import { resolveDefaultAgentId, resolveAgentWorkspaceDir, resolveAgentDir, } from "../agents/agent-scope.js";
+import { createSubsystemLogger } from "../logging/subsystem.js";
+const log = createSubsystemLogger("llm-slug-generator");
 /**
  * Generate a short 1-2 word filename slug from session content using LLM
  */
@@ -53,7 +55,8 @@ Reply with ONLY the slug, nothing else. Examples: "vendor-pitch", "api-design",
         return null;
     }
     catch (err) {
-        console.error("[llm-slug-generator] Failed to generate slug:", err);
+        const message = err instanceof Error ? (err.stack ?? err.message) : String(err);
+        log.error(`Failed to generate slug: ${message}`);
         return null;
     }
     finally {