@xopcai/xopc 0.0.86 → 0.0.87

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

@@ -0,0 +1,102 @@
+import { SessionConfigSchema, init_schema } from "../config/schema.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 { 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 { bareResetAckMessage, matchResetTriggers, resolveResetTriggers } from "./reset-triggers.js";
+import { randomUUID } from "node:crypto";
+//#region src/session/init-session-turn.ts
+init_schema();
+init_session_key();
+init_logger();
+const log = createLogger("InitSessionTurn");
+/**
+* Turn-start session init: match `resetTriggers`, evaluate freshness, archive +
+* assign new `sessionId` when stale or explicitly reset. OpenClaw `initSessionState`
+* equivalent for xopc direct + channel paths.
+*/
+async function initSessionTurn(opts) {
+	const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});
+	const triggers = resolveResetTriggers(sessionCfg.resetTriggers);
+	const rawBody = opts.body ?? "";
+	const triggerMatch = matchResetTriggers(rawBody, triggers);
+	const { sessionKey, sessionStore } = await resolveSessionKeyForRequest({
+		cfg: opts.cfg,
+		sessionKey: opts.sessionKey
+	});
+	const key = sessionKey?.trim() ?? opts.sessionKey.trim();
+	const sessionEntry = key ? sessionStore[key] : void 0;
+	const parsed = key ? parseSessionKey(key) : null;
+	const peerKind = parsed?.peerKind;
+	const resetType = resolveSessionResetType({
+		sessionKey: key,
+		isGroup: peerKind === "group" || peerKind === "channel",
+		isThread: Boolean(parsed?.threadId)
+	});
+	const meta = sessionEntry?.pluginExtensions?.xopc?.metadata;
+	const resetPolicy = resolveSessionResetPolicy({
+		sessionCfg,
+		resetType,
+		resetOverride: resolveChannelResetConfig({
+			sessionCfg,
+			channel: parsed?.source ?? meta?.sourceChannel
+		})
+	});
+	const lifecycle = resolveSessionLifecycleTimestamps({ entry: sessionEntry });
+	const now = Date.now();
+	const freshness = sessionEntry ? evaluateSessionFreshness({
+		updatedAt: sessionEntry.updatedAt,
+		...lifecycle,
+		now,
+		policy: resetPolicy
+	}) : { fresh: false };
+	const skipImplicit = opts.skipImplicitExpiry ?? false;
+	const staleRollover = Boolean(sessionEntry && !skipImplicit && !freshness.fresh);
+	const needsRollover = triggerMatch.resetTriggered || staleRollover;
+	let sessionId = sessionEntry?.sessionId;
+	let previousSessionId;
+	let isNewSession = false;
+	if (needsRollover && sessionEntry?.sessionId) {
+		const outcome = await opts.resetSession(key);
+		if (outcome) {
+			previousSessionId = outcome.previousSessionId;
+			sessionId = outcome.sessionId;
+			isNewSession = true;
+			log.info({
+				sessionKey: key,
+				sessionId: outcome.sessionId,
+				previousSessionId: outcome.previousSessionId,
+				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();
+			isNewSession = true;
+		}
+	} else if (!sessionEntry) {
+		isNewSession = true;
+		sessionId = randomUUID();
+	}
+	const bareReset = triggerMatch.resetTriggered && triggerMatch.bareReset;
+	const ackMessage = bareReset ? bareResetAckMessage(triggerMatch.matchedTrigger) : void 0;
+	return {
+		sessionKey: key,
+		sessionId,
+		previousSessionId,
+		isNewSession,
+		resetTriggered: triggerMatch.resetTriggered,
+		staleRollover,
+		bodyStripped: triggerMatch.resetTriggered ? triggerMatch.bodyStripped : rawBody,
+		bareReset,
+		ackMessage
+	};
+}
+//#endregion
+export { initSessionTurn };
+
+//# sourceMappingURL=init-session-turn.js.map

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

@@ -0,0 +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';\n\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  /** When true, skip idle/daily implicit rollover (provider-owned CLI sessions). */\n  skipImplicitExpiry?: boolean;\n};\n\n/**\n * Turn-start session init: match `resetTriggers`, evaluate freshness, archive +\n * assign new `sessionId` when stale or explicitly reset. OpenClaw `initSessionState`\n * equivalent for xopc direct + channel paths.\n */\nexport async function initSessionTurn(\n  opts: InitSessionTurnOptions,\n): Promise<InitSessionTurnResult> {\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, sessionStore } = await resolveSessionKeyForRequest({\n    cfg: opts.cfg,\n    sessionKey: opts.sessionKey,\n  });\n  const key = sessionKey?.trim() ?? opts.sessionKey.trim();\n  const sessionEntry = key ? sessionStore[key] : undefined;\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 meta = sessionEntry?.pluginExtensions?.xopc?.metadata;\n  const channelReset = resolveChannelResetConfig({\n    sessionCfg,\n    channel: parsed?.source ?? meta?.sourceChannel,\n  });\n  const resetPolicy = resolveSessionResetPolicy({\n    sessionCfg,\n    resetType,\n    resetOverride: channelReset,\n  });\n  const lifecycle = resolveSessionLifecycleTimestamps({ entry: sessionEntry });\n  const now = Date.now();\n  const freshness = sessionEntry\n    ? evaluateSessionFreshness({\n        updatedAt: sessionEntry.updatedAt,\n        ...lifecycle,\n        now,\n        policy: resetPolicy,\n      })\n    : { fresh: false };\n\n  const skipImplicit = opts.skipImplicitExpiry ?? false;\n  const staleRollover = Boolean(sessionEntry && !skipImplicit && !freshness.fresh);\n  const needsRollover = triggerMatch.resetTriggered || staleRollover;\n\n  let sessionId = sessionEntry?.sessionId;\n  let previousSessionId: string | undefined;\n  let isNewSession = false;\n\n  if (needsRollover && sessionEntry?.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 (!sessionEntry) {\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;;;;;;AAgC3C,eAAsB,gBACpB,MACgC;CAChC,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,iBAAiB,MAAM,4BAA4B;EACrE,KAAK,KAAK;EACV,YAAY,KAAK;EAClB,CAAC;CACF,MAAM,MAAM,YAAY,MAAM,IAAI,KAAK,WAAW,MAAM;CACxD,MAAM,eAAe,MAAM,aAAa,OAAO,KAAA;CAE/C,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;CACF,MAAM,OAAO,cAAc,kBAAkB,MAAM;CAKnD,MAAM,cAAc,0BAA0B;EAC5C;EACA;EACA,eAPmB,0BAA0B;GAC7C;GACA,SAAS,QAAQ,UAAU,MAAM;GAClC,CAI4B;EAC5B,CAAC;CACF,MAAM,YAAY,kCAAkC,EAAE,OAAO,cAAc,CAAC;CAC5E,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,YAAY,eACd,yBAAyB;EACvB,WAAW,aAAa;EACxB,GAAG;EACH;EACA,QAAQ;EACT,CAAC,GACF,EAAE,OAAO,OAAO;CAEpB,MAAM,eAAe,KAAK,sBAAsB;CAChD,MAAM,gBAAgB,QAAQ,gBAAgB,CAAC,gBAAgB,CAAC,UAAU,MAAM;CAChF,MAAM,gBAAgB,aAAa,kBAAkB;CAErD,IAAI,YAAY,cAAc;CAC9B,IAAI;CACJ,IAAI,eAAe;AAEnB,KAAI,iBAAiB,cAAc,WAAW;EAC5C,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,cAAc;AACxB,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/lifecycle-timestamps.d.ts

@@ -0,0 +1,8 @@
+import type { XopcSessionDiskEntry } from './parity/xopc-session-disk-entry.js';
+export type SessionLifecycleEntry = Pick<XopcSessionDiskEntry, 'sessionStartedAt' | 'lastInteractionAt' | 'updatedAt'>;
+export declare function resolveSessionLifecycleTimestamps(params: {
+    entry: SessionLifecycleEntry | undefined;
+}): {
+    sessionStartedAt?: number;
+    lastInteractionAt?: number;
+};

package/dist/src/session/lifecycle-timestamps.js

@@ -0,0 +1,16 @@
+//#region src/session/lifecycle-timestamps.ts
+function resolveTimestamp(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
+}
+function resolveSessionLifecycleTimestamps(params) {
+	const entry = params.entry;
+	if (!entry) return {};
+	return {
+		sessionStartedAt: resolveTimestamp(entry.sessionStartedAt),
+		lastInteractionAt: resolveTimestamp(entry.lastInteractionAt)
+	};
+}
+//#endregion
+export { resolveSessionLifecycleTimestamps };
+
+//# sourceMappingURL=lifecycle-timestamps.js.map

package/dist/src/session/lifecycle-timestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-timestamps.js","names":[],"sources":["../../../src/session/lifecycle-timestamps.ts"],"sourcesContent":["import type { XopcSessionDiskEntry } from './parity/xopc-session-disk-entry.js';\n\nexport type SessionLifecycleEntry = Pick<\n  XopcSessionDiskEntry,\n  'sessionStartedAt' | 'lastInteractionAt' | 'updatedAt'\n>;\n\nfunction resolveTimestamp(value: number | undefined): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined;\n}\n\nexport function resolveSessionLifecycleTimestamps(params: {\n  entry: SessionLifecycleEntry | undefined;\n}): { sessionStartedAt?: number; lastInteractionAt?: number } {\n  const entry = params.entry;\n  if (!entry) {\n    return {};\n  }\n  return {\n    sessionStartedAt: resolveTimestamp(entry.sessionStartedAt),\n    lastInteractionAt: resolveTimestamp(entry.lastInteractionAt),\n  };\n}\n"],"mappings":";AAOA,SAAS,iBAAiB,OAA+C;AACvE,QAAO,OAAO,UAAU,YAAY,OAAO,SAAS,MAAM,IAAI,SAAS,IAAI,QAAQ,KAAA;;AAGrF,SAAgB,kCAAkC,QAEY;CAC5D,MAAM,QAAQ,OAAO;AACrB,KAAI,CAAC,MACH,QAAO,EAAE;AAEX,QAAO;EACL,kBAAkB,iBAAiB,MAAM,iBAAiB;EAC1D,mBAAmB,iBAAiB,MAAM,kBAAkB;EAC7D"}

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

@@ -112,7 +112,8 @@ export declare class SessionIndex extends EventEmitter {
     /** Wrapped transcript document (stable id, compaction history); null if missing or not a valid envelope. */
     loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null>;
     /**
-     * @deprecated Runtime turns must use PiTranscriptManager.appendMessage. Compaction/admin only.
+     * Runtime turns must use PiTranscriptManager.appendMessage; this entry point
+     * is reserved for compaction, tests, and admin tools.
      */
     saveMessages(key: string, messages: any[]): Promise<void>;
     /**
@@ -121,6 +122,11 @@ export declare class SessionIndex extends EventEmitter {
     appendTranscriptContextEntry(key: string, entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>): Promise<void>;
     /** Delete session data */
     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;
+    } | null>;
     /** Token/window stats for a message list */
     getWindowStats(messages: any[]): {
         total: number;

package/dist/src/session/manager.js

@@ -204,7 +204,8 @@ var SessionIndex = class extends EventEmitter$1 {
 		return this.store.loadTranscriptDocument(key);
 	}
 	/**
-	* @deprecated Runtime turns must use PiTranscriptManager.appendMessage. Compaction/admin only.
+	* 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);
@@ -220,6 +221,12 @@ var SessionIndex = class extends EventEmitter$1 {
 	async delete(key) {
 		await this.store.delete(key);
 	}
+	/** Archive transcript and start a new session id for the same key. */
+	async resetSession(key) {
+		const result = await this.store.reset(key);
+		if (result) this.emit("sessionUpdated", { key });
+		return result;
+	}
 	/** Token/window stats for a message list */
 	getWindowStats(messages) {
 		return this.store.getWindowStats(messages);

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  agentId?: string;\n  sessionsDir?: string;\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        agentId: config.agentId,\n        sessionsDir: config.sessionsDir,\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  /**\n   * List all subagent sessions.\n   * Subagent sessions have keys starting with 'subagent:'.\n   */\n  async listSubagents(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    // Filter for subagent sessions only\n    const subagentQuery: SessionListQuery = {\n      ...query,\n      search: query.search ? `subagent:${query.search}` : 'subagent:',\n    };\n    \n    const result = await this.store.list(subagentQuery);\n    \n    // Additional filtering to ensure only subagent sessions\n    const subagentSessions = result.items.filter((s) => s.key.startsWith('subagent:'));\n    \n    return {\n      ...result,\n      items: subagentSessions,\n      total: subagentSessions.length,\n      hasMore: false, // Simplified for now\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    await this.store.updateMetadata(key, { name });\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, 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  // ========== 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   * @deprecated Runtime turns must use PiTranscriptManager.appendMessage. Compaction/admin only.\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  /** Delete session data */\n  async delete(key: string): Promise<void> {\n    await this.store.delete(key);\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 { 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  agentId?: string;\n  sessionsDir?: string;\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        agentId: config.agentId,\n        sessionsDir: config.sessionsDir,\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  /**\n   * List all subagent sessions.\n   * Subagent sessions have keys starting with 'subagent:'.\n   */\n  async listSubagents(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    // Filter for subagent sessions only\n    const subagentQuery: SessionListQuery = {\n      ...query,\n      search: query.search ? `subagent:${query.search}` : 'subagent:',\n    };\n    \n    const result = await this.store.list(subagentQuery);\n    \n    // Additional filtering to ensure only subagent sessions\n    const subagentSessions = result.items.filter((s) => s.key.startsWith('subagent:'));\n    \n    return {\n      ...result,\n      items: subagentSessions,\n      total: subagentSessions.length,\n      hasMore: false, // Simplified for now\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    await this.store.updateMetadata(key, { name });\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, 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  // ========== 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  /** 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":";;;;;;aAGkD;AAmBlD,MAAM,MAAM,aAAa,eAAe;AAUxC,IAAa,eAAb,cAAkCA,eAAa;CAC7C;CAEA,YAAY,QAA4B;AACtC,SAAO;AACP,OAAK,QAAQ,IAAI,aACf;GACE,QAAQ,OAAO;GACf,SAAS,OAAO;GAChB,aAAa,OAAO;GACrB,EACD,OAAO,cACP,OAAO,iBACR;;CAGH,MAAM,aAA4B;AAChC,QAAM,KAAK,MAAM,YAAY;AAC7B,OAAK,KAAK,QAAQ;;;CAIpB,WAAyB;AACvB,SAAO,KAAK;;CAKd,MAAM,aAAa,OAAqE;AACtF,SAAO,KAAK,MAAM,KAAK,MAAM;;;;;;CAO/B,MAAM,cAAc,QAA0B,EAAE,EAA6C;EAE3F,MAAM,gBAAkC;GACtC,GAAG;GACH,QAAQ,MAAM,SAAS,YAAY,MAAM,WAAW;GACrD;EAED,MAAM,SAAS,MAAM,KAAK,MAAM,KAAK,cAAc;EAGnD,MAAM,mBAAmB,OAAO,MAAM,QAAQ,MAAM,EAAE,IAAI,WAAW,YAAY,CAAC;AAElF,SAAO;GACL,GAAG;GACH,OAAO;GACP,OAAO,iBAAiB;GACxB,SAAS;GACV;;CAGH,MAAM,WACJ,KACA,SAC+B;EAC/B,MAAM,UAAU,MAAM,KAAK,MAAM,IAAI,KAAK,QAAQ;AAClD,MAAI,QACF,MAAK,KAAK,mBAAmB,EAAE,KAAK,CAAC;AAEvC,SAAO;;CAGT,MAAM,sBACJ,KACA,SAiBQ;EACR,MAAM,SAAS,MAAM,KAAK,MAAM,eAAe,KAAK,QAAQ;AAC5D,MAAI,OACF,MAAK,KAAK,mBAAmB,EAAE,KAAK,CAAC;AAEvC,SAAO;;;;;CAMT,MAAM,aACJ,KACA,OACsD;EACtD,MAAM,OAAO,MAAM,KAAK,MAAM,YAAY,IAAI;AAC9C,MAAI,CAAC,KACH,QAAO;GAAE,IAAI;GAAO,OAAO;GAAqB;EAElD,MAAM,UAAU,4BAA4B,MAAM,MAAM;AACxD,MAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,EAClC,QAAO,EAAE,IAAI,MAAM;AAErB,QAAM,KAAK,MAAM,eAAe,KAAK,QAAQ;AAC7C,OAAK,KAAK,kBAAkB,EAAE,KAAK,CAAC;AACpC,SAAO,EAAE,IAAI,MAAM;;CAGrB,MAAM,mBAAmB,KAA8C;AACrE,SAAO,KAAK,MAAM,YAAY,IAAI;;CAGpC,MAAM,cAAc,KAA+B;EACjD,MAAM,SAAS,MAAM,KAAK,MAAM,OAAO,IAAI;AAC3C,MAAI,OACF,MAAK,KAAK,kBAAkB,EAAE,KAAK,CAAC;AAEtC,SAAO;;CAGT,MAAM,eAAe,MAAkE;EACrF,MAAM,SAAS,MAAM,KAAK,MAAM,WAAW,KAAK;AAChD,OAAK,MAAM,OAAO,OAAO,QACvB,MAAK,KAAK,kBAAkB,EAAE,KAAK,CAAC;AAEtC,SAAO;;CAKT,MAAM,cAAc,KAAa,MAA6B;AAC5D,QAAM,KAAK,MAAM,eAAe,KAAK,EAAE,MAAM,CAAC;AAC9C,OAAK,KAAK,kBAAkB;GAAE;GAAK;GAAM,CAAC;;;CAI5C,MAAM,sBAAsB,KAAa,SAAkD;AACzF,QAAM,KAAK,MAAM,eAAe,KAAK,QAAQ;AAC7C,OAAK,KAAK,kBAAkB,EAAE,KAAK,CAAC;;CAGtC,MAAM,WAAW,KAAa,MAA+B;EAC3D,MAAM,WAAW,MAAM,KAAK,MAAM,YAAY,IAAI;AAClD,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,sBAAsB,MAAM;EAI9C,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,SAAS,MAAM,GAAG,KAAK,CAAC,CAAC;AAC5D,QAAM,KAAK,MAAM,eAAe,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAK,KAAK,kBAAkB;GAAE;GAAK,MAAM;GAAY,CAAC;;CAGxD,MAAM,aAAa,KAAa,MAA+B;EAC7D,MAAM,WAAW,MAAM,KAAK,MAAM,YAAY,IAAI;AAClD,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,sBAAsB,MAAM;EAG9C,MAAM,eAAe,SAAS,KAAK,QAAQ,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;AACnE,QAAM,KAAK,MAAM,eAAe,KAAK,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAK,KAAK,kBAAkB;GAAE;GAAK,MAAM;GAAc,CAAC;;CAG1D,MAAM,eAAe,KAAa,MAA+B;AAC/D,QAAM,KAAK,MAAM,eAAe,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;AAClE,OAAK,KAAK,kBAAkB;GAAE;GAAK;GAAM,CAAC;;CAK5C,MAAM,eAAe,KAA4B;AAC/C,QAAM,KAAK,MAAM,QAAQ,IAAI;AAC7B,OAAK,KAAK,mBAAmB,EAAE,KAAK,CAAC;;CAGvC,MAAM,iBAAiB,KAA4B;AACjD,QAAM,KAAK,MAAM,UAAU,IAAI;AAC/B,OAAK,KAAK,mBAAmB,EAAE,KAAK,CAAC;;CAGvC,MAAM,WAAW,KAA4B;AAC3C,QAAM,KAAK,MAAM,IAAI,IAAI;AACzB,OAAK,KAAK,iBAAiB,EAAE,KAAK,CAAC;;CAGrC,MAAM,aAAa,KAA4B;AAC7C,QAAM,KAAK,MAAM,MAAM,IAAI;AAC3B,OAAK,KAAK,mBAAmB,EAAE,KAAK,CAAC;;CAGvC,MAAM,iBAAiB,KAAa,QAAsC;AACxE,QAAM,KAAK,MAAM,UAAU,KAAK,OAAO;AACvC,OAAK,KAAK,wBAAwB;GAAE;GAAK;GAAQ,CAAC;;CAKpD,MAAM,eAAe,OAA2C;AAE9D,UAAO,MADc,KAAK,MAAM,KAAK;GAAE,QAAQ;GAAO,OAAO;GAAK,CAAC,EACrD;;CAGhB,MAAM,gBAAgB,KAAa,SAAqC;AACtE,SAAO,KAAK,MAAM,gBAAgB,KAAK,QAAQ;;CAKjD,MAAM,cAAc,KAAa,QAAuC;AACtE,SAAO,KAAK,MAAM,cAAc,KAAK,OAAO;;CAK9C,MAAM,WAAwC;AAC5C,SAAO,KAAK,MAAM,UAAU;;CAK9B,MAAM,mBAAmB,eAAwC;EAC/D,MAAM,QAAQ,MAAM,KAAK,MAAM,WAAW,cAAc;AACxD,MAAI,KAAK;GAAE;GAAO;GAAe,EAAE,wBAAwB;AAC3D,SAAO;;CAKT,iBAAiB,UAAqD;AACpE,OAAK,GAAG,kBAAkB,SAAS;;CAGrC,iBAAiB,UAAiF;AAChG,OAAK,GAAG,kBAAkB,SAAS;;CAGrC,iBAAiB,UAAiD;AAChE,OAAK,GAAG,kBAAkB,SAAS;;CAGrC,kBAAkB,UAAiD;AACjE,OAAK,GAAG,mBAAmB,SAAS;;CAGtC,kBAAkB,UAAiD;AACjE,OAAK,GAAG,mBAAmB,SAAS;;CAGtC,gBAAgB,UAAiD;AAC/D,OAAK,GAAG,iBAAiB,SAAS;;CAGpC,kBAAkB,UAAiD;AACjE,OAAK,GAAG,mBAAmB,SAAS;;CAGtC,uBAAuB,UAAwE;AAC7F,OAAK,GAAG,wBAAwB,SAAS;;CAG3C,kBAAkB,UAAiD;AACjE,OAAK,GAAG,mBAAmB,SAAS;;;CAMtC,MAAM,aAAa,KAAa;AAC9B,SAAO,KAAK,MAAM,aAAa,IAAI;;;CAIrC,MAAM,uBAAuB,KAAsD;AACjF,SAAO,KAAK,MAAM,uBAAuB,IAAI;;;;;;CAO/C,MAAM,aAAa,KAAa,UAAiB;AAC/C,SAAO,KAAK,MAAM,aAAa,KAAK,SAAS;;;;;CAM/C,MAAM,6BACJ,KACA,OACe;AACf,QAAM,KAAK,MAAM,6BAA6B,KAAK,MAAM;AACzD,OAAK,KAAK,kBAAkB,EAAE,KAAK,CAAC;;;CAItC,MAAM,OAAO,KAA4B;AACvC,QAAM,KAAK,MAAM,OAAO,IAAI;;;CAI9B,MAAM,aACJ,KACkE;EAClE,MAAM,SAAS,MAAM,KAAK,MAAM,MAAM,IAAI;AAC1C,MAAI,OACF,MAAK,KAAK,kBAAkB,EAAE,KAAK,CAAC;AAEtC,SAAO;;;CAIT,eAAe,UAAiB;AAC9B,SAAO,KAAK,MAAM,eAAe,SAAS;;;CAI5C,kBAAkB,KAAa,UAAiB,eAAuB;AACrE,SAAO,KAAK,MAAM,kBAAkB,KAAK,UAAU,cAAc;;;CAInE,QACE,KACA,UACA,eACA,cACA,OAC2B;AAC3B,SAAO,KAAK,MAAM,QAAQ,KAAK,UAAU,eAAe,cAAc,MAAM;;;CAI9E,MAAM,mBAAmB,KAAa;AACpC,SAAO,KAAK,MAAM,mBAAmB,IAAI;;;CAI3C,0BAA0B,KAAa;AACrC,SAAO,KAAK,MAAM,0BAA0B,IAAI;;CAGlD,8BAA8B,KAAa,cAAsB;AAC/D,SAAO,KAAK,MAAM,8BAA8B,KAAK,aAAa;;CAGpE,4BAA4B,KAAa,cAAsB;AAC7D,SAAO,KAAK,MAAM,4BAA4B,KAAK,aAAa;;;CAIlE,MAAM,mBAAmB,KAAa,UAAkC;AACtE,SAAO,KAAK,MAAM,eAAe,SAAS"}

package/dist/src/session/parity/transcript-paths.js

@@ -2,7 +2,7 @@ import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { formatSessionArchiveTimestamp, init_artifacts } from "./artifacts.js";
 import { init_session_id, validateSessionId } from "./session-id.js";
 import { dirname, relative, resolve } from "node:path";
-import fsSync from "node:fs";
+import fs from "node:fs";
 //#region src/session/parity/transcript-paths.ts
 function resolveSessionsDir(opts) {
 	const sessionsDir = opts?.sessionsDir?.trim();
@@ -50,7 +50,7 @@ function resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, _
 }
 function archiveFileOnDisk(filePath, reason) {
 	const archived = `${filePath}.${reason}.${formatSessionArchiveTimestamp()}`;
-	fsSync.renameSync(filePath, archived);
+	fs.renameSync(filePath, archived);
 	return archived;
 }
 var init_transcript_paths = __esmMin((() => {

package/dist/src/session/parity/transcript-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcript-paths.js","names":[],"sources":["../../../../src/session/parity/transcript-paths.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { dirname, relative, resolve } from 'node:path';\n\nimport { formatSessionArchiveTimestamp } from './artifacts.js';\nimport { validateSessionId } from './session-id.js';\n\nexport type SessionFilePathOptions = {\n  agentId?: string;\n  sessionsDir?: string;\n};\n\nfunction resolveSessionsDir(opts?: SessionFilePathOptions): string {\n  const sessionsDir = opts?.sessionsDir?.trim();\n  if (!sessionsDir) {\n    throw new Error('sessionsDir is required for session transcript path resolution');\n  }\n  return resolve(sessionsDir);\n}\n\nfunction resolvePathWithinSessionsDir(sessionsDir: string, candidate: string): string {\n  const trimmed = candidate.trim();\n  if (!trimmed) {\n    throw new Error('Session file path must not be empty');\n  }\n  const resolvedBase = resolve(sessionsDir);\n  const normalized = resolve(resolvedBase, trimmed);\n  const rel = relative(resolvedBase, normalized);\n  if (rel.startsWith('..') || rel === '') {\n    throw new Error('Session file path must be within sessions directory');\n  }\n  return normalized;\n}\n\nexport function resolveSessionTranscriptPathInDir(\n  sessionId: string,\n  sessionsDir: string,\n  topicId?: string | number,\n): string {\n  const safeSessionId = validateSessionId(sessionId);\n  const safeTopicId =\n    typeof topicId === 'string'\n      ? encodeURIComponent(topicId)\n      : typeof topicId === 'number'\n        ? String(topicId)\n        : undefined;\n  const fileName =\n    safeTopicId !== undefined\n      ? `${safeSessionId}-topic-${safeTopicId}.jsonl`\n      : `${safeSessionId}.jsonl`;\n  return resolvePathWithinSessionsDir(sessionsDir, fileName);\n}\n\nexport function resolveSessionFilePath(\n  sessionId: string,\n  entry?: { sessionFile?: string },\n  opts?: SessionFilePathOptions,\n): string {\n  const sessionsDir = resolveSessionsDir(opts);\n  const candidate = entry?.sessionFile?.trim();\n  if (candidate) {\n    try {\n      return resolvePathWithinSessionsDir(sessionsDir, candidate);\n    } catch {\n      /* fall through */\n    }\n  }\n  return resolveSessionTranscriptPathInDir(sessionId, sessionsDir);\n}\n\n/**\n * Candidate transcript paths for a session (xopc state only — no external legacy dirs).\n */\nexport function resolveSessionTranscriptCandidates(\n  sessionId: string,\n  storePath: string | undefined,\n  sessionFile?: string,\n  _agentId?: string,\n): string[] {\n  const candidates: string[] = [];\n  const push = (p: string): void => {\n    if (!candidates.includes(p)) {\n      candidates.push(p);\n    }\n  };\n\n  if (storePath) {\n    const sessionsDir = dirname(storePath);\n    if (sessionFile?.trim()) {\n      try {\n        push(resolveSessionFilePath(sessionId, { sessionFile }, { sessionsDir }));\n      } catch {\n        /* ignore */\n      }\n    }\n    push(resolveSessionTranscriptPathInDir(sessionId, sessionsDir));\n  } else if (sessionFile?.trim()) {\n    push(resolve(sessionFile.trim()));\n  }\n\n  return candidates;\n}\n\nexport function archiveFileOnDisk(filePath: string, reason: 'reset' | 'deleted' | 'bak'): string {\n  const ts = formatSessionArchiveTimestamp();\n  const archived = `${filePath}.${reason}.${ts}`;\n  fs.renameSync(filePath, archived);\n  return archived;\n}\n"],"mappings":";;;;;;AAWA,SAAS,mBAAmB,MAAuC;CACjE,MAAM,cAAc,MAAM,aAAa,MAAM;AAC7C,KAAI,CAAC,YACH,OAAM,IAAI,MAAM,iEAAiE;AAEnF,QAAO,QAAQ,YAAY;;AAG7B,SAAS,6BAA6B,aAAqB,WAA2B;CACpF,MAAM,UAAU,UAAU,MAAM;AAChC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sCAAsC;CAExD,MAAM,eAAe,QAAQ,YAAY;CACzC,MAAM,aAAa,QAAQ,cAAc,QAAQ;CACjD,MAAM,MAAM,SAAS,cAAc,WAAW;AAC9C,KAAI,IAAI,WAAW,KAAK,IAAI,QAAQ,GAClC,OAAM,IAAI,MAAM,sDAAsD;AAExE,QAAO;;AAGT,SAAgB,kCACd,WACA,aACA,SACQ;CACR,MAAM,gBAAgB,kBAAkB,UAAU;CAClD,MAAM,cACJ,OAAO,YAAY,WACf,mBAAmB,QAAQ,GAC3B,OAAO,YAAY,WACjB,OAAO,QAAQ,GACf,KAAA;AAKR,QAAO,6BAA6B,aAHlC,gBAAgB,KAAA,IACZ,GAAG,cAAc,SAAS,YAAY,UACtC,GAAG,cAAc,QACmC;;AAG5D,SAAgB,uBACd,WACA,OACA,MACQ;CACR,MAAM,cAAc,mBAAmB,KAAK;CAC5C,MAAM,YAAY,OAAO,aAAa,MAAM;AAC5C,KAAI,UACF,KAAI;AACF,SAAO,6BAA6B,aAAa,UAAU;SACrD;AAIV,QAAO,kCAAkC,WAAW,YAAY;;;;;AAMlE,SAAgB,mCACd,WACA,WACA,aACA,UACU;CACV,MAAM,aAAuB,EAAE;CAC/B,MAAM,QAAQ,MAAoB;AAChC,MAAI,CAAC,WAAW,SAAS,EAAE,CACzB,YAAW,KAAK,EAAE;;AAItB,KAAI,WAAW;EACb,MAAM,cAAc,QAAQ,UAAU;AACtC,MAAI,aAAa,MAAM,CACrB,KAAI;AACF,QAAK,uBAAuB,WAAW,EAAE,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;UACnE;AAIV,OAAK,kCAAkC,WAAW,YAAY,CAAC;YACtD,aAAa,MAAM,CAC5B,MAAK,QAAQ,YAAY,MAAM,CAAC,CAAC;AAGnC,QAAO;;AAGT,SAAgB,kBAAkB,UAAkB,QAA6C;CAE/F,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAD5B,+BACiC;AAC5C,QAAG,WAAW,UAAU,SAAS;AACjC,QAAO;;;iBAvGsD;kBACX"}
+{"version":3,"file":"transcript-paths.js","names":[],"sources":["../../../../src/session/parity/transcript-paths.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { dirname, relative, resolve } from 'node:path';\n\nimport { formatSessionArchiveTimestamp } from './artifacts.js';\nimport { validateSessionId } from './session-id.js';\n\nexport type SessionFilePathOptions = {\n  agentId?: string;\n  sessionsDir?: string;\n};\n\nfunction resolveSessionsDir(opts?: SessionFilePathOptions): string {\n  const sessionsDir = opts?.sessionsDir?.trim();\n  if (!sessionsDir) {\n    throw new Error('sessionsDir is required for session transcript path resolution');\n  }\n  return resolve(sessionsDir);\n}\n\nfunction resolvePathWithinSessionsDir(sessionsDir: string, candidate: string): string {\n  const trimmed = candidate.trim();\n  if (!trimmed) {\n    throw new Error('Session file path must not be empty');\n  }\n  const resolvedBase = resolve(sessionsDir);\n  const normalized = resolve(resolvedBase, trimmed);\n  const rel = relative(resolvedBase, normalized);\n  if (rel.startsWith('..') || rel === '') {\n    throw new Error('Session file path must be within sessions directory');\n  }\n  return normalized;\n}\n\nexport function resolveSessionTranscriptPathInDir(\n  sessionId: string,\n  sessionsDir: string,\n  topicId?: string | number,\n): string {\n  const safeSessionId = validateSessionId(sessionId);\n  const safeTopicId =\n    typeof topicId === 'string'\n      ? encodeURIComponent(topicId)\n      : typeof topicId === 'number'\n        ? String(topicId)\n        : undefined;\n  const fileName =\n    safeTopicId !== undefined\n      ? `${safeSessionId}-topic-${safeTopicId}.jsonl`\n      : `${safeSessionId}.jsonl`;\n  return resolvePathWithinSessionsDir(sessionsDir, fileName);\n}\n\nexport function resolveSessionFilePath(\n  sessionId: string,\n  entry?: { sessionFile?: string },\n  opts?: SessionFilePathOptions,\n): string {\n  const sessionsDir = resolveSessionsDir(opts);\n  const candidate = entry?.sessionFile?.trim();\n  if (candidate) {\n    try {\n      return resolvePathWithinSessionsDir(sessionsDir, candidate);\n    } catch {\n      /* fall through */\n    }\n  }\n  return resolveSessionTranscriptPathInDir(sessionId, sessionsDir);\n}\n\n/**\n * Candidate transcript paths for a session (xopc state only — no external legacy dirs).\n */\nexport function resolveSessionTranscriptCandidates(\n  sessionId: string,\n  storePath: string | undefined,\n  sessionFile?: string,\n  _agentId?: string,\n): string[] {\n  const candidates: string[] = [];\n  const push = (p: string): void => {\n    if (!candidates.includes(p)) {\n      candidates.push(p);\n    }\n  };\n\n  if (storePath) {\n    const sessionsDir = dirname(storePath);\n    if (sessionFile?.trim()) {\n      try {\n        push(resolveSessionFilePath(sessionId, { sessionFile }, { sessionsDir }));\n      } catch {\n        /* ignore */\n      }\n    }\n    push(resolveSessionTranscriptPathInDir(sessionId, sessionsDir));\n  } else if (sessionFile?.trim()) {\n    push(resolve(sessionFile.trim()));\n  }\n\n  return candidates;\n}\n\nexport function archiveFileOnDisk(filePath: string, reason: 'reset' | 'deleted' | 'bak'): string {\n  const ts = formatSessionArchiveTimestamp();\n  const archived = `${filePath}.${reason}.${ts}`;\n  fs.renameSync(filePath, archived);\n  return archived;\n}\n"],"mappings":";;;;;;AAWA,SAAS,mBAAmB,MAAuC;CACjE,MAAM,cAAc,MAAM,aAAa,MAAM;AAC7C,KAAI,CAAC,YACH,OAAM,IAAI,MAAM,iEAAiE;AAEnF,QAAO,QAAQ,YAAY;;AAG7B,SAAS,6BAA6B,aAAqB,WAA2B;CACpF,MAAM,UAAU,UAAU,MAAM;AAChC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sCAAsC;CAExD,MAAM,eAAe,QAAQ,YAAY;CACzC,MAAM,aAAa,QAAQ,cAAc,QAAQ;CACjD,MAAM,MAAM,SAAS,cAAc,WAAW;AAC9C,KAAI,IAAI,WAAW,KAAK,IAAI,QAAQ,GAClC,OAAM,IAAI,MAAM,sDAAsD;AAExE,QAAO;;AAGT,SAAgB,kCACd,WACA,aACA,SACQ;CACR,MAAM,gBAAgB,kBAAkB,UAAU;CAClD,MAAM,cACJ,OAAO,YAAY,WACf,mBAAmB,QAAQ,GAC3B,OAAO,YAAY,WACjB,OAAO,QAAQ,GACf,KAAA;AAKR,QAAO,6BAA6B,aAHlC,gBAAgB,KAAA,IACZ,GAAG,cAAc,SAAS,YAAY,UACtC,GAAG,cAAc,QACmC;;AAG5D,SAAgB,uBACd,WACA,OACA,MACQ;CACR,MAAM,cAAc,mBAAmB,KAAK;CAC5C,MAAM,YAAY,OAAO,aAAa,MAAM;AAC5C,KAAI,UACF,KAAI;AACF,SAAO,6BAA6B,aAAa,UAAU;SACrD;AAIV,QAAO,kCAAkC,WAAW,YAAY;;;;;AAMlE,SAAgB,mCACd,WACA,WACA,aACA,UACU;CACV,MAAM,aAAuB,EAAE;CAC/B,MAAM,QAAQ,MAAoB;AAChC,MAAI,CAAC,WAAW,SAAS,EAAE,CACzB,YAAW,KAAK,EAAE;;AAItB,KAAI,WAAW;EACb,MAAM,cAAc,QAAQ,UAAU;AACtC,MAAI,aAAa,MAAM,CACrB,KAAI;AACF,QAAK,uBAAuB,WAAW,EAAE,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;UACnE;AAIV,OAAK,kCAAkC,WAAW,YAAY,CAAC;YACtD,aAAa,MAAM,CAC5B,MAAK,QAAQ,YAAY,MAAM,CAAC,CAAC;AAGnC,QAAO;;AAGT,SAAgB,kBAAkB,UAAkB,QAA6C;CAE/F,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAD5B,+BACiC;AAC5C,IAAG,WAAW,UAAU,SAAS;AACjC,QAAO;;;iBAvGsD;kBACX"}

package/dist/src/session/parity/xopc-session-disk-entry.d.ts

@@ -6,6 +6,12 @@ export interface XopcSessionDiskEntry extends Record<string, unknown> {
     sessionId: string;
     updatedAt: number;
     sessionStartedAt?: number;
+    /** Last user/channel interaction (ms) — extends idle reset lifetime. */
+    lastInteractionAt?: number;
+    /** Persisted thinking level (OpenClaw SessionEntry parity). */
+    thinkingLevel?: string;
+    /** Persisted verbose level (OpenClaw SessionEntry parity). */
+    verboseLevel?: string;
     sessionFile?: string;
     pluginExtensions?: {
         xopc?: {

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

@@ -0,0 +1,32 @@
+import type { Config } from '../config/schema.js';
+export type SessionResetMode = 'daily' | 'idle';
+export type SessionResetType = 'direct' | 'group' | 'thread';
+export type SessionResetConfig = NonNullable<Config['session']>['reset'];
+export type SessionResetPolicy = {
+    mode: SessionResetMode;
+    atHour: number;
+    idleMinutes?: number;
+    configured?: boolean;
+};
+export type SessionFreshness = {
+    fresh: boolean;
+    dailyResetAt?: number;
+    idleExpiresAt?: number;
+};
+export declare const DEFAULT_RESET_MODE: SessionResetMode;
+export declare const DEFAULT_RESET_AT_HOUR = 4;
+/** Default idle window when mode is `idle` and no explicit minutes are set. */
+export declare const DEFAULT_IDLE_MINUTES = 0;
+export declare function resolveDailyResetAtMs(now: number, atHour: number): number;
+export declare function resolveSessionResetPolicy(params: {
+    sessionCfg?: Config['session'];
+    resetType: SessionResetType;
+    resetOverride?: SessionResetConfig;
+}): SessionResetPolicy;
+export declare function evaluateSessionFreshness(params: {
+    updatedAt: number;
+    sessionStartedAt?: number;
+    lastInteractionAt?: number;
+    now: number;
+    policy: SessionResetPolicy;
+}): SessionFreshness;

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

@@ -0,0 +1,65 @@
+//#region src/session/reset-policy.ts
+const DEFAULT_RESET_MODE = "daily";
+const DEFAULT_RESET_AT_HOUR = 4;
+/** Default idle window when mode is `idle` and no explicit minutes are set. */
+const DEFAULT_IDLE_MINUTES = 0;
+function resolveDailyResetAtMs(now, atHour) {
+	const normalizedAtHour = normalizeResetAtHour(atHour);
+	const resetAt = new Date(now);
+	resetAt.setHours(normalizedAtHour, 0, 0, 0);
+	if (now < resetAt.getTime()) resetAt.setDate(resetAt.getDate() - 1);
+	return resetAt.getTime();
+}
+function resolveSessionResetPolicy(params) {
+	const sessionCfg = params.sessionCfg;
+	const baseReset = params.resetOverride ?? sessionCfg?.reset;
+	const typeReset = params.resetOverride ? void 0 : sessionCfg?.resetByType?.[params.resetType];
+	const hasExplicitReset = Boolean(baseReset || sessionCfg?.resetByType);
+	const legacyIdleMinutes = params.resetOverride ? void 0 : sessionCfg?.idleMinutes;
+	const configured = Boolean(baseReset || typeReset || legacyIdleMinutes != null);
+	const mode = typeReset?.mode ?? baseReset?.mode ?? (!hasExplicitReset && legacyIdleMinutes != null ? "idle" : "daily");
+	const atHour = normalizeResetAtHour(typeReset?.atHour ?? baseReset?.atHour ?? 4);
+	const idleMinutesRaw = typeReset?.idleMinutes ?? baseReset?.idleMinutes ?? legacyIdleMinutes;
+	let idleMinutes;
+	if (idleMinutesRaw != null) {
+		const normalized = Math.floor(idleMinutesRaw);
+		if (Number.isFinite(normalized)) idleMinutes = Math.max(normalized, 0);
+	} else if (mode === "idle") idleMinutes = 0;
+	return {
+		mode,
+		atHour,
+		idleMinutes,
+		configured
+	};
+}
+function evaluateSessionFreshness(params) {
+	const updatedAt = resolveTimestamp(params.updatedAt, params.now) ?? 0;
+	const sessionStartedAt = resolveTimestamp(params.sessionStartedAt, params.now) ?? updatedAt;
+	const lastInteractionAt = resolveTimestamp(params.lastInteractionAt, params.now) ?? sessionStartedAt;
+	const dailyResetAt = params.policy.mode === "daily" ? resolveDailyResetAtMs(params.now, params.policy.atHour) : void 0;
+	const idleExpiresAt = params.policy.idleMinutes != null && params.policy.idleMinutes > 0 ? lastInteractionAt + params.policy.idleMinutes * 6e4 : void 0;
+	const staleDaily = dailyResetAt != null && sessionStartedAt < dailyResetAt;
+	const staleIdle = idleExpiresAt != null && params.now > idleExpiresAt;
+	return {
+		fresh: !(staleDaily || staleIdle),
+		dailyResetAt,
+		idleExpiresAt
+	};
+}
+function resolveTimestamp(value, now) {
+	if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return;
+	if (typeof now === "number" && Number.isFinite(now) && value > now) return;
+	return value;
+}
+function normalizeResetAtHour(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return 4;
+	const normalized = Math.floor(value);
+	if (!Number.isFinite(normalized)) return 4;
+	if (normalized < 0) return 0;
+	if (normalized > 23) return 23;
+	return normalized;
+}
+//#endregion
+export { DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, evaluateSessionFreshness, resolveDailyResetAtMs, resolveSessionResetPolicy };
+
+//# sourceMappingURL=reset-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reset-policy.js","names":[],"sources":["../../../src/session/reset-policy.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\n\nexport type SessionResetMode = 'daily' | 'idle';\nexport type SessionResetType = 'direct' | 'group' | 'thread';\n\nexport type SessionResetConfig = NonNullable<Config['session']>['reset'];\nexport type SessionResetPolicy = {\n  mode: SessionResetMode;\n  atHour: number;\n  idleMinutes?: number;\n  configured?: boolean;\n};\n\nexport type SessionFreshness = {\n  fresh: boolean;\n  dailyResetAt?: number;\n  idleExpiresAt?: number;\n};\n\nexport const DEFAULT_RESET_MODE: SessionResetMode = 'daily';\nexport const DEFAULT_RESET_AT_HOUR = 4;\n/** Default idle window when mode is `idle` and no explicit minutes are set. */\nexport const DEFAULT_IDLE_MINUTES = 0;\n\nexport function resolveDailyResetAtMs(now: number, atHour: number): number {\n  const normalizedAtHour = normalizeResetAtHour(atHour);\n  const resetAt = new Date(now);\n  resetAt.setHours(normalizedAtHour, 0, 0, 0);\n  if (now < resetAt.getTime()) {\n    resetAt.setDate(resetAt.getDate() - 1);\n  }\n  return resetAt.getTime();\n}\n\nexport function resolveSessionResetPolicy(params: {\n  sessionCfg?: Config['session'];\n  resetType: SessionResetType;\n  resetOverride?: SessionResetConfig;\n}): SessionResetPolicy {\n  const sessionCfg = params.sessionCfg;\n  const baseReset = params.resetOverride ?? sessionCfg?.reset;\n  const typeReset = params.resetOverride ? undefined : sessionCfg?.resetByType?.[params.resetType];\n  const hasExplicitReset = Boolean(baseReset || sessionCfg?.resetByType);\n  const legacyIdleMinutes = params.resetOverride ? undefined : sessionCfg?.idleMinutes;\n  const configured = Boolean(baseReset || typeReset || legacyIdleMinutes != null);\n  const mode =\n    typeReset?.mode ??\n    baseReset?.mode ??\n    (!hasExplicitReset && legacyIdleMinutes != null ? 'idle' : DEFAULT_RESET_MODE);\n  const atHour = normalizeResetAtHour(typeReset?.atHour ?? baseReset?.atHour ?? DEFAULT_RESET_AT_HOUR);\n  const idleMinutesRaw = typeReset?.idleMinutes ?? baseReset?.idleMinutes ?? legacyIdleMinutes;\n\n  let idleMinutes: number | undefined;\n  if (idleMinutesRaw != null) {\n    const normalized = Math.floor(idleMinutesRaw);\n    if (Number.isFinite(normalized)) {\n      idleMinutes = Math.max(normalized, 0);\n    }\n  } else if (mode === 'idle') {\n    idleMinutes = DEFAULT_IDLE_MINUTES;\n  }\n\n  return { mode, atHour, idleMinutes, configured };\n}\n\nexport function evaluateSessionFreshness(params: {\n  updatedAt: number;\n  sessionStartedAt?: number;\n  lastInteractionAt?: number;\n  now: number;\n  policy: SessionResetPolicy;\n}): SessionFreshness {\n  const updatedAt = resolveTimestamp(params.updatedAt, params.now) ?? 0;\n  const sessionStartedAt = resolveTimestamp(params.sessionStartedAt, params.now) ?? updatedAt;\n  const lastInteractionAt =\n    resolveTimestamp(params.lastInteractionAt, params.now) ?? sessionStartedAt;\n  const dailyResetAt =\n    params.policy.mode === 'daily'\n      ? resolveDailyResetAtMs(params.now, params.policy.atHour)\n      : undefined;\n  const idleExpiresAt =\n    params.policy.idleMinutes != null && params.policy.idleMinutes > 0\n      ? lastInteractionAt + params.policy.idleMinutes * 60_000\n      : undefined;\n  const staleDaily = dailyResetAt != null && sessionStartedAt < dailyResetAt;\n  const staleIdle = idleExpiresAt != null && params.now > idleExpiresAt;\n  return {\n    fresh: !(staleDaily || staleIdle),\n    dailyResetAt,\n    idleExpiresAt,\n  };\n}\n\nfunction resolveTimestamp(value: number | undefined, now?: number): number | undefined {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {\n    return undefined;\n  }\n  if (typeof now === 'number' && Number.isFinite(now) && value > now) {\n    return undefined;\n  }\n  return value;\n}\n\nfunction normalizeResetAtHour(value: number | undefined): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    return DEFAULT_RESET_AT_HOUR;\n  }\n  const normalized = Math.floor(value);\n  if (!Number.isFinite(normalized)) {\n    return DEFAULT_RESET_AT_HOUR;\n  }\n  if (normalized < 0) {\n    return 0;\n  }\n  if (normalized > 23) {\n    return 23;\n  }\n  return normalized;\n}\n"],"mappings":";AAmBA,MAAa,qBAAuC;AACpD,MAAa,wBAAwB;;AAErC,MAAa,uBAAuB;AAEpC,SAAgB,sBAAsB,KAAa,QAAwB;CACzE,MAAM,mBAAmB,qBAAqB,OAAO;CACrD,MAAM,UAAU,IAAI,KAAK,IAAI;AAC7B,SAAQ,SAAS,kBAAkB,GAAG,GAAG,EAAE;AAC3C,KAAI,MAAM,QAAQ,SAAS,CACzB,SAAQ,QAAQ,QAAQ,SAAS,GAAG,EAAE;AAExC,QAAO,QAAQ,SAAS;;AAG1B,SAAgB,0BAA0B,QAInB;CACrB,MAAM,aAAa,OAAO;CAC1B,MAAM,YAAY,OAAO,iBAAiB,YAAY;CACtD,MAAM,YAAY,OAAO,gBAAgB,KAAA,IAAY,YAAY,cAAc,OAAO;CACtF,MAAM,mBAAmB,QAAQ,aAAa,YAAY,YAAY;CACtE,MAAM,oBAAoB,OAAO,gBAAgB,KAAA,IAAY,YAAY;CACzE,MAAM,aAAa,QAAQ,aAAa,aAAa,qBAAqB,KAAK;CAC/E,MAAM,OACJ,WAAW,QACX,WAAW,SACV,CAAC,oBAAoB,qBAAqB,OAAO,SAAA;CACpD,MAAM,SAAS,qBAAqB,WAAW,UAAU,WAAW,UAAA,EAAgC;CACpG,MAAM,iBAAiB,WAAW,eAAe,WAAW,eAAe;CAE3E,IAAI;AACJ,KAAI,kBAAkB,MAAM;EAC1B,MAAM,aAAa,KAAK,MAAM,eAAe;AAC7C,MAAI,OAAO,SAAS,WAAW,CAC7B,eAAc,KAAK,IAAI,YAAY,EAAE;YAE9B,SAAS,OAClB,eAAA;AAGF,QAAO;EAAE;EAAM;EAAQ;EAAa;EAAY;;AAGlD,SAAgB,yBAAyB,QAMpB;CACnB,MAAM,YAAY,iBAAiB,OAAO,WAAW,OAAO,IAAI,IAAI;CACpE,MAAM,mBAAmB,iBAAiB,OAAO,kBAAkB,OAAO,IAAI,IAAI;CAClF,MAAM,oBACJ,iBAAiB,OAAO,mBAAmB,OAAO,IAAI,IAAI;CAC5D,MAAM,eACJ,OAAO,OAAO,SAAS,UACnB,sBAAsB,OAAO,KAAK,OAAO,OAAO,OAAO,GACvD,KAAA;CACN,MAAM,gBACJ,OAAO,OAAO,eAAe,QAAQ,OAAO,OAAO,cAAc,IAC7D,oBAAoB,OAAO,OAAO,cAAc,MAChD,KAAA;CACN,MAAM,aAAa,gBAAgB,QAAQ,mBAAmB;CAC9D,MAAM,YAAY,iBAAiB,QAAQ,OAAO,MAAM;AACxD,QAAO;EACL,OAAO,EAAE,cAAc;EACvB;EACA;EACD;;AAGH,SAAS,iBAAiB,OAA2B,KAAkC;AACrF,KAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,EAClE;AAEF,KAAI,OAAO,QAAQ,YAAY,OAAO,SAAS,IAAI,IAAI,QAAQ,IAC7D;AAEF,QAAO;;AAGT,SAAS,qBAAqB,OAAmC;AAC/D,KAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,MAAM,CACtD,QAAA;CAEF,MAAM,aAAa,KAAK,MAAM,MAAM;AACpC,KAAI,CAAC,OAAO,SAAS,WAAW,CAC9B,QAAA;AAEF,KAAI,aAAa,EACf,QAAO;AAET,KAAI,aAAa,GACf,QAAO;AAET,QAAO"}

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

@@ -0,0 +1,20 @@
+/** Default reset triggers (OpenClaw-aligned). */
+export declare const DEFAULT_RESET_TRIGGERS: readonly ["/new", "/reset"];
+export type ResetTriggerMatch = {
+    resetTriggered: boolean;
+    bodyStripped: string;
+    matchedTrigger?: string;
+    bareReset: boolean;
+};
+/** Strip gateway/channel envelope prefix e.g. `[Jun 4 17:35] `. */
+export declare function stripLeadingEnvelopeTimestamp(body: string): string;
+/**
+ * Match configured reset triggers against inbound body (case-insensitive trigger,
+ * preserve tail casing). Mirrors OpenClaw `initSessionState` reset-trigger loop.
+ */
+export declare function matchResetTriggers(body: string, triggers: readonly string[]): ResetTriggerMatch;
+export declare function resolveResetTriggers(configured?: string[]): readonly string[];
+export declare function bareResetAckMessage(matchedTrigger?: string): string;
+/** Slash command names that overlap reset triggers — skip when init already reset. */
+export declare const RESET_OVERLAP_COMMANDS: Set<string>;
+export declare function shouldSkipResetOverlapCommand(command: string | undefined, resetTriggered: boolean): boolean;

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

@@ -0,0 +1,63 @@
+//#region src/session/reset-triggers.ts
+/** Default reset triggers (OpenClaw-aligned). */
+const DEFAULT_RESET_TRIGGERS = ["/new", "/reset"];
+/** Strip gateway/channel envelope prefix e.g. `[Jun 4 17:35] `. */
+function stripLeadingEnvelopeTimestamp(body) {
+	return body.replace(/^\[[^\]]+\]\s*/, "");
+}
+/**
+* Match configured reset triggers against inbound body (case-insensitive trigger,
+* preserve tail casing). Mirrors OpenClaw `initSessionState` reset-trigger loop.
+*/
+function matchResetTriggers(body, triggers) {
+	const normalized = stripLeadingEnvelopeTimestamp(body.trim());
+	const lower = normalized.toLowerCase();
+	for (const trigger of triggers) {
+		const trimmedTrigger = trigger.trim();
+		if (!trimmedTrigger) continue;
+		const triggerLower = trimmedTrigger.toLowerCase();
+		if (lower === triggerLower) return {
+			resetTriggered: true,
+			bodyStripped: "",
+			matchedTrigger: trimmedTrigger,
+			bareReset: true
+		};
+		const prefix = `${triggerLower} `;
+		if (lower.startsWith(prefix)) {
+			const rest = normalized.slice(trimmedTrigger.length).trimStart();
+			return {
+				resetTriggered: true,
+				bodyStripped: rest,
+				matchedTrigger: trimmedTrigger,
+				bareReset: rest.length === 0
+			};
+		}
+	}
+	return {
+		resetTriggered: false,
+		bodyStripped: body,
+		bareReset: false
+	};
+}
+function resolveResetTriggers(configured) {
+	if (configured?.length) return configured;
+	return DEFAULT_RESET_TRIGGERS;
+}
+function bareResetAckMessage(matchedTrigger) {
+	if ((matchedTrigger ?? "").toLowerCase().includes("reset")) return "✅ Session reset.";
+	return "✅ New session started.";
+}
+/** Slash command names that overlap reset triggers — skip when init already reset. */
+const RESET_OVERLAP_COMMANDS = new Set([
+	"new",
+	"reset",
+	"restart"
+]);
+function shouldSkipResetOverlapCommand(command, resetTriggered) {
+	if (!resetTriggered || !command) return false;
+	return RESET_OVERLAP_COMMANDS.has(command.toLowerCase());
+}
+//#endregion
+export { DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, bareResetAckMessage, matchResetTriggers, resolveResetTriggers, shouldSkipResetOverlapCommand, stripLeadingEnvelopeTimestamp };
+
+//# sourceMappingURL=reset-triggers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reset-triggers.js","names":[],"sources":["../../../src/session/reset-triggers.ts"],"sourcesContent":["/** Default reset triggers (OpenClaw-aligned). */\nexport const DEFAULT_RESET_TRIGGERS = ['/new', '/reset'] as const;\n\nexport type ResetTriggerMatch = {\n  resetTriggered: boolean;\n  bodyStripped: string;\n  matchedTrigger?: string;\n  bareReset: boolean;\n};\n\n/** Strip gateway/channel envelope prefix e.g. `[Jun 4 17:35] `. */\nexport function stripLeadingEnvelopeTimestamp(body: string): string {\n  return body.replace(/^\\[[^\\]]+\\]\\s*/, '');\n}\n\n/**\n * Match configured reset triggers against inbound body (case-insensitive trigger,\n * preserve tail casing). Mirrors OpenClaw `initSessionState` reset-trigger loop.\n */\nexport function matchResetTriggers(body: string, triggers: readonly string[]): ResetTriggerMatch {\n  const normalized = stripLeadingEnvelopeTimestamp(body.trim());\n  const lower = normalized.toLowerCase();\n\n  for (const trigger of triggers) {\n    const trimmedTrigger = trigger.trim();\n    if (!trimmedTrigger) {\n      continue;\n    }\n    const triggerLower = trimmedTrigger.toLowerCase();\n\n    if (lower === triggerLower) {\n      return {\n        resetTriggered: true,\n        bodyStripped: '',\n        matchedTrigger: trimmedTrigger,\n        bareReset: true,\n      };\n    }\n\n    const prefix = `${triggerLower} `;\n    if (lower.startsWith(prefix)) {\n      const rest = normalized.slice(trimmedTrigger.length).trimStart();\n      return {\n        resetTriggered: true,\n        bodyStripped: rest,\n        matchedTrigger: trimmedTrigger,\n        bareReset: rest.length === 0,\n      };\n    }\n  }\n\n  return {\n    resetTriggered: false,\n    bodyStripped: body,\n    bareReset: false,\n  };\n}\n\nexport function resolveResetTriggers(\n  configured?: string[],\n): readonly string[] {\n  if (configured?.length) {\n    return configured;\n  }\n  return DEFAULT_RESET_TRIGGERS;\n}\n\nexport function bareResetAckMessage(matchedTrigger?: string): string {\n  const lower = (matchedTrigger ?? '').toLowerCase();\n  if (lower.includes('reset')) {\n    return '✅ Session reset.';\n  }\n  return '✅ New session started.';\n}\n\n/** Slash command names that overlap reset triggers — skip when init already reset. */\nexport const RESET_OVERLAP_COMMANDS = new Set(['new', 'reset', 'restart']);\n\nexport function shouldSkipResetOverlapCommand(\n  command: string | undefined,\n  resetTriggered: boolean,\n): boolean {\n  if (!resetTriggered || !command) {\n    return false;\n  }\n  return RESET_OVERLAP_COMMANDS.has(command.toLowerCase());\n}\n"],"mappings":";;AACA,MAAa,yBAAyB,CAAC,QAAQ,SAAS;;AAUxD,SAAgB,8BAA8B,MAAsB;AAClE,QAAO,KAAK,QAAQ,kBAAkB,GAAG;;;;;;AAO3C,SAAgB,mBAAmB,MAAc,UAAgD;CAC/F,MAAM,aAAa,8BAA8B,KAAK,MAAM,CAAC;CAC7D,MAAM,QAAQ,WAAW,aAAa;AAEtC,MAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,iBAAiB,QAAQ,MAAM;AACrC,MAAI,CAAC,eACH;EAEF,MAAM,eAAe,eAAe,aAAa;AAEjD,MAAI,UAAU,aACZ,QAAO;GACL,gBAAgB;GAChB,cAAc;GACd,gBAAgB;GAChB,WAAW;GACZ;EAGH,MAAM,SAAS,GAAG,aAAa;AAC/B,MAAI,MAAM,WAAW,OAAO,EAAE;GAC5B,MAAM,OAAO,WAAW,MAAM,eAAe,OAAO,CAAC,WAAW;AAChE,UAAO;IACL,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,WAAW,KAAK,WAAW;IAC5B;;;AAIL,QAAO;EACL,gBAAgB;EAChB,cAAc;EACd,WAAW;EACZ;;AAGH,SAAgB,qBACd,YACmB;AACnB,KAAI,YAAY,OACd,QAAO;AAET,QAAO;;AAGT,SAAgB,oBAAoB,gBAAiC;AAEnE,MADe,kBAAkB,IAAI,aAC5B,CAAC,SAAS,QAAQ,CACzB,QAAO;AAET,QAAO;;;AAIT,MAAa,yBAAyB,IAAI,IAAI;CAAC;CAAO;CAAS;CAAU,CAAC;AAE1E,SAAgB,8BACd,SACA,gBACS;AACT,KAAI,CAAC,kBAAkB,CAAC,QACtB,QAAO;AAET,QAAO,uBAAuB,IAAI,QAAQ,aAAa,CAAC"}

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

@@ -0,0 +1,12 @@
+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;
+export declare function resolveChannelResetConfig(params: {
+    sessionCfg?: Config['session'];
+    channel?: string | null;
+}): SessionResetConfig | undefined;

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

@@ -0,0 +1,25 @@
+import { init_string_coerce, normalizeLowercaseStringOrEmpty, 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.isGroup) return "group";
+	const normalized = normalizeLowercaseStringOrEmpty(params.sessionKey);
+	if (GROUP_SESSION_MARKERS.some((marker) => normalized.includes(marker))) return "group";
+	return "direct";
+}
+function resolveChannelResetConfig(params) {
+	const resetByChannel = params.sessionCfg?.resetByChannel;
+	if (!resetByChannel) return;
+	const key = normalizeOptionalLowercaseString(params.channel);
+	if (!key) return;
+	return resetByChannel[key];
+}
+//#endregion
+export { isThreadSessionKey, resolveChannelResetConfig, resolveSessionResetType };
+
+//# sourceMappingURL=reset-type.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,30 @@
+import { type Config } from '../config/schema.js';
+import { type ThinkLevel, type VerboseLevel } from '../agent/transcript/thinking-types.js';
+import type { XopcSessionDiskEntry } from './parity/xopc-session-disk-entry.js';
+export type SessionResolution = {
+    sessionId: string;
+    sessionKey?: string;
+    sessionEntry?: XopcSessionDiskEntry;
+    sessionStore: Record<string, XopcSessionDiskEntry>;
+    storePath: string;
+    isNewSession: boolean;
+    persistedThinking?: ThinkLevel;
+    persistedVerbose?: VerboseLevel;
+};
+export type SessionKeyResolution = {
+    sessionKey?: string;
+    sessionStore: Record<string, XopcSessionDiskEntry>;
+    storePath: string;
+};
+export declare function resolveSessionKeyForRequest(opts: {
+    cfg: Config;
+    sessionKey?: string;
+    sessionId?: string;
+    agentId?: string;
+}): Promise<SessionKeyResolution>;
+export declare function resolveSession(opts: {
+    cfg: Config;
+    sessionKey?: string;
+    sessionId?: string;
+    agentId?: string;
+}): Promise<SessionResolution>;