@clowder-ai/plugin-contract 0.1.0-beta.1 → 0.1.0-beta.10

package/dist/conformance/stdio-harness/child-process-harness.js

@@ -0,0 +1,296 @@
+import {} from 'node:child_process';
+import { createDirectTargetLifecycle, spawnHarnessProcess, spawnHarnessProcessWithAdapter, } from './harness-process-spawn.js';
+import { NdjsonFrameDecoder, encodeNdjsonFrame, } from './ndjson-frame.js';
+import { createNodeProcessTreeRuntime } from './node-process-tree-runtime.js';
+import { HarnessCleanupError, ProcessTreeController, } from './process-tree-controller.js';
+export { HarnessCleanupError } from './process-tree-controller.js';
+export const MAX_HARNESS_QUEUED_FRAMES = 16;
+/**
+ * Node.js setTimeout uses a 32-bit signed integer internally.
+ * Values above 2^31-1 (2_147_483_647) are silently clamped to 1ms,
+ * making the timer fire immediately — a correctness hazard.
+ */
+export const MAX_TIMER_MS = 2_147_483_647;
+function assertTimerMs(value, name) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new RangeError(`${name} must be a positive safe integer`);
+    }
+    if (value > MAX_TIMER_MS) {
+        throw new RangeError(`${name} must not exceed ${MAX_TIMER_MS}ms (Node timer overflow ceiling)`);
+    }
+}
+function assertTimerMsNonNegative(value, name) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new RangeError(`${name} must be a non-negative safe integer`);
+    }
+    if (value > MAX_TIMER_MS) {
+        throw new RangeError(`${name} must not exceed ${MAX_TIMER_MS}ms (Node timer overflow ceiling)`);
+    }
+}
+const HARNESS_CLEANUP_TIMEOUT_MS = 1_000;
+const HARNESS_CLEANUP_PROBE_INTERVAL_MS = 5;
+const TASKKILL_TIMEOUT_MS = 500;
+const TARGET_EXIT_GRACE_MS = 500;
+export class HarnessTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HarnessTimeoutError';
+    }
+}
+export class HarnessChildExitedError extends Error {
+    exit;
+    constructor(exit) {
+        super(`harness child exited before another frame was available (code=${String(exit.code)}, signal=${String(exit.signal)})`);
+        this.exit = exit;
+        this.name = 'HarnessChildExitedError';
+    }
+}
+export class HarnessFrameBacklogError extends Error {
+    maxQueuedFrames;
+    constructor(maxQueuedFrames = MAX_HARNESS_QUEUED_FRAMES) {
+        super(`decoded child frame backlog exceeded ${maxQueuedFrames} queued frames`);
+        this.maxQueuedFrames = maxQueuedFrames;
+        this.name = 'HarnessFrameBacklogError';
+    }
+}
+export class HarnessChild {
+    child;
+    pid;
+    decoder = new NdjsonFrameDecoder();
+    frames = [];
+    waiters = [];
+    exitPromise;
+    processTree;
+    resolveExit;
+    exit;
+    streamsClosed = false;
+    stopPromise;
+    constructor(child, target = createDirectTargetLifecycle(child), runtime = createNodeProcessTreeRuntime(process.platform, target.signalTarget)) {
+        this.child = child;
+        this.pid = child.pid;
+        this.processTree = new ProcessTreeController(this.pid, runtime);
+        this.exitPromise = new Promise((resolve) => {
+            this.resolveExit = resolve;
+        });
+        child.stdout.on('data', (chunk) => {
+            try {
+                for (const frame of this.decoder.push(chunk)) {
+                    this.enqueue(frame);
+                }
+            }
+            catch (error) {
+                this.failAndKill(error);
+            }
+        });
+        child.stdout.on('end', () => {
+            if (harnessFatalErrors.has(this)) {
+                return;
+            }
+            try {
+                for (const frame of this.decoder.end()) {
+                    this.enqueue(frame);
+                }
+            }
+            catch (error) {
+                this.failAndKill(error);
+            }
+        });
+        child.stdin.on('error', (error) => this.failAndKill(error));
+        child.stdout.on('error', (error) => this.failAndKill(error));
+        child.stderr.on('error', (error) => this.failAndKill(error));
+        target.onTargetError((error) => this.failAndKill(error));
+        child.stderr.resume();
+        const recordExit = (code, signal) => {
+            if (this.exit === undefined) {
+                this.exit = { code, signal };
+                this.processTree.markTargetExited();
+                this.resolveExit(this.exit);
+            }
+            return this.exit;
+        };
+        target.onTargetExit(recordExit);
+        child.once('close', (code, signal) => {
+            const exit = recordExit(code, signal);
+            this.streamsClosed = true;
+            this.processTree.markStreamsClosed();
+            if (!harnessFatalErrors.has(this)) {
+                this.rejectWaiters(new HarnessChildExitedError(exit));
+            }
+        });
+        this.processTree.markRunning();
+    }
+    async send(frame) {
+        this.assertRunning();
+        const encoded = encodeNdjsonFrame(frame);
+        await new Promise((resolve, reject) => {
+            this.child.stdin.write(encoded, (error) => {
+                if (error === null || error === undefined) {
+                    resolve();
+                }
+                else {
+                    reject(error);
+                }
+            });
+        });
+    }
+    async receive(options) {
+        assertTimerMs(options.timeoutMs, 'receive timeoutMs');
+        const frame = this.frames.shift();
+        if (frame !== undefined) {
+            return frame;
+        }
+        const fatalError = harnessFatalErrors.get(this);
+        if (fatalError !== undefined) {
+            throw fatalError;
+        }
+        if (this.streamsClosed && this.exit !== undefined) {
+            throw new HarnessChildExitedError(this.exit);
+        }
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    const index = this.waiters.indexOf(waiter);
+                    if (index !== -1) {
+                        this.waiters.splice(index, 1);
+                    }
+                    reject(new HarnessTimeoutError(`timed out after ${options.timeoutMs}ms waiting for child frame`));
+                }, options.timeoutMs),
+            };
+            this.waiters.push(waiter);
+        });
+    }
+    kill(signal = 'SIGKILL') {
+        this.processTree.requestTermination(signal);
+        if (signal === 'SIGKILL') {
+            void this.startReap();
+        }
+    }
+    waitForExit() {
+        return this.exitPromise;
+    }
+    async stop(terminateGraceMs = 100) {
+        assertTimerMsNonNegative(terminateGraceMs, 'terminateGraceMs');
+        this.stopPromise ??= this.stopOnce(terminateGraceMs);
+        return await this.stopPromise;
+    }
+    async stopOnce(terminateGraceMs) {
+        this.child.stdin.end();
+        this.processTree.requestTermination('SIGTERM');
+        await new Promise((resolve) => {
+            const timer = setTimeout(resolve, terminateGraceMs);
+            this.exitPromise.then(() => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+        this.processTree.requestTermination('SIGKILL');
+        await this.startReap();
+        return await this.exitPromise;
+    }
+    assertRunning() {
+        const fatalError = harnessFatalErrors.get(this);
+        if (fatalError !== undefined) {
+            throw fatalError;
+        }
+        if (this.exit !== undefined) {
+            throw new HarnessChildExitedError(this.exit);
+        }
+    }
+    enqueue(frame) {
+        const waiter = this.waiters.shift();
+        if (waiter === undefined) {
+            if (this.frames.length >= MAX_HARNESS_QUEUED_FRAMES) {
+                throw new HarnessFrameBacklogError();
+            }
+            this.frames.push(frame);
+            return;
+        }
+        clearTimeout(waiter.timer);
+        waiter.resolve(frame);
+    }
+    fail(error, discardQueuedFrames = false) {
+        if (harnessFatalErrors.has(this)) {
+            if (discardQueuedFrames) {
+                this.frames.splice(0);
+            }
+            return;
+        }
+        harnessFatalErrors.set(this, error);
+        if (discardQueuedFrames) {
+            this.frames.splice(0);
+        }
+        this.rejectWaiters(error);
+    }
+    rejectWaiters(error) {
+        for (const waiter of this.waiters.splice(0)) {
+            clearTimeout(waiter.timer);
+            waiter.reject(error);
+        }
+    }
+    failAndKill(error) {
+        this.fail(error instanceof Error ? error : new Error(String(error)), true);
+        this.kill('SIGKILL');
+    }
+    startReap() {
+        const cleanup = this.processTree.reap({
+            timeoutMs: HARNESS_CLEANUP_TIMEOUT_MS,
+            probeIntervalMs: HARNESS_CLEANUP_PROBE_INTERVAL_MS,
+            taskkillTimeoutMs: TASKKILL_TIMEOUT_MS,
+            targetExitGraceMs: TARGET_EXIT_GRACE_MS,
+        });
+        void cleanup.catch((error) => {
+            this.fail(error instanceof Error ? error : new Error(String(error)), true);
+        });
+        return cleanup;
+    }
+}
+const harnessFatalErrors = new WeakMap();
+export function spawnHarnessChild(options) {
+    const spawned = spawnHarnessProcess(options);
+    return new HarnessChild(spawned.root, spawned.target, spawned.runtime);
+}
+export function spawnHarnessChildWithAdapter(options, adapter) {
+    const spawned = spawnHarnessProcessWithAdapter(options, adapter);
+    return new HarnessChild(spawned.root, spawned.target, spawned.runtime);
+}
+export async function runHarnessCase(options, execute) {
+    assertTimerMs(options.timeoutMs, 'case timeoutMs');
+    assertTimerMsNonNegative(options.terminateGraceMs ?? 100, 'case terminateGraceMs');
+    const child = spawnHarnessChild(options);
+    let timer;
+    let completed = false;
+    let result;
+    let executionError;
+    try {
+        result = await Promise.race([
+            execute(child),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => {
+                    child.kill('SIGKILL');
+                    reject(new HarnessTimeoutError(`harness case timed out after ${options.timeoutMs}ms`));
+                }, options.timeoutMs);
+            }),
+        ]);
+        completed = true;
+    }
+    catch (error) {
+        executionError = error;
+    }
+    finally {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        await child.stop(options.terminateGraceMs);
+    }
+    const fatalError = harnessFatalErrors.get(child);
+    if (fatalError !== undefined) {
+        throw fatalError;
+    }
+    if (!completed) {
+        throw executionError;
+    }
+    return result;
+}
+//# sourceMappingURL=child-process-harness.js.map

package/dist/conformance/stdio-harness/child-process-harness.js.map

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

package/dist/conformance/stdio-harness/dual-transport-oracle.d.ts

@@ -0,0 +1,26 @@
+export interface OracleTransport<Input, Result, Observation> {
+    /** Harness-local control-plane setup; never sent over the plugin wire. */
+    setup(): Promise<void>;
+    /** The sole semantic operation path being compared across transports. */
+    execute(input: Input): Promise<Result>;
+    /** Harness-local observation; never exposed as a production wire method. */
+    observe(): Promise<Observation>;
+}
+export interface DualTransportOracleCase<Input> {
+    readonly id: string;
+    readonly input: Input;
+}
+export interface TransportTranscript<Result, Observation> {
+    readonly before: Observation;
+    readonly result: Result;
+    readonly after: Observation;
+}
+export interface DualTransportOracleReport<Result, Observation> {
+    readonly id: string;
+    readonly passed: boolean;
+    readonly failures: readonly string[];
+    readonly inProcess: TransportTranscript<Result, Observation>;
+    readonly wire: TransportTranscript<Result, Observation>;
+}
+export declare function runDualTransportOracle<Input, Result, Observation>(oracleCase: DualTransportOracleCase<Input>, inProcessTransport: OracleTransport<Input, Result, Observation>, wireTransport: OracleTransport<Input, Result, Observation>): Promise<DualTransportOracleReport<Result, Observation>>;
+//# sourceMappingURL=dual-transport-oracle.d.ts.map

package/dist/conformance/stdio-harness/dual-transport-oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dual-transport-oracle.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/dual-transport-oracle.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW;IACzD,0EAA0E;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB,CAAC,KAAK;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB,CAAC,MAAM,EAAE,WAAW;IACtD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB,CAAC,MAAM,EAAE,WAAW;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACzD;AAaD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EACrE,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC,EAC1C,kBAAkB,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAC/D,aAAa,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,GACzD,OAAO,CAAC,yBAAyB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAwBzD"}

package/dist/conformance/stdio-harness/dual-transport-oracle.js

@@ -0,0 +1,32 @@
+import { isDeepStrictEqual } from 'node:util';
+async function captureTranscript(input, transport) {
+    await transport.setup();
+    const before = structuredClone(await transport.observe());
+    const result = structuredClone(await transport.execute(structuredClone(input)));
+    const after = structuredClone(await transport.observe());
+    return { before, result, after };
+}
+export async function runDualTransportOracle(oracleCase, inProcessTransport, wireTransport) {
+    const [inProcess, wire] = await Promise.all([
+        captureTranscript(oracleCase.input, inProcessTransport),
+        captureTranscript(oracleCase.input, wireTransport),
+    ]);
+    const failures = [];
+    if (!isDeepStrictEqual(inProcess.before, wire.before)) {
+        failures.push('before observation mismatch');
+    }
+    if (!isDeepStrictEqual(inProcess.result, wire.result)) {
+        failures.push('result mismatch');
+    }
+    if (!isDeepStrictEqual(inProcess.after, wire.after)) {
+        failures.push('after observation mismatch');
+    }
+    return {
+        id: oracleCase.id,
+        passed: failures.length === 0,
+        failures,
+        inProcess,
+        wire,
+    };
+}
+//# sourceMappingURL=dual-transport-oracle.js.map

package/dist/conformance/stdio-harness/dual-transport-oracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dual-transport-oracle.js","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/dual-transport-oracle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AA8B9C,KAAK,UAAU,iBAAiB,CAC9B,KAAY,EACZ,SAAsD;IAEtD,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA0C,EAC1C,kBAA+D,EAC/D,aAA0D;IAE1D,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,iBAAiB,CAAC,UAAU,CAAC,KAAK,EAAE,kBAAkB,CAAC;QACvD,iBAAiB,CAAC,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC;KACnD,CAAC,CAAC;IACH,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC7B,QAAQ;QACR,SAAS;QACT,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/conformance/stdio-harness/harness-process-spawn.d.ts

@@ -0,0 +1,27 @@
+import { type ChildProcessWithoutNullStreams } from 'node:child_process';
+import { type ProcessTreeRuntime } from './process-tree-controller.js';
+export interface SpawnHarnessChildOptions {
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export interface HarnessTargetLifecycle {
+    readonly onTargetError: (listener: (error: Error) => void) => void;
+    readonly onTargetExit: (listener: (code: number | null, signal: NodeJS.Signals | null) => void) => void;
+    readonly signalTarget: (signal: NodeJS.Signals) => void;
+}
+/** @internal Injectable platform boundary for cross-platform conformance tests. */
+export interface HarnessPlatformAdapter {
+    readonly platform: NodeJS.Platform;
+    readonly createProcessTreeRuntime: (signalTarget: (signal: NodeJS.Signals) => void) => ProcessTreeRuntime;
+}
+export interface SpawnedHarnessProcess {
+    readonly root: ChildProcessWithoutNullStreams;
+    readonly target: HarnessTargetLifecycle;
+    readonly runtime: ProcessTreeRuntime;
+}
+export declare function spawnHarnessProcess(options: SpawnHarnessChildOptions): SpawnedHarnessProcess;
+export declare function spawnHarnessProcessWithAdapter(options: SpawnHarnessChildOptions, adapter: HarnessPlatformAdapter): SpawnedHarnessProcess;
+export declare function createDirectTargetLifecycle(child: ChildProcessWithoutNullStreams): HarnessTargetLifecycle;
+//# sourceMappingURL=harness-process-spawn.d.ts.map

package/dist/conformance/stdio-harness/harness-process-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-process-spawn.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/harness-process-spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,YAAY,EAAE,CACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,KAAK,IAAI,KACnE,IAAI,CAAC;IACV,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;CACzD;AAED,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,wBAAwB,EAAE,CACjC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,KAC3C,kBAAkB,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,GAChC,qBAAqB,CAMvB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAsBvB;AACD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,8BAA8B,GACpC,sBAAsB,CAQxB"}

package/dist/conformance/stdio-harness/harness-process-spawn.js

@@ -0,0 +1,43 @@
+import { spawn } from 'node:child_process';
+import { createNodeProcessTreeRuntime } from './node-process-tree-runtime.js';
+import {} from './process-tree-controller.js';
+import { spawnWindowsSentinel } from './windows-sentinel.js';
+export function spawnHarnessProcess(options) {
+    return spawnHarnessProcessWithAdapter(options, {
+        platform: process.platform,
+        createProcessTreeRuntime: (signalTarget) => createNodeProcessTreeRuntime(process.platform, signalTarget),
+    });
+}
+export function spawnHarnessProcessWithAdapter(options, adapter) {
+    const args = [...(options.args ?? [])];
+    if (adapter.platform === 'win32') {
+        const target = spawnWindowsSentinel({ ...options, args });
+        return {
+            root: target.root,
+            target,
+            runtime: adapter.createProcessTreeRuntime(target.signalTarget),
+        };
+    }
+    const root = spawn(options.command, args, {
+        cwd: options.cwd,
+        detached: true,
+        env: options.env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    const target = createDirectTargetLifecycle(root);
+    return {
+        root,
+        target,
+        runtime: adapter.createProcessTreeRuntime(target.signalTarget),
+    };
+}
+export function createDirectTargetLifecycle(child) {
+    return {
+        onTargetError: (listener) => child.once('error', listener),
+        onTargetExit: (listener) => child.once('exit', listener),
+        signalTarget: (signal) => {
+            child.kill(signal);
+        },
+    };
+}
+//# sourceMappingURL=harness-process-spawn.js.map

package/dist/conformance/stdio-harness/harness-process-spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-process-spawn.js","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/harness-process-spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAuC,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAA2B,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AA+B7D,MAAM,UAAU,mBAAmB,CACjC,OAAiC;IAEjC,OAAO,8BAA8B,CAAC,OAAO,EAAE;QAC7C,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,wBAAwB,EAAE,CAAC,YAAY,EAAE,EAAE,CACzC,4BAA4B,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,OAAiC,EACjC,OAA+B;IAE/B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC,YAAY,CAAC;SAC/D,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;QACxC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO;QACL,IAAI;QACJ,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC,YAAY,CAAC;KAC/D,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,2BAA2B,CACzC,KAAqC;IAErC,OAAO;QACL,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC1D,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/conformance/stdio-harness/index.d.ts

@@ -0,0 +1,5 @@
+export { HarnessChild, HarnessChildExitedError, HarnessCleanupError, HarnessFrameBacklogError, HarnessTimeoutError, MAX_HARNESS_QUEUED_FRAMES, MAX_TIMER_MS, runHarnessCase, spawnHarnessChild, type HarnessChildExit, type HarnessReceiveOptions, type RunHarnessCaseOptions, type SpawnHarnessChildOptions, } from './child-process-harness.js';
+export { runDualTransportOracle, type DualTransportOracleCase, type DualTransportOracleReport, type OracleTransport, type TransportTranscript, } from './dual-transport-oracle.js';
+export { MAX_NDJSON_FRAME_BYTES, NdjsonFrameDecoder, NdjsonFrameError, encodeNdjsonFrame, type DecodedNdjsonFrame, type JsonObject, type NdjsonFrameErrorCode, } from './ndjson-frame.js';
+export type { HarnessWireShape } from './wire-shape.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/conformance/stdio-harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/conformance/stdio-harness/index.js

@@ -0,0 +1,4 @@
+export { HarnessChild, HarnessChildExitedError, HarnessCleanupError, HarnessFrameBacklogError, HarnessTimeoutError, MAX_HARNESS_QUEUED_FRAMES, MAX_TIMER_MS, runHarnessCase, spawnHarnessChild, } from './child-process-harness.js';
+export { runDualTransportOracle, } from './dual-transport-oracle.js';
+export { MAX_NDJSON_FRAME_BYTES, NdjsonFrameDecoder, NdjsonFrameError, encodeNdjsonFrame, } from './ndjson-frame.js';
+//# sourceMappingURL=index.js.map

package/dist/conformance/stdio-harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAKlB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,sBAAsB,GAKvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC"}

package/dist/conformance/stdio-harness/ndjson-frame.d.ts

@@ -0,0 +1,31 @@
+/**
+ * NDJSON frame ceiling — derived from the canonical wire constant.
+ * P-1b consumes P-1a's truth; this alias exists for harness-local naming.
+ * Widened to `number` so callers can pass stricter sub-limits.
+ */
+export declare const MAX_NDJSON_FRAME_BYTES: number;
+export type JsonObject = Readonly<Record<string, unknown>>;
+export interface DecodedNdjsonFrame {
+    /** Exact bytes before LF; retained for pre-parse contract validation. */
+    readonly raw: Uint8Array;
+    /** Convenience parse only; contract validation must still inspect raw. */
+    readonly value: JsonObject;
+}
+export type NdjsonFrameErrorCode = 'FRAME_TOO_LARGE' | 'INVALID_UTF8' | 'INVALID_JSON' | 'INVALID_FRAME' | 'TRUNCATED_FRAME' | 'DECODER_CLOSED';
+export declare class NdjsonFrameError extends Error {
+    readonly code: NdjsonFrameErrorCode;
+    constructor(code: NdjsonFrameErrorCode, message: string);
+}
+export declare function encodeNdjsonFrame(value: JsonObject, maxFrameBytes?: number): Uint8Array;
+export declare class NdjsonFrameDecoder {
+    private readonly maxFrameBytes;
+    private buffered;
+    private closed;
+    private failed;
+    constructor(maxFrameBytes?: number);
+    push(chunk: Uint8Array): readonly DecodedNdjsonFrame[];
+    end(): readonly DecodedNdjsonFrame[];
+    private assertOpen;
+    private fail;
+}
+//# sourceMappingURL=ndjson-frame.d.ts.map

package/dist/conformance/stdio-harness/ndjson-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson-frame.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/ndjson-frame.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAwB,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,cAAc,GACd,cAAc,GACd,eAAe,GACf,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,IAAI,EAAE,oBAAoB;gBAA1B,IAAI,EAAE,oBAAoB,EACnC,OAAO,EAAE,MAAM;CAKlB;AAyCD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,aAAa,SAAyB,GACrC,UAAU,CAmBZ;AAED,qBAAa,kBAAkB;IAKjB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJ1C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEM,aAAa,SAAyB;IAInE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,kBAAkB,EAAE;IAkDtD,GAAG,IAAI,SAAS,kBAAkB,EAAE;IAapC,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,IAAI;CAIb"}

package/dist/conformance/stdio-harness/ndjson-frame.js

@@ -0,0 +1,125 @@
+import { MAX_FRAME_BYTES } from '../../wire/constants.js';
+/**
+ * NDJSON frame ceiling — derived from the canonical wire constant.
+ * P-1b consumes P-1a's truth; this alias exists for harness-local naming.
+ * Widened to `number` so callers can pass stricter sub-limits.
+ */
+export const MAX_NDJSON_FRAME_BYTES = MAX_FRAME_BYTES;
+export class NdjsonFrameError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'NdjsonFrameError';
+    }
+}
+function validateMaxFrameBytes(maxFrameBytes) {
+    if (!Number.isSafeInteger(maxFrameBytes) ||
+        maxFrameBytes <= 0 ||
+        maxFrameBytes > MAX_NDJSON_FRAME_BYTES) {
+        throw new RangeError(`NDJSON maxFrameBytes must be a positive safe integer no greater than ${MAX_NDJSON_FRAME_BYTES}`);
+    }
+}
+function assertJsonObject(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new NdjsonFrameError('INVALID_FRAME', 'NDJSON frames must contain one non-array JSON object');
+    }
+}
+function decodeFrame(frame) {
+    let text;
+    try {
+        text = new TextDecoder('utf-8', { fatal: true }).decode(frame);
+    }
+    catch {
+        throw new NdjsonFrameError('INVALID_UTF8', 'NDJSON frame is not valid UTF-8');
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new NdjsonFrameError('INVALID_JSON', 'NDJSON frame is not valid JSON');
+    }
+    assertJsonObject(value);
+    return { raw: Buffer.from(frame), value };
+}
+export function encodeNdjsonFrame(value, maxFrameBytes = MAX_NDJSON_FRAME_BYTES) {
+    validateMaxFrameBytes(maxFrameBytes);
+    assertJsonObject(value);
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined) {
+        throw new NdjsonFrameError('INVALID_FRAME', 'NDJSON frames must serialize to one non-array JSON object');
+    }
+    assertJsonObject(JSON.parse(serialized));
+    const frame = Buffer.from(serialized, 'utf8');
+    if (frame.byteLength > maxFrameBytes) {
+        throw new NdjsonFrameError('FRAME_TOO_LARGE', `NDJSON frame is ${frame.byteLength} bytes; limit is ${maxFrameBytes}`);
+    }
+    return Buffer.concat([frame, Buffer.from('\n')], frame.byteLength + 1);
+}
+export class NdjsonFrameDecoder {
+    maxFrameBytes;
+    buffered = Buffer.alloc(0);
+    closed = false;
+    failed = false;
+    constructor(maxFrameBytes = MAX_NDJSON_FRAME_BYTES) {
+        this.maxFrameBytes = maxFrameBytes;
+        validateMaxFrameBytes(maxFrameBytes);
+    }
+    push(chunk) {
+        this.assertOpen();
+        if (chunk.byteLength === 0) {
+            return [];
+        }
+        const incoming = Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+        const combined = this.buffered.byteLength === 0
+            ? incoming
+            : Buffer.concat([this.buffered, incoming], this.buffered.byteLength + incoming.byteLength);
+        const frames = [];
+        let frameStart = 0;
+        try {
+            let newline = combined.indexOf(0x0a, frameStart);
+            while (newline !== -1) {
+                const frameLength = newline - frameStart;
+                if (frameLength > this.maxFrameBytes) {
+                    throw new NdjsonFrameError('FRAME_TOO_LARGE', `NDJSON frame is ${frameLength} bytes; limit is ${this.maxFrameBytes}`);
+                }
+                if (frameLength === 0) {
+                    throw new NdjsonFrameError('INVALID_FRAME', 'blank NDJSON frames are not allowed');
+                }
+                frames.push(decodeFrame(combined.subarray(frameStart, newline)));
+                frameStart = newline + 1;
+                newline = combined.indexOf(0x0a, frameStart);
+            }
+            const remainder = combined.subarray(frameStart);
+            if (remainder.byteLength > this.maxFrameBytes) {
+                throw new NdjsonFrameError('FRAME_TOO_LARGE', `unterminated NDJSON frame exceeded ${this.maxFrameBytes} bytes`);
+            }
+            this.buffered = Buffer.from(remainder);
+            return frames;
+        }
+        catch (error) {
+            this.fail();
+            throw error;
+        }
+    }
+    end() {
+        this.assertOpen();
+        this.closed = true;
+        if (this.buffered.byteLength === 0) {
+            return [];
+        }
+        this.buffered = Buffer.alloc(0);
+        throw new NdjsonFrameError('TRUNCATED_FRAME', 'NDJSON stream ended before the final LF delimiter');
+    }
+    assertOpen() {
+        if (this.closed || this.failed) {
+            throw new NdjsonFrameError('DECODER_CLOSED', 'NDJSON decoder is closed');
+        }
+    }
+    fail() {
+        this.failed = true;
+        this.buffered = Buffer.alloc(0);
+    }
+}
+//# sourceMappingURL=ndjson-frame.js.map