[PR #3724] docs(deepagents): add streaming mode coverage to human-in-the-loop page #3757

Open
opened 2026-06-05 18:53:02 -04:00 by yindo · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3724
Author: @AdemBoukhris457
Created: 4/25/2026
Status: 🔄 Open

Base: mainHead: docs/deepagents-hitl-streaming


📝 Commits (3)

  • 7e418e3 docs: add streaming HITL section to deep agents human-in-the-loop page
  • 54f7270 docs: add streaming note to subagent interrupts section
  • f3d75db docs: cross-reference HITL from deep agents streaming page

📊 Changes

2 files changed (+179 additions, -0 deletions)

View changed files

📝 src/oss/deepagents/human-in-the-loop.mdx (+141 -0)
📝 src/oss/deepagents/streaming.mdx (+38 -0)

📄 Description

Overview

Add streaming mode coverage to the Deep Agents human-in-the-loop documentation. The existing HITL page only covered the .invoke() path. This PR adds streaming examples, a subagent streaming note, and cross-references between the HITL and streaming pages.

Type of change

Type: Update existing documentation

Related issues/PRs

  • GitHub issue: closes #3723
  • Feature PR:
  • Linear issue:
  • Slack thread:

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

Changes across 3 commits:

  1. human-in-the-loop.mdx — New "Handle interrupts with streaming" section with full Python + TypeScript examples showing the stream → detect __interrupt__ → collect decisions → Command(resume=...) → re-stream loop pattern
  2. human-in-the-loop.mdx — Added a note in the "Subagent interrupts" section that subagent interrupts also surface in the updates stream when subgraphs=True is enabled, with cross-link
  3. streaming.mdx — New "Handle human-in-the-loop interrupts" subsection in common patterns with short detection snippets, plus HITL link added to Related section

No new pages were added, so src/docs.json does not need updating. Code examples are based on patterns from the Deep Agents CLI source (textual_adapter.py, non_interactive.py).


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/3724 **Author:** [@AdemBoukhris457](https://github.com/AdemBoukhris457) **Created:** 4/25/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/deepagents-hitl-streaming` --- ### 📝 Commits (3) - [`7e418e3`](https://github.com/langchain-ai/docs/commit/7e418e3f251ce889ee67db3f11ce0c39bd540c8d) docs: add streaming HITL section to deep agents human-in-the-loop page - [`54f7270`](https://github.com/langchain-ai/docs/commit/54f72702490040bfa1d92388eb724206589dd4f4) docs: add streaming note to subagent interrupts section - [`f3d75db`](https://github.com/langchain-ai/docs/commit/f3d75db2d4ecf13e91c9f2d5ecf8643b8cb0813d) docs: cross-reference HITL from deep agents streaming page ### 📊 Changes **2 files changed** (+179 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `src/oss/deepagents/human-in-the-loop.mdx` (+141 -0) 📝 `src/oss/deepagents/streaming.mdx` (+38 -0) </details> ### 📄 Description ## Overview Add streaming mode coverage to the Deep Agents human-in-the-loop documentation. The existing HITL page only covered the `.invoke()` path. This PR adds streaming examples, a subagent streaming note, and cross-references between the HITL and streaming pages. ## Type of change **Type:** Update existing documentation ## Related issues/PRs - GitHub issue: closes #3723 - Feature PR: - Linear issue: - Slack thread: ## Checklist - [x] I have read the [contributing guidelines](README.md), including the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy) - [x] I have tested my changes locally using `docs dev` - [x] All code examples have been tested and work correctly - [x] I have used **root relative** paths for internal links - [x] I have updated navigation in `src/docs.json` if needed **Changes across 3 commits:** 1. **`human-in-the-loop.mdx`** — New "Handle interrupts with streaming" section with full Python + TypeScript examples showing the stream → detect `__interrupt__` → collect decisions → `Command(resume=...)` → re-stream loop pattern 2. **`human-in-the-loop.mdx`** — Added a note in the "Subagent interrupts" section that subagent interrupts also surface in the `updates` stream when `subgraphs=True` is enabled, with cross-link 3. **`streaming.mdx`** — New "Handle human-in-the-loop interrupts" subsection in common patterns with short detection snippets, plus HITL link added to Related section No new pages were added, so `src/docs.json` does not need updating. Code examples are based on patterns from the Deep Agents CLI source (`textual_adapter.py`, `non_interactive.py`). --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-06-05 18:53:02 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#3757