alma-memory 0.5.1__py3-none-any.whl → 0.7.0__py3-none-any.whl

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 (111) hide show
  1. alma/__init__.py +296 -226
  2. alma/compression/__init__.py +33 -0
  3. alma/compression/pipeline.py +980 -0
  4. alma/confidence/__init__.py +47 -47
  5. alma/confidence/engine.py +540 -540
  6. alma/confidence/types.py +351 -351
  7. alma/config/loader.py +157 -157
  8. alma/consolidation/__init__.py +23 -23
  9. alma/consolidation/engine.py +678 -678
  10. alma/consolidation/prompts.py +84 -84
  11. alma/core.py +1189 -430
  12. alma/domains/__init__.py +30 -30
  13. alma/domains/factory.py +359 -359
  14. alma/domains/schemas.py +448 -448
  15. alma/domains/types.py +272 -272
  16. alma/events/__init__.py +75 -75
  17. alma/events/emitter.py +285 -284
  18. alma/events/storage_mixin.py +246 -246
  19. alma/events/types.py +126 -126
  20. alma/events/webhook.py +425 -425
  21. alma/exceptions.py +49 -49
  22. alma/extraction/__init__.py +31 -31
  23. alma/extraction/auto_learner.py +265 -265
  24. alma/extraction/extractor.py +420 -420
  25. alma/graph/__init__.py +106 -106
  26. alma/graph/backends/__init__.py +32 -32
  27. alma/graph/backends/kuzu.py +624 -624
  28. alma/graph/backends/memgraph.py +432 -432
  29. alma/graph/backends/memory.py +236 -236
  30. alma/graph/backends/neo4j.py +417 -417
  31. alma/graph/base.py +159 -159
  32. alma/graph/extraction.py +198 -198
  33. alma/graph/store.py +860 -860
  34. alma/harness/__init__.py +35 -35
  35. alma/harness/base.py +386 -386
  36. alma/harness/domains.py +705 -705
  37. alma/initializer/__init__.py +37 -37
  38. alma/initializer/initializer.py +418 -418
  39. alma/initializer/types.py +250 -250
  40. alma/integration/__init__.py +62 -62
  41. alma/integration/claude_agents.py +444 -444
  42. alma/integration/helena.py +423 -423
  43. alma/integration/victor.py +471 -471
  44. alma/learning/__init__.py +101 -86
  45. alma/learning/decay.py +878 -0
  46. alma/learning/forgetting.py +1446 -1446
  47. alma/learning/heuristic_extractor.py +390 -390
  48. alma/learning/protocols.py +374 -374
  49. alma/learning/validation.py +346 -346
  50. alma/mcp/__init__.py +123 -45
  51. alma/mcp/__main__.py +156 -156
  52. alma/mcp/resources.py +122 -122
  53. alma/mcp/server.py +955 -591
  54. alma/mcp/tools.py +3254 -509
  55. alma/observability/__init__.py +91 -84
  56. alma/observability/config.py +302 -302
  57. alma/observability/guidelines.py +170 -0
  58. alma/observability/logging.py +424 -424
  59. alma/observability/metrics.py +583 -583
  60. alma/observability/tracing.py +440 -440
  61. alma/progress/__init__.py +21 -21
  62. alma/progress/tracker.py +607 -607
  63. alma/progress/types.py +250 -250
  64. alma/retrieval/__init__.py +134 -53
  65. alma/retrieval/budget.py +525 -0
  66. alma/retrieval/cache.py +1304 -1061
  67. alma/retrieval/embeddings.py +202 -202
  68. alma/retrieval/engine.py +850 -427
  69. alma/retrieval/modes.py +365 -0
  70. alma/retrieval/progressive.py +560 -0
  71. alma/retrieval/scoring.py +344 -344
  72. alma/retrieval/trust_scoring.py +637 -0
  73. alma/retrieval/verification.py +797 -0
  74. alma/session/__init__.py +19 -19
  75. alma/session/manager.py +442 -399
  76. alma/session/types.py +288 -288
  77. alma/storage/__init__.py +101 -90
  78. alma/storage/archive.py +233 -0
  79. alma/storage/azure_cosmos.py +1259 -1259
  80. alma/storage/base.py +1083 -583
  81. alma/storage/chroma.py +1443 -1443
  82. alma/storage/constants.py +103 -103
  83. alma/storage/file_based.py +614 -614
  84. alma/storage/migrations/__init__.py +21 -21
  85. alma/storage/migrations/base.py +321 -321
  86. alma/storage/migrations/runner.py +323 -323
  87. alma/storage/migrations/version_stores.py +337 -337
  88. alma/storage/migrations/versions/__init__.py +11 -11
  89. alma/storage/migrations/versions/v1_0_0.py +373 -373
  90. alma/storage/migrations/versions/v1_1_0_workflow_context.py +551 -0
  91. alma/storage/pinecone.py +1080 -1080
  92. alma/storage/postgresql.py +1948 -1559
  93. alma/storage/qdrant.py +1306 -1306
  94. alma/storage/sqlite_local.py +3041 -1457
  95. alma/testing/__init__.py +46 -46
  96. alma/testing/factories.py +301 -301
  97. alma/testing/mocks.py +389 -389
  98. alma/types.py +292 -264
  99. alma/utils/__init__.py +19 -0
  100. alma/utils/tokenizer.py +521 -0
  101. alma/workflow/__init__.py +83 -0
  102. alma/workflow/artifacts.py +170 -0
  103. alma/workflow/checkpoint.py +311 -0
  104. alma/workflow/context.py +228 -0
  105. alma/workflow/outcomes.py +189 -0
  106. alma/workflow/reducers.py +393 -0
  107. {alma_memory-0.5.1.dist-info → alma_memory-0.7.0.dist-info}/METADATA +210 -72
  108. alma_memory-0.7.0.dist-info/RECORD +112 -0
  109. alma_memory-0.5.1.dist-info/RECORD +0 -93
  110. {alma_memory-0.5.1.dist-info → alma_memory-0.7.0.dist-info}/WHEEL +0 -0
  111. {alma_memory-0.5.1.dist-info → alma_memory-0.7.0.dist-info}/top_level.txt +0 -0
alma/observability/__init__.py CHANGED
@@ -1,84 +1,91 @@
1
- """
2
- ALMA Observability Module.
3
-
4
- Provides comprehensive observability features including:
5
- - OpenTelemetry integration for distributed tracing
6
- - Structured JSON logging
7
- - Metrics collection (counters, histograms, gauges)
8
- - Performance monitoring
9
-
10
- This module follows the OpenTelemetry specification and supports
11
- integration with common observability backends (Jaeger, Prometheus,
12
- DataDog, etc.).
13
-
14
- Usage:
15
- from alma.observability import (
16
- get_tracer,
17
- get_meter,
18
- get_logger,
19
- configure_observability,
20
- ALMAMetrics,
21
- )
22
-
23
- # Initialize observability (typically at app startup)
24
- configure_observability(
25
- service_name="alma-memory",
26
- enable_tracing=True,
27
- enable_metrics=True,
28
- log_format="json",
29
- )
30
-
31
- # Use in code
32
- tracer = get_tracer(__name__)
33
- with tracer.start_as_current_span("my_operation"):
34
- # ... your code
35
- pass
36
- """
37
-
38
- from alma.observability.config import (
39
- ObservabilityConfig,
40
- configure_observability,
41
- shutdown_observability,
42
- )
43
- from alma.observability.logging import (
44
- JSONFormatter,
45
- StructuredLogger,
46
- get_logger,
47
- setup_logging,
48
- )
49
- from alma.observability.metrics import (
50
- ALMAMetrics,
51
- MetricsCollector,
52
- get_meter,
53
- get_metrics,
54
- )
55
- from alma.observability.tracing import (
56
- SpanKind,
57
- TracingContext,
58
- get_tracer,
59
- trace_async,
60
- trace_method,
61
- )
62
-
63
- __all__ = [
64
- # Configuration
65
- "ObservabilityConfig",
66
- "configure_observability",
67
- "shutdown_observability",
68
- # Logging
69
- "JSONFormatter",
70
- "StructuredLogger",
71
- "get_logger",
72
- "setup_logging",
73
- # Metrics
74
- "ALMAMetrics",
75
- "MetricsCollector",
76
- "get_meter",
77
- "get_metrics",
78
- # Tracing
79
- "SpanKind",
80
- "TracingContext",
81
- "get_tracer",
82
- "trace_method",
83
- "trace_async",
84
- ]
1
+ """
2
+ ALMA Observability Module.
3
+
4
+ Provides comprehensive observability features including:
5
+ - OpenTelemetry integration for distributed tracing
6
+ - Structured JSON logging
7
+ - Metrics collection (counters, histograms, gauges)
8
+ - Performance monitoring
9
+
10
+ This module follows the OpenTelemetry specification and supports
11
+ integration with common observability backends (Jaeger, Prometheus,
12
+ DataDog, etc.).
13
+
14
+ Usage:
15
+ from alma.observability import (
16
+ get_tracer,
17
+ get_meter,
18
+ get_logger,
19
+ configure_observability,
20
+ ALMAMetrics,
21
+ )
22
+
23
+ # Initialize observability (typically at app startup)
24
+ configure_observability(
25
+ service_name="alma-memory",
26
+ enable_tracing=True,
27
+ enable_metrics=True,
28
+ log_format="json",
29
+ )
30
+
31
+ # Use in code
32
+ tracer = get_tracer(__name__)
33
+ with tracer.start_as_current_span("my_operation"):
34
+ # ... your code
35
+ pass
36
+ """
37
+
38
+ from alma.observability.config import (
39
+ ObservabilityConfig,
40
+ configure_observability,
41
+ shutdown_observability,
42
+ )
43
+ from alma.observability.guidelines import (
44
+ OPERATION_LOG_LEVELS,
45
+ get_recommended_level,
46
+ )
47
+ from alma.observability.logging import (
48
+ JSONFormatter,
49
+ StructuredLogger,
50
+ get_logger,
51
+ setup_logging,
52
+ )
53
+ from alma.observability.metrics import (
54
+ ALMAMetrics,
55
+ MetricsCollector,
56
+ get_meter,
57
+ get_metrics,
58
+ )
59
+ from alma.observability.tracing import (
60
+ SpanKind,
61
+ TracingContext,
62
+ get_tracer,
63
+ trace_async,
64
+ trace_method,
65
+ )
66
+
67
+ __all__ = [
68
+ # Configuration
69
+ "ObservabilityConfig",
70
+ "configure_observability",
71
+ "shutdown_observability",
72
+ # Logging
73
+ "JSONFormatter",
74
+ "StructuredLogger",
75
+ "get_logger",
76
+ "setup_logging",
77
+ # Metrics
78
+ "ALMAMetrics",
79
+ "MetricsCollector",
80
+ "get_meter",
81
+ "get_metrics",
82
+ # Tracing
83
+ "SpanKind",
84
+ "TracingContext",
85
+ "get_tracer",
86
+ "trace_method",
87
+ "trace_async",
88
+ # Guidelines
89
+ "OPERATION_LOG_LEVELS",
90
+ "get_recommended_level",
91
+ ]