spiracha 1.4.0 → 2.0.0

package/apps/ui/src/routes/opencode-sessions.$sessionId.tsx

@@ -0,0 +1,334 @@
+import type { ThreadEvent, ThreadTranscriptStats } from '@spiracha/lib/codex-browser-types';
+import type { OpenCodeSessionTranscript } from '@spiracha/lib/opencode-exporter-types';
+import { useMutation, useSuspenseQuery } from '@tanstack/react-query';
+import { createFileRoute, Link } from '@tanstack/react-router';
+import { Download } from 'lucide-react';
+import { useMemo, useState } from 'react';
+import { Breadcrumbs } from '#/components/breadcrumbs';
+import { ExportDialog } from '#/components/export-dialog';
+import { JsonPanel } from '#/components/json-panel';
+import { LoadingPanel } from '#/components/loading-panel';
+import { MetadataSection } from '#/components/metadata-section';
+import { MetricCard } from '#/components/metric-card';
+import { PageHeader } from '#/components/page-header';
+import { ReloadErrorPanel } from '#/components/reload-error-panel';
+import { TranscriptView } from '#/components/transcript-view';
+import { Button } from '#/components/ui/button';
+import { Checkbox } from '#/components/ui/checkbox';
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '#/components/ui/tabs';
+import { downloadTextFile, downloadUrlFile } from '#/lib/download';
+import { formatDateTime, formatList, formatNumber, formatTokens } from '#/lib/formatters';
+import { openCodeSessionDetailQueryOptions } from '#/lib/opencode-queries';
+import { exportOpenCodeSessionFn } from '#/lib/opencode-server';
+import { getOpenCodeThreadTranscriptStats, openCodeTranscriptToThreadEvents } from '#/lib/opencode-transcript-events';
+
+type ExportDialogOptions = {
+    includeCommentary: boolean;
+    includeMetadata: boolean;
+    includeTools: boolean;
+    outputFormat: 'md' | 'txt';
+    zipArchive: boolean;
+};
+
+type TranscriptControlsProps = {
+    rawJsonDisabled?: boolean;
+    showCommentary: boolean;
+    showExtraEvents: boolean;
+    showRawJson: boolean;
+    showToolCalls: boolean;
+    showUserMessages: boolean;
+    onShowCommentaryChange: (checked: boolean) => void;
+    onShowExtraEventsChange: (checked: boolean) => void;
+    onShowRawJsonChange: (checked: boolean) => void;
+    onShowToolCallsChange: (checked: boolean) => void;
+    onShowUserMessagesChange: (checked: boolean) => void;
+};
+
+const OpenCodeSessionDetailErrorComponent = ({ error }: { error: Error }) => {
+    return <ReloadErrorPanel description={error.message} title="Failed to load OpenCode session" />;
+};
+
+const buildSessionMetadata = (detail: OpenCodeSessionTranscript) => [
+    { label: 'Session ID', value: <span data-mono="true">{detail.session.sessionId}</span> },
+    {
+        label: 'Workspace',
+        value: (
+            <Link
+                className="text-[var(--accent)]"
+                params={{ workspaceKey: detail.session.workspaceKey }}
+                to="/opencode/$workspaceKey"
+            >
+                {detail.session.workspaceLabel}
+            </Link>
+        ),
+    },
+    { label: 'Worktree', value: detail.session.worktree },
+    { label: 'Directory', value: detail.session.directory },
+    { label: 'Slug', value: detail.session.slug },
+    { label: 'Agent', value: detail.session.agent ?? 'unknown' },
+    { label: 'Model', value: detail.session.modelLabel ?? 'unknown' },
+    { label: 'Created', value: <span suppressHydrationWarning>{formatDateTime(detail.session.createdAtMs)}</span> },
+    { label: 'Updated', value: <span suppressHydrationWarning>{formatDateTime(detail.session.lastUpdatedAtMs)}</span> },
+    { label: 'Archived', value: <span suppressHydrationWarning>{formatDateTime(detail.session.archivedAtMs)}</span> },
+];
+
+const buildTranscriptStatsItems = (
+    detail: OpenCodeSessionTranscript,
+    events: ThreadEvent[],
+    stats: ThreadTranscriptStats,
+) => [
+    { label: 'Event kinds', value: formatList([...new Set(events.map((event) => event.kind))]) },
+    { label: 'Messages', value: formatNumber(stats.messageCount) },
+    { label: 'User messages', value: formatNumber(stats.userMessageCount) },
+    { label: 'Assistant messages', value: formatNumber(stats.assistantMessageCount) },
+    { label: 'Reasoning events', value: formatNumber(events.filter((event) => event.kind === 'reasoning').length) },
+    { label: 'Final answers', value: formatNumber(stats.finalAnswerCount) },
+    { label: 'Tool calls', value: formatNumber(stats.toolCallCount) },
+    { label: 'Tool outputs', value: formatNumber(stats.toolOutputCount) },
+    { label: 'Renderable parts', value: formatNumber(detail.renderablePartCount) },
+];
+
+const OpenCodeTranscriptControls = ({
+    rawJsonDisabled = false,
+    showCommentary,
+    showExtraEvents,
+    showRawJson,
+    showToolCalls,
+    showUserMessages,
+    onShowCommentaryChange,
+    onShowExtraEventsChange,
+    onShowRawJsonChange,
+    onShowToolCallsChange,
+    onShowUserMessagesChange,
+}: TranscriptControlsProps) => {
+    return (
+        <div className="flex flex-wrap gap-4 rounded-xl border border-[var(--border)] bg-[var(--panel)] px-4 py-3 shadow-[var(--panel-shadow)]">
+            <div className="flex items-center gap-2 text-sm">
+                <Checkbox
+                    checked={showToolCalls}
+                    id="opencode-transcript-show-tool-calls"
+                    onCheckedChange={(checked) => onShowToolCallsChange(checked === true)}
+                />
+                <label htmlFor="opencode-transcript-show-tool-calls">Show tool calls</label>
+            </div>
+            <div className="flex items-center gap-2 text-sm">
+                <Checkbox
+                    checked={showCommentary}
+                    id="opencode-transcript-show-commentary"
+                    onCheckedChange={(checked) => onShowCommentaryChange(checked === true)}
+                />
+                <label htmlFor="opencode-transcript-show-commentary">Show commentary</label>
+            </div>
+            <div className="flex items-center gap-2 text-sm">
+                <Checkbox
+                    checked={showExtraEvents}
+                    id="opencode-transcript-show-extra-events"
+                    onCheckedChange={(checked) => onShowExtraEventsChange(checked === true)}
+                />
+                <label htmlFor="opencode-transcript-show-extra-events">Show extra events</label>
+            </div>
+            <div className="flex items-center gap-2 text-sm">
+                <Checkbox
+                    checked={showRawJson}
+                    disabled={rawJsonDisabled}
+                    id="opencode-transcript-show-raw-json"
+                    onCheckedChange={(checked) => onShowRawJsonChange(checked === true)}
+                />
+                <label htmlFor="opencode-transcript-show-raw-json">Raw JSON</label>
+            </div>
+            <div className="flex items-center gap-2 text-sm">
+                <Checkbox
+                    checked={showUserMessages}
+                    id="opencode-transcript-show-user-messages"
+                    onCheckedChange={(checked) => onShowUserMessagesChange(checked === true)}
+                />
+                <label htmlFor="opencode-transcript-show-user-messages">User</label>
+            </div>
+        </div>
+    );
+};
+
+const OpenCodeRawPanels = ({ detail, events }: { detail: OpenCodeSessionTranscript; events: ThreadEvent[] }) => {
+    return (
+        <div className="space-y-4">
+            <JsonPanel title="Session summary" value={detail.session} />
+            <JsonPanel title="OpenCode messages" value={detail.messages} />
+            <JsonPanel title="Transcript events" value={events} />
+        </div>
+    );
+};
+
+const OpenCodeSessionDetailPage = () => {
+    const detail = useSuspenseQuery(openCodeSessionDetailQueryOptions(Route.useParams().sessionId)).data;
+    const [pendingExport, setPendingExport] = useState(false);
+    const [showToolCalls, setShowToolCalls] = useState(false);
+    const [showCommentary, setShowCommentary] = useState(false);
+    const [showExtraEvents, setShowExtraEvents] = useState(false);
+    const [showRawJson, setShowRawJson] = useState(false);
+    const [showUserMessages, setShowUserMessages] = useState(true);
+    const transcriptEvents = useMemo(() => openCodeTranscriptToThreadEvents(detail), [detail]);
+    const transcriptStats = useMemo(() => getOpenCodeThreadTranscriptStats(transcriptEvents), [transcriptEvents]);
+
+    const exportSessionMutation = useMutation({
+        mutationFn: async (options: ExportDialogOptions) => {
+            const download = await exportOpenCodeSessionFn({
+                data: {
+                    includeCommentary: options.includeCommentary,
+                    includeMetadata: options.includeMetadata,
+                    includeTools: options.includeTools,
+                    outputFormat: options.outputFormat,
+                    sessionId: detail.session.sessionId,
+                    zipArchive: options.zipArchive,
+                },
+            });
+            if (download.mode === 'download') {
+                downloadTextFile(download.fileName, download.content, download.mimeType);
+                return;
+            }
+
+            await downloadUrlFile(download.fileName, download.downloadUrl);
+        },
+        onSuccess: () => {
+            setPendingExport(false);
+        },
+    });
+
+    return (
+        <div className="space-y-6">
+            <PageHeader
+                actions={
+                    <Button
+                        className="rounded-full"
+                        type="button"
+                        variant="outline"
+                        onClick={() => setPendingExport(true)}
+                    >
+                        <Download className="mr-2 size-4" />
+                        Export
+                    </Button>
+                }
+                breadcrumb={
+                    <Breadcrumbs
+                        items={[
+                            { label: 'OpenCode', to: '/opencode' },
+                            {
+                                label: detail.session.workspaceLabel,
+                                params: { workspaceKey: detail.session.workspaceKey },
+                                to: '/opencode/$workspaceKey',
+                            },
+                            { label: detail.session.title },
+                        ]}
+                    />
+                }
+                eyebrow="OpenCode session"
+                subtitle="Session detail for the selected OpenCode project conversation."
+                title={detail.session.title}
+            />
+
+            <div className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
+                <MetricCard label="Messages" value={formatNumber(detail.session.messageCount)} />
+                <MetricCard label="Parts" value={formatNumber(detail.partCount)} />
+                <MetricCard label="Tool calls" value={formatNumber(detail.session.toolPartCount)} />
+                <MetricCard label="Tokens" value={formatTokens(detail.session.totalTokens)} />
+            </div>
+
+            <Tabs className="space-y-4" defaultValue="transcript">
+                <TabsList className="grid w-fit min-w-[24rem] grid-cols-3 rounded-full border border-[var(--border)] bg-[var(--panel)] p-1">
+                    <TabsTrigger className="rounded-full px-5 text-sm" value="transcript">
+                        Transcript
+                    </TabsTrigger>
+                    <TabsTrigger className="rounded-full px-5 text-sm" value="metadata">
+                        Metadata
+                    </TabsTrigger>
+                    <TabsTrigger className="rounded-full px-5 text-sm" value="raw">
+                        Raw
+                    </TabsTrigger>
+                </TabsList>
+
+                <TabsContent className="space-y-3" value="transcript">
+                    <OpenCodeTranscriptControls
+                        rawJsonDisabled={transcriptEvents.length === 0}
+                        showCommentary={showCommentary}
+                        showExtraEvents={showExtraEvents}
+                        showRawJson={showRawJson}
+                        showToolCalls={showToolCalls}
+                        showUserMessages={showUserMessages}
+                        onShowCommentaryChange={setShowCommentary}
+                        onShowExtraEventsChange={setShowExtraEvents}
+                        onShowRawJsonChange={setShowRawJson}
+                        onShowToolCallsChange={setShowToolCalls}
+                        onShowUserMessagesChange={setShowUserMessages}
+                    />
+                    {transcriptEvents.length > 0 ? (
+                        <TranscriptView
+                            assistantModel={detail.session.modelLabel}
+                            events={transcriptEvents}
+                            projectPath={detail.session.worktree}
+                            showCommentary={showCommentary}
+                            showExtraEvents={showExtraEvents}
+                            showRawJson={showRawJson}
+                            showToolCalls={showToolCalls}
+                            showUserMessages={showUserMessages}
+                        />
+                    ) : (
+                        <section className="rounded-[1.6rem] border border-[var(--border)] bg-[var(--panel)] p-5 shadow-[var(--panel-shadow)]">
+                            <h3 className="font-semibold text-[var(--muted-foreground)] text-sm uppercase tracking-[0.18em]">
+                                Transcript
+                            </h3>
+                            <p className="mt-4 text-[var(--muted-foreground)] text-sm">
+                                No renderable OpenCode transcript content was found for this session.
+                            </p>
+                        </section>
+                    )}
+                </TabsContent>
+
+                <TabsContent value="metadata">
+                    <div className="grid gap-4 xl:grid-cols-[0.95fr_1.05fr]">
+                        <MetadataSection items={buildSessionMetadata(detail)} title="Session metadata" />
+                        <MetadataSection
+                            items={buildTranscriptStatsItems(detail, transcriptEvents, transcriptStats)}
+                            title="Transcript stats"
+                        />
+                    </div>
+                </TabsContent>
+
+                <TabsContent value="raw">
+                    <OpenCodeRawPanels detail={detail} events={transcriptEvents} />
+                </TabsContent>
+            </Tabs>
+
+            <ExportDialog
+                errorMessage={
+                    exportSessionMutation.isError
+                        ? exportSessionMutation.error instanceof Error
+                            ? exportSessionMutation.error.message
+                            : 'Export failed'
+                        : null
+                }
+                open={pendingExport}
+                pending={exportSessionMutation.isPending}
+                title={`Export ${detail.session.title}`}
+                onExport={(options) => exportSessionMutation.mutate(options)}
+                onOpenChange={(open) => {
+                    setPendingExport(open);
+                    if (!open) {
+                        exportSessionMutation.reset();
+                    }
+                }}
+            />
+        </div>
+    );
+};
+
+export const Route = createFileRoute('/opencode-sessions/$sessionId')({
+    component: OpenCodeSessionDetailPage,
+    errorComponent: OpenCodeSessionDetailErrorComponent,
+    loader: ({ context, params }) =>
+        context.queryClient.ensureQueryData(openCodeSessionDetailQueryOptions(params.sessionId)),
+    pendingComponent: () => (
+        <LoadingPanel
+            description="Loading the OpenCode transcript, parts, and session metadata."
+            title="Loading session"
+        />
+    ),
+});

package/apps/ui/src/routes/opencode.$workspaceKey.tsx

@@ -0,0 +1,135 @@
+import type { OpenCodeSessionSummary, OpenCodeWorkspaceGroup } from '@spiracha/lib/opencode-exporter-types';
+import { useMutation, useSuspenseQuery } from '@tanstack/react-query';
+import { createFileRoute } from '@tanstack/react-router';
+import { useDeferredValue, useState } from 'react';
+import { ExportDialog } from '#/components/export-dialog';
+import { ListSearchInput } from '#/components/list-search-input';
+import { LoadingPanel } from '#/components/loading-panel';
+import { OpenCodeSessionsTable } from '#/components/opencode-sessions-table';
+import { PageHeader } from '#/components/page-header';
+import { ReloadErrorPanel } from '#/components/reload-error-panel';
+import { downloadTextFile, downloadUrlFile } from '#/lib/download';
+import { openCodeSessionsQueryOptions, openCodeWorkspacesQueryOptions } from '#/lib/opencode-queries';
+import { exportOpenCodeSessionFn } from '#/lib/opencode-server';
+import { matchesTextQuery } from '#/lib/text-filter';
+
+type ExportDialogOptions = {
+    includeCommentary: boolean;
+    includeMetadata: boolean;
+    includeTools: boolean;
+    outputFormat: 'md' | 'txt';
+    zipArchive: boolean;
+};
+
+const findWorkspaceOrThrow = (workspaces: OpenCodeWorkspaceGroup[], workspaceKey: string) => {
+    const workspace = workspaces.find((candidate) => candidate.key === workspaceKey);
+    if (!workspace) {
+        throw new Error(`OpenCode workspace not found: ${workspaceKey}`);
+    }
+
+    return workspace;
+};
+
+export const Route = createFileRoute('/opencode/$workspaceKey')({
+    component: OpenCodeWorkspacePage,
+    errorComponent: OpenCodeWorkspaceErrorComponent,
+    loader: async ({ context, params }) => {
+        const workspaces = await context.queryClient.ensureQueryData(openCodeWorkspacesQueryOptions());
+        findWorkspaceOrThrow(workspaces, params.workspaceKey);
+        await context.queryClient.ensureQueryData(openCodeSessionsQueryOptions(params.workspaceKey));
+    },
+    pendingComponent: () => (
+        <LoadingPanel description="Loading OpenCode sessions and transcript metadata." title="Loading workspace" />
+    ),
+});
+
+function OpenCodeWorkspaceErrorComponent({ error }: { error: Error }) {
+    return <ReloadErrorPanel description={error.message} title="Failed to load OpenCode workspace" />;
+}
+
+function OpenCodeWorkspacePage() {
+    const params = Route.useParams();
+    const workspaces = useSuspenseQuery(openCodeWorkspacesQueryOptions()).data;
+    const workspace = findWorkspaceOrThrow(workspaces, params.workspaceKey);
+    const sessions = useSuspenseQuery(openCodeSessionsQueryOptions(workspace.key)).data;
+    const [searchInput, setSearchInput] = useState('');
+    const [pendingExport, setPendingExport] = useState<OpenCodeSessionSummary | null>(null);
+    const deferredSearch = useDeferredValue(searchInput);
+
+    const exportMutation = useMutation({
+        mutationFn: async (options: ExportDialogOptions) => {
+            if (!pendingExport) {
+                throw new Error('No OpenCode session selected for export');
+            }
+
+            const download = await exportOpenCodeSessionFn({
+                data: {
+                    includeCommentary: options.includeCommentary,
+                    includeMetadata: options.includeMetadata,
+                    includeTools: options.includeTools,
+                    outputFormat: options.outputFormat,
+                    sessionId: pendingExport.sessionId,
+                    zipArchive: options.zipArchive,
+                },
+            });
+            if (download.mode === 'download') {
+                downloadTextFile(download.fileName, download.content, download.mimeType);
+                return;
+            }
+
+            await downloadUrlFile(download.fileName, download.downloadUrl);
+        },
+        onSuccess: () => {
+            setPendingExport(null);
+        },
+    });
+
+    const visibleSessions = sessions.filter((session) =>
+        matchesTextQuery(deferredSearch, [
+            session.title,
+            session.sessionId,
+            session.slug,
+            session.agent,
+            session.modelLabel,
+            session.directory,
+        ]),
+    );
+
+    return (
+        <div className="space-y-6">
+            <PageHeader
+                actions={
+                    <ListSearchInput
+                        placeholder="Search session title, id, model, or agent"
+                        value={searchInput}
+                        onValueChange={setSearchInput}
+                    />
+                }
+                eyebrow="OpenCode workspace"
+                subtitle="Inspect local OpenCode sessions, transcript parts, tool calls, reasoning, token totals, and exportable conversation text."
+                title={workspace.label}
+            />
+
+            <OpenCodeSessionsTable sessions={visibleSessions} onExportSession={setPendingExport} />
+
+            <ExportDialog
+                open={pendingExport !== null}
+                pending={exportMutation.isPending}
+                title={pendingExport ? `Export ${pendingExport.title}` : 'Export session'}
+                onExport={(options) => exportMutation.mutate(options)}
+                onOpenChange={(open) => {
+                    if (!open) {
+                        setPendingExport(null);
+                        exportMutation.reset();
+                    }
+                }}
+            />
+
+            {exportMutation.isError ? (
+                <p className="text-[var(--destructive)] text-sm">
+                    {exportMutation.error instanceof Error ? exportMutation.error.message : 'Session export failed'}
+                </p>
+            ) : null}
+        </div>
+    );
+}

package/apps/ui/src/routes/opencode.index.tsx

@@ -0,0 +1,48 @@
+import { useSuspenseQuery } from '@tanstack/react-query';
+import { createFileRoute } from '@tanstack/react-router';
+import { useDeferredValue, useState } from 'react';
+import { ListSearchInput } from '#/components/list-search-input';
+import { OpenCodeWorkspacesTable } from '#/components/opencode-workspaces-table';
+import { PageHeader } from '#/components/page-header';
+import { ReloadErrorPanel } from '#/components/reload-error-panel';
+import { openCodeWorkspacesQueryOptions } from '#/lib/opencode-queries';
+import { matchesTextQuery } from '#/lib/text-filter';
+
+const OpenCodeErrorComponent = ({ error }: { error: Error }) => {
+    return <ReloadErrorPanel description={error.message} title="Failed to load OpenCode workspaces" />;
+};
+
+const OpenCodePage = () => {
+    const workspaces = useSuspenseQuery(openCodeWorkspacesQueryOptions()).data;
+    const [searchInput, setSearchInput] = useState('');
+    const deferredSearch = useDeferredValue(searchInput);
+
+    const visibleWorkspaces = workspaces.filter((workspace) =>
+        matchesTextQuery(deferredSearch, [workspace.label, workspace.worktree, workspace.key, workspace.projectId]),
+    );
+
+    return (
+        <div className="space-y-6">
+            <PageHeader
+                actions={
+                    <ListSearchInput
+                        placeholder="Search workspace name or path"
+                        value={searchInput}
+                        onValueChange={setSearchInput}
+                    />
+                }
+                eyebrow="Inventory"
+                subtitle="Workspace groups are derived from the local OpenCode project, session, message, and part tables."
+                title="OpenCode"
+            />
+
+            <OpenCodeWorkspacesTable workspaces={visibleWorkspaces} />
+        </div>
+    );
+};
+
+export const Route = createFileRoute('/opencode/')({
+    component: OpenCodePage,
+    errorComponent: OpenCodeErrorComponent,
+    loader: ({ context }) => context.queryClient.ensureQueryData(openCodeWorkspacesQueryOptions()),
+});