@openai/agents-core 0.8.5 → 0.9.1

package/dist/memory/historyMutations.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySessionHistoryMutations = applySessionHistoryMutations;
+/**
+ * Applies persisted-history mutations and returns a new canonical item list.
+ */
+function applySessionHistoryMutations(items, mutations) {
+    let nextItems = items.map((item) => structuredClone(item));
+    for (const mutation of mutations) {
+        if (mutation.type === 'replace_function_call') {
+            nextItems = applyReplaceFunctionCallMutation(nextItems, mutation);
+        }
+    }
+    return nextItems;
+}
+function applyReplaceFunctionCallMutation(items, mutation) {
+    const replacement = structuredClone(mutation.replacement);
+    const nextItems = [];
+    let keptReplacement = false;
+    for (const item of items) {
+        if (item.type === 'function_call' && item.callId === mutation.callId) {
+            if (!keptReplacement) {
+                nextItems.push(replacement);
+                keptReplacement = true;
+            }
+            continue;
+        }
+        nextItems.push(item);
+    }
+    return nextItems;
+}
+//# sourceMappingURL=historyMutations.js.map

package/dist/memory/historyMutations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyMutations.js","sourceRoot":"","sources":["../../src/memory/historyMutations.ts"],"names":[],"mappings":";;AAMA,oEAaC;AAhBD;;GAEG;AACH,SAAgB,4BAA4B,CAC1C,KAAuB,EACvB,SAAmC;IAEnC,IAAI,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAC9C,SAAS,GAAG,gCAAgC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gCAAgC,CACvC,KAAuB,EACvB,QAA4E;IAE5E,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC5B,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC;YACD,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/memory/historyMutations.mjs

@@ -0,0 +1,29 @@
+/**
+ * Applies persisted-history mutations and returns a new canonical item list.
+ */
+export function applySessionHistoryMutations(items, mutations) {
+    let nextItems = items.map((item) => structuredClone(item));
+    for (const mutation of mutations) {
+        if (mutation.type === 'replace_function_call') {
+            nextItems = applyReplaceFunctionCallMutation(nextItems, mutation);
+        }
+    }
+    return nextItems;
+}
+function applyReplaceFunctionCallMutation(items, mutation) {
+    const replacement = structuredClone(mutation.replacement);
+    const nextItems = [];
+    let keptReplacement = false;
+    for (const item of items) {
+        if (item.type === 'function_call' && item.callId === mutation.callId) {
+            if (!keptReplacement) {
+                nextItems.push(replacement);
+                keptReplacement = true;
+            }
+            continue;
+        }
+        nextItems.push(item);
+    }
+    return nextItems;
+}
+//# sourceMappingURL=historyMutations.mjs.map

package/dist/memory/historyMutations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyMutations.mjs","sourceRoot":"","sources":["../../src/memory/historyMutations.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAuB,EACvB,SAAmC;IAEnC,IAAI,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAC9C,SAAS,GAAG,gCAAgC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gCAAgC,CACvC,KAAuB,EACvB,QAA4E;IAE5E,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC5B,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC;YACD,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/memory/memorySession.d.ts

@@ -1,5 +1,5 @@
 import type { AgentInputItem } from '../types';
-import type { Session } from './session';
+import type { SessionHistoryRewriteArgs, SessionHistoryRewriteAwareSession } from './session';
 import { Logger } from '../logger';
 export type MemorySessionOptions = {
     sessionId?: string;
@@ -9,7 +9,7 @@ export type MemorySessionOptions = {
 /**
  * Simple in-memory session store intended for demos or tests. Not recommended for production use.
  */
-export declare class MemorySession implements Session {
+export declare class MemorySession implements SessionHistoryRewriteAwareSession {
     private readonly sessionId;
     private readonly logger;
     private items;
@@ -19,4 +19,5 @@ export declare class MemorySession implements Session {
     addItems(items: AgentInputItem[]): Promise<void>;
     popItem(): Promise<AgentInputItem | undefined>;
     clearSession(): Promise<void>;
+    applyHistoryMutations(args: SessionHistoryRewriteArgs): Promise<void>;
 }

package/dist/memory/memorySession.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemorySession = void 0;
 const _shims_1 = require("@openai/agents-core/_shims");
+const historyMutations_1 = require("./historyMutations.js");
 const logger_1 = require("../logger.js");
 /**
  * Simple in-memory session store intended for demos or tests. Not recommended for production use.
@@ -56,6 +57,12 @@ class MemorySession {
         this.logger.debug(`Clearing memory session (${this.sessionId})`);
         this.items = [];
     }
+    async applyHistoryMutations(args) {
+        if (args.mutations.length === 0) {
+            return;
+        }
+        this.items = (0, historyMutations_1.applySessionHistoryMutations)(this.items, args.mutations);
+    }
 }
 exports.MemorySession = MemorySession;
 function cloneAgentItem(item) {

package/dist/memory/memorySession.js.map

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

package/dist/memory/memorySession.mjs

@@ -1,4 +1,5 @@
 import { randomUUID } from '@openai/agents-core/_shims';
+import { applySessionHistoryMutations } from "./historyMutations.mjs";
 import { logger } from "../logger.mjs";
 /**
  * Simple in-memory session store intended for demos or tests. Not recommended for production use.
@@ -53,6 +54,12 @@ export class MemorySession {
         this.logger.debug(`Clearing memory session (${this.sessionId})`);
         this.items = [];
     }
+    async applyHistoryMutations(args) {
+        if (args.mutations.length === 0) {
+            return;
+        }
+        this.items = applySessionHistoryMutations(this.items, args.mutations);
+    }
 }
 function cloneAgentItem(item) {
     return structuredClone(item);

package/dist/memory/memorySession.mjs.map

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

package/dist/memory/session.d.ts

@@ -4,6 +4,17 @@ import type { RequestUsage } from '../usage';
  * A function that combines session history with new input items before the model call.
  */
 export type SessionInputCallback = (historyItems: AgentInputItem[], newItems: AgentInputItem[]) => AgentInputItem[] | Promise<AgentInputItem[]>;
+export type SessionHistoryReplaceFunctionCallMutation = {
+    type: 'replace_function_call';
+    callId: string;
+    replacement: Extract<AgentInputItem, {
+        type: 'function_call';
+    }>;
+};
+export type SessionHistoryMutation = SessionHistoryReplaceFunctionCallMutation;
+export type SessionHistoryRewriteArgs = {
+    mutations: SessionHistoryMutation[];
+};
 /**
  * Interface representing a persistent session store for conversation history.
  */
@@ -19,6 +30,13 @@ export interface Session {
      * recent {@link limit} items should be returned in chronological order.
      */
     getItems(limit?: number): Promise<AgentInputItem[]>;
+    /**
+     * Optionally rewrite a stored history item before it is sent back to the model.
+     *
+     * Session implementations can use this to strip provider-managed replay metadata while
+     * preserving their public `getItems()` shape for UI and deletion workflows.
+     */
+    prepareHistoryItemForModelInput?(item: AgentInputItem): AgentInputItem;
     /**
      * Append new items to the conversation history.
      *
@@ -35,6 +53,9 @@ export interface Session {
      */
     clearSession(): Promise<void>;
 }
+export interface SessionHistoryRewriteAwareSession extends Session {
+    applyHistoryMutations(args: SessionHistoryRewriteArgs): Promise<void> | void;
+}
 /**
  * Session subtype that can run compaction logic after a completed turn is persisted.
  */
@@ -78,3 +99,4 @@ export interface OpenAIResponsesCompactionAwareSession extends Session {
     runCompaction(args?: OpenAIResponsesCompactionArgs): Promise<OpenAIResponsesCompactionResult | null> | OpenAIResponsesCompactionResult | null;
 }
 export declare function isOpenAIResponsesCompactionAwareSession(session: Session | undefined): session is OpenAIResponsesCompactionAwareSession;
+export declare function isSessionHistoryRewriteAwareSession(session: Session | undefined): session is SessionHistoryRewriteAwareSession;

package/dist/memory/session.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isOpenAIResponsesCompactionAwareSession = isOpenAIResponsesCompactionAwareSession;
+exports.isSessionHistoryRewriteAwareSession = isSessionHistoryRewriteAwareSession;
 function isOpenAIResponsesCompactionAwareSession(session) {
     return (!!session &&
         typeof session.runCompaction ===
             'function');
 }
+function isSessionHistoryRewriteAwareSession(session) {
+    return (!!session &&
+        typeof session
+            .applyHistoryMutations === 'function');
+}
 //# sourceMappingURL=session.js.map

package/dist/memory/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/memory/session.ts"],"names":[],"mappings":";;AAiGA,0FAQC;AARD,SAAgB,uCAAuC,CACrD,OAA4B;IAE5B,OAAO,CACL,CAAC,CAAC,OAAO;QACT,OAAQ,OAAiD,CAAC,aAAa;YACrE,UAAU,CACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/memory/session.ts"],"names":[],"mappings":";;AAyHA,0FAQC;AAED,kFAQC;AAlBD,SAAgB,uCAAuC,CACrD,OAA4B;IAE5B,OAAO,CACL,CAAC,CAAC,OAAO;QACT,OAAQ,OAAiD,CAAC,aAAa;YACrE,UAAU,CACb,CAAC;AACJ,CAAC;AAED,SAAgB,mCAAmC,CACjD,OAA4B;IAE5B,OAAO,CACL,CAAC,CAAC,OAAO;QACT,OAAQ,OAA6C;aAClD,qBAAqB,KAAK,UAAU,CACxC,CAAC;AACJ,CAAC"}

package/dist/memory/session.mjs

@@ -3,4 +3,9 @@ export function isOpenAIResponsesCompactionAwareSession(session) {
         typeof session.runCompaction ===
             'function');
 }
+export function isSessionHistoryRewriteAwareSession(session) {
+    return (!!session &&
+        typeof session
+            .applyHistoryMutations === 'function');
+}
 //# sourceMappingURL=session.mjs.map

package/dist/memory/session.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"session.mjs","sourceRoot":"","sources":["../../src/memory/session.ts"],"names":[],"mappings":"AAiGA,MAAM,UAAU,uCAAuC,CACrD,OAA4B;IAE5B,OAAO,CACL,CAAC,CAAC,OAAO;QACT,OAAQ,OAAiD,CAAC,aAAa;YACrE,UAAU,CACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"session.mjs","sourceRoot":"","sources":["../../src/memory/session.ts"],"names":[],"mappings":"AAyHA,MAAM,UAAU,uCAAuC,CACrD,OAA4B;IAE5B,OAAO,CACL,CAAC,CAAC,OAAO;QACT,OAAQ,OAAiD,CAAC,aAAa;YACrE,UAAU,CACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,OAA4B;IAE5B,OAAO,CACL,CAAC,CAAC,OAAO;QACT,OAAQ,OAA6C;aAClD,qBAAqB,KAAK,UAAU,CACxC,CAAC;AACJ,CAAC"}

package/dist/metadata.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.METADATA = void 0;
 exports.METADATA = {
     "name": "@openai/agents-core",
-    "version": "0.8.5",
+    "version": "0.9.1",
     "versions": {
-        "@openai/agents-core": "0.8.5",
+        "@openai/agents-core": "0.9.1",
         "openai": "^6.26.0"
     }
 };

package/dist/metadata.mjs

@@ -1,9 +1,9 @@
 // This file is automatically generated
 export const METADATA = {
     "name": "@openai/agents-core",
-    "version": "0.8.5",
+    "version": "0.9.1",
     "versions": {
-        "@openai/agents-core": "0.8.5",
+        "@openai/agents-core": "0.9.1",
         "openai": "^6.26.0"
     }
 };

package/dist/model.d.ts

@@ -36,6 +36,21 @@ export interface ModelSettingsText {
      */
     verbosity?: 'low' | 'medium' | 'high' | null;
 }
+export type ModelSettingsContextManagement = Array<{
+    /**
+     * The context-management strategy to apply.
+     */
+    type: 'compaction' | (string & {});
+    /**
+     * Rendered-token threshold that triggers server-side compaction.
+     */
+    compactThreshold?: number;
+    /**
+     * Rendered-token threshold that triggers server-side compaction.
+     */
+    compact_threshold?: number;
+    [key: string]: unknown;
+}>;
 export type RetryDecision = boolean | {
     /**
      * Whether the failed request should be retried.
@@ -209,6 +224,12 @@ export type ModelSettings = {
      * See https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention for the available options.
      */
     promptCacheRetention?: 'in-memory' | '24h' | null;
+    /**
+     * Context-management strategies to apply when calling the model.
+     * This setting is available on OpenAI Responses requests, including server-side compaction.
+     * See https://developers.openai.com/api/docs/guides/compaction.
+     */
+    contextManagement?: ModelSettingsContextManagement;
     /**
      * The reasoning settings to use when calling the model.
      */

package/dist/run.d.ts

@@ -8,6 +8,7 @@ import { RunResult, StreamedRunResult } from './result';
 import { RunState } from './runState';
 import type { TracingConfig } from './tracing';
 import type { Session, SessionInputCallback } from './memory/session';
+import type { SandboxRunConfig } from './sandbox/client';
 import type { AgentInputItem } from './types';
 import type { ReasoningItemIdPolicy } from './runner/items';
 import type { CallModelInputFilter } from './runner/types';
@@ -109,6 +110,10 @@ export type RunConfig = {
      * Tracing configuration for this run. Use this to override the API key used when exporting traces.
      */
     tracing?: TracingConfig;
+    /**
+     * Sandbox runtime configuration used when execution reaches a sandbox agent.
+     */
+    sandbox?: SandboxRunConfig;
     /**
      * Customizes how session history is combined with the current turn's input.
      * When omitted, history items are appended before the new input.
@@ -144,8 +149,9 @@ type SharedRunOptions<TContext = undefined, TAgent extends Agent<any, any> = Age
     toolErrorFormatter?: ToolErrorFormatter;
     reasoningItemIdPolicy?: ReasoningItemIdPolicy;
     tracing?: TracingConfig;
+    sandbox?: SandboxRunConfig;
     /**
-     * Error handlers keyed by error kind. Currently only maxTurns errors are supported.
+     * Error handlers keyed by error kind.
      */
     errorHandlers?: RunErrorHandlers<TContext, TAgent>;
 };