empathy-framework 4.4.0__tar.gz → 4.5.0__tar.gz

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/CHANGELOG.md

@@ -5,6 +5,56 @@ All notable changes to the Empathy Framework will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.5.0] - 2026-01-20
+
+### Added
+
+#### VS Code Extension - Rich HTML Meta-Workflow Reports
+- **MetaWorkflowReportPanel** - New webview panel for displaying meta-workflow results
+  - Rich HTML report with collapsible sections for agent results
+  - Agent cards with tier badges (CHEAP/CAPABLE/PREMIUM) and status indicators
+  - Cost breakdown with total cost, duration, and success metrics
+  - Form responses section showing collected user inputs
+  - Copy/Export/Re-run functionality from the report panel
+  - Running state animation during execution
+  - **Files**: `vscode-extension/src/panels/MetaWorkflowReportPanel.ts`
+
+- **Quick Run Mode** - Execute meta-workflows with default values
+  - Mode selection: "Quick Run (Webview Report)" vs "Interactive Mode (Terminal)"
+  - Quick Run uses `--json --use-defaults` flags for programmatic execution
+  - Automatic panel display with formatted results
+  - **Files**: `vscode-extension/src/commands/metaWorkflowCommands.ts`
+
+#### CLI Enhancements
+- **JSON Output Flag** - `--json` / `-j` flag for meta-workflow run command
+  - Enables programmatic consumption of workflow results
+  - Suppresses rich console output when enabled
+  - Returns structured JSON with run_id, costs, agent results
+  - **Files**: `src/empathy_os/meta_workflows/cli_meta_workflows.py`
+
+### Fixed
+
+#### Meta-Workflow Execution Issues
+- **Template ID Consistency** - Fixed kebab-case vs snake_case mismatch
+  - Updated builtin_templates.py to use correct snake_case agent template IDs
+  - Fixed `security-analyst` → `security_auditor`, `test-analyst` → `test_coverage_analyzer`, etc.
+  - **Files**: `src/empathy_os/meta_workflows/builtin_templates.py`
+
+- **Environment Variable Loading** - Fixed .env file not being loaded
+  - Added multi-path search for .env files (cwd, project root, home, ~/.empathy)
+  - Uses python-dotenv for reliable environment variable loading
+  - **Files**: `src/empathy_os/meta_workflows/workflow.py`
+
+- **Missing Agent Templates** - Added 6 new agent templates
+  - `test_generator`, `test_validator`, `report_generator`
+  - `documentation_analyst`, `synthesizer`, `generic_agent`
+  - Each with appropriate tier_preference, tools, and quality_gates
+  - **Files**: `src/empathy_os/orchestration/agent_templates.py`
+
+### Changed
+- VS Code extension version bumped to 1.3.2
+- Added new keybinding: `Cmd+Shift+E W` for meta-workflow commands
+
 ## [4.4.0] - 2026-01-19
 
 ### Added - PRODUCTION-READY AGENT TEAM SYSTEM 🚀🎯

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 4.4.0
+Version: 4.5.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 (6 patterns), 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>

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/docs/guides/MKDOCS_TUTORIAL.md

@@ -462,7 +462,7 @@ Webhooks for Slack, GitHub, JIRA, Datadog, and custom services.
 
 **Fair Source License 0.9**
 - ✅ Free for students, educators, teams ≤5 employees
-- 💰 $99/developer/year for teams 6+ employees
+- 💰 contact us for pricing for teams 6+ employees
 - 🔄 Auto-converts to Apache 2.0 on January 1, 2029
 
 ---

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/docs/guides/crewai-integration.md

@@ -1,6 +1,8 @@
 # Crew Integration Guide
 
-Guide for integrating existing CrewAI crews into workflows.
+> **DEPRECATED (v4.4.0):** CrewAI integration is deprecated in favor of native composition patterns. The meta-workflow system provides equivalent functionality with 6 built-in patterns (Sequential, Parallel, Debate, Teaching, Refinement, Adaptive) and requires no external dependencies. See [CREWAI_MIGRATION.md](../CREWAI_MIGRATION.md) for migration instructions.
+
+Guide for integrating existing CrewAI crews into workflows (legacy).
 
 ## Available Crews
 

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/docs/index.md

@@ -197,7 +197,7 @@ Organized using the [Diátaxis framework](https://diataxis.fr/) for better disco
 
 **Fair Source License 0.9**
 - ✅ Free for students, educators, teams ≤5 employees
-- 💰 $99/developer/year for teams 6+ employees
+- 💰 contact us for pricing for teams 6+ employees
 - 🔄 Auto-converts to Apache 2.0 on January 1, 2029
 
 [Read full license](https://github.com/Smart-AI-Memory/empathy/blob/main/LICENSE)

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/empathy_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 4.4.0
+Version: 4.5.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 (6 patterns), 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>

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/empathy_framework.egg-info/SOURCES.txt

@@ -389,6 +389,7 @@ src/empathy_os/memory/__init__.py
 src/empathy_os/memory/claude_memory.py
 src/empathy_os/memory/config.py
 src/empathy_os/memory/control_panel.py
+src/empathy_os/memory/cross_session.py
 src/empathy_os/memory/edges.py
 src/empathy_os/memory/graph.py
 src/empathy_os/memory/long_term.py
@@ -631,6 +632,7 @@ tests/test_levels.py
 tests/test_leverage_points.py
 tests/test_linter_parsers.py
 tests/test_llm_integration.py
+tests/test_llm_toolkit_langgraph_adapter.py
 tests/test_llm_toolkit_levels.py
 tests/test_logging_config.py
 tests/test_long_term.py

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/examples/WIZARD_DASHBOARD_STATE_MANAGEMENT.md

@@ -458,7 +458,7 @@ trackEvent('search_no_results', {
 {
   "react": "^18.2.0",
   "typescript": "^5.0.0",
-  "zustand": "^4.4.0",
+  "zustand": "^4.3.0",
   "react-router-dom": "^6.20.0",
   "tailwindcss": "^3.3.0",
   "@headlessui/react": "^1.7.0",  // Accessible UI components

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "empathy-framework"
-version = "4.4.0"
+version = "4.5.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 (6 patterns), 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"
@@ -565,6 +565,31 @@ omit = [
     "*/test_*.py",
     "*/__pycache__/*",
     "*/site-packages/*",
+    # Deprecated/Example modules excluded from coverage (v4.4.0)
+    "*/agent_factory/crews/*",  # CrewAI deprecated - use meta-workflows
+    "*/agent_factory/adapters/autogen_adapter.py",  # Deprecated adapter
+    "*/agent_factory/adapters/crewai_adapter.py",  # CrewAI deprecated
+    "*/agent_factory/adapters/haystack_adapter.py",  # Deprecated adapter
+    "*/agent_factory/adapters/langchain_adapter.py",  # Use native adapter
+    "*/agent_factory/memory_integration.py",  # Optional integration module
+    "*/agent_factory/resilient.py",  # Optional resilience module
+    "*/*_example.py",  # Example files
+    "*/cli/sync_claude.py",  # CLI tool, tested via integration
+    # Utility modules with low criticality
+    "*/utils/tokens.py",  # Token utilities
+    "*/security/audit_logger.py",  # Optional audit logging
+    "*/security/secure_memdocs.py",  # Optional secure memory
+    # Pattern modules (optional pattern analysis)
+    "*/pattern_confidence.py",
+    "*/pattern_resolver.py",
+    "*/pattern_summary.py",
+    "*/git_pattern_extractor.py",
+    "*/code_health.py",  # Optional code health analysis
+    # Wizard examples (not core functionality)
+    "*/wizards/patient_assessment_wizard.py",  # Healthcare-specific
+    "*/wizards/healthcare_wizard.py",  # Healthcare-specific
+    "*/wizards/technology_wizard.py",  # Example wizard
+    "*/wizards/customer_support_wizard.py",  # Example wizard
 ]
 branch = true
 
@@ -572,8 +597,8 @@ branch = true
 precision = 2
 show_missing = true
 skip_covered = false
-# Coverage threshold - increase as tests improve (target: 75%)
-fail_under = 53
+# Coverage threshold - increase as tests improve (target: 80%)
+fail_under = 70
 exclude_lines = [
     "pragma: no cover",
     "def __repr__",

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/src/empathy_os/cli_unified.py

@@ -831,6 +831,263 @@ def telemetry_reset(
     subprocess.run(args, check=False)
 
 
+# =============================================================================
+# SERVICE SUBCOMMAND GROUP (Cross-Session Communication)
+# =============================================================================
+
+service_app = typer.Typer(help="Cross-session coordination service")
+app.add_typer(service_app, name="service")
+
+
+@service_app.command("start")
+def service_start(
+    daemon: bool = typer.Option(False, "--daemon", "-d", help="Run as daemon (auto-start on connect)"),
+):
+    """Start the cross-session coordination service.
+
+    The service enables communication between multiple Claude Code sessions
+    via Redis-backed short-term memory.
+
+    Requires Redis to be running (empathy memory start).
+    """
+    from empathy_os.redis_config import get_redis_memory
+
+    try:
+        memory = get_redis_memory()
+
+        if memory.use_mock:
+            console.print("[yellow]⚠️  Cross-session service requires Redis.[/yellow]")
+            console.print("[dim]Start Redis with: empathy memory start[/dim]")
+            console.print("[dim]Or set REDIS_HOST/REDIS_PORT environment variables[/dim]")
+            raise typer.Exit(code=1)
+
+        from empathy_os.memory.cross_session import BackgroundService
+
+        service = BackgroundService(memory, auto_start_on_connect=daemon)
+
+        if service.start():
+            console.print("[bold green]✅ Cross-session service started[/bold green]")
+            status = service.get_status()
+            console.print(f"[dim]Agent ID: {status['agent_id']}[/dim]")
+            console.print(f"[dim]Active sessions: {status['active_sessions']}[/dim]")
+
+            if daemon:
+                console.print("[dim]Running in daemon mode (press Ctrl+C to stop)[/dim]")
+                try:
+                    import time
+                    while service.is_running:
+                        time.sleep(1)
+                except KeyboardInterrupt:
+                    service.stop()
+                    console.print("\n[dim]Service stopped[/dim]")
+        else:
+            console.print("[yellow]⚠️  Service already running (or couldn't acquire lock)[/yellow]")
+            console.print("[dim]Use 'empathy service status' to check[/dim]")
+
+    except Exception as e:
+        console.print(f"[bold red]Error:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
+@service_app.command("stop")
+def service_stop():
+    """Stop the cross-session coordination service."""
+    from empathy_os.redis_config import get_redis_memory
+
+    try:
+        memory = get_redis_memory()
+
+        if memory.use_mock:
+            console.print("[yellow]No service to stop (mock mode)[/yellow]")
+            return
+
+        # Check if service is running and signal it to stop
+        client = memory._client
+        if client:
+            from empathy_os.memory.cross_session import KEY_SERVICE_LOCK
+
+            lock_holder = client.get(KEY_SERVICE_LOCK)
+            if lock_holder:
+                client.delete(KEY_SERVICE_LOCK)
+                console.print("[green]✅ Service stop signal sent[/green]")
+            else:
+                console.print("[dim]No service currently running[/dim]")
+        else:
+            console.print("[yellow]Redis not connected[/yellow]")
+
+    except Exception as e:
+        console.print(f"[bold red]Error:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
+@service_app.command("status")
+def service_status(
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
+):
+    """Show cross-session service status and active sessions."""
+    import json as json_mod
+
+    from empathy_os.redis_config import get_redis_memory
+
+    try:
+        memory = get_redis_memory()
+
+        if memory.use_mock:
+            status = {
+                "mode": "mock",
+                "cross_session_available": False,
+                "message": "Cross-session requires Redis",
+            }
+            if json_output:
+                console.print(json_mod.dumps(status, indent=2))
+            else:
+                console.print("[yellow]⚠️  Mock mode - cross-session not available[/yellow]")
+                console.print("[dim]Start Redis: empathy memory start[/dim]")
+            return
+
+        from empathy_os.memory.cross_session import (
+            KEY_ACTIVE_AGENTS,
+            KEY_SERVICE_HEARTBEAT,
+            KEY_SERVICE_LOCK,
+            SessionInfo,
+        )
+
+        client = memory._client
+        if not client:
+            console.print("[red]Redis not connected[/red]")
+            raise typer.Exit(code=1)
+
+        # Check service status
+        service_lock = client.get(KEY_SERVICE_LOCK)
+        service_heartbeat = client.get(KEY_SERVICE_HEARTBEAT)
+
+        # Get active sessions
+        all_agents = client.hgetall(KEY_ACTIVE_AGENTS)
+        sessions = []
+        for agent_id, data in all_agents.items():
+            try:
+                if isinstance(agent_id, bytes):
+                    agent_id = agent_id.decode()
+                if isinstance(data, bytes):
+                    data = data.decode()
+                info = SessionInfo.from_dict(json_mod.loads(data))
+                if not info.is_stale:
+                    sessions.append(info.to_dict())
+            except (json_mod.JSONDecodeError, KeyError, ValueError):
+                pass
+
+        status = {
+            "mode": "redis",
+            "cross_session_available": True,
+            "service_running": bool(service_lock),
+            "service_pid": service_lock.decode() if isinstance(service_lock, bytes) else service_lock,
+            "last_heartbeat": service_heartbeat.decode() if isinstance(service_heartbeat, bytes) else service_heartbeat,
+            "active_sessions": len(sessions),
+            "sessions": sessions,
+        }
+
+        if json_output:
+            console.print(json_mod.dumps(status, indent=2))
+        else:
+            console.print()
+            console.print("[bold cyan]CROSS-SESSION SERVICE STATUS[/bold cyan]")
+            console.print("=" * 50)
+            console.print()
+
+            if status["service_running"]:
+                console.print("[green]● Service Running[/green]")
+                console.print(f"[dim]  PID: {status['service_pid']}[/dim]")
+                if status["last_heartbeat"]:
+                    console.print(f"[dim]  Last heartbeat: {status['last_heartbeat']}[/dim]")
+            else:
+                console.print("[yellow]○ Service Not Running[/yellow]")
+                console.print("[dim]  Start with: empathy service start[/dim]")
+
+            console.print()
+            console.print(f"[bold]Active Sessions:[/bold] {status['active_sessions']}")
+
+            if sessions:
+                console.print()
+                for session in sessions:
+                    session_type = session.get("session_type", "unknown")
+                    agent_id = session.get("agent_id", "unknown")
+                    tier = session.get("access_tier", "unknown")
+                    emoji = "🤖" if session_type == "claude" else "⚙️" if session_type == "service" else "👷"
+                    console.print(f"  {emoji} {agent_id}")
+                    console.print(f"     [dim]Type: {session_type} | Tier: {tier}[/dim]")
+
+            console.print()
+            console.print("=" * 50)
+
+    except Exception as e:
+        console.print(f"[bold red]Error:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
+@service_app.command("sessions")
+def service_sessions():
+    """List all active cross-session agents."""
+    import json as json_mod
+
+    from empathy_os.redis_config import get_redis_memory
+
+    try:
+        memory = get_redis_memory()
+
+        if memory.use_mock:
+            console.print("[yellow]No sessions (mock mode)[/yellow]")
+            return
+
+        from empathy_os.memory.cross_session import KEY_ACTIVE_AGENTS, SessionInfo
+
+        client = memory._client
+        if not client:
+            console.print("[red]Redis not connected[/red]")
+            return
+
+        all_agents = client.hgetall(KEY_ACTIVE_AGENTS)
+
+        if not all_agents:
+            console.print("[dim]No active sessions[/dim]")
+            return
+
+        console.print()
+        console.print("[bold]Active Cross-Session Agents[/bold]")
+        console.print("-" * 60)
+
+        for agent_id, data in all_agents.items():
+            try:
+                if isinstance(agent_id, bytes):
+                    agent_id = agent_id.decode()
+                if isinstance(data, bytes):
+                    data = data.decode()
+
+                info = SessionInfo.from_dict(json_mod.loads(data))
+
+                if info.is_stale:
+                    status_str = "[red]STALE[/red]"
+                else:
+                    status_str = "[green]ACTIVE[/green]"
+
+                console.print(f"\n{agent_id}")
+                console.print(f"  Status: {status_str}")
+                console.print(f"  Type: {info.session_type.value}")
+                console.print(f"  Tier: {info.access_tier.name}")
+                console.print(f"  Started: {info.started_at.isoformat()}")
+                console.print(f"  Last heartbeat: {info.last_heartbeat.isoformat()}")
+                if info.capabilities:
+                    console.print(f"  Capabilities: {', '.join(info.capabilities)}")
+
+            except (json_mod.JSONDecodeError, KeyError, ValueError) as e:
+                console.print(f"\n{agent_id}: [red]Invalid data[/red] - {e}")
+
+        console.print()
+
+    except Exception as e:
+        console.print(f"[bold red]Error:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
 # =============================================================================
 # META-WORKFLOW SUBCOMMAND GROUP
 # =============================================================================
@@ -1065,6 +1322,11 @@ def cheatsheet():
   empathy memory start      Start Redis server
   empathy memory patterns   List stored patterns
 
+[bold]Cross-Session Service[/bold]
+  empathy service start     Start coordination service
+  empathy service status    Show service & sessions
+  empathy service sessions  List active agents
+
 [bold]Provider Config[/bold]
   empathy provider          Show current config
   empathy provider --set hybrid    Use best-of-breed

{empathy_framework-4.4.0 → empathy_framework-4.5.0}/src/empathy_os/memory/__init__.py

@@ -67,6 +67,18 @@ from .config import check_redis_connection, get_railway_redis, get_redis_config,
 # Control Panel
 from .control_panel import ControlPanelConfig, MemoryControlPanel, MemoryStats
 
+# Cross-session communication
+from .cross_session import (
+    BackgroundService,
+    ConflictResult,
+    ConflictStrategy,
+    CrossSessionCoordinator,
+    SessionInfo,
+    SessionType,
+    check_redis_cross_session_support,
+    generate_agent_id,
+)
+
 # Memory Graph (Cross-Wizard Intelligence)
 from .edges import REVERSE_EDGE_TYPES, WIZARD_EDGE_PATTERNS, Edge, EdgeType
 from .graph import MemoryGraph
@@ -132,6 +144,8 @@ __all__ = [
     "AuditEvent",
     # Security - Audit
     "AuditLogger",
+    # Cross-session communication
+    "BackgroundService",
     "BugNode",
     "Classification",
     "ClassificationRules",
@@ -139,9 +153,12 @@ __all__ = [
     "ClaudeMemoryConfig",
     "ClaudeMemoryLoader",
     "ConflictContext",
+    "ConflictResult",
+    "ConflictStrategy",
     "ControlPanelConfig",
     # Conversation Summary Index
     "ConversationSummaryIndex",
+    "CrossSessionCoordinator",
     "Edge",
     "EdgeType",
     "EncryptionManager",
@@ -176,6 +193,8 @@ __all__ = [
     "SecurePattern",
     "SecurityError",
     "SecurityViolation",
+    "SessionInfo",
+    "SessionType",
     "Severity",
     "StagedPattern",
     "TTLStrategy",
@@ -183,9 +202,11 @@ __all__ = [
     "UnifiedMemory",
     "VulnerabilityNode",
     "check_redis_connection",
+    "check_redis_cross_session_support",
     "detect_secrets",
     # Redis Bootstrap
     "ensure_redis",
+    "generate_agent_id",
     "get_railway_redis",
     "get_redis_config",
     # Configuration