empathy-framework 3.9.1__py3-none-any.whl → 3.9.3__py3-none-any.whl

empathy_os/cli_unified.py

@@ -513,6 +513,85 @@ def workflow_recommend(
     )
 
 
+# =============================================================================
+# TELEMETRY SUBCOMMAND GROUP
+# =============================================================================
+
+telemetry_app = typer.Typer(help="View and manage local usage telemetry")
+app.add_typer(telemetry_app, name="telemetry")
+
+
+@telemetry_app.command("show")
+def telemetry_show(
+    limit: int = typer.Option(20, "--limit", "-l", help="Number of entries to show"),
+    days: int | None = typer.Option(None, "--days", "-d", help="Only show last N days"),
+):
+    """Show recent LLM calls and usage stats."""
+    args = [sys.executable, "-m", "empathy_os.cli", "telemetry", "show", "--limit", str(limit)]
+    if days:
+        args.extend(["--days", str(days)])
+    subprocess.run(args, check=False)
+
+
+@telemetry_app.command("savings")
+def telemetry_savings(
+    days: int = typer.Option(30, "--days", "-d", help="Number of days to analyze"),
+):
+    """Calculate cost savings vs baseline (all PREMIUM)."""
+    subprocess.run(
+        [sys.executable, "-m", "empathy_os.cli", "telemetry", "savings", "--days", str(days)],
+        check=False,
+    )
+
+
+@telemetry_app.command("compare")
+def telemetry_compare(
+    period1: int = typer.Option(7, "--period1", "-p1", help="First period in days"),
+    period2: int = typer.Option(30, "--period2", "-p2", help="Second period in days"),
+):
+    """Compare usage across two time periods."""
+    subprocess.run(
+        [
+            sys.executable,
+            "-m",
+            "empathy_os.cli",
+            "telemetry",
+            "compare",
+            "--period1",
+            str(period1),
+            "--period2",
+            str(period2),
+        ],
+        check=False,
+    )
+
+
+@telemetry_app.command("export")
+def telemetry_export(
+    format_type: str = typer.Option("json", "--format", "-f", help="Export format (json, csv)"),
+    output: Path | None = typer.Option(None, "--output", "-o", help="Output file path"),
+    days: int | None = typer.Option(None, "--days", "-d", help="Only export last N days"),
+):
+    """Export telemetry data to JSON or CSV."""
+    args = [sys.executable, "-m", "empathy_os.cli", "telemetry", "export", "--format", format_type]
+    if output:
+        args.extend(["--output", str(output)])
+    if days:
+        args.extend(["--days", str(days)])
+    subprocess.run(args, check=False)
+
+
+@telemetry_app.command("reset")
+def telemetry_reset(
+    confirm: bool = typer.Option(False, "--confirm", help="Confirm deletion"),
+):
+    """Clear all telemetry data (use with caution)."""
+    args = [sys.executable, "-m", "empathy_os.cli", "telemetry", "reset"]
+    if confirm:
+        args.append("--confirm")
+    subprocess.run(args, check=False)
+
+
 # =============================================================================
 # TIER RECOMMENDATION SUBCOMMAND GROUP
 # =============================================================================
@@ -552,7 +631,7 @@ def tier_recommend(
     console.print(f"  💰 [bold]Expected Cost:[/bold] ${result.expected_cost:.3f}")
     console.print(f"  🔄 [bold]Expected Attempts:[/bold] {result.expected_attempts:.1f}")
     console.print()
-    console.print(f"  📊 [bold]Reasoning:[/bold]")
+    console.print("  📊 [bold]Reasoning:[/bold]")
     console.print(f"     {result.reasoning}")
     console.print()
 
@@ -669,7 +748,12 @@ def cheatsheet():
   empathy wizard list       Show available wizards
   empathy wizard run <name> Execute a wizard
   empathy wizard create <name> -d <domain>  Create wizard (12x faster)
-  empathy wizard list-patterns              List available patterns""",
+  empathy wizard list-patterns              List available patterns
+
+[bold]Usage Telemetry[/bold]
+  empathy telemetry show    View recent LLM calls & costs
+  empathy telemetry savings Calculate cost savings (tier routing)
+  empathy telemetry export  Export usage data (JSON/CSV)""",
             title="[bold blue]Empathy Framework Cheatsheet[/bold blue]",
         ),
     )

empathy_os/config.py

@@ -14,7 +14,10 @@ import json
 import os
 from dataclasses import asdict, dataclass, field
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from empathy_os.workflows.config import ModelConfig
 
 try:
     import yaml
@@ -23,8 +26,6 @@ try:
 except ImportError:
     YAML_AVAILABLE = False
 
-from empathy_os.workflows.config import ModelConfig
-
 
 def _validate_file_path(path: str, allowed_dir: str | None = None) -> Path:
     """Validate file path to prevent path traversal and arbitrary writes.
@@ -120,7 +121,7 @@ class EmpathyConfig:
     metadata: dict[str, Any] = field(default_factory=dict)
 
     # Model settings
-    models: list[ModelConfig] = field(default_factory=list)
+    models: list["ModelConfig"] = field(default_factory=list)
     default_model: str | None = None
     log_path: str | None = None
     max_threads: int = 4
@@ -181,6 +182,8 @@ class EmpathyConfig:
 
         # Handle nested ModelConfig objects
         if filtered_data.get("models"):
+            from empathy_os.workflows.config import ModelConfig
+
             filtered_data["models"] = [ModelConfig(**m) for m in filtered_data["models"]]
 
         return cls(**filtered_data)

empathy_os/hot_reload/integration.py

@@ -7,6 +7,7 @@ Licensed under Fair Source 0.9
 """
 
 import logging
+from collections.abc import Callable
 
 from fastapi import FastAPI, WebSocket, WebSocketDisconnect
 
@@ -45,7 +46,7 @@ class HotReloadIntegration:
     def __init__(
         self,
         app: FastAPI,
-        register_callback: callable,
+        register_callback: Callable[[str, type], bool],
     ):
         """Initialize hot-reload integration.
 

empathy_os/hot_reload/watcher.py

@@ -19,16 +19,16 @@ logger = logging.getLogger(__name__)
 class WizardFileHandler(FileSystemEventHandler):
     """Handles file system events for wizard files."""
 
-    def __init__(self, reload_callback: Callable[[str], None]):
+    def __init__(self, reload_callback: Callable[[str, str], None]):
         """Initialize handler.
 
         Args:
-            reload_callback: Function to call when wizard file changes
+            reload_callback: Function to call when wizard file changes (wizard_id, file_path)
 
         """
         super().__init__()
         self.reload_callback = reload_callback
-        self._processing = set()  # Prevent duplicate events
+        self._processing: set[str] = set()  # Prevent duplicate events
 
     def on_modified(self, event: FileSystemEvent) -> None:
         """Handle file modification events.
@@ -40,7 +40,11 @@ class WizardFileHandler(FileSystemEventHandler):
         if event.is_directory:
             return
 
-        file_path = event.src_path
+        # Convert file_path to str if it's bytes
+        file_path_raw = event.src_path
+        file_path = (
+            file_path_raw.decode("utf-8") if isinstance(file_path_raw, bytes) else file_path_raw
+        )
 
         # Only process Python files
         if not file_path.endswith(".py"):

empathy_os/hot_reload/websocket.py

@@ -8,6 +8,7 @@ Licensed under Fair Source 0.9
 
 import asyncio
 import logging
+from collections.abc import Callable
 from typing import Any
 
 from fastapi import WebSocket
@@ -141,7 +142,7 @@ def get_notification_manager() -> ReloadNotificationManager:
     return _notification_manager
 
 
-def create_notification_callback() -> callable:
+def create_notification_callback() -> Callable[[dict[str, Any]], None]:
     """Create a callback function for the wizard reloader.
 
     Returns:

empathy_os/memory/__init__.py

@@ -73,48 +73,48 @@ from .graph import MemoryGraph
 
 # Long-term memory (Persistent patterns)
 from .long_term import (
-                     Classification,
-                     ClassificationRules,
-                     EncryptionManager,
-                     MemDocsStorage,
-                     PatternMetadata,
-                     SecureMemDocsIntegration,
-                     SecurePattern,
-                     SecurityError,
+    Classification,
+    ClassificationRules,
+    EncryptionManager,
+    MemDocsStorage,
+    PatternMetadata,
+    SecureMemDocsIntegration,
+    SecurePattern,
+    SecurityError,
 )
 from .long_term import PermissionError as MemoryPermissionError
 from .nodes import BugNode, Node, NodeType, PatternNode, PerformanceNode, VulnerabilityNode
 
 # Redis Bootstrap
 from .redis_bootstrap import (
-                     RedisStartMethod,
-                     RedisStatus,
-                     ensure_redis,
-                     get_redis_or_mock,
-                     stop_redis,
+    RedisStartMethod,
+    RedisStatus,
+    ensure_redis,
+    get_redis_or_mock,
+    stop_redis,
 )
 
 # Security components
 from .security import (  # Audit Logging; PII Scrubbing; Secrets Detection
-                     AuditEvent,
-                     AuditLogger,
-                     PIIDetection,
-                     PIIPattern,
-                     PIIScrubber,
-                     SecretDetection,
-                     SecretsDetector,
-                     SecretType,
-                     SecurityViolation,
-                     Severity,
-                     detect_secrets,
+    AuditEvent,
+    AuditLogger,
+    PIIDetection,
+    PIIPattern,
+    PIIScrubber,
+    SecretDetection,
+    SecretsDetector,
+    SecretType,
+    SecurityViolation,
+    Severity,
+    detect_secrets,
 )
 from .short_term import (
-                     AccessTier,
-                     AgentCredentials,
-                     ConflictContext,
-                     RedisShortTermMemory,
-                     StagedPattern,
-                     TTLStrategy,
+    AccessTier,
+    AgentCredentials,
+    ConflictContext,
+    RedisShortTermMemory,
+    StagedPattern,
+    TTLStrategy,
 )
 
 # Conversation Summary Index

empathy_os/memory/control_panel.py

@@ -560,7 +560,9 @@ class MemoryControlPanel:
             return long_term.delete_pattern(pattern_id, user_id)
         except Exception as e:
             logger.error("delete_pattern_failed", pattern_id=pattern_id, error=str(e))
-            return False  # Graceful degradation - validation errors raise, storage errors return False
+            return (
+                False  # Graceful degradation - validation errors raise, storage errors return False
+            )
 
     def clear_short_term(self, agent_id: str = "admin") -> int:
         """Clear all short-term memory for an agent.

empathy_os/memory/long_term.py

@@ -570,7 +570,9 @@ class SecureMemDocsIntegration:
 
             # Pattern 5: Type validation
             if custom_metadata is not None and not isinstance(custom_metadata, dict):
-                raise TypeError(f"custom_metadata must be dict, got {type(custom_metadata).__name__}")
+                raise TypeError(
+                    f"custom_metadata must be dict, got {type(custom_metadata).__name__}"
+                )
 
             # Step 1 & 2: PII Scrubbing + Secrets Detection (PARALLEL for performance)
             # Run both operations in parallel since they're independent

empathy_os/models/__init__.py

@@ -12,64 +12,64 @@ Licensed under Fair Source License 0.9
 from .empathy_executor import EmpathyLLMExecutor
 from .executor import ExecutionContext, LLMExecutor, LLMResponse, MockLLMExecutor
 from .fallback import (
-                       DEFAULT_FALLBACK_POLICY,
-                       DEFAULT_RETRY_POLICY,
-                       CircuitBreaker,
-                       CircuitBreakerState,
-                       FallbackPolicy,
-                       FallbackStep,
-                       FallbackStrategy,
-                       ResilientExecutor,
-                       RetryPolicy,
+    DEFAULT_FALLBACK_POLICY,
+    DEFAULT_RETRY_POLICY,
+    CircuitBreaker,
+    CircuitBreakerState,
+    FallbackPolicy,
+    FallbackStep,
+    FallbackStrategy,
+    ResilientExecutor,
+    RetryPolicy,
 )
 from .provider_config import (
-                       ProviderConfig,
-                       ProviderMode,
-                       configure_provider_cli,
-                       configure_provider_interactive,
-                       get_provider_config,
-                       reset_provider_config,
-                       set_provider_config,
+    ProviderConfig,
+    ProviderMode,
+    configure_provider_cli,
+    configure_provider_interactive,
+    get_provider_config,
+    reset_provider_config,
+    set_provider_config,
 )
 from .registry import (
-                       MODEL_REGISTRY,
-                       ModelInfo,
-                       ModelProvider,
-                       ModelTier,
-                       get_all_models,
-                       get_model,
-                       get_pricing_for_model,
+    MODEL_REGISTRY,
+    ModelInfo,
+    ModelProvider,
+    ModelTier,
+    get_all_models,
+    get_model,
+    get_pricing_for_model,
 )
 from .tasks import (
-                       CAPABLE_TASKS,
-                       CHEAP_TASKS,
-                       PREMIUM_TASKS,
-                       TASK_TIER_MAP,
-                       TaskInfo,
-                       TaskType,
-                       get_all_tasks,
-                       get_tasks_for_tier,
-                       get_tier_for_task,
-                       is_known_task,
-                       normalize_task_type,
+    CAPABLE_TASKS,
+    CHEAP_TASKS,
+    PREMIUM_TASKS,
+    TASK_TIER_MAP,
+    TaskInfo,
+    TaskType,
+    get_all_tasks,
+    get_tasks_for_tier,
+    get_tier_for_task,
+    is_known_task,
+    normalize_task_type,
 )
 from .telemetry import (
-                       LLMCallRecord,
-                       TelemetryAnalytics,
-                       TelemetryBackend,
-                       TelemetryStore,
-                       WorkflowRunRecord,
-                       WorkflowStageRecord,
-                       get_telemetry_store,
-                       log_llm_call,
-                       log_workflow_run,
+    LLMCallRecord,
+    TelemetryAnalytics,
+    TelemetryBackend,
+    TelemetryStore,
+    WorkflowRunRecord,
+    WorkflowStageRecord,
+    get_telemetry_store,
+    log_llm_call,
+    log_workflow_run,
 )
 from .validation import (
-                       ConfigValidator,
-                       ValidationError,
-                       ValidationResult,
-                       validate_config,
-                       validate_yaml_file,
+    ConfigValidator,
+    ValidationError,
+    ValidationResult,
+    validate_config,
+    validate_yaml_file,
 )
 
 __all__ = [

empathy_os/monitoring/__init__.py

@@ -25,13 +25,13 @@ from empathy_os.agent_monitoring import AgentMetrics, AgentMonitor, TeamMetrics
 
 # Import telemetry classes
 from empathy_os.models.telemetry import (
-                                         LLMCallRecord,
-                                         TelemetryAnalytics,
-                                         TelemetryStore,
-                                         WorkflowRunRecord,
-                                         get_telemetry_store,
-                                         log_llm_call,
-                                         log_workflow_run,
+    LLMCallRecord,
+    TelemetryAnalytics,
+    TelemetryStore,
+    WorkflowRunRecord,
+    get_telemetry_store,
+    log_llm_call,
+    log_workflow_run,
 )
 
 __all__ = [

empathy_os/optimization/__init__.py

@@ -7,9 +7,9 @@ Licensed under Fair Source License 0.9
 """
 
 from empathy_os.optimization.context_optimizer import (
-                                                       CompressionLevel,
-                                                       ContextOptimizer,
-                                                       optimize_xml_prompt,
+    CompressionLevel,
+    ContextOptimizer,
+    optimize_xml_prompt,
 )
 
 __all__ = [

empathy_os/pattern_library.py

@@ -262,9 +262,7 @@ class PatternLibrary:
         """
         pattern = self.patterns.get(pattern_id)
         if not pattern:
-            raise ValueError(
-                f"Pattern '{pattern_id}' not found. Cannot record outcome."
-            )
+            raise ValueError(f"Pattern '{pattern_id}' not found. Cannot record outcome.")
         pattern.record_usage(success)
 
     def link_patterns(self, pattern_id_1: str, pattern_id_2: str):
@@ -300,10 +298,7 @@ class PatternLibrary:
                 self.pattern_graph[pattern_id_2].append(pattern_id_1)
 
     def get_related_patterns(
-        self,
-        pattern_id: str,
-        depth: int = 1,
-        _visited: set[str] | None = None
+        self, pattern_id: str, depth: int = 1, _visited: set[str] | None = None
     ) -> list[Pattern]:
         """Get patterns related to a given pattern
 

empathy_os/plugins/__init__.py

@@ -7,12 +7,12 @@ Licensed under Fair Source 0.9
 """
 
 from .base import (
-                   BasePlugin,
-                   BaseWizard,
-                   PluginError,
-                   PluginLoadError,
-                   PluginMetadata,
-                   PluginValidationError,
+    BasePlugin,
+    BaseWizard,
+    PluginError,
+    PluginLoadError,
+    PluginMetadata,
+    PluginValidationError,
 )
 from .registry import PluginRegistry, get_global_registry
 

empathy_os/resilience/__init__.py

@@ -18,11 +18,11 @@ Licensed under Fair Source 0.9
 """
 
 from .circuit_breaker import (
-                              CircuitBreaker,
-                              CircuitOpenError,
-                              CircuitState,
-                              circuit_breaker,
-                              get_circuit_breaker,
+    CircuitBreaker,
+    CircuitOpenError,
+    CircuitState,
+    circuit_breaker,
+    get_circuit_breaker,
 )
 from .fallback import Fallback, fallback, with_fallback
 from .health import HealthCheck, HealthStatus, SystemHealth

empathy_os/scaffolding/cli.py

@@ -218,7 +218,7 @@ Examples:
     )
 
     # List patterns command
-    list_parser = subparsers.add_parser("list-patterns", help="List available patterns")
+    subparsers.add_parser("list-patterns", help="List available patterns")
 
     args = parser.parse_args()