@oneharness/sdk 0.8.0 → 0.10.0

package/dist/generated/zod.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import type { ConfigOptions } from "./config-options.js";
 import type { ConfigReport, Field, Field10, Field2, Field3, Field4, Field5, Field6, Field7, Field8, Field9, HarnessReport, HookEntry, VariantReport } from "./config-report.js";
-import type { ActionEvent, BatchReport, ControlEvent, ControlReason, ControlReport, ControlVerb, ExecutionTelemetry, FailureKind, FallThrough, FallbackReport, RunReport, RunResult, SessionReport, Status, TimingSource, ToolCallStatus, Usage, UtcInstant } from "./contracts.js";
+import type { ActionEvent, BatchReport, ControlEvent, ControlReason, ControlReport, ControlVerb, ExecutionTelemetry, FailureKind, FallThrough, FallThroughReason, FallbackReport, RunReport, RunResult, SessionReport, Status, TimingSource, ToolCallStatus, Usage, UtcInstant } from "./contracts.js";
 import type { DetectOptions } from "./detect-options.js";
 import type { DetectInfo, DetectReport } from "./detection.js";
 import type { GateOptions } from "./gate-options.js";
@@ -53,6 +53,7 @@ export declare const DetectReportSchema: z.ZodType<DetectReport>;
 export declare const ExecutionTelemetrySchema: z.ZodType<ExecutionTelemetry>;
 export declare const FailureKindSchema: z.ZodType<FailureKind>;
 export declare const FallThroughSchema: z.ZodType<FallThrough>;
+export declare const FallThroughReasonSchema: z.ZodType<FallThroughReason>;
 export declare const FallbackReportSchema: z.ZodType<FallbackReport>;
 export declare const FieldSchema: z.ZodType<Field>;
 export declare const Field10Schema: z.ZodType<Field10>;

package/dist/generated/zod.js

@@ -169,11 +169,25 @@ export const FailureKindSchema = z.union([
     z.literal("quota"),
     z.literal("session_not_found"),
     z.literal("tool_deferred"),
+    z.literal("untrusted_directory"),
+    z.literal("input_too_large"),
 ]);
 export const FallThroughSchema = z.looseObject({
+    detail: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
     harness: z.string().refine((value) => value !== undefined, { message: "Required" }),
-    reason: z.string().refine((value) => value !== undefined, { message: "Required" }),
+    reason: z.lazy(() => FallThroughReasonSchema).refine((value) => value !== undefined, { message: "Required" }),
 });
+export const FallThroughReasonSchema = z.union([
+    z.literal("not-installed"),
+    z.literal("spawn-error"),
+    z.literal("auth"),
+    z.literal("quota"),
+    z.literal("session-not-found"),
+    z.literal("untrusted-directory"),
+    z.literal("input-too-large"),
+    z.literal("model-not-found"),
+    z.literal("rate-limit"),
+]);
 export const FallbackReportSchema = z.looseObject({
     fell_through: z
         .array(z.lazy(() => FallThroughSchema))
@@ -326,7 +340,7 @@ export const HistoryEventLineSchema = z.union([
             .refine((value) => [...value].length <= 36, { message: "Too long: expected at most 36 characters" })
             .refine((value) => value !== undefined, { message: "Required" }),
         schema_version: z
-            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
             .refine((value) => value !== undefined, { message: "Required" }),
         variant: z.union([z.string(), z.null()]).optional(),
     }),
@@ -376,7 +390,7 @@ export const HistoryLineSchema = z.union([
                 .refine((value) => [...value].length <= 36, { message: "Too long: expected at most 36 characters" })
                 .refine((value) => value !== undefined, { message: "Required" }),
             schema_version: z
-                .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+                .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
                 .refine((value) => value !== undefined, { message: "Required" }),
             type: z.literal("event").refine((value) => value !== undefined, { message: "Required" }),
             variant: z.union([z.string(), z.null()]).optional(),
@@ -453,6 +467,7 @@ export const HistoryLineSchema = z.union([
                 z.literal("1.3"),
                 z.literal("1.4"),
                 z.literal("1.5"),
+                z.literal("1.6"),
             ])
                 .refine((value) => value !== undefined, { message: "Required" }),
             session: z.string().refine((value) => value !== undefined, { message: "Required" }),
@@ -530,6 +545,7 @@ export const HistoryLineSchema = z.union([
                 z.literal("1.3"),
                 z.literal("1.4"),
                 z.literal("1.5"),
+                z.literal("1.6"),
             ])
                 .refine((value) => value !== undefined, { message: "Required" }),
             session: z.string().refine((value) => value !== undefined, { message: "Required" }),
@@ -604,7 +620,7 @@ export const HistoryLineSchema = z.union([
             project: z.string().refine((value) => value !== undefined, { message: "Required" }),
             prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
             schema_version: z
-                .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+                .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
                 .refine((value) => value !== undefined, { message: "Required" }),
             session: z.string().refine((value) => value !== undefined, { message: "Required" }),
             session_id: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
@@ -667,6 +683,7 @@ export const HistoryLineSchema = z.union([
                 z.literal("1.3"),
                 z.literal("1.4"),
                 z.literal("1.5"),
+                z.literal("1.6"),
             ])
                 .refine((value) => value !== undefined, { message: "Required" }),
             session: z.string().refine((value) => value !== undefined, { message: "Required" }),
@@ -732,7 +749,7 @@ export const HistoryLineSchema = z.union([
             project: z.string().refine((value) => value !== undefined, { message: "Required" }),
             prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
             schema_version: z
-                .union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+                .union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
                 .refine((value) => value !== undefined, { message: "Required" }),
             session: z.string().refine((value) => value !== undefined, { message: "Required" }),
             session_id: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
@@ -806,6 +823,7 @@ export const HistoryLineSchema = z.union([
                 z.literal("1.3"),
                 z.literal("1.4"),
                 z.literal("1.5"),
+                z.literal("1.6"),
             ])
                 .refine((value) => value !== undefined, { message: "Required" }),
             session: z.string().refine((value) => value !== undefined, { message: "Required" }),
@@ -831,7 +849,9 @@ export const HistoryLineSchema = z.union([
         }),
         z.intersection(z.looseObject({
             error: z.string().refine((value) => value !== undefined, { message: "Required" }),
-            schema_version: z.union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5")]).optional(),
+            schema_version: z
+                .union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
+                .optional(),
         }), z.union([
             z.looseObject({
                 status: z
@@ -864,9 +884,9 @@ export const HistoryLineSchema = z.union([
                 .optional(),
         }),
         z.looseObject({
-            schema_version: z.union([z.literal("1.4"), z.literal("1.5")]).optional(),
+            schema_version: z.union([z.literal("1.4"), z.literal("1.5"), z.literal("1.6")]).optional(),
         }),
-    ])), z.union([
+    ])), z.intersection(z.union([
         z.looseObject({
             failure_kind: z
                 .union([
@@ -875,14 +895,33 @@ export const HistoryLineSchema = z.union([
                 z.literal("model_not_found"),
                 z.literal("quota"),
                 z.literal("tool_deferred"),
+                z.literal("untrusted_directory"),
+                z.literal("input_too_large"),
                 z.literal(null),
             ])
                 .optional(),
         }),
         z.looseObject({
-            schema_version: z.literal("1.5").optional(),
+            schema_version: z.union([z.literal("1.5"), z.literal("1.6")]).optional(),
         }),
-    ])),
+    ]), z.union([
+        z.looseObject({
+            failure_kind: z
+                .union([
+                z.literal("auth"),
+                z.literal("rate_limit"),
+                z.literal("model_not_found"),
+                z.literal("quota"),
+                z.literal("session_not_found"),
+                z.literal("tool_deferred"),
+                z.literal(null),
+            ])
+                .optional(),
+        }),
+        z.looseObject({
+            schema_version: z.literal("1.6").optional(),
+        }),
+    ]))),
 ]);
 export const HistoryListSchema = z.array(z.lazy(() => HistorySessionSummarySchema));
 export const HistoryListOptionsSchema = z.strictObject({
@@ -1032,7 +1071,7 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
         project: z.string().refine((value) => value !== undefined, { message: "Required" }),
         prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
         schema_version: z
-            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
             .refine((value) => value !== undefined, { message: "Required" }),
         session: z.string().refine((value) => value !== undefined, { message: "Required" }),
         session_id: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
@@ -1236,7 +1275,7 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
         project: z.string().refine((value) => value !== undefined, { message: "Required" }),
         prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
         schema_version: z
-            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
             .refine((value) => value !== undefined, { message: "Required" }),
         session: z.string().refine((value) => value !== undefined, { message: "Required" }),
         session_id: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
@@ -1298,7 +1337,7 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
         project: z.string().refine((value) => value !== undefined, { message: "Required" }),
         prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
         schema_version: z
-            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
             .refine((value) => value !== undefined, { message: "Required" }),
         session: z.string().refine((value) => value !== undefined, { message: "Required" }),
         session_id: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
@@ -1354,7 +1393,7 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
         project: z.string().refine((value) => value !== undefined, { message: "Required" }),
         prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
         schema_version: z
-            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+            .union([z.literal("1.2"), z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
             .refine((value) => value !== undefined, { message: "Required" }),
         session: z.string().refine((value) => value !== undefined, { message: "Required" }),
         session_id: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
@@ -1419,7 +1458,7 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
         project: z.string().refine((value) => value !== undefined, { message: "Required" }),
         prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
         schema_version: z
-            .union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5")])
+            .union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
             .refine((value) => value !== undefined, { message: "Required" }),
         session: z.string().refine((value) => value !== undefined, { message: "Required" }),
         session_id: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
@@ -1670,7 +1709,9 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
     }),
     z.intersection(z.looseObject({
         error: z.string().refine((value) => value !== undefined, { message: "Required" }),
-        schema_version: z.union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5")]).optional(),
+        schema_version: z
+            .union([z.literal("1.3"), z.literal("1.4"), z.literal("1.5"), z.literal("1.6")])
+            .optional(),
     }), z.union([
         z.looseObject({
             status: z
@@ -1701,9 +1742,9 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
             .optional(),
     }),
     z.looseObject({
-        schema_version: z.union([z.literal("1.4"), z.literal("1.5")]).optional(),
+        schema_version: z.union([z.literal("1.4"), z.literal("1.5"), z.literal("1.6")]).optional(),
     }),
-])), z.union([
+])), z.intersection(z.union([
     z.looseObject({
         failure_kind: z
             .union([
@@ -1712,14 +1753,33 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
             z.literal("model_not_found"),
             z.literal("quota"),
             z.literal("tool_deferred"),
+            z.literal("untrusted_directory"),
+            z.literal("input_too_large"),
             z.literal(null),
         ])
             .optional(),
     }),
     z.looseObject({
-        schema_version: z.literal("1.5").optional(),
+        schema_version: z.union([z.literal("1.5"), z.literal("1.6")]).optional(),
     }),
-]));
+]), z.union([
+    z.looseObject({
+        failure_kind: z
+            .union([
+            z.literal("auth"),
+            z.literal("rate_limit"),
+            z.literal("model_not_found"),
+            z.literal("quota"),
+            z.literal("session_not_found"),
+            z.literal("tool_deferred"),
+            z.literal(null),
+        ])
+            .optional(),
+    }),
+    z.looseObject({
+        schema_version: z.literal("1.6").optional(),
+    }),
+])));
 export const HistoryRecordsSchema = z.array(z.lazy(() => HistoryRecordSchema));
 export const HistorySessionSummarySchema = z.looseObject({
     harnesses: z.array(z.string()).refine((value) => value !== undefined, { message: "Required" }),

package/dist/index.d.ts

@@ -25,7 +25,7 @@ import type { SyncOptions } from "./generated/sync-options.js";
 import type { SyncReport } from "./generated/sync-report.js";
 import type { UsageOptions } from "./generated/usage-options.js";
 import type { UsageReport } from "./generated/usage-report.js";
-export type { Capability, CapabilityMethod, FlagKind, OptionBinding, StdoutShape, } from "./generated/capabilities.js";
+export type { Capability, CapabilityMethod, FlagKind, OptionBinding, StdoutShape, UnlessResolution, } from "./generated/capabilities.js";
 export { CAPABILITIES } from "./generated/capabilities.js";
 export type { ConfigOptions } from "./generated/config-options.js";
 export type { ConfigReport } from "./generated/config-report.js";

package/dist/index.js

@@ -213,6 +213,23 @@ function rendersArgument(binding, value) {
             return true;
     }
 }
+/**
+ * Does this value assert something, or merely occupy the key?
+ *
+ * Suppression asks whether a binding renders; refusing asks something narrower,
+ * because a contradiction takes two positive answers. An empty value is not one.
+ * `{system: ""}` does render `--system ""` — which is why it still suppresses the
+ * `--system-file` clap refuses beside it — but an empty system prompt asks for
+ * nothing, so a file beside it is a defaulted key next to a real choice rather
+ * than a caller asking for two different things.
+ */
+function statesAChoice(binding, value) {
+    if (!rendersArgument(binding, value))
+        return false;
+    if (binding.kind === "value" || binding.kind === "positional")
+        return String(value) !== "";
+    return true;
+}
 /**
  * Render one capability's argv from its declared bindings.
  *
@@ -239,8 +256,23 @@ function capabilityArguments(method, options) {
         // that an `unless` always resolves here, so a missing entry is unreachable
         // rather than a case to render through.
         const suppressor = binding.unless === null ? null : bound.get(binding.unless);
-        if (suppressor && rendersArgument(suppressor, input[suppressor.option]))
+        if (suppressor && rendersArgument(suppressor, input[suppressor.option])) {
+            // What both halves asserting means is the manifest's question, not this
+            // client's: `prefer` is a request with one meaning (`{session, last:
+            // true}` is "the most recent"), `refuse` is a caller who asked for two
+            // different things. Editing the second one out picks an answer silently,
+            // which is how a turn gets billed to a harness nobody selected. So
+            // `prefer` is the only waiver, and everything else refuses: an absent
+            // annotation (a manifest older than the key) and a resolution added after
+            // this client shipped both read as the recoverable half, because a
+            // refusal the manifest meant to resolve is a message the caller can act
+            // on and the reverse is not.
+            if ((binding.unless_resolution ?? "refuse") !== "prefer" &&
+                statesAChoice(binding, input[binding.option]) &&
+                statesAChoice(suppressor, input[suppressor.option]))
+                throw new Error(`invalid oneharness ${capability.argv.join(" ")} options: \`${binding.option}\` and \`${suppressor.option}\` are mutually exclusive, and this call sets both to values the CLI would send. Pass only the one you mean — resolving it here would run the call as something you did not ask for.`);
             continue;
+        }
         const value = input[binding.option];
         if (value === undefined || value === null)
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneharness/sdk",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Typed Node.js SDK for oneharness",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "oneharness-cli": "0.8.0",
+    "oneharness-cli": "0.10.0",
     "zod": "^4.4.3"
   }
 }