Check Deploy Status
tfstatusMONITORING: Quick status check for Terraform deployments Check the current status of a Terraform deployment job. Use this tool to quickly check if a deployment is running, completed, or failed. Returns job status, job_id, and other metadata without streaming logs. Use tflogs to stream the actual deployment logs. REQUIRES: session_id from convoopen response (format: sess_v2_...). OPTIONAL: job_id to target a specific deployment (use tfruns to discover IDs).
LIVENESS: The response carries two distinct timestamps:
updated_atā last semantic change (only bumped when status / drift / version actually differ). Useful for sorting deployments; NOT a per-poll heartbeat.last_refresh_atā last successful Oracle decode (stamped on every poll where reliable reached Oracle, even if nothing in the row changed). Use this to confirm reliable is still actively talking to Oracle for a long-running RUNNING job. Absent on rows that haven't been refreshed since the column was added. š” TIP: Examine workflow.usage prompt for more context on how to properly use these tools.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>"
},
"name": "tfstatus"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | No | Optional. Specific job ID to inspect. When omitted, returns the status of the latest job for the session. | |
| session_id | Yes | Session ID from convoopen ā pass back EXACTLY as returned, including the ?token=... suffix (format: sess_v2_*?token=*). The suffix is part of the session credential; never strip it when summarizing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| found | No | False when the session has no job yet. | |
| hints | No | Guidance for the calling agent: what to do next and which tools relate to this result. | |
| job_id | No | ID of the job reported on. | |
| status | No | Job status, for example 'pending', 'running', 'succeeded' or 'failed'. | |
| job_key | No | Job type key (for example 'apply', 'destroy', 'plan', 'drift'). | |
| created_at | No | Job creation time (RFC 3339). | |
| session_id | No | Session ID this status belongs to. | |
| updated_at | No | Time of the job's last status change (RFC 3339). | |
| version_id | No | ID of the stack version the job ran. | |
| plan_summary | No | Summary of the Terraform plan, for plan and drift jobs. | |
| draft_version | No | Draft stack version number, when a draft exists. | |
| last_event_id | No | Log cursor. Pass it to tflogs to fetch only newer entries. | |
| drift_detected | No | True when a drift check found differences from the deployed state. | |
| version_number | No | Number of the stack version the job ran. | |
| version_status | No | Status of that stack version. | |
| current_version | No | Latest committed stack version number. | |
| last_refresh_at | No | Time the backend last polled the deploy runner for this job (RFC 3339). | |
| presets_version | No | Terraform presets version the runner used. | |
| drift_actionable | No | True when the drift would make Terraform apply changes; false when it is refresh-only noise. | |
| template_version | No | Infrastructure template version the runner used. | |
| has_pending_changes | No | True when the draft stack differs from the deployed version. | |
| drift_classification | No | Per-resource drift verdicts, when the drift check could classify them. | |
| custom_presets_version | No | Terraform presets version InsideOut composed the stack with. | |
| custom_template_version | No | Infrastructure template version InsideOut composed the stack with. |