import { getChannelPlugin, normalizeChannelId } from "../channels/plugins/index.js"; import { truncateUtf16Safe } from "../utils.js"; import { type MessagingToolSend } from "./pi-embedded-messaging.js"; import { normalizeTargetForProvider } from "../infra/outbound/target-normalization.js"; const TOOL_RESULT_MAX_CHARS = 8000; const TOOL_ERROR_MAX_CHARS = 400; function truncateToolText(text: string): string { if (text.length <= TOOL_RESULT_MAX_CHARS) return text; return `${truncateUtf16Safe(text, TOOL_RESULT_MAX_CHARS)}\n…(truncated)…`; } function normalizeToolErrorText(text: string): string | undefined { const trimmed = text.trim(); if (!trimmed) return undefined; const firstLine = trimmed.split(/\r?\n/)[0]?.trim() ?? ""; if (!firstLine) return undefined; return firstLine.length > TOOL_ERROR_MAX_CHARS ? `${truncateUtf16Safe(firstLine, TOOL_ERROR_MAX_CHARS)}…` : firstLine; } function readErrorCandidate(value: unknown): string | undefined { if (typeof value === "string") return normalizeToolErrorText(value); if (!value || typeof value !== "object") return undefined; const record = value as Record; if (typeof record.message === "string") return normalizeToolErrorText(record.message); if (typeof record.error === "string") return normalizeToolErrorText(record.error); return undefined; } function extractErrorField(value: unknown): string | undefined { if (!value || typeof value !== "object") return undefined; const record = value as Record; const direct = readErrorCandidate(record.error) ?? readErrorCandidate(record.message) ?? readErrorCandidate(record.reason); if (direct) return direct; const status = typeof record.status === "string" ? record.status.trim() : ""; return status ? normalizeToolErrorText(status) : undefined; } export function sanitizeToolResult(result: unknown): unknown { if (!result || typeof result !== "object") return result; const record = result as Record; const content = Array.isArray(record.content) ? record.content : null; if (!content) return record; const sanitized = content.map((item) => { if (!item || typeof item !== "object") return item; const entry = item as Record; const type = typeof entry.type === "string" ? entry.type : undefined; if (type === "text" && typeof entry.text === "string") { return { ...entry, text: truncateToolText(entry.text) }; } if (type === "image") { const data = typeof entry.data === "string" ? entry.data : undefined; const bytes = data ? data.length : undefined; const cleaned = { ...entry }; delete cleaned.data; return { ...cleaned, bytes, omitted: true }; } return entry; }); return { ...record, content: sanitized }; } export function extractToolResultText(result: unknown): string | undefined { if (!result || typeof result !== "object") return undefined; const record = result as Record; const content = Array.isArray(record.content) ? record.content : null; if (!content) return undefined; const texts = content .map((item) => { if (!item || typeof item !== "object") return undefined; const entry = item as Record; if (entry.type !== "text" || typeof entry.text !== "string") return undefined; const trimmed = entry.text.trim(); return trimmed ? trimmed : undefined; }) .filter((value): value is string => Boolean(value)); if (texts.length === 0) return undefined; return texts.join("\n"); } export function isToolResultError(result: unknown): boolean { if (!result || typeof result !== "object") return false; const record = result as { details?: unknown }; const details = record.details; if (!details || typeof details !== "object") return false; const status = (details as { status?: unknown }).status; if (typeof status !== "string") return false; const normalized = status.trim().toLowerCase(); return normalized === "error" || normalized === "timeout"; } export function extractToolErrorMessage(result: unknown): string | undefined { if (!result || typeof result !== "object") return undefined; const record = result as Record; const fromDetails = extractErrorField(record.details); if (fromDetails) return fromDetails; const fromRoot = extractErrorField(record); if (fromRoot) return fromRoot; const text = extractToolResultText(result); if (!text) return undefined; try { const parsed = JSON.parse(text) as unknown; const fromJson = extractErrorField(parsed); if (fromJson) return fromJson; } catch { // Fall through to first-line text fallback. } return normalizeToolErrorText(text); } export function extractMessagingToolSend( toolName: string, args: Record, ): MessagingToolSend | undefined { // Provider docking: new provider tools must implement plugin.actions.extractToolSend. const action = typeof args.action === "string" ? args.action.trim() : ""; const accountIdRaw = typeof args.accountId === "string" ? args.accountId.trim() : undefined; const accountId = accountIdRaw ? accountIdRaw : undefined; if (toolName === "message") { if (action !== "send" && action !== "thread-reply") return undefined; const toRaw = typeof args.to === "string" ? args.to : undefined; if (!toRaw) return undefined; const providerRaw = typeof args.provider === "string" ? args.provider.trim() : ""; const channelRaw = typeof args.channel === "string" ? args.channel.trim() : ""; const providerHint = providerRaw || channelRaw; const providerId = providerHint ? normalizeChannelId(providerHint) : null; const provider = providerId ?? (providerHint ? providerHint.toLowerCase() : "message"); const to = normalizeTargetForProvider(provider, toRaw); return to ? { tool: toolName, provider, accountId, to } : undefined; } const providerId = normalizeChannelId(toolName); if (!providerId) return undefined; const plugin = getChannelPlugin(providerId); const extracted = plugin?.actions?.extractToolSend?.({ args }); if (!extracted?.to) return undefined; const to = normalizeTargetForProvider(providerId, extracted.to); return to ? { tool: toolName, provider: providerId, accountId: extracted.accountId ?? accountId, to, } : undefined; }