@startsimpli/ui 0.4.43 → 0.4.46

package/src/components/index.ts

@@ -60,6 +60,18 @@ export * from './workspace'
 // Chat surface primitives (ChatThread, ChatMessage, ChatComposer)
 export * from './chat'
 
+// Terminal (xterm.js) — generic presentational terminal + skeleton + themes
+// (startsim-768w.16.7.E). Import styles from '@startsimpli/ui/terminal/styles'.
+export * from './terminal'
+
+// Diff viewer — presentational unified-diff renderer (no fetching)
+export * from './diff'
+
+// Agent-session surfaces (startsim-768w.16.7.E): SessionCard/List/StatusBadge,
+// ConversationTimeline, and the live AgentSessionConsole (driven by
+// @startsimpli/realtime/react). All generic — decoupled from any app model.
+export * from './session'
+
 // Slide-deck viewer (Google-Slides-style canvas + filmstrip)
 export * from './slide-deck'
 
@@ -147,3 +159,6 @@ export type {
   ActivityTypeOption,
   OutcomeOption,
 } from './LogActivityDialog'
+
+// Record detail read-view
+export * from './record-detail'

package/src/components/record-detail/RecordDetail.tsx

@@ -0,0 +1,92 @@
+'use client'
+
+import * as React from 'react'
+import { cn } from '../../lib/utils'
+
+export type RecordFieldKind = 'text' | 'longtext' | 'url' | 'boolean' | 'json'
+
+export interface RecordField {
+  label: string
+  value: string
+  kind?: RecordFieldKind
+}
+
+export interface RecordDetailProps {
+  fields: RecordField[]
+  emptyMessage?: string
+  className?: string
+}
+
+const URL_RE = /^https?:\/\//i
+
+/**
+ * Read-optimized view of a record's fields (startsim-768w.17.4). Renders short
+ * fields as a compact label/value list (auto-linking urls), long-text fields as
+ * readable, newline-preserving prose blocks (right for extracted article bodies),
+ * and json as a scrollable code block. Generic: a consumer maps its own schema to
+ * `fields` and this owns the layout, so every Foundry tenant's detail drawer reads
+ * the same without duplicating the view.
+ */
+export function RecordDetail({ fields, emptyMessage = 'No details.', className }: RecordDetailProps) {
+  const present = fields.filter((f) => f.value != null && String(f.value).trim() !== '')
+  const shorts = present.filter((f) => f.kind !== 'longtext' && f.kind !== 'json')
+  const longs = present.filter((f) => f.kind === 'longtext')
+  const jsons = present.filter((f) => f.kind === 'json')
+
+  if (present.length === 0) {
+    return <p className={cn('text-sm text-muted-foreground', className)}>{emptyMessage}</p>
+  }
+
+  return (
+    <div className={cn('space-y-4', className)}>
+      {shorts.length > 0 && (
+        <dl className="space-y-1.5">
+          {shorts.map((f, i) => {
+            const isUrl = f.kind === 'url' || URL_RE.test(f.value)
+            return (
+              <div key={i} className="flex gap-2 text-sm">
+                <dt className="w-28 shrink-0 capitalize text-muted-foreground">{f.label}</dt>
+                <dd className="min-w-0 flex-1 break-words">
+                  {isUrl ? (
+                    <a
+                      href={f.value}
+                      target="_blank"
+                      rel="noopener noreferrer"
+                      className="break-all text-primary underline underline-offset-2 hover:no-underline"
+                    >
+                      {f.value}
+                    </a>
+                  ) : (
+                    f.value
+                  )}
+                </dd>
+              </div>
+            )
+          })}
+        </dl>
+      )}
+
+      {longs.map((f, i) => (
+        <section key={i} className="space-y-1.5">
+          <h4 className="text-xs font-medium uppercase tracking-wide text-muted-foreground">
+            {f.label}
+          </h4>
+          <div className="whitespace-pre-wrap text-sm leading-relaxed text-foreground">
+            {f.value}
+          </div>
+        </section>
+      ))}
+
+      {jsons.map((f, i) => (
+        <section key={i} className="space-y-1.5">
+          <h4 className="text-xs font-medium uppercase tracking-wide text-muted-foreground">
+            {f.label}
+          </h4>
+          <pre className="overflow-x-auto rounded-md bg-muted p-3 text-xs leading-relaxed">
+            {f.value}
+          </pre>
+        </section>
+      ))}
+    </div>
+  )
+}

package/src/components/record-detail/__tests__/record-detail.test.tsx

@@ -0,0 +1,42 @@
+import { render, screen } from '@testing-library/react'
+import { RecordDetail, type RecordField } from '../RecordDetail'
+
+const fields: RecordField[] = [
+  { label: 'url', value: 'https://example.com/a', kind: 'url' },
+  { label: 'source', value: 'The National', kind: 'text' },
+  { label: 'content', value: 'Para one.\nPara two.', kind: 'longtext' },
+  { label: 'empty', value: '', kind: 'text' },
+]
+
+describe('RecordDetail', () => {
+  it('renders a url field as a new-tab clickable link', () => {
+    render(<RecordDetail fields={fields} />)
+    const link = screen.getByRole('link', { name: 'https://example.com/a' })
+    expect(link).toHaveAttribute('href', 'https://example.com/a')
+    expect(link).toHaveAttribute('target', '_blank')
+    expect(link).toHaveAttribute('rel', expect.stringContaining('noopener'))
+  })
+
+  it('renders long-text as a newline-preserving prose block', () => {
+    const { container } = render(<RecordDetail fields={fields} />)
+    const prose = container.querySelector('.whitespace-pre-wrap')
+    expect(prose).toBeInTheDocument()
+    expect(prose?.textContent).toContain('Para one.')
+    expect(prose?.textContent).toContain('Para two.')
+  })
+
+  it('skips empty fields', () => {
+    render(<RecordDetail fields={fields} />)
+    expect(screen.queryByText('empty')).not.toBeInTheDocument()
+  })
+
+  it('auto-links a text field whose value looks like a url', () => {
+    render(<RecordDetail fields={[{ label: 'link', value: 'https://x.io', kind: 'text' }]} />)
+    expect(screen.getByRole('link', { name: 'https://x.io' })).toBeInTheDocument()
+  })
+
+  it('shows the empty message when no field has a value', () => {
+    render(<RecordDetail fields={[{ label: 'a', value: '' }]} emptyMessage="Nothing here" />)
+    expect(screen.getByText('Nothing here')).toBeInTheDocument()
+  })
+})

package/src/components/record-detail/index.ts

@@ -0,0 +1,2 @@
+export { RecordDetail } from './RecordDetail'
+export type { RecordDetailProps, RecordField, RecordFieldKind } from './RecordDetail'

package/src/components/session/AgentSessionConsole.tsx

@@ -0,0 +1,200 @@
+'use client'
+
+import * as React from 'react'
+import { useAgentSession } from '@startsimpli/realtime/react'
+import type { AgentLifecycleMsg } from '@startsimpli/realtime'
+import { cn } from '../../lib/utils'
+import { Terminal, type TerminalHandle } from '../terminal/Terminal'
+import type { ChatMessageData } from '../chat/types'
+import { ConversationTimeline } from './ConversationTimeline'
+import { DiffViewer } from '../diff/DiffViewer'
+import { mapSocketStatus } from './status'
+
+export interface AgentSessionConsoleProps {
+  /** WebSocket URL for the agent session (ws(s)://…). */
+  url: string
+  /** Auth token appended by the socket (string or getter re-read on reconnect). */
+  token?: string | (() => string | null | undefined)
+  /** A raw unified diff to show in the Diff tab (the parent fetches it). */
+  diff?: string
+  /** Load/refresh the diff (wired to the Diff tab's refresh button). */
+  onLoadDiff?: () => void
+  diffLoading?: boolean
+  diffError?: string | null
+  /** Ref/branch the diff is against (shown in the diff header). */
+  diffBaseRef?: string
+  title?: string
+  className?: string
+}
+
+type Tab = 'session' | 'diff'
+
+/** Turn a structured lifecycle event into a timeline row. Generic — no app knowledge. */
+export function lifecycleToMessage(msg: AgentLifecycleMsg): ChatMessageData {
+  const data = msg.data as { message?: string; tool?: string } | undefined
+  const looksLikeTool = /tool|command|exec|edit|write|read|bash/i.test(msg.event)
+  const content = data?.message ?? msg.event.replace(/[_-]/g, ' ')
+  return {
+    id: `lifecycle-${msg.ts ?? Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    role: looksLikeTool ? 'tool' : 'system',
+    kind: looksLikeTool ? 'tool' : 'status',
+    toolName: looksLikeTool ? (data?.tool ?? msg.event) : undefined,
+    content,
+    timestamp: msg.ts,
+  }
+}
+
+/**
+ * The live agent-session surface: a status header + a `<Terminal>` and
+ * `<ConversationTimeline>` side by side (with a `<DiffViewer>` in a tab). It is
+ * driven by `useAgentSession` from `@startsimpli/realtime/react`:
+ *   - inbound output is pumped into the terminal imperatively (no re-render/byte),
+ *   - keystrokes/resizes are forwarded to `session.send`/`session.resize`,
+ *   - lifecycle events accumulate into the conversation timeline,
+ *   - the composer steers the agent via `session.send`.
+ *
+ * Fully generic — no Foundry/app types. The parent supplies the URL, token, and
+ * (optionally) a diff.
+ */
+export function AgentSessionConsole({
+  url,
+  token,
+  diff,
+  onLoadDiff,
+  diffLoading,
+  diffError,
+  diffBaseRef,
+  title,
+  className,
+}: AgentSessionConsoleProps) {
+  const termHandleRef = React.useRef<TerminalHandle | null>(null)
+  const [tab, setTab] = React.useState<Tab>('session')
+  const [entries, setEntries] = React.useState<ChatMessageData[]>([])
+
+  const session = useAgentSession({
+    url,
+    token,
+    onOutput: (d) => termHandleRef.current?.write(d),
+    onLifecycle: (m) => setEntries((prev) => [...prev, lifecycleToMessage(m)]),
+  })
+
+  const { status, lastEvent, send, resize, socket } = session
+
+  // An error event trumps the socket status for the terminal indicator.
+  const isError = lastEvent?.type === 'error'
+  const terminalStatus = isError ? 'error' : mapSocketStatus(status)
+
+  const exited = lastEvent?.type === 'exited' ? lastEvent : null
+
+  const handleSend = React.useCallback(
+    (text: string) => {
+      send(text)
+      setEntries((prev) => [
+        ...prev,
+        { id: `user-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`, role: 'user', content: text },
+      ])
+    },
+    [send],
+  )
+
+  const reconnect = React.useCallback(() => socket?.connect(), [socket])
+
+  const statusLabel = exited
+    ? `Exited (code ${exited.exitCode})`
+    : isError
+      ? 'Error'
+      : status === 'open'
+        ? 'Connected'
+        : status === 'connecting'
+          ? 'Connecting…'
+          : status === 'reconnecting'
+            ? 'Reconnecting…'
+            : 'Disconnected'
+
+  return (
+    <div className={cn('flex h-full flex-col overflow-hidden rounded-lg border border-border bg-card', className)}>
+      {/* Status header + tabs */}
+      <div className="flex flex-shrink-0 flex-wrap items-center justify-between gap-2 border-b border-border px-4 py-2">
+        <div className="flex items-center gap-3">
+          {title && <span className="text-sm font-semibold text-foreground">{title}</span>}
+          <span
+            data-testid="agent-session-status"
+            className={cn(
+              'inline-flex items-center gap-1.5 rounded-full px-2.5 py-0.5 text-xs font-medium',
+              terminalStatus === 'connected' && 'bg-emerald-500/15 text-emerald-600 dark:text-emerald-400',
+              terminalStatus === 'connecting' && 'bg-muted text-muted-foreground',
+              terminalStatus === 'error' && 'bg-red-500/15 text-red-600 dark:text-red-400',
+              terminalStatus === 'disconnected' && 'bg-muted text-muted-foreground',
+            )}
+          >
+            <span className="h-1.5 w-1.5 rounded-full bg-current" />
+            {statusLabel}
+          </span>
+        </div>
+        <div className="flex items-center gap-1 rounded-lg bg-muted p-0.5" role="tablist">
+          <button
+            type="button"
+            role="tab"
+            aria-selected={tab === 'session'}
+            onClick={() => setTab('session')}
+            className={cn(
+              'rounded-md px-3 py-1 text-xs font-medium transition-colors',
+              tab === 'session' ? 'bg-card text-foreground shadow-sm' : 'text-muted-foreground hover:text-foreground',
+            )}
+          >
+            Session
+          </button>
+          <button
+            type="button"
+            role="tab"
+            aria-selected={tab === 'diff'}
+            onClick={() => setTab('diff')}
+            className={cn(
+              'rounded-md px-3 py-1 text-xs font-medium transition-colors',
+              tab === 'diff' ? 'bg-card text-foreground shadow-sm' : 'text-muted-foreground hover:text-foreground',
+            )}
+          >
+            Diff
+          </button>
+        </div>
+      </div>
+
+      <div className="relative min-h-0 flex-1">
+        {/* Session tab: Terminal | Conversation split. Terminal stays MOUNTED
+            across tab switches (via `hidden`) so xterm is never re-initialised. */}
+        <div className={cn('grid h-full grid-cols-1 gap-3 p-3 lg:grid-cols-2', tab !== 'session' && 'hidden')}>
+          <Terminal
+            onReady={(h) => {
+              termHandleRef.current = h
+            }}
+            onData={send}
+            onResize={resize}
+            status={terminalStatus}
+            onReconnect={reconnect}
+            className="min-h-[320px]"
+          />
+          <ConversationTimeline
+            entries={entries}
+            title="Conversation"
+            statusLabel={statusLabel}
+            onSend={handleSend}
+            emptyState={<span className="text-sm text-muted-foreground">Steer the agent by sending a message.</span>}
+            className="min-h-[320px]"
+          />
+        </div>
+
+        {/* Diff tab */}
+        <div className={cn('h-full p-3', tab !== 'diff' && 'hidden')}>
+          <DiffViewer
+            diff={diff ?? ''}
+            baseRef={diffBaseRef}
+            isLoading={diffLoading}
+            error={diffError}
+            onRefresh={onLoadDiff}
+            className="h-full rounded-lg border border-border"
+          />
+        </div>
+      </div>
+    </div>
+  )
+}

package/src/components/session/ConversationTimeline.tsx

@@ -0,0 +1,131 @@
+'use client'
+
+import * as React from 'react'
+import { cn } from '../../lib/utils'
+import { ChatThread } from '../chat/ChatThread'
+import { ChatComposer } from '../chat/ChatComposer'
+import type { ChatMessageData } from '../chat/types'
+
+export interface ConversationTimelineProps {
+  /** The agent-shaped timeline entries (already chat-shaped: status/kind/toolName). */
+  entries: ChatMessageData[]
+  /** Header title. */
+  title?: string
+  /** 0..100 progress bar shown under the header (omit to hide). */
+  progressPercent?: number
+  /** Short status label shown in the header. */
+  statusLabel?: string
+  /** Called with the composed message text. Sending state is tracked internally. */
+  onSend?: (text: string) => void | Promise<void>
+  /** The agent is working / entries are loading — shows the working indicator. */
+  isLoading?: boolean
+  /** Load older entries (renders a "Load more" control when `hasMore`). */
+  onLoadMore?: () => void
+  hasMore?: boolean
+  composerPlaceholder?: string
+  /** Rendered when there are no entries. */
+  emptyState?: React.ReactNode
+  /** Custom message-body renderer passed through to ChatThread (e.g. markdown). */
+  renderContent?: (content: string, message: ChatMessageData) => React.ReactNode
+  className?: string
+}
+
+/**
+ * The "steer the agent" surface: a scrolling timeline of agent events plus a
+ * composer that sends a message back to the agent. Built on the existing
+ * ChatThread / ChatComposer, so it inherits their auto-scroll, streaming
+ * indicators, tool/status rows, and keyboard handling. Fully generic — it takes
+ * `ChatMessageData[]` and an `onSend` callback; it knows nothing about the
+ * transport or any app model.
+ */
+export function ConversationTimeline({
+  entries,
+  title,
+  progressPercent,
+  statusLabel,
+  onSend,
+  isLoading = false,
+  onLoadMore,
+  hasMore = false,
+  composerPlaceholder = 'Message the agent…',
+  emptyState,
+  renderContent,
+  className,
+}: ConversationTimelineProps) {
+  const [sending, setSending] = React.useState(false)
+
+  const handleSubmit = React.useCallback(
+    (text: string) => {
+      if (!onSend) return
+      const result = onSend(text)
+      if (result && typeof (result as Promise<void>).then === 'function') {
+        setSending(true)
+        void (result as Promise<void>).finally(() => setSending(false))
+      }
+    },
+    [onSend],
+  )
+
+  const showHeader = !!title || !!statusLabel || progressPercent != null
+
+  return (
+    <div className={cn('flex h-full flex-col overflow-hidden rounded-lg border border-border bg-card', className)}>
+      {showHeader && (
+        <div className="flex-shrink-0 border-b border-border px-4 py-3">
+          <div className="flex items-center justify-between gap-2">
+            {title && <h3 className="truncate text-sm font-semibold text-foreground">{title}</h3>}
+            {statusLabel && <span className="text-xs text-muted-foreground">{statusLabel}</span>}
+          </div>
+          {progressPercent != null && (
+            <div className="mt-2">
+              <div className="mb-1 flex items-center justify-between text-xs text-muted-foreground">
+                <span>Progress</span>
+                <span>{Math.round(progressPercent)}%</span>
+              </div>
+              <div className="h-2 overflow-hidden rounded-full bg-muted">
+                <div
+                  className="h-full rounded-full bg-primary transition-[width] duration-500"
+                  style={{ width: `${Math.max(0, Math.min(100, progressPercent))}%` }}
+                  role="progressbar"
+                  aria-valuemin={0}
+                  aria-valuemax={100}
+                  aria-valuenow={Math.round(progressPercent)}
+                />
+              </div>
+            </div>
+          )}
+        </div>
+      )}
+
+      <div className="flex min-h-0 flex-1 flex-col">
+        {hasMore && onLoadMore && (
+          <div className="flex-shrink-0 border-b border-border p-2 text-center">
+            <button
+              type="button"
+              onClick={onLoadMore}
+              className="text-xs text-primary transition-colors hover:underline"
+            >
+              Load earlier messages
+            </button>
+          </div>
+        )}
+        <ChatThread
+          messages={entries}
+          busy={isLoading}
+          emptyState={emptyState}
+          renderContent={renderContent}
+          className="flex-1"
+        />
+      </div>
+
+      {onSend && (
+        <ChatComposer
+          onSubmit={handleSubmit}
+          placeholder={composerPlaceholder}
+          busy={sending}
+          className="flex-shrink-0"
+        />
+      )}
+    </div>
+  )
+}