@openai/agents-core 0.2.1 → 0.3.1

package/dist/items.mjs

@@ -123,16 +123,37 @@ export class RunHandoffOutputItem extends RunItemBase {
 export class RunToolApprovalItem extends RunItemBase {
     rawItem;
     agent;
+    toolName;
     type = 'tool_approval_item';
-    constructor(rawItem, agent) {
+    constructor(rawItem, agent, 
+    /**
+     * Explicit tool name to use for approval tracking when not present on the raw item.
+     */
+    toolName) {
         super();
         this.rawItem = rawItem;
         this.agent = agent;
+        this.toolName = toolName;
+        this.toolName = toolName ?? rawItem.name;
+    }
+    /**
+     * Returns the tool name if available on the raw item or provided explicitly.
+     * Kept for backwards compatibility with code that previously relied on `rawItem.name`.
+     */
+    get name() {
+        return this.toolName ?? this.rawItem.name;
+    }
+    /**
+     * Returns the arguments if the raw item has an arguments property otherwise this will be undefined.
+     */
+    get arguments() {
+        return 'arguments' in this.rawItem ? this.rawItem.arguments : undefined;
     }
     toJSON() {
         return {
             ...super.toJSON(),
             agent: this.agent.toJSON(),
+            toolName: this.toolName,
         };
     }
 }

package/dist/items.mjs.map

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

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

package/dist/model.d.ts

@@ -1,6 +1,6 @@
 import { Usage } from './usage';
 import { StreamEvent } from './types/protocol';
-import { HostedTool, ComputerTool, FunctionTool } from './tool';
+import { HostedTool, ComputerTool, FunctionTool, ShellTool, ApplyPatchTool } from './tool';
 import { Handoff } from './handoff';
 import { AgentInputItem, AgentOutputItem, JsonSchemaDefinition, TextOutput, InputText, InputImage, InputFile } from './types';
 export type ModelSettingsToolChoice = 'auto' | 'required' | 'none' | (string & {});
@@ -127,12 +127,20 @@ export type SerializedComputerTool = {
     environment: ComputerTool['computer']['environment'];
     dimensions: ComputerTool['computer']['dimensions'];
 };
+export type SerializedShellTool = {
+    type: ShellTool['type'];
+    name: ShellTool['name'];
+};
+export type SerializedApplyPatchTool = {
+    type: ApplyPatchTool['type'];
+    name: ApplyPatchTool['name'];
+};
 export type SerializedHostedTool = {
     type: HostedTool['type'];
     name: HostedTool['name'];
     providerData?: HostedTool['providerData'];
 };
-export type SerializedTool = SerializedFunctionTool | SerializedComputerTool | SerializedHostedTool;
+export type SerializedTool = SerializedFunctionTool | SerializedComputerTool | SerializedShellTool | SerializedApplyPatchTool | SerializedHostedTool;
 export type SerializedHandoff = {
     /**
      * The name of the tool that represents the handoff.

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 {};