@oneharness/sdk 0.8.0 → 0.10.0

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" | undefined;
+        schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | undefined;
         [k: string]: unknown;
     } & ({
         status?: "nonzero" | "timeout" | "cancelled" | "spawn-error" | "skipped" | undefined;
@@ -26,15 +26,21 @@ export type HistoryStreamEnvelope = {
         status?: "ok" | "nonzero" | "timeout" | "spawn-error" | "skipped" | "planned" | undefined;
         [k: string]: unknown;
     } | {
-        schema_version?: "1.4" | "1.5" | undefined;
+        schema_version?: "1.4" | "1.5" | "1.6" | undefined;
+        [k: string]: unknown;
+    }) & (({
+        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | null;
+        [k: string]: unknown;
+    } | {
+        schema_version?: "1.5" | "1.6" | undefined;
         [k: string]: unknown;
     }) & ({
-        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | null | undefined;
+        failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | null;
         [k: string]: unknown;
     } | {
-        schema_version?: "1.5" | undefined;
+        schema_version?: "1.6" | undefined;
         [k: string]: unknown;
-    }) & HistoryRecord;
+    })) & HistoryRecord;
     type: "record";
     [k: string]: unknown;
 } | {
@@ -137,7 +143,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -367,7 +373,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -459,7 +465,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -551,7 +557,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -643,7 +649,7 @@ export type HistoryRecord = {
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.3" | "1.4" | "1.5";
+    schema_version: "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -995,7 +1001,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";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large";
 /**
  * The outcome of attempting to run one harness.
  */
@@ -1005,7 +1011,7 @@ export type HistoryEventLine = {
     harness: string;
     harness_id?: string | null | undefined;
     run_id: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     variant?: string | null | undefined;
     [k: string]: unknown;
 } | {

package/dist/generated/history.d.ts

@@ -8,7 +8,7 @@ export type HistoryRecord = ({
     [k: string]: unknown;
 } | ({
     error: string;
-    schema_version?: "1.3" | "1.4" | "1.5" | undefined;
+    schema_version?: "1.3" | "1.4" | "1.5" | "1.6" | undefined;
     [k: string]: unknown;
 } & ({
     status?: "nonzero" | "timeout" | "cancelled" | "spawn-error" | "skipped" | undefined;
@@ -20,15 +20,21 @@ export type HistoryRecord = ({
     status?: "ok" | "nonzero" | "timeout" | "spawn-error" | "skipped" | "planned" | undefined;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.4" | "1.5" | undefined;
+    schema_version?: "1.4" | "1.5" | "1.6" | undefined;
     [k: string]: unknown;
-}) & ({
-    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | null | undefined;
+}) & (({
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "tool_deferred" | "untrusted_directory" | "input_too_large" | null;
     [k: string]: unknown;
 } | {
-    schema_version?: "1.5" | undefined;
+    schema_version?: "1.5" | "1.6" | undefined;
     [k: string]: unknown;
 }) & ({
+    failure_kind?: "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | null;
+    [k: string]: unknown;
+} | {
+    schema_version?: "1.6" | undefined;
+    [k: string]: unknown;
+})) & ({
     duration_ms: number;
     /**
      * Best-effort normalized failure text for a run that did not succeed: the
@@ -123,7 +129,7 @@ export type HistoryRecord = ({
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -353,7 +359,7 @@ export type HistoryRecord = ({
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -445,7 +451,7 @@ export type HistoryRecord = ({
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -537,7 +543,7 @@ export type HistoryRecord = ({
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.2" | "1.3" | "1.4" | "1.5";
+    schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -629,7 +635,7 @@ export type HistoryRecord = ({
      * run's single prompt).
      */
     prompt: string;
-    schema_version: "1.3" | "1.4" | "1.5";
+    schema_version: "1.3" | "1.4" | "1.5" | "1.6";
     /**
      * The oneharness session id this run belongs to (the history file's stem).
      */
@@ -981,7 +987,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";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large";
 /**
  * The outcome of attempting to run one harness.
  */

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

@@ -69,6 +69,17 @@ export type ControlReason = "unsupported" | "no_active_turn" | "not_running";
  * frame's `v` is what leaves room for `steer` later.
  */
 export type ControlVerb = "interrupt";
+/**
+ * Why a candidate fell through — the closed set [`startup_failure_reason`]
+ * decides and [`crate::domain::report::FallThrough`] reports.
+ *
+ * A type rather than a token, because the set is closed and every reader
+ * downstream branches on it: a value no classifier produced cannot be built,
+ * and the JSON spelling below is the schema's rather than each call site's. A
+ * 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";
 /**
  * The normalized, closed set of failure reasons oneharness can classify from a
  * harness's output. It is the single source for the `failure_kind` contract
@@ -80,7 +91,7 @@ export type ControlVerb = "interrupt";
  * 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";
+export type FailureKind = "auth" | "rate_limit" | "model_not_found" | "quota" | "session_not_found" | "tool_deferred" | "untrusted_directory" | "input_too_large";
 /**
  * How a harness emits its result, which decides how `text` is extracted.
  *
@@ -350,7 +361,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`, and — on a model fan-out — `model-not-found` / `rate-limit`; see
+     * `quota`, `session-not-found`, `untrusted-directory`, `input-too-large`,
+     * and — on a model fan-out — `model-not-found` / `rate-limit`; see
      * [`crate::domain::fallback::startup_failure_reason`]).
      */
     fell_through: FallThrough[];
@@ -365,15 +377,29 @@ export interface FallbackReport {
  * One candidate a fallback run fell through, with the reason it could not run.
  */
 export interface FallThrough {
+    /**
+     * This candidate's own account of why it could not run: its
+     * [`RunResult::error`], copied — one value with one source, not a second
+     * rendering of it. `null` when the candidate said nothing beyond its status.
+     *
+     * So when the provider named the cause in machine-readable terms, what
+     * arrives here is the sentence naming the harness with that object **quoted
+     * inside it** (`… refused the request before running it:
+     * {"input_error_code":"input_too_large",…}`) — the object verbatim, not the
+     * object alone. A reader extracts it; nothing paraphrases it on the way.
+     *
+     * The `reason` above is oneharness's classification and stays a short,
+     * closed token; this is the cause underneath it, carried up so a supervisor
+     * reading only the fallback block never has to re-parse a fallen-through
+     * candidate's raw stdout to learn what the provider already said. Added in
+     * report schema `0.8`.
+     */
+    detail: string | null;
     /**
      * Canonical harness id.
      */
     harness: string;
-    /**
-     * Short reason token (`not-installed` / `spawn-error` / `auth` / `quota` /
-     * `model-not-found` / `rate-limit`).
-     */
-    reason: string;
+    reason: FallThroughReason;
     [k: string]: unknown;
 }
 /**