@webless/agent 0.10.4 → 0.12.0

package/dist/{panel-controller-rxR75tRa.d.cts → panel-controller-CYoivbYB.d.cts}

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import * as react from 'react';
 
 declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
@@ -66,7 +67,134 @@ type AgentToolResultEnvelope = {
     ui?: AgentToolUiSurface;
 };
 
+declare const agentRuntimeHandoffEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"status">;
+    status: z.ZodEnum<{
+        ai: "ai";
+        requesting: "requesting";
+        queued: "queued";
+        human: "human";
+        resolved: "resolved";
+        failed: "failed";
+    }>;
+    actor: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    handoffId: z.ZodString;
+    epoch: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"visitor.message">;
+    message: z.ZodString;
+    operationId: z.ZodString;
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    handoffId: z.ZodString;
+    epoch: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"human.message">;
+    message: z.ZodString;
+    actor: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>;
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    handoffId: z.ZodString;
+    epoch: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>], "type">;
+declare const agentRuntimeHandoffPageSchema: z.ZodObject<{
+    apiVersion: z.ZodLiteral<"webless.ai/agent-runtime-handoff/v1">;
+    sessionId: z.ZodString;
+    enabled: z.ZodBoolean;
+    status: z.ZodEnum<{
+        ai: "ai";
+        requesting: "requesting";
+        queued: "queued";
+        human: "human";
+        resolved: "resolved";
+        failed: "failed";
+    }>;
+    handoffId: z.ZodNullable<z.ZodString>;
+    epoch: z.ZodNumber;
+    after: z.ZodNumber;
+    cursor: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"status">;
+        status: z.ZodEnum<{
+            ai: "ai";
+            requesting: "requesting";
+            queued: "queued";
+            human: "human";
+            resolved: "resolved";
+            failed: "failed";
+        }>;
+        actor: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        handoffId: z.ZodString;
+        epoch: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"visitor.message">;
+        message: z.ZodString;
+        operationId: z.ZodString;
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        handoffId: z.ZodString;
+        epoch: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"human.message">;
+        message: z.ZodString;
+        actor: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>;
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        handoffId: z.ZodString;
+        epoch: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>;
+type AgentRuntimeHandoffEvent = z.infer<typeof agentRuntimeHandoffEventSchema>;
+type AgentRuntimeHandoffPage = z.infer<typeof agentRuntimeHandoffPageSchema>;
+
+type AgentHandoffCommand = {
+    operationId: string;
+    handoffId: string;
+    epoch: number;
+};
+type AgentHandoffClient = {
+    read(options?: {
+        after?: number;
+        signal?: AbortSignal;
+    }): Promise<AgentRuntimeHandoffPage>;
+    start(operationId: string, signal?: AbortSignal): Promise<void>;
+    send(command: AgentHandoffCommand & {
+        message: string;
+    }, signal?: AbortSignal): Promise<void>;
+    returnToAI(command: AgentHandoffCommand, signal?: AbortSignal): Promise<void>;
+};
+
 type AgentIndexVersion = "published" | "unpublished";
+type AgentWorkItem = {
+    id: string;
+    kind: "planning" | "search" | "specialist" | "tool";
+    label: string;
+    state: "completed" | "active" | "pending" | "error";
+    detail?: string;
+};
 type AgentInputOption = {
     id: string;
     label: string;
@@ -103,6 +231,41 @@ type AgentToolResult = {
         message: string;
     };
 };
+type AgentStreamHandlers = {
+    onWork?: (item: AgentWorkItem) => void;
+    /** @deprecated Use onWork for semantic progress events. */
+    onStep?: (label: string, detail?: string) => void;
+    onDelta: (delta: string) => void;
+    onComplete?: () => void;
+    onActionResult?: (output: unknown) => void;
+    onToolResult?: (result: AgentToolResult) => void;
+    onInputRequest?: (requests: readonly AgentInputRequest[]) => void;
+};
+type AgentSendTurnOptions = {
+    signal?: AbortSignal;
+    handlers: AgentStreamHandlers;
+};
+type AgentResumeTurnOptions = AgentSendTurnOptions & {
+    initialText?: string;
+    message: string;
+};
+type AgentRespondTurnOptions = AgentSendTurnOptions & {
+    responses: readonly AgentInputResponse[];
+};
+type AgentClient = {
+    readonly handoff: AgentHandoffClient;
+    readonly indexId: string;
+    readonly version: AgentIndexVersion;
+    readonly runtimeOrigin: string;
+    readonly visitorSessionId: string;
+    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    regenerateTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    resumeTurn: (options: AgentResumeTurnOptions) => Promise<string | null>;
+    respondTurn: (options: AgentRespondTurnOptions) => Promise<string>;
+    reset: () => void;
+    cancelActive: () => void;
+    getActiveSessionId: () => string | undefined;
+};
 
 type ComposerFormFieldKind = "text" | "email" | "tel" | "textarea";
 type ComposerFormField = {
@@ -285,6 +448,15 @@ type JourneyContext = {
     stepLabel?: string;
 };
 type ConversationMessage = {
+    id: string;
+    role: "human";
+    text: string;
+    createdAt: number;
+    representative: {
+        id: string;
+        name: string;
+    };
+} | {
     id: string;
     role: "visitor";
     text: string;
@@ -443,4 +615,4 @@ type AgentPanelSubmitOptions = {
 declare function resetAgentPanel(customerId: string): void;
 declare function submitAgentPanel(customerId: string, message: string, options?: AgentPanelSubmitOptions): Promise<string | null>;
 
-export { defaultDarkAgentRailTheme as $, AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, type AgentToolUiOption as B, type AgentToolUiStep as C, type AgentToolUiSurface as D, AssistEdgeTab as E, type AssistTabSide as F, type AssistTabVariant as G, type Citation as H, type ConversationMessage as I, DEFAULT_AGENT_PLACEMENT as J, type FollowUpSuggestion as K, type JourneyContext as L, type ToolStepState as M, type NormalizedAgentTagManifest as N, type VisitorBookingResultPresentation as O, type VisitorSearchResultPresentation as P, type VisitorToolInputResultPresentation as Q, type ResolvedVisitorToolResultPresentation as R, type VisitorToolResultLink as S, type ToolStep as T, type VisitorToolResultPresentation as U, type VisitorBooking as V, type VisitorToolResultPresenter as W, type VisitorToolResultPresenterOutput as X, type VisitorToolResultRegistry as Y, builtInVisitorToolResultRegistry as Z, defaultAgentRailTheme as _, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, formatAgentStructuredToolInput as a0, normalizeAgentPlacement as a1, normalizeAgentTagManifest as a2, presentVisitorToolResult as a3, resetAgentPanel as a4, submitAgentPanel as a5, type AgentAnalyticsConfig as b, type AgentBrandingConfig as c, type AgentColorScheme as d, type AgentIndexVersion as e, type AgentInputOption as f, type AgentInputRequest as g, type AgentInputResponse as h, type AgentMessageFeedback as i, type AgentMountStrategy as j, type AgentPanelSubmitOptions as k, type AgentPlacementConfig as l, type AgentRailPhase as m, type AgentRailState as n, type AgentRailTheme as o, type AgentSearchReferences as p, type AgentSearchSource as q, type AgentStructuredToolInput as r, type AgentTabSide as s, type AgentTabVariant as t, type AgentTagManifest as u, type AgentToolResult as v, type AgentToolResultJsonValue as w, type AgentToolUiAction as x, type AgentToolUiField as y, type AgentToolUiFieldKind as z };
+export { builtInVisitorToolResultRegistry as $, AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, type AgentToolUiField as B, type AgentToolUiFieldKind as C, type AgentToolUiOption as D, type AgentToolUiStep as E, type AgentToolUiSurface as F, AssistEdgeTab as G, type AssistTabSide as H, type AssistTabVariant as I, type Citation as J, type ConversationMessage as K, DEFAULT_AGENT_PLACEMENT as L, type FollowUpSuggestion as M, type JourneyContext as N, type NormalizedAgentTagManifest as O, type ToolStepState as P, type VisitorBookingResultPresentation as Q, type ResolvedVisitorToolResultPresentation as R, type VisitorSearchResultPresentation as S, type ToolStep as T, type VisitorToolInputResultPresentation as U, type VisitorBooking as V, type VisitorToolResultLink as W, type VisitorToolResultPresentation as X, type VisitorToolResultPresenter as Y, type VisitorToolResultPresenterOutput as Z, type VisitorToolResultRegistry as _, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, defaultAgentRailTheme as a0, defaultDarkAgentRailTheme as a1, formatAgentStructuredToolInput as a2, normalizeAgentPlacement as a3, normalizeAgentTagManifest as a4, presentVisitorToolResult as a5, resetAgentPanel as a6, submitAgentPanel as a7, type AgentAnalyticsConfig as b, type AgentBrandingConfig as c, type AgentClient as d, type AgentColorScheme as e, type AgentIndexVersion as f, type AgentInputOption as g, type AgentInputRequest as h, type AgentInputResponse as i, type AgentMessageFeedback as j, type AgentMountStrategy as k, type AgentPanelSubmitOptions as l, type AgentPlacementConfig as m, type AgentRailPhase as n, type AgentRailState as o, type AgentRailTheme as p, type AgentRuntimeHandoffEvent as q, type AgentSearchReferences as r, type AgentSearchSource as s, type AgentStructuredToolInput as t, type AgentTabSide as u, type AgentTabVariant as v, type AgentTagManifest as w, type AgentToolResult as x, type AgentToolResultJsonValue as y, type AgentToolUiAction as z };

package/dist/{panel-controller-rxR75tRa.d.ts → panel-controller-CYoivbYB.d.ts}

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import * as react from 'react';
 
 declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
@@ -66,7 +67,134 @@ type AgentToolResultEnvelope = {
     ui?: AgentToolUiSurface;
 };
 
+declare const agentRuntimeHandoffEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"status">;
+    status: z.ZodEnum<{
+        ai: "ai";
+        requesting: "requesting";
+        queued: "queued";
+        human: "human";
+        resolved: "resolved";
+        failed: "failed";
+    }>;
+    actor: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    handoffId: z.ZodString;
+    epoch: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"visitor.message">;
+    message: z.ZodString;
+    operationId: z.ZodString;
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    handoffId: z.ZodString;
+    epoch: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"human.message">;
+    message: z.ZodString;
+    actor: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>;
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    handoffId: z.ZodString;
+    epoch: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>], "type">;
+declare const agentRuntimeHandoffPageSchema: z.ZodObject<{
+    apiVersion: z.ZodLiteral<"webless.ai/agent-runtime-handoff/v1">;
+    sessionId: z.ZodString;
+    enabled: z.ZodBoolean;
+    status: z.ZodEnum<{
+        ai: "ai";
+        requesting: "requesting";
+        queued: "queued";
+        human: "human";
+        resolved: "resolved";
+        failed: "failed";
+    }>;
+    handoffId: z.ZodNullable<z.ZodString>;
+    epoch: z.ZodNumber;
+    after: z.ZodNumber;
+    cursor: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"status">;
+        status: z.ZodEnum<{
+            ai: "ai";
+            requesting: "requesting";
+            queued: "queued";
+            human: "human";
+            resolved: "resolved";
+            failed: "failed";
+        }>;
+        actor: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        handoffId: z.ZodString;
+        epoch: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"visitor.message">;
+        message: z.ZodString;
+        operationId: z.ZodString;
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        handoffId: z.ZodString;
+        epoch: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"human.message">;
+        message: z.ZodString;
+        actor: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>;
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        handoffId: z.ZodString;
+        epoch: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>;
+type AgentRuntimeHandoffEvent = z.infer<typeof agentRuntimeHandoffEventSchema>;
+type AgentRuntimeHandoffPage = z.infer<typeof agentRuntimeHandoffPageSchema>;
+
+type AgentHandoffCommand = {
+    operationId: string;
+    handoffId: string;
+    epoch: number;
+};
+type AgentHandoffClient = {
+    read(options?: {
+        after?: number;
+        signal?: AbortSignal;
+    }): Promise<AgentRuntimeHandoffPage>;
+    start(operationId: string, signal?: AbortSignal): Promise<void>;
+    send(command: AgentHandoffCommand & {
+        message: string;
+    }, signal?: AbortSignal): Promise<void>;
+    returnToAI(command: AgentHandoffCommand, signal?: AbortSignal): Promise<void>;
+};
+
 type AgentIndexVersion = "published" | "unpublished";
+type AgentWorkItem = {
+    id: string;
+    kind: "planning" | "search" | "specialist" | "tool";
+    label: string;
+    state: "completed" | "active" | "pending" | "error";
+    detail?: string;
+};
 type AgentInputOption = {
     id: string;
     label: string;
@@ -103,6 +231,41 @@ type AgentToolResult = {
         message: string;
     };
 };
+type AgentStreamHandlers = {
+    onWork?: (item: AgentWorkItem) => void;
+    /** @deprecated Use onWork for semantic progress events. */
+    onStep?: (label: string, detail?: string) => void;
+    onDelta: (delta: string) => void;
+    onComplete?: () => void;
+    onActionResult?: (output: unknown) => void;
+    onToolResult?: (result: AgentToolResult) => void;
+    onInputRequest?: (requests: readonly AgentInputRequest[]) => void;
+};
+type AgentSendTurnOptions = {
+    signal?: AbortSignal;
+    handlers: AgentStreamHandlers;
+};
+type AgentResumeTurnOptions = AgentSendTurnOptions & {
+    initialText?: string;
+    message: string;
+};
+type AgentRespondTurnOptions = AgentSendTurnOptions & {
+    responses: readonly AgentInputResponse[];
+};
+type AgentClient = {
+    readonly handoff: AgentHandoffClient;
+    readonly indexId: string;
+    readonly version: AgentIndexVersion;
+    readonly runtimeOrigin: string;
+    readonly visitorSessionId: string;
+    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    regenerateTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    resumeTurn: (options: AgentResumeTurnOptions) => Promise<string | null>;
+    respondTurn: (options: AgentRespondTurnOptions) => Promise<string>;
+    reset: () => void;
+    cancelActive: () => void;
+    getActiveSessionId: () => string | undefined;
+};
 
 type ComposerFormFieldKind = "text" | "email" | "tel" | "textarea";
 type ComposerFormField = {
@@ -285,6 +448,15 @@ type JourneyContext = {
     stepLabel?: string;
 };
 type ConversationMessage = {
+    id: string;
+    role: "human";
+    text: string;
+    createdAt: number;
+    representative: {
+        id: string;
+        name: string;
+    };
+} | {
     id: string;
     role: "visitor";
     text: string;
@@ -443,4 +615,4 @@ type AgentPanelSubmitOptions = {
 declare function resetAgentPanel(customerId: string): void;
 declare function submitAgentPanel(customerId: string, message: string, options?: AgentPanelSubmitOptions): Promise<string | null>;
 
-export { defaultDarkAgentRailTheme as $, AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, type AgentToolUiOption as B, type AgentToolUiStep as C, type AgentToolUiSurface as D, AssistEdgeTab as E, type AssistTabSide as F, type AssistTabVariant as G, type Citation as H, type ConversationMessage as I, DEFAULT_AGENT_PLACEMENT as J, type FollowUpSuggestion as K, type JourneyContext as L, type ToolStepState as M, type NormalizedAgentTagManifest as N, type VisitorBookingResultPresentation as O, type VisitorSearchResultPresentation as P, type VisitorToolInputResultPresentation as Q, type ResolvedVisitorToolResultPresentation as R, type VisitorToolResultLink as S, type ToolStep as T, type VisitorToolResultPresentation as U, type VisitorBooking as V, type VisitorToolResultPresenter as W, type VisitorToolResultPresenterOutput as X, type VisitorToolResultRegistry as Y, builtInVisitorToolResultRegistry as Z, defaultAgentRailTheme as _, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, formatAgentStructuredToolInput as a0, normalizeAgentPlacement as a1, normalizeAgentTagManifest as a2, presentVisitorToolResult as a3, resetAgentPanel as a4, submitAgentPanel as a5, type AgentAnalyticsConfig as b, type AgentBrandingConfig as c, type AgentColorScheme as d, type AgentIndexVersion as e, type AgentInputOption as f, type AgentInputRequest as g, type AgentInputResponse as h, type AgentMessageFeedback as i, type AgentMountStrategy as j, type AgentPanelSubmitOptions as k, type AgentPlacementConfig as l, type AgentRailPhase as m, type AgentRailState as n, type AgentRailTheme as o, type AgentSearchReferences as p, type AgentSearchSource as q, type AgentStructuredToolInput as r, type AgentTabSide as s, type AgentTabVariant as t, type AgentTagManifest as u, type AgentToolResult as v, type AgentToolResultJsonValue as w, type AgentToolUiAction as x, type AgentToolUiField as y, type AgentToolUiFieldKind as z };
+export { builtInVisitorToolResultRegistry as $, AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, type AgentToolUiField as B, type AgentToolUiFieldKind as C, type AgentToolUiOption as D, type AgentToolUiStep as E, type AgentToolUiSurface as F, AssistEdgeTab as G, type AssistTabSide as H, type AssistTabVariant as I, type Citation as J, type ConversationMessage as K, DEFAULT_AGENT_PLACEMENT as L, type FollowUpSuggestion as M, type JourneyContext as N, type NormalizedAgentTagManifest as O, type ToolStepState as P, type VisitorBookingResultPresentation as Q, type ResolvedVisitorToolResultPresentation as R, type VisitorSearchResultPresentation as S, type ToolStep as T, type VisitorToolInputResultPresentation as U, type VisitorBooking as V, type VisitorToolResultLink as W, type VisitorToolResultPresentation as X, type VisitorToolResultPresenter as Y, type VisitorToolResultPresenterOutput as Z, type VisitorToolResultRegistry as _, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, defaultAgentRailTheme as a0, defaultDarkAgentRailTheme as a1, formatAgentStructuredToolInput as a2, normalizeAgentPlacement as a3, normalizeAgentTagManifest as a4, presentVisitorToolResult as a5, resetAgentPanel as a6, submitAgentPanel as a7, type AgentAnalyticsConfig as b, type AgentBrandingConfig as c, type AgentClient as d, type AgentColorScheme as e, type AgentIndexVersion as f, type AgentInputOption as g, type AgentInputRequest as h, type AgentInputResponse as i, type AgentMessageFeedback as j, type AgentMountStrategy as k, type AgentPanelSubmitOptions as l, type AgentPlacementConfig as m, type AgentRailPhase as n, type AgentRailState as o, type AgentRailTheme as p, type AgentRuntimeHandoffEvent as q, type AgentSearchReferences as r, type AgentSearchSource as s, type AgentStructuredToolInput as t, type AgentTabSide as u, type AgentTabVariant as v, type AgentTagManifest as w, type AgentToolResult as x, type AgentToolResultJsonValue as y, type AgentToolUiAction as z };

package/dist/presentation.cjs

@@ -736,6 +736,9 @@ function finalizeSummaryPresentation(result, proposed) {
   };
 }
 function presentVisitorToolResult(result, registry = []) {
+  if (result.toolName === "request_location") {
+    return { id: result.callId, toolName: result.toolName, status: result.status, kind: "hidden" };
+  }
   if (result.status === "completed" && toolResultFailed(result)) {
     result = { ...result, status: "failed" };
   }