@openai/agents-core 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export { OPENAI_DEFAULT_MODEL_ENV_VARIABLE_NAME, gpt5ReasoningSettingsRequired,
 export { setDefaultModelProvider } from './providers';
 export { RunResult, StreamedRunResult } from './result';
 export { IndividualRunOptions, NonStreamRunOptions, run, RunConfig, Runner, StreamRunOptions, } from './run';
+export type { ModelInputData, CallModelInputFilter, CallModelInputFilterArgs, } from './run';
 export { RunContext } from './runContext';
 export { RunState } from './runState';
 export { HostedTool, ComputerTool, computerTool, HostedMCPTool, hostedMcpTool, FunctionTool, FunctionToolResult, Tool, tool, ToolExecuteArgument, ToolEnabledFunction, } from './tool';
@@ -24,6 +25,8 @@ export * from './tracing';
 export { getGlobalTraceProvider, TraceProvider } from './tracing/provider';
 export type { AgentInputItem, AgentOutputItem, AssistantMessageItem, HostedToolCallItem, ComputerCallResultItem, ComputerUseCallItem, FunctionCallItem, FunctionCallResultItem, JsonSchemaDefinition, ReasoningItem, ResponseStreamEvent, SystemMessageItem, TextOutput, UnknownContext, UnknownItem, UserMessageItem, StreamEvent, StreamEventTextStream, StreamEventResponseCompleted, StreamEventResponseStarted, StreamEventGenericItem, } from './types';
 export { Usage } from './usage';
+export type { Session, SessionInputCallback } from './memory/session';
+export { MemorySession } from './memory/memorySession';
 /**
  * Exporting the whole protocol as an object here. This contains both the types
  * and the zod schemas for parsing the protocol.

package/dist/index.js

@@ -37,7 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RunContext = exports.Runner = exports.run = exports.StreamedRunResult = exports.RunResult = exports.setDefaultModelProvider = exports.isGpt5Default = exports.getDefaultModelSettings = exports.getDefaultModel = exports.gpt5ReasoningSettingsRequired = exports.OPENAI_DEFAULT_MODEL_ENV_VARIABLE_NAME = exports.createMCPToolStaticFilter = exports.MCPServerSSE = exports.MCPServerStreamableHttp = exports.MCPServerStdio = exports.mcpToFunctionTool = exports.invalidateServerToolsCache = exports.getAllMcpTools = exports.getLogger = exports.AgentHooks = exports.RunToolCallOutputItem = exports.RunToolCallItem = exports.RunToolApprovalItem = exports.RunReasoningItem = exports.RunMessageOutputItem = exports.RunHandoffOutputItem = exports.RunHandoffCallItem = exports.extractAllTextOutput = exports.user = exports.system = exports.assistant = exports.handoff = exports.Handoff = exports.getTransferMessage = exports.getHandoff = exports.defineOutputGuardrail = exports.RunItemStreamEvent = exports.RunRawModelStreamEvent = exports.RunAgentUpdatedStreamEvent = exports.SystemError = exports.UserError = exports.ToolCallError = exports.OutputGuardrailTripwireTriggered = exports.ModelBehaviorError = exports.MaxTurnsExceededError = exports.InputGuardrailTripwireTriggered = exports.GuardrailExecutionError = exports.AgentsError = exports.Agent = exports.RuntimeEventEmitter = void 0;
-exports.protocol = exports.Usage = exports.TraceProvider = exports.getGlobalTraceProvider = exports.tool = exports.hostedMcpTool = exports.computerTool = exports.RunState = void 0;
+exports.protocol = exports.MemorySession = exports.Usage = exports.TraceProvider = exports.getGlobalTraceProvider = exports.tool = exports.hostedMcpTool = exports.computerTool = exports.RunState = void 0;
 const tracing_1 = require("./tracing/index.js");
 const processor_1 = require("./tracing/processor.js");
 var _shims_1 = require("@openai/agents-core/_shims");
@@ -119,6 +119,8 @@ Object.defineProperty(exports, "getGlobalTraceProvider", { enumerable: true, get
 Object.defineProperty(exports, "TraceProvider", { enumerable: true, get: function () { return provider_1.TraceProvider; } });
 var usage_1 = require("./usage.js");
 Object.defineProperty(exports, "Usage", { enumerable: true, get: function () { return usage_1.Usage; } });
+var memorySession_1 = require("./memory/memorySession.js");
+Object.defineProperty(exports, "MemorySession", { enumerable: true, get: function () { return memorySession_1.MemorySession; } });
 /**
  * Exporting the whole protocol as an object here. This contains both the types
  * and the zod schemas for parsing the protocol.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAA8C;AAC9C,sDAAuD;AAEvD,qDAAiE;AAAxD,6GAAA,mBAAmB,OAAA;AAC5B,oCAUiB;AATf,8FAAA,KAAK,OAAA;AAWP,sCAUkB;AAThB,qGAAA,WAAW,OAAA;AACX,iHAAA,uBAAuB,OAAA;AACvB,yHAAA,+BAA+B,OAAA;AAC/B,+GAAA,qBAAqB,OAAA;AACrB,4GAAA,kBAAkB,OAAA;AAClB,0HAAA,gCAAgC,OAAA;AAChC,uGAAA,aAAa,OAAA;AACb,mGAAA,SAAS,OAAA;AACT,qGAAA,WAAW,OAAA;AAEb,sCAKkB;AAJhB,oHAAA,0BAA0B,OAAA;AAC1B,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAGpB,4CAcqB;AAbnB,kHAAA,qBAAqB,OAAA;AAcvB,wCAOmB;AANjB,qGAAA,UAAU,OAAA;AACV,6GAAA,kBAAkB,OAAA;AAClB,kGAAA,OAAO,OAAA;AACP,kGAAA,OAAO,OAAA;AAIT,gDAA4D;AAAnD,oGAAA,SAAS,OAAA;AAAE,iGAAA,MAAM,OAAA;AAAE,+FAAA,IAAI,OAAA;AAChC,oCAUiB;AATf,6GAAA,oBAAoB,OAAA;AACpB,2GAAA,kBAAkB,OAAA;AAClB,6GAAA,oBAAoB,OAAA;AAEpB,6GAAA,oBAAoB,OAAA;AACpB,yGAAA,gBAAgB,OAAA;AAChB,4GAAA,mBAAmB,OAAA;AACnB,wGAAA,eAAe,OAAA;AACf,8GAAA,qBAAqB,OAAA;AAEvB,4CAAyC;AAAhC,uGAAA,UAAU,OAAA;AACnB,sCAAqC;AAA5B,mGAAA,SAAS,OAAA;AAClB,gCASe;AARb,qGAAA,cAAc,OAAA;AACd,iHAAA,0BAA0B,OAAA;AAC1B,wGAAA,iBAAiB,OAAA;AAEjB,qGAAA,cAAc,OAAA;AACd,8GAAA,uBAAuB,OAAA;AACvB,mGAAA,YAAY,OAAA;AAGd,wCAKmB;AADjB,oHAAA,yBAAyB,OAAA;AAa3B,kDAMwB;AALtB,sIAAA,sCAAsC,OAAA;AACtC,6HAAA,6BAA6B,OAAA;AAC7B,+GAAA,eAAe,OAAA;AACf,uHAAA,uBAAuB,OAAA;AACvB,6GAAA,aAAa,OAAA;AAEf,4CAAsD;AAA7C,oHAAA,uBAAuB,OAAA;AAChC,sCAAwD;AAA/C,mGAAA,SAAS,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AACrC,gCAOe;AAJb,0FAAA,GAAG,OAAA;AAEH,6FAAA,MAAM,OAAA;AAGR,8CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,0CAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,kCAYgB;AATd,oGAAA,YAAY,OAAA;AAEZ,qGAAA,aAAa,OAAA;AAIb,4FAAA,IAAI,OAAA;AAWN,qDAA0B;AAC1B,kDAA2E;AAAlE,kHAAA,sBAAsB,OAAA;AAAE,yGAAA,aAAa,OAAA;AAyB9C,oCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd;;;GAGG;AACH,gEAA6C;AAE7C;;;;;GAKG;AACH,IAAA,2BAAiB,EAAC,IAAA,4BAAgB,GAAE,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAA8C;AAC9C,sDAAuD;AAEvD,qDAAiE;AAAxD,6GAAA,mBAAmB,OAAA;AAC5B,oCAUiB;AATf,8FAAA,KAAK,OAAA;AAWP,sCAUkB;AAThB,qGAAA,WAAW,OAAA;AACX,iHAAA,uBAAuB,OAAA;AACvB,yHAAA,+BAA+B,OAAA;AAC/B,+GAAA,qBAAqB,OAAA;AACrB,4GAAA,kBAAkB,OAAA;AAClB,0HAAA,gCAAgC,OAAA;AAChC,uGAAA,aAAa,OAAA;AACb,mGAAA,SAAS,OAAA;AACT,qGAAA,WAAW,OAAA;AAEb,sCAKkB;AAJhB,oHAAA,0BAA0B,OAAA;AAC1B,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAGpB,4CAcqB;AAbnB,kHAAA,qBAAqB,OAAA;AAcvB,wCAOmB;AANjB,qGAAA,UAAU,OAAA;AACV,6GAAA,kBAAkB,OAAA;AAClB,kGAAA,OAAO,OAAA;AACP,kGAAA,OAAO,OAAA;AAIT,gDAA4D;AAAnD,oGAAA,SAAS,OAAA;AAAE,iGAAA,MAAM,OAAA;AAAE,+FAAA,IAAI,OAAA;AAChC,oCAUiB;AATf,6GAAA,oBAAoB,OAAA;AACpB,2GAAA,kBAAkB,OAAA;AAClB,6GAAA,oBAAoB,OAAA;AAEpB,6GAAA,oBAAoB,OAAA;AACpB,yGAAA,gBAAgB,OAAA;AAChB,4GAAA,mBAAmB,OAAA;AACnB,wGAAA,eAAe,OAAA;AACf,8GAAA,qBAAqB,OAAA;AAEvB,4CAAyC;AAAhC,uGAAA,UAAU,OAAA;AACnB,sCAAqC;AAA5B,mGAAA,SAAS,OAAA;AAClB,gCASe;AARb,qGAAA,cAAc,OAAA;AACd,iHAAA,0BAA0B,OAAA;AAC1B,wGAAA,iBAAiB,OAAA;AAEjB,qGAAA,cAAc,OAAA;AACd,8GAAA,uBAAuB,OAAA;AACvB,mGAAA,YAAY,OAAA;AAGd,wCAKmB;AADjB,oHAAA,yBAAyB,OAAA;AAa3B,kDAMwB;AALtB,sIAAA,sCAAsC,OAAA;AACtC,6HAAA,6BAA6B,OAAA;AAC7B,+GAAA,eAAe,OAAA;AACf,uHAAA,uBAAuB,OAAA;AACvB,6GAAA,aAAa,OAAA;AAEf,4CAAsD;AAA7C,oHAAA,uBAAuB,OAAA;AAChC,sCAAwD;AAA/C,mGAAA,SAAS,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AACrC,gCAOe;AAJb,0FAAA,GAAG,OAAA;AAEH,6FAAA,MAAM,OAAA;AAQR,8CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,0CAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,kCAYgB;AATd,oGAAA,YAAY,OAAA;AAEZ,qGAAA,aAAa,OAAA;AAIb,4FAAA,IAAI,OAAA;AAWN,qDAA0B;AAC1B,kDAA2E;AAAlE,kHAAA,sBAAsB,OAAA;AAAE,yGAAA,aAAa,OAAA;AAyB9C,oCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd,2DAAuD;AAA9C,8GAAA,aAAa,OAAA;AAEtB;;;GAGG;AACH,gEAA6C;AAE7C;;;;;GAKG;AACH,IAAA,2BAAiB,EAAC,IAAA,4BAAgB,GAAE,CAAC,CAAC"}

package/dist/index.mjs

@@ -22,6 +22,7 @@ export { computerTool, hostedMcpTool, tool, } from "./tool.mjs";
 export * from "./tracing/index.mjs";
 export { getGlobalTraceProvider, TraceProvider } from "./tracing/provider.mjs";
 export { Usage } from "./usage.mjs";
+export { MemorySession } from "./memory/memorySession.mjs";
 export * as protocol from "./types/protocol.mjs";
 /**
  * Add the default processor, which exports traces and spans to the backend in batches. You can

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"OAAO,EAAE,iBAAiB,EAAE;OACrB,EAAE,gBAAgB,EAAE;OAEpB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B;OACzD,EACL,KAAK,GASN;OAEM,EACL,WAAW,EACX,uBAAuB,EACvB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,gCAAgC,EAChC,aAAa,EACb,SAAS,EACT,WAAW,GACZ;OACM,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,GAEnB;OACM,EACL,qBAAqB,GAatB;OACM,EACL,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,OAAO,GAGR;OACM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;OAC3B,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EAEpB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB;OACM,EAAE,UAAU,EAAE;OACd,EAAE,SAAS,EAAE;OACb,EACL,cAAc,EACd,0BAA0B,EAC1B,iBAAiB,EAEjB,cAAc,EACd,uBAAuB,EACvB,YAAY,GAEb;OACM,EAIL,yBAAyB,GAC1B;OAYM,EACL,sCAAsC,EACtC,6BAA6B,EAC7B,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd;OACM,EAAE,uBAAuB,EAAE;OAC3B,EAAE,SAAS,EAAE,iBAAiB,EAAE;OAChC,EAGL,GAAG,EAEH,MAAM,GAEP;OACM,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAE;OACZ,EAGL,YAAY,EAEZ,aAAa,EAIb,IAAI,GAGL;;OASM,EAAE,sBAAsB,EAAE,aAAa,EAAE;OAyBzC,EAAE,KAAK,EAAE;OAMT,KAAK,QAAQ;AAEpB;;;;;GAKG;AACH,iBAAiB,CAAC,gBAAgB,EAAE,CAAC,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"OAAO,EAAE,iBAAiB,EAAE;OACrB,EAAE,gBAAgB,EAAE;OAEpB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B;OACzD,EACL,KAAK,GASN;OAEM,EACL,WAAW,EACX,uBAAuB,EACvB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,gCAAgC,EAChC,aAAa,EACb,SAAS,EACT,WAAW,GACZ;OACM,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,GAEnB;OACM,EACL,qBAAqB,GAatB;OACM,EACL,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,OAAO,GAGR;OACM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;OAC3B,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EAEpB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB;OACM,EAAE,UAAU,EAAE;OACd,EAAE,SAAS,EAAE;OACb,EACL,cAAc,EACd,0BAA0B,EAC1B,iBAAiB,EAEjB,cAAc,EACd,uBAAuB,EACvB,YAAY,GAEb;OACM,EAIL,yBAAyB,GAC1B;OAYM,EACL,sCAAsC,EACtC,6BAA6B,EAC7B,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd;OACM,EAAE,uBAAuB,EAAE;OAC3B,EAAE,SAAS,EAAE,iBAAiB,EAAE;OAChC,EAGL,GAAG,EAEH,MAAM,GAEP;OAMM,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAE;OACZ,EAGL,YAAY,EAEZ,aAAa,EAIb,IAAI,GAGL;;OASM,EAAE,sBAAsB,EAAE,aAAa,EAAE;OAyBzC,EAAE,KAAK,EAAE;OAET,EAAE,aAAa,EAAE;OAMjB,KAAK,QAAQ;AAEpB;;;;;GAKG;AACH,iBAAiB,CAAC,gBAAgB,EAAE,CAAC,CAAC"}

package/dist/memory/memorySession.d.ts

@@ -0,0 +1,22 @@
+import type { AgentInputItem } from '../types';
+import type { Session } from './session';
+import { Logger } from '../logger';
+export type MemorySessionOptions = {
+    sessionId?: string;
+    initialItems?: AgentInputItem[];
+    logger?: Logger;
+};
+/**
+ * Simple in-memory session store intended for demos or tests. Not recommended for production use.
+ */
+export declare class MemorySession implements Session {
+    private readonly sessionId;
+    private readonly logger;
+    private items;
+    constructor(options?: MemorySessionOptions);
+    getSessionId(): Promise<string>;
+    getItems(limit?: number): Promise<AgentInputItem[]>;
+    addItems(items: AgentInputItem[]): Promise<void>;
+    popItem(): Promise<AgentInputItem | undefined>;
+    clearSession(): Promise<void>;
+}

package/dist/memory/memorySession.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemorySession = void 0;
+const _shims_1 = require("@openai/agents-core/_shims");
+const logger_1 = require("../logger.js");
+/**
+ * Simple in-memory session store intended for demos or tests. Not recommended for production use.
+ */
+class MemorySession {
+    sessionId;
+    logger;
+    items;
+    constructor(options = {}) {
+        this.sessionId = options.sessionId ?? (0, _shims_1.randomUUID)();
+        this.items = options.initialItems
+            ? options.initialItems.map(cloneAgentItem)
+            : [];
+        this.logger = options.logger ?? logger_1.logger;
+    }
+    async getSessionId() {
+        return this.sessionId;
+    }
+    async getItems(limit) {
+        if (limit === undefined) {
+            const cloned = this.items.map(cloneAgentItem);
+            this.logger.debug(`Getting items from memory session (${this.sessionId}): ${JSON.stringify(cloned)}`);
+            return cloned;
+        }
+        if (limit <= 0) {
+            return [];
+        }
+        const start = Math.max(this.items.length - limit, 0);
+        const items = this.items.slice(start).map(cloneAgentItem);
+        this.logger.debug(`Getting items from memory session (${this.sessionId}): ${JSON.stringify(items)}`);
+        return items;
+    }
+    async addItems(items) {
+        if (items.length === 0) {
+            return;
+        }
+        const cloned = items.map(cloneAgentItem);
+        this.logger.debug(`Adding items to memory session (${this.sessionId}): ${JSON.stringify(cloned)}`);
+        this.items = [...this.items, ...cloned];
+    }
+    async popItem() {
+        if (this.items.length === 0) {
+            return undefined;
+        }
+        const item = this.items[this.items.length - 1];
+        const cloned = cloneAgentItem(item);
+        this.logger.debug(`Popping item from memory session (${this.sessionId}): ${JSON.stringify(cloned)}`);
+        this.items = this.items.slice(0, -1);
+        return cloned;
+    }
+    async clearSession() {
+        this.logger.debug(`Clearing memory session (${this.sessionId})`);
+        this.items = [];
+    }
+}
+exports.MemorySession = MemorySession;
+function cloneAgentItem(item) {
+    return structuredClone(item);
+}
+//# sourceMappingURL=memorySession.js.map

package/dist/memory/memorySession.js.map

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

package/dist/memory/memorySession.mjs

@@ -0,0 +1,60 @@
+import { randomUUID } from '@openai/agents-core/_shims';
+import { logger } from "../logger.mjs";
+/**
+ * Simple in-memory session store intended for demos or tests. Not recommended for production use.
+ */
+export class MemorySession {
+    sessionId;
+    logger;
+    items;
+    constructor(options = {}) {
+        this.sessionId = options.sessionId ?? randomUUID();
+        this.items = options.initialItems
+            ? options.initialItems.map(cloneAgentItem)
+            : [];
+        this.logger = options.logger ?? logger;
+    }
+    async getSessionId() {
+        return this.sessionId;
+    }
+    async getItems(limit) {
+        if (limit === undefined) {
+            const cloned = this.items.map(cloneAgentItem);
+            this.logger.debug(`Getting items from memory session (${this.sessionId}): ${JSON.stringify(cloned)}`);
+            return cloned;
+        }
+        if (limit <= 0) {
+            return [];
+        }
+        const start = Math.max(this.items.length - limit, 0);
+        const items = this.items.slice(start).map(cloneAgentItem);
+        this.logger.debug(`Getting items from memory session (${this.sessionId}): ${JSON.stringify(items)}`);
+        return items;
+    }
+    async addItems(items) {
+        if (items.length === 0) {
+            return;
+        }
+        const cloned = items.map(cloneAgentItem);
+        this.logger.debug(`Adding items to memory session (${this.sessionId}): ${JSON.stringify(cloned)}`);
+        this.items = [...this.items, ...cloned];
+    }
+    async popItem() {
+        if (this.items.length === 0) {
+            return undefined;
+        }
+        const item = this.items[this.items.length - 1];
+        const cloned = cloneAgentItem(item);
+        this.logger.debug(`Popping item from memory session (${this.sessionId}): ${JSON.stringify(cloned)}`);
+        this.items = this.items.slice(0, -1);
+        return cloned;
+    }
+    async clearSession() {
+        this.logger.debug(`Clearing memory session (${this.sessionId})`);
+        this.items = [];
+    }
+}
+function cloneAgentItem(item) {
+    return structuredClone(item);
+}
+//# sourceMappingURL=memorySession.mjs.map

package/dist/memory/memorySession.mjs.map

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

package/dist/memory/session.d.ts

@@ -0,0 +1,36 @@
+import type { AgentInputItem } from '../types';
+/**
+ * A function that combines session history with new input items before the model call.
+ */
+export type SessionInputCallback = (historyItems: AgentInputItem[], newItems: AgentInputItem[]) => AgentInputItem[] | Promise<AgentInputItem[]>;
+/**
+ * Interface representing a persistent session store for conversation history.
+ */
+export interface Session {
+    /**
+     * Ensure and return the identifier for this session.
+     */
+    getSessionId(): Promise<string>;
+    /**
+     * Retrieve items from the conversation history.
+     *
+     * @param limit - The maximum number of items to return. When provided the most
+     * recent {@link limit} items should be returned in chronological order.
+     */
+    getItems(limit?: number): Promise<AgentInputItem[]>;
+    /**
+     * Append new items to the conversation history.
+     *
+     * @param items - Items to add to the session history.
+     */
+    addItems(items: AgentInputItem[]): Promise<void>;
+    /**
+     * Remove and return the most recent item from the conversation history if it
+     * exists.
+     */
+    popItem(): Promise<AgentInputItem | undefined>;
+    /**
+     * Remove all items that belong to the session and reset its state.
+     */
+    clearSession(): Promise<void>;
+}

package/dist/memory/session.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=session.js.map

package/dist/memory/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/memory/session.ts"],"names":[],"mappings":""}

package/dist/memory/session.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.mjs.map

package/dist/memory/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","sourceRoot":"","sources":["../../src/memory/session.ts"],"names":[],"mappings":""}

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.2.1",
+    "version": "0.3.0",
     "versions": {
-        "@openai/agents-core": "0.2.1",
+        "@openai/agents-core": "0.3.0",
         "openai": "^6"
     }
 };

package/dist/metadata.mjs

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

package/dist/run.d.ts

@@ -1,13 +1,14 @@
 import { Agent, AgentOutputType } from './agent';
 import { InputGuardrail, OutputGuardrail } from './guardrail';
 import { HandoffInputFilter } from './handoff';
-import { Model, ModelProvider, ModelSettings } from './model';
+import { Model, ModelProvider, ModelSettings, ModelTracing } from './model';
 import { RunContext } from './runContext';
 import { AgentInputItem } from './types';
 import { RunResult, StreamedRunResult } from './result';
 import { RunHooks } from './lifecycle';
 import { RunItem } from './items';
 import { RunState } from './runState';
+import type { Session, SessionInputCallback } from './memory/session';
 /**
  * Configures settings for the entire agent run.
  */
@@ -68,36 +69,74 @@ export type RunConfig = {
      * An optional dictionary of additional metadata to include with the trace.
      */
     traceMetadata?: Record<string, string>;
+    /**
+     * Customizes how session history is combined with the current turn's input.
+     * When omitted, history items are appended before the new input.
+     */
+    sessionInputCallback?: SessionInputCallback;
+    /**
+     * Invoked immediately before calling the model, allowing callers to edit the
+     * system instructions or input items that will be sent to the model.
+     */
+    callModelInputFilter?: CallModelInputFilter;
 };
+/**
+ * Common run options shared between streaming and non-streaming execution pathways.
+ */
 type SharedRunOptions<TContext = undefined> = {
     context?: TContext | RunContext<TContext>;
     maxTurns?: number;
     signal?: AbortSignal;
     previousResponseId?: string;
     conversationId?: string;
+    session?: Session;
+    sessionInputCallback?: SessionInputCallback;
+    callModelInputFilter?: CallModelInputFilter;
 };
+/**
+ * Options for runs that stream incremental events as the model responds.
+ */
 export type StreamRunOptions<TContext = undefined> = SharedRunOptions<TContext> & {
     /**
      * Whether to stream the run. If true, the run will emit events as the model responds.
      */
     stream: true;
 };
+/**
+ * Options for runs that collect the full model response before returning.
+ */
 export type NonStreamRunOptions<TContext = undefined> = SharedRunOptions<TContext> & {
     /**
-     * Whether to stream the run. If true, the run will emit events as the model responds.
+     * Run to completion without streaming incremental events; leave undefined or set to `false`.
      */
     stream?: false;
 };
+/**
+ * Options polymorphic over streaming or non-streaming execution modes.
+ */
 export type IndividualRunOptions<TContext = undefined> = StreamRunOptions<TContext> | NonStreamRunOptions<TContext>;
-export declare function getTurnInput(originalInput: string | AgentInputItem[], generatedItems: RunItem[]): AgentInputItem[];
 /**
- * A Runner is responsible for running an agent workflow.
+ * Executes an agent workflow with the shared default `Runner` instance.
+ *
+ * @param agent - The entry agent to invoke.
+ * @param input - A string utterance, structured input items, or a resumed `RunState`.
+ * @param options - Controls streaming mode, context, session handling, and turn limits.
+ * @returns A `RunResult` when `stream` is false, otherwise a `StreamedRunResult`.
+ */
+export declare function run<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: string | AgentInputItem[] | RunState<TContext, TAgent>, options?: NonStreamRunOptions<TContext>): Promise<RunResult<TContext, TAgent>>;
+export declare function run<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: string | AgentInputItem[] | RunState<TContext, TAgent>, options?: StreamRunOptions<TContext>): Promise<StreamedRunResult<TContext, TAgent>>;
+/**
+ * Orchestrates agent execution, including guardrails, tool calls, session persistence, and
+ * tracing. Reuse a `Runner` instance when you want consistent configuration across multiple runs.
  */
 export declare class Runner extends RunHooks<any, AgentOutputType<unknown>> {
     #private;
     readonly config: RunConfig;
-    private readonly inputGuardrailDefs;
-    private readonly outputGuardrailDefs;
+    /**
+     * Creates a runner with optional defaults that apply to every subsequent run invocation.
+     *
+     * @param config - Overrides for models, guardrails, tracing, or session behavior.
+     */
     constructor(config?: Partial<RunConfig>);
     /**
      * Run a workflow starting at the given agent. The agent will run in a loop until a final
@@ -123,8 +162,49 @@ export declare class Runner extends RunHooks<any, AgentOutputType<unknown>> {
      */
     run<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: string | AgentInputItem[] | RunState<TContext, TAgent>, options?: NonStreamRunOptions<TContext>): Promise<RunResult<TContext, TAgent>>;
     run<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: string | AgentInputItem[] | RunState<TContext, TAgent>, options?: StreamRunOptions<TContext>): Promise<StreamedRunResult<TContext, TAgent>>;
+    private readonly inputGuardrailDefs;
+    private readonly outputGuardrailDefs;
 }
+/**
+ * Mutable view of the instructions + input items that the model will receive.
+ * Filters always see a copy so they can edit without side effects.
+ */
+export type ModelInputData = {
+    input: AgentInputItem[];
+    instructions?: string;
+};
+/**
+ * Shape of the payload given to `callModelInputFilter`. Mirrored in the Python SDK so filters can
+ * share the same implementation across languages.
+ */
+export type CallModelInputFilterArgs<TContext = unknown> = {
+    modelData: ModelInputData;
+    agent: Agent<TContext, AgentOutputType>;
+    context: TContext | undefined;
+};
+/**
+ * Hook invoked immediately before a model call is issued, allowing callers to adjust the
+ * instructions or input array. Returning a new array enables redaction, truncation, or
+ * augmentation of the payload that will be sent to the provider.
+ */
+export type CallModelInputFilter<TContext = unknown> = (args: CallModelInputFilterArgs<TContext>) => ModelInputData | Promise<ModelInputData>;
+/**
+ * Constructs the model input array for the current turn by combining the original turn input with
+ * any new run items (excluding tool approval placeholders). This helps ensure that repeated calls
+ * to the Responses API only send newly generated content.
+ *
+ * See: https://platform.openai.com/docs/guides/conversation-state?api-mode=responses.
+ */
+export declare function getTurnInput(originalInput: string | AgentInputItem[], generatedItems: RunItem[]): AgentInputItem[];
+/**
+ * Resolves the effective model for the next turn by giving precedence to the agent-specific
+ * configuration when present, otherwise falling back to the runner-level default.
+ */
 export declare function selectModel(agentModel: string | Model, runConfigModel: string | Model | undefined): string | Model;
-export declare function run<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: string | AgentInputItem[] | RunState<TContext, TAgent>, options?: NonStreamRunOptions<TContext>): Promise<RunResult<TContext, TAgent>>;
-export declare function run<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: string | AgentInputItem[] | RunState<TContext, TAgent>, options?: StreamRunOptions<TContext>): Promise<StreamedRunResult<TContext, TAgent>>;
+/**
+ * Normalizes tracing configuration into the format expected by model providers.
+ * Returns `false` to disable tracing, `true` to include full payload data, or
+ * `'enabled_without_data'` to omit sensitive content while still emitting spans.
+ */
+export declare function getTracing(tracingDisabled: boolean, traceIncludeSensitiveData: boolean): ModelTracing;
 export {};