@pixelzx/genesis 2026.6.13-beta.3 → 2026.6.13

package/dist/subagent-announce-delivery-DgJVgXOr.js

@@ -0,0 +1,726 @@
+import { c as normalizeOptionalString, s as normalizeOptionalLowercaseString, u as normalizeOptionalThreadValue } from "./string-coerce-DPP_aYVc.js";
+import { n as defaultRuntime } from "./runtime-DDkDH9fa.js";
+import { a as loadConfig } from "./io-lNN4Levs.js";
+import { i as isCronSessionKey } from "./session-key-utils-DDwuwYKT.js";
+import { n as normalizeAccountId } from "./account-id-CTXHUezn.js";
+import { l as normalizeMainKey, u as resolveAgentIdFromSessionKey } from "./session-key-Cj8Hd5K-.js";
+import "./config-DzozJ_v4.js";
+import "./message-channel-core-BUIi495-.js";
+import { c as isGatewayMessageChannel, r as isInternalMessageChannel, u as normalizeMessageChannel } from "./message-channel-DGBKBihv.js";
+import { t as getGlobalHookRunner } from "./hook-runner-global-KWJ-vVaB.js";
+import { i as resolveMainSessionKey } from "./main-session-C5R_Lg-0.js";
+import { u as resolveStorePath } from "./paths-CV1IubzZ.js";
+import { i as normalizeDeliveryContext$1, r as mergeDeliveryContext$1 } from "./delivery-context.shared-XCrZuuA_.js";
+import { t as loadSessionStore } from "./store-load-TVGyCAt9.js";
+import "./sessions-lhISK_V1.js";
+import { r as callGateway } from "./call-CL7Keh1p.js";
+import { n as resolveConversationDeliveryTarget } from "./delivery-context-DP5JLMHJ.js";
+import { a as getSubagentDepthFromSessionStore } from "./subagent-capabilities-CgoplZng.js";
+import { r as resolveComparableTargetForLoadedChannel } from "./target-parsing-loaded-BMJEwvPk.js";
+import { t as sendMessage } from "./message-Bec0oyM4.js";
+import { t as resolveQueueSettings } from "./queue-Dmcs434b.js";
+import { t as resolveExternalBestEffortDeliveryTarget } from "./best-effort-delivery-DljQXVME.js";
+import { r as normalizeConversationRef } from "./conversation-id-B4q1gKl1.js";
+import { r as getSessionBindingService } from "./session-binding-service-UsMQYRwd.js";
+import { t as resolveConversationIdFromTargets } from "./conversation-id-CNY0wEK6.js";
+import { a as isEmbeddedPiRunActive, c as resolveActiveEmbeddedRunSessionId, s as queueEmbeddedPiMessage } from "./runs-o2XRtOL_.js";
+import { t as enqueueAnnounce } from "./subagent-announce-queue-BGkhVLRU.js";
+//#region src/agents/announce-idempotency.ts
+function buildAnnounceIdFromChildRun(params) {
+	return `v1:${params.childSessionKey}:${params.childRunId}`;
+}
+function buildAnnounceIdempotencyKey(announceId) {
+	return `announce:${announceId}`;
+}
+function resolveQueueAnnounceId(params) {
+	const announceId = params.announceId?.trim();
+	if (announceId) return announceId;
+	return `legacy:${params.sessionKey}:${params.enqueuedAt}`;
+}
+//#endregion
+//#region src/infra/outbound/bound-delivery-router.ts
+function isActiveBinding(record) {
+	return record.status === "active";
+}
+function resolveBindingForRequester(requester, bindings) {
+	const matchingChannelAccount = bindings.filter((entry) => {
+		const conversation = normalizeConversationRef(entry.conversation);
+		return conversation.channel === requester.channel && conversation.accountId === requester.accountId;
+	});
+	if (matchingChannelAccount.length === 0) return null;
+	const exactConversation = matchingChannelAccount.find((entry) => normalizeConversationRef(entry.conversation).conversationId === requester.conversationId);
+	if (exactConversation) return exactConversation;
+	if (matchingChannelAccount.length === 1) return matchingChannelAccount[0] ?? null;
+	return null;
+}
+function createBoundDeliveryRouter(service = getSessionBindingService()) {
+	return { resolveDestination: (input) => {
+		const targetSessionKey = input.targetSessionKey.trim();
+		if (!targetSessionKey) return {
+			binding: null,
+			mode: "fallback",
+			reason: "missing-target-session"
+		};
+		const activeBindings = service.listBySession(targetSessionKey).filter(isActiveBinding);
+		if (activeBindings.length === 0) return {
+			binding: null,
+			mode: "fallback",
+			reason: "no-active-binding"
+		};
+		if (!input.requester) {
+			if (activeBindings.length === 1) return {
+				binding: activeBindings[0] ?? null,
+				mode: "bound",
+				reason: "single-active-binding"
+			};
+			return {
+				binding: null,
+				mode: "fallback",
+				reason: "ambiguous-without-requester"
+			};
+		}
+		const requester = normalizeConversationRef(input.requester);
+		if (!requester.channel || !requester.conversationId) return {
+			binding: null,
+			mode: "fallback",
+			reason: "invalid-requester"
+		};
+		const fromRequester = resolveBindingForRequester(requester, activeBindings);
+		if (fromRequester) return {
+			binding: fromRequester,
+			mode: "bound",
+			reason: "requester-match"
+		};
+		if (activeBindings.length === 1 && !input.failClosed) return {
+			binding: activeBindings[0] ?? null,
+			mode: "bound",
+			reason: "single-active-binding-fallback"
+		};
+		return {
+			binding: null,
+			mode: "fallback",
+			reason: "no-requester-match"
+		};
+	} };
+}
+//#endregion
+//#region src/agents/subagent-announce-dispatch.ts
+function mapQueueOutcomeToDeliveryResult(outcome) {
+	if (outcome === "steered") return {
+		delivered: true,
+		path: "steered"
+	};
+	if (outcome === "queued") return {
+		delivered: true,
+		path: "queued"
+	};
+	return {
+		delivered: false,
+		path: "none"
+	};
+}
+async function runSubagentAnnounceDispatch(params) {
+	const phases = [];
+	const appendPhase = (phase, result) => {
+		phases.push({
+			phase,
+			delivered: result.delivered,
+			path: result.path,
+			error: result.error
+		});
+	};
+	const withPhases = (result) => ({
+		...result,
+		phases
+	});
+	if (params.signal?.aborted) return withPhases({
+		delivered: false,
+		path: "none"
+	});
+	if (!params.expectsCompletionMessage) {
+		const primaryQueueOutcome = await params.queue();
+		const primaryQueue = mapQueueOutcomeToDeliveryResult(primaryQueueOutcome);
+		appendPhase("queue-primary", primaryQueue);
+		if (primaryQueue.delivered) return withPhases(primaryQueue);
+		if (primaryQueueOutcome === "dropped") return withPhases(primaryQueue);
+		const primaryDirect = await params.direct();
+		appendPhase("direct-primary", primaryDirect);
+		return withPhases(primaryDirect);
+	}
+	const primaryDirect = await params.direct();
+	appendPhase("direct-primary", primaryDirect);
+	if (primaryDirect.delivered) return withPhases(primaryDirect);
+	if (params.signal?.aborted) return withPhases(primaryDirect);
+	const fallbackQueue = mapQueueOutcomeToDeliveryResult(await params.queue());
+	appendPhase("queue-fallback", fallbackQueue);
+	if (fallbackQueue.delivered) return withPhases(fallbackQueue);
+	return withPhases(primaryDirect);
+}
+//#endregion
+//#region src/agents/subagent-announce-origin.ts
+function normalizeDeliveryContext(context) {
+	if (!context) return;
+	const normalized = {
+		channel: normalizeOptionalLowercaseString(context.channel),
+		to: normalizeOptionalString(context.to),
+		accountId: normalizeOptionalString(context.accountId)
+	};
+	const threadId = normalizeOptionalThreadValue(context.threadId);
+	if (threadId != null) normalized.threadId = threadId;
+	if (!normalized.channel && !normalized.to && !normalized.accountId && normalized.threadId == null) return;
+	return normalized;
+}
+function mergeDeliveryContext(primary, fallback) {
+	const normalizedPrimary = normalizeDeliveryContext(primary);
+	const normalizedFallback = normalizeDeliveryContext(fallback);
+	if (!normalizedPrimary && !normalizedFallback) return;
+	const channelsConflict = normalizedPrimary?.channel && normalizedFallback?.channel && normalizedPrimary.channel !== normalizedFallback.channel;
+	return normalizeDeliveryContext({
+		channel: normalizedPrimary?.channel ?? normalizedFallback?.channel,
+		to: channelsConflict ? normalizedPrimary?.to : normalizedPrimary?.to ?? normalizedFallback?.to,
+		accountId: channelsConflict ? normalizedPrimary?.accountId : normalizedPrimary?.accountId ?? normalizedFallback?.accountId,
+		threadId: channelsConflict ? normalizedPrimary?.threadId : normalizedPrimary?.threadId ?? normalizedFallback?.threadId
+	});
+}
+function deliveryContextFromSession(entry) {
+	if (!entry) return;
+	return normalizeDeliveryContext({
+		channel: entry.deliveryContext?.channel ?? entry.lastChannel ?? entry.channel ?? entry.origin?.provider,
+		to: entry.deliveryContext?.to ?? entry.lastTo,
+		accountId: entry.deliveryContext?.accountId ?? entry.lastAccountId ?? entry.origin?.accountId,
+		threadId: entry.deliveryContext?.threadId ?? entry.lastThreadId ?? entry.origin?.threadId
+	});
+}
+function stripThreadRouteSuffix(target) {
+	return /^(.*):topic:[^:]+$/u.exec(target)?.[1] ?? target;
+}
+function normalizeAnnounceRouteTarget(context) {
+	const rawTo = normalizeOptionalString(context?.to);
+	if (!rawTo) return;
+	const channel = normalizeOptionalLowercaseString(context?.channel);
+	let route = stripThreadRouteSuffix((channel ? resolveComparableTargetForLoadedChannel({
+		channel,
+		rawTarget: rawTo,
+		fallbackThreadId: context?.threadId
+	}) : null)?.to ?? rawTo);
+	if (channel && route.toLowerCase().startsWith(`${channel}:`)) route = route.slice(channel.length + 1);
+	if (route.startsWith("group:") || route.startsWith("channel:")) route = route.slice(route.indexOf(":") + 1);
+	return route || void 0;
+}
+function shouldStripThreadFromAnnounceEntry(normalizedRequester, normalizedEntry) {
+	if (!normalizedRequester?.to || normalizedRequester.threadId != null || normalizedEntry?.threadId == null) return false;
+	const requesterTarget = normalizeAnnounceRouteTarget(normalizedRequester);
+	const entryTarget = normalizeAnnounceRouteTarget(normalizedEntry);
+	if (requesterTarget && entryTarget) return requesterTarget !== entryTarget;
+	return false;
+}
+function resolveAnnounceOrigin(entry, requesterOrigin) {
+	const normalizedRequester = normalizeDeliveryContext(requesterOrigin);
+	const normalizedEntry = deliveryContextFromSession(entry);
+	if (normalizedRequester?.channel && isInternalMessageChannel(normalizedRequester.channel)) return mergeDeliveryContext({
+		accountId: normalizedRequester.accountId,
+		threadId: normalizedRequester.threadId
+	}, normalizedEntry);
+	return mergeDeliveryContext(normalizedRequester, normalizedEntry && shouldStripThreadFromAnnounceEntry(normalizedRequester, normalizedEntry) ? (() => {
+		const { threadId: _ignore, ...rest } = normalizedEntry;
+		return rest;
+	})() : normalizedEntry);
+}
+//#endregion
+//#region src/agents/subagent-requester-store-key.ts
+function resolveRequesterStoreKey(cfg, requesterSessionKey) {
+	const raw = (requesterSessionKey ?? "").trim();
+	if (!raw) return raw;
+	if (raw === "global" || raw === "unknown") return raw;
+	if (raw.startsWith("agent:")) return raw;
+	const mainKey = normalizeMainKey(cfg?.session?.mainKey);
+	if (raw === "main" || raw === mainKey) return resolveMainSessionKey(cfg);
+	return `agent:${resolveAgentIdFromSessionKey(raw)}:${raw}`;
+}
+//#endregion
+//#region src/agents/subagent-announce-delivery.ts
+const DEFAULT_SUBAGENT_ANNOUNCE_TIMEOUT_MS = 12e4;
+const MAX_TIMER_SAFE_TIMEOUT_MS = 2147e6;
+let subagentAnnounceDeliveryDeps = {
+	callGateway,
+	loadConfig,
+	getRequesterSessionActivity: (requesterSessionKey) => {
+		const sessionId = resolveActiveEmbeddedRunSessionId(requesterSessionKey) ?? loadRequesterSessionEntry(requesterSessionKey).entry?.sessionId;
+		return {
+			sessionId,
+			isActive: Boolean(sessionId && isEmbeddedPiRunActive(sessionId))
+		};
+	},
+	queueEmbeddedPiMessage,
+	sendMessage
+};
+function resolveBoundConversationOrigin(params) {
+	const conversation = params.bindingConversation;
+	const conversationId = conversation.conversationId?.trim() ?? "";
+	const parentConversationId = conversation.parentConversationId?.trim() ?? "";
+	const requesterConversationId = params.requesterConversation?.conversationId?.trim() ?? "";
+	const requesterTo = params.requesterOrigin?.to?.trim();
+	if (conversation.channel === "matrix" && parentConversationId && requesterConversationId && parentConversationId === requesterConversationId && requesterTo) return {
+		channel: conversation.channel,
+		accountId: conversation.accountId,
+		to: requesterTo,
+		...conversationId ? { threadId: conversationId } : {}
+	};
+	const boundTarget = resolveConversationDeliveryTarget({
+		channel: conversation.channel,
+		conversationId,
+		parentConversationId
+	});
+	const inferredThreadId = boundTarget.threadId ?? (parentConversationId && parentConversationId !== conversationId ? conversationId : void 0) ?? (params.requesterOrigin?.threadId != null && params.requesterOrigin.threadId !== "" ? String(params.requesterOrigin.threadId) : void 0);
+	if (requesterTo && conversationId && requesterConversationId && conversationId.toLowerCase() === requesterConversationId.toLowerCase()) return {
+		channel: conversation.channel,
+		accountId: conversation.accountId,
+		to: requesterTo,
+		threadId: inferredThreadId
+	};
+	return {
+		channel: conversation.channel,
+		accountId: conversation.accountId,
+		to: boundTarget.to,
+		threadId: inferredThreadId
+	};
+}
+function resolveRequesterSessionActivity(requesterSessionKey) {
+	const activity = subagentAnnounceDeliveryDeps.getRequesterSessionActivity(requesterSessionKey);
+	if (activity.sessionId || activity.isActive) return activity;
+	const { entry } = loadRequesterSessionEntry(requesterSessionKey);
+	const sessionId = entry?.sessionId;
+	return {
+		sessionId,
+		isActive: Boolean(sessionId && isEmbeddedPiRunActive(sessionId))
+	};
+}
+function resolveDirectAnnounceTransientRetryDelaysMs() {
+	return process.env.GENESIS_TEST_FAST === "1" ? [
+		8,
+		16,
+		32
+	] : [
+		5e3,
+		1e4,
+		2e4
+	];
+}
+function resolveSubagentAnnounceTimeoutMs(cfg) {
+	const configured = cfg.agents?.defaults?.subagents?.announceTimeoutMs;
+	if (typeof configured !== "number" || !Number.isFinite(configured)) return DEFAULT_SUBAGENT_ANNOUNCE_TIMEOUT_MS;
+	return Math.min(Math.max(1, Math.floor(configured)), MAX_TIMER_SAFE_TIMEOUT_MS);
+}
+function isInternalAnnounceRequesterSession(sessionKey) {
+	return getSubagentDepthFromSessionStore(sessionKey) >= 1 || isCronSessionKey(sessionKey);
+}
+function summarizeDeliveryError(error) {
+	if (error instanceof Error) return error.message || "error";
+	if (typeof error === "string") return error;
+	if (error === void 0 || error === null) return "unknown error";
+	try {
+		return JSON.stringify(error);
+	} catch {
+		return "error";
+	}
+}
+const TRANSIENT_ANNOUNCE_DELIVERY_ERROR_PATTERNS = [
+	/\berrorcode=unavailable\b/i,
+	/\bstatus\s*[:=]\s*"?unavailable\b/i,
+	/\bUNAVAILABLE\b/,
+	/no active .* listener/i,
+	/gateway not connected/i,
+	/gateway closed \(1006/i,
+	/gateway timeout/i,
+	/\b(econnreset|econnrefused|etimedout|enotfound|ehostunreach|network error)\b/i
+];
+const PERMANENT_ANNOUNCE_DELIVERY_ERROR_PATTERNS = [
+	/unsupported channel/i,
+	/unknown channel/i,
+	/chat not found/i,
+	/user not found/i,
+	/bot.*not.*member/i,
+	/bot was blocked by the user/i,
+	/forbidden: bot was kicked/i,
+	/recipient is not a valid/i,
+	/outbound not configured for channel/i
+];
+function isTransientAnnounceDeliveryError(error) {
+	const message = summarizeDeliveryError(error);
+	if (!message) return false;
+	if (PERMANENT_ANNOUNCE_DELIVERY_ERROR_PATTERNS.some((re) => re.test(message))) return false;
+	return TRANSIENT_ANNOUNCE_DELIVERY_ERROR_PATTERNS.some((re) => re.test(message));
+}
+async function waitForAnnounceRetryDelay(ms, signal) {
+	if (ms <= 0) return;
+	if (!signal) {
+		await new Promise((resolve) => setTimeout(resolve, ms));
+		return;
+	}
+	if (signal.aborted) return;
+	await new Promise((resolve) => {
+		const timer = setTimeout(() => {
+			signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
+			clearTimeout(timer);
+			signal.removeEventListener("abort", onAbort);
+			resolve();
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+	});
+}
+async function runAnnounceDeliveryWithRetry(params) {
+	const retryDelaysMs = resolveDirectAnnounceTransientRetryDelaysMs();
+	let retryIndex = 0;
+	for (;;) {
+		if (params.signal?.aborted) throw new Error("announce delivery aborted");
+		try {
+			return await params.run();
+		} catch (err) {
+			const delayMs = retryDelaysMs[retryIndex];
+			if (delayMs == null || !isTransientAnnounceDeliveryError(err) || params.signal?.aborted) throw err;
+			const nextAttempt = retryIndex + 2;
+			const maxAttempts = retryDelaysMs.length + 1;
+			defaultRuntime.log(`[warn] Subagent announce ${params.operation} transient failure, retrying ${nextAttempt}/${maxAttempts} in ${Math.round(delayMs / 1e3)}s: ${summarizeDeliveryError(err)}`);
+			retryIndex += 1;
+			await waitForAnnounceRetryDelay(delayMs, params.signal);
+		}
+	}
+}
+async function resolveSubagentCompletionOrigin(params) {
+	const requesterOrigin = normalizeDeliveryContext$1(params.requesterOrigin);
+	const channel = normalizeOptionalLowercaseString(requesterOrigin?.channel);
+	const to = requesterOrigin?.to?.trim();
+	const accountId = normalizeAccountId(requesterOrigin?.accountId);
+	const conversationId = (requesterOrigin?.threadId != null && requesterOrigin.threadId !== "" ? String(requesterOrigin.threadId).trim() : void 0) || resolveConversationIdFromTargets({ targets: [to] }) || "";
+	const requesterConversation = channel && conversationId ? {
+		channel,
+		accountId,
+		conversationId
+	} : void 0;
+	const route = createBoundDeliveryRouter().resolveDestination({
+		eventKind: "task_completion",
+		targetSessionKey: params.childSessionKey,
+		requester: requesterConversation,
+		failClosed: false
+	});
+	if (route.mode === "bound" && route.binding) return mergeDeliveryContext$1(resolveBoundConversationOrigin({
+		bindingConversation: route.binding.conversation,
+		requesterConversation,
+		requesterOrigin
+	}), requesterOrigin);
+	const hookRunner = getGlobalHookRunner();
+	if (!hookRunner?.hasHooks("subagent_delivery_target")) return requesterOrigin;
+	try {
+		const hookOrigin = normalizeDeliveryContext$1((await hookRunner.runSubagentDeliveryTarget({
+			childSessionKey: params.childSessionKey,
+			requesterSessionKey: params.requesterSessionKey,
+			requesterOrigin,
+			childRunId: params.childRunId,
+			spawnMode: params.spawnMode,
+			expectsCompletionMessage: params.expectsCompletionMessage
+		}, {
+			runId: params.childRunId,
+			childSessionKey: params.childSessionKey,
+			requesterSessionKey: params.requesterSessionKey
+		}))?.origin);
+		if (!hookOrigin) return requesterOrigin;
+		if (hookOrigin.channel && isInternalMessageChannel(hookOrigin.channel)) return requesterOrigin;
+		return mergeDeliveryContext$1(hookOrigin, requesterOrigin);
+	} catch {
+		return requesterOrigin;
+	}
+}
+async function sendAnnounce(item) {
+	const announceTimeoutMs = resolveSubagentAnnounceTimeoutMs(subagentAnnounceDeliveryDeps.loadConfig());
+	const requesterIsSubagent = isInternalAnnounceRequesterSession(item.sessionKey);
+	const origin = item.origin;
+	const threadId = origin?.threadId != null && origin.threadId !== "" ? String(origin.threadId) : void 0;
+	const idempotencyKey = buildAnnounceIdempotencyKey(resolveQueueAnnounceId({
+		announceId: item.announceId,
+		sessionKey: item.sessionKey,
+		enqueuedAt: item.enqueuedAt
+	}));
+	await subagentAnnounceDeliveryDeps.callGateway({
+		method: "agent",
+		params: {
+			sessionKey: item.sessionKey,
+			message: item.prompt,
+			channel: requesterIsSubagent ? void 0 : origin?.channel,
+			accountId: requesterIsSubagent ? void 0 : origin?.accountId,
+			to: requesterIsSubagent ? void 0 : origin?.to,
+			threadId: requesterIsSubagent ? void 0 : threadId,
+			deliver: !requesterIsSubagent,
+			internalEvents: item.internalEvents,
+			inputProvenance: {
+				kind: "inter_session",
+				sourceSessionKey: item.sourceSessionKey,
+				sourceChannel: item.sourceChannel ?? "webchat",
+				sourceTool: item.sourceTool ?? "subagent_announce"
+			},
+			idempotencyKey
+		},
+		timeoutMs: announceTimeoutMs
+	});
+}
+function loadRequesterSessionEntry(requesterSessionKey) {
+	const cfg = subagentAnnounceDeliveryDeps.loadConfig();
+	const canonicalKey = resolveRequesterStoreKey(cfg, requesterSessionKey);
+	const agentId = resolveAgentIdFromSessionKey(canonicalKey);
+	return {
+		cfg,
+		entry: loadSessionStore(resolveStorePath(cfg.session?.store, { agentId }))[canonicalKey],
+		canonicalKey
+	};
+}
+function loadSessionEntryByKey(sessionKey) {
+	const cfg = subagentAnnounceDeliveryDeps.loadConfig();
+	const agentId = resolveAgentIdFromSessionKey(sessionKey);
+	return loadSessionStore(resolveStorePath(cfg.session?.store, { agentId }))[sessionKey];
+}
+function buildAnnounceQueueKey(sessionKey, origin) {
+	const accountId = normalizeAccountId(origin?.accountId);
+	if (!accountId) return sessionKey;
+	return `${sessionKey}:acct:${accountId}`;
+}
+async function maybeQueueSubagentAnnounce(params) {
+	if (params.signal?.aborted) return "none";
+	const { cfg, entry } = loadRequesterSessionEntry(params.requesterSessionKey);
+	const canonicalKey = resolveRequesterStoreKey(cfg, params.requesterSessionKey);
+	const { sessionId, isActive } = resolveRequesterSessionActivity(canonicalKey);
+	if (!sessionId) return "none";
+	const queueSettings = resolveQueueSettings({
+		cfg,
+		channel: entry?.channel ?? entry?.lastChannel ?? entry?.origin?.provider,
+		sessionEntry: entry
+	});
+	if (queueSettings.mode === "steer" || queueSettings.mode === "steer-backlog") {
+		if (subagentAnnounceDeliveryDeps.queueEmbeddedPiMessage(sessionId, params.steerMessage)) return "steered";
+	}
+	const shouldFollowup = queueSettings.mode === "followup" || queueSettings.mode === "collect" || queueSettings.mode === "steer-backlog" || queueSettings.mode === "interrupt";
+	if (isActive && (shouldFollowup || queueSettings.mode === "steer")) {
+		const origin = resolveAnnounceOrigin(entry, params.requesterOrigin);
+		return enqueueAnnounce({
+			key: buildAnnounceQueueKey(canonicalKey, origin),
+			item: {
+				announceId: params.announceId,
+				prompt: params.triggerMessage,
+				summaryLine: params.summaryLine,
+				internalEvents: params.internalEvents,
+				enqueuedAt: Date.now(),
+				sessionKey: canonicalKey,
+				origin,
+				sourceSessionKey: params.sourceSessionKey,
+				sourceChannel: params.sourceChannel,
+				sourceTool: params.sourceTool
+			},
+			settings: queueSettings,
+			send: sendAnnounce
+		}) ? "queued" : "dropped";
+	}
+	return "none";
+}
+function extractThreadCompletionFallbackText(internalEvents) {
+	if (!internalEvents || internalEvents.length === 0) return "";
+	for (const event of internalEvents) {
+		if (event.type !== "task_completion") continue;
+		const result = event.result.trim();
+		if (result) return result;
+		const statusLabel = event.statusLabel.trim();
+		const taskLabel = event.taskLabel.trim();
+		if (statusLabel && taskLabel) return `${taskLabel}: ${statusLabel}`;
+		if (statusLabel) return statusLabel;
+		if (taskLabel) return taskLabel;
+	}
+	return "";
+}
+function hasVisibleGatewayAgentPayload(response) {
+	const result = response && typeof response === "object" && "result" in response ? response.result : void 0;
+	const payloads = result && typeof result === "object" && "payloads" in result ? result.payloads : void 0;
+	if (!Array.isArray(payloads)) return false;
+	return payloads.some((payload) => {
+		if (!payload || typeof payload !== "object") return false;
+		const record = payload;
+		const text = typeof record.text === "string" ? record.text.trim() : "";
+		const mediaUrl = typeof record.mediaUrl === "string" ? record.mediaUrl.trim() : "";
+		const mediaUrls = Array.isArray(record.mediaUrls) ? record.mediaUrls.some((item) => typeof item === "string" && item.trim()) : false;
+		return Boolean(text || mediaUrl || mediaUrls || record.presentation || record.interactive || record.channelData);
+	});
+}
+async function sendThreadCompletionFallback(params) {
+	const channel = params.channel?.trim();
+	const to = params.to?.trim();
+	const content = params.content.trim();
+	if (!channel || !to || !params.threadId || !content) return false;
+	await runAnnounceDeliveryWithRetry({
+		operation: "completion direct thread fallback send",
+		signal: params.signal,
+		run: async () => await subagentAnnounceDeliveryDeps.sendMessage({
+			cfg: params.cfg,
+			channel,
+			to,
+			accountId: params.accountId,
+			threadId: params.threadId,
+			content,
+			requesterSessionKey: params.requesterSessionKey,
+			bestEffort: params.bestEffortDeliver,
+			idempotencyKey: params.idempotencyKey,
+			abortSignal: params.signal
+		})
+	});
+	return true;
+}
+async function sendSubagentAnnounceDirectly(params) {
+	if (params.signal?.aborted) return {
+		delivered: false,
+		path: "none"
+	};
+	const cfg = subagentAnnounceDeliveryDeps.loadConfig();
+	const announceTimeoutMs = resolveSubagentAnnounceTimeoutMs(cfg);
+	const canonicalRequesterSessionKey = resolveRequesterStoreKey(cfg, params.targetRequesterSessionKey);
+	try {
+		const completionDirectOrigin = normalizeDeliveryContext$1(params.completionDirectOrigin);
+		const directOrigin = normalizeDeliveryContext$1(params.directOrigin);
+		const requesterSessionOrigin = normalizeDeliveryContext$1(params.requesterSessionOrigin);
+		const effectiveDirectOrigin = params.expectsCompletionMessage && completionDirectOrigin ? mergeDeliveryContext$1(completionDirectOrigin, directOrigin) : directOrigin;
+		const sessionOnlyOrigin = effectiveDirectOrigin?.channel ? effectiveDirectOrigin : requesterSessionOrigin;
+		const deliveryTarget = !params.requesterIsSubagent ? resolveExternalBestEffortDeliveryTarget({
+			channel: effectiveDirectOrigin?.channel,
+			to: effectiveDirectOrigin?.to,
+			accountId: effectiveDirectOrigin?.accountId,
+			threadId: effectiveDirectOrigin?.threadId
+		}) : { deliver: false };
+		const normalizedSessionOnlyOriginChannel = !params.requesterIsSubagent ? normalizeMessageChannel(sessionOnlyOrigin?.channel) : void 0;
+		const sessionOnlyOriginChannel = normalizedSessionOnlyOriginChannel && isGatewayMessageChannel(normalizedSessionOnlyOriginChannel) ? normalizedSessionOnlyOriginChannel : void 0;
+		const requesterActivity = resolveRequesterSessionActivity(canonicalRequesterSessionKey);
+		if (params.expectsCompletionMessage && requesterActivity.sessionId) {
+			if (requesterActivity.sessionId ? subagentAnnounceDeliveryDeps.queueEmbeddedPiMessage(requesterActivity.sessionId, params.triggerMessage) : false) return {
+				delivered: true,
+				path: "steered"
+			};
+			if (requesterActivity.isActive) return {
+				delivered: false,
+				path: "direct",
+				error: "active requester session could not be woken"
+			};
+		}
+		if (params.signal?.aborted) return {
+			delivered: false,
+			path: "none"
+		};
+		const threadCompletionFallbackText = params.expectsCompletionMessage && deliveryTarget.deliver && deliveryTarget.threadId ? extractThreadCompletionFallbackText(params.internalEvents) : "";
+		let directAnnounceResponse;
+		try {
+			directAnnounceResponse = await runAnnounceDeliveryWithRetry({
+				operation: params.expectsCompletionMessage ? "completion direct announce agent call" : "direct announce agent call",
+				signal: params.signal,
+				run: async () => await subagentAnnounceDeliveryDeps.callGateway({
+					method: "agent",
+					params: {
+						sessionKey: canonicalRequesterSessionKey,
+						message: params.triggerMessage,
+						deliver: deliveryTarget.deliver,
+						bestEffortDeliver: params.bestEffortDeliver,
+						internalEvents: params.internalEvents,
+						channel: deliveryTarget.deliver ? deliveryTarget.channel : sessionOnlyOriginChannel,
+						accountId: deliveryTarget.deliver ? deliveryTarget.accountId : sessionOnlyOriginChannel ? sessionOnlyOrigin?.accountId : void 0,
+						to: deliveryTarget.deliver ? deliveryTarget.to : sessionOnlyOriginChannel ? sessionOnlyOrigin?.to : void 0,
+						threadId: deliveryTarget.deliver ? deliveryTarget.threadId : sessionOnlyOriginChannel ? sessionOnlyOrigin?.threadId : void 0,
+						inputProvenance: {
+							kind: "inter_session",
+							sourceSessionKey: params.sourceSessionKey,
+							sourceChannel: params.sourceChannel ?? "webchat",
+							sourceTool: params.sourceTool ?? "subagent_announce"
+						},
+						idempotencyKey: params.directIdempotencyKey
+					},
+					expectFinal: true,
+					timeoutMs: announceTimeoutMs
+				})
+			});
+		} catch (err) {
+			if (await sendThreadCompletionFallback({
+				cfg,
+				channel: deliveryTarget.channel,
+				to: deliveryTarget.to,
+				accountId: deliveryTarget.accountId,
+				threadId: deliveryTarget.threadId,
+				content: threadCompletionFallbackText,
+				requesterSessionKey: canonicalRequesterSessionKey,
+				bestEffortDeliver: params.bestEffortDeliver,
+				idempotencyKey: params.directIdempotencyKey,
+				signal: params.signal
+			})) return {
+				delivered: true,
+				path: "direct-thread-fallback"
+			};
+			throw err;
+		}
+		if (threadCompletionFallbackText && !hasVisibleGatewayAgentPayload(directAnnounceResponse)) {
+			if (await sendThreadCompletionFallback({
+				cfg,
+				channel: deliveryTarget.channel,
+				to: deliveryTarget.to,
+				accountId: deliveryTarget.accountId,
+				threadId: deliveryTarget.threadId,
+				content: threadCompletionFallbackText,
+				requesterSessionKey: canonicalRequesterSessionKey,
+				bestEffortDeliver: params.bestEffortDeliver,
+				idempotencyKey: params.directIdempotencyKey,
+				signal: params.signal
+			})) return {
+				delivered: true,
+				path: "direct-thread-fallback"
+			};
+		}
+		return {
+			delivered: true,
+			path: "direct"
+		};
+	} catch (err) {
+		return {
+			delivered: false,
+			path: "direct",
+			error: summarizeDeliveryError(err)
+		};
+	}
+}
+async function deliverSubagentAnnouncement(params) {
+	return await runSubagentAnnounceDispatch({
+		expectsCompletionMessage: params.expectsCompletionMessage,
+		signal: params.signal,
+		queue: async () => await maybeQueueSubagentAnnounce({
+			requesterSessionKey: params.requesterSessionKey,
+			announceId: params.announceId,
+			triggerMessage: params.triggerMessage,
+			steerMessage: params.steerMessage,
+			summaryLine: params.summaryLine,
+			requesterOrigin: params.requesterOrigin,
+			sourceSessionKey: params.sourceSessionKey,
+			sourceChannel: params.sourceChannel,
+			sourceTool: params.sourceTool,
+			internalEvents: params.internalEvents,
+			signal: params.signal
+		}),
+		direct: async () => await sendSubagentAnnounceDirectly({
+			targetRequesterSessionKey: params.targetRequesterSessionKey,
+			triggerMessage: params.triggerMessage,
+			internalEvents: params.internalEvents,
+			directIdempotencyKey: params.directIdempotencyKey,
+			completionDirectOrigin: params.completionDirectOrigin,
+			directOrigin: params.directOrigin,
+			requesterSessionOrigin: params.requesterSessionOrigin,
+			sourceSessionKey: params.sourceSessionKey,
+			sourceChannel: params.sourceChannel,
+			sourceTool: params.sourceTool,
+			requesterIsSubagent: params.requesterIsSubagent,
+			expectsCompletionMessage: params.expectsCompletionMessage,
+			signal: params.signal,
+			bestEffortDeliver: params.bestEffortDeliver
+		})
+	});
+}
+//#endregion
+export { resolveSubagentAnnounceTimeoutMs as a, resolveAnnounceOrigin as c, loadSessionEntryByKey as i, buildAnnounceIdFromChildRun as l, isInternalAnnounceRequesterSession as n, resolveSubagentCompletionOrigin as o, loadRequesterSessionEntry as r, runAnnounceDeliveryWithRetry as s, deliverSubagentAnnouncement as t, buildAnnounceIdempotencyKey as u };