@webless/agent 0.6.11 → 0.7.0

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { d as AgentIndexVersion, i as AgentPlacementConfig, c as AgentColorScheme, b as AgentBrandingConfig, P as VisitorToolResultRegistry, k as AgentRailState, l as AgentRailTheme, g as AgentInputResponse, x as AgentToolUiSurface, r as AgentToolResultJsonValue, F as FollowUpSuggestion, D as ConversationMessage, j as AgentRailPhase, V as VisitorBooking } from './manifest-Ulpp3ffe.js';
-export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, e as AgentInputOption, f as AgentInputRequest, m as AgentStructuredToolInput, q as AgentToolResult, s as AgentToolUiAction, t as AgentToolUiField, u as AgentToolUiFieldKind, v as AgentToolUiOption, w as AgentToolUiStep, y as AssistEdgeTab, z as AssistTabSide, B as AssistTabVariant, C as Citation, E as DEFAULT_AGENT_PLACEMENT, J as JourneyContext, R as ResolvedVisitorToolResultPresentation, T as ToolStep, G as ToolStepState, H as VisitorBookingResultPresentation, I as VisitorToolInputResultPresentation, K as VisitorToolResultLink, L as VisitorToolResultPresentation, M as VisitorToolResultPresenter, O as VisitorToolResultPresenterOutput, Q as builtInVisitorToolResultRegistry, S as defaultAgentRailTheme, U as defaultDarkAgentRailTheme, W as formatAgentStructuredToolInput, X as normalizeAgentPlacement, Z as presentVisitorToolResult } from './manifest-Ulpp3ffe.js';
+import { e as AgentIndexVersion, k as AgentPlacementConfig, d as AgentColorScheme, c as AgentBrandingConfig, b as AgentAnalyticsConfig, S as VisitorToolResultRegistry, i as AgentMessageFeedback, T as ToolStep, m as AgentRailState, n as AgentRailTheme, F as ConversationMessage, h as AgentInputResponse, z as AgentToolUiSurface, t as AgentToolResultJsonValue, H as FollowUpSuggestion, l as AgentRailPhase, V as VisitorBooking } from './manifest-BNJQfEow.js';
+export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, f as AgentInputOption, g as AgentInputRequest, o as AgentStructuredToolInput, s as AgentToolResult, u as AgentToolUiAction, v as AgentToolUiField, w as AgentToolUiFieldKind, x as AgentToolUiOption, y as AgentToolUiStep, B as AssistEdgeTab, C as AssistTabSide, D as AssistTabVariant, E as Citation, G as DEFAULT_AGENT_PLACEMENT, J as JourneyContext, R as ResolvedVisitorToolResultPresentation, I as ToolStepState, K as VisitorBookingResultPresentation, L as VisitorToolInputResultPresentation, M as VisitorToolResultLink, O as VisitorToolResultPresentation, P as VisitorToolResultPresenter, Q as VisitorToolResultPresenterOutput, U as builtInVisitorToolResultRegistry, W as defaultAgentRailTheme, X as defaultDarkAgentRailTheme, Y as formatAgentStructuredToolInput, Z as normalizeAgentPlacement, $ as presentVisitorToolResult } from './manifest-BNJQfEow.js';
 
 type AgentWidgetProps = {
     indexId: string;
@@ -15,9 +15,23 @@ type AgentWidgetProps = {
     registerPanelController?: boolean;
     colorScheme?: AgentColorScheme;
     branding?: AgentBrandingConfig;
+    analytics?: AgentAnalyticsConfig;
     toolResultRegistry?: VisitorToolResultRegistry;
 };
-declare function AgentWidget({ indexId, customerId, getUnpublishedPreviewGrant, previewBuildId, version, runtimeOrigin, placement: placementInput, defaultCollapsed, pageShift, registerPanelController, colorScheme, branding, toolResultRegistry, }: AgentWidgetProps): react.JSX.Element;
+declare function AgentWidget({ indexId, customerId, getUnpublishedPreviewGrant, previewBuildId, version, runtimeOrigin, placement: placementInput, defaultCollapsed, pageShift, registerPanelController, colorScheme, branding, analytics, toolResultRegistry, }: AgentWidgetProps): react.JSX.Element;
+
+declare function MessageActions({ answeredAt, copyText, disabled, onOpenReceipt, onRegenerate, onFeedback, readAloud, receiptSteps, speechText, }: {
+    answeredAt?: number;
+    copyText: string;
+    disabled?: boolean;
+    onOpenReceipt?: () => void;
+    onRegenerate?: () => void;
+    onFeedback?: (rating: AgentMessageFeedback) => void;
+    readAloud?: boolean;
+    receiptBrandLabel?: string;
+    receiptSteps?: ToolStep[];
+    speechText?: string;
+}): react.JSX.Element;
 
 type AgentRailProps = {
     state: AgentRailState;
@@ -26,6 +40,9 @@ type AgentRailProps = {
     brandLabel?: string;
     brandLogoUrl?: string;
     poweredByLabel?: string;
+    disclaimerLabel?: string | null | undefined;
+    answerReceipt?: boolean;
+    readAloud?: boolean;
     composerPlaceholder?: string;
     mobileFullscreen?: boolean;
     expanded?: boolean;
@@ -34,6 +51,8 @@ type AgentRailProps = {
     onExpandToggle?: () => void;
     onReset?: () => void;
     onRetry?: () => void;
+    onRegenerate?: () => void;
+    onFeedback?: (rating: AgentMessageFeedback, message: ConversationMessage) => void;
     onSubmit?: (message: string) => void;
     onFollowUpSelect?: (label: string) => void;
     onBook?: (input: {
@@ -43,7 +62,7 @@ type AgentRailProps = {
     onInputResponse?: (response: AgentInputResponse) => void;
     onToolInput?: (surface: AgentToolUiSurface, values: Record<string, AgentToolResultJsonValue>) => void;
 };
-declare function AgentRail({ state, theme, colorScheme, brandLabel, brandLogoUrl, poweredByLabel, composerPlaceholder, mobileFullscreen, expanded, onCollapse, onClose, onExpandToggle, onReset, onRetry, onSubmit, onFollowUpSelect, onBook, onInputResponse, onToolInput, }: AgentRailProps): react.JSX.Element;
+declare function AgentRail({ state, theme, colorScheme, brandLabel, brandLogoUrl, poweredByLabel, disclaimerLabel, answerReceipt, readAloud, composerPlaceholder, mobileFullscreen, expanded, onCollapse, onClose, onExpandToggle, onReset, onRetry, onRegenerate, onFeedback, onSubmit, onFollowUpSelect, onBook, onInputResponse, onToolInput, }: AgentRailProps): react.JSX.Element;
 
 type UseAgentChatOptions = {
     customerId?: string;
@@ -65,6 +84,7 @@ declare function useAgentChat({ customerId, getUnpublishedPreviewGrant, indexId,
     state: AgentRailState;
     reset: () => void;
     retry: () => Promise<void>;
+    regenerate: () => Promise<string | null>;
     respondToInput: (response: AgentInputResponse) => Promise<void>;
     respondToToolInput: (surface: AgentToolUiSurface, values: Record<string, AgentToolResultJsonValue>) => Promise<void>;
     submit: (visitorText: string, options?: AgentChatSubmitOptions) => Promise<string | null>;
@@ -77,4 +97,41 @@ declare function hasVisitorMessages(messages: ConversationMessage[]): boolean;
 declare function createIdleSuggestions(): FollowUpSuggestion[];
 declare function isAgentBusy(phase: AgentRailPhase): phase is "thinking" | "running-tools" | "streaming";
 
-export { AgentColorScheme, AgentInputResponse, AgentPlacementConfig, AgentRail, AgentRailPhase, type AgentRailProps, AgentRailState, AgentRailTheme, AgentToolUiSurface, AgentWidget, type AgentWidgetProps, ConversationMessage, FollowUpSuggestion, type UseAgentChatOptions, VisitorToolResultRegistry, createIdleSuggestions, hasVisitorMessages, isAgentBusy, useAgentChat };
+declare const AGENT_ANSWER_FEEDBACK_EVENT_TYPE = "agent_answer_feedback";
+/** The visitor question that produced the rated agent answer. */
+declare function findPrecedingVisitorText(messages: readonly ConversationMessage[], agentMessageId: string): string | undefined;
+declare function buildAgentAnswerFeedbackEvent(input: {
+    agentSessionId?: string | undefined;
+    analytics: AgentAnalyticsConfig;
+    answer?: string | undefined;
+    indexId: string;
+    messageId: string;
+    page: string;
+    query?: string | undefined;
+    rating: AgentMessageFeedback;
+    version: AgentIndexVersion;
+    visitorSessionId: string;
+}): {
+    readonly answer?: string | undefined;
+    readonly query?: string | undefined;
+    readonly agent_session_id?: string | undefined;
+    readonly event_type: "agent_answer_feedback";
+    readonly company: string;
+    readonly session_id: string;
+    readonly page: string;
+    readonly timestamp: number;
+    readonly tracking_consent: boolean;
+    readonly feedback_value: 1 | -1;
+    readonly feedback_rating: "helpful" | "not_helpful";
+    readonly surface: "agent_panel";
+    readonly index_id: string;
+    readonly index_version: AgentIndexVersion;
+    readonly message_id: string;
+};
+/**
+ * Fire-and-forget analytics POST. Analytics must never break the widget, so
+ * every failure is swallowed.
+ */
+declare function sendAgentAnswerFeedback(eventUrl: string, event: Record<string, unknown>): void;
+
+export { AGENT_ANSWER_FEEDBACK_EVENT_TYPE, AgentColorScheme, AgentInputResponse, AgentMessageFeedback, AgentPlacementConfig, AgentRail, AgentRailPhase, type AgentRailProps, AgentRailState, AgentRailTheme, AgentToolUiSurface, AgentWidget, type AgentWidgetProps, ConversationMessage, FollowUpSuggestion, MessageActions, ToolStep, type UseAgentChatOptions, VisitorToolResultRegistry, buildAgentAnswerFeedbackEvent, createIdleSuggestions, findPrecedingVisitorText, hasVisitorMessages, isAgentBusy, sendAgentAnswerFeedback, useAgentChat };

package/dist/react.js

@@ -1,38 +1,48 @@
 import "./react.css";
 import {
+  AGENT_ANSWER_FEEDBACK_EVENT_TYPE,
   AGENT_STRUCTURED_TOOL_INPUT_HEADER,
   AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION,
   AgentRail,
   AgentWidget,
   AssistEdgeTab,
   DEFAULT_AGENT_PLACEMENT,
+  MessageActions,
+  buildAgentAnswerFeedbackEvent,
   builtInVisitorToolResultRegistry,
   createIdleSuggestions,
   defaultAgentRailTheme,
   defaultDarkAgentRailTheme,
+  findPrecedingVisitorText,
   formatAgentStructuredToolInput,
   hasVisitorMessages,
   isAgentBusy,
   normalizeAgentPlacement,
   presentVisitorToolResult,
+  sendAgentAnswerFeedback,
   useAgentChat
-} from "./chunk-YNF2UPGJ.js";
+} from "./chunk-CYI3OSWG.js";
 export {
+  AGENT_ANSWER_FEEDBACK_EVENT_TYPE,
   AGENT_STRUCTURED_TOOL_INPUT_HEADER,
   AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION,
   AgentRail,
   AgentWidget,
   AssistEdgeTab,
   DEFAULT_AGENT_PLACEMENT,
+  MessageActions,
+  buildAgentAnswerFeedbackEvent,
   builtInVisitorToolResultRegistry,
   createIdleSuggestions,
   defaultAgentRailTheme,
   defaultDarkAgentRailTheme,
+  findPrecedingVisitorText,
   formatAgentStructuredToolInput,
   hasVisitorMessages,
   isAgentBusy,
   normalizeAgentPlacement,
   presentVisitorToolResult,
+  sendAgentAnswerFeedback,
   useAgentChat
 };
 //# sourceMappingURL=react.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webless/agent",
-  "version": "0.6.11",
+  "version": "0.7.0",
   "description": "Webless Agent SDK — Eve runtime client, React UI, and embed bundle.",
   "type": "module",
   "license": "MIT",