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.
- package/dist/web/assets/{AboutPage-BHbNacTY.js → AboutPage-S8QFfzpA.js} +1 -1
- package/dist/web/assets/AboutSectionHeading-B5CzH4Zs.js +1 -0
- package/dist/web/assets/AboutSectionHeading-DjXpIV27.css +1 -0
- package/dist/web/assets/AgentAppsPage-BYXraPFM.js +1 -0
- package/dist/web/assets/{AgentHand-BGzGOjzl.js → AgentHand-BGGdVdd9.js} +1 -1
- package/dist/web/assets/AgentManagement-Bza8k5ra.js +7 -0
- package/dist/web/assets/AgentManagement-CeF4mjtg.css +1 -0
- package/dist/web/assets/AgentMentionCopy-C72hY2QL.js +1 -0
- package/dist/web/assets/{AgentName-C5HzUHaA.js → AgentName-CUjBNQ8j.js} +1 -1
- package/dist/web/assets/AgentProfilePage-D5QUzw5N.css +1 -0
- package/dist/web/assets/AgentProfilePage-kp7-gRRx.js +5 -0
- package/dist/web/assets/AgentServicesPage-IsGaz7FY.js +1 -0
- package/dist/web/assets/{AppViewerPage-N5C_6WLz.css → AppViewerPage-CJ0Zy6LA.css} +1 -1
- package/dist/web/assets/AppViewerPage-CcOlwxck.js +1 -0
- package/dist/web/assets/{BackToTop-SL4ai3_g.js → BackToTop-C3KYEoCW.js} +1 -1
- package/dist/web/assets/BoardCardFieldsMenu-BlBWT1j7.js +1 -0
- package/dist/web/assets/BoardMoveMenu-Bc7xC1Uh.js +1 -0
- package/dist/web/assets/Breadcrumb-BbwBNrG2.css +1 -0
- package/dist/web/assets/Breadcrumb-C_xMiD-Z.js +1 -0
- package/dist/web/assets/CaptureChangePage-Bekp1aWg.js +1 -0
- package/dist/web/assets/ConnectionsPage-BpvecWXD.js +1 -0
- package/dist/web/assets/{CopyFixPrompt-CCrPxN5x.js → CopyFixPrompt-Bp-UX4Hq.js} +1 -1
- package/dist/web/assets/DataFormatPage-dsy8d3oA.js +2 -0
- package/dist/web/assets/DataFormatPage-sSnjjUY4.css +1 -0
- package/dist/web/assets/DebugTurnPage-HdFAyc2D.css +1 -0
- package/dist/web/assets/DebugTurnPage-cIJV7xDW.js +1 -0
- package/dist/web/assets/DebugTurnsPage-B6Te_Alp.js +1 -0
- package/dist/web/assets/DebugTurnsPage-BFuOzyWR.css +1 -0
- package/dist/web/assets/{DialogTitle-CTKjDGQc.js → DialogTitle-Lj5s6nwG.js} +1 -1
- package/dist/web/assets/EmployeeRedirectPage-DnvwJeCN.js +1 -0
- package/dist/web/assets/EmployeeScopeDialog-CXNZ62Ab.js +1 -0
- package/dist/web/assets/EmployeeWorkbench-BhReI8l6.css +1 -0
- package/dist/web/assets/EmployeeWorkbench-DALIO-cM.js +4 -0
- package/dist/web/assets/FieldRoot-DRnAC66O.js +1 -0
- package/dist/web/assets/FlaGrowth-7wlv31Tl.js +1 -0
- package/dist/web/assets/FlaGrowth-BzXY8pcx.css +1 -0
- package/dist/web/assets/FlaTaskSheets-CNdaBy1P.js +1 -0
- package/dist/web/assets/FlasPage-BCs1Ffpf.js +1 -0
- package/dist/web/assets/{FlasPage-Cb6Q5lge.css → FlasPage-SLQDMv47.css} +1 -1
- package/dist/web/assets/{button-CaCh3Iim.css → GrowthLoading-CigPij0N.css} +1 -1
- package/dist/web/assets/GrowthLoading-Cr8xZwwO.js +1 -0
- package/dist/web/assets/HowtoPage-Cv1YQy1s.js +1 -0
- package/dist/web/assets/{HowtoPage-BRV2W1Go.css → HowtoPage-t12tDDpS.css} +1 -1
- package/dist/web/assets/{InboxPage-DSOmt6VL.js → InboxPage-CgJnymOY.js} +2 -2
- package/dist/web/assets/KnowledgeDeleteButton-FEyEvhlR.js +1 -0
- package/dist/web/assets/KnowledgeHardDeleteSection-CVwTeMEJ.js +1 -0
- package/dist/web/assets/KnowledgeItemEditPage-rwpM8cF1.js +1 -0
- package/dist/web/assets/{KnowledgeItemSummaryCard-D1h0e1Hn.js → KnowledgeItemSummaryCard-49EADY_Z.js} +1 -1
- package/dist/web/assets/KnowledgeOrganizerPage-7IdnjM3L.js +1 -0
- package/dist/web/assets/KnowledgePage-gxqOIZxf.js +1 -0
- package/dist/web/assets/KnowledgePeek-Bm5jRVA9.css +1 -0
- package/dist/web/assets/KnowledgePeek-CQyCxHFj.js +1 -0
- package/dist/web/assets/KnowledgeTurnReceiptPage-BOz7IpaK.js +1 -0
- package/dist/web/assets/KnowledgeWorkspace-A7zVb26p.js +4 -0
- package/dist/web/assets/KnowledgeWorkspace-DCoVFyf0.css +1 -0
- package/dist/web/assets/{MeAvatar-DHJA3h2E.js → MeAvatar-CYVcRiuW.js} +1 -1
- package/dist/web/assets/{MeLink-CU7zuYgD.js → MeLink-BdqkzhT6.js} +1 -1
- package/dist/web/assets/{MenuSeparator-DV3U0Y8_.js → MenuSeparator-quqkZZXY.js} +1 -1
- package/dist/web/assets/ModelSettingsPage-B8jC_uew.js +3 -0
- package/dist/web/assets/ModelSettingsPage-DhCn_SF6.css +1 -0
- package/dist/web/assets/{NotFoundPage-BMWxdf6r.js → NotFoundPage-Dmn32VWo.js} +1 -1
- package/dist/web/assets/OccupationsPage-BVREfX_R.js +1 -0
- package/dist/web/assets/OverviewPage-CHyEbdP4.js +1 -0
- package/dist/web/assets/OverviewPage-xdF5g6bZ.css +1 -0
- package/dist/web/assets/{PageColumns-D7jIeVv6.js → PageColumns-DpfaPeu7.js} +1 -1
- package/dist/web/assets/PageOutline-BKBQ1T4d.js +1 -0
- package/dist/web/assets/PageOutline-BqVgnlos.css +1 -0
- package/dist/web/assets/PersonalProfilePage-Cxp2gn6J.js +1 -0
- package/dist/web/assets/PersonalProjectsPage-821imOxR.js +1 -0
- package/dist/web/assets/{PinIcon-DzYhXU_p.js → PinIcon-B7dvh7ld.js} +1 -1
- package/dist/web/assets/{PopperContent-BnejG-fO.js → PopperContent-DNqbLkNa.js} +1 -1
- package/dist/web/assets/{Presence-o9BoSyBV.js → Presence-D3HKb5Hb.js} +1 -1
- package/dist/web/assets/ProfileAuthorChip-7HSHODdR.js +1 -0
- package/dist/web/assets/ProfileAuthorChip-C_0hzDoP.css +1 -0
- package/dist/web/assets/ProjectAgentsPage-DBsXS6Xa.js +5 -0
- package/dist/web/assets/{ProjectAgentsPage-Dt37ogX1.css → ProjectAgentsPage-RpfiV2Fm.css} +1 -1
- package/dist/web/assets/ProjectJudgmentPolicy-GA33aSRi.js +2 -0
- package/dist/web/assets/PublicProjectsPage-PJlBI8IE.js +1 -0
- package/dist/web/assets/{RoundtablesPage-C6vo4kl6.css → RoundtablesPage-DK9A9J-y.css} +1 -1
- package/dist/web/assets/{RoundtablesPage-B2mqkwwR.js → RoundtablesPage-DT5DUXsa.js} +2 -2
- package/dist/web/assets/{RovingFocusGroup-CKxT5j44.js → RovingFocusGroup-BB0d3k17.js} +1 -1
- package/dist/web/assets/{RovingFocusItem-Cr-XrVve.js → RovingFocusItem-CFd7tXzD.js} +1 -1
- package/dist/web/assets/SessionMigrationPage-BZ1lEDQr.js +1 -0
- package/dist/web/assets/SessionRecordsPage-BMAAtIAt.js +1 -0
- package/dist/web/assets/SettingsPage-BYNEk6BM.js +1 -0
- package/dist/web/assets/SettingsPage-Uj1IpZpS.css +1 -0
- package/dist/web/assets/SharedJefaReportPage-g35o6jUb.js +1 -0
- package/dist/web/assets/TagVocabularyPage-COubNJXz.js +1 -0
- package/dist/web/assets/{TaskBlockerClear-38qdj0bl.js → TaskBlockerClear-B5MpHdlh.js} +1 -1
- package/dist/web/assets/{TaskBlockerNotice--X8TtCGj.js → TaskBlockerNotice-CIN0HRiE.js} +1 -1
- package/dist/web/assets/{TaskReason-COiuiZVd.js → TaskReason-LQ0CFiKu.js} +1 -1
- package/dist/web/assets/{TeamCard-Bl4riuQt.css → TeamCard-CsmWDw2Q.css} +1 -1
- package/dist/web/assets/TeamCard-D-kLa5rT.js +1 -0
- package/dist/web/assets/TeamCardsWidget-DGX9k0S6.js +1 -0
- package/dist/web/assets/{TeamIsland-D8ycFpkZ.js → TeamIsland-BIo-l49b.js} +2 -2
- package/dist/web/assets/{Teleport-BAIkXp2z.js → Teleport-C1upABpY.js} +1 -1
- package/dist/web/assets/{TextField-BFGv0VA5.js → TextField-ZnmRqG0h.js} +1 -1
- package/dist/web/assets/{UiChip-h_SUumBM.js → UiChip-CizeOu1Q.js} +1 -1
- package/dist/web/assets/UiDialog-CGTzxn3-.js +1 -0
- package/dist/web/assets/{UiDisclosure-BO5EAYyS.js → UiDisclosure-ueMA4jl0.js} +1 -1
- package/dist/web/assets/UiIcon-sD1hUsOF.js +1 -0
- package/dist/web/assets/{UiIconButton-C0WP-F-p.js → UiIconButton-CCo4NPYv.js} +1 -1
- package/dist/web/assets/{UiNotice-NCEwjNQR.js → UiNotice-DGPFbVo7.js} +1 -1
- package/dist/web/assets/{UiSegmented-B49yYjJ3.js → UiSegmented-BZ-jqnPE.js} +1 -1
- package/dist/web/assets/{UiWeight-DRIwuLUX.js → UiWeight-BRO3oVMZ.js} +1 -1
- package/dist/web/assets/{VirtualDirectoryList-Dieq64pn.js → VirtualDirectoryList-BkV3gj5E.js} +1 -1
- package/dist/web/assets/{VisuallyHidden-DIWFV5lV.js → VisuallyHidden-B8wfJ_mU.js} +1 -1
- package/dist/web/assets/{VisuallyHiddenInput-WxcAZDj2.js → VisuallyHiddenInput-Bdcr9CwC.js} +1 -1
- package/dist/web/assets/WidgetSlot-DFojQaSo.js +2 -0
- package/dist/web/assets/_plugin-vue_export-helper-B9AJmZbc.js +9 -0
- package/dist/web/assets/{agent-apps-CXhZLNMa.js → agent-apps-CKGFfySp.js} +1 -1
- package/dist/web/assets/{agent-avatar-xTnj6P4n.js → agent-avatar-V6M_DF3r.js} +1 -1
- package/dist/web/assets/agent-occupation-PZ2YAIM8.js +1 -0
- package/dist/web/assets/{agent-pins-CMBM9w6b.js → agent-pins-8KX0ynzy.js} +1 -1
- package/dist/web/assets/agent-profile-Clb-gYu-.css +1 -0
- package/dist/web/assets/{agent-roster-records-pCYzR1as.js → agent-roster-records-PfAgndHp.js} +1 -1
- package/dist/web/assets/{agent-workflows-IeF737kp.js → agent-workflows-DQlqVOoA.js} +1 -1
- package/dist/web/assets/{attach-closest-edge-B34lttZK.js → attach-closest-edge-D2qlayPy.js} +1 -1
- package/dist/web/assets/{attention-store-BTKBC8TZ.js → attention-store-BnZ8l3kk.js} +1 -1
- package/dist/web/assets/{badge-Bnc2nVhV.js → badge-DX_xrLV6.js} +1 -1
- package/dist/web/assets/button-CEkPBC1E.js +1 -0
- package/dist/web/assets/button-CoXXgtY5.css +1 -0
- package/dist/web/assets/{card-B2JIXyum.js → card-DNQ0_6vT.js} +1 -1
- package/dist/web/assets/{catalog-C8eUDXUx.js → catalog-KnpBkv5t.js} +1 -1
- package/dist/web/assets/{checkbox-Blw3CguI.js → checkbox-DPyLHneg.js} +1 -1
- package/dist/web/assets/{client-AaxCWoEF.js → client-CSQcWFRh.js} +2 -2
- package/dist/web/assets/client-connection-model-vO2cap6a.js +1 -0
- package/dist/web/assets/{client-links-store-CmP5Qsfa.js → client-links-store-DMqe0MbK.js} +1 -1
- package/dist/web/assets/combobox-zUq9bkyM.js +1 -0
- package/dist/web/assets/{console-DtxpKdVW.js → console-DaoAO-EO.js} +1 -1
- package/dist/web/assets/{context-menu-DSGaOBX2.js → context-menu-CcGDnF_k.js} +1 -1
- package/dist/web/assets/{conversation-launcher-settings-DAL9Kf4y.js → conversation-launcher-settings-CXFE-q_A.js} +1 -1
- package/dist/web/assets/{dialog-CwFuZvhM.js → dialog-CxhKMo0D.js} +1 -1
- package/dist/web/assets/dist-B9GqMC5C.js +1 -0
- package/dist/web/assets/dist-DIJqkL4O.js +1 -0
- package/dist/web/assets/dropdown-menu-CXmMnCBh.js +1 -0
- package/dist/web/assets/field-LNsBZqam.js +1 -0
- package/dist/web/assets/{format-bytes-N7zRFzUD.js → format-bytes-Bqefdt37.js} +1 -1
- package/dist/web/assets/{identity-BUFzZs1s.js → identity-DRfhWjty.js} +1 -1
- package/dist/web/assets/index-B4AMPpl_.css +1 -0
- package/dist/web/assets/index-BYIOAXnn.js +2 -0
- package/dist/web/assets/{input-Db1wVnd4.js → input-UoZ-0Xne.js} +1 -1
- package/dist/web/assets/{label--RjFNYxb.js → label-DpjbTOxt.js} +1 -1
- package/dist/web/assets/label-table-BnWNYfyk.js +1 -0
- package/dist/web/assets/{model-crzN3PVX.js → model-13BQndfF.js} +1 -1
- package/dist/web/assets/{model-KuA63FiT.js → model-B5g0CFcM.js} +1 -1
- package/dist/web/assets/model-BYKHVgJr.js +1 -0
- package/dist/web/assets/{model-B5f68kqL.js → model-CDevUwUw.js} +1 -1
- package/dist/web/assets/model-CpuIG8Du.js +4 -0
- package/dist/web/assets/{model-B5dQs6Zt.js → model-P5fSGsiJ.js} +1 -1
- package/dist/web/assets/{model-DOf6QDiY.js → model-pJ6k3zYD.js} +1 -1
- package/dist/web/assets/{motion-CeLn8y1x.js → motion-C-ZimCUS.js} +1 -1
- package/dist/web/assets/{motion-wEp9RlID.js → motion-QY5FKKko.js} +1 -1
- package/dist/web/assets/{motion-preference-DfUreaML.js → motion-preference-BQiiwhab.js} +1 -1
- package/dist/web/assets/{occupation-catalog-Crs_Zc8R.js → occupation-catalog-uDDhZwKK.js} +1 -1
- package/dist/web/assets/{option-DCSIgajR.js → option-CcHPBOo6.js} +1 -1
- package/dist/web/assets/{orchestration-filters-Cu9KEzWE.js → orchestration-filters-DmF4Qs8E.js} +1 -1
- package/dist/web/assets/{page-title-Bvm24KbY.js → page-title-NXphgeQI.js} +1 -1
- package/dist/web/assets/{person-profile-Cf0Sytyw.js → person-profile-DXXfpvta.js} +1 -1
- package/dist/web/assets/popover-xSRzcSmY.js +1 -0
- package/dist/web/assets/popup-host-Bmvrf-2t.js +1 -0
- package/dist/web/assets/{profile-model-DkDH6Qth.js → profile-model-6gTmScHC.js} +1 -1
- package/dist/web/assets/{project-board-layout-OeuzohUI.js → project-board-layout-DBQeP_QP.js} +1 -1
- package/dist/web/assets/{project-capture-BQAqeAJf.js → project-capture-BhYsDWwJ.js} +1 -1
- package/dist/web/assets/{project-origin-CENDtRuK.js → project-origin-D8jy8EF_.js} +1 -1
- package/dist/web/assets/{quick-edit-api-Qndjqk1h.js → quick-edit-api-WLh_88w6.js} +1 -1
- package/dist/web/assets/{radio-group-pfWejLFt.js → radio-group-B4r78nDh.js} +1 -1
- package/dist/web/assets/{role-names-aIXV-sMx.js → role-names-PECaMfQo.js} +1 -1
- package/dist/web/assets/{roundtable-live-D7Asm_GB.js → roundtable-live-DFeDF56c.js} +1 -1
- package/dist/web/assets/{runtime-dom.esm-bundler-BS2lpl87.js → runtime-dom.esm-bundler-f39i44Mt.js} +1 -1
- package/dist/web/assets/save-file-rPduHi2f.js +1 -0
- package/dist/web/assets/select-_JO3Mxdp.js +1 -0
- package/dist/web/assets/{session-launch-offers-kLW-dRsW.js → session-launch-offers-X9b0DwF1.js} +1 -1
- package/dist/web/assets/settings-restart-BnwcTv3i.js +1 -0
- package/dist/web/assets/shared-report-BxNVLalR.js +3 -0
- package/dist/web/assets/shared-report-mYIyRY9C.css +1 -0
- package/dist/web/assets/{source-adapters-CUxqZHz7.js → source-adapters-aupsL146.js} +1 -1
- package/dist/web/assets/{switch-Cdz4-JcE.js → switch-B3Y3oE_n.js} +1 -1
- package/dist/web/assets/{tabs-C3w1-eMu.js → tabs-BlcZiEMY.js} +1 -1
- package/dist/web/assets/{task-board-model-DSr4P56O.js → task-board-model-CmMKsWdY.js} +1 -1
- package/dist/web/assets/task-card-fields-DAx6zMLz.js +1 -0
- package/dist/web/assets/task-labels-BdDFvSAy.js +1 -0
- package/dist/web/assets/{task-reason-BywD_kfi.js → task-reason-7WnPreht.js} +1 -1
- package/dist/web/assets/{team-sheets-D8Y--CP4.js → team-sheets-Cr0ZTPw3.js} +1 -1
- package/dist/web/assets/{textarea-C228nxbD.js → textarea-CRzFqL9a.js} +1 -1
- package/dist/web/assets/{ui-BM8jZcP6.js → ui-BopQuQfc.js} +1 -1
- package/dist/web/assets/{useAgentRecords-D7x4xQ9O.js → useAgentRecords-CMtpd3Fj.js} +1 -1
- package/dist/web/assets/{useAgentWorkSummary-pc1i6nr0.js → useAgentWorkSummary-BQbhaHov.js} +1 -1
- package/dist/web/assets/{useApi-CROJJdhE-DZtkWJZv.js → useApi-CROJJdhE-CRCgNOqq.js} +1 -1
- package/dist/web/assets/{useClipboardCopy-sTthF_MD.js → useClipboardCopy-DkqKK3wY.js} +1 -1
- package/dist/web/assets/{useFocusReturn-BoyUh5y3.js → useFocusReturn-BZpVmQnM.js} +1 -1
- package/dist/web/assets/{useForwardExpose-CqXuqZvd.js → useForwardExpose-Di-MnbTz.js} +1 -1
- package/dist/web/assets/{useForwardPropsEmits-0F_e7unJ.js → useForwardPropsEmits-L9XcB5DG.js} +1 -1
- package/dist/web/assets/useForwardScopeId-CUQFIAIj.js +1 -0
- package/dist/web/assets/useKnowledgeItemPeek-PmQJixw5.js +1 -0
- package/dist/web/assets/{useMinimumLoadingDisplay-CzfqbQPs.js → useMinimumLoadingDisplay-CWPiOaDl.js} +1 -1
- package/dist/web/assets/useProjectAgentRoster-CWVpSsQ3.js +1 -0
- package/dist/web/assets/{useRoutePeek-BDgll9Fy.js → useRoutePeek-DxLVksbJ.js} +1 -1
- package/dist/web/assets/useTeamPeople-CDISP0PM.js +1 -0
- package/dist/web/assets/{useTeamWork-BSFi27vj.js → useTeamWork-BTZd_wKs.js} +1 -1
- package/dist/web/assets/{useTypeahead-D_g4j3Xp.js → useTypeahead-pEZNpBls.js} +1 -1
- package/dist/web/assets/{utils-C6vsxGrE.js → utils-B4pBTmyh.js} +1 -1
- package/dist/web/assets/utils-BsxOjD1Q.js +1 -0
- package/dist/web/assets/version-db3QWWjt.js +1 -0
- package/dist/web/assets/{vue-router-BPhQ0Qow.js → vue-router-B79HWW1l.js} +1 -1
- package/dist/web/assets/website-YgovUEcN.js +1 -0
- package/dist/web/index.html +71 -66
- package/docs/agent-interface-architecture.md +13 -4
- package/docs/client-connections.md +3 -2
- package/docs/employee-agents.md +11 -9
- package/docs/judgment-and-autonomy.md +4 -4
- package/graph-provider/fuli_graph/app.py +4 -0
- package/graph-provider/fuli_graph/collaboration_context.py +3 -7
- package/graph-provider/fuli_graph/graph_field_contract.py +10 -2
- package/graph-provider/fuli_graph/graph_format_builtin_occupations.py +33 -1
- package/graph-provider/fuli_graph/graph_format_migrations.py +18 -0
- package/graph-provider/fuli_graph/graph_query.py +3 -12
- package/graph-provider/fuli_graph/knowledge_index_scan.py +120 -0
- package/graph-provider/fuli_graph/knowledge_outdated.py +9 -1
- package/graph-provider/fuli_graph/knowledge_retrieval_models.py +95 -0
- package/graph-provider/fuli_graph/knowledge_retrieval_terms.py +116 -0
- package/graph-provider/fuli_graph/knowledge_search.py +220 -39
- package/graph-provider/fuli_graph/knowledge_semantic.py +87 -0
- package/graph-provider/fuli_graph/knowledge_semantic_index.py +98 -0
- package/graph-provider/fuli_graph/knowledge_semantic_models.py +72 -0
- package/graph-provider/fuli_graph/knowledge_semantic_query.py +19 -0
- package/graph-provider/fuli_graph/knowledge_versions.py +14 -7
- package/graph-provider/fuli_graph/models.py +4 -0
- package/graph-provider/fuli_graph/occupation_catalog.py +6 -3
- package/graph-provider/fuli_graph/personal_global_preferences.py +3 -7
- package/graph-provider/fuli_graph/preference_versions.py +110 -0
- package/graph-provider/fuli_graph/project_agent_models.py +3 -0
- package/graph-provider/fuli_graph/project_agent_recruitment_occupation.py +1 -1
- package/graph-provider/fuli_graph/provider_values.py +7 -0
- package/graph-provider/fuli_graph/search_projection.py +2 -6
- package/graph-provider/fuli_graph/store_knowledge.py +10 -1
- package/graph-provider/fuli_graph/task_context_routes.py +1 -1
- package/graph-provider/pyproject.toml +1 -1
- package/native/win32/fuli-win-helper.exe +0 -0
- package/npm-shrinkwrap.json +3 -4
- package/package.json +2 -1
- package/skills/capturing-session-knowledge/SKILL.md +14 -7
- package/skills/capturing-session-knowledge/references/capture.md +12 -2
- package/skills/capturing-session-knowledge/references/retrieval.md +13 -4
- package/skills/grilling-project/SKILL.md +2 -0
- package/skills/operating-fuli/SKILL.md +36 -8
- package/skills/operating-fuli/references/workflow-recipes.md +10 -9
- package/src/agent-apps/host-tools/catalog.js +3 -0
- package/src/agent-delegation/agent-tool.js +12 -2
- package/src/agent-delegation/delegation-header.js +32 -8
- package/src/agent-delegation/entry-prompts.js +54 -0
- package/src/agent-delegation/operation-log.js +17 -7
- package/src/agent-delegation/person-words.js +38 -0
- package/src/agent-delegation/port.js +6 -4
- package/src/agent-delegation/refusals.js +14 -0
- package/src/agent-kits/client-detection.js +7 -0
- package/src/agent-kits/client-installer.js +13 -0
- package/src/agent-tools/delegation-definitions.js +5 -3
- package/src/agent-tools/diagnostic-definitions.js +23 -0
- package/src/agent-tools/graph-definitions.js +4 -0
- package/src/agent-tools/graph-handlers.js +6 -1
- package/src/agent-tools/interface-catalog.js +47 -17
- package/src/agent-tools/model-backend-definitions.js +1 -1
- package/src/agent-tools/old-data-definitions.js +16 -0
- package/src/agent-tools/task-entry-definitions.js +1 -1
- package/src/agent-tools/work-surface-definitions.js +1 -1
- package/src/agents/claude-code/lifecycle-hook.js +19 -5
- package/src/agents/claude-code/transcript-format-probe.js +31 -0
- package/src/agents/codex/lifecycle-hook.js +27 -7
- package/src/agents/codex/transcript-format-probe.js +29 -0
- package/src/agents/cursor/lifecycle-hook.js +4 -1
- package/src/agents/lifecycle-failure.js +27 -0
- package/src/agents/lifecycle-message.js +10 -0
- package/src/agents/opencode/lifecycle-hook.js +18 -2
- package/src/agents/transcript-format-registry.js +34 -0
- package/src/agents/transcript-format-scan.js +71 -0
- package/src/cli/command-registry.js +3 -0
- package/src/cli/diagnostics-command.js +59 -0
- package/src/cli/setup-command.js +3 -0
- package/src/cli.js +5 -0
- package/src/conversations/entry-budget.js +1 -1
- package/src/conversations/entry-detail-readers.js +22 -0
- package/src/conversations/entry-inline-budget.js +24 -12
- package/src/conversations/entry-skeleton.js +27 -9
- package/src/conversations/preference-lifecycle.js +2 -1
- package/src/conversations/preference-session.js +5 -2
- package/src/conversations/preference-snapshot.js +4 -1
- package/src/conversations/preference-view.js +5 -1
- package/src/conversations/reply-citations.js +21 -0
- package/src/conversations/stop-auto-close.js +21 -9
- package/src/conversations/task-context-view.js +31 -0
- package/src/data-format/backup-retention.js +8 -0
- package/src/data-format/local-stores.js +24 -2
- package/src/debug-turns/fuli-surface.js +23 -0
- package/src/debug-turns/model-capture.js +84 -0
- package/src/debug-turns/model-request.js +97 -0
- package/src/debug-turns/record.js +178 -0
- package/src/debug-turns/recorder.js +53 -0
- package/src/debug-turns/store.js +91 -0
- package/src/debug-turns/transcript-reader.js +64 -0
- package/src/debug-turns/trigger.js +25 -0
- package/src/diagnostics/agent-tool.js +14 -0
- package/src/diagnostics/event-log.js +133 -0
- package/src/diagnostics/failure-records.js +43 -0
- package/src/diagnostics/query.js +114 -0
- package/src/diagnostics/safe-event.js +83 -0
- package/src/dreaming/run.js +310 -0
- package/src/dreaming/scheduler.js +58 -0
- package/src/employees/builtin/jefa/board-store.js +78 -19
- package/src/employees/builtin/jefa/http.js +8 -5
- package/src/employees/builtin/jefa/project-board.js +2 -0
- package/src/employees/builtin/jefa/tools.js +7 -6
- package/src/employees/recruitment.js +20 -2
- package/src/employees/service.js +11 -1
- package/src/graphiti/agent-growth.js +64 -0
- package/src/graphiti/collaboration-preference-projection.js +7 -0
- package/src/graphiti/collaboration-preference-workflow.js +3 -3
- package/src/graphiti/current-project-knowledge-search.js +24 -1
- package/src/graphiti/federated-application.js +19 -1
- package/src/graphiti/federated-search.js +8 -1
- package/src/graphiti/local-runtimes.js +13 -0
- package/src/graphiti/personal-projects.js +11 -0
- package/src/graphiti/project-agent-mapping.js +1 -0
- package/src/graphiti/project-agent-task-sheets.js +6 -2
- package/src/graphiti/project-agent-workflows.js +22 -4
- package/src/graphiti/project-profile-authors.js +14 -7
- package/src/graphiti/provider-client.js +36 -0
- package/src/graphiti/session-knowledge-migration.js +103 -3
- package/src/graphiti/session-migration-notices.js +65 -0
- package/src/graphiti/session-records.js +22 -4
- package/src/graphiti/task-context-entry.js +5 -1
- package/src/graphiti/task-entry-preferences.js +31 -2
- package/src/graphiti/task-entry-read-only.js +28 -0
- package/src/graphiti/task-knowledge-checkpoint.js +2 -0
- package/src/graphiti/task-knowledge-recall.js +96 -19
- package/src/graphiti/task-remember.js +7 -2
- package/src/graphiti/task-update-request.js +13 -0
- package/src/graphiti/temporary-project-scope.js +7 -1
- package/src/graphiti/turn-receipt-delivery.js +5 -3
- package/src/http/agent-delegation-gate.js +5 -4
- package/src/http/agent-growth-api-router.js +17 -0
- package/src/http/api-router.js +18 -2
- package/src/http/capture-onboarding-api-router.js +3 -2
- package/src/http/debug-turns-api-router.js +70 -0
- package/src/http/diagnostic-events-api-router.js +27 -0
- package/src/http/dreaming-api-router.js +32 -0
- package/src/http/graph-api-router.js +35 -1
- package/src/http/knowledge-item-api-router.js +19 -2
- package/src/http/knowledge-scope-api-router.js +3 -2
- package/src/http/old-data-api-router.js +47 -0
- package/src/http/person-profile-api-router.js +3 -2
- package/src/http/retrieval-terms-api-router.js +37 -0
- package/src/http/semantic-api-router.js +26 -0
- package/src/judgment/agent-view.js +1 -1
- package/src/judgment/backend.js +30 -0
- package/src/judgment/http.js +2 -1
- package/src/judgment/review-prompt.js +2 -0
- package/src/judgment/routing.js +10 -2
- package/src/judgment/service.js +8 -2
- package/src/judgment/store.js +17 -7
- package/src/local-runtime/lifecycle.js +3 -0
- package/src/local-runtime/windows-process-handle.js +9 -3
- package/src/mcp/create-mcp-server.js +42 -25
- package/src/mcp/process-registry.js +45 -3
- package/src/mcp/runtime.js +2 -1
- package/src/mcp/stdio-relay.js +4 -1
- package/src/mcp/tool-annotations.js +2 -0
- package/src/model-backends/adapters/anthropic-messages.js +1 -1
- package/src/model-backends/adapters/exchange.js +2 -2
- package/src/model-backends/adapters/openai-chat.js +1 -1
- package/src/model-backends/adapters/openai-embeddings.js +60 -0
- package/src/model-backends/adapters/registry.js +3 -1
- package/src/model-backends/adapters/typesafe-systemone.js +1 -1
- package/src/model-backends/budget.js +14 -8
- package/src/model-backends/config.js +49 -15
- package/src/model-backends/decision-contract.js +2 -1
- package/src/model-backends/http.js +19 -1
- package/src/model-backends/model-fetch.js +37 -0
- package/src/model-backends/port.js +165 -67
- package/src/model-backends/prompt.js +4 -3
- package/src/model-backends/request.js +42 -3
- package/src/native-runtime/runtime.js +28 -4
- package/src/old-data/agent-tools.js +17 -0
- package/src/old-data/backup-reader.js +78 -0
- package/src/old-data/console-actions.js +53 -0
- package/src/old-data/guarded-stores.js +18 -0
- package/src/old-data/inventory.js +142 -0
- package/src/old-data/port.js +53 -0
- package/src/person-profile/port.js +2 -1
- package/src/presence/windows-helper-pin.js +1 -1
- package/src/project-change-log/port.js +65 -0
- package/src/project-change-log/store.js +60 -0
- package/src/retrieval-terms/fill.js +102 -0
- package/src/retrieval-terms/runner.js +50 -0
- package/src/retrieval-terms/terms-model.js +99 -0
- package/src/security/sensitive-content.js +11 -0
- package/src/semantic/scheduler.js +50 -0
- package/src/semantic/semantic-index.js +94 -0
- package/src/server.js +20 -1
- package/src/setup/paths.js +1 -1
- package/src/setup/setup.js +7 -0
- package/src/system/client-connection-status.js +6 -4
- package/src/system/doctor-repair.js +16 -4
- package/src/system/doctor.js +75 -3
- package/src/system/log-paths.js +11 -0
- package/src/system/log-retention.js +2 -8
- package/src/system/mcp-process-scan.js +55 -0
- package/src/system/resource-monitor.js +18 -2
- package/src/system/system-service.js +39 -7
- package/src/system/windows-data-acl.js +109 -0
- package/src/work-surfaces/port.js +17 -11
- package/src/work-surfaces/sources.js +4 -3
- package/dist/web/assets/AboutSectionHeading-BOXKE5Le.js +0 -1
- package/dist/web/assets/AboutSectionHeading-CiD3M3eG.css +0 -1
- package/dist/web/assets/AgentAppsPage-DS2X485q.js +0 -1
- package/dist/web/assets/AgentConversations-D7QJVFIo.js +0 -2
- package/dist/web/assets/AgentConversations-oZFXZE1X.css +0 -1
- package/dist/web/assets/AgentMentionCopy-O6pAjjYE.js +0 -1
- package/dist/web/assets/AgentProfilePage-CKCTcTzc.js +0 -2
- package/dist/web/assets/AgentProfilePage-D1ha8O3z.css +0 -1
- package/dist/web/assets/AgentServicesPage-C3npKkHp.js +0 -1
- package/dist/web/assets/AgentWorkbench-CJ4TYQA1.css +0 -1
- package/dist/web/assets/AgentWorkbench-D9HGRW-n.js +0 -2
- package/dist/web/assets/AppViewerPage-Al4TzYJF.js +0 -1
- package/dist/web/assets/BoardMoveMenu-ncWgEitd.js +0 -1
- package/dist/web/assets/Breadcrumb-QzjzIJdS.js +0 -1
- package/dist/web/assets/Breadcrumb-bsc0JKtG.css +0 -1
- package/dist/web/assets/CaptureChangePage-BQdqH2qC.js +0 -1
- package/dist/web/assets/ConnectionsPage-Be8jIb93.js +0 -1
- package/dist/web/assets/DataFormatPage-0Ne27K6I.css +0 -1
- package/dist/web/assets/DataFormatPage-C92rwzHa.js +0 -2
- package/dist/web/assets/EmployeeScopeDialog-DdR2DzcW.js +0 -1
- package/dist/web/assets/EmployeeTaskBoard-Bo8JT36K.js +0 -3
- package/dist/web/assets/EmployeeTaskBoard-Dljjy_L7.css +0 -1
- package/dist/web/assets/EmployeeWorkbenchPage-B249Mgle.js +0 -3
- package/dist/web/assets/EmployeeWorkbenchPage-BBjZJ6Od.css +0 -1
- package/dist/web/assets/FieldRoot-YdKVCBhW.js +0 -1
- package/dist/web/assets/FlaTaskSheets-Cm5SLq7J.js +0 -1
- package/dist/web/assets/FlasPage-C57gTN5X.js +0 -1
- package/dist/web/assets/HowtoPage-CDJScY6b.js +0 -1
- package/dist/web/assets/KnowledgeDeleteButton-5EtCPPl4.js +0 -1
- package/dist/web/assets/KnowledgeHardDeleteSection-r0lZ7ijb.js +0 -1
- package/dist/web/assets/KnowledgeItemEditPage-BStIRllM.js +0 -1
- package/dist/web/assets/KnowledgeOrganizerPage-BByk8hbw.js +0 -1
- package/dist/web/assets/KnowledgePage-DuWS3bRP.js +0 -1
- package/dist/web/assets/KnowledgePeek-BycBJ2xR.js +0 -1
- package/dist/web/assets/KnowledgePeek-EvumfJER.css +0 -1
- package/dist/web/assets/KnowledgeTurnReceiptPage-DTcDN-pG.js +0 -1
- package/dist/web/assets/KnowledgeWorkspace-CJo-6xdn.js +0 -4
- package/dist/web/assets/KnowledgeWorkspace-DPBq-At0.css +0 -1
- package/dist/web/assets/ModelSettingsPage-C1ghraAh.js +0 -1
- package/dist/web/assets/ModelSettingsPage-ConWy_ec.css +0 -1
- package/dist/web/assets/OccupationsPage-BY1jej7i.js +0 -1
- package/dist/web/assets/OverviewPage-C7YJf-Cq.css +0 -1
- package/dist/web/assets/OverviewPage-Dl-H0EBe.js +0 -1
- package/dist/web/assets/PersonalProfilePage-BcaVzKM6.js +0 -1
- package/dist/web/assets/PersonalProjectsPage-CO4ZYVAI.js +0 -1
- package/dist/web/assets/ProjectAgentDetailPage-Bgh78Mr5.js +0 -8
- package/dist/web/assets/ProjectAgentDetailPage-h7hr9iee.css +0 -1
- package/dist/web/assets/ProjectAgentDialog--T6mU-FW.css +0 -1
- package/dist/web/assets/ProjectAgentDialog-DzTor5ky.js +0 -5
- package/dist/web/assets/ProjectAgentsPage-CzN183pa.js +0 -1
- package/dist/web/assets/ProjectJudgmentPolicy-BMlEBJM3.js +0 -2
- package/dist/web/assets/PublicProjectsPage-DAHT31B8.js +0 -1
- package/dist/web/assets/SessionMigrationPage-IW07XhmD.js +0 -1
- package/dist/web/assets/SessionRecordsPage-Du76tewc.js +0 -1
- package/dist/web/assets/SettingsPage-CJNXe313.js +0 -1
- package/dist/web/assets/SettingsPage-D3AYCNTC.css +0 -1
- package/dist/web/assets/SharedJefaReportPage-dzHSSGhu.js +0 -1
- package/dist/web/assets/TagVocabularyPage-C_oV6GFs.js +0 -1
- package/dist/web/assets/TeamCard-CdO0RiNB.js +0 -1
- package/dist/web/assets/TeamCardsWidget-Cg_kJmb-.js +0 -1
- package/dist/web/assets/UiDialog-CUgrU6SQ.js +0 -1
- package/dist/web/assets/UiIcon-DPv0eZIU.js +0 -1
- package/dist/web/assets/WidgetSlot-BSU_-l_4.js +0 -2
- package/dist/web/assets/_plugin-vue_export-helper-DQENg-QE.js +0 -9
- package/dist/web/assets/agent-occupation-BvOgDW-q.js +0 -1
- package/dist/web/assets/agent-profile-BBqkfac0.css +0 -1
- package/dist/web/assets/agent-task-board-Cf9il_1i.js +0 -1
- package/dist/web/assets/button-N4FjuQuJ.js +0 -1
- package/dist/web/assets/client-connection-model-C3gpYYl7.js +0 -1
- package/dist/web/assets/combobox-DHwWXUpj.js +0 -1
- package/dist/web/assets/desktop-client-DnfjyLBX.js +0 -1
- package/dist/web/assets/dist-BInsvNsv.js +0 -1
- package/dist/web/assets/dist-Dc8jFf8M.js +0 -1
- package/dist/web/assets/field-BQLn7Hfw.js +0 -1
- package/dist/web/assets/index-CXPYDcyq.js +0 -2
- package/dist/web/assets/index-x95VDmzK.css +0 -1
- package/dist/web/assets/judgment-api-CK9yqrpU.js +0 -1
- package/dist/web/assets/label-table-KdyaCTvK.js +0 -1
- package/dist/web/assets/model-D4kKYvpj.js +0 -1
- package/dist/web/assets/popover-D4YFkL_5.js +0 -1
- package/dist/web/assets/project-board-settings-DPP6xKLz.js +0 -1
- package/dist/web/assets/project-team-api-7ybLH-uJ.js +0 -1
- package/dist/web/assets/save-file-CRxAsski.js +0 -1
- package/dist/web/assets/select-CUy1AIwE.js +0 -1
- package/dist/web/assets/settings-restart-JYH81qB-.js +0 -1
- package/dist/web/assets/shared-report-8p3nBKr-.js +0 -1
- package/dist/web/assets/source-coverage-4PsHC9TK.js +0 -1
- package/dist/web/assets/task-labels-CXBG2chm.js +0 -1
- package/dist/web/assets/useForwardScopeId-DVUFcuwO.js +0 -1
- package/dist/web/assets/useKnowledgeItemPeek-KZveY8Wz.js +0 -1
- package/dist/web/assets/useTeamPeople-Dna3Yrm3.js +0 -1
- package/dist/web/assets/utils-BX1QI2N6.js +0 -1
- 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
|
|
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)
|