@orkestrel/process 0.0.10 → 0.0.12

package/dist/src/server/index.d.cts

@@ -1,46 +1,39 @@
 import { Buffer as Buffer_2 } from 'node:buffer';
-import { DetachOptions } from '@orkestrel/process';
-import { EmitterInterface } from '@orkestrel/emitter';
-import { ExecutableOptions } from '@orkestrel/process';
-import { ExecuteInput } from '@orkestrel/process';
-import { ExecuteOptions } from '@orkestrel/process';
-import { ExecuteResult } from '@orkestrel/process';
-import { ExecuteSyncOptions } from '@orkestrel/process';
-import { ProcessCommand } from '@orkestrel/process';
-import { ProcessEventMap } from '@orkestrel/process';
-import { ProcessExit } from '@orkestrel/process';
-import { ProcessExit as ProcessExit_2 } from '@orkestrel/process';
-import { ProcessInterface } from '@orkestrel/process';
-import { ProcessInterface as ProcessInterface_2 } from '@orkestrel/process';
-import { ProcessManagerEventMap } from '@orkestrel/process';
-import { ProcessManagerInterface } from '@orkestrel/process';
-import { ProcessManagerInterface as ProcessManagerInterface_2 } from '@orkestrel/process';
-import { ProcessManagerOptions } from '@orkestrel/process';
-import { ProcessManagerOptions as ProcessManagerOptions_2 } from '@orkestrel/process';
-import { ProcessOptions } from '@orkestrel/process';
-import { ProcessOptions as ProcessOptions_2 } from '@orkestrel/process';
-import { Readable } from 'node:stream';
-import { SessionEventMap } from '@orkestrel/process';
-import { SessionInterface } from '@orkestrel/process';
-import { SessionInterface as SessionInterface_2 } from '@orkestrel/process';
-import { SessionOptions } from '@orkestrel/process';
-import { SessionOptions as SessionOptions_2 } from '@orkestrel/process';
-import { SpawnInput } from '@orkestrel/process';
+import type { DetachOptions } from '@orkestrel/process';
+import type { EmitterInterface } from '@orkestrel/emitter';
+import type { ExecutableOptions } from '@orkestrel/process';
+import type { ExecuteInput } from '@orkestrel/process';
+import type { ExecuteOptions } from '@orkestrel/process';
+import type { ExecuteResult } from '@orkestrel/process';
+import type { ExecuteSyncOptions } from '@orkestrel/process';
+import type { ProcessCommand } from '@orkestrel/process';
+import type { ProcessEventMap } from '@orkestrel/process';
+import type { ProcessExit } from '@orkestrel/process';
+import type { ProcessInterface } from '@orkestrel/process';
+import type { ProcessManagerEventMap } from '@orkestrel/process';
+import type { ProcessManagerInterface } from '@orkestrel/process';
+import type { ProcessManagerOptions } from '@orkestrel/process';
+import type { ProcessOptions } from '@orkestrel/process';
+import type { Readable } from 'node:stream';
+import type { SessionEventMap } from '@orkestrel/process';
+import type { SessionInterface } from '@orkestrel/process';
+import type { SessionOptions } from '@orkestrel/process';
+import type { SpawnInput } from '@orkestrel/process';
 
 /**
  * Builds the executable candidates an explicit platform would search.
  *
  * @remarks
  * Windows alone needs this list: the host searches the working directory before `PATH` and applies
- * `PATHEXT`, and Node reproduces neither for a direct spawn. Within each searched directory the
- * literal name is tried first and each `PATHEXT` candidate after it, whether or not the name already
- * carries an extension — so `report.txt` resolves to a `report.txt` file where one exists and to
- * `report.txt.cmd` where none does. The lookup reads the child's effective environment, so an
- * overridden `PATH` selects the executable the child would have found. A POSIX host resolves the
- * file itself, so the candidate list there is empty. An appended extension is spelled the way
- * `PATHEXT` spells it rather than the way the directory entry does, which the case-insensitive host
- * treats as the same file. A non-Windows platform returns an empty list because `execvp` performs
- * its own lookup.
+ * `PATHEXT`, and Node reproduces neither for a direct spawn. Within each searched directory,
+ * {@link buildExecutableCandidates} enumerates `PATHEXT` candidates for an extensionless name. For
+ * an extension-bearing name, it enumerates the literal path before `PATHEXT` candidates, so
+ * `report.txt` resolves to a `report.txt` file where one exists and to `report.txt.cmd` where none
+ * does. The lookup reads the child's effective environment, so an overridden `PATH` selects the
+ * executable the child would have found. A POSIX host resolves the file itself, so the candidate
+ * list there is empty. A `PATHEXT` candidate keeps the extension spelling from `PATHEXT`, which the
+ * case-insensitive host treats as the same file. A non-Windows platform returns an empty list
+ * because `execvp` performs its own lookup.
  *
  * @param file - The command executable name or path
  * @param workspace - The directory searched first
@@ -114,6 +107,10 @@ export declare function buildPlatformSpawn(command: ProcessCommand, file: string
 /**
  * Builds the resolved spawn form of one command for the current host.
  *
+ * @remarks
+ * When executable lookup returns no regular-file candidate, {@link buildSpawn} preserves the
+ * command file as written for native spawning.
+ *
  * @param command - The executable and its argument vector
  * @param options - The directory searched first and the child's effective environment
  * @returns The file, argument vector, and verbatim flag to spawn with
@@ -151,26 +148,37 @@ export declare function buildSpawn(command: ProcessCommand, options?: Executable
 export declare function captureChunk(chunk: unknown, room: number): Buffer_2 | undefined;
 
 /**
- * Creates one supervised child process.
+ * Creates one supervised child process and returns it as a {@link ProcessInterface}, so a caller
+ * holds the published contract rather than the `Process` class.
  *
  * @param options - Command, workspace, termination, evidence, stdin, and observation settings
  * @returns The launched {@link ProcessInterface}
  *
- * @example
+ * @example Supervise a child and read its lines
  * ```ts
  * import { createProcess } from '@orkestrel/process/server'
  *
  * const child = createProcess({
- * 	command: { file: 'node', arguments: ['--version'] },
+ * 	command: { file: 'node', arguments: ['-e', 'console.log("ready"); console.log("done")'] },
  * 	workspace: process.cwd(),
- * 	grace: 5000,
+ * 	grace: 5_000, // POSIX only: the window between SIGTERM and SIGKILL
  * })
+ *
+ * const lines: string[] = []
+ * for await (const line of child.lines) lines.push(line)
+ * lines // ['ready', 'done']
+ *
+ * const exit = await child.exit
+ * exit.code // 0
+ * await child.destroy()
  * ```
  */
 export declare function createProcess(options: ProcessOptions): ProcessInterface;
 
 /**
- * Creates one keyed registry of supervised child processes.
+ * Creates one empty keyed registry of supervised child processes and returns it as a
+ * {@link ProcessManagerInterface}, so a caller holds the published contract rather than the
+ * `ProcessManager` class.
  *
  * @param options - Initial fleet-level observation hooks and listener-error handling
  * @returns The {@link ProcessManagerInterface} registry
@@ -185,7 +193,8 @@ export declare function createProcess(options: ProcessOptions): ProcessInterface
 export declare function createProcessManager(options?: ProcessManagerOptions): ProcessManagerInterface;
 
 /**
- * Creates one raw byte session over a supervised child process.
+ * Creates one raw byte session over a supervised child process and returns it as a
+ * {@link SessionInterface}, so a caller holds the published contract rather than the `Session` class.
  *
  * @param options - Command, workspace, termination, evidence, stdin, and observation settings
  * @returns The launched {@link SessionInterface}
@@ -416,7 +425,8 @@ export declare function mergeEnvironment(isolated: boolean, base?: Readonly<Reco
 export declare function mergePlatformEnvironment(platform: NodeJS.Platform, parent: Readonly<Record<string, string | undefined>>, isolated: boolean, base?: Readonly<Record<string, string | undefined>>, override?: Readonly<Record<string, string | undefined>>): NodeJS.ProcessEnv;
 
 /**
- * Supervises one child while keeping every observation channel aligned at termination.
+ * Supervises one child, frames its standard output into lines under a bounded backlog, and keeps
+ * every observation channel aligned at termination.
  *
  * @remarks
  * The child's ending and the supervision's ending are distinct. `pid`, `code`, and `signal` read
@@ -446,7 +456,7 @@ export declare function mergePlatformEnvironment(platform: NodeJS.Platform, pare
  * await child.destroy()
  * ```
  */
-export declare class Process implements ProcessInterface_2 {
+export declare class Process implements ProcessInterface {
     #private;
     /**
      * Spawns one child process and begins stream capture.
@@ -454,7 +464,7 @@ export declare class Process implements ProcessInterface_2 {
      * @param options - Command, workspace, termination, capture, stdin, and observation settings
      * @throws A {@link ProcessError} coded `invalid` when an option or command string is malformed
      */
-    constructor(options: ProcessOptions_2);
+    constructor(options: ProcessOptions);
     /** Holds the host process id, fixed when construction returns, or `undefined` when the spawn produced none. */
     get pid(): number | undefined;
     /** Holds the exit code the host recorded, or `null` while the child has not exited and when a signal ended it. */
@@ -474,7 +484,7 @@ export declare class Process implements ProcessInterface_2 {
     /** Reports whether termination began, including after the terminal moment. */
     get stopping(): boolean;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
-    get exit(): Promise<ProcessExit_2>;
+    get exit(): Promise<ProcessExit>;
     /**
      * Writes one line to the open standard-input channel.
      *
@@ -587,7 +597,8 @@ export declare interface ProcessChildInterface {
 }
 
 /**
- * Represents a keyed registry of live supervised child processes.
+ * Launches supervised children under caller-chosen ids, evicts each one as it settles, and destroys
+ * every live child on teardown.
  *
  * @remarks
  * A child launched under an id joins the registry and emits `launch`; when it settles it removes
@@ -615,14 +626,14 @@ export declare interface ProcessChildInterface {
  * await manager.destroy()
  * ```
  */
-export declare class ProcessManager implements ProcessManagerInterface_2 {
+export declare class ProcessManager implements ProcessManagerInterface {
     #private;
     /**
      * Constructs a process registry.
      *
      * @param options - Initial fleet-level observation hooks and listener-error handling
      */
-    constructor(options?: ProcessManagerOptions_2);
+    constructor(options?: ProcessManagerOptions);
     /** Holds the typed fleet-level observation surface. */
     get emitter(): EmitterInterface<ProcessManagerEventMap>;
     /** Counts the live children. */
@@ -633,13 +644,13 @@ export declare class ProcessManager implements ProcessManagerInterface_2 {
      * @param id - The registry key
      * @returns The child, or `undefined`
      */
-    process(id: string): ProcessInterface_2 | undefined;
+    process(id: string): ProcessInterface | undefined;
     /**
      * Returns a snapshot of every live child.
      *
      * @returns The live children in launch order
      */
-    processes(): readonly ProcessInterface_2[];
+    processes(): readonly ProcessInterface[];
     /**
      * Spawns and registers one child under `id`.
      *
@@ -657,7 +668,7 @@ export declare class ProcessManager implements ProcessManagerInterface_2 {
      * @returns The launched child
      * @throws A {@link ProcessError} coded `duplicate` when `id` is already live, `protocol` when the registry is being destroyed, or `invalid` when an option or command string is malformed
      */
-    launch(id: string, options: ProcessOptions_2): ProcessInterface_2;
+    launch(id: string, options: ProcessOptions): ProcessInterface;
     /**
      * Terminates the named children and awaits their exit.
      *
@@ -745,7 +756,12 @@ export declare function readPlatformVariable(environment: Readonly<Record<string
 export declare function readVariable(environment: Readonly<Record<string, string | undefined>>, name: string): string | undefined;
 
 /**
- * Resolves a command file to the executable path the host would launch.
+ * Resolves a command file to the executable path the host would launch, or to `undefined` on a POSIX
+ * host, which performs its own lookup.
+ *
+ * @remarks
+ * A Windows lookup miss also returns `undefined`. {@link buildSpawn} preserves the command file as
+ * written for native spawning.
  *
  * @param file - The command executable name or path
  * @param options - The directory searched first and the child's effective environment
@@ -789,7 +805,7 @@ export declare function resolveExecutable(file: string, options?: ExecutableOpti
  * })
  * ```
  */
-export declare class Session implements SessionInterface_2 {
+export declare class Session implements SessionInterface {
     #private;
     /**
      * Spawns one child process and begins byte capture.
@@ -797,7 +813,7 @@ export declare class Session implements SessionInterface_2 {
      * @param options - Command, workspace, termination, evidence, stdin, and observation settings
      * @throws A {@link ProcessError} coded `invalid` when an option or command string is malformed
      */
-    constructor(options: SessionOptions_2);
+    constructor(options: SessionOptions);
     /** Holds the host process id, fixed when construction returns, or `undefined` when the spawn produced none. */
     get pid(): number | undefined;
     /** Holds the exit code the host recorded, or `null` while the child has not exited and when a signal ended it. */
@@ -815,7 +831,7 @@ export declare class Session implements SessionInterface_2 {
     /** Settles at the child's own ending, awaited without the terminal moment's drain window. */
     get ending(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
-    get exit(): Promise<ProcessExit_2>;
+    get exit(): Promise<ProcessExit>;
     /**
      * Writes raw bytes to the open standard-input channel.
      *
@@ -972,7 +988,7 @@ export declare class Supervisor {
      * @param face - The composing face's callbacks for each lifecycle moment
      * @throws A {@link ProcessError} coded `invalid` when an option or command string is malformed
      */
-    constructor(options: ProcessOptions_2, face: SupervisorFace);
+    constructor(options: ProcessOptions, face: SupervisorFace);
     /** Holds the child's standard-output stream, for the composing face to attach its own consumer to. */
     get stdout(): Readable;
     /** Holds the host process id, fixed when construction returns, or `undefined` when the spawn produced none. */
@@ -997,7 +1013,7 @@ export declare class Supervisor {
      */
     get ending(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
-    get exit(): Promise<ProcessExit_2>;
+    get exit(): Promise<ProcessExit>;
     /**
      * Writes raw bytes to the open standard-input channel.
      *

package/dist/src/server/index.d.ts

@@ -1,46 +1,39 @@
 import { Buffer as Buffer_2 } from 'node:buffer';
-import { DetachOptions } from '@orkestrel/process';
-import { EmitterInterface } from '@orkestrel/emitter';
-import { ExecutableOptions } from '@orkestrel/process';
-import { ExecuteInput } from '@orkestrel/process';
-import { ExecuteOptions } from '@orkestrel/process';
-import { ExecuteResult } from '@orkestrel/process';
-import { ExecuteSyncOptions } from '@orkestrel/process';
-import { ProcessCommand } from '@orkestrel/process';
-import { ProcessEventMap } from '@orkestrel/process';
-import { ProcessExit } from '@orkestrel/process';
-import { ProcessExit as ProcessExit_2 } from '@orkestrel/process';
-import { ProcessInterface } from '@orkestrel/process';
-import { ProcessInterface as ProcessInterface_2 } from '@orkestrel/process';
-import { ProcessManagerEventMap } from '@orkestrel/process';
-import { ProcessManagerInterface } from '@orkestrel/process';
-import { ProcessManagerInterface as ProcessManagerInterface_2 } from '@orkestrel/process';
-import { ProcessManagerOptions } from '@orkestrel/process';
-import { ProcessManagerOptions as ProcessManagerOptions_2 } from '@orkestrel/process';
-import { ProcessOptions } from '@orkestrel/process';
-import { ProcessOptions as ProcessOptions_2 } from '@orkestrel/process';
-import { Readable } from 'node:stream';
-import { SessionEventMap } from '@orkestrel/process';
-import { SessionInterface } from '@orkestrel/process';
-import { SessionInterface as SessionInterface_2 } from '@orkestrel/process';
-import { SessionOptions } from '@orkestrel/process';
-import { SessionOptions as SessionOptions_2 } from '@orkestrel/process';
-import { SpawnInput } from '@orkestrel/process';
+import type { DetachOptions } from '@orkestrel/process';
+import type { EmitterInterface } from '@orkestrel/emitter';
+import type { ExecutableOptions } from '@orkestrel/process';
+import type { ExecuteInput } from '@orkestrel/process';
+import type { ExecuteOptions } from '@orkestrel/process';
+import type { ExecuteResult } from '@orkestrel/process';
+import type { ExecuteSyncOptions } from '@orkestrel/process';
+import type { ProcessCommand } from '@orkestrel/process';
+import type { ProcessEventMap } from '@orkestrel/process';
+import type { ProcessExit } from '@orkestrel/process';
+import type { ProcessInterface } from '@orkestrel/process';
+import type { ProcessManagerEventMap } from '@orkestrel/process';
+import type { ProcessManagerInterface } from '@orkestrel/process';
+import type { ProcessManagerOptions } from '@orkestrel/process';
+import type { ProcessOptions } from '@orkestrel/process';
+import type { Readable } from 'node:stream';
+import type { SessionEventMap } from '@orkestrel/process';
+import type { SessionInterface } from '@orkestrel/process';
+import type { SessionOptions } from '@orkestrel/process';
+import type { SpawnInput } from '@orkestrel/process';
 
 /**
  * Builds the executable candidates an explicit platform would search.
  *
  * @remarks
  * Windows alone needs this list: the host searches the working directory before `PATH` and applies
- * `PATHEXT`, and Node reproduces neither for a direct spawn. Within each searched directory the
- * literal name is tried first and each `PATHEXT` candidate after it, whether or not the name already
- * carries an extension — so `report.txt` resolves to a `report.txt` file where one exists and to
- * `report.txt.cmd` where none does. The lookup reads the child's effective environment, so an
- * overridden `PATH` selects the executable the child would have found. A POSIX host resolves the
- * file itself, so the candidate list there is empty. An appended extension is spelled the way
- * `PATHEXT` spells it rather than the way the directory entry does, which the case-insensitive host
- * treats as the same file. A non-Windows platform returns an empty list because `execvp` performs
- * its own lookup.
+ * `PATHEXT`, and Node reproduces neither for a direct spawn. Within each searched directory,
+ * {@link buildExecutableCandidates} enumerates `PATHEXT` candidates for an extensionless name. For
+ * an extension-bearing name, it enumerates the literal path before `PATHEXT` candidates, so
+ * `report.txt` resolves to a `report.txt` file where one exists and to `report.txt.cmd` where none
+ * does. The lookup reads the child's effective environment, so an overridden `PATH` selects the
+ * executable the child would have found. A POSIX host resolves the file itself, so the candidate
+ * list there is empty. A `PATHEXT` candidate keeps the extension spelling from `PATHEXT`, which the
+ * case-insensitive host treats as the same file. A non-Windows platform returns an empty list
+ * because `execvp` performs its own lookup.
  *
  * @param file - The command executable name or path
  * @param workspace - The directory searched first
@@ -114,6 +107,10 @@ export declare function buildPlatformSpawn(command: ProcessCommand, file: string
 /**
  * Builds the resolved spawn form of one command for the current host.
  *
+ * @remarks
+ * When executable lookup returns no regular-file candidate, {@link buildSpawn} preserves the
+ * command file as written for native spawning.
+ *
  * @param command - The executable and its argument vector
  * @param options - The directory searched first and the child's effective environment
  * @returns The file, argument vector, and verbatim flag to spawn with
@@ -151,26 +148,37 @@ export declare function buildSpawn(command: ProcessCommand, options?: Executable
 export declare function captureChunk(chunk: unknown, room: number): Buffer_2 | undefined;
 
 /**
- * Creates one supervised child process.
+ * Creates one supervised child process and returns it as a {@link ProcessInterface}, so a caller
+ * holds the published contract rather than the `Process` class.
  *
  * @param options - Command, workspace, termination, evidence, stdin, and observation settings
  * @returns The launched {@link ProcessInterface}
  *
- * @example
+ * @example Supervise a child and read its lines
  * ```ts
  * import { createProcess } from '@orkestrel/process/server'
  *
  * const child = createProcess({
- * 	command: { file: 'node', arguments: ['--version'] },
+ * 	command: { file: 'node', arguments: ['-e', 'console.log("ready"); console.log("done")'] },
  * 	workspace: process.cwd(),
- * 	grace: 5000,
+ * 	grace: 5_000, // POSIX only: the window between SIGTERM and SIGKILL
  * })
+ *
+ * const lines: string[] = []
+ * for await (const line of child.lines) lines.push(line)
+ * lines // ['ready', 'done']
+ *
+ * const exit = await child.exit
+ * exit.code // 0
+ * await child.destroy()
  * ```
  */
 export declare function createProcess(options: ProcessOptions): ProcessInterface;
 
 /**
- * Creates one keyed registry of supervised child processes.
+ * Creates one empty keyed registry of supervised child processes and returns it as a
+ * {@link ProcessManagerInterface}, so a caller holds the published contract rather than the
+ * `ProcessManager` class.
  *
  * @param options - Initial fleet-level observation hooks and listener-error handling
  * @returns The {@link ProcessManagerInterface} registry
@@ -185,7 +193,8 @@ export declare function createProcess(options: ProcessOptions): ProcessInterface
 export declare function createProcessManager(options?: ProcessManagerOptions): ProcessManagerInterface;
 
 /**
- * Creates one raw byte session over a supervised child process.
+ * Creates one raw byte session over a supervised child process and returns it as a
+ * {@link SessionInterface}, so a caller holds the published contract rather than the `Session` class.
  *
  * @param options - Command, workspace, termination, evidence, stdin, and observation settings
  * @returns The launched {@link SessionInterface}
@@ -416,7 +425,8 @@ export declare function mergeEnvironment(isolated: boolean, base?: Readonly<Reco
 export declare function mergePlatformEnvironment(platform: NodeJS.Platform, parent: Readonly<Record<string, string | undefined>>, isolated: boolean, base?: Readonly<Record<string, string | undefined>>, override?: Readonly<Record<string, string | undefined>>): NodeJS.ProcessEnv;
 
 /**
- * Supervises one child while keeping every observation channel aligned at termination.
+ * Supervises one child, frames its standard output into lines under a bounded backlog, and keeps
+ * every observation channel aligned at termination.
  *
  * @remarks
  * The child's ending and the supervision's ending are distinct. `pid`, `code`, and `signal` read
@@ -446,7 +456,7 @@ export declare function mergePlatformEnvironment(platform: NodeJS.Platform, pare
  * await child.destroy()
  * ```
  */
-export declare class Process implements ProcessInterface_2 {
+export declare class Process implements ProcessInterface {
     #private;
     /**
      * Spawns one child process and begins stream capture.
@@ -454,7 +464,7 @@ export declare class Process implements ProcessInterface_2 {
      * @param options - Command, workspace, termination, capture, stdin, and observation settings
      * @throws A {@link ProcessError} coded `invalid` when an option or command string is malformed
      */
-    constructor(options: ProcessOptions_2);
+    constructor(options: ProcessOptions);
     /** Holds the host process id, fixed when construction returns, or `undefined` when the spawn produced none. */
     get pid(): number | undefined;
     /** Holds the exit code the host recorded, or `null` while the child has not exited and when a signal ended it. */
@@ -474,7 +484,7 @@ export declare class Process implements ProcessInterface_2 {
     /** Reports whether termination began, including after the terminal moment. */
     get stopping(): boolean;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
-    get exit(): Promise<ProcessExit_2>;
+    get exit(): Promise<ProcessExit>;
     /**
      * Writes one line to the open standard-input channel.
      *
@@ -587,7 +597,8 @@ export declare interface ProcessChildInterface {
 }
 
 /**
- * Represents a keyed registry of live supervised child processes.
+ * Launches supervised children under caller-chosen ids, evicts each one as it settles, and destroys
+ * every live child on teardown.
  *
  * @remarks
  * A child launched under an id joins the registry and emits `launch`; when it settles it removes
@@ -615,14 +626,14 @@ export declare interface ProcessChildInterface {
  * await manager.destroy()
  * ```
  */
-export declare class ProcessManager implements ProcessManagerInterface_2 {
+export declare class ProcessManager implements ProcessManagerInterface {
     #private;
     /**
      * Constructs a process registry.
      *
      * @param options - Initial fleet-level observation hooks and listener-error handling
      */
-    constructor(options?: ProcessManagerOptions_2);
+    constructor(options?: ProcessManagerOptions);
     /** Holds the typed fleet-level observation surface. */
     get emitter(): EmitterInterface<ProcessManagerEventMap>;
     /** Counts the live children. */
@@ -633,13 +644,13 @@ export declare class ProcessManager implements ProcessManagerInterface_2 {
      * @param id - The registry key
      * @returns The child, or `undefined`
      */
-    process(id: string): ProcessInterface_2 | undefined;
+    process(id: string): ProcessInterface | undefined;
     /**
      * Returns a snapshot of every live child.
      *
      * @returns The live children in launch order
      */
-    processes(): readonly ProcessInterface_2[];
+    processes(): readonly ProcessInterface[];
     /**
      * Spawns and registers one child under `id`.
      *
@@ -657,7 +668,7 @@ export declare class ProcessManager implements ProcessManagerInterface_2 {
      * @returns The launched child
      * @throws A {@link ProcessError} coded `duplicate` when `id` is already live, `protocol` when the registry is being destroyed, or `invalid` when an option or command string is malformed
      */
-    launch(id: string, options: ProcessOptions_2): ProcessInterface_2;
+    launch(id: string, options: ProcessOptions): ProcessInterface;
     /**
      * Terminates the named children and awaits their exit.
      *
@@ -745,7 +756,12 @@ export declare function readPlatformVariable(environment: Readonly<Record<string
 export declare function readVariable(environment: Readonly<Record<string, string | undefined>>, name: string): string | undefined;
 
 /**
- * Resolves a command file to the executable path the host would launch.
+ * Resolves a command file to the executable path the host would launch, or to `undefined` on a POSIX
+ * host, which performs its own lookup.
+ *
+ * @remarks
+ * A Windows lookup miss also returns `undefined`. {@link buildSpawn} preserves the command file as
+ * written for native spawning.
  *
  * @param file - The command executable name or path
  * @param options - The directory searched first and the child's effective environment
@@ -789,7 +805,7 @@ export declare function resolveExecutable(file: string, options?: ExecutableOpti
  * })
  * ```
  */
-export declare class Session implements SessionInterface_2 {
+export declare class Session implements SessionInterface {
     #private;
     /**
      * Spawns one child process and begins byte capture.
@@ -797,7 +813,7 @@ export declare class Session implements SessionInterface_2 {
      * @param options - Command, workspace, termination, evidence, stdin, and observation settings
      * @throws A {@link ProcessError} coded `invalid` when an option or command string is malformed
      */
-    constructor(options: SessionOptions_2);
+    constructor(options: SessionOptions);
     /** Holds the host process id, fixed when construction returns, or `undefined` when the spawn produced none. */
     get pid(): number | undefined;
     /** Holds the exit code the host recorded, or `null` while the child has not exited and when a signal ended it. */
@@ -815,7 +831,7 @@ export declare class Session implements SessionInterface_2 {
     /** Settles at the child's own ending, awaited without the terminal moment's drain window. */
     get ending(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
-    get exit(): Promise<ProcessExit_2>;
+    get exit(): Promise<ProcessExit>;
     /**
      * Writes raw bytes to the open standard-input channel.
      *
@@ -972,7 +988,7 @@ export declare class Supervisor {
      * @param face - The composing face's callbacks for each lifecycle moment
      * @throws A {@link ProcessError} coded `invalid` when an option or command string is malformed
      */
-    constructor(options: ProcessOptions_2, face: SupervisorFace);
+    constructor(options: ProcessOptions, face: SupervisorFace);
     /** Holds the child's standard-output stream, for the composing face to attach its own consumer to. */
     get stdout(): Readable;
     /** Holds the host process id, fixed when construction returns, or `undefined` when the spawn produced none. */
@@ -997,7 +1013,7 @@ export declare class Supervisor {
      */
     get ending(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
-    get exit(): Promise<ProcessExit_2>;
+    get exit(): Promise<ProcessExit>;
     /**
      * Writes raw bytes to the open standard-input channel.
      *