@helpai/elements 0.12.3 → 0.13.0

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.12.3"
+  "version": "0.13.0"
 }

package/schema.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startSessionResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-BUakRA3-.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startSessionResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-BJD1aESw.js';
 import { z } from 'zod';
 
 /**
@@ -306,6 +306,7 @@ declare const featureFlagsSchema: z.ZodObject<{
         code: z.ZodString;
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$loose>]>>>;
+    humanInLoop: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$loose>;
 type FeatureFlags = z.infer<typeof featureFlagsSchema>;
 
@@ -566,6 +567,130 @@ declare const i18nSchema: z.ZodObject<{
 }, z.core.$loose>;
 type I18nOptions = z.infer<typeof i18nSchema>;
 
+/**
+ * Intake section — the pre-chat **lead/sales capture form**, modeled as a
+ * deterministic array of typed fields with validation. When enabled it renders
+ * as a **blocking gate**: the visitor completes (or skips, if `skippable`) the
+ * form before the composer unlocks.
+ *
+ * The same {@link formFieldSchema} shape is reused at runtime by the AI-driven
+ * **ask-input tool** (`src/ui/tool-ask-input.tsx`), so a sales/support/lead
+ * agent can both capture a lead up-front and ask for more structured info
+ * mid-conversation through one form engine.
+ *
+ * Off by default — existing deployments are unchanged. See
+ * `docs/api/hitl-and-forms.md` for the wire contract + agent presets.
+ */
+
+declare const fieldTypeSchema: z.ZodEnum<{
+    number: "number";
+    text: "text";
+    url: "url";
+    email: "email";
+    tel: "tel";
+    textarea: "textarea";
+    select: "select";
+    radio: "radio";
+    checkbox: "checkbox";
+    multiselect: "multiselect";
+}>;
+type FieldType = z.infer<typeof fieldTypeSchema>;
+declare const fieldOptionSchema: z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type FieldOption = z.infer<typeof fieldOptionSchema>;
+declare const fieldValidationSchema: z.ZodObject<{
+    pattern: z.ZodOptional<z.ZodString>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    minSelections: z.ZodOptional<z.ZodNumber>;
+    maxSelections: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+type FieldValidation = z.infer<typeof fieldValidationSchema>;
+declare const formFieldSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+        number: "number";
+        text: "text";
+        url: "url";
+        email: "email";
+        tel: "tel";
+        textarea: "textarea";
+        select: "select";
+        radio: "radio";
+        checkbox: "checkbox";
+        multiselect: "multiselect";
+    }>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    defaultValue: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    validation: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodOptional<z.ZodString>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        minSelections: z.ZodOptional<z.ZodNumber>;
+        maxSelections: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    allowOther: z.ZodOptional<z.ZodBoolean>;
+    validationHint: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type FormField = z.infer<typeof formFieldSchema>;
+declare const intakeSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            text: "text";
+            url: "url";
+            email: "email";
+            tel: "tel";
+            textarea: "textarea";
+            select: "select";
+            radio: "radio";
+            checkbox: "checkbox";
+            multiselect: "multiselect";
+        }>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        validation: z.ZodOptional<z.ZodObject<{
+            pattern: z.ZodOptional<z.ZodString>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            minSelections: z.ZodOptional<z.ZodNumber>;
+            maxSelections: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        allowOther: z.ZodOptional<z.ZodBoolean>;
+        validationHint: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    skippable: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$loose>;
+type Intake = z.infer<typeof intakeSchema>;
+
 /**
  * Modules section — the Intercom-style "messenger" surface, modeled as a
  * **data-driven, ordered list of tabs**. Each tab picks a UI `layout`, an
@@ -686,4 +811,4 @@ declare const ALL_MODES: readonly Mode[];
  */
 declare function emitJsonSchema(): unknown;
 
-export { ALL_MODES, type ActionName, type AttachmentLimits, type Behavior, type CalloutPosition, type CalloutShape, type ComposerOptions, type FeatureFlags, type FeedbackEvent, type FeedbackOptions, type FooterOptions, type HapticsOptions, type HeaderActions, type HeaderOptions, type I18nOptions, type LauncherCallout, type LauncherOptions, type LauncherSize, type LauncherVariant, type Mode, type ModuleLayout, type ModuleOptions, type ModulesOptions, type Position, type PoweredBy, type Presentation, type ResizeOptions, type ResponseMode, type SendButtonOptions, type SizeOptions, type SoundOptions, type StringsOverride, type ThemeOverrides, type ThemePreference, type VoiceMode, type WelcomeAnimation, type WelcomeOptions, actionNameSchema, attachmentLimitsSchema, behaviorSchema, calloutPositionSchema, calloutShapeSchema, composerOptionsSchema, emitJsonSchema, featureFlagsSchema, feedbackEventSchema, feedbackSchema, footerSchema, hapticsOptionsSchema, headerActionsSchema, headerSchema, i18nSchema, initialSizeSchema, launcherCalloutSchema, launcherOptionsSchema, launcherSizeSchema, launcherVariantSchema, modeSchema, moduleLayoutSchema, moduleSchema, modulesSchema, positionSchema, poweredBySchema, presentationSchema, resizeOptionsSchema, responseModeSchema, sendButtonIconSchema, sendButtonOptionsSchema, sendButtonShapeSchema, sendButtonVariantSchema, sizeOptionsSchema, soundOptionsSchema, stringsOverrideSchema, themeFieldSchema, themeOverridesSchema, themePreferenceSchema, toolRefSchema, voiceModeSchema, welcomeAnimationSchema, welcomeOptionsSchema, widgetSettingsSchemaForMode };
+export { ALL_MODES, type ActionName, type AttachmentLimits, type Behavior, type CalloutPosition, type CalloutShape, type ComposerOptions, type FeatureFlags, type FeedbackEvent, type FeedbackOptions, type FieldOption, type FieldType, type FieldValidation, type FooterOptions, type FormField, type HapticsOptions, type HeaderActions, type HeaderOptions, type I18nOptions, type Intake, type LauncherCallout, type LauncherOptions, type LauncherSize, type LauncherVariant, type Mode, type ModuleLayout, type ModuleOptions, type ModulesOptions, type Position, type PoweredBy, type Presentation, type ResizeOptions, type ResponseMode, type SendButtonOptions, type SizeOptions, type SoundOptions, type StringsOverride, type ThemeOverrides, type ThemePreference, type VoiceMode, type WelcomeAnimation, type WelcomeOptions, actionNameSchema, attachmentLimitsSchema, behaviorSchema, calloutPositionSchema, calloutShapeSchema, composerOptionsSchema, emitJsonSchema, featureFlagsSchema, feedbackEventSchema, feedbackSchema, fieldOptionSchema, fieldTypeSchema, fieldValidationSchema, footerSchema, formFieldSchema, hapticsOptionsSchema, headerActionsSchema, headerSchema, i18nSchema, initialSizeSchema, intakeSchema, launcherCalloutSchema, launcherOptionsSchema, launcherSizeSchema, launcherVariantSchema, modeSchema, moduleLayoutSchema, moduleSchema, modulesSchema, positionSchema, poweredBySchema, presentationSchema, resizeOptionsSchema, responseModeSchema, sendButtonIconSchema, sendButtonOptionsSchema, sendButtonShapeSchema, sendButtonVariantSchema, sizeOptionsSchema, soundOptionsSchema, stringsOverrideSchema, themeFieldSchema, themeOverridesSchema, themePreferenceSchema, toolRefSchema, voiceModeSchema, welcomeAnimationSchema, welcomeOptionsSchema, widgetSettingsSchemaForMode };