@k2b/cloud 0.40.0 → 0.42.0

package/src/ai/chat/action-question.tsx

@@ -4,15 +4,25 @@ import {
   Chat,
   type ChatDecisionState,
   type ChatOutcomeLine,
+  dialogCore,
   isStructuredDataValue,
   LocaleProvider,
   MarkdownView,
+  PanelDialog,
+  Placeholder,
+  panelDialogOptions,
   ReferenceChip,
   StructuredDataPreview,
 } from "@k2b/ui";
 import { Lexer, type Token, type Tokens } from "marked";
-import { createMemo, createSignal, createUniqueId, For, type JSX, Match, Show, Switch } from "solid-js";
-import type { CapabilityPerson, CapabilityPreview } from "../../contracts/capabilities";
+import { createMemo, createSignal, createUniqueId, For, type JSX, Match, onCleanup, onMount, Show, Switch } from "solid-js";
+import { readCapabilityReviewContent } from "../../capabilities/client";
+import type {
+  CapabilityPerson,
+  CapabilityPreview,
+  CapabilityReviewContent,
+  CapabilityReviewContentRef,
+} from "../../contracts/capabilities";
 import { formatBytes } from "../../shared/format";
 import type { ActionCard, ActionChip, ActionPreviewModel, ActionText } from "./action-card";
 import { actionMessages } from "./action-messages";
@@ -160,13 +170,13 @@ const mayOverflow = (text: string): boolean =>
  * not fit offers to show the rest in place, and any other text stands whole, so nothing a person approves stays out of
  * reach even where the estimate is short, such as for wide characters.
  */
-function PreviewExcerpt(props: { text: string; readMore?: string; label: string }) {
+function PreviewExcerpt(props: { text: string; readMore?: string; label: string; full?: boolean; compact?: boolean }) {
   const id = createUniqueId();
   const [expanded, setExpanded] = createSignal(false);
-  const offer = () => !props.readMore && mayOverflow(props.text);
+  const offer = () => !props.full && !props.compact && !props.readMore && mayOverflow(props.text);
   return (
     <>
-      <Chat.Preview.Excerpt id={id} expanded={expanded() || (!props.readMore && !offer())}>
+      <Chat.Preview.Excerpt id={id} expanded={props.full || expanded() || (!props.compact && !props.readMore && !offer())}>
         {props.text}
       </Chat.Preview.Excerpt>
       <Show when={offer() && !expanded()}>
@@ -217,22 +227,33 @@ function MessagePreview(props: {
   locale: string;
   timeZone: string;
   readMore?: string;
+  /** Only a question that sends says when the mail goes out; a draft that is created or deleted goes nowhere. */
+  sends: boolean;
+  full?: boolean;
+  compact?: boolean;
 }) {
   const t = () => actionMessages(props.locale);
+  const text = (value: string) => (props.full ? visibleReviewText(value) : value);
+  const person = (value: CapabilityPerson) => ({
+    ...personRow(value),
+    ...(value.name !== undefined ? { name: text(value.name) } : {}),
+    ...(value.address !== undefined ? { address: text(value.address) } : {}),
+  });
   const rows = () => {
     const p = props.preview;
     const more = (count?: number) => (count ? { value: <> {t().andMore({ count })}</> } : {});
     return [
-      ...(p.from ? [{ label: t().from, people: [personRow(p.from)] }] : []),
-      { label: t().to, people: p.to.map(personRow), ...more(p.more?.to) },
-      ...(p.cc?.length || p.more?.cc ? [{ label: t().cc, people: (p.cc ?? []).map(personRow), ...more(p.more?.cc) }] : []),
+      ...(p.from ? [{ label: t().from, people: [person(p.from)] }] : []),
+      { label: t().to, people: p.to.map(person), ...more(p.more?.to) },
+      ...(p.cc?.length || p.more?.cc ? [{ label: t().cc, people: (p.cc ?? []).map(person), ...more(p.more?.cc) }] : []),
       ...(p.bcc?.length || p.more?.bcc
-        ? [{ label: t().bcc, people: (p.bcc ?? []).map(personRow), emphasis: true, ...more(p.more?.bcc) }]
+        ? [{ label: t().bcc, people: (p.bcc ?? []).map(person), emphasis: true, ...more(p.more?.bcc) }]
         : []),
     ];
   };
   const note = () => {
     const p = props.preview;
+    if (!props.sends) return undefined;
     if (p.sendAt) {
       const [before, after] = t().sendsAt({ at: "\u0000" }).split("\u0000");
       return (
@@ -248,9 +269,15 @@ function MessagePreview(props: {
   return (
     <>
       <Chat.Preview.Header rows={rows()} note={note()} />
-      <Chat.Preview.Title>{props.preview.subject || t().noSubject}</Chat.Preview.Title>
-      <Show when={props.preview.body.trim()}>
-        <PreviewExcerpt text={excerptText(props.preview.body, props.preview.format)} readMore={props.readMore} label={t().readMail} />
+      <Chat.Preview.Title>{text(props.preview.subject) || t().noSubject}</Chat.Preview.Title>
+      <Show when={props.full || props.preview.body.trim()}>
+        <PreviewExcerpt
+          text={props.full ? visibleReviewText(props.preview.body) : excerptText(props.preview.body, props.preview.format)}
+          readMore={props.readMore}
+          label={t().readMail}
+          full={props.full}
+          compact={props.compact}
+        />
       </Show>
       <For each={props.preview.attachments ?? []}>
         {(attachment) => (
@@ -259,7 +286,7 @@ function MessagePreview(props: {
             accent={attachmentLook(attachment.name).accent}
             meta={attachment.size !== undefined ? formatBytes(attachment.size, { locale: props.locale }) : undefined}
           >
-            {attachment.name}
+            {text(attachment.name)}
           </Chat.Preview.Line>
         )}
       </For>
@@ -273,7 +300,7 @@ function MessagePreview(props: {
       <For each={props.preview.warnings ?? []}>
         {(warning) => (
           <Chat.Preview.Line icon="ti ti-alert-triangle" tone="warning">
-            <WarningText text={warning} />
+            <WarningText text={text(warning)} />
           </Chat.Preview.Line>
         )}
       </For>
@@ -288,7 +315,14 @@ function MessagePreview(props: {
   );
 }
 
-function ReviewPreviewBody(props: { model: Extract<ActionPreviewModel, { kind: "review" }>; card: ActionCard; readMore?: string }) {
+function ReviewPreviewBody(props: {
+  model: Extract<ActionPreviewModel, { kind: "review" }>;
+  card: ActionCard;
+  readMore?: string;
+  full?: boolean;
+  baseRevision?: number;
+  compact?: boolean;
+}) {
   const t = () => actionMessages(props.model.locale);
   const locale = () => props.model.locale;
   const tz = () => props.model.timeZone;
@@ -305,9 +339,22 @@ function ReviewPreviewBody(props: { model: Extract<ActionPreviewModel, { kind: "
   const preview = () => props.model.preview;
   return (
     <Chat.Preview>
+      <Show when={props.baseRevision !== undefined}>
+        <Chat.Preview.Line icon="ti ti-history">{t().baseRevision({ revision: props.baseRevision! })}</Chat.Preview.Line>
+      </Show>
       <Switch>
         <Match when={preview()?.kind === "message" ? (preview() as Extract<CapabilityPreview, { kind: "message" }>) : undefined}>
-          {(message) => <MessagePreview preview={message()} locale={locale()} timeZone={tz()} readMore={props.readMore} />}
+          {(message) => (
+            <MessagePreview
+              preview={message()}
+              locale={locale()}
+              timeZone={tz()}
+              readMore={props.readMore}
+              sends={props.card.reason.code === "sends"}
+              full={props.full}
+              compact={props.compact}
+            />
+          )}
         </Match>
         <Match when={preview()?.kind === "event" ? (preview() as Extract<CapabilityPreview, { kind: "event" }>) : undefined}>
           {(event) => (
@@ -396,9 +443,17 @@ function ReviewPreviewBody(props: { model: Extract<ActionPreviewModel, { kind: "
         <Match when={preview()?.kind === "page" ? (preview() as Extract<CapabilityPreview, { kind: "page" }>) : undefined}>
           {(page) => (
             <>
-              <Chat.Preview.Title meta={page().place}>{page().title}</Chat.Preview.Title>
-              <Show when={page().body.trim()}>
-                <PreviewExcerpt text={excerptText(page().body, page().format)} readMore={props.readMore} label={t().readPage} />
+              <Chat.Preview.Title meta={props.full && page().place ? visibleReviewText(page().place!) : page().place}>
+                {props.full ? visibleReviewText(page().title) : page().title}
+              </Chat.Preview.Title>
+              <Show when={props.full || page().body.trim()}>
+                <PreviewExcerpt
+                  text={props.full ? visibleReviewText(page().body) : excerptText(page().body, page().format)}
+                  readMore={props.readMore}
+                  label={t().readPage}
+                  full={props.full}
+                  compact={props.compact}
+                />
               </Show>
               <Show when={page().changes?.length ? page().changes : undefined}>
                 {(changes) => (
@@ -556,15 +611,113 @@ function LegacyPreview(props: { model: Extract<ActionPreviewModel, { kind: "lega
   );
 }
 
+/** Controls remain inspectable instead of being removed or changing reading order. */
+export const visibleReviewText = (text: string): string =>
+  text.replace(/[\p{Cc}\p{Cf}\p{Cs}\u2028\u2029]/gu, (character) =>
+    character === "\n" || character === "\t" ? character : `⟦U+${character.codePointAt(0)!.toString(16).toUpperCase().padStart(4, "0")}⟧`,
+  );
+
+function ReviewContentPanel(props: {
+  card: ActionCard;
+  source: CapabilityReviewContentRef;
+  timeZone: string;
+  close: () => void;
+  onLoaded: () => void;
+}) {
+  const t = () => actionMessages(props.card.locale);
+  const [content, setContent] = createSignal<CapabilityReviewContent>();
+  const [failed, setFailed] = createSignal(false);
+  const [loading, setLoading] = createSignal(false);
+  let request: AbortController | undefined;
+  let disposed = false;
+  onCleanup(() => {
+    disposed = true;
+    request?.abort();
+  });
+  const load = async () => {
+    if (loading() || disposed) return;
+    request = new AbortController();
+    setLoading(true);
+    setFailed(false);
+    try {
+      const result = await readCapabilityReviewContent(props.source, { signal: request.signal });
+      if (!result.ok) throw new Error(result.error.message);
+      if (disposed) return;
+      setContent(result.data);
+      props.onLoaded();
+    } catch {
+      if (!disposed) setFailed(true);
+    } finally {
+      if (!disposed) setLoading(false);
+    }
+  };
+  onMount(() => void load());
+  return (
+    <LocaleProvider locale={props.card.locale}>
+      <PanelDialog>
+        <PanelDialog.Header
+          icon={props.card.app.icon}
+          title={t().fullReview}
+          subtitle={props.card.questionText}
+          close={props.close}
+          closeLabel={t().fullReviewClose}
+        />
+        <PanelDialog.Body>
+          <Show
+            when={content()}
+            fallback={
+              <Show when={failed()} fallback={<Placeholder state="loading" title={t().fullReviewLoading} variant="panel" />}>
+                <Placeholder
+                  state="error"
+                  title={t().fullReviewFailed}
+                  variant="panel"
+                  action={
+                    <Button variant="secondary" onClick={() => void load()}>
+                      {t().fullReviewRetry}
+                    </Button>
+                  }
+                />
+              </Show>
+            }
+          >
+            {(value) => (
+              <ReviewPreviewBody
+                card={props.card}
+                full
+                baseRevision={value().baseRevision}
+                model={{
+                  kind: "review",
+                  locale: props.card.locale,
+                  timeZone: props.timeZone,
+                  preview: value(),
+                  slots: {},
+                  consequences: [],
+                }}
+              />
+            )}
+          </Show>
+        </PanelDialog.Body>
+      </PanelDialog>
+    </LocaleProvider>
+  );
+}
+
 /** The thing the question is about, from its review, or an old review's rows and Markdown. */
-export function ActionPreview(props: { card: ActionCard; timeZone: string }) {
+export function ActionPreview(props: { card: ActionCard; timeZone: string; onContentLoaded?: (key: string) => void }) {
   return (
     <>
       <Show when={props.card.preview}>
         {(model) => (
           <Switch>
             <Match when={model().kind === "review" ? (model() as Extract<ActionPreviewModel, { kind: "review" }>) : undefined}>
-              {(review) => <ReviewPreviewBody model={review()} card={props.card} readMore={props.card.readMore} />}
+              {(review) => (
+                <ReviewPreviewBody
+                  model={review()}
+                  card={props.card}
+                  compact={!!props.card.contentRef}
+                  readMore={props.card.contentRef ? undefined : props.card.readMore}
+                />
+              )}
             </Match>
             <Match when={model().kind === "legacy" ? (model() as Extract<ActionPreviewModel, { kind: "legacy" }>) : undefined}>
               {(legacy) => <LegacyPreview model={legacy()} card={props.card} timeZone={props.timeZone} />}
@@ -572,6 +725,41 @@ export function ActionPreview(props: { card: ActionCard; timeZone: string }) {
           </Switch>
         )}
       </Show>
+      <Show when={props.card.contentRef}>
+        {(reference) => (
+          <Chat.Preview>
+            <Button
+              variant="ghost"
+              size="sm"
+              onClick={() => {
+                const card = props.card;
+                const source = reference();
+                void dialogCore.open<void>(
+                  (close) => (
+                    <ReviewContentPanel
+                      card={card}
+                      source={source}
+                      timeZone={props.timeZone}
+                      close={close}
+                      onLoaded={() => props.onContentLoaded?.(`${source.href}:${source.digest}`)}
+                    />
+                  ),
+                  { ...panelDialogOptions, history: true, ariaLabel: actionMessages(card.locale).fullReview },
+                );
+              }}
+            >
+              {actionMessages(props.card.locale).fullReview}
+            </Button>
+            <Show when={props.card.readMore}>
+              {(href) => (
+                <Chat.Preview.ReadMore href={href()}>
+                  {actionMessages(props.card.locale).openIn({ app: props.card.app.name })}
+                </Chat.Preview.ReadMore>
+              )}
+            </Show>
+          </Chat.Preview>
+        )}
+      </Show>
       {/* The review's other links, such as editing the draft, stay one quiet click away before the answer. */}
       <Show when={props.card.links.length > 0 || (!props.card.preview && props.card.readMore)}>
         <Chat.Preview class="cloud-action-preview__links">
@@ -644,6 +832,9 @@ const confirmIcon = (card: ActionCard): string | undefined =>
 
 /** One Assistant question in card v4. An answer collapses it at once to its outcome line, which takes the focus. */
 export function ActionQuestion(props: ActionQuestionProps) {
+  const [loadedContent, setLoadedContent] = createSignal<string>();
+  const needsContent = () => props.card.contentRef && loadedContent() !== `${props.card.contentRef.href}:${props.card.contentRef.digest}`;
+  const unavailable = () => props.unavailable ?? (needsContent() ? actionMessages(props.card.locale).fullReviewRequired : undefined);
   return (
     <LocaleProvider locale={props.card.locale}>
       <Chat.Decision
@@ -652,8 +843,8 @@ export function ActionQuestion(props: ActionQuestionProps) {
         anchorId={props.anchorId}
         sentence={<ActionTextView text={props.card.question} accent={props.card.app.accent} />}
         reason={{ text: props.card.reason.text, icon: props.card.reason.icon, tone: props.card.reason.tone }}
-        unavailable={props.unavailable ? { text: props.unavailable, icon: "ti ti-player-pause", tone: "neutral" } : undefined}
-        preview={<ActionPreview card={props.card} timeZone={props.timeZone} />}
+        unavailable={unavailable() ? { text: unavailable()!, icon: "ti ti-player-pause", tone: "neutral" } : undefined}
+        preview={<ActionPreview card={props.card} timeZone={props.timeZone} onContentLoaded={setLoadedContent} />}
         confirm={{
           label: props.card.confirm.label,
           variant: props.card.confirm.variant,

package/src/ai/chat/action-text.ts

@@ -0,0 +1,288 @@
+import { dates, i18n } from "@k2b/stdlib";
+import { capabilityPersonText, capabilitySentenceText } from "../../_internal/capability-sentences";
+import type { CapabilityAskReason, CapabilityPerson, CapabilitySentence } from "../../contracts/capabilities";
+import { formatBytes } from "../../shared/format";
+import type { ActionCard } from "./action-card";
+import { actionMessages } from "./action-messages";
+
+export type ActionTextRow = { label: string; value: string; format?: "date" | "date-time"; block?: true };
+export type ActionQuestionText = {
+  locale: string;
+  question: string;
+  reason: string;
+  reasonCode: CapabilityAskReason;
+  rows: ActionTextRow[];
+  readMore?: string;
+  confirm: string;
+  decline: string;
+  incomplete: boolean;
+};
+
+const messages = i18n.define({
+  baseLocale: "en",
+  messages: {
+    en: {
+      from: "From",
+      to: "To",
+      cc: "Cc",
+      bcc: "Bcc",
+      subject: "Subject",
+      sendAt: "Send at",
+      warning: "Warning",
+      attachments: "Attachments",
+      text: "Text",
+      when: "When",
+      until: "Until",
+      where: "Where",
+      with: "With",
+      repeats: "Repeats",
+      due: "Due",
+      assignees: "Assignees",
+      status: "Status",
+      checklist: "Checklist",
+      tags: "Tags",
+      folder: "Folder",
+      size: "Size",
+      target: "To",
+      place: "Place",
+      added: "Added",
+      removed: "Removed",
+      starts: "Starts",
+      may: "May",
+      mayAdded: "May (added)",
+      mayRemoved: "May (removed)",
+      also: "Also",
+      readAll: "Read all",
+      title: "Title",
+      name: "Name",
+      note: "Note",
+      before: ({ label }: { label: string }) => `${label} (before)`,
+      more: ({ count }: { count: number }) => `${count.toLocaleString("en")} more`,
+    },
+    de: {
+      from: "Von",
+      to: "An",
+      cc: "Cc",
+      bcc: "Bcc",
+      subject: "Betreff",
+      sendAt: "Senden am",
+      warning: "Warnung",
+      attachments: "Anhänge",
+      text: "Text",
+      when: "Wann",
+      until: "Bis",
+      where: "Wo",
+      with: "Mit",
+      repeats: "Wiederholung",
+      due: "Fällig",
+      assignees: "Zuständig",
+      status: "Status",
+      checklist: "Checkliste",
+      tags: "Tags",
+      folder: "Ordner",
+      size: "Größe",
+      target: "Ziel",
+      place: "Ort",
+      added: "Neu",
+      removed: "Entfernt",
+      starts: "Startet",
+      may: "Darf",
+      mayAdded: "Darf (neu)",
+      mayRemoved: "Darf (entfernt)",
+      also: "Folge",
+      readAll: "Ganz lesen",
+      title: "Titel",
+      name: "Name",
+      note: "Hinweis",
+      before: ({ label }) => `${label} (vorher)`,
+      more: ({ count }) => `${count.toLocaleString("de")} weitere`,
+    },
+  },
+});
+export const checkActionTextMessages = () => messages.check();
+/** The label for a row an old review left without one, where a transport requires labels. */
+export const actionNoteLabel = (locale: string): string => messages.resolve([locale]).t.note;
+
+/** Flatten the question card once. Transport limits and terminal escaping belong to its callers. */
+export const actionCardText = (card: ActionCard): ActionQuestionText => {
+  const t = messages.resolve([card.locale]).t;
+  const rows: ActionTextRow[] = [];
+  let incomplete = Boolean(card.contentRef);
+  const row = (label: string, value: string | undefined, extra: Pick<ActionTextRow, "block" | "format"> = {}) => {
+    if (value !== undefined && value !== "") rows.push({ label, value, ...extra });
+  };
+  const list = (values: string[], more = 0) => {
+    if (more > 0) {
+      incomplete = true;
+      values.push(t.more({ count: more }));
+    }
+    return new Intl.ListFormat(card.locale, { type: "conjunction" }).format(values);
+  };
+  const people = (values: CapabilityPerson[] | undefined, more = 0) => list((values ?? []).map(capabilityPersonText), more);
+  // The thing's own name, unless the question already says it.
+  const named = (label: string, value: string) => {
+    if (!card.questionText.includes(value)) row(label, value);
+  };
+  const model = card.preview;
+  if (model?.kind === "legacy") {
+    rows.push(...model.rows);
+    row(t.text, model.markdown, { block: true });
+  } else if (model?.kind === "review") {
+    const context = { locale: card.locale, timeZone: model.timeZone };
+    const sentence = (value: CapabilitySentence) => capabilitySentenceText(value.text, value.slots ?? model.slots ?? {}, context);
+    const preview = model.preview;
+    if (preview && "truncated" in preview && preview.truncated) incomplete = true;
+    switch (preview?.kind) {
+      case "message":
+        row(t.from, preview.from && capabilityPersonText(preview.from));
+        row(t.to, people(preview.to, preview.more?.to));
+        row(t.cc, people(preview.cc, preview.more?.cc));
+        row(t.bcc, people(preview.bcc, preview.more?.bcc));
+        row(t.subject, preview.subject);
+        row(t.sendAt, preview.sendAt, { format: "date-time" });
+        row(t.warning, preview.warnings?.join(" · "));
+        row(
+          t.attachments,
+          list(
+            (preview.attachments ?? []).map((file) =>
+              file.size === undefined ? file.name : `${file.name} (${formatBytes(file.size, { locale: card.locale })})`,
+            ),
+            preview.moreAttachments,
+          ),
+        );
+        row(t.text, preview.body, { block: true });
+        break;
+      case "event": {
+        named(t.title, preview.title);
+        const dateOnly = (value: string) => /^\d{4}-\d{2}-\d{2}$/.test(value);
+        const allDay = preview.allDay === true || dateOnly(preview.start);
+        // Both ends stay typed, so a device shows them in its own zone. An all-day instant becomes its calendar day
+        // in the card's zone first, so no reader's zone moves it to another day.
+        const day = (value: string) =>
+          dateOnly(value)
+            ? value
+            : new Intl.DateTimeFormat("en-CA", { timeZone: model.timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).format(
+                new Date(value),
+              );
+        const format = allDay ? "date" : "date-time";
+        row(t.when, allDay ? day(preview.start) : preview.start, { format });
+        if (preview.end) row(t.until, allDay ? day(preview.end) : preview.end, { format });
+        row(t.where, [preview.place, preview.location].filter(Boolean).join(" · "));
+        row(t.with, people(preview.attendees));
+        row(t.repeats, preview.recurrence);
+        row(t.text, preview.description, { block: true });
+        break;
+      }
+      case "task":
+        named(t.title, preview.title);
+        row(t.place, preview.place);
+        row(t.due, preview.due, { format: /^\d{4}-\d{2}-\d{2}$/.test(preview.due ?? "") ? "date" : "date-time" });
+        row(t.assignees, people(preview.assignees));
+        row(t.status, preview.status);
+        row(t.checklist, preview.checklist?.map((item) => `${item.done ? "☑" : "☐"} ${item.label}`).join(" · "));
+        row(t.tags, preview.tags?.join(", "));
+        row(t.text, preview.description, { block: true });
+        break;
+      case "file":
+        named(t.name, preview.name);
+        row(t.folder, preview.place ?? preview.path);
+        row(t.size, preview.size === undefined ? undefined : formatBytes(preview.size, { locale: card.locale }));
+        row(t.target, preview.to);
+        break;
+      case "page":
+        named(t.title, preview.title);
+        row(t.place, preview.place);
+        row(t.text, preview.body, { block: true });
+        for (const change of preview.changes ?? []) row(change.change === "added" ? t.added : t.removed, change.text);
+        break;
+      case "rule":
+        row(t.starts, sentence(preview.when));
+        row(t.text, preview.does, { block: true });
+        for (const may of preview.may)
+          row(may.mark === "added" ? t.mayAdded : may.mark === "removed" ? t.mayRemoved : t.may, sentence(may));
+        // The card's fixed line: a routine knows only its instruction, never this chat.
+        if (!preview.seesChat) row(t.note, actionMessages(card.locale).ruleBlindToChat);
+        break;
+      case "fields":
+        for (const field of preview.rows) {
+          rows.push({ label: field.label, value: field.value, ...(field.format ? { format: field.format } : {}) });
+          if (field.before !== undefined)
+            rows.push({ label: t.before({ label: field.label }), value: field.before, ...(field.format ? { format: field.format } : {}) });
+        }
+        break;
+    }
+    for (const consequence of model.consequences)
+      row(consequence.mark === "added" ? t.added : consequence.mark === "removed" ? t.removed : t.also, consequence.plain);
+  }
+  // A long question shortens slot values and names at most three people of a slot, then "N more". The text is
+  // complete only when the question or a row shows each value whole; people the app left out are never shown.
+  const shown = [card.questionText, ...rows.map((entry) => entry.value)];
+  const whole = (value: string) => shown.some((text) => text.includes(value));
+  const typed = (value: string, format: "date" | "date-time") =>
+    rows.some((entry) => entry.value === value && (entry.format === "date-time" || entry.format === format));
+  if (
+    card.slotValues?.unlisted ||
+    card.slotValues?.values.some((value) => !whole(value)) ||
+    card.slotValues?.times.some(
+      (time) => !whole(time.text) && !(typed(time.start, time.format) && (!time.end || typed(time.end, time.format))),
+    )
+  )
+    incomplete = true;
+  return {
+    locale: card.locale,
+    question: card.questionText,
+    reason: card.reason.text,
+    reasonCode: card.reason.code,
+    rows,
+    ...(card.readMore ? { readMore: card.readMore } : {}),
+    confirm: card.confirm.label,
+    decline: card.decline,
+    incomplete,
+  };
+};
+
+/** The CLI's plain question block, before terminal-safe sanitizing at the CLI boundary. */
+export const actionQuestionLines = (
+  text: ActionQuestionText,
+  extra: { origin?: string; commands?: { approve: string; reject: string }; timeZone: string },
+): string[] => {
+  const t = messages.resolve([text.locale]).t;
+  const lines = [`? ${text.question}`, `  ${text.reason}`];
+  if (extra.origin) lines.push(`  ${extra.origin}`);
+  const width = Math.max(0, ...text.rows.filter((row) => !row.block && row.label).map((row) => Array.from(row.label).length + 1));
+  let markedIncomplete = false;
+  for (const row of text.rows) {
+    if (row.block) {
+      const body = row.value.split(/\r?\n/);
+      // Cut a long text only when "Read all" can open the whole thing; otherwise the terminal shows all of it.
+      const shown = text.readMore ? body.slice(0, 8) : body;
+      lines.push(...shown.map((line) => `  ${line}`));
+      if (shown.length < body.length || (text.incomplete && !markedIncomplete)) {
+        lines.push("  …");
+        markedIncomplete = true;
+      }
+      continue;
+    }
+    const options = { locale: text.locale, timeZone: extra.timeZone };
+    const value =
+      row.format === "date-time"
+        ? dates.formatDateTime(row.value, options)
+        : row.format === "date"
+          ? dates.formatDate(/^\d{4}-\d{2}-\d{2}$/.test(row.value) ? `${row.value}T12:00:00.000Z` : row.value, {
+              ...options,
+              ...(/^\d{4}-\d{2}-\d{2}$/.test(row.value) ? { timeZone: "UTC" } : {}),
+            })
+          : row.value;
+    lines.push(row.label ? `  ${(row.label + ":").padEnd(width)} ${value}` : `  ${value}`);
+  }
+  if (text.incomplete && !markedIncomplete) lines.push("  …");
+  if (text.readMore) lines.push(`  ${t.readAll}: ${text.readMore}`);
+  if (extra.commands) {
+    const width = Math.max(Array.from(text.confirm).length, Array.from(text.decline).length) + 1;
+    lines.push(
+      `  ${(text.confirm + ":").padEnd(width)} ${extra.commands.approve}`,
+      `  ${(text.decline + ":").padEnd(width)} ${extra.commands.reject}`,
+    );
+  }
+  return lines;
+};

package/src/ai/chat/tool-action-words.ts

@@ -0,0 +1,31 @@
+import { capabilityUnknownText } from "../../_internal/capability-sentences";
+import type { AiTurnBlock } from "../protocol";
+import { toolOutcome } from "../tool-wording";
+import { isRecord } from "./message-utils";
+import { aiChatMessages } from "./messages";
+
+type ToolBlock = Extract<AiTurnBlock, { kind: "tool" }>;
+
+/** The application's own short summary of a result, if it fits on one line. */
+const resultSummary = (block: ToolBlock): string | undefined => {
+  const value = isRecord(block.result) ? block.result.summary : undefined;
+  return typeof value === "string" && value.trim() && value.trim().length <= 500 ? value.trim() : undefined;
+};
+
+/** The words of a call without an app sentence: Cloud's frames around its catalog sentence or title. */
+export const legacyOutcomeWords = (block: ToolBlock, locale: string, timeZone: string) => (subject: string) => {
+  const t = aiChatMessages(locale);
+  const capability = block.presentation?.kind === "capability";
+  return {
+    running: t.receiptRunning({ title: subject }),
+    // The app's done sentence, else its own summary of the call, else Cloud's frame.
+    done:
+      toolOutcome(block, "done", locale, timeZone) ??
+      resultSummary(block) ??
+      (capability ? t.receiptDone({ title: subject }) : t.receiptApproved({ title: subject })),
+    rejected: toolOutcome(block, "rejected", locale, timeZone) ?? t.receiptRejected({ title: subject }),
+    notRun: toolOutcome(block, "notRun", locale, timeZone) ?? t.receiptNotRun({ title: subject, stopped: false }),
+    unknown: capabilityUnknownText(subject, locale),
+    unknownStill: capabilityUnknownText(subject, locale, true),
+  };
+};