@xopcai/xopc 0.0.125 → 0.0.127

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

@@ -1 +1 @@
-{"version":3,"file":"client-history.js","names":[],"sources":["../../../src/session/client-history.ts"],"sourcesContent":["import type { Message } from './types.js';\nimport type { TranscriptStoredRow } from './session-context-for-llm.js';\n\n/** Transcript row for TUI and HTTP clients (flattened from persisted session messages). */\nexport interface ClientHistoryMessage {\n  id?: string;\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n  rawContent?: string | unknown[];\n  timestamp?: number;\n  kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';\n  tokensBefore?: number;\n  tokensAfter?: number;\n  bash?: {\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  custom?: {\n    customType: string;\n    details?: unknown;\n    state?: boolean;\n    display?: boolean;\n  };\n  branch?: {\n    summary: string;\n    fromId?: string;\n  };\n  toolCalls?: Array<{ name: string; args?: unknown; result?: string; isError?: boolean }>;\n}\n\nexport function flattenMessageContent(content: string | unknown[]): string {\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return '';\n  const parts: string[] = [];\n  for (const block of content) {\n    if (typeof block !== 'object' || block === null) continue;\n    const b = block as Record<string, unknown>;\n    if (b.type === 'text' && typeof b.text === 'string') {\n      parts.push(b.text);\n    }\n  }\n  return parts.join('');\n}\n\nfunction parseTimestamp(ts: string | undefined): number | undefined {\n  if (!ts) return undefined;\n  const ms = Date.parse(ts);\n  return Number.isFinite(ms) ? ms : undefined;\n}\n\nfunction safeJsonParseArguments(raw: string): unknown {\n  const t = raw.trim();\n  if (!t) return undefined;\n  try {\n    return JSON.parse(t) as unknown;\n  } catch {\n    return raw;\n  }\n}\n\nfunction collectToolResults(messages: Message[]): Map<string, { text: string; isError?: boolean }> {\n  const map = new Map<string, { text: string; isError?: boolean }>();\n  for (const m of messages) {\n    if (m.role !== 'tool' && m.role !== 'toolResult') continue;\n    const id = m.tool_call_id;\n    if (!id || typeof id !== 'string') continue;\n    map.set(id, {\n      text: flattenMessageContent(m.content),\n      isError: m.isError,\n    });\n  }\n  return map;\n}\n\nfunction toolCallsWithResults(\n  tool_calls: Message['tool_calls'],\n  results: Map<string, { text: string; isError?: boolean }>,\n): ClientHistoryMessage['toolCalls'] | undefined {\n  if (!tool_calls?.length) return undefined;\n  const out: NonNullable<ClientHistoryMessage['toolCalls']> = [];\n  for (const tc of tool_calls) {\n    const res = results.get(tc.id);\n    out.push({\n      name: tc.function.name,\n      args: safeJsonParseArguments(tc.function.arguments),\n      result: res?.text,\n      isError: res?.isError,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\n/**\n * Maps gateway/session API messages into a linear chat history for clients.\n * Tool / toolResult rows are merged into assistant `toolCalls` when ids match; otherwise skipped.\n */\nexport function messagesToClientHistory(\n  messages: Message[],\n  opts?: { limit?: number },\n): ClientHistoryMessage[] {\n  const slice =\n    opts?.limit !== undefined && messages.length > opts.limit\n      ? messages.slice(-opts.limit)\n      : messages;\n\n  const results = collectToolResults(slice);\n  const out: ClientHistoryMessage[] = [];\n\n  for (const m of slice) {\n    if (m.role === 'tool' || m.role === 'toolResult') {\n      continue;\n    }\n\n    if (m.role === 'user' || m.role === 'system') {\n      const text = flattenMessageContent(m.content);\n      out.push({\n        role: m.role,\n        content: text,\n        timestamp: parseTimestamp(m.timestamp),\n      });\n      continue;\n    }\n\n    if (m.role === 'assistant') {\n      const text = flattenMessageContent(m.content);\n      const toolCalls = toolCallsWithResults(m.tool_calls, results);\n      out.push({\n        role: 'assistant',\n        content: text,\n        timestamp: parseTimestamp(m.timestamp),\n        toolCalls,\n      });\n    }\n  }\n\n  return out;\n}\n\ntype HistoryMessageRow = {\n  role: 'system' | 'user' | 'assistant' | 'tool' | 'toolResult';\n  content?: string | unknown[];\n  timestamp?: string | number;\n  tool_call_id?: string;\n  toolCallId?: string;\n  tool_calls?: Message['tool_calls'];\n  toolCalls?: Message['tool_calls'];\n  isError?: boolean;\n};\n\nfunction asHistoryMessageRow(row: TranscriptStoredRow): HistoryMessageRow | null {\n  const role = (row as { role?: unknown }).role;\n  if (\n    typeof role !== 'string' ||\n    !['system', 'user', 'assistant', 'tool', 'toolResult'].includes(role)\n  ) {\n    return null;\n  }\n  return row as unknown as HistoryMessageRow;\n}\n\nfunction parseTimestampValue(ts: string | number | undefined): number | undefined {\n  if (typeof ts === 'number') return Number.isFinite(ts) ? ts : undefined;\n  return parseTimestamp(ts);\n}\n\nfunction collectHistoryToolResults(messages: HistoryMessageRow[]): Map<string, { text: string; isError?: boolean }> {\n  const map = new Map<string, { text: string; isError?: boolean }>();\n  for (const m of messages) {\n    if (m.role !== 'tool' && m.role !== 'toolResult') continue;\n    const id = m.tool_call_id ?? m.toolCallId;\n    if (!id || typeof id !== 'string') continue;\n    map.set(id, {\n      text: flattenMessageContent(m.content ?? ''),\n      isError: m.isError,\n    });\n  }\n  return map;\n}\n\nfunction isCompactionRow(row: TranscriptStoredRow): row is TranscriptStoredRow & {\n  type: 'compaction';\n  summary?: string;\n  at?: string;\n  tokensBefore?: number;\n  tokensAfter?: number;\n} {\n  return (row as { type?: unknown }).type === 'compaction';\n}\n\nfunction compactionSummaryRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'compactionSummary') return null;\n  const summary = optionalString(r.summary) ?? '';\n  return {\n    role: 'system',\n    kind: 'compaction',\n    content: summary,\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    tokensBefore: typeof r.tokensBefore === 'number' ? r.tokensBefore : undefined,\n  };\n}\n\nfunction contextRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  if ((row as { kind?: unknown }).kind !== 'context') return null;\n  const text = (row as { text?: unknown }).text;\n  if (typeof text !== 'string' || !text.trim()) return null;\n  const createdAt = (row as { createdAt?: unknown }).createdAt;\n  return {\n    role: 'system',\n    kind: 'context',\n    content: text,\n    timestamp: typeof createdAt === 'string' ? parseTimestamp(createdAt) : undefined,\n  };\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction bashRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'bashExecution') return null;\n\n  const command = optionalString(r.command) ?? optionalString(r.content)?.trim();\n  if (!command) return null;\n  const output = Array.isArray(r.output) || typeof r.output === 'string'\n    ? flattenMessageContent(r.output)\n    : optionalString(r.output);\n  const exitCode = typeof r.exitCode === 'number' ? r.exitCode : r.exitCode === null ? null : undefined;\n  const signal = typeof r.signal === 'string' ? r.signal : r.signal === null ? null : undefined;\n  const excludeFromContext =\n    typeof r.excludeFromContext === 'boolean'\n      ? r.excludeFromContext\n      : typeof r.excludedFromContext === 'boolean'\n        ? r.excludedFromContext\n        : undefined;\n\n  return {\n    role: 'system',\n    kind: 'bash',\n    content: output || command,\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    bash: {\n      command,\n      output,\n      exitCode,\n      signal,\n      excludeFromContext,\n      truncated: typeof r.truncated === 'boolean' ? r.truncated : undefined,\n      fullOutputPath: optionalString(r.fullOutputPath),\n    },\n  };\n}\n\nfunction customRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'custom' && r.type !== 'custom_message') return null;\n\n  const customType = optionalString(r.customType)?.trim();\n  if (!customType) return null;\n  const content = Array.isArray(r.content) || typeof r.content === 'string'\n    ? flattenMessageContent(r.content)\n    : '';\n  const timestamp = parseTimestampValue(\n    typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n  );\n\n  return {\n    role: 'system',\n    kind: 'custom',\n    content,\n    rawContent: Array.isArray(r.content) || typeof r.content === 'string' ? r.content : undefined,\n    timestamp,\n    custom: {\n      customType,\n      details: r.details,\n      display: r.display === false ? false : true,\n    },\n  };\n}\n\nfunction customStateRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.type !== 'custom') return null;\n\n  const customType = optionalString(r.customType)?.trim();\n  if (!customType) return null;\n  return {\n    role: 'system',\n    kind: 'custom',\n    content: '',\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    custom: {\n      customType,\n      details: r.data,\n      state: true,\n    },\n  };\n}\n\nfunction branchSummaryRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'branchSummary') return null;\n  const summary = optionalString(r.summary)?.trim();\n  if (!summary) return null;\n  const fromId = optionalString(r.fromId);\n\n  return {\n    role: 'system',\n    kind: 'branch',\n    content: summary,\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    branch: {\n      summary,\n      fromId,\n    },\n  };\n}\n\n/**\n * Maps persisted transcript rows into linear chat history, preserving non-LLM\n * audit rows that the TUI can render as dedicated components.\n */\nexport function transcriptRowsToClientHistory(\n  rows: TranscriptStoredRow[],\n  opts?: { limit?: number },\n): ClientHistoryMessage[] {\n  const startIndex =\n    opts?.limit !== undefined && rows.length > opts.limit\n      ? rows.length - opts.limit\n      : 0;\n  const slice =\n    opts?.limit !== undefined && rows.length > opts.limit\n      ? rows.slice(-opts.limit)\n      : rows;\n  const messages = slice\n    .map(asHistoryMessageRow)\n    .filter((row): row is HistoryMessageRow => row !== null);\n  const results = collectHistoryToolResults(messages);\n  const out: ClientHistoryMessage[] = [];\n\n  for (const [offset, row] of slice.entries()) {\n    const id = `row-${startIndex + offset + 1}`;\n    if (isCompactionRow(row)) {\n      out.push({\n        id,\n        role: 'system',\n        kind: 'compaction',\n        content: typeof row.summary === 'string' ? row.summary : '',\n        timestamp: parseTimestamp(row.at),\n        tokensBefore: row.tokensBefore,\n        tokensAfter: row.tokensAfter,\n      });\n      continue;\n    }\n\n    const compactionSummaryRow = compactionSummaryRowToClientHistory(row);\n    if (compactionSummaryRow) {\n      out.push({ id, ...compactionSummaryRow });\n      continue;\n    }\n\n    const contextRow = contextRowToClientHistory(row);\n    if (contextRow) {\n      out.push({ id, ...contextRow });\n      continue;\n    }\n\n    const bashRow = bashRowToClientHistory(row);\n    if (bashRow) {\n      out.push({ id, ...bashRow });\n      continue;\n    }\n\n    const customRow = customRowToClientHistory(row);\n    if (customRow) {\n      out.push({ id, ...customRow });\n      continue;\n    }\n\n    const customStateRow = customStateRowToClientHistory(row);\n    if (customStateRow) {\n      out.push({ id, ...customStateRow });\n      continue;\n    }\n\n    const branchSummaryRow = branchSummaryRowToClientHistory(row);\n    if (branchSummaryRow) {\n      out.push({ id, ...branchSummaryRow });\n      continue;\n    }\n\n    const messageRow = asHistoryMessageRow(row);\n    if (!messageRow) continue;\n    if (messageRow.role === 'tool' || messageRow.role === 'toolResult') {\n      continue;\n    }\n\n    if (messageRow.role === 'user' || messageRow.role === 'system') {\n      out.push({\n        id,\n        role: messageRow.role,\n        kind: 'message',\n        content: flattenMessageContent(messageRow.content ?? ''),\n        timestamp: parseTimestampValue(messageRow.timestamp),\n      });\n      continue;\n    }\n\n    out.push({\n      id,\n      role: 'assistant',\n      kind: 'message',\n      content: flattenMessageContent(messageRow.content ?? ''),\n      timestamp: parseTimestampValue(messageRow.timestamp),\n      toolCalls: toolCallsWithResults(messageRow.tool_calls ?? messageRow.toolCalls, results),\n    });\n  }\n\n  return out;\n}\n"],"mappings":"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"}
+{"version":3,"file":"client-history.js","names":[],"sources":["../../../src/session/client-history.ts"],"sourcesContent":["import type { Message } from './types.js';\nimport type { TranscriptStoredRow } from './session-context-for-llm.js';\nimport { buildTranscriptOutline } from './transcript-outline.js';\n\n/** Transcript row for TUI and HTTP clients (flattened from persisted session messages). */\nexport interface ClientHistoryMessage {\n  id?: string;\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n  displayIndex?: number;\n  rawContent?: string | unknown[];\n  timestamp?: number;\n  kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';\n  tokensBefore?: number;\n  tokensAfter?: number;\n  bash?: {\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  custom?: {\n    customType: string;\n    details?: unknown;\n    state?: boolean;\n    display?: boolean;\n  };\n  branch?: {\n    summary: string;\n    fromId?: string;\n  };\n  toolCalls?: Array<{ name: string; args?: unknown; result?: string; isError?: boolean }>;\n}\n\nexport function flattenMessageContent(content: string | unknown[]): string {\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return '';\n  const parts: string[] = [];\n  for (const block of content) {\n    if (typeof block !== 'object' || block === null) continue;\n    const b = block as Record<string, unknown>;\n    if (b.type === 'text' && typeof b.text === 'string') {\n      parts.push(b.text);\n    }\n  }\n  return parts.join('');\n}\n\nfunction parseTimestamp(ts: string | undefined): number | undefined {\n  if (!ts) return undefined;\n  const ms = Date.parse(ts);\n  return Number.isFinite(ms) ? ms : undefined;\n}\n\nfunction safeJsonParseArguments(raw: string): unknown {\n  const t = raw.trim();\n  if (!t) return undefined;\n  try {\n    return JSON.parse(t) as unknown;\n  } catch {\n    return raw;\n  }\n}\n\nfunction collectToolResults(messages: Message[]): Map<string, { text: string; isError?: boolean }> {\n  const map = new Map<string, { text: string; isError?: boolean }>();\n  for (const m of messages) {\n    if (m.role !== 'tool' && m.role !== 'toolResult') continue;\n    const id = m.tool_call_id;\n    if (!id || typeof id !== 'string') continue;\n    map.set(id, {\n      text: flattenMessageContent(m.content),\n      isError: m.isError,\n    });\n  }\n  return map;\n}\n\nfunction toolCallsWithResults(\n  tool_calls: Message['tool_calls'],\n  results: Map<string, { text: string; isError?: boolean }>,\n): ClientHistoryMessage['toolCalls'] | undefined {\n  if (!tool_calls?.length) return undefined;\n  const out: NonNullable<ClientHistoryMessage['toolCalls']> = [];\n  for (const tc of tool_calls) {\n    const res = results.get(tc.id);\n    out.push({\n      name: tc.function.name,\n      args: safeJsonParseArguments(tc.function.arguments),\n      result: res?.text,\n      isError: res?.isError,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\n/**\n * Maps gateway/session API messages into a linear chat history for clients.\n * Tool / toolResult rows are merged into assistant `toolCalls` when ids match; otherwise skipped.\n */\nexport function messagesToClientHistory(\n  messages: Message[],\n  opts?: { limit?: number },\n): ClientHistoryMessage[] {\n  const slice =\n    opts?.limit !== undefined && messages.length > opts.limit\n      ? messages.slice(-opts.limit)\n      : messages;\n\n  const results = collectToolResults(slice);\n  const out: ClientHistoryMessage[] = [];\n\n  for (const m of slice) {\n    if (m.role === 'tool' || m.role === 'toolResult') {\n      continue;\n    }\n\n    if (m.role === 'user' || m.role === 'system') {\n      const text = flattenMessageContent(m.content);\n      out.push({\n        role: m.role,\n        content: text,\n        timestamp: parseTimestamp(m.timestamp),\n      });\n      continue;\n    }\n\n    if (m.role === 'assistant') {\n      const text = flattenMessageContent(m.content);\n      const toolCalls = toolCallsWithResults(m.tool_calls, results);\n      out.push({\n        role: 'assistant',\n        content: text,\n        timestamp: parseTimestamp(m.timestamp),\n        toolCalls,\n      });\n    }\n  }\n\n  return out;\n}\n\ntype HistoryMessageRow = {\n  role: 'system' | 'user' | 'assistant' | 'tool' | 'toolResult';\n  content?: string | unknown[];\n  timestamp?: string | number;\n  tool_call_id?: string;\n  toolCallId?: string;\n  tool_calls?: Message['tool_calls'];\n  toolCalls?: Message['tool_calls'];\n  isError?: boolean;\n};\n\nfunction asHistoryMessageRow(row: TranscriptStoredRow): HistoryMessageRow | null {\n  const role = (row as { role?: unknown }).role;\n  if (\n    typeof role !== 'string' ||\n    !['system', 'user', 'assistant', 'tool', 'toolResult'].includes(role)\n  ) {\n    return null;\n  }\n  return row as unknown as HistoryMessageRow;\n}\n\nfunction parseTimestampValue(ts: string | number | undefined): number | undefined {\n  if (typeof ts === 'number') return Number.isFinite(ts) ? ts : undefined;\n  return parseTimestamp(ts);\n}\n\nfunction collectHistoryToolResults(messages: HistoryMessageRow[]): Map<string, { text: string; isError?: boolean }> {\n  const map = new Map<string, { text: string; isError?: boolean }>();\n  for (const m of messages) {\n    if (m.role !== 'tool' && m.role !== 'toolResult') continue;\n    const id = m.tool_call_id ?? m.toolCallId;\n    if (!id || typeof id !== 'string') continue;\n    map.set(id, {\n      text: flattenMessageContent(m.content ?? ''),\n      isError: m.isError,\n    });\n  }\n  return map;\n}\n\nfunction isCompactionRow(row: TranscriptStoredRow): row is TranscriptStoredRow & {\n  type: 'compaction';\n  summary?: string;\n  at?: string;\n  tokensBefore?: number;\n  tokensAfter?: number;\n} {\n  return (row as { type?: unknown }).type === 'compaction';\n}\n\nfunction compactionSummaryRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'compactionSummary') return null;\n  const summary = optionalString(r.summary) ?? '';\n  return {\n    role: 'system',\n    kind: 'compaction',\n    content: summary,\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    tokensBefore: typeof r.tokensBefore === 'number' ? r.tokensBefore : undefined,\n  };\n}\n\nfunction contextRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  if ((row as { kind?: unknown }).kind !== 'context') return null;\n  const text = (row as { text?: unknown }).text;\n  if (typeof text !== 'string' || !text.trim()) return null;\n  const createdAt = (row as { createdAt?: unknown }).createdAt;\n  return {\n    role: 'system',\n    kind: 'context',\n    content: text,\n    timestamp: typeof createdAt === 'string' ? parseTimestamp(createdAt) : undefined,\n  };\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction bashRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'bashExecution') return null;\n\n  const command = optionalString(r.command) ?? optionalString(r.content)?.trim();\n  if (!command) return null;\n  const output = Array.isArray(r.output) || typeof r.output === 'string'\n    ? flattenMessageContent(r.output)\n    : optionalString(r.output);\n  const exitCode = typeof r.exitCode === 'number' ? r.exitCode : r.exitCode === null ? null : undefined;\n  const signal = typeof r.signal === 'string' ? r.signal : r.signal === null ? null : undefined;\n  const excludeFromContext =\n    typeof r.excludeFromContext === 'boolean'\n      ? r.excludeFromContext\n      : typeof r.excludedFromContext === 'boolean'\n        ? r.excludedFromContext\n        : undefined;\n\n  return {\n    role: 'system',\n    kind: 'bash',\n    content: output || command,\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    bash: {\n      command,\n      output,\n      exitCode,\n      signal,\n      excludeFromContext,\n      truncated: typeof r.truncated === 'boolean' ? r.truncated : undefined,\n      fullOutputPath: optionalString(r.fullOutputPath),\n    },\n  };\n}\n\nfunction customRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'custom' && r.type !== 'custom_message') return null;\n\n  const customType = optionalString(r.customType)?.trim();\n  if (!customType) return null;\n  const content = Array.isArray(r.content) || typeof r.content === 'string'\n    ? flattenMessageContent(r.content)\n    : '';\n  const timestamp = parseTimestampValue(\n    typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n  );\n\n  return {\n    role: 'system',\n    kind: 'custom',\n    content,\n    rawContent: Array.isArray(r.content) || typeof r.content === 'string' ? r.content : undefined,\n    timestamp,\n    custom: {\n      customType,\n      details: r.details,\n      display: r.display === false ? false : true,\n    },\n  };\n}\n\nfunction customStateRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.type !== 'custom') return null;\n\n  const customType = optionalString(r.customType)?.trim();\n  if (!customType) return null;\n  return {\n    role: 'system',\n    kind: 'custom',\n    content: '',\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    custom: {\n      customType,\n      details: r.data,\n      state: true,\n    },\n  };\n}\n\nfunction branchSummaryRowToClientHistory(row: TranscriptStoredRow): ClientHistoryMessage | null {\n  const r = row as unknown as Record<string, unknown>;\n  if (r.role !== 'branchSummary') return null;\n  const summary = optionalString(r.summary)?.trim();\n  if (!summary) return null;\n  const fromId = optionalString(r.fromId);\n\n  return {\n    role: 'system',\n    kind: 'branch',\n    content: summary,\n    timestamp: parseTimestampValue(\n      typeof r.timestamp === 'string' || typeof r.timestamp === 'number' ? r.timestamp : undefined,\n    ),\n    branch: {\n      summary,\n      fromId,\n    },\n  };\n}\n\n/**\n * Maps persisted transcript rows into linear chat history, preserving non-LLM\n * audit rows that the TUI can render as dedicated components.\n */\nexport function transcriptRowsToClientHistory(\n  rows: TranscriptStoredRow[],\n  opts?: { limit?: number; startRowNumber?: number; endRowNumber?: number },\n): ClientHistoryMessage[] {\n  const displayIndexByRowNumber = new Map(\n    buildTranscriptOutline(rows)\n      .filter((entry) => entry.displayIndex !== undefined)\n      .map((entry) => [entry.rowNumber, entry.displayIndex!] as const),\n  );\n  const hasRowWindow = opts?.startRowNumber !== undefined || opts?.endRowNumber !== undefined;\n  const startIndex = hasRowWindow\n    ? Math.max(0, Math.trunc(opts?.startRowNumber ?? 1) - 1)\n    : opts?.limit !== undefined && rows.length > opts.limit\n      ? rows.length - opts.limit\n      : 0;\n  const endIndex = hasRowWindow\n    ? Math.max(\n        startIndex,\n        Math.min(rows.length, Math.trunc(opts?.endRowNumber ?? rows.length)),\n      )\n    : rows.length;\n  const slice = hasRowWindow\n    ? rows.slice(startIndex, endIndex)\n    : opts?.limit !== undefined && rows.length > opts.limit\n      ? rows.slice(-opts.limit)\n      : rows;\n  const messages = slice\n    .map(asHistoryMessageRow)\n    .filter((row): row is HistoryMessageRow => row !== null);\n  const results = collectHistoryToolResults(messages);\n  const out: ClientHistoryMessage[] = [];\n\n  for (const [offset, row] of slice.entries()) {\n    const rowNumber = startIndex + offset + 1;\n    const id = `row-${rowNumber}`;\n    const displayIndex = displayIndexByRowNumber.get(rowNumber);\n    if (isCompactionRow(row)) {\n      out.push({\n        id,\n        role: 'system',\n        kind: 'compaction',\n        content: typeof row.summary === 'string' ? row.summary : '',\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n        timestamp: parseTimestamp(row.at),\n        tokensBefore: row.tokensBefore,\n        tokensAfter: row.tokensAfter,\n      });\n      continue;\n    }\n\n    const compactionSummaryRow = compactionSummaryRowToClientHistory(row);\n    if (compactionSummaryRow) {\n      out.push({\n        id,\n        ...compactionSummaryRow,\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n      });\n      continue;\n    }\n\n    const contextRow = contextRowToClientHistory(row);\n    if (contextRow) {\n      out.push({\n        id,\n        ...contextRow,\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n      });\n      continue;\n    }\n\n    const bashRow = bashRowToClientHistory(row);\n    if (bashRow) {\n      out.push({\n        id,\n        ...bashRow,\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n      });\n      continue;\n    }\n\n    const customRow = customRowToClientHistory(row);\n    if (customRow) {\n      out.push({\n        id,\n        ...customRow,\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n      });\n      continue;\n    }\n\n    const customStateRow = customStateRowToClientHistory(row);\n    if (customStateRow) {\n      out.push({\n        id,\n        ...customStateRow,\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n      });\n      continue;\n    }\n\n    const branchSummaryRow = branchSummaryRowToClientHistory(row);\n    if (branchSummaryRow) {\n      out.push({\n        id,\n        ...branchSummaryRow,\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n      });\n      continue;\n    }\n\n    const messageRow = asHistoryMessageRow(row);\n    if (!messageRow) continue;\n    if (messageRow.role === 'tool' || messageRow.role === 'toolResult') {\n      continue;\n    }\n\n    if (messageRow.role === 'user' || messageRow.role === 'system') {\n      out.push({\n        id,\n        role: messageRow.role,\n        kind: 'message',\n        content: flattenMessageContent(messageRow.content ?? ''),\n        ...(displayIndex !== undefined ? { displayIndex } : {}),\n        timestamp: parseTimestampValue(messageRow.timestamp),\n      });\n      continue;\n    }\n\n    out.push({\n      id,\n      role: 'assistant',\n      kind: 'message',\n      content: flattenMessageContent(messageRow.content ?? ''),\n      ...(displayIndex !== undefined ? { displayIndex } : {}),\n      timestamp: parseTimestampValue(messageRow.timestamp),\n      toolCalls: toolCallsWithResults(messageRow.tool_calls ?? messageRow.toolCalls, results),\n    });\n  }\n\n  return out;\n}\n"],"mappings":"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"}

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

@@ -1,8 +1,8 @@
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import "../storage/sqlite/index.js";
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
 import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";

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

@@ -1,9 +1,9 @@
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { findSessionKeyBySessionId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";

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

@@ -1,7 +1,7 @@
-import { isCronSessionKey } from "../routing/session-key-utils.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { isCronSessionKey } from "../routing/session-key-utils.js";
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";
@@ -32,12 +32,32 @@ function extractTextFromMessage(m) {
 function firstUserText(messages) {
 	const u = messages.find((m) => m.role === "user");
 	if (!u) return "";
-	return stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(extractTextFromMessage(u))));
+	return normalizeUserTextForTitle(extractTextFromMessage(u));
 }
 function stripMediaClaimChecks(text) {
 	if (!text.includes("[media attached:") && !text.includes("xopc-media-uri:")) return text;
 	return text.replace(/\s*\[media attached:[^\]]+\]\s*\r?\nxopc-media-uri:[^\r\n]+\r?\n\s*xopc-media-path:[^\r\n]+(?:\r?\n\s*Use the read_media tool[^\r\n]*)?/g, "").replace(/\s*\[media attached:[^\]]+\]\s*/g, " ").replace(/\s*xopc-media-uri:[^\r\n]+/g, "").replace(/\s*xopc-media-path:[^\r\n]+/g, "").replace(/\s*Use the read_media tool[^\r\n]*/g, "").replace(/\n{3,}/g, "\n\n").trim();
 }
+function stripExpandedSkillBlockForTitle(text) {
+	const trimmed = text.trimStart();
+	if (!/^##\s+Skill:\s*\S+/i.test(trimmed)) return text;
+	const markerRe = /(?:^|\r?\n)\*\*Arguments\*\*:\s*/gi;
+	let argsStart = -1;
+	while (markerRe.exec(trimmed) !== null) argsStart = markerRe.lastIndex;
+	if (argsStart !== -1) {
+		const args = trimmed.slice(argsStart).trim();
+		if (args) return args;
+	}
+	return (trimmed.split(/\r?\n/)[0]?.trim() ?? "").replace(/^##\s+Skill:\s*/i, "").trim();
+}
+function stripSkillCommandForTitle(text) {
+	const match = text.trimStart().match(/^\/skill:([^\s]+)(?:\s+([\s\S]*))?$/i);
+	if (!match) return text;
+	return match[2]?.trim() || match[1]?.trim() || text;
+}
+function normalizeUserTextForTitle(raw) {
+	return stripSkillCommandForTitle(stripExpandedSkillBlockForTitle(stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw))))).trim();
+}
 /** First assistant message that has visible text (skips tool-only assistant rows). */
 function firstAssistantText(messages) {
 	for (const m of messages) if (m.role === "assistant") {
@@ -73,7 +93,7 @@ function getSessionTitleSource(meta) {
 }
 /** Title from a single user message (first line), for immediate sidebar labels. */
 function provisionalTitleFromUserText(raw) {
-	const text = stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText((raw ?? "").trim()));
+	const text = normalizeUserTextForTitle((raw ?? "").trim());
 	if (!text) return null;
 	const line = text.split(/\n/)[0]?.trim();
 	if (!line) return null;

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

@@ -1 +1 @@
-{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport { stripSessionStartupContextFromUserText } from '../agent/reply/startup-context.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  return stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw)));\n}\n\nfunction stripMediaClaimChecks(text: string): string {\n  if (!text.includes('[media attached:') && !text.includes('xopc-media-uri:')) {\n    return text;\n  }\n  return text\n    .replace(\n      /\\s*\\[media attached:[^\\]]+\\]\\s*\\r?\\nxopc-media-uri:[^\\r\\n]+\\r?\\n\\s*xopc-media-path:[^\\r\\n]+(?:\\r?\\n\\s*Use the read_media tool[^\\r\\n]*)?/g,\n      '',\n    )\n    .replace(/\\s*\\[media attached:[^\\]]+\\]\\s*/g, ' ')\n    .replace(/\\s*xopc-media-uri:[^\\r\\n]+/g, '')\n    .replace(/\\s*xopc-media-path:[^\\r\\n]+/g, '')\n    .replace(/\\s*Use the read_media tool[^\\r\\n]*/g, '')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\nexport type SessionTitleSource = 'provisional' | 'llm' | 'user';\n\nexport function getSessionTitleSource(\n  meta: { customData?: Record<string, unknown> } | null | undefined,\n): SessionTitleSource | null {\n  const raw = meta?.customData?.titleSource;\n  if (raw === 'provisional' || raw === 'llm' || raw === 'user') return raw;\n  return null;\n}\n\n/** Title from a single user message (first line), for immediate sidebar labels. */\nexport function provisionalTitleFromUserText(raw: string): string | null {\n  const text = stripEnvelopeTimestampPrefix(\n    stripSessionStartupContextFromUserText((raw ?? '').trim()),\n  );\n  if (!text) return null;\n  const line = text.split(/\\n/)[0]?.trim();\n  if (!line) return null;\n  return sanitizeSessionTitle(line);\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\nexport type SessionTitleUpdatedHook = (sessionKey: string, name: string) => void | Promise<void>;\n\n/** Whether post-turn LLM refine may run (provisional or still unnamed; not user-locked). */\nexport function shouldRefineSessionTitleWithLlm(\n  meta: { name?: string; customData?: Record<string, unknown> } | null | undefined,\n): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  if (meta.name?.trim()) return source === 'provisional';\n  return true;\n}\n\nfunction canAutoWriteTitle(meta: { name?: string; customData?: Record<string, unknown> } | null): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  return !meta.name?.trim();\n}\n\n/**\n * Set provisional title from first user text when session is still unnamed.\n * Skips cron/heartbeat keys and user-locked titles.\n */\nexport async function maybeSetProvisionalSessionTitle(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  userText?: string,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) return;\n  if (!canAutoWriteTitle(meta)) return;\n\n  let title: string | null = null;\n  if (userText?.trim()) {\n    title = provisionalTitleFromUserText(userText);\n  }\n  if (!title) {\n    const messages = await sessionStore.load(sessionKey);\n    if (!messages.length) return;\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'provisional' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: provisional updateMetadata failed');\n  }\n}\n\n/**\n * LLM refine when title is empty or still provisional (not user-locked).\n */\nexport async function maybeRefineSessionTitleWithLlm(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.saveMessages(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (!shouldRefineSessionTitleWithLlm(meta)) return;\n\n  const source = getSessionTitleSource(meta);\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  const existing = meta.name?.trim();\n  if (existing === title) {\n    if (source !== 'llm') {\n      try {\n        await sessionStore.updateMetadata(sessionKey, {\n          customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n        });\n      } catch {\n        /* ignore */\n      }\n    }\n    return;\n  }\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: refine updateMetadata failed');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport { stripSessionStartupContextFromUserText } from '../agent/reply/startup-context.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  return normalizeUserTextForTitle(raw);\n}\n\nfunction stripMediaClaimChecks(text: string): string {\n  if (!text.includes('[media attached:') && !text.includes('xopc-media-uri:')) {\n    return text;\n  }\n  return text\n    .replace(\n      /\\s*\\[media attached:[^\\]]+\\]\\s*\\r?\\nxopc-media-uri:[^\\r\\n]+\\r?\\n\\s*xopc-media-path:[^\\r\\n]+(?:\\r?\\n\\s*Use the read_media tool[^\\r\\n]*)?/g,\n      '',\n    )\n    .replace(/\\s*\\[media attached:[^\\]]+\\]\\s*/g, ' ')\n    .replace(/\\s*xopc-media-uri:[^\\r\\n]+/g, '')\n    .replace(/\\s*xopc-media-path:[^\\r\\n]+/g, '')\n    .replace(/\\s*Use the read_media tool[^\\r\\n]*/g, '')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\nfunction stripExpandedSkillBlockForTitle(text: string): string {\n  const trimmed = text.trimStart();\n  if (!/^##\\s+Skill:\\s*\\S+/i.test(trimmed)) {\n    return text;\n  }\n\n  const markerRe = /(?:^|\\r?\\n)\\*\\*Arguments\\*\\*:\\s*/gi;\n  let argsStart = -1;\n  while (markerRe.exec(trimmed) !== null) {\n    argsStart = markerRe.lastIndex;\n  }\n\n  if (argsStart !== -1) {\n    const args = trimmed.slice(argsStart).trim();\n    if (args) return args;\n  }\n\n  const firstLine = trimmed.split(/\\r?\\n/)[0]?.trim() ?? '';\n  return firstLine.replace(/^##\\s+Skill:\\s*/i, '').trim();\n}\n\nfunction stripSkillCommandForTitle(text: string): string {\n  const trimmed = text.trimStart();\n  const match = trimmed.match(/^\\/skill:([^\\s]+)(?:\\s+([\\s\\S]*))?$/i);\n  if (!match) {\n    return text;\n  }\n  const args = match[2]?.trim();\n  return args || match[1]?.trim() || text;\n}\n\nfunction normalizeUserTextForTitle(raw: string): string {\n  return stripSkillCommandForTitle(\n    stripExpandedSkillBlockForTitle(\n      stripMediaClaimChecks(\n        stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw)),\n      ),\n    ),\n  ).trim();\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\nexport type SessionTitleSource = 'provisional' | 'llm' | 'user';\n\nexport function getSessionTitleSource(\n  meta: { customData?: Record<string, unknown> } | null | undefined,\n): SessionTitleSource | null {\n  const raw = meta?.customData?.titleSource;\n  if (raw === 'provisional' || raw === 'llm' || raw === 'user') return raw;\n  return null;\n}\n\n/** Title from a single user message (first line), for immediate sidebar labels. */\nexport function provisionalTitleFromUserText(raw: string): string | null {\n  const text = normalizeUserTextForTitle((raw ?? '').trim());\n  if (!text) return null;\n  const line = text.split(/\\n/)[0]?.trim();\n  if (!line) return null;\n  return sanitizeSessionTitle(line);\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\nexport type SessionTitleUpdatedHook = (sessionKey: string, name: string) => void | Promise<void>;\n\n/** Whether post-turn LLM refine may run (provisional or still unnamed; not user-locked). */\nexport function shouldRefineSessionTitleWithLlm(\n  meta: { name?: string; customData?: Record<string, unknown> } | null | undefined,\n): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  if (meta.name?.trim()) return source === 'provisional';\n  return true;\n}\n\nfunction canAutoWriteTitle(meta: { name?: string; customData?: Record<string, unknown> } | null): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  return !meta.name?.trim();\n}\n\n/**\n * Set provisional title from first user text when session is still unnamed.\n * Skips cron/heartbeat keys and user-locked titles.\n */\nexport async function maybeSetProvisionalSessionTitle(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  userText?: string,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) return;\n  if (!canAutoWriteTitle(meta)) return;\n\n  let title: string | null = null;\n  if (userText?.trim()) {\n    title = provisionalTitleFromUserText(userText);\n  }\n  if (!title) {\n    const messages = await sessionStore.load(sessionKey);\n    if (!messages.length) return;\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'provisional' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: provisional updateMetadata failed');\n  }\n}\n\n/**\n * LLM refine when title is empty or still provisional (not user-locked).\n */\nexport async function maybeRefineSessionTitleWithLlm(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.saveMessages(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (!shouldRefineSessionTitleWithLlm(meta)) return;\n\n  const source = getSessionTitleSource(meta);\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  const existing = meta.name?.trim();\n  if (existing === title) {\n    if (source !== 'llm') {\n      try {\n        await sessionStore.updateMetadata(sessionKey, {\n          customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n        });\n      } catch {\n        /* ignore */\n      }\n    }\n    return;\n  }\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: refine updateMetadata failed');\n  }\n}\n"],"mappings":"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"}

package/dist/src/session/store.js

@@ -1,5 +1,4 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
@@ -9,6 +8,7 @@ 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";
 import "../storage/sqlite/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
 import { SessionCompactor } from "../agent/memory/compaction.js";
 import { SlidingWindow } from "../agent/memory/window.js";

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

@@ -150,6 +150,10 @@ export interface SessionListQuery {
     sessionTypes?: SessionType[];
     includeHidden?: boolean;
     projectId?: string;
+    unassigned?: boolean;
+    updatedAfter?: number;
+    includePinned?: boolean;
+    includeSessionKey?: string;
     sortBy?: 'updatedAt' | 'createdAt' | 'messageCount' | 'lastAccessedAt';
     sortOrder?: 'asc' | 'desc';
     limit?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/session/types.ts"],"sourcesContent":["// Session management types\n\nimport type { TranscriptStoredRow } from './session-context-for-llm.js';\n\nexport interface Message {\n  role: 'system' | 'user' | 'assistant' | 'tool' | 'toolResult';\n  /** Plain string or structured content blocks (tool calls, multimodal). */\n  content: string | unknown[];\n  timestamp?: string;\n  tool_call_id?: string;\n  tool_calls?: Array<{\n    id: string;\n    type: 'function';\n    function: {\n      name: string;\n      arguments: string;\n    };\n  }>;\n  tool_call_id$?: string;\n  toolName?: string;\n  isError?: boolean;\n  name?: string;\n  /** Token usage from the LLM response (assistant messages only). */\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    totalTokens?: number;\n  };\n  /** Inbound attachment metadata (no base64). */\n  media?: Array<{\n    id: string;\n    bucket: string;\n    type: string;\n    mimeType: string;\n    name: string;\n    size: number;\n    uri: string;\n    path: string;\n  }>;\n}\n\n/** Session status enum */\nexport enum SessionStatus {\n  ACTIVE = 'active',\n  IDLE = 'idle',\n  ARCHIVED = 'archived',\n  PINNED = 'pinned',\n}\n\n/** Session routing metadata */\nexport interface SessionRoutingMeta {\n  agentId: string;\n  source: string;\n  accountId: string;\n  peerKind: string;\n  peerId: string;\n  threadId?: string;\n  scopeId?: string;\n  mainSessionKey?: string;\n  lastRoutePolicy?: 'main' | 'session';\n}\n\n/** Session-level statistics (per session) */\nexport interface SessionStats {\n  messageCount: number;\n  tokenCount: number;\n  turnCount?: number;\n  lastTurnAt?: number;\n}\n\n/** Global session statistics (aggregate) */\nexport interface GlobalSessionStats {\n  totalSessions: number;\n  activeSessions: number;\n  archivedSessions: number;\n  pinnedSessions: number;\n  totalMessages: number;\n  totalTokens: number;\n  oldestSession?: string;\n  newestSession?: string;\n  byChannel: Record<string, number>;\n}\n\nexport type SessionType = 'chat' | 'workflow-run' | 'workflow-subagent' | 'cron' | 'heartbeat';\n\n/** Session metadata (stored in index) */\nexport interface SessionMetadata {\n  key: string;\n  name?: string;\n  status: SessionStatus;\n  tags: string[];\n  createdAt: string;\n  updatedAt: string;\n  lastAccessedAt: string;\n  messageCount: number;\n  estimatedTokens: number;\n  compactedCount: number;\n  lastFlushedAt?: string;\n  flushCount?: number;\n  sourceChannel: string;\n  sourceChatId: string;\n  customData?: Record<string, unknown>;\n  /** Optional project grouping for sessions, goals, workflows, and related context. */\n  projectId?: string;\n  /** Routing metadata */\n  routing?: SessionRoutingMeta;\n  /** Session statistics */\n  stats?: SessionStats;\n  /**\n   * High-level origin for filtering/UI (e.g. `cron`, `heartbeat`, `webchat`).\n   * Distinct from `sourceChannel` (routing namespace).\n   */\n  sessionType: SessionType;\n  hiddenFromSessionList?: boolean;\n  parentSessionKey?: string;\n  workflowRunId?: string;\n  workflowDefinitionId?: string;\n  workflowAgentId?: string;\n  workflowAgentLabel?: string;\n  /** Active OpenClaw-style session instance id. Rotates on reset while `key` stays stable. */\n  sessionId?: string;\n  /** Workspace/cwd recorded for the active transcript. */\n  cwd?: string;\n  /** First activity time for this session row (ISO), from transcript header when available. */\n  sessionStartedAt?: string;\n  /** Last transcript write / interaction (ISO), updated on each persist. */\n  lastInteractionAt?: string;\n  /**\n   * Epoch ms when the last webchat run was aborted (`POST /api/agent/abort`).\n   * Used with `clientCreatedAtMs` on the next POST /api/agent to drop stale queued sends.\n   */\n  abortCutoffTimestamp?: number;\n}\n\n/** Summary of wrapped transcript (no duplicate message bodies). */\nexport interface SessionTranscriptSummary {\n  id: string;\n  version: number;\n  createdAt: string;\n  updatedAt: string;\n  compactionCount: number;\n}\n\n/** Session detail (metadata + messages) */\nexport interface SessionDetail extends SessionMetadata {\n  messages: Message[];\n  /** Present when loaded with `includeTranscriptSummary` (gateway `?include=transcript`). */\n  transcriptSummary?: SessionTranscriptSummary;\n  /** Present when loaded with `include=transcriptRows` (full on-disk rows, LLM + `kind: 'context'`). */\n  transcriptRows?: TranscriptStoredRow[];\n}\n\n/** Session list query parameters */\nexport interface SessionListQuery {\n  status?: SessionStatus | SessionStatus[];\n  /** Single `sourceChannel`, or comma-separated list (e.g. `telegram,weixin`). */\n  channel?: string;\n  tags?: string[];\n  search?: string;\n  sessionTypes?: SessionType[];\n  includeHidden?: boolean;\n  projectId?: string;\n  sortBy?: 'updatedAt' | 'createdAt' | 'messageCount' | 'lastAccessedAt';\n  sortOrder?: 'asc' | 'desc';\n  limit?: number;\n  offset?: number;\n}\n\n/** Paginated result */\nexport interface PaginatedResult<T> {\n  items: T[];\n  total: number;\n  limit: number;\n  offset: number;\n  hasMore: boolean;\n}\n\n/** Export format */\nexport type ExportFormat = 'json' | 'markdown';\n\n/** Session export data */\nexport interface SessionExport {\n  version: string;\n  exportedAt: string;\n  metadata: SessionMetadata;\n  messages: Message[];\n  /** Full on-disk rows (LLM + `kind: 'context'`) for audit / round-trip. */\n  transcriptRows: TranscriptStoredRow[];\n}\n\n/** On-disk pre-compaction snapshot (OpenClaw-style checkpoint list). */\nexport interface CompactionCheckpointSummary {\n  id: string;\n  sizeBytes: number;\n  modifiedAt: string;\n}\n\nexport interface CompactionCheckpointDetail extends CompactionCheckpointSummary {\n  messageCount: number;\n}\n"],"mappings":";;AA4CA,IAAY,gBAAL,yBAAA,eAAA;AACL,eAAA,YAAA;AACA,eAAA,UAAA;AACA,eAAA,cAAA;AACA,eAAA,YAAA;;KACD"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/session/types.ts"],"sourcesContent":["// Session management types\n\nimport type { TranscriptStoredRow } from './session-context-for-llm.js';\n\nexport interface Message {\n  role: 'system' | 'user' | 'assistant' | 'tool' | 'toolResult';\n  /** Plain string or structured content blocks (tool calls, multimodal). */\n  content: string | unknown[];\n  timestamp?: string;\n  tool_call_id?: string;\n  tool_calls?: Array<{\n    id: string;\n    type: 'function';\n    function: {\n      name: string;\n      arguments: string;\n    };\n  }>;\n  tool_call_id$?: string;\n  toolName?: string;\n  isError?: boolean;\n  name?: string;\n  /** Token usage from the LLM response (assistant messages only). */\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    totalTokens?: number;\n  };\n  /** Inbound attachment metadata (no base64). */\n  media?: Array<{\n    id: string;\n    bucket: string;\n    type: string;\n    mimeType: string;\n    name: string;\n    size: number;\n    uri: string;\n    path: string;\n  }>;\n}\n\n/** Session status enum */\nexport enum SessionStatus {\n  ACTIVE = 'active',\n  IDLE = 'idle',\n  ARCHIVED = 'archived',\n  PINNED = 'pinned',\n}\n\n/** Session routing metadata */\nexport interface SessionRoutingMeta {\n  agentId: string;\n  source: string;\n  accountId: string;\n  peerKind: string;\n  peerId: string;\n  threadId?: string;\n  scopeId?: string;\n  mainSessionKey?: string;\n  lastRoutePolicy?: 'main' | 'session';\n}\n\n/** Session-level statistics (per session) */\nexport interface SessionStats {\n  messageCount: number;\n  tokenCount: number;\n  turnCount?: number;\n  lastTurnAt?: number;\n}\n\n/** Global session statistics (aggregate) */\nexport interface GlobalSessionStats {\n  totalSessions: number;\n  activeSessions: number;\n  archivedSessions: number;\n  pinnedSessions: number;\n  totalMessages: number;\n  totalTokens: number;\n  oldestSession?: string;\n  newestSession?: string;\n  byChannel: Record<string, number>;\n}\n\nexport type SessionType = 'chat' | 'workflow-run' | 'workflow-subagent' | 'cron' | 'heartbeat';\n\n/** Session metadata (stored in index) */\nexport interface SessionMetadata {\n  key: string;\n  name?: string;\n  status: SessionStatus;\n  tags: string[];\n  createdAt: string;\n  updatedAt: string;\n  lastAccessedAt: string;\n  messageCount: number;\n  estimatedTokens: number;\n  compactedCount: number;\n  lastFlushedAt?: string;\n  flushCount?: number;\n  sourceChannel: string;\n  sourceChatId: string;\n  customData?: Record<string, unknown>;\n  /** Optional project grouping for sessions, goals, workflows, and related context. */\n  projectId?: string;\n  /** Routing metadata */\n  routing?: SessionRoutingMeta;\n  /** Session statistics */\n  stats?: SessionStats;\n  /**\n   * High-level origin for filtering/UI (e.g. `cron`, `heartbeat`, `webchat`).\n   * Distinct from `sourceChannel` (routing namespace).\n   */\n  sessionType: SessionType;\n  hiddenFromSessionList?: boolean;\n  parentSessionKey?: string;\n  workflowRunId?: string;\n  workflowDefinitionId?: string;\n  workflowAgentId?: string;\n  workflowAgentLabel?: string;\n  /** Active OpenClaw-style session instance id. Rotates on reset while `key` stays stable. */\n  sessionId?: string;\n  /** Workspace/cwd recorded for the active transcript. */\n  cwd?: string;\n  /** First activity time for this session row (ISO), from transcript header when available. */\n  sessionStartedAt?: string;\n  /** Last transcript write / interaction (ISO), updated on each persist. */\n  lastInteractionAt?: string;\n  /**\n   * Epoch ms when the last webchat run was aborted (`POST /api/agent/abort`).\n   * Used with `clientCreatedAtMs` on the next POST /api/agent to drop stale queued sends.\n   */\n  abortCutoffTimestamp?: number;\n}\n\n/** Summary of wrapped transcript (no duplicate message bodies). */\nexport interface SessionTranscriptSummary {\n  id: string;\n  version: number;\n  createdAt: string;\n  updatedAt: string;\n  compactionCount: number;\n}\n\n/** Session detail (metadata + messages) */\nexport interface SessionDetail extends SessionMetadata {\n  messages: Message[];\n  /** Present when loaded with `includeTranscriptSummary` (gateway `?include=transcript`). */\n  transcriptSummary?: SessionTranscriptSummary;\n  /** Present when loaded with `include=transcriptRows` (full on-disk rows, LLM + `kind: 'context'`). */\n  transcriptRows?: TranscriptStoredRow[];\n}\n\n/** Session list query parameters */\nexport interface SessionListQuery {\n  status?: SessionStatus | SessionStatus[];\n  /** Single `sourceChannel`, or comma-separated list (e.g. `telegram,weixin`). */\n  channel?: string;\n  tags?: string[];\n  search?: string;\n  sessionTypes?: SessionType[];\n  includeHidden?: boolean;\n  projectId?: string;\n  unassigned?: boolean;\n  updatedAfter?: number;\n  includePinned?: boolean;\n  includeSessionKey?: string;\n  sortBy?: 'updatedAt' | 'createdAt' | 'messageCount' | 'lastAccessedAt';\n  sortOrder?: 'asc' | 'desc';\n  limit?: number;\n  offset?: number;\n}\n\n/** Paginated result */\nexport interface PaginatedResult<T> {\n  items: T[];\n  total: number;\n  limit: number;\n  offset: number;\n  hasMore: boolean;\n}\n\n/** Export format */\nexport type ExportFormat = 'json' | 'markdown';\n\n/** Session export data */\nexport interface SessionExport {\n  version: string;\n  exportedAt: string;\n  metadata: SessionMetadata;\n  messages: Message[];\n  /** Full on-disk rows (LLM + `kind: 'context'`) for audit / round-trip. */\n  transcriptRows: TranscriptStoredRow[];\n}\n\n/** On-disk pre-compaction snapshot (OpenClaw-style checkpoint list). */\nexport interface CompactionCheckpointSummary {\n  id: string;\n  sizeBytes: number;\n  modifiedAt: string;\n}\n\nexport interface CompactionCheckpointDetail extends CompactionCheckpointSummary {\n  messageCount: number;\n}\n"],"mappings":";;AA4CA,IAAY,gBAAL,yBAAA,eAAA;AACL,eAAA,YAAA;AACA,eAAA,UAAA;AACA,eAAA,cAAA;AACA,eAAA,YAAA;;KACD"}

package/dist/src/storage/sqlite/activity-repository.d.ts

@@ -0,0 +1,8 @@
+import type { ActivityEventWithRelations, ActivityListResult, ActivityObjectRef, CreateObjectLinkInput, ListActivityOptions, ListObjectActivityOptions, ListProjectActivityOptions, ObjectLink, RecordActivityInput } from '../../activity/types.js';
+export declare function recordActivityEvent(input: RecordActivityInput): ActivityEventWithRelations;
+export declare function getActivityEventRecord(id: string): ActivityEventWithRelations | null;
+export declare function listActivityRecords(options?: ListActivityOptions): ActivityListResult;
+export declare function listObjectActivityRecords(options: ListObjectActivityOptions): ActivityListResult;
+export declare function listProjectActivityRecords(options: ListProjectActivityOptions): ActivityListResult;
+export declare function createObjectLinkRecord(input: CreateObjectLinkInput): ObjectLink;
+export declare function listObjectLinkRecords(object: ActivityObjectRef): ObjectLink[];

package/dist/src/storage/sqlite/activity-repository.js

@@ -0,0 +1,208 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/activity-repository.ts
+function parseJson(json, fallback) {
+	try {
+		return JSON.parse(json);
+	} catch {
+		return fallback;
+	}
+}
+function eventFromRow(row) {
+	return {
+		id: row.id,
+		type: row.type,
+		primaryObject: {
+			kind: row.primary_object_kind,
+			id: row.primary_object_id,
+			title: row.primary_object_title ?? void 0
+		},
+		actor: parseJson(row.actor_json, { kind: "system" }),
+		initiator: row.initiator_json ? parseJson(row.initiator_json, void 0) : void 0,
+		source: parseJson(row.source_json, { kind: "system" }),
+		payload: parseJson(row.payload_json, {}),
+		visibility: row.visibility,
+		importance: row.importance,
+		createdAt: row.created_at
+	};
+}
+function scopeFromRow(row) {
+	return {
+		activityId: row.activity_id,
+		scopeKind: row.scope_kind,
+		scopeId: row.scope_id,
+		reason: row.reason
+	};
+}
+function relatedProjectFromRow(row) {
+	return {
+		activityId: row.activity_id,
+		projectId: row.project_id,
+		reason: row.reason,
+		confidence: row.confidence,
+		computedAt: row.computed_at
+	};
+}
+function objectLinkFromRow(row) {
+	return {
+		id: row.id,
+		from: {
+			kind: row.from_kind,
+			id: row.from_id,
+			title: row.from_title ?? void 0
+		},
+		to: {
+			kind: row.to_kind,
+			id: row.to_id,
+			title: row.to_title ?? void 0
+		},
+		relation: row.relation,
+		source: row.source,
+		createdAt: row.created_at
+	};
+}
+function listScopesForActivity(activityId) {
+	return getSqliteDatabase().prepare(`SELECT activity_id, scope_kind, scope_id, reason
+       FROM activity_scopes
+       WHERE activity_id = ?
+       ORDER BY scope_kind ASC, scope_id ASC, reason ASC`).all(activityId).map((row) => scopeFromRow(row));
+}
+function listRelatedProjectsForActivity(activityId) {
+	return getSqliteDatabase().prepare(`SELECT activity_id, project_id, reason, confidence, computed_at
+       FROM activity_related_projects
+       WHERE activity_id = ?
+       ORDER BY project_id ASC, reason ASC`).all(activityId).map((row) => relatedProjectFromRow(row));
+}
+function eventWithRelations(row) {
+	const event = eventFromRow(row);
+	return {
+		...event,
+		scopes: listScopesForActivity(event.id),
+		relatedProjects: listRelatedProjectsForActivity(event.id)
+	};
+}
+function normalizeLimit(limit) {
+	return Math.max(1, Math.min(100, Math.floor(limit ?? 50)));
+}
+function normalizeOffset(offset) {
+	return Math.max(0, Math.floor(offset ?? 0));
+}
+function visibilityClause(visibility, params) {
+	if (!visibility) return "";
+	params.push(visibility);
+	return "WHERE visibility = ?";
+}
+function listResult(rows, total, limit, offset) {
+	return {
+		items: rows.map(eventWithRelations),
+		total,
+		limit,
+		offset,
+		hasMore: offset + rows.length < total
+	};
+}
+function recordActivityEvent(input) {
+	const id = input.id ?? randomUUID();
+	const now = input.nowMs ?? Date.now();
+	const visibility = input.visibility ?? "timeline";
+	const importance = input.importance ?? "normal";
+	const payload = input.payload ?? {};
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO activity_events (
+        id, type, primary_object_kind, primary_object_id, primary_object_title,
+        actor_json, initiator_json, source_json, payload_json,
+        visibility, importance, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.type, input.primaryObject.kind, input.primaryObject.id, input.primaryObject.title ?? null, JSON.stringify(input.actor), input.initiator ? JSON.stringify(input.initiator) : null, JSON.stringify(input.source), JSON.stringify(payload), visibility, importance, now);
+		for (const scope of input.scopes ?? []) db.prepare(`INSERT OR IGNORE INTO activity_scopes (activity_id, scope_kind, scope_id, reason)
+         VALUES (?, ?, ?, ?)`).run(id, scope.scopeKind, scope.scopeId, scope.reason);
+		for (const related of input.relatedProjects ?? []) db.prepare(`INSERT OR REPLACE INTO activity_related_projects (
+          activity_id, project_id, reason, confidence, computed_at
+        ) VALUES (?, ?, ?, ?, ?)`).run(id, related.projectId, related.reason, related.confidence, related.computedAt ?? now);
+	});
+	const event = getActivityEventRecord(id);
+	if (!event) throw new Error(`Activity event was not persisted: ${id}`);
+	return event;
+}
+function getActivityEventRecord(id) {
+	const row = getSqliteDatabase().prepare(`SELECT *
+       FROM activity_events
+       WHERE id = ?`).get(id);
+	return row ? eventWithRelations(row) : null;
+}
+function listActivityRecords(options = {}) {
+	const limit = normalizeLimit(options.limit);
+	const offset = normalizeOffset(options.offset);
+	const params = [];
+	const where = visibilityClause(options.visibility, params);
+	const total = getSqliteDatabase().prepare(`SELECT COUNT(*) AS count FROM activity_events ${where}`).get(...params).count;
+	return listResult(getSqliteDatabase().prepare(`SELECT *
+       FROM activity_events
+       ${where}
+       ORDER BY created_at DESC, id DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map((row) => row), total, limit, offset);
+}
+function listObjectActivityRecords(options) {
+	const limit = normalizeLimit(options.limit);
+	const offset = normalizeOffset(options.offset);
+	const params = [options.object.kind, options.object.id];
+	const visibility = options.visibility ? "AND visibility = ?" : "";
+	if (options.visibility) params.push(options.visibility);
+	const total = getSqliteDatabase().prepare(`SELECT COUNT(*) AS count
+       FROM activity_events
+       WHERE primary_object_kind = ? AND primary_object_id = ?
+       ${visibility}`).get(...params).count;
+	return listResult(getSqliteDatabase().prepare(`SELECT *
+       FROM activity_events
+       WHERE primary_object_kind = ? AND primary_object_id = ?
+       ${visibility}
+       ORDER BY created_at DESC, id DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map((row) => row), total, limit, offset);
+}
+function listProjectActivityRecords(options) {
+	const limit = normalizeLimit(options.limit);
+	const offset = normalizeOffset(options.offset);
+	const params = ["project", options.projectId];
+	const relatedClause = options.includeRelated ? `OR EXISTS (
+        SELECT 1 FROM activity_related_projects ar
+        WHERE ar.activity_id = ae.id AND ar.project_id = ?
+      )` : "";
+	if (options.includeRelated) params.push(options.projectId);
+	const visibilityClauseSql = options.visibility ? "AND ae.visibility = ?" : "";
+	if (options.visibility) params.push(options.visibility);
+	const baseWhere = `EXISTS (
+      SELECT 1 FROM activity_scopes s
+      WHERE s.activity_id = ae.id AND s.scope_kind = ? AND s.scope_id = ?
+    ) ${relatedClause}`;
+	const total = getSqliteDatabase().prepare(`SELECT COUNT(*) AS count
+       FROM activity_events ae
+       WHERE (${baseWhere})
+       ${visibilityClauseSql}`).get(...params).count;
+	return listResult(getSqliteDatabase().prepare(`SELECT ae.*
+       FROM activity_events ae
+       WHERE (${baseWhere})
+       ${visibilityClauseSql}
+       ORDER BY ae.created_at DESC, ae.id DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map((row) => row), total, limit, offset);
+}
+function createObjectLinkRecord(input) {
+	const id = input.id ?? randomUUID();
+	const now = input.nowMs ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO object_links (
+        id, from_kind, from_id, from_title, to_kind, to_id, to_title, relation, source, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.from.kind, input.from.id, input.from.title ?? null, input.to.kind, input.to.id, input.to.title ?? null, input.relation, input.source, now);
+	});
+	const row = getSqliteDatabase().prepare(`SELECT * FROM object_links WHERE id = ?`).get(id);
+	if (!row) throw new Error(`Object link was not persisted: ${id}`);
+	return objectLinkFromRow(row);
+}
+function listObjectLinkRecords(object) {
+	return getSqliteDatabase().prepare(`SELECT *
+       FROM object_links
+       WHERE (from_kind = ? AND from_id = ?) OR (to_kind = ? AND to_id = ?)
+       ORDER BY created_at DESC, id DESC`).all(object.kind, object.id, object.kind, object.id).map((row) => objectLinkFromRow(row));
+}
+//#endregion
+export { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent };
+
+//# sourceMappingURL=activity-repository.js.map

package/dist/src/storage/sqlite/activity-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-repository.js","names":[],"sources":["../../../../src/storage/sqlite/activity-repository.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type {\n  ActivityEvent,\n  ActivityEventWithRelations,\n  ActivityListResult,\n  ActivityObjectRef,\n  ActivityRelatedProject,\n  ActivityScope,\n  ActivitySource,\n  ActivityPrincipal,\n  CreateObjectLinkInput,\n  ListActivityOptions,\n  ListObjectActivityOptions,\n  ListProjectActivityOptions,\n  ObjectLink,\n  RecordActivityInput,\n} from '../../activity/types.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\ntype ActivityEventRow = {\n  id: string;\n  type: string;\n  primary_object_kind: string;\n  primary_object_id: string;\n  primary_object_title: string | null;\n  actor_json: string;\n  initiator_json: string | null;\n  source_json: string;\n  payload_json: string;\n  visibility: string;\n  importance: string;\n  created_at: number;\n};\n\ntype ActivityScopeRow = {\n  activity_id: string;\n  scope_kind: string;\n  scope_id: string;\n  reason: string;\n};\n\ntype ActivityRelatedProjectRow = {\n  activity_id: string;\n  project_id: string;\n  reason: string;\n  confidence: number;\n  computed_at: number;\n};\n\ntype ObjectLinkRow = {\n  id: string;\n  from_kind: string;\n  from_id: string;\n  from_title: string | null;\n  to_kind: string;\n  to_id: string;\n  to_title: string | null;\n  relation: string;\n  source: string;\n  created_at: number;\n};\n\ntype CountRow = { count: number };\ntype SqlParam = string | number | bigint | null;\n\nfunction parseJson<T>(json: string, fallback: T): T {\n  try {\n    return JSON.parse(json) as T;\n  } catch {\n    return fallback;\n  }\n}\n\nfunction eventFromRow(row: ActivityEventRow): ActivityEvent {\n  return {\n    id: row.id,\n    type: row.type,\n    primaryObject: {\n      kind: row.primary_object_kind as ActivityObjectRef['kind'],\n      id: row.primary_object_id,\n      title: row.primary_object_title ?? undefined,\n    },\n    actor: parseJson<ActivityPrincipal>(row.actor_json, { kind: 'system' }),\n    initiator: row.initiator_json ? parseJson<ActivityPrincipal | undefined>(row.initiator_json, undefined) : undefined,\n    source: parseJson<ActivitySource>(row.source_json, { kind: 'system' }),\n    payload: parseJson<Record<string, unknown>>(row.payload_json, {}),\n    visibility: row.visibility as ActivityEvent['visibility'],\n    importance: row.importance as ActivityEvent['importance'],\n    createdAt: row.created_at,\n  };\n}\n\nfunction scopeFromRow(row: ActivityScopeRow): ActivityScope {\n  return {\n    activityId: row.activity_id,\n    scopeKind: row.scope_kind as ActivityScope['scopeKind'],\n    scopeId: row.scope_id,\n    reason: row.reason as ActivityScope['reason'],\n  };\n}\n\nfunction relatedProjectFromRow(row: ActivityRelatedProjectRow): ActivityRelatedProject {\n  return {\n    activityId: row.activity_id,\n    projectId: row.project_id,\n    reason: row.reason as ActivityRelatedProject['reason'],\n    confidence: row.confidence,\n    computedAt: row.computed_at,\n  };\n}\n\nfunction objectLinkFromRow(row: ObjectLinkRow): ObjectLink {\n  return {\n    id: row.id,\n    from: {\n      kind: row.from_kind as ActivityObjectRef['kind'],\n      id: row.from_id,\n      title: row.from_title ?? undefined,\n    },\n    to: {\n      kind: row.to_kind as ActivityObjectRef['kind'],\n      id: row.to_id,\n      title: row.to_title ?? undefined,\n    },\n    relation: row.relation as ObjectLink['relation'],\n    source: row.source as ObjectLink['source'],\n    createdAt: row.created_at,\n  };\n}\n\nfunction listScopesForActivity(activityId: string): ActivityScope[] {\n  return getSqliteDatabase()\n    .prepare(\n      `SELECT activity_id, scope_kind, scope_id, reason\n       FROM activity_scopes\n       WHERE activity_id = ?\n       ORDER BY scope_kind ASC, scope_id ASC, reason ASC`,\n    )\n    .all(activityId)\n    .map((row) => scopeFromRow(row as ActivityScopeRow));\n}\n\nfunction listRelatedProjectsForActivity(activityId: string): ActivityRelatedProject[] {\n  return getSqliteDatabase()\n    .prepare(\n      `SELECT activity_id, project_id, reason, confidence, computed_at\n       FROM activity_related_projects\n       WHERE activity_id = ?\n       ORDER BY project_id ASC, reason ASC`,\n    )\n    .all(activityId)\n    .map((row) => relatedProjectFromRow(row as ActivityRelatedProjectRow));\n}\n\nfunction eventWithRelations(row: ActivityEventRow): ActivityEventWithRelations {\n  const event = eventFromRow(row);\n  return {\n    ...event,\n    scopes: listScopesForActivity(event.id),\n    relatedProjects: listRelatedProjectsForActivity(event.id),\n  };\n}\n\nfunction normalizeLimit(limit: number | undefined): number {\n  return Math.max(1, Math.min(100, Math.floor(limit ?? 50)));\n}\n\nfunction normalizeOffset(offset: number | undefined): number {\n  return Math.max(0, Math.floor(offset ?? 0));\n}\n\nfunction visibilityClause(visibility: string | undefined, params: SqlParam[]): string {\n  if (!visibility) return '';\n  params.push(visibility);\n  return 'WHERE visibility = ?';\n}\n\nfunction listResult(rows: ActivityEventRow[], total: number, limit: number, offset: number): ActivityListResult {\n  return {\n    items: rows.map(eventWithRelations),\n    total,\n    limit,\n    offset,\n    hasMore: offset + rows.length < total,\n  };\n}\n\nexport function recordActivityEvent(input: RecordActivityInput): ActivityEventWithRelations {\n  const id = input.id ?? randomUUID();\n  const now = input.nowMs ?? Date.now();\n  const visibility = input.visibility ?? 'timeline';\n  const importance = input.importance ?? 'normal';\n  const payload = input.payload ?? {};\n\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO activity_events (\n        id, type, primary_object_kind, primary_object_id, primary_object_title,\n        actor_json, initiator_json, source_json, payload_json,\n        visibility, importance, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      id,\n      input.type,\n      input.primaryObject.kind,\n      input.primaryObject.id,\n      input.primaryObject.title ?? null,\n      JSON.stringify(input.actor),\n      input.initiator ? JSON.stringify(input.initiator) : null,\n      JSON.stringify(input.source),\n      JSON.stringify(payload),\n      visibility,\n      importance,\n      now,\n    );\n\n    for (const scope of input.scopes ?? []) {\n      db.prepare(\n        `INSERT OR IGNORE INTO activity_scopes (activity_id, scope_kind, scope_id, reason)\n         VALUES (?, ?, ?, ?)`,\n      ).run(id, scope.scopeKind, scope.scopeId, scope.reason);\n    }\n\n    for (const related of input.relatedProjects ?? []) {\n      db.prepare(\n        `INSERT OR REPLACE INTO activity_related_projects (\n          activity_id, project_id, reason, confidence, computed_at\n        ) VALUES (?, ?, ?, ?, ?)`,\n      ).run(id, related.projectId, related.reason, related.confidence, related.computedAt ?? now);\n    }\n  });\n\n  const event = getActivityEventRecord(id);\n  if (!event) {\n    throw new Error(`Activity event was not persisted: ${id}`);\n  }\n  return event;\n}\n\nexport function getActivityEventRecord(id: string): ActivityEventWithRelations | null {\n  const row = getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM activity_events\n       WHERE id = ?`,\n    )\n    .get(id) as ActivityEventRow | undefined;\n  return row ? eventWithRelations(row) : null;\n}\n\nexport function listActivityRecords(options: ListActivityOptions = {}): ActivityListResult {\n  const limit = normalizeLimit(options.limit);\n  const offset = normalizeOffset(options.offset);\n  const params: SqlParam[] = [];\n  const where = visibilityClause(options.visibility, params);\n  const total = (getSqliteDatabase()\n    .prepare(`SELECT COUNT(*) AS count FROM activity_events ${where}`)\n    .get(...params) as CountRow).count;\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM activity_events\n       ${where}\n       ORDER BY created_at DESC, id DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset)\n    .map((row) => row as ActivityEventRow);\n  return listResult(rows, total, limit, offset);\n}\n\nexport function listObjectActivityRecords(options: ListObjectActivityOptions): ActivityListResult {\n  const limit = normalizeLimit(options.limit);\n  const offset = normalizeOffset(options.offset);\n  const params: SqlParam[] = [options.object.kind, options.object.id];\n  const visibility = options.visibility ? 'AND visibility = ?' : '';\n  if (options.visibility) params.push(options.visibility);\n  const total = (getSqliteDatabase()\n    .prepare(\n      `SELECT COUNT(*) AS count\n       FROM activity_events\n       WHERE primary_object_kind = ? AND primary_object_id = ?\n       ${visibility}`,\n    )\n    .get(...params) as CountRow).count;\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM activity_events\n       WHERE primary_object_kind = ? AND primary_object_id = ?\n       ${visibility}\n       ORDER BY created_at DESC, id DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset)\n    .map((row) => row as ActivityEventRow);\n  return listResult(rows, total, limit, offset);\n}\n\nexport function listProjectActivityRecords(options: ListProjectActivityOptions): ActivityListResult {\n  const limit = normalizeLimit(options.limit);\n  const offset = normalizeOffset(options.offset);\n  const params: SqlParam[] = ['project', options.projectId];\n  const relatedClause = options.includeRelated\n    ? `OR EXISTS (\n        SELECT 1 FROM activity_related_projects ar\n        WHERE ar.activity_id = ae.id AND ar.project_id = ?\n      )`\n    : '';\n  if (options.includeRelated) params.push(options.projectId);\n  const visibilityClauseSql = options.visibility ? 'AND ae.visibility = ?' : '';\n  if (options.visibility) params.push(options.visibility);\n\n  const baseWhere = `EXISTS (\n      SELECT 1 FROM activity_scopes s\n      WHERE s.activity_id = ae.id AND s.scope_kind = ? AND s.scope_id = ?\n    ) ${relatedClause}`;\n\n  const total = (getSqliteDatabase()\n    .prepare(\n      `SELECT COUNT(*) AS count\n       FROM activity_events ae\n       WHERE (${baseWhere})\n       ${visibilityClauseSql}`,\n    )\n    .get(...params) as CountRow).count;\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT ae.*\n       FROM activity_events ae\n       WHERE (${baseWhere})\n       ${visibilityClauseSql}\n       ORDER BY ae.created_at DESC, ae.id DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset)\n    .map((row) => row as ActivityEventRow);\n  return listResult(rows, total, limit, offset);\n}\n\nexport function createObjectLinkRecord(input: CreateObjectLinkInput): ObjectLink {\n  const id = input.id ?? randomUUID();\n  const now = input.nowMs ?? Date.now();\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO object_links (\n        id, from_kind, from_id, from_title, to_kind, to_id, to_title, relation, source, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      id,\n      input.from.kind,\n      input.from.id,\n      input.from.title ?? null,\n      input.to.kind,\n      input.to.id,\n      input.to.title ?? null,\n      input.relation,\n      input.source,\n      now,\n    );\n  });\n  const row = getSqliteDatabase()\n    .prepare(`SELECT * FROM object_links WHERE id = ?`)\n    .get(id) as ObjectLinkRow | undefined;\n  if (!row) {\n    throw new Error(`Object link was not persisted: ${id}`);\n  }\n  return objectLinkFromRow(row);\n}\n\nexport function listObjectLinkRecords(object: ActivityObjectRef): ObjectLink[] {\n  return getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM object_links\n       WHERE (from_kind = ? AND from_id = ?) OR (to_kind = ? AND to_id = ?)\n       ORDER BY created_at DESC, id DESC`,\n    )\n    .all(object.kind, object.id, object.kind, object.id)\n    .map((row) => objectLinkFromRow(row as ObjectLinkRow));\n}\n"],"mappings":";;;AAkEA,SAAS,UAAa,MAAc,UAAgB;AAClD,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO;;;AAIX,SAAS,aAAa,KAAsC;AAC1D,QAAO;EACL,IAAI,IAAI;EACR,MAAM,IAAI;EACV,eAAe;GACb,MAAM,IAAI;GACV,IAAI,IAAI;GACR,OAAO,IAAI,wBAAwB,KAAA;GACpC;EACD,OAAO,UAA6B,IAAI,YAAY,EAAE,MAAM,UAAU,CAAC;EACvE,WAAW,IAAI,iBAAiB,UAAyC,IAAI,gBAAgB,KAAA,EAAU,GAAG,KAAA;EAC1G,QAAQ,UAA0B,IAAI,aAAa,EAAE,MAAM,UAAU,CAAC;EACtE,SAAS,UAAmC,IAAI,cAAc,EAAE,CAAC;EACjE,YAAY,IAAI;EAChB,YAAY,IAAI;EAChB,WAAW,IAAI;EAChB;;AAGH,SAAS,aAAa,KAAsC;AAC1D,QAAO;EACL,YAAY,IAAI;EAChB,WAAW,IAAI;EACf,SAAS,IAAI;EACb,QAAQ,IAAI;EACb;;AAGH,SAAS,sBAAsB,KAAwD;AACrF,QAAO;EACL,YAAY,IAAI;EAChB,WAAW,IAAI;EACf,QAAQ,IAAI;EACZ,YAAY,IAAI;EAChB,YAAY,IAAI;EACjB;;AAGH,SAAS,kBAAkB,KAAgC;AACzD,QAAO;EACL,IAAI,IAAI;EACR,MAAM;GACJ,MAAM,IAAI;GACV,IAAI,IAAI;GACR,OAAO,IAAI,cAAc,KAAA;GAC1B;EACD,IAAI;GACF,MAAM,IAAI;GACV,IAAI,IAAI;GACR,OAAO,IAAI,YAAY,KAAA;GACxB;EACD,UAAU,IAAI;EACd,QAAQ,IAAI;EACZ,WAAW,IAAI;EAChB;;AAGH,SAAS,sBAAsB,YAAqC;AAClE,QAAO,mBAAmB,CACvB,QACC;;;0DAID,CACA,IAAI,WAAW,CACf,KAAK,QAAQ,aAAa,IAAwB,CAAC;;AAGxD,SAAS,+BAA+B,YAA8C;AACpF,QAAO,mBAAmB,CACvB,QACC;;;4CAID,CACA,IAAI,WAAW,CACf,KAAK,QAAQ,sBAAsB,IAAiC,CAAC;;AAG1E,SAAS,mBAAmB,KAAmD;CAC7E,MAAM,QAAQ,aAAa,IAAI;AAC/B,QAAO;EACL,GAAG;EACH,QAAQ,sBAAsB,MAAM,GAAG;EACvC,iBAAiB,+BAA+B,MAAM,GAAG;EAC1D;;AAGH,SAAS,eAAe,OAAmC;AACzD,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM,SAAS,GAAG,CAAC,CAAC;;AAG5D,SAAS,gBAAgB,QAAoC;AAC3D,QAAO,KAAK,IAAI,GAAG,KAAK,MAAM,UAAU,EAAE,CAAC;;AAG7C,SAAS,iBAAiB,YAAgC,QAA4B;AACpF,KAAI,CAAC,WAAY,QAAO;AACxB,QAAO,KAAK,WAAW;AACvB,QAAO;;AAGT,SAAS,WAAW,MAA0B,OAAe,OAAe,QAAoC;AAC9G,QAAO;EACL,OAAO,KAAK,IAAI,mBAAmB;EACnC;EACA;EACA;EACA,SAAS,SAAS,KAAK,SAAS;EACjC;;AAGH,SAAgB,oBAAoB,OAAwD;CAC1F,MAAM,KAAK,MAAM,MAAM,YAAY;CACnC,MAAM,MAAM,MAAM,SAAS,KAAK,KAAK;CACrC,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,UAAU,MAAM,WAAW,EAAE;AAEnC,4BAA2B,OAAO;AAChC,KAAG,QACD;;;;qDAKD,CAAC,IACA,IACA,MAAM,MACN,MAAM,cAAc,MACpB,MAAM,cAAc,IACpB,MAAM,cAAc,SAAS,MAC7B,KAAK,UAAU,MAAM,MAAM,EAC3B,MAAM,YAAY,KAAK,UAAU,MAAM,UAAU,GAAG,MACpD,KAAK,UAAU,MAAM,OAAO,EAC5B,KAAK,UAAU,QAAQ,EACvB,YACA,YACA,IACD;AAED,OAAK,MAAM,SAAS,MAAM,UAAU,EAAE,CACpC,IAAG,QACD;8BAED,CAAC,IAAI,IAAI,MAAM,WAAW,MAAM,SAAS,MAAM,OAAO;AAGzD,OAAK,MAAM,WAAW,MAAM,mBAAmB,EAAE,CAC/C,IAAG,QACD;;kCAGD,CAAC,IAAI,IAAI,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,YAAY,QAAQ,cAAc,IAAI;GAE7F;CAEF,MAAM,QAAQ,uBAAuB,GAAG;AACxC,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,qCAAqC,KAAK;AAE5D,QAAO;;AAGT,SAAgB,uBAAuB,IAA+C;CACpF,MAAM,MAAM,mBAAmB,CAC5B,QACC;;qBAGD,CACA,IAAI,GAAG;AACV,QAAO,MAAM,mBAAmB,IAAI,GAAG;;AAGzC,SAAgB,oBAAoB,UAA+B,EAAE,EAAsB;CACzF,MAAM,QAAQ,eAAe,QAAQ,MAAM;CAC3C,MAAM,SAAS,gBAAgB,QAAQ,OAAO;CAC9C,MAAM,SAAqB,EAAE;CAC7B,MAAM,QAAQ,iBAAiB,QAAQ,YAAY,OAAO;CAC1D,MAAM,QAAS,mBAAmB,CAC/B,QAAQ,iDAAiD,QAAQ,CACjE,IAAI,GAAG,OAAO,CAAc;AAW/B,QAAO,WAVM,mBAAmB,CAC7B,QACC;;SAEG,MAAM;;yBAGV,CACA,IAAI,GAAG,QAAQ,OAAO,OAAO,CAC7B,KAAK,QAAQ,IACM,EAAE,OAAO,OAAO,OAAO;;AAG/C,SAAgB,0BAA0B,SAAwD;CAChG,MAAM,QAAQ,eAAe,QAAQ,MAAM;CAC3C,MAAM,SAAS,gBAAgB,QAAQ,OAAO;CAC9C,MAAM,SAAqB,CAAC,QAAQ,OAAO,MAAM,QAAQ,OAAO,GAAG;CACnE,MAAM,aAAa,QAAQ,aAAa,uBAAuB;AAC/D,KAAI,QAAQ,WAAY,QAAO,KAAK,QAAQ,WAAW;CACvD,MAAM,QAAS,mBAAmB,CAC/B,QACC;;;SAGG,aACJ,CACA,IAAI,GAAG,OAAO,CAAc;AAY/B,QAAO,WAXM,mBAAmB,CAC7B,QACC;;;SAGG,WAAW;;yBAGf,CACA,IAAI,GAAG,QAAQ,OAAO,OAAO,CAC7B,KAAK,QAAQ,IACM,EAAE,OAAO,OAAO,OAAO;;AAG/C,SAAgB,2BAA2B,SAAyD;CAClG,MAAM,QAAQ,eAAe,QAAQ,MAAM;CAC3C,MAAM,SAAS,gBAAgB,QAAQ,OAAO;CAC9C,MAAM,SAAqB,CAAC,WAAW,QAAQ,UAAU;CACzD,MAAM,gBAAgB,QAAQ,iBAC1B;;;WAIA;AACJ,KAAI,QAAQ,eAAgB,QAAO,KAAK,QAAQ,UAAU;CAC1D,MAAM,sBAAsB,QAAQ,aAAa,0BAA0B;AAC3E,KAAI,QAAQ,WAAY,QAAO,KAAK,QAAQ,WAAW;CAEvD,MAAM,YAAY;;;QAGZ;CAEN,MAAM,QAAS,mBAAmB,CAC/B,QACC;;gBAEU,UAAU;SACjB,sBACJ,CACA,IAAI,GAAG,OAAO,CAAc;AAY/B,QAAO,WAXM,mBAAmB,CAC7B,QACC;;gBAEU,UAAU;SACjB,oBAAoB;;yBAGxB,CACA,IAAI,GAAG,QAAQ,OAAO,OAAO,CAC7B,KAAK,QAAQ,IACM,EAAE,OAAO,OAAO,OAAO;;AAG/C,SAAgB,uBAAuB,OAA0C;CAC/E,MAAM,KAAK,MAAM,MAAM,YAAY;CACnC,MAAM,MAAM,MAAM,SAAS,KAAK,KAAK;AACrC,4BAA2B,OAAO;AAChC,KAAG,QACD;;+CAGD,CAAC,IACA,IACA,MAAM,KAAK,MACX,MAAM,KAAK,IACX,MAAM,KAAK,SAAS,MACpB,MAAM,GAAG,MACT,MAAM,GAAG,IACT,MAAM,GAAG,SAAS,MAClB,MAAM,UACN,MAAM,QACN,IACD;GACD;CACF,MAAM,MAAM,mBAAmB,CAC5B,QAAQ,0CAA0C,CAClD,IAAI,GAAG;AACV,KAAI,CAAC,IACH,OAAM,IAAI,MAAM,kCAAkC,KAAK;AAEzD,QAAO,kBAAkB,IAAI;;AAG/B,SAAgB,sBAAsB,QAAyC;AAC7E,QAAO,mBAAmB,CACvB,QACC;;;0CAID,CACA,IAAI,OAAO,MAAM,OAAO,IAAI,OAAO,MAAM,OAAO,GAAG,CACnD,KAAK,QAAQ,kBAAkB,IAAqB,CAAC"}

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

@@ -1,9 +1,9 @@
 import { resolveXopcDatabasePath } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { ensureXopcDatabaseSchema } from "./schema.js";
 import { requireNodeSqlite } from "../../infra/node-sqlite.js";
 import { installSqliteTransientRejectionHandler } from "../../infra/unhandled-rejections.js";
-import { ensureXopcDatabaseSchema } from "./schema.js";
 import path from "node:path";
 import fs from "node:fs";
 import childProcess from "node:child_process";

package/dist/src/storage/sqlite/index.d.ts

@@ -14,3 +14,4 @@ export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgen
 export { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex, type MemorySearchHit, } from './memory-index-repository.js';
 export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemorySignalRowPayload, type MemoryTraceFeedback, type MemoryTraceEventPayload, type SearchMemoryRecordsOptions, type SetMemoryTraceFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';
+export { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent, } from './activity-repository.js';