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.
- alma/__init__.py +296 -226
- alma/compression/__init__.py +33 -0
- alma/compression/pipeline.py +980 -0
- alma/confidence/__init__.py +47 -47
- alma/confidence/engine.py +540 -540
- alma/confidence/types.py +351 -351
- alma/config/loader.py +157 -157
- alma/consolidation/__init__.py +23 -23
- alma/consolidation/engine.py +678 -678
- alma/consolidation/prompts.py +84 -84
- alma/core.py +1189 -430
- alma/domains/__init__.py +30 -30
- alma/domains/factory.py +359 -359
- alma/domains/schemas.py +448 -448
- alma/domains/types.py +272 -272
- alma/events/__init__.py +75 -75
- alma/events/emitter.py +285 -284
- alma/events/storage_mixin.py +246 -246
- alma/events/types.py +126 -126
- alma/events/webhook.py +425 -425
- alma/exceptions.py +49 -49
- alma/extraction/__init__.py +31 -31
- alma/extraction/auto_learner.py +265 -265
- alma/extraction/extractor.py +420 -420
- alma/graph/__init__.py +106 -106
- alma/graph/backends/__init__.py +32 -32
- alma/graph/backends/kuzu.py +624 -624
- alma/graph/backends/memgraph.py +432 -432
- alma/graph/backends/memory.py +236 -236
- alma/graph/backends/neo4j.py +417 -417
- alma/graph/base.py +159 -159
- alma/graph/extraction.py +198 -198
- alma/graph/store.py +860 -860
- alma/harness/__init__.py +35 -35
- alma/harness/base.py +386 -386
- alma/harness/domains.py +705 -705
- alma/initializer/__init__.py +37 -37
- alma/initializer/initializer.py +418 -418
- alma/initializer/types.py +250 -250
- alma/integration/__init__.py +62 -62
- alma/integration/claude_agents.py +444 -444
- alma/integration/helena.py +423 -423
- alma/integration/victor.py +471 -471
- alma/learning/__init__.py +101 -86
- alma/learning/decay.py +878 -0
- alma/learning/forgetting.py +1446 -1446
- alma/learning/heuristic_extractor.py +390 -390
- alma/learning/protocols.py +374 -374
- alma/learning/validation.py +346 -346
- alma/mcp/__init__.py +123 -45
- alma/mcp/__main__.py +156 -156
- alma/mcp/resources.py +122 -122
- alma/mcp/server.py +955 -591
- alma/mcp/tools.py +3254 -509
- alma/observability/__init__.py +91 -84
- alma/observability/config.py +302 -302
- alma/observability/guidelines.py +170 -0
- alma/observability/logging.py +424 -424
- alma/observability/metrics.py +583 -583
- alma/observability/tracing.py +440 -440
- alma/progress/__init__.py +21 -21
- alma/progress/tracker.py +607 -607
- alma/progress/types.py +250 -250
- alma/retrieval/__init__.py +134 -53
- alma/retrieval/budget.py +525 -0
- alma/retrieval/cache.py +1304 -1061
- alma/retrieval/embeddings.py +202 -202
- alma/retrieval/engine.py +850 -427
- alma/retrieval/modes.py +365 -0
- alma/retrieval/progressive.py +560 -0
- alma/retrieval/scoring.py +344 -344
- alma/retrieval/trust_scoring.py +637 -0
- alma/retrieval/verification.py +797 -0
- alma/session/__init__.py +19 -19
- alma/session/manager.py +442 -399
- alma/session/types.py +288 -288
- alma/storage/__init__.py +101 -90
- alma/storage/archive.py +233 -0
- alma/storage/azure_cosmos.py +1259 -1259
- alma/storage/base.py +1083 -583
- alma/storage/chroma.py +1443 -1443
- alma/storage/constants.py +103 -103
- alma/storage/file_based.py +614 -614
- alma/storage/migrations/__init__.py +21 -21
- alma/storage/migrations/base.py +321 -321
- alma/storage/migrations/runner.py +323 -323
- alma/storage/migrations/version_stores.py +337 -337
- alma/storage/migrations/versions/__init__.py +11 -11
- alma/storage/migrations/versions/v1_0_0.py +373 -373
- alma/storage/migrations/versions/v1_1_0_workflow_context.py +551 -0
- alma/storage/pinecone.py +1080 -1080
- alma/storage/postgresql.py +1948 -1559
- alma/storage/qdrant.py +1306 -1306
- alma/storage/sqlite_local.py +3041 -1457
- alma/testing/__init__.py +46 -46
- alma/testing/factories.py +301 -301
- alma/testing/mocks.py +389 -389
- alma/types.py +292 -264
- alma/utils/__init__.py +19 -0
- alma/utils/tokenizer.py +521 -0
- alma/workflow/__init__.py +83 -0
- alma/workflow/artifacts.py +170 -0
- alma/workflow/checkpoint.py +311 -0
- alma/workflow/context.py +228 -0
- alma/workflow/outcomes.py +189 -0
- alma/workflow/reducers.py +393 -0
- {alma_memory-0.5.1.dist-info → alma_memory-0.7.0.dist-info}/METADATA +210 -72
- alma_memory-0.7.0.dist-info/RECORD +112 -0
- alma_memory-0.5.1.dist-info/RECORD +0 -93
- {alma_memory-0.5.1.dist-info → alma_memory-0.7.0.dist-info}/WHEEL +0 -0
- {alma_memory-0.5.1.dist-info → alma_memory-0.7.0.dist-info}/top_level.txt +0 -0
alma/events/__init__.py
CHANGED
|
@@ -1,75 +1,75 @@
|
|
|
1
|
-
"""
|
|
2
|
-
ALMA Event System.
|
|
3
|
-
|
|
4
|
-
Provides event emission and webhook delivery for memory operations.
|
|
5
|
-
|
|
6
|
-
The event system allows external systems to react to memory changes through:
|
|
7
|
-
1. In-process callbacks (subscribe to event types)
|
|
8
|
-
2. Webhooks (HTTP delivery with signatures)
|
|
9
|
-
|
|
10
|
-
Example - In-process subscription:
|
|
11
|
-
```python
|
|
12
|
-
from alma.events import get_emitter, MemoryEventType
|
|
13
|
-
|
|
14
|
-
def on_memory_created(event):
|
|
15
|
-
print(f"Memory created: {event.memory_id}")
|
|
16
|
-
|
|
17
|
-
emitter = get_emitter()
|
|
18
|
-
emitter.subscribe(MemoryEventType.CREATED, on_memory_created)
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Example - Webhook delivery:
|
|
22
|
-
```python
|
|
23
|
-
from alma.events import WebhookConfig, WebhookManager, get_emitter
|
|
24
|
-
|
|
25
|
-
manager = WebhookManager()
|
|
26
|
-
manager.add_webhook(WebhookConfig(
|
|
27
|
-
url="https://example.com/webhook",
|
|
28
|
-
events=[MemoryEventType.CREATED, MemoryEventType.UPDATED],
|
|
29
|
-
secret="my-webhook-secret"
|
|
30
|
-
))
|
|
31
|
-
manager.start(get_emitter())
|
|
32
|
-
```
|
|
33
|
-
"""
|
|
34
|
-
|
|
35
|
-
from alma.events.emitter import (
|
|
36
|
-
EventEmitter,
|
|
37
|
-
get_emitter,
|
|
38
|
-
reset_emitter,
|
|
39
|
-
)
|
|
40
|
-
from alma.events.storage_mixin import (
|
|
41
|
-
EventAwareStorageMixin,
|
|
42
|
-
emit_on_save,
|
|
43
|
-
)
|
|
44
|
-
from alma.events.types import (
|
|
45
|
-
MemoryEvent,
|
|
46
|
-
MemoryEventType,
|
|
47
|
-
create_memory_event,
|
|
48
|
-
)
|
|
49
|
-
from alma.events.webhook import (
|
|
50
|
-
WebhookConfig,
|
|
51
|
-
WebhookDelivery,
|
|
52
|
-
WebhookDeliveryResult,
|
|
53
|
-
WebhookDeliveryStatus,
|
|
54
|
-
WebhookManager,
|
|
55
|
-
)
|
|
56
|
-
|
|
57
|
-
__all__ = [
|
|
58
|
-
# Types
|
|
59
|
-
"MemoryEvent",
|
|
60
|
-
"MemoryEventType",
|
|
61
|
-
"create_memory_event",
|
|
62
|
-
# Emitter
|
|
63
|
-
"EventEmitter",
|
|
64
|
-
"get_emitter",
|
|
65
|
-
"reset_emitter",
|
|
66
|
-
# Webhook
|
|
67
|
-
"WebhookConfig",
|
|
68
|
-
"WebhookDelivery",
|
|
69
|
-
"WebhookDeliveryResult",
|
|
70
|
-
"WebhookDeliveryStatus",
|
|
71
|
-
"WebhookManager",
|
|
72
|
-
# Storage Mixin
|
|
73
|
-
"EventAwareStorageMixin",
|
|
74
|
-
"emit_on_save",
|
|
75
|
-
]
|
|
1
|
+
"""
|
|
2
|
+
ALMA Event System.
|
|
3
|
+
|
|
4
|
+
Provides event emission and webhook delivery for memory operations.
|
|
5
|
+
|
|
6
|
+
The event system allows external systems to react to memory changes through:
|
|
7
|
+
1. In-process callbacks (subscribe to event types)
|
|
8
|
+
2. Webhooks (HTTP delivery with signatures)
|
|
9
|
+
|
|
10
|
+
Example - In-process subscription:
|
|
11
|
+
```python
|
|
12
|
+
from alma.events import get_emitter, MemoryEventType
|
|
13
|
+
|
|
14
|
+
def on_memory_created(event):
|
|
15
|
+
print(f"Memory created: {event.memory_id}")
|
|
16
|
+
|
|
17
|
+
emitter = get_emitter()
|
|
18
|
+
emitter.subscribe(MemoryEventType.CREATED, on_memory_created)
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Example - Webhook delivery:
|
|
22
|
+
```python
|
|
23
|
+
from alma.events import WebhookConfig, WebhookManager, get_emitter
|
|
24
|
+
|
|
25
|
+
manager = WebhookManager()
|
|
26
|
+
manager.add_webhook(WebhookConfig(
|
|
27
|
+
url="https://example.com/webhook",
|
|
28
|
+
events=[MemoryEventType.CREATED, MemoryEventType.UPDATED],
|
|
29
|
+
secret="my-webhook-secret"
|
|
30
|
+
))
|
|
31
|
+
manager.start(get_emitter())
|
|
32
|
+
```
|
|
33
|
+
"""
|
|
34
|
+
|
|
35
|
+
from alma.events.emitter import (
|
|
36
|
+
EventEmitter,
|
|
37
|
+
get_emitter,
|
|
38
|
+
reset_emitter,
|
|
39
|
+
)
|
|
40
|
+
from alma.events.storage_mixin import (
|
|
41
|
+
EventAwareStorageMixin,
|
|
42
|
+
emit_on_save,
|
|
43
|
+
)
|
|
44
|
+
from alma.events.types import (
|
|
45
|
+
MemoryEvent,
|
|
46
|
+
MemoryEventType,
|
|
47
|
+
create_memory_event,
|
|
48
|
+
)
|
|
49
|
+
from alma.events.webhook import (
|
|
50
|
+
WebhookConfig,
|
|
51
|
+
WebhookDelivery,
|
|
52
|
+
WebhookDeliveryResult,
|
|
53
|
+
WebhookDeliveryStatus,
|
|
54
|
+
WebhookManager,
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
__all__ = [
|
|
58
|
+
# Types
|
|
59
|
+
"MemoryEvent",
|
|
60
|
+
"MemoryEventType",
|
|
61
|
+
"create_memory_event",
|
|
62
|
+
# Emitter
|
|
63
|
+
"EventEmitter",
|
|
64
|
+
"get_emitter",
|
|
65
|
+
"reset_emitter",
|
|
66
|
+
# Webhook
|
|
67
|
+
"WebhookConfig",
|
|
68
|
+
"WebhookDelivery",
|
|
69
|
+
"WebhookDeliveryResult",
|
|
70
|
+
"WebhookDeliveryStatus",
|
|
71
|
+
"WebhookManager",
|
|
72
|
+
# Storage Mixin
|
|
73
|
+
"EventAwareStorageMixin",
|
|
74
|
+
"emit_on_save",
|
|
75
|
+
]
|