@xopcai/xopc 0.0.122 → 0.0.124

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

@@ -37,6 +37,8 @@ const LLM_ROLES = new Set([
 	"tool",
 	"toolResult"
 ]);
+const CODING_CONTEXT_LOOKBACK = 80;
+const CODING_CONTEXT_MAX_LINES = 24;
 function isLikelyAgentMessage(x) {
 	if (!x || typeof x !== "object") return false;
 	const role = x.role;
@@ -85,6 +87,153 @@ function bashExecutionRowToLlmMessage(row) {
 		timestamp: parseTimestampValue(row.timestamp)
 	};
 }
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function stringValue(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function parseJsonRecord(value) {
+	if (typeof value !== "string" || !value.trim()) return null;
+	try {
+		return asRecord(JSON.parse(value));
+	} catch {
+		return null;
+	}
+}
+function textFromContent(content) {
+	if (typeof content === "string") return content;
+	if (!Array.isArray(content)) return "";
+	return content.map((part) => {
+		if (typeof part === "string") return part;
+		const rec = asRecord(part);
+		if (!rec) return "";
+		if (rec.type === "text" && typeof rec.text === "string") return rec.text;
+		return "";
+	}).filter(Boolean).join("");
+}
+function toolNameFromBlock(block) {
+	const fn = asRecord(block.function);
+	return stringValue(block.name) ?? stringValue(block.toolName) ?? stringValue(fn?.name) ?? "tool";
+}
+function toolArgsFromBlock(block) {
+	const fn = asRecord(block.function);
+	return asRecord(block.arguments) ?? asRecord(block.args) ?? asRecord(block.input) ?? asRecord(fn?.arguments) ?? parseJsonRecord(block.arguments) ?? parseJsonRecord(block.args) ?? parseJsonRecord(block.input) ?? parseJsonRecord(fn?.arguments) ?? {};
+}
+function toolCallIdFromBlock(block) {
+	return stringValue(block.id) ?? stringValue(block.toolCallId) ?? stringValue(block.tool_call_id) ?? stringValue(block.tool_call_id$);
+}
+function toolResultId(row) {
+	const rec = row;
+	return stringValue(rec.toolCallId) ?? stringValue(rec.tool_call_id) ?? stringValue(rec.tool_call_id$);
+}
+function extractResultDetails(row) {
+	if (!row) return null;
+	const topLevelDetails = asRecord(row.details);
+	if (topLevelDetails) return topLevelDetails;
+	const contentText = textFromContent(row.content);
+	if (!contentText.trim()) return null;
+	try {
+		const rec = asRecord(JSON.parse(contentText));
+		return asRecord(rec?.details) ?? rec;
+	} catch {
+		return null;
+	}
+}
+function collectToolResults(messages) {
+	const results = /* @__PURE__ */ new Map();
+	for (const message of messages) {
+		const role = message.role;
+		if (role !== "tool" && role !== "toolResult") continue;
+		const id = toolResultId(message);
+		if (id) results.set(id, message);
+	}
+	return results;
+}
+function extractToolCalls(message) {
+	const content = message.content;
+	const calls = [];
+	if (Array.isArray(content)) for (const block of content) {
+		const rec = asRecord(block);
+		const type = rec ? stringValue(rec.type) : void 0;
+		if (!rec || type !== "toolCall" && type !== "tool_use" && type !== "tool_call") continue;
+		calls.push({
+			id: toolCallIdFromBlock(rec),
+			name: toolNameFromBlock(rec),
+			args: toolArgsFromBlock(rec)
+		});
+	}
+	const toolCalls = message.tool_calls;
+	if (Array.isArray(toolCalls)) for (const call of toolCalls) {
+		const rec = asRecord(call);
+		const fn = asRecord(rec?.function);
+		const name = stringValue(fn?.name) ?? stringValue(rec?.name);
+		if (!rec || !name) continue;
+		calls.push({
+			id: stringValue(rec.id),
+			name,
+			args: parseJsonRecord(fn?.arguments) ?? asRecord(fn?.arguments) ?? {}
+		});
+	}
+	return calls;
+}
+function summarizePlan(details) {
+	const lines = (Array.isArray(details.plan) ? details.plan : []).map((item) => {
+		const rec = asRecord(item);
+		const step = stringValue(rec?.step)?.trim();
+		const status = stringValue(rec?.status)?.trim();
+		return step && status ? `${status}: ${step}` : "";
+	}).filter(Boolean).slice(0, 8);
+	if (lines.length === 0) return void 0;
+	const explanation = stringValue(details.explanation)?.trim();
+	return `Plan${explanation ? ` (${explanation})` : ""}: ${lines.join(" | ")}`;
+}
+function summarizeCommand(args, details) {
+	const command = stringValue(details?.command) ?? stringValue(args.cmd) ?? stringValue(args.command) ?? "";
+	const status = stringValue(details?.status) ?? (details?.exitCode === 0 ? "success" : "unknown");
+	const exitCode = typeof details?.exitCode === "number" ? details.exitCode : void 0;
+	const hint = stringValue(details?.failureHint);
+	return [
+		`Command ${status}: ${command || "(unknown command)"}`,
+		exitCode !== void 0 ? `exit=${exitCode}` : "",
+		hint ? `hint=${hint}` : ""
+	].filter(Boolean).join(" ");
+}
+function summarizePatch(details) {
+	if (!details) return void 0;
+	const files = Array.isArray(details.files) ? details.files.filter((file) => typeof file === "string" && file.trim().length > 0) : [];
+	const added = typeof details.added === "number" ? details.added : 0;
+	const removed = typeof details.removed === "number" ? details.removed : 0;
+	const summary = stringValue(details.summary)?.trim();
+	return `Patch applied: ${files.length ? files.join(", ") : summary || "(files unknown)"} (+${added}/-${removed})`;
+}
+function buildCodingContextMessage(messages) {
+	const recent = messages.slice(-CODING_CONTEXT_LOOKBACK);
+	const results = collectToolResults(recent);
+	const lines = [];
+	for (const message of recent) {
+		if (message.role !== "assistant") continue;
+		for (const call of extractToolCalls(message)) {
+			if (call.name !== "update_plan" && call.name !== "exec_command" && call.name !== "apply_patch") continue;
+			const details = extractResultDetails(call.id ? results.get(call.id) : void 0);
+			const line = call.name === "update_plan" ? summarizePlan(details ?? call.args) : call.name === "exec_command" ? summarizeCommand(call.args, details) : summarizePatch(details);
+			if (line) lines.push(line);
+		}
+	}
+	const uniqueLines = [...new Set(lines)].slice(-CODING_CONTEXT_MAX_LINES);
+	if (uniqueLines.length === 0) return null;
+	return {
+		role: "user",
+		content: [{
+			type: "text",
+			text: [
+				"<coding_context>",
+				...uniqueLines.map((line) => `- ${line}`),
+				"</coding_context>"
+			].join("\n")
+		}]
+	};
+}
 /**
 * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).
 */
@@ -140,6 +289,8 @@ function buildSessionContextForLlm(rows) {
 		}
 		if (isLikelyAgentMessage(r)) out.push(r);
 	}
+	const codingContext = buildCodingContextMessage(out);
+	if (codingContext) out.push(codingContext);
 	return out;
 }
 /**

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

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

package/dist/src/storage/sqlite/migrations/021_projects_fts.sql

@@ -0,0 +1,21 @@
+CREATE VIRTUAL TABLE IF NOT EXISTS projects_fts USING fts5(
+  content,
+  project_id UNINDEXED,
+  tokenize='unicode61'
+);
+
+DELETE FROM projects_fts;
+
+INSERT INTO projects_fts (content, project_id)
+SELECT
+  trim(
+    coalesce(name, '') || char(10) ||
+    coalesce(slug, '') || char(10) ||
+    coalesce(description, '') || char(10) ||
+    coalesce(workspace_root, '') || char(10) ||
+    coalesce(brief, '') || char(10) ||
+    coalesce(instructions, '') || char(10) ||
+    coalesce(default_agent_id, '')
+  ) AS content,
+  project_id
+FROM projects;

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

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

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

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

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

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

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

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

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

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

package/dist/src/tui/backends/embedded-backend.d.ts

@@ -1,7 +1,7 @@
 import type { ExtensionRegistryImpl } from '../../extensions/loader.js';
 import { type Config } from '../../config/schema.js';
 import type { ExportFormat } from '../../session/types.js';
-import type { ChatSendOptions, HistoryMessage, TuiBackend, TuiCompactionResult, TuiEvent, TuiModelChoice, TuiShareRequest, TuiShareResult, TuiSessionStats, TuiSessionItem, TuiTranscriptTreeEntry, TuiAgentInfo, TuiWorkspaceFileSearchEntry, TuiWorkflowRunStartRequest, TuiWorkflowRunStartResult } from '../tui-backend.js';
+import type { ChatSendOptions, HistoryMessage, TuiBackend, TuiCompactionResult, TuiEvent, TuiModelChoice, TuiShareRequest, TuiShareResult, TuiSessionStats, TuiSessionItem, TuiTranscriptTreeEntry, TuiAgentInfo, TuiWorkspaceFileSearchEntry, TuiWorkflowRunStartRequest, TuiWorkflowRunStartResult, TuiStartupProjectResult } from '../tui-backend.js';
 import type { SessionInfo } from '../tui-types.js';
 interface EmbeddedBackendOptions {
     config?: Config;
@@ -41,9 +41,16 @@ export declare class EmbeddedBackend implements TuiBackend {
     private activeConfig;
     getStartupResources(sessionKey: string): Promise<import("../tui-backend.js").TuiStartupResources>;
     startWorkflowRun(opts: TuiWorkflowRunStartRequest): Promise<TuiWorkflowRunStartResult>;
+    resolveStartupProject(opts: {
+        workspacePath: string;
+        sessionKey: string;
+        agentId: string;
+        autoCreate?: boolean;
+    }): Promise<TuiStartupProjectResult>;
     searchWorkspaceFiles(sessionKey: string, query: string, options?: {
         limit?: number;
     }): Promise<TuiWorkspaceFileSearchEntry[]>;
+    getReviewContext(sessionKey: string): Promise<import("../../review/review-git.js").ReviewContext>;
     sendChat(opts: ChatSendOptions): Promise<{
         runId: string;
     }>;

package/dist/src/tui/backends/embedded-backend.js

@@ -5,7 +5,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { openXopcDatabase } from "../../storage/sqlite/connection.js";
+import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
+import { effectiveWorkspacePathForSession } from "../../session/session-workspace.js";
 import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
 import { evictEmbeddedSessionRunner } from "../../agent/embedded/session-runner.js";
 import { prependEnvelopeTimestamp } from "../../channels/envelope-timestamp.js";
@@ -13,6 +15,7 @@ import { SessionIndex } from "../../session/manager.js";
 import { transcriptRowsToClientHistory } from "../../session/client-history.js";
 import "../../session/index.js";
 import { parseModelRef } from "../../agent/models/selection.js";
+import { buildReviewContext, resolveGitRoot } from "../../review/review-git.js";
 import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
 import { setTuiDefaultAgentConfig } from "../../commands/agents.config.js";
@@ -21,6 +24,9 @@ import "../../config/index.js";
 import { buildWorkflowChildTools } from "../../agent/workflow/workflow-child-tools.js";
 import { WorkflowRunService } from "../../workflows/service/workflow-run-service.js";
 import { WorkflowSessionBridge } from "../../workflows/service/workflow-session-bridge.js";
+import { ProjectService } from "../../projects/project-service.js";
+import { inferSuggestedProjectDefaultAgentId } from "../../projects/project-agent-suggestion.js";
+import "../../projects/index.js";
 import { ChatStreamMapper } from "../../gateway/chat-stream/mapper.js";
 import { fuzzySearchWorkspaceFiles } from "../../gateway/workspace-file-search.js";
 import { sessionMetadataToTuiItem } from "../tui-session-format.js";
@@ -191,6 +197,47 @@ var EmbeddedBackend = class {
 			definitionId: opts.definitionId
 		};
 	}
+	async resolveStartupProject(opts) {
+		await this.sessionIndexReady;
+		if (!this.sessionIndex) return { project: null };
+		const projects = new ProjectService();
+		const defaultAgentId = inferSuggestedProjectDefaultAgentId({
+			config: this.activeConfig(),
+			workspaceRoot: opts.workspacePath
+		});
+		const match = projects.resolveOrCreateForWorkspacePath({
+			workspacePath: opts.workspacePath,
+			agentId: opts.agentId,
+			defaultAgentId,
+			autoCreate: opts.autoCreate !== false
+		});
+		if (!match) return { project: null };
+		const projectAgentId = match.project.defaultAgentId?.trim() ? normalizeAgentId(match.project.defaultAgentId) : void 0;
+		if (projectAgentId && projectAgentId !== normalizeAgentId(opts.agentId)) return {
+			project: match.project,
+			created: match.created,
+			reason: match.reason
+		};
+		if (!getSessionMetadata(opts.sessionKey)) await this.sessionIndex.getStore().resolveTranscriptPath(opts.sessionKey, { metadata: {
+			sourceChannel: "tui",
+			sourceChatId: `default:direct:${opts.sessionKey}`,
+			sessionType: "chat",
+			projectId: match.project.id,
+			routing: {
+				agentId: opts.agentId,
+				source: "tui",
+				accountId: "default",
+				peerKind: "direct",
+				peerId: opts.sessionKey
+			}
+		} });
+		projects.attachSession(opts.sessionKey, match.project.id);
+		return {
+			project: match.project,
+			created: match.created,
+			reason: match.reason
+		};
+	}
 	async searchWorkspaceFiles(sessionKey, query, options) {
 		if (!this.agent) return [];
 		try {
@@ -205,6 +252,11 @@ var EmbeddedBackend = class {
 			return [];
 		}
 	}
+	async getReviewContext(sessionKey) {
+		const config = this.activeConfig();
+		const metadata = getSessionMetadata(sessionKey);
+		return buildReviewContext(await resolveGitRoot(effectiveWorkspacePathForSession(config, sessionKey, null, metadata?.projectId ? new ProjectService().get(metadata.projectId) : null)));
+	}
 	async sendChat(opts) {
 		const agent = await this.ensureAgent();
 		const runId = crypto.randomUUID();
@@ -419,7 +471,14 @@ var EmbeddedBackend = class {
 		await this.agent.resetSession(sessionKey);
 	}
 	async patchSession(sessionKey, patch) {
-		const result = await (await this.ensureAgent()).sessionConfig.patch(sessionKey, {
+		const agent = await this.ensureAgent();
+		const projectId = typeof patch.projectId === "string" ? patch.projectId.trim() : "";
+		if (projectId) {
+			await this.sessionIndexReady;
+			await this.sessionIndex?.getStore().resolveTranscriptPath(sessionKey);
+			new ProjectService().attachSession(sessionKey, projectId);
+		}
+		const result = await agent.sessionConfig.patch(sessionKey, {
 			model: typeof patch.model === "string" ? patch.model : void 0,
 			thinkingLevel: typeof patch.thinkingLevel === "string" ? patch.thinkingLevel : void 0,
 			reasoningLevel: typeof patch.reasoningLevel === "string" ? patch.reasoningLevel : void 0,