@webless/agent 0.11.0 → 0.12.1

package/dist/react.d.cts

@@ -1,6 +1,7 @@
 import * as react from 'react';
-import { e as AgentIndexVersion, l as AgentPlacementConfig, d as AgentColorScheme, c as AgentBrandingConfig, b as AgentAnalyticsConfig, Y as VisitorToolResultRegistry, i as AgentMessageFeedback, T as ToolStep, n as AgentRailState, o as AgentRailTheme, I as ConversationMessage, k as AgentPanelSubmitOptions, h as AgentInputResponse, D as AgentToolUiSurface, w as AgentToolResultJsonValue, K as FollowUpSuggestion, m as AgentRailPhase, V as VisitorBooking, R as ResolvedVisitorToolResultPresentation } from './panel-controller-rxR75tRa.cjs';
-export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, f as AgentInputOption, g as AgentInputRequest, p as AgentSearchReferences, q as AgentSearchSource, r as AgentStructuredToolInput, v as AgentToolResult, x as AgentToolUiAction, y as AgentToolUiField, z as AgentToolUiFieldKind, B as AgentToolUiOption, C as AgentToolUiStep, E as AssistEdgeTab, F as AssistTabSide, G as AssistTabVariant, H as Citation, J as DEFAULT_AGENT_PLACEMENT, L as JourneyContext, M as ToolStepState, O as VisitorBookingResultPresentation, P as VisitorSearchResultPresentation, Q as VisitorToolInputResultPresentation, S as VisitorToolResultLink, U as VisitorToolResultPresentation, W as VisitorToolResultPresenter, X as VisitorToolResultPresenterOutput, Z as builtInVisitorToolResultRegistry, _ as defaultAgentRailTheme, $ as defaultDarkAgentRailTheme, a0 as formatAgentStructuredToolInput, a1 as normalizeAgentPlacement, a3 as presentVisitorToolResult } from './panel-controller-rxR75tRa.cjs';
+import { f as AgentIndexVersion, m as AgentPlacementConfig, e as AgentColorScheme, c as AgentBrandingConfig, b as AgentAnalyticsConfig, _ as VisitorToolResultRegistry, d as AgentClient, q as AgentRuntimeHandoffEvent, j as AgentMessageFeedback, T as ToolStep, o as AgentRailState, p as AgentRailTheme, K as ConversationMessage, l as AgentPanelSubmitOptions, i as AgentInputResponse, F as AgentToolUiSurface, y as AgentToolResultJsonValue, M as FollowUpSuggestion, n as AgentRailPhase, V as VisitorBooking, R as ResolvedVisitorToolResultPresentation } from './panel-controller-DbDHLs4L.cjs';
+export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, g as AgentInputOption, h as AgentInputRequest, r as AgentSearchReferences, s as AgentSearchSource, t as AgentStructuredToolInput, x as AgentToolResult, z as AgentToolUiAction, B as AgentToolUiField, C as AgentToolUiFieldKind, D as AgentToolUiOption, E as AgentToolUiStep, G as AssistEdgeTab, H as AssistTabSide, I as AssistTabVariant, J as Citation, L as DEFAULT_AGENT_PLACEMENT, N as JourneyContext, P as ToolStepState, Q as VisitorBookingResultPresentation, S as VisitorSearchResultPresentation, U as VisitorToolInputResultPresentation, W as VisitorToolResultLink, X as VisitorToolResultPresentation, Y as VisitorToolResultPresenter, Z as VisitorToolResultPresenterOutput, $ as builtInVisitorToolResultRegistry, a0 as defaultAgentRailTheme, a1 as defaultDarkAgentRailTheme, a2 as formatAgentStructuredToolInput, a3 as normalizeAgentPlacement, a5 as presentVisitorToolResult } from './panel-controller-DbDHLs4L.cjs';
+import 'zod';
 
 type AgentWidgetProps = {
     indexId: string;
@@ -9,6 +10,7 @@ type AgentWidgetProps = {
     previewBuildId?: string;
     version?: AgentIndexVersion;
     runtimeOrigin?: string;
+    handoffEnabled?: boolean;
     placement?: Partial<AgentPlacementConfig>;
     defaultCollapsed?: boolean;
     pageShift?: boolean;
@@ -18,7 +20,70 @@ type AgentWidgetProps = {
     analytics?: AgentAnalyticsConfig;
     toolResultRegistry?: VisitorToolResultRegistry;
 };
-declare function AgentWidget({ indexId, customerId, getUnpublishedPreviewGrant, previewBuildId, version, runtimeOrigin, placement: placementInput, defaultCollapsed, pageShift, registerPanelController, colorScheme, branding, analytics, toolResultRegistry, }: AgentWidgetProps): react.JSX.Element;
+declare function AgentWidget({ indexId, customerId, getUnpublishedPreviewGrant, previewBuildId, version, runtimeOrigin, handoffEnabled, placement: placementInput, defaultCollapsed, pageShift, registerPanelController, colorScheme, branding, analytics, toolResultRegistry, }: AgentWidgetProps): react.JSX.Element;
+
+declare function useAgentHandoff(options: {
+    enabled: boolean;
+    client: AgentClient;
+    sessionId: string | undefined;
+    onEvents: (events: AgentRuntimeHandoffEvent[]) => void;
+    onOwnership: () => void;
+}): {
+    page: {
+        apiVersion: "webless.ai/agent-runtime-handoff/v1";
+        sessionId: string;
+        enabled: boolean;
+        status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+        handoffId: string | null;
+        epoch: number;
+        after: number;
+        cursor: number;
+        hasMore: boolean;
+        events: ({
+            type: "status";
+            status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+            actor: {
+                id: string;
+                name: string;
+            } | null;
+            id: string;
+            sequence: number;
+            handoffId: string;
+            epoch: number;
+            createdAt: string;
+        } | {
+            type: "visitor.message";
+            message: string;
+            operationId: string;
+            id: string;
+            sequence: number;
+            handoffId: string;
+            epoch: number;
+            createdAt: string;
+        } | {
+            type: "human.message";
+            message: string;
+            actor: {
+                id: string;
+                name: string;
+            };
+            id: string;
+            sequence: number;
+            handoffId: string;
+            epoch: number;
+            createdAt: string;
+        })[];
+    } | null;
+    busy: boolean;
+    error: string | null;
+    hasPending: boolean;
+    canReset: boolean;
+    blocksAI: boolean;
+    start: () => Promise<void>;
+    send: (message: string) => Promise<void>;
+    returnToAI: () => Promise<void>;
+    retry: () => Promise<void>;
+};
 
 declare function MessageActions({ answeredAt, copyText, disabled, onOpenReceipt, onRegenerate, onFeedback, readAloud, receiptSteps, speechText, }: {
     answeredAt?: number;
@@ -35,6 +100,7 @@ declare function MessageActions({ answeredAt, copyText, disabled, onOpenReceipt,
 
 type AgentRailProps = {
     state: AgentRailState;
+    handoff?: ReturnType<typeof useAgentHandoff>;
     theme?: Partial<AgentRailTheme>;
     colorScheme?: AgentColorScheme;
     brandLabel?: string;
@@ -63,9 +129,10 @@ type AgentRailProps = {
     onInputResponse?: (response: AgentInputResponse) => void;
     onToolInput?: (surface: AgentToolUiSurface, values: Record<string, AgentToolResultJsonValue>) => void;
 };
-declare function AgentRail({ state, theme, colorScheme, brandLabel, brandLogoUrl, poweredByLabel, disclaimerLabel, disclaimerLink, answerReceipt, readAloud, composerPlaceholder, mobileFullscreen, expanded, onCollapse, onClose, onExpandToggle, onReset, onRetry, onRegenerate, onFeedback, onSubmit, onFollowUpSelect, onBook, onInputResponse, onToolInput, }: AgentRailProps): react.JSX.Element;
+declare function AgentRail({ state, handoff, theme, colorScheme, brandLabel, brandLogoUrl, poweredByLabel, disclaimerLabel, disclaimerLink, answerReceipt, readAloud, composerPlaceholder, mobileFullscreen, expanded, onCollapse, onClose, onExpandToggle, onReset, onRetry, onRegenerate, onFeedback, onSubmit, onFollowUpSelect, onBook, onInputResponse, onToolInput, }: AgentRailProps): react.JSX.Element;
 
 type UseAgentChatOptions = {
+    handoffEnabled?: boolean;
     customerId?: string;
     getUnpublishedPreviewGrant?: () => Promise<string>;
     indexId: string;
@@ -82,7 +149,63 @@ type AgentChatSubmitOptions = {
     runtimeText?: string;
     declinedComposerFormId?: string;
 };
-declare function useAgentChat({ customerId, getUnpublishedPreviewGrant, indexId, previewBuildId, version, runtimeOrigin, visitorSessionId, storageKeyPrefix, greeting, toolResultRegistry, }: UseAgentChatOptions): {
+declare function useAgentChat({ handoffEnabled, customerId, getUnpublishedPreviewGrant, indexId, previewBuildId, version, runtimeOrigin, visitorSessionId, storageKeyPrefix, greeting, toolResultRegistry, }: UseAgentChatOptions): {
+    handoff: {
+        page: {
+            apiVersion: "webless.ai/agent-runtime-handoff/v1";
+            sessionId: string;
+            enabled: boolean;
+            status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+            handoffId: string | null;
+            epoch: number;
+            after: number;
+            cursor: number;
+            hasMore: boolean;
+            events: ({
+                type: "status";
+                status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+                actor: {
+                    id: string;
+                    name: string;
+                } | null;
+                id: string;
+                sequence: number;
+                handoffId: string;
+                epoch: number;
+                createdAt: string;
+            } | {
+                type: "visitor.message";
+                message: string;
+                operationId: string;
+                id: string;
+                sequence: number;
+                handoffId: string;
+                epoch: number;
+                createdAt: string;
+            } | {
+                type: "human.message";
+                message: string;
+                actor: {
+                    id: string;
+                    name: string;
+                };
+                id: string;
+                sequence: number;
+                handoffId: string;
+                epoch: number;
+                createdAt: string;
+            })[];
+        } | null;
+        busy: boolean;
+        error: string | null;
+        hasPending: boolean;
+        canReset: boolean;
+        blocksAI: boolean;
+        start: () => Promise<void>;
+        send: (message: string) => Promise<void>;
+        returnToAI: () => Promise<void>;
+        retry: () => Promise<void>;
+    };
     state: AgentRailState;
     reset: () => void;
     retry: () => Promise<void>;

package/dist/react.d.ts

@@ -1,6 +1,7 @@
 import * as react from 'react';
-import { e as AgentIndexVersion, l as AgentPlacementConfig, d as AgentColorScheme, c as AgentBrandingConfig, b as AgentAnalyticsConfig, Y as VisitorToolResultRegistry, i as AgentMessageFeedback, T as ToolStep, n as AgentRailState, o as AgentRailTheme, I as ConversationMessage, k as AgentPanelSubmitOptions, h as AgentInputResponse, D as AgentToolUiSurface, w as AgentToolResultJsonValue, K as FollowUpSuggestion, m as AgentRailPhase, V as VisitorBooking, R as ResolvedVisitorToolResultPresentation } from './panel-controller-rxR75tRa.js';
-export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, f as AgentInputOption, g as AgentInputRequest, p as AgentSearchReferences, q as AgentSearchSource, r as AgentStructuredToolInput, v as AgentToolResult, x as AgentToolUiAction, y as AgentToolUiField, z as AgentToolUiFieldKind, B as AgentToolUiOption, C as AgentToolUiStep, E as AssistEdgeTab, F as AssistTabSide, G as AssistTabVariant, H as Citation, J as DEFAULT_AGENT_PLACEMENT, L as JourneyContext, M as ToolStepState, O as VisitorBookingResultPresentation, P as VisitorSearchResultPresentation, Q as VisitorToolInputResultPresentation, S as VisitorToolResultLink, U as VisitorToolResultPresentation, W as VisitorToolResultPresenter, X as VisitorToolResultPresenterOutput, Z as builtInVisitorToolResultRegistry, _ as defaultAgentRailTheme, $ as defaultDarkAgentRailTheme, a0 as formatAgentStructuredToolInput, a1 as normalizeAgentPlacement, a3 as presentVisitorToolResult } from './panel-controller-rxR75tRa.js';
+import { f as AgentIndexVersion, m as AgentPlacementConfig, e as AgentColorScheme, c as AgentBrandingConfig, b as AgentAnalyticsConfig, _ as VisitorToolResultRegistry, d as AgentClient, q as AgentRuntimeHandoffEvent, j as AgentMessageFeedback, T as ToolStep, o as AgentRailState, p as AgentRailTheme, K as ConversationMessage, l as AgentPanelSubmitOptions, i as AgentInputResponse, F as AgentToolUiSurface, y as AgentToolResultJsonValue, M as FollowUpSuggestion, n as AgentRailPhase, V as VisitorBooking, R as ResolvedVisitorToolResultPresentation } from './panel-controller-DbDHLs4L.js';
+export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, g as AgentInputOption, h as AgentInputRequest, r as AgentSearchReferences, s as AgentSearchSource, t as AgentStructuredToolInput, x as AgentToolResult, z as AgentToolUiAction, B as AgentToolUiField, C as AgentToolUiFieldKind, D as AgentToolUiOption, E as AgentToolUiStep, G as AssistEdgeTab, H as AssistTabSide, I as AssistTabVariant, J as Citation, L as DEFAULT_AGENT_PLACEMENT, N as JourneyContext, P as ToolStepState, Q as VisitorBookingResultPresentation, S as VisitorSearchResultPresentation, U as VisitorToolInputResultPresentation, W as VisitorToolResultLink, X as VisitorToolResultPresentation, Y as VisitorToolResultPresenter, Z as VisitorToolResultPresenterOutput, $ as builtInVisitorToolResultRegistry, a0 as defaultAgentRailTheme, a1 as defaultDarkAgentRailTheme, a2 as formatAgentStructuredToolInput, a3 as normalizeAgentPlacement, a5 as presentVisitorToolResult } from './panel-controller-DbDHLs4L.js';
+import 'zod';
 
 type AgentWidgetProps = {
     indexId: string;
@@ -9,6 +10,7 @@ type AgentWidgetProps = {
     previewBuildId?: string;
     version?: AgentIndexVersion;
     runtimeOrigin?: string;
+    handoffEnabled?: boolean;
     placement?: Partial<AgentPlacementConfig>;
     defaultCollapsed?: boolean;
     pageShift?: boolean;
@@ -18,7 +20,70 @@ type AgentWidgetProps = {
     analytics?: AgentAnalyticsConfig;
     toolResultRegistry?: VisitorToolResultRegistry;
 };
-declare function AgentWidget({ indexId, customerId, getUnpublishedPreviewGrant, previewBuildId, version, runtimeOrigin, placement: placementInput, defaultCollapsed, pageShift, registerPanelController, colorScheme, branding, analytics, toolResultRegistry, }: AgentWidgetProps): react.JSX.Element;
+declare function AgentWidget({ indexId, customerId, getUnpublishedPreviewGrant, previewBuildId, version, runtimeOrigin, handoffEnabled, placement: placementInput, defaultCollapsed, pageShift, registerPanelController, colorScheme, branding, analytics, toolResultRegistry, }: AgentWidgetProps): react.JSX.Element;
+
+declare function useAgentHandoff(options: {
+    enabled: boolean;
+    client: AgentClient;
+    sessionId: string | undefined;
+    onEvents: (events: AgentRuntimeHandoffEvent[]) => void;
+    onOwnership: () => void;
+}): {
+    page: {
+        apiVersion: "webless.ai/agent-runtime-handoff/v1";
+        sessionId: string;
+        enabled: boolean;
+        status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+        handoffId: string | null;
+        epoch: number;
+        after: number;
+        cursor: number;
+        hasMore: boolean;
+        events: ({
+            type: "status";
+            status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+            actor: {
+                id: string;
+                name: string;
+            } | null;
+            id: string;
+            sequence: number;
+            handoffId: string;
+            epoch: number;
+            createdAt: string;
+        } | {
+            type: "visitor.message";
+            message: string;
+            operationId: string;
+            id: string;
+            sequence: number;
+            handoffId: string;
+            epoch: number;
+            createdAt: string;
+        } | {
+            type: "human.message";
+            message: string;
+            actor: {
+                id: string;
+                name: string;
+            };
+            id: string;
+            sequence: number;
+            handoffId: string;
+            epoch: number;
+            createdAt: string;
+        })[];
+    } | null;
+    busy: boolean;
+    error: string | null;
+    hasPending: boolean;
+    canReset: boolean;
+    blocksAI: boolean;
+    start: () => Promise<void>;
+    send: (message: string) => Promise<void>;
+    returnToAI: () => Promise<void>;
+    retry: () => Promise<void>;
+};
 
 declare function MessageActions({ answeredAt, copyText, disabled, onOpenReceipt, onRegenerate, onFeedback, readAloud, receiptSteps, speechText, }: {
     answeredAt?: number;
@@ -35,6 +100,7 @@ declare function MessageActions({ answeredAt, copyText, disabled, onOpenReceipt,
 
 type AgentRailProps = {
     state: AgentRailState;
+    handoff?: ReturnType<typeof useAgentHandoff>;
     theme?: Partial<AgentRailTheme>;
     colorScheme?: AgentColorScheme;
     brandLabel?: string;
@@ -63,9 +129,10 @@ type AgentRailProps = {
     onInputResponse?: (response: AgentInputResponse) => void;
     onToolInput?: (surface: AgentToolUiSurface, values: Record<string, AgentToolResultJsonValue>) => void;
 };
-declare function AgentRail({ state, theme, colorScheme, brandLabel, brandLogoUrl, poweredByLabel, disclaimerLabel, disclaimerLink, answerReceipt, readAloud, composerPlaceholder, mobileFullscreen, expanded, onCollapse, onClose, onExpandToggle, onReset, onRetry, onRegenerate, onFeedback, onSubmit, onFollowUpSelect, onBook, onInputResponse, onToolInput, }: AgentRailProps): react.JSX.Element;
+declare function AgentRail({ state, handoff, theme, colorScheme, brandLabel, brandLogoUrl, poweredByLabel, disclaimerLabel, disclaimerLink, answerReceipt, readAloud, composerPlaceholder, mobileFullscreen, expanded, onCollapse, onClose, onExpandToggle, onReset, onRetry, onRegenerate, onFeedback, onSubmit, onFollowUpSelect, onBook, onInputResponse, onToolInput, }: AgentRailProps): react.JSX.Element;
 
 type UseAgentChatOptions = {
+    handoffEnabled?: boolean;
     customerId?: string;
     getUnpublishedPreviewGrant?: () => Promise<string>;
     indexId: string;
@@ -82,7 +149,63 @@ type AgentChatSubmitOptions = {
     runtimeText?: string;
     declinedComposerFormId?: string;
 };
-declare function useAgentChat({ customerId, getUnpublishedPreviewGrant, indexId, previewBuildId, version, runtimeOrigin, visitorSessionId, storageKeyPrefix, greeting, toolResultRegistry, }: UseAgentChatOptions): {
+declare function useAgentChat({ handoffEnabled, customerId, getUnpublishedPreviewGrant, indexId, previewBuildId, version, runtimeOrigin, visitorSessionId, storageKeyPrefix, greeting, toolResultRegistry, }: UseAgentChatOptions): {
+    handoff: {
+        page: {
+            apiVersion: "webless.ai/agent-runtime-handoff/v1";
+            sessionId: string;
+            enabled: boolean;
+            status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+            handoffId: string | null;
+            epoch: number;
+            after: number;
+            cursor: number;
+            hasMore: boolean;
+            events: ({
+                type: "status";
+                status: "ai" | "requesting" | "queued" | "human" | "resolved" | "failed";
+                actor: {
+                    id: string;
+                    name: string;
+                } | null;
+                id: string;
+                sequence: number;
+                handoffId: string;
+                epoch: number;
+                createdAt: string;
+            } | {
+                type: "visitor.message";
+                message: string;
+                operationId: string;
+                id: string;
+                sequence: number;
+                handoffId: string;
+                epoch: number;
+                createdAt: string;
+            } | {
+                type: "human.message";
+                message: string;
+                actor: {
+                    id: string;
+                    name: string;
+                };
+                id: string;
+                sequence: number;
+                handoffId: string;
+                epoch: number;
+                createdAt: string;
+            })[];
+        } | null;
+        busy: boolean;
+        error: string | null;
+        hasPending: boolean;
+        canReset: boolean;
+        blocksAI: boolean;
+        start: () => Promise<void>;
+        send: (message: string) => Promise<void>;
+        returnToAI: () => Promise<void>;
+        retry: () => Promise<void>;
+    };
     state: AgentRailState;
     reset: () => void;
     retry: () => Promise<void>;

package/dist/react.js

@@ -27,7 +27,7 @@ import {
   sendAgentAnswerFeedback,
   useAgentChat,
   useAgentColorScheme
-} from "./chunk-NW37MHU7.js";
+} from "./chunk-HKQFEO6R.js";
 
 // src/react/components/AgentTranscript/AgentTranscript.tsx
 import { Fragment as Fragment2 } from "react";

package/dist/{types-B2j6hbI5.d.cts → types-4lTJW5mp.d.cts}

@@ -1,3 +1,5 @@
+import { z } from 'zod';
+
 declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
 declare const AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION: "webless.structured-tool-input.v1";
 declare const AGENT_STRUCTURED_TOOL_INPUT_HEADER: "Webless-Structured-Tool-Input-JSON:";
@@ -66,6 +68,135 @@ type AgentToolResultEnvelope = {
 };
 declare function parseAgentToolResultEnvelope(value: unknown): AgentToolResultEnvelope | null;
 
+declare const agentRuntimeHandoffStatusSchema: z.ZodEnum<{
+    ai: "ai";
+    requesting: "requesting";
+    queued: "queued";
+    human: "human";
+    resolved: "resolved";
+    failed: "failed";
+}>;
+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 AgentRuntimeHandoffStatus = z.infer<typeof agentRuntimeHandoffStatusSchema>;
+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 AgentRuntimeConfig = {
     origin: string;
@@ -163,6 +294,7 @@ type AgentClientOptions = {
     storageKeyPrefix?: string;
 };
 type AgentClient = {
+    readonly handoff: AgentHandoffClient;
     readonly indexId: string;
     readonly version: AgentIndexVersion;
     readonly runtimeOrigin: string;
@@ -180,4 +312,4 @@ type AgentHealthResult = {
     detail: string;
 };
 
-export { AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, parseAgentToolResultEnvelope as B, parseAgentToolUiSurface as C, type PersistedAgentSession as P, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, AGENT_TOOL_UI_SCHEMA_VERSION as b, type AgentClient as c, type AgentClientOptions as d, type AgentHealthResult as e, type AgentIndexVersion as f, type AgentInputOption as g, type AgentInputRequest as h, type AgentInputResponse as i, type AgentRespondTurnOptions as j, type AgentResumeTurnOptions as k, type AgentRuntimeConfig as l, type AgentSendTurnOptions as m, type AgentStreamHandlers as n, type AgentStructuredToolInput as o, type AgentToolResult as p, type AgentToolResultEnvelope as q, type AgentToolResultJsonValue as r, type AgentToolUiAction as s, type AgentToolUiField as t, type AgentToolUiFieldKind as u, type AgentToolUiOption as v, type AgentToolUiStep as w, type AgentToolUiSurface as x, type AgentWorkItem as y, formatAgentStructuredToolInput as z };
+export { AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, type AgentToolUiOption as B, type AgentToolUiStep as C, type AgentToolUiSurface as D, type AgentWorkItem as E, formatAgentStructuredToolInput as F, parseAgentToolResultEnvelope as G, parseAgentToolUiSurface as H, type PersistedAgentSession as P, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, AGENT_TOOL_UI_SCHEMA_VERSION as b, type AgentClient as c, type AgentClientOptions as d, type AgentHandoffClient as e, type AgentHandoffCommand as f, type AgentHealthResult as g, type AgentIndexVersion as h, type AgentInputOption as i, type AgentInputRequest as j, type AgentInputResponse as k, type AgentRespondTurnOptions as l, type AgentResumeTurnOptions as m, type AgentRuntimeConfig as n, type AgentRuntimeHandoffEvent as o, type AgentRuntimeHandoffPage as p, type AgentRuntimeHandoffStatus as q, type AgentSendTurnOptions as r, type AgentStreamHandlers as s, type AgentStructuredToolInput as t, type AgentToolResult as u, type AgentToolResultEnvelope as v, type AgentToolResultJsonValue as w, type AgentToolUiAction as x, type AgentToolUiField as y, type AgentToolUiFieldKind as z };