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/consolidation/prompts.py
CHANGED
|
@@ -1,84 +1,84 @@
|
|
|
1
|
-
"""
|
|
2
|
-
ALMA Consolidation Prompts.
|
|
3
|
-
|
|
4
|
-
LLM prompts for intelligently merging similar memories.
|
|
5
|
-
"""
|
|
6
|
-
|
|
7
|
-
# Prompt for merging multiple similar heuristics into one
|
|
8
|
-
MERGE_HEURISTICS_PROMPT = """You are a memory consolidation agent. Given these similar heuristics that have been identified as near-duplicates based on semantic similarity, create a single consolidated heuristic that captures the essence of all.
|
|
9
|
-
|
|
10
|
-
Similar Heuristics:
|
|
11
|
-
{heuristics}
|
|
12
|
-
|
|
13
|
-
Create a consolidated heuristic that:
|
|
14
|
-
1. Generalizes the condition to cover all cases
|
|
15
|
-
2. Combines the strategies into a comprehensive approach
|
|
16
|
-
3. Preserves any unique insights from individual heuristics
|
|
17
|
-
|
|
18
|
-
Output a JSON object with exactly these fields:
|
|
19
|
-
{{
|
|
20
|
-
"condition": "The generalized condition that triggers this heuristic",
|
|
21
|
-
"strategy": "The merged strategy combining all approaches",
|
|
22
|
-
"confidence": <average confidence as a float between 0 and 1>
|
|
23
|
-
}}
|
|
24
|
-
|
|
25
|
-
Only output the JSON object, no other text."""
|
|
26
|
-
|
|
27
|
-
# Prompt for merging similar domain knowledge
|
|
28
|
-
MERGE_DOMAIN_KNOWLEDGE_PROMPT = """You are a memory consolidation agent. Given these similar domain knowledge facts that have been identified as near-duplicates, create a single consolidated fact that captures all the information.
|
|
29
|
-
|
|
30
|
-
Similar Domain Knowledge:
|
|
31
|
-
{knowledge_items}
|
|
32
|
-
|
|
33
|
-
Create a consolidated fact that:
|
|
34
|
-
1. Combines all unique information
|
|
35
|
-
2. Removes redundancy
|
|
36
|
-
3. Maintains accuracy
|
|
37
|
-
|
|
38
|
-
Output a JSON object with exactly these fields:
|
|
39
|
-
{{
|
|
40
|
-
"fact": "The consolidated fact combining all information",
|
|
41
|
-
"confidence": <average confidence as a float between 0 and 1>
|
|
42
|
-
}}
|
|
43
|
-
|
|
44
|
-
Only output the JSON object, no other text."""
|
|
45
|
-
|
|
46
|
-
# Prompt for merging anti-patterns
|
|
47
|
-
MERGE_ANTI_PATTERNS_PROMPT = """You are a memory consolidation agent. Given these similar anti-patterns that have been identified as near-duplicates, create a single consolidated anti-pattern.
|
|
48
|
-
|
|
49
|
-
Similar Anti-Patterns:
|
|
50
|
-
{anti_patterns}
|
|
51
|
-
|
|
52
|
-
Create a consolidated anti-pattern that:
|
|
53
|
-
1. Generalizes the pattern description
|
|
54
|
-
2. Combines all reasons why it's bad
|
|
55
|
-
3. Provides a comprehensive alternative
|
|
56
|
-
|
|
57
|
-
Output a JSON object with exactly these fields:
|
|
58
|
-
{{
|
|
59
|
-
"pattern": "The generalized pattern to avoid",
|
|
60
|
-
"why_bad": "Combined explanation of why this pattern is problematic",
|
|
61
|
-
"better_alternative": "The recommended alternative approach"
|
|
62
|
-
}}
|
|
63
|
-
|
|
64
|
-
Only output the JSON object, no other text."""
|
|
65
|
-
|
|
66
|
-
# Prompt for merging outcomes (typically used for summarization rather than true merge)
|
|
67
|
-
MERGE_OUTCOMES_PROMPT = """You are a memory consolidation agent. Given these similar task outcomes, create a summary that captures the key learnings.
|
|
68
|
-
|
|
69
|
-
Similar Outcomes:
|
|
70
|
-
{outcomes}
|
|
71
|
-
|
|
72
|
-
Create a summary that:
|
|
73
|
-
1. Identifies the common task type
|
|
74
|
-
2. Notes the overall success/failure pattern
|
|
75
|
-
3. Highlights effective strategies
|
|
76
|
-
|
|
77
|
-
Output a JSON object with exactly these fields:
|
|
78
|
-
{{
|
|
79
|
-
"task_type": "The common task type",
|
|
80
|
-
"summary": "Summary of the outcomes and learnings",
|
|
81
|
-
"recommended_strategy": "The most effective strategy based on the outcomes"
|
|
82
|
-
}}
|
|
83
|
-
|
|
84
|
-
Only output the JSON object, no other text."""
|
|
1
|
+
"""
|
|
2
|
+
ALMA Consolidation Prompts.
|
|
3
|
+
|
|
4
|
+
LLM prompts for intelligently merging similar memories.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
# Prompt for merging multiple similar heuristics into one
|
|
8
|
+
MERGE_HEURISTICS_PROMPT = """You are a memory consolidation agent. Given these similar heuristics that have been identified as near-duplicates based on semantic similarity, create a single consolidated heuristic that captures the essence of all.
|
|
9
|
+
|
|
10
|
+
Similar Heuristics:
|
|
11
|
+
{heuristics}
|
|
12
|
+
|
|
13
|
+
Create a consolidated heuristic that:
|
|
14
|
+
1. Generalizes the condition to cover all cases
|
|
15
|
+
2. Combines the strategies into a comprehensive approach
|
|
16
|
+
3. Preserves any unique insights from individual heuristics
|
|
17
|
+
|
|
18
|
+
Output a JSON object with exactly these fields:
|
|
19
|
+
{{
|
|
20
|
+
"condition": "The generalized condition that triggers this heuristic",
|
|
21
|
+
"strategy": "The merged strategy combining all approaches",
|
|
22
|
+
"confidence": <average confidence as a float between 0 and 1>
|
|
23
|
+
}}
|
|
24
|
+
|
|
25
|
+
Only output the JSON object, no other text."""
|
|
26
|
+
|
|
27
|
+
# Prompt for merging similar domain knowledge
|
|
28
|
+
MERGE_DOMAIN_KNOWLEDGE_PROMPT = """You are a memory consolidation agent. Given these similar domain knowledge facts that have been identified as near-duplicates, create a single consolidated fact that captures all the information.
|
|
29
|
+
|
|
30
|
+
Similar Domain Knowledge:
|
|
31
|
+
{knowledge_items}
|
|
32
|
+
|
|
33
|
+
Create a consolidated fact that:
|
|
34
|
+
1. Combines all unique information
|
|
35
|
+
2. Removes redundancy
|
|
36
|
+
3. Maintains accuracy
|
|
37
|
+
|
|
38
|
+
Output a JSON object with exactly these fields:
|
|
39
|
+
{{
|
|
40
|
+
"fact": "The consolidated fact combining all information",
|
|
41
|
+
"confidence": <average confidence as a float between 0 and 1>
|
|
42
|
+
}}
|
|
43
|
+
|
|
44
|
+
Only output the JSON object, no other text."""
|
|
45
|
+
|
|
46
|
+
# Prompt for merging anti-patterns
|
|
47
|
+
MERGE_ANTI_PATTERNS_PROMPT = """You are a memory consolidation agent. Given these similar anti-patterns that have been identified as near-duplicates, create a single consolidated anti-pattern.
|
|
48
|
+
|
|
49
|
+
Similar Anti-Patterns:
|
|
50
|
+
{anti_patterns}
|
|
51
|
+
|
|
52
|
+
Create a consolidated anti-pattern that:
|
|
53
|
+
1. Generalizes the pattern description
|
|
54
|
+
2. Combines all reasons why it's bad
|
|
55
|
+
3. Provides a comprehensive alternative
|
|
56
|
+
|
|
57
|
+
Output a JSON object with exactly these fields:
|
|
58
|
+
{{
|
|
59
|
+
"pattern": "The generalized pattern to avoid",
|
|
60
|
+
"why_bad": "Combined explanation of why this pattern is problematic",
|
|
61
|
+
"better_alternative": "The recommended alternative approach"
|
|
62
|
+
}}
|
|
63
|
+
|
|
64
|
+
Only output the JSON object, no other text."""
|
|
65
|
+
|
|
66
|
+
# Prompt for merging outcomes (typically used for summarization rather than true merge)
|
|
67
|
+
MERGE_OUTCOMES_PROMPT = """You are a memory consolidation agent. Given these similar task outcomes, create a summary that captures the key learnings.
|
|
68
|
+
|
|
69
|
+
Similar Outcomes:
|
|
70
|
+
{outcomes}
|
|
71
|
+
|
|
72
|
+
Create a summary that:
|
|
73
|
+
1. Identifies the common task type
|
|
74
|
+
2. Notes the overall success/failure pattern
|
|
75
|
+
3. Highlights effective strategies
|
|
76
|
+
|
|
77
|
+
Output a JSON object with exactly these fields:
|
|
78
|
+
{{
|
|
79
|
+
"task_type": "The common task type",
|
|
80
|
+
"summary": "Summary of the outcomes and learnings",
|
|
81
|
+
"recommended_strategy": "The most effective strategy based on the outcomes"
|
|
82
|
+
}}
|
|
83
|
+
|
|
84
|
+
Only output the JSON object, no other text."""
|