@openai/agents-extensions 0.8.5 → 0.9.1

package/dist/sandbox/shared/ports.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertConfiguredExposedPort = assertConfiguredExposedPort;
+exports.getCachedExposedPortEndpoint = getCachedExposedPortEndpoint;
+exports.recordResolvedExposedPortEndpoint = recordResolvedExposedPortEndpoint;
+exports.parseExposedPortEndpoint = parseExposedPortEndpoint;
+const sandbox_1 = require("@openai/agents-core/sandbox");
+function assertConfiguredExposedPort(args) {
+    const port = (0, sandbox_1.normalizeExposedPort)(args.port);
+    if (args.allowOnDemand) {
+        return port;
+    }
+    const configuredPorts = args.configuredPorts?.map((entry) => (0, sandbox_1.normalizeExposedPort)(entry));
+    if (!configuredPorts?.includes(port)) {
+        throw new sandbox_1.SandboxConfigurationError(`${args.providerName} exposed port ${port} was not configured. Configure exposedPorts with ${port} before resolving it.`, {
+            provider: args.providerName,
+            port,
+            configuredPorts: configuredPorts ?? [],
+        });
+    }
+    return port;
+}
+function getCachedExposedPortEndpoint(state, port) {
+    return (0, sandbox_1.getRecordedExposedPortEndpoint)(state, port);
+}
+function recordResolvedExposedPortEndpoint(state, requestedPort, endpoint) {
+    return (0, sandbox_1.recordExposedPortEndpoint)(state, endpoint, requestedPort);
+}
+function parseExposedPortEndpoint(value, args) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new sandbox_1.SandboxProviderError(`${args.providerName} returned an empty exposed port ${args.source}.`, {
+            provider: args.providerName,
+            source: args.source,
+        });
+    }
+    const hasScheme = /^[a-z][a-z0-9+.-]*:\/\//iu.test(trimmed);
+    let parsed;
+    try {
+        parsed = new URL(hasScheme ? trimmed : `http://${trimmed}`);
+    }
+    catch (error) {
+        throw new sandbox_1.SandboxProviderError(`${args.providerName} returned an invalid exposed port ${args.source}: ${trimmed}`, {
+            provider: args.providerName,
+            source: args.source,
+            value: trimmed,
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+    const host = parsed.hostname;
+    if (!host) {
+        throw new sandbox_1.SandboxProviderError(`${args.providerName} returned an exposed port ${args.source} without a host: ${trimmed}`, {
+            provider: args.providerName,
+            source: args.source,
+            value: trimmed,
+        });
+    }
+    const explicitPort = parsed.port.length > 0 ? Number.parseInt(parsed.port, 10) : undefined;
+    const tls = hasScheme
+        ? parsed.protocol === 'https:' || parsed.protocol === 'wss:'
+        : explicitPort === undefined;
+    const port = (0, sandbox_1.normalizeExposedPort)(explicitPort ?? (tls ? 443 : 80));
+    const query = [parsed.search.replace(/^\?/u, ''), args.query]
+        .filter((entry) => typeof entry === 'string')
+        .filter((entry) => entry.length > 0)
+        .join('&');
+    return {
+        host,
+        port,
+        tls,
+        query,
+        url: hasScheme ? trimmed : undefined,
+    };
+}
+//# sourceMappingURL=ports.js.map

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

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

package/dist/sandbox/shared/ports.mjs

@@ -0,0 +1,69 @@
+import { SandboxConfigurationError, SandboxProviderError, getRecordedExposedPortEndpoint, normalizeExposedPort, recordExposedPortEndpoint, } from '@openai/agents-core/sandbox';
+export function assertConfiguredExposedPort(args) {
+    const port = normalizeExposedPort(args.port);
+    if (args.allowOnDemand) {
+        return port;
+    }
+    const configuredPorts = args.configuredPorts?.map((entry) => normalizeExposedPort(entry));
+    if (!configuredPorts?.includes(port)) {
+        throw new SandboxConfigurationError(`${args.providerName} exposed port ${port} was not configured. Configure exposedPorts with ${port} before resolving it.`, {
+            provider: args.providerName,
+            port,
+            configuredPorts: configuredPorts ?? [],
+        });
+    }
+    return port;
+}
+export function getCachedExposedPortEndpoint(state, port) {
+    return getRecordedExposedPortEndpoint(state, port);
+}
+export function recordResolvedExposedPortEndpoint(state, requestedPort, endpoint) {
+    return recordExposedPortEndpoint(state, endpoint, requestedPort);
+}
+export function parseExposedPortEndpoint(value, args) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new SandboxProviderError(`${args.providerName} returned an empty exposed port ${args.source}.`, {
+            provider: args.providerName,
+            source: args.source,
+        });
+    }
+    const hasScheme = /^[a-z][a-z0-9+.-]*:\/\//iu.test(trimmed);
+    let parsed;
+    try {
+        parsed = new URL(hasScheme ? trimmed : `http://${trimmed}`);
+    }
+    catch (error) {
+        throw new SandboxProviderError(`${args.providerName} returned an invalid exposed port ${args.source}: ${trimmed}`, {
+            provider: args.providerName,
+            source: args.source,
+            value: trimmed,
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+    const host = parsed.hostname;
+    if (!host) {
+        throw new SandboxProviderError(`${args.providerName} returned an exposed port ${args.source} without a host: ${trimmed}`, {
+            provider: args.providerName,
+            source: args.source,
+            value: trimmed,
+        });
+    }
+    const explicitPort = parsed.port.length > 0 ? Number.parseInt(parsed.port, 10) : undefined;
+    const tls = hasScheme
+        ? parsed.protocol === 'https:' || parsed.protocol === 'wss:'
+        : explicitPort === undefined;
+    const port = normalizeExposedPort(explicitPort ?? (tls ? 443 : 80));
+    const query = [parsed.search.replace(/^\?/u, ''), args.query]
+        .filter((entry) => typeof entry === 'string')
+        .filter((entry) => entry.length > 0)
+        .join('&');
+    return {
+        host,
+        port,
+        tls,
+        query,
+        url: hasScheme ? trimmed : undefined,
+    };
+}
+//# sourceMappingURL=ports.mjs.map

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

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

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

@@ -0,0 +1,16 @@
+export type SandboxProcessResult = {
+    status: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+    timedOut: boolean;
+};
+export type RunSandboxProcessOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    maxOutputBytes?: number;
+};
+export declare function runSandboxProcess(command: string, args: string[], options?: RunSandboxProcessOptions): Promise<SandboxProcessResult>;
+export declare function formatSandboxProcessError(result: SandboxProcessResult): string;

package/dist/sandbox/shared/process.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSandboxProcess = runSandboxProcess;
+exports.formatSandboxProcessError = formatSandboxProcessError;
+const node_child_process_1 = require("node:child_process");
+const DEFAULT_MAX_OUTPUT_BYTES = 1024 * 1024;
+const FORCE_KILL_DELAY_MS = 5_000;
+async function runSandboxProcess(command, args, options = {}) {
+    return new Promise((resolve) => {
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let stdoutBytes = 0;
+        let stderrBytes = 0;
+        let error;
+        let timedOut = false;
+        let closed = false;
+        let settled = false;
+        let timeout;
+        let forceKillTimeout;
+        const maxOutputBytes = options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+        const child = (0, node_child_process_1.spawn)(command, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const captureChunk = (chunks, currentBytes, chunk) => {
+            const remainingBytes = maxOutputBytes - currentBytes;
+            if (remainingBytes <= 0) {
+                return currentBytes;
+            }
+            const captured = chunk.length > remainingBytes
+                ? chunk.subarray(0, remainingBytes)
+                : chunk;
+            chunks.push(captured);
+            return currentBytes + captured.length;
+        };
+        const finish = (status, signal) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            closed = true;
+            if (timeout) {
+                clearTimeout(timeout);
+            }
+            if (forceKillTimeout) {
+                clearTimeout(forceKillTimeout);
+            }
+            resolve({
+                status,
+                signal,
+                stdout: Buffer.concat(stdoutChunks).toString('utf8'),
+                stderr: Buffer.concat(stderrChunks).toString('utf8'),
+                error,
+                timedOut,
+            });
+        };
+        child.stdout.on('data', (chunk) => {
+            stdoutBytes = captureChunk(stdoutChunks, stdoutBytes, chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            stderrBytes = captureChunk(stderrChunks, stderrBytes, chunk);
+        });
+        child.on('error', (childError) => {
+            error = childError;
+            finish(null, null);
+        });
+        if (options.timeoutMs !== undefined) {
+            timeout = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                forceKillTimeout = setTimeout(() => {
+                    if (!closed) {
+                        child.kill('SIGKILL');
+                    }
+                }, FORCE_KILL_DELAY_MS);
+            }, options.timeoutMs);
+        }
+        child.on('close', (status, signal) => {
+            finish(status, signal);
+        });
+    });
+}
+function formatSandboxProcessError(result) {
+    if (result.timedOut) {
+        return 'process timed out';
+    }
+    return (result.stderr || result.stdout || result.error?.message || 'process failed');
+}
+//# sourceMappingURL=process.js.map

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

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

package/dist/sandbox/shared/process.mjs

@@ -0,0 +1,86 @@
+import { spawn } from 'node:child_process';
+const DEFAULT_MAX_OUTPUT_BYTES = 1024 * 1024;
+const FORCE_KILL_DELAY_MS = 5_000;
+export async function runSandboxProcess(command, args, options = {}) {
+    return new Promise((resolve) => {
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let stdoutBytes = 0;
+        let stderrBytes = 0;
+        let error;
+        let timedOut = false;
+        let closed = false;
+        let settled = false;
+        let timeout;
+        let forceKillTimeout;
+        const maxOutputBytes = options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const captureChunk = (chunks, currentBytes, chunk) => {
+            const remainingBytes = maxOutputBytes - currentBytes;
+            if (remainingBytes <= 0) {
+                return currentBytes;
+            }
+            const captured = chunk.length > remainingBytes
+                ? chunk.subarray(0, remainingBytes)
+                : chunk;
+            chunks.push(captured);
+            return currentBytes + captured.length;
+        };
+        const finish = (status, signal) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            closed = true;
+            if (timeout) {
+                clearTimeout(timeout);
+            }
+            if (forceKillTimeout) {
+                clearTimeout(forceKillTimeout);
+            }
+            resolve({
+                status,
+                signal,
+                stdout: Buffer.concat(stdoutChunks).toString('utf8'),
+                stderr: Buffer.concat(stderrChunks).toString('utf8'),
+                error,
+                timedOut,
+            });
+        };
+        child.stdout.on('data', (chunk) => {
+            stdoutBytes = captureChunk(stdoutChunks, stdoutBytes, chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            stderrBytes = captureChunk(stderrChunks, stderrBytes, chunk);
+        });
+        child.on('error', (childError) => {
+            error = childError;
+            finish(null, null);
+        });
+        if (options.timeoutMs !== undefined) {
+            timeout = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                forceKillTimeout = setTimeout(() => {
+                    if (!closed) {
+                        child.kill('SIGKILL');
+                    }
+                }, FORCE_KILL_DELAY_MS);
+            }, options.timeoutMs);
+        }
+        child.on('close', (status, signal) => {
+            finish(status, signal);
+        });
+    });
+}
+export function formatSandboxProcessError(result) {
+    if (result.timedOut) {
+        return 'process timed out';
+    }
+    return (result.stderr || result.stdout || result.error?.message || 'process failed');
+}
+//# sourceMappingURL=process.mjs.map

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

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

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

@@ -0,0 +1,81 @@
+export type PtyProcessEntry = {
+    tty: boolean;
+    output: string;
+    done: boolean;
+    exitCode: number | null;
+    lastUsed: number;
+    waiters: Set<() => void>;
+    sendInput?: (chars: string) => Promise<void>;
+    terminate?: () => Promise<void>;
+};
+export type PtyWebSocket = {
+    readyState?: number;
+    binaryType?: string;
+    send(data: string | Uint8Array | ArrayBuffer): void;
+    close(): void;
+    addEventListener?: (type: string, listener: (event: unknown) => void) => void;
+    removeEventListener?: (type: string, listener: (event: unknown) => void) => void;
+    on?: (type: string, listener: (...args: unknown[]) => void) => void;
+    off?: (type: string, listener: (...args: unknown[]) => void) => void;
+    removeListener?: (type: string, listener: (...args: unknown[]) => void) => void;
+};
+export declare function createPtyProcessEntry(args: {
+    tty?: boolean;
+    sendInput?: (chars: string) => Promise<void>;
+    terminate?: () => Promise<void>;
+}): PtyProcessEntry;
+export declare function appendPtyOutput(entry: PtyProcessEntry, chunk: string | Uint8Array | ArrayBuffer): void;
+export declare function markPtyDone(entry: PtyProcessEntry, exitCode?: number | null): void;
+export declare function watchPtyProcess(entry: PtyProcessEntry, wait: () => Promise<unknown>, exitCode: (result: unknown, error?: unknown) => number | null | undefined): void;
+export declare function openPtyWebSocket(args: {
+    url: string;
+    providerName: string;
+    headers?: Record<string, string>;
+    headersUnsupportedUrl?: string;
+    timeoutMs?: number;
+    configure?: (socket: PtyWebSocket) => void | Promise<void>;
+}): Promise<PtyWebSocket>;
+export declare function addPtyWebSocketListener(socket: PtyWebSocket, type: string, listener: (event: unknown) => void): () => void;
+export declare class PtyProcessRegistry {
+    private readonly processes;
+    register(entry: PtyProcessEntry): {
+        sessionId: number;
+        pruned?: PtyProcessEntry;
+    };
+    get(sessionId: number): PtyProcessEntry | undefined;
+    terminateAll(): Promise<void>;
+    finalize(sessionId: number): Promise<{
+        processId?: number;
+        exitCode?: number | null;
+    }>;
+    private pruneIfNeeded;
+}
+export declare function collectPtyOutput(args: {
+    entry: PtyProcessEntry;
+    yieldTimeMs: number;
+    maxOutputTokens?: number;
+}): Promise<{
+    text: string;
+    originalTokenCount?: number;
+}>;
+export declare function writePtyStdin(args: {
+    providerName: string;
+    registry: PtyProcessRegistry;
+    sessionId: number;
+    chars?: string;
+    yieldTimeMs?: number;
+    maxOutputTokens?: number;
+}): Promise<string>;
+export declare function formatPtyExecUpdate(args: {
+    registry: PtyProcessRegistry;
+    sessionId: number;
+    entry: PtyProcessEntry;
+    startTime: number;
+    yieldTimeMs?: number;
+    maxOutputTokens?: number;
+}): Promise<string>;
+export declare function shellCommandForPty(args: {
+    cmd: string;
+    shell?: string;
+    login?: boolean;
+}): string;