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

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"}

package/dist/conformance/stdio-harness/process-tree-controller.js

@@ -0,0 +1,162 @@
+export class HarnessCleanupError extends Error {
+    rootPid;
+    constructor(rootPid, message, options) {
+        super(message, options);
+        this.rootPid = rootPid;
+        this.name = 'HarnessCleanupError';
+    }
+}
+export class ProcessTreeController {
+    rootPid;
+    runtime;
+    currentState = 'spawned';
+    targetExited = false;
+    streamsClosed = false;
+    hardKillRequested = false;
+    terminationError;
+    reapPromise;
+    constructor(rootPid, runtime) {
+        this.rootPid = rootPid;
+        this.runtime = runtime;
+    }
+    get state() {
+        return this.currentState;
+    }
+    markRunning() {
+        if (this.state === 'spawned') {
+            this.currentState = 'running';
+        }
+    }
+    requestTermination(signal) {
+        if (this.state === 'reaped' || this.state === 'cleanup-failed') {
+            return;
+        }
+        if (this.hardKillRequested) {
+            return;
+        }
+        if (signal === 'SIGKILL') {
+            this.hardKillRequested = true;
+        }
+        if (this.state === 'spawned' || this.state === 'running') {
+            this.currentState = 'terminating';
+        }
+        try {
+            if (this.rootPid === undefined || this.runtime.platform === 'win32') {
+                this.runtime.signalTarget(signal);
+                return;
+            }
+            this.runtime.signalTree(this.rootPid, signal);
+        }
+        catch (error) {
+            this.terminationError =
+                error instanceof Error ? error : new Error(String(error));
+        }
+    }
+    markTargetExited() {
+        this.targetExited = true;
+        if (this.state === 'reaped' || this.state === 'cleanup-failed') {
+            return;
+        }
+        if (this.state === 'spawned' || this.state === 'running') {
+            this.currentState = 'terminating';
+        }
+        this.currentState = 'exited';
+    }
+    markStreamsClosed() {
+        this.streamsClosed = true;
+    }
+    treeIsAlive() {
+        return this.rootPid === undefined ? false : this.runtime.treeIsAlive(this.rootPid);
+    }
+    reap(options) {
+        validatePositiveSafeInteger(options.timeoutMs, 'cleanup timeoutMs');
+        validatePositiveSafeInteger(options.probeIntervalMs, 'cleanup probeIntervalMs');
+        validatePositiveSafeInteger(options.taskkillTimeoutMs, 'taskkill timeoutMs');
+        validatePositiveSafeInteger(options.targetExitGraceMs, 'target-exit graceMs');
+        this.reapPromise ??= this.reapOnce(options);
+        return this.reapPromise;
+    }
+    async reapOnce(options) {
+        let taskkillOutcome;
+        let targetExitConfirmedBeforeTaskkill = true;
+        if (this.runtime.platform === 'win32' && this.rootPid !== undefined) {
+            const targetExitDeadline = this.runtime.now() + options.targetExitGraceMs;
+            while (!this.targetExited && this.runtime.now() < targetExitDeadline) {
+                await this.runtime.sleep(Math.min(options.probeIntervalMs, targetExitDeadline - this.runtime.now()));
+            }
+            targetExitConfirmedBeforeTaskkill = this.targetExited;
+            try {
+                taskkillOutcome = await this.runtime.runTaskkill(this.rootPid, options.taskkillTimeoutMs);
+            }
+            catch (error) {
+                taskkillOutcome = {
+                    status: 'spawn-error',
+                    error: error instanceof Error ? error : new Error(String(error)),
+                };
+            }
+            if (taskkillOutcome.status !== 'success') {
+                this.currentState = 'cleanup-failed';
+                const outcome = describeTaskkillOutcome(taskkillOutcome);
+                const terminationDetail = this.terminationError === undefined
+                    ? ''
+                    : `; termination signal failed: ${this.terminationError.message}`;
+                const cause = this.terminationError ??
+                    (taskkillOutcome.status === 'spawn-error'
+                        ? taskkillOutcome.error
+                        : undefined);
+                throw new HarnessCleanupError(this.rootPid, `harness process-tree cleanup has no whole-tree evidence after taskkill ${outcome}${terminationDetail}`, cause === undefined ? undefined : { cause });
+            }
+        }
+        const deadline = this.runtime.now() + options.timeoutMs;
+        while (true) {
+            let treeAlive;
+            try {
+                treeAlive = this.treeIsAlive();
+            }
+            catch (error) {
+                const cause = error instanceof Error ? error : new Error(String(error));
+                this.currentState = 'cleanup-failed';
+                throw new HarnessCleanupError(this.rootPid, `harness process-tree cleanup probe failed: ${cause.message}`, { cause });
+            }
+            if (!treeAlive && this.targetExited && this.streamsClosed) {
+                if (!targetExitConfirmedBeforeTaskkill) {
+                    this.currentState = 'cleanup-failed';
+                    throw new HarnessCleanupError(this.rootPid, 'Windows sentinel did not report target exit before taskkill reaped the wrapper root');
+                }
+                this.currentState = 'reaped';
+                return;
+            }
+            if (this.runtime.now() >= deadline) {
+                this.currentState = 'cleanup-failed';
+                const outcome = describeTaskkillOutcome(taskkillOutcome);
+                const terminationDetail = this.terminationError === undefined
+                    ? ''
+                    : `; termination signal failed: ${this.terminationError.message}`;
+                const cause = this.terminationError ??
+                    (taskkillOutcome?.status === 'spawn-error'
+                        ? taskkillOutcome.error
+                        : undefined);
+                throw new HarnessCleanupError(this.rootPid, `harness process-tree cleanup failed after taskkill ${outcome}${terminationDetail}`, cause === undefined ? undefined : { cause });
+            }
+            await this.runtime.sleep(Math.min(options.probeIntervalMs, deadline - this.runtime.now()));
+        }
+    }
+}
+function validatePositiveSafeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new RangeError(`${label} must be a positive safe integer`);
+    }
+}
+function describeTaskkillOutcome(outcome) {
+    if (outcome === undefined) {
+        return 'not-applicable';
+    }
+    if (outcome.status === 'nonzero') {
+        return `nonzero (code=${String(outcome.code)})`;
+    }
+    if (outcome.status === 'spawn-error') {
+        return `spawn-error (${outcome.error.message})`;
+    }
+    return outcome.status;
+}
+//# sourceMappingURL=process-tree-controller.js.map

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

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

package/dist/conformance/stdio-harness/windows-sentinel.d.ts

@@ -0,0 +1,15 @@
+import { type ChildProcessWithoutNullStreams } from 'node:child_process';
+export interface WindowsSentinelOptions {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export interface WindowsSentinel {
+    readonly root: ChildProcessWithoutNullStreams;
+    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;
+}
+export declare function spawnWindowsSentinel(options: WindowsSentinelOptions): WindowsSentinel;
+//# sourceMappingURL=windows-sentinel.d.ts.map

package/dist/conformance/stdio-harness/windows-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-sentinel.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/windows-sentinel.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,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;AAiFD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAmGrF"}

package/dist/conformance/stdio-harness/windows-sentinel.js

@@ -0,0 +1,160 @@
+import { spawn, } from 'node:child_process';
+const WINDOWS_SENTINEL_SOURCE = String.raw `
+const { spawn } = require('node:child_process');
+
+let target;
+let targetExitSent = false;
+const keepAlive = setInterval(() => {}, 0x3fffffff);
+
+function send(message) {
+  if (process.connected) {
+    process.send(message, () => {});
+  }
+}
+
+function sendError(error) {
+  send({
+    type: 'target-error',
+    name: error && error.name ? String(error.name) : 'Error',
+    message: error && error.message ? String(error.message) : String(error),
+    code: error && error.code !== undefined ? String(error.code) : undefined,
+  });
+}
+
+function sendExit(code, signal) {
+  if (!targetExitSent) {
+    targetExitSent = true;
+    send({ type: 'target-exit', code, signal });
+  }
+}
+
+process.on('message', (message) => {
+  if (!message || typeof message !== 'object') return;
+  if (message.type === 'launch' && target === undefined) {
+    try {
+      target = spawn(message.command, message.args, {
+        stdio: ['inherit', 'inherit', 'inherit'],
+      });
+      target.once('error', (error) => {
+        sendError(error);
+        sendExit(null, null);
+      });
+      target.once('exit', sendExit);
+    } catch (error) {
+      sendError(error);
+      sendExit(null, null);
+    }
+    return;
+  }
+  if (message.type === 'signal' && target !== undefined) {
+    try {
+      target.kill(message.signal);
+    } catch (error) {
+      sendError(error);
+    }
+  }
+});
+
+process.on('disconnect', () => {
+  clearInterval(keepAlive);
+  if (process.platform === 'win32') {
+    const cleanup = spawn(
+      'taskkill',
+      ['/pid', String(process.pid), '/t', '/f'],
+      { detached: true, stdio: 'ignore', windowsHide: true },
+    );
+    cleanup.unref();
+  } else if (target !== undefined) {
+    target.kill('SIGKILL');
+  }
+});
+`;
+export function spawnWindowsSentinel(options) {
+    const root = spawn(process.execPath, ['-e', WINDOWS_SENTINEL_SOURCE], {
+        cwd: options.cwd,
+        env: options.env,
+        stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        windowsHide: true,
+    });
+    let targetExit;
+    let targetError;
+    const exitListeners = [];
+    const errorListeners = [];
+    const publishTargetError = (error) => {
+        targetError ??= error;
+        for (const listener of errorListeners.splice(0)) {
+            listener(targetError);
+        }
+    };
+    const publishTargetExit = (code, signal) => {
+        if (targetExit !== undefined) {
+            return;
+        }
+        targetExit = { code, signal };
+        for (const listener of exitListeners.splice(0)) {
+            listener(code, signal);
+        }
+    };
+    root.on('message', (message) => {
+        if (!isSentinelMessage(message)) {
+            return;
+        }
+        if (message.type === 'target-error') {
+            const error = new Error(message.message ?? 'Windows sentinel target failed');
+            error.name = message.name ?? 'Error';
+            if (message.code !== undefined) {
+                Object.assign(error, { code: message.code });
+            }
+            publishTargetError(error);
+            return;
+        }
+        publishTargetExit(typeof message.code === 'number' ? message.code : null, message.signal ?? null);
+    });
+    root.once('error', publishTargetError);
+    root.once('close', (code, signal) => publishTargetExit(code, signal));
+    root.once('spawn', () => {
+        root.send({ type: 'launch', command: options.command, args: [...options.args] }, (error) => {
+            if (error !== null) {
+                publishTargetError(error);
+                publishTargetExit(null, null);
+            }
+        });
+    });
+    return {
+        root,
+        onTargetError: (listener) => {
+            if (targetError === undefined) {
+                errorListeners.push(listener);
+            }
+            else {
+                const error = targetError;
+                queueMicrotask(() => listener(error));
+            }
+        },
+        onTargetExit: (listener) => {
+            if (targetExit === undefined) {
+                exitListeners.push(listener);
+            }
+            else {
+                const exit = targetExit;
+                queueMicrotask(() => listener(exit.code, exit.signal));
+            }
+        },
+        signalTarget: (signal) => {
+            if (root.connected) {
+                root.send({ type: 'signal', signal }, (error) => {
+                    if (error !== null) {
+                        publishTargetError(error);
+                    }
+                });
+            }
+        },
+    };
+}
+function isSentinelMessage(message) {
+    return (typeof message === 'object' &&
+        message !== null &&
+        'type' in message &&
+        (message.type === 'target-error' || message.type === 'target-exit'));
+}
+//# sourceMappingURL=windows-sentinel.js.map

package/dist/conformance/stdio-harness/windows-sentinel.js.map

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

package/dist/conformance/stdio-harness/wire-shape.d.ts

@@ -0,0 +1,18 @@
+import type { HarnessChild } from './child-process-harness.js';
+import type { DecodedNdjsonFrame, JsonObject } from './ndjson-frame.js';
+/**
+ * Deliberate seam for the P-1a contract output.
+ *
+ * This skeleton owns process and frame transport only. The #1165 frozen
+ * shape (rev11) is now shape-approved; the wire module mechanizes its
+ * 13-row registry, disposition table, and closed error envelopes. This
+ * seam will be replaced by a concrete codec backed by those wire types
+ * when the handshake rows (1, 2) reach CLOSED leaf closure.
+ */
+export interface HarnessWireShape<Outbound, Inbound> {
+    readonly status: 'shape-approved';
+    encode(message: Outbound): JsonObject;
+    decode(frame: DecodedNdjsonFrame): Inbound;
+    performHelloReady(child: HarnessChild): Promise<void>;
+}
+//# sourceMappingURL=wire-shape.d.ts.map

package/dist/conformance/stdio-harness/wire-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-shape.d.ts","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/wire-shape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ,EAAE,OAAO;IACjD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAC3C,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

package/dist/conformance/stdio-harness/wire-shape.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wire-shape.js.map

package/dist/conformance/stdio-harness/wire-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-shape.js","sourceRoot":"","sources":["../../../src/conformance/stdio-harness/wire-shape.ts"],"names":[],"mappings":""}