Error: transfer_back_to_supervisor is not a valid tool #949

Closed
opened 2026-02-20 17:42:29 -05:00 by yindo · 8 comments
Owner

Originally created by @SmallTownRiver on GitHub (Aug 28, 2025).

Checked other resources

  • This is a bug, not a usage question. For questions, please use the LangChain Forum (https://forum.langchain.com/).
  • I added a clear and detailed title that summarizes the issue.
  • I read what a minimal reproducible example is (https://stackoverflow.com/help/minimal-reproducible-example).
  • I included a self-contained, minimal example that demonstrates the issue INCLUDING all the relevant imports. The code run AS IS to reproduce the issue.

Example Code

agent1 = create_react_agent(
   model=llm,
   tools=[tool1,tool2],
   name='agent1',
)
agent2 = create_react_agent(
   model=llm,
   tools=[tool3,tool4],
   name='agent2',
)
supervisor = create_supervisor(
   agents=[agent1, agent2],
   model=llm
)

supervisor.invoke("xxxx")

Error Message and Stack Trace (if applicable)

{
    "content": "Error: transfer_back_to_supervisor is not a valid tool, try one of [tool1, tool2].",
    "additional_kwargs": {},
    "response_metadata": {},
    "type": "tool",
    "name": "transfer_back_to_supervisor",
    "id": "1f69e141-d8c9-4be2-8e17-bfe931857dfe",
    "tool_call_id": "call_pp2d2sqseg7jw23n1rqrwqbg",
    "status": "error"
}

Description

when agent1 finish work, it can't return control to the supervisor and append this error msg to stream

System Info

langgraph==0.6.6
langgraph-supervisor==0.0.29

Originally created by @SmallTownRiver on GitHub (Aug 28, 2025). ### Checked other resources - [x] This is a bug, not a usage question. For questions, please use the LangChain Forum (https://forum.langchain.com/). - [x] I added a clear and detailed title that summarizes the issue. - [x] I read what a minimal reproducible example is (https://stackoverflow.com/help/minimal-reproducible-example). - [x] I included a self-contained, minimal example that demonstrates the issue INCLUDING all the relevant imports. The code run AS IS to reproduce the issue. ### Example Code ```python agent1 = create_react_agent( model=llm, tools=[tool1,tool2], name='agent1', ) agent2 = create_react_agent( model=llm, tools=[tool3,tool4], name='agent2', ) supervisor = create_supervisor( agents=[agent1, agent2], model=llm ) supervisor.invoke("xxxx") ``` ### Error Message and Stack Trace (if applicable) ```shell { "content": "Error: transfer_back_to_supervisor is not a valid tool, try one of [tool1, tool2].", "additional_kwargs": {}, "response_metadata": {}, "type": "tool", "name": "transfer_back_to_supervisor", "id": "1f69e141-d8c9-4be2-8e17-bfe931857dfe", "tool_call_id": "call_pp2d2sqseg7jw23n1rqrwqbg", "status": "error" } ``` ### Description when agent1 finish work, it can't return control to the supervisor and append this error msg to stream ### System Info langgraph==0.6.6 langgraph-supervisor==0.0.29
yindo added the bugpending labels 2026-02-20 17:42:29 -05:00
yindo closed this issue 2026-02-20 17:42:29 -05:00
Author
Owner

@we-over-i commented on GitHub (Aug 29, 2025):

I can confirm that this issue exists when using the supervisor architecture. The first tool call of transfer_back_to_supervisor fails, but the subsequent calls works.

@we-over-i commented on GitHub (Aug 29, 2025): I can confirm that this issue exists when using the supervisor architecture. The first tool call of transfer_back_to_supervisor fails, but the subsequent calls works.
Author
Owner

@sarathak commented on GitHub (Sep 1, 2025):

i think issue must be related to https://github.com/langchain-ai/langgraph-supervisor-py not langgraph

@sarathak commented on GitHub (Sep 1, 2025): i think issue must be related to https://github.com/langchain-ai/langgraph-supervisor-py not langgraph
Author
Owner

@SmallTownRiver commented on GitHub (Sep 3, 2025):

issue with unpredictable reproduction, but significantly impacts user experience.

@SmallTownRiver commented on GitHub (Sep 3, 2025): issue with unpredictable reproduction, but significantly impacts user experience.
Author
Owner

@fehmisener commented on GitHub (Sep 15, 2025):

I think the library is still not mature.. it's just happening without any reason

@fehmisener commented on GitHub (Sep 15, 2025): I think the library is still not mature.. it's just happening without any reason
Author
Owner

@nathananneken-8451 commented on GitHub (Sep 24, 2025):

We've seen similar errors pop up randomly as well, feels like a race condition that can just randomly occur without much warning

@nathananneken-8451 commented on GitHub (Sep 24, 2025): We've seen similar errors pop up randomly as well, feels like a race condition that can just randomly occur without much warning
Author
Owner

@tngwilkins commented on GitHub (Sep 25, 2025):

+1, seeing this also

@tngwilkins commented on GitHub (Sep 25, 2025): +1, seeing this also
Author
Owner

@sydney-runkle commented on GitHub (Nov 7, 2025):

closing, this is reported on supervisor

@sydney-runkle commented on GitHub (Nov 7, 2025): closing, this is reported on supervisor
Author
Owner

@lucky6qi commented on GitHub (Nov 12, 2025):

https://github.com/langchain-ai/langgraph-supervisor-py/issues/241

@lucky6qi commented on GitHub (Nov 12, 2025): https://github.com/langchain-ai/langgraph-supervisor-py/issues/241
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/langgraph#949