@openai/agents-extensions 0.8.4 → 0.9.0

package/dist/sandbox/shared/sessionBase.mjs

@@ -0,0 +1,442 @@
+import { SandboxProviderError, SandboxUnsupportedFeatureError, } from '@openai/agents-core/sandbox';
+import { randomUUID } from 'node:crypto';
+import { assertTarWorkspacePersistence, hydrateRemoteWorkspaceTar, persistRemoteWorkspaceTar, } from "./archive.mjs";
+import { RemoteSandboxEditor } from "./editor.mjs";
+import { applyLocalSourceManifestEntryToState, applyLocalSourceManifestToState, materializeLocalSourceManifest, } from "./localSources.mjs";
+import { assertSandboxEntryMetadataSupported, assertSandboxManifestMetadataSupported, sandboxEntryPermissionsMode, } from "./metadata.mjs";
+import { imageOutputFromBytes } from "./media.mjs";
+import { elapsedSeconds, formatExecResponse, truncateOutput } from "./output.mjs";
+import { resolveSandboxAbsolutePath, resolveSandboxWorkdir, shellQuote, validateRemoteSandboxPathForManifest, } from "./paths.mjs";
+import { assertConfiguredExposedPort, getCachedExposedPortEndpoint, parseExposedPortEndpoint, recordResolvedExposedPortEndpoint, } from "./ports.mjs";
+import { assertRunAsUnsupported } from "./session.mjs";
+export class RemoteSandboxSessionBase {
+    state;
+    providerName;
+    providerId;
+    concurrencyLimits;
+    remotePathResolver = async (path, options) => await this.resolveRemotePath(path, options);
+    constructor(args) {
+        this.state = args.state;
+        this.providerName = args.options.providerName;
+        this.providerId = args.options.providerId;
+        this.concurrencyLimits = args.options.concurrencyLimits;
+    }
+    createEditor(runAs) {
+        this.assertFilesystemRunAs(runAs);
+        if (runAs) {
+            return this.createRunAsEditor(runAs);
+        }
+        return new RemoteSandboxEditor({
+            resolvePath: this.remotePathResolver,
+            mkdir: async (path) => {
+                await this.beforeFilesystemMutation();
+                await this.mkdirRemote(path);
+            },
+            pathExists: async (path) => await this.pathExists(path),
+            readText: async (path) => await this.readRemoteText(path),
+            writeText: async (path, content) => {
+                await this.beforeFilesystemMutation();
+                await this.ensureParentDir(path);
+                await this.writeRemoteFile(path, content);
+            },
+            deletePath: async (path) => {
+                await this.beforeFilesystemMutation();
+                await this.deleteRemotePath(path);
+            },
+        });
+    }
+    supportsPty() {
+        return false;
+    }
+    async execCommand(args) {
+        if (args.tty) {
+            return await this.execPtyCommand(args);
+        }
+        this.assertExecRunAs(args.runAs);
+        await this.beforeExecCommand(args);
+        const start = Date.now();
+        const result = await this.runRemoteCommand(args.cmd, {
+            kind: 'exec',
+            workdir: this.resolveWorkdir(args.workdir),
+            runAs: args.runAs,
+            execArgs: args,
+        });
+        const output = truncateOutput(joinRemoteCommandOutput(result), args.maxOutputTokens);
+        return formatExecResponse({
+            output: output.text,
+            wallTimeSeconds: elapsedSeconds(start),
+            exitCode: result.status,
+            originalTokenCount: output.originalTokenCount,
+        });
+    }
+    async viewImage(args) {
+        this.assertFilesystemRunAs(args.runAs);
+        const absolutePath = await this.resolveRemotePath(args.path);
+        const bytes = args.runAs
+            ? await this.readRemoteFileAs(absolutePath, args.runAs)
+            : await this.readRemoteFile(absolutePath);
+        return imageOutputFromBytes(args.path, bytes);
+    }
+    async pathExists(path, runAs) {
+        this.assertFilesystemRunAs(runAs);
+        const absolutePath = await this.resolveRemotePath(path);
+        const result = await this.runRemoteCommand(`test -e ${shellQuote(absolutePath)}`, {
+            kind: 'path',
+            workdir: this.state.manifest.root,
+            runAs,
+        });
+        return result.status === 0;
+    }
+    async readFile(args) {
+        this.assertFilesystemRunAs(args.runAs);
+        const absolutePath = await this.resolveRemotePath(args.path);
+        const bytes = args.runAs
+            ? await this.readRemoteFileAs(absolutePath, args.runAs)
+            : await this.readRemoteFile(absolutePath);
+        if (typeof args.maxBytes === 'number' && bytes.byteLength > args.maxBytes) {
+            return bytes.subarray(0, args.maxBytes);
+        }
+        return bytes;
+    }
+    async running() {
+        try {
+            const result = await this.runRemoteCommand('true', {
+                kind: 'running',
+                workdir: this.runningWorkdir(),
+            });
+            return result.status === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    async resolveExposedPort(port) {
+        const requestedPort = assertConfiguredExposedPort({
+            providerName: this.providerName,
+            port,
+            configuredPorts: this.configuredExposedPorts(),
+            allowOnDemand: this.allowOnDemandExposedPorts(),
+        });
+        const cached = getCachedExposedPortEndpoint(this.state, requestedPort);
+        if (cached && this.useCachedExposedPortEndpoint(requestedPort)) {
+            return cached;
+        }
+        const endpoint = await this.resolveRemoteExposedPort(requestedPort);
+        return recordResolvedExposedPortEndpoint(this.state, requestedPort, typeof endpoint === 'string'
+            ? parseExposedPortEndpoint(endpoint, {
+                providerName: this.providerName,
+                source: this.exposedPortSource(),
+            })
+            : endpoint);
+    }
+    async materializeEntry(args) {
+        this.assertManifestRunAs(args.runAs);
+        assertSandboxEntryMetadataSupported(this.providerName, args.path, args.entry, this.manifestMetadataSupport());
+        await this.beforeMaterializeEntry(args);
+        await applyLocalSourceManifestEntryToState(this.state, args.path, args.entry, this.providerId, this.manifestWriter(), this.remotePathResolver, this.manifestMaterializationOptionsWithMetadata(args.runAs));
+    }
+    async applyManifest(manifest, runAs) {
+        this.assertManifestRunAs(runAs);
+        const resolvedManifest = await this.resolveManifestForApply(manifest);
+        assertSandboxManifestMetadataSupported(this.providerName, resolvedManifest, this.manifestMetadataSupport());
+        await this.beforeApplyManifest(resolvedManifest);
+        await this.provisionManifestAccounts(resolvedManifest);
+        await applyLocalSourceManifestToState(this.state, resolvedManifest, this.providerId, this.manifestWriter(), this.remotePathResolver, this.manifestMaterializationOptionsWithMetadata(runAs));
+    }
+    async persistWorkspace() {
+        assertTarWorkspacePersistence(this.providerName, this.workspacePersistence());
+        return await this.persistWorkspaceTar();
+    }
+    async hydrateWorkspace(data) {
+        assertTarWorkspacePersistence(this.providerName, this.workspacePersistence());
+        await this.hydrateWorkspaceTar(data);
+    }
+    async execPtyCommand(_args) {
+        throw new SandboxUnsupportedFeatureError(`${this.providerName} does not support tty=true yet.`, {
+            provider: this.providerId,
+            feature: 'tty',
+        });
+    }
+    assertExecRunAs(runAs) {
+        assertRunAsUnsupported(this.providerName, runAs);
+    }
+    assertFilesystemRunAs(runAs) {
+        assertRunAsUnsupported(this.providerName, runAs);
+    }
+    assertManifestRunAs(runAs) {
+        this.assertFilesystemRunAs(runAs);
+    }
+    async beforeExecCommand(_args) { }
+    async beforeFilesystemMutation() { }
+    async beforeMaterializeEntry(_args) { }
+    async beforeApplyManifest(_manifest) { }
+    resolveManifestForApply(manifest) {
+        return manifest;
+    }
+    manifestMetadataSupport() {
+        return undefined;
+    }
+    manifestMaterializationOptions() {
+        return {};
+    }
+    workspacePersistence() {
+        return this.state.workspacePersistence;
+    }
+    configuredExposedPorts() {
+        const configured = this.state.configuredExposedPorts;
+        return Array.isArray(configured) ? configured : undefined;
+    }
+    allowOnDemandExposedPorts() {
+        return false;
+    }
+    useCachedExposedPortEndpoint(_port) {
+        return true;
+    }
+    exposedPortSource() {
+        return 'endpoint';
+    }
+    async resolveRemoteExposedPort(port) {
+        throw new SandboxProviderError(`${this.providerName} exposed port resolution is not configured.`, {
+            provider: this.providerId,
+            port,
+        });
+    }
+    runningWorkdir() {
+        return this.state.manifest.root;
+    }
+    resolveWorkdir(path) {
+        return resolveSandboxWorkdir(this.state.manifest.root, path);
+    }
+    resolveAbsolutePath(path) {
+        return resolveSandboxAbsolutePath(this.state.manifest.root, path);
+    }
+    async resolveRemotePath(path, options = {}) {
+        return await validateRemoteSandboxPathForManifest({
+            manifest: this.state.manifest,
+            path,
+            options,
+            runCommand: async (command) => await this.runRemoteCommand(command, {
+                kind: 'path',
+                workdir: this.state.manifest.root,
+            }),
+        });
+    }
+    async ensureParentDir(path) {
+        const parent = this.parentDir(path);
+        if (parent !== '/' && parent !== '.') {
+            await this.mkdirRemote(parent);
+        }
+    }
+    async persistWorkspaceTar() {
+        return await persistRemoteWorkspaceTar({
+            providerName: this.providerName,
+            manifest: this.state.manifest,
+            io: this.archiveIo(),
+        });
+    }
+    async hydrateWorkspaceTar(data) {
+        await hydrateRemoteWorkspaceTar({
+            providerName: this.providerName,
+            manifest: this.state.manifest,
+            io: this.archiveIo(),
+            data,
+        });
+    }
+    manifestWriter() {
+        return {
+            mkdir: async (path) => {
+                await this.beforeFilesystemMutation();
+                await this.mkdirRemote(path);
+            },
+            writeFile: async (path, content) => {
+                await this.beforeFilesystemMutation();
+                await this.ensureParentDir(path);
+                await this.writeRemoteFile(path, content);
+            },
+        };
+    }
+    async materializeManifestEntries(manifest) {
+        await materializeLocalSourceManifest(this.manifestWriter(), manifest, this.providerId, this.remotePathResolver, this.manifestMaterializationOptionsWithMetadata());
+    }
+    archiveIo() {
+        return {
+            runCommand: async (command) => await this.runRemoteCommand(command, {
+                kind: 'archive',
+                workdir: this.state.manifest.root,
+            }),
+            readFile: async (path) => await this.readRemoteFile(path),
+            writeFile: async (path, content) => {
+                await this.beforeFilesystemMutation();
+                await this.ensureParentDir(path);
+                await this.writeRemoteFile(path, content);
+            },
+            mkdir: async (path) => {
+                await this.beforeFilesystemMutation();
+                await this.mkdirRemote(path);
+            },
+        };
+    }
+    parentDir(path) {
+        const index = path.lastIndexOf('/');
+        if (index <= 0) {
+            return index === 0 ? '/' : '.';
+        }
+        return path.slice(0, index);
+    }
+    createRunAsEditor(runAs) {
+        return new RemoteSandboxEditor({
+            resolvePath: this.remotePathResolver,
+            mkdir: async (path) => {
+                await this.beforeFilesystemMutation();
+                await this.runCheckedRemoteCommand(`mkdir -p -- ${shellQuote(path)}`, {
+                    kind: 'manifest',
+                    workdir: '/',
+                    runAs,
+                }, `create directory ${path}`);
+            },
+            readText: async (path) => await this.runCheckedRemoteCommand(`cat -- ${shellQuote(path)}`, {
+                kind: 'path',
+                workdir: '/',
+                runAs,
+            }, `read file ${path}`),
+            pathExists: async (path) => await this.pathExists(path, runAs),
+            writeText: async (path, content) => {
+                await this.beforeFilesystemMutation();
+                await this.writeRemoteTextAs(path, content, runAs);
+            },
+            deletePath: async (path) => {
+                await this.beforeFilesystemMutation();
+                await this.runCheckedRemoteCommand(`rm -f -- ${shellQuote(path)}`, {
+                    kind: 'manifest',
+                    workdir: '/',
+                    runAs,
+                }, `delete path ${path}`);
+            },
+        });
+    }
+    async readRemoteFileAs(path, runAs) {
+        const output = await this.runCheckedRemoteCommand(`base64 -- ${shellQuote(path)}`, {
+            kind: 'path',
+            workdir: '/',
+            runAs,
+        }, `read file ${path}`);
+        return Buffer.from(output.replace(/\s+/gu, ''), 'base64');
+    }
+    async writeRemoteTextAs(path, content, runAs) {
+        const tempPath = `/tmp/openai-agents-${randomUUID()}`;
+        try {
+            await this.writeRemoteFile(tempPath, content);
+            await this.runCheckedRemoteCommand([
+                `chmod 0644 -- ${shellQuote(tempPath)}`,
+                `chown ${shellQuote(runAs)}:${shellQuote(runAs)} -- ${shellQuote(tempPath)}`,
+            ].join(' && '), {
+                kind: 'manifest',
+                workdir: '/',
+            }, `prepare temporary file ${tempPath}`);
+            await this.runCheckedRemoteCommand(`cat -- ${shellQuote(tempPath)} > ${shellQuote(path)}`, {
+                kind: 'manifest',
+                workdir: '/',
+                runAs,
+            }, `write file ${path}`);
+        }
+        finally {
+            await this.runRemoteCommand(`rm -f -- ${shellQuote(tempPath)}`, {
+                kind: 'manifest',
+                workdir: '/',
+            }).catch(() => { });
+        }
+    }
+    manifestMaterializationOptionsWithMetadata(runAs) {
+        const options = {
+            ...this.manifestMaterializationOptions(),
+            concurrencyLimits: this.concurrencyLimits,
+        };
+        const support = this.manifestMetadataSupport();
+        if (!support?.entryGroups && !support?.entryPermissions && !runAs) {
+            return options;
+        }
+        return {
+            ...options,
+            applyMetadata: async (absolutePath, entry) => {
+                await options.applyMetadata?.(absolutePath, entry);
+                await this.applyManifestEntryMetadata(absolutePath, entry, runAs);
+            },
+        };
+    }
+    async provisionManifestAccounts(manifest) {
+        const support = this.manifestMetadataSupport();
+        if (!support?.users && !support?.groups) {
+            return;
+        }
+        const users = new Set(manifest.users.map((user) => user.name));
+        for (const group of manifest.groups) {
+            if (support.groups) {
+                await this.runCheckedRemoteCommand(`getent group ${shellQuote(group.name)} >/dev/null 2>&1 || groupadd ${shellQuote(group.name)}`, {
+                    kind: 'manifest',
+                    workdir: '/',
+                }, `create group ${group.name}`);
+            }
+            for (const user of group.users ?? []) {
+                users.add(user.name);
+            }
+        }
+        if (support.users) {
+            for (const user of users) {
+                const quotedUser = shellQuote(user);
+                await this.runCheckedRemoteCommand([
+                    `if id -u ${quotedUser} >/dev/null 2>&1; then exit 0; fi`,
+                    `if getent group ${quotedUser} >/dev/null 2>&1; then useradd -M -s /usr/sbin/nologin -g ${quotedUser} ${quotedUser}; else useradd -U -M -s /usr/sbin/nologin ${quotedUser}; fi`,
+                ].join('; '), {
+                    kind: 'manifest',
+                    workdir: '/',
+                }, `create user ${user}`);
+            }
+        }
+        if (support.groups) {
+            for (const group of manifest.groups) {
+                for (const user of group.users ?? []) {
+                    await this.runCheckedRemoteCommand(`usermod -aG ${shellQuote(group.name)} ${shellQuote(user.name)}`, {
+                        kind: 'manifest',
+                        workdir: '/',
+                    }, `add user ${user.name} to group ${group.name}`);
+                }
+            }
+        }
+    }
+    async applyManifestEntryMetadata(absolutePath, entry, runAs) {
+        const support = this.manifestMetadataSupport();
+        const commands = [];
+        if (runAs) {
+            commands.push(`chown ${shellQuote(runAs)}:${shellQuote(runAs)} -- ${shellQuote(absolutePath)}`);
+        }
+        if (support?.entryGroups && entry.group) {
+            commands.push(`chgrp ${shellQuote(entry.group.name)} -- ${shellQuote(absolutePath)}`);
+        }
+        if (support?.entryPermissions) {
+            commands.push(`chmod ${sandboxEntryPermissionsMode(entry)} -- ${shellQuote(absolutePath)}`);
+        }
+        if (commands.length === 0) {
+            return;
+        }
+        await this.runCheckedRemoteCommand(commands.join(' && '), {
+            kind: 'manifest',
+            workdir: '/',
+        }, `apply metadata to ${absolutePath}`);
+    }
+    async runCheckedRemoteCommand(command, options, action) {
+        const result = await this.runRemoteCommand(command, options);
+        if (result.status !== 0) {
+            const output = joinRemoteCommandOutput(result);
+            throw new SandboxProviderError(`${this.providerName} failed to ${action}${output ? `: ${output}` : ''}`, {
+                provider: this.providerId,
+            });
+        }
+        return result.stdout ?? '';
+    }
+}
+function joinRemoteCommandOutput(result) {
+    return [result.stdout ?? '', result.stderr ?? '']
+        .filter((value) => value.trim().length > 0)
+        .join('\n');
+}
+//# sourceMappingURL=sessionBase.mjs.map

package/dist/sandbox/shared/sessionBase.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionBase.mjs","sourceRoot":"","sources":["../../../src/sandbox/shared/sessionBase.ts"],"names":[],"mappings":"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"}

package/dist/sandbox/shared/sessionState.d.ts

@@ -0,0 +1,7 @@
+import type { Manifest } from '@openai/agents-core/sandbox';
+export type RemoteSandboxSessionStateValues = {
+    manifest: Manifest;
+    environment: Record<string, string>;
+};
+export declare function serializeRemoteSandboxSessionState<TState extends RemoteSandboxSessionStateValues>(state: TState): Record<string, unknown>;
+export declare function deserializeRemoteSandboxSessionStateValues(state: Record<string, unknown>, configuredEnvironment?: Record<string, string>): RemoteSandboxSessionStateValues;

package/dist/sandbox/shared/sessionState.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeRemoteSandboxSessionState = serializeRemoteSandboxSessionState;
+exports.deserializeRemoteSandboxSessionStateValues = deserializeRemoteSandboxSessionStateValues;
+const environment_1 = require("./environment.js");
+const manifest_1 = require("./manifest.js");
+function serializeRemoteSandboxSessionState(state) {
+    return {
+        ...state,
+        environment: serializeRemoteRuntimeEnvironmentForPersistence(state.manifest, state.environment),
+        manifest: (0, manifest_1.serializeManifestRecord)(state.manifest),
+    };
+}
+function deserializeRemoteSandboxSessionStateValues(state, configuredEnvironment) {
+    const manifest = (0, manifest_1.deserializeManifest)(state.manifest);
+    return {
+        manifest,
+        environment: deserializeRemotePersistedEnvironmentForRuntime(manifest, state.environment, configuredEnvironment),
+    };
+}
+function serializeRemoteRuntimeEnvironmentForPersistence(manifest, environment) {
+    const runtimeEnvironment = Object.fromEntries(Object.entries(environment).filter(([key, value]) => !(key in manifest.environment) && typeof value === 'string'));
+    return {
+        ...runtimeEnvironment,
+        ...(0, environment_1.serializeRuntimeEnvironmentForPersistence)(manifest, environment),
+    };
+}
+function deserializeRemotePersistedEnvironmentForRuntime(manifest, environment, configuredEnvironment = {}) {
+    const runtimeEnvironment = Object.fromEntries(Object.entries(environment ?? {}).filter(([key, value]) => !(key in manifest.environment) && typeof value === 'string'));
+    return {
+        ...runtimeEnvironment,
+        ...(0, environment_1.deserializePersistedEnvironmentForRuntime)(manifest, environment, configuredEnvironment),
+    };
+}
+//# sourceMappingURL=sessionState.js.map

package/dist/sandbox/shared/sessionState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionState.js","sourceRoot":"","sources":["../../../src/sandbox/shared/sessionState.ts"],"names":[],"mappings":";;AAYA,gFAWC;AAED,gGAeC;AAvCD,kDAGuB;AACvB,4CAA0E;AAO1E,SAAgB,kCAAkC,CAEhD,KAAa;IACb,OAAO;QACL,GAAG,KAAK;QACR,WAAW,EAAE,+CAA+C,CAC1D,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,WAAW,CAClB;QACD,QAAQ,EAAE,IAAA,kCAAuB,EAAC,KAAK,CAAC,QAAQ,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,SAAgB,0CAA0C,CACxD,KAA8B,EAC9B,qBAA8C;IAE9C,MAAM,QAAQ,GAAG,IAAA,8BAAmB,EAClC,KAAK,CAAC,QAA+C,CACtD,CAAC;IACF,OAAO;QACL,QAAQ;QACR,WAAW,EAAE,+CAA+C,CAC1D,QAAQ,EACR,KAAK,CAAC,WAAiD,EACvD,qBAAqB,CACtB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,+CAA+C,CACtD,QAAkB,EAClB,WAAmC;IAEnC,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAChC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAC9D,CACF,CAAC;IAEF,OAAO;QACL,GAAG,kBAAkB;QACrB,GAAG,IAAA,uDAAyC,EAAC,QAAQ,EAAE,WAAW,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,+CAA+C,CACtD,QAAkB,EAClB,WAA+C,EAC/C,wBAAgD,EAAE;IAElD,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAC9D,CACF,CAAC;IAEF,OAAO;QACL,GAAG,kBAAkB;QACrB,GAAG,IAAA,uDAAyC,EAC1C,QAAQ,EACR,WAAW,EACX,qBAAqB,CACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/sandbox/shared/sessionState.mjs

@@ -0,0 +1,31 @@
+import { deserializePersistedEnvironmentForRuntime, serializeRuntimeEnvironmentForPersistence, } from "./environment.mjs";
+import { deserializeManifest, serializeManifestRecord } from "./manifest.mjs";
+export function serializeRemoteSandboxSessionState(state) {
+    return {
+        ...state,
+        environment: serializeRemoteRuntimeEnvironmentForPersistence(state.manifest, state.environment),
+        manifest: serializeManifestRecord(state.manifest),
+    };
+}
+export function deserializeRemoteSandboxSessionStateValues(state, configuredEnvironment) {
+    const manifest = deserializeManifest(state.manifest);
+    return {
+        manifest,
+        environment: deserializeRemotePersistedEnvironmentForRuntime(manifest, state.environment, configuredEnvironment),
+    };
+}
+function serializeRemoteRuntimeEnvironmentForPersistence(manifest, environment) {
+    const runtimeEnvironment = Object.fromEntries(Object.entries(environment).filter(([key, value]) => !(key in manifest.environment) && typeof value === 'string'));
+    return {
+        ...runtimeEnvironment,
+        ...serializeRuntimeEnvironmentForPersistence(manifest, environment),
+    };
+}
+function deserializeRemotePersistedEnvironmentForRuntime(manifest, environment, configuredEnvironment = {}) {
+    const runtimeEnvironment = Object.fromEntries(Object.entries(environment ?? {}).filter(([key, value]) => !(key in manifest.environment) && typeof value === 'string'));
+    return {
+        ...runtimeEnvironment,
+        ...deserializePersistedEnvironmentForRuntime(manifest, environment, configuredEnvironment),
+    };
+}
+//# sourceMappingURL=sessionState.mjs.map

package/dist/sandbox/shared/sessionState.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionState.mjs","sourceRoot":"","sources":["../../../src/sandbox/shared/sessionState.ts"],"names":[],"mappings":"OACO,EACL,yCAAyC,EACzC,yCAAyC,GAC1C;OACM,EAAE,mBAAmB,EAAE,uBAAuB,EAAE;AAOvD,MAAM,UAAU,kCAAkC,CAEhD,KAAa;IACb,OAAO;QACL,GAAG,KAAK;QACR,WAAW,EAAE,+CAA+C,CAC1D,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,WAAW,CAClB;QACD,QAAQ,EAAE,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,KAA8B,EAC9B,qBAA8C;IAE9C,MAAM,QAAQ,GAAG,mBAAmB,CAClC,KAAK,CAAC,QAA+C,CACtD,CAAC;IACF,OAAO;QACL,QAAQ;QACR,WAAW,EAAE,+CAA+C,CAC1D,QAAQ,EACR,KAAK,CAAC,WAAiD,EACvD,qBAAqB,CACtB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,+CAA+C,CACtD,QAAkB,EAClB,WAAmC;IAEnC,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAChC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAC9D,CACF,CAAC;IAEF,OAAO;QACL,GAAG,kBAAkB;QACrB,GAAG,yCAAyC,CAAC,QAAQ,EAAE,WAAW,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,+CAA+C,CACtD,QAAkB,EAClB,WAA+C,EAC/C,wBAAgD,EAAE;IAElD,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAC9D,CACF,CAAC;IAEF,OAAO;QACL,GAAG,kBAAkB;QACrB,GAAG,yCAAyC,CAC1C,QAAQ,EACR,WAAW,EACX,qBAAqB,CACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/sandbox/shared/snapshots.d.ts

@@ -0,0 +1,9 @@
+export type NativeSnapshotProvider = 'e2b' | 'modal_snapshot_directory' | 'modal_snapshot_filesystem' | 'runloop' | 'vercel';
+export type NativeSnapshotRef = {
+    provider: NativeSnapshotProvider;
+    snapshotId: string;
+    workspacePersistence?: string;
+};
+export declare function encodeNativeSnapshotRef(ref: NativeSnapshotRef): Uint8Array;
+export declare function decodeNativeSnapshotRef(data: string | ArrayBuffer | Uint8Array): NativeSnapshotRef | undefined;
+export declare function requireNativeSnapshotRef(data: string | ArrayBuffer | Uint8Array, provider: NativeSnapshotProvider): NativeSnapshotRef;

package/dist/sandbox/shared/snapshots.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeNativeSnapshotRef = encodeNativeSnapshotRef;
+exports.decodeNativeSnapshotRef = decodeNativeSnapshotRef;
+exports.requireNativeSnapshotRef = requireNativeSnapshotRef;
+const sandbox_1 = require("@openai/agents-core/sandbox");
+const archive_1 = require("./archive.js");
+const NATIVE_SNAPSHOT_PREFIXES = {
+    e2b: 'E2B_SANDBOX_SNAPSHOT_V1\n',
+    modal_snapshot_directory: 'MODAL_SANDBOX_DIR_SNAPSHOT_V1\n',
+    modal_snapshot_filesystem: 'MODAL_SANDBOX_FS_SNAPSHOT_V1\n',
+    runloop: 'RUNLOOP_SANDBOX_SNAPSHOT_V1\n',
+    vercel: 'UC_VERCEL_SNAPSHOT_V1\n',
+};
+function encodeNativeSnapshotRef(ref) {
+    const prefix = NATIVE_SNAPSHOT_PREFIXES[ref.provider];
+    const body = JSON.stringify({
+        snapshot_id: ref.snapshotId,
+        ...(ref.workspacePersistence
+            ? { workspace_persistence: ref.workspacePersistence }
+            : {}),
+    }, Object.keys({
+        snapshot_id: ref.snapshotId,
+        workspace_persistence: ref.workspacePersistence,
+    }).sort());
+    return new TextEncoder().encode(`${prefix}${body}`);
+}
+function decodeNativeSnapshotRef(data) {
+    const text = new TextDecoder().decode((0, archive_1.toWorkspaceArchiveBytes)(data));
+    for (const [provider, prefix] of Object.entries(NATIVE_SNAPSHOT_PREFIXES)) {
+        if (!text.startsWith(prefix)) {
+            continue;
+        }
+        try {
+            const payload = JSON.parse(text.slice(prefix.length));
+            if (typeof payload.snapshot_id !== 'string' || !payload.snapshot_id) {
+                return undefined;
+            }
+            return {
+                provider,
+                snapshotId: payload.snapshot_id,
+                workspacePersistence: typeof payload.workspace_persistence === 'string'
+                    ? payload.workspace_persistence
+                    : undefined,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function requireNativeSnapshotRef(data, provider) {
+    const ref = decodeNativeSnapshotRef(data);
+    if (!ref || ref.provider !== provider) {
+        throw new sandbox_1.SandboxSnapshotError(`Expected a ${provider} native snapshot reference.`, {
+            provider,
+        });
+    }
+    return ref;
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/sandbox/shared/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../../../src/sandbox/shared/snapshots.ts"],"names":[],"mappings":";;AAwBA,0DAeC;AAED,0DAmCC;AAED,4DAcC;AA5FD,yDAAmE;AACnE,0CAAoD;AAepD,MAAM,wBAAwB,GAA2C;IACvE,GAAG,EAAE,2BAA2B;IAChC,wBAAwB,EAAE,iCAAiC;IAC3D,yBAAyB,EAAE,gCAAgC;IAC3D,OAAO,EAAE,+BAA+B;IACxC,MAAM,EAAE,yBAAyB;CAClC,CAAC;AAEF,SAAgB,uBAAuB,CAAC,GAAsB;IAC5D,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB;QACE,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,GAAG,CAAC,GAAG,CAAC,oBAAoB;YAC1B,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,oBAAoB,EAAE;YACrD,CAAC,CAAC,EAAE,CAAC;KACR,EACD,MAAM,CAAC,IAAI,CAAC;QACV,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,qBAAqB,EAAE,GAAG,CAAC,oBAAoB;KAChD,CAAC,CAAC,IAAI,EAAE,CACV,CAAC;IACF,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,uBAAuB,CACrC,IAAuC;IAEvC,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAA,iCAAuB,EAAC,IAAI,CAAC,CAAC,CAAC;IAErE,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAGrE,EAAE,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAGnD,CAAC;YACF,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACpE,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO;gBACL,QAAQ;gBACR,UAAU,EAAE,OAAO,CAAC,WAAW;gBAC/B,oBAAoB,EAClB,OAAO,OAAO,CAAC,qBAAqB,KAAK,QAAQ;oBAC/C,CAAC,CAAC,OAAO,CAAC,qBAAqB;oBAC/B,CAAC,CAAC,SAAS;aAChB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,wBAAwB,CACtC,IAAuC,EACvC,QAAgC;IAEhC,MAAM,GAAG,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,8BAAoB,CAC5B,cAAc,QAAQ,6BAA6B,EACnD;YACE,QAAQ;SACT,CACF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}