neotoma 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/README.md +15 -1
  2. package/dist/actions.d.ts.map +1 -1
  3. package/dist/actions.js +332 -150
  4. package/dist/actions.js.map +1 -1
  5. package/dist/cli/commands/mirror.d.ts +52 -0
  6. package/dist/cli/commands/mirror.d.ts.map +1 -0
  7. package/dist/cli/commands/mirror.js +147 -0
  8. package/dist/cli/commands/mirror.js.map +1 -0
  9. package/dist/cli/config.d.ts +8 -0
  10. package/dist/cli/config.d.ts.map +1 -1
  11. package/dist/cli/config.js.map +1 -1
  12. package/dist/cli/doctor.d.ts +76 -0
  13. package/dist/cli/doctor.d.ts.map +1 -0
  14. package/dist/cli/doctor.js +345 -0
  15. package/dist/cli/doctor.js.map +1 -0
  16. package/dist/cli/hooks.d.ts +45 -0
  17. package/dist/cli/hooks.d.ts.map +1 -0
  18. package/dist/cli/hooks.js +273 -0
  19. package/dist/cli/hooks.js.map +1 -0
  20. package/dist/cli/hooks_detect.d.ts +53 -0
  21. package/dist/cli/hooks_detect.d.ts.map +1 -0
  22. package/dist/cli/hooks_detect.js +220 -0
  23. package/dist/cli/hooks_detect.js.map +1 -0
  24. package/dist/cli/index.d.ts.map +1 -1
  25. package/dist/cli/index.js +595 -49
  26. package/dist/cli/index.js.map +1 -1
  27. package/dist/cli/permissions.d.ts +46 -0
  28. package/dist/cli/permissions.d.ts.map +1 -0
  29. package/dist/cli/permissions.js +191 -0
  30. package/dist/cli/permissions.js.map +1 -0
  31. package/dist/cli/setup.d.ts +46 -0
  32. package/dist/cli/setup.d.ts.map +1 -0
  33. package/dist/cli/setup.js +105 -0
  34. package/dist/cli/setup.js.map +1 -0
  35. package/dist/core/operations.d.ts +145 -0
  36. package/dist/core/operations.d.ts.map +1 -0
  37. package/dist/core/operations.js +106 -0
  38. package/dist/core/operations.js.map +1 -0
  39. package/dist/server.d.ts.map +1 -1
  40. package/dist/server.js +99 -4
  41. package/dist/server.js.map +1 -1
  42. package/dist/services/batch_correction.d.ts +129 -0
  43. package/dist/services/batch_correction.d.ts.map +1 -0
  44. package/dist/services/batch_correction.js +231 -0
  45. package/dist/services/batch_correction.js.map +1 -0
  46. package/dist/services/canonical_markdown.d.ts +145 -0
  47. package/dist/services/canonical_markdown.d.ts.map +1 -0
  48. package/dist/services/canonical_markdown.js +425 -0
  49. package/dist/services/canonical_markdown.js.map +1 -0
  50. package/dist/services/canonical_mirror.d.ts +127 -0
  51. package/dist/services/canonical_mirror.d.ts.map +1 -0
  52. package/dist/services/canonical_mirror.js +1047 -0
  53. package/dist/services/canonical_mirror.js.map +1 -0
  54. package/dist/services/canonical_mirror_git.d.ts +71 -0
  55. package/dist/services/canonical_mirror_git.d.ts.map +1 -0
  56. package/dist/services/canonical_mirror_git.js +211 -0
  57. package/dist/services/canonical_mirror_git.js.map +1 -0
  58. package/dist/services/entity_resolution.d.ts +17 -1
  59. package/dist/services/entity_resolution.d.ts.map +1 -1
  60. package/dist/services/entity_resolution.js +97 -24
  61. package/dist/services/entity_resolution.js.map +1 -1
  62. package/dist/services/entity_type_equivalence.d.ts +40 -0
  63. package/dist/services/entity_type_equivalence.d.ts.map +1 -0
  64. package/dist/services/entity_type_equivalence.js +109 -0
  65. package/dist/services/entity_type_equivalence.js.map +1 -0
  66. package/dist/services/entity_type_guard.d.ts +52 -0
  67. package/dist/services/entity_type_guard.d.ts.map +1 -0
  68. package/dist/services/entity_type_guard.js +204 -0
  69. package/dist/services/entity_type_guard.js.map +1 -0
  70. package/dist/services/file_text_extraction.d.ts.map +1 -1
  71. package/dist/services/file_text_extraction.js +5 -0
  72. package/dist/services/file_text_extraction.js.map +1 -1
  73. package/dist/services/flat_packed_detection.d.ts +32 -0
  74. package/dist/services/flat_packed_detection.d.ts.map +1 -0
  75. package/dist/services/flat_packed_detection.js +96 -0
  76. package/dist/services/flat_packed_detection.js.map +1 -0
  77. package/dist/services/interpretation.d.ts.map +1 -1
  78. package/dist/services/interpretation.js +9 -0
  79. package/dist/services/interpretation.js.map +1 -1
  80. package/dist/services/memory_export.d.ts +56 -0
  81. package/dist/services/memory_export.d.ts.map +1 -0
  82. package/dist/services/memory_export.js +295 -0
  83. package/dist/services/memory_export.js.map +1 -0
  84. package/dist/services/raw_fragments.js +1 -1
  85. package/dist/services/raw_fragments.js.map +1 -1
  86. package/dist/services/raw_storage.d.ts +6 -0
  87. package/dist/services/raw_storage.d.ts.map +1 -1
  88. package/dist/services/raw_storage.js +26 -0
  89. package/dist/services/raw_storage.js.map +1 -1
  90. package/dist/services/schema_definitions.d.ts.map +1 -1
  91. package/dist/services/schema_definitions.js +37 -0
  92. package/dist/services/schema_definitions.js.map +1 -1
  93. package/dist/services/schema_reference_linking.d.ts +38 -0
  94. package/dist/services/schema_reference_linking.d.ts.map +1 -0
  95. package/dist/services/schema_reference_linking.js +130 -0
  96. package/dist/services/schema_reference_linking.js.map +1 -0
  97. package/dist/services/schema_registry.d.ts +39 -0
  98. package/dist/services/schema_registry.d.ts.map +1 -1
  99. package/dist/services/schema_registry.js +91 -2
  100. package/dist/services/schema_registry.js.map +1 -1
  101. package/dist/services/snapshot_computation.d.ts.map +1 -1
  102. package/dist/services/snapshot_computation.js +10 -0
  103. package/dist/services/snapshot_computation.js.map +1 -1
  104. package/dist/services/timeline_events.d.ts +24 -5
  105. package/dist/services/timeline_events.d.ts.map +1 -1
  106. package/dist/services/timeline_events.js +89 -13
  107. package/dist/services/timeline_events.js.map +1 -1
  108. package/dist/shared/action_schemas.d.ts +18 -2
  109. package/dist/shared/action_schemas.d.ts.map +1 -1
  110. package/dist/shared/action_schemas.js +8 -0
  111. package/dist/shared/action_schemas.js.map +1 -1
  112. package/dist/shared/local_transport.d.ts +13 -0
  113. package/dist/shared/local_transport.d.ts.map +1 -1
  114. package/dist/shared/local_transport.js +89 -6
  115. package/dist/shared/local_transport.js.map +1 -1
  116. package/openapi.yaml +13 -0
  117. package/openclaw.plugin.json +1 -1
  118. package/package.json +18 -3
package/README.md CHANGED
@@ -220,12 +220,26 @@ Neotoma exposes state via MCP. Local storage only in preview. Local built-in aut
220
220
 
221
221
  **Representative actions:** `store`, `retrieve_entities`, `retrieve_entity_snapshot`, `merge_entities`, `list_observations`, `create_relationship`, `list_relationships`, `list_timeline_events`, `retrieve_graph_neighborhood`. Full list: [MCP spec](docs/specs/MCP_SPEC.md).
222
222
 
223
+ ## Using with AI tools (hooks)
224
+
225
+ Neotoma also integrates into harnesses that expose lifecycle hooks. Hooks and MCP compose: hooks are the reliability floor (guaranteed capture, retrieval injection, compaction awareness, persistence safety net) and MCP remains the quality ceiling (agent-driven structured writes).
226
+
227
+ | Harness | Package | Guide |
228
+ | --- | --- | --- |
229
+ | Claude Code | [`packages/claude-code-plugin`](packages/claude-code-plugin) | [docs/integrations/hooks/claude_code.md](docs/integrations/hooks/claude_code.md) |
230
+ | Cursor | [`packages/cursor-hooks`](packages/cursor-hooks) | [docs/integrations/hooks/cursor.md](docs/integrations/hooks/cursor.md) |
231
+ | OpenCode | [`packages/opencode-plugin`](packages/opencode-plugin) | [docs/integrations/hooks/opencode.md](docs/integrations/hooks/opencode.md) |
232
+ | Codex CLI | [`packages/codex-hooks`](packages/codex-hooks) | [docs/integrations/hooks/codex_cli.md](docs/integrations/hooks/codex_cli.md) |
233
+ | Claude Agent SDK | [`packages/claude-agent-sdk-adapter`](packages/claude-agent-sdk-adapter) | [docs/integrations/hooks/claude_agent_sdk.md](docs/integrations/hooks/claude_agent_sdk.md) |
234
+
235
+ Shared client libraries: [`@neotoma/client`](packages/client) (TypeScript), [`neotoma-client`](packages/client-python) (Python).
236
+
223
237
  ### OpenClaw native plugin
224
238
 
225
239
  Neotoma ships as a native OpenClaw plugin with `kind: "memory"`, so it can fill the dedicated memory slot. All 30+ MCP tools are registered as agent tools.
226
240
 
227
241
  ```bash
228
- openclaw plugins install neotoma
242
+ openclaw plugins install clawhub:neotoma
229
243
  ```
230
244
 
231
245
  Then assign it to the memory slot in your OpenClaw config:
package/dist/actions.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AA8E9B,eAAO,MAAM,GAAG,6CAAY,CAAC;AAwL7B,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAK5D;AAw7ID,wBAAsB,eAAe;;;eAgCpC"}
1
+ {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAoF9B,eAAO,MAAM,GAAG,6CAAY,CAAC;AAwL7B,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAK5D;AA2pJD,wBAAsB,eAAe;;;eAgCpC"}