@xopcai/xopc 0.0.113 → 0.0.115

package/dist/src/session/index.js

@@ -11,11 +11,11 @@ import { resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel } from ".
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput } from "./session-workspace.js";
 import { shouldSkipWebchatInboundByAbortCutoff } from "./abort-cutoff.js";
 import { DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, evaluateSessionFreshness, resolveDailyResetAtMs, resolveSessionResetPolicy } from "./reset-policy.js";
-import { isThreadSessionKey, resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
+import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
 import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";
 import { resolveSession, resolveSessionKeyForRequest } 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 { flattenMessageContent, messagesToClientHistory } from "./client-history.js";
 import { CURRENT_SESSION_TRANSCRIPT_VERSION, XOPC_SESSION_TRANSCRIPT_TYPE } from "./transcript-format.js";
-export { CURRENT_SESSION_TRANSCRIPT_VERSION, 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, isThreadSessionKey, isTranscriptContextEntry, isWebchatSessionKey, matchResetTriggers, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeCompactionCheckpointId, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, provisionalTitleFromUserText, resolveChannelResetConfig, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionKeyForRequest, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, shouldSkipWebchatInboundByAbortCutoff, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };
+export { CURRENT_SESSION_TRANSCRIPT_VERSION, 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, normalizeCompactionCheckpointId, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, provisionalTitleFromUserText, resolveChannelResetConfig, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionKeyForRequest, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, shouldSkipWebchatInboundByAbortCutoff, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };

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

@@ -1,7 +1,6 @@
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import "../storage/sqlite/index.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
@@ -12,7 +11,6 @@ import { bareResetAckMessage, matchResetTriggers, resolveResetTriggers } from ".
 import { randomUUID } from "node:crypto";
 //#region src/session/init-session-turn.ts
 init_schema();
-init_session_key();
 init_logger();
 const log = createLogger("InitSessionTurn");
 async function initSessionTurn(opts) {
@@ -26,19 +24,18 @@ async function initSessionTurn(opts) {
 		sessionKey: opts.sessionKey
 	});
 	const key = sessionKey?.trim() ?? opts.sessionKey.trim();
-	const parsed = key ? parseSessionKey(key) : null;
-	const peerKind = parsed?.peerKind;
+	const routing = sessionMetadata?.routing;
+	const peerKind = routing?.peerKind;
 	const resetType = resolveSessionResetType({
-		sessionKey: key,
 		isGroup: peerKind === "group" || peerKind === "channel",
-		isThread: Boolean(parsed?.threadId)
+		isThread: Boolean(routing?.threadId)
 	});
 	const resetPolicy = resolveSessionResetPolicy({
 		sessionCfg,
 		resetType,
 		resetOverride: resolveChannelResetConfig({
 			sessionCfg,
-			channel: parsed?.source ?? sessionMetadata?.sourceChannel
+			channel: routing?.source ?? sessionMetadata?.sourceChannel
 		})
 	});
 	const lifecycle = resolveSessionLifecycleTimestamps({ entry: sessionMetadata ? {
@@ -56,10 +53,10 @@ async function initSessionTurn(opts) {
 	const skipImplicit = opts.skipImplicitExpiry ?? false;
 	const staleRollover = Boolean(sessionMetadata && !skipImplicit && !freshness.fresh);
 	const needsRollover = triggerMatch.resetTriggered || staleRollover;
-	let sessionId = sessionMetadata?.transcriptId;
+	let sessionId = sessionMetadata?.sessionId;
 	let previousSessionId;
 	let isNewSession = false;
-	if (needsRollover && sessionMetadata?.transcriptId) {
+	if (needsRollover && sessionMetadata?.sessionId) {
 		const outcome = await opts.resetSession(key);
 		if (outcome) {
 			previousSessionId = outcome.previousSessionId;

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

@@ -1 +1 @@
-{"version":3,"file":"init-session-turn.js","names":[],"sources":["../../../src/session/init-session-turn.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { SessionConfigSchema, type Config } from '../config/schema.js';\nimport { parseSessionKey } from '../routing/session-key.js';\nimport { createLogger } from '../utils/logger.js';\nimport { requireXopcDatabase } from '../storage/sqlite/index.js';\nimport { resolveSessionLifecycleTimestamps } from './lifecycle-timestamps.js';\nimport {\n  evaluateSessionFreshness,\n  resolveSessionResetPolicy,\n} from './reset-policy.js';\nimport {\n  bareResetAckMessage,\n  matchResetTriggers,\n  resolveResetTriggers,\n} from './reset-triggers.js';\nimport { resolveChannelResetConfig, resolveSessionResetType } from './reset-type.js';\nimport { resolveSessionKeyForRequest } from './resolve-session.js';\n\nconst log = createLogger('InitSessionTurn');\n\nexport type SessionResetFn = (\n  sessionKey: string,\n) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n\nexport type InitSessionTurnResult = {\n  sessionKey: string;\n  sessionId?: string;\n  previousSessionId?: string;\n  isNewSession: boolean;\n  resetTriggered: boolean;\n  staleRollover: boolean;\n  bodyStripped: string;\n  bareReset: boolean;\n  ackMessage?: string;\n};\n\nexport type InitSessionTurnOptions = {\n  cfg: Config;\n  sessionKey: string;\n  body?: string;\n  resetSession: SessionResetFn;\n  skipImplicitExpiry?: boolean;\n};\n\nexport async function initSessionTurn(\n  opts: InitSessionTurnOptions,\n): Promise<InitSessionTurnResult> {\n  requireXopcDatabase();\n\n  const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});\n  const triggers = resolveResetTriggers(sessionCfg.resetTriggers);\n  const rawBody = opts.body ?? '';\n  const triggerMatch = matchResetTriggers(rawBody, triggers);\n\n  const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest({\n    cfg: opts.cfg,\n    sessionKey: opts.sessionKey,\n  });\n  const key = sessionKey?.trim() ?? opts.sessionKey.trim();\n\n  const parsed = key ? parseSessionKey(key) : null;\n  const peerKind = parsed?.peerKind;\n  const resetType = resolveSessionResetType({\n    sessionKey: key,\n    isGroup: peerKind === 'group' || peerKind === 'channel',\n    isThread: Boolean(parsed?.threadId),\n  });\n  const channelReset = resolveChannelResetConfig({\n    sessionCfg,\n    channel: parsed?.source ?? sessionMetadata?.sourceChannel,\n  });\n  const resetPolicy = resolveSessionResetPolicy({\n    sessionCfg,\n    resetType,\n    resetOverride: channelReset,\n  });\n  const lifecycle = resolveSessionLifecycleTimestamps({\n    entry: sessionMetadata\n      ? {\n          updatedAt: Date.parse(sessionMetadata.updatedAt),\n          sessionStartedAt: sessionMetadata.sessionStartedAt\n            ? Date.parse(sessionMetadata.sessionStartedAt)\n            : undefined,\n          lastInteractionAt: sessionMetadata.lastInteractionAt\n            ? Date.parse(sessionMetadata.lastInteractionAt)\n            : undefined,\n        }\n      : undefined,\n  });\n  const now = Date.now();\n  const freshness = sessionMetadata\n    ? evaluateSessionFreshness({\n        updatedAt: Date.parse(sessionMetadata.updatedAt),\n        ...lifecycle,\n        now,\n        policy: resetPolicy,\n      })\n    : { fresh: false };\n\n  const skipImplicit = opts.skipImplicitExpiry ?? false;\n  const staleRollover = Boolean(sessionMetadata && !skipImplicit && !freshness.fresh);\n  const needsRollover = triggerMatch.resetTriggered || staleRollover;\n\n  let sessionId = sessionMetadata?.transcriptId;\n  let previousSessionId: string | undefined;\n  let isNewSession = false;\n\n  if (needsRollover && sessionMetadata?.transcriptId) {\n    const outcome = await opts.resetSession(key);\n    if (outcome) {\n      previousSessionId = outcome.previousSessionId;\n      sessionId = outcome.sessionId;\n      isNewSession = true;\n      log.info(\n        {\n          sessionKey: key,\n          sessionId: outcome.sessionId,\n          previousSessionId: outcome.previousSessionId,\n          resetTriggered: triggerMatch.resetTriggered,\n          staleRollover,\n          resetType,\n        },\n        triggerMatch.resetTriggered\n          ? 'Session reset via reset trigger'\n          : 'Session rolled over (stale freshness)',\n      );\n    } else {\n      log.warn({ sessionKey: key }, 'Session rollover requested but resetSession returned null');\n      sessionId = randomUUID();\n      isNewSession = true;\n    }\n  } else if (!sessionMetadata) {\n    isNewSession = true;\n    sessionId = randomUUID();\n  }\n\n  const bareReset = triggerMatch.resetTriggered && triggerMatch.bareReset;\n  const ackMessage = bareReset ? bareResetAckMessage(triggerMatch.matchedTrigger) : undefined;\n\n  return {\n    sessionKey: key,\n    sessionId,\n    previousSessionId,\n    isNewSession,\n    resetTriggered: triggerMatch.resetTriggered,\n    staleRollover,\n    bodyStripped: triggerMatch.resetTriggered ? triggerMatch.bodyStripped : rawBody,\n    bareReset,\n    ackMessage,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;aAEuE;kBACX;aACV;AAelD,MAAM,MAAM,aAAa,kBAAkB;AA0B3C,eAAsB,gBACpB,MACgC;AAChC,sBAAqB;CAErB,MAAM,aAAa,KAAK,IAAI,WAAW,oBAAoB,MAAM,EAAE,CAAC;CACpE,MAAM,WAAW,qBAAqB,WAAW,cAAc;CAC/D,MAAM,UAAU,KAAK,QAAQ;CAC7B,MAAM,eAAe,mBAAmB,SAAS,SAAS;CAE1D,MAAM,EAAE,YAAY,oBAAoB,MAAM,4BAA4B;EACxE,KAAK,KAAK;EACV,YAAY,KAAK;EAClB,CAAC;CACF,MAAM,MAAM,YAAY,MAAM,IAAI,KAAK,WAAW,MAAM;CAExD,MAAM,SAAS,MAAM,gBAAgB,IAAI,GAAG;CAC5C,MAAM,WAAW,QAAQ;CACzB,MAAM,YAAY,wBAAwB;EACxC,YAAY;EACZ,SAAS,aAAa,WAAW,aAAa;EAC9C,UAAU,QAAQ,QAAQ,SAAS;EACpC,CAAC;CAKF,MAAM,cAAc,0BAA0B;EAC5C;EACA;EACA,eAPmB,0BAA0B;GAC7C;GACA,SAAS,QAAQ,UAAU,iBAAiB;GAC7C,CAI4B;EAC5B,CAAC;CACF,MAAM,YAAY,kCAAkC,EAClD,OAAO,kBACH;EACE,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,kBAAkB,gBAAgB,mBAC9B,KAAK,MAAM,gBAAgB,iBAAiB,GAC5C,KAAA;EACJ,mBAAmB,gBAAgB,oBAC/B,KAAK,MAAM,gBAAgB,kBAAkB,GAC7C,KAAA;EACL,GACD,KAAA,GACL,CAAC;CACF,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,YAAY,kBACd,yBAAyB;EACvB,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,GAAG;EACH;EACA,QAAQ;EACT,CAAC,GACF,EAAE,OAAO,OAAO;CAEpB,MAAM,eAAe,KAAK,sBAAsB;CAChD,MAAM,gBAAgB,QAAQ,mBAAmB,CAAC,gBAAgB,CAAC,UAAU,MAAM;CACnF,MAAM,gBAAgB,aAAa,kBAAkB;CAErD,IAAI,YAAY,iBAAiB;CACjC,IAAI;CACJ,IAAI,eAAe;AAEnB,KAAI,iBAAiB,iBAAiB,cAAc;EAClD,MAAM,UAAU,MAAM,KAAK,aAAa,IAAI;AAC5C,MAAI,SAAS;AACX,uBAAoB,QAAQ;AAC5B,eAAY,QAAQ;AACpB,kBAAe;AACf,OAAI,KACF;IACE,YAAY;IACZ,WAAW,QAAQ;IACnB,mBAAmB,QAAQ;IAC3B,gBAAgB,aAAa;IAC7B;IACA;IACD,EACD,aAAa,iBACT,oCACA,wCACL;SACI;AACL,OAAI,KAAK,EAAE,YAAY,KAAK,EAAE,4DAA4D;AAC1F,eAAY,YAAY;AACxB,kBAAe;;YAER,CAAC,iBAAiB;AAC3B,iBAAe;AACf,cAAY,YAAY;;CAG1B,MAAM,YAAY,aAAa,kBAAkB,aAAa;CAC9D,MAAM,aAAa,YAAY,oBAAoB,aAAa,eAAe,GAAG,KAAA;AAElF,QAAO;EACL,YAAY;EACZ;EACA;EACA;EACA,gBAAgB,aAAa;EAC7B;EACA,cAAc,aAAa,iBAAiB,aAAa,eAAe;EACxE;EACA;EACD"}
+{"version":3,"file":"init-session-turn.js","names":[],"sources":["../../../src/session/init-session-turn.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { SessionConfigSchema, type Config } from '../config/schema.js';\nimport { createLogger } from '../utils/logger.js';\nimport { requireXopcDatabase } from '../storage/sqlite/index.js';\nimport { resolveSessionLifecycleTimestamps } from './lifecycle-timestamps.js';\nimport {\n  evaluateSessionFreshness,\n  resolveSessionResetPolicy,\n} from './reset-policy.js';\nimport {\n  bareResetAckMessage,\n  matchResetTriggers,\n  resolveResetTriggers,\n} from './reset-triggers.js';\nimport { resolveChannelResetConfig, resolveSessionResetType } from './reset-type.js';\nimport { resolveSessionKeyForRequest } from './resolve-session.js';\n\nconst log = createLogger('InitSessionTurn');\n\nexport type SessionResetFn = (\n  sessionKey: string,\n) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n\nexport type InitSessionTurnResult = {\n  sessionKey: string;\n  sessionId?: string;\n  previousSessionId?: string;\n  isNewSession: boolean;\n  resetTriggered: boolean;\n  staleRollover: boolean;\n  bodyStripped: string;\n  bareReset: boolean;\n  ackMessage?: string;\n};\n\nexport type InitSessionTurnOptions = {\n  cfg: Config;\n  sessionKey: string;\n  body?: string;\n  resetSession: SessionResetFn;\n  skipImplicitExpiry?: boolean;\n};\n\nexport async function initSessionTurn(\n  opts: InitSessionTurnOptions,\n): Promise<InitSessionTurnResult> {\n  requireXopcDatabase();\n\n  const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});\n  const triggers = resolveResetTriggers(sessionCfg.resetTriggers);\n  const rawBody = opts.body ?? '';\n  const triggerMatch = matchResetTriggers(rawBody, triggers);\n\n  const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest({\n    cfg: opts.cfg,\n    sessionKey: opts.sessionKey,\n  });\n  const key = sessionKey?.trim() ?? opts.sessionKey.trim();\n\n  const routing = sessionMetadata?.routing;\n  const peerKind = routing?.peerKind;\n  const resetType = resolveSessionResetType({\n    isGroup: peerKind === 'group' || peerKind === 'channel',\n    isThread: Boolean(routing?.threadId),\n  });\n  const channelReset = resolveChannelResetConfig({\n    sessionCfg,\n    channel: routing?.source ?? sessionMetadata?.sourceChannel,\n  });\n  const resetPolicy = resolveSessionResetPolicy({\n    sessionCfg,\n    resetType,\n    resetOverride: channelReset,\n  });\n  const lifecycle = resolveSessionLifecycleTimestamps({\n    entry: sessionMetadata\n      ? {\n          updatedAt: Date.parse(sessionMetadata.updatedAt),\n          sessionStartedAt: sessionMetadata.sessionStartedAt\n            ? Date.parse(sessionMetadata.sessionStartedAt)\n            : undefined,\n          lastInteractionAt: sessionMetadata.lastInteractionAt\n            ? Date.parse(sessionMetadata.lastInteractionAt)\n            : undefined,\n        }\n      : undefined,\n  });\n  const now = Date.now();\n  const freshness = sessionMetadata\n    ? evaluateSessionFreshness({\n        updatedAt: Date.parse(sessionMetadata.updatedAt),\n        ...lifecycle,\n        now,\n        policy: resetPolicy,\n      })\n    : { fresh: false };\n\n  const skipImplicit = opts.skipImplicitExpiry ?? false;\n  const staleRollover = Boolean(sessionMetadata && !skipImplicit && !freshness.fresh);\n  const needsRollover = triggerMatch.resetTriggered || staleRollover;\n\n  let sessionId = sessionMetadata?.sessionId;\n  let previousSessionId: string | undefined;\n  let isNewSession = false;\n\n  if (needsRollover && sessionMetadata?.sessionId) {\n    const outcome = await opts.resetSession(key);\n    if (outcome) {\n      previousSessionId = outcome.previousSessionId;\n      sessionId = outcome.sessionId;\n      isNewSession = true;\n      log.info(\n        {\n          sessionKey: key,\n          sessionId: outcome.sessionId,\n          previousSessionId: outcome.previousSessionId,\n          resetTriggered: triggerMatch.resetTriggered,\n          staleRollover,\n          resetType,\n        },\n        triggerMatch.resetTriggered\n          ? 'Session reset via reset trigger'\n          : 'Session rolled over (stale freshness)',\n      );\n    } else {\n      log.warn({ sessionKey: key }, 'Session rollover requested but resetSession returned null');\n      sessionId = randomUUID();\n      isNewSession = true;\n    }\n  } else if (!sessionMetadata) {\n    isNewSession = true;\n    sessionId = randomUUID();\n  }\n\n  const bareReset = triggerMatch.resetTriggered && triggerMatch.bareReset;\n  const ackMessage = bareReset ? bareResetAckMessage(triggerMatch.matchedTrigger) : undefined;\n\n  return {\n    sessionKey: key,\n    sessionId,\n    previousSessionId,\n    isNewSession,\n    resetTriggered: triggerMatch.resetTriggered,\n    staleRollover,\n    bodyStripped: triggerMatch.resetTriggered ? triggerMatch.bodyStripped : rawBody,\n    bareReset,\n    ackMessage,\n  };\n}\n"],"mappings":";;;;;;;;;;;;aAEuE;aACrB;AAelD,MAAM,MAAM,aAAa,kBAAkB;AA0B3C,eAAsB,gBACpB,MACgC;AAChC,sBAAqB;CAErB,MAAM,aAAa,KAAK,IAAI,WAAW,oBAAoB,MAAM,EAAE,CAAC;CACpE,MAAM,WAAW,qBAAqB,WAAW,cAAc;CAC/D,MAAM,UAAU,KAAK,QAAQ;CAC7B,MAAM,eAAe,mBAAmB,SAAS,SAAS;CAE1D,MAAM,EAAE,YAAY,oBAAoB,MAAM,4BAA4B;EACxE,KAAK,KAAK;EACV,YAAY,KAAK;EAClB,CAAC;CACF,MAAM,MAAM,YAAY,MAAM,IAAI,KAAK,WAAW,MAAM;CAExD,MAAM,UAAU,iBAAiB;CACjC,MAAM,WAAW,SAAS;CAC1B,MAAM,YAAY,wBAAwB;EACxC,SAAS,aAAa,WAAW,aAAa;EAC9C,UAAU,QAAQ,SAAS,SAAS;EACrC,CAAC;CAKF,MAAM,cAAc,0BAA0B;EAC5C;EACA;EACA,eAPmB,0BAA0B;GAC7C;GACA,SAAS,SAAS,UAAU,iBAAiB;GAC9C,CAI4B;EAC5B,CAAC;CACF,MAAM,YAAY,kCAAkC,EAClD,OAAO,kBACH;EACE,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,kBAAkB,gBAAgB,mBAC9B,KAAK,MAAM,gBAAgB,iBAAiB,GAC5C,KAAA;EACJ,mBAAmB,gBAAgB,oBAC/B,KAAK,MAAM,gBAAgB,kBAAkB,GAC7C,KAAA;EACL,GACD,KAAA,GACL,CAAC;CACF,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,YAAY,kBACd,yBAAyB;EACvB,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,GAAG;EACH;EACA,QAAQ;EACT,CAAC,GACF,EAAE,OAAO,OAAO;CAEpB,MAAM,eAAe,KAAK,sBAAsB;CAChD,MAAM,gBAAgB,QAAQ,mBAAmB,CAAC,gBAAgB,CAAC,UAAU,MAAM;CACnF,MAAM,gBAAgB,aAAa,kBAAkB;CAErD,IAAI,YAAY,iBAAiB;CACjC,IAAI;CACJ,IAAI,eAAe;AAEnB,KAAI,iBAAiB,iBAAiB,WAAW;EAC/C,MAAM,UAAU,MAAM,KAAK,aAAa,IAAI;AAC5C,MAAI,SAAS;AACX,uBAAoB,QAAQ;AAC5B,eAAY,QAAQ;AACpB,kBAAe;AACf,OAAI,KACF;IACE,YAAY;IACZ,WAAW,QAAQ;IACnB,mBAAmB,QAAQ;IAC3B,gBAAgB,aAAa;IAC7B;IACA;IACD,EACD,aAAa,iBACT,oCACA,wCACL;SACI;AACL,OAAI,KAAK,EAAE,YAAY,KAAK,EAAE,4DAA4D;AAC1F,eAAY,YAAY;AACxB,kBAAe;;YAER,CAAC,iBAAiB;AAC3B,iBAAe;AACf,cAAY,YAAY;;CAG1B,MAAM,YAAY,aAAa,kBAAkB,aAAa;CAC9D,MAAM,aAAa,YAAY,oBAAoB,aAAa,eAAe,GAAG,KAAA;AAElF,QAAO;EACL,YAAY;EACZ;EACA;EACA;EACA,gBAAgB,aAAa;EAC7B;EACA,cAAc,aAAa,iBAAiB,aAAa,eAAe;EACxE;EACA;EACD"}

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

@@ -1,6 +1,7 @@
 import EventEmitter from 'events';
 import { SessionStore } from './store.js';
 import type { SessionMetadata, SessionDetail, SessionListQuery, PaginatedResult, GlobalSessionStats, ExportFormat, SessionStatus } from './types.js';
+import type { SessionMetadataSeed } from '../storage/sqlite/index.js';
 import type { Message } from './types.js';
 import type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';
 import type { XopcSessionTranscriptV1 } from './transcript-format.js';
@@ -52,6 +53,7 @@ export declare class SessionIndex extends EventEmitter {
         error: string;
     }>;
     getSessionMetadata(key: string): Promise<SessionMetadata | null>;
+    resolveSessionKeyBySessionId(sessionId: string): Promise<string | null>;
     deleteSession(key: string): Promise<boolean>;
     deleteSessions(keys: string[]): Promise<{
         success: string[];
@@ -123,7 +125,9 @@ export declare class SessionIndex extends EventEmitter {
      * Runtime turns must use PiTranscriptManager.appendMessage; this entry point
      * is reserved for compaction, tests, and admin tools.
      */
-    saveMessages(key: string, messages: any[]): Promise<void>;
+    saveMessages(key: string, messages: any[], options?: {
+        metadata?: SessionMetadataSeed;
+    }): Promise<void>;
     /**
      * Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).
      */

package/dist/src/session/manager.js

@@ -58,6 +58,9 @@ var SessionIndex = class extends EventEmitter$1 {
 	async getSessionMetadata(key) {
 		return this.store.getMetadata(key);
 	}
+	async resolveSessionKeyBySessionId(sessionId) {
+		return this.store.resolveKeyBySessionId(sessionId);
+	}
 	async deleteSession(key) {
 		const result = await this.store.delete(key);
 		if (result) this.emit("sessionDeleted", { key });
@@ -218,8 +221,8 @@ var SessionIndex = class extends EventEmitter$1 {
 	* Runtime turns must use PiTranscriptManager.appendMessage; this entry point
 	* is reserved for compaction, tests, and admin tools.
 	*/
-	async saveMessages(key, messages) {
-		return this.store.saveMessages(key, messages);
+	async saveMessages(key, messages, options) {
+		return this.store.saveMessages(key, messages, options);
 	}
 	/**
 	* Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).

package/dist/src/session/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":["EventEmitter"],"sources":["../../../src/session/manager.ts"],"sourcesContent":["// Session manager - high-level session management service\n\nimport EventEmitter from 'events';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionStore } from './store.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionStatus,\n} from './types.js';\nimport type { Message } from './types.js';\nimport type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';\nimport type { XopcSessionTranscriptV1 } from './transcript-format.js';\nimport type { XopcTranscriptContextEntry } from './session-context-for-llm.js';\nimport { applySessionPatchToMetadata, type SessionPatchBody } from './patch-metadata.js';\nimport type { WindowConfig } from '../agent/memory/window.js';\nimport type { Config } from '../config/schema.js';\n\nconst log = createLogger('SessionIndex');\n\nexport interface SessionIndexConfig {\n  config: Config;\n  windowConfig?: Partial<WindowConfig>;\n  compactionConfig?: Partial<CompactionConfig>;\n}\n\nexport class SessionIndex extends EventEmitter {\n  private store: SessionStore;\n\n  constructor(config: SessionIndexConfig) {\n    super();\n    this.store = new SessionStore(\n      {\n        config: config.config,\n      },\n      config.windowConfig,\n      config.compactionConfig\n    );\n  }\n\n  async initialize(): Promise<void> {\n    await this.store.initialize();\n    this.emit('ready');\n  }\n\n  /** Low-level store (e.g. cron resolving weixin delivery from session index). */\n  getStore(): SessionStore {\n    return this.store;\n  }\n\n  // ========== CRUD Operations ==========\n\n  async listSessions(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>> {\n    return this.store.list(query);\n  }\n\n  async listSubagents(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    return this.store.list({\n      ...query,\n      sessionTypes: ['workflow-subagent'],\n      includeHidden: true,\n    });\n  }\n\n  async getSession(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail | null> {\n    const session = await this.store.get(key, options);\n    if (session) {\n      this.emit('sessionAccessed', { key });\n    }\n    return session;\n  }\n\n  async getSessionMessagePage(\n    key: string,\n    options?: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    },\n  ): Promise<{\n    session: SessionDetail;\n    pagination: {\n      total: number;\n      limit: number;\n      offset: number;\n      hasMore: boolean;\n      before?: string;\n      nextBeforeCursor?: string;\n    };\n  } | null> {\n    const result = await this.store.getMessagePage(key, options);\n    if (result) {\n      this.emit('sessionAccessed', { key });\n    }\n    return result;\n  }\n\n  /**\n   * OpenClaw-style `sessions.patch`: partial metadata (name, tags, customData shallow merge).\n   */\n  async patchSession(\n    key: string,\n    patch: SessionPatchBody,\n  ): Promise<{ ok: true } | { ok: false; error: string }> {\n    const meta = await this.store.getMetadata(key);\n    if (!meta) {\n      return { ok: false, error: 'Session not found' };\n    }\n    const updates = applySessionPatchToMetadata(meta, patch);\n    if (Object.keys(updates).length === 0) {\n      return { ok: true };\n    }\n    await this.store.updateMetadata(key, updates);\n    this.emit('sessionUpdated', { key });\n    return { ok: true };\n  }\n\n  async getSessionMetadata(key: string): Promise<SessionMetadata | null> {\n    return this.store.getMetadata(key);\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    const result = await this.store.delete(key);\n    if (result) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  async deleteSessions(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const result = await this.store.deleteMany(keys);\n    for (const key of result.success) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  // ========== Metadata Updates ==========\n\n  async renameSession(key: string, name: string): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    await this.store.updateMetadata(key, {\n      name,\n      customData: { ...(existing?.customData ?? {}), titleSource: 'user' },\n    });\n    this.emit('sessionUpdated', { key, name });\n  }\n\n  /** Partial metadata update (caller merges nested fields like `customData` when needed). */\n  async updateSessionMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    await this.store.updateMetadata(key, updates);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async tagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    // Merge tags, remove duplicates\n    const mergedTags = [...new Set([...existing.tags, ...tags])];\n    await this.store.updateMetadata(key, { tags: mergedTags });\n    this.emit('sessionUpdated', { key, tags: mergedTags });\n  }\n\n  async untagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    const filteredTags = existing.tags.filter((t) => !tags.includes(t));\n    await this.store.updateMetadata(key, { tags: filteredTags });\n    this.emit('sessionUpdated', { key, tags: filteredTags });\n  }\n\n  async setSessionTags(key: string, tags: string[]): Promise<void> {\n    await this.store.updateMetadata(key, { tags: [...new Set(tags)] });\n    this.emit('sessionUpdated', { key, tags });\n  }\n\n  // ========== Status Management ==========\n\n  async archiveSession(key: string): Promise<void> {\n    await this.store.archive(key);\n    this.emit('sessionArchived', { key });\n  }\n\n  async unarchiveSession(key: string): Promise<void> {\n    await this.store.unarchive(key);\n    this.emit('sessionRestored', { key });\n  }\n\n  async pinSession(key: string): Promise<void> {\n    await this.store.pin(key);\n    this.emit('sessionPinned', { key });\n  }\n\n  async unpinSession(key: string): Promise<void> {\n    await this.store.unpin(key);\n    this.emit('sessionUnpinned', { key });\n  }\n\n  async setSessionStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.store.setStatus(key, status);\n    this.emit('sessionStatusChanged', { key, status });\n  }\n\n  // ========== Search ==========\n\n  async searchSessions(query: string): Promise<SessionMetadata[]> {\n    const result = await this.store.list({ search: query, sessionTypes: ['chat'], limit: 100 });\n    return result.items;\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    return this.store.searchInSession(key, keyword);\n  }\n\n  // ========== Export/Import ==========\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    return this.store.exportSession(key, format);\n  }\n\n  async importSessionExport(\n    targetKey: string,\n    jsonContent: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    const result = await this.store.importSessionExport(targetKey, jsonContent);\n    const metadata = await this.store.getMetadata(result.sessionKey);\n    if (metadata) {\n      this.emit('sessionCreated', metadata);\n    }\n    return result;\n  }\n\n  async forkSession(\n    sourceKey: string,\n    targetKey: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    const result = await this.store.forkSession(sourceKey, targetKey);\n    const metadata = await this.store.getMetadata(result.sessionKey);\n    if (metadata) {\n      this.emit('sessionCreated', metadata);\n    }\n    return result;\n  }\n\n  async forkSessionRows(\n    sourceKey: string,\n    targetKey: string,\n    options: { throughRow?: number } = {},\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    const result = await this.store.forkSessionRows(sourceKey, targetKey, options);\n    const metadata = await this.store.getMetadata(result.sessionKey);\n    if (metadata) {\n      this.emit('sessionCreated', metadata);\n    }\n    return result;\n  }\n\n  // ========== Statistics ==========\n\n  async getStats(): Promise<GlobalSessionStats> {\n    return this.store.getStats();\n  }\n\n  // ========== Maintenance ==========\n\n  async archiveOldSessions(olderThanDays: number): Promise<number> {\n    const count = await this.store.archiveOld(olderThanDays);\n    log.info({ count, olderThanDays }, 'Archived old sessions');\n    return count;\n  }\n\n  // ========== Event Helpers ==========\n\n  onSessionCreated(callback: (metadata: SessionMetadata) => void): void {\n    this.on('sessionCreated', callback);\n  }\n\n  onSessionUpdated(callback: (data: { key: string; name?: string; tags?: string[] }) => void): void {\n    this.on('sessionUpdated', callback);\n  }\n\n  onSessionDeleted(callback: (data: { key: string }) => void): void {\n    this.on('sessionDeleted', callback);\n  }\n\n  onSessionArchived(callback: (data: { key: string }) => void): void {\n    this.on('sessionArchived', callback);\n  }\n\n  onSessionRestored(callback: (data: { key: string }) => void): void {\n    this.on('sessionRestored', callback);\n  }\n\n  onSessionPinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionPinned', callback);\n  }\n\n  onSessionUnpinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionUnpinned', callback);\n  }\n\n  onSessionStatusChanged(callback: (data: { key: string; status: SessionStatus }) => void): void {\n    this.on('sessionStatusChanged', callback);\n  }\n\n  onSessionAccessed(callback: (data: { key: string }) => void): void {\n    this.on('sessionAccessed', callback);\n  }\n\n  // ========== Store delegation (messages, compaction) ==========\n\n  /** Load messages for a session key */\n  async loadMessages(key: string) {\n    return this.store.loadMessages(key);\n  }\n\n  /** Wrapped transcript document (stable id, compaction history); null if missing or not a valid envelope. */\n  async loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null> {\n    return this.store.loadTranscriptDocument(key);\n  }\n\n  /**\n   * Runtime turns must use PiTranscriptManager.appendMessage; this entry point\n   * is reserved for compaction, tests, and admin tools.\n   */\n  async saveMessages(key: string, messages: any[]) {\n    return this.store.saveMessages(key, messages);\n  }\n\n  /**\n   * Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).\n   */\n  async appendTranscriptContextEntry(\n    key: string,\n    entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>,\n  ): Promise<void> {\n    await this.store.appendTranscriptContextEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptLabelEntry(\n    key: string,\n    entry: { targetId: string; label?: string },\n  ): Promise<void> {\n    await this.store.appendTranscriptLabelEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptCustomEntry(\n    key: string,\n    entry: { customType: string; data?: unknown },\n  ): Promise<void> {\n    await this.store.appendTranscriptCustomEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptCustomMessageEntry(\n    key: string,\n    entry: {\n      customType: string;\n      content?: string | unknown[];\n      display?: boolean;\n      details?: unknown;\n    },\n  ): Promise<void> {\n    await this.store.appendTranscriptCustomMessageEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptBashExecutionEntry(\n    key: string,\n    entry: {\n      command: string;\n      output?: string;\n      exitCode?: number | null;\n      signal?: string | null;\n      excludeFromContext?: boolean;\n      truncated?: boolean;\n      fullOutputPath?: string;\n    },\n  ): Promise<void> {\n    await this.store.appendTranscriptBashExecutionEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  /** Delete session data */\n  async delete(key: string): Promise<void> {\n    await this.store.delete(key);\n  }\n\n  /** Archive transcript and start a new session id for the same key. */\n  async resetSession(\n    key: string,\n  ): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    const result = await this.store.reset(key);\n    if (result) {\n      this.emit('sessionUpdated', { key });\n    }\n    return result;\n  }\n\n  /** Token/window stats for a message list */\n  getWindowStats(messages: any[]) {\n    return this.store.getWindowStats(messages);\n  }\n\n  /** Prepare compaction run */\n  prepareCompaction(key: string, messages: any[], contextWindow: number) {\n    return this.store.prepareCompaction(key, messages, contextWindow);\n  }\n\n  /** Compact session messages */\n  compact(\n    key: string,\n    messages: any[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    return this.store.compact(key, messages, contextWindow, instructions, force);\n  }\n\n  /** Compaction stats for a session */\n  async getCompactionStats(key: string) {\n    return this.store.getCompactionStats(key);\n  }\n\n  /** List pre-compaction transcript snapshots (newest first). */\n  listCompactionCheckpoints(key: string) {\n    return this.store.listCompactionCheckpoints(key);\n  }\n\n  getCompactionCheckpointDetail(key: string, checkpointId: string) {\n    return this.store.getCompactionCheckpointDetail(key, checkpointId);\n  }\n\n  restoreCompactionCheckpoint(key: string, checkpointId: string) {\n    return this.store.restoreCompactionCheckpoint(key, checkpointId);\n  }\n\n  /** Estimate token usage for messages */\n  async estimateTokenUsage(key: string, messages: any[]): Promise<number> {\n    return this.store.estimateTokens(messages);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"manager.js","names":["EventEmitter"],"sources":["../../../src/session/manager.ts"],"sourcesContent":["// Session manager - high-level session management service\n\nimport EventEmitter from 'events';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionStore } from './store.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionStatus,\n} from './types.js';\nimport type { SessionMetadataSeed } from '../storage/sqlite/index.js';\nimport type { Message } from './types.js';\nimport type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';\nimport type { XopcSessionTranscriptV1 } from './transcript-format.js';\nimport type { XopcTranscriptContextEntry } from './session-context-for-llm.js';\nimport { applySessionPatchToMetadata, type SessionPatchBody } from './patch-metadata.js';\nimport type { WindowConfig } from '../agent/memory/window.js';\nimport type { Config } from '../config/schema.js';\n\nconst log = createLogger('SessionIndex');\n\nexport interface SessionIndexConfig {\n  config: Config;\n  windowConfig?: Partial<WindowConfig>;\n  compactionConfig?: Partial<CompactionConfig>;\n}\n\nexport class SessionIndex extends EventEmitter {\n  private store: SessionStore;\n\n  constructor(config: SessionIndexConfig) {\n    super();\n    this.store = new SessionStore(\n      {\n        config: config.config,\n      },\n      config.windowConfig,\n      config.compactionConfig\n    );\n  }\n\n  async initialize(): Promise<void> {\n    await this.store.initialize();\n    this.emit('ready');\n  }\n\n  /** Low-level store (e.g. cron resolving weixin delivery from session index). */\n  getStore(): SessionStore {\n    return this.store;\n  }\n\n  // ========== CRUD Operations ==========\n\n  async listSessions(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>> {\n    return this.store.list(query);\n  }\n\n  async listSubagents(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    return this.store.list({\n      ...query,\n      sessionTypes: ['workflow-subagent'],\n      includeHidden: true,\n    });\n  }\n\n  async getSession(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail | null> {\n    const session = await this.store.get(key, options);\n    if (session) {\n      this.emit('sessionAccessed', { key });\n    }\n    return session;\n  }\n\n  async getSessionMessagePage(\n    key: string,\n    options?: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    },\n  ): Promise<{\n    session: SessionDetail;\n    pagination: {\n      total: number;\n      limit: number;\n      offset: number;\n      hasMore: boolean;\n      before?: string;\n      nextBeforeCursor?: string;\n    };\n  } | null> {\n    const result = await this.store.getMessagePage(key, options);\n    if (result) {\n      this.emit('sessionAccessed', { key });\n    }\n    return result;\n  }\n\n  /**\n   * OpenClaw-style `sessions.patch`: partial metadata (name, tags, customData shallow merge).\n   */\n  async patchSession(\n    key: string,\n    patch: SessionPatchBody,\n  ): Promise<{ ok: true } | { ok: false; error: string }> {\n    const meta = await this.store.getMetadata(key);\n    if (!meta) {\n      return { ok: false, error: 'Session not found' };\n    }\n    const updates = applySessionPatchToMetadata(meta, patch);\n    if (Object.keys(updates).length === 0) {\n      return { ok: true };\n    }\n    await this.store.updateMetadata(key, updates);\n    this.emit('sessionUpdated', { key });\n    return { ok: true };\n  }\n\n  async getSessionMetadata(key: string): Promise<SessionMetadata | null> {\n    return this.store.getMetadata(key);\n  }\n\n  async resolveSessionKeyBySessionId(sessionId: string): Promise<string | null> {\n    return this.store.resolveKeyBySessionId(sessionId);\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    const result = await this.store.delete(key);\n    if (result) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  async deleteSessions(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const result = await this.store.deleteMany(keys);\n    for (const key of result.success) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  // ========== Metadata Updates ==========\n\n  async renameSession(key: string, name: string): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    await this.store.updateMetadata(key, {\n      name,\n      customData: { ...(existing?.customData ?? {}), titleSource: 'user' },\n    });\n    this.emit('sessionUpdated', { key, name });\n  }\n\n  /** Partial metadata update (caller merges nested fields like `customData` when needed). */\n  async updateSessionMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    await this.store.updateMetadata(key, updates);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async tagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    // Merge tags, remove duplicates\n    const mergedTags = [...new Set([...existing.tags, ...tags])];\n    await this.store.updateMetadata(key, { tags: mergedTags });\n    this.emit('sessionUpdated', { key, tags: mergedTags });\n  }\n\n  async untagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    const filteredTags = existing.tags.filter((t) => !tags.includes(t));\n    await this.store.updateMetadata(key, { tags: filteredTags });\n    this.emit('sessionUpdated', { key, tags: filteredTags });\n  }\n\n  async setSessionTags(key: string, tags: string[]): Promise<void> {\n    await this.store.updateMetadata(key, { tags: [...new Set(tags)] });\n    this.emit('sessionUpdated', { key, tags });\n  }\n\n  // ========== Status Management ==========\n\n  async archiveSession(key: string): Promise<void> {\n    await this.store.archive(key);\n    this.emit('sessionArchived', { key });\n  }\n\n  async unarchiveSession(key: string): Promise<void> {\n    await this.store.unarchive(key);\n    this.emit('sessionRestored', { key });\n  }\n\n  async pinSession(key: string): Promise<void> {\n    await this.store.pin(key);\n    this.emit('sessionPinned', { key });\n  }\n\n  async unpinSession(key: string): Promise<void> {\n    await this.store.unpin(key);\n    this.emit('sessionUnpinned', { key });\n  }\n\n  async setSessionStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.store.setStatus(key, status);\n    this.emit('sessionStatusChanged', { key, status });\n  }\n\n  // ========== Search ==========\n\n  async searchSessions(query: string): Promise<SessionMetadata[]> {\n    const result = await this.store.list({ search: query, sessionTypes: ['chat'], limit: 100 });\n    return result.items;\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    return this.store.searchInSession(key, keyword);\n  }\n\n  // ========== Export/Import ==========\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    return this.store.exportSession(key, format);\n  }\n\n  async importSessionExport(\n    targetKey: string,\n    jsonContent: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    const result = await this.store.importSessionExport(targetKey, jsonContent);\n    const metadata = await this.store.getMetadata(result.sessionKey);\n    if (metadata) {\n      this.emit('sessionCreated', metadata);\n    }\n    return result;\n  }\n\n  async forkSession(\n    sourceKey: string,\n    targetKey: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    const result = await this.store.forkSession(sourceKey, targetKey);\n    const metadata = await this.store.getMetadata(result.sessionKey);\n    if (metadata) {\n      this.emit('sessionCreated', metadata);\n    }\n    return result;\n  }\n\n  async forkSessionRows(\n    sourceKey: string,\n    targetKey: string,\n    options: { throughRow?: number } = {},\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    const result = await this.store.forkSessionRows(sourceKey, targetKey, options);\n    const metadata = await this.store.getMetadata(result.sessionKey);\n    if (metadata) {\n      this.emit('sessionCreated', metadata);\n    }\n    return result;\n  }\n\n  // ========== Statistics ==========\n\n  async getStats(): Promise<GlobalSessionStats> {\n    return this.store.getStats();\n  }\n\n  // ========== Maintenance ==========\n\n  async archiveOldSessions(olderThanDays: number): Promise<number> {\n    const count = await this.store.archiveOld(olderThanDays);\n    log.info({ count, olderThanDays }, 'Archived old sessions');\n    return count;\n  }\n\n  // ========== Event Helpers ==========\n\n  onSessionCreated(callback: (metadata: SessionMetadata) => void): void {\n    this.on('sessionCreated', callback);\n  }\n\n  onSessionUpdated(callback: (data: { key: string; name?: string; tags?: string[] }) => void): void {\n    this.on('sessionUpdated', callback);\n  }\n\n  onSessionDeleted(callback: (data: { key: string }) => void): void {\n    this.on('sessionDeleted', callback);\n  }\n\n  onSessionArchived(callback: (data: { key: string }) => void): void {\n    this.on('sessionArchived', callback);\n  }\n\n  onSessionRestored(callback: (data: { key: string }) => void): void {\n    this.on('sessionRestored', callback);\n  }\n\n  onSessionPinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionPinned', callback);\n  }\n\n  onSessionUnpinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionUnpinned', callback);\n  }\n\n  onSessionStatusChanged(callback: (data: { key: string; status: SessionStatus }) => void): void {\n    this.on('sessionStatusChanged', callback);\n  }\n\n  onSessionAccessed(callback: (data: { key: string }) => void): void {\n    this.on('sessionAccessed', callback);\n  }\n\n  // ========== Store delegation (messages, compaction) ==========\n\n  /** Load messages for a session key */\n  async loadMessages(key: string) {\n    return this.store.loadMessages(key);\n  }\n\n  /** Wrapped transcript document (stable id, compaction history); null if missing or not a valid envelope. */\n  async loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null> {\n    return this.store.loadTranscriptDocument(key);\n  }\n\n  /**\n   * Runtime turns must use PiTranscriptManager.appendMessage; this entry point\n   * is reserved for compaction, tests, and admin tools.\n   */\n  async saveMessages(\n    key: string,\n    messages: any[],\n    options?: { metadata?: SessionMetadataSeed },\n  ) {\n    return this.store.saveMessages(key, messages, options);\n  }\n\n  /**\n   * Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).\n   */\n  async appendTranscriptContextEntry(\n    key: string,\n    entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>,\n  ): Promise<void> {\n    await this.store.appendTranscriptContextEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptLabelEntry(\n    key: string,\n    entry: { targetId: string; label?: string },\n  ): Promise<void> {\n    await this.store.appendTranscriptLabelEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptCustomEntry(\n    key: string,\n    entry: { customType: string; data?: unknown },\n  ): Promise<void> {\n    await this.store.appendTranscriptCustomEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptCustomMessageEntry(\n    key: string,\n    entry: {\n      customType: string;\n      content?: string | unknown[];\n      display?: boolean;\n      details?: unknown;\n    },\n  ): Promise<void> {\n    await this.store.appendTranscriptCustomMessageEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async appendTranscriptBashExecutionEntry(\n    key: string,\n    entry: {\n      command: string;\n      output?: string;\n      exitCode?: number | null;\n      signal?: string | null;\n      excludeFromContext?: boolean;\n      truncated?: boolean;\n      fullOutputPath?: string;\n    },\n  ): Promise<void> {\n    await this.store.appendTranscriptBashExecutionEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  /** Delete session data */\n  async delete(key: string): Promise<void> {\n    await this.store.delete(key);\n  }\n\n  /** Archive transcript and start a new session id for the same key. */\n  async resetSession(\n    key: string,\n  ): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    const result = await this.store.reset(key);\n    if (result) {\n      this.emit('sessionUpdated', { key });\n    }\n    return result;\n  }\n\n  /** Token/window stats for a message list */\n  getWindowStats(messages: any[]) {\n    return this.store.getWindowStats(messages);\n  }\n\n  /** Prepare compaction run */\n  prepareCompaction(key: string, messages: any[], contextWindow: number) {\n    return this.store.prepareCompaction(key, messages, contextWindow);\n  }\n\n  /** Compact session messages */\n  compact(\n    key: string,\n    messages: any[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    return this.store.compact(key, messages, contextWindow, instructions, force);\n  }\n\n  /** Compaction stats for a session */\n  async getCompactionStats(key: string) {\n    return this.store.getCompactionStats(key);\n  }\n\n  /** List pre-compaction transcript snapshots (newest first). */\n  listCompactionCheckpoints(key: string) {\n    return this.store.listCompactionCheckpoints(key);\n  }\n\n  getCompactionCheckpointDetail(key: string, checkpointId: string) {\n    return this.store.getCompactionCheckpointDetail(key, checkpointId);\n  }\n\n  restoreCompactionCheckpoint(key: string, checkpointId: string) {\n    return this.store.restoreCompactionCheckpoint(key, checkpointId);\n  }\n\n  /** Estimate token usage for messages */\n  async estimateTokenUsage(key: string, messages: any[]): Promise<number> {\n    return this.store.estimateTokens(messages);\n  }\n}\n"],"mappings":"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"}

package/dist/src/session/reset-type.d.ts

@@ -1,8 +1,6 @@
 import type { Config } from '../config/schema.js';
 import type { SessionResetConfig, SessionResetType } from './reset-policy.js';
-export declare function isThreadSessionKey(sessionKey?: string | null): boolean;
 export declare function resolveSessionResetType(params: {
-    sessionKey?: string | null;
     isGroup?: boolean;
     isThread?: boolean;
 }): SessionResetType;

package/dist/src/session/reset-type.js

@@ -1,15 +1,9 @@
-import { init_string_coerce, normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString } from "../utils/string-coerce.js";
+import { init_string_coerce, normalizeOptionalLowercaseString } from "../utils/string-coerce.js";
 //#region src/session/reset-type.ts
 init_string_coerce();
-const GROUP_SESSION_MARKERS = [":group:", ":channel:"];
-function isThreadSessionKey(sessionKey) {
-	return (sessionKey ?? "").trim().includes(":thread:");
-}
 function resolveSessionResetType(params) {
-	if (params.isThread || isThreadSessionKey(params.sessionKey)) return "thread";
+	if (params.isThread) return "thread";
 	if (params.isGroup) return "group";
-	const normalized = normalizeLowercaseStringOrEmpty(params.sessionKey);
-	if (GROUP_SESSION_MARKERS.some((marker) => normalized.includes(marker))) return "group";
 	return "direct";
 }
 function resolveChannelResetConfig(params) {
@@ -20,6 +14,6 @@ function resolveChannelResetConfig(params) {
 	return resetByChannel[key];
 }
 //#endregion
-export { isThreadSessionKey, resolveChannelResetConfig, resolveSessionResetType };
+export { resolveChannelResetConfig, resolveSessionResetType };
 
 //# sourceMappingURL=reset-type.js.map

package/dist/src/session/reset-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"reset-type.js","names":[],"sources":["../../../src/session/reset-type.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString } from '../utils/string-coerce.js';\n\nimport type { SessionResetConfig, SessionResetType } from './reset-policy.js';\n\nconst GROUP_SESSION_MARKERS = [':group:', ':channel:'];\n\nexport function isThreadSessionKey(sessionKey?: string | null): boolean {\n  const raw = (sessionKey ?? '').trim();\n  return raw.includes(':thread:');\n}\n\nexport function resolveSessionResetType(params: {\n  sessionKey?: string | null;\n  isGroup?: boolean;\n  isThread?: boolean;\n}): SessionResetType {\n  if (params.isThread || isThreadSessionKey(params.sessionKey)) {\n    return 'thread';\n  }\n  if (params.isGroup) {\n    return 'group';\n  }\n  const normalized = normalizeLowercaseStringOrEmpty(params.sessionKey);\n  if (GROUP_SESSION_MARKERS.some((marker) => normalized.includes(marker))) {\n    return 'group';\n  }\n  return 'direct';\n}\n\nexport function resolveChannelResetConfig(params: {\n  sessionCfg?: Config['session'];\n  channel?: string | null;\n}): SessionResetConfig | undefined {\n  const resetByChannel = params.sessionCfg?.resetByChannel;\n  if (!resetByChannel) {\n    return undefined;\n  }\n  const key = normalizeOptionalLowercaseString(params.channel);\n  if (!key) {\n    return undefined;\n  }\n  return resetByChannel[key];\n}\n"],"mappings":";;oBAC8G;AAI9G,MAAM,wBAAwB,CAAC,WAAW,YAAY;AAEtD,SAAgB,mBAAmB,YAAqC;AAEtE,SADa,cAAc,IAAI,MACrB,CAAC,SAAS,WAAW;;AAGjC,SAAgB,wBAAwB,QAInB;AACnB,KAAI,OAAO,YAAY,mBAAmB,OAAO,WAAW,CAC1D,QAAO;AAET,KAAI,OAAO,QACT,QAAO;CAET,MAAM,aAAa,gCAAgC,OAAO,WAAW;AACrE,KAAI,sBAAsB,MAAM,WAAW,WAAW,SAAS,OAAO,CAAC,CACrE,QAAO;AAET,QAAO;;AAGT,SAAgB,0BAA0B,QAGP;CACjC,MAAM,iBAAiB,OAAO,YAAY;AAC1C,KAAI,CAAC,eACH;CAEF,MAAM,MAAM,iCAAiC,OAAO,QAAQ;AAC5D,KAAI,CAAC,IACH;AAEF,QAAO,eAAe"}
+{"version":3,"file":"reset-type.js","names":[],"sources":["../../../src/session/reset-type.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { normalizeOptionalLowercaseString } from '../utils/string-coerce.js';\n\nimport type { SessionResetConfig, SessionResetType } from './reset-policy.js';\n\nexport function resolveSessionResetType(params: {\n  isGroup?: boolean;\n  isThread?: boolean;\n}): SessionResetType {\n  if (params.isThread) {\n    return 'thread';\n  }\n  if (params.isGroup) {\n    return 'group';\n  }\n  return 'direct';\n}\n\nexport function resolveChannelResetConfig(params: {\n  sessionCfg?: Config['session'];\n  channel?: string | null;\n}): SessionResetConfig | undefined {\n  const resetByChannel = params.sessionCfg?.resetByChannel;\n  if (!resetByChannel) {\n    return undefined;\n  }\n  const key = normalizeOptionalLowercaseString(params.channel);\n  if (!key) {\n    return undefined;\n  }\n  return resetByChannel[key];\n}\n"],"mappings":";;oBAC6E;AAI7E,SAAgB,wBAAwB,QAGnB;AACnB,KAAI,OAAO,SACT,QAAO;AAET,KAAI,OAAO,QACT,QAAO;AAET,QAAO;;AAGT,SAAgB,0BAA0B,QAGP;CACjC,MAAM,iBAAiB,OAAO,YAAY;AAC1C,KAAI,CAAC,eACH;CAEF,MAAM,MAAM,iCAAiC,OAAO,QAAQ;AAC5D,KAAI,CAAC,IACH;AAEF,QAAO,eAAe"}

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

@@ -1,11 +1,8 @@
-import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
-import { init_agent_session_key, normalizeAgentId, resolveAgentIdFromSessionKey } from "../routing/agent-session-key.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
-import { findSessionKeyByTranscriptId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
+import { findSessionKeyBySessionId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
 import { normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
@@ -14,9 +11,6 @@ import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";
 import { randomUUID } from "node:crypto";
 //#region src/session/resolve-session.ts
 init_schema();
-init_agent_scope();
-init_agent_session_key();
-init_session_key();
 init_logger();
 const log = createLogger("ResolveSession");
 async function resolveSessionKeyForRequest(opts) {
@@ -24,11 +18,7 @@ async function resolveSessionKeyForRequest(opts) {
 	const explicitKey = opts.sessionKey?.trim();
 	const requestedSessionId = opts.sessionId?.trim();
 	let sessionKey = explicitKey;
-	if (requestedSessionId && !sessionKey) sessionKey = findSessionKeyByTranscriptId(requestedSessionId) ?? void 0;
-	if (requestedSessionId && !sessionKey) {
-		const storeAgentId = explicitKey ? resolveAgentIdFromSessionKey(explicitKey) : opts.agentId?.trim() ? normalizeAgentId(opts.agentId) : resolveDefaultAgentId(opts.cfg);
-		sessionKey = `agent:${normalizeAgentId(opts.agentId ?? storeAgentId)}:explicit:${requestedSessionId}`;
-	}
+	if (requestedSessionId && !sessionKey) sessionKey = findSessionKeyBySessionId(requestedSessionId) ?? void 0;
 	const sessionMetadata = sessionKey ? getSessionMetadata(sessionKey) : null;
 	return {
 		sessionKey,
@@ -39,19 +29,18 @@ async function resolveSession(opts) {
 	const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});
 	const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest(opts);
 	const now = Date.now();
-	const parsed = sessionKey ? parseSessionKey(sessionKey) : null;
-	const peerKind = parsed?.peerKind;
+	const routing = sessionMetadata?.routing;
+	const peerKind = routing?.peerKind;
 	const resetType = resolveSessionResetType({
-		sessionKey,
 		isGroup: peerKind === "group" || peerKind === "channel",
-		isThread: Boolean(parsed?.threadId)
+		isThread: Boolean(routing?.threadId)
 	});
 	const resetPolicy = resolveSessionResetPolicy({
 		sessionCfg,
 		resetType,
 		resetOverride: resolveChannelResetConfig({
 			sessionCfg,
-			channel: parsed?.source ?? sessionMetadata?.sourceChannel
+			channel: routing?.source ?? sessionMetadata?.sourceChannel
 		})
 	});
 	const lifecycle = resolveSessionLifecycleTimestamps({ entry: sessionMetadata ? {
@@ -65,14 +54,14 @@ async function resolveSession(opts) {
 		now,
 		policy: resetPolicy
 	}) : { fresh: false }).fresh;
-	const sessionId = opts.sessionId?.trim() || (fresh ? sessionMetadata?.transcriptId : void 0) || randomUUID();
+	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?.transcriptId,
+		previousSessionId: sessionMetadata?.sessionId,
 		sessionId,
 		resetType
-	}, "Session reset boundary — new transcript id for turn");
+	}, "Session reset boundary: new session id for turn");
 	return {
 		sessionId,
 		sessionKey,

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-session.js","names":[],"sources":["../../../src/session/resolve-session.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { SessionConfigSchema, type Config } from '../config/schema.js';\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport {\n  normalizeAgentId,\n  resolveAgentIdFromSessionKey,\n} from '../routing/agent-session-key.js';\nimport { parseSessionKey } from '../routing/session-key.js';\nimport {\n  normalizeThinkLevel,\n  normalizeVerboseLevel,\n  type ThinkLevel,\n  type VerboseLevel,\n} from '../agent/transcript/thinking-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  findSessionKeyByTranscriptId,\n  getSessionMetadata,\n  getSessionPersistedLevels,\n  requireXopcDatabase,\n} from '../storage/sqlite/index.js';\n\nimport { resolveSessionLifecycleTimestamps } from './lifecycle-timestamps.js';\nimport {\n  evaluateSessionFreshness,\n  resolveSessionResetPolicy,\n} from './reset-policy.js';\nimport { resolveChannelResetConfig, resolveSessionResetType } from './reset-type.js';\nimport type { SessionMetadata } from './types.js';\n\nconst log = createLogger('ResolveSession');\n\nexport type SessionResolution = {\n  sessionId: string;\n  sessionKey?: string;\n  sessionMetadata?: SessionMetadata | null;\n  isNewSession: boolean;\n  persistedThinking?: ThinkLevel;\n  persistedVerbose?: VerboseLevel;\n};\n\nexport type SessionKeyResolution = {\n  sessionKey?: string;\n  sessionMetadata?: SessionMetadata | null;\n};\n\nexport async function resolveSessionKeyForRequest(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionKeyResolution> {\n  requireXopcDatabase();\n  const explicitKey = opts.sessionKey?.trim();\n  const requestedSessionId = opts.sessionId?.trim();\n\n  let sessionKey = explicitKey;\n  if (requestedSessionId && !sessionKey) {\n    sessionKey = findSessionKeyByTranscriptId(requestedSessionId) ?? undefined;\n  }\n  if (requestedSessionId && !sessionKey) {\n    const storeAgentId = explicitKey\n      ? resolveAgentIdFromSessionKey(explicitKey)\n      : opts.agentId?.trim()\n        ? normalizeAgentId(opts.agentId)\n        : resolveDefaultAgentId(opts.cfg);\n    sessionKey = `agent:${normalizeAgentId(opts.agentId ?? storeAgentId)}:explicit:${requestedSessionId}`;\n  }\n\n  const sessionMetadata = sessionKey ? getSessionMetadata(sessionKey) : null;\n  return { sessionKey, sessionMetadata };\n}\n\nexport async function resolveSession(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionResolution> {\n  const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});\n  const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest(opts);\n  const now = Date.now();\n\n  const parsed = sessionKey ? parseSessionKey(sessionKey) : null;\n  const peerKind = parsed?.peerKind;\n  const resetType = resolveSessionResetType({\n    sessionKey,\n    isGroup: peerKind === 'group' || peerKind === 'channel',\n    isThread: Boolean(parsed?.threadId),\n  });\n  const channelReset = resolveChannelResetConfig({\n    sessionCfg,\n    channel: parsed?.source ?? sessionMetadata?.sourceChannel,\n  });\n  const resetPolicy = resolveSessionResetPolicy({\n    sessionCfg,\n    resetType,\n    resetOverride: channelReset,\n  });\n  const lifecycle = resolveSessionLifecycleTimestamps({\n    entry: sessionMetadata\n      ? {\n          updatedAt: Date.parse(sessionMetadata.updatedAt),\n          sessionStartedAt: sessionMetadata.sessionStartedAt\n            ? Date.parse(sessionMetadata.sessionStartedAt)\n            : undefined,\n          lastInteractionAt: sessionMetadata.lastInteractionAt\n            ? Date.parse(sessionMetadata.lastInteractionAt)\n            : undefined,\n        }\n      : undefined,\n  });\n  const freshness = sessionMetadata\n    ? evaluateSessionFreshness({\n        updatedAt: Date.parse(sessionMetadata.updatedAt),\n        ...lifecycle,\n        now,\n        policy: resetPolicy,\n      })\n    : { fresh: false };\n  const fresh = freshness.fresh;\n  const sessionId =\n    opts.sessionId?.trim() || (fresh ? sessionMetadata?.transcriptId : undefined) || randomUUID();\n  const isNewSession = !fresh && !opts.sessionId?.trim();\n\n  if (isNewSession && sessionKey) {\n    log.debug(\n      { sessionKey, previousSessionId: sessionMetadata?.transcriptId, sessionId, resetType },\n      'Session reset boundary — new transcript id for turn',\n    );\n  }\n\n  const persistedThinking =\n    fresh && sessionKey\n      ? normalizeThinkLevel(getSessionPersistedLevels(sessionKey)?.thinkingLevel ?? undefined)\n      : undefined;\n  const persistedVerbose =\n    fresh && sessionKey\n      ? normalizeVerboseLevel(getSessionPersistedLevels(sessionKey)?.verboseLevel ?? undefined)\n      : undefined;\n\n  return {\n    sessionId,\n    sessionKey,\n    sessionMetadata,\n    isNewSession,\n    persistedThinking,\n    persistedVerbose,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;aAEuE;kBACP;wBAIvB;kBACmB;aAOV;AAgBlD,MAAM,MAAM,aAAa,iBAAiB;AAgB1C,eAAsB,4BAA4B,MAKhB;AAChC,sBAAqB;CACrB,MAAM,cAAc,KAAK,YAAY,MAAM;CAC3C,MAAM,qBAAqB,KAAK,WAAW,MAAM;CAEjD,IAAI,aAAa;AACjB,KAAI,sBAAsB,CAAC,WACzB,cAAa,6BAA6B,mBAAmB,IAAI,KAAA;AAEnE,KAAI,sBAAsB,CAAC,YAAY;EACrC,MAAM,eAAe,cACjB,6BAA6B,YAAY,GACzC,KAAK,SAAS,MAAM,GAClB,iBAAiB,KAAK,QAAQ,GAC9B,sBAAsB,KAAK,IAAI;AACrC,eAAa,SAAS,iBAAiB,KAAK,WAAW,aAAa,CAAC,YAAY;;CAGnF,MAAM,kBAAkB,aAAa,mBAAmB,WAAW,GAAG;AACtE,QAAO;EAAE;EAAY;EAAiB;;AAGxC,eAAsB,eAAe,MAKN;CAC7B,MAAM,aAAa,KAAK,IAAI,WAAW,oBAAoB,MAAM,EAAE,CAAC;CACpE,MAAM,EAAE,YAAY,oBAAoB,MAAM,4BAA4B,KAAK;CAC/E,MAAM,MAAM,KAAK,KAAK;CAEtB,MAAM,SAAS,aAAa,gBAAgB,WAAW,GAAG;CAC1D,MAAM,WAAW,QAAQ;CACzB,MAAM,YAAY,wBAAwB;EACxC;EACA,SAAS,aAAa,WAAW,aAAa;EAC9C,UAAU,QAAQ,QAAQ,SAAS;EACpC,CAAC;CAKF,MAAM,cAAc,0BAA0B;EAC5C;EACA;EACA,eAPmB,0BAA0B;GAC7C;GACA,SAAS,QAAQ,UAAU,iBAAiB;GAC7C,CAI4B;EAC5B,CAAC;CACF,MAAM,YAAY,kCAAkC,EAClD,OAAO,kBACH;EACE,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,kBAAkB,gBAAgB,mBAC9B,KAAK,MAAM,gBAAgB,iBAAiB,GAC5C,KAAA;EACJ,mBAAmB,gBAAgB,oBAC/B,KAAK,MAAM,gBAAgB,kBAAkB,GAC7C,KAAA;EACL,GACD,KAAA,GACL,CAAC;CASF,MAAM,SARY,kBACd,yBAAyB;EACvB,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,GAAG;EACH;EACA,QAAQ;EACT,CAAC,GACF,EAAE,OAAO,OAAO,EACI;CACxB,MAAM,YACJ,KAAK,WAAW,MAAM,KAAK,QAAQ,iBAAiB,eAAe,KAAA,MAAc,YAAY;CAC/F,MAAM,eAAe,CAAC,SAAS,CAAC,KAAK,WAAW,MAAM;AAEtD,KAAI,gBAAgB,WAClB,KAAI,MACF;EAAE;EAAY,mBAAmB,iBAAiB;EAAc;EAAW;EAAW,EACtF,sDACD;AAYH,QAAO;EACL;EACA;EACA;EACA;EACA,mBAbA,SAAS,aACL,oBAAoB,0BAA0B,WAAW,EAAE,iBAAiB,KAAA,EAAU,GACtF,KAAA;EAYJ,kBAVA,SAAS,aACL,sBAAsB,0BAA0B,WAAW,EAAE,gBAAgB,KAAA,EAAU,GACvF,KAAA;EASL"}
+{"version":3,"file":"resolve-session.js","names":[],"sources":["../../../src/session/resolve-session.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { SessionConfigSchema, type Config } from '../config/schema.js';\nimport {\n  normalizeThinkLevel,\n  normalizeVerboseLevel,\n  type ThinkLevel,\n  type VerboseLevel,\n} from '../agent/transcript/thinking-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  findSessionKeyBySessionId,\n  getSessionMetadata,\n  getSessionPersistedLevels,\n  requireXopcDatabase,\n} from '../storage/sqlite/index.js';\n\nimport { resolveSessionLifecycleTimestamps } from './lifecycle-timestamps.js';\nimport {\n  evaluateSessionFreshness,\n  resolveSessionResetPolicy,\n} from './reset-policy.js';\nimport { resolveChannelResetConfig, resolveSessionResetType } from './reset-type.js';\nimport type { SessionMetadata } from './types.js';\n\nconst log = createLogger('ResolveSession');\n\nexport type SessionResolution = {\n  sessionId: string;\n  sessionKey?: string;\n  sessionMetadata?: SessionMetadata | null;\n  isNewSession: boolean;\n  persistedThinking?: ThinkLevel;\n  persistedVerbose?: VerboseLevel;\n};\n\nexport type SessionKeyResolution = {\n  sessionKey?: string;\n  sessionMetadata?: SessionMetadata | null;\n};\n\nexport async function resolveSessionKeyForRequest(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionKeyResolution> {\n  requireXopcDatabase();\n  const explicitKey = opts.sessionKey?.trim();\n  const requestedSessionId = opts.sessionId?.trim();\n\n  let sessionKey = explicitKey;\n  if (requestedSessionId && !sessionKey) {\n    sessionKey = findSessionKeyBySessionId(requestedSessionId) ?? undefined;\n  }\n\n  const sessionMetadata = sessionKey ? getSessionMetadata(sessionKey) : null;\n  return { sessionKey, sessionMetadata };\n}\n\nexport async function resolveSession(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionResolution> {\n  const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});\n  const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest(opts);\n  const now = Date.now();\n\n  const routing = sessionMetadata?.routing;\n  const peerKind = routing?.peerKind;\n  const resetType = resolveSessionResetType({\n    isGroup: peerKind === 'group' || peerKind === 'channel',\n    isThread: Boolean(routing?.threadId),\n  });\n  const channelReset = resolveChannelResetConfig({\n    sessionCfg,\n    channel: routing?.source ?? sessionMetadata?.sourceChannel,\n  });\n  const resetPolicy = resolveSessionResetPolicy({\n    sessionCfg,\n    resetType,\n    resetOverride: channelReset,\n  });\n  const lifecycle = resolveSessionLifecycleTimestamps({\n    entry: sessionMetadata\n      ? {\n          updatedAt: Date.parse(sessionMetadata.updatedAt),\n          sessionStartedAt: sessionMetadata.sessionStartedAt\n            ? Date.parse(sessionMetadata.sessionStartedAt)\n            : undefined,\n          lastInteractionAt: sessionMetadata.lastInteractionAt\n            ? Date.parse(sessionMetadata.lastInteractionAt)\n            : undefined,\n        }\n      : undefined,\n  });\n  const freshness = sessionMetadata\n    ? evaluateSessionFreshness({\n        updatedAt: Date.parse(sessionMetadata.updatedAt),\n        ...lifecycle,\n        now,\n        policy: resetPolicy,\n      })\n    : { fresh: false };\n  const fresh = freshness.fresh;\n  const sessionId =\n    opts.sessionId?.trim() || (fresh ? sessionMetadata?.sessionId : undefined) || randomUUID();\n  const isNewSession = !fresh && !opts.sessionId?.trim();\n\n  if (isNewSession && sessionKey) {\n    log.debug(\n      { sessionKey, previousSessionId: sessionMetadata?.sessionId, sessionId, resetType },\n      'Session reset boundary: new session id for turn',\n    );\n  }\n\n  const persistedThinking =\n    fresh && sessionKey\n      ? normalizeThinkLevel(getSessionPersistedLevels(sessionKey)?.thinkingLevel ?? undefined)\n      : undefined;\n  const persistedVerbose =\n    fresh && sessionKey\n      ? normalizeVerboseLevel(getSessionPersistedLevels(sessionKey)?.verboseLevel ?? undefined)\n      : undefined;\n\n  return {\n    sessionId,\n    sessionKey,\n    sessionMetadata,\n    isNewSession,\n    persistedThinking,\n    persistedVerbose,\n  };\n}\n"],"mappings":";;;;;;;;;;;;aAEuE;aAOrB;AAgBlD,MAAM,MAAM,aAAa,iBAAiB;AAgB1C,eAAsB,4BAA4B,MAKhB;AAChC,sBAAqB;CACrB,MAAM,cAAc,KAAK,YAAY,MAAM;CAC3C,MAAM,qBAAqB,KAAK,WAAW,MAAM;CAEjD,IAAI,aAAa;AACjB,KAAI,sBAAsB,CAAC,WACzB,cAAa,0BAA0B,mBAAmB,IAAI,KAAA;CAGhE,MAAM,kBAAkB,aAAa,mBAAmB,WAAW,GAAG;AACtE,QAAO;EAAE;EAAY;EAAiB;;AAGxC,eAAsB,eAAe,MAKN;CAC7B,MAAM,aAAa,KAAK,IAAI,WAAW,oBAAoB,MAAM,EAAE,CAAC;CACpE,MAAM,EAAE,YAAY,oBAAoB,MAAM,4BAA4B,KAAK;CAC/E,MAAM,MAAM,KAAK,KAAK;CAEtB,MAAM,UAAU,iBAAiB;CACjC,MAAM,WAAW,SAAS;CAC1B,MAAM,YAAY,wBAAwB;EACxC,SAAS,aAAa,WAAW,aAAa;EAC9C,UAAU,QAAQ,SAAS,SAAS;EACrC,CAAC;CAKF,MAAM,cAAc,0BAA0B;EAC5C;EACA;EACA,eAPmB,0BAA0B;GAC7C;GACA,SAAS,SAAS,UAAU,iBAAiB;GAC9C,CAI4B;EAC5B,CAAC;CACF,MAAM,YAAY,kCAAkC,EAClD,OAAO,kBACH;EACE,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,kBAAkB,gBAAgB,mBAC9B,KAAK,MAAM,gBAAgB,iBAAiB,GAC5C,KAAA;EACJ,mBAAmB,gBAAgB,oBAC/B,KAAK,MAAM,gBAAgB,kBAAkB,GAC7C,KAAA;EACL,GACD,KAAA,GACL,CAAC;CASF,MAAM,SARY,kBACd,yBAAyB;EACvB,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,GAAG;EACH;EACA,QAAQ;EACT,CAAC,GACF,EAAE,OAAO,OAAO,EACI;CACxB,MAAM,YACJ,KAAK,WAAW,MAAM,KAAK,QAAQ,iBAAiB,YAAY,KAAA,MAAc,YAAY;CAC5F,MAAM,eAAe,CAAC,SAAS,CAAC,KAAK,WAAW,MAAM;AAEtD,KAAI,gBAAgB,WAClB,KAAI,MACF;EAAE;EAAY,mBAAmB,iBAAiB;EAAW;EAAW;EAAW,EACnF,kDACD;AAYH,QAAO;EACL;EACA;EACA;EACA;EACA,mBAbA,SAAS,aACL,oBAAoB,0BAA0B,WAAW,EAAE,iBAAiB,KAAA,EAAU,GACtF,KAAA;EAYJ,kBAVA,SAAS,aACL,sBAAsB,0BAA0B,WAAW,EAAE,gBAAgB,KAAA,EAAU,GACvF,KAAA;EASL"}

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

@@ -1,7 +1,7 @@
-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 { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";

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

@@ -2,6 +2,7 @@ import type { AgentMessage } from '@earendil-works/pi-agent-core';
 import type { Config } from '../config/schema.js';
 import { type CompactionConfig, type CompactionResult } from '../agent/memory/compaction.js';
 import { type WindowConfig } from '../agent/memory/window.js';
+import { type SessionMetadataSeed } from '../storage/sqlite/index.js';
 import type { XopcSessionTranscriptV1 } from './transcript-format.js';
 import { type TranscriptStoredRow, type XopcTranscriptContextEntry } from './session-context-for-llm.js';
 import type { SessionMetadata, SessionDetail, SessionListQuery, PaginatedResult, GlobalSessionStats, ExportFormat, CompactionCheckpointSummary, CompactionCheckpointDetail } from './types.js';
@@ -20,11 +21,15 @@ export declare class SessionStore {
     private runStoreMutation;
     initialize(): Promise<void>;
     getSessionsRoot(): string;
-    resolveTranscriptPath(sessionKey: string): Promise<{
+    resolveTranscriptPath(sessionKey: string, options?: {
+        metadata?: SessionMetadataSeed;
+    }): Promise<{
         sessionId: string;
         sessionKey: string;
     }>;
-    appendTranscriptMessage(sessionKey: string, message: AgentMessage): Promise<void>;
+    appendTranscriptMessage(sessionKey: string, message: AgentMessage, options?: {
+        metadata?: SessionMetadataSeed;
+    }): Promise<void>;
     getByAgent(agentId: string): Promise<SessionMetadata[]>;
     getByAccount(accountId: string): Promise<SessionMetadata[]>;
     getByPeer(peerKind: string, peerId: string): Promise<SessionMetadata[]>;
@@ -55,6 +60,7 @@ export declare class SessionStore {
     private buildSessionDetail;
     loadTranscriptRows(key: string): Promise<TranscriptStoredRow[]>;
     getMetadata(key: string): Promise<SessionMetadata | null>;
+    resolveKeyBySessionId(sessionId: string): Promise<string | null>;
     updateMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void>;
     reset(key: string): Promise<{
         sessionId: string;
@@ -99,7 +105,9 @@ export declare class SessionStore {
         truncated?: boolean;
         fullOutputPath?: string;
     }): Promise<void>;
-    saveMessages(key: string, messages: AgentMessage[]): Promise<void>;
+    saveMessages(key: string, messages: AgentMessage[], options?: {
+        metadata?: SessionMetadataSeed;
+    }): Promise<void>;
     getWindowStats(messages: AgentMessage[]): {
         total: number;
         system: number;

package/dist/src/session/store.js

@@ -1,12 +1,12 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import "./types.js";
 import { buildSessionContextForLlm, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
-import { deleteSessionRecord, ensureSessionRecord, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
+import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
 import { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckpointDetail, listCompactionCheckpoints, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRowsForSession, replaceTranscriptRows, restoreCompactionCheckpoint } from "../storage/sqlite/transcript-repository.js";
 import "../storage/sqlite/index.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
@@ -40,17 +40,17 @@ var SessionStore = class {
 	getSessionsRoot() {
 		return resolveStateDir();
 	}
-	async resolveTranscriptPath(sessionKey) {
+	async resolveTranscriptPath(sessionKey, options) {
 		requireXopcDatabase();
 		return {
-			sessionId: ensureSessionRecord(sessionKey, this.resolveWorkspaceCwd(sessionKey)).transcriptId,
+			sessionId: ensureSessionRecord(sessionKey, this.resolveWorkspaceCwd(sessionKey), options?.metadata).sessionId,
 			sessionKey
 		};
 	}
-	async appendTranscriptMessage(sessionKey, message) {
+	async appendTranscriptMessage(sessionKey, message, options) {
 		return this.runStoreMutation(async () => {
 			requireXopcDatabase();
-			ensureSessionRecord(sessionKey, this.resolveWorkspaceCwd(sessionKey));
+			ensureSessionRecord(sessionKey, this.resolveWorkspaceCwd(sessionKey), options?.metadata);
 			appendTranscriptEntry(sessionKey, message);
 		});
 	}
@@ -137,6 +137,10 @@ var SessionStore = class {
 		requireXopcDatabase();
 		return getSessionMetadata(key);
 	}
+	async resolveKeyBySessionId(sessionId) {
+		requireXopcDatabase();
+		return findSessionKeyBySessionId(sessionId);
+	}
 	async updateMetadata(key, updates) {
 		return this.runStoreMutation(async () => {
 			requireXopcDatabase();
@@ -201,7 +205,7 @@ var SessionStore = class {
 	}
 	async loadTranscriptDocument(key) {
 		const metadata = await this.getMetadata(key);
-		if (!metadata?.transcriptId) return null;
+		if (!metadata?.sessionId) return null;
 		const rows = await this.loadTranscriptRows(key);
 		const compactions = [];
 		for (const row of rows) if (row.type === "compaction") {
@@ -217,7 +221,7 @@ var SessionStore = class {
 		return {
 			type: "xopc_session_transcript",
 			version: 1,
-			id: metadata.transcriptId,
+			id: metadata.sessionId,
 			createdAt: metadata.createdAt,
 			updatedAt: metadata.updatedAt,
 			messages: rows,
@@ -301,10 +305,10 @@ var SessionStore = class {
 			});
 		});
 	}
-	async saveMessages(key, messages) {
+	async saveMessages(key, messages, options) {
 		return this.runStoreMutation(async () => {
 			requireXopcDatabase();
-			ensureSessionRecord(key, this.resolveWorkspaceCwd(key));
+			ensureSessionRecord(key, this.resolveWorkspaceCwd(key), options?.metadata);
 			replaceTranscriptRows(key, mergeLlmMessagesPreservingContextRows(await this.loadTranscriptRows(key), messages));
 		});
 	}
@@ -430,9 +434,15 @@ var SessionStore = class {
 			const rowsSource = Array.isArray(record.transcriptRows) ? record.transcriptRows : void 0;
 			const rows = rowsSource ? transcriptRowsFromJsonArray(rowsSource) : [];
 			if (rows.length === 0) throw new Error("Session export contains no importable transcript rows");
-			ensureSessionRecord(targetKey, this.resolveWorkspaceCwd(targetKey));
-			replaceTranscriptRows(targetKey, rows);
 			const metadata = record.metadata && typeof record.metadata === "object" ? record.metadata : {};
+			ensureSessionRecord(targetKey, this.resolveWorkspaceCwd(targetKey), {
+				sourceChannel: metadata.sourceChannel,
+				sourceChatId: metadata.sourceChatId,
+				sessionType: metadata.sessionType,
+				routing: metadata.routing,
+				customData: metadata.customData
+			});
+			replaceTranscriptRows(targetKey, rows);
 			const sourceKey = typeof metadata.key === "string" ? metadata.key : void 0;
 			const sourceName = typeof metadata.name === "string" ? metadata.name.trim() : "";
 			patchSessionMetadata(targetKey, {
@@ -462,7 +472,13 @@ var SessionStore = class {
 			const rows = await this.loadTranscriptRows(sourceKey);
 			if (options.throughRow !== void 0 && (options.throughRow < 1 || options.throughRow > rows.length)) throw new Error(`Invalid fork row: ${options.throughRow}`);
 			const selectedRows = options.throughRow === void 0 ? rows : rows.slice(0, Math.max(0, Math.trunc(options.throughRow)));
-			ensureSessionRecord(targetKey, this.resolveWorkspaceCwd(targetKey));
+			ensureSessionRecord(targetKey, this.resolveWorkspaceCwd(targetKey), {
+				sourceChannel: sourceMetadata.sourceChannel,
+				sourceChatId: sourceMetadata.sourceChatId,
+				sessionType: sourceMetadata.sessionType,
+				routing: sourceMetadata.routing,
+				customData: sourceMetadata.customData
+			});
 			replaceTranscriptRows(targetKey, selectedRows);
 			patchSessionMetadata(targetKey, {
 				name: `Fork of ${sourceMetadata.name?.trim() || sourceKey}`,
@@ -470,7 +486,7 @@ var SessionStore = class {
 				customData: {
 					...sourceMetadata.customData ?? {},
 					forkedFromSessionKey: sourceKey,
-					forkedFromTranscriptId: sourceMetadata.transcriptId,
+					forkedFromSessionId: sourceMetadata.sessionId,
 					...options.throughRow !== void 0 ? { forkedFromRow: selectedRows.length } : {},
 					forkedAt: (/* @__PURE__ */ new Date()).toISOString()
 				}