@oneharness/sdk 0.20.0 → 0.21.1

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": [
@@ -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"
+                    }
+                ]
             }
         }
     },
@@ -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": {
@@ -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",

package/dist/generated/zod.d.ts

@@ -11,12 +11,14 @@ import type { HistoryClearDryRun, HistoryClearRemoved, HistoryClearReport } from
 import type { HistoryLine } from "./history-line.js";
 import type { HistoryList, HistorySessionSummary } from "./history-list.js";
 import type { HistoryListOptions } from "./history-list-options.js";
-import type { HistoryLookup, HistoryLookupByLast, HistoryLookupBySession } from "./history-lookup.js";
+import type { HistoryLookup, HistoryLookupByLast, HistoryLookupBySession, HistoryWindow } from "./history-lookup.js";
 import type { HistoryMigrateOptions } from "./history-migrate-options.js";
 import type { HistoryMigrateReport, MigrationSummary } from "./history-migrate-report.js";
 import type { HistoryPointer, HistoryPointers } from "./history-pointers.js";
 import type { HistoryPointersOptions } from "./history-pointers-options.js";
-import type { HistoryRecords } from "./history-records.js";
+import type { HistoryReindexOptions } from "./history-reindex-options.js";
+import type { HistoryReindexReport, SegmentReindexSummary, UnreadableSessionFile } from "./history-reindex-report.js";
+import type { HistoryShowEntries, HistoryShowEntry, IncompleteHistoryRun } from "./history-show-entries.js";
 import type { HistoryEventLine, HistoryStreamEnvelope } from "./history-stream-envelope.js";
 import type { HistoryWatchOptions } from "./history-watch-options.js";
 import type { InitOptions } from "./init-options.js";
@@ -34,6 +36,7 @@ export type AbsolutePath = ControlReport["socket"];
 export type BatchStrategy = BatchReport["strategy"];
 export type ControlShape = ControlReport["mechanism"];
 export type IdentitySelector = UsageIdentity["selector"];
+export type IncompleteRunType = IncompleteHistoryRun["type"];
 export type ModeHeadless = ModeInfo["headless"];
 export type SessionPhase = SessionReport["phase"];
 export type UsedPercent = number;
@@ -89,13 +92,19 @@ export declare const HistoryPointerSchema: z.ZodType<HistoryPointer>;
 export declare const HistoryPointersSchema: z.ZodType<HistoryPointers>;
 export declare const HistoryPointersOptionsSchema: z.ZodType<HistoryPointersOptions>;
 export declare const HistoryRecordSchema: z.ZodType<HistoryRecord>;
-export declare const HistoryRecordsSchema: z.ZodType<HistoryRecords>;
+export declare const HistoryReindexOptionsSchema: z.ZodType<HistoryReindexOptions>;
+export declare const HistoryReindexReportSchema: z.ZodType<HistoryReindexReport>;
 export declare const HistorySessionSummarySchema: z.ZodType<HistorySessionSummary>;
+export declare const HistoryShowEntriesSchema: z.ZodType<HistoryShowEntries>;
+export declare const HistoryShowEntrySchema: z.ZodType<HistoryShowEntry>;
 export declare const HistoryStreamEnvelopeSchema: z.ZodType<HistoryStreamEnvelope>;
 export declare const HistoryWatchOptionsSchema: z.ZodType<HistoryWatchOptions>;
+export declare const HistoryWindowSchema: z.ZodType<HistoryWindow>;
 export declare const HookEntrySchema: z.ZodType<HookEntry>;
 export declare const HookFileResultSchema: z.ZodType<HookFileResult>;
 export declare const IdentitySelectorSchema: z.ZodType<IdentitySelector>;
+export declare const IncompleteHistoryRunSchema: z.ZodType<IncompleteHistoryRun>;
+export declare const IncompleteRunTypeSchema: z.ZodType<IncompleteRunType>;
 export declare const InitOptionsSchema: z.ZodType<InitOptions>;
 export declare const InterruptOptionsSchema: z.ZodType<InterruptOptions>;
 export declare const InterruptResponseSchema: z.ZodType<InterruptResponse>;
@@ -117,6 +126,7 @@ export declare const RunReportSchema: z.ZodType<RunReport>;
 export declare const RunResultSchema: z.ZodType<RunResult>;
 export declare const RunStreamEnvelopeSchema: z.ZodType<RunStreamEnvelope>;
 export declare const RunWorkSchema: z.ZodType<RunWork>;
+export declare const SegmentReindexSummarySchema: z.ZodType<SegmentReindexSummary>;
 export declare const SessionPhaseSchema: z.ZodType<SessionPhase>;
 export declare const SessionReportSchema: z.ZodType<SessionReport>;
 export declare const StatusSchema: z.ZodType<Status>;
@@ -129,6 +139,7 @@ export declare const ToolCallStatusSchema: z.ZodType<ToolCallStatus>;
 export declare const UnavailableReasonSchema: z.ZodType<UnavailableReason>;
 export declare const UnknownReasonSchema: z.ZodType<UnknownReason>;
 export declare const UnmappedRuleSchema: z.ZodType<UnmappedRule>;
+export declare const UnreadableSessionFileSchema: z.ZodType<UnreadableSessionFile>;
 export declare const UsageSchema: z.ZodType<Usage>;
 export declare const UsageAvailabilitySchema: z.ZodType<UsageAvailability>;
 export declare const UsageIdentitySchema: z.ZodType<UsageIdentity>;