@oneharness/sdk 0.11.4 → 0.12.1

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-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";
 export type ToolCallStatus = "completed" | "failed" | "timeout" | "interrupted";
 /**
  * How a normalized tool interval was obtained.
@@ -74,7 +74,7 @@ export type TimingSource = "provider_measured" | "stdout_observed";
  * 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";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch";
 /**
  * How a harness emits its result, which decides how `text` is extracted.
  *
@@ -308,7 +308,8 @@ export interface FallbackReport {
      * The candidates fallen through because they could not run the task at all,
      * in priority order, each with why (`not-installed`, `spawn-error`, `auth`,
      * `quota`, `session-not-found`, `untrusted-directory`, `input-too-large`,
-     * and — on a model fan-out — `model-not-found` / `rate-limit`; see
+     * `model-mismatch`, and — on a model fan-out — `model-not-found` /
+     * `rate-limit`; see
      * [`crate::domain::fallback::startup_failure_reason`]).
      */
     fell_through: FallThrough[];
@@ -323,13 +324,16 @@ export interface FallbackReport {
      * [`RunResult::work`] read [`RunWork::None`] on a failure no classifier
      * recognized.
      *
-     * The chain still stops there, deliberately: re-running a task that may
-     * genuinely have failed for free would burn the next identity's quota on
-     * the same failure, which is worse than stopping (see
+     * The chain still stops there, deliberately — decided, not inherited:
+     * empty accounting is the absence of work evidence, not proof nothing was
+     * spent, so handing the candidate on could bill a task twice (the decision
+     * and its reasoning are stated once, at
      * [`crate::domain::fallback::startup_failure_reason`]). What this flag adds
      * is the *attribution* — without it a candidate that never got started reads
      * in the report exactly like one that tried the task and failed it, and the
-     * remaining candidates look untried for a reason nobody can name.
+     * remaining candidates look untried for a reason nobody can name — and the
+     * failure summary carries the candidate's own words beside it, so the
+     * reader left holding that one line can act on the cause.
      *
      * `false` whenever `ran` is `null` (no candidate ran at all — every one is
      * in `fell_through`, each with its reason).
@@ -415,7 +419,8 @@ export interface RunResult {
      * Best-effort failure reason; `null` when unclassified. Distinct from
      * `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`), and `tool_deferred` — a run that exited
+     * `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`
@@ -445,6 +450,17 @@ export interface RunResult {
      * without parsing the argv.
      */
     model: string | null;
+    /**
+     * The model the harness **itself** reported the conversation would run
+     * under, read off its own protocol before any token was spent — for codex
+     * over `app-server`, `result.model` of the `thread/start` / `thread/resume`
+     * response. `null` on every path that reports none, which today is every
+     * path but codex's app-server. Never inferred and never copied from
+     * `model`: where both are set they are the requested model and the served
+     * one, and a difference between them is exactly the `model_mismatch`
+     * refusal, which this field then names the other half of.
+     */
+    observed_model: string | null;
     output_format: OutputFormat;
     /**
      * The prompt this result ran, set only on a **batch** run (one harness

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";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
     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" | undefined;
+    schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
     [k: string]: unknown;
 } & ({
     status?: "nonzero" | "timeout" | "cancelled" | "spawn-error" | "skipped" | undefined;
@@ -39,27 +39,40 @@ export type HistoryLine = ({
     work?: null | undefined;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.7" | undefined;
+    schema_version?: "1.7" | "1.8" | undefined;
     status?: "nonzero" | "timeout" | "cancelled" | undefined;
     work: "done" | "none";
     [k: string]: unknown;
+}) & ({
+    observed_model?: null | undefined;
+    [k: string]: unknown;
+} | {
+    observed_model: string;
+    schema_version?: "1.8" | 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" | undefined;
+    schema_version?: "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | undefined;
     [k: string]: unknown;
 }) & (({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch" | null;
+    [k: string]: unknown;
+} | {
+    schema_version?: "1.5" | "1.6" | "1.7" | "1.8" | undefined;
+    [k: string]: unknown;
+}) & ({
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "model_mismatch" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.5" | "1.6" | "1.7" | undefined;
+    schema_version?: "1.6" | "1.7" | "1.8" | undefined;
     [k: string]: unknown;
 }) & ({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | null;
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.6" | "1.7" | undefined;
+    schema_version?: "1.8" | undefined;
     [k: string]: unknown;
 })) & ({
     duration_ms: number;
@@ -78,11 +91,16 @@ export type HistoryLine = ({
     model: string | null;
     model_ms: number;
     name: string;
+    /**
+     * The model the harness itself reported it would run under (see
+     * [`HistoryRecord::observed_model`]). Omitted on the wire when absent.
+     */
+    observed_model?: string | null | undefined;
     observed_tool_ms?: never | undefined;
     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";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
     session: string;
     session_id: string | null;
     started_at: string;
@@ -118,11 +136,16 @@ export type HistoryLine = ({
     model: string | null;
     model_ms: number;
     name: string;
+    /**
+     * The model the harness itself reported it would run under (see
+     * [`HistoryRecord::observed_model`]). Omitted on the wire when absent.
+     */
+    observed_model?: string | null | undefined;
     observed_tool_ms?: never | undefined;
     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";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
     session: string;
     session_id: string | null;
     started_at: string;
@@ -158,11 +181,16 @@ export type HistoryLine = ({
     model: string | null;
     model_ms?: never | undefined;
     name: string;
+    /**
+     * The model the harness itself reported it would run under (see
+     * [`HistoryRecord::observed_model`]). Omitted on the wire when absent.
+     */
+    observed_model?: string | null | undefined;
     observed_tool_ms: number;
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
     session: string;
     session_id: string | null;
     started_at?: never | undefined;
@@ -198,11 +226,16 @@ export type HistoryLine = ({
     model: string | null;
     model_ms?: never | undefined;
     name: string;
+    /**
+     * The model the harness itself reported it would run under (see
+     * [`HistoryRecord::observed_model`]). Omitted on the wire when absent.
+     */
+    observed_model?: string | null | undefined;
     observed_tool_ms?: never | undefined;
     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";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
     session: string;
     session_id: string | null;
     started_at?: never | undefined;
@@ -238,11 +271,16 @@ export type HistoryLine = ({
     model: string | null;
     model_ms?: never | undefined;
     name: string;
+    /**
+     * The model the harness itself reported it would run under (see
+     * [`HistoryRecord::observed_model`]). Omitted on the wire when absent.
+     */
+    observed_model?: string | null | undefined;
     observed_tool_ms?: never | undefined;
     permission_mode: PermissionMode;
     project: string;
     prompt: string;
-    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7";
+    schema_version: "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
     session: string;
     session_id: string | null;
     started_at: string;
@@ -278,11 +316,16 @@ export type HistoryLine = ({
     model: string | null;
     model_ms?: never | undefined;
     name: string;
+    /**
+     * The model the harness itself reported it would run under (see
+     * [`HistoryRecord::observed_model`]). Omitted on the wire when absent.
+     */
+    observed_model?: string | null | undefined;
     observed_tool_ms?: never | undefined;
     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";
+    schema_version: "1.0" | "1.1" | "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8";
     session: string;
     session_id: string | null;
     started_at?: never | undefined;
@@ -318,7 +361,7 @@ export type TimingSource = "provider_measured" | "stdout_observed";
  * 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";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large" | "model_mismatch";
 /**
  * The unified approval mode, from least to most autonomy. A harness may not
  * support every value (see [`crate::domain::harness::HarnessSpec::mode`]); the