AI Response Stream

1"use client";
2 
3import * as React from "react";
4import { motion, AnimatePresence } from "motion/react";
5 
6import { cn } from "@/lib/utils";
7import { useReducedMotion } from "@/lib/motiq";
8 
9/**
10 * AiResponseStream — renders a streaming assistant response supplied by the
11 * parent application (text, fenced code, inline citations, and lifecycle
12 * state). It is a *presentation* component: it never talks to a model, never
13 * fabricates tokens, and makes no claim about what an AI is "doing" — the app
14 * owns the stream and passes the segments + state in.
15 *
16 * Accessibility: the rendered content is real, readable text (not aria-hidden),
17 * so once the response is complete a screen reader reads the whole thing in one
18 * pass. A separate polite `role="status"` region announces lifecycle changes
19 * (responding / complete / stopped / failed) — never token-by-token, so the
20 * live region is not spammed. State is conveyed with icon + label + border, not
21 * colour alone, so it survives forced-colors. Stop / Retry / Copy are real
22 * <button>s with accessible names and focus-visible rings. Under
23 * `prefers-reduced-motion` there is no per-token motion and no caret: content
24 * appears immediately. Clean-room original.
25 */
26 
27export type StreamState = "streaming" | "stopped" | "complete" | "error";
28 
29/** A source referenced by inline `[n]` citation markers. */
30export interface StreamSource {
31  /** Stable id referenced by a `citation` segment's `sourceId` (e.g. "1"). */
32  id: string;
33  /** Human-readable title shown in the sources rail. */
34  title: string;
35  /** Optional external URL. Rendered as a real link when present. */
36  url?: string;
37  /** Optional one-line context shown under the title. */
38  snippet?: string;
39}
40 
41/** Ordered content the parent streams in. Text may contain blank-line paragraph breaks. */
42export type ResponseSegment =
43  | { type: "text"; text: string }
44  | { type: "code"; code: string; lang?: string; filename?: string }
45  | { type: "citation"; sourceId: string };
46 
47export interface AiResponseStreamProps {
48  /** Ordered response segments supplied by the application. */
49  segments: ResponseSegment[];
50  /** Lifecycle state, owned by the application. */
51  state: StreamState;
52  /** Sources referenced by inline citations; rendered as a numbered rail. */
53  sources?: StreamSource[];
54  /** Label shown in the header (e.g. the assistant/model display name). */
55  assistantName?: string;
56  /** Message shown in the error banner when `state === "error"`. */
57// … truncated