@alpacakit/agents 0.1.0-beta.20 → 0.1.0-beta.24

package/dist/core/node-controlled-exec.d.ts

@@ -0,0 +1,3 @@
+import type { ControlledExec, ControlledExecOptions } from "./controlled-process.js";
+export declare function createControlledExec(options: ControlledExecOptions): ControlledExec;
+//# sourceMappingURL=node-controlled-exec.d.ts.map

package/dist/core/node-controlled-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-controlled-exec.d.ts","sourceRoot":"","sources":["../../src/core/node-controlled-exec.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAajC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CA0BhB"}

package/dist/core/node-controlled-exec.js

@@ -0,0 +1,32 @@
+import path from "node:path";
+import { launchControlledProcess, recoverControlledProcess, } from "../internal/controlled-process/host-controller.js";
+import { withNodeBinFirst } from "./node-ports.js";
+const PACKAGE_ROOT = path.resolve(import.meta.dirname, "../..");
+const SUPERVISOR_ENTRY_PATH = path.join(PACKAGE_ROOT, "dist/internal/controlled-process/supervisor-entry.js");
+const SHIM_ENTRY_PATH = path.join(PACKAGE_ROOT, "dist/internal/controlled-process/shim-entry.js");
+export function createControlledExec(options) {
+    return {
+        spawn: async (worker, lifecycle) => {
+            const process = await launchControlledProcess({
+                supervisorEntryPath: SUPERVISOR_ENTRY_PATH,
+                shimEntryPath: SHIM_ENTRY_PATH,
+                runtimeDirectory: options.runtimeDirectory,
+                worker: { ...worker, env: withNodeBinFirst(worker.env) },
+                timing: options.termination,
+                lifecycle,
+            });
+            return {
+                chunks: process.chunks,
+                completion: process.completion,
+                requestTermination: process.requestTermination,
+            };
+        },
+        recovery: {
+            recover: (identity, lifecycle) => recoverControlledProcess({
+                identity,
+                runtimeDirectory: options.runtimeDirectory,
+                lifecycle,
+            }),
+        },
+    };
+}

package/dist/core/node-ports.d.ts

@@ -5,5 +5,6 @@
 import type { Clock, Exec, HttpClient } from "./ports.js";
 export declare const systemClock: Clock;
 export declare const fetchHttp: HttpClient;
+export declare function withNodeBinFirst(env: Record<string, string>): Record<string, string>;
 export declare const nodeExec: Exec;
 //# sourceMappingURL=node-ports.d.ts.map

package/dist/core/node-ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-ports.d.ts","sourceRoot":"","sources":["../../src/core/node-ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,KAAK,EACL,IAAI,EAIJ,UAAU,EAGX,MAAM,YAAY,CAAC;AAOpB,eAAO,MAAM,WAAW,EAAE,KAOzB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,UAEvB,CAAC;AA+HF,eAAO,MAAM,QAAQ,EAAE,IAGtB,CAAC"}
+{"version":3,"file":"node-ports.d.ts","sourceRoot":"","sources":["../../src/core/node-ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,KAAK,EACL,IAAI,EAIJ,UAAU,EAGX,MAAM,YAAY,CAAC;AAOpB,eAAO,MAAM,WAAW,EAAE,KAOzB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,UAEvB,CAAC;AAoBF,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAyGD,eAAO,MAAM,QAAQ,EAAE,IAGtB,CAAC"}

package/dist/core/node-ports.js

@@ -37,7 +37,7 @@ function pathKeyOf(env) {
     }
     return PATH_ENV_VAR;
 }
-function withNodeBinFirst(env) {
+export function withNodeBinFirst(env) {
     const key = pathKeyOf(env);
     const entries = (env[key] ?? "")
         .split(path.delimiter)
@@ -61,6 +61,11 @@ function spawnProcess(options) {
         settleExit = resolve;
         failExit = reject;
     });
+    void exit.catch(() => { });
+    let settleTermination = () => { };
+    const termination = new Promise((resolve) => {
+        settleTermination = resolve;
+    });
     child.stdout.setEncoding(TEXT_ENCODING);
     child.stderr.setEncoding(TEXT_ENCODING);
     child.stdout.on("data", (text) => {
@@ -72,10 +77,12 @@ function spawnProcess(options) {
     child.on("error", (error) => {
         chunks.end();
         failExit(error);
+        settleTermination();
     });
     child.on("close", (code, signal) => {
         chunks.end();
         settleExit({ code, signal });
+        settleTermination();
     });
     // A child that exits without reading stdin emits EPIPE here; without a
     // listener that unhandled 'error' event would crash the host process.
@@ -98,6 +105,7 @@ function spawnProcess(options) {
         kill: (signal) => {
             child.kill(signal);
         },
+        awaitTerminationEscalation: () => termination,
     };
 }
 function isExecutable(candidate) {

package/dist/core/ports.d.ts

@@ -32,6 +32,11 @@ export interface ExecProcess {
     readonly chunks: AsyncIterable<ExecChunk>;
     readonly exit: Promise<ExecExit>;
     kill(signal: ProcessSignal): void;
+    /**
+     * After termination is requested, resolve when the uncontrolled child has
+     * closed. Persistent controlled execution uses `ControlledExec` instead.
+     */
+    awaitTerminationEscalation(): Promise<void>;
 }
 /** Returned by interactive spawns; stdin capability is carried by the type. */
 export interface InteractiveExecProcess extends ExecProcess {

package/dist/core/ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,YAAY,EACV,KAAK,EACL,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,GAAG;IAC3D,aAAa,EAAE,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,+EAA+E;AAC/E,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,CAAC,OAAO,EAAE,2BAA2B,GAAG,sBAAsB,CAAC;IACpE,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAC9C,wEAAwE;IACxE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;CACrC;AAED,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7D;AAED,uDAAuD;AACvD,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,aAE3B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAExB,CAAC"}
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,YAAY,EACV,KAAK,EACL,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,GAAG;IAC3D,aAAa,EAAE,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,+EAA+E;AAC/E,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,CAAC,OAAO,EAAE,2BAA2B,GAAG,sBAAsB,CAAC;IACpE,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAC9C,wEAAwE;IACxE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;CACrC;AAED,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7D;AAED,uDAAuD;AACvD,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,aAE3B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAExB,CAAC"}

package/dist/fleet/fleet.d.ts.map

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

package/dist/fleet/fleet.js

@@ -6,7 +6,7 @@
  * effort defaults, and the linked signal are already folded in.
  */
 import { EMPTY_ENV_PATCH, mergeEnvPatches, } from "../core/env.js";
-import { AGENT_ERROR_CODE, AgentError, isAgentError, } from "../core/error.js";
+import { AGENT_ERROR_CODE, AGENT_FAILURE_CLASS, AgentError, isAgentError, } from "../core/error.js";
 import { totalKeyedHandler } from "../kernel/keyed.js";
 import { COOLDOWN_SCOPE, FAILURE_ACTION_KIND, resolveFailurePolicy, } from "./policy.js";
 import { memoryFleetStore, } from "./store.js";
@@ -118,6 +118,7 @@ function bindCandidate(agent, candidate, authPatch, fleetSignal) {
 function invalidCandidate(reason) {
     return new AgentError({
         code: AGENT_ERROR_CODE.invalidInput,
+        classification: AgentError.agentFailure(AGENT_ERROR_CODE.invalidInput),
         message: reason,
         data: { reason },
     });
@@ -305,7 +306,8 @@ class FailureActionApplier {
         this.clock = clock;
     }
     async apply(identity, error) {
-        if (!isPolicyCode(error.code)) {
+        if (error.failureClass === AGENT_FAILURE_CLASS.infrastructure ||
+            !isPolicyCode(error.code)) {
             return terminalDisposition(error);
         }
         const action = this.policy[error.code];
@@ -355,6 +357,7 @@ export function createFleet(options) {
                     status: FLEET_OUTCOME_STATUS.failed,
                     error: new AgentError({
                         code: AGENT_ERROR_CODE.cancelled,
+                        classification: AgentError.agentFailure(AGENT_ERROR_CODE.cancelled),
                         message: "Fleet run was cancelled",
                         data: { reason: null },
                     }),

package/dist/fleet/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/fleet/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAC1C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAgPD,wBAAgB,gBAAgB,IAAI,eAAe,CAElD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,GACZ,eAAe,CAEjB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/fleet/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAC1C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAsPD,wBAAgB,gBAAgB,IAAI,eAAe,CAElD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,GACZ,eAAe,CAEjB"}

package/dist/fleet/store.js

@@ -80,6 +80,7 @@ async function takeOverStaleLock(lockPath) {
         }
         throw new AgentError({
             code: AGENT_ERROR_CODE.failed,
+            classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
             message: `Could not take over stale fleet store lock: ${lockPath}`,
             data: { exitCode: null, stdoutTail: null, stderrTail: null },
             cause: error,
@@ -113,6 +114,7 @@ async function withFileLock(filePath, clock, task) {
                 // cannot help, so fail immediately with the real cause.
                 throw new AgentError({
                     code: AGENT_ERROR_CODE.failed,
+                    classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
                     message: `Could not create fleet store lock: ${lockPath}`,
                     data: { exitCode: null, stdoutTail: null, stderrTail: null },
                     cause: error,
@@ -125,6 +127,7 @@ async function withFileLock(filePath, clock, task) {
             if (attempt === LOCK_MAX_ATTEMPTS - 1) {
                 throw new AgentError({
                     code: AGENT_ERROR_CODE.failed,
+                    classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
                     message: `Timed out waiting for fleet store lock: ${lockPath}`,
                     data: { exitCode: null, stdoutTail: null, stderrTail: null },
                     cause: error,

package/dist/host/github-dir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-dir.d.ts","sourceRoot":"","sources":["../../src/host/github-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,OAAO,CACnC,WAAW,EACX;IAAE,IAAI,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAA;CAAE,CAC7C,CAAC;AAqKF,qEAAqE;AACrE,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC,CAWZ"}
+{"version":3,"file":"github-dir.d.ts","sourceRoot":"","sources":["../../src/host/github-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,OAAO,CACnC,WAAW,EACX;IAAE,IAAI,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAA;CAAE,CAC7C,CAAC;AA+KF,qEAAqE;AACrE,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/host/github-dir.js

@@ -49,6 +49,7 @@ function githubRepoParts(source) {
         repo === "") {
         throw new AgentError({
             code: AGENT_ERROR_CODE.invalidInput,
+            classification: AgentError.agentFailure(AGENT_ERROR_CODE.invalidInput),
             message: `Invalid GitHub repo "${source.repo}"`,
             data: { reason: "github-dir repo must be owner/name" },
         });
@@ -73,6 +74,7 @@ async function fetchJson(ctx, url) {
     if (!response.ok) {
         throw new AgentError({
             code: AGENT_ERROR_CODE.failed,
+            classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
             message: `GitHub skill fetch failed with status ${response.status}`,
             data: {
                 exitCode: null,
@@ -88,6 +90,7 @@ async function fetchBytes(ctx, url) {
     if (!response.ok) {
         throw new AgentError({
             code: AGENT_ERROR_CODE.failed,
+            classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
             message: `GitHub skill file fetch failed with status ${response.status}`,
             data: {
                 exitCode: null,
@@ -110,6 +113,7 @@ async function writeGithubFile(ctx, entry, targetPath) {
         if (downloadUrl === null) {
             throw new AgentError({
                 code: AGENT_ERROR_CODE.failed,
+                classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
                 message: "GitHub skill file is missing download_url",
                 data: { exitCode: null, stdoutTail: null, stderrTail: null },
             });
@@ -124,6 +128,7 @@ async function fetchGithubDirectory(ctx, source, remotePath, targetDir) {
     if (!Array.isArray(payload)) {
         throw new AgentError({
             code: AGENT_ERROR_CODE.invalidInput,
+            classification: AgentError.agentFailure(AGENT_ERROR_CODE.invalidInput),
             message: `GitHub skill source is not a directory: ${remotePath}`,
             data: { reason: "github-dir source must resolve to a directory" },
         });

package/dist/host/mcp-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-list.d.ts","sourceRoot":"","sources":["../../src/host/mcp-list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAyGhD,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAsB3B"}
+{"version":3,"file":"mcp-list.d.ts","sourceRoot":"","sources":["../../src/host/mcp-list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAyGhD,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAwB3B"}

package/dist/host/mcp-list.js

@@ -109,6 +109,7 @@ export async function listMcpServersViaCli(ctx, input) {
     catch (error) {
         throw new AgentError({
             code: AGENT_ERROR_CODE.failed,
+            classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
             message: "MCP server list output is not valid JSON",
             data: {
                 exitCode: result.exit.code,

package/dist/host/run-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/host/run-command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACtD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClD,OAAO,CAAC,iBAAiB,CAAC,CA+B5B;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,GACxB,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAc5C;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClD,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/host/run-command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACtD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClD,OAAO,CAAC,iBAAiB,CAAC,CAiC5B;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,GACxB,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAgB5C;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClD,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}

package/dist/host/run-command.js

@@ -13,6 +13,7 @@ export async function runHostCommandResult(ctx, input) {
     if (command === null) {
         throw new AgentError({
             code: AGENT_ERROR_CODE.notAvailable,
+            classification: AgentError.agentFailure(AGENT_ERROR_CODE.notAvailable),
             message: `Command "${input.command}" was not found on PATH`,
             data: { cause: NOT_AVAILABLE_CAUSE.notInstalled },
         });
@@ -49,6 +50,7 @@ export function hostCommandFailedError(command, result) {
     const stderrTail = result.stderr.slice(-OUTPUT_TAIL_CHARS);
     return new AgentError({
         code: AGENT_ERROR_CODE.failed,
+        classification: AgentError.agentFailure(AGENT_ERROR_CODE.failed),
         message: `Host command "${command}" failed with exit code ${result.exit.code ?? "null"}`,
         data: {
             exitCode: result.exit.code,

package/dist/index.d.ts

@@ -22,8 +22,11 @@ export { fileProfileStore, type ProfileStore } from "./auth/profile-store.js";
 export { envResolver, requireSecret } from "./auth/secrets.js";
 export type { EnvPatch } from "./core/env.js";
 export { applyEnvPatch, EMPTY_ENV_PATCH, mergeEnvPatches, processEnv, } from "./core/env.js";
-export type { AgentErrorCode, AgentErrorData, AgentErrorOptions, AuthFailureReason, GuardViolation, Issue, NotAvailableCause, TimeoutKind, } from "./core/error.js";
-export { AGENT_ERROR_CODE, AgentError, AUTH_FAILURE_REASON, isAgentError, NOT_AVAILABLE_CAUSE, TIMEOUT_KIND, } from "./core/error.js";
+export type { AgentErrorCode, AgentErrorData, AgentErrorOptions, AgentFailure, AgentFailureCode, AgentFailureClass, AgentInfrastructureFailureCode, AuthFailureReason, GuardViolation, Issue, NotAvailableCause, TimeoutKind, } from "./core/error.js";
+export { AGENT_ERROR_CODE, AGENT_FAILURE_CLASS, AGENT_INFRASTRUCTURE_FAILURE_CODE, AgentError, AUTH_FAILURE_REASON, agentFailure, infrastructureFailure, isAgentError, NOT_AVAILABLE_CAUSE, TIMEOUT_KIND, } from "./core/error.js";
+export type { ChildProcessAbsenceProof, ChildProcessCompletion, ChildProcessIdentity, ChildProcessLifecycle, ChildProcessTerminationEvidence, ChildProcessTerminationPhase, ChildProcessTerminationResult, ChildProcessUnkillableReason, ControlledExec, ControlledExecOptions, ControlledExecProcess, ControlledProcessRecovery, } from "./core/controlled-process.js";
+export { CHILD_PROCESS_TERMINATION_EVIDENCE_KIND, CHILD_PROCESS_ABSENCE_PROOF, CHILD_PROCESS_TERMINATION_KIND, CHILD_PROCESS_TERMINATION_PHASE, CHILD_PROCESS_UNKILLABLE_REASON, } from "./core/controlled-process.js";
+export { createControlledExec } from "./core/node-controlled-exec.js";
 export type { Clock, Exec, ExecChunk, ExecExit, ExecProcess, ExecSpawnOptions, HttpClient, InteractiveExecProcess, InteractiveExecSpawnOptions, Logger, LogLevel, Ports, SecretResolver, SecretResolvers, TelemetrySink, } from "./core/ports.js";
 export { LOG_LEVEL } from "./core/ports.js";
 export { redactJsonSecrets, redactSecrets } from "./core/redact.js";
@@ -56,7 +59,7 @@ export { referencedEnvNames, resolveEnvTemplate, } from "./kernel/env-template.j
 export type { AgentAuth, AgentDoctor, AgentLogin, AgentMcp, AgentSkills, } from "./kernel/facets.js";
 export type { Guard, GuardContext, GuardFactory } from "./kernel/guard.js";
 export { maxToolCalls, maxTurns, noProgress, repeatedOutput, } from "./kernel/guard.js";
-export type { Grant, Limits, ResolvedLimits, ResolvedRunOptions, ResolvedSandbox, RunOptions, Sandbox, SandboxMode, } from "./kernel/options.js";
+export type { ControlledChildProcessResource, Grant, Limits, ResolvedLimits, ResolvedRunResources, ResolvedRunOptions, ResolvedSandbox, RunOptions, RunResources, Sandbox, SandboxMode, } from "./kernel/options.js";
 export { GRANT_KIND, SANDBOX_MODE } from "./kernel/options.js";
 export type { Agent, AgentRuntime, AgentRuntimeOptions, } from "./kernel/runtime.js";
 export { createAgentRuntime, resolvePorts } from "./kernel/runtime.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -17,7 +17,9 @@ export { AUTH_MATERIAL_KIND, AUTH_STATUS, createApiKeyProfile, createHomeDirProf
 export { fileProfileStore } from "./auth/profile-store.js";
 export { envResolver, requireSecret } from "./auth/secrets.js";
 export { applyEnvPatch, EMPTY_ENV_PATCH, mergeEnvPatches, processEnv, } from "./core/env.js";
-export { AGENT_ERROR_CODE, AgentError, AUTH_FAILURE_REASON, isAgentError, NOT_AVAILABLE_CAUSE, TIMEOUT_KIND, } from "./core/error.js";
+export { AGENT_ERROR_CODE, AGENT_FAILURE_CLASS, AGENT_INFRASTRUCTURE_FAILURE_CODE, AgentError, AUTH_FAILURE_REASON, agentFailure, infrastructureFailure, isAgentError, NOT_AVAILABLE_CAUSE, TIMEOUT_KIND, } from "./core/error.js";
+export { CHILD_PROCESS_TERMINATION_EVIDENCE_KIND, CHILD_PROCESS_ABSENCE_PROOF, CHILD_PROCESS_TERMINATION_KIND, CHILD_PROCESS_TERMINATION_PHASE, CHILD_PROCESS_UNKILLABLE_REASON, } from "./core/controlled-process.js";
+export { createControlledExec } from "./core/node-controlled-exec.js";
 export { LOG_LEVEL } from "./core/ports.js";
 export { redactJsonSecrets, redactSecrets } from "./core/redact.js";
 export { AGENT_EVENT_TYPE, RUN_COMPLETION_KIND, RUN_EVENT_TYPE, RUN_OUTCOME, } from "./core/run.js";

package/dist/internal/controlled-process/authentication.d.ts

@@ -0,0 +1,13 @@
+import type { SupervisorAuthenticationResult, SupervisorCapability, SupervisorChallenge, SupervisorChallengeState, SupervisorClientChallenge, SupervisorClientProof, SupervisorServerNonce } from "./model.js";
+import { SUPERVISOR_CHALLENGE_STATE_KIND } from "./values.js";
+export type IssuedSupervisorChallenge = {
+    readonly challenge: SupervisorChallenge;
+    readonly state: Extract<SupervisorChallengeState, {
+        readonly kind: typeof SUPERVISOR_CHALLENGE_STATE_KIND.awaitingClient;
+    }>;
+};
+export declare function issueSupervisorChallenge(clientChallenge: SupervisorClientChallenge, serverNonce: SupervisorServerNonce, capability: SupervisorCapability): IssuedSupervisorChallenge;
+export declare function verifySupervisorChallenge(challenge: SupervisorChallenge, capability: SupervisorCapability): boolean;
+export declare function createClientProof(challenge: SupervisorChallenge, capability: SupervisorCapability): SupervisorClientProof;
+export declare function consumeClientProof(state: SupervisorChallengeState, proof: SupervisorClientProof, capability: SupervisorCapability): SupervisorAuthenticationResult;
+//# sourceMappingURL=authentication.d.ts.map

package/dist/internal/controlled-process/authentication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/authentication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,8BAA8B,EAC9B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EAExB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAKL,+BAA+B,EAEhC,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CACrB,wBAAwB,EACxB;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,+BAA+B,CAAC,cAAc,CAAA;KAAE,CACzE,CAAC;CACH,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,yBAAyB,EAC1C,WAAW,EAAE,qBAAqB,EAClC,UAAU,EAAE,oBAAoB,GAC/B,yBAAyB,CAsB3B;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAKT;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,oBAAoB,GAC/B,qBAAqB,CAavB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,wBAAwB,EAC/B,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,oBAAoB,GAC/B,8BAA8B,CA2ChC"}

package/dist/internal/controlled-process/authentication.js

@@ -0,0 +1,112 @@
+import { constantTimeMacEqual, createDomainSeparatedMac } from "./record.js";
+import { supervisorAuthenticationMacSchema } from "./schema.js";
+import { CONTROLLED_PROCESS_PROTOCOL_VERSION, SUPERVISOR_AUTHENTICATION_FRAME_KIND, SUPERVISOR_AUTHENTICATION_REJECTION_REASON, SUPERVISOR_AUTHENTICATION_RESULT_KIND, SUPERVISOR_CHALLENGE_STATE_KIND, SUPERVISOR_MAC_DOMAIN, } from "./values.js";
+export function issueSupervisorChallenge(clientChallenge, serverNonce, capability) {
+    const transcript = {
+        protocolVersion: CONTROLLED_PROCESS_PROTOCOL_VERSION,
+        recordId: clientChallenge.recordId,
+        clientNonce: clientChallenge.clientNonce,
+        serverNonce,
+    };
+    const supervisorMac = createSupervisorMac(transcript, capability);
+    return {
+        challenge: {
+            kind: SUPERVISOR_AUTHENTICATION_FRAME_KIND.supervisorChallenge,
+            recordId: transcript.recordId,
+            clientNonce: transcript.clientNonce,
+            serverNonce: transcript.serverNonce,
+            supervisorMac,
+        },
+        state: {
+            kind: SUPERVISOR_CHALLENGE_STATE_KIND.awaitingClient,
+            transcript,
+            supervisorMac,
+        },
+    };
+}
+export function verifySupervisorChallenge(challenge, capability) {
+    return constantTimeMacEqual(challenge.supervisorMac, createSupervisorMac(transcriptFromChallenge(challenge), capability));
+}
+export function createClientProof(challenge, capability) {
+    const transcript = transcriptFromChallenge(challenge);
+    if (!verifySupervisorChallenge(challenge, capability)) {
+        throw new Error("Supervisor challenge authentication failed.");
+    }
+    return {
+        kind: SUPERVISOR_AUTHENTICATION_FRAME_KIND.clientProof,
+        recordId: transcript.recordId,
+        clientNonce: transcript.clientNonce,
+        serverNonce: transcript.serverNonce,
+        supervisorMac: challenge.supervisorMac,
+        clientMac: createClientMac(transcript, challenge.supervisorMac, capability),
+    };
+}
+export function consumeClientProof(state, proof, capability) {
+    if (state.kind === SUPERVISOR_CHALLENGE_STATE_KIND.consumed) {
+        return rejected(state, SUPERVISOR_AUTHENTICATION_REJECTION_REASON.replay);
+    }
+    const consumedState = {
+        kind: SUPERVISOR_CHALLENGE_STATE_KIND.consumed,
+        transcript: state.transcript,
+        supervisorMac: state.supervisorMac,
+    };
+    if (!proofMatchesTranscript(proof, state.transcript)) {
+        return rejected(consumedState, SUPERVISOR_AUTHENTICATION_REJECTION_REASON.transcriptMismatch);
+    }
+    const expectedSupervisorMac = createSupervisorMac(state.transcript, capability);
+    if (!constantTimeMacEqual(state.supervisorMac, expectedSupervisorMac) ||
+        !constantTimeMacEqual(proof.supervisorMac, expectedSupervisorMac)) {
+        return rejected(consumedState, SUPERVISOR_AUTHENTICATION_REJECTION_REASON.invalidSupervisorMac);
+    }
+    const expectedClientMac = createClientMac(state.transcript, expectedSupervisorMac, capability);
+    if (!constantTimeMacEqual(proof.clientMac, expectedClientMac)) {
+        return rejected(consumedState, SUPERVISOR_AUTHENTICATION_REJECTION_REASON.invalidClientMac);
+    }
+    return {
+        kind: SUPERVISOR_AUTHENTICATION_RESULT_KIND.accepted,
+        state: consumedState,
+    };
+}
+function transcriptFromChallenge(challenge) {
+    return {
+        protocolVersion: CONTROLLED_PROCESS_PROTOCOL_VERSION,
+        recordId: challenge.recordId,
+        clientNonce: challenge.clientNonce,
+        serverNonce: challenge.serverNonce,
+    };
+}
+function encodeCanonicalChallengeTranscript(transcript) {
+    return JSON.stringify({
+        protocolVersion: transcript.protocolVersion,
+        recordId: transcript.recordId,
+        clientNonce: transcript.clientNonce,
+        serverNonce: transcript.serverNonce,
+    });
+}
+function encodeCanonicalClientTranscript(transcript, supervisorMac) {
+    return JSON.stringify({
+        protocolVersion: transcript.protocolVersion,
+        recordId: transcript.recordId,
+        clientNonce: transcript.clientNonce,
+        serverNonce: transcript.serverNonce,
+        supervisorMac,
+    });
+}
+function createSupervisorMac(transcript, capability) {
+    return supervisorAuthenticationMacSchema.parse(createDomainSeparatedMac(SUPERVISOR_MAC_DOMAIN.supervisorChallenge, encodeCanonicalChallengeTranscript(transcript), capability));
+}
+function createClientMac(transcript, supervisorMac, capability) {
+    return supervisorAuthenticationMacSchema.parse(createDomainSeparatedMac(SUPERVISOR_MAC_DOMAIN.clientProof, encodeCanonicalClientTranscript(transcript, supervisorMac), capability));
+}
+function proofMatchesTranscript(proof, transcript) {
+    return (proof.recordId === transcript.recordId &&
+        proof.clientNonce === transcript.clientNonce &&
+        proof.serverNonce === transcript.serverNonce);
+}
+function rejected(state, reason) {
+    return {
+        kind: SUPERVISOR_AUTHENTICATION_RESULT_KIND.rejected,
+        reason,
+        state,
+    };
+}

package/dist/internal/controlled-process/child-fd.d.ts

@@ -0,0 +1,5 @@
+import { type Readable, type Writable } from "node:stream";
+export declare function readableFd(fd: number): Readable;
+export declare function writableFd(fd: number): Writable;
+export declare function closeWritableFd(writable: Writable, fd: number): Promise<void>;
+//# sourceMappingURL=child-fd.d.ts.map

package/dist/internal/controlled-process/child-fd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-fd.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/child-fd.ts"],"names":[],"mappings":"AAKA,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIrE,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAE/C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAO/C;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/internal/controlled-process/child-fd.js

@@ -0,0 +1,47 @@
+import { close as closeFileDescriptor, createReadStream, createWriteStream, } from "node:fs";
+import { finished } from "node:stream";
+const IGNORED_FD_PATH = "/dev/null";
+export function readableFd(fd) {
+    return createReadStream(IGNORED_FD_PATH, { fd, autoClose: false });
+}
+export function writableFd(fd) {
+    const writable = createWriteStream(IGNORED_FD_PATH, {
+        fd,
+        autoClose: false,
+    });
+    writable.on("error", () => { });
+    return writable;
+}
+export async function closeWritableFd(writable, fd) {
+    if (!writable.destroyed && !writable.writableEnded) {
+        writable.end();
+    }
+    await settleWritable(writable);
+    await closeFd(fd);
+}
+function settleWritable(writable) {
+    return new Promise((resolve, reject) => {
+        let cleanup = () => { };
+        cleanup = finished(writable, { readable: false }, (error) => {
+            cleanup();
+            if (error === undefined || error === null) {
+                resolve();
+            }
+            else {
+                reject(error);
+            }
+        });
+    });
+}
+function closeFd(fd) {
+    return new Promise((resolve, reject) => {
+        closeFileDescriptor(fd, (error) => {
+            if (error === null) {
+                resolve();
+            }
+            else {
+                reject(error);
+            }
+        });
+    });
+}

package/dist/internal/controlled-process/framed-transport.d.ts

@@ -0,0 +1,6 @@
+import type { Readable, Writable } from "node:stream";
+import { type UnknownRecord } from "../../core/json.js";
+export declare function writeFramedRecord(writable: Writable, record: object): Promise<void>;
+export declare function readFramedRecords(readable: Readable): AsyncGenerator<UnknownRecord>;
+export declare function readRequiredFrame(frames: AsyncIterator<UnknownRecord>): Promise<UnknownRecord>;
+//# sourceMappingURL=framed-transport.d.ts.map

package/dist/internal/controlled-process/framed-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framed-transport.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/framed-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxE,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAQf;AA4ED,wBAAuB,iBAAiB,CACtC,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,aAAa,CAAC,CA4B/B;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CAMxB"}