spiracha 1.5.0 → 2.1.0

package/apps/ui/src/lib/cursor-transcript-events.ts

@@ -0,0 +1,229 @@
+import type { ThreadEvent, ThreadTranscriptStats } from '@spiracha/lib/codex-browser-types';
+import type { CursorBubble, CursorThreadTranscript, CursorToolCall } from '@spiracha/lib/cursor-exporter-types';
+import type { JsonValue } from '@spiracha/lib/shared';
+
+const toTimestamp = (value: number | null): string | null => {
+    if (value === null || !Number.isFinite(value)) {
+        return null;
+    }
+
+    return new Date(value).toISOString();
+};
+
+const toolCallToJson = (toolCall: CursorToolCall | null): JsonValue => {
+    if (!toolCall) {
+        return null;
+    }
+
+    return {
+        argumentsText: toolCall.argumentsText,
+        callId: toolCall.callId,
+        name: toolCall.name,
+        resultText: toolCall.resultText,
+        status: toolCall.status,
+    };
+};
+
+const buildBubbleRaw = (
+    bubble: CursorBubble,
+    eventType: string,
+    extra: Record<string, JsonValue> = {},
+): Record<string, JsonValue> => ({
+    bubbleId: bubble.bubbleId,
+    createdAtMs: bubble.createdAtMs,
+    eventType,
+    kind: bubble.kind,
+    source: 'cursor_bubble',
+    text: bubble.text,
+    thinking: bubble.thinking,
+    toolCall: toolCallToJson(bubble.toolCall),
+    ...extra,
+});
+
+const buildMessageEvent = (
+    bubble: CursorBubble,
+    sequence: number,
+    role: 'assistant' | 'user',
+    text: string,
+    phase: string | null,
+): ThreadEvent => ({
+    isHiddenByDefault: false,
+    kind: 'message',
+    memoryCitation: null,
+    model: null,
+    phase,
+    raw: buildBubbleRaw(bubble, phase === 'commentary' ? 'thinking' : 'message'),
+    role,
+    sequence,
+    text,
+    timestamp: toTimestamp(bubble.createdAtMs),
+    variant: role === 'user' ? 'user_message' : 'agent_message',
+});
+
+const buildToolCallCommand = (toolCall: CursorToolCall): string => {
+    if (!toolCall.argumentsText?.trim()) {
+        return toolCall.name;
+    }
+
+    return `${toolCall.name}\n${toolCall.argumentsText}`;
+};
+
+const buildToolCallEvent = (bubble: CursorBubble, sequence: number, toolCall: CursorToolCall): ThreadEvent => ({
+    argumentsParseFailed: false,
+    argumentsText: toolCall.argumentsText,
+    callId: toolCall.callId,
+    command: buildToolCallCommand(toolCall),
+    kind: 'tool_call',
+    name: toolCall.name,
+    raw: buildBubbleRaw(bubble, 'tool_call', {
+        argumentsText: toolCall.argumentsText,
+        callId: toolCall.callId,
+        name: toolCall.name,
+        status: toolCall.status,
+    }),
+    sequence,
+    timestamp: toTimestamp(bubble.createdAtMs),
+    workdir: null,
+});
+
+const buildToolOutputEvent = (bubble: CursorBubble, sequence: number, toolCall: CursorToolCall): ThreadEvent | null => {
+    const outputText = toolCall.resultText?.trim();
+    if (!outputText) {
+        return null;
+    }
+
+    return {
+        callId: toolCall.callId,
+        exitCode: null,
+        kind: 'tool_output',
+        outputText,
+        raw: buildBubbleRaw(bubble, 'tool_output', {
+            callId: toolCall.callId,
+            name: toolCall.name,
+            resultText: outputText,
+            status: toolCall.status,
+        }),
+        sequence,
+        summary: outputText,
+        timestamp: toTimestamp(bubble.createdAtMs),
+        wallTime: null,
+    };
+};
+
+const getAssistantFinalTextIndexes = (bubbles: CursorBubble[]) => {
+    const finalTextIndexes = new Set<number>();
+    let currentAssistantTextIndex: number | null = null;
+
+    const flushAssistantRun = () => {
+        if (currentAssistantTextIndex !== null) {
+            finalTextIndexes.add(currentAssistantTextIndex);
+            currentAssistantTextIndex = null;
+        }
+    };
+
+    bubbles.forEach((bubble, index) => {
+        if (bubble.kind !== 'assistant') {
+            flushAssistantRun();
+            return;
+        }
+
+        if (bubble.text.trim()) {
+            currentAssistantTextIndex = index;
+        }
+    });
+
+    flushAssistantRun();
+    return finalTextIndexes;
+};
+
+const cursorBubbleToThreadEvents = (
+    bubble: CursorBubble,
+    bubbleIndex: number,
+    finalTextIndexes: Set<number>,
+): ThreadEvent[] => {
+    if (bubble.kind !== 'assistant' && bubble.kind !== 'user') {
+        return [];
+    }
+
+    const baseSequence = bubbleIndex * 10;
+    const events: ThreadEvent[] = [];
+    if (bubble.kind === 'assistant' && bubble.thinking?.trim()) {
+        events.push(buildMessageEvent(bubble, baseSequence, 'assistant', bubble.thinking.trim(), 'commentary'));
+    }
+
+    if (bubble.text.trim()) {
+        const phase =
+            bubble.kind === 'assistant' ? (finalTextIndexes.has(bubbleIndex) ? 'final_answer' : 'commentary') : null;
+        events.push(buildMessageEvent(bubble, baseSequence + 1, bubble.kind, bubble.text, phase));
+    }
+
+    if (bubble.kind === 'assistant' && bubble.toolCall) {
+        events.push(buildToolCallEvent(bubble, baseSequence + 2, bubble.toolCall));
+        const output = buildToolOutputEvent(bubble, baseSequence + 3, bubble.toolCall);
+        if (output) {
+            events.push(output);
+        }
+    }
+
+    return events;
+};
+
+export const cursorTranscriptToThreadEvents = (transcript: CursorThreadTranscript): ThreadEvent[] => {
+    const finalTextIndexes = getAssistantFinalTextIndexes(transcript.bubbles);
+    return transcript.bubbles.flatMap((bubble, index) => cursorBubbleToThreadEvents(bubble, index, finalTextIndexes));
+};
+
+const updateMessageStats = (stats: ThreadTranscriptStats, event: Extract<ThreadEvent, { kind: 'message' }>) => {
+    stats.messageCount += 1;
+    if (event.role === 'assistant') {
+        stats.assistantMessageCount += 1;
+    }
+    if (event.role === 'user') {
+        stats.userMessageCount += 1;
+    }
+    if (event.phase === 'commentary') {
+        stats.commentaryCount += 1;
+    }
+    if (event.phase === 'final_answer') {
+        stats.finalAnswerCount += 1;
+    }
+};
+
+const updateCursorStats = (stats: ThreadTranscriptStats, event: ThreadEvent) => {
+    switch (event.kind) {
+        case 'message':
+            updateMessageStats(stats, event);
+            break;
+        case 'tool_call':
+            stats.toolCallCount += 1;
+            break;
+        case 'tool_output':
+            stats.toolOutputCount += 1;
+            break;
+        case 'web_search':
+            stats.webSearchEventCount += 1;
+            break;
+        default:
+            break;
+    }
+};
+
+export const getCursorThreadTranscriptStats = (events: ThreadEvent[]): ThreadTranscriptStats => {
+    const stats: ThreadTranscriptStats = {
+        assistantMessageCount: 0,
+        commentaryCount: 0,
+        execCommandCount: 0,
+        finalAnswerCount: 0,
+        messageCount: 0,
+        toolCallCount: 0,
+        toolOutputCount: 0,
+        userMessageCount: 0,
+        webSearchEventCount: 0,
+    };
+
+    for (const event of events) {
+        updateCursorStats(stats, event);
+    }
+
+    return stats;
+};

package/apps/ui/src/lib/download.ts

@@ -0,0 +1,166 @@
+type DownloadLogger = Pick<Console, 'error' | 'info' | 'warn'>;
+
+type DownloadTextOptions = {
+    createObjectUrl?: (blob: Blob) => string;
+    documentRef?: Document;
+    logger?: DownloadLogger;
+    revokeDelayMs?: number;
+    revokeObjectUrl?: (url: string) => void;
+    schedule?: (callback: () => void, delayMs: number) => void;
+};
+
+type DownloadUrlOptions = {
+    documentRef?: Document;
+    fetchImpl?: typeof fetch;
+    logger?: DownloadLogger;
+    maxAttempts?: number;
+    retryDelayMs?: number;
+    sleep?: (delayMs: number) => Promise<void>;
+};
+
+const DEFAULT_DOWNLOAD_ATTEMPTS = 6;
+const DEFAULT_DOWNLOAD_RETRY_DELAY_MS = 250;
+const DEFAULT_INLINE_REVOKE_DELAY_MS = 30000;
+
+const logDownloadEvent = (
+    logger: DownloadLogger,
+    level: keyof DownloadLogger,
+    event: string,
+    details: Record<string, unknown>,
+) => {
+    logger[level](`[spiracha:download] ${event}`, details);
+};
+
+const delay = (delayMs: number) =>
+    new Promise<void>((resolve) => {
+        window.setTimeout(resolve, delayMs);
+    });
+
+const triggerAnchorDownload = (documentRef: Document, href: string, fileName: string) => {
+    const link = documentRef.createElement('a');
+    link.href = href;
+    link.download = fileName;
+    documentRef.body.append(link);
+    link.click();
+    link.remove();
+};
+
+const isReadyStatus = (status: number) => {
+    return (status >= 200 && status < 400) || status === 405;
+};
+
+export const waitForDownloadUrlAvailability = async (
+    downloadUrl: string,
+    fileName: string,
+    {
+        fetchImpl = fetch,
+        logger = console,
+        maxAttempts = DEFAULT_DOWNLOAD_ATTEMPTS,
+        retryDelayMs = DEFAULT_DOWNLOAD_RETRY_DELAY_MS,
+        sleep = delay,
+    }: Omit<DownloadUrlOptions, 'documentRef'> = {},
+) => {
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        try {
+            const response = await fetchImpl(downloadUrl, {
+                cache: 'no-store',
+                method: 'HEAD',
+            });
+
+            if (isReadyStatus(response.status)) {
+                logDownloadEvent(logger, 'info', 'url_ready', {
+                    attempt,
+                    downloadUrl,
+                    fileName,
+                    status: response.status,
+                });
+                return;
+            }
+
+            logDownloadEvent(logger, 'warn', 'url_not_ready', {
+                attempt,
+                downloadUrl,
+                fileName,
+                status: response.status,
+            });
+        } catch (error) {
+            logDownloadEvent(logger, 'warn', 'url_probe_failed', {
+                attempt,
+                downloadUrl,
+                error: error instanceof Error ? error.message : String(error),
+                fileName,
+            });
+        }
+
+        if (attempt < maxAttempts) {
+            await sleep(retryDelayMs);
+        }
+    }
+
+    throw new Error(`Download file was not available after ${maxAttempts} attempts: ${fileName}`);
+};
+
+export const downloadUrlFile = async (
+    fileName: string,
+    downloadUrl: string,
+    {
+        documentRef = document,
+        fetchImpl = fetch,
+        logger = console,
+        maxAttempts = DEFAULT_DOWNLOAD_ATTEMPTS,
+        retryDelayMs = DEFAULT_DOWNLOAD_RETRY_DELAY_MS,
+        sleep = delay,
+    }: DownloadUrlOptions = {},
+) => {
+    logDownloadEvent(logger, 'info', 'start', {
+        downloadUrl,
+        fileName,
+    });
+
+    await waitForDownloadUrlAvailability(downloadUrl, fileName, {
+        fetchImpl,
+        logger,
+        maxAttempts,
+        retryDelayMs,
+        sleep,
+    });
+
+    triggerAnchorDownload(documentRef, downloadUrl, fileName);
+    logDownloadEvent(logger, 'info', 'triggered', {
+        downloadUrl,
+        fileName,
+    });
+};
+
+export const downloadTextFile = (
+    fileName: string,
+    content: string,
+    mimeType: string,
+    {
+        createObjectUrl = (blob) => URL.createObjectURL(blob),
+        documentRef = document,
+        logger = console,
+        revokeDelayMs = DEFAULT_INLINE_REVOKE_DELAY_MS,
+        revokeObjectUrl = (url) => URL.revokeObjectURL(url),
+        schedule = (callback, delayMs) => {
+            window.setTimeout(callback, delayMs);
+        },
+    }: DownloadTextOptions = {},
+) => {
+    logDownloadEvent(logger, 'info', 'inline_start', {
+        fileName,
+        mimeType,
+        sizeBytes: content.length,
+    });
+
+    const blob = new Blob([content], { type: mimeType });
+    const url = createObjectUrl(blob);
+    triggerAnchorDownload(documentRef, url, fileName);
+    schedule(() => revokeObjectUrl(url), revokeDelayMs);
+
+    logDownloadEvent(logger, 'info', 'inline_triggered', {
+        fileName,
+        mimeType,
+        sizeBytes: content.length,
+    });
+};

package/apps/ui/src/lib/formatters.ts

@@ -0,0 +1,147 @@
+import { formatModelLabel as formatSharedModelLabel } from '@spiracha/lib/model-label';
+
+type DateTimeFormatOptions = {
+    now?: Date;
+    timeZone?: string;
+};
+
+type DateTimeFormatterSet = {
+    dayKeyFormatter: Intl.DateTimeFormat;
+    timePartsFormatter: Intl.DateTimeFormat;
+};
+
+const DATE_TIME_FORMATTERS = new Map<string, DateTimeFormatterSet>();
+
+const getDateTimeFormatters = (timeZone?: string): DateTimeFormatterSet => {
+    const cacheKey = timeZone ?? 'local';
+    const cached = DATE_TIME_FORMATTERS.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+
+    const created = {
+        dayKeyFormatter: new Intl.DateTimeFormat('en-CA', {
+            day: '2-digit',
+            month: '2-digit',
+            timeZone,
+            year: 'numeric',
+        }),
+        timePartsFormatter: new Intl.DateTimeFormat('en-US', {
+            day: 'numeric',
+            hour: 'numeric',
+            hour12: true,
+            minute: '2-digit',
+            month: 'short',
+            timeZone,
+            year: 'numeric',
+        }),
+    };
+
+    DATE_TIME_FORMATTERS.set(cacheKey, created);
+    return created;
+};
+
+const buildDayKey = (date: Date, timeZone?: string) => {
+    return getDateTimeFormatters(timeZone).dayKeyFormatter.format(date);
+};
+
+const formatTimeParts = (date: Date, timeZone?: string) => {
+    const parts = getDateTimeFormatters(timeZone).timePartsFormatter.formatToParts(date);
+    const partMap = new Map(parts.map((part) => [part.type, part.value]));
+    const hour = partMap.get('hour');
+    const minute = partMap.get('minute');
+    const dayPeriod = partMap.get('dayPeriod');
+
+    if (!hour || !minute || !dayPeriod) {
+        return null;
+    }
+
+    return {
+        day: partMap.get('day') ?? '',
+        month: partMap.get('month') ?? '',
+        time: `${hour}:${minute} ${dayPeriod}`.trim(),
+        year: partMap.get('year') ?? '',
+    };
+};
+
+export const formatNumber = (value: number) => {
+    return new Intl.NumberFormat('en-US').format(value);
+};
+
+export const formatTokens = (value: number) => {
+    return `${formatNumber(value)} tokens`;
+};
+
+export const formatBytes = (value: number | null | undefined) => {
+    if (!value || value <= 0) {
+        return '0 B';
+    }
+
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let size = value;
+    let unitIndex = 0;
+
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex += 1;
+    }
+
+    const fractionDigits = size >= 100 || unitIndex === 0 ? 0 : 1;
+    return `${size.toFixed(fractionDigits)} ${units[unitIndex]}`;
+};
+
+export const formatDateTime = (
+    value: number | string | null | undefined,
+    options: DateTimeFormatOptions = {},
+): string => {
+    if (value === null || value === undefined || value === '') {
+        return 'n/a';
+    }
+
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return 'n/a';
+    }
+
+    const now = options.now ?? new Date();
+    const parts = formatTimeParts(date, options.timeZone);
+    if (!parts) {
+        return 'n/a';
+    }
+
+    const { day, month, time, year } = parts;
+    const isToday = buildDayKey(date, options.timeZone) === buildDayKey(now, options.timeZone);
+
+    if (isToday) {
+        return time;
+    }
+
+    const currentYear = formatTimeParts(now, options.timeZone)?.year;
+    if (year && currentYear && year !== currentYear) {
+        return `${month} ${day}, ${year} · ${time}`;
+    }
+
+    return `${month} ${day} · ${time}`;
+};
+
+export const formatList = (values: string[]) => {
+    if (values.length === 0) {
+        return 'n/a';
+    }
+
+    return values.join(', ');
+};
+
+export const formatPercent = (value: number, total: number) => {
+    if (total <= 0) {
+        return '0%';
+    }
+
+    return `${Math.round((value / total) * 100)}%`;
+};
+
+export const formatBooleanLabel = (value: boolean) => {
+    return value ? 'Yes' : 'No';
+};
+
+export const formatModelLabel = formatSharedModelLabel;

package/apps/ui/src/lib/grok-queries.ts

@@ -0,0 +1,22 @@
+import { queryOptions } from '@tanstack/react-query';
+import { getGrokSessionDetailFn, listGrokSessionsFn, listGrokWorkspacesFn } from './grok-server';
+
+export const grokWorkspacesQueryOptions = () =>
+    queryOptions({
+        queryFn: () => listGrokWorkspacesFn(),
+        queryKey: ['grok-workspaces'],
+    });
+
+export const grokSessionsQueryOptions = (workspaceKey: string | null) =>
+    queryOptions({
+        enabled: workspaceKey !== null,
+        queryFn: () => listGrokSessionsFn({ data: { workspaceKey: workspaceKey ?? '' } }),
+        queryKey: ['grok-sessions', workspaceKey ?? 'none'],
+    });
+
+export const grokSessionDetailQueryOptions = (sessionId: string | null) =>
+    queryOptions({
+        enabled: sessionId !== null,
+        queryFn: () => getGrokSessionDetailFn({ data: { sessionId: sessionId ?? '' } }),
+        queryKey: ['grok-session', sessionId ?? 'none'],
+    });