@opengeni/runtime 2.5.1-canary.0 → 2.5.2-canary.0

package/dist/index.js

@@ -247,7 +247,7 @@ import {
   workspaceEnvironmentInstructions,
   wrapAttemptToolDefinitions,
   wrapAttemptToolExecute
-} from "./chunk-26GUTY32.js";
+} from "./chunk-GBHOT4KS.js";
 import {
   ActiveBackendUnresolvableError,
   BROWSER_CONTROL_ADMIN_TOKEN_FILE,
@@ -361,6 +361,7 @@ import {
   buildTerminalServerScript,
   cancelSelfhostedOp,
   captureVerifiedWorkspaceArchive,
+  captureWorkspaceArchiveForStorage,
   classifyProviderSandboxFailure,
   clearRunCredentials,
   clearRunCredentialsForAttempt,
@@ -385,6 +386,7 @@ import {
   describeNativeSnapshotArchive,
   deserializeSandboxSessionStateEnvelope,
   desktopCapableBackend,
+  disposeWorkspaceArchive,
   dockerNetworkExposedPortEndpoint,
   drainingExhaustedError,
   drainingMessage,
@@ -517,7 +519,7 @@ import {
   withRunCredentialsClient,
   withRunCredentialsSession,
   withoutSandboxProviderIdentity
-} from "./chunk-LGLJ5PVD.js";
+} from "./chunk-LEIGL6X2.js";
 import "./chunk-CD22I76N.js";
 import {
   SKILL_MAX_FILES,
@@ -759,6 +761,7 @@ export {
   callModelInputFilterForSettings,
   cancelSelfhostedOp,
   captureVerifiedWorkspaceArchive,
+  captureWorkspaceArchiveForStorage,
   clampCompactionThresholdRatio,
   classifyProviderSandboxFailure,
   clearRunCredentials,
@@ -804,6 +807,7 @@ export {
   describeNativeSnapshotArchive,
   deserializeSandboxSessionStateEnvelope,
   desktopCapableBackend,
+  disposeWorkspaceArchive,
   dockerNetworkExposedPortEndpoint,
   drainingExhaustedError,
   drainingMessage,

package/dist/sandbox/archive-spool.d.ts

@@ -0,0 +1,14 @@
+import type { TarWorkspaceArchiveDescriptor } from "@opengeni/contracts";
+/** Process-owned, reopenable archive bytes. Never persisted as a local path. */
+export type WorkspaceArchiveSpool = {
+    path: string;
+    byteSize: number;
+    sha256: string;
+    open: () => AsyncIterable<Uint8Array>;
+    dispose: () => Promise<void>;
+};
+export type VerifiedHostWorkspaceArchive = {
+    kind: "host_spool";
+    spool: WorkspaceArchiveSpool;
+    descriptor: TarWorkspaceArchiveDescriptor;
+};

package/dist/sandbox/host-archive-spool.d.ts

@@ -0,0 +1,19 @@
+import type { WorkspaceTreeFingerprint } from "@opengeni/contracts";
+import type { WorkspaceArchiveSpool } from "./archive-spool.js";
+/** Matches SDK 0.14.3 resolveSandboxArchiveLimits: absent/null means unlimited;
+ * an explicit object fills undefined fields with SDK defaults, null disables a field.
+ * chunkBytes controls buffering, never the amount of input accepted. */
+export type HostWorkspaceArchiveOptions = {
+    chunkBytes?: number;
+    archiveLimits?: {
+        maxInputBytes?: number | null;
+        maxExtractedBytes?: number | null;
+        maxMembers?: number | null;
+    } | null;
+};
+export declare function fingerprintHostWorkspace(root: string, excludedPaths: readonly string[]): Promise<WorkspaceTreeFingerprint>;
+export declare function captureHostWorkspaceArchive(root: string, excludedPaths: readonly string[]): Promise<{
+    spool: WorkspaceArchiveSpool;
+    workspace: WorkspaceTreeFingerprint;
+}>;
+export declare function restoreHostWorkspaceArchive(root: string, spool: WorkspaceArchiveSpool, options?: HostWorkspaceArchiveOptions): Promise<void>;

package/dist/sandbox/index.d.ts

@@ -1,6 +1,9 @@
 export type { ProviderCommandPersistence, ProviderCommandSession, } from "./provider-command-session.js";
 import type { Settings } from "@opengeni/config";
-import { type SandboxBackend, type SandboxProviderContinuityRecovery } from "@opengeni/contracts";
+export type { WorkspaceArchiveSpool, VerifiedHostWorkspaceArchive } from "./archive-spool.js";
+import type { WorkspaceArchiveSpool } from "./archive-spool.js";
+export { captureWorkspaceArchiveForStorage, disposeWorkspaceArchive, type VerifiedWorkspaceArchivePayload, } from "./workspace-archive.js";
+import { type WorkspaceArchiveObjectRef, type SandboxBackend, type SandboxProviderContinuityRecovery } from "@opengeni/contracts";
 import type { SandboxClient, SandboxSessionState } from "@openai/agents/sandbox";
 import { type WorkspaceArchiveDescriptor } from "./workspace-archive.js";
 import type { RuntimeMetricsHooks } from "../metrics.js";
@@ -202,6 +205,7 @@ export declare function withoutSandboxProviderIdentity(envelope: Record<string,
 export declare function establishSandboxSessionFromEnvelope(settings: Settings, envelope: Record<string, unknown> | null, opts: {
     sessionId: string;
     recovery: "create-or-restore" | "resume-only";
+    loadHostWorkspaceArchive?: (ref: WorkspaceArchiveObjectRef) => Promise<WorkspaceArchiveSpool>;
     backendOverride?: SandboxBackend;
     environment?: Record<string, string>;
     onSandboxCreated?: SandboxCreatedCallback;

package/dist/sandbox/index.js

@@ -110,6 +110,7 @@ import {
   buildTerminalServerScript,
   cancelSelfhostedOp,
   captureVerifiedWorkspaceArchive,
+  captureWorkspaceArchiveForStorage,
   classifyProviderSandboxFailure,
   clearRunCredentials,
   clearRunCredentialsForAttempt,
@@ -134,6 +135,7 @@ import {
   describeNativeSnapshotArchive,
   deserializeSandboxSessionStateEnvelope,
   desktopCapableBackend,
+  disposeWorkspaceArchive,
   dockerNetworkExposedPortEndpoint,
   drainingExhaustedError,
   drainingMessage,
@@ -265,7 +267,7 @@ import {
   withRunCredentialsClient,
   withRunCredentialsSession,
   withoutSandboxProviderIdentity
-} from "../chunk-LGLJ5PVD.js";
+} from "../chunk-LEIGL6X2.js";
 import "../chunk-CD22I76N.js";
 import "../chunk-25B3EQRW.js";
 import "../chunk-PZ5AY32C.js";
@@ -381,6 +383,7 @@ export {
   buildTerminalServerScript,
   cancelSelfhostedOp,
   captureVerifiedWorkspaceArchive,
+  captureWorkspaceArchiveForStorage,
   classifyProviderSandboxFailure,
   clearRunCredentials,
   clearRunCredentialsForAttempt,
@@ -405,6 +408,7 @@ export {
   describeNativeSnapshotArchive,
   deserializeSandboxSessionStateEnvelope,
   desktopCapableBackend,
+  disposeWorkspaceArchive,
   dockerNetworkExposedPortEndpoint,
   drainingExhaustedError,
   drainingMessage,

package/dist/sandbox/workspace-archive.d.ts

@@ -1,4 +1,5 @@
 import { type NativeSnapshotDescriptor, type NativeSnapshotRef, type WorkspaceArchiveDescriptor, type WorkspaceTreeFingerprint } from "@opengeni/contracts";
+import type { VerifiedHostWorkspaceArchive } from "./archive-spool.js";
 export { WORKSPACE_ARCHIVE_DESCRIPTOR_VERSION, decodeNativeSnapshotRef, encodeNativeSnapshotRef, parseWorkspaceArchiveDescriptor, type NativeSnapshotDescriptor, type NativeSnapshotProvider, type NativeSnapshotRef, type TarWorkspaceArchiveDescriptor, type WorkspaceArchiveDescriptor, type WorkspaceTreeFingerprint, } from "@opengeni/contracts";
 export type VerifiedWorkspaceArchive = {
     bytes: Uint8Array;
@@ -7,6 +8,12 @@ export type VerifiedWorkspaceArchive = {
     kind: "tar" | "provider_snapshot";
     nativeSnapshot?: NativeSnapshotRef;
 };
+export type VerifiedWorkspaceArchivePayload = VerifiedWorkspaceArchive | VerifiedHostWorkspaceArchive;
+/** Host-backed portable archives can go directly to object storage without an
+ * intermediate whole-document string or buffer. Existing inline/provider APIs
+ * retain their compatibility path when disk-backed publication is unavailable. */
+export declare function captureWorkspaceArchiveForStorage(session: unknown, capturedAtMs: number, options: WorkspaceArchiveCaptureOptions, objectStorageAvailable: boolean): Promise<VerifiedWorkspaceArchivePayload>;
+export declare function disposeWorkspaceArchive(archive: VerifiedWorkspaceArchivePayload | undefined): Promise<void>;
 export type WorkspaceArchiveIntegrityCode = "archive_metadata_missing" | "archive_metadata_invalid" | "archive_base64_invalid" | "archive_hash_mismatch" | "archive_hydration_failed" | "workspace_fingerprint_unavailable" | "workspace_changed_during_capture" | "workspace_fingerprint_mismatch" | "native_snapshot_reference_invalid" | "native_snapshot_fallback_unverified";
 export declare class WorkspaceArchiveIntegrityError extends Error {
     readonly code: WorkspaceArchiveIntegrityCode;

package/dist/workspace-tool-gateway.js

@@ -1,7 +1,7 @@
 import {
   prepareAgentTools
-} from "./chunk-26GUTY32.js";
-import "./chunk-LGLJ5PVD.js";
+} from "./chunk-GBHOT4KS.js";
+import "./chunk-LEIGL6X2.js";
 import "./chunk-CD22I76N.js";
 import "./chunk-GB763TSV.js";
 import "./chunk-UZ66CGC2.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/runtime",
-  "version": "2.5.1-canary.0",
+  "version": "2.5.2-canary.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -62,16 +62,16 @@
     "@openai/agents": "0.14.3",
     "@openai/agents-core": "0.14.3",
     "@openai/agents-extensions": "0.14.3",
-    "@opengeni/agent-proto": "^0.5.1-canary.24",
-    "@opengeni/capabilities": "^0.3.3-canary.6",
-    "@opengeni/codemode": "^0.5.4-canary.0",
-    "@opengeni/codex": "^0.2.22-canary.6",
-    "@opengeni/config": "^1.1.0-canary.0",
-    "@opengeni/contracts": "^3.0.0-canary.0",
-    "@opengeni/network": "^0.3.1-canary.6",
-    "@opengeni/sdk": "^5.0.0-canary.0",
-    "@opengeni/tool-gateway": "^0.1.5-canary.0",
-    "@opengeni/xai-subscription": "^0.1.4-canary.6",
+    "@opengeni/agent-proto": "^0.5.1-canary.25",
+    "@opengeni/capabilities": "^0.3.3-canary.7",
+    "@opengeni/codemode": "^0.5.5-canary.0",
+    "@opengeni/codex": "^0.2.22-canary.7",
+    "@opengeni/config": "^1.1.1-canary.0",
+    "@opengeni/contracts": "^3.0.1-canary.0",
+    "@opengeni/network": "^0.3.1-canary.7",
+    "@opengeni/sdk": "^5.0.3-canary.0",
+    "@opengeni/tool-gateway": "^0.1.6-canary.0",
+    "@opengeni/xai-subscription": "^0.1.4-canary.7",
     "debug": "4.4.3",
     "modal": "0.9.0",
     "openai": "6.47.0",

package/src/sandbox/archive-spool.ts

@@ -0,0 +1,16 @@
+import type { TarWorkspaceArchiveDescriptor } from "@opengeni/contracts";
+
+/** Process-owned, reopenable archive bytes. Never persisted as a local path. */
+export type WorkspaceArchiveSpool = {
+  path: string;
+  byteSize: number;
+  sha256: string;
+  open: () => AsyncIterable<Uint8Array>;
+  dispose: () => Promise<void>;
+};
+
+export type VerifiedHostWorkspaceArchive = {
+  kind: "host_spool";
+  spool: WorkspaceArchiveSpool;
+  descriptor: TarWorkspaceArchiveDescriptor;
+};