MONITORING: Fetch Terraform deployment logs with pagination
Fetches logs from a running or completed Terraform deployment job.
For **completed jobs**: uses REST endpoint for instant retrieval (supports `tail` for server-side filtering).
For **running jobs**: streams via SSE with timeout-based pagination.
**PAGINATION** (running jobs only): Use `last_event_id` from the response to fetch more:
1. First call: `tflogs(session_id='...')` → get logs + `last_event_id`
2. Next call: `tflogs(session_id='...', last_event_id='...')` → get NEW logs only
3. Repeat until `complete: true` in response
**RESPONSE FIELDS**:
- `logs`: Array of log messages collected
- `last_event_id`: Pass this back to get more logs (pagination cursor, SSE only)
- `complete`: true if job finished, false if more logs may be available
- `total_logs`: total log entries before tail truncation
REQUIRES: session_id from convoopen response (format: sess_v2_...).
OPTIONAL: job_id to target a specific deployment (use tfruns to discover IDs),
timeout (default 50s, max 55s), last_event_id (for pagination), tail (return only last N entries)
⚠️ CONTEXT WARNING: Deploy logs can be hundreds of lines. Use tail: 50 for completed jobs to avoid blowing up the context window.
Connector