Skip to content

Handoff filters

Contains common handoff input filters, for convenience.

default_handoff_history_mapper 

default_handoff_history_mapper(
    transcript: list[TResponseInputItem],
) -> list[TResponseInputItem]

Return a single assistant message summarizing the transcript.

Source code in src/agents/handoffs/history.py 
321
322
323
324
325
326
327
def default_handoff_history_mapper(
    transcript: list[TResponseInputItem],
) -> list[TResponseInputItem]:
    """Return a single assistant message summarizing the transcript."""

    summary_message = _build_summary_message(transcript)
    return [summary_message]

nest_handoff_history 

nest_handoff_history(
    handoff_input_data: HandoffInputData,
    *,
    history_mapper: HandoffHistoryMapper | None = None,
) -> HandoffInputData

Summarize the previous transcript for the next agent without redacting sensitive data.

The transcript is built from input_history, pre_handoff_items, and new_items. Any existing input_items override is ignored. Tool arguments and outputs from those source fields can therefore remain in the generated summary text.

Sanitize all three source fields before calling this function, or sanitize the returned input_history before forwarding the nested result. Sanitizing the returned history allows the original new_items to remain available for session history. Filtering only input_items does not prevent sensitive content from entering nested history.

Source code in src/agents/handoffs/history.py 
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def nest_handoff_history(
    handoff_input_data: HandoffInputData,
    *,
    history_mapper: HandoffHistoryMapper | None = None,
) -> HandoffInputData:
    """Summarize the previous transcript for the next agent without redacting sensitive data.

    The transcript is built from ``input_history``, ``pre_handoff_items``, and ``new_items``.
    Any existing ``input_items`` override is ignored. Tool arguments and outputs from those
    source fields can therefore remain in the generated summary text.

    Sanitize all three source fields before calling this function, or sanitize the returned
    ``input_history`` before forwarding the nested result. Sanitizing the returned history
    allows the original ``new_items`` to remain available for session history. Filtering only
    ``input_items`` does not prevent sensitive content from entering nested history.
    """

    nested, _ = _nest_handoff_history_with_provenance(
        handoff_input_data,
        history_mapper=history_mapper,
    )
    return nested

remove_all_tools 

remove_all_tools(
    handoff_input_data: HandoffInputData,
) -> HandoffInputData

Filters out all tool items: file search, web search and function calls+output.

Source code in src/agents/extensions/handoff_filters.py 
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
def remove_all_tools(handoff_input_data: HandoffInputData) -> HandoffInputData:
    """Filters out all tool items: file search, web search and function calls+output."""

    history = handoff_input_data.input_history
    new_items = handoff_input_data.new_items

    filtered_history = (
        _remove_tool_types_from_input(history) if isinstance(history, tuple) else history
    )
    filtered_pre_handoff_items = _remove_tools_from_items(handoff_input_data.pre_handoff_items)
    filtered_new_items = _remove_tools_from_items(new_items)
    # Preserve and filter input_items so chained filters (e.g. after
    # nest_handoff_history) don't drop or re-introduce tool items.
    existing_input_items = handoff_input_data.input_items
    filtered_input_items = (
        _remove_tools_from_items(existing_input_items) if existing_input_items is not None else None
    )

    return handoff_input_data.clone(
        input_history=filtered_history,
        pre_handoff_items=filtered_pre_handoff_items,
        new_items=filtered_new_items,
        input_items=filtered_input_items,
    )