@aicalas/loopy 0.1.0

package/dist/harnesses/base.js

@@ -0,0 +1,182 @@
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { sessionMismatchReason } from "../core/calls.js";
+import { isJsonValue } from "../core/wire.js";
+import { log } from "../log.js";
+export const CLEANUP_TIMEOUT_MS = 10_000;
+export class HarnessError extends Error {
+    diagnostic;
+    usage;
+    sessionId;
+    constructor(diagnostic, options = {}) {
+        super(diagnostic, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = new.target.name;
+        this.diagnostic = diagnostic;
+        this.usage = options.usage;
+        this.sessionId = options.sessionId;
+    }
+}
+export class ProviderError extends HarnessError {
+}
+export class OutcomeError extends HarnessError {
+}
+export class ValidatingHarness {
+    async run(context, signal) {
+        const adapter = this.createAdapter(context);
+        let usage;
+        try {
+            throwIfAborted(signal);
+            const turn = await adapter.start(context.prompt, context.schema, signal);
+            usage = mergeUsage(usage, turn.usage);
+            assertSessionContinuity(context.resumeSessionId, adapter.sessionId);
+            let value;
+            try {
+                value = validateTurn(turn, context.schema);
+            }
+            catch (error) {
+                if (!(error instanceof OutcomeError) || turn.sessionId === undefined)
+                    throw error;
+                const correction = "Return only one JSON value matching the required output schema. " +
+                    `Correct these validation errors: ${error.diagnostic}`;
+                const corrected = await adapter.continue(correction, context.schema, signal);
+                usage = mergeUsage(usage, corrected.usage);
+                value = validateTurn(corrected, context.schema);
+            }
+            return {
+                value,
+                ...(adapter.sessionId === undefined ? {} : { sessionId: adapter.sessionId }),
+                ...(usage === undefined ? {} : { usage }),
+            };
+        }
+        catch (error) {
+            if (signal?.aborted || isAbortError(error)) {
+                await boundedCleanup(adapter.interrupt());
+                throw abortError(signal?.reason ?? error);
+            }
+            if (error instanceof HarnessError) {
+                error.usage = mergeUsage(usage, error.usage);
+                error.sessionId ??= adapter.sessionId;
+            }
+            throw error;
+        }
+        finally {
+            await boundedCleanup(adapter.close());
+        }
+    }
+}
+/** Guards the provider behaviour of silently starting a fresh session when a resume cannot bind. */
+function assertSessionContinuity(expected, actual) {
+    if (expected === undefined)
+        return;
+    const reason = sessionMismatchReason(expected, actual);
+    if (reason !== undefined) {
+        throw new ProviderError(reason, actual === undefined ? {} : { sessionId: actual });
+    }
+}
+export function validateTurn(turn, schema) {
+    let payload = turn.payload;
+    if (payload === undefined) {
+        try {
+            payload = JSON.parse(turn.text ?? "");
+        }
+        catch (error) {
+            const message = error instanceof SyntaxError ? error.message : String(error);
+            throw new OutcomeError(`response is not JSON: ${message}`, { cause: error });
+        }
+    }
+    if (!isJsonValue(payload))
+        throw new OutcomeError("output must contain only JSON values");
+    const ajv = new Ajv2020({ allErrors: true, strict: true });
+    let validate;
+    try {
+        validate = ajv.compile(schema);
+    }
+    catch (error) {
+        throw new OutcomeError(`invalid output schema: ${errorMessage(error)}`, { cause: error });
+    }
+    if (!validate(payload)) {
+        const messages = [...(validate.errors ?? [])]
+            .sort(compareAjvErrors)
+            .map((error) => `${error.instancePath || "$"}: ${error.message ?? "invalid"}`);
+        throw new OutcomeError(messages.join("; ").slice(0, 2_000));
+    }
+    return payload;
+}
+export function mergeUsage(left, right) {
+    if (left === undefined)
+        return right === undefined ? undefined : structuredClone(right);
+    if (right === undefined)
+        return structuredClone(left);
+    const merged = structuredClone(left);
+    for (const [key, value] of Object.entries(right)) {
+        const current = merged[key];
+        if (isPlainJsonObject(current) && isPlainJsonObject(value)) {
+            merged[key] = mergeUsage(current, value) ?? {};
+        }
+        else if (typeof current === "number" && typeof value === "number") {
+            merged[key] = current + value;
+        }
+        else {
+            merged[key] = structuredClone(value);
+        }
+    }
+    return merged;
+}
+export function jsonObject(value, label) {
+    if (value === undefined || value === null)
+        return undefined;
+    let normalized;
+    try {
+        normalized = JSON.parse(JSON.stringify(value));
+    }
+    catch (error) {
+        throw new ProviderError(`${label} is not JSON serializable`, { cause: error });
+    }
+    if (typeof normalized !== "object" || normalized === null || Array.isArray(normalized)) {
+        normalized = { value: normalized };
+    }
+    return normalized;
+}
+export function isAbortError(error) {
+    return error instanceof DOMException && error.name === "AbortError";
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function boundedCleanup(operation) {
+    let timeout;
+    try {
+        await Promise.race([
+            operation,
+            new Promise((resolve) => {
+                timeout = setTimeout(() => {
+                    log.warning(`agent provider cleanup exceeded ${CLEANUP_TIMEOUT_MS / 1_000}s`);
+                    resolve();
+                }, CLEANUP_TIMEOUT_MS);
+                timeout.unref();
+            }),
+        ]);
+    }
+    catch (error) {
+        log.warning("agent provider cleanup failed", error);
+    }
+    finally {
+        if (timeout !== undefined)
+            clearTimeout(timeout);
+    }
+}
+function isPlainJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function compareAjvErrors(left, right) {
+    return (left.instancePath.localeCompare(right.instancePath) || left.keyword.localeCompare(right.keyword));
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw abortError(signal.reason);
+}
+function abortError(reason) {
+    if (isAbortError(reason))
+        return reason;
+    return new DOMException(errorMessage(reason ?? "operation aborted"), "AbortError");
+}
+//# sourceMappingURL=base.js.map

package/dist/harnesses/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/harnesses/base.ts"],"names":[],"mappings":"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"}

package/dist/harnesses/claude-executable.d.ts

@@ -0,0 +1,42 @@
+export declare const CLAUDE_EXECUTABLE_ENV = "LOOPY_CLAUDE_EXECUTABLE";
+export type LibcFamily = "glibc" | "musl";
+interface ReportHeader {
+    glibcVersionRuntime?: string;
+}
+/**
+ * Host libc family, or undefined on platforms with no glibc/musl split we care
+ * about. Mirrors the SDK's own probe (`sdk.mjs` `preferMusl`): a Linux host is
+ * musl exactly when the Node process report carries no glibc runtime version.
+ */
+export declare function detectHostLibc(report?: () => ReportHeader | undefined, platform?: NodeJS.Platform): LibcFamily | undefined;
+/**
+ * SDK platform-package binary specs for a host, most-preferred first. Mirrors
+ * the SDK's resolver: a musl host prefers the `-musl` package and falls back to
+ * the gnu one, and a glibc host the reverse, so a mismatched bundled binary is
+ * never chosen when a matching sibling package is installed.
+ */
+export declare function bundledExecutableSpecs(platform: NodeJS.Platform, arch: string, libc: LibcFamily | undefined): string[];
+export interface ExecutableProbe {
+    readonly env: NodeJS.ProcessEnv;
+    /** The SDK's default bundled native binary, or undefined when no matching platform package is installed. */
+    resolveBundled(): string | undefined;
+    /** A `claude` executable found on PATH, or undefined. */
+    discoverOnPath(): string | undefined;
+    /** Whether the executable at `path` launches on this host (`--version` exits cleanly). */
+    launches(path: string): boolean;
+}
+export interface ClaudeExecutableOptions {
+    executable_path?: string | undefined;
+}
+/**
+ * The `pathToClaudeCodeExecutable` to hand the SDK, or undefined to let the SDK
+ * resolve its own bundled binary. Priority: an explicit config override, then
+ * the `LOOPY_CLAUDE_EXECUTABLE` env override, then the SDK's bundled binary when
+ * it launches, then a `claude` discovered on PATH. An explicit or env override
+ * is trusted verbatim; auto-discovery only steps in when the bundled binary is
+ * missing or fails a launch probe.
+ */
+export declare function resolveClaudeExecutable(options: ClaudeExecutableOptions, probe?: ExecutableProbe): string | undefined;
+export declare function createExecutableProbe(): ExecutableProbe;
+export {};
+//# sourceMappingURL=claude-executable.d.ts.map

package/dist/harnesses/claude-executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-executable.d.ts","sourceRoot":"","sources":["../../src/harnesses/claude-executable.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAI/D,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C,UAAU,YAAY;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,MAAM,YAAY,GAAG,SAA+B,EAC5D,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,UAAU,GAAG,SAAS,CAKxB;AAQD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GAAG,SAAS,GAC3B,MAAM,EAAE,CAWV;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,4GAA4G;IAC5G,cAAc,IAAI,MAAM,GAAG,SAAS,CAAC;IACrC,yDAAyD;IACzD,cAAc,IAAI,MAAM,GAAG,SAAS,CAAC;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,EAChC,KAAK,GAAE,eAAyC,GAC/C,MAAM,GAAG,SAAS,CAoBpB;AAGD,wBAAgB,qBAAqB,IAAI,eAAe,CAOvD"}

package/dist/harnesses/claude-executable.js

@@ -0,0 +1,138 @@
+import { spawnSync } from "node:child_process";
+import { accessSync, constants } from "node:fs";
+import { createRequire } from "node:module";
+import { delimiter, join } from "node:path";
+import { log } from "../log.js";
+// The Claude Agent SDK bundles a single native `claude` binary per platform
+// package and only lets a caller override it via `pathToClaudeCodeExecutable`
+// (there is no env override in the SDK). When that bundled binary's libc does
+// not match the host - e.g. a musl-linked binary on a glibc host - it fails to
+// launch and halts the whole instance at the first `claude` step. This module
+// determines the host libc and picks a launchable executable so the harness is
+// usable on any host. See issue #27.
+export const CLAUDE_EXECUTABLE_ENV = "LOOPY_CLAUDE_EXECUTABLE";
+const SDK_PACKAGE = "@anthropic-ai/claude-agent-sdk";
+const LAUNCH_TIMEOUT_MS = 10_000;
+/**
+ * Host libc family, or undefined on platforms with no glibc/musl split we care
+ * about. Mirrors the SDK's own probe (`sdk.mjs` `preferMusl`): a Linux host is
+ * musl exactly when the Node process report carries no glibc runtime version.
+ */
+export function detectHostLibc(report = defaultReportHeader, platform = process.platform) {
+    if (platform !== "linux")
+        return undefined;
+    const header = report();
+    if (header === undefined)
+        return undefined;
+    return header.glibcVersionRuntime === undefined ? "musl" : "glibc";
+}
+/* istanbul ignore next -- thin process.report boundary; detectHostLibc is tested with an injected report */
+function defaultReportHeader() {
+    if (typeof process.report?.getReport !== "function")
+        return undefined;
+    return process.report.getReport().header;
+}
+/**
+ * SDK platform-package binary specs for a host, most-preferred first. Mirrors
+ * the SDK's resolver: a musl host prefers the `-musl` package and falls back to
+ * the gnu one, and a glibc host the reverse, so a mismatched bundled binary is
+ * never chosen when a matching sibling package is installed.
+ */
+export function bundledExecutableSpecs(platform, arch, libc) {
+    const suffix = platform === "win32" ? ".exe" : "";
+    const packages = platform === "android"
+        ? [`${SDK_PACKAGE}-linux-${arch}-android`]
+        : platform === "linux"
+            ? libc === "musl"
+                ? [`${SDK_PACKAGE}-linux-${arch}-musl`, `${SDK_PACKAGE}-linux-${arch}`]
+                : [`${SDK_PACKAGE}-linux-${arch}`, `${SDK_PACKAGE}-linux-${arch}-musl`]
+            : [`${SDK_PACKAGE}-${platform}-${arch}`];
+    return packages.map((pkg) => `${pkg}/claude${suffix}`);
+}
+/**
+ * The `pathToClaudeCodeExecutable` to hand the SDK, or undefined to let the SDK
+ * resolve its own bundled binary. Priority: an explicit config override, then
+ * the `LOOPY_CLAUDE_EXECUTABLE` env override, then the SDK's bundled binary when
+ * it launches, then a `claude` discovered on PATH. An explicit or env override
+ * is trusted verbatim; auto-discovery only steps in when the bundled binary is
+ * missing or fails a launch probe.
+ */
+export function resolveClaudeExecutable(options, probe = createExecutableProbe()) {
+    if (options.executable_path !== undefined)
+        return options.executable_path;
+    const override = probe.env[CLAUDE_EXECUTABLE_ENV]?.trim();
+    if (override !== undefined && override !== "")
+        return override;
+    const bundled = probe.resolveBundled();
+    if (bundled !== undefined && probe.launches(bundled))
+        return bundled;
+    const discovered = probe.discoverOnPath();
+    if (discovered !== undefined && probe.launches(discovered)) {
+        log.info(bundled === undefined
+            ? `claude harness: no bundled SDK binary for this host; using ${discovered} from PATH`
+            : `claude harness: bundled SDK binary ${bundled} failed to launch; using ${discovered} from PATH`);
+        return discovered;
+    }
+    // Nothing better than the SDK default; let the SDK resolve and, if the
+    // bundled binary cannot launch, surface its own libc-mismatch diagnostic.
+    return undefined;
+}
+/* istanbul ignore next -- production process/filesystem wiring; resolveClaudeExecutable is tested with injected probes */
+export function createExecutableProbe() {
+    return {
+        env: process.env,
+        resolveBundled: () => resolveBundledExecutable(),
+        discoverOnPath: () => discoverOnPath("claude"),
+        launches: (path) => launches(path),
+    };
+}
+/* istanbul ignore next -- resolves against installed SDK platform packages; exercised only in production installs */
+function resolveBundledExecutable(platform = process.platform, arch = process.arch, libc = detectHostLibc()) {
+    let requireFromSdk;
+    try {
+        // Anchor at the SDK package so pnpm's nested platform packages resolve the
+        // same way the SDK's own resolver reaches them.
+        const requireFromHere = createRequire(import.meta.url);
+        requireFromSdk = createRequire(requireFromHere.resolve(SDK_PACKAGE));
+    }
+    catch {
+        return undefined;
+    }
+    for (const spec of bundledExecutableSpecs(platform, arch, libc)) {
+        try {
+            return requireFromSdk.resolve(spec);
+        }
+        catch {
+            // Try the next candidate package.
+        }
+    }
+    return undefined;
+}
+/* istanbul ignore next -- production PATH walk; discovery is exercised through injected probes */
+function discoverOnPath(name, env = process.env, platform = process.platform) {
+    const directories = (env.PATH ?? "").split(delimiter).filter((entry) => entry !== "");
+    const candidates = platform === "win32" ? [`${name}.exe`, `${name}.cmd`, name] : [name];
+    for (const directory of directories) {
+        for (const candidate of candidates) {
+            const full = join(directory, candidate);
+            try {
+                accessSync(full, constants.X_OK);
+                return full;
+            }
+            catch {
+                // Not an executable here; keep looking.
+            }
+        }
+    }
+    return undefined;
+}
+/* istanbul ignore next -- spawns a real process; resolveClaudeExecutable is tested with an injected launch probe */
+function launches(path, run = spawnSync) {
+    const result = run(path, ["--version"], {
+        timeout: LAUNCH_TIMEOUT_MS,
+        windowsHide: true,
+        stdio: "ignore",
+    });
+    return result.error === undefined && result.status === 0;
+}
+//# sourceMappingURL=claude-executable.js.map

package/dist/harnesses/claude-executable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-executable.js","sourceRoot":"","sources":["../../src/harnesses/claude-executable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,qCAAqC;AAErC,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAC/D,MAAM,WAAW,GAAG,gCAAgC,CAAC;AACrD,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAQjC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAM,GAAmC,mBAAmB,EAC5D,QAAQ,GAAoB,OAAO,CAAC,QAAQ;IAE5C,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,MAAM,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AACrE,CAAC;AAED,4GAA4G;AAC5G,SAAS,mBAAmB;IAC1B,IAAI,OAAO,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACtE,OAAQ,OAAO,CAAC,MAAM,CAAC,SAAS,EAAgC,CAAC,MAAM,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAyB,EACzB,IAAY,EACZ,IAA4B;IAE5B,MAAM,MAAM,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,MAAM,QAAQ,GACZ,QAAQ,KAAK,SAAS;QACpB,CAAC,CAAC,CAAC,GAAG,WAAW,UAAU,IAAI,UAAU,CAAC;QAC1C,CAAC,CAAC,QAAQ,KAAK,OAAO;YACpB,CAAC,CAAC,IAAI,KAAK,MAAM;gBACf,CAAC,CAAC,CAAC,GAAG,WAAW,UAAU,IAAI,OAAO,EAAE,GAAG,WAAW,UAAU,IAAI,EAAE,CAAC;gBACvE,CAAC,CAAC,CAAC,GAAG,WAAW,UAAU,IAAI,EAAE,EAAE,GAAG,WAAW,UAAU,IAAI,OAAO,CAAC;YACzE,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,UAAU,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC;AAgBD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAgC,EAChC,KAAK,GAAoB,qBAAqB,EAAE;IAEhD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,eAAe,CAAC;IAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAE/D,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;IACvC,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAErE,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;IAC1C,IAAI,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CACN,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,8DAA8D,UAAU,YAAY;YACtF,CAAC,CAAC,sCAAsC,OAAO,4BAA4B,UAAU,YAAY,CACpG,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,uEAAuE;IACvE,0EAA0E;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,0HAA0H;AAC1H,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,GAAG,EAAE,CAAC,wBAAwB,EAAE;QAChD,cAAc,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,qHAAqH;AACrH,SAAS,wBAAwB,CAC/B,QAAQ,GAAoB,OAAO,CAAC,QAAQ,EAC5C,IAAI,GAAW,OAAO,CAAC,IAAI,EAC3B,IAAI,GAA2B,cAAc,EAAE;IAE/C,IAAI,cAA2B,CAAC;IAChC,IAAI,CAAC;QACH,2EAA2E;QAC3E,gDAAgD;QAChD,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,cAAc,GAAG,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,sBAAsB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC;YACH,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kGAAkG;AAClG,SAAS,cAAc,CACrB,IAAY,EACZ,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,QAAQ,GAAoB,OAAO,CAAC,QAAQ;IAE5C,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxF,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QACpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACxC,IAAI,CAAC;gBACH,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oHAAoH;AACpH,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAG,GAAqB,SAAS;IAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE;QACtC,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,IAAI;QACjB,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/dist/harnesses/claude.d.ts

@@ -0,0 +1,35 @@
+import { query as claudeQuery } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod";
+import type { HarnessContext, HarnessSpec } from "../adapters.js";
+import { type Adapter, ValidatingHarness } from "./base.js";
+export declare const claudeOptionsSchema: z.ZodObject<{
+    isolated: z.ZodDefault<z.ZodBoolean>;
+    permission_mode: z.ZodOptional<z.ZodEnum<{
+        acceptEdits: "acceptEdits";
+        auto: "auto";
+        bypassPermissions: "bypassPermissions";
+        default: "default";
+        dontAsk: "dontAsk";
+        plan: "plan";
+    }>>;
+    model: z.ZodString;
+    model_effort: z.ZodEnum<{
+        high: "high";
+        low: "low";
+        max: "max";
+        medium: "medium";
+        xhigh: "xhigh";
+    }>;
+    executable_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ClaudeOptions = z.infer<typeof claudeOptionsSchema>;
+export type ClaudeQueryFactory = typeof claudeQuery;
+export declare class ClaudeHarness extends ValidatingHarness {
+    readonly options: ClaudeOptions;
+    private readonly queryFactory;
+    private readonly executable;
+    constructor(options: ClaudeOptions, queryFactory?: ClaudeQueryFactory, executable?: string);
+    protected createAdapter(context: HarnessContext): Adapter;
+}
+export declare const claudeHarnessSpec: HarnessSpec;
+//# sourceMappingURL=claude.d.ts.map

package/dist/harnesses/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/harnesses/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,WAAW,EAKrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,KAAK,OAAO,EAMZ,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAGnB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;kBAYrB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,OAAO,WAAW,CAAC;AAEpD,qBAAa,aAAc,SAAQ,iBAAiB;IAClD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,YACE,OAAO,EAAE,aAAa,EAEtB,YAAY,GAAE,kBAAgC,EAC9C,UAAU,CAAC,EAAE,MAAM,EAMpB;IAED,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAExD;CACF;AAsID,eAAO,MAAM,iBAAiB,EAAE,WAO/B,CAAC"}

package/dist/harnesses/claude.js

@@ -0,0 +1,160 @@
+import { query as claudeQuery, } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod";
+import { errorMessage, isAbortError, jsonObject, ProviderError, ValidatingHarness, } from "./base.js";
+import { resolveClaudeExecutable } from "./claude-executable.js";
+export const claudeOptionsSchema = z
+    .object({
+    isolated: z.boolean().default(false),
+    permission_mode: z
+        .enum(["default", "acceptEdits", "plan", "bypassPermissions", "dontAsk", "auto"])
+        .optional(),
+    model: z.string().min(1),
+    model_effort: z.enum(["low", "medium", "high", "xhigh", "max"]),
+    // Override the SDK's bundled native binary when its libc does not match the
+    // host; auto-discovered from PATH when omitted. See claude-executable.ts.
+    executable_path: z.string().min(1).optional(),
+})
+    .strict();
+export class ClaudeHarness extends ValidatingHarness {
+    options;
+    queryFactory;
+    executable;
+    constructor(options, 
+    /* istanbul ignore next -- production SDK wiring; tests inject a deterministic stream */
+    queryFactory = claudeQuery, executable) {
+        super();
+        this.options = options;
+        this.queryFactory = queryFactory;
+        this.executable = executable;
+    }
+    createAdapter(context) {
+        return new ClaudeAdapter(context, this.options, this.queryFactory, this.executable);
+    }
+}
+class ClaudeAdapter {
+    sessionId;
+    currentQuery;
+    currentController;
+    context;
+    options;
+    queryFactory;
+    executable;
+    constructor(context, options, queryFactory, executable) {
+        this.context = context;
+        this.options = options;
+        this.queryFactory = queryFactory;
+        this.executable = executable;
+    }
+    start(prompt, schema, signal) {
+        return this.runQuery(prompt, schema, signal, this.context.resumeSessionId);
+    }
+    continue(prompt, schema, signal) {
+        /* istanbul ignore next -- ValidatingHarness only corrects turns carrying this session id */
+        if (this.sessionId === undefined) {
+            throw new ProviderError("Claude returned no session id for correction");
+        }
+        return this.runQuery(prompt, schema, signal, this.sessionId);
+    }
+    async interrupt() {
+        this.currentController?.abort();
+        this.currentQuery?.close();
+    }
+    async close() {
+        this.currentQuery?.close();
+        this.currentQuery = undefined;
+        this.currentController = undefined;
+    }
+    async runQuery(prompt, schema, signal, resume) {
+        const controller = new AbortController();
+        this.currentController = controller;
+        const onAbort = () => controller.abort(signal?.reason);
+        signal?.addEventListener("abort", onAbort, { once: true });
+        // Inherit on-disk config (~/.claude, project settings) unless the harness is isolated.
+        const settingSources = this.options.isolated
+            ? []
+            : ["user", "project", "local"];
+        const options = {
+            abortController: controller,
+            cwd: this.context.workspace,
+            outputFormat: { type: "json_schema", schema: withoutSchemaDialect(schema) },
+            settingSources,
+            model: this.options.model,
+            effort: this.options.model_effort,
+        };
+        if (this.options.permission_mode !== undefined) {
+            options.permissionMode = this.options.permission_mode;
+            options.allowDangerouslySkipPermissions =
+                this.options.permission_mode === "bypassPermissions";
+        }
+        else if (this.options.isolated) {
+            // Sealed and unspecified: never block on prompts an operator cannot answer.
+            options.permissionMode = "bypassPermissions";
+            options.allowDangerouslySkipPermissions = true;
+        }
+        if (resume !== undefined)
+            options.resume = resume;
+        if (this.executable !== undefined)
+            options.pathToClaudeCodeExecutable = this.executable;
+        const stream = this.queryFactory({ prompt, options });
+        this.currentQuery = stream;
+        let result;
+        try {
+            for await (const message of stream) {
+                if (message.type === "result")
+                    result = message;
+            }
+        }
+        catch (error) {
+            if (controller.signal.aborted || signal?.aborted || isAbortError(error))
+                throw error;
+            throw new ProviderError(`Claude failed: ${errorMessage(error)}`.slice(0, 2_000), {
+                cause: error,
+            });
+        }
+        finally {
+            signal?.removeEventListener("abort", onAbort);
+            this.currentQuery = undefined;
+            this.currentController = undefined;
+        }
+        if (result === undefined)
+            throw new ProviderError("Claude returned no terminal result");
+        this.sessionId = result.session_id;
+        const usage = jsonObject({
+            tokens: result.usage,
+            models: result.modelUsage,
+            cost_usd: result.total_cost_usd,
+        }, "Claude usage");
+        if (result.subtype !== "success") {
+            const diagnostic = result.errors.join("; ") || result.stop_reason || "provider error";
+            throw new ProviderError(`Claude failed: ${diagnostic}`.slice(0, 2_000), usage === undefined ? {} : { usage });
+        }
+        const turn = {
+            text: result.result,
+            sessionId: result.session_id,
+        };
+        if (result.structured_output !== undefined)
+            turn.payload = result.structured_output;
+        if (usage !== undefined)
+            turn.usage = usage;
+        return turn;
+    }
+}
+// Claude Code's `--json-schema` validator rejects a `$schema` dialect reference it cannot
+// resolve (e.g. "https://json-schema.org/draft/2020-12/schema", which every loopy outcome
+// schema declares), so drop the meta key before handing the schema to the SDK. The harness
+// boundary still validates the returned outcome against the original schema with Ajv.
+function withoutSchemaDialect(schema) {
+    if (!Object.hasOwn(schema, "$schema"))
+        return schema;
+    const { $schema: _dialect, ...rest } = schema;
+    return rest;
+}
+export const claudeHarnessSpec = {
+    name: "claude",
+    optionsSchema: claudeOptionsSchema,
+    create(options) {
+        const parsed = claudeOptionsSchema.parse(options);
+        return new ClaudeHarness(parsed, undefined, resolveClaudeExecutable(parsed));
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/harnesses/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/harnesses/claude.ts"],"names":[],"mappings":"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"}

package/dist/harnesses/codex.d.ts

@@ -0,0 +1,40 @@
+import { type Thread, type ThreadOptions } from "@openai/codex-sdk";
+import { z } from "zod";
+import type { HarnessContext, HarnessSpec } from "../adapters.js";
+import { type Adapter, ValidatingHarness } from "./base.js";
+export declare const codexOptionsSchema: z.ZodObject<{
+    isolated: z.ZodDefault<z.ZodBoolean>;
+    sandbox: z.ZodOptional<z.ZodEnum<{
+        "full-access": "full-access";
+        "read-only": "read-only";
+        "workspace-write": "workspace-write";
+    }>>;
+    approval_mode: z.ZodOptional<z.ZodEnum<{
+        auto_review: "auto_review";
+        deny_all: "deny_all";
+    }>>;
+    model: z.ZodString;
+    model_effort: z.ZodEnum<{
+        high: "high";
+        low: "low";
+        medium: "medium";
+        minimal: "minimal";
+        none: "none";
+        xhigh: "xhigh";
+    }>;
+}, z.core.$strict>;
+export type CodexOptions = z.infer<typeof codexOptionsSchema>;
+interface CodexClient {
+    startThread(options?: ThreadOptions): Thread;
+    resumeThread(id: string, options?: ThreadOptions): Thread;
+}
+export type CodexFactory = () => CodexClient;
+export declare class CodexHarness extends ValidatingHarness {
+    readonly options: CodexOptions;
+    private readonly clientFactory;
+    constructor(options: CodexOptions, clientFactory?: CodexFactory);
+    protected createAdapter(context: HarnessContext): Adapter;
+}
+export declare const codexHarnessSpec: HarnessSpec;
+export {};
+//# sourceMappingURL=codex.d.ts.map

package/dist/harnesses/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/harnesses/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,KAAK,OAAO,EAMZ,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;kBAQpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,UAAU,WAAW;IACnB,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7C,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;CAC3D;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC;AAE7C,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,YACE,OAAO,EAAE,YAAY,EAErB,aAAa,GAAE,YAAgC,EAKhD;IAED,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAExD;CACF;AA2FD,eAAO,MAAM,gBAAgB,EAAE,WAM9B,CAAC"}