@openclaw/matrix 2026.7.2-beta.5 → 2026.7.33

package/dist/storage-paths-gUmSydsW.js

@@ -1,41 +0,0 @@
-import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import crypto from "node:crypto";
-import path from "node:path";
-//#region extensions/matrix/src/storage-paths.ts
-function sanitizeMatrixPathSegment(value) {
-	return normalizeLowercaseStringOrEmpty(value).replace(/[^a-z0-9._-]+/g, "_").replace(/^_+|_+$/g, "") || "unknown";
-}
-function resolveMatrixHomeserverKey(homeserver) {
-	try {
-		const url = new URL(homeserver);
-		if (url.host) return sanitizeMatrixPathSegment(url.host);
-	} catch {}
-	return sanitizeMatrixPathSegment(homeserver);
-}
-function hashMatrixAccessToken(accessToken) {
-	return crypto.createHash("sha256").update(accessToken).digest("hex").slice(0, 16);
-}
-function resolveMatrixCredentialsFilename(accountId) {
-	const normalized = normalizeAccountId(accountId);
-	return normalized === DEFAULT_ACCOUNT_ID ? "credentials.json" : `credentials-${normalized}.json`;
-}
-function resolveMatrixCredentialsDir(stateDir) {
-	return path.join(stateDir, "credentials", "matrix");
-}
-function resolveMatrixCredentialsPath(params) {
-	return path.join(resolveMatrixCredentialsDir(params.stateDir), resolveMatrixCredentialsFilename(params.accountId));
-}
-function resolveMatrixAccountStorageRoot(params) {
-	const accountKey = sanitizeMatrixPathSegment(params.accountId ?? DEFAULT_ACCOUNT_ID);
-	const userKey = sanitizeMatrixPathSegment(params.userId);
-	const serverKey = resolveMatrixHomeserverKey(params.homeserver);
-	const tokenHash = hashMatrixAccessToken(params.accessToken);
-	return {
-		rootDir: path.join(params.stateDir, "matrix", "accounts", accountKey, `${serverKey}__${userKey}`, tokenHash),
-		accountKey,
-		tokenHash
-	};
-}
-//#endregion
-export { resolveMatrixCredentialsPath as a, resolveMatrixCredentialsFilename as i, resolveMatrixAccountStorageRoot as n, resolveMatrixHomeserverKey as o, resolveMatrixCredentialsDir as r, sanitizeMatrixPathSegment as s, hashMatrixAccessToken as t };

package/dist/subagent-hooks-dkPAF6Et.js

@@ -1,143 +0,0 @@
-import { a as resolveMatrixTargetIdentity } from "./target-ids-B-5aQxwn.js";
-import { a as listBindingsForAccount, c as resolveBindingKey, i as listAllBindings, n as getMatrixThreadBindingManager, o as removeBindingRecord } from "./thread-bindings-shared-CKnY4LSd.js";
-import { formatThreadBindingDisabledError, formatThreadBindingSpawnDisabledError, resolveThreadBindingSpawnPolicy } from "openclaw/plugin-sdk/conversation-runtime";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
-import { getSessionBindingService } from "openclaw/plugin-sdk/conversation-binding-runtime";
-//#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_ACCOUNT_ID;
-	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 { handleMatrixSubagentDeliveryTarget, handleMatrixSubagentEnded, handleMatrixSubagentSpawning };

package/dist/thread-binding-api-DRbBZlhS.js

@@ -1,17 +0,0 @@
-import { a as resolveMatrixTargetIdentity } from "./target-ids-B-5aQxwn.js";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-//#region extensions/matrix/src/thread-binding-api.ts
-const defaultTopLevelPlacement = "child";
-function resolveMatrixInboundConversation(params) {
-	const rawTarget = params.to?.trim() || params.conversationId?.trim() || "";
-	const target = rawTarget ? resolveMatrixTargetIdentity(rawTarget) : null;
-	const parentConversationId = target?.kind === "room" ? target.id : void 0;
-	const threadId = params.threadId != null ? normalizeOptionalString(String(params.threadId)) : void 0;
-	if (threadId) return {
-		conversationId: threadId,
-		...parentConversationId ? { parentConversationId } : {}
-	};
-	return parentConversationId ? { conversationId: parentConversationId } : null;
-}
-//#endregion
-export { resolveMatrixInboundConversation as n, defaultTopLevelPlacement as t };

package/dist/thread-bindings-D3RfVgAF.js

@@ -1,436 +0,0 @@
-import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { a as listBindingsForAccount, c as resolveBindingKey, f as setMatrixThreadBindingManagerEntry, h as toSessionBindingRecord, l as resolveEffectiveBindingExpiry, m as toMatrixBindingTargetKind, o as removeBindingRecord, r as getMatrixThreadBindingManagerEntry, t as deleteMatrixThreadBindingManagerEntry, u as setBindingRecord } from "./thread-bindings-shared-CKnY4LSd.js";
-import { M as resolveMatrixSqliteStateEnv, N as resolveMatrixSqliteStateKey, c as resolveMatrixStateFilePath, t as claimCurrentTokenStorageState } from "./storage-BvAkgzvT.js";
-import { r as sendMessageMatrix } from "./send-C9Ssx-iV.js";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { createHash } from "node:crypto";
-import path from "node:path";
-import { registerSessionBindingAdapter, resolveThreadBindingFarewellText, unregisterSessionBindingAdapter } from "openclaw/plugin-sdk/thread-bindings-session-runtime";
-import fs from "node:fs/promises";
-import { resolveDefaultAgentId } from "openclaw/plugin-sdk/agent-runtime";
-import { readJsonFileWithFallback } from "openclaw/plugin-sdk/json-store";
-import { resolveAgentIdFromSessionKey } from "openclaw/plugin-sdk/session-key-runtime";
-//#region extensions/matrix/src/matrix/thread-bindings.ts
-const STORE_VERSION = 1;
-const THREAD_BINDINGS_NAMESPACE = "thread-bindings";
-const THREAD_BINDINGS_MIGRATIONS_NAMESPACE = "thread-bindings-migrations";
-const THREAD_BINDINGS_MAX_ENTRIES = 1e4;
-const THREAD_BINDINGS_SWEEP_INTERVAL_MS = 6e4;
-const TOUCH_PERSIST_DELAY_MS = 3e4;
-function resolveBindingsPath(params) {
-	return resolveMatrixStateFilePath({
-		auth: params.auth,
-		accountId: params.accountId,
-		env: params.env,
-		stateDir: params.stateDir,
-		filename: "thread-bindings.json"
-	});
-}
-function createThreadBindingStore(params) {
-	return getMatrixRuntime().state.openKeyedStore({
-		namespace: THREAD_BINDINGS_NAMESPACE,
-		maxEntries: THREAD_BINDINGS_MAX_ENTRIES,
-		env: resolveMatrixSqliteStateEnv(params)
-	});
-}
-function createThreadBindingMigrationStore(params) {
-	return getMatrixRuntime().state.openKeyedStore({
-		namespace: THREAD_BINDINGS_MIGRATIONS_NAMESPACE,
-		maxEntries: 1e3,
-		env: resolveMatrixSqliteStateEnv(params)
-	});
-}
-function buildThreadBindingStoreKey(record) {
-	const digest = createHash("sha256").update(record.accountId).update("\0").update(record.parentConversationId ?? "").update("\0").update(record.conversationId).digest("hex");
-	return `${record.accountId}:${digest}`;
-}
-function buildLegacyThreadBindingsImportKey(params) {
-	const digest = createHash("sha256").update(params.accountId).update("\0").update(params.legacyFilePath).digest("hex");
-	return `${params.accountId}:${digest}`;
-}
-function normalizeBindingRecord(entry, accountId) {
-	if (!entry || typeof entry !== "object" || Array.isArray(entry)) return null;
-	const record = entry;
-	if (record.accountId && record.accountId !== accountId) return null;
-	const conversationId = normalizeOptionalString(record.conversationId);
-	const parentConversationId = normalizeOptionalString(record.parentConversationId);
-	const targetSessionKey = normalizeOptionalString(record.targetSessionKey) ?? "";
-	if (!conversationId || !targetSessionKey) return null;
-	const boundAt = typeof record.boundAt === "number" && Number.isFinite(record.boundAt) ? Math.floor(record.boundAt) : Date.now();
-	const lastActivityAt = typeof record.lastActivityAt === "number" && Number.isFinite(record.lastActivityAt) ? Math.floor(record.lastActivityAt) : boundAt;
-	return {
-		accountId,
-		conversationId,
-		...parentConversationId ? { parentConversationId } : {},
-		targetKind: record.targetKind === "subagent" ? "subagent" : "acp",
-		targetSessionKey,
-		agentId: normalizeOptionalString(record.agentId) || void 0,
-		label: normalizeOptionalString(record.label) || void 0,
-		boundBy: normalizeOptionalString(record.boundBy) || void 0,
-		boundAt,
-		lastActivityAt: Math.max(lastActivityAt, boundAt),
-		idleTimeoutMs: typeof record.idleTimeoutMs === "number" && Number.isFinite(record.idleTimeoutMs) ? Math.max(0, Math.floor(record.idleTimeoutMs)) : void 0,
-		maxAgeMs: typeof record.maxAgeMs === "number" && Number.isFinite(record.maxAgeMs) ? Math.max(0, Math.floor(record.maxAgeMs)) : void 0
-	};
-}
-async function loadBindingsFromLegacyDisk(filePath, accountId) {
-	const { value } = await readJsonFileWithFallback(filePath, null);
-	if (value?.version !== STORE_VERSION || !Array.isArray(value.bindings)) return [];
-	const loaded = [];
-	for (const entry of value.bindings) {
-		const record = normalizeBindingRecord(entry, accountId);
-		if (record) loaded.push(record);
-	}
-	return loaded;
-}
-async function loadBindingsFromPluginState(params) {
-	const store = createThreadBindingStore(params);
-	const loaded = [];
-	for (const entry of await store.entries()) {
-		const record = normalizeBindingRecord(entry.value, params.accountId);
-		if (record) loaded.push(record);
-	}
-	return loaded;
-}
-function toPluginJsonValue(value) {
-	const serialized = JSON.stringify(value);
-	return JSON.parse(serialized);
-}
-async function persistBindingsSnapshot(params) {
-	const store = createThreadBindingStore(params);
-	const liveKeys = new Set(params.bindings.map((record) => buildThreadBindingStoreKey(record)));
-	for (const entry of await store.entries()) if (normalizeBindingRecord(entry.value, params.accountId) && !liveKeys.has(entry.key)) await store.delete(entry.key);
-	for (const record of params.bindings) await store.register(buildThreadBindingStoreKey(record), toPluginJsonValue(record));
-}
-function buildMatrixBindingIntroText(params) {
-	const introText = normalizeOptionalString(params.metadata?.introText);
-	if (introText) return introText;
-	const label = normalizeOptionalString(params.metadata?.label);
-	const agentId = normalizeOptionalString(params.metadata?.agentId) || resolveAgentIdFromSessionKey(params.targetSessionKey);
-	return `⚙️ ${label || agentId || "session"} session active. Messages here go directly to this session.`;
-}
-async function sendBindingMessage(params) {
-	const trimmed = params.text.trim();
-	if (!trimmed) return null;
-	return (await sendMessageMatrix(`room:${params.roomId}`, trimmed, {
-		cfg: params.cfg,
-		client: params.client,
-		accountId: params.accountId,
-		...params.threadId ? { threadId: params.threadId } : {}
-	})).messageId || null;
-}
-async function sendFarewellMessage(params) {
-	const roomId = params.record.parentConversationId ?? params.record.conversationId;
-	const idleTimeoutMs = typeof params.record.idleTimeoutMs === "number" ? params.record.idleTimeoutMs : params.defaultIdleTimeoutMs;
-	const maxAgeMs = typeof params.record.maxAgeMs === "number" ? params.record.maxAgeMs : params.defaultMaxAgeMs;
-	const farewellText = resolveThreadBindingFarewellText({
-		reason: params.reason,
-		idleTimeoutMs,
-		maxAgeMs
-	});
-	await sendBindingMessage({
-		cfg: params.cfg,
-		client: params.client,
-		accountId: params.accountId,
-		roomId,
-		threadId: params.record.parentConversationId && params.record.parentConversationId !== params.record.conversationId ? params.record.conversationId : void 0,
-		text: farewellText
-	}).catch(() => {});
-}
-async function createMatrixThreadBindingManager(params) {
-	if (params.auth.accountId !== params.accountId) throw new Error(`Matrix thread binding account mismatch: requested ${params.accountId}, auth resolved ${params.auth.accountId}`);
-	const legacyFilePath = resolveBindingsPath({
-		auth: params.auth,
-		accountId: params.accountId,
-		env: params.env,
-		stateDir: params.stateDir
-	});
-	const sqliteStateDir = path.dirname(legacyFilePath);
-	const storageKey = resolveMatrixSqliteStateKey({
-		env: params.env,
-		stateDir: sqliteStateDir
-	});
-	const existingEntry = getMatrixThreadBindingManagerEntry(params.accountId);
-	if (existingEntry) {
-		if (existingEntry.storageKey === storageKey) return existingEntry.manager;
-		existingEntry.manager.stop();
-	}
-	const pluginLoaded = await loadBindingsFromPluginState({
-		accountId: params.accountId,
-		env: params.env,
-		stateDir: sqliteStateDir
-	});
-	const migrationStore = createThreadBindingMigrationStore({
-		env: params.env,
-		stateDir: sqliteStateDir
-	});
-	const legacyImportKey = buildLegacyThreadBindingsImportKey({
-		accountId: params.accountId,
-		legacyFilePath
-	});
-	const pluginLoadedKeys = new Set(pluginLoaded.map((record) => buildThreadBindingStoreKey(record)));
-	let legacyHadRows = false;
-	let legacyLoaded = [];
-	if (!await migrationStore.lookup(legacyImportKey)) {
-		const legacyCandidates = await loadBindingsFromLegacyDisk(legacyFilePath, params.accountId);
-		legacyHadRows = legacyCandidates.length > 0;
-		legacyLoaded = legacyCandidates.filter((record) => !pluginLoadedKeys.has(buildThreadBindingStoreKey(record)));
-	}
-	const loaded = [...pluginLoaded, ...legacyLoaded];
-	for (const record of loaded) setBindingRecord(record);
-	let persistQueue = Promise.resolve();
-	const enqueuePersist = (bindings) => {
-		const snapshot = bindings ?? listBindingsForAccount(params.accountId);
-		const next = persistQueue.catch(() => {}).then(async () => {
-			await persistBindingsSnapshot({
-				accountId: params.accountId,
-				bindings: snapshot,
-				env: params.env,
-				stateDir: sqliteStateDir
-			});
-			claimCurrentTokenStorageState({ rootDir: sqliteStateDir });
-		});
-		persistQueue = next;
-		return next;
-	};
-	const persist = async () => await enqueuePersist();
-	const persistSafely = (reason, bindings) => {
-		enqueuePersist(bindings).catch((err) => {
-			params.logVerboseMessage?.(`matrix: failed persisting thread bindings account=${params.accountId} action=${reason}: ${String(err)}`);
-		});
-	};
-	const defaults = {
-		idleTimeoutMs: params.idleTimeoutMs,
-		maxAgeMs: params.maxAgeMs
-	};
-	if (legacyHadRows) {
-		if (legacyLoaded.length > 0) await persist();
-		await migrationStore.register(legacyImportKey, { importedAt: Date.now() });
-		await fs.rm(legacyFilePath, { force: true }).catch((err) => {
-			params.logVerboseMessage?.(`matrix: failed removing migrated legacy thread bindings account=${params.accountId}: ${String(err)}`);
-		});
-	}
-	let persistTimer = null;
-	const schedulePersist = (delayMs) => {
-		if (persistTimer) return;
-		persistTimer = setTimeout(() => {
-			persistTimer = null;
-			persistSafely("delayed-touch");
-		}, delayMs);
-		persistTimer.unref?.();
-	};
-	const updateBindingsBySessionKey = (input) => {
-		const targetSessionKey = input.targetSessionKey.trim();
-		if (!targetSessionKey) return [];
-		const now = Date.now();
-		const nextBindings = listBindingsForAccount(params.accountId).filter((entry) => entry.targetSessionKey === targetSessionKey).map((entry) => input.update(entry, now));
-		if (nextBindings.length === 0) return [];
-		for (const entry of nextBindings) setBindingRecord(entry);
-		persistSafely(input.persistReason);
-		return nextBindings;
-	};
-	const manager = {
-		accountId: params.accountId,
-		getIdleTimeoutMs: () => defaults.idleTimeoutMs,
-		getMaxAgeMs: () => defaults.maxAgeMs,
-		persist,
-		getByConversation: ({ conversationId, parentConversationId }) => listBindingsForAccount(params.accountId).find((entry) => {
-			if (entry.conversationId !== conversationId.trim()) return false;
-			if (!parentConversationId) return true;
-			return (entry.parentConversationId ?? "") === parentConversationId.trim();
-		}),
-		listBySessionKey: (targetSessionKey) => listBindingsForAccount(params.accountId).filter((entry) => entry.targetSessionKey === targetSessionKey.trim()),
-		listBindings: () => listBindingsForAccount(params.accountId),
-		touchBinding: (bindingId, at) => {
-			const record = listBindingsForAccount(params.accountId).find((entry) => resolveBindingKey(entry) === bindingId.trim());
-			if (!record) return null;
-			const nextRecord = {
-				...record,
-				lastActivityAt: typeof at === "number" && Number.isFinite(at) ? Math.max(record.lastActivityAt, Math.floor(at)) : Date.now()
-			};
-			setBindingRecord(nextRecord);
-			schedulePersist(TOUCH_PERSIST_DELAY_MS);
-			return nextRecord;
-		},
-		setIdleTimeoutBySessionKey: ({ targetSessionKey, idleTimeoutMs }) => {
-			return updateBindingsBySessionKey({
-				targetSessionKey,
-				persistReason: "idle-timeout-update",
-				update: (entry, now) => ({
-					...entry,
-					idleTimeoutMs: Math.max(0, Math.floor(idleTimeoutMs)),
-					lastActivityAt: now
-				})
-			});
-		},
-		setMaxAgeBySessionKey: ({ targetSessionKey, maxAgeMs }) => {
-			return updateBindingsBySessionKey({
-				targetSessionKey,
-				persistReason: "max-age-update",
-				update: (entry, now) => ({
-					...entry,
-					maxAgeMs: Math.max(0, Math.floor(maxAgeMs)),
-					lastActivityAt: now
-				})
-			});
-		},
-		stop: () => {
-			if (sweepTimer) clearInterval(sweepTimer);
-			if (persistTimer) {
-				clearTimeout(persistTimer);
-				persistTimer = null;
-				persistSafely("shutdown-flush");
-			}
-			unregisterSessionBindingAdapter({
-				channel: "matrix",
-				accountId: params.accountId,
-				adapter: sessionBindingAdapter
-			});
-			if (getMatrixThreadBindingManagerEntry(params.accountId)?.manager === manager) deleteMatrixThreadBindingManagerEntry(params.accountId);
-			for (const record of listBindingsForAccount(params.accountId)) removeBindingRecord(record);
-		}
-	};
-	let sweepTimer = null;
-	const removeRecords = (records) => {
-		if (records.length === 0) return [];
-		return records.map((record) => removeBindingRecord(record)).filter((record) => Boolean(record));
-	};
-	const sendFarewellMessages = async (removed, reason) => {
-		await Promise.all(removed.map(async (record) => {
-			await sendFarewellMessage({
-				cfg: params.cfg,
-				client: params.client,
-				accountId: params.accountId,
-				record,
-				defaultIdleTimeoutMs: defaults.idleTimeoutMs,
-				defaultMaxAgeMs: defaults.maxAgeMs,
-				reason: typeof reason === "function" ? reason(record) : reason
-			});
-		}));
-	};
-	const unbindRecords = async (records, reason) => {
-		const removed = removeRecords(records);
-		if (removed.length === 0) return [];
-		await persist();
-		await sendFarewellMessages(removed, reason);
-		return removed.map((record) => toSessionBindingRecord(record, defaults));
-	};
-	const sessionBindingAdapter = {
-		channel: "matrix",
-		accountId: params.accountId,
-		capabilities: {
-			placements: ["current", "child"],
-			bindSupported: true,
-			unbindSupported: true
-		},
-		bind: async (input) => {
-			const conversationId = input.conversation.conversationId.trim();
-			const parentConversationId = normalizeOptionalString(input.conversation.parentConversationId);
-			const targetSessionKey = input.targetSessionKey.trim();
-			if (!conversationId || !targetSessionKey) return null;
-			let boundConversationId = conversationId;
-			let boundParentConversationId = parentConversationId;
-			const introText = buildMatrixBindingIntroText({
-				metadata: input.metadata,
-				targetSessionKey
-			});
-			if (input.placement === "child") {
-				const roomId = parentConversationId || conversationId;
-				const rootEventId = await sendBindingMessage({
-					cfg: params.cfg,
-					client: params.client,
-					accountId: params.accountId,
-					roomId,
-					text: introText
-				});
-				if (!rootEventId) return null;
-				boundConversationId = rootEventId;
-				boundParentConversationId = roomId;
-			}
-			const now = Date.now();
-			const record = {
-				accountId: params.accountId,
-				conversationId: boundConversationId,
-				...boundParentConversationId ? { parentConversationId: boundParentConversationId } : {},
-				targetKind: toMatrixBindingTargetKind(input.targetKind),
-				targetSessionKey,
-				agentId: normalizeOptionalString(input.metadata?.agentId) || resolveAgentIdFromSessionKey(targetSessionKey, resolveDefaultAgentId(params.cfg)),
-				label: normalizeOptionalString(input.metadata?.label) || void 0,
-				boundBy: normalizeOptionalString(input.metadata?.boundBy) || "system",
-				boundAt: now,
-				lastActivityAt: now,
-				idleTimeoutMs: defaults.idleTimeoutMs,
-				maxAgeMs: defaults.maxAgeMs
-			};
-			setBindingRecord(record);
-			await persist();
-			if (input.placement === "current" && introText) {
-				const roomId = boundParentConversationId || boundConversationId;
-				const threadId = boundParentConversationId && boundParentConversationId !== boundConversationId ? boundConversationId : void 0;
-				await sendBindingMessage({
-					cfg: params.cfg,
-					client: params.client,
-					accountId: params.accountId,
-					roomId,
-					threadId,
-					text: introText
-				}).catch(() => {});
-			}
-			return toSessionBindingRecord(record, defaults);
-		},
-		listBySession: (targetSessionKey) => manager.listBySessionKey(targetSessionKey).map((record) => toSessionBindingRecord(record, defaults)),
-		resolveByConversation: (ref) => {
-			const record = manager.getByConversation({
-				conversationId: ref.conversationId,
-				parentConversationId: ref.parentConversationId
-			});
-			return record ? toSessionBindingRecord(record, defaults) : null;
-		},
-		touch: (bindingId, at) => {
-			manager.touchBinding(bindingId, at);
-		},
-		unbind: async (input) => {
-			return await unbindRecords(listBindingsForAccount(params.accountId).filter((record) => {
-				if (input.bindingId?.trim()) return resolveBindingKey(record) === input.bindingId.trim();
-				if (input.targetSessionKey?.trim()) return record.targetSessionKey === input.targetSessionKey.trim();
-				return false;
-			}), input.reason);
-		}
-	};
-	registerSessionBindingAdapter(sessionBindingAdapter);
-	if (params.enableSweeper !== false) {
-		sweepTimer = setInterval(() => {
-			const now = Date.now();
-			const expired = listBindingsForAccount(params.accountId).map((record) => ({
-				record,
-				lifecycle: resolveEffectiveBindingExpiry({
-					record,
-					defaultIdleTimeoutMs: defaults.idleTimeoutMs,
-					defaultMaxAgeMs: defaults.maxAgeMs
-				})
-			})).filter((entry) => typeof entry.lifecycle.expiresAt === "number" && entry.lifecycle.expiresAt <= now && Boolean(entry.lifecycle.reason));
-			if (expired.length === 0) return;
-			const reasonByBindingKey = new Map(expired.map(({ record, lifecycle }) => [resolveBindingKey(record), lifecycle.reason]));
-			(async () => {
-				const removed = removeRecords(expired.map(({ record }) => record));
-				if (removed.length === 0) return;
-				for (const record of removed) {
-					const reason = reasonByBindingKey.get(resolveBindingKey(record));
-					params.logVerboseMessage?.(`matrix: auto-unbinding ${record.conversationId} due to ${reason}`);
-				}
-				await persist();
-				await sendFarewellMessages(removed, (record) => reasonByBindingKey.get(resolveBindingKey(record)));
-			})().catch((err) => {
-				params.logVerboseMessage?.(`matrix: failed auto-unbinding expired bindings account=${params.accountId}: ${String(err)}`);
-			});
-		}, THREAD_BINDINGS_SWEEP_INTERVAL_MS);
-		sweepTimer.unref?.();
-	}
-	setMatrixThreadBindingManagerEntry(params.accountId, {
-		storageKey,
-		manager
-	});
-	return manager;
-}
-//#endregion
-export { createMatrixThreadBindingManager as t };