@helpai/elements 0.72.0 → 0.73.0

package/package.json

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

package/schema.d.ts

@@ -268,10 +268,6 @@ declare const voiceModeSchema: z.ZodEnum<{
   disabled: "disabled";
 }>;
 type VoiceMode = z.infer<typeof voiceModeSchema>;
-declare const toolRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-  code: z.ZodString;
-  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$loose>]>;
 declare const featureFlagsSchema: z.ZodObject<{
   disableFileUpload: z.ZodDefault<z.ZodBoolean>;
   voice: z.ZodDefault<z.ZodEnum<{
@@ -279,10 +275,6 @@ declare const featureFlagsSchema: z.ZodObject<{
     server: "server";
     disabled: "disabled";
   }>>;
-  tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-    code: z.ZodString;
-    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  }, z.core.$loose>]>>>;
   disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
   enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$loose>;
@@ -475,10 +467,10 @@ type FooterOptions = z.infer<typeof footerSchema>;
 //#region src/schema/widget/forms.d.ts
 declare const fieldTypeSchema: z.ZodEnum<{
   number: "number";
+  email: "email";
   date: "date";
-  text: "text";
   url: "url";
-  email: "email";
+  text: "text";
   tel: "tel";
   time: "time";
   textarea: "textarea";
@@ -509,10 +501,10 @@ declare const formFieldSchema: z.ZodObject<{
   label: z.ZodString;
   type: z.ZodEnum<{
     number: "number";
+    email: "email";
     date: "date";
-    text: "text";
     url: "url";
-    email: "email";
+    text: "text";
     tel: "tel";
     time: "time";
     textarea: "textarea";
@@ -611,10 +603,10 @@ declare const formDefSchema: z.ZodObject<{
     label: z.ZodString;
     type: z.ZodEnum<{
       number: "number";
+      email: "email";
       date: "date";
-      text: "text";
       url: "url";
-      email: "email";
+      text: "text";
       tel: "tel";
       time: "time";
       textarea: "textarea";
@@ -689,10 +681,10 @@ declare const formsSchema: z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     type: z.ZodEnum<{
       number: "number";
+      email: "email";
       date: "date";
-      text: "text";
       url: "url";
-      email: "email";
+      text: "text";
       tel: "tel";
       time: "time";
       textarea: "textarea";
@@ -767,8 +759,8 @@ type I18nOptions = z.infer<typeof i18nSchema>;
 //#endregion
 //#region src/schema/widget/modules.d.ts
 declare const moduleLayoutSchema: z.ZodEnum<{
-  chat: "chat";
   home: "home";
+  chat: "chat";
   help: "help";
   news: "news";
 }>;
@@ -776,8 +768,8 @@ type ModuleLayout = z.infer<typeof moduleLayoutSchema>;
 declare const moduleSchema: z.ZodObject<{
   label: z.ZodString;
   layout: z.ZodEnum<{
-    chat: "chat";
     home: "home";
+    chat: "chat";
     help: "help";
     news: "news";
   }>;
@@ -804,8 +796,8 @@ type ModuleOptions = z.infer<typeof moduleSchema>;
 declare const modulesSchema: z.ZodArray<z.ZodObject<{
   label: z.ZodString;
   layout: z.ZodEnum<{
-    chat: "chat";
     home: "home";
+    chat: "chat";
     help: "help";
     news: "news";
   }>;
@@ -1110,10 +1102,6 @@ declare const widgetSettingsSchema: z.ZodObject<{
       server: "server";
       disabled: "disabled";
     }>>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      code: z.ZodString;
-      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>]>>>;
     disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
     enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$loose>>;
@@ -1131,10 +1119,10 @@ declare const widgetSettingsSchema: z.ZodObject<{
       label: z.ZodString;
       type: z.ZodEnum<{
         number: "number";
+        email: "email";
         date: "date";
-        text: "text";
         url: "url";
-        email: "email";
+        text: "text";
         tel: "tel";
         time: "time";
         textarea: "textarea";
@@ -1197,8 +1185,8 @@ declare const widgetSettingsSchema: z.ZodObject<{
   modules: z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
-      chat: "chat";
       home: "home";
+      chat: "chat";
       help: "help";
       news: "news";
     }>;
@@ -1230,10 +1218,10 @@ declare const widgetSettingsSchema: z.ZodObject<{
 }, z.core.$loose>;
 type WidgetSettings = z.infer<typeof widgetSettingsSchema>;
 /**
- * Full client widget config — connection + widget settings + page-mode
- * extras. The dashboard / dev configurator typically only edits one
- * of the two halves at a time (`widgetSettingsSchema` for the dashboard
- * surface, `connectionConfigSchema` for the developer-facing fields).
+ * Full tooling schema — connection + widget settings + page-mode
+ * handshake extras. The dashboard / dev configurator typically only
+ * edits one part at a time (`widgetSettingsSchema` for the dashboard
+ * surface, `connectionConfigSchema` for developer-facing fields).
  */
 declare const widgetConfigSchema: z.ZodObject<{
   widgetId: z.ZodDefault<z.ZodString>;
@@ -1449,10 +1437,6 @@ declare const widgetConfigSchema: z.ZodObject<{
       server: "server";
       disabled: "disabled";
     }>>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      code: z.ZodString;
-      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>]>>>;
     disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
     enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$loose>>;
@@ -1470,10 +1454,10 @@ declare const widgetConfigSchema: z.ZodObject<{
       label: z.ZodString;
       type: z.ZodEnum<{
         number: "number";
+        email: "email";
         date: "date";
-        text: "text";
         url: "url";
-        email: "email";
+        text: "text";
         tel: "tel";
         time: "time";
         textarea: "textarea";
@@ -1536,8 +1520,8 @@ declare const widgetConfigSchema: z.ZodObject<{
   modules: z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
-      chat: "chat";
       home: "home";
+      chat: "chat";
       help: "help";
       news: "news";
     }>;
@@ -1787,10 +1771,6 @@ declare const widgetConfigPartialSchema: z.ZodObject<{
       server: "server";
       disabled: "disabled";
     }>>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      code: z.ZodString;
-      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>]>>>;
     disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
     enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$loose>>>;
@@ -1808,10 +1788,10 @@ declare const widgetConfigPartialSchema: z.ZodObject<{
       label: z.ZodString;
       type: z.ZodEnum<{
         number: "number";
+        email: "email";
         date: "date";
-        text: "text";
         url: "url";
-        email: "email";
+        text: "text";
         tel: "tel";
         time: "time";
         textarea: "textarea";
@@ -1874,8 +1854,8 @@ declare const widgetConfigPartialSchema: z.ZodObject<{
   modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
-      chat: "chat";
       home: "home";
+      chat: "chat";
       help: "help";
       news: "news";
     }>;
@@ -2085,10 +2065,6 @@ declare const widgetSettingsPartialSchema: z.ZodObject<{
       server: "server";
       disabled: "disabled";
     }>>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      code: z.ZodString;
-      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>]>>>;
     disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
     enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$loose>>>;
@@ -2106,10 +2082,10 @@ declare const widgetSettingsPartialSchema: z.ZodObject<{
       label: z.ZodString;
       type: z.ZodEnum<{
         number: "number";
+        email: "email";
         date: "date";
-        text: "text";
         url: "url";
-        email: "email";
+        text: "text";
         tel: "tel";
         time: "time";
         textarea: "textarea";
@@ -2172,8 +2148,8 @@ declare const widgetSettingsPartialSchema: z.ZodObject<{
   modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
-      chat: "chat";
       home: "home";
+      chat: "chat";
       help: "help";
       news: "news";
     }>;
@@ -2245,9 +2221,10 @@ type ConnectionConfigPartial = z.infer<typeof connectionConfigPartialSchema>;
 /**
  * Server-pushable widget settings. Same surface as the editable
  * {@link widgetSettingsSchema} but every field is optional (the server
- * pushes patches, not full configs). Connection fields (publicKey,
- * aiAgentDeploymentId, baseUrl, user, iframe) are deliberately
- * excluded — those are client concerns.
+ * pushes patches, not full configs). Embed identity, host context,
+ * the agent endpoint, storage, and callbacks are deliberately excluded
+ * because they are client concerns. `presentation.iframe` remains a
+ * server-pushable widget setting.
  *
  * Two deltas vs the editable surface:
  *   - `forms` is omitted — resolved form definitions are served by the
@@ -2440,18 +2417,14 @@ declare const serverConfigSchema: z.ZodObject<{
       server: "server";
       disabled: "disabled";
     }>>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      code: z.ZodString;
-      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>]>>>;
     disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
     enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$loose>>>;
   modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
-      chat: "chat";
       home: "home";
+      chat: "chat";
       help: "help";
       news: "news";
     }>;
@@ -2730,18 +2703,14 @@ declare const handshakeResponseSchema: z.ZodObject<{
         server: "server";
         disabled: "disabled";
       }>>;
-      tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        code: z.ZodString;
-        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-      }, z.core.$loose>]>>>;
       disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
       enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$loose>>>;
     modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
       label: z.ZodString;
       layout: z.ZodEnum<{
-        chat: "chat";
         home: "home";
+        chat: "chat";
         help: "help";
         news: "news";
       }>;
@@ -2861,5 +2830,5 @@ declare const ALL_MODES: readonly Mode[];
  */
 declare function emitJsonSchema(): unknown;
 //#endregion
-export { ALL_MODES, ActionName, Asset, AttachmentLimits, Behavior, BlocksConfig, CalloutPosition, CalloutShape, ComposerOptions, ConnectionConfig, ConnectionConfigPartial, Endpoints, FeatureFlags, FeedbackEvent, FeedbackOptions, FieldOption, FieldType, FieldValidation, FooterOptions, FormCondition, FormDef, FormField, FormTranslation, Forms, HandshakeResponse, HapticsOptions, HeaderActions, HeaderOptions, I18nOptions, LauncherCallout, LauncherOptions, LauncherSize, LauncherVariant, Link, Mode, ModuleLayout, ModuleOptions, ModulesOptions, PAGE_AREA_SUGGESTIONS, PageContext, Position, PoweredBy, Presentation, ResizeOptions, ResponseMode, SendButtonOptions, ServerConfig, SiteConfig, SizeOptions, SoundOptions, StringsOverride, ThemeOverrides, ThemePreference, TrackingSettings, UserContext, VoiceMode, WidgetConfig, WidgetConfigPartial, WidgetSettings, WidgetSettingsPartial, actionNameSchema, assetSchema, attachmentLimitsSchema, behaviorSchema, blocksConfigSchema, calloutPositionSchema, calloutShapeSchema, composerOptionsSchema, connectionConfigPartialSchema, connectionConfigSchema, cssColorSchema, cssLengthSchema, emitJsonSchema, endpointsSchema, featureFlagsSchema, feedbackEventSchema, feedbackSchema, fieldOptionSchema, fieldOptionTranslationSchema, fieldTypeSchema, fieldValidationSchema, footerSchema, formConditionSchema, formDefSchema, formFieldSchema, formFieldTranslationSchema, formTranslationSchema, formTriggerSchema, formsSchema, handshakeResponseSchema, hapticsOptionsSchema, headerActionsSchema, headerSchema, i18nSchema, initialSizeSchema, launcherCalloutSchema, launcherOptionsSchema, launcherSizeSchema, launcherVariantSchema, linkSchema, localeSchema, modeSchema, moduleLayoutSchema, moduleSchema, modulesSchema, pageContextSchema, positionSchema, poweredBySchema, presentationSchema, resizeOptionsSchema, responseModeSchema, sendButtonIconSchema, sendButtonOptionsSchema, sendButtonShapeSchema, sendButtonVariantSchema, serverConfigSchema, siteConfigSchema, sizeOptionsSchema, soundOptionsSchema, stringsOverrideSchema, themeFieldSchema, themeOverridesSchema, themePreferenceSchema, toolRefSchema, trackingSchema, userContextSchema, uuid7Schema, voiceModeSchema, widgetConfigPartialSchema, widgetConfigSchema, widgetSettingsPartialSchema, widgetSettingsSchema, widgetSettingsSchemaForMode };
+export { ALL_MODES, ActionName, Asset, AttachmentLimits, Behavior, BlocksConfig, CalloutPosition, CalloutShape, ComposerOptions, ConnectionConfig, ConnectionConfigPartial, Endpoints, FeatureFlags, FeedbackEvent, FeedbackOptions, FieldOption, FieldType, FieldValidation, FooterOptions, FormCondition, FormDef, FormField, FormTranslation, Forms, HandshakeResponse, HapticsOptions, HeaderActions, HeaderOptions, I18nOptions, LauncherCallout, LauncherOptions, LauncherSize, LauncherVariant, Link, Mode, ModuleLayout, ModuleOptions, ModulesOptions, PAGE_AREA_SUGGESTIONS, PageContext, Position, PoweredBy, Presentation, ResizeOptions, ResponseMode, SendButtonOptions, ServerConfig, SiteConfig, SizeOptions, SoundOptions, StringsOverride, ThemeOverrides, ThemePreference, TrackingSettings, UserContext, VoiceMode, WidgetConfig, WidgetConfigPartial, WidgetSettings, WidgetSettingsPartial, actionNameSchema, assetSchema, attachmentLimitsSchema, behaviorSchema, blocksConfigSchema, calloutPositionSchema, calloutShapeSchema, composerOptionsSchema, connectionConfigPartialSchema, connectionConfigSchema, cssColorSchema, cssLengthSchema, emitJsonSchema, endpointsSchema, featureFlagsSchema, feedbackEventSchema, feedbackSchema, fieldOptionSchema, fieldOptionTranslationSchema, fieldTypeSchema, fieldValidationSchema, footerSchema, formConditionSchema, formDefSchema, formFieldSchema, formFieldTranslationSchema, formTranslationSchema, formTriggerSchema, formsSchema, handshakeResponseSchema, hapticsOptionsSchema, headerActionsSchema, headerSchema, i18nSchema, initialSizeSchema, launcherCalloutSchema, launcherOptionsSchema, launcherSizeSchema, launcherVariantSchema, linkSchema, localeSchema, modeSchema, moduleLayoutSchema, moduleSchema, modulesSchema, pageContextSchema, positionSchema, poweredBySchema, presentationSchema, resizeOptionsSchema, responseModeSchema, sendButtonIconSchema, sendButtonOptionsSchema, sendButtonShapeSchema, sendButtonVariantSchema, serverConfigSchema, siteConfigSchema, sizeOptionsSchema, soundOptionsSchema, stringsOverrideSchema, themeFieldSchema, themeOverridesSchema, themePreferenceSchema, trackingSchema, userContextSchema, uuid7Schema, voiceModeSchema, widgetConfigPartialSchema, widgetConfigSchema, widgetSettingsPartialSchema, widgetSettingsSchema, widgetSettingsSchemaForMode };
 //# sourceMappingURL=schema.d.ts.map

package/schema.json

@@ -472,7 +472,7 @@
             },
             "showReasoning": {
               "default": false,
-              "description": "Show the model's reasoning (\"thoughts\") as a collapsible block above each answer. `false` (default) hides it — a loading indicator still shows while the model works. Reasoning is never persisted; it only appears live.",
+              "description": "Show the model's reasoning (\"thoughts\") as a collapsible block above each answer. `false` (default) hides it — a loading indicator still shows while the model works. Reasoning is absent from durable history, but the current turn's short-lived resume backlog may replay it after an immediate reconnect or reload.",
               "type": "boolean"
             },
             "showToolCalls": {
@@ -1283,41 +1283,6 @@
                 "disabled"
               ]
             },
-            "tools": {
-              "description": "Backend tools the assistant may invoke. Bare codes (`'tool:send-money'`) or rich refs (`{ code, config }`).",
-              "maxItems": 200,
-              "type": "array",
-              "items": {
-                "anyOf": [
-                  {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 200
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "code": {
-                        "type": "string",
-                        "minLength": 1,
-                        "maxLength": 200
-                      },
-                      "config": {
-                        "type": "object",
-                        "propertyNames": {
-                          "type": "string"
-                        },
-                        "additionalProperties": {}
-                      }
-                    },
-                    "required": [
-                      "code"
-                    ],
-                    "additionalProperties": {}
-                  }
-                ]
-              }
-            },
             "disableHumanInLoop": {
               "default": false,
               "description": "Turn OFF the human-in-the-loop tool UI — the inline ask-questions form + approve/reject controls for gated tools. Unset/`false` = shown (default), `true` = suppressed (the wire still carries the signals).",
@@ -1336,7 +1301,7 @@
             "enableOperatorRequest"
           ],
           "additionalProperties": {},
-          "description": "Capability flags — file upload, voice mode, and the tools the assistant may invoke.",
+          "description": "Capability flags — file upload, voice mode, HITL, and operator requests.",
           "examples": [
             {
               "voice": "local"
@@ -1347,9 +1312,7 @@
             },
             {
               "voice": "server",
-              "tools": [
-                "tool:send-money"
-              ]
+              "enableOperatorRequest": true
             }
           ]
         },
@@ -2028,7 +1991,7 @@
         "theme"
       ],
       "additionalProperties": {},
-      "description": "Full client widget config — connection (where + auth) + widget settings (look + behaviour) + page-mode extras. This is what the runtime parses on `mount()` / `init()`. Mode-specific constraints (e.g. `position` only meaningful in `floating`) are NOT enforced here — the runtime silently ignores irrelevant fields rather than rejecting them so the same object can flow across mode changes.",
+      "description": "Full tooling config — connection (where + auth) + widget settings (look + behaviour) + page-mode handshake extras. The production widget does not import this Zod schema. Mode-specific constraints (e.g. `position` only meaningful in `floating`) are NOT enforced here so the same object can flow across mode changes.",
       "examples": [
         {
           "publicKey": "agent_pk_demo",
@@ -2355,7 +2318,7 @@
                 },
                 "showReasoning": {
                   "default": false,
-                  "description": "Show the model's reasoning (\"thoughts\") as a collapsible block above each answer. `false` (default) hides it — a loading indicator still shows while the model works. Reasoning is never persisted; it only appears live.",
+                  "description": "Show the model's reasoning (\"thoughts\") as a collapsible block above each answer. `false` (default) hides it — a loading indicator still shows while the model works. Reasoning is absent from durable history, but the current turn's short-lived resume backlog may replay it after an immediate reconnect or reload.",
                   "type": "boolean"
                 },
                 "showToolCalls": {
@@ -3166,41 +3129,6 @@
                     "disabled"
                   ]
                 },
-                "tools": {
-                  "description": "Backend tools the assistant may invoke. Bare codes (`'tool:send-money'`) or rich refs (`{ code, config }`).",
-                  "maxItems": 200,
-                  "type": "array",
-                  "items": {
-                    "anyOf": [
-                      {
-                        "type": "string",
-                        "minLength": 1,
-                        "maxLength": 200
-                      },
-                      {
-                        "type": "object",
-                        "properties": {
-                          "code": {
-                            "type": "string",
-                            "minLength": 1,
-                            "maxLength": 200
-                          },
-                          "config": {
-                            "type": "object",
-                            "propertyNames": {
-                              "type": "string"
-                            },
-                            "additionalProperties": {}
-                          }
-                        },
-                        "required": [
-                          "code"
-                        ],
-                        "additionalProperties": {}
-                      }
-                    ]
-                  }
-                },
                 "disableHumanInLoop": {
                   "default": false,
                   "description": "Turn OFF the human-in-the-loop tool UI — the inline ask-questions form + approve/reject controls for gated tools. Unset/`false` = shown (default), `true` = suppressed (the wire still carries the signals).",
@@ -3219,7 +3147,7 @@
                 "enableOperatorRequest"
               ],
               "additionalProperties": {},
-              "description": "Capability flags — file upload, voice mode, and the tools the assistant may invoke.",
+              "description": "Capability flags — file upload, voice mode, HITL, and operator requests.",
               "examples": [
                 {
                   "voice": "local"
@@ -3230,9 +3158,7 @@
                 },
                 {
                   "voice": "server",
-                  "tools": [
-                    "tool:send-money"
-                  ]
+                  "enableOperatorRequest": true
                 }
               ]
             },