PyPI - empathy-framework - Versions diffs - 5.2.1__tar.gz → 5.3.0__tar.gz - Mend

empathy-framework 5.2.1tar.gz → 5.3.0tar.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 (777) hide show

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/CHANGELOG.md RENAMED Viewed

@@ -7,6 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
+## [5.3.0] - 2026-01-31
+### Added
+- **Agent Display Names**: Added optional `display_name` field to agent heartbeats for human-readable dashboard labels
+  - Backend: `display_name` parameter in `start_heartbeat()` and `beat()` methods
+  - API: Dashboard `/api/agents` endpoint returns display names
+  - Frontend: JavaScript lookup map translates agent IDs to display names across all sections
+  - Demo: Updated `dashboard_demo.py` to use descriptive names like "Code Analyzer", "Test Generator"
+- **Dashboard Help Panel**: Comprehensive slide-out help system explaining dashboard features
+  - 5 accordion sections: What is this dashboard, When needed, When NOT needed, Dashboard sections, Redis setup
+  - Emphasizes dashboard is optional for basic workflows
+  - Clear Redis installation instructions for Docker, macOS, Linux
+  - Improved accessibility with proper button type attributes
+### Changed
+- **Dashboard UX Improvements**:
+  - Changed "Source:" to "Source Agent:" in Event Stream for clarity
+  - Updated Redis status message to "Redis Requires Enabling" when Redis unavailable
+  - Display names now shown consistently across Active Agents, Event Stream, and Recent Signals
+  - Implemented date-based cache busting (`?v=20260131d`) for reliable browser updates
+### Documentation
+- Cleaned up root directory structure:
+  - Moved 8 batch/behavioral test summaries to `.archive/`
+  - Removed duplicate dashboard documentation files
+  - Moved historical testing session summary to `.archive/`
+- Updated README to accurately highlight flexible context routing (200K subscription + 1M API availability)
+- Added clear Redis requirement documentation for Agent Dashboard
 ## [5.2.1] - 2026-01-30
 ### Fixed

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 5.2.1
+Version: 5.3.0
 Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
 Author-email: Patrick Roebuck <admin@smartaimemory.com>
 Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
@@ -444,7 +444,7 @@ pip install empathy-framework[developer]
 **Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
 - **📦 Prompt Caching:** 90% cost reduction on repeated prompts
-- **📖 200K Context:** Largest context window available (vs 128K for competitors)
+- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
 - **🧠 Extended Thinking:** See Claude's internal reasoning process
 - **🔧 Advanced Tool Use:** Optimized for agentic workflows
@@ -458,6 +458,30 @@ pip install empathy-framework[developer]
 ---
+## What's New in v5.3.0
+**🎨 Dashboard Enhancements** - Improved usability and clarity:
+- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
+- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
+- **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
+- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
+**📚 Documentation Improvements**:
+- Clarified flexible context strategy (200K subscription + 1M API routing)
+- Added Redis requirement documentation for dashboard
+- Root directory cleanup (8 archived files)
+**🧪 Test Infrastructure**:
+- Sequential test execution to fix import timing issues
+- All agent tracking tests passing (19/19)
+[See Full Changelog](CHANGELOG.md#530---2026-01-31)
+---
 ## What's New in v5.1.0
 **🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
@@ -472,7 +496,7 @@ pip install empathy-framework[developer]
 - **Custom Agents** - Build specialized agents for your workflow needs
 - **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
-- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py`
+- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
 **🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
@@ -902,7 +926,7 @@ export ANTHROPIC_API_KEY="sk-ant-..."
 export OPENAI_API_KEY="sk-..."
 export GOOGLE_API_KEY="..."
-# Optional: Redis for memory
+# Optional (but required for Agent Dashboard): Redis for memory
 export REDIS_URL="redis://localhost:6379"
 ```

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/README.md RENAMED Viewed

@@ -21,7 +21,7 @@ pip install empathy-framework[developer]
 **Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
 - **📦 Prompt Caching:** 90% cost reduction on repeated prompts
-- **📖 200K Context:** Largest context window available (vs 128K for competitors)
+- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
 - **🧠 Extended Thinking:** See Claude's internal reasoning process
 - **🔧 Advanced Tool Use:** Optimized for agentic workflows
@@ -35,6 +35,30 @@ pip install empathy-framework[developer]
 ---
+## What's New in v5.3.0
+**🎨 Dashboard Enhancements** - Improved usability and clarity:
+- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
+- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
+- **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
+- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
+**📚 Documentation Improvements**:
+- Clarified flexible context strategy (200K subscription + 1M API routing)
+- Added Redis requirement documentation for dashboard
+- Root directory cleanup (8 archived files)
+**🧪 Test Infrastructure**:
+- Sequential test execution to fix import timing issues
+- All agent tracking tests passing (19/19)
+[See Full Changelog](CHANGELOG.md#530---2026-01-31)
+---
 ## What's New in v5.1.0
 **🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
@@ -49,7 +73,7 @@ pip install empathy-framework[developer]
 - **Custom Agents** - Build specialized agents for your workflow needs
 - **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
-- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py`
+- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
 **🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
@@ -479,7 +503,7 @@ export ANTHROPIC_API_KEY="sk-ant-..."
 export OPENAI_API_KEY="sk-..."
 export GOOGLE_API_KEY="..."
-# Optional: Redis for memory
+# Optional (but required for Agent Dashboard): Redis for memory
 export REDIS_URL="redis://localhost:6379"
 ```

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/empathy_framework.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 5.2.1
+Version: 5.3.0
 Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
 Author-email: Patrick Roebuck <admin@smartaimemory.com>
 Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
@@ -444,7 +444,7 @@ pip install empathy-framework[developer]
 **Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
 - **📦 Prompt Caching:** 90% cost reduction on repeated prompts
-- **📖 200K Context:** Largest context window available (vs 128K for competitors)
+- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
 - **🧠 Extended Thinking:** See Claude's internal reasoning process
 - **🔧 Advanced Tool Use:** Optimized for agentic workflows
@@ -458,6 +458,30 @@ pip install empathy-framework[developer]
 ---
+## What's New in v5.3.0
+**🎨 Dashboard Enhancements** - Improved usability and clarity:
+- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
+- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
+- **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
+- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
+**📚 Documentation Improvements**:
+- Clarified flexible context strategy (200K subscription + 1M API routing)
+- Added Redis requirement documentation for dashboard
+- Root directory cleanup (8 archived files)
+**🧪 Test Infrastructure**:
+- Sequential test execution to fix import timing issues
+- All agent tracking tests passing (19/19)
+[See Full Changelog](CHANGELOG.md#530---2026-01-31)
+---
 ## What's New in v5.1.0
 **🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
@@ -472,7 +496,7 @@ pip install empathy-framework[developer]
 - **Custom Agents** - Build specialized agents for your workflow needs
 - **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
-- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py`
+- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
 **🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
@@ -902,7 +926,7 @@ export ANTHROPIC_API_KEY="sk-ant-..."
 export OPENAI_API_KEY="sk-..."
 export GOOGLE_API_KEY="..."
-# Optional: Redis for memory
+# Optional (but required for Agent Dashboard): Redis for memory
 export REDIS_URL="redis://localhost:6379"
 ```

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/empathy_framework.egg-info/SOURCES.txt RENAMED Viewed

@@ -269,7 +269,6 @@ src/empathy_os/cache_monitor.py
 src/empathy_os/cache_stats.py
 src/empathy_os/cli_legacy.py
 src/empathy_os/cli_minimal.py
-src/empathy_os/cli_router 2.py
 src/empathy_os/cli_router.py
 src/empathy_os/cli_unified.py
 src/empathy_os/config.py
@@ -293,7 +292,6 @@ src/empathy_os/templates.py
 src/empathy_os/tier_recommender.py
 src/empathy_os/tools.py
 src/empathy_os/trust_building.py
-src/empathy_os/vscode_bridge 2.py
 src/empathy_os/vscode_bridge.py
 src/empathy_os/workflow_commands.py
 src/empathy_os/adaptive/__init__.py
@@ -329,7 +327,6 @@ src/empathy_os/cli/commands/utilities.py
 src/empathy_os/cli/commands/workflow.py
 src/empathy_os/cli/parsers/__init__.py
 src/empathy_os/cli/parsers/batch.py
-src/empathy_os/cli/parsers/cache 2.py
 src/empathy_os/cli/parsers/cache.py
 src/empathy_os/cli/parsers/help.py
 src/empathy_os/cli/parsers/info.py
@@ -351,11 +348,8 @@ src/empathy_os/config/__init__.py
 src/empathy_os/config/xml_config.py
 src/empathy_os/core_modules/__init__.py
 src/empathy_os/dashboard/__init__.py
-src/empathy_os/dashboard/app 2.py
 src/empathy_os/dashboard/app.py
-src/empathy_os/dashboard/simple_server 2.py
 src/empathy_os/dashboard/simple_server.py
-src/empathy_os/dashboard/standalone_server 2.py
 src/empathy_os/dashboard/standalone_server.py
 src/empathy_os/hot_reload/README.md
 src/empathy_os/hot_reload/__init__.py
@@ -423,7 +417,6 @@ src/empathy_os/metrics/collector.py
 src/empathy_os/metrics/prompt_metrics.py
 src/empathy_os/models/__init__.py
 src/empathy_os/models/__main__.py
-src/empathy_os/models/adaptive_routing 2.py
 src/empathy_os/models/adaptive_routing.py
 src/empathy_os/models/auth_cli.py
 src/empathy_os/models/auth_strategy.py
@@ -467,7 +460,6 @@ src/empathy_os/project_index/index.py
 src/empathy_os/project_index/models.py
 src/empathy_os/project_index/reports.py
 src/empathy_os/project_index/scanner.py
-src/empathy_os/project_index/scanner_parallel 2.py
 src/empathy_os/project_index/scanner_parallel.py
 src/empathy_os/prompts/__init__.py
 src/empathy_os/prompts/config.py
@@ -510,16 +502,11 @@ src/empathy_os/socratic/success.py
 src/empathy_os/socratic/visual_editor.py
 src/empathy_os/socratic/web_ui.py
 src/empathy_os/telemetry/__init__.py
-src/empathy_os/telemetry/agent_coordination 2.py
 src/empathy_os/telemetry/agent_coordination.py
-src/empathy_os/telemetry/agent_tracking 2.py
 src/empathy_os/telemetry/agent_tracking.py
-src/empathy_os/telemetry/approval_gates 2.py
 src/empathy_os/telemetry/approval_gates.py
 src/empathy_os/telemetry/cli.py
-src/empathy_os/telemetry/event_streaming 2.py
 src/empathy_os/telemetry/event_streaming.py
-src/empathy_os/telemetry/feedback_loop 2.py
 src/empathy_os/telemetry/feedback_loop.py
 src/empathy_os/telemetry/usage_tracker.py
 src/empathy_os/telemetry/commands/__init__.py
@@ -551,7 +538,6 @@ src/empathy_os/workflows/code_review_adapters.py
 src/empathy_os/workflows/code_review_pipeline.py
 src/empathy_os/workflows/config.py
 src/empathy_os/workflows/dependency_check.py
-src/empathy_os/workflows/document_gen.py
 src/empathy_os/workflows/document_manager.py
 src/empathy_os/workflows/document_manager_README.md
 src/empathy_os/workflows/documentation_orchestrator.py
@@ -606,21 +592,13 @@ src/empathy_os/workflows/keyboard_shortcuts/schema.py
 src/empathy_os/workflows/keyboard_shortcuts/workflow.py
 src/empathy_os/workflows/progressive/README 2.md
 src/empathy_os/workflows/progressive/README.md
-src/empathy_os/workflows/progressive/__init__ 2.py
 src/empathy_os/workflows/progressive/__init__.py
-src/empathy_os/workflows/progressive/cli 2.py
 src/empathy_os/workflows/progressive/cli.py
-src/empathy_os/workflows/progressive/core 2.py
 src/empathy_os/workflows/progressive/core.py
-src/empathy_os/workflows/progressive/orchestrator 2.py
 src/empathy_os/workflows/progressive/orchestrator.py
-src/empathy_os/workflows/progressive/reports 2.py
 src/empathy_os/workflows/progressive/reports.py
-src/empathy_os/workflows/progressive/telemetry 2.py
 src/empathy_os/workflows/progressive/telemetry.py
-src/empathy_os/workflows/progressive/test_gen 2.py
 src/empathy_os/workflows/progressive/test_gen.py
-src/empathy_os/workflows/progressive/workflow 2.py
 src/empathy_os/workflows/progressive/workflow.py
 src/empathy_os/workflows/test_gen/__init__.py
 src/empathy_os/workflows/test_gen/ast_analyzer.py
@@ -745,7 +723,6 @@ tests/test_sensor_parsers.py
 tests/test_session_status.py
 tests/test_short_term.py
 tests/test_smart_router.py
-tests/test_smoke 2.py
 tests/test_smoke.py
 tests/test_sonnet_opus_fallback.py
 tests/test_state.py

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/examples/dashboard_demo.py RENAMED Viewed

@@ -10,6 +10,18 @@ Licensed under Fair Source License 0.9
 import random
 import threading
 import time
+from pathlib import Path
+# Load environment variables from .env file
+try:
+    from dotenv import load_dotenv
+    # Load .env from project root
+    env_path = Path(__file__).parent.parent / ".env"
+    if env_path.exists():
+        load_dotenv(env_path)
+except ImportError:
+    pass  # dotenv not installed, will use system environment
 from empathy_os.telemetry import (
     ApprovalGate,
@@ -21,6 +33,46 @@ from empathy_os.telemetry import (
 from empathy_os.telemetry.feedback_loop import ModelTier
+def keep_agents_alive(memory):
+    """Continuously publish heartbeats to keep agents visible in dashboard.
+    Runs in background thread, updating agent heartbeats every 3 seconds.
+    """
+    agent_configs = {
+        "Code Analyzer": {"tasks": ["Analyzing code quality", "Running static analysis", "Checking dependencies"]},
+        "Test Generator": {"tasks": ["Generating unit tests", "Creating test fixtures", "Validating coverage"]},
+        "Refactoring Agent": {"tasks": ["Refactoring code", "Optimizing performance", "Improving readability"]},
+        "CI/CD Pipeline": {"tasks": ["Running CI/CD pipeline", "Deploying to staging", "Idle - awaiting tasks"]},
+        "System Monitor": {"tasks": ["Monitoring system health", "Processing metrics", "Generating reports"]},
+    }
+    coordinators = {}
+    for agent_id, config in agent_configs.items():
+        coordinator = HeartbeatCoordinator(memory=memory)
+        coordinator.start_heartbeat(
+            agent_id=f"agent-{list(agent_configs.keys()).index(agent_id) + 1}",  # Internal ID
+            display_name=agent_id,  # Display name for dashboard
+            metadata={"demo": True, "persistent": True}
+        )
+        coordinators[agent_id] = coordinator
+    while True:
+        for agent_id, config in agent_configs.items():
+            coordinator = coordinators[agent_id]
+            # Randomly vary status and progress for realistic simulation
+            status = random.choice(["running", "running", "running", "idle"])  # Bias toward "running"
+            progress = random.random()
+            current_task = random.choice(config["tasks"])
+            coordinator.beat(
+                status=status,
+                progress=progress,
+                current_task=current_task
+            )
+        time.sleep(3)  # Update heartbeats every 3 seconds
 def generate_test_data():
     """Generate test data for all dashboard patterns."""
     print("=" * 70)
@@ -28,30 +80,23 @@ def generate_test_data():
     print("=" * 70)
     print()
-    # Pattern 1: Agent Heartbeats
-    print("📊 Pattern 1: Creating test agent heartbeats...")
-    for i in range(5):
-        agent_id = f"agent-{i+1}"
-        coordinator = HeartbeatCoordinator()
-        status = random.choice(["running", "idle", "running", "running"])
-        progress = random.random()
-        tasks = [
-            "Analyzing code quality",
-            "Generating tests",
-            "Running validation",
-            "Processing workflow",
-            "Idle - awaiting tasks",
-        ]
-        # Start heartbeat and publish update
-        coordinator.start_heartbeat(agent_id=agent_id, metadata={"demo": True})
-        coordinator.beat(
-            status=status, progress=progress, current_task=random.choice(tasks)
-        )
+    # Initialize Redis memory backend for all patterns
+    try:
+        from empathy_os.memory.short_term import RedisShortTermMemory
-        print(f"  ✓ {agent_id}: {status} ({progress*100:.0f}%)")
+        memory = RedisShortTermMemory()
+        print("✅ Connected to Redis memory backend")
+        print()
+    except Exception as e:
+        print(f"❌ Failed to connect to Redis: {e}")
+        print("   Make sure Redis is running and REDIS_ENABLED=true in .env")
+        print()
+        return None
+    # Pattern 1: Agent Heartbeats (continuous in background)
+    print("📊 Pattern 1: Setting up continuous agent heartbeats...")
+    print("  ✓ 5 agents will publish heartbeats every 3 seconds")
+    print("  ✓ Agents: Code Analyzer, Test Generator, Refactoring Agent, CI/CD Pipeline, System Monitor")
     print()
     # Pattern 2: Coordination Signals
@@ -61,12 +106,13 @@ def generate_test_data():
         target = f"agent-{random.randint(1, 5)}"
         signal_types = ["status_update", "task_complete", "request_help", "acknowledge"]
-        signals = CoordinationSignals(agent_id=source)
+        signals = CoordinationSignals(memory=memory, agent_id=source)
         signals.signal(
             signal_type=random.choice(signal_types),
             source_agent=source,
             target_agent=target,
             payload={"message": f"Test signal {i+1}", "demo": True},
+            ttl_seconds=3600,  # 1 hour TTL for demo (default is 5 minutes)
         )
         print(f"  ✓ Signal: {source} → {target}")
@@ -75,7 +121,7 @@ def generate_test_data():
     # Pattern 4: Event Streaming
     print("📤 Pattern 4: Creating test events...")
-    streamer = EventStreamer()
+    streamer = EventStreamer(memory=memory)
     for i in range(15):
         event_types = ["workflow_progress", "agent_heartbeat", "coordination_signal"]
@@ -96,30 +142,39 @@ def generate_test_data():
     print()
-    # Pattern 5: Approval Requests (create in background to avoid blocking)
+    # Pattern 5: Approval Requests (create directly without blocking)
     print("✋ Pattern 5: Creating test approval requests...")
-    def create_approval():
-        gate = ApprovalGate(agent_id="demo-workflow")
-        # This will timeout after 60s if not approved
-        gate.request_approval(
-            approval_type=random.choice(["deploy_to_staging", "delete_old_data", "refactor_module"]),
-            context={"version": "1.0.0", "demo": True},
-            timeout=300.0,  # 5 minutes
-        )
+    # Create approval requests directly in Redis without blocking
+    gate = ApprovalGate(memory=memory, agent_id="demo-workflow")
+    # Manually store 2 approval requests without the blocking wait
+    from uuid import uuid4
+    from datetime import datetime
+    import json
-    # Create 2 approval requests in background
     for i in range(2):
-        thread = threading.Thread(target=create_approval, daemon=True)
-        thread.start()
-        time.sleep(0.5)  # Stagger creation
+        request_id = f"approval_{uuid4().hex[:8]}"
+        approval_data = {
+            "request_id": request_id,
+            "approval_type": random.choice(["deploy_to_staging", "delete_old_data", "refactor_module"]),
+            "agent_id": "demo-workflow",
+            "context": {"version": "1.0.0", "demo": True, "number": i+1},
+            "timestamp": datetime.utcnow().isoformat(),
+            "timeout_seconds": 300.0,
+            "status": "pending"
+        }
+        # Store in Redis (without empathy: prefix for approval gates)
+        request_key = f"approval_request:{request_id}"
+        memory._client.setex(request_key, 360, json.dumps(approval_data))
+        print(f"  ✓ Approval request {i+1}: {approval_data['approval_type']}")
-    print(f"  ✓ 2 approval requests created (will timeout in 5 minutes)")
     print()
     # Pattern 6: Quality Feedback
     print("📊 Pattern 6: Creating test quality feedback...")
-    feedback = FeedbackLoop()
+    feedback = FeedbackLoop(memory=memory)
     workflows = ["code-review", "test-generation", "refactoring"]
     stages = ["analysis", "generation", "validation"]
@@ -160,6 +215,8 @@ def generate_test_data():
     print("=" * 70)
     print()
+    return memory
 def run_dashboard_demo():
     """Run dashboard demo with test data."""
@@ -176,13 +233,21 @@ def run_dashboard_demo():
     # Generate test data
     try:
-        generate_test_data()
+        memory = generate_test_data()
+        if memory is None:
+            return  # Failed to connect to Redis
     except Exception as e:
         print(f"\n❌ Failed to generate test data: {e}")
         print("    Make sure Redis is running: redis-server")
         print("    Or run: empathy memory start")
         return
+    # Start background thread for continuous agent heartbeats
+    heartbeat_thread = threading.Thread(target=keep_agents_alive, args=(memory,), daemon=True)
+    heartbeat_thread.start()
+    print("🔄 Background thread started: Agents will remain active")
+    print()
     # Start dashboard
     print()
     print("=" * 70)
@@ -192,13 +257,14 @@ def run_dashboard_demo():
     print("📊 Dashboard will be available at: http://localhost:8000")
     print()
     print("💡 What you'll see:")
-    print("  • 5 active agents with heartbeats (Pattern 1)")
+    print("  • 5 active agents with live heartbeats (updating every 3s)")
     print("  • 10 coordination signals (Pattern 2)")
     print("  • 15 stream events (Pattern 4)")
     print("  • 2 pending approval requests (Pattern 5)")
     print("  • Quality metrics for 3 workflows × 3 stages × 3 tiers (Pattern 6)")
     print()
     print("🔄 Dashboard auto-refreshes every 5 seconds")
+    print("💓 Agent heartbeats update continuously in background")
     print()
     print("Press Ctrl+C to stop the server")
     print("=" * 70)

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "empathy-framework"
-version = "5.2.1"
+version = "5.3.0"
 description = "AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration."
 readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.10"

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/src/empathy_os/__init__.py RENAMED Viewed

@@ -55,7 +55,7 @@ Copyright 2025 Smart AI Memory, LLC
 Licensed under Fair Source 0.9
 """
-__version__ = "5.1.1"
+__version__ = "5.3.0"
 __author__ = "Patrick Roebuck"
 __email__ = "patrick.roebuck@smartaimemory.com"

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/src/empathy_os/cache/hybrid.py RENAMED Viewed

@@ -256,7 +256,11 @@ class HybridCache(BaseCache):
             return None
         if self._model is None:
-            raise RuntimeError("Sentence transformer model not loaded")
+            raise RuntimeError(
+                f"Sentence transformer model '{self.model_name}' not loaded. "
+                "Install required dependencies with: pip install empathy-framework[cache] "
+                "or pip install sentence-transformers torch"
+            )
         # Encode prompt
         prompt_embedding = self._model.encode(prompt, convert_to_numpy=True)

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/src/empathy_os/cli/commands/batch.py RENAMED Viewed

@@ -47,6 +47,8 @@ def cmd_batch_submit(args):
         api_key = os.getenv("ANTHROPIC_API_KEY")
         if not api_key:
             print("❌ Error: ANTHROPIC_API_KEY environment variable not set")
+            print("   Set it with: export ANTHROPIC_API_KEY='your-api-key-here'")
+            print("   Or get a key from: https://console.anthropic.com/")
             return 1
         # Load requests from file
@@ -100,6 +102,8 @@ def cmd_batch_status(args):
         api_key = os.getenv("ANTHROPIC_API_KEY")
         if not api_key:
             print("❌ Error: ANTHROPIC_API_KEY environment variable not set")
+            print("   Set it with: export ANTHROPIC_API_KEY='your-api-key-here'")
+            print("   Or get a key from: https://console.anthropic.com/")
             return 1
         workflow = BatchProcessingWorkflow(api_key=api_key)
@@ -154,6 +158,8 @@ def cmd_batch_results(args):
         api_key = os.getenv("ANTHROPIC_API_KEY")
         if not api_key:
             print("❌ Error: ANTHROPIC_API_KEY environment variable not set")
+            print("   Set it with: export ANTHROPIC_API_KEY='your-api-key-here'")
+            print("   Or get a key from: https://console.anthropic.com/")
             return 1
         workflow = BatchProcessingWorkflow(api_key=api_key)
@@ -214,6 +220,8 @@ def cmd_batch_wait(args):
         api_key = os.getenv("ANTHROPIC_API_KEY")
         if not api_key:
             print("❌ Error: ANTHROPIC_API_KEY environment variable not set")
+            print("   Set it with: export ANTHROPIC_API_KEY='your-api-key-here'")
+            print("   Or get a key from: https://console.anthropic.com/")
             return 1
         workflow = BatchProcessingWorkflow(api_key=api_key)

{empathy_framework-5.2.1 → empathy_framework-5.3.0}/src/empathy_os/cli/commands/profiling.py RENAMED Viewed

@@ -86,6 +86,8 @@ def memory_scan(
     if not scanner_path.exists():
         console.print("[red]Error:[/red] Memory leak scanner not found at expected path")
         console.print(f"Expected: {scanner_path}")
+        console.print("\nThe scanner script may have been moved or renamed.")
+        console.print("Check the scripts/ directory or reinstall the package.")
         raise typer.Exit(1)
     args = [sys.executable, str(scanner_path), "--path", str(path)]
@@ -135,6 +137,8 @@ def memory_test(
     if not profile_script.exists():
         console.print("[red]Error:[/red] Memory profiling script not found")
         console.print(f"Expected: {profile_script}")
+        console.print("\nInstall memory_profiler with: pip install memory-profiler")
+        console.print("Or check that the benchmarks directory exists.")
         raise typer.Exit(1)
     console.print(f"[bold]Profiling memory module: {module}[/bold]\n")

empathy-framework 5.2.1__tar.gz → 5.3.0__tar.gz

empathy-framework 5.2.1tar.gz → 5.3.0tar.gz