@poolzin/pool-bot 2026.2.0 → 2026.2.2

package/dist/extensionAPI.js

@@ -0,0 +1,8 @@
+export { resolveAgentDir, resolveAgentWorkspaceDir } from "./agents/agent-scope.js";
+export { DEFAULT_MODEL, DEFAULT_PROVIDER } from "./agents/defaults.js";
+export { resolveAgentIdentity } from "./agents/identity.js";
+export { resolveThinkingDefault } from "./agents/model-selection.js";
+export { runEmbeddedPiAgent } from "./agents/pi-embedded.js";
+export { resolveAgentTimeoutMs } from "./agents/timeout.js";
+export { ensureAgentWorkspace } from "./agents/workspace.js";
+export { resolveStorePath, loadSessionStore, saveSessionStore, resolveSessionFilePath, } from "./config/sessions.js";

package/dist/gateway/control-ui.js

@@ -204,7 +204,14 @@ export function handleControlUiHttpRequest(req, res, opts) {
         if (!pathname.startsWith(`${basePath}/`))
             return false;
     }
-    const root = resolveControlUiRoot();
+    const root = (() => {
+        if (opts?.root) {
+            if (opts.root.kind === "resolved")
+                return opts.root.path;
+            return null;
+        }
+        return resolveControlUiRoot();
+    })();
     if (!root) {
         res.statusCode = 503;
         res.setHeader("Content-Type", "text/plain; charset=utf-8");

package/dist/gateway/hooks-mapping.js

@@ -87,6 +87,7 @@ function normalizeHookMapping(mapping, index, transformsDir) {
         action,
         wakeMode,
         name: mapping.name,
+        agentId: mapping.agentId?.trim() || undefined,
         sessionKey: mapping.sessionKey,
         messageTemplate: mapping.messageTemplate,
         textTemplate: mapping.textTemplate,
@@ -131,6 +132,7 @@ function buildActionFromMapping(mapping, ctx) {
             kind: "agent",
             message,
             name: renderOptional(mapping.name, ctx),
+            agentId: mapping.agentId,
             wakeMode: mapping.wakeMode ?? "now",
             sessionKey: renderOptional(mapping.sessionKey, ctx),
             deliver: mapping.deliver,
@@ -162,6 +164,7 @@ function mergeAction(base, override, defaultAction) {
         message,
         wakeMode,
         name: override.name ?? baseAgent?.name,
+        agentId: override.agentId ?? baseAgent?.agentId,
         sessionKey: override.sessionKey ?? baseAgent?.sessionKey,
         deliver: typeof override.deliver === "boolean" ? override.deliver : baseAgent?.deliver,
         allowUnsafeExternalContent: typeof override.allowUnsafeExternalContent === "boolean"

package/dist/gateway/hooks.js

@@ -1,5 +1,7 @@
 import { randomUUID } from "node:crypto";
+import { listAgentIds, resolveDefaultAgentId } from "../agents/agent-scope.js";
 import { listChannelPlugins } from "../channels/plugins/index.js";
+import { normalizeAgentId } from "../routing/session-key.js";
 import { normalizeMessageChannel } from "../utils/message-channel.js";
 import { resolveHookMappings } from "./hooks-mapping.js";
 const DEFAULT_HOOKS_PATH = "/hooks";
@@ -21,13 +23,48 @@ export function resolveHooksConfig(cfg) {
         ? cfg.hooks.maxBodyBytes
         : DEFAULT_HOOKS_MAX_BODY_BYTES;
     const mappings = resolveHookMappings(cfg.hooks);
+    const defaultAgentId = resolveDefaultAgentId(cfg);
+    const knownAgentIds = resolveKnownAgentIds(cfg, defaultAgentId);
+    const allowedAgentIds = resolveAllowedAgentIds(cfg.hooks?.allowedAgentIds);
     return {
         basePath: trimmed,
         token,
         maxBodyBytes,
         mappings,
+        agentPolicy: {
+            defaultAgentId,
+            knownAgentIds,
+            allowedAgentIds,
+        },
     };
 }
+function resolveKnownAgentIds(cfg, defaultAgentId) {
+    const known = new Set(listAgentIds(cfg));
+    known.add(defaultAgentId);
+    return known;
+}
+function resolveAllowedAgentIds(raw) {
+    if (!Array.isArray(raw)) {
+        return undefined;
+    }
+    const allowed = new Set();
+    let hasWildcard = false;
+    for (const entry of raw) {
+        const trimmed = entry.trim();
+        if (!trimmed) {
+            continue;
+        }
+        if (trimmed === "*") {
+            hasWildcard = true;
+            break;
+        }
+        allowed.add(normalizeAgentId(trimmed));
+    }
+    if (hasWildcard) {
+        return undefined;
+    }
+    return allowed;
+}
 export function extractHookToken(req, url) {
     const auth = typeof req.headers.authorization === "string" ? req.headers.authorization.trim() : "";
     if (auth.toLowerCase().startsWith("bearer ")) {
@@ -120,12 +157,39 @@ export function resolveHookChannel(raw) {
 export function resolveHookDeliver(raw) {
     return raw !== false;
 }
+export function resolveHookTargetAgentId(hooksConfig, agentId) {
+    const raw = agentId?.trim();
+    if (!raw) {
+        return undefined;
+    }
+    const normalized = normalizeAgentId(raw);
+    if (hooksConfig.agentPolicy.knownAgentIds.has(normalized)) {
+        return normalized;
+    }
+    return hooksConfig.agentPolicy.defaultAgentId;
+}
+export function isHookAgentAllowed(hooksConfig, agentId) {
+    // Keep backwards compatibility for callers that omit agentId.
+    const raw = agentId?.trim();
+    if (!raw) {
+        return true;
+    }
+    const allowed = hooksConfig.agentPolicy.allowedAgentIds;
+    if (allowed === undefined) {
+        return true;
+    }
+    const resolved = resolveHookTargetAgentId(hooksConfig, raw);
+    return resolved ? allowed.has(resolved) : false;
+}
+export const getHookAgentPolicyError = () => "agentId is not allowed by hooks.allowedAgentIds";
 export function normalizeAgentPayload(payload, opts) {
     const message = typeof payload.message === "string" ? payload.message.trim() : "";
     if (!message)
         return { ok: false, error: "message required" };
     const nameRaw = payload.name;
     const name = typeof nameRaw === "string" && nameRaw.trim() ? nameRaw.trim() : "Hook";
+    const agentIdRaw = payload.agentId;
+    const agentId = typeof agentIdRaw === "string" && agentIdRaw.trim() ? agentIdRaw.trim() : undefined;
     const wakeMode = payload.wakeMode === "next-heartbeat" ? "next-heartbeat" : "now";
     const sessionKeyRaw = payload.sessionKey;
     const idFactory = opts?.idFactory ?? randomUUID;
@@ -154,6 +218,7 @@ export function normalizeAgentPayload(payload, opts) {
         value: {
             message,
             name,
+            agentId,
             wakeMode,
             sessionKey,
             deliver,

package/dist/gateway/net.js

@@ -1,83 +1,125 @@
 import net from "node:net";
+import os from "node:os";
 import { pickPrimaryTailnetIPv4, pickPrimaryTailnetIPv6 } from "../infra/tailnet.js";
+/**
+ * Pick the primary non-internal IPv4 address (LAN IP).
+ * Prefers common interface names (en0, eth0) then falls back to any external IPv4.
+ */
+export function pickPrimaryLanIPv4() {
+    const nets = os.networkInterfaces();
+    const preferredNames = ["en0", "eth0"];
+    for (const name of preferredNames) {
+        const list = nets[name];
+        const entry = list?.find((n) => n.family === "IPv4" && !n.internal);
+        if (entry?.address) {
+            return entry.address;
+        }
+    }
+    for (const list of Object.values(nets)) {
+        const entry = list?.find((n) => n.family === "IPv4" && !n.internal);
+        if (entry?.address) {
+            return entry.address;
+        }
+    }
+    return undefined;
+}
 export function isLoopbackAddress(ip) {
-    if (!ip)
+    if (!ip) {
         return false;
-    if (ip === "127.0.0.1")
+    }
+    if (ip === "127.0.0.1") {
         return true;
-    if (ip.startsWith("127."))
+    }
+    if (ip.startsWith("127.")) {
         return true;
-    if (ip === "::1")
+    }
+    if (ip === "::1") {
         return true;
-    if (ip.startsWith("::ffff:127."))
+    }
+    if (ip.startsWith("::ffff:127.")) {
         return true;
+    }
     return false;
 }
 function normalizeIPv4MappedAddress(ip) {
-    if (ip.startsWith("::ffff:"))
+    if (ip.startsWith("::ffff:")) {
         return ip.slice("::ffff:".length);
+    }
     return ip;
 }
 function normalizeIp(ip) {
     const trimmed = ip?.trim();
-    if (!trimmed)
+    if (!trimmed) {
         return undefined;
+    }
     return normalizeIPv4MappedAddress(trimmed.toLowerCase());
 }
 function stripOptionalPort(ip) {
     if (ip.startsWith("[")) {
         const end = ip.indexOf("]");
-        if (end !== -1)
+        if (end !== -1) {
             return ip.slice(1, end);
+        }
     }
-    if (net.isIP(ip))
+    if (net.isIP(ip)) {
         return ip;
+    }
     const lastColon = ip.lastIndexOf(":");
     if (lastColon > -1 && ip.includes(".") && ip.indexOf(":") === lastColon) {
         const candidate = ip.slice(0, lastColon);
-        if (net.isIP(candidate) === 4)
+        if (net.isIP(candidate) === 4) {
             return candidate;
+        }
     }
     return ip;
 }
 export function parseForwardedForClientIp(forwardedFor) {
     const raw = forwardedFor?.split(",")[0]?.trim();
-    if (!raw)
+    if (!raw) {
         return undefined;
+    }
     return normalizeIp(stripOptionalPort(raw));
 }
 function parseRealIp(realIp) {
     const raw = realIp?.trim();
-    if (!raw)
+    if (!raw) {
         return undefined;
+    }
     return normalizeIp(stripOptionalPort(raw));
 }
 export function isTrustedProxyAddress(ip, trustedProxies) {
     const normalized = normalizeIp(ip);
-    if (!normalized || !trustedProxies || trustedProxies.length === 0)
+    if (!normalized || !trustedProxies || trustedProxies.length === 0) {
         return false;
+    }
     return trustedProxies.some((proxy) => normalizeIp(proxy) === normalized);
 }
 export function resolveGatewayClientIp(params) {
     const remote = normalizeIp(params.remoteAddr);
-    if (!remote)
+    if (!remote) {
         return undefined;
-    if (!isTrustedProxyAddress(remote, params.trustedProxies))
+    }
+    if (!isTrustedProxyAddress(remote, params.trustedProxies)) {
         return remote;
+    }
     return parseForwardedForClientIp(params.forwardedFor) ?? parseRealIp(params.realIp) ?? remote;
 }
 export function isLocalGatewayAddress(ip) {
-    if (isLoopbackAddress(ip))
+    if (isLoopbackAddress(ip)) {
         return true;
-    if (!ip)
+    }
+    if (!ip) {
         return false;
+    }
     const normalized = normalizeIPv4MappedAddress(ip.trim().toLowerCase());
     const tailnetIPv4 = pickPrimaryTailnetIPv4();
-    if (tailnetIPv4 && normalized === tailnetIPv4.toLowerCase())
+    if (tailnetIPv4 && normalized === tailnetIPv4.toLowerCase()) {
         return true;
+    }
     const tailnetIPv6 = pickPrimaryTailnetIPv6();
-    if (tailnetIPv6 && ip.trim().toLowerCase() === tailnetIPv6.toLowerCase())
+    if (tailnetIPv6 && ip.trim().toLowerCase() === tailnetIPv6.toLowerCase()) {
         return true;
+    }
     return false;
 }
 /**
@@ -96,16 +138,19 @@ export async function resolveGatewayBindHost(bind, customHost) {
     const mode = bind ?? "loopback";
     if (mode === "loopback") {
         // 127.0.0.1 rarely fails, but handle gracefully
-        if (await canBindToHost("127.0.0.1"))
+        if (await canBindToHost("127.0.0.1")) {
             return "127.0.0.1";
+        }
         return "0.0.0.0"; // extreme fallback
     }
     if (mode === "tailnet") {
         const tailnetIP = pickPrimaryTailnetIPv4();
-        if (tailnetIP && (await canBindToHost(tailnetIP)))
+        if (tailnetIP && (await canBindToHost(tailnetIP))) {
             return tailnetIP;
-        if (await canBindToHost("127.0.0.1"))
+        }
+        if (await canBindToHost("127.0.0.1")) {
             return "127.0.0.1";
+        }
         return "0.0.0.0";
     }
     if (mode === "lan") {
@@ -113,16 +158,19 @@ export async function resolveGatewayBindHost(bind, customHost) {
     }
     if (mode === "custom") {
         const host = customHost?.trim();
-        if (!host)
-            return "0.0.0.0"; // invalid config → fall back to all
-        if (isValidIPv4(host) && (await canBindToHost(host)))
+        if (!host) {
+            return "0.0.0.0";
+        } // invalid config → fall back to all
+        if (isValidIPv4(host) && (await canBindToHost(host))) {
             return host;
+        }
         // Custom IP failed → fall back to LAN
         return "0.0.0.0";
     }
     if (mode === "auto") {
-        if (await canBindToHost("127.0.0.1"))
+        if (await canBindToHost("127.0.0.1")) {
             return "127.0.0.1";
+        }
         return "0.0.0.0";
     }
     return "0.0.0.0";
@@ -149,11 +197,13 @@ export async function canBindToHost(host) {
     });
 }
 export async function resolveGatewayListenHosts(bindHost, opts) {
-    if (bindHost !== "127.0.0.1")
+    if (bindHost !== "127.0.0.1") {
         return [bindHost];
+    }
     const canBind = opts?.canBindToHost ?? canBindToHost;
-    if (await canBind("::1"))
+    if (await canBind("::1")) {
         return [bindHost, "::1"];
+    }
     return [bindHost];
 }
 /**
@@ -162,15 +212,30 @@ export async function resolveGatewayListenHosts(bindHost, opts) {
  * @param host - The string to validate
  * @returns True if valid IPv4 format
  */
-function isValidIPv4(host) {
+export function isValidIPv4(host) {
     const parts = host.split(".");
-    if (parts.length !== 4)
+    if (parts.length !== 4) {
         return false;
+    }
     return parts.every((part) => {
         const n = parseInt(part, 10);
         return !Number.isNaN(n) && n >= 0 && n <= 255 && part === String(n);
     });
 }
+/**
+ * Check if a hostname or IP refers to the local machine.
+ * Handles: localhost, 127.x.x.x, ::1, [::1], ::ffff:127.x.x.x
+ * Note: 0.0.0.0 and :: are NOT loopback - they bind to all interfaces.
+ */
 export function isLoopbackHost(host) {
-    return isLoopbackAddress(host);
+    if (!host) {
+        return false;
+    }
+    const h = host.trim().toLowerCase();
+    if (h === "localhost") {
+        return true;
+    }
+    // Handle bracketed IPv6 addresses like [::1]
+    const unbracket = h.startsWith("[") && h.endsWith("]") ? h.slice(1, -1) : h;
+    return isLoopbackAddress(unbracket);
 }

package/dist/gateway/node-command-policy.js

@@ -8,10 +8,22 @@ const CANVAS_COMMANDS = [
     "canvas.a2ui.pushJSONL",
     "canvas.a2ui.reset",
 ];
-const CAMERA_COMMANDS = ["camera.list", "camera.snap", "camera.clip"];
-const SCREEN_COMMANDS = ["screen.record"];
+const CAMERA_COMMANDS = ["camera.list"];
+const CAMERA_DANGEROUS_COMMANDS = ["camera.snap", "camera.clip"];
+const SCREEN_DANGEROUS_COMMANDS = ["screen.record"];
 const LOCATION_COMMANDS = ["location.get"];
-const SMS_COMMANDS = ["sms.send"];
+const DEVICE_COMMANDS = ["device.info", "device.status"];
+const CONTACTS_COMMANDS = ["contacts.search"];
+const CONTACTS_DANGEROUS_COMMANDS = ["contacts.add"];
+const CALENDAR_COMMANDS = ["calendar.events"];
+const CALENDAR_DANGEROUS_COMMANDS = ["calendar.add"];
+const REMINDERS_COMMANDS = ["reminders.list"];
+const REMINDERS_DANGEROUS_COMMANDS = ["reminders.add"];
+const PHOTOS_COMMANDS = ["photos.latest"];
+const MOTION_COMMANDS = ["motion.activity", "motion.pedometer"];
+const SMS_DANGEROUS_COMMANDS = ["sms.send"];
+// iOS nodes don't implement system.run/which, but they do support notifications.
+const IOS_SYSTEM_COMMANDS = ["system.notify"];
 const SYSTEM_COMMANDS = [
     "system.run",
     "system.which",
@@ -20,32 +32,55 @@ const SYSTEM_COMMANDS = [
     "system.execApprovals.set",
     "browser.proxy",
 ];
+// "High risk" node commands. These can be enabled by explicitly adding them to
+// `gateway.nodes.allowCommands` (and ensuring they're not blocked by denyCommands).
+export const DEFAULT_DANGEROUS_NODE_COMMANDS = [
+    ...CAMERA_DANGEROUS_COMMANDS,
+    ...SCREEN_DANGEROUS_COMMANDS,
+    ...CONTACTS_DANGEROUS_COMMANDS,
+    ...CALENDAR_DANGEROUS_COMMANDS,
+    ...REMINDERS_DANGEROUS_COMMANDS,
+    ...SMS_DANGEROUS_COMMANDS,
+];
 const PLATFORM_DEFAULTS = {
-    ios: [...CANVAS_COMMANDS, ...CAMERA_COMMANDS, ...SCREEN_COMMANDS, ...LOCATION_COMMANDS],
-    android: [
+    ios: [
         ...CANVAS_COMMANDS,
         ...CAMERA_COMMANDS,
-        ...SCREEN_COMMANDS,
         ...LOCATION_COMMANDS,
-        ...SMS_COMMANDS,
+        ...DEVICE_COMMANDS,
+        ...CONTACTS_COMMANDS,
+        ...CALENDAR_COMMANDS,
+        ...REMINDERS_COMMANDS,
+        ...PHOTOS_COMMANDS,
+        ...MOTION_COMMANDS,
+        ...IOS_SYSTEM_COMMANDS,
     ],
-    macos: [
+    android: [
         ...CANVAS_COMMANDS,
         ...CAMERA_COMMANDS,
-        ...SCREEN_COMMANDS,
         ...LOCATION_COMMANDS,
-        ...SYSTEM_COMMANDS,
+        ...DEVICE_COMMANDS,
+        ...CONTACTS_COMMANDS,
+        ...CALENDAR_COMMANDS,
+        ...REMINDERS_COMMANDS,
+        ...PHOTOS_COMMANDS,
+        ...MOTION_COMMANDS,
     ],
-    linux: [...SYSTEM_COMMANDS],
-    windows: [...SYSTEM_COMMANDS],
-    unknown: [
+    macos: [
         ...CANVAS_COMMANDS,
         ...CAMERA_COMMANDS,
-        ...SCREEN_COMMANDS,
         ...LOCATION_COMMANDS,
-        ...SMS_COMMANDS,
+        ...DEVICE_COMMANDS,
+        ...CONTACTS_COMMANDS,
+        ...CALENDAR_COMMANDS,
+        ...REMINDERS_COMMANDS,
+        ...PHOTOS_COMMANDS,
+        ...MOTION_COMMANDS,
         ...SYSTEM_COMMANDS,
     ],
+    linux: [...SYSTEM_COMMANDS],
+    windows: [...SYSTEM_COMMANDS],
+    unknown: [...CANVAS_COMMANDS, ...CAMERA_COMMANDS, ...LOCATION_COMMANDS, ...SYSTEM_COMMANDS],
 };
 function normalizePlatformId(platform, deviceFamily) {
     const raw = (platform ?? "").trim().toLowerCase();

package/dist/gateway/origin-check.js

@@ -0,0 +1,56 @@
+import { isLoopbackHost } from "./net.js";
+function normalizeHostHeader(hostHeader) {
+    return (hostHeader ?? "").trim().toLowerCase();
+}
+function resolveHostName(hostHeader) {
+    const host = normalizeHostHeader(hostHeader);
+    if (!host) {
+        return "";
+    }
+    if (host.startsWith("[")) {
+        const end = host.indexOf("]");
+        if (end !== -1) {
+            return host.slice(1, end);
+        }
+    }
+    const [name] = host.split(":");
+    return name ?? "";
+}
+function parseOrigin(originRaw) {
+    const trimmed = (originRaw ?? "").trim();
+    if (!trimmed || trimmed === "null") {
+        return null;
+    }
+    try {
+        const url = new URL(trimmed);
+        return {
+            origin: url.origin.toLowerCase(),
+            host: url.host.toLowerCase(),
+            hostname: url.hostname.toLowerCase(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function checkBrowserOrigin(params) {
+    const parsedOrigin = parseOrigin(params.origin);
+    if (!parsedOrigin) {
+        return { ok: false, reason: "origin missing or invalid" };
+    }
+    const allowlist = (params.allowedOrigins ?? [])
+        .map((value) => value.trim().toLowerCase())
+        .filter(Boolean);
+    if (allowlist.includes(parsedOrigin.origin)) {
+        return { ok: true };
+    }
+    const requestHost = normalizeHostHeader(params.requestHost);
+    if (requestHost && parsedOrigin.host === requestHost) {
+        return { ok: true };
+    }
+    const requestHostname = resolveHostName(requestHost);
+    if (isLoopbackHost(parsedOrigin.hostname) && isLoopbackHost(requestHostname)) {
+        return { ok: true };
+    }
+    return { ok: false, reason: "origin not allowed" };
+}

package/dist/gateway/protocol/client-info.js

@@ -23,6 +23,9 @@ export const GATEWAY_CLIENT_MODES = {
     PROBE: "probe",
     TEST: "test",
 };
+export const GATEWAY_CLIENT_CAPS = {
+    TOOL_EVENTS: "tool-events",
+};
 const GATEWAY_CLIENT_ID_SET = new Set(Object.values(GATEWAY_CLIENT_IDS));
 const GATEWAY_CLIENT_MODE_SET = new Set(Object.values(GATEWAY_CLIENT_MODES));
 export function normalizeGatewayClientId(raw) {
@@ -44,3 +47,9 @@ export function normalizeGatewayClientMode(raw) {
         ? normalized
         : undefined;
 }
+export function hasGatewayClientCap(caps, cap) {
+    if (!Array.isArray(caps)) {
+        return false;
+    }
+    return caps.includes(cap);
+}

package/dist/gateway/protocol/index.js

@@ -1,5 +1,5 @@
 import AjvPkg from "ajv";
-import { AgentEventSchema, AgentIdentityParamsSchema, AgentIdentityResultSchema, AgentParamsSchema, AgentSummarySchema, AgentsListParamsSchema, AgentsListResultSchema, AgentWaitParamsSchema, ChannelsLogoutParamsSchema, ChannelsStatusParamsSchema, ChannelsStatusResultSchema, ChatAbortParamsSchema, ChatEventSchema, ChatHistoryParamsSchema, ChatInjectParamsSchema, ChatSendParamsSchema, ConfigApplyParamsSchema, ConfigGetParamsSchema, ConfigPatchParamsSchema, ConfigSchemaParamsSchema, ConfigSchemaResponseSchema, ConfigSetParamsSchema, ConnectParamsSchema, CronAddParamsSchema, CronJobSchema, CronListParamsSchema, CronRemoveParamsSchema, CronRunParamsSchema, CronRunsParamsSchema, CronStatusParamsSchema, CronUpdateParamsSchema, DevicePairApproveParamsSchema, DevicePairListParamsSchema, DevicePairRejectParamsSchema, DeviceTokenRevokeParamsSchema, DeviceTokenRotateParamsSchema, ExecApprovalsGetParamsSchema, ExecApprovalsNodeGetParamsSchema, ExecApprovalsNodeSetParamsSchema, ExecApprovalsSetParamsSchema, ExecApprovalRequestParamsSchema, ExecApprovalResolveParamsSchema, ErrorCodes, ErrorShapeSchema, EventFrameSchema, errorShape, GatewayFrameSchema, HelloOkSchema, LogsTailParamsSchema, LogsTailResultSchema, ModelsListParamsSchema, NodeDescribeParamsSchema, NodeEventParamsSchema, NodeInvokeParamsSchema, NodeInvokeResultParamsSchema, NodeListParamsSchema, NodePairApproveParamsSchema, NodePairListParamsSchema, NodePairRejectParamsSchema, NodePairRequestParamsSchema, NodePairVerifyParamsSchema, NodeRenameParamsSchema, PollParamsSchema, PROTOCOL_VERSION, PresenceEntrySchema, ProtocolSchemas, RequestFrameSchema, ResponseFrameSchema, SendParamsSchema, SessionsCompactParamsSchema, SessionsDeleteParamsSchema, SessionsListParamsSchema, SessionsPatchParamsSchema, SessionsPreviewParamsSchema, SessionsResetParamsSchema, SessionsResolveParamsSchema, ShutdownEventSchema, SkillsBinsParamsSchema, SkillsInstallParamsSchema, SkillsStatusParamsSchema, SkillsUpdateParamsSchema, SnapshotSchema, StateVersionSchema, TalkModeParamsSchema, TickEventSchema, UpdateRunParamsSchema, WakeParamsSchema, WebLoginStartParamsSchema, WebLoginWaitParamsSchema, WizardCancelParamsSchema, WizardNextParamsSchema, WizardNextResultSchema, WizardStartParamsSchema, WizardStartResultSchema, WizardStatusParamsSchema, WizardStatusResultSchema, WizardStepSchema, } from "./schema.js";
+import { AgentEventSchema, AgentIdentityParamsSchema, AgentIdentityResultSchema, AgentParamsSchema, AgentSummarySchema, AgentsFileEntrySchema, AgentsCreateParamsSchema, AgentsCreateResultSchema, AgentsUpdateParamsSchema, AgentsUpdateResultSchema, AgentsDeleteParamsSchema, AgentsDeleteResultSchema, AgentsFilesGetParamsSchema, AgentsFilesGetResultSchema, AgentsFilesListParamsSchema, AgentsFilesListResultSchema, AgentsFilesSetParamsSchema, AgentsFilesSetResultSchema, AgentsListParamsSchema, AgentsListResultSchema, AgentWaitParamsSchema, ChannelsLogoutParamsSchema, ChannelsStatusParamsSchema, ChannelsStatusResultSchema, ChatAbortParamsSchema, ChatEventSchema, ChatHistoryParamsSchema, ChatInjectParamsSchema, ChatSendParamsSchema, ConfigApplyParamsSchema, ConfigGetParamsSchema, ConfigPatchParamsSchema, ConfigSchemaParamsSchema, ConfigSchemaResponseSchema, ConfigSetParamsSchema, ConnectParamsSchema, CronAddParamsSchema, CronJobSchema, CronListParamsSchema, CronRemoveParamsSchema, CronRunParamsSchema, CronRunsParamsSchema, CronStatusParamsSchema, CronUpdateParamsSchema, DevicePairApproveParamsSchema, DevicePairListParamsSchema, DevicePairRejectParamsSchema, DeviceTokenRevokeParamsSchema, DeviceTokenRotateParamsSchema, ExecApprovalsGetParamsSchema, ExecApprovalsNodeGetParamsSchema, ExecApprovalsNodeSetParamsSchema, ExecApprovalsSetParamsSchema, ExecApprovalRequestParamsSchema, ExecApprovalResolveParamsSchema, ErrorCodes, ErrorShapeSchema, EventFrameSchema, errorShape, GatewayFrameSchema, HelloOkSchema, LogsTailParamsSchema, LogsTailResultSchema, ModelsListParamsSchema, NodeDescribeParamsSchema, NodeEventParamsSchema, NodeInvokeParamsSchema, NodeInvokeResultParamsSchema, NodeListParamsSchema, NodePairApproveParamsSchema, NodePairListParamsSchema, NodePairRejectParamsSchema, NodePairRequestParamsSchema, NodePairVerifyParamsSchema, NodeRenameParamsSchema, PollParamsSchema, PROTOCOL_VERSION, PresenceEntrySchema, ProtocolSchemas, RequestFrameSchema, ResponseFrameSchema, SendParamsSchema, SessionsCompactParamsSchema, SessionsDeleteParamsSchema, SessionsListParamsSchema, SessionsPatchParamsSchema, SessionsPreviewParamsSchema, SessionsResetParamsSchema, SessionsResolveParamsSchema, SessionsUsageParamsSchema, ShutdownEventSchema, SkillsBinsParamsSchema, SkillsInstallParamsSchema, SkillsStatusParamsSchema, SkillsUpdateParamsSchema, SnapshotSchema, StateVersionSchema, TalkModeParamsSchema, TickEventSchema, UpdateRunParamsSchema, WakeParamsSchema, WebLoginStartParamsSchema, WebLoginWaitParamsSchema, WizardCancelParamsSchema, WizardNextParamsSchema, WizardNextResultSchema, WizardStartParamsSchema, WizardStartResultSchema, WizardStatusParamsSchema, WizardStatusResultSchema, WizardStepSchema, } from "./schema.js";
 const ajv = new AjvPkg({
     allErrors: true,
     strict: false,
@@ -16,6 +16,12 @@ export const validateAgentIdentityParams = ajv.compile(AgentIdentityParamsSchema
 export const validateAgentWaitParams = ajv.compile(AgentWaitParamsSchema);
 export const validateWakeParams = ajv.compile(WakeParamsSchema);
 export const validateAgentsListParams = ajv.compile(AgentsListParamsSchema);
+export const validateAgentsCreateParams = ajv.compile(AgentsCreateParamsSchema);
+export const validateAgentsUpdateParams = ajv.compile(AgentsUpdateParamsSchema);
+export const validateAgentsDeleteParams = ajv.compile(AgentsDeleteParamsSchema);
+export const validateAgentsFilesListParams = ajv.compile(AgentsFilesListParamsSchema);
+export const validateAgentsFilesGetParams = ajv.compile(AgentsFilesGetParamsSchema);
+export const validateAgentsFilesSetParams = ajv.compile(AgentsFilesSetParamsSchema);
 export const validateNodePairRequestParams = ajv.compile(NodePairRequestParamsSchema);
 export const validateNodePairListParams = ajv.compile(NodePairListParamsSchema);
 export const validateNodePairApproveParams = ajv.compile(NodePairApproveParamsSchema);
@@ -34,6 +40,7 @@ export const validateSessionsPatchParams = ajv.compile(SessionsPatchParamsSchema
 export const validateSessionsResetParams = ajv.compile(SessionsResetParamsSchema);
 export const validateSessionsDeleteParams = ajv.compile(SessionsDeleteParamsSchema);
 export const validateSessionsCompactParams = ajv.compile(SessionsCompactParamsSchema);
+export const validateSessionsUsageParams = ajv.compile(SessionsUsageParamsSchema);
 export const validateConfigGetParams = ajv.compile(ConfigGetParamsSchema);
 export const validateConfigSetParams = ajv.compile(ConfigSetParamsSchema);
 export const validateConfigApplyParams = ajv.compile(ConfigApplyParamsSchema);
@@ -106,4 +113,4 @@ export function formatValidationErrors(errors) {
     }
     return unique.join("; ");
 }
-export { ConnectParamsSchema, HelloOkSchema, RequestFrameSchema, ResponseFrameSchema, EventFrameSchema, GatewayFrameSchema, PresenceEntrySchema, SnapshotSchema, ErrorShapeSchema, StateVersionSchema, AgentEventSchema, ChatEventSchema, SendParamsSchema, PollParamsSchema, AgentParamsSchema, AgentIdentityParamsSchema, AgentIdentityResultSchema, WakeParamsSchema, NodePairRequestParamsSchema, NodePairListParamsSchema, NodePairApproveParamsSchema, NodePairRejectParamsSchema, NodePairVerifyParamsSchema, NodeListParamsSchema, NodeInvokeParamsSchema, SessionsListParamsSchema, SessionsPreviewParamsSchema, SessionsPatchParamsSchema, SessionsResetParamsSchema, SessionsDeleteParamsSchema, SessionsCompactParamsSchema, ConfigGetParamsSchema, ConfigSetParamsSchema, ConfigApplyParamsSchema, ConfigPatchParamsSchema, ConfigSchemaParamsSchema, ConfigSchemaResponseSchema, WizardStartParamsSchema, WizardNextParamsSchema, WizardCancelParamsSchema, WizardStatusParamsSchema, WizardStepSchema, WizardNextResultSchema, WizardStartResultSchema, WizardStatusResultSchema, ChannelsStatusParamsSchema, ChannelsStatusResultSchema, ChannelsLogoutParamsSchema, WebLoginStartParamsSchema, WebLoginWaitParamsSchema, AgentSummarySchema, AgentsListParamsSchema, AgentsListResultSchema, ModelsListParamsSchema, SkillsStatusParamsSchema, SkillsInstallParamsSchema, SkillsUpdateParamsSchema, CronJobSchema, CronListParamsSchema, CronStatusParamsSchema, CronAddParamsSchema, CronUpdateParamsSchema, CronRemoveParamsSchema, CronRunParamsSchema, CronRunsParamsSchema, LogsTailParamsSchema, LogsTailResultSchema, ChatHistoryParamsSchema, ChatSendParamsSchema, ChatInjectParamsSchema, UpdateRunParamsSchema, TickEventSchema, ShutdownEventSchema, ProtocolSchemas, PROTOCOL_VERSION, ErrorCodes, errorShape, };
+export { ConnectParamsSchema, HelloOkSchema, RequestFrameSchema, ResponseFrameSchema, EventFrameSchema, GatewayFrameSchema, PresenceEntrySchema, SnapshotSchema, ErrorShapeSchema, StateVersionSchema, AgentEventSchema, ChatEventSchema, SendParamsSchema, PollParamsSchema, AgentParamsSchema, AgentIdentityParamsSchema, AgentIdentityResultSchema, WakeParamsSchema, NodePairRequestParamsSchema, NodePairListParamsSchema, NodePairApproveParamsSchema, NodePairRejectParamsSchema, NodePairVerifyParamsSchema, NodeListParamsSchema, NodeInvokeParamsSchema, SessionsListParamsSchema, SessionsPreviewParamsSchema, SessionsPatchParamsSchema, SessionsResetParamsSchema, SessionsDeleteParamsSchema, SessionsCompactParamsSchema, SessionsUsageParamsSchema, ConfigGetParamsSchema, ConfigSetParamsSchema, ConfigApplyParamsSchema, ConfigPatchParamsSchema, ConfigSchemaParamsSchema, ConfigSchemaResponseSchema, WizardStartParamsSchema, WizardNextParamsSchema, WizardCancelParamsSchema, WizardStatusParamsSchema, WizardStepSchema, WizardNextResultSchema, WizardStartResultSchema, WizardStatusResultSchema, ChannelsStatusParamsSchema, ChannelsStatusResultSchema, ChannelsLogoutParamsSchema, WebLoginStartParamsSchema, WebLoginWaitParamsSchema, AgentSummarySchema, AgentsListParamsSchema, AgentsListResultSchema, AgentsFileEntrySchema, AgentsCreateParamsSchema, AgentsCreateResultSchema, AgentsUpdateParamsSchema, AgentsUpdateResultSchema, AgentsDeleteParamsSchema, AgentsDeleteResultSchema, AgentsFilesListParamsSchema, AgentsFilesListResultSchema, AgentsFilesGetParamsSchema, AgentsFilesGetResultSchema, AgentsFilesSetParamsSchema, AgentsFilesSetResultSchema, ModelsListParamsSchema, SkillsStatusParamsSchema, SkillsInstallParamsSchema, SkillsUpdateParamsSchema, CronJobSchema, CronListParamsSchema, CronStatusParamsSchema, CronAddParamsSchema, CronUpdateParamsSchema, CronRemoveParamsSchema, CronRunParamsSchema, CronRunsParamsSchema, LogsTailParamsSchema, LogsTailResultSchema, ChatHistoryParamsSchema, ChatSendParamsSchema, ChatInjectParamsSchema, UpdateRunParamsSchema, TickEventSchema, ShutdownEventSchema, ProtocolSchemas, PROTOCOL_VERSION, ErrorCodes, errorShape, };