@unctad-ai/voice-agent-registries 3.0.3 → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
  import { type ReactNode } from 'react';
2
- export type FormFieldType = 'text' | 'email' | 'tel' | 'date' | 'select' | 'radio' | 'checkbox';
2
+ export type FormFieldType = 'text' | 'email' | 'tel' | 'date' | 'select' | 'radio' | 'checkbox' | 'upload';
3
3
  export interface FormFieldOption {
4
4
  value: string;
5
5
  label: string;
@@ -15,9 +15,15 @@ export interface FormField {
15
15
  elementRef?: React.RefObject<HTMLElement>;
16
16
  /** Step/section name for progressive forms — used by getFormSchema to group fields. */
17
17
  group?: string;
18
+ /** When set, this field is a placeholder for a gated section that needs an action to open. */
19
+ gatedAction?: string;
18
20
  }
21
+ /** FormField with loose options type — accepts bare strings alongside {value, label}. */
22
+ type FormFieldInput = Omit<FormField, 'options'> & {
23
+ options?: (FormFieldOption | string)[];
24
+ };
19
25
  interface FormFieldRegistry {
20
- register(field: FormField): void;
26
+ register(field: FormFieldInput): void;
21
27
  unregister(id: string): void;
22
28
  getFields(): FormField[];
23
29
  /** Returns the field label on success, or null if the field was not found / value was invalid. */
@@ -32,7 +38,7 @@ export declare function FormFieldRegistryProvider({ children }: {
32
38
  export declare function useFormFieldRegistry(): {
33
39
  fields: FormField[];
34
40
  setValue: (id: string, value: unknown) => string | null;
35
- register: (field: FormField) => void;
41
+ register: (field: FormFieldInput) => void;
36
42
  unregister: (id: string) => void;
37
43
  };
38
44
  /**
@@ -1 +1 @@
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"}
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,GAAG,QAAQ,CAAC;AAE3G,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;IACf,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yFAAyF;AACzF,KAAK,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAA;CAAE,CAAC;AAE9F,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,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;AAQD,eAAO,MAAM,wBAAwB,mDAAgD,CAAC;AAItF,wBAAgB,yBAAyB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA2F9E;AAED,wBAAgB,oBAAoB;;mBA5GrB,MAAM,SAAS,OAAO,KAAG,MAAM,GAAG,IAAI;sBAJnC,cAAc,KAAG,IAAI;qBACtB,MAAM,KAAG,IAAI;EAgI7B;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"}
@@ -1,5 +1,11 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
2
  import { createContext, useContext, useRef, useCallback, useEffect, useMemo, useSyncExternalStore, } from 'react';
3
+ /** Normalize options: bare strings become {value, label} objects. */
4
+ function normalizeOptions(options) {
5
+ if (!options)
6
+ return undefined;
7
+ return options.map(o => typeof o === 'string' ? { value: o, label: o } : o);
8
+ }
3
9
  export const FormFieldRegistryContext = createContext(null);
4
10
  const EMPTY_FIELDS = [];
5
11
  export function FormFieldRegistryProvider({ children }) {
@@ -22,7 +28,7 @@ export function FormFieldRegistryProvider({ children }) {
22
28
  }, []);
23
29
  const registry = useMemo(() => ({
24
30
  register(field) {
25
- fieldsRef.current.set(field.id, field);
31
+ fieldsRef.current.set(field.id, { ...field, options: normalizeOptions(field.options) });
26
32
  notify();
27
33
  },
28
34
  unregister(id) {
@@ -1 +1 @@
1
- {"version":3,"file":"FormFieldRegistry.js","sourceRoot":"","sources":["../src/FormFieldRegistry.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"FormFieldRegistry.js","sourceRoot":"","sources":["../src/FormFieldRegistry.tsx"],"names":[],"mappings":"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"}
@@ -129,7 +129,7 @@ export function useRegisterViewModeAction(prefix, label, setViewMode) {
129
129
  * @param category Optional category (defaults to prefix)
130
130
  */
131
131
  export function useRegisterTabSwitchAction(prefix, validTabs, setActiveTab, category) {
132
- useRegisterUIAction(`${prefix}.switchTab`, `Switch between ${validTabs.join(', ')} tabs`, (params) => {
132
+ useRegisterUIAction(`${prefix}.switchTab`, `Switch tabs (sequence: ${validTabs.join(' ')}). Advance to the next tab in order unless the user asks otherwise.`, (params) => {
133
133
  const tab = params?.tab;
134
134
  if (!validTabs.includes(tab))
135
135
  return `Invalid tab "${tab}". Use: ${validTabs.join(', ')}.`;
@@ -1 +1 @@
1
- {"version":3,"file":"UIActionRegistry.js","sourceRoot":"","sources":["../src/UIActionRegistry.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"UIActionRegistry.js","sourceRoot":"","sources":["../src/UIActionRegistry.tsx"],"names":[],"mappings":"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"}
@@ -1 +1 @@
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,CAuGhF"}
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;AAqBrD,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,CA4IhF"}
@@ -1,5 +1,21 @@
1
1
  /** Values the LLM might produce for checkbox "true". */
2
2
  const TRUTHY = new Set(['true', 'yes', '1', 'on']);
3
+ /**
4
+ * Resolve a display-friendly service title.
5
+ * Some consuming projects use `name` instead of the canonical `title` field,
6
+ * so we fall back through: title → name → id.
7
+ */
8
+ function resolveServiceTitle(service) {
9
+ return service.title || service.name || service.id;
10
+ }
11
+ /** Check if a form field value counts as "filled" (not empty/null/undefined). */
12
+ function isFilled(value) {
13
+ if (value === null || value === undefined)
14
+ return false;
15
+ if (typeof value === 'string')
16
+ return value !== '';
17
+ return true; // booleans, numbers, arrays are valid filled values
18
+ }
3
19
  export function createClientToolHandler(deps) {
4
20
  const { navigate, executeUIAction, getFormFields, setFormValue, config } = deps;
5
21
  return async (toolName, args) => {
@@ -15,7 +31,7 @@ export function createClientToolHandler(deps) {
15
31
  if (!service)
16
32
  return 'Service not found';
17
33
  navigate(`/service/${serviceId}`);
18
- return `Navigated to ${service.title} info page.`;
34
+ return `Navigated to ${resolveServiceTitle(service)} info page.`;
19
35
  }
20
36
  case 'getServiceDetails': {
21
37
  const serviceId = args.serviceId;
@@ -33,10 +49,10 @@ export function createClientToolHandler(deps) {
33
49
  const route = config.getServiceFormRoute(serviceId);
34
50
  if (!route) {
35
51
  navigate(`/service/${serviceId}`);
36
- 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.`;
52
+ return `No online application form exists for "${resolveServiceTitle(service)}" yet — tell the user clearly that only the information page is available. Navigated to the info page instead.`;
37
53
  }
38
54
  navigate(route);
39
- 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.`;
55
+ return `Opened "${resolveServiceTitle(service)}" application form.`;
40
56
  }
41
57
  case 'performUIAction': {
42
58
  const actionId = args.actionId;
@@ -54,14 +70,17 @@ export function createClientToolHandler(deps) {
54
70
  }
55
71
  const result = await executeUIAction(actionId, params);
56
72
  if (!result)
57
- return actionId.split('.').pop() || actionId;
73
+ return `Action "${actionId}" not found or did not execute. <internal>Check UI_ACTIONS for valid action IDs.</internal>`;
58
74
  const firstSentence = result.split(/\.(?:\s|$)/)[0];
59
75
  return firstSentence || result;
60
76
  }
61
77
  case 'getFormSchema': {
62
- const fields = getFormFields();
63
- if (fields.length === 0)
64
- 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").';
78
+ const allFields = getFormFields();
79
+ // Separate gated marker fields from real fields
80
+ const gatedFields = allFields.filter(f => f.gatedAction);
81
+ const fields = allFields.filter(f => !f.gatedAction);
82
+ if (fields.length === 0 && gatedFields.length === 0)
83
+ return 'No form fields are visible right now. <internal>A UI action may be needed first — check UI_ACTIONS for the next step.</internal>';
65
84
  const fieldToSchema = (f) => ({
66
85
  id: f.id,
67
86
  label: f.label,
@@ -69,9 +88,27 @@ export function createClientToolHandler(deps) {
69
88
  value: f.value ?? null,
70
89
  ...(f.options?.length ? { opts: f.options } : {}),
71
90
  });
91
+ const fillableFields = fields.filter(f => f.type !== 'upload');
92
+ const allFilled = fillableFields.length > 0 && fillableFields.every(f => isFilled(f.value));
93
+ const hint = allFilled
94
+ ? 'All visible fields are filled. <internal>Check UI_ACTIONS for the next tab or submit action.</internal>'
95
+ : undefined;
96
+ // Build gated section placeholders — deduplicate by action ID
97
+ const seenActions = new Set();
98
+ const gatedSections = [];
99
+ for (const f of gatedFields) {
100
+ const action = f.gatedAction;
101
+ if (seenActions.has(action))
102
+ continue;
103
+ seenActions.add(action);
104
+ gatedSections.push({ section: f.group || f.label, gated: true, action });
105
+ }
72
106
  const hasGroups = fields.some((f) => f.group);
73
- if (!hasGroups)
107
+ if (!hasGroups && gatedSections.length === 0) {
108
+ if (hint)
109
+ return JSON.stringify({ fields: fields.map(fieldToSchema), hint });
74
110
  return JSON.stringify(fields.map(fieldToSchema));
111
+ }
75
112
  const sectionMap = new Map();
76
113
  for (const f of fields) {
77
114
  const key = f.group || '_ungrouped';
@@ -81,12 +118,24 @@ export function createClientToolHandler(deps) {
81
118
  else
82
119
  sectionMap.set(key, [f]);
83
120
  }
84
- return JSON.stringify({
85
- sections: Array.from(sectionMap.entries()).map(([section, sectionFields]) => ({
121
+ const sections = [
122
+ ...gatedSections,
123
+ ...Array.from(sectionMap.entries()).map(([section, sectionFields]) => ({
86
124
  section: section === '_ungrouped' ? 'Other' : section,
87
125
  fields: sectionFields.map(fieldToSchema),
88
126
  })),
89
- });
127
+ ];
128
+ const result = { sections };
129
+ // Gated-section hint takes priority: if gated sections exist, the form
130
+ // cannot truly be "all filled" — the gated fields aren't even visible yet.
131
+ if (gatedSections.length > 0) {
132
+ const actions = gatedSections.map(s => `${s.action} (opens ${s.section})`).join(', ');
133
+ result.hint = `<internal>FIRST call performUIAction for: ${actions}. Then call getFormSchema again.</internal>`;
134
+ }
135
+ else if (hint) {
136
+ result.hint = hint;
137
+ }
138
+ return JSON.stringify(result);
90
139
  }
91
140
  case 'fillFormFields': {
92
141
  const fieldEntries = args.fields;
@@ -95,6 +144,14 @@ export function createClientToolHandler(deps) {
95
144
  const allFields = getFormFields();
96
145
  for (const entry of fieldEntries) {
97
146
  const fieldDef = allFields.find((f) => f.id === entry.fieldId);
147
+ if (fieldDef?.gatedAction) {
148
+ errors.push(`"${entry.fieldId}" is gated — call ${fieldDef.gatedAction} first`);
149
+ continue;
150
+ }
151
+ if (fieldDef?.type === 'upload') {
152
+ errors.push(`"${entry.fieldId}" is a file upload — the user must handle it manually`);
153
+ continue;
154
+ }
98
155
  const coerced = fieldDef?.type === 'checkbox'
99
156
  ? typeof entry.value === 'boolean'
100
157
  ? entry.value
@@ -1 +1 @@
1
- {"version":3,"file":"clientToolHandlers.js","sourceRoot":"","sources":["../src/clientToolHandlers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"clientToolHandlers.js","sourceRoot":"","sources":["../src/clientToolHandlers.ts"],"names":[],"mappings":"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"}
@@ -23,6 +23,18 @@ export interface ProgressiveStepConfig {
23
23
  step: string;
24
24
  /** Whether this step's fields should be registered. */
25
25
  visible: boolean;
26
+ /**
27
+ * Whether the form inputs are actually rendered and interactive.
28
+ * Use this for sections gated behind an "Add" button — set to true
29
+ * only when the sub-form is open. Defaults to true.
30
+ */
31
+ ready?: boolean;
32
+ /**
33
+ * UI action ID that opens this section (e.g. 'reg-form.showDirectorForm').
34
+ * When ready is false, a placeholder is registered so getFormSchema can
35
+ * tell the LLM which action to call to reveal the section's fields.
36
+ */
37
+ gatedAction?: string;
26
38
  fields: ProgressiveFieldConfig[];
27
39
  }
28
40
  /**
@@ -1 +1 @@
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"}
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;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,QA4HlF"}
@@ -22,6 +22,24 @@ export function useProgressiveFields(prefix, steps) {
22
22
  const flatFields = [];
23
23
  const currentIds = new Set();
24
24
  for (const step of steps) {
25
+ const isReady = step.ready ?? true;
26
+ const isGated = step.visible && !isReady && step.gatedAction;
27
+ if (isGated) {
28
+ // Register a single marker field so getFormSchema knows this section
29
+ // exists but needs an action before fields become available.
30
+ const gatedId = `${prefix}.__gated__.${step.step}`;
31
+ currentIds.add(gatedId);
32
+ flatFields.push({
33
+ id: gatedId,
34
+ label: step.step,
35
+ type: 'text',
36
+ required: false,
37
+ value: null,
38
+ enabled: true,
39
+ group: step.step,
40
+ gatedAction: step.gatedAction,
41
+ });
42
+ }
25
43
  for (const field of step.fields) {
26
44
  const fullId = `${prefix}.${field.id}`;
27
45
  currentIds.add(fullId);
@@ -31,7 +49,7 @@ export function useProgressiveFields(prefix, steps) {
31
49
  type: field.type,
32
50
  required: field.required ?? false,
33
51
  value: field.bind[0],
34
- enabled: step.visible && (field.visible ?? true),
52
+ enabled: step.visible && isReady && (field.visible ?? true),
35
53
  group: step.step,
36
54
  elementRef: field.elementRef,
37
55
  });
@@ -71,7 +89,7 @@ export function useProgressiveFields(prefix, steps) {
71
89
  // Includes ALL metadata (not just id/value/enabled) so label, type, required,
72
90
  // and group changes also trigger re-registration. Values are constrained to
73
91
  // JSON-safe primitives via the FieldConfig type, so stringify is deterministic.
74
- const fingerprint = JSON.stringify(flatFields.map((f) => [f.id, f.label, f.type, f.required, f.value, f.enabled, f.group]));
92
+ const fingerprint = JSON.stringify(flatFields.map((f) => [f.id, f.label, f.type, f.required, f.value, f.enabled, f.group, f.gatedAction]));
75
93
  // ── Registration effect ──
76
94
  // The cleanup function unregisters only the IDs this effect registered, so
77
95
  // disabled fields or fields from other components are never clobbered.
@@ -91,9 +109,10 @@ export function useProgressiveFields(prefix, steps) {
91
109
  required: field.required,
92
110
  value: field.value,
93
111
  options: optionsRef.current.get(field.id),
94
- setter: wrappersRef.current.get(field.id),
112
+ setter: wrappersRef.current.get(field.id) ?? (() => { }),
95
113
  group: field.group,
96
114
  elementRef: field.elementRef,
115
+ gatedAction: field.gatedAction,
97
116
  });
98
117
  registeredIds.push(field.id);
99
118
  }
@@ -1 +1 @@
1
- {"version":3,"file":"useProgressiveFields.js","sourceRoot":"","sources":["../src/useProgressiveFields.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"useProgressiveFields.js","sourceRoot":"","sources":["../src/useProgressiveFields.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@unctad-ai/voice-agent-registries",
3
- "version": "3.0.3",
3
+ "version": "5.0.1",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -18,14 +18,14 @@
18
18
  },
19
19
  "peerDependencies": {
20
20
  "react": ">=18",
21
- "@unctad-ai/voice-agent-core": "3.0.3"
21
+ "@unctad-ai/voice-agent-core": "5.0.1"
22
22
  },
23
23
  "devDependencies": {
24
24
  "@types/react": "^19.0.0",
25
25
  "react": "^19.2.4",
26
26
  "typescript": "^5.9.3",
27
27
  "vitest": "^4.1.0",
28
- "@unctad-ai/voice-agent-core": "3.0.3"
28
+ "@unctad-ai/voice-agent-core": "5.0.1"
29
29
  },
30
30
  "scripts": {
31
31
  "build": "tsc",