@loucompanion/forge-bridge 0.1.3-dev.d46a8e73d03d → 0.1.3-dev.eeefdb0d19c1

package/dist/runtime/host-runtime-lease.d.ts

@@ -0,0 +1,133 @@
+import type { RunOnceDispatchPacket } from "../session/session.types.js";
+import { type ProviderProcessRunner } from "../session/provider-cli/provider-cli.process.js";
+import { type RuntimeIsolationLease } from "./runtime-isolation-lease.js";
+import { type LoadedHostRuntimeContract } from "./host-runtime-contract.js";
+import { HostPortBroker } from "./host-port-broker.js";
+import { NodeHostRuntimeAdapter, type NodeRuntimeAdapterLaunch, type NodeRuntimeCommand, type NodeRuntimeCommandLauncher } from "./node-host-runtime-adapter.js";
+import { AttemptProcessSupervisorRegistry } from "./attempt-process-supervisor-registry.js";
+import { HostListenerInspector } from "./host-listener-inspector.js";
+import { PlaywrightHostRuntimeAdapter } from "./playwright-host-runtime-adapter.js";
+import { HostParallelPromotionStore } from "./host-runtime-promotion.js";
+import { type HostProcessRecovery } from "../shared/process/host-process-recovery.js";
+export interface HostRuntimeLeaseStart {
+    readonly lease: RuntimeIsolationLease;
+    readonly environment: Readonly<Record<string, string>>;
+    readonly runtimeContract: LoadedHostRuntimeContract;
+    readonly executionClass: HostRuntimeExecutionClass;
+}
+export type HostRuntimeExecutionClass = "analysis_only" | "managed_runtime";
+export type HostRuntimeSafetyClass = "host_serial_only" | "host_parallel_candidate" | "host_parallel_safe";
+export interface HostRuntimeProjectCapacitySnapshot {
+    readonly repoId: string;
+    readonly safetyClass: HostRuntimeSafetyClass;
+    readonly activeAttempts: number;
+    readonly reservedAttempts: number;
+    readonly waitingAttempts: number;
+    readonly degradedAttempts: number;
+    readonly runtimeContractFingerprint?: string | null;
+    readonly runtimeContractSource?: "project" | "derived" | null;
+    readonly promotedAt?: string | null;
+}
+export interface HostRuntimeCapacitySnapshot {
+    readonly activeAttempts: number;
+    readonly reservedAttempts: number;
+    readonly waitingAttempts: number;
+    readonly degradedAttempts: number;
+    readonly exclusiveReservations: number;
+    readonly sharedReservations: number;
+    readonly projects: readonly HostRuntimeProjectCapacitySnapshot[];
+}
+export interface HostRuntimeReapOptions {
+    readonly runnerId: string;
+    readonly runnerInstanceId: string;
+    readonly nowMs?: number;
+}
+export interface HostRuntimeReapReport {
+    readonly examined: number;
+    readonly reaped: number;
+    readonly processesTerminated: number;
+    readonly reusedPidsProtected: number;
+    readonly degraded: number;
+}
+export interface HostNodeRuntimeLaunch<T> extends NodeRuntimeAdapterLaunch<T> {
+    readonly runtimeLease: RuntimeIsolationLease;
+}
+export interface HostRuntimeLeaseRuntime {
+    acquire(dispatch: RunOnceDispatchPacket, signal?: AbortSignal): Promise<readonly string[]>;
+    start(dispatch: RunOnceDispatchPacket, worktreePath: string, signal?: AbortSignal): Promise<HostRuntimeLeaseStart>;
+    startConfiguredProject(dispatchAttemptId: string, fencingToken: string, signal?: AbortSignal): Promise<HostRuntimeLeaseStart>;
+    updateLease(dispatchAttemptId: string, fencingToken: string, expiresAt: string): Promise<void>;
+    providerProcessRunner?(dispatchAttemptId: string, fencingToken: string): ProviderProcessRunner | null;
+    release(dispatchAttemptId: string, fencingToken: string): Promise<RuntimeIsolationLease | null>;
+    invalidatePromotion?(repoId: string): Promise<void>;
+    reap?(options: HostRuntimeReapOptions): Promise<HostRuntimeReapReport>;
+    snapshot?(): HostRuntimeCapacitySnapshot;
+}
+export declare class HostRuntimeLeaseManager implements HostRuntimeLeaseRuntime {
+    private readonly stateRoot;
+    private readonly processSupervisors;
+    private readonly processRunner;
+    private readonly listenerInspector;
+    private readonly promotionStore;
+    private readonly playwrightAdapter;
+    private readonly processRecovery;
+    private readonly active;
+    private readonly pendingRenewals;
+    private readonly admissions;
+    private readonly singletonOwners;
+    private readonly singletonWaiters;
+    private readonly parallelProjectOwners;
+    private readonly parallelProjectWaiters;
+    private readonly degraded;
+    private readonly knownPromotions;
+    private readonly portBroker;
+    private readonly nodeAdapter;
+    constructor(stateRoot: string, portBroker?: HostPortBroker, nodeAdapter?: NodeHostRuntimeAdapter, processSupervisors?: AttemptProcessSupervisorRegistry, processRunner?: ProviderProcessRunner, listenerInspector?: HostListenerInspector, promotionStore?: HostParallelPromotionStore, playwrightAdapter?: PlaywrightHostRuntimeAdapter, processRecovery?: HostProcessRecovery);
+    reap(options: HostRuntimeReapOptions): Promise<HostRuntimeReapReport>;
+    snapshot(): HostRuntimeCapacitySnapshot;
+    acquire(dispatch: RunOnceDispatchPacket, signal?: AbortSignal): Promise<readonly string[]>;
+    private reserveSingletonKeys;
+    private reserveParallelProject;
+    start(dispatch: RunOnceDispatchPacket, worktreePath: string, signal?: AbortSignal): Promise<HostRuntimeLeaseStart>;
+    updateLease(dispatchAttemptId: string, fencingToken: string, expiresAt: string): Promise<void>;
+    startConfiguredProject(dispatchAttemptId: string, fencingToken: string, signal?: AbortSignal): Promise<HostRuntimeLeaseStart>;
+    providerProcessRunner(dispatchAttemptId: string, fencingToken: string): ProviderProcessRunner | null;
+    private promoteVerifiedRuntime;
+    launchNodeRuntime<T>(dispatchAttemptId: string, fencingToken: string, portName: string, command: NodeRuntimeCommand, launcher: NodeRuntimeCommandLauncher<T>, signal?: AbortSignal): Promise<HostNodeRuntimeLaunch<T>>;
+    release(dispatchAttemptId: string, fencingToken: string): Promise<RuntimeIsolationLease | null>;
+    private readLedgers;
+    private recoverPersistedProcesses;
+    private markLedgerDegraded;
+    private rememberDegraded;
+    private forgetDegraded;
+    private attemptRoot;
+    private writeLedger;
+    private ledgerPath;
+    private singletonKeysAvailable;
+    private assignSingletonKeys;
+    private releaseSingletonKeys;
+    private convertSingletonToParallelProject;
+    private parallelProjectOwned;
+    private parallelProjectAvailable;
+    private assignParallelProject;
+    private releaseParallelProjectNoDrain;
+    private releaseParallelProjects;
+    private deleteAdmission;
+    private renewAdmissionWaiterDeadline;
+    private clearPendingRenewal;
+    private cancelAdmissionWaiters;
+    private drainSingletonWaiters;
+    private drainParallelProjectWaiters;
+    private refreshKnownPromotions;
+    invalidatePromotion(repoId: string): Promise<void>;
+    private drainAdmissionWaiters;
+}
+export declare class HostRuntimeLeaseCleanupError extends Error {
+    readonly lease: RuntimeIsolationLease;
+    constructor(lease: RuntimeIsolationLease, cause: unknown);
+}
+export declare class HostRuntimeAdmissionExpiredError extends Error {
+    constructor();
+}
+export declare function hostRuntimeEventResources(lease: RuntimeIsolationLease, runtimeContract?: LoadedHostRuntimeContract, executionClass?: HostRuntimeExecutionClass): Record<string, unknown>;
+export declare function hostRuntimeSingletonKeys(dispatch: RunOnceDispatchPacket): readonly string[];