@evermore.work/server 2026.509.0-canary.0

package/dist/services/environment-runtime.d.ts

@@ -0,0 +1,90 @@
+import type { Db } from "@evermore.work/db";
+import type { Environment, EnvironmentLease, EnvironmentLeaseStatus, ExecutionWorkspace, SandboxEnvironmentConfig } from "@evermore.work/shared";
+import type { PluginEnvironmentExecuteResult, PluginEnvironmentLease, PluginEnvironmentRealizeWorkspaceResult } from "@evermore.work/plugin-sdk";
+import type { PluginWorkerManager } from "./plugin-worker-manager.js";
+export declare function buildEnvironmentLeaseContext(input: {
+    persistedExecutionWorkspace: Pick<ExecutionWorkspace, "id" | "mode"> | null;
+}): {
+    executionWorkspaceId: string | null;
+    executionWorkspaceMode: "adapter_managed" | "cloud_sandbox" | "shared_workspace" | "isolated_workspace" | "operator_branch" | null;
+};
+export interface EnvironmentDriverAcquireInput {
+    companyId: string;
+    environment: Environment;
+    issueId: string | null;
+    /**
+     * UUID of the owning heartbeat run, or null for ad-hoc invocations
+     * (e.g. operator-initiated `Test` probes) that are not tied to a run.
+     * Null leases must be released by id via `getDriver(...).releaseRunLease`
+     * since `releaseRunLeases(heartbeatRunId)` cannot find them.
+     */
+    heartbeatRunId: string | null;
+    executionWorkspaceId: string | null;
+    executionWorkspaceMode: ExecutionWorkspace["mode"] | null;
+}
+export interface EnvironmentDriverReleaseInput {
+    environment: Environment;
+    lease: EnvironmentLease;
+    status: Extract<EnvironmentLeaseStatus, "released" | "expired" | "failed">;
+}
+export interface EnvironmentDriverLeaseInput {
+    environment: Environment;
+    lease: EnvironmentLease;
+}
+export interface EnvironmentDriverRealizeWorkspaceInput extends EnvironmentDriverLeaseInput {
+    workspace: {
+        localPath?: string;
+        remotePath?: string;
+        mode?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface EnvironmentDriverExecuteInput extends EnvironmentDriverLeaseInput {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    stdin?: string;
+    timeoutMs?: number;
+}
+export interface EnvironmentRuntimeDriver {
+    readonly driver: string;
+    acquireRunLease(input: EnvironmentDriverAcquireInput): Promise<EnvironmentLease>;
+    releaseRunLease(input: EnvironmentDriverReleaseInput): Promise<EnvironmentLease | null>;
+    resumeRunLease?(input: EnvironmentDriverLeaseInput): Promise<PluginEnvironmentLease | EnvironmentLease | null>;
+    destroyRunLease?(input: EnvironmentDriverLeaseInput): Promise<EnvironmentLease | null>;
+    realizeWorkspace?(input: EnvironmentDriverRealizeWorkspaceInput): Promise<PluginEnvironmentRealizeWorkspaceResult>;
+    execute?(input: EnvironmentDriverExecuteInput): Promise<PluginEnvironmentExecuteResult>;
+}
+export interface EnvironmentRuntimeLeaseRecord {
+    environment: Environment;
+    lease: EnvironmentLease;
+    leaseContext: ReturnType<typeof buildEnvironmentLeaseContext>;
+}
+export declare function findReusableSandboxLeaseId(input: {
+    config: SandboxEnvironmentConfig;
+    leases: Array<Pick<EnvironmentLease, "providerLeaseId" | "metadata">>;
+}): string | null;
+export declare function environmentRuntimeService(db: Db, options?: {
+    drivers?: EnvironmentRuntimeDriver[];
+    pluginWorkerManager?: PluginWorkerManager;
+    pluginWorkerReadyTimeoutMs?: number;
+    pluginWorkerReadyPollMs?: number;
+}): {
+    getDriver: (driverKey: string) => EnvironmentRuntimeDriver | null;
+    acquireRunLease(input: {
+        companyId: string;
+        environment: Environment;
+        issueId: string | null;
+        /** Null for ad-hoc invocations (e.g. operator-initiated `Test` probes). */
+        heartbeatRunId: string | null;
+        persistedExecutionWorkspace: Pick<ExecutionWorkspace, "id" | "mode"> | null;
+    }): Promise<EnvironmentRuntimeLeaseRecord>;
+    releaseRunLeases(heartbeatRunId: string, status?: Extract<EnvironmentLeaseStatus, "released" | "expired" | "failed">): Promise<EnvironmentRuntimeLeaseRecord[]>;
+    resumeRunLease(input: EnvironmentDriverLeaseInput): Promise<PluginEnvironmentLease | EnvironmentLease | null>;
+    destroyRunLease(input: EnvironmentDriverLeaseInput): Promise<EnvironmentLease | null>;
+    realizeWorkspace(input: EnvironmentDriverRealizeWorkspaceInput): Promise<PluginEnvironmentRealizeWorkspaceResult>;
+    execute(input: EnvironmentDriverExecuteInput): Promise<PluginEnvironmentExecuteResult>;
+};
+export type EnvironmentRuntimeService = ReturnType<typeof environmentRuntimeService>;
+//# sourceMappingURL=environment-runtime.d.ts.map

package/dist/services/environment-runtime.d.ts.map

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