@xopcai/xopc 0.0.285 → 0.0.286

package/dist/src/session/index.js

@@ -1,9 +1,9 @@
-import { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
-import { SessionStatus } from "./types.js";
+import { buildSessionContextForLlm, init_session_context_for_llm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
+import { SessionStatus, init_types } from "./types.js";
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath } from "./session-workspace.js";
 import { flattenMessageContent, messagesToClientHistory } from "./client-history.js";
 import { emitSessionTranscriptUpdate, onSessionTranscriptUpdate } from "./transcript-events.js";
-import { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatSessionKey, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm } from "./session-title.js";
+import { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatConversationId, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleConversationId, shouldRefineSessionTitleWithLlm } from "./session-title.js";
 import { SessionStore } from "./store.js";
 import { applySessionPatchToMetadata } from "./patch-metadata.js";
 import { SessionIndex } from "./manager.js";
@@ -12,8 +12,12 @@ import { DEFAULT_ACTIVITY_DETAIL_LEVEL, resolveConfiguredActivityDetailDefault,
 import { DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, evaluateSessionFreshness, resolveDailyResetAtMs, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
 import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";
-import { resolveSession, resolveSessionKeyForRequest } from "./resolve-session.js";
+import { resolveConversationIdForRequest, resolveSession } from "./resolve-session.js";
 import { DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, bareResetAckMessage, matchResetTriggers, resolveResetTriggers, shouldSkipResetOverlapCommand, stripLeadingEnvelopeTimestamp } from "./reset-triggers.js";
 import { initSessionTurn } from "./init-session-turn.js";
 import { CURRENT_SESSION_TRANSCRIPT_VERSION, XOPC_SESSION_TRANSCRIPT_TYPE } from "./transcript-format.js";
-export { CURRENT_SESSION_TRANSCRIPT_VERSION, DEFAULT_ACTIVITY_DETAIL_LEVEL, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, SessionConfigStore, SessionIndex, SessionStatus, SessionStore, XOPC_SESSION_TRANSCRIPT_TYPE, applySessionPatchToMetadata, bareResetAckMessage, buildSessionContextForLlm, effectiveWorkspacePathForSession, emitSessionTranscriptUpdate, evaluateSessionFreshness, fallbackTitleFromMessages, flattenMessageContent, generateSessionTitleFromMessages, getSessionTitleSource, initSessionTurn, isTranscriptContextEntry, isWebchatSessionKey, matchResetTriggers, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, projectWorkspacePath, provisionalTitleFromUserText, resolveChannelResetConfig, resolveConfiguredActivityDetailDefault, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionKeyForRequest, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };
+//#region src/session/index.ts
+init_types();
+init_session_context_for_llm();
+//#endregion
+export { CURRENT_SESSION_TRANSCRIPT_VERSION, DEFAULT_ACTIVITY_DETAIL_LEVEL, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, SessionConfigStore, SessionIndex, SessionStatus, SessionStore, XOPC_SESSION_TRANSCRIPT_TYPE, applySessionPatchToMetadata, bareResetAckMessage, buildSessionContextForLlm, effectiveWorkspacePathForSession, emitSessionTranscriptUpdate, evaluateSessionFreshness, fallbackTitleFromMessages, flattenMessageContent, generateSessionTitleFromMessages, getSessionTitleSource, initSessionTurn, isTranscriptContextEntry, isWebchatConversationId, matchResetTriggers, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, projectWorkspacePath, provisionalTitleFromUserText, resolveChannelResetConfig, resolveConfiguredActivityDetailDefault, resolveConversationIdForRequest, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleConversationId, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };

package/dist/src/session/init-session-turn.d.ts

@@ -1,12 +1,12 @@
 import { type Config } from '../config/schema.js';
-export type SessionResetFn = (sessionKey: string) => Promise<{
-    sessionId: string;
-    previousSessionId: string;
+export type SessionResetFn = (conversationId: string) => Promise<{
+    transcriptId: string;
+    previousTranscriptId: string;
 } | null>;
 export type InitSessionTurnResult = {
-    sessionKey: string;
-    sessionId?: string;
-    previousSessionId?: string;
+    conversationId: string;
+    transcriptId?: string;
+    previousTranscriptId?: string;
     isNewSession: boolean;
     resetTriggered: boolean;
     staleRollover: boolean;
@@ -16,7 +16,7 @@ export type InitSessionTurnResult = {
 };
 export type InitSessionTurnOptions = {
     cfg: Config;
-    sessionKey: string;
+    conversationId: string;
     body?: string;
     resetSession: SessionResetFn;
 };

package/dist/src/session/init-session-turn.js

@@ -6,7 +6,7 @@ import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
 import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";
-import { resolveSessionKeyForRequest } from "./resolve-session.js";
+import { resolveConversationIdForRequest } from "./resolve-session.js";
 import { bareResetAckMessage, matchResetTriggers, resolveResetTriggers } from "./reset-triggers.js";
 import { randomUUID } from "node:crypto";
 //#region src/session/init-session-turn.ts
@@ -19,11 +19,11 @@ async function initSessionTurn(opts) {
 	const triggers = resolveResetTriggers(sessionCfg.resetTriggers);
 	const rawBody = opts.body ?? "";
 	const triggerMatch = matchResetTriggers(rawBody, triggers);
-	const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest({
+	const { conversationId, sessionMetadata } = await resolveConversationIdForRequest({
 		cfg: opts.cfg,
-		sessionKey: opts.sessionKey
+		conversationId: opts.conversationId
 	});
-	const key = sessionKey?.trim() ?? opts.sessionKey.trim();
+	const key = conversationId?.trim() ?? opts.conversationId.trim();
 	const routing = sessionMetadata?.routing;
 	const peerKind = routing?.peerKind;
 	const resetType = resolveSessionResetType({
@@ -52,38 +52,38 @@ async function initSessionTurn(opts) {
 	}) : { fresh: false };
 	const staleRollover = Boolean(sessionMetadata && resetPolicy.configured === true && !freshness.fresh);
 	const needsRollover = triggerMatch.resetTriggered || staleRollover;
-	let sessionId = sessionMetadata?.sessionId;
-	let previousSessionId;
+	let transcriptId = sessionMetadata?.transcriptId;
+	let previousTranscriptId;
 	let isNewSession = false;
-	if (needsRollover && sessionMetadata?.sessionId) {
+	if (needsRollover && sessionMetadata?.transcriptId) {
 		const task = await opts.resetSession(key);
 		if (task) {
-			previousSessionId = task.previousSessionId;
-			sessionId = task.sessionId;
+			previousTranscriptId = task.previousTranscriptId;
+			transcriptId = task.transcriptId;
 			isNewSession = true;
 			log.info({
-				sessionKey: key,
-				sessionId: task.sessionId,
-				previousSessionId: task.previousSessionId,
+				conversationId: key,
+				transcriptId: task.transcriptId,
+				previousTranscriptId: task.previousTranscriptId,
 				resetTriggered: triggerMatch.resetTriggered,
 				staleRollover,
 				resetType
 			}, triggerMatch.resetTriggered ? "Session reset via reset trigger" : "Session rolled over (stale freshness)");
 		} else {
-			log.warn({ sessionKey: key }, "Session rollover requested but resetSession returned null");
-			sessionId = randomUUID();
+			log.warn({ conversationId: key }, "Session rollover requested but resetSession returned null");
+			transcriptId = randomUUID();
 			isNewSession = true;
 		}
 	} else if (!sessionMetadata) {
 		isNewSession = true;
-		sessionId = randomUUID();
+		transcriptId = randomUUID();
 	}
 	const bareReset = triggerMatch.resetTriggered && triggerMatch.bareReset;
 	const ackMessage = bareReset ? bareResetAckMessage(triggerMatch.matchedTrigger) : void 0;
 	return {
-		sessionKey: key,
-		sessionId,
-		previousSessionId,
+		conversationId: key,
+		transcriptId,
+		previousTranscriptId,
 		isNewSession,
 		resetTriggered: triggerMatch.resetTriggered,
 		staleRollover,

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

@@ -55,7 +55,7 @@ export declare class SessionIndex extends EventEmitter {
         error: string;
     }>;
     getSessionMetadata(key: string): Promise<SessionMetadata | null>;
-    resolveSessionKeyBySessionId(sessionId: string): Promise<string | null>;
+    resolveConversationIdByTranscriptId(transcriptId: string): Promise<string | null>;
     deleteSession(key: string): Promise<boolean>;
     deleteSessions(keys: string[]): Promise<{
         success: string[];
@@ -76,17 +76,17 @@ export declare class SessionIndex extends EventEmitter {
     searchInSession(key: string, keyword: string): Promise<Message[]>;
     exportSession(key: string, format: ExportFormat): Promise<string>;
     importSessionExport(targetKey: string, jsonContent: string): Promise<{
-        sessionKey: string;
+        conversationId: string;
         rowCount: number;
     }>;
     forkSession(sourceKey: string, targetKey: string): Promise<{
-        sessionKey: string;
+        conversationId: string;
         rowCount: number;
     }>;
     forkSessionRows(sourceKey: string, targetKey: string, options?: {
         throughRow?: number;
     }): Promise<{
-        sessionKey: string;
+        conversationId: string;
         rowCount: number;
     }>;
     forkSessionAtTurn(sourceKey: string, options: import('./store.js').ForkSessionAtTurnOptions): Promise<import('./store.js').ForkSessionResult>;
@@ -149,7 +149,7 @@ export declare class SessionIndex extends EventEmitter {
         data?: unknown;
     }): Promise<void>;
     appendTranscriptCustomMessageEntry(key: string, entry: {
-        expectedSessionId?: string;
+        expectedTranscriptId?: string;
         customType: string;
         content?: string | unknown[];
         display?: boolean;
@@ -168,8 +168,8 @@ export declare class SessionIndex extends EventEmitter {
     delete(key: string): Promise<void>;
     /** Archive transcript and start a new session id for the same key. */
     resetSession(key: string): Promise<{
-        sessionId: string;
-        previousSessionId: string;
+        transcriptId: string;
+        previousTranscriptId: string;
     } | null>;
     /** Token/window stats for a message list */
     getWindowStats(messages: any[]): {

package/dist/src/session/manager.js

@@ -58,8 +58,8 @@ var SessionIndex = class extends EventEmitter$1 {
 	async getSessionMetadata(key) {
 		return this.store.getMetadata(key);
 	}
-	async resolveSessionKeyBySessionId(sessionId) {
-		return this.store.resolveKeyBySessionId(sessionId);
+	async resolveConversationIdByTranscriptId(transcriptId) {
+		return this.store.resolveKeyByTranscriptId(transcriptId);
 	}
 	async deleteSession(key) {
 		const result = await this.store.delete(key);
@@ -155,25 +155,25 @@ var SessionIndex = class extends EventEmitter$1 {
 	}
 	async importSessionExport(targetKey, jsonContent) {
 		const result = await this.store.importSessionExport(targetKey, jsonContent);
-		const metadata = await this.store.getMetadata(result.sessionKey);
+		const metadata = await this.store.getMetadata(result.conversationId);
 		if (metadata) this.emit("sessionCreated", metadata);
 		return result;
 	}
 	async forkSession(sourceKey, targetKey) {
 		const result = await this.store.forkSession(sourceKey, targetKey);
-		const metadata = await this.store.getMetadata(result.sessionKey);
+		const metadata = await this.store.getMetadata(result.conversationId);
 		if (metadata) this.emit("sessionCreated", metadata);
 		return result;
 	}
 	async forkSessionRows(sourceKey, targetKey, options = {}) {
 		const result = await this.store.forkSessionRows(sourceKey, targetKey, options);
-		const metadata = await this.store.getMetadata(result.sessionKey);
+		const metadata = await this.store.getMetadata(result.conversationId);
 		if (metadata) this.emit("sessionCreated", metadata);
 		return result;
 	}
 	async forkSessionAtTurn(sourceKey, options) {
 		const result = await this.store.forkSessionAtTurn(sourceKey, options);
-		const metadata = await this.store.getMetadata(result.sessionKey);
+		const metadata = await this.store.getMetadata(result.conversationId);
 		if (metadata) this.emit("sessionCreated", metadata);
 		return result;
 	}

package/dist/src/session/model-config-lock.d.ts

@@ -1,2 +1,2 @@
 /** Serialize configuration changes with input acceptance for one conversation. */
-export declare function withModelConfigLock<T>(sessionKey: string, operation: () => Promise<T>): Promise<T>;
+export declare function withModelConfigLock<T>(conversationId: string, operation: () => Promise<T>): Promise<T>;

package/dist/src/session/model-config-lock.js

@@ -1,13 +1,13 @@
 //#region src/session/model-config-lock.ts
 const pending = /* @__PURE__ */ new Map();
 /** Serialize configuration changes with input acceptance for one conversation. */
-async function withModelConfigLock(sessionKey, operation) {
-	const next = (pending.get(sessionKey) ?? Promise.resolve()).catch(() => void 0).then(operation);
-	pending.set(sessionKey, next);
+async function withModelConfigLock(conversationId, operation) {
+	const next = (pending.get(conversationId) ?? Promise.resolve()).catch(() => void 0).then(operation);
+	pending.set(conversationId, next);
 	try {
 		return await next;
 	} finally {
-		if (pending.get(sessionKey) === next) pending.delete(sessionKey);
+		if (pending.get(conversationId) === next) pending.delete(conversationId);
 	}
 }
 //#endregion

package/dist/src/session/resolve-session.d.ts

@@ -2,26 +2,26 @@ import { type Config } from '../config/schema.js';
 import { type ThinkLevel, type VerboseLevel } from '../agent/transcript/thinking-types.js';
 import type { SessionMetadata } from './types.js';
 export type SessionResolution = {
-    sessionId: string;
-    sessionKey?: string;
+    transcriptId: string;
+    conversationId?: string;
     sessionMetadata?: SessionMetadata | null;
     isNewSession: boolean;
     persistedThinking?: ThinkLevel;
     persistedVerbose?: VerboseLevel;
 };
-export type SessionKeyResolution = {
-    sessionKey?: string;
+export type ConversationIdResolution = {
+    conversationId?: string;
     sessionMetadata?: SessionMetadata | null;
 };
-export declare function resolveSessionKeyForRequest(opts: {
+export declare function resolveConversationIdForRequest(opts: {
     cfg: Config;
-    sessionKey?: string;
-    sessionId?: string;
+    conversationId?: string;
+    transcriptId?: string;
     agentId?: string;
-}): Promise<SessionKeyResolution>;
+}): Promise<ConversationIdResolution>;
 export declare function resolveSession(opts: {
     cfg: Config;
-    sessionKey?: string;
-    sessionId?: string;
+    conversationId?: string;
+    transcriptId?: string;
     agentId?: string;
 }): Promise<SessionResolution>;

package/dist/src/session/resolve-session.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
-import { findSessionKeyBySessionId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
+import { findConversationIdByTranscriptId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
 import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
@@ -13,21 +13,21 @@ import { randomUUID } from "node:crypto";
 init_schema();
 init_logger();
 const log = createLogger("ResolveSession");
-async function resolveSessionKeyForRequest(opts) {
+async function resolveConversationIdForRequest(opts) {
 	requireXopcDatabase();
-	const explicitKey = opts.sessionKey?.trim();
-	const requestedSessionId = opts.sessionId?.trim();
-	let sessionKey = explicitKey;
-	if (requestedSessionId && !sessionKey) sessionKey = findSessionKeyBySessionId(requestedSessionId) ?? void 0;
-	const sessionMetadata = sessionKey ? getSessionMetadata(sessionKey) : null;
+	const explicitKey = opts.conversationId?.trim();
+	const requestedTranscriptId = opts.transcriptId?.trim();
+	let conversationId = explicitKey;
+	if (requestedTranscriptId && !conversationId) conversationId = findConversationIdByTranscriptId(requestedTranscriptId) ?? void 0;
+	const sessionMetadata = conversationId ? getSessionMetadata(conversationId) : null;
 	return {
-		sessionKey,
+		conversationId,
 		sessionMetadata
 	};
 }
 async function resolveSession(opts) {
 	const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});
-	const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest(opts);
+	const { conversationId, sessionMetadata } = await resolveConversationIdForRequest(opts);
 	const now = Date.now();
 	const routing = sessionMetadata?.routing;
 	const peerKind = routing?.peerKind;
@@ -54,22 +54,22 @@ async function resolveSession(opts) {
 		now,
 		policy: resetPolicy
 	}) : { fresh: false }).fresh;
-	const sessionId = opts.sessionId?.trim() || (fresh ? sessionMetadata?.sessionId : void 0) || randomUUID();
-	const isNewSession = !fresh && !opts.sessionId?.trim();
-	if (isNewSession && sessionKey) log.debug({
-		sessionKey,
-		previousSessionId: sessionMetadata?.sessionId,
-		sessionId,
+	const transcriptId = opts.transcriptId?.trim() || (fresh ? sessionMetadata?.transcriptId : void 0) || randomUUID();
+	const isNewSession = !fresh && !opts.transcriptId?.trim();
+	if (isNewSession && conversationId) log.debug({
+		conversationId,
+		previousTranscriptId: sessionMetadata?.transcriptId,
+		transcriptId,
 		resetType
 	}, "Session reset boundary: new session id for turn");
 	return {
-		sessionId,
-		sessionKey,
+		transcriptId,
+		conversationId,
 		sessionMetadata,
 		isNewSession,
-		persistedThinking: fresh && sessionKey ? normalizeThinkLevel(getSessionPersistedLevels(sessionKey)?.thinkingLevel ?? void 0) : void 0,
-		persistedVerbose: fresh && sessionKey ? normalizeVerboseLevel(getSessionPersistedLevels(sessionKey)?.verboseLevel ?? void 0) : void 0
+		persistedThinking: fresh && conversationId ? normalizeThinkLevel(getSessionPersistedLevels(conversationId)?.thinkingLevel ?? void 0) : void 0,
+		persistedVerbose: fresh && conversationId ? normalizeVerboseLevel(getSessionPersistedLevels(conversationId)?.verboseLevel ?? void 0) : void 0
 	};
 }
 //#endregion
-export { resolveSession, resolveSessionKeyForRequest };
+export { resolveConversationIdForRequest, resolveSession };

package/dist/src/session/session-context-for-llm.js

@@ -1,5 +1,6 @@
-import { voiceTranscriptMessage } from "./voice-transcript.js";
-import { isCompactionAudit, isCompactionHandover } from "./compaction-types.js";
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { init_voice_transcript, voiceTranscriptMessage } from "./voice-transcript.js";
+import { init_compaction_types, isCompactionAudit, isCompactionHandover } from "./compaction-types.js";
 //#region src/session/session-context-for-llm.ts
 function isTranscriptContextEntry(x) {
 	if (!x || typeof x !== "object") return false;
@@ -37,13 +38,6 @@ function isTranscriptMetadataEntry(x) {
 	const type = x.type;
 	return type === "thinking_level_change" || type === "model_change" || type === "session_info";
 }
-const LLM_ROLES = new Set([
-	"user",
-	"assistant",
-	"system",
-	"tool",
-	"toolResult"
-]);
 function isLikelyAgentMessage(x) {
 	if (!x || typeof x !== "object") return false;
 	const role = x.role;
@@ -332,5 +326,18 @@ function mergeLlmMessagesPreservingContextRows(prevRows, llmMessages) {
 	}
 	return out;
 }
+var LLM_ROLES;
+var init_session_context_for_llm = __esmMin((() => {
+	init_voice_transcript();
+	init_compaction_types();
+	LLM_ROLES = new Set([
+		"user",
+		"assistant",
+		"system",
+		"tool",
+		"toolResult"
+	]);
+}));
 //#endregion
-export { buildSessionContextForLlm, buildSessionDisplayMessages, isRuntimeOnlyTranscriptMessage, isTranscriptBashExecutionEntry, isTranscriptCompactionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptCustomStateEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSummaryMessageEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray };
+init_session_context_for_llm();
+export { buildSessionContextForLlm, buildSessionDisplayMessages, init_session_context_for_llm, isRuntimeOnlyTranscriptMessage, isTranscriptBashExecutionEntry, isTranscriptCompactionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptCustomStateEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSummaryMessageEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray };

package/dist/src/session/session-title.d.ts

@@ -3,9 +3,9 @@
  */
 import type { AgentMessage } from '@earendil-works/pi-agent-core';
 import type { SessionStore } from './store.js';
-export declare function isWebchatSessionKey(sessionKey: string): boolean;
+export declare function isWebchatConversationId(conversationId: string): boolean;
 /** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */
-export declare function shouldAutoTitleSessionKey(sessionKey: string): boolean;
+export declare function shouldAutoTitleConversationId(conversationId: string): boolean;
 export declare function sanitizeSessionTitle(raw: string): string;
 /** Strip leading reasoning blocks emitted as raw text by some model providers. */
 export declare function sanitizeGeneratedSessionTitle(raw: string): string;
@@ -21,7 +21,7 @@ export declare function fallbackTitleFromMessages(messages: AgentMessage[]): str
  * Returns a title string, or null if generation should be skipped or failed.
  */
 export declare function generateSessionTitleFromMessages(modelRef: string, messages: AgentMessage[], signal?: AbortSignal): Promise<string | null>;
-export type SessionTitleUpdatedHook = (sessionKey: string, name: string) => void | Promise<void>;
+export type SessionTitleUpdatedHook = (conversationId: string, name: string) => void | Promise<void>;
 /** Whether post-turn LLM refine may run (provisional or still unnamed; not user-locked). */
 export declare function shouldRefineSessionTitleWithLlm(meta: {
     name?: string;
@@ -31,8 +31,8 @@ export declare function shouldRefineSessionTitleWithLlm(meta: {
  * Set provisional title from first user text when session is still unnamed.
  * Skips cron/heartbeat keys and user-locked titles.
  */
-export declare function maybeSetProvisionalSessionTitle(sessionStore: SessionStore, sessionKey: string, userText?: string, onUpdated?: SessionTitleUpdatedHook): Promise<void>;
+export declare function maybeSetProvisionalSessionTitle(sessionStore: SessionStore, conversationId: string, userText?: string, onUpdated?: SessionTitleUpdatedHook): Promise<void>;
 /**
  * LLM refine when title is empty or still provisional (not user-locked).
  */
-export declare function maybeRefineSessionTitleWithLlm(sessionStore: SessionStore, sessionKey: string, modelRef: string | undefined, onUpdated?: SessionTitleUpdatedHook): Promise<void>;
+export declare function maybeRefineSessionTitleWithLlm(sessionStore: SessionStore, conversationId: string, modelRef: string | undefined, onUpdated?: SessionTitleUpdatedHook): Promise<void>;

package/dist/src/session/session-title.js

@@ -1,7 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { isCronSessionKey } from "../routing/session-key-utils.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
+import { isCronConversationId } from "../routing/agent-session-key.js";
+import { init_session_key } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
@@ -65,16 +66,15 @@ function firstAssistantText(messages) {
 	}
 	return "";
 }
-function isWebchatSessionKey(sessionKey) {
-	if (parseSessionKey(sessionKey)?.source === "webchat") return true;
-	return sessionKey.includes(":webchat:");
+function isWebchatConversationId(conversationId) {
+	return getConversationRouting(conversationId)?.source === "webchat";
 }
 /** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */
-function shouldAutoTitleSessionKey(sessionKey) {
-	const raw = (sessionKey ?? "").trim();
+function shouldAutoTitleConversationId(conversationId) {
+	const raw = (conversationId ?? "").trim();
 	if (!raw) return false;
-	if (isCronSessionKey(raw)) return false;
-	if (raw.toLowerCase().startsWith("heartbeat:")) return false;
+	if (isCronConversationId(raw)) return false;
+	if (getConversationRouting(raw)?.source === "heartbeat") return false;
 	return true;
 }
 function sanitizeSessionTitle(raw) {
@@ -203,49 +203,49 @@ function canAutoWriteTitle(meta) {
 * Set provisional title from first user text when session is still unnamed.
 * Skips cron/heartbeat keys and user-locked titles.
 */
-async function maybeSetProvisionalSessionTitle(sessionStore, sessionKey, userText, onUpdated) {
-	if (!shouldAutoTitleSessionKey(sessionKey)) return;
-	let meta = await sessionStore.getMetadata(sessionKey);
+async function maybeSetProvisionalSessionTitle(sessionStore, conversationId, userText, onUpdated) {
+	if (!shouldAutoTitleConversationId(conversationId)) return;
+	let meta = await sessionStore.getMetadata(conversationId);
 	if (!meta) return;
 	if (!canAutoWriteTitle(meta)) return;
 	let title = null;
 	if (userText?.trim()) title = provisionalTitleFromUserText(userText);
 	if (!title) {
-		const messages = await sessionStore.load(sessionKey);
+		const messages = await sessionStore.load(conversationId);
 		if (!messages.length) return;
 		title = fallbackTitleFromMessages(messages);
 	}
 	if (!title) return;
 	try {
-		await sessionStore.updateMetadata(sessionKey, {
+		await sessionStore.updateMetadata(conversationId, {
 			name: title,
 			customData: {
 				...meta.customData ?? {},
 				titleSource: "provisional"
 			}
 		});
-		await onUpdated?.(sessionKey, title);
+		await onUpdated?.(conversationId, title);
 	} catch (err) {
 		log.warn({
 			err,
-			sessionKey
+			conversationId
 		}, "Session title: provisional updateMetadata failed");
 	}
 }
 /**
 * LLM refine when title is empty or still provisional (not user-locked).
 */
-async function maybeRefineSessionTitleWithLlm(sessionStore, sessionKey, modelRef, onUpdated) {
-	if (!shouldAutoTitleSessionKey(sessionKey)) return;
-	let messages = await sessionStore.load(sessionKey);
+async function maybeRefineSessionTitleWithLlm(sessionStore, conversationId, modelRef, onUpdated) {
+	if (!shouldAutoTitleConversationId(conversationId)) return;
+	let messages = await sessionStore.load(conversationId);
 	if (!messages.length) return;
-	let meta = await sessionStore.getMetadata(sessionKey);
+	let meta = await sessionStore.getMetadata(conversationId);
 	if (!meta) {
-		await sessionStore.saveMessages(sessionKey, messages);
-		meta = await sessionStore.getMetadata(sessionKey);
+		await sessionStore.saveMessages(conversationId, messages);
+		meta = await sessionStore.getMetadata(conversationId);
 	}
 	if (!meta) {
-		log.warn({ sessionKey }, "Session title: metadata missing after save");
+		log.warn({ conversationId }, "Session title: metadata missing after save");
 		return;
 	}
 	if (!shouldRefineSessionTitleWithLlm(meta)) return;
@@ -265,7 +265,7 @@ async function maybeRefineSessionTitleWithLlm(sessionStore, sessionKey, modelRef
 	if (!title) return;
 	if (meta.name?.trim() === title) {
 		if (source !== "llm") try {
-			await sessionStore.updateMetadata(sessionKey, { customData: {
+			await sessionStore.updateMetadata(conversationId, { customData: {
 				...meta.customData ?? {},
 				titleSource: "llm"
 			} });
@@ -273,20 +273,20 @@ async function maybeRefineSessionTitleWithLlm(sessionStore, sessionKey, modelRef
 		return;
 	}
 	try {
-		await sessionStore.updateMetadata(sessionKey, {
+		await sessionStore.updateMetadata(conversationId, {
 			name: title,
 			customData: {
 				...meta.customData ?? {},
 				titleSource: "llm"
 			}
 		});
-		await onUpdated?.(sessionKey, title);
+		await onUpdated?.(conversationId, title);
 	} catch (err) {
 		log.warn({
 			err,
-			sessionKey
+			conversationId
 		}, "Session title: refine updateMetadata failed");
 	}
 }
 //#endregion
-export { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatSessionKey, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm };
+export { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatConversationId, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleConversationId, shouldRefineSessionTitleWithLlm };

package/dist/src/session/session-workspace.d.ts

@@ -19,4 +19,4 @@ export declare function projectWorkspacePath(project: Pick<Project, 'workspaceRo
  * Resolved workspace for tools/shell: bound execution environment, project workspace,
  * session override, or merged agent profile default.
  */
-export declare function effectiveWorkspacePathForSession(cfg: Config, sessionKey: string, sessionAgentConfig: SessionAgentConfig | null | undefined, project?: Pick<Project, 'workspaceRoot'> | null): string;
+export declare function effectiveWorkspacePathForSession(cfg: Config, conversationId: string, sessionAgentConfig: SessionAgentConfig | null | undefined, project?: Pick<Project, 'workspaceRoot'> | null): string;

package/dist/src/session/session-workspace.js

@@ -33,9 +33,9 @@ function projectWorkspacePath(project) {
 * Resolved workspace for tools/shell: bound execution environment, project workspace,
 * session override, or merged agent profile default.
 */
-function effectiveWorkspacePathForSession(cfg, sessionKey, sessionAgentConfig, project) {
-	const base = resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;
-	const environment = getExecutionEnvironmentForSession(sessionKey);
+function effectiveWorkspacePathForSession(cfg, conversationId, sessionAgentConfig, project) {
+	const base = resolveEffectiveAgentProfileForSession(cfg, conversationId).resolvedWorkspacePath;
+	const environment = getExecutionEnvironmentForSession(conversationId);
 	if (environment) return environment.rootPath;
 	const projectWorkspace = projectWorkspacePath(project);
 	if (projectWorkspace) return projectWorkspace;