@alpacakit/agents 0.1.0-beta.31 → 0.1.0-beta.36

package/dist/host/availability.js

@@ -0,0 +1,177 @@
+/**
+ * Agent execution availability (ambient, not profile-bound). Definitions own
+ * vendor-specific probes and remediation; the runtime only binds HostContext.
+ */
+import { PROCESS_SIGNAL } from "../core/values.js";
+export const AGENT_AVAILABILITY_STATUS = {
+    runnable: "runnable",
+    unavailable: "unavailable",
+    indeterminate: "indeterminate",
+};
+export const AGENT_UNAVAILABLE_REASON = {
+    commandMissing: "command_missing",
+    authenticationRequired: "authentication_required",
+};
+export const AGENT_INDETERMINATE_REASON = {
+    probeTimeout: "probe_timeout",
+    probeFault: "probe_fault",
+};
+/** The single bounded default for CLI availability subprocesses. */
+export const DEFAULT_AGENT_AVAILABILITY_PROBE_TIMEOUT_MS = 30_000;
+const AVAILABILITY_DETAIL = {
+    timeout: "Agent availability probe timed out.",
+    commandResolutionFault: "Agent availability probe failed during command resolution.",
+    spawnFault: "Agent availability probe failed while starting the command.",
+    processFault: "Agent availability probe process failed.",
+    cleanupFault: "Agent availability probe process cleanup failed.",
+    timerFault: "Agent availability probe timer failed.",
+};
+const PROBE_OBSERVATION_KIND = {
+    exit: "exit",
+    timeout: "timeout",
+    fault: "fault",
+};
+function probeFault(detail) {
+    return {
+        status: AGENT_AVAILABILITY_STATUS.indeterminate,
+        reason: AGENT_INDETERMINATE_REASON.probeFault,
+        detail,
+    };
+}
+async function observeProcess(child) {
+    const drain = (async () => {
+        for await (const _chunk of child.chunks) {
+            // Availability is exit-code-only. Never retain CLI output.
+        }
+    })();
+    try {
+        const [, exit] = await Promise.all([drain, child.exit]);
+        return { kind: PROBE_OBSERVATION_KIND.exit, code: exit.code };
+    }
+    catch {
+        return { kind: PROBE_OBSERVATION_KIND.fault };
+    }
+}
+async function stopProcess(child) {
+    try {
+        child.kill(PROCESS_SIGNAL.sigkill);
+        await child.awaitTerminationEscalation();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveAuthenticationObservation(observation, child, cancelTimeout, remediation) {
+    let timeoutCleanupFailed = false;
+    try {
+        cancelTimeout();
+    }
+    catch {
+        timeoutCleanupFailed = true;
+    }
+    if (observation.kind === PROBE_OBSERVATION_KIND.timeout) {
+        try {
+            await child.awaitTerminationEscalation();
+        }
+        catch {
+            return probeFault(AVAILABILITY_DETAIL.cleanupFault);
+        }
+        if (timeoutCleanupFailed) {
+            return probeFault(AVAILABILITY_DETAIL.cleanupFault);
+        }
+        return {
+            status: AGENT_AVAILABILITY_STATUS.indeterminate,
+            reason: AGENT_INDETERMINATE_REASON.probeTimeout,
+            detail: AVAILABILITY_DETAIL.timeout,
+        };
+    }
+    if (observation.kind === PROBE_OBSERVATION_KIND.fault) {
+        const stopped = await stopProcess(child);
+        return probeFault(stopped && !timeoutCleanupFailed
+            ? AVAILABILITY_DETAIL.processFault
+            : AVAILABILITY_DETAIL.cleanupFault);
+    }
+    if (timeoutCleanupFailed) {
+        return probeFault(AVAILABILITY_DETAIL.cleanupFault);
+    }
+    if (observation.code === 0) {
+        return { status: AGENT_AVAILABILITY_STATUS.runnable };
+    }
+    if (observation.code === null) {
+        return probeFault(AVAILABILITY_DETAIL.processFault);
+    }
+    return {
+        status: AGENT_AVAILABILITY_STATUS.unavailable,
+        reason: AGENT_UNAVAILABLE_REASON.authenticationRequired,
+        remediation,
+    };
+}
+/**
+ * Build a CLI definition-side availability capability. With no
+ * authentication command this is the generic PATH-only default.
+ */
+export function cliAvailability(options) {
+    return {
+        probe: async (ctx) => {
+            let command;
+            try {
+                command = await ctx.exec.which(options.command, ctx.env);
+            }
+            catch {
+                return probeFault(AVAILABILITY_DETAIL.commandResolutionFault);
+            }
+            if (command === null) {
+                return {
+                    status: AGENT_AVAILABILITY_STATUS.unavailable,
+                    reason: AGENT_UNAVAILABLE_REASON.commandMissing,
+                    remediation: options.commandMissingRemediation,
+                };
+            }
+            if (options.authentication === undefined) {
+                return { status: AGENT_AVAILABILITY_STATUS.runnable };
+            }
+            let child;
+            try {
+                child = ctx.exec.spawn({
+                    command,
+                    args: [...options.authentication.args],
+                    cwd: ctx.location.homeDir,
+                    env: ctx.env,
+                    stdin: null,
+                });
+            }
+            catch {
+                return probeFault(AVAILABILITY_DETAIL.spawnFault);
+            }
+            const processObservation = observeProcess(child);
+            let settleTimeout = () => { };
+            const timeoutObservation = new Promise((resolve) => {
+                settleTimeout = resolve;
+            });
+            let cancelTimeout;
+            try {
+                cancelTimeout = ctx.clock.setTimeout(() => {
+                    try {
+                        child.kill(PROCESS_SIGNAL.sigkill);
+                        settleTimeout({ kind: PROBE_OBSERVATION_KIND.timeout });
+                    }
+                    catch {
+                        settleTimeout({ kind: PROBE_OBSERVATION_KIND.fault });
+                    }
+                }, options.timeoutMs ?? DEFAULT_AGENT_AVAILABILITY_PROBE_TIMEOUT_MS);
+            }
+            catch {
+                const stopped = await stopProcess(child);
+                return probeFault(stopped
+                    ? AVAILABILITY_DETAIL.timerFault
+                    : AVAILABILITY_DETAIL.cleanupFault);
+            }
+            const observation = await Promise.race([
+                processObservation,
+                timeoutObservation,
+            ]);
+            return resolveAuthenticationObservation(observation, child, cancelTimeout, options.authentication.remediation);
+        },
+    };
+}

package/dist/host/command-doctor.d.ts

@@ -0,0 +1,4 @@
+import { type DoctorCapability } from "./capabilities.js";
+/** Default CLI Doctor: command presence only, with no auth inference. */
+export declare function cliCommandDoctor(commandName: string): DoctorCapability;
+//# sourceMappingURL=command-doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-doctor.d.ts","sourceRoot":"","sources":["../../src/host/command-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAmBtE"}

package/dist/host/command-doctor.js

@@ -0,0 +1,21 @@
+import { DOCTOR_CHECK_STATUS } from "./capabilities.js";
+/** Default CLI Doctor: command presence only, with no auth inference. */
+export function cliCommandDoctor(commandName) {
+    return {
+        probe: async (ctx) => {
+            const command = await ctx.exec.which(commandName, ctx.env);
+            return {
+                available: command !== null,
+                checks: [
+                    {
+                        id: "command-on-path",
+                        status: command === null
+                            ? DOCTOR_CHECK_STATUS.fail
+                            : DOCTOR_CHECK_STATUS.pass,
+                        detail: command,
+                    },
+                ],
+            };
+        },
+    };
+}

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * storage (`/config`).
  */
 export { BUILTIN_AGENT_ID, type BuiltinAgentId, builtinAgentFactories, } from "./agents/builtin.js";
-export { claude, structuredQuotaMatcher } from "./agents/claude.js";
+export { claude, type ClaudeOptions, structuredQuotaMatcher, } from "./agents/claude.js";
 export { capacityTextMatcher, codex } from "./agents/codex.js";
 export type { PiSessionEngineOptions } from "./agents/openai-compatible/pi/engine.js";
 export { PI_DEFAULT_CONTEXT_WINDOW, PI_DEFAULT_MAX_TOKENS, piSessionEngine, } from "./agents/openai-compatible/pi/engine.js";
@@ -20,12 +20,12 @@ export type { ApiKeyProfileOptions, AuthCapability, AuthMaterial, AuthMaterialDe
 export { AUTH_MATERIAL_KIND, AUTH_STATUS, createApiKeyProfile, createHomeDirProfile, envVarAuthMaterial, } from "./auth/material.js";
 export { fileProfileStore, type ProfileStore } from "./auth/profile-store.js";
 export { envResolver, requireSecret } from "./auth/secrets.js";
+export type { ChildProcessAbsenceProof, ChildProcessCompletion, ChildProcessIdentity, ChildProcessLifecycle, ChildProcessTerminationEvidence, ChildProcessTerminationPhase, ChildProcessTerminationResult, ChildProcessUnkillableReason, ControlledExec, ControlledExecOptions, ControlledExecProcess, ControlledProcessRecovery, } from "./core/controlled-process.js";
+export { CHILD_PROCESS_ABSENCE_PROOF, CHILD_PROCESS_TERMINATION_EVIDENCE_KIND, CHILD_PROCESS_TERMINATION_KIND, CHILD_PROCESS_TERMINATION_PHASE, CHILD_PROCESS_UNKILLABLE_REASON, } from "./core/controlled-process.js";
 export type { EnvPatch } from "./core/env.js";
 export { applyEnvPatch, EMPTY_ENV_PATCH, mergeEnvPatches, processEnv, } from "./core/env.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 type { AgentErrorCode, AgentErrorData, AgentErrorOptions, AgentFailure, AgentFailureClass, AgentFailureCode, AgentInfrastructureFailureCode, AuthFailureReason, ControlledProcessLaunchFailureCode, ControlledProcessLaunchFailureData, ControlledProcessLaunchFailureRetryability, GuardViolation, Issue, NotAvailableCause, TimeoutKind, } from "./core/error.js";
+export { AGENT_ERROR_CODE, AGENT_FAILURE_CLASS, AGENT_INFRASTRUCTURE_FAILURE_CODE, AgentError, AUTH_FAILURE_REASON, agentFailure, CONTROLLED_PROCESS_LAUNCH_FAILURE_CODE, CONTROLLED_PROCESS_LAUNCH_FAILURE_RETRYABILITY, infrastructureFailure, isAgentError, NOT_AVAILABLE_CAUSE, TIMEOUT_KIND, } from "./core/error.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";
@@ -36,12 +36,14 @@ export type { OutputChannel, ProcessSignal } from "./core/values.js";
 export { OUTPUT_CHANNEL, PROCESS_SIGNAL } from "./core/values.js";
 export type { FailureCorpusRecorder, FailureCorpusRecorderOptions, } from "./corpus/failure-corpus.js";
 export { createFailureCorpusRecorder } from "./corpus/failure-corpus.js";
-export type { AttemptStatus, AttemptTrace, Blocker, BlockerReason, Candidate, CandidateOptions, CreateFleetOptions, FleetAttemptRunOptions, Fleet, FleetOutcome, FleetPlainRunOptions, FleetOutcomeStatus, FleetRunOptions, FleetStructuredRunOptions, } from "./fleet/fleet.js";
+export type { AttemptStatus, AttemptTrace, Blocker, BlockerReason, Candidate, CandidateOptions, CreateFleetOptions, Fleet, FleetAttemptRunOptions, FleetOutcome, FleetOutcomeStatus, FleetPlainRunOptions, FleetRunOptions, FleetStructuredRunOptions, } from "./fleet/fleet.js";
 export { ATTEMPT_STATUS, BLOCKER_REASON, candidateForAgent, candidateFromProfile, candidateKey, createFleet, FLEET_OUTCOME_STATUS, profileCooldownKey, } from "./fleet/fleet.js";
 export type { CooldownScope, FailureAction, FailureActionKind, FailurePolicy, PolicyCode, } from "./fleet/policy.js";
 export { CAPACITY_DEFAULT_COOLDOWN_MS, COOLDOWN_SCOPE, defaultFailurePolicy, FAILURE_ACTION_KIND, QUOTA_DEFAULT_COOLDOWN_MS, } from "./fleet/policy.js";
 export type { CooldownKey, FleetStateStore } from "./fleet/store.js";
 export { fileFleetStore, memoryFleetStore } from "./fleet/store.js";
+export type { AgentAvailability, AgentAvailabilityCapability, AgentRemediation, } from "./host/availability.js";
+export { AGENT_AVAILABILITY_STATUS, AGENT_INDETERMINATE_REASON, AGENT_UNAVAILABLE_REASON, DEFAULT_AGENT_AVAILABILITY_PROBE_TIMEOUT_MS, } from "./host/availability.js";
 export type { DoctorCapability, DoctorCheck, DoctorReport, InstalledSkill, InstallOptions, InstallOutcome, McpAvailability, McpCapability, McpScope, McpServerSpec, McpServerState, McpTransport, SkillAvailability, SkillSource, SkillSourceKind, SkillsCapability, StdioMcpServerSpec, } from "./host/capabilities.js";
 export { CAPABILITY_AVAILABILITY_STATUS, checkMcpAvailability, checkSkillAvailability, DOCTOR_CHECK_STATUS, INSTALL_STATUS, MCP_SCOPE, MCP_TRANSPORT, SKILL_SOURCE_KIND, } from "./host/capabilities.js";
 export type { HostContext, HostLocation } from "./host/context.js";
@@ -56,10 +58,10 @@ export type { AgentDefinition, AgentRun, RunContext, } from "./kernel/definition
 export { defineAgent } from "./kernel/definition.js";
 export type { EnvTemplate, EnvTemplateResolution, } from "./kernel/env-template.js";
 export { referencedEnvNames, resolveEnvTemplate, } from "./kernel/env-template.js";
-export type { AgentAuth, AgentDoctor, AgentLogin, AgentMcp, AgentSkills, } from "./kernel/facets.js";
+export type { AgentAuth, AgentAvailabilityProbe, 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 { ControlledChildProcessResource, Grant, Limits, ResolvedLimits, ResolvedRunResources, ResolvedRunOptions, ResolvedSandbox, RunOptions, RunResources, Sandbox, SandboxMode, } from "./kernel/options.js";
+export type { ControlledChildProcessResource, Grant, Limits, ResolvedLimits, ResolvedRunOptions, ResolvedRunResources, 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

@@ -8,7 +8,7 @@
  * storage (`/config`).
  */
 export { BUILTIN_AGENT_ID, builtinAgentFactories, } from "./agents/builtin.js";
-export { claude, structuredQuotaMatcher } from "./agents/claude.js";
+export { claude, structuredQuotaMatcher, } from "./agents/claude.js";
 export { capacityTextMatcher, codex } from "./agents/codex.js";
 export { PI_DEFAULT_CONTEXT_WINDOW, PI_DEFAULT_MAX_TOKENS, piSessionEngine, } from "./agents/openai-compatible/pi/engine.js";
 export { openaiCompatible } from "./agents/openai-compatible.js";
@@ -16,9 +16,9 @@ export { LOGIN_EVENT_TYPE, LOGIN_METHOD } from "./auth/login.js";
 export { AUTH_MATERIAL_KIND, AUTH_STATUS, createApiKeyProfile, createHomeDirProfile, envVarAuthMaterial, } from "./auth/material.js";
 export { fileProfileStore } from "./auth/profile-store.js";
 export { envResolver, requireSecret } from "./auth/secrets.js";
+export { CHILD_PROCESS_ABSENCE_PROOF, CHILD_PROCESS_TERMINATION_EVIDENCE_KIND, CHILD_PROCESS_TERMINATION_KIND, CHILD_PROCESS_TERMINATION_PHASE, CHILD_PROCESS_UNKILLABLE_REASON, } from "./core/controlled-process.js";
 export { applyEnvPatch, EMPTY_ENV_PATCH, mergeEnvPatches, processEnv, } from "./core/env.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 { AGENT_ERROR_CODE, AGENT_FAILURE_CLASS, AGENT_INFRASTRUCTURE_FAILURE_CODE, AgentError, AUTH_FAILURE_REASON, agentFailure, CONTROLLED_PROCESS_LAUNCH_FAILURE_CODE, CONTROLLED_PROCESS_LAUNCH_FAILURE_RETRYABILITY, infrastructureFailure, isAgentError, NOT_AVAILABLE_CAUSE, TIMEOUT_KIND, } from "./core/error.js";
 export { createControlledExec } from "./core/node-controlled-exec.js";
 export { LOG_LEVEL } from "./core/ports.js";
 export { redactJsonSecrets, redactSecrets } from "./core/redact.js";
@@ -28,6 +28,7 @@ export { createFailureCorpusRecorder } from "./corpus/failure-corpus.js";
 export { ATTEMPT_STATUS, BLOCKER_REASON, candidateForAgent, candidateFromProfile, candidateKey, createFleet, FLEET_OUTCOME_STATUS, profileCooldownKey, } from "./fleet/fleet.js";
 export { CAPACITY_DEFAULT_COOLDOWN_MS, COOLDOWN_SCOPE, defaultFailurePolicy, FAILURE_ACTION_KIND, QUOTA_DEFAULT_COOLDOWN_MS, } from "./fleet/policy.js";
 export { fileFleetStore, memoryFleetStore } from "./fleet/store.js";
+export { AGENT_AVAILABILITY_STATUS, AGENT_INDETERMINATE_REASON, AGENT_UNAVAILABLE_REASON, DEFAULT_AGENT_AVAILABILITY_PROBE_TIMEOUT_MS, } from "./host/availability.js";
 export { CAPABILITY_AVAILABILITY_STATUS, checkMcpAvailability, checkSkillAvailability, DOCTOR_CHECK_STATUS, INSTALL_STATUS, MCP_SCOPE, MCP_TRANSPORT, SKILL_SOURCE_KIND, } from "./host/capabilities.js";
 export { parseMcpRequirementRef, parseSkillRequirementRef, } from "./host/requirement-ref.js";
 export { validateSpecSecrets } from "./host/validate-spec.js";

package/dist/internal/controlled-process/host-controller.d.ts

@@ -1,10 +1,11 @@
 import type { ChildProcessCompletion, ChildProcessIdentity, ChildProcessLifecycle, ChildProcessTerminationResult } from "../../core/controlled-process.js";
-import type { ControlledProcessOutput, SupervisorTimingOptions, SupervisorWorkerOptions } from "./supervisor-model.js";
+import type { ExecSpawnOptions } from "../../core/ports.js";
+import type { ControlledProcessOutput, SupervisorTimingOptions } from "./supervisor-model.js";
 export type ControlledProcessLaunchInput = {
     readonly supervisorEntryPath: string;
     readonly shimEntryPath: string;
     readonly runtimeDirectory: string;
-    readonly worker: SupervisorWorkerOptions;
+    readonly worker: ExecSpawnOptions;
     readonly timing: SupervisorTimingOptions;
     readonly lifecycle: ChildProcessLifecycle;
 };

package/dist/internal/controlled-process/host-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-controller.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/host-controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EAErB,6BAA6B,EAC9B,MAAM,kCAAkC,CAAC;AA+B1C,OAAO,KAAK,EACV,uBAAuB,EAEvB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAoC/B,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;CAC3C,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrD,kBAAkB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACvD;AAqED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CA2GtC;AAymBD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAC;CACrE,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA4BzC"}
+{"version":3,"file":"host-controller.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/host-controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EAErB,6BAA6B,EAC9B,MAAM,kCAAkC,CAAC;AAQ1C,OAAO,KAAK,EAAY,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA6BtE,OAAO,KAAK,EACV,uBAAuB,EAEvB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAqC/B,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;CAC3C,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrD,kBAAkB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACvD;AAsED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAoJtC;AAgnBD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAC;CACrE,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA4BzC"}

package/dist/internal/controlled-process/host-controller.js

@@ -1,7 +1,9 @@
 // biome-ignore-all lint/nursery/noExcessiveLinesPerFile: Section 5.103 confines the correction to this existing host lifecycle owner.
 import { spawn } from "node:child_process";
 import { CHILD_PROCESS_ABSENCE_PROOF, CHILD_PROCESS_TERMINATION_EVIDENCE_KIND, CHILD_PROCESS_TERMINATION_KIND, CHILD_PROCESS_UNKILLABLE_REASON, } from "../../core/controlled-process.js";
+import { CONTROLLED_PROCESS_LAUNCH_FAILURE_RETRYABILITY } from "../../core/error.js";
 import { readFramedRecords, readRequiredFrame, writeFramedRecord, } from "./framed-transport.js";
+import { ControlledProcessLaunchError, workerInputManifest, writeWorkerInput, } from "./input-transport.js";
 import { transitionControlledProcess } from "./lifecycle.js";
 import { controlledProcessRecordMatchesToken, signControlledProcessRecord, verifySignedControlledProcessRecord, } from "./record.js";
 import { assertSecureRuntimeDirectory, resolveSupervisorSocketNamespace, SignedRecordStore, supervisorSocketPath, } from "./record-store.js";
@@ -14,6 +16,7 @@ import { decodeProcessStartToken } from "./token.js";
 import { CONTROLLED_PROCESS_STATE } from "./values.js";
 const HOST_BOOTSTRAP_FD = 3;
 const HOST_IDENTITY_FD = 4;
+const HOST_INPUT_FD = 5;
 const OUTPUT_QUEUE_HIGH_WATER_BYTES = 64 * 1024;
 const OUTPUT_QUEUE_LOW_WATER_BYTES = 32 * 1024;
 const PRE_READY_CLEANUP_AUTHORITY = {
@@ -29,8 +32,9 @@ const TERMINATION_OBSERVATION_SOURCE = {
     supervisorClose: "supervisor_close",
     offlineFallback: "offline_fallback",
 };
-class SupervisorReportedLaunchFailure extends Error {
+class SupervisorReportedLaunchFailure extends ControlledProcessLaunchError {
 }
+// biome-ignore lint/complexity/noExcessiveLinesPerFunction: Launch, readiness, and pre-ready cleanup share one custody scope.
 export async function launchControlledProcess(input) {
     const platform = createSupervisorPlatformAdapter();
     const runtimeDirectory = await assertSecureRuntimeDirectory(input.runtimeDirectory, platform.uid);
@@ -39,6 +43,7 @@ export async function launchControlledProcess(input) {
     void supervisorClose.promise.catch(() => undefined);
     const control = supervisor.stdio[HOST_BOOTSTRAP_FD];
     const identityStream = supervisor.stdio[HOST_IDENTITY_FD];
+    const inputStream = supervisor.stdio.at(HOST_INPUT_FD);
     const identityFrames = readFramedRecords(identityStream)[Symbol.asyncIterator]();
     let output = null;
     let identity = null;
@@ -50,29 +55,52 @@ export async function launchControlledProcess(input) {
             kind: SUPERVISOR_BOOTSTRAP_FRAME_KIND.bootstrap,
             runtimeDirectory,
             shimEntryPath: input.shimEntryPath,
-            worker: input.worker,
+            worker: {
+                command: input.worker.command,
+                args: input.worker.args,
+                cwd: input.worker.cwd,
+                env: input.worker.env,
+            },
+            input: workerInputManifest(input.worker.stdin),
             timing: input.timing,
         });
+        const inputTransfer = writeWorkerInput(inputStream, input.worker.stdin);
+        void inputTransfer.catch(() => undefined);
         identity = await readSupervisorIdentity(identityFrames);
-        let hostAckComplete = false;
-        const readinessObservation = observeSupervisorReadiness(identityFrames, () => hostAckComplete);
+        let hostAckWriteStarted = false;
+        const readinessObservation = observeSupervisorReadiness(identityFrames, () => hostAckWriteStarted);
         await input.lifecycle.beforeExec(identity);
         descriptorCommitted = true;
+        hostAckWriteStarted = true;
         await writeFramedRecord(control, {
             kind: SUPERVISOR_BOOTSTRAP_FRAME_KIND.hostAck,
         });
-        hostAckComplete = true;
         control.end();
-        const readiness = await concludeSupervisorReadiness({
-            observation: readinessObservation,
-            identity,
-            runtimeDirectory,
-            supervisorClose,
-            timing: input.timing,
-        });
+        const [inputSettlement, readinessSettlement] = await Promise.allSettled([
+            inputTransfer,
+            concludeSupervisorReadiness({
+                observation: readinessObservation,
+                identity,
+                runtimeDirectory,
+                supervisorClose,
+                timing: input.timing,
+            }),
+        ]);
+        if (readinessSettlement.status === "rejected") {
+            throw readinessSettlement.reason;
+        }
+        const readiness = readinessSettlement.value;
         if (readiness.kind === "failure") {
             cleanupAuthority = readiness.cleanupAuthority;
-            throw readiness.error;
+            if (readiness.error instanceof SupervisorReportedLaunchFailure) {
+                throw readiness.error;
+            }
+            throw inputSettlement.status === "rejected"
+                ? inputSettlement.reason
+                : readiness.error;
+        }
+        if (inputSettlement.status === "rejected") {
+            throw inputSettlement.reason;
         }
         const readyIdentity = identity;
         let terminationRequested = false;
@@ -101,12 +129,14 @@ export async function launchControlledProcess(input) {
         };
     }
     catch (primaryFailure) {
-        if (primaryFailure instanceof SupervisorReportedLaunchFailure) {
+        if (primaryFailure instanceof SupervisorReportedLaunchFailure &&
+            identity === null) {
             cleanupAuthority = PRE_READY_CLEANUP_AUTHORITY.reportedFailure;
         }
         try {
             await cleanupPreReadySupervisor({
                 control,
+                inputStream,
                 identity,
                 descriptorCommitted,
                 runtimeDirectory,
@@ -118,26 +148,32 @@ export async function launchControlledProcess(input) {
             });
         }
         catch (cleanupFailure) {
+            if (primaryFailure instanceof ControlledProcessLaunchError) {
+                throw new ControlledProcessLaunchError({
+                    ...primaryFailure.failure,
+                    retryability: CONTROLLED_PROCESS_LAUNCH_FAILURE_RETRYABILITY.permanent,
+                }, new AggregateError([primaryFailure, cleanupFailure], `Controlled process launch and pre-ready cleanup both failed (${cleanupAuthority}).`));
+            }
             throw new AggregateError([primaryFailure, cleanupFailure], "Controlled process launch and pre-ready cleanup both failed.");
         }
         throw primaryFailure;
     }
 }
-function observeSupervisorReadiness(frames, hostAckComplete) {
+function observeSupervisorReadiness(frames, hostAckWriteStarted) {
     return frames.next().then((result) => ({
         kind: "result",
         result,
-        observedBeforeHostAck: !hostAckComplete(),
+        observedBeforeHostAckWrite: !hostAckWriteStarted(),
     }), (error) => ({
         kind: "failure",
         error,
-        observedBeforeHostAck: !hostAckComplete(),
+        observedBeforeHostAckWrite: !hostAckWriteStarted(),
     }));
 }
 async function concludeSupervisorReadiness(input) {
     const observation = await input.observation;
-    if (observation.observedBeforeHostAck) {
-        return readinessFailure(new Error("Supervisor readiness arrived before host ACK completed."), PRE_READY_CLEANUP_AUTHORITY.unprobed);
+    if (observation.observedBeforeHostAckWrite) {
+        return readinessFailure(new Error("Supervisor readiness arrived before the host ACK write began."), PRE_READY_CLEANUP_AUTHORITY.unprobed);
     }
     if (observation.kind === "failure") {
         return readinessFailure(observation.error, PRE_READY_CLEANUP_AUTHORITY.unprobed);
@@ -145,7 +181,7 @@ async function concludeSupervisorReadiness(input) {
     if (!observation.result.done) {
         const failure = supervisorLaunchFailedFrameSchema.safeParse(observation.result.value);
         if (failure.success) {
-            return readinessFailure(new Error(failure.data.reason), PRE_READY_CLEANUP_AUTHORITY.rollbackCompleted);
+            return readinessFailure(new SupervisorReportedLaunchFailure(failure.data.failure), PRE_READY_CLEANUP_AUTHORITY.live);
         }
         return readinessFailure(new Error("Supervisor readiness frame is invalid."), PRE_READY_CLEANUP_AUTHORITY.unprobed);
     }
@@ -209,6 +245,9 @@ async function cleanupPreReadySupervisor(input) {
     if (!input.control.destroyed && !input.control.writableEnded) {
         input.control.end();
     }
+    if (!input.inputStream.destroyed && !input.inputStream.writableEnded) {
+        input.inputStream.destroy();
+    }
     if (input.output !== null) {
         await input.output.queue[Symbol.asyncIterator]().return?.();
     }
@@ -377,7 +416,8 @@ async function raceSupervisorRequestWithClose(input) {
     return result;
 }
 function preReadyCleanupDeadline(timing) {
-    const budget = Math.min(Number.MAX_SAFE_INTEGER, timing.termGraceMs + timing.killProbeTimeoutMs + timing.probeIntervalMs);
+    const budget = Math.min(Number.MAX_SAFE_INTEGER, (timing.termGraceMs + timing.killProbeTimeoutMs + timing.probeIntervalMs) *
+        2);
     return Math.min(Number.MAX_SAFE_INTEGER, Date.now() + budget);
 }
 function beforeDeadline(operation, deadline, message) {
@@ -716,7 +756,7 @@ function spawnSupervisor(entryPath) {
     const child = spawn(process.execPath, [entryPath], {
         detached: true,
         env: {},
-        stdio: ["ignore", "pipe", "pipe", "pipe", "pipe"],
+        stdio: ["ignore", "pipe", "pipe", "pipe", "pipe", "pipe"],
     });
     containSupervisorStdioErrors(child);
     child.once("error", () => { });
@@ -777,7 +817,7 @@ async function readSupervisorIdentity(frames) {
     }
     const failure = supervisorLaunchFailedFrameSchema.safeParse(frame);
     if (failure.success) {
-        throw new SupervisorReportedLaunchFailure(failure.data.reason);
+        throw new SupervisorReportedLaunchFailure(failure.data.failure);
     }
     throw new Error("Supervisor identity frame is invalid.");
 }

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

@@ -0,0 +1,17 @@
+import type { Readable, Writable } from "node:stream";
+import type { ControlledProcessLaunchFailure, WorkerInputManifest } from "./supervisor-model.js";
+export declare class ControlledProcessLaunchError extends Error {
+    readonly failure: ControlledProcessLaunchFailure;
+    constructor(failure: ControlledProcessLaunchFailure, cause?: unknown);
+}
+export declare function workerInputManifest(input: string | null): WorkerInputManifest;
+export declare function writeWorkerInput(writable: Writable, input: string | null): Promise<void>;
+export declare function transferWorkerInput(input: {
+    readonly readable: Readable;
+    readonly writable: Writable;
+    readonly manifest: WorkerInputManifest;
+    readonly stage: ControlledProcessLaunchFailure["stage"];
+    readonly timeoutMs: number;
+}): Promise<void>;
+export declare function launchFailure(code: ControlledProcessLaunchFailure["code"], stage: ControlledProcessLaunchFailure["stage"], expectedBytes: number | null, actualBytes: number | null, message: string, cause?: unknown): ControlledProcessLaunchError;
+//# sourceMappingURL=input-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input-transport.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/input-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKtD,OAAO,KAAK,EACV,8BAA8B,EAC9B,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAK/B,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAC;gBAErC,OAAO,EAAE,8BAA8B,EAAE,KAAK,CAAC,EAAE,OAAO;CAKrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,mBAAmB,CAU7E;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAuGhB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,8BAA8B,CAAC,MAAM,CAAC,EAC5C,KAAK,EAAE,8BAA8B,CAAC,OAAO,CAAC,EAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,GACd,4BAA4B,CAW9B"}