empathy-framework 3.8.1__py3-none-any.whl → 3.8.3__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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: empathy-framework
3
- Version: 3.8.1
3
+ Version: 3.8.3
4
4
  Summary: AI collaboration framework with intelligent caching (up to 57% cache hit rate), tier routing (34-86% cost savings depending on task complexity), XML-enhanced prompts, persistent memory, CrewAI integration, and multi-agent orchestration. Includes HIPAA-compliant healthcare wizards.
5
5
  Author-email: Patrick Roebuck <admin@smartaimemory.com>
6
6
  Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
@@ -371,7 +371,7 @@ pip install empathy-framework[developer] # Lightweight for individual developer
371
371
 
372
372
  ### 🎯 **Transparent Cost Claims: Honest Role-Based Savings (34-86%)**
373
373
 
374
- **Real savings depend on your work role.** Architects using 60% PREMIUM tasks see 34% savings, while junior devs see 86%. See [role-based analysis](docs/cost-analysis/COST_SAVINGS_BY_ROLE_AND_PROVIDER.md) for your specific case.
374
+ **Real savings depend on your work role.** Architects using 60% PREMIUM tasks see 34% savings, while junior devs see 86%. See [role-based analysis](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/cost-analysis/COST_SAVINGS_BY_ROLE_AND_PROVIDER.md) for your specific case.
375
375
 
376
376
  ### 🚀 **Intelligent Response Caching: Up to 57% Hit Rate (Benchmarked)**
377
377
 
@@ -388,7 +388,7 @@ cache = create_cache(cache_type="hash")
388
388
  cache = create_cache(cache_type="hybrid", similarity_threshold=0.95)
389
389
  ```
390
390
 
391
- See [caching docs](docs/caching/) for benchmarks and configuration.
391
+ See [caching docs](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/caching/) for benchmarks and configuration.
392
392
 
393
393
  ---
394
394
 
@@ -553,7 +553,7 @@ See ESLintParser, PylintParser, or MyPyParser for examples.
553
553
  - **34-86% Cost Savings** — Smart tier routing varies by role: architects 34%, senior devs 65%, junior devs 86%*
554
554
  - **VSCode Dashboard** — 10 integrated workflows with input history persistence
555
555
 
556
- *See [Cost Savings Analysis](docs/cost-analysis/COST_SAVINGS_BY_ROLE_AND_PROVIDER.md) for your specific use case
556
+ *See [Cost Savings Analysis](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/cost-analysis/COST_SAVINGS_BY_ROLE_AND_PROVIDER.md) for your specific use case
557
557
 
558
558
  ---
559
559
 
@@ -619,6 +619,26 @@ print(result.predicted_issues) # What will break in 30-90 days
619
619
  print(result.prevention_steps) # How to prevent it
620
620
  ```
621
621
 
622
+ ### 4. Track Your Savings
623
+
624
+ **New in v3.9.0:** Local usage telemetry tracks your actual cost savings vs baseline.
625
+
626
+ ```bash
627
+ # View recent usage
628
+ empathy telemetry show
629
+
630
+ # Calculate your savings vs all-PREMIUM baseline
631
+ empathy telemetry savings --days 30
632
+
633
+ # Compare time periods
634
+ empathy telemetry compare --period1 7 --period2 30
635
+
636
+ # Export for analysis
637
+ empathy telemetry export --format csv --output usage.csv
638
+ ```
639
+
640
+ **Privacy**: All data stored locally in `~/.empathy/telemetry/`. No data sent to external servers.
641
+
622
642
  ---
623
643
 
624
644
  ## Why Empathy?
@@ -709,13 +729,13 @@ Run 2: $0.13, 15 seconds - cache frees 30s for deep analysis
709
729
 
710
730
  **Result**: Cache makes workflows SMARTER, not just cheaper.
711
731
 
712
- See [Adaptive Workflows Documentation](docs/caching/ADAPTIVE_WORKFLOWS.md) for full explanation.
732
+ See [Adaptive Workflows Documentation](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/caching/ADAPTIVE_WORKFLOWS.md) for full explanation.
713
733
 
714
734
  #### Complete Documentation
715
735
 
716
- - **[Quick Reference](docs/caching/QUICK_REFERENCE.md)** - Common scenarios, 1-page cheat sheet
717
- - **[Configuration Guide](docs/caching/CONFIGURATION_GUIDE.md)** - All options, when to use each
718
- - **[Adaptive Workflows](docs/caching/ADAPTIVE_WORKFLOWS.md)** - Why Run 2 can cost more (it's good!)
736
+ - **[Quick Reference](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/caching/QUICK_REFERENCE.md)** - Common scenarios, 1-page cheat sheet
737
+ - **[Configuration Guide](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/caching/CONFIGURATION_GUIDE.md)** - All options, when to use each
738
+ - **[Adaptive Workflows](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/caching/ADAPTIVE_WORKFLOWS.md)** - Why Run 2 can cost more (it's good!)
719
739
 
720
740
  **Test it yourself**:
721
741
  ```bash
@@ -770,7 +790,7 @@ python -m empathy_os.models.cli provider --set hybrid
770
790
  | **QA Engineer** | 10% | 35% | 55% | **80%** | Test generation, reports, automation |
771
791
  | **DevOps Engineer** | 20% | 50% | 30% | **69%** | Infrastructure planning + automation |
772
792
 
773
- **See [Complete Cost Analysis](docs/cost-analysis/COST_SAVINGS_BY_ROLE_AND_PROVIDER.md) for provider comparisons (Anthropic vs OpenAI vs Ollama) and detailed calculations.**
793
+ **See [Complete Cost Analysis](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/docs/cost-analysis/COST_SAVINGS_BY_ROLE_AND_PROVIDER.md) for provider comparisons (Anthropic vs OpenAI vs Ollama) and detailed calculations.**
774
794
 
775
795
  ### Level 3: Multi-Model Workflows
776
796
 
@@ -1160,10 +1180,10 @@ echo 'ANTHROPIC_API_KEY=sk-ant-...' >> .env
1160
1180
 
1161
1181
  For those interested in the development history and architectural decisions:
1162
1182
 
1163
- - **[Development Logs](docs/development-logs/)** — Execution plans, phase completions, and progress tracking
1164
- - **[Architecture Docs](docs/architecture/)** — System design, memory architecture, and integration plans
1165
- - **[Marketing Materials](docs/marketing/)** — Pitch decks, outreach templates, and commercial readiness
1166
- - **[Guides](docs/guides/)** — Publishing tutorials, MkDocs setup, and distribution policies
1183
+ - **[Development Logs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/development-logs/)** — Execution plans, phase completions, and progress tracking
1184
+ - **[Architecture Docs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/architecture/)** — System design, memory architecture, and integration plans
1185
+ - **[Marketing Materials](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/marketing/)** — Pitch decks, outreach templates, and commercial readiness
1186
+ - **[Guides](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/guides/)** — Publishing tutorials, MkDocs setup, and distribution policies
1167
1187
 
1168
1188
  ---
1169
1189
 
@@ -20,7 +20,7 @@ coach_wizards/refactoring_wizard.py,sha256=X0MTx3BHpOlOMAYDow-3HX5GyryY70JGAF5vA
20
20
  coach_wizards/scaling_wizard.py,sha256=n1RLtpWmj1RSEGSWssMiUPwCdpskO3z2Z3yhLlTdXro,2598
21
21
  coach_wizards/security_wizard.py,sha256=19SOClSxo6N-QqUc_QsFXOE7yEquiZF4kLi7jRomA7g,2605
22
22
  coach_wizards/testing_wizard.py,sha256=vKFgFG4uJfAVFmCIQbkrWNvZhIfLC6ve_XbvWZKrPg4,2563
23
- empathy_framework-3.8.1.dist-info/licenses/LICENSE,sha256=IJ9eeI5KSrD5P7alsn7sI_6_1bDihxBA5S4Sen4jf2k,4937
23
+ empathy_framework-3.8.3.dist-info/licenses/LICENSE,sha256=IJ9eeI5KSrD5P7alsn7sI_6_1bDihxBA5S4Sen4jf2k,4937
24
24
  empathy_healthcare_plugin/__init__.py,sha256=4NioL1_86UXzkd-QNkQZUSZ8rKTQGSP0TC9VXP32kQs,295
25
25
  empathy_healthcare_plugin/monitors/__init__.py,sha256=Udp8qfZR504QAq5_eQjvtIaE7v06Yguc7nuF40KllQc,196
26
26
  empathy_healthcare_plugin/monitors/clinical_protocol_monitor.py,sha256=GkNh2Yuw9cvuKuPh3mriWtKJZFq_sTxBD7Ci8lFV9gQ,11620
@@ -58,7 +58,7 @@ empathy_llm_toolkit/agent_factory/adapters/__init__.py,sha256=VCyzcH0fX26-73MORF
58
58
  empathy_llm_toolkit/agent_factory/adapters/autogen_adapter.py,sha256=8dmY1QpBLVNpv6rSFTVER4yZigH6yxw1v0ABin7IFzk,10951
59
59
  empathy_llm_toolkit/agent_factory/adapters/crewai_adapter.py,sha256=Ood-03g3_WqtcsnlsuHcq6QOdyUA_eVxmZNZ5xhUIM0,16056
60
60
  empathy_llm_toolkit/agent_factory/adapters/haystack_adapter.py,sha256=dtZaSzs_aUyt6Ik2MFlCIzpZpXUG6quUN5QRPUiivsM,10228
61
- empathy_llm_toolkit/agent_factory/adapters/langchain_adapter.py,sha256=0S9NoIdeGzSo1FKYItzcXJ_oNI8osZ1PKutxr13dY6U,13227
61
+ empathy_llm_toolkit/agent_factory/adapters/langchain_adapter.py,sha256=wGs61xLpS8rU5hdzctj4hiMee2HSZGYTo1OJE_2df9A,13225
62
62
  empathy_llm_toolkit/agent_factory/adapters/langgraph_adapter.py,sha256=9KWbe572uXcg1djs1FbIaPcBV-H9mIjEEGLas8SH72M,11553
63
63
  empathy_llm_toolkit/agent_factory/adapters/native.py,sha256=lCpR6kvVIlTzbYs3jgMDgSTx364Nxg0_XNy66iE3vl4,7727
64
64
  empathy_llm_toolkit/agent_factory/adapters/wizard_adapter.py,sha256=Qy4_SCQOJU-CUvUIwQoOR66Ji37ICI0CNzy7Oc8Db7c,13326
@@ -93,7 +93,7 @@ empathy_llm_toolkit/wizards/healthcare_wizard.py,sha256=zIdeXqS5jPTRFhUTi0MyPYqh
93
93
  empathy_llm_toolkit/wizards/patient_assessment_README.md,sha256=DInK_x7LgM8Qi9YSHgXtm7_sQupioJRf0M43_vml4ck,1586
94
94
  empathy_llm_toolkit/wizards/patient_assessment_wizard.py,sha256=dsvoOq0AYCBigmn6HPoaSBnBPk9YV7IzAFZkJYx1iZQ,5423
95
95
  empathy_llm_toolkit/wizards/technology_wizard.py,sha256=8hQirzzGQp7UVtj1hFCoaoLLtqAtx9HFf4mdUWV1xH0,7533
96
- empathy_os/__init__.py,sha256=Wo1dH8xdalai4janV1Y8E7YMiAy4PsBEHgX4yeElj6w,7069
96
+ empathy_os/__init__.py,sha256=29Xhv1VoZUwu7HTEHeVzjMtkWbyHaAcbUh4eZSQKJnU,5896
97
97
  empathy_os/agent_monitoring.py,sha256=s4seLC_J4AtQ3PYWrRPO8YHM-Fbm0Q36kPEdlTHf2HI,13375
98
98
  empathy_os/cli.py,sha256=6gTjhG35PoG1KmRmaW3nQW-lm52S3UhVhDtSR21jvKo,99330
99
99
  empathy_os/cli_unified.py,sha256=7W0WU-bL71P4GWRURTH513gAEKqCn3GLpfeWLnQlLS0,19376
@@ -326,8 +326,8 @@ workflow_scaffolding/__init__.py,sha256=UpX5vjjjPjIaAKyIV1D4GxJzLUZy5DzdzgSkePYM
326
326
  workflow_scaffolding/__main__.py,sha256=0qspuNoadTDqyskXTlT8Sahqau-XIxN35NHTSGVW6z4,236
327
327
  workflow_scaffolding/cli.py,sha256=R4rCTDENRMil2c3v32MnisqteFRDfilS6RHBNlYV39Q,6752
328
328
  workflow_scaffolding/generator.py,sha256=whWbBmWEA0rN3M3X9EzTjfbwBxHcF40Jin8-nbj0S0E,8858
329
- empathy_framework-3.8.1.dist-info/METADATA,sha256=Wb0_Me2BAYnFSuXbddG0mg4ksxR27aNYwbifJ8eWpks,46740
330
- empathy_framework-3.8.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
331
- empathy_framework-3.8.1.dist-info/entry_points.txt,sha256=zMu7sKCiLndbEEXjTecltS-1P_JZoEUKrifuRBBbroc,1268
332
- empathy_framework-3.8.1.dist-info/top_level.txt,sha256=KmPrj9gMAqXeKLPLp3VEAPDTNDE-LQjET3Ew3LU8sbs,180
333
- empathy_framework-3.8.1.dist-info/RECORD,,
329
+ empathy_framework-3.8.3.dist-info/METADATA,sha256=CgmidjdD_CZJdO8lKr9ecdxqBMWHPUzdcQlaghtOU2k,48007
330
+ empathy_framework-3.8.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
331
+ empathy_framework-3.8.3.dist-info/entry_points.txt,sha256=zMu7sKCiLndbEEXjTecltS-1P_JZoEUKrifuRBBbroc,1268
332
+ empathy_framework-3.8.3.dist-info/top_level.txt,sha256=KmPrj9gMAqXeKLPLp3VEAPDTNDE-LQjET3Ew3LU8sbs,180
333
+ empathy_framework-3.8.3.dist-info/RECORD,,
@@ -252,7 +252,7 @@ class LangChainAdapter(BaseAdapter):
252
252
  # In langchain 1.x, these moved to different locations
253
253
  try:
254
254
  # Try langchain 1.x imports first
255
- from langchain.agents import create_tool_calling_agent # type: ignore[attr-defined]
255
+ from langchain.agents import create_tool_calling_agent
256
256
  from langchain.agents.agent import AgentExecutor
257
257
  except (ImportError, AttributeError):
258
258
  # Fall back to langgraph for newer versions
@@ -262,7 +262,7 @@ class LangChainAdapter(BaseAdapter):
262
262
 
263
263
  create_tool_calling_agent: Any = create_react_agent # type: ignore[no-redef]
264
264
  except ImportError:
265
- create_tool_calling_agent = None
265
+ create_tool_calling_agent = None # type: ignore[assignment]
266
266
  from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
267
267
 
268
268
  llm = self._get_llm(config)
empathy_os/__init__.py CHANGED
@@ -55,33 +55,33 @@ Copyright 2025 Smart AI Memory, LLC
55
55
  Licensed under Fair Source 0.9
56
56
  """
57
57
 
58
- __version__ = "3.8.1"
58
+ __version__ = "3.8.3"
59
59
  __author__ = "Patrick Roebuck"
60
60
  __email__ = "hello@deepstudy.ai"
61
61
 
62
62
  from .agent_monitoring import AgentMetrics, AgentMonitor, TeamMetrics
63
63
  from .config import EmpathyConfig, load_config
64
64
  from .coordination import (
65
- AgentCoordinator,
66
- AgentTask,
67
- ConflictResolver,
68
- ResolutionResult,
69
- ResolutionStrategy,
70
- TeamPriorities,
71
- TeamSession,
65
+ AgentCoordinator,
66
+ AgentTask,
67
+ ConflictResolver,
68
+ ResolutionResult,
69
+ ResolutionStrategy,
70
+ TeamPriorities,
71
+ TeamSession,
72
72
  )
73
73
  from .core import EmpathyOS
74
74
  from .emergence import EmergenceDetector
75
75
  from .exceptions import (
76
- CollaborationStateError,
77
- ConfidenceThresholdError,
78
- EmpathyFrameworkError,
79
- EmpathyLevelError,
80
- FeedbackLoopError,
81
- LeveragePointError,
82
- PatternNotFoundError,
83
- TrustThresholdError,
84
- ValidationError,
76
+ CollaborationStateError,
77
+ ConfidenceThresholdError,
78
+ EmpathyFrameworkError,
79
+ EmpathyLevelError,
80
+ FeedbackLoopError,
81
+ LeveragePointError,
82
+ PatternNotFoundError,
83
+ TrustThresholdError,
84
+ ValidationError,
85
85
  )
86
86
  from .feedback_loops import FeedbackLoopDetector
87
87
  from .levels import Level1Reactive, Level2Guided, Level3Proactive, Level4Anticipatory, Level5Systems
@@ -90,41 +90,41 @@ from .logging_config import LoggingConfig, get_logger
90
90
 
91
91
  # Memory module (unified short-term + long-term + security)
92
92
  from .memory import (
93
- AccessTier,
94
- AgentCredentials, # Memory module imports
95
- AuditEvent,
96
- AuditLogger,
97
- Classification,
98
- ClassificationRules,
99
- ClaudeMemoryConfig,
100
- ClaudeMemoryLoader,
101
- ConflictContext,
102
- EncryptionManager,
103
- Environment,
104
- MemDocsStorage,
105
- MemoryConfig,
106
- MemoryPermissionError,
107
- PatternMetadata,
108
- PIIDetection,
109
- PIIPattern,
110
- PIIScrubber,
111
- RedisShortTermMemory,
112
- SecretDetection,
113
- SecretsDetector,
114
- SecretType,
115
- SecureMemDocsIntegration,
116
- SecurePattern,
117
- SecurityError,
118
- SecurityViolation,
119
- Severity,
120
- StagedPattern,
121
- TTLStrategy,
122
- UnifiedMemory,
123
- check_redis_connection,
124
- detect_secrets,
125
- get_railway_redis,
126
- get_redis_config,
127
- get_redis_memory,
93
+ AccessTier,
94
+ AgentCredentials, # Memory module imports
95
+ AuditEvent,
96
+ AuditLogger,
97
+ Classification,
98
+ ClassificationRules,
99
+ ClaudeMemoryConfig,
100
+ ClaudeMemoryLoader,
101
+ ConflictContext,
102
+ EncryptionManager,
103
+ Environment,
104
+ MemDocsStorage,
105
+ MemoryConfig,
106
+ MemoryPermissionError,
107
+ PatternMetadata,
108
+ PIIDetection,
109
+ PIIPattern,
110
+ PIIScrubber,
111
+ RedisShortTermMemory,
112
+ SecretDetection,
113
+ SecretsDetector,
114
+ SecretType,
115
+ SecureMemDocsIntegration,
116
+ SecurePattern,
117
+ SecurityError,
118
+ SecurityViolation,
119
+ Severity,
120
+ StagedPattern,
121
+ TTLStrategy,
122
+ UnifiedMemory,
123
+ check_redis_connection,
124
+ detect_secrets,
125
+ get_railway_redis,
126
+ get_redis_config,
127
+ get_redis_memory,
128
128
  )
129
129
  from .pattern_library import Pattern, PatternLibrary, PatternMatch
130
130
  from .persistence import MetricsCollector, PatternPersistence, StateManager