From 5426911e206558a6124bfcd1fb977781e6a6c8c1 Mon Sep 17 00:00:00 2001 From: Sydney Runkle Date: Sat, 11 Oct 2025 11:50:32 -0400 Subject: [PATCH 1/3] remove old images --- src/oss/images/0000.svg | 1 - src/oss/images/0001.svg | 1 - src/oss/images/0010.svg | 1 - src/oss/images/0011.svg | 1 - src/oss/images/0100.svg | 1 - src/oss/images/0101.svg | 1 - src/oss/images/0110.svg | 1 - src/oss/images/0111.svg | 1 - src/oss/images/1000.svg | 1 - src/oss/images/1001.svg | 1 - src/oss/images/1010.svg | 1 - src/oss/images/1011.svg | 1 - src/oss/images/1100.svg | 1 - src/oss/images/1101.svg | 1 - src/oss/images/1110.svg | 1 - src/oss/images/1111.svg | 1 - 16 files changed, 16 deletions(-) delete mode 100644 src/oss/images/0000.svg delete mode 100644 src/oss/images/0001.svg delete mode 100644 src/oss/images/0010.svg delete mode 100644 src/oss/images/0011.svg delete mode 100644 src/oss/images/0100.svg delete mode 100644 src/oss/images/0101.svg delete mode 100644 src/oss/images/0110.svg delete mode 100644 src/oss/images/0111.svg delete mode 100644 src/oss/images/1000.svg delete mode 100644 src/oss/images/1001.svg delete mode 100644 src/oss/images/1010.svg delete mode 100644 src/oss/images/1011.svg delete mode 100644 src/oss/images/1100.svg delete mode 100644 src/oss/images/1101.svg delete mode 100644 src/oss/images/1110.svg delete mode 100644 src/oss/images/1111.svg diff --git a/src/oss/images/0000.svg b/src/oss/images/0000.svg deleted file mode 100644 index c6ac7fdfc..000000000 --- a/src/oss/images/0000.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

__end__

 diff --git a/src/oss/images/0001.svg b/src/oss/images/0001.svg deleted file mode 100644 index 79d79403f..000000000 --- a/src/oss/images/0001.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

__end__

 diff --git a/src/oss/images/0010.svg b/src/oss/images/0010.svg deleted file mode 100644 index b6ecf5516..000000000 --- a/src/oss/images/0010.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

pre_model_hook

__end__

 diff --git a/src/oss/images/0011.svg b/src/oss/images/0011.svg deleted file mode 100644 index 1f218281b..000000000 --- a/src/oss/images/0011.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

pre_model_hook

__end__

 diff --git a/src/oss/images/0100.svg b/src/oss/images/0100.svg deleted file mode 100644 index 8fa789f7a..000000000 --- a/src/oss/images/0100.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

post_model_hook

__end__

 diff --git a/src/oss/images/0101.svg b/src/oss/images/0101.svg deleted file mode 100644 index e746496fd..000000000 --- a/src/oss/images/0101.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

post_model_hook

__end__

 diff --git a/src/oss/images/0110.svg b/src/oss/images/0110.svg deleted file mode 100644 index 34f2ee59e..000000000 --- a/src/oss/images/0110.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

pre_model_hook

post_model_hook

__end__

 diff --git a/src/oss/images/0111.svg b/src/oss/images/0111.svg deleted file mode 100644 index 4a8f5c77e..000000000 --- a/src/oss/images/0111.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

pre_model_hook

post_model_hook

__end__

 diff --git a/src/oss/images/1000.svg b/src/oss/images/1000.svg deleted file mode 100644 index 84d439aba..000000000 --- a/src/oss/images/1000.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

generate_structured_response

__end__

 diff --git a/src/oss/images/1001.svg b/src/oss/images/1001.svg deleted file mode 100644 index 3066654d9..000000000 --- a/src/oss/images/1001.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

generate_structured_response

__end__

 diff --git a/src/oss/images/1010.svg b/src/oss/images/1010.svg deleted file mode 100644 index 445f405c5..000000000 --- a/src/oss/images/1010.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

pre_model_hook

generate_structured_response

__end__

 diff --git a/src/oss/images/1011.svg b/src/oss/images/1011.svg deleted file mode 100644 index ed5ab0bb5..000000000 --- a/src/oss/images/1011.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

pre_model_hook

generate_structured_response

__end__

 diff --git a/src/oss/images/1100.svg b/src/oss/images/1100.svg deleted file mode 100644 index 23e2d5b71..000000000 --- a/src/oss/images/1100.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

post_model_hook

generate_structured_response

__end__

 diff --git a/src/oss/images/1101.svg b/src/oss/images/1101.svg deleted file mode 100644 index acc1d0403..000000000 --- a/src/oss/images/1101.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

post_model_hook

generate_structured_response

__end__

 diff --git a/src/oss/images/1110.svg b/src/oss/images/1110.svg deleted file mode 100644 index efe832965..000000000 --- a/src/oss/images/1110.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

pre_model_hook

post_model_hook

generate_structured_response

__end__

 diff --git a/src/oss/images/1111.svg b/src/oss/images/1111.svg deleted file mode 100644 index b903b4ed6..000000000 --- a/src/oss/images/1111.svg +++ /dev/null @@ -1 +0,0 @@ -

__start__

agent

tools

pre_model_hook

post_model_hook

generate_structured_response

__end__

 From a905883fe800ef759298ff855f479534d0228476 Mon Sep 17 00:00:00 2001 From: Sydney Runkle <54324534+sydney-runkle@users.noreply.github.com> Date: Sat, 11 Oct 2025 16:23:09 -0400 Subject: [PATCH 2/3] Change content highlights (#854) --- pipeline/core/builder.py | 10 +- src/oss/langchain/middleware.mdx | 20 +- src/oss/langgraph/use-functional-api.mdx | 4 +- .../middleware_visualization/README.md | 63 +++ .../middleware_visualization/diagrams_js.js | 1 + .../diagrams_python.js | 1 + .../generate_middleware_diagrams.py | 256 +++++++++++ .../middleware_visualization/index.html | 401 ++++++++++++++++++ 8 files changed, 738 insertions(+), 18 deletions(-) create mode 100644 src/plugins/middleware_visualization/README.md create mode 100644 src/plugins/middleware_visualization/diagrams_js.js create mode 100644 src/plugins/middleware_visualization/diagrams_python.js create mode 100644 src/plugins/middleware_visualization/generate_middleware_diagrams.py create mode 100644 src/plugins/middleware_visualization/index.html diff --git a/pipeline/core/builder.py b/pipeline/core/builder.py index f7488e399..08becb850 100644 --- a/pipeline/core/builder.py +++ b/pipeline/core/builder.py @@ -51,6 +51,7 @@ def __init__(self, src_dir: Path, build_dir: Path) -> None: ".yaml", ".css", ".js", + ".html", } # Mapping of language codes to full names for URLs @@ -156,8 +157,8 @@ def rewrite_link(match: re.Match) -> str: url = match.group(2) # The URL post = match.group(3) # Everything after the URL - # Only rewrite absolute /oss/ paths that don't contain 'images' - if url.startswith("/oss/") and "images" not in url: + # Only rewrite absolute /oss/ paths that don't contain 'images' or 'plugins' + if url.startswith("/oss/") and "images" not in url and "plugins" not in url: parts = url.split("/") # Insert full language name after "oss" parts.insert(2, self.language_url_names[target_language]) @@ -743,8 +744,11 @@ def is_shared_file(self, file_path: Path) -> bool: if "snippets" in relative_path.parts: return True + if "plugins" in relative_path.parts: + return True + # JavaScript and CSS files should be shared (used for custom scripts/styles) - return file_path.suffix.lower() in {".js", ".css"} + return file_path.suffix.lower() in {".js", ".css", ".html", ".json"} def _copy_shared_files(self) -> None: """Copy files that should be shared between versions.""" diff --git a/src/oss/langchain/middleware.mdx b/src/oss/langchain/middleware.mdx index 49a51fb3b..fe4bb7e87 100644 --- a/src/oss/langchain/middleware.mdx +++ b/src/oss/langchain/middleware.mdx @@ -877,21 +877,15 @@ Build custom middleware by implementing hooks that run at specific points in the #### Node-style hooks -Run at specific points in the execution flow: +Run at specific points in the execution flow. -:::python -- `before_agent` - Before agent starts (once per invocation) -- `before_model` - Before each model call -- `after_model` - After each model response -- `after_agent` - After agent completes (up to once per invocation) -::: +**Try it:** The interactive widget below shows all available hooks and lets you toggle different combinations to see how they affect the agent execution graph: -:::js -- `beforeAgent` - Before agent starts (once per invocation) -- `beforeModel` - Before each model call -- `afterModel` - After each model response -- `afterAgent` - After agent completes (up to once per invocation) -::: +