neotoma 0.26.0 → 0.28.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/README.md +5 -5
- package/dist/actions.d.ts.map +1 -1
- package/dist/actions.js +256 -38
- package/dist/actions.js.map +1 -1
- package/dist/cli/harness_configure.d.ts +2 -1
- package/dist/cli/harness_configure.d.ts.map +1 -1
- package/dist/cli/harness_configure.js.map +1 -1
- package/dist/cli/index.d.ts +14 -0
- package/dist/cli/index.d.ts.map +1 -1
- package/dist/cli/index.js +53 -8
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/mcp_config_scan.d.ts +29 -0
- package/dist/cli/mcp_config_scan.d.ts.map +1 -1
- package/dist/cli/mcp_config_scan.js +35 -6
- package/dist/cli/mcp_config_scan.js.map +1 -1
- package/dist/cli/setup.d.ts +24 -3
- package/dist/cli/setup.d.ts.map +1 -1
- package/dist/cli/setup.js +65 -3
- package/dist/cli/setup.js.map +1 -1
- package/dist/docs/architecture/architecture.md +1 -1
- package/dist/docs/conventions/documentation_standards.md +1 -1
- package/dist/docs/developer/atomic_corrections.md +2 -2
- package/dist/docs/developer/cli_agent_instructions.md +14 -3
- package/dist/docs/developer/cli_reference.md +13 -2
- package/dist/docs/developer/mcp/instructions.md +15 -4
- package/dist/docs/developer/mcp_codex_remote_setup.md +61 -0
- package/dist/docs/developer/mcp_continue_setup.md +9 -17
- package/dist/docs/developer/mcp_letta_setup.md +5 -2
- package/dist/docs/developer/mcp_openclaw_setup.md +5 -3
- package/dist/docs/developer/mcp_overview.md +39 -19
- package/dist/docs/developer/mcp_vscode_setup.md +10 -23
- package/dist/docs/developer/mcp_windsurf_setup.md +9 -25
- package/dist/docs/developer/seo_analytics_verification.md +12 -10
- package/dist/docs/developer/site_launch_readiness.md +56 -0
- package/dist/docs/developer/tunnels.md +1 -1
- package/dist/docs/infrastructure/deployment.md +1 -1
- package/dist/docs/integrations/es/matrix.md +38 -0
- package/dist/docs/integrations/matrix.md +26 -71
- package/dist/docs/legal/site_privacy_notice.md +30 -8
- package/dist/docs/security/advisories/2026-11-04-peer-sync-and-agent-grant-scope.md +41 -0
- package/dist/docs/security/advisories/README.md +1 -0
- package/dist/docs/site/site_doc_manifest.yaml +7 -4
- package/dist/docs/specs/MCP_SPEC.md +7 -2
- package/dist/docs/subsystems/agent_capabilities.md +105 -4
- package/dist/docs/subsystems/auth.md +45 -0
- package/dist/docs/subsystems/conflict_resolution.md +18 -4
- package/dist/docs/subsystems/errors.md +1 -0
- package/dist/docs/subsystems/observation_architecture.md +2 -1
- package/dist/docs/subsystems/peer_sync.md +146 -24
- package/dist/docs/subsystems/reducer.md +130 -10
- package/dist/docs/testing/automated_test_catalog.md +97 -24
- package/dist/inspector/assets/{access_policies-CJOlV60d.js → access_policies-CecrDHE5.js} +1 -1
- package/dist/inspector/assets/{agent_badge-BnBqn8kt.js → agent_badge-bFKcTLc3.js} +1 -1
- package/dist/inspector/assets/{agent_detail-wP0ccjhX.js → agent_detail-ByxqvVXp.js} +1 -1
- package/dist/inspector/assets/{agent_filter-Bp2xA131.js → agent_filter-CIlnJqXp.js} +1 -1
- package/dist/inspector/assets/{agent_grant_detail-HIGr5dq_.js → agent_grant_detail-BS9vi68s.js} +1 -1
- package/dist/inspector/assets/agent_grant_form-CUNvJrPS.js +1 -0
- package/dist/inspector/assets/{agent_grants-CTKkadE5.js → agent_grants-DKd7ld_4.js} +1 -1
- package/dist/inspector/assets/{agents-CPwJLNJN.js → agents-CE6YYOPn.js} +1 -1
- package/dist/inspector/assets/{api_not_configured_state-ivqIcs2c.js → api_not_configured_state-BdXbCQAz.js} +1 -1
- package/dist/inspector/assets/{attribution_card-5ZAqRz6K.js → attribution_card-Df6GMziR.js} +1 -1
- package/dist/inspector/assets/{attribution_summary-D_MHFv7e.js → attribution_summary-B2T-E3h9.js} +1 -1
- package/dist/inspector/assets/{bundles-QfMciBj9.js → bundles-DPrW5kwK.js} +1 -1
- package/dist/inspector/assets/{card-1rkzdi9W.js → card-xB0wTMgy.js} +1 -1
- package/dist/inspector/assets/{checkbox-CO5dXSZf.js → checkbox-C6aOTIf3.js} +1 -1
- package/dist/inspector/assets/{compliance-OTGEtY7Y.js → compliance-CKOQJGVG.js} +1 -1
- package/dist/inspector/assets/{confirm-dialog-D0cZ5vck.js → confirm-dialog-CrSwx0Db.js} +1 -1
- package/dist/inspector/assets/{conversation_common-cSILaHXq.js → conversation_common-C5W4gEXW.js} +1 -1
- package/dist/inspector/assets/{conversation_detail-DT-lGapN.js → conversation_detail-Uz4wDgPf.js} +1 -1
- package/dist/inspector/assets/{copy_id_button-Dz0JDn4l.js → copy_id_button-CDMxVOzU.js} +1 -1
- package/dist/inspector/assets/{copyable_code_block-B2f99g8Q.js → copyable_code_block-CPl0aWFe.js} +1 -1
- package/dist/inspector/assets/{corrections-KvxGvvLV.js → corrections-Dwj1Fugu.js} +1 -1
- package/dist/inspector/assets/{dashboard-BudvW21X.js → dashboard-BBCSRZNU.js} +1 -1
- package/dist/inspector/assets/{data-table-d9EMxowf.js → data-table-aUtH1nlD.js} +1 -1
- package/dist/inspector/assets/{design-DyiQbEeP.js → design-D0gJ9iB8.js} +1 -1
- package/dist/inspector/assets/{dialog-BmW1Iw8o.js → dialog-CMWtV0zN.js} +1 -1
- package/dist/inspector/assets/{docs-CT3IYX0E.js → docs-Byar2vOe.js} +1 -1
- package/dist/inspector/assets/{docs_page_layout-CosNjUZa.js → docs_page_layout-CP64UQbJ.js} +1 -1
- package/dist/inspector/assets/{embed_graph-Dk1-zVnz.js → embed_graph-CnaGuKds.js} +1 -1
- package/dist/inspector/assets/{empty_state-B8Ot2oGB.js → empty_state-BzT7NRtZ.js} +1 -1
- package/dist/inspector/assets/{entities-Dt5Ts5UN.js → entities-fkG18fss.js} +1 -1
- package/dist/inspector/assets/{entity_correct-D2PHEpGY.js → entity_correct-mnPBHieg.js} +1 -1
- package/dist/inspector/assets/{entity_history-DHgNythA.js → entity_history-Th7OnpfA.js} +1 -1
- package/dist/inspector/assets/{entity_history_sections-Cnxblw-Z.js → entity_history_sections-DwEU4Y5F.js} +1 -1
- package/dist/inspector/assets/{entity_link-DWf1VD1n.js → entity_link-U1JSr9H2.js} +1 -1
- package/dist/inspector/assets/{entity_relationships_by_type-B0-TLC5o.js → entity_relationships_by_type-B6ZTLPGk.js} +1 -1
- package/dist/inspector/assets/{entity_segment_page-CzZ0VhKm.js → entity_segment_page-N7j8YJxA.js} +1 -1
- package/dist/inspector/assets/{entity_table_column_toggle-C73aErGE.js → entity_table_column_toggle-DfKBCgU2.js} +1 -1
- package/dist/inspector/assets/{entity_timeline-SAq5qvB5.js → entity_timeline-B7sMnfd3.js} +1 -1
- package/dist/inspector/assets/{entity_types-DEcDvyO0.js → entity_types-D5la65Sn.js} +1 -1
- package/dist/inspector/assets/{faq-DazWIFdv.js → faq-C-BJiIWQ.js} +1 -1
- package/dist/inspector/assets/{graph_auto_fit-CSzD7yNh.js → graph_auto_fit-Cl1sM7g6.js} +1 -1
- package/dist/inspector/assets/{graph_explorer-BEXXiMQ1.js → graph_explorer-BF8NyJLR.js} +1 -1
- package/dist/inspector/assets/home-Czrx0JG4.js +1 -0
- package/dist/inspector/assets/{index-fc4sMprn.js → index-BcN-bmX4.js} +2 -2
- package/dist/inspector/assets/{index-Dt_q_A1j.js → index-Bf45K-hH.js} +1 -1
- package/dist/inspector/assets/{index-Cii0RALL.js → index-DnnkhCRn.js} +1 -1
- package/dist/inspector/assets/{interpretations-DtzoiGuK.js → interpretations-BON8Hv6B.js} +1 -1
- package/dist/inspector/assets/interpretations-D1AiR24H.js +1 -0
- package/dist/inspector/assets/{issue_author_attribution-DtmFaluD.js → issue_author_attribution-BiIemiwE.js} +1 -1
- package/dist/inspector/assets/{issue_detail-ChHiz9I_.js → issue_detail-DKwqgprb.js} +1 -1
- package/dist/inspector/assets/{issues-BoxR2nB2.js → issues-DN0qXAD9.js} +1 -1
- package/dist/inspector/assets/{json_viewer-KAFp_j-8.js → json_viewer-o1fpEDum.js} +1 -1
- package/dist/inspector/assets/{label-Dn0ARjYl.js → label-6dQuJkiv.js} +1 -1
- package/dist/inspector/assets/{live_relative_time-gOIFOOLR.js → live_relative_time-DRapJJqL.js} +1 -1
- package/dist/inspector/assets/{mobile_filter_popover-2ezU-mlZ.js → mobile_filter_popover-CG_CrM1J.js} +1 -1
- package/dist/inspector/assets/{not_found-DwX7ikQC.js → not_found-ZFJp_piF.js} +1 -1
- package/dist/inspector/assets/{oauth_callback-BDGLOyTN.js → oauth_callback-0LtMaQug.js} +1 -1
- package/dist/inspector/assets/{oauth_signin-CGcCtq-V.js → oauth_signin-Dojz-oXP.js} +1 -1
- package/dist/inspector/assets/{observations-DvcUGpHm.js → observations-L18GAXwN.js} +1 -1
- package/dist/inspector/assets/{page_shell-DiwchdUC.js → page_shell-DGmu9DSu.js} +1 -1
- package/dist/inspector/assets/{pagination-BGIUHQkm.js → pagination-D06zx3An.js} +1 -1
- package/dist/inspector/assets/{peer_detail-DeD1sTeJ.js → peer_detail-ChA0ildZ.js} +1 -1
- package/dist/inspector/assets/{peers-CXe47m55.js → peers-1DpY9nuL.js} +1 -1
- package/dist/inspector/assets/{pin_primitive_button-C37Ha0Bt.js → pin_primitive_button-C69_BXo8.js} +1 -1
- package/dist/inspector/assets/{recent_activity-CzQjt4ym.js → recent_activity-_tzwJHSQ.js} +1 -1
- package/dist/inspector/assets/{recent_conversations-BnUl4h4t.js → recent_conversations-DIuO8UEC.js} +1 -1
- package/dist/inspector/assets/{recent_conversations-BFYZTxUJ.js → recent_conversations-DyySBTfu.js} +1 -1
- package/dist/inspector/assets/{recent_records_feed-y1n0RuMa.js → recent_records_feed-C3kqxaSx.js} +1 -1
- package/dist/inspector/assets/record_activity-D6T1ehSh.js +1 -0
- package/dist/inspector/assets/{relationship_detail-ic83ZCwG.js → relationship_detail-DB9gZgOc.js} +1 -1
- package/dist/inspector/assets/{relationship_panel_groups-CI1fZIU_.js → relationship_panel_groups-DDcasdh0.js} +1 -1
- package/dist/inspector/assets/{relationships-C7iSdgXG.js → relationships-DE8zWSeh.js} +1 -1
- package/dist/inspector/assets/{relationships-C1JrEl85.js → relationships-r726Am6k.js} +1 -1
- package/dist/inspector/assets/{sandbox-Dst-WJhB.js → sandbox-CK8Xh0zh.js} +1 -1
- package/dist/inspector/assets/{schema_detail-C7_JSWAw.js → schema_detail-tV9qZlDI.js} +1 -1
- package/dist/inspector/assets/{schemas-BgrIpRVJ.js → schemas-r5vde1ev.js} +1 -1
- package/dist/inspector/assets/{search-BUmT32dy.js → search-CYsHQGOl.js} +1 -1
- package/dist/inspector/assets/{segmented_control-t1pBImFE.js → segmented_control-Dh7hbz4k.js} +1 -1
- package/dist/inspector/assets/{select-DU7Jwzuy.js → select-BKEI7cq9.js} +1 -1
- package/dist/inspector/assets/{settings-BAPHY6RY.js → settings-CGFwUgc3.js} +1 -1
- package/dist/inspector/assets/{source_content-CIhKrGsl.js → source_content-BVWgibsY.js} +1 -1
- package/dist/inspector/assets/{source_content_open_button-Erw2ErgG.js → source_content_open_button-CILzjRlO.js} +1 -1
- package/dist/inspector/assets/{source_detail-C0XOo0Uu.js → source_detail-C1w4In3r.js} +1 -1
- package/dist/inspector/assets/{source_link-CkcRMEO3.js → source_link-DlxqKShY.js} +1 -1
- package/dist/inspector/assets/{sources-C0JBEINb.js → sources-C3c88YnL.js} +1 -1
- package/dist/inspector/assets/{subscriptions-DxU4kHGt.js → subscriptions-BJI8nfBi.js} +1 -1
- package/dist/inspector/assets/{switch-BhKadp29.js → switch-Dx7yDS8J.js} +1 -1
- package/dist/inspector/assets/{tabs-d81XObYb.js → tabs-C7CNmtlx.js} +1 -1
- package/dist/inspector/assets/{textarea-DTiKLH24.js → textarea-CnKEdeS7.js} +1 -1
- package/dist/inspector/assets/{timeline-BEyKQpER.js → timeline-DFvizOXt.js} +1 -1
- package/dist/inspector/assets/{timeline-98QXcGln.js → timeline-TBibq40-.js} +1 -1
- package/dist/inspector/assets/{timeline_event_detail-DzGzqtrx.js → timeline_event_detail-DXpLKXwn.js} +1 -1
- package/dist/inspector/assets/{turn_detail-CDP_FEPT.js → turn_detail-DxoBBnAV.js} +1 -1
- package/dist/inspector/assets/{turns-DLmr1Iue.js → turns-DYRndDTk.js} +1 -1
- package/dist/inspector/assets/{use_agents-D3rvlr5v.js → use_agents-EhoEA4-8.js} +1 -1
- package/dist/inspector/assets/{use_entities-CVikeUOv.js → use_entities-DzF_NpWe.js} +1 -1
- package/dist/inspector/assets/use_interpretations-CmKAxtHd.js +1 -0
- package/dist/inspector/assets/{use_mutations-BhwSLXcJ.js → use_mutations-Da9jgbQb.js} +1 -1
- package/dist/inspector/assets/{use_peers-QTm1Z_BV.js → use_peers-C1-jKVUX.js} +1 -1
- package/dist/inspector/assets/{use_relationships-DtymxAI9.js → use_relationships-ClEy1YjY.js} +1 -1
- package/dist/inspector/assets/{use_stats-BW1Z-dI2.js → use_stats-jYkK0Ydj.js} +1 -1
- package/dist/inspector/assets/{use_timeline-DND87Sof.js → use_timeline-CNpY1sVJ.js} +1 -1
- package/dist/inspector/assets/{use_turns-Dfb6Q8Ru.js → use_turns-aYgpXeJo.js} +1 -1
- package/dist/inspector/assets/{world_time_event_timeline-DxzejNrJ.js → world_time_event_timeline-4k2EdpBk.js} +1 -1
- package/dist/inspector/index.html +1 -1
- package/dist/reducers/observation_reducer.d.ts +7 -0
- package/dist/reducers/observation_reducer.d.ts.map +1 -1
- package/dist/reducers/observation_reducer.js +60 -7
- package/dist/reducers/observation_reducer.js.map +1 -1
- package/dist/repositories/sqlite/sqlite_client.d.ts +13 -1
- package/dist/repositories/sqlite/sqlite_client.d.ts.map +1 -1
- package/dist/repositories/sqlite/sqlite_client.js +56 -0
- package/dist/repositories/sqlite/sqlite_client.js.map +1 -1
- package/dist/repositories/worker/worker_file_database.d.ts +16 -1
- package/dist/repositories/worker/worker_file_database.d.ts.map +1 -1
- package/dist/repositories/worker/worker_file_database.js +280 -29
- package/dist/repositories/worker/worker_file_database.js.map +1 -1
- package/dist/server.d.ts +10 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +185 -25
- package/dist/server.js.map +1 -1
- package/dist/services/agent_capabilities.d.ts +25 -1
- package/dist/services/agent_capabilities.d.ts.map +1 -1
- package/dist/services/agent_capabilities.js +5 -8
- package/dist/services/agent_capabilities.js.map +1 -1
- package/dist/services/agent_grants.d.ts.map +1 -1
- package/dist/services/agent_grants.js +7 -0
- package/dist/services/agent_grants.js.map +1 -1
- package/dist/services/batch_correction.d.ts +2 -1
- package/dist/services/batch_correction.d.ts.map +1 -1
- package/dist/services/batch_correction.js +29 -1
- package/dist/services/batch_correction.js.map +1 -1
- package/dist/services/bearer_slots.d.ts +109 -0
- package/dist/services/bearer_slots.d.ts.map +1 -0
- package/dist/services/bearer_slots.js +275 -0
- package/dist/services/bearer_slots.js.map +1 -0
- package/dist/services/bounded_identity_read.d.ts +26 -0
- package/dist/services/bounded_identity_read.d.ts.map +1 -0
- package/dist/services/bounded_identity_read.js +154 -0
- package/dist/services/bounded_identity_read.js.map +1 -0
- package/dist/services/bundles/activation.d.ts +4 -2
- package/dist/services/bundles/activation.d.ts.map +1 -1
- package/dist/services/bundles/activation.js +13 -9
- package/dist/services/bundles/activation.js.map +1 -1
- package/dist/services/correction.d.ts.map +1 -1
- package/dist/services/correction.js +14 -2
- package/dist/services/correction.js.map +1 -1
- package/dist/services/correction_identity.d.ts +63 -0
- package/dist/services/correction_identity.d.ts.map +1 -0
- package/dist/services/correction_identity.js +57 -0
- package/dist/services/correction_identity.js.map +1 -0
- package/dist/services/correction_transaction.d.ts.map +1 -1
- package/dist/services/correction_transaction.js +9 -3
- package/dist/services/correction_transaction.js.map +1 -1
- package/dist/services/current_state_reads.d.ts +56 -0
- package/dist/services/current_state_reads.d.ts.map +1 -0
- package/dist/services/current_state_reads.js +337 -0
- package/dist/services/current_state_reads.js.map +1 -0
- package/dist/services/entity_lifecycle_storage.d.ts.map +1 -1
- package/dist/services/entity_lifecycle_storage.js +17 -4
- package/dist/services/entity_lifecycle_storage.js.map +1 -1
- package/dist/services/entity_population_certificate.d.ts +2 -0
- package/dist/services/entity_population_certificate.d.ts.map +1 -0
- package/dist/services/entity_population_certificate.js +74 -0
- package/dist/services/entity_population_certificate.js.map +1 -0
- package/dist/services/entity_queries.d.ts +0 -5
- package/dist/services/entity_queries.d.ts.map +1 -1
- package/dist/services/entity_queries.js +296 -275
- package/dist/services/entity_queries.js.map +1 -1
- package/dist/services/interpretation.d.ts +12 -0
- package/dist/services/interpretation.d.ts.map +1 -1
- package/dist/services/interpretation.js +88 -29
- package/dist/services/interpretation.js.map +1 -1
- package/dist/services/mcp_lookup_timing.d.ts +25 -0
- package/dist/services/mcp_lookup_timing.d.ts.map +1 -0
- package/dist/services/mcp_lookup_timing.js +156 -0
- package/dist/services/mcp_lookup_timing.js.map +1 -0
- package/dist/services/mutation_capability.d.ts +105 -0
- package/dist/services/mutation_capability.d.ts.map +1 -0
- package/dist/services/mutation_capability.js +262 -0
- package/dist/services/mutation_capability.js.map +1 -0
- package/dist/services/net/private_host_guard.d.ts +6 -2
- package/dist/services/net/private_host_guard.d.ts.map +1 -1
- package/dist/services/net/private_host_guard.js +14 -3
- package/dist/services/net/private_host_guard.js.map +1 -1
- package/dist/services/oauth_key_gate.d.ts.map +1 -1
- package/dist/services/oauth_key_gate.js +5 -0
- package/dist/services/oauth_key_gate.js.map +1 -1
- package/dist/services/observation_storage.d.ts.map +1 -1
- package/dist/services/observation_storage.js +4 -0
- package/dist/services/observation_storage.js.map +1 -1
- package/dist/services/rendered_page/copy_controls.d.ts +8 -0
- package/dist/services/rendered_page/copy_controls.d.ts.map +1 -0
- package/dist/services/rendered_page/copy_controls.js +122 -0
- package/dist/services/rendered_page/copy_controls.js.map +1 -0
- package/dist/services/rendered_page/html_template.d.ts.map +1 -1
- package/dist/services/rendered_page/html_template.js +9 -0
- package/dist/services/rendered_page/html_template.js.map +1 -1
- package/dist/services/request_context.d.ts +3 -0
- package/dist/services/request_context.d.ts.map +1 -1
- package/dist/services/request_context.js.map +1 -1
- package/dist/services/root_landing/harness_snippets.d.ts.map +1 -1
- package/dist/services/root_landing/harness_snippets.js +23 -49
- package/dist/services/root_landing/harness_snippets.js.map +1 -1
- package/dist/services/root_landing/index.d.ts +1 -6
- package/dist/services/root_landing/index.d.ts.map +1 -1
- package/dist/services/root_landing/index.js +2 -16
- package/dist/services/root_landing/index.js.map +1 -1
- package/dist/services/root_landing/site_nav.js +1 -1
- package/dist/services/root_landing/site_nav.js.map +1 -1
- package/dist/services/schema_registry.d.ts +29 -11
- package/dist/services/schema_registry.d.ts.map +1 -1
- package/dist/services/schema_registry.js +193 -58
- package/dist/services/schema_registry.js.map +1 -1
- package/dist/services/store_admission.d.ts +26 -0
- package/dist/services/store_admission.d.ts.map +1 -1
- package/dist/services/store_admission.js +74 -6
- package/dist/services/store_admission.js.map +1 -1
- package/dist/services/sync/conflict_resolver.d.ts +39 -5
- package/dist/services/sync/conflict_resolver.d.ts.map +1 -1
- package/dist/services/sync/conflict_resolver.js +250 -18
- package/dist/services/sync/conflict_resolver.js.map +1 -1
- package/dist/services/sync/full_sync.d.ts +12 -0
- package/dist/services/sync/full_sync.d.ts.map +1 -1
- package/dist/services/sync/full_sync.js +78 -9
- package/dist/services/sync/full_sync.js.map +1 -1
- package/dist/services/sync/peer_ops.d.ts +8 -0
- package/dist/services/sync/peer_ops.d.ts.map +1 -1
- package/dist/services/sync/peer_ops.js +26 -0
- package/dist/services/sync/peer_ops.js.map +1 -1
- package/dist/services/sync/remote_snapshot_admission.d.ts +144 -0
- package/dist/services/sync/remote_snapshot_admission.d.ts.map +1 -0
- package/dist/services/sync/remote_snapshot_admission.js +248 -0
- package/dist/services/sync/remote_snapshot_admission.js.map +1 -0
- package/dist/services/sync/seed_peer_schema.d.ts.map +1 -1
- package/dist/services/sync/seed_peer_schema.js +8 -0
- package/dist/services/sync/seed_peer_schema.js.map +1 -1
- package/dist/services/sync/sync_webhook_inbound.d.ts.map +1 -1
- package/dist/services/sync/sync_webhook_inbound.js +37 -9
- package/dist/services/sync/sync_webhook_inbound.js.map +1 -1
- package/dist/services/sync/sync_webhook_outbound.d.ts +8 -0
- package/dist/services/sync/sync_webhook_outbound.d.ts.map +1 -1
- package/dist/services/sync/sync_webhook_outbound.js +74 -0
- package/dist/services/sync/sync_webhook_outbound.js.map +1 -1
- package/dist/shared/action_handlers/entity_handlers.d.ts.map +1 -1
- package/dist/shared/action_handlers/entity_handlers.js +3 -20
- package/dist/shared/action_handlers/entity_handlers.js.map +1 -1
- package/dist/shared/action_handlers/exact_identity_read.d.ts +8 -0
- package/dist/shared/action_handlers/exact_identity_read.d.ts.map +1 -0
- package/dist/shared/action_handlers/exact_identity_read.js +67 -0
- package/dist/shared/action_handlers/exact_identity_read.js.map +1 -0
- package/dist/shared/action_schemas.d.ts +31 -12
- package/dist/shared/action_schemas.d.ts.map +1 -1
- package/dist/shared/action_schemas.js +22 -5
- package/dist/shared/action_schemas.js.map +1 -1
- package/dist/shared/contract_mappings.d.ts.map +1 -1
- package/dist/shared/contract_mappings.js +1 -0
- package/dist/shared/contract_mappings.js.map +1 -1
- package/dist/shared/harness_connections.d.ts +37 -0
- package/dist/shared/harness_connections.d.ts.map +1 -0
- package/dist/shared/harness_connections.js +339 -0
- package/dist/shared/harness_connections.js.map +1 -0
- package/dist/shared/http_content_negotiation.d.ts +7 -0
- package/dist/shared/http_content_negotiation.d.ts.map +1 -0
- package/dist/shared/http_content_negotiation.js +17 -0
- package/dist/shared/http_content_negotiation.js.map +1 -0
- package/dist/shared/openapi_types.d.ts +433 -12
- package/dist/shared/openapi_types.d.ts.map +1 -1
- package/dist/shared/schema_planning.d.ts +24 -0
- package/dist/shared/schema_planning.d.ts.map +1 -0
- package/dist/shared/schema_planning.js +22 -0
- package/dist/shared/schema_planning.js.map +1 -0
- package/dist/tool_definitions.d.ts +6 -0
- package/dist/tool_definitions.d.ts.map +1 -1
- package/dist/tool_definitions.js +27 -34
- package/dist/tool_definitions.js.map +1 -1
- package/docs/README.md +1 -1
- package/docs/developer/mcp/instructions.md +15 -4
- package/openapi.yaml +412 -11
- package/package.json +7 -7
- package/skills/continue-session/SKILL.md +547 -0
- package/skills/end/SKILL.md +3 -1
- package/skills/status/SKILL.md +302 -80
- package/skills/where/SKILL.md +36 -30
- package/dist/inspector/assets/agent_grant_form-BoNBvzEf.js +0 -1
- package/dist/inspector/assets/home-3AZtmjKp.js +0 -1
- package/dist/inspector/assets/interpretations-CjR2csNL.js +0 -1
- package/dist/inspector/assets/record_activity-kXm-jtQ6.js +0 -1
- package/dist/inspector/assets/use_interpretations-CCoQ6ihs.js +0 -1
package/dist/cli/setup.js
CHANGED
|
@@ -32,8 +32,70 @@ export function buildVerifyLine(doctor) {
|
|
|
32
32
|
const mcpLabel = hasMcpConfig ? "stdio" : "stdio (not yet configured)";
|
|
33
33
|
return `Neotoma installed at ${bin} (resolved via ${via}; ${ver}; data_dir=${dataDir}; mcp=${mcpLabel})`;
|
|
34
34
|
}
|
|
35
|
-
|
|
36
|
-
|
|
35
|
+
const MCP_PRESET_DESCRIPTION = {
|
|
36
|
+
a: "preset a: local signing proxy command forwarding to a signed HTTP MCP endpoint",
|
|
37
|
+
b: "preset b: local command that may forward MCP requests to a local Neotoma HTTP endpoint",
|
|
38
|
+
c: "preset c: local stdio command with no endpoint URL; the Neotoma server it starts checks the npm registry for updates unless NO_UPDATE_NOTIFIER=1",
|
|
39
|
+
d: "preset d: local signing proxy command forwarding to a signed HTTP MCP endpoint, with the dev entry pointed at the prod endpoint",
|
|
40
|
+
e: "preset e: local signing proxy command forwarding to a signed HTTP MCP endpoint, discovered from the local prod port file",
|
|
41
|
+
};
|
|
42
|
+
/**
|
|
43
|
+
* Plain-language description of what one preset's generated entries do (no URL, path or command).
|
|
44
|
+
* It describes only the mechanism: a local command or an HTTP endpoint, signed or not, and
|
|
45
|
+
* whether it forwards to an endpoint. No preset, entry or setup as a whole may claim the
|
|
46
|
+
* absence of network activity: even preset `c` starts a stdio server that checks the npm
|
|
47
|
+
* registry for updates. A test pins this for every preset, so this never throws during a
|
|
48
|
+
* user's setup run.
|
|
49
|
+
*/
|
|
50
|
+
export function describeWrittenMcpTransport(transport) {
|
|
51
|
+
return MCP_PRESET_DESCRIPTION[transport];
|
|
52
|
+
}
|
|
53
|
+
export const NO_MCP_ENTRY_WRITTEN_SUMMARY = "Transport: This line describes no Neotoma MCP entry, because this run recorded no new one. Any existing entries, including any setup repaired or re-pointed to a new port, were not checked.";
|
|
54
|
+
export const OTHER_MCP_ENTRIES_NOT_CHECKED = "Any other Neotoma entries in your MCP config, including any setup repaired or re-pointed to a new port, are not described here and were not checked.";
|
|
55
|
+
/**
|
|
56
|
+
* One-line transport summary built only from the entries this run generated and wrote.
|
|
57
|
+
* It never reads existing configs back, and never prints a URL, host, port, path,
|
|
58
|
+
* command, argument or environment value.
|
|
59
|
+
*/
|
|
60
|
+
export function buildPrivacyTransportSummary(written) {
|
|
61
|
+
const seen = new Set();
|
|
62
|
+
const clauses = [];
|
|
63
|
+
for (const entry of written ?? []) {
|
|
64
|
+
const key = `${entry.server_key}\u0000${entry.transport}`;
|
|
65
|
+
if (seen.has(key))
|
|
66
|
+
continue;
|
|
67
|
+
seen.add(key);
|
|
68
|
+
clauses.push(`${entry.server_key} (${describeWrittenMcpTransport(entry.transport)})`);
|
|
69
|
+
}
|
|
70
|
+
if (clauses.length === 0)
|
|
71
|
+
return NO_MCP_ENTRY_WRITTEN_SUMMARY;
|
|
72
|
+
// Setup may also have repaired or re-ported other entries (offerFix,
|
|
73
|
+
// applySessionPortsToUrls); those are not recorded here, so the line states only
|
|
74
|
+
// that they were not checked, never that they were unchanged.
|
|
75
|
+
return `Transport: this run wrote ${clauses.join("; ")}. ${OTHER_MCP_ENTRIES_NOT_CHECKED}`;
|
|
76
|
+
}
|
|
77
|
+
function isMcpTransportChoice(value) {
|
|
78
|
+
return value === "a" || value === "b" || value === "c" || value === "d" || value === "e";
|
|
79
|
+
}
|
|
80
|
+
/** Read `written` from the MCP step's details; anything malformed counts as nothing written. */
|
|
81
|
+
export function writtenEntriesFromMcpStep(step) {
|
|
82
|
+
if (!step || !step.ok || step.skipped)
|
|
83
|
+
return undefined;
|
|
84
|
+
const details = step.details;
|
|
85
|
+
if (!details || !Array.isArray(details.written))
|
|
86
|
+
return undefined;
|
|
87
|
+
const out = [];
|
|
88
|
+
for (const item of details.written) {
|
|
89
|
+
const candidate = item;
|
|
90
|
+
if (!candidate ||
|
|
91
|
+
typeof candidate.server_key !== "string" ||
|
|
92
|
+
!isMcpTransportChoice(candidate.transport)) {
|
|
93
|
+
return undefined;
|
|
94
|
+
}
|
|
95
|
+
out.push({ server_key: candidate.server_key, transport: candidate.transport });
|
|
96
|
+
}
|
|
97
|
+
return out;
|
|
98
|
+
}
|
|
37
99
|
/**
|
|
38
100
|
* Install published skills into the harness skills directory.
|
|
39
101
|
*
|
|
@@ -307,7 +369,7 @@ export async function runSetup(options = {}) {
|
|
|
307
369
|
doctor_after: doctorAfter,
|
|
308
370
|
overall_ok: overall,
|
|
309
371
|
verify_line: buildVerifyLine(doctorAfter),
|
|
310
|
-
privacy_transport_summary:
|
|
372
|
+
privacy_transport_summary: buildPrivacyTransportSummary(dryRun ? undefined : writtenEntriesFromMcpStep(mcpStep)),
|
|
311
373
|
};
|
|
312
374
|
}
|
|
313
375
|
//# sourceMappingURL=setup.js.map
|
package/dist/cli/setup.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA6B3E;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6C;IAC3E,MAAM,GAAG,GACP,MAAM,CAAC,OAAO,CAAC,aAAa;QAC5B,MAAM,CAAC,OAAO,CAAC,UAAU;QACzB,yCAAyC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,IAAI,SAAS,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAC/E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;IACrC,+FAA+F;IAC/F,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAClE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,eAAe,CAC1C,CAAC;IACF,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC;IACvE,OAAO,wBAAwB,GAAG,kBAAkB,GAAG,KAAK,GAAG,cAAc,OAAO,SAAS,QAAQ,GAAG,CAAC;AAC3G,CAAC;AAED,MAAM,sBAAsB,GAAuC;IACjE,CAAC,EAAE,gFAAgF;IACnF,CAAC,EAAE,wFAAwF;IAC3F,CAAC,EAAE,kJAAkJ;IACrJ,CAAC,EAAE,iIAAiI;IACpI,CAAC,EAAE,0HAA0H;CAC9H,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAA6B;IACvE,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GACvC,8LAA8L,CAAC;AAEjM,MAAM,CAAC,MAAM,6BAA6B,GACxC,sJAAsJ,CAAC;AAEzJ;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAsC;IACjF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,UAAU,SAAS,KAAK,CAAC,SAAS,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,KAAK,2BAA2B,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,4BAA4B,CAAC;IAC9D,qEAAqE;IACrE,iFAAiF;IACjF,8DAA8D;IAC9D,OAAO,6BAA6B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,6BAA6B,EAAE,CAAC;AAC7F,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;AAC3F,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,yBAAyB,CACvC,IAAiC;IAEjC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,OAA4C,CAAC;IAClE,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAA4D,CAAC;QAC/E,IACE,CAAC,SAAS;YACV,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ;YACxC,CAAC,oBAAoB,CAAC,SAAS,CAAC,SAAS,CAAC,EAC1C,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AA0BD;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,GAAW,EAAE,KAAyB;IACzE,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE;YACP,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAA2B,EAAE;IAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,IAAI,aAAa,GAAG,YAAY,CAAC;IAEjC,MAAM,SAAS,GACb,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAkB,SAAS,IAAI,YAAY,CAAC,iBAAiB,CAAC;IAExE,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,4BAA4B;IAC5B,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,aAAa,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,MAAM;YACV,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,MAAM;YACV,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,aAAa,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,IAAI,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,eAAe,CAC1C,CAAC;QACF,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,eAAe;gBACnB,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,oBAAoB;aAC7B,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,eAAe;gBACnB,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,eAAe;gBACnB,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,qBAAqB;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,IAAI,CACxE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,eAAe,CAC1C,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,qCAAqC;IACrC,IAAI,OAAO,CAAC,OAAO,EAAE,wBAAwB,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM;YAAE,aAAa,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,GAAG,aAAa,CAAC,gBAAgB,CAAC;QAC1C,MAAM,MAAM,GACV,EAAE,CAAC,OAAO,CAAC,MAAM;YACjB,EAAE,CAAC,OAAO,CAAC,MAAM;YACjB,EAAE,CAAC,OAAO,CAAC,KAAK;YAChB,EAAE,CAAC,IAAI,CAAC,MAAM;YACd,EAAE,CAAC,IAAI,CAAC,MAAM;YACd,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAChB,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,kBAAkB;gBACtB,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,oBAAoB;aAC7B,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,kBAAkB;gBACtB,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,kBAAkB;gBACtB,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,qBAAqB;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,IAAI,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,OAAO;YACX,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,OAAO;gBACX,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,mCAAmC,CAAC,CAAC,CAAC,oBAAoB;aACtF,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,OAAO;gBACX,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,oBAAoB;aAC7B,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,OAAO;gBACX,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,mBAAmB;aAC5B,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACzF,CAAC;aAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,OAAO;gBACX,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,sBAAsB;aAC/B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;gBACnC,IAAI,EAAE,WAAW;gBACjB,GAAG;gBACH,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,IAAI;gBACT,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,OAAO;gBACX,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBACnE,OAAO,EAAE;oBACP,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC/F,CAAC;SAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,QAAQ;YACZ,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,oBAAoB;SAC7B,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1F,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,6BAA6B;IAC7B,MAAM,iBAAiB,GAAsB,EAAE,CAAC;IAChD,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACzF,wEAAwE;QACxE,kEAAkE;QAClE,uEAAuE;QACvE,sDAAsD;QACtD,MAAM,YAAY,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE;YACvD,MAAM;YACN,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY;SACrC,CAAC,CAAC;QACH,iBAAiB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,aAAa;YACjB,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACxF,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,aAAa;YACjB,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,oCAAoC,CAAC,CAAC,CAAC,oBAAoB;SACvF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEzC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,MAAM;QACf,KAAK;QACL,kBAAkB,EAAE,iBAAiB;QACrC,aAAa,EAAE,YAAY;QAC3B,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,OAAO;QACnB,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC;QACzC,yBAAyB,EAAE,4BAA4B,CACrD,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,OAAO,CAAC,CACxD;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -107,7 +107,7 @@ There is no as-of query across the whole record: point-in-time reads work one en
|
|
|
107
107
|
|
|
108
108
|
## Corrections and deletions
|
|
109
109
|
|
|
110
|
-
A correction adds a new observation with source priority 1000 and no source. The earlier value is not edited and stays listed among the entity's observations. A correction
|
|
110
|
+
A correction adds a new observation with source priority 1000 and no source. The earlier value is not edited and stays listed among the entity's observations. A correction stays in effect until a later correction for the same field replaces it, whatever merge policy the field declares; an ordinary write at any priority does not displace it. On a `merge_array` field a later correction replaces the whole array ([issue #2341](https://github.com/markmhendrickson/neotoma/issues/2341)); on a `merge_array_by_key` field corrections combine by key.
|
|
111
111
|
|
|
112
112
|
Who made a correction is recorded only for writes over MCP, and only as the client name that the MCP client reports about itself.
|
|
113
113
|
|
|
@@ -59,7 +59,7 @@ Describe these properties only as far as the code supports them:
|
|
|
59
59
|
|
|
60
60
|
- **Provenance:** each current field names the observation that set it, and observations from a store link to their source. A correction observation has no source.
|
|
61
61
|
- **Determinism:** the reducer produces the same snapshot from the same observations and merge policies. Entity ids derive from the entity type and its identifying fields and agree across instances, unless tenant-scoped entity ids are on (sandbox mode or `NEOTOMA_TENANT_SCOPED_ENTITY_IDS`). Source and observation ids depend on the user and on the interpretation run, so they can differ between instances and runs: the stdio MCP server writes as a shared default user, so its ids repeat across installs, while the HTTP server (and so the CLI) runs by default in `local_sandbox` mode with a per-install user, so its source and observation ids differ across installs; and each interpretation run gets a new observation id. Do not write that source or observation ids match across instances.
|
|
62
|
-
- **Corrections:** a correction adds an observation, and the earlier value stays listed.
|
|
62
|
+
- **Corrections:** a correction adds an observation, and the earlier value stays listed. It stays authoritative on its field until a later correction replaces it, and an ordinary write does not displace it.
|
|
63
63
|
- **History:** an as-of read exists for one entity at a time (`retrieve_entity_snapshot` with `at` or `at_ingested`); there is no as-of query across the whole record, and export carries current values only.
|
|
64
64
|
- **Network use:** the CLI checks the npm registry for a newer release about once a day (off with `--no-update-check` or `NO_UPDATE_NOTIFIER=1`). The stdio MCP server checks when a session starts and about every 6 hours after that (off with `NO_UPDATE_NOTIFIER=1`). The request carries only the package name, and the registry sees ordinary connection metadata. Never write "no telemetry" or "no network egress" without that caveat.
|
|
65
65
|
|
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
`POST /corrections/transaction` (`correct_transaction` over MCP) applies a bounded set of ordinary correction observations in one existing database transaction. The CLI uses `neotoma request --operation correctTransaction --body '<json>'`. It is additive; existing single-entity correction behavior is unchanged.
|
|
4
4
|
|
|
5
|
-
Each of 1–50 unique targets supplies `entity_id`, actual `entity_type`, `expected_observation_count`, `expected_snapshot` fields and 1–50 unique `{field,value}` changes. Every changed field must be declared by the target's active schema. Read the current scoped snapshots immediately before constructing the transaction. The count catches concurrent writes even when timestamps coincide; expected fields additionally identify the state the caller reviewed.
|
|
5
|
+
Each of 1–50 unique targets supplies `entity_id`, actual `entity_type`, `expected_observation_count`, `expected_snapshot` fields and a `changes` array. A writing target has 1–50 unique `{field,value}` changes; a compare-only target has `changes: []` and at least one declared expected snapshot field. At least one target must write. Every changed field must be declared by the target's active schema. Read the current scoped snapshots immediately before constructing the transaction. The count catches concurrent writes even when timestamps coincide; expected fields additionally identify the state the caller reviewed. A compare-only target is checked inside the same transaction but creates no observation or notification.
|
|
6
6
|
|
|
7
7
|
The server authenticates the graph, applies the existing agent correction capability policy, and checks all targets inside the database transaction. A missing/cross-graph target, stale precondition, invalid field, failed write or correction that does not win the reducer rolls back all observations and snapshots. Existing observation/entity notifications are buffered until commit; a rolled-back attempt emits none.
|
|
8
8
|
|
|
9
|
-
The required `idempotency_key` belongs to the authenticated graph and complete canonical request. An exact retry returns `status: replayed` without new writes or notifications; changed payload with the same key fails. Receipts reuse the committed correction observations and their canonical hash. Responses contain current scoped snapshots, including on replay, rather than a frozen historical response. After an uncertain network response, retry the identical payload/key before deciding whether to construct a new transition. Do not overwrite a conflict or escalate correction priority to force it to win.
|
|
9
|
+
The required `idempotency_key` belongs to the authenticated graph and complete canonical request, including compare-only targets. An exact retry returns `status: replayed` without new writes or notifications; changed payload with the same key fails. Receipts reuse the committed correction observations and their canonical hash. Responses contain current scoped snapshots, including on replay, rather than a frozen historical response. A replay checks that each target remains in the authenticated graph and has the same entity type, but does not reapply stale preconditions to an already committed transition. After an uncertain network response, retry the identical payload/key before deciding whether to construct a new transition. Do not overwrite a conflict or escalate correction priority to force it to win.
|
|
10
10
|
|
|
11
11
|
This is a State Layer primitive. It does not interpret approvals, allocate application capacity, fetch external documents or certify human consent. The caller must derive its business transition and authorization from its own reviewed inputs, and include all affected entities in the transaction. The database commit cannot make an external document immutable; applications must verify external revisions through authorized APIs and retain their revision proof separately.
|
|
12
12
|
|
|
@@ -104,7 +104,7 @@ neotoma array-item patch <entityId> <entityType> <field> <keyField> <keyValue> -
|
|
|
104
104
|
neotoma array-item patch <entityId> <entityType> <field> <keyField> <keyValue> --item-json '{"status":"queued"}' --expected-item-absent
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
`keyValue` must be a string, boolean, or finite JSON number within the safe-integer range. A stale `--expected-item-version` (from a prior patch's `item_version`) returns a structured conflict (exit code non-zero, `status: "conflict"` with `current_item` / `current_item_version` in the JSON output) instead of overwriting; re-apply your change against `current_item` and retry with the fresh version. `--expected-item-absent` makes creation race-safe: exactly one concurrent creator succeeds. For non-array fields, read `entity_version` with `neotoma entities get`, then pass it to `neotoma corrections create <id> --expected-version <token>`; `--entity-type` is optional because the CLI resolves the stored type. See `docs/developer/mcp/instructions.md` [ENTITY & RELATIONSHIP LIFECYCLE] "Patching structured array fields" for the full contract.
|
|
107
|
+
`keyValue` must be a string, boolean, or finite JSON number within the safe-integer range. A stale `--expected-item-version` (from a prior patch's `item_version`) returns a structured conflict (exit code non-zero, `status: "conflict"` with `current_item` / `current_item_version` in the JSON output) instead of overwriting; re-apply your change against `current_item` and retry with the fresh version. `--expected-item-absent` makes creation race-safe: exactly one concurrent creator succeeds. For non-array fields, read `entity_version` with `neotoma entities get`, then pass it to `neotoma corrections create <id> --expected-version <token>`; `--entity-type` is optional because the CLI resolves the stored type. See `docs/developer/mcp/instructions.md` [ENTITY & RELATIONSHIP LIFECYCLE] "Patching structured array fields" for the full contract. For a plain `merge_array` field, `neotoma corrections create --corrected-value '["a","b"]'` replaces the whole array with exactly that list (`'[]'` clears it), so send the complete list; to restore an earlier list pass a fresh `--idempotency-key`, because the default key is derived from the value and would replay the earlier correction.
|
|
108
108
|
|
|
109
109
|
## Pre-check before storing (CLI backup)
|
|
110
110
|
|
|
@@ -156,6 +156,8 @@ neotoma relationships list --entity-id <entity_id>
|
|
|
156
156
|
|
|
157
157
|
Use narrow queries first, then expand only if needed.
|
|
158
158
|
|
|
159
|
+
**Exact identity proof:** use `neotoma request --operation queryEntities --body '<json>' --json` with the request defined in [RETRIEVAL] under “Exact identity proof.” Use the POST form so the identity stays out of the URL.
|
|
160
|
+
|
|
159
161
|
**Entity-id identifiers:** when the identifier is a literal `entity_id` (`ent_<hex>`), `entities search` / `retrieve_entity_by_identifier` short-circuits to a direct primary-key lookup and returns that entity exclusively (`match_mode: "direct"`) — it does not run name/text matching that would surface tangential rows mentioning the id. If no entity has that id for the caller, the response is `{ entities: [], total: 0, match_mode: "none", hint: … }` where `hint` points to `retrieve_entity_snapshot`; treat that as an explicit not-found for the id. For a known exact id, `retrieve_entity_snapshot` (`neotoma entities snapshot <entity_id>`) is the canonical direct fetch.
|
|
160
162
|
|
|
161
163
|
**Named entity-type routing:** see `docs/developer/mcp/instructions.md` (search "Named entity-type routing"). The CLI form is `neotoma entities list --type <entity_type>`. Run `neotoma instructions print` to see the canonical behavioral rule.
|
|
@@ -208,7 +210,7 @@ When rendering Neotoma Inspector links from CLI-backed memory operations, first
|
|
|
208
210
|
After running `neotoma setup --tool <harness> --yes`, two plain-text lines always appear on stdout (after the JSON report, if `--json` is active):
|
|
209
211
|
|
|
210
212
|
1. **Install-verification line** — grep for `Neotoma installed at` to confirm install succeeded. Format: `Neotoma installed at <path> (resolved via <manager>; v<version>; data_dir=<dir>; mcp=<transport>)`.
|
|
211
|
-
2. **
|
|
213
|
+
2. **Transport summary** — begins `Transport:` and describes only the Neotoma MCP entries this run wrote, one clause per entry with its server key and what its preset does. The line describes each written entry's mechanism (local command or HTTP endpoint, signed or not, and whether it forwards to an endpoint) and makes no claim that the entry, or Neotoma, makes no network requests. A preset `c` entry starts the stdio MCP server, which checks the npm registry for updates unless `NO_UPDATE_NOTIFIER=1`. When entries were written, the line adds that any other Neotoma entries in the MCP config are not described and were not checked. Setup may have repaired them or re-pointed them to a new port. When this run recorded no new entry (skipped, already configured, cancelled, dry run, or a repair), it says `Transport: This line describes no Neotoma MCP entry, because this run recorded no new one. Any existing entries, including any setup repaired or re-pointed to a new port, were not checked.` The line never includes a URL, host, port, path or command. The CLI and the stdio MCP server still check the npm registry for updates; set `NO_UPDATE_NOTIFIER=1` to disable those checks.
|
|
212
214
|
|
|
213
215
|
If the install-verification line is absent, check `neotoma status --json` (the `doctor` alias still works) for `neotoma.path_fix_hint` and surface it to the user.
|
|
214
216
|
|
|
@@ -277,5 +279,14 @@ before verification. Repeating the same endpoints/type is idempotent; unrelated
|
|
|
277
279
|
`related_to` edges remain unchanged. This is an explicit consumer migration, never
|
|
278
280
|
automatic registry side effect.
|
|
279
281
|
|
|
280
|
-
|
|
282
|
+
Immutability and corrections: a correction outranks every other write to its field, so a later `store` into a corrected field is not projected; change it only through a later correction. The canonical rule is the Immutability line in `docs/developer/mcp/instructions.md`; this is a transport-layer pointer only.
|
|
283
|
+
|
|
284
|
+
Atomic correction transport: `neotoma request --operation correctTransaction --body '<json>'` uses the same contract as MCP `correct_transaction`, including compare-only `changes: []` participants with a declared expected field and at least one writing participant. See `docs/developer/atomic_corrections.md` and the canonical behavioral instructions for retry and precondition semantics.
|
|
281
285
|
The committed `atomic_keyed_array_disjoint_writers` replay scenario uses the actual isolated HTTP tool. It binds deterministic portable item-version tokens by asserting the server's returned versions, then verifies a stale same-key conflict with current item/version, reviewed reapplication, exact replay and changed-payload refusal. Snapshot observation counts prove refusals/replay add no writes and the disjoint row survives. The cassette contains requests only. Removing the item-version comparison makes the same scenario fail; simultaneous arrival and post-commit event behavior are separately covered by `tests/unit/array_item_patch_atomic.test.ts`, including queued identical entity-CAS retries. This replay does not claim live-model reasoning or simultaneous HTTP arrival.
|
|
286
|
+
|
|
287
|
+
## Planning declaration commands
|
|
288
|
+
|
|
289
|
+
Use `neotoma schemas update <type> --planning '<json>'` for the existing versioned
|
|
290
|
+
schema operation, and `neotoma schemas list --summary --limit <budget> --json`
|
|
291
|
+
for its compact catalog. The canonical declaration, preservation and complete-census
|
|
292
|
+
rules are in `neotoma instructions print` under `[PLANNING DECLARATIONS]`.
|
|
@@ -472,7 +472,7 @@ Config scope for `neotoma init` is a binary switch: `--project-local` writes to
|
|
|
472
472
|
After the JSON report, `neotoma setup` always emits two plain-text lines to stdout (regardless of `--json` / `--pretty` mode):
|
|
473
473
|
|
|
474
474
|
1. **Install-verification line**: a single grep-able line confirming the binary path, version manager, version, data directory, and MCP transport. Format: `Neotoma installed at <path> (resolved via <manager>; v<version>; data_dir=<dir>; mcp=<transport>)`. Agent harnesses grep this line to confirm install succeeded without parsing JSON.
|
|
475
|
-
2. **Transport summary**: the
|
|
475
|
+
2. **Transport summary**: the line begins `Transport:` and describes only the Neotoma MCP entries this run wrote, one clause per entry: its server key and what its `--mcp-transport` preset does. The line describes each written entry's mechanism (local command or HTTP endpoint, signed or not, and whether it forwards to an endpoint) and makes no claim that the entry, or Neotoma, makes no network requests. A preset `c` entry is a local stdio command with no endpoint URL; the server it starts checks the npm registry for updates unless `NO_UPDATE_NOTIFIER=1`. When entries were written, the line adds that any other Neotoma entries in the MCP config are not described and were not checked. Setup may have repaired them or re-pointed them to a new port. When this run recorded no new entry (skipped, already configured, cancelled, dry run, or a repair of existing entries), it reads `Transport: This line describes no Neotoma MCP entry, because this run recorded no new one. Any existing entries, including any setup repaired or re-pointed to a new port, were not checked.` The line never prints a URL, host, port, path, command or environment value. It is not a statement about Neotoma as a whole: the CLI and the stdio MCP server still check the npm registry for updates, which the registry sees with ordinary connection metadata. Set `NO_UPDATE_NOTIFIER=1` to disable those checks (see [Update check](#update-check-stderr-notice)).
|
|
476
476
|
|
|
477
477
|
Use `neotoma setup --tool <harness> --yes` for the normal greenfield path. Use `neotoma mcp config` or `neotoma cli config` when only one layer needs repair.
|
|
478
478
|
|
|
@@ -726,10 +726,12 @@ Cross-instance peer sync. Backed by `src/services/sync/` and the HTTP `/peers` s
|
|
|
726
726
|
- `--peer-public-key-thumbprint <thumbprint>`: Expected AAuth thumbprint when `auth-method=aauth`.
|
|
727
727
|
- `--conflict-strategy <last_write_wins|source_priority|manual>` (default `last_write_wins`).
|
|
728
728
|
- `--target-user-id <id>`: Receiver `user_id` on the peer instance.
|
|
729
|
+
- Governance entity types (for example `issue`, `subscription`, `skill`) listed in `--types` are still refused from the peer until you accept them for it: `neotoma corrections create <peer_config_entity_id> --entity-type peer_config --field-name accept_governance_entity_types --corrected-value '["issue"]'`. `peers add` has no flag for this. See [Remote Snapshot Admission](../subsystems/peer_sync.md#remote-snapshot-admission).
|
|
729
730
|
- `neotoma peers list`: List configured peers.
|
|
730
731
|
- `neotoma peers status <peer_id>`: Show peer config plus `remote_health` (probed `{peer_url}/health`) and semver compatibility vs the local package version.
|
|
731
732
|
- `neotoma peers sync <peer_id>`: Run a bounded bilateral catch-up against the peer (push local changed observations, pull remote snapshots through `/sync/entities`).
|
|
732
733
|
- `--limit <n>`: Cap observations / snapshots per direction.
|
|
734
|
+
- Pulled rows whose `entity_type` is not admitted are skipped and reported as `refused`; pushed rows the peer refuses by entity type are reported as `refused_by_peer`, not `failed`.
|
|
733
735
|
- `neotoma peers remove <peer_id>`: Deactivate the peer (does not delete prior `observation_source: "sync"` rows).
|
|
734
736
|
|
|
735
737
|
### Interpretations
|
|
@@ -913,7 +915,9 @@ Main only; not in v0.25.0.
|
|
|
913
915
|
- Two patches against DIFFERENT keys on the same field both succeed regardless of ordering. This is the fix for the lost-update pattern where a caller reads the whole array, edits one row locally, and writes the full array back, which can silently discard a concurrent writer's disjoint row.
|
|
914
916
|
- Only applies to array fields whose active schema declares `merge_policies.<field>.strategy: "merge_array_by_key"` with the same `key_field` (see `docs/subsystems/reducer.md` §3.5); missing or mismatched policy fails closed before any write.
|
|
915
917
|
|
|
916
|
-
For non-array fields, `neotoma corrections create <entityId> --field-name <field> --corrected-value <value> --expected-version <entity_version>` provides entity-level CAS (main only; v0.25.0 has no `--expected-version`). The CLI resolves the stored entity type when `--entity-type` is omitted. A stale token exits non-zero with `ERR_FIELD_VERSION_CONFLICT`, the stored token, and retry guidance; an identical idempotency replay returns the original observation and value before evaluating the now-stale CAS token.
|
|
918
|
+
For non-array fields, `neotoma corrections create <entityId> --field-name <field> --corrected-value <value> --expected-version <entity_version>` provides entity-level CAS (main only; v0.25.0 has no `--expected-version`). The CLI resolves the stored entity type when `--entity-type` is omitted. A stale token exits non-zero with `ERR_FIELD_VERSION_CONFLICT`, the stored token, and retry guidance; an identical idempotency replay returns the original observation and value before evaluating the now-stale CAS token. On a `merge_array` field, `--corrected-value` with a JSON array replaces the whole array (`'[]'` clears it); send the complete list. The default idempotency key is derived from the entity, field and value, so any correction that repeats a value the field held before (restoring an earlier list, setting `last_sync_at` or `active` back to an earlier value) is answered as a replay: it reports success and writes nothing. Pass a fresh `--idempotency-key` whenever you repeat a value, and read the field back to confirm.
|
|
919
|
+
|
|
920
|
+
For a coordinated correction that also depends on an unchanged entity, use the generic `neotoma request --operation correctTransaction --body '<json>'` command. Include the unchanged entity in `entities` with its scoped ID, type, observation count, at least one declared expected snapshot field, and `changes: []`; another entity must have a correction. The guard is checked in the same transaction and creates no observation. See [`atomic_corrections.md`](atomic_corrections.md) for the payload and exact retry rule.
|
|
917
921
|
|
|
918
922
|
### Memory export
|
|
919
923
|
|
|
@@ -1278,3 +1282,10 @@ Load this document when updating CLI commands, options, or configuration behavio
|
|
|
1278
1282
|
- Config path and fields are accurate
|
|
1279
1283
|
- Main-only behaviour is marked
|
|
1280
1284
|
- Agent Instructions included
|
|
1285
|
+
|
|
1286
|
+
## Planning declaration commands
|
|
1287
|
+
|
|
1288
|
+
Use `neotoma schemas update <type> --planning '<json>'` for the existing versioned
|
|
1289
|
+
schema operation, and `neotoma schemas list --summary --limit <budget> --json`
|
|
1290
|
+
for its compact catalog. The canonical declaration, preservation and complete-census
|
|
1291
|
+
rules are in `neotoma instructions print` under `[PLANNING DECLARATIONS]`.
|
|
@@ -54,7 +54,7 @@ Entities **`entities[]` shape:** put every intended observation field at the **t
|
|
|
54
54
|
MCP tool choice: prefer **`store`** for all writes (entities-only, file-only, or combined). Deprecated MCP aliases `store_structured` and `store_unstructured` call the same handler as **`store`** until removed; use **`store`** in new prompts and configs.
|
|
55
55
|
Relationship batching: define ALL known links in the **`store`** `relationships` array whenever possible. Use { relationship_type, source_index, target_index } for entities in the same request, or { relationship_type, source_entity_id, target_entity_id } for existing entities already known by id. If you need to link an existing conversation/message/source entity to newly created entities, prefer re-including the existing entity in `entities` by stable identity fields and linking by index, or use id-based relationship entries in the same store call. If relationships must be created after a store response, use create_relationships with a relationships array; do not issue one create_relationship call per link when batching is possible.
|
|
56
56
|
Interpretation batching: when an agent extracts entities from a stored source (file, email, API detail payload, transcript, or other raw artifact), prefer one **`store`** call with `interpretation: { source_id | source_ref, interpretation_config }` plus any `relationships`. Use `source_ref: "unstructured"` for the raw file source in a combined file+entities store, and `source_ref: "structured"` only when intentionally interpreting the generated JSON source. Use `create_interpretation` when the source already exists and you are adding a post-hoc interpretation; use list_interpretations to review interpretation runs for a source. Omit `interpretation` for ordinary user-stated/chat-native structured facts; those observations intentionally keep `interpretation_id = NULL`.
|
|
57
|
-
Immutability: observations and sources are immutable after creation. correct creates a new priority-1000 observation; it
|
|
57
|
+
Immutability: observations and sources are immutable after creation. correct creates a new priority-1000 observation; it never edits or deletes prior ones. A correction outranks every other write to its field, at any priority, so it changes only through a later `correct` (merge_array_by_key fields combine corrections by key); `store` into it is silently not projected. After correct, independently retrieve the entity snapshot and field provenance; verify the intended value and the new correction observation materialized before claiming the correction took effect.
|
|
58
58
|
Turn identity: use host conversation_id/thread_id/session_id and turn_id when available. Keep one `conversation` entity and stable, chat-unique `conversation_id` across its turns; use `turn_key = "{conversation_id}:{turn_id}"` and a per-turn unique idempotency_key (e.g. `conversation-{conversation_id}-{turn_id}-{timestamp_ms}`). If only a generic session prefix exists, append a stable chat-specific suffix (first-message timestamp or short title hash). Never reuse unscoped keys (e.g. "cursor:1") across chats.
|
|
59
59
|
Session UUID bridge (Claude Code): in Claude Code contexts the SessionStart hook creates a `conversation` entity keyed by the raw session UUID while the MCP agent creates a slug-keyed entity (conversation_id = derived slug). Call `get_session_identity` once per session — at user-phase Step 2 retrieval or Step 3 store time — and include `session_uuid: <UUID returned by get_session_identity>` on the slug-keyed `conversation` entity so rows written by hooks correlate with the MCP conversation. FORBIDDEN: omitting `session_uuid` on the `conversation` entity in Claude Code contexts when `get_session_identity` is available and returns a session UUID.
|
|
60
60
|
Fallback IDs: without host conversation/turn ids, derive ONE chat-unique id from visible context (e.g. "chat-<topic-or-first-message-hash>-<session-start-timestamp>") and reuse it with a rising turn index or per-turn timestamp. Set `turn_key = "{synthetic_conversation_id}:<turn>"` and `idempotency_key = "conversation-{synthetic_conversation_id}-<turn>-<timestamp_ms>"`. With no thread context, use `session_epoch_ms` (first-message millisecond timestamp, fixed for the session): `turn_key = "chat-<session_epoch_ms>:<turn>"` and `idempotency_key = "conversation-chat-<session_epoch_ms>-<turn>-<timestamp_ms>"`. Fresh ids split one chat; bare "chat:<turn>" keys merge unrelated sessions.
|
|
@@ -97,7 +97,8 @@ Guardrails and answer grounding: start with small, targeted queries and expand o
|
|
|
97
97
|
Publication-recency: for prompts asking for "recently published" or equivalent publication-time ordering, sort by publication timestamp (`published_date` / `published_at`) descending, not by observation recency (`last_observation_at` / `updated_at`). Use a limit/page strategy large enough to avoid subset bias and deduplicate by entity_id before answering.
|
|
98
98
|
Entity-type cardinality: when the user asks how many entities exist per entity_type (counts by type, histogram, sorted type totals), answer from aggregated stats first — MCP get_entity_type_counts or OpenAPI getStats / HTTP GET /stats → entities_by_type. list_entity_types lists registered schemas; `field_count` there is schema field width — never report it as entity row counts or substitute it for cardinality. Exhaustive per-type totals via retrieve_entities with limit 1 per type are an expensive last resort, not the default presentation for "all types by count". See [ERRORS & RECOVERY] for getStats-unreachable behavior.
|
|
99
99
|
Bounded completeness: for list/count answers derived from entity graphs, run a bounded completeness pass before replying — check likely equivalent containers/identifiers and common relationship variants in that domain, deduplicate by entity_id, and report the reconciled total (or clearly note remaining ambiguity).
|
|
100
|
-
Deep pagination:
|
|
100
|
+
Deep pagination: with default sort (sort_by=entity_id, no search), retrieve_entities returns `next_cursor` while more results exist. Pass it verbatim as `cursor`; never construct/edit it. Cursor costs O(page size); growing offset costs O(offset) and is depth-limited. Cursor forbids search, non-default sort_by and nonzero offset; drop it when changing sort. No next_cursor means exhausted: stop, never resend the last cursor. On INVALID_CURSOR (stale token or changed sort), do not retry it: restart at page one or reissue with its original sort. Repeat an explicitly set sort_order on every page; later omission counts as a rejected sort change.
|
|
101
|
+
Exact identity proof: retrieve_entities with read_mode:"exact_identity", one entity_type and one snapshot_filters string equality on its sole declared canonical identity field; no other options/user_id. Identifiers: 1–64 lowercase ASCII letters/digits/underscore, starting with a letter. Value: 1–256 Unicode characters, no C0/C1 controls. Check exact_identity.common_view and state: singleton returns one verified entity; absent proves zero; ambiguous proves 2+; unproved means unavailable. Ordinary lists/unproved cannot certify identity. Requires an available file-libSQL pinned reader.
|
|
101
102
|
Schema and entity agent instructions: when `retrieve_entity_snapshot` or `retrieve_entities` returns a `schema_instructions` field, agents MUST treat that string as behavioral context for the entity type and apply it to the current turn — it is a markdown instruction from the schema's `agent_instructions` declaration. When a `entity_instructions` field is present, agents MUST treat that string as behavioral context for the specific entity and apply it, superseding or extending `schema_instructions`. Both fields are optional and may be absent; when absent, no special behavior is required. FORBIDDEN: ignoring `schema_instructions` or `entity_instructions` when present in a retrieval response.
|
|
102
103
|
|
|
103
104
|
[PROVENANCE]
|
|
@@ -148,6 +149,8 @@ Schema-check before storing known entity types: a type is known registered if li
|
|
|
148
149
|
Schema-first store for unfamiliar types: before FIRST store of a type unused this session outside the common chat list above, call list_entity_types(keyword matching the type name). If registered, apply schema-check; otherwise proceed schema-agnostic. This supplements checks of known schemas. FORBIDDEN: intuited fields for an unfamiliar type without discovery; common chat types retain their documented schema-agnostic default.
|
|
149
150
|
Full data fidelity: every field of source data MUST land in a stored field — either a declared schema field or a clearly named invented field. Do not silently drop data. If `unknown_fields_count > 0` in a store response, it means those fields are preserved on the observation but NOT projected onto the entity snapshot (the reducer projects only declared schema fields); immediately repair before proceeding to the closing assistant store. Repair ordering (do them in this order — the first that fits wins): (1) if an already-declared field fits the data, re-store or `correct` the value into that declared field — use `describe_entity_type` to see declared fields; (2) if no declared field fits and the schema declares `canonical_name_fields`, call `update_schema_incremental` to add the field, then re-store; (3) if the schema has NO `canonical_name_fields`, `update_schema_incremental` will fail with `ERR_SCHEMA_MISSING_IDENTITY_CONFIG` — instead `register_schema` a new version that adds the field, or `correct` the value into an existing declared field. If step (2) returns `ERR_SCHEMA_SCOPE_MISMATCH`, retry `update_schema_incremental` without `user_specific` — do NOT fall through to `register_schema` for that code (see Schema scope mismatch under Schema evolution). The store response's `hint` is computed against the actual schema and already names the path that will work for that type; follow it. FORBIDDEN: treating a store response with `unknown_fields_count > 0` as complete and proceeding without repair. FORBIDDEN: blindly calling `update_schema_incremental` on a schema with no identity config — it dead-ends; read the `hint`. Aggregate backlog triage: the per-store `unknown_fields` signal repairs one write; to see the *accumulated* stranded backlog across everything stored, call `audit_undeclared_fragments` (optionally scoped to one `entity_type`). It lists, per type, the undeclared `fragment_key`s with occurrence and affected-entity counts and a `schema_missing` flag — read-only, it declares nothing. Use it before drafting `update_schema_incremental` / `register_schema` work, or when you have seen repeated `unknown_fields` signals for a type, to decide which high-occurrence fields to promote first.
|
|
150
151
|
Required fields: when a store response includes `required_fields_missing`, the schema marks those fields `required: true` and the stored observation omitted them. The write was accepted (non-fatal) but the entity is incomplete; supply each missing field via `correct` before the closing store. Use `describe_entity_type` to learn which fields a type requires BEFORE the first store so the response comes back clean.
|
|
152
|
+
Correcting array fields: on a `merge_array` field a later `correct` replaces the whole array with exactly the `value` you pass (`[]` clears it), so send the complete list you want, not just the change; earlier corrections no longer union in. For keyed collections prefer `patch_array_item`.
|
|
153
|
+
|
|
151
154
|
Correcting into undeclared fields: `correct` accepts a `field` that is not declared on the schema (append path, parity with `store`). The value is preserved on the correction observation and mirrored to `raw_fragments`, and the response returns `unknown_field: true` with a `hint` plus a structured `details: { entity_type, field }`; like `store`, the value will not surface in the snapshot until the field is added to the schema. Before correcting into a new field, call `describe_entity_type` for the type to confirm no declared field already fits the data — prefer correcting into a declared field over creating yet another undeclared one. Use the undeclared-field append only to attach genuinely new structured data to an existing entity without a schema migration; promote the field later (via `update_schema_incremental` or `register_schema`, per the response `hint`) when it recurs. The MCP and HTTP transports return an identical `correct` response shape; the HTTP transport additionally includes `success` and `snapshot`.
|
|
152
155
|
Entity-type reuse check: before storing with an entity_type that is not one of the common types above and not in the agent's cached type list for this session, check for semantic equivalents among existing types — singular vs plural (place/places), synonyms (person/contact), prefix variants (social_post/social_media_post). If a match exists, use the established type. When uncertain, prefer the type with more existing entities. Call list_entity_types with a keyword search if the cached list is stale or unavailable. FORBIDDEN: creating a new entity_type when a semantically equivalent one already exists — this prevents type proliferation and duplicate schemas.
|
|
153
156
|
Schema evolution: schemas evolve via update_schema_incremental. Both adding fields (minor version bump) and removing fields (major version bump) are supported. Use fields_to_remove to prune noisy or inappropriate fields accumulated via auto-enhancement or early inference that do not represent the entity type. Removed fields are excluded from snapshots via schema-projection filtering but all observation data is preserved; re-adding a removed field restores it in snapshots. At least one field must remain after removal. update_schema_incremental also accepts `canonical_name_fields` to change an entity type's identity rule (how canonical_name / identity is derived) — a major version bump; the existing reducer_config is preserved automatically, so this is the safe way to re-key a type without a full register_schema re-supply. Reach for it when same-name-different-entity collisions appear (e.g. a bulk import collapses distinct people who share a name into one entity because identity resolves on `name` alone): re-key to a rule led by a unique field, e.g. `[{composite:["linkedin_url"]},"email","name"]`, so records with that field key on it and fall back in order. It governs NEW writes only — existing rows keep their stored canonical_name until re-derived. Verify the change with describe_entity_type (which surfaces canonical_name_fields).
|
|
@@ -157,7 +160,7 @@ Entity-type consistency within a workflow: within one import or workflow, pick o
|
|
|
157
160
|
Instruction scope (for /learn and future edits): keep MCP interaction instructions generalized and workflow-level (ordering, required steps, safety, idempotency, retrieval/store patterns). Avoid embedding domain- or dataset-specific modeling rules (e.g. instructions tailored to one roster, one customer list, or one content collection). When /learn updates MCP instructions, prefer reusable interaction guidance that applies across entities and workflows instead of case-specific data logic.
|
|
158
161
|
conversation_message sender semantics: for every `conversation_message` write (canonical entity_type as of v0.6; pre-v0.6 `agent_message` payloads still resolve via alias), always set `sender_kind` (one of `user` | `assistant` | `agent` | `system` | `tool`) alongside the legacy `role` field. `role` stays for backward compatibility but readers should prefer `sender_kind`. For agent-to-agent (A2A) traffic, set `sender_kind: "agent"` and include `sender_agent_id` + optional `recipient_agent_id` (stable identifiers; derive from AAuth thumbprint / clientInfo / agent_sub when available — see [ATTRIBUTION & AGENT IDENTITY]). For the parent `conversation`, set `thread_kind` to `human_agent` (default), `agent_agent`, or `multi_party` to describe the participant topology.
|
|
159
162
|
|
|
160
|
-
Atomic
|
|
163
|
+
Atomic correct_transaction: bind each existing participant's count and expected declared fields. A guard uses changes: [] plus >=1 expected field; another target must write. Guards add no observation/event. Bind idempotency to the whole request: retry exact payload/key after uncertainty. Stale guards need fresh review; never overwrite/escalate priority. Stored checks prove neither human approval nor external revision.
|
|
161
164
|
|
|
162
165
|
[ENTITY & RELATIONSHIP LIFECYCLE]
|
|
163
166
|
Soft delete: delete_entity(entity_id, entity_type, reason?) and delete_relationship(relationship_type, source_entity_id, target_entity_id, reason?) append deletion observations, excluding active snapshots/queries while retaining audit history; never physical removal.
|
|
@@ -167,6 +170,8 @@ Split: split_entity reverses over-merges by moving predicate-selected observatio
|
|
|
167
170
|
Patching structured array fields: patch_array_item(entity_id, entity_type, field, key_field, key_value, item, idempotency_key, expected_item_version?, expected_item_absent?) replaces full-array read-modify-write. Active array schema needs merge_array_by_key/matching key_field; missing policy or stored-type/key mismatch refuses before write. Keys: strings, booleans, finite safe-range JSON numbers; other historical keys stay unkeyed. One transaction compares/writes one key, preserving disjoint keys. Same-version rivals: one winner, ERR_ARRAY_ITEM_CONFLICT with current item/version. Review/reapply against current_item_version, never blind-overwrite. expected_item_absent:true gives single-winner creation; no preconditions means per-key last-write-wins. Versions: SHA-256 of stable UTF-8 JSON (sorted object keys, ordered arrays, JSON scalars). correct uses expected_version from entity_version plus explicit overwrite; stale CAS returns 409 ERR_FIELD_VERSION_CONFLICT/no write. Exact replay precedes CAS, returning committed observation/value; changed payload/key: ERR_IDEMPOTENCY_MISMATCH. CLI: docs/developer/cli_agent_instructions.md.
|
|
168
171
|
|
|
169
172
|
[RELATIONSHIP CREATION]
|
|
173
|
+
Store response size: `store` returns `related_entities` as compact `{id, entity_type, canonical_name}` entries (`id` = entity id) for linked entities, with no snapshots. Retrieve an entity by id (`retrieve_entity_snapshot`) when you need its fields, or pass `include_related_snapshots: true` to `store` to get each related entity's full row and snapshot back (can be hundreds of kilobytes for a large plan).
|
|
174
|
+
|
|
170
175
|
Pre-store candidate discovery: before completing any `store` operation that creates a new entity, check whether the new entity logically relates to entities already in context — same person, same project, same conversation thread, same source document, same organization. Use `retrieve_related_entities` or `retrieve_entity_by_identifier` to discover existing candidates when the session has not already confirmed their ids. When a candidate is found, create the relationship in the same `store` call using the `relationships` array (index-based or id-based entries), or immediately after with `create_relationships`. FORBIDDEN: completing a store turn that creates a new non-bookkeeping entity without first considering whether it has a logical relationship to entities already known this session or returned by bounded retrieval.
|
|
171
176
|
Relationship-in-same-store: prefer defining relationships in the `store` `relationships` array over separate `create_relationship` calls. Use `{ relationship_type, source_index, target_index }` when both entities are in the same request, or `{ relationship_type, source_entity_id, target_entity_id }` when linking to an existing entity whose id was returned by retrieval. Only use `create_relationships` as a follow-up when the target entity id was not known at store time.
|
|
172
177
|
Canonical relationship examples — use these as a guide when context implies a connection: (1) person or contact → organization/company: `REFERS_TO` (person works at or is affiliated with org); (2) task → conversation: `REFERS_TO` (task was created from or motivated by a conversation turn); (3) workout_session, run, or activity → source conversation: `REFERS_TO` (entity extracted from a chat message describing the session); (4) issue → plan or feature_spec: `REFERS_TO` (issue relates to a plan or spec); (5) note or report → analyzed entity: `REFERS_TO` (analysis references its subject); (6) event → location/place: `REFERS_TO` (event occurs at a place); (7) task → person/contact: `REFERS_TO` (task involves or is assigned to a person); (8) any extracted entity → source document or email: `REFERS_TO` (entity was extracted from that artifact, complementing the `interpretation` / `source_id` provenance chain). These examples are illustrative, not exhaustive — apply the same logic to any entity pair where one logically concerns, involves, or was produced from the other.
|
|
@@ -204,7 +209,9 @@ Display rule — empty state: before rendering the empty-state message or any `S
|
|
|
204
209
|
Display rule — override scope: the display rule overrides the silent-storage default and the no-emoji communication style for this disclosure only; do not narrate internal store sequencing.
|
|
205
210
|
neotoma_turn_summary rendering — Tier 1A (VS Code ≥ 1.109, Cursor ≥ 2.6, Continue, Claude mobile): the client fetches `ui://neotoma/turn-summary` as an MCP resource (`text/html;profile=mcp-app`) and renders it as an inline sandboxed widget; per-turn data arrives via `ui/initialize` and `ui/notifications/tool-result` postMessages — not via URI query params. Do not embed counts or conversation IDs in the resource URI; it is static. Tier 2 clients (Claude Code CLI, Windsurf, Codex Desktop): the widget does not render; `status_line` in the tool result is the user-visible fallback — emit it as plain text. Tier 1A and Tier 2 are mutually exclusive per session; do not attempt to render both. `@neotoma/ext-apps-widget-host` integrators: continue consuming `widget_uri` (the parameterized `ui://neotoma/turn-summary?…` form) via `resolveTurnSummaryWidget` for backward compatibility — this is a separate delivery path from the static MCP Apps resource URI.
|
|
206
211
|
Weekly value surfacing: when the conversation is the first of the day or the user has not interacted for several days, proactively run a bounded retrieval (list_recent_changes, retrieve_entities with a recent time window, or list_timeline_events for the past 7 days) and surface a brief summary: "You have N entities in Neotoma. Here is what changed this week: [2 new contacts, 3 tasks completed, 5 observations added]." Keep it to 1–2 sentences. Do not surface this more than once per day.
|
|
207
|
-
|
|
212
|
+
Guest visual artifacts: store a `rendered_page` with `title`, `html_body` and optional `custom_css`, then call **`publish_rendered_page`** for a guest_access_token, absolute `…/entities/<id>/html?access_token=<token>` URL and `ttl_seconds`. Or pass inline `{title, html_body, custom_css}` to create and publish in one call. `html_body` is inserted verbatim into a server template; omit `<html>/<head>/<body>` wrappers. CSS is inserted into `<head>`. Under `submitter_scoped`, bare `…/html` URLs return 401 to unauthenticated readers; share the tokenized URL.
|
|
213
|
+
|
|
214
|
+
Copyable blocks: `<pre data-copyable>`; no author scripts or event handlers. Verify full reader-path clipboard text. See docs/rendered_page.md.
|
|
208
215
|
|
|
209
216
|
[GITHUB ENTITY EXTRACTION]
|
|
210
217
|
Apply this section during the per-record scan (step 5 of the per-record extraction checklist in [COMMUNICATION & DISPLAY]) whenever an email, calendar invite, chat message, or web page body contains a GitHub issue URL, PR URL, org name, or project link. Full field reference and extraction examples: docs/subsystems/github_entities.md.
|
|
@@ -335,6 +342,10 @@ Chat transcript discovery: during onboarding, check for chat transcript exports
|
|
|
335
342
|
Session injection: the MCP `initialize` response includes `serverInfo._neotoma.standing_rules` — an array of persistent agent instructions stored as `standing_rule` entities in Neotoma. Each entry has `entity_id`, `title`, `rule_text`, `scope` (optional), and `priority` (higher = more important). Apply all injected rules from the first turn of the session without requiring a separate query. An empty array means no standing rules have been stored yet — UNLESS `serverInfo._neotoma.standing_rules_unavailable` is `true`, in which case the rules lookup FAILED and the empty array carries no information at all. When that flag is present (it appears only on failure, alongside a human-readable `standing_rules_note`), treat this instance's policy as UNKNOWN rather than absent: do not proceed as though the instance is unrestricted, tell the user plainly that you could not read the instance's standing rules, and be conservative about what you write — especially on a shared or client instance where an out-of-scope write is visible to others and cannot be quietly undone. FORBIDDEN: reporting 'no standing rules are configured' when `standing_rules_unavailable` is true.
|
|
336
343
|
Scope filtering: rules with a `scope` field set to a value other than `"global"` or `null` are intended for a specific project, repository, or context. Check whether the rule's scope matches the current context before applying it; skip rules whose scope does not match.
|
|
337
344
|
Storing new rules: to create a standing rule, store an entity with `entity_type: "standing_rule"`, required fields `title` and `rule_text`, and optional `scope` and `priority`. Set `enabled: false` on the entity to suppress injection without deleting the rule.
|
|
345
|
+
|
|
346
|
+
[PLANNING DECLARATIONS]
|
|
347
|
+
Use only schema_definition.planning = {level: finite number, read_only?: boolean}; names/ranks are instance-defined, never inferred from type names. These marks grant no execution/edit authority. update_schema_incremental accepts planning alone; omission preserves it and other declarations/fields/identity/reducers/row metadata. Existing scoped versioning, grants and effect gates apply.
|
|
348
|
+
Read the entire declared-level set through unfiltered list_entity_types or GET /schemas?summary=true&limit=<budget>&offset=0. Qualify registry_coverage only when all fields/types are present: version="1", state="complete", source="registry", exhausted=true, reasons=[], scope={owner:"authenticated",keyword:null,entity_type:null}, and known total=returned_count=actual row count. Require valid marks on every row. Missing/malformed, filtered/paginated or code-fallback evidence is unknown, never empty/complete. planning_error exposes invalid legacy marks; do not drop them or infer the highest rank from encountered task ancestry.
|
|
338
349
|
```
|
|
339
350
|
|
|
340
351
|
## One-call chat persistence
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Codex remote MCP setup
|
|
2
|
+
|
|
3
|
+
Connect Codex CLI to a Neotoma instance over HTTPS with MCP OAuth.
|
|
4
|
+
|
|
5
|
+
Applies to v0.25.0 and main. The Codex CLI commands reflect the installed CLI's `codex mcp --help`; check your own installed version if its options differ.
|
|
6
|
+
|
|
7
|
+
## Scope
|
|
8
|
+
|
|
9
|
+
This guide covers Codex on a different machine or in a sandbox that cannot run Neotoma locally. For a same-machine stdio connection, use [`neotoma setup --tool codex`](../../install.md#step-24-apply-the-full-setup-in-one-call). The repository's [`agent_cli_configuration.md`](agent_cli_configuration.md) describes local project config syncing, not this remote connection.
|
|
10
|
+
|
|
11
|
+
## Connect
|
|
12
|
+
|
|
13
|
+
1. Obtain the HTTPS base URL of a running Neotoma instance from its administrator. The instance must expose `/mcp` and support MCP OAuth. If it requires key-auth before OAuth, arrange that access with the administrator. If you are hosting the instance yourself from the published npm package, follow the [production deployment guide](../../install.md#production-deployment-headless--systemd): run the packaged `dist/actions.js` under a supervisor and put a TLS-terminating reverse proxy in front of it. The npm package cannot start this server with `neotoma api start`, and its `--tunnel` mode requires a source checkout.
|
|
14
|
+
|
|
15
|
+
For a temporary HTTPS tunnel instead, use a [Neotoma source checkout](../../install.md#developer-setup-source-checkout) with its dependencies installed and an [installed tunnel provider](tunnels.md#supported-providers). From that checkout, start the source-backed API and tunnel:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
neotoma api start --env prod --tunnel
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Follow the [tunnel guide](tunnels.md) to obtain its public HTTPS URL. Use the instance's actual URL; the MCP endpoint is `/mcp`.
|
|
22
|
+
|
|
23
|
+
2. On the machine running Codex, add the streamable HTTP endpoint. Substitute your own host in the command:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
codex mcp add neotoma --url https://<your-instance-host>/mcp
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
3. Start the OAuth flow and complete the browser's Neotoma authorization prompts. The instance may require its key-auth preflight before it offers connection approval. Codex also supports `codex mcp login neotoma --no-browser` when it cannot open a browser; that option prints an authorization URL and accepts the callback URL.
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
codex mcp login neotoma
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
4. Confirm that Codex has the server entry, then start or restart a Codex session and check its available MCP tools. `codex mcp get` checks configuration; a tool-list check in the session confirms the connection and authorization actually work.
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
codex mcp get neotoma
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
OAuth credentials are managed by Codex. Do not put an access token in the URL or commit one to project config. If discovery or login fails, consult [OAuth troubleshooting](mcp_oauth_troubleshooting.md) and confirm the instance's HTTPS URL and [OAuth discovery endpoint](mcp_cursor_setup.md#option-b-http-remote-via-tunnel).
|
|
42
|
+
|
|
43
|
+
## File storage across the connection
|
|
44
|
+
|
|
45
|
+
For `store`, a `file_path` names a path on the Neotoma server. A path on the Codex machine is not available to a remote instance and is rejected with `ERR_FILE_PATH_IS_SERVER_LOCAL`. Send bytes as `file_content` (base64) with `mime_type`, as shown in the [MCP overview](mcp_overview.md#store-a-file-over-remote-http-mcp), or use the REST multipart upload route for a larger file.
|
|
46
|
+
|
|
47
|
+
## Testing requirements
|
|
48
|
+
|
|
49
|
+
The supported command shapes are visible in `codex mcp add --help`, `codex mcp login --help`, and `codex mcp get --help`. Neotoma's HTTP endpoint and OAuth flow are implemented in `src/actions.ts` and `src/services/mcp_oauth.ts`; the [OAuth implementation reference](mcp_oauth_implementation.md) describes the server behavior. This guide does not assert that every third-party Codex version has been exercised against every Neotoma deployment.
|
|
50
|
+
|
|
51
|
+
See the [official Codex MCP documentation](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) for client-side server and OAuth options.
|
|
52
|
+
|
|
53
|
+
## Agent Instructions
|
|
54
|
+
|
|
55
|
+
### When to Load This Document
|
|
56
|
+
|
|
57
|
+
Load this guide when configuring Codex CLI to reach a remote Neotoma MCP server.
|
|
58
|
+
|
|
59
|
+
### Constraints Agents Must Enforce
|
|
60
|
+
|
|
61
|
+
Use the instance's actual HTTPS `/mcp` URL, keep credentials out of project files, and verify the tool list after login.
|
|
@@ -19,37 +19,29 @@ neotoma init
|
|
|
19
19
|
|
|
20
20
|
- Continue installed in your IDE (VS Code, JetBrains, or standalone).
|
|
21
21
|
|
|
22
|
-
## Option A:
|
|
22
|
+
## Option A: Host configuration
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
neotoma setup --tool continue --yes
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
This writes the Neotoma MCP server entry into `~/.continue/config.json` and verifies the connection.
|
|
24
|
+
Configure Continue manually with the current host format. `neotoma setup --tool continue` can write Cursor configuration instead of Continue configuration. Check the active Continue file and tool list.
|
|
29
25
|
|
|
30
26
|
## Option B: Manual — stdio (local install)
|
|
31
27
|
|
|
28
|
+
For the installed-package stdio example below, run `node -p "process.execPath"` and `npm root -g`, then replace the two example paths with the absolute Node.js executable and `<npm root -g>/neotoma/dist/index.js`. Confirm that file exists. This is the launch shape used by Neotoma's MCP config writer. A source checkout uses its absolute `scripts/run_neotoma_mcp_stdio_prod.sh` path instead.
|
|
29
|
+
|
|
32
30
|
Add to `~/.continue/config.json`:
|
|
33
31
|
|
|
34
32
|
```json
|
|
35
33
|
{
|
|
36
34
|
"mcpServers": {
|
|
37
35
|
"neotoma": {
|
|
38
|
-
"command": "
|
|
39
|
-
"args": ["
|
|
40
|
-
"env": {}
|
|
36
|
+
"command": "/absolute/path/to/node",
|
|
37
|
+
"args": ["/absolute/npm/root/neotoma/dist/index.js"],
|
|
38
|
+
"env": { "NEOTOMA_ACTIONS_DISABLE_AUTOSTART": "1", "NEOTOMA_ENV": "production" }
|
|
41
39
|
}
|
|
42
40
|
}
|
|
43
41
|
}
|
|
44
42
|
```
|
|
45
43
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
which neotoma
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Then substitute the full path, for example `/usr/local/bin/neotoma`.
|
|
44
|
+
Use the absolute Node.js executable and the installed package entrypoint found with the read-only commands above.
|
|
53
45
|
|
|
54
46
|
Restart Continue (reload the IDE window) after editing the config file.
|
|
55
47
|
|
|
@@ -87,7 +79,7 @@ For OAuth, `neotoma auth login` first, then add `"headers": { "Authorization": "
|
|
|
87
79
|
## Troubleshooting
|
|
88
80
|
|
|
89
81
|
- If tools do not appear after reload, check the Continue output panel for MCP server errors
|
|
90
|
-
- If using stdio and the command is not found, confirm the absolute path
|
|
82
|
+
- If using stdio and the command is not found, confirm the absolute Node.js path and package entrypoint and restart Continue
|
|
91
83
|
- If using HTTP and getting 401, run `neotoma auth login` and verify the tunnel is reachable
|
|
92
84
|
- Continue caches MCP server state; a full IDE restart clears stale state when a config change is not picked up
|
|
93
85
|
|
|
@@ -88,13 +88,16 @@ SSE is interchangeable with streamable HTTP for Neotoma's MCP endpoint.
|
|
|
88
88
|
|
|
89
89
|
## Option C: Stdio (Docker-only)
|
|
90
90
|
|
|
91
|
+
Inside the Letta container, for the installed-package stdio example below, run `node -p "process.execPath"` and `npm root -g`, then replace the two example paths with the absolute Node.js executable and `<npm root -g>/neotoma/dist/index.js`. Confirm that file exists. This is the launch shape used by Neotoma's MCP config writer. A source checkout uses its absolute `scripts/run_neotoma_mcp_stdio_prod.sh` path instead.
|
|
92
|
+
|
|
91
93
|
Letta supports stdio MCP servers when the Letta server runs in Docker and the MCP binary is available in the same container. This path is not recommended for most setups.
|
|
92
94
|
|
|
93
95
|
```python
|
|
94
96
|
neotoma_mcp = client.mcp_servers.create(config={
|
|
95
97
|
"mcp_server_type": "stdio",
|
|
96
|
-
"command": "
|
|
97
|
-
"args": ["
|
|
98
|
+
"command": "/absolute/path/to/node",
|
|
99
|
+
"args": ["/absolute/npm/root/neotoma/dist/index.js"],
|
|
100
|
+
"env": {"NEOTOMA_ACTIONS_DISABLE_AUTOSTART": "1", "NEOTOMA_ENV": "production"},
|
|
98
101
|
})
|
|
99
102
|
```
|
|
100
103
|
|
|
@@ -37,15 +37,17 @@ neotoma mcp config --user-level --yes
|
|
|
37
37
|
|
|
38
38
|
## Option B: Manual — stdio (local install)
|
|
39
39
|
|
|
40
|
+
For the installed-package stdio example below, run `node -p "process.execPath"` and `npm root -g`, then replace the two example paths with the absolute Node.js executable and `<npm root -g>/neotoma/dist/index.js`. Confirm that file exists. This is the launch shape used by Neotoma's MCP config writer. A source checkout uses its absolute `scripts/run_neotoma_mcp_stdio_prod.sh` path instead.
|
|
41
|
+
|
|
40
42
|
If your OpenClaw environment cannot spawn `neotoma setup`, configure the MCP server entry manually. OpenClaw reads the same `mcpServers` JSON format as Cursor:
|
|
41
43
|
|
|
42
44
|
```json
|
|
43
45
|
{
|
|
44
46
|
"mcpServers": {
|
|
45
47
|
"neotoma": {
|
|
46
|
-
"command": "
|
|
47
|
-
"args": ["
|
|
48
|
-
"env": {}
|
|
48
|
+
"command": "/absolute/path/to/node",
|
|
49
|
+
"args": ["/absolute/npm/root/neotoma/dist/index.js"],
|
|
50
|
+
"env": { "NEOTOMA_ACTIONS_DISABLE_AUTOSTART": "1", "NEOTOMA_ENV": "production" }
|
|
49
51
|
}
|
|
50
52
|
}
|
|
51
53
|
}
|