@oneharness/sdk 0.20.0 → 0.21.2

package/dist/generated/schemas.json

@@ -995,10 +995,10 @@
                 "show"
             ],
             "options": "history_lookup",
-            "output": "history_records",
+            "output": "history_show_entries",
             "stdout": "json",
             "stdin": false,
-            "rust": "oneharness_core::io::history::read_session",
+            "rust": "oneharness_core::io::history::read_session_display",
             "always": [
                 "--compact",
                 "--format",
@@ -1037,6 +1037,17 @@
                     "kind": "switch",
                     "unless": null
                 },
+                {
+                    "option": "window",
+                    "flag": "",
+                    "kind": "window",
+                    "unless": null,
+                    "window": {
+                        "days": "--days",
+                        "since": "--since",
+                        "allTime": "--all-time"
+                    }
+                },
                 {
                     "option": "historyDir",
                     "flag": "--history-dir",
@@ -1095,6 +1106,17 @@
                     "kind": "switch",
                     "unless": null
                 },
+                {
+                    "option": "window",
+                    "flag": "",
+                    "kind": "window",
+                    "unless": null,
+                    "window": {
+                        "days": "--days",
+                        "since": "--since",
+                        "allTime": "--all-time"
+                    }
+                },
                 {
                     "option": "historyDir",
                     "flag": "--history-dir",
@@ -1137,7 +1159,8 @@
                     "option": "after",
                     "flag": "--after",
                     "kind": "value",
-                    "unless": null
+                    "unless": "window",
+                    "unless_resolution": "refuse"
                 },
                 {
                     "option": "labels",
@@ -1182,6 +1205,17 @@
                     "kind": "switch",
                     "unless": null
                 },
+                {
+                    "option": "window",
+                    "flag": "",
+                    "kind": "window",
+                    "unless": null,
+                    "window": {
+                        "days": "--days",
+                        "since": "--since",
+                        "allTime": "--all-time"
+                    }
+                },
                 {
                     "option": "config",
                     "flag": "--config",
@@ -1295,6 +1329,45 @@
             ],
             "uncovered": []
         },
+        {
+            "method": "historyReindex",
+            "argv": [
+                "history",
+                "reindex"
+            ],
+            "options": "history_reindex_options",
+            "output": "history_reindex_report",
+            "stdout": "json",
+            "stdin": false,
+            "rust": "oneharness_core::io::history::reindex",
+            "always": [
+                "--compact",
+                "--format",
+                "json"
+            ],
+            "bindings": [
+                {
+                    "option": "historyDir",
+                    "flag": "--history-dir",
+                    "kind": "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": "historyPointers",
             "argv": [
@@ -1525,7 +1598,7 @@
                         "type": "string"
                     },
                     "name": {
-                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` for a\n`tool_result`, or when the harness did not name the tool.",
+                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` when\nthe harness did not name the tool. A `tool_result` carries the name of\nthe `tool_call` it answers (matched by `tool_call_id`) when that call\nwas seen earlier in the same run, else `null`.",
                         "type": [
                             "string",
                             "null"
@@ -1546,7 +1619,7 @@
                         ]
                     },
                     "status": {
-                        "description": "Terminal tool state, populated on history tool-call events.",
+                        "description": "Terminal tool state, populated on history tool-call events. On a\n`tool_result` it is the outcome the harness reported for the call:\n`failed` when the result is marked an error (a Claude Code / Qwen\n`is_error: true` block), else `completed`; `null` when the harness\nreports no error state for its results, and in a history record with\nno tool timing, which makes no tool-state claim on any event.",
                         "anyOf": [
                             {
                                 "$ref": "#/$defs/ToolCallStatus"
@@ -2606,7 +2679,7 @@
                         "type": "string"
                     },
                     "name": {
-                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` for a\n`tool_result`, or when the harness did not name the tool.",
+                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` when\nthe harness did not name the tool. A `tool_result` carries the name of\nthe `tool_call` it answers (matched by `tool_call_id`) when that call\nwas seen earlier in the same run, else `null`.",
                         "type": [
                             "string",
                             "null"
@@ -2627,7 +2700,7 @@
                         ]
                     },
                     "status": {
-                        "description": "Terminal tool state, populated on history tool-call events.",
+                        "description": "Terminal tool state, populated on history tool-call events. On a\n`tool_result` it is the outcome the harness reported for the call:\n`failed` when the result is marked an error (a Claude Code / Qwen\n`is_error: true` block), else `completed`; `null` when the harness\nreports no error state for its results, and in a history record with\nno tool timing, which makes no tool-state claim on any event.",
                         "anyOf": [
                             {
                                 "$ref": "#/$defs/ToolCallStatus"
@@ -4138,6 +4211,17 @@
                     "session": {
                         "description": "A name may accompany `last: true` — it is what the caller would have\nlooked up otherwise — but `last` takes priority, so it never selects.\nIt is therefore unconstrained: an empty name is meaningless here rather\nthan invalid, so `{\"session\": \"\", \"last\": true}` stays accepted.",
                         "type": "string"
+                    },
+                    "window": {
+                        "description": "Which dates of the index to read: the last `days` UTC days, from a\nUTC date on, or all time (every dated segment plus the legacy index an\nolder oneharness kept). Omitted, the last 7 UTC days.",
+                        "anyOf": [
+                            {
+                                "$ref": "#/$defs/HistoryWindow"
+                            },
+                            {
+                                "type": "null"
+                            }
+                        ]
                     }
                 },
                 "additionalProperties": false,
@@ -4181,12 +4265,74 @@
                         "description": "The oneharness-derived session name recorded by `run --history`. This is\nthe name that selects, so it must be non-empty.",
                         "type": "string",
                         "minLength": 1
+                    },
+                    "window": {
+                        "description": "Which dates of the index to read: the last `days` UTC days, from a\nUTC date on, or all time (every dated segment plus the legacy index an\nolder oneharness kept). Omitted, the last 7 UTC days.",
+                        "anyOf": [
+                            {
+                                "$ref": "#/$defs/HistoryWindow"
+                            },
+                            {
+                                "type": "null"
+                            }
+                        ]
                     }
                 },
                 "additionalProperties": false,
                 "required": [
                     "session"
                 ]
+            },
+            "HistoryWindow": {
+                "description": "Which dates of the index a listing reads.\n\nIt is also the one value an SDK history lookup, listing or watch takes as\nits `window`, so \"from this date\" and \"from the beginning\" cannot both be\nstated. On the wire it is externally tagged in camelCase —\n`{\"recent\": {\"days\": 3}}`, `{\"since\": \"2026-01-05\"}`, or `\"allTime\"` — and\nrenders to the CLI's `--days`, `--since` or `--all-time`.",
+                "oneOf": [
+                    {
+                        "description": "The last `days` UTC days, today included (`1` means today alone).",
+                        "type": "object",
+                        "properties": {
+                            "recent": {
+                                "type": "object",
+                                "properties": {
+                                    "days": {
+                                        "description": "How many UTC days, today included; at least one.",
+                                        "type": "integer",
+                                        "format": "uint32",
+                                        "minimum": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "days"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "recent"
+                        ]
+                    },
+                    {
+                        "description": "Every date from this one on.",
+                        "type": "object",
+                        "properties": {
+                            "since": {
+                                "type": "string",
+                                "maxLength": 10,
+                                "minLength": 10,
+                                "pattern": "^(?:[1-9][0-9]{3}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12][0-9]|3[01])|(?:0[469]|11)-(?:0[1-9]|[12][0-9]|30)|02-(?:0[1-9]|1[0-9]|2[0-8]))|(?:[1-9][0-9](?:0[48]|[2468][048]|[13579][26])|(?:1[26]|2[048]|3[26]|4[048]|5[26]|6[048]|7[26]|8[048]|9[26])00)-02-29)$"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "since"
+                        ]
+                    },
+                    {
+                        "description": "Every segment, plus the legacy index files an older core keeps.",
+                        "type": "string",
+                        "const": "allTime"
+                    }
+                ]
             }
         }
     },
@@ -4219,9 +4365,73 @@
             "variant": {
                 "description": "Narrow to one configured harness identity (`claude-code:work`).",
                 "type": "string"
+            },
+            "window": {
+                "description": "Which dates of the index to read: the last `days` UTC days, from a\nUTC date on, or all time (every dated segment plus the legacy index an\nolder oneharness kept). Omitted, the last 7 UTC days.",
+                "anyOf": [
+                    {
+                        "$ref": "#/$defs/HistoryWindow"
+                    },
+                    {
+                        "type": "null"
+                    }
+                ]
             }
         },
-        "additionalProperties": false
+        "additionalProperties": false,
+        "$defs": {
+            "HistoryWindow": {
+                "description": "Which dates of the index a listing reads.\n\nIt is also the one value an SDK history lookup, listing or watch takes as\nits `window`, so \"from this date\" and \"from the beginning\" cannot both be\nstated. On the wire it is externally tagged in camelCase —\n`{\"recent\": {\"days\": 3}}`, `{\"since\": \"2026-01-05\"}`, or `\"allTime\"` — and\nrenders to the CLI's `--days`, `--since` or `--all-time`.",
+                "oneOf": [
+                    {
+                        "description": "The last `days` UTC days, today included (`1` means today alone).",
+                        "type": "object",
+                        "properties": {
+                            "recent": {
+                                "type": "object",
+                                "properties": {
+                                    "days": {
+                                        "description": "How many UTC days, today included; at least one.",
+                                        "type": "integer",
+                                        "format": "uint32",
+                                        "minimum": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "days"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "recent"
+                        ]
+                    },
+                    {
+                        "description": "Every date from this one on.",
+                        "type": "object",
+                        "properties": {
+                            "since": {
+                                "type": "string",
+                                "maxLength": 10,
+                                "minLength": 10,
+                                "pattern": "^(?:[1-9][0-9]{3}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12][0-9]|3[01])|(?:0[469]|11)-(?:0[1-9]|[12][0-9]|30)|02-(?:0[1-9]|1[0-9]|2[0-8]))|(?:[1-9][0-9](?:0[48]|[2468][048]|[13579][26])|(?:1[26]|2[048]|3[26]|4[048]|5[26]|6[048]|7[26]|8[048]|9[26])00)-02-29)$"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "since"
+                        ]
+                    },
+                    {
+                        "description": "Every segment, plus the legacy index files an older core keeps.",
+                        "type": "string",
+                        "const": "allTime"
+                    }
+                ]
+            }
+        }
     },
     "history_watch_options": {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -4276,6 +4486,17 @@
             "variant": {
                 "description": "Narrow to one configured harness identity (`claude-code:work`).",
                 "type": "string"
+            },
+            "window": {
+                "description": "Where the watch starts when no `after` cursor is given: the beginning\nof the last `days` UTC days, of a UTC date, or of all time (the legacy\nindex an older oneharness kept included). Omitted, the current UTC\nday. Refused beside `after`, the other answer to where a watch begins.",
+                "anyOf": [
+                    {
+                        "$ref": "#/$defs/HistoryWindow"
+                    },
+                    {
+                        "type": "null"
+                    }
+                ]
             }
         },
         "additionalProperties": false,
@@ -4298,6 +4519,57 @@
                     },
                     "pattern": "^[A-Za-z0-9]"
                 }
+            },
+            "HistoryWindow": {
+                "description": "Which dates of the index a listing reads.\n\nIt is also the one value an SDK history lookup, listing or watch takes as\nits `window`, so \"from this date\" and \"from the beginning\" cannot both be\nstated. On the wire it is externally tagged in camelCase —\n`{\"recent\": {\"days\": 3}}`, `{\"since\": \"2026-01-05\"}`, or `\"allTime\"` — and\nrenders to the CLI's `--days`, `--since` or `--all-time`.",
+                "oneOf": [
+                    {
+                        "description": "The last `days` UTC days, today included (`1` means today alone).",
+                        "type": "object",
+                        "properties": {
+                            "recent": {
+                                "type": "object",
+                                "properties": {
+                                    "days": {
+                                        "description": "How many UTC days, today included; at least one.",
+                                        "type": "integer",
+                                        "format": "uint32",
+                                        "minimum": 1
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "days"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "recent"
+                        ]
+                    },
+                    {
+                        "description": "Every date from this one on.",
+                        "type": "object",
+                        "properties": {
+                            "since": {
+                                "type": "string",
+                                "maxLength": 10,
+                                "minLength": 10,
+                                "pattern": "^(?:[1-9][0-9]{3}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12][0-9]|3[01])|(?:0[469]|11)-(?:0[1-9]|[12][0-9]|30)|02-(?:0[1-9]|1[0-9]|2[0-8]))|(?:[1-9][0-9](?:0[48]|[2468][048]|[13579][26])|(?:1[26]|2[048]|3[26]|4[048]|5[26]|6[048]|7[26]|8[048]|9[26])00)-02-29)$"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "since"
+                        ]
+                    },
+                    {
+                        "description": "Every segment, plus the legacy index files an older core keeps.",
+                        "type": "string",
+                        "const": "allTime"
+                    }
+                ]
             }
         }
     },
@@ -5991,7 +6263,7 @@
                         "type": "string"
                     },
                     "name": {
-                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` for a\n`tool_result`, or when the harness did not name the tool.",
+                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` when\nthe harness did not name the tool. A `tool_result` carries the name of\nthe `tool_call` it answers (matched by `tool_call_id`) when that call\nwas seen earlier in the same run, else `null`.",
                         "type": [
                             "string",
                             "null"
@@ -6012,7 +6284,7 @@
                         ]
                     },
                     "status": {
-                        "description": "Terminal tool state, populated on history tool-call events.",
+                        "description": "Terminal tool state, populated on history tool-call events. On a\n`tool_result` it is the outcome the harness reported for the call:\n`failed` when the result is marked an error (a Claude Code / Qwen\n`is_error: true` block), else `completed`; `null` when the harness\nreports no error state for its results, and in a history record with\nno tool timing, which makes no tool-state claim on any event.",
                         "anyOf": [
                             {
                                 "$ref": "#/$defs/ToolCallStatus"
@@ -9031,7 +9303,7 @@
                         "type": "string"
                     },
                     "name": {
-                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` for a\n`tool_result`, or when the harness did not name the tool.",
+                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` when\nthe harness did not name the tool. A `tool_result` carries the name of\nthe `tool_call` it answers (matched by `tool_call_id`) when that call\nwas seen earlier in the same run, else `null`.",
                         "type": [
                             "string",
                             "null"
@@ -9052,7 +9324,7 @@
                         ]
                     },
                     "status": {
-                        "description": "Terminal tool state, populated on history tool-call events.",
+                        "description": "Terminal tool state, populated on history tool-call events. On a\n`tool_result` it is the outcome the harness reported for the call:\n`failed` when the result is marked an error (a Claude Code / Qwen\n`is_error: true` block), else `completed`; `null` when the harness\nreports no error state for its results, and in a history record with\nno tool timing, which makes no tool-state claim on any event.",
                         "anyOf": [
                             {
                                 "$ref": "#/$defs/ToolCallStatus"
@@ -9415,7 +9687,7 @@
                         "type": "string"
                     },
                     "name": {
-                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` for a\n`tool_result`, or when the harness did not name the tool.",
+                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` when\nthe harness did not name the tool. A `tool_result` carries the name of\nthe `tool_call` it answers (matched by `tool_call_id`) when that call\nwas seen earlier in the same run, else `null`.",
                         "type": [
                             "string",
                             "null"
@@ -9436,7 +9708,7 @@
                         ]
                     },
                     "status": {
-                        "description": "Terminal tool state, populated on history tool-call events.",
+                        "description": "Terminal tool state, populated on history tool-call events. On a\n`tool_result` it is the outcome the harness reported for the call:\n`failed` when the result is marked an error (a Claude Code / Qwen\n`is_error: true` block), else `completed`; `null` when the harness\nreports no error state for its results, and in a history record with\nno tool timing, which makes no tool-state claim on any event.",
                         "anyOf": [
                             {
                                 "$ref": "#/$defs/ToolCallStatus"
@@ -12556,12 +12828,12 @@
             }
         }
     },
-    "history_records": {
+    "history_show_entries": {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
-        "title": "Array_of_HistoryRecord",
+        "title": "Array_of_HistoryShowEntry",
         "type": "array",
         "items": {
-            "$ref": "#/$defs/HistoryRecord"
+            "$ref": "#/$defs/HistoryShowEntry"
         },
         "$defs": {
             "ActionEvent": {
@@ -12597,7 +12869,7 @@
                         "type": "string"
                     },
                     "name": {
-                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` for a\n`tool_result`, or when the harness did not name the tool.",
+                        "description": "Normalized tool name where knowable (e.g. `bash`, `Edit`); `null` when\nthe harness did not name the tool. A `tool_result` carries the name of\nthe `tool_call` it answers (matched by `tool_call_id`) when that call\nwas seen earlier in the same run, else `null`.",
                         "type": [
                             "string",
                             "null"
@@ -12618,7 +12890,7 @@
                         ]
                     },
                     "status": {
-                        "description": "Terminal tool state, populated on history tool-call events.",
+                        "description": "Terminal tool state, populated on history tool-call events. On a\n`tool_result` it is the outcome the harness reported for the call:\n`failed` when the result is marked an error (a Claude Code / Qwen\n`is_error: true` block), else `completed`; `null` when the harness\nreports no error state for its results, and in a history record with\nno tool timing, which makes no tool-state claim on any event.",
                         "anyOf": [
                             {
                                 "$ref": "#/$defs/ToolCallStatus"
@@ -15429,6 +15701,61 @@
                     }
                 ]
             },
+            "HistoryShowEntry": {
+                "description": "One entry of `history show`'s answer: a finished run's record, or a run still\nin flight.",
+                "anyOf": [
+                    {
+                        "description": "A run whose closing record has landed.",
+                        "$ref": "#/$defs/HistoryRecord"
+                    },
+                    {
+                        "description": "A run that has published events but no closing record yet.",
+                        "$ref": "#/$defs/IncompleteHistoryRun"
+                    }
+                ]
+            },
+            "IncompleteHistoryRun": {
+                "description": "A run `history show` reads before its closing record has landed: the events\nits event lines have published so far, under the run they belong to. It is a\ndisplay entry, never a store line: once the run's closing record lands the\nsame run is shown as a [`HistoryRecord`] instead. It exists only because an\nevent line was read, so it always carries at least one event.",
+                "type": "object",
+                "properties": {
+                    "events": {
+                        "description": "The events published so far, in `index` order; never empty.",
+                        "type": "array",
+                        "items": {
+                            "$ref": "#/$defs/ActionEvent"
+                        },
+                        "minItems": 1
+                    },
+                    "harness": {
+                        "description": "The harness the event lines name.",
+                        "type": "string"
+                    },
+                    "run_id": {
+                        "description": "The id the run's closing record will carry as its `history_id`.",
+                        "type": "string",
+                        "maxLength": 36,
+                        "minLength": 36,
+                        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+                    },
+                    "type": {
+                        "description": "Always `incomplete`: what tells this entry apart from a record.",
+                        "$ref": "#/$defs/IncompleteRunType"
+                    }
+                },
+                "required": [
+                    "type",
+                    "run_id",
+                    "harness",
+                    "events"
+                ]
+            },
+            "IncompleteRunType": {
+                "description": "The discriminator of an [`IncompleteHistoryRun`].",
+                "type": "string",
+                "enum": [
+                    "incomplete"
+                ]
+            },
             "PermissionMode": {
                 "description": "The unified approval mode, from least to most autonomy. A harness may not\nsupport every value (see [`crate::domain::harness::HarnessSpec::mode`]); the\ncommand layer refuses an unsupported one before spawning, never silently\ndowngrading it.",
                 "oneOf": [
@@ -18003,6 +18330,113 @@
             }
         }
     },
+    "history_reindex_options": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "title": "HistoryReindexOptions",
+        "description": "Options accepted by the language SDKs' `historyReindex()`.",
+        "type": "object",
+        "properties": {
+            "config": {
+                "description": "Load configuration from exactly these files, in order, skipping\nuser/project discovery; each later file overrides the earlier ones.",
+                "type": "array",
+                "items": {
+                    "type": "string"
+                }
+            },
+            "historyDir": {
+                "type": "string"
+            },
+            "noConfig": {
+                "description": "Ignore every configuration file and `ONEHARNESS_*` override. `true`\nbeside a non-empty `config` is refused before anything runs.",
+                "type": "boolean"
+            }
+        },
+        "additionalProperties": false
+    },
+    "history_reindex_report": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "title": "HistoryReindexReport",
+        "description": "The `oneharness history reindex` output contract.",
+        "type": "object",
+        "properties": {
+            "entries_added": {
+                "description": "The sum of `segments[].added`.",
+                "type": "integer",
+                "format": "uint",
+                "minimum": 0
+            },
+            "files_read": {
+                "description": "How many session files were read.",
+                "type": "integer",
+                "format": "uint",
+                "minimum": 0
+            },
+            "segments": {
+                "description": "One row per segment this run appended to, in file-name order; a\nsegment that already held every entry is not listed.",
+                "type": "array",
+                "items": {
+                    "$ref": "#/$defs/SegmentReindexSummary"
+                }
+            },
+            "unreadable": {
+                "description": "Every session file (or project directory) that could not be read,\nwith why. The rest are indexed regardless.",
+                "type": "array",
+                "items": {
+                    "$ref": "#/$defs/UnreadableSessionFile"
+                }
+            }
+        },
+        "required": [
+            "segments",
+            "entries_added",
+            "files_read",
+            "unreadable"
+        ],
+        "$defs": {
+            "SegmentReindexSummary": {
+                "description": "What [`reindex`] appended to one segment.",
+                "type": "object",
+                "properties": {
+                    "added": {
+                        "description": "How many entries this run appended to it.",
+                        "type": "integer",
+                        "format": "uint",
+                        "minimum": 0
+                    },
+                    "path": {
+                        "description": "The segment's path, as a display string.",
+                        "type": "string"
+                    },
+                    "segment": {
+                        "description": "The segment's file name (`runs-YYYY-MM-DD.ndjson` or\n`events-YYYY-MM-DD.ndjson`).",
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "segment",
+                    "path",
+                    "added"
+                ]
+            },
+            "UnreadableSessionFile": {
+                "description": "A session file [`reindex`] could not read.",
+                "type": "object",
+                "properties": {
+                    "error": {
+                        "description": "Why it could not be read, as the operating system said it.",
+                        "type": "string"
+                    },
+                    "path": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "path",
+                    "error"
+                ]
+            }
+        }
+    },
     "history_pointers_options": {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "title": "HistoryPointersOptions",