@aleph-alpha/lib-mcp 3.0.0 → 4.1.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"
     ],
@@ -141,6 +254,38 @@
     ],
     "_autoGenerated": true
   },
+  "CkEditableUserMessage": {
+    "description": "Editable variant of {@link CkUserMessage}. Wraps the plain user message in a floating actions toolbar (via `UiFloatActions`) that reveals an edit button on hover and keyboard focus. Activating it emits the `edit` event; the consumer owns the actual editing flow (e.g. swapping in an inline editor). Use this instead of `CkUserMessage` only when a turn needs the edit affordance — plain, non-interactive turns should keep using `CkUserMessage`.",
+    "category": "Messages",
+    "useCases": [
+      "edit user message",
+      "revise prompt",
+      "editable conversation turn",
+      "message hover actions"
+    ],
+    "keywords": [
+      "user",
+      "message",
+      "edit",
+      "editable",
+      "chat",
+      "conversation",
+      "turn"
+    ],
+    "related": [
+      "CkUserMessage",
+      "CkAgentMessage",
+      "CkConversation"
+    ],
+    "props": [
+      "message",
+      "collapsedLines"
+    ],
+    "examples": [
+      "Default"
+    ],
+    "_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",
@@ -163,8 +308,8 @@
       "button"
     ],
     "related": [
-      "CkMessageActionButton",
-      "CkCopyMessageActionButton",
+      "CkMessageButton",
+      "CkCopyMessageButton",
       "CkAgentMessage",
       "CkConversation"
     ],
@@ -203,7 +348,7 @@
     ],
     "related": [
       "CkFeedbackButton",
-      "CkMessageActionButton",
+      "CkMessageButton",
       "CkAgentMessage"
     ],
     "props": [
@@ -235,7 +380,7 @@
     "_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",
@@ -258,7 +403,8 @@
     ],
     "props": [
       "files",
-      "maxInline",
+      "minItemWidth",
+      "maxItemWidth",
       "size",
       "isRemovable",
       "removeLabel",
@@ -276,6 +422,44 @@
       "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
@@ -361,7 +545,8 @@
     "props": [
       "content",
       "classes",
-      "plugins"
+      "plugins",
+      "citations"
     ],
     "examples": [
       "Default",
@@ -370,11 +555,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": [
@@ -393,7 +581,7 @@
       "button"
     ],
     "related": [
-      "CkCopyMessageActionButton",
+      "CkCopyMessageButton",
       "CkAgentMessage",
       "CkConversation"
     ],
@@ -445,7 +633,7 @@
     "_autoGenerated": true
   },
   "CkPromptInput": {
-    "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. 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",
@@ -468,7 +656,6 @@
       "toolbar"
     ],
     "related": [
-      "CkInput",
       "CkPromptSendButton",
       "CkPromptStopButton",
       "CkPromptMenuButton",
@@ -514,8 +701,8 @@
       "input"
     ],
     "related": [
-      "CkInput",
-      "CkPromptInput"
+      "CkPromptInput",
+      "CkPromptSendButton"
     ],
     "props": [
       "text"
@@ -588,7 +775,6 @@
     "related": [
       "CkPromptInput",
       "CkPromptStopButton",
-      "CkInput",
       "CkSendIcon"
     ],
     "props": [
@@ -627,7 +813,6 @@
       "CkPromptSendButton",
       "CkPromptMenuButton",
       "CkPromptInput",
-      "CkInput",
       "CkStopIcon"
     ],
     "props": [
@@ -640,8 +825,42 @@
     ],
     "_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": "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.",
+    "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. For an editable variant (hover/focus edit toolbar), see {@link CkEditableUserMessage}, which wraps this component.",
     "category": "Messages",
     "useCases": [
       "render user message",
@@ -660,6 +879,7 @@
       "show more"
     ],
     "related": [
+      "CkEditableUserMessage",
       "CkAgentMessage",
       "CkConversation"
     ],
@@ -702,8 +922,8 @@
       "CkAgentMessage",
       "CkUserMessage",
       "CkMarkdownRenderer",
-      "CkCopyMessageActionButton",
-      "CkInput"
+      "CkCopyMessageButton",
+      "CkPromptInput"
     ],
     "props": [
       "messages",
@@ -714,11 +934,11 @@
     ],
     "examples": [
       "Default",
-      "ChainOfThought",
       "WithIcon",
       "WithCustomAvatarFallback",
       "NoIcon",
       "WithCustomIcon",
+      "WithLoadingIcon",
       "WithFooterActions",
       "WithCustomUserContent",
       "WithCustomAgentContent",
@@ -772,52 +992,5 @@
       "NoCollapse"
     ],
     "_autoGenerated": true
-  },
-  "CkInput": {
-    "description": "Drop-in chat input: combines `CkPromptInput`, a `CkPromptSendButton` 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",
-      "CkPromptSendButton",
-      "CkPromptInputDisclaimer",
-      "CkConversation"
-    ],
-    "props": [
-      "modelValue",
-      "placeholder",
-      "disabled",
-      "loading",
-      "ariaLabel",
-      "stopAriaLabel",
-      "disclaimer"
-    ],
-    "examples": [
-      "Default",
-      "WithModeToggle",
-      "FullExample",
-      "Disabled",
-      "Loading",
-      "WithLongText",
-      "MobileWidth"
-    ],
-    "_autoGenerated": true
   }
 }

package/components-meta.json

@@ -239,6 +239,11 @@
       "Default",
       "DesignNotes",
       "Accessibility",
+      "KeyboardNavigation",
+      "KeyboardGroupNavigation",
+      "ZoomMagnification",
+      "ScreenReader",
+      "MobileBreakpoint",
       "Outline",
       "Secondary",
       "Ghost",
@@ -250,7 +255,7 @@
       "LoadingWithBothIcons",
       "AsChild",
       "AllVariants",
-      "DisabledHoverBleed",
+      "Disabled",
       "AllVariantsAndSizes"
     ],
     "_autoGenerated": true
@@ -1439,11 +1444,10 @@
     "_autoGenerated": true
   },
   "UiSnackbar": {
-    "description": "Toast notification container (Sonner). Place once near the app root, then call `toast()` (or `toast.success()`, `toast.error()`, etc.) from anywhere to display a non-blocking notification.",
+    "description": "Toast notification container. Place once near the app root, then call `showSnackbar()` or `toast()` from anywhere to display a non-blocking notification with a title and optional description. This component is currently experimental. Its API and behavior may still change before it is considered stable.",
     "category": "Feedback",
     "useCases": [
-      "success confirmation",
-      "error notice",
+      "confirmation",
       "undo action",
       "async progress",
       "background updates"
@@ -1451,30 +1455,25 @@
     "keywords": [
       "snackbar",
       "toast",
-      "sonner",
       "notification",
       "alert",
       "message",
       "banner",
-      "undo"
+      "undo",
+      "experimental"
     ],
     "related": [
       "UiAlert",
-      "UiAlertDialog"
+      "UiAlertDialog",
+      "UiSnackbarContent"
     ],
     "props": [],
     "examples": [
-      "SuccessHigh",
-      "SuccessLow",
-      "InfoHigh",
-      "InfoLow",
-      "WarningHigh",
-      "WarningLow",
-      "ErrorHigh",
-      "ErrorLow",
-      "AllVariants",
       "Default",
       "WithDescription",
+      "IconModes",
+      "ActionModes",
+      "WithAction",
       "PromiseSnackbar",
       "WithDialog"
     ],
@@ -1811,7 +1810,8 @@
       "align",
       "class",
       "delayDuration",
-      "disabled"
+      "disabled",
+      "to"
     ],
     "examples": [
       "Default",
@@ -1869,7 +1869,8 @@
       "WithMinHeightSmallDataset",
       "WithRowActions",
       "WithCellFormatting",
-      "WithRowClick"
+      "WithRowClick",
+      "WithFilterMenu"
     ],
     "_autoGenerated": true
   },
@@ -1978,6 +1979,54 @@
     ],
     "_autoGenerated": true
   },
+  "UiFloatActions": {
+    "description": "Anchors floating action content to a trigger element on hover, focus, or click. Use for contextual toolbars, quick actions, and inline controls. For rich panels or forms, prefer `UiPopover`. This component is currently experimental. Its API and behavior may still change before it is considered stable.",
+    "category": "Overlays",
+    "useCases": [
+      "contextual toolbar",
+      "inline actions",
+      "hover controls",
+      "keyboard toolbar"
+    ],
+    "keywords": [
+      "float",
+      "anchor",
+      "floating",
+      "toolbar",
+      "hover",
+      "focus",
+      "contextual",
+      "experimental",
+      "actions"
+    ],
+    "related": [
+      "UiFloatActionItems",
+      "UiPopover",
+      "UiTooltip",
+      "useAnchorFloat"
+    ],
+    "props": [
+      "trigger",
+      "placement",
+      "offset",
+      "open",
+      "openDelay",
+      "closeDelay",
+      "dismissOnOutsideClick",
+      "dismissOnEscape",
+      "ariaLabel"
+    ],
+    "examples": [
+      "ShowModes",
+      "IconOnlyWithTooltip",
+      "ButtonWithText",
+      "Orientation",
+      "ItemTypes",
+      "AllStates",
+      "Composable"
+    ],
+    "_autoGenerated": true
+  },
   "UiPlaceholder": {
     "description": "Placeholder for foundation components (internal development use).",
     "category": "Foundations",

package/dist/cli.js

@@ -22214,6 +22214,7 @@ function getChatKitComponentDocs(componentName) {
   return {
     name,
     description,
+    labels: [],
     props,
     examples,
     usageGuidance: [...new Set(usageGuidance)],

package/dist/server.js

@@ -22102,6 +22102,7 @@ function getChatKitComponentDocs(componentName) {
   return {
     name,
     description,
+    labels: [],
     props,
     examples,
     usageGuidance: [...new Set(usageGuidance)],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-alpha/lib-mcp",
-  "version": "3.0.0",
+  "version": "4.1.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/server.js",
@@ -32,12 +32,12 @@
   "devDependencies": {
     "esbuild": "^0.24.0",
     "typescript": "^5.2.2",
-    "vitest": "^3.0.0",
+    "vitest": "^3.2.6",
     "@aleph-alpha/tsconfig-frontend": "0.7.0"
   },
   "peerDependencies": {
-    "@aleph-alpha/ui-library": "3.0.0",
-    "@aleph-alpha/chat-kit": "3.0.0"
+    "@aleph-alpha/ui-library": "5.4.0",
+    "@aleph-alpha/chat-kit": "5.3.0"
   },
   "homepage": "https://docs.aleph-alpha.com",
   "scripts": {