@intent-systems/nexus 2026.1.5-3 → 2026.1.5-5

package/dist/agents/sandbox.js

@@ -4,7 +4,7 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { startBrowserBridgeServer, stopBrowserBridgeServer, } from "../browser/bridge-server.js";
-import { resolveProfile } from "../browser/config.js";
+import { resolveProfile, } from "../browser/config.js";
 import { DEFAULT_NEXUS_BROWSER_COLOR } from "../browser/constants.js";
 import { STATE_DIR_NEXUS } from "../config/config.js";
 import { defaultRuntime } from "../runtime.js";
@@ -27,7 +27,14 @@ const DEFAULT_TOOL_ALLOW = [
     "sessions_send",
     "sessions_spawn",
 ];
-const DEFAULT_TOOL_DENY = ["browser", "canvas", "nodes", "cron", "discord", "gateway"];
+const DEFAULT_TOOL_DENY = [
+    "browser",
+    "canvas",
+    "nodes",
+    "cron",
+    "discord",
+    "gateway",
+];
 export const DEFAULT_SANDBOX_BROWSER_IMAGE = "nexus-sandbox-browser:bookworm-slim";
 export const DEFAULT_SANDBOX_COMMON_IMAGE = "nexus-sandbox-common:bookworm-slim";
 const DEFAULT_SANDBOX_BROWSER_PREFIX = "nexus-sbx-browser-";
@@ -490,7 +497,9 @@ async function ensureSandboxBrowser(params) {
         ? await readDockerPort(containerName, params.cfg.browser.noVncPort)
         : null;
     const existing = BROWSER_BRIDGES.get(params.sessionKey);
-    const existingProfile = existing ? resolveProfile(existing.bridge.state.resolved, "nexus") : null;
+    const existingProfile = existing
+        ? resolveProfile(existing.bridge.state.resolved, "nexus")
+        : null;
     const shouldReuse = existing &&
         existing.containerName === containerName &&
         existingProfile?.cdpPort === mappedCdp;

package/dist/agents/skill-runner.js

@@ -3,10 +3,11 @@ import path from "node:path";
 import { loadConfig } from "../config/config.js";
 import { runCommandWithTimeout } from "../process/exec.js";
 import { MANAGED_SKILLS_DIR, resolveUserPath } from "../utils.js";
-import { DEFAULT_AGENT_WORKSPACE_DIR } from "./workspace.js";
-import { buildWorkspaceSkillStatus } from "./skills-status.js";
-import { getSkillMetadata, hasBinary, loadWorkspaceSkillEntries, } from "./skills.js";
 import { getSkillExecutionType, getSkillScriptConfig, getSkillToolConfig, } from "./skill-tools.js";
+import { recordSkillUsage } from "./skill-usage.js";
+import { getSkillMetadata, hasBinary, loadWorkspaceSkillEntries, } from "./skills.js";
+import { buildWorkspaceSkillStatus } from "./skills-status.js";
+import { DEFAULT_AGENT_WORKSPACE_DIR } from "./workspace.js";
 function loadSkillContext(name) {
     const config = loadConfig();
     const workspaceDir = resolveUserPath(config.agent?.workspace ?? DEFAULT_AGENT_WORKSPACE_DIR);
@@ -90,8 +91,18 @@ export async function runSkill(name, args) {
     if (!entry) {
         return { ok: false, error: `Skill not found: ${name}` };
     }
+    const startedAt = Date.now();
+    const record = (ok) => {
+        recordSkillUsage(entry.skill.name, {
+            ts: Date.now(),
+            event: "run",
+            ok,
+            durationMs: Date.now() - startedAt,
+        });
+    };
     const execType = getSkillExecutionType(entry.skill.name);
     if (execType === "prompt") {
+        record(false);
         return {
             ok: false,
             error: "Skill is prompt-only and has no runnable command.",
@@ -100,13 +111,19 @@ export async function runSkill(name, args) {
     if (execType === "tool") {
         const toolConfig = getSkillToolConfig(entry.skill.name);
         if (!toolConfig?.tool) {
+            record(false);
             return { ok: false, error: "Skill tool configuration missing." };
         }
         if (!hasBinary(toolConfig.tool)) {
+            record(false);
             return { ok: false, error: `Missing binary: ${toolConfig.tool}` };
         }
-        const result = await runCommandWithTimeout([toolConfig.tool, ...args], { timeoutMs: 300_000, cwd: entry.skill.baseDir });
+        const result = await runCommandWithTimeout([toolConfig.tool, ...args], {
+            timeoutMs: 300_000,
+            cwd: entry.skill.baseDir,
+        });
         if (result.code !== 0) {
+            record(false);
             return {
                 ok: false,
                 error: result.stderr || result.stdout || "Skill command failed.",
@@ -115,6 +132,7 @@ export async function runSkill(name, args) {
                 code: result.code,
             };
         }
+        record(true);
         return {
             ok: true,
             stdout: result.stdout,
@@ -125,9 +143,11 @@ export async function runSkill(name, args) {
     if (execType === "script") {
         const scriptConfig = getSkillScriptConfig(entry.skill.name);
         if (!scriptConfig) {
+            record(false);
             return { ok: false, error: "Skill script configuration missing." };
         }
         if (!hasBinary(scriptConfig.runner)) {
+            record(false);
             return {
                 ok: false,
                 error: `Missing runner: ${scriptConfig.runner}`,
@@ -135,11 +155,13 @@ export async function runSkill(name, args) {
         }
         const scriptPath = path.join(entry.skill.baseDir, scriptConfig.script);
         if (!fs.existsSync(scriptPath)) {
+            record(false);
             return { ok: false, error: `Script not found: ${scriptConfig.script}` };
         }
         if (scriptConfig.requiredEnv?.length) {
             const missingEnv = scriptConfig.requiredEnv.filter((envName) => !process.env[envName]);
             if (missingEnv.length > 0) {
+                record(false);
                 return {
                     ok: false,
                     error: `Missing env: ${missingEnv.join(", ")}`,
@@ -148,6 +170,7 @@ export async function runSkill(name, args) {
         }
         const result = await runCommandWithTimeout([scriptConfig.runner, scriptPath, ...args], { timeoutMs: 300_000, cwd: entry.skill.baseDir });
         if (result.code !== 0) {
+            record(false);
             return {
                 ok: false,
                 error: result.stderr || result.stdout || "Skill script failed.",
@@ -156,6 +179,7 @@ export async function runSkill(name, args) {
                 code: result.code,
             };
         }
+        record(true);
         return {
             ok: true,
             stdout: result.stdout,
@@ -163,6 +187,7 @@ export async function runSkill(name, args) {
             code: result.code,
         };
     }
+    record(false);
     return { ok: false, error: "Unknown skill execution type." };
 }
 export async function verifySkill(name) {

package/dist/agents/skill-usage.js

@@ -1,8 +1,10 @@
+import fs from "node:fs";
+import path from "node:path";
 import { loadConfig } from "../config/config.js";
 import { MANAGED_SKILLS_DIR, resolveUserPath } from "../utils.js";
-import { DEFAULT_AGENT_WORKSPACE_DIR } from "./workspace.js";
-import { buildWorkspaceSkillStatus } from "./skills-status.js";
 import { loadWorkspaceSkillEntries } from "./skills.js";
+import { buildWorkspaceSkillStatus } from "./skills-status.js";
+import { DEFAULT_AGENT_WORKSPACE_DIR } from "./workspace.js";
 function loadSkillEntries() {
     const config = loadConfig();
     const workspaceDir = resolveUserPath(config.agent?.workspace ?? DEFAULT_AGENT_WORKSPACE_DIR);
@@ -13,31 +15,132 @@ function loadSkillEntries() {
     });
     return { config, workspaceDir, managedSkillsDir, entries };
 }
-export async function getSkillStats(name) {
+function resolveUsageLogPath(name) {
+    return path.join(MANAGED_SKILLS_DIR, name, "usage.log");
+}
+function parseUsageEntry(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed?.ts !== "number")
+            return null;
+        if (parsed.event !== "use" && parsed.event !== "run")
+            return null;
+        if (typeof parsed.ok !== "boolean")
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function readUsageEntries(name, sinceMs) {
+    const logPath = resolveUsageLogPath(name);
+    try {
+        const raw = fs.readFileSync(logPath, "utf-8");
+        const entries = [];
+        for (const line of raw.split(/\r?\n/)) {
+            if (!line.trim())
+                continue;
+            const entry = parseUsageEntry(line);
+            if (!entry)
+                continue;
+            if (sinceMs && entry.ts < sinceMs)
+                continue;
+            entries.push(entry);
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+function hasUsageEntries(name) {
+    const logPath = resolveUsageLogPath(name);
+    try {
+        const stat = fs.statSync(logPath);
+        return stat.isFile() && stat.size > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export function hasSkillUsage(name) {
+    return hasUsageEntries(name);
+}
+export function readSkillUsageEntries(name, opts) {
+    const entries = readUsageEntries(name, opts?.sinceMs);
+    if (opts?.limit && opts.limit > 0) {
+        return entries.slice(-opts.limit);
+    }
+    return entries;
+}
+export function recordSkillUsage(name, entry) {
+    const logPath = resolveUsageLogPath(name);
+    try {
+        fs.mkdirSync(path.dirname(logPath), { recursive: true });
+        fs.appendFileSync(logPath, `${JSON.stringify(entry)}\n`, "utf-8");
+    }
+    catch {
+        // ignore logging failures
+    }
+}
+export async function getSkillStats(name, opts) {
     const { entries } = loadSkillEntries();
     const entry = entries.find((item) => item.skill.name.toLowerCase() === name.toLowerCase());
     if (!entry)
         return null;
+    const sinceMs = opts?.windowDays && opts.windowDays > 0
+        ? Date.now() - opts.windowDays * 24 * 60 * 60 * 1000
+        : undefined;
+    const entriesUsed = readUsageEntries(entry.skill.name, sinceMs);
+    const runs = entriesUsed.length;
+    const errors = entriesUsed.filter((item) => !item.ok).length;
+    const lastTs = entriesUsed.reduce((max, item) => Math.max(max, item.ts), 0);
+    const durations = entriesUsed
+        .map((item) => item.durationMs)
+        .filter((val) => typeof val === "number" && val >= 0);
+    const avgDurationMs = durations.length > 0
+        ? Math.round(durations.reduce((sum, val) => sum + val, 0) / durations.length)
+        : undefined;
     return {
-        runs: 0,
-        errors: 0,
-        lastUsed: undefined,
-        avgDurationMs: undefined,
+        runs,
+        errors,
+        lastUsed: lastTs ? new Date(lastTs).toISOString() : undefined,
+        avgDurationMs,
     };
 }
-export async function getAggregateStats() {
+export async function getAggregateStats(opts) {
     const { config, workspaceDir, managedSkillsDir, entries } = loadSkillEntries();
     const status = buildWorkspaceSkillStatus(workspaceDir, {
         config,
         managedSkillsDir,
         entries,
     });
+    const sinceMs = opts?.windowDays && opts.windowDays > 0
+        ? Date.now() - opts.windowDays * 24 * 60 * 60 * 1000
+        : undefined;
+    const usageCounts = [];
+    let totalRuns = 0;
+    for (const entry of entries) {
+        const skillRuns = readUsageEntries(entry.skill.name, sinceMs).length;
+        if (skillRuns > 0) {
+            usageCounts.push({ name: entry.skill.name, runs: skillRuns });
+        }
+        totalRuns += skillRuns;
+    }
+    usageCounts.sort((a, b) => b.runs - a.runs);
+    const mostUsed = usageCounts[0];
+    const limit = typeof opts?.limit === "number" && opts.limit > 0 ? opts.limit : 5;
+    const topUsed = usageCounts.slice(0, limit);
     return {
-        totalRuns: 0,
+        totalRuns,
         activeSkills: entries.length,
-        mostUsed: undefined,
+        mostUsed: mostUsed
+            ? { name: mostUsed.name, runs: mostUsed.runs }
+            : undefined,
+        topUsed: topUsed.map((item) => ({ name: item.name, runs: item.runs })),
         readyButUnused: status.skills
-            .filter((skill) => skill.eligible)
+            .filter((skill) => skill.eligible && !hasUsageEntries(skill.name))
             .map((skill) => skill.name),
     };
 }

package/dist/agents/skills-status.js

@@ -1,5 +1,4 @@
-import path from "node:path";
-import { CONFIG_DIR } from "../utils.js";
+import { MANAGED_SKILLS_DIR } from "../utils.js";
 import { getSkillMetadata, hasBinary, isBundledSkillAllowed, isConfigPathTruthy, loadWorkspaceSkillEntries, resolveBundledAllowlist, resolveConfigPath, resolveSkillConfig, resolveSkillsInstallPreferences, } from "./skills.js";
 function resolveSkillKey(entry) {
     return getSkillMetadata(entry)?.skillKey ?? entry.skill.name;
@@ -92,7 +91,8 @@ function buildSkillStatus(entry, config, prefs) {
             continue;
         if (skillConfig?.env?.[envName])
             continue;
-        if (skillConfig?.apiKey && getSkillMetadata(entry)?.primaryEnv === envName) {
+        if (skillConfig?.apiKey &&
+            getSkillMetadata(entry)?.primaryEnv === envName) {
             continue;
         }
         missingEnv.push(envName);
@@ -146,7 +146,7 @@ function buildSkillStatus(entry, config, prefs) {
     };
 }
 export function buildWorkspaceSkillStatus(workspaceDir, opts) {
-    const managedSkillsDir = opts?.managedSkillsDir ?? path.join(CONFIG_DIR, "skills");
+    const managedSkillsDir = opts?.managedSkillsDir ?? MANAGED_SKILLS_DIR;
     const skillEntries = opts?.entries ?? loadWorkspaceSkillEntries(workspaceDir, opts);
     const prefs = resolveSkillsInstallPreferences(opts?.config);
     return {

package/dist/agents/skills.js

@@ -212,7 +212,9 @@ function resolveNexusMetadata(frontmatter) {
         const requiresRaw = typeof metadataObj.requires === "object" && metadataObj.requires !== null
             ? metadataObj.requires
             : undefined;
-        const installRaw = Array.isArray(metadataObj.install) ? metadataObj.install : [];
+        const installRaw = Array.isArray(metadataObj.install)
+            ? metadataObj.install
+            : [];
         const install = installRaw
             .map((entry) => parseInstallSpec(entry))
             .filter((entry) => Boolean(entry));
@@ -223,11 +225,19 @@ function resolveNexusMetadata(frontmatter) {
             : undefined;
         const provides = normalizeStringList(metadataObj.provides);
         return {
-            always: typeof metadataObj.always === "boolean" ? metadataObj.always : undefined,
+            always: typeof metadataObj.always === "boolean"
+                ? metadataObj.always
+                : undefined,
             emoji: typeof metadataObj.emoji === "string" ? metadataObj.emoji : undefined,
-            homepage: typeof metadataObj.homepage === "string" ? metadataObj.homepage : undefined,
-            skillKey: typeof metadataObj.skillKey === "string" ? metadataObj.skillKey : undefined,
-            primaryEnv: typeof metadataObj.primaryEnv === "string" ? metadataObj.primaryEnv : undefined,
+            homepage: typeof metadataObj.homepage === "string"
+                ? metadataObj.homepage
+                : undefined,
+            skillKey: typeof metadataObj.skillKey === "string"
+                ? metadataObj.skillKey
+                : undefined,
+            primaryEnv: typeof metadataObj.primaryEnv === "string"
+                ? metadataObj.primaryEnv
+                : undefined,
             os: osRaw.length > 0 ? osRaw : undefined,
             type,
             provides: provides.length > 0 ? provides : undefined,
@@ -251,7 +261,7 @@ export function getSkillMetadata(entry) {
     return entry.nexus;
 }
 function resolveSkillKey(skill, entry) {
-    return entry ? getSkillMetadata(entry)?.skillKey ?? skill.name : skill.name;
+    return entry ? (getSkillMetadata(entry)?.skillKey ?? skill.name) : skill.name;
 }
 function shouldIncludeSkill(params) {
     const { entry, config } = params;
@@ -289,7 +299,8 @@ function shouldIncludeSkill(params) {
                 continue;
             if (skillConfig?.env?.[envName])
                 continue;
-            if (skillConfig?.apiKey && getSkillMetadata(entry)?.primaryEnv === envName) {
+            if (skillConfig?.apiKey &&
+                getSkillMetadata(entry)?.primaryEnv === envName) {
                 continue;
             }
             return false;

package/dist/agents/subagent-registry.js

@@ -2,26 +2,31 @@ import crypto from "node:crypto";
 import { loadConfig, STATE_DIR_NEXUS } from "../config/config.js";
 import { callGateway } from "../gateway/call.js";
 import { normalizeAgentId, parseAgentSessionKey, resolveAgentIdFromSessionKey, } from "../routing/session-key.js";
-import { resolveDisplaySessionKey, resolveInternalSessionKey, resolveMainSessionAlias, stripToolMessages, } from "./tools/sessions-helpers.js";
-import { resolveAnnounceTarget } from "./tools/sessions-announce-target.js";
+import { createFileSubagentStore, } from "./subagent-registry.store.js";
 import { readLatestAssistantReply, runAgentStep } from "./tools/agent-step.js";
+import { resolveAnnounceTarget } from "./tools/sessions-announce-target.js";
+import { resolveDisplaySessionKey, resolveInternalSessionKey, resolveMainSessionAlias, stripToolMessages, } from "./tools/sessions-helpers.js";
 import { isAnnounceSkip } from "./tools/sessions-send-helpers.js";
-import { createFileSubagentStore, } from "./subagent-registry.store.js";
 function normalizeStoredEntry(entry) {
     if (!entry || typeof entry !== "object")
         return null;
     const sessionKey = typeof entry.sessionKey === "string" ? entry.sessionKey.trim() : "";
-    const parentSessionKey = typeof entry.parentSessionKey === "string" ? entry.parentSessionKey.trim() : "";
+    const parentSessionKey = typeof entry.parentSessionKey === "string"
+        ? entry.parentSessionKey.trim()
+        : "";
     if (!sessionKey || !parentSessionKey)
         return null;
-    const status = entry.status === "announced" || entry.status === "failed" || entry.status === "pending"
+    const status = entry.status === "announced" ||
+        entry.status === "failed" ||
+        entry.status === "pending"
         ? entry.status
         : "pending";
     const createdAt = typeof entry.createdAt === "string" && entry.createdAt.trim()
         ? entry.createdAt
         : new Date().toISOString();
     const agentId = normalizeAgentId(entry.agentId);
-    const legacyRequester = entry.requesterProvider;
+    const legacyRequester = entry
+        .requesterProvider;
     return {
         ...entry,
         agentId,
@@ -36,8 +41,12 @@ function buildSubagentAnnouncePrompt(params) {
     const taskLine = params.task?.trim() ? params.task.trim() : "(not available)";
     const lines = [
         "Sub-agent announce step:",
-        params.requesterSessionKey ? `Requester session: ${params.requesterSessionKey}.` : undefined,
-        params.requesterChannel ? `Requester channel: ${params.requesterChannel}.` : undefined,
+        params.requesterSessionKey
+            ? `Requester session: ${params.requesterSessionKey}.`
+            : undefined,
+        params.requesterChannel
+            ? `Requester channel: ${params.requesterChannel}.`
+            : undefined,
         `Post target channel: ${params.announceChannel}.`,
         `Original task: ${taskLine}`,
         params.subagentReply
@@ -94,7 +103,9 @@ async function readSubagentTask(sessionKey) {
 }
 async function runSubagentAnnounceFlow(params) {
     let status = "pending";
-    const timeoutMs = typeof params.timeoutMs === "number" && params.timeoutMs > 0 ? params.timeoutMs : 30_000;
+    const timeoutMs = typeof params.timeoutMs === "number" && params.timeoutMs > 0
+        ? params.timeoutMs
+        : 30_000;
     try {
         let reply = params.roundOneReply?.trim();
         if (!reply) {
@@ -140,7 +151,9 @@ async function runSubagentAnnounceFlow(params) {
             timeoutMs,
             lane: "nested",
         });
-        if (!announceReply || !announceReply.trim() || isAnnounceSkip(announceReply)) {
+        if (!announceReply ||
+            !announceReply.trim() ||
+            isAnnounceSkip(announceReply)) {
             status = "announced";
             return status;
         }
@@ -178,7 +191,8 @@ async function runSubagentAnnounceFlow(params) {
     }
 }
 export function createSubagentRegistry(params) {
-    const store = params?.store ?? createFileSubagentStore(params?.stateDir ?? STATE_DIR_NEXUS);
+    const store = params?.store ??
+        createFileSubagentStore(params?.stateDir ?? STATE_DIR_NEXUS);
     const entries = new Map();
     let initialized = false;
     let resumeInFlight = null;

package/dist/agents/system-prompt.js

@@ -82,6 +82,7 @@ export function buildAgentSystemPromptAppend(params) {
     const userTimezone = params.userTimezone?.trim();
     const userTime = params.userTime?.trim();
     const runtimeInfo = params.runtimeInfo;
+    const reactionGuidance = params.reactionGuidance;
     const runtimeLines = [];
     if (runtimeInfo?.host)
         runtimeLines.push(`Host: ${runtimeInfo.host}`);
@@ -124,6 +125,12 @@ export function buildAgentSystemPromptAppend(params) {
             : "",
         "TOOLS.md does not control tool availability; it is user guidance for how to use external tools.",
         "",
+        "## Nexus CLI Quick Reference",
+        "- nexus status: show overall status",
+        "- nexus gateway restart: restart the gateway process",
+        "- nexus usage upload: upload usage batches",
+        "Do not invent commands; run `nexus help` to list available commands.",
+        "",
         "## Workspace",
         `Your working directory is: ${params.workspaceDir}`,
         "Treat this directory as the single global workspace for file operations unless explicitly instructed otherwise.",
@@ -167,6 +174,15 @@ export function buildAgentSystemPromptAppend(params) {
         "- [[reply_to:<id>]] replies to a specific message id when you have it.",
         "Tags are stripped before sending; support depends on the current provider config.",
         "",
+        reactionGuidance && reactionGuidance.level && reactionGuidance.level !== "off"
+            ? "## Reactions"
+            : "",
+        reactionGuidance && reactionGuidance.level && reactionGuidance.level !== "off"
+            ? `Reactions are enabled for ${reactionGuidance.channel ?? "this channel"} in ${reactionGuidance.level.toUpperCase()} mode.`
+            : "",
+        reactionGuidance && reactionGuidance.level && reactionGuidance.level !== "off"
+            ? ""
+            : "",
     ];
     if (extraSystemPrompt) {
         lines.push("## Group Chat Context", extraSystemPrompt, "");

package/dist/agents/tool-policy.js

@@ -10,7 +10,12 @@ export const TOOL_GROUPS = {
     // Host/runtime execution tools
     "group:runtime": ["exec", "process"],
     // Session management tools
-    "group:sessions": ["sessions_list", "sessions_history", "sessions_send", "sessions_spawn"],
+    "group:sessions": [
+        "sessions_list",
+        "sessions_history",
+        "sessions_send",
+        "sessions_spawn",
+    ],
     // UI helpers
     "group:ui": ["browser", "canvas"],
     // Automation + infra
@@ -43,10 +48,21 @@ const TOOL_PROFILES = {
         allow: ["sessions_list"],
     },
     coding: {
-        allow: ["group:fs", "group:runtime", "group:sessions", "group:memory", "image"],
+        allow: [
+            "group:fs",
+            "group:runtime",
+            "group:sessions",
+            "group:memory",
+            "image",
+        ],
     },
     messaging: {
-        allow: ["group:messaging", "sessions_list", "sessions_history", "sessions_send"],
+        allow: [
+            "group:messaging",
+            "sessions_list",
+            "sessions_history",
+            "sessions_send",
+        ],
     },
     full: {},
 };

package/dist/agents/tools/browser-tool.js

@@ -1,8 +1,8 @@
 import { Type } from "@sinclair/typebox";
 import { browserCloseTab, browserFocusTab, browserOpenTab, browserSnapshot, browserStart, browserStatus, browserStop, browserTabs, } from "../../browser/client.js";
 import { browserAct, browserArmDialog, browserArmFileChooser, browserConsoleMessages, browserNavigate, browserPdfSave, browserScreenshotAction, } from "../../browser/client-actions.js";
-import { DEFAULT_AI_SNAPSHOT_MAX_CHARS } from "../../browser/constants.js";
 import { resolveBrowserConfig } from "../../browser/config.js";
+import { DEFAULT_AI_SNAPSHOT_MAX_CHARS } from "../../browser/constants.js";
 import { loadConfig } from "../../config/config.js";
 import { imageResultFromFile, jsonResult, readStringParam, } from "./common.js";
 const BrowserActSchema = Type.Union([
@@ -178,11 +178,14 @@ export function createBrowserTool(opts) {
                         params.maxChars > 0
                         ? Math.floor(params.maxChars)
                         : undefined;
-                    const resolvedMaxChars = format === "ai" ? maxChars ?? DEFAULT_AI_SNAPSHOT_MAX_CHARS : undefined;
+                    const resolvedMaxChars = format === "ai"
+                        ? (maxChars ?? DEFAULT_AI_SNAPSHOT_MAX_CHARS)
+                        : undefined;
                     const snapshot = await browserSnapshot(baseUrl, {
                         format,
                         targetId,
                         limit,
+                        maxChars: resolvedMaxChars,
                     });
                     if (snapshot.format === "ai") {
                         return {