Translate supervisor tutorial to js #981

pokey · 2025-10-17T21:33:06Z

Just translates the Python version of the supervisor tutorial to js.

Depends on feat(core): Add BaseMessage.toFormattedString() langchainjs#9228
See also feat(examples): Add supervisor example langchainjs#9235

To accompany https://docs.langchain.com/oss/javascript/langchain/supervisor from langchain-ai/docs#981

pokey · 2025-10-20T12:56:50Z

src/oss/langchain/supervisor.mdx


 **Important:** Make sure sub-agent prompts emphasize that their final message should contain all relevant information. A common failure mode is sub-agents that perform tool calls but don't include the results in their final response.

+:::js


I don't think we have a Python example so I've made this callout js-only for now

Copilot

Pull Request Overview

This PR translates the supervisor agent tutorial from Python to JavaScript, creating language-specific versions of the tutorial content. The PR adds comprehensive JavaScript examples alongside the existing Python content, including tool definitions, agent creation, human-in-the-loop patterns, and advanced customization examples.

Key Changes

Added JavaScript/TypeScript code examples throughout the tutorial using custom language fences (:::js and :::python)
Updated navigation structure in docs.json to make the supervisor tutorial accessible from both Python and JavaScript sections
Included JavaScript-specific installation instructions and imports

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File	Description
src/oss/langchain/supervisor.mdx	Added comprehensive JavaScript translations of all code examples, including tool definitions, agent creation, streaming patterns, and human-in-the-loop workflows
src/docs.json	Updated navigation to reference the shared supervisor tutorial from both Python and JavaScript tutorial sections

src/oss/langchain/supervisor.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull Request Overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

src/oss/langchain/supervisor.mdx

src/docs.json

src/oss/langchain/supervisor.mdx

hntrl · 2025-10-20T21:40:11Z

src/oss/langchain/supervisor.mdx

+  for (const update of Object.values(step)) {
+    if (update && typeof update === "object" && "messages" in update) {
+      for (const message of update.messages) {
+        console.log(message.prettyPrint());
+      }
+    }
+  }


this looked odd until I realized that stream steps are just cast as any types 🫠

yeah this was the cleanest I could come up with, but does actually result in a type error. Should I add an explicit any cast? Would be good to revisit at some point to see if we can come up with something clean that keeps strong types

hntrl · 2025-10-20T21:43:32Z

src/oss/langchain/supervisor.mdx

+
+const resume: Record<string, any> = {};
+for (const interrupt of interrupts) {
+  if (interrupt.id === "2b56f299be313ad8bc689eff02973f16") {


hmm don't think this is desired?

nice catch. I've fixed the ts but left the python

hntrl · 2025-10-20T21:47:04Z

src/oss/langchain/supervisor.mdx

+    // Customize context received by sub-agent
+    // Access full thread messages from the config
+    const currentMessages =
+      config?.configurable?.pregel_scratchpad?.currentTaskInput?.messages || [];


The preferred way to introspect state (currently):

Suggested change

// Customize context received by sub-agent

// Access full thread messages from the config

const currentMessages =

config?.configurable?.pregel_scratchpad?.currentTaskInput?.messages || [];

// Customize context received by sub-agent

// Access full thread messages from the config

const currentMessages = getCurrentTaskInput<InternalAgentState>(config).messages;

importing InternalAgentState from langchain and getCurrentTaskInput from langgraph

I made this fix, but it from what I can tell, InternalAgentState is not actually exported from langchain? Did we want to export that?

src/oss/langchain/supervisor.mdx

Copilot

Pull Request Overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

Copilot · 2025-10-21T10:17:03Z

src/oss/langchain/supervisor.mdx

+
+:::js
+```typescript
+import { tool } from "langchain";


The import statement references a non-existent module. The tool function should be imported from '@langchain/core/tools' rather than 'langchain'.

Suggested change

import { tool } from "langchain";

import { tool } from "@langchain/core/tools";

Copilot · 2025-10-21T10:17:03Z

src/oss/langchain/supervisor.mdx

+
+:::js
+```typescript
+import { createAgent } from "langchain";


The import statement references a non-existent module. The createAgent function should be imported from a specific LangChain package (likely '@langchain/langgraph' or similar) rather than the generic 'langchain' package.

Suggested change

import { createAgent } from "langchain";

import { createAgent } from "@langchain/langgraph";

Copilot · 2025-10-21T10:17:04Z

src/oss/langchain/supervisor.mdx

+ * that are wrapped as tools.
+ */
+
+import { tool, createAgent } from "langchain";


The import statement references a non-existent module. Both tool and createAgent should be imported from their correct packages: tool from '@langchain/core/tools' and createAgent from the appropriate LangChain package.

Suggested change

import { tool, createAgent } from "langchain";

import { tool } from "@langchain/core/tools";

import { createAgent } from "@langchain/core/agents";

Copilot · 2025-10-21T10:17:04Z

src/oss/langchain/supervisor.mdx

+import { createAgent, humanInTheLoopMiddleware } from "langchain"; // [!code highlight]
+import { MemorySaver } from "@langchain/langgraph"; // [!code highlight]


The import statement references a non-existent module. These functions should be imported from their specific packages rather than the generic 'langchain' package.

Suggested change

import { createAgent, humanInTheLoopMiddleware } from "langchain"; // [!code highlight]

import { MemorySaver } from "@langchain/langgraph"; // [!code highlight]

import { createAgent, humanInTheLoopMiddleware, MemorySaver } from "@langchain/langgraph"; // [!code highlight]

Copilot · 2025-10-21T10:17:04Z

src/oss/langchain/supervisor.mdx

+      startTime: z.string().describe("ISO format: '2024-01-15T14:00:00'"),
+      endTime: z.string().describe("ISO format: '2024-01-15T15:00:00'"),
+      attendees: z.array(z.string()).describe("email addresses"),
+      location: z.string().optional().default(""),


Chaining .default() after .optional() is incorrect. Either use .optional() alone (which makes the field optional with undefined as default) or use .default('') without .optional().

Copilot · 2025-10-21T10:17:04Z

src/oss/langchain/supervisor.mdx

+      to: z.array(z.string()).describe("email addresses"),
+      subject: z.string(),
+      body: z.string(),
+      cc: z.array(z.string()).optional().default([]),


Chaining .default() after .optional() is incorrect. Either use .optional() alone (which makes the field optional with undefined as default) or use .default([]) without .optional().

Suggested change

cc: z.array(z.string()).optional().default([]),

cc: z.array(z.string()).default([]),

Copilot · 2025-10-21T10:17:05Z

src/oss/langchain/supervisor.mdx

+
+:::js
+```typescript
+import { getCurrentTaskInput } from "@langchain/langgraph";


The function getCurrentTaskInput does not exist in '@langchain/langgraph'. Verify the correct import path for accessing task input in LangChain.js.

pokey · 2025-10-21T10:23:56Z

Ok I addressed your comments and left responses to a couple

Copilot

Pull Request Overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

Just translates the Python version of the supervisor tutorial to js. - Depends on langchain-ai/langchainjs#9228 - See also langchain-ai/langchainjs#9235 --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Lauren Hirata Singh <lauren@langchain.dev>

github-actions bot added langchain For docs changes to LangChain oss labels Oct 17, 2025

pokey force-pushed the pokey/translate-supervisor-tutorial-to-js branch from 71bf3e4 to 8ba0e0c Compare October 20, 2025 11:39

pokey added a commit to pokey/langchainjs that referenced this pull request Oct 20, 2025

feat(examples): Add supervisor example

1e23534

To accompany https://docs.langchain.com/oss/javascript/langchain/supervisor from langchain-ai/docs#981

pokey mentioned this pull request Oct 20, 2025

feat(examples): Add supervisor example langchain-ai/langchainjs#9235

Merged

Translate supervisor tutorial to js

14c9da7

pokey force-pushed the pokey/translate-supervisor-tutorial-to-js branch from 8ba0e0c to 14c9da7 Compare October 20, 2025 11:48

pokey commented Oct 20, 2025

View reviewed changes

pokey marked this pull request as ready for review October 20, 2025 12:57

pokey requested review from katmayb and lnhsingh as code owners October 20, 2025 12:57

Copilot AI review requested due to automatic review settings October 20, 2025 12:57

Copilot AI reviewed Oct 20, 2025

View reviewed changes

Update supervisor.mdx

061cea3

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings October 20, 2025 18:01

Copilot AI reviewed Oct 20, 2025

View reviewed changes

src/oss/langchain/supervisor.mdx Show resolved Hide resolved

hntrl reviewed Oct 20, 2025

View reviewed changes

PR feedback

da61d20

Copilot AI review requested due to automatic review settings October 21, 2025 10:15

pokey force-pushed the pokey/translate-supervisor-tutorial-to-js branch from ee29781 to da61d20 Compare October 21, 2025 10:15

Copilot AI reviewed Oct 21, 2025

View reviewed changes

rename prettyPrint => toFormattedString

3f8d435

pokey mentioned this pull request Oct 21, 2025

feat(examples): Add sql_agent example langchain-ai/langchainjs#9249

Open

Merge branch 'main' into pokey/translate-supervisor-tutorial-to-js

f25c226

Copilot AI review requested due to automatic review settings October 22, 2025 12:57

Copilot AI reviewed Oct 22, 2025

View reviewed changes

lnhsingh approved these changes Oct 22, 2025

View reviewed changes

Merge branch 'main' into pokey/translate-supervisor-tutorial-to-js

7ba8f9f

lnhsingh merged commit 3e74969 into langchain-ai:main Oct 22, 2025
4 checks passed


		Important: Make sure sub-agent prompts emphasize that their final message should contain all relevant information. A common failure mode is sub-agents that perform tool calls but don't include the results in their final response.

		:::js

	import { tool } from "langchain";
	import { tool } from "@langchain/core/tools";

	import { createAgent } from "langchain";
	import { createAgent } from "@langchain/langgraph";

	import { tool, createAgent } from "langchain";
	import { tool } from "@langchain/core/tools";
	import { createAgent } from "@langchain/core/agents";

		import { createAgent, humanInTheLoopMiddleware } from "langchain"; // [!code highlight]
		import { MemorySaver } from "@langchain/langgraph"; // [!code highlight]

	cc: z.array(z.string()).optional().default([]),
	cc: z.array(z.string()).default([]),

Translate supervisor tutorial to js #981

Translate supervisor tutorial to js #981

Uh oh!

Conversation

pokey commented Oct 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pokey Oct 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Key Changes

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

hntrl Oct 20, 2025

Choose a reason for hiding this comment

Uh oh!

pokey Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

hntrl Oct 20, 2025

Choose a reason for hiding this comment

Uh oh!

pokey Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

hntrl Oct 20, 2025

Choose a reason for hiding this comment

Uh oh!

pokey Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Copilot AI Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

pokey commented Oct 21, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

pokey commented Oct 17, 2025 •

edited

Loading