surreal-memory 2.0.0__tar.gz

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 (371) hide show
  1. surreal_memory-2.0.0/.gitignore +241 -0
  2. surreal_memory-2.0.0/LICENSE +21 -0
  3. surreal_memory-2.0.0/NOTICE +26 -0
  4. surreal_memory-2.0.0/PKG-INFO +484 -0
  5. surreal_memory-2.0.0/README.md +373 -0
  6. surreal_memory-2.0.0/pyproject.toml +316 -0
  7. surreal_memory-2.0.0/src/surreal_memory/__init__.py +48 -0
  8. surreal_memory-2.0.0/src/surreal_memory/cli/__init__.py +15 -0
  9. surreal_memory-2.0.0/src/surreal_memory/cli/__main__.py +6 -0
  10. surreal_memory-2.0.0/src/surreal_memory/cli/_helpers.py +192 -0
  11. surreal_memory-2.0.0/src/surreal_memory/cli/commands/__init__.py +1 -0
  12. surreal_memory-2.0.0/src/surreal_memory/cli/commands/brain.py +612 -0
  13. surreal_memory-2.0.0/src/surreal_memory/cli/commands/codebase.py +107 -0
  14. surreal_memory-2.0.0/src/surreal_memory/cli/commands/config_cmd.py +134 -0
  15. surreal_memory-2.0.0/src/surreal_memory/cli/commands/habits.py +305 -0
  16. surreal_memory-2.0.0/src/surreal_memory/cli/commands/info.py +490 -0
  17. surreal_memory-2.0.0/src/surreal_memory/cli/commands/listing.py +427 -0
  18. surreal_memory-2.0.0/src/surreal_memory/cli/commands/memory.py +590 -0
  19. surreal_memory-2.0.0/src/surreal_memory/cli/commands/project.py +427 -0
  20. surreal_memory-2.0.0/src/surreal_memory/cli/commands/shared.py +376 -0
  21. surreal_memory-2.0.0/src/surreal_memory/cli/commands/shortcuts.py +401 -0
  22. surreal_memory-2.0.0/src/surreal_memory/cli/commands/storage.py +72 -0
  23. surreal_memory-2.0.0/src/surreal_memory/cli/commands/telegram.py +127 -0
  24. surreal_memory-2.0.0/src/surreal_memory/cli/commands/tools.py +1102 -0
  25. surreal_memory-2.0.0/src/surreal_memory/cli/commands/train.py +117 -0
  26. surreal_memory-2.0.0/src/surreal_memory/cli/commands/update.py +224 -0
  27. surreal_memory-2.0.0/src/surreal_memory/cli/commands/version.py +280 -0
  28. surreal_memory-2.0.0/src/surreal_memory/cli/commands/watch.py +125 -0
  29. surreal_memory-2.0.0/src/surreal_memory/cli/config.py +231 -0
  30. surreal_memory-2.0.0/src/surreal_memory/cli/doctor.py +1022 -0
  31. surreal_memory-2.0.0/src/surreal_memory/cli/embedding_setup.py +199 -0
  32. surreal_memory-2.0.0/src/surreal_memory/cli/full_setup.py +425 -0
  33. surreal_memory-2.0.0/src/surreal_memory/cli/graph_export.py +455 -0
  34. surreal_memory-2.0.0/src/surreal_memory/cli/ide_rules.py +243 -0
  35. surreal_memory-2.0.0/src/surreal_memory/cli/main.py +149 -0
  36. surreal_memory-2.0.0/src/surreal_memory/cli/markdown_export.py +249 -0
  37. surreal_memory-2.0.0/src/surreal_memory/cli/setup.py +426 -0
  38. surreal_memory-2.0.0/src/surreal_memory/cli/storage.py +178 -0
  39. surreal_memory-2.0.0/src/surreal_memory/cli/tui.py +471 -0
  40. surreal_memory-2.0.0/src/surreal_memory/cli/update_check.py +181 -0
  41. surreal_memory-2.0.0/src/surreal_memory/cli/wizard.py +258 -0
  42. surreal_memory-2.0.0/src/surreal_memory/config_presets.py +175 -0
  43. surreal_memory-2.0.0/src/surreal_memory/core/__init__.py +57 -0
  44. surreal_memory-2.0.0/src/surreal_memory/core/action_event.py +39 -0
  45. surreal_memory-2.0.0/src/surreal_memory/core/alert.py +69 -0
  46. surreal_memory-2.0.0/src/surreal_memory/core/brain.py +416 -0
  47. surreal_memory-2.0.0/src/surreal_memory/core/brain_mode.py +273 -0
  48. surreal_memory-2.0.0/src/surreal_memory/core/eternal_context.py +273 -0
  49. surreal_memory-2.0.0/src/surreal_memory/core/fiber.py +312 -0
  50. surreal_memory-2.0.0/src/surreal_memory/core/memory_types.py +606 -0
  51. surreal_memory-2.0.0/src/surreal_memory/core/neuron.py +235 -0
  52. surreal_memory-2.0.0/src/surreal_memory/core/project.py +279 -0
  53. surreal_memory-2.0.0/src/surreal_memory/core/review_schedule.py +89 -0
  54. surreal_memory-2.0.0/src/surreal_memory/core/source.py +103 -0
  55. surreal_memory-2.0.0/src/surreal_memory/core/synapse.py +357 -0
  56. surreal_memory-2.0.0/src/surreal_memory/core/trigger_engine.py +226 -0
  57. surreal_memory-2.0.0/src/surreal_memory/engine/__init__.py +29 -0
  58. surreal_memory-2.0.0/src/surreal_memory/engine/activation.py +534 -0
  59. surreal_memory-2.0.0/src/surreal_memory/engine/arousal.py +220 -0
  60. surreal_memory-2.0.0/src/surreal_memory/engine/associative_inference.py +246 -0
  61. surreal_memory-2.0.0/src/surreal_memory/engine/brain_evolution.py +479 -0
  62. surreal_memory-2.0.0/src/surreal_memory/engine/brain_transplant.py +353 -0
  63. surreal_memory-2.0.0/src/surreal_memory/engine/brain_versioning.py +438 -0
  64. surreal_memory-2.0.0/src/surreal_memory/engine/causal_traversal.py +304 -0
  65. surreal_memory-2.0.0/src/surreal_memory/engine/chart_generator.py +319 -0
  66. surreal_memory-2.0.0/src/surreal_memory/engine/chunking.py +148 -0
  67. surreal_memory-2.0.0/src/surreal_memory/engine/citation.py +150 -0
  68. surreal_memory-2.0.0/src/surreal_memory/engine/clustering.py +41 -0
  69. surreal_memory-2.0.0/src/surreal_memory/engine/codebase_encoder.py +258 -0
  70. surreal_memory-2.0.0/src/surreal_memory/engine/cognitive.py +192 -0
  71. surreal_memory-2.0.0/src/surreal_memory/engine/compression.py +1002 -0
  72. surreal_memory-2.0.0/src/surreal_memory/engine/conflict_auto_resolve.py +143 -0
  73. surreal_memory-2.0.0/src/surreal_memory/engine/conflict_detection.py +602 -0
  74. surreal_memory-2.0.0/src/surreal_memory/engine/connection_explainer.py +249 -0
  75. surreal_memory-2.0.0/src/surreal_memory/engine/consolidation.py +1795 -0
  76. surreal_memory-2.0.0/src/surreal_memory/engine/consolidation_delta.py +227 -0
  77. surreal_memory-2.0.0/src/surreal_memory/engine/context_merger.py +151 -0
  78. surreal_memory-2.0.0/src/surreal_memory/engine/context_optimizer.py +467 -0
  79. surreal_memory-2.0.0/src/surreal_memory/engine/context_retrieval.py +142 -0
  80. surreal_memory-2.0.0/src/surreal_memory/engine/cross_brain.py +227 -0
  81. surreal_memory-2.0.0/src/surreal_memory/engine/db_introspector.py +415 -0
  82. surreal_memory-2.0.0/src/surreal_memory/engine/db_knowledge.py +638 -0
  83. surreal_memory-2.0.0/src/surreal_memory/engine/db_trainer.py +421 -0
  84. surreal_memory-2.0.0/src/surreal_memory/engine/decision_intel.py +330 -0
  85. surreal_memory-2.0.0/src/surreal_memory/engine/dedup/__init__.py +12 -0
  86. surreal_memory-2.0.0/src/surreal_memory/engine/dedup/config.py +104 -0
  87. surreal_memory-2.0.0/src/surreal_memory/engine/dedup/llm_judge.py +154 -0
  88. surreal_memory-2.0.0/src/surreal_memory/engine/dedup/pipeline.py +262 -0
  89. surreal_memory-2.0.0/src/surreal_memory/engine/dedup/prompts.py +44 -0
  90. surreal_memory-2.0.0/src/surreal_memory/engine/depth_prior.py +355 -0
  91. surreal_memory-2.0.0/src/surreal_memory/engine/diagnostics.py +743 -0
  92. surreal_memory-2.0.0/src/surreal_memory/engine/doc_chunker.py +414 -0
  93. surreal_memory-2.0.0/src/surreal_memory/engine/doc_extractor.py +593 -0
  94. surreal_memory-2.0.0/src/surreal_memory/engine/doc_trainer.py +664 -0
  95. surreal_memory-2.0.0/src/surreal_memory/engine/dream.py +138 -0
  96. surreal_memory-2.0.0/src/surreal_memory/engine/drift_detection.py +502 -0
  97. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/__init__.py +10 -0
  98. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/config.py +47 -0
  99. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/gemini_embedding.py +109 -0
  100. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/ollama_embedding.py +113 -0
  101. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/openai_embedding.py +95 -0
  102. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/openrouter_embedding.py +38 -0
  103. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/provider.py +46 -0
  104. surreal_memory-2.0.0/src/surreal_memory/engine/embedding/sentence_transformer.py +72 -0
  105. surreal_memory-2.0.0/src/surreal_memory/engine/encoder.py +475 -0
  106. surreal_memory-2.0.0/src/surreal_memory/engine/enrichment.py +240 -0
  107. surreal_memory-2.0.0/src/surreal_memory/engine/fidelity.py +538 -0
  108. surreal_memory-2.0.0/src/surreal_memory/engine/file_watcher.py +369 -0
  109. surreal_memory-2.0.0/src/surreal_memory/engine/fuzzy_match.py +110 -0
  110. surreal_memory-2.0.0/src/surreal_memory/engine/fuzzy_query.py +251 -0
  111. surreal_memory-2.0.0/src/surreal_memory/engine/gromov.py +238 -0
  112. surreal_memory-2.0.0/src/surreal_memory/engine/hippocampal_replay.py +174 -0
  113. surreal_memory-2.0.0/src/surreal_memory/engine/hooks.py +112 -0
  114. surreal_memory-2.0.0/src/surreal_memory/engine/idf_anchor.py +100 -0
  115. surreal_memory-2.0.0/src/surreal_memory/engine/importance.py +99 -0
  116. surreal_memory-2.0.0/src/surreal_memory/engine/interference.py +274 -0
  117. surreal_memory-2.0.0/src/surreal_memory/engine/koopman.py +227 -0
  118. surreal_memory-2.0.0/src/surreal_memory/engine/learning_rule.py +230 -0
  119. surreal_memory-2.0.0/src/surreal_memory/engine/lifecycle.py +436 -0
  120. surreal_memory-2.0.0/src/surreal_memory/engine/memory_stages.py +247 -0
  121. surreal_memory-2.0.0/src/surreal_memory/engine/merge.py +379 -0
  122. surreal_memory-2.0.0/src/surreal_memory/engine/narrative.py +255 -0
  123. surreal_memory-2.0.0/src/surreal_memory/engine/pattern_extraction.py +205 -0
  124. surreal_memory-2.0.0/src/surreal_memory/engine/pipeline.py +126 -0
  125. surreal_memory-2.0.0/src/surreal_memory/engine/pipeline_steps.py +1694 -0
  126. surreal_memory-2.0.0/src/surreal_memory/engine/ppr_activation.py +291 -0
  127. surreal_memory-2.0.0/src/surreal_memory/engine/prediction_error.py +259 -0
  128. surreal_memory-2.0.0/src/surreal_memory/engine/priming.py +518 -0
  129. surreal_memory-2.0.0/src/surreal_memory/engine/quality_scorer.py +294 -0
  130. surreal_memory-2.0.0/src/surreal_memory/engine/query_expander.py +212 -0
  131. surreal_memory-2.0.0/src/surreal_memory/engine/query_expansion.py +106 -0
  132. surreal_memory-2.0.0/src/surreal_memory/engine/query_pattern_mining.py +408 -0
  133. surreal_memory-2.0.0/src/surreal_memory/engine/reconsolidation.py +221 -0
  134. surreal_memory-2.0.0/src/surreal_memory/engine/reconstruction.py +374 -0
  135. surreal_memory-2.0.0/src/surreal_memory/engine/reflection.py +148 -0
  136. surreal_memory-2.0.0/src/surreal_memory/engine/reflex_activation.py +389 -0
  137. surreal_memory-2.0.0/src/surreal_memory/engine/reranker.py +216 -0
  138. surreal_memory-2.0.0/src/surreal_memory/engine/retrieval.py +1849 -0
  139. surreal_memory-2.0.0/src/surreal_memory/engine/retrieval_context.py +485 -0
  140. surreal_memory-2.0.0/src/surreal_memory/engine/retrieval_types.py +95 -0
  141. surreal_memory-2.0.0/src/surreal_memory/engine/schema_assimilation.py +357 -0
  142. surreal_memory-2.0.0/src/surreal_memory/engine/score_fusion.py +117 -0
  143. surreal_memory-2.0.0/src/surreal_memory/engine/semantic_discovery.py +303 -0
  144. surreal_memory-2.0.0/src/surreal_memory/engine/sequence_mining.py +414 -0
  145. surreal_memory-2.0.0/src/surreal_memory/engine/session_state.py +306 -0
  146. surreal_memory-2.0.0/src/surreal_memory/engine/spaced_repetition.py +136 -0
  147. surreal_memory-2.0.0/src/surreal_memory/engine/stabilization.py +165 -0
  148. surreal_memory-2.0.0/src/surreal_memory/engine/sufficiency.py +503 -0
  149. surreal_memory-2.0.0/src/surreal_memory/engine/temporal_binding.py +107 -0
  150. surreal_memory-2.0.0/src/surreal_memory/engine/tier_engine.py +286 -0
  151. surreal_memory-2.0.0/src/surreal_memory/engine/token_budget.py +231 -0
  152. surreal_memory-2.0.0/src/surreal_memory/engine/token_normalizer.py +159 -0
  153. surreal_memory-2.0.0/src/surreal_memory/engine/tool_memory.py +377 -0
  154. surreal_memory-2.0.0/src/surreal_memory/engine/topology_analysis.py +233 -0
  155. surreal_memory-2.0.0/src/surreal_memory/engine/watch_state.py +206 -0
  156. surreal_memory-2.0.0/src/surreal_memory/engine/workflow_suggest.py +108 -0
  157. surreal_memory-2.0.0/src/surreal_memory/engine/write_queue.py +147 -0
  158. surreal_memory-2.0.0/src/surreal_memory/extraction/__init__.py +51 -0
  159. surreal_memory-2.0.0/src/surreal_memory/extraction/codebase.py +580 -0
  160. surreal_memory-2.0.0/src/surreal_memory/extraction/entities.py +697 -0
  161. surreal_memory-2.0.0/src/surreal_memory/extraction/keywords.py +457 -0
  162. surreal_memory-2.0.0/src/surreal_memory/extraction/llm_provider.py +98 -0
  163. surreal_memory-2.0.0/src/surreal_memory/extraction/parser.py +385 -0
  164. surreal_memory-2.0.0/src/surreal_memory/extraction/relations.py +514 -0
  165. surreal_memory-2.0.0/src/surreal_memory/extraction/router.py +435 -0
  166. surreal_memory-2.0.0/src/surreal_memory/extraction/sentiment.py +576 -0
  167. surreal_memory-2.0.0/src/surreal_memory/extraction/structure_detector.py +334 -0
  168. surreal_memory-2.0.0/src/surreal_memory/extraction/temporal.py +440 -0
  169. surreal_memory-2.0.0/src/surreal_memory/git_context.py +76 -0
  170. surreal_memory-2.0.0/src/surreal_memory/hooks/__init__.py +4 -0
  171. surreal_memory-2.0.0/src/surreal_memory/hooks/post_tool_use.py +201 -0
  172. surreal_memory-2.0.0/src/surreal_memory/hooks/pre_compact.py +309 -0
  173. surreal_memory-2.0.0/src/surreal_memory/hooks/session_start.py +91 -0
  174. surreal_memory-2.0.0/src/surreal_memory/hooks/stop.py +535 -0
  175. surreal_memory-2.0.0/src/surreal_memory/integration/__init__.py +30 -0
  176. surreal_memory-2.0.0/src/surreal_memory/integration/adapter.py +78 -0
  177. surreal_memory-2.0.0/src/surreal_memory/integration/adapters/__init__.py +138 -0
  178. surreal_memory-2.0.0/src/surreal_memory/integration/adapters/awf_adapter.py +335 -0
  179. surreal_memory-2.0.0/src/surreal_memory/integration/adapters/chromadb_adapter.py +212 -0
  180. surreal_memory-2.0.0/src/surreal_memory/integration/adapters/cognee_adapter.py +192 -0
  181. surreal_memory-2.0.0/src/surreal_memory/integration/adapters/graphiti_adapter.py +342 -0
  182. surreal_memory-2.0.0/src/surreal_memory/integration/adapters/llamaindex_adapter.py +194 -0
  183. surreal_memory-2.0.0/src/surreal_memory/integration/adapters/mem0_adapter.py +261 -0
  184. surreal_memory-2.0.0/src/surreal_memory/integration/mapper.py +273 -0
  185. surreal_memory-2.0.0/src/surreal_memory/integration/models.py +180 -0
  186. surreal_memory-2.0.0/src/surreal_memory/integration/sync_engine.py +240 -0
  187. surreal_memory-2.0.0/src/surreal_memory/integration/telegram.py +235 -0
  188. surreal_memory-2.0.0/src/surreal_memory/integrations/__init__.py +1 -0
  189. surreal_memory-2.0.0/src/surreal_memory/integrations/nanobot/__init__.py +32 -0
  190. surreal_memory-2.0.0/src/surreal_memory/integrations/nanobot/base_tool.py +58 -0
  191. surreal_memory-2.0.0/src/surreal_memory/integrations/nanobot/context.py +33 -0
  192. surreal_memory-2.0.0/src/surreal_memory/integrations/nanobot/memory_store.py +206 -0
  193. surreal_memory-2.0.0/src/surreal_memory/integrations/nanobot/protocol.py +34 -0
  194. surreal_memory-2.0.0/src/surreal_memory/integrations/nanobot/setup.py +80 -0
  195. surreal_memory-2.0.0/src/surreal_memory/integrations/nanobot/tools.py +374 -0
  196. surreal_memory-2.0.0/src/surreal_memory/integrations/openclaw_config.py +226 -0
  197. surreal_memory-2.0.0/src/surreal_memory/mcp/__init__.py +9 -0
  198. surreal_memory-2.0.0/src/surreal_memory/mcp/__main__.py +6 -0
  199. surreal_memory-2.0.0/src/surreal_memory/mcp/alert_handler.py +196 -0
  200. surreal_memory-2.0.0/src/surreal_memory/mcp/auto_capture.py +317 -0
  201. surreal_memory-2.0.0/src/surreal_memory/mcp/auto_handler.py +440 -0
  202. surreal_memory-2.0.0/src/surreal_memory/mcp/budget_handler.py +214 -0
  203. surreal_memory-2.0.0/src/surreal_memory/mcp/cognitive_handler.py +1570 -0
  204. surreal_memory-2.0.0/src/surreal_memory/mcp/conflict_handler.py +318 -0
  205. surreal_memory-2.0.0/src/surreal_memory/mcp/connection_handler.py +73 -0
  206. surreal_memory-2.0.0/src/surreal_memory/mcp/constants.py +14 -0
  207. surreal_memory-2.0.0/src/surreal_memory/mcp/db_train_handler.py +157 -0
  208. surreal_memory-2.0.0/src/surreal_memory/mcp/drift_handler.py +134 -0
  209. surreal_memory-2.0.0/src/surreal_memory/mcp/eternal_handler.py +206 -0
  210. surreal_memory-2.0.0/src/surreal_memory/mcp/evolution_handler.py +426 -0
  211. surreal_memory-2.0.0/src/surreal_memory/mcp/expiry_cleanup_handler.py +149 -0
  212. surreal_memory-2.0.0/src/surreal_memory/mcp/http_transport.py +159 -0
  213. surreal_memory-2.0.0/src/surreal_memory/mcp/index_handler.py +208 -0
  214. surreal_memory-2.0.0/src/surreal_memory/mcp/instruction_handler.py +246 -0
  215. surreal_memory-2.0.0/src/surreal_memory/mcp/lifecycle_handler.py +383 -0
  216. surreal_memory-2.0.0/src/surreal_memory/mcp/maintenance_handler.py +609 -0
  217. surreal_memory-2.0.0/src/surreal_memory/mcp/mem0_sync_handler.py +172 -0
  218. surreal_memory-2.0.0/src/surreal_memory/mcp/narrative_handler.py +142 -0
  219. surreal_memory-2.0.0/src/surreal_memory/mcp/onboarding_handler.py +155 -0
  220. surreal_memory-2.0.0/src/surreal_memory/mcp/prompt.py +523 -0
  221. surreal_memory-2.0.0/src/surreal_memory/mcp/provenance_handler.py +363 -0
  222. surreal_memory-2.0.0/src/surreal_memory/mcp/recall_handler.py +911 -0
  223. surreal_memory-2.0.0/src/surreal_memory/mcp/remember_handler.py +806 -0
  224. surreal_memory-2.0.0/src/surreal_memory/mcp/response_compactor.py +280 -0
  225. surreal_memory-2.0.0/src/surreal_memory/mcp/review_handler.py +122 -0
  226. surreal_memory-2.0.0/src/surreal_memory/mcp/scheduled_consolidation_handler.py +141 -0
  227. surreal_memory-2.0.0/src/surreal_memory/mcp/server.py +656 -0
  228. surreal_memory-2.0.0/src/surreal_memory/mcp/session_handler.py +361 -0
  229. surreal_memory-2.0.0/src/surreal_memory/mcp/stats_handler.py +374 -0
  230. surreal_memory-2.0.0/src/surreal_memory/mcp/surface_handler.py +116 -0
  231. surreal_memory-2.0.0/src/surreal_memory/mcp/sync_handler.py +599 -0
  232. surreal_memory-2.0.0/src/surreal_memory/mcp/telegram_handler.py +75 -0
  233. surreal_memory-2.0.0/src/surreal_memory/mcp/tier_handler.py +153 -0
  234. surreal_memory-2.0.0/src/surreal_memory/mcp/tool_handler_utils.py +133 -0
  235. surreal_memory-2.0.0/src/surreal_memory/mcp/tool_handlers.py +66 -0
  236. surreal_memory-2.0.0/src/surreal_memory/mcp/tool_schemas.py +1940 -0
  237. surreal_memory-2.0.0/src/surreal_memory/mcp/train_handler.py +218 -0
  238. surreal_memory-2.0.0/src/surreal_memory/mcp/version_check_handler.py +235 -0
  239. surreal_memory-2.0.0/src/surreal_memory/mcp/visualize_handler.py +133 -0
  240. surreal_memory-2.0.0/src/surreal_memory/mcp/watch_handler.py +225 -0
  241. surreal_memory-2.0.0/src/surreal_memory/plugins/__init__.py +138 -0
  242. surreal_memory-2.0.0/src/surreal_memory/plugins/base.py +69 -0
  243. surreal_memory-2.0.0/src/surreal_memory/plugins/community.py +203 -0
  244. surreal_memory-2.0.0/src/surreal_memory/py.typed +0 -0
  245. surreal_memory-2.0.0/src/surreal_memory/safety/__init__.py +37 -0
  246. surreal_memory-2.0.0/src/surreal_memory/safety/encryption.py +162 -0
  247. surreal_memory-2.0.0/src/surreal_memory/safety/freshness.py +240 -0
  248. surreal_memory-2.0.0/src/surreal_memory/safety/input_firewall.py +305 -0
  249. surreal_memory-2.0.0/src/surreal_memory/safety/sensitive.py +400 -0
  250. surreal_memory-2.0.0/src/surreal_memory/server/__init__.py +5 -0
  251. surreal_memory-2.0.0/src/surreal_memory/server/app.py +682 -0
  252. surreal_memory-2.0.0/src/surreal_memory/server/dependencies.py +116 -0
  253. surreal_memory-2.0.0/src/surreal_memory/server/models.py +348 -0
  254. surreal_memory-2.0.0/src/surreal_memory/server/routes/__init__.py +25 -0
  255. surreal_memory-2.0.0/src/surreal_memory/server/routes/brain.py +328 -0
  256. surreal_memory-2.0.0/src/surreal_memory/server/routes/consolidation.py +115 -0
  257. surreal_memory-2.0.0/src/surreal_memory/server/routes/dashboard_api.py +1573 -0
  258. surreal_memory-2.0.0/src/surreal_memory/server/routes/hub.py +387 -0
  259. surreal_memory-2.0.0/src/surreal_memory/server/routes/integration_status.py +177 -0
  260. surreal_memory-2.0.0/src/surreal_memory/server/routes/memory.py +896 -0
  261. surreal_memory-2.0.0/src/surreal_memory/server/routes/oauth.py +240 -0
  262. surreal_memory-2.0.0/src/surreal_memory/server/routes/openclaw_api.py +208 -0
  263. surreal_memory-2.0.0/src/surreal_memory/server/routes/sync.py +415 -0
  264. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/DiagramsPage-BZV40eAE.css +1 -0
  265. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/DiagramsPage-DxGbFDqh.js +7 -0
  266. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/EvolutionPage-BCt3Gjlg.js +1 -0
  267. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/GraphPage-Bn2XnYSM.js +312 -0
  268. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/HealthPage-BOvDCRq_.js +1 -0
  269. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/OraclePage-Cx309IS8.js +1 -0
  270. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/OverviewPage-C9zanzbn.js +1 -0
  271. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/ProGate-CWdLKxhy.js +1 -0
  272. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/SettingsPage-Co7mL5ao.js +1 -0
  273. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/StoragePage-ChOPs2Io.js +1 -0
  274. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/SyncPage-XHo3B9mj.js +1 -0
  275. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/TimelinePage-D7a4yM0C.js +1 -0
  276. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/ToolStatsPage-DSbdcAxV.js +1 -0
  277. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/VisualizePage-CQRwt661.js +2 -0
  278. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/card-DMi3iNIj.js +1 -0
  279. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/embed-gLOWnRXV.js +193 -0
  280. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/index-C4hAA6lf.css +1 -0
  281. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/index-eqEVe4jF.js +54 -0
  282. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/skeleton-CMgwRZUe.js +1 -0
  283. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/timer-DWAvo6M8.js +1 -0
  284. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/vendor-icons-ILWTDAJI.js +1 -0
  285. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/vendor-motion-Ct_HHbYW.js +1 -0
  286. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/vendor-query-CqA1cBNl.js +1 -0
  287. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/vendor-react-BfuodpLv.js +3 -0
  288. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/vendor-recharts-BkwZfCWA.js +33 -0
  289. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/assets/vendor-ui-Qm4_4bAc.js +1 -0
  290. surreal_memory-2.0.0/src/surreal_memory/server/static/dist/index.html +19 -0
  291. surreal_memory-2.0.0/src/surreal_memory/skills/__init__.py +10 -0
  292. surreal_memory-2.0.0/src/surreal_memory/skills/memory-audit/SKILL.md +226 -0
  293. surreal_memory-2.0.0/src/surreal_memory/skills/memory-evolution/SKILL.md +317 -0
  294. surreal_memory-2.0.0/src/surreal_memory/skills/memory-intake/SKILL.md +179 -0
  295. surreal_memory-2.0.0/src/surreal_memory/storage/__init__.py +18 -0
  296. surreal_memory-2.0.0/src/surreal_memory/storage/base.py +1814 -0
  297. surreal_memory-2.0.0/src/surreal_memory/storage/factory.py +391 -0
  298. surreal_memory-2.0.0/src/surreal_memory/storage/memory_brain_ops.py +291 -0
  299. surreal_memory-2.0.0/src/surreal_memory/storage/memory_collections.py +339 -0
  300. surreal_memory-2.0.0/src/surreal_memory/storage/memory_reviews.py +69 -0
  301. surreal_memory-2.0.0/src/surreal_memory/storage/memory_store.py +764 -0
  302. surreal_memory-2.0.0/src/surreal_memory/storage/neuron_cache.py +97 -0
  303. surreal_memory-2.0.0/src/surreal_memory/storage/read_pool.py +87 -0
  304. surreal_memory-2.0.0/src/surreal_memory/storage/shared_store.py +468 -0
  305. surreal_memory-2.0.0/src/surreal_memory/storage/shared_store_collections.py +210 -0
  306. surreal_memory-2.0.0/src/surreal_memory/storage/shared_store_mappers.py +139 -0
  307. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_action_log.py +153 -0
  308. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_alerts.py +203 -0
  309. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_brain_ops.py +522 -0
  310. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_calibration.py +356 -0
  311. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_change_log.py +287 -0
  312. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_coactivation.py +112 -0
  313. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_cognitive.py +477 -0
  314. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_compression.py +187 -0
  315. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_depth_priors.py +136 -0
  316. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_devices.py +138 -0
  317. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_drift.py +219 -0
  318. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_entity_refs.py +103 -0
  319. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_fibers.py +527 -0
  320. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_maturation.py +147 -0
  321. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_merkle.py +301 -0
  322. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_neurons.py +752 -0
  323. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_projects.py +148 -0
  324. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_reviews.py +162 -0
  325. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_row_mappers.py +287 -0
  326. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_schema.py +1289 -0
  327. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_sessions.py +141 -0
  328. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_sources.py +246 -0
  329. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_store.py +370 -0
  330. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_synapses.py +484 -0
  331. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_sync_state.py +117 -0
  332. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_tool_events.py +264 -0
  333. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_training_files.py +183 -0
  334. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_typed.py +380 -0
  335. surreal_memory-2.0.0/src/surreal_memory/storage/sqlite_versioning.py +153 -0
  336. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/__init__.py +22 -0
  337. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/activity.py +219 -0
  338. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/alerts.py +248 -0
  339. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/cognitive.py +512 -0
  340. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/compression.py +233 -0
  341. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/depth_priors.py +157 -0
  342. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/keyword_entity.py +202 -0
  343. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/review_schedules.py +175 -0
  344. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/schema.py +376 -0
  345. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/sources.py +234 -0
  346. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/store.py +1741 -0
  347. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/typed_memory.py +464 -0
  348. surreal_memory-2.0.0/src/surreal_memory/storage/surrealdb/versions.py +199 -0
  349. surreal_memory-2.0.0/src/surreal_memory/surface/__init__.py +57 -0
  350. surreal_memory-2.0.0/src/surreal_memory/surface/generator.py +609 -0
  351. surreal_memory-2.0.0/src/surreal_memory/surface/lifecycle.py +112 -0
  352. surreal_memory-2.0.0/src/surreal_memory/surface/models.py +146 -0
  353. surreal_memory-2.0.0/src/surreal_memory/surface/parser.py +401 -0
  354. surreal_memory-2.0.0/src/surreal_memory/surface/resolver.py +154 -0
  355. surreal_memory-2.0.0/src/surreal_memory/surface/serializer.py +180 -0
  356. surreal_memory-2.0.0/src/surreal_memory/surface/token_budget.py +114 -0
  357. surreal_memory-2.0.0/src/surreal_memory/sync/__init__.py +48 -0
  358. surreal_memory-2.0.0/src/surreal_memory/sync/client.py +461 -0
  359. surreal_memory-2.0.0/src/surreal_memory/sync/device.py +85 -0
  360. surreal_memory-2.0.0/src/surreal_memory/sync/incremental_merge.py +203 -0
  361. surreal_memory-2.0.0/src/surreal_memory/sync/merkle.py +217 -0
  362. surreal_memory-2.0.0/src/surreal_memory/sync/protocol.py +115 -0
  363. surreal_memory-2.0.0/src/surreal_memory/sync/sync_engine.py +719 -0
  364. surreal_memory-2.0.0/src/surreal_memory/unified_config.py +1878 -0
  365. surreal_memory-2.0.0/src/surreal_memory/utils/__init__.py +6 -0
  366. surreal_memory-2.0.0/src/surreal_memory/utils/config.py +115 -0
  367. surreal_memory-2.0.0/src/surreal_memory/utils/consolidation_lock.py +140 -0
  368. surreal_memory-2.0.0/src/surreal_memory/utils/simhash.py +109 -0
  369. surreal_memory-2.0.0/src/surreal_memory/utils/ssl_helper.py +49 -0
  370. surreal_memory-2.0.0/src/surreal_memory/utils/tag_normalizer.py +164 -0
  371. surreal_memory-2.0.0/src/surreal_memory/utils/timeutils.py +33 -0
@@ -0,0 +1,241 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ share/python-wheels/
24
+ *.egg-info/
25
+ .installed.cfg
26
+ *.egg
27
+ MANIFEST
28
+
29
+ # PyInstaller
30
+ *.manifest
31
+ *.spec
32
+
33
+ # Installer logs
34
+ pip-log.txt
35
+ pip-delete-this-directory.txt
36
+
37
+ # Unit test / coverage reports
38
+ htmlcov/
39
+ .tox/
40
+ .nox/
41
+ .coverage
42
+ .coverage.*
43
+ .cache
44
+ nosetests.xml
45
+ coverage.xml
46
+ *.cover
47
+ *.py,cover
48
+ .hypothesis/
49
+ .pytest_cache/
50
+
51
+ # Translations
52
+ *.mo
53
+ *.pot
54
+
55
+ # Django stuff:
56
+ *.log
57
+ local_settings.py
58
+ db.sqlite3
59
+ db.sqlite3-journal
60
+
61
+ # Flask stuff:
62
+ instance/
63
+ .webassets-cache
64
+
65
+ # Scrapy stuff:
66
+ .scrapy
67
+
68
+ # Sphinx documentation
69
+ docs/_build/
70
+
71
+ # PyBuilder
72
+ .pybuilder/
73
+ target/
74
+
75
+ # Jupyter Notebook
76
+ .ipynb_checkpoints
77
+
78
+ # IPython
79
+ profile_default/
80
+ ipython_config.py
81
+
82
+ # pyenv
83
+ .python-version
84
+
85
+ # pipenv
86
+ Pipfile.lock
87
+
88
+ # poetry
89
+ poetry.lock
90
+
91
+ # pdm
92
+ .pdm.toml
93
+ .pdm-python
94
+ .pdm-build/
95
+
96
+ # PEP 582
97
+ __pypackages__/
98
+
99
+ # Celery stuff
100
+ celerybeat-schedule
101
+ celerybeat.pid
102
+
103
+ # SageMath parsed files
104
+ *.sage.py
105
+
106
+ # Environments
107
+ .env
108
+ .venv
109
+ env/
110
+ venv/
111
+ ENV/
112
+ env.bak/
113
+ venv.bak/
114
+
115
+ # Spyder project settings
116
+ .spyderproject
117
+ .spyproject
118
+
119
+ # Rope project settings
120
+ .ropeproject
121
+
122
+ # mkdocs documentation
123
+ /site
124
+
125
+ # mypy
126
+ .mypy_cache/
127
+ .dmypy.json
128
+ dmypy.json
129
+
130
+ # Pyre type checker
131
+ .pyre/
132
+
133
+ # pytype static type analyzer
134
+ .pytype/
135
+
136
+ # Cython debug symbols
137
+ cython_debug/
138
+
139
+ # IDE
140
+ .idea/
141
+ .vscode/
142
+ *.swp
143
+ *.swo
144
+ *~
145
+
146
+ # OS
147
+ .DS_Store
148
+ Thumbs.db
149
+ nul
150
+
151
+ # VS Code extension packages
152
+ *.vsix
153
+
154
+ # Project specific
155
+ *.db
156
+ *.sqlite
157
+ data/
158
+ logs/
159
+ .surreal_memory/
160
+ .claude/
161
+ CLAUDE.md
162
+ .rune/
163
+ chatbot/
164
+ .mcp.json
165
+ /agents/
166
+ /commands/
167
+ /hooks/
168
+ /skills/
169
+ VISION.md
170
+ .github/internal/
171
+
172
+ # Temp/debug artifacts
173
+ .tmp_*
174
+ .tmp.*
175
+ nonexistent_path_*
176
+ MagicMock/
177
+ companion-setup-brain.json
178
+ .venv-*/
179
+
180
+ # Root-level screenshots (use docs/assets/images/ instead)
181
+ /*.png
182
+ /*.jpg
183
+
184
+ # Secrets / runtime config (defence-in-depth)
185
+ config.toml
186
+ *.key
187
+ .env
188
+
189
+ # Dashboard (React SPA)
190
+ dashboard/node_modules/
191
+ dashboard/dist/
192
+ # Bundled dashboard UI for pip install — must be tracked
193
+ !src/surreal_memory/server/static/dist/
194
+ # OpenClaw plugin dist — must be tracked for git installs + npm publish
195
+ !integrations/surrealmemory/dist/
196
+
197
+ # spaCy models
198
+ en_core_web_sm/
199
+ en_core_web_md/
200
+ en_core_web_lg/
201
+ # Gemini CLI settings (contains user-specific config)
202
+ .gemini/
203
+ .gitnexus
204
+
205
+ # Node (root-level tooling — dashboard has its own entry above)
206
+ node_modules/
207
+ package-lock.json
208
+ package.json
209
+
210
+ # Pay-hub (Cloudflare Worker — closed source, separate repo)
211
+ pay-hub/
212
+
213
+ # Playwright MCP
214
+ .playwright-mcp/
215
+
216
+ # Plugin zip artifacts
217
+ surreal-memory-plugin-*.zip
218
+
219
+ # uv lockfile
220
+ uv.lock
221
+
222
+ # Local-only docs/plans
223
+ docs/plans/
224
+
225
+ # Misc local files
226
+ AUDIT-REPORT.md
227
+ lefthook.yml
228
+ integrations/surrealmemory/coverage/
229
+
230
+ # Local surreal-memory brain data (never commit)
231
+ .surrealmemory/
232
+ .neuralmemory/
233
+
234
+ # Serena MCP project cache (never commit)
235
+ .serena/
236
+
237
+ # Task Master AI — local dev planning (never commit)
238
+ .taskmaster/
239
+
240
+ # Local hook event log — may capture secrets from tool output
241
+ tool_events.jsonl
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 NeuralMemory Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,26 @@
1
+ Surreal-Memory
2
+ ==============
3
+
4
+ This project is a fork of NeuralMemory
5
+ (https://github.com/nhadaututtheky/neural-memory) by nhadaututtheky,
6
+ licensed under the MIT License (see LICENSE).
7
+
8
+ The original copyright notice is retained per the terms of the MIT License:
9
+
10
+ Copyright (c) 2024 NeuralMemory Contributors
11
+
12
+ Significant modifications by Toni Nowak / AI-Flow NOWAK, also released
13
+ under the MIT License:
14
+
15
+ - SurrealDB storage backend replacing SQLite as the primary store
16
+ - Community plugin unlocking advanced features without Pro gating
17
+ - PyPI package renamed to `surreal-memory`
18
+ - Python module renamed to `surreal_memory` (planned in v2.0.0)
19
+ - npm package renamed to `surrealmemory` (planned in v2.0.0)
20
+ - VS Code extension renamed to `surrealmemory` / "Surreal-Memory" (planned in v2.0.0)
21
+ - CLI commands renamed `nmem-*` → `smem-*` (planned in v2.0.0)
22
+ - Additional Claude Code hooks (`session_start`)
23
+ - Rebuilt CI/CD pipeline for the new branding
24
+
25
+ If you find Surreal-Memory useful, please also consider starring the
26
+ original NeuralMemory project that made this work possible.