@xopcai/xopc 0.0.86 → 0.0.88

package/dist/src/routing/agent-session-key.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OpenClaw-aligned agent session keys: `agent:{agentId}:{rest}`
+ */
+export { getSubagentDepth, isAcpSessionKey, isCronSessionKey, isSubagentSessionKey, parseAgentSessionKey, parseThreadSessionSuffix, type ParsedAgentSessionKey, } from './session-key-utils.js';
+export { DEFAULT_ACCOUNT_ID, normalizeAccountId, normalizeOptionalAccountId, } from './account-id.js';
+export declare const DEFAULT_AGENT_ID = "main";
+export declare const DEFAULT_MAIN_KEY = "main";
+export type SessionKeyShape = 'missing' | 'agent' | 'legacy_or_alias' | 'malformed_agent';
+export type PeerKind = 'direct' | 'group' | 'channel' | 'dm';
+export declare function normalizeMainKey(value: string | undefined | null): string;
+export declare function toAgentRequestSessionKey(storeKey: string | undefined | null): string | undefined;
+export declare function toAgentStoreSessionKey(params: {
+    agentId: string;
+    requestKey: string | undefined | null;
+    mainKey?: string | undefined;
+}): string;
+export declare function resolveAgentIdFromSessionKey(sessionKey: string | undefined | null): string;
+export declare function classifySessionKeyShape(sessionKey: string | undefined | null): SessionKeyShape;
+export declare function normalizeAgentId(value: string | undefined | null): string;
+export declare function isValidAgentId(value: string | undefined | null): boolean;
+export declare function sanitizeAgentId(value: string | undefined | null): string;
+export declare function buildAgentMainSessionKey(params: {
+    agentId: string;
+    mainKey?: string | undefined;
+}): string;
+export declare function buildAgentPeerSessionKey(params: {
+    agentId: string;
+    mainKey?: string | undefined;
+    channel: string;
+    accountId?: string | null;
+    peerKind?: PeerKind | null;
+    peerId?: string | null;
+    identityLinks?: Record<string, string[]>;
+    dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';
+}): string;
+export declare function buildGroupHistoryKey(params: {
+    channel: string;
+    accountId?: string | null;
+    peerKind: 'group' | 'channel';
+    peerId: string;
+}): string;
+export declare function resolveThreadSessionKeys(params: {
+    baseSessionKey: string;
+    threadId?: string | null;
+    parentSessionKey?: string;
+    useSuffix?: boolean;
+    normalizeThreadId?: (threadId: string) => string;
+}): {
+    sessionKey: string;
+    parentSessionKey?: string;
+};
+export declare function scopedHeartbeatWakeOptions<T extends object>(sessionKey: string, wakeOptions: T): T | (T & {
+    sessionKey: string;
+});
+/** Default CLI/TUI main session key. */
+export declare function defaultMainSessionKey(agentId?: string, mainKey?: string): string;
+export declare function assertAgentSessionKey(sessionKey: string): void;
+export declare function normalizeSessionKey(sessionKey: string | undefined | null): string;

package/dist/src/routing/agent-session-key.js

@@ -0,0 +1,164 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { DEFAULT_ACCOUNT_ID, init_account_id, normalizeAccountId, normalizeOptionalAccountId } from "./account-id.js";
+import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
+import { getSubagentDepth, init_session_key_utils, isAcpSessionKey, isCronSessionKey, isSubagentSessionKey, parseAgentSessionKey, parseThreadSessionSuffix } from "./session-key-utils.js";
+//#region src/routing/agent-session-key.ts
+function normalizeToken(value) {
+	return normalizeLowercaseStringOrEmpty(value);
+}
+function normalizeMainKey(value) {
+	return normalizeLowercaseStringOrEmpty(value) || "main";
+}
+function toAgentRequestSessionKey(storeKey) {
+	const raw = (storeKey ?? "").trim();
+	if (!raw) return;
+	return parseAgentSessionKey(raw)?.rest ?? raw;
+}
+function toAgentStoreSessionKey(params) {
+	const raw = (params.requestKey ?? "").trim();
+	const lowered = normalizeLowercaseStringOrEmpty(raw);
+	if (!raw || lowered === "main") return buildAgentMainSessionKey({
+		agentId: params.agentId,
+		mainKey: params.mainKey
+	});
+	const parsed = parseAgentSessionKey(raw);
+	if (parsed) return `agent:${parsed.agentId}:${parsed.rest}`;
+	if (lowered.startsWith("agent:")) return lowered;
+	return `agent:${normalizeAgentId(params.agentId)}:${lowered}`;
+}
+function resolveAgentIdFromSessionKey(sessionKey) {
+	return normalizeAgentId(parseAgentSessionKey(sessionKey)?.agentId ?? "main");
+}
+function classifySessionKeyShape(sessionKey) {
+	const raw = (sessionKey ?? "").trim();
+	if (!raw) return "missing";
+	if (parseAgentSessionKey(raw)) return "agent";
+	return normalizeLowercaseStringOrEmpty(raw).startsWith("agent:") ? "malformed_agent" : "legacy_or_alias";
+}
+function normalizeAgentId(value) {
+	const trimmed = (value ?? "").trim();
+	if (!trimmed) return DEFAULT_AGENT_ID;
+	const normalized = normalizeLowercaseStringOrEmpty(trimmed);
+	if (VALID_ID_RE.test(trimmed)) return normalized;
+	return normalized.replace(INVALID_CHARS_RE, "-").replace(LEADING_DASH_RE, "").replace(TRAILING_DASH_RE, "").slice(0, 64) || "main";
+}
+function isValidAgentId(value) {
+	const trimmed = (value ?? "").trim();
+	return Boolean(trimmed) && VALID_ID_RE.test(trimmed);
+}
+function sanitizeAgentId(value) {
+	return normalizeAgentId(value);
+}
+function buildAgentMainSessionKey(params) {
+	return `agent:${normalizeAgentId(params.agentId)}:${normalizeMainKey(params.mainKey)}`;
+}
+function buildAgentPeerSessionKey(params) {
+	const rawKind = params.peerKind ?? "direct";
+	const peerKind = rawKind === "dm" ? "direct" : rawKind;
+	if (peerKind === "direct") {
+		const dmScope = params.dmScope ?? "main";
+		let peerId = (params.peerId ?? "").trim();
+		const linkedPeerId = dmScope === "main" ? null : resolveLinkedPeerId({
+			identityLinks: params.identityLinks,
+			channel: params.channel,
+			peerId
+		});
+		if (linkedPeerId) peerId = linkedPeerId;
+		peerId = normalizeLowercaseStringOrEmpty(peerId);
+		if (dmScope === "per-account-channel-peer" && peerId) {
+			const channel = normalizeLowercaseStringOrEmpty(params.channel) || "unknown";
+			const accountId = normalizeAccountId(params.accountId);
+			return `agent:${normalizeAgentId(params.agentId)}:${channel}:${accountId}:direct:${peerId}`;
+		}
+		if (dmScope === "per-channel-peer" && peerId) {
+			const channel = normalizeLowercaseStringOrEmpty(params.channel) || "unknown";
+			return `agent:${normalizeAgentId(params.agentId)}:${channel}:direct:${peerId}`;
+		}
+		if (dmScope === "per-peer" && peerId) return `agent:${normalizeAgentId(params.agentId)}:direct:${peerId}`;
+		return buildAgentMainSessionKey({
+			agentId: params.agentId,
+			mainKey: params.mainKey
+		});
+	}
+	const channel = normalizeLowercaseStringOrEmpty(params.channel) || "unknown";
+	const peerId = normalizeLowercaseStringOrEmpty(params.peerId) || "unknown";
+	return `agent:${normalizeAgentId(params.agentId)}:${channel}:${peerKind}:${peerId}`;
+}
+function resolveLinkedPeerId(params) {
+	const identityLinks = params.identityLinks;
+	if (!identityLinks) return null;
+	const peerId = params.peerId.trim();
+	if (!peerId) return null;
+	const candidates = /* @__PURE__ */ new Set();
+	const rawCandidate = normalizeToken(peerId);
+	if (rawCandidate) candidates.add(rawCandidate);
+	const channel = normalizeToken(params.channel);
+	if (channel) {
+		const scopedCandidate = normalizeToken(`${channel}:${peerId}`);
+		if (scopedCandidate) candidates.add(scopedCandidate);
+	}
+	if (candidates.size === 0) return null;
+	for (const [canonical, ids] of Object.entries(identityLinks)) {
+		const canonicalName = canonical.trim();
+		if (!canonicalName || !Array.isArray(ids)) continue;
+		for (const id of ids) {
+			const normalized = normalizeToken(id);
+			if (normalized && candidates.has(normalized)) return canonicalName;
+		}
+	}
+	return null;
+}
+function buildGroupHistoryKey(params) {
+	const channel = normalizeToken(params.channel) || "unknown";
+	const accountId = normalizeAccountId(params.accountId);
+	const peerId = normalizeLowercaseStringOrEmpty(params.peerId) || "unknown";
+	return `${channel}:${accountId}:${params.peerKind}:${peerId}`;
+}
+function resolveThreadSessionKeys(params) {
+	const threadId = (params.threadId ?? "").trim();
+	if (!threadId) return {
+		sessionKey: params.baseSessionKey,
+		parentSessionKey: void 0
+	};
+	const normalizedThread = params.normalizeThreadId?.(threadId) ?? normalizeLowercaseStringOrEmpty(threadId);
+	return {
+		sessionKey: params.useSuffix ?? true ? `${params.baseSessionKey}:thread:${normalizedThread}` : params.baseSessionKey,
+		parentSessionKey: params.parentSessionKey
+	};
+}
+function scopedHeartbeatWakeOptions(sessionKey, wakeOptions) {
+	return parseAgentSessionKey(sessionKey) ? {
+		...wakeOptions,
+		sessionKey
+	} : wakeOptions;
+}
+/** Default CLI/TUI main session key. */
+function defaultMainSessionKey(agentId, mainKey) {
+	return buildAgentMainSessionKey({
+		agentId: agentId ?? "main",
+		mainKey
+	});
+}
+function assertAgentSessionKey(sessionKey) {
+	if (!parseAgentSessionKey(sessionKey)) throw new Error(`Invalid agent session key (expected agent:{id}:{rest}): ${sessionKey}`);
+}
+function normalizeSessionKey(sessionKey) {
+	return (sessionKey ?? "").trim().toLowerCase();
+}
+var DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, VALID_ID_RE, INVALID_CHARS_RE, LEADING_DASH_RE, TRAILING_DASH_RE;
+var init_agent_session_key = __esmMin((() => {
+	init_string_coerce();
+	init_account_id();
+	init_session_key_utils();
+	DEFAULT_AGENT_ID = "main";
+	DEFAULT_MAIN_KEY = "main";
+	VALID_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;
+	INVALID_CHARS_RE = /[^a-z0-9_-]+/g;
+	LEADING_DASH_RE = /^-+/;
+	TRAILING_DASH_RE = /-+$/;
+}));
+//#endregion
+init_agent_session_key();
+export { DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, assertAgentSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, buildGroupHistoryKey, classifySessionKeyShape, defaultMainSessionKey, getSubagentDepth, init_agent_session_key, isAcpSessionKey, isCronSessionKey, isSubagentSessionKey, isValidAgentId, normalizeAccountId, normalizeAgentId, normalizeMainKey, normalizeOptionalAccountId, normalizeSessionKey, parseAgentSessionKey, parseThreadSessionSuffix, resolveAgentIdFromSessionKey, resolveThreadSessionKeys, sanitizeAgentId, scopedHeartbeatWakeOptions, toAgentRequestSessionKey, toAgentStoreSessionKey };
+
+//# sourceMappingURL=agent-session-key.js.map

package/dist/src/routing/agent-session-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-key.js","names":[],"sources":["../../../src/routing/agent-session-key.ts"],"sourcesContent":["/**\n * OpenClaw-aligned agent session keys: `agent:{agentId}:{rest}`\n */\n\nimport { normalizeLowercaseStringOrEmpty } from '../utils/string-coerce.js';\nimport { normalizeAccountId } from './account-id.js';\nimport { parseAgentSessionKey } from './session-key-utils.js';\n\nexport {\n  getSubagentDepth,\n  isAcpSessionKey,\n  isCronSessionKey,\n  isSubagentSessionKey,\n  parseAgentSessionKey,\n  parseThreadSessionSuffix,\n  type ParsedAgentSessionKey,\n} from './session-key-utils.js';\nexport {\n  DEFAULT_ACCOUNT_ID,\n  normalizeAccountId,\n  normalizeOptionalAccountId,\n} from './account-id.js';\n\nexport const DEFAULT_AGENT_ID = 'main';\nexport const DEFAULT_MAIN_KEY = 'main';\nexport type SessionKeyShape = 'missing' | 'agent' | 'legacy_or_alias' | 'malformed_agent';\n\nexport type PeerKind = 'direct' | 'group' | 'channel' | 'dm';\n\nconst VALID_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;\nconst INVALID_CHARS_RE = /[^a-z0-9_-]+/g;\nconst LEADING_DASH_RE = /^-+/;\nconst TRAILING_DASH_RE = /-+$/;\n\nfunction normalizeToken(value: string | undefined | null): string {\n  return normalizeLowercaseStringOrEmpty(value);\n}\n\nexport function normalizeMainKey(value: string | undefined | null): string {\n  return normalizeLowercaseStringOrEmpty(value) || DEFAULT_MAIN_KEY;\n}\n\nexport function toAgentRequestSessionKey(storeKey: string | undefined | null): string | undefined {\n  const raw = (storeKey ?? '').trim();\n  if (!raw) {\n    return undefined;\n  }\n  return parseAgentSessionKey(raw)?.rest ?? raw;\n}\n\nexport function toAgentStoreSessionKey(params: {\n  agentId: string;\n  requestKey: string | undefined | null;\n  mainKey?: string | undefined;\n}): string {\n  const raw = (params.requestKey ?? '').trim();\n  const lowered = normalizeLowercaseStringOrEmpty(raw);\n  if (!raw || lowered === DEFAULT_MAIN_KEY) {\n    return buildAgentMainSessionKey({ agentId: params.agentId, mainKey: params.mainKey });\n  }\n  const parsed = parseAgentSessionKey(raw);\n  if (parsed) {\n    return `agent:${parsed.agentId}:${parsed.rest}`;\n  }\n  if (lowered.startsWith('agent:')) {\n    return lowered;\n  }\n  return `agent:${normalizeAgentId(params.agentId)}:${lowered}`;\n}\n\nexport function resolveAgentIdFromSessionKey(sessionKey: string | undefined | null): string {\n  const parsed = parseAgentSessionKey(sessionKey);\n  return normalizeAgentId(parsed?.agentId ?? DEFAULT_AGENT_ID);\n}\n\nexport function classifySessionKeyShape(sessionKey: string | undefined | null): SessionKeyShape {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) {\n    return 'missing';\n  }\n  if (parseAgentSessionKey(raw)) {\n    return 'agent';\n  }\n  return normalizeLowercaseStringOrEmpty(raw).startsWith('agent:')\n    ? 'malformed_agent'\n    : 'legacy_or_alias';\n}\n\nexport function normalizeAgentId(value: string | undefined | null): string {\n  const trimmed = (value ?? '').trim();\n  if (!trimmed) {\n    return DEFAULT_AGENT_ID;\n  }\n  const normalized = normalizeLowercaseStringOrEmpty(trimmed);\n  if (VALID_ID_RE.test(trimmed)) {\n    return normalized;\n  }\n  return (\n    normalized\n      .replace(INVALID_CHARS_RE, '-')\n      .replace(LEADING_DASH_RE, '')\n      .replace(TRAILING_DASH_RE, '')\n      .slice(0, 64) || DEFAULT_AGENT_ID\n  );\n}\n\nexport function isValidAgentId(value: string | undefined | null): boolean {\n  const trimmed = (value ?? '').trim();\n  return Boolean(trimmed) && VALID_ID_RE.test(trimmed);\n}\n\nexport function sanitizeAgentId(value: string | undefined | null): string {\n  return normalizeAgentId(value);\n}\n\nexport function buildAgentMainSessionKey(params: {\n  agentId: string;\n  mainKey?: string | undefined;\n}): string {\n  const agentId = normalizeAgentId(params.agentId);\n  const mainKey = normalizeMainKey(params.mainKey);\n  return `agent:${agentId}:${mainKey}`;\n}\n\nexport function buildAgentPeerSessionKey(params: {\n  agentId: string;\n  mainKey?: string | undefined;\n  channel: string;\n  accountId?: string | null;\n  peerKind?: PeerKind | null;\n  peerId?: string | null;\n  identityLinks?: Record<string, string[]>;\n  dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';\n}): string {\n  const rawKind = params.peerKind ?? 'direct';\n  const peerKind = rawKind === 'dm' ? 'direct' : rawKind;\n\n  if (peerKind === 'direct') {\n    const dmScope = params.dmScope ?? 'main';\n    let peerId = (params.peerId ?? '').trim();\n    const linkedPeerId =\n      dmScope === 'main'\n        ? null\n        : resolveLinkedPeerId({\n            identityLinks: params.identityLinks,\n            channel: params.channel,\n            peerId,\n          });\n    if (linkedPeerId) {\n      peerId = linkedPeerId;\n    }\n    peerId = normalizeLowercaseStringOrEmpty(peerId);\n    if (dmScope === 'per-account-channel-peer' && peerId) {\n      const channel = normalizeLowercaseStringOrEmpty(params.channel) || 'unknown';\n      const accountId = normalizeAccountId(params.accountId);\n      return `agent:${normalizeAgentId(params.agentId)}:${channel}:${accountId}:direct:${peerId}`;\n    }\n    if (dmScope === 'per-channel-peer' && peerId) {\n      const channel = normalizeLowercaseStringOrEmpty(params.channel) || 'unknown';\n      return `agent:${normalizeAgentId(params.agentId)}:${channel}:direct:${peerId}`;\n    }\n    if (dmScope === 'per-peer' && peerId) {\n      return `agent:${normalizeAgentId(params.agentId)}:direct:${peerId}`;\n    }\n    return buildAgentMainSessionKey({\n      agentId: params.agentId,\n      mainKey: params.mainKey,\n    });\n  }\n\n  const channel = normalizeLowercaseStringOrEmpty(params.channel) || 'unknown';\n  const peerId = normalizeLowercaseStringOrEmpty(params.peerId) || 'unknown';\n  return `agent:${normalizeAgentId(params.agentId)}:${channel}:${peerKind}:${peerId}`;\n}\n\nfunction resolveLinkedPeerId(params: {\n  identityLinks?: Record<string, string[]>;\n  channel: string;\n  peerId: string;\n}): string | null {\n  const identityLinks = params.identityLinks;\n  if (!identityLinks) {\n    return null;\n  }\n  const peerId = params.peerId.trim();\n  if (!peerId) {\n    return null;\n  }\n  const candidates = new Set<string>();\n  const rawCandidate = normalizeToken(peerId);\n  if (rawCandidate) {\n    candidates.add(rawCandidate);\n  }\n  const channel = normalizeToken(params.channel);\n  if (channel) {\n    const scopedCandidate = normalizeToken(`${channel}:${peerId}`);\n    if (scopedCandidate) {\n      candidates.add(scopedCandidate);\n    }\n  }\n  if (candidates.size === 0) {\n    return null;\n  }\n  for (const [canonical, ids] of Object.entries(identityLinks)) {\n    const canonicalName = canonical.trim();\n    if (!canonicalName || !Array.isArray(ids)) {\n      continue;\n    }\n    for (const id of ids) {\n      const normalized = normalizeToken(id);\n      if (normalized && candidates.has(normalized)) {\n        return canonicalName;\n      }\n    }\n  }\n  return null;\n}\n\nexport function buildGroupHistoryKey(params: {\n  channel: string;\n  accountId?: string | null;\n  peerKind: 'group' | 'channel';\n  peerId: string;\n}): string {\n  const channel = normalizeToken(params.channel) || 'unknown';\n  const accountId = normalizeAccountId(params.accountId);\n  const peerId = normalizeLowercaseStringOrEmpty(params.peerId) || 'unknown';\n  return `${channel}:${accountId}:${params.peerKind}:${peerId}`;\n}\n\nexport function resolveThreadSessionKeys(params: {\n  baseSessionKey: string;\n  threadId?: string | null;\n  parentSessionKey?: string;\n  useSuffix?: boolean;\n  normalizeThreadId?: (threadId: string) => string;\n}): { sessionKey: string; parentSessionKey?: string } {\n  const threadId = (params.threadId ?? '').trim();\n  if (!threadId) {\n    return { sessionKey: params.baseSessionKey, parentSessionKey: undefined };\n  }\n  const normalizedThread =\n    params.normalizeThreadId?.(threadId) ?? normalizeLowercaseStringOrEmpty(threadId);\n  const useSuffix = params.useSuffix ?? true;\n  const sessionKey = useSuffix\n    ? `${params.baseSessionKey}:thread:${normalizedThread}`\n    : params.baseSessionKey;\n  return { sessionKey, parentSessionKey: params.parentSessionKey };\n}\n\nexport function scopedHeartbeatWakeOptions<T extends object>(\n  sessionKey: string,\n  wakeOptions: T,\n): T | (T & { sessionKey: string }) {\n  return parseAgentSessionKey(sessionKey) ? { ...wakeOptions, sessionKey } : wakeOptions;\n}\n\n/** Default CLI/TUI main session key. */\nexport function defaultMainSessionKey(agentId?: string, mainKey?: string): string {\n  return buildAgentMainSessionKey({ agentId: agentId ?? DEFAULT_AGENT_ID, mainKey });\n}\n\nexport function assertAgentSessionKey(sessionKey: string): void {\n  if (!parseAgentSessionKey(sessionKey)) {\n    throw new Error(`Invalid agent session key (expected agent:{id}:{rest}): ${sessionKey}`);\n  }\n}\n\nexport function normalizeSessionKey(sessionKey: string | undefined | null): string {\n  return (sessionKey ?? '').trim().toLowerCase();\n}\n"],"mappings":";;;;;AAkCA,SAAS,eAAe,OAA0C;AAChE,QAAO,gCAAgC,MAAM;;AAG/C,SAAgB,iBAAiB,OAA0C;AACzE,QAAO,gCAAgC,MAAM,IAAA;;AAG/C,SAAgB,yBAAyB,UAAyD;CAChG,MAAM,OAAO,YAAY,IAAI,MAAM;AACnC,KAAI,CAAC,IACH;AAEF,QAAO,qBAAqB,IAAI,EAAE,QAAQ;;AAG5C,SAAgB,uBAAuB,QAI5B;CACT,MAAM,OAAO,OAAO,cAAc,IAAI,MAAM;CAC5C,MAAM,UAAU,gCAAgC,IAAI;AACpD,KAAI,CAAC,OAAO,YAAA,OACV,QAAO,yBAAyB;EAAE,SAAS,OAAO;EAAS,SAAS,OAAO;EAAS,CAAC;CAEvF,MAAM,SAAS,qBAAqB,IAAI;AACxC,KAAI,OACF,QAAO,SAAS,OAAO,QAAQ,GAAG,OAAO;AAE3C,KAAI,QAAQ,WAAW,SAAS,CAC9B,QAAO;AAET,QAAO,SAAS,iBAAiB,OAAO,QAAQ,CAAC,GAAG;;AAGtD,SAAgB,6BAA6B,YAA+C;AAE1F,QAAO,iBADQ,qBAAqB,WACN,EAAE,WAAA,OAA4B;;AAG9D,SAAgB,wBAAwB,YAAwD;CAC9F,MAAM,OAAO,cAAc,IAAI,MAAM;AACrC,KAAI,CAAC,IACH,QAAO;AAET,KAAI,qBAAqB,IAAI,CAC3B,QAAO;AAET,QAAO,gCAAgC,IAAI,CAAC,WAAW,SAAS,GAC5D,oBACA;;AAGN,SAAgB,iBAAiB,OAA0C;CACzE,MAAM,WAAW,SAAS,IAAI,MAAM;AACpC,KAAI,CAAC,QACH,QAAO;CAET,MAAM,aAAa,gCAAgC,QAAQ;AAC3D,KAAI,YAAY,KAAK,QAAQ,CAC3B,QAAO;AAET,QACE,WACG,QAAQ,kBAAkB,IAAI,CAC9B,QAAQ,iBAAiB,GAAG,CAC5B,QAAQ,kBAAkB,GAAG,CAC7B,MAAM,GAAG,GAAG,IAAA;;AAInB,SAAgB,eAAe,OAA2C;CACxE,MAAM,WAAW,SAAS,IAAI,MAAM;AACpC,QAAO,QAAQ,QAAQ,IAAI,YAAY,KAAK,QAAQ;;AAGtD,SAAgB,gBAAgB,OAA0C;AACxE,QAAO,iBAAiB,MAAM;;AAGhC,SAAgB,yBAAyB,QAG9B;AAGT,QAAO,SAFS,iBAAiB,OAAO,QAEjB,CAAC,GADR,iBAAiB,OAAO,QACN;;AAGpC,SAAgB,yBAAyB,QAS9B;CACT,MAAM,UAAU,OAAO,YAAY;CACnC,MAAM,WAAW,YAAY,OAAO,WAAW;AAE/C,KAAI,aAAa,UAAU;EACzB,MAAM,UAAU,OAAO,WAAW;EAClC,IAAI,UAAU,OAAO,UAAU,IAAI,MAAM;EACzC,MAAM,eACJ,YAAY,SACR,OACA,oBAAoB;GAClB,eAAe,OAAO;GACtB,SAAS,OAAO;GAChB;GACD,CAAC;AACR,MAAI,aACF,UAAS;AAEX,WAAS,gCAAgC,OAAO;AAChD,MAAI,YAAY,8BAA8B,QAAQ;GACpD,MAAM,UAAU,gCAAgC,OAAO,QAAQ,IAAI;GACnE,MAAM,YAAY,mBAAmB,OAAO,UAAU;AACtD,UAAO,SAAS,iBAAiB,OAAO,QAAQ,CAAC,GAAG,QAAQ,GAAG,UAAU,UAAU;;AAErF,MAAI,YAAY,sBAAsB,QAAQ;GAC5C,MAAM,UAAU,gCAAgC,OAAO,QAAQ,IAAI;AACnE,UAAO,SAAS,iBAAiB,OAAO,QAAQ,CAAC,GAAG,QAAQ,UAAU;;AAExE,MAAI,YAAY,cAAc,OAC5B,QAAO,SAAS,iBAAiB,OAAO,QAAQ,CAAC,UAAU;AAE7D,SAAO,yBAAyB;GAC9B,SAAS,OAAO;GAChB,SAAS,OAAO;GACjB,CAAC;;CAGJ,MAAM,UAAU,gCAAgC,OAAO,QAAQ,IAAI;CACnE,MAAM,SAAS,gCAAgC,OAAO,OAAO,IAAI;AACjE,QAAO,SAAS,iBAAiB,OAAO,QAAQ,CAAC,GAAG,QAAQ,GAAG,SAAS,GAAG;;AAG7E,SAAS,oBAAoB,QAIX;CAChB,MAAM,gBAAgB,OAAO;AAC7B,KAAI,CAAC,cACH,QAAO;CAET,MAAM,SAAS,OAAO,OAAO,MAAM;AACnC,KAAI,CAAC,OACH,QAAO;CAET,MAAM,6BAAa,IAAI,KAAa;CACpC,MAAM,eAAe,eAAe,OAAO;AAC3C,KAAI,aACF,YAAW,IAAI,aAAa;CAE9B,MAAM,UAAU,eAAe,OAAO,QAAQ;AAC9C,KAAI,SAAS;EACX,MAAM,kBAAkB,eAAe,GAAG,QAAQ,GAAG,SAAS;AAC9D,MAAI,gBACF,YAAW,IAAI,gBAAgB;;AAGnC,KAAI,WAAW,SAAS,EACtB,QAAO;AAET,MAAK,MAAM,CAAC,WAAW,QAAQ,OAAO,QAAQ,cAAc,EAAE;EAC5D,MAAM,gBAAgB,UAAU,MAAM;AACtC,MAAI,CAAC,iBAAiB,CAAC,MAAM,QAAQ,IAAI,CACvC;AAEF,OAAK,MAAM,MAAM,KAAK;GACpB,MAAM,aAAa,eAAe,GAAG;AACrC,OAAI,cAAc,WAAW,IAAI,WAAW,CAC1C,QAAO;;;AAIb,QAAO;;AAGT,SAAgB,qBAAqB,QAK1B;CACT,MAAM,UAAU,eAAe,OAAO,QAAQ,IAAI;CAClD,MAAM,YAAY,mBAAmB,OAAO,UAAU;CACtD,MAAM,SAAS,gCAAgC,OAAO,OAAO,IAAI;AACjE,QAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,SAAS,GAAG;;AAGvD,SAAgB,yBAAyB,QAMa;CACpD,MAAM,YAAY,OAAO,YAAY,IAAI,MAAM;AAC/C,KAAI,CAAC,SACH,QAAO;EAAE,YAAY,OAAO;EAAgB,kBAAkB,KAAA;EAAW;CAE3E,MAAM,mBACJ,OAAO,oBAAoB,SAAS,IAAI,gCAAgC,SAAS;AAKnF,QAAO;EAAE,YAJS,OAAO,aAAa,OAElC,GAAG,OAAO,eAAe,UAAU,qBACnC,OAAO;EACU,kBAAkB,OAAO;EAAkB;;AAGlE,SAAgB,2BACd,YACA,aACkC;AAClC,QAAO,qBAAqB,WAAW,GAAG;EAAE,GAAG;EAAa;EAAY,GAAG;;;AAI7E,SAAgB,sBAAsB,SAAkB,SAA0B;AAChF,QAAO,yBAAyB;EAAE,SAAS,WAAA;EAA6B;EAAS,CAAC;;AAGpF,SAAgB,sBAAsB,YAA0B;AAC9D,KAAI,CAAC,qBAAqB,WAAW,CACnC,OAAM,IAAI,MAAM,2DAA2D,aAAa;;AAI5F,SAAgB,oBAAoB,YAA+C;AACjF,SAAQ,cAAc,IAAI,MAAM,CAAC,aAAa;;;;qBAzQ4B;kBACvB;yBACS;AAiBjD,oBAAmB;AACnB,oBAAmB;AAK1B,eAAc;AACd,oBAAmB;AACnB,mBAAkB;AAClB,oBAAmB"}

package/dist/src/routing/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Session key helpers, binding rules, and route resolution.
  */
-export { buildSessionKey, parseSessionKey, sanitizeSegment, isValidSegment, isSubagentSessionKey, isCronSessionKey, getSubagentDepth, buildSubagentSessionKey, getParentSessionKey, normalizeSessionKey, type BuildSessionKeyParams, type ParsedSessionKey, } from './session-key.js';
+export { buildSessionKey, parseSessionKey, sanitizeSegment, isValidSegment, isSubagentSessionKey, isCronSessionKey, getSubagentDepth, buildSubagentSessionKey, getParentSessionKey, normalizeSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, defaultMainSessionKey, parseAgentSessionKey, resolveAgentIdFromSessionKey, toAgentStoreSessionKey, assertAgentSessionKey, normalizeAgentId, normalizeMainKey, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, type BuildSessionKeyParams, type ParsedSessionKey, } from './session-key.js';
 export { normalizeAccountId, normalizeOptionalAccountId, isValidAccountId, sanitizeAccountId, DEFAULT_ACCOUNT_ID, } from './account-id.js';
 export { globMatch, matchesBinding, parseBindingRules, parseBindingRule, resolveRoute as resolveBindingRoute, type BindingMatch, type BindingRule, type RouteInput, type RouteResult, } from './bindings.js';
 export { applyIdentityLinks, getDefaultAgentId, agentExists, pickFirstExistingAgentId, buildRouteSessionKey, deriveLastRoutePolicy, resolveRoute, resolveRouteFromSessionKey, type IdentityLinks, type SessionConfig, type AgentConfig, type RoutingConfig, type ResolveRouteInput, type ResolveRouteResult, type RouteContext, } from './resolve-route.js';

package/dist/src/routing/index.js

@@ -1,5 +1,7 @@
 import { DEFAULT_ACCOUNT_ID, init_account_id, isValidAccountId, normalizeAccountId, normalizeOptionalAccountId, sanitizeAccountId } from "./account-id.js";
-import { buildSessionKey, buildSubagentSessionKey, getParentSessionKey, getSubagentDepth, init_session_key, isCronSessionKey, isSubagentSessionKey, isValidSegment, normalizeSessionKey, parseSessionKey, sanitizeSegment } from "./session-key.js";
+import { getSubagentDepth, isCronSessionKey, isSubagentSessionKey, parseAgentSessionKey } from "./session-key-utils.js";
+import { DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, assertAgentSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, defaultMainSessionKey, normalizeAgentId, normalizeMainKey, normalizeSessionKey, resolveAgentIdFromSessionKey, toAgentStoreSessionKey } from "./agent-session-key.js";
+import { buildSessionKey, buildSubagentSessionKey, getParentSessionKey, init_session_key, isValidSegment, parseSessionKey, sanitizeSegment } from "./session-key.js";
 import { globMatch, init_bindings, matchesBinding, parseBindingRule, parseBindingRules, resolveRoute } from "./bindings.js";
 import { agentExists, applyIdentityLinks, buildRouteSessionKey, deriveLastRoutePolicy, getDefaultAgentId, init_resolve_route, pickFirstExistingAgentId, resolveRoute as resolveRoute$1, resolveRouteFromSessionKey } from "./resolve-route.js";
 //#region src/routing/index.ts
@@ -8,6 +10,6 @@ init_account_id();
 init_bindings();
 init_resolve_route();
 //#endregion
-export { DEFAULT_ACCOUNT_ID, agentExists, applyIdentityLinks, buildRouteSessionKey, buildSessionKey, buildSubagentSessionKey, deriveLastRoutePolicy, getDefaultAgentId, getParentSessionKey, getSubagentDepth, globMatch, isCronSessionKey, isSubagentSessionKey, isValidAccountId, isValidSegment, matchesBinding, normalizeAccountId, normalizeOptionalAccountId, normalizeSessionKey, parseBindingRule, parseBindingRules, parseSessionKey, pickFirstExistingAgentId, resolveRoute as resolveBindingRoute, resolveRoute$1 as resolveRoute, resolveRouteFromSessionKey, sanitizeAccountId, sanitizeSegment };
+export { DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, agentExists, applyIdentityLinks, assertAgentSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, buildRouteSessionKey, buildSessionKey, buildSubagentSessionKey, defaultMainSessionKey, deriveLastRoutePolicy, getDefaultAgentId, getParentSessionKey, getSubagentDepth, globMatch, isCronSessionKey, isSubagentSessionKey, isValidAccountId, isValidSegment, matchesBinding, normalizeAccountId, normalizeAgentId, normalizeMainKey, normalizeOptionalAccountId, normalizeSessionKey, parseAgentSessionKey, parseBindingRule, parseBindingRules, parseSessionKey, pickFirstExistingAgentId, resolveAgentIdFromSessionKey, resolveRoute as resolveBindingRoute, resolveRoute$1 as resolveRoute, resolveRouteFromSessionKey, sanitizeAccountId, sanitizeSegment, toAgentStoreSessionKey };
 
 //# sourceMappingURL=index.js.map

package/dist/src/routing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/routing/index.ts"],"sourcesContent":["/**\n * Session routing\n *\n * Session key helpers, binding rules, and route resolution.\n */\n\n// Session key utilities\nexport {\n  buildSessionKey,\n  parseSessionKey,\n  sanitizeSegment,\n  isValidSegment,\n  isSubagentSessionKey,\n  isCronSessionKey,\n  getSubagentDepth,\n  buildSubagentSessionKey,\n  getParentSessionKey,\n  normalizeSessionKey,\n  type BuildSessionKeyParams,\n  type ParsedSessionKey,\n} from './session-key.js';\n\n// Account id normalization\nexport {\n  normalizeAccountId,\n  normalizeOptionalAccountId,\n  isValidAccountId,\n  sanitizeAccountId,\n  DEFAULT_ACCOUNT_ID,\n} from './account-id.js';\n\n// Binding rules\nexport {\n  globMatch,\n  matchesBinding,\n  parseBindingRules,\n  parseBindingRule,\n  resolveRoute as resolveBindingRoute,\n  type BindingMatch,\n  type BindingRule,\n  type RouteInput,\n  type RouteResult,\n} from './bindings.js';\n\n// Route resolution\nexport {\n  applyIdentityLinks,\n  getDefaultAgentId,\n  agentExists,\n  pickFirstExistingAgentId,\n  buildRouteSessionKey,\n  deriveLastRoutePolicy,\n  resolveRoute,\n  resolveRouteFromSessionKey,\n  type IdentityLinks,\n  type SessionConfig,\n  type AgentConfig,\n  type RoutingConfig,\n  type ResolveRouteInput,\n  type ResolveRouteResult,\n  type RouteContext,\n} from './resolve-route.js';\n"],"mappings":";;;;;kBAoB0B;iBASD;eAaF;oBAmBK"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/routing/index.ts"],"sourcesContent":["/**\n * Session routing\n *\n * Session key helpers, binding rules, and route resolution.\n */\n\n// Session key utilities\nexport {\n  buildSessionKey,\n  parseSessionKey,\n  sanitizeSegment,\n  isValidSegment,\n  isSubagentSessionKey,\n  isCronSessionKey,\n  getSubagentDepth,\n  buildSubagentSessionKey,\n  getParentSessionKey,\n  normalizeSessionKey,\n  buildAgentMainSessionKey,\n  buildAgentPeerSessionKey,\n  defaultMainSessionKey,\n  parseAgentSessionKey,\n  resolveAgentIdFromSessionKey,\n  toAgentStoreSessionKey,\n  assertAgentSessionKey,\n  normalizeAgentId,\n  normalizeMainKey,\n  DEFAULT_AGENT_ID,\n  DEFAULT_MAIN_KEY,\n  type BuildSessionKeyParams,\n  type ParsedSessionKey,\n} from './session-key.js';\n\n// Account id normalization\nexport {\n  normalizeAccountId,\n  normalizeOptionalAccountId,\n  isValidAccountId,\n  sanitizeAccountId,\n  DEFAULT_ACCOUNT_ID,\n} from './account-id.js';\n\n// Binding rules\nexport {\n  globMatch,\n  matchesBinding,\n  parseBindingRules,\n  parseBindingRule,\n  resolveRoute as resolveBindingRoute,\n  type BindingMatch,\n  type BindingRule,\n  type RouteInput,\n  type RouteResult,\n} from './bindings.js';\n\n// Route resolution\nexport {\n  applyIdentityLinks,\n  getDefaultAgentId,\n  agentExists,\n  pickFirstExistingAgentId,\n  buildRouteSessionKey,\n  deriveLastRoutePolicy,\n  resolveRoute,\n  resolveRouteFromSessionKey,\n  type IdentityLinks,\n  type SessionConfig,\n  type AgentConfig,\n  type RoutingConfig,\n  type ResolveRouteInput,\n  type ResolveRouteResult,\n  type RouteContext,\n} from './resolve-route.js';\n"],"mappings":";;;;;;;kBA+B0B;iBASD;eAaF;oBAmBK"}

package/dist/src/routing/resolve-route.d.ts

@@ -18,10 +18,25 @@ export type IdentityLinks = Record<string, string[]>;
  * Session-related routing options.
  */
 export interface SessionConfig {
+    scope?: 'per-sender' | 'global';
+    mainKey?: string;
     /** How DM sessions are scoped / merged */
     dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';
     /** Cross-channel identity aliases */
     identityLinks?: IdentityLinks;
+    resetTriggers?: string[];
+    idleMinutes?: number;
+    reset?: {
+        mode?: 'daily' | 'idle';
+        atHour?: number;
+        idleMinutes?: number;
+    };
+    resetByType?: {
+        direct?: SessionConfig['reset'];
+        group?: SessionConfig['reset'];
+        thread?: SessionConfig['reset'];
+    };
+    resetByChannel?: Record<string, NonNullable<SessionConfig['reset']>>;
     /** Optional session store tuning */
     storage?: {
         pruneAfterMs?: number;

package/dist/src/routing/resolve-route.js

@@ -1,7 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_account_id, normalizeAccountId } from "./account-id.js";
-import { buildSessionKey, init_session_key, normalizeSessionKey, parseSessionKey } from "./session-key.js";
+import { buildAgentMainSessionKey, buildAgentPeerSessionKey, init_agent_session_key, normalizeSessionKey } from "./agent-session-key.js";
+import { buildSessionKey, init_session_key, parseSessionKey } from "./session-key.js";
 import { init_bindings, parseBindingRules, resolveRoute as resolveRoute$1 } from "./bindings.js";
 //#region src/routing/resolve-route.ts
 /**
@@ -56,7 +57,8 @@ function buildRouteSessionKey(agentId, channel, accountId, peerKind, peerId, thr
 		peerKind,
 		peerId,
 		threadId: threadId || void 0,
-		scopeId: scopeId || void 0
+		scopeId: scopeId || void 0,
+		dmScope: peerKind === "dm" || peerKind === "direct" ? "per-account-channel-peer" : void 0
 	});
 }
 /**
@@ -86,28 +88,46 @@ function resolveRoute(input) {
 		memberRoleIds: input.memberRoleIds
 	}, rules, getDefaultAgentId(config));
 	const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);
-	const dmScope = config.session?.dmScope ?? "per-account-channel-peer";
+	const dmScope = config.session?.dmScope ?? "main";
 	let sessionKey;
 	let mainSessionKey;
+	const identityLinks = config.session?.identityLinks;
+	const mainKey = void 0;
 	if (peerKind === "dm" || peerKind === "direct") {
-		mainSessionKey = buildRouteSessionKey(agentId, channel, accountId, "dm", "main");
-		switch (dmScope) {
-			case "per-peer":
-				sessionKey = buildRouteSessionKey(agentId, channel, accountId, "dm", peerId);
-				break;
-			case "per-channel-peer":
-				sessionKey = buildRouteSessionKey(agentId, channel, "default", "dm", peerId);
-				break;
-			case "per-account-channel-peer":
-				sessionKey = buildRouteSessionKey(agentId, "default", "default", "dm", peerId);
-				break;
-			default:
-				sessionKey = mainSessionKey;
-				break;
-		}
+		mainSessionKey = buildAgentMainSessionKey({
+			agentId,
+			mainKey
+		});
+		sessionKey = buildAgentPeerSessionKey({
+			agentId,
+			mainKey,
+			channel,
+			accountId,
+			peerKind: "direct",
+			peerId,
+			identityLinks,
+			dmScope
+		});
 	} else {
-		sessionKey = buildRouteSessionKey(agentId, channel, accountId, peerKind, peerId, threadId);
-		mainSessionKey = buildRouteSessionKey(agentId, channel, accountId, peerKind, "main");
+		const mappedKind = peerKind === "group" || peerKind === "channel" ? peerKind : peerKind;
+		sessionKey = buildAgentPeerSessionKey({
+			agentId,
+			mainKey,
+			channel,
+			accountId,
+			peerKind: mappedKind,
+			peerId,
+			identityLinks
+		});
+		mainSessionKey = buildAgentPeerSessionKey({
+			agentId,
+			mainKey,
+			channel,
+			accountId,
+			peerKind: mappedKind,
+			peerId: "main",
+			identityLinks
+		});
 	}
 	if (threadId && !sessionKey.includes(":thread:")) sessionKey = `${sessionKey}:thread:${threadId.toLowerCase()}`;
 	sessionKey = normalizeSessionKey(sessionKey);
@@ -138,6 +158,7 @@ var init_resolve_route = __esmMin((() => {
 	init_agent_scope();
 	init_bindings();
 	init_session_key();
+	init_agent_session_key();
 	init_account_id();
 }));
 //#endregion

package/dist/src/routing/resolve-route.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-route.js","names":["resolveDefaultAgentIdFromConfig","resolveBindingRoute"],"sources":["../../../src/routing/resolve-route.ts"],"sourcesContent":["/**\n * Route resolution\n *\n * Combines binding rules, identity links, and config to pick an agent and session keys.\n */\n\nimport { resolveDefaultAgentId as resolveDefaultAgentIdFromConfig } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport type { BindingRule, RouteInput, RouteResult } from './bindings.js';\n\n/**\n * Route context type (alias for RouteInput)\n */\nexport type RouteContext = RouteInput;\nimport { parseBindingRules, resolveRoute as resolveBindingRoute } from './bindings.js';\nimport { buildSessionKey, normalizeSessionKey, parseSessionKey } from './session-key.js';\nimport { normalizeAccountId } from './account-id.js';\n\n/**\n * Identity link map: canonical peer id -> aliases across channels.\n *\n * Shape: `{ canonicalName: [alias1, alias2, ...] }`\n */\nexport type IdentityLinks = Record<string, string[]>;\n\n/**\n * Session-related routing options.\n */\nexport interface SessionConfig {\n  /** How DM sessions are scoped / merged */\n  dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';\n  /** Cross-channel identity aliases */\n  identityLinks?: IdentityLinks;\n  /** Optional session store tuning */\n  storage?: {\n    pruneAfterMs?: number;\n    maxEntries?: number;\n  };\n}\n\n/**\n * Agent list and default id from config.\n */\nexport interface AgentConfig {\n  /** Default agent id */\n  default?: string;\n  /** Registered agents */\n  list?: Array<{\n    id: string;\n    name?: string;\n    enabled?: boolean;\n    [key: string]: unknown;\n  }>;\n}\n\n/**\n * Subset of app config used for routing.\n */\nexport interface RoutingConfig {\n  agents?: AgentConfig;\n  bindings?: BindingRule[] | any[];\n  session?: SessionConfig;\n}\n\n/**\n * Input to `resolveRoute`.\n */\nexport interface ResolveRouteInput extends RouteInput {\n  /** Routing config snapshot */\n  config: RoutingConfig;\n  /** Optional thread id for threaded channels */\n  threadId?: string | null;\n}\n\n/**\n * Resolved route including session keys.\n */\nexport interface ResolveRouteResult extends RouteResult {\n  /** Active session key for this turn */\n  sessionKey: string;\n  /** Main session key (DM merge target) */\n  mainSessionKey: string;\n  /** Whether routing used the main or a per-session key */\n  lastRoutePolicy: 'main' | 'session';\n}\n\n/**\n * Apply identity links and return a canonical lowercased peer id.\n */\nexport function applyIdentityLinks(\n  peerId: string,\n  channel: string,\n  identityLinks?: IdentityLinks\n): string {\n  if (!identityLinks) {\n    return peerId.toLowerCase();\n  }\n  \n  const normalizedPeerId = peerId.trim().toLowerCase();\n  if (!normalizedPeerId) {\n    return normalizedPeerId;\n  }\n  \n  const candidates = new Set<string>();\n  candidates.add(normalizedPeerId);\n  \n  const channelPrefix = channel.trim().toLowerCase();\n  if (channelPrefix) {\n    candidates.add(`${channelPrefix}:${normalizedPeerId}`);\n  }\n  \n  // Match any alias to its canonical id\n  for (const [canonical, aliases] of Object.entries(identityLinks)) {\n    if (!Array.isArray(aliases)) {\n      continue;\n    }\n    \n    for (const alias of aliases) {\n      const normalizedAlias = alias.trim().toLowerCase();\n      if (candidates.has(normalizedAlias)) {\n        return canonical.trim().toLowerCase();\n      }\n    }\n  }\n  \n  return normalizedPeerId;\n}\n\n/**\n * Default agent id from config (`agents.default`, `list[].default`, or `main`).\n */\nexport function getDefaultAgentId(config: RoutingConfig): string {\n  return resolveDefaultAgentIdFromConfig(config as Config);\n}\n\n/**\n * Whether `agentId` appears in the enabled agent list (or list is absent).\n */\nexport function agentExists(agentId: string, config: RoutingConfig): boolean {\n  if (!config.agents?.list) {\n    return true; // No list: treat every id as valid\n  }\n  \n  return config.agents.list.some(\n    (agent) => agent.enabled !== false && agent.id.toLowerCase() === agentId.toLowerCase()\n  );\n}\n\n/**\n * Return `agentId` if listed, otherwise the default agent id.\n */\nexport function pickFirstExistingAgentId(agentId: string, config: RoutingConfig): string {\n  if (!agentId) {\n    return getDefaultAgentId(config);\n  }\n  \n  if (agentExists(agentId, config)) {\n    return agentId.toLowerCase();\n  }\n  \n  return getDefaultAgentId(config);\n}\n\n/**\n * Thin wrapper around `buildSessionKey` for route inputs.\n */\nexport function buildRouteSessionKey(\n  agentId: string,\n  channel: string,\n  accountId: string,\n  peerKind: string,\n  peerId: string,\n  threadId?: string | null,\n  scopeId?: string | null\n): string {\n  return buildSessionKey({\n    agentId,\n    source: channel,\n    accountId,\n    peerKind,\n    peerId,\n    threadId: threadId || undefined,\n    scopeId: scopeId || undefined,\n  });\n}\n\n/**\n * Map session vs main key to policy label.\n */\nexport function deriveLastRoutePolicy(\n  sessionKey: string,\n  mainSessionKey: string\n): 'main' | 'session' {\n  return sessionKey === mainSessionKey ? 'main' : 'session';\n}\n\n/**\n * Resolve agent and session keys from channel context and config.\n */\nexport function resolveRoute(input: ResolveRouteInput): ResolveRouteResult {\n  const { config, threadId } = input;\n  \n  const channel = (input.channel ?? '').trim().toLowerCase() || 'unknown';\n  const accountId = normalizeAccountId(input.accountId);\n  const peerKind = (input.peerKind ?? 'dm').toLowerCase();\n  const rawPeerId = (input.peerId ?? '').trim();\n  \n  const peerId = applyIdentityLinks(rawPeerId, channel, config.session?.identityLinks ?? {});\n  \n  const rules = Array.isArray(config.bindings)\n    ? parseBindingRules({ bindings: config.bindings })\n    : [];\n  \n  const bindingResult = resolveBindingRoute(\n    {\n      channel,\n      accountId,\n      peerKind: input.peerKind,\n      peerId: rawPeerId,\n      guildId: input.guildId,\n      teamId: input.teamId,\n      memberRoleIds: input.memberRoleIds,\n    },\n    rules,\n    getDefaultAgentId(config)\n  );\n  \n  const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);\n  \n  const dmScope = config.session?.dmScope ?? 'per-account-channel-peer';\n  \n  let sessionKey: string;\n  let mainSessionKey: string;\n  \n  if (peerKind === 'dm' || peerKind === 'direct') {\n    // DM: merge or split sessions depending on dmScope\n    mainSessionKey = buildRouteSessionKey(agentId, channel, accountId, 'dm', 'main');\n    \n    switch (dmScope) {\n      case 'per-peer':\n        sessionKey = buildRouteSessionKey(agentId, channel, accountId, 'dm', peerId);\n        break;\n      case 'per-channel-peer':\n        sessionKey = buildRouteSessionKey(agentId, channel, 'default', 'dm', peerId);\n        break;\n      case 'per-account-channel-peer':\n        sessionKey = buildRouteSessionKey(agentId, 'default', 'default', 'dm', peerId);\n        break;\n      case 'main':\n      default:\n        sessionKey = mainSessionKey;\n        break;\n    }\n  } else {\n    // Group / channel / other peer kinds\n    sessionKey = buildRouteSessionKey(agentId, channel, accountId, peerKind, peerId, threadId);\n    mainSessionKey = buildRouteSessionKey(agentId, channel, accountId, peerKind, 'main');\n  }\n  \n  if (threadId && !sessionKey.includes(':thread:')) {\n    sessionKey = `${sessionKey}:thread:${threadId.toLowerCase()}`;\n  }\n  \n  sessionKey = normalizeSessionKey(sessionKey);\n  mainSessionKey = normalizeSessionKey(mainSessionKey);\n  \n  return {\n    ...bindingResult,\n    agentId,\n    sessionKey,\n    mainSessionKey,\n    lastRoutePolicy: deriveLastRoutePolicy(sessionKey, mainSessionKey),\n  };\n}\n\n/**\n * Parse basic routing fields from a session key string.\n */\nexport function resolveRouteFromSessionKey(\n  sessionKey: string,\n  _config: RoutingConfig\n): { agentId: string; source: string; accountId: string; peerKind: string; peerId: string } | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) {\n    return null;\n  }\n  \n  return {\n    agentId: parsed.agentId,\n    source: parsed.source,\n    accountId: parsed.accountId,\n    peerKind: parsed.peerKind,\n    peerId: parsed.peerId,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve-route.js","names":["resolveDefaultAgentIdFromConfig","resolveBindingRoute"],"sources":["../../../src/routing/resolve-route.ts"],"sourcesContent":["/**\n * Route resolution\n *\n * Combines binding rules, identity links, and config to pick an agent and session keys.\n */\n\nimport { resolveDefaultAgentId as resolveDefaultAgentIdFromConfig } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport type { BindingRule, RouteInput, RouteResult } from './bindings.js';\n\n/**\n * Route context type (alias for RouteInput)\n */\nexport type RouteContext = RouteInput;\nimport { parseBindingRules, resolveRoute as resolveBindingRoute } from './bindings.js';\nimport { buildSessionKey, normalizeSessionKey, parseSessionKey } from './session-key.js';\nimport {\n  buildAgentMainSessionKey,\n  buildAgentPeerSessionKey,\n} from './agent-session-key.js';\nimport { normalizeAccountId } from './account-id.js';\n\n/**\n * Identity link map: canonical peer id -> aliases across channels.\n *\n * Shape: `{ canonicalName: [alias1, alias2, ...] }`\n */\nexport type IdentityLinks = Record<string, string[]>;\n\n/**\n * Session-related routing options.\n */\nexport interface SessionConfig {\n  scope?: 'per-sender' | 'global';\n  mainKey?: string;\n  /** How DM sessions are scoped / merged */\n  dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';\n  /** Cross-channel identity aliases */\n  identityLinks?: IdentityLinks;\n  resetTriggers?: string[];\n  idleMinutes?: number;\n  reset?: {\n    mode?: 'daily' | 'idle';\n    atHour?: number;\n    idleMinutes?: number;\n  };\n  resetByType?: {\n    direct?: SessionConfig['reset'];\n    group?: SessionConfig['reset'];\n    thread?: SessionConfig['reset'];\n  };\n  resetByChannel?: Record<string, NonNullable<SessionConfig['reset']>>;\n  /** Optional session store tuning */\n  storage?: {\n    pruneAfterMs?: number;\n    maxEntries?: number;\n  };\n}\n\n/**\n * Agent list and default id from config.\n */\nexport interface AgentConfig {\n  /** Default agent id */\n  default?: string;\n  /** Registered agents */\n  list?: Array<{\n    id: string;\n    name?: string;\n    enabled?: boolean;\n    [key: string]: unknown;\n  }>;\n}\n\n/**\n * Subset of app config used for routing.\n */\nexport interface RoutingConfig {\n  agents?: AgentConfig;\n  bindings?: BindingRule[] | any[];\n  session?: SessionConfig;\n}\n\n/**\n * Input to `resolveRoute`.\n */\nexport interface ResolveRouteInput extends RouteInput {\n  /** Routing config snapshot */\n  config: RoutingConfig;\n  /** Optional thread id for threaded channels */\n  threadId?: string | null;\n}\n\n/**\n * Resolved route including session keys.\n */\nexport interface ResolveRouteResult extends RouteResult {\n  /** Active session key for this turn */\n  sessionKey: string;\n  /** Main session key (DM merge target) */\n  mainSessionKey: string;\n  /** Whether routing used the main or a per-session key */\n  lastRoutePolicy: 'main' | 'session';\n}\n\n/**\n * Apply identity links and return a canonical lowercased peer id.\n */\nexport function applyIdentityLinks(\n  peerId: string,\n  channel: string,\n  identityLinks?: IdentityLinks\n): string {\n  if (!identityLinks) {\n    return peerId.toLowerCase();\n  }\n  \n  const normalizedPeerId = peerId.trim().toLowerCase();\n  if (!normalizedPeerId) {\n    return normalizedPeerId;\n  }\n  \n  const candidates = new Set<string>();\n  candidates.add(normalizedPeerId);\n  \n  const channelPrefix = channel.trim().toLowerCase();\n  if (channelPrefix) {\n    candidates.add(`${channelPrefix}:${normalizedPeerId}`);\n  }\n  \n  // Match any alias to its canonical id\n  for (const [canonical, aliases] of Object.entries(identityLinks)) {\n    if (!Array.isArray(aliases)) {\n      continue;\n    }\n    \n    for (const alias of aliases) {\n      const normalizedAlias = alias.trim().toLowerCase();\n      if (candidates.has(normalizedAlias)) {\n        return canonical.trim().toLowerCase();\n      }\n    }\n  }\n  \n  return normalizedPeerId;\n}\n\n/**\n * Default agent id from config (`agents.default`, `list[].default`, or `main`).\n */\nexport function getDefaultAgentId(config: RoutingConfig): string {\n  return resolveDefaultAgentIdFromConfig(config as Config);\n}\n\n/**\n * Whether `agentId` appears in the enabled agent list (or list is absent).\n */\nexport function agentExists(agentId: string, config: RoutingConfig): boolean {\n  if (!config.agents?.list) {\n    return true; // No list: treat every id as valid\n  }\n  \n  return config.agents.list.some(\n    (agent) => agent.enabled !== false && agent.id.toLowerCase() === agentId.toLowerCase()\n  );\n}\n\n/**\n * Return `agentId` if listed, otherwise the default agent id.\n */\nexport function pickFirstExistingAgentId(agentId: string, config: RoutingConfig): string {\n  if (!agentId) {\n    return getDefaultAgentId(config);\n  }\n  \n  if (agentExists(agentId, config)) {\n    return agentId.toLowerCase();\n  }\n  \n  return getDefaultAgentId(config);\n}\n\n/**\n * Thin wrapper around `buildSessionKey` for route inputs.\n */\nexport function buildRouteSessionKey(\n  agentId: string,\n  channel: string,\n  accountId: string,\n  peerKind: string,\n  peerId: string,\n  threadId?: string | null,\n  scopeId?: string | null,\n): string {\n  return buildSessionKey({\n    agentId,\n    source: channel,\n    accountId,\n    peerKind,\n    peerId,\n    threadId: threadId || undefined,\n    scopeId: scopeId || undefined,\n    dmScope: peerKind === 'dm' || peerKind === 'direct' ? 'per-account-channel-peer' : undefined,\n  });\n}\n\n/**\n * Map session vs main key to policy label.\n */\nexport function deriveLastRoutePolicy(\n  sessionKey: string,\n  mainSessionKey: string\n): 'main' | 'session' {\n  return sessionKey === mainSessionKey ? 'main' : 'session';\n}\n\n/**\n * Resolve agent and session keys from channel context and config.\n */\nexport function resolveRoute(input: ResolveRouteInput): ResolveRouteResult {\n  const { config, threadId } = input;\n  \n  const channel = (input.channel ?? '').trim().toLowerCase() || 'unknown';\n  const accountId = normalizeAccountId(input.accountId);\n  const peerKind = (input.peerKind ?? 'dm').toLowerCase();\n  const rawPeerId = (input.peerId ?? '').trim();\n  \n  const peerId = applyIdentityLinks(rawPeerId, channel, config.session?.identityLinks ?? {});\n  \n  const rules = Array.isArray(config.bindings)\n    ? parseBindingRules({ bindings: config.bindings })\n    : [];\n  \n  const bindingResult = resolveBindingRoute(\n    {\n      channel,\n      accountId,\n      peerKind: input.peerKind,\n      peerId: rawPeerId,\n      guildId: input.guildId,\n      teamId: input.teamId,\n      memberRoleIds: input.memberRoleIds,\n    },\n    rules,\n    getDefaultAgentId(config)\n  );\n  \n  const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);\n  \n  const dmScope = config.session?.dmScope ?? 'main';\n\n  let sessionKey: string;\n  let mainSessionKey: string;\n\n  const identityLinks = config.session?.identityLinks;\n  const mainKey = undefined;\n\n  if (peerKind === 'dm' || peerKind === 'direct') {\n    mainSessionKey = buildAgentMainSessionKey({ agentId, mainKey });\n\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: 'direct',\n      peerId,\n      identityLinks,\n      dmScope,\n    });\n  } else {\n    const mappedKind = peerKind === 'group' || peerKind === 'channel' ? peerKind : peerKind;\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId,\n      identityLinks,\n    });\n    mainSessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId: 'main',\n      identityLinks,\n    });\n  }\n\n  if (threadId && !sessionKey.includes(':thread:')) {\n    sessionKey = `${sessionKey}:thread:${threadId.toLowerCase()}`;\n  }\n  \n  sessionKey = normalizeSessionKey(sessionKey);\n  mainSessionKey = normalizeSessionKey(mainSessionKey);\n  \n  return {\n    ...bindingResult,\n    agentId,\n    sessionKey,\n    mainSessionKey,\n    lastRoutePolicy: deriveLastRoutePolicy(sessionKey, mainSessionKey),\n  };\n}\n\n/**\n * Parse basic routing fields from a session key string.\n */\nexport function resolveRouteFromSessionKey(\n  sessionKey: string,\n  _config: RoutingConfig\n): { agentId: string; source: string; accountId: string; peerKind: string; peerId: string } | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) {\n    return null;\n  }\n  \n  return {\n    agentId: parsed.agentId,\n    source: parsed.source,\n    accountId: parsed.accountId,\n    peerKind: parsed.peerKind,\n    peerId: parsed.peerId,\n  };\n}\n"],"mappings":"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"}

package/dist/src/routing/resolve-tui-session-key.d.ts

@@ -0,0 +1,25 @@
+import type { Config } from '../config/schema.js';
+export type SessionScope = 'per-sender' | 'global';
+export declare function resolveTuiSessionKey(params: {
+    raw?: string;
+    sessionScope: SessionScope;
+    currentAgentId: string;
+    sessionMainKey: string;
+}): string;
+export declare function resolveInitialTuiAgentId(params: {
+    cfg: Config;
+    fallbackAgentId: string;
+    initialSessionInput?: string;
+    cwd?: string;
+}): string;
+/** Resolve TUI startup session key from CLI options and config. */
+export declare function resolveTuiStartupSessionKey(params: {
+    cfg: Config;
+    sessionOption?: string;
+    cwd?: string;
+}): {
+    sessionKey: string;
+    agentId: string;
+    sessionScope: SessionScope;
+    sessionMainKey: string;
+};

package/dist/src/routing/resolve-tui-session-key.js

@@ -0,0 +1,54 @@
+import { init_agent_scope, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
+import { parseAgentSessionKey } from "./session-key-utils.js";
+import { buildAgentMainSessionKey, init_agent_session_key, normalizeAgentId, normalizeMainKey } from "./agent-session-key.js";
+//#region src/routing/resolve-tui-session-key.ts
+init_agent_scope();
+init_agent_session_key();
+init_string_coerce();
+function resolveTuiSessionKey(params) {
+	const trimmed = (params.raw ?? "").trim();
+	if (!trimmed) {
+		if (params.sessionScope === "global") return "global";
+		return buildAgentMainSessionKey({
+			agentId: params.currentAgentId,
+			mainKey: params.sessionMainKey
+		});
+	}
+	if (trimmed === "global" || trimmed === "unknown") return trimmed;
+	if (trimmed.startsWith("agent:")) return normalizeLowercaseStringOrEmpty(trimmed);
+	return `agent:${params.currentAgentId}:${normalizeLowercaseStringOrEmpty(trimmed)}`;
+}
+function resolveInitialTuiAgentId(params) {
+	const parsed = parseAgentSessionKey((params.initialSessionInput ?? "").trim());
+	if (parsed?.agentId) return normalizeAgentId(parsed.agentId);
+	const inferredFromWorkspace = resolveAgentIdByWorkspacePath(params.cfg, params.cwd ?? process.cwd());
+	if (inferredFromWorkspace) return inferredFromWorkspace;
+	return normalizeAgentId(params.fallbackAgentId);
+}
+/** Resolve TUI startup session key from CLI options and config. */
+function resolveTuiStartupSessionKey(params) {
+	const sessionScope = params.cfg.session?.scope ?? "per-sender";
+	const sessionMainKey = normalizeMainKey(params.cfg.session?.mainKey);
+	const agentId = resolveInitialTuiAgentId({
+		cfg: params.cfg,
+		fallbackAgentId: resolveDefaultAgentId(params.cfg),
+		initialSessionInput: (params.sessionOption ?? "").trim(),
+		cwd: params.cwd ?? process.cwd()
+	});
+	return {
+		sessionKey: resolveTuiSessionKey({
+			raw: params.sessionOption,
+			sessionScope,
+			currentAgentId: agentId,
+			sessionMainKey
+		}),
+		agentId,
+		sessionScope,
+		sessionMainKey
+	};
+}
+//#endregion
+export { resolveInitialTuiAgentId, resolveTuiSessionKey, resolveTuiStartupSessionKey };
+
+//# sourceMappingURL=resolve-tui-session-key.js.map

package/dist/src/routing/resolve-tui-session-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-tui-session-key.js","names":[],"sources":["../../../src/routing/resolve-tui-session-key.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport {\n  resolveAgentIdByWorkspacePath,\n  resolveDefaultAgentId,\n} from '../agent/agent-scope.js';\nimport {\n  buildAgentMainSessionKey,\n  normalizeAgentId,\n  normalizeMainKey,\n  parseAgentSessionKey,\n} from './agent-session-key.js';\nimport { normalizeLowercaseStringOrEmpty } from '../utils/string-coerce.js';\n\nexport type SessionScope = 'per-sender' | 'global';\n\nexport function resolveTuiSessionKey(params: {\n  raw?: string;\n  sessionScope: SessionScope;\n  currentAgentId: string;\n  sessionMainKey: string;\n}): string {\n  const trimmed = (params.raw ?? '').trim();\n  if (!trimmed) {\n    if (params.sessionScope === 'global') {\n      return 'global';\n    }\n    return buildAgentMainSessionKey({\n      agentId: params.currentAgentId,\n      mainKey: params.sessionMainKey,\n    });\n  }\n  if (trimmed === 'global' || trimmed === 'unknown') {\n    return trimmed;\n  }\n  if (trimmed.startsWith('agent:')) {\n    return normalizeLowercaseStringOrEmpty(trimmed);\n  }\n  return `agent:${params.currentAgentId}:${normalizeLowercaseStringOrEmpty(trimmed)}`;\n}\n\nexport function resolveInitialTuiAgentId(params: {\n  cfg: Config;\n  fallbackAgentId: string;\n  initialSessionInput?: string;\n  cwd?: string;\n}): string {\n  const parsed = parseAgentSessionKey((params.initialSessionInput ?? '').trim());\n  if (parsed?.agentId) {\n    return normalizeAgentId(parsed.agentId);\n  }\n\n  const inferredFromWorkspace = resolveAgentIdByWorkspacePath(\n    params.cfg,\n    params.cwd ?? process.cwd(),\n  );\n  if (inferredFromWorkspace) {\n    return inferredFromWorkspace;\n  }\n\n  return normalizeAgentId(params.fallbackAgentId);\n}\n\n/** Resolve TUI startup session key from CLI options and config. */\nexport function resolveTuiStartupSessionKey(params: {\n  cfg: Config;\n  sessionOption?: string;\n  cwd?: string;\n}): { sessionKey: string; agentId: string; sessionScope: SessionScope; sessionMainKey: string } {\n  const sessionScope = (params.cfg.session?.scope ?? 'per-sender') as SessionScope;\n  const sessionMainKey = normalizeMainKey(params.cfg.session?.mainKey);\n  const agentId = resolveInitialTuiAgentId({\n    cfg: params.cfg,\n    fallbackAgentId: resolveDefaultAgentId(params.cfg),\n    initialSessionInput: (params.sessionOption ?? '').trim(),\n    cwd: params.cwd ?? process.cwd(),\n  });\n  const sessionKey = resolveTuiSessionKey({\n    raw: params.sessionOption,\n    sessionScope,\n    currentAgentId: agentId,\n    sessionMainKey,\n  });\n  return { sessionKey, agentId, sessionScope, sessionMainKey };\n}\n"],"mappings":";;;;;kBAIiC;wBAMD;oBAC4C;AAI5E,SAAgB,qBAAqB,QAK1B;CACT,MAAM,WAAW,OAAO,OAAO,IAAI,MAAM;AACzC,KAAI,CAAC,SAAS;AACZ,MAAI,OAAO,iBAAiB,SAC1B,QAAO;AAET,SAAO,yBAAyB;GAC9B,SAAS,OAAO;GAChB,SAAS,OAAO;GACjB,CAAC;;AAEJ,KAAI,YAAY,YAAY,YAAY,UACtC,QAAO;AAET,KAAI,QAAQ,WAAW,SAAS,CAC9B,QAAO,gCAAgC,QAAQ;AAEjD,QAAO,SAAS,OAAO,eAAe,GAAG,gCAAgC,QAAQ;;AAGnF,SAAgB,yBAAyB,QAK9B;CACT,MAAM,SAAS,sBAAsB,OAAO,uBAAuB,IAAI,MAAM,CAAC;AAC9E,KAAI,QAAQ,QACV,QAAO,iBAAiB,OAAO,QAAQ;CAGzC,MAAM,wBAAwB,8BAC5B,OAAO,KACP,OAAO,OAAO,QAAQ,KAAK,CAC5B;AACD,KAAI,sBACF,QAAO;AAGT,QAAO,iBAAiB,OAAO,gBAAgB;;;AAIjD,SAAgB,4BAA4B,QAIoD;CAC9F,MAAM,eAAgB,OAAO,IAAI,SAAS,SAAS;CACnD,MAAM,iBAAiB,iBAAiB,OAAO,IAAI,SAAS,QAAQ;CACpE,MAAM,UAAU,yBAAyB;EACvC,KAAK,OAAO;EACZ,iBAAiB,sBAAsB,OAAO,IAAI;EAClD,sBAAsB,OAAO,iBAAiB,IAAI,MAAM;EACxD,KAAK,OAAO,OAAO,QAAQ,KAAK;EACjC,CAAC;AAOF,QAAO;EAAE,YANU,qBAAqB;GACtC,KAAK,OAAO;GACZ;GACA,gBAAgB;GAChB;GACD,CACkB;EAAE;EAAS;EAAc;EAAgB"}

package/dist/src/routing/session-key-utils.d.ts

@@ -0,0 +1,24 @@
+export type ParsedAgentSessionKey = {
+    agentId: string;
+    rest: string;
+};
+export type ParsedThreadSessionSuffix = {
+    baseSessionKey: string | undefined;
+    threadId: string | undefined;
+};
+export type RawSessionConversationRef = {
+    channel: string;
+    kind: 'group' | 'channel';
+    rawId: string;
+    prefix: string;
+};
+/** Parse `agent:{agentId}:{rest}` session keys (OpenClaw canonical form). */
+export declare function parseAgentSessionKey(sessionKey: string | undefined | null): ParsedAgentSessionKey | null;
+export declare function isCronRunSessionKey(sessionKey: string | undefined | null): boolean;
+export declare function isCronSessionKey(sessionKey: string | undefined | null): boolean;
+export declare function isSubagentSessionKey(sessionKey: string | undefined | null): boolean;
+export declare function getSubagentDepth(sessionKey: string | undefined | null): number;
+export declare function isAcpSessionKey(sessionKey: string | undefined | null): boolean;
+export declare function parseThreadSessionSuffix(sessionKey: string | undefined | null): ParsedThreadSessionSuffix;
+export declare function parseRawSessionConversationRef(sessionKey: string | undefined | null): RawSessionConversationRef | null;
+export declare function resolveThreadParentSessionKey(sessionKey: string | undefined | null): string | null;