@openai/agents-core 0.8.4 → 0.9.0

package/dist/sandbox/permissions.d.ts

@@ -0,0 +1,29 @@
+export declare enum FileMode {
+    ALL = 7,
+    NONE = 0,
+    READ = 4,
+    WRITE = 2,
+    EXEC = 1
+}
+export type PermissionsValue = {
+    owner?: number;
+    group?: number;
+    other?: number;
+    directory?: boolean;
+};
+export type PermissionsInit = PermissionsValue | string | number | Permissions;
+export declare const DEFAULT_SANDBOX_ENTRY_PERMISSIONS: Required<PermissionsValue>;
+export declare function permissionsForSandboxEntry(permissions?: PermissionsInit): Permissions;
+export declare class Permissions {
+    readonly owner: number;
+    readonly group: number;
+    readonly other: number;
+    readonly directory: boolean;
+    constructor(init?: PermissionsInit);
+    static fromMode(mode: number): Permissions;
+    static fromString(value: string): Permissions;
+    toMode(): number;
+    normalized(): Required<PermissionsValue>;
+    toString(): string;
+}
+export declare function normalizePermissions(permissions: PermissionsInit): Required<PermissionsValue>;

package/dist/sandbox/permissions.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Permissions = exports.DEFAULT_SANDBOX_ENTRY_PERMISSIONS = exports.FileMode = void 0;
+exports.permissionsForSandboxEntry = permissionsForSandboxEntry;
+exports.normalizePermissions = normalizePermissions;
+var FileMode;
+(function (FileMode) {
+    FileMode[FileMode["ALL"] = 7] = "ALL";
+    FileMode[FileMode["NONE"] = 0] = "NONE";
+    FileMode[FileMode["READ"] = 4] = "READ";
+    FileMode[FileMode["WRITE"] = 2] = "WRITE";
+    FileMode[FileMode["EXEC"] = 1] = "EXEC";
+})(FileMode || (exports.FileMode = FileMode = {}));
+exports.DEFAULT_SANDBOX_ENTRY_PERMISSIONS = {
+    owner: FileMode.ALL,
+    group: FileMode.READ | FileMode.EXEC,
+    other: FileMode.READ | FileMode.EXEC,
+    directory: false,
+};
+function permissionsForSandboxEntry(permissions) {
+    return new Permissions(permissions ?? exports.DEFAULT_SANDBOX_ENTRY_PERMISSIONS);
+}
+class Permissions {
+    owner;
+    group;
+    other;
+    directory;
+    constructor(init = {}) {
+        if (init instanceof Permissions) {
+            this.owner = init.owner;
+            this.group = init.group;
+            this.other = init.other;
+            this.directory = init.directory;
+            return;
+        }
+        if (typeof init === 'string') {
+            const parsed = Permissions.fromString(init);
+            this.owner = parsed.owner;
+            this.group = parsed.group;
+            this.other = parsed.other;
+            this.directory = parsed.directory;
+            return;
+        }
+        if (typeof init === 'number') {
+            const parsed = Permissions.fromMode(init);
+            this.owner = parsed.owner;
+            this.group = parsed.group;
+            this.other = parsed.other;
+            this.directory = parsed.directory;
+            return;
+        }
+        this.owner = normalizePermissionBits(init.owner ?? FileMode.ALL, 'owner');
+        this.group = normalizePermissionBits(init.group ?? FileMode.NONE, 'group');
+        this.other = normalizePermissionBits(init.other ?? FileMode.NONE, 'other');
+        this.directory = init.directory ?? false;
+    }
+    static fromMode(mode) {
+        return new Permissions({
+            owner: (mode >> 6) & 0b111,
+            group: (mode >> 3) & 0b111,
+            other: mode & 0b111,
+            directory: (mode & 0o40000) !== 0,
+        });
+    }
+    static fromString(value) {
+        const permissions = value.length === 11 && /[@+]$/u.test(value) ? value.slice(0, -1) : value;
+        if (permissions.length !== 10) {
+            throw new Error(`Invalid permissions string length: ${value}`);
+        }
+        if (permissions[0] !== 'd' && permissions[0] !== '-') {
+            throw new Error(`Invalid permissions type: ${value}`);
+        }
+        return new Permissions({
+            directory: permissions[0] === 'd',
+            owner: parsePermissionTriplet(permissions.slice(1, 4)),
+            group: parsePermissionTriplet(permissions.slice(4, 7)),
+            other: parsePermissionTriplet(permissions.slice(7, 10)),
+        });
+    }
+    toMode() {
+        return ((this.directory ? 0o40000 : 0) |
+            (this.owner << 6) |
+            (this.group << 3) |
+            this.other);
+    }
+    normalized() {
+        return {
+            owner: this.owner,
+            group: this.group,
+            other: this.other,
+            directory: this.directory,
+        };
+    }
+    toString() {
+        return `${this.directory ? 'd' : '-'}${formatPermissionTriplet(this.owner)}${formatPermissionTriplet(this.group)}${formatPermissionTriplet(this.other)}`;
+    }
+}
+exports.Permissions = Permissions;
+function normalizePermissions(permissions) {
+    return new Permissions(permissions).normalized();
+}
+function normalizePermissionBits(value, label) {
+    if (!Number.isInteger(value) || value < 0 || value > 0b111) {
+        throw new Error(`Permission ${label} bits must be an integer from 0 to 7.`);
+    }
+    return value;
+}
+function parsePermissionTriplet(value) {
+    if (value.length !== 3) {
+        throw new Error(`Invalid permissions triplet: ${value}`);
+    }
+    let mode = 0;
+    if (value[0] === 'r') {
+        mode |= FileMode.READ;
+    }
+    else if (value[0] !== '-') {
+        throw new Error(`Invalid read flag: ${value}`);
+    }
+    if (value[1] === 'w') {
+        mode |= FileMode.WRITE;
+    }
+    else if (value[1] !== '-') {
+        throw new Error(`Invalid write flag: ${value}`);
+    }
+    if (value[2] === 'x') {
+        mode |= FileMode.EXEC;
+    }
+    else if (value[2] !== '-') {
+        throw new Error(`Invalid exec flag: ${value}`);
+    }
+    return mode;
+}
+function formatPermissionTriplet(value) {
+    return [
+        value & FileMode.READ ? 'r' : '-',
+        value & FileMode.WRITE ? 'w' : '-',
+        value & FileMode.EXEC ? 'x' : '-',
+    ].join('');
+}
+//# sourceMappingURL=permissions.js.map

package/dist/sandbox/permissions.js.map

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

package/dist/sandbox/permissions.mjs

@@ -0,0 +1,134 @@
+export var FileMode;
+(function (FileMode) {
+    FileMode[FileMode["ALL"] = 7] = "ALL";
+    FileMode[FileMode["NONE"] = 0] = "NONE";
+    FileMode[FileMode["READ"] = 4] = "READ";
+    FileMode[FileMode["WRITE"] = 2] = "WRITE";
+    FileMode[FileMode["EXEC"] = 1] = "EXEC";
+})(FileMode || (FileMode = {}));
+export const DEFAULT_SANDBOX_ENTRY_PERMISSIONS = {
+    owner: FileMode.ALL,
+    group: FileMode.READ | FileMode.EXEC,
+    other: FileMode.READ | FileMode.EXEC,
+    directory: false,
+};
+export function permissionsForSandboxEntry(permissions) {
+    return new Permissions(permissions ?? DEFAULT_SANDBOX_ENTRY_PERMISSIONS);
+}
+export class Permissions {
+    owner;
+    group;
+    other;
+    directory;
+    constructor(init = {}) {
+        if (init instanceof Permissions) {
+            this.owner = init.owner;
+            this.group = init.group;
+            this.other = init.other;
+            this.directory = init.directory;
+            return;
+        }
+        if (typeof init === 'string') {
+            const parsed = Permissions.fromString(init);
+            this.owner = parsed.owner;
+            this.group = parsed.group;
+            this.other = parsed.other;
+            this.directory = parsed.directory;
+            return;
+        }
+        if (typeof init === 'number') {
+            const parsed = Permissions.fromMode(init);
+            this.owner = parsed.owner;
+            this.group = parsed.group;
+            this.other = parsed.other;
+            this.directory = parsed.directory;
+            return;
+        }
+        this.owner = normalizePermissionBits(init.owner ?? FileMode.ALL, 'owner');
+        this.group = normalizePermissionBits(init.group ?? FileMode.NONE, 'group');
+        this.other = normalizePermissionBits(init.other ?? FileMode.NONE, 'other');
+        this.directory = init.directory ?? false;
+    }
+    static fromMode(mode) {
+        return new Permissions({
+            owner: (mode >> 6) & 0b111,
+            group: (mode >> 3) & 0b111,
+            other: mode & 0b111,
+            directory: (mode & 0o40000) !== 0,
+        });
+    }
+    static fromString(value) {
+        const permissions = value.length === 11 && /[@+]$/u.test(value) ? value.slice(0, -1) : value;
+        if (permissions.length !== 10) {
+            throw new Error(`Invalid permissions string length: ${value}`);
+        }
+        if (permissions[0] !== 'd' && permissions[0] !== '-') {
+            throw new Error(`Invalid permissions type: ${value}`);
+        }
+        return new Permissions({
+            directory: permissions[0] === 'd',
+            owner: parsePermissionTriplet(permissions.slice(1, 4)),
+            group: parsePermissionTriplet(permissions.slice(4, 7)),
+            other: parsePermissionTriplet(permissions.slice(7, 10)),
+        });
+    }
+    toMode() {
+        return ((this.directory ? 0o40000 : 0) |
+            (this.owner << 6) |
+            (this.group << 3) |
+            this.other);
+    }
+    normalized() {
+        return {
+            owner: this.owner,
+            group: this.group,
+            other: this.other,
+            directory: this.directory,
+        };
+    }
+    toString() {
+        return `${this.directory ? 'd' : '-'}${formatPermissionTriplet(this.owner)}${formatPermissionTriplet(this.group)}${formatPermissionTriplet(this.other)}`;
+    }
+}
+export function normalizePermissions(permissions) {
+    return new Permissions(permissions).normalized();
+}
+function normalizePermissionBits(value, label) {
+    if (!Number.isInteger(value) || value < 0 || value > 0b111) {
+        throw new Error(`Permission ${label} bits must be an integer from 0 to 7.`);
+    }
+    return value;
+}
+function parsePermissionTriplet(value) {
+    if (value.length !== 3) {
+        throw new Error(`Invalid permissions triplet: ${value}`);
+    }
+    let mode = 0;
+    if (value[0] === 'r') {
+        mode |= FileMode.READ;
+    }
+    else if (value[0] !== '-') {
+        throw new Error(`Invalid read flag: ${value}`);
+    }
+    if (value[1] === 'w') {
+        mode |= FileMode.WRITE;
+    }
+    else if (value[1] !== '-') {
+        throw new Error(`Invalid write flag: ${value}`);
+    }
+    if (value[2] === 'x') {
+        mode |= FileMode.EXEC;
+    }
+    else if (value[2] !== '-') {
+        throw new Error(`Invalid exec flag: ${value}`);
+    }
+    return mode;
+}
+function formatPermissionTriplet(value) {
+    return [
+        value & FileMode.READ ? 'r' : '-',
+        value & FileMode.WRITE ? 'w' : '-',
+        value & FileMode.EXEC ? 'x' : '-',
+    ].join('');
+}
+//# sourceMappingURL=permissions.mjs.map

package/dist/sandbox/permissions.mjs.map

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

package/dist/sandbox/runtime/agentKeys.d.ts

@@ -0,0 +1,7 @@
+import type { Agent, AgentOutputType } from '../../agent';
+import type { SandboxAgent } from '../agent';
+export declare function allocateAgentKeys<TContext>(startingAgent: Agent<TContext, AgentOutputType>): Map<number, string>;
+export declare function acquireSandboxAgent<TContext>(agent: SandboxAgent<TContext, AgentOutputType>): number;
+export declare function releaseSandboxAgents<TContext>(agents: Iterable<SandboxAgent<TContext, AgentOutputType>>): void;
+export declare function isSandboxAgent<TContext>(agent: Agent<TContext, AgentOutputType>): agent is SandboxAgent<TContext, AgentOutputType>;
+export declare function getObjectId(value: object): number;

package/dist/sandbox/runtime/agentKeys.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocateAgentKeys = allocateAgentKeys;
+exports.acquireSandboxAgent = acquireSandboxAgent;
+exports.releaseSandboxAgents = releaseSandboxAgents;
+exports.isSandboxAgent = isSandboxAgent;
+exports.getObjectId = getObjectId;
+const handoff_1 = require("../../handoff.js");
+const brand_1 = require("../brand.js");
+const sandboxConcurrencyGuards = new WeakMap();
+const objectIds = new WeakMap();
+let nextObjectId = 1;
+function allocateAgentKeys(startingAgent) {
+    const keys = new Map();
+    const counts = new Map();
+    const usedKeys = new Set();
+    const queue = [startingAgent];
+    const visited = new Set();
+    while (queue.length > 0) {
+        const agent = queue.shift();
+        if (visited.has(agent)) {
+            continue;
+        }
+        visited.add(agent);
+        keys.set(getObjectId(agent), allocateUniqueAgentKey(agent.name, counts, usedKeys));
+        for (const handoff of agent.handoffs) {
+            queue.push(handoff instanceof handoff_1.Handoff
+                ? handoff.agent
+                : handoff);
+        }
+    }
+    return keys;
+}
+function allocateUniqueAgentKey(agentName, counts, usedKeys) {
+    while (true) {
+        const count = counts.get(agentName) ?? 0;
+        counts.set(agentName, count + 1);
+        const candidate = count === 0 ? agentName : `${agentName}_${count + 1}`;
+        if (!usedKeys.has(candidate)) {
+            usedKeys.add(candidate);
+            return candidate;
+        }
+    }
+}
+function acquireSandboxAgent(agent) {
+    const agentId = getObjectId(agent);
+    const guard = sandboxConcurrencyGuards.get(agent) ?? { activeRuns: 0 };
+    sandboxConcurrencyGuards.set(agent, guard);
+    if (guard.activeRuns > 0) {
+        throw new Error(`SandboxAgent '${agent.name}' cannot be reused concurrently across runs`);
+    }
+    guard.activeRuns += 1;
+    return agentId;
+}
+function releaseSandboxAgents(agents) {
+    for (const agent of agents) {
+        const guard = sandboxConcurrencyGuards.get(agent);
+        if (guard) {
+            guard.activeRuns = Math.max(0, guard.activeRuns - 1);
+        }
+    }
+}
+function isSandboxAgent(agent) {
+    return (Object.prototype.hasOwnProperty.call(agent, brand_1.SANDBOX_AGENT_BRAND) &&
+        agent[brand_1.SANDBOX_AGENT_BRAND] === true);
+}
+function getObjectId(value) {
+    const existing = objectIds.get(value);
+    if (existing) {
+        return existing;
+    }
+    const assigned = nextObjectId++;
+    objectIds.set(value, assigned);
+    return assigned;
+}
+//# sourceMappingURL=agentKeys.js.map

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

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

package/dist/sandbox/runtime/agentKeys.mjs

@@ -0,0 +1,69 @@
+import { Handoff } from "../../handoff.mjs";
+import { SANDBOX_AGENT_BRAND } from "../brand.mjs";
+const sandboxConcurrencyGuards = new WeakMap();
+const objectIds = new WeakMap();
+let nextObjectId = 1;
+export function allocateAgentKeys(startingAgent) {
+    const keys = new Map();
+    const counts = new Map();
+    const usedKeys = new Set();
+    const queue = [startingAgent];
+    const visited = new Set();
+    while (queue.length > 0) {
+        const agent = queue.shift();
+        if (visited.has(agent)) {
+            continue;
+        }
+        visited.add(agent);
+        keys.set(getObjectId(agent), allocateUniqueAgentKey(agent.name, counts, usedKeys));
+        for (const handoff of agent.handoffs) {
+            queue.push(handoff instanceof Handoff
+                ? handoff.agent
+                : handoff);
+        }
+    }
+    return keys;
+}
+function allocateUniqueAgentKey(agentName, counts, usedKeys) {
+    while (true) {
+        const count = counts.get(agentName) ?? 0;
+        counts.set(agentName, count + 1);
+        const candidate = count === 0 ? agentName : `${agentName}_${count + 1}`;
+        if (!usedKeys.has(candidate)) {
+            usedKeys.add(candidate);
+            return candidate;
+        }
+    }
+}
+export function acquireSandboxAgent(agent) {
+    const agentId = getObjectId(agent);
+    const guard = sandboxConcurrencyGuards.get(agent) ?? { activeRuns: 0 };
+    sandboxConcurrencyGuards.set(agent, guard);
+    if (guard.activeRuns > 0) {
+        throw new Error(`SandboxAgent '${agent.name}' cannot be reused concurrently across runs`);
+    }
+    guard.activeRuns += 1;
+    return agentId;
+}
+export function releaseSandboxAgents(agents) {
+    for (const agent of agents) {
+        const guard = sandboxConcurrencyGuards.get(agent);
+        if (guard) {
+            guard.activeRuns = Math.max(0, guard.activeRuns - 1);
+        }
+    }
+}
+export function isSandboxAgent(agent) {
+    return (Object.prototype.hasOwnProperty.call(agent, SANDBOX_AGENT_BRAND) &&
+        agent[SANDBOX_AGENT_BRAND] === true);
+}
+export function getObjectId(value) {
+    const existing = objectIds.get(value);
+    if (existing) {
+        return existing;
+    }
+    const assigned = nextObjectId++;
+    objectIds.set(value, assigned);
+    return assigned;
+}
+//# sourceMappingURL=agentKeys.mjs.map

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

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

package/dist/sandbox/runtime/agentPreparation.d.ts

@@ -0,0 +1,20 @@
+import type { AgentOutputType } from '../../agent';
+import type { Model } from '../../model';
+import type { Capability } from '../capabilities';
+import type { SandboxAgent } from '../agent';
+import type { SandboxSessionLike, SandboxSessionState } from '../session';
+export { getDefaultSandboxInstructions } from './prompts';
+type PrepareSandboxAgentArgs<TContext, TOutput extends AgentOutputType> = {
+    agent: SandboxAgent<TContext, TOutput>;
+    session: SandboxSessionLike<SandboxSessionState>;
+    capabilities?: Capability[];
+    runConfigModel?: SandboxRuntimeModel;
+    processManifest?: boolean;
+};
+export type ResolvedSandboxRuntimeModel = {
+    model: string;
+    modelInstance: Model;
+};
+export type SandboxRuntimeModel = string | Model | ResolvedSandboxRuntimeModel;
+export declare function cloneSandboxCapabilities(capabilities: Capability[]): Capability[];
+export declare function prepareSandboxAgent<TContext, TOutput extends AgentOutputType>({ agent, session, capabilities, runConfigModel, processManifest, }: PrepareSandboxAgentArgs<TContext, TOutput>): SandboxAgent<TContext, TOutput>;