ostruct-cli 0.7.1__py3-none-any.whl → 0.8.0__py3-none-any.whl

ostruct/cli/progress_reporting.py

@@ -0,0 +1,398 @@
+"""Enhanced progress reporting with user-centric language."""
+
+import logging
+from dataclasses import dataclass
+from typing import List, Optional
+
+import click
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class CostBreakdown:
+    """Cost breakdown for transparency."""
+
+    total: float
+    input_cost: float
+    output_cost: float
+    input_tokens: int
+    output_tokens: int
+    code_interpreter_cost: Optional[float] = None
+    file_search_cost: Optional[float] = None
+    model: str = "gpt-4o"
+
+    @property
+    def has_tool_costs(self) -> bool:
+        """Check if there are additional tool costs."""
+        return bool(self.code_interpreter_cost or self.file_search_cost)
+
+
+@dataclass
+class ProcessingResult:
+    """Processing result summary for user reporting."""
+
+    model: str
+    analysis_summary: str
+    search_summary: Optional[str] = None
+    completion_summary: str = "Processing completed successfully"
+    files_processed: int = 0
+    tools_used: Optional[List[str]] = None
+
+    def __post_init__(self) -> None:
+        if self.tools_used is None:
+            self.tools_used = []
+
+
+class EnhancedProgressReporter:
+    """Enhanced progress reporter with user-friendly language and transparency."""
+
+    def __init__(self, verbose: bool = False, progress_level: str = "basic"):
+        """Initialize the progress reporter.
+
+        Args:
+            verbose: Enable verbose logging output
+            progress_level: Progress level (none, basic, detailed)
+        """
+        self.verbose = verbose
+        self.progress_level = progress_level
+        self.should_report = progress_level != "none"
+        self.detailed = progress_level == "detailed" or verbose
+
+    def report_phase(self, phase_name: str, emoji: str = "⚙️") -> None:
+        """Report the start of a major processing phase.
+
+        Args:
+            phase_name: Name of the processing phase
+            emoji: Emoji icon for the phase
+        """
+        if self.should_report:
+            click.echo(f"{emoji} {phase_name}...", err=True)
+
+    def report_optimization(self, optimizations: List[str]) -> None:
+        """Report template optimization results with user-friendly language.
+
+        Args:
+            optimizations: List of optimization transformations applied
+        """
+        if not self.should_report or not optimizations:
+            return
+
+        if self.detailed:
+            click.echo("🔧 Template optimization:", err=True)
+            for optimization in optimizations:
+                # Convert technical language to user-friendly descriptions
+                user_friendly = self._humanize_optimization(optimization)
+                click.echo(f"  → {user_friendly}", err=True)
+        else:
+            click.echo(
+                f"🔧 Optimized template for better AI performance ({len(optimizations)} improvements)",
+                err=True,
+            )
+
+    def report_file_routing(
+        self,
+        template_files: List[str],
+        container_files: List[str],
+        vector_files: List[str],
+    ) -> None:
+        """Report file routing decisions in user-friendly terms.
+
+        Args:
+            template_files: Files routed to template access
+            container_files: Files routed to Code Interpreter
+            vector_files: Files routed to File Search
+        """
+        if not self.should_report:
+            return
+
+        total_files = (
+            len(template_files) + len(container_files) + len(vector_files)
+        )
+        if total_files == 0:
+            return
+
+        if self.detailed:
+            click.echo("📂 File routing:", err=True)
+            for file in template_files:
+                click.echo(
+                    f"  → {file}: available in template for direct access",
+                    err=True,
+                )
+            for file in container_files:
+                click.echo(
+                    f"  → {file}: uploaded to Code Interpreter for analysis",
+                    err=True,
+                )
+            for file in vector_files:
+                click.echo(
+                    f"  → {file}: uploaded to File Search for semantic search",
+                    err=True,
+                )
+        else:
+            tools_used = []
+            if container_files:
+                tools_used.append(
+                    f"Code Interpreter ({len(container_files)} files)"
+                )
+            if vector_files:
+                tools_used.append(f"File Search ({len(vector_files)} files)")
+            if template_files:
+                tools_used.append(f"Template ({len(template_files)} files)")
+
+            tools_str = ", ".join(tools_used)
+            click.echo(
+                f"📂 Routed {total_files} files to: {tools_str}", err=True
+            )
+
+    def report_processing_start(
+        self, model: str, tools_used: List[str]
+    ) -> None:
+        """Report the start of AI processing with clear context.
+
+        Args:
+            model: Model being used for processing
+            tools_used: List of tools being utilized
+        """
+        if not self.should_report:
+            return
+
+        tools_str = ", ".join(tools_used) if tools_used else "template only"
+        click.echo(
+            f"🤖 Processing with {model} using {tools_str}...", err=True
+        )
+
+    def report_processing_results(self, result: ProcessingResult) -> None:
+        """Report AI processing outcomes in a user-friendly way.
+
+        Args:
+            result: Processing result with summary information
+        """
+        if not self.should_report:
+            return
+
+        if self.detailed:
+            click.echo("📦 Processing results:", err=True)
+            click.echo(f"├── Model: {result.model}", err=True)
+            if result.files_processed > 0:
+                click.echo(
+                    f"├── Files processed: {result.files_processed}", err=True
+                )
+            if result.tools_used:
+                click.echo(
+                    f"├── Tools used: {', '.join(result.tools_used)}", err=True
+                )
+            if result.search_summary:
+                click.echo(f"├── 🔍 {result.search_summary}", err=True)
+            click.echo(f"└── ✅ {result.completion_summary}", err=True)
+        else:
+            click.echo(f"✅ {result.completion_summary}", err=True)
+
+    def report_cost_breakdown(self, cost_info: CostBreakdown) -> None:
+        """Report transparent cost information to build user trust.
+
+        Args:
+            cost_info: Detailed cost breakdown information
+        """
+        if not self.should_report:
+            return
+
+        if self.detailed:
+            click.echo(
+                f"💰 Cost breakdown: ${cost_info.total:.4f} total", err=True
+            )
+            click.echo(
+                f"  ├── Input tokens ({cost_info.input_tokens:,}): ${cost_info.input_cost:.4f}",
+                err=True,
+            )
+            click.echo(
+                f"  ├── Output tokens ({cost_info.output_tokens:,}): ${cost_info.output_cost:.4f}",
+                err=True,
+            )
+            if cost_info.code_interpreter_cost:
+                click.echo(
+                    f"  ├── Code Interpreter: ${cost_info.code_interpreter_cost:.4f}",
+                    err=True,
+                )
+            if cost_info.file_search_cost:
+                click.echo(
+                    f"  └── File Search: ${cost_info.file_search_cost:.4f}",
+                    err=True,
+                )
+        else:
+            if cost_info.total > 0.01:  # Only show cost if significant
+                if cost_info.has_tool_costs:
+                    click.echo(
+                        f"💰 Total cost: ${cost_info.total:.3f} (model + tools)",
+                        err=True,
+                    )
+                else:
+                    click.echo(
+                        f"💰 Total cost: ${cost_info.total:.3f}", err=True
+                    )
+
+    def report_file_downloads(
+        self, downloaded_files: List[str], download_dir: str
+    ) -> None:
+        """Report file download operations clearly.
+
+        Args:
+            downloaded_files: List of downloaded file paths
+            download_dir: Directory where files were downloaded
+        """
+        if not self.should_report or not downloaded_files:
+            return
+
+        if self.detailed:
+            click.echo(
+                f"📥 Downloaded {len(downloaded_files)} generated files to {download_dir}:",
+                err=True,
+            )
+            for file_path in downloaded_files:
+                click.echo(f"  → {file_path}", err=True)
+        else:
+            click.echo(
+                f"📥 Downloaded {len(downloaded_files)} files to {download_dir}",
+                err=True,
+            )
+
+    def report_error(
+        self,
+        error_type: str,
+        error_message: str,
+        suggestions: Optional[List[str]] = None,
+    ) -> None:
+        """Report errors with helpful context and suggestions.
+
+        Args:
+            error_type: Type of error for categorization
+            error_message: Main error message
+            suggestions: Optional list of actionable suggestions
+        """
+        if not self.should_report:
+            return
+
+        click.echo(f"❌ {error_type}: {error_message}", err=True)
+
+        if suggestions and self.detailed:
+            click.echo("💡 Suggestions:", err=True)
+            for suggestion in suggestions:
+                click.echo(f"  • {suggestion}", err=True)
+
+    def report_validation_results(
+        self,
+        schema_valid: bool,
+        template_valid: bool,
+        token_count: int,
+        token_limit: int,
+    ) -> None:
+        """Report validation results with clear status indicators.
+
+        Args:
+            schema_valid: Whether schema validation passed
+            template_valid: Whether template validation passed
+            token_count: Current token count
+            token_limit: Token limit for the model
+        """
+        if not self.should_report:
+            return
+
+        if self.detailed:
+            click.echo("✅ Validation results:", err=True)
+            click.echo(
+                f"  ├── Schema: {'✅ Valid' if schema_valid else '❌ Invalid'}",
+                err=True,
+            )
+            click.echo(
+                f"  ├── Template: {'✅ Valid' if template_valid else '❌ Invalid'}",
+                err=True,
+            )
+            click.echo(
+                f"  └── Tokens: {token_count:,} / {token_limit:,} ({(token_count / token_limit) * 100:.1f}%)",
+                err=True,
+            )
+        else:
+            if schema_valid and template_valid:
+                usage_pct = (token_count / token_limit) * 100
+                if usage_pct > 80:
+                    click.echo(
+                        f"✅ Validation passed (⚠️  {usage_pct:.0f}% token usage)",
+                        err=True,
+                    )
+                else:
+                    click.echo("✅ Validation passed", err=True)
+
+    def _humanize_optimization(self, technical_message: str) -> str:
+        """Convert technical optimization messages to user-friendly language.
+
+        Args:
+            technical_message: Technical optimization message
+
+        Returns:
+            User-friendly description of the optimization
+        """
+        # Convert technical messages to user-friendly descriptions
+        if (
+            "moved" in technical_message.lower()
+            and "appendix" in technical_message.lower()
+        ):
+            file_name = technical_message.split("Moved ")[-1].split(
+                " to appendix"
+            )[0]
+            return f"Moved large file '{file_name}' to organized appendix"
+        elif "built structured appendix" in technical_message.lower():
+            return "Organized file content into structured appendix for better AI processing"
+        elif "moved directory" in technical_message.lower():
+            return technical_message.replace(
+                "Moved directory", "Organized directory"
+            )
+        else:
+            return technical_message
+
+
+# Global progress reporter instance
+_progress_reporter: Optional[EnhancedProgressReporter] = None
+
+
+def get_progress_reporter() -> EnhancedProgressReporter:
+    """Get the global progress reporter instance.
+
+    Returns:
+        Global progress reporter instance
+    """
+    global _progress_reporter
+    if _progress_reporter is None:
+        _progress_reporter = EnhancedProgressReporter()
+    return _progress_reporter
+
+
+def configure_progress_reporter(
+    verbose: bool = False, progress_level: str = "basic"
+) -> None:
+    """Configure the global progress reporter.
+
+    Args:
+        verbose: Enable verbose logging output
+        progress_level: Progress level (none, basic, detailed)
+    """
+    global _progress_reporter
+    _progress_reporter = EnhancedProgressReporter(verbose, progress_level)
+
+
+def report_phase(phase_name: str, emoji: str = "⚙️") -> None:
+    """Convenience function to report a processing phase."""
+    get_progress_reporter().report_phase(phase_name, emoji)
+
+
+def report_success(message: str) -> None:
+    """Convenience function to report success."""
+    reporter = get_progress_reporter()
+    if reporter.should_report:
+        click.echo(f"✅ {message}", err=True)
+
+
+def report_info(message: str, emoji: str = "ℹ️") -> None:
+    """Convenience function to report information."""
+    reporter = get_progress_reporter()
+    if reporter.should_report:
+        click.echo(f"{emoji} {message}", err=True)

ostruct/cli/registry_updates.py

@@ -11,15 +11,20 @@ import time
 from pathlib import Path
 from typing import Optional, Tuple
 
-from openai_structured.model_registry import (
-    ModelRegistry,
-    RegistryUpdateStatus,
-)
+# Model Registry Integration - Using external openai-model-registry library
+from openai_model_registry import ModelRegistry
+
+
+# For compatibility with existing code
+class RegistryUpdateStatus:
+    UPDATE_AVAILABLE = "UPDATE_AVAILABLE"
+    ALREADY_CURRENT = "ALREADY_CURRENT"
+
 
 logger = logging.getLogger(__name__)
 
 # Constants
-UPDATE_CHECK_ENV_VAR = "OSTRUCT_DISABLE_UPDATE_CHECKS"
+UPDATE_CHECK_ENV_VAR = "OSTRUCT_DISABLE_REGISTRY_UPDATE_CHECKS"
 UPDATE_CHECK_INTERVAL_SECONDS = (
     86400  # Check for updates once per day (24 hours)
 )
@@ -122,17 +127,17 @@ def check_for_registry_updates() -> Tuple[bool, Optional[str]]:
         return False, None
 
     try:
-        registry = ModelRegistry()
+        registry = ModelRegistry.get_instance()
         result = registry.check_for_updates()
 
         # Save the check time regardless of the result
         _save_last_check_time()
 
-        if result.status == RegistryUpdateStatus.UPDATE_AVAILABLE:
+        if result.status.value == "update_available":
             return True, (
                 "A new model registry is available. "
                 "This may include support for new models or features. "
-                "The registry will be automatically updated when needed."
+                "Run 'ostruct update-registry' to update."
             )
 
         return False, None
@@ -154,7 +159,7 @@ def get_update_notification() -> Optional[str]:
     try:
         update_available, message = check_for_registry_updates()
         if update_available and message:
-            return message
+            return str(message)  # Explicit cast to ensure str type
         return None
     except Exception as e:
         # Ensure any errors don't affect normal operation