@xopcai/xopc 0.0.102 → 0.0.104

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';\n\n/** Transcript row for TUI and HTTP clients (flattened from persisted session messages). */\nexport interface ClientHistoryMessage {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n  timestamp?: number;\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"],"mappings":";AAUA,SAAgB,sBAAsB,SAAqC;AACzE,KAAI,OAAO,YAAY,SAAU,QAAO;AACxC,KAAI,CAAC,MAAM,QAAQ,QAAQ,CAAE,QAAO;CACpC,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,SAAS,SAAS;AAC3B,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM;EACjD,MAAM,IAAI;AACV,MAAI,EAAE,SAAS,UAAU,OAAO,EAAE,SAAS,SACzC,OAAM,KAAK,EAAE,KAAK;;AAGtB,QAAO,MAAM,KAAK,GAAG;;AAGvB,SAAS,eAAe,IAA4C;AAClE,KAAI,CAAC,GAAI,QAAO,KAAA;CAChB,MAAM,KAAK,KAAK,MAAM,GAAG;AACzB,QAAO,OAAO,SAAS,GAAG,GAAG,KAAK,KAAA;;AAGpC,SAAS,uBAAuB,KAAsB;CACpD,MAAM,IAAI,IAAI,MAAM;AACpB,KAAI,CAAC,EAAG,QAAO,KAAA;AACf,KAAI;AACF,SAAO,KAAK,MAAM,EAAE;SACd;AACN,SAAO;;;AAIX,SAAS,mBAAmB,UAAuE;CACjG,MAAM,sBAAM,IAAI,KAAkD;AAClE,MAAK,MAAM,KAAK,UAAU;AACxB,MAAI,EAAE,SAAS,UAAU,EAAE,SAAS,aAAc;EAClD,MAAM,KAAK,EAAE;AACb,MAAI,CAAC,MAAM,OAAO,OAAO,SAAU;AACnC,MAAI,IAAI,IAAI;GACV,MAAM,sBAAsB,EAAE,QAAQ;GACtC,SAAS,EAAE;GACZ,CAAC;;AAEJ,QAAO;;AAGT,SAAS,qBACP,YACA,SAC+C;AAC/C,KAAI,CAAC,YAAY,OAAQ,QAAO,KAAA;CAChC,MAAM,MAAsD,EAAE;AAC9D,MAAK,MAAM,MAAM,YAAY;EAC3B,MAAM,MAAM,QAAQ,IAAI,GAAG,GAAG;AAC9B,MAAI,KAAK;GACP,MAAM,GAAG,SAAS;GAClB,MAAM,uBAAuB,GAAG,SAAS,UAAU;GACnD,QAAQ,KAAK;GACb,SAAS,KAAK;GACf,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;;;;;AAO5B,SAAgB,wBACd,UACA,MACwB;CACxB,MAAM,QACJ,MAAM,UAAU,KAAA,KAAa,SAAS,SAAS,KAAK,QAChD,SAAS,MAAM,CAAC,KAAK,MAAM,GAC3B;CAEN,MAAM,UAAU,mBAAmB,MAAM;CACzC,MAAM,MAA8B,EAAE;AAEtC,MAAK,MAAM,KAAK,OAAO;AACrB,MAAI,EAAE,SAAS,UAAU,EAAE,SAAS,aAClC;AAGF,MAAI,EAAE,SAAS,UAAU,EAAE,SAAS,UAAU;GAC5C,MAAM,OAAO,sBAAsB,EAAE,QAAQ;AAC7C,OAAI,KAAK;IACP,MAAM,EAAE;IACR,SAAS;IACT,WAAW,eAAe,EAAE,UAAU;IACvC,CAAC;AACF;;AAGF,MAAI,EAAE,SAAS,aAAa;GAC1B,MAAM,OAAO,sBAAsB,EAAE,QAAQ;GAC7C,MAAM,YAAY,qBAAqB,EAAE,YAAY,QAAQ;AAC7D,OAAI,KAAK;IACP,MAAM;IACN,SAAS;IACT,WAAW,eAAe,EAAE,UAAU;IACtC;IACD,CAAC;;;AAIN,QAAO"}
+{"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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"}

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

@@ -20,10 +20,6 @@ export declare class SessionIndex extends EventEmitter {
     /** Low-level store (e.g. cron resolving weixin delivery from session index). */
     getStore(): SessionStore;
     listSessions(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>>;
-    /**
-     * List all subagent sessions.
-     * Subagent sessions have keys starting with 'subagent:'.
-     */
     listSubagents(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>>;
     getSession(key: string, options?: {
         includeTranscriptSummary?: boolean;
@@ -75,6 +71,20 @@ export declare class SessionIndex extends EventEmitter {
     searchSessions(query: string): Promise<SessionMetadata[]>;
     searchInSession(key: string, keyword: string): Promise<Message[]>;
     exportSession(key: string, format: ExportFormat): Promise<string>;
+    importSessionExport(targetKey: string, jsonContent: string): Promise<{
+        sessionKey: string;
+        rowCount: number;
+    }>;
+    forkSession(sourceKey: string, targetKey: string): Promise<{
+        sessionKey: string;
+        rowCount: number;
+    }>;
+    forkSessionRows(sourceKey: string, targetKey: string, options?: {
+        throughRow?: number;
+    }): Promise<{
+        sessionKey: string;
+        rowCount: number;
+    }>;
     getStats(): Promise<GlobalSessionStats>;
     archiveOldSessions(olderThanDays: number): Promise<number>;
     onSessionCreated(callback: (metadata: SessionMetadata) => void): void;
@@ -118,6 +128,29 @@ export declare class SessionIndex extends EventEmitter {
      * Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).
      */
     appendTranscriptContextEntry(key: string, entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>): Promise<void>;
+    appendTranscriptLabelEntry(key: string, entry: {
+        targetId: string;
+        label?: string;
+    }): Promise<void>;
+    appendTranscriptCustomEntry(key: string, entry: {
+        customType: string;
+        data?: unknown;
+    }): Promise<void>;
+    appendTranscriptCustomMessageEntry(key: string, entry: {
+        customType: string;
+        content?: string | unknown[];
+        display?: boolean;
+        details?: unknown;
+    }): Promise<void>;
+    appendTranscriptBashExecutionEntry(key: string, entry: {
+        command: string;
+        output?: string;
+        exitCode?: number | null;
+        signal?: string | null;
+        excludeFromContext?: boolean;
+        truncated?: boolean;
+        fullOutputPath?: string;
+    }): Promise<void>;
     /** Delete session data */
     delete(key: string): Promise<void>;
     /** Archive transcript and start a new session id for the same key. */

package/dist/src/session/manager.js

@@ -23,23 +23,12 @@ var SessionIndex = class extends EventEmitter$1 {
 	async listSessions(query) {
 		return this.store.list(query);
 	}
-	/**
-	* List all subagent sessions.
-	* Subagent sessions have keys starting with 'subagent:'.
-	*/
 	async listSubagents(query = {}) {
-		const subagentQuery = {
+		return this.store.list({
 			...query,
-			search: query.search ? `subagent:${query.search}` : "subagent:"
-		};
-		const result = await this.store.list(subagentQuery);
-		const subagentSessions = result.items.filter((s) => s.key.startsWith("subagent:"));
-		return {
-			...result,
-			items: subagentSessions,
-			total: subagentSessions.length,
-			hasMore: false
-		};
+			sessionTypes: ["workflow-subagent"],
+			includeHidden: true
+		});
 	}
 	async getSession(key, options) {
 		const session = await this.store.get(key, options);
@@ -151,6 +140,7 @@ var SessionIndex = class extends EventEmitter$1 {
 	async searchSessions(query) {
 		return (await this.store.list({
 			search: query,
+			sessionTypes: ["chat"],
 			limit: 100
 		})).items;
 	}
@@ -160,6 +150,24 @@ var SessionIndex = class extends EventEmitter$1 {
 	async exportSession(key, format) {
 		return this.store.exportSession(key, format);
 	}
+	async importSessionExport(targetKey, jsonContent) {
+		const result = await this.store.importSessionExport(targetKey, jsonContent);
+		const metadata = await this.store.getMetadata(result.sessionKey);
+		if (metadata) this.emit("sessionCreated", metadata);
+		return result;
+	}
+	async forkSession(sourceKey, targetKey) {
+		const result = await this.store.forkSession(sourceKey, targetKey);
+		const metadata = await this.store.getMetadata(result.sessionKey);
+		if (metadata) this.emit("sessionCreated", metadata);
+		return result;
+	}
+	async forkSessionRows(sourceKey, targetKey, options = {}) {
+		const result = await this.store.forkSessionRows(sourceKey, targetKey, options);
+		const metadata = await this.store.getMetadata(result.sessionKey);
+		if (metadata) this.emit("sessionCreated", metadata);
+		return result;
+	}
 	async getStats() {
 		return this.store.getStats();
 	}
@@ -220,6 +228,22 @@ var SessionIndex = class extends EventEmitter$1 {
 		await this.store.appendTranscriptContextEntry(key, entry);
 		this.emit("sessionUpdated", { key });
 	}
+	async appendTranscriptLabelEntry(key, entry) {
+		await this.store.appendTranscriptLabelEntry(key, entry);
+		this.emit("sessionUpdated", { key });
+	}
+	async appendTranscriptCustomEntry(key, entry) {
+		await this.store.appendTranscriptCustomEntry(key, entry);
+		this.emit("sessionUpdated", { key });
+	}
+	async appendTranscriptCustomMessageEntry(key, entry) {
+		await this.store.appendTranscriptCustomMessageEntry(key, entry);
+		this.emit("sessionUpdated", { key });
+	}
+	async appendTranscriptBashExecutionEntry(key, entry) {
+		await this.store.appendTranscriptBashExecutionEntry(key, entry);
+		this.emit("sessionUpdated", { key });
+	}
 	/** Delete session data */
 	async delete(key) {
 		await this.store.delete(key);

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

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

package/dist/src/session/session-context-for-llm.d.ts

@@ -16,8 +16,100 @@ export interface XopcTranscriptContextEntry {
     data?: Record<string, unknown>;
     createdAt?: string;
 }
-export type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry;
+/** Persisted-only row for replaying local shell executions in clients. */
+export interface XopcTranscriptBashExecutionEntry {
+    role: 'bashExecution';
+    command?: string;
+    output?: string | unknown[];
+    exitCode?: number | null;
+    signal?: string | null;
+    excludeFromContext?: boolean;
+    excludedFromContext?: boolean;
+    truncated?: boolean;
+    fullOutputPath?: string;
+    timestamp?: string | number;
+}
+/** Persisted extension-injected message row for client replay. */
+export interface XopcTranscriptCustomMessageEntry {
+    role: 'custom';
+    customType?: string;
+    content?: string | unknown[];
+    display?: boolean;
+    details?: unknown;
+    timestamp?: string | number;
+}
+/** Persisted extension custom_message entry shape before conversion to an agent message. */
+export interface XopcTranscriptCustomMessageFileEntry {
+    type: 'custom_message';
+    customType?: string;
+    content?: string | unknown[];
+    display?: boolean;
+    details?: unknown;
+    timestamp?: string | number;
+}
+/** Persisted extension state entry for replay by extension sessionManager APIs. */
+export interface XopcTranscriptCustomStateEntry {
+    type: 'custom';
+    customType?: string;
+    data?: unknown;
+    timestamp?: string | number;
+}
+/** Persisted branch summary row generated when returning from a branch. */
+export interface XopcTranscriptBranchSummaryEntry {
+    role: 'branchSummary';
+    summary?: string;
+    fromId?: string;
+    timestamp?: string | number;
+}
+/** Persisted compaction summary row generated after transcript compaction. */
+export interface XopcTranscriptCompactionSummaryEntry {
+    role: 'compactionSummary';
+    summary?: string;
+    tokensBefore?: number;
+    timestamp?: string | number;
+}
+/** Persisted label change for a transcript entry. */
+export interface XopcTranscriptLabelEntry {
+    type: 'label';
+    id?: string;
+    parentId?: string | null;
+    targetId?: string;
+    label?: string;
+    timestamp?: string | number;
+}
+/** Persisted thinking level change metadata row. */
+export interface XopcTranscriptThinkingLevelChangeEntry {
+    type: 'thinking_level_change';
+    id?: string;
+    parentId?: string | null;
+    thinkingLevel?: string;
+    timestamp?: string | number;
+}
+/** Persisted model change metadata row. */
+export interface XopcTranscriptModelChangeEntry {
+    type: 'model_change';
+    id?: string;
+    parentId?: string | null;
+    provider?: string;
+    modelId?: string;
+    timestamp?: string | number;
+}
+/** Persisted session info metadata row. */
+export interface XopcTranscriptSessionInfoEntry {
+    type: 'session_info';
+    id?: string;
+    parentId?: string | null;
+    name?: string;
+    timestamp?: string | number;
+}
+export type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry | XopcTranscriptBashExecutionEntry | XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry | XopcTranscriptCustomStateEntry | XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry | XopcTranscriptLabelEntry | XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry;
 export declare function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry;
+export declare function isTranscriptBashExecutionEntry(x: unknown): x is XopcTranscriptBashExecutionEntry;
+export declare function isTranscriptCustomMessageEntry(x: unknown): x is XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry;
+export declare function isTranscriptCustomStateEntry(x: unknown): x is XopcTranscriptCustomStateEntry;
+export declare function isTranscriptSummaryMessageEntry(x: unknown): x is XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry;
+export declare function isTranscriptLabelEntry(x: unknown): x is XopcTranscriptLabelEntry;
+export declare function isTranscriptMetadataEntry(x: unknown): x is XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry;
 /**
  * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).
  */

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

@@ -3,6 +3,33 @@ function isTranscriptContextEntry(x) {
 	if (!x || typeof x !== "object") return false;
 	return x.kind === "context";
 }
+function isTranscriptBashExecutionEntry(x) {
+	if (!x || typeof x !== "object") return false;
+	return x.role === "bashExecution";
+}
+function isTranscriptCustomMessageEntry(x) {
+	if (!x || typeof x !== "object") return false;
+	const row = x;
+	return row.role === "custom" || row.type === "custom_message";
+}
+function isTranscriptCustomStateEntry(x) {
+	if (!x || typeof x !== "object") return false;
+	return x.type === "custom";
+}
+function isTranscriptSummaryMessageEntry(x) {
+	if (!x || typeof x !== "object") return false;
+	const role = x.role;
+	return role === "branchSummary" || role === "compactionSummary";
+}
+function isTranscriptLabelEntry(x) {
+	if (!x || typeof x !== "object") return false;
+	return x.type === "label";
+}
+function isTranscriptMetadataEntry(x) {
+	if (!x || typeof x !== "object") return false;
+	const type = x.type;
+	return type === "thinking_level_change" || type === "model_change" || type === "session_info";
+}
 const LLM_ROLES = new Set([
 	"user",
 	"assistant",
@@ -15,6 +42,49 @@ function isLikelyAgentMessage(x) {
 	const role = x.role;
 	return typeof role === "string" && LLM_ROLES.has(role);
 }
+function parseTimestampValue(timestamp) {
+	if (typeof timestamp === "number") return Number.isFinite(timestamp) ? timestamp : void 0;
+	if (typeof timestamp !== "string") return;
+	const ms = Date.parse(timestamp);
+	return Number.isFinite(ms) ? ms : void 0;
+}
+function customMessageRowToLlmMessage(row) {
+	return {
+		role: "user",
+		content: typeof row.content === "string" ? [{
+			type: "text",
+			text: row.content
+		}] : Array.isArray(row.content) ? row.content : [{
+			type: "text",
+			text: ""
+		}],
+		timestamp: parseTimestampValue(row.timestamp)
+	};
+}
+function bashExecutionRowToLlmMessage(row) {
+	if (row.excludeFromContext === true || row.excludedFromContext === true) return null;
+	const command = row.command?.trim();
+	if (!command) return null;
+	const output = typeof row.output === "string" ? row.output : Array.isArray(row.output) ? row.output.filter((part) => typeof part === "object" && part !== null && "type" in part).map((part) => part.type === "text" && typeof part.text === "string" ? part.text : "").join("") : "";
+	const exit = row.exitCode == null ? "?" : String(row.exitCode);
+	const signal = row.signal ? ` signal=${row.signal}` : "";
+	const truncated = row.truncated ? "\n[output truncated]" : "";
+	return {
+		role: "user",
+		content: [{
+			type: "text",
+			text: [
+				"<local_shell>",
+				`$ ${command}`,
+				`exit=${exit}${signal}`,
+				output ? "output:" : "output: (empty)",
+				output.trimEnd(),
+				`${truncated}</local_shell>`
+			].join("\n")
+		}],
+		timestamp: parseTimestampValue(row.timestamp)
+	};
+}
 /**
 * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).
 */
@@ -25,6 +95,30 @@ function transcriptRowsFromJsonArray(arr) {
 			out.push(x);
 			continue;
 		}
+		if (isTranscriptBashExecutionEntry(x)) {
+			out.push(x);
+			continue;
+		}
+		if (isTranscriptCustomMessageEntry(x)) {
+			out.push(x);
+			continue;
+		}
+		if (isTranscriptCustomStateEntry(x)) {
+			out.push(x);
+			continue;
+		}
+		if (isTranscriptSummaryMessageEntry(x)) {
+			out.push(x);
+			continue;
+		}
+		if (isTranscriptLabelEntry(x)) {
+			out.push(x);
+			continue;
+		}
+		if (isTranscriptMetadataEntry(x)) {
+			out.push(x);
+			continue;
+		}
 		if (isLikelyAgentMessage(x)) out.push(x);
 	}
 	return out;
@@ -35,6 +129,15 @@ function buildSessionContextForLlm(rows) {
 	for (const r of rows) {
 		if (isTranscriptContextEntry(r)) continue;
 		if (r.type === "compaction") continue;
+		if (isTranscriptBashExecutionEntry(r)) {
+			const msg = bashExecutionRowToLlmMessage(r);
+			if (msg) out.push(msg);
+			continue;
+		}
+		if (isTranscriptCustomMessageEntry(r)) {
+			out.push(customMessageRowToLlmMessage(r));
+			continue;
+		}
 		if (isLikelyAgentMessage(r)) out.push(r);
 	}
 	return out;
@@ -47,7 +150,7 @@ function buildSessionContextForLlm(rows) {
 function mergeLlmMessagesPreservingContextRows(prevRows, llmMessages) {
 	let i = 0;
 	const out = [];
-	for (const r of prevRows) if (isTranscriptContextEntry(r)) out.push(r);
+	for (const r of prevRows) if (isTranscriptContextEntry(r) || isTranscriptBashExecutionEntry(r) || isTranscriptCustomMessageEntry(r) || isTranscriptCustomStateEntry(r) || isTranscriptSummaryMessageEntry(r) || isTranscriptLabelEntry(r) || isTranscriptMetadataEntry(r)) out.push(r);
 	else if (i < llmMessages.length) {
 		out.push(llmMessages[i]);
 		i += 1;
@@ -59,6 +162,6 @@ function mergeLlmMessagesPreservingContextRows(prevRows, llmMessages) {
 	return out;
 }
 //#endregion
-export { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray };
+export { buildSessionContextForLlm, isTranscriptBashExecutionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptCustomStateEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSummaryMessageEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray };
 
 //# sourceMappingURL=session-context-for-llm.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"session-context-for-llm.js","names":[],"sources":["../../../src/session/session-context-for-llm.ts"],"sourcesContent":["/**\n * Transcript rows persisted on disk may include non-LLM entries (e.g. `kind: 'context'`).\n * {@link buildSessionContextForLlm} is the single choke point for provider-facing history.\n *\n * Do not pass raw on-disk JSONL rows into pi-agent / providers — always run\n * {@link buildSessionContextForLlm} first (or use {@link SessionStore.loadMessages}, which already does).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n/** Persisted-only row: never sent to the model as a chat message. */\nexport interface XopcTranscriptContextEntry {\n  kind: 'context';\n  id?: string;\n  /** Short human-readable line for UIs / logs. */\n  text?: string;\n  /** Structured payload (tool summaries, delivery metadata, etc.). */\n  data?: Record<string, unknown>;\n  createdAt?: string;\n}\n\nexport type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry;\n\nexport function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).kind === 'context';\n}\n\nconst LLM_ROLES = new Set(['user', 'assistant', 'system', 'tool', 'toolResult']);\n\nfunction isLikelyAgentMessage(x: unknown): x is AgentMessage {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return typeof role === 'string' && LLM_ROLES.has(role);\n}\n\n/**\n * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).\n */\nexport function transcriptRowsFromJsonArray(arr: unknown[]): TranscriptStoredRow[] {\n  const out: TranscriptStoredRow[] = [];\n  for (const x of arr) {\n    if (isTranscriptContextEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isLikelyAgentMessage(x)) {\n      out.push(x);\n    }\n  }\n  return out;\n}\n\n/** Messages only — what providers and pi-agent should see. */\nexport function buildSessionContextForLlm(rows: TranscriptStoredRow[]): AgentMessage[] {\n  const out: AgentMessage[] = [];\n  for (const r of rows) {\n    if (isTranscriptContextEntry(r)) {\n      continue;\n    }\n    if ((r as { type?: string }).type === 'compaction') {\n      continue;\n    }\n    if (isLikelyAgentMessage(r)) {\n      out.push(r);\n    }\n  }\n  return out;\n}\n\n/**\n * When persisting LLM messages, keep prior `kind: 'context'` rows in their relative positions:\n * each non-context slot in the previous file is replaced by the next incoming LLM message;\n * trailing new LLM rows are appended. Extra old LLM rows are dropped if the new list is shorter.\n */\nexport function mergeLlmMessagesPreservingContextRows(\n  prevRows: TranscriptStoredRow[],\n  llmMessages: AgentMessage[],\n): TranscriptStoredRow[] {\n  let i = 0;\n  const out: TranscriptStoredRow[] = [];\n  for (const r of prevRows) {\n    if (isTranscriptContextEntry(r)) {\n      out.push(r);\n    } else {\n      if (i < llmMessages.length) {\n        out.push(llmMessages[i]);\n        i += 1;\n      }\n    }\n  }\n  while (i < llmMessages.length) {\n    out.push(llmMessages[i]);\n    i += 1;\n  }\n  return out;\n}\n"],"mappings":";AAuBA,SAAgB,yBAAyB,GAA6C;AACpF,KAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;AACxC,QAAQ,EAA8B,SAAS;;AAGjD,MAAM,YAAY,IAAI,IAAI;CAAC;CAAQ;CAAa;CAAU;CAAQ;CAAa,CAAC;AAEhF,SAAS,qBAAqB,GAA+B;AAC3D,KAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;CACxC,MAAM,OAAQ,EAA8B;AAC5C,QAAO,OAAO,SAAS,YAAY,UAAU,IAAI,KAAK;;;;;AAMxD,SAAgB,4BAA4B,KAAuC;CACjF,MAAM,MAA6B,EAAE;AACrC,MAAK,MAAM,KAAK,KAAK;AACnB,MAAI,yBAAyB,EAAE,EAAE;AAC/B,OAAI,KAAK,EAAE;AACX;;AAEF,MAAI,qBAAqB,EAAE,CACzB,KAAI,KAAK,EAAE;;AAGf,QAAO;;;AAIT,SAAgB,0BAA0B,MAA6C;CACrF,MAAM,MAAsB,EAAE;AAC9B,MAAK,MAAM,KAAK,MAAM;AACpB,MAAI,yBAAyB,EAAE,CAC7B;AAEF,MAAK,EAAwB,SAAS,aACpC;AAEF,MAAI,qBAAqB,EAAE,CACzB,KAAI,KAAK,EAAE;;AAGf,QAAO;;;;;;;AAQT,SAAgB,sCACd,UACA,aACuB;CACvB,IAAI,IAAI;CACR,MAAM,MAA6B,EAAE;AACrC,MAAK,MAAM,KAAK,SACd,KAAI,yBAAyB,EAAE,CAC7B,KAAI,KAAK,EAAE;UAEP,IAAI,YAAY,QAAQ;AAC1B,MAAI,KAAK,YAAY,GAAG;AACxB,OAAK;;AAIX,QAAO,IAAI,YAAY,QAAQ;AAC7B,MAAI,KAAK,YAAY,GAAG;AACxB,OAAK;;AAEP,QAAO"}
+{"version":3,"file":"session-context-for-llm.js","names":[],"sources":["../../../src/session/session-context-for-llm.ts"],"sourcesContent":["/**\n * Transcript rows persisted on disk may include non-LLM entries (e.g. `kind: 'context'`).\n * {@link buildSessionContextForLlm} is the single choke point for provider-facing history.\n *\n * Do not pass raw on-disk JSONL rows into pi-agent / providers — always run\n * {@link buildSessionContextForLlm} first (or use {@link SessionStore.loadMessages}, which already does).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n/** Persisted-only row: never sent to the model as a chat message. */\nexport interface XopcTranscriptContextEntry {\n  kind: 'context';\n  id?: string;\n  /** Short human-readable line for UIs / logs. */\n  text?: string;\n  /** Structured payload (tool summaries, delivery metadata, etc.). */\n  data?: Record<string, unknown>;\n  createdAt?: string;\n}\n\n/** Persisted-only row for replaying local shell executions in clients. */\nexport interface XopcTranscriptBashExecutionEntry {\n  role: 'bashExecution';\n  command?: string;\n  output?: string | unknown[];\n  exitCode?: number | null;\n  signal?: string | null;\n  excludeFromContext?: boolean;\n  excludedFromContext?: boolean;\n  truncated?: boolean;\n  fullOutputPath?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted extension-injected message row for client replay. */\nexport interface XopcTranscriptCustomMessageEntry {\n  role: 'custom';\n  customType?: string;\n  content?: string | unknown[];\n  display?: boolean;\n  details?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted extension custom_message entry shape before conversion to an agent message. */\nexport interface XopcTranscriptCustomMessageFileEntry {\n  type: 'custom_message';\n  customType?: string;\n  content?: string | unknown[];\n  display?: boolean;\n  details?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted extension state entry for replay by extension sessionManager APIs. */\nexport interface XopcTranscriptCustomStateEntry {\n  type: 'custom';\n  customType?: string;\n  data?: unknown;\n  timestamp?: string | number;\n}\n\n/** Persisted branch summary row generated when returning from a branch. */\nexport interface XopcTranscriptBranchSummaryEntry {\n  role: 'branchSummary';\n  summary?: string;\n  fromId?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted compaction summary row generated after transcript compaction. */\nexport interface XopcTranscriptCompactionSummaryEntry {\n  role: 'compactionSummary';\n  summary?: string;\n  tokensBefore?: number;\n  timestamp?: string | number;\n}\n\n/** Persisted label change for a transcript entry. */\nexport interface XopcTranscriptLabelEntry {\n  type: 'label';\n  id?: string;\n  parentId?: string | null;\n  targetId?: string;\n  label?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted thinking level change metadata row. */\nexport interface XopcTranscriptThinkingLevelChangeEntry {\n  type: 'thinking_level_change';\n  id?: string;\n  parentId?: string | null;\n  thinkingLevel?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted model change metadata row. */\nexport interface XopcTranscriptModelChangeEntry {\n  type: 'model_change';\n  id?: string;\n  parentId?: string | null;\n  provider?: string;\n  modelId?: string;\n  timestamp?: string | number;\n}\n\n/** Persisted session info metadata row. */\nexport interface XopcTranscriptSessionInfoEntry {\n  type: 'session_info';\n  id?: string;\n  parentId?: string | null;\n  name?: string;\n  timestamp?: string | number;\n}\n\nexport type TranscriptStoredRow =\n  | AgentMessage\n  | XopcTranscriptContextEntry\n  | XopcTranscriptBashExecutionEntry\n  | XopcTranscriptCustomMessageEntry\n  | XopcTranscriptCustomMessageFileEntry\n  | XopcTranscriptCustomStateEntry\n  | XopcTranscriptBranchSummaryEntry\n  | XopcTranscriptCompactionSummaryEntry\n  | XopcTranscriptLabelEntry\n  | XopcTranscriptThinkingLevelChangeEntry\n  | XopcTranscriptModelChangeEntry\n  | XopcTranscriptSessionInfoEntry;\n\nexport function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).kind === 'context';\n}\n\nexport function isTranscriptBashExecutionEntry(x: unknown): x is XopcTranscriptBashExecutionEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).role === 'bashExecution';\n}\n\nexport function isTranscriptCustomMessageEntry(\n  x: unknown,\n): x is XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry {\n  if (!x || typeof x !== 'object') return false;\n  const row = x as Record<string, unknown>;\n  return row.role === 'custom' || row.type === 'custom_message';\n}\n\nexport function isTranscriptCustomStateEntry(x: unknown): x is XopcTranscriptCustomStateEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).type === 'custom';\n}\n\nexport function isTranscriptSummaryMessageEntry(\n  x: unknown,\n): x is XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return role === 'branchSummary' || role === 'compactionSummary';\n}\n\nexport function isTranscriptLabelEntry(x: unknown): x is XopcTranscriptLabelEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).type === 'label';\n}\n\nexport function isTranscriptMetadataEntry(\n  x: unknown,\n): x is XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry {\n  if (!x || typeof x !== 'object') return false;\n  const type = (x as Record<string, unknown>).type;\n  return type === 'thinking_level_change' || type === 'model_change' || type === 'session_info';\n}\n\nconst LLM_ROLES = new Set(['user', 'assistant', 'system', 'tool', 'toolResult']);\n\nfunction isLikelyAgentMessage(x: unknown): x is AgentMessage {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return typeof role === 'string' && LLM_ROLES.has(role);\n}\n\nfunction parseTimestampValue(timestamp: string | number | undefined): number | undefined {\n  if (typeof timestamp === 'number') {\n    return Number.isFinite(timestamp) ? timestamp : undefined;\n  }\n  if (typeof timestamp !== 'string') {\n    return undefined;\n  }\n  const ms = Date.parse(timestamp);\n  return Number.isFinite(ms) ? ms : undefined;\n}\n\nfunction customMessageRowToLlmMessage(\n  row: XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry,\n): AgentMessage {\n  const content = typeof row.content === 'string'\n    ? [{ type: 'text' as const, text: row.content }]\n    : Array.isArray(row.content)\n      ? row.content\n      : [{ type: 'text' as const, text: '' }];\n  return {\n    role: 'user',\n    content,\n    timestamp: parseTimestampValue(row.timestamp),\n  } as AgentMessage;\n}\n\nfunction bashExecutionRowToLlmMessage(row: XopcTranscriptBashExecutionEntry): AgentMessage | null {\n  if (row.excludeFromContext === true || row.excludedFromContext === true) {\n    return null;\n  }\n  const command = row.command?.trim();\n  if (!command) {\n    return null;\n  }\n  const output = typeof row.output === 'string'\n    ? row.output\n    : Array.isArray(row.output)\n      ? row.output\n        .filter((part): part is { type: string; text?: string } =>\n          typeof part === 'object' && part !== null && 'type' in part)\n        .map((part) => (part.type === 'text' && typeof part.text === 'string' ? part.text : ''))\n        .join('')\n      : '';\n  const exit = row.exitCode == null ? '?' : String(row.exitCode);\n  const signal = row.signal ? ` signal=${row.signal}` : '';\n  const truncated = row.truncated ? '\\n[output truncated]' : '';\n  return {\n    role: 'user',\n    content: [{\n      type: 'text',\n      text: [\n        '<local_shell>',\n        `$ ${command}`,\n        `exit=${exit}${signal}`,\n        output ? 'output:' : 'output: (empty)',\n        output.trimEnd(),\n        `${truncated}</local_shell>`,\n      ].join('\\n'),\n    }],\n    timestamp: parseTimestampValue(row.timestamp),\n  } as AgentMessage;\n}\n\n/**\n * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).\n */\nexport function transcriptRowsFromJsonArray(arr: unknown[]): TranscriptStoredRow[] {\n  const out: TranscriptStoredRow[] = [];\n  for (const x of arr) {\n    if (isTranscriptContextEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptBashExecutionEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptCustomMessageEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptCustomStateEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptSummaryMessageEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptLabelEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isTranscriptMetadataEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isLikelyAgentMessage(x)) {\n      out.push(x);\n    }\n  }\n  return out;\n}\n\n/** Messages only — what providers and pi-agent should see. */\nexport function buildSessionContextForLlm(rows: TranscriptStoredRow[]): AgentMessage[] {\n  const out: AgentMessage[] = [];\n  for (const r of rows) {\n    if (isTranscriptContextEntry(r)) {\n      continue;\n    }\n    if ((r as { type?: string }).type === 'compaction') {\n      continue;\n    }\n    if (isTranscriptBashExecutionEntry(r)) {\n      const msg = bashExecutionRowToLlmMessage(r);\n      if (msg) out.push(msg);\n      continue;\n    }\n    if (isTranscriptCustomMessageEntry(r)) {\n      out.push(customMessageRowToLlmMessage(r));\n      continue;\n    }\n    if (isLikelyAgentMessage(r)) {\n      out.push(r);\n    }\n  }\n  return out;\n}\n\n/**\n * When persisting LLM messages, keep prior `kind: 'context'` rows in their relative positions:\n * each non-context slot in the previous file is replaced by the next incoming LLM message;\n * trailing new LLM rows are appended. Extra old LLM rows are dropped if the new list is shorter.\n */\nexport function mergeLlmMessagesPreservingContextRows(\n  prevRows: TranscriptStoredRow[],\n  llmMessages: AgentMessage[],\n): TranscriptStoredRow[] {\n  let i = 0;\n  const out: TranscriptStoredRow[] = [];\n  for (const r of prevRows) {\n    if (\n      isTranscriptContextEntry(r) ||\n      isTranscriptBashExecutionEntry(r) ||\n      isTranscriptCustomMessageEntry(r) ||\n      isTranscriptCustomStateEntry(r) ||\n      isTranscriptSummaryMessageEntry(r) ||\n      isTranscriptLabelEntry(r) ||\n      isTranscriptMetadataEntry(r)\n    ) {\n      out.push(r);\n    } else {\n      if (i < llmMessages.length) {\n        out.push(llmMessages[i]);\n        i += 1;\n      }\n    }\n  }\n  while (i < llmMessages.length) {\n    out.push(llmMessages[i]);\n    i += 1;\n  }\n  return out;\n}\n"],"mappings":"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"}

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

@@ -76,6 +76,29 @@ export declare class SessionStore {
     loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null>;
     syncEmbeddedTranscriptUpdate(update: SessionTranscriptUpdate): Promise<void>;
     appendTranscriptContextEntry(key: string, entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>): Promise<void>;
+    appendTranscriptLabelEntry(key: string, entry: {
+        targetId: string;
+        label?: string;
+    }): Promise<void>;
+    appendTranscriptCustomEntry(key: string, entry: {
+        customType: string;
+        data?: unknown;
+    }): Promise<void>;
+    appendTranscriptCustomMessageEntry(key: string, entry: {
+        customType: string;
+        content?: string | unknown[];
+        display?: boolean;
+        details?: unknown;
+    }): Promise<void>;
+    appendTranscriptBashExecutionEntry(key: string, entry: {
+        command: string;
+        output?: string;
+        exitCode?: number | null;
+        signal?: string | null;
+        excludeFromContext?: boolean;
+        truncated?: boolean;
+        fullOutputPath?: string;
+    }): Promise<void>;
     saveMessages(key: string, messages: AgentMessage[]): Promise<void>;
     getWindowStats(messages: AgentMessage[]): {
         total: number;
@@ -117,6 +140,20 @@ export declare class SessionStore {
     estimateTokenUsage(_key: string, messages: AgentMessage[]): Promise<number>;
     searchInSession(key: string, keyword: string): Promise<Message[]>;
     exportSession(key: string, format: ExportFormat): Promise<string>;
+    importSessionExport(targetKey: string, jsonContent: string): Promise<{
+        sessionKey: string;
+        rowCount: number;
+    }>;
+    forkSession(sourceKey: string, targetKey: string): Promise<{
+        sessionKey: string;
+        rowCount: number;
+    }>;
+    forkSessionRows(sourceKey: string, targetKey: string, options?: {
+        throughRow?: number;
+    }): Promise<{
+        sessionKey: string;
+        rowCount: number;
+    }>;
     getStats(): Promise<GlobalSessionStats>;
     archiveOld(olderThanDays: number): Promise<number>;
     estimateTokens(messages: AgentMessage[]): number;