@openai/agents-core 0.8.5 → 0.9.1

package/dist/sandbox/capabilities/memory.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memory = memory;
+exports.isMemoryCapability = isMemoryCapability;
+const errors_1 = require("../../errors.js");
+const entries_1 = require("../entries/index.js");
+const manifest_1 = require("../manifest.js");
+const spans_1 = require("../runtime/spans.js");
+const shell_1 = require("../shared/shell.js");
+const prompts_1 = require("../memory/prompts.js");
+const storage_1 = require("../memory/storage.js");
+const base_1 = require("./base.js");
+const MEMORY_SUMMARY_FILE = 'memory_summary.md';
+const MEMORY_SUMMARY_MAX_BYTES = 1_000_000;
+const DEFAULT_PHASE_ONE_MODEL = 'gpt-5.4-mini';
+const DEFAULT_PHASE_TWO_MODEL = 'gpt-5.4';
+const DEFAULT_MEMORY_MODEL_SETTINGS = {
+    reasoning: { effort: 'medium' },
+};
+const MEMORY_BEGIN_MARKER = '__OPENAI_AGENTS_MEMORY_SUMMARY_BEGIN__';
+const MEMORY_END_MARKER = '__OPENAI_AGENTS_MEMORY_SUMMARY_END__';
+class MemoryCapability extends base_1.Capability {
+    type = 'memory';
+    read;
+    generate;
+    layout;
+    store;
+    constructor(args = {}) {
+        super();
+        this.read = normalizeReadConfig(args.read);
+        this.generate = normalizeGenerateConfig(args.generate);
+        this.layout = normalizeLayoutConfig(args.layout);
+        this.store = args.store;
+        if (this.read === null && this.generate === null) {
+            throw new errors_1.UserError('Memory requires at least one of `read` or `generate`.');
+        }
+    }
+    requiredCapabilityTypes() {
+        if (this.read === null) {
+            return new Set();
+        }
+        if (this.read.liveUpdate) {
+            return new Set(['filesystem', 'shell']);
+        }
+        return new Set(['shell']);
+    }
+    processManifest(manifest) {
+        if (this.read?.liveUpdate || this.generate !== null) {
+            ensureDirectoryEntry(manifest, this.layout.memoriesDir);
+        }
+        if (this.generate !== null) {
+            ensureDirectoryEntry(manifest, this.layout.sessionsDir);
+        }
+        return manifest;
+    }
+    async instructions(_manifest) {
+        if (this.read === null) {
+            return null;
+        }
+        const session = (0, base_1.requireBoundSession)(this.type, this._session);
+        if (this.store) {
+            await new storage_1.SandboxMemoryStorage({
+                session,
+                runAs: this._runAs,
+                store: this.store,
+            }).hydrateFromStore(this.layout.memoriesDir);
+        }
+        const memorySummary = await this.readMemorySummary(session);
+        if (!memorySummary) {
+            return null;
+        }
+        return (0, prompts_1.renderMemoryReadPrompt)({
+            memoryDir: this.layout.memoriesDir,
+            memorySummary,
+            liveUpdate: Boolean(this.read.liveUpdate),
+        });
+    }
+    async readMemorySummary(session) {
+        const path = (0, storage_1.joinRelativePaths)(this.layout.memoriesDir, this.layout.summaryFile);
+        if (session.pathExists && !(await session.pathExists(path, this._runAs))) {
+            return await this.readStoredText(path);
+        }
+        if (session.readFile) {
+            try {
+                const payload = await (0, spans_1.withSandboxSpan)('sandbox.memory.read_summary', {
+                    path,
+                    run_as: this._runAs,
+                }, async () => await session.readFile({
+                    path,
+                    runAs: this._runAs,
+                    maxBytes: MEMORY_SUMMARY_MAX_BYTES,
+                }));
+                return normalizeMemorySummaryPayload(payload);
+            }
+            catch (error) {
+                if (isMissingFileError(error)) {
+                    return await this.readStoredText(path);
+                }
+                throw error;
+            }
+        }
+        const stored = await this.readStoredText(path);
+        if (stored !== null) {
+            return stored;
+        }
+        if (session.execCommand) {
+            return await readMemorySummaryWithShell({
+                session,
+                path,
+                runAs: this._runAs,
+            });
+        }
+        throw new errors_1.UserError('Memory sandbox sessions must provide readFile() or execCommand().');
+    }
+    async readStoredText(path) {
+        const stored = await this.store?.read(path);
+        return stored ? normalizeMemorySummaryPayload(stored) : null;
+    }
+}
+function memory(args = {}) {
+    return new MemoryCapability(args);
+}
+function isMemoryCapability(capability) {
+    return capability.type === 'memory' && capability instanceof MemoryCapability;
+}
+function normalizeReadConfig(config) {
+    if (config === null || config === false) {
+        return null;
+    }
+    if (config === undefined || config === true) {
+        return { enabled: true, liveUpdate: true };
+    }
+    rejectKnownSnakeCaseConfigKeys(config, ['live_update'], 'memory read config');
+    if (config.enabled === false) {
+        return null;
+    }
+    return {
+        enabled: true,
+        liveUpdate: config.liveUpdate ?? true,
+    };
+}
+function normalizeGenerateConfig(config) {
+    if (config === null || config === false) {
+        return null;
+    }
+    if (config === undefined || config === true) {
+        return {
+            enabled: true,
+            maxRawMemoriesForConsolidation: 256,
+            phaseOneModel: DEFAULT_PHASE_ONE_MODEL,
+            phaseOneModelSettings: DEFAULT_MEMORY_MODEL_SETTINGS,
+            phaseTwoModel: DEFAULT_PHASE_TWO_MODEL,
+            phaseTwoModelSettings: DEFAULT_MEMORY_MODEL_SETTINGS,
+        };
+    }
+    rejectKnownSnakeCaseConfigKeys(config, [
+        'max_raw_memories_for_consolidation',
+        'phase_one_model',
+        'phase_one_model_settings',
+        'phase_two_model',
+        'phase_two_model_settings',
+        'extra_prompt',
+    ], 'memory generate config');
+    if (config.enabled === false) {
+        return null;
+    }
+    const maxRawMemoriesForConsolidation = config.maxRawMemoriesForConsolidation ?? 256;
+    if (!Number.isInteger(maxRawMemoriesForConsolidation) ||
+        maxRawMemoriesForConsolidation <= 0 ||
+        maxRawMemoriesForConsolidation > 4096) {
+        throw new errors_1.UserError('MemoryGenerateConfig.maxRawMemoriesForConsolidation must be an integer between 1 and 4096.');
+    }
+    const sharedModel = normalizeMemoryModel(config.model);
+    const phaseOneModel = config.phaseOneModel ?? sharedModel;
+    const phaseTwoModel = config.phaseTwoModel ?? sharedModel;
+    const extraPrompt = config.extraPrompt ?? config.instructions;
+    const phaseOneModelSettings = config.phaseOneModelSettings ?? DEFAULT_MEMORY_MODEL_SETTINGS;
+    const phaseTwoModelSettings = config.phaseTwoModelSettings ?? DEFAULT_MEMORY_MODEL_SETTINGS;
+    return {
+        enabled: true,
+        maxRawMemoriesForConsolidation,
+        phaseOneModel: phaseOneModel ?? DEFAULT_PHASE_ONE_MODEL,
+        phaseTwoModel: phaseTwoModel ?? DEFAULT_PHASE_TWO_MODEL,
+        phaseOneModelSettings,
+        phaseTwoModelSettings,
+        ...(extraPrompt ? { extraPrompt } : {}),
+    };
+}
+function normalizeMemoryModel(model) {
+    if (typeof model !== 'string') {
+        return model;
+    }
+    const trimmed = model.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizeLayoutConfig(config) {
+    if (config !== undefined) {
+        rejectKnownSnakeCaseConfigKeys(config, ['memories_dir', 'sessions_dir', 'summary_file'], 'memory layout config');
+    }
+    const memoriesDir = normalizeRequiredRelativePath('layout.memoriesDir', config?.memoriesDir ?? config?.directory ?? 'memories');
+    const sessionsDir = normalizeRequiredRelativePath('layout.sessionsDir', config?.sessionsDir ?? 'sessions');
+    const summaryFile = normalizeRequiredRelativePath('layout.summaryFile', config?.summaryFile ?? MEMORY_SUMMARY_FILE);
+    if (summaryFile.includes('/')) {
+        throw new errors_1.UserError('Memory layout.summaryFile must be a file name.');
+    }
+    return {
+        memoriesDir,
+        sessionsDir,
+        summaryFile,
+    };
+}
+function normalizeRequiredRelativePath(name, value) {
+    let normalized;
+    try {
+        normalized = (0, manifest_1.normalizeRelativePath)(value);
+    }
+    catch {
+        throw new errors_1.UserError(`${name} must be relative to the sandbox workspace root and must not escape root, got: ${value}`);
+    }
+    if (!normalized) {
+        throw new errors_1.UserError(`${name} must be non-empty.`);
+    }
+    return normalized;
+}
+function ensureDirectoryEntry(manifest, path) {
+    const normalizedPath = (0, manifest_1.normalizeRelativePath)(path);
+    if (!normalizedPath ||
+        manifestHasOverlappingEntry(manifest, normalizedPath)) {
+        return;
+    }
+    manifest.entries[normalizedPath] = (0, entries_1.dir)();
+}
+function manifestHasOverlappingEntry(manifest, path) {
+    const prefix = `${path}/`;
+    for (const entryPath of Object.keys(manifest.entries)) {
+        const normalizedEntryPath = (0, manifest_1.normalizeRelativePath)(entryPath);
+        if (normalizedEntryPath === path ||
+            normalizedEntryPath.startsWith(prefix) ||
+            path.startsWith(`${normalizedEntryPath}/`)) {
+            return true;
+        }
+    }
+    return false;
+}
+async function readMemorySummaryWithShell(args) {
+    const command = [
+        `if [ -f ${(0, shell_1.shellQuote)(args.path)} ]; then`,
+        `printf '%s\n' ${(0, shell_1.shellQuote)(MEMORY_BEGIN_MARKER)};`,
+        `head -c ${MEMORY_SUMMARY_MAX_BYTES} ${(0, shell_1.shellQuote)(args.path)};`,
+        `printf '\n%s\n' ${(0, shell_1.shellQuote)(MEMORY_END_MARKER)};`,
+        'fi',
+    ].join(' ');
+    const output = await (0, spans_1.withSandboxSpan)('sandbox.memory.read_summary', {
+        path: args.path,
+        run_as: args.runAs,
+    }, async () => await args.session.execCommand({
+        cmd: command,
+        login: false,
+        yieldTimeMs: 10_000,
+        maxOutputTokens: 20_000,
+        runAs: args.runAs,
+    }));
+    const begin = output.indexOf(MEMORY_BEGIN_MARKER);
+    const end = output.indexOf(MEMORY_END_MARKER, begin + MEMORY_BEGIN_MARKER.length);
+    if (begin < 0 || end < 0) {
+        return null;
+    }
+    return normalizeMemorySummaryPayload(output.slice(begin + MEMORY_BEGIN_MARKER.length, end));
+}
+function normalizeMemorySummaryPayload(payload) {
+    const text = typeof payload === 'string'
+        ? payload
+        : new TextDecoder('utf-8', { fatal: false }).decode(payload);
+    const normalized = text.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function isMissingFileError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+function rejectKnownSnakeCaseConfigKeys(value, keys, source) {
+    const found = keys.find((key) => key in value);
+    if (!found) {
+        return;
+    }
+    throw new errors_1.UserError(`Use camelCase config keys in ${source}; snake_case key "${found}" is not supported.`);
+}
+//# sourceMappingURL=memory.js.map

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

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

package/dist/sandbox/capabilities/memory.mjs

@@ -0,0 +1,286 @@
+import { UserError } from "../../errors.mjs";
+import { dir } from "../entries/index.mjs";
+import { normalizeRelativePath } from "../manifest.mjs";
+import { withSandboxSpan } from "../runtime/spans.mjs";
+import { shellQuote } from "../shared/shell.mjs";
+import { renderMemoryReadPrompt } from "../memory/prompts.mjs";
+import { joinRelativePaths, SandboxMemoryStorage, } from "../memory/storage.mjs";
+import { Capability, requireBoundSession } from "./base.mjs";
+const MEMORY_SUMMARY_FILE = 'memory_summary.md';
+const MEMORY_SUMMARY_MAX_BYTES = 1_000_000;
+const DEFAULT_PHASE_ONE_MODEL = 'gpt-5.4-mini';
+const DEFAULT_PHASE_TWO_MODEL = 'gpt-5.4';
+const DEFAULT_MEMORY_MODEL_SETTINGS = {
+    reasoning: { effort: 'medium' },
+};
+const MEMORY_BEGIN_MARKER = '__OPENAI_AGENTS_MEMORY_SUMMARY_BEGIN__';
+const MEMORY_END_MARKER = '__OPENAI_AGENTS_MEMORY_SUMMARY_END__';
+class MemoryCapability extends Capability {
+    type = 'memory';
+    read;
+    generate;
+    layout;
+    store;
+    constructor(args = {}) {
+        super();
+        this.read = normalizeReadConfig(args.read);
+        this.generate = normalizeGenerateConfig(args.generate);
+        this.layout = normalizeLayoutConfig(args.layout);
+        this.store = args.store;
+        if (this.read === null && this.generate === null) {
+            throw new UserError('Memory requires at least one of `read` or `generate`.');
+        }
+    }
+    requiredCapabilityTypes() {
+        if (this.read === null) {
+            return new Set();
+        }
+        if (this.read.liveUpdate) {
+            return new Set(['filesystem', 'shell']);
+        }
+        return new Set(['shell']);
+    }
+    processManifest(manifest) {
+        if (this.read?.liveUpdate || this.generate !== null) {
+            ensureDirectoryEntry(manifest, this.layout.memoriesDir);
+        }
+        if (this.generate !== null) {
+            ensureDirectoryEntry(manifest, this.layout.sessionsDir);
+        }
+        return manifest;
+    }
+    async instructions(_manifest) {
+        if (this.read === null) {
+            return null;
+        }
+        const session = requireBoundSession(this.type, this._session);
+        if (this.store) {
+            await new SandboxMemoryStorage({
+                session,
+                runAs: this._runAs,
+                store: this.store,
+            }).hydrateFromStore(this.layout.memoriesDir);
+        }
+        const memorySummary = await this.readMemorySummary(session);
+        if (!memorySummary) {
+            return null;
+        }
+        return renderMemoryReadPrompt({
+            memoryDir: this.layout.memoriesDir,
+            memorySummary,
+            liveUpdate: Boolean(this.read.liveUpdate),
+        });
+    }
+    async readMemorySummary(session) {
+        const path = joinRelativePaths(this.layout.memoriesDir, this.layout.summaryFile);
+        if (session.pathExists && !(await session.pathExists(path, this._runAs))) {
+            return await this.readStoredText(path);
+        }
+        if (session.readFile) {
+            try {
+                const payload = await withSandboxSpan('sandbox.memory.read_summary', {
+                    path,
+                    run_as: this._runAs,
+                }, async () => await session.readFile({
+                    path,
+                    runAs: this._runAs,
+                    maxBytes: MEMORY_SUMMARY_MAX_BYTES,
+                }));
+                return normalizeMemorySummaryPayload(payload);
+            }
+            catch (error) {
+                if (isMissingFileError(error)) {
+                    return await this.readStoredText(path);
+                }
+                throw error;
+            }
+        }
+        const stored = await this.readStoredText(path);
+        if (stored !== null) {
+            return stored;
+        }
+        if (session.execCommand) {
+            return await readMemorySummaryWithShell({
+                session,
+                path,
+                runAs: this._runAs,
+            });
+        }
+        throw new UserError('Memory sandbox sessions must provide readFile() or execCommand().');
+    }
+    async readStoredText(path) {
+        const stored = await this.store?.read(path);
+        return stored ? normalizeMemorySummaryPayload(stored) : null;
+    }
+}
+export function memory(args = {}) {
+    return new MemoryCapability(args);
+}
+export function isMemoryCapability(capability) {
+    return capability.type === 'memory' && capability instanceof MemoryCapability;
+}
+function normalizeReadConfig(config) {
+    if (config === null || config === false) {
+        return null;
+    }
+    if (config === undefined || config === true) {
+        return { enabled: true, liveUpdate: true };
+    }
+    rejectKnownSnakeCaseConfigKeys(config, ['live_update'], 'memory read config');
+    if (config.enabled === false) {
+        return null;
+    }
+    return {
+        enabled: true,
+        liveUpdate: config.liveUpdate ?? true,
+    };
+}
+function normalizeGenerateConfig(config) {
+    if (config === null || config === false) {
+        return null;
+    }
+    if (config === undefined || config === true) {
+        return {
+            enabled: true,
+            maxRawMemoriesForConsolidation: 256,
+            phaseOneModel: DEFAULT_PHASE_ONE_MODEL,
+            phaseOneModelSettings: DEFAULT_MEMORY_MODEL_SETTINGS,
+            phaseTwoModel: DEFAULT_PHASE_TWO_MODEL,
+            phaseTwoModelSettings: DEFAULT_MEMORY_MODEL_SETTINGS,
+        };
+    }
+    rejectKnownSnakeCaseConfigKeys(config, [
+        'max_raw_memories_for_consolidation',
+        'phase_one_model',
+        'phase_one_model_settings',
+        'phase_two_model',
+        'phase_two_model_settings',
+        'extra_prompt',
+    ], 'memory generate config');
+    if (config.enabled === false) {
+        return null;
+    }
+    const maxRawMemoriesForConsolidation = config.maxRawMemoriesForConsolidation ?? 256;
+    if (!Number.isInteger(maxRawMemoriesForConsolidation) ||
+        maxRawMemoriesForConsolidation <= 0 ||
+        maxRawMemoriesForConsolidation > 4096) {
+        throw new UserError('MemoryGenerateConfig.maxRawMemoriesForConsolidation must be an integer between 1 and 4096.');
+    }
+    const sharedModel = normalizeMemoryModel(config.model);
+    const phaseOneModel = config.phaseOneModel ?? sharedModel;
+    const phaseTwoModel = config.phaseTwoModel ?? sharedModel;
+    const extraPrompt = config.extraPrompt ?? config.instructions;
+    const phaseOneModelSettings = config.phaseOneModelSettings ?? DEFAULT_MEMORY_MODEL_SETTINGS;
+    const phaseTwoModelSettings = config.phaseTwoModelSettings ?? DEFAULT_MEMORY_MODEL_SETTINGS;
+    return {
+        enabled: true,
+        maxRawMemoriesForConsolidation,
+        phaseOneModel: phaseOneModel ?? DEFAULT_PHASE_ONE_MODEL,
+        phaseTwoModel: phaseTwoModel ?? DEFAULT_PHASE_TWO_MODEL,
+        phaseOneModelSettings,
+        phaseTwoModelSettings,
+        ...(extraPrompt ? { extraPrompt } : {}),
+    };
+}
+function normalizeMemoryModel(model) {
+    if (typeof model !== 'string') {
+        return model;
+    }
+    const trimmed = model.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizeLayoutConfig(config) {
+    if (config !== undefined) {
+        rejectKnownSnakeCaseConfigKeys(config, ['memories_dir', 'sessions_dir', 'summary_file'], 'memory layout config');
+    }
+    const memoriesDir = normalizeRequiredRelativePath('layout.memoriesDir', config?.memoriesDir ?? config?.directory ?? 'memories');
+    const sessionsDir = normalizeRequiredRelativePath('layout.sessionsDir', config?.sessionsDir ?? 'sessions');
+    const summaryFile = normalizeRequiredRelativePath('layout.summaryFile', config?.summaryFile ?? MEMORY_SUMMARY_FILE);
+    if (summaryFile.includes('/')) {
+        throw new UserError('Memory layout.summaryFile must be a file name.');
+    }
+    return {
+        memoriesDir,
+        sessionsDir,
+        summaryFile,
+    };
+}
+function normalizeRequiredRelativePath(name, value) {
+    let normalized;
+    try {
+        normalized = normalizeRelativePath(value);
+    }
+    catch {
+        throw new UserError(`${name} must be relative to the sandbox workspace root and must not escape root, got: ${value}`);
+    }
+    if (!normalized) {
+        throw new UserError(`${name} must be non-empty.`);
+    }
+    return normalized;
+}
+function ensureDirectoryEntry(manifest, path) {
+    const normalizedPath = normalizeRelativePath(path);
+    if (!normalizedPath ||
+        manifestHasOverlappingEntry(manifest, normalizedPath)) {
+        return;
+    }
+    manifest.entries[normalizedPath] = dir();
+}
+function manifestHasOverlappingEntry(manifest, path) {
+    const prefix = `${path}/`;
+    for (const entryPath of Object.keys(manifest.entries)) {
+        const normalizedEntryPath = normalizeRelativePath(entryPath);
+        if (normalizedEntryPath === path ||
+            normalizedEntryPath.startsWith(prefix) ||
+            path.startsWith(`${normalizedEntryPath}/`)) {
+            return true;
+        }
+    }
+    return false;
+}
+async function readMemorySummaryWithShell(args) {
+    const command = [
+        `if [ -f ${shellQuote(args.path)} ]; then`,
+        `printf '%s\n' ${shellQuote(MEMORY_BEGIN_MARKER)};`,
+        `head -c ${MEMORY_SUMMARY_MAX_BYTES} ${shellQuote(args.path)};`,
+        `printf '\n%s\n' ${shellQuote(MEMORY_END_MARKER)};`,
+        'fi',
+    ].join(' ');
+    const output = await withSandboxSpan('sandbox.memory.read_summary', {
+        path: args.path,
+        run_as: args.runAs,
+    }, async () => await args.session.execCommand({
+        cmd: command,
+        login: false,
+        yieldTimeMs: 10_000,
+        maxOutputTokens: 20_000,
+        runAs: args.runAs,
+    }));
+    const begin = output.indexOf(MEMORY_BEGIN_MARKER);
+    const end = output.indexOf(MEMORY_END_MARKER, begin + MEMORY_BEGIN_MARKER.length);
+    if (begin < 0 || end < 0) {
+        return null;
+    }
+    return normalizeMemorySummaryPayload(output.slice(begin + MEMORY_BEGIN_MARKER.length, end));
+}
+function normalizeMemorySummaryPayload(payload) {
+    const text = typeof payload === 'string'
+        ? payload
+        : new TextDecoder('utf-8', { fatal: false }).decode(payload);
+    const normalized = text.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function isMissingFileError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+function rejectKnownSnakeCaseConfigKeys(value, keys, source) {
+    const found = keys.find((key) => key in value);
+    if (!found) {
+        return;
+    }
+    throw new UserError(`Use camelCase config keys in ${source}; snake_case key "${found}" is not supported.`);
+}
+//# sourceMappingURL=memory.mjs.map

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

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

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

@@ -0,0 +1,15 @@
+import { type Tool } from '../../tool';
+import { Capability, type ConfigureCapabilityTools } from './base';
+export type ShellArgs = {
+    configureTools?: ConfigureCapabilityTools;
+};
+declare class ShellCapability extends Capability {
+    readonly type = "shell";
+    private readonly configureTools?;
+    constructor(args?: ShellArgs);
+    tools(): Tool<any>[];
+    instructions(): string;
+}
+export type Shell = ShellCapability;
+export declare function shell(args?: ShellArgs): Shell;
+export {};