OMP Tandem

Overview Schema Source Related Servers Discussions Admin

tandem_team

Orchestrate a bounded AI team for development, research, analysis, or review by planning steps, running independent work concurrently, assigning models, and tracking results.

Instructions

Run a bounded team for development, research, analysis or review.

models reads only OMP-available openai-codex subscription models, excluding OpenRouter, ordinary OpenAI API and other providers, without a model turn. start requires a stable request_key and a complete plan with one final integration step. Independent steps run concurrently; declared file conflicts serialize. Work requires plan.allow_work; this is a live workspace, NOT an OS sandbox. The whole run owns one deadline and stops with its MCP owner, not detached. Auto selection uses Jev when configured, exporting goal/title summaries and public model facts only. Choose a model/thinking pair per step; explicit model and thinking choices win. Unassigned actionable steps are returned as pending_models, even while assigned workers run. Read selection for frozen eligible pairs, consult the OMP partner, compare once, then assign exactly every current pending step's model, thinking and reason. Never ask the user to route routine subtasks or invent model/reasoning availability. status observes the same run; never start again to wait. Worker questions use tandem_reply(task_id, question_id, answer). Cancel stops pending and active steps. Partial evidence unlocks only an explicitly opted-in read-only final synthesis. Completed reports are claims, not independent acceptance. Every response is bounded, including details. Follow readers for complete plan, selection, run errors, questions and structured results. read returns digest-bound UTF-8 byte pages; send next_request unchanged. models returns UTF-8 catalog pages from one immutable metadata observation; cursor pages never probe again. list has complete cursor continuation over run metadata.

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": {
      "action": "<action>"
    },
    "name": "tandem_team"
  }
}

Input Schema

Name	Required	Description	Default
`plan`	No
`limit`	No
`action`	Yes
`cursor`	No
`run_id`	No
`details`	No
`section`	No
`step_id`	No
`max_bytes`	No
`assignments`	No
`request_key`	No
`offset_bytes`	No
`wait_seconds`	No
`expected_sha256`	No

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedv3.14.0Oct 29, 2026

changedInput schema / properties / plan / anyOf

Previous value: -[
-  {
-    "properties": {
-      "allow_work": {
-        "default": false,
-        "description": "Explicitly permits work-mode steps with the existing edit/shell capabilities. Not an OS sandbox or a detached-execution grant.",
-        "type": "boolean"
-      },
-      "budget_seconds": {
-        "default": 1800,
-        "maximum": 7200,
-        "minimum": 10,
-        "type": "integer"
-      },
-      "cwd": {
-        "anyOf": [
-          {
-            "maxLength": 4096,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "execution": {
-        "anyOf": [
-          {
-            "properties": {
-              "focus": {
-                "anyOf": [
-                  {
-                    "properties": {
-                      "allow_external": {
-                        "default": false,
-                        "type": "boolean"
-                      },
-                      "goal": {
-                        "maxLength": 4000,
-                        "pattern": "\\S",
-                        "type": "string"
-                      },
-                      "surfaces": {
-                        "items": {
-                          "enum": [
-                            "context",
-                            "tools",
-                            "outputs"
-                          ],
-                          "type": "string"
-                        },
-                        "type": "array"
-                      }
-                    },
-                    "required": [
-                      "goal"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "default": null,
-                "description": "Explicit goal and export consent for optional context, tool presentation and focused readers; never inherited."
-              },
-              "model": {
-                "anyOf": [
-                  {
-                    "maxLength": 200,
-                    "pattern": "^openai-codex/[A-Za-z0-9][A-Za-z0-9._:\\-]*(/[A-Za-z0-9][A-Za-z0-9._:\\-]*)*$",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "default": null
-              },
-              "profile": {
-                "default": "balanced",
-                "description": "Profile defaults: quick: Defaults to low thinking with a 600-second deadline. balanced: Defaults to high thinking with a 1800-second deadline. deep: Defaults to high thinking with a 3600-second deadline. Uses the same thinking level as balanced with a longer deadline, not higher reasoning. These are default choices; overrides, effective settings, and actual settings are reported separately.",
-                "enum": [
-                  "quick",
-                  "balanced",
-                  "deep"
-                ],
-                "type": "string"
-              },
-              "routing": {
-                "anyOf": [
-                  {
-                    "properties": {
-                      "allow_external_summary": {
-                        "default": false,
-                        "type": "boolean"
-                      },
-                      "input_modalities": {
-                        "items": {
-                          "enum": [
-                            "text",
-                            "image"
-                          ],
-                          "type": "string"
-                        },
-                        "maxItems": 2,
-                        "minItems": 1,
-                        "type": "array"
-                      },
-                      "input_token_estimate": {
-                        "maximum": 2000000,
-                        "minimum": 1,
-                        "type": "integer"
-                      },
-                      "max_candidate_cost_usd": {
-                        "anyOf": [
-                          {
-                            "minimum": 0,
-                            "type": "number"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ],
-                        "default": null
-                      },
-                      "output_token_estimate": {
-                        "maximum": 2000000,
-                        "minimum": 1,
-                        "type": "integer"
-                      },
-                      "summary": {
-                        "maxLength": 4000,
-                        "pattern": "\\S",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "summary",
-                      "input_token_estimate",
-                      "output_token_estimate"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "default": null,
-                "description": "Explicit export-approved input for optional shadow routing; never inherited or applied to execution."
-              },
-              "thinking": {
-                "anyOf": [
-                  {
-                    "enum": [
-                      "off",
-                      "minimal",
-                      "low",
-                      "medium",
-                      "high",
-                      "xhigh",
-                      "max"
-                    ],
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "default": null
-              },
-              "timeout_seconds": {
-                "anyOf": [
-                  {
-                    "maximum": 7200,
-                    "minimum": 1,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "default": null
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "goal": {
-        "maxLength": 8000,
-        "pattern": "\\S",
-        "type": "string"
-      },
-      "max_parallel": {
-        "default": 3,
-        "maximum": 4,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "model_selection": {
-        "default": "auto",
-        "description": "Auto uses configured Jev on goal/title summaries and public model facts. Coordinator sends no team summaries to Jev and agrees explicit assignments from the OMP catalog.",
-        "enum": [
-          "auto",
-          "coordinator"
-        ],
-        "type": "string"
-      },
-      "project_context_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "steps": {
-        "items": {
-          "properties": {
-            "contract": {
-              "properties": {
-                "acceptance": {
-                  "items": {
-                    "maxLength": 2000,
-                    "pattern": "\\S",
-                    "type": "string"
-                  },
-                  "maxItems": 50,
-                  "type": "array"
-                },
-                "acceptance_set": {
-                  "anyOf": [
-                    {
-                      "description": "The declared denominator. Its revision is its content, not a version number.",
-                      "properties": {
-                        "items": {
-                          "items": {
-                            "properties": {
-                              "id": {
-                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
-                                "type": "string"
-                              },
-                              "obligations": {
-                                "description": "Declared clauses. Naming none keeps the criterion one undecomposed unit; naming some means a mapping of the parent covers none of them.",
-                                "items": {
-                                  "description": "One clause of a criterion, with the exact environment it is owed in.",
-                                  "properties": {
-                                    "environment": {
-                                      "patternProperties": {
-                                        "\\S": {
-                                          "maxLength": 200,
-                                          "type": "string"
-                                        }
-                                      },
-                                      "propertyNames": {
-                                        "maxLength": 60
-                                      },
-                                      "type": "object"
-                                    },
-                                    "id": {
-                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
-                                      "type": "string"
-                                    },
-                                    "text": {
-                                      "maxLength": 16000,
-                                      "pattern": "\\S",
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "id",
-                                    "text"
-                                  ],
-                                  "type": "object"
-                                },
-                                "maxItems": 100,
-                                "type": "array"
-                              },
-                              "text": {
-                                "maxLength": 16000,
-                                "pattern": "\\S",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "id",
-                              "text"
-                            ],
-                            "type": "object"
-                          },
-                          "maxItems": 100,
-                          "type": "array"
-                        },
-                        "revision": {
-                          "pattern": "^[0-9a-f]{64}$",
-                          "type": "string"
-                        },
-                        "schema_version": {
-                          "const": 1,
-                          "default": 1,
-                          "type": "integer"
-                        },
-                        "set_id": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "set_id",
-                        "revision"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "default": null,
-                  "description": "Optional structured form of the same acceptance list: its texts must repeat acceptance exactly, so there is never a second source of truth."
-                },
-                "artifact_ids": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "maxItems": 32,
-                  "type": "array"
-                },
-                "constraints": {
-                  "items": {
-                    "maxLength": 2000,
-                    "pattern": "\\S",
-                    "type": "string"
-                  },
-                  "maxItems": 50,
-                  "type": "array"
-                },
-                "context": {
-                  "default": "",
-                  "maxLength": 60000,
-                  "type": "string"
-                },
-                "context_options": {
-                  "description": "Presentation of pinned product data, never a reduction of required policy.",
-                  "properties": {
-                    "advisory_rule_ids": {
-                      "items": {
-                        "maxLength": 100,
-                        "pattern": "\\S",
-                        "type": "string"
-                      },
-                      "maxItems": 50,
-                      "type": "array"
-                    },
-                    "decision_ids": {
-                      "items": {
-                        "maxLength": 100,
-                        "pattern": "\\S",
-                        "type": "string"
-                      },
-                      "maxItems": 100,
-                      "type": "array"
-                    },
-                    "delivery": {
-                      "default": "capsule",
-                      "enum": [
-                        "capsule",
-                        "full"
-                      ],
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "goal": {
-                  "maxLength": 8000,
-                  "pattern": "\\S",
-                  "type": "string"
-                },
-                "requirements": {
-                  "description": "Declared execution needs; a live-path claim remains attributed evidence.",
-                  "properties": {
-                    "boundary_paths": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "maxItems": 100,
-                      "type": "array"
-                    },
-                    "entry_paths": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "maxItems": 100,
-                      "type": "array"
-                    },
-                    "live_path_evidence": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "maxItems": 32,
-                      "type": "array"
-                    },
-                    "requires_shell": {
-                      "default": false,
-                      "type": "boolean"
-                    },
-                    "requires_write": {
-                      "default": false,
-                      "type": "boolean"
-                    }
-                  },
-                  "type": "object"
-                },
-                "scope": {
-                  "description": "Declared file ownership for coordination; NOT a filesystem sandbox.",
-                  "properties": {
-                    "owned_files": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "maxItems": 100,
-                      "type": "array"
-                    }
-                  },
-                  "type": "object"
-                },
-                "verification": {
-                  "anyOf": [
-                    {
-                      "description": "Explicit check ladder; later phases include earlier required checks.",
-                      "properties": {
-                        "acceptance_coverage": {
-                          "default": "report_only",
-                          "description": "report_only surfaces gaps and refuses nothing. require_current_evidence additionally refuses a success report while a declared evidence unit lacks applicable current passing evidence.",
-                          "enum": [
-                            "report_only",
-                            "require_current_evidence"
-                          ],
-                          "type": "string"
-                        },
-                        "checks": {
-                          "items": {
-                            "properties": {
-                              "acceptance_refs": {
-                                "description": "Which declared criteria or obligations this check is intended to exercise. An assertion of intent, never of execution or sufficiency.",
-                                "items": {
-                                  "description": "Points at one criterion or one of its obligations, at an exact revision.",
-                                  "properties": {
-                                    "criterion_id": {
-                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
-                                      "type": "string"
-                                    },
-                                    "obligation_id": {
-                                      "anyOf": [
-                                        {
-                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
-                                          "type": "string"
-                                        },
-                                        {
-                                          "type": "null"
-                                        }
-                                      ],
-                                      "default": null
-                                    },
-                                    "revision": {
-                                      "pattern": "^[0-9a-f]{64}$",
-                                      "type": "string"
-                                    },
-                                    "set_id": {
-                                      "type": "string"
-                                    }
-                                  },
-                                  "required": [
-                                    "set_id",
-                                    "revision",
-                                    "criterion_id"
-                                  ],
-                                  "type": "object"
-                                },
-                                "maxItems": 200,
-                                "type": "array"
-                              },
-                              "command": {
-                                "anyOf": [
-                                  {
-                                    "maxLength": 2000,
-                                    "type": "string"
-                                  },
-                                  {
-                                    "type": "null"
-                                  }
-                                ],
-                                "default": null
-                              },
-                              "criterion": {
-                                "maxLength": 2000,
-                                "pattern": "\\S",
-                                "type": "string"
-                              },
-                              "estimated_seconds": {
-                                "anyOf": [
-                                  {
-                                    "maximum": 7200,
-                                    "minimum": 1,
-                                    "type": "integer"
-                                  },
-                                  {
-                                    "type": "null"
-                                  }
-                                ],
-                                "default": null
-                              },
-                              "id": {
-                                "maxLength": 100,
-                                "pattern": "\\S",
-                                "type": "string"
-                              },
-                              "phase": {
-                                "default": "targeted",
-                                "enum": [
-                                  "targeted",
-                                  "candidate",
-                                  "integration"
-                                ],
-                                "type": "string"
-                              },
-                              "requires_shell": {
-                                "default": false,
-                                "type": "boolean"
-                              },
-                              "scope": {
-                                "anyOf": [
-                                  {
-                                    "description": "Which bytes a run observed. Equal digests of the same kind are the same bytes.",
-                                    "properties": {
-                                      "boundaries": {
-                                        "description": "What the run did not exercise (external services, other platforms, unselected files).",
-                                        "items": {
-                                          "maxLength": 2000,
-                                          "pattern": "\\S",
-                                          "type": "string"
-                                        },
-                                        "maxItems": 20,
-                                        "type": "array"
-                                      },
-                                      "digest": {
-                                        "pattern": "^[0-9a-f]{7,128}$",
-                                        "type": "string"
-                                      },
-                                      "kind": {
-                                        "enum": [
-                                          "tree",
-                                          "commit",
-                                          "archive",
-                                          "content"
-                                        ],
-                                        "type": "string"
-                                      }
-                                    },
-                                    "required": [
-                                      "kind",
-                                      "digest"
-                                    ],
-                                    "type": "object"
-                                  },
-                                  {
-                                    "type": "null"
-                                  }
-                                ],
-                                "default": null,
-                                "description": "Explicit current input identity. History from other bytes remains recorded but is not a current result; omitted scope keeps ambiguous failures unresolved."
-                              }
-                            },
-                            "required": [
-                              "id",
-                              "criterion"
-                            ],
-                            "type": "object"
-                          },
-                          "maxItems": 50,
-                          "type": "array"
-                        },
-                        "coverage_scope": {
-                          "anyOf": [
-                            {
-                              "description": "Which bytes a run observed. Equal digests of the same kind are the same bytes.",
-                              "properties": {
-                                "boundaries": {
-                                  "description": "What the run did not exercise (external services, other platforms, unselected files).",
-                                  "items": {
-                                    "maxLength": 2000,
-                                    "pattern": "\\S",
-                                    "type": "string"
-                                  },
-                                  "maxItems": 20,
-                                  "type": "array"
-                                },
-                                "digest": {
-                                  "pattern": "^[0-9a-f]{7,128}$",
-                                  "type": "string"
-                                },
-                                "kind": {
-                                  "enum": [
-                                    "tree",
-                                    "commit",
-                                    "archive",
-                                    "content"
-                                  ],
-                                  "type": "string"
-                                }
-                              },
-                              "required": [
-                                "kind",
-                                "digest"
-                              ],
-                              "type": "object"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "default": null,
-                          "description": "The output bytes this coverage assessment is about. A declaration, not an observation of the filesystem."
-                        },
-                        "preparation_seconds": {
-                          "default": 0,
-                          "maximum": 7200,
-                          "minimum": 0,
-                          "type": "integer"
-                        },
-                        "stage": {
-                          "default": "targeted",
-                          "enum": [
-                            "targeted",
-                            "candidate",
-                            "integration"
-                          ],
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "default": null
-                }
-              },
-              "required": [
-                "goal"
-              ],
-              "type": "object"
-            },
-            "dependency_policy": {
-              "default": "success",
-              "description": "Success-only by default. reported_evidence is restricted to the final think synthesis of a wholly read-only team and accepts completed structured success/partial evidence, never failed or unreported work.",
-              "enum": [
-                "success",
-                "reported_evidence"
-              ],
-              "type": "string"
-            },
-            "depends_on": {
-              "items": {
-                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,63}$",
-                "type": "string"
-              },
-              "maxItems": 15,
-              "type": "array"
-            },
-            "execution": {
-              "anyOf": [
-                {
-                  "properties": {
-                    "focus": {
-                      "anyOf": [
-                        {
-                          "properties": {
-                            "allow_external": {
-                              "default": false,
-                              "type": "boolean"
-                            },
-                            "goal": {
-                              "maxLength": 4000,
-                              "pattern": "\\S",
-                              "type": "string"
-                            },
-                            "surfaces": {
-                              "items": {
-                                "enum": [
-                                  "context",
-                                  "tools",
-                                  "outputs"
-                                ],
-                                "type": "string"
-                              },
-                              "type": "array"
-                            }
-                          },
-                          "required": [
-                            "goal"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "default": null,
-                      "description": "Explicit goal and export consent for optional context, tool presentation and focused readers; never inherited."
-                    },
-                    "model": {
-                      "anyOf": [
-                        {
-                          "maxLength": 200,
-                          "pattern": "^openai-codex/[A-Za-z0-9][A-Za-z0-9._:\\-]*(/[A-Za-z0-9][A-Za-z0-9._:\\-]*)*$",
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "default": null
-                    },
-                    "profile": {
-                      "default": "balanced",
-                      "description": "Profile defaults: quick: Defaults to low thinking with a 600-second deadline. balanced: Defaults to high thinking with a 1800-second deadline. deep: Defaults to high thinking with a 3600-second deadline. Uses the same thinking level as balanced with a longer deadline, not higher reasoning. These are default choices; overrides, effective settings, and actual settings are reported separately.",
-                      "enum": [
-                        "quick",
-                        "balanced",
-                        "deep"
-                      ],
-                      "type": "string"
-                    },
-                    "routing": {
-                      "anyOf": [
-                        {
-                          "properties": {
-                            "allow_external_summary": {
-                              "default": false,
-                              "type": "boolean"
-                            },
-                            "input_modalities": {
-                              "items": {
-                                "enum": [
-                                  "text",
-                                  "image"
-                                ],
-                                "type": "string"
-                              },
-                              "maxItems": 2,
-                              "minItems": 1,
-                              "type": "array"
-                            },
-                            "input_token_estimate": {
-                              "maximum": 2000000,
-                              "minimum": 1,
-                              "type": "integer"
-                            },
-                            "max_candidate_cost_usd": {
-                              "anyOf": [
-                                {
-                                  "minimum": 0,
-                                  "type": "number"
-                                },
-                                {
-                                  "type": "null"
-                                }
-                              ],
-                              "default": null
-                            },
-                            "output_token_estimate": {
-                              "maximum": 2000000,
-                              "minimum": 1,
-                              "type": "integer"
-                            },
-                            "summary": {
-                              "maxLength": 4000,
-                              "pattern": "\\S",
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "summary",
-                            "input_token_estimate",
-                            "output_token_estimate"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "default": null,
-                      "description": "Explicit export-approved input for optional shadow routing; never inherited or applied to execution."
-                    },
-                    "thinking": {
-                      "anyOf": [
-                        {
-                          "enum": [
-                            "off",
-                            "minimal",
-                            "low",
-                            "medium",
-                            "high",
-                            "xhigh",
-                            "max"
-                          ],
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "default": null
-                    },
-                    "timeout_seconds": {
-                      "anyOf": [
-                        {
-                          "maximum": 7200,
-                          "minimum": 1,
-                          "type": "integer"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "default": null
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "id": {
-              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,63}$",
-              "type": "string"
-            },
-            "mode": {
-              "default": "analyze",
-              "enum": [
-                "think",
-                "analyze",
-                "work"
-              ],
-              "type": "string"
-            },
-            "role": {
-              "anyOf": [
-                {
-                  "maxLength": 2000,
-                  "pattern": "\\S",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "title": {
-              "maxLength": 2000,
-              "pattern": "\\S",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "title",
-            "contract"
-          ],
-          "type": "object"
-        },
-        "maxItems": 16,
-        "minItems": 2,
-        "type": "array"
-      }
-    },
-    "required": [
-      "goal",
-      "steps"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "allow_work": {
+        "default": false,
+        "description": "Explicitly permits work-mode steps with the existing edit/shell capabilities. Not an OS sandbox or a detached-execution grant.",
+        "type": "boolean"
+      },
+      "budget_seconds": {
+        "default": 1800,
+        "maximum": 7200,
+        "minimum": 10,
+        "type": "integer"
+      },
+      "cwd": {
+        "anyOf": [
+          {
+            "maxLength": 4096,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "execution": {
+        "anyOf": [
+          {
+            "properties": {
+              "focus": {
+                "anyOf": [
+                  {
+                    "properties": {
+                      "allow_external": {
+                        "default": false,
+                        "type": "boolean"
+                      },
+                      "goal": {
+                        "maxLength": 4000,
+                        "pattern": "\\S",
+                        "type": "string"
+                      },
+                      "surfaces": {
+                        "items": {
+                          "enum": [
+                            "context",
+                            "tools",
+                            "outputs"
+                          ],
+                          "type": "string"
+                        },
+                        "type": "array"
+                      }
+                    },
+                    "required": [
+                      "goal"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Explicit goal and export consent for optional context, tool presentation and focused readers; never inherited."
+              },
+              "model": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^openai-codex/[A-Za-z0-9][A-Za-z0-9._:\\-]*(/[A-Za-z0-9][A-Za-z0-9._:\\-]*)*$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "profile": {
+                "default": "balanced",
+                "description": "Profile defaults: quick: Defaults to low thinking with a 600-second deadline. balanced: Defaults to high thinking with a 1800-second deadline. deep: Defaults to high thinking with a 3600-second deadline. Uses the same thinking level as balanced with a longer deadline, not higher reasoning. These are default choices; overrides, effective settings, and actual settings are reported separately.",
+                "enum": [
+                  "quick",
+                  "balanced",
+                  "deep"
+                ],
+                "type": "string"
+              },
+              "purpose": {
+                "default": "work",
+                "description": "Turn-local lane: coordination is reserved for think-only consultation, never work or extra permissions. Not inherited.",
+                "enum": [
+                  "work",
+                  "coordination"
+                ],
+                "type": "string"
+              },
+              "routing": {
+                "anyOf": [
+                  {
+                    "properties": {
+                      "allow_external_summary": {
+                        "default": false,
+                        "type": "boolean"
+                      },
+                      "input_modalities": {
+                        "items": {
+                          "enum": [
+                            "text",
+                            "image"
+                          ],
+                          "type": "string"
+                        },
+                        "maxItems": 2,
+                        "minItems": 1,
+                        "type": "array"
+                      },
+                      "input_token_estimate": {
+                        "maximum": 2000000,
+                        "minimum": 1,
+                        "type": "integer"
+                      },
+                      "max_candidate_cost_usd": {
+                        "anyOf": [
+                          {
+                            "minimum": 0,
+                            "type": "number"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "default": null
+                      },
+                      "output_token_estimate": {
+                        "maximum": 2000000,
+                        "minimum": 1,
+                        "type": "integer"
+                      },
+                      "summary": {
+                        "maxLength": 4000,
+                        "pattern": "\\S",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "summary",
+                      "input_token_estimate",
+                      "output_token_estimate"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Explicit export-approved input for optional shadow routing; never inherited or applied to execution."
+              },
+              "thinking": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "off",
+                      "minimal",
+                      "low",
+                      "medium",
+                      "high",
+                      "xhigh",
+                      "max"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "timeout_seconds": {
+                "anyOf": [
+                  {
+                    "maximum": 7200,
+                    "minimum": 1,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "goal": {
+        "maxLength": 8000,
+        "pattern": "\\S",
+        "type": "string"
+      },
+      "max_parallel": {
+        "default": 3,
+        "maximum": 4,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "model_selection": {
+        "default": "auto",
+        "description": "Auto uses configured Jev on goal/title summaries and public model facts. Coordinator sends no team summaries to Jev and agrees explicit assignments from the OMP catalog.",
+        "enum": [
+          "auto",
+          "coordinator"
+        ],
+        "type": "string"
+      },
+      "project_context_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "steps": {
+        "items": {
+          "properties": {
+            "contract": {
+              "properties": {
+                "acceptance": {
+                  "items": {
+                    "maxLength": 2000,
+                    "pattern": "\\S",
+                    "type": "string"
+                  },
+                  "maxItems": 50,
+                  "type": "array"
+                },
+                "acceptance_set": {
+                  "anyOf": [
+                    {
+                      "description": "The declared denominator. Its revision is its content, not a version number.",
+                      "properties": {
+                        "items": {
+                          "items": {
+                            "properties": {
+                              "id": {
+                                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
+                                "type": "string"
+                              },
+                              "obligations": {
+                                "description": "Declared clauses. Naming none keeps the criterion one undecomposed unit; naming some means a mapping of the parent covers none of them.",
+                                "items": {
+                                  "description": "One clause of a criterion, with the exact environment it is owed in.",
+                                  "properties": {
+                                    "environment": {
+                                      "patternProperties": {
+                                        "\\S": {
+                                          "maxLength": 200,
+                                          "type": "string"
+                                        }
+                                      },
+                                      "propertyNames": {
+                                        "maxLength": 60
+                                      },
+                                      "type": "object"
+                                    },
+                                    "id": {
+                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
+                                      "type": "string"
+                                    },
+                                    "text": {
+                                      "maxLength": 16000,
+                                      "pattern": "\\S",
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "id",
+                                    "text"
+                                  ],
+                                  "type": "object"
+                                },
+                                "maxItems": 100,
+                                "type": "array"
+                              },
+                              "text": {
+                                "maxLength": 16000,
+                                "pattern": "\\S",
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "id",
+                              "text"
+                            ],
+                            "type": "object"
+                          },
+                          "maxItems": 100,
+                          "type": "array"
+                        },
+                        "revision": {
+                          "pattern": "^[0-9a-f]{64}$",
+                          "type": "string"
+                        },
+                        "schema_version": {
+                          "const": 1,
+                          "default": 1,
+                          "type": "integer"
+                        },
+                        "set_id": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "set_id",
+                        "revision"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null,
+                  "description": "Optional structured form of the same acceptance list: its texts must repeat acceptance exactly, so there is never a second source of truth."
+                },
+                "artifact_ids": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "maxItems": 32,
+                  "type": "array"
+                },
+                "constraints": {
+                  "items": {
+                    "maxLength": 2000,
+                    "pattern": "\\S",
+                    "type": "string"
+                  },
+                  "maxItems": 50,
+                  "type": "array"
+                },
+                "context": {
+                  "default": "",
+                  "maxLength": 60000,
+                  "type": "string"
+                },
+                "context_options": {
+                  "description": "Presentation of pinned product data, never a reduction of required policy.",
+                  "properties": {
+                    "advisory_rule_ids": {
+                      "items": {
+                        "maxLength": 100,
+                        "pattern": "\\S",
+                        "type": "string"
+                      },
+                      "maxItems": 50,
+                      "type": "array"
+                    },
+                    "decision_ids": {
+                      "items": {
+                        "maxLength": 100,
+                        "pattern": "\\S",
+                        "type": "string"
+                      },
+                      "maxItems": 100,
+                      "type": "array"
+                    },
+                    "delivery": {
+                      "default": "capsule",
+                      "enum": [
+                        "capsule",
+                        "full"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "goal": {
+                  "maxLength": 8000,
+                  "pattern": "\\S",
+                  "type": "string"
+                },
+                "requirements": {
+                  "description": "Declared execution needs; a live-path claim remains attributed evidence.",
+                  "properties": {
+                    "boundary_paths": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "maxItems": 100,
+                      "type": "array"
+                    },
+                    "entry_paths": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "maxItems": 100,
+                      "type": "array"
+                    },
+                    "live_path_evidence": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "maxItems": 32,
+                      "type": "array"
+                    },
+                    "requires_shell": {
+                      "default": false,
+                      "type": "boolean"
+                    },
+                    "requires_write": {
+                      "default": false,
+                      "type": "boolean"
+                    }
+                  },
+                  "type": "object"
+                },
+                "scope": {
+                  "description": "Declared file ownership for coordination; NOT a filesystem sandbox.",
+                  "properties": {
+                    "owned_files": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "maxItems": 100,
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                },
+                "verification": {
+                  "anyOf": [
+                    {
+                      "description": "Explicit check ladder; later phases include earlier required checks.",
+                      "properties": {
+                        "acceptance_coverage": {
+                          "default": "report_only",
+                          "description": "report_only surfaces gaps and refuses nothing. require_current_evidence additionally refuses a success report while a declared evidence unit lacks applicable current passing evidence.",
+                          "enum": [
+                            "report_only",
+                            "require_current_evidence"
+                          ],
+                          "type": "string"
+                        },
+                        "checks": {
+                          "items": {
+                            "properties": {
+                              "acceptance_refs": {
+                                "description": "Which declared criteria or obligations this check is intended to exercise. An assertion of intent, never of execution or sufficiency.",
+                                "items": {
+                                  "description": "Points at one criterion or one of its obligations, at an exact revision.",
+                                  "properties": {
+                                    "criterion_id": {
+                                      "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
+                                      "type": "string"
+                                    },
+                                    "obligation_id": {
+                                      "anyOf": [
+                                        {
+                                          "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,99}$",
+                                          "type": "string"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ],
+                                      "default": null
+                                    },
+                                    "revision": {
+                                      "pattern": "^[0-9a-f]{64}$",
+                                      "type": "string"
+                                    },
+                                    "set_id": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "set_id",
+                                    "revision",
+                                    "criterion_id"
+                                  ],
+                                  "type": "object"
+                                },
+                                "maxItems": 200,
+                                "type": "array"
+                              },
+                              "command": {
+                                "anyOf": [
+                                  {
+                                    "maxLength": 2000,
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "default": null
+                              },
+                              "criterion": {
+                                "maxLength": 2000,
+                                "pattern": "\\S",
+                                "type": "string"
+                              },
+                              "estimated_seconds": {
+                                "anyOf": [
+                                  {
+                                    "maximum": 7200,
+                                    "minimum": 1,
+                                    "type": "integer"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "default": null
+                              },
+                              "id": {
+                                "maxLength": 100,
+                                "pattern": "\\S",
+                                "type": "string"
+                              },
+                              "phase": {
+                                "default": "targeted",
+                                "enum": [
+                                  "targeted",
+                                  "candidate",
+                                  "integration"
+                                ],
+                                "type": "string"
+                              },
+                              "requires_shell": {
+                                "default": false,
+                                "type": "boolean"
+                              },
+                              "scope": {
+                                "anyOf": [
+                                  {
+                                    "description": "Which bytes a run observed. Equal digests of the same kind are the same bytes.",
+                                    "properties": {
+                                      "boundaries": {
+                                        "description": "What the run did not exercise (external services, other platforms, unselected files).",
+                                        "items": {
+                                          "maxLength": 2000,
+                                          "pattern": "\\S",
+                                          "type": "string"
+                                        },
+                                        "maxItems": 20,
+                                        "type": "array"
+                                      },
+                                      "digest": {
+                                        "pattern": "^[0-9a-f]{7,128}$",
+                                        "type": "string"
+                                      },
+                                      "kind": {
+                                        "enum": [
+                                          "tree",
+                                          "commit",
+                                          "archive",
+                                          "content"
+                                        ],
+                                        "type": "string"
+                                      }
+                                    },
+                                    "required": [
+                                      "kind",
+                                      "digest"
+                                    ],
+                                    "type": "object"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "default": null,
+                                "description": "Explicit current input identity. History from other bytes remains recorded but is not a current result; omitted scope keeps ambiguous failures unresolved."
+                              }
+                            },
+                            "required": [
+                              "id",
+                              "criterion"
+                            ],
+                            "type": "object"
+                          },
+                          "maxItems": 50,
+                          "type": "array"
+                        },
+                        "coverage_scope": {
+                          "anyOf": [
+                            {
+                              "description": "Which bytes a run observed. Equal digests of the same kind are the same bytes.",
+                              "properties": {
+                                "boundaries": {
+                                  "description": "What the run did not exercise (external services, other platforms, unselected files).",
+                                  "items": {
+                                    "maxLength": 2000,
+                                    "pattern": "\\S",
+                                    "type": "string"
+                                  },
+                                  "maxItems": 20,
+                                  "type": "array"
+                                },
+                                "digest": {
+                                  "pattern": "^[0-9a-f]{7,128}$",
+                                  "type": "string"
+                                },
+                                "kind": {
+                                  "enum": [
+                                    "tree",
+                                    "commit",
+                                    "archive",
+                                    "content"
+                                  ],
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "digest"
+                              ],
+                              "type": "object"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "default": null,
+                          "description": "The output bytes this coverage assessment is about. A declaration, not an observation of the filesystem."
+                        },
+                        "preparation_seconds": {
+                          "default": 0,
+                          "maximum": 7200,
+                          "minimum": 0,
+                          "type": "integer"
+                        },
+                        "stage": {
+                          "default": "targeted",
+                          "enum": [
+                            "targeted",
+                            "candidate",
+                            "integration"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                }
+              },
+              "required": [
+                "goal"
+              ],
+              "type": "object"
+            },
+            "dependency_policy": {
+              "default": "success",
+              "description": "Success-only by default. reported_evidence is restricted to the final think synthesis of a wholly read-only team and accepts completed structured success/partial evidence, never failed or unreported work.",
+              "enum": [
+                "success",
+                "reported_evidence"
+              ],
+              "type": "string"
+            },
+            "depends_on": {
+              "items": {
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,63}$",
+                "type": "string"
+              },
+              "maxItems": 15,
+              "type": "array"
+            },
+            "execution": {
+              "anyOf": [
+                {
+                  "properties": {
+                    "focus": {
+                      "anyOf": [
+                        {
+                          "properties": {
+                            "allow_external": {
+                              "default": false,
+                              "type": "boolean"
+                            },
+                            "goal": {
+                              "maxLength": 4000,
+                              "pattern": "\\S",
+                              "type": "string"
+                            },
+                            "surfaces": {
+                              "items": {
+                                "enum": [
+                                  "context",
+                                  "tools",
+                                  "outputs"
+                                ],
+                                "type": "string"
+                              },
+                              "type": "array"
+                            }
+                          },
+                          "required": [
+                            "goal"
+                          ],
+                          "type": "object"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "default": null,
+                      "description": "Explicit goal and export consent for optional context, tool presentation and focused readers; never inherited."
+                    },
+                    "model": {
+                      "anyOf": [
+                        {
+                          "maxLength": 200,
+                          "pattern": "^openai-codex/[A-Za-z0-9][A-Za-z0-9._:\\-]*(/[A-Za-z0-9][A-Za-z0-9._:\\-]*)*$",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "default": null
+                    },
+                    "profile": {
+                      "default": "balanced",
+                      "description": "Profile defaults: quick: Defaults to low thinking with a 600-second deadline. balanced: Defaults to high thinking with a 1800-second deadline. deep: Defaults to high thinking with a 3600-second deadline. Uses the same thinking level as balanced with a longer deadline, not higher reasoning. These are default choices; overrides, effective settings, and actual settings are reported separately.",
+                      "enum": [
+                        "quick",
+                        "balanced",
+                        "deep"
+                      ],
+                      "type": "string"
+                    },
+                    "purpose": {
+                      "default": "work",
+                      "description": "Turn-local lane: coordination is reserved for think-only consultation, never work or extra permissions. Not inherited.",
+                      "enum": [
+                        "work",
+                        "coordination"
+                      ],
+                      "type": "string"
+                    },
+                    "routing": {
+                      "anyOf": [
+                        {
+                          "properties": {
+                            "allow_external_summary": {
+                              "default": false,
+                              "type": "boolean"
+                            },
+                            "input_modalities": {
+                              "items": {
+                                "enum": [
+                                  "text",
+                                  "image"
+                                ],
+                                "type": "string"
+                              },
+                              "maxItems": 2,
+                              "minItems": 1,
+                              "type": "array"
+                            },
+                            "input_token_estimate": {
+                              "maximum": 2000000,
+                              "minimum": 1,
+                              "type": "integer"
+                            },
+                            "max_candidate_cost_usd": {
+                              "anyOf": [
+                                {
+                                  "minimum": 0,
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "default": null
+                            },
+                            "output_token_estimate": {
+                              "maximum": 2000000,
+                              "minimum": 1,
+                              "type": "integer"
+                            },
+                            "summary": {
+                              "maxLength": 4000,
+                              "pattern": "\\S",
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "summary",
+                            "input_token_estimate",
+                            "output_token_estimate"
+                          ],
+                          "type": "object"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "default": null,
+                      "description": "Explicit export-approved input for optional shadow routing; never inherited or applied to execution."
+                    },
+                    "thinking": {
+                      "anyOf": [
+                        {
+                          "enum": [
+                            "off",
+                            "minimal",
+                            "low",
+                            "medium",
+                            "high",
+                            "xhigh",
+                            "max"
+                          ],
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "default": null
+                    },
+                    "timeout_seconds": {
+                      "anyOf": [
+                        {
+                          "maximum": 7200,
+                          "minimum": 1,
+                          "type": "integer"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "default": null
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "id": {
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9._\\-]{0,63}$",
+              "type": "string"
+            },
+            "mode": {
+              "default": "analyze",
+              "enum": [
+                "think",
+                "analyze",
+                "work"
+              ],
+              "type": "string"
+            },
+            "role": {
+              "anyOf": [
+                {
+                  "maxLength": 2000,
+                  "pattern": "\\S",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "title": {
+              "maxLength": 2000,
+              "pattern": "\\S",
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "title",
+            "contract"
+          ],
+          "type": "object"
+        },
+        "maxItems": 16,
+        "minItems": 2,
+        "type": "array"
+      }
+    },
+    "required": [
+      "goal",
+      "steps"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / wait_seconds / anyOf

Added value: +[
+  {
+    "maximum": 1200,
+    "minimum": 0,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / wait_seconds / default
```
Previous value: -25New value: +null
```
removedInput schema / properties / wait_seconds / maximum
```
Removed value: -1200
```
removedInput schema / properties / wait_seconds / minimum
```
Removed value: -0
```
removedInput schema / properties / wait_seconds / type
```
Removed value: -"integer"
```

Addedv3.12.0Oct 22, 2026

TDQS

B3.3/5.0

Behavior4/5

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

With no annotations, the description does substantial work: it discloses that the workspace is live and not an OS sandbox, that the run owns one deadline and stops with its MCP owner, that file conflicts serialize, that auto selection exports only goal/title summaries and public model facts, and that responses are bounded with pagination rules. Remaining gaps include permission requirements and error behavior, but the core behavioral profile is unusually rich.

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

Conciseness3/5

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

The purpose is front-loaded and most sentences carry information, but the description is a dense block with undefined internal terms such as Jev, OMP, and next_request. It would be more usable with action-oriented structure or bullets rather than a single prose wall.

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

Completeness3/5

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

The tool is complex, with 14 parameters and multiple actions, and the presence of an output schema means return values need not be explained. The description covers many operational behaviors and the main action semantics, but does not fully document the parameter surface, leaving an agent to infer the purpose of several top-level fields.

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

Parameters2/5

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

The schema has 14 top-level parameters and 0% top-level description coverage, so the description must compensate. It explains action meanings, request_key stability, plan.allow_work, and assignment fields, but leaves many parameters undocumented, including run_id, limit, cursor usage details, max_bytes, offset_bytes, expected_sha256, wait_seconds, details, section, and project_context_id.

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

Purpose4/5

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

The first sentence states a specific verb and resource: running a bounded team for development, research, analysis, or review. The action enum and later sentences clarify that it multiplexes models/start/status/list/assign/cancel/read, but it does not explicitly distinguish itself from siblings such as tandem_start or tandem_work.

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

Usage Guidelines3/5

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

It gives action-level guidance: start requires a stable request_key and complete plan; status observes the same run and you should never start again to wait; assign must cover every current pending step; cancel stops pending and active steps. However, it does not state when to use this tool versus the many sibling tools, so the guidance is implied rather than explicit.

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