empathy-framework 4.4.0__py3-none-any.whl → 4.5.1__py3-none-any.whl

{empathy_framework-4.4.0.dist-info → empathy_framework-4.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 4.4.0
+Version: 4.5.1
 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>
@@ -359,10 +359,10 @@ Dynamic: license-file
 
 **The AI collaboration framework with breakthrough meta-orchestration - agents that compose themselves.**
 
-🎭 **v4.0: The Meta-Orchestration Era** - Dynamic agent teams, intelligent composition, self-learning systems.
+🎭 **v4.5: Production-Ready Agent Teams** - Real LLM execution, VS Code integration, rich reports.
 
 [![PyPI](https://img.shields.io/pypi/v/empathy-framework)](https://pypi.org/project/empathy-framework/)
-[![Tests](https://img.shields.io/badge/tests-6%2C038%20passing-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)
+[![Tests](https://img.shields.io/badge/tests-7%2C200%2B%20passing-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)
 [![Coverage](https://img.shields.io/badge/coverage-68%25-yellow)](https://github.com/Smart-AI-Memory/empathy-framework)
 [![License](https://img.shields.io/badge/license-Fair%20Source%200.9-blue)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org)
@@ -372,11 +372,58 @@ Dynamic: license-file
 pip install empathy-framework[developer]  # Lightweight for individual developers
 ```
 
-## What's New in v4.2.0 🤖 **META-WORKFLOW SYSTEM**
+## What's New in v4.5.0 🖥️ **VS CODE INTEGRATION**
+
+### **Rich HTML Reports for Agent Team Execution**
+
+**v4.5** adds VS Code webview integration with rich HTML reports, Quick Run mode, and JSON output for programmatic workflows.
+
+**Key Features:**
+
+- 📊 **MetaWorkflowReportPanel** - Rich HTML webview displaying agent results with collapsible sections
+- ⚡ **Quick Run Mode** - Execute with defaults, see results in beautiful reports
+- 🔧 **CLI JSON Output** - `--json` flag for programmatic consumption
+- 🎨 **Agent Cards** - Tier badges, status indicators, cost breakdowns
+
+**Quick Start (VS Code):**
+
+1. Open Command Palette (`Cmd+Shift+P`)
+2. Run "Empathy: Run Meta-Workflow"
+3. Select "Quick Run (Webview Report)"
+4. View rich HTML report with agent results
+
+---
+
+## What's New in v4.4.0 🚀 **PRODUCTION-READY AGENT TEAMS**
+
+### **Real LLM Execution with Cost Tracking**
+
+**v4.4** brings production-ready agent teams with real Claude model execution, accurate cost tracking, and skill-based invocation.
+
+**Breakthrough Features:**
+
+- 🤖 **Real LLM Execution** - Agents execute with actual Claude API calls
+- 💰 **Accurate Cost Tracking** - Token counting from real API usage
+- 📈 **Progressive Tier Escalation** - CHEAP → CAPABLE → PREMIUM with actual execution
+- 🎯 **Skill-based Invocation** - Use `/release-prep`, `/test-coverage`, `/manage-docs` in Claude Code
+
+**Quick Start (CLI):**
+
+```bash
+# Run release preparation agent team
+empathy meta-workflow run release-prep --real
+
+# Natural language - describe what you need
+empathy meta-workflow ask "prepare my code for release" --auto
+```
+
+---
+
+## Meta-Workflow System 🤖 (v4.2+)
 
 ### **Intelligent Workflow Orchestration Through Forms + Dynamic Agents**
 
-**The breakthrough:** v4.2 introduces a meta-workflow system that combines Socratic forms (interactive questions), dynamic agent team creation, and pattern learning for self-improving workflows.
+**The breakthrough:** The meta-workflow system combines Socratic forms (interactive questions), dynamic agent team creation, and pattern learning for self-improving workflows.
 
 **How it works:**
 

{empathy_framework-4.4.0.dist-info → empathy_framework-4.5.1.dist-info}/RECORD

@@ -20,7 +20,7 @@ coach_wizards/refactoring_wizard.py,sha256=X0MTx3BHpOlOMAYDow-3HX5GyryY70JGAF5vA
 coach_wizards/scaling_wizard.py,sha256=n1RLtpWmj1RSEGSWssMiUPwCdpskO3z2Z3yhLlTdXro,2598
 coach_wizards/security_wizard.py,sha256=19SOClSxo6N-QqUc_QsFXOE7yEquiZF4kLi7jRomA7g,2605
 coach_wizards/testing_wizard.py,sha256=vKFgFG4uJfAVFmCIQbkrWNvZhIfLC6ve_XbvWZKrPg4,2563
-empathy_framework-4.4.0.dist-info/licenses/LICENSE,sha256=IJ9eeI5KSrD5P7alsn7sI_6_1bDihxBA5S4Sen4jf2k,4937
+empathy_framework-4.5.1.dist-info/licenses/LICENSE,sha256=IJ9eeI5KSrD5P7alsn7sI_6_1bDihxBA5S4Sen4jf2k,4937
 empathy_healthcare_plugin/__init__.py,sha256=4NioL1_86UXzkd-QNkQZUSZ8rKTQGSP0TC9VXP32kQs,295
 empathy_healthcare_plugin/monitors/__init__.py,sha256=Udp8qfZR504QAq5_eQjvtIaE7v06Yguc7nuF40KllQc,196
 empathy_healthcare_plugin/monitors/clinical_protocol_monitor.py,sha256=MWE5t8tW9HWZn_SNo-inx8-0nhdTNGhbcB8ZeDWyXa0,11648
@@ -100,7 +100,7 @@ empathy_os/agent_monitoring.py,sha256=s4seLC_J4AtQ3PYWrRPO8YHM-Fbm0Q36kPEdlTHf2H
 empathy_os/cache_monitor.py,sha256=DTR8xr9d63czGzzdfrBFWp8hkoWPFsL-hpihPGmkbEc,11072
 empathy_os/cache_stats.py,sha256=rWJPBNFEfhuLwKYKy89D_Qa9GPIyVso2jdCKp_cdJhI,10232
 empathy_os/cli.py,sha256=gr9cUowOsvsfqQzhsLPNCny1tpgJtg1vP6C2NNq8vV0,128006
-empathy_os/cli_unified.py,sha256=PsTvjs6PjhF3NP-07gokeKSYRyNhYoUwAatgXV9iBLk,38686
+empathy_os/cli_unified.py,sha256=mDIPbRvaNJNCyD2-LC51z8OsusXNuXP9-FwvamfgXxU,48422
 empathy_os/config.py,sha256=jsFQuXpZP_jt6UrZtfLlkBZwPUSNbnW5VVtMS5JIhbA,16276
 empathy_os/coordination.py,sha256=E2HvHxKk1xbYswtgxhnVKB6DRxfXUV5pCt-XWHOvNKM,28509
 empathy_os/core.py,sha256=PvrPs8JQPwQjPZZQj6zy6xQTFGHKziaeRxCIlIs3iHA,52951
@@ -142,16 +142,17 @@ empathy_os/hot_reload/integration.py,sha256=mBhQgkV266Z753WVuuyMEcm0J25DzSsutQPw
 empathy_os/hot_reload/reloader.py,sha256=akqz5t9nn5kc-yj1Dj2NuyPO1p1cWaAhUf-CVlr0XRE,9365
 empathy_os/hot_reload/watcher.py,sha256=l0dZmfDM5RaCZm7nT8qutPI4fXScrS9_QoJ_pdCdOoY,5198
 empathy_os/hot_reload/websocket.py,sha256=DFJlu2gK3hi5R99J05By7RGlfIJDPLa555VZtzUJxUE,5088
-empathy_os/memory/__init__.py,sha256=QwxOpVux5AKBBEZRHs7FoE39JVdWlJQ6WCAm00Cy3C8,4908
+empathy_os/memory/__init__.py,sha256=TwdCTcd_7HuIB5XDh-4iP1lddntAaaD_Mb1Rngcs8sw,5400
 empathy_os/memory/claude_memory.py,sha256=IIwm3su_vyyyoLy4NrpwVk96KLnIgq1A_TfBhjcUZk4,14878
 empathy_os/memory/config.py,sha256=EoBBZLgyY5sHT3kLeyWjyI4b6hRA3Xiaoo3xdMLLGos,6380
 empathy_os/memory/control_panel.py,sha256=ylU2RODUIXQSMhBLcqPI5KkOAOpcmuABVcd2AleeSaw,47334
+empathy_os/memory/cross_session.py,sha256=3cZl_4QeK63v-JMhOSCRJJ9d-ea2yb0azFW2yXvOt4o,26870
 empathy_os/memory/edges.py,sha256=ljku2CYeetJ7qDnQUJobrPZdBaYFxkn_PfGSNa9sVDE,5891
 empathy_os/memory/graph.py,sha256=Up4PCG8BbK5fmGym7rNEPZsCNjS7TQ3_F9-S6-mS2L4,18820
 empathy_os/memory/long_term.py,sha256=dMKL3a3lZgc5bq7eQAUMp4gPwq-6R6k62M5yDOcbSrw,50882
 empathy_os/memory/nodes.py,sha256=lVLN9pp8cFSBrO2Nh8d0zTOglM3QBaYCtwfO5P8dryc,4752
 empathy_os/memory/redis_bootstrap.py,sha256=G71loEE2LTcn0BCp_mN96Bk37ygFz1ImORiLoEmg9jA,16508
-empathy_os/memory/short_term.py,sha256=cp38F77ouFKzwaDgLxUOGGkKTauxcIQy9CH12w3XuKQ,71445
+empathy_os/memory/short_term.py,sha256=wBRb7LPQjyAYqKCZFBZv8KlncwAi0zeuymJE_NkZ0DY,78467
 empathy_os/memory/summary_index.py,sha256=7m_m2xH3KMBJWRJFvk3hAws_tgPD4VCfFBxwAbV9fCo,20777
 empathy_os/memory/unified.py,sha256=L5yZiMOUmrJSKjkOtW5eB0DV9ONRwx3-1XBzFCLcUNo,29168
 empathy_os/memory/security/__init__.py,sha256=f_t-pFO1aHOE8uFJ0icGaCt2xCvWx-bFxBcv9U3Cu3Q,868
@@ -161,15 +162,15 @@ empathy_os/memory/security/secrets_detector.py,sha256=bJsXTD95yEnfShDMxvCndzF8X7
 empathy_os/memory/storage/__init__.py,sha256=sPLdecYJ1z6nZTIl8gmbozjdCPp0SZLKsKoi8L1xhcE,480
 empathy_os/meta_workflows/__init__.py,sha256=REUdSgr5kRxPuzj1R3qy50_BEdImoNOry_UNwn2jRYo,1845
 empathy_os/meta_workflows/agent_creator.py,sha256=f2Bc_Qm4bj7DFpGzhDf41RnUK4rG4jQRpRWYiQ_AdjE,8061
-empathy_os/meta_workflows/builtin_templates.py,sha256=znZ2mF4mEuHuiYuV7GkUpDvKrEQjHYQNhkkcqB7JkrU,20619
-empathy_os/meta_workflows/cli_meta_workflows.py,sha256=ZpcESKWJ5uk0g8VwmpNilNpajdLxkWCMXattMR3Qei0,56599
+empathy_os/meta_workflows/builtin_templates.py,sha256=5yL7hEKi7hu20jQK3PxJkGfwppyqdEokJiJMnTzTiXk,20722
+empathy_os/meta_workflows/cli_meta_workflows.py,sha256=ICKl50NI9K5RafWmUwvji_bk8xFyHscEo_3e0LALLOQ,58750
 empathy_os/meta_workflows/form_engine.py,sha256=tUeSU_TofTS7ZjhWL5tIw4DxrleaHfFQf2mMDI4IaMg,10877
 empathy_os/meta_workflows/intent_detector.py,sha256=heWc6nm-EyMz-Ru2TfaNnWSLqduhOxfTVK80Plf96y4,10126
 empathy_os/meta_workflows/models.py,sha256=jtuAgSuY-vHbjqVOo4AIoq1SXfp-DxUhPyAcmwqjbcI,18909
 empathy_os/meta_workflows/pattern_learner.py,sha256=9DA6L39zu88ohu5zC9PmmJPaIb15of6GwFP7qyy1SlE,26529
 empathy_os/meta_workflows/session_context.py,sha256=WTdhWAKHq6cLJBLHT-jwjxOwQyUPId_F8GPjQlI7gvY,12366
 empathy_os/meta_workflows/template_registry.py,sha256=eFv4rlHcsuk7tnpLCjTNytYipmgyuruW_VZKdXmSXSE,7488
-empathy_os/meta_workflows/workflow.py,sha256=BByaH4bTfLVPgglv0wwZBLjz6jDi54kj5m-ZQtwPbdY,35048
+empathy_os/meta_workflows/workflow.py,sha256=Sag47KtDACEAcFnQ30Lu834iNHo08GCx5dnMXL0ILcc,36015
 empathy_os/metrics/__init__.py,sha256=b0lkly5Fz89AvvGqV6lLYx8hWlmttL1ZCPuWlHjwXxY,369
 empathy_os/metrics/prompt_metrics.py,sha256=9ZUxM5zJX7v9MxKbDfuP4zWdFKy2sNZO6zRdSELZgTo,6315
 empathy_os/models/__init__.py,sha256=gP9DDNB6kyQJroon182ZYDJ4-IkREkDwRitZg1Xgw_4,3324
@@ -192,7 +193,7 @@ empathy_os/monitoring/otel_backend.py,sha256=dqCgiw79bYTeVFSRV3raYk-Mpnu8sNoqik3
 empathy_os/optimization/__init__.py,sha256=p9dPGmci7MIASss38ctLpKTl_tV8ApkcyPZovE1EUMA,422
 empathy_os/optimization/context_optimizer.py,sha256=lPWXuG7K1OMVNZKOdQT2SlZhLfjMREKSp5pCPQibXpk,8048
 empathy_os/orchestration/__init__.py,sha256=BuIuXDQ2MWPOIkhVkjFCkKjbiDwAqCmrL096ou2NYFE,876
-empathy_os/orchestration/agent_templates.py,sha256=t8LxeqiTdgqYvW1BE8IXswAFamVTrScycb2VnG0qBCM,16283
+empathy_os/orchestration/agent_templates.py,sha256=eGT_NeIW3lS64En_2L5QccJ-bocdETk2uu1T3v74Dlw,22113
 empathy_os/orchestration/config_store.py,sha256=TZLjzCr1g0nAP1eEZA9fMUy3OjF6XsWIQaJnX_PpLDY,16774
 empathy_os/orchestration/execution_strategies.py,sha256=PRlCJkHgITS4Kuqb6Etk28Yk2wb-ReyBFodfVM87s3g,57002
 empathy_os/orchestration/meta_orchestrator.py,sha256=lFyqXat7wULVzNkED2Uxst5Bol-JPOgUHU5U8LevIgM,21591
@@ -394,8 +395,8 @@ workflow_scaffolding/__init__.py,sha256=UpX5vjjjPjIaAKyIV1D4GxJzLUZy5DzdzgSkePYM
 workflow_scaffolding/__main__.py,sha256=0qspuNoadTDqyskXTlT8Sahqau-XIxN35NHTSGVW6z4,236
 workflow_scaffolding/cli.py,sha256=yLgvMsPbqI-LHt7UKXMuj-Dc0-44EqWiChldysrw1YQ,6763
 workflow_scaffolding/generator.py,sha256=9eEmm324kVzf8BCtXEML090pyke06o0U7aGATzZIaPM,8869
-empathy_framework-4.4.0.dist-info/METADATA,sha256=iFFX3CQYFCv-oYrm7utIvzhy7IM3f3Sknjh1BkoVKcc,56221
-empathy_framework-4.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-empathy_framework-4.4.0.dist-info/entry_points.txt,sha256=41rM9JgcKpkU8dr4VvPcbiPy2GQX68cEj10l3XMH0FQ,1519
-empathy_framework-4.4.0.dist-info/top_level.txt,sha256=wrNU1aVMutVDACer58H-udv0P_171Dv6z_42sZtZ-xM,124
-empathy_framework-4.4.0.dist-info/RECORD,,
+empathy_framework-4.5.1.dist-info/METADATA,sha256=rubJMu0yJFywjzRr-z18oEoBNxNyV0V-0_nZMj12vxI,57808
+empathy_framework-4.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+empathy_framework-4.5.1.dist-info/entry_points.txt,sha256=41rM9JgcKpkU8dr4VvPcbiPy2GQX68cEj10l3XMH0FQ,1519
+empathy_framework-4.5.1.dist-info/top_level.txt,sha256=wrNU1aVMutVDACer58H-udv0P_171Dv6z_42sZtZ-xM,124
+empathy_framework-4.5.1.dist-info/RECORD,,

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_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