spiracha 2.0.0 → 2.2.0

package/src/lib/conversation-data/kiro-adapter.ts

@@ -1,4 +1,10 @@
-import { listKiroSessionsForGroup, listKiroWorkspaceGroups, readKiroSessionTranscript } from '../kiro-db';
+import { mapWithConcurrency } from '../concurrency';
+import {
+    deleteKiroSession,
+    listKiroSessionsForGroup,
+    listKiroWorkspaceGroups,
+    readKiroSessionTranscript,
+} from '../kiro-db';
 import type {
     KiroSessionSummary,
     KiroSessionTranscript,
@@ -8,10 +14,13 @@ import type {
 import { resolveKiroWorkspaceSessionsDir } from '../kiro-exporter-types';
 import { getFinalKiroAssistantMessageEntryIds, getKiroMessagePhase } from '../kiro-transcript-phase';
 import { cleanInlineTitle } from '../shared';
+import { runWithTranscriptLoadLimit } from '../transcript-load-limiter';
 import {
+    createConversationUiPath,
     createDeepLinks,
     createTextMessage,
     finalizeMessages,
+    isWithinUpdatedWindow,
     normalizeAssistantPhase,
     normalizeRole,
     toDateMs,
@@ -23,10 +32,13 @@ import type {
     ConversationDetail,
     ConversationMessage,
     ConversationPathMatch,
+    DeleteConversationOptions,
     GetConversationOptions,
     ListConversationsForPathOptions,
 } from './types';
 
+const KIRO_CONVERSATION_HYDRATION_CONCURRENCY = 4;
+
 const getSessionsDir = (options: { locations?: { kiroWorkspaceSessionsDir?: string } }) =>
     options.locations?.kiroWorkspaceSessionsDir ?? resolveKiroWorkspaceSessionsDir();
 
@@ -74,8 +86,16 @@ const buildConversation = async (
     sessionsDir: string,
     matches: ConversationPathMatch[],
     options: Pick<ListConversationsForPathOptions, 'includeMessages' | 'messageSelector'>,
+    loadedTranscript: KiroSessionTranscript | null = null,
 ): Promise<ConversationDetail> => {
-    const transcript = options.includeMessages ? await readKiroSessionTranscript(sessionsDir, session.sessionId) : null;
+    const transcript = options.includeMessages
+        ? (loadedTranscript ??
+          (await runWithTranscriptLoadLimit(() => readKiroSessionTranscript(sessionsDir, session.sessionId), {
+              id: session.sessionId,
+              path: session.filePath,
+              source: 'kiro-api',
+          })))
+        : null;
     const allMessages = transcript ? transcriptToMessages(transcript) : [];
     const messages = options.includeMessages
         ? selectConversationMessages(allMessages, options.messageSelector ?? 'last_final_answer')
@@ -83,7 +103,11 @@ const buildConversation = async (
 
     return {
         createdAtMs: session.createdAtMs,
-        deepLinks: createDeepLinks('kiro', session.sessionId, `/kiro-sessions/${session.sessionId}`),
+        deepLinks: createDeepLinks(
+            'kiro',
+            session.sessionId,
+            createConversationUiPath('kiro-sessions', session.sessionId),
+        ),
         id: session.sessionId,
         matches,
         messageCount: options.includeMessages ? allMessages.length : session.messageCount,
@@ -113,10 +137,14 @@ const listKiroConversationsForPath = async (options: ListConversationsForPathOpt
         if (!match) {
             continue;
         }
-        const sessions = await listKiroSessionsForGroup(group.key, sessionsDir);
-        for (const session of sessions) {
-            conversations.push(await buildConversation(session, sessionsDir, [match], options));
-        }
+        const sessions = (await listKiroSessionsForGroup(group.key, sessionsDir)).filter((session) =>
+            isWithinUpdatedWindow(session.lastActiveAtMs, options),
+        );
+        conversations.push(
+            ...(await mapWithConcurrency(sessions, KIRO_CONVERSATION_HYDRATION_CONCURRENCY, (session) =>
+                buildConversation(session, sessionsDir, [match], options),
+            )),
+        );
     }
 
     return conversations;
@@ -124,16 +152,35 @@ const listKiroConversationsForPath = async (options: ListConversationsForPathOpt
 
 const getKiroConversation = async (options: GetConversationOptions): Promise<ConversationDetail | null> => {
     const sessionsDir = getSessionsDir(options);
-    const transcript = await readKiroSessionTranscript(sessionsDir, options.id);
+    const transcript = await runWithTranscriptLoadLimit(() => readKiroSessionTranscript(sessionsDir, options.id), {
+        id: options.id,
+        path: sessionsDir,
+        source: 'kiro-api',
+    });
     return transcript
-        ? buildConversation(transcript.session, sessionsDir, [], {
-              includeMessages: true,
-              messageSelector: options.messageSelector ?? 'all',
-          })
+        ? buildConversation(
+              transcript.session,
+              sessionsDir,
+              [],
+              {
+                  includeMessages: true,
+                  messageSelector: options.messageSelector ?? 'all',
+              },
+              transcript,
+          )
         : null;
 };
 
+const deleteKiroConversation = async (options: DeleteConversationOptions) => {
+    const result = await deleteKiroSession(getSessionsDir(options), options.id);
+    return {
+        deletedFiles: result.deletedFiles,
+        deletedIds: result.deletedSessionIds,
+    };
+};
+
 export const kiroConversationAdapter: ConversationAdapter = {
+    deleteConversation: deleteKiroConversation,
     getConversation: getKiroConversation,
     listConversationsForPath: listKiroConversationsForPath,
     source: 'kiro',

package/src/lib/conversation-data/message-selector.ts

@@ -14,12 +14,9 @@ const selectLastAssistantMessage = (messages: ConversationMessage[]) => {
     return latestByOrder(messages.filter((message) => message.role === 'assistant'));
 };
 
-// Not every integration can identify final answers. In that case, API list/export defaults still
-// return the latest assistant message instead of silently omitting the conversation.
 const selectLastFinalAnswer = (messages: ConversationMessage[]) => {
-    return (
-        latestByOrder(messages.filter((message) => message.role === 'assistant' && message.phase === 'final_answer')) ??
-        selectLastAssistantMessage(messages)
+    return latestByOrder(
+        messages.filter((message) => message.role === 'assistant' && message.phase === 'final_answer'),
     );
 };
 

package/src/lib/conversation-data/opencode-adapter.ts

@@ -1,4 +1,6 @@
+import { mapWithConcurrency } from '../concurrency';
 import {
+    deleteOpenCodeSession,
     listOpenCodeSessionsForGroup,
     listOpenCodeWorkspaceGroups,
     readOpenCodeSessionTranscript,
@@ -12,10 +14,13 @@ import { resolveOpenCodeDbPath } from '../opencode-exporter-types';
 import { splitOpenCodeThinkTaggedText } from '../opencode-think-tags';
 import { getFinalOpenCodeAssistantTextPartIds, getOpenCodeTextPartPhase } from '../opencode-transcript-phase';
 import { cleanInlineTitle } from '../shared';
+import { runWithTranscriptLoadLimit } from '../transcript-load-limiter';
 import {
+    createConversationUiPath,
     createDeepLinks,
     createTextMessage,
     finalizeMessages,
+    isWithinUpdatedWindow,
     normalizeAssistantPhase,
     normalizeRole,
 } from './adapter-helpers';
@@ -26,10 +31,13 @@ import type {
     ConversationDetail,
     ConversationMessage,
     ConversationPathMatch,
+    DeleteConversationOptions,
     GetConversationOptions,
     ListConversationsForPathOptions,
 } from './types';
 
+const OPENCODE_CONVERSATION_HYDRATION_CONCURRENCY = 4;
+
 const getDbPath = (options: { locations?: { opencodeDbPath?: string } }) =>
     options.locations?.opencodeDbPath ?? resolveOpenCodeDbPath();
 
@@ -38,7 +46,10 @@ const textPartToMessages = (
     finalTextPartIds: Set<string>,
     order: number,
 ): ConversationMessage[] => {
-    const split = splitOpenCodeThinkTaggedText(part.text ?? '');
+    const split =
+        part.role === 'assistant'
+            ? splitOpenCodeThinkTaggedText(part.text ?? '')
+            : { reasoningBlocks: [], visibleText: part.text ?? '' };
     return [
         ...createTextMessage({
             createdAtMs: part.createdAtMs,
@@ -80,15 +91,27 @@ const partToMessages = (
     }
 
     if (part.type === 'tool') {
-        return createTextMessage({
-            createdAtMs: part.createdAtMs,
-            id: part.partId,
-            metadata: { callId: part.callId, status: part.status, toolName: part.toolName },
-            order,
-            phase: part.outputText ? 'tool_output' : 'tool_call',
-            role: 'tool',
-            text: part.outputText ?? part.argumentsText ?? part.title ?? part.toolName,
-        });
+        const metadata = { callId: part.callId, status: part.status, toolName: part.toolName };
+        return [
+            ...createTextMessage({
+                createdAtMs: part.createdAtMs,
+                id: `${part.partId}:tool_call`,
+                metadata,
+                order,
+                phase: 'tool_call',
+                role: 'tool',
+                text: [part.toolName, part.argumentsText ?? part.title].filter(Boolean).join('\n'),
+            }),
+            ...createTextMessage({
+                createdAtMs: part.createdAtMs,
+                id: `${part.partId}:tool_output`,
+                metadata,
+                order,
+                phase: 'tool_output',
+                role: 'tool',
+                text: part.outputText,
+            }),
+        ];
     }
 
     return [];
@@ -109,7 +132,13 @@ const buildConversation = async (
 ): Promise<ConversationDetail> => {
     const transcript =
         loadedTranscript ??
-        (options.includeMessages ? await readOpenCodeSessionTranscript(dbPath, session.sessionId) : null);
+        (options.includeMessages
+            ? await runWithTranscriptLoadLimit(() => readOpenCodeSessionTranscript(dbPath, session.sessionId), {
+                  id: session.sessionId,
+                  path: dbPath,
+                  source: 'opencode-api',
+              })
+            : null);
     const allMessages = transcript ? transcriptToMessages(transcript) : [];
     const messages = options.includeMessages
         ? selectConversationMessages(allMessages, options.messageSelector ?? 'last_final_answer')
@@ -117,7 +146,11 @@ const buildConversation = async (
 
     return {
         createdAtMs: session.createdAtMs,
-        deepLinks: createDeepLinks('opencode', session.sessionId, `/opencode-sessions/${session.sessionId}`),
+        deepLinks: createDeepLinks(
+            'opencode',
+            session.sessionId,
+            createConversationUiPath('opencode-sessions', session.sessionId),
+        ),
         id: session.sessionId,
         matches,
         messageCount: options.includeMessages ? allMessages.length : session.messageCount,
@@ -147,10 +180,14 @@ const listOpenCodeConversationsForPath = async (options: ListConversationsForPat
         if (!match) {
             continue;
         }
-        const sessions = await listOpenCodeSessionsForGroup(group.key, dbPath);
-        for (const session of sessions) {
-            conversations.push(await buildConversation(session, dbPath, [match], options));
-        }
+        const sessions = (await listOpenCodeSessionsForGroup(group.key, dbPath)).filter((session) =>
+            isWithinUpdatedWindow(session.lastUpdatedAtMs, options),
+        );
+        conversations.push(
+            ...(await mapWithConcurrency(sessions, OPENCODE_CONVERSATION_HYDRATION_CONCURRENCY, (session) =>
+                buildConversation(session, dbPath, [match], options),
+            )),
+        );
     }
 
     return conversations;
@@ -158,7 +195,11 @@ const listOpenCodeConversationsForPath = async (options: ListConversationsForPat
 
 const getOpenCodeConversation = async (options: GetConversationOptions): Promise<ConversationDetail | null> => {
     const dbPath = getDbPath(options);
-    const transcript = await readOpenCodeSessionTranscript(dbPath, options.id);
+    const transcript = await runWithTranscriptLoadLimit(() => readOpenCodeSessionTranscript(dbPath, options.id), {
+        id: options.id,
+        path: dbPath,
+        source: 'opencode-api',
+    });
     return transcript
         ? buildConversation(
               transcript.session,
@@ -173,7 +214,16 @@ const getOpenCodeConversation = async (options: GetConversationOptions): Promise
         : null;
 };
 
+const deleteOpenCodeConversation = async (options: DeleteConversationOptions) => {
+    const result = await deleteOpenCodeSession(getDbPath(options), options.id);
+    return {
+        deletedFiles: [],
+        deletedIds: result.deletedSessionIds,
+    };
+};
+
 export const opencodeConversationAdapter: ConversationAdapter = {
+    deleteConversation: deleteOpenCodeConversation,
     getConversation: getOpenCodeConversation,
     listConversationsForPath: listOpenCodeConversationsForPath,
     source: 'opencode',

package/src/lib/conversation-data/path-match.ts

@@ -1,20 +1,8 @@
 import { realpath } from 'node:fs/promises';
-import os from 'node:os';
 import path from 'node:path';
+import { expandHome } from '../shared';
 import type { ConversationPathMatch } from './types';
 
-const expandHome = (value: string) => {
-    if (value === '~') {
-        return os.homedir();
-    }
-
-    if (value.startsWith('~/') || value.startsWith('~\\')) {
-        return path.join(os.homedir(), value.slice(2));
-    }
-
-    return value;
-};
-
 const trimTrailingSeparators = (value: string) => {
     const trimmed = value.replace(/[\\/]+$/u, '');
     return trimmed || value;

package/src/lib/conversation-data/qoder-adapter.ts

@@ -14,10 +14,13 @@ import type {
 import { resolveQoderGlobalStateDb, resolveQoderWorkspaceStorageDir } from '../qoder-exporter-types';
 import { getFinalQoderAssistantMessageEntryIds, getQoderMessagePhase } from '../qoder-transcript-phase';
 import { cleanInlineTitle } from '../shared';
+import { runWithTranscriptLoadLimit } from '../transcript-load-limiter';
 import {
+    createConversationUiPath,
     createDeepLinks,
     createTextMessage,
     finalizeMessages,
+    isWithinUpdatedWindow,
     normalizeAssistantPhase,
     normalizeRole,
     toDateMs,
@@ -35,6 +38,11 @@ import type {
 
 const QODER_CONVERSATION_HYDRATION_CONCURRENCY = 4;
 
+const getPartString = (part: QoderTranscriptPart, key: string): string | null => {
+    const value = part.raw[key];
+    return typeof value === 'string' && value.trim() ? value : null;
+};
+
 const getQoderLocations = (options: {
     locations?: {
         qoderAcpSocketPath?: string;
@@ -49,20 +57,6 @@ const getQoderLocations = (options: {
     workspaceStorageDir: options.locations?.qoderWorkspaceStorageDir ?? resolveQoderWorkspaceStorageDir(),
 });
 
-const isWithinUpdatedWindow = (
-    session: QoderSessionSummary,
-    options: Pick<ListConversationsForPathOptions, 'updatedAfterMs' | 'updatedBeforeMs'>,
-): boolean => {
-    const updatedAtMs = session.lastActiveAtMs ?? 0;
-    if (options.updatedAfterMs !== undefined && updatedAtMs < options.updatedAfterMs) {
-        return false;
-    }
-    if (options.updatedBeforeMs !== undefined && updatedAtMs > options.updatedBeforeMs) {
-        return false;
-    }
-    return true;
-};
-
 const partToMessages = (
     entry: QoderTranscriptEntry,
     part: QoderTranscriptPart,
@@ -73,7 +67,11 @@ const partToMessages = (
         return createTextMessage({
             createdAtMs: toDateMs(entry.timestamp),
             id: `${entry.entryId}:${partIndex}`,
-            metadata: { requestId: entry.requestId },
+            metadata: {
+                requestId: entry.requestId,
+                toolCallId: getPartString(part, 'toolCallId') ?? entry.entryId,
+                toolName: getPartString(part, 'toolName'),
+            },
             order: partIndex,
             phase: 'tool_call',
             role: 'tool',
@@ -85,7 +83,11 @@ const partToMessages = (
         return createTextMessage({
             createdAtMs: toDateMs(entry.timestamp),
             id: `${entry.entryId}:${partIndex}`,
-            metadata: { requestId: entry.requestId },
+            metadata: {
+                requestId: entry.requestId,
+                toolCallId: getPartString(part, 'toolCallId'),
+                toolName: getPartString(part, 'toolName'),
+            },
             order: partIndex,
             phase: 'tool_output',
             role: 'tool',
@@ -117,18 +119,28 @@ const buildConversation = async (
     locations: ReturnType<typeof getQoderLocations>,
     matches: ConversationPathMatch[],
     options: Pick<ListConversationsForPathOptions, 'includeMessages' | 'messageSelector'>,
+    loadedTranscript: QoderSessionTranscript | null = null,
 ): Promise<ConversationDetail> => {
     const transcript = options.includeMessages
-        ? await readQoderSessionTranscript(
-              locations.globalStateDb,
-              locations.workspaceStorageDir,
-              session.sessionId,
-              locations.cliProjectsDir,
+        ? (loadedTranscript ??
+          (await runWithTranscriptLoadLimit(
+              () =>
+                  readQoderSessionTranscript(
+                      locations.globalStateDb,
+                      locations.workspaceStorageDir,
+                      session.sessionId,
+                      locations.cliProjectsDir,
+                      {
+                          acpSocketPath: locations.acpSocketPath,
+                          enableAcp: locations.acpSocketPath ? true : undefined,
+                      },
+                  ),
               {
-                  acpSocketPath: locations.acpSocketPath,
-                  enableAcp: locations.acpSocketPath ? true : undefined,
+                  id: session.sessionId,
+                  path: session.sourceStatePath ?? locations.globalStateDb,
+                  source: 'qoder-api',
               },
-          )
+          )))
         : null;
     const allMessages = transcript ? transcriptToMessages(transcript) : [];
     const messages = options.includeMessages
@@ -144,7 +156,11 @@ const buildConversation = async (
 
     return {
         createdAtMs: session.createdAtMs,
-        deepLinks: createDeepLinks('qoder', session.sessionId, `/qoder-sessions/${session.sessionId}`),
+        deepLinks: createDeepLinks(
+            'qoder',
+            session.sessionId,
+            createConversationUiPath('qoder-sessions', session.sessionId),
+        ),
         id: session.sessionId,
         matches,
         messageCount: options.includeMessages ? allMessages.length : session.messageCount,
@@ -190,7 +206,7 @@ const listQoderConversationsForPath = async (options: ListConversationsForPathOp
             locations.workspaceStorageDir,
         );
         for (const session of sessions) {
-            if (!isWithinUpdatedWindow(session, options)) {
+            if (!isWithinUpdatedWindow(session.lastActiveAtMs, options)) {
                 continue;
             }
 
@@ -205,21 +221,35 @@ const listQoderConversationsForPath = async (options: ListConversationsForPathOp
 
 const getQoderConversation = async (options: GetConversationOptions): Promise<ConversationDetail | null> => {
     const locations = getQoderLocations(options);
-    const transcript = await readQoderSessionTranscript(
-        locations.globalStateDb,
-        locations.workspaceStorageDir,
-        options.id,
-        locations.cliProjectsDir,
+    const transcript = await runWithTranscriptLoadLimit(
+        () =>
+            readQoderSessionTranscript(
+                locations.globalStateDb,
+                locations.workspaceStorageDir,
+                options.id,
+                locations.cliProjectsDir,
+                {
+                    acpSocketPath: locations.acpSocketPath,
+                    enableAcp: locations.acpSocketPath ? true : undefined,
+                },
+            ),
         {
-            acpSocketPath: locations.acpSocketPath,
-            enableAcp: locations.acpSocketPath ? true : undefined,
+            id: options.id,
+            path: locations.globalStateDb,
+            source: 'qoder-api',
         },
     );
     return transcript
-        ? buildConversation(transcript.session, locations, [], {
-              includeMessages: true,
-              messageSelector: options.messageSelector ?? 'all',
-          })
+        ? buildConversation(
+              transcript.session,
+              locations,
+              [],
+              {
+                  includeMessages: true,
+                  messageSelector: options.messageSelector ?? 'all',
+              },
+              transcript,
+          )
         : null;
 };
 

package/src/lib/conversation-data/types.ts

@@ -1,6 +1,7 @@
 export const CONVERSATION_SOURCES = [
     'codex',
     'claude-code',
+    'grok',
     'kiro',
     'qoder',
     'cursor',
@@ -77,6 +78,7 @@ export type ConversationDataLocations = {
     claudeCodeProjectsDir?: string;
     codexDbPath?: string;
     cursorUserDir?: string;
+    grokSessionsDir?: string;
     kiroWorkspaceSessionsDir?: string;
     opencodeDbPath?: string;
     qoderAcpSocketPath?: string;
@@ -104,12 +106,53 @@ export type GetConversationOptions = {
     source: ConversationSource;
 };
 
+export type DeleteConversationOptions = {
+    id: string;
+    locations?: ConversationDataLocations;
+    source: ConversationSource;
+};
+
+export type DeleteConversationResult = {
+    deletedFiles: string[];
+    deletedIds: string[];
+};
+
+export type ConversationIdSetOptions = {
+    ids: string[];
+    locations?: ConversationDataLocations;
+    source: ConversationSource;
+};
+
+export type DeleteConversationsOptions = ConversationIdSetOptions;
+
+export type DeleteConversationItemResult = DeleteConversationResult & {
+    deleted: boolean;
+    id: string;
+};
+
+export type DeleteConversationsResult = DeleteConversationResult & {
+    missingIds: string[];
+    results: DeleteConversationItemResult[];
+};
+
+export type ExportConversationsZipOptions = ConversationIdSetOptions & {
+    messageSelector?: ConversationMessageSelector;
+    outputFormat?: 'md';
+};
+
+export type ConversationZipDownload = {
+    blob: Blob;
+    fileName: string;
+    mimeType: 'application/zip';
+};
+
 export type ResolvedConversationRef = {
     id: string;
     source: ConversationSource;
 };
 
 export type ConversationAdapter = {
+    deleteConversation?: (options: DeleteConversationOptions) => Promise<DeleteConversationResult>;
     getConversation: (options: GetConversationOptions) => Promise<ConversationDetail | null>;
     listConversationsForPath: (options: ListConversationsForPathOptions) => Promise<ConversationDetail[]>;
     source: ConversationSource;

package/src/lib/conversation-zip-export.ts

@@ -0,0 +1,75 @@
+import { randomUUID } from 'node:crypto';
+import { mkdtemp, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { resolveUniqueExportFileBaseName, sanitizeExportFileName } from './ui-export-archive';
+import { zipExportDirectory } from './ui-export-zip';
+
+type ConversationMarkdownZipEntry = {
+    fallbackBaseName: string;
+    markdown: string;
+    title: string | null;
+};
+
+type ConversationMarkdownZipOptions = {
+    entries: ConversationMarkdownZipEntry[];
+    fileBaseName: string;
+};
+
+const EXPORT_BASE_NAME_BYTE_LIMIT = 120;
+
+const truncateUtf8 = (value: string, maxBytes: number) => {
+    let bytes = 0;
+    let result = '';
+    for (const character of value) {
+        const characterBytes = Buffer.byteLength(character);
+        if (bytes + characterBytes > maxBytes) {
+            break;
+        }
+        bytes += characterBytes;
+        result += character;
+    }
+    return result;
+};
+
+export type ConversationMarkdownZip = {
+    blob: Blob;
+    fileName: string;
+    mimeType: 'application/zip';
+};
+
+const toSafeFileBaseName = (value: string | null, fallback: string) => {
+    const sanitized = sanitizeExportFileName(value?.trim() || '') || sanitizeExportFileName(fallback) || 'conversation';
+    return truncateUtf8(sanitized, EXPORT_BASE_NAME_BYTE_LIMIT) || 'conversation';
+};
+
+export const createConversationMarkdownZip = async ({
+    entries,
+    fileBaseName,
+}: ConversationMarkdownZipOptions): Promise<ConversationMarkdownZip> => {
+    if (entries.length === 0) {
+        throw new Error('No conversations selected for export');
+    }
+
+    const safeBaseName = toSafeFileBaseName(fileBaseName, 'conversations');
+    const workspaceDir = await mkdtemp(path.join(os.tmpdir(), `${safeBaseName}-`));
+    const zipPath = path.join(os.tmpdir(), `${safeBaseName}-${randomUUID()}.zip`);
+    const usedBaseNames = new Map<string, number>();
+
+    try {
+        for (const entry of entries) {
+            const entryBaseName = toSafeFileBaseName(entry.title, entry.fallbackBaseName);
+            const fileBaseNameForEntry = resolveUniqueExportFileBaseName(entryBaseName, usedBaseNames);
+            await Bun.write(path.join(workspaceDir, `${fileBaseNameForEntry}.md`), entry.markdown);
+        }
+
+        await zipExportDirectory(workspaceDir, zipPath);
+        return {
+            blob: new Blob([await Bun.file(zipPath).arrayBuffer()], { type: 'application/zip' }),
+            fileName: `${safeBaseName}.zip`,
+            mimeType: 'application/zip',
+        };
+    } finally {
+        await Promise.all([rm(workspaceDir, { force: true, recursive: true }), rm(zipPath, { force: true })]);
+    }
+};