@webless/agent 0.12.0 → 0.12.1

package/README.md

@@ -45,6 +45,12 @@ Agent Studio generates a live preview of the agent on your pages, so you can che
 
 `@webless/agent` is published for Webless tooling and internal use. It powers the script bundle served from the console install flow.
 
+### Embedded human handoff
+
+Set `handoffEnabled: true` in the embed manifest or React `AgentWidget` props only for a runtime with handoff support. It defaults to false. The runtime decides whether the visitor can request a person; the widget displays representative replies and requires an explicit return to AI after resolution.
+
+For opted-in conversations, an unavailable ownership lookup blocks sending until ownership is confirmed. This prevents the AI from replying while a person may own the conversation. Widgets without the opt-in make no handoff requests and retain their existing chat behavior.
+
 ### Location-aware tool requests
 
 The built-in widget advertises `locationConsent: "v1"` during bootstrap. A compatible runtime can then pause on `request_location`, which the widget renders as a toggle rather than a generic approval card. Headless clients should set `createAgentClient({ locationConsent: true, ... })` only if they implement that UI and resolve its pending request IDs.

package/dist/{chunk-EVWZF34F.js → chunk-HKQFEO6R.js}

@@ -7989,6 +7989,7 @@ function AgentWidget({
   previewBuildId,
   version,
   runtimeOrigin,
+  handoffEnabled = false,
   placement: placementInput,
   defaultCollapsed = true,
   pageShift = true,
@@ -8015,6 +8016,7 @@ function AgentWidget({
   });
   const {
     state,
+    handoff,
     reset,
     retry,
     regenerate,
@@ -8024,6 +8026,7 @@ function AgentWidget({
     visitorSessionId,
     sessionId
   } = useAgentChat({
+    handoffEnabled,
     customerId,
     getUnpublishedPreviewGrant,
     indexId,
@@ -8150,6 +8153,7 @@ function AgentWidget({
                 answerReceipt: branding?.answerReceipt,
                 readAloud: branding?.readAloud,
                 state,
+                handoff,
                 mobileFullscreen: isMobile && !railCollapsed,
                 expanded: railExpanded,
                 onCollapse: !isMobile ? () => setRailCollapsed(true) : void 0,
@@ -8234,4 +8238,4 @@ export {
   sendAgentAnswerFeedback,
   AgentWidget
 };
-//# sourceMappingURL=chunk-EVWZF34F.js.map
+//# sourceMappingURL=chunk-HKQFEO6R.js.map