@syntrologie/adapt-chatbot 2.28.0 → 2.29.0

package/dist/schema.d.ts

@@ -15,6 +15,7 @@ export declare const configSchema: z.ZodObject<{
     maxHistory: z.ZodDefault<z.ZodNumber>;
     /** Quick-reply suggestions shown in the empty state */
     suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    voiceInput: z.ZodOptional<z.ZodBoolean>;
     /**
      * Per-customer fallback card rendered when chat can't open (Turnstile
      * failure, network error, etc.). The end-user is redirected to the
@@ -31,13 +32,13 @@ export declare const configSchema: z.ZodObject<{
         /** Target of the CTA link — typically the customer's existing support path. */
         ctaHref: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
     }, "strict", z.ZodTypeAny, {
-        title?: string | undefined;
         message?: string | undefined;
+        title?: string | undefined;
         ctaLabel?: string | undefined;
         ctaHref?: string | undefined;
     }, {
-        title?: string | undefined;
         message?: string | undefined;
+        title?: string | undefined;
         ctaLabel?: string | undefined;
         ctaHref?: string | undefined;
     }>>;
@@ -45,23 +46,25 @@ export declare const configSchema: z.ZodObject<{
     greeting: string;
     backendUrl: string;
     maxHistory: number;
+    voiceInput?: boolean | undefined;
     mlflowRunId?: string | undefined;
     suggestions?: string[] | undefined;
     fallback?: {
-        title?: string | undefined;
         message?: string | undefined;
+        title?: string | undefined;
         ctaLabel?: string | undefined;
         ctaHref?: string | undefined;
     } | undefined;
 }, {
     backendUrl: string;
     greeting?: string | undefined;
+    voiceInput?: boolean | undefined;
     mlflowRunId?: string | undefined;
     maxHistory?: number | undefined;
     suggestions?: string[] | undefined;
     fallback?: {
-        title?: string | undefined;
         message?: string | undefined;
+        title?: string | undefined;
         ctaLabel?: string | undefined;
         ctaHref?: string | undefined;
     } | undefined;
@@ -70,12 +73,13 @@ export type ChatbotConfigSchema = z.infer<typeof configSchema>;
 export declare function validateChatbotConfig(data: unknown): z.SafeParseReturnType<{
     backendUrl: string;
     greeting?: string | undefined;
+    voiceInput?: boolean | undefined;
     mlflowRunId?: string | undefined;
     maxHistory?: number | undefined;
     suggestions?: string[] | undefined;
     fallback?: {
-        title?: string | undefined;
         message?: string | undefined;
+        title?: string | undefined;
         ctaLabel?: string | undefined;
         ctaHref?: string | undefined;
     } | undefined;
@@ -83,11 +87,12 @@ export declare function validateChatbotConfig(data: unknown): z.SafeParseReturnT
     greeting: string;
     backendUrl: string;
     maxHistory: number;
+    voiceInput?: boolean | undefined;
     mlflowRunId?: string | undefined;
     suggestions?: string[] | undefined;
     fallback?: {
-        title?: string | undefined;
         message?: string | undefined;
+        title?: string | undefined;
         ctaLabel?: string | undefined;
         ctaHref?: string | undefined;
     } | undefined;
@@ -104,36 +109,164 @@ export declare function validateChatbotConfig(data: unknown): z.SafeParseReturnT
  */
 export declare const chatBarPropsSchema: z.ZodObject<{
     placeholder: z.ZodOptional<z.ZodString>;
+    assistantName: z.ZodOptional<z.ZodString>;
+    personas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        role_title: z.ZodOptional<z.ZodString>;
+        pronouns: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodObject<{
+            sm: z.ZodOptional<z.ZodString>;
+            md: z.ZodOptional<z.ZodString>;
+            lg: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            md?: string | undefined;
+            sm?: string | undefined;
+            lg?: string | undefined;
+        }, {
+            md?: string | undefined;
+            sm?: string | undefined;
+            lg?: string | undefined;
+        }>>;
+        intro_line: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        avatar?: {
+            md?: string | undefined;
+            sm?: string | undefined;
+            lg?: string | undefined;
+        } | undefined;
+        role_title?: string | undefined;
+        pronouns?: string | undefined;
+        intro_line?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        avatar?: {
+            md?: string | undefined;
+            sm?: string | undefined;
+            lg?: string | undefined;
+        } | undefined;
+        role_title?: string | undefined;
+        pronouns?: string | undefined;
+        intro_line?: string | undefined;
+    }>, "many">>;
     messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
         role: z.ZodEnum<["user", "assistant"]>;
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        role: "user" | "assistant";
-        text: string;
         id: string | number;
-    }, {
-        role: "user" | "assistant";
         text: string;
+        role: "user" | "assistant";
+    }, {
         id: string | number;
+        text: string;
+        role: "user" | "assistant";
     }>, "many">>;
     inFlight: z.ZodOptional<z.ZodBoolean>;
+    forceExpanded: z.ZodOptional<z.ZodBoolean>;
+    backendUrl: z.ZodOptional<z.ZodString>;
+    greeting: z.ZodOptional<z.ZodString>;
+    introSuggestion: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        prompt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        prompt: string;
+    }, {
+        label: string;
+        prompt: string;
+    }>>;
+    fallback: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        ctaLabel: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        title: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        ctaLabel: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        title: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        ctaLabel: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    elementsEnabled: z.ZodOptional<z.ZodBoolean>;
+    uiTemplates: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>>;
+    voiceInput: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     messages?: {
-        role: "user" | "assistant";
-        text: string;
         id: string | number;
+        text: string;
+        role: "user" | "assistant";
     }[] | undefined;
-    placeholder?: string | undefined;
+    greeting?: string | undefined;
+    forceExpanded?: boolean | undefined;
     inFlight?: boolean | undefined;
+    introSuggestion?: {
+        label: string;
+        prompt: string;
+    } | undefined;
+    personas?: {
+        id: string;
+        name: string;
+        avatar?: {
+            md?: string | undefined;
+            sm?: string | undefined;
+            lg?: string | undefined;
+        } | undefined;
+        role_title?: string | undefined;
+        pronouns?: string | undefined;
+        intro_line?: string | undefined;
+    }[] | undefined;
+    placeholder?: string | undefined;
+    assistantName?: string | undefined;
+    voiceInput?: boolean | undefined;
+    backendUrl?: string | undefined;
+    fallback?: z.objectOutputType<{
+        title: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        ctaLabel: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    elementsEnabled?: boolean | undefined;
+    uiTemplates?: Record<string, unknown> | undefined;
 }, {
     messages?: {
-        role: "user" | "assistant";
-        text: string;
         id: string | number;
+        text: string;
+        role: "user" | "assistant";
     }[] | undefined;
-    placeholder?: string | undefined;
+    greeting?: string | undefined;
+    forceExpanded?: boolean | undefined;
     inFlight?: boolean | undefined;
+    introSuggestion?: {
+        label: string;
+        prompt: string;
+    } | undefined;
+    personas?: {
+        id: string;
+        name: string;
+        avatar?: {
+            md?: string | undefined;
+            sm?: string | undefined;
+            lg?: string | undefined;
+        } | undefined;
+        role_title?: string | undefined;
+        pronouns?: string | undefined;
+        intro_line?: string | undefined;
+    }[] | undefined;
+    placeholder?: string | undefined;
+    assistantName?: string | undefined;
+    voiceInput?: boolean | undefined;
+    backendUrl?: string | undefined;
+    fallback?: z.objectInputType<{
+        title: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        ctaLabel: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    elementsEnabled?: boolean | undefined;
+    uiTemplates?: Record<string, unknown> | undefined;
 }>;
 export type ChatBarProps = z.infer<typeof chatBarPropsSchema>;
 /**
@@ -158,15 +291,15 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
                 props?: Record<string, unknown> | undefined;
             }>;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         }, {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
@@ -309,7 +442,7 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
                     withinMs: z.ZodOptional<z.ZodNumber>;
                     counter: z.ZodOptional<z.ZodObject<{
                         events: z.ZodArray<z.ZodEnum<["ui.click", "ui.scroll", "ui.input", "ui.change", "ui.submit", "ui.hover", "ui.idle", "ui.scroll_thrash", "ui.focus_bounce", "ui.hesitate", "ui.rage_click", "nav.page_view", "nav.page_leave"]>, "many">;
-                        match: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                        match: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
                             equals: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
                             contains: z.ZodOptional<z.ZodString>;
                         }, "strip", z.ZodTypeAny, {
@@ -318,6 +451,12 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
                         }, {
                             equals?: string | number | boolean | undefined;
                             contains?: string | undefined;
+                        }>, {
+                            equals?: string | number | boolean | undefined;
+                            contains?: string | undefined;
+                        }, {
+                            equals?: string | number | boolean | undefined;
+                            contains?: string | undefined;
                         }>>>;
                     }, "strip", z.ZodTypeAny, {
                         events: ("ui.click" | "ui.scroll" | "ui.input" | "ui.change" | "ui.submit" | "ui.hover" | "ui.idle" | "ui.scroll_thrash" | "ui.focus_bounce" | "ui.hesitate" | "ui.rage_click" | "nav.page_view" | "nav.page_leave")[];
@@ -676,16 +815,16 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
         validation: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";
@@ -776,16 +915,16 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
         description?: string | undefined;
     }, {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";
@@ -876,16 +1015,16 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
         description?: string | undefined;
     }>, {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";
@@ -976,16 +1115,16 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
         description?: string | undefined;
     }, {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";
@@ -1078,16 +1217,16 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     chips: {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";
@@ -1180,16 +1319,16 @@ export declare const chipsStripPropsSchema: z.ZodObject<{
 }, {
     chips?: {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";
@@ -1300,6 +1439,7 @@ export declare const tileWidgets: ({
         maxHistory: z.ZodDefault<z.ZodNumber>;
         /** Quick-reply suggestions shown in the empty state */
         suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        voiceInput: z.ZodOptional<z.ZodBoolean>;
         /**
          * Per-customer fallback card rendered when chat can't open (Turnstile
          * failure, network error, etc.). The end-user is redirected to the
@@ -1316,13 +1456,13 @@ export declare const tileWidgets: ({
             /** Target of the CTA link — typically the customer's existing support path. */
             ctaHref: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
         }, "strict", z.ZodTypeAny, {
-            title?: string | undefined;
             message?: string | undefined;
+            title?: string | undefined;
             ctaLabel?: string | undefined;
             ctaHref?: string | undefined;
         }, {
-            title?: string | undefined;
             message?: string | undefined;
+            title?: string | undefined;
             ctaLabel?: string | undefined;
             ctaHref?: string | undefined;
         }>>;
@@ -1330,23 +1470,25 @@ export declare const tileWidgets: ({
         greeting: string;
         backendUrl: string;
         maxHistory: number;
+        voiceInput?: boolean | undefined;
         mlflowRunId?: string | undefined;
         suggestions?: string[] | undefined;
         fallback?: {
-            title?: string | undefined;
             message?: string | undefined;
+            title?: string | undefined;
             ctaLabel?: string | undefined;
             ctaHref?: string | undefined;
         } | undefined;
     }, {
         backendUrl: string;
         greeting?: string | undefined;
+        voiceInput?: boolean | undefined;
         mlflowRunId?: string | undefined;
         maxHistory?: number | undefined;
         suggestions?: string[] | undefined;
         fallback?: {
-            title?: string | undefined;
             message?: string | undefined;
+            title?: string | undefined;
             ctaLabel?: string | undefined;
             ctaHref?: string | undefined;
         } | undefined;
@@ -1356,36 +1498,164 @@ export declare const tileWidgets: ({
     defName: string;
     propsSchema: z.ZodObject<{
         placeholder: z.ZodOptional<z.ZodString>;
+        assistantName: z.ZodOptional<z.ZodString>;
+        personas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            role_title: z.ZodOptional<z.ZodString>;
+            pronouns: z.ZodOptional<z.ZodString>;
+            avatar: z.ZodOptional<z.ZodObject<{
+                sm: z.ZodOptional<z.ZodString>;
+                md: z.ZodOptional<z.ZodString>;
+                lg: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                md?: string | undefined;
+                sm?: string | undefined;
+                lg?: string | undefined;
+            }, {
+                md?: string | undefined;
+                sm?: string | undefined;
+                lg?: string | undefined;
+            }>>;
+            intro_line: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            avatar?: {
+                md?: string | undefined;
+                sm?: string | undefined;
+                lg?: string | undefined;
+            } | undefined;
+            role_title?: string | undefined;
+            pronouns?: string | undefined;
+            intro_line?: string | undefined;
+        }, {
+            id: string;
+            name: string;
+            avatar?: {
+                md?: string | undefined;
+                sm?: string | undefined;
+                lg?: string | undefined;
+            } | undefined;
+            role_title?: string | undefined;
+            pronouns?: string | undefined;
+            intro_line?: string | undefined;
+        }>, "many">>;
         messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
             role: z.ZodEnum<["user", "assistant"]>;
             text: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            role: "user" | "assistant";
-            text: string;
             id: string | number;
-        }, {
-            role: "user" | "assistant";
             text: string;
+            role: "user" | "assistant";
+        }, {
             id: string | number;
+            text: string;
+            role: "user" | "assistant";
         }>, "many">>;
         inFlight: z.ZodOptional<z.ZodBoolean>;
+        forceExpanded: z.ZodOptional<z.ZodBoolean>;
+        backendUrl: z.ZodOptional<z.ZodString>;
+        greeting: z.ZodOptional<z.ZodString>;
+        introSuggestion: z.ZodOptional<z.ZodObject<{
+            label: z.ZodString;
+            prompt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            prompt: string;
+        }, {
+            label: string;
+            prompt: string;
+        }>>;
+        fallback: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+            ctaLabel: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            title: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+            ctaLabel: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            title: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+            ctaLabel: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        elementsEnabled: z.ZodOptional<z.ZodBoolean>;
+        uiTemplates: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>>;
+        voiceInput: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         messages?: {
-            role: "user" | "assistant";
-            text: string;
             id: string | number;
+            text: string;
+            role: "user" | "assistant";
         }[] | undefined;
-        placeholder?: string | undefined;
+        greeting?: string | undefined;
+        forceExpanded?: boolean | undefined;
         inFlight?: boolean | undefined;
+        introSuggestion?: {
+            label: string;
+            prompt: string;
+        } | undefined;
+        personas?: {
+            id: string;
+            name: string;
+            avatar?: {
+                md?: string | undefined;
+                sm?: string | undefined;
+                lg?: string | undefined;
+            } | undefined;
+            role_title?: string | undefined;
+            pronouns?: string | undefined;
+            intro_line?: string | undefined;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        assistantName?: string | undefined;
+        voiceInput?: boolean | undefined;
+        backendUrl?: string | undefined;
+        fallback?: z.objectOutputType<{
+            title: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+            ctaLabel: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+        elementsEnabled?: boolean | undefined;
+        uiTemplates?: Record<string, unknown> | undefined;
     }, {
         messages?: {
-            role: "user" | "assistant";
-            text: string;
             id: string | number;
+            text: string;
+            role: "user" | "assistant";
         }[] | undefined;
-        placeholder?: string | undefined;
+        greeting?: string | undefined;
+        forceExpanded?: boolean | undefined;
         inFlight?: boolean | undefined;
+        introSuggestion?: {
+            label: string;
+            prompt: string;
+        } | undefined;
+        personas?: {
+            id: string;
+            name: string;
+            avatar?: {
+                md?: string | undefined;
+                sm?: string | undefined;
+                lg?: string | undefined;
+            } | undefined;
+            role_title?: string | undefined;
+            pronouns?: string | undefined;
+            intro_line?: string | undefined;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        assistantName?: string | undefined;
+        voiceInput?: boolean | undefined;
+        backendUrl?: string | undefined;
+        fallback?: z.objectInputType<{
+            title: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+            ctaLabel: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+        elementsEnabled?: boolean | undefined;
+        uiTemplates?: Record<string, unknown> | undefined;
     }>;
 } | {
     widget: string;
@@ -1407,15 +1677,15 @@ export declare const tileWidgets: ({
                     props?: Record<string, unknown> | undefined;
                 }>;
             }, "strip", z.ZodTypeAny, {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
                 };
             }, {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
@@ -1558,7 +1828,7 @@ export declare const tileWidgets: ({
                         withinMs: z.ZodOptional<z.ZodNumber>;
                         counter: z.ZodOptional<z.ZodObject<{
                             events: z.ZodArray<z.ZodEnum<["ui.click", "ui.scroll", "ui.input", "ui.change", "ui.submit", "ui.hover", "ui.idle", "ui.scroll_thrash", "ui.focus_bounce", "ui.hesitate", "ui.rage_click", "nav.page_view", "nav.page_leave"]>, "many">;
-                            match: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                            match: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
                                 equals: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
                                 contains: z.ZodOptional<z.ZodString>;
                             }, "strip", z.ZodTypeAny, {
@@ -1567,6 +1837,12 @@ export declare const tileWidgets: ({
                             }, {
                                 equals?: string | number | boolean | undefined;
                                 contains?: string | undefined;
+                            }>, {
+                                equals?: string | number | boolean | undefined;
+                                contains?: string | undefined;
+                            }, {
+                                equals?: string | number | boolean | undefined;
+                                contains?: string | undefined;
                             }>>>;
                         }, "strip", z.ZodTypeAny, {
                             events: ("ui.click" | "ui.scroll" | "ui.input" | "ui.change" | "ui.submit" | "ui.hover" | "ui.idle" | "ui.scroll_thrash" | "ui.focus_bounce" | "ui.hesitate" | "ui.rage_click" | "nav.page_view" | "nav.page_leave")[];
@@ -1925,16 +2201,16 @@ export declare const tileWidgets: ({
             validation: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             config: {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
                 };
             };
             kind: "suggestions:chip";
-            title?: string | undefined;
             id?: string | undefined;
+            title?: string | undefined;
             validation?: string[] | undefined;
             triggerWhen?: {
                 type: "rules";
@@ -2025,16 +2301,16 @@ export declare const tileWidgets: ({
             description?: string | undefined;
         }, {
             config: {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
                 };
             };
             kind: "suggestions:chip";
-            title?: string | undefined;
             id?: string | undefined;
+            title?: string | undefined;
             validation?: string[] | undefined;
             triggerWhen?: {
                 type: "rules";
@@ -2125,16 +2401,16 @@ export declare const tileWidgets: ({
             description?: string | undefined;
         }>, {
             config: {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
                 };
             };
             kind: "suggestions:chip";
-            title?: string | undefined;
             id?: string | undefined;
+            title?: string | undefined;
             validation?: string[] | undefined;
             triggerWhen?: {
                 type: "rules";
@@ -2225,16 +2501,16 @@ export declare const tileWidgets: ({
             description?: string | undefined;
         }, {
             config: {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
                 };
             };
             kind: "suggestions:chip";
-            title?: string | undefined;
             id?: string | undefined;
+            title?: string | undefined;
             validation?: string[] | undefined;
             triggerWhen?: {
                 type: "rules";
@@ -2327,16 +2603,16 @@ export declare const tileWidgets: ({
     }, "strict", z.ZodTypeAny, {
         chips: {
             config: {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
                 };
             };
             kind: "suggestions:chip";
-            title?: string | undefined;
             id?: string | undefined;
+            title?: string | undefined;
             validation?: string[] | undefined;
             triggerWhen?: {
                 type: "rules";
@@ -2429,16 +2705,16 @@ export declare const tileWidgets: ({
     }, {
         chips?: {
             config: {
-                title: string;
                 id: string;
+                title: string;
                 payload: {
                     widget: string;
                     props?: Record<string, unknown> | undefined;
                 };
             };
             kind: "suggestions:chip";
-            title?: string | undefined;
             id?: string | undefined;
+            title?: string | undefined;
             validation?: string[] | undefined;
             triggerWhen?: {
                 type: "rules";
@@ -2530,6 +2806,20 @@ export declare const tileWidgets: ({
         }[] | undefined;
     }>;
 })[];
+export declare const CAPABILITIES_DOCUMENTATION: {
+    packageId: string;
+    plannerSummary: string;
+    description: string;
+    whenToUse: {
+        goal: string;
+        action: string;
+    }[];
+    conventions: {
+        name: string;
+        description: string;
+    }[];
+    events: string[];
+};
 /**
  * Action step schemas — registered into the unified canvas-config
  * JSON Schema's action-step union so authors (and the tactician LLM)
@@ -2558,15 +2848,15 @@ export declare const actionStepSchemas: {
                 props?: Record<string, unknown> | undefined;
             }>;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         }, {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
@@ -2709,7 +2999,7 @@ export declare const actionStepSchemas: {
                     withinMs: z.ZodOptional<z.ZodNumber>;
                     counter: z.ZodOptional<z.ZodObject<{
                         events: z.ZodArray<z.ZodEnum<["ui.click", "ui.scroll", "ui.input", "ui.change", "ui.submit", "ui.hover", "ui.idle", "ui.scroll_thrash", "ui.focus_bounce", "ui.hesitate", "ui.rage_click", "nav.page_view", "nav.page_leave"]>, "many">;
-                        match: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                        match: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
                             equals: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
                             contains: z.ZodOptional<z.ZodString>;
                         }, "strip", z.ZodTypeAny, {
@@ -2718,6 +3008,12 @@ export declare const actionStepSchemas: {
                         }, {
                             equals?: string | number | boolean | undefined;
                             contains?: string | undefined;
+                        }>, {
+                            equals?: string | number | boolean | undefined;
+                            contains?: string | undefined;
+                        }, {
+                            equals?: string | number | boolean | undefined;
+                            contains?: string | undefined;
                         }>>>;
                     }, "strip", z.ZodTypeAny, {
                         events: ("ui.click" | "ui.scroll" | "ui.input" | "ui.change" | "ui.submit" | "ui.hover" | "ui.idle" | "ui.scroll_thrash" | "ui.focus_bounce" | "ui.hesitate" | "ui.rage_click" | "nav.page_view" | "nav.page_leave")[];
@@ -3076,16 +3372,16 @@ export declare const actionStepSchemas: {
         validation: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";
@@ -3176,16 +3472,16 @@ export declare const actionStepSchemas: {
         description?: string | undefined;
     }, {
         config: {
-            title: string;
             id: string;
+            title: string;
             payload: {
                 widget: string;
                 props?: Record<string, unknown> | undefined;
             };
         };
         kind: "suggestions:chip";
-        title?: string | undefined;
         id?: string | undefined;
+        title?: string | undefined;
         validation?: string[] | undefined;
         triggerWhen?: {
             type: "rules";