@oneharness/sdk 0.4.4 → 0.4.6

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 complete client surface is `run`, `runStream`, `list`, `detect`, `history`, `historyList`, and `historyWatch`. Both streaming methods return async iterators:
+The complete client surface includes `run`, `runMock`, `runStream`, `list`, `detect`, `history`, `historyList`, and `historyWatch`. `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/index.d.ts

@@ -28,6 +28,13 @@ export type OneHarnessOptions = {
     executableArgs?: readonly string[];
     env?: Readonly<Record<string, string>>;
 };
+/** Script for the shipped deterministic provider substitute. */
+export type MockHarnessScript = {
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+    latencyMs?: number;
+};
 /** A non-zero exit from the oneharness subprocess. */
 export declare class OneHarnessProcessError extends Error {
     readonly exitCode: number | null;
@@ -42,6 +49,7 @@ export declare class OneHarness {
     private readonly options;
     constructor(options?: OneHarnessOptions);
     run(options: RunOptions): Promise<RunReport>;
+    runMock(harness: string, options: RunOptions, script?: MockHarnessScript): Promise<RunReport>;
     runStream(options: RunOptions): AsyncGenerator<RunStreamEnvelope>;
     list(): Promise<HarnessInfo[]>;
     detect(harnesses?: readonly string[]): Promise<Detection[]>;

package/dist/index.js

@@ -194,6 +194,24 @@ export class OneHarness {
         const value = await invokeWith(this.options, args, input.cwd, true);
         return parseContract(RunReportSchema, value, "invalid oneharness run contract");
     }
+    async runMock(harness, options, script = {}) {
+        if (harness.length === 0)
+            throw new Error("mock harness must not be empty");
+        const input = parseContract(RunOptionsSchema, options, "invalid oneharness run options");
+        const env = { ...(input.env ?? {}) };
+        if (script.stdout !== undefined)
+            env.MOCK_STDOUT = script.stdout;
+        if (script.stderr !== undefined)
+            env.MOCK_STDERR = script.stderr;
+        if (script.exitCode !== undefined)
+            env.MOCK_EXIT = String(script.exitCode);
+        if (script.latencyMs !== undefined)
+            env.MOCK_SLEEP_MS = String(script.latencyMs);
+        const args = runArguments({ ...input, harnesses: [harness], env }, false);
+        args.push("--mock-harness", harness);
+        const value = await invokeWith(this.options, args, input.cwd, true);
+        return parseContract(RunReportSchema, value, "invalid oneharness run contract");
+    }
     runStream(options) {
         const input = parseContract(RunOptionsSchema, options, "invalid oneharness run options");
         return invokeStreamWith(this.options, runArguments(input, true), RunStreamEnvelopeSchema, "invalid oneharness run stream contract", input.cwd);

package/package.json

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