rift-ds 1.7.0 → 1.8.0

package/chat/demo-cards.js

@@ -0,0 +1,59 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { AgentPlan } from "../components/AgentPlan/AgentPlan.js";
+import { Button } from "../components/Button/Button.js";
+import { CodeDiff } from "../components/CodeDiff/CodeDiff.js";
+import { MessageCard } from "../components/MessageCard/MessageCard.js";
+import { SourceChip } from "../components/SourceChip/SourceChip.js";
+import { DemoStack, DemoInterrupt, DemoToolCall, DemoChart } from "./demo-card-components.js";
+import "./demo.css";
+const TONES = ["one", "two", "three"];
+const DEMO_RENDERERS = {
+  "product-card": (data) => {
+    const card = data;
+    return /* @__PURE__ */ jsx(
+      MessageCard,
+      {
+        media: /* @__PURE__ */ jsx("div", { className: "ds-chat-demo__card-media", "aria-hidden": "true" }),
+        title: card.title,
+        description: card.description,
+        meta: card.meta,
+        actions: card.actions?.map((action) => /* @__PURE__ */ jsx(Button, { label: action.label, variant: action.variant, size: "compact" }, action.label))
+      }
+    );
+  },
+  chart: (data) => /* @__PURE__ */ jsx(DemoChart, { card: data }),
+  sources: (data) => {
+    const card = data;
+    return /* @__PURE__ */ jsx("div", { className: "ds-chat-demo__source-row", children: card.items.map((item, index) => /* @__PURE__ */ jsx(
+      SourceChip,
+      {
+        title: item.title,
+        index: item.index,
+        logo: item.letter ? /* @__PURE__ */ jsx(
+          "span",
+          {
+            className: `ds-chat-demo__logo ds-chat-demo__logo--${TONES[index % TONES.length]}`,
+            "aria-hidden": "true",
+            children: item.letter
+          }
+        ) : void 0,
+        source: item.source,
+        meta: item.meta,
+        excerpt: item.excerpt
+      },
+      item.title
+    )) });
+  },
+  "tool-call": (data) => /* @__PURE__ */ jsx(DemoToolCall, { card: data }),
+  diff: (data) => {
+    const card = data;
+    return /* @__PURE__ */ jsx(CodeDiff, { diff: card.diff, filename: card.filename });
+  },
+  plan: (data) => /* @__PURE__ */ jsx(AgentPlan, { steps: data.steps }),
+  interrupt: (data) => /* @__PURE__ */ jsx(DemoInterrupt, { card: data }),
+  stack: (data) => /* @__PURE__ */ jsx(DemoStack, { card: data, renderers: DEMO_RENDERERS })
+};
+export {
+  DEMO_RENDERERS
+};

package/chat/demo-fixtures.d.ts

@@ -0,0 +1,20 @@
+import { MentionSource } from '../components/Mention/Mention';
+import { ModelPickerModel } from '../components/ModelPicker/ModelPicker';
+import { ThreadPanelGroup, ThreadPanelProject } from '../components/ThreadPanel/ThreadPanel';
+import { ThreadsOptions } from './threads';
+/** `@` reaches for a person or a file, `/` for a skill. */
+export declare const DEMO_MENTIONS: MentionSource[];
+/** A mock model list for the picker: set dressing, nothing routes on it. */
+export declare const DEMO_MODELS: ModelPickerModel[];
+export declare const DEMO_THREAD_GROUPS: ThreadPanelGroup[];
+export declare const DEMO_PROJECTS: ThreadPanelProject[];
+/** The names the demo's "title generation" hands out, in order. */
+export declare const DEMO_THREAD_NAMES: string[];
+/** Ready-made options for `ChatProvider`'s `threads`. */
+export declare const DEMO_THREADS: ThreadsOptions;
+/** What sits under the composer on the demo's welcome screen. */
+export type DemoWelcomeVariant = 'starters' | 'links' | 'cards' | 'dashboard' | 'none';
+export declare const DEMO_WELCOME_OPTIONS: {
+    value: DemoWelcomeVariant;
+    label: string;
+}[];

package/chat/demo-fixtures.js

@@ -0,0 +1,113 @@
+const DEMO_MENTIONS = [
+  {
+    trigger: "@",
+    label: "People and files",
+    items: [
+      { id: "mira", label: "Mira Castellan", description: "Design lead", icon: "person" },
+      { id: "tobias", label: "Tobias Renner", description: "Platform", icon: "person" },
+      { id: "ines", label: "Ines Okonjo", description: "Research", icon: "person" },
+      { id: "roadmap", label: "roadmap.md", description: "Docs", icon: "description" },
+      { id: "pricing", label: "pricing.csv", description: "Finance", icon: "description" },
+      { id: "onboarding", label: "onboarding.pdf", description: "Docs", icon: "description" }
+    ]
+  },
+  {
+    trigger: "/",
+    label: "Skills",
+    items: [
+      { id: "summarize", label: "summarize", description: "The thread so far, in brief" },
+      { id: "draft", label: "draft", description: "Write a first version" },
+      { id: "review", label: "review", description: "Read it for problems" },
+      { id: "translate", label: "translate", description: "Into another language" },
+      { id: "schedule", label: "schedule", description: "Run this later" },
+      { id: "invite", label: "invite", description: "Add a teammate to the workspace" },
+      { id: "export", label: "export", description: "Save the thread as a file" },
+      { id: "status", label: "status", description: "Where things stand" },
+      { id: "share", label: "share", description: "Send a link to this thread" },
+      { id: "search", label: "search", description: "Look across the workspace" }
+    ]
+  }
+];
+const DEMO_MODELS = [
+  { label: "Sonnet 5", value: "sonnet-5", description: "Fast and capable, the everyday pick.", badge: "New" },
+  { label: "Fable 5", value: "fable-5", description: "The deepest reasoning for hard questions." },
+  { label: "Haiku 4.5", value: "haiku-4-5", description: "Instant answers for quick lookups." }
+];
+const DEMO_THREAD_GROUPS = [
+  {
+    label: "Pinned",
+    threads: [
+      {
+        id: "pricing",
+        title: "Compare the plan limits",
+        description: "Annual pricing options",
+        status: "idle",
+        pinned: true,
+        meta: "2d"
+      }
+    ]
+  },
+  {
+    label: "This week",
+    threads: [
+      {
+        id: "launch",
+        title: "Plan the launch week",
+        description: "Waiting on the beta invite list",
+        status: "waiting",
+        icon: "cloud",
+        meta: "32m"
+      },
+      {
+        id: "onboarding",
+        title: "Rework the onboarding email",
+        description: "Drafting the welcome sequence",
+        status: "working",
+        icon: "cloud",
+        meta: "2h"
+      }
+    ]
+  },
+  {
+    label: "Earlier",
+    threads: [
+      { id: "import", title: "Import last year's invoices", meta: "4d" },
+      { id: "roles", title: "Set up roles for the team", status: "error", meta: "5d" },
+      { id: "notify", title: "Quiet the mention notifications", status: "unread", meta: "1w" }
+    ]
+  }
+];
+const DEMO_PROJECTS = [
+  { id: "workspace-revamp", label: "Workspace revamp", meta: "1m" },
+  { id: "billing-cleanup", label: "Billing cleanup", meta: "3d" }
+];
+const DEMO_THREAD_NAMES = [
+  "Plan the beta invite list",
+  "Summarize the weekly standup",
+  "Draft the pricing FAQ",
+  "Tidy up the workspace roles",
+  "Sketch the renewal email"
+];
+const DEMO_THREADS = {
+  groups: DEMO_THREAD_GROUPS,
+  projects: DEMO_PROJECTS,
+  pinnedGroup: "Pinned",
+  homeGroup: "This week",
+  nameThread: (index) => DEMO_THREAD_NAMES[index % DEMO_THREAD_NAMES.length]
+};
+const DEMO_WELCOME_OPTIONS = [
+  { value: "starters", label: "Starters" },
+  { value: "links", label: "Links" },
+  { value: "cards", label: "Cards" },
+  { value: "dashboard", label: "Dashboard" },
+  { value: "none", label: "None" }
+];
+export {
+  DEMO_MENTIONS,
+  DEMO_MODELS,
+  DEMO_PROJECTS,
+  DEMO_THREADS,
+  DEMO_THREAD_GROUPS,
+  DEMO_THREAD_NAMES,
+  DEMO_WELCOME_OPTIONS
+};

package/chat/demo-script.d.ts

@@ -0,0 +1,6 @@
+import { ChatScript } from './sim';
+import { Starter } from './types';
+/** The three starters the demo welcome screen offers. */
+export declare const DEMO_STARTERS: Starter[];
+/** The scripted conversation, for `createSimTransport` or inspection. */
+export declare const DEMO_SCRIPT: ChatScript;

package/chat/demo-script.js

@@ -0,0 +1,215 @@
+import { scriptChat } from "./sim.js";
+const TRIAL_SIGNUPS = [
+  { week: "W1", signups: 320 },
+  { week: "W2", signups: 410 },
+  { week: "W3", signups: 380 },
+  { week: "W4", signups: 520 },
+  { week: "W5", signups: 610 },
+  { week: "W6", signups: 720 }
+];
+const LAUNCH_BUDGET = [
+  { phase: "Beta", spend: 12 },
+  { phase: "Launch week", spend: 34 },
+  { phase: "Follow-up", spend: 18 }
+];
+const PLAN_STEPS = [
+  { label: "Check the workspace quota", status: "completed" },
+  { label: "Create the shared project", status: "completed", detail: "acme-design / launch" },
+  { label: "Invite the three teammates", status: "active" },
+  { label: "Post the welcome note", status: "pending" }
+];
+const card = (kind, data) => ({ kind, data });
+const DEMO_STARTERS = [
+  { id: "start", label: "How do I get started?" },
+  { id: "plans", label: "What do the plans include?" },
+  { id: "invite", label: "Invite my team to a workspace" }
+];
+const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
+  "Create a workspace from the dashboard, then invite your team from Settings. Everyone you add sees the shared projects the moment they join. If you would rather not click through it, I can set the whole thing up for you.",
+  {
+    steps: [
+      { status: "Reading the first-run flow", point: "The question maps to the first-run flow." },
+      { status: "Drafting the answer", point: "Lead with the workspace, then the invite step." }
+    ],
+    followups: ["Set it all up for me", "What do the plans include?", "How is the trial going?"]
+  }
+).user("Set it all up for me").assistant("On it. Two steps are done already, and the invites are going out now.", {
+  steps: [
+    { status: "Planning the setup", point: "Four steps, from quota check to welcome note." },
+    { status: "Creating the workspace", point: "The shared project comes first." }
+  ],
+  card: card("plan", { steps: PLAN_STEPS }),
+  followups: ["Find a time we can all meet", "Take us up to twelve seats", "How is the trial going?"]
+}).user("What do the plans include?").assistant(
+  "Every plan includes unlimited projects. The Team plan adds shared workspaces, guest seats, and a 90 day version history.",
+  {
+    steps: [
+      { status: "Comparing the plans", point: "Three plans differ on collaboration, not on limits." },
+      { status: "Drafting the answer", point: "Name what the Team plan adds over the base." }
+    ],
+    followups: ["Which plan fits a team of five?", "Where is that written down?", "How is the trial going?"]
+  }
+).user("Which plan fits a team of five?").assistant("The Team plan fits what you described: shared workspaces for the whole team, and guest seats stay free.", {
+  steps: [
+    { status: "Matching plans to the team", point: "The visitor needs shared workspaces and guest seats." },
+    { status: "Drafting the answer", point: "The Team plan covers both; lead with the card." }
+  ],
+  card: card("product-card", {
+    title: "Team plan",
+    description: "Shared workspaces, guest seats, and version history for the whole team.",
+    meta: "Billed monthly, cancel any time",
+    actions: [
+      { label: "Choose plan", variant: "secondary" },
+      { label: "Compare plans", variant: "tertiary" }
+    ]
+  }),
+  followups: ["Where is that written down?", "Invite my team to a workspace", "How is the trial going?"]
+}).user("Where is that written down?").assistant("Each chip opens the page the answer came from, so nothing here needs taking on trust.", {
+  steps: [
+    { status: "Collecting the sources", point: "Three product pages back the answer." },
+    { status: "Drafting the answer", point: "Cite them so the visitor can check." }
+  ],
+  card: card("sources", {
+    items: [
+      {
+        title: "Pricing guide",
+        index: 1,
+        letter: "A",
+        source: "acme.design/pricing",
+        meta: "Updated 3 days ago",
+        excerpt: "Team is billed per editor, monthly or yearly. Viewers are free on every plan, and a seat you remove mid-cycle comes back as credit on the next invoice."
+      },
+      {
+        title: "Workspace docs",
+        index: 2,
+        letter: "D",
+        source: "docs.acme.design",
+        excerpt: "An editor can create and change files in any project they are invited to. Seats belong to the workspace, not to a project, so moving someone between teams costs nothing."
+      },
+      {
+        title: "Fair use policy",
+        source: "acme.design/legal",
+        meta: "4 min read",
+        excerpt: "Unlimited means no hard cap on files or version history. Automated bulk uploads above the published rate are queued, never dropped."
+      }
+    ]
+  }),
+  followups: ["Which plan fits a team of five?", "How do I get started?", "How is the trial going?"]
+}).user("How is the trial going?").assistant("Signups have climbed for five of the six weeks since the trial opened, and last week was the strongest yet.", {
+  steps: [
+    { status: "Pulling the signup numbers", point: "Six weeks of signup data since the trial opened." },
+    { status: "Charting the trend", point: "One series tells it; chart it in the card." }
+  ],
+  card: card("chart", {
+    type: "area",
+    title: "Trial signups",
+    meta: "Last six weeks",
+    data: TRIAL_SIGNUPS,
+    xKey: "week",
+    yKey: "signups",
+    label: "Signups"
+  }),
+  followups: ["Which plan fits a team of five?", "Invite my team to a workspace", "Where is that written down?"]
+}).user("Invite my team to a workspace").assistant("Happy to. Give me the word and I will send invites to the three teammates on your account, all as editors.", {
+  steps: [
+    { status: "Checking the account", point: "Three teammates sit on the account, none invited yet." },
+    { status: "Drafting the answer", point: "Confirm before sending anything." }
+  ],
+  followups: ["Go ahead and invite the other three", "Take us up to twelve seats", "Find a time we can all meet"]
+}).user("Go ahead and invite the other three").assistant("All three invites are out. Everyone lands in the workspace with editor access.", {
+  steps: [
+    { status: "Sending the invites", point: "Three teammates to invite, all editors." },
+    { status: "Confirming delivery", point: "One call covers the batch." }
+  ],
+  card: card("tool-call", {
+    name: "invite_teammates",
+    summary: "3 editors to acme-design",
+    status: "success",
+    duration: "0.6s",
+    args: '{\n  "workspace": "acme-design",\n  "role": "editor",\n  "emails": 3\n}'
+  }),
+  followups: ["Find a time we can all meet", "Take us up to twelve seats", "How is the trial going?"]
+}).user("Take us up to twelve seats").assistant("Only the seat count moves, from five to twelve. Everything else in the config stays as it was.", {
+  steps: [
+    { status: "Locating the seat limit", point: "The seat limit lives in workspace.config.ts." },
+    { status: "Preparing the change", point: "One line changes; show the diff." }
+  ],
+  card: card("diff", {
+    filename: "workspace.config.ts",
+    diff: '@@ -12,7 +12,7 @@\n export const workspace = {\n   name: "acme-design",\n-  seats: 5,\n+  seats: 12,\n   region: "eu-west",\n };'
+  }),
+  followups: ["Go ahead and invite the other three", "What do the plans include?", "Find a time we can all meet"]
+}).user("Here is the launch plan we are working from.").assistant(
+  "Three phases, and most of the budget sits behind launch week itself. The dates line up with the workspace you already set up, so nothing needs to move.",
+  {
+    steps: [
+      { status: "Reading the document", point: "Fourteen pages; read it before answering." },
+      { status: "Charting the budget", point: "Budget is the decision in the doc; chart it." }
+    ],
+    card: card("stack", {
+      items: [
+        card("tool-call", {
+          name: "read_document",
+          summary: "Q3 launch plan.pdf",
+          status: "success",
+          duration: "1.8s"
+        }),
+        card("chart", {
+          type: "bar",
+          title: "Budget by phase",
+          meta: "From Q3 launch plan.pdf",
+          data: LAUNCH_BUDGET,
+          xKey: "phase",
+          yKey: "spend",
+          label: "Spend ($k)"
+        })
+      ]
+    }),
+    followups: ["Set it all up for me", "Take us up to twelve seats", "Find a time we can all meet"]
+  }
+).user("Sync the shared calendar").assistant("The sync timed out on the provider's side. Retry below and it should land.", {
+  steps: [{ status: "Starting the calendar sync", point: "The calendar sync runs after the invites." }],
+  card: card("tool-call", {
+    name: "sync_calendar",
+    summary: "the shared team calendar",
+    status: "error",
+    duration: "2.1s",
+    retryable: true
+  }),
+  followups: ["Find a time we can all meet", "Go ahead and invite the other three", "How is the trial going?"]
+}).user("Find a time we can all meet").assistant("I can check everyone's calendar for a slot, once you allow it below.", {
+  steps: [
+    { status: "Checking what this needs", point: "Suggesting times needs calendar access." },
+    { status: "Preparing the request", point: "Ask before connecting anything." }
+  ],
+  card: card("interrupt", {
+    title: "Connect the shared calendar?",
+    description: "The assistant wants read access to the team calendar to suggest meeting times.",
+    options: [
+      { value: "allow", label: "Allow once", variant: "primary" },
+      { value: "always", label: "Always allow", variant: "secondary" },
+      { value: "deny", label: "Not now", variant: "secondary" }
+    ]
+  }),
+  followups: ["Go ahead and invite the other three", "How is the trial going?", "How do I get started?"]
+}).fallback(
+  "The launch is on track overall. Three of the four readiness tracks are green, and the one item I would watch is the **legal review**, since it gates the pricing rollout.",
+  {
+    steps: [
+      { status: "Reading the readiness tracks", point: "Pull the four readiness tracks and their owners." },
+      { status: "Reviewing the legal blocker", point: "Pricing copy is still sitting in legal review." },
+      { status: "Drafting the answer", point: "Lead with the overall status, then flag the one real risk." }
+    ],
+    followups: ["Which track is behind?", "Who owns the legal review?", "What happens if pricing slips?"]
+  }
+).fallback(
+  "This chat is a scripted preview of the widget, so free text gets one of a few written replies. The suggestion chips lead through the parts of the story that show off the rich content: a plan, a chart, a diff, a tool call and an approval.",
+  {
+    steps: [{ status: "Reading the question", point: "Nothing scripted matches this one." }],
+    followups: ["How do I get started?", "What do the plans include?", "How is the trial going?"]
+  }
+).build();
+export {
+  DEMO_SCRIPT,
+  DEMO_STARTERS
+};

package/chat/demo.css

@@ -0,0 +1,46 @@
+/* The demo's card furniture: a drawn stand-in for product imagery, a row of
+   source chips, a stack of two cards landing as one turn, and the lettered
+   disc a source chip wears for a logo. Chart-series tokens keep it on-theme
+   in both modes and re-theme with the rest of a theme like every chart. */
+
+.ds-chat-demo__card-media {
+  height: 120px;
+  background: linear-gradient(135deg, var(--color-chart-series-1), var(--color-chart-series-2));
+}
+
+.ds-chat-demo__source-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--gap-200);
+}
+
+.ds-chat-demo__stack {
+  display: flex;
+  flex-direction: column;
+  gap: var(--gap-300);
+}
+
+.ds-chat-demo__logo {
+  display: inline-grid;
+  place-items: center;
+  width: 100%;
+  height: 100%;
+  border-radius: var(--radius-pill);
+  font-family: var(--font-caption-family);
+  font-size: var(--font-caption-size);
+  font-weight: var(--font-title-body-weight);
+  line-height: 1;
+  color: var(--color-text-inverse);
+}
+
+.ds-chat-demo__logo--one {
+  background-color: var(--color-chart-series-1);
+}
+
+.ds-chat-demo__logo--two {
+  background-color: var(--color-chart-series-2);
+}
+
+.ds-chat-demo__logo--three {
+  background-color: var(--color-chart-series-3);
+}

package/chat/demo.d.ts

@@ -0,0 +1,9 @@
+import { SimTiming } from './sim';
+import { ChatTransport } from './types';
+export { DEMO_RENDERERS, type DemoProductCard, type DemoChartCard, type DemoSourcesCard, type DemoToolCallCard, type DemoDiffCard, type DemoPlanCard, type DemoInterruptCard, type DemoStackCard, } from './demo-cards';
+export { DEMO_SCRIPT, DEMO_STARTERS } from './demo-script';
+export { DEMO_MENTIONS, DEMO_MODELS, DEMO_THREAD_GROUPS, DEMO_PROJECTS, DEMO_THREAD_NAMES, DEMO_THREADS, DEMO_WELCOME_OPTIONS, type DemoWelcomeVariant, } from './demo-fixtures';
+export { demoAgentTabs } from './demo-agent';
+export { DemoBoard, DemoWelcome } from './DemoWelcome';
+/** The demo's transport: the script, played at the default beats unless told otherwise. */
+export declare const createDemoTransport: (timing?: Partial<SimTiming>) => ChatTransport;

package/chat/demo.js

@@ -0,0 +1,24 @@
+import { createSimTransport } from "./sim.js";
+import { DEMO_SCRIPT } from "./demo-script.js";
+import { DEMO_STARTERS } from "./demo-script.js";
+import { DEMO_RENDERERS } from "./demo-cards.js";
+import { DEMO_MENTIONS, DEMO_MODELS, DEMO_PROJECTS, DEMO_THREADS, DEMO_THREAD_GROUPS, DEMO_THREAD_NAMES, DEMO_WELCOME_OPTIONS } from "./demo-fixtures.js";
+import { demoAgentTabs } from "./demo-agent.js";
+import { DemoBoard, DemoWelcome } from "./DemoWelcome.js";
+const createDemoTransport = (timing) => createSimTransport(DEMO_SCRIPT, timing);
+export {
+  DEMO_MENTIONS,
+  DEMO_MODELS,
+  DEMO_PROJECTS,
+  DEMO_RENDERERS,
+  DEMO_SCRIPT,
+  DEMO_STARTERS,
+  DEMO_THREADS,
+  DEMO_THREAD_GROUPS,
+  DEMO_THREAD_NAMES,
+  DEMO_WELCOME_OPTIONS,
+  DemoBoard,
+  DemoWelcome,
+  createDemoTransport,
+  demoAgentTabs
+};

package/chat/followups.d.ts

@@ -0,0 +1,41 @@
+import { ChatTurn } from './types';
+/** Chips offered under one answer. */
+export declare const MAX_FOLLOWUPS = 3;
+/**
+ * The written fallbacks a host that passes none gets: generic by design, so
+ * any of them makes sense under any answer. A host whose chat is about one
+ * product writes its own pool and passes it to the provider.
+ */
+export declare const DEFAULT_FALLBACK_FOLLOWUPS: readonly string[];
+/**
+ * Three questions from a fallback pool, rotated by the turn id (stable
+ * across re-renders) and skipping one identical to what the visitor just
+ * asked: offering their own question back would read as not listening.
+ */
+export declare function pickFallbackFollowups(pool: readonly string[], turnId: string, question: string): string[];
+/**
+ * Suggestions have no value once the visitor has moved on, and the widget
+ * never blocks on them, so a slow one is simply dropped.
+ */
+export declare const FOLLOWUPS_TIMEOUT_MS = 10000;
+/** A source of follow-up questions for a finished answer. */
+export type FollowupsSource = (question: string, answer: string, signal: AbortSignal) => Promise<string[]>;
+/**
+ * A source that asks an HTTP endpoint speaking the follow-ups protocol
+ * (`createFollowupsHandler` on the server): POST `{ question, answer }`,
+ * read `{ suggestions: string[] }`. Resolves to an empty array on any
+ * failure, which the provider stores as-is: it records that the turn was
+ * asked about and had nothing to offer, then substitutes the fallbacks.
+ */
+export declare function createFollowupsFetcher(endpoint?: string): FollowupsSource;
+/**
+ * The turn to ask about, or null when there is nothing to ask about yet:
+ * the newest turn must be a committed assistant answer that came from a
+ * backend (an exchange id is the marker, as it is for the thumbs) and has
+ * not been asked about already.
+ */
+export declare function followupTarget(turns: ChatTurn[]): {
+    id: string;
+    question: string;
+    answer: string;
+} | null;

package/chat/followups.js

@@ -0,0 +1,55 @@
+import { fitsChip } from "./suggestions.js";
+const MAX_FOLLOWUPS = 3;
+const DEFAULT_FALLBACK_FOLLOWUPS = [
+  "Can you say more about that?",
+  "What should I do next?",
+  "Where can I read more?",
+  "Can you give an example?",
+  "What are the alternatives?"
+];
+function pickFallbackFollowups(pool, turnId, question) {
+  const asked = question.trim().toLowerCase();
+  const usable = pool.filter((label) => label.toLowerCase() !== asked && fitsChip(label));
+  let hash = 0;
+  for (const char of turnId) hash = hash * 31 + char.charCodeAt(0) >>> 0;
+  return Array.from(
+    { length: Math.min(MAX_FOLLOWUPS, usable.length) },
+    (_, index) => usable[(hash + index) % usable.length]
+  );
+}
+const FOLLOWUPS_TIMEOUT_MS = 1e4;
+function createFollowupsFetcher(endpoint = "/api/chat/followups") {
+  return async (question, answer, signal) => {
+    try {
+      const response = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ question, answer }),
+        signal
+      });
+      if (!response.ok) return [];
+      const payload = await response.json();
+      const suggestions = payload?.suggestions;
+      if (!Array.isArray(suggestions)) return [];
+      return suggestions.filter((item) => typeof item === "string" && fitsChip(item)).slice(0, MAX_FOLLOWUPS);
+    } catch {
+      return [];
+    }
+  };
+}
+function followupTarget(turns) {
+  const last = turns[turns.length - 1];
+  if (!last || last.role !== "assistant") return null;
+  if (!last.exchangeId || last.followups || last.text === "") return null;
+  const question = turns[turns.length - 2];
+  if (!question || question.role !== "user") return null;
+  return { id: last.id, question: question.text, answer: last.text };
+}
+export {
+  DEFAULT_FALLBACK_FOLLOWUPS,
+  FOLLOWUPS_TIMEOUT_MS,
+  MAX_FOLLOWUPS,
+  createFollowupsFetcher,
+  followupTarget,
+  pickFallbackFollowups
+};

package/chat/greeting.d.ts

@@ -0,0 +1,11 @@
+/** The three greetings, overridable by a host that speaks differently. */
+export interface GreetingCopy {
+    morning: string;
+    afternoon: string;
+    evening: string;
+}
+export declare const DEFAULT_GREETING_COPY: GreetingCopy;
+export declare const greetingFor: (hour: number, copy?: GreetingCopy) => string;
+export declare const subscribeClock: () => () => void;
+export declare const readGreeting: () => string;
+export declare const serverGreeting: () => string;

package/chat/greeting.js

@@ -0,0 +1,21 @@
+const DEFAULT_GREETING_COPY = {
+  morning: "Good morning",
+  afternoon: "Good afternoon",
+  evening: "Good evening"
+};
+const greetingFor = (hour, copy = DEFAULT_GREETING_COPY) => {
+  if (hour >= 5 && hour < 12) return copy.morning;
+  if (hour >= 12 && hour < 17) return copy.afternoon;
+  return copy.evening;
+};
+const subscribeClock = () => () => {
+};
+const readGreeting = () => greetingFor((/* @__PURE__ */ new Date()).getHours());
+const serverGreeting = () => "";
+export {
+  DEFAULT_GREETING_COPY,
+  greetingFor,
+  readGreeting,
+  serverGreeting,
+  subscribeClock
+};