activeclaw 2026.2.12 → 2026.2.13

package/dist/{deliver-B1jsU2r7.js → deliver-LsxKETro.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-Cbj13DAv.js";
-import { A as logVerbose, C as getActivePluginRegistry, N as shouldLogVerbose } from "./subsystem-Bv7dGhES.js";
-import { b as resolveUserPath, l as escapeRegExp } from "./utils-BHPdZE4h.js";
-import { i as isMessagingToolDuplicate } from "./pi-embedded-helpers-CmftU5Zj.js";
+import { A as logVerbose, C as getActivePluginRegistry, N as shouldLogVerbose, t as createSubsystemLogger } from "./subsystem-BoExtIHo.js";
+import { b as resolveUserPath, l as escapeRegExp } from "./utils-Cd9QdCHh.js";
+import { i as isMessagingToolDuplicate } from "./pi-embedded-helpers-CMKLjW6X.js";
 import { c as normalizeAccountId$1 } from "./session-key-BWxPj0z_.js";
-import { i as loadConfig } from "./config-DH9TLUNc.js";
-import { r as normalizeChannelId, t as getChannelPlugin } from "./plugins-BL9lIXSA.js";
-import { V as getChannelDock, W as resolveSignalAccount, l as appendAssistantMessageToSessionTranscript, u as resolveMirroredTranscriptText } from "./sandbox-BW8Xnkw1.js";
-import { _ as maxBytesForKind, a as optimizeImageToPng, c as saveMediaBuffer, i as hasAlphaChannel, l as detectMime, n as convertHeicToJpeg, o as resizeToJpeg, u as extensionForMime, v as mediaKindFromMime } from "./routes-82Ywfho6.js";
-import { t as INTERNAL_MESSAGE_CHANNEL } from "./message-channel-0717wOz-.js";
-import { n as fetchRemoteMedia, r as fetchWithTimeout } from "./fetch-CqZP8jwB.js";
+import { i as loadConfig } from "./config-aFQssWKX.js";
+import { r as normalizeChannelId, t as getChannelPlugin } from "./plugins-X7d_tfTE.js";
+import { V as getChannelDock, W as resolveSignalAccount, l as appendAssistantMessageToSessionTranscript, u as resolveMirroredTranscriptText } from "./sandbox-Bhjnh1Xg.js";
+import { _ as maxBytesForKind, a as optimizeImageToPng, c as saveMediaBuffer, i as hasAlphaChannel, l as detectMime, n as convertHeicToJpeg, o as resizeToJpeg, u as extensionForMime, v as mediaKindFromMime } from "./routes-CmOI1hIH.js";
+import { t as INTERNAL_MESSAGE_CHANNEL } from "./message-channel-BLi2a6Yw.js";
+import { n as fetchRemoteMedia, r as fetchWithTimeout } from "./fetch-DmiOpALK.js";
 import { fileURLToPath } from "node:url";
 import os from "node:os";
 import path from "node:path";
@@ -26,6 +26,260 @@ function isSilentReplyText(text, token = SILENT_REPLY_TOKEN) {
 	return new RegExp(`\\b${escaped}\\b\\W*$`).test(text);
 }
 
+//#endregion
+//#region src/plugins/hooks.ts
+/**
+* Get hooks for a specific hook name, sorted by priority (higher first).
+*/
+function getHooksForName(registry, hookName) {
+	return registry.typedHooks.filter((h) => h.hookName === hookName).toSorted((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+}
+/**
+* Create a hook runner for a specific registry.
+*/
+function createHookRunner(registry, options = {}) {
+	const logger = options.logger;
+	const catchErrors = options.catchErrors ?? true;
+	/**
+	* Run a hook that doesn't return a value (fire-and-forget style).
+	* All handlers are executed in parallel for performance.
+	*/
+	async function runVoidHook(hookName, event, ctx) {
+		const hooks = getHooksForName(registry, hookName);
+		if (hooks.length === 0) return;
+		logger?.debug?.(`[hooks] running ${hookName} (${hooks.length} handlers)`);
+		const promises = hooks.map(async (hook) => {
+			try {
+				await hook.handler(event, ctx);
+			} catch (err) {
+				const msg = `[hooks] ${hookName} handler from ${hook.pluginId} failed: ${String(err)}`;
+				if (catchErrors) logger?.error(msg);
+				else throw new Error(msg, { cause: err });
+			}
+		});
+		await Promise.all(promises);
+	}
+	/**
+	* Run a hook that can return a modifying result.
+	* Handlers are executed sequentially in priority order, and results are merged.
+	*/
+	async function runModifyingHook(hookName, event, ctx, mergeResults) {
+		const hooks = getHooksForName(registry, hookName);
+		if (hooks.length === 0) return;
+		logger?.debug?.(`[hooks] running ${hookName} (${hooks.length} handlers, sequential)`);
+		let result;
+		for (const hook of hooks) try {
+			const handlerResult = await hook.handler(event, ctx);
+			if (handlerResult !== void 0 && handlerResult !== null) if (mergeResults && result !== void 0) result = mergeResults(result, handlerResult);
+			else result = handlerResult;
+		} catch (err) {
+			const msg = `[hooks] ${hookName} handler from ${hook.pluginId} failed: ${String(err)}`;
+			if (catchErrors) logger?.error(msg);
+			else throw new Error(msg, { cause: err });
+		}
+		return result;
+	}
+	/**
+	* Run before_agent_start hook.
+	* Allows plugins to inject context into the system prompt.
+	* Runs sequentially, merging systemPrompt and prependContext from all handlers.
+	*/
+	async function runBeforeAgentStart(event, ctx) {
+		return runModifyingHook("before_agent_start", event, ctx, (acc, next) => ({
+			systemPrompt: next.systemPrompt ?? acc?.systemPrompt,
+			prependContext: acc?.prependContext && next.prependContext ? `${acc.prependContext}\n\n${next.prependContext}` : next.prependContext ?? acc?.prependContext
+		}));
+	}
+	/**
+	* Run agent_end hook.
+	* Allows plugins to analyze completed conversations.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runAgentEnd(event, ctx) {
+		return runVoidHook("agent_end", event, ctx);
+	}
+	/**
+	* Run before_compaction hook.
+	*/
+	async function runBeforeCompaction(event, ctx) {
+		return runVoidHook("before_compaction", event, ctx);
+	}
+	/**
+	* Run after_compaction hook.
+	*/
+	async function runAfterCompaction(event, ctx) {
+		return runVoidHook("after_compaction", event, ctx);
+	}
+	/**
+	* Run message_received hook.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runMessageReceived(event, ctx) {
+		return runVoidHook("message_received", event, ctx);
+	}
+	/**
+	* Run message_sending hook.
+	* Allows plugins to modify or cancel outgoing messages.
+	* Runs sequentially.
+	*/
+	async function runMessageSending(event, ctx) {
+		return runModifyingHook("message_sending", event, ctx, (acc, next) => ({
+			content: next.content ?? acc?.content,
+			cancel: next.cancel ?? acc?.cancel
+		}));
+	}
+	/**
+	* Run message_sent hook.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runMessageSent(event, ctx) {
+		return runVoidHook("message_sent", event, ctx);
+	}
+	/**
+	* Run before_tool_call hook.
+	* Allows plugins to modify or block tool calls.
+	* Runs sequentially.
+	*/
+	async function runBeforeToolCall(event, ctx) {
+		return runModifyingHook("before_tool_call", event, ctx, (acc, next) => ({
+			params: next.params ?? acc?.params,
+			block: next.block ?? acc?.block,
+			blockReason: next.blockReason ?? acc?.blockReason
+		}));
+	}
+	/**
+	* Run after_tool_call hook.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runAfterToolCall(event, ctx) {
+		return runVoidHook("after_tool_call", event, ctx);
+	}
+	/**
+	* Run tool_result_persist hook.
+	*
+	* This hook is intentionally synchronous: it runs in hot paths where session
+	* transcripts are appended synchronously.
+	*
+	* Handlers are executed sequentially in priority order (higher first). Each
+	* handler may return `{ message }` to replace the message passed to the next
+	* handler.
+	*/
+	function runToolResultPersist(event, ctx) {
+		const hooks = getHooksForName(registry, "tool_result_persist");
+		if (hooks.length === 0) return;
+		let current = event.message;
+		for (const hook of hooks) try {
+			const out = hook.handler({
+				...event,
+				message: current
+			}, ctx);
+			if (out && typeof out.then === "function") {
+				const msg = `[hooks] tool_result_persist handler from ${hook.pluginId} returned a Promise; this hook is synchronous and the result was ignored.`;
+				if (catchErrors) {
+					logger?.warn?.(msg);
+					continue;
+				}
+				throw new Error(msg);
+			}
+			const next = out?.message;
+			if (next) current = next;
+		} catch (err) {
+			const msg = `[hooks] tool_result_persist handler from ${hook.pluginId} failed: ${String(err)}`;
+			if (catchErrors) logger?.error(msg);
+			else throw new Error(msg, { cause: err });
+		}
+		return { message: current };
+	}
+	/**
+	* Run session_start hook.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runSessionStart(event, ctx) {
+		return runVoidHook("session_start", event, ctx);
+	}
+	/**
+	* Run session_end hook.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runSessionEnd(event, ctx) {
+		return runVoidHook("session_end", event, ctx);
+	}
+	/**
+	* Run gateway_start hook.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runGatewayStart(event, ctx) {
+		return runVoidHook("gateway_start", event, ctx);
+	}
+	/**
+	* Run gateway_stop hook.
+	* Runs in parallel (fire-and-forget).
+	*/
+	async function runGatewayStop(event, ctx) {
+		return runVoidHook("gateway_stop", event, ctx);
+	}
+	/**
+	* Check if any hooks are registered for a given hook name.
+	*/
+	function hasHooks(hookName) {
+		return registry.typedHooks.some((h) => h.hookName === hookName);
+	}
+	/**
+	* Get count of registered hooks for a given hook name.
+	*/
+	function getHookCount(hookName) {
+		return registry.typedHooks.filter((h) => h.hookName === hookName).length;
+	}
+	return {
+		runBeforeAgentStart,
+		runAgentEnd,
+		runBeforeCompaction,
+		runAfterCompaction,
+		runMessageReceived,
+		runMessageSending,
+		runMessageSent,
+		runBeforeToolCall,
+		runAfterToolCall,
+		runToolResultPersist,
+		runSessionStart,
+		runSessionEnd,
+		runGatewayStart,
+		runGatewayStop,
+		hasHooks,
+		getHookCount
+	};
+}
+
+//#endregion
+//#region src/plugins/hook-runner-global.ts
+const log = createSubsystemLogger("plugins");
+let globalHookRunner = null;
+let globalRegistry = null;
+/**
+* Initialize the global hook runner with a plugin registry.
+* Called once when plugins are loaded during gateway startup.
+*/
+function initializeGlobalHookRunner(registry) {
+	globalRegistry = registry;
+	globalHookRunner = createHookRunner(registry, {
+		logger: {
+			debug: (msg) => log.debug(msg),
+			warn: (msg) => log.warn(msg),
+			error: (msg) => log.error(msg)
+		},
+		catchErrors: true
+	});
+	const hookCount = registry.hooks.length;
+	if (hookCount > 0) log.info(`hook runner initialized with ${hookCount} registered hooks`);
+}
+/**
+* Get the global hook runner.
+* Returns null if plugins haven't been loaded yet.
+*/
+function getGlobalHookRunner() {
+	return globalHookRunner;
+}
+
 //#endregion
 //#region src/markdown/fences.ts
 function parseFenceSpans(buffer) {
@@ -2363,22 +2617,60 @@ async function deliverOutboundPayloads(params) {
 		const normalized = normalizeWhatsAppPayload(payload);
 		return normalized ? [normalized] : [];
 	});
+	const hookRunner = getGlobalHookRunner();
 	for (const payload of normalizedPayloads) {
 		const payloadSummary = {
 			text: payload.text ?? "",
 			mediaUrls: payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []),
 			channelData: payload.channelData
 		};
+		const emitMessageSent = (success, error) => {
+			if (!hookRunner?.hasHooks("message_sent")) return;
+			hookRunner.runMessageSent({
+				to,
+				content: payloadSummary.text,
+				success,
+				...error ? { error } : {}
+			}, {
+				channelId: channel,
+				accountId: accountId ?? void 0
+			}).catch(() => {});
+		};
 		try {
 			throwIfAborted(abortSignal);
+			let effectivePayload = payload;
+			if (hookRunner?.hasHooks("message_sending")) try {
+				const sendingResult = await hookRunner.runMessageSending({
+					to,
+					content: payloadSummary.text,
+					metadata: {
+						channel,
+						accountId,
+						mediaUrls: payloadSummary.mediaUrls
+					}
+				}, {
+					channelId: channel,
+					accountId: accountId ?? void 0
+				});
+				if (sendingResult?.cancel) continue;
+				if (sendingResult?.content != null) {
+					effectivePayload = {
+						...payload,
+						text: sendingResult.content
+					};
+					payloadSummary.text = sendingResult.content;
+				}
+			} catch {}
 			params.onPayload?.(payloadSummary);
-			if (handler.sendPayload && payload.channelData) {
-				results.push(await handler.sendPayload(payload));
+			if (handler.sendPayload && effectivePayload.channelData) {
+				results.push(await handler.sendPayload(effectivePayload));
+				emitMessageSent(true);
 				continue;
 			}
 			if (payloadSummary.mediaUrls.length === 0) {
 				if (isSignalChannel) await sendSignalTextChunks(payloadSummary.text);
 				else await sendTextChunks(payloadSummary.text);
+				emitMessageSent(true);
 				continue;
 			}
 			let first = true;
@@ -2389,7 +2681,9 @@ async function deliverOutboundPayloads(params) {
 				if (isSignalChannel) results.push(await sendSignalMedia(caption, url));
 				else results.push(await handler.sendMedia(caption, url));
 			}
+			emitMessageSent(true);
 		} catch (err) {
+			emitMessageSent(false, err instanceof Error ? err.message : String(err));
 			if (!params.bestEffort) throw err;
 			params.onError?.(err, payloadSummary);
 		}
@@ -2409,4 +2703,4 @@ async function deliverOutboundPayloads(params) {
 }
 
 //#endregion
-export { markdownToIR as A, resolveChunkMode as B, sendTypingSignal as C, resolveFetch as D, streamSignalEvents as E, chunkByNewline as F, HEARTBEAT_TOKEN as G, findFenceSpanAt as H, chunkMarkdownText as I, SILENT_REPLY_TOKEN as K, chunkMarkdownTextWithMode as L, loadWebMedia as M, loadWebMediaRaw as N, wrapFetchWithAbortSignal as O, resolveMarkdownTableMode as P, chunkText as R, sendReadReceiptSignal as S, signalRpcRequest as T, isSafeFenceBreak as U, resolveTextChunkLimit as V, parseFenceSpans as W, throwIfAborted as _, normalizeOutboundPayloadsForJson as a, parseInlineDirectives as b, applyReplyThreading as c, shouldSuppressMessagingToolReplies as d, createReplyToModeFilterForChannel as f, normalizeTargetForProvider as g, normalizeChannelTargetInput as h, normalizeOutboundPayloads as i, markdownToIRWithMeta as j, chunkMarkdownIR as k, filterMessagingToolDuplicates as l, buildTargetResolverSignature as m, deliver_exports as n, normalizeReplyPayloadsForDelivery as o, resolveReplyToMode as p, isSilentReplyText as q, formatOutboundPayloadLog as r, applyReplyTagsToPayload as s, deliverOutboundPayloads as t, isRenderablePayload as u, parseReplyDirectives as v, signalCheck as w, sendMessageSignal as x, splitMediaFromOutput as y, chunkTextWithMode as z };
+export { markdownToIR as A, resolveChunkMode as B, sendTypingSignal as C, resolveFetch as D, streamSignalEvents as E, chunkByNewline as F, getGlobalHookRunner as G, findFenceSpanAt as H, chunkMarkdownText as I, SILENT_REPLY_TOKEN as J, initializeGlobalHookRunner as K, chunkMarkdownTextWithMode as L, loadWebMedia as M, loadWebMediaRaw as N, wrapFetchWithAbortSignal as O, resolveMarkdownTableMode as P, chunkText as R, sendReadReceiptSignal as S, signalRpcRequest as T, isSafeFenceBreak as U, resolveTextChunkLimit as V, parseFenceSpans as W, isSilentReplyText as Y, throwIfAborted as _, normalizeOutboundPayloadsForJson as a, parseInlineDirectives as b, applyReplyThreading as c, shouldSuppressMessagingToolReplies as d, createReplyToModeFilterForChannel as f, normalizeTargetForProvider as g, normalizeChannelTargetInput as h, normalizeOutboundPayloads as i, markdownToIRWithMeta as j, chunkMarkdownIR as k, filterMessagingToolDuplicates as l, buildTargetResolverSignature as m, deliver_exports as n, normalizeReplyPayloadsForDelivery as o, resolveReplyToMode as p, HEARTBEAT_TOKEN as q, formatOutboundPayloadLog as r, applyReplyTagsToPayload as s, deliverOutboundPayloads as t, isRenderablePayload as u, parseReplyDirectives as v, signalCheck as w, sendMessageSignal as x, splitMediaFromOutput as y, chunkTextWithMode as z };