fuli-context 0.23.0-beta.8 → 0.23.0

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 (505) hide show
  1. package/dist/web/assets/{AboutPage-BHbNacTY.js → AboutPage-S8QFfzpA.js} +1 -1
  2. package/dist/web/assets/AboutSectionHeading-B5CzH4Zs.js +1 -0
  3. package/dist/web/assets/AboutSectionHeading-DjXpIV27.css +1 -0
  4. package/dist/web/assets/AgentAppsPage-BYXraPFM.js +1 -0
  5. package/dist/web/assets/{AgentHand-BGzGOjzl.js → AgentHand-BGGdVdd9.js} +1 -1
  6. package/dist/web/assets/AgentManagement-Bza8k5ra.js +7 -0
  7. package/dist/web/assets/AgentManagement-CeF4mjtg.css +1 -0
  8. package/dist/web/assets/AgentMentionCopy-C72hY2QL.js +1 -0
  9. package/dist/web/assets/{AgentName-C5HzUHaA.js → AgentName-CUjBNQ8j.js} +1 -1
  10. package/dist/web/assets/AgentProfilePage-D5QUzw5N.css +1 -0
  11. package/dist/web/assets/AgentProfilePage-kp7-gRRx.js +5 -0
  12. package/dist/web/assets/AgentServicesPage-IsGaz7FY.js +1 -0
  13. package/dist/web/assets/{AppViewerPage-N5C_6WLz.css → AppViewerPage-CJ0Zy6LA.css} +1 -1
  14. package/dist/web/assets/AppViewerPage-CcOlwxck.js +1 -0
  15. package/dist/web/assets/{BackToTop-SL4ai3_g.js → BackToTop-C3KYEoCW.js} +1 -1
  16. package/dist/web/assets/BoardCardFieldsMenu-BlBWT1j7.js +1 -0
  17. package/dist/web/assets/BoardMoveMenu-Bc7xC1Uh.js +1 -0
  18. package/dist/web/assets/Breadcrumb-BbwBNrG2.css +1 -0
  19. package/dist/web/assets/Breadcrumb-C_xMiD-Z.js +1 -0
  20. package/dist/web/assets/CaptureChangePage-Bekp1aWg.js +1 -0
  21. package/dist/web/assets/ConnectionsPage-BpvecWXD.js +1 -0
  22. package/dist/web/assets/{CopyFixPrompt-CCrPxN5x.js → CopyFixPrompt-Bp-UX4Hq.js} +1 -1
  23. package/dist/web/assets/DataFormatPage-dsy8d3oA.js +2 -0
  24. package/dist/web/assets/DataFormatPage-sSnjjUY4.css +1 -0
  25. package/dist/web/assets/DebugTurnPage-HdFAyc2D.css +1 -0
  26. package/dist/web/assets/DebugTurnPage-cIJV7xDW.js +1 -0
  27. package/dist/web/assets/DebugTurnsPage-B6Te_Alp.js +1 -0
  28. package/dist/web/assets/DebugTurnsPage-BFuOzyWR.css +1 -0
  29. package/dist/web/assets/{DialogTitle-CTKjDGQc.js → DialogTitle-Lj5s6nwG.js} +1 -1
  30. package/dist/web/assets/EmployeeRedirectPage-DnvwJeCN.js +1 -0
  31. package/dist/web/assets/EmployeeScopeDialog-CXNZ62Ab.js +1 -0
  32. package/dist/web/assets/EmployeeWorkbench-BhReI8l6.css +1 -0
  33. package/dist/web/assets/EmployeeWorkbench-DALIO-cM.js +4 -0
  34. package/dist/web/assets/FieldRoot-DRnAC66O.js +1 -0
  35. package/dist/web/assets/FlaGrowth-7wlv31Tl.js +1 -0
  36. package/dist/web/assets/FlaGrowth-BzXY8pcx.css +1 -0
  37. package/dist/web/assets/FlaTaskSheets-CNdaBy1P.js +1 -0
  38. package/dist/web/assets/FlasPage-BCs1Ffpf.js +1 -0
  39. package/dist/web/assets/{FlasPage-Cb6Q5lge.css → FlasPage-SLQDMv47.css} +1 -1
  40. package/dist/web/assets/{button-CaCh3Iim.css → GrowthLoading-CigPij0N.css} +1 -1
  41. package/dist/web/assets/GrowthLoading-Cr8xZwwO.js +1 -0
  42. package/dist/web/assets/HowtoPage-Cv1YQy1s.js +1 -0
  43. package/dist/web/assets/{HowtoPage-BRV2W1Go.css → HowtoPage-t12tDDpS.css} +1 -1
  44. package/dist/web/assets/{InboxPage-DSOmt6VL.js → InboxPage-CgJnymOY.js} +2 -2
  45. package/dist/web/assets/KnowledgeDeleteButton-FEyEvhlR.js +1 -0
  46. package/dist/web/assets/KnowledgeHardDeleteSection-CVwTeMEJ.js +1 -0
  47. package/dist/web/assets/KnowledgeItemEditPage-rwpM8cF1.js +1 -0
  48. package/dist/web/assets/{KnowledgeItemSummaryCard-D1h0e1Hn.js → KnowledgeItemSummaryCard-49EADY_Z.js} +1 -1
  49. package/dist/web/assets/KnowledgeOrganizerPage-7IdnjM3L.js +1 -0
  50. package/dist/web/assets/KnowledgePage-gxqOIZxf.js +1 -0
  51. package/dist/web/assets/KnowledgePeek-Bm5jRVA9.css +1 -0
  52. package/dist/web/assets/KnowledgePeek-CQyCxHFj.js +1 -0
  53. package/dist/web/assets/KnowledgeTurnReceiptPage-BOz7IpaK.js +1 -0
  54. package/dist/web/assets/KnowledgeWorkspace-A7zVb26p.js +4 -0
  55. package/dist/web/assets/KnowledgeWorkspace-DCoVFyf0.css +1 -0
  56. package/dist/web/assets/{MeAvatar-DHJA3h2E.js → MeAvatar-CYVcRiuW.js} +1 -1
  57. package/dist/web/assets/{MeLink-CU7zuYgD.js → MeLink-BdqkzhT6.js} +1 -1
  58. package/dist/web/assets/{MenuSeparator-DV3U0Y8_.js → MenuSeparator-quqkZZXY.js} +1 -1
  59. package/dist/web/assets/ModelSettingsPage-B8jC_uew.js +3 -0
  60. package/dist/web/assets/ModelSettingsPage-DhCn_SF6.css +1 -0
  61. package/dist/web/assets/{NotFoundPage-BMWxdf6r.js → NotFoundPage-Dmn32VWo.js} +1 -1
  62. package/dist/web/assets/OccupationsPage-BVREfX_R.js +1 -0
  63. package/dist/web/assets/OverviewPage-CHyEbdP4.js +1 -0
  64. package/dist/web/assets/OverviewPage-xdF5g6bZ.css +1 -0
  65. package/dist/web/assets/{PageColumns-D7jIeVv6.js → PageColumns-DpfaPeu7.js} +1 -1
  66. package/dist/web/assets/PageOutline-BKBQ1T4d.js +1 -0
  67. package/dist/web/assets/PageOutline-BqVgnlos.css +1 -0
  68. package/dist/web/assets/PersonalProfilePage-Cxp2gn6J.js +1 -0
  69. package/dist/web/assets/PersonalProjectsPage-821imOxR.js +1 -0
  70. package/dist/web/assets/{PinIcon-DzYhXU_p.js → PinIcon-B7dvh7ld.js} +1 -1
  71. package/dist/web/assets/{PopperContent-BnejG-fO.js → PopperContent-DNqbLkNa.js} +1 -1
  72. package/dist/web/assets/{Presence-o9BoSyBV.js → Presence-D3HKb5Hb.js} +1 -1
  73. package/dist/web/assets/ProfileAuthorChip-7HSHODdR.js +1 -0
  74. package/dist/web/assets/ProfileAuthorChip-C_0hzDoP.css +1 -0
  75. package/dist/web/assets/ProjectAgentsPage-DBsXS6Xa.js +5 -0
  76. package/dist/web/assets/{ProjectAgentsPage-Dt37ogX1.css → ProjectAgentsPage-RpfiV2Fm.css} +1 -1
  77. package/dist/web/assets/ProjectJudgmentPolicy-GA33aSRi.js +2 -0
  78. package/dist/web/assets/PublicProjectsPage-PJlBI8IE.js +1 -0
  79. package/dist/web/assets/{RoundtablesPage-C6vo4kl6.css → RoundtablesPage-DK9A9J-y.css} +1 -1
  80. package/dist/web/assets/{RoundtablesPage-B2mqkwwR.js → RoundtablesPage-DT5DUXsa.js} +2 -2
  81. package/dist/web/assets/{RovingFocusGroup-CKxT5j44.js → RovingFocusGroup-BB0d3k17.js} +1 -1
  82. package/dist/web/assets/{RovingFocusItem-Cr-XrVve.js → RovingFocusItem-CFd7tXzD.js} +1 -1
  83. package/dist/web/assets/SessionMigrationPage-BZ1lEDQr.js +1 -0
  84. package/dist/web/assets/SessionRecordsPage-BMAAtIAt.js +1 -0
  85. package/dist/web/assets/SettingsPage-BYNEk6BM.js +1 -0
  86. package/dist/web/assets/SettingsPage-Uj1IpZpS.css +1 -0
  87. package/dist/web/assets/SharedJefaReportPage-g35o6jUb.js +1 -0
  88. package/dist/web/assets/TagVocabularyPage-COubNJXz.js +1 -0
  89. package/dist/web/assets/{TaskBlockerClear-38qdj0bl.js → TaskBlockerClear-B5MpHdlh.js} +1 -1
  90. package/dist/web/assets/{TaskBlockerNotice--X8TtCGj.js → TaskBlockerNotice-CIN0HRiE.js} +1 -1
  91. package/dist/web/assets/{TaskReason-COiuiZVd.js → TaskReason-LQ0CFiKu.js} +1 -1
  92. package/dist/web/assets/{TeamCard-Bl4riuQt.css → TeamCard-CsmWDw2Q.css} +1 -1
  93. package/dist/web/assets/TeamCard-D-kLa5rT.js +1 -0
  94. package/dist/web/assets/TeamCardsWidget-DGX9k0S6.js +1 -0
  95. package/dist/web/assets/{TeamIsland-D8ycFpkZ.js → TeamIsland-BIo-l49b.js} +2 -2
  96. package/dist/web/assets/{Teleport-BAIkXp2z.js → Teleport-C1upABpY.js} +1 -1
  97. package/dist/web/assets/{TextField-BFGv0VA5.js → TextField-ZnmRqG0h.js} +1 -1
  98. package/dist/web/assets/{UiChip-h_SUumBM.js → UiChip-CizeOu1Q.js} +1 -1
  99. package/dist/web/assets/UiDialog-CGTzxn3-.js +1 -0
  100. package/dist/web/assets/{UiDisclosure-BO5EAYyS.js → UiDisclosure-ueMA4jl0.js} +1 -1
  101. package/dist/web/assets/UiIcon-sD1hUsOF.js +1 -0
  102. package/dist/web/assets/{UiIconButton-C0WP-F-p.js → UiIconButton-CCo4NPYv.js} +1 -1
  103. package/dist/web/assets/{UiNotice-NCEwjNQR.js → UiNotice-DGPFbVo7.js} +1 -1
  104. package/dist/web/assets/{UiSegmented-B49yYjJ3.js → UiSegmented-BZ-jqnPE.js} +1 -1
  105. package/dist/web/assets/{UiWeight-DRIwuLUX.js → UiWeight-BRO3oVMZ.js} +1 -1
  106. package/dist/web/assets/{VirtualDirectoryList-Dieq64pn.js → VirtualDirectoryList-BkV3gj5E.js} +1 -1
  107. package/dist/web/assets/{VisuallyHidden-DIWFV5lV.js → VisuallyHidden-B8wfJ_mU.js} +1 -1
  108. package/dist/web/assets/{VisuallyHiddenInput-WxcAZDj2.js → VisuallyHiddenInput-Bdcr9CwC.js} +1 -1
  109. package/dist/web/assets/WidgetSlot-DFojQaSo.js +2 -0
  110. package/dist/web/assets/_plugin-vue_export-helper-B9AJmZbc.js +9 -0
  111. package/dist/web/assets/{agent-apps-CXhZLNMa.js → agent-apps-CKGFfySp.js} +1 -1
  112. package/dist/web/assets/{agent-avatar-xTnj6P4n.js → agent-avatar-V6M_DF3r.js} +1 -1
  113. package/dist/web/assets/agent-occupation-PZ2YAIM8.js +1 -0
  114. package/dist/web/assets/{agent-pins-CMBM9w6b.js → agent-pins-8KX0ynzy.js} +1 -1
  115. package/dist/web/assets/agent-profile-Clb-gYu-.css +1 -0
  116. package/dist/web/assets/{agent-roster-records-pCYzR1as.js → agent-roster-records-PfAgndHp.js} +1 -1
  117. package/dist/web/assets/{agent-workflows-IeF737kp.js → agent-workflows-DQlqVOoA.js} +1 -1
  118. package/dist/web/assets/{attach-closest-edge-B34lttZK.js → attach-closest-edge-D2qlayPy.js} +1 -1
  119. package/dist/web/assets/{attention-store-BTKBC8TZ.js → attention-store-BnZ8l3kk.js} +1 -1
  120. package/dist/web/assets/{badge-Bnc2nVhV.js → badge-DX_xrLV6.js} +1 -1
  121. package/dist/web/assets/button-CEkPBC1E.js +1 -0
  122. package/dist/web/assets/button-CoXXgtY5.css +1 -0
  123. package/dist/web/assets/{card-B2JIXyum.js → card-DNQ0_6vT.js} +1 -1
  124. package/dist/web/assets/{catalog-C8eUDXUx.js → catalog-KnpBkv5t.js} +1 -1
  125. package/dist/web/assets/{checkbox-Blw3CguI.js → checkbox-DPyLHneg.js} +1 -1
  126. package/dist/web/assets/{client-AaxCWoEF.js → client-CSQcWFRh.js} +2 -2
  127. package/dist/web/assets/client-connection-model-vO2cap6a.js +1 -0
  128. package/dist/web/assets/{client-links-store-CmP5Qsfa.js → client-links-store-DMqe0MbK.js} +1 -1
  129. package/dist/web/assets/combobox-zUq9bkyM.js +1 -0
  130. package/dist/web/assets/{console-DtxpKdVW.js → console-DaoAO-EO.js} +1 -1
  131. package/dist/web/assets/{context-menu-DSGaOBX2.js → context-menu-CcGDnF_k.js} +1 -1
  132. package/dist/web/assets/{conversation-launcher-settings-DAL9Kf4y.js → conversation-launcher-settings-CXFE-q_A.js} +1 -1
  133. package/dist/web/assets/{dialog-CwFuZvhM.js → dialog-CxhKMo0D.js} +1 -1
  134. package/dist/web/assets/dist-B9GqMC5C.js +1 -0
  135. package/dist/web/assets/dist-DIJqkL4O.js +1 -0
  136. package/dist/web/assets/dropdown-menu-CXmMnCBh.js +1 -0
  137. package/dist/web/assets/field-LNsBZqam.js +1 -0
  138. package/dist/web/assets/{format-bytes-N7zRFzUD.js → format-bytes-Bqefdt37.js} +1 -1
  139. package/dist/web/assets/{identity-BUFzZs1s.js → identity-DRfhWjty.js} +1 -1
  140. package/dist/web/assets/index-B4AMPpl_.css +1 -0
  141. package/dist/web/assets/index-BYIOAXnn.js +2 -0
  142. package/dist/web/assets/{input-Db1wVnd4.js → input-UoZ-0Xne.js} +1 -1
  143. package/dist/web/assets/{label--RjFNYxb.js → label-DpjbTOxt.js} +1 -1
  144. package/dist/web/assets/label-table-BnWNYfyk.js +1 -0
  145. package/dist/web/assets/{model-crzN3PVX.js → model-13BQndfF.js} +1 -1
  146. package/dist/web/assets/{model-KuA63FiT.js → model-B5g0CFcM.js} +1 -1
  147. package/dist/web/assets/model-BYKHVgJr.js +1 -0
  148. package/dist/web/assets/{model-B5f68kqL.js → model-CDevUwUw.js} +1 -1
  149. package/dist/web/assets/model-CpuIG8Du.js +4 -0
  150. package/dist/web/assets/{model-B5dQs6Zt.js → model-P5fSGsiJ.js} +1 -1
  151. package/dist/web/assets/{model-DOf6QDiY.js → model-pJ6k3zYD.js} +1 -1
  152. package/dist/web/assets/{motion-CeLn8y1x.js → motion-C-ZimCUS.js} +1 -1
  153. package/dist/web/assets/{motion-wEp9RlID.js → motion-QY5FKKko.js} +1 -1
  154. package/dist/web/assets/{motion-preference-DfUreaML.js → motion-preference-BQiiwhab.js} +1 -1
  155. package/dist/web/assets/{occupation-catalog-Crs_Zc8R.js → occupation-catalog-uDDhZwKK.js} +1 -1
  156. package/dist/web/assets/{option-DCSIgajR.js → option-CcHPBOo6.js} +1 -1
  157. package/dist/web/assets/{orchestration-filters-Cu9KEzWE.js → orchestration-filters-DmF4Qs8E.js} +1 -1
  158. package/dist/web/assets/{page-title-Bvm24KbY.js → page-title-NXphgeQI.js} +1 -1
  159. package/dist/web/assets/{person-profile-Cf0Sytyw.js → person-profile-DXXfpvta.js} +1 -1
  160. package/dist/web/assets/popover-xSRzcSmY.js +1 -0
  161. package/dist/web/assets/popup-host-Bmvrf-2t.js +1 -0
  162. package/dist/web/assets/{profile-model-DkDH6Qth.js → profile-model-6gTmScHC.js} +1 -1
  163. package/dist/web/assets/{project-board-layout-OeuzohUI.js → project-board-layout-DBQeP_QP.js} +1 -1
  164. package/dist/web/assets/{project-capture-BQAqeAJf.js → project-capture-BhYsDWwJ.js} +1 -1
  165. package/dist/web/assets/{project-origin-CENDtRuK.js → project-origin-D8jy8EF_.js} +1 -1
  166. package/dist/web/assets/{quick-edit-api-Qndjqk1h.js → quick-edit-api-WLh_88w6.js} +1 -1
  167. package/dist/web/assets/{radio-group-pfWejLFt.js → radio-group-B4r78nDh.js} +1 -1
  168. package/dist/web/assets/{role-names-aIXV-sMx.js → role-names-PECaMfQo.js} +1 -1
  169. package/dist/web/assets/{roundtable-live-D7Asm_GB.js → roundtable-live-DFeDF56c.js} +1 -1
  170. package/dist/web/assets/{runtime-dom.esm-bundler-BS2lpl87.js → runtime-dom.esm-bundler-f39i44Mt.js} +1 -1
  171. package/dist/web/assets/save-file-rPduHi2f.js +1 -0
  172. package/dist/web/assets/select-_JO3Mxdp.js +1 -0
  173. package/dist/web/assets/{session-launch-offers-kLW-dRsW.js → session-launch-offers-X9b0DwF1.js} +1 -1
  174. package/dist/web/assets/settings-restart-BnwcTv3i.js +1 -0
  175. package/dist/web/assets/shared-report-BxNVLalR.js +3 -0
  176. package/dist/web/assets/shared-report-mYIyRY9C.css +1 -0
  177. package/dist/web/assets/{source-adapters-CUxqZHz7.js → source-adapters-aupsL146.js} +1 -1
  178. package/dist/web/assets/{switch-Cdz4-JcE.js → switch-B3Y3oE_n.js} +1 -1
  179. package/dist/web/assets/{tabs-C3w1-eMu.js → tabs-BlcZiEMY.js} +1 -1
  180. package/dist/web/assets/{task-board-model-DSr4P56O.js → task-board-model-CmMKsWdY.js} +1 -1
  181. package/dist/web/assets/task-card-fields-DAx6zMLz.js +1 -0
  182. package/dist/web/assets/task-labels-BdDFvSAy.js +1 -0
  183. package/dist/web/assets/{task-reason-BywD_kfi.js → task-reason-7WnPreht.js} +1 -1
  184. package/dist/web/assets/{team-sheets-D8Y--CP4.js → team-sheets-Cr0ZTPw3.js} +1 -1
  185. package/dist/web/assets/{textarea-C228nxbD.js → textarea-CRzFqL9a.js} +1 -1
  186. package/dist/web/assets/{ui-BM8jZcP6.js → ui-BopQuQfc.js} +1 -1
  187. package/dist/web/assets/{useAgentRecords-D7x4xQ9O.js → useAgentRecords-CMtpd3Fj.js} +1 -1
  188. package/dist/web/assets/{useAgentWorkSummary-pc1i6nr0.js → useAgentWorkSummary-BQbhaHov.js} +1 -1
  189. package/dist/web/assets/{useApi-CROJJdhE-DZtkWJZv.js → useApi-CROJJdhE-CRCgNOqq.js} +1 -1
  190. package/dist/web/assets/{useClipboardCopy-sTthF_MD.js → useClipboardCopy-DkqKK3wY.js} +1 -1
  191. package/dist/web/assets/{useFocusReturn-BoyUh5y3.js → useFocusReturn-BZpVmQnM.js} +1 -1
  192. package/dist/web/assets/{useForwardExpose-CqXuqZvd.js → useForwardExpose-Di-MnbTz.js} +1 -1
  193. package/dist/web/assets/{useForwardPropsEmits-0F_e7unJ.js → useForwardPropsEmits-L9XcB5DG.js} +1 -1
  194. package/dist/web/assets/useForwardScopeId-CUQFIAIj.js +1 -0
  195. package/dist/web/assets/useKnowledgeItemPeek-PmQJixw5.js +1 -0
  196. package/dist/web/assets/{useMinimumLoadingDisplay-CzfqbQPs.js → useMinimumLoadingDisplay-CWPiOaDl.js} +1 -1
  197. package/dist/web/assets/useProjectAgentRoster-CWVpSsQ3.js +1 -0
  198. package/dist/web/assets/{useRoutePeek-BDgll9Fy.js → useRoutePeek-DxLVksbJ.js} +1 -1
  199. package/dist/web/assets/useTeamPeople-CDISP0PM.js +1 -0
  200. package/dist/web/assets/{useTeamWork-BSFi27vj.js → useTeamWork-BTZd_wKs.js} +1 -1
  201. package/dist/web/assets/{useTypeahead-D_g4j3Xp.js → useTypeahead-pEZNpBls.js} +1 -1
  202. package/dist/web/assets/{utils-C6vsxGrE.js → utils-B4pBTmyh.js} +1 -1
  203. package/dist/web/assets/utils-BsxOjD1Q.js +1 -0
  204. package/dist/web/assets/version-db3QWWjt.js +1 -0
  205. package/dist/web/assets/{vue-router-BPhQ0Qow.js → vue-router-B79HWW1l.js} +1 -1
  206. package/dist/web/assets/website-YgovUEcN.js +1 -0
  207. package/dist/web/index.html +71 -66
  208. package/docs/agent-interface-architecture.md +13 -4
  209. package/docs/client-connections.md +3 -2
  210. package/docs/employee-agents.md +11 -9
  211. package/docs/judgment-and-autonomy.md +4 -4
  212. package/graph-provider/fuli_graph/app.py +4 -0
  213. package/graph-provider/fuli_graph/collaboration_context.py +3 -7
  214. package/graph-provider/fuli_graph/graph_field_contract.py +10 -2
  215. package/graph-provider/fuli_graph/graph_format_builtin_occupations.py +33 -1
  216. package/graph-provider/fuli_graph/graph_format_migrations.py +18 -0
  217. package/graph-provider/fuli_graph/graph_query.py +3 -12
  218. package/graph-provider/fuli_graph/knowledge_index_scan.py +120 -0
  219. package/graph-provider/fuli_graph/knowledge_outdated.py +9 -1
  220. package/graph-provider/fuli_graph/knowledge_retrieval_models.py +95 -0
  221. package/graph-provider/fuli_graph/knowledge_retrieval_terms.py +116 -0
  222. package/graph-provider/fuli_graph/knowledge_search.py +220 -39
  223. package/graph-provider/fuli_graph/knowledge_semantic.py +87 -0
  224. package/graph-provider/fuli_graph/knowledge_semantic_index.py +98 -0
  225. package/graph-provider/fuli_graph/knowledge_semantic_models.py +72 -0
  226. package/graph-provider/fuli_graph/knowledge_semantic_query.py +19 -0
  227. package/graph-provider/fuli_graph/knowledge_versions.py +14 -7
  228. package/graph-provider/fuli_graph/models.py +4 -0
  229. package/graph-provider/fuli_graph/occupation_catalog.py +6 -3
  230. package/graph-provider/fuli_graph/personal_global_preferences.py +3 -7
  231. package/graph-provider/fuli_graph/preference_versions.py +110 -0
  232. package/graph-provider/fuli_graph/project_agent_models.py +3 -0
  233. package/graph-provider/fuli_graph/project_agent_recruitment_occupation.py +1 -1
  234. package/graph-provider/fuli_graph/provider_values.py +7 -0
  235. package/graph-provider/fuli_graph/search_projection.py +2 -6
  236. package/graph-provider/fuli_graph/store_knowledge.py +10 -1
  237. package/graph-provider/fuli_graph/task_context_routes.py +1 -1
  238. package/graph-provider/pyproject.toml +1 -1
  239. package/native/win32/fuli-win-helper.exe +0 -0
  240. package/npm-shrinkwrap.json +3 -4
  241. package/package.json +2 -1
  242. package/skills/capturing-session-knowledge/SKILL.md +14 -7
  243. package/skills/capturing-session-knowledge/references/capture.md +12 -2
  244. package/skills/capturing-session-knowledge/references/retrieval.md +13 -4
  245. package/skills/grilling-project/SKILL.md +2 -0
  246. package/skills/operating-fuli/SKILL.md +36 -8
  247. package/skills/operating-fuli/references/workflow-recipes.md +10 -9
  248. package/src/agent-apps/host-tools/catalog.js +3 -0
  249. package/src/agent-delegation/agent-tool.js +12 -2
  250. package/src/agent-delegation/delegation-header.js +32 -8
  251. package/src/agent-delegation/entry-prompts.js +54 -0
  252. package/src/agent-delegation/operation-log.js +17 -7
  253. package/src/agent-delegation/person-words.js +38 -0
  254. package/src/agent-delegation/port.js +6 -4
  255. package/src/agent-delegation/refusals.js +14 -0
  256. package/src/agent-kits/client-detection.js +7 -0
  257. package/src/agent-kits/client-installer.js +13 -0
  258. package/src/agent-tools/delegation-definitions.js +5 -3
  259. package/src/agent-tools/diagnostic-definitions.js +23 -0
  260. package/src/agent-tools/graph-definitions.js +4 -0
  261. package/src/agent-tools/graph-handlers.js +6 -1
  262. package/src/agent-tools/interface-catalog.js +47 -17
  263. package/src/agent-tools/model-backend-definitions.js +1 -1
  264. package/src/agent-tools/old-data-definitions.js +16 -0
  265. package/src/agent-tools/task-entry-definitions.js +1 -1
  266. package/src/agent-tools/work-surface-definitions.js +1 -1
  267. package/src/agents/claude-code/lifecycle-hook.js +19 -5
  268. package/src/agents/claude-code/transcript-format-probe.js +31 -0
  269. package/src/agents/codex/lifecycle-hook.js +27 -7
  270. package/src/agents/codex/transcript-format-probe.js +29 -0
  271. package/src/agents/cursor/lifecycle-hook.js +4 -1
  272. package/src/agents/lifecycle-failure.js +27 -0
  273. package/src/agents/lifecycle-message.js +10 -0
  274. package/src/agents/opencode/lifecycle-hook.js +18 -2
  275. package/src/agents/transcript-format-registry.js +34 -0
  276. package/src/agents/transcript-format-scan.js +71 -0
  277. package/src/cli/command-registry.js +3 -0
  278. package/src/cli/diagnostics-command.js +59 -0
  279. package/src/cli/setup-command.js +3 -0
  280. package/src/cli.js +5 -0
  281. package/src/conversations/entry-budget.js +1 -1
  282. package/src/conversations/entry-detail-readers.js +22 -0
  283. package/src/conversations/entry-inline-budget.js +24 -12
  284. package/src/conversations/entry-skeleton.js +27 -9
  285. package/src/conversations/preference-lifecycle.js +2 -1
  286. package/src/conversations/preference-session.js +5 -2
  287. package/src/conversations/preference-snapshot.js +4 -1
  288. package/src/conversations/preference-view.js +5 -1
  289. package/src/conversations/reply-citations.js +21 -0
  290. package/src/conversations/stop-auto-close.js +21 -9
  291. package/src/conversations/task-context-view.js +31 -0
  292. package/src/data-format/backup-retention.js +8 -0
  293. package/src/data-format/local-stores.js +24 -2
  294. package/src/debug-turns/fuli-surface.js +23 -0
  295. package/src/debug-turns/model-capture.js +84 -0
  296. package/src/debug-turns/model-request.js +97 -0
  297. package/src/debug-turns/record.js +178 -0
  298. package/src/debug-turns/recorder.js +53 -0
  299. package/src/debug-turns/store.js +91 -0
  300. package/src/debug-turns/transcript-reader.js +64 -0
  301. package/src/debug-turns/trigger.js +25 -0
  302. package/src/diagnostics/agent-tool.js +14 -0
  303. package/src/diagnostics/event-log.js +133 -0
  304. package/src/diagnostics/failure-records.js +43 -0
  305. package/src/diagnostics/query.js +114 -0
  306. package/src/diagnostics/safe-event.js +83 -0
  307. package/src/dreaming/run.js +310 -0
  308. package/src/dreaming/scheduler.js +58 -0
  309. package/src/employees/builtin/jefa/board-store.js +78 -19
  310. package/src/employees/builtin/jefa/http.js +8 -5
  311. package/src/employees/builtin/jefa/project-board.js +2 -0
  312. package/src/employees/builtin/jefa/tools.js +7 -6
  313. package/src/employees/recruitment.js +20 -2
  314. package/src/employees/service.js +11 -1
  315. package/src/graphiti/agent-growth.js +64 -0
  316. package/src/graphiti/collaboration-preference-projection.js +7 -0
  317. package/src/graphiti/collaboration-preference-workflow.js +3 -3
  318. package/src/graphiti/current-project-knowledge-search.js +24 -1
  319. package/src/graphiti/federated-application.js +19 -1
  320. package/src/graphiti/federated-search.js +8 -1
  321. package/src/graphiti/local-runtimes.js +13 -0
  322. package/src/graphiti/personal-projects.js +11 -0
  323. package/src/graphiti/project-agent-mapping.js +1 -0
  324. package/src/graphiti/project-agent-task-sheets.js +6 -2
  325. package/src/graphiti/project-agent-workflows.js +22 -4
  326. package/src/graphiti/project-profile-authors.js +14 -7
  327. package/src/graphiti/provider-client.js +36 -0
  328. package/src/graphiti/session-knowledge-migration.js +103 -3
  329. package/src/graphiti/session-migration-notices.js +65 -0
  330. package/src/graphiti/session-records.js +22 -4
  331. package/src/graphiti/task-context-entry.js +5 -1
  332. package/src/graphiti/task-entry-preferences.js +31 -2
  333. package/src/graphiti/task-entry-read-only.js +28 -0
  334. package/src/graphiti/task-knowledge-checkpoint.js +2 -0
  335. package/src/graphiti/task-knowledge-recall.js +96 -19
  336. package/src/graphiti/task-remember.js +7 -2
  337. package/src/graphiti/task-update-request.js +13 -0
  338. package/src/graphiti/temporary-project-scope.js +7 -1
  339. package/src/graphiti/turn-receipt-delivery.js +5 -3
  340. package/src/http/agent-delegation-gate.js +5 -4
  341. package/src/http/agent-growth-api-router.js +17 -0
  342. package/src/http/api-router.js +18 -2
  343. package/src/http/capture-onboarding-api-router.js +3 -2
  344. package/src/http/debug-turns-api-router.js +70 -0
  345. package/src/http/diagnostic-events-api-router.js +27 -0
  346. package/src/http/dreaming-api-router.js +32 -0
  347. package/src/http/graph-api-router.js +35 -1
  348. package/src/http/knowledge-item-api-router.js +19 -2
  349. package/src/http/knowledge-scope-api-router.js +3 -2
  350. package/src/http/old-data-api-router.js +47 -0
  351. package/src/http/person-profile-api-router.js +3 -2
  352. package/src/http/retrieval-terms-api-router.js +37 -0
  353. package/src/http/semantic-api-router.js +26 -0
  354. package/src/judgment/agent-view.js +1 -1
  355. package/src/judgment/backend.js +30 -0
  356. package/src/judgment/http.js +2 -1
  357. package/src/judgment/review-prompt.js +2 -0
  358. package/src/judgment/routing.js +10 -2
  359. package/src/judgment/service.js +8 -2
  360. package/src/judgment/store.js +17 -7
  361. package/src/local-runtime/lifecycle.js +3 -0
  362. package/src/local-runtime/windows-process-handle.js +9 -3
  363. package/src/mcp/create-mcp-server.js +42 -25
  364. package/src/mcp/process-registry.js +45 -3
  365. package/src/mcp/runtime.js +2 -1
  366. package/src/mcp/stdio-relay.js +4 -1
  367. package/src/mcp/tool-annotations.js +2 -0
  368. package/src/model-backends/adapters/anthropic-messages.js +1 -1
  369. package/src/model-backends/adapters/exchange.js +2 -2
  370. package/src/model-backends/adapters/openai-chat.js +1 -1
  371. package/src/model-backends/adapters/openai-embeddings.js +60 -0
  372. package/src/model-backends/adapters/registry.js +3 -1
  373. package/src/model-backends/adapters/typesafe-systemone.js +1 -1
  374. package/src/model-backends/budget.js +14 -8
  375. package/src/model-backends/config.js +49 -15
  376. package/src/model-backends/decision-contract.js +2 -1
  377. package/src/model-backends/http.js +19 -1
  378. package/src/model-backends/model-fetch.js +37 -0
  379. package/src/model-backends/port.js +165 -67
  380. package/src/model-backends/prompt.js +4 -3
  381. package/src/model-backends/request.js +42 -3
  382. package/src/native-runtime/runtime.js +28 -4
  383. package/src/old-data/agent-tools.js +17 -0
  384. package/src/old-data/backup-reader.js +78 -0
  385. package/src/old-data/console-actions.js +53 -0
  386. package/src/old-data/guarded-stores.js +18 -0
  387. package/src/old-data/inventory.js +142 -0
  388. package/src/old-data/port.js +53 -0
  389. package/src/person-profile/port.js +2 -1
  390. package/src/presence/windows-helper-pin.js +1 -1
  391. package/src/project-change-log/port.js +65 -0
  392. package/src/project-change-log/store.js +60 -0
  393. package/src/retrieval-terms/fill.js +102 -0
  394. package/src/retrieval-terms/runner.js +50 -0
  395. package/src/retrieval-terms/terms-model.js +99 -0
  396. package/src/security/sensitive-content.js +11 -0
  397. package/src/semantic/scheduler.js +50 -0
  398. package/src/semantic/semantic-index.js +94 -0
  399. package/src/server.js +20 -1
  400. package/src/setup/paths.js +1 -1
  401. package/src/setup/setup.js +7 -0
  402. package/src/system/client-connection-status.js +6 -4
  403. package/src/system/doctor-repair.js +16 -4
  404. package/src/system/doctor.js +75 -3
  405. package/src/system/log-paths.js +11 -0
  406. package/src/system/log-retention.js +2 -8
  407. package/src/system/mcp-process-scan.js +55 -0
  408. package/src/system/resource-monitor.js +18 -2
  409. package/src/system/system-service.js +39 -7
  410. package/src/system/windows-data-acl.js +109 -0
  411. package/src/work-surfaces/port.js +17 -11
  412. package/src/work-surfaces/sources.js +4 -3
  413. package/dist/web/assets/AboutSectionHeading-BOXKE5Le.js +0 -1
  414. package/dist/web/assets/AboutSectionHeading-CiD3M3eG.css +0 -1
  415. package/dist/web/assets/AgentAppsPage-DS2X485q.js +0 -1
  416. package/dist/web/assets/AgentConversations-D7QJVFIo.js +0 -2
  417. package/dist/web/assets/AgentConversations-oZFXZE1X.css +0 -1
  418. package/dist/web/assets/AgentMentionCopy-O6pAjjYE.js +0 -1
  419. package/dist/web/assets/AgentProfilePage-CKCTcTzc.js +0 -2
  420. package/dist/web/assets/AgentProfilePage-D1ha8O3z.css +0 -1
  421. package/dist/web/assets/AgentServicesPage-C3npKkHp.js +0 -1
  422. package/dist/web/assets/AgentWorkbench-CJ4TYQA1.css +0 -1
  423. package/dist/web/assets/AgentWorkbench-D9HGRW-n.js +0 -2
  424. package/dist/web/assets/AppViewerPage-Al4TzYJF.js +0 -1
  425. package/dist/web/assets/BoardMoveMenu-ncWgEitd.js +0 -1
  426. package/dist/web/assets/Breadcrumb-QzjzIJdS.js +0 -1
  427. package/dist/web/assets/Breadcrumb-bsc0JKtG.css +0 -1
  428. package/dist/web/assets/CaptureChangePage-BQdqH2qC.js +0 -1
  429. package/dist/web/assets/ConnectionsPage-Be8jIb93.js +0 -1
  430. package/dist/web/assets/DataFormatPage-0Ne27K6I.css +0 -1
  431. package/dist/web/assets/DataFormatPage-C92rwzHa.js +0 -2
  432. package/dist/web/assets/EmployeeScopeDialog-DdR2DzcW.js +0 -1
  433. package/dist/web/assets/EmployeeTaskBoard-Bo8JT36K.js +0 -3
  434. package/dist/web/assets/EmployeeTaskBoard-Dljjy_L7.css +0 -1
  435. package/dist/web/assets/EmployeeWorkbenchPage-B249Mgle.js +0 -3
  436. package/dist/web/assets/EmployeeWorkbenchPage-BBjZJ6Od.css +0 -1
  437. package/dist/web/assets/FieldRoot-YdKVCBhW.js +0 -1
  438. package/dist/web/assets/FlaTaskSheets-Cm5SLq7J.js +0 -1
  439. package/dist/web/assets/FlasPage-C57gTN5X.js +0 -1
  440. package/dist/web/assets/HowtoPage-CDJScY6b.js +0 -1
  441. package/dist/web/assets/KnowledgeDeleteButton-5EtCPPl4.js +0 -1
  442. package/dist/web/assets/KnowledgeHardDeleteSection-r0lZ7ijb.js +0 -1
  443. package/dist/web/assets/KnowledgeItemEditPage-BStIRllM.js +0 -1
  444. package/dist/web/assets/KnowledgeOrganizerPage-BByk8hbw.js +0 -1
  445. package/dist/web/assets/KnowledgePage-DuWS3bRP.js +0 -1
  446. package/dist/web/assets/KnowledgePeek-BycBJ2xR.js +0 -1
  447. package/dist/web/assets/KnowledgePeek-EvumfJER.css +0 -1
  448. package/dist/web/assets/KnowledgeTurnReceiptPage-DTcDN-pG.js +0 -1
  449. package/dist/web/assets/KnowledgeWorkspace-CJo-6xdn.js +0 -4
  450. package/dist/web/assets/KnowledgeWorkspace-DPBq-At0.css +0 -1
  451. package/dist/web/assets/ModelSettingsPage-C1ghraAh.js +0 -1
  452. package/dist/web/assets/ModelSettingsPage-ConWy_ec.css +0 -1
  453. package/dist/web/assets/OccupationsPage-BY1jej7i.js +0 -1
  454. package/dist/web/assets/OverviewPage-C7YJf-Cq.css +0 -1
  455. package/dist/web/assets/OverviewPage-Dl-H0EBe.js +0 -1
  456. package/dist/web/assets/PersonalProfilePage-BcaVzKM6.js +0 -1
  457. package/dist/web/assets/PersonalProjectsPage-CO4ZYVAI.js +0 -1
  458. package/dist/web/assets/ProjectAgentDetailPage-Bgh78Mr5.js +0 -8
  459. package/dist/web/assets/ProjectAgentDetailPage-h7hr9iee.css +0 -1
  460. package/dist/web/assets/ProjectAgentDialog--T6mU-FW.css +0 -1
  461. package/dist/web/assets/ProjectAgentDialog-DzTor5ky.js +0 -5
  462. package/dist/web/assets/ProjectAgentsPage-CzN183pa.js +0 -1
  463. package/dist/web/assets/ProjectJudgmentPolicy-BMlEBJM3.js +0 -2
  464. package/dist/web/assets/PublicProjectsPage-DAHT31B8.js +0 -1
  465. package/dist/web/assets/SessionMigrationPage-IW07XhmD.js +0 -1
  466. package/dist/web/assets/SessionRecordsPage-Du76tewc.js +0 -1
  467. package/dist/web/assets/SettingsPage-CJNXe313.js +0 -1
  468. package/dist/web/assets/SettingsPage-D3AYCNTC.css +0 -1
  469. package/dist/web/assets/SharedJefaReportPage-dzHSSGhu.js +0 -1
  470. package/dist/web/assets/TagVocabularyPage-C_oV6GFs.js +0 -1
  471. package/dist/web/assets/TeamCard-CdO0RiNB.js +0 -1
  472. package/dist/web/assets/TeamCardsWidget-Cg_kJmb-.js +0 -1
  473. package/dist/web/assets/UiDialog-CUgrU6SQ.js +0 -1
  474. package/dist/web/assets/UiIcon-DPv0eZIU.js +0 -1
  475. package/dist/web/assets/WidgetSlot-BSU_-l_4.js +0 -2
  476. package/dist/web/assets/_plugin-vue_export-helper-DQENg-QE.js +0 -9
  477. package/dist/web/assets/agent-occupation-BvOgDW-q.js +0 -1
  478. package/dist/web/assets/agent-profile-BBqkfac0.css +0 -1
  479. package/dist/web/assets/agent-task-board-Cf9il_1i.js +0 -1
  480. package/dist/web/assets/button-N4FjuQuJ.js +0 -1
  481. package/dist/web/assets/client-connection-model-C3gpYYl7.js +0 -1
  482. package/dist/web/assets/combobox-DHwWXUpj.js +0 -1
  483. package/dist/web/assets/desktop-client-DnfjyLBX.js +0 -1
  484. package/dist/web/assets/dist-BInsvNsv.js +0 -1
  485. package/dist/web/assets/dist-Dc8jFf8M.js +0 -1
  486. package/dist/web/assets/field-BQLn7Hfw.js +0 -1
  487. package/dist/web/assets/index-CXPYDcyq.js +0 -2
  488. package/dist/web/assets/index-x95VDmzK.css +0 -1
  489. package/dist/web/assets/judgment-api-CK9yqrpU.js +0 -1
  490. package/dist/web/assets/label-table-KdyaCTvK.js +0 -1
  491. package/dist/web/assets/model-D4kKYvpj.js +0 -1
  492. package/dist/web/assets/popover-D4YFkL_5.js +0 -1
  493. package/dist/web/assets/project-board-settings-DPP6xKLz.js +0 -1
  494. package/dist/web/assets/project-team-api-7ybLH-uJ.js +0 -1
  495. package/dist/web/assets/save-file-CRxAsski.js +0 -1
  496. package/dist/web/assets/select-CUy1AIwE.js +0 -1
  497. package/dist/web/assets/settings-restart-JYH81qB-.js +0 -1
  498. package/dist/web/assets/shared-report-8p3nBKr-.js +0 -1
  499. package/dist/web/assets/source-coverage-4PsHC9TK.js +0 -1
  500. package/dist/web/assets/task-labels-CXBG2chm.js +0 -1
  501. package/dist/web/assets/useForwardScopeId-DVUFcuwO.js +0 -1
  502. package/dist/web/assets/useKnowledgeItemPeek-KZveY8Wz.js +0 -1
  503. package/dist/web/assets/useTeamPeople-Dna3Yrm3.js +0 -1
  504. package/dist/web/assets/utils-BX1QI2N6.js +0 -1
  505. package/dist/web/assets/version-CBPeq5nI.js +0 -1
@@ -0,0 +1,120 @@
1
+ """The items a derived index covers (rec#88, rec#92): those default search
2
+ could return, read one chunk at a time with their own text and the derived
3
+ values stored beside it, and the write lock that pins an item's text while a
4
+ derived value is written.
5
+
6
+ Only current items of the space count, resting on no unresolved basis,
7
+ confirmed by a person or an Agent, and reachable through a scope (a
8
+ preference, an assignment, a source episode or a project reference). Derived
9
+ values (a meaning vector, retrieval terms) are an index: storing one writes no
10
+ history and changes no version, lock_version or timestamp.
11
+ """
12
+ from .search_projection import is_default_retrievable
13
+
14
+ # Items read per query while looking through them.
15
+ SCAN_CHUNK = 500
16
+ ITEM_KINDS = ('entity', 'relationship')
17
+
18
+ _ELIGIBLE = {
19
+ 'entity': '''
20
+ MATCH (item:Entity {group_id: $group_id})
21
+ WHERE item.uuid > $after AND item.fuli_invalid_at IS NULL''',
22
+ 'relationship': '''
23
+ MATCH ()-[item:RELATES_TO {group_id: $group_id}]->()
24
+ WHERE item.uuid > $after AND item.invalid_at IS NULL''',
25
+ }
26
+ _REACHABLE = {
27
+ 'entity': 'EXISTS { MATCH (:Episodic {group_id: $group_id})-[:MENTIONS]->(item) }',
28
+ 'relationship': 'size(coalesce(item.episodes, [])) > 0',
29
+ }
30
+ _SOURCE_EPISODES = {
31
+ 'entity': 'OPTIONAL MATCH (episode:Episodic {group_id: $group_id})-[:MENTIONS]->(item)',
32
+ 'relationship': '''OPTIONAL MATCH (episode:Episodic {group_id: $group_id})
33
+ WHERE episode.uuid IN coalesce(item.episodes, [])''',
34
+ }
35
+ _TEXT = {
36
+ 'entity': 'item.name AS name, item.summary AS summary',
37
+ 'relationship': 'item.name AS name, item.fact AS fact',
38
+ }
39
+ _DERIVED = '''item.fuli_retrieval_terms AS retrieval_terms, item.fuli_retrieval_context AS retrieval_context,
40
+ item.fuli_retrieval_hash AS retrieval_hash,
41
+ item.fuli_semantic_model AS semantic_model, item.fuli_semantic_hash AS semantic_hash'''
42
+
43
+
44
+ def scan_query(item_kind: str) -> str:
45
+ return _ELIGIBLE[item_kind] + '''
46
+ AND size(coalesce(item.fuli_unresolved_bases, [])) = 0
47
+ OPTIONAL MATCH (assignment:FuliKnowledgeAssignment {
48
+ space_id: $space_id, item_kind: $item_kind, item_id: item.uuid
49
+ })
50
+ WITH item, assignment
51
+ WHERE item.fuli_profile_aspect IS NOT NULL OR assignment IS NOT NULL
52
+ OR ''' + _REACHABLE[item_kind] + '''
53
+ OR EXISTS { MATCH (:FuliSpace {id: $space_id})-[:HAS_KNOWLEDGE_REFERENCE]->
54
+ (:FuliKnowledgeProjectReference {item_kind: $item_kind, item_id: item.uuid,
55
+ status: 'active'}) }
56
+ ''' + _SOURCE_EPISODES[item_kind] + '''
57
+ WITH item, assignment, min(episode.fuli_personal_project_id) AS episode_project_id
58
+ RETURN item.uuid AS id, ''' + _TEXT[item_kind] + ''',
59
+ coalesce(item.fuli_confirmation_status, 'pending') AS confirmation_status,
60
+ item.fuli_confirmation_basis_json AS confirmation_basis_json,
61
+ coalesce(assignment.project_id, item.fuli_preference_project_id, episode_project_id)
62
+ AS personal_project_id,
63
+ ''' + _DERIVED + '''
64
+ ORDER BY item.uuid
65
+ LIMIT $chunk
66
+ '''
67
+
68
+
69
+ async def indexable_items(store, space, item_kind: str, after: str = ''):
70
+ """The indexable items of one kind after `after`, in id order."""
71
+ while True:
72
+ records, _, _ = await store.runtime.driver.execute_query(
73
+ scan_query(item_kind), group_id=space['group_id'], space_id=space['id'], item_kind=item_kind,
74
+ after=after, chunk=SCAN_CHUNK, routing_='r')
75
+ for record in records:
76
+ if is_default_retrievable(record):
77
+ yield record
78
+ if len(records) < SCAN_CHUNK:
79
+ return
80
+ after = records[-1]['id']
81
+
82
+
83
+ async def indexable_from(store, space, after: str | None):
84
+ """Every indexable item of every kind from a page cursor on, as (kind, record)."""
85
+ start, item_id = page_cursor(after)
86
+ for kind_index in range(start, len(ITEM_KINDS)):
87
+ item_kind = ITEM_KINDS[kind_index]
88
+ async for record in indexable_items(store, space, item_kind, item_id if kind_index == start else ''):
89
+ yield item_kind, record
90
+
91
+
92
+ def page_cursor(after: str | None) -> tuple[int, str]:
93
+ if not after:
94
+ return 0, ''
95
+ kind, _, item_id = after.partition(':')
96
+ return (ITEM_KINDS.index(kind), item_id) if kind in ITEM_KINDS else (len(ITEM_KINDS), '')
97
+
98
+
99
+ # The item's write lock, held to the commit, then its text: an edit waits, so
100
+ # the text checked is the text a derived value is stored beside. The lock
101
+ # property is removed in the same statement and the item is left as it was.
102
+ _LOCKED_TEXT = {
103
+ 'entity': '''
104
+ MATCH (item:Entity {uuid: $item_id, group_id: $group_id})
105
+ SET item._index_lock = true REMOVE item._index_lock
106
+ RETURN item.name AS name, item.summary AS summary,
107
+ item.fuli_retrieval_terms AS retrieval_terms, item.fuli_retrieval_context AS retrieval_context''',
108
+ 'relationship': '''
109
+ MATCH ()-[item:RELATES_TO {uuid: $item_id, group_id: $group_id}]->()
110
+ SET item._index_lock = true REMOVE item._index_lock
111
+ RETURN item.fact AS fact,
112
+ item.fuli_retrieval_terms AS retrieval_terms, item.fuli_retrieval_context AS retrieval_context''',
113
+ }
114
+
115
+
116
+ async def locked_item(scoped, space, item_kind: str, item_id: str) -> dict | None:
117
+ """Inside a store transaction: lock the item and read its text, or None when it is gone."""
118
+ records, _, _ = await scoped.runtime.driver.execute_query(
119
+ _LOCKED_TEXT[item_kind], item_id=item_id, group_id=space['group_id'])
120
+ return records[0] if records else None
@@ -21,6 +21,7 @@ from .knowledge_versions import (
21
21
  end_keyed_values, invalid_property, keyed_value, lock_knowledge, record_version_revision,
22
22
  )
23
23
  from .models import KnowledgeRevisionRecord
24
+ from .preference_versions import end_older_preferences
24
25
  from .provider_values import normalized_text, stable_uuid
25
26
 
26
27
  MARK_OUTDATED_TOOL = 'mark_outdated'
@@ -37,11 +38,18 @@ POSSIBLY_OUTDATED_REASON = 'Newer knowledge may replace this; it stays current u
37
38
  async def settle_older_knowledge(scoped, actor, space, items, *, created_at) -> dict[str, list[dict]]:
38
39
  """What newly written or confirmed knowledge does to older knowledge,
39
40
  inside the caller's transaction. A confirmed value of a keyed relation
40
- ends the other values of its subject and relation; any other new item
41
+ ends the other values of its subject and relation, and a confirmed
42
+ preference the other preferences of its key and scope; any other new item
41
43
  queues the older items it may silently replace for a person (flagged, not
42
44
  ended). Nothing is deleted."""
43
45
  superseded, flagged = [], []
44
46
  for item_kind, item_id in items:
47
+ # A confirmed preference ends the older one of its key and scope.
48
+ ended = await end_older_preferences(scoped, actor, space, item_kind, item_id, changed_by='user',
49
+ created_at=created_at)
50
+ if ended:
51
+ superseded += ended
52
+ continue
45
53
  keyed = await keyed_value(scoped, space, item_id) if item_kind == 'relationship' else None
46
54
  if keyed and keyed['confirmation_status'] == 'confirmed':
47
55
  ended = await end_keyed_values(scoped, actor, space, keyed, changed_by='user', created_at=created_at)
@@ -0,0 +1,95 @@
1
+ """Requests and answers of retrieval terms (rec#92)."""
2
+ from typing import Annotated
3
+
4
+ from pydantic import Field, field_validator, model_validator
5
+
6
+ from .knowledge_audit_models import KnowledgeItemKind
7
+ from .knowledge_semantic_models import Sha256
8
+ from .model_base import StrictModel
9
+
10
+ RETRIEVAL_BATCH_LIMIT = 64
11
+ MAX_TERMS = 24
12
+ MAX_TERM_CHARS = 120
13
+ MAX_CONTEXT_CHARS = 300
14
+ SpaceId = Annotated[str, Field(min_length=1, max_length=128)]
15
+
16
+
17
+ class RetrievalCandidatesRequest(StrictModel):
18
+ personal_space_id: SpaceId
19
+ # Only this project's items; omitted for every project and items no project owns.
20
+ personal_project_id: str | None = Field(default=None, min_length=1, max_length=128)
21
+ limit: int = Field(default=RETRIEVAL_BATCH_LIMIT, ge=1, le=RETRIEVAL_BATCH_LIMIT)
22
+ after: str | None = Field(default=None, min_length=1, max_length=320)
23
+ # Only items without terms for their current text.
24
+ missing_only: bool = True
25
+
26
+
27
+ class RetrievalCandidate(StrictModel):
28
+ item_kind: KnowledgeItemKind
29
+ item_id: str
30
+ personal_project_id: str | None
31
+ title: str
32
+ # The item's own words, which the terms are made from.
33
+ text: str
34
+ has_terms: bool
35
+ # Of `text`: a write whose hash no longer matches is skipped.
36
+ hash: str
37
+
38
+
39
+ class RetrievalCandidatesPage(StrictModel):
40
+ items: list[RetrievalCandidate]
41
+ next: str | None
42
+
43
+
44
+ class RetrievalTermsItem(StrictModel):
45
+ item_kind: KnowledgeItemKind
46
+ item_id: str = Field(min_length=1, max_length=256)
47
+ hash: Sha256
48
+ terms: list[str] = Field(min_length=1, max_length=MAX_TERMS)
49
+ context: str | None = Field(default=None, max_length=MAX_CONTEXT_CHARS)
50
+
51
+ @field_validator('terms')
52
+ @classmethod
53
+ def clean_terms(cls, terms: list[str]) -> list[str]:
54
+ cleaned = list(dict.fromkeys(term.strip() for term in terms if term.strip()))
55
+ if not cleaned:
56
+ raise ValueError('at least one term is required')
57
+ if any(len(term) > MAX_TERM_CHARS for term in cleaned):
58
+ raise ValueError(f'a term has at most {MAX_TERM_CHARS} characters')
59
+ return cleaned
60
+
61
+ @field_validator('context')
62
+ @classmethod
63
+ def clean_context(cls, context: str | None) -> str | None:
64
+ return context.strip() or None if context else None
65
+
66
+
67
+ class RetrievalTermsWrite(StrictModel):
68
+ personal_space_id: SpaceId
69
+ items: list[RetrievalTermsItem] = Field(min_length=1, max_length=RETRIEVAL_BATCH_LIMIT)
70
+
71
+ @model_validator(mode='after')
72
+ def validate_unique(self):
73
+ if len({(item.item_kind, item.item_id) for item in self.items}) != len(self.items):
74
+ raise ValueError('each item may appear once')
75
+ return self
76
+
77
+
78
+ class RetrievalTermsWriteResult(StrictModel):
79
+ written: int = Field(ge=0)
80
+ # The items whose text changed since their hash was computed, or that are gone.
81
+ skipped: list[str]
82
+
83
+
84
+ class RetrievalStatsRequest(StrictModel):
85
+ personal_space_id: SpaceId
86
+ personal_project_id: str | None = Field(default=None, min_length=1, max_length=128)
87
+
88
+
89
+ class RetrievalStats(StrictModel):
90
+ items: int = Field(ge=0)
91
+ with_terms: int = Field(ge=0)
92
+ # Characters of the items' own words, all of them and those still without terms:
93
+ # what an estimate of the fill's cost starts from.
94
+ chars: int = Field(ge=0)
95
+ missing_chars: int = Field(ge=0)
@@ -0,0 +1,116 @@
1
+ """Retrieval terms (rec#92): the other ways someone would ask for an item,
2
+ stored beside it so word search and the meaning index find it by them.
3
+
4
+ Knowledge saved before FULI asked for search terms has only its own words.
5
+ Node asks a model for the missing terms of each item and stores them here.
6
+ They are derived data, like a meaning vector: storing them writes no history
7
+ and no human-change record, changes no version, lock_version or timestamp,
8
+ and nothing waits for a person. Each set keeps the hash of the item's words it
9
+ was made from, so an edit leaves the item without current terms again.
10
+ """
11
+ from .knowledge_index_scan import ITEM_KINDS, indexable_from, indexable_items, locked_item
12
+ from .knowledge_item_view import personal_reader_space
13
+ from .knowledge_retrieval_models import (
14
+ RetrievalCandidate,
15
+ RetrievalCandidatesPage,
16
+ RetrievalCandidatesRequest,
17
+ RetrievalStats,
18
+ RetrievalStatsRequest,
19
+ RetrievalTermsWrite,
20
+ RetrievalTermsWriteResult,
21
+ )
22
+ from .knowledge_semantic import item_text, semantic_hash
23
+ from .store_transactions import query_store_transaction
24
+
25
+
26
+ def _current(item_kind: str, record) -> tuple[str, str, bool]:
27
+ """The item's own words, their hash, and whether its stored terms were made from them."""
28
+ text = item_text(item_kind, record)
29
+ text_hash = semantic_hash(text)
30
+ return text, text_hash, bool(record.get('retrieval_terms')) and record.get('retrieval_hash') == text_hash
31
+
32
+
33
+ def _in_project(record, personal_project_id: str | None) -> bool:
34
+ return personal_project_id is None or record['personal_project_id'] == personal_project_id
35
+
36
+
37
+ async def retrieval_candidates(store, actor, request: RetrievalCandidatesRequest) -> RetrievalCandidatesPage:
38
+ space = await personal_reader_space(store, actor, request.personal_space_id)
39
+ items = []
40
+ async for item_kind, record in indexable_from(store, space, request.after):
41
+ if not _in_project(record, request.personal_project_id):
42
+ continue
43
+ text, text_hash, has_terms = _current(item_kind, record)
44
+ if not text or (request.missing_only and has_terms):
45
+ continue
46
+ if len(items) == request.limit:
47
+ last = items[-1]
48
+ return RetrievalCandidatesPage(items=items, next=f'{last.item_kind}:{last.item_id}')
49
+ items.append(RetrievalCandidate(
50
+ item_kind=item_kind, item_id=record['id'], personal_project_id=record['personal_project_id'],
51
+ title=(record.get('name') if item_kind == 'entity' else None) or text[:120], text=text,
52
+ has_terms=has_terms,
53
+ hash=text_hash))
54
+ return RetrievalCandidatesPage(items=items, next=None)
55
+
56
+
57
+ async def retrieval_stats(store, actor, request: RetrievalStatsRequest) -> RetrievalStats:
58
+ space = await personal_reader_space(store, actor, request.personal_space_id)
59
+ counts = {'items': 0, 'with_terms': 0, 'chars': 0, 'missing_chars': 0}
60
+ for item_kind in ITEM_KINDS:
61
+ async for record in indexable_items(store, space, item_kind):
62
+ if not _in_project(record, request.personal_project_id):
63
+ continue
64
+ text, _, has_terms = _current(item_kind, record)
65
+ if not text:
66
+ continue
67
+ counts['items'] += 1
68
+ counts['chars'] += len(text)
69
+ if has_terms:
70
+ counts['with_terms'] += 1
71
+ else:
72
+ counts['missing_chars'] += len(text)
73
+ return RetrievalStats(**counts)
74
+
75
+
76
+ _STORE_TERMS = {
77
+ 'entity': '''
78
+ MATCH (item:Entity {uuid: $item_id, group_id: $group_id})
79
+ SET item.fuli_retrieval_terms = $terms, item.fuli_retrieval_context = $context,
80
+ item.fuli_retrieval_hash = $hash''',
81
+ 'relationship': '''
82
+ MATCH ()-[item:RELATES_TO {uuid: $item_id, group_id: $group_id}]->()
83
+ SET item.fuli_retrieval_terms = $terms, item.fuli_retrieval_context = $context,
84
+ item.fuli_retrieval_hash = $hash''',
85
+ }
86
+
87
+
88
+ async def write_retrieval_terms(store, actor, request: RetrievalTermsWrite) -> RetrievalTermsWriteResult:
89
+ space = await personal_reader_space(store, actor, request.personal_space_id)
90
+ written, skipped = 0, []
91
+ # One transaction: terms never land beside words other than those they were made from.
92
+ async with query_store_transaction(store) as scoped:
93
+ for item in request.items:
94
+ record = await locked_item(scoped, space, item.item_kind, item.item_id)
95
+ if record is None or semantic_hash(item_text(item.item_kind, record)) != item.hash:
96
+ skipped.append(item.item_id)
97
+ continue
98
+ await scoped.runtime.driver.execute_query(
99
+ _STORE_TERMS[item.item_kind], terms=item.terms, context=item.context, hash=item.hash,
100
+ item_id=item.item_id, group_id=space['group_id'])
101
+ written += 1
102
+ return RetrievalTermsWriteResult(written=written, skipped=skipped)
103
+
104
+
105
+ def register_knowledge_retrieval_routes(application, store, Actor) -> None:
106
+ @application.post('/v1/retrieval/candidates', response_model=RetrievalCandidatesPage)
107
+ async def candidates(request: RetrievalCandidatesRequest, actor: Actor):
108
+ return await retrieval_candidates(store, actor, request)
109
+
110
+ @application.post('/v1/retrieval/terms', response_model=RetrievalTermsWriteResult)
111
+ async def terms(request: RetrievalTermsWrite, actor: Actor):
112
+ return await write_retrieval_terms(store, actor, request)
113
+
114
+ @application.post('/v1/retrieval/stats', response_model=RetrievalStats)
115
+ async def stats(request: RetrievalStatsRequest, actor: Actor):
116
+ return await retrieval_stats(store, actor, request)