@oneharness/sdk 0.26.1 → 0.27.1

package/dist/generated/schemas.json

@@ -169,6 +169,36 @@
                     "kind": "value",
                     "unless": null
                 },
+                {
+                    "option": "autoCompactTokens",
+                    "flag": "--auto-compact-tokens",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "toolSet",
+                    "flag": "--tool-set",
+                    "kind": "repeated",
+                    "unless": null
+                },
+                {
+                    "option": "noSkills",
+                    "flag": "--no-skills",
+                    "kind": "switch",
+                    "unless": null
+                },
+                {
+                    "option": "noMcp",
+                    "flag": "--no-mcp",
+                    "kind": "switch",
+                    "unless": null
+                },
+                {
+                    "option": "images",
+                    "flag": "--image",
+                    "kind": "repeated",
+                    "unless": null
+                },
                 {
                     "option": "cwd",
                     "flag": "--cwd",
@@ -470,6 +500,36 @@
                     "kind": "value",
                     "unless": null
                 },
+                {
+                    "option": "autoCompactTokens",
+                    "flag": "--auto-compact-tokens",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "toolSet",
+                    "flag": "--tool-set",
+                    "kind": "repeated",
+                    "unless": null
+                },
+                {
+                    "option": "noSkills",
+                    "flag": "--no-skills",
+                    "kind": "switch",
+                    "unless": null
+                },
+                {
+                    "option": "noMcp",
+                    "flag": "--no-mcp",
+                    "kind": "switch",
+                    "unless": null
+                },
+                {
+                    "option": "images",
+                    "flag": "--image",
+                    "kind": "repeated",
+                    "unless": null
+                },
                 {
                     "option": "cwd",
                     "flag": "--cwd",
@@ -988,6 +1048,86 @@
             ],
             "uncovered": []
         },
+        {
+            "method": "compact",
+            "argv": [
+                "compact"
+            ],
+            "options": "compact_options",
+            "output": "compact_outcome",
+            "stdout": "json",
+            "stdin": false,
+            "rust": "oneharness_core::io::compact::compact_session",
+            "always": [
+                "--compact",
+                "--format",
+                "json"
+            ],
+            "bindings": [
+                {
+                    "option": "session",
+                    "flag": "--session",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "sessionDir",
+                    "flag": "--session-dir",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "harness",
+                    "flag": "--harness",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "cwd",
+                    "flag": "--cwd",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "model",
+                    "flag": "--model",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "timeoutSeconds",
+                    "flag": "--timeout",
+                    "kind": "value",
+                    "unless": null
+                },
+                {
+                    "option": "env",
+                    "flag": "--env",
+                    "kind": "key-value",
+                    "unless": null
+                },
+                {
+                    "option": "bins",
+                    "flag": "--bin",
+                    "kind": "key-value",
+                    "unless": null
+                },
+                {
+                    "option": "config",
+                    "flag": "--config",
+                    "kind": "repeated",
+                    "unless": "noConfig",
+                    "unless_resolution": "refuse"
+                },
+                {
+                    "option": "noConfig",
+                    "flag": "--no-config",
+                    "kind": "switch",
+                    "unless": null
+                }
+            ],
+            "uncovered": []
+        },
         {
             "method": "history",
             "argv": [
@@ -1875,6 +2015,28 @@
                     "interrupt"
                 ]
             },
+            "Diagnostic": {
+                "description": "A setting a harness could not apply, named in the run's report.",
+                "type": "object",
+                "properties": {
+                    "harness": {
+                        "description": "The harness id the run used.",
+                        "type": "string"
+                    },
+                    "message": {
+                        "description": "What happened instead.",
+                        "type": "string"
+                    },
+                    "setting": {
+                        "$ref": "#/$defs/Setting"
+                    }
+                },
+                "required": [
+                    "harness",
+                    "setting",
+                    "message"
+                ]
+            },
             "ExecutionTelemetry": {
                 "description": "Measured execution telemetry for one harness run: when the invocation ran,\nand — when the harness's transcript supports it — how its wall clock split\nbetween provider latency and tool work.\n\nCarried from the runner/parser to the history writer *and*, since report\nschema `0.5`, serialized on [`RunResult::telemetry`]. Exposing it there is\nwhat lets a consumer read the numbers off the run it just made instead of\nre-opening the history file the same run wrote.\n\nInternally tagged by `source`, so the variant is a value a consumer switches\non rather than a shape it has to sniff. Every variant states only what was\nactually measured — there is no variant meaning \"no telemetry\"; that is a\n`null` field.",
                 "oneOf": [
@@ -2030,6 +2192,11 @@
                         "description": "The shared Codex app-server a pooled dispatch's turn ran on went away\nunder it: the connection reached EOF, was closed, or refused a write\n(`EPIPE`) while oneharness's own record showed a turn started and not\ncompleted. The server crashed or was restarted, not the turn — so it is\nnever a turn failure, and a fallback chain moves on to its next\ncandidate (`\"app-server-lost\"`).",
                         "type": "string",
                         "const": "app_server_lost"
+                    },
+                    {
+                        "description": "The request carried an input this harness cannot take — today an\nimage (`images`) on a harness with no image input — so the harness was\nrefused for the run before it started, and a fallback chain moves on\n(`\"unsupported-input\"`). Its `error` names the input.",
+                        "type": "string",
+                        "const": "unsupported_input"
                     }
                 ]
             },
@@ -2121,6 +2288,11 @@
                         "description": "The shared Codex app-server went away under the candidate's live turn.",
                         "type": "string",
                         "const": "app-server-lost"
+                    },
+                    {
+                        "description": "The harness cannot take an input the request carried (an image).",
+                        "type": "string",
+                        "const": "unsupported-input"
                     }
                 ]
             },
@@ -2221,6 +2393,16 @@
                         "description": "The binary name or path oneharness resolved and would invoke.",
                         "type": "string"
                     },
+                    "calls": {
+                        "description": "One usage per model call the turn made, in order, read from the\nharness's own stream or session record (see\n[`crate::domain::lean::Setting::Calls`]). Like `usage`, it covers the\nrun's final attempt when a retry ran it again. Absent where the harness\nexposes no per-call figures, and then `diagnostics` says why. The\nrun's `usage` total is unchanged by it. Added in report schema `0.13`.",
+                        "type": [
+                            "array",
+                            "null"
+                        ],
+                        "items": {
+                            "$ref": "#/$defs/Usage"
+                        }
+                    },
                     "command": {
                         "description": "The exact argv oneharness built; its first element is the binary.",
                         "type": "array",
@@ -2228,6 +2410,13 @@
                             "type": "string"
                         }
                     },
+                    "diagnostics": {
+                        "description": "Each setting this run's harness could not apply, or applied in part\n(`auto_compact_tokens`, `tool_set`, `load_skills`, `load_mcp`, `calls`):\nthe run proceeded, and this says what it did instead. Absent when\nempty. Added in report schema `0.13`.",
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/$defs/Diagnostic"
+                        }
+                    },
                     "duration_ms": {
                         "description": "Wall-clock duration of the run; `null` when not executed.",
                         "type": [
@@ -2518,6 +2707,46 @@
                     "store_file"
                 ]
             },
+            "Setting": {
+                "description": "One of the settings this module translates.",
+                "oneOf": [
+                    {
+                        "description": "Compact a session's context once it reaches this many tokens.",
+                        "type": "string",
+                        "const": "auto_compact_tokens"
+                    },
+                    {
+                        "description": "Compact a named session immediately (`oneharness compact`).",
+                        "type": "string",
+                        "const": "compact_now"
+                    },
+                    {
+                        "description": "Load only these built-in tool classes.",
+                        "type": "string",
+                        "const": "tool_set"
+                    },
+                    {
+                        "description": "`false` loads no skills list.",
+                        "type": "string",
+                        "const": "load_skills"
+                    },
+                    {
+                        "description": "`false` loads no MCP server or MCP tool.",
+                        "type": "string",
+                        "const": "load_mcp"
+                    },
+                    {
+                        "description": "Attach image files to the prompt as images.",
+                        "type": "string",
+                        "const": "images"
+                    },
+                    {
+                        "description": "One usage per model call (`RunResult::calls`).",
+                        "type": "string",
+                        "const": "calls"
+                    }
+                ]
+            },
             "Status": {
                 "description": "The outcome of attempting to run one harness.",
                 "oneOf": [
@@ -3052,6 +3281,28 @@
                     "interrupt"
                 ]
             },
+            "Diagnostic": {
+                "description": "A setting a harness could not apply, named in the run's report.",
+                "type": "object",
+                "properties": {
+                    "harness": {
+                        "description": "The harness id the run used.",
+                        "type": "string"
+                    },
+                    "message": {
+                        "description": "What happened instead.",
+                        "type": "string"
+                    },
+                    "setting": {
+                        "$ref": "#/$defs/Setting"
+                    }
+                },
+                "required": [
+                    "harness",
+                    "setting",
+                    "message"
+                ]
+            },
             "ExecutionTelemetry": {
                 "description": "Measured execution telemetry for one harness run: when the invocation ran,\nand — when the harness's transcript supports it — how its wall clock split\nbetween provider latency and tool work.\n\nCarried from the runner/parser to the history writer *and*, since report\nschema `0.5`, serialized on [`RunResult::telemetry`]. Exposing it there is\nwhat lets a consumer read the numbers off the run it just made instead of\nre-opening the history file the same run wrote.\n\nInternally tagged by `source`, so the variant is a value a consumer switches\non rather than a shape it has to sniff. Every variant states only what was\nactually measured — there is no variant meaning \"no telemetry\"; that is a\n`null` field.",
                 "oneOf": [
@@ -3207,6 +3458,11 @@
                         "description": "The shared Codex app-server a pooled dispatch's turn ran on went away\nunder it: the connection reached EOF, was closed, or refused a write\n(`EPIPE`) while oneharness's own record showed a turn started and not\ncompleted. The server crashed or was restarted, not the turn — so it is\nnever a turn failure, and a fallback chain moves on to its next\ncandidate (`\"app-server-lost\"`).",
                         "type": "string",
                         "const": "app_server_lost"
+                    },
+                    {
+                        "description": "The request carried an input this harness cannot take — today an\nimage (`images`) on a harness with no image input — so the harness was\nrefused for the run before it started, and a fallback chain moves on\n(`\"unsupported-input\"`). Its `error` names the input.",
+                        "type": "string",
+                        "const": "unsupported_input"
                     }
                 ]
             },
@@ -3298,6 +3554,11 @@
                         "description": "The shared Codex app-server went away under the candidate's live turn.",
                         "type": "string",
                         "const": "app-server-lost"
+                    },
+                    {
+                        "description": "The harness cannot take an input the request carried (an image).",
+                        "type": "string",
+                        "const": "unsupported-input"
                     }
                 ]
             },
@@ -3562,6 +3823,16 @@
                         "description": "The binary name or path oneharness resolved and would invoke.",
                         "type": "string"
                     },
+                    "calls": {
+                        "description": "One usage per model call the turn made, in order, read from the\nharness's own stream or session record (see\n[`crate::domain::lean::Setting::Calls`]). Like `usage`, it covers the\nrun's final attempt when a retry ran it again. Absent where the harness\nexposes no per-call figures, and then `diagnostics` says why. The\nrun's `usage` total is unchanged by it. Added in report schema `0.13`.",
+                        "type": [
+                            "array",
+                            "null"
+                        ],
+                        "items": {
+                            "$ref": "#/$defs/Usage"
+                        }
+                    },
                     "command": {
                         "description": "The exact argv oneharness built; its first element is the binary.",
                         "type": "array",
@@ -3569,6 +3840,13 @@
                             "type": "string"
                         }
                     },
+                    "diagnostics": {
+                        "description": "Each setting this run's harness could not apply, or applied in part\n(`auto_compact_tokens`, `tool_set`, `load_skills`, `load_mcp`, `calls`):\nthe run proceeded, and this says what it did instead. Absent when\nempty. Added in report schema `0.13`.",
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/$defs/Diagnostic"
+                        }
+                    },
                     "duration_ms": {
                         "description": "Wall-clock duration of the run; `null` when not executed.",
                         "type": [
@@ -3859,6 +4137,46 @@
                     "store_file"
                 ]
             },
+            "Setting": {
+                "description": "One of the settings this module translates.",
+                "oneOf": [
+                    {
+                        "description": "Compact a session's context once it reaches this many tokens.",
+                        "type": "string",
+                        "const": "auto_compact_tokens"
+                    },
+                    {
+                        "description": "Compact a named session immediately (`oneharness compact`).",
+                        "type": "string",
+                        "const": "compact_now"
+                    },
+                    {
+                        "description": "Load only these built-in tool classes.",
+                        "type": "string",
+                        "const": "tool_set"
+                    },
+                    {
+                        "description": "`false` loads no skills list.",
+                        "type": "string",
+                        "const": "load_skills"
+                    },
+                    {
+                        "description": "`false` loads no MCP server or MCP tool.",
+                        "type": "string",
+                        "const": "load_mcp"
+                    },
+                    {
+                        "description": "Attach image files to the prompt as images.",
+                        "type": "string",
+                        "const": "images"
+                    },
+                    {
+                        "description": "One usage per model call (`RunResult::calls`).",
+                        "type": "string",
+                        "const": "calls"
+                    }
+                ]
+            },
             "Status": {
                 "description": "The outcome of attempting to run one harness.",
                 "oneOf": [
@@ -3996,6 +4314,12 @@
                 "description": "Run against every supported harness.",
                 "type": "boolean"
             },
+            "autoCompactTokens": {
+                "description": "Compact a session's context once it reaches this many tokens (a\npositive integer), through each harness's own knob.",
+                "type": "integer",
+                "format": "uint64",
+                "minimum": 1
+            },
             "batchPrompts": {
                 "description": "Further prompts, making this a **batch**: one harness fanned over each\nprompt, sharing the cacheable `system`/model prefix. Combined order is\n`prompt`, then these, then `promptFiles` — the CLI's own order.",
                 "type": "array",
@@ -4068,6 +4392,13 @@
                 "type": "string",
                 "minLength": 1
             },
+            "images": {
+                "description": "Image files attached to the prompt as images the model sees.",
+                "type": "array",
+                "items": {
+                    "type": "string"
+                }
+            },
             "maxParallel": {
                 "description": "Maximum harnesses (or, in a batch, prompts) to run concurrently.",
                 "type": "integer",
@@ -4102,6 +4433,14 @@
                 "description": "Do NOT record history for this run, overriding config or the\n`ONEHARNESS_HISTORY` environment override.",
                 "type": "boolean"
             },
+            "noMcp": {
+                "description": "Load no MCP server or MCP tool.",
+                "type": "boolean"
+            },
+            "noSkills": {
+                "description": "Load no skills list.",
+                "type": "boolean"
+            },
             "outputDir": {
                 "description": "Write each harness's raw stdout/stderr under this directory.",
                 "type": "string"
@@ -4187,6 +4526,14 @@
                 "type": "integer",
                 "format": "uint64",
                 "minimum": 0
+            },
+            "toolSet": {
+                "description": "Load only these built-in tool classes; every other built-in tool is\nnot loaded. At least one: each class is sent as its own `--tool-set`,\nso an empty array would send nothing at all and is refused rather than\nsilently loading the harness's own tools.",
+                "type": "array",
+                "items": {
+                    "$ref": "#/$defs/ToolClass"
+                },
+                "minItems": 1
             }
         },
         "additionalProperties": false,
@@ -4297,6 +4644,21 @@
                         "const": "fallback"
                     }
                 ]
+            },
+            "ToolClass": {
+                "description": "A harness-agnostic class of built-in tool a turn may load (`tool_set`).",
+                "oneOf": [
+                    {
+                        "description": "Run commands.",
+                        "type": "string",
+                        "const": "shell"
+                    },
+                    {
+                        "description": "Read files.",
+                        "type": "string",
+                        "const": "read"
+                    }
+                ]
             }
         }
     },
@@ -4743,7 +5105,8 @@
                             "schema_version": {
                                 "type": "string",
                                 "enum": [
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "started": {
@@ -4805,7 +5168,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "session_name": {
@@ -4950,7 +5314,8 @@
                                                             "1.8",
                                                             "1.9",
                                                             "1.10",
-                                                            "1.11"
+                                                            "1.11",
+                                                            "1.12"
                                                         ]
                                                     }
                                                 },
@@ -5014,7 +5379,8 @@
                                                             "1.8",
                                                             "1.9",
                                                             "1.10",
-                                                            "1.11"
+                                                            "1.11",
+                                                            "1.12"
                                                         ]
                                                     },
                                                     "status": {
@@ -5063,7 +5429,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         },
@@ -5104,7 +5471,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -5130,6 +5498,7 @@
                                                             "model_mismatch",
                                                             "server_overloaded",
                                                             "app_server_lost",
+                                                            "unsupported_input",
                                                             null
                                                         ]
                                                     }
@@ -5147,7 +5516,8 @@
                                                             "1.8",
                                                             "1.9",
                                                             "1.10",
-                                                            "1.11"
+                                                            "1.11",
+                                                            "1.12"
                                                         ]
                                                     }
                                                 }
@@ -5170,6 +5540,7 @@
                                                             "model_mismatch",
                                                             "server_overloaded",
                                                             "app_server_lost",
+                                                            "unsupported_input",
                                                             null
                                                         ]
                                                     }
@@ -5186,7 +5557,8 @@
                                                             "1.8",
                                                             "1.9",
                                                             "1.10",
-                                                            "1.11"
+                                                            "1.11",
+                                                            "1.12"
                                                         ]
                                                     }
                                                 }
@@ -5210,6 +5582,7 @@
                                                             "input_too_large",
                                                             "server_overloaded",
                                                             "app_server_lost",
+                                                            "unsupported_input",
                                                             null
                                                         ]
                                                     }
@@ -5224,7 +5597,8 @@
                                                             "1.8",
                                                             "1.9",
                                                             "1.10",
-                                                            "1.11"
+                                                            "1.11",
+                                                            "1.12"
                                                         ]
                                                     }
                                                 }
@@ -5248,6 +5622,7 @@
                                                             "input_too_large",
                                                             "model_mismatch",
                                                             "app_server_lost",
+                                                            "unsupported_input",
                                                             null
                                                         ]
                                                     }
@@ -5261,7 +5636,8 @@
                                                         "enum": [
                                                             "1.9",
                                                             "1.10",
-                                                            "1.11"
+                                                            "1.11",
+                                                            "1.12"
                                                         ]
                                                     }
                                                 }
@@ -5285,6 +5661,7 @@
                                                             "input_too_large",
                                                             "model_mismatch",
                                                             "server_overloaded",
+                                                            "unsupported_input",
                                                             null
                                                         ]
                                                     }
@@ -5297,21 +5674,58 @@
                                                         "type": "string",
                                                         "enum": [
                                                             "1.10",
-                                                            "1.11"
+                                                            "1.11",
+                                                            "1.12"
                                                         ]
                                                     }
                                                 }
                                             }
                                         ]
-                                    }
-                                ]
-                            }
-                        ],
-                        "oneOf": [
-                            {
-                                "allOf": [
+                                    },
                                     {
-                                        "description": "The terminal summary for one harness run.",
+                                        "anyOf": [
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "failure_kind": {
+                                                        "enum": [
+                                                            "auth",
+                                                            "rate_limit",
+                                                            "model_not_found",
+                                                            "quota",
+                                                            "session_not_found",
+                                                            "tool_deferred",
+                                                            "untrusted_directory",
+                                                            "input_too_large",
+                                                            "model_mismatch",
+                                                            "server_overloaded",
+                                                            "app_server_lost",
+                                                            null
+                                                        ]
+                                                    }
+                                                }
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "schema_version": {
+                                                        "type": "string",
+                                                        "enum": [
+                                                            "1.12"
+                                                        ]
+                                                    }
+                                                }
+                                            }
+                                        ]
+                                    }
+                                ]
+                            }
+                        ],
+                        "oneOf": [
+                            {
+                                "allOf": [
+                                    {
+                                        "description": "The terminal summary for one harness run.",
                                         "type": "object",
                                         "properties": {
                                             "duration_ms": {
@@ -5409,7 +5823,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "session": {
@@ -5616,7 +6031,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "session": {
@@ -5821,7 +6237,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "session": {
@@ -6007,7 +6424,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "session": {
@@ -6192,7 +6610,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "session": {
@@ -6394,7 +6813,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "session": {
@@ -6640,6 +7060,11 @@
                         "description": "The shared Codex app-server a pooled dispatch's turn ran on went away\nunder it: the connection reached EOF, was closed, or refused a write\n(`EPIPE`) while oneharness's own record showed a turn started and not\ncompleted. The server crashed or was restarted, not the turn — so it is\nnever a turn failure, and a fallback chain moves on to its next\ncandidate (`\"app-server-lost\"`).",
                         "type": "string",
                         "const": "app_server_lost"
+                    },
+                    {
+                        "description": "The request carried an input this harness cannot take — today an\nimage (`images`) on a harness with no image input — so the harness was\nrefused for the run before it started, and a fallback chain moves on\n(`\"unsupported-input\"`). Its `error` names the input.",
+                        "type": "string",
+                        "const": "unsupported_input"
                     }
                 ]
             },
@@ -6873,7 +7298,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 },
@@ -6937,7 +7363,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     },
                                     "status": {
@@ -6986,7 +7413,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             }
                         },
@@ -7027,7 +7455,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             }
                         }
@@ -7053,6 +7482,7 @@
                                             "model_mismatch",
                                             "server_overloaded",
                                             "app_server_lost",
+                                            "unsupported_input",
                                             null
                                         ]
                                     }
@@ -7070,7 +7500,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 }
@@ -7093,6 +7524,7 @@
                                             "model_mismatch",
                                             "server_overloaded",
                                             "app_server_lost",
+                                            "unsupported_input",
                                             null
                                         ]
                                     }
@@ -7109,7 +7541,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 }
@@ -7133,6 +7566,7 @@
                                             "input_too_large",
                                             "server_overloaded",
                                             "app_server_lost",
+                                            "unsupported_input",
                                             null
                                         ]
                                     }
@@ -7147,7 +7581,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 }
@@ -7171,6 +7606,7 @@
                                             "input_too_large",
                                             "model_mismatch",
                                             "app_server_lost",
+                                            "unsupported_input",
                                             null
                                         ]
                                     }
@@ -7184,7 +7620,8 @@
                                         "enum": [
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 }
@@ -7208,6 +7645,7 @@
                                             "input_too_large",
                                             "model_mismatch",
                                             "server_overloaded",
+                                            "unsupported_input",
                                             null
                                         ]
                                     }
@@ -7220,7 +7658,44 @@
                                         "type": "string",
                                         "enum": [
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
+                                        ]
+                                    }
+                                }
+                            }
+                        ]
+                    },
+                    {
+                        "anyOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "failure_kind": {
+                                        "enum": [
+                                            "auth",
+                                            "rate_limit",
+                                            "model_not_found",
+                                            "quota",
+                                            "session_not_found",
+                                            "tool_deferred",
+                                            "untrusted_directory",
+                                            "input_too_large",
+                                            "model_mismatch",
+                                            "server_overloaded",
+                                            "app_server_lost",
+                                            null
+                                        ]
+                                    }
+                                }
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "schema_version": {
+                                        "type": "string",
+                                        "enum": [
+                                            "1.12"
                                         ]
                                     }
                                 }
@@ -7532,7 +8007,8 @@
                             "1.8",
                             "1.9",
                             "1.10",
-                            "1.11"
+                            "1.11",
+                            "1.12"
                         ]
                     },
                     "session": {
@@ -8194,7 +8670,8 @@
                             "1.8",
                             "1.9",
                             "1.10",
-                            "1.11"
+                            "1.11",
+                            "1.12"
                         ]
                     },
                     "session": {
@@ -8394,7 +8871,8 @@
                             "1.8",
                             "1.9",
                             "1.10",
-                            "1.11"
+                            "1.11",
+                            "1.12"
                         ]
                     },
                     "session": {
@@ -8592,7 +9070,8 @@
                             "1.8",
                             "1.9",
                             "1.10",
-                            "1.11"
+                            "1.11",
+                            "1.12"
                         ]
                     },
                     "session": {
@@ -8791,7 +9270,8 @@
                             "1.8",
                             "1.9",
                             "1.10",
-                            "1.11"
+                            "1.11",
+                            "1.12"
                         ]
                     },
                     "session": {
@@ -9755,6 +10235,11 @@
                         "description": "The shared Codex app-server a pooled dispatch's turn ran on went away\nunder it: the connection reached EOF, was closed, or refused a write\n(`EPIPE`) while oneharness's own record showed a turn started and not\ncompleted. The server crashed or was restarted, not the turn — so it is\nnever a turn failure, and a fallback chain moves on to its next\ncandidate (`\"app-server-lost\"`).",
                         "type": "string",
                         "const": "app_server_lost"
+                    },
+                    {
+                        "description": "The request carried an input this harness cannot take — today an\nimage (`images`) on a harness with no image input — so the harness was\nrefused for the run before it started, and a fallback chain moves on\n(`\"unsupported-input\"`). Its `error` names the input.",
+                        "type": "string",
+                        "const": "unsupported_input"
                     }
                 ]
             },
@@ -10144,6 +10629,11 @@
                         "description": "The shared Codex app-server a pooled dispatch's turn ran on went away\nunder it: the connection reached EOF, was closed, or refused a write\n(`EPIPE`) while oneharness's own record showed a turn started and not\ncompleted. The server crashed or was restarted, not the turn — so it is\nnever a turn failure, and a fallback chain moves on to its next\ncandidate (`\"app-server-lost\"`).",
                         "type": "string",
                         "const": "app_server_lost"
+                    },
+                    {
+                        "description": "The request carried an input this harness cannot take — today an\nimage (`images`) on a harness with no image input — so the harness was\nrefused for the run before it started, and a fallback chain moves on\n(`\"unsupported-input\"`). Its `error` names the input.",
+                        "type": "string",
+                        "const": "unsupported_input"
                     }
                 ]
             },
@@ -10185,7 +10675,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     },
                                     "session_name": {
@@ -10336,7 +10827,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         },
@@ -10400,7 +10892,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "status": {
@@ -10449,7 +10942,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 },
@@ -10490,7 +10984,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 }
@@ -10516,6 +11011,7 @@
                                                     "model_mismatch",
                                                     "server_overloaded",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -10533,7 +11029,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -10556,6 +11053,7 @@
                                                     "model_mismatch",
                                                     "server_overloaded",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -10572,7 +11070,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -10596,6 +11095,7 @@
                                                     "input_too_large",
                                                     "server_overloaded",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -10610,7 +11110,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -10634,6 +11135,7 @@
                                                     "input_too_large",
                                                     "model_mismatch",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -10647,7 +11149,8 @@
                                                 "enum": [
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -10671,6 +11174,7 @@
                                                     "input_too_large",
                                                     "model_mismatch",
                                                     "server_overloaded",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -10683,7 +11187,44 @@
                                                 "type": "string",
                                                 "enum": [
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "anyOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "failure_kind": {
+                                                "enum": [
+                                                    "auth",
+                                                    "rate_limit",
+                                                    "model_not_found",
+                                                    "quota",
+                                                    "session_not_found",
+                                                    "tool_deferred",
+                                                    "untrusted_directory",
+                                                    "input_too_large",
+                                                    "model_mismatch",
+                                                    "server_overloaded",
+                                                    "app_server_lost",
+                                                    null
+                                                ]
+                                            }
+                                        }
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "schema_version": {
+                                                "type": "string",
+                                                "enum": [
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -10995,7 +11536,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -11657,7 +12199,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -11857,7 +12400,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -12055,7 +12599,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -12254,7 +12799,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -13399,6 +13945,11 @@
                         "description": "The shared Codex app-server a pooled dispatch's turn ran on went away\nunder it: the connection reached EOF, was closed, or refused a write\n(`EPIPE`) while oneharness's own record showed a turn started and not\ncompleted. The server crashed or was restarted, not the turn — so it is\nnever a turn failure, and a fallback chain moves on to its next\ncandidate (`\"app-server-lost\"`).",
                         "type": "string",
                         "const": "app_server_lost"
+                    },
+                    {
+                        "description": "The request carried an input this harness cannot take — today an\nimage (`images`) on a harness with no image input — so the harness was\nrefused for the run before it started, and a fallback chain moves on\n(`\"unsupported-input\"`). Its `error` names the input.",
+                        "type": "string",
+                        "const": "unsupported_input"
                     }
                 ]
             },
@@ -13453,7 +14004,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         },
@@ -13517,7 +14069,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             },
                                             "status": {
@@ -13566,7 +14119,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 },
@@ -13607,7 +14161,8 @@
                                             "1.8",
                                             "1.9",
                                             "1.10",
-                                            "1.11"
+                                            "1.11",
+                                            "1.12"
                                         ]
                                     }
                                 }
@@ -13633,6 +14188,7 @@
                                                     "model_mismatch",
                                                     "server_overloaded",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -13650,7 +14206,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -13673,6 +14230,7 @@
                                                     "model_mismatch",
                                                     "server_overloaded",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -13689,7 +14247,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -13713,6 +14272,7 @@
                                                     "input_too_large",
                                                     "server_overloaded",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -13727,7 +14287,8 @@
                                                     "1.8",
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -13751,6 +14312,7 @@
                                                     "input_too_large",
                                                     "model_mismatch",
                                                     "app_server_lost",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -13764,7 +14326,8 @@
                                                 "enum": [
                                                     "1.9",
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -13788,6 +14351,7 @@
                                                     "input_too_large",
                                                     "model_mismatch",
                                                     "server_overloaded",
+                                                    "unsupported_input",
                                                     null
                                                 ]
                                             }
@@ -13800,7 +14364,44 @@
                                                 "type": "string",
                                                 "enum": [
                                                     "1.10",
-                                                    "1.11"
+                                                    "1.11",
+                                                    "1.12"
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "anyOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "failure_kind": {
+                                                "enum": [
+                                                    "auth",
+                                                    "rate_limit",
+                                                    "model_not_found",
+                                                    "quota",
+                                                    "session_not_found",
+                                                    "tool_deferred",
+                                                    "untrusted_directory",
+                                                    "input_too_large",
+                                                    "model_mismatch",
+                                                    "server_overloaded",
+                                                    "app_server_lost",
+                                                    null
+                                                ]
+                                            }
+                                        }
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "schema_version": {
+                                                "type": "string",
+                                                "enum": [
+                                                    "1.12"
                                                 ]
                                             }
                                         }
@@ -14112,7 +14713,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -14774,7 +15376,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -14974,7 +15577,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -15172,7 +15776,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -15371,7 +15976,8 @@
                                     "1.8",
                                     "1.9",
                                     "1.10",
-                                    "1.11"
+                                    "1.11",
+                                    "1.12"
                                 ]
                             },
                             "session": {
@@ -16609,6 +17215,18 @@
                         "description": "Whether the unified allow/deny rule lists and hooks table can be synced\ninto that file (see the README support matrix).",
                         "type": "boolean"
                     },
+                    "supports_auto_compact": {
+                        "description": "Whether `auto_compact_tokens` reaches this harness's own compaction\nknob. Every `supports_*` flag below is read from the translation table\n([`crate::domain::lean::TRANSLATIONS`]): `false` means a run asking for\nthe setting carries a diagnostic (or, for images, refuses the harness).",
+                        "type": "boolean"
+                    },
+                    "supports_call_usage": {
+                        "description": "Whether a result's `calls` can carry per-call usage.",
+                        "type": "boolean"
+                    },
+                    "supports_compact_now": {
+                        "description": "Whether `oneharness compact` can compact this harness's sessions.",
+                        "type": "boolean"
+                    },
                     "supports_denied_tools": {
                         "type": "boolean"
                     },
@@ -16619,6 +17237,14 @@
                     "supports_hooks": {
                         "type": "boolean"
                     },
+                    "supports_images": {
+                        "description": "Whether `images` reach the model as images.",
+                        "type": "boolean"
+                    },
+                    "supports_mcp_off": {
+                        "description": "Whether `load_mcp = false` loads no MCP server.",
+                        "type": "boolean"
+                    },
                     "supports_mock_deny": {
                         "description": "Whether `oneharness mock <id>` can express a pre-tool *deny* for this\nharness (the same protocol `oneharness gate` speaks).",
                         "type": "boolean"
@@ -16639,10 +17265,18 @@
                         "description": "Whether `run --resume <session>` is supported for this harness.",
                         "type": "boolean"
                     },
+                    "supports_skills_off": {
+                        "description": "Whether `load_skills = false` loads no skills list.",
+                        "type": "boolean"
+                    },
                     "supports_system_file": {
                         "description": "Whether a large system prompt can be delivered off the argv via a file\nflag (Claude Code's `--append-system-prompt-file`). `false` does not mean a\nlarge system is unhandled — for a harness whose system rides the prompt it\ntravels on stdin with the prompt; see the README large-prompt matrix.",
                         "type": "boolean"
                     },
+                    "supports_tool_set": {
+                        "description": "Whether `tool_set` loads exactly the named classes (`false` for codex,\nwhich applies it in part and says so).",
+                        "type": "boolean"
+                    },
                     "sync_file": {
                         "description": "The project-scoped config file `oneharness sync` writes for this\nharness; `null` when it has none (sync settings are then rejected).",
                         "type": [
@@ -16679,6 +17313,13 @@
                     "mock_rewrite",
                     "supports_prompt_stdin",
                     "supports_system_file",
+                    "supports_auto_compact",
+                    "supports_compact_now",
+                    "supports_tool_set",
+                    "supports_skills_off",
+                    "supports_mcp_off",
+                    "supports_images",
+                    "supports_call_usage",
                     "example_command",
                     "variants"
                 ]
@@ -16974,6 +17615,9 @@
             "allowed_tools": {
                 "$ref": "#/$defs/Field2"
             },
+            "auto_compact_tokens": {
+                "$ref": "#/$defs/Field5"
+            },
             "bypass": {
                 "$ref": "#/$defs/Field"
             },
@@ -17024,10 +17668,16 @@
                 "$ref": "#/$defs/Field3"
             },
             "hooks": {
-                "$ref": "#/$defs/Field10"
+                "$ref": "#/$defs/Field11"
+            },
+            "load_mcp": {
+                "$ref": "#/$defs/Field"
+            },
+            "load_skills": {
+                "$ref": "#/$defs/Field"
             },
             "max_parallel": {
-                "$ref": "#/$defs/Field8"
+                "$ref": "#/$defs/Field9"
             },
             "mode": {
                 "description": "The configured `mode`, if any. Unset when only the legacy `bypass` field\n(or neither) is set — the effective mode then derives from `bypass`.",
@@ -17041,7 +17691,7 @@
                 "$ref": "#/$defs/Field2"
             },
             "output_format": {
-                "$ref": "#/$defs/Field6"
+                "$ref": "#/$defs/Field7"
             },
             "reasoning": {
                 "description": "Reasoning / thinking effort (`--reasoning` / `ONEHARNESS_REASONING`), if\nany. Forwarded to reasoning-capable harnesses only.",
@@ -17052,19 +17702,19 @@
             },
             "run_mode": {
                 "description": "The effective run mode: a configured value, else `fallback` (the\nbuilt-in default, attributed to [`DEFAULT_SOURCE`]) — the report says what\na run would do, so an unset mode is never shown as `null`.",
-                "$ref": "#/$defs/Field9"
+                "$ref": "#/$defs/Field10"
             },
             "schema_file": {
                 "$ref": "#/$defs/Field3"
             },
             "schema_max_retries": {
-                "$ref": "#/$defs/Field7"
+                "$ref": "#/$defs/Field8"
             },
             "schema_version": {
                 "type": "string"
             },
             "server_overloaded_max_retries": {
-                "$ref": "#/$defs/Field7"
+                "$ref": "#/$defs/Field8"
             },
             "stream": {
                 "description": "Whether config asks every `run` to stream (`--stream` / ONEHARNESS_STREAM);\ndefaults to false, the built-in buffered report.",
@@ -17075,6 +17725,9 @@
             },
             "timeout": {
                 "$ref": "#/$defs/Field5"
+            },
+            "tool_set": {
+                "$ref": "#/$defs/Field6"
             }
         },
         "required": [
@@ -17090,6 +17743,10 @@
             "bypass",
             "mode",
             "timeout",
+            "auto_compact_tokens",
+            "tool_set",
+            "load_skills",
+            "load_mcp",
             "output_format",
             "stream",
             "schema_file",
@@ -17147,6 +17804,32 @@
                 ]
             },
             "Field10": {
+                "description": "One resolved field in the `oneharness config` report: the effective value\nplus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both\nare `null` when the field is unset everywhere and has no built-in default.",
+                "type": "object",
+                "properties": {
+                    "source": {
+                        "type": [
+                            "string",
+                            "null"
+                        ]
+                    },
+                    "value": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/$defs/RunMode"
+                            },
+                            {
+                                "type": "null"
+                            }
+                        ]
+                    }
+                },
+                "required": [
+                    "value",
+                    "source"
+                ]
+            },
+            "Field11": {
                 "description": "One resolved field in the `oneharness config` report: the effective value\nplus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both\nare `null` when the field is unset everywhere and has no built-in default.",
                 "type": "object",
                 "properties": {
@@ -17171,7 +17854,7 @@
                     "source"
                 ]
             },
-            "Field11": {
+            "Field12": {
                 "description": "One resolved field in the `oneharness config` report: the effective value\nplus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both\nare `null` when the field is unset everywhere and has no built-in default.",
                 "type": "object",
                 "properties": {
@@ -17305,14 +17988,13 @@
                         ]
                     },
                     "value": {
-                        "anyOf": [
-                            {
-                                "$ref": "#/$defs/OutputFormat"
-                            },
-                            {
-                                "type": "null"
-                            }
-                        ]
+                        "type": [
+                            "array",
+                            "null"
+                        ],
+                        "items": {
+                            "$ref": "#/$defs/ToolClass"
+                        }
                     }
                 },
                 "required": [
@@ -17331,12 +18013,14 @@
                         ]
                     },
                     "value": {
-                        "type": [
-                            "integer",
-                            "null"
-                        ],
-                        "format": "uint32",
-                        "minimum": 0
+                        "anyOf": [
+                            {
+                                "$ref": "#/$defs/OutputFormat"
+                            },
+                            {
+                                "type": "null"
+                            }
+                        ]
                     }
                 },
                 "required": [
@@ -17359,7 +18043,7 @@
                             "integer",
                             "null"
                         ],
-                        "format": "uint",
+                        "format": "uint32",
                         "minimum": 0
                     }
                 },
@@ -17379,14 +18063,12 @@
                         ]
                     },
                     "value": {
-                        "anyOf": [
-                            {
-                                "$ref": "#/$defs/RunMode"
-                            },
-                            {
-                                "type": "null"
-                            }
-                        ]
+                        "type": [
+                            "integer",
+                            "null"
+                        ],
+                        "format": "uint",
+                        "minimum": 0
                     }
                 },
                 "required": [
@@ -17416,7 +18098,7 @@
                         "description": "The resolved `app_server` (`\"shared\"` by default), present only for\n`codex`.",
                         "anyOf": [
                             {
-                                "$ref": "#/$defs/Field11"
+                                "$ref": "#/$defs/Field12"
                             },
                             {
                                 "type": "null"
@@ -17637,6 +18319,21 @@
                     }
                 ]
             },
+            "ToolClass": {
+                "description": "A harness-agnostic class of built-in tool a turn may load (`tool_set`).",
+                "oneOf": [
+                    {
+                        "description": "Run commands.",
+                        "type": "string",
+                        "const": "shell"
+                    },
+                    {
+                        "description": "Read files.",
+                        "type": "string",
+                        "const": "read"
+                    }
+                ]
+            },
             "VariantReport": {
                 "type": "object",
                 "properties": {
@@ -17658,7 +18355,7 @@
                         "description": "The `app_server` a launch of this variant resolves to: the variant's\nown, else its harness's, else `\"shared\"`. Present only for `codex`.",
                         "anyOf": [
                             {
-                                "$ref": "#/$defs/Field11"
+                                "$ref": "#/$defs/Field12"
                             },
                             {
                                 "type": "null"
@@ -18966,6 +19663,213 @@
             }
         }
     },
+    "compact_options": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "title": "CompactOptions",
+        "description": "Options accepted by the language SDKs' `compact()`: compact a named\nsession now (`oneharness compact`).",
+        "type": "object",
+        "properties": {
+            "bins": {
+                "type": "object",
+                "additionalProperties": {
+                    "type": "string"
+                }
+            },
+            "config": {
+                "type": "array",
+                "items": {
+                    "type": "string"
+                }
+            },
+            "cwd": {
+                "type": "string"
+            },
+            "env": {
+                "type": "object",
+                "additionalProperties": {
+                    "type": "string"
+                }
+            },
+            "harness": {
+                "description": "The harness identity the session is expected to be bound to.",
+                "type": "string"
+            },
+            "model": {
+                "type": "string"
+            },
+            "noConfig": {
+                "type": "boolean"
+            },
+            "session": {
+                "description": "The caller-owned session name (`run`'s `session`).",
+                "type": "string",
+                "minLength": 1
+            },
+            "sessionDir": {
+                "type": "string"
+            },
+            "timeoutSeconds": {
+                "type": "integer",
+                "format": "uint64",
+                "minimum": 0
+            }
+        },
+        "additionalProperties": false,
+        "required": [
+            "session"
+        ]
+    },
+    "compact_outcome": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "title": "CompactOutcome",
+        "description": "The `oneharness compact` report.",
+        "type": "object",
+        "properties": {
+            "context_tokens_after": {
+                "description": "The context size after compaction, where the harness reports it\n(claude-code's `compact_boundary.post_tokens`); `null` otherwise.",
+                "type": [
+                    "integer",
+                    "null"
+                ],
+                "format": "uint64",
+                "minimum": 0
+            },
+            "context_tokens_before": {
+                "description": "The context size before compaction, where the harness reports it\n(claude-code's `compact_boundary.pre_tokens`); `null` otherwise.",
+                "type": [
+                    "integer",
+                    "null"
+                ],
+                "format": "uint64",
+                "minimum": 0
+            },
+            "error": {
+                "description": "Why the compaction is `unsupported` or `failed`; absent otherwise.",
+                "type": [
+                    "string",
+                    "null"
+                ]
+            },
+            "harness": {
+                "description": "The harness identity the session is bound to.",
+                "type": "string"
+            },
+            "schema_version": {
+                "type": "string"
+            },
+            "session": {
+                "description": "The session name compacted.",
+                "type": "string"
+            },
+            "status": {
+                "$ref": "#/$defs/CompactStatus"
+            },
+            "token": {
+                "description": "The native session token the name continues after this call: the\ncompacted fork's on `completed`, the untouched original's otherwise.\n`null` when the request was refused before a session was resolved.",
+                "type": [
+                    "string",
+                    "null"
+                ]
+            },
+            "usage": {
+                "description": "The compaction's own usage, every field `null` where the harness\nreports none.",
+                "$ref": "#/$defs/Usage"
+            }
+        },
+        "required": [
+            "schema_version",
+            "status",
+            "session",
+            "harness",
+            "context_tokens_before",
+            "context_tokens_after",
+            "usage"
+        ],
+        "$defs": {
+            "CompactStatus": {
+                "description": "How a compaction ended.",
+                "oneOf": [
+                    {
+                        "description": "The harness compacted a fork of the session, and the session name now\ncontinues the compacted fork.",
+                        "type": "string",
+                        "const": "completed"
+                    },
+                    {
+                        "description": "The caller cancelled; the harness process was ended and the session is\nexactly as it was.",
+                        "type": "string",
+                        "const": "cancelled"
+                    },
+                    {
+                        "description": "The harness has no compaction oneharness can drive.",
+                        "type": "string",
+                        "const": "unsupported"
+                    },
+                    {
+                        "description": "The harness did not complete the compaction (its own refusal, a\nnon-zero exit, a timeout); the session is exactly as it was and `error`\nsays why.",
+                        "type": "string",
+                        "const": "failed"
+                    }
+                ]
+            },
+            "Usage": {
+                "description": "Normalized token/cost accounting. Every field is best-effort and independently\nnullable: a harness may report tokens but not dollar cost (cost is commonly\nabsent on subscription auth), or report nothing at all (plain-text harnesses).",
+                "type": "object",
+                "properties": {
+                    "cache_read_tokens": {
+                        "description": "Prompt tokens served from the provider's prompt cache (a cheap read of a\npreviously-written prefix), when the harness reports them. `None` when the\nharness does not surface cache counts — never `0` as a guess.",
+                        "type": [
+                            "integer",
+                            "null"
+                        ],
+                        "format": "uint64",
+                        "minimum": 0
+                    },
+                    "cache_write_tokens": {
+                        "description": "Prompt tokens written to the provider's prompt cache (a.k.a. cache\ncreation), when the harness reports them. `None` when not surfaced.",
+                        "type": [
+                            "integer",
+                            "null"
+                        ],
+                        "format": "uint64",
+                        "minimum": 0
+                    },
+                    "cost_usd": {
+                        "description": "Total cost in USD, when the harness reports it (often absent on\nsubscription auth, where there is no per-call dollar figure).",
+                        "type": [
+                            "number",
+                            "null"
+                        ],
+                        "format": "double"
+                    },
+                    "input_tokens": {
+                        "description": "Prompt/input tokens billed, when the harness reports them.",
+                        "type": [
+                            "integer",
+                            "null"
+                        ],
+                        "format": "uint64",
+                        "minimum": 0
+                    },
+                    "output_tokens": {
+                        "description": "Completion/output tokens billed, when the harness reports them.",
+                        "type": [
+                            "integer",
+                            "null"
+                        ],
+                        "format": "uint64",
+                        "minimum": 0
+                    }
+                },
+                "required": [
+                    "input_tokens",
+                    "output_tokens",
+                    "cache_read_tokens",
+                    "cache_write_tokens",
+                    "cost_usd"
+                ]
+            }
+        }
+    },
     "history_clear_options": {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "title": "HistoryClearOptions",