@unctad-ai/voice-agent-registries 0.1.1

package/dist/CopilotProvider.d.ts

@@ -0,0 +1,5 @@
+import type { ReactNode } from 'react';
+export default function CopilotProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CopilotProvider.d.ts.map

package/dist/CopilotProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopilotProvider.d.ts","sourceRoot":"","sources":["../src/CopilotProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAM5E"}

package/dist/CopilotProvider.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { UIActionRegistryProvider } from './UIActionRegistry';
+import { FormFieldRegistryProvider } from './FormFieldRegistry';
+// CopilotKit removed — useChat (Vercel AI SDK) is standalone, no provider needed.
+// UIActionRegistry and FormFieldRegistry remain as pure React contexts.
+export default function CopilotProvider({ children }) {
+    return (_jsx(UIActionRegistryProvider, { children: _jsx(FormFieldRegistryProvider, { children: children }) }));
+}
+//# sourceMappingURL=CopilotProvider.js.map

package/dist/CopilotProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopilotProvider.js","sourceRoot":"","sources":["../src/CopilotProvider.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,kFAAkF;AAClF,wEAAwE;AACxE,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,EAAE,QAAQ,EAA2B;IAC3E,OAAO,CACL,KAAC,wBAAwB,cACvB,KAAC,yBAAyB,cAAE,QAAQ,GAA6B,GACxC,CAC5B,CAAC;AACJ,CAAC"}

package/dist/FormFieldRegistry.d.ts

@@ -0,0 +1,62 @@
+import { type ReactNode } from 'react';
+export type FormFieldType = 'text' | 'email' | 'tel' | 'date' | 'select' | 'radio' | 'checkbox';
+export interface FormFieldOption {
+    value: string;
+    label: string;
+}
+export interface FormField {
+    id: string;
+    label: string;
+    type: FormFieldType;
+    required: boolean;
+    value: unknown;
+    options?: FormFieldOption[];
+    setter: (value: unknown) => void;
+    elementRef?: React.RefObject<HTMLElement>;
+    /** Step/section name for progressive forms — used by getFormSchema to group fields. */
+    group?: string;
+}
+interface FormFieldRegistry {
+    register(field: FormField): void;
+    unregister(id: string): void;
+    getFields(): FormField[];
+    /** Returns the field label on success, or null if the field was not found / value was invalid. */
+    setValue(id: string, value: unknown): string | null;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): FormField[];
+}
+export declare const FormFieldRegistryContext: import("react").Context<FormFieldRegistry | null>;
+export declare function FormFieldRegistryProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useFormFieldRegistry(): {
+    fields: FormField[];
+    setValue: (id: string, value: unknown) => string | null;
+    register: (field: FormField) => void;
+    unregister: (id: string) => void;
+};
+/**
+ * Hook — registers a form field in the global registry on mount,
+ * unregisters on unmount, and keeps the stored value in sync.
+ *
+ * The `setter` and `options` arguments are stored in refs so that
+ * inline arrow functions and inline arrays do NOT cause infinite
+ * re-registration loops. Only `value` changes (and truly static props
+ * like id/label/type) trigger a re-registration.
+ */
+export declare function useRegisterFormField(config: {
+    id: string;
+    label: string;
+    type: FormFieldType;
+    required: boolean;
+    value: unknown;
+    options?: FormFieldOption[];
+    setter: (value: unknown) => void;
+    elementRef?: React.RefObject<HTMLElement>;
+    /** When false the field is unregistered (hidden sections). Defaults to true. */
+    enabled?: boolean;
+    /** Step/section name for progressive forms — used by getFormSchema to group fields. */
+    group?: string;
+}): void;
+export {};
+//# sourceMappingURL=FormFieldRegistry.d.ts.map

package/dist/FormFieldRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldRegistry.d.ts","sourceRoot":"","sources":["../src/FormFieldRegistry.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1C,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,IAAI,SAAS,EAAE,CAAC;IACzB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACpD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,WAAW,IAAI,SAAS,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,wBAAwB,mDAAgD,CAAC;AAItF,wBAAgB,yBAAyB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA2F9E;AAED,wBAAgB,oBAAoB;;mBAtGrB,MAAM,SAAS,OAAO,KAAG,MAAM,GAAG,IAAI;sBAJnC,SAAS,KAAG,IAAI;qBACjB,MAAM,KAAG,IAAI;EA0H7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1C,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,QAkDA"}

package/dist/FormFieldRegistry.js

@@ -0,0 +1,149 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useRef, useCallback, useEffect, useMemo, useSyncExternalStore, } from 'react';
+export const FormFieldRegistryContext = createContext(null);
+const EMPTY_FIELDS = [];
+export function FormFieldRegistryProvider({ children }) {
+    const fieldsRef = useRef(new Map());
+    const listenersRef = useRef(new Set());
+    const snapshotRef = useRef(EMPTY_FIELDS);
+    const highlightTimersRef = useRef(new Map());
+    // Batched notification — coalesces rapid register/unregister calls (e.g. 30 fields
+    // mounting simultaneously on PinRegistration) into a single snapshot + listener flush.
+    const pendingNotifyRef = useRef(false);
+    const notify = useCallback(() => {
+        if (!pendingNotifyRef.current) {
+            pendingNotifyRef.current = true;
+            queueMicrotask(() => {
+                pendingNotifyRef.current = false;
+                snapshotRef.current = Array.from(fieldsRef.current.values());
+                listenersRef.current.forEach((l) => l());
+            });
+        }
+    }, []);
+    const registry = useMemo(() => ({
+        register(field) {
+            fieldsRef.current.set(field.id, field);
+            notify();
+        },
+        unregister(id) {
+            fieldsRef.current.delete(id);
+            // Clear any pending highlight timer for this field
+            const timer = highlightTimersRef.current.get(id);
+            if (timer) {
+                clearTimeout(timer);
+                highlightTimersRef.current.delete(id);
+            }
+            notify();
+        },
+        getFields() {
+            return snapshotRef.current;
+        },
+        setValue(id, value) {
+            const field = fieldsRef.current.get(id);
+            if (!field)
+                return null;
+            // Validate select/radio values against declared options
+            if ((field.type === 'select' || field.type === 'radio') && field.options) {
+                if (!field.options.some((o) => o.value === String(value))) {
+                    return null;
+                }
+            }
+            field.setter(value);
+            // Visual highlight on the element if available and motion is not reduced
+            if (field.elementRef?.current &&
+                !window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
+                const el = field.elementRef.current;
+                // Clear any existing timer for this field to prevent flicker on rapid calls
+                const existing = highlightTimersRef.current.get(id);
+                if (existing)
+                    clearTimeout(existing);
+                el.classList.add('ring-2', 'ring-blue-500/50', 'transition-shadow');
+                highlightTimersRef.current.set(id, setTimeout(() => {
+                    el.classList.remove('ring-2', 'ring-blue-500/50', 'transition-shadow');
+                    highlightTimersRef.current.delete(id);
+                }, 1000));
+            }
+            return field.label;
+        },
+        subscribe(listener) {
+            listenersRef.current.add(listener);
+            return () => listenersRef.current.delete(listener);
+        },
+        getSnapshot() {
+            return snapshotRef.current;
+        },
+    }), [notify]);
+    return (_jsx(FormFieldRegistryContext.Provider, { value: registry, children: children }));
+}
+export function useFormFieldRegistry() {
+    const registry = useContext(FormFieldRegistryContext);
+    if (!registry)
+        throw new Error('useFormFieldRegistry must be used within FormFieldRegistryProvider');
+    const fields = useSyncExternalStore(registry.subscribe, registry.getSnapshot, 
+    // SSR-safe: return empty array during server render
+    () => EMPTY_FIELDS);
+    return {
+        fields,
+        setValue: registry.setValue,
+        register: registry.register,
+        unregister: registry.unregister,
+    };
+}
+/**
+ * Hook — registers a form field in the global registry on mount,
+ * unregisters on unmount, and keeps the stored value in sync.
+ *
+ * The `setter` and `options` arguments are stored in refs so that
+ * inline arrow functions and inline arrays do NOT cause infinite
+ * re-registration loops. Only `value` changes (and truly static props
+ * like id/label/type) trigger a re-registration.
+ */
+export function useRegisterFormField(config) {
+    const registry = useContext(FormFieldRegistryContext);
+    const enabled = config.enabled ?? true;
+    // Refs for potentially-unstable callback and array — always kept fresh
+    // but never listed as effect dependencies. Updated in a layout-time effect
+    // so the latest setter is available before any CopilotKit handler fires.
+    const setterRef = useRef(config.setter);
+    const optionsRef = useRef(config.options);
+    useEffect(() => {
+        setterRef.current = config.setter;
+        optionsRef.current = config.options;
+    });
+    // Stable setter wrapper — created once, delegates to the latest setter via ref.
+    const stableSetter = useCallback((v) => setterRef.current(v), []);
+    useEffect(() => {
+        if (!registry)
+            return;
+        if (!enabled) {
+            registry.unregister(config.id);
+            return;
+        }
+        registry.register({
+            id: config.id,
+            label: config.label,
+            type: config.type,
+            required: config.required,
+            value: config.value,
+            options: optionsRef.current,
+            setter: stableSetter,
+            elementRef: config.elementRef,
+            group: config.group,
+        });
+        return () => registry.unregister(config.id);
+    }, [
+        config.id,
+        config.label,
+        config.type,
+        config.required,
+        config.value,
+        // setter excluded — stored in ref, accessed via stableSetter
+        // options excluded — stored in ref, read at registration time
+        config.elementRef,
+        config.group,
+        stableSetter,
+        registry,
+        enabled,
+    ]);
+}
+//# sourceMappingURL=FormFieldRegistry.js.map

package/dist/FormFieldRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldRegistry.js","sourceRoot":"","sources":["../src/FormFieldRegistry.tsx"],"names":[],"mappings":"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"}

package/dist/UIActionRegistry.d.ts

@@ -0,0 +1,66 @@
+import { type ReactNode } from 'react';
+export interface UIActionParam {
+    name: string;
+    description: string;
+    type: string;
+}
+export interface UIAction {
+    id: string;
+    description: string;
+    category: string;
+    handler: (params?: Record<string, unknown>) => unknown;
+    params?: UIActionParam[];
+}
+export declare function UIActionRegistryProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useUIActionRegistry(): {
+    actions: UIAction[];
+    execute: (id: string, params?: Record<string, unknown>) => unknown;
+    register: (action: UIAction) => void;
+    unregister: (id: string) => void;
+};
+/**
+ * Hook — registers a UI action in the global registry on mount,
+ * unregisters on unmount.
+ *
+ * The `handler` and `params` arguments are stored in refs so that
+ * inline arrow functions and inline arrays do NOT cause infinite
+ * re-registration loops. Only truly static props (id, description,
+ * category) trigger a re-registration.
+ */
+export declare function useRegisterUIAction(id: string, description: string, handler: (params?: Record<string, unknown>) => unknown, options?: {
+    category?: string;
+    params?: UIActionParam[];
+}): void;
+/**
+ * Registers a view-mode toggle action (table/card) for a dashboard section.
+ *
+ * @param prefix  Action ID prefix, e.g. `'dashboard.taxes'`
+ * @param label   Human-readable label for the section, e.g. `'tax registrations'`
+ * @param setViewMode  State setter for `'table' | 'card'`
+ */
+export declare function useRegisterViewModeAction(prefix: string, label: string, setViewMode: (mode: 'table' | 'card') => void): void;
+/**
+ * Registers a tab-switching action.
+ *
+ * @param prefix      Action ID prefix, e.g. `'film'` → registers `'film.switchTab'`
+ * @param validTabs   Array of valid tab values
+ * @param setActiveTab State setter
+ * @param category    Optional category (defaults to prefix)
+ */
+export declare function useRegisterTabSwitchAction(prefix: string, validTabs: readonly string[], setActiveTab: (tab: string) => void, category?: string): void;
+/**
+ * Registers a form-submit action with optional guard.
+ *
+ * @param prefix   Action ID prefix, e.g. `'pin-reg'` → registers `'pin-reg.submitApplication'`
+ * @param options  Configuration object
+ */
+export declare function useRegisterSubmitAction(prefix: string, options: {
+    description?: string;
+    guard?: () => string | null;
+    onSubmit: () => void;
+    successMessage?: string;
+    category?: string;
+}): void;
+//# sourceMappingURL=UIActionRegistry.d.ts.map

package/dist/UIActionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIActionRegistry.d.ts","sourceRoot":"","sources":["../src/UIActionRegistry.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACvD,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAeD,wBAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAsD7E;AAED,wBAAgB,mBAAmB;;kBAlErB,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO;uBAF7C,QAAQ,KAAG,IAAI;qBACjB,MAAM,KAAG,IAAI;EAmF7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,EACtD,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,QA0B1D;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,QAgB9C;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EACnC,QAAQ,CAAC,EAAE,MAAM,QAsBlB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,QAkBF"}

package/dist/UIActionRegistry.js

@@ -0,0 +1,163 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useRef, useCallback, useEffect, useMemo, useSyncExternalStore, } from 'react';
+const UIActionRegistryContext = createContext(null);
+const EMPTY_ACTIONS = [];
+export function UIActionRegistryProvider({ children }) {
+    const actionsRef = useRef(new Map());
+    const listenersRef = useRef(new Set());
+    const snapshotRef = useRef(EMPTY_ACTIONS);
+    // Batched notification — coalesces rapid register/unregister calls into a
+    // single snapshot + listener flush (same pattern as FormFieldRegistry).
+    const pendingNotifyRef = useRef(false);
+    const notify = useCallback(() => {
+        if (!pendingNotifyRef.current) {
+            pendingNotifyRef.current = true;
+            queueMicrotask(() => {
+                pendingNotifyRef.current = false;
+                snapshotRef.current = Array.from(actionsRef.current.values());
+                listenersRef.current.forEach((l) => l());
+            });
+        }
+    }, []);
+    // useMemo (not useRef) avoids the "Cannot access refs during render" lint error.
+    // The registry object is stable across renders because it closes over refs.
+    const registry = useMemo(() => ({
+        register(action) {
+            actionsRef.current.set(action.id, action);
+            notify();
+        },
+        unregister(id) {
+            actionsRef.current.delete(id);
+            notify();
+        },
+        execute(id, params) {
+            const action = actionsRef.current.get(id);
+            if (!action)
+                return `Action "${id}" not found`;
+            return action.handler(params);
+        },
+        getActions() {
+            return snapshotRef.current;
+        },
+        subscribe(listener) {
+            listenersRef.current.add(listener);
+            return () => listenersRef.current.delete(listener);
+        },
+        getSnapshot() {
+            return snapshotRef.current;
+        },
+    }), [notify]);
+    return (_jsx(UIActionRegistryContext.Provider, { value: registry, children: children }));
+}
+export function useUIActionRegistry() {
+    const registry = useContext(UIActionRegistryContext);
+    if (!registry)
+        throw new Error('useUIActionRegistry must be used within UIActionRegistryProvider');
+    const actions = useSyncExternalStore(registry.subscribe, registry.getSnapshot, () => EMPTY_ACTIONS);
+    return {
+        actions,
+        execute: registry.execute,
+        register: registry.register,
+        unregister: registry.unregister,
+    };
+}
+/**
+ * Hook — registers a UI action in the global registry on mount,
+ * unregisters on unmount.
+ *
+ * The `handler` and `params` arguments are stored in refs so that
+ * inline arrow functions and inline arrays do NOT cause infinite
+ * re-registration loops. Only truly static props (id, description,
+ * category) trigger a re-registration.
+ */
+export function useRegisterUIAction(id, description, handler, options) {
+    const registry = useContext(UIActionRegistryContext);
+    // Refs for potentially-unstable callback and params array
+    const handlerRef = useRef(handler);
+    const paramsRef = useRef(options?.params);
+    useEffect(() => {
+        handlerRef.current = handler;
+        paramsRef.current = options?.params;
+    });
+    // Stable handler wrapper — created once, delegates to the latest handler via ref
+    const stableHandler = useCallback((p) => handlerRef.current(p), []);
+    useEffect(() => {
+        if (!registry)
+            return;
+        registry.register({
+            id,
+            description,
+            category: options?.category ?? 'general',
+            handler: stableHandler,
+            params: paramsRef.current,
+        });
+        return () => registry.unregister(id);
+    }, [id, description, options?.category, stableHandler, registry]);
+}
+// ---------------------------------------------------------------------------
+// Convenience hooks — reduce boilerplate for common action patterns
+// ---------------------------------------------------------------------------
+/**
+ * Registers a view-mode toggle action (table/card) for a dashboard section.
+ *
+ * @param prefix  Action ID prefix, e.g. `'dashboard.taxes'`
+ * @param label   Human-readable label for the section, e.g. `'tax registrations'`
+ * @param setViewMode  State setter for `'table' | 'card'`
+ */
+export function useRegisterViewModeAction(prefix, label, setViewMode) {
+    useRegisterUIAction(`${prefix}.setViewMode`, `Switch between table and card view for ${label}`, (params) => {
+        const mode = params?.mode;
+        if (mode !== 'table' && mode !== 'card')
+            return 'Invalid mode. Use "table" or "card"';
+        setViewMode(mode);
+        return `Switched ${label} to ${mode} view`;
+    }, {
+        category: 'dashboard',
+        params: [{ name: 'mode', description: 'View mode: table or card', type: 'string' }],
+    });
+}
+/**
+ * Registers a tab-switching action.
+ *
+ * @param prefix      Action ID prefix, e.g. `'film'` → registers `'film.switchTab'`
+ * @param validTabs   Array of valid tab values
+ * @param setActiveTab State setter
+ * @param category    Optional category (defaults to prefix)
+ */
+export function useRegisterTabSwitchAction(prefix, validTabs, setActiveTab, category) {
+    useRegisterUIAction(`${prefix}.switchTab`, `Switch between ${validTabs.join(', ')} tabs`, (params) => {
+        const tab = params?.tab;
+        if (!validTabs.includes(tab))
+            return `Invalid tab "${tab}". Use: ${validTabs.join(', ')}.`;
+        setActiveTab(tab);
+        return `Switched to ${tab} tab`;
+    }, {
+        category: category ?? prefix,
+        params: [
+            {
+                name: 'tab',
+                description: `Tab to switch to: ${validTabs.join(', ')}`,
+                type: 'string',
+            },
+        ],
+    });
+}
+/**
+ * Registers a form-submit action with optional guard.
+ *
+ * @param prefix   Action ID prefix, e.g. `'pin-reg'` → registers `'pin-reg.submitApplication'`
+ * @param options  Configuration object
+ */
+export function useRegisterSubmitAction(prefix, options) {
+    useRegisterUIAction(`${prefix}.submitApplication`, options.description ?? 'Submit the application', () => {
+        if (options.guard) {
+            const err = options.guard();
+            if (err)
+                return err;
+        }
+        options.onSubmit();
+        return (options.successMessage ??
+            'Application submitted successfully. The user has been redirected to the dashboard.');
+    }, { category: options.category ?? prefix });
+}
+//# sourceMappingURL=UIActionRegistry.js.map

package/dist/UIActionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIActionRegistry.js","sourceRoot":"","sources":["../src/UIActionRegistry.tsx"],"names":[],"mappings":"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"}

package/dist/clientToolHandlers.d.ts

@@ -0,0 +1,12 @@
+import type { SiteConfig } from '@unctad-ai/voice-agent-core';
+import type { FormField } from './FormFieldRegistry';
+interface ClientToolDeps {
+    navigate: (path: string) => void;
+    executeUIAction: (actionId: string, params?: Record<string, unknown>) => string | undefined | Promise<string | undefined>;
+    getFormFields: () => FormField[];
+    setFormValue: (id: string, value: unknown) => string | null;
+    config: SiteConfig;
+}
+export declare function createClientToolHandler(deps: ClientToolDeps): (toolName: string, args: Record<string, unknown>) => Promise<string>;
+export {};
+//# sourceMappingURL=clientToolHandlers.d.ts.map

package/dist/clientToolHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientToolHandlers.d.ts","sourceRoot":"","sources":["../src/clientToolHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKrD,UAAU,cAAc;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,eAAe,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtD,aAAa,EAAE,MAAM,SAAS,EAAE,CAAC;IACjC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5D,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,IAG5C,UAAU,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC,CAgGhF"}

package/dist/clientToolHandlers.js

@@ -0,0 +1,111 @@
+/** Values the LLM might produce for checkbox "true". */
+const TRUTHY = new Set(['true', 'yes', '1', 'on']);
+export function createClientToolHandler(deps) {
+    const { navigate, executeUIAction, getFormFields, setFormValue, config } = deps;
+    return async (toolName, args) => {
+        switch (toolName) {
+            case 'navigateTo': {
+                const page = args.page;
+                navigate(config.routeMap[page] || '/');
+                return page;
+            }
+            case 'viewService': {
+                const serviceId = args.serviceId;
+                const service = config.services.find(s => s.id === serviceId);
+                if (!service)
+                    return 'Service not found';
+                navigate(`/service/${serviceId}`);
+                return `Navigated to ${service.title} info page.`;
+            }
+            case 'startApplication': {
+                const serviceId = args.serviceId;
+                const service = config.services.find(s => s.id === serviceId);
+                if (!service)
+                    return 'Service not found';
+                const route = config.getServiceFormRoute(serviceId);
+                if (!route) {
+                    navigate(`/service/${serviceId}`);
+                    return `No online application form exists for "${service.title}" yet — tell the user clearly that only the information page is available. Navigated to the info page instead.`;
+                }
+                navigate(route);
+                return `Opened "${service.title}" application form. Check UI_ACTIONS for what the user needs to do first — do NOT call getFormSchema yet. Guide the user through the first visible step.`;
+            }
+            case 'performUIAction': {
+                const actionId = args.actionId;
+                let params;
+                if (args.paramsJson) {
+                    let jsonStr = args.paramsJson.trim();
+                    jsonStr = jsonStr.replace(/([{,]\s*)([a-zA-Z_]\w*)\s*:/g, '$1"$2":');
+                    jsonStr = jsonStr.replace(/,\s*([}\]])/g, '$1');
+                    try {
+                        params = JSON.parse(jsonStr);
+                    }
+                    catch {
+                        return `Could not parse params "${args.paramsJson}". Use valid JSON like {"key": "value"}.`;
+                    }
+                }
+                const result = await executeUIAction(actionId, params);
+                if (!result)
+                    return actionId.split('.').pop() || actionId;
+                const firstSentence = result.split(/\.(?:\s|$)/)[0];
+                return firstSentence || result;
+            }
+            case 'getFormSchema': {
+                const fields = getFormFields();
+                if (fields.length === 0)
+                    return 'No form fields are visible right now. The form may need a UI action first — check UI_ACTIONS for the next step (e.g. "Add Director").';
+                const fieldToSchema = (f) => ({
+                    id: f.id,
+                    label: f.label,
+                    type: f.type,
+                    value: f.value ?? null,
+                    ...(f.options?.length ? { opts: f.options } : {}),
+                });
+                const hasGroups = fields.some((f) => f.group);
+                if (!hasGroups)
+                    return JSON.stringify(fields.map(fieldToSchema));
+                const sectionMap = new Map();
+                for (const f of fields) {
+                    const key = f.group || '_ungrouped';
+                    const arr = sectionMap.get(key);
+                    if (arr)
+                        arr.push(f);
+                    else
+                        sectionMap.set(key, [f]);
+                }
+                return JSON.stringify({
+                    sections: Array.from(sectionMap.entries()).map(([section, sectionFields]) => ({
+                        section: section === '_ungrouped' ? 'Other' : section,
+                        fields: sectionFields.map(fieldToSchema),
+                    })),
+                });
+            }
+            case 'fillFormFields': {
+                const fieldEntries = args.fields;
+                const filled = [];
+                const errors = [];
+                const allFields = getFormFields();
+                for (const entry of fieldEntries) {
+                    const fieldDef = allFields.find((f) => f.id === entry.fieldId);
+                    const coerced = fieldDef?.type === 'checkbox'
+                        ? typeof entry.value === 'boolean'
+                            ? entry.value
+                            : TRUTHY.has(String(entry.value).toLowerCase())
+                        : entry.value;
+                    const result = setFormValue(entry.fieldId, coerced);
+                    if (result === null)
+                        errors.push(`Field "${entry.fieldId}" not found or invalid value`);
+                    else
+                        filled.push(result);
+                }
+                if (filled.length === 0)
+                    return errors.length > 0 ? errors.join('; ') : 'No fields matched';
+                const summary = filled.join(', ');
+                return errors.length > 0 ? `${summary} (${errors.length} failed)` : summary;
+            }
+            default:
+                return `Unknown tool: ${toolName}`;
+        }
+    };
+}
+//# sourceMappingURL=clientToolHandlers.js.map

package/dist/clientToolHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientToolHandlers.js","sourceRoot":"","sources":["../src/clientToolHandlers.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { UIActionRegistryProvider, useUIActionRegistry, useRegisterUIAction, useRegisterViewModeAction, useRegisterTabSwitchAction, useRegisterSubmitAction, } from './UIActionRegistry';
+export type { UIAction, UIActionParam } from './UIActionRegistry';
+export { FormFieldRegistryProvider, useFormFieldRegistry, useRegisterFormField, } from './FormFieldRegistry';
+export type { FormField, FormFieldType, FormFieldOption } from './FormFieldRegistry';
+export { default as CopilotProvider } from './CopilotProvider';
+export { useProgressiveFields } from './useProgressiveFields';
+export type { ProgressiveFieldConfig, ProgressiveStepConfig } from './useProgressiveFields';
+export { createClientToolHandler } from './clientToolHandlers';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { UIActionRegistryProvider, useUIActionRegistry, useRegisterUIAction, useRegisterViewModeAction, useRegisterTabSwitchAction, useRegisterSubmitAction, } from './UIActionRegistry';
+export { FormFieldRegistryProvider, useFormFieldRegistry, useRegisterFormField, } from './FormFieldRegistry';
+export { default as CopilotProvider } from './CopilotProvider';
+export { useProgressiveFields } from './useProgressiveFields';
+export { createClientToolHandler } from './clientToolHandlers';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/useProgressiveFields.d.ts

@@ -0,0 +1,40 @@
+import type { FormFieldType, FormFieldOption } from './FormFieldRegistry';
+export interface ProgressiveFieldConfig {
+    id: string;
+    label: string;
+    type: FormFieldType;
+    /** Defaults to false when omitted. */
+    required?: boolean;
+    options?: FormFieldOption[];
+    /** Per-field visibility override — ANDed with step.visible. Defaults to true. */
+    visible?: boolean;
+    /**
+     * [value, setter] tuple — same pattern as useState return.
+     * Value is constrained to JSON-safe primitives so the fingerprint comparison
+     * (JSON.stringify) never throws or produces non-deterministic output.
+     * Inline arrow setters are safe — they are ref-stabilized internally.
+     */
+    bind: [string | boolean | number | null, (value: unknown) => void];
+    /** DOM ref for the visual ring-highlight when the LLM fills this field. */
+    elementRef?: React.RefObject<HTMLElement>;
+}
+export interface ProgressiveStepConfig {
+    /** Section name shown to the LLM via getFormSchema grouping. */
+    step: string;
+    /** Whether this step's fields should be registered. */
+    visible: boolean;
+    fields: ProgressiveFieldConfig[];
+}
+/**
+ * Registers progressive form fields with the global FormFieldRegistry.
+ *
+ * Replaces N individual `useRegisterFormField` + `useCallback` + `useMemo`
+ * calls with one declarative config. Uses the FormFieldRegistryContext
+ * directly (not hook-per-field) to avoid rules-of-hooks issues with
+ * conditional field counts.
+ *
+ * @param prefix - Field ID prefix (e.g. 'evaluate-investment')
+ * @param steps  - Step configs with visibility and field definitions
+ */
+export declare function useProgressiveFields(prefix: string, steps: ProgressiveStepConfig[]): void;
+//# sourceMappingURL=useProgressiveFields.d.ts.map

package/dist/useProgressiveFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProgressiveFields.d.ts","sourceRoot":"","sources":["../src/useProgressiveFields.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,IAAI,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC;IACnE,2EAA2E;IAC3E,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,QAuGlF"}

package/dist/useProgressiveFields.js

@@ -0,0 +1,108 @@
+import { useContext, useEffect, useRef } from 'react';
+import { FormFieldRegistryContext } from './FormFieldRegistry';
+/**
+ * Registers progressive form fields with the global FormFieldRegistry.
+ *
+ * Replaces N individual `useRegisterFormField` + `useCallback` + `useMemo`
+ * calls with one declarative config. Uses the FormFieldRegistryContext
+ * directly (not hook-per-field) to avoid rules-of-hooks issues with
+ * conditional field counts.
+ *
+ * @param prefix - Field ID prefix (e.g. 'evaluate-investment')
+ * @param steps  - Step configs with visibility and field definitions
+ */
+export function useProgressiveFields(prefix, steps) {
+    const registry = useContext(FormFieldRegistryContext);
+    // Refs for potentially-unstable callbacks and arrays — kept fresh via a
+    // passive effect so the render body stays pure (no ref mutations).
+    const settersRef = useRef(new Map());
+    const optionsRef = useRef(new Map());
+    const wrappersRef = useRef(new Map());
+    // ── Pure computation: build flat field list (no side effects) ──
+    const flatFields = [];
+    const currentIds = new Set();
+    for (const step of steps) {
+        for (const field of step.fields) {
+            const fullId = `${prefix}.${field.id}`;
+            currentIds.add(fullId);
+            flatFields.push({
+                id: fullId,
+                label: field.label,
+                type: field.type,
+                required: field.required ?? false,
+                value: field.bind[0],
+                enabled: step.visible && (field.visible ?? true),
+                group: step.step,
+                elementRef: field.elementRef,
+            });
+        }
+    }
+    // Lazy-init stable wrapper closures — one per field ID, delegates to the
+    // latest setter via ref. Only creates on first encounter (idempotent),
+    // which is acceptable during render per React guidelines for lazy init.
+    for (const { id } of flatFields) {
+        if (!wrappersRef.current.has(id)) {
+            wrappersRef.current.set(id, (v) => {
+                settersRef.current.get(id)?.(v);
+            });
+        }
+    }
+    // ── Passive effect: sync refs + prune stale entries ──
+    // Runs after every render to keep refs fresh without mutating them during
+    // the render body. Also prunes orphaned IDs when fields are removed from
+    // the steps config (prevents memory leaks from accumulated map entries).
+    useEffect(() => {
+        for (const step of steps) {
+            for (const field of step.fields) {
+                const fullId = `${prefix}.${field.id}`;
+                settersRef.current.set(fullId, field.bind[1]);
+                optionsRef.current.set(fullId, field.options);
+            }
+        }
+        for (const id of [...settersRef.current.keys()]) {
+            if (!currentIds.has(id)) {
+                settersRef.current.delete(id);
+                optionsRef.current.delete(id);
+                wrappersRef.current.delete(id);
+            }
+        }
+    });
+    // ── Fingerprint: detect meaningful changes ──
+    // Includes ALL metadata (not just id/value/enabled) so label, type, required,
+    // and group changes also trigger re-registration. Values are constrained to
+    // JSON-safe primitives via the FieldConfig type, so stringify is deterministic.
+    const fingerprint = JSON.stringify(flatFields.map((f) => [f.id, f.label, f.type, f.required, f.value, f.enabled, f.group]));
+    // ── Registration effect ──
+    // The cleanup function unregisters only the IDs this effect registered, so
+    // disabled fields or fields from other components are never clobbered.
+    // When a field transitions enabled→disabled, the fingerprint changes, the old
+    // cleanup runs (unregistering it), and the new effect skips it.
+    useEffect(() => {
+        if (!registry)
+            return;
+        const registeredIds = [];
+        for (const field of flatFields) {
+            if (!field.enabled)
+                continue;
+            registry.register({
+                id: field.id,
+                label: field.label,
+                type: field.type,
+                required: field.required,
+                value: field.value,
+                options: optionsRef.current.get(field.id),
+                setter: wrappersRef.current.get(field.id),
+                group: field.group,
+                elementRef: field.elementRef,
+            });
+            registeredIds.push(field.id);
+        }
+        return () => {
+            for (const id of registeredIds) {
+                registry.unregister(id);
+            }
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [registry, fingerprint]);
+}
+//# sourceMappingURL=useProgressiveFields.js.map

package/dist/useProgressiveFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProgressiveFields.js","sourceRoot":"","sources":["../src/useProgressiveFields.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@unctad-ai/voice-agent-registries",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unctad-ai/voice-agent-kit.git",
+    "directory": "packages/registries"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "@unctad-ai/voice-agent-core": "0.1.1"
+  },
+  "devDependencies": {
+    "react": "^19.2.4",
+    "@types/react": "^19.0.0",
+    "typescript": "^5.9.3",
+    "@unctad-ai/voice-agent-core": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}