@xopcai/xopc 0.0.103 → 0.0.104

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

@@ -83,7 +83,238 @@ function messagesToClientHistory(messages, opts) {
 	}
 	return out;
 }
+function asHistoryMessageRow(row) {
+	const role = row.role;
+	if (typeof role !== "string" || ![
+		"system",
+		"user",
+		"assistant",
+		"tool",
+		"toolResult"
+	].includes(role)) return null;
+	return row;
+}
+function parseTimestampValue(ts) {
+	if (typeof ts === "number") return Number.isFinite(ts) ? ts : void 0;
+	return parseTimestamp(ts);
+}
+function collectHistoryToolResults(messages) {
+	const map = /* @__PURE__ */ new Map();
+	for (const m of messages) {
+		if (m.role !== "tool" && m.role !== "toolResult") continue;
+		const id = m.tool_call_id ?? m.toolCallId;
+		if (!id || typeof id !== "string") continue;
+		map.set(id, {
+			text: flattenMessageContent(m.content ?? ""),
+			isError: m.isError
+		});
+	}
+	return map;
+}
+function isCompactionRow(row) {
+	return row.type === "compaction";
+}
+function compactionSummaryRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "compactionSummary") return null;
+	return {
+		role: "system",
+		kind: "compaction",
+		content: optionalString(r.summary) ?? "",
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		tokensBefore: typeof r.tokensBefore === "number" ? r.tokensBefore : void 0
+	};
+}
+function contextRowToClientHistory(row) {
+	if (row.kind !== "context") return null;
+	const text = row.text;
+	if (typeof text !== "string" || !text.trim()) return null;
+	const createdAt = row.createdAt;
+	return {
+		role: "system",
+		kind: "context",
+		content: text,
+		timestamp: typeof createdAt === "string" ? parseTimestamp(createdAt) : void 0
+	};
+}
+function optionalString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function bashRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "bashExecution") return null;
+	const command = optionalString(r.command) ?? optionalString(r.content)?.trim();
+	if (!command) return null;
+	const output = Array.isArray(r.output) || typeof r.output === "string" ? flattenMessageContent(r.output) : optionalString(r.output);
+	const exitCode = typeof r.exitCode === "number" ? r.exitCode : r.exitCode === null ? null : void 0;
+	const signal = typeof r.signal === "string" ? r.signal : r.signal === null ? null : void 0;
+	const excludeFromContext = typeof r.excludeFromContext === "boolean" ? r.excludeFromContext : typeof r.excludedFromContext === "boolean" ? r.excludedFromContext : void 0;
+	return {
+		role: "system",
+		kind: "bash",
+		content: output || command,
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		bash: {
+			command,
+			output,
+			exitCode,
+			signal,
+			excludeFromContext,
+			truncated: typeof r.truncated === "boolean" ? r.truncated : void 0,
+			fullOutputPath: optionalString(r.fullOutputPath)
+		}
+	};
+}
+function customRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "custom" && r.type !== "custom_message") return null;
+	const customType = optionalString(r.customType)?.trim();
+	if (!customType) return null;
+	const content = Array.isArray(r.content) || typeof r.content === "string" ? flattenMessageContent(r.content) : "";
+	const timestamp = parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0);
+	return {
+		role: "system",
+		kind: "custom",
+		content,
+		rawContent: Array.isArray(r.content) || typeof r.content === "string" ? r.content : void 0,
+		timestamp,
+		custom: {
+			customType,
+			details: r.details,
+			display: r.display === false ? false : true
+		}
+	};
+}
+function customStateRowToClientHistory(row) {
+	const r = row;
+	if (r.type !== "custom") return null;
+	const customType = optionalString(r.customType)?.trim();
+	if (!customType) return null;
+	return {
+		role: "system",
+		kind: "custom",
+		content: "",
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		custom: {
+			customType,
+			details: r.data,
+			state: true
+		}
+	};
+}
+function branchSummaryRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "branchSummary") return null;
+	const summary = optionalString(r.summary)?.trim();
+	if (!summary) return null;
+	const fromId = optionalString(r.fromId);
+	return {
+		role: "system",
+		kind: "branch",
+		content: summary,
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		branch: {
+			summary,
+			fromId
+		}
+	};
+}
+/**
+* Maps persisted transcript rows into linear chat history, preserving non-LLM
+* audit rows that the TUI can render as dedicated components.
+*/
+function transcriptRowsToClientHistory(rows, opts) {
+	const startIndex = opts?.limit !== void 0 && rows.length > opts.limit ? rows.length - opts.limit : 0;
+	const slice = opts?.limit !== void 0 && rows.length > opts.limit ? rows.slice(-opts.limit) : rows;
+	const results = collectHistoryToolResults(slice.map(asHistoryMessageRow).filter((row) => row !== null));
+	const out = [];
+	for (const [offset, row] of slice.entries()) {
+		const id = `row-${startIndex + offset + 1}`;
+		if (isCompactionRow(row)) {
+			out.push({
+				id,
+				role: "system",
+				kind: "compaction",
+				content: typeof row.summary === "string" ? row.summary : "",
+				timestamp: parseTimestamp(row.at),
+				tokensBefore: row.tokensBefore,
+				tokensAfter: row.tokensAfter
+			});
+			continue;
+		}
+		const compactionSummaryRow = compactionSummaryRowToClientHistory(row);
+		if (compactionSummaryRow) {
+			out.push({
+				id,
+				...compactionSummaryRow
+			});
+			continue;
+		}
+		const contextRow = contextRowToClientHistory(row);
+		if (contextRow) {
+			out.push({
+				id,
+				...contextRow
+			});
+			continue;
+		}
+		const bashRow = bashRowToClientHistory(row);
+		if (bashRow) {
+			out.push({
+				id,
+				...bashRow
+			});
+			continue;
+		}
+		const customRow = customRowToClientHistory(row);
+		if (customRow) {
+			out.push({
+				id,
+				...customRow
+			});
+			continue;
+		}
+		const customStateRow = customStateRowToClientHistory(row);
+		if (customStateRow) {
+			out.push({
+				id,
+				...customStateRow
+			});
+			continue;
+		}
+		const branchSummaryRow = branchSummaryRowToClientHistory(row);
+		if (branchSummaryRow) {
+			out.push({
+				id,
+				...branchSummaryRow
+			});
+			continue;
+		}
+		const messageRow = asHistoryMessageRow(row);
+		if (!messageRow) continue;
+		if (messageRow.role === "tool" || messageRow.role === "toolResult") continue;
+		if (messageRow.role === "user" || messageRow.role === "system") {
+			out.push({
+				id,
+				role: messageRow.role,
+				kind: "message",
+				content: flattenMessageContent(messageRow.content ?? ""),
+				timestamp: parseTimestampValue(messageRow.timestamp)
+			});
+			continue;
+		}
+		out.push({
+			id,
+			role: "assistant",
+			kind: "message",
+			content: flattenMessageContent(messageRow.content ?? ""),
+			timestamp: parseTimestampValue(messageRow.timestamp),
+			toolCalls: toolCallsWithResults(messageRow.tool_calls ?? messageRow.toolCalls, results)
+		});
+	}
+	return out;
+}
 //#endregion
-export { flattenMessageContent, messagesToClientHistory };
+export { flattenMessageContent, messagesToClientHistory, transcriptRowsToClientHistory };
 
 //# sourceMappingURL=client-history.js.map

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).
  */