@alfadocs/ui-kit 0.1.8 → 0.1.9

package/dist/components/command-palette/index.js

@@ -1,4 +1,4 @@
-import { C as t, a as e, b as o, c as s, d as n, e as d, f as i, g as C, h as r, i as l, j as c, k as h, u as g } from "../../_chunks/command-palette.agent-js2rxgeR.js";
+import { C as t, a as e, b as o, c as s, d as n, e as d, f as i, g as C, h as r, i as l, j as c, k as h, u as g } from "../../_chunks/command-palette.agent-HatEt_EM.js";
 export {
   t as CommandEmpty,
   e as CommandGroup,

package/dist/components/data-table/index.js

@@ -1,4 +1,4 @@
-import { A as r, B as l, C as s, a as n, D as o, b as d, L as C, S as t, T as R, c as T, d as b, e as c, U as g, f as i, u } from "../../_chunks/balance-cell-renderer-BWm3knY9.js";
+import { A as r, B as l, C as s, a as n, D as o, b as d, L as C, S as t, T as R, c as T, d as b, e as c, U as g, f as i, u } from "../../_chunks/balance-cell-renderer-5CA7zpAi.js";
 export {
   r as ActionsCellRenderer,
   l as BalanceCellRenderer,

package/dist/components/date-picker/date-picker.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { DatePickerHandle } from './date-picker';
+export declare const datePickerAgent: AgentAdapter<DatePickerHandle>;
+//# sourceMappingURL=date-picker.agent.d.ts.map

package/dist/components/date-picker/date-picker.d.ts

@@ -1,6 +1,21 @@
 import { type VariantProps } from 'class-variance-authority';
 import { triggerVariants } from '../_shared';
 import '../../tokens/themes/bridges/react-day-picker.css';
+/** Curated imperative handle exposed via `ref` — also consumed by the agent adapter. */
+export interface DatePickerHandle {
+    /** Get the current selected date, or undefined. */
+    getValue: () => Date | undefined;
+    /** Set the selected date. */
+    setValue: (date: Date | undefined) => void;
+    /** Clear the selected date. */
+    clear: () => void;
+    /** Whether the popover is open. */
+    isOpen: () => boolean;
+    /** Open the calendar popover. */
+    open: () => void;
+    /** Close the calendar popover. */
+    close: () => void;
+}
 export interface DatePickerPreset {
     label: string;
     date: () => Date;
@@ -33,5 +48,5 @@ export interface DatePickerProps extends Pick<VariantProps<typeof triggerVariant
     /** id override. */
     id?: string;
 }
-export declare const DatePicker: import("react").ForwardRefExoticComponent<DatePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DatePicker: import("react").ForwardRefExoticComponent<DatePickerProps & import("react").RefAttributes<DatePickerHandle>>;
 //# sourceMappingURL=date-picker.d.ts.map

package/dist/components/date-picker/index.d.ts

@@ -1,3 +1,4 @@
 export { DatePicker } from './date-picker';
-export type { DatePickerProps, DatePickerPreset } from './date-picker';
+export type { DatePickerProps, DatePickerPreset, DatePickerHandle } from './date-picker';
+export { datePickerAgent } from './date-picker.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/date-picker/index.js

@@ -1,5 +1,6 @@
-import { D as a } from "../../_chunks/date-picker-DYXNsWmM.js";
+import { D as r, d as t } from "../../_chunks/date-picker-BqPTn7bO.js";
 export {
-  a as DatePicker
+  r as DatePicker,
+  t as datePickerAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/date-range-picker/date-range-picker.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { DateRangePickerHandle } from './date-range-picker';
+export declare const dateRangePickerAgent: AgentAdapter<DateRangePickerHandle>;
+//# sourceMappingURL=date-range-picker.agent.d.ts.map

package/dist/components/date-range-picker/date-range-picker.d.ts

@@ -12,6 +12,21 @@ export interface DateRangeValue {
     from?: Date;
     to?: Date;
 }
+/** Curated imperative handle exposed via `ref` — also consumed by the agent adapter. */
+export interface DateRangePickerHandle {
+    /** Get the current selected range. */
+    getRange: () => DateRangeValue;
+    /** Replace the selected range. */
+    setRange: (range: DateRangeValue) => void;
+    /** Clear the selected range. */
+    clear: () => void;
+    /** Whether the popover is open. */
+    isOpen: () => boolean;
+    /** Open the range calendar popover. */
+    open: () => void;
+    /** Close the range calendar popover. */
+    close: () => void;
+}
 export interface DateRangePickerProps extends Pick<VariantProps<typeof triggerVariants>, 'size'> {
     /** Current range — controlled. */
     value?: DateRangeValue;
@@ -38,5 +53,5 @@ export interface DateRangePickerProps extends Pick<VariantProps<typeof triggerVa
     /** id override. */
     id?: string;
 }
-export declare const DateRangePicker: import("react").ForwardRefExoticComponent<DateRangePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DateRangePicker: import("react").ForwardRefExoticComponent<DateRangePickerProps & import("react").RefAttributes<DateRangePickerHandle>>;
 //# sourceMappingURL=date-range-picker.d.ts.map

package/dist/components/date-range-picker/index.d.ts

@@ -1,3 +1,4 @@
 export { DateRangePicker } from './date-range-picker';
-export type { DateRangePickerProps, DateRangePreset, DateRangeValue, } from './date-range-picker';
+export type { DateRangePickerProps, DateRangePreset, DateRangeValue, DateRangePickerHandle, } from './date-range-picker';
+export { dateRangePickerAgent } from './date-range-picker.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/date-range-picker/index.js

@@ -1,5 +1,6 @@
-import { D as r } from "../../_chunks/date-range-picker-BcNDJI7m.js";
+import { D as r, d as t } from "../../_chunks/date-range-picker-B2hGsffw.js";
 export {
-  r as DateRangePicker
+  r as DateRangePicker,
+  t as dateRangePickerAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/date-time-picker/date-time-picker.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { DateTimePickerHandle } from './date-time-picker';
+export declare const dateTimePickerAgent: AgentAdapter<DateTimePickerHandle>;
+//# sourceMappingURL=date-time-picker.agent.d.ts.map

package/dist/components/date-time-picker/date-time-picker.d.ts

@@ -1,6 +1,21 @@
 import { type VariantProps } from 'class-variance-authority';
 import { triggerVariants } from '../_shared';
 import '../../tokens/themes/bridges/react-day-picker.css';
+/** Curated imperative handle exposed via `ref` — also consumed by the agent adapter. */
+export interface DateTimePickerHandle {
+    /** Get the current selected datetime, or undefined. */
+    getValue: () => Date | undefined;
+    /** Set the selected datetime. */
+    setValue: (date: Date | undefined) => void;
+    /** Clear the selected datetime. */
+    clear: () => void;
+    /** Whether the popover is open. */
+    isOpen: () => boolean;
+    /** Open the popover. */
+    open: () => void;
+    /** Close the popover. */
+    close: () => void;
+}
 export interface DateTimePickerProps extends Pick<VariantProps<typeof triggerVariants>, 'size'> {
     /** Current datetime — controlled. */
     value?: Date;
@@ -31,5 +46,5 @@ export interface DateTimePickerProps extends Pick<VariantProps<typeof triggerVar
     /** id override. */
     id?: string;
 }
-export declare const DateTimePicker: import("react").ForwardRefExoticComponent<DateTimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const DateTimePicker: import("react").ForwardRefExoticComponent<DateTimePickerProps & import("react").RefAttributes<DateTimePickerHandle>>;
 //# sourceMappingURL=date-time-picker.d.ts.map

package/dist/components/date-time-picker/index.d.ts

@@ -1,3 +1,4 @@
 export { DateTimePicker } from './date-time-picker';
-export type { DateTimePickerProps } from './date-time-picker';
+export type { DateTimePickerProps, DateTimePickerHandle } from './date-time-picker';
+export { dateTimePickerAgent } from './date-time-picker.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/date-time-picker/index.js

@@ -1,5 +1,6 @@
-import { D as a } from "../../_chunks/date-time-picker-CmGiTU__.js";
+import { D as i, d as r } from "../../_chunks/date-time-picker-Bzt0S8yO.js";
 export {
-  a as DateTimePicker
+  i as DateTimePicker,
+  r as dateTimePickerAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/dialog/dialog.agent.d.ts

@@ -1,10 +1,9 @@
 import type { AgentAdapter } from '../../agent/types';
+import type { DialogHandle } from './dialog';
 /**
- * Dialog wraps Radix Dialog. Opening / closing is consumer-controlled via
- * `open` + `onOpenChange` props — there is no imperative handle. The agent
- * surface here is declarative: the kit emits `data-component="dialog"` so a
- * future MCP UI bridge can locate live dialogs, and the host pattern owns
- * how the dialog opens / dismisses.
+ * Dialog wraps Radix Dialog. The curated handle (`DialogHandle`) bridges the
+ * Radix controlled-or-uncontrolled `open` state so an agent can observe and
+ * drive the dialog without owning the React state itself.
  */
-export declare const dialogAgent: AgentAdapter<unknown>;
+export declare const dialogAgent: AgentAdapter<DialogHandle>;
 //# sourceMappingURL=dialog.agent.d.ts.map

package/dist/components/dialog/dialog.d.ts

@@ -4,6 +4,15 @@ import { type VariantProps } from 'class-variance-authority';
 declare const contentVariants: (props?: ({
     size?: "sm" | "md" | "lg" | "fullscreen" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface DialogHandle {
+    getIsOpen: () => boolean;
+    open: () => void;
+    close: () => void;
+}
+export interface DialogRootProps extends ComponentPropsWithoutRef<typeof RadixDialog.Root> {
+    /** Opaque instance id — forwarded to Dialog.Content as `data-component-id`. */
+    id?: string;
+}
 export interface DialogContentProps extends Omit<ComponentPropsWithoutRef<typeof RadixDialog.Content>, 'role'>, VariantProps<typeof contentVariants> {
     size?: 'sm' | 'md' | 'lg' | 'fullscreen';
     variant?: 'default' | 'alert' | 'confirmation';
@@ -15,11 +24,11 @@ interface DialogFooterProps extends HTMLAttributes<HTMLDivElement> {
     divider?: boolean;
 }
 export declare const Dialog: {
-    ({ children, ...props }: ComponentPropsWithoutRef<typeof RadixDialog.Root>): import("react/jsx-runtime").JSX.Element;
+    ({ children, id, ...props }: DialogRootProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 } & {
     Root: {
-        ({ children, ...props }: ComponentPropsWithoutRef<typeof RadixDialog.Root>): import("react/jsx-runtime").JSX.Element;
+        ({ children, id, ...props }: DialogRootProps): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
     Trigger: import("react").ForwardRefExoticComponent<Omit<RadixDialog.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/dialog/index.js

@@ -1,4 +1,4 @@
-import { D as g, d } from "../../_chunks/dialog.agent-DEG_fVzG.js";
+import { D as g, d } from "../../_chunks/dialog.agent-Daf1TTko.js";
 export {
   g as Dialog,
   d as dialogAgent

package/dist/components/dropdown-menu/dropdown-menu.agent.d.ts

@@ -1,3 +1,4 @@
 import type { AgentAdapter } from '../../agent/types';
-export declare const dropdownMenuAgent: AgentAdapter<unknown>;
+import type { DropdownMenuHandle } from './dropdown-menu';
+export declare const dropdownMenuAgent: AgentAdapter<DropdownMenuHandle>;
 //# sourceMappingURL=dropdown-menu.agent.d.ts.map

package/dist/components/dropdown-menu/dropdown-menu.d.ts

@@ -3,7 +3,15 @@ import * as RadixDropdownMenu from '@radix-ui/react-dropdown-menu';
 import { type VariantProps } from 'class-variance-authority';
 import { type KbdNamedKey } from '../kbd/kbd';
 declare const contentVariants: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
-type DropdownMenuRootProps = ComponentPropsWithoutRef<typeof RadixDropdownMenu.Root>;
+export interface DropdownMenuHandle {
+    getIsOpen: () => boolean;
+    open: () => void;
+    close: () => void;
+}
+export interface DropdownMenuRootProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.Root> {
+    /** Opaque instance id — forwarded to DropdownMenu.Content as `data-component-id`. */
+    id?: string;
+}
 export interface DropdownMenuContentProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.Content>, VariantProps<typeof contentVariants> {
 }
 export interface DropdownMenuItemProps extends ComponentPropsWithoutRef<typeof RadixDropdownMenu.Item> {
@@ -32,7 +40,7 @@ export interface DropdownMenuSubContentProps extends ComponentPropsWithoutRef<ty
 }
 export declare const DropdownMenu: {
     Root: {
-        ({ dir, ...props }: DropdownMenuRootProps): import("react/jsx-runtime").JSX.Element;
+        ({ dir, id, ...props }: DropdownMenuRootProps): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
     Trigger: import("react").ForwardRefExoticComponent<RadixDropdownMenu.DropdownMenuTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/dropdown-menu/index.js

@@ -1,5 +1,5 @@
-import { D as e } from "../../_chunks/dropdown-menu-Cw3EyPZv.js";
-import { d } from "../../_chunks/dropdown-menu.agent-Cry4Nmes.js";
+import { D as e } from "../../_chunks/dropdown-menu-C7AZipNz.js";
+import { d } from "../../_chunks/dropdown-menu.agent-BcxIKOjK.js";
 export {
   e as DropdownMenu,
   d as dropdownMenuAgent

package/dist/components/file-upload/file-upload.agent.d.ts

@@ -1,3 +1,4 @@
 import type { AgentAdapter } from '../../agent/types';
-export declare const fileUploadAgent: AgentAdapter<unknown>;
+import type { FileUploadHandle } from './file-upload';
+export declare const fileUploadAgent: AgentAdapter<FileUploadHandle>;
 //# sourceMappingURL=file-upload.agent.d.ts.map

package/dist/components/file-upload/file-upload.d.ts

@@ -10,7 +10,19 @@ export interface FileUploadRejection {
     file: File;
     reason: 'file-too-large' | 'file-too-small' | 'file-invalid-type' | 'too-many-files';
 }
+export interface FileUploadHandle {
+    getFiles: () => Array<{
+        id: string;
+        name: string;
+        size: number;
+        status: FileUploadFile['status'];
+    }>;
+    removeFile: (id: string) => void;
+    clear: () => void;
+}
 export interface FileUploadProps {
+    /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
+    id?: string;
     accept?: Record<string, string[]>;
     maxSize?: number;
     minSize?: number;

package/dist/components/file-upload/index.js

@@ -1,4 +1,4 @@
-import { F as l, f as o } from "../../_chunks/file-upload.agent-B9AN82LA.js";
+import { F as l, f as o } from "../../_chunks/file-upload.agent-DJaH2dHg.js";
 export {
   l as FileUpload,
   o as fileUploadAgent

package/dist/components/freemium-paywall/freemium-paywall.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { FreemiumPaywallHandle } from './freemium-paywall';
+export declare const freemiumPaywallAgent: AgentAdapter<FreemiumPaywallHandle>;
+//# sourceMappingURL=freemium-paywall.agent.d.ts.map

package/dist/components/freemium-paywall/freemium-paywall.d.ts

@@ -17,6 +17,13 @@ declare const contentVariants: (props?: ({
     layout?: "sheet" | "centered" | null | undefined;
     density?: "compact" | "full" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** Curated imperative handle for agent / external automation. */
+export interface FreemiumPaywallHandle {
+    isOpen: () => boolean;
+    getSelectedPlanId: () => string | null;
+    upgrade: () => void;
+    dismiss: () => void;
+}
 export interface FreemiumPaywallProps extends VariantProps<typeof contentVariants> {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -40,6 +47,6 @@ export interface FreemiumPaywallProps extends VariantProps<typeof contentVariant
     description?: ReactNode;
     className?: string;
 }
-export declare const FreemiumPaywall: import("react").ForwardRefExoticComponent<FreemiumPaywallProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const FreemiumPaywall: import("react").ForwardRefExoticComponent<FreemiumPaywallProps & import("react").RefAttributes<FreemiumPaywallHandle>>;
 export {};
 //# sourceMappingURL=freemium-paywall.d.ts.map

package/dist/components/freemium-paywall/index.d.ts

@@ -1,3 +1,4 @@
 export { FreemiumPaywall } from './freemium-paywall';
-export type { FreemiumPaywallProps, FreemiumPlan } from './freemium-paywall';
+export type { FreemiumPaywallProps, FreemiumPaywallHandle, FreemiumPlan, } from './freemium-paywall';
+export { freemiumPaywallAgent } from './freemium-paywall.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/freemium-paywall/index.js

@@ -1,5 +1,6 @@
-import { F as m } from "../../_chunks/freemium-paywall-CkefGLM_.js";
+import { F as m, f as l } from "../../_chunks/freemium-paywall.agent-_nQqLyRF.js";
 export {
-  m as FreemiumPaywall
+  m as FreemiumPaywall,
+  l as freemiumPaywallAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/index.d.ts

@@ -24,6 +24,7 @@ export * from './number-input';
 export * from './otp-input';
 export * from './password-input';
 export * from './phone-input';
+export * from './recaptcha-widget';
 export * from './radio';
 export * from './radio-group';
 export * from './search-input';
@@ -55,6 +56,7 @@ export * from './breadcrumb';
 export * from './command-palette';
 export * from './header';
 export * from './navigation-menu';
+export * from './link';
 export * from './pagination';
 export * from './search-bar';
 export * from './sidebar';

package/dist/components/link/index.d.ts

@@ -0,0 +1,2 @@
+export { Link, type LinkProps } from './link';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/link/index.js

@@ -0,0 +1,5 @@
+import { L } from "../../_chunks/link-QheANk74.js";
+export {
+  L as Link
+};
+//# sourceMappingURL=index.js.map

package/dist/components/link/link.d.ts

@@ -0,0 +1,39 @@
+import { type AnchorHTMLAttributes, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+/**
+ * Link is the semantic anchor primitive for inline navigation —
+ * privacy / terms in form copy, external "remote support" links in
+ * sidebars, in-paragraph references inside info-tip body copy.
+ *
+ * For action affordances that *look* like a link but trigger UI rather
+ * than navigation, use `<Button intent="link">` instead — the semantic
+ * boundary matters for screen readers and keyboard users.
+ */
+declare const linkVariants: (props?: ({
+    intent?: "default" | "inverted" | "subtle" | null | undefined;
+    weight?: "strong" | "normal" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>, VariantProps<typeof linkVariants> {
+    /** Anchor target. Required — the whole point of the component. */
+    href: string;
+    /**
+     * Flag the link as opening in a new browsing context. Automatically
+     * adds `target="_blank"` + `rel="noopener noreferrer"` and renders a
+     * trailing `ExternalLink` icon with an i18n'd aria-label.
+     */
+    external?: boolean;
+    /**
+     * Render the link in a non-interactive disabled state. Strips `href`,
+     * adds `aria-disabled` + `role="link"`, suppresses the underline.
+     * Prefer hiding the link entirely when possible — disabled links are
+     * a usability anti-pattern outside of state-machine flows.
+     */
+    disabled?: boolean;
+    /** Optional leading icon (inline-start). */
+    startIcon?: ReactNode;
+    /** Optional trailing icon (inline-end). Ignored when `external`. */
+    endIcon?: ReactNode;
+}
+export declare const Link: import("react").ForwardRefExoticComponent<LinkProps & import("react").RefAttributes<HTMLAnchorElement>>;
+export {};
+//# sourceMappingURL=link.d.ts.map

package/dist/components/list/index.d.ts

@@ -1,3 +1,4 @@
 export { List } from './list';
-export type { ListProps, ListItemProps } from './list';
+export type { ListProps, ListHandle, ListItemProps } from './list';
+export { listAgent } from './list.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/list/index.js

@@ -1,5 +1,6 @@
-import { L as s } from "../../_chunks/list-B1ozIjQe.js";
+import { L as a, l as e } from "../../_chunks/list.agent-D0iWt4VI.js";
 export {
-  s as List
+  a as List,
+  e as listAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/list/list.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { ListHandle } from './list';
+export declare const listAgent: AgentAdapter<ListHandle>;
+//# sourceMappingURL=list.agent.d.ts.map

package/dist/components/list/list.d.ts

@@ -11,6 +11,12 @@ interface ListContextValue {
     registerItemRef: (value: string, el: HTMLElement | null) => void;
     divider: 'spaced' | 'divided' | 'bordered';
 }
+/** Curated imperative handle for agent / external automation. */
+export interface ListHandle {
+    getSelection: () => string[];
+    setSelection: (ids: string[]) => void;
+    clearSelection: () => void;
+}
 export interface ListProps extends HTMLAttributes<HTMLElement> {
     as?: 'ul' | 'ol';
     start?: number;
@@ -34,8 +40,8 @@ export interface ListItemProps extends Omit<HTMLAttributes<HTMLElement>, 'title'
     disabled?: boolean;
     className?: string;
 }
-export declare const List: import("react").ForwardRefExoticComponent<ListProps & import("react").RefAttributes<HTMLElement>> & {
-    Root: import("react").ForwardRefExoticComponent<ListProps & import("react").RefAttributes<HTMLElement>>;
+export declare const List: import("react").ForwardRefExoticComponent<ListProps & import("react").RefAttributes<ListHandle>> & {
+    Root: import("react").ForwardRefExoticComponent<ListProps & import("react").RefAttributes<ListHandle>>;
     Item: import("react").ForwardRefExoticComponent<ListItemProps & import("react").RefAttributes<HTMLElement>>;
 };
 export type { ListContextValue };

package/dist/components/message-card/index.d.ts

@@ -1,3 +1,4 @@
 export { MessageCard, isSafeMessageUrl, } from './message-card';
 export type { MessageItem, MessageSender, MessageCardProps, } from './message-card';
+export { messageCardAgent } from './message-card.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/message-card/index.js

@@ -1,6 +1,8 @@
-import { M as e, i as r } from "../../_chunks/message-card-qAp2-WQK.js";
+import { M as a, i as r } from "../../_chunks/message-card-qhoGv947.js";
+import { m } from "../../_chunks/message-card.agent-4IeIgrnJ.js";
 export {
-  e as MessageCard,
-  r as isSafeMessageUrl
+  a as MessageCard,
+  r as isSafeMessageUrl,
+  m as messageCardAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/message-card/message-card.agent.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from '../../agent/types';
+export declare const messageCardAgent: AgentAdapter;
+//# sourceMappingURL=message-card.agent.d.ts.map

package/dist/components/message-tray/index.d.ts

@@ -1,3 +1,4 @@
 export { MessageTray } from './message-tray';
-export type { MessageTrayProps } from './message-tray';
+export type { MessageTrayProps, MessageTrayHandle } from './message-tray';
+export { messageTrayAgent } from './message-tray.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/message-tray/index.js

@@ -1,5 +1,6 @@
-import { M as r } from "../../_chunks/message-tray-VaLpQU5t.js";
+import { M as s, m as r } from "../../_chunks/message-tray-xHUCra-Y.js";
 export {
-  r as MessageTray
+  s as MessageTray,
+  r as messageTrayAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/message-tray/message-tray.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { MessageTrayHandle } from './message-tray';
+export declare const messageTrayAgent: AgentAdapter<MessageTrayHandle>;
+//# sourceMappingURL=message-tray.agent.d.ts.map

package/dist/components/message-tray/message-tray.d.ts

@@ -1,7 +1,32 @@
 import { type HTMLAttributes } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 import { type MessageItem } from '../message-card/message-card';
-export interface MessageTrayProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onClick' | 'children' | 'role'>, VariantProps<typeof messageTrayVariants> {
+/**
+ * Curated imperative handle for MessageTray. Exposed as the forwardRef
+ * target so a future agent / MCP UI bridge can drive the tray without
+ * touching the DOM. See `message-tray.agent.ts`.
+ */
+export interface MessageTrayHandle {
+    open: () => void;
+    close: () => void;
+    isOpen: () => boolean;
+    getItems: () => Array<{
+        id: string;
+        read: boolean;
+    }>;
+    getUnreadCount: () => number;
+    selectItem: (id: string) => void;
+    markRead: (id: string) => void;
+    dismiss: (id: string) => void;
+}
+export interface MessageTrayProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onClick' | 'children' | 'role' | 'id'>, VariantProps<typeof messageTrayVariants> {
+    /**
+     * Stable instance id. Surfaced on the root as `data-component-id` so
+     * an agent / MCP UI bridge can address this specific tray.
+     */
+    id?: string;
+    /** Fires when the host should mark a single message as read (used by agent integration). */
+    onMarkRead?: (item: MessageItem) => void;
     /** Messages rendered in the dropdown panel. */
     items: MessageItem[];
     /** Number of unread messages. Drives the badge count. */
@@ -35,6 +60,6 @@ export interface MessageTrayProps extends Omit<HTMLAttributes<HTMLDivElement>, '
 declare const messageTrayVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export declare const MessageTray: import("react").ForwardRefExoticComponent<MessageTrayProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const MessageTray: import("react").ForwardRefExoticComponent<MessageTrayProps & import("react").RefAttributes<MessageTrayHandle>>;
 export {};
 //# sourceMappingURL=message-tray.d.ts.map

package/dist/components/multi-select/index.js

@@ -1,4 +1,4 @@
-import { M as a, m as l, a as i } from "../../_chunks/multi-select.agent-CNsyW3n9.js";
+import { M as a, m as l, a as i } from "../../_chunks/multi-select.agent-Do6CeQUT.js";
 export {
   a as MultiSelect,
   l as multiSelectAgent,

package/dist/components/multi-select/multi-select.agent.d.ts

@@ -1,3 +1,4 @@
 import type { AgentAdapter } from '../../agent/types';
-export declare const multiSelectAgent: AgentAdapter<unknown>;
+import type { MultiSelectHandle } from './multi-select';
+export declare const multiSelectAgent: AgentAdapter<MultiSelectHandle>;
 //# sourceMappingURL=multi-select.agent.d.ts.map

package/dist/components/multi-select/multi-select.d.ts

@@ -5,6 +5,16 @@ declare const multiSelectVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type HTMLDivAttributes = HTMLAttributes<HTMLDivElement>;
+export interface MultiSelectHandle {
+    getSelection: () => string[];
+    getQuery: () => string;
+    getIsOpen: () => boolean;
+    setSelection: (values: string[]) => void;
+    clearSelection: () => void;
+    setQuery: (query: string) => void;
+    open: () => void;
+    close: () => void;
+}
 export interface MultiSelectProps<T extends string = string> extends Omit<HTMLDivAttributes, 'onChange'>, VariantProps<typeof multiSelectVariants> {
     options: OptionShape<T>[];
     value?: T[];

package/dist/components/navigation-menu/index.d.ts

@@ -1,5 +1,6 @@
 export { NavigationMenu, NavigationMenuList, NavigationMenuItem, NavigationMenuTrigger, NavigationMenuContent, NavigationMenuLink, NavigationMenuIndicator, NavigationMenuViewport, } from './navigation-menu';
-export type { NavigationMenuProps, NavigationMenuContentProps, NavigationMenuLinkProps, } from './navigation-menu';
+export type { NavigationMenuProps, NavigationMenuHandle, NavigationMenuItemProps, NavigationMenuContentProps, NavigationMenuLinkProps, } from './navigation-menu';
+export { navigationMenuAgent } from './navigation-menu.agent';
 export { SkipLink } from '../skip-link';
 export type { SkipLinkProps } from '../skip-link';
 //# sourceMappingURL=index.d.ts.map