@8wave/ai-elements 0.98.0 → 0.99.0-beta.1

package/dist-vue/locales.js

@@ -197,6 +197,7 @@ var e = {
 		teams: "Microsoft Teams",
 		formMaxSteps: "Maximum steps",
 		formMaxOptionsPerStep: "Max options per step",
+		toolRequiresApproval: "Ask the user to confirm",
 		chatWidget: "Chat Widget",
 		widgetUrl: "Widget URL",
 		loadDelay: "Load Delay (ms)",
@@ -256,6 +257,7 @@ var e = {
 		includeThoughts: "View reasoning",
 		thinking: "Thinking",
 		enabled: "Enabled",
+		toolApprovalBadge: "User confirm",
 		calendarEvent: "Event",
 		comparison: "Comparison",
 		contactUs: "Contact us",
@@ -335,6 +337,7 @@ var e = {
 		dismissableNotice: "It will be hidden after the first message.",
 		privacyPolicyNotice: "Displayed at the bottom of the contact form. Supports Markdown.",
 		fileUploadEnabled: "Allow users to attach files to their messages.",
+		approvalChannels: "A tool can ask the user to confirm before it runs: expand a tool to turn it on. On API endpoints and scheduled runs the call is refused.",
 		platformSupported: "Renders natively on WhatsApp and Teams",
 		formMaxSteps: "Maximum number of steps the agent can generate in a single form (min. 1, max. 10).",
 		formMaxOptionsPerStep: "Maximum number of options for each choice step (min. 2, max. 10).",
@@ -342,6 +345,7 @@ var e = {
 			useAllUserKb: "Reads the memories the user shared with all their agents, not just this one. Writing stays scoped to this agent.",
 			useAllUserFiles: "Searches all the user's files, including those uploaded on other agents, not just this agent's."
 		},
+		toolRequiresApproval: "The assistant waits for approval in the chat before running.",
 		channelWidgetDisabled: "The Widget channel is disabled: the embed code and loader will not work.",
 		channelAppDisabled: "The App channel is disabled: the direct link and iframe will not work.",
 		embedCode: "Copy and paste this code to embed the agent in your website.",
@@ -456,6 +460,10 @@ var e = {
 		reasoning: "Reasoning...",
 		streaming: "Loading..."
 	},
+	toolApproval: {
+		expired: "This request is no longer answerable: the action was not performed.",
+		prompt: "Your confirmation is needed to continue:"
+	},
 	validation: { invalidPhoneNumber: "The number entered is incorrect" },
 	showForm: {
 		step: "Step {current} of {total}",
@@ -666,6 +674,7 @@ var e = {
 		teams: "Microsoft Teams",
 		formMaxSteps: "Numero massimo di step",
 		formMaxOptionsPerStep: "Opzioni massime per step",
+		toolRequiresApproval: "Chiedi conferma all'utente",
 		chatWidget: "Chat Widget",
 		widgetUrl: "URL widget",
 		loadDelay: "Ritardo caricamento (ms)",
@@ -725,6 +734,7 @@ var e = {
 		includeThoughts: "Visualizza ragionamento",
 		thinking: "Pensiero",
 		enabled: "Abilitato",
+		toolApprovalBadge: "Conferma utente",
 		calendarEvent: "Evento",
 		comparison: "Confronto",
 		contactUs: "Contattaci",
@@ -804,6 +814,7 @@ var e = {
 		dismissableNotice: "Verrà nascosto dopo il primo messaggio.",
 		privacyPolicyNotice: "Visibile del modulo di contatto.",
 		fileUploadEnabled: "Permetti agli utenti di allegare file ai messaggi.",
+		approvalChannels: "Un tool può chiedere conferma all'utente prima di eseguire: espandi il tool per attivarla. Via API o in esecuzioni schedulate la chiamata viene rifiutata.",
 		platformSupported: "Resa nativa su WhatsApp e Teams",
 		formMaxSteps: "Numero massimo di step che l'agente può generare in un singolo form (min. 1, max. 10).",
 		formMaxOptionsPerStep: "Numero massimo di opzioni per ciascuno step di scelta (min. 2, max. 10).",
@@ -811,6 +822,7 @@ var e = {
 			useAllUserKb: "Legge le memorie che l'utente ha condiviso con tutti i suoi agenti, non solo con questo. La scrittura resta legata a questo agente.",
 			useAllUserFiles: "Cerca in tutti i file dell'utente, anche quelli caricati su altri agenti, non solo in quelli di questo agente."
 		},
+		toolRequiresApproval: "Prima di eseguire, l'assistente attende l'approvazione in chat.",
 		channelWidgetDisabled: "Il canale Widget è disabilitato: il codice embed e il loader non funzioneranno.",
 		channelAppDisabled: "Il canale App è disabilitato: il link diretto e l'iframe non funzioneranno.",
 		embedCode: "Copia e incolla questo codice per incorporare l'agente nel tuo sito web.",
@@ -925,6 +937,10 @@ var e = {
 		reasoning: "Ragionamento...",
 		streaming: "Caricamento..."
 	},
+	toolApproval: {
+		expired: "Questa richiesta non è più confermabile: l'azione non è stata eseguita.",
+		prompt: "Per continuare serve la tua conferma:"
+	},
 	validation: { invalidPhoneNumber: "Il numero inserito non è corretto" },
 	showForm: {
 		step: "Domanda {current} di {total}",

package/dist-vue/packages/components/src/PkCheckboxField.d.ts

@@ -0,0 +1,45 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    label: string;
+    hint?: string;
+    /** Field name, unique within the form. */
+    name?: string;
+    disabled?: boolean;
+};
+type __VLS_ModelProps = {
+    /**
+         * A checkbox (or switch) with a bold label and an optional hint below it, the
+         * shape settings panels use for every boolean option. It exists because that
+         * markup was copied in ~30 places: same three elements, same utility classes,
+         * drifting one edit at a time.
+         *
+         * Layout only. Wording stays with the caller, so labels keep living next to
+         * the option they describe (and in the caller's i18n keys).
+         *
+         * Extra content under the hint (badges, a channel-support strip) goes in the
+         * default slot; options that need a whole custom body are better off with
+         * `VvCheckbox` directly.
+         *
+         * Anything else is forwarded to `VvCheckbox`, `switch` included: options that
+         * read as on/off rather than opt-in pass it as a plain attribute.
+         */
+    modelValue?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_8: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+}, string, PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist-vue/packages/components/src/PkEditorRepeater.d.ts

@@ -14,7 +14,7 @@ declare const __VLS_export: <T extends Record<string, any>>(__VLS_props: NonNull
         allowEmpty?: boolean;
         force?: boolean;
     } & {
-        "onUpdate:modelValue"?: ((value: T[]) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: Partial<T>[]) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
@@ -34,7 +34,7 @@ declare const __VLS_export: <T extends Record<string, any>>(__VLS_props: NonNull
     } & {
         actions?: (props: {}) => any;
     };
-    emit: (evt: "update:modelValue", value: T[]) => void;
+    emit: (evt: "update:modelValue", value: Partial<T>[]) => void;
 }>) => VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist-vue/packages/components/src/PkPwaInstallPrompt.d.ts

@@ -0,0 +1,4 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const __VLS_export: DefineComponent<{}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist-vue/packages/components/src/PkPwaOfflineNotice.d.ts

@@ -0,0 +1,4 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const __VLS_export: DefineComponent<{}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist-vue/packages/components/src/chat/PkAgentSettingsPanel.d.ts

@@ -48,6 +48,13 @@ type __VLS_ModelProps = {
         origins?: string[];
     };
     'disabledTools'?: AgentBuiltInTool[];
+    /**
+         * Tools that ask the user to confirm before running
+         * (docs/specs/tool-approval-interface.md). Names are canonical tool-set
+         * keys, so built-ins go in verbatim; the MCP and API tool pages add their
+         * own prefixed entries to the same list.
+         */
+    'approvalTools'?: string[];
     'useAllUserKb'?: boolean;
     'useAllUserFiles'?: boolean;
     'formMaxSteps'?: AgentFormSettings['maxSteps'];
@@ -87,9 +94,9 @@ type __VLS_ModelProps = {
     };
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_589: {};
+declare var __VLS_592: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_589) => any;
+    default?: (props: typeof __VLS_592) => any;
 };
 declare const __VLS_base: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "update:reasoning": (value: {
@@ -262,6 +269,7 @@ declare const __VLS_base: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Com
         origins?: string[];
     }) => any;
     "update:disabledTools": (value: AgentBuiltInTool[]) => any;
+    "update:approvalTools": (value: string[]) => any;
     "update:useAllUserKb": (value: boolean) => any;
     "update:useAllUserFiles": (value: boolean) => any;
     "update:formMaxSteps": (value: number) => any;
@@ -470,6 +478,7 @@ declare const __VLS_base: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Com
         origins?: string[];
     }) => any) | undefined;
     "onUpdate:disabledTools"?: ((value: AgentBuiltInTool[]) => any) | undefined;
+    "onUpdate:approvalTools"?: ((value: string[]) => any) | undefined;
     "onUpdate:useAllUserKb"?: ((value: boolean) => any) | undefined;
     "onUpdate:useAllUserFiles"?: ((value: boolean) => any) | undefined;
     "onUpdate:formMaxSteps"?: ((value: number) => any) | undefined;

package/dist-vue/packages/components/src/chat/PkChatbotMessages.d.ts

@@ -20,6 +20,12 @@ type __VLS_Props = {
     showMessageDateTime?: boolean;
     showMessageTokensCount?: boolean;
     showAllMessageParts?: boolean;
+    /**
+     * Lets the user answer the tool requests rendered in the feed (approval
+     * and confirm cards). Off by default: the log viewers render the same
+     * messages read-only and have nothing to answer with.
+     */
+    interactive?: boolean;
     showExtendedSteps?: boolean;
     isDark?: boolean;
     /** Show a floating "back to bottom" button when the user scrolls up (fullscreen layout) */
@@ -34,7 +40,7 @@ declare var __VLS_25: {
     part: TextUIPart;
     index: number;
     isLoading: boolean;
-}, __VLS_60: `tool-${string}`, __VLS_61: {
+}, __VLS_73: `tool-${string}`, __VLS_74: {
     message: UIChatMessage;
     part: {
         type: `tool-${string}`;
@@ -43,7 +49,7 @@ declare var __VLS_25: {
     isLoading: boolean;
 };
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_60>]?: (props: typeof __VLS_61) => any;
+    [K in NonNullable<typeof __VLS_73>]?: (props: typeof __VLS_74) => any;
 } & {
     text?: (props: typeof __VLS_25) => any;
 };
@@ -60,6 +66,14 @@ declare const __VLS_base: DefineComponent<__VLS_Props, {}, {}, {}, {}, Component
     "scroll-down": () => any;
     "auto-retry": () => any;
     "reset-chat": () => any;
+    "approval-respond": (payload: {
+        id: string;
+        approved: boolean;
+    }) => any;
+    "confirm-respond": (payload: {
+        toolCallId: string;
+        confirmed: boolean;
+    }) => any;
 }, string, PublicProps, Readonly<__VLS_Props> & Readonly<{
     onUpvote?: ((message: UIChatMessage) => any) | undefined;
     onDownvote?: ((message: UIChatMessage) => any) | undefined;
@@ -73,6 +87,14 @@ declare const __VLS_base: DefineComponent<__VLS_Props, {}, {}, {}, {}, Component
     "onScroll-down"?: (() => any) | undefined;
     "onAuto-retry"?: (() => any) | undefined;
     "onReset-chat"?: (() => any) | undefined;
+    "onApproval-respond"?: ((payload: {
+        id: string;
+        approved: boolean;
+    }) => any) | undefined;
+    "onConfirm-respond"?: ((payload: {
+        toolCallId: string;
+        confirmed: boolean;
+    }) => any) | undefined;
 }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist-vue/packages/components/src/chat/PkToolApprovalBadge.d.ts

@@ -0,0 +1,4 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const __VLS_export: DefineComponent<{}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist-vue/packages/components/src/chat/PkToolApprovalCard.d.ts

@@ -0,0 +1,35 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/**
+ * The single confirmation card of the chat. It renders two things that are
+ * the same question for the user:
+ *
+ * - **approval**: a tool call the backend suspended waiting for consent
+ *   (`approval-requested`), plus its resolved states so the decision stays
+ *   visible in the transcript;
+ * - **confirm**: a `requestConfirm` call, the client-side tool the model uses
+ *   to have an action it described approved. Same layout, its own wording
+ *   (Proceed / Cancel, as on the messaging channels).
+ *
+ * The body comes from `toolApprovalPreviews[toolName]` when the tool has a
+ * dedicated preview (localized, human copy: e.g. `sendEmail` will reuse the
+ * email renderer); tools without one show only the localized prompt, never
+ * a raw echo of the call input. Adding a preview never requires touching
+ * this component.
+ */
+type __VLS_Props = {
+    part: unknown;
+    /**
+     * Whether the user can still answer. False in read-only views (chat
+     * logs) and, for approvals, once the conversation has moved past the
+     * request: the backend closes an abandoned approval as denied, so
+     * answering it later would not run the tool.
+     */
+    actionable?: boolean;
+};
+declare const __VLS_export: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    respond: (approved: boolean) => any;
+}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRespond?: ((approved: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist-vue/packages/components/src/chat/PkToolApprovalPreviewMessage.d.ts

@@ -0,0 +1,11 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/**
+ * Preview for the tools whose input is already a sentence written for the
+ * user (`requestConfirm`): it is shown as-is, with no key/value framing.
+ */
+type __VLS_Props = {
+    input?: unknown;
+};
+declare const __VLS_export: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist-vue/packages/components/src/chat/index.d.ts

@@ -28,6 +28,7 @@ import { default as PkMessageDetail } from './PkMessageDetail';
 import { default as PkStreamingMarkdown } from './PkStreamingMarkdown';
 import { default as PkToolShowForm } from './PkToolShowForm';
 import { default as PkToolShowArtifact } from './PkToolShowArtifact';
+import { default as PkToolApprovalBadge } from './PkToolApprovalBadge';
 import { default as PkToolShowEmail } from './PkToolShowEmail';
 import { default as PkToolShowMessage } from './PkToolShowMessage';
 import { default as PkToolShowWebPages } from './PkToolShowWebPages';
@@ -46,4 +47,4 @@ import { default as PkWebSearchSettings } from './PkWebSearchSettings';
 import { default as PkStreamingMarkdownAutoscroll } from './PkStreamingMarkdownAutoscroll';
 import { default as PkWelcomePopup } from './PkWelcomePopup';
 import { default as PkChatbotAuth } from './PkChatbotAuth';
-export { PkAgentSelectorInline, PkAgentSettingsPanel, PkAuroraCanvas, PkAvatar, PkChatSidebar, PkChatSidebarConversationItem, PkChatbot, PkChatbotEmptyState, PkChatbotError, PkChatbotFeedbackForm, PkChatbotFilePreview, PkChatbotInput, PkChatbotMessages, PkChatbotSteps, PkChatbotStepToolDetail, PkChatbotViewChat, PkChunkPreview, PkChatbotViewConversations, PkChatbotViewProfile, PkCode, PkCopyBlock, PkDocumentHeader, PkLanguageModel, PkLanguageModelCombobox, PkMessageParts, PkMessageDetail, PkStreamingMarkdown, PkStreamingMarkdownAutoscroll, PkToolShowForm, PkToolShowArtifact, PkToolShowEmail, PkToolShowMessage, PkToolShowWebPages, PkToolShowProductList, PkToolShowContactForm, PkToolShowCalendarEvent, PkToolShowComparison, PkToolShowLocation, PkToolShowQrCode, PkToolShowImageGallery, PkToolShowSuggestedReply, PkToolShowSources, PkRetryCountdown, PkReasoningChat, PkReasoningSettings, PkWebSearchSettings, PkWelcomePopup, PkChatbotAuth, };
+export { PkAgentSelectorInline, PkAgentSettingsPanel, PkAuroraCanvas, PkAvatar, PkChatSidebar, PkChatSidebarConversationItem, PkChatbot, PkChatbotEmptyState, PkChatbotError, PkChatbotFeedbackForm, PkChatbotFilePreview, PkChatbotInput, PkChatbotMessages, PkChatbotSteps, PkChatbotStepToolDetail, PkChatbotViewChat, PkChunkPreview, PkChatbotViewConversations, PkChatbotViewProfile, PkCode, PkCopyBlock, PkDocumentHeader, PkLanguageModel, PkLanguageModelCombobox, PkMessageParts, PkMessageDetail, PkStreamingMarkdown, PkStreamingMarkdownAutoscroll, PkToolShowForm, PkToolShowArtifact, PkToolApprovalBadge, PkToolShowEmail, PkToolShowMessage, PkToolShowWebPages, PkToolShowProductList, PkToolShowContactForm, PkToolShowCalendarEvent, PkToolShowComparison, PkToolShowLocation, PkToolShowQrCode, PkToolShowImageGallery, PkToolShowSuggestedReply, PkToolShowSources, PkRetryCountdown, PkReasoningChat, PkReasoningSettings, PkWebSearchSettings, PkWelcomePopup, PkChatbotAuth, };

package/dist-vue/packages/components/src/chat/toolApprovalPreviews.d.ts

@@ -0,0 +1,12 @@
+import { Component } from 'vue';
+/**
+ * Maps a tool name to the component that renders a human-readable preview of
+ * its input inside `PkToolApprovalCard`. The preview receives the tool call
+ * input as its `input` prop.
+ *
+ * Registering a preview needs no change to the card: tools with no entry here
+ * show only the localized confirmation prompt (no raw echo of the call input).
+ * Reuse the component that already renders that kind of payload when there is
+ * one (e.g. `sendEmail` will reuse `PkToolShowEmail`).
+ */
+export declare const toolApprovalPreviews: Record<string, Component>;

package/dist-vue/packages/components/src/chat/toolComponentMap.d.ts

@@ -2,8 +2,10 @@ import { defineAsyncComponent } from 'vue';
 /**
  * Maps tool `part.type` to the corresponding component for auto-rendering.
  * Only includes simple tools that accept only a `:part` prop.
- * Interactive tools (requestConfirm, showContactForm, showSuggestedReply,
- * showSources, showMultipleChoice) must be wired explicitly in the parent
- * with their required callbacks/events.
+ * Interactive tools (showContactForm, showSuggestedReply, showSources,
+ * showMultipleChoice) must be wired explicitly in the parent with their
+ * required callbacks/events. Consent requests (`requestConfirm` and the tool
+ * calls suspended for approval) are not here either: `PkChatbotMessages`
+ * renders them all with `PkToolApprovalCard`.
  */
 export declare const toolComponentMap: Record<string, ReturnType<typeof defineAsyncComponent>>;

package/dist-vue/packages/components/src/chat/useChatScroll.d.ts

@@ -10,6 +10,12 @@ interface UseChatScrollOptions {
      * child.
      */
     contentEl?: () => HTMLElement | null;
+    /**
+     * Awaited right before the new-exchange scroll. Lets the host apply the
+     * layout that changes the content height (the anchor spacer) first, so
+     * the scroll targets the final bottom instead of an intermediate one.
+     */
+    beforeNewMessageScroll?: () => void | Promise<void>;
     onScrollUp?: () => void;
     onScrollDown?: () => void;
 }

package/dist-vue/packages/components/src/chat/utils.d.ts

@@ -10,6 +10,19 @@ export declare function mergeConsecutiveTextParts(parts: UIMessage['parts']): UI
 export declare function isStreamingPart(part: UIMessage['parts'][number] | null | undefined): part is Extract<UIMessage['parts'][number], {
     streaming?: boolean;
 }>;
+export declare function isToolApprovalPart(part: UIMessage['parts'][number] | null | undefined): boolean;
+/**
+ * The client-side tool the model uses to have an action it described approved.
+ * It predates the SDK's approval gate and keeps its own round-trip (it resolves
+ * through `addToolOutput`), but it asks the user the very same question, so it
+ * shares `PkToolApprovalCard` instead of having a card of its own.
+ */
+export declare const CONFIRM_TOOL_NAME = "requestConfirm";
+export declare function isToolConfirmPart(part: UIMessage['parts'][number] | null | undefined): boolean;
+/** True for any part the confirmation card is responsible for. */
+export declare function isConfirmationCardPart(part: UIMessage['parts'][number] | null | undefined): boolean;
+/** The id of the pending approval request on a tool part, if any. */
+export declare function getToolApprovalId(part: UIMessage['parts'][number] | null | undefined): string | undefined;
 export declare function getPartState(part: UIMessage['parts'][number] | null | undefined): string | undefined;
 export declare function isLoadingState(state?: string): boolean;
 export declare function getContrast(hexcolor?: string): 'black' | 'white';

package/dist-vue/packages/components/src/index.d.ts

@@ -11,6 +11,7 @@ import { default as PkEditorRadioButtons } from './PkEditorRadioButtons';
 import { default as PkEditorCheckboxButtons } from './PkEditorCheckboxButtons';
 import { default as PkEditorRepeater } from './PkEditorRepeater';
 import { default as PkEditorWyswyg } from './PkEditorWyswyg';
+import { default as PkCheckboxField } from './PkCheckboxField';
 import { default as PkFieldset } from './PkFieldset';
 import { default as PkInfobox } from './PkInfobox';
 import { default as PkSchemaField } from './PkSchemaField';
@@ -19,6 +20,8 @@ import { default as PkLazyImg } from './PkLazyImg';
 import { default as PkLightbox } from './PkLightbox';
 import { default as PkLoader } from './PkLoader';
 import { default as PkMedia } from './PkMedia';
+import { default as PkPwaInstallPrompt } from './PkPwaInstallPrompt';
+import { default as PkPwaOfflineNotice } from './PkPwaOfflineNotice';
 import { default as PkRelativeTime } from './PkRelativeTime';
 import { default as PkSkeleton } from './PkSkeleton';
 import { default as PkSvgViewer } from './PkSvgViewer';
@@ -27,4 +30,4 @@ export * from './chat';
 export * from './input';
 export * from './table';
 export * from './types';
-export { PkBadge, PkEditorAgentType, PkEditorDocumentType, PkEditorNotificationType, PkEditorCode, PkEditorJsonSchema, PkEditorMarkdown, PkEditorMedia, PkEditorPrompt, PkEditorRadioButtons, PkEditorCheckboxButtons, PkEditorRepeater, PkEditorWyswyg, PkFieldset, PkInfobox, PkSchemaField, PkIntegrationProvider, PkLazyImg, PkLightbox, PkLoader, PkMedia, PkRelativeTime, PkSkeleton, PkSvgViewer, PkUrl, };
+export { PkBadge, PkEditorAgentType, PkEditorDocumentType, PkEditorNotificationType, PkEditorCode, PkEditorJsonSchema, PkEditorMarkdown, PkEditorMedia, PkEditorPrompt, PkEditorRadioButtons, PkEditorCheckboxButtons, PkEditorRepeater, PkEditorWyswyg, PkCheckboxField, PkFieldset, PkInfobox, PkSchemaField, PkIntegrationProvider, PkLazyImg, PkLightbox, PkLoader, PkMedia, PkPwaInstallPrompt, PkPwaOfflineNotice, PkRelativeTime, PkSkeleton, PkSvgViewer, PkUrl, };

package/dist-vue/packages/composable/src/chatbot/useChatbotStore.d.ts

@@ -349,6 +349,9 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         userFiles: {
             useAllUserFiles: boolean;
         };
+        approval: {
+            tools: string[];
+        };
     } | undefined, {
         disabled: AgentBuiltInTool[];
         showForm: {
@@ -406,6 +409,9 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         userFiles: {
             useAllUserFiles: boolean;
         };
+        approval: {
+            tools: string[];
+        };
     } | undefined>;
     headers: globalThis.Ref<Record<string, string> | undefined, Record<string, string> | undefined>;
     revisedAnswers: globalThis.Ref<{
@@ -1512,6 +1518,11 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         toolCallId: string;
         output: unknown;
     }) => void;
+    addToolApprovalResponse: (params: {
+        id: string;
+        approved: boolean;
+        reason?: string;
+    }) => void;
     handleFileSelect: (file: File) => Promise<void>;
     clearFileLimitError: () => void;
     clearPendingAttachments: (revokeAll?: boolean) => void;
@@ -1864,6 +1875,9 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         userFiles: {
             useAllUserFiles: boolean;
         };
+        approval: {
+            tools: string[];
+        };
     } | undefined, {
         disabled: AgentBuiltInTool[];
         showForm: {
@@ -1921,6 +1935,9 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         userFiles: {
             useAllUserFiles: boolean;
         };
+        approval: {
+            tools: string[];
+        };
     } | undefined>;
     headers: globalThis.Ref<Record<string, string> | undefined, Record<string, string> | undefined>;
     revisedAnswers: globalThis.Ref<{
@@ -3027,6 +3044,11 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         toolCallId: string;
         output: unknown;
     }) => void;
+    addToolApprovalResponse: (params: {
+        id: string;
+        approved: boolean;
+        reason?: string;
+    }) => void;
     handleFileSelect: (file: File) => Promise<void>;
     clearFileLimitError: () => void;
     clearPendingAttachments: (revokeAll?: boolean) => void;
@@ -3379,6 +3401,9 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         userFiles: {
             useAllUserFiles: boolean;
         };
+        approval: {
+            tools: string[];
+        };
     } | undefined, {
         disabled: AgentBuiltInTool[];
         showForm: {
@@ -3436,6 +3461,9 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         userFiles: {
             useAllUserFiles: boolean;
         };
+        approval: {
+            tools: string[];
+        };
     } | undefined>;
     headers: globalThis.Ref<Record<string, string> | undefined, Record<string, string> | undefined>;
     revisedAnswers: globalThis.Ref<{
@@ -4542,6 +4570,11 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
         toolCallId: string;
         output: unknown;
     }) => void;
+    addToolApprovalResponse: (params: {
+        id: string;
+        approved: boolean;
+        reason?: string;
+    }) => void;
     handleFileSelect: (file: File) => Promise<void>;
     clearFileLimitError: () => void;
     clearPendingAttachments: (revokeAll?: boolean) => void;
@@ -4553,4 +4586,4 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
     navigate: (view: ChatbotView) => void;
     renameChatTitle: (chatId: string, title: string) => Promise<void>;
     deleteChat: (chatId: string) => Promise<void>;
-}, "regenerate" | "initialize" | "loadConversations" | "loadChatFiles" | "getChatFileUrl" | "getChatFilePreviewUrl" | "deleteChatFile" | "handleSubmit" | "sendMessage" | "stopGeneration" | "startNewChat" | "addToolOutput" | "handleFileSelect" | "clearFileLimitError" | "clearPendingAttachments" | "onUpvote" | "onDownvote" | "onFeedback" | "onFeedbackSubmit" | "onLeadSubmit" | "navigate" | "renameChatTitle" | "deleteChat">>;
+}, "regenerate" | "initialize" | "loadConversations" | "loadChatFiles" | "getChatFileUrl" | "getChatFilePreviewUrl" | "deleteChatFile" | "handleSubmit" | "sendMessage" | "stopGeneration" | "startNewChat" | "addToolOutput" | "addToolApprovalResponse" | "handleFileSelect" | "clearFileLimitError" | "clearPendingAttachments" | "onUpvote" | "onDownvote" | "onFeedback" | "onFeedbackSubmit" | "onLeadSubmit" | "navigate" | "renameChatTitle" | "deleteChat">>;

package/dist-vue/packages/models/src/schema/Agent.d.ts

@@ -176,6 +176,28 @@ export declare enum AgentBuiltInTool {
     ShowWebPages = "showWebPages",
     ShowMultipleChoice = "showMultipleChoice"
 }
+/**
+ * Prefixes the runtime tool set uses for the tools an agent configures. They are
+ * part of a contract shared by three places: the services that build the tool
+ * set, the approval list that matches names against it, and the backoffice UI
+ * that writes those names. A mismatch is silent (a name matching no tool simply
+ * never gates anything), so the prefixes live here and nowhere else.
+ */
+export declare const MCP_TOOL_PREFIX = "mcp-";
+export declare const API_TOOL_PREFIX = "api-";
+/** Tool-set key of an MCP tool, from the name the server advertises. */
+export declare const mcpToolKey: (toolName: string) => string;
+/** Tool-set key of an agent API tool, from its configured name. */
+export declare const apiToolKey: (toolName: string) => string;
+/**
+ * Returns true if the tool can be put behind the user-approval gate
+ * (`settings.tools.approval.tools`, see docs/specs/tool-approval-interface.md).
+ *
+ * Only tools that run server-side qualify: a presentation tool has nothing to
+ * approve, and a client-resolved one (geolocation, OAuth connect) already asks
+ * the user by construction, since it is the browser or the user who answers it.
+ */
+export declare function canRequireApproval(toolName: string): boolean;
 /**
  * Returns true if the tool renders a UI element (card, form, list, etc.).
  * Used in `prepareStep` to prevent duplicate UI elements across streaming steps.
@@ -317,6 +339,20 @@ export declare const AgentUserFilesSchema: z.ZodObject<{
     useAllUserFiles: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type AgentUserFiles = z.infer<typeof AgentUserFilesSchema>;
+/**
+ * Human-in-the-loop approval settings. Lists the tools whose calls must be
+ * approved by the user before they execute. Names are matched against the tool
+ * set of the turn, so any tool can be listed: built-in (`sendEmail`), API tools
+ * (`api-<name>`) and MCP tools (`mcp-<server>_<tool>`).
+ *
+ * The gate is UX, not security: it only suspends execution on interactive
+ * channels. On non-interactive ones (messaging platforms, API, scheduled runs)
+ * a listed tool is denied instead of hanging forever, see `toolApproval.ts`.
+ */
+export declare const AgentToolApprovalSchema: z.ZodObject<{
+    tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type AgentToolApproval = z.infer<typeof AgentToolApprovalSchema>;
 export declare const AgentToolsSchema: z.ZodObject<{
     disabled: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof AgentBuiltInTool>>>;
     showForm: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -382,6 +418,9 @@ export declare const AgentToolsSchema: z.ZodObject<{
     userFiles: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         useAllUserFiles: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>>;
+    approval: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type AgentTools = z.infer<typeof AgentToolsSchema>;
 /**
@@ -908,6 +947,9 @@ export declare const AgentSettingsSchema: z.ZodObject<{
         userFiles: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             useAllUserFiles: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>>;
+        approval: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     fileUpload: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1213,6 +1255,9 @@ export declare const AgentDtoSchema: z.ZodObject<{
             userFiles: z.ZodDefault<z.ZodOptional<z.ZodObject<{
                 useAllUserFiles: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>>;
+            approval: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>>;
         fileUpload: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1519,6 +1564,9 @@ export declare const AgentSchema: z.ZodLazy<z.ZodObject<{
             userFiles: z.ZodDefault<z.ZodOptional<z.ZodObject<{
                 useAllUserFiles: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>>;
+            approval: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>>;
         fileUpload: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;

package/dist-vue/packages/models/src/schema/ReasoningChat.d.ts

@@ -295,6 +295,9 @@ export declare const ReasoningChatSchema: z.ZodObject<{
                 userFiles: z.ZodDefault<z.ZodOptional<z.ZodObject<{
                     useAllUserFiles: z.ZodDefault<z.ZodBoolean>;
                 }, z.core.$strip>>>;
+                approval: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                    tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>>;
             fileUpload: z.ZodDefault<z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;
@@ -652,6 +655,9 @@ export declare const ReasoningChatSchema: z.ZodObject<{
                     userFiles: z.ZodDefault<z.ZodOptional<z.ZodObject<{
                         useAllUserFiles: z.ZodDefault<z.ZodBoolean>;
                     }, z.core.$strip>>>;
+                    approval: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                        tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>>;
                 }, z.core.$strip>>>;
                 fileUpload: z.ZodDefault<z.ZodOptional<z.ZodObject<{
                     enabled: z.ZodDefault<z.ZodBoolean>;