@xopcai/xopc 0.0.285 → 0.0.286

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

@@ -1,8 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_account_id, normalizeAccountId } from "./account-id.js";
-import { buildAgentMainSessionKey, buildAgentPeerSessionKey, init_agent_session_key, normalizeSessionKey } from "./agent-session-key.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { buildSessionKey, init_session_key, parseSessionKey } from "./session-key.js";
+import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
+import { init_agent_session_key, resolveAgentPeerConversationId } from "./agent-session-key.js";
+import { init_session_key, resolveConversationId } from "./session-key.js";
 import { init_bindings, parseBindingRules, resolveRoute as resolveRoute$1 } from "./bindings.js";
 //#region src/routing/resolve-route.ts
 /**
@@ -47,10 +48,10 @@ function pickFirstExistingAgentId(agentId, config) {
 	return getDefaultAgentId(config);
 }
 /**
-* Thin wrapper around `buildSessionKey` for route inputs.
+* Thin wrapper around `resolveConversationId` for route inputs.
 */
-function buildRouteSessionKey(agentId, channel, accountId, peerKind, peerId, threadId, scopeId) {
-	return buildSessionKey({
+function buildRouteConversationId(agentId, channel, accountId, peerKind, peerId, threadId, scopeId) {
+	return resolveConversationId({
 		agentId,
 		source: channel,
 		accountId,
@@ -62,12 +63,6 @@ function buildRouteSessionKey(agentId, channel, accountId, peerKind, peerId, thr
 	});
 }
 /**
-* Map session vs main key to policy label.
-*/
-function deriveLastRoutePolicy(sessionKey, mainSessionKey) {
-	return sessionKey === mainSessionKey ? "main" : "session";
-}
-/**
 * Resolve agent and session keys from channel context and config.
 */
 function resolveRoute(input) {
@@ -89,62 +84,27 @@ function resolveRoute(input) {
 	}, rules, getDefaultAgentId(config));
 	const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);
 	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 = buildAgentMainSessionKey({
-			agentId,
-			mainKey
-		});
-		sessionKey = buildAgentPeerSessionKey({
-			agentId,
-			mainKey,
-			channel,
-			accountId,
-			peerKind: "direct",
-			peerId,
-			identityLinks,
-			dmScope
-		});
-	} else {
-		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);
-	mainSessionKey = normalizeSessionKey(mainSessionKey);
+	const conversationId = resolveAgentPeerConversationId({
+		agentId,
+		channel,
+		accountId,
+		peerKind,
+		peerId,
+		dmScope,
+		threadId: threadId ?? void 0
+	});
 	return {
 		...bindingResult,
 		agentId,
-		sessionKey,
-		mainSessionKey,
-		lastRoutePolicy: deriveLastRoutePolicy(sessionKey, mainSessionKey)
+		conversationId,
+		lastRoutePolicy: dmScope === "main" && (peerKind === "dm" || peerKind === "direct") ? "main" : "session"
 	};
 }
 /**
 * Parse basic routing fields from a session key string.
 */
-function resolveRouteFromSessionKey(sessionKey, _config) {
-	const parsed = parseSessionKey(sessionKey);
+function resolveRouteFromConversationId(conversationId, _config) {
+	const parsed = getConversationRouting(conversationId);
 	if (!parsed) return null;
 	return {
 		agentId: parsed.agentId,
@@ -163,4 +123,4 @@ var init_resolve_route = __esmMin((() => {
 }));
 //#endregion
 init_resolve_route();
-export { agentExists, applyIdentityLinks, buildRouteSessionKey, deriveLastRoutePolicy, getDefaultAgentId, init_resolve_route, pickFirstExistingAgentId, resolveRoute, resolveRouteFromSessionKey };
+export { agentExists, applyIdentityLinks, buildRouteConversationId, getDefaultAgentId, init_resolve_route, pickFirstExistingAgentId, resolveRoute, resolveRouteFromConversationId };

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

@@ -1,30 +1,22 @@
 import type { Config } from '../config/schema.js';
-export type SessionScope = 'per-sender' | 'global';
 export declare function resolveDefaultTuiAgentId(cfg: Config): string;
-export declare function resolveTuiSessionKey(params: {
+export declare function resolveTuiConversationId(params: {
     raw?: string;
-    sessionScope: SessionScope;
-    currentAgentId: string;
-    sessionMainKey: string;
 }): string;
 export declare function resolveInitialTuiAgentId(params: {
     cfg: Config;
     fallbackAgentId: string;
     explicitAgentId?: string;
-    initialSessionInput?: string;
     cwd?: string;
 }): string;
-export declare function createDefaultTuiSessionKeySuffix(): string;
-/** Resolve TUI startup session key from CLI options and config. */
-export declare function resolveTuiStartupSessionKey(params: {
+/** Resolve TUI startup conversation identity and initial agent from CLI options and config. */
+export declare function resolveTuiStartupConversationId(params: {
     cfg: Config;
     sessionOption?: string;
     agentOption?: string;
     cwd?: string;
-    createSessionKeySuffix?: () => string;
+    createId?: () => string;
 }): {
-    sessionKey: string;
+    conversationId: string;
     agentId: string;
-    sessionScope: SessionScope;
-    sessionMainKey: string;
 };

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

@@ -1,12 +1,12 @@
-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";
+import { validateConversationId } from "../../packages/gateway-contract/src/conversation-identity.js";
+import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { init_agent_session_key, normalizeAgentId } from "./agent-session-key.js";
 import { randomUUID } from "node:crypto";
 //#region src/routing/resolve-tui-session-key.ts
+init_src();
 init_agent_scope();
 init_agent_session_key();
-init_string_coerce();
 function agentExists(cfg, agentId) {
 	const id = normalizeAgentId(agentId);
 	return listAgentEntries(cfg).some((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === id);
@@ -16,53 +16,28 @@ function resolveDefaultTuiAgentId(cfg) {
 	if (configured && agentExists(cfg, configured)) return normalizeAgentId(configured);
 	return resolveDefaultAgentId(cfg);
 }
-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 resolveTuiConversationId(params) {
+	return validateConversationId(params.raw?.trim() || randomUUID());
 }
 function resolveInitialTuiAgentId(params) {
-	const parsed = parseAgentSessionKey((params.initialSessionInput ?? "").trim());
-	if (parsed?.agentId) return normalizeAgentId(parsed.agentId);
 	if (params.explicitAgentId?.trim()) return normalizeAgentId(params.explicitAgentId);
 	const inferredFromWorkspace = resolveAgentIdByWorkspacePath(params.cfg, params.cwd ?? process.cwd());
 	if (inferredFromWorkspace) return inferredFromWorkspace;
 	return normalizeAgentId(params.fallbackAgentId);
 }
-function createDefaultTuiSessionKeySuffix() {
-	return `tui-${randomUUID()}`;
-}
-/** 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);
+/** Resolve TUI startup conversation identity and initial agent from CLI options and config. */
+function resolveTuiStartupConversationId(params) {
 	const sessionOption = (params.sessionOption ?? "").trim();
 	const agentId = resolveInitialTuiAgentId({
 		cfg: params.cfg,
 		fallbackAgentId: resolveDefaultTuiAgentId(params.cfg),
 		explicitAgentId: params.agentOption,
-		initialSessionInput: sessionOption,
 		cwd: params.cwd ?? process.cwd()
 	});
 	return {
-		sessionKey: resolveTuiSessionKey({
-			raw: sessionOption || (params.createSessionKeySuffix ?? createDefaultTuiSessionKeySuffix)(),
-			sessionScope,
-			currentAgentId: agentId,
-			sessionMainKey
-		}),
-		agentId,
-		sessionScope,
-		sessionMainKey
+		conversationId: resolveTuiConversationId({ raw: sessionOption || (params.createId ?? randomUUID)() }),
+		agentId
 	};
 }
 //#endregion
-export { createDefaultTuiSessionKeySuffix, resolveDefaultTuiAgentId, resolveInitialTuiAgentId, resolveTuiSessionKey, resolveTuiStartupSessionKey };
+export { resolveDefaultTuiAgentId, resolveInitialTuiAgentId, resolveTuiConversationId, resolveTuiStartupConversationId };

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

@@ -1,44 +1,11 @@
-/**
- * Session key parsing helpers for `agent:{agentId}:{rest}` keys.
- *
- * Re-exports the OpenClaw-aligned builder/parser surface from agent-session-key.ts.
- */
-import { defaultMainSessionKey } from './agent-session-key.js';
+import type { ConversationRouteInput } from './conversation-route.js';
 export * from './agent-session-key.js';
-export * from './session-key-utils.js';
+export { getConversationRouting } from '../storage/sqlite/conversation-repository.js';
 export declare function sanitizeSegment(value: string | undefined | null, options?: {
     allowLeadingDash?: boolean;
 }): string;
 export declare function isValidSegment(value: string | undefined | null): boolean;
-/** Structured view of an agent session key rest segment. */
-export interface ParsedSessionKey {
-    agentId: string;
-    source: string;
-    accountId: string;
-    peerKind: string;
-    peerId: string;
-    threadId?: string;
-    scopeId?: string;
-}
-export interface BuildSessionKeyParams {
-    agentId: string;
-    source: string;
-    accountId: string;
-    peerKind: string;
-    peerId: string;
-    threadId?: string | null;
-    scopeId?: string | null;
-    mainKey?: string;
-    dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';
-    identityLinks?: Record<string, string[]>;
-}
-/** Build an OpenClaw-style agent session key from routing segments. */
-export declare function buildSessionKey(params: BuildSessionKeyParams): string;
-/** Parse `agent:{agentId}:{rest}` into routing segments. Returns null for invalid keys. */
-export declare function parseSessionKey(sessionKey: string | undefined | null): ParsedSessionKey | null;
-export interface BuildSubagentSessionKeyParams extends BuildSessionKeyParams {
-    parentSessionKey: string;
-}
-export declare function buildSubagentSessionKey(params: BuildSubagentSessionKeyParams): string;
-export declare function getParentSessionKey(sessionKey: string | undefined | null): string | null;
-export { defaultMainSessionKey };
+export type BuildConversationIdParams = ConversationRouteInput;
+export declare function resolveConversationId(params: ConversationRouteInput): string;
+export declare function getParentConversationId(conversationId: string | undefined | null): string | null;
+export declare function normalizeConversationId(conversationId: string): string;

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

@@ -1,7 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId, normalizeOptionalAccountId } from "./account-id.js";
-import { getSubagentDepth, init_session_key_utils, isAcpSessionKey, isCronSessionKey, isSubagentSessionKey, parseAgentSessionKey, parseRawSessionConversationRef, parseThreadSessionSuffix, resolveThreadParentSessionKey } from "./session-key-utils.js";
-import { DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, assertAgentSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, buildGroupHistoryKey, classifySessionKeyShape, defaultMainSessionKey, init_agent_session_key, isValidAgentId, normalizeAgentId, normalizeMainKey, normalizeSessionKey, resolveAgentIdFromSessionKey, resolveThreadSessionKeys, sanitizeAgentId, scopedHeartbeatWakeOptions, toAgentRequestSessionKey, toAgentStoreSessionKey } from "./agent-session-key.js";
+import { validateConversationId } from "../../packages/gateway-contract/src/conversation-identity.js";
+import { init_src } from "../../packages/gateway-contract/src/index.js";
+import { getConversationRouting, init_conversation_repository, requireConversation, resolveRoutedConversation } from "../storage/sqlite/conversation-repository.js";
+import { DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, assertAgentConversationId, defaultMainConversationId, getConversation, init_agent_session_key, isCronConversationId, isSubagentConversationId, isValidAgentId, normalizeAgentId, normalizeMainKey, resolveAgentIdFromConversationId, resolveAgentMainConversationId, resolveAgentPeerConversationId, sanitizeAgentId } from "./agent-session-key.js";
 //#region src/routing/session-key.ts
 function sanitizeSegment(value, options) {
 	const trimmed = (value ?? "").trim();
@@ -17,170 +19,20 @@ function isValidSegment(value) {
 	if (!trimmed || trimmed.length > 64) return false;
 	return VALID_SEGMENT_RE.test(trimmed);
 }
-/** Build an OpenClaw-style agent session key from routing segments. */
-function buildSessionKey(params) {
-	const peerKind = params.peerKind === "dm" ? "direct" : params.peerKind;
-	let key = buildAgentPeerSessionKey({
-		agentId: params.agentId,
-		mainKey: params.mainKey,
-		channel: params.source,
-		accountId: params.accountId,
-		peerKind,
-		peerId: params.peerId,
-		identityLinks: params.identityLinks,
-		dmScope: params.dmScope ?? (peerKind === "direct" ? "per-account-channel-peer" : void 0)
-	});
-	if (params.threadId) key = resolveThreadSessionKeys({
-		baseSessionKey: key,
-		threadId: params.threadId
-	}).sessionKey;
-	if (params.scopeId) key = `${key}:scope:${sanitizeSegment(params.scopeId, { allowLeadingDash: true }) || "default"}`;
-	return key;
+function resolveConversationId(params) {
+	return resolveRoutedConversation(params);
 }
-/** Parse `agent:{agentId}:{rest}` into routing segments. Returns null for invalid keys. */
-function parseSessionKey(sessionKey) {
-	const raw = (sessionKey ?? "").trim();
-	if (!raw) return null;
-	const { baseSessionKey, threadId } = parseThreadSuffix(raw);
-	const agentParsed = parseAgentSessionKey(baseSessionKey);
-	if (!agentParsed) return null;
-	const scopeParts = parseScopeSuffix(agentParsed.rest);
-	const rest = scopeParts.rest;
-	const scopeId = scopeParts.scopeId;
-	const mainKey = normalizeMainKey(void 0);
-	if (rest === mainKey) return {
-		agentId: agentParsed.agentId,
-		source: "cli",
-		accountId: "default",
-		peerKind: "direct",
-		peerId: mainKey,
-		threadId,
-		scopeId
-	};
-	if (rest.startsWith("subagent:")) return parseSubagentRest(agentParsed.agentId, rest, threadId, scopeId);
-	if (rest.startsWith("cron:")) {
-		const parts = rest.split(":");
-		return {
-			agentId: agentParsed.agentId,
-			source: "cron",
-			accountId: "default",
-			peerKind: "direct",
-			peerId: parts.slice(1).join(":") || "cron",
-			threadId,
-			scopeId
-		};
-	}
-	const parts = rest.split(":").filter(Boolean);
-	if (parts.length >= 4 && parts[2] === "direct") return {
-		agentId: agentParsed.agentId,
-		source: parts[0],
-		accountId: parts[1],
-		peerKind: "direct",
-		peerId: parts.slice(3).join(":"),
-		threadId,
-		scopeId
-	};
-	if (parts.length >= 3 && parts[1] === "direct") return {
-		agentId: agentParsed.agentId,
-		source: parts[0],
-		accountId: "default",
-		peerKind: "direct",
-		peerId: parts.slice(2).join(":"),
-		threadId,
-		scopeId
-	};
-	if (parts.length >= 2 && parts[0] === "direct") return {
-		agentId: agentParsed.agentId,
-		source: "cli",
-		accountId: "default",
-		peerKind: "direct",
-		peerId: parts.slice(1).join(":"),
-		threadId,
-		scopeId
-	};
-	if (parts.length >= 3 && (parts[1] === "group" || parts[1] === "channel")) return {
-		agentId: agentParsed.agentId,
-		source: parts[0],
-		accountId: "default",
-		peerKind: parts[1],
-		peerId: parts.slice(2).join(":"),
-		threadId,
-		scopeId
-	};
-	return {
-		agentId: agentParsed.agentId,
-		source: "cli",
-		accountId: "default",
-		peerKind: "direct",
-		peerId: rest,
-		threadId,
-		scopeId
-	};
+function getParentConversationId(conversationId) {
+	return conversationId ? requireConversation(conversationId).parentConversationId ?? null : null;
 }
-function parseThreadSuffix(raw) {
-	const idx = raw.toLowerCase().lastIndexOf(":thread:");
-	if (idx === -1) return { baseSessionKey: raw };
-	return {
-		baseSessionKey: raw.slice(0, idx),
-		threadId: raw.slice(idx + 8)
-	};
-}
-function parseScopeSuffix(rest) {
-	const idx = rest.toLowerCase().lastIndexOf(":scope:");
-	if (idx === -1) return { rest };
-	return {
-		rest: rest.slice(0, idx),
-		scopeId: rest.slice(idx + 7)
-	};
-}
-function parseSubagentRest(parentAgentId, rest, threadId, scopeId) {
-	const body = rest.replace(/^subagent:/, "");
-	const parentKey = body ? `agent:${parentAgentId}:${body}` : "";
-	const parentParsed = parentKey ? parseSessionKey(parentKey) : null;
-	if (parentParsed) return {
-		...parentParsed,
-		agentId: "subagent",
-		threadId: threadId ?? parentParsed.threadId,
-		scopeId: scopeId ?? parentParsed.scopeId
-	};
-	return {
-		agentId: "subagent",
-		source: parentAgentId,
-		accountId: "default",
-		peerKind: "direct",
-		peerId: body || "unknown",
-		threadId,
-		scopeId
-	};
-}
-function buildSubagentSessionKey(params) {
-	const parentParsed = parseAgentSessionKey(params.parentSessionKey);
-	if (!parentParsed) throw new Error(`Invalid parent session key: ${params.parentSessionKey}`);
-	const parentRest = parentParsed.rest;
-	let key = `agent:${normalizeAgentId(parentParsed.agentId)}:subagent:${parentRest}`;
-	if (params.threadId) key = resolveThreadSessionKeys({
-		baseSessionKey: key,
-		threadId: params.threadId
-	}).sessionKey;
-	return key;
-}
-function getParentSessionKey(sessionKey) {
-	const parsed = parseSessionKey(sessionKey);
-	if (!parsed?.threadId) return null;
-	return buildSessionKey({
-		agentId: parsed.agentId,
-		source: parsed.source,
-		accountId: parsed.accountId,
-		peerKind: parsed.peerKind,
-		peerId: parsed.peerId,
-		scopeId: parsed.scopeId
-	});
+function normalizeConversationId(conversationId) {
+	return validateConversationId(conversationId);
 }
 var VALID_SEGMENT_RE, INVALID_CHARS_RE, LEADING_DASH_RE, TRAILING_DASH_RE;
 var init_session_key = __esmMin((() => {
+	init_src();
+	init_conversation_repository();
 	init_agent_session_key();
-	init_agent_session_key();
-	init_session_key_utils();
 	VALID_SEGMENT_RE = /^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/i;
 	INVALID_CHARS_RE = /[^a-z0-9_-]+/g;
 	LEADING_DASH_RE = /^-+/;
@@ -188,4 +40,4 @@ var init_session_key = __esmMin((() => {
 }));
 //#endregion
 init_session_key();
-export { DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, assertAgentSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, buildGroupHistoryKey, buildSessionKey, buildSubagentSessionKey, classifySessionKeyShape, defaultMainSessionKey, getParentSessionKey, getSubagentDepth, init_session_key, isAcpSessionKey, isCronSessionKey, isSubagentSessionKey, isValidAgentId, isValidSegment, normalizeAccountId, normalizeAgentId, normalizeMainKey, normalizeOptionalAccountId, normalizeSessionKey, parseAgentSessionKey, parseRawSessionConversationRef, parseSessionKey, parseThreadSessionSuffix, resolveAgentIdFromSessionKey, resolveThreadParentSessionKey, resolveThreadSessionKeys, sanitizeAgentId, sanitizeSegment, scopedHeartbeatWakeOptions, toAgentRequestSessionKey, toAgentStoreSessionKey };
+export { DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, assertAgentConversationId, defaultMainConversationId, getConversation, getConversationRouting, getParentConversationId, init_session_key, isCronConversationId, isSubagentConversationId, isValidAgentId, isValidSegment, normalizeAccountId, normalizeAgentId, normalizeConversationId, normalizeMainKey, normalizeOptionalAccountId, resolveAgentIdFromConversationId, resolveAgentMainConversationId, resolveAgentPeerConversationId, resolveConversationId, sanitizeAgentId, sanitizeSegment };

package/dist/src/session/client-history.js

@@ -1,7 +1,9 @@
 import { parseTurnOutcome } from "../../packages/gateway-contract/src/turn-outcome.js";
+import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 import { buildTranscriptOutline } from "./transcript-outline.js";
 //#region src/session/client-history.ts
+init_src();
 function sourceContextDisplayMetadata(metadata) {
 	if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return void 0;
 	const rows = metadata.sourceContexts;

package/dist/src/session/compaction-types.js

@@ -1,16 +1,5 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 //#region src/session/compaction-types.ts
-const HANDOVER_ITEM_KINDS = [
-	"objective",
-	"decision",
-	"pending_user_ask",
-	"todo",
-	"constraint",
-	"file_change",
-	"tool_outcome",
-	"failure",
-	"current_state",
-	"next_action"
-];
 function isCompactionHandover(value) {
 	if (!value || typeof value !== "object") return false;
 	const handover = value;
@@ -31,5 +20,21 @@ function isCompactionAudit(value) {
 	const audit = value;
 	return (audit.status === "passed" || audit.status === "degraded" || audit.status === "disabled") && (audit.mode === "structural" || audit.mode === "risk" || audit.mode === "full") && Number.isInteger(audit.missingItemsFound) && typeof audit.repaired === "boolean" && (audit.auditModelRef === void 0 || typeof audit.auditModelRef === "string");
 }
+var HANDOVER_ITEM_KINDS;
+var init_compaction_types = __esmMin((() => {
+	HANDOVER_ITEM_KINDS = [
+		"objective",
+		"decision",
+		"pending_user_ask",
+		"todo",
+		"constraint",
+		"file_change",
+		"tool_outcome",
+		"failure",
+		"current_state",
+		"next_action"
+	];
+}));
 //#endregion
-export { HANDOVER_ITEM_KINDS, isCompactionAudit, isCompactionHandover };
+init_compaction_types();
+export { HANDOVER_ITEM_KINDS, init_compaction_types, isCompactionAudit, isCompactionHandover };

package/dist/src/session/config-store.d.ts

@@ -6,14 +6,14 @@ export declare class SessionConfigStore {
     constructor(_agentHomeDir: string, cwd?: string);
     private requireDatabase;
     initialize(): Promise<void>;
-    get(sessionKey: string): Promise<SessionAgentConfig | null>;
-    set(sessionKey: string, config: SessionAgentConfig): Promise<void>;
-    update(sessionKey: string, partial: Partial<SessionAgentConfig>): Promise<SessionAgentConfig>;
-    delete(sessionKey: string): Promise<void>;
-    has(sessionKey: string): Promise<boolean>;
+    get(conversationId: string): Promise<SessionAgentConfig | null>;
+    set(conversationId: string, config: SessionAgentConfig): Promise<void>;
+    update(conversationId: string, partial: Partial<SessionAgentConfig>): Promise<SessionAgentConfig>;
+    delete(conversationId: string): Promise<void>;
+    has(conversationId: string): Promise<boolean>;
     getAll(): Promise<Map<string, SessionAgentConfig>>;
     clear(): Promise<void>;
 }
-export declare function resolveThinkingLevel(sessionConfigStore: SessionConfigStore, sessionKey: string, agentDefault?: ThinkLevel): Promise<ThinkLevel | undefined>;
-export declare function resolveReasoningLevel(sessionConfigStore: SessionConfigStore, sessionKey: string, agentDefault?: ReasoningLevel): Promise<ReasoningLevel | undefined>;
-export declare function resolveVerboseLevel(sessionConfigStore: SessionConfigStore, sessionKey: string, agentDefault?: VerboseLevel): Promise<VerboseLevel | undefined>;
+export declare function resolveThinkingLevel(sessionConfigStore: SessionConfigStore, conversationId: string, agentDefault?: ThinkLevel): Promise<ThinkLevel | undefined>;
+export declare function resolveReasoningLevel(sessionConfigStore: SessionConfigStore, conversationId: string, agentDefault?: ReasoningLevel): Promise<ReasoningLevel | undefined>;
+export declare function resolveVerboseLevel(sessionConfigStore: SessionConfigStore, conversationId: string, agentDefault?: VerboseLevel): Promise<VerboseLevel | undefined>;

package/dist/src/session/config-store.js

@@ -18,29 +18,29 @@ var SessionConfigStore = class {
 		this.requireDatabase();
 		log.debug("Session config store initialized (SQLite)");
 	}
-	async get(sessionKey) {
+	async get(conversationId) {
 		this.requireDatabase();
-		return getSessionConfig(sessionKey);
+		return getSessionConfig(conversationId);
 	}
-	async set(sessionKey, config) {
+	async set(conversationId, config) {
 		this.requireDatabase();
-		setSessionConfig(sessionKey, config, this.cwd);
-		log.debug({ sessionKey }, "Session config saved");
+		setSessionConfig(conversationId, config, this.cwd);
+		log.debug({ conversationId }, "Session config saved");
 	}
-	async update(sessionKey, partial) {
+	async update(conversationId, partial) {
 		this.requireDatabase();
-		const updated = updateSessionConfig(sessionKey, partial, this.cwd);
-		log.debug({ sessionKey }, "Session config updated");
+		const updated = updateSessionConfig(conversationId, partial, this.cwd);
+		log.debug({ conversationId }, "Session config updated");
 		return updated;
 	}
-	async delete(sessionKey) {
+	async delete(conversationId) {
 		this.requireDatabase();
-		deleteSessionConfig(sessionKey);
-		log.debug({ sessionKey }, "Session config deleted");
+		deleteSessionConfig(conversationId);
+		log.debug({ conversationId }, "Session config deleted");
 	}
-	async has(sessionKey) {
+	async has(conversationId) {
 		this.requireDatabase();
-		return hasSessionConfig(sessionKey);
+		return hasSessionConfig(conversationId);
 	}
 	async getAll() {
 		this.requireDatabase();
@@ -61,14 +61,14 @@ var SessionConfigStore = class {
 		log.debug("All session configs cleared");
 	}
 };
-async function resolveThinkingLevel(sessionConfigStore, sessionKey, agentDefault) {
-	return (await sessionConfigStore.get(sessionKey))?.thinkingLevel ?? agentDefault;
+async function resolveThinkingLevel(sessionConfigStore, conversationId, agentDefault) {
+	return (await sessionConfigStore.get(conversationId))?.thinkingLevel ?? agentDefault;
 }
-async function resolveReasoningLevel(sessionConfigStore, sessionKey, agentDefault) {
-	return (await sessionConfigStore.get(sessionKey))?.reasoningLevel ?? agentDefault;
+async function resolveReasoningLevel(sessionConfigStore, conversationId, agentDefault) {
+	return (await sessionConfigStore.get(conversationId))?.reasoningLevel ?? agentDefault;
 }
-async function resolveVerboseLevel(sessionConfigStore, sessionKey, agentDefault) {
-	return (await sessionConfigStore.get(sessionKey))?.verboseLevel ?? agentDefault;
+async function resolveVerboseLevel(sessionConfigStore, conversationId, agentDefault) {
+	return (await sessionConfigStore.get(conversationId))?.verboseLevel ?? agentDefault;
 }
 //#endregion
 export { SessionConfigStore, resolveReasoningLevel, resolveThinkingLevel, resolveVerboseLevel };

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

@@ -10,12 +10,12 @@ export { SessionStatus, type SessionMetadata, type SessionDetail, type SessionLi
 export { DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_IDLE_MINUTES, evaluateSessionFreshness, resolveDailyResetAtMs, resolveSessionResetPolicy, type SessionFreshness, type SessionResetConfig, type SessionResetMode, type SessionResetPolicy, type SessionResetType, } from './reset-policy.js';
 export { resolveChannelResetConfig, resolveSessionResetType, } from './reset-type.js';
 export { resolveSessionLifecycleTimestamps, type SessionLifecycleEntry } from './lifecycle-timestamps.js';
-export { resolveSession, resolveSessionKeyForRequest, type SessionKeyResolution, type SessionResolution, } from './resolve-session.js';
+export { resolveSession, resolveConversationIdForRequest, type ConversationIdResolution, type SessionResolution, } from './resolve-session.js';
 export { initSessionTurn, type InitSessionTurnOptions, type InitSessionTurnResult, type SessionResetFn, } from './init-session-turn.js';
 export { DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, bareResetAckMessage, matchResetTriggers, resolveResetTriggers, shouldSkipResetOverlapCommand, stripLeadingEnvelopeTimestamp, type ResetTriggerMatch, } from './reset-triggers.js';
 export type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';
 export type { WindowConfig } from '../agent/memory/window.js';
-export { maybeSetProvisionalSessionTitle, maybeRefineSessionTitleWithLlm, generateSessionTitleFromMessages, sanitizeSessionTitle, sanitizeGeneratedSessionTitle, provisionalTitleFromUserText, fallbackTitleFromMessages, getSessionTitleSource, shouldRefineSessionTitleWithLlm, isWebchatSessionKey, shouldAutoTitleSessionKey, type SessionTitleSource, } from './session-title.js';
+export { maybeSetProvisionalSessionTitle, maybeRefineSessionTitleWithLlm, generateSessionTitleFromMessages, sanitizeSessionTitle, sanitizeGeneratedSessionTitle, provisionalTitleFromUserText, fallbackTitleFromMessages, getSessionTitleSource, shouldRefineSessionTitleWithLlm, isWebchatConversationId, shouldAutoTitleConversationId, type SessionTitleSource, } from './session-title.js';
 export { messagesToClientHistory, flattenMessageContent, type ClientHistoryMessage } from './client-history.js';
 export { XOPC_SESSION_TRANSCRIPT_TYPE, CURRENT_SESSION_TRANSCRIPT_VERSION, } from './transcript-format.js';
 export { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray, type TranscriptStoredRow, type XopcTranscriptContextEntry, } from './session-context-for-llm.js';