hermes-plugin-qdrant-memory 0.3.0__tar.gz → 0.5.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 (159) hide show
  1. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/PKG-INFO +41 -23
  2. hermes_plugin_qdrant_memory-0.3.0/hermes_plugin_qdrant_memory.egg-info/PKG-INFO → hermes_plugin_qdrant_memory-0.5.0/README.md +36 -45
  3. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/docs/local-embedding.md +10 -7
  4. hermes_plugin_qdrant_memory-0.3.0/README.md → hermes_plugin_qdrant_memory-0.5.0/hermes_plugin_qdrant_memory.egg-info/PKG-INFO +63 -22
  5. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/SOURCES.txt +62 -0
  6. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/requires.txt +5 -0
  7. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/pyproject.toml +3 -2
  8. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/cli.py +28 -2
  9. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/config.py +11 -3
  10. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/dedupe.py +43 -0
  11. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/embedding.py +3 -1
  12. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/extraction.py +121 -0
  13. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/ledger.py +59 -5
  14. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/local_embedding.py +2 -1
  15. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/local_model.py +4 -0
  16. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/mcp_server.py +11 -4
  17. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/native_owner.py +264 -0
  18. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/owner_lifecycle.py +243 -0
  19. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/owner_llm.py +168 -0
  20. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/ownership.py +115 -0
  21. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/plugin.yaml +4 -1
  22. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/policy_admin.py +93 -0
  23. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/provider.py +189 -4
  24. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/qdrant_store.py +7 -2
  25. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/quality_metrics.py +254 -0
  26. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_client.py +180 -0
  27. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_gateway.py +317 -0
  28. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/remote_protocol.py +46 -0
  29. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/runtime.py +53 -4
  30. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_client.py +93 -0
  31. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_protocol.py +46 -0
  32. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_reader.py +227 -0
  33. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_recall.py +166 -0
  34. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_security.py +365 -0
  35. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_service.py +701 -0
  36. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/shared_state.py +45 -0
  37. hermes_plugin_qdrant_memory-0.5.0/qdrant_memory/standalone.py +417 -0
  38. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/tools.py +21 -0
  39. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/version.py +1 -1
  40. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/requirements-local.txt +232 -234
  41. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/requirements.txt +3 -3
  42. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/scripts/demo.sh +1 -1
  43. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/helpers.py +21 -0
  44. hermes_plugin_qdrant_memory-0.5.0/tests/remote/fixture.py +343 -0
  45. hermes_plugin_qdrant_memory-0.5.0/tests/security/__init__.py +1 -0
  46. hermes_plugin_qdrant_memory-0.5.0/tests/security/test_cloud_owner.py +191 -0
  47. hermes_plugin_qdrant_memory-0.5.0/tests/security/test_cloud_owner_cleanup.py +122 -0
  48. hermes_plugin_qdrant_memory-0.5.0/tests/security/test_device_server.py +98 -0
  49. hermes_plugin_qdrant_memory-0.5.0/tests/security/test_shared_security.py +520 -0
  50. hermes_plugin_qdrant_memory-0.5.0/tests/security/test_shared_security_live.py +115 -0
  51. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_admission_control.py +65 -0
  52. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_device_grants.py +120 -0
  53. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_context.py +33 -0
  54. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_events.py +276 -0
  55. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_lifecycle.py +112 -0
  56. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_owner_llm.py +455 -0
  57. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_policy_admin.py +48 -0
  58. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_client.py +138 -0
  59. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_gateway.py +183 -0
  60. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_listener_options.py +79 -0
  61. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_remote_service.py +143 -0
  62. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_reset_receipts.py +97 -0
  63. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_contracts.py +298 -0
  64. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_evaluation.py +53 -0
  65. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_reader.py +382 -0
  66. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_response.py +122 -0
  67. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_service.py +880 -0
  68. hermes_plugin_qdrant_memory-0.5.0/tests/standalone/test_shared_visibility.py +115 -0
  69. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_checkpoint_lifecycle.py +7 -4
  70. hermes_plugin_qdrant_memory-0.5.0/tests/test_ci_gate.py +195 -0
  71. hermes_plugin_qdrant_memory-0.5.0/tests/test_ci_infrastructure_retry.py +124 -0
  72. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_config_embedding.py +16 -2
  73. hermes_plugin_qdrant_memory-0.5.0/tests/test_dependency_inputs.py +195 -0
  74. hermes_plugin_qdrant_memory-0.5.0/tests/test_dependency_security.py +42 -0
  75. hermes_plugin_qdrant_memory-0.5.0/tests/test_explicit_dedupe.py +269 -0
  76. hermes_plugin_qdrant_memory-0.5.0/tests/test_fastembed_compat.py +145 -0
  77. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_input_validation.py +31 -0
  78. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_local_embedding_provider.py +6 -3
  79. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_manifest_contract.py +8 -1
  80. hermes_plugin_qdrant_memory-0.5.0/tests/test_model_smoke.py +154 -0
  81. hermes_plugin_qdrant_memory-0.5.0/tests/test_native_owner.py +559 -0
  82. hermes_plugin_qdrant_memory-0.5.0/tests/test_native_unadmitted.py +268 -0
  83. hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_http.py +398 -0
  84. hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_models.py +130 -0
  85. hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_preflight.py +334 -0
  86. hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_runner.py +377 -0
  87. hermes_plugin_qdrant_memory-0.5.0/tests/test_openrouter_workflow.py +71 -0
  88. hermes_plugin_qdrant_memory-0.5.0/tests/test_pi_quality_driver.py +80 -0
  89. hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_dependencies.py +34 -0
  90. hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_metrics.py +224 -0
  91. hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_mutations.py +152 -0
  92. hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_ollama_setup.py +85 -0
  93. hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_profiles.py +236 -0
  94. hermes_plugin_qdrant_memory-0.5.0/tests/test_quality_runner.py +211 -0
  95. hermes_plugin_qdrant_memory-0.5.0/tests/test_readme_release_contract.py +136 -0
  96. hermes_plugin_qdrant_memory-0.5.0/tests/test_remote_shutdown.py +151 -0
  97. hermes_plugin_qdrant_memory-0.5.0/tests/test_shared_recall.py +305 -0
  98. hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/dedupe.py +0 -34
  99. hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/extraction.py +0 -90
  100. hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/ownership.py +0 -48
  101. hermes_plugin_qdrant_memory-0.3.0/qdrant_memory/standalone.py +0 -236
  102. hermes_plugin_qdrant_memory-0.3.0/tests/test_ci_gate.py +0 -62
  103. hermes_plugin_qdrant_memory-0.3.0/tests/test_explicit_dedupe.py +0 -80
  104. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/LICENSE +0 -0
  105. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/MANIFEST.in +0 -0
  106. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/dependency_links.txt +0 -0
  107. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/entry_points.txt +0 -0
  108. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/hermes_plugin_qdrant_memory.egg-info/top_level.txt +0 -0
  109. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/__init__.py +0 -0
  110. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/config_schema.py +0 -0
  111. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/inventory.py +0 -0
  112. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/managed_setup.py +0 -0
  113. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/migration.py +0 -0
  114. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/models.py +0 -0
  115. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/private_paths.py +0 -0
  116. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/progress.py +0 -0
  117. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/reset.py +0 -0
  118. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/qdrant_memory/retry.py +0 -0
  119. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/setup.cfg +0 -0
  120. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/__init__.py +0 -0
  121. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/conftest.py +0 -0
  122. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/local_model/test_acceptance.py +0 -0
  123. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/__init__.py +0 -0
  124. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_explicit_writes.py +0 -0
  125. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_managed_setup.py +0 -0
  126. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_public_api.py +0 -0
  127. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/standalone/test_standalone.py +0 -0
  128. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_backend_contracts.py +0 -0
  129. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_bot_scope.py +0 -0
  130. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_bounded_recovery.py +0 -0
  131. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_cli_output.py +0 -0
  132. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_deletion_ordering.py +0 -0
  133. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_discovery_cli.py +0 -0
  134. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_host_lifecycle.py +0 -0
  135. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_host_pins.py +0 -0
  136. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_inventory_export.py +0 -0
  137. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_live_metrics.py +0 -0
  138. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_local_embedding.py +0 -0
  139. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_local_model.py +0 -0
  140. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_maintenance.py +0 -0
  141. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration.py +0 -0
  142. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_endpoints.py +0 -0
  143. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_progress.py +0 -0
  144. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_resume.py +0 -0
  145. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_migration_superseded.py +0 -0
  146. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_profile_scope.py +0 -0
  147. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_provider.py +0 -0
  148. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_recovery_benchmark.py +0 -0
  149. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_recovery_evaluation.py +0 -0
  150. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_remote_qdrant.py +0 -0
  151. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_reset_inspection.py +0 -0
  152. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_reset_recovery.py +0 -0
  153. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_retention.py +0 -0
  154. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_review_regressions.py +0 -0
  155. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_session_provenance.py +0 -0
  156. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_setup_contract.py +0 -0
  157. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_shutdown_contract.py +0 -0
  158. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/tests/test_store_runtime.py +0 -0
  159. {hermes_plugin_qdrant_memory-0.3.0 → hermes_plugin_qdrant_memory-0.5.0}/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.3.0
3
+ Version: 0.5.0
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
@@ -15,14 +15,27 @@ License-File: LICENSE
15
15
  Requires-Dist: qdrant-client<2,>=1.15
16
16
  Requires-Dist: httpx<1,>=0.28
17
17
  Requires-Dist: portalocker<4,>=3.2
18
+ Requires-Dist: jsonschema<5,>=4.23
18
19
  Provides-Extra: mcp
19
20
  Requires-Dist: mcp<3,>=1.30; extra == "mcp"
21
+ Provides-Extra: remote
22
+ Requires-Dist: mcp<3,>=1.30; extra == "remote"
23
+ Requires-Dist: uvicorn<1,>=0.35; extra == "remote"
20
24
  Provides-Extra: local
21
25
  Requires-Dist: fastembed==0.9.0; extra == "local"
22
26
  Dynamic: license-file
23
27
 
24
28
  # Qdrant Memory for Hermes
25
29
 
30
+ Shared deployment hardening in this checkout is documented in the
31
+ [protected destination guide](docs/shared-memory/deployment-security.md) and
32
+ [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.
34
+
35
+ ## One Memory, Multiple Agents — opt-in shared owner
36
+
37
+ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge. Multiple agents can share an explicitly authorized space while legacy records remain private. Hermes Native Provider and existing private defaults remain unchanged. See [setup, Hermes/DSH walkthrough and limits](docs/shared-memory/README.md), [architecture](docs/shared-memory/architecture.md), and [validation](docs/shared-memory/report.md). Runtime 0.5.0 adds opt-in Native Owner extraction, device grants and HTTPS MCP. See the [remote Owner guide](docs/shared-memory/remote-owner.md).
38
+
26
39
  [![CI](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml)
27
40
  [![Platform compatibility](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml)
28
41
  [![Standalone CLI and MCP](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml)
@@ -30,19 +43,22 @@ Dynamic: license-file
30
43
  [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
31
44
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
32
45
 
33
- > **Runtime 0.3.0** adds optional offline CPU embedding and trusted setup
34
- > commands to the standalone CLI/MCP. It supports MCP Python SDK 1.x and 2.x.
46
+ > **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
47
+ > bridge for explicit shared memory. It keeps the optional offline CPU embedding,
48
+ > trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
35
49
  > Explicit writes retain canonical-text deduplication without an LLM.
36
- > MCP distribution 0.1.3 pins Runtime 0.2.2. The Runtime 0.3.0 update follows
37
- > in the MCP repository.
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.
52
+ > The generic MCP distribution and managed launcher select their own exact Runtime
53
+ > dependency and are released independently.
38
54
  > The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
39
55
  > does not upgrade it. One writer per destination remains required.
40
- > See [release notes](docs/releases/0.3.0.md) and [validation](docs/validation.md).
56
+ > See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
41
57
 
42
58
  [English](README.md) | [简体中文](README.zh-CN.md)
43
59
 
44
- New in 0.3.0: [optional CPU embedding and guided setup](docs/local-embedding.md)
45
- adds explicit provider selection without changing Ollama or cloud configurations.
60
+ New in 0.5.0: [shared memory for multiple agents](docs/shared-memory/README.md)
61
+ adds an opt-in authenticated local owner without changing private defaults.
46
62
 
47
63
  Native long-term memory plugin for Hermes Agent, implemented as a `MemoryProvider`.
48
64
  Hermes performs extraction
@@ -55,7 +71,7 @@ as a community-maintained plugin.
55
71
  ## How it works
56
72
 
57
73
  For non-Hermes users, install in a private Python 3.11+
58
- environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.3.0'` (omit `[mcp]`
74
+ environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
59
75
  for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
60
76
  Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
61
77
  MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
@@ -96,8 +112,7 @@ The plugin primarily provides Hermes Agent's durable memory integration. As an
96
112
  additional capability, its shared backend can serve other agents through the
97
113
  Runtime's `qdrant-memory --home PATH` JSON CLI and optional local stdio MCP
98
114
  interface. Standalone use does not require Hermes. These interfaces support explicit scoped
99
- memory operations and maintenance/migration. Automatic extraction and prefetch
100
- remain Hermes lifecycle features. See [standalone setup](docs/standalone.md) for
115
+ memory operations and maintenance/migration. Automatic extraction and prefetch use the Hermes Native Owner or the opt-in Pi lifecycle adapter. See [standalone setup](docs/standalone.md) for
101
116
  configuration and boundaries, and the agent-neutral
102
117
  [qdrant-memory skill](https://github.com/cnkang/skills/tree/main/qdrant-memory)
103
118
  for multi-agent installation and usage guidance.
@@ -131,7 +146,11 @@ to serve `qwen3-embedding:4b`.
131
146
 
132
147
  Choose the **active profile's** home explicitly. Do not reuse another profile's data.
133
148
 
134
- **Recommended: install from the official Hermes Plugin Catalog.**
149
+ **Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
150
+
151
+ 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
153
+ recommended version-locked installation below.
135
154
 
136
155
  ```bash
137
156
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -148,36 +167,35 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
148
167
  tools, requirements and known issues before it clones anything.
149
168
  `hermes plugins enable` prepares the declared dependencies through Hermes PM.
150
169
 
151
- **Version-locked: install the verified Runtime 0.3.0 source through the Hermes CLI.**
170
+ **Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
152
171
 
153
- This immutable source revision includes the optional CPU embedding and guided
154
- setup. It does not depend on a PyPI release or a catalog update.
172
+ This immutable source revision includes opt-in shared memory. It does not depend
173
+ on a PyPI release or a catalog update.
155
174
 
156
175
  ```bash
157
176
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
158
177
  ollama pull qwen3-embedding:4b
159
178
  # Start Ollama if it is not running. Keep its service available.
160
179
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
161
- --ref 7c9e52d816b4f8e8109dbef2797f573b93e0d604 # verified Runtime 0.3.0 source
180
+ --ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
162
181
  hermes plugins enable qdrant-memory
163
182
  hermes memory setup
164
183
  hermes config set memory.provider qdrant-memory
165
184
  hermes qdrant-memory init
166
185
  ```
167
186
 
168
- **Previous verified source: install Runtime 0.2.2 through the Hermes CLI.**
187
+ **Previous verified source: install Runtime 0.3.0 through the Hermes CLI.**
169
188
 
170
- This older immutable source revision supports MCP SDK 1.x/2.x and includes the
171
- explicit-write fix, but it predates the optional CPU embedding and guided setup.
172
- For the current release use Runtime 0.3.0 above. It does not
173
- depend on a PyPI release or a catalog update.
189
+ This older immutable source revision includes optional CPU embedding and guided
190
+ 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.
174
192
 
175
193
  ```bash
176
194
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
177
195
  ollama pull qwen3-embedding:4b
178
196
  # Start Ollama if it is not running. Keep its service available.
179
197
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
180
- --ref c85d2bce788b117dddd854bb124971f7de8e564c # verified Runtime 0.2.2 source
198
+ --ref 534562f1df43541dbf906d248bb11cd085b211ee # verified Runtime 0.3.0 source
181
199
  hermes plugins enable qdrant-memory
182
200
  hermes memory setup
183
201
  hermes config set memory.provider qdrant-memory
@@ -194,7 +212,7 @@ environment. Omit `--ref` to track `main`, the development line.
194
212
  **Historical release: clone a published tag manually.**
195
213
 
196
214
  The v0.1.0 tag below predates the standalone interfaces and the explicit-write
197
- fix. Use the pinned source above for Runtime 0.3.0.
215
+ fix. Use the pinned source above for Runtime 0.5.0.
198
216
 
199
217
  ```bash
200
218
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -1,28 +1,14 @@
1
- Metadata-Version: 2.4
2
- Name: hermes-plugin-qdrant-memory
3
- Version: 0.3.0
4
- Summary: Durable Qdrant memory for Hermes, standalone CLI and local MCP
5
- License-Expression: MIT
6
- Project-URL: Homepage, https://github.com/cnkang/hermes-plugin-qdrant-memory
7
- Project-URL: Repository, https://github.com/cnkang/hermes-plugin-qdrant-memory
8
- Project-URL: Issues, https://github.com/cnkang/hermes-plugin-qdrant-memory/issues
9
- Project-URL: Changelog, https://github.com/cnkang/hermes-plugin-qdrant-memory/blob/main/CHANGELOG.md
10
- Project-URL: MCP, https://github.com/cnkang/qdrant-memory-mcp
11
- Project-URL: Skill, https://github.com/cnkang/skills/tree/main/qdrant-memory
12
- Requires-Python: >=3.11
13
- Description-Content-Type: text/markdown
14
- License-File: LICENSE
15
- Requires-Dist: qdrant-client<2,>=1.15
16
- Requires-Dist: httpx<1,>=0.28
17
- Requires-Dist: portalocker<4,>=3.2
18
- Provides-Extra: mcp
19
- Requires-Dist: mcp<3,>=1.30; extra == "mcp"
20
- Provides-Extra: local
21
- Requires-Dist: fastembed==0.9.0; extra == "local"
22
- Dynamic: license-file
23
-
24
1
  # Qdrant Memory for Hermes
25
2
 
3
+ Shared deployment hardening in this checkout is documented in the
4
+ [protected destination guide](docs/shared-memory/deployment-security.md) and
5
+ [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.
7
+
8
+ ## One Memory, Multiple Agents — opt-in shared owner
9
+
10
+ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge. Multiple agents can share an explicitly authorized space while legacy records remain private. Hermes Native Provider and existing private defaults remain unchanged. See [setup, Hermes/DSH walkthrough and limits](docs/shared-memory/README.md), [architecture](docs/shared-memory/architecture.md), and [validation](docs/shared-memory/report.md). Runtime 0.5.0 adds opt-in Native Owner extraction, device grants and HTTPS MCP. See the [remote Owner guide](docs/shared-memory/remote-owner.md).
11
+
26
12
  [![CI](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml)
27
13
  [![Platform compatibility](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml)
28
14
  [![Standalone CLI and MCP](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml)
@@ -30,19 +16,22 @@ Dynamic: license-file
30
16
  [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
31
17
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
32
18
 
33
- > **Runtime 0.3.0** adds optional offline CPU embedding and trusted setup
34
- > commands to the standalone CLI/MCP. It supports MCP Python SDK 1.x and 2.x.
19
+ > **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
20
+ > bridge for explicit shared memory. It keeps the optional offline CPU embedding,
21
+ > trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
35
22
  > Explicit writes retain canonical-text deduplication without an LLM.
36
- > MCP distribution 0.1.3 pins Runtime 0.2.2. The Runtime 0.3.0 update follows
37
- > in the MCP repository.
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.
25
+ > The generic MCP distribution and managed launcher select their own exact Runtime
26
+ > dependency and are released independently.
38
27
  > The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
39
28
  > does not upgrade it. One writer per destination remains required.
40
- > See [release notes](docs/releases/0.3.0.md) and [validation](docs/validation.md).
29
+ > See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
41
30
 
42
31
  [English](README.md) | [简体中文](README.zh-CN.md)
43
32
 
44
- New in 0.3.0: [optional CPU embedding and guided setup](docs/local-embedding.md)
45
- adds explicit provider selection without changing Ollama or cloud configurations.
33
+ New in 0.5.0: [shared memory for multiple agents](docs/shared-memory/README.md)
34
+ adds an opt-in authenticated local owner without changing private defaults.
46
35
 
47
36
  Native long-term memory plugin for Hermes Agent, implemented as a `MemoryProvider`.
48
37
  Hermes performs extraction
@@ -55,7 +44,7 @@ as a community-maintained plugin.
55
44
  ## How it works
56
45
 
57
46
  For non-Hermes users, install in a private Python 3.11+
58
- environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.3.0'` (omit `[mcp]`
47
+ environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
59
48
  for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
60
49
  Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
61
50
  MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
@@ -96,8 +85,7 @@ The plugin primarily provides Hermes Agent's durable memory integration. As an
96
85
  additional capability, its shared backend can serve other agents through the
97
86
  Runtime's `qdrant-memory --home PATH` JSON CLI and optional local stdio MCP
98
87
  interface. Standalone use does not require Hermes. These interfaces support explicit scoped
99
- memory operations and maintenance/migration. Automatic extraction and prefetch
100
- remain Hermes lifecycle features. See [standalone setup](docs/standalone.md) for
88
+ memory operations and maintenance/migration. Automatic extraction and prefetch use the Hermes Native Owner or the opt-in Pi lifecycle adapter. See [standalone setup](docs/standalone.md) for
101
89
  configuration and boundaries, and the agent-neutral
102
90
  [qdrant-memory skill](https://github.com/cnkang/skills/tree/main/qdrant-memory)
103
91
  for multi-agent installation and usage guidance.
@@ -131,7 +119,11 @@ to serve `qwen3-embedding:4b`.
131
119
 
132
120
  Choose the **active profile's** home explicitly. Do not reuse another profile's data.
133
121
 
134
- **Recommended: install from the official Hermes Plugin Catalog.**
122
+ **Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
123
+
124
+ 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
126
+ recommended version-locked installation below.
135
127
 
136
128
  ```bash
137
129
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -148,36 +140,35 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
148
140
  tools, requirements and known issues before it clones anything.
149
141
  `hermes plugins enable` prepares the declared dependencies through Hermes PM.
150
142
 
151
- **Version-locked: install the verified Runtime 0.3.0 source through the Hermes CLI.**
143
+ **Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
152
144
 
153
- This immutable source revision includes the optional CPU embedding and guided
154
- setup. It does not depend on a PyPI release or a catalog update.
145
+ This immutable source revision includes opt-in shared memory. It does not depend
146
+ on a PyPI release or a catalog update.
155
147
 
156
148
  ```bash
157
149
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
158
150
  ollama pull qwen3-embedding:4b
159
151
  # Start Ollama if it is not running. Keep its service available.
160
152
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
161
- --ref 7c9e52d816b4f8e8109dbef2797f573b93e0d604 # verified Runtime 0.3.0 source
153
+ --ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
162
154
  hermes plugins enable qdrant-memory
163
155
  hermes memory setup
164
156
  hermes config set memory.provider qdrant-memory
165
157
  hermes qdrant-memory init
166
158
  ```
167
159
 
168
- **Previous verified source: install Runtime 0.2.2 through the Hermes CLI.**
160
+ **Previous verified source: install Runtime 0.3.0 through the Hermes CLI.**
169
161
 
170
- This older immutable source revision supports MCP SDK 1.x/2.x and includes the
171
- explicit-write fix, but it predates the optional CPU embedding and guided setup.
172
- For the current release use Runtime 0.3.0 above. It does not
173
- depend on a PyPI release or a catalog update.
162
+ This older immutable source revision includes optional CPU embedding and guided
163
+ 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.
174
165
 
175
166
  ```bash
176
167
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
177
168
  ollama pull qwen3-embedding:4b
178
169
  # Start Ollama if it is not running. Keep its service available.
179
170
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
180
- --ref c85d2bce788b117dddd854bb124971f7de8e564c # verified Runtime 0.2.2 source
171
+ --ref 534562f1df43541dbf906d248bb11cd085b211ee # verified Runtime 0.3.0 source
181
172
  hermes plugins enable qdrant-memory
182
173
  hermes memory setup
183
174
  hermes config set memory.provider qdrant-memory
@@ -194,7 +185,7 @@ environment. Omit `--ref` to track `main`, the development line.
194
185
  **Historical release: clone a published tag manually.**
195
186
 
196
187
  The v0.1.0 tag below predates the standalone interfaces and the explicit-write
197
- fix. Use the pinned source above for Runtime 0.3.0.
188
+ fix. Use the pinned source above for Runtime 0.5.0.
198
189
 
199
190
  ```bash
200
191
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -1,6 +1,6 @@
1
1
  # Optional local CPU embedding and guided setup
2
2
 
3
- These commands ship with Runtime 0.3.0. Published Runtime 0.2.2 and MCP
3
+ These commands are available in Runtime 0.5.0. Published Runtime 0.2.2 and MCP
4
4
  distribution 0.1.3 predate them. Those packages keep their existing
5
5
  configuration workflow.
6
6
 
@@ -35,8 +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.
40
+
38
41
  ```sh
39
- python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.3.0'
42
+ python -m pip install 'hermes-plugin-qdrant-memory[mcp,local]==0.5.0'
40
43
  ```
41
44
 
42
45
  Choose **one** setup command and replace the profile path with a new absolute
@@ -69,7 +72,7 @@ name, supply `--embedding-api-key-env VARIABLE_NAME`.
69
72
 
70
73
  Use a different profile and `--agent-id` for each client. `--user-id` defaults to
71
74
  `local-user`. Self-hosted/Cloud Qdrant storage continues to use the existing
72
- [configuration workflow](configuration.md); this setup command creates only a
75
+ [configuration workflow](configuration.md). This setup command creates only a
73
76
  new embedded destination. A remote embedding choice is distinct from remote
74
77
  Qdrant storage.
75
78
 
@@ -102,7 +105,7 @@ Managed cache/profile paths must be canonical absolute paths without symlinks
102
105
  or Windows reparse points, including intermediate directories.
103
106
 
104
107
  Preparation requires network access and may take several minutes. Start MCP
105
- after preparation and setup complete; do not place the download inside a
108
+ after preparation and setup complete. Do not place the download inside a
106
109
  30-second connection handshake. Normal provider startup verifies cached files
107
110
  and performs no downloads. Prepared CPU inference works offline and does not
108
111
  send memory/query text to an embedding service.
@@ -110,7 +113,7 @@ send memory/query text to an embedding service.
110
113
  Downloads use a provisioning lock and a private staging directory. The complete
111
114
  cache is published only after every file passes validation. Failed preparation
112
115
  can be retried with the same command. A corrupt completed cache is rejected and
113
- left untouched; it is not silently replaced. Select a new cache directory for
116
+ left untouched. It is not silently replaced. Select a new cache directory for
114
117
  explicit re-preparation, preserving the old files for diagnosis or recovery.
115
118
 
116
119
  ## Safety, limits and recovery
@@ -127,7 +130,7 @@ explicit re-preparation, preserving the old files for diagnosis or recovery.
127
130
  - Choosing CPU for a collection created with Ollama or another model is not a
128
131
  migration. Existing incompatible collections fail compatibility checks.
129
132
  - `LocalModelNotPreparedError`: run explicit preparation with the correct cache.
130
- - `LocalModelIntegrityError`: do not bypass checks; explicitly prepare a new cache.
133
+ - `LocalModelIntegrityError`: do not bypass checks. Explicitly prepare a new cache.
131
134
  - `LocalEmbeddingUnavailableError`: install the reviewed `local` extra.
132
135
  - `ManagedProfileConflictError`: retain the existing profile and choose a new
133
136
  directory, or use the existing advanced configuration/maintenance workflow.
@@ -141,7 +144,7 @@ extraction, new network listener or cloud credential custody is introduced.
141
144
  Real local CPU inference and offline official-MCP CRUD/restart tests are separate
142
145
  from package installation and real WorkBuddy GUI acceptance. The optional local
143
146
  embedding workflow tests native Linux x64, Windows x64 and macOS Apple Silicon
144
- with Python 3.11. macOS Intel is best-effort compatibility and is not a release
147
+ with Python 3.11. MacOS Intel is best-effort compatibility and is not a release
145
148
  gate or a formally supported CPU platform. A successful dependency resolution
146
149
  alone is not a platform support claim. ARM64 variants outside macOS require
147
150
  separate acceptance.
@@ -1,5 +1,41 @@
1
+ Metadata-Version: 2.4
2
+ Name: hermes-plugin-qdrant-memory
3
+ Version: 0.5.0
4
+ Summary: Durable Qdrant memory for Hermes, standalone CLI and local MCP
5
+ License-Expression: MIT
6
+ Project-URL: Homepage, https://github.com/cnkang/hermes-plugin-qdrant-memory
7
+ Project-URL: Repository, https://github.com/cnkang/hermes-plugin-qdrant-memory
8
+ Project-URL: Issues, https://github.com/cnkang/hermes-plugin-qdrant-memory/issues
9
+ Project-URL: Changelog, https://github.com/cnkang/hermes-plugin-qdrant-memory/blob/main/CHANGELOG.md
10
+ Project-URL: MCP, https://github.com/cnkang/qdrant-memory-mcp
11
+ Project-URL: Skill, https://github.com/cnkang/skills/tree/main/qdrant-memory
12
+ Requires-Python: >=3.11
13
+ Description-Content-Type: text/markdown
14
+ License-File: LICENSE
15
+ Requires-Dist: qdrant-client<2,>=1.15
16
+ Requires-Dist: httpx<1,>=0.28
17
+ Requires-Dist: portalocker<4,>=3.2
18
+ Requires-Dist: jsonschema<5,>=4.23
19
+ Provides-Extra: mcp
20
+ Requires-Dist: mcp<3,>=1.30; extra == "mcp"
21
+ Provides-Extra: remote
22
+ Requires-Dist: mcp<3,>=1.30; extra == "remote"
23
+ Requires-Dist: uvicorn<1,>=0.35; extra == "remote"
24
+ Provides-Extra: local
25
+ Requires-Dist: fastembed==0.9.0; extra == "local"
26
+ Dynamic: license-file
27
+
1
28
  # Qdrant Memory for Hermes
2
29
 
30
+ Shared deployment hardening in this checkout is documented in the
31
+ [protected destination guide](docs/shared-memory/deployment-security.md) and
32
+ [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.
34
+
35
+ ## One Memory, Multiple Agents — opt-in shared owner
36
+
37
+ Runtime 0.5.0 adds an opt-in authenticated local shared owner and stdio bridge. Multiple agents can share an explicitly authorized space while legacy records remain private. Hermes Native Provider and existing private defaults remain unchanged. See [setup, Hermes/DSH walkthrough and limits](docs/shared-memory/README.md), [architecture](docs/shared-memory/architecture.md), and [validation](docs/shared-memory/report.md). Runtime 0.5.0 adds opt-in Native Owner extraction, device grants and HTTPS MCP. See the [remote Owner guide](docs/shared-memory/remote-owner.md).
38
+
3
39
  [![CI](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/ci.yml)
4
40
  [![Platform compatibility](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/platform-compat.yml)
5
41
  [![Standalone CLI and MCP](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml/badge.svg)](https://github.com/cnkang/hermes-plugin-qdrant-memory/actions/workflows/standalone.yml)
@@ -7,19 +43,22 @@
7
43
  [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
8
44
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
9
45
 
10
- > **Runtime 0.3.0** adds optional offline CPU embedding and trusted setup
11
- > commands to the standalone CLI/MCP. It supports MCP Python SDK 1.x and 2.x.
46
+ > **Runtime 0.5.0** adds an opt-in authenticated local shared owner and a stdio
47
+ > bridge for explicit shared memory. It keeps the optional offline CPU embedding,
48
+ > trusted setup and MCP Python SDK 1.x/2.x support from 0.3.0.
12
49
  > Explicit writes retain canonical-text deduplication without an LLM.
13
- > MCP distribution 0.1.3 pins Runtime 0.2.2. The Runtime 0.3.0 update follows
14
- > in the MCP repository.
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.
52
+ > The generic MCP distribution and managed launcher select their own exact Runtime
53
+ > dependency and are released independently.
15
54
  > The Hermes Plugin Catalog has its own reviewed immutable pin. A PyPI release
16
55
  > does not upgrade it. One writer per destination remains required.
17
- > See [release notes](docs/releases/0.3.0.md) and [validation](docs/validation.md).
56
+ > See [release notes](docs/releases/0.5.0.md) and [validation](docs/validation.md).
18
57
 
19
58
  [English](README.md) | [简体中文](README.zh-CN.md)
20
59
 
21
- New in 0.3.0: [optional CPU embedding and guided setup](docs/local-embedding.md)
22
- adds explicit provider selection without changing Ollama or cloud configurations.
60
+ New in 0.5.0: [shared memory for multiple agents](docs/shared-memory/README.md)
61
+ adds an opt-in authenticated local owner without changing private defaults.
23
62
 
24
63
  Native long-term memory plugin for Hermes Agent, implemented as a `MemoryProvider`.
25
64
  Hermes performs extraction
@@ -32,7 +71,7 @@ as a community-maintained plugin.
32
71
  ## How it works
33
72
 
34
73
  For non-Hermes users, install in a private Python 3.11+
35
- environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.3.0'` (omit `[mcp]`
74
+ environment: `pip install 'hermes-plugin-qdrant-memory[mcp]==0.5.0'` (omit `[mcp]`
36
75
  for CLI only). `qdrant-memory` is the CLI and `mcp` is its server subcommand.
37
76
  Standalone does not require Hermes. See [setup and quick start](docs/standalone.md).
38
77
  MCP-focused agents may instead use the [metadata-only distribution](https://github.com/cnkang/qdrant-memory-mcp).
@@ -73,8 +112,7 @@ The plugin primarily provides Hermes Agent's durable memory integration. As an
73
112
  additional capability, its shared backend can serve other agents through the
74
113
  Runtime's `qdrant-memory --home PATH` JSON CLI and optional local stdio MCP
75
114
  interface. Standalone use does not require Hermes. These interfaces support explicit scoped
76
- memory operations and maintenance/migration. Automatic extraction and prefetch
77
- remain Hermes lifecycle features. See [standalone setup](docs/standalone.md) for
115
+ memory operations and maintenance/migration. Automatic extraction and prefetch use the Hermes Native Owner or the opt-in Pi lifecycle adapter. See [standalone setup](docs/standalone.md) for
78
116
  configuration and boundaries, and the agent-neutral
79
117
  [qdrant-memory skill](https://github.com/cnkang/skills/tree/main/qdrant-memory)
80
118
  for multi-agent installation and usage guidance.
@@ -108,7 +146,11 @@ to serve `qwen3-embedding:4b`.
108
146
 
109
147
  Choose the **active profile's** home explicitly. Do not reuse another profile's data.
110
148
 
111
- **Recommended: install from the official Hermes Plugin Catalog.**
149
+ **Catalog option: install the version reviewed by the official Hermes Plugin Catalog.**
150
+
151
+ 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
153
+ recommended version-locked installation below.
112
154
 
113
155
  ```bash
114
156
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -125,36 +167,35 @@ The install resolves the catalog's reviewed commit and prints the entry's declar
125
167
  tools, requirements and known issues before it clones anything.
126
168
  `hermes plugins enable` prepares the declared dependencies through Hermes PM.
127
169
 
128
- **Version-locked: install the verified Runtime 0.3.0 source through the Hermes CLI.**
170
+ **Recommended: install the version-locked Runtime 0.5.0 source through the Hermes CLI.**
129
171
 
130
- This immutable source revision includes the optional CPU embedding and guided
131
- setup. It does not depend on a PyPI release or a catalog update.
172
+ This immutable source revision includes opt-in shared memory. It does not depend
173
+ on a PyPI release or a catalog update.
132
174
 
133
175
  ```bash
134
176
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
135
177
  ollama pull qwen3-embedding:4b
136
178
  # Start Ollama if it is not running. Keep its service available.
137
179
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
138
- --ref 7c9e52d816b4f8e8109dbef2797f573b93e0d604 # verified Runtime 0.3.0 source
180
+ --ref 2687a56631d5a7183d3fbe959324e3fc07491139 # Runtime 0.5.0 release
139
181
  hermes plugins enable qdrant-memory
140
182
  hermes memory setup
141
183
  hermes config set memory.provider qdrant-memory
142
184
  hermes qdrant-memory init
143
185
  ```
144
186
 
145
- **Previous verified source: install Runtime 0.2.2 through the Hermes CLI.**
187
+ **Previous verified source: install Runtime 0.3.0 through the Hermes CLI.**
146
188
 
147
- This older immutable source revision supports MCP SDK 1.x/2.x and includes the
148
- explicit-write fix, but it predates the optional CPU embedding and guided setup.
149
- For the current release use Runtime 0.3.0 above. It does not
150
- depend on a PyPI release or a catalog update.
189
+ This older immutable source revision includes optional CPU embedding and guided
190
+ 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.
151
192
 
152
193
  ```bash
153
194
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
154
195
  ollama pull qwen3-embedding:4b
155
196
  # Start Ollama if it is not running. Keep its service available.
156
197
  hermes plugins install https://github.com/cnkang/hermes-plugin-qdrant-memory \
157
- --ref c85d2bce788b117dddd854bb124971f7de8e564c # verified Runtime 0.2.2 source
198
+ --ref 534562f1df43541dbf906d248bb11cd085b211ee # verified Runtime 0.3.0 source
158
199
  hermes plugins enable qdrant-memory
159
200
  hermes memory setup
160
201
  hermes config set memory.provider qdrant-memory
@@ -171,7 +212,7 @@ environment. Omit `--ref` to track `main`, the development line.
171
212
  **Historical release: clone a published tag manually.**
172
213
 
173
214
  The v0.1.0 tag below predates the standalone interfaces and the explicit-write
174
- fix. Use the pinned source above for Runtime 0.3.0.
215
+ fix. Use the pinned source above for Runtime 0.5.0.
175
216
 
176
217
  ```bash
177
218
  export HERMES_HOME="/absolute/path/to/your/hermes-profile"
@@ -26,15 +26,30 @@ qdrant_memory/managed_setup.py
26
26
  qdrant_memory/mcp_server.py
27
27
  qdrant_memory/migration.py
28
28
  qdrant_memory/models.py
29
+ qdrant_memory/native_owner.py
30
+ qdrant_memory/owner_lifecycle.py
31
+ qdrant_memory/owner_llm.py
29
32
  qdrant_memory/ownership.py
30
33
  qdrant_memory/plugin.yaml
34
+ qdrant_memory/policy_admin.py
31
35
  qdrant_memory/private_paths.py
32
36
  qdrant_memory/progress.py
33
37
  qdrant_memory/provider.py
34
38
  qdrant_memory/qdrant_store.py
39
+ qdrant_memory/quality_metrics.py
40
+ qdrant_memory/remote_client.py
41
+ qdrant_memory/remote_gateway.py
42
+ qdrant_memory/remote_protocol.py
35
43
  qdrant_memory/reset.py
36
44
  qdrant_memory/retry.py
37
45
  qdrant_memory/runtime.py
46
+ qdrant_memory/shared_client.py
47
+ qdrant_memory/shared_protocol.py
48
+ qdrant_memory/shared_reader.py
49
+ qdrant_memory/shared_recall.py
50
+ qdrant_memory/shared_security.py
51
+ qdrant_memory/shared_service.py
52
+ qdrant_memory/shared_state.py
38
53
  qdrant_memory/standalone.py
39
54
  qdrant_memory/tools.py
40
55
  qdrant_memory/version.py
@@ -47,11 +62,15 @@ tests/test_bot_scope.py
47
62
  tests/test_bounded_recovery.py
48
63
  tests/test_checkpoint_lifecycle.py
49
64
  tests/test_ci_gate.py
65
+ tests/test_ci_infrastructure_retry.py
50
66
  tests/test_cli_output.py
51
67
  tests/test_config_embedding.py
52
68
  tests/test_deletion_ordering.py
69
+ tests/test_dependency_inputs.py
70
+ tests/test_dependency_security.py
53
71
  tests/test_discovery_cli.py
54
72
  tests/test_explicit_dedupe.py
73
+ tests/test_fastembed_compat.py
55
74
  tests/test_host_lifecycle.py
56
75
  tests/test_host_pins.py
57
76
  tests/test_input_validation.py
@@ -67,23 +86,66 @@ tests/test_migration_endpoints.py
67
86
  tests/test_migration_progress.py
68
87
  tests/test_migration_resume.py
69
88
  tests/test_migration_superseded.py
89
+ tests/test_model_smoke.py
90
+ tests/test_native_owner.py
91
+ tests/test_native_unadmitted.py
92
+ tests/test_openrouter_http.py
93
+ tests/test_openrouter_models.py
94
+ tests/test_openrouter_preflight.py
95
+ tests/test_openrouter_runner.py
96
+ tests/test_openrouter_workflow.py
97
+ tests/test_pi_quality_driver.py
70
98
  tests/test_profile_scope.py
71
99
  tests/test_provider.py
100
+ tests/test_quality_dependencies.py
101
+ tests/test_quality_metrics.py
102
+ tests/test_quality_mutations.py
103
+ tests/test_quality_ollama_setup.py
104
+ tests/test_quality_profiles.py
105
+ tests/test_quality_runner.py
106
+ tests/test_readme_release_contract.py
72
107
  tests/test_recovery_benchmark.py
73
108
  tests/test_recovery_evaluation.py
74
109
  tests/test_remote_qdrant.py
110
+ tests/test_remote_shutdown.py
75
111
  tests/test_reset_inspection.py
76
112
  tests/test_reset_recovery.py
77
113
  tests/test_retention.py
78
114
  tests/test_review_regressions.py
79
115
  tests/test_session_provenance.py
80
116
  tests/test_setup_contract.py
117
+ tests/test_shared_recall.py
81
118
  tests/test_shutdown_contract.py
82
119
  tests/test_store_runtime.py
83
120
  tests/test_writer_ownership.py
84
121
  tests/local_model/test_acceptance.py
122
+ tests/remote/fixture.py
123
+ tests/security/__init__.py
124
+ tests/security/test_cloud_owner.py
125
+ tests/security/test_cloud_owner_cleanup.py
126
+ tests/security/test_device_server.py
127
+ tests/security/test_shared_security.py
128
+ tests/security/test_shared_security_live.py
85
129
  tests/standalone/__init__.py
130
+ tests/standalone/test_admission_control.py
131
+ tests/standalone/test_device_grants.py
86
132
  tests/standalone/test_explicit_writes.py
87
133
  tests/standalone/test_managed_setup.py
134
+ tests/standalone/test_owner_context.py
135
+ tests/standalone/test_owner_events.py
136
+ tests/standalone/test_owner_lifecycle.py
137
+ tests/standalone/test_owner_llm.py
138
+ tests/standalone/test_policy_admin.py
88
139
  tests/standalone/test_public_api.py
140
+ tests/standalone/test_remote_client.py
141
+ tests/standalone/test_remote_gateway.py
142
+ tests/standalone/test_remote_listener_options.py
143
+ tests/standalone/test_remote_service.py
144
+ tests/standalone/test_reset_receipts.py
145
+ tests/standalone/test_shared_contracts.py
146
+ tests/standalone/test_shared_evaluation.py
147
+ tests/standalone/test_shared_reader.py
148
+ tests/standalone/test_shared_response.py
149
+ tests/standalone/test_shared_service.py
150
+ tests/standalone/test_shared_visibility.py
89
151
  tests/standalone/test_standalone.py