@oneharness/sdk 0.12.1 → 0.13.0

package/dist/generated/capabilities.d.ts

@@ -158,6 +158,11 @@ export declare const CAPABILITIES: {
             readonly flag: "--schema-max-retries";
             readonly kind: "value";
             readonly unless: null;
+        }, {
+            readonly option: "serverOverloadedMaxRetries";
+            readonly flag: "--server-overloaded-max-retries";
+            readonly kind: "value";
+            readonly unless: null;
         }, {
             readonly option: "outputDir";
             readonly flag: "--output-dir";
@@ -393,6 +398,11 @@ export declare const CAPABILITIES: {
             readonly flag: "--schema-max-retries";
             readonly kind: "value";
             readonly unless: null;
+        }, {
+            readonly option: "serverOverloadedMaxRetries";
+            readonly flag: "--server-overloaded-max-retries";
+            readonly kind: "value";
+            readonly unless: null;
         }, {
             readonly option: "outputDir";
             readonly flag: "--output-dir";

package/dist/generated/capabilities.js

@@ -143,6 +143,12 @@ export const CAPABILITIES = {
                 kind: "value",
                 unless: null,
             },
+            {
+                option: "serverOverloadedMaxRetries",
+                flag: "--server-overloaded-max-retries",
+                kind: "value",
+                unless: null,
+            },
             {
                 option: "outputDir",
                 flag: "--output-dir",
@@ -425,6 +431,12 @@ export const CAPABILITIES = {
                 kind: "value",
                 unless: null,
             },
+            {
+                option: "serverOverloadedMaxRetries",
+                flag: "--server-overloaded-max-retries",
+                kind: "value",
+                unless: null,
+            },
             {
                 option: "outputDir",
                 flag: "--output-dir",

package/dist/generated/config-report.d.ts

@@ -68,6 +68,7 @@ export interface ConfigReport {
     schema_file: Field3;
     schema_max_retries: Field7;
     schema_version: string;
+    server_overloaded_max_retries: Field7;
     stream: Field1;
     system: Field3;
     timeout: Field5;

package/dist/generated/contracts.d.ts

@@ -57,7 +57,7 @@ export type ControlVerb = "interrupt";
  * new variant is a report `schema_version` bump like any other enum value, since
  * a consumer matching exhaustively learns of it only from the version.
  */
-export type FallThroughReason = "not-installed" | "spawn-error" | "auth" | "quota" | "session-not-found" | "untrusted-directory" | "input-too-large" | "model-mismatch" | "model-not-found" | "rate-limit";
+export type FallThroughReason = "not-installed" | "spawn-error" | "auth" | "quota" | "session-not-found" | "untrusted-directory" | "input-too-large" | "model-mismatch" | "model-not-found" | "rate-limit" | "server-overloaded";
 export type ToolCallStatus = "completed" | "failed" | "timeout" | "interrupted";
 /**
  * How a normalized tool interval was obtained.
@@ -68,13 +68,13 @@ export type TimingSource = "provider_measured" | "stdout_observed";
  * harness's output. It is the single source for the `failure_kind` contract
  * value: serialized as the snake_case token a consumer reads in the report
  * (`auth`, `rate_limit`, `model_not_found`, `quota`, `session_not_found`,
- * `tool_deferred`), so the wire shape is unchanged — modeling it as an enum
+ * `tool_deferred`, `server_overloaded`), so the wire shape is unchanged — modeling it as an enum
  * keeps a misspelled or invalid kind unrepresentable and gives every
  * producer/consumer (classifier, `is_failure`, the fallback fall-through rule,
  * the report, history) one definition to share instead of scattered string
  * literals.
  */
-export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | "server_overloaded";
 /**
  * How a harness emits its result, which decides how `text` is extracted.
  *
@@ -127,8 +127,9 @@ export type ExecutionTelemetry = {
  *
  * - **Tool events.** A recorded tool call is the harness acting on the task.
  * - **Usage accounting.** [`Usage::reports_billed_work`][billed] — the same definition
- *   `signals::record_reports_work` classifies a raw harness record with, so the
- *   two readings of "billed" are one contract with one implementation.
+ *   `signals::record_work_evidence` reads a raw harness record with, and it answers
+ *   in this same type, so the two readings of "billed" are one contract with one
+ *   implementation.
  *
  * It is also a **published reading**, not only an internal one: a run that
  * failed with nothing to classify carries it as [`RunResult::work`] and in its
@@ -420,11 +421,11 @@ export interface RunResult {
      * `status`, which records oneharness's relationship to the process. Two
      * families: coarse reasons for a non-zero run (`auth`, `rate_limit`,
      * `model_not_found`, `quota`, `session_not_found`, `untrusted_directory`,
-     * `input_too_large`, `model_mismatch`), and `tool_deferred` — a run that exited
-     * *cleanly* but only deferred a builtin tool call instead of executing it
-     * (Claude Code bridge/managed deployments), so it did no useful work. The
-     * deferred case is the only `failure_kind` that can appear on a `status: ok`
-     * run, and it also marks the run as failed for exit-code purposes.
+     * `input_too_large`, `model_mismatch`, `server_overloaded`), and
+     * `tool_deferred` — a run that only deferred a builtin tool call instead of
+     * executing it (Claude Code bridge/managed deployments), so it did no useful
+     * work. Both `tool_deferred` and `server_overloaded` can accompany a clean
+     * transport exit; either still marks the run as failed for exit-code purposes.
      * Serialized as its snake_case token (see [`FailureKind`]).
      */
     failure_kind: FailureKind | null;

package/dist/generated/history-line.d.ts

@@ -6,7 +6,7 @@ export type HistoryLine = ({
     harness: string;
     harness_id?: string | null | undefined;
     run_id: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     type: "event";
     variant?: string | null | undefined;
     [k: string]: unknown;
@@ -27,7 +27,7 @@ export type HistoryLine = ({
     [k: string]: unknown;
 } | ({
     error: string;
-    schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 } & ({
     status?: "nonzero" | "timeout" | "cancelled" | "spawn-error" | "skipped" | undefined;
@@ -39,7 +39,7 @@ export type HistoryLine = ({
     work?: null | undefined;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.7" | "1.8" | undefined;
+    schema_version?: "1.7" | "1.8" | "1.9" | undefined;
     status?: "nonzero" | "timeout" | "cancelled" | undefined;
     work: "done" | "none";
     [k: string]: unknown;
@@ -48,31 +48,37 @@ export type HistoryLine = ({
     [k: string]: unknown;
 } | {
     observed_model: string;
-    schema_version?: "1.8" | undefined;
+    schema_version?: "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & ({
     status?: "ok" | "nonzero" | "timeout" | "spawn-error" | "skipped" | "planned" | undefined;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & (({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | "server_overloaded" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & ({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "model_mismatch" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "model_mismatch" | "server_overloaded" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & ({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "server_overloaded" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.8" | undefined;
+    schema_version?: "1.8" | "1.9" | undefined;
+    [k: string]: unknown;
+}) & ({
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | null;
+    [k: string]: unknown;
+} | {
+    schema_version?: "1.9" | undefined;
     [k: string]: unknown;
 })) & ({
     duration_ms: number;
@@ -100,7 +106,7 @@ export type HistoryLine = ({
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     session: string;
     session_id: string | null;
     started_at: string;
@@ -145,7 +151,7 @@ export type HistoryLine = ({
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     session: string;
     session_id: string | null;
     started_at: string;
@@ -190,7 +196,7 @@ export type HistoryLine = ({
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     session: string;
     session_id: string | null;
     started_at?: never | undefined;
@@ -235,7 +241,7 @@ export type HistoryLine = ({
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     session: string;
     session_id: string | null;
     started_at?: never | undefined;
@@ -280,7 +286,7 @@ export type HistoryLine = ({
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     session: string;
     session_id: string | null;
     started_at: string;
@@ -325,7 +331,7 @@ export type HistoryLine = ({
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     session: string;
     session_id: string | null;
     started_at?: never | undefined;
@@ -355,13 +361,13 @@ export type TimingSource = "provider_measured" | "stdout_observed";
  * harness's output. It is the single source for the `failure_kind` contract
  * value: serialized as the snake_case token a consumer reads in the report
  * (`auth`, `rate_limit`, `model_not_found`, `quota`, `session_not_found`,
- * `tool_deferred`), so the wire shape is unchanged — modeling it as an enum
+ * `tool_deferred`, `server_overloaded`), so the wire shape is unchanged — modeling it as an enum
  * keeps a misspelled or invalid kind unrepresentable and gives every
  * producer/consumer (classifier, `is_failure`, the fallback fall-through rule,
  * the report, history) one definition to share instead of scattered string
  * literals.
  */
-export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | "server_overloaded";
 /**
  * The unified approval mode, from least to most autonomy. A harness may not
  * support every value (see [`crate::domain::harness::HarnessSpec::mode`]); the
@@ -377,8 +383,9 @@ export type PermissionMode = "read-only" | "plan" | "default" | "edit" | "auto"
  *
  * - **Tool events.** A recorded tool call is the harness acting on the task.
  * - **Usage accounting.** [`Usage::reports_billed_work`][billed] — the same definition
- *   `signals::record_reports_work` classifies a raw harness record with, so the
- *   two readings of "billed" are one contract with one implementation.
+ *   `signals::record_work_evidence` reads a raw harness record with, and it answers
+ *   in this same type, so the two readings of "billed" are one contract with one
+ *   implementation.
  *
  * It is also a **published reading**, not only an internal one: a run that
  * failed with nothing to classify carries it as [`RunResult::work`] and in its

package/dist/generated/history-records.d.ts

@@ -112,7 +112,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -412,7 +412,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -539,7 +539,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -666,7 +666,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -793,7 +793,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -1260,13 +1260,13 @@ export type TimingSource = "provider_measured" | "stdout_observed";
  * harness's output. It is the single source for the `failure_kind` contract
  * value: serialized as the snake_case token a consumer reads in the report
  * (`auth`, `rate_limit`, `model_not_found`, `quota`, `session_not_found`,
- * `tool_deferred`), so the wire shape is unchanged — modeling it as an enum
+ * `tool_deferred`, `server_overloaded`), so the wire shape is unchanged — modeling it as an enum
  * keeps a misspelled or invalid kind unrepresentable and gives every
  * producer/consumer (classifier, `is_failure`, the fallback fall-through rule,
  * the report, history) one definition to share instead of scattered string
  * literals.
  */
-export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | "server_overloaded";
 /**
  * The outcome of attempting to run one harness.
  */
@@ -1279,8 +1279,9 @@ export type Status = "ok" | "nonzero" | "timeout" | "cancelled" | "spawn-error"
  *
  * - **Tool events.** A recorded tool call is the harness acting on the task.
  * - **Usage accounting.** [`Usage::reports_billed_work`][billed] — the same definition
- *   `signals::record_reports_work` classifies a raw harness record with, so the
- *   two readings of "billed" are one contract with one implementation.
+ *   `signals::record_work_evidence` reads a raw harness record with, and it answers
+ *   in this same type, so the two readings of "billed" are one contract with one
+ *   implementation.
  *
  * It is also a **published reading**, not only an internal one: a run that
  * failed with nothing to classify carries it as [`RunResult::work`] and in its
@@ -1296,7 +1297,7 @@ export type HistoryRecords = (({
     [k: string]: unknown;
 } | ({
     error: string;
-    schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 } & ({
     status?: "nonzero" | "timeout" | "cancelled" | "spawn-error" | "skipped" | undefined;
@@ -1308,7 +1309,7 @@ export type HistoryRecords = (({
     work?: null | undefined;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.7" | "1.8" | undefined;
+    schema_version?: "1.7" | "1.8" | "1.9" | undefined;
     status?: "nonzero" | "timeout" | "cancelled" | undefined;
     work: "done" | "none";
     [k: string]: unknown;
@@ -1317,31 +1318,37 @@ export type HistoryRecords = (({
     [k: string]: unknown;
 } | {
     observed_model: string;
-    schema_version?: "1.8" | undefined;
+    schema_version?: "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & ({
     status?: "ok" | "nonzero" | "timeout" | "spawn-error" | "skipped" | "planned" | undefined;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & (({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | "server_overloaded" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & ({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "model_mismatch" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "model_mismatch" | "server_overloaded" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.6" | "1.7" | "1.8" | undefined;
+    schema_version?: "1.6" | "1.7" | "1.8" | "1.9" | undefined;
     [k: string]: unknown;
 }) & ({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "server_overloaded" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.8" | undefined;
+    schema_version?: "1.8" | "1.9" | undefined;
+    [k: string]: unknown;
+}) & ({
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | null;
+    [k: string]: unknown;
+} | {
+    schema_version?: "1.9" | undefined;
     [k: string]: unknown;
 })) & HistoryRecord)[];
 /**

package/dist/generated/history-stream-envelope.d.ts

@@ -14,7 +14,7 @@ export type HistoryStreamEnvelope = {
         [k: string]: unknown;
     } | ({
         error: string;
-        schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+        schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
         [k: string]: unknown;
     } & ({
         status?: "nonzero" | "timeout" | "cancelled" | "spawn-error" | "skipped" | undefined;
@@ -26,7 +26,7 @@ export type HistoryStreamEnvelope = {
         work?: null | undefined;
         [k: string]: unknown;
     } | {
-        schema_version?: "1.7" | "1.8" | undefined;
+        schema_version?: "1.7" | "1.8" | "1.9" | undefined;
         status?: "nonzero" | "timeout" | "cancelled" | undefined;
         work: "done" | "none";
         [k: string]: unknown;
@@ -35,31 +35,37 @@ export type HistoryStreamEnvelope = {
         [k: string]: unknown;
     } | {
         observed_model: string;
-        schema_version?: "1.8" | undefined;
+        schema_version?: "1.8" | "1.9" | undefined;
         [k: string]: unknown;
     }) & ({
         status?: "ok" | "nonzero" | "timeout" | "spawn-error" | "skipped" | "planned" | undefined;
         [k: string]: unknown;
     } | {
-        schema_version?: "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+        schema_version?: "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
         [k: string]: unknown;
     }) & (({
-        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | null;
+        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | "server_overloaded" | null;
         [k: string]: unknown;
     } | {
-        schema_version?: "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+        schema_version?: "1.5" | "1.6" | "1.7" | "1.8" | "1.9" | undefined;
         [k: string]: unknown;
     }) & ({
-        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "model_mismatch" | null;
+        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "model_mismatch" | "server_overloaded" | null;
         [k: string]: unknown;
     } | {
-        schema_version?: "1.6" | "1.7" | "1.8" | undefined;
+        schema_version?: "1.6" | "1.7" | "1.8" | "1.9" | undefined;
         [k: string]: unknown;
     }) & ({
-        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | null;
+        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "server_overloaded" | null;
         [k: string]: unknown;
     } | {
-        schema_version?: "1.8" | undefined;
+        schema_version?: "1.8" | "1.9" | undefined;
+        [k: string]: unknown;
+    }) & ({
+        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | null;
+        [k: string]: unknown;
+    } | {
+        schema_version?: "1.9" | undefined;
         [k: string]: unknown;
     })) & HistoryRecord;
     type: "record";
@@ -183,7 +189,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -483,7 +489,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -610,7 +616,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -737,7 +743,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -864,7 +870,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -1331,13 +1337,13 @@ export type TimingSource = "provider_measured" | "stdout_observed";
  * harness's output. It is the single source for the `failure_kind` contract
  * value: serialized as the snake_case token a consumer reads in the report
  * (`auth`, `rate_limit`, `model_not_found`, `quota`, `session_not_found`,
- * `tool_deferred`), so the wire shape is unchanged — modeling it as an enum
+ * `tool_deferred`, `server_overloaded`), so the wire shape is unchanged — modeling it as an enum
  * keeps a misspelled or invalid kind unrepresentable and gives every
  * producer/consumer (classifier, `is_failure`, the fallback fall-through rule,
  * the report, history) one definition to share instead of scattered string
  * literals.
  */
-export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | "server_overloaded";
 /**
  * The outcome of attempting to run one harness.
  */
@@ -1350,8 +1356,9 @@ export type Status = "ok" | "nonzero" | "timeout" | "cancelled" | "spawn-error"
  *
  * - **Tool events.** A recorded tool call is the harness acting on the task.
  * - **Usage accounting.** [`Usage::reports_billed_work`][billed] — the same definition
- *   `signals::record_reports_work` classifies a raw harness record with, so the
- *   two readings of "billed" are one contract with one implementation.
+ *   `signals::record_work_evidence` reads a raw harness record with, and it answers
+ *   in this same type, so the two readings of "billed" are one contract with one
+ *   implementation.
  *
  * It is also a **published reading**, not only an internal one: a run that
  * failed with nothing to classify carries it as [`RunResult::work`] and in its
@@ -1367,7 +1374,7 @@ export type HistoryEventLine = {
     harness: string;
     harness_id?: string | null | undefined;
     run_id: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
     variant?: string | null | undefined;
     [k: string]: unknown;
 } | {