@openai/agents-extensions 0.8.4 → 0.9.0

package/dist/sandbox/shared/runAs.mjs

@@ -0,0 +1,141 @@
+import { SandboxProviderError } from '@openai/agents-core/sandbox';
+import { RemoteSandboxEditor } from "./editor.mjs";
+import { sandboxEntryPermissionsMode } from "./metadata.mjs";
+import { shellQuote } from "./paths.mjs";
+export function sandboxUserShellCommand(command, user) {
+    if (!user) {
+        return command;
+    }
+    return [
+        `target_user=${shellQuote(user)}`,
+        'current_uid="$(id -u)"',
+        'current_user="$(id -un 2>/dev/null || id -u)"',
+        'if [ "$current_uid" = "$target_user" ] || [ "$current_user" = "$target_user" ]; then',
+        `  sh -lc ${shellQuote(command)}`,
+        'elif [ "$current_uid" -eq 0 ]; then',
+        `  su -s /bin/sh "$target_user" -c ${shellQuote(command)}`,
+        'else',
+        `  sudo -n -u "$target_user" -- sh -lc ${shellQuote(command)}`,
+        'fi',
+    ].join('\n');
+}
+export function createRunAsRemoteEditor(args) {
+    return new RemoteSandboxEditor({
+        resolvePath: args.resolvePath,
+        mkdir: async (path) => {
+            await args.beforeFilesystemMutation?.();
+            await runCheckedRunAsRemoteCommand(args.providerName, args.providerId, args.runCommand, `mkdir -p -- ${shellQuote(path)}`, `create directory ${path}`, args.runAs);
+        },
+        readText: async (path) => new TextDecoder().decode(await readRunAsRemoteFile({
+            providerName: args.providerName,
+            providerId: args.providerId,
+            path,
+            runAs: args.runAs,
+            runCommand: args.runCommand,
+        })),
+        pathExists: async (path) => await runAsRemotePathExists(path, args.runAs, args.runCommand),
+        writeText: async (path, content) => {
+            await args.beforeFilesystemMutation?.();
+            await writeRunAsRemoteText({
+                providerName: args.providerName,
+                providerId: args.providerId,
+                path,
+                content,
+                runAs: args.runAs,
+                runCommand: args.runCommand,
+                writer: args.writer,
+            });
+        },
+        deletePath: async (path) => {
+            await args.beforeFilesystemMutation?.();
+            await runCheckedRunAsRemoteCommand(args.providerName, args.providerId, args.runCommand, `rm -f -- ${shellQuote(path)}`, `delete path ${path}`, args.runAs);
+        },
+    });
+}
+export async function readRunAsRemoteFile(args) {
+    const output = await runCheckedRunAsRemoteCommand(args.providerName, args.providerId, args.runCommand, `base64 -- ${shellQuote(args.path)}`, `read file ${args.path}`, args.runAs);
+    return decodeBase64(output);
+}
+export async function runAsRemotePathExists(path, runAs, runCommand) {
+    const result = await runCommand(`test -e ${shellQuote(path)}`, { runAs });
+    return result.status === 0;
+}
+export async function writeRunAsRemoteText(args) {
+    const tempPath = `/tmp/openai-agents-${randomId()}`;
+    try {
+        await args.writer.writeFile(tempPath, args.content);
+        await runCheckedRunAsRemoteCommand(args.providerName, args.providerId, args.runCommand, [
+            `chmod 0644 -- ${shellQuote(tempPath)}`,
+            `chown ${shellQuote(args.runAs)}:${shellQuote(args.runAs)} -- ${shellQuote(tempPath)}`,
+        ].join(' && '), `prepare temporary file ${tempPath}`, 'root');
+        await runCheckedRunAsRemoteCommand(args.providerName, args.providerId, args.runCommand, `cat -- ${shellQuote(tempPath)} > ${shellQuote(args.path)}`, `write file ${args.path}`, args.runAs);
+    }
+    finally {
+        await args
+            .runCommand(`rm -f -- ${shellQuote(tempPath)}`, { runAs: 'root' })
+            .catch(() => { });
+    }
+}
+export function manifestMaterializationOptionsWithRunAs(args) {
+    const options = args.options ?? {};
+    if (!args.runAs &&
+        !args.support?.entryGroups &&
+        !args.support?.entryPermissions) {
+        return options;
+    }
+    return {
+        ...options,
+        applyMetadata: async (absolutePath, entry) => {
+            await options.applyMetadata?.(absolutePath, entry);
+            await applyRunAsManifestEntryMetadata({
+                providerName: args.providerName,
+                providerId: args.providerId,
+                absolutePath,
+                entry,
+                runAs: args.runAs,
+                runCommand: args.runCommand,
+                support: args.support,
+            });
+        },
+    };
+}
+async function applyRunAsManifestEntryMetadata(args) {
+    const commands = [];
+    if (args.runAs) {
+        commands.push(`chown ${shellQuote(args.runAs)}:${shellQuote(args.runAs)} -- ${shellQuote(args.absolutePath)}`);
+    }
+    if (args.support?.entryGroups && args.entry.group) {
+        commands.push(`chgrp ${shellQuote(args.entry.group.name)} -- ${shellQuote(args.absolutePath)}`);
+    }
+    if (args.support?.entryPermissions) {
+        commands.push(`chmod ${sandboxEntryPermissionsMode(args.entry)} -- ${shellQuote(args.absolutePath)}`);
+    }
+    if (commands.length === 0) {
+        return;
+    }
+    await runCheckedRunAsRemoteCommand(args.providerName, args.providerId, args.runCommand, commands.join(' && '), `apply metadata to ${args.absolutePath}`, 'root');
+}
+async function runCheckedRunAsRemoteCommand(providerName, providerId, runCommand, command, action, runAs) {
+    const result = await runCommand(command, { runAs });
+    if (result.status !== 0) {
+        const output = [result.stdout ?? '', result.stderr ?? '']
+            .filter((value) => value.trim().length > 0)
+            .join('\n');
+        throw new SandboxProviderError(`${providerName} failed to ${action}${output ? `: ${output}` : ''}`, {
+            provider: providerId,
+        });
+    }
+    return result.stdout ?? '';
+}
+function decodeBase64(value) {
+    const binary = atob(value.replace(/\s+/gu, ''));
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1) {
+        bytes[index] = binary.charCodeAt(index);
+    }
+    return bytes;
+}
+function randomId() {
+    return (globalThis.crypto?.randomUUID?.() ?? Math.random().toString(16).slice(2)).replace(/-/gu, '');
+}
+//# sourceMappingURL=runAs.mjs.map

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

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

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

@@ -0,0 +1,16 @@
+import { withSandboxSpan, type SandboxConcurrencyLimits, type SnapshotSpec } from '@openai/agents-core/sandbox';
+export { withSandboxSpan };
+export declare function closeRemoteSessionOnManifestError(providerName: string, session: {
+    close(): Promise<void>;
+}, manifestError: unknown): Promise<never>;
+export declare function assertRunAsUnsupported(providerName: string, runAs?: string): void;
+export declare function assertCoreSnapshotUnsupported(providerName: string, snapshot?: SnapshotSpec): void;
+export declare function assertCoreConcurrencyLimitsUnsupported(providerName: string, limits?: SandboxConcurrencyLimits): void;
+export declare function withProviderError<T>(providerName: string, provider: string, operation: string, fn: () => Promise<T>, context?: Record<string, unknown>): Promise<T>;
+export declare function isProviderSandboxNotFoundError(error: unknown): boolean;
+export type ResumeRecreateErrorContext = {
+    providerName: string;
+    provider: string;
+    details?: Record<string, unknown>;
+};
+export declare function assertResumeRecreateAllowed(error: unknown, context: ResumeRecreateErrorContext): void;

package/dist/sandbox/shared/session.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withSandboxSpan = void 0;
+exports.closeRemoteSessionOnManifestError = closeRemoteSessionOnManifestError;
+exports.assertRunAsUnsupported = assertRunAsUnsupported;
+exports.assertCoreSnapshotUnsupported = assertCoreSnapshotUnsupported;
+exports.assertCoreConcurrencyLimitsUnsupported = assertCoreConcurrencyLimitsUnsupported;
+exports.withProviderError = withProviderError;
+exports.isProviderSandboxNotFoundError = isProviderSandboxNotFoundError;
+exports.assertResumeRecreateAllowed = assertResumeRecreateAllowed;
+const agents_core_1 = require("@openai/agents-core");
+const sandbox_1 = require("@openai/agents-core/sandbox");
+Object.defineProperty(exports, "withSandboxSpan", { enumerable: true, get: function () { return sandbox_1.withSandboxSpan; } });
+const typeGuards_1 = require("./typeGuards.js");
+async function closeRemoteSessionOnManifestError(providerName, session, manifestError) {
+    try {
+        await session.close();
+    }
+    catch (closeError) {
+        throw new agents_core_1.UserError(`Failed to apply a ${providerName} sandbox manifest and close the sandbox. Manifest error: ${errorMessage(manifestError)} Close error: ${errorMessage(closeError)}`);
+    }
+    throw manifestError;
+}
+function assertRunAsUnsupported(providerName, runAs) {
+    if (runAs) {
+        throw new sandbox_1.SandboxUnsupportedFeatureError(`${providerName} does not support runAs yet.`, {
+            provider: providerName,
+            feature: 'runAs',
+        });
+    }
+}
+function assertCoreSnapshotUnsupported(providerName, snapshot) {
+    if (snapshot && snapshot.type !== 'noop') {
+        throw new sandbox_1.SandboxUnsupportedFeatureError(`${providerName} does not support core sandbox snapshots yet. Use the provider-specific workspacePersistence option when available.`, {
+            provider: providerName,
+            feature: 'snapshot',
+        });
+    }
+}
+function assertCoreConcurrencyLimitsUnsupported(providerName, limits) {
+    if (limits?.manifestEntries !== undefined ||
+        limits?.localDirFiles !== undefined) {
+        throw new sandbox_1.SandboxUnsupportedFeatureError(`${providerName} does not support core sandbox concurrencyLimits yet.`, {
+            provider: providerName,
+            feature: 'concurrencyLimits',
+        });
+    }
+}
+async function withProviderError(providerName, provider, operation, fn, context = {}) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        if (error instanceof agents_core_1.UserError) {
+            throw error;
+        }
+        throw new sandbox_1.SandboxProviderError(`${providerName} failed to ${operation}.`, {
+            provider,
+            operation,
+            ...context,
+            cause: errorMessage(error),
+        });
+    }
+}
+function isProviderSandboxNotFoundError(error) {
+    if (isNotFoundErrorRecord(error, new Set())) {
+        return true;
+    }
+    const text = errorMessage(error).trim();
+    return isNotFoundErrorMessage(text);
+}
+function assertResumeRecreateAllowed(error, context) {
+    if (error instanceof agents_core_1.UserError) {
+        throw error;
+    }
+    if (isProviderSandboxNotFoundError(error)) {
+        return;
+    }
+    throw new sandbox_1.SandboxProviderError(`${context.providerName} failed to reconnect sandbox during resume.`, {
+        provider: context.provider,
+        operation: 'resume',
+        ...context.details,
+        cause: errorMessage(error),
+    });
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isNotFoundErrorRecord(error, seen) {
+    if (!(0, typeGuards_1.isRecord)(error)) {
+        return false;
+    }
+    if (seen.has(error)) {
+        return false;
+    }
+    seen.add(error);
+    for (const key of ['status', 'statusCode', 'httpStatus', 'httpStatusCode']) {
+        if (is404(error[key])) {
+            return true;
+        }
+    }
+    const response = error.response;
+    if ((0, typeGuards_1.isRecord)(response) && is404(response.status)) {
+        return true;
+    }
+    if (isNotFoundErrorCode(error.code)) {
+        return true;
+    }
+    if (typeof error.message === 'string' &&
+        isNotFoundErrorMessage(error.message)) {
+        return true;
+    }
+    return isNotFoundErrorRecord(error.cause, seen);
+}
+function is404(value) {
+    return value === 404 || value === '404';
+}
+function isNotFoundErrorCode(value) {
+    if (typeof value === 'number') {
+        return value === 404;
+    }
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return /^(404|not_found|not-found|notfound|resource_not_found|resource-not-found|not found)$/iu.test(value.trim());
+}
+function isNotFoundErrorMessage(message) {
+    const text = message.trim();
+    if (!text) {
+        return false;
+    }
+    if (/^(404|not[_ -]?found)$/iu.test(text)) {
+        return true;
+    }
+    return (/\b(sandbox|sandbox instance|instance|devbox)\b.*\b(not found|missing|does not exist|no such)\b/iu.test(text) ||
+        /\b(not found|missing|does not exist|no such)\b.*\b(sandbox|sandbox instance|instance|devbox)\b/iu.test(text));
+}
+//# sourceMappingURL=session.js.map

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

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

package/dist/sandbox/shared/session.mjs

@@ -0,0 +1,128 @@
+import { UserError } from '@openai/agents-core';
+import { SandboxProviderError, SandboxUnsupportedFeatureError, withSandboxSpan, } from '@openai/agents-core/sandbox';
+import { isRecord } from "./typeGuards.mjs";
+export { withSandboxSpan };
+export async function closeRemoteSessionOnManifestError(providerName, session, manifestError) {
+    try {
+        await session.close();
+    }
+    catch (closeError) {
+        throw new UserError(`Failed to apply a ${providerName} sandbox manifest and close the sandbox. Manifest error: ${errorMessage(manifestError)} Close error: ${errorMessage(closeError)}`);
+    }
+    throw manifestError;
+}
+export function assertRunAsUnsupported(providerName, runAs) {
+    if (runAs) {
+        throw new SandboxUnsupportedFeatureError(`${providerName} does not support runAs yet.`, {
+            provider: providerName,
+            feature: 'runAs',
+        });
+    }
+}
+export function assertCoreSnapshotUnsupported(providerName, snapshot) {
+    if (snapshot && snapshot.type !== 'noop') {
+        throw new SandboxUnsupportedFeatureError(`${providerName} does not support core sandbox snapshots yet. Use the provider-specific workspacePersistence option when available.`, {
+            provider: providerName,
+            feature: 'snapshot',
+        });
+    }
+}
+export function assertCoreConcurrencyLimitsUnsupported(providerName, limits) {
+    if (limits?.manifestEntries !== undefined ||
+        limits?.localDirFiles !== undefined) {
+        throw new SandboxUnsupportedFeatureError(`${providerName} does not support core sandbox concurrencyLimits yet.`, {
+            provider: providerName,
+            feature: 'concurrencyLimits',
+        });
+    }
+}
+export async function withProviderError(providerName, provider, operation, fn, context = {}) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        if (error instanceof UserError) {
+            throw error;
+        }
+        throw new SandboxProviderError(`${providerName} failed to ${operation}.`, {
+            provider,
+            operation,
+            ...context,
+            cause: errorMessage(error),
+        });
+    }
+}
+export function isProviderSandboxNotFoundError(error) {
+    if (isNotFoundErrorRecord(error, new Set())) {
+        return true;
+    }
+    const text = errorMessage(error).trim();
+    return isNotFoundErrorMessage(text);
+}
+export function assertResumeRecreateAllowed(error, context) {
+    if (error instanceof UserError) {
+        throw error;
+    }
+    if (isProviderSandboxNotFoundError(error)) {
+        return;
+    }
+    throw new SandboxProviderError(`${context.providerName} failed to reconnect sandbox during resume.`, {
+        provider: context.provider,
+        operation: 'resume',
+        ...context.details,
+        cause: errorMessage(error),
+    });
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isNotFoundErrorRecord(error, seen) {
+    if (!isRecord(error)) {
+        return false;
+    }
+    if (seen.has(error)) {
+        return false;
+    }
+    seen.add(error);
+    for (const key of ['status', 'statusCode', 'httpStatus', 'httpStatusCode']) {
+        if (is404(error[key])) {
+            return true;
+        }
+    }
+    const response = error.response;
+    if (isRecord(response) && is404(response.status)) {
+        return true;
+    }
+    if (isNotFoundErrorCode(error.code)) {
+        return true;
+    }
+    if (typeof error.message === 'string' &&
+        isNotFoundErrorMessage(error.message)) {
+        return true;
+    }
+    return isNotFoundErrorRecord(error.cause, seen);
+}
+function is404(value) {
+    return value === 404 || value === '404';
+}
+function isNotFoundErrorCode(value) {
+    if (typeof value === 'number') {
+        return value === 404;
+    }
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return /^(404|not_found|not-found|notfound|resource_not_found|resource-not-found|not found)$/iu.test(value.trim());
+}
+function isNotFoundErrorMessage(message) {
+    const text = message.trim();
+    if (!text) {
+        return false;
+    }
+    if (/^(404|not[_ -]?found)$/iu.test(text)) {
+        return true;
+    }
+    return (/\b(sandbox|sandbox instance|instance|devbox)\b.*\b(not found|missing|does not exist|no such)\b/iu.test(text) ||
+        /\b(not found|missing|does not exist|no such)\b.*\b(sandbox|sandbox instance|instance|devbox)\b/iu.test(text));
+}
+//# sourceMappingURL=session.mjs.map

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

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

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

@@ -0,0 +1,90 @@
+import { type ToolOutputImage } from '@openai/agents-core';
+import { type ExecCommandArgs, type ExposedPortEndpoint, type Manifest, type MaterializeEntryArgs, type ReadFileArgs, type SandboxConcurrencyLimits, type SandboxSession, type SandboxSessionState, type ViewImageArgs, type WorkspaceArchiveData } from '@openai/agents-core/sandbox';
+import { type RemoteWorkspaceTarIo } from './archive';
+import { RemoteSandboxEditor } from './editor';
+import type { ManifestMaterializationOptions } from './manifest';
+import type { RemoteManifestWriter, RemoteSandboxPathOptions, RemoteSandboxPathResolver, SandboxManifestMetadataSupport } from './types';
+export type RemoteSandboxCommandKind = 'archive' | 'exec' | 'manifest' | 'path' | 'running';
+export type RemoteSandboxCommandOptions = {
+    kind: RemoteSandboxCommandKind;
+    workdir: string;
+    runAs?: string;
+    execArgs?: ExecCommandArgs;
+    timeoutMs?: number;
+};
+export type RemoteSandboxCommandResult = {
+    status: number;
+    stdout?: string;
+    stderr?: string;
+};
+export type RemoteSandboxSessionBaseOptions = {
+    providerName: string;
+    providerId: string;
+    concurrencyLimits?: SandboxConcurrencyLimits;
+};
+export declare abstract class RemoteSandboxSessionBase<TState extends SandboxSessionState & {
+    environment: Record<string, string>;
+}> implements SandboxSession<TState> {
+    readonly state: TState;
+    protected readonly providerName: string;
+    protected readonly providerId: string;
+    private readonly concurrencyLimits?;
+    protected readonly remotePathResolver: RemoteSandboxPathResolver;
+    protected constructor(args: {
+        state: TState;
+        options: RemoteSandboxSessionBaseOptions;
+    });
+    createEditor(runAs?: string): RemoteSandboxEditor;
+    supportsPty(): boolean;
+    execCommand(args: ExecCommandArgs): Promise<string>;
+    viewImage(args: ViewImageArgs): Promise<ToolOutputImage>;
+    pathExists(path: string, runAs?: string): Promise<boolean>;
+    readFile(args: ReadFileArgs): Promise<Uint8Array>;
+    running(): Promise<boolean>;
+    resolveExposedPort(port: number): Promise<ExposedPortEndpoint>;
+    materializeEntry(args: MaterializeEntryArgs): Promise<void>;
+    applyManifest(manifest: Manifest, runAs?: string): Promise<void>;
+    persistWorkspace(): Promise<Uint8Array>;
+    hydrateWorkspace(data: WorkspaceArchiveData): Promise<void>;
+    protected abstract runRemoteCommand(command: string, options: RemoteSandboxCommandOptions): Promise<RemoteSandboxCommandResult>;
+    protected abstract mkdirRemote(path: string): Promise<void>;
+    protected abstract readRemoteText(path: string): Promise<string>;
+    protected abstract readRemoteFile(path: string): Promise<Uint8Array>;
+    protected abstract writeRemoteFile(path: string, content: string | Uint8Array): Promise<void>;
+    protected abstract deleteRemotePath(path: string): Promise<void>;
+    protected execPtyCommand(_args: ExecCommandArgs): Promise<string>;
+    protected assertExecRunAs(runAs?: string): void;
+    protected assertFilesystemRunAs(runAs?: string): void;
+    protected assertManifestRunAs(runAs?: string): void;
+    protected beforeExecCommand(_args: ExecCommandArgs): Promise<void>;
+    protected beforeFilesystemMutation(): Promise<void>;
+    protected beforeMaterializeEntry(_args: MaterializeEntryArgs): Promise<void>;
+    protected beforeApplyManifest(_manifest: Manifest): Promise<void>;
+    protected resolveManifestForApply(manifest: Manifest): Manifest | Promise<Manifest>;
+    protected manifestMetadataSupport(): SandboxManifestMetadataSupport | undefined;
+    protected manifestMaterializationOptions(): ManifestMaterializationOptions;
+    protected workspacePersistence(): unknown;
+    protected configuredExposedPorts(): number[] | undefined;
+    protected allowOnDemandExposedPorts(): boolean;
+    protected useCachedExposedPortEndpoint(_port: number): boolean;
+    protected exposedPortSource(): string;
+    protected resolveRemoteExposedPort(port: number): Promise<string | ExposedPortEndpoint>;
+    protected runningWorkdir(): string;
+    protected resolveWorkdir(path?: string): string;
+    protected resolveAbsolutePath(path?: string): string;
+    protected resolveRemotePath(path?: string, options?: RemoteSandboxPathOptions): Promise<string>;
+    protected ensureParentDir(path: string): Promise<void>;
+    protected persistWorkspaceTar(): Promise<Uint8Array>;
+    protected hydrateWorkspaceTar(data: WorkspaceArchiveData): Promise<void>;
+    protected manifestWriter(): RemoteManifestWriter;
+    protected materializeManifestEntries(manifest: Manifest): Promise<void>;
+    protected archiveIo(): RemoteWorkspaceTarIo;
+    private parentDir;
+    private createRunAsEditor;
+    private readRemoteFileAs;
+    private writeRemoteTextAs;
+    private manifestMaterializationOptionsWithMetadata;
+    private provisionManifestAccounts;
+    private applyManifestEntryMetadata;
+    private runCheckedRemoteCommand;
+}