@oneharness/sdk 0.26.1 → 0.27.0

package/README.md

@@ -11,7 +11,7 @@ const checked: RunReport = RunReportSchema.parse(report);
 console.log(checked.results[0]?.text, checked.results[0]?.usage.input_tokens);
 ```
 
-The client covers every verb the CLI exposes, so nothing needs a hand-built command line: `run`, `runMock`, `runStream`, `list`, `detect`, `config`, `sync`, `init`, `usage`, `gate`, `mock`, `interrupt`, `history`, `historyList`, `historyWatch`, `historyClear`, `historyMigrate`, `historyReindex`, and `historyPointers`. That coverage is gated, not asserted here. `runMock` uses the deterministic responder shipped in the CLI; see [Testing patterns](../../docs/testing-patterns.md). Both streaming methods return async iterators:
+The client covers every verb the CLI exposes, so nothing needs a hand-built command line: `run`, `runMock`, `runStream`, `list`, `detect`, `config`, `sync`, `init`, `usage`, `gate`, `mock`, `interrupt`, `compact`, `history`, `historyList`, `historyWatch`, `historyClear`, `historyMigrate`, `historyReindex`, and `historyPointers`. That coverage is gated, not asserted here, and this list is held to the same capability manifest by `every_capability_is_named_in_each_sdk_readme` in [`crates/sdk-conformance/tests/sdk_conformance.rs`](../../crates/sdk-conformance/tests/sdk_conformance.rs). `runMock` uses the deterministic responder shipped in the CLI; see [Testing patterns](../../docs/testing-patterns.md). Both streaming methods return async iterators:
 
 ```ts
 for await (const envelope of oneharness.runStream({

package/dist/generated/capabilities.d.ts

@@ -187,6 +187,31 @@ export declare const CAPABILITIES: {
             readonly flag: "--timeout";
             readonly kind: "value";
             readonly unless: null;
+        }, {
+            readonly option: "autoCompactTokens";
+            readonly flag: "--auto-compact-tokens";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "toolSet";
+            readonly flag: "--tool-set";
+            readonly kind: "repeated";
+            readonly unless: null;
+        }, {
+            readonly option: "noSkills";
+            readonly flag: "--no-skills";
+            readonly kind: "switch";
+            readonly unless: null;
+        }, {
+            readonly option: "noMcp";
+            readonly flag: "--no-mcp";
+            readonly kind: "switch";
+            readonly unless: null;
+        }, {
+            readonly option: "images";
+            readonly flag: "--image";
+            readonly kind: "repeated";
+            readonly unless: null;
         }, {
             readonly option: "cwd";
             readonly flag: "--cwd";
@@ -432,6 +457,31 @@ export declare const CAPABILITIES: {
             readonly flag: "--timeout";
             readonly kind: "value";
             readonly unless: null;
+        }, {
+            readonly option: "autoCompactTokens";
+            readonly flag: "--auto-compact-tokens";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "toolSet";
+            readonly flag: "--tool-set";
+            readonly kind: "repeated";
+            readonly unless: null;
+        }, {
+            readonly option: "noSkills";
+            readonly flag: "--no-skills";
+            readonly kind: "switch";
+            readonly unless: null;
+        }, {
+            readonly option: "noMcp";
+            readonly flag: "--no-mcp";
+            readonly kind: "switch";
+            readonly unless: null;
+        }, {
+            readonly option: "images";
+            readonly flag: "--image";
+            readonly kind: "repeated";
+            readonly unless: null;
         }, {
             readonly option: "cwd";
             readonly flag: "--cwd";
@@ -840,6 +890,69 @@ export declare const CAPABILITIES: {
         }];
         readonly uncovered: readonly [];
     };
+    readonly compact: {
+        readonly method: "compact";
+        readonly argv: readonly ["compact"];
+        readonly options: "compact_options";
+        readonly output: "compact_outcome";
+        readonly stdout: "json";
+        readonly stdin: false;
+        readonly rust: "oneharness_core::io::compact::compact_session";
+        readonly always: readonly ["--compact", "--format", "json"];
+        readonly bindings: readonly [{
+            readonly option: "session";
+            readonly flag: "--session";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "sessionDir";
+            readonly flag: "--session-dir";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "harness";
+            readonly flag: "--harness";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "cwd";
+            readonly flag: "--cwd";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "model";
+            readonly flag: "--model";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "timeoutSeconds";
+            readonly flag: "--timeout";
+            readonly kind: "value";
+            readonly unless: null;
+        }, {
+            readonly option: "env";
+            readonly flag: "--env";
+            readonly kind: "key-value";
+            readonly unless: null;
+        }, {
+            readonly option: "bins";
+            readonly flag: "--bin";
+            readonly kind: "key-value";
+            readonly unless: null;
+        }, {
+            readonly option: "config";
+            readonly flag: "--config";
+            readonly kind: "repeated";
+            readonly unless: "noConfig";
+            readonly unless_resolution: "refuse";
+        }, {
+            readonly option: "noConfig";
+            readonly flag: "--no-config";
+            readonly kind: "switch";
+            readonly unless: null;
+        }];
+        readonly uncovered: readonly [];
+    };
     readonly history: {
         readonly method: "history";
         readonly argv: readonly ["history", "show"];

package/dist/generated/capabilities.js

@@ -167,6 +167,36 @@ export const CAPABILITIES = {
                 kind: "value",
                 unless: null,
             },
+            {
+                option: "autoCompactTokens",
+                flag: "--auto-compact-tokens",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "toolSet",
+                flag: "--tool-set",
+                kind: "repeated",
+                unless: null,
+            },
+            {
+                option: "noSkills",
+                flag: "--no-skills",
+                kind: "switch",
+                unless: null,
+            },
+            {
+                option: "noMcp",
+                flag: "--no-mcp",
+                kind: "switch",
+                unless: null,
+            },
+            {
+                option: "images",
+                flag: "--image",
+                kind: "repeated",
+                unless: null,
+            },
             {
                 option: "cwd",
                 flag: "--cwd",
@@ -461,6 +491,36 @@ export const CAPABILITIES = {
                 kind: "value",
                 unless: null,
             },
+            {
+                option: "autoCompactTokens",
+                flag: "--auto-compact-tokens",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "toolSet",
+                flag: "--tool-set",
+                kind: "repeated",
+                unless: null,
+            },
+            {
+                option: "noSkills",
+                flag: "--no-skills",
+                kind: "switch",
+                unless: null,
+            },
+            {
+                option: "noMcp",
+                flag: "--no-mcp",
+                kind: "switch",
+                unless: null,
+            },
+            {
+                option: "images",
+                flag: "--image",
+                kind: "repeated",
+                unless: null,
+            },
             {
                 option: "cwd",
                 flag: "--cwd",
@@ -937,6 +997,80 @@ export const CAPABILITIES = {
         ],
         uncovered: [],
     },
+    compact: {
+        method: "compact",
+        argv: ["compact"],
+        options: "compact_options",
+        output: "compact_outcome",
+        stdout: "json",
+        stdin: false,
+        rust: "oneharness_core::io::compact::compact_session",
+        always: ["--compact", "--format", "json"],
+        bindings: [
+            {
+                option: "session",
+                flag: "--session",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "sessionDir",
+                flag: "--session-dir",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "harness",
+                flag: "--harness",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "cwd",
+                flag: "--cwd",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "model",
+                flag: "--model",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "timeoutSeconds",
+                flag: "--timeout",
+                kind: "value",
+                unless: null,
+            },
+            {
+                option: "env",
+                flag: "--env",
+                kind: "key-value",
+                unless: null,
+            },
+            {
+                option: "bins",
+                flag: "--bin",
+                kind: "key-value",
+                unless: null,
+            },
+            {
+                option: "config",
+                flag: "--config",
+                kind: "repeated",
+                unless: "noConfig",
+                unless_resolution: "refuse",
+            },
+            {
+                option: "noConfig",
+                flag: "--no-config",
+                kind: "switch",
+                unless: null,
+            },
+        ],
+        uncovered: [],
+    },
     history: {
         method: "history",
         argv: ["history", "show"],

package/dist/generated/compact-options.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Options accepted by the language SDKs' `compact()`: compact a named
+ * session now (`oneharness compact`).
+ */
+export interface CompactOptions {
+    bins?: {
+        [k: string]: string;
+    } | undefined;
+    config?: string[] | undefined;
+    cwd?: string | undefined;
+    env?: {
+        [k: string]: string;
+    } | undefined;
+    /**
+     * The harness identity the session is expected to be bound to.
+     */
+    harness?: string | undefined;
+    model?: string | undefined;
+    noConfig?: boolean | undefined;
+    /**
+     * The caller-owned session name (`run`'s `session`).
+     */
+    session: string;
+    sessionDir?: string | undefined;
+    timeoutSeconds?: number | undefined;
+}

package/dist/generated/compact-options.js

@@ -0,0 +1,2 @@
+/* Generated from oneharness-core. Do not edit. */
+export {};

package/dist/generated/compact-outcome.d.ts

@@ -0,0 +1,72 @@
+/**
+ * How a compaction ended.
+ */
+export type CompactStatus = "completed" | "cancelled" | "unsupported" | "failed";
+/**
+ * The `oneharness compact` report.
+ */
+export interface CompactOutcome {
+    /**
+     * The context size after compaction, where the harness reports it
+     * (claude-code's `compact_boundary.post_tokens`); `null` otherwise.
+     */
+    context_tokens_after: number | null;
+    /**
+     * The context size before compaction, where the harness reports it
+     * (claude-code's `compact_boundary.pre_tokens`); `null` otherwise.
+     */
+    context_tokens_before: number | null;
+    /**
+     * Why the compaction is `unsupported` or `failed`; absent otherwise.
+     */
+    error?: string | null | undefined;
+    /**
+     * The harness identity the session is bound to.
+     */
+    harness: string;
+    schema_version: string;
+    /**
+     * The session name compacted.
+     */
+    session: string;
+    status: CompactStatus;
+    /**
+     * The native session token the name continues after this call: the
+     * compacted fork's on `completed`, the untouched original's otherwise.
+     * `null` when the request was refused before a session was resolved.
+     */
+    token?: string | null | undefined;
+    usage: Usage;
+    [k: string]: unknown;
+}
+/**
+ * The compaction's own usage, every field `null` where the harness
+ * reports none.
+ */
+export interface Usage {
+    /**
+     * Prompt tokens served from the provider's prompt cache (a cheap read of a
+     * previously-written prefix), when the harness reports them. `None` when the
+     * harness does not surface cache counts — never `0` as a guess.
+     */
+    cache_read_tokens: number | null;
+    /**
+     * Prompt tokens written to the provider's prompt cache (a.k.a. cache
+     * creation), when the harness reports them. `None` when not surfaced.
+     */
+    cache_write_tokens: number | null;
+    /**
+     * Total cost in USD, when the harness reports it (often absent on
+     * subscription auth, where there is no per-call dollar figure).
+     */
+    cost_usd: number | null;
+    /**
+     * Prompt/input tokens billed, when the harness reports them.
+     */
+    input_tokens: number | null;
+    /**
+     * Completion/output tokens billed, when the harness reports them.
+     */
+    output_tokens: number | null;
+    [k: string]: unknown;
+}

package/dist/generated/compact-outcome.js

@@ -0,0 +1,2 @@
+/* Generated from oneharness-core. Do not edit. */
+export {};

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

@@ -29,6 +29,10 @@ export type OutputFormat = "text" | "json" | "stream-json";
  * free of `clap`.
  */
 export type RunMode = "parallel" | "fallback";
+/**
+ * A harness-agnostic class of built-in tool a turn may load (`tool_set`).
+ */
+export type ToolClass = "shell" | "read";
 /**
  * The `oneharness config` report: the fully layered configuration with the
  * provenance of every value, so a consumer can see exactly which file (or
@@ -37,6 +41,7 @@ export type RunMode = "parallel" | "fallback";
 export interface ConfigReport {
     all: Field;
     allowed_tools: Field2;
+    auto_compact_tokens: Field5;
     bypass: Field;
     /**
      * The files consulted, in layering order (user first, project last).
@@ -66,22 +71,25 @@ export interface ConfigReport {
         [k: string]: Field3;
     };
     history_pointer_file: Field3;
-    hooks: Field10;
-    max_parallel: Field8;
+    hooks: Field11;
+    load_mcp: Field;
+    load_skills: Field;
+    max_parallel: Field9;
     mode: Field4;
     model: Field3;
     models: Field21;
-    output_format: Field6;
+    output_format: Field7;
     reasoning: Field31;
     require_available: Field;
-    run_mode: Field9;
+    run_mode: Field10;
     schema_file: Field3;
-    schema_max_retries: Field7;
+    schema_max_retries: Field8;
     schema_version: string;
-    server_overloaded_max_retries: Field7;
+    server_overloaded_max_retries: Field8;
     stream: Field1;
     system: Field3;
     timeout: Field5;
+    tool_set: Field6;
     [k: string]: unknown;
 }
 /**
@@ -104,6 +112,16 @@ export interface Field2 {
     value: string[] | null;
     [k: string]: unknown;
 }
+/**
+ * One resolved field in the `oneharness config` report: the effective value
+ * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
+ * are `null` when the field is unset everywhere and has no built-in default.
+ */
+export interface Field5 {
+    source: string | null;
+    value: number | null;
+    [k: string]: unknown;
+}
 /**
  * One resolved field in the `oneharness config` report: the effective value
  * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
@@ -127,7 +145,7 @@ export interface HarnessReport {
      * The resolved `app_server` (`"shared"` by default), present only for
      * `codex`.
      */
-    app_server?: Field11 | null | undefined;
+    app_server?: Field12 | null | undefined;
     /**
      * The resolved `apps` opt-in (`false` by default), present only for
      * `codex`.
@@ -172,21 +190,11 @@ export interface HarnessReport {
  * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
  * are `null` when the field is unset everywhere and has no built-in default.
  */
-export interface Field11 {
+export interface Field12 {
     source: string | null;
     value: AppServerMode | null;
     [k: string]: unknown;
 }
-/**
- * One resolved field in the `oneharness config` report: the effective value
- * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
- * are `null` when the field is unset everywhere and has no built-in default.
- */
-export interface Field5 {
-    source: string | null;
-    value: number | null;
-    [k: string]: unknown;
-}
 export interface VariantReport {
     allowed_tools: Field2;
     /**
@@ -198,7 +206,7 @@ export interface VariantReport {
      * The `app_server` a launch of this variant resolves to: the variant's
      * own, else its harness's, else `"shared"`. Present only for `codex`.
      */
-    app_server?: Field11 | null | undefined;
+    app_server?: Field12 | null | undefined;
     /**
      * The apps opt-in a launch of this variant resolves to: the variant's
      * own, else its harness's, else `false`. Present only for `codex`.
@@ -247,7 +255,7 @@ export interface VariantReport {
  * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
  * are `null` when the field is unset everywhere and has no built-in default.
  */
-export interface Field10 {
+export interface Field11 {
     source: string | null;
     value: HookEntry[] | null;
     [k: string]: unknown;
@@ -290,7 +298,7 @@ export interface HookEntry {
  * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
  * are `null` when the field is unset everywhere and has no built-in default.
  */
-export interface Field8 {
+export interface Field9 {
     source: string | null;
     value: number | null;
     [k: string]: unknown;
@@ -319,7 +327,7 @@ export interface Field21 {
  * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
  * are `null` when the field is unset everywhere and has no built-in default.
  */
-export interface Field6 {
+export interface Field7 {
     source: string | null;
     value: OutputFormat | null;
     [k: string]: unknown;
@@ -339,7 +347,7 @@ export interface Field31 {
  * built-in default, attributed to [`DEFAULT_SOURCE`]) — the report says what
  * a run would do, so an unset mode is never shown as `null`.
  */
-export interface Field9 {
+export interface Field10 {
     source: string | null;
     value: RunMode | null;
     [k: string]: unknown;
@@ -349,7 +357,7 @@ export interface Field9 {
  * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
  * are `null` when the field is unset everywhere and has no built-in default.
  */
-export interface Field7 {
+export interface Field8 {
     source: string | null;
     value: number | null;
     [k: string]: unknown;
@@ -364,3 +372,13 @@ export interface Field1 {
     value: boolean | null;
     [k: string]: unknown;
 }
+/**
+ * One resolved field in the `oneharness config` report: the effective value
+ * plus where it came from (a config file path, or [`DEFAULT_SOURCE`]). Both
+ * are `null` when the field is unset everywhere and has no built-in default.
+ */
+export interface Field6 {
+    source: string | null;
+    value: ToolClass[] | null;
+    [k: string]: unknown;
+}