@opengeni/worker-bundle 0.16.21 → 0.17.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/dist/activities/agent-turn.d.ts +145 -32
  2. package/dist/activities/api-integrations.d.ts +21 -0
  3. package/dist/activities/codemode-dispatcher.d.ts +35 -0
  4. package/dist/activities/codemode-token-renewal.d.ts +23 -0
  5. package/dist/activities/codex-capacity.d.ts +5 -5
  6. package/dist/activities/codex-image-generation.d.ts +21 -0
  7. package/dist/activities/context-compaction.d.ts +3 -0
  8. package/dist/activities/documents.d.ts +3 -2
  9. package/dist/activities/environment.d.ts +11 -7
  10. package/dist/activities/expiring-material-renewal.d.ts +5 -3
  11. package/dist/activities/file-upload-reaper.d.ts +7 -2
  12. package/dist/activities/gateway-image-generation.d.ts +39 -0
  13. package/dist/activities/gateway-video-generation.d.ts +53 -0
  14. package/dist/activities/generated-images.d.ts +112 -0
  15. package/dist/activities/git-credential-renewal.d.ts +2 -2
  16. package/dist/activities/goals.d.ts +2 -2
  17. package/dist/activities/google-drive-changes.d.ts +99 -0
  18. package/dist/activities/image-generation-operation.d.ts +74 -0
  19. package/dist/activities/image-generation-references.d.ts +25 -0
  20. package/dist/activities/knowledge-source-sync-driver.d.ts +23 -0
  21. package/dist/activities/knowledge-source-sync.d.ts +75 -0
  22. package/dist/activities/packs.d.ts +13 -26
  23. package/dist/activities/parent-wake.d.ts +1 -1
  24. package/dist/activities/retained-screenshot-reaper.d.ts +32 -0
  25. package/dist/activities/retained-screenshots.d.ts +129 -0
  26. package/dist/activities/rig-verification.d.ts +82 -5
  27. package/dist/activities/run-credential-renewal.d.ts +2 -2
  28. package/dist/activities/run-input.d.ts +5 -1
  29. package/dist/activities/sandbox-images.d.ts +14 -0
  30. package/dist/activities/sandbox-lease.d.ts +47 -9
  31. package/dist/activities/scheduled-tasks.d.ts +2 -2
  32. package/dist/activities/session-state.d.ts +4 -4
  33. package/dist/activities/streaming.d.ts +1 -1
  34. package/dist/activities/types.d.ts +71 -5
  35. package/dist/activities/video-generation-admission.d.ts +38 -0
  36. package/dist/activities/video-generation-credential.d.ts +7 -0
  37. package/dist/activities/video-generation-reconciliation.d.ts +13 -0
  38. package/dist/activities/video-media-validation.d.ts +34 -0
  39. package/dist/activities/video-output-retention.d.ts +36 -0
  40. package/dist/activities/video-reference-staging.d.ts +49 -0
  41. package/dist/activities/workflow-wake.d.ts +2 -2
  42. package/dist/activities/workspace-capture.d.ts +11 -1
  43. package/dist/activities-control-44KBWLSM.js +6885 -0
  44. package/dist/activities-control-44KBWLSM.js.map +1 -0
  45. package/dist/activities-control.d.ts +289 -0
  46. package/dist/activities-turn-K4CEDEGJ.js +14675 -0
  47. package/dist/activities-turn-K4CEDEGJ.js.map +1 -0
  48. package/dist/activities-turn.d.ts +17 -0
  49. package/dist/activities.d.ts +130 -147
  50. package/dist/activity-services.d.ts +10 -0
  51. package/dist/artifact-materializer-entry.d.ts +6 -0
  52. package/dist/artifact-materializer-entry.js +2662 -0
  53. package/dist/artifact-materializer-entry.js.map +1 -0
  54. package/dist/artifact-outbox-entry.d.ts +2 -0
  55. package/dist/artifact-outbox-entry.js +681 -0
  56. package/dist/artifact-outbox-entry.js.map +1 -0
  57. package/dist/chunk-E3RI3I33.js +828 -0
  58. package/dist/chunk-E3RI3I33.js.map +1 -0
  59. package/dist/chunk-GRFQTTSQ.js +448 -0
  60. package/dist/chunk-GRFQTTSQ.js.map +1 -0
  61. package/dist/chunk-KKCRGAGZ.js +3091 -0
  62. package/dist/chunk-KKCRGAGZ.js.map +1 -0
  63. package/dist/{chunk-BJUW5LCM.js → chunk-RAMNYSAW.js} +15 -12
  64. package/dist/chunk-RAMNYSAW.js.map +1 -0
  65. package/dist/concurrency.d.ts +108 -5
  66. package/dist/editable-artifact-hint-broker.d.ts +49 -0
  67. package/dist/editable-artifact-materializer-launcher.d.ts +49 -0
  68. package/dist/editable-artifact-materializer-service.d.ts +108 -0
  69. package/dist/editable-artifact-materializer-storage.d.ts +12 -0
  70. package/dist/editable-artifact-materializer-subprocess.d.ts +50 -0
  71. package/dist/editable-artifact-materializer.d.ts +262 -0
  72. package/dist/editable-artifact-outbox-dispatcher.d.ts +44 -0
  73. package/dist/editable-artifact-outbox-service.d.ts +70 -0
  74. package/dist/host-export.d.ts +1 -1
  75. package/dist/host-export.js +1 -1
  76. package/dist/index.d.ts +176 -10
  77. package/dist/index.js +675 -16460
  78. package/dist/index.js.map +1 -1
  79. package/dist/memory-pressure-guard.d.ts +57 -0
  80. package/dist/model-checkpoint-memory-collector.d.ts +22 -0
  81. package/dist/observability-metrics.d.ts +33 -0
  82. package/dist/sandbox-reaper-contract.d.ts +40 -0
  83. package/dist/sandbox-reaper-timeout.d.ts +14 -0
  84. package/dist/sandbox-resume.d.ts +40 -7
  85. package/dist/sandbox-routing.d.ts +13 -6
  86. package/dist/worker-service-lifecycle.d.ts +6 -2
  87. package/dist/workflow-bundle.js +1044 -363
  88. package/dist/workflows/activities.d.ts +7 -1
  89. package/dist/workflows/document-index.d.ts +1 -1
  90. package/dist/workflows/knowledge-source-sync.d.ts +13 -0
  91. package/dist/workflows/rig-verification.d.ts +1 -1
  92. package/dist/workflows/sandbox-reaper.d.ts +8 -0
  93. package/dist/workflows/scheduled-tasks.d.ts +1 -1
  94. package/dist/workflows/session.d.ts +2 -2
  95. package/dist/workflows/video-generation.d.ts +10 -0
  96. package/dist/workflows/workflow-wake.d.ts +1 -1
  97. package/dist/workflows.d.ts +9 -7
  98. package/package.json +34 -15
  99. package/src/activities/agent-turn.ts +1905 -559
  100. package/src/activities/api-integrations.ts +138 -0
  101. package/src/activities/codemode-dispatcher.ts +335 -0
  102. package/src/activities/codemode-token-renewal.ts +64 -0
  103. package/src/activities/codex-capacity.ts +16 -7
  104. package/src/activities/codex-image-generation.ts +56 -0
  105. package/src/activities/codex-rotation.ts +19 -5
  106. package/src/activities/context-compaction.ts +47 -6
  107. package/src/activities/documents.ts +14 -4
  108. package/src/activities/environment.ts +52 -60
  109. package/src/activities/expiring-material-renewal.ts +16 -7
  110. package/src/activities/file-upload-reaper.ts +34 -3
  111. package/src/activities/gateway-image-generation.ts +146 -0
  112. package/src/activities/gateway-video-generation.ts +298 -0
  113. package/src/activities/generated-images.ts +860 -0
  114. package/src/activities/git-credential-renewal.ts +3 -3
  115. package/src/activities/goals.ts +6 -2
  116. package/src/activities/google-drive-changes.ts +454 -0
  117. package/src/activities/image-generation-operation.ts +333 -0
  118. package/src/activities/image-generation-references.ts +118 -0
  119. package/src/activities/knowledge-source-sync-driver.ts +27 -0
  120. package/src/activities/knowledge-source-sync.ts +2840 -0
  121. package/src/activities/mcp-credentials.ts +1 -0
  122. package/src/activities/packs.ts +55 -55
  123. package/src/activities/recording.ts +4 -5
  124. package/src/activities/retained-screenshot-reaper.ts +202 -0
  125. package/src/activities/retained-screenshots.ts +1317 -0
  126. package/src/activities/rig-verification.ts +567 -77
  127. package/src/activities/run-credential-renewal.ts +9 -2
  128. package/src/activities/run-input.ts +40 -10
  129. package/src/activities/sandbox-images.ts +167 -0
  130. package/src/activities/sandbox-lease.ts +1065 -483
  131. package/src/activities/scheduled-tasks.ts +96 -7
  132. package/src/activities/session-state.ts +4 -4
  133. package/src/activities/streaming.ts +42 -3
  134. package/src/activities/types.ts +87 -5
  135. package/src/activities/video-generation-admission.ts +270 -0
  136. package/src/activities/video-generation-credential.ts +34 -0
  137. package/src/activities/video-generation-reconciliation.ts +578 -0
  138. package/src/activities/video-media-validation.ts +326 -0
  139. package/src/activities/video-output-retention.ts +314 -0
  140. package/src/activities/video-reference-staging.ts +263 -0
  141. package/src/activities/workflow-wake.ts +2 -2
  142. package/src/activities/workspace-capture.ts +77 -13
  143. package/src/activities-control.ts +54 -0
  144. package/src/activities-turn.ts +40 -0
  145. package/src/activities.ts +50 -118
  146. package/src/activity-services.ts +62 -0
  147. package/src/artifact-materializer-entry.ts +35 -0
  148. package/src/artifact-outbox-entry.ts +29 -0
  149. package/src/concurrency.ts +484 -6
  150. package/src/editable-artifact-hint-broker.ts +235 -0
  151. package/src/editable-artifact-materializer-launcher.ts +515 -0
  152. package/src/editable-artifact-materializer-service.ts +787 -0
  153. package/src/editable-artifact-materializer-storage.ts +413 -0
  154. package/src/editable-artifact-materializer-subprocess.ts +956 -0
  155. package/src/editable-artifact-materializer.ts +1289 -0
  156. package/src/editable-artifact-outbox-dispatcher.ts +244 -0
  157. package/src/editable-artifact-outbox-service.ts +438 -0
  158. package/src/host-export-pump.ts +28 -11
  159. package/src/http.ts +3 -6
  160. package/src/index.ts +277 -72
  161. package/src/memory-pressure-guard.ts +489 -0
  162. package/src/model-checkpoint-memory-collector.ts +116 -0
  163. package/src/observability-metrics.ts +202 -7
  164. package/src/sandbox-reaper-contract.ts +73 -0
  165. package/src/sandbox-reaper-timeout.ts +79 -0
  166. package/src/sandbox-resume.ts +331 -157
  167. package/src/sandbox-routing.ts +49 -39
  168. package/src/worker-service-lifecycle.ts +82 -12
  169. package/src/workflows/activities.ts +30 -0
  170. package/src/workflows/file-upload-reaper.ts +6 -1
  171. package/src/workflows/knowledge-source-sync.ts +83 -0
  172. package/src/workflows/sandbox-reaper.ts +183 -21
  173. package/src/workflows/scheduled-tasks.ts +42 -6
  174. package/src/workflows/video-generation.ts +36 -0
  175. package/src/workflows.ts +17 -1
  176. package/dist/activities/redaction.d.ts +0 -1
  177. package/dist/activities/toolspace-token-renewal.d.ts +0 -23
  178. package/dist/chunk-BJUW5LCM.js.map +0 -1
  179. package/src/activities/redaction.ts +0 -9
  180. package/src/activities/toolspace-token-renewal.ts +0 -57
@@ -0,0 +1,57 @@
1
+ import type { Settings } from "@opengeni/config";
2
+ import type { Observability } from "@opengeni/observability";
3
+ export type TurnWorkerMemoryScope = "host" | "cgroup";
4
+ export type TurnWorkerMemoryScopeSnapshot = {
5
+ scope: TurnWorkerMemoryScope;
6
+ usedBytes: number;
7
+ limitBytes: number;
8
+ };
9
+ export type TurnWorkerMemoryPressureSnapshot = {
10
+ processRssBytes: number;
11
+ processHeapUsedBytes: number;
12
+ processExternalBytes: number;
13
+ processArrayBuffersBytes: number;
14
+ scopes: TurnWorkerMemoryScopeSnapshot[];
15
+ };
16
+ export type TurnWorkerMemoryPressureGuard = {
17
+ sampleNow(): void;
18
+ close(): void;
19
+ };
20
+ type GuardSettings = Pick<Settings, "turnWorkerConcurrencyMode" | "turnWorkerTargetMemoryUsage" | "turnWorkerEmergencyMemoryUsage" | "turnWorkerMemoryGuardIntervalMs" | "turnWorkerMemoryGuardSustainMs">;
21
+ type GuardDependencies = {
22
+ now?: () => number;
23
+ sample?: () => TurnWorkerMemoryPressureSnapshot;
24
+ setInterval?: typeof setInterval;
25
+ clearInterval?: typeof clearInterval;
26
+ gc?: () => void;
27
+ };
28
+ type SnapshotDependencies = {
29
+ readText?: (path: string) => string | null;
30
+ hostTotalBytes?: () => number;
31
+ hostAvailableBytes?: () => number;
32
+ processMemoryUsage?: () => Pick<NodeJS.MemoryUsage, "rss" | "heapUsed" | "external" | "arrayBuffers">;
33
+ };
34
+ export type ProcessCgroupMembership = {
35
+ v2Path: string | null;
36
+ v1MemoryPath: string | null;
37
+ };
38
+ export type CgroupMemoryFilePair = {
39
+ currentPath: string;
40
+ maxPath: string;
41
+ };
42
+ export declare function parseLinuxMeminfo(value: string): {
43
+ totalBytes: number;
44
+ availableBytes: number;
45
+ } | null;
46
+ export declare function parseFiniteCgroupMemoryLimit(value: string): number | null;
47
+ export declare function parseProcessCgroupMembership(value: string): ProcessCgroupMembership;
48
+ export declare function cgroupMemoryFilePairs(membership: ProcessCgroupMembership): CgroupMemoryFilePair[];
49
+ export declare function readTurnWorkerMemoryPressureSnapshot(dependencies?: SnapshotDependencies): TurnWorkerMemoryPressureSnapshot;
50
+ export declare function turnWorkerMemoryPressureGuardEnabled(role: "control" | "turn", settings: Pick<Settings, "turnWorkerConcurrencyMode">): boolean;
51
+ export declare function createTurnWorkerMemoryPressureGuard(input: {
52
+ settings: GuardSettings;
53
+ observability: Observability;
54
+ drain: () => void;
55
+ dependencies?: GuardDependencies;
56
+ }): TurnWorkerMemoryPressureGuard;
57
+ export {};
@@ -0,0 +1,22 @@
1
+ import type { Observability } from "@opengeni/observability";
2
+ export declare const MODEL_CHECKPOINT_GC_PRESSURE_BYTES: number;
3
+ export declare const MODEL_CHECKPOINT_GC_COOLDOWN_MS = 30000;
4
+ type ProcessMemory = Pick<NodeJS.MemoryUsage, "heapUsed" | "external">;
5
+ type ModelCheckpointMemoryCollectorDependencies = {
6
+ now?: () => number;
7
+ memoryUsage?: () => ProcessMemory;
8
+ gc?: () => void;
9
+ setTimeout?: typeof setTimeout;
10
+ };
11
+ export type ModelCheckpointMemoryCollector = {
12
+ schedule(observability: Observability): void;
13
+ };
14
+ /**
15
+ * Reclaim request serialization and stream buffers only after one model
16
+ * response has crossed the durable conversation checkpoint. The callback runs
17
+ * on a later task so the completed response's stack can unwind first. Active
18
+ * turns and their exact model context remain strongly reachable and are never
19
+ * shortened, restarted, or rewritten by this process-local collection.
20
+ */
21
+ export declare function createModelCheckpointMemoryCollector(dependencies?: ModelCheckpointMemoryCollectorDependencies): ModelCheckpointMemoryCollector;
22
+ export {};
@@ -9,6 +9,22 @@ export type CreditBalanceGauge = {
9
9
  accountId: string;
10
10
  balanceMicros: number;
11
11
  };
12
+ export type TurnTaskQueueStats = {
13
+ /** Temporal activity tasks ready for a turn worker to accept. */
14
+ eligibleBacklog: number;
15
+ oldestBacklogAgeSeconds: number;
16
+ tasksAddRate: number;
17
+ tasksDispatchRate: number;
18
+ };
19
+ export type TemporalTurnTaskQueueStats = {
20
+ approximateBacklogCount?: unknown;
21
+ approximateBacklogAge?: {
22
+ seconds?: unknown;
23
+ nanos?: unknown;
24
+ } | null;
25
+ tasksAddRate?: unknown;
26
+ tasksDispatchRate?: unknown;
27
+ } | null;
12
28
  export declare function observabilityEventLogger(observability: Observability): EventLogger;
13
29
  export declare function runtimeMetricsHooksForObservability(observability: Observability): RuntimeMetricsHooks;
14
30
  /**
@@ -65,6 +81,23 @@ export declare class TurnLifecycleMetrics {
65
81
  private now;
66
82
  }
67
83
  export declare function recordTurnsQueuedGauge(observability: Observability, value: number): void;
84
+ /**
85
+ * Record the authoritative turn activity queue rather than aggregate Postgres
86
+ * prompts. A paused human prompt is durable queue truth but is not runnable and
87
+ * never reaches this Temporal task queue. DescribeTaskQueue's approximate
88
+ * backlog count and age are explicitly documented by Temporal as autoscaling
89
+ * signals.
90
+ */
91
+ export declare function recordTurnTaskQueueStats(observability: Observability, stats: TurnTaskQueueStats): void;
92
+ export declare function normalizeTurnTaskQueueStats(stats: TemporalTurnTaskQueueStats | undefined): TurnTaskQueueStats;
93
+ export declare function startTurnCapacityMonitor(input: {
94
+ observability: Observability;
95
+ read: () => Promise<TurnTaskQueueStats>;
96
+ intervalMs?: number;
97
+ now?: () => number;
98
+ }): {
99
+ close: () => Promise<void>;
100
+ };
68
101
  export declare function recordSandboxLeaseGauges(observability: Observability, counts: Partial<Record<SandboxLeaseLiveness, number>>): void;
69
102
  export declare const SANDBOX_INVENTORY_PROJECTION_DOMAINS: readonly ["leases", "checkpoint_artifacts", "rotation_backlog", "retained_processes", "expired_drains"];
70
103
  export type SandboxInventoryProjectionDomain = (typeof SANDBOX_INVENTORY_PROJECTION_DOMAINS)[number];
@@ -0,0 +1,40 @@
1
+ export declare const SANDBOX_REAPER_SCAN_ACTIVITY_TIMEOUT_MS: number;
2
+ export declare const SANDBOX_DRAIN_FAST_ACTIVITY_TIMEOUT_MS: number;
3
+ export declare const SANDBOX_DRAIN_EXTENDED_ACTIVITY_TIMEOUT_MS: number;
4
+ export declare const SANDBOX_DRAIN_SETTLEMENT_MARGIN_MS = 60000;
5
+ export declare const SANDBOX_REAPER_ACTIVITY_HEARTBEAT_TIMEOUT_MS = 20000;
6
+ export declare const SANDBOX_REAPER_ACTIVITY_HEARTBEAT_INTERVAL_MS = 5000;
7
+ export declare const SANDBOX_REAPER_CHILD_DISPATCH_LIMIT = 500;
8
+ export declare const SANDBOX_REAPER_V2_WORKFLOW_ID = "opengeni-sandbox-lease-reaper-v2";
9
+ export declare const SANDBOX_REAPER_MAINTENANCE_WORKFLOW_ID = "opengeni-sandbox-lease-maintenance-v1";
10
+ export declare const SANDBOX_LIFECYCLE_TASK_QUEUE_SUFFIX = "-sandbox-lifecycle-v1";
11
+ export declare function sandboxLifecycleTaskQueue(baseTaskQueue: string): string;
12
+ export type SandboxDrainTimeoutClass = "fast" | "extended";
13
+ export type SandboxDrainTarget = {
14
+ workspaceId: string;
15
+ sandboxGroupId: string;
16
+ instanceId: string | null;
17
+ leaseEpoch: number;
18
+ };
19
+ export type SandboxDrainActivityInput = {
20
+ target: SandboxDrainTarget;
21
+ timeoutClass: SandboxDrainTimeoutClass;
22
+ /** Provider operation budget frozen when the durable child is created. A
23
+ * rolling config change cannot make an existing fast child retry forever. */
24
+ snapshotTimeoutMs: number;
25
+ captureTimeoutMs: number;
26
+ /** Stable logical teardown operation; every Temporal activity retry keeps it
27
+ * while receiving a distinct exact capture-attempt id. */
28
+ operationId: string;
29
+ };
30
+ export type SandboxDrainWorkflowInput = Omit<SandboxDrainActivityInput, "operationId">;
31
+ export type SandboxLeaseSweepMaintenanceInput = {
32
+ examined: number;
33
+ started: number;
34
+ alreadyRunning: number;
35
+ startFailed: number;
36
+ rotationsRequested: number;
37
+ };
38
+ export declare function sandboxDrainTimeoutClass(captureTimeoutMs: number): SandboxDrainTimeoutClass;
39
+ export declare function sandboxDrainActivityTimeoutMs(timeoutClass: SandboxDrainTimeoutClass): number;
40
+ export declare function sandboxDrainWorkflowId(target: SandboxDrainTarget): string;
@@ -0,0 +1,14 @@
1
+ import { type Settings } from "@opengeni/config";
2
+ import { type SandboxDrainTimeoutClass } from "./sandbox-reaper-contract.js";
3
+ export declare function sandboxDrainTiming(settings: Pick<Settings, "sandboxSnapshotTimeoutMs">): {
4
+ snapshotTimeoutMs: number;
5
+ captureTimeoutMs: number;
6
+ timeoutClass: SandboxDrainTimeoutClass;
7
+ activityTimeoutMs: number;
8
+ };
9
+ export declare function assertSandboxReaperActivityTimeout(settings: Pick<Settings, "sandboxSnapshotTimeoutMs">): void;
10
+ export declare function assertSandboxDrainInputTiming(input: {
11
+ timeoutClass: SandboxDrainTimeoutClass;
12
+ snapshotTimeoutMs: number;
13
+ captureTimeoutMs: number;
14
+ }): void;
@@ -19,6 +19,10 @@ export declare function isRetryableDegradedRestore(restore: {
19
19
  export type SandboxResumeServices = {
20
20
  db: Database;
21
21
  settings: Settings;
22
+ /** Exact settings before a verified rig provider image overlaid the logical
23
+ * pack/deployment image. Fresh-create NotFound fallback must preserve an
24
+ * ID-only logical base instead of selecting the provider default. */
25
+ logicalFallbackSettings?: Settings;
22
26
  sandboxMetrics?: RuntimeMetricsHooks;
23
27
  /**
24
28
  * The logical turn-attempt lifetime, not merely the provider request lifetime.
@@ -88,15 +92,36 @@ export type ResumedTurnSandbox = {
88
92
  established: EstablishedSandboxSession;
89
93
  /** The lease_epoch this turn holds; the heartbeat/fence token. */
90
94
  leaseEpoch: number;
91
- /** Idempotent release: deletes this holder row and (if refcount hits 0 with no
92
- * turn holders) CASes warm->draining. NEVER stops the box. Safe to call once. */
93
- release: () => Promise<void>;
95
+ /** Staged idempotent release. The ordinary form immediately prevents a
96
+ * holder/timer leak. The quiesced form may be called later—even after the
97
+ * ordinary form—to repair null-outcome admissions only after every exact
98
+ * attempt-owned workspace writer has physically drained. NEVER stops the box. */
99
+ release: (options?: {
100
+ workspaceWritersQuiesced?: boolean;
101
+ }) => Promise<void>;
94
102
  };
95
- export declare class SandboxWarmingTimeoutError extends Error {
103
+ export declare abstract class SandboxWarmingTimeoutError extends Error {
96
104
  readonly backend: string;
97
105
  readonly timeoutMs: number;
98
- readonly code = "sandbox_warming_timeout";
99
- constructor(backend: string, timeoutMs: number);
106
+ readonly stage: "exec_readiness" | "sibling_warming";
107
+ readonly sandboxGroupId: string | null;
108
+ readonly instanceId: string | null;
109
+ abstract readonly code: "sandbox_exec_readiness_timeout" | "sandbox_sibling_warming_timeout";
110
+ protected constructor(backend: string, timeoutMs: number, stage: "exec_readiness" | "sibling_warming", sandboxGroupId: string | null, instanceId: string | null);
111
+ }
112
+ export declare class SandboxExecReadinessTimeoutError extends SandboxWarmingTimeoutError {
113
+ readonly code: "sandbox_exec_readiness_timeout";
114
+ constructor(backend: string, timeoutMs: number, identity?: {
115
+ sandboxGroupId?: string | null;
116
+ instanceId?: string | null;
117
+ });
118
+ }
119
+ export declare class SandboxSiblingWarmingTimeoutError extends SandboxWarmingTimeoutError {
120
+ readonly code: "sandbox_sibling_warming_timeout";
121
+ constructor(backend: string, timeoutMs: number, identity: {
122
+ sandboxGroupId: string;
123
+ instanceId?: string | null;
124
+ });
100
125
  }
101
126
  /** The exact attached caller that won warm->cold after proving the provider
102
127
  * instance gone. It is a lease supersession (the same logical turn recovers),
@@ -111,7 +136,15 @@ export declare class SandboxLeaseInstanceLostError extends SandboxLeaseSupersede
111
136
  * returns, so it cannot bound that initial RPC. Probe it before publishing the
112
137
  * lease as warm and enforce our own wall-clock deadline.
113
138
  */
114
- export declare function waitForSandboxExecReadiness(established: EstablishedSandboxSession, timeoutMs?: number): Promise<void>;
139
+ export declare function waitForSandboxExecReadiness(established: EstablishedSandboxSession, timeoutMs?: number, identity?: {
140
+ sandboxGroupId?: string | null;
141
+ }): Promise<void>;
142
+ export declare function safeSnapshotError(error: unknown): {
143
+ errorClass: "SnapshotOperationError";
144
+ errorCode: "snapshot_operation_failed";
145
+ status?: number;
146
+ origin: "sandbox-resume";
147
+ };
115
148
  export declare function waitForWarmSnapshot(snapshot: Promise<unknown>, timeoutMs: number, signal?: AbortSignal): Promise<boolean>;
116
149
  /**
117
150
  * MID-SESSION /workspace snapshot (sandbox-file-persistence). The reaper's
@@ -31,6 +31,14 @@ export type RoutingWiringServices = {
31
31
  established: EstablishedSandboxSession;
32
32
  leaseEpoch: number;
33
33
  }) => void;
34
+ /** Cancel bounded capture waits with the owning turn activity. */
35
+ waitSignal?: AbortSignal;
36
+ };
37
+ /** Worker-turn routing may final-ack streamed command output, so it must always
38
+ * carry the turn's durable frontier journal. Non-turn helpers may still omit it
39
+ * through the broader service shape above. */
40
+ type TurnRoutingWiringServices = RoutingWiringServices & {
41
+ opJournal: OpStreamJournal;
34
42
  };
35
43
  export type RoutingWiringIds = {
36
44
  workspaceId: string;
@@ -91,8 +99,8 @@ export type RoutingWiringIds = {
91
99
  export declare function relayConfigFromSettings(settings: Settings): SelfhostedRelayConfig;
92
100
  /** The selfhosted CONTROL vs EXEC op deadlines for a turn, from settings. Control
93
101
  * ops (ping/fs/desktop/pty) stay on the short timeout so machine liveness is never
94
- * masked by a slow op; exec gets its own much larger budget so a real command is not
95
- * killed at the control wall. Threaded into every turn-path session build + resolver. */
102
+ * masked by a slow op; exec has its own setting and defaults to no duration wall.
103
+ * Threaded into every turn-path session build + resolver. */
96
104
  export declare function selfhostedTimeoutsFromSettings(settings: Settings): {
97
105
  timeoutMs: number;
98
106
  execTimeoutMs: number;
@@ -110,8 +118,8 @@ export declare function providerIdentityFromResumeState(resumeState: Record<stri
110
118
  * SelfhostedSession bound to the target's enrollment agentId, fenced under the
111
119
  * swap's active_epoch.
112
120
  */
113
- export declare function wrapTurnBoxWithRouting(services: RoutingWiringServices, ids: RoutingWiringIds, established: EstablishedSandboxSession): EstablishedSandboxSession;
114
- export declare function wrapLazyTurnBoxWithRouting(services: RoutingWiringServices, ids: RoutingWiringIds, args: {
121
+ export declare function wrapTurnBoxWithRouting(services: TurnRoutingWiringServices, ids: RoutingWiringIds, established: EstablishedSandboxSession): EstablishedSandboxSession;
122
+ export declare function wrapLazyTurnBoxWithRouting(services: TurnRoutingWiringServices, ids: RoutingWiringIds, args: {
115
123
  client: EstablishedSandboxSession["client"];
116
124
  backendId: string;
117
125
  agentDefaultManifest: unknown;
@@ -143,8 +151,7 @@ export type SelfhostedTurnSessionArgs = {
143
151
  /** The session working directory (per-session pointer). Null ⇒ workspace_root. */
144
152
  workingDir: string | null;
145
153
  };
146
- type LegacySelfhostedTurnSessionArgs = Omit<SelfhostedTurnSessionArgs, "opStream">;
147
- export declare function establishSelfhostedTurnSession(services: RoutingWiringServices, args: SelfhostedTurnSessionArgs | LegacySelfhostedTurnSessionArgs): Promise<EstablishedSandboxSession>;
154
+ export declare function establishSelfhostedTurnSession(services: RoutingWiringServices, args: SelfhostedTurnSessionArgs): Promise<EstablishedSandboxSession>;
148
155
  /** Whether the routing proxy should wrap the turn box: the hot-swap feature is
149
156
  * gated by the selfhosted flag (the active pointer + swap tools are only
150
157
  * meaningful when selfhosted is enabled). With the flag off the established
@@ -1,14 +1,18 @@
1
1
  import type { Observability } from "@opengeni/observability";
2
- import type { WorkerLifecycleState } from "./http";
2
+ import type { WorkerLifecycleState } from "./http.js";
3
3
  export declare function constructWithOwnedConnection<Connection, Result>(connect: () => Promise<Connection>, construct: (connection: Connection) => Promise<Result>, close: (connection: Connection) => Promise<void>): Promise<Result>;
4
4
  export type WorkerRunTarget = {
5
5
  run(): Promise<void>;
6
6
  shutdown(): void;
7
7
  };
8
+ /** One process may poll several disjoint Temporal queues, but it still has one
9
+ * host lifecycle. Start and stop every poller as a unit; a failed poller drains
10
+ * its siblings and preserves the original failure. */
11
+ export declare function combineWorkerRunTargets(targets: readonly WorkerRunTarget[]): WorkerRunTarget;
8
12
  export type WorkerServiceLifecycle = {
9
13
  state(): WorkerLifecycleState;
10
14
  run(): Promise<void>;
11
- drain(reason?: string): void;
15
+ drain(reason?: string): boolean;
12
16
  close(): Promise<void>;
13
17
  };
14
18
  export declare function createWorkerServiceLifecycle(input: {