OMP Tandem

by Flyozzzz

Overview Schema Source Related Servers Discussions Admin

Python

Local

tandem_start

Start a task with exactly one of prompt or structured contract. Returns immediately.

Instructions

Start a task with exactly one of prompt or structured contract. Returns immediately.

Base constraints/owned files stay fixed; each follow-up has a new goal and criteria. project_context_id pins product rules/decisions. Only the coordinator sets question timeout. Think: collaboration; analyze: read/search; work: edits/shell, NOT sandboxed. Use preflight=true to inspect admission without launching a worker. Structured requirements declare exact entry/boundary paths and shell/write needs; verification declares the agreed check ladder, never permission to execute it.

Input Schema

Name	Required	Default
`cwd`	Yes
`mode`	No	analyze
`prompt`	No
`contract`	No
`execution`	No
`preflight`	No
`review_id`	No
`review_stage`	No
`timeout_seconds`	No
`project_context_id`	No
`question_timeout_seconds`	No

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv3.12.0Oct 22, 2026

changedInput schema / properties / execution / anyOf

Previous value: -[
-  {
-    "properties": {
-      "model": {
-        "anyOf": [
-          {
-            "minLength": 1,
-            "pattern": "\\S",
-            "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"
-      },
-      "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"
-  }
-]New value: +[
+  {
+    "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": [
+          {
+            "minLength": 1,
+            "pattern": "\\S",
+            "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"
+  }
+]

Changed1 schema field changedv3.10.0Sep 17, 2026

changedInput schema / properties / contract / anyOf

Previous value: -[
-  {
-    "properties": {
-      "acceptance": {
-        "items": {
-          "maxLength": 2000,
-          "pattern": "\\S",
-          "type": "string"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "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": {
-              "checks": {
-                "items": {
-                  "properties": {
-                    "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"
-              },
-              "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"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "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"
+  },
+  {
+    "type": "null"
+  }
+]

Changed2 schema fields changedv3.8.0Sep 16, 2026

changedInput schema / properties / contract / anyOf

Previous value: -[
-  {
-    "properties": {
-      "acceptance": {
-        "items": {
-          "maxLength": 2000,
-          "pattern": "\\S",
-          "type": "string"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "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"
-      },
-      "goal": {
-        "maxLength": 8000,
-        "pattern": "\\S",
-        "type": "string"
-      },
-      "scope": {
-        "description": "Declared file ownership for coordination; NOT a filesystem sandbox.",
-        "properties": {
-          "owned_files": {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 100,
-            "type": "array"
-          }
-        },
-        "type": "object"
-      }
-    },
-    "required": [
-      "goal"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "acceptance": {
+        "items": {
+          "maxLength": 2000,
+          "pattern": "\\S",
+          "type": "string"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "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": {
+              "checks": {
+                "items": {
+                  "properties": {
+                    "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"
+              },
+              "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"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / preflight

Added value: +{
+  "default": false,
+  "type": "boolean"
+}

Changed1 schema field changedv3.3.0Sep 10, 2026

changedInput schema / properties / execution / anyOf

Previous value: -[
-  {
-    "properties": {
-      "model": {
-        "anyOf": [
-          {
-            "minLength": 1,
-            "pattern": "\\S",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "profile": {
-        "default": "balanced",
-        "enum": [
-          "quick",
-          "balanced",
-          "deep"
-        ],
-        "type": "string"
-      },
-      "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"
-  }
-]New value: +[
+  {
+    "properties": {
+      "model": {
+        "anyOf": [
+          {
+            "minLength": 1,
+            "pattern": "\\S",
+            "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"
+      },
+      "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"
+  }
+]

Changed8 schema fields changedv3.1.0Sep 9, 2026

addedInput schema / properties / execution

Added value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "model": {
+          "anyOf": [
+            {
+              "minLength": 1,
+              "pattern": "\\S",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "profile": {
+          "default": "balanced",
+          "enum": [
+            "quick",
+            "balanced",
+            "deep"
+          ],
+          "type": "string"
+        },
+        "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
+}

addedInput schema / properties / review_id

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedInput schema / properties / review_stage

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "independent",
+        "comparison"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedInput schema / properties / timeout_seconds / anyOf

Added value: +[
+  {
+    "maximum": 7200,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / timeout_seconds / default
```
Previous value: -1800New value: +null
```
removedInput schema / properties / timeout_seconds / maximum
```
Removed value: -7200
```
removedInput schema / properties / timeout_seconds / minimum
```
Removed value: -1
```
removedInput schema / properties / timeout_seconds / type
```
Removed value: -"integer"
```

First observedv3.0.1Sep 9, 2026

TDQS

A3.5/5.0

Behavior4/5

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

With no annotations, the description carries the full burden and does disclose several non-obvious traits: the call returns immediately while a worker runs, 'work' mode edits/shell and is 'NOT sandboxed', preflight gives a dry-run admission check, and 'verification declares the agreed check ladder, never permission to execute it.' It still says nothing about concurrency limits, invalid-contract behavior, or cost, and its 'NOT sandboxed' note partly duplicates the scope field description.

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 most important fact (start a task with exactly one of prompt/contract, returns immediately) is front-loaded correctly. But the remainder is a dense run-on of fragment sentences in mixed registers ('project_context_id pins product rules/decisions. Only the coordinator sets question timeout.'), and 'Base constraints/owned files stay fixed; each follow-up has a new goal and criteria' describes follow-up behavior rather than this call, which dilutes focus.

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?

An output schema exists, so return values need no prose, and the description does cover the core launch semantics and the not-sandboxed risk. For an 11-parameter tool with a deeply nested contract and zero annotations, however, the complete silence on execution tuning (profile/thinking/timeout/routing) and review scoping leaves an agent guessing on roughly half the surface.

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?

Top-level schema description coverage is reported as 0%, so the prose must compensate, and it does explain the trickiest semantics: prompt-vs-contract exclusivity, project_context_id pinning, question_timeout being coordinator-only, preflight, and the requirements/verification sub-structures. It says nothing about the entire 'execution' group (profile, thinking, model, timeout_seconds, routing, focus), review_id/review_stage, or context_options, leaving several of the 11 parameters unexplained.

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?

Opens with a specific verb and resource plus a hard constraint: 'Start a task with exactly one of prompt or structured contract. Returns immediately.' That tells an agent what the tool does and its fire-and-forget nature. It never names a sibling (tandem_continue, tandem_work, tandem_review_run), so the boundary with related launch/continue tools is only inferable from 'each follow-up has a new goal and criteria.'

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?

'Use preflight=true to inspect admission without launching a worker' is real when-to-use guidance, and the mode gloss ('Think: collaboration; analyze: read/search; work: edits/shell') helps pick a mode. But there is no explicit statement of when to choose this over tandem_continue or tandem_work, no prerequisites, and no exclusions beyond the prompt/contract either-or.

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