@webless/agent 0.11.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/README.md +6 -0
  2. package/dist/{chunk-NW37MHU7.js → chunk-HKQFEO6R.js} +1107 -477
  3. package/dist/chunk-HKQFEO6R.js.map +1 -0
  4. package/dist/embed.cjs +1138 -506
  5. package/dist/embed.cjs.map +1 -1
  6. package/dist/embed.css +64 -0
  7. package/dist/embed.css.map +1 -1
  8. package/dist/embed.d.cts +3 -2
  9. package/dist/embed.d.ts +3 -2
  10. package/dist/embed.js +3 -1
  11. package/dist/embed.js.map +1 -1
  12. package/dist/index.cjs +283 -12
  13. package/dist/index.cjs.map +1 -1
  14. package/dist/index.d.cts +3 -2
  15. package/dist/index.d.ts +3 -2
  16. package/dist/index.js +277 -6
  17. package/dist/index.js.map +1 -1
  18. package/dist/{panel-controller-rxR75tRa.d.cts → panel-controller-DbDHLs4L.d.cts} +175 -1
  19. package/dist/{panel-controller-rxR75tRa.d.ts → panel-controller-DbDHLs4L.d.ts} +175 -1
  20. package/dist/presentation.d.cts +2 -1
  21. package/dist/presentation.d.ts +2 -1
  22. package/dist/react.cjs +1135 -505
  23. package/dist/react.cjs.map +1 -1
  24. package/dist/react.css +64 -0
  25. package/dist/react.css.map +1 -1
  26. package/dist/react.d.cts +128 -5
  27. package/dist/react.d.ts +128 -5
  28. package/dist/react.js +1 -1
  29. package/dist/{types-B2j6hbI5.d.cts → types-4lTJW5mp.d.cts} +133 -1
  30. package/dist/{types-B2j6hbI5.d.ts → types-4lTJW5mp.d.ts} +133 -1
  31. package/package.json +3 -2
  32. package/scripts/sync-handoff-contract.mjs +18 -0
  33. package/dist/chunk-NW37MHU7.js.map +0 -1
package/README.md CHANGED
@@ -45,6 +45,12 @@ Agent Studio generates a live preview of the agent on your pages, so you can che
45
45
 
46
46
  `@webless/agent` is published for Webless tooling and internal use. It powers the script bundle served from the console install flow.
47
47
 
48
+ ### Embedded human handoff
49
+
50
+ 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.
51
+
52
+ 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.
53
+
48
54
  ### Location-aware tool requests
49
55
 
50
56
  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.