File size: 20,370 Bytes
a477044
e4abb85
c509b44
 
e4abb85
 
c509b44
a477044
 
c16e1c9
 
 
a477044
 
c509b44
a477044
e4abb85
611e2c1
 
 
 
 
 
 
 
 
 
 
e4abb85
 
 
c509b44
 
 
 
e4abb85
 
 
 
c16e1c9
 
 
e4abb85
c16e1c9
 
e4abb85
c16e1c9
c509b44
 
c16e1c9
 
 
c509b44
c16e1c9
 
 
 
 
c509b44
 
 
 
 
 
 
 
 
 
 
 
 
 
c16e1c9
 
e4abb85
c16e1c9
e4abb85
 
a477044
 
c16e1c9
 
a477044
 
 
 
 
 
 
c509b44
 
c16e1c9
 
 
 
 
e4abb85
 
 
 
 
 
 
 
a477044
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
c509b44
 
a477044
 
 
 
c509b44
a477044
c509b44
 
a477044
 
 
 
c509b44
 
c16e1c9
 
e4abb85
 
a477044
 
 
 
 
 
 
 
e4abb85
 
c16e1c9
e4abb85
 
 
 
a477044
 
e4abb85
 
 
a477044
 
 
 
 
e4abb85
 
 
 
 
 
 
a477044
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
e4abb85
c16e1c9
 
 
e4abb85
a477044
 
c16e1c9
 
 
 
e4abb85
c16e1c9
 
 
 
 
 
 
 
 
 
 
e4abb85
 
c16e1c9
 
e4abb85
c16e1c9
 
 
 
 
 
c509b44
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
a477044
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
c509b44
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
from fastapi import APIRouter, Header, HTTPException, Query, UploadFile, File
from pydantic import BaseModel
from typing import List, Optional, Dict, Any
from datetime import datetime, timedelta

from backend.api.storage.rules_store import RulesStore
from backend.api.storage.analytics_store import AnalyticsStore
from backend.api.services.rule_enhancer import RuleEnhancer
from backend.api.services.document_ingestion import extract_text_from_file_bytes

router = APIRouter()

# Initialize stores (table creation disabled by default to avoid blocking startup)
rules_store = RulesStore(auto_create_table=False)
analytics_store = AnalyticsStore()
rule_enhancer = RuleEnhancer()

# Log which backend is being used
if rules_store.use_supabase:
    print("✅ RulesStore: Using Supabase backend")
else:
    print("⚠️  RulesStore: Using SQLite backend (set SUPABASE_URL + SUPABASE_SERVICE_KEY to use Supabase)")

if analytics_store.use_supabase:
    print("✅ AnalyticsStore: Using Supabase backend")
else:
    print("⚠️  AnalyticsStore: Using SQLite backend (set SUPABASE_URL + SUPABASE_SERVICE_KEY to use Supabase)")


class RulePayload(BaseModel):
    rule: str
    pattern: Optional[str] = None  # Regex pattern
    severity: Optional[str] = "medium"  # low, medium, high, critical
    description: Optional[str] = None
    enabled: Optional[bool] = True


class BulkRulePayload(BaseModel):
    rules: List[str]


def get_rules_for_tenant(tenant_id: str) -> List[str]:
    return rules_store.get_rules(tenant_id)


@router.get("/rules")
async def get_redflag_rules(
    x_tenant_id: str = Header(None),
    detailed: bool = Query(False, description="Return full rule metadata including pattern and severity")
):
    """
    Returns all red-flag rules for this tenant.
    Set detailed=true to get full metadata including regex patterns and severity levels.
    """

    if not x_tenant_id:
        raise HTTPException(status_code=400, detail="Missing tenant ID")

    if detailed:
        rules = rules_store.get_rules_detailed(x_tenant_id)
        return {
            "tenant_id": x_tenant_id,
            "rules": rules,
            "count": len(rules)
        }
    else:
        rules = get_rules_for_tenant(x_tenant_id)
        return {
            "tenant_id": x_tenant_id,
            "rules": rules,
            "count": len(rules)
        }


@router.post("/rules")
async def add_redflag_rule(
    payload: Optional[RulePayload] = None,
    rule: Optional[str] = None,
    x_tenant_id: str = Header(None),
    enhance: bool = Query(True, description="Use LLM to enhance the rule before saving")
):
    """
    Adds a new red-flag rule to this tenant.
    
    Flow:
    1. Fetch existing rules for context
    2. Use LLM to analyze and enhance the rule (identify edge cases, improve pattern)
    3. Save enhanced rule to database
    
    Accepts either JSON body or query parameter ?rule=...
    JSON body supports: rule, pattern (regex), severity (low/medium/high/critical), description, enabled
    """

    if not x_tenant_id:
        raise HTTPException(status_code=400, detail="Missing tenant ID")

    rule_value = payload.rule if payload else rule
    if not rule_value:
        raise HTTPException(status_code=400, detail="Missing rule text")

    rule_value = rule_value.strip()
    if not rule_value:
        raise HTTPException(status_code=400, detail="Rule cannot be empty")

    # Step 1: Get existing rules for context
    existing_rules = rules_store.get_rules(x_tenant_id)
    
    # Step 2: Enhance rule using LLM (if enhance=True and LLM available)
    enhanced_data = None
    if enhance:
        try:
            enhanced_data = await rule_enhancer.enhance_rule(
                rule_value,
                existing_rules=existing_rules if existing_rules else None,
                context=payload.description if payload and payload.description else None
            )
        except Exception as e:
            # If enhancement fails, continue with original rule
            print(f"Rule enhancement failed: {e}, using original rule")
            enhanced_data = None
    
    # Step 3: Use enhanced data if available, otherwise use provided values
    if enhanced_data:
        final_rule = enhanced_data["rule"]
        final_pattern = enhanced_data["pattern"]
        final_severity = enhanced_data["severity"]
        final_description = enhanced_data["description"]
        edge_cases = enhanced_data.get("edge_cases", [])
        improvements = enhanced_data.get("improvements", [])
    else:
        # Use provided values or defaults
        final_rule = rule_value
        final_pattern = payload.pattern if payload else None
        final_severity = payload.severity if payload else "medium"
        final_description = payload.description if payload else None
        edge_cases = []
        improvements = []
    
    # Override with explicit values if provided (user has final say)
    if payload:
        if payload.pattern:
            final_pattern = payload.pattern
        if payload.severity:
            final_severity = payload.severity
        if payload.description:
            final_description = payload.description
    
    # Validate severity
    if final_severity not in ["low", "medium", "high", "critical"]:
        final_severity = "medium"
    
    enabled = payload.enabled if payload else True

    # Step 4: Save to database
    rules_store.add_rule(
        x_tenant_id,
        final_rule,
        pattern=final_pattern,
        severity=final_severity,
        description=final_description,
        enabled=enabled
    )
    rules = get_rules_for_tenant(x_tenant_id)

    return {
        "tenant_id": x_tenant_id,
        "original_rule": rule_value,
        "added_rule": final_rule,
        "pattern": final_pattern or final_rule,
        "severity": final_severity,
        "description": final_description or final_rule,
        "enhanced": enhanced_data is not None,
        "edge_cases": edge_cases,
        "improvements": improvements,
        "rules": rules
    }


@router.post("/rules/bulk")
async def add_redflag_rules_bulk(
    payload: BulkRulePayload,
    x_tenant_id: str = Header(None),
    enhance: bool = Query(True, description="Use LLM to enhance rules before saving")
):
    """
    Adds multiple rules in one call.
    
    Flow:
    1. Fetch existing rules for context
    2. Use LLM to enhance each rule (identify edge cases, improve patterns)
    3. Save enhanced rules to database
    """
    if not x_tenant_id:
        raise HTTPException(status_code=400, detail="Missing tenant ID")

    if not payload.rules:
        raise HTTPException(status_code=400, detail="No rules provided")

    # Filter out comment lines (starting with #) and empty lines
    cleaned = [
        rule.strip() 
        for rule in payload.rules 
        if rule.strip() and not rule.strip().startswith("#")
    ]
    
    # Step 1: Get existing rules for context
    existing_rules = rules_store.get_rules(x_tenant_id)
    
    # Step 2: Enhance rules using LLM (with chunk protection)
    enhanced_rules_data = []
    if enhance:
        try:
            # Process rules in chunks to avoid timeout
            # Frontend already chunks to 5, but backend adds extra safety
            CHUNK_SIZE = 5
            for i in range(0, len(cleaned), CHUNK_SIZE):
                chunk = cleaned[i:i + CHUNK_SIZE]
                try:
                    chunk_enhanced = await rule_enhancer.enhance_rules_bulk(
                        chunk,
                        existing_rules=existing_rules if existing_rules else None
                    )
                    enhanced_rules_data.extend(chunk_enhanced)
                except Exception as e:
                    print(f"Chunk {i//CHUNK_SIZE + 1} enhancement failed: {e}")
                    # Add fallback rules for this chunk
                    for rule in chunk:
                        enhanced_rules_data.append({
                            "rule": rule,
                            "pattern": rule,
                            "description": rule,
                            "severity": "medium",
                            "edge_cases": [],
                            "improvements": ["Enhancement failed for this chunk"],
                            "keywords": []
                        })
        except Exception as e:
            print(f"Bulk rule enhancement failed: {e}, using original rules")
            enhanced_rules_data = []
    
    # Step 3: Save enhanced rules to database
    added = []
    enhancement_summary = []
    
    for i, rule in enumerate(cleaned):
        try:
            if enhanced_rules_data and i < len(enhanced_rules_data):
                enhanced = enhanced_rules_data[i]
                success = rules_store.add_rule(
                    x_tenant_id,
                    enhanced["rule"],
                    pattern=enhanced["pattern"],
                    severity=enhanced["severity"],
                    description=enhanced["description"],
                    enabled=True
                )
                if success:
                    added.append(enhanced["rule"])
                    if enhanced.get("improvements") and "failed" not in str(enhanced.get("improvements", [])).lower():
                        enhancement_summary.append(f"{enhanced['rule']}: {', '.join(enhanced['improvements'][:2])}")
            else:
                # Fallback to original rule
                success = rules_store.add_rule(x_tenant_id, rule)
                if success:
                    added.append(rule)
        except Exception as e:
            print(f"Error saving rule {i+1}: {e}")
            # Continue with next rule
            continue
    
    rules = get_rules_for_tenant(x_tenant_id)

    return {
        "tenant_id": x_tenant_id,
        "added_rules": added,
        "enhanced": len(enhanced_rules_data) > 0,
        "enhancement_summary": enhancement_summary,
        "rules": rules
    }


@router.delete("/rules/{rule}")
async def delete_redflag_rule(
    rule: str,
    x_tenant_id: str = Header(None)
):
    """
    Deletes a red-flag rule for this tenant.
    """

    if not x_tenant_id:
        raise HTTPException(status_code=400, detail="Missing tenant ID")

    deleted = rules_store.delete_rule(x_tenant_id, rule)
    if not deleted:
        raise HTTPException(status_code=404, detail="Rule not found")

    rules = get_rules_for_tenant(x_tenant_id)

    return {
        "tenant_id": x_tenant_id,
        "deleted_rule": rule,
        "rules": rules
    }


@router.get("/violations")
async def get_violations(
    x_tenant_id: str = Header(None),
    limit: int = Query(50, description="Maximum number of violations to return"),
    days: int = Query(30, description="Number of days to look back")
):
    """
    Returns red-flag violations for this tenant.
    Includes rule details, severity, confidence, and timestamps.
    """

    if not x_tenant_id:
        raise HTTPException(status_code=400, detail="Missing tenant ID")

    since_timestamp = int((datetime.now() - timedelta(days=days)).timestamp()) if days else None
    violations = analytics_store.get_redflag_violations(x_tenant_id, limit, since_timestamp)

    # Convert timestamps to ISO format
    for violation in violations:
        if "timestamp" in violation:
            violation["timestamp_iso"] = datetime.fromtimestamp(violation["timestamp"]).isoformat()

    return {
        "tenant_id": x_tenant_id,
        "violations": violations,
        "count": len(violations),
        "period_days": days
    }


@router.get("/tools/logs")
async def get_tool_logs(
    x_tenant_id: str = Header(None),
    tool_name: Optional[str] = Query(None, description="Filter by tool name (rag, web, admin, llm)"),
    days: int = Query(7, description="Number of days to look back"),
    limit: int = Query(100, description="Maximum number of logs to return")
):
    """
    Returns detailed tool usage logs for this tenant.
    Includes every tool call with timestamp, latency, tokens, and success/error status.
    """

    if not x_tenant_id:
        raise HTTPException(status_code=400, detail="Missing tenant ID")

    # For now, return aggregated stats. Full log querying would require extending AnalyticsStore
    since_timestamp = int((datetime.now() - timedelta(days=days)).timestamp()) if days else None
    tool_stats = analytics_store.get_tool_usage_stats(x_tenant_id, since_timestamp)

    # Filter by tool if specified
    if tool_name:
        tool_stats = {tool_name: tool_stats.get(tool_name)} if tool_name in tool_stats else {}

    return {
        "tenant_id": x_tenant_id,
        "tool_usage": tool_stats,
        "period_days": days
    }


@router.post("/rules/upload-file")
async def upload_rules_from_file(
    file: UploadFile = File(...),
    x_tenant_id: str = Header(None),
    enhance: bool = Query(True, description="Use LLM to enhance rules before saving")
):
    """
    Upload rules from a file (TXT, PDF, DOC, DOCX).
    Extracts text from the file and processes rules.
    """
    if not x_tenant_id:
        raise HTTPException(status_code=400, detail="Missing tenant ID")
    
    if not file.filename:
        raise HTTPException(status_code=400, detail="No file provided")
    
    file_ext = file.filename.split('.')[-1].lower() if '.' in file.filename else ''
    if file_ext not in ['txt', 'pdf', 'doc', 'docx', 'md']:
        raise HTTPException(
            status_code=400, 
            detail=f"Unsupported file type: {file_ext}. Supported: TXT, PDF, DOC, DOCX, MD"
        )
    
    try:
        # Read file bytes
        file_bytes = await file.read()
        if not file_bytes:
            raise HTTPException(status_code=400, detail="File is empty")
        
        # Extract text from file
        try:
            extracted_text = extract_text_from_file_bytes(file_bytes, file.filename)
        except ValueError as e:
            raise HTTPException(status_code=400, detail=str(e))
        
        if not extracted_text or not extracted_text.strip():
            raise HTTPException(status_code=400, detail="No text could be extracted from file")
        
        # Parse rules (filter comments and empty lines)
        rules = [
            rule.strip() 
            for rule in extracted_text.splitlines() 
            if rule.strip() and not rule.strip().startswith("#")
        ]
        
        if not rules:
            raise HTTPException(status_code=400, detail="No valid rules found in file (after filtering comments)")
        
        # Get existing rules for context
        existing_rules = rules_store.get_rules(x_tenant_id)
        
        # Enhance rules using LLM
        enhanced_rules_data = []
        if enhance:
            try:
                CHUNK_SIZE = 5
                for i in range(0, len(rules), CHUNK_SIZE):
                    chunk = rules[i:i + CHUNK_SIZE]
                    try:
                        chunk_enhanced = await rule_enhancer.enhance_rules_bulk(
                            chunk,
                            existing_rules=existing_rules if existing_rules else None
                        )
                        enhanced_rules_data.extend(chunk_enhanced)
                    except Exception as e:
                        print(f"Chunk {i//CHUNK_SIZE + 1} enhancement failed: {e}")
                        for rule in chunk:
                            enhanced_rules_data.append({
                                "rule": rule,
                                "pattern": rule,
                                "description": rule,
                                "severity": "medium",
                                "edge_cases": [],
                                "improvements": ["Enhancement failed for this chunk"],
                                "keywords": []
                            })
            except Exception as e:
                print(f"Bulk rule enhancement failed: {e}, using original rules")
                enhanced_rules_data = []
        
        # Save rules to database
        added = []
        enhancement_summary = []
        
        for i, rule in enumerate(rules):
            try:
                if enhanced_rules_data and i < len(enhanced_rules_data):
                    enhanced = enhanced_rules_data[i]
                    success = rules_store.add_rule(
                        x_tenant_id,
                        enhanced["rule"],
                        pattern=enhanced["pattern"],
                        severity=enhanced["severity"],
                        description=enhanced["description"],
                        enabled=True
                    )
                    if success:
                        added.append(enhanced["rule"])
                        if enhanced.get("improvements") and "failed" not in str(enhanced.get("improvements", [])).lower():
                            enhancement_summary.append(f"{enhanced['rule']}: {', '.join(enhanced['improvements'][:2])}")
                else:
                    success = rules_store.add_rule(x_tenant_id, rule)
                    if success:
                        added.append(rule)
            except Exception as e:
                print(f"Error saving rule {i+1}: {e}")
                continue
        
        rules_list = get_rules_for_tenant(x_tenant_id)
        
        return {
            "tenant_id": x_tenant_id,
            "filename": file.filename,
            "added_rules": added,
            "total_extracted": len(rules),
            "enhanced": len(enhanced_rules_data) > 0,
            "enhancement_summary": enhancement_summary,
            "rules": rules_list
        }
    
    except HTTPException:
        raise
    except Exception as e:
        raise HTTPException(status_code=500, detail=f"Error processing file: {str(e)}")


@router.post("/setup/table")
async def create_supabase_table(x_tenant_id: str = Header(None)):
    """
    Create the admin_rules table in Supabase if it doesn't exist.
    This endpoint can be called after startup to set up the table.
    """
    try:
        if rules_store.use_supabase:
            success = rules_store.create_table_if_needed()
            if success:
                return {
                    "status": "success",
                    "message": "Table created successfully",
                    "table": "admin_rules"
                }
            else:
                return {
                    "status": "manual_required",
                    "message": "Automatic table creation failed. Please run SQL manually.",
                    "instructions": "Go to Supabase Dashboard → SQL Editor → Run supabase_admin_rules_table.sql"
                }
        else:
            return {
                "status": "not_applicable",
                "message": "Using SQLite, not Supabase. Table creation not needed."
            }
    except Exception as e:
        return {
            "status": "error",
            "message": str(e)
        }


@router.get("/tenants")
async def list_tenants():
    """
    Lists all tenants (placeholder - would need tenant management table).
    For demo purposes, returns info about available tenant data.
    """

    # Placeholder implementation - in production, this would query a tenants table
    return {
        "tenants": [],
        "message": "Tenant management not fully implemented. Use tenant_id in headers for multi-tenant operations."
    }


@router.post("/tenants")
async def create_tenant(
    tenant_id: str,
    metadata: Optional[Dict[str, Any]] = None
):
    """
    Creates a new tenant (placeholder - would need tenant management table).
    """

    # Placeholder implementation
    return {
        "tenant_id": tenant_id,
        "status": "created",
        "message": "Tenant management not fully implemented. Tenant IDs are created on first use."
    }


@router.delete("/tenants/{tenant_id}")
async def delete_tenant(tenant_id: str):
    """
    Deletes a tenant and all associated data (placeholder).
    WARNING: This would delete all rules, analytics, and documents for the tenant.
    """

    # Placeholder implementation
    return {
        "tenant_id": tenant_id,
        "status": "deleted",
        "message": "Tenant deletion not fully implemented. This would delete all tenant data."
    }