hermes-plugin-qdrant-memory 0.5.0__tar.gz → 0.5.2__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 (161) hide show
  1. {hermes_plugin_qdrant_memory-0.5.0/hermes_plugin_qdrant_memory.egg-info → hermes_plugin_qdrant_memory-0.5.2}/PKG-INFO +95 -18
  2. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/README.md +94 -17
  3. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/docs/local-embedding.md +3 -3
  4. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2/hermes_plugin_qdrant_memory.egg-info}/PKG-INFO +95 -18
  5. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/SOURCES.txt +7 -0
  6. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/pyproject.toml +1 -1
  7. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/cli.py +33 -2
  8. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/config.py +4 -1
  9. hermes_plugin_qdrant_memory-0.5.2/qdrant_memory/event_quarantine.py +91 -0
  10. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/extraction.py +1 -1
  11. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/ledger.py +34 -3
  12. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/owner_lifecycle.py +7 -2
  13. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/owner_llm.py +17 -2
  14. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/plugin.yaml +1 -1
  15. hermes_plugin_qdrant_memory-0.5.2/qdrant_memory/remote_client.py +534 -0
  16. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/remote_gateway.py +25 -4
  17. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/runtime.py +21 -3
  18. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_security.py +26 -1
  19. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_state.py +1 -1
  20. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/standalone.py +9 -1
  21. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/version.py +1 -1
  22. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/requirements-local.txt +71 -71
  23. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/requirements.txt +3 -3
  24. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/scripts/demo.sh +1 -1
  25. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_shared_security.py +95 -0
  26. hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_event_quarantine.py +184 -0
  27. hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_event_quarantine_security.py +250 -0
  28. hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_owner_diagnostics.py +77 -0
  29. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_client.py +4 -1
  30. hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_remote_listener.py +53 -0
  31. hermes_plugin_qdrant_memory-0.5.2/tests/standalone/test_remote_retry_contract.py +650 -0
  32. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_readme_release_contract.py +2 -2
  33. hermes_plugin_qdrant_memory-0.5.2/tests/test_restart_boundary.py +109 -0
  34. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_client.py +0 -180
  35. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/LICENSE +0 -0
  36. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/MANIFEST.in +0 -0
  37. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/dependency_links.txt +0 -0
  38. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/entry_points.txt +0 -0
  39. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/requires.txt +0 -0
  40. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/hermes_plugin_qdrant_memory.egg-info/top_level.txt +0 -0
  41. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/__init__.py +0 -0
  42. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/config_schema.py +0 -0
  43. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/dedupe.py +0 -0
  44. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/embedding.py +0 -0
  45. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/inventory.py +0 -0
  46. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/local_embedding.py +0 -0
  47. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/local_model.py +0 -0
  48. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/managed_setup.py +0 -0
  49. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/mcp_server.py +0 -0
  50. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/migration.py +0 -0
  51. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/models.py +0 -0
  52. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/native_owner.py +0 -0
  53. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/ownership.py +0 -0
  54. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/policy_admin.py +0 -0
  55. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/private_paths.py +0 -0
  56. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/progress.py +0 -0
  57. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/provider.py +0 -0
  58. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/qdrant_store.py +0 -0
  59. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/quality_metrics.py +0 -0
  60. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/remote_protocol.py +0 -0
  61. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/reset.py +0 -0
  62. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/retry.py +0 -0
  63. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_client.py +0 -0
  64. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_protocol.py +0 -0
  65. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_reader.py +0 -0
  66. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_recall.py +0 -0
  67. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/shared_service.py +0 -0
  68. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/qdrant_memory/tools.py +0 -0
  69. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/setup.cfg +0 -0
  70. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/__init__.py +0 -0
  71. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/conftest.py +0 -0
  72. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/helpers.py +0 -0
  73. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/local_model/test_acceptance.py +0 -0
  74. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/remote/fixture.py +0 -0
  75. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/__init__.py +0 -0
  76. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_cloud_owner.py +0 -0
  77. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_cloud_owner_cleanup.py +0 -0
  78. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_device_server.py +0 -0
  79. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/security/test_shared_security_live.py +0 -0
  80. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/__init__.py +0 -0
  81. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_admission_control.py +0 -0
  82. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_device_grants.py +0 -0
  83. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_explicit_writes.py +0 -0
  84. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_managed_setup.py +0 -0
  85. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_context.py +0 -0
  86. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_events.py +0 -0
  87. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_lifecycle.py +0 -0
  88. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_owner_llm.py +0 -0
  89. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_policy_admin.py +0 -0
  90. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_public_api.py +0 -0
  91. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_gateway.py +0 -0
  92. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_listener_options.py +0 -0
  93. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_remote_service.py +0 -0
  94. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_reset_receipts.py +0 -0
  95. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_contracts.py +0 -0
  96. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_evaluation.py +0 -0
  97. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_reader.py +0 -0
  98. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_response.py +0 -0
  99. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_service.py +0 -0
  100. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_shared_visibility.py +0 -0
  101. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/standalone/test_standalone.py +0 -0
  102. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_backend_contracts.py +0 -0
  103. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_bot_scope.py +0 -0
  104. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_bounded_recovery.py +0 -0
  105. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_checkpoint_lifecycle.py +0 -0
  106. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_ci_gate.py +0 -0
  107. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_ci_infrastructure_retry.py +0 -0
  108. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_cli_output.py +0 -0
  109. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_config_embedding.py +0 -0
  110. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_deletion_ordering.py +0 -0
  111. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_dependency_inputs.py +0 -0
  112. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_dependency_security.py +0 -0
  113. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_discovery_cli.py +0 -0
  114. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_explicit_dedupe.py +0 -0
  115. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_fastembed_compat.py +0 -0
  116. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_host_lifecycle.py +0 -0
  117. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_host_pins.py +0 -0
  118. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_input_validation.py +0 -0
  119. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_inventory_export.py +0 -0
  120. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_live_metrics.py +0 -0
  121. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_local_embedding.py +0 -0
  122. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_local_embedding_provider.py +0 -0
  123. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_local_model.py +0 -0
  124. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_maintenance.py +0 -0
  125. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_manifest_contract.py +0 -0
  126. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration.py +0 -0
  127. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_endpoints.py +0 -0
  128. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_progress.py +0 -0
  129. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_resume.py +0 -0
  130. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_migration_superseded.py +0 -0
  131. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_model_smoke.py +0 -0
  132. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_native_owner.py +0 -0
  133. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_native_unadmitted.py +0 -0
  134. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_http.py +0 -0
  135. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_models.py +0 -0
  136. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_preflight.py +0 -0
  137. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_runner.py +0 -0
  138. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_openrouter_workflow.py +0 -0
  139. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_pi_quality_driver.py +0 -0
  140. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_profile_scope.py +0 -0
  141. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_provider.py +0 -0
  142. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_dependencies.py +0 -0
  143. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_metrics.py +0 -0
  144. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_mutations.py +0 -0
  145. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_ollama_setup.py +0 -0
  146. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_profiles.py +0 -0
  147. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_quality_runner.py +0 -0
  148. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_recovery_benchmark.py +0 -0
  149. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_recovery_evaluation.py +0 -0
  150. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_remote_qdrant.py +0 -0
  151. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_remote_shutdown.py +0 -0
  152. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_reset_inspection.py +0 -0
  153. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_reset_recovery.py +0 -0
  154. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_retention.py +0 -0
  155. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_review_regressions.py +0 -0
  156. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_session_provenance.py +0 -0
  157. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_setup_contract.py +0 -0
  158. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_shared_recall.py +0 -0
  159. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_shutdown_contract.py +0 -0
  160. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_store_runtime.py +0 -0
  161. {hermes_plugin_qdrant_memory-0.5.0 → hermes_plugin_qdrant_memory-0.5.2}/tests/test_writer_ownership.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: hermes-plugin-qdrant-memory
3
- Version: 0.5.0
3
+ Version: 0.5.2
4
4
  Summary: Durable Qdrant memory for Hermes, standalone CLI and local MCP
5
5
  License-Expression: MIT
6
6
  Project-URL: Homepage, https://github.com/cnkang/hermes-plugin-qdrant-memory
@@ -27,10 +27,18 @@ Dynamic: license-file
27
27
 
28
28
  # Qdrant Memory for Hermes
29
29
 
30
+ **One Memory. Multiple Agents.**
31
+
32
+ Durable, portable, and permission-aware memory for AI agents.
33
+
34
+ Share persistent memory across AI harnesses, sessions, and devices through one
35
+ Qdrant-backed Runtime. Integrate using native providers, MCP, CLI, or Agent
36
+ Skills—with explicit access control, conflict-safe updates, and crash recovery.
37
+
30
38
  Shared deployment hardening in this checkout is documented in the
31
39
  [protected destination guide](docs/shared-memory/deployment-security.md) and
32
40
  [versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
33
- are included in Runtime 0.5.0. Remote access needs the `[remote]` extra.
41
+ are included in Runtime 0.5.2. Remote access needs the `[remote]` extra.
34
42
 
35
43
  ## One Memory, Multiple Agents — opt-in shared owner
36
44
 
@@ -43,17 +51,19 @@ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge.
43
51
  [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
44
52
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
45
53
 
46
- > **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
54
+ > **Runtime 0.5.2** keeps the opt-in authenticated local shared owner and the stdio
47
55
  > bridge for explicit shared memory. It keeps the optional offline CPU embedding,
48
56
  > trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
49
57
  > Explicit writes retain canonical-text deduplication without an LLM.
50
- > This guide selects Runtime 0.5.0. Check its availability on
51
- > [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) before installation.
58
+ > This patch makes a restart-interrupted write replayable with the same request
59
+ > identifier. It changes no schema and no collection identity.
60
+ > This guide selects Runtime 0.5.2. Check its availability on
61
+ > [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) before installation.
52
62
  > The generic MCP distribution and managed launcher select their own exact Runtime
53
63
  > dependency and are released independently.
54
64
  > The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
55
65
  > does not upgrade it. One writer per destination remains required.
56
- > See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
66
+ > See [release notes](docs/releases/0.5.2.md) and [validation](docs/validation.md).
57
67
 
58
68
  [English](README.md) | [简体中文](README.zh-CN.md)
59
69
 
@@ -71,7 +81,7 @@ as a community-maintained plugin.
71
81
  ## How it works
72
82
 
73
83
  For non-Hermes users, install in a private Python 3.11+
74
- environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
84
+ environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.2'` (omit `[mcp]`
75
85
  for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
76
86
  Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
77
87
  MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
@@ -82,14 +92,27 @@ an authorized upgrade, verify the same profile, collection and embedding pipelin
82
92
 
83
93
  ```mermaid
84
94
  flowchart LR
85
- turn["Hermes turn"] --> admit["Provider callback"]
86
- admit --> ledger[("SQLite ledger<br/>durable admission")]
87
- ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
88
- extract --> store[("Qdrant<br/>dense vectors + payloads")]
89
- ask["Recall / search"] --> search["Scoped dense search"]
90
- search --> store
95
+ subgraph Private["Private standalone path"]
96
+ turn["Hermes turn"] --> admit["Provider callback"]
97
+ admit --> ledger[("SQLite ledger<br/>durable admission")]
98
+ ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
99
+ extract --> store[("Qdrant<br/>dense vectors + payloads")]
100
+ ask["Recall / search"] --> search["Scoped dense search"]
101
+ search --> store
102
+ end
103
+ subgraph Shared["Shared owner path (opt-in)"]
104
+ agent["Agent A / B"] --> owner["Shared Owner<br/>auth + scope"]
105
+ owner --> lease["WriterLease<br/>(current profile only)"]
106
+ lease --> store2[("Qdrant<br/>shared space")]
107
+ owner --> ledger2[("SQLite ledger")]
108
+ end
109
+ store -.migration/portability.-> store2
91
110
  ```
92
111
 
112
+ `WriterLease` coordinates only the current profile's writes. It does not prevent
113
+ other profiles or devices from writing to the same destination. "One writer per
114
+ destination" is an operational constraint, not an automatic cross-device lock.
115
+
93
116
  ## Why this plugin
94
117
 
95
118
  - Durable, private memory for Hermes Agent: conversations become searchable
@@ -136,6 +159,19 @@ cleans up the demo scope. All steps
136
159
  run in embedded mode. `scripts/demo.sh` reproduces the same walkthrough with
137
160
  the pinned release.
138
161
 
162
+ ## Choose your setup
163
+
164
+ | Use case | Recommended entry | Notes |
165
+ |---|---|---|
166
+ | Hermes native automatic memory | Native MemoryProvider | Automatic extraction and recall inside Hermes |
167
+ | Single agent, standalone MCP | Standalone MCP (`qdrant-memory-mcp`) | Explicit tools only, no auto-extraction |
168
+ | Multiple agents sharing memory | Authenticated Shared Owner | Opt-in. One writer per destination |
169
+ | Remote / multi-device access | HTTPS MCP + Owner | TLS, auth and network protection required |
170
+ | WorkBuddy / DSH | Host integration guides | Reuse the same Runtime |
171
+ | Migrate Mem0 data | Migration CLI | Source IDs, resumable manifest, verification |
172
+
173
+ See [standalone setup](docs/standalone.md), [shared memory](docs/shared-memory/README.md), and [cross-harness architecture](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md).
174
+
139
175
  ## Install
140
176
 
141
177
  Requirements: Python 3.11+, a compatible Hermes installation, and a reachable
@@ -149,7 +185,7 @@ Choose the **active profile's** home explicitly. Do not reuse another profile's
149
185
  **Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
150
186
 
151
187
  The Catalog selects its own fixed revision, which may be older than Runtime
152
- 0.5.0. To use the current release, including opt-in shared memory, follow the
188
+ 0.5.2. To use the current release, including opt-in shared memory, follow the
153
189
  recommended version-locked installation below.
154
190
 
155
191
  ```bash
@@ -167,7 +203,7 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
167
203
  tools, requirements and known issues before it clones anything.
168
204
  `hermes plugins enable` prepares the declared dependencies through Hermes PM.
169
205
 
170
- **Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
206
+ **Recommended: install the version-locked Runtime 0.5.2 source through the Hermes CLI.**
171
207
 
172
208
  This immutable source revision includes opt-in shared memory. It does not depend
173
209
  on a PyPI release or a catalog update.
@@ -177,7 +213,7 @@ export HERMES_HOME="/absolute/path/to/your/hermes-profile"
177
213
  ollama pull qwen3-embedding:4b
178
214
  # Start Ollama if it is not running. Keep its service available.
179
215
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
180
- --ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
216
+ --ref 604793341226e45f04500cd1d53fd668ddf89d63 # Runtime 0.5.2 release
181
217
  hermes plugins enable qdrant-memory
182
218
  hermes memory setup
183
219
  hermes config set memory.provider qdrant-memory
@@ -188,7 +224,7 @@ hermes qdrant-memory init
188
224
 
189
225
  This older immutable source revision includes optional CPU embedding and guided
190
226
  setup, but it predates opt-in shared memory. For the current release use
191
- Runtime 0.5.0 above. It does not depend on a PyPI release or a catalog update.
227
+ Runtime 0.5.2 above. It does not depend on a PyPI release or a catalog update.
192
228
 
193
229
  ```bash
194
230
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -212,7 +248,7 @@ environment. Omit `--ref` to track `main`, the development line.
212
248
  **Historical release: clone a published tag manually.**
213
249
 
214
250
  The v0.1.0 tag below predates the standalone interfaces and the explicit-write
215
- fix. Use the pinned source above for Runtime 0.5.0.
251
+ fix. Use the pinned source above for Runtime 0.5.2.
216
252
 
217
253
  ```bash
218
254
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -492,6 +528,20 @@ and non-primary-agent turns. Treat recalled content as untrusted data. See
492
528
  [security](docs/security.md), [operating procedures](docs/operations.md),
493
529
  [troubleshooting](docs/troubleshooting.md) and [architecture](docs/architecture.md).
494
530
 
531
+ ## Capabilities and limitations
532
+
533
+ | Area | Status | Notes |
534
+ |---|---|---|
535
+ | Private memory (standalone) | Supported | Embedded / server / Cloud Qdrant |
536
+ | Automatic extraction (Hermes) | Supported | Trusted `ctx.llm` facade |
537
+ | Automatic recall (Hermes) | Supported | Scoped dense search |
538
+ | Shared memory (Shared Owner) | Opt-in | One writer per destination (operational constraint, not cross-device lock). Not the default |
539
+ | Automatic shared extraction | Opt-in | Native Owner and opt-in Pi lifecycle adapter |
540
+ | MCP auto-extraction | Not supported | Explicit tools only |
541
+ | Hybrid search / reranking | Not supported | Dense retrieval only (v0.1) |
542
+ | Multi-writer Server/Cloud | Not supported | One authoritative writer |
543
+ | Web UI | Not supported | CLI and tools only |
544
+
495
545
  ## Compatibility and scope
496
546
 
497
547
  Version 0.1 implements dense retrieval. Hybrid sparse vectors, RRF/DBSF, reranking
@@ -556,6 +606,33 @@ for a separate synthetic replay and retained-storage measurement.
556
606
  CI runs tests, SonarCloud quality gates and Snyk dependency/code scans.
557
607
  See [CI service setup](docs/ci.md) and [validation evidence](docs/validation.md).
558
608
 
609
+ ## Documentation
610
+
611
+ - [Getting started / standalone](docs/standalone.md)
612
+ - [Architecture](docs/architecture.md)
613
+ - [Configuration](docs/configuration.md)
614
+ - [Cross-harness sharing (MCP repo)](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md)
615
+ - [Shared memory](docs/shared-memory/README.md)
616
+ - [Security](docs/security.md)
617
+ - [Operations](docs/operations.md)
618
+ - [Migration from Mem0](docs/migration-from-mem0.md)
619
+ - [Backup and portability](docs/portability.md)
620
+ - [Validation and evidence](docs/validation.md)
621
+ - [Development](docs/development.md)
622
+ - [CI](docs/ci.md)
623
+
624
+ ## Validation and evidence
625
+
626
+ Real evidence, not badges:
627
+
628
+ - Hermes native lifecycle tests: [validation](docs/validation.md)
629
+ - Cross-harness sharing: [OpenCode / Pi dual-device acceptance](docs/validation/cross-device-opencode-pi-2026-10.md); WorkBuddy / DSH: not fully host-validated ([report](docs/shared-memory/report.md))
630
+ - Crash / restart / idempotency: [bounded recovery](docs/recovery-benchmark.md)
631
+ - Authorization and isolation: [security](docs/security.md), [threat model](docs/shared-memory/threat-model-v1.md)
632
+ - Model quality: frozen evaluation datasets (see `scripts/evaluate.py`)
633
+
634
+ Long-running 24-hour acceptance: pending / not yet verified.
635
+
559
636
  ## License
560
637
 
561
638
  MIT. Copyright © 2026 Kang Liu. See [LICENSE](LICENSE).
@@ -1,9 +1,17 @@
1
1
  # Qdrant Memory for Hermes
2
2
 
3
+ **One Memory. Multiple Agents.**
4
+
5
+ Durable, portable, and permission-aware memory for AI agents.
6
+
7
+ Share persistent memory across AI harnesses, sessions, and devices through one
8
+ Qdrant-backed Runtime. Integrate using native providers, MCP, CLI, or Agent
9
+ Skills—with explicit access control, conflict-safe updates, and crash recovery.
10
+
3
11
  Shared deployment hardening in this checkout is documented in the
4
12
  [protected destination guide](docs/shared-memory/deployment-security.md) and
5
13
  [versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
6
- are included in Runtime 0.5.0. Remote access needs the `[remote]` extra.
14
+ are included in Runtime 0.5.2. Remote access needs the `[remote]` extra.
7
15
 
8
16
  ## One Memory, Multiple Agents — opt-in shared owner
9
17
 
@@ -16,17 +24,19 @@ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge.
16
24
  [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
17
25
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
18
26
 
19
- > **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
27
+ > **Runtime 0.5.2** keeps the opt-in authenticated local shared owner and the stdio
20
28
  > bridge for explicit shared memory. It keeps the optional offline CPU embedding,
21
29
  > trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
22
30
  > Explicit writes retain canonical-text deduplication without an LLM.
23
- > This guide selects Runtime 0.5.0. Check its availability on
24
- > [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) before installation.
31
+ > This patch makes a restart-interrupted write replayable with the same request
32
+ > identifier. It changes no schema and no collection identity.
33
+ > This guide selects Runtime 0.5.2. Check its availability on
34
+ > [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) before installation.
25
35
  > The generic MCP distribution and managed launcher select their own exact Runtime
26
36
  > dependency and are released independently.
27
37
  > The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
28
38
  > does not upgrade it. One writer per destination remains required.
29
- > See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
39
+ > See [release notes](docs/releases/0.5.2.md) and [validation](docs/validation.md).
30
40
 
31
41
  [English](README.md) | [简体中文](README.zh-CN.md)
32
42
 
@@ -44,7 +54,7 @@ as a community-maintained plugin.
44
54
  ## How it works
45
55
 
46
56
  For non-Hermes users, install in a private Python 3.11+
47
- environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
57
+ environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.2'` (omit `[mcp]`
48
58
  for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
49
59
  Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
50
60
  MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
@@ -55,14 +65,27 @@ an authorized upgrade, verify the same profile, collection and embedding pipelin
55
65
 
56
66
  ```mermaid
57
67
  flowchart LR
58
- turn["Hermes turn"] --> admit["Provider callback"]
59
- admit --> ledger[("SQLite ledger<br/>durable admission")]
60
- ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
61
- extract --> store[("Qdrant<br/>dense vectors + payloads")]
62
- ask["Recall / search"] --> search["Scoped dense search"]
63
- search --> store
68
+ subgraph Private["Private standalone path"]
69
+ turn["Hermes turn"] --> admit["Provider callback"]
70
+ admit --> ledger[("SQLite ledger<br/>durable admission")]
71
+ ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
72
+ extract --> store[("Qdrant<br/>dense vectors + payloads")]
73
+ ask["Recall / search"] --> search["Scoped dense search"]
74
+ search --> store
75
+ end
76
+ subgraph Shared["Shared owner path (opt-in)"]
77
+ agent["Agent A / B"] --> owner["Shared Owner<br/>auth + scope"]
78
+ owner --> lease["WriterLease<br/>(current profile only)"]
79
+ lease --> store2[("Qdrant<br/>shared space")]
80
+ owner --> ledger2[("SQLite ledger")]
81
+ end
82
+ store -.migration/portability.-> store2
64
83
  ```
65
84
 
85
+ `WriterLease` coordinates only the current profile's writes. It does not prevent
86
+ other profiles or devices from writing to the same destination. "One writer per
87
+ destination" is an operational constraint, not an automatic cross-device lock.
88
+
66
89
  ## Why this plugin
67
90
 
68
91
  - Durable, private memory for Hermes Agent: conversations become searchable
@@ -109,6 +132,19 @@ cleans up the demo scope. All steps
109
132
  run in embedded mode. `scripts/demo.sh` reproduces the same walkthrough with
110
133
  the pinned release.
111
134
 
135
+ ## Choose your setup
136
+
137
+ | Use case | Recommended entry | Notes |
138
+ |---|---|---|
139
+ | Hermes native automatic memory | Native MemoryProvider | Automatic extraction and recall inside Hermes |
140
+ | Single agent, standalone MCP | Standalone MCP (`qdrant-memory-mcp`) | Explicit tools only, no auto-extraction |
141
+ | Multiple agents sharing memory | Authenticated Shared Owner | Opt-in. One writer per destination |
142
+ | Remote / multi-device access | HTTPS MCP + Owner | TLS, auth and network protection required |
143
+ | WorkBuddy / DSH | Host integration guides | Reuse the same Runtime |
144
+ | Migrate Mem0 data | Migration CLI | Source IDs, resumable manifest, verification |
145
+
146
+ See [standalone setup](docs/standalone.md), [shared memory](docs/shared-memory/README.md), and [cross-harness architecture](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md).
147
+
112
148
  ## Install
113
149
 
114
150
  Requirements: Python 3.11+, a compatible Hermes installation, and a reachable
@@ -122,7 +158,7 @@ Choose the **active profile's** home explicitly. Do not reuse another profile's
122
158
  **Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
123
159
 
124
160
  The Catalog selects its own fixed revision, which may be older than Runtime
125
- 0.5.0. To use the current release, including opt-in shared memory, follow the
161
+ 0.5.2. To use the current release, including opt-in shared memory, follow the
126
162
  recommended version-locked installation below.
127
163
 
128
164
  ```bash
@@ -140,7 +176,7 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
140
176
  tools, requirements and known issues before it clones anything.
141
177
  `hermes plugins enable` prepares the declared dependencies through Hermes PM.
142
178
 
143
- **Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
179
+ **Recommended: install the version-locked Runtime 0.5.2 source through the Hermes CLI.**
144
180
 
145
181
  This immutable source revision includes opt-in shared memory. It does not depend
146
182
  on a PyPI release or a catalog update.
@@ -150,7 +186,7 @@ export HERMES_HOME="/absolute/path/to/your/hermes-profile"
150
186
  ollama pull qwen3-embedding:4b
151
187
  # Start Ollama if it is not running. Keep its service available.
152
188
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
153
- --ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
189
+ --ref 604793341226e45f04500cd1d53fd668ddf89d63 # Runtime 0.5.2 release
154
190
  hermes plugins enable qdrant-memory
155
191
  hermes memory setup
156
192
  hermes config set memory.provider qdrant-memory
@@ -161,7 +197,7 @@ hermes qdrant-memory init
161
197
 
162
198
  This older immutable source revision includes optional CPU embedding and guided
163
199
  setup, but it predates opt-in shared memory. For the current release use
164
- Runtime 0.5.0 above. It does not depend on a PyPI release or a catalog update.
200
+ Runtime 0.5.2 above. It does not depend on a PyPI release or a catalog update.
165
201
 
166
202
  ```bash
167
203
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -185,7 +221,7 @@ environment. Omit `--ref` to track `main`, the development line.
185
221
  **Historical release: clone a published tag manually.**
186
222
 
187
223
  The v0.1.0 tag below predates the standalone interfaces and the explicit-write
188
- fix. Use the pinned source above for Runtime 0.5.0.
224
+ fix. Use the pinned source above for Runtime 0.5.2.
189
225
 
190
226
  ```bash
191
227
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -465,6 +501,20 @@ and non-primary-agent turns. Treat recalled content as untrusted data. See
465
501
  [security](docs/security.md), [operating procedures](docs/operations.md),
466
502
  [troubleshooting](docs/troubleshooting.md) and [architecture](docs/architecture.md).
467
503
 
504
+ ## Capabilities and limitations
505
+
506
+ | Area | Status | Notes |
507
+ |---|---|---|
508
+ | Private memory (standalone) | Supported | Embedded / server / Cloud Qdrant |
509
+ | Automatic extraction (Hermes) | Supported | Trusted `ctx.llm` facade |
510
+ | Automatic recall (Hermes) | Supported | Scoped dense search |
511
+ | Shared memory (Shared Owner) | Opt-in | One writer per destination (operational constraint, not cross-device lock). Not the default |
512
+ | Automatic shared extraction | Opt-in | Native Owner and opt-in Pi lifecycle adapter |
513
+ | MCP auto-extraction | Not supported | Explicit tools only |
514
+ | Hybrid search / reranking | Not supported | Dense retrieval only (v0.1) |
515
+ | Multi-writer Server/Cloud | Not supported | One authoritative writer |
516
+ | Web UI | Not supported | CLI and tools only |
517
+
468
518
  ## Compatibility and scope
469
519
 
470
520
  Version 0.1 implements dense retrieval. Hybrid sparse vectors, RRF/DBSF, reranking
@@ -529,6 +579,33 @@ for a separate synthetic replay and retained-storage measurement.
529
579
  CI runs tests, SonarCloud quality gates and Snyk dependency/code scans.
530
580
  See [CI service setup](docs/ci.md) and [validation evidence](docs/validation.md).
531
581
 
582
+ ## Documentation
583
+
584
+ - [Getting started / standalone](docs/standalone.md)
585
+ - [Architecture](docs/architecture.md)
586
+ - [Configuration](docs/configuration.md)
587
+ - [Cross-harness sharing (MCP repo)](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md)
588
+ - [Shared memory](docs/shared-memory/README.md)
589
+ - [Security](docs/security.md)
590
+ - [Operations](docs/operations.md)
591
+ - [Migration from Mem0](docs/migration-from-mem0.md)
592
+ - [Backup and portability](docs/portability.md)
593
+ - [Validation and evidence](docs/validation.md)
594
+ - [Development](docs/development.md)
595
+ - [CI](docs/ci.md)
596
+
597
+ ## Validation and evidence
598
+
599
+ Real evidence, not badges:
600
+
601
+ - Hermes native lifecycle tests: [validation](docs/validation.md)
602
+ - Cross-harness sharing: [OpenCode / Pi dual-device acceptance](docs/validation/cross-device-opencode-pi-2026-10.md); WorkBuddy / DSH: not fully host-validated ([report](docs/shared-memory/report.md))
603
+ - Crash / restart / idempotency: [bounded recovery](docs/recovery-benchmark.md)
604
+ - Authorization and isolation: [security](docs/security.md), [threat model](docs/shared-memory/threat-model-v1.md)
605
+ - Model quality: frozen evaluation datasets (see `scripts/evaluate.py`)
606
+
607
+ Long-running 24-hour acceptance: pending / not yet verified.
608
+
532
609
  ## License
533
610
 
534
611
  MIT. Copyright © 2026 Kang Liu. See [LICENSE](LICENSE).
@@ -35,11 +35,11 @@ python -m pip install '.[mcp,local]'
35
35
 
36
36
  For a published package, install the same extras with the release version:
37
37
 
38
- Check [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) for
39
- Runtime 0.5.0 availability before running this command.
38
+ Check [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) for
39
+ Runtime 0.5.2 availability before running this command.
40
40
 
41
41
  ```sh
42
- python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.5.0'
42
+ python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.5.2'
43
43
  ```
44
44
 
45
45
  Choose **one** setup command and replace the profile path with a new absolute
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: hermes-plugin-qdrant-memory
3
- Version: 0.5.0
3
+ Version: 0.5.2
4
4
  Summary: Durable Qdrant memory for Hermes, standalone CLI and local MCP
5
5
  License-Expression: MIT
6
6
  Project-URL: Homepage, https://github.com/cnkang/hermes-plugin-qdrant-memory
@@ -27,10 +27,18 @@ Dynamic: license-file
27
27
 
28
28
  # Qdrant Memory for Hermes
29
29
 
30
+ **One Memory. Multiple Agents.**
31
+
32
+ Durable, portable, and permission-aware memory for AI agents.
33
+
34
+ Share persistent memory across AI harnesses, sessions, and devices through one
35
+ Qdrant-backed Runtime. Integrate using native providers, MCP, CLI, or Agent
36
+ Skills—with explicit access control, conflict-safe updates, and crash recovery.
37
+
30
38
  Shared deployment hardening in this checkout is documented in the
31
39
  [protected destination guide](docs/shared-memory/deployment-security.md) and
32
40
  [versioned threat model](docs/shared-memory/threat-model-v1.md). These additions
33
- are included in Runtime 0.5.0. Remote access needs the `[remote]` extra.
41
+ are included in Runtime 0.5.2. Remote access needs the `[remote]` extra.
34
42
 
35
43
  ## One Memory, Multiple Agents — opt-in shared owner
36
44
 
@@ -43,17 +51,19 @@ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge.
43
51
  [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
44
52
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
45
53
 
46
- > **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
54
+ > **Runtime 0.5.2** keeps the opt-in authenticated local shared owner and the stdio
47
55
  > bridge for explicit shared memory. It keeps the optional offline CPU embedding,
48
56
  > trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
49
57
  > Explicit writes retain canonical-text deduplication without an LLM.
50
- > This guide selects Runtime 0.5.0. Check its availability on
51
- > [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.0/) before installation.
58
+ > This patch makes a restart-interrupted write replayable with the same request
59
+ > identifier. It changes no schema and no collection identity.
60
+ > This guide selects Runtime 0.5.2. Check its availability on
61
+ > [PyPI](https://pypi.org/project/hermes-plugin-qdrant-memory/0.5.2/) before installation.
52
62
  > The generic MCP distribution and managed launcher select their own exact Runtime
53
63
  > dependency and are released independently.
54
64
  > The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
55
65
  > does not upgrade it. One writer per destination remains required.
56
- > See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
66
+ > See [release notes](docs/releases/0.5.2.md) and [validation](docs/validation.md).
57
67
 
58
68
  [English](README.md) | [简体中文](README.zh-CN.md)
59
69
 
@@ -71,7 +81,7 @@ as a community-maintained plugin.
71
81
  ## How it works
72
82
 
73
83
  For non-Hermes users, install in a private Python 3.11+
74
- environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
84
+ environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.2'` (omit `[mcp]`
75
85
  for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
76
86
  Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
77
87
  MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
@@ -82,14 +92,27 @@ an authorized upgrade, verify the same profile, collection and embedding pipelin
82
92
 
83
93
  ```mermaid
84
94
  flowchart LR
85
- turn["Hermes turn"] --> admit["Provider callback"]
86
- admit --> ledger[("SQLite ledger<br/>durable admission")]
87
- ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
88
- extract --> store[("Qdrant<br/>dense vectors + payloads")]
89
- ask["Recall / search"] --> search["Scoped dense search"]
90
- search --> store
95
+ subgraph Private["Private standalone path"]
96
+ turn["Hermes turn"] --> admit["Provider callback"]
97
+ admit --> ledger[("SQLite ledger<br/>durable admission")]
98
+ ledger -.async.-> extract["LLM extraction +<br/>relation checks"]
99
+ extract --> store[("Qdrant<br/>dense vectors + payloads")]
100
+ ask["Recall / search"] --> search["Scoped dense search"]
101
+ search --> store
102
+ end
103
+ subgraph Shared["Shared owner path (opt-in)"]
104
+ agent["Agent A / B"] --> owner["Shared Owner<br/>auth + scope"]
105
+ owner --> lease["WriterLease<br/>(current profile only)"]
106
+ lease --> store2[("Qdrant<br/>shared space")]
107
+ owner --> ledger2[("SQLite ledger")]
108
+ end
109
+ store -.migration/portability.-> store2
91
110
  ```
92
111
 
112
+ `WriterLease` coordinates only the current profile's writes. It does not prevent
113
+ other profiles or devices from writing to the same destination. "One writer per
114
+ destination" is an operational constraint, not an automatic cross-device lock.
115
+
93
116
  ## Why this plugin
94
117
 
95
118
  - Durable, private memory for Hermes Agent: conversations become searchable
@@ -136,6 +159,19 @@ cleans up the demo scope. All steps
136
159
  run in embedded mode. `scripts/demo.sh` reproduces the same walkthrough with
137
160
  the pinned release.
138
161
 
162
+ ## Choose your setup
163
+
164
+ | Use case | Recommended entry | Notes |
165
+ |---|---|---|
166
+ | Hermes native automatic memory | Native MemoryProvider | Automatic extraction and recall inside Hermes |
167
+ | Single agent, standalone MCP | Standalone MCP (`qdrant-memory-mcp`) | Explicit tools only, no auto-extraction |
168
+ | Multiple agents sharing memory | Authenticated Shared Owner | Opt-in. One writer per destination |
169
+ | Remote / multi-device access | HTTPS MCP + Owner | TLS, auth and network protection required |
170
+ | WorkBuddy / DSH | Host integration guides | Reuse the same Runtime |
171
+ | Migrate Mem0 data | Migration CLI | Source IDs, resumable manifest, verification |
172
+
173
+ See [standalone setup](docs/standalone.md), [shared memory](docs/shared-memory/README.md), and [cross-harness architecture](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md).
174
+
139
175
  ## Install
140
176
 
141
177
  Requirements: Python 3.11+, a compatible Hermes installation, and a reachable
@@ -149,7 +185,7 @@ Choose the **active profile's** home explicitly. Do not reuse another profile's
149
185
  **Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
150
186
 
151
187
  The Catalog selects its own fixed revision, which may be older than Runtime
152
- 0.5.0. To use the current release, including opt-in shared memory, follow the
188
+ 0.5.2. To use the current release, including opt-in shared memory, follow the
153
189
  recommended version-locked installation below.
154
190
 
155
191
  ```bash
@@ -167,7 +203,7 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
167
203
  tools, requirements and known issues before it clones anything.
168
204
  `hermes plugins enable` prepares the declared dependencies through Hermes PM.
169
205
 
170
- **Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
206
+ **Recommended: install the version-locked Runtime 0.5.2 source through the Hermes CLI.**
171
207
 
172
208
  This immutable source revision includes opt-in shared memory. It does not depend
173
209
  on a PyPI release or a catalog update.
@@ -177,7 +213,7 @@ export HERMES_HOME="/absolute/path/to/your/hermes-profile"
177
213
  ollama pull qwen3-embedding:4b
178
214
  # Start Ollama if it is not running. Keep its service available.
179
215
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
180
- --ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
216
+ --ref 604793341226e45f04500cd1d53fd668ddf89d63 # Runtime 0.5.2 release
181
217
  hermes plugins enable qdrant-memory
182
218
  hermes memory setup
183
219
  hermes config set memory.provider qdrant-memory
@@ -188,7 +224,7 @@ hermes qdrant-memory init
188
224
 
189
225
  This older immutable source revision includes optional CPU embedding and guided
190
226
  setup, but it predates opt-in shared memory. For the current release use
191
- Runtime 0.5.0 above. It does not depend on a PyPI release or a catalog update.
227
+ Runtime 0.5.2 above. It does not depend on a PyPI release or a catalog update.
192
228
 
193
229
  ```bash
194
230
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -212,7 +248,7 @@ environment. Omit `--ref` to track `main`, the development line.
212
248
  **Historical release: clone a published tag manually.**
213
249
 
214
250
  The v0.1.0 tag below predates the standalone interfaces and the explicit-write
215
- fix. Use the pinned source above for Runtime 0.5.0.
251
+ fix. Use the pinned source above for Runtime 0.5.2.
216
252
 
217
253
  ```bash
218
254
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -492,6 +528,20 @@ and non-primary-agent turns. Treat recalled content as untrusted data. See
492
528
  [security](docs/security.md), [operating procedures](docs/operations.md),
493
529
  [troubleshooting](docs/troubleshooting.md) and [architecture](docs/architecture.md).
494
530
 
531
+ ## Capabilities and limitations
532
+
533
+ | Area | Status | Notes |
534
+ |---|---|---|
535
+ | Private memory (standalone) | Supported | Embedded / server / Cloud Qdrant |
536
+ | Automatic extraction (Hermes) | Supported | Trusted `ctx.llm` facade |
537
+ | Automatic recall (Hermes) | Supported | Scoped dense search |
538
+ | Shared memory (Shared Owner) | Opt-in | One writer per destination (operational constraint, not cross-device lock). Not the default |
539
+ | Automatic shared extraction | Opt-in | Native Owner and opt-in Pi lifecycle adapter |
540
+ | MCP auto-extraction | Not supported | Explicit tools only |
541
+ | Hybrid search / reranking | Not supported | Dense retrieval only (v0.1) |
542
+ | Multi-writer Server/Cloud | Not supported | One authoritative writer |
543
+ | Web UI | Not supported | CLI and tools only |
544
+
495
545
  ## Compatibility and scope
496
546
 
497
547
  Version 0.1 implements dense retrieval. Hybrid sparse vectors, RRF/DBSF, reranking
@@ -556,6 +606,33 @@ for a separate synthetic replay and retained-storage measurement.
556
606
  CI runs tests, SonarCloud quality gates and Snyk dependency/code scans.
557
607
  See [CI service setup](docs/ci.md) and [validation evidence](docs/validation.md).
558
608
 
609
+ ## Documentation
610
+
611
+ - [Getting started / standalone](docs/standalone.md)
612
+ - [Architecture](docs/architecture.md)
613
+ - [Configuration](docs/configuration.md)
614
+ - [Cross-harness sharing (MCP repo)](https://github.com/cnkang/qdrant-memory-mcp/blob/main/docs/cross-harness-architecture.md)
615
+ - [Shared memory](docs/shared-memory/README.md)
616
+ - [Security](docs/security.md)
617
+ - [Operations](docs/operations.md)
618
+ - [Migration from Mem0](docs/migration-from-mem0.md)
619
+ - [Backup and portability](docs/portability.md)
620
+ - [Validation and evidence](docs/validation.md)
621
+ - [Development](docs/development.md)
622
+ - [CI](docs/ci.md)
623
+
624
+ ## Validation and evidence
625
+
626
+ Real evidence, not badges:
627
+
628
+ - Hermes native lifecycle tests: [validation](docs/validation.md)
629
+ - Cross-harness sharing: [OpenCode / Pi dual-device acceptance](docs/validation/cross-device-opencode-pi-2026-10.md); WorkBuddy / DSH: not fully host-validated ([report](docs/shared-memory/report.md))
630
+ - Crash / restart / idempotency: [bounded recovery](docs/recovery-benchmark.md)
631
+ - Authorization and isolation: [security](docs/security.md), [threat model](docs/shared-memory/threat-model-v1.md)
632
+ - Model quality: frozen evaluation datasets (see `scripts/evaluate.py`)
633
+
634
+ Long-running 24-hour acceptance: pending / not yet verified.
635
+
559
636
  ## License
560
637
 
561
638
  MIT. Copyright © 2026 Kang Liu. See [LICENSE](LICENSE).