@gaodefa/daocore 2026.5.31 → 2026.5.33

package/dist/subagent-control-BQDtHw6e.js

@@ -0,0 +1,508 @@
+import { i as formatErrorMessage } from "./errors-D_oyTIw2.js";
+import { t as createLazyImportLoader } from "./lazy-promise-Djskx0qC.js";
+import { a as isSubagentSessionKey, c as parseAgentSessionKey } from "./session-key-utils-Ce_xWkNq.js";
+import { r as logVerbose } from "./globals-DhGeOA1P.js";
+import { r as INTERNAL_MESSAGE_CHANNEL } from "./message-channel-core-C7o0LP7q.js";
+import "./message-channel-CRza_Xs_.js";
+import { r as callGateway } from "./call-BFqofFc5.js";
+import { u as resolveStorePath } from "./paths-8MFrTNIB.js";
+import { t as loadSessionStore } from "./store-load-B817r-3Z.js";
+import { u as updateSessionStore } from "./store-C4uyNaPD.js";
+import { M as subagentRuns, t as getSubagentRunsSnapshotForRead } from "./subagent-registry-state-IRjqqsbj.js";
+import { r as getLatestSubagentRunByChildSessionKey, s as listSubagentRunsForController } from "./subagent-registry-read-Dx7kwYP9.js";
+import { n as resolveStoredSubagentCapabilities } from "./subagent-capabilities-CL0g3hBY.js";
+import { c as resolveMainSessionAlias, s as resolveInternalSessionKey } from "./sessions-helpers-Ctik-uPl.js";
+import { t as AGENT_LANE_SUBAGENT } from "./lanes-ReZ09_e4.js";
+import { a as waitForAgentRunAndReadUpdatedAssistantReply, r as readLatestAssistantReplySnapshot } from "./run-wait-Ba5wh82_.js";
+import { d as markSubagentRunForSteerRestart, f as markSubagentRunTerminated, i as countPendingDescendantRuns, m as replaceSubagentRunAfterSteer, t as clearSubagentRunSteerRestart } from "./subagent-registry-BHt8-wIZ.js";
+import { a as sortSubagentRuns, i as resolveSubagentTargetFromRuns, r as resolveSubagentLabel } from "./subagents-utils-yfXEDHe3.js";
+import { a as resolveSessionEntryForKey, t as buildLatestSubagentRunIndex } from "./subagent-list-C3f1YJh8.js";
+import crypto from "node:crypto";
+const MAX_RECENT_MINUTES = 1440;
+const MAX_STEER_MESSAGE_CHARS = 4e3;
+const STEER_RATE_LIMIT_MS = 2e3;
+const STEER_ABORT_SETTLE_TIMEOUT_MS = 5e3;
+const SUBAGENT_REPLY_HISTORY_LIMIT = 50;
+const steerRateLimit = /* @__PURE__ */ new Map();
+let subagentControlDeps = {
+	callGateway,
+	updateSessionStore
+};
+const subagentControlRuntimeLoader = createLazyImportLoader(() => import("./subagent-control.runtime.js"));
+function loadSubagentControlRuntime() {
+	return subagentControlRuntimeLoader.load();
+}
+async function resolveSubagentControlRuntime() {
+	if (subagentControlDeps.abortEmbeddedPiRun && subagentControlDeps.clearSessionQueues) return {
+		abortEmbeddedPiRun: subagentControlDeps.abortEmbeddedPiRun,
+		clearSessionQueues: subagentControlDeps.clearSessionQueues
+	};
+	const runtime = await loadSubagentControlRuntime();
+	return {
+		abortEmbeddedPiRun: subagentControlDeps.abortEmbeddedPiRun ?? runtime.abortEmbeddedPiRun,
+		clearSessionQueues: subagentControlDeps.clearSessionQueues ?? runtime.clearSessionQueues
+	};
+}
+function resolveSubagentController(params) {
+	const { mainKey, alias } = resolveMainSessionAlias(params.cfg);
+	const callerSessionKey = resolveInternalSessionKey({
+		key: params.agentSessionKey?.trim() || alias,
+		alias,
+		mainKey
+	});
+	if (!isSubagentSessionKey(callerSessionKey)) return {
+		controllerSessionKey: callerSessionKey,
+		callerSessionKey,
+		callerIsSubagent: false,
+		controlScope: "children"
+	};
+	return {
+		controllerSessionKey: callerSessionKey,
+		callerSessionKey,
+		callerIsSubagent: true,
+		controlScope: resolveStoredSubagentCapabilities(callerSessionKey, { cfg: params.cfg }).controlScope
+	};
+}
+function listControlledSubagentRuns(controllerSessionKey) {
+	const key = controllerSessionKey.trim();
+	if (!key) return [];
+	const latestByChildSessionKey = buildLatestSubagentRunIndex(getSubagentRunsSnapshotForRead(subagentRuns)).latestByChildSessionKey;
+	return sortSubagentRuns(Array.from(latestByChildSessionKey.values()).filter((entry) => {
+		return (entry.controllerSessionKey?.trim() || entry.requesterSessionKey?.trim()) === key;
+	}));
+}
+function ensureControllerOwnsRun(params) {
+	if ((params.entry.controllerSessionKey?.trim() || params.entry.requesterSessionKey) === params.controller.controllerSessionKey) return;
+	return "Subagents can only control runs spawned from their own session.";
+}
+async function killSubagentRun(params) {
+	if (params.entry.endedAt) return { killed: false };
+	const childSessionKey = params.entry.childSessionKey;
+	const resolved = resolveSessionEntryForKey({
+		cfg: params.cfg,
+		key: childSessionKey,
+		cache: params.cache
+	});
+	const sessionId = resolved.entry?.sessionId;
+	const runtime = await resolveSubagentControlRuntime();
+	const aborted = sessionId ? runtime.abortEmbeddedPiRun(sessionId) : false;
+	const cleared = runtime.clearSessionQueues([childSessionKey, sessionId]);
+	if (cleared.followupCleared > 0 || cleared.laneCleared > 0) logVerbose(`subagents control kill: cleared followups=${cleared.followupCleared} lane=${cleared.laneCleared} keys=${cleared.keys.join(",")}`);
+	if (resolved.entry) try {
+		await subagentControlDeps.updateSessionStore(resolved.storePath, (store) => {
+			const current = store[childSessionKey];
+			if (!current) return;
+			current.abortedLastRun = true;
+			current.updatedAt = Date.now();
+			store[childSessionKey] = current;
+		});
+	} catch (error) {
+		logVerbose(`subagents control kill: failed to persist abortedLastRun for ${childSessionKey}: ${formatErrorMessage(error)}`);
+	}
+	return {
+		killed: markSubagentRunTerminated({
+			runId: params.entry.runId,
+			childSessionKey,
+			reason: "killed"
+		}) > 0 || aborted || cleared.followupCleared > 0 || cleared.laneCleared > 0,
+		sessionId
+	};
+}
+async function cascadeKillChildren(params) {
+	const childRunsBySessionKey = /* @__PURE__ */ new Map();
+	for (const run of listSubagentRunsForController(params.parentChildSessionKey)) {
+		const childKey = run.childSessionKey?.trim();
+		if (!childKey) continue;
+		const latest = getLatestSubagentRunByChildSessionKey(childKey);
+		const latestControllerSessionKey = latest?.controllerSessionKey?.trim() || latest?.requesterSessionKey?.trim();
+		if (!latest || latest.runId !== run.runId || latestControllerSessionKey !== params.parentChildSessionKey) continue;
+		const existing = childRunsBySessionKey.get(childKey);
+		if (!existing || run.createdAt >= existing.createdAt) childRunsBySessionKey.set(childKey, run);
+	}
+	const childRuns = Array.from(childRunsBySessionKey.values());
+	const seenChildSessionKeys = params.seenChildSessionKeys ?? /* @__PURE__ */ new Set();
+	let killed = 0;
+	const labels = [];
+	for (const run of childRuns) {
+		const childKey = run.childSessionKey?.trim();
+		if (!childKey || seenChildSessionKeys.has(childKey)) continue;
+		seenChildSessionKeys.add(childKey);
+		if (!run.endedAt) {
+			if ((await killSubagentRun({
+				cfg: params.cfg,
+				entry: run,
+				cache: params.cache
+			})).killed) {
+				killed += 1;
+				labels.push(resolveSubagentLabel(run));
+			}
+		}
+		const cascade = await cascadeKillChildren({
+			cfg: params.cfg,
+			parentChildSessionKey: childKey,
+			cache: params.cache,
+			seenChildSessionKeys
+		});
+		killed += cascade.killed;
+		labels.push(...cascade.labels);
+	}
+	return {
+		killed,
+		labels
+	};
+}
+async function killAllControlledSubagentRuns(params) {
+	if (params.controller.controlScope !== "children") return {
+		status: "forbidden",
+		error: "Leaf subagents cannot control other sessions.",
+		killed: 0,
+		labels: []
+	};
+	const cache = /* @__PURE__ */ new Map();
+	const seenChildSessionKeys = /* @__PURE__ */ new Set();
+	const killedLabels = [];
+	let killed = 0;
+	for (const entry of params.runs) {
+		const childKey = entry.childSessionKey?.trim();
+		if (!childKey || seenChildSessionKeys.has(childKey)) continue;
+		const currentEntry = getLatestSubagentRunByChildSessionKey(childKey);
+		if (!currentEntry || currentEntry.runId !== entry.runId) continue;
+		seenChildSessionKeys.add(childKey);
+		if (!currentEntry.endedAt) {
+			if ((await killSubagentRun({
+				cfg: params.cfg,
+				entry: currentEntry,
+				cache
+			})).killed) {
+				killed += 1;
+				killedLabels.push(resolveSubagentLabel(currentEntry));
+			}
+		}
+		const cascade = await cascadeKillChildren({
+			cfg: params.cfg,
+			parentChildSessionKey: childKey,
+			cache,
+			seenChildSessionKeys
+		});
+		killed += cascade.killed;
+		killedLabels.push(...cascade.labels);
+	}
+	return {
+		status: "ok",
+		killed,
+		labels: killedLabels
+	};
+}
+async function killControlledSubagentRun(params) {
+	const ownershipError = ensureControllerOwnsRun({
+		controller: params.controller,
+		entry: params.entry
+	});
+	if (ownershipError) return {
+		status: "forbidden",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		error: ownershipError
+	};
+	if (params.controller.controlScope !== "children") return {
+		status: "forbidden",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		error: "Leaf subagents cannot control other sessions."
+	};
+	const currentEntry = getLatestSubagentRunByChildSessionKey(params.entry.childSessionKey);
+	if (!currentEntry || currentEntry.runId !== params.entry.runId) return {
+		status: "done",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		label: resolveSubagentLabel(params.entry),
+		text: `${resolveSubagentLabel(params.entry)} is already finished.`
+	};
+	const killCache = /* @__PURE__ */ new Map();
+	const stopResult = await killSubagentRun({
+		cfg: params.cfg,
+		entry: currentEntry,
+		cache: killCache
+	});
+	const seenChildSessionKeys = /* @__PURE__ */ new Set();
+	const targetChildKey = params.entry.childSessionKey?.trim();
+	if (targetChildKey) seenChildSessionKeys.add(targetChildKey);
+	const cascade = await cascadeKillChildren({
+		cfg: params.cfg,
+		parentChildSessionKey: params.entry.childSessionKey,
+		cache: killCache,
+		seenChildSessionKeys
+	});
+	if (!stopResult.killed && cascade.killed === 0) return {
+		status: "done",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		label: resolveSubagentLabel(params.entry),
+		text: `${resolveSubagentLabel(params.entry)} is already finished.`
+	};
+	const cascadeText = cascade.killed > 0 ? ` (+ ${cascade.killed} descendant${cascade.killed === 1 ? "" : "s"})` : "";
+	return {
+		status: "ok",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		label: resolveSubagentLabel(params.entry),
+		cascadeKilled: cascade.killed,
+		cascadeLabels: cascade.killed > 0 ? cascade.labels : void 0,
+		text: stopResult.killed ? `killed ${resolveSubagentLabel(params.entry)}${cascadeText}.` : `killed ${cascade.killed} descendant${cascade.killed === 1 ? "" : "s"} of ${resolveSubagentLabel(params.entry)}.`
+	};
+}
+async function killSubagentRunAdmin(params) {
+	const targetSessionKey = params.sessionKey.trim();
+	if (!targetSessionKey) return {
+		found: false,
+		killed: false
+	};
+	const entry = getLatestSubagentRunByChildSessionKey(targetSessionKey);
+	if (!entry) return {
+		found: false,
+		killed: false
+	};
+	const killCache = /* @__PURE__ */ new Map();
+	const stopResult = await killSubagentRun({
+		cfg: params.cfg,
+		entry,
+		cache: killCache
+	});
+	const seenChildSessionKeys = new Set([targetSessionKey]);
+	const cascade = await cascadeKillChildren({
+		cfg: params.cfg,
+		parentChildSessionKey: targetSessionKey,
+		cache: killCache,
+		seenChildSessionKeys
+	});
+	return {
+		found: true,
+		killed: stopResult.killed || cascade.killed > 0,
+		runId: entry.runId,
+		sessionKey: entry.childSessionKey,
+		cascadeKilled: cascade.killed,
+		cascadeLabels: cascade.killed > 0 ? cascade.labels : void 0
+	};
+}
+async function steerControlledSubagentRun(params) {
+	const ownershipError = ensureControllerOwnsRun({
+		controller: params.controller,
+		entry: params.entry
+	});
+	if (ownershipError) return {
+		status: "forbidden",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		error: ownershipError
+	};
+	if (params.controller.controlScope !== "children") return {
+		status: "forbidden",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		error: "Leaf subagents cannot control other sessions."
+	};
+	const targetHasPendingDescendants = countPendingDescendantRuns(params.entry.childSessionKey) > 0;
+	if (params.entry.endedAt && !targetHasPendingDescendants) return {
+		status: "done",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		text: `${resolveSubagentLabel(params.entry)} is already finished.`
+	};
+	if (params.controller.callerSessionKey === params.entry.childSessionKey) return {
+		status: "forbidden",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		error: "Subagents cannot steer themselves."
+	};
+	const currentEntry = getLatestSubagentRunByChildSessionKey(params.entry.childSessionKey);
+	const currentHasPendingDescendants = currentEntry && countPendingDescendantRuns(currentEntry.childSessionKey) > 0;
+	if (!currentEntry || currentEntry.runId !== params.entry.runId || currentEntry.endedAt && !currentHasPendingDescendants) return {
+		status: "done",
+		runId: params.entry.runId,
+		sessionKey: params.entry.childSessionKey,
+		text: `${resolveSubagentLabel(params.entry)} is already finished.`
+	};
+	const rateKey = `${params.controller.callerSessionKey}:${params.entry.childSessionKey}`;
+	if (process.env.VITEST !== "true") {
+		const now = Date.now();
+		if (now - (steerRateLimit.get(rateKey) ?? 0) < STEER_RATE_LIMIT_MS) return {
+			status: "rate_limited",
+			runId: params.entry.runId,
+			sessionKey: params.entry.childSessionKey,
+			error: "Steer rate limit exceeded. Wait a moment before sending another steer."
+		};
+		steerRateLimit.set(rateKey, now);
+	}
+	markSubagentRunForSteerRestart(params.entry.runId);
+	const targetSession = resolveSessionEntryForKey({
+		cfg: params.cfg,
+		key: params.entry.childSessionKey,
+		cache: /* @__PURE__ */ new Map()
+	});
+	const sessionId = typeof targetSession.entry?.sessionId === "string" && targetSession.entry.sessionId.trim() ? targetSession.entry.sessionId.trim() : void 0;
+	if (sessionId) (await resolveSubagentControlRuntime()).abortEmbeddedPiRun(sessionId);
+	const cleared = (await resolveSubagentControlRuntime()).clearSessionQueues([params.entry.childSessionKey, sessionId]);
+	if (cleared.followupCleared > 0 || cleared.laneCleared > 0) logVerbose(`subagents control steer: cleared followups=${cleared.followupCleared} lane=${cleared.laneCleared} keys=${cleared.keys.join(",")}`);
+	try {
+		await subagentControlDeps.callGateway({
+			method: "agent.wait",
+			params: {
+				runId: params.entry.runId,
+				timeoutMs: STEER_ABORT_SETTLE_TIMEOUT_MS
+			},
+			timeoutMs: 7e3
+		});
+	} catch {}
+	const idempotencyKey = crypto.randomUUID();
+	let runId = idempotencyKey;
+	try {
+		const response = await subagentControlDeps.callGateway({
+			method: "agent",
+			params: {
+				message: params.message,
+				sessionKey: params.entry.childSessionKey,
+				sessionId,
+				idempotencyKey,
+				deliver: false,
+				channel: INTERNAL_MESSAGE_CHANNEL,
+				lane: AGENT_LANE_SUBAGENT,
+				timeout: 0
+			},
+			timeoutMs: 1e4
+		});
+		if (typeof response?.runId === "string" && response.runId) runId = response.runId;
+	} catch (err) {
+		clearSubagentRunSteerRestart(params.entry.runId);
+		const error = formatErrorMessage(err);
+		return {
+			status: "error",
+			runId,
+			sessionKey: params.entry.childSessionKey,
+			sessionId,
+			error
+		};
+	}
+	if (!replaceSubagentRunAfterSteer({
+		previousRunId: params.entry.runId,
+		nextRunId: runId,
+		fallback: params.entry,
+		runTimeoutSeconds: params.entry.runTimeoutSeconds ?? 0
+	})) {
+		clearSubagentRunSteerRestart(params.entry.runId);
+		return {
+			status: "error",
+			runId,
+			sessionKey: params.entry.childSessionKey,
+			sessionId,
+			error: "failed to replace steered subagent run"
+		};
+	}
+	return {
+		status: "accepted",
+		runId,
+		sessionKey: params.entry.childSessionKey,
+		sessionId,
+		mode: "restart",
+		label: resolveSubagentLabel(params.entry),
+		text: `steered ${resolveSubagentLabel(params.entry)}.`
+	};
+}
+async function sendControlledSubagentMessage(params) {
+	const ownershipError = ensureControllerOwnsRun({
+		controller: params.controller,
+		entry: params.entry
+	});
+	if (ownershipError) return {
+		status: "forbidden",
+		error: ownershipError
+	};
+	if (params.controller.controlScope !== "children") return {
+		status: "forbidden",
+		error: "Leaf subagents cannot control other sessions."
+	};
+	const currentEntry = getLatestSubagentRunByChildSessionKey(params.entry.childSessionKey);
+	if (!currentEntry || currentEntry.runId !== params.entry.runId) return {
+		status: "done",
+		runId: params.entry.runId,
+		text: `${resolveSubagentLabel(params.entry)} is already finished.`
+	};
+	const targetSessionKey = params.entry.childSessionKey;
+	const parsed = parseAgentSessionKey(targetSessionKey);
+	const targetSessionEntry = loadSessionStore(resolveStorePath(params.cfg.session?.store, { agentId: parsed?.agentId }))[targetSessionKey];
+	const targetSessionId = typeof targetSessionEntry?.sessionId === "string" && targetSessionEntry.sessionId.trim() ? targetSessionEntry.sessionId.trim() : void 0;
+	const idempotencyKey = crypto.randomUUID();
+	let runId = idempotencyKey;
+	try {
+		const baselineReply = await readLatestAssistantReplySnapshot({
+			sessionKey: targetSessionKey,
+			limit: SUBAGENT_REPLY_HISTORY_LIMIT,
+			callGateway: subagentControlDeps.callGateway
+		});
+		const response = await subagentControlDeps.callGateway({
+			method: "agent",
+			params: {
+				message: params.message,
+				sessionKey: targetSessionKey,
+				sessionId: targetSessionId,
+				idempotencyKey,
+				deliver: false,
+				channel: INTERNAL_MESSAGE_CHANNEL,
+				lane: AGENT_LANE_SUBAGENT,
+				timeout: 0
+			},
+			timeoutMs: 1e4
+		});
+		const responseRunId = typeof response?.runId === "string" ? response.runId : void 0;
+		if (responseRunId) runId = responseRunId;
+		const result = await waitForAgentRunAndReadUpdatedAssistantReply({
+			runId,
+			sessionKey: targetSessionKey,
+			timeoutMs: 3e4,
+			limit: SUBAGENT_REPLY_HISTORY_LIMIT,
+			baseline: baselineReply,
+			callGateway: subagentControlDeps.callGateway
+		});
+		if (result.status === "timeout") return {
+			status: "timeout",
+			runId
+		};
+		if (result.status === "error") return {
+			status: "error",
+			runId,
+			error: result.error ?? "unknown error"
+		};
+		return {
+			status: "ok",
+			runId,
+			replyText: result.replyText
+		};
+	} catch (err) {
+		const error = formatErrorMessage(err);
+		return {
+			status: "error",
+			runId,
+			error
+		};
+	}
+}
+function resolveControlledSubagentTarget(runs, token, options) {
+	return resolveSubagentTargetFromRuns({
+		runs,
+		token,
+		recentWindowMinutes: options?.recentMinutes ?? 30,
+		label: (entry) => resolveSubagentLabel(entry),
+		aliases: (entry) => entry.taskName ? [entry.taskName] : [],
+		isActive: options?.isActive,
+		errors: {
+			missingTarget: "Missing subagent target.",
+			invalidIndex: (value) => `Invalid subagent index: ${value}`,
+			unknownSession: (value) => `Unknown subagent session: ${value}`,
+			ambiguousLabel: (value) => `Ambiguous subagent label: ${value}`,
+			ambiguousLabelPrefix: (value) => `Ambiguous subagent label prefix: ${value}`,
+			ambiguousRunIdPrefix: (value) => `Ambiguous subagent run id prefix: ${value}`,
+			unknownTarget: (value) => `Unknown subagent target: ${value}`
+		}
+	});
+}
+//#endregion
+export { killSubagentRunAdmin as a, resolveSubagentController as c, killControlledSubagentRun as i, sendControlledSubagentMessage as l, MAX_STEER_MESSAGE_CHARS as n, listControlledSubagentRuns as o, killAllControlledSubagentRuns as r, resolveControlledSubagentTarget as s, MAX_RECENT_MINUTES as t, steerControlledSubagentRun as u };

package/dist/subagent-hooks-BUKvlYGi.js

@@ -0,0 +1,2 @@
+import { n as handleMatrixSubagentEnded, r as handleMatrixSubagentSpawning, t as handleMatrixSubagentDeliveryTarget } from "./subagent-hooks-D-6S1mpG.js";
+export { handleMatrixSubagentDeliveryTarget, handleMatrixSubagentEnded, handleMatrixSubagentSpawning };

package/dist/subagent-hooks-CwwuJtIN.js

@@ -0,0 +1,2 @@
+import { n as handleFeishuSubagentEnded, r as handleFeishuSubagentSpawning, t as handleFeishuSubagentDeliveryTarget } from "./subagent-hooks-DKrXETX6.js";
+export { handleFeishuSubagentDeliveryTarget, handleFeishuSubagentEnded, handleFeishuSubagentSpawning };

package/dist/subagent-hooks-D-6S1mpG.js

@@ -0,0 +1,146 @@
+import { c as normalizeOptionalString } from "./string-coerce-DyL154ka.js";
+import "./account-id-B32J-iNN.js";
+import { n as getSessionBindingService } from "./session-binding-service-Dt5NxtK1.js";
+import { n as formatThreadBindingSpawnDisabledError, t as formatThreadBindingDisabledError, u as resolveThreadBindingSpawnPolicy } from "./thread-bindings-policy-BZBsdp3j.js";
+import "./string-coerce-runtime-DcopKqDR.js";
+import "./conversation-binding-runtime-DUU8Cbqn.js";
+import "./conversation-runtime-DPrqAWle.js";
+import { a as resolveMatrixTargetIdentity } from "./target-ids-1sTIwV96.js";
+import { a as listBindingsForAccount, c as resolveBindingKey, i as listAllBindings, n as getMatrixThreadBindingManager, o as removeBindingRecord } from "./thread-bindings-shared-Cw37PDuX.js";
+//#region extensions/matrix/src/matrix/subagent-hooks.ts
+function summarizeError(err) {
+	if (err instanceof Error) return err.message;
+	if (typeof err === "string") return err;
+	return "error";
+}
+function resolveMatrixBindingThreadId(binding) {
+	const { conversationId, parentConversationId } = binding.conversation;
+	return parentConversationId && parentConversationId !== conversationId ? conversationId : void 0;
+}
+function resolveMatrixBindingDeliveryOrigin(binding, fallbackAccountId) {
+	const boundRoomId = binding.conversation.parentConversationId ?? binding.conversation.conversationId;
+	const threadId = resolveMatrixBindingThreadId(binding);
+	return {
+		channel: "matrix",
+		accountId: binding.conversation.accountId ?? fallbackAccountId,
+		to: `room:${boundRoomId}`,
+		...threadId ? { threadId } : {}
+	};
+}
+async function handleMatrixSubagentSpawning(api, event) {
+	if (!event.threadRequested) return;
+	if (event.requester?.channel?.trim().toLowerCase() !== "matrix") return;
+	const accountId = normalizeOptionalString(event.requester?.accountId) || "default";
+	const policy = resolveThreadBindingSpawnPolicy({
+		cfg: api.config,
+		channel: "matrix",
+		accountId,
+		kind: "subagent"
+	});
+	if (!policy.enabled) return {
+		status: "error",
+		error: formatThreadBindingDisabledError({
+			channel: policy.channel,
+			accountId: policy.accountId,
+			kind: "subagent"
+		})
+	};
+	if (!policy.spawnEnabled) return {
+		status: "error",
+		error: formatThreadBindingSpawnDisabledError({
+			channel: policy.channel,
+			accountId: policy.accountId,
+			kind: "subagent"
+		})
+	};
+	const rawTo = normalizeOptionalString(event.requester?.to) ?? "";
+	const matrixTarget = rawTo ? resolveMatrixTargetIdentity(rawTo) : null;
+	const roomId = matrixTarget?.kind === "room" ? matrixTarget.id : "";
+	if (!roomId) return {
+		status: "error",
+		error: "Cannot create Matrix thread binding: no room target in spawn request (requester.to must be a Matrix room ID)."
+	};
+	const bindingService = getSessionBindingService();
+	const capabilities = bindingService.getCapabilities({
+		channel: "matrix",
+		accountId
+	});
+	if (!capabilities.adapterAvailable || !capabilities.bindSupported) return {
+		status: "error",
+		error: `No Matrix session binding adapter available for account "${accountId}". Is the Matrix channel running?`
+	};
+	if (!capabilities.placements.includes("child")) return {
+		status: "error",
+		error: `Matrix session binding adapter for account "${accountId}" does not support child thread bindings.`
+	};
+	try {
+		return {
+			status: "ok",
+			threadBindingReady: true,
+			deliveryOrigin: resolveMatrixBindingDeliveryOrigin(await bindingService.bind({
+				targetSessionKey: event.childSessionKey,
+				targetKind: "subagent",
+				conversation: {
+					channel: "matrix",
+					accountId,
+					conversationId: roomId
+				},
+				placement: "child",
+				metadata: {
+					agentId: event.agentId?.trim() || void 0,
+					label: normalizeOptionalString(event.label) || void 0,
+					boundBy: "system"
+				}
+			}), accountId)
+		};
+	} catch (err) {
+		return {
+			status: "error",
+			error: `Matrix thread bind failed: ${summarizeError(err)}`
+		};
+	}
+}
+async function handleMatrixSubagentEnded(event) {
+	const accountId = normalizeOptionalString(event.accountId) || void 0;
+	const matching = (accountId ? listBindingsForAccount(accountId) : listAllBindings()).filter((entry) => entry.targetSessionKey === event.targetSessionKey && entry.targetKind === "subagent");
+	const removedBindingKeys = /* @__PURE__ */ new Set();
+	if (event.sendFarewell) {
+		const bindingService = getSessionBindingService();
+		const reason = normalizeOptionalString(event.reason) || "subagent-ended";
+		for (const binding of matching) {
+			const bindingId = resolveBindingKey(binding);
+			if ((await bindingService.unbind({
+				bindingId,
+				reason
+			})).some((entry) => entry.bindingId === bindingId)) removedBindingKeys.add(bindingId);
+		}
+	}
+	const affectedAccountIds = /* @__PURE__ */ new Set();
+	for (const binding of matching) {
+		if (removedBindingKeys.has(resolveBindingKey(binding))) continue;
+		if (removeBindingRecord(binding)) affectedAccountIds.add(binding.accountId);
+	}
+	for (const acctId of affectedAccountIds) await getMatrixThreadBindingManager(acctId)?.persist();
+}
+function handleMatrixSubagentDeliveryTarget(event) {
+	if (!event.expectsCompletionMessage) return;
+	if (event.requesterOrigin?.channel?.trim().toLowerCase() !== "matrix") return;
+	const requesterAccountId = normalizeOptionalString(event.requesterOrigin?.accountId);
+	const requesterThreadId = event.requesterOrigin?.threadId != null && event.requesterOrigin.threadId !== "" ? String(event.requesterOrigin.threadId).trim() : "";
+	const bindings = (requesterAccountId ? listBindingsForAccount(requesterAccountId) : listAllBindings()).filter((entry) => entry.targetSessionKey === event.childSessionKey && entry.targetKind === "subagent");
+	if (bindings.length === 0) return;
+	let binding;
+	if (requesterThreadId) binding = bindings.find((entry) => entry.conversationId === requesterThreadId && (!requesterAccountId || entry.accountId === requesterAccountId));
+	if (!binding && bindings.length === 1) binding = bindings[0];
+	if (!binding) return;
+	const roomId = binding.parentConversationId ?? binding.conversationId;
+	const threadId = binding.parentConversationId && binding.parentConversationId !== binding.conversationId ? binding.conversationId : void 0;
+	return { origin: {
+		channel: "matrix",
+		accountId: binding.accountId,
+		to: `room:${roomId}`,
+		...threadId ? { threadId } : {}
+	} };
+}
+//#endregion
+export { handleMatrixSubagentEnded as n, handleMatrixSubagentSpawning as r, handleMatrixSubagentDeliveryTarget as t };

package/dist/subagent-hooks-DK4O9DHY.js

@@ -0,0 +1,2 @@
+import { n as handleDiscordSubagentEnded, r as handleDiscordSubagentSpawning, t as handleDiscordSubagentDeliveryTarget } from "./subagent-hooks-RtDD-o7f.js";
+export { handleDiscordSubagentDeliveryTarget, handleDiscordSubagentEnded, handleDiscordSubagentSpawning };