@alfadocs/ui-kit 0.1.8 → 0.1.9

package/dist/components/search-bar/search-bar.d.ts

@@ -29,7 +29,33 @@ type SharedProps = {
     /** Platform-aware shortcut pill — default `true` (hidden below `md` breakpoint). */
     shortcutHint?: boolean;
     className?: string;
+    /**
+     * Consumer-supplied instance id, surfaced as `data-component-id` so an
+     * agent / UI bridge can address this instance.
+     */
+    id?: string;
+    /**
+     * Called when an external driver (agent adapter) asks the host to apply
+     * a saved search by id. The host is responsible for resolving the saved
+     * search and feeding the resulting query back through `value` /
+     * `onQueryChange`. No-op when not provided.
+     */
+    onApplySavedSearch?: (id: string) => void;
 };
+/**
+ * Imperative handle for agent-readiness + programmatic control. Replaces
+ * the previously-forwarded `HTMLDivElement` ref. Consumers who needed the
+ * DOM element for layout queries should wrap the SearchBar in their own
+ * div with a ref attached.
+ */
+export interface SearchBarHandle {
+    getQuery: () => string;
+    setQuery: (query: string) => void;
+    clear: () => void;
+    submit: () => void;
+    focus: () => void;
+    applySavedSearch: (id: string) => void;
+}
 type LauncherProps = SharedProps & {
     mode?: 'launcher';
     /** Called on click / Enter / global Cmd/Ctrl+K. */
@@ -54,6 +80,6 @@ type InlineProps = SharedProps & {
 };
 export type SearchBarProps = (LauncherProps | InlineProps) & Omit<HTMLAttributes<HTMLDivElement>, 'role' | 'onChange' | 'children' | 'defaultValue' | 'results'> & VariantProps<typeof launcherVariants>;
 export declare function filterSearchResults(query: string, groups: SearchBarResultGroup[]): SearchBarResultGroup[];
-export declare const SearchBar: import("react").ForwardRefExoticComponent<SearchBarProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const SearchBar: import("react").ForwardRefExoticComponent<SearchBarProps & import("react").RefAttributes<SearchBarHandle>>;
 export {};
 //# sourceMappingURL=search-bar.d.ts.map

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

@@ -1,3 +1,4 @@
 export { SearchInput } from './search-input';
-export type { SearchInputProps } from './search-input';
+export type { SearchInputProps, SearchInputHandle } from './search-input';
+export { searchInputAgent } from './search-input.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,5 +1,7 @@
-import { S as e } from "../../_chunks/search-input-BVMCONyN.js";
+import { S as t } from "../../_chunks/search-input-Xw3cdWXW.js";
+import { s as o } from "../../_chunks/search-input.agent-CfZvViOd.js";
 export {
-  e as SearchInput
+  t as SearchInput,
+  o as searchInputAgent
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -23,6 +23,33 @@ export interface SearchInputProps {
     'aria-controls'?: string;
     'aria-activedescendant'?: string;
 }
+/**
+ * Imperative handle for agent-readiness + programmatic control.
+ *
+ * The forwarded ref intersects the underlying `HTMLInputElement` so
+ * existing consumers (`ref.current.focus()` etc.) keep working — we
+ * mutate the live input element to add the curated methods rather than
+ * returning a new object from `useImperativeHandle`.
+ */
+export interface SearchInputHandle {
+    getQuery: () => string;
+    setQuery: (query: string) => void;
+    clear: () => void;
+    submit: () => void;
+    /**
+     * Expand-aware focus. Named `agentFocus` rather than `focus` because
+     * the handle is grafted onto the underlying `HTMLInputElement` and the
+     * native `focus` slot is non-writable.
+     */
+    agentFocus: () => void;
+}
+/**
+ * Backwards-compatible alias retained for one release cycle — the
+ * forwarded ref's value is structurally an `HTMLInputElement` with the
+ * `SearchInputHandle` methods grafted on. Consumers can read it as
+ * either type via a cast.
+ */
+export type SearchInputRefValue = HTMLInputElement & SearchInputHandle;
 export declare const SearchInput: import("react").ForwardRefExoticComponent<SearchInputProps & import("react").RefAttributes<HTMLInputElement>>;
 export {};
 //# sourceMappingURL=search-input.d.ts.map

package/dist/components/select/index.js

@@ -1,4 +1,4 @@
-import { S as a, a as l, b as S, c, d as s, e as o, f as r, g as p, h as g, i, j as m } from "../../_chunks/select-IY_JQa-F.js";
+import { S as a, a as l, b as S, c, d as s, e as o, f as r, g as p, h as g, i, j as m } from "../../_chunks/select-DY1Cb2Tg.js";
 export {
   a as Select,
   l as SelectContent,

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

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

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

@@ -1,4 +1,13 @@
 import { type ComponentPropsWithoutRef, type ReactElement, type ReactNode, type Ref } from 'react';
+/** Agent-readiness curated handle for Select. */
+export interface SelectHandle {
+    getValue: () => string;
+    setValue: (value: string) => void;
+    clear: () => void;
+    open: () => void;
+    close: () => void;
+    isOpen: () => boolean;
+}
 import * as RadixSelect from '@radix-ui/react-select';
 import { type VariantProps } from 'class-variance-authority';
 import type { OptionShape } from '../_shared/option';

package/dist/components/sheet/index.js

@@ -1,5 +1,5 @@
-import { S as o } from "../../_chunks/sheet-BhNpLHc9.js";
-import { s } from "../../_chunks/sheet.agent-DwQlBqK9.js";
+import { S as o } from "../../_chunks/sheet-B9kH9pcI.js";
+import { s } from "../../_chunks/sheet.agent-QAyTOxgk.js";
 export {
   o as Sheet,
   s as sheetAgent

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

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

package/dist/components/sheet/sheet.d.ts

@@ -4,6 +4,15 @@ import { type VariantProps } from 'class-variance-authority';
 declare const contentVariants: (props?: ({
     side?: "top" | "end" | "bottom" | "start" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface SheetHandle {
+    getIsOpen: () => boolean;
+    open: () => void;
+    close: () => void;
+}
+export interface SheetRootProps extends ComponentPropsWithoutRef<typeof RadixDialog.Root> {
+    /** Opaque instance id — forwarded to Sheet.Content as `data-component-id`. */
+    id?: string;
+}
 export interface SheetContentProps extends Omit<ComponentPropsWithoutRef<typeof RadixDialog.Content>, 'className'>, VariantProps<typeof contentVariants> {
     side?: 'start' | 'end' | 'top' | 'bottom';
     size?: 'sm' | 'md' | 'lg';
@@ -11,11 +20,11 @@ export interface SheetContentProps extends Omit<ComponentPropsWithoutRef<typeof
     children: ReactNode;
 }
 export declare const Sheet: {
-    ({ children, ...props }: ComponentPropsWithoutRef<typeof RadixDialog.Root>): import("react/jsx-runtime").JSX.Element;
+    ({ children, id, ...props }: SheetRootProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 } & {
     Root: {
-        ({ children, ...props }: ComponentPropsWithoutRef<typeof RadixDialog.Root>): import("react/jsx-runtime").JSX.Element;
+        ({ children, id, ...props }: SheetRootProps): 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/sidebar/index.js

@@ -1,5 +1,5 @@
-import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as l, k as c, l as p, m as I, n as g, o as u, p as P, u as f, q as B } from "../../_chunks/sidebar-OVzwN3jE.js";
-import { s as h } from "../../_chunks/sidebar.agent-B0fnH9CC.js";
+import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as l, k as c, l as p, m as I, n as g, o as u, p as P, u as f, q as B } from "../../_chunks/sidebar-CHF5xr_P.js";
+import { s as h } from "../../_chunks/sidebar.agent-C9TM_ZDZ.js";
 export {
   r as Sidebar,
   i as SidebarBody,

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

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

package/dist/components/sidebar/sidebar.d.ts

@@ -10,6 +10,12 @@ export interface SidebarContextValue {
 }
 export declare const useSidebar: () => SidebarContextValue;
 export declare function usePersistentState<T>(storageKey: string, initial: T | (() => T)): [T, (value: T | ((prev: T) => T)) => void];
+export interface SidebarHandle {
+    getIsCollapsed: () => boolean;
+    getActiveItem: () => string | null;
+    toggleCollapsed: () => void;
+    selectItem: (id: string) => void;
+}
 export interface SidebarProps extends ComponentPropsWithoutRef<'nav'> {
     /** Visual mode. Controlled via `onStateChange`. @default 'expanded' */
     state?: SidebarMode;

package/dist/components/signature-capture/index.js

@@ -1,4 +1,4 @@
-import { S as r, s as t } from "../../_chunks/signature-capture.agent-C38VPXxg.js";
+import { S as r, s as t } from "../../_chunks/signature-capture.agent-BpeDwFht.js";
 export {
   r as SignatureCapture,
   t as signatureCaptureAgent

package/dist/components/signature-capture/signature-capture.d.ts

@@ -16,6 +16,8 @@ export interface SignatureConfirmPayload {
     strokes?: PointGroup[];
 }
 export interface SignatureCaptureProps {
+    /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
+    id?: string;
     /** Called with the export payload when the user confirms the signature. */
     onConfirm?: (payload: SignatureConfirmPayload) => void;
     /** Called after the pad is cleared (explicit user action). */

package/dist/components/slider/index.js

@@ -1,4 +1,4 @@
-import { S as o } from "../../_chunks/slider-DjyRt3Mp.js";
+import { S as o } from "../../_chunks/slider-CcsQTZTA.js";
 export {
   o as Slider
 };

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

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

package/dist/components/slider/slider.d.ts

@@ -1,4 +1,9 @@
 import { type ComponentPropsWithoutRef } from 'react';
+/** Agent-readiness curated handle for Slider. */
+export interface SliderHandle {
+    getValue: () => number[];
+    setValue: (value: number[]) => void;
+}
 import * as RadixSlider from '@radix-ui/react-slider';
 import { type VariantProps } from 'class-variance-authority';
 export interface SliderMark {

package/dist/components/sparkline/index.js

@@ -1,4 +1,4 @@
-import { S as r, s, u as n } from "../../_chunks/sparkline.agent-C_xp3NRB.js";
+import { S as r, s, u as n } from "../../_chunks/sparkline.agent-56Sj7nOP.js";
 export {
   r as Sparkline,
   s as sparklineAgent,

package/dist/components/stepper-accordion/index.d.ts

@@ -1,4 +1,5 @@
 export { StepperAccordion } from './stepper-accordion';
-export type { StepperAccordionProps, AccordionStepSpec, } from './stepper-accordion';
+export type { StepperAccordionProps, StepperAccordionHandle, AccordionStepSpec, } from './stepper-accordion';
+export { stepperAccordionAgent } from './stepper-accordion.agent';
 export type { StepSpec, StepStatus, StepState } from '../_shared/stepper';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/stepper-accordion/index.js

@@ -1,5 +1,6 @@
-import { S as e } from "../../_chunks/stepper-accordion-CGog0JSF.js";
+import { S as r, s as p } from "../../_chunks/stepper-accordion.agent-ckKYZCIP.js";
 export {
-  e as StepperAccordion
+  r as StepperAccordion,
+  p as stepperAccordionAgent
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -26,7 +26,25 @@ export interface StepperAccordionProps extends Omit<ComponentPropsWithoutRef<typ
     onStepChange?: (index: number) => void;
     /** Override the default `aria-label` on the list wrapper. */
     'aria-label'?: string;
+    /**
+     * Consumer-supplied instance id, surfaced as `data-component-id` so an
+     * agent / UI bridge can address this instance.
+     */
+    id?: string;
+}
+/**
+ * Imperative handle for agent-readiness. Routes state mutations through
+ * the consumer's `onStepChange`, never mutating directly.
+ */
+export interface StepperAccordionHandle {
+    getCurrentStep: () => number;
+    getTotalSteps: () => number;
+    /** Indices of currently-open panels — singleton under Radix `type="single"`. */
+    getOpenSteps: () => number[];
+    gotoStep: (step: number) => void;
+    next: () => void;
+    previous: () => void;
 }
-declare const StepperAccordion: import("react").ForwardRefExoticComponent<StepperAccordionProps & import("react").RefAttributes<HTMLDivElement>>;
+declare const StepperAccordion: import("react").ForwardRefExoticComponent<StepperAccordionProps & import("react").RefAttributes<StepperAccordionHandle>>;
 export { StepperAccordion };
 //# sourceMappingURL=stepper-accordion.d.ts.map

package/dist/components/stepper-calendar/index.d.ts

@@ -1,3 +1,4 @@
 export { StepperCalendar } from './stepper-calendar';
-export type { StepperCalendarProps, StepperCalendarValue, ServiceOption, } from './stepper-calendar';
+export type { StepperCalendarProps, StepperCalendarHandle, StepperCalendarValue, ServiceOption, } from './stepper-calendar';
+export { stepperCalendarAgent } from './stepper-calendar.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/stepper-calendar/index.js

@@ -1,5 +1,6 @@
-import { S as a } from "../../_chunks/stepper-calendar-_fLOAjus.js";
+import { S as r, s as p } from "../../_chunks/stepper-calendar.agent-9iT3ClIB.js";
 export {
-  a as StepperCalendar
+  r as StepperCalendar,
+  p as stepperCalendarAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/stepper-calendar/stepper-calendar.agent.d.ts

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

package/dist/components/stepper-calendar/stepper-calendar.d.ts

@@ -38,7 +38,25 @@ export interface StepperCalendarProps extends Omit<ComponentPropsWithoutRef<'div
     /** Per-step status overrides — `error` will mark a step in the rail. */
     stepStatuses?: Partial<Record<0 | 1 | 2 | 3, StepStatus>>;
     'aria-label'?: string;
+    /**
+     * Consumer-supplied instance id, surfaced as `data-component-id` so an
+     * agent / UI bridge can address this instance.
+     */
+    id?: string;
 }
-declare const StepperCalendar: import("react").ForwardRefExoticComponent<StepperCalendarProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Imperative handle for agent-readiness. The booking value itself is
+ * owned by the consumer through `value` / `onChange`, so the handle
+ * deliberately exposes only step navigation — not the selected
+ * service / date / time.
+ */
+export interface StepperCalendarHandle {
+    getCurrentStep: () => number;
+    getTotalSteps: () => number;
+    gotoStep: (step: number) => void;
+    next: () => void;
+    previous: () => void;
+}
+declare const StepperCalendar: import("react").ForwardRefExoticComponent<StepperCalendarProps & import("react").RefAttributes<StepperCalendarHandle>>;
 export { StepperCalendar };
 //# sourceMappingURL=stepper-calendar.d.ts.map

package/dist/components/stepper-progress/index.d.ts

@@ -1,3 +1,4 @@
 export { StepperProgress } from './stepper-progress';
-export type { StepperProgressProps } from './stepper-progress';
+export type { StepperProgressProps, StepperProgressHandle } from './stepper-progress';
+export { stepperProgressAgent } from './stepper-progress.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/stepper-progress/index.js

@@ -1,5 +1,7 @@
-import { S as o } from "../../_chunks/stepper-progress-rE7tn7WY.js";
+import { S as s } from "../../_chunks/stepper-progress-Bmen-YXB.js";
+import { s as p } from "../../_chunks/stepper-progress.agent-q9InWca4.js";
 export {
-  o as StepperProgress
+  s as StepperProgress,
+  p as stepperProgressAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/stepper-progress/stepper-progress.agent.d.ts

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

package/dist/components/stepper-progress/stepper-progress.d.ts

@@ -22,7 +22,32 @@ export interface StepperProgressProps extends Omit<ComponentPropsWithoutRef<'div
     size?: Size;
     /** Caption position relative to the bar. @default 'top' */
     captionPosition?: CaptionPosition;
+    /**
+     * Consumer-supplied instance id, surfaced as `data-component-id` so an
+     * agent / UI bridge can address this instance.
+     */
+    id?: string;
+    /**
+     * Called when an external driver (agent adapter) requests a step change.
+     * StepperProgress is a pure indicator and does not own step state itself
+     * — this hook lets a host wizard react to agent-driven navigation.
+     */
+    onStepChange?: (next: number) => void;
 }
-declare const StepperProgress: import("react").ForwardRefExoticComponent<StepperProgressProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Imperative handle for agent-readiness. Exposed via `ref`.
+ *
+ * The handle is the surface the future MCP UI bridge invokes through the
+ * runtime registry. Methods are pure functions of the current props +
+ * internal state; mutations route through the consumer's `onStepChange`.
+ */
+export interface StepperProgressHandle {
+    getCurrentStep: () => number;
+    getTotalSteps: () => number;
+    gotoStep: (step: number) => void;
+    next: () => void;
+    previous: () => void;
+}
+declare const StepperProgress: import("react").ForwardRefExoticComponent<StepperProgressProps & import("react").RefAttributes<StepperProgressHandle>>;
 export { StepperProgress };
 //# sourceMappingURL=stepper-progress.d.ts.map

package/dist/components/suggestion-chip/index.d.ts

@@ -1,3 +1,4 @@
 export { SuggestionChip, SuggestionChipGroup } from './suggestion-chip';
-export type { SuggestionChipProps, SuggestionChipGroupProps, } from './suggestion-chip';
+export type { SuggestionChipProps, SuggestionChipHandle, SuggestionChipGroupProps, } from './suggestion-chip';
+export { suggestionChipAgent } from './suggestion-chip.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/suggestion-chip/index.js

@@ -1,6 +1,8 @@
-import { S as i, a as p } from "../../_chunks/suggestion-chip-BNJ2M8Os.js";
+import { S as g, a as e } from "../../_chunks/suggestion-chip-DhFrkRPj.js";
+import { s as p } from "../../_chunks/suggestion-chip.agent-6sNWFj7m.js";
 export {
-  i as SuggestionChip,
-  p as SuggestionChipGroup
+  g as SuggestionChip,
+  e as SuggestionChipGroup,
+  p as suggestionChipAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/suggestion-chip/suggestion-chip.agent.d.ts

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

package/dist/components/suggestion-chip/suggestion-chip.d.ts

@@ -10,6 +10,12 @@ export interface SuggestionChipGroupProps extends Omit<HTMLAttributes<HTMLDivEle
 }
 export declare const SuggestionChipGroup: import("react").ForwardRefExoticComponent<SuggestionChipGroupProps & import("react").RefAttributes<HTMLDivElement>>;
 type NativeButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onSelect' | 'children'>;
+/** Curated imperative handle for agent / external automation. */
+export interface SuggestionChipHandle {
+    getValue: () => string;
+    select: () => void;
+    dismiss: () => void;
+}
 export interface SuggestionChipProps extends NativeButtonProps, VariantProps<typeof chipVariants> {
     /** Value emitted on activation. Falls back to children when a string. */
     value?: string;
@@ -23,6 +29,6 @@ export interface SuggestionChipProps extends NativeButtonProps, VariantProps<typ
     /** Opt out of self-removal — useful inside controlled lists. */
     keepOnSelect?: boolean;
 }
-export declare const SuggestionChip: import("react").ForwardRefExoticComponent<SuggestionChipProps & import("react").RefAttributes<HTMLButtonElement>>;
+export declare const SuggestionChip: import("react").ForwardRefExoticComponent<SuggestionChipProps & import("react").RefAttributes<SuggestionChipHandle>>;
 export {};
 //# sourceMappingURL=suggestion-chip.d.ts.map

package/dist/components/switch/index.js

@@ -1,4 +1,4 @@
-import { S as t } from "../../_chunks/switch-aN2EYxHh.js";
+import { S as t } from "../../_chunks/switch-BYEH8I53.js";
 export {
   t as Switch
 };

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

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

package/dist/components/switch/switch.d.ts

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

package/dist/components/tabs/index.js

@@ -1,4 +1,4 @@
-import { T as t, a as b, b as T, c as e, t as r } from "../../_chunks/tabs.agent-BpbVA-Zh.js";
+import { T as t, a as b, b as T, c as e, t as r } from "../../_chunks/tabs.agent-h7NvsTR1.js";
 export {
   t as Tabs,
   b as TabsContent,

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

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

package/dist/components/tabs/tabs.d.ts

@@ -11,6 +11,10 @@ export declare const tabsTriggerVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type TabsOverflow = 'dropdown' | 'select';
+export interface TabsHandle {
+    getActiveTab: () => string | null;
+    selectTab: (value: string) => void;
+}
 export interface TabsRootProps extends Omit<ComponentPropsWithoutRef<typeof TabsPrimitive.Root>, 'orientation'> {
     variant?: 'default' | 'underlined' | 'pills';
     size?: 'sm' | 'md' | 'lg';

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

@@ -1,3 +1,4 @@
 export { TaskCard, isSafeTaskUrl } from './task-card';
 export type { TaskCardProps, TaskItem, TaskStatus, TaskPriority, } from './task-card';
+export { taskCardAgent } from './task-card.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,6 +1,8 @@
-import { T as r, i as T } from "../../_chunks/task-card-yW7tKlG4.js";
+import { T as s, i as t } from "../../_chunks/task-card-CY5ztNkU.js";
+import { t as o } from "../../_chunks/task-card.agent-CUPKYd7w.js";
 export {
-  r as TaskCard,
-  T as isSafeTaskUrl
+  s as TaskCard,
+  t as isSafeTaskUrl,
+  o as taskCardAgent
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -1,3 +1,4 @@
 export { TaskTray } from './task-tray';
-export type { TaskTrayProps } from './task-tray';
+export type { TaskTrayProps, TaskTrayHandle } from './task-tray';
+export { taskTrayAgent } from './task-tray.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,5 +1,6 @@
-import { T } from "../../_chunks/task-tray-BzahI5FQ.js";
+import { T as s, t } from "../../_chunks/task-tray-CCoUdorl.js";
 export {
-  T as TaskTray
+  s as TaskTray,
+  t as taskTrayAgent
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -4,7 +4,26 @@ import { type TaskItem } from '../task-card';
 declare const taskTrayVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export interface TaskTrayProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick'>, VariantProps<typeof taskTrayVariants> {
+/**
+ * Curated imperative handle for TaskTray. Exposed as the forwardRef
+ * target so a future agent / MCP UI bridge can drive the tray without
+ * touching the DOM. See `task-tray.agent.ts`.
+ */
+export interface TaskTrayHandle {
+    getItems: () => Array<{
+        id: string;
+        status: string;
+    }>;
+    selectItem: (id: string) => void;
+    toggleDone: (id: string) => void;
+    dismiss: (id: string) => void;
+}
+export interface TaskTrayProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick' | 'id'>, VariantProps<typeof taskTrayVariants> {
+    /**
+     * Stable instance id. Surfaced on the root as `data-component-id` so
+     * an agent / MCP UI bridge can address this specific tray.
+     */
+    id?: string;
     /** Tasks rendered inside the panel. */
     items: TaskItem[];
     /** Section title — rendered in the header. Localised by the consumer. */
@@ -13,6 +32,10 @@ export interface TaskTrayProps extends Omit<HTMLAttributes<HTMLElement>, 'onClic
     size?: 'sm' | 'md';
     /** Fires when the user activates a task (click / Enter / Space). */
     onOpenTask?: (item: TaskItem) => void;
+    /** Fires when the host should toggle the done state of a task. Used by agent integration. */
+    onToggleDone?: (item: TaskItem) => void;
+    /** Fires when the host should dismiss / remove a task. Used by agent integration. */
+    onDismissTask?: (item: TaskItem) => void;
     /** Fires when the user activates the header "Add" affordance. */
     onAddTask?: () => void;
     /** Localised label for the "Add" affordance. Defaults to `ui.taskTray.add`. */
@@ -23,6 +46,6 @@ export interface TaskTrayProps extends Omit<HTMLAttributes<HTMLElement>, 'onClic
     emptyTitle?: string;
     emptyDescription?: string;
 }
-export declare const TaskTray: import("react").ForwardRefExoticComponent<TaskTrayProps & import("react").RefAttributes<HTMLElement>>;
+export declare const TaskTray: import("react").ForwardRefExoticComponent<TaskTrayProps & import("react").RefAttributes<TaskTrayHandle>>;
 export {};
 //# sourceMappingURL=task-tray.d.ts.map

package/dist/components/text-area/index.js

@@ -1,4 +1,4 @@
-import { T as a } from "../../_chunks/text-area-DmKSd2DG.js";
+import { T as a } from "../../_chunks/text-area-C_M8wliK.js";
 export {
   a as TextArea
 };