ai-lls-lib 1.5.0rc4__py3-none-any.whl → 1.5.0rc7__py3-none-any.whl

ai_lls_lib/__init__.py

@@ -17,7 +17,7 @@ from ai_lls_lib.core.verifier import PhoneVerifier
 from ai_lls_lib.core.processor import BulkProcessor
 from ai_lls_lib.core.cache import DynamoDBCache
 
-__version__ = "1.5.0-rc.4"
+__version__ = "1.5.0-rc.7"
 __all__ = [
     "PhoneVerification",
     "BulkJob",

ai_lls_lib/cli/__main__.py

@@ -5,7 +5,7 @@ import click
 import sys
 import os
 from pathlib import Path
-from ai_lls_lib.cli.commands import verify, cache, admin, test_stack, stripe
+from ai_lls_lib.cli.commands import verify, cache, admin, test_stack, stripe, monitor
 from ai_lls_lib.cli.env_loader import load_env_file
 
 def load_env_files(verbose=False):
@@ -49,6 +49,7 @@ cli.add_command(cache.cache_group)
 cli.add_command(admin.admin_group)
 cli.add_command(test_stack.test_stack_group)
 cli.add_command(stripe.stripe_group)
+cli.add_command(monitor.monitor_group)
 
 def main():
     """Main entry point"""

ai_lls_lib/cli/aws_client.py

@@ -27,6 +27,7 @@ class AWSClient:
         self._sqs = None
         self._secretsmanager = None
         self._cloudformation = None
+        self._logs = None
 
     @property
     def dynamodb(self):
@@ -63,6 +64,13 @@ class AWSClient:
             self._cloudformation = self.session.client('cloudformation')
         return self._cloudformation
 
+    @property
+    def logs(self):
+        """Get CloudWatch Logs client"""
+        if not self._logs:
+            self._logs = self.session.client('logs')
+        return self._logs
+
     def get_stack_outputs(self, stack_name: str) -> Dict[str, str]:
         """Get CloudFormation stack outputs"""
         try:

ai_lls_lib/cli/commands/monitor.py

@@ -0,0 +1,297 @@
+"""
+Real-time CloudWatch log monitoring for Lambda functions
+"""
+import click
+import json
+import time
+from datetime import datetime, timedelta
+from typing import Optional, List, Dict
+from botocore.exceptions import ClientError
+from ai_lls_lib.cli.aws_client import AWSClient
+
+try:
+    from rich.console import Console
+    from rich.syntax import Syntax
+    from rich.table import Table
+    from rich.live import Live
+    from rich.panel import Panel
+    from rich.text import Text
+    from rich import box
+    HAS_RICH = True
+except ImportError:
+    HAS_RICH = False
+    Console = None
+
+
+def get_log_groups(aws_client: AWSClient, environment: str) -> List[str]:
+    """Get relevant CloudWatch log groups for the environment"""
+    # Map environment to stack name pattern
+    stack_prefix = "landline-api-staging" if environment == "staging" else "landline-api"
+
+    # Key Lambda functions to monitor
+    lambda_functions = [
+        "PhoneVerifyHandler",
+        "BulkUploadHandler",
+        "BulkProcessHandler",
+        "PlansHandler",
+        "PaymentHandler",
+        "UserProfileHandler"
+    ]
+
+    log_groups = []
+    for func in lambda_functions:
+        log_group = f"/aws/lambda/{stack_prefix}-{func}"
+        log_groups.append(log_group)
+
+    return log_groups
+
+
+def format_log_event(event: Dict, use_rich: bool = True) -> str:
+    """Format a CloudWatch log event for display"""
+    timestamp = datetime.fromtimestamp(event.get('timestamp', 0) / 1000)
+    message = event.get('message', '')
+
+    # Try to parse JSON message
+    try:
+        if message.strip().startswith('{'):
+            parsed = json.loads(message)
+
+            # Check for external API calls
+            if 'external_api_call' in message.lower() or 'landlineremover.com' in message:
+                if use_rich and HAS_RICH:
+                    return f"[bold green]{timestamp.strftime('%H:%M:%S')}[/bold green] [cyan]EXTERNAL API:[/cyan] {message}"
+                else:
+                    return f"{timestamp.strftime('%H:%M:%S')} EXTERNAL API: {message}"
+
+            # Check for cache events
+            if 'cache' in message.lower():
+                if use_rich and HAS_RICH:
+                    return f"[bold blue]{timestamp.strftime('%H:%M:%S')}[/bold blue] [yellow]CACHE:[/yellow] {message}"
+                else:
+                    return f"{timestamp.strftime('%H:%M:%S')} CACHE: {message}"
+
+            # Check for errors
+            if 'error' in message.lower() or 'exception' in message.lower():
+                if use_rich and HAS_RICH:
+                    return f"[bold red]{timestamp.strftime('%H:%M:%S')}[/bold red] [red]ERROR:[/red] {message}"
+                else:
+                    return f"{timestamp.strftime('%H:%M:%S')} ERROR: {message}"
+
+            # Format structured logs
+            if use_rich and HAS_RICH:
+                message = json.dumps(parsed, indent=2)
+    except (json.JSONDecodeError, ValueError):
+        pass
+
+    # Default formatting
+    if use_rich and HAS_RICH:
+        return f"[dim]{timestamp.strftime('%H:%M:%S')}[/dim] {message}"
+    else:
+        return f"{timestamp.strftime('%H:%M:%S')} {message}"
+
+
+def tail_logs(aws_client: AWSClient, log_groups: List[str], duration: int = 300, follow: bool = True):
+    """Tail CloudWatch logs in real-time"""
+    console = Console() if HAS_RICH else None
+
+    # Calculate start time
+    start_time = int((datetime.utcnow() - timedelta(seconds=duration)).timestamp() * 1000)
+
+    # Track last event time for each log group
+    last_event_times = {group: start_time for group in log_groups}
+
+    if console and HAS_RICH:
+        console.print(Panel.fit(
+            f"[bold cyan]Monitoring {len(log_groups)} Lambda functions[/bold cyan]\n"
+            f"[dim]Press Ctrl+C to stop[/dim]",
+            title="CloudWatch Log Monitor",
+            border_style="cyan"
+        ))
+        console.print()
+    else:
+        click.echo(f"Monitoring {len(log_groups)} Lambda functions")
+        click.echo("Press Ctrl+C to stop\n")
+
+    try:
+        while True:
+            events_found = False
+
+            for log_group in log_groups:
+                try:
+                    # Use filter_log_events for real-time tailing
+                    response = aws_client.logs.filter_log_events(
+                        logGroupName=log_group,
+                        startTime=last_event_times[log_group],
+                        limit=100
+                    )
+
+                    events = response.get('events', [])
+
+                    if events:
+                        events_found = True
+                        # Update last event time
+                        last_event_times[log_group] = events[-1]['timestamp'] + 1
+
+                        # Display log group header
+                        if console and HAS_RICH:
+                            console.print(f"\n[bold magenta]═══ {log_group} ═══[/bold magenta]")
+                        else:
+                            click.echo(f"\n=== {log_group} ===")
+
+                        # Display events
+                        for event in events:
+                            formatted = format_log_event(event, use_rich=(console is not None))
+                            if console and HAS_RICH:
+                                console.print(formatted)
+                            else:
+                                click.echo(formatted)
+
+                except ClientError as e:
+                    if e.response['Error']['Code'] != 'ResourceNotFoundException':
+                        if console and HAS_RICH:
+                            console.print(f"[yellow]Warning: {e}[/yellow]")
+                        else:
+                            click.echo(f"Warning: {e}", err=True)
+
+            if not follow:
+                break
+
+            # Sleep briefly before next poll
+            time.sleep(2 if events_found else 5)
+
+    except KeyboardInterrupt:
+        if console and HAS_RICH:
+            console.print("\n[yellow]Monitoring stopped[/yellow]")
+        else:
+            click.echo("\nMonitoring stopped")
+
+
+def start_live_tail(aws_client: AWSClient, log_groups: List[str]):
+    """Start a CloudWatch Logs Live Tail session (requires AWS SDK v2)"""
+    console = Console() if HAS_RICH else None
+
+    try:
+        # Start live tail session
+        response = aws_client.logs.start_live_tail(
+            logGroupIdentifiers=log_groups,
+            logStreamNamePrefixes=[],
+            logEventFilterPattern=""
+        )
+
+        session_id = response.get('sessionId')
+        session_url = response.get('sessionUrl')
+
+        if console and HAS_RICH:
+            console.print(Panel.fit(
+                f"[bold green]Live Tail session started[/bold green]\n"
+                f"Session ID: {session_id}\n"
+                f"[dim]Note: Live Tail API requires WebSocket support[/dim]",
+                title="CloudWatch Live Tail",
+                border_style="green"
+            ))
+        else:
+            click.echo(f"Live Tail session started")
+            click.echo(f"Session ID: {session_id}")
+            click.echo(f"Note: Live Tail API requires WebSocket support")
+
+        # Note: Full WebSocket implementation would be needed here
+        # For now, fall back to filter_log_events polling
+        click.echo("\nFalling back to standard log polling...")
+        tail_logs(aws_client, log_groups, duration=300, follow=True)
+
+    except ClientError as e:
+        if 'start_live_tail' in str(e):
+            # Fall back to regular tailing if Live Tail not available
+            if console and HAS_RICH:
+                console.print("[yellow]Live Tail API not available, using standard polling[/yellow]")
+            else:
+                click.echo("Live Tail API not available, using standard polling")
+            tail_logs(aws_client, log_groups, duration=300, follow=True)
+        else:
+            raise
+
+
+@click.group(name="monitor")
+def monitor_group():
+    """Monitor CloudWatch logs in real-time"""
+    pass
+
+
+@monitor_group.command()
+@click.option('--staging', is_flag=True, help='Monitor staging environment (default: production)')
+@click.option('--production', is_flag=True, help='Monitor production environment')
+@click.option('--duration', default=300, help='How far back to start (seconds, default: 300)')
+@click.option('--follow', is_flag=True, default=True, help='Follow logs in real-time (default: true)')
+@click.option('--filter', 'filter_pattern', help='CloudWatch filter pattern to apply')
+@click.option('--profile', help='AWS profile to use')
+@click.option('--region', default='us-east-1', help='AWS region')
+def logs(staging, production, duration, follow, filter_pattern, profile, region):
+    """Tail CloudWatch logs for Lambda functions
+
+    Examples:
+        ai-lls monitor logs --staging
+        ai-lls monitor logs --production
+        ai-lls monitor logs --staging --filter "ERROR"
+        ai-lls monitor logs --duration 600 --follow
+    """
+    # Determine environment
+    if staging and production:
+        raise click.ClickException("Cannot specify both --staging and --production")
+
+    environment = "staging" if staging else "production"
+
+    # Show warning if Rich not installed
+    if not HAS_RICH:
+        click.echo("Warning: Install 'rich' library for better output formatting", err=True)
+        click.echo("Run: pip install rich", err=True)
+        click.echo()
+
+    # Initialize AWS client
+    aws_client = AWSClient(region=region, profile=profile)
+
+    # Get log groups
+    log_groups = get_log_groups(aws_client, environment)
+
+    click.echo(f"Monitoring {environment} environment...")
+    click.echo(f"Log groups: {', '.join([g.split('/')[-1] for g in log_groups])}")
+    click.echo()
+
+    # Start tailing logs
+    tail_logs(aws_client, log_groups, duration=duration, follow=follow)
+
+
+@monitor_group.command()
+@click.option('--staging', is_flag=True, help='Monitor staging environment')
+@click.option('--production', is_flag=True, help='Monitor production environment')
+@click.option('--profile', help='AWS profile to use')
+@click.option('--region', default='us-east-1', help='AWS region')
+def live(staging, production, profile, region):
+    """Start CloudWatch Logs Live Tail session (experimental)
+
+    Uses the CloudWatch Logs Live Tail API for real-time streaming.
+    Falls back to standard polling if Live Tail is not available.
+
+    Examples:
+        ai-lls monitor live --staging
+        ai-lls monitor live --production
+    """
+    # Determine environment
+    if staging and production:
+        raise click.ClickException("Cannot specify both --staging and --production")
+
+    environment = "staging" if staging else "production"
+
+    # Initialize AWS client
+    aws_client = AWSClient(region=region, profile=profile)
+
+    # Get log groups
+    log_groups = get_log_groups(aws_client, environment)
+
+    click.echo(f"Starting Live Tail for {environment} environment...")
+
+    # Start live tail
+    start_live_tail(aws_client, log_groups)
+
+
+# Export the group for registration
+__all__ = ['monitor_group']

{ai_lls_lib-1.5.0rc4.dist-info → ai_lls_lib-1.5.0rc7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-lls-lib
-Version: 1.5.0rc4
+Version: 1.5.0rc7
 Summary: Landline Scrubber core library - phone verification and DNC checking
 Author: LandlineScrubber Team
 Requires-Python: >=3.12,<4.0
@@ -12,7 +12,9 @@ Requires-Dist: aws-lambda-powertools (>=2.30.0,<3.0.0)
 Requires-Dist: boto3 (>=1.34.0,<2.0.0)
 Requires-Dist: click (>=8.1.0,<9.0.0)
 Requires-Dist: httpx (>=0.25.0,<0.26.0)
+Requires-Dist: pandas (>=2.3.3,<3.0.0)
 Requires-Dist: phonenumbers (>=8.13.0,<9.0.0)
+Requires-Dist: pyarrow (>=22.0.0,<23.0.0)
 Requires-Dist: pydantic (>=2.5.0,<3.0.0)
 Requires-Dist: rich (>=14.0,<15.0)
 Requires-Dist: stripe (>=12.5.1,<13.0.0)
@@ -186,6 +188,33 @@ ai-lls test-stack test
 ai-lls test-stack delete
 ```
 
+### CloudWatch Log Monitoring
+```bash
+# Monitor staging environment logs in real-time
+ai-lls monitor logs --staging
+
+# Monitor production environment logs
+ai-lls monitor logs --production
+
+# Monitor with custom duration (look back 10 minutes)
+ai-lls monitor logs --staging --duration 600
+
+# Filter logs for errors only
+ai-lls monitor logs --staging --filter "ERROR"
+
+# Use specific AWS profile
+ai-lls monitor logs --staging --profile myprofile
+
+# Experimental: Use CloudWatch Logs Live Tail API
+ai-lls monitor live --staging
+```
+
+The monitor command provides real-time log streaming from Lambda functions with:
+- Color-coded output for different event types (external API calls, cache events, errors)
+- Support for multiple log groups simultaneously
+- Rich formatting when the `rich` library is installed
+- Automatic detection of external API calls to landlineremover.com
+
 ## Project Structure
 
 ```

{ai_lls_lib-1.5.0rc4.dist-info → ai_lls_lib-1.5.0rc7.dist-info}/RECORD

@@ -1,12 +1,13 @@
-ai_lls_lib/__init__.py,sha256=me5F-kAI_umDdD_bPb-PTQhVFshB93w7c3wfU9W6t0Y,734
+ai_lls_lib/__init__.py,sha256=u1GD2lQF53p0u6gHgLdVgIJFn8ysIi3RbMYQkB9VsGU,734
 ai_lls_lib/auth/__init__.py,sha256=ZjwlfTvYUo9A9BaLinaXW2elxYectScmu0XtKAppSFs,198
 ai_lls_lib/auth/context_parser.py,sha256=AWyGWejrFR0jJ7fMhajdA1ABo656Qlvs2YAzz-IfTrs,2290
 ai_lls_lib/cli/__init__.py,sha256=HyjnIBGlrbTlHQ82n_UppjtJbZl4_7QsnAgRqNlXKMU,77
-ai_lls_lib/cli/__main__.py,sha256=3G1Mmkaa7NfEHILpZbDVqu4yPfy5TVx7QaAmlp2TSGc,2071
-ai_lls_lib/cli/aws_client.py,sha256=lqihYQQtpx8Xb5HcVTbexl1pZdlYYdozPLDEGcen27Q,4067
+ai_lls_lib/cli/__main__.py,sha256=OLpqz78s2nAtib7soqI-WQ2_V9aqa9Cd4NRwvso0IbM,2120
+ai_lls_lib/cli/aws_client.py,sha256=yJ_seXyAOSy1xFqUHD8CScnN5un18b2412a7pUG_UQs,4283
 ai_lls_lib/cli/commands/__init__.py,sha256=yi0bdkZSPIXY33apvJRcuK410-Ta0-_-n31MQYuL_aU,31
 ai_lls_lib/cli/commands/admin.py,sha256=JlFljbblVWJkJ2z2FIM6P0fy3Pmc0VqG62Y3POtvRFw,6861
 ai_lls_lib/cli/commands/cache.py,sha256=1Vm3m5vXJkRagNmQXpT8_YEsQEv92veJUFwA_v9FPb0,5822
+ai_lls_lib/cli/commands/monitor.py,sha256=TLbf5Q_viwF7q_aPXo9XenzY4W0R1bjO68Iu8KlzvoE,11315
 ai_lls_lib/cli/commands/stripe.py,sha256=_aRsz6Z7BN-S9_07efUovXwsbL-eCE-raw1uBOkDP5g,15276
 ai_lls_lib/cli/commands/test_stack.py,sha256=FK6ITOek7j4e0QiSNTv_taLghNnR8d_kWG02cl0A3rY,7594
 ai_lls_lib/cli/commands/verify.py,sha256=8rTg8xbdQbJdebDy5CT7HFcJ-ODFZdAOAo2JX82ARJs,8522
@@ -27,7 +28,7 @@ ai_lls_lib/providers/external.py,sha256=MKu3BZV8gfSqV3lNcF9Vt4UmKIJixQ5Q7FI2wFeS
 ai_lls_lib/providers/stub.py,sha256=XXUObkIb3hs7_fYMA9mlLh1llJUGIgqQHVjgZHZl1T8,1199
 ai_lls_lib/testing/__init__.py,sha256=NytBz7T0YtNLDArRYHsczaeopIQmmBeV21-XXUprdeY,42
 ai_lls_lib/testing/fixtures.py,sha256=OC1huorIqUndePoUTfgoU-aDvsWAFJqmQ6fGDjH9E14,3414
-ai_lls_lib-1.5.0rc4.dist-info/METADATA,sha256=lHqVjmDxXEZvcjo-DNXugzdHbD3tqcIBYK_uRkDQBTw,7302
-ai_lls_lib-1.5.0rc4.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-ai_lls_lib-1.5.0rc4.dist-info/entry_points.txt,sha256=Pi0V_HBViEKGFbNQKatl5lhhnHHBXlxaom-5gH9gXZ0,55
-ai_lls_lib-1.5.0rc4.dist-info/RECORD,,
+ai_lls_lib-1.5.0rc7.dist-info/METADATA,sha256=-IDPXAzq0hRrsac3G-oxXzovpRY9DE78b20OYsameeM,8256
+ai_lls_lib-1.5.0rc7.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+ai_lls_lib-1.5.0rc7.dist-info/entry_points.txt,sha256=Pi0V_HBViEKGFbNQKatl5lhhnHHBXlxaom-5gH9gXZ0,55
+ai_lls_lib-1.5.0rc7.dist-info/RECORD,,