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
@@ -30,9 +30,10 @@ export function promptForMode(prompt, mode) {
30
30
  : prompt;
31
31
  }
32
32
 
33
- // The one bounded repair: the model sees its reply and why it was rejected.
34
- export function repairTurns(turns, reply, issues) {
33
+ // The one bounded repair: the model sees its reply, why it was rejected and the
34
+ // schema, which an endpoint that ignored it never showed.
35
+ export function repairTurns(turns, reply, issues, schema) {
35
36
  return [...turns,
36
37
  { role: 'assistant', text: reply.slice(0, REPAIR_ECHO_CHARS) || '(empty reply)' },
37
- { role: 'user', text: `Your previous reply was not valid: ${issues.join('; ')}. Reply again with only the corrected JSON object.` }];
38
+ { role: 'user', text: `Your previous reply was not valid: ${issues.join('; ')}. Reply again with only the corrected JSON object. It must match this JSON schema: ${JSON.stringify(schema)}` }];
38
39
  }
@@ -1,7 +1,7 @@
1
1
  import { randomUUID } from 'node:crypto';
2
2
  import { z } from 'zod';
3
3
 
4
- import { MODEL_BACKEND_ROLES, OPERATION_PATTERN } from './config.js';
4
+ import { KNOWLEDGE_EMBEDDING_OPERATION, MODEL_BACKEND_ROLES, OPERATION_PATTERN, SEMANTIC_ROLE } from './config.js';
5
5
  import { DECISIONS, DEFAULT_DECISIONS } from './decision-contract.js';
6
6
 
7
7
  // Caller input of the model port. Invalid input is a programming error and
@@ -10,6 +10,12 @@ import { DECISIONS, DEFAULT_DECISIONS } from './decision-contract.js';
10
10
  // so the egress check sees it; instructions and options are operation text.
11
11
 
12
12
  export const CONNECTION_CHECK = 'connection_check';
13
+ // The most texts one embedding call sends; a caller batches longer lists.
14
+ const MAX_EMBEDDING_TEXTS = 64;
15
+ const MAX_EMBEDDING_TEXT_CHARS = 20_000;
16
+ const CHECK_TEXT = 'FULI connection check.';
17
+ // The built-in Agents decide; the semantic role only embeds.
18
+ const DECISION_ROLES = MODEL_BACKEND_ROLES.filter(role => role !== SEMANTIC_ROLE);
13
19
 
14
20
  const id = z.string().trim().min(1).max(256);
15
21
  const key = z.string().regex(/^[A-Za-z0-9][A-Za-z0-9:._-]{0,127}$/);
@@ -23,12 +29,14 @@ const outputSchema = z.discriminatedUnion('type', [
23
29
  z.object({ type: z.literal('structured'), schema: z.looseObject({}) }).strict()
24
30
  ]);
25
31
 
32
+ const scopeSchema = z.object({ personalSpaceId: id, personalProjectId: id.nullable(), sessionRef: id.nullable() }).strict();
33
+
26
34
  const requestSchema = z.object({
27
- role: z.enum(MODEL_BACKEND_ROLES),
35
+ role: z.enum(DECISION_ROLES),
28
36
  operation: z.string().regex(OPERATION_PATTERN),
29
37
  requestId: id,
30
38
  sourceEventId: id.nullable().default(null),
31
- scope: z.object({ personalSpaceId: id, personalProjectId: id.nullable(), sessionRef: id.nullable() }).strict(),
39
+ scope: scopeSchema,
32
40
  versions: z.object({ evidence: id, policy: id }).strict(),
33
41
  instructions: z.string().trim().min(1).max(4000),
34
42
  evidence: z.array(z.object({ id: key, personalProjectId: id.nullable(), text: z.string().trim().min(1).max(20_000) }).strict())
@@ -40,6 +48,17 @@ const requestSchema = z.object({
40
48
  .partial().strict().default({})
41
49
  }).strict();
42
50
 
51
+ // Every text belongs to the request's project, or to none.
52
+ const embeddingSchema = z.object({
53
+ role: z.literal(SEMANTIC_ROLE),
54
+ operation: z.literal(KNOWLEDGE_EMBEDDING_OPERATION),
55
+ requestId: id,
56
+ scope: scopeSchema,
57
+ texts: z.array(z.string().trim().min(1).max(MAX_EMBEDDING_TEXT_CHARS)).min(1).max(MAX_EMBEDDING_TEXTS),
58
+ // A search waits only so long for its query's vector, then goes on by words.
59
+ budget: z.object({ timeoutMs: z.number().int().positive() }).strict().optional()
60
+ }).strict();
61
+
43
62
  const usageQuerySchema = z.object({
44
63
  role: z.enum(MODEL_BACKEND_ROLES).nullable().default(null),
45
64
  from: isoTime.nullable().default(null),
@@ -58,6 +77,18 @@ export function parseDecisionRequest(input) {
58
77
  return parse(requestSchema, input, 'model decision request');
59
78
  }
60
79
 
80
+ export function parseEmbeddingRequest(input) {
81
+ return parse(embeddingSchema, input, 'embedding request');
82
+ }
83
+
84
+ // What the egress check sees of an embedding request: each text as an item
85
+ // of the request's project. The connection check's fixed text is nobody's
86
+ // content, so it carries none.
87
+ export function embeddingEgress(request) {
88
+ const items = request.operation === CONNECTION_CHECK ? [] : request.texts;
89
+ return { scope: request.scope, evidence: items.map(() => ({ personalProjectId: request.scope.personalProjectId })) };
90
+ }
91
+
61
92
  export function parseRoleWorkClaim(input) {
62
93
  return parse(claimSchema, input, 'role work claim');
63
94
  }
@@ -83,6 +114,14 @@ export function connectionCheckRequest(role) {
83
114
  };
84
115
  }
85
116
 
117
+ // The semantic role's check: one short fixed text, no project.
118
+ export function embeddingCheckRequest() {
119
+ return {
120
+ role: SEMANTIC_ROLE, operation: CONNECTION_CHECK, requestId: `${CONNECTION_CHECK}:${randomUUID()}`,
121
+ scope: { personalSpaceId: 'connection-check', personalProjectId: null, sessionRef: null }, texts: [CHECK_TEXT]
122
+ };
123
+ }
124
+
86
125
  function parse(schema, input, label) {
87
126
  const result = schema.safeParse(input);
88
127
  if (!result.success) {
@@ -41,6 +41,8 @@ import {
41
41
  import { nonEmptyText } from '../validation/values.js';
42
42
  import { openChildProcessLog } from '../local-runtime/child-process-log.js';
43
43
  import { isProcessAlive } from '../local-runtime/processes.js';
44
+ import { diagnosticEventLog } from '../diagnostics/event-log.js';
45
+ import { errorCode } from '../diagnostics/safe-event.js';
44
46
  import { parseProviderEnv } from '../setup/provider-env.js';
45
47
  import { nativeInstanceLogPaths } from '../setup/paths.js';
46
48
  import { providerServerArguments } from './provider-arguments.js';
@@ -81,7 +83,9 @@ export function createNativeGraphServices({
81
83
  : platform === 'darwin' ? assertMacNativePortFree : async () => {},
82
84
  fetchImpl = globalThis.fetch,
83
85
  wait = delay,
84
- now = () => new Date()
86
+ now = () => new Date(),
87
+ // A start that failed, in the data directory's diagnostics log (rec#73).
88
+ recordFailure = paths.dataDir ? recordGraphServicesFailure(paths.dataDir) : () => {}
85
89
  }) {
86
90
  const descriptor = runtimeDescriptor ?? readJson(paths.nativeRuntimeManifestPath);
87
91
 
@@ -91,6 +95,7 @@ export function createNativeGraphServices({
91
95
  const stopDatabases = () => operation(() => stopDatabasesUnlocked());
92
96
 
93
97
  async function startUnlocked({ providers: startProviders = true } = {}) {
98
+ const startedAt = Date.now();
94
99
  if (platform === 'darwin') {
95
100
  const selected = readJson(paths.nativeRuntimeManifestPath);
96
101
  if (selected && (selected.status !== 'ready' || selected.neo4jHome !== descriptor?.neo4jHome)) throw new Error('Native Neo4j descriptor is stale or uninstalled. Recreate the service from the selected manifest.');
@@ -178,6 +183,7 @@ export function createNativeGraphServices({
178
183
  { ...(previousState.databases ?? {}), ...withoutStarted(databases, startedDatabases) },
179
184
  { ...(previousState.providers ?? {}), ...withoutStarted(providers, startedProviders) }
180
185
  );
186
+ recordFailure(error, Date.now() - startedAt);
181
187
  throw error;
182
188
  }
183
189
  }
@@ -797,17 +803,35 @@ function spawnNativeProvider(spec) {
797
803
  }
798
804
  }
799
805
 
806
+ // The reason each start failure may give; another error's message may name a local path.
807
+ const START_FAILURE_REASONS = Object.freeze({
808
+ provider_exited: 'the Graph Provider process exited during startup',
809
+ provider_not_ready: 'the Graph Provider did not become ready after starting',
810
+ provider_incompatible: 'the Graph Provider is incompatible with transcript capture'
811
+ });
812
+
813
+ function recordGraphServicesFailure(dataDir) {
814
+ const log = diagnosticEventLog(dataDir);
815
+ return (error, durationMs) => log.record({ component: 'provider', operation: 'native.start', outcome: 'failed',
816
+ code: errorCode(error), reason: START_FAILURE_REASONS[error?.code] ?? 'the native graph services did not start',
817
+ durationMs });
818
+ }
819
+
800
820
  async function waitForProvider(url, fetchImpl, wait, entry) {
801
821
  for (let attempt = 0; attempt < 120; attempt += 1) {
802
- if (entry?.ownership && !isProcessAlive(entry.pid)) throw new Error('The owned native Graph Provider exited during startup');
822
+ if (entry?.ownership && !isProcessAlive(entry.pid)) {
823
+ throw Object.assign(new Error('The owned native Graph Provider exited during startup'), { code: 'provider_exited' });
824
+ }
803
825
  const readiness = await providerReadiness(url, fetchImpl);
804
826
  if (readiness === 'ready') return;
805
827
  if (readiness === 'incompatible') {
806
- throw new Error('The native Graph Provider is incompatible with transcript capture. Upgrade the Provider and restart local services when existing sessions can release them.');
828
+ throw Object.assign(new Error('The native Graph Provider is incompatible with transcript capture. Upgrade the Provider and restart local services when existing sessions can release them.'),
829
+ { code: 'provider_incompatible' });
807
830
  }
808
831
  if (attempt < 119) await wait(1000);
809
832
  }
810
- throw new Error('The native graph Provider did not become ready after starting.');
833
+ throw Object.assign(new Error('The native graph Provider did not become ready after starting.'),
834
+ { code: 'provider_not_ready' });
811
835
  }
812
836
 
813
837
  async function providerReady(url, fetchImpl) {
@@ -0,0 +1,17 @@
1
+ import { ApplicationError, InvalidInputError } from '../app/application-error.js';
2
+
3
+ // read_old_data (rec#80 group B): the same list and read-only look the
4
+ // console's 存储 card has, for the person's own AI.
5
+ export const OLD_DATA_HANDLERS = Object.freeze({
6
+ read_old_data: async (app, { id = null, path = null } = {}) => {
7
+ if (path !== null && id === null) throw new InvalidInputError('path needs the id of the old data it is in');
8
+ return id === null ? shelf(app).list() : shelf(app).read({ id, path });
9
+ }
10
+ });
11
+
12
+ function shelf(app) {
13
+ if (!app.oldData) {
14
+ throw new ApplicationError('old_data_unavailable', 'Old data needs a local FULI installation', { status: 503 });
15
+ }
16
+ return app.oldData;
17
+ }
@@ -0,0 +1,78 @@
1
+ import { closeSync, lstatSync, openSync, readdirSync, readSync } from 'node:fs';
2
+ import { basename, join } from 'node:path';
3
+ import { redactSensitiveContent } from '../security/sensitive-content.js';
4
+ import { unreadable } from './guarded-stores.js';
5
+
6
+ import { ApplicationError } from '../app/application-error.js';
7
+
8
+ // The person's own AI reads an old-data item read-only (rec#80 group B): the
9
+ // files it holds, then one text or JSON file. A path is never resolved from
10
+ // what the caller sent: it must be one of the files listed for that item, so
11
+ // nothing outside the backup can be named, links are not followed and a
12
+ // directory is not read. A file with a NUL byte in what is read, or a known
13
+ // binary extension (SQLite, Neo4j dump), is refused instead of shown.
14
+
15
+ const MAX_LISTED_FILES = 200;
16
+ const MAX_READ_BYTES = 32 * 1024;
17
+ const BINARY_EXTENSIONS = /\.(sqlite|sqlite-wal|sqlite-shm|db|dump|gz|zip)$/i;
18
+
19
+ // item: an inventory item (targets: its absolute files or directories).
20
+ export function listBackupFiles(item) {
21
+ const files = itemFiles(item);
22
+ return { files: files.slice(0, MAX_LISTED_FILES).map(({ path, bytes }) => ({ path, bytes })),
23
+ truncated: files.length > MAX_LISTED_FILES };
24
+ }
25
+
26
+ export function readBackupFile(item, path) {
27
+ const file = itemFiles(item).find((entry) => entry.path === path);
28
+ if (!file) {
29
+ throw new ApplicationError('old_data_file_not_found', `${item.id} holds no file ${path}; list its files first`,
30
+ { status: 404 });
31
+ }
32
+ if (unreadable(item)) {
33
+ throw new ApplicationError('old_data_secret', `${item.id} may hold credentials, so its files are listed and not shown`,
34
+ { status: 403 });
35
+ }
36
+ if (BINARY_EXTENSIONS.test(path)) throw binary(item, path);
37
+ const buffer = readPrefix(file.absolute, Math.min(file.bytes, MAX_READ_BYTES));
38
+ if (buffer.includes(0)) throw binary(item, path);
39
+ const truncated = file.bytes > buffer.length;
40
+ // A streaming decode holds back a character the cut split instead of showing half of it.
41
+ return { id: item.id, path, bytes: file.bytes, truncated,
42
+ content: redactSensitiveContent(new TextDecoder().decode(buffer, { stream: truncated })) };
43
+ }
44
+
45
+ function binary(item, path) {
46
+ return new ApplicationError('old_data_binary', `${item.id}: ${path} is not a text file and is not shown`,
47
+ { status: 415 });
48
+ }
49
+
50
+ // A single directory's files are named inside it; a file, or one of several, by its name.
51
+ function itemFiles(item) {
52
+ const inside = item.targets.length === 1 && isDirectory(item.targets[0]);
53
+ return item.targets.flatMap((target) => walk(target, inside ? '' : basename(target)));
54
+ }
55
+
56
+ // Files only, depth first, in name order; links and anything that is not a
57
+ // regular file or directory are skipped.
58
+ function walk(absolute, path) {
59
+ let stats;
60
+ try { stats = lstatSync(absolute); } catch { return []; }
61
+ if (stats.isFile()) return [{ absolute, path, bytes: stats.size }];
62
+ if (!stats.isDirectory()) return [];
63
+ return readdirSync(absolute).sort().flatMap((name) => walk(join(absolute, name), path ? `${path}/${name}` : name));
64
+ }
65
+
66
+ function isDirectory(path) {
67
+ try { return lstatSync(path).isDirectory(); } catch { return false; }
68
+ }
69
+
70
+ function readPrefix(path, length) {
71
+ const buffer = Buffer.alloc(length);
72
+ const descriptor = openSync(path, 'r');
73
+ try {
74
+ return buffer.subarray(0, readSync(descriptor, buffer, 0, length, 0));
75
+ } finally {
76
+ closeSync(descriptor);
77
+ }
78
+ }
@@ -0,0 +1,53 @@
1
+ import { rmSync } from 'node:fs';
2
+ import { personOnlyRestore } from './guarded-stores.js';
3
+
4
+ import { ApplicationError } from '../app/application-error.js';
5
+ import { formatBackupNeeded } from '../data-format/backup-retention.js';
6
+ import { recordFormatOperations } from '../data-format/operations-log.js';
7
+ import { removeChildLogArchives } from '../local-runtime/child-process-log.js';
8
+
9
+ // The console's two old-data actions (rec#80 group B), on the local console only.
10
+ // - 恢复 puts a store's format backup back through the console's whole-store
11
+ // restore (data-format/console-restore.js): it stops FULI, keeps the store as
12
+ // it is now as a new format backup and starts FULI again, so the restore is
13
+ // itself undone by restoring that backup. No other kind has a console restore.
14
+ // - 立即删除 removes the item for good: a log's kept copies the way 「清理旧日志」
15
+ // removes them, anything else as files. A format backup an undo or the current
16
+ // version still needs is refused, as pruning keeps it; one that goes is logged
17
+ // like a pruned backup.
18
+ // shelf: the data directory's old-data port; restore: consoleRestore() or null.
19
+ export function createOldDataConsole({ shelf, restore = null, now = () => new Date(),
20
+ remove = (path) => rmSync(path, { recursive: true, force: true }) }) {
21
+ return {
22
+ async restore(id, { delegated = false } = {}) {
23
+ const item = await shelf.find(id);
24
+ if (delegated && personOnlyRestore(item)) {
25
+ throw new ApplicationError('old_data_restore_person_only', `${id} goes back only by the person's own click in Settings`, { status: 403 });
26
+ }
27
+ if (!item.restorable || !restore) {
28
+ throw new ApplicationError('old_data_not_restorable', `${id} has no restore in the console`
29
+ + (item.restoreCommand ? `; restore it at a terminal: ${item.restoreCommand}` : ''), { status: 409 });
30
+ }
31
+ const { currentDigest } = restore.describe(item.label, item.ref);
32
+ const started = restore.start({ label: item.label, backupRef: item.ref, currentDigest });
33
+ shelf.forgetMeasurement();
34
+ return { id, restore: started };
35
+ },
36
+ async delete(id) {
37
+ const item = await shelf.find(id);
38
+ if (item.kind === 'format_backup' && formatBackupNeeded(shelf.dataDir, item.label, item.ref)) {
39
+ throw new ApplicationError('old_data_needed', `${id} is still needed to undo a migration or to restore the `
40
+ + 'store\'s current version; FULI keeps it', { status: 409 });
41
+ }
42
+ if (item.kind === 'log_archive') removeChildLogArchives(item.logPath);
43
+ else item.targets.forEach(remove);
44
+ if (item.kind === 'format_backup') {
45
+ recordFormatOperations(shelf.dataDir, [{ kind: 'pruned', store: item.store, label: item.label,
46
+ backupRef: item.ref, version: item.version, bytes: item.bytes, reason: 'deleted now by the person',
47
+ at: now().toISOString() }]);
48
+ }
49
+ shelf.forgetMeasurement();
50
+ return { id, freedBytes: item.bytes };
51
+ }
52
+ };
53
+ }
@@ -0,0 +1,18 @@
1
+ import { AGENT_DELEGATION_FORMAT } from '../agent-delegation/operation-log.js';
2
+ import { AGENT_DELEGATION_POLICY_FORMAT } from '../agent-delegation/policy-store.js';
3
+ import { AGENT_ACCESS_POLICY_FORMAT } from '../graphiti/agent-access-policy.js';
4
+ import { GRAPH_RUNTIME_CONFIG_FORMAT } from '../graphiti/runtime-config.js';
5
+ import { MODEL_BACKEND_CONFIG_FORMAT } from '../model-backends/config.js';
6
+ import { MODEL_SECRETS_FORMAT } from '../model-backends/secret-store.js';
7
+
8
+ // Old data an Agent must not reach through the shelf. A backup of a store that
9
+ // holds credentials, and a copy of a client's config (it may carry MCP tokens),
10
+ // are listed but never read. Those stores, what limits an Agent and the record
11
+ // of what Agents did go back only by the person's own click: an FLA restoring
12
+ // them could undo the limits on itself or the record of its actions.
13
+ const SECRET_STORES = new Set([MODEL_SECRETS_FORMAT.store, MODEL_BACKEND_CONFIG_FORMAT.store, GRAPH_RUNTIME_CONFIG_FORMAT.store]);
14
+ const PERSON_ONLY_RESTORES = new Set([...SECRET_STORES, AGENT_ACCESS_POLICY_FORMAT.store,
15
+ AGENT_DELEGATION_POLICY_FORMAT.store, AGENT_DELEGATION_FORMAT.store]);
16
+
17
+ export const unreadable = (item) => item.kind === 'client_config_backup' || SECRET_STORES.has(item.store);
18
+ export const personOnlyRestore = (item) => PERSON_ONLY_RESTORES.has(item.store);
@@ -0,0 +1,142 @@
1
+ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
2
+ import { basename, dirname, join, relative, sep } from 'node:path';
3
+
4
+ import { BACKUP_DIRECTORY, formatBackupsOf } from '../../packages/roundtable/src/storage/format-backup-names.js';
5
+ import { localStoreFiles } from '../data-format/local-stores.js';
6
+ import { readFormatOperations } from '../data-format/operations-log.js';
7
+ import { childLogArchives } from '../local-runtime/child-process-log.js';
8
+ import { allocatedPathSize } from '../system/resource-monitor.js';
9
+ import { fuliLogPaths } from '../system/log-paths.js';
10
+
11
+ // 旧数据 (rec#80 group B): the copies FULI already keeps under the data
12
+ // directory before it changes something, listed in one place so the person
13
+ // (or their own AI) sees what each is, which action left it, when and how big,
14
+ // and whether FULI can put it back. Nothing here writes. Each item names the
15
+ // restore that already exists for it: only a store's format backup has one in
16
+ // the console (data-format/console-restore.js); a graph export is imported
17
+ // again at a terminal (fuli graph import); the others have none.
18
+ //
19
+ // What is not listed: graph undo journals live inside the graph and are
20
+ // pruned by the format retention budget (format-retention.js); permanent
21
+ // deletes keep no content (knowledge-hard-delete/delete-ledger.js).
22
+
23
+ // Kinds: format_backup, graph_export, settings_backup, client_config_backup, log_archive.
24
+ const GRAPH_IMPORT = 'fuli graph import --input <folder>';
25
+
26
+ // Every old-data item of one data directory, newest first. paths: resolveSetupPaths().
27
+ export async function oldDataInventory(paths) {
28
+ const found = [
29
+ ...formatBackups(paths.dataDir),
30
+ ...graphExports(paths.graphBackupDir),
31
+ ...childEntries(paths.runtimeSettingsBackupDir, 'settings_backup', settingsLeft),
32
+ ...childEntries(paths.backupDir, 'client_config_backup', clientConfigLeft),
33
+ ...logArchives(paths)
34
+ ];
35
+ const items = await Promise.all(found.map(async (item) => ({
36
+ ...item,
37
+ id: `${item.kind}:${relativeTo(paths.dataDir, item.anchor)}`,
38
+ path: relativeTo(paths.dataDir, item.anchor),
39
+ bytes: (await Promise.all(item.targets.map(allocatedPathSize))).reduce((sum, bytes) => sum + bytes, 0)
40
+ })));
41
+ return items.sort((a, b) => b.createdAt.localeCompare(a.createdAt) || a.id.localeCompare(b.id));
42
+ }
43
+
44
+ // What a caller outside this module sees of an item: never an absolute path.
45
+ export function publicOldDataItem({ id, kind, path, left, createdAt, bytes, restorable, restoreCommand }) {
46
+ return { id, kind, path, left, createdAt, bytes, restorable, restoreCommand };
47
+ }
48
+
49
+ function formatBackups(dataDir) {
50
+ const operations = readFormatOperations(dataDir);
51
+ return localStoreFiles(dataDir).flatMap((store) => formatBackupsOf(store.path).map((backup) => {
52
+ const file = join(dirname(store.path), BACKUP_DIRECTORY, backup.name);
53
+ return { kind: 'format_backup', anchor: file, targets: [file], label: store.label, store: store.format.store, ref: backup.ref,
54
+ version: backup.version, createdAt: backup.takenAt, left: formatBackupLeft(store.label, backup, operations),
55
+ restorable: true, restoreCommand: null };
56
+ }));
57
+ }
58
+
59
+ // The operations log names the step a backup was taken for; an older backup
60
+ // the log no longer holds says only what it is.
61
+ function formatBackupLeft(label, backup, operations) {
62
+ const same = (event) => event.label === label;
63
+ if (operations.some((event) => same(event) && event.kind === 'restored' && event.safetyBackupRef === backup.ref)) {
64
+ return { zh: `整体恢复前保留的 ${label}`, en: `${label} as it was before a whole-store restore` };
65
+ }
66
+ const applied = operations.find((event) => same(event) && event.kind === 'applied' && event.backupRef === backup.ref);
67
+ if (applied) {
68
+ return { zh: `升级数据格式前的 ${label}(v${applied.fromVersion}→v${applied.toVersion})`,
69
+ en: `${label} before its data format went from v${applied.fromVersion} to v${applied.toVersion}` };
70
+ }
71
+ return { zh: `数据格式变更前的 ${label}(v${backup.version})`,
72
+ en: `${label} before a data format change (v${backup.version})` };
73
+ }
74
+
75
+ function graphExports(root) {
76
+ return directoryEntries(root).filter(({ name, stats }) => stats.isDirectory() && !name.includes('.partial-'))
77
+ .map(({ path, name, stats }) => {
78
+ const manifest = readManifest(path);
79
+ return { kind: 'graph_export', anchor: path, targets: [path], left: graphExportLeft(name),
80
+ createdAt: validTime(manifest?.createdAt) ?? stats.mtime.toISOString(), restorable: false,
81
+ restoreCommand: manifest ? GRAPH_IMPORT : null };
82
+ });
83
+ }
84
+
85
+ function graphExportLeft(name) {
86
+ const neo4j = /^before-neo4j-(.+?)-\d{4}-\d{2}-\d{2}T/.exec(name);
87
+ if (neo4j) return { zh: `升级 Neo4j ${neo4j[1]} 前的图谱`, en: `The graph before the Neo4j ${neo4j[1]} upgrade` };
88
+ if (name.startsWith('container-to-native-')) {
89
+ return { zh: '从 Docker 迁到内置图谱时导出的图谱', en: 'The graph exported when it moved from Docker to the built-in graph' };
90
+ }
91
+ if (name.startsWith('before-import-')) return { zh: '导入图谱前保留的图谱', en: 'The graph kept before a graph import' };
92
+ return { zh: '图谱导出', en: 'A graph export' };
93
+ }
94
+
95
+ function settingsLeft() {
96
+ return { zh: '更换控制台端口前的运行设置', en: 'Runtime settings before the console port was changed' };
97
+ }
98
+
99
+ // One item per client: what agent-installer and the legacy hook cleanup copied
100
+ // before they changed that client's configuration.
101
+ function clientConfigLeft(name) {
102
+ return { zh: `接入前保存的 ${name} 原配置`, en: `${name}'s configuration as it was before FULI connected it` };
103
+ }
104
+
105
+ function childEntries(root, kind, left) {
106
+ return directoryEntries(root).map(({ path, name, stats }) => ({ kind, anchor: path, targets: [path],
107
+ left: left(name), createdAt: stats.mtime.toISOString(), restorable: false, restoreCommand: null }));
108
+ }
109
+
110
+ // One item per log: the copies rotation kept (`.1` to `.3`), never the log itself.
111
+ function logArchives(paths) {
112
+ return fuliLogPaths(paths).flatMap((logPath) => {
113
+ const copies = childLogArchives(logPath);
114
+ if (!copies.length) return [];
115
+ const newest = Math.max(...copies.map(({ path }) => statSync(path).mtimeMs));
116
+ return [{ kind: 'log_archive', anchor: logPath, logPath, targets: copies.map(({ path }) => path),
117
+ left: { zh: `日志超过 50 MB 后留下的旧 ${basename(logPath)}`, en: `Older ${basename(logPath)} kept after it passed 50 MB` },
118
+ createdAt: new Date(newest).toISOString(), restorable: false, restoreCommand: null }];
119
+ });
120
+ }
121
+
122
+ function directoryEntries(root) {
123
+ if (!root || !existsSync(root)) return [];
124
+ return readdirSync(root, { withFileTypes: true }).filter((entry) => !entry.isSymbolicLink())
125
+ .map((entry) => ({ name: entry.name, path: join(root, entry.name), stats: statSync(join(root, entry.name)) }));
126
+ }
127
+
128
+ function readManifest(directory) {
129
+ try {
130
+ return JSON.parse(readFileSync(join(directory, 'manifest.json'), 'utf8'));
131
+ } catch {
132
+ return null;
133
+ }
134
+ }
135
+
136
+ function validTime(value) {
137
+ return typeof value === 'string' && Number.isFinite(Date.parse(value)) ? new Date(value).toISOString() : null;
138
+ }
139
+
140
+ function relativeTo(dataDir, path) {
141
+ return relative(dataDir, path).split(sep).join('/');
142
+ }
@@ -0,0 +1,53 @@
1
+ import { ApplicationError } from '../app/application-error.js';
2
+ import { allocatedDirectorySize } from '../system/resource-monitor.js';
3
+ import { listBackupFiles, readBackupFile } from './backup-reader.js';
4
+ import { oldDataInventory, publicOldDataItem } from './inventory.js';
5
+
6
+ // 旧数据 for one data directory (rec#80 group B): the list with how much the
7
+ // live data and the old data take, and a read-only look into one item. The
8
+ // console and the person's own AI (read_old_data) read the same port; restore
9
+ // and delete-now are the console's (console-actions.js).
10
+ //
11
+ // The whole data directory is measured as the resource monitor measures it
12
+ // and kept for a minute, so opening the list again does not rescan every
13
+ // file; a delete or restore forgets the measurement.
14
+ const DATA_SIZE_CACHE_MS = 60_000;
15
+
16
+ export function createOldDataShelf({ paths, now = () => Date.now(), measure = allocatedDirectorySize }) {
17
+ let measured = null;
18
+
19
+ async function dataBytes() {
20
+ if (measured && now() - measured.at < DATA_SIZE_CACHE_MS) return measured;
21
+ const at = now();
22
+ measured = { at, bytes: await measure(paths.dataDir) };
23
+ return measured;
24
+ }
25
+
26
+ async function find(id) {
27
+ const item = (await oldDataInventory(paths)).find((candidate) => candidate.id === id);
28
+ if (!item) throw new ApplicationError('old_data_not_found', `No old data is listed as ${id}`, { status: 404 });
29
+ return item;
30
+ }
31
+
32
+ return {
33
+ dataDir: paths.dataDir,
34
+ // items newest first; summary: live data (the data directory without the
35
+ // old data, which all lies inside it), old data, and both together.
36
+ async list() {
37
+ const [items, data] = await Promise.all([oldDataInventory(paths), dataBytes()]);
38
+ const oldBytes = items.reduce((sum, item) => sum + item.bytes, 0);
39
+ const totalBytes = Math.max(data.bytes, oldBytes);
40
+ return { items: items.map(publicOldDataItem),
41
+ summary: { liveBytes: totalBytes - oldBytes, oldBytes, totalBytes, measuredAt: new Date(data.at).toISOString() } };
42
+ },
43
+ // Without path: the item and its files. With path: one listed text file, bounded.
44
+ async read({ id, path = null }) {
45
+ const item = await find(id);
46
+ return path === null ? { item: publicOldDataItem(item), ...listBackupFiles(item) } : readBackupFile(item, path);
47
+ },
48
+ find,
49
+ forgetMeasurement() {
50
+ measured = null;
51
+ }
52
+ };
53
+ }
@@ -6,7 +6,8 @@ import { singleLine } from '../text/single-line.js';
6
6
  // The person's own home (「我」): what FULI and Agents call them and the
7
7
  // picture they show as 「我」. Kept on this computer only, in
8
8
  // person-profile.json under the data directory; only the person changes it,
9
- // in the console (local_user_only). Agents get the name as one short field of
9
+ // in the console or through an FLA that relays their words (agent_relayed,
10
+ // rec#80). Agents get the name as one short field of
10
11
  // the preferences they already read (context.address_as), never the picture.
11
12
  export const PERSON_PROFILE_FORMAT = jsonFormat({ store: 'person-profile', versions: [1] });
12
13
  const PERSON_NAME_MAX_CHARS = 32;
@@ -3,4 +3,4 @@
3
3
  // and writes its digest here before publishing (scripts/pin-win-helper.js); a
4
4
  // source checkout has no helper and no pin, so Windows Hello is unavailable there.
5
5
  // The helper is not Authenticode-signed: this digest is its only integrity check.
6
- export const WIN_HELPER_SHA256 = 'a85dd135812ec53e22358c815e5ef9036f27b71857a3ecdcbea9847aa7afcaaf';
6
+ export const WIN_HELPER_SHA256 = '1bcf9774d56aca66a91d229525522b8514dfa96b4ace9709aeef2ba941a3c488';
@@ -0,0 +1,65 @@
1
+ import { AUTHORED_FIELDS, fieldText } from '../graphiti/project-profile-authors.js';
2
+ import { positiveInteger, requiredString } from '../validation/values.js';
3
+ import { ProjectChangeStore } from './store.js';
4
+
5
+ // The fields a person reads as the project's profile. The assessment and the
6
+ // brief draft are left out: FULI recomputes them, so they say nothing about
7
+ // what someone changed; `authors` only follows the fields below.
8
+ const PROFILE_TEXT = Object.freeze({
9
+ name: (profile) => fieldText(profile?.name),
10
+ ...Object.fromEntries(AUTHORED_FIELDS.map((field) => [field, (profile) => fieldText(profile?.[field])])),
11
+ lifecycle: (profile) => fieldText(profile?.lifecycle),
12
+ sources: (profile) => (profile?.sources ?? []).map(sourceText).join('\n')
13
+ });
14
+
15
+ const PROJECT_ID_MAX_CHARS = 128;
16
+ const DEFAULT_LIMIT = 50;
17
+ const MAX_LIMIT = 200;
18
+
19
+ export function createProjectChangeLog({ path = ':memory:', now = () => new Date(),
20
+ warn = (message) => process.stderr.write(`${message}\n`) } = {}) {
21
+ const store = new ProjectChangeStore(path);
22
+
23
+ return {
24
+ // `previous` is the stored profile before the save (null for a new
25
+ // project), `saved` what the Provider answered: a field an Agent was
26
+ // refused is unchanged there. The save already happened, so a failure here
27
+ // is reported and stops at this line.
28
+ record({ personalSpaceId, projectId, writer, previous, saved }) {
29
+ try {
30
+ const changes = profileChanges(previous, saved.profile);
31
+ if (!changes.length) return;
32
+ store.add({ personalSpaceId, projectId, at: now().toISOString(), actor: changeActor(writer), changes });
33
+ } catch (error) {
34
+ warn(`The profile of project ${projectId} was saved, but its change log was not written: ${error?.message ?? error}`);
35
+ }
36
+ },
37
+
38
+ list({ personalSpaceId, projectId, limit }) {
39
+ const id = requiredString(projectId, 'projectId', PROJECT_ID_MAX_CHARS);
40
+ const count = positiveInteger(limit ?? DEFAULT_LIMIT, 'limit', MAX_LIMIT);
41
+ const entries = store.recent(personalSpaceId, id, count + 1);
42
+ return { entries: entries.slice(0, count), hasMore: entries.length > count };
43
+ },
44
+
45
+ close: () => store.close()
46
+ };
47
+ }
48
+
49
+ function profileChanges(previous, saved) {
50
+ return Object.entries(PROFILE_TEXT).flatMap(([field, text]) => {
51
+ const before = text(previous);
52
+ const after = text(saved);
53
+ return before === after ? [] : [{ field, before, after }];
54
+ });
55
+ }
56
+
57
+ // An Agent writer with neither an id nor a name is FULI's own draft.
58
+ function changeActor({ kind, agentId = null, agentName = null }) {
59
+ if (kind === 'person') return { kind, agentId: null, agentName: null };
60
+ return agentId || agentName ? { kind, agentId, agentName } : { kind: 'fuli', agentId: null, agentName: null };
61
+ }
62
+
63
+ function sourceText({ title, uri, summary }) {
64
+ return [title, uri, summary].filter(Boolean).join(' · ');
65
+ }