@8wave/ai-elements 0.123.0-beta.11 → 0.123.0-beta.12

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 (139) hide show
  1. package/README.md +30 -3
  2. package/dist/_chunks/{Agent-C0JtGK2t.js → Agent-CsSvagZw.js} +13 -2
  3. package/dist/_chunks/Agent-CsSvagZw.js.map +1 -0
  4. package/dist/_chunks/{PkStreamingMarkdown-DGdyf4_3.js → PkStreamingMarkdown-ReRKQNAO.js} +3 -3
  5. package/dist/_chunks/{PkStreamingMarkdown-DGdyf4_3.js.map → PkStreamingMarkdown-ReRKQNAO.js.map} +1 -1
  6. package/dist/_chunks/{PkToolChatFile-NrOBCzk2.js → PkToolChatFile-QJi6bOuS.js} +2 -2
  7. package/dist/_chunks/{PkToolChatFile-NrOBCzk2.js.map → PkToolChatFile-QJi6bOuS.js.map} +1 -1
  8. package/dist/_chunks/{PkToolRequestGeolocation-BIfpxvX5.js → PkToolRequestGeolocation-CUjRsNs9.js} +2 -2
  9. package/dist/_chunks/{PkToolRequestGeolocation-BIfpxvX5.js.map → PkToolRequestGeolocation-CUjRsNs9.js.map} +1 -1
  10. package/dist/_chunks/{PkToolRequestOAuthConnection-CJgoiSgi.js → PkToolRequestOAuthConnection-CbxVIAPg.js} +2 -2
  11. package/dist/_chunks/{PkToolRequestOAuthConnection-CJgoiSgi.js.map → PkToolRequestOAuthConnection-CbxVIAPg.js.map} +1 -1
  12. package/dist/_chunks/{PkToolShowArtifact-DmZEQMSm.js → PkToolShowArtifact-D0HZ_qWx.js} +2 -2
  13. package/dist/_chunks/{PkToolShowArtifact-DmZEQMSm.js.map → PkToolShowArtifact-D0HZ_qWx.js.map} +1 -1
  14. package/dist/_chunks/{PkToolShowContactForm-BaX3d5Yq.js → PkToolShowContactForm-DkJB0EO1.js} +2 -2
  15. package/dist/_chunks/{PkToolShowContactForm-BaX3d5Yq.js.map → PkToolShowContactForm-DkJB0EO1.js.map} +1 -1
  16. package/dist/_chunks/{PkToolShowForm-BKyZnpPB.js → PkToolShowForm-zAprG0yl.js} +3 -3
  17. package/dist/_chunks/{PkToolShowForm-BKyZnpPB.js.map → PkToolShowForm-zAprG0yl.js.map} +1 -1
  18. package/dist/_chunks/{PkToolShowImageGallery-GBaXxucK.js → PkToolShowImageGallery-o62SZ6tq.js} +2 -2
  19. package/dist/_chunks/{PkToolShowImageGallery-GBaXxucK.js.map → PkToolShowImageGallery-o62SZ6tq.js.map} +1 -1
  20. package/dist/_chunks/{PkToolShowProductList-DBVtBJXU.js → PkToolShowProductList-CWLxVreB.js} +2 -2
  21. package/dist/_chunks/{PkToolShowProductList-DBVtBJXU.js.map → PkToolShowProductList-CWLxVreB.js.map} +1 -1
  22. package/dist/_chunks/{PkToolShowSources-Ciuizdl3.js → PkToolShowSources-dJEqZn6T.js} +3 -3
  23. package/dist/_chunks/{PkToolShowSources-Ciuizdl3.js.map → PkToolShowSources-dJEqZn6T.js.map} +1 -1
  24. package/dist/_chunks/{PkToolShowSuggestedReply-Dbti20SV.js → PkToolShowSuggestedReply-BHAltyxH.js} +2 -2
  25. package/dist/_chunks/{PkToolShowSuggestedReply-Dbti20SV.js.map → PkToolShowSuggestedReply-BHAltyxH.js.map} +1 -1
  26. package/dist/_chunks/{PkToolShowVideo-DKDR3zmI.js → PkToolShowVideo-DtJ0nEJk.js} +2 -2
  27. package/dist/_chunks/{PkToolShowVideo-DKDR3zmI.js.map → PkToolShowVideo-DtJ0nEJk.js.map} +1 -1
  28. package/dist/_chunks/{PkToolShowWebPages-CuJ12tdE.js → PkToolShowWebPages-D-tG9JH8.js} +2 -2
  29. package/dist/_chunks/{PkToolShowWebPages-CuJ12tdE.js.map → PkToolShowWebPages-D-tG9JH8.js.map} +1 -1
  30. package/dist/_chunks/{chatImagePolicy-D3zIP7-i.js → chatImagePolicy-Dhxqcirq.js} +2 -2
  31. package/dist/_chunks/{chatImagePolicy-D3zIP7-i.js.map → chatImagePolicy-Dhxqcirq.js.map} +1 -1
  32. package/dist/_chunks/{markdown-BxOlM5SY.js → markdown-CUaXq5OY.js} +2 -2
  33. package/dist/_chunks/{markdown-BxOlM5SY.js.map → markdown-CUaXq5OY.js.map} +1 -1
  34. package/dist/ai-elements.es.js +2720 -2269
  35. package/dist/ai-elements.es.js.map +1 -1
  36. package/dist-vue/PkChatbot.js +1 -1
  37. package/dist-vue/PkChatbotEmptyState.js +1 -1
  38. package/dist-vue/PkChatbotInput.js +1 -1
  39. package/dist-vue/PkChatbotMessages.js +1 -1
  40. package/dist-vue/PkChatbotStepPayload.js +1 -1
  41. package/dist-vue/PkChatbotStepToolDetail.js +1 -1
  42. package/dist-vue/PkChatbotSteps.js +1 -1
  43. package/dist-vue/PkChatbotViewChat.js +1 -1
  44. package/dist-vue/PkChatbotViewConversations.js +1 -1
  45. package/dist-vue/PkChatbotViewFiles.js +1 -1
  46. package/dist-vue/PkChatbotViewProfile.js +1 -1
  47. package/dist-vue/_chunks/{Agent-Dsi_xGvV.js → Agent-D3US-D1x.js} +13 -2
  48. package/dist-vue/_chunks/Agent-D3US-D1x.js.map +1 -0
  49. package/dist-vue/_chunks/{Document-B5R1PJnc.js → Document-D5FVOcP9.js} +2 -2
  50. package/dist-vue/_chunks/{Document-B5R1PJnc.js.map → Document-D5FVOcP9.js.map} +1 -1
  51. package/dist-vue/_chunks/{PkChatbot-CBpViucq.js → PkChatbot-DxPT26Vn.js} +8 -8
  52. package/dist-vue/_chunks/{PkChatbot-CBpViucq.js.map → PkChatbot-DxPT26Vn.js.map} +1 -1
  53. package/dist-vue/_chunks/{PkChatbotEmptyState-DKrmLdVU.js → PkChatbotEmptyState-3VeE3lFA.js} +2 -2
  54. package/dist-vue/_chunks/{PkChatbotEmptyState-DKrmLdVU.js.map → PkChatbotEmptyState-3VeE3lFA.js.map} +1 -1
  55. package/dist-vue/_chunks/{PkChatbotInput-C1i14Ur_.js → PkChatbotInput-SWQVz3m7.js} +212 -175
  56. package/dist-vue/_chunks/PkChatbotInput-SWQVz3m7.js.map +1 -0
  57. package/dist-vue/_chunks/{PkChatbotMessages-Ce8h0QNX.js → PkChatbotMessages-DFimKbCj.js} +122 -114
  58. package/dist-vue/_chunks/PkChatbotMessages-DFimKbCj.js.map +1 -0
  59. package/dist-vue/_chunks/{PkChatbotStepPayload-Dp_akrQu.js → PkChatbotStepPayload-Di0FNaTC.js} +2 -2
  60. package/dist-vue/_chunks/{PkChatbotStepPayload-Dp_akrQu.js.map → PkChatbotStepPayload-Di0FNaTC.js.map} +1 -1
  61. package/dist-vue/_chunks/{PkChatbotStepToolDetail-CKxl4_lQ.js → PkChatbotStepToolDetail-Bne48uS8.js} +3 -3
  62. package/dist-vue/_chunks/{PkChatbotStepToolDetail-CKxl4_lQ.js.map → PkChatbotStepToolDetail-Bne48uS8.js.map} +1 -1
  63. package/dist-vue/_chunks/{PkChatbotSteps-ChaHkHjG.js → PkChatbotSteps-Cr9nwMQj.js} +5 -5
  64. package/dist-vue/_chunks/{PkChatbotSteps-ChaHkHjG.js.map → PkChatbotSteps-Cr9nwMQj.js.map} +1 -1
  65. package/dist-vue/_chunks/{PkChatbotViewChat-Bjw6x7VD.js → PkChatbotViewChat-CQy-k_dp.js} +417 -404
  66. package/dist-vue/_chunks/PkChatbotViewChat-CQy-k_dp.js.map +1 -0
  67. package/dist-vue/_chunks/{PkChatbotViewConversations-D-UK4paq.js → PkChatbotViewConversations-Bng-dyqd.js} +3 -3
  68. package/dist-vue/_chunks/{PkChatbotViewConversations-D-UK4paq.js.map → PkChatbotViewConversations-Bng-dyqd.js.map} +1 -1
  69. package/dist-vue/_chunks/{PkChatbotViewFiles-57kQRbZm.js → PkChatbotViewFiles-Ccti1JAS.js} +3 -3
  70. package/dist-vue/_chunks/{PkChatbotViewFiles-57kQRbZm.js.map → PkChatbotViewFiles-Ccti1JAS.js.map} +1 -1
  71. package/dist-vue/_chunks/{PkChatbotViewProfile-BZTify2Q.js → PkChatbotViewProfile-ChEItAHZ.js} +2 -2
  72. package/dist-vue/_chunks/{PkChatbotViewProfile-BZTify2Q.js.map → PkChatbotViewProfile-ChEItAHZ.js.map} +1 -1
  73. package/dist-vue/_chunks/{PkStreamingMarkdown-4Ez-DDFq.js → PkStreamingMarkdown-92GXUXrG.js} +3 -3
  74. package/dist-vue/_chunks/{PkStreamingMarkdown-4Ez-DDFq.js.map → PkStreamingMarkdown-92GXUXrG.js.map} +1 -1
  75. package/dist-vue/_chunks/{PkToolChatFile-DaivFIhK.js → PkToolChatFile-Ca45de6q.js} +2 -2
  76. package/dist-vue/_chunks/{PkToolChatFile-DaivFIhK.js.map → PkToolChatFile-Ca45de6q.js.map} +1 -1
  77. package/dist-vue/_chunks/{PkToolRequestGeolocation-B__wk6m3.js → PkToolRequestGeolocation-gEDbmudT.js} +2 -2
  78. package/dist-vue/_chunks/{PkToolRequestGeolocation-B__wk6m3.js.map → PkToolRequestGeolocation-gEDbmudT.js.map} +1 -1
  79. package/dist-vue/_chunks/{PkToolRequestOAuthConnection-BAttadSC.js → PkToolRequestOAuthConnection-Dy0GXNwC.js} +2 -2
  80. package/dist-vue/_chunks/{PkToolRequestOAuthConnection-BAttadSC.js.map → PkToolRequestOAuthConnection-Dy0GXNwC.js.map} +1 -1
  81. package/dist-vue/_chunks/{PkToolShowArtifact-CncSr7Z8.js → PkToolShowArtifact-B-BUIMju.js} +2 -2
  82. package/dist-vue/_chunks/{PkToolShowArtifact-CncSr7Z8.js.map → PkToolShowArtifact-B-BUIMju.js.map} +1 -1
  83. package/dist-vue/_chunks/{PkToolShowContactForm-Bi5N1fFe.js → PkToolShowContactForm-NRfvmPLV.js} +2 -2
  84. package/dist-vue/_chunks/{PkToolShowContactForm-Bi5N1fFe.js.map → PkToolShowContactForm-NRfvmPLV.js.map} +1 -1
  85. package/dist-vue/_chunks/{PkToolShowDiagram-D8NF9lZu.js → PkToolShowDiagram-VTi8vwcN.js} +2 -2
  86. package/dist-vue/_chunks/{PkToolShowDiagram-D8NF9lZu.js.map → PkToolShowDiagram-VTi8vwcN.js.map} +1 -1
  87. package/dist-vue/_chunks/{PkToolShowForm-Dmyn6cMU.js → PkToolShowForm-C4JnalBU.js} +4 -4
  88. package/dist-vue/_chunks/{PkToolShowForm-Dmyn6cMU.js.map → PkToolShowForm-C4JnalBU.js.map} +1 -1
  89. package/dist-vue/_chunks/{PkToolShowImageGallery-XZiRk6FK.js → PkToolShowImageGallery-ORfqyhhh.js} +2 -2
  90. package/dist-vue/_chunks/{PkToolShowImageGallery-XZiRk6FK.js.map → PkToolShowImageGallery-ORfqyhhh.js.map} +1 -1
  91. package/dist-vue/_chunks/{PkToolShowProductList-DzvPUdbo.js → PkToolShowProductList-C9kbfutK.js} +2 -2
  92. package/dist-vue/_chunks/{PkToolShowProductList-DzvPUdbo.js.map → PkToolShowProductList-C9kbfutK.js.map} +1 -1
  93. package/dist-vue/_chunks/{PkToolShowSources-NOSBkQCi.js → PkToolShowSources-BVfcp1iE.js} +3 -3
  94. package/dist-vue/_chunks/{PkToolShowSources-NOSBkQCi.js.map → PkToolShowSources-BVfcp1iE.js.map} +1 -1
  95. package/dist-vue/_chunks/{PkToolShowSuggestedReply-C7dUB3dz.js → PkToolShowSuggestedReply-Bb7Inxa4.js} +2 -2
  96. package/dist-vue/_chunks/{PkToolShowSuggestedReply-C7dUB3dz.js.map → PkToolShowSuggestedReply-Bb7Inxa4.js.map} +1 -1
  97. package/dist-vue/_chunks/{PkToolShowVideo-sSZyISJH.js → PkToolShowVideo-CUNITpHh.js} +2 -2
  98. package/dist-vue/_chunks/{PkToolShowVideo-sSZyISJH.js.map → PkToolShowVideo-CUNITpHh.js.map} +1 -1
  99. package/dist-vue/_chunks/{PkToolShowWebPages-B1c4X_cH.js → PkToolShowWebPages-C-yl2smm.js} +2 -2
  100. package/dist-vue/_chunks/{PkToolShowWebPages-B1c4X_cH.js.map → PkToolShowWebPages-C-yl2smm.js.map} +1 -1
  101. package/dist-vue/_chunks/{createChatbotApiClient-BmBo5IQR.js → createChatbotApiClient-CuqGJGHD.js} +2 -2
  102. package/dist-vue/_chunks/createChatbotApiClient-CuqGJGHD.js.map +1 -0
  103. package/dist-vue/_chunks/{useChatbotStore-D7ZMA7Tr.js → useChatbotStore-C1lW6qXE.js} +1143 -1134
  104. package/dist-vue/_chunks/useChatbotStore-C1lW6qXE.js.map +1 -0
  105. package/dist-vue/_chunks/{utils-CKsn0vxx.js → utils-CoLdYTZq.js} +2 -2
  106. package/dist-vue/_chunks/{utils-CKsn0vxx.js.map → utils-CoLdYTZq.js.map} +1 -1
  107. package/dist-vue/api.js +1 -1
  108. package/dist-vue/apps/web-component/src/components/EmbeddedChatWidget.ce.d.ts +4 -4
  109. package/dist-vue/apps/web-component/src/composables/useChatbotAgent.d.ts +2 -0
  110. package/dist-vue/apps/web-component/src/composables/useChatbotAuth.d.ts +3 -3
  111. package/dist-vue/apps/web-component/src/composables/usePagePointer.d.ts +50 -0
  112. package/dist-vue/apps/web-component/src/composables/usePageTools.d.ts +21 -0
  113. package/dist-vue/apps/web-component/src/pageTools/index.d.ts +8 -1
  114. package/dist-vue/apps/web-component/src/pageTools/pointing.d.ts +41 -0
  115. package/dist-vue/apps/web-component/src/pageTools/snapshot.d.ts +2 -0
  116. package/dist-vue/composables.js +24 -8
  117. package/dist-vue/composables.js.map +1 -1
  118. package/dist-vue/index.js +47 -30
  119. package/dist-vue/index.js.map +1 -1
  120. package/dist-vue/locales.js +20 -0
  121. package/dist-vue/packages/components/src/chat/PkAgentPageAccessSettings.d.ts +2 -0
  122. package/dist-vue/packages/components/src/chat/PkAgentSettingsPanel.d.ts +2 -0
  123. package/dist-vue/packages/components/src/chat/PkChatbotInput.d.ts +16 -3
  124. package/dist-vue/packages/components/src/chat/PkPagePointer.d.ts +41 -0
  125. package/dist-vue/packages/composable/src/chatbot/useChatbotStore.d.ts +150 -6
  126. package/dist-vue/packages/models/src/schema/Agent.d.ts +7 -0
  127. package/dist-vue/packages/models/src/schema/Chat.d.ts +8 -0
  128. package/dist-vue/packages/models/src/schema/PageAccess.d.ts +29 -1
  129. package/dist-vue/packages/models/src/schema/ReasoningChat.d.ts +2 -0
  130. package/dist-vue/packages/models/src/schema/SubAgent.d.ts +2 -0
  131. package/dist-vue/style.css +1 -1
  132. package/package.json +1 -1
  133. package/dist/_chunks/Agent-C0JtGK2t.js.map +0 -1
  134. package/dist-vue/_chunks/Agent-Dsi_xGvV.js.map +0 -1
  135. package/dist-vue/_chunks/PkChatbotInput-C1i14Ur_.js.map +0 -1
  136. package/dist-vue/_chunks/PkChatbotMessages-Ce8h0QNX.js.map +0 -1
  137. package/dist-vue/_chunks/PkChatbotViewChat-Bjw6x7VD.js.map +0 -1
  138. package/dist-vue/_chunks/createChatbotApiClient-BmBo5IQR.js.map +0 -1
  139. package/dist-vue/_chunks/useChatbotStore-D7ZMA7Tr.js.map +0 -1
@@ -191,6 +191,7 @@ var e = {
191
191
  pageAccessExcludeSelectors: "Excluded areas",
192
192
  cssSelector: "CSS selector",
193
193
  pageAccessConfirmEveryAction: "Confirm every action",
194
+ pageAccessPointer: "Point and ask",
194
195
  pageAccessNotice: "Notice to the user",
195
196
  pageAccessRisk: "What this level means",
196
197
  mimeTypeImages: "Images",
@@ -447,6 +448,7 @@ var e = {
447
448
  pageAccessExcludeSelectors: "The agent neither reads nor touches these elements and those with the data-agent-ignore attribute.",
448
449
  pageAccessExcludeSelectorsInfo: "Passwords, hidden fields and payment data are already excluded: other sensitive fields have to be marked by the site.",
449
450
  pageAccessConfirmEveryAction: "The user confirms every click and every write, not only submits and page changes.",
451
+ pageAccessPointer: "A button in the chat input to point at an element of the page, or select its text, and ask about it.",
450
452
  pageAccessNotice: "Empty, the widget uses the level's own text.",
451
453
  modelRetired: "No longer available on the platform: move the agents using it to another model.",
452
454
  modelNotCompatible: "Not compatible with the privacy flags of this agent.",
@@ -771,6 +773,14 @@ var e = {
771
773
  resetSentTitle: "Check your email",
772
774
  resetSent: "If an account exists with this email, you will receive a password reset link."
773
775
  },
776
+ pagePointer: {
777
+ remove: "Remove",
778
+ start: "Point at the page",
779
+ selected: "Text selected on the page",
780
+ pointed: "Pointed at on the page",
781
+ hint: "Click an element of the page",
782
+ ask: "Ask"
783
+ },
774
784
  toolApproval: {
775
785
  hostCall: "The agent wants to use “{name}”. Allow it?",
776
786
  prompt: "Your confirmation is needed to continue:",
@@ -1057,6 +1067,7 @@ var e = {
1057
1067
  pageAccessExcludeSelectors: "Zone escluse",
1058
1068
  cssSelector: "Selettore CSS",
1059
1069
  pageAccessConfirmEveryAction: "Conferma ogni azione",
1070
+ pageAccessPointer: "Indica e chiedi",
1060
1071
  pageAccessNotice: "Avviso all'utente",
1061
1072
  pageAccessRisk: "Cosa comporta questo livello",
1062
1073
  mimeTypeImages: "Immagini",
@@ -1313,6 +1324,7 @@ var e = {
1313
1324
  pageAccessExcludeSelectors: "L'agente non legge né tocca questi elementi e quelli con l'attributo data-agent-ignore.",
1314
1325
  pageAccessExcludeSelectorsInfo: "Password, campi nascosti e dati di pagamento sono già esclusi: gli altri campi sensibili li deve marcare il sito.",
1315
1326
  pageAccessConfirmEveryAction: "L'utente conferma ogni clic e ogni scrittura, non solo gli invii e i cambi di pagina.",
1327
+ pageAccessPointer: "Un pulsante nel campo della chat per indicare un elemento della pagina, o selezionarne il testo, e chiedere.",
1316
1328
  pageAccessNotice: "Vuoto, il widget usa il testo del livello.",
1317
1329
  modelRetired: "Non più disponibile sulla piattaforma: sposta su un altro modello gli agenti che lo usano.",
1318
1330
  modelNotCompatible: "Non compatibile con i flag di riservatezza di questo agente.",
@@ -1637,6 +1649,14 @@ var e = {
1637
1649
  resetSentTitle: "Controlla la tua email",
1638
1650
  resetSent: "Se esiste un account con questa email, riceverai un link per reimpostare la password."
1639
1651
  },
1652
+ pagePointer: {
1653
+ remove: "Togli",
1654
+ start: "Indica sulla pagina",
1655
+ selected: "Testo selezionato sulla pagina",
1656
+ pointed: "Indicato sulla pagina",
1657
+ hint: "Fai clic su un elemento della pagina",
1658
+ ask: "Chiedi"
1659
+ },
1640
1660
  toolApproval: {
1641
1661
  hostCall: "L'agente vuole usare «{name}». Consenti?",
1642
1662
  prompt: "Per continuare serve la tua conferma:",
@@ -19,6 +19,7 @@ declare const __VLS_export: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, C
19
19
  level: PageAccessLevel;
20
20
  excludeSelectors: string[];
21
21
  confirmEveryAction: boolean;
22
+ pointer: boolean;
22
23
  notice?: Record<string, string> | undefined;
23
24
  acknowledgedBy?: string | undefined;
24
25
  acknowledgedAt?: Date | undefined;
@@ -29,6 +30,7 @@ declare const __VLS_export: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, C
29
30
  level: PageAccessLevel;
30
31
  excludeSelectors: string[];
31
32
  confirmEveryAction: boolean;
33
+ pointer: boolean;
32
34
  notice?: Record<string, string> | undefined;
33
35
  acknowledgedBy?: string | undefined;
34
36
  acknowledgedAt?: Date | undefined;
@@ -403,6 +403,7 @@ declare const __VLS_base: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Com
403
403
  level: PageAccessLevel;
404
404
  excludeSelectors: string[];
405
405
  confirmEveryAction: boolean;
406
+ pointer: boolean;
406
407
  notice?: Record<string, string> | undefined;
407
408
  acknowledgedBy?: string | undefined;
408
409
  acknowledgedAt?: Date | undefined;
@@ -672,6 +673,7 @@ declare const __VLS_base: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, Com
672
673
  level: PageAccessLevel;
673
674
  excludeSelectors: string[];
674
675
  confirmEveryAction: boolean;
676
+ pointer: boolean;
675
677
  notice?: Record<string, string> | undefined;
676
678
  acknowledgedBy?: string | undefined;
677
679
  acknowledgedAt?: Date | undefined;
@@ -26,17 +26,26 @@ type __VLS_Props = {
26
26
  id: string;
27
27
  text: string;
28
28
  }[];
29
+ /** The user may point at the page that embeds the chat: the button shows. */
30
+ pointerAvailable?: boolean;
31
+ /** The user is pointing at the page now. */
32
+ pointing?: boolean;
33
+ /** What the user pointed at for this message: the chip above the field. */
34
+ pointer?: {
35
+ kind: 'element' | 'text';
36
+ label: string;
37
+ };
29
38
  };
30
39
  type __VLS_ModelProps = {
31
40
  modelValue?: string | undefined;
32
41
  'pendingAttachments'?: PendingAttachment[];
33
42
  };
34
43
  type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
35
- declare var __VLS_32: {}, __VLS_73: {};
44
+ declare var __VLS_44: {}, __VLS_85: {};
36
45
  type __VLS_Slots = {} & {
37
- prepend?: (props: typeof __VLS_32) => any;
46
+ prepend?: (props: typeof __VLS_44) => any;
38
47
  } & {
39
- 'additional-actions'?: (props: typeof __VLS_73) => any;
48
+ 'additional-actions'?: (props: typeof __VLS_85) => any;
40
49
  };
41
50
  declare const __VLS_base: DefineComponent<__VLS_PublicProps, {
42
51
  /** Move the focus to the message field */
@@ -52,6 +61,8 @@ declare const __VLS_base: DefineComponent<__VLS_PublicProps, {
52
61
  "open-answer-notice": (id: string) => any;
53
62
  "dismiss-answer-notice": (id: string) => any;
54
63
  "voice-start": () => any;
64
+ point: () => any;
65
+ "remove-pointer": () => any;
55
66
  }, string, PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
56
67
  "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
57
68
  onSubmit?: (() => any) | undefined;
@@ -63,6 +74,8 @@ declare const __VLS_base: DefineComponent<__VLS_PublicProps, {
63
74
  "onOpen-answer-notice"?: ((id: string) => any) | undefined;
64
75
  "onDismiss-answer-notice"?: ((id: string) => any) | undefined;
65
76
  "onVoice-start"?: (() => any) | undefined;
77
+ onPoint?: (() => any) | undefined;
78
+ "onRemove-pointer"?: (() => any) | undefined;
66
79
  }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
67
80
  declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
68
81
  declare const _default: typeof __VLS_export;
@@ -0,0 +1,41 @@
1
+ import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
2
+ /**
3
+ * The user pointing at the page that embeds the widget (spec
4
+ * `page-point-and-choose.md`, P): the bar that says what to do, the box on
5
+ * the element that would be chosen, and the bubble next to a text the user
6
+ * selected. Fixed on the page, next to the chat and not inside it, as the
7
+ * page control bar: a transformed ancestor would pin it to itself. While
8
+ * the user points, a clear layer over the whole window takes the pointer,
9
+ * so no event of the gesture reaches the site, whatever it listens to; the
10
+ * widget finds what lies under the layer at each point.
11
+ */
12
+ type __VLS_Props = {
13
+ /** The user is choosing an element: the bar and the box show. */
14
+ picking: boolean;
15
+ /** The element under the pointer, where the box goes, and its name. */
16
+ box?: {
17
+ top: number;
18
+ left: number;
19
+ width: number;
20
+ height: number;
21
+ label: string;
22
+ };
23
+ /** Where the bubble of a selected text goes. */
24
+ bubble?: {
25
+ top: number;
26
+ left: number;
27
+ };
28
+ };
29
+ declare const __VLS_export: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
30
+ cancel: () => any;
31
+ move: (x: number, y: number) => any;
32
+ ask: () => any;
33
+ press: (x: number, y: number) => any;
34
+ }, string, PublicProps, Readonly<__VLS_Props> & Readonly<{
35
+ onCancel?: (() => any) | undefined;
36
+ onMove?: ((x: number, y: number) => any) | undefined;
37
+ onAsk?: (() => any) | undefined;
38
+ onPress?: ((x: number, y: number) => any) | undefined;
39
+ }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
40
+ declare const _default: typeof __VLS_export;
41
+ export default _default;
@@ -1,5 +1,5 @@
1
1
  import { FileUIPart, ChatStatus, ChatRequestOptions, ChatAddToolOutputFunction, ChatAddToolApproveResponseFunction, ProviderMetadata, LanguageModelUsage } from 'ai';
2
- import { PageAccessLevel, Chat as ChatRecord, ChatMessageActions, UIChatMessage, AgentWidgetLayout, AgentWidgetAppearance, AgentLoaderStrategy, StoragePolicy, AgentSearchMode, AgentBuiltInTool, WebSearchProvider, UIChatMessageMetadata, PlatformType, ToolGroupKind, BlockedReasonCode, ConversationAnalysisTrigger, Sentiment, SentimentTrend, UserTone, AbuseCategory, LlmIssueCategory, UserEngagement, AbuseConfidence, UserFileKind } from '../../../models/src';
2
+ import { PageAccessLevel, Chat as ChatRecord, ChatMessageActions, UIChatMessage, UIChatMessageMetadata, AgentWidgetLayout, AgentWidgetAppearance, AgentLoaderStrategy, StoragePolicy, AgentSearchMode, AgentBuiltInTool, WebSearchProvider, PlatformType, ToolGroupKind, BlockedReasonCode, ConversationAnalysisTrigger, Sentiment, SentimentTrend, UserTone, AbuseCategory, LlmIssueCategory, UserEngagement, AbuseConfidence, UserFileKind } from '../../../models/src';
3
3
  import { HostToolConfirmation, RegisteredHostTool } from './hostTools';
4
4
  import { ChatbotFile } from './api';
5
5
  import { PendingAttachment } from './types';
@@ -601,11 +601,13 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
601
601
  excludeSelectors: string[];
602
602
  confirmEveryAction: boolean;
603
603
  notice?: Record<string, string> | undefined;
604
+ pointer?: boolean | undefined;
604
605
  } | undefined, {
605
606
  level: PageAccessLevel;
606
607
  excludeSelectors: string[];
607
608
  confirmEveryAction: boolean;
608
609
  notice?: Record<string, string> | undefined;
610
+ pointer?: boolean | undefined;
609
611
  } | undefined>;
610
612
  pageToolRegistry: globalThis.ShallowRef<RegisteredHostTool[] | undefined>;
611
613
  pageFormsProvider: globalThis.ShallowRef<(() => RegisteredHostTool[]) | undefined>;
@@ -623,7 +625,7 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
623
625
  forms: boolean;
624
626
  }) => {
625
627
  version: 1;
626
- features: "fill-fields"[];
628
+ features: ("fill-fields" | "fill-choose")[];
627
629
  forms: {
628
630
  name: string;
629
631
  description: string | undefined;
@@ -650,6 +652,30 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
650
652
  pageAccessAvailable: globalThis.ComputedRef<boolean>;
651
653
  pageAccessOff: globalThis.Ref<boolean, boolean>;
652
654
  setPageAccessOff: (off: boolean) => Promise<void>;
655
+ pagePointer: globalThis.Ref<{
656
+ kind: "text" | "element";
657
+ label: string;
658
+ line: string;
659
+ context: string;
660
+ page: {
661
+ title: string;
662
+ path: string;
663
+ };
664
+ text?: string | undefined;
665
+ } | undefined, {
666
+ kind: "text" | "element";
667
+ label: string;
668
+ line: string;
669
+ context: string;
670
+ page: {
671
+ title: string;
672
+ path: string;
673
+ };
674
+ text?: string | undefined;
675
+ } | undefined>;
676
+ pagePointerStart: globalThis.ShallowRef<(() => void) | undefined>;
677
+ pagePointing: globalThis.Ref<boolean, boolean>;
678
+ pagePointerAvailable: globalThis.ComputedRef<boolean>;
653
679
  systemTheme: globalThis.Ref<"light" | "dark" | undefined, "light" | "dark" | undefined>;
654
680
  hideWelcomeMessage: globalThis.Ref<boolean, boolean>;
655
681
  isDark: globalThis.ComputedRef<boolean>;
@@ -789,6 +815,17 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
789
815
  iteration: number;
790
816
  reason: string;
791
817
  } | undefined;
818
+ pagePointer?: {
819
+ kind: "text" | "element";
820
+ label: string;
821
+ line: string;
822
+ context: string;
823
+ page: {
824
+ title: string;
825
+ path: string;
826
+ };
827
+ text?: string | undefined;
828
+ } | undefined;
792
829
  } | undefined;
793
830
  parts: ({
794
831
  type: "text";
@@ -1344,6 +1381,17 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
1344
1381
  iteration: number;
1345
1382
  reason: string;
1346
1383
  } | undefined;
1384
+ pagePointer?: {
1385
+ kind: "text" | "element";
1386
+ label: string;
1387
+ line: string;
1388
+ context: string;
1389
+ page: {
1390
+ title: string;
1391
+ path: string;
1392
+ };
1393
+ text?: string | undefined;
1394
+ } | undefined;
1347
1395
  } | undefined;
1348
1396
  parts: ({
1349
1397
  type: "text";
@@ -2005,7 +2053,7 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
2005
2053
  focusInput: () => void;
2006
2054
  renameChatTitle: (chatId: string, title: string) => Promise<void>;
2007
2055
  deleteChat: (chatId: string) => Promise<void>;
2008
- }, "name" | "input" | "model" | "externalContext" | "gatewayOptions" | "fallbackModels" | "userId" | "agentId" | "headers" | "conversations" | "agentModel" | "agentType" | "baseUrl" | "basePath" | "agentInterface" | "agentTools" | "revisedAnswers" | "actionsInput" | "agentFileUpload" | "agentVoice" | "agentHostTools" | "hostToolRegistry" | "hostToolsPending" | "agentPageAccess" | "pageToolRegistry" | "pageFormsProvider" | "pageAction" | "hostStepTitles" | "pageControlActive" | "isWorking" | "hostConfirmation" | "pageAccessOff" | "systemTheme" | "hideWelcomeMessage" | "isLoadingConversations" | "hasMoreConversations" | "isLoadingMoreConversations" | "chatFiles" | "isLoadingChatFiles" | "pendingAttachments" | "fileLimitError" | "isConversationBlocked" | "chatError" | "activeView" | "inputFocusRequest" | "messageFeedbacks" | "feedbackDialogMessage" | "isFeedbackSubmitting" | "isFeedbackSubmitted" | "feedbackSubmitError" | "isLeadSubmitted" | "isLoadingSubmitLead" | "submitLeadError">, Pick<{
2056
+ }, "name" | "input" | "model" | "externalContext" | "gatewayOptions" | "fallbackModels" | "userId" | "agentId" | "headers" | "conversations" | "agentModel" | "agentType" | "baseUrl" | "pagePointer" | "basePath" | "agentInterface" | "agentTools" | "revisedAnswers" | "actionsInput" | "agentFileUpload" | "agentVoice" | "agentHostTools" | "hostToolRegistry" | "hostToolsPending" | "agentPageAccess" | "pageToolRegistry" | "pageFormsProvider" | "pageAction" | "hostStepTitles" | "pageControlActive" | "isWorking" | "hostConfirmation" | "pageAccessOff" | "pagePointerStart" | "pagePointing" | "systemTheme" | "hideWelcomeMessage" | "isLoadingConversations" | "hasMoreConversations" | "isLoadingMoreConversations" | "chatFiles" | "isLoadingChatFiles" | "pendingAttachments" | "fileLimitError" | "isConversationBlocked" | "chatError" | "activeView" | "inputFocusRequest" | "messageFeedbacks" | "feedbackDialogMessage" | "isFeedbackSubmitting" | "isFeedbackSubmitted" | "feedbackSubmitError" | "isLeadSubmitted" | "isLoadingSubmitLead" | "submitLeadError">, Pick<{
2009
2057
  apiClient: globalThis.ComputedRef< ChatbotApiClient>;
2010
2058
  baseUrl: globalThis.Ref<string, string>;
2011
2059
  basePath: globalThis.Ref<string | undefined, string | undefined>;
@@ -2566,11 +2614,13 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
2566
2614
  excludeSelectors: string[];
2567
2615
  confirmEveryAction: boolean;
2568
2616
  notice?: Record<string, string> | undefined;
2617
+ pointer?: boolean | undefined;
2569
2618
  } | undefined, {
2570
2619
  level: PageAccessLevel;
2571
2620
  excludeSelectors: string[];
2572
2621
  confirmEveryAction: boolean;
2573
2622
  notice?: Record<string, string> | undefined;
2623
+ pointer?: boolean | undefined;
2574
2624
  } | undefined>;
2575
2625
  pageToolRegistry: globalThis.ShallowRef<RegisteredHostTool[] | undefined>;
2576
2626
  pageFormsProvider: globalThis.ShallowRef<(() => RegisteredHostTool[]) | undefined>;
@@ -2588,7 +2638,7 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
2588
2638
  forms: boolean;
2589
2639
  }) => {
2590
2640
  version: 1;
2591
- features: "fill-fields"[];
2641
+ features: ("fill-fields" | "fill-choose")[];
2592
2642
  forms: {
2593
2643
  name: string;
2594
2644
  description: string | undefined;
@@ -2615,6 +2665,30 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
2615
2665
  pageAccessAvailable: globalThis.ComputedRef<boolean>;
2616
2666
  pageAccessOff: globalThis.Ref<boolean, boolean>;
2617
2667
  setPageAccessOff: (off: boolean) => Promise<void>;
2668
+ pagePointer: globalThis.Ref<{
2669
+ kind: "text" | "element";
2670
+ label: string;
2671
+ line: string;
2672
+ context: string;
2673
+ page: {
2674
+ title: string;
2675
+ path: string;
2676
+ };
2677
+ text?: string | undefined;
2678
+ } | undefined, {
2679
+ kind: "text" | "element";
2680
+ label: string;
2681
+ line: string;
2682
+ context: string;
2683
+ page: {
2684
+ title: string;
2685
+ path: string;
2686
+ };
2687
+ text?: string | undefined;
2688
+ } | undefined>;
2689
+ pagePointerStart: globalThis.ShallowRef<(() => void) | undefined>;
2690
+ pagePointing: globalThis.Ref<boolean, boolean>;
2691
+ pagePointerAvailable: globalThis.ComputedRef<boolean>;
2618
2692
  systemTheme: globalThis.Ref<"light" | "dark" | undefined, "light" | "dark" | undefined>;
2619
2693
  hideWelcomeMessage: globalThis.Ref<boolean, boolean>;
2620
2694
  isDark: globalThis.ComputedRef<boolean>;
@@ -2754,6 +2828,17 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
2754
2828
  iteration: number;
2755
2829
  reason: string;
2756
2830
  } | undefined;
2831
+ pagePointer?: {
2832
+ kind: "text" | "element";
2833
+ label: string;
2834
+ line: string;
2835
+ context: string;
2836
+ page: {
2837
+ title: string;
2838
+ path: string;
2839
+ };
2840
+ text?: string | undefined;
2841
+ } | undefined;
2757
2842
  } | undefined;
2758
2843
  parts: ({
2759
2844
  type: "text";
@@ -3309,6 +3394,17 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
3309
3394
  iteration: number;
3310
3395
  reason: string;
3311
3396
  } | undefined;
3397
+ pagePointer?: {
3398
+ kind: "text" | "element";
3399
+ label: string;
3400
+ line: string;
3401
+ context: string;
3402
+ page: {
3403
+ title: string;
3404
+ path: string;
3405
+ };
3406
+ text?: string | undefined;
3407
+ } | undefined;
3312
3408
  } | undefined;
3313
3409
  parts: ({
3314
3410
  type: "text";
@@ -3970,7 +4066,7 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
3970
4066
  focusInput: () => void;
3971
4067
  renameChatTitle: (chatId: string, title: string) => Promise<void>;
3972
4068
  deleteChat: (chatId: string) => Promise<void>;
3973
- }, "messages" | "chat" | "actions" | "apiClient" | "pageNoticeLevel" | "pageAccessAvailable" | "isDark" | "isAttachmentLimitReached" | "localChatId" | "inputMessagePlaceholder" | "runningChatIds" | "backgroundAnswers" | "canQueue" | "queuedMessages">, Pick<{
4069
+ }, "messages" | "chat" | "actions" | "apiClient" | "pageNoticeLevel" | "pageAccessAvailable" | "pagePointerAvailable" | "isDark" | "isAttachmentLimitReached" | "localChatId" | "inputMessagePlaceholder" | "runningChatIds" | "backgroundAnswers" | "canQueue" | "queuedMessages">, Pick<{
3974
4070
  apiClient: globalThis.ComputedRef< ChatbotApiClient>;
3975
4071
  baseUrl: globalThis.Ref<string, string>;
3976
4072
  basePath: globalThis.Ref<string | undefined, string | undefined>;
@@ -4531,11 +4627,13 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
4531
4627
  excludeSelectors: string[];
4532
4628
  confirmEveryAction: boolean;
4533
4629
  notice?: Record<string, string> | undefined;
4630
+ pointer?: boolean | undefined;
4534
4631
  } | undefined, {
4535
4632
  level: PageAccessLevel;
4536
4633
  excludeSelectors: string[];
4537
4634
  confirmEveryAction: boolean;
4538
4635
  notice?: Record<string, string> | undefined;
4636
+ pointer?: boolean | undefined;
4539
4637
  } | undefined>;
4540
4638
  pageToolRegistry: globalThis.ShallowRef<RegisteredHostTool[] | undefined>;
4541
4639
  pageFormsProvider: globalThis.ShallowRef<(() => RegisteredHostTool[]) | undefined>;
@@ -4553,7 +4651,7 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
4553
4651
  forms: boolean;
4554
4652
  }) => {
4555
4653
  version: 1;
4556
- features: "fill-fields"[];
4654
+ features: ("fill-fields" | "fill-choose")[];
4557
4655
  forms: {
4558
4656
  name: string;
4559
4657
  description: string | undefined;
@@ -4580,6 +4678,30 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
4580
4678
  pageAccessAvailable: globalThis.ComputedRef<boolean>;
4581
4679
  pageAccessOff: globalThis.Ref<boolean, boolean>;
4582
4680
  setPageAccessOff: (off: boolean) => Promise<void>;
4681
+ pagePointer: globalThis.Ref<{
4682
+ kind: "text" | "element";
4683
+ label: string;
4684
+ line: string;
4685
+ context: string;
4686
+ page: {
4687
+ title: string;
4688
+ path: string;
4689
+ };
4690
+ text?: string | undefined;
4691
+ } | undefined, {
4692
+ kind: "text" | "element";
4693
+ label: string;
4694
+ line: string;
4695
+ context: string;
4696
+ page: {
4697
+ title: string;
4698
+ path: string;
4699
+ };
4700
+ text?: string | undefined;
4701
+ } | undefined>;
4702
+ pagePointerStart: globalThis.ShallowRef<(() => void) | undefined>;
4703
+ pagePointing: globalThis.Ref<boolean, boolean>;
4704
+ pagePointerAvailable: globalThis.ComputedRef<boolean>;
4583
4705
  systemTheme: globalThis.Ref<"light" | "dark" | undefined, "light" | "dark" | undefined>;
4584
4706
  hideWelcomeMessage: globalThis.Ref<boolean, boolean>;
4585
4707
  isDark: globalThis.ComputedRef<boolean>;
@@ -4719,6 +4841,17 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
4719
4841
  iteration: number;
4720
4842
  reason: string;
4721
4843
  } | undefined;
4844
+ pagePointer?: {
4845
+ kind: "text" | "element";
4846
+ label: string;
4847
+ line: string;
4848
+ context: string;
4849
+ page: {
4850
+ title: string;
4851
+ path: string;
4852
+ };
4853
+ text?: string | undefined;
4854
+ } | undefined;
4722
4855
  } | undefined;
4723
4856
  parts: ({
4724
4857
  type: "text";
@@ -5274,6 +5407,17 @@ export declare function useChatbotStore(agentId: string): Store<`chatbot-${strin
5274
5407
  iteration: number;
5275
5408
  reason: string;
5276
5409
  } | undefined;
5410
+ pagePointer?: {
5411
+ kind: "text" | "element";
5412
+ label: string;
5413
+ line: string;
5414
+ context: string;
5415
+ page: {
5416
+ title: string;
5417
+ path: string;
5418
+ };
5419
+ text?: string | undefined;
5420
+ } | undefined;
5277
5421
  } | undefined;
5278
5422
  parts: ({
5279
5423
  type: "text";
@@ -1858,6 +1858,7 @@ export declare const AgentSettingsSchema: z.ZodObject<{
1858
1858
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
1859
1859
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
1860
1860
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
1861
+ pointer: z.ZodDefault<z.ZodBoolean>;
1861
1862
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1862
1863
  acknowledgedBy: z.ZodOptional<z.ZodString>;
1863
1864
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -2287,6 +2288,7 @@ export declare const AgentDtoSchema: z.ZodObject<{
2287
2288
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
2288
2289
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
2289
2290
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
2291
+ pointer: z.ZodDefault<z.ZodBoolean>;
2290
2292
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2291
2293
  acknowledgedBy: z.ZodOptional<z.ZodString>;
2292
2294
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -2717,6 +2719,7 @@ export declare const AgentSchema: z.ZodLazy<z.ZodObject<{
2717
2719
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
2718
2720
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
2719
2721
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
2722
+ pointer: z.ZodDefault<z.ZodBoolean>;
2720
2723
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2721
2724
  acknowledgedBy: z.ZodOptional<z.ZodString>;
2722
2725
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -2911,6 +2914,7 @@ export declare const AgentPublicSchema: z.ZodObject<{
2911
2914
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
2912
2915
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
2913
2916
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2917
+ pointer: z.ZodOptional<z.ZodBoolean>;
2914
2918
  }, z.core.$strip>>;
2915
2919
  }, z.core.$strip>;
2916
2920
  channels: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof AgentChannel>>>;
@@ -3160,6 +3164,7 @@ export declare const AgentAccessGrantedSchema: z.ZodObject<{
3160
3164
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
3161
3165
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
3162
3166
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
3167
+ pointer: z.ZodOptional<z.ZodBoolean>;
3163
3168
  }, z.core.$strip>>;
3164
3169
  }, z.core.$strip>;
3165
3170
  channels: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof AgentChannel>>>;
@@ -3365,6 +3370,7 @@ export declare const AgentAccessDecisionSchema: z.ZodDiscriminatedUnion<[z.ZodOb
3365
3370
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
3366
3371
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
3367
3372
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
3373
+ pointer: z.ZodOptional<z.ZodBoolean>;
3368
3374
  }, z.core.$strip>>;
3369
3375
  }, z.core.$strip>;
3370
3376
  channels: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof AgentChannel>>>;
@@ -3589,6 +3595,7 @@ export declare const AgentAccessSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
3589
3595
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
3590
3596
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
3591
3597
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
3598
+ pointer: z.ZodOptional<z.ZodBoolean>;
3592
3599
  }, z.core.$strip>>;
3593
3600
  }, z.core.$strip>;
3594
3601
  channels: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof AgentChannel>>>;
@@ -1,5 +1,6 @@
1
1
  import { UIMessage, LanguageModelUsage } from 'ai';
2
2
  import { AgentBuiltInTool, AgentSearchMode, WebSearchProvider } from './Agent';
3
+ import { PagePointer } from './PageAccess';
3
4
  import { PlatformContext } from './Platform';
4
5
  import { DeviceContextSchema, DeviceContext } from './DeviceContext';
5
6
  import { ConversationAnalysisTrigger, Sentiment, SentimentTrend, UserTone, AbuseCategory, AbuseConfidence, LlmIssueCategory, UserEngagement } from './ConversationAnalysis';
@@ -513,6 +514,13 @@ export type UIChatMessageMetadata = {
513
514
  * is the prompt the agent left for itself, not words the user typed.
514
515
  */
515
516
  wakeup?: UIChatMessageWakeup;
517
+ /**
518
+ * What the user pointed at on the page with this message (spec
519
+ * `page-point-and-choose.md`, P). The backend keeps it only from a
520
+ * widget that reads the page, and the model reads it as text after the
521
+ * message's own.
522
+ */
523
+ pagePointer?: PagePointer;
516
524
  };
517
525
  /** The wakeup a seed message belongs to (spec agent-wakeup). */
518
526
  export type UIChatMessageWakeup = {
@@ -24,6 +24,7 @@ export declare const PageAccessSettingsSchema: z.ZodObject<{
24
24
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
25
25
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
26
26
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
27
+ pointer: z.ZodDefault<z.ZodBoolean>;
27
28
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
28
29
  acknowledgedBy: z.ZodOptional<z.ZodString>;
29
30
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -53,6 +54,7 @@ export declare const PageAccessCapabilitySchema: z.ZodObject<{
53
54
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
54
55
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
55
56
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
57
+ pointer: z.ZodOptional<z.ZodBoolean>;
56
58
  }, z.core.$strip>;
57
59
  export type PageAccessCapability = z.infer<typeof PageAccessCapabilitySchema>;
58
60
  /**
@@ -60,9 +62,35 @@ export type PageAccessCapability = z.infer<typeof PageAccessCapabilitySchema>;
60
62
  * only to the widgets that declare it, so a page still on an older bundle
61
63
  * (a tab open across a deploy, a cached embed) never gets a call it cannot
62
64
  * run. `fill-fields`: `page_fill` writes several fields in one call.
65
+ * `fill-choose`: `page_fill` chooses the option of a list a field opens
66
+ * (spec `page-point-and-choose.md`, C).
63
67
  */
64
- export declare const PAGE_TOOL_FEATURES: readonly ["fill-fields"];
68
+ export declare const PAGE_TOOL_FEATURES: readonly ["fill-fields", "fill-choose"];
65
69
  export type PageToolFeature = (typeof PAGE_TOOL_FEATURES)[number];
70
+ /**
71
+ * What the user pointed at on the page while writing a message (spec
72
+ * `page-point-and-choose.md`, P): an element, or a text they selected and
73
+ * the element it is in. The widget reads it the way `page_snapshot` reads
74
+ * the page, with the same refs, so the model acts on it without reading the
75
+ * page again. It travels on the user message's metadata; the backend keeps
76
+ * it only from a widget that reads the page, and gives the model a text of
77
+ * it. The limits are above the widget's own, with room for the quoting.
78
+ */
79
+ export declare const PagePointerSchema: z.ZodObject<{
80
+ kind: z.ZodEnum<{
81
+ text: "text";
82
+ element: "element";
83
+ }>;
84
+ label: z.ZodString;
85
+ line: z.ZodString;
86
+ context: z.ZodString;
87
+ text: z.ZodOptional<z.ZodString>;
88
+ page: z.ZodObject<{
89
+ title: z.ZodString;
90
+ path: z.ZodString;
91
+ }, z.core.$strip>;
92
+ }, z.core.$strip>;
93
+ export type PagePointer = z.infer<typeof PagePointerSchema>;
66
94
  /** What a request declares when the widget can run page tools. */
67
95
  export declare const PageToolsRequestSchema: z.ZodObject<{
68
96
  version: z.ZodLiteral<1>;
@@ -430,6 +430,7 @@ export declare const ReasoningChatSchema: z.ZodObject<{
430
430
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
431
431
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
432
432
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
433
+ pointer: z.ZodDefault<z.ZodBoolean>;
433
434
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
434
435
  acknowledgedBy: z.ZodOptional<z.ZodString>;
435
436
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -912,6 +913,7 @@ export declare const ReasoningChatSchema: z.ZodObject<{
912
913
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
913
914
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
914
915
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
916
+ pointer: z.ZodDefault<z.ZodBoolean>;
915
917
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
916
918
  acknowledgedBy: z.ZodOptional<z.ZodString>;
917
919
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -430,6 +430,7 @@ export declare const SubAgentSchema: z.ZodObject<{
430
430
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
431
431
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
432
432
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
433
+ pointer: z.ZodDefault<z.ZodBoolean>;
433
434
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
434
435
  acknowledgedBy: z.ZodOptional<z.ZodString>;
435
436
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -869,6 +870,7 @@ export declare const SubAgentSchema: z.ZodObject<{
869
870
  level: z.ZodDefault<z.ZodEnum<typeof PageAccessLevel>>;
870
871
  excludeSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
871
872
  confirmEveryAction: z.ZodDefault<z.ZodBoolean>;
873
+ pointer: z.ZodDefault<z.ZodBoolean>;
872
874
  notice: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
873
875
  acknowledgedBy: z.ZodOptional<z.ZodString>;
874
876
  acknowledgedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;