@aleph-alpha/lib-mcp 2.2.0 → 4.0.0

package/chat-kit-components-meta.json

@@ -1,6 +1,6 @@
 {
   "CkAgentMessage": {
-    "description": "Layout for a single assistant (agent) turn in a conversation. Exposes `icon`, `header`, default content and `footer` slots for full control over each section while keeping consistent spacing and alignment.",
+    "description": "Layout for a single assistant (agent) turn in a conversation. Exposes a full-width `header`, default content and `footer` slots for full control over each section while keeping consistent spacing and alignment. The agent icon now lives inside the header (see `CkAgentMessageHeader`), so the `header` slot spans the entire width.",
     "category": "Messages",
     "useCases": [
       "render assistant reply",
@@ -20,16 +20,129 @@
     "related": [
       "CkUserMessage",
       "CkConversation",
+      "CkAgentMessageHeader",
       "CkMarkdownRenderer",
-      "CkCopyMessageActionButton"
+      "CkCopyMessageButton"
+    ],
+    "props": [
+      "bottomSeparator"
     ],
-    "props": [],
     "examples": [
       "Default",
+      "WithActivityHeader",
       "WithFooterActions",
-      "WithRichContent",
-      "WithCustomHeader",
-      "WithoutIcon"
+      "WithoutHeader",
+      "WithoutBottomSeparator",
+      "WithCitations"
+    ],
+    "_autoGenerated": true
+  },
+  "CkAgentMessageHeader": {
+    "description": "Full-width header row for an assistant (agent) message. Owns the agent icon, a header text and an optional activity button, and is intended to be passed into the `header` slot of `CkAgentMessage`. It has two visual states, driven purely by whether the `activity` slot is provided: - **with `activity`** — vertical padding and a bottom border separate the header from the message body; - **without `activity`** — a compact icon + text row with no padding or border. Slots: `icon` (leading agent avatar/icon), default (header text, ellipsised on overflow), `activity` (typically a `CkHeaderActivityButton`).",
+    "category": "Messages",
+    "useCases": [
+      "agent message header",
+      "assistant turn header",
+      "chain-of-thought summary row",
+      "activity indicator row"
+    ],
+    "keywords": [
+      "agent",
+      "assistant",
+      "message",
+      "header",
+      "icon",
+      "activity",
+      "conversation"
+    ],
+    "related": [
+      "CkAgentMessage",
+      "CkHeaderActivityButton",
+      "CkConversation"
+    ],
+    "props": [],
+    "examples": [
+      "WithActivityButton",
+      "WithoutActivityButton"
+    ],
+    "_autoGenerated": true
+  },
+  "CkCitation": {
+    "description": "An inline citation marker — the numbered chip rendered in place of a `[n]` reference inside an assistant answer. On hover, or when activated by keyboard (Enter/Space) or click, it reveals a `CkCitationCard` describing the source. The marker shows the bare source number (no brackets). Activating the card's external-link action re-emits `open-source` so the host can open the (possibly auth-proxied) source URL.",
+    "category": "Data Display",
+    "useCases": [
+      "inline citation in assistant reply",
+      "numbered source reference",
+      "hover to preview the cited file/page"
+    ],
+    "keywords": [
+      "citation",
+      "source",
+      "reference",
+      "inline",
+      "marker",
+      "footnote",
+      "number",
+      "hover",
+      "popover"
+    ],
+    "related": [
+      "CkCitationCard",
+      "CkMarkdownRenderer",
+      "CkAgentMessage"
+    ],
+    "props": [],
+    "examples": [
+      "Default",
+      "Selected",
+      "InlineInText",
+      "MultiDigitIndex",
+      "WithoutLink",
+      "LongFileName",
+      "WithoutLocation",
+      "SourceTypes"
+    ],
+    "_autoGenerated": true
+  },
+  "CkCitationCard": {
+    "description": "The floating card that describes a single citation source: the source file, the cited excerpt, an optional location (e.g. page), and an optional external-link action. Rendered as the hover/focus content of `CkCitation`, but usable on its own wherever a source preview is needed. Purely presentational and prop-driven. The external-link action is exposed as an `open-source` event rather than a plain link, because the source URL is often auth-proxied and cannot be navigated to directly.",
+    "category": "Data Display",
+    "useCases": [
+      "citation source preview",
+      "hover card for an inline reference",
+      "show the cited file/page/excerpt"
+    ],
+    "keywords": [
+      "citation",
+      "source",
+      "card",
+      "popover",
+      "reference",
+      "file",
+      "page",
+      "excerpt",
+      "preview"
+    ],
+    "related": [
+      "CkCitation",
+      "CkMarkdownRenderer",
+      "CkAgentMessage"
+    ],
+    "props": [
+      "fileName",
+      "snippet",
+      "locationLabel",
+      "url",
+      "openSourceLabel"
+    ],
+    "examples": [
+      "Default",
+      "WithoutLink",
+      "WithoutLocation",
+      "MinimalSnippetOnly",
+      "LongFileName",
+      "LongSnippet",
+      "FileTypeVariants"
     ],
     "_autoGenerated": true
   },
@@ -66,7 +179,7 @@
     ],
     "_autoGenerated": true
   },
-  "CkCopyMessageActionButton": {
+  "CkCopyMessageButton": {
     "description": "Copy-to-clipboard action button for chat messages. Shows a check icon and announces success for assistive technologies, then reverts after a delay.",
     "category": "Actions",
     "useCases": [
@@ -85,7 +198,7 @@
       "feedback"
     ],
     "related": [
-      "CkMessageActionButton",
+      "CkMessageButton",
       "CkAgentMessage",
       "CkConversation"
     ],
@@ -103,6 +216,44 @@
     ],
     "_autoGenerated": true
   },
+  "CkDropZoneOverlay": {
+    "description": "Full-window drag-and-drop overlay. Listens for file drags anywhere on the page, reveals a teleported overlay, validates dropped files against `accept`, `maxFileSizeBytes` and `maxFiles`, and emits the accepted files. Purely presentational and self-contained: it owns its own drag state and has no knowledge of the host app. All limits and copy are configurable, and rejection handling can be delegated to the consumer via the `rejected` event.",
+    "category": "Form Inputs",
+    "useCases": [
+      "page-level file attachment",
+      "drag-and-drop upload",
+      "chat composer"
+    ],
+    "keywords": [
+      "drag and drop",
+      "drop zone",
+      "file upload",
+      "overlay",
+      "attachments",
+      "drop",
+      "zone"
+    ],
+    "related": [
+      "CkFileItemsList",
+      "CkPromptInput"
+    ],
+    "props": [
+      "accept",
+      "maxFileSizeBytes",
+      "maxFiles",
+      "disabled",
+      "heading",
+      "hint",
+      "ariaLabel",
+      "showErrors",
+      "errorTimeoutMs"
+    ],
+    "examples": [
+      "Default",
+      "SingleFile"
+    ],
+    "_autoGenerated": true
+  },
   "CkFeedbackButton": {
     "description": "Binary thumbs up / thumbs down feedback control for assistant messages. Fully prop-driven: the host application owns the selection and lock state and decides when (or if) to persist it to a backend. Labels default to those provided by `useChatKitLabels` (which can be translated via `provideChatKitLabels`). The `ariaLabel*` props override the injected labels on a per-instance basis when set.",
     "category": "Feedback",
@@ -125,8 +276,8 @@
       "button"
     ],
     "related": [
-      "CkMessageActionButton",
-      "CkCopyMessageActionButton",
+      "CkMessageButton",
+      "CkCopyMessageButton",
       "CkAgentMessage",
       "CkConversation"
     ],
@@ -149,7 +300,7 @@
     "_autoGenerated": true
   },
   "CkFeedbackDialog": {
-    "description": "Modal dialog for collecting qualitative feedback on an assistant response. Opened after a binary thumbs-up / thumbs-down click (see `CkFeedbackButton`), it lets the user pick a single reason code and add an optional free-text comment, then submit both alongside the original sentiment. One reason per submission: the backend (feedback-kit) stores a single `reason` enum per response, so the dialog is single-select by design. Fully prop-driven: the host application owns `open`, the list of reasons to show (fetched from `GET /feedback/config`), the response text to display, and the submission handler. The component only manages transient form state (the selected reason and free-text value) until the user submits or cancels. capture a free-text comment, drive a two-step rating flow rating, comment CkConversation, UiDialog, UiToggleGroup",
+    "description": "Modal dialog for collecting qualitative feedback on an assistant response. Opened after a binary thumbs-up / thumbs-down click (see `CkFeedbackButton`), it lets the user pick one or more reason codes and add an optional free-text comment, then submit them alongside the original sentiment. Multiple reasons per submission: the backend (feedback-kit) stores a list of reason codes per response (each becomes its own categorical score), so the chips are multi-select. Fully prop-driven: the host application owns `open`, the list of reasons to show (fetched from `GET /feedback/config`), the response text to display, and the submission handler. The component only manages transient form state (the selected reasons and free-text value) until the user submits or cancels. capture a free-text comment, drive a two-step rating flow rating, comment CkConversation, UiDialog, UiToggleGroup",
     "category": "Feedback",
     "useCases": [
       "collect qualitative feedback",
@@ -165,7 +316,7 @@
     ],
     "related": [
       "CkFeedbackButton",
-      "CkMessageActionButton",
+      "CkMessageButton",
       "CkAgentMessage"
     ],
     "props": [
@@ -191,12 +342,13 @@
       "Negative",
       "NoResponseColumn",
       "Submitting",
+      "LongResponse",
       "WithFeedbackButton"
     ],
     "_autoGenerated": true
   },
   "CkFileItemsList": {
-    "description": "Horizontal list of file attachments; collapses to a popover once the count exceeds `maxInline`.",
+    "description": "Horizontal list of file attachments. Renders as many items inline as fit the available width — each kept between `minItemWidth` and `maxItemWidth` wide — and collapses into a popover once they no longer fit.",
     "category": "Form Inputs",
     "useCases": [
       "user message attachments",
@@ -219,11 +371,13 @@
     ],
     "props": [
       "files",
-      "maxInline",
+      "minItemWidth",
+      "maxItemWidth",
       "size",
       "isRemovable",
       "removeLabel",
       "disabled",
+      "showStatus",
       "triggerLabel",
       "triggerAriaLabel",
       "listLabel",
@@ -232,9 +386,48 @@
     "examples": [
       "Inline",
       "Collapsed",
+      "UploadStatus",
       "Removable",
       "CustomItem",
       "Clickable",
+      "Disabled",
+      "Responsive"
+    ],
+    "_autoGenerated": true
+  },
+  "CkHeaderActivityButton": {
+    "description": "Compact, ghost-styled button shown on the right of an agent message header (see `CkAgentMessageHeader`). Renders a short label followed by a trailing icon (an arrow by default) and emits a generic `click` event — it performs no action of its own, leaving the consumer to decide what happens (e.g. open an activity / chain-of-thought panel).",
+    "category": "Actions",
+    "useCases": [
+      "agent message header action",
+      "open activity panel",
+      "chain-of-thought summary toggle",
+      "tool/source indicator"
+    ],
+    "keywords": [
+      "header",
+      "activity",
+      "action",
+      "button",
+      "ghost",
+      "arrow",
+      "agent",
+      "message"
+    ],
+    "related": [
+      "CkAgentMessageHeader",
+      "CkAgentMessage",
+      "CkConversation",
+      "CkMessageButton"
+    ],
+    "props": [
+      "disabled",
+      "ariaLabel",
+      "icon"
+    ],
+    "examples": [
+      "Default",
+      "WithoutIcon",
       "Disabled"
     ],
     "_autoGenerated": true
@@ -320,7 +513,8 @@
     "props": [
       "content",
       "classes",
-      "plugins"
+      "plugins",
+      "citations"
     ],
     "examples": [
       "Default",
@@ -329,11 +523,14 @@
       "ComplexMarkdown",
       "WithCustomClasses",
       "GfmFeatures",
-      "WithCustomPlugin"
+      "MathExpressions",
+      "WithCustomPlugin",
+      "WithCitations",
+      "WithUnsupportedAndCodeMarkers"
     ],
     "_autoGenerated": true
   },
-  "CkMessageActionButton": {
+  "CkMessageButton": {
     "description": "Small icon-only action button used in the footer of chat messages. Acts as a ghost-styled wrapper around `UiButton` with consistent chat-kit tokens.",
     "category": "Actions",
     "useCases": [
@@ -352,7 +549,7 @@
       "button"
     ],
     "related": [
-      "CkCopyMessageActionButton",
+      "CkCopyMessageButton",
       "CkAgentMessage",
       "CkConversation"
     ],
@@ -365,52 +562,53 @@
     ],
     "_autoGenerated": true
   },
-  "CkPromptActionButton": {
-    "description": "Icon-only call-to-action button styled for the chat prompt area (brand color). Typically used as the \"send\" button inside a prompt input toolbar, but works for any primary prompt-level action.",
+  "CkModelSelector": {
+    "description": "Compact dropdown for choosing the active model, sized to sit inline in a prompt field next to the send button. Controlled component: pass the available `models` and the `selectedModelId`, and react to `update:selectedModelId` (so it works with `v-model:selected-model-id`). Purely presentational — fetching the list and persisting the choice are the consumer's responsibility.",
     "category": "Actions",
     "useCases": [
-      "send message button",
-      "submit prompt",
-      "primary chat action",
-      "loading send button",
-      "disabled send button"
+      "select model",
+      "choose LLM",
+      "model picker in prompt field",
+      "switch model mid-conversation"
     ],
     "keywords": [
+      "model",
+      "selector",
+      "picker",
+      "dropdown",
+      "llm",
       "prompt",
-      "send",
-      "action",
-      "button",
-      "icon",
-      "submit",
-      "loading",
-      "brand"
+      "choose",
+      "switch"
     ],
     "related": [
       "CkPromptInput",
-      "CkInput",
-      "CkMessageActionButton"
+      "CkPromptSendButton"
     ],
     "props": [
-      "ariaLabel",
+      "models",
+      "selectedModelId",
       "disabled",
-      "loading",
-      "type"
+      "side",
+      "align",
+      "sideOffset"
     ],
     "examples": [
       "Default",
-      "Disabled",
-      "Loading"
+      "Placeholder",
+      "Disabled"
     ],
     "_autoGenerated": true
   },
   "CkPromptInput": {
-    "description": "Low-level prompt input: a single auto-growing textarea with left/right toolbar slots, a footer slot, and keyboard submission (Enter to submit, Shift+Enter for newline). Use when you need full control over the prompt layout; for a turnkey chat input use `CkInput` instead.",
+    "description": "Low-level prompt input: an auto-growing textarea (1–6 lines, then internal scroll) with `toolbar-top` / `toolbar-left` / `toolbar-right` / `footer` slots and keyboard submission (Enter to submit, Shift+Enter for newline). The form layout adapts between a compact single-row variant (large 3xl radius) and a stacked multi-row variant (2xl radius) automatically — driven by content height and whether `toolbar-top` is filled. Compose it with `CkPromptSendButton`, `CkPromptStopButton`, and `CkPromptInputDisclaimer` to build a complete chat input.",
     "category": "Form Inputs",
     "useCases": [
       "raw chat prompt textarea",
       "custom prompt toolbar",
-      "auto-growing textarea",
-      "compose box",
+      "auto-growing compose box",
+      "file-attachment chip row",
+      "multi-line chat input",
       "keyboard submit"
     ],
     "keywords": [
@@ -418,27 +616,36 @@
       "input",
       "textarea",
       "chat",
-      "auto-grow",
       "compose",
       "submit",
-      "v-model"
+      "v-model",
+      "auto-grow",
+      "multi-line",
+      "toolbar"
     ],
     "related": [
-      "CkInput",
-      "CkPromptActionButton",
-      "CkPromptInputDisclaimer"
+      "CkPromptSendButton",
+      "CkPromptStopButton",
+      "CkPromptMenuButton",
+      "CkPromptInputDisclaimer",
+      "CkFileItemsList"
     ],
     "props": [
       "modelValue",
       "placeholder",
       "disabled",
-      "maxHeight",
       "ariaLabel"
     ],
     "examples": [
       "Default",
       "WithToolbarSlots",
       "WithFooterSlot",
+      "WithFooterControls",
+      "WithToolbarTopSlot",
+      "WithUploadAndModelSelection",
+      "WithMultiLineContent",
+      "WithCollapsedFileChips",
+      "WithUploadAndModelSelectionStreaming",
       "Disabled"
     ],
     "_autoGenerated": true
@@ -462,8 +669,8 @@
       "input"
     ],
     "related": [
-      "CkInput",
-      "CkPromptInput"
+      "CkPromptInput",
+      "CkPromptSendButton"
     ],
     "props": [
       "text"
@@ -475,8 +682,84 @@
     ],
     "_autoGenerated": true
   },
+  "CkPromptMenuButton": {
+    "description": "Icon-only menu trigger styled for the chat prompt area (ghost variant, pill-shaped). Sits in `CkPromptInput`'s `toolbar-left` slot as the entry point to a dropdown of prompt actions — attach files, attach folders, toggle tools, switch length, etc. Defaults to a `plus` icon when the slot is empty; pass any icon to override.",
+    "category": "Actions",
+    "useCases": [
+      "open prompt menu",
+      "attach files",
+      "add resources",
+      "toggle tools",
+      "prompt input toolbar"
+    ],
+    "keywords": [
+      "prompt",
+      "menu",
+      "plus",
+      "add",
+      "button",
+      "icon",
+      "ghost",
+      "dropdown trigger",
+      "tools"
+    ],
+    "related": [
+      "CkPromptInput",
+      "CkPromptSendButton",
+      "CkPromptStopButton",
+      "CkDropZoneOverlay",
+      "CkFileItemsList"
+    ],
+    "props": [
+      "ariaLabel",
+      "disabled",
+      "type"
+    ],
+    "examples": [
+      "Default",
+      "Disabled"
+    ],
+    "_autoGenerated": true
+  },
+  "CkPromptSendButton": {
+    "description": "Icon-only send button styled for the chat prompt area (brand color, pill shape). Sits in `CkPromptInput`'s `toolbar-right` slot as the submit trigger. Shows a spinner via `loading` while the previous request is in flight; pair with `CkPromptStopButton` to expose an abort control.",
+    "category": "Actions",
+    "useCases": [
+      "send message button",
+      "submit prompt",
+      "primary chat send action",
+      "loading send button",
+      "disabled send button"
+    ],
+    "keywords": [
+      "prompt",
+      "send",
+      "submit",
+      "button",
+      "icon",
+      "loading",
+      "brand"
+    ],
+    "related": [
+      "CkPromptInput",
+      "CkPromptStopButton",
+      "CkSendIcon"
+    ],
+    "props": [
+      "ariaLabel",
+      "disabled",
+      "loading",
+      "type"
+    ],
+    "examples": [
+      "Default",
+      "Disabled",
+      "Loading"
+    ],
+    "_autoGenerated": true
+  },
   "CkPromptStopButton": {
-    "description": "Icon-only button used to stop an in-flight assistant generation. Shares the brand styling of `CkPromptActionButton` but is intended to replace it in the prompt toolbar while a response is streaming.",
+    "description": "Icon-only button used to stop an in-flight assistant generation. Visually de-emphasized counterpart to `CkPromptSendButton` — uses UiButton's `secondary` variant (muted background) per Figma spec, so the user's eye doesn't read it as a primary call-to-action. Swap it in for `CkPromptSendButton` in the prompt toolbar while a response is streaming.",
     "category": "Actions",
     "useCases": [
       "stop assistant generation",
@@ -489,15 +772,16 @@
       "cancel",
       "abort",
       "prompt",
-      "action",
       "button",
       "icon",
-      "streaming"
+      "streaming",
+      "secondary"
     ],
     "related": [
-      "CkPromptActionButton",
+      "CkPromptSendButton",
+      "CkPromptMenuButton",
       "CkPromptInput",
-      "CkInput"
+      "CkStopIcon"
     ],
     "props": [
       "ariaLabel",
@@ -509,35 +793,73 @@
     ],
     "_autoGenerated": true
   },
+  "CkRegenerateMessageButton": {
+    "description": "Regenerate action button for chat messages. Lets the user request a new response for an assistant message. Renders an icon-only button with an accessible label and tooltip.",
+    "category": "Actions",
+    "useCases": [
+      "regenerate assistant reply",
+      "retry message",
+      "request new response",
+      "chat message action"
+    ],
+    "keywords": [
+      "regenerate",
+      "retry",
+      "repeat",
+      "action",
+      "message",
+      "button",
+      "icon"
+    ],
+    "related": [
+      "CkMessageButton",
+      "CkCopyMessageButton",
+      "CkAgentMessage",
+      "CkConversation"
+    ],
+    "props": [
+      "disabled",
+      "ariaLabel"
+    ],
+    "examples": [
+      "Default",
+      "Disabled"
+    ],
+    "_autoGenerated": true
+  },
   "CkUserMessage": {
-    "description": "Bubble layout for a single user turn in a conversation. Renders the message text on the right side with a tokenized background and max-width; supports a default slot for custom inline content.",
+    "description": "Layout for a single user turn in a conversation. Renders the message text right-aligned in the muted on-surface color with a max-width; supports a default slot for custom inline content. When `collapsedLines` is set, long messages are clamped with a fade and a \"Show more\" / \"Show less\" toggle.",
     "category": "Messages",
     "useCases": [
-      "render user message bubble",
+      "render user message",
       "conversation turn from user",
       "chat input preview",
-      "right-aligned message"
+      "right-aligned message",
+      "collapsible long message"
     ],
     "keywords": [
       "user",
       "message",
-      "bubble",
       "chat",
       "conversation",
-      "turn"
+      "turn",
+      "collapse",
+      "show more"
     ],
     "related": [
       "CkAgentMessage",
       "CkConversation"
     ],
     "props": [
-      "message"
+      "message",
+      "collapsedLines"
     ],
     "examples": [
       "Default",
       "LongMessage",
       "MultilineMessage",
-      "WithSlotContent"
+      "WithSlotContent",
+      "Collapsible"
     ],
     "_autoGenerated": true
   },
@@ -567,8 +889,8 @@
       "CkAgentMessage",
       "CkUserMessage",
       "CkMarkdownRenderer",
-      "CkCopyMessageActionButton",
-      "CkInput"
+      "CkCopyMessageButton",
+      "CkPromptInput"
     ],
     "props": [
       "messages",
@@ -622,61 +944,19 @@
       "hrefResolver",
       "activeId",
       "showAction",
-      "showActionOnHover"
+      "showActionOnHover",
+      "timeFormatter",
+      "collapsedLimit",
+      "maxHeight"
     ],
     "examples": [
       "Default",
       "WithoutActions",
       "RouterLinkIntegration",
-      "WithCustomItem"
-    ],
-    "_autoGenerated": true
-  },
-  "CkInput": {
-    "description": "Drop-in chat input: combines `CkPromptInput`, a `CkPromptActionButton` send button, and a `CkPromptInputDisclaimer`. Supports `v-model`, loading and disabled states, and slots to customize the toolbar and footer.",
-    "category": "Form Inputs",
-    "useCases": [
-      "chat compose input",
-      "prompt box with send button",
-      "llm input with disclaimer",
-      "quick-start chat input",
-      "turnkey chat input"
-    ],
-    "keywords": [
-      "input",
-      "prompt",
-      "chat",
-      "send",
-      "compose",
-      "disclaimer",
-      "loading",
-      "v-model",
-      "textarea"
-    ],
-    "related": [
-      "CkPromptInput",
-      "CkPromptActionButton",
-      "CkPromptInputDisclaimer",
-      "CkConversation"
-    ],
-    "props": [
-      "modelValue",
-      "placeholder",
-      "disabled",
-      "loading",
-      "maxHeight",
-      "ariaLabel",
-      "stopAriaLabel",
-      "disclaimer"
-    ],
-    "examples": [
-      "Default",
-      "WithModeToggle",
-      "FullExample",
-      "Disabled",
-      "Loading",
-      "WithLongText",
-      "MobileWidth"
+      "WithCustomItem",
+      "WithoutTime",
+      "CollapsedWithShowAll",
+      "NoCollapse"
     ],
     "_autoGenerated": true
   }