@xopcai/xopc 0.0.124 → 0.0.125

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

@@ -1 +1 @@
-{"version":3,"file":"session-context-for-llm.js","names":[],"sources":["../../../src/session/session-context-for-llm.ts"],"sourcesContent":["/**\n * Transcript rows persisted on disk may include non-LLM entries (e.g. `kind: 'context'`).\n * {@link buildSessionContextForLlm} is the single choke point for provider-facing history.\n *\n * Do not pass raw on-disk JSONL rows into pi-agent / providers — always run\n * {@link buildSessionContextForLlm} first (or use {@link SessionStore.loadMessages}, which already does).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n/** Persisted-only row: never sent to the model as a chat message. */\nexport interface XopcTranscriptContextEntry {\n  kind: 'context';\n  id?: string;\n  /** Short human-readable line for UIs / logs. */\n  text?: string;\n  /** Structured payload (tool summaries, delivery metadata, etc.). */\n  data?: Record<string, unknown>;\n  createdAt?: string;\n}\n\n/** Persisted-only row for replaying local shell executions in clients. */\nexport interface XopcTranscriptBashExecutionEntry {\n  role: 'bashExecution';\n  command?: string;\n  output?: string | unknown[];\n  exitCode?: number | null;\n  signal?: string | null;\n  excludeFromContext?: boolean;\n  excludedFromContext?: boolean;\n  truncated?: boolean;\n  fullOutputPath?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted extension-injected message row for client replay. */\nexport interface XopcTranscriptCustomMessageEntry {\n  role: 'custom';\n  customType?: string;\n  content?: string | unknown[];\n  display?: boolean;\n  details?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted extension custom_message entry shape before conversion to an agent message. */\nexport interface XopcTranscriptCustomMessageFileEntry {\n  type: 'custom_message';\n  customType?: string;\n  content?: string | unknown[];\n  display?: boolean;\n  details?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted extension state entry for replay by extension sessionManager APIs. */\nexport interface XopcTranscriptCustomStateEntry {\n  type: 'custom';\n  customType?: string;\n  data?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted branch summary row generated when returning from a branch. */\nexport interface XopcTranscriptBranchSummaryEntry {\n  role: 'branchSummary';\n  summary?: string;\n  fromId?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted compaction summary row generated after transcript compaction. */\nexport interface XopcTranscriptCompactionSummaryEntry {\n  role: 'compactionSummary';\n  summary?: string;\n  tokensBefore?: number;\n  timestamp?: string | number;\n}\n\n/** Persisted label change for a transcript entry. */\nexport interface XopcTranscriptLabelEntry {\n  type: 'label';\n  id?: string;\n  parentId?: string | null;\n  targetId?: string;\n  label?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted thinking level change metadata row. */\nexport interface XopcTranscriptThinkingLevelChangeEntry {\n  type: 'thinking_level_change';\n  id?: string;\n  parentId?: string | null;\n  thinkingLevel?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted model change metadata row. */\nexport interface XopcTranscriptModelChangeEntry {\n  type: 'model_change';\n  id?: string;\n  parentId?: string | null;\n  provider?: string;\n  modelId?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted session info metadata row. */\nexport interface XopcTranscriptSessionInfoEntry {\n  type: 'session_info';\n  id?: string;\n  parentId?: string | null;\n  name?: string;\n  timestamp?: string | number;\n}\n\nexport type TranscriptStoredRow =\n  | AgentMessage\n  | XopcTranscriptContextEntry\n  | XopcTranscriptBashExecutionEntry\n  | XopcTranscriptCustomMessageEntry\n  | XopcTranscriptCustomMessageFileEntry\n  | XopcTranscriptCustomStateEntry\n  | XopcTranscriptBranchSummaryEntry\n  | XopcTranscriptCompactionSummaryEntry\n  | XopcTranscriptLabelEntry\n  | XopcTranscriptThinkingLevelChangeEntry\n  | XopcTranscriptModelChangeEntry\n  | XopcTranscriptSessionInfoEntry;\n\nexport function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).kind === 'context';\n}\n\nexport function isTranscriptBashExecutionEntry(x: unknown): x is XopcTranscriptBashExecutionEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).role === 'bashExecution';\n}\n\nexport function isTranscriptCustomMessageEntry(\n  x: unknown,\n): x is XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry {\n  if (!x || typeof x !== 'object') return false;\n  const row = x as Record<string, unknown>;\n  return row.role === 'custom' || row.type === 'custom_message';\n}\n\nexport function isTranscriptCustomStateEntry(x: unknown): x is XopcTranscriptCustomStateEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).type === 'custom';\n}\n\nexport function isTranscriptSummaryMessageEntry(\n  x: unknown,\n): x is XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return role === 'branchSummary' || role === 'compactionSummary';\n}\n\nexport function isTranscriptLabelEntry(x: unknown): x is XopcTranscriptLabelEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).type === 'label';\n}\n\nexport function isTranscriptMetadataEntry(\n  x: unknown,\n): x is XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry {\n  if (!x || typeof x !== 'object') return false;\n  const type = (x as Record<string, unknown>).type;\n  return type === 'thinking_level_change' || type === 'model_change' || type === 'session_info';\n}\n\nconst LLM_ROLES = new Set(['user', 'assistant', 'system', 'tool', 'toolResult']);\nconst CODING_CONTEXT_LOOKBACK = 80;\nconst CODING_CONTEXT_MAX_LINES = 24;\n\nfunction isLikelyAgentMessage(x: unknown): x is AgentMessage {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return typeof role === 'string' && LLM_ROLES.has(role);\n}\n\nfunction parseTimestampValue(timestamp: string | number | undefined): number | undefined {\n  if (typeof timestamp === 'number') {\n    return Number.isFinite(timestamp) ? timestamp : undefined;\n  }\n  if (typeof timestamp !== 'string') {\n    return undefined;\n  }\n  const ms = Date.parse(timestamp);\n  return Number.isFinite(ms) ? ms : undefined;\n}\n\nfunction customMessageRowToLlmMessage(\n  row: XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry,\n): AgentMessage {\n  const content = typeof row.content === 'string'\n    ? [{ type: 'text' as const, text: row.content }]\n    : Array.isArray(row.content)\n      ? row.content\n      : [{ type: 'text' as const, text: '' }];\n  return {\n    role: 'user',\n    content,\n    timestamp: parseTimestampValue(row.timestamp),\n  } as AgentMessage;\n}\n\nfunction bashExecutionRowToLlmMessage(row: XopcTranscriptBashExecutionEntry): AgentMessage | null {\n  if (row.excludeFromContext === true || row.excludedFromContext === true) {\n    return null;\n  }\n  const command = row.command?.trim();\n  if (!command) {\n    return null;\n  }\n  const output = typeof row.output === 'string'\n    ? row.output\n    : Array.isArray(row.output)\n      ? row.output\n        .filter((part): part is { type: string; text?: string } =>\n          typeof part === 'object' && part !== null && 'type' in part)\n        .map((part) => (part.type === 'text' && typeof part.text === 'string' ? part.text : ''))\n        .join('')\n      : '';\n  const exit = row.exitCode == null ? '?' : String(row.exitCode);\n  const signal = row.signal ? ` signal=${row.signal}` : '';\n  const truncated = row.truncated ? '\\n[output truncated]' : '';\n  return {\n    role: 'user',\n    content: [{\n      type: 'text',\n      text: [\n        '<local_shell>',\n        `$ ${command}`,\n        `exit=${exit}${signal}`,\n        output ? 'output:' : 'output: (empty)',\n        output.trimEnd(),\n        `${truncated}</local_shell>`,\n      ].join('\\n'),\n    }],\n    timestamp: parseTimestampValue(row.timestamp),\n  } as AgentMessage;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : null;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction parseJsonRecord(value: unknown): Record<string, unknown> | null {\n  if (typeof value !== 'string' || !value.trim()) return null;\n  try {\n    return asRecord(JSON.parse(value));\n  } catch {\n    return null;\n  }\n}\n\nfunction textFromContent(content: unknown): string {\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return '';\n  return content\n    .map((part) => {\n      if (typeof part === 'string') return part;\n      const rec = asRecord(part);\n      if (!rec) return '';\n      if (rec.type === 'text' && typeof rec.text === 'string') return rec.text;\n      return '';\n    })\n    .filter(Boolean)\n    .join('');\n}\n\nfunction toolNameFromBlock(block: Record<string, unknown>): string {\n  const fn = asRecord(block.function);\n  return stringValue(block.name) ?? stringValue(block.toolName) ?? stringValue(fn?.name) ?? 'tool';\n}\n\nfunction toolArgsFromBlock(block: Record<string, unknown>): Record<string, unknown> {\n  const fn = asRecord(block.function);\n  return (\n    asRecord(block.arguments) ??\n    asRecord(block.args) ??\n    asRecord(block.input) ??\n    asRecord(fn?.arguments) ??\n    parseJsonRecord(block.arguments) ??\n    parseJsonRecord(block.args) ??\n    parseJsonRecord(block.input) ??\n    parseJsonRecord(fn?.arguments) ??\n    {}\n  );\n}\n\nfunction toolCallIdFromBlock(block: Record<string, unknown>): string | undefined {\n  return (\n    stringValue(block.id) ??\n    stringValue(block.toolCallId) ??\n    stringValue(block.tool_call_id) ??\n    stringValue(block.tool_call_id$)\n  );\n}\n\nfunction toolResultId(row: AgentMessage): string | undefined {\n  const rec = row as unknown as Record<string, unknown>;\n  return (\n    stringValue(rec.toolCallId) ??\n    stringValue(rec.tool_call_id) ??\n    stringValue(rec.tool_call_id$)\n  );\n}\n\nfunction extractResultDetails(row: AgentMessage | undefined): Record<string, unknown> | null {\n  if (!row) return null;\n  const topLevelDetails = asRecord((row as unknown as { details?: unknown }).details);\n  if (topLevelDetails) return topLevelDetails;\n\n  const contentText = textFromContent((row as { content?: unknown }).content);\n  if (!contentText.trim()) return null;\n  try {\n    const parsed = JSON.parse(contentText) as unknown;\n    const rec = asRecord(parsed);\n    const details = asRecord(rec?.details);\n    return details ?? rec;\n  } catch {\n    return null;\n  }\n}\n\nfunction collectToolResults(messages: AgentMessage[]): Map<string, AgentMessage> {\n  const results = new Map<string, AgentMessage>();\n  for (const message of messages) {\n    const role = (message as { role?: unknown }).role;\n    if (role !== 'tool' && role !== 'toolResult') continue;\n    const id = toolResultId(message);\n    if (id) results.set(id, message);\n  }\n  return results;\n}\n\nfunction extractToolCalls(message: AgentMessage): Array<{ id?: string; name: string; args: Record<string, unknown> }> {\n  const content = (message as { content?: unknown }).content;\n  const calls: Array<{ id?: string; name: string; args: Record<string, unknown> }> = [];\n  if (Array.isArray(content)) {\n    for (const block of content) {\n      const rec = asRecord(block);\n      const type = rec ? stringValue(rec.type) : undefined;\n      if (!rec || (type !== 'toolCall' && type !== 'tool_use' && type !== 'tool_call')) continue;\n      calls.push({ id: toolCallIdFromBlock(rec), name: toolNameFromBlock(rec), args: toolArgsFromBlock(rec) });\n    }\n  }\n  const toolCalls = (message as { tool_calls?: unknown }).tool_calls;\n  if (Array.isArray(toolCalls)) {\n    for (const call of toolCalls) {\n      const rec = asRecord(call);\n      const fn = asRecord(rec?.function);\n      const name = stringValue(fn?.name) ?? stringValue(rec?.name);\n      if (!rec || !name) continue;\n      calls.push({\n        id: stringValue(rec.id),\n        name,\n        args: parseJsonRecord(fn?.arguments) ?? asRecord(fn?.arguments) ?? {},\n      });\n    }\n  }\n  return calls;\n}\n\nfunction summarizePlan(details: Record<string, unknown>): string | undefined {\n  const plan = Array.isArray(details.plan) ? details.plan : [];\n  const lines = plan\n    .map((item) => {\n      const rec = asRecord(item);\n      const step = stringValue(rec?.step)?.trim();\n      const status = stringValue(rec?.status)?.trim();\n      return step && status ? `${status}: ${step}` : '';\n    })\n    .filter(Boolean)\n    .slice(0, 8);\n  if (lines.length === 0) return undefined;\n  const explanation = stringValue(details.explanation)?.trim();\n  return `Plan${explanation ? ` (${explanation})` : ''}: ${lines.join(' | ')}`;\n}\n\nfunction summarizeCommand(args: Record<string, unknown>, details: Record<string, unknown> | null): string {\n  const command = stringValue(details?.command) ?? stringValue(args.cmd) ?? stringValue(args.command) ?? '';\n  const status = stringValue(details?.status) ?? (details?.exitCode === 0 ? 'success' : 'unknown');\n  const exitCode = typeof details?.exitCode === 'number' ? details.exitCode : undefined;\n  const hint = stringValue(details?.failureHint);\n  return [\n    `Command ${status}: ${command || '(unknown command)'}`,\n    exitCode !== undefined ? `exit=${exitCode}` : '',\n    hint ? `hint=${hint}` : '',\n  ].filter(Boolean).join(' ');\n}\n\nfunction summarizePatch(details: Record<string, unknown> | null): string | undefined {\n  if (!details) return undefined;\n  const files = Array.isArray(details.files)\n    ? details.files.filter((file): file is string => typeof file === 'string' && file.trim().length > 0)\n    : [];\n  const added = typeof details.added === 'number' ? details.added : 0;\n  const removed = typeof details.removed === 'number' ? details.removed : 0;\n  const summary = stringValue(details.summary)?.trim();\n  return `Patch applied: ${files.length ? files.join(', ') : summary || '(files unknown)'} (+${added}/-${removed})`;\n}\n\nfunction buildCodingContextMessage(messages: AgentMessage[]): AgentMessage | null {\n  const recent = messages.slice(-CODING_CONTEXT_LOOKBACK);\n  const results = collectToolResults(recent);\n  const lines: string[] = [];\n\n  for (const message of recent) {\n    if ((message as { role?: unknown }).role !== 'assistant') continue;\n    for (const call of extractToolCalls(message)) {\n      if (call.name !== 'update_plan' && call.name !== 'exec_command' && call.name !== 'apply_patch') {\n        continue;\n      }\n      const result = call.id ? results.get(call.id) : undefined;\n      const details = extractResultDetails(result);\n      const line = call.name === 'update_plan'\n        ? summarizePlan(details ?? call.args)\n        : call.name === 'exec_command'\n          ? summarizeCommand(call.args, details)\n          : summarizePatch(details);\n      if (line) lines.push(line);\n    }\n  }\n\n  const uniqueLines = [...new Set(lines)].slice(-CODING_CONTEXT_MAX_LINES);\n  if (uniqueLines.length === 0) return null;\n  return {\n    role: 'user',\n    content: [{\n      type: 'text',\n      text: ['<coding_context>', ...uniqueLines.map((line) => `- ${line}`), '</coding_context>'].join('\\n'),\n    }],\n  } as AgentMessage;\n}\n\n/**\n * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).\n */\nexport function transcriptRowsFromJsonArray(arr: unknown[]): TranscriptStoredRow[] {\n  const out: TranscriptStoredRow[] = [];\n  for (const x of arr) {\n    if (isTranscriptContextEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptBashExecutionEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptCustomMessageEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptCustomStateEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptSummaryMessageEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptLabelEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptMetadataEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isLikelyAgentMessage(x)) {\n      out.push(x);\n    }\n  }\n  return out;\n}\n\n/** Messages only — what providers and pi-agent should see. */\nexport function buildSessionContextForLlm(rows: TranscriptStoredRow[]): AgentMessage[] {\n  const out: AgentMessage[] = [];\n  for (const r of rows) {\n    if (isTranscriptContextEntry(r)) {\n      continue;\n    }\n    if ((r as { type?: string }).type === 'compaction') {\n      continue;\n    }\n    if (isTranscriptBashExecutionEntry(r)) {\n      const msg = bashExecutionRowToLlmMessage(r);\n      if (msg) out.push(msg);\n      continue;\n    }\n    if (isTranscriptCustomMessageEntry(r)) {\n      out.push(customMessageRowToLlmMessage(r));\n      continue;\n    }\n    if (isLikelyAgentMessage(r)) {\n      out.push(r);\n    }\n  }\n  const codingContext = buildCodingContextMessage(out);\n  if (codingContext) out.push(codingContext);\n  return out;\n}\n\n/**\n * When persisting LLM messages, keep prior `kind: 'context'` rows in their relative positions:\n * each non-context slot in the previous file is replaced by the next incoming LLM message;\n * trailing new LLM rows are appended. Extra old LLM rows are dropped if the new list is shorter.\n */\nexport function mergeLlmMessagesPreservingContextRows(\n  prevRows: TranscriptStoredRow[],\n  llmMessages: AgentMessage[],\n): TranscriptStoredRow[] {\n  let i = 0;\n  const out: TranscriptStoredRow[] = [];\n  for (const r of prevRows) {\n    if (\n      isTranscriptContextEntry(r) ||\n      isTranscriptBashExecutionEntry(r) ||\n      isTranscriptCustomMessageEntry(r) ||\n      isTranscriptCustomStateEntry(r) ||\n      isTranscriptSummaryMessageEntry(r) ||\n      isTranscriptLabelEntry(r) ||\n      isTranscriptMetadataEntry(r)\n    ) {\n      out.push(r);\n    } else {\n      if (i < llmMessages.length) {\n        out.push(llmMessages[i]);\n        i += 1;\n      }\n    }\n  }\n  while (i < llmMessages.length) {\n    out.push(llmMessages[i]);\n    i += 1;\n  }\n  return out;\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-context-for-llm.js","names":[],"sources":["../../../src/session/session-context-for-llm.ts"],"sourcesContent":["/**\n * Transcript rows persisted on disk may include non-LLM entries (e.g. `kind: 'context'`).\n * {@link buildSessionContextForLlm} is the single choke point for provider-facing history.\n *\n * Do not pass raw on-disk JSONL rows into pi-agent / providers — always run\n * {@link buildSessionContextForLlm} first (or use {@link SessionStore.loadMessages}, which already does).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n/** Persisted-only row: never sent to the model as a chat message. */\nexport interface XopcTranscriptContextEntry {\n  kind: 'context';\n  id?: string;\n  /** Short human-readable line for UIs / logs. */\n  text?: string;\n  /** Structured payload (tool summaries, delivery metadata, etc.). */\n  data?: Record<string, unknown>;\n  createdAt?: string;\n}\n\n/** Persisted-only row for replaying local shell executions in clients. */\nexport interface XopcTranscriptBashExecutionEntry {\n  role: 'bashExecution';\n  command?: string;\n  output?: string | unknown[];\n  exitCode?: number | null;\n  signal?: string | null;\n  excludeFromContext?: boolean;\n  excludedFromContext?: boolean;\n  truncated?: boolean;\n  fullOutputPath?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted extension-injected message row for client replay. */\nexport interface XopcTranscriptCustomMessageEntry {\n  role: 'custom';\n  customType?: string;\n  content?: string | unknown[];\n  display?: boolean;\n  details?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted extension custom_message entry shape before conversion to an agent message. */\nexport interface XopcTranscriptCustomMessageFileEntry {\n  type: 'custom_message';\n  customType?: string;\n  content?: string | unknown[];\n  display?: boolean;\n  details?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted extension state entry for replay by extension sessionManager APIs. */\nexport interface XopcTranscriptCustomStateEntry {\n  type: 'custom';\n  customType?: string;\n  data?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted branch summary row generated when returning from a branch. */\nexport interface XopcTranscriptBranchSummaryEntry {\n  role: 'branchSummary';\n  summary?: string;\n  fromId?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted compaction summary row generated after transcript compaction. */\nexport interface XopcTranscriptCompactionSummaryEntry {\n  role: 'compactionSummary';\n  summary?: string;\n  tokensBefore?: number;\n  timestamp?: string | number;\n}\n\n/** Persisted label change for a transcript entry. */\nexport interface XopcTranscriptLabelEntry {\n  type: 'label';\n  id?: string;\n  parentId?: string | null;\n  targetId?: string;\n  label?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted thinking level change metadata row. */\nexport interface XopcTranscriptThinkingLevelChangeEntry {\n  type: 'thinking_level_change';\n  id?: string;\n  parentId?: string | null;\n  thinkingLevel?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted model change metadata row. */\nexport interface XopcTranscriptModelChangeEntry {\n  type: 'model_change';\n  id?: string;\n  parentId?: string | null;\n  provider?: string;\n  modelId?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted session info metadata row. */\nexport interface XopcTranscriptSessionInfoEntry {\n  type: 'session_info';\n  id?: string;\n  parentId?: string | null;\n  name?: string;\n  timestamp?: string | number;\n}\n\nexport type TranscriptStoredRow =\n  | AgentMessage\n  | XopcTranscriptContextEntry\n  | XopcTranscriptBashExecutionEntry\n  | XopcTranscriptCustomMessageEntry\n  | XopcTranscriptCustomMessageFileEntry\n  | XopcTranscriptCustomStateEntry\n  | XopcTranscriptBranchSummaryEntry\n  | XopcTranscriptCompactionSummaryEntry\n  | XopcTranscriptLabelEntry\n  | XopcTranscriptThinkingLevelChangeEntry\n  | XopcTranscriptModelChangeEntry\n  | XopcTranscriptSessionInfoEntry;\n\nexport function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).kind === 'context';\n}\n\nexport function isTranscriptBashExecutionEntry(x: unknown): x is XopcTranscriptBashExecutionEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).role === 'bashExecution';\n}\n\nexport function isTranscriptCustomMessageEntry(\n  x: unknown,\n): x is XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry {\n  if (!x || typeof x !== 'object') return false;\n  const row = x as Record<string, unknown>;\n  return row.role === 'custom' || row.type === 'custom_message';\n}\n\nexport function isTranscriptCustomStateEntry(x: unknown): x is XopcTranscriptCustomStateEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).type === 'custom';\n}\n\nexport function isTranscriptSummaryMessageEntry(\n  x: unknown,\n): x is XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return role === 'branchSummary' || role === 'compactionSummary';\n}\n\nexport function isTranscriptLabelEntry(x: unknown): x is XopcTranscriptLabelEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).type === 'label';\n}\n\nexport function isTranscriptMetadataEntry(\n  x: unknown,\n): x is XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry {\n  if (!x || typeof x !== 'object') return false;\n  const type = (x as Record<string, unknown>).type;\n  return type === 'thinking_level_change' || type === 'model_change' || type === 'session_info';\n}\n\nconst LLM_ROLES = new Set(['user', 'assistant', 'system', 'tool', 'toolResult']);\nconst CODING_CONTEXT_LOOKBACK = 80;\nconst CODING_CONTEXT_MAX_LINES = 24;\n\nfunction isLikelyAgentMessage(x: unknown): x is AgentMessage {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return typeof role === 'string' && LLM_ROLES.has(role);\n}\n\nfunction parseTimestampValue(timestamp: string | number | undefined): number | undefined {\n  if (typeof timestamp === 'number') {\n    return Number.isFinite(timestamp) ? timestamp : undefined;\n  }\n  if (typeof timestamp !== 'string') {\n    return undefined;\n  }\n  const ms = Date.parse(timestamp);\n  return Number.isFinite(ms) ? ms : undefined;\n}\n\nfunction customMessageRowToLlmMessage(\n  row: XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry,\n): AgentMessage {\n  const content = typeof row.content === 'string'\n    ? [{ type: 'text' as const, text: row.content }]\n    : Array.isArray(row.content)\n      ? row.content\n      : [{ type: 'text' as const, text: '' }];\n  return {\n    role: 'user',\n    content,\n    timestamp: parseTimestampValue(row.timestamp),\n  } as AgentMessage;\n}\n\nfunction bashExecutionRowToLlmMessage(row: XopcTranscriptBashExecutionEntry): AgentMessage | null {\n  if (row.excludeFromContext === true || row.excludedFromContext === true) {\n    return null;\n  }\n  const command = row.command?.trim();\n  if (!command) {\n    return null;\n  }\n  const output = typeof row.output === 'string'\n    ? row.output\n    : Array.isArray(row.output)\n      ? row.output\n        .filter((part): part is { type: string; text?: string } =>\n          typeof part === 'object' && part !== null && 'type' in part)\n        .map((part) => (part.type === 'text' && typeof part.text === 'string' ? part.text : ''))\n        .join('')\n      : '';\n  const exit = row.exitCode == null ? '?' : String(row.exitCode);\n  const signal = row.signal ? ` signal=${row.signal}` : '';\n  const truncated = row.truncated ? '\\n[output truncated]' : '';\n  return {\n    role: 'user',\n    content: [{\n      type: 'text',\n      text: [\n        '<local_shell>',\n        `$ ${command}`,\n        `exit=${exit}${signal}`,\n        output ? 'output:' : 'output: (empty)',\n        output.trimEnd(),\n        `${truncated}</local_shell>`,\n      ].join('\\n'),\n    }],\n    timestamp: parseTimestampValue(row.timestamp),\n  } as AgentMessage;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : null;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction parseJsonRecord(value: unknown): Record<string, unknown> | null {\n  if (typeof value !== 'string' || !value.trim()) return null;\n  try {\n    return asRecord(JSON.parse(value));\n  } catch {\n    return null;\n  }\n}\n\nfunction textFromContent(content: unknown): string {\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return '';\n  return content\n    .map((part) => {\n      if (typeof part === 'string') return part;\n      const rec = asRecord(part);\n      if (!rec) return '';\n      if (rec.type === 'text' && typeof rec.text === 'string') return rec.text;\n      return '';\n    })\n    .filter(Boolean)\n    .join('');\n}\n\nfunction toolNameFromBlock(block: Record<string, unknown>): string {\n  const fn = asRecord(block.function);\n  return stringValue(block.name) ?? stringValue(block.toolName) ?? stringValue(fn?.name) ?? 'tool';\n}\n\nfunction toolArgsFromBlock(block: Record<string, unknown>): Record<string, unknown> {\n  const fn = asRecord(block.function);\n  return (\n    asRecord(block.arguments) ??\n    asRecord(block.args) ??\n    asRecord(block.input) ??\n    asRecord(fn?.arguments) ??\n    parseJsonRecord(block.arguments) ??\n    parseJsonRecord(block.args) ??\n    parseJsonRecord(block.input) ??\n    parseJsonRecord(fn?.arguments) ??\n    {}\n  );\n}\n\nfunction toolCallIdFromBlock(block: Record<string, unknown>): string | undefined {\n  return (\n    stringValue(block.id) ??\n    stringValue(block.toolCallId) ??\n    stringValue(block.tool_call_id) ??\n    stringValue(block.tool_call_id$)\n  );\n}\n\nfunction toolResultId(row: AgentMessage): string | undefined {\n  const rec = row as unknown as Record<string, unknown>;\n  return (\n    stringValue(rec.toolCallId) ??\n    stringValue(rec.tool_call_id) ??\n    stringValue(rec.tool_call_id$)\n  );\n}\n\nfunction extractResultDetails(row: AgentMessage | undefined): Record<string, unknown> | null {\n  if (!row) return null;\n  const topLevelDetails = asRecord((row as unknown as { details?: unknown }).details);\n  if (topLevelDetails) return topLevelDetails;\n\n  const contentText = textFromContent((row as { content?: unknown }).content);\n  if (!contentText.trim()) return null;\n  try {\n    const parsed = JSON.parse(contentText) as unknown;\n    const rec = asRecord(parsed);\n    const details = asRecord(rec?.details);\n    return details ?? rec;\n  } catch {\n    return null;\n  }\n}\n\nfunction collectToolResults(messages: AgentMessage[]): Map<string, AgentMessage> {\n  const results = new Map<string, AgentMessage>();\n  for (const message of messages) {\n    const role = (message as { role?: unknown }).role;\n    if (role !== 'tool' && role !== 'toolResult') continue;\n    const id = toolResultId(message);\n    if (id) results.set(id, message);\n  }\n  return results;\n}\n\nfunction extractToolCalls(message: AgentMessage): Array<{ id?: string; name: string; args: Record<string, unknown> }> {\n  const content = (message as { content?: unknown }).content;\n  const calls: Array<{ id?: string; name: string; args: Record<string, unknown> }> = [];\n  if (Array.isArray(content)) {\n    for (const block of content) {\n      const rec = asRecord(block);\n      const type = rec ? stringValue(rec.type) : undefined;\n      if (!rec || (type !== 'toolCall' && type !== 'tool_use' && type !== 'tool_call')) continue;\n      calls.push({ id: toolCallIdFromBlock(rec), name: toolNameFromBlock(rec), args: toolArgsFromBlock(rec) });\n    }\n  }\n  const toolCalls = (message as { tool_calls?: unknown }).tool_calls;\n  if (Array.isArray(toolCalls)) {\n    for (const call of toolCalls) {\n      const rec = asRecord(call);\n      const fn = asRecord(rec?.function);\n      const name = stringValue(fn?.name) ?? stringValue(rec?.name);\n      if (!rec || !name) continue;\n      calls.push({\n        id: stringValue(rec.id),\n        name,\n        args: parseJsonRecord(fn?.arguments) ?? asRecord(fn?.arguments) ?? {},\n      });\n    }\n  }\n  return calls;\n}\n\nfunction summarizePlan(details: Record<string, unknown>): string | undefined {\n  const plan = Array.isArray(details.plan) ? details.plan : [];\n  const lines = plan\n    .map((item) => {\n      const rec = asRecord(item);\n      const step = stringValue(rec?.step)?.trim();\n      const status = stringValue(rec?.status)?.trim();\n      return step && status ? `${status}: ${step}` : '';\n    })\n    .filter(Boolean)\n    .slice(0, 8);\n  if (lines.length === 0) return undefined;\n  const explanation = stringValue(details.explanation)?.trim();\n  return `Plan${explanation ? ` (${explanation})` : ''}: ${lines.join(' | ')}`;\n}\n\nfunction summarizeCommand(args: Record<string, unknown>, details: Record<string, unknown> | null): string {\n  const command = stringValue(details?.command) ?? stringValue(args.cmd) ?? stringValue(args.command) ?? '';\n  const status = stringValue(details?.status) ?? (details?.exitCode === 0 ? 'success' : 'unknown');\n  const exitCode = typeof details?.exitCode === 'number' ? details.exitCode : undefined;\n  const hint = stringValue(details?.failureHint);\n  return [\n    `Command ${status}: ${command || '(unknown command)'}`,\n    exitCode !== undefined ? `exit=${exitCode}` : '',\n    hint ? `hint=${hint}` : '',\n  ].filter(Boolean).join(' ');\n}\n\nfunction summarizePatch(details: Record<string, unknown> | null): string | undefined {\n  if (!details) return undefined;\n  const files = Array.isArray(details.files)\n    ? details.files.filter((file): file is string => typeof file === 'string' && file.trim().length > 0)\n    : [];\n  const added = typeof details.added === 'number' ? details.added : 0;\n  const removed = typeof details.removed === 'number' ? details.removed : 0;\n  const summary = stringValue(details.summary)?.trim();\n  return `Patch applied: ${files.length ? files.join(', ') : summary || '(files unknown)'} (+${added}/-${removed})`;\n}\n\nfunction buildCodingContextMessage(messages: AgentMessage[]): AgentMessage | null {\n  const recent = messages.slice(-CODING_CONTEXT_LOOKBACK);\n  const results = collectToolResults(recent);\n  const lines: string[] = [];\n\n  for (const message of recent) {\n    if ((message as { role?: unknown }).role !== 'assistant') continue;\n    for (const call of extractToolCalls(message)) {\n      if (call.name !== 'update_plan' && call.name !== 'exec_command' && call.name !== 'apply_patch') {\n        continue;\n      }\n      const result = call.id ? results.get(call.id) : undefined;\n      const details = extractResultDetails(result);\n      const line = call.name === 'update_plan'\n        ? summarizePlan(details ?? call.args)\n        : call.name === 'exec_command'\n          ? summarizeCommand(call.args, details)\n          : summarizePatch(details);\n      if (line) lines.push(line);\n    }\n  }\n\n  const uniqueLines = [...new Set(lines)].slice(-CODING_CONTEXT_MAX_LINES);\n  if (uniqueLines.length === 0) return null;\n  return {\n    role: 'user',\n    content: [{\n      type: 'text',\n      text: ['<coding_context>', ...uniqueLines.map((line) => `- ${line}`), '</coding_context>'].join('\\n'),\n    }],\n  } as AgentMessage;\n}\n\n/**\n * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).\n */\nexport function transcriptRowsFromJsonArray(arr: unknown[]): TranscriptStoredRow[] {\n  const out: TranscriptStoredRow[] = [];\n  for (const x of arr) {\n    if (isTranscriptContextEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptBashExecutionEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptCustomMessageEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptCustomStateEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptSummaryMessageEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptLabelEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptMetadataEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isLikelyAgentMessage(x)) {\n      out.push(x);\n    }\n  }\n  return out;\n}\n\n/** Messages only — what providers and pi-agent should see. */\nexport function buildSessionContextForLlm(rows: TranscriptStoredRow[]): AgentMessage[] {\n  const out: AgentMessage[] = [];\n  for (const r of rows) {\n    if (isTranscriptContextEntry(r)) {\n      continue;\n    }\n    if ((r as { type?: string }).type === 'compaction') {\n      continue;\n    }\n    if (isTranscriptBashExecutionEntry(r)) {\n      const msg = bashExecutionRowToLlmMessage(r);\n      if (msg) out.push(msg);\n      continue;\n    }\n    if (isTranscriptCustomMessageEntry(r)) {\n      out.push(customMessageRowToLlmMessage(r));\n      continue;\n    }\n    if (isLikelyAgentMessage(r)) {\n      out.push(r);\n    }\n  }\n  const codingContext = buildCodingContextMessage(out);\n  if (codingContext) out.push(codingContext);\n  return out;\n}\n\n/** Visible chat messages only - no LLM-only audit/context expansion. */\nexport function buildSessionDisplayMessages(rows: TranscriptStoredRow[]): AgentMessage[] {\n  const out: AgentMessage[] = [];\n  for (const r of rows) {\n    if (isTranscriptCustomMessageEntry(r)) {\n      if (r.display === false) {\n        continue;\n      }\n      out.push(customMessageRowToLlmMessage(r));\n      continue;\n    }\n    if (isLikelyAgentMessage(r)) {\n      out.push(r);\n    }\n  }\n  return out;\n}\n\n/**\n * When persisting LLM messages, keep prior `kind: 'context'` rows in their relative positions:\n * each non-context slot in the previous file is replaced by the next incoming LLM message;\n * trailing new LLM rows are appended. Extra old LLM rows are dropped if the new list is shorter.\n */\nexport function mergeLlmMessagesPreservingContextRows(\n  prevRows: TranscriptStoredRow[],\n  llmMessages: AgentMessage[],\n): TranscriptStoredRow[] {\n  let i = 0;\n  const out: TranscriptStoredRow[] = [];\n  for (const r of prevRows) {\n    if (\n      isTranscriptContextEntry(r) ||\n      isTranscriptBashExecutionEntry(r) ||\n      isTranscriptCustomMessageEntry(r) ||\n      isTranscriptCustomStateEntry(r) ||\n      isTranscriptSummaryMessageEntry(r) ||\n      isTranscriptLabelEntry(r) ||\n      isTranscriptMetadataEntry(r)\n    ) {\n      out.push(r);\n    } else {\n      if (i < llmMessages.length) {\n        out.push(llmMessages[i]);\n        i += 1;\n      }\n    }\n  }\n  while (i < llmMessages.length) {\n    out.push(llmMessages[i]);\n    i += 1;\n  }\n  return out;\n}\n"],"mappings":"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"}

package/dist/src/session/store.js

@@ -4,7 +4,7 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import "./types.js";
-import { buildSessionContextForLlm, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
+import { buildSessionContextForLlm, buildSessionDisplayMessages, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.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";
@@ -525,7 +525,7 @@ var SessionStore = class {
 		rowSets.push(await this.loadTranscriptRows(key));
 		const messages = [];
 		const seen = /* @__PURE__ */ new Set();
-		for (const rows of rowSets) for (const message of buildSessionContextForLlm(rows)) {
+		for (const rows of rowSets) for (const message of buildSessionDisplayMessages(rows)) {
 			if (this.isCompactionSummaryMessage(message)) continue;
 			const identity = this.displayMessageIdentity(message);
 			if (seen.has(identity)) continue;

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

@@ -1 +1 @@
-{"version":3,"file":"store.js","names":[],"sources":["../../../src/session/store.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { readPostCompactionContext } from '../agent/reply/post-compaction-context.js';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionCompactor, type CompactionConfig, type CompactionResult } from '../agent/memory/compaction.js';\nimport { SlidingWindow, type WindowConfig } from '../agent/memory/window.js';\nimport {\n  requireXopcDatabase,\n  appendTranscriptEntry,\n  captureCompactionCheckpoint,\n  deleteSessionRecord,\n  ensureSessionRecord,\n  estimateTokensFromMessages,\n  getCompactionCheckpointDetail,\n  getGlobalSessionStats,\n  getSessionMetadata,\n  findSessionKeyBySessionId,\n  listCompactionCheckpoints,\n  listSessionMetadata,\n  listSessionsByAgent,\n  loadCheckpointRows,\n  loadLlmMessagesForSession,\n  loadTranscriptRowsForSession,\n  patchSessionMetadata,\n  replaceTranscriptRows,\n  resetSessionRecord,\n  restoreCompactionCheckpoint,\n  type SessionMetadataSeed,\n} from '../storage/sqlite/index.js';\nimport type { TranscriptCompactionRecord, XopcSessionTranscriptV1 } from './transcript-format.js';\nimport {\n  buildSessionContextForLlm,\n  mergeLlmMessagesPreservingContextRows,\n  transcriptRowsFromJsonArray,\n  type TranscriptStoredRow,\n  type XopcTranscriptContextEntry,\n  type XopcTranscriptCustomMessageEntry,\n  type XopcTranscriptCustomStateEntry,\n} from './session-context-for-llm.js';\nimport { normalizeCompactionCheckpointId } from './compaction-checkpoints.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionExport,\n  SessionTranscriptSummary,\n  CompactionCheckpointSummary,\n  CompactionCheckpointDetail,\n} from './types.js';\nimport { SessionStatus } from './types.js';\nimport type { Message } from './types.js';\nimport type { SessionTranscriptUpdate } from './transcript-events.js';\nimport { isAppendOnlyLlmTranscriptMessage } from './transcript-stats.js';\n\nconst log = createLogger('SessionStore');\n\nconst INDEX_VERSION = '1.0';\n\nexport interface SessionStoreOptions {\n  config: Config;\n}\n\nexport class SessionStore {\n  private window: SlidingWindow;\n  private compactor: SessionCompactor;\n\n  constructor(\n    private options: SessionStoreOptions,\n    windowConfig?: Partial<WindowConfig>,\n    compactionConfig?: Partial<CompactionConfig>,\n  ) {\n    this.window = new SlidingWindow(windowConfig);\n    this.compactor = new SessionCompactor(compactionConfig);\n  }\n\n  private resolveWorkspaceCwd(sessionKey: string): string {\n    return resolveEffectiveAgentProfileForSession(this.options.config, sessionKey).resolvedWorkspacePath;\n  }\n\n  private async runStoreMutation<T>(fn: () => Promise<T>): Promise<T> {\n    return fn();\n  }\n\n  async initialize(): Promise<void> {\n    requireXopcDatabase();\n    log.debug('Session store initialized (SQLite)');\n  }\n\n  getSessionsRoot(): string {\n    return resolveStateDir();\n  }\n\n  async resolveTranscriptPath(\n    sessionKey: string,\n    options?: { metadata?: SessionMetadataSeed },\n  ): Promise<{ sessionId: string; sessionKey: string }> {\n    requireXopcDatabase();\n    const cwd = this.resolveWorkspaceCwd(sessionKey);\n    const meta = ensureSessionRecord(sessionKey, cwd, options?.metadata);\n    return { sessionId: meta.sessionId!, sessionKey };\n  }\n\n  async appendTranscriptMessage(\n    sessionKey: string,\n    message: AgentMessage,\n    options?: { metadata?: SessionMetadataSeed },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd, options?.metadata);\n      appendTranscriptEntry(sessionKey, message);\n    });\n  }\n\n  async getByAgent(agentId: string): Promise<SessionMetadata[]> {\n    requireXopcDatabase();\n    return listSessionsByAgent(agentId);\n  }\n\n  async getByAccount(accountId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.accountId === accountId);\n  }\n\n  async getByPeer(peerKind: string, peerId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.peerKind === peerKind && m.routing.peerId === peerId);\n  }\n\n  async getMainSession(channel: string, accountId: string): Promise<SessionMetadata | null> {\n    const { items } = await this.list({ limit: 100_000 });\n    return (\n      items.find(\n        (m) =>\n          m.routing?.source === channel &&\n          m.routing.accountId === accountId &&\n          m.routing.peerKind === 'dm' &&\n          m.routing.peerId === 'main',\n      ) ?? null\n    );\n  }\n\n  async refreshIndex(): Promise<void> {\n    /* no-op: SQLite is authoritative */\n  }\n\n  async list(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    requireXopcDatabase();\n    return listSessionMetadata(query);\n  }\n\n  async get(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n    const messages = await this.loadDisplayMessages(key);\n    return this.buildSessionDetail(key, metadata, messages, options);\n  }\n\n  async getMessagePage(\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 metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n    const parsedBefore = options.before ? Number.parseInt(options.before, 10) : undefined;\n    const hasBeforeCursor = parsedBefore !== undefined && Number.isFinite(parsedBefore);\n\n    const displayMessages = await this.loadDisplayMessages(key);\n    const page = this.paginateDisplayMessages(displayMessages, {\n      limit,\n      offset: hasBeforeCursor ? undefined : offset,\n      beforeEndIndex: hasBeforeCursor ? parsedBefore : undefined,\n    });\n\n    const session = await this.buildSessionDetail(key, metadata, page.messages, options);\n    const nextBeforeCursor = page.startIndex > 0 ? String(page.startIndex) : undefined;\n\n    return {\n      session,\n      pagination: {\n        total: page.total,\n        limit,\n        offset,\n        hasMore: hasBeforeCursor ? page.startIndex > 0 : offset + limit < page.total,\n        ...(hasBeforeCursor ? { before: String(page.endIndex) } : {}),\n        ...(nextBeforeCursor ? { nextBeforeCursor } : {}),\n      },\n    };\n  }\n\n  private async buildSessionDetail(\n    key: string,\n    metadata: SessionMetadata,\n    messages: AgentMessage[],\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail> {\n    let transcriptSummary: SessionTranscriptSummary | undefined;\n    if (options?.includeTranscriptSummary) {\n      const env = await this.loadTranscriptDocument(key);\n      if (env) {\n        transcriptSummary = {\n          id: env.id,\n          version: env.version,\n          createdAt: env.createdAt,\n          updatedAt: env.updatedAt,\n          compactionCount: env.compactions?.length ?? 0,\n        };\n      }\n    }\n    let transcriptRows: TranscriptStoredRow[] | undefined;\n    if (options?.includeTranscriptRows) {\n      transcriptRows = await this.loadTranscriptRows(key);\n    }\n    return {\n      ...metadata,\n      messages: this.convertMessages(messages),\n      ...(transcriptSummary ? { transcriptSummary } : {}),\n      ...(transcriptRows !== undefined ? { transcriptRows } : {}),\n    };\n  }\n\n  async loadTranscriptRows(key: string): Promise<TranscriptStoredRow[]> {\n    requireXopcDatabase();\n    return loadTranscriptRowsForSession(key);\n  }\n\n  async getMetadata(key: string): Promise<SessionMetadata | null> {\n    requireXopcDatabase();\n    return getSessionMetadata(key);\n  }\n\n  async resolveKeyBySessionId(sessionId: string): Promise<string | null> {\n    requireXopcDatabase();\n    return findSessionKeyBySessionId(sessionId);\n  }\n\n  async updateMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      patchSessionMetadata(key, updates);\n      log.debug({ key, updates }, 'Session metadata updated');\n    });\n  }\n\n  async reset(key: string): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      const outcome = resetSessionRecord(key, cwd);\n      if (outcome) {\n        log.info({ key, ...outcome }, 'Session reset');\n      }\n      return outcome;\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const ok = deleteSessionRecord(key);\n      if (ok) {\n        log.info({ key }, 'Session deleted');\n      }\n      return ok;\n    });\n  }\n\n  async deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const success: string[] = [];\n    const failed: string[] = [];\n    for (const key of keys) {\n      try {\n        if (await this.delete(key)) {\n          success.push(key);\n        } else {\n          failed.push(key);\n        }\n      } catch {\n        failed.push(key);\n      }\n    }\n    return { success, failed };\n  }\n\n  async setStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.updateMetadata(key, { status });\n  }\n\n  async archive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ARCHIVED);\n  }\n\n  async unarchive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async pin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.PINNED);\n  }\n\n  async unpin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async loadMessages(_key: string, _options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    return loadLlmMessagesForSession(_key);\n  }\n\n  async loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata?.sessionId) {\n      return null;\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const compactions: TranscriptCompactionRecord[] = [];\n    for (const row of rows) {\n      if ((row as { type?: string }).type === 'compaction') {\n        const c = row as unknown as TranscriptCompactionRecord & { type: 'compaction' };\n        compactions.push({\n          at: c.at ?? new Date().toISOString(),\n          summary: c.summary ?? '',\n          firstKeptIndex: Number(c.firstKeptIndex ?? 0),\n          tokensBefore: c.tokensBefore ?? 0,\n          tokensAfter: (c as { tokensAfter?: number }).tokensAfter ?? 0,\n        });\n      }\n    }\n    return {\n      type: 'xopc_session_transcript',\n      version: 1,\n      id: metadata.sessionId,\n      createdAt: metadata.createdAt,\n      updatedAt: metadata.updatedAt,\n      messages: rows,\n      ...(compactions.length > 0 ? { compactions } : {}),\n    };\n  }\n\n  async syncEmbeddedTranscriptUpdate(update: SessionTranscriptUpdate): Promise<void> {\n    const sessionKey = update.sessionKey?.trim();\n    if (!sessionKey) {\n      return;\n    }\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd);\n\n      if (update.message && isAppendOnlyLlmTranscriptMessage(update.message)) {\n        appendTranscriptEntry(sessionKey, update.message as AgentMessage);\n      }\n    });\n  }\n\n  async appendTranscriptContextEntry(\n    key: string,\n    entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>,\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptContextEntry = {\n        kind: 'context',\n        id: typeof entry.id === 'string' ? entry.id : undefined,\n        text: typeof entry.text === 'string' ? entry.text : undefined,\n        data: entry.data,\n        createdAt: entry.createdAt ?? new Date().toISOString(),\n      };\n      appendTranscriptEntry(key, row);\n    });\n  }\n\n  async appendTranscriptLabelEntry(\n    key: string,\n    entry: { targetId: string; label?: string },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      appendTranscriptEntry(key, {\n        type: 'label',\n        targetId: entry.targetId,\n        label: entry.label?.trim() || undefined,\n        timestamp: new Date().toISOString(),\n      });\n    });\n  }\n\n  async appendTranscriptCustomEntry(\n    key: string,\n    entry: { customType: string; data?: unknown },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptCustomStateEntry = {\n        type: 'custom',\n        customType: entry.customType.trim(),\n        data: entry.data,\n        timestamp: new Date().toISOString(),\n      };\n      appendTranscriptEntry(key, row);\n    });\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    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptCustomMessageEntry = {\n        role: 'custom',\n        customType: entry.customType.trim(),\n        content: entry.content ?? '',\n        display: entry.display ?? true,\n        details: entry.details,\n        timestamp: Date.now(),\n      };\n      appendTranscriptEntry(key, row);\n    });\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    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      appendTranscriptEntry(key, {\n        role: 'bashExecution',\n        command: entry.command,\n        output: entry.output ?? '',\n        exitCode: entry.exitCode ?? null,\n        signal: entry.signal ?? null,\n        excludeFromContext: entry.excludeFromContext === true,\n        truncated: entry.truncated === true,\n        fullOutputPath: entry.fullOutputPath,\n        timestamp: Date.now(),\n      });\n    });\n  }\n\n  async saveMessages(\n    key: string,\n    messages: AgentMessage[],\n    options?: { metadata?: SessionMetadataSeed },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd, options?.metadata);\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, messages);\n      replaceTranscriptRows(key, merged);\n    });\n  }\n\n  getWindowStats(messages: AgentMessage[]) {\n    return this.window.getStats(messages);\n  }\n\n  needsCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    return this.compactor.needsCompaction(messages, contextWindow);\n  }\n\n  prepareCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    const result = this.compactor.needsCompaction(messages, contextWindow);\n    return { needsCompaction: result.needed, messages, stats: result };\n  }\n\n  async applyCompaction(\n    key: string,\n    messages: AgentMessage[],\n    result: CompactionResult,\n  ): Promise<AgentMessage[]> {\n    const compacted = this.compactor.applyCompaction(messages, result);\n    return this.runStoreMutation(async () => {\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, compacted);\n      captureCompactionCheckpoint(key);\n      replaceTranscriptRows(key, merged, {\n        appendCompaction: {\n          at: new Date().toISOString(),\n          summary: result.summary,\n          firstKeptIndex: result.firstKeptIndex,\n          tokensBefore: result.tokensBefore,\n          tokensAfter: result.tokensAfter,\n        },\n      });\n      const metadata = await this.getMetadata(key);\n      if (metadata) {\n        await this.updateMetadata(key, { compactedCount: metadata.compactedCount + 1 });\n      }\n      log.info(\n        { key, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter, keptMessages: compacted.length },\n        'Session compacted',\n      );\n      await this.injectPostCompactionContext(key);\n      return compacted;\n    });\n  }\n\n  async compact(\n    key: string,\n    messages: AgentMessage[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    void contextWindow;\n    const result = await this.compactor.compact(messages, instructions, force);\n    if (result.compacted) {\n      await this.applyCompaction(key, messages, result);\n    }\n    return result;\n  }\n\n  async getCompactionStats(key: string) {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return undefined;\n    }\n    return {\n      compactionCount: metadata.compactedCount,\n      totalTokensBefore: 0,\n      totalTokensAfter: 0,\n      lastCompactionAt: undefined,\n    };\n  }\n\n  async listCompactionCheckpoints(key: string): Promise<CompactionCheckpointSummary[]> {\n    requireXopcDatabase();\n    return listCompactionCheckpoints(key);\n  }\n\n  async getCompactionCheckpointDetail(\n    key: string,\n    checkpointId: string,\n  ): Promise<CompactionCheckpointDetail | null> {\n    requireXopcDatabase();\n    const id = normalizeCompactionCheckpointId(checkpointId);\n    if (!id) {\n      return null;\n    }\n    return getCompactionCheckpointDetail(key, id);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const id = normalizeCompactionCheckpointId(checkpointId);\n      if (!id) {\n        throw new Error(`Invalid checkpoint id: ${checkpointId}`);\n      }\n      restoreCompactionCheckpoint(key, id);\n    });\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    return this.delete(key);\n  }\n\n  async load(key: string, options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    return this.loadMessages(key, options);\n  }\n\n  async estimateTokenUsage(_key: string, messages: AgentMessage[]): Promise<number> {\n    return this.estimateTokens(messages);\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    const messages = await this.loadDisplayMessages(key);\n    const q = keyword.toLowerCase();\n    return this.convertMessages(\n      messages.filter((m) => this.extractTextContent(this.messageContent(m)).toLowerCase().includes(q)),\n    );\n  }\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      throw new Error(`Session not found: ${key}`);\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const messages = this.convertMessages(buildSessionContextForLlm(rows));\n    const payload: SessionExport = {\n      version: INDEX_VERSION,\n      exportedAt: new Date().toISOString(),\n      metadata,\n      messages,\n      transcriptRows: rows,\n    };\n    if (format === 'json') {\n      return JSON.stringify(payload, null, 2);\n    }\n    const lines = [`# ${metadata.name ?? metadata.key}`, '', `Exported: ${payload.exportedAt}`, ''];\n    for (const msg of messages) {\n      lines.push(`## ${msg.role}`, '', typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content), '');\n    }\n    return lines.join('\\n');\n  }\n\n  async importSessionExport(\n    targetKey: string,\n    jsonContent: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const existing = await this.getMetadata(targetKey);\n      if (existing) {\n        throw new Error(`Target session already exists: ${targetKey}`);\n      }\n\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(jsonContent);\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        throw new Error(`Invalid session export JSON: ${errorMessage}`);\n      }\n\n      const record = parsed && typeof parsed === 'object' ? parsed as Record<string, unknown> : {};\n      const rowsSource = Array.isArray(record.transcriptRows) ? record.transcriptRows : undefined;\n      const rows = rowsSource ? transcriptRowsFromJsonArray(rowsSource) : [];\n      if (rows.length === 0) {\n        throw new Error('Session export contains no importable transcript rows');\n      }\n\n      const metadata = record.metadata && typeof record.metadata === 'object'\n        ? record.metadata as Partial<SessionMetadata>\n        : {};\n      const cwd = this.resolveWorkspaceCwd(targetKey);\n      ensureSessionRecord(targetKey, cwd, {\n        sourceChannel: metadata.sourceChannel,\n        sourceChatId: metadata.sourceChatId,\n        sessionType: metadata.sessionType,\n        routing: metadata.routing,\n        customData: metadata.customData,\n      });\n      replaceTranscriptRows(targetKey, rows);\n\n      const sourceKey = typeof metadata.key === 'string' ? metadata.key : undefined;\n      const sourceName = typeof metadata.name === 'string' ? metadata.name.trim() : '';\n      patchSessionMetadata(targetKey, {\n        name: sourceName ? `Import of ${sourceName}` : 'Imported session',\n        tags: [...new Set([...(Array.isArray(metadata.tags) ? metadata.tags.filter((tag): tag is string => typeof tag === 'string') : []), 'import'])],\n        customData: {\n          ...(metadata.customData && typeof metadata.customData === 'object'\n            ? metadata.customData as Record<string, unknown>\n            : {}),\n          ...(sourceKey ? { importedFromSessionKey: sourceKey } : {}),\n          importedAt: new Date().toISOString(),\n        },\n      });\n      return { sessionKey: targetKey, rowCount: rows.length };\n    });\n  }\n\n  async forkSession(\n    sourceKey: string,\n    targetKey: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.forkSessionRows(sourceKey, targetKey);\n  }\n\n  async forkSessionRows(\n    sourceKey: string,\n    targetKey: string,\n    options: { throughRow?: number } = {},\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const sourceMetadata = await this.getMetadata(sourceKey);\n      if (!sourceMetadata) {\n        throw new Error(`Session not found: ${sourceKey}`);\n      }\n      const existing = await this.getMetadata(targetKey);\n      if (existing) {\n        throw new Error(`Target session already exists: ${targetKey}`);\n      }\n      const rows = await this.loadTranscriptRows(sourceKey);\n      if (\n        options.throughRow !== undefined &&\n        (options.throughRow < 1 || options.throughRow > rows.length)\n      ) {\n        throw new Error(`Invalid fork row: ${options.throughRow}`);\n      }\n      const selectedRows =\n        options.throughRow === undefined ? rows : rows.slice(0, Math.max(0, Math.trunc(options.throughRow)));\n      const cwd = this.resolveWorkspaceCwd(targetKey);\n      ensureSessionRecord(targetKey, cwd, {\n        sourceChannel: sourceMetadata.sourceChannel,\n        sourceChatId: sourceMetadata.sourceChatId,\n        sessionType: sourceMetadata.sessionType,\n        routing: sourceMetadata.routing,\n        customData: sourceMetadata.customData,\n      });\n      replaceTranscriptRows(targetKey, selectedRows);\n      const label = sourceMetadata.name?.trim() || sourceKey;\n      patchSessionMetadata(targetKey, {\n        name: `Fork of ${label}`,\n        tags: [...new Set([...(sourceMetadata.tags ?? []), 'fork'])],\n        customData: {\n          ...(sourceMetadata.customData ?? {}),\n          forkedFromSessionKey: sourceKey,\n          forkedFromSessionId: sourceMetadata.sessionId,\n          ...(options.throughRow !== undefined ? { forkedFromRow: selectedRows.length } : {}),\n          forkedAt: new Date().toISOString(),\n        },\n      });\n      return { sessionKey: targetKey, rowCount: selectedRows.length };\n    });\n  }\n\n  async getStats(): Promise<GlobalSessionStats> {\n    requireXopcDatabase();\n    return getGlobalSessionStats();\n  }\n\n  async archiveOld(olderThanDays: number): Promise<number> {\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - olderThanDays);\n    const list = await this.list({ limit: 100_000 });\n    let archived = 0;\n    for (const session of list.items) {\n      if (session.status !== SessionStatus.ARCHIVED && session.status !== SessionStatus.PINNED) {\n        const lastAccess = new Date(session.lastAccessedAt);\n        if (lastAccess < cutoff) {\n          await this.archive(session.key);\n          archived++;\n        }\n      }\n    }\n    return archived;\n  }\n\n  estimateTokens(messages: AgentMessage[]): number {\n    return estimateTokensFromMessages(messages);\n  }\n\n  private async loadDisplayMessages(key: string): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    const checkpoints = listCompactionCheckpoints(key);\n    const rowSets: TranscriptStoredRow[][] = [];\n    for (const checkpoint of [...checkpoints].reverse()) {\n      rowSets.push(loadCheckpointRows(key, checkpoint.id));\n    }\n    rowSets.push(await this.loadTranscriptRows(key));\n\n    const messages: AgentMessage[] = [];\n    const seen = new Set<string>();\n    for (const rows of rowSets) {\n      for (const message of buildSessionContextForLlm(rows)) {\n        if (this.isCompactionSummaryMessage(message)) {\n          continue;\n        }\n        const identity = this.displayMessageIdentity(message);\n        if (seen.has(identity)) {\n          continue;\n        }\n        seen.add(identity);\n        messages.push(message);\n      }\n    }\n    return messages;\n  }\n\n  private paginateDisplayMessages(\n    messages: AgentMessage[],\n    options: {\n      offset?: number;\n      limit?: number;\n      beforeEndIndex?: number;\n    } = {},\n  ): { messages: AgentMessage[]; total: number; startIndex: number; endIndex: number } {\n    const total = messages.length;\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n\n    let startIndex: number;\n    let endIndex: number;\n    if (options.beforeEndIndex !== undefined && Number.isFinite(options.beforeEndIndex)) {\n      endIndex = Math.min(total, Math.max(0, Math.trunc(options.beforeEndIndex)));\n      startIndex = Math.max(0, endIndex - limit);\n    } else {\n      endIndex = Math.max(0, total - offset);\n      startIndex = Math.max(0, endIndex - limit);\n    }\n\n    return {\n      messages: messages.slice(startIndex, endIndex),\n      total,\n      startIndex,\n      endIndex,\n    };\n  }\n\n  private displayMessageIdentity(message: AgentMessage): string {\n    const record = message as unknown as Record<string, unknown>;\n    return JSON.stringify({\n      role: message.role,\n      timestamp: record.timestamp,\n      toolCallId: record.toolCallId ?? record.tool_call_id,\n      toolName: record.toolName,\n      content: this.messageContent(message),\n    });\n  }\n\n  private messageContent(msg: AgentMessage): unknown {\n    return (msg as { content?: unknown }).content;\n  }\n\n  private isCompactionSummaryMessage(msg: AgentMessage): boolean {\n    if (msg.role !== 'user') {\n      return false;\n    }\n    const text = this.extractTextContent(this.messageContent(msg)).trim();\n    return /^\\[Previous conversation summary\\]/i.test(text);\n  }\n\n  private extractTextContent(content: unknown): string {\n    if (typeof content === 'string') {\n      return content;\n    }\n    if (Array.isArray(content)) {\n      const parts: string[] = [];\n      for (const item of content) {\n        if (typeof item !== 'object' || item === null || !('type' in item)) {\n          continue;\n        }\n        const c = item as { type?: string; text?: string; name?: string };\n        if (c.type === 'text' && typeof c.text === 'string') {\n          parts.push(c.text);\n        } else if (c.type === 'toolCall' || c.type === 'tool_use') {\n          parts.push(c.name ? `[${c.name}]` : '');\n        }\n      }\n      return parts.join('');\n    }\n    return '';\n  }\n\n  private async injectPostCompactionContext(key: string): Promise<void> {\n    const contextText = readPostCompactionContext({\n      cfg: this.options.config,\n      sessionKey: key,\n    });\n    if (!contextText?.trim()) {\n      return;\n    }\n    try {\n      await this.appendTranscriptContextEntry(key, {\n        id: `post-compaction-${Date.now()}`,\n        text: contextText,\n        createdAt: new Date().toISOString(),\n      });\n    } catch (err) {\n      log.warn({ err, key }, 'Post-compaction context injection failed');\n    }\n  }\n\n  private convertMessages(messages: AgentMessage[]): Message[] {\n    return messages.map((m: AgentMessage & Record<string, unknown>) => {\n      const c = this.messageContent(m);\n      const content: string | unknown[] =\n        typeof c === 'string' ? c : Array.isArray(c) ? c : this.extractTextContent(c);\n      const row: Message = {\n        role: m.role as Message['role'],\n        content,\n        timestamp: m.timestamp ? new Date(m.timestamp as string | number).toISOString() : undefined,\n        tool_call_id: (m.tool_call_id as string | undefined) || (m.toolCallId as string | undefined),\n        tool_calls: m.tool_calls as Message['tool_calls'],\n        name: m.name as string | undefined,\n      };\n      if (Array.isArray(m.media) && m.media.length > 0) {\n        row.media = m.media as Message['media'];\n      }\n      const rawUsage = m.usage as {\n        input?: number;\n        output?: number;\n        cacheRead?: number;\n        cacheWrite?: number;\n        totalTokens?: number;\n        total?: number;\n      } | undefined;\n      if (rawUsage && typeof rawUsage === 'object') {\n        const inputTokens = typeof rawUsage.input === 'number' ? rawUsage.input : undefined;\n        const outputTokens = typeof rawUsage.output === 'number' ? rawUsage.output : undefined;\n        const cacheReadTokens = typeof rawUsage.cacheRead === 'number' ? rawUsage.cacheRead : undefined;\n        const cacheWriteTokens = typeof rawUsage.cacheWrite === 'number' ? rawUsage.cacheWrite : undefined;\n        const totalTokens = typeof rawUsage.totalTokens === 'number'\n          ? rawUsage.totalTokens\n          : typeof rawUsage.total === 'number'\n            ? rawUsage.total\n            : undefined;\n        if (\n          inputTokens !== undefined ||\n          outputTokens !== undefined ||\n          cacheReadTokens !== undefined ||\n          cacheWriteTokens !== undefined ||\n          totalTokens !== undefined\n        ) {\n          row.usage = {\n            inputTokens,\n            outputTokens,\n            cacheReadTokens,\n            cacheWriteTokens,\n            totalTokens,\n          };\n        }\n      }\n      return row;\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/session/store.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { readPostCompactionContext } from '../agent/reply/post-compaction-context.js';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionCompactor, type CompactionConfig, type CompactionResult } from '../agent/memory/compaction.js';\nimport { SlidingWindow, type WindowConfig } from '../agent/memory/window.js';\nimport {\n  requireXopcDatabase,\n  appendTranscriptEntry,\n  captureCompactionCheckpoint,\n  deleteSessionRecord,\n  ensureSessionRecord,\n  estimateTokensFromMessages,\n  getCompactionCheckpointDetail,\n  getGlobalSessionStats,\n  getSessionMetadata,\n  findSessionKeyBySessionId,\n  listCompactionCheckpoints,\n  listSessionMetadata,\n  listSessionsByAgent,\n  loadCheckpointRows,\n  loadLlmMessagesForSession,\n  loadTranscriptRowsForSession,\n  patchSessionMetadata,\n  replaceTranscriptRows,\n  resetSessionRecord,\n  restoreCompactionCheckpoint,\n  type SessionMetadataSeed,\n} from '../storage/sqlite/index.js';\nimport type { TranscriptCompactionRecord, XopcSessionTranscriptV1 } from './transcript-format.js';\nimport {\n  buildSessionDisplayMessages,\n  buildSessionContextForLlm,\n  mergeLlmMessagesPreservingContextRows,\n  transcriptRowsFromJsonArray,\n  type TranscriptStoredRow,\n  type XopcTranscriptContextEntry,\n  type XopcTranscriptCustomMessageEntry,\n  type XopcTranscriptCustomStateEntry,\n} from './session-context-for-llm.js';\nimport { normalizeCompactionCheckpointId } from './compaction-checkpoints.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionExport,\n  SessionTranscriptSummary,\n  CompactionCheckpointSummary,\n  CompactionCheckpointDetail,\n} from './types.js';\nimport { SessionStatus } from './types.js';\nimport type { Message } from './types.js';\nimport type { SessionTranscriptUpdate } from './transcript-events.js';\nimport { isAppendOnlyLlmTranscriptMessage } from './transcript-stats.js';\n\nconst log = createLogger('SessionStore');\n\nconst INDEX_VERSION = '1.0';\n\nexport interface SessionStoreOptions {\n  config: Config;\n}\n\nexport class SessionStore {\n  private window: SlidingWindow;\n  private compactor: SessionCompactor;\n\n  constructor(\n    private options: SessionStoreOptions,\n    windowConfig?: Partial<WindowConfig>,\n    compactionConfig?: Partial<CompactionConfig>,\n  ) {\n    this.window = new SlidingWindow(windowConfig);\n    this.compactor = new SessionCompactor(compactionConfig);\n  }\n\n  private resolveWorkspaceCwd(sessionKey: string): string {\n    return resolveEffectiveAgentProfileForSession(this.options.config, sessionKey).resolvedWorkspacePath;\n  }\n\n  private async runStoreMutation<T>(fn: () => Promise<T>): Promise<T> {\n    return fn();\n  }\n\n  async initialize(): Promise<void> {\n    requireXopcDatabase();\n    log.debug('Session store initialized (SQLite)');\n  }\n\n  getSessionsRoot(): string {\n    return resolveStateDir();\n  }\n\n  async resolveTranscriptPath(\n    sessionKey: string,\n    options?: { metadata?: SessionMetadataSeed },\n  ): Promise<{ sessionId: string; sessionKey: string }> {\n    requireXopcDatabase();\n    const cwd = this.resolveWorkspaceCwd(sessionKey);\n    const meta = ensureSessionRecord(sessionKey, cwd, options?.metadata);\n    return { sessionId: meta.sessionId!, sessionKey };\n  }\n\n  async appendTranscriptMessage(\n    sessionKey: string,\n    message: AgentMessage,\n    options?: { metadata?: SessionMetadataSeed },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd, options?.metadata);\n      appendTranscriptEntry(sessionKey, message);\n    });\n  }\n\n  async getByAgent(agentId: string): Promise<SessionMetadata[]> {\n    requireXopcDatabase();\n    return listSessionsByAgent(agentId);\n  }\n\n  async getByAccount(accountId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.accountId === accountId);\n  }\n\n  async getByPeer(peerKind: string, peerId: string): Promise<SessionMetadata[]> {\n    const { items } = await this.list({ limit: 100_000 });\n    return items.filter((m) => m.routing?.peerKind === peerKind && m.routing.peerId === peerId);\n  }\n\n  async getMainSession(channel: string, accountId: string): Promise<SessionMetadata | null> {\n    const { items } = await this.list({ limit: 100_000 });\n    return (\n      items.find(\n        (m) =>\n          m.routing?.source === channel &&\n          m.routing.accountId === accountId &&\n          m.routing.peerKind === 'dm' &&\n          m.routing.peerId === 'main',\n      ) ?? null\n    );\n  }\n\n  async refreshIndex(): Promise<void> {\n    /* no-op: SQLite is authoritative */\n  }\n\n  async list(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    requireXopcDatabase();\n    return listSessionMetadata(query);\n  }\n\n  async get(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n    const messages = await this.loadDisplayMessages(key);\n    return this.buildSessionDetail(key, metadata, messages, options);\n  }\n\n  async getMessagePage(\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 metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return null;\n    }\n\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n    const parsedBefore = options.before ? Number.parseInt(options.before, 10) : undefined;\n    const hasBeforeCursor = parsedBefore !== undefined && Number.isFinite(parsedBefore);\n\n    const displayMessages = await this.loadDisplayMessages(key);\n    const page = this.paginateDisplayMessages(displayMessages, {\n      limit,\n      offset: hasBeforeCursor ? undefined : offset,\n      beforeEndIndex: hasBeforeCursor ? parsedBefore : undefined,\n    });\n\n    const session = await this.buildSessionDetail(key, metadata, page.messages, options);\n    const nextBeforeCursor = page.startIndex > 0 ? String(page.startIndex) : undefined;\n\n    return {\n      session,\n      pagination: {\n        total: page.total,\n        limit,\n        offset,\n        hasMore: hasBeforeCursor ? page.startIndex > 0 : offset + limit < page.total,\n        ...(hasBeforeCursor ? { before: String(page.endIndex) } : {}),\n        ...(nextBeforeCursor ? { nextBeforeCursor } : {}),\n      },\n    };\n  }\n\n  private async buildSessionDetail(\n    key: string,\n    metadata: SessionMetadata,\n    messages: AgentMessage[],\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail> {\n    let transcriptSummary: SessionTranscriptSummary | undefined;\n    if (options?.includeTranscriptSummary) {\n      const env = await this.loadTranscriptDocument(key);\n      if (env) {\n        transcriptSummary = {\n          id: env.id,\n          version: env.version,\n          createdAt: env.createdAt,\n          updatedAt: env.updatedAt,\n          compactionCount: env.compactions?.length ?? 0,\n        };\n      }\n    }\n    let transcriptRows: TranscriptStoredRow[] | undefined;\n    if (options?.includeTranscriptRows) {\n      transcriptRows = await this.loadTranscriptRows(key);\n    }\n    return {\n      ...metadata,\n      messages: this.convertMessages(messages),\n      ...(transcriptSummary ? { transcriptSummary } : {}),\n      ...(transcriptRows !== undefined ? { transcriptRows } : {}),\n    };\n  }\n\n  async loadTranscriptRows(key: string): Promise<TranscriptStoredRow[]> {\n    requireXopcDatabase();\n    return loadTranscriptRowsForSession(key);\n  }\n\n  async getMetadata(key: string): Promise<SessionMetadata | null> {\n    requireXopcDatabase();\n    return getSessionMetadata(key);\n  }\n\n  async resolveKeyBySessionId(sessionId: string): Promise<string | null> {\n    requireXopcDatabase();\n    return findSessionKeyBySessionId(sessionId);\n  }\n\n  async updateMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      patchSessionMetadata(key, updates);\n      log.debug({ key, updates }, 'Session metadata updated');\n    });\n  }\n\n  async reset(key: string): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      const outcome = resetSessionRecord(key, cwd);\n      if (outcome) {\n        log.info({ key, ...outcome }, 'Session reset');\n      }\n      return outcome;\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const ok = deleteSessionRecord(key);\n      if (ok) {\n        log.info({ key }, 'Session deleted');\n      }\n      return ok;\n    });\n  }\n\n  async deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const success: string[] = [];\n    const failed: string[] = [];\n    for (const key of keys) {\n      try {\n        if (await this.delete(key)) {\n          success.push(key);\n        } else {\n          failed.push(key);\n        }\n      } catch {\n        failed.push(key);\n      }\n    }\n    return { success, failed };\n  }\n\n  async setStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.updateMetadata(key, { status });\n  }\n\n  async archive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ARCHIVED);\n  }\n\n  async unarchive(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async pin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.PINNED);\n  }\n\n  async unpin(key: string): Promise<void> {\n    await this.setStatus(key, SessionStatus.ACTIVE);\n  }\n\n  async loadMessages(_key: string, _options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    return loadLlmMessagesForSession(_key);\n  }\n\n  async loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata?.sessionId) {\n      return null;\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const compactions: TranscriptCompactionRecord[] = [];\n    for (const row of rows) {\n      if ((row as { type?: string }).type === 'compaction') {\n        const c = row as unknown as TranscriptCompactionRecord & { type: 'compaction' };\n        compactions.push({\n          at: c.at ?? new Date().toISOString(),\n          summary: c.summary ?? '',\n          firstKeptIndex: Number(c.firstKeptIndex ?? 0),\n          tokensBefore: c.tokensBefore ?? 0,\n          tokensAfter: (c as { tokensAfter?: number }).tokensAfter ?? 0,\n        });\n      }\n    }\n    return {\n      type: 'xopc_session_transcript',\n      version: 1,\n      id: metadata.sessionId,\n      createdAt: metadata.createdAt,\n      updatedAt: metadata.updatedAt,\n      messages: rows,\n      ...(compactions.length > 0 ? { compactions } : {}),\n    };\n  }\n\n  async syncEmbeddedTranscriptUpdate(update: SessionTranscriptUpdate): Promise<void> {\n    const sessionKey = update.sessionKey?.trim();\n    if (!sessionKey) {\n      return;\n    }\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(sessionKey);\n      ensureSessionRecord(sessionKey, cwd);\n\n      if (update.message && isAppendOnlyLlmTranscriptMessage(update.message)) {\n        appendTranscriptEntry(sessionKey, update.message as AgentMessage);\n      }\n    });\n  }\n\n  async appendTranscriptContextEntry(\n    key: string,\n    entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>,\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptContextEntry = {\n        kind: 'context',\n        id: typeof entry.id === 'string' ? entry.id : undefined,\n        text: typeof entry.text === 'string' ? entry.text : undefined,\n        data: entry.data,\n        createdAt: entry.createdAt ?? new Date().toISOString(),\n      };\n      appendTranscriptEntry(key, row);\n    });\n  }\n\n  async appendTranscriptLabelEntry(\n    key: string,\n    entry: { targetId: string; label?: string },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      appendTranscriptEntry(key, {\n        type: 'label',\n        targetId: entry.targetId,\n        label: entry.label?.trim() || undefined,\n        timestamp: new Date().toISOString(),\n      });\n    });\n  }\n\n  async appendTranscriptCustomEntry(\n    key: string,\n    entry: { customType: string; data?: unknown },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptCustomStateEntry = {\n        type: 'custom',\n        customType: entry.customType.trim(),\n        data: entry.data,\n        timestamp: new Date().toISOString(),\n      };\n      appendTranscriptEntry(key, row);\n    });\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    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      const row: XopcTranscriptCustomMessageEntry = {\n        role: 'custom',\n        customType: entry.customType.trim(),\n        content: entry.content ?? '',\n        display: entry.display ?? true,\n        details: entry.details,\n        timestamp: Date.now(),\n      };\n      appendTranscriptEntry(key, row);\n    });\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    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd);\n      appendTranscriptEntry(key, {\n        role: 'bashExecution',\n        command: entry.command,\n        output: entry.output ?? '',\n        exitCode: entry.exitCode ?? null,\n        signal: entry.signal ?? null,\n        excludeFromContext: entry.excludeFromContext === true,\n        truncated: entry.truncated === true,\n        fullOutputPath: entry.fullOutputPath,\n        timestamp: Date.now(),\n      });\n    });\n  }\n\n  async saveMessages(\n    key: string,\n    messages: AgentMessage[],\n    options?: { metadata?: SessionMetadataSeed },\n  ): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const cwd = this.resolveWorkspaceCwd(key);\n      ensureSessionRecord(key, cwd, options?.metadata);\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, messages);\n      replaceTranscriptRows(key, merged);\n    });\n  }\n\n  getWindowStats(messages: AgentMessage[]) {\n    return this.window.getStats(messages);\n  }\n\n  needsCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    return this.compactor.needsCompaction(messages, contextWindow);\n  }\n\n  prepareCompaction(key: string, messages: AgentMessage[], contextWindow: number) {\n    const result = this.compactor.needsCompaction(messages, contextWindow);\n    return { needsCompaction: result.needed, messages, stats: result };\n  }\n\n  async applyCompaction(\n    key: string,\n    messages: AgentMessage[],\n    result: CompactionResult,\n  ): Promise<AgentMessage[]> {\n    const compacted = this.compactor.applyCompaction(messages, result);\n    return this.runStoreMutation(async () => {\n      const prev = await this.loadTranscriptRows(key);\n      const merged = mergeLlmMessagesPreservingContextRows(prev, compacted);\n      captureCompactionCheckpoint(key);\n      replaceTranscriptRows(key, merged, {\n        appendCompaction: {\n          at: new Date().toISOString(),\n          summary: result.summary,\n          firstKeptIndex: result.firstKeptIndex,\n          tokensBefore: result.tokensBefore,\n          tokensAfter: result.tokensAfter,\n        },\n      });\n      const metadata = await this.getMetadata(key);\n      if (metadata) {\n        await this.updateMetadata(key, { compactedCount: metadata.compactedCount + 1 });\n      }\n      log.info(\n        { key, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter, keptMessages: compacted.length },\n        'Session compacted',\n      );\n      await this.injectPostCompactionContext(key);\n      return compacted;\n    });\n  }\n\n  async compact(\n    key: string,\n    messages: AgentMessage[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    void contextWindow;\n    const result = await this.compactor.compact(messages, instructions, force);\n    if (result.compacted) {\n      await this.applyCompaction(key, messages, result);\n    }\n    return result;\n  }\n\n  async getCompactionStats(key: string) {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      return undefined;\n    }\n    return {\n      compactionCount: metadata.compactedCount,\n      totalTokensBefore: 0,\n      totalTokensAfter: 0,\n      lastCompactionAt: undefined,\n    };\n  }\n\n  async listCompactionCheckpoints(key: string): Promise<CompactionCheckpointSummary[]> {\n    requireXopcDatabase();\n    return listCompactionCheckpoints(key);\n  }\n\n  async getCompactionCheckpointDetail(\n    key: string,\n    checkpointId: string,\n  ): Promise<CompactionCheckpointDetail | null> {\n    requireXopcDatabase();\n    const id = normalizeCompactionCheckpointId(checkpointId);\n    if (!id) {\n      return null;\n    }\n    return getCompactionCheckpointDetail(key, id);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const id = normalizeCompactionCheckpointId(checkpointId);\n      if (!id) {\n        throw new Error(`Invalid checkpoint id: ${checkpointId}`);\n      }\n      restoreCompactionCheckpoint(key, id);\n    });\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    return this.delete(key);\n  }\n\n  async load(key: string, options?: { fromArchive?: boolean }): Promise<AgentMessage[]> {\n    return this.loadMessages(key, options);\n  }\n\n  async estimateTokenUsage(_key: string, messages: AgentMessage[]): Promise<number> {\n    return this.estimateTokens(messages);\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    const messages = await this.loadDisplayMessages(key);\n    const q = keyword.toLowerCase();\n    return this.convertMessages(\n      messages.filter((m) => this.extractTextContent(this.messageContent(m)).toLowerCase().includes(q)),\n    );\n  }\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    const metadata = await this.getMetadata(key);\n    if (!metadata) {\n      throw new Error(`Session not found: ${key}`);\n    }\n    const rows = await this.loadTranscriptRows(key);\n    const messages = this.convertMessages(buildSessionContextForLlm(rows));\n    const payload: SessionExport = {\n      version: INDEX_VERSION,\n      exportedAt: new Date().toISOString(),\n      metadata,\n      messages,\n      transcriptRows: rows,\n    };\n    if (format === 'json') {\n      return JSON.stringify(payload, null, 2);\n    }\n    const lines = [`# ${metadata.name ?? metadata.key}`, '', `Exported: ${payload.exportedAt}`, ''];\n    for (const msg of messages) {\n      lines.push(`## ${msg.role}`, '', typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content), '');\n    }\n    return lines.join('\\n');\n  }\n\n  async importSessionExport(\n    targetKey: string,\n    jsonContent: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const existing = await this.getMetadata(targetKey);\n      if (existing) {\n        throw new Error(`Target session already exists: ${targetKey}`);\n      }\n\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(jsonContent);\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        throw new Error(`Invalid session export JSON: ${errorMessage}`);\n      }\n\n      const record = parsed && typeof parsed === 'object' ? parsed as Record<string, unknown> : {};\n      const rowsSource = Array.isArray(record.transcriptRows) ? record.transcriptRows : undefined;\n      const rows = rowsSource ? transcriptRowsFromJsonArray(rowsSource) : [];\n      if (rows.length === 0) {\n        throw new Error('Session export contains no importable transcript rows');\n      }\n\n      const metadata = record.metadata && typeof record.metadata === 'object'\n        ? record.metadata as Partial<SessionMetadata>\n        : {};\n      const cwd = this.resolveWorkspaceCwd(targetKey);\n      ensureSessionRecord(targetKey, cwd, {\n        sourceChannel: metadata.sourceChannel,\n        sourceChatId: metadata.sourceChatId,\n        sessionType: metadata.sessionType,\n        routing: metadata.routing,\n        customData: metadata.customData,\n      });\n      replaceTranscriptRows(targetKey, rows);\n\n      const sourceKey = typeof metadata.key === 'string' ? metadata.key : undefined;\n      const sourceName = typeof metadata.name === 'string' ? metadata.name.trim() : '';\n      patchSessionMetadata(targetKey, {\n        name: sourceName ? `Import of ${sourceName}` : 'Imported session',\n        tags: [...new Set([...(Array.isArray(metadata.tags) ? metadata.tags.filter((tag): tag is string => typeof tag === 'string') : []), 'import'])],\n        customData: {\n          ...(metadata.customData && typeof metadata.customData === 'object'\n            ? metadata.customData as Record<string, unknown>\n            : {}),\n          ...(sourceKey ? { importedFromSessionKey: sourceKey } : {}),\n          importedAt: new Date().toISOString(),\n        },\n      });\n      return { sessionKey: targetKey, rowCount: rows.length };\n    });\n  }\n\n  async forkSession(\n    sourceKey: string,\n    targetKey: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.forkSessionRows(sourceKey, targetKey);\n  }\n\n  async forkSessionRows(\n    sourceKey: string,\n    targetKey: string,\n    options: { throughRow?: number } = {},\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.runStoreMutation(async () => {\n      requireXopcDatabase();\n      const sourceMetadata = await this.getMetadata(sourceKey);\n      if (!sourceMetadata) {\n        throw new Error(`Session not found: ${sourceKey}`);\n      }\n      const existing = await this.getMetadata(targetKey);\n      if (existing) {\n        throw new Error(`Target session already exists: ${targetKey}`);\n      }\n      const rows = await this.loadTranscriptRows(sourceKey);\n      if (\n        options.throughRow !== undefined &&\n        (options.throughRow < 1 || options.throughRow > rows.length)\n      ) {\n        throw new Error(`Invalid fork row: ${options.throughRow}`);\n      }\n      const selectedRows =\n        options.throughRow === undefined ? rows : rows.slice(0, Math.max(0, Math.trunc(options.throughRow)));\n      const cwd = this.resolveWorkspaceCwd(targetKey);\n      ensureSessionRecord(targetKey, cwd, {\n        sourceChannel: sourceMetadata.sourceChannel,\n        sourceChatId: sourceMetadata.sourceChatId,\n        sessionType: sourceMetadata.sessionType,\n        routing: sourceMetadata.routing,\n        customData: sourceMetadata.customData,\n      });\n      replaceTranscriptRows(targetKey, selectedRows);\n      const label = sourceMetadata.name?.trim() || sourceKey;\n      patchSessionMetadata(targetKey, {\n        name: `Fork of ${label}`,\n        tags: [...new Set([...(sourceMetadata.tags ?? []), 'fork'])],\n        customData: {\n          ...(sourceMetadata.customData ?? {}),\n          forkedFromSessionKey: sourceKey,\n          forkedFromSessionId: sourceMetadata.sessionId,\n          ...(options.throughRow !== undefined ? { forkedFromRow: selectedRows.length } : {}),\n          forkedAt: new Date().toISOString(),\n        },\n      });\n      return { sessionKey: targetKey, rowCount: selectedRows.length };\n    });\n  }\n\n  async getStats(): Promise<GlobalSessionStats> {\n    requireXopcDatabase();\n    return getGlobalSessionStats();\n  }\n\n  async archiveOld(olderThanDays: number): Promise<number> {\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - olderThanDays);\n    const list = await this.list({ limit: 100_000 });\n    let archived = 0;\n    for (const session of list.items) {\n      if (session.status !== SessionStatus.ARCHIVED && session.status !== SessionStatus.PINNED) {\n        const lastAccess = new Date(session.lastAccessedAt);\n        if (lastAccess < cutoff) {\n          await this.archive(session.key);\n          archived++;\n        }\n      }\n    }\n    return archived;\n  }\n\n  estimateTokens(messages: AgentMessage[]): number {\n    return estimateTokensFromMessages(messages);\n  }\n\n  private async loadDisplayMessages(key: string): Promise<AgentMessage[]> {\n    requireXopcDatabase();\n    const checkpoints = listCompactionCheckpoints(key);\n    const rowSets: TranscriptStoredRow[][] = [];\n    for (const checkpoint of [...checkpoints].reverse()) {\n      rowSets.push(loadCheckpointRows(key, checkpoint.id));\n    }\n    rowSets.push(await this.loadTranscriptRows(key));\n\n    const messages: AgentMessage[] = [];\n    const seen = new Set<string>();\n    for (const rows of rowSets) {\n      for (const message of buildSessionDisplayMessages(rows)) {\n        if (this.isCompactionSummaryMessage(message)) {\n          continue;\n        }\n        const identity = this.displayMessageIdentity(message);\n        if (seen.has(identity)) {\n          continue;\n        }\n        seen.add(identity);\n        messages.push(message);\n      }\n    }\n    return messages;\n  }\n\n  private paginateDisplayMessages(\n    messages: AgentMessage[],\n    options: {\n      offset?: number;\n      limit?: number;\n      beforeEndIndex?: number;\n    } = {},\n  ): { messages: AgentMessage[]; total: number; startIndex: number; endIndex: number } {\n    const total = messages.length;\n    const limit = Math.min(200, Math.max(1, Math.trunc(options.limit ?? 50)));\n    const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n\n    let startIndex: number;\n    let endIndex: number;\n    if (options.beforeEndIndex !== undefined && Number.isFinite(options.beforeEndIndex)) {\n      endIndex = Math.min(total, Math.max(0, Math.trunc(options.beforeEndIndex)));\n      startIndex = Math.max(0, endIndex - limit);\n    } else {\n      endIndex = Math.max(0, total - offset);\n      startIndex = Math.max(0, endIndex - limit);\n    }\n\n    return {\n      messages: messages.slice(startIndex, endIndex),\n      total,\n      startIndex,\n      endIndex,\n    };\n  }\n\n  private displayMessageIdentity(message: AgentMessage): string {\n    const record = message as unknown as Record<string, unknown>;\n    return JSON.stringify({\n      role: message.role,\n      timestamp: record.timestamp,\n      toolCallId: record.toolCallId ?? record.tool_call_id,\n      toolName: record.toolName,\n      content: this.messageContent(message),\n    });\n  }\n\n  private messageContent(msg: AgentMessage): unknown {\n    return (msg as { content?: unknown }).content;\n  }\n\n  private isCompactionSummaryMessage(msg: AgentMessage): boolean {\n    if (msg.role !== 'user') {\n      return false;\n    }\n    const text = this.extractTextContent(this.messageContent(msg)).trim();\n    return /^\\[Previous conversation summary\\]/i.test(text);\n  }\n\n  private extractTextContent(content: unknown): string {\n    if (typeof content === 'string') {\n      return content;\n    }\n    if (Array.isArray(content)) {\n      const parts: string[] = [];\n      for (const item of content) {\n        if (typeof item !== 'object' || item === null || !('type' in item)) {\n          continue;\n        }\n        const c = item as { type?: string; text?: string; name?: string };\n        if (c.type === 'text' && typeof c.text === 'string') {\n          parts.push(c.text);\n        } else if (c.type === 'toolCall' || c.type === 'tool_use') {\n          parts.push(c.name ? `[${c.name}]` : '');\n        }\n      }\n      return parts.join('');\n    }\n    return '';\n  }\n\n  private async injectPostCompactionContext(key: string): Promise<void> {\n    const contextText = readPostCompactionContext({\n      cfg: this.options.config,\n      sessionKey: key,\n    });\n    if (!contextText?.trim()) {\n      return;\n    }\n    try {\n      await this.appendTranscriptContextEntry(key, {\n        id: `post-compaction-${Date.now()}`,\n        text: contextText,\n        createdAt: new Date().toISOString(),\n      });\n    } catch (err) {\n      log.warn({ err, key }, 'Post-compaction context injection failed');\n    }\n  }\n\n  private convertMessages(messages: AgentMessage[]): Message[] {\n    return messages.map((m: AgentMessage & Record<string, unknown>) => {\n      const c = this.messageContent(m);\n      const content: string | unknown[] =\n        typeof c === 'string' ? c : Array.isArray(c) ? c : this.extractTextContent(c);\n      const row: Message = {\n        role: m.role as Message['role'],\n        content,\n        timestamp: m.timestamp ? new Date(m.timestamp as string | number).toISOString() : undefined,\n        tool_call_id: (m.tool_call_id as string | undefined) || (m.toolCallId as string | undefined),\n        tool_calls: m.tool_calls as Message['tool_calls'],\n        name: m.name as string | undefined,\n      };\n      if (Array.isArray(m.media) && m.media.length > 0) {\n        row.media = m.media as Message['media'];\n      }\n      const rawUsage = m.usage as {\n        input?: number;\n        output?: number;\n        cacheRead?: number;\n        cacheWrite?: number;\n        totalTokens?: number;\n        total?: number;\n      } | undefined;\n      if (rawUsage && typeof rawUsage === 'object') {\n        const inputTokens = typeof rawUsage.input === 'number' ? rawUsage.input : undefined;\n        const outputTokens = typeof rawUsage.output === 'number' ? rawUsage.output : undefined;\n        const cacheReadTokens = typeof rawUsage.cacheRead === 'number' ? rawUsage.cacheRead : undefined;\n        const cacheWriteTokens = typeof rawUsage.cacheWrite === 'number' ? rawUsage.cacheWrite : undefined;\n        const totalTokens = typeof rawUsage.totalTokens === 'number'\n          ? rawUsage.totalTokens\n          : typeof rawUsage.total === 'number'\n            ? rawUsage.total\n            : undefined;\n        if (\n          inputTokens !== undefined ||\n          outputTokens !== undefined ||\n          cacheReadTokens !== undefined ||\n          cacheWriteTokens !== undefined ||\n          totalTokens !== undefined\n        ) {\n          row.usage = {\n            inputTokens,\n            outputTokens,\n            cacheReadTokens,\n            cacheWriteTokens,\n            totalTokens,\n          };\n        }\n      }\n      return row;\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/src/storage/sqlite/migrations/022_work_items.sql

@@ -0,0 +1,61 @@
+CREATE TABLE IF NOT EXISTS work_items (
+  id              TEXT PRIMARY KEY,
+  project_id      TEXT NOT NULL,
+  title           TEXT NOT NULL,
+  description     TEXT,
+  status          TEXT NOT NULL,
+  priority        TEXT NOT NULL DEFAULT 'normal',
+  owner_agent_id  TEXT,
+  next_action     TEXT,
+  blocked_reason  TEXT,
+  due_at          INTEGER,
+  completed_at    INTEGER,
+  archived_at     INTEGER,
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_items_project_status
+  ON work_items(project_id, status, archived_at, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS work_item_links (
+  id               TEXT PRIMARY KEY,
+  work_item_id     TEXT NOT NULL,
+  kind             TEXT NOT NULL,
+  target_id        TEXT NOT NULL,
+  title            TEXT,
+  status_snapshot  TEXT,
+  created_at       INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_links_item
+  ON work_item_links(work_item_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS work_item_events (
+  id            TEXT PRIMARY KEY,
+  work_item_id  TEXT NOT NULL,
+  type          TEXT NOT NULL,
+  payload_json  TEXT,
+  created_at    INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_events_item
+  ON work_item_events(work_item_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS work_item_update_suggestions (
+  id             TEXT PRIMARY KEY,
+  work_item_id   TEXT NOT NULL,
+  source_kind    TEXT NOT NULL,
+  source_id      TEXT NOT NULL,
+  status         TEXT NOT NULL,
+  patch_json     TEXT NOT NULL DEFAULT '{}',
+  progress_note  TEXT,
+  rationale      TEXT,
+  confidence     REAL,
+  created_at     INTEGER NOT NULL,
+  applied_at     INTEGER,
+  dismissed_at   INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_update_suggestions_item
+  ON work_item_update_suggestions(work_item_id, status, created_at DESC);

package/dist/src/storage/sqlite/migrations/023_work_item_attachments.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS work_item_attachments (
+  id            TEXT PRIMARY KEY,
+  work_item_id  TEXT NOT NULL,
+  media_uri     TEXT NOT NULL,
+  media_id      TEXT NOT NULL,
+  bucket        TEXT NOT NULL,
+  type          TEXT NOT NULL,
+  mime_type     TEXT NOT NULL,
+  file_name     TEXT NOT NULL,
+  size          INTEGER NOT NULL,
+  created_at    INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_attachments_item
+  ON work_item_attachments(work_item_id, created_at DESC);

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 21;
+export declare const XOPC_DB_SCHEMA_VERSION = 23;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 21;
+const XOPC_DB_SCHEMA_VERSION = 23;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 21;
+	const targetVersion = options.targetVersion ?? 23;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 21;
+	const appVersion = options.targetVersion ?? 23;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 21;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 23;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 21;
+export const XOPC_DB_SCHEMA_VERSION = 23;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 21 });
+	applyPendingMigrations(db, { targetVersion: 23 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };