@opengeni/worker-bundle 2.3.1 → 2.3.2-canary.37090756480001

package/dist/observability-metrics.d.ts

@@ -216,6 +216,11 @@ export declare function recordSandboxCheckpointArtifactGauges(observability: Obs
 export type SandboxCheckpointArtifactOutcome = "legacy_adopted" | "claimed" | "deleted" | "delete_failed" | "tombstone_pruned";
 export declare function recordSandboxCheckpointArtifactOutcome(observability: Observability, outcome: SandboxCheckpointArtifactOutcome, count?: number): void;
 export declare function recordSandboxDeadlineRotationsRequested(observability: Observability, count: number): void;
+/** Fixed outcomes of legacy retained-command containment: per-candidate
+ * enrollment inspection, then the enrolled drain's exact cold commit. */
+export declare const SANDBOX_COMMAND_CONTAINMENT_OUTCOMES: readonly ["idle_enrolled", "deadline_enrolled", "resumed_enrolled", "not_eligible", "inspection_failed", "contained", "provider_missing"];
+export type SandboxCommandContainmentOutcome = (typeof SANDBOX_COMMAND_CONTAINMENT_OUTCOMES)[number];
+export declare function recordSandboxCommandContainment(observability: Observability, outcome: SandboxCommandContainmentOutcome): void;
 /** Only call after the exact draining->cold commit reports wentCold. The
  * backend is validated against the closed contract so provider IDs and other
  * per-sandbox values can never become metric labels. */
@@ -256,7 +261,7 @@ export declare function recordExpiredDrainingSandboxLeaseGauges(observability: O
     ageBucket: string;
     count: number;
 }>): void;
-export declare const RETAINED_PROCESS_RECONCILIATION_OUTCOMES: readonly ["claim_failed", "proof_exited", "proof_lost", "proof_checkpoint_failed", "settled_exited", "settled_lost", "settlement_failed", "identity_mismatch", "resume_state_missing", "backend_unsupported", "provider_running", "provider_unknown", "provider_timeout", "provider_error", "provider_binding_missing", "provider_binding_mismatch", "provider_binding_adopted", "process_observation_unavailable", "quarantined_process_observation_unavailable", "quarantined_binding_missing", "quarantined_binding_mismatch", "defer_failed"];
+export declare const RETAINED_PROCESS_RECONCILIATION_OUTCOMES: readonly ["claim_failed", "background_recovered", "proof_exited", "proof_lost", "proof_checkpoint_failed", "settled_exited", "settled_lost", "settlement_failed", "identity_mismatch", "resume_state_missing", "backend_unsupported", "provider_running", "provider_unknown", "provider_timeout", "provider_error", "provider_binding_missing", "provider_binding_mismatch", "provider_binding_adopted", "process_observation_unavailable", "quarantined_process_observation_unavailable", "quarantined_binding_missing", "quarantined_binding_mismatch", "defer_failed"];
 export type RetainedProcessReconciliationOutcome = (typeof RETAINED_PROCESS_RECONCILIATION_OUTCOMES)[number];
 export declare function recordRetainedProcessReconciliation(observability: Observability, outcome: RetainedProcessReconciliationOutcome): void;
 export declare function recordCreditMicros(observability: Observability | undefined, kind: CreditMicrosKind, amountMicros: number): void;

package/dist/sandbox-resume.d.ts

@@ -1,3 +1,4 @@
+import type { EventBus } from "@opengeni/events";
 import { type Settings } from "@opengeni/config";
 import { readLease, reinstateTurnLeaseHolder, SandboxLeaseSupersededError, type Database, type LeaseHolderKind } from "@opengeni/db";
 import { establishSandboxSessionFromEnvelope, type EstablishedSandboxSession, type RuntimeMetricsHooks } from "@opengeni/runtime";
@@ -60,6 +61,8 @@ export type SandboxResumeServices = {
      * call. Absent, the call gets its own single replacement.
      */
     freshSandboxReadinessReplacementBudget?: FreshSandboxReadinessReplacementBudget;
+    /** Live fanout for background commands a provider loss settled. */
+    bus?: EventBus | null;
     /** Called only by the observer that wins the exact warm->cold loss CAS. */
     onSandboxLost?: (input: {
         sandboxGroupId: string;

package/dist/session-event-fanout.d.ts

@@ -0,0 +1,6 @@
+import type { SessionEvent } from "@opengeni/contracts";
+import type { EventBus } from "@opengeni/events";
+/** Best-effort live fanout of events that are already durable, grouped by
+ * session. Durable catch-up remains the source of truth, so failures are only
+ * reported. */
+export declare function publishDurableSessionEvents(bus: EventBus | null | undefined, workspaceId: string, events: readonly SessionEvent[] | undefined, onError?: (error: unknown) => void): Promise<void>;

package/dist/worker-service-lifecycle.d.ts

@@ -22,3 +22,15 @@ export declare function createWorkerServiceLifecycle(input: {
     closeOwnedResources: () => Promise<void>;
     onReady?: () => void;
 }): WorkerServiceLifecycle;
+/** A cleanup stall first drains peers through WORKER_SHUTDOWN. The standalone
+ * process owns the final exit, because Temporal cannot kill JavaScript writers.
+ * Embedded hosts may supply their own termination policy at this same edge. */
+export declare function createWorkerCleanupContainment(input: {
+    drain: () => boolean;
+    terminate?: () => void;
+    observability: Observability;
+    timeoutMs?: number;
+}): {
+    request(): void;
+    finished(): void;
+};