@cueplusplus/ui 0.20.0 → 0.21.0

package/manifest/components/question-card.json

@@ -0,0 +1,157 @@
+{
+  "name": "QuestionCard",
+  "slug": "question-card",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "An agent's free-text question, answered in place.\n\nThe answer is the caller's to deliver. The card reports it through\n`onAnswer` and says where it has got to from `delivery`: on its way, arrived,\nor not arrived. It never claims more than that.",
+  "props": [
+    {
+      "name": "question",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "What the agent asked, in its own words. It also names the answer field.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "context",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "A supporting line under the question: who is asking, or why.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "The field's resting text. Defaults to `QUESTION_LABELS.placeholder`.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "answer",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "The answer as the caller holds it. Drawn as sent while `delivery` is\n`sending` or `sent`, and put back in the field when it is `failed`, so a\nretry is one press.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "delivery",
+      "type": "\"failed\" | \"sending\" | \"sent\"",
+      "required": false,
+      "defaultValue": null,
+      "description": "Where the answer has got to: `sending`, `sent` or `failed`. Unset while\nthe question is still waiting on the person.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "failed",
+          "sending",
+          "sent"
+        ]
+      }
+    },
+    {
+      "name": "onAnswer",
+      "type": "((answer: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called with the typed answer, trimmed, when the person sends it.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "onDismiss",
+      "type": "(() => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when the person skips the question. Skip is drawn only when this is set.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "labels",
+      "type": "Partial<QuestionLabels>",
+      "required": false,
+      "defaultValue": null,
+      "description": "Replace any of the card's own copy.",
+      "control": {
+        "kind": "opaque"
+      }
+    }
+  ],
+  "typeReferences": [
+    "Omit<React.ComponentPropsWithoutRef<\"div\">, \"children\" | \"onSubmit\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-focus",
+    "--cue-focus-ring",
+    "--cue-radius-overlay",
+    "--cue-radius-surface",
+    "--cue-style-focus-width",
+    "--cue-surface-1",
+    "--cue-surface-2",
+    "--cue-text-body",
+    "--cue-text-ui"
+  ],
+  "summary": "An agent's free-text question, answered in place, with where the answer has got to.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { QuestionCard } from \"@cueplusplus/ui/elements\";\n\n<QuestionCard\n  question=\"Which branch should I deploy?\"\n  context=\"Asked by the release agent\"\n  onAnswer={(text) => reply(request.id, text)}\n/>\n// While the answer travels, the card shows it and takes no other.\n<QuestionCard question=\"Which branch?\" answer=\"main\" delivery=\"sending\" />",
+      "language": "tsx"
+    }
+  ],
+  "status": "stable",
+  "url": "/docs/components/question-card",
+  "mdUrl": "/docs/components/question-card.md",
+  "jsonUrl": "/r/components/question-card.json",
+  "whenToUse": [
+    "An agent asking something whose answer is a sentence: which branch, what to call the release, what the user meant.",
+    "Relaying a remote agent, where the answer can be on its way, arrive, or fail. `delivery` says which."
+  ],
+  "whenNotToUse": [
+    "A question with typed fields, such as a repository, a toggle or a choice. `ElicitationForm` draws those.",
+    "A yes or no about running something. `ApprovalCard` draws the decision as buttons."
+  ],
+  "commonMistakes": [
+    "Setting `delivery` to `sent` and treating the question as answered by the agent. Sent says the answer arrived, nothing more.",
+    "Dropping `answer` when delivery fails. Pass it back, and the field holds it again so the retry is one press."
+  ],
+  "specimens": [
+    {
+      "title": "QuestionCard",
+      "group": "elements",
+      "components": [
+        "QuestionCard"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"asking\" wide>\n    <LiveQuestion />\n  </Specimen>\n  <Specimen label=\"sending\" wide>\n    <QuestionCard\n      question=\"Which universe holds the house lights?\"\n      answer=\"Universe 1, channels 1 to 12\"\n      delivery=\"sending\"\n    />\n  </Specimen>\n  <Specimen label=\"not sent\" wide>\n    <QuestionCard\n      question=\"Which universe holds the house lights?\"\n      answer=\"Universe 1, channels 1 to 12\"\n      delivery=\"failed\"\n      onAnswer={() => {}}\n    />\n  </Specimen>\n</Specimens>",
+      "note": "An agent's free-text question, answered in place. The answer is the caller's to deliver: the card reports it and says where it has got to. While it travels the card shows it and takes no other, and a failed delivery keeps what was typed, so sending again is one press.",
+      "interaction": "type an answer and press Enter to send it; Shift+Enter breaks the line. The first card is live and shows its answer as sent. Skip is drawn only when the question can be skipped."
+    }
+  ]
+}

package/manifest/components/resizable.json

@@ -7,7 +7,7 @@
     "react-resizable-panels"
   ],
   "clientOnly": true,
-  "description": "Split panes the user can drag, on `react-resizable-panels`.\n\n`react-resizable-panels` is an **optional peer**: import this from\n`@cueplusplus/ui/layout/resizable`, never from the core barrel, so an app\nwith no split view never installs one.",
+  "description": "Split panes the user can drag, on `react-resizable-panels`.\n\n`react-resizable-panels` is an **optional peer**: import this from\n`@cueplusplus/ui/layout/resizable`, never from the core barrel, so an app\nwith no split view never installs one. For one seam beside one pane,\n`PaneSeam` in the core barrel needs no peer at all.",
   "props": [],
   "typeReferences": [],
   "subcomponents": [

package/manifest/components/reveal.json

@@ -66,7 +66,9 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [],
+  "tokensUsed": [
+    "--cue-reveal-distance"
+  ],
   "summary": "Content that rises into place the first time it scrolls into view, once — cueplusplus.com's section entrance, with an optional stagger over the items you mark.",
   "examples": [
     {

package/manifest/components/split-pane.json

@@ -0,0 +1,224 @@
+{
+  "name": "SplitPane",
+  "slug": "split-pane",
+  "group": "layout",
+  "importPath": "@cueplusplus/ui",
+  "peerDependencies": [],
+  "clientOnly": true,
+  "description": "A list beside its detail, which stacks into a drill-in when narrow (#102).\n\nThe master-detail opinion on top of {@link PaneSeam}. Side by side while\nthe detail would be at least twice the list, measured on the frame rather\nthan the window, so it works in any column. Below that it stacks the way a\nphone does: the list, or the detail with a Back button, and Escape inside the\ndetail goes back too. `detailOpen` says which shows; selection and the list's\nown keyboard stay with the list.\n\nThe frame measures itself with a `ResizeObserver` and draws side by side\nuntil it has, so a server render and a browser without one get the split.",
+  "props": [
+    {
+      "name": "list",
+      "type": "ReactNode",
+      "required": true,
+      "defaultValue": null,
+      "description": "The master: a list of rows, a tree, a feed. It owns its own keyboard.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
+    },
+    {
+      "name": "detail",
+      "type": "ReactNode",
+      "required": true,
+      "defaultValue": null,
+      "description": "The detail for whatever the list has selected.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
+    },
+    {
+      "name": "listLabel",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "What the list is, in a word or two: `events`. It names the seam (`Resize\nthe events`), the Back button (`Back to events`) and the fold (`Hide\nevents`), so each control says what it acts on.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "listSize",
+      "type": "number",
+      "required": false,
+      "defaultValue": null,
+      "description": "The list's width in pixels, when the caller holds it.",
+      "control": {
+        "kind": "number"
+      }
+    },
+    {
+      "name": "defaultListSize",
+      "type": "number",
+      "required": false,
+      "defaultValue": "320",
+      "description": "The list's starting width when nothing controls it. Defaults to 320.",
+      "control": {
+        "kind": "number"
+      }
+    },
+    {
+      "name": "onListSizeChange",
+      "type": "((size: number) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called with every new list width, clamped to `minListSize` and `maxListSize`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "minListSize",
+      "type": "number",
+      "required": false,
+      "defaultValue": "200",
+      "description": "The narrowest the list may be dragged, in pixels. Defaults to 200.",
+      "control": {
+        "kind": "number"
+      }
+    },
+    {
+      "name": "maxListSize",
+      "type": "number",
+      "required": false,
+      "defaultValue": "480",
+      "description": "The widest the list may be dragged, in pixels. Defaults to 480.",
+      "control": {
+        "kind": "number"
+      }
+    },
+    {
+      "name": "stackBelow",
+      "type": "number",
+      "required": false,
+      "defaultValue": null,
+      "description": "The frame width, in pixels, below which the panes stack. Unset, they stack\nonce the detail would be narrower than twice the list.",
+      "control": {
+        "kind": "number"
+      }
+    },
+    {
+      "name": "detailOpen",
+      "type": "boolean",
+      "required": false,
+      "defaultValue": "false",
+      "description": "Which pane shows when stacked: the detail when `true`, the list when not.\nSide by side, both always show.",
+      "control": {
+        "kind": "boolean"
+      }
+    },
+    {
+      "name": "onBack",
+      "type": "(() => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called by the stacked detail's Back button and by Escape inside it.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "collapsible",
+      "type": "boolean",
+      "required": false,
+      "defaultValue": "false",
+      "description": "Whether the list can fold to a thin tab while side by side.",
+      "control": {
+        "kind": "boolean"
+      }
+    },
+    {
+      "name": "collapsed",
+      "type": "boolean",
+      "required": false,
+      "defaultValue": null,
+      "description": "Whether the list is folded, when the caller holds it.",
+      "control": {
+        "kind": "boolean"
+      }
+    },
+    {
+      "name": "defaultCollapsed",
+      "type": "boolean",
+      "required": false,
+      "defaultValue": "false",
+      "description": "Whether the list starts folded when nothing controls it.",
+      "control": {
+        "kind": "boolean"
+      }
+    },
+    {
+      "name": "onCollapsedChange",
+      "type": "((collapsed: boolean) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when the list folds (`true`) or opens (`false`).",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    }
+  ],
+  "typeReferences": [
+    "Omit<React.ComponentPropsWithoutRef<\"div\">, \"children\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-focus",
+    "--cue-focus-ring",
+    "--cue-radius-control",
+    "--cue-space-1",
+    "--cue-space-2",
+    "--cue-space-6",
+    "--cue-style-focus-width",
+    "--cue-surface-2",
+    "--cue-text-ui"
+  ],
+  "summary": "A list beside its detail, stacking into a drill-in with Back when the frame is narrow.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "const [selected, setSelected] = React.useState<string | null>(null);\n\n<SplitPane\n  listLabel=\"events\"\n  list={<EventFeed events={events} selectedId={selected} onSelect={setSelected} />}\n  detail={selected ? <EventDetail id={selected} /> : <EmptyState title=\"Pick an event\" />}\n  detailOpen={selected !== null}\n  onBack={() => setSelected(null)}\n  collapsible\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "stable",
+  "url": "/docs/components/split-pane",
+  "mdUrl": "/docs/components/split-pane.md",
+  "jsonUrl": "/r/components/split-pane.json",
+  "whenToUse": [
+    "A list and an inspector: events, logs, jobs, an inbox, an MCP catalogue.",
+    "One layout for a wide console and a narrow column. It measures its own frame, so it stacks inside a sidebar as readily as on a phone."
+  ],
+  "whenNotToUse": [
+    "Two panes that are equals rather than a list and its detail. Use `Resizable`.",
+    "A single side pane with no stacking. `PaneSeam` alone is lighter."
+  ],
+  "commonMistakes": [
+    "Leaving `detailOpen` true with nothing selected. When stacked, it decides which pane shows, so tie it to the selection.",
+    "Omitting `onBack`. When stacked, Back and Escape are the only ways out of the detail, and both call it.",
+    "A `listLabel` that is a sentence. It is spliced into three controls (`Resize the …`, `Back to …`, `Hide …`), so give it a noun: `events`."
+  ],
+  "specimens": [
+    {
+      "title": "SplitPane",
+      "group": "layout",
+      "components": [
+        "SplitPane"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"side by side\" wide>\n    <SplitPane\n      listLabel=\"cues\"\n      defaultListSize={180}\n      minListSize={140}\n      maxListSize={260}\n      collapsible\n      detailOpen={cue !== null}\n      onBack={() => setCue(null)}\n      list={cueList}\n      detail={cueDetail}\n      className=\"h-[11rem] w-full max-w-[36rem] overflow-hidden rounded-(--radius-surface) border border-border\"\n    />\n  </Specimen>\n  <Specimen label=\"stacked, under twice the list\" wide>\n    <SplitPane\n      listLabel=\"cues\"\n      defaultListSize={180}\n      detailOpen={cue !== null}\n      onBack={() => setCue(null)}\n      list={cueList}\n      detail={cueDetail}\n      className=\"h-[11rem] w-full max-w-[22rem] overflow-hidden rounded-(--radius-surface) border border-border\"\n    />\n  </Specimen>\n</Specimens>",
+      "note": "A list beside its detail, on PaneSeam. Side by side while the detail is at least twice the list, measured on the frame, not the window; below that it stacks like a phone, the list or the detail with Back. Both specimens share one selection: the wide one splits, and the narrow one is the same split stacked.",
+      "interaction": "pick a cue. In the narrow frame that opens the detail, and Back or Escape returns to the list. In the wide frame drag or arrow the seam, or fold the list to its tab with the chevron."
+    }
+  ]
+}

package/manifest/components/tool-call.json

@@ -62,13 +62,58 @@
     {
       "name": "running",
       "type": "boolean",
-      "required": true,
+      "required": false,
       "defaultValue": null,
       "description": "When true a spinner replaces the success check on the trigger.",
       "control": {
         "kind": "boolean"
       }
     },
+    {
+      "name": "state",
+      "type": "\"done\" | \"failed\" | \"running\" | \"refused\"",
+      "required": false,
+      "defaultValue": null,
+      "description": "Where the call got to: `running`, `done`, `failed` or `refused`. Each settled\nstate ends the row with its own mark. Supersedes `running`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "done",
+          "failed",
+          "running",
+          "refused"
+        ]
+      }
+    },
+    {
+      "name": "variant",
+      "type": "\"inline\" | \"card\"",
+      "required": false,
+      "defaultValue": "card",
+      "description": "`card` (the default) or `inline`, a denser row that spans its column, for a\ntranscript of many calls.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "inline",
+          "card"
+        ]
+      }
+    },
+    {
+      "name": "absence",
+      "type": "\"none\" | \"refused\" | \"unanswered\"",
+      "required": false,
+      "defaultValue": null,
+      "description": "What an empty `result` means: `none` (it returned nothing), `refused` or\n`unanswered`. Read only when `result` is empty.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "none",
+          "refused",
+          "unanswered"
+        ]
+      }
+    },
     {
       "name": "open",
       "type": "boolean",
@@ -113,7 +158,6 @@
     "--cue-focus",
     "--cue-focus-ring",
     "--cue-font-mono",
-    "--cue-ok",
     "--cue-radius-control",
     "--cue-radius-overlay",
     "--cue-style-focus-width",

package/manifest/components/tool-group.json

@@ -50,10 +50,24 @@
         "kind": "callback",
         "fixture": "callback.log"
       }
+    },
+    {
+      "name": "variant",
+      "type": "\"inline\" | \"card\"",
+      "required": false,
+      "defaultValue": "card",
+      "description": "`card` (the default) or `inline`, a row in its column without the paper, for a\ntranscript of many groups.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "inline",
+          "card"
+        ]
+      }
     }
   ],
   "typeReferences": [
-    "Omit<\n  ComponentProps<\"div\">,\n  \"children\" | \"label\" | \"tools\" | \"open\" | \"onOpenChange\"\n> & {\n  /** What the group did, as one line. */\n  label: string;\n  /**\n   * Calls issued together. The header summarizes them: progress while any run,\n   * failures if any failed, otherwise the count.\n   */\n  tools: readonly GroupedTool[];\n  /** Whether the per-call list is expanded. */\n  open: boolean;\n  /** Called when the group is expanded or collapsed. */\n  onOpenChange?: (open: boolean) => void;\n}"
+    "Omit<\n  ComponentProps<\"div\">,\n  \"children\" | \"label\" | \"tools\" | \"open\" | \"onOpenChange\"\n> & {\n  /** What the group did, as one line. */\n  label: string;\n  /**\n   * Calls issued together. The header summarizes them: progress while any run,\n   * failures if any failed, otherwise the count.\n   */\n  tools: readonly GroupedTool[];\n  /** Whether the per-call list is expanded. */\n  open: boolean;\n  /** Called when the group is expanded or collapsed. */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * `card` (the default) or `inline`, a row in its column without the paper, for a\n   * transcript of many groups.\n   */\n  variant?: \"card\" | \"inline\";\n}"
   ],
   "subcomponents": [],
   "parts": [],
@@ -61,10 +75,8 @@
   "defaultVariants": {},
   "tokensUsed": [
     "--cue-border",
-    "--cue-danger",
     "--cue-fg-muted",
     "--cue-fg-subtle",
-    "--cue-ok",
     "--cue-radius-overlay",
     "--cue-surface-1",
     "--cue-text-body"

package/manifest/components/unsupported-request-card.json

@@ -0,0 +1,117 @@
+{
+  "name": "UnsupportedRequestCard",
+  "slug": "unsupported-request-card",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "A request this client cannot answer, said plainly, with no answer offered.",
+  "props": [
+    {
+      "name": "title",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "What the agent asked for, in its words: `Pick a file`, `Open a browser`.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "kind",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "The request's kind as the protocol names it, printed in mono so it can be reported.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "detail",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "A supporting line: which agent asked, or what it was doing.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "onDismiss",
+      "type": "(() => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when the person clears the card. Dismiss is drawn only when this is set.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
+    },
+    {
+      "name": "labels",
+      "type": "Partial<UnsupportedRequestLabels>",
+      "required": false,
+      "defaultValue": null,
+      "description": "Replace any of the card's own copy.",
+      "control": {
+        "kind": "opaque"
+      }
+    }
+  ],
+  "typeReferences": [
+    "Omit<React.ComponentPropsWithoutRef<\"div\">, \"children\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-radius-overlay",
+    "--cue-radius-surface",
+    "--cue-surface-1",
+    "--cue-surface-2",
+    "--cue-text-body",
+    "--cue-text-ui"
+  ],
+  "summary": "A request this app cannot answer, said plainly, with no answer offered.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { UnsupportedRequestCard } from \"@cueplusplus/ui/elements\";\n\n<UnsupportedRequestCard\n  title=\"Pick a file\"\n  kind=\"file-picker\"\n  detail=\"Asked by the coding agent\"\n  onDismiss={() => dismiss(request.id)}\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "stable",
+  "url": "/docs/components/unsupported-request-card",
+  "mdUrl": "/docs/components/unsupported-request-card.md",
+  "jsonUrl": "/r/components/unsupported-request-card.json",
+  "whenToUse": [
+    "An agent request your client has no way to fulfil: a file picker, a browser session, or a request kind newer than the client.",
+    "Keeping the transcript honest. The request stays visible, and `kind` names it so the person can report it."
+  ],
+  "whenNotToUse": [
+    "A request you can answer but have not built yet. Answer it with `ApprovalCard`, `QuestionCard` or `ElicitationForm` rather than calling it unsupported."
+  ],
+  "commonMistakes": [
+    "Drawing an unsupported request as an approval or a question. A button the client cannot deliver is a false statement.",
+    "Leaving `kind` off. It is the one detail the person can pass on to whoever runs the agent."
+  ],
+  "specimens": [
+    {
+      "title": "UnsupportedRequestCard",
+      "group": "elements",
+      "components": [
+        "UnsupportedRequestCard"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"with dismiss\" wide>\n    <UnsupportedRequestCard\n      title=\"Pick a show file\"\n      kind=\"file-picker\"\n      detail=\"Asked by the patcher\"\n      onDismiss={() => {}}\n    />\n  </Specimen>\n  <Specimen label=\"nothing to press\" wide>\n    <UnsupportedRequestCard title=\"Open a browser\" kind=\"browser-session\" />\n  </Specimen>\n</Specimens>",
+      "note": "A request this app cannot answer, said plainly and with nothing offered. A card drawn as an approval or a question would invite an answer nothing can deliver. The request's kind is printed in mono, so a reader can name it to whoever runs the agent.",
+      "interaction": "Dismiss is drawn only when the caller can clear the card."
+    }
+  ]
+}

package/manifest/fixtures.json

@@ -686,6 +686,22 @@
         "readonly QueuedFollowUp[]"
       ]
     },
+    {
+      "id": "agents.feed",
+      "kind": "array",
+      "label": "5 run events",
+      "accepts": [
+        "readonly FeedEvent[]"
+      ]
+    },
+    {
+      "id": "agents.feed-event",
+      "kind": "opaque",
+      "label": "One run event",
+      "accepts": [
+        "FeedEvent"
+      ]
+    },
     {
       "id": "composer.attachment",
       "kind": "opaque",