@openai/agents-core 0.8.4 → 0.9.0

package/dist/sandbox/capabilities/base.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Capability = void 0;
+exports.requireBoundSession = requireBoundSession;
+const errors_1 = require("../errors.js");
+class Capability {
+    _session;
+    _runAs;
+    _modelInstance;
+    clone() {
+        const cloned = Object.create(Object.getPrototypeOf(this));
+        for (const [key, value] of Object.entries(this)) {
+            if (key === '_session' || key === '_runAs' || key === '_modelInstance') {
+                continue;
+            }
+            cloned[key] = cloneCapabilityValue(value);
+        }
+        return cloned;
+    }
+    bind(session) {
+        this._session = session;
+        return this;
+    }
+    bindRunAs(runAs) {
+        this._runAs = typeof runAs === 'string' ? runAs : runAs?.name;
+        return this;
+    }
+    bindModel(_model, modelInstance) {
+        this._modelInstance = modelInstance;
+        return this;
+    }
+    requiredCapabilityTypes() {
+        return new Set();
+    }
+    tools() {
+        return [];
+    }
+    processManifest(manifest) {
+        return manifest;
+    }
+    instructions(_manifest) {
+        return null;
+    }
+    samplingParams(_samplingParams) {
+        return {};
+    }
+    processContext(context) {
+        return context;
+    }
+}
+exports.Capability = Capability;
+function requireBoundSession(capabilityType, session) {
+    if (!session) {
+        throw new errors_1.SandboxConfigurationError(`${capitalize(capabilityType)} capability is not bound to a SandboxSession`, { capability: capabilityType });
+    }
+    return session;
+}
+function cloneCapabilityValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => cloneCapabilityValue(item));
+    }
+    if (value instanceof Uint8Array) {
+        return new Uint8Array(value);
+    }
+    if (value instanceof Map) {
+        return new Map(value);
+    }
+    if (value instanceof Set) {
+        return new Set(value);
+    }
+    if (isPlainRecord(value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, childValue]) => [
+            key,
+            cloneCapabilityValue(childValue),
+        ]));
+    }
+    return value;
+}
+function isPlainRecord(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function capitalize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+//# sourceMappingURL=base.js.map

package/dist/sandbox/capabilities/base.js.map

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

package/dist/sandbox/capabilities/base.mjs

@@ -0,0 +1,84 @@
+import { SandboxConfigurationError } from "../errors.mjs";
+export class Capability {
+    _session;
+    _runAs;
+    _modelInstance;
+    clone() {
+        const cloned = Object.create(Object.getPrototypeOf(this));
+        for (const [key, value] of Object.entries(this)) {
+            if (key === '_session' || key === '_runAs' || key === '_modelInstance') {
+                continue;
+            }
+            cloned[key] = cloneCapabilityValue(value);
+        }
+        return cloned;
+    }
+    bind(session) {
+        this._session = session;
+        return this;
+    }
+    bindRunAs(runAs) {
+        this._runAs = typeof runAs === 'string' ? runAs : runAs?.name;
+        return this;
+    }
+    bindModel(_model, modelInstance) {
+        this._modelInstance = modelInstance;
+        return this;
+    }
+    requiredCapabilityTypes() {
+        return new Set();
+    }
+    tools() {
+        return [];
+    }
+    processManifest(manifest) {
+        return manifest;
+    }
+    instructions(_manifest) {
+        return null;
+    }
+    samplingParams(_samplingParams) {
+        return {};
+    }
+    processContext(context) {
+        return context;
+    }
+}
+export function requireBoundSession(capabilityType, session) {
+    if (!session) {
+        throw new SandboxConfigurationError(`${capitalize(capabilityType)} capability is not bound to a SandboxSession`, { capability: capabilityType });
+    }
+    return session;
+}
+function cloneCapabilityValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => cloneCapabilityValue(item));
+    }
+    if (value instanceof Uint8Array) {
+        return new Uint8Array(value);
+    }
+    if (value instanceof Map) {
+        return new Map(value);
+    }
+    if (value instanceof Set) {
+        return new Set(value);
+    }
+    if (isPlainRecord(value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, childValue]) => [
+            key,
+            cloneCapabilityValue(childValue),
+        ]));
+    }
+    return value;
+}
+function isPlainRecord(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function capitalize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+//# sourceMappingURL=base.mjs.map

package/dist/sandbox/capabilities/base.mjs.map

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

package/dist/sandbox/capabilities/compaction.d.ts

@@ -0,0 +1,33 @@
+import type { AgentInputItem } from '../../types';
+import { Capability } from './base';
+export declare abstract class CompactionPolicy {
+    abstract compactThreshold(model?: string): number;
+}
+export declare class StaticCompactionPolicy extends CompactionPolicy {
+    readonly threshold: number;
+    constructor(threshold?: number);
+    compactThreshold(): number;
+}
+export declare class DynamicCompactionPolicy extends CompactionPolicy {
+    readonly thresholdRatio: number;
+    readonly fallbackThreshold: number;
+    constructor(thresholdRatio?: number, fallbackThreshold?: number);
+    compactThreshold(model?: string): number;
+}
+export declare class CompactionModelInfo {
+    readonly contextWindow: number;
+    constructor(contextWindow: number);
+    static forModel(model: string): CompactionModelInfo | undefined;
+}
+declare class CompactionCapability extends Capability {
+    readonly type = "compaction";
+    readonly policy: CompactionPolicy;
+    constructor(policy?: CompactionPolicy);
+    samplingParams(samplingParams: Record<string, unknown>): Record<string, unknown>;
+    processContext(context: AgentInputItem[]): AgentInputItem[];
+}
+export type Compaction = CompactionCapability;
+export declare function compaction(args?: {
+    policy?: CompactionPolicy;
+}): Compaction;
+export {};

package/dist/sandbox/capabilities/compaction.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompactionModelInfo = exports.DynamicCompactionPolicy = exports.StaticCompactionPolicy = exports.CompactionPolicy = void 0;
+exports.compaction = compaction;
+const base_1 = require("./base.js");
+const transport_1 = require("./transport.js");
+class CompactionPolicy {
+}
+exports.CompactionPolicy = CompactionPolicy;
+class StaticCompactionPolicy extends CompactionPolicy {
+    threshold;
+    constructor(threshold = 240000) {
+        super();
+        this.threshold = threshold;
+    }
+    compactThreshold() {
+        return this.threshold;
+    }
+}
+exports.StaticCompactionPolicy = StaticCompactionPolicy;
+class DynamicCompactionPolicy extends CompactionPolicy {
+    thresholdRatio;
+    fallbackThreshold;
+    constructor(thresholdRatio = 0.9, fallbackThreshold = 240000) {
+        super();
+        this.thresholdRatio = thresholdRatio;
+        this.fallbackThreshold = fallbackThreshold;
+    }
+    compactThreshold(model) {
+        if (!model) {
+            return this.fallbackThreshold;
+        }
+        const modelInfo = CompactionModelInfo.forModel(model);
+        if (!modelInfo) {
+            return this.fallbackThreshold;
+        }
+        return Math.floor(modelInfo.contextWindow * this.thresholdRatio);
+    }
+}
+exports.DynamicCompactionPolicy = DynamicCompactionPolicy;
+class CompactionModelInfo {
+    contextWindow;
+    constructor(contextWindow) {
+        this.contextWindow = contextWindow;
+    }
+    static forModel(model) {
+        for (const candidate of getSandboxCompactionModelCandidates(model)) {
+            if (SANDBOX_CONTEXT_WINDOWS_1M.has(candidate)) {
+                return new CompactionModelInfo(1047576);
+            }
+            if (SANDBOX_CONTEXT_WINDOWS_400K.has(candidate)) {
+                return new CompactionModelInfo(400000);
+            }
+            if (SANDBOX_CONTEXT_WINDOWS_200K.has(candidate)) {
+                return new CompactionModelInfo(200000);
+            }
+            if (SANDBOX_CONTEXT_WINDOWS_128K.has(candidate)) {
+                return new CompactionModelInfo(128000);
+            }
+        }
+        return undefined;
+    }
+}
+exports.CompactionModelInfo = CompactionModelInfo;
+class CompactionCapability extends base_1.Capability {
+    type = 'compaction';
+    policy;
+    constructor(policy = new DynamicCompactionPolicy()) {
+        super();
+        this.policy = policy;
+    }
+    samplingParams(samplingParams) {
+        if (samplingParams.modelInstance &&
+            !(0, transport_1.supportsResponsesCompactionTransport)(samplingParams.modelInstance)) {
+            return {};
+        }
+        const model = typeof samplingParams.model === 'string'
+            ? samplingParams.model
+            : undefined;
+        return {
+            context_management: [
+                {
+                    type: 'compaction',
+                    compact_threshold: this.policy.compactThreshold(model),
+                },
+            ],
+        };
+    }
+    processContext(context) {
+        let lastCompactionIndex = -1;
+        for (let index = 0; index < context.length; index += 1) {
+            if (context[index].type === 'compaction') {
+                lastCompactionIndex = index;
+            }
+        }
+        if (lastCompactionIndex === -1) {
+            return context;
+        }
+        return context.slice(lastCompactionIndex);
+    }
+}
+function compaction(args = {}) {
+    return new CompactionCapability(args.policy);
+}
+function getSandboxCompactionModelCandidates(model) {
+    const trimmed = model.trim();
+    if (!trimmed) {
+        return [];
+    }
+    const withoutProviderPrefix = trimmed.includes('/')
+        ? trimmed.slice(trimmed.lastIndexOf('/') + 1)
+        : trimmed;
+    const normalized = withoutProviderPrefix.toLowerCase();
+    const withoutPinnedDate = normalized.replace(/-\d{4}-\d{2}-\d{2}$/u, '');
+    return [...new Set([normalized, withoutPinnedDate])];
+}
+const SANDBOX_CONTEXT_WINDOWS_1M = new Set([
+    'gpt-5.4',
+    'gpt-5.4-2026-03-05',
+    'gpt-5.4-pro',
+    'gpt-5.4-pro-2026-03-05',
+    'gpt-4.1',
+    'gpt-4.1-2025-04-14',
+    'gpt-4.1-mini',
+    'gpt-4.1-mini-2025-04-14',
+    'gpt-4.1-nano',
+    'gpt-4.1-nano-2025-04-14',
+]);
+const SANDBOX_CONTEXT_WINDOWS_400K = new Set([
+    'gpt-5',
+    'gpt-5-codex',
+    'gpt-5-mini',
+    'gpt-5-nano',
+    'gpt-5-pro',
+    'gpt-5.1',
+    'gpt-5.1-codex',
+    'gpt-5.1-codex-max',
+    'gpt-5.1-codex-mini',
+    'gpt-5.2',
+    'gpt-5.2-codex',
+    'gpt-5.2-codex-cyber',
+    'gpt-5.2-pro',
+    'gpt-5.3-codex',
+    'gpt-5.3-codex-spark',
+    'gpt-5.4-mini',
+    'gpt-5.4-nano',
+]);
+const SANDBOX_CONTEXT_WINDOWS_200K = new Set([
+    'codex-mini-latest',
+    'o1',
+    'o1-2024-12-17',
+    'o1-pro',
+    'o3',
+    'o3-2025-04-16',
+    'o3-mini',
+    'o3-pro',
+    'o3-deep-research',
+    'o4-mini',
+    'o4-mini-2025-04-16',
+    'o4-mini-deep-research',
+]);
+const SANDBOX_CONTEXT_WINDOWS_128K = new Set([
+    'gpt-4o',
+    'gpt-4o-2024-08-06',
+    'gpt-4o-mini',
+    'gpt-4o-mini-2024-07-18',
+    'gpt-5-chat-latest',
+    'gpt-5.1-chat-latest',
+    'gpt-5.2-chat-latest',
+    'gpt-5.3-chat-latest',
+]);
+//# sourceMappingURL=compaction.js.map

package/dist/sandbox/capabilities/compaction.js.map

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

package/dist/sandbox/capabilities/compaction.mjs

@@ -0,0 +1,164 @@
+import { Capability } from "./base.mjs";
+import { supportsResponsesCompactionTransport } from "./transport.mjs";
+export class CompactionPolicy {
+}
+export class StaticCompactionPolicy extends CompactionPolicy {
+    threshold;
+    constructor(threshold = 240000) {
+        super();
+        this.threshold = threshold;
+    }
+    compactThreshold() {
+        return this.threshold;
+    }
+}
+export class DynamicCompactionPolicy extends CompactionPolicy {
+    thresholdRatio;
+    fallbackThreshold;
+    constructor(thresholdRatio = 0.9, fallbackThreshold = 240000) {
+        super();
+        this.thresholdRatio = thresholdRatio;
+        this.fallbackThreshold = fallbackThreshold;
+    }
+    compactThreshold(model) {
+        if (!model) {
+            return this.fallbackThreshold;
+        }
+        const modelInfo = CompactionModelInfo.forModel(model);
+        if (!modelInfo) {
+            return this.fallbackThreshold;
+        }
+        return Math.floor(modelInfo.contextWindow * this.thresholdRatio);
+    }
+}
+export class CompactionModelInfo {
+    contextWindow;
+    constructor(contextWindow) {
+        this.contextWindow = contextWindow;
+    }
+    static forModel(model) {
+        for (const candidate of getSandboxCompactionModelCandidates(model)) {
+            if (SANDBOX_CONTEXT_WINDOWS_1M.has(candidate)) {
+                return new CompactionModelInfo(1047576);
+            }
+            if (SANDBOX_CONTEXT_WINDOWS_400K.has(candidate)) {
+                return new CompactionModelInfo(400000);
+            }
+            if (SANDBOX_CONTEXT_WINDOWS_200K.has(candidate)) {
+                return new CompactionModelInfo(200000);
+            }
+            if (SANDBOX_CONTEXT_WINDOWS_128K.has(candidate)) {
+                return new CompactionModelInfo(128000);
+            }
+        }
+        return undefined;
+    }
+}
+class CompactionCapability extends Capability {
+    type = 'compaction';
+    policy;
+    constructor(policy = new DynamicCompactionPolicy()) {
+        super();
+        this.policy = policy;
+    }
+    samplingParams(samplingParams) {
+        if (samplingParams.modelInstance &&
+            !supportsResponsesCompactionTransport(samplingParams.modelInstance)) {
+            return {};
+        }
+        const model = typeof samplingParams.model === 'string'
+            ? samplingParams.model
+            : undefined;
+        return {
+            context_management: [
+                {
+                    type: 'compaction',
+                    compact_threshold: this.policy.compactThreshold(model),
+                },
+            ],
+        };
+    }
+    processContext(context) {
+        let lastCompactionIndex = -1;
+        for (let index = 0; index < context.length; index += 1) {
+            if (context[index].type === 'compaction') {
+                lastCompactionIndex = index;
+            }
+        }
+        if (lastCompactionIndex === -1) {
+            return context;
+        }
+        return context.slice(lastCompactionIndex);
+    }
+}
+export function compaction(args = {}) {
+    return new CompactionCapability(args.policy);
+}
+function getSandboxCompactionModelCandidates(model) {
+    const trimmed = model.trim();
+    if (!trimmed) {
+        return [];
+    }
+    const withoutProviderPrefix = trimmed.includes('/')
+        ? trimmed.slice(trimmed.lastIndexOf('/') + 1)
+        : trimmed;
+    const normalized = withoutProviderPrefix.toLowerCase();
+    const withoutPinnedDate = normalized.replace(/-\d{4}-\d{2}-\d{2}$/u, '');
+    return [...new Set([normalized, withoutPinnedDate])];
+}
+const SANDBOX_CONTEXT_WINDOWS_1M = new Set([
+    'gpt-5.4',
+    'gpt-5.4-2026-03-05',
+    'gpt-5.4-pro',
+    'gpt-5.4-pro-2026-03-05',
+    'gpt-4.1',
+    'gpt-4.1-2025-04-14',
+    'gpt-4.1-mini',
+    'gpt-4.1-mini-2025-04-14',
+    'gpt-4.1-nano',
+    'gpt-4.1-nano-2025-04-14',
+]);
+const SANDBOX_CONTEXT_WINDOWS_400K = new Set([
+    'gpt-5',
+    'gpt-5-codex',
+    'gpt-5-mini',
+    'gpt-5-nano',
+    'gpt-5-pro',
+    'gpt-5.1',
+    'gpt-5.1-codex',
+    'gpt-5.1-codex-max',
+    'gpt-5.1-codex-mini',
+    'gpt-5.2',
+    'gpt-5.2-codex',
+    'gpt-5.2-codex-cyber',
+    'gpt-5.2-pro',
+    'gpt-5.3-codex',
+    'gpt-5.3-codex-spark',
+    'gpt-5.4-mini',
+    'gpt-5.4-nano',
+]);
+const SANDBOX_CONTEXT_WINDOWS_200K = new Set([
+    'codex-mini-latest',
+    'o1',
+    'o1-2024-12-17',
+    'o1-pro',
+    'o3',
+    'o3-2025-04-16',
+    'o3-mini',
+    'o3-pro',
+    'o3-deep-research',
+    'o4-mini',
+    'o4-mini-2025-04-16',
+    'o4-mini-deep-research',
+]);
+const SANDBOX_CONTEXT_WINDOWS_128K = new Set([
+    'gpt-4o',
+    'gpt-4o-2024-08-06',
+    'gpt-4o-mini',
+    'gpt-4o-mini-2024-07-18',
+    'gpt-5-chat-latest',
+    'gpt-5.1-chat-latest',
+    'gpt-5.2-chat-latest',
+    'gpt-5.3-chat-latest',
+]);
+//# sourceMappingURL=compaction.mjs.map

package/dist/sandbox/capabilities/compaction.mjs.map

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

package/dist/sandbox/capabilities/filesystem.d.ts

@@ -0,0 +1,14 @@
+import { type Tool } from '../../tool';
+import { Capability, type ConfigureCapabilityTools } from './base';
+export type FilesystemArgs = {
+    configureTools?: ConfigureCapabilityTools;
+};
+declare class FilesystemCapability extends Capability {
+    readonly type = "filesystem";
+    private readonly configureTools?;
+    constructor(args?: FilesystemArgs);
+    tools(): Tool<any>[];
+}
+export type Filesystem = FilesystemCapability;
+export declare function filesystem(args?: FilesystemArgs): Filesystem;
+export {};