Add run context to handoff input filter to align with Python SDK (#271)

Author: seratch

.changeset/shiny-months-smoke.md

@@ -0,0 +1,5 @@
+---
+"@openai/agents-core": patch
+---
+
+Add run context to handoff input filter to align with Python SDK

packages/agents-core/src/extensions/handoffFilters.ts

@@ -24,7 +24,8 @@ const TOOL_TYPES = new Set([
 export function removeAllTools(
   handoffInputData: HandoffInputData,
 ): HandoffInputData {
-  const { inputHistory, preHandoffItems, newItems } = handoffInputData;
+  const { inputHistory, preHandoffItems, newItems, runContext } =
+    handoffInputData;
 
   const filteredHistory = Array.isArray(inputHistory)
     ? removeToolTypesFromInput(inputHistory)
@@ -37,6 +38,7 @@ export function removeAllTools(
     inputHistory: filteredHistory,
     preHandoffItems: filteredPreHandoffItems,
     newItems: filteredNewItems,
+    runContext,
   };
 }
 

packages/agents-core/src/handoff.ts

@@ -34,6 +34,11 @@ export type HandoffInputData = {
    * handoff and the tool output message representing the response from the handoff output.
    */
   newItems: RunItem[];
+  /**
+   * The context of the handoff.
+   * Note that, since this property was added later on, it's optional to pass from users.
+   */
+  runContext?: RunContext<any>;
 };
 
 export type HandoffInputFilter = (input: HandoffInputData) => HandoffInputData;

packages/agents-core/src/runImplementation.ts

@@ -1025,6 +1025,7 @@ export async function executeHandoffCalls<
             : originalInput,
           preHandoffItems: [...preStepItems],
           newItems: [...newStepItems],
+          runContext,
         };
 
         const filtered = inputFilter(handoffInputData);