@poolzin/pool-bot 2026.2.24 → 2026.2.25

package/dist/infra/outbound/message-action-runner.js

@@ -1,55 +1,46 @@
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { readNumberParam, readStringArrayParam, readStringParam, } from "../../agents/tools/common.js";
 import { resolveSessionAgentId } from "../../agents/agent-scope.js";
+import { readNumberParam, readStringArrayParam, readStringParam, } from "../../agents/tools/common.js";
 import { parseReplyDirectives } from "../../auto-reply/reply/reply-directives.js";
 import { dispatchChannelMessageAction } from "../../channels/plugins/message-actions.js";
 import { isDeliverableMessageChannel, normalizeMessageChannel, } from "../../utils/message-channel.js";
+import { throwIfAborted } from "./abort.js";
 import { listConfiguredMessageChannels, resolveMessageChannelSelection, } from "./channel-selection.js";
 import { applyTargetToParams } from "./channel-target.js";
-import { ensureOutboundSessionEntry, resolveOutboundSessionRoute } from "./outbound-session.js";
+import { hydrateSendAttachmentParams, hydrateSetGroupIconParams, normalizeSandboxMediaList, normalizeSandboxMediaParams, parseButtonsParam, parseCardParam, parseComponentsParam, readBooleanParam, resolveSlackAutoThreadId, resolveTelegramAutoThreadId, } from "./message-action-params.js";
+import { actionHasTarget, actionRequiresTarget } from "./message-action-spec.js";
 import { applyCrossContextDecoration, buildCrossContextDecoration, enforceCrossContextPolicy, shouldApplyCrossContextMarker, } from "./outbound-policy.js";
 import { executePollAction, executeSendAction } from "./outbound-send-service.js";
-import { actionHasTarget, actionRequiresTarget } from "./message-action-spec.js";
+import { ensureOutboundSessionEntry, resolveOutboundSessionRoute } from "./outbound-session.js";
 import { resolveChannelTarget } from "./target-resolver.js";
-import { loadWebMedia } from "../../web/media.js";
-import { extensionForMime } from "../../media/mime.js";
-import { parseSlackTarget } from "../../slack/targets.js";
-import { parseTelegramTarget } from "../../telegram/targets.js";
-import { assertMediaNotDataUrl, resolveSandboxedMediaSource } from "../../agents/sandbox-paths.js";
-import { throwIfAborted } from "./abort.js";
-export function getToolResult(result) {
-    return "toolResult" in result ? result.toolResult : undefined;
-}
-function extractToolPayload(result) {
-    if (result.details !== undefined)
-        return result.details;
-    const textBlock = Array.isArray(result.content)
-        ? result.content.find((block) => block &&
-            typeof block === "object" &&
-            block.type === "text" &&
-            typeof block.text === "string")
+import { extractToolPayload } from "./tool-payload.js";
+function resolveAndApplyOutboundThreadId(params, ctx) {
+    const threadId = readStringParam(params, "threadId");
+    const slackAutoThreadId = ctx.allowSlackAutoThread && ctx.channel === "slack" && !threadId
+        ? resolveSlackAutoThreadId({ to: ctx.to, toolContext: ctx.toolContext })
         : undefined;
-    const text = textBlock?.text;
-    if (text) {
-        try {
-            return JSON.parse(text);
-        }
-        catch {
-            return text;
-        }
+    const telegramAutoThreadId = ctx.channel === "telegram" && !threadId
+        ? resolveTelegramAutoThreadId({ to: ctx.to, toolContext: ctx.toolContext })
+        : undefined;
+    const resolved = threadId ?? slackAutoThreadId ?? telegramAutoThreadId;
+    // Write auto-resolved threadId back into params so downstream dispatch
+    // (plugin `readStringParam(params, "threadId")`) picks it up.
+    if (resolved && !params.threadId) {
+        params.threadId = resolved;
     }
-    return result.content ?? result;
+    return resolved ?? undefined;
+}
+export function getToolResult(result) {
+    return "toolResult" in result ? result.toolResult : undefined;
 }
-function applyCrossContextMessageDecoration({ params, message, decoration, preferEmbeds, }) {
+function applyCrossContextMessageDecoration({ params, message, decoration, preferComponents, }) {
     const applied = applyCrossContextDecoration({
         message,
         decoration,
-        preferEmbeds,
+        preferComponents,
     });
     params.message = applied.message;
-    if (applied.embeds?.length) {
-        params.embeds = applied.embeds;
+    if (applied.componentsBuilder) {
+        params.components = applied.componentsBuilder;
     }
     return applied.message;
 }
@@ -64,279 +55,16 @@ async function maybeApplyCrossContextMarker(params) {
         toolContext: params.toolContext,
         accountId: params.accountId ?? undefined,
     });
-    if (!decoration)
+    if (!decoration) {
         return params.message;
+    }
     return applyCrossContextMessageDecoration({
         params: params.args,
         message: params.message,
         decoration,
-        preferEmbeds: params.preferEmbeds,
+        preferComponents: params.preferComponents,
     });
 }
-function readBooleanParam(params, key) {
-    const raw = params[key];
-    if (typeof raw === "boolean")
-        return raw;
-    if (typeof raw === "string") {
-        const trimmed = raw.trim().toLowerCase();
-        if (trimmed === "true")
-            return true;
-        if (trimmed === "false")
-            return false;
-    }
-    return undefined;
-}
-function resolveSlackAutoThreadId(params) {
-    const context = params.toolContext;
-    if (!context?.currentThreadTs || !context.currentChannelId)
-        return undefined;
-    // Only mirror auto-threading when Slack would reply in the active thread for this channel.
-    if (context.replyToMode !== "all" && context.replyToMode !== "first")
-        return undefined;
-    const parsedTarget = parseSlackTarget(params.to, { defaultKind: "channel" });
-    if (!parsedTarget || parsedTarget.kind !== "channel")
-        return undefined;
-    if (parsedTarget.id.toLowerCase() !== context.currentChannelId.toLowerCase())
-        return undefined;
-    if (context.replyToMode === "first" && context.hasRepliedRef?.value)
-        return undefined;
-    return context.currentThreadTs;
-}
-/**
- * Auto-inject Telegram forum topic thread ID when the message tool targets
- * the same chat the session originated from.
- */
-function resolveTelegramAutoThreadId(params) {
-    const context = params.toolContext;
-    if (!context?.currentThreadTs || !context.currentChannelId)
-        return undefined;
-    const parsedTo = parseTelegramTarget(params.to);
-    const parsedChannel = parseTelegramTarget(context.currentChannelId);
-    if (parsedTo.chatId.toLowerCase() !== parsedChannel.chatId.toLowerCase())
-        return undefined;
-    return context.currentThreadTs;
-}
-function resolveAttachmentMaxBytes(params) {
-    const accountId = typeof params.accountId === "string" ? params.accountId.trim() : "";
-    const channelCfg = params.cfg.channels?.[params.channel];
-    const channelObj = channelCfg && typeof channelCfg === "object"
-        ? channelCfg
-        : undefined;
-    const channelMediaMax = typeof channelObj?.mediaMaxMb === "number" ? channelObj.mediaMaxMb : undefined;
-    const accountsObj = channelObj?.accounts && typeof channelObj.accounts === "object"
-        ? channelObj.accounts
-        : undefined;
-    const accountCfg = accountId && accountsObj ? accountsObj[accountId] : undefined;
-    const accountMediaMax = accountCfg && typeof accountCfg === "object"
-        ? accountCfg.mediaMaxMb
-        : undefined;
-    const limitMb = (typeof accountMediaMax === "number" ? accountMediaMax : undefined) ??
-        channelMediaMax ??
-        params.cfg.agents?.defaults?.mediaMaxMb;
-    return typeof limitMb === "number" ? limitMb * 1024 * 1024 : undefined;
-}
-function inferAttachmentFilename(params) {
-    const mediaHint = params.mediaHint?.trim();
-    if (mediaHint) {
-        try {
-            if (mediaHint.startsWith("file://")) {
-                const filePath = fileURLToPath(mediaHint);
-                const base = path.basename(filePath);
-                if (base)
-                    return base;
-            }
-            else if (/^https?:\/\//i.test(mediaHint)) {
-                const url = new URL(mediaHint);
-                const base = path.basename(url.pathname);
-                if (base)
-                    return base;
-            }
-            else {
-                const base = path.basename(mediaHint);
-                if (base)
-                    return base;
-            }
-        }
-        catch {
-            // fall through to content-type based default
-        }
-    }
-    const ext = params.contentType ? extensionForMime(params.contentType) : undefined;
-    return ext ? `attachment${ext}` : "attachment";
-}
-function normalizeBase64Payload(params) {
-    if (!params.base64)
-        return { base64: params.base64, contentType: params.contentType };
-    const match = /^data:([^;]+);base64,(.*)$/i.exec(params.base64.trim());
-    if (!match)
-        return { base64: params.base64, contentType: params.contentType };
-    const [, mime, payload] = match;
-    return {
-        base64: payload,
-        contentType: params.contentType ?? mime,
-    };
-}
-async function normalizeSandboxMediaParams(params) {
-    const sandboxRoot = params.sandboxRoot?.trim();
-    const mediaKeys = ["media", "path", "filePath"];
-    for (const key of mediaKeys) {
-        const raw = readStringParam(params.args, key, { trim: false });
-        if (!raw)
-            continue;
-        assertMediaNotDataUrl(raw);
-        if (!sandboxRoot)
-            continue;
-        const normalized = await resolveSandboxedMediaSource({ media: raw, sandboxRoot });
-        if (normalized !== raw) {
-            params.args[key] = normalized;
-        }
-    }
-}
-async function normalizeSandboxMediaList(params) {
-    const sandboxRoot = params.sandboxRoot?.trim();
-    const normalized = [];
-    const seen = new Set();
-    for (const value of params.values) {
-        const raw = value?.trim();
-        if (!raw)
-            continue;
-        assertMediaNotDataUrl(raw);
-        const resolved = sandboxRoot
-            ? await resolveSandboxedMediaSource({ media: raw, sandboxRoot })
-            : raw;
-        if (seen.has(resolved))
-            continue;
-        seen.add(resolved);
-        normalized.push(resolved);
-    }
-    return normalized;
-}
-async function hydrateSetGroupIconParams(params) {
-    if (params.action !== "setGroupIcon")
-        return;
-    const mediaHint = readStringParam(params.args, "media", { trim: false });
-    const fileHint = readStringParam(params.args, "path", { trim: false }) ??
-        readStringParam(params.args, "filePath", { trim: false });
-    const contentTypeParam = readStringParam(params.args, "contentType") ?? readStringParam(params.args, "mimeType");
-    const rawBuffer = readStringParam(params.args, "buffer", { trim: false });
-    const normalized = normalizeBase64Payload({
-        base64: rawBuffer,
-        contentType: contentTypeParam ?? undefined,
-    });
-    if (normalized.base64 !== rawBuffer && normalized.base64) {
-        params.args.buffer = normalized.base64;
-        if (normalized.contentType && !contentTypeParam) {
-            params.args.contentType = normalized.contentType;
-        }
-    }
-    const filename = readStringParam(params.args, "filename");
-    const mediaSource = mediaHint ?? fileHint;
-    if (!params.dryRun && !readStringParam(params.args, "buffer", { trim: false }) && mediaSource) {
-        const maxBytes = resolveAttachmentMaxBytes({
-            cfg: params.cfg,
-            channel: params.channel,
-            accountId: params.accountId,
-        });
-        const media = await loadWebMedia(mediaSource, maxBytes);
-        params.args.buffer = media.buffer.toString("base64");
-        if (!contentTypeParam && media.contentType) {
-            params.args.contentType = media.contentType;
-        }
-        if (!filename) {
-            params.args.filename = inferAttachmentFilename({
-                mediaHint: media.fileName ?? mediaSource,
-                contentType: media.contentType ?? contentTypeParam ?? undefined,
-            });
-        }
-    }
-    else if (!filename) {
-        params.args.filename = inferAttachmentFilename({
-            mediaHint: mediaSource,
-            contentType: contentTypeParam ?? undefined,
-        });
-    }
-}
-async function hydrateSendAttachmentParams(params) {
-    if (params.action !== "sendAttachment")
-        return;
-    const mediaHint = readStringParam(params.args, "media", { trim: false });
-    const fileHint = readStringParam(params.args, "path", { trim: false }) ??
-        readStringParam(params.args, "filePath", { trim: false });
-    const contentTypeParam = readStringParam(params.args, "contentType") ?? readStringParam(params.args, "mimeType");
-    const caption = readStringParam(params.args, "caption", { allowEmpty: true })?.trim();
-    const message = readStringParam(params.args, "message", { allowEmpty: true })?.trim();
-    if (!caption && message)
-        params.args.caption = message;
-    const rawBuffer = readStringParam(params.args, "buffer", { trim: false });
-    const normalized = normalizeBase64Payload({
-        base64: rawBuffer,
-        contentType: contentTypeParam ?? undefined,
-    });
-    if (normalized.base64 !== rawBuffer && normalized.base64) {
-        params.args.buffer = normalized.base64;
-        if (normalized.contentType && !contentTypeParam) {
-            params.args.contentType = normalized.contentType;
-        }
-    }
-    const filename = readStringParam(params.args, "filename");
-    const mediaSource = mediaHint ?? fileHint;
-    if (!params.dryRun && !readStringParam(params.args, "buffer", { trim: false }) && mediaSource) {
-        const maxBytes = resolveAttachmentMaxBytes({
-            cfg: params.cfg,
-            channel: params.channel,
-            accountId: params.accountId,
-        });
-        const media = await loadWebMedia(mediaSource, maxBytes);
-        params.args.buffer = media.buffer.toString("base64");
-        if (!contentTypeParam && media.contentType) {
-            params.args.contentType = media.contentType;
-        }
-        if (!filename) {
-            params.args.filename = inferAttachmentFilename({
-                mediaHint: media.fileName ?? mediaSource,
-                contentType: media.contentType ?? contentTypeParam ?? undefined,
-            });
-        }
-    }
-    else if (!filename) {
-        params.args.filename = inferAttachmentFilename({
-            mediaHint: mediaSource,
-            contentType: contentTypeParam ?? undefined,
-        });
-    }
-}
-function parseButtonsParam(params) {
-    const raw = params.buttons;
-    if (typeof raw !== "string")
-        return;
-    const trimmed = raw.trim();
-    if (!trimmed) {
-        delete params.buttons;
-        return;
-    }
-    try {
-        params.buttons = JSON.parse(trimmed);
-    }
-    catch {
-        throw new Error("--buttons must be valid JSON");
-    }
-}
-function parseCardParam(params) {
-    const raw = params.card;
-    if (typeof raw !== "string")
-        return;
-    const trimmed = raw.trim();
-    if (!trimmed) {
-        delete params.card;
-        return;
-    }
-    try {
-        params.card = JSON.parse(trimmed);
-    }
-    catch {
-        throw new Error("--card must be valid JSON");
-    }
-}
 async function resolveChannel(cfg, params) {
     const channelHint = readStringParam(params, "channel");
     const selection = await resolveMessageChannelSelection({
@@ -385,8 +113,9 @@ async function resolveActionTarget(params) {
     return resolvedTarget;
 }
 function resolveGateway(input) {
-    if (!input.gateway)
+    if (!input.gateway) {
         return undefined;
+    }
     return {
         url: input.gateway.url,
         token: input.gateway.token,
@@ -426,8 +155,9 @@ async function handleBroadcastAction(input, params) {
                     channel: targetChannel,
                     input: target,
                 });
-                if (!resolved.ok)
+                if (!resolved.ok) {
                     throw resolved.error;
+                }
                 const sendResult = await runMessageAction({
                     ...input,
                     action: "send",
@@ -445,8 +175,9 @@ async function handleBroadcastAction(input, params) {
                 });
             }
             catch (err) {
-                if (isAbortError(err))
+                if (isAbortError(err)) {
                     throw err;
+                }
                 results.push({
                     channel: targetChannel,
                     to: target,
@@ -458,7 +189,7 @@ async function handleBroadcastAction(input, params) {
     }
     return {
         kind: "broadcast",
-        channel: (targetChannels[0] ?? "discord"),
+        channel: targetChannels[0] ?? "discord",
         action: "broadcast",
         handledBy: input.dryRun ? "dry-run" : "core",
         payload: { results },
@@ -475,31 +206,37 @@ async function handleSendAction(ctx) {
         readStringParam(params, "path", { trim: false }) ??
         readStringParam(params, "filePath", { trim: false });
     const hasCard = params.card != null && typeof params.card === "object";
+    const hasComponents = params.components != null && typeof params.components === "object";
+    const caption = readStringParam(params, "caption", { allowEmpty: true }) ?? "";
     let message = readStringParam(params, "message", {
-        required: !mediaHint && !hasCard,
+        required: !mediaHint && !hasCard && !hasComponents,
         allowEmpty: true,
     }) ?? "";
-    // Unescape literal \\n sequences that models sometimes emit in tool arguments.
     if (message.includes("\\n")) {
         message = message.replaceAll("\\n", "\n");
     }
+    if (!message.trim() && caption.trim()) {
+        message = caption;
+    }
     const parsed = parseReplyDirectives(message);
     const mergedMediaUrls = [];
     const seenMedia = new Set();
     const pushMedia = (value) => {
         const trimmed = value?.trim();
-        if (!trimmed)
+        if (!trimmed) {
             return;
-        if (seenMedia.has(trimmed))
+        }
+        if (seenMedia.has(trimmed)) {
             return;
+        }
         seenMedia.add(trimmed);
         mergedMediaUrls.push(trimmed);
     };
     pushMedia(mediaHint);
-    for (const url of parsed.mediaUrls ?? [])
+    for (const url of parsed.mediaUrls ?? []) {
         pushMedia(url);
+    }
     pushMedia(parsed.mediaUrl);
-    // Sandbox-validate and deduplicate media URLs.
     const normalizedMediaUrls = await normalizeSandboxMediaList({
         values: mergedMediaUrls,
         sandboxRoot: input.sandboxRoot,
@@ -508,8 +245,9 @@ async function handleSendAction(ctx) {
     mergedMediaUrls.push(...normalizedMediaUrls);
     message = parsed.text;
     params.message = message;
-    if (!params.replyTo && parsed.replyToId)
+    if (!params.replyTo && parsed.replyToId) {
         params.replyTo = parsed.replyToId;
+    }
     if (!params.media) {
         // Use path/filePath if media not set, then fall back to parsed directives
         params.media = mergedMediaUrls[0] || undefined;
@@ -523,25 +261,29 @@ async function handleSendAction(ctx) {
         accountId,
         args: params,
         message,
-        preferEmbeds: true,
+        preferComponents: true,
     });
     const mediaUrl = readStringParam(params, "media", { trim: false });
+    if (channel === "whatsapp") {
+        message = message.replace(/^(?:[ \t]*\r?\n)+/, "");
+        if (!message.trim()) {
+            message = "";
+        }
+    }
+    if (!message.trim() && !mediaUrl && mergedMediaUrls.length === 0 && !hasCard && !hasComponents) {
+        throw new Error("send requires text or media");
+    }
+    params.message = message;
     const gifPlayback = readBooleanParam(params, "gifPlayback") ?? false;
     const bestEffort = readBooleanParam(params, "bestEffort");
+    const silent = readBooleanParam(params, "silent");
     const replyToId = readStringParam(params, "replyTo");
-    const threadId = readStringParam(params, "threadId");
-    // Slack auto-threading can inject threadTs without explicit params; mirror to that session key.
-    const slackAutoThreadId = channel === "slack" && !replyToId && !threadId
-        ? resolveSlackAutoThreadId({ to, toolContext: input.toolContext })
-        : undefined;
-    // Telegram forum topic auto-threading
-    const telegramAutoThreadId = channel === "telegram" && !threadId
-        ? resolveTelegramAutoThreadId({ to, toolContext: input.toolContext })
-        : undefined;
-    const resolvedThreadId = threadId ?? slackAutoThreadId ?? telegramAutoThreadId;
-    if (resolvedThreadId && !params.threadId) {
-        params.threadId = resolvedThreadId;
-    }
+    const resolvedThreadId = resolveAndApplyOutboundThreadId(params, {
+        channel,
+        to,
+        toolContext: input.toolContext,
+        allowSlackAutoThread: channel === "slack" && !replyToId,
+    });
     const outboundRoute = agentId && !dryRun
         ? await resolveOutboundSessionRoute({
             cfg,
@@ -563,6 +305,12 @@ async function handleSendAction(ctx) {
             route: outboundRoute,
         });
     }
+    if (outboundRoute && !dryRun) {
+        params.__sessionKey = outboundRoute.sessionKey;
+    }
+    if (agentId) {
+        params.__agentId = agentId;
+    }
     const mirrorMediaUrls = mergedMediaUrls.length > 0 ? mergedMediaUrls : mediaUrl ? [mediaUrl] : undefined;
     throwIfAborted(abortSignal);
     const send = await executeSendAction({
@@ -570,6 +318,7 @@ async function handleSendAction(ctx) {
             cfg,
             channel,
             params,
+            agentId,
             accountId: accountId ?? undefined,
             gateway,
             toolContext: input.toolContext,
@@ -584,6 +333,7 @@ async function handleSendAction(ctx) {
                 }
                 : undefined,
             abortSignal,
+            silent: silent ?? undefined,
         },
         to,
         message,
@@ -591,6 +341,8 @@ async function handleSendAction(ctx) {
         mediaUrls: mergedMediaUrls.length ? mergedMediaUrls : undefined,
         gifPlayback,
         bestEffort: bestEffort ?? undefined,
+        replyToId: replyToId ?? undefined,
+        threadId: resolvedThreadId ?? undefined,
     });
     return {
         kind: "send",
@@ -616,11 +368,33 @@ async function handlePollAction(ctx) {
     if (options.length < 2) {
         throw new Error("pollOption requires at least two values");
     }
+    const silent = readBooleanParam(params, "silent");
     const allowMultiselect = readBooleanParam(params, "pollMulti") ?? false;
+    const pollAnonymous = readBooleanParam(params, "pollAnonymous");
+    const pollPublic = readBooleanParam(params, "pollPublic");
+    if (pollAnonymous && pollPublic) {
+        throw new Error("pollAnonymous and pollPublic are mutually exclusive");
+    }
+    const isAnonymous = pollAnonymous ? true : pollPublic ? false : undefined;
     const durationHours = readNumberParam(params, "pollDurationHours", {
         integer: true,
     });
+    const durationSeconds = readNumberParam(params, "pollDurationSeconds", {
+        integer: true,
+    });
     const maxSelections = allowMultiselect ? Math.max(2, options.length) : 1;
+    if (durationSeconds !== undefined && channel !== "telegram") {
+        throw new Error("pollDurationSeconds is only supported for Telegram polls");
+    }
+    if (isAnonymous !== undefined && channel !== "telegram") {
+        throw new Error("pollAnonymous/pollPublic are only supported for Telegram polls");
+    }
+    const resolvedThreadId = resolveAndApplyOutboundThreadId(params, {
+        channel,
+        to,
+        toolContext: input.toolContext,
+        allowSlackAutoThread: channel === "slack",
+    });
     const base = typeof params.message === "string" ? params.message : "";
     await maybeApplyCrossContextMarker({
         cfg,
@@ -631,7 +405,7 @@ async function handlePollAction(ctx) {
         accountId,
         args: params,
         message: base,
-        preferEmbeds: true,
+        preferComponents: false,
     });
     const poll = await executePollAction({
         ctx: {
@@ -642,12 +416,16 @@ async function handlePollAction(ctx) {
             gateway,
             toolContext: input.toolContext,
             dryRun,
+            silent: silent ?? undefined,
         },
         to,
         question,
         options,
         maxSelections,
+        durationSeconds: durationSeconds ?? undefined,
         durationHours: durationHours ?? undefined,
+        threadId: resolvedThreadId ?? undefined,
+        isAnonymous,
     });
     return {
         kind: "poll",
@@ -681,6 +459,7 @@ async function handlePluginAction(ctx) {
         cfg,
         params,
         accountId: accountId ?? undefined,
+        requesterSenderId: input.requesterSenderId ?? undefined,
         gateway,
         toolContext: input.toolContext,
         dryRun,
@@ -707,6 +486,7 @@ export async function runMessageAction(input) {
             : undefined);
     parseButtonsParam(params);
     parseCardParam(params);
+    parseComponentsParam(params);
     const action = input.action;
     if (action === "broadcast") {
         return handleBroadcastAction(input, params);