spiracha 2.0.0 → 2.2.0

package/src/lib/antigravity-db.ts

@@ -1,4 +1,5 @@
-import { readdir, stat } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { chmod, readdir, rename, rm, stat } from 'node:fs/promises';
 import path from 'node:path';
 import {
     type AntigravityArtifact,
@@ -11,7 +12,18 @@ import {
     resolveAntigravityRoots,
 } from './antigravity-exporter-types';
 import { decryptAntigravitySafeStoragePayload } from './antigravity-keychain';
+import { resolveAntigravityProjectNames } from './antigravity-projects';
+import { getAntigravityAssistantPhase, getFinalAntigravityAssistantSequences } from './antigravity-transcript-phase';
 import { mapWithConcurrency } from './concurrency';
+import {
+    type ExportFormat,
+    formatInlineLiteral,
+    type MetadataEntry,
+    renderCodeBlock,
+    renderDocumentTitle,
+    renderMetadataBlock,
+    renderSection,
+} from './shared';
 
 type ProtoField = {
     bytes?: Uint8Array;
@@ -25,6 +37,7 @@ type SummaryEntry = {
     createdAtMs: number | null;
     indexedItemCount: number | null;
     lastUpdatedAtMs: number | null;
+    projectId: string | null;
     summaryPath: string;
     title: string;
     workspaceFolder: string | null;
@@ -33,6 +46,11 @@ type SummaryEntry = {
     workspaceUri: string | null;
 };
 
+export type DeleteAntigravityConversationResult = {
+    deletedConversationIds: string[];
+    deletedPaths: string[];
+};
+
 type ConversationFile = {
     bytes: number;
     mtimeMs: number;
@@ -48,7 +66,6 @@ const isSafeConversationId = (value: string) => SAFE_CONVERSATION_ID_PATTERN.tes
 type TranscriptFile = {
     bytes: number;
     entryCount: number;
-    fullPath: string | null;
     mtimeMs: number;
     model: string | null;
     path: string;
@@ -60,11 +77,19 @@ export type AntigravityConversationMessage = {
     createdAtMs: number | null;
     metadata: Record<string, unknown>;
     order: number;
-    phase: 'final_answer' | 'reasoning' | 'tool_call' | 'tool_output' | 'unknown';
+    phase: 'commentary' | 'final_answer' | 'reasoning' | 'tool_call' | 'tool_output' | 'unknown';
     role: 'assistant' | 'system' | 'tool' | 'unknown' | 'user';
     text: string;
 };
 
+export type AntigravityConversationRenderOptions = {
+    includeCommentary?: boolean;
+    includeMetadata?: boolean;
+    includeTools?: boolean;
+    keychainSecret?: string | null;
+    outputFormat?: ExportFormat;
+};
+
 type WorkspaceInfo = Pick<SummaryEntry, 'workspaceFolder' | 'workspaceKey' | 'workspaceLabel' | 'workspaceUri'>;
 
 const UNKNOWN_WORKSPACE: WorkspaceInfo = {
@@ -271,8 +296,8 @@ const parseContextWorkspaceInfo = (field: ProtoField | null): WorkspaceInfo | nu
 // Antigravity summary parsing is reverse-engineered from agyhub_summaries_proto.pb:
 // entry field 1 = conversation id, entry field 2 = summary message. Inside that summary,
 // field 1 = title, 2 = indexed item count, 3 = last-updated timestamp, 7 = created timestamp,
-// 9 = workspace info, and 17 = context workspace info. parseWorkspaceInfo uses nested fields
-// 1/2 for URI variants; parseContextWorkspaceInfo uses field 7 or nested workspace field 1.
+// 9 = workspace info, and 17 = context metadata. Context field 18 is the Antigravity
+// project id; workspace parsing uses context field 7 or nested workspace field 1.
 const parseSummaryEntry = (entryField: ProtoField, summaryPath: string): SummaryEntry | null => {
     try {
         const entryFields = nestedFields(entryField);
@@ -283,6 +308,7 @@ const parseSummaryEntry = (entryField: ProtoField, summaryPath: string): Summary
         }
 
         const summaryFields = nestedFields(summaryBytes);
+        const contextFields = nestedFields(firstField(summaryFields, 17));
         const workspace =
             parseWorkspaceInfo(firstField(summaryFields, 9)) ??
             parseContextWorkspaceInfo(firstField(summaryFields, 17)) ??
@@ -294,6 +320,7 @@ const parseSummaryEntry = (entryField: ProtoField, summaryPath: string): Summary
             createdAtMs: parseTimestampMs(firstField(summaryFields, 7)),
             indexedItemCount: fieldNumberValue(summaryFields, 2),
             lastUpdatedAtMs: parseTimestampMs(firstField(summaryFields, 3)),
+            projectId: fieldString(contextFields, 18),
             summaryPath,
             title: cleanTitle(fieldString(summaryFields, 1), conversationId),
         };
@@ -318,6 +345,92 @@ export const readAntigravitySummaryIndex = async (summaryPath: string): Promise<
     }
 };
 
+const getFieldBounds = (
+    buffer: Uint8Array,
+    start: number,
+): {
+    end: number;
+    fieldNumber: number;
+    payloadEnd: number;
+    payloadStart: number;
+    wireType: number;
+} => {
+    const key = readVarint(buffer, start, buffer.length);
+    const fieldNumber = key.value >> 3;
+    const wireType = key.value & 7;
+    let index = key.next;
+
+    if (wireType === 0) {
+        const value = readVarint(buffer, index, buffer.length);
+        return { end: value.next, fieldNumber, payloadEnd: value.next, payloadStart: index, wireType };
+    }
+
+    if (wireType === 1) {
+        return { end: index + 8, fieldNumber, payloadEnd: index + 8, payloadStart: index, wireType };
+    }
+
+    if (wireType === 2) {
+        const length = readVarint(buffer, index, buffer.length);
+        index = length.next;
+        return {
+            end: index + length.value,
+            fieldNumber,
+            payloadEnd: index + length.value,
+            payloadStart: index,
+            wireType,
+        };
+    }
+
+    if (wireType === 5) {
+        return { end: index + 4, fieldNumber, payloadEnd: index + 4, payloadStart: index, wireType };
+    }
+
+    throw new Error(`Unsupported protobuf wire type: ${wireType}`);
+};
+
+const removeConversationFromSummaryIndex = async (summaryPath: string, conversationId: string): Promise<boolean> => {
+    if (!(await pathExists(summaryPath))) {
+        return false;
+    }
+
+    const buffer = new Uint8Array(await Bun.file(summaryPath).arrayBuffer());
+    const retained: Uint8Array[] = [];
+    let removed = false;
+    let index = 0;
+
+    while (index < buffer.length) {
+        const bounds = getFieldBounds(buffer, index);
+        const fieldBytes = buffer.slice(index, bounds.end);
+        const shouldRemove =
+            bounds.fieldNumber === 1 &&
+            bounds.wireType === 2 &&
+            fieldString(parseProtoFields(buffer, bounds.payloadStart, bounds.payloadEnd), 1) === conversationId;
+
+        if (shouldRemove) {
+            removed = true;
+        } else {
+            retained.push(fieldBytes);
+        }
+
+        index = bounds.end;
+    }
+
+    if (!removed) {
+        return false;
+    }
+
+    const tempPath = `${summaryPath}.${randomUUID()}.tmp`;
+    const mode = (await stat(summaryPath)).mode & 0o777;
+    try {
+        await Bun.write(tempPath, Buffer.concat(retained));
+        await chmod(tempPath, mode);
+        await rename(tempPath, summaryPath);
+    } finally {
+        await rm(tempPath, { force: true });
+    }
+    return true;
+};
+
 const preferConversationFile = (
     current: ConversationFile | undefined,
     candidate: ConversationFile,
@@ -491,15 +604,6 @@ const mergeArtifactMaps = async (roots: string[]): Promise<Map<string, Antigravi
     return merged;
 };
 
-const countJsonlEntries = async (filePath: string): Promise<number> => {
-    try {
-        const text = await Bun.file(filePath).text();
-        return text.split(/\r?\n/u).filter((line) => line.trim().length > 0).length;
-    } catch {
-        return 0;
-    }
-};
-
 const stripModelQualifier = (value: string): string => value.replace(/\s*\([^)]*\)\s*$/u, '').trim();
 
 const extractModelSelection = (content: string): string | null => {
@@ -524,18 +628,31 @@ const extractModelSelection = (content: string): string | null => {
     return rawModel ? stripModelQualifier(rawModel) : null;
 };
 
-const extractTranscriptModel = async (filePath: string): Promise<string | null> => {
-    const text = await Bun.file(filePath)
-        .text()
-        .catch(() => '');
+const transcriptAnalysisCache = new Map<string, { entryCount: number; model: string | null }>();
+
+const analyzeTranscriptFile = async (filePath: string, size: number, mtimeMs: number) => {
+    const cacheKey = `${filePath}:${size}:${mtimeMs}`;
+    const cached = transcriptAnalysisCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const text = await Bun.file(filePath).text();
+    let model: string | null = null;
     for (const entry of parseLogEntries(text)) {
-        const model = extractModelSelection(getString(entry.content) ?? '');
-        if (model) {
-            return model;
+        model = extractModelSelection(getString(entry.content) ?? '') ?? model;
+        if (model !== null) {
+            break;
         }
     }
-
-    return null;
+    const analysis = {
+        entryCount: text.split(/\r?\n/u).filter((line) => line.trim().length > 0).length,
+        model,
+    };
+    if (transcriptAnalysisCache.size >= 256) {
+        transcriptAnalysisCache.delete(transcriptAnalysisCache.keys().next().value ?? '');
+    }
+    transcriptAnalysisCache.set(cacheKey, analysis);
+    return analysis;
 };
 
 const preferTranscriptFile = (current: TranscriptFile | undefined, candidate: TranscriptFile): TranscriptFile => {
@@ -543,15 +660,22 @@ const preferTranscriptFile = (current: TranscriptFile | undefined, candidate: Tr
         return candidate;
     }
 
+    const sourceRank = (source: TranscriptFile['source']) => (source === 'transcript' ? 2 : 1);
+    const candidateRank = sourceRank(candidate.source);
+    const currentRank = sourceRank(current.source);
+    if (candidateRank !== currentRank) {
+        return candidateRank > currentRank ? candidate : current;
+    }
+
     if (candidate.mtimeMs !== current.mtimeMs) {
         return candidate.mtimeMs > current.mtimeMs ? candidate : current;
     }
 
-    if (candidate.source !== current.source) {
-        return candidate.source === 'overview' ? candidate : current;
+    if (candidate.entryCount !== current.entryCount) {
+        return candidate.entryCount > current.entryCount ? candidate : current;
     }
 
-    return candidate.entryCount > current.entryCount ? candidate : current;
+    return candidate.bytes > current.bytes ? candidate : current;
 };
 
 const readTranscriptFileCandidate = async (
@@ -565,15 +689,12 @@ const readTranscriptFileCandidate = async (
         if (!info.isFile()) {
             return null;
         }
+        const analysis = await analyzeTranscriptFile(transcriptPath, info.size, info.mtimeMs);
 
-        const fullPath = path.join(logsDir, 'transcript_full.jsonl');
-        const hasFullTranscript = await pathExists(fullPath);
-        const modelSourcePath = hasFullTranscript ? fullPath : transcriptPath;
         return {
             bytes: info.size,
-            entryCount: await countJsonlEntries(modelSourcePath),
-            fullPath: hasFullTranscript ? fullPath : null,
-            model: await extractTranscriptModel(modelSourcePath),
+            entryCount: analysis.entryCount,
+            model: analysis.model,
             mtimeMs: info.mtimeMs,
             path: transcriptPath,
             root,
@@ -601,8 +722,9 @@ const readTranscriptFilesForRoot = async (root: string): Promise<Map<string, Tra
 
         const logsDir = path.join(brainDir, entry.name, '.system_generated', 'logs');
         for (const candidate of [
-            { name: 'overview.txt', source: 'overview' as const },
+            { name: 'transcript_full.jsonl', source: 'transcript' as const },
             { name: 'transcript.jsonl', source: 'transcript' as const },
+            { name: 'overview.txt', source: 'overview' as const },
         ]) {
             const transcript = await readTranscriptFileCandidate(root, logsDir, candidate);
             if (transcript) {
@@ -689,6 +811,8 @@ const toConversation = (
 ): AntigravityConversation => {
     const fallbackTitle = artifacts[0]?.summary ?? conversationId;
     const artifactBytes = artifacts.reduce((total, artifact) => total + artifact.bytes, 0);
+    const conversationBytes = file?.bytes ?? 0;
+    const transcriptBytes = transcript?.bytes ?? 0;
     const workspace = resolveConversationWorkspace(summary, file, transcript, artifacts);
     const lastUpdatedAtMs = resolveConversationLastUpdatedAt(artifacts, file, summary, transcript);
     const sourceRoot = resolveConversationSourceRoot(file, transcript, artifacts);
@@ -697,7 +821,7 @@ const toConversation = (
         artifactBytes,
         artifactCount: artifacts.length,
         artifacts,
-        conversationBytes: file?.bytes ?? 0,
+        conversationBytes,
         conversationId,
         conversationMtimeMs: file?.mtimeMs ?? null,
         conversationPath: file?.path ?? null,
@@ -705,10 +829,12 @@ const toConversation = (
         indexedItemCount: summary?.indexedItemCount ?? null,
         lastUpdatedAtMs,
         model: transcript?.model ?? null,
+        projectId: summary?.projectId ?? null,
         sourceRoot,
         summaryPath: summary?.summaryPath ?? null,
         title: summary?.title ?? cleanTitle(fallbackTitle, conversationId),
-        transcriptBytes: transcript?.bytes ?? 0,
+        totalBytes: conversationBytes + transcriptBytes + artifactBytes,
+        transcriptBytes,
         transcriptEntryCount: transcript?.entryCount ?? 0,
         transcriptPath: transcript?.path ?? null,
         transcriptSource: resolveConversationTranscriptSource(file, transcript),
@@ -750,25 +876,30 @@ export const listAntigravityConversations = async (
 
 export const groupAntigravityConversations = (
     conversations: AntigravityConversation[],
+    projectNames: ReadonlyMap<string, string> = new Map(),
 ): AntigravityWorkspaceGroup[] => {
     const groups = new Map<string, AntigravityWorkspaceGroup>();
     for (const conversation of conversations) {
-        const current = groups.get(conversation.workspaceKey) ?? {
+        const projectName = conversation.projectId ? projectNames.get(conversation.projectId) : null;
+        const groupKey = conversation.projectId ? `project:${conversation.projectId}` : conversation.workspaceKey;
+        const current = groups.get(groupKey) ?? {
             artifactCount: 0,
             conversationBytes: 0,
             conversationCount: 0,
-            key: conversation.workspaceKey,
-            label: conversation.workspaceLabel,
+            key: groupKey,
+            label: projectName ?? conversation.workspaceLabel,
             lastActiveMs: 0,
+            totalBytes: 0,
             transcriptCount: 0,
-            uri: conversation.workspaceUri,
+            uri: conversation.projectId ? null : conversation.workspaceUri,
         };
         current.artifactCount += conversation.artifactCount;
         current.conversationBytes += conversation.conversationBytes;
         current.conversationCount += 1;
         current.lastActiveMs = Math.max(current.lastActiveMs, conversation.lastUpdatedAtMs ?? 0);
         current.transcriptCount += conversation.transcriptEntryCount > 0 ? 1 : 0;
-        groups.set(conversation.workspaceKey, current);
+        current.totalBytes += conversation.totalBytes;
+        groups.set(groupKey, current);
     }
 
     return [...groups.values()].sort((a, b) => b.lastActiveMs - a.lastActiveMs || a.label.localeCompare(b.label));
@@ -777,16 +908,67 @@ export const groupAntigravityConversations = (
 export const listAntigravityWorkspaceGroups = async (
     roots = resolveAntigravityRoots(),
 ): Promise<AntigravityWorkspaceGroup[]> => {
-    return groupAntigravityConversations(await listAntigravityConversations(roots));
+    const conversations = await listAntigravityConversations(roots);
+    const projectNames = await resolveAntigravityProjectNames(
+        conversations.flatMap((conversation) => (conversation.projectId ? [conversation.projectId] : [])),
+    );
+    return groupAntigravityConversations(conversations, projectNames);
 };
 
 export const listAntigravityConversationsForGroup = async (
     workspaceKey: string,
     roots = resolveAntigravityRoots(),
 ): Promise<AntigravityConversation[]> => {
-    return (await listAntigravityConversations(roots)).filter(
-        (conversation) => conversation.workspaceKey === workspaceKey,
-    );
+    return (await listAntigravityConversations(roots)).filter((conversation) => {
+        const conversationGroupKey = conversation.projectId
+            ? `project:${conversation.projectId}`
+            : conversation.workspaceKey;
+        return conversationGroupKey === workspaceKey;
+    });
+};
+
+const existingAntigravityDeletePaths = async (root: string, conversationId: string): Promise<string[]> => {
+    const conversationPath = path.join(getAntigravityConversationDir(root), `${conversationId}.pb`);
+    const artifactDir = path.join(getAntigravityBrainDir(root), conversationId);
+    const logsDir = path.join(artifactDir, '.system_generated', 'logs');
+    const candidates = [
+        conversationPath,
+        path.join(logsDir, 'overview.txt'),
+        path.join(logsDir, 'transcript.jsonl'),
+        path.join(logsDir, 'transcript_full.jsonl'),
+        artifactDir,
+    ];
+    const exists = await Promise.all(candidates.map(pathExists));
+    return candidates.filter((_, index) => exists[index]);
+};
+
+export const deleteAntigravityConversation = async (
+    roots: string[],
+    conversationId: string,
+): Promise<DeleteAntigravityConversationResult> => {
+    if (!isSafeConversationId(conversationId)) {
+        return { deletedConversationIds: [], deletedPaths: [] };
+    }
+
+    const deletedPaths: string[] = [];
+    let deletedSummary = false;
+
+    for (const root of roots) {
+        deletedSummary =
+            (await removeConversationFromSummaryIndex(getAntigravitySummaryIndexPath(root), conversationId)) ||
+            deletedSummary;
+
+        const rootPaths = await existingAntigravityDeletePaths(root, conversationId);
+        deletedPaths.push(...rootPaths);
+
+        await rm(path.join(getAntigravityConversationDir(root), `${conversationId}.pb`), { force: true });
+        await rm(path.join(getAntigravityBrainDir(root), conversationId), { force: true, recursive: true });
+    }
+
+    return {
+        deletedConversationIds: deletedSummary || deletedPaths.length > 0 ? [conversationId] : [],
+        deletedPaths: [...new Set(deletedPaths)],
+    };
 };
 
 export const renderAntigravityArtifactsMarkdown = async (
@@ -893,48 +1075,99 @@ const logEntryHeading = (entry: AntigravityLogEntry): string => {
     return type ? `Tool: ${type}` : 'Event';
 };
 
-const renderToolCalls = (toolCalls: unknown): string[] => {
+type ResolvedAntigravityConversationRenderOptions = {
+    includeCommentary: boolean;
+    includeMetadata: boolean;
+    includeTools: boolean;
+    keychainSecret: string | null;
+    outputFormat: ExportFormat;
+};
+
+const resolveAntigravityRenderOptions = (
+    options: AntigravityConversationRenderOptions,
+): ResolvedAntigravityConversationRenderOptions => ({
+    includeCommentary: options.includeCommentary ?? true,
+    includeMetadata: options.includeMetadata ?? true,
+    includeTools: options.includeTools ?? true,
+    keychainSecret: options.keychainSecret ?? null,
+    outputFormat: options.outputFormat ?? 'md',
+});
+
+const renderNestedHeading = (title: string, outputFormat: ExportFormat) => {
+    return outputFormat === 'md' ? `### ${title}` : `${title}\n${'~'.repeat(Math.max(title.length, 3))}`;
+};
+
+const renderToolCalls = (toolCalls: unknown, outputFormat: ExportFormat): string => {
     if (!Array.isArray(toolCalls) || toolCalls.length === 0) {
-        return [];
+        return '';
     }
 
-    const parts = ['### Tool Calls', ''];
+    const parts: string[] = [];
     for (const call of toolCalls) {
         if (!call || typeof call !== 'object') {
             continue;
         }
 
         const { args, name } = call as { args?: unknown; name?: unknown };
-        parts.push(`- \`${typeof name === 'string' ? name : 'unknown'}\``);
+        parts.push(`- ${formatInlineLiteral(typeof name === 'string' ? name : 'unknown', outputFormat)}`);
         if (args !== undefined) {
-            parts.push('', '```json', JSON.stringify(args, null, 2), '```', '');
+            parts.push('', 'Input:', '', renderCodeBlock(JSON.stringify(args, null, 2), outputFormat), '');
         }
     }
 
-    return parts;
+    return parts.length > 0 ? [renderNestedHeading('Tool Calls', outputFormat), '', ...parts].join('\n').trimEnd() : '';
 };
 
-const renderLogEntry = (entry: AntigravityLogEntry): string[] => {
-    const heading = logEntryHeading(entry);
-    const timestamp = getString(entry.created_at);
+const renderLogEntryBodyParts = (
+    entry: AntigravityLogEntry,
+    role: AntigravityConversationMessage['role'],
+    sequence: number,
+    finalAssistantSequences: Set<number>,
+    options: ResolvedAntigravityConversationRenderOptions,
+): string[] => {
+    const bodyParts: string[] = [];
+    const thinking = getString(entry.thinking) ?? '';
+    if (options.includeCommentary && thinking) {
+        bodyParts.push(renderNestedHeading('Thinking', options.outputFormat), '', thinking.trim(), '');
+    }
+
     const content = cleanLogContent(entry);
-    const thinking = getString(entry.thinking);
-    const parts = [`## ${heading}`, ''];
+    const phase = role === 'assistant' ? getAntigravityAssistantPhase(sequence, finalAssistantSequences) : 'unknown';
+    if (content && (role !== 'assistant' || phase !== 'commentary' || options.includeCommentary)) {
+        bodyParts.push(content, '');
+    }
 
-    if (timestamp) {
-        parts.push(`_Timestamp: ${timestamp}_`, '');
+    const toolCalls = options.includeTools ? renderToolCalls(entry.tool_calls, options.outputFormat) : '';
+    if (toolCalls) {
+        bodyParts.push(toolCalls);
     }
 
-    if (thinking) {
-        parts.push('### Thinking', '', thinking.trim(), '');
+    return bodyParts;
+};
+
+const renderLogEntry = (
+    entry: AntigravityLogEntry,
+    sequence: number,
+    finalAssistantSequences: Set<number>,
+    options: ResolvedAntigravityConversationRenderOptions,
+): string => {
+    const heading = logEntryHeading(entry);
+    const role = logEntryRole(entry);
+    if (!options.includeTools && (role === 'tool' || heading.startsWith('Tool: '))) {
+        return '';
     }
 
-    if (content) {
-        parts.push(content, '');
+    const timestamp = getString(entry.created_at);
+    const bodyParts = renderLogEntryBodyParts(entry, role, sequence, finalAssistantSequences, options);
+
+    if (bodyParts.length === 0) {
+        return '';
     }
 
-    parts.push(...renderToolCalls(entry.tool_calls));
-    return parts;
+    const parts = timestamp
+        ? [options.outputFormat === 'md' ? `_Timestamp: ${timestamp}_` : `Timestamp: ${timestamp}`, '', ...bodyParts]
+        : bodyParts;
+    return renderSection(heading, parts.join('\n').trimEnd(), options.outputFormat);
 };
 
 const logEntryCreatedAtMs = (entry: AntigravityLogEntry): number | null => {
@@ -972,10 +1205,14 @@ const logEntryRole = (entry: AntigravityLogEntry): AntigravityConversationMessag
     return 'unknown';
 };
 
-const logEntryPhase = (entry: AntigravityLogEntry): AntigravityConversationMessage['phase'] => {
+const logEntryPhase = (
+    entry: AntigravityLogEntry,
+    sequence: number,
+    finalAssistantSequences: Set<number>,
+): AntigravityConversationMessage['phase'] => {
     const role = logEntryRole(entry);
     if (role === 'assistant') {
-        return 'final_answer';
+        return getAntigravityAssistantPhase(sequence, finalAssistantSequences);
     }
     if (role === 'tool') {
         return 'tool_output';
@@ -1005,11 +1242,27 @@ const toolCallsText = (toolCalls: unknown): string => {
         .join('\n');
 };
 
-const logEntryToMessages = (entry: AntigravityLogEntry, index: number): AntigravityConversationMessage[] => {
+const getAntigravityPhaseItems = (entries: AntigravityLogEntry[]) => {
+    return entries.map((entry, sequence) => {
+        const role = logEntryRole(entry);
+        return {
+            hasContent: Boolean(cleanLogContent(entry)),
+            hasToolCalls: Array.isArray(entry.tool_calls) && entry.tool_calls.length > 0,
+            role: role === 'assistant' || role === 'user' ? role : ('other' as const),
+            sequence,
+        };
+    });
+};
+
+const logEntryToMessages = (
+    entry: AntigravityLogEntry,
+    index: number,
+    finalAssistantSequences: Set<number>,
+): AntigravityConversationMessage[] => {
     const order = logEntryOrder(entry, index);
     const createdAtMs = logEntryCreatedAtMs(entry);
     const role = logEntryRole(entry);
-    const phase = logEntryPhase(entry);
+    const phase = logEntryPhase(entry, index, finalAssistantSequences);
     const metadata = logEntryMetadata(entry);
     const messages: AntigravityConversationMessage[] = [];
     const thinking = getString(entry.thinking)?.trim();
@@ -1058,15 +1311,39 @@ export const readAntigravityConversationMessages = async (
         return [];
     }
 
-    try {
-        const entries = parseLogEntries(await Bun.file(conversation.transcriptPath).text());
-        return entries.flatMap(logEntryToMessages);
-    } catch {
-        return [];
+    const content = await Bun.file(conversation.transcriptPath).text();
+    const entries = parseLogEntries(content);
+    if (content.trim() && entries.length === 0) {
+        throw new Error(`Antigravity transcript is corrupt: ${conversation.transcriptPath}`);
+    }
+    const finalAssistantSequences = getFinalAntigravityAssistantSequences(getAntigravityPhaseItems(entries));
+    return entries.flatMap((entry, index) => logEntryToMessages(entry, index, finalAssistantSequences));
+};
+
+const renderAntigravityMetadata = (entries: MetadataEntry[], outputFormat: ExportFormat): string => {
+    if (outputFormat === 'txt') {
+        return renderMetadataBlock(entries, outputFormat);
     }
+
+    return entries
+        .filter((entry) => entry.value !== null && entry.value !== undefined && entry.value !== '')
+        .map((entry) => `- ${entry.key}: ${formatInlineLiteral(String(entry.value), outputFormat)}`)
+        .join('\n');
 };
 
-const renderAntigravityTranscriptMarkdown = async (conversation: AntigravityConversation): Promise<string | null> => {
+const buildAntigravityIdentityMetadata = (
+    conversation: AntigravityConversation,
+    exportedFrom: string,
+): MetadataEntry[] => [
+    { key: 'exported_from', value: exportedFrom },
+    { key: 'conversation_id', value: conversation.conversationId },
+    { key: 'workspace', value: conversation.workspaceUri },
+];
+
+const renderAntigravityTranscript = async (
+    conversation: AntigravityConversation,
+    options: ResolvedAntigravityConversationRenderOptions,
+): Promise<string | null> => {
     if (!conversation.transcriptPath || !conversation.transcriptSource) {
         return null;
     }
@@ -1080,35 +1357,44 @@ const renderAntigravityTranscriptMarkdown = async (conversation: AntigravityConv
         conversation.transcriptSource === 'overview'
             ? 'antigravity_overview_transcript'
             : 'antigravity_jsonl_transcript';
+    const finalAssistantSequences = getFinalAntigravityAssistantSequences(getAntigravityPhaseItems(entries));
+    const sections = entries
+        .map((entry, sequence) => renderLogEntry(entry, sequence, finalAssistantSequences, options))
+        .filter(Boolean);
     const parts = [
-        `# ${conversation.title}`,
-        '',
-        `- exported_from: \`${exportedFrom}\``,
-        `- conversation_id: \`${conversation.conversationId}\``,
-        conversation.workspaceUri ? `- workspace: \`${conversation.workspaceUri}\`` : '',
+        renderDocumentTitle(conversation.title, options.outputFormat),
         '',
+        options.includeMetadata
+            ? renderAntigravityMetadata(
+                  buildAntigravityIdentityMetadata(conversation, exportedFrom),
+                  options.outputFormat,
+              )
+            : '',
+        ...sections,
     ].filter(Boolean);
 
-    for (const entry of entries) {
-        parts.push(...renderLogEntry(entry));
-    }
-
     return `${parts.join('\n').trimEnd()}\n`;
 };
 
-const renderDecryptedSafeStorageMarkdown = (conversation: AntigravityConversation, content: string): string | null => {
+const renderDecryptedSafeStorage = (
+    conversation: AntigravityConversation,
+    content: string,
+    options: ResolvedAntigravityConversationRenderOptions,
+): string | null => {
     const trimmed = content.trim();
     if (!trimmed) {
         return null;
     }
 
     return [
-        `# ${conversation.title}`,
-        '',
-        '- exported_from: `antigravity_safe_storage_payload`',
-        `- conversation_id: \`${conversation.conversationId}\``,
-        conversation.workspaceUri ? `- workspace: \`${conversation.workspaceUri}\`` : '',
+        renderDocumentTitle(conversation.title, options.outputFormat),
         '',
+        options.includeMetadata
+            ? renderAntigravityMetadata(
+                  buildAntigravityIdentityMetadata(conversation, 'antigravity_safe_storage_payload'),
+                  options.outputFormat,
+              )
+            : '',
         trimmed,
         '',
     ]
@@ -1116,22 +1402,66 @@ const renderDecryptedSafeStorageMarkdown = (conversation: AntigravityConversatio
         .join('\n');
 };
 
+const renderAntigravitySummary = (
+    conversation: AntigravityConversation,
+    options: ResolvedAntigravityConversationRenderOptions,
+): string | null => {
+    if (conversation.artifactCount > 0) {
+        return null;
+    }
+
+    if (!conversation.summaryPath && conversation.indexedItemCount === null) {
+        return null;
+    }
+
+    return [
+        renderDocumentTitle(conversation.title, options.outputFormat),
+        '',
+        options.includeMetadata
+            ? renderAntigravityMetadata(
+                  [
+                      ...buildAntigravityIdentityMetadata(conversation, 'antigravity_summary_index'),
+                      { key: 'indexed_items', value: conversation.indexedItemCount },
+                      {
+                          key: 'created_at',
+                          value: conversation.createdAtMs ? new Date(conversation.createdAtMs).toISOString() : null,
+                      },
+                      {
+                          key: 'updated_at',
+                          value: conversation.lastUpdatedAtMs
+                              ? new Date(conversation.lastUpdatedAtMs).toISOString()
+                              : null,
+                      },
+                  ],
+                  options.outputFormat,
+              )
+            : '',
+        options.includeMetadata
+            ? 'No local transcript log was found for this Antigravity conversation. The export contains the summary index metadata that Antigravity retained.'
+            : 'No local transcript log was found for this Antigravity conversation.',
+        '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+};
+
 export const renderAntigravityConversationMarkdown = async (
     conversation: AntigravityConversation,
-    options: { keychainSecret?: string | null } = {},
+    options: AntigravityConversationRenderOptions = {},
 ): Promise<string | null> => {
-    const transcript = await renderAntigravityTranscriptMarkdown(conversation);
+    const resolvedOptions = resolveAntigravityRenderOptions(options);
+    const transcript = await renderAntigravityTranscript(conversation, resolvedOptions);
     if (transcript) {
         return transcript;
     }
 
-    if (options.keychainSecret && conversation.conversationPath) {
+    if (resolvedOptions.keychainSecret && conversation.conversationPath) {
         const encrypted = Buffer.from(await Bun.file(conversation.conversationPath).arrayBuffer());
-        const decrypted = decryptAntigravitySafeStoragePayload(encrypted, options.keychainSecret);
+        const decrypted = decryptAntigravitySafeStoragePayload(encrypted, resolvedOptions.keychainSecret);
         if (decrypted) {
-            return renderDecryptedSafeStorageMarkdown(conversation, decrypted);
+            return renderDecryptedSafeStorage(conversation, decrypted, resolvedOptions);
         }
     }
 
-    return null;
+    return renderAntigravitySummary(conversation, resolvedOptions);
 };