spiracha 2.0.0 → 2.1.0

package/apps/ui/src/lib/qoder-server.ts

@@ -1,6 +1,6 @@
 import { createServerFn } from '@tanstack/react-start';
 import { z } from 'zod';
-import { renderSourceSessionDownload } from './source-session-export-server';
+import { renderSourceSessionDownload, renderSourceSessionsDownload } from './source-session-export-server';
 
 const workspaceSchema = z.object({
     workspaceKey: z.string().min(1),
@@ -19,6 +19,15 @@ const exportSessionSchema = z.object({
     zipArchive: z.boolean().default(false),
 });
 
+const exportSessionsSchema = z.object({
+    includeCommentary: z.boolean().default(true),
+    includeMetadata: z.boolean().default(true),
+    includeTools: z.boolean().default(true),
+    outputFormat: z.enum(['md', 'txt']).default('md'),
+    sessionIds: z.array(z.string().min(1)).min(1),
+    zipArchive: z.boolean().default(true),
+});
+
 export const listQoderWorkspacesFn = createServerFn({ method: 'GET' }).handler(async () => {
     const { listQoderWorkspaceGroups } = await import('@spiracha/lib/qoder-db');
     return listQoderWorkspaceGroups();
@@ -32,19 +41,27 @@ export const listQoderSessionsFn = createServerFn({ method: 'GET' })
     });
 
 const loadQoderSessionTranscript = async (sessionId: string) => {
+    const { runWithTranscriptLoadLimit } = await import('@spiracha/lib/transcript-load-limiter');
     const { readQoderSessionTranscript, resolveQoderGlobalStateDb, resolveQoderWorkspaceStorageDir } = await import(
         '@spiracha/lib/qoder-db'
     );
-    const transcript = await readQoderSessionTranscript(
-        resolveQoderGlobalStateDb(),
-        resolveQoderWorkspaceStorageDir(),
-        sessionId,
-    );
-    if (!transcript) {
-        throw new Error(`Qoder session not found: ${sessionId}`);
-    }
+    const globalStateDb = resolveQoderGlobalStateDb();
+    const workspaceStorageDir = resolveQoderWorkspaceStorageDir();
+    return runWithTranscriptLoadLimit(
+        async () => {
+            const transcript = await readQoderSessionTranscript(globalStateDb, workspaceStorageDir, sessionId);
+            if (!transcript) {
+                throw new Error(`Qoder session not found: ${sessionId}`);
+            }
 
-    return transcript;
+            return transcript;
+        },
+        {
+            id: sessionId,
+            path: globalStateDb,
+            source: 'qoder-ui',
+        },
+    );
 };
 
 export const getQoderSessionDetailFn = createServerFn({ method: 'GET' })
@@ -71,8 +88,47 @@ export const exportQoderSessionFn = createServerFn({ method: 'POST' })
 
         return renderSourceSessionDownload({
             content,
+            cwd: transcript.session.workspacePath ?? transcript.session.worktree,
             fallbackBaseName: 'qoder-session',
-            fileBaseName: transcript.session.title || transcript.session.sessionId,
+            outputFormat: data.outputFormat,
+            sessionId: transcript.session.sessionId,
+            updatedAtMs: transcript.session.lastActiveAtMs,
+            zipArchive: data.zipArchive,
+        });
+    });
+
+export const exportQoderSessionsFn = createServerFn({ method: 'POST' })
+    .validator(exportSessionsSchema)
+    .handler(async ({ data }) => {
+        const { renderQoderTranscript } = await import('@spiracha/lib/qoder-transcript');
+        const entries = await Promise.all(
+            data.sessionIds.map(async (sessionId) => {
+                const transcript = await loadQoderSessionTranscript(sessionId);
+                const content = renderQoderTranscript(transcript, {
+                    includeCommentary: data.includeCommentary,
+                    includeMetadata: data.includeMetadata,
+                    includeTools: data.includeTools,
+                    outputFormat: data.outputFormat,
+                });
+
+                if (!content) {
+                    throw new Error(`Qoder session has no exportable content: ${sessionId}`);
+                }
+
+                return {
+                    content,
+                    cwd: transcript.session.workspacePath ?? transcript.session.worktree,
+                    fallbackBaseName: 'qoder-session',
+                    fileBaseName: transcript.session.title || transcript.session.sessionId,
+                    sessionId: transcript.session.sessionId,
+                    updatedAtMs: transcript.session.lastActiveAtMs,
+                };
+            }),
+        );
+
+        return renderSourceSessionsDownload({
+            entries,
+            fallbackBaseName: 'qoder-sessions',
             outputFormat: data.outputFormat,
             zipArchive: data.zipArchive,
         });

package/apps/ui/src/lib/route-search.ts

@@ -6,6 +6,16 @@ export type AnalyticsSearch = {
     project?: string;
 };
 
+export type ThreadTranscriptSearch = {
+    commentary?: boolean;
+    extra?: boolean;
+    q?: string;
+    raw?: boolean;
+    sort?: 'earliest' | 'latest';
+    tools?: boolean;
+    user?: boolean;
+};
+
 type SearchRecord = Record<string, unknown>;
 
 const asNonBlankString = (value: unknown) => {
@@ -27,6 +37,110 @@ export const parseAnalyticsSearch = (search: SearchRecord): AnalyticsSearch => {
     return project ? { project } : {};
 };
 
+const asBooleanSearch = (value: unknown) => {
+    if (value === true || value === 'true' || value === '1') {
+        return true;
+    }
+
+    if (value === false || value === 'false' || value === '0') {
+        return false;
+    }
+
+    return undefined;
+};
+
+const setBooleanSearchParam = (target: SearchRecord, key: keyof ThreadTranscriptSearch, value: boolean) => {
+    if (value) {
+        target[key] = true;
+        return;
+    }
+
+    delete target[key];
+};
+
+const setTextSearchParam = (target: SearchRecord, key: keyof ThreadTranscriptSearch, value: string | undefined) => {
+    const trimmed = asNonBlankString(value);
+    if (trimmed) {
+        target[key] = trimmed;
+        return;
+    }
+
+    delete target[key];
+};
+
+const setThreadSortSearchParam = (target: SearchRecord, value: ThreadTranscriptSearch['sort']) => {
+    if (value === 'latest') {
+        target.sort = 'latest';
+        return;
+    }
+
+    delete target.sort;
+};
+
+export const parseThreadTranscriptSearch = (search: SearchRecord): ThreadTranscriptSearch => {
+    const q = asNonBlankString(search.q);
+    const sort = search.sort === 'latest' ? 'latest' : undefined;
+    const parsed: ThreadTranscriptSearch = q ? { q } : {};
+    const tools = asBooleanSearch(search.tools);
+    const commentary = asBooleanSearch(search.commentary);
+    const extra = asBooleanSearch(search.extra);
+    const raw = asBooleanSearch(search.raw);
+    const user = asBooleanSearch(search.user);
+
+    if (tools) {
+        parsed.tools = true;
+    }
+    if (commentary) {
+        parsed.commentary = true;
+    }
+    if (extra) {
+        parsed.extra = true;
+    }
+    if (raw) {
+        parsed.raw = true;
+    }
+    if (user) {
+        parsed.user = true;
+    }
+    if (sort) {
+        parsed.sort = sort;
+    }
+
+    return parsed;
+};
+
+export const withThreadTranscriptSearch = (
+    current: SearchRecord,
+    patch: Partial<ThreadTranscriptSearch>,
+): SearchRecord & ThreadTranscriptSearch => {
+    const next = { ...current };
+
+    if ('q' in patch) {
+        setTextSearchParam(next, 'q', patch.q);
+    }
+    if ('sort' in patch) {
+        setThreadSortSearchParam(next, patch.sort);
+    }
+
+    if ('tools' in patch && typeof patch.tools === 'boolean') {
+        setBooleanSearchParam(next, 'tools', patch.tools);
+    }
+    if ('commentary' in patch && typeof patch.commentary === 'boolean') {
+        setBooleanSearchParam(next, 'commentary', patch.commentary);
+    }
+    if ('extra' in patch && typeof patch.extra === 'boolean') {
+        setBooleanSearchParam(next, 'extra', patch.extra);
+    }
+    if ('raw' in patch && typeof patch.raw === 'boolean') {
+        setBooleanSearchParam(next, 'raw', patch.raw);
+    }
+    if ('user' in patch && typeof patch.user === 'boolean') {
+        setBooleanSearchParam(next, 'user', patch.user);
+    }
+
+    return next as SearchRecord & ThreadTranscriptSearch;
+};
+
 export const withTextQuerySearch = (current: SearchRecord, query: string): SearchRecord & TextQuerySearch => {
     const next = { ...current };
     const q = asNonBlankString(query);

package/apps/ui/src/lib/source-session-export-server.ts

@@ -2,15 +2,40 @@ import { randomUUID } from 'node:crypto';
 import { mkdtemp, rm } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
-import { getExportMimeType, sanitizeExportFileName, zipExportDirectory } from '@spiracha/lib/ui-export-archive';
+import {
+    buildBatchExportBaseName,
+    buildConversationExportBaseName,
+    getExportMimeType,
+    resolveUniqueExportFileBaseName,
+    sanitizeExportFileName,
+    zipExportDirectory,
+} from '@spiracha/lib/ui-export-archive';
 import { buildUiExportDownloadUrl, ensureUiExportDir } from '@spiracha/lib/ui-export-files';
 
 type ExportFormat = 'md' | 'txt';
 
 type RenderSourceSessionDownloadOptions = {
     content: string;
+    cwd: string | null;
+    fallbackBaseName: string;
+    outputFormat: ExportFormat;
+    sessionId: string;
+    updatedAtMs: number | null;
+    zipArchive: boolean;
+};
+
+type RenderedSourceSession = {
+    content: string;
+    cwd: string | null;
     fallbackBaseName: string;
     fileBaseName: string;
+    sessionId: string;
+    updatedAtMs: number | null;
+};
+
+type RenderSourceSessionsDownloadOptions = {
+    entries: RenderedSourceSession[];
+    fallbackBaseName: string;
     outputFormat: ExportFormat;
     zipArchive: boolean;
 };
@@ -21,12 +46,21 @@ export const toSafeSourceExportName = (value: string, fallback: string) => {
 
 export const renderSourceSessionDownload = async ({
     content,
+    cwd,
     fallbackBaseName,
-    fileBaseName,
     outputFormat,
+    sessionId,
+    updatedAtMs,
     zipArchive,
 }: RenderSourceSessionDownloadOptions) => {
-    const safeBaseName = toSafeSourceExportName(fileBaseName, fallbackBaseName);
+    const safeBaseName = buildConversationExportBaseName(
+        {
+            cwd,
+            id: sessionId,
+            updatedAtMs,
+        },
+        fallbackBaseName,
+    );
     if (!zipArchive) {
         return {
             content,
@@ -54,3 +88,52 @@ export const renderSourceSessionDownload = async ({
         mode: 'download_url' as const,
     };
 };
+
+export const renderSourceSessionsDownload = async ({
+    entries,
+    fallbackBaseName,
+    outputFormat,
+    zipArchive,
+}: RenderSourceSessionsDownloadOptions) => {
+    if (entries.length === 0) {
+        throw new Error('No transcripts selected for export');
+    }
+
+    if (entries.length === 1) {
+        const entry = entries[0]!;
+        return renderSourceSessionDownload({
+            content: entry.content,
+            cwd: entry.cwd,
+            fallbackBaseName: entry.fallbackBaseName,
+            outputFormat,
+            sessionId: entry.sessionId,
+            updatedAtMs: entry.updatedAtMs,
+            zipArchive,
+        });
+    }
+
+    const safeBaseName = buildBatchExportBaseName(entries, fallbackBaseName);
+    const exportDir = await ensureUiExportDir();
+    const workspaceDir = await mkdtemp(path.join(os.tmpdir(), `${safeBaseName}-`));
+    const zipPath = path.join(exportDir, `${safeBaseName}-${randomUUID()}.zip`);
+    const usedBaseNames = new Map<string, number>();
+
+    try {
+        for (const entry of entries) {
+            const baseName = toSafeSourceExportName(entry.fileBaseName, entry.fallbackBaseName);
+            const fileBaseName = resolveUniqueExportFileBaseName(baseName, usedBaseNames);
+            await Bun.write(path.join(workspaceDir, `${fileBaseName}.${outputFormat}`), entry.content);
+        }
+
+        await zipExportDirectory(workspaceDir, zipPath);
+    } finally {
+        await rm(workspaceDir, { force: true, recursive: true });
+    }
+
+    return {
+        downloadUrl: buildUiExportDownloadUrl(zipPath),
+        fileName: `${safeBaseName}.zip`,
+        mimeType: 'application/zip',
+        mode: 'download_url' as const,
+    };
+};

package/apps/ui/src/lib/thread-transcript-load.ts

@@ -0,0 +1,15 @@
+type TranscriptLoadState = {
+    isPartial: boolean;
+} | null;
+
+export const shouldLoadFullThreadTranscript = ({
+    shouldLoadTranscript,
+    snapshotTranscript,
+    transcriptMissing,
+}: {
+    shouldLoadTranscript: boolean;
+    snapshotTranscript: TranscriptLoadState;
+    transcriptMissing: boolean;
+}) => {
+    return shouldLoadTranscript && !transcriptMissing && (snapshotTranscript === null || snapshotTranscript.isPartial);
+};

package/apps/ui/src/lib/workspace-delete-navigation.ts

@@ -0,0 +1,12 @@
+export const isWorkspaceEmptiedByDelete = <TItem>(
+    items: TItem[],
+    deletedIds: string[],
+    getItemId: (item: TItem) => string,
+) => {
+    if (items.length === 0 || deletedIds.length === 0) {
+        return false;
+    }
+
+    const deletedIdSet = new Set(deletedIds);
+    return items.every((item) => deletedIdSet.has(getItemId(item)));
+};