@openai/agents-core 0.8.5 → 0.9.0

package/dist/sandbox/runtime/toolRehydration.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processedResponseRequiresExecutionToolRehydration = processedResponseRequiresExecutionToolRehydration;
+exports.getSerializedFunctionToolPlaceholder = getSerializedFunctionToolPlaceholder;
+exports.getSerializedComputerToolPlaceholder = getSerializedComputerToolPlaceholder;
+exports.getSerializedShellToolPlaceholder = getSerializedShellToolPlaceholder;
+exports.getSerializedApplyPatchToolPlaceholder = getSerializedApplyPatchToolPlaceholder;
+const errors_1 = require("../../errors.js");
+const toolIdentity_1 = require("../../toolIdentity.js");
+const agentKeys_1 = require("./agentKeys.js");
+const SERIALIZED_EXECUTION_TOOL_PLACEHOLDER = Symbol('serializedExecutionToolPlaceholder');
+function markSerializedExecutionToolPlaceholder(tool) {
+    Object.defineProperty(tool, SERIALIZED_EXECUTION_TOOL_PLACEHOLDER, {
+        value: true,
+        enumerable: false,
+    });
+    return tool;
+}
+function isSerializedExecutionToolPlaceholder(tool) {
+    return Boolean(tool &&
+        typeof tool === 'object' &&
+        tool[SERIALIZED_EXECUTION_TOOL_PLACEHOLDER] === true);
+}
+function processedResponseRequiresExecutionToolRehydration(processedResponse) {
+    if (!processedResponse) {
+        return false;
+    }
+    return ((processedResponse.functions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.tool)) ||
+        (processedResponse.computerActions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.computer)) ||
+        (processedResponse.shellActions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.shell)) ||
+        (processedResponse.applyPatchActions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.applyPatch)));
+}
+function hasConfiguredFunctionTool(tools, toolCall, toolIdentity) {
+    const configuredFunctionTools = new Map(tools
+        .filter((tool) => tool.type === 'function')
+        .map((tool) => [(0, toolIdentity_1.getFunctionToolQualifiedName)(tool) ?? tool.name, tool]));
+    const configuredIdentity = (0, toolIdentity_1.resolveFunctionToolCallName)(toolCall, configuredFunctionTools) ??
+        toolIdentity;
+    return configuredFunctionTools.has(configuredIdentity);
+}
+function hasConfiguredTool(tools, type, name) {
+    return tools.some((tool) => tool.type === type &&
+        'name' in tool &&
+        typeof tool.name === 'string' &&
+        tool.name === name);
+}
+function canUseSerializedExecutionToolPlaceholder(args) {
+    const { agent, allowSerializedExecutionToolPlaceholder, configuredToolExists, serializedTool, type, } = args;
+    return (allowSerializedExecutionToolPlaceholder &&
+        (0, agentKeys_1.isSandboxAgent)(agent) &&
+        !configuredToolExists &&
+        Boolean(serializedTool) &&
+        typeof serializedTool === 'object' &&
+        serializedTool.type === type);
+}
+function getSerializedToolName(serializedTool, fallbackName) {
+    const name = serializedTool &&
+        typeof serializedTool === 'object' &&
+        typeof serializedTool.name === 'string'
+        ? serializedTool.name
+        : fallbackName;
+    return name;
+}
+function createSerializedExecutionToolError(type, name) {
+    return new errors_1.UserError(`${type} tool ${name} was restored from serialized execution-time metadata without an executable handler. Resume the RunState through Runner.run() with the matching execution-time tool configuration before executing it.`);
+}
+function getSerializedFunctionToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolCall, toolIdentity, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredFunctionTool(baseAgentTools, toolCall, toolIdentity),
+        serializedTool,
+        type: 'function',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolCall.name);
+    const placeholder = {
+        ...serialized,
+        type: 'function',
+        name,
+        description: typeof serialized.description === 'string'
+            ? serialized.description
+            : `Serialized execution-time tool ${name}.`,
+        parameters: serialized.parameters &&
+            typeof serialized.parameters === 'object' &&
+            !Array.isArray(serialized.parameters)
+            ? serialized.parameters
+            : {
+                type: 'object',
+                properties: {},
+                required: [],
+                additionalProperties: false,
+            },
+        strict: typeof serialized.strict === 'boolean' ? serialized.strict : true,
+        deferLoading: typeof serialized.deferLoading === 'boolean'
+            ? serialized.deferLoading
+            : false,
+        invoke: async () => {
+            throw createSerializedExecutionToolError('Function', toolIdentity);
+        },
+        needsApproval: async () => false,
+        isEnabled: async () => true,
+    };
+    if (typeof toolCall.namespace === 'string' &&
+        toolCall.namespace.length > 0 &&
+        toolCall.namespace !== name) {
+        Object.assign(placeholder, {
+            [toolIdentity_1.FUNCTION_TOOL_NAMESPACE]: toolCall.namespace,
+            [toolIdentity_1.FUNCTION_TOOL_NAMESPACE_DESCRIPTION]: toolCall.namespace,
+        });
+    }
+    return markSerializedExecutionToolPlaceholder(placeholder);
+}
+function getSerializedComputerToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolName, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredTool(baseAgentTools, 'computer', toolName),
+        serializedTool,
+        type: 'computer',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolName);
+    const throwComputerError = async () => {
+        throw createSerializedExecutionToolError('Computer', name);
+    };
+    return markSerializedExecutionToolPlaceholder({
+        ...serialized,
+        type: 'computer',
+        name,
+        computer: {
+            environment: 'browser',
+            dimensions: [1, 1],
+            screenshot: throwComputerError,
+            click: throwComputerError,
+            doubleClick: throwComputerError,
+            scroll: throwComputerError,
+            type: throwComputerError,
+            wait: throwComputerError,
+            move: throwComputerError,
+            keypress: throwComputerError,
+            drag: throwComputerError,
+        },
+        needsApproval: async () => false,
+    });
+}
+function getSerializedShellToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolName, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredTool(baseAgentTools, 'shell', toolName),
+        serializedTool,
+        type: 'shell',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolName);
+    return markSerializedExecutionToolPlaceholder({
+        ...serialized,
+        type: 'shell',
+        name,
+        environment: { type: 'local' },
+        shell: {
+            run: async () => {
+                throw createSerializedExecutionToolError('Shell', name);
+            },
+        },
+        needsApproval: async () => false,
+    });
+}
+function getSerializedApplyPatchToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolName, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredTool(baseAgentTools, 'apply_patch', toolName),
+        serializedTool,
+        type: 'apply_patch',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolName);
+    const throwEditorError = async () => {
+        throw createSerializedExecutionToolError('Apply patch', name);
+    };
+    return markSerializedExecutionToolPlaceholder({
+        ...serialized,
+        type: 'apply_patch',
+        name,
+        editor: {
+            createFile: throwEditorError,
+            updateFile: throwEditorError,
+            deleteFile: throwEditorError,
+        },
+        needsApproval: async () => false,
+    });
+}
+//# sourceMappingURL=toolRehydration.js.map

package/dist/sandbox/runtime/toolRehydration.js.map

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

package/dist/sandbox/runtime/toolRehydration.mjs

@@ -0,0 +1,200 @@
+import { UserError } from "../../errors.mjs";
+import { FUNCTION_TOOL_NAMESPACE, FUNCTION_TOOL_NAMESPACE_DESCRIPTION, getFunctionToolQualifiedName, resolveFunctionToolCallName, } from "../../toolIdentity.mjs";
+import { isSandboxAgent } from "./agentKeys.mjs";
+const SERIALIZED_EXECUTION_TOOL_PLACEHOLDER = Symbol('serializedExecutionToolPlaceholder');
+function markSerializedExecutionToolPlaceholder(tool) {
+    Object.defineProperty(tool, SERIALIZED_EXECUTION_TOOL_PLACEHOLDER, {
+        value: true,
+        enumerable: false,
+    });
+    return tool;
+}
+function isSerializedExecutionToolPlaceholder(tool) {
+    return Boolean(tool &&
+        typeof tool === 'object' &&
+        tool[SERIALIZED_EXECUTION_TOOL_PLACEHOLDER] === true);
+}
+export function processedResponseRequiresExecutionToolRehydration(processedResponse) {
+    if (!processedResponse) {
+        return false;
+    }
+    return ((processedResponse.functions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.tool)) ||
+        (processedResponse.computerActions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.computer)) ||
+        (processedResponse.shellActions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.shell)) ||
+        (processedResponse.applyPatchActions ?? []).some((item) => isSerializedExecutionToolPlaceholder(item.applyPatch)));
+}
+function hasConfiguredFunctionTool(tools, toolCall, toolIdentity) {
+    const configuredFunctionTools = new Map(tools
+        .filter((tool) => tool.type === 'function')
+        .map((tool) => [getFunctionToolQualifiedName(tool) ?? tool.name, tool]));
+    const configuredIdentity = resolveFunctionToolCallName(toolCall, configuredFunctionTools) ??
+        toolIdentity;
+    return configuredFunctionTools.has(configuredIdentity);
+}
+function hasConfiguredTool(tools, type, name) {
+    return tools.some((tool) => tool.type === type &&
+        'name' in tool &&
+        typeof tool.name === 'string' &&
+        tool.name === name);
+}
+function canUseSerializedExecutionToolPlaceholder(args) {
+    const { agent, allowSerializedExecutionToolPlaceholder, configuredToolExists, serializedTool, type, } = args;
+    return (allowSerializedExecutionToolPlaceholder &&
+        isSandboxAgent(agent) &&
+        !configuredToolExists &&
+        Boolean(serializedTool) &&
+        typeof serializedTool === 'object' &&
+        serializedTool.type === type);
+}
+function getSerializedToolName(serializedTool, fallbackName) {
+    const name = serializedTool &&
+        typeof serializedTool === 'object' &&
+        typeof serializedTool.name === 'string'
+        ? serializedTool.name
+        : fallbackName;
+    return name;
+}
+function createSerializedExecutionToolError(type, name) {
+    return new UserError(`${type} tool ${name} was restored from serialized execution-time metadata without an executable handler. Resume the RunState through Runner.run() with the matching execution-time tool configuration before executing it.`);
+}
+export function getSerializedFunctionToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolCall, toolIdentity, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredFunctionTool(baseAgentTools, toolCall, toolIdentity),
+        serializedTool,
+        type: 'function',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolCall.name);
+    const placeholder = {
+        ...serialized,
+        type: 'function',
+        name,
+        description: typeof serialized.description === 'string'
+            ? serialized.description
+            : `Serialized execution-time tool ${name}.`,
+        parameters: serialized.parameters &&
+            typeof serialized.parameters === 'object' &&
+            !Array.isArray(serialized.parameters)
+            ? serialized.parameters
+            : {
+                type: 'object',
+                properties: {},
+                required: [],
+                additionalProperties: false,
+            },
+        strict: typeof serialized.strict === 'boolean' ? serialized.strict : true,
+        deferLoading: typeof serialized.deferLoading === 'boolean'
+            ? serialized.deferLoading
+            : false,
+        invoke: async () => {
+            throw createSerializedExecutionToolError('Function', toolIdentity);
+        },
+        needsApproval: async () => false,
+        isEnabled: async () => true,
+    };
+    if (typeof toolCall.namespace === 'string' &&
+        toolCall.namespace.length > 0 &&
+        toolCall.namespace !== name) {
+        Object.assign(placeholder, {
+            [FUNCTION_TOOL_NAMESPACE]: toolCall.namespace,
+            [FUNCTION_TOOL_NAMESPACE_DESCRIPTION]: toolCall.namespace,
+        });
+    }
+    return markSerializedExecutionToolPlaceholder(placeholder);
+}
+export function getSerializedComputerToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolName, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredTool(baseAgentTools, 'computer', toolName),
+        serializedTool,
+        type: 'computer',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolName);
+    const throwComputerError = async () => {
+        throw createSerializedExecutionToolError('Computer', name);
+    };
+    return markSerializedExecutionToolPlaceholder({
+        ...serialized,
+        type: 'computer',
+        name,
+        computer: {
+            environment: 'browser',
+            dimensions: [1, 1],
+            screenshot: throwComputerError,
+            click: throwComputerError,
+            doubleClick: throwComputerError,
+            scroll: throwComputerError,
+            type: throwComputerError,
+            wait: throwComputerError,
+            move: throwComputerError,
+            keypress: throwComputerError,
+            drag: throwComputerError,
+        },
+        needsApproval: async () => false,
+    });
+}
+export function getSerializedShellToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolName, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredTool(baseAgentTools, 'shell', toolName),
+        serializedTool,
+        type: 'shell',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolName);
+    return markSerializedExecutionToolPlaceholder({
+        ...serialized,
+        type: 'shell',
+        name,
+        environment: { type: 'local' },
+        shell: {
+            run: async () => {
+                throw createSerializedExecutionToolError('Shell', name);
+            },
+        },
+        needsApproval: async () => false,
+    });
+}
+export function getSerializedApplyPatchToolPlaceholder(args) {
+    const { agent, baseAgentTools, serializedTool, toolName, allowSerializedExecutionToolPlaceholder, } = args;
+    if (!canUseSerializedExecutionToolPlaceholder({
+        agent,
+        allowSerializedExecutionToolPlaceholder,
+        configuredToolExists: hasConfiguredTool(baseAgentTools, 'apply_patch', toolName),
+        serializedTool,
+        type: 'apply_patch',
+    })) {
+        return undefined;
+    }
+    const serialized = serializedTool;
+    const name = getSerializedToolName(serializedTool, toolName);
+    const throwEditorError = async () => {
+        throw createSerializedExecutionToolError('Apply patch', name);
+    };
+    return markSerializedExecutionToolPlaceholder({
+        ...serialized,
+        type: 'apply_patch',
+        name,
+        editor: {
+            createFile: throwEditorError,
+            updateFile: throwEditorError,
+            deleteFile: throwEditorError,
+        },
+        needsApproval: async () => false,
+    });
+}
+//# sourceMappingURL=toolRehydration.mjs.map

package/dist/sandbox/runtime/toolRehydration.mjs.map

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

package/dist/sandbox/sandboxes/docker.d.ts

@@ -0,0 +1,75 @@
+import type { Editor } from '../../editor';
+import type { ToolOutputImage } from '../../tool';
+import { type ChildProcessWithoutNullStreams } from 'node:child_process';
+import type { SandboxClient, SandboxClientOptions, SandboxClientCreateArgs, SandboxConcurrencyLimits } from '../client';
+import { Manifest } from '../manifest';
+import { type ResolveSandboxPathOptions } from '../workspacePaths';
+import { type ExposedPortEndpoint, type ListDirectoryArgs, type MaterializeEntryArgs, type ReadFileArgs, type SandboxDirectoryEntry, type ViewImageArgs } from '../session';
+import type { LocalSandboxSnapshotSpec } from './types';
+import { UnixLocalSandboxSession, type UnixLocalSandboxSessionState } from './unixLocal';
+export interface DockerSandboxClientOptions extends SandboxClientOptions {
+    image?: string;
+    exposedPorts?: number[];
+    workspaceBaseDir?: string;
+    snapshot?: LocalSandboxSnapshotSpec;
+    concurrencyLimits?: SandboxConcurrencyLimits;
+}
+export interface DockerSandboxSessionState extends UnixLocalSandboxSessionState {
+    containerId: string;
+    image: string;
+    defaultUser?: string;
+    configuredExposedPorts?: number[];
+    dockerVolumeNames?: string[];
+    snapshotExcludedPaths?: string[];
+}
+export declare class DockerSandboxSession extends UnixLocalSandboxSession<DockerSandboxSessionState> {
+    private containerClosed;
+    resolveFilesystemRunAs(runAs?: string): Promise<undefined>;
+    createEditor(runAs?: string): Editor;
+    viewImage(args: ViewImageArgs): Promise<ToolOutputImage>;
+    pathExists(path: string, runAs?: string): Promise<boolean>;
+    readFile(args: ReadFileArgs): Promise<Uint8Array>;
+    listDir(args: ListDirectoryArgs): Promise<SandboxDirectoryEntry[]>;
+    private pathRequiresDockerFilesystem;
+    materializeEntry(args: MaterializeEntryArgs): Promise<void>;
+    applyManifest(manifest: Manifest, runAs?: string): Promise<void>;
+    resolveExposedPort(port: number): Promise<ExposedPortEndpoint>;
+    protected resolveCommandWorkdir(path?: string): string;
+    protected spawnShellCommand(command: string, args: {
+        cwd: string;
+        logicalCwd: string;
+        shell?: string;
+        login: boolean;
+        runAs?: string;
+        tty?: boolean;
+    }): Promise<ChildProcessWithoutNullStreams>;
+    protected translateCommandInput(command: string): string;
+    protected translateCommandOutput(output: string): string;
+    protected materializeRestoredWorkspaceMounts(): Promise<void>;
+    resolveSandboxPath(path?: string, options?: ResolveSandboxPathOptions): string;
+    resolveContainerFilesystemPath(path?: string, options?: ResolveSandboxPathOptions): string;
+    readDockerFileAs(path: string, runAs?: string): Promise<Uint8Array>;
+    writeDockerTextFileAs(path: string, content: string, runAs: string): Promise<void>;
+    deleteDockerPathAs(path: string, runAs: string): Promise<void>;
+    mkdirDockerPathAs(path: string, runAs: string): Promise<void>;
+    runDockerMountCommand(command: string, action: string, options?: {
+        input?: string | Uint8Array;
+    }): Promise<string>;
+    private chownContainerPath;
+    private runCheckedDockerFilesystemCommand;
+    private runDockerFilesystemCommand;
+    close(): Promise<void>;
+}
+export declare class DockerSandboxClient implements SandboxClient<DockerSandboxClientOptions, DockerSandboxSessionState> {
+    readonly backendId = "docker";
+    readonly supportsDefaultOptions = true;
+    private readonly options;
+    constructor(options?: DockerSandboxClientOptions);
+    create(args?: SandboxClientCreateArgs<DockerSandboxClientOptions> | Manifest, manifestOptions?: DockerSandboxClientOptions): Promise<DockerSandboxSession>;
+    resume(state: DockerSandboxSessionState): Promise<DockerSandboxSession>;
+    serializeSessionState(state: DockerSandboxSessionState): Promise<Record<string, unknown>>;
+    deserializeSessionState(state: Record<string, unknown>): Promise<DockerSandboxSessionState>;
+    private restoreIfNeeded;
+    private cleanupDockerResources;
+    private restartContainer;
+}