rift-ds 1.9.0 → 1.10.0

package/chat/demo-script.js

@@ -20,7 +20,44 @@ const PLAN_STEPS = [
   { label: "Invite the three teammates", status: "active" },
   { label: "Post the welcome note", status: "pending" }
 ];
+const KICKOFF_STEPS = [
+  { label: "Hold the slot on every calendar", status: "completed" },
+  { label: "Draft the agenda from the launch plan", status: "active" },
+  { label: "Send the invites", status: "pending" }
+];
 const card = (kind, data) => ({ kind, data });
+function planFor(answer) {
+  const size = answer.toLowerCase();
+  const plan = size.includes("just me") ? "the Starter plan covers you: unlimited projects, no seats to manage" : size.includes("more than 50") ? "the Business plan fits: single sign-on, audit logs and pooled seats" : "the Team plan fits: shared workspaces for everyone, and guest seats stay free";
+  return {
+    steps: [{ status: "Matching the plan", point: "Team size decides the plan; nothing else differs." }],
+    text: `For ${answer.trim().replace(/[.!?]$/, "")}, ${plan}.`,
+    followups: ["What do the plans include?", "Invite my team to a workspace", "Set up notifications for me"]
+  };
+}
+const INVITES_SENT = {
+  steps: [
+    { status: "Sending the invites", point: "Three teammates to invite, all editors." },
+    { status: "Confirming delivery", point: "One call covers the batch." }
+  ],
+  text: "All three invites are out. Everyone lands in the workspace with editor access.",
+  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: ["Set up notifications for me", "Take us up to twelve seats", "Plan our launch kickoff"]
+};
+const PLANS_COMPARED = {
+  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." }
+  ],
+  text: "Every plan includes unlimited projects. The Team plan adds shared workspaces, guest seats, and a 90 day version history.",
+  followups: ["Which plan fits a team of five?", "Help me pick a plan", "Where is that written down?"]
+};
 const DEMO_STARTERS = [
   { id: "start", label: "How do I get started?" },
   { id: "plans", label: "What do the plans include?" },
@@ -42,16 +79,7 @@ const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
   ],
   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.", {
+}).user("What do the plans include?").assistant(PLANS_COMPARED.text, PLANS_COMPARED).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. Shall we go with it?", {
   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." }
@@ -59,13 +87,26 @@ const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
   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" }
-    ]
+    meta: "Billed monthly, cancel any time"
   }),
-  followups: ["Where is that written down?", "Invite my team to a workspace", "How is the trial going?"]
+  question: {
+    id: "team-plan",
+    questions: [
+      {
+        id: "plan",
+        prompt: "Go with the Team plan?",
+        options: [
+          { value: "choose", label: "Choose the Team plan" },
+          { value: "compare", label: "Compare the plans first" }
+        ]
+      }
+    ]
+  },
+  answered: (answer) => answer.toLowerCase().includes("compare") ? PLANS_COMPARED : {
+    steps: [{ status: "Switching the plan", point: "Move the workspace to Team from today." }],
+    text: "Done. The workspace is on the Team plan from today, billed monthly, and you can step back down any time.",
+    followups: ["Invite my team to a workspace", "Where is that written down?", "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." },
@@ -112,26 +153,30 @@ const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
     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.", {
+}).user("Invite my team to a workspace").assistant("Happy to. Shall I 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.", {
+  question: {
+    id: "invites",
+    questions: [
+      {
+        id: "send",
+        prompt: "Send the invites?",
+        options: [
+          { value: "send", label: "Invite all three" },
+          { value: "wait", label: "Not yet" }
+        ]
+      }
+    ]
+  },
+  answered: (answer) => answer.toLowerCase().startsWith("not yet") ? {
+    steps: [{ status: "Holding the invites", point: "Nothing sent; keep the list ready." }],
+    text: "Nothing sent. The three are ready to go whenever you are.",
+    followups: ["Take us up to twelve seats", "Find a time we can all meet", "How is the trial going?"]
+  } : INVITES_SENT
+}).user("Go ahead and invite the other three").assistant(INVITES_SENT.text, INVITES_SENT).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. Apply it?", {
   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." }
@@ -140,7 +185,34 @@ const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
     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"]
+  question: {
+    id: "seats",
+    questions: [
+      {
+        id: "apply",
+        prompt: "Apply the change?",
+        options: [
+          { value: "apply", label: "Apply it" },
+          { value: "wait", label: "Not yet" }
+        ]
+      }
+    ]
+  },
+  answered: (answer) => answer.toLowerCase().startsWith("not yet") ? {
+    steps: [{ status: "Leaving the config", point: "The diff stays a proposal." }],
+    text: "Left as it is. The workspace stays at five seats until you say otherwise.",
+    followups: ["What do the plans include?", "Invite my team to a workspace", "How is the trial going?"]
+  } : {
+    steps: [{ status: "Applying the change", point: "One line in workspace.config.ts." }],
+    text: "Applied. The workspace takes twelve seats from now, and the next invoice picks up the difference.",
+    card: card("tool-call", {
+      name: "update_config",
+      summary: "workspace.config.ts, seats 5 to 12",
+      status: "success",
+      duration: "0.4s"
+    }),
+    followups: ["Invite my team to a workspace", "Find a time we can all meet", "How is the trial going?"]
+  }
 }).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.",
   {
@@ -169,31 +241,73 @@ const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
     }),
     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.", {
+).user("Sync the shared calendar").assistant("The sync timed out on the provider's side. It usually lands on a second try. Run it again?", {
   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
+    duration: "2.1s"
   }),
-  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.", {
+  question: {
+    id: "sync-retry",
+    questions: [
+      {
+        id: "retry",
+        prompt: "Try the sync again?",
+        options: [
+          { value: "retry", label: "Retry the sync" },
+          { value: "leave", label: "Leave it for now" }
+        ]
+      }
+    ]
+  },
+  answered: (answer) => answer.toLowerCase().startsWith("leave") ? {
+    steps: [{ status: "Leaving the sync", point: "Nothing to retry until asked." }],
+    text: "Left for now. Nothing else depends on it, and it can run again whenever you like.",
+    followups: ["Find a time we can all meet", "Invite my team to a workspace", "How is the trial going?"]
+  } : {
+    steps: [{ status: "Retrying the sync", point: "Second attempt against the provider." }],
+    text: "Second time lucky. The shared calendar is in sync.",
+    card: card("tool-call", {
+      name: "sync_calendar",
+      summary: "the shared team calendar",
+      status: "success",
+      duration: "1.2s"
+    }),
+    followups: ["Find a time we can all meet", "Plan our launch kickoff", "How is the trial going?"]
+  }
+}).user("Find a time we can all meet").assistant("I can check everyone's calendar for a slot. Can I read the shared team calendar?", {
   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" }
+  question: {
+    id: "calendar-access",
+    questions: [
+      {
+        id: "access",
+        prompt: "Read the shared calendar?",
+        options: [
+          { value: "once", label: "Yes, just this once" },
+          { value: "always", label: "Yes, always" },
+          { value: "no", label: "Not now" }
+        ]
+      }
     ]
-  }),
-  followups: ["Go ahead and invite the other three", "How is the trial going?", "How do I get started?"]
+  },
+  answered: (answer) => answer.toLowerCase().startsWith("not now") ? {
+    steps: [{ status: "Leaving the calendar alone", point: "No access; offer the manual route." }],
+    text: "No problem, nothing is connected. You can share a few times that suit you and I will send them round.",
+    followups: ["Go ahead and invite the other three", "How is the trial going?", "How do I get started?"]
+  } : {
+    steps: [
+      { status: "Reading the shared calendar", point: "Four calendars, the next ten working days." },
+      { status: "Finding a free slot", point: "Thursday afternoon is clear for everyone." }
+    ],
+    text: answer.toLowerCase().includes("always") ? "Connected for good. Thursday at 2pm is the first slot everyone has free, and I will keep an eye out when plans change." : "Read once and disconnected. Thursday at 2pm is the first slot everyone has free.",
+    followups: ["Plan our launch kickoff", "Go ahead and invite the other three", "How is the trial going?"]
+  }
 }).user("Build me a launch dashboard").assistant(
   "Here is the launch on one board: what is running now, the trial signups, the projects and what is waiting on you. The rows that ask a question will ask it here.",
   {
@@ -214,7 +328,99 @@ const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
     card: artifactCard(DEMO_PAGE_ARTIFACT),
     followups: ["Build me a launch dashboard", "What do the plans include?", "How is the trial going?"]
   }
-).fallback(
+).user("Help me pick a plan").assistant("Happy to. How big is the team that will use the workspace?", {
+  steps: [{ status: "Reading the plans", point: "Plans differ by team size; ask before recommending." }],
+  question: {
+    id: "team-size",
+    questions: [
+      {
+        id: "size",
+        prompt: "How big is the team?",
+        options: [
+          { value: "solo", label: "Just me" },
+          { value: "small", label: "2 to 10 people" },
+          { value: "medium", label: "11 to 50 people" },
+          { value: "large", label: "More than 50" }
+        ],
+        other: true
+      }
+    ]
+  },
+  answered: planFor
+}).user("Set up notifications for me").assistant("Sure. Which of these should reach you? Pick as many as you like.", {
+  steps: [{ status: "Reading your settings", point: "Four kinds of notification; ask which matter." }],
+  question: {
+    id: "notifications",
+    questions: [
+      {
+        id: "kinds",
+        prompt: "Notify me about",
+        mode: "multi",
+        options: [
+          { value: "mentions", label: "Mentions", description: "When someone writes your name" },
+          { value: "comments", label: "Comments on my files" },
+          { value: "invites", label: "Invites accepted" },
+          { value: "summary", label: "A weekly summary", description: "Mondays, one email" }
+        ],
+        other: true
+      }
+    ]
+  },
+  answered: (answer) => ({
+    steps: [{ status: "Saving your settings", point: "Turn on what was picked, everything else off." }],
+    text: `Done. You will hear about ${answer.trim().toLowerCase()}, and nothing else. Change it any time in Settings.`,
+    followups: ["Plan our launch kickoff", "Help me pick a plan", "How is the trial going?"]
+  })
+}).user("Plan our launch kickoff").assistant("Three quick questions first, so the kickoff fits the team.", {
+  steps: [
+    { status: "Reading the launch plan", point: "The kickoff needs a date, a guest list and a format." },
+    { status: "Preparing the questions", point: "Ask all three before booking anything." }
+  ],
+  question: {
+    id: "kickoff",
+    questions: [
+      {
+        id: "when",
+        prompt: "When should it happen?",
+        options: [
+          { value: "this-week", label: "This week" },
+          { value: "next-week", label: "Next week" },
+          { value: "after-beta", label: "After the beta" }
+        ]
+      },
+      {
+        id: "who",
+        prompt: "Who should be there?",
+        mode: "multi",
+        options: [
+          { value: "design", label: "Design" },
+          { value: "engineering", label: "Engineering" },
+          { value: "marketing", label: "Marketing" },
+          { value: "sales", label: "Sales" }
+        ]
+      },
+      {
+        id: "format",
+        prompt: "What format?",
+        options: [
+          { value: "room", label: "In person" },
+          { value: "video", label: "A video call" },
+          { value: "async", label: "An async update" }
+        ],
+        other: true
+      }
+    ]
+  },
+  answered: {
+    steps: [
+      { status: "Booking the kickoff", point: "Find the first slot everyone named is free." },
+      { status: "Drafting the agenda", point: "Lead with the launch dates, then owners." }
+    ],
+    text: "Kickoff is on the calendar. The slot is held for everyone you named, and the agenda is being drafted from the launch plan.",
+    card: card("plan", { steps: KICKOFF_STEPS }),
+    followups: ["Find a time we can all meet", "Build me a launch dashboard", "Set up notifications for me"]
+  }
+}).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: [
@@ -225,10 +431,10 @@ const DEMO_SCRIPT = scriptChat().user("How do I get started?").assistant(
     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, an approval and an artifact.",
+  "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, an artifact and questions to answer.",
   {
     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?"]
+    followups: ["How do I get started?", "Help me pick a plan", "Plan our launch kickoff"]
   }
 ).build();
 export {

package/chat/followups.d.ts

@@ -31,8 +31,8 @@ export declare function createFollowupsFetcher(endpoint?: string): FollowupsSour
 /**
  * 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.
+ * backend (an exchange id is the marker, as it is for the thumbs), has
+ * not been asked about already, and asks no question of its own.
  */
 export declare function followupTarget(turns: ChatTurn[]): {
     id: string;

package/chat/followups.js

@@ -41,6 +41,7 @@ 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;
+  if (last.question) 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 };

package/chat/index.d.ts

@@ -29,9 +29,10 @@ export { createFetchTransport, DEFAULT_FETCH_COPY, FIRST_BYTE_TIMEOUT_MS, MAX_TR
 export { scriptChat, createSimTransport, defaultFilesReply, DEFAULT_FALLBACK_REPLY, DEFAULT_SIM_TIMING, type ChatScript, type ChatScriptBuilder, type ScriptNode, type ScriptStep, type ScriptedReply, type SimTiming, } from './sim';
 export { createFollowupsFetcher, followupTarget, pickFallbackFollowups, DEFAULT_FALLBACK_FOLLOWUPS, MAX_FOLLOWUPS, FOLLOWUPS_TIMEOUT_MS, type FollowupsSource, } from './followups';
 export { SUGGESTION_MAX_CHARS, fitsChip } from './suggestions';
+export { sanitizeQuestionSet, describeAnswers, serializeReply, isBlockingQuestion, ASK_USER_INPUT_SCHEMA, MAX_QUESTIONS, MAX_QUESTION_OPTIONS, MIN_QUESTION_OPTIONS, QUESTION_PROMPT_MAX_CHARS, OPTION_DESCRIPTION_MAX_CHARS, } from './questions';
 export { STARTER_COUNT, pickStarters, namedStarter, hashString, mulberry32, } from './starters';
 export { greetingFor, readGreeting, serverGreeting, subscribeClock, DEFAULT_GREETING_COPY, type GreetingCopy, } from './greeting';
 export { CHAT_PLACEMENTS, chatPlacement, DOCK_MIN_WIDTH, DOCK_MAX_WIDTH, FLOAT_MAX_SCALE, FLOAT_EDGE_GAP, dockWidthFromDrag, isFloatDragStart, clampFloatPosition, type ChatPlacement, type ChatSide, } from './placement';
 export { artifactCard, cardArtifact } from './artifacts';
-export { ARTIFACT_CARD_KIND, CHAT_EVENT_KINDS, type ChatArtifact, type ChatCard, type ChatEvent, type ChatTransport, type ChatTransportMessage, type ChatTurn, type ChatModelOption, type ChatFeedbackVerdict, type LivePhase, type LiveResponse, type Starter, } from './types';
+export { ARTIFACT_CARD_KIND, CHAT_EVENT_KINDS, type ChatArtifact, type ChatCard, type ChatEvent, type ChatQuestion, type ChatQuestionAnswer, type ChatQuestionSet, type ChatReply, type ChatTransport, type ChatTransportMessage, type ChatTurn, type ChatModelOption, type ChatFeedbackVerdict, type LivePhase, type LiveResponse, type Starter, } from './types';
 export { chatWidget, chatWidgetRegistry, WIDGET_COUNT, type ChatWidgetMeta } from './registry';

package/chat/index.js

@@ -14,6 +14,7 @@ import { DEFAULT_FETCH_COPY, FIRST_BYTE_TIMEOUT_MS, MAX_TRANSPORT_TURNS, createF
 import { DEFAULT_FALLBACK_REPLY, DEFAULT_SIM_TIMING, createSimTransport, defaultFilesReply, scriptChat } from "./sim.js";
 import { DEFAULT_FALLBACK_FOLLOWUPS, FOLLOWUPS_TIMEOUT_MS, MAX_FOLLOWUPS, createFollowupsFetcher, followupTarget, pickFallbackFollowups } from "./followups.js";
 import { SUGGESTION_MAX_CHARS, fitsChip } from "./suggestions.js";
+import { ASK_USER_INPUT_SCHEMA, MAX_QUESTIONS, MAX_QUESTION_OPTIONS, MIN_QUESTION_OPTIONS, OPTION_DESCRIPTION_MAX_CHARS, QUESTION_PROMPT_MAX_CHARS, describeAnswers, isBlockingQuestion, sanitizeQuestionSet, serializeReply } from "./questions.js";
 import { STARTER_COUNT, hashString, mulberry32, namedStarter, pickStarters } from "./starters.js";
 import { DEFAULT_GREETING_COPY, greetingFor, readGreeting, serverGreeting, subscribeClock } from "./greeting.js";
 import { CHAT_PLACEMENTS, DOCK_MAX_WIDTH, DOCK_MIN_WIDTH, FLOAT_EDGE_GAP, FLOAT_MAX_SCALE, chatPlacement, clampFloatPosition, dockWidthFromDrag, isFloatDragStart } from "./placement.js";
@@ -25,6 +26,7 @@ export {
   ARTIFACT_MIN_COLUMN_WIDTH,
   ASIDE_RAIL_MIN_WIDTH,
   ASIDE_WITH_THREADS_MIN_WIDTH,
+  ASK_USER_INPUT_SCHEMA,
   CHAT_EVENT_KINDS,
   CHAT_PANEL_ID,
   CHAT_PLACEMENTS,
@@ -50,7 +52,12 @@ export {
   FLOAT_MAX_SCALE,
   FOLLOWUPS_TIMEOUT_MS,
   MAX_FOLLOWUPS,
+  MAX_QUESTIONS,
+  MAX_QUESTION_OPTIONS,
   MAX_TRANSPORT_TURNS,
+  MIN_QUESTION_OPTIONS,
+  OPTION_DESCRIPTION_MAX_CHARS,
+  QUESTION_PROMPT_MAX_CHARS,
   STARTER_COUNT,
   SUGGESTION_MAX_CHARS,
   TAKEOVER_QUERY,
@@ -68,11 +75,13 @@ export {
   createFollowupsFetcher,
   createSimTransport,
   defaultFilesReply,
+  describeAnswers,
   dockWidthFromDrag,
   fitsChip,
   followupTarget,
   greetingFor,
   hashString,
+  isBlockingQuestion,
   isFloatDragStart,
   isInternalPath,
   mulberry32,
@@ -80,7 +89,9 @@ export {
   pickFallbackFollowups,
   pickStarters,
   readGreeting,
+  sanitizeQuestionSet,
   scriptChat,
+  serializeReply,
   serverGreeting,
   subscribeClock,
   useChat,

package/chat/queries.d.ts

@@ -1,5 +1,5 @@
-export declare const DOCK_QUERY = "(min-width: 1440px)";
-export declare const TAKEOVER_QUERY = "(max-width: 719px)";
+export declare const DOCK_QUERY: string;
+export declare const TAKEOVER_QUERY: string;
 /** The widget's own width thresholds for seating its rails inline. */
 export declare const THREADS_RAIL_MIN_WIDTH = 720;
 /** The trailing seat's threshold, one number for both of its tenants: at

package/chat/queries.js

@@ -1,7 +1,8 @@
 "use client";
 import { useSyncExternalStore } from "react";
-const DOCK_QUERY = "(min-width: 1440px)";
-const TAKEOVER_QUERY = "(max-width: 719px)";
+import { mediaAbove, mediaBelow, BREAKPOINT_CHAT_TAKEOVER_PX, BREAKPOINT_CHAT_DOCK_PX } from "../tokens/breakpoints.js";
+const DOCK_QUERY = mediaAbove(BREAKPOINT_CHAT_DOCK_PX);
+const TAKEOVER_QUERY = mediaBelow(BREAKPOINT_CHAT_TAKEOVER_PX);
 const THREADS_RAIL_MIN_WIDTH = 720;
 const ASIDE_RAIL_MIN_WIDTH = 760;
 const ASIDE_WITH_THREADS_MIN_WIDTH = 1040;

package/chat/questions.d.ts

@@ -0,0 +1,97 @@
+import { ChatQuestionAnswer, ChatQuestionSet, ChatReply, ChatTurn } from './types';
+/** Questions in one set. A longer interview belongs in a form, not a chat turn. */
+export declare const MAX_QUESTIONS = 4;
+/** Options in one question, before "Something else". */
+export declare const MAX_QUESTION_OPTIONS = 5;
+/** Options in one question at the least: one option is not a choice. */
+export declare const MIN_QUESTION_OPTIONS = 2;
+/** A question's own heading: a few words, one line in a docked panel. */
+export declare const QUESTION_PROMPT_MAX_CHARS = 60;
+/** An option's second line. */
+export declare const OPTION_DESCRIPTION_MAX_CHARS = 80;
+/**
+ * The question set the widget may render, or null. Questions that are
+ * malformed or over budget are dropped one by one; a set left with none,
+ * or with more than `MAX_QUESTIONS`, is dropped whole.
+ */
+export declare function sanitizeQuestionSet(input: unknown, fallbackId?: string): ChatQuestionSet | null;
+/**
+ * Whether a turn's questions hold the composer: a set of more than one,
+ * still open, on the newest turn. One question never does: typing instead
+ * of tapping is a fine answer to it, and leaves the card marked unanswered.
+ */
+export declare function isBlockingQuestion(turn: ChatTurn | undefined, live: boolean): boolean;
+/** What each answered question reads as: its prompt and the labels picked. */
+export declare function describeAnswers(set: ChatQuestionSet, answers: ChatQuestionAnswer[]): ChatReply;
+/**
+ * The answers as the plain message the model reads. One question reads as
+ * the answer alone ("Vite", "Components, Tokens"), because the model's own
+ * reply just asked it; a set names each question so the answers cannot be
+ * paired with the wrong one.
+ */
+export declare function serializeReply(reply: ChatReply): string;
+/**
+ * The `ask_user` tool's input schema, for `createChatHandler`. Exported so
+ * a host running its own loop asks for the same shape the widget renders.
+ */
+export declare const ASK_USER_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly questions: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 4;
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly description: "A short stable key for the question, e.g. \"framework\".";
+                    };
+                    readonly prompt: {
+                        readonly type: "string";
+                        readonly description: "The question in a few words, at most 60 characters, e.g. \"Which framework?\".";
+                    };
+                    readonly mode: {
+                        readonly type: "string";
+                        readonly enum: readonly ["single", "multi"];
+                        readonly description: "single when exactly one answer fits; multi when several can be true at once.";
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly minItems: 2;
+                        readonly maxItems: 5;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly label: {
+                                    readonly type: "string";
+                                    readonly description: "The answer as the person would say it, at most 40 characters.";
+                                };
+                                readonly description: {
+                                    readonly type: "string";
+                                    readonly description: "Optional: what choosing it means, at most 80 characters.";
+                                };
+                            };
+                            readonly required: readonly ["label"];
+                        };
+                    };
+                    readonly other: {
+                        readonly type: "boolean";
+                        readonly description: "Offer a free-text \"Something else\" when the options may not cover every answer.";
+                    };
+                    readonly min: {
+                        readonly type: "integer";
+                        readonly description: "multi only: the fewest picks that make an answer.";
+                    };
+                    readonly max: {
+                        readonly type: "integer";
+                        readonly description: "multi only: the most picks allowed.";
+                    };
+                };
+                readonly required: readonly ["prompt", "options"];
+            };
+        };
+    };
+    readonly required: readonly ["questions"];
+};