@oneharness/sdk 0.4.5 → 0.5.0

package/dist/generated/zod.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 import type { ActionEvent, BatchReport, FailureKind, FallThrough, FallbackReport, OutputFormat, RunReport, RunResult, SessionReport, Status, ToolCallStatus, Usage } from "./contracts.js";
 import type { DetectInfo, DetectReport } from "./detection.js";
 import type { HistoryRecord } from "./history.js";
+import type { HistoryLine } from "./history-line.js";
 import type { HistoryList, HistorySessionSummary } from "./history-list.js";
 import type { HistoryListOptions } from "./history-list-options.js";
 import type { HistoryLookup, HistoryLookupByLast, HistoryLookupBySession } from "./history-lookup.js";
@@ -24,6 +25,7 @@ export declare const FallThroughSchema: z.ZodType<FallThrough>;
 export declare const FallbackReportSchema: z.ZodType<FallbackReport>;
 export declare const HarnessInfoSchema: z.ZodType<HarnessInfo>;
 export declare const HistoryLabelsSchema: z.ZodType<HistoryLabels>;
+export declare const HistoryLineSchema: z.ZodType<HistoryLine>;
 export declare const HistoryListSchema: z.ZodType<HistoryList>;
 export declare const HistoryListOptionsSchema: z.ZodType<HistoryListOptions>;
 export declare const HistoryLookupSchema: z.ZodType<HistoryLookup>;

package/dist/generated/zod.js

@@ -90,6 +90,215 @@ export const HistoryLabelsSchema = z.record(z
     .refine((value) => !new RegExp("[\\u0000-\\u001f\\u007f-\\u009f]", "u").test(value), {
     message: "Invalid string: must not contain [\\u0000-\\u001f\\u007f-\\u009f]",
 }));
+export const HistoryLineSchema = z.union([
+    z.looseObject({
+        event: z
+            .union([
+            z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
+                duration_ms: z
+                    .int()
+                    .gte(0)
+                    .refine((value) => value !== undefined, { message: "Required" }),
+                finished_at: z.string().refine((value) => value !== undefined, { message: "Required" }),
+                kind: z.literal("tool_call").refine((value) => value !== undefined, { message: "Required" }),
+                started_at: z.string().refine((value) => value !== undefined, { message: "Required" }),
+                status: z.literal("completed").refine((value) => value !== undefined, { message: "Required" }),
+                tool_call_id: z
+                    .string()
+                    .min(1)
+                    .refine((value) => value !== undefined, { message: "Required" }),
+            })),
+            z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
+                duration_ms: z
+                    .int()
+                    .gte(0)
+                    .refine((value) => value !== undefined, { message: "Required" }),
+                finished_at: z.string().refine((value) => value !== undefined, { message: "Required" }),
+                kind: z.literal("tool_call").refine((value) => value !== undefined, { message: "Required" }),
+                started_at: z.string().refine((value) => value !== undefined, { message: "Required" }),
+                status: z.literal("failed").refine((value) => value !== undefined, { message: "Required" }),
+                tool_call_id: z
+                    .string()
+                    .min(1)
+                    .refine((value) => value !== undefined, { message: "Required" }),
+            })),
+            z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
+                kind: z.literal("tool_call").refine((value) => value !== undefined, { message: "Required" }),
+                started_at: z.string().refine((value) => value !== undefined, { message: "Required" }),
+                status: z.literal("timeout").refine((value) => value !== undefined, { message: "Required" }),
+                tool_call_id: z
+                    .string()
+                    .min(1)
+                    .refine((value) => value !== undefined, { message: "Required" }),
+            })),
+            z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
+                kind: z.literal("tool_call").refine((value) => value !== undefined, { message: "Required" }),
+                started_at: z.string().refine((value) => value !== undefined, { message: "Required" }),
+                status: z.literal("interrupted").refine((value) => value !== undefined, { message: "Required" }),
+                tool_call_id: z
+                    .string()
+                    .min(1)
+                    .refine((value) => value !== undefined, { message: "Required" }),
+            })),
+            z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
+                kind: z
+                    .string()
+                    .refine((value) => !new RegExp("^tool_call$", "u").test(value), {
+                    message: "Invalid string: must not contain ^tool_call$",
+                })
+                    .optional(),
+            })),
+        ])
+            .refine((value) => value !== undefined, { message: "Required" }),
+        harness: z.string().refine((value) => value !== undefined, { message: "Required" }),
+        run_id: z
+            .string()
+            .min(36)
+            .regex(new RegExp("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "u"))
+            .refine((value) => [...value].length <= 36, { message: "Too long: expected at most 36 characters" })
+            .refine((value) => value !== undefined, { message: "Required" }),
+        schema_version: z.literal("1.0").refine((value) => value !== undefined, { message: "Required" }),
+        type: z.literal("event").refine((value) => value !== undefined, { message: "Required" }),
+    }),
+    z.union([
+        z.looseObject({
+            duration_ms: z
+                .int()
+                .gte(0)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            exit_code: z.union([z.int(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            failure_kind: z
+                .union([z.lazy(() => FailureKindSchema), z.null()])
+                .refine((value) => value !== undefined, { message: "Required" }),
+            finished_at: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            harness: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            history_id: z
+                .string()
+                .min(36)
+                .regex(new RegExp("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "u"))
+                .refine((value) => [...value].length <= 36, { message: "Too long: expected at most 36 characters" })
+                .refine((value) => value !== undefined, { message: "Required" }),
+            labels: z.lazy(() => HistoryLabelsSchema).optional(),
+            model: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            model_ms: z
+                .int()
+                .gte(0)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            name: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            permission_mode: z
+                .lazy(() => PermissionModeSchema)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            project: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            schema_version: z.literal("1.0").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" }),
+            started_at: z
+                .string()
+                .min(1)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            status: z
+                .union([z.literal("ok"), z.literal("nonzero")])
+                .refine((value) => value !== undefined, { message: "Required" }),
+            text: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            text_source: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            time_to_first_token_ms: z.union([z.int().gte(0), z.null()]).optional(),
+            timestamp: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            tool_ms: z
+                .int()
+                .gte(0)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            type: z.literal("run").refine((value) => value !== undefined, { message: "Required" }),
+            usage: z.lazy(() => UsageSchema).refine((value) => value !== undefined, { message: "Required" }),
+        }),
+        z.looseObject({
+            duration_ms: z
+                .int()
+                .gte(0)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            exit_code: z.union([z.int(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            failure_kind: z
+                .union([z.lazy(() => FailureKindSchema), z.null()])
+                .refine((value) => value !== undefined, { message: "Required" }),
+            finished_at: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            harness: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            history_id: z
+                .string()
+                .min(36)
+                .regex(new RegExp("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "u"))
+                .refine((value) => [...value].length <= 36, { message: "Too long: expected at most 36 characters" })
+                .refine((value) => value !== undefined, { message: "Required" }),
+            labels: z.lazy(() => HistoryLabelsSchema).optional(),
+            model: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            model_ms: z
+                .int()
+                .gte(0)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            name: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            permission_mode: z
+                .lazy(() => PermissionModeSchema)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            project: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            schema_version: z.literal("1.0").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" }),
+            started_at: z
+                .string()
+                .min(1)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            status: z
+                .union([z.literal("timeout"), z.literal("spawn_error"), z.literal("skipped"), z.literal("planned")])
+                .refine((value) => value !== undefined, { message: "Required" }),
+            text: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            text_source: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            time_to_first_token_ms: z.union([z.int().gte(0), z.null()]).optional(),
+            timestamp: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            tool_ms: z
+                .int()
+                .gte(0)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            type: z.literal("run").refine((value) => value !== undefined, { message: "Required" }),
+            usage: z.lazy(() => UsageSchema).refine((value) => value !== undefined, { message: "Required" }),
+        }),
+        z.looseObject({
+            duration_ms: z.union([z.int().gte(0), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            exit_code: z.union([z.int(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            failure_kind: z
+                .union([z.lazy(() => FailureKindSchema), z.null()])
+                .refine((value) => value !== undefined, { message: "Required" }),
+            finished_at: z.null().refine((value) => value !== undefined, { message: "Required" }),
+            harness: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            history_id: z
+                .string()
+                .min(36)
+                .regex(new RegExp("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "u"))
+                .refine((value) => [...value].length <= 36, { message: "Too long: expected at most 36 characters" })
+                .refine((value) => value !== undefined, { message: "Required" }),
+            labels: z.lazy(() => HistoryLabelsSchema).optional(),
+            model: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            model_ms: z.never().optional(),
+            name: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            permission_mode: z
+                .lazy(() => PermissionModeSchema)
+                .refine((value) => value !== undefined, { message: "Required" }),
+            project: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            schema_version: z.literal("1.0").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" }),
+            started_at: z.never().optional(),
+            status: z.lazy(() => StatusSchema).refine((value) => value !== undefined, { message: "Required" }),
+            text: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            text_source: z.union([z.string(), z.null()]).refine((value) => value !== undefined, { message: "Required" }),
+            time_to_first_token_ms: z.never().optional(),
+            timestamp: z.string().refine((value) => value !== undefined, { message: "Required" }),
+            tool_ms: z.never().optional(),
+            type: z.literal("run").refine((value) => value !== undefined, { message: "Required" }),
+            usage: z.lazy(() => UsageSchema).refine((value) => value !== undefined, { message: "Required" }),
+        }),
+    ]),
+]);
 export const HistoryListSchema = z.array(z.lazy(() => HistorySessionSummarySchema));
 export const HistoryListOptionsSchema = z.strictObject({
     allProjects: z.boolean().optional(),
@@ -201,7 +410,7 @@ export const HistoryRecordSchema = z.union([
         permission_mode: z.lazy(() => PermissionModeSchema).refine((value) => value !== undefined, { message: "Required" }),
         project: z.string().refine((value) => value !== undefined, { message: "Required" }),
         prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
-        schema_version: z.literal("0.3").refine((value) => value !== undefined, { message: "Required" }),
+        schema_version: z.literal("1.0").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" }),
         started_at: z
@@ -260,7 +469,7 @@ export const HistoryRecordSchema = z.union([
         permission_mode: z.lazy(() => PermissionModeSchema).refine((value) => value !== undefined, { message: "Required" }),
         project: z.string().refine((value) => value !== undefined, { message: "Required" }),
         prompt: z.string().refine((value) => value !== undefined, { message: "Required" }),
-        schema_version: z.literal("0.3").refine((value) => value !== undefined, { message: "Required" }),
+        schema_version: z.literal("1.0").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" }),
         started_at: z.never().optional(),

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import type { RunStreamEnvelope } from "./generated/run-stream-envelope.js";
 export type { ActionEvent, BatchReport, FailureKind, FallbackReport, FallThrough, OutputFormat, RunReport, RunResult, SessionReport, Status, Usage, } from "./generated/contracts.js";
 export type { DetectInfo, DetectReport } from "./generated/detection.js";
 export type { HistoryRecord } from "./generated/history.js";
+export type { HistoryLine } from "./generated/history-line.js";
 export type { HistoryList, HistorySessionSummary, } from "./generated/history-list.js";
 export type { HistoryListOptions } from "./generated/history-list-options.js";
 export type { HistoryLookup, HistoryLookupByLast, HistoryLookupBySession, } from "./generated/history-lookup.js";
@@ -28,6 +29,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 +50,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.5",
+  "version": "0.5.0",
   "description": "Typed Node.js SDK for oneharness",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "oneharness-cli": "0.4.5",
+    "oneharness-cli": "0.5.0",
     "zod": "^4.4.3"
   }
 }