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

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, 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,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, 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,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,26 @@
+export declare const MAX_NDJSON_FRAME_BYTES = 1048576;
+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":"AAAA,eAAO,MAAM,sBAAsB,UAAY,CAAC;AAEhD,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,119 @@
+export const MAX_NDJSON_FRAME_BYTES = 1_048_576;
+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

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

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

package/dist/conformance/stdio-harness/node-process-tree-runtime.d.ts

@@ -0,0 +1,15 @@
+import { type ProcessTreeRuntime, type TaskkillOutcome } from './process-tree-controller.js';
+export interface TaskkillProcess {
+    readonly kill: () => boolean;
+    readonly once: {
+        (event: 'close', listener: (code: number | null) => void): TaskkillProcess;
+        (event: 'error', listener: (error: Error) => void): TaskkillProcess;
+    };
+}
+export type TaskkillSpawner = (command: string, args: readonly string[], options: {
+    readonly stdio: 'ignore';
+    readonly windowsHide: true;
+}) => TaskkillProcess;
+export declare function runTaskkill(rootPid: number, timeoutMs: number, spawnTaskkill?: TaskkillSpawner): Promise<TaskkillOutcome>;
+export declare function createNodeProcessTreeRuntime(platform: NodeJS.Platform, signalTarget: (signal: NodeJS.Signals) => void, killProcess?: typeof process.kill): ProcessTreeRuntime;
+//# sourceMappingURL=node-process-tree-runtime.d.ts.map

package/dist/conformance/stdio-harness/node-process-tree-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-process-tree-runtime.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/node-process-tree-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE;QACb,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,eAAe,CAAC;QAC3E,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,eAAe,CAAC;KACrE,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAA;CAAE,KAC9D,eAAe,CAAC;AAKrB,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,eAAwC,GACtD,OAAO,CAAC,eAAe,CAAC,CAqC1B;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,EAC9C,WAAW,GAAE,OAAO,OAAO,CAAC,IAAmB,GAC9C,kBAAkB,CAiCpB"}

package/dist/conformance/stdio-harness/node-process-tree-runtime.js

@@ -0,0 +1,78 @@
+import { spawn } from 'node:child_process';
+import {} from './process-tree-controller.js';
+const defaultTaskkillSpawner = (command, args, options) => spawn(command, [...args], options);
+export function runTaskkill(rootPid, timeoutMs, spawnTaskkill = defaultTaskkillSpawner) {
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+        throw new RangeError('taskkill timeoutMs must be a positive safe integer');
+    }
+    let child;
+    try {
+        child = spawnTaskkill('taskkill', ['/pid', String(rootPid), '/t', '/f'], { stdio: 'ignore', windowsHide: true });
+    }
+    catch (error) {
+        return Promise.resolve({
+            status: 'spawn-error',
+            error: error instanceof Error ? error : new Error(String(error)),
+        });
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        const settle = (outcome) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            resolve(outcome);
+        };
+        const timer = setTimeout(() => {
+            child.kill();
+            settle({ status: 'timeout' });
+        }, timeoutMs);
+        child.once('error', (error) => settle({ status: 'spawn-error', error }));
+        child.once('close', (code) => settle(code === 0 ? { status: 'success' } : { status: 'nonzero', code }));
+    });
+}
+export function createNodeProcessTreeRuntime(platform, signalTarget, killProcess = process.kill) {
+    return {
+        platform,
+        now: Date.now,
+        sleep: (delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs)),
+        signalTarget,
+        signalTree: (rootPid, signal) => {
+            try {
+                killProcess(-rootPid, signal);
+            }
+            catch (error) {
+                if (isNoSuchProcessError(error)) {
+                    signalTarget(signal);
+                    return;
+                }
+                throw error;
+            }
+        },
+        treeIsAlive: (rootPid) => {
+            try {
+                killProcess(platform === 'win32' ? rootPid : -rootPid, 0);
+                return true;
+            }
+            catch (error) {
+                if (isNoSuchProcessError(error)) {
+                    return false;
+                }
+                if (isPermissionError(error)) {
+                    return true;
+                }
+                throw error;
+            }
+        },
+        runTaskkill,
+    };
+}
+function isNoSuchProcessError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ESRCH';
+}
+function isPermissionError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'EPERM';
+}
+//# sourceMappingURL=node-process-tree-runtime.js.map

package/dist/conformance/stdio-harness/node-process-tree-runtime.js.map

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

package/dist/conformance/stdio-harness/process-tree-controller.d.ts

@@ -0,0 +1,51 @@
+export type HarnessProcessState = 'spawned' | 'running' | 'terminating' | 'exited' | 'reaped' | 'cleanup-failed';
+export type TaskkillOutcome = {
+    readonly status: 'success';
+} | {
+    readonly status: 'nonzero';
+    readonly code: number | null;
+} | {
+    readonly status: 'spawn-error';
+    readonly error: Error;
+} | {
+    readonly status: 'timeout';
+};
+export interface ProcessTreeRuntime {
+    readonly platform: NodeJS.Platform;
+    readonly now: () => number;
+    readonly sleep: (delayMs: number) => Promise<void>;
+    readonly signalTarget: (signal: NodeJS.Signals) => void;
+    readonly signalTree: (rootPid: number, signal: NodeJS.Signals) => void;
+    readonly treeIsAlive: (rootPid: number) => boolean;
+    readonly runTaskkill: (rootPid: number, timeoutMs: number) => Promise<TaskkillOutcome>;
+}
+export interface ReapProcessTreeOptions {
+    readonly timeoutMs: number;
+    readonly probeIntervalMs: number;
+    readonly taskkillTimeoutMs: number;
+    readonly targetExitGraceMs: number;
+}
+export declare class HarnessCleanupError extends Error {
+    readonly rootPid: number | undefined;
+    constructor(rootPid: number | undefined, message: string, options?: ErrorOptions);
+}
+export declare class ProcessTreeController {
+    readonly rootPid: number | undefined;
+    readonly runtime: ProcessTreeRuntime;
+    private currentState;
+    private targetExited;
+    private streamsClosed;
+    private hardKillRequested;
+    private terminationError;
+    private reapPromise;
+    constructor(rootPid: number | undefined, runtime: ProcessTreeRuntime);
+    get state(): HarnessProcessState;
+    markRunning(): void;
+    requestTermination(signal: NodeJS.Signals): void;
+    markTargetExited(): void;
+    markStreamsClosed(): void;
+    treeIsAlive(): boolean;
+    reap(options: ReapProcessTreeOptions): Promise<void>;
+    private reapOnce;
+}
+//# sourceMappingURL=process-tree-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process-tree-controller.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/process-tree-controller.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,SAAS,GACT,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,gBAAgB,CAAC;AAErB,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,CACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;gBAA3B,OAAO,EAAE,MAAM,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,qBAAa,qBAAqB;IAS9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IACpC,QAAQ,CAAC,OAAO,EAAE,kBAAkB;IATtC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,WAAW,CAA4B;gBAGpC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,kBAAkB;IAGtC,IAAI,KAAK,IAAI,mBAAmB,CAE/B;IAED,WAAW,IAAI,IAAI;IAMnB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;IA0BhD,gBAAgB,IAAI,IAAI;IAWxB,iBAAiB,IAAI,IAAI;IAIzB,WAAW,IAAI,OAAO;IAItB,IAAI,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;YAStC,QAAQ;CA6FvB"}