@alfadocs/ui-kit 0.1.7 → 0.1.9

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

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

package/dist/components/accordion/accordion.d.ts

@@ -14,6 +14,12 @@ type PrimitiveMultipleProps = ComponentPropsWithoutRef<typeof AccordionPrimitive
     type: 'multiple';
 };
 export type AccordionProps = (PrimitiveSingleProps | PrimitiveMultipleProps) & VariantProps<typeof accordionVariants>;
+export interface AccordionHandle {
+    getOpenItems: () => string[];
+    expand: (itemId: string) => void;
+    collapse: (itemId: string) => void;
+    clear: () => void;
+}
 export type AccordionItemProps = ComponentPropsWithoutRef<typeof AccordionPrimitive.Item> & VariantProps<typeof accordionItemVariants>;
 export type AccordionTriggerProps = ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger>;
 export type AccordionContentProps = ComponentPropsWithoutRef<typeof AccordionPrimitive.Content>;

package/dist/components/accordion/index.js

@@ -1,5 +1,5 @@
-import { A as r, a, b as n, c as e } from "../../_chunks/accordion-B6fyINUk.js";
-import { a as t } from "../../_chunks/accordion.agent-Cz-yglRa.js";
+import { A as r, a, b as n, c as e } from "../../_chunks/accordion-BEnrZmAn.js";
+import { a as t } from "../../_chunks/accordion.agent-BTjeO1Sx.js";
 export {
   r as Accordion,
   a as AccordionContent,

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

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

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

@@ -1,3 +1,4 @@
 export { AgendaCard, isSafeAgendaUrl } from './agenda-card';
 export type { AgendaCardProps, AgendaItem, AppointmentStatus, } from './agenda-card';
+export { agendaCardAgent } from './agenda-card.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,6 +1,8 @@
-import { A as r, i as d } from "../../_chunks/agenda-card-DIWDvWum.js";
+import { A as r, i as d } from "../../_chunks/agenda-card-DwLIxgi7.js";
+import { a as n } from "../../_chunks/agenda-card.agent-B_R47-c9.js";
 export {
   r as AgendaCard,
+  n as agendaCardAgent,
   d as isSafeAgendaUrl
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -4,7 +4,24 @@ import { type AgendaItem } from '../agenda-card';
 declare const agendaTrayVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export interface AgendaTrayProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick'>, VariantProps<typeof agendaTrayVariants> {
+/**
+ * Curated imperative handle for AgendaTray. Exposed as the forwardRef
+ * target so a future agent / MCP UI bridge can drive the tray without
+ * touching the DOM. See `agenda-tray.agent.ts`.
+ */
+export interface AgendaTrayHandle {
+    getItems: () => Array<{
+        id: string;
+        status: string;
+    }>;
+    selectItem: (id: string) => void;
+}
+export interface AgendaTrayProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick' | 'id'>, VariantProps<typeof agendaTrayVariants> {
+    /**
+     * Stable instance id. Surfaced on the root as `data-component-id` so
+     * an agent / MCP UI bridge can address this specific tray.
+     */
+    id?: string;
     items: AgendaItem[];
     /** Section title — rendered in the header. Localised by the consumer. */
     title?: string;
@@ -19,6 +36,6 @@ export interface AgendaTrayProps extends Omit<HTMLAttributes<HTMLElement>, 'onCl
     emptyTitle?: string;
     emptyDescription?: string;
 }
-export declare const AgendaTray: import("react").ForwardRefExoticComponent<AgendaTrayProps & import("react").RefAttributes<HTMLElement>>;
+export declare const AgendaTray: import("react").ForwardRefExoticComponent<AgendaTrayProps & import("react").RefAttributes<AgendaTrayHandle>>;
 export {};
 //# sourceMappingURL=agenda-tray.d.ts.map

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

@@ -1,3 +1,4 @@
 export { AgendaTray } from './agenda-tray';
-export type { AgendaTrayProps } from './agenda-tray';
+export type { AgendaTrayProps, AgendaTrayHandle } from './agenda-tray';
+export { agendaTrayAgent } from './agenda-tray.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,5 +1,6 @@
-import { A as e } from "../../_chunks/agenda-tray-BqQZwiHc.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-DUvengGQ.js";
 export {
-  e as AgendaTray
+  r as AgendaTray,
+  g as agendaTrayAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/ai-prompt-input/ai-prompt-input.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { AIPromptInputHandle } from './ai-prompt-input';
+export declare const aiPromptInputAgent: AgentAdapter<AIPromptInputHandle>;
+//# sourceMappingURL=ai-prompt-input.agent.d.ts.map

package/dist/components/ai-prompt-input/ai-prompt-input.d.ts

@@ -23,6 +23,23 @@ type NativeTextareaProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'si
 declare const rootVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** Curated imperative handle for agent / external automation. */
+export interface AIPromptInputHandle {
+    /** Current composer text. */
+    getValue: () => string;
+    /** True when text is empty and no attachments are pending. */
+    isEmpty: () => boolean;
+    /** True while a submit is in flight. */
+    isSubmitting: () => boolean;
+    /** Replace the composer text. */
+    setValue: (value: string) => void;
+    /** Clear text and attachments. */
+    clear: () => void;
+    /** Programmatically submit. */
+    submit: () => void;
+    /** Move keyboard focus into the textarea. */
+    focus: () => void;
+}
 export interface AIPromptInputProps extends NativeTextareaProps, VariantProps<typeof rootVariants> {
     /** Slash-command catalog. The DS owns the menu; apps own the commands. */
     commands?: AIPromptCommand[];
@@ -44,6 +61,6 @@ export interface AIPromptInputProps extends NativeTextareaProps, VariantProps<ty
     minRows?: number;
     maxRows?: number;
 }
-export declare const AIPromptInput: import("react").ForwardRefExoticComponent<AIPromptInputProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export declare const AIPromptInput: import("react").ForwardRefExoticComponent<AIPromptInputProps & import("react").RefAttributes<AIPromptInputHandle>>;
 export {};
 //# sourceMappingURL=ai-prompt-input.d.ts.map

package/dist/components/ai-prompt-input/index.d.ts

@@ -1,3 +1,4 @@
 export { AIPromptInput } from './ai-prompt-input';
-export type { AIPromptInputProps, AIPromptCommand, AIPromptModel, AIPromptAttachment, AIPromptSubmitPayload, } from './ai-prompt-input';
+export type { AIPromptInputProps, AIPromptInputHandle, AIPromptCommand, AIPromptModel, AIPromptAttachment, AIPromptSubmitPayload, } from './ai-prompt-input';
+export { aiPromptInputAgent } from './ai-prompt-input.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/ai-prompt-input/index.js

@@ -1,5 +1,6 @@
-import { A as r } from "../../_chunks/ai-prompt-input-CI27KmZ1.js";
+import { A as a, a as o } from "../../_chunks/ai-prompt-input.agent-0NHYLTWD.js";
 export {
-  r as AIPromptInput
+  a as AIPromptInput,
+  o as aiPromptInputAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/aspect-ratio/index.js

@@ -1,4 +1,4 @@
-import { A as e } from "../../_chunks/aspect-ratio-CxsdG8vk.js";
+import { A as e } from "../../_chunks/aspect-ratio-DeSNzASA.js";
 import { Root as r } from "@radix-ui/react-aspect-ratio";
 export {
   e as AspectRatio,

package/dist/components/audio-recorder/audio-recorder.agent.d.ts

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

package/dist/components/audio-recorder/audio-recorder.d.ts

@@ -3,6 +3,15 @@ import { type VariantProps } from 'class-variance-authority';
 declare const rootVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** Curated imperative handle for agent / external automation. */
+export interface AudioRecorderHandle {
+    isRecording: () => boolean;
+    getDuration: () => number;
+    hasRecording: () => boolean;
+    startRecording: () => Promise<void> | void;
+    stopRecording: () => void;
+    discard: () => void;
+}
 export interface AudioRecorderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onError'>, VariantProps<typeof rootVariants> {
     /** Called on stop with the final blob + duration in ms. */
     onRecordingComplete?: (blob: Blob, durationMs: number) => void;
@@ -21,6 +30,6 @@ export interface AudioRecorderProps extends Omit<HTMLAttributes<HTMLDivElement>,
      */
     maxBytes?: number | null;
 }
-export declare const AudioRecorder: import("react").ForwardRefExoticComponent<AudioRecorderProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const AudioRecorder: import("react").ForwardRefExoticComponent<AudioRecorderProps & import("react").RefAttributes<AudioRecorderHandle>>;
 export {};
 //# sourceMappingURL=audio-recorder.d.ts.map

package/dist/components/audio-recorder/index.d.ts

@@ -1,3 +1,4 @@
 export { AudioRecorder } from './audio-recorder';
-export type { AudioRecorderProps } from './audio-recorder';
+export type { AudioRecorderProps, AudioRecorderHandle } from './audio-recorder';
+export { audioRecorderAgent } from './audio-recorder.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/audio-recorder/index.js

@@ -1,5 +1,6 @@
-import { A as e } from "../../_chunks/audio-recorder-B-8SKgKn.js";
+import { A as r, a } from "../../_chunks/audio-recorder.agent--VKeykUp.js";
 export {
-  e as AudioRecorder
+  r as AudioRecorder,
+  a as audioRecorderAgent
 };
 //# sourceMappingURL=index.js.map

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

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

package/dist/components/autocomplete/autocomplete.d.ts

@@ -5,6 +5,16 @@ declare const autocompleteVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
     tone?: "default" | "error" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface AutocompleteHandle {
+    getValue: () => string | null;
+    getQuery: () => string;
+    getIsOpen: () => boolean;
+    setValue: (value: string | null) => void;
+    setQuery: (query: string) => void;
+    clear: () => void;
+    open: () => void;
+    close: () => void;
+}
 type CVAProps = VariantProps<typeof autocompleteVariants>;
 export interface AutocompleteProps<T extends string = string> extends Pick<CVAProps, 'size' | 'tone'> {
     loadOptions: (query: string, opts: {

package/dist/components/autocomplete/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o, b as m } from "../../_chunks/autocomplete.agent-DqOy0_1P.js";
+import { A as e, a as o, b as m } from "../../_chunks/autocomplete.agent-Dh7KioS6.js";
 export {
   e as Autocomplete,
   o as autocompleteAgent,

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

@@ -0,0 +1,8 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { BreadcrumbHandle } from './breadcrumb';
+export interface BreadcrumbAgentItem {
+    id: string;
+    href?: string;
+}
+export declare const breadcrumbAgent: AgentAdapter<BreadcrumbHandle>;
+//# sourceMappingURL=breadcrumb.agent.d.ts.map

package/dist/components/breadcrumb/breadcrumb.d.ts

@@ -1,7 +1,7 @@
 import { type AnchorHTMLAttributes, type ComponentPropsWithoutRef, type ReactElement, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 type SeparatorVariant = 'chevron' | 'slash';
-export interface BreadcrumbProps extends ComponentPropsWithoutRef<'nav'> {
+export interface BreadcrumbProps extends Omit<ComponentPropsWithoutRef<'nav'>, 'id'> {
     /** Override the default `aria-label` (falls back to translated `ui.navigation.breadcrumb.label`). */
     'aria-label'?: string;
     /** Separator glyph between items. @default 'chevron' */
@@ -14,8 +14,27 @@ export interface BreadcrumbProps extends ComponentPropsWithoutRef<'nav'> {
     itemsAfterCollapse?: number;
     /** If true, disables collapse behaviour. */
     disableCollapse?: boolean;
+    /**
+     * Consumer-supplied instance id, surfaced as `data-component-id` so an
+     * agent / UI bridge can address this instance.
+     */
+    id?: string;
 }
-declare const Breadcrumb: import("react").ForwardRefExoticComponent<BreadcrumbProps & import("react").RefAttributes<HTMLElement>>;
+/**
+ * Imperative handle for agent-readiness.
+ *
+ * Items expose their stable id (`BreadcrumbItem` `id` prop, falling back
+ * to the `BreadcrumbLink` href) and href — never their visible label,
+ * which may contain PHI (see PRS §26 §6.1).
+ */
+export interface BreadcrumbHandle {
+    getItems: () => Array<{
+        id: string;
+        href?: string;
+    }>;
+    navigateTo: (id: string) => void;
+}
+declare const Breadcrumb: import("react").ForwardRefExoticComponent<BreadcrumbProps & import("react").RefAttributes<BreadcrumbHandle>>;
 export interface BreadcrumbListProps extends ComponentPropsWithoutRef<'ol'> {
     maxItems?: number;
     itemsBeforeCollapse?: number;

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

@@ -1,3 +1,4 @@
 export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbSeparator, BreadcrumbEllipsis, } from './breadcrumb';
-export type { BreadcrumbProps, BreadcrumbListProps, BreadcrumbItemProps, BreadcrumbLinkProps, BreadcrumbSeparatorProps, BreadcrumbEllipsisProps, } from './breadcrumb';
+export type { BreadcrumbProps, BreadcrumbHandle, BreadcrumbListProps, BreadcrumbItemProps, BreadcrumbLinkProps, BreadcrumbSeparatorProps, BreadcrumbEllipsisProps, } from './breadcrumb';
+export { breadcrumbAgent } from './breadcrumb.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/breadcrumb/index.js

@@ -1,10 +1,11 @@
-import { B as e, a as s, b as m, c as b, d as c, e as d } from "../../_chunks/breadcrumb-D6xpsP7n.js";
+import { B as e, a as s, b, c as m, d as c, e as d, f as u } from "../../_chunks/breadcrumb.agent-GM2hAKFX.js";
 export {
   e as Breadcrumb,
   s as BreadcrumbEllipsis,
-  m as BreadcrumbItem,
-  b as BreadcrumbLink,
+  b as BreadcrumbItem,
+  m as BreadcrumbLink,
   c as BreadcrumbList,
-  d as BreadcrumbSeparator
+  d as BreadcrumbSeparator,
+  u as breadcrumbAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/button/button.d.ts

@@ -1,7 +1,7 @@
 import { type ButtonHTMLAttributes } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const buttonVariants: (props?: ({
-    intent?: "primary" | "secondary" | "outline" | "ghost" | "destructive" | "link" | "tonal" | null | undefined;
+    intent?: "link" | "primary" | "secondary" | "outline" | "ghost" | "destructive" | "tonal" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {

package/dist/components/chart/chart.d.ts

@@ -10,6 +10,8 @@ export interface ChartSeries {
 export interface ChartProps extends VariantProps<typeof chartVariants> {
     /** Required — drives aria-label and sr-only table caption. */
     title: string;
+    /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
+    id?: string;
     /** Chart visual type. */
     type: ChartType;
     /**

package/dist/components/chart/index.js

@@ -1,4 +1,4 @@
-import { C as t, c as s, a as c } from "../../_chunks/chart.agent-BdS-_8MO.js";
+import { C as t, c as s, a as c } from "../../_chunks/chart.agent-_pRYS17d.js";
 export {
   t as Chart,
   s as chartAgent,

package/dist/components/chat-container/chat-container.d.ts

@@ -9,7 +9,9 @@ export interface ChatContainerHandle {
     }) => void;
     getScrollViewport: () => HTMLDivElement | null;
 }
-export interface ChatContainerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof rootVariants> {
+export interface ChatContainerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'id'>, VariantProps<typeof rootVariants> {
+    /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
+    id?: string;
     /** Array of messages to render. When the array exceeds 100 items the
      *  list is virtualised via @tanstack/react-virtual. */
     messages: Array<{

package/dist/components/chat-container/index.js

@@ -1,5 +1,5 @@
-import { C as o } from "../../_chunks/chat-container-Cm3SlR2p.js";
-import { c as e } from "../../_chunks/chat-container.agent-Dhw9xCJt.js";
+import { C as o } from "../../_chunks/chat-container-Dl0Kfy5a.js";
+import { c as e } from "../../_chunks/chat-container.agent-CM4WModE.js";
 export {
   o as ChatContainer,
   e as chatContainerAgent

package/dist/components/chat-input/chat-input.agent.d.ts

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

package/dist/components/chat-input/chat-input.d.ts

@@ -4,6 +4,15 @@ declare const rootVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type NativeTextareaProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'size' | 'onSubmit' | 'children'>;
+/** Curated imperative handle for agent / external automation. */
+export interface ChatInputHandle {
+    getValue: () => string;
+    isEmpty: () => boolean;
+    setValue: (value: string) => void;
+    clear: () => void;
+    submit: () => void;
+    focus: () => void;
+}
 export interface ChatInputProps extends NativeTextareaProps, VariantProps<typeof rootVariants> {
     /** Invoked when the user submits (Cmd/Ctrl+Enter, or send button). */
     onSubmit?: (text: string) => void;
@@ -27,6 +36,6 @@ export interface ChatInputProps extends NativeTextareaProps, VariantProps<typeof
     /** Visible label above the textarea. When omitted, a visually-hidden label is used. */
     label?: string;
 }
-export declare const ChatInput: import("react").ForwardRefExoticComponent<ChatInputProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export declare const ChatInput: import("react").ForwardRefExoticComponent<ChatInputProps & import("react").RefAttributes<ChatInputHandle>>;
 export {};
 //# sourceMappingURL=chat-input.d.ts.map

package/dist/components/chat-input/index.d.ts

@@ -1,3 +1,4 @@
 export { ChatInput } from './chat-input';
-export type { ChatInputProps } from './chat-input';
+export type { ChatInputProps, ChatInputHandle } from './chat-input';
+export { chatInputAgent } from './chat-input.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/chat-input/index.js

@@ -1,5 +1,7 @@
-import { C as o } from "../../_chunks/chat-input-DreOPP8A.js";
+import { C as o } from "../../_chunks/chat-input-C_tMQv92.js";
+import { c as r } from "../../_chunks/chat-input.agent-Bsz3ckGa.js";
 export {
-  o as ChatInput
+  o as ChatInput,
+  r as chatInputAgent
 };
 //# sourceMappingURL=index.js.map

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

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

package/dist/components/checkbox/checkbox.d.ts

@@ -1,6 +1,12 @@
 import { type ComponentPropsWithoutRef } from 'react';
 import * as RadixCheckbox from '@radix-ui/react-checkbox';
 import { type VariantProps } from 'class-variance-authority';
+/** Agent-readiness curated handle for Checkbox. */
+export interface CheckboxHandle {
+    getChecked: () => boolean | 'indeterminate';
+    setChecked: (checked: boolean | 'indeterminate') => void;
+    toggle: () => void;
+}
 declare const checkboxVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;

package/dist/components/checkbox/index.js

@@ -1,4 +1,4 @@
-import { C as x, a as C, u as a } from "../../_chunks/checkbox-DNK4qS2_.js";
+import { C as x, a as C, u as a } from "../../_chunks/checkbox-CtPM6Rup.js";
 export {
   x as Checkbox,
   C as CheckboxGroupContext,

package/dist/components/checkbox-group/checkbox-group.agent.d.ts

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

package/dist/components/checkbox-group/checkbox-group.d.ts

@@ -1,5 +1,11 @@
 import { type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
+/** Agent-readiness curated handle for CheckboxGroup. */
+export interface CheckboxGroupHandle {
+    getSelection: () => string[];
+    setSelection: (ids: string[]) => void;
+    clearSelection: () => void;
+}
 declare const checkboxGroupVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
@@ -13,6 +19,8 @@ export interface CheckboxGroupProps extends VariantProps<typeof checkboxGroupVar
     value?: string[];
     onChange?: (value: string[]) => void;
     name?: string;
+    /** Stable id, used to address this instance from the agent runtime. */
+    id?: string;
     orientation?: 'vertical' | 'horizontal';
     disabled?: boolean;
     min?: number;

package/dist/components/checkbox-group/index.js

@@ -1,4 +1,4 @@
-import { C as e } from "../../_chunks/checkbox-group-CWpGZEF6.js";
+import { C as e } from "../../_chunks/checkbox-group-BTdEB6Yo.js";
 export {
   e as CheckboxGroup
 };

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

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

package/dist/components/collapsible/collapsible.d.ts

@@ -9,9 +9,16 @@ type TriggerProps = ComponentPropsWithoutRef<typeof CollapsiblePrimitive.Trigger
 type PrimitiveContentProps = ComponentPropsWithoutRef<typeof CollapsiblePrimitive.Content>;
 export interface CollapsibleProps extends Omit<RootProps, 'asChild'>, VariantProps<typeof collapsibleVariants> {
 }
+/** Curated imperative handle for agent / external automation. */
+export interface CollapsibleHandle {
+    isOpen: () => boolean;
+    toggle: () => void;
+    open: () => void;
+    close: () => void;
+}
 export type CollapsibleTriggerProps = TriggerProps;
 export type CollapsibleContentProps = PrimitiveContentProps;
-export declare const Collapsible: import("react").ForwardRefExoticComponent<CollapsibleProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const Collapsible: import("react").ForwardRefExoticComponent<CollapsibleProps & import("react").RefAttributes<CollapsibleHandle>>;
 export declare const CollapsibleTrigger: import("react").ForwardRefExoticComponent<Omit<CollapsiblePrimitive.CollapsibleTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
 export declare const CollapsibleContent: import("react").ForwardRefExoticComponent<Omit<CollapsiblePrimitive.CollapsibleContentProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 export {};

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

@@ -1,3 +1,4 @@
 export { Collapsible, CollapsibleTrigger, CollapsibleContent } from './collapsible';
-export type { CollapsibleProps, CollapsibleTriggerProps, CollapsibleContentProps } from './collapsible';
+export type { CollapsibleProps, CollapsibleHandle, CollapsibleTriggerProps, CollapsibleContentProps, } from './collapsible';
+export { collapsibleAgent } from './collapsible.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/collapsible/index.js

@@ -1,7 +1,8 @@
-import { C as e, a as o, b as s } from "../../_chunks/collapsible-D4LOdLxp.js";
+import { C as e, a as s, b as o, c as b } from "../../_chunks/collapsible.agent-DkS1jVyn.js";
 export {
   e as Collapsible,
-  o as CollapsibleContent,
-  s as CollapsibleTrigger
+  s as CollapsibleContent,
+  o as CollapsibleTrigger,
+  b as collapsibleAgent
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -1,3 +1,8 @@
+/** Agent-readiness curated handle for ColorPicker. */
+export interface ColorPickerHandle {
+    getValue: () => string;
+    setValue: (hex: string) => void;
+}
 import { type PaletteSwatch } from './palettes';
 export interface ColorPickerProps {
     value?: string;

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

@@ -1,4 +1,4 @@
-import { A as E, B as P, C as o } from "../../_chunks/color-picker-e9PmpaGH.js";
+import { A as E, B as P, C as o } from "../../_chunks/color-picker-94qcBZqZ.js";
 export {
   E as APPOINTMENT_PALETTE,
   P as BRAND_PALETTE,

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

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

package/dist/components/combobox/combobox.d.ts

@@ -1,6 +1,16 @@
 import { type ReactElement, type ReactNode, type Ref } from 'react';
 import type { OptionShape } from '../_shared/option';
 export type ComboboxOption<T extends string = string> = OptionShape<T>;
+export interface ComboboxHandle {
+    getValue: () => string | null;
+    getQuery: () => string;
+    getIsOpen: () => boolean;
+    setValue: (value: string | null) => void;
+    setQuery: (query: string) => void;
+    clear: () => void;
+    open: () => void;
+    close: () => void;
+}
 export interface ComboboxProps<T extends string = string> {
     options: ComboboxOption<T>[];
     value?: T | '';

package/dist/components/combobox/index.js

@@ -1,4 +1,4 @@
-import { C as b, c as s, a as t, b as m, d as n, e as r } from "../../_chunks/combobox.agent-ByobCLJ_.js";
+import { C as b, c as s, a as t, b as m, d as n, e as r } from "../../_chunks/combobox.agent-CAvUkkIe.js";
 export {
   b as Combobox,
   s as comboboxAgent,

package/dist/components/command-palette/command-palette.agent.d.ts

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

package/dist/components/command-palette/command-palette.d.ts

@@ -17,6 +17,13 @@ export declare function useCommandPalette(): {
 };
 export interface CommandPaletteRootProps extends ComponentPropsWithoutRef<typeof CommandPrimitive> {
 }
+export interface CommandPaletteHandle {
+    getQuery: () => string;
+    getIsOpen: () => boolean;
+    open: () => void;
+    close: () => void;
+    setQuery: (query: string) => void;
+}
 declare const CommandPalette: import("react").ForwardRefExoticComponent<CommandPaletteRootProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface CommandInputProps extends ComponentPropsWithoutRef<typeof CommandPrimitive.Input> {
 }