@oneharness/sdk 0.6.14 → 0.6.16

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

@@ -0,0 +1,8 @@
+/**
+ * Options accepted by the language SDKs' `config()`.
+ */
+export interface ConfigOptions {
+    config?: string | undefined;
+    cwd?: string | undefined;
+    noConfig?: boolean | undefined;
+}

package/dist/generated/config-options.js

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

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

@@ -0,0 +1,283 @@
+/**
+ * The unified approval mode, from least to most autonomy. A harness may not
+ * support every value (see [`crate::domain::harness::HarnessSpec::mode`]); the
+ * command layer refuses an unsupported one before spawning, never silently
+ * downgrading it.
+ */
+export type PermissionMode = "read-only" | "plan" | "default" | "edit" | "auto" | "bypass";
+/**
+ * How a harness emits its result, which decides how `text` is extracted.
+ *
+ * Also accepted as a CLI value (`--output-format`, parsed in the `oneharness`
+ * binary) and a config-file value (`output_format`, via `Deserialize`). The
+ * CLI parsing lives in the binary so this core crate stays free of `clap`.
+ */
+export type OutputFormat = "text" | "json" | "stream-json";
+/**
+ * How the selected harnesses are run. Accepted as a CLI value (`--run-mode`,
+ * parsed in the `oneharness` binary) and a config-file value (`run_mode`, via
+ * `Deserialize`); the CLI parsing lives in the binary so this core crate stays
+ * free of `clap`.
+ */
+export type RunMode = "parallel" | "fallback";
+/**
+ * The `oneharness config` report: the fully layered configuration with the
+ * provenance of every value, so a consumer can see exactly which file (or
+ * default) shaped each setting of a run.
+ */
+export interface ConfigReport {
+    all: Field;
+    allowed_tools: Field2;
+    bypass: Field;
+    /**
+     * The files consulted, in layering order (user first, project last).
+     */
+    config_files: string[];
+    denied_tools: Field2;
+    /**
+     * Per-key provenance for the top-level `[env]`.
+     */
+    env: {
+        [k: string]: Field3;
+    };
+    exclude: Field2;
+    /**
+     * Per-harness overrides, with per-field provenance.
+     */
+    harness: {
+        [k: string]: HarnessReport;
+    };
+    harnesses: Field2;
+    history: Field;
+    history_dir: Field3;
+    /**
+     * Per-key provenance for history labels.
+     */
+    history_labels: {
+        [k: string]: Field3;
+    };
+    hooks: Field10;
+    max_parallel: Field8;
+    mode: Field4;
+    model: Field3;
+    models: Field21;
+    output_format: Field6;
+    reasoning: Field31;
+    require_available: Field;
+    run_mode: Field9;
+    schema_file: Field3;
+    schema_max_retries: Field7;
+    schema_version: string;
+    stream: Field1;
+    system: Field3;
+    timeout: Field5;
+    [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 Field {
+    source: string | null;
+    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 Field2 {
+    source: string | null;
+    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 Field3 {
+    source: string | null;
+    value: string | null;
+    [k: string]: unknown;
+}
+/**
+ * One harness's `[harness.<id>]` overrides, with provenance.
+ */
+export interface HarnessReport {
+    allowed_tools: Field2;
+    args: Field2;
+    bin: Field3;
+    denied_tools: Field2;
+    env: {
+        [k: string]: Field3;
+    };
+    hooks: {
+        [k: string]: unknown;
+    };
+    model: Field3;
+    reasoning: Field3;
+    settings: {
+        [k: string]: unknown;
+    };
+    variant: {
+        [k: string]: VariantReport;
+    };
+    [k: string]: unknown;
+}
+export interface VariantReport {
+    allowed_tools: Field2;
+    args: Field2;
+    bin: Field3;
+    denied_tools: Field2;
+    env: {
+        [k: string]: Field3;
+    };
+    env_file: Field3;
+    env_from: {
+        [k: string]: Field3;
+    };
+    hooks: {
+        [k: string]: unknown;
+    };
+    model: Field3;
+    reasoning: Field3;
+    settings: {
+        [k: string]: unknown;
+    };
+    unset_env: Field2;
+    [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 Field10 {
+    source: string | null;
+    value: HookEntry[] | null;
+    [k: string]: unknown;
+}
+/**
+ * One `[[hooks]]` entry: a pre-tool gate installed into each targeted harness.
+ * The `command` may contain `{harness}`, replaced with the harness id when the
+ * hook is built (so one entry can route `mygate hook {harness}` to every CLI).
+ */
+export interface HookEntry {
+    /**
+     * The command the harness runs before a tool call. `{harness}` is
+     * substituted with the harness id. Required and non-empty.
+     */
+    command: string;
+    /**
+     * Restrict this entry to these harness ids; absent means every harness
+     * being synced.
+     */
+    harnesses: string[] | null;
+    /**
+     * Tool-name matcher in the harness's dialect (most read it as a regex);
+     * applied to every targeted harness as written. Absent means match-all.
+     */
+    matcher: string | null;
+    /**
+     * Identity for plugin-delivered harnesses (Goose, OpenCode) and Copilot's
+     * per-owner file, so two tools' hooks never collide. Defaults to
+     * `oneharness`.
+     */
+    plugin_name: string | null;
+    /**
+     * Timeout in seconds, for the harnesses whose hook schema carries one
+     * (Goose, Crush); ignored by the others.
+     */
+    timeout: number | null;
+}
+/**
+ * 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 Field8 {
+    source: string | null;
+    value: number | null;
+    [k: string]: unknown;
+}
+/**
+ * The configured `mode`, if any. Unset when only the legacy `bypass` field
+ * (or neither) is set — the effective mode then derives from `bypass`.
+ */
+export interface Field4 {
+    source: string | null;
+    value: PermissionMode | 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 Field21 {
+    source: string | null;
+    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 Field6 {
+    source: string | null;
+    value: OutputFormat | 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 Field31 {
+    source: string | null;
+    value: string | null;
+    [k: string]: unknown;
+}
+/**
+ * The configured run mode, if any. Unset falls back to `parallel` (the
+ * built-in default) at run time.
+ */
+export interface Field9 {
+    source: string | null;
+    value: RunMode | 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 Field7 {
+    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
+ * are `null` when the field is unset everywhere and has no built-in default.
+ */
+export interface Field1 {
+    source: string | null;
+    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 Field5 {
+    source: string | null;
+    value: number | null;
+    [k: string]: unknown;
+}

package/dist/generated/config-report.js

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

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

@@ -0,0 +1,19 @@
+/**
+ * Options accepted by the language SDKs' `detect()`.
+ */
+export interface DetectOptions {
+    all?: boolean | undefined;
+    bins?: {
+        [k: string]: string;
+    } | undefined;
+    config?: string | undefined;
+    exclude?: string[] | undefined;
+    harnesses?: string[] | undefined;
+    noConfig?: boolean | undefined;
+    /**
+     * Exit non-zero if any probed harness is not installed. The SDKs surface
+     * that as a thrown process error rather than a report a caller must
+     * re-check.
+     */
+    requireAvailable?: boolean | undefined;
+}

package/dist/generated/detect-options.js

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

package/dist/generated/detection.d.ts

@@ -1,8 +1,14 @@
+/**
+ * The `oneharness detect` output contract.
+ */
 export interface DetectReport {
     detected: DetectInfo[];
     schema_version: string;
     [k: string]: unknown;
 }
+/**
+ * One probed harness identity.
+ */
 export interface DetectInfo {
     available: boolean;
     bin: string;

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

@@ -0,0 +1,17 @@
+/**
+ * Options accepted by the language SDKs' `gate()` — the pre-tool gate an
+ * installed hook invokes, driven directly so a consumer hosting its own hook
+ * runner never has to shell out and parse.
+ */
+export interface GateOptions {
+    denyIfContains?: string | undefined;
+    /**
+     * The harness's pre-tool hook event, written to the gate's stdin.
+     */
+    event: string;
+    /**
+     * The harness whose hook protocol to speak.
+     */
+    harness: string;
+    reason?: string | undefined;
+}

package/dist/generated/gate-options.js

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

package/dist/generated/history-clear-options.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Options accepted by the language SDKs' `historyClear()`.
+ */
+export interface HistoryClearOptions {
+    allProjects?: boolean | undefined;
+    config?: string | undefined;
+    historyDir?: string | undefined;
+    noConfig?: boolean | undefined;
+    project?: string | undefined;
+    /**
+     * Actually delete. Absent or false reports what would be removed and
+     * removes nothing, so a caller can always look first.
+     */
+    yes?: boolean | undefined;
+}

package/dist/generated/history-clear-options.js

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

package/dist/generated/history-clear-report.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The `oneharness history clear` output contract.
+ *
+ * `clear` is a dry run until `--yes`, and the two phases have always printed
+ * *different* documents: a real run reports `removed`, a dry run reports
+ * `would_remove` plus the hint that makes it real. That difference is the
+ * contract, so this is a sum of the two frames rather than one struct with
+ * both counts optional — which would let a consumer read a deletion count off
+ * a run that deleted nothing. Untagged, because `dry_run` is the discriminant
+ * the published shape already carries.
+ */
+export type HistoryClearReport = HistoryClearRemoved | HistoryClearDryRun;
+/**
+ * The frame a `--yes` run prints: these files are gone.
+ */
+export interface HistoryClearRemoved {
+    /**
+     * Always `false` — the field is what tells the two frames apart, so it is
+     * a literal rather than a flag either constructor could get wrong.
+     */
+    dry_run: false;
+    files: string[];
+    removed: number;
+    [k: string]: unknown;
+}
+/**
+ * The frame a run without `--yes` prints: these files *would* go.
+ */
+export interface HistoryClearDryRun {
+    dry_run: true;
+    files: string[];
+    /**
+     * How to make the dry run real. Constant text, carried in the document so
+     * a JSON consumer gets the same guidance the text view prints.
+     */
+    hint: string;
+    would_remove: number;
+    [k: string]: unknown;
+}

package/dist/generated/history-clear-report.js

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

package/dist/generated/history-list-options.d.ts

@@ -3,6 +3,19 @@
  */
 export interface HistoryListOptions {
     allProjects?: boolean | undefined;
+    /**
+     * Load configuration from exactly this file, skipping user/project
+     * discovery.
+     */
+    config?: string | undefined;
     historyDir?: string | undefined;
+    /**
+     * Ignore every configuration file.
+     */
+    noConfig?: boolean | undefined;
     project?: string | undefined;
+    /**
+     * Narrow to one configured harness identity (`claude-code:work`).
+     */
+    variant?: string | undefined;
 }

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

@@ -28,13 +28,26 @@ export type HistoryLookup = HistoryLookupByLast | HistoryLookupBySession;
  * Select the most recent session.
  */
 export interface HistoryLookupByLast {
+    /**
+     * Show every record in the session rather than the run summaries.
+     */
+    all?: boolean | undefined;
     allProjects?: boolean | undefined;
+    /**
+     * Load configuration from exactly this file, skipping user/project
+     * discovery.
+     */
+    config?: string | undefined;
     historyDir?: string | undefined;
     /**
      * Select the most recent session. Only `true` selects, so this variant
      * accepts no other value.
      */
     last: true;
+    /**
+     * Ignore every configuration file.
+     */
+    noConfig?: boolean | undefined;
     project?: string | undefined;
     /**
      * A name may accompany `last: true` — it is what the caller would have
@@ -48,7 +61,16 @@ export interface HistoryLookupByLast {
  * Select the session named by `session`.
  */
 export interface HistoryLookupBySession {
+    /**
+     * Show every record in the session rather than the run summaries.
+     */
+    all?: boolean | undefined;
     allProjects?: boolean | undefined;
+    /**
+     * Load configuration from exactly this file, skipping user/project
+     * discovery.
+     */
+    config?: string | undefined;
     historyDir?: string | undefined;
     /**
      * Whether the most recent session was asked for instead. An ordinary
@@ -57,6 +79,10 @@ export interface HistoryLookupBySession {
      * first — so a lookup that reaches this variant always meant the name.
      */
     last?: boolean | undefined;
+    /**
+     * Ignore every configuration file.
+     */
+    noConfig?: boolean | undefined;
     project?: string | undefined;
     /**
      * The oneharness-derived session name recorded by `run --history`. This is

package/dist/generated/history-migrate-options.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Options accepted by the language SDKs' `historyMigrate()`.
+ */
+export interface HistoryMigrateOptions {
+    config?: string | undefined;
+    historyDir?: string | undefined;
+    noConfig?: boolean | undefined;
+}

package/dist/generated/history-migrate-options.js

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

package/dist/generated/history-migrate-report.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The `oneharness history migrate` output contract.
+ *
+ * A type rather than the inline `json!` literal it replaced, because an SDK
+ * cannot validate a document that has no schema — which is what left this
+ * capability's `output` unbacked in the capability manifest.
+ */
+export interface HistoryMigrateReport {
+    /**
+     * One entry per session file the migration touched.
+     */
+    files: MigrationSummary[];
+    /**
+     * `files.len()`, carried so a consumer reading only the summary does not
+     * have to walk the array.
+     */
+    files_processed: number;
+    [k: string]: unknown;
+}
+/**
+ * Outcome for one session file processed by [`migrate`]. Counts refer to
+ * whole legacy records and current v1.0 lines; unreadable lines are preserved
+ * byte-for-byte and reported as skipped.
+ */
+export interface MigrationSummary {
+    already_current: number;
+    path: string;
+    records_migrated: number;
+    skipped: number;
+    [k: string]: unknown;
+}

package/dist/generated/history-migrate-report.js

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

package/dist/generated/history-watch-options.d.ts

@@ -8,10 +8,23 @@
 export interface HistoryWatchOptions {
     after?: string | undefined;
     allProjects?: boolean | undefined;
+    /**
+     * Load configuration from exactly this file, skipping user/project
+     * discovery.
+     */
+    config?: string | undefined;
     events?: boolean | undefined;
     historyDir?: string | undefined;
     labels?: HistoryLabels | undefined;
+    /**
+     * Ignore every configuration file.
+     */
+    noConfig?: boolean | undefined;
     project?: string | undefined;
+    /**
+     * Narrow to one configured harness identity (`claude-code:work`).
+     */
+    variant?: string | undefined;
 }
 export interface HistoryLabels {
     [k: string]: string;

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

@@ -0,0 +1,11 @@
+/**
+ * Options accepted by the language SDKs' `init()`.
+ */
+export interface InitOptions {
+    force?: boolean | undefined;
+    /**
+     * Where to write the starter config. Absent means `oneharness.toml` in the
+     * working directory, exactly as the CLI's own default.
+     */
+    path?: string | undefined;
+}

package/dist/generated/init-options.js

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

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

@@ -0,0 +1,12 @@
+/**
+ * Options accepted by the language SDKs' `interrupt()`.
+ */
+export interface InterruptOptions {
+    cwd?: string | undefined;
+    input?: string | undefined;
+    /**
+     * The caller-owned session handle the target run was started with.
+     */
+    session: string;
+    sessionDir?: string | undefined;
+}

package/dist/generated/interrupt-options.js

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

package/dist/generated/interrupt-response.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The answer to one `oneharness interrupt`: either the abort was served, or it was refused with a reason.
+ */
+export type InterruptResponse = {
+    error?: never | undefined;
+    mechanism: ControlShape;
+    ok: true;
+    reason?: never | undefined;
+    /**
+     * Whether the request's redirection was committed with the abort. Omitted rather than sent as `false`, so a plain interrupt's answer gains no field the supervisor did not ask for.
+     */
+    redirected?: boolean | undefined;
+    v: 2;
+    [k: string]: unknown;
+} | {
+    error: string;
+    mechanism?: never | undefined;
+    ok: false;
+    reason: ControlReason;
+    redirected?: false | undefined;
+    v: 2;
+    [k: string]: unknown;
+};
+/**
+ * How a harness accepts an out-of-band interrupt for an in-flight turn.
+ *
+ * Registry data on [`crate::domain::harness::HarnessSpec::control`], sourced
+ * from a live interrupt against the real CLI — never guessed. `None` there
+ * means `oneharness interrupt` is a loud usage error for the harness, never a
+ * silent no-op: a supervisor that is told "ok" while the turn keeps running is
+ * worse off than one told the lever does not exist.
+ */
+export type ControlShape = "claude-control-request" | "codex-app-server" | "opencode-http" | "acp-cancel" | "crush-http";
+/**
+ * Why a control request could not be served. Distinct reasons because a
+ * supervisor reacts differently to each: `unsupported` is permanent for the
+ * harness, `not_running` means the dispatch is gone, `no_active_turn` means
+ * the run is alive but between turns.
+ */
+export type ControlReason = "unsupported" | "no_active_turn" | "not_running";

package/dist/generated/interrupt-response.js

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

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

@@ -0,0 +1,12 @@
+/**
+ * Options accepted by the language SDKs' `mock()`.
+ */
+export interface MockOptions {
+    /**
+     * The harness's pre-tool hook event, written to the responder's stdin.
+     */
+    event: string;
+    harness: string;
+    rules?: string | undefined;
+    spyFile?: string | undefined;
+}

package/dist/generated/mock-options.js

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