codex-in-claude

Overview Schema Source Related Servers Discussions Admin

Fetch job result (free)

codex_job_result

Read-only

Retrieve the stored result of a finished asynchronous Codex job—diff, consult, or review—without deleting its record; use once status reports the result is available.

Instructions

Deprecated: use amicus_job_result. Fetch a finished background Codex job's result WITHOUT deleting the record.

Works for any async job or sync consult/review/delegate (whose meta.job_id names its record) — codex_delegate_async (a diff), codex_consult_async (a consult answer), or codex_review_changes_async (a review with verdict). Use when codex_job_status reports result_available=true; the envelope matches the job's kind, so branch on tool. meta.job_id is set. A still-running/cancelled/timed- out/failed job returns an error envelope — as does a done job whose stored result this release cannot read (job_result_incompatible). To fetch and delete, use codex_job_consume_result. Free — no model call.

detail="summary" (default) omits the raw model text; pass detail="full" for the complete raw output and metadata (#56).

Input Schema

TableJSON Schema

Name	Required	Description	Default
`detail`	No	Response verbosity: 'summary' (default) omits the raw model text; 'full' includes it.	summary
`job_id`	Yes	The job_id from an *_async call or a sync call's meta.job_id; recover lost ids with codex_job_list. Control characters are rejected, not stripped.
`workspace_root`	No	Absolute path to the target repo root — pass it (or an MCP root) to target the intended repo; otherwise the call falls back to the server's own cwd and sets meta.workspace_warning. On an active call it selects where Codex works, not what it can read — it is not a read boundary.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`ok`	Yes	true = success result, false = error result

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedv0.19.0Aug 22, 2026

changedInput schema / properties / job_id / description

Previous value: -"The job_id from an *_async call or a sync call's meta.job_id; recover lost ids with codex_job_list."New value: +"The job_id from an *_async call or a sync call's meta.job_id; recover lost ids with codex_job_list. Control characters are rejected, not stripped."

addedInput schema / properties / job_id / pattern
```
Added value: +"^[^\\x00-\\x1F\\x7F-\\x9F]*$"
```

changedInput schema / properties / workspace_root / description

Previous value: -"Absolute path to the target repo root — pass it (or an MCP root) to target the intended repo; otherwise the call falls back to the server's own cwd and sets meta.workspace_warning."New value: +"Absolute path to the target repo root — pass it (or an MCP root) to target the intended repo; otherwise the call falls back to the server's own cwd and sets meta.workspace_warning. On an active call it selects where Codex works, not what it can read — it is not a read boundary."

Changed1 schema field changedv0.17.0Aug 3, 2026

changedInput schema / properties / workspace_root / description

Previous value: -"Absolute path to the target repository root. Pass it (or rely on an MCP root) so the call targets the intended repo; otherwise it falls back to the server's own cwd and meta.workspace_warning is set."New value: +"Absolute path to the target repo root — pass it (or an MCP root) to target the intended repo; otherwise the call falls back to the server's own cwd and sets meta.workspace_warning."

Changed4 schema fields changedv0.8.0Jul 6, 2026

changedInput schema / properties / job_id / description

Previous value: -"The job_id returned by an *_async call (codex_*_async); recover lost ids with codex_job_list."New value: +"The job_id from an *_async call or a sync call's meta.job_id; recover lost ids with codex_job_list."

addedOutput schema / $schema

Added value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "diff": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "findings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "evidence": {
-              "type": "string"
-            },
-            "file": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "line": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "line_end": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "recommendation": {
-              "type": "string"
-            },
-            "risk": {
-              "type": "string"
-            },
-            "severity": {
-              "enum": [
-                "critical",
-                "high",
-                "medium",
-                "low",
-                "nit"
-              ],
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "severity",
-            "title",
-            "evidence",
-            "risk",
-            "recommendation"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "additionalProperties": false,
-        "properties": {
-          "base": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "command_exit_code": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "commit": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "compat_warnings": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "context_summary": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "files_changed": {
-                    "type": "integer"
-                  },
-                  "lines_added": {
-                    "type": "integer"
-                  },
-                  "lines_removed": {
-                    "type": "integer"
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "cwd": {
-            "type": "string"
-          },
-          "elapsed_ms": {
-            "type": "integer"
-          },
-          "fingerprint": {
-            "type": "string"
-          },
-          "isolation": {
-            "enum": [
-              "inherit",
-              "ignore-config",
-              "ignore-rules"
-            ],
-            "type": "string"
-          },
-          "job_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "model": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "paths": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "rate_limit": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "age_seconds": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "as_of": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "home_unverified": {
-                    "type": "boolean"
-                  },
-                  "is_stale": {
-                    "type": "boolean"
-                  },
-                  "limiting_window": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "primary",
-                          "secondary"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "note": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "plan_type": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "primary": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "remaining_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "reset_passed": {
-                            "type": "boolean"
-                          },
-                          "resets_at": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "seconds_until_reset": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "used_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "window_minutes": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "secondary": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "remaining_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "reset_passed": {
-                            "type": "boolean"
-                          },
-                          "resets_at": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "seconds_until_reset": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "used_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "window_minutes": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "source": {
-                    "enum": [
-                      "current_run",
-                      "plugin_cache"
-                    ],
-                    "type": "string"
-                  },
-                  "status": {
-                    "enum": [
-                      "available",
-                      "limited",
-                      "exhausted",
-                      "unknown"
-                    ],
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "status"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "redacted_paths": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "request_id": {
-            "type": "string"
-          },
-          "sandbox": {
-            "enum": [
-              "read-only",
-              "workspace-write",
-              "danger-full-access"
-            ],
-            "type": "string"
-          },
-          "scope": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "security_warnings": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tier": {
-            "enum": [
-              "consult",
-              "propose",
-              "apply"
-            ],
-            "type": "string"
-          },
-          "timeout_seconds": {
-            "type": "integer"
-          },
-          "truncated": {
-            "type": "boolean"
-          },
-          "truncation_hint": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "usage": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "cached_input_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "input_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "output_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "total_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "workspace_source": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "workspace_warning": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "cwd",
-          "tier",
-          "sandbox",
-          "isolation",
-          "timeout_seconds",
-          "elapsed_ms"
-        ],
-        "type": "object"
-      },
-      "next_steps": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "ok": {
-        "const": true,
-        "type": "boolean"
-      },
-      "questions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "raw_response": {
-        "additionalProperties": false,
-        "properties": {
-          "model": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "text": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "type": "string"
-      },
-      "tool": {
-        "const": "codex_delegate",
-        "type": "string"
-      }
-    },
-    "required": [
-      "summary",
-      "meta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "findings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "evidence": {
-              "type": "string"
-            },
-            "file": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "line": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "line_end": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "recommendation": {
-              "type": "string"
-            },
-            "risk": {
-              "type": "string"
-            },
-            "severity": {
-              "enum": [
-                "critical",
-                "high",
-                "medium",
-                "low",
-                "nit"
-              ],
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "severity",
-            "title",
-            "evidence",
-            "risk",
-            "recommendation"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "additionalProperties": false,
-        "properties": {
-          "base": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "command_exit_code": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "commit": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "compat_warnings": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "context_summary": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "files_changed": {
-                    "type": "integer"
-                  },
-                  "lines_added": {
-                    "type": "integer"
-                  },
-                  "lines_removed": {
-                    "type": "integer"
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "cwd": {
-            "type": "string"
-          },
-          "elapsed_ms": {
-            "type": "integer"
-          },
-          "fingerprint": {
-            "type": "string"
-          },
-          "isolation": {
-            "enum": [
-              "inherit",
-              "ignore-config",
-              "ignore-rules"
-            ],
-            "type": "string"
-          },
-          "job_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "model": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "paths": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "rate_limit": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "age_seconds": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "as_of": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "home_unverified": {
-                    "type": "boolean"
-                  },
-                  "is_stale": {
-                    "type": "boolean"
-                  },
-                  "limiting_window": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "primary",
-                          "secondary"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "note": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "plan_type": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "primary": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "remaining_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "reset_passed": {
-                            "type": "boolean"
-                          },
-                          "resets_at": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "seconds_until_reset": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "used_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "window_minutes": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "secondary": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "remaining_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "reset_passed": {
-                            "type": "boolean"
-                          },
-                          "resets_at": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "seconds_until_reset": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "used_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "window_minutes": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "source": {
-                    "enum": [
-                      "current_run",
-                      "plugin_cache"
-                    ],
-                    "type": "string"
-                  },
-                  "status": {
-                    "enum": [
-                      "available",
-                      "limited",
-                      "exhausted",
-                      "unknown"
-                    ],
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "status"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "redacted_paths": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "request_id": {
-            "type": "string"
-          },
-          "sandbox": {
-            "enum": [
-              "read-only",
-              "workspace-write",
-              "danger-full-access"
-            ],
-            "type": "string"
-          },
-          "scope": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "security_warnings": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tier": {
-            "enum": [
-              "consult",
-              "propose",
-              "apply"
-            ],
-            "type": "string"
-          },
-          "timeout_seconds": {
-            "type": "integer"
-          },
-          "truncated": {
-            "type": "boolean"
-          },
-          "truncation_hint": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "usage": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "cached_input_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "input_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "output_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "total_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "workspace_source": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "workspace_warning": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "cwd",
-          "tier",
-          "sandbox",
-          "isolation",
-          "timeout_seconds",
-          "elapsed_ms"
-        ],
-        "type": "object"
-      },
-      "next_steps": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "ok": {
-        "const": true,
-        "type": "boolean"
-      },
-      "questions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "raw_response": {
-        "additionalProperties": false,
-        "properties": {
-          "model": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "text": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "type": "string"
-      },
-      "tool": {
-        "const": "codex_consult",
-        "type": "string"
-      }
-    },
-    "required": [
-      "summary",
-      "meta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "confidence": {
-        "enum": [
-          "low",
-          "medium",
-          "high"
-        ],
-        "type": "string"
-      },
-      "findings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "evidence": {
-              "type": "string"
-            },
-            "file": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "line": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "line_end": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "recommendation": {
-              "type": "string"
-            },
-            "risk": {
-              "type": "string"
-            },
-            "severity": {
-              "enum": [
-                "critical",
-                "high",
-                "medium",
-                "low",
-                "nit"
-              ],
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "severity",
-            "title",
-            "evidence",
-            "risk",
-            "recommendation"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "additionalProperties": false,
-        "properties": {
-          "base": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "command_exit_code": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "commit": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "compat_warnings": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "context_summary": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "files_changed": {
-                    "type": "integer"
-                  },
-                  "lines_added": {
-                    "type": "integer"
-                  },
-                  "lines_removed": {
-                    "type": "integer"
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "cwd": {
-            "type": "string"
-          },
-          "elapsed_ms": {
-            "type": "integer"
-          },
-          "fingerprint": {
-            "type": "string"
-          },
-          "isolation": {
-            "enum": [
-              "inherit",
-              "ignore-config",
-              "ignore-rules"
-            ],
-            "type": "string"
-          },
-          "job_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "model": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "paths": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "rate_limit": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "age_seconds": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "as_of": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "home_unverified": {
-                    "type": "boolean"
-                  },
-                  "is_stale": {
-                    "type": "boolean"
-                  },
-                  "limiting_window": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "primary",
-                          "secondary"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "note": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "plan_type": {
-                    "anyOf": [
-                      {
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "primary": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "remaining_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "reset_passed": {
-                            "type": "boolean"
-                          },
-                          "resets_at": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "seconds_until_reset": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "used_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "window_minutes": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "secondary": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "remaining_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "reset_passed": {
-                            "type": "boolean"
-                          },
-                          "resets_at": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "seconds_until_reset": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "used_percent": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "window_minutes": {
-                            "anyOf": [
-                              {
-                                "type": "integer"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "source": {
-                    "enum": [
-                      "current_run",
-                      "plugin_cache"
-                    ],
-                    "type": "string"
-                  },
-                  "status": {
-                    "enum": [
-                      "available",
-                      "limited",
-                      "exhausted",
-                      "unknown"
-                    ],
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "status"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "redacted_paths": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "request_id": {
-            "type": "string"
-          },
-          "sandbox": {
-            "enum": [
-              "read-only",
-              "workspace-write",
-              "danger-full-access"
-            ],
-            "type": "string"
-          },
-          "scope": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "security_warnings": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tier": {
-            "enum": [
-              "consult",
-              "propose",
-              "apply"
-            ],
-            "type": "string"
-          },
-          "timeout_seconds": {
-            "type": "integer"
-          },
-          "truncated": {
-            "type": "boolean"
-          },
-          "truncation_hint": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "usage": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "cached_input_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "input_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "output_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "total_tokens": {
-                    "anyOf": [
-                      {
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "workspace_source": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "workspace_warning": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "cwd",
-          "tier",
-          "sandbox",
-          "isolation",
-          "timeout_seconds",
-          "elapsed_ms"
-        ],
-        "type": "object"
-      },
-      "next_steps": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "ok": {
-        "const": true,
-        "type": "boolean"
-      },
-      "questions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "raw_response": {
-        "additionalProperties": false,
-        "properties": {
-          "model": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "text": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "type": "string"
-      },
-      "tool": {
-        "const": "codex_review_changes",
-        "type": "string"
-      },
-      "verdict": {
-        "enum": [
-          "pass",
-          "concerns",
-          "fail",
-          "unknown"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "summary",
-      "meta"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "error": {
-        "description": "Populated error envelope; full schema at resource codex://error-envelope",
-        "type": "object"
-      },
-      "meta": {
-        "type": "object"
-      },
-      "ok": {
-        "const": false
-      }
-    },
-    "required": [
-      "ok",
-      "error",
-      "meta"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "ok": {
+        "const": true
+      },
+      "tool": {
+        "description": "Originating tool; the payload matches that tool's advertised outputSchema success branch — branch on this field.",
+        "enum": [
+          "codex_consult",
+          "codex_review_changes",
+          "codex_delegate"
+        ]
+      }
+    },
+    "required": [
+      "ok",
+      "tool"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "error": {
+        "description": "Populated error envelope; full schema at resource codex://error-envelope",
+        "type": "object"
+      },
+      "meta": {
+        "type": "object"
+      },
+      "ok": {
+        "const": false
+      }
+    },
+    "required": [
+      "ok",
+      "error",
+      "meta"
+    ],
+    "type": "object"
+  }
+]

addedOutput schema / properties / ok / description

Added value: +"true = success result, false = error result"

First observedv0.5.0Jun 28, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true/openWorldHint=false, but the description goes well beyond them: it flags deprecation, states the tool is free with no model call, lists the failure modes (running/cancelled/timed-out/failed and job_result_incompatible), and notes meta.job_id is set. This is rich behavioral context that annotations alone could not convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The deprecation warning and core purpose are front-loaded, and every paragraph carries information. It is a touch dense with parentheticals and job-kind asides, but no sentence is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values needn't be detailed, yet the description still explains the envelope shape and error cases. Combined with the routing guidance and deprecation note, an agent has everything needed to call this correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents job_id, detail, and workspace_root. The description adds only marginal value ('detail="full"' yields the complete raw output and metadata), which maps to a param the schema already explains. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (fetch a finished background Codex job's result) and immediately distinguishes itself with the 'WITHOUT deleting the record' scope, which separates it from codex_job_consume_result. The opening deprecation notice and named successor add further routing clarity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly names the condition for use ('when codex_job_status reports result_available=true') and the alternative for the fetch-and-delete case ('use codex_job_consume_result'). It also enumerates which job kinds are eligible (async delegate/consult/review) and what tool states return errors.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server