From e7d5e83ef8b7ff84b9223ce1bb4605204eed7875 Mon Sep 17 00:00:00 2001 From: Greg Holmes Date: Wed, 11 Mar 2026 11:07:05 +0000 Subject: [PATCH] Rename lang-graph files to langgraph and fix guide copy - Rename lang-graph-message-per-response/token to langgraph-message-per-response/token - Update nav links and index page to match new filenames - Replace "NPM package" with "Node project" across all guides --- src/data/nav/aitransport.ts | 4 ++-- .../ai-transport/guides/anthropic/anthropic-citations.mdx | 2 +- .../guides/anthropic/anthropic-human-in-the-loop.mdx | 2 +- .../guides/anthropic/anthropic-message-per-response.mdx | 4 ++-- .../guides/anthropic/anthropic-message-per-token.mdx | 4 ++-- ...-per-response.mdx => langgraph-message-per-response.mdx} | 6 +++--- ...essage-per-token.mdx => langgraph-message-per-token.mdx} | 4 ++-- .../docs/ai-transport/guides/openai/openai-citations.mdx | 2 +- .../ai-transport/guides/openai/openai-human-in-the-loop.mdx | 2 +- .../guides/openai/openai-message-per-response.mdx | 2 +- .../ai-transport/guides/openai/openai-message-per-token.mdx | 2 +- .../guides/vercel-ai-sdk/vercel-message-per-response.mdx | 2 +- .../guides/vercel-ai-sdk/vercel-message-per-token.mdx | 2 +- src/pages/docs/ai-transport/index.mdx | 4 ++-- 14 files changed, 21 insertions(+), 21 deletions(-) rename src/pages/docs/ai-transport/guides/langgraph/{lang-graph-message-per-response.mdx => langgraph-message-per-response.mdx} (98%) rename src/pages/docs/ai-transport/guides/langgraph/{lang-graph-message-per-token.mdx => langgraph-message-per-token.mdx} (99%) diff --git a/src/data/nav/aitransport.ts b/src/data/nav/aitransport.ts index 2c62b22219..6bf34963ed 100644 --- a/src/data/nav/aitransport.ts +++ b/src/data/nav/aitransport.ts @@ -140,11 +140,11 @@ export default { pages: [ { name: 'Message per response', - link: '/docs/ai-transport/guides/langgraph/lang-graph-message-per-response', + link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-response', }, { name: 'Message per token', - link: '/docs/ai-transport/guides/langgraph/lang-graph-message-per-token', + link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-token', }, { name: 'Human-in-the-loop', diff --git a/src/pages/docs/ai-transport/guides/anthropic/anthropic-citations.mdx b/src/pages/docs/ai-transport/guides/anthropic/anthropic-citations.mdx index 1533e4b683..810c7e3202 100644 --- a/src/pages/docs/ai-transport/guides/anthropic/anthropic-citations.mdx +++ b/src/pages/docs/ai-transport/guides/anthropic/anthropic-citations.mdx @@ -27,7 +27,7 @@ Useful links: - [Anthropic Citations documentation](https://docs.anthropic.com/en/docs/build-with-claude/citations) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the agent and client code: +Create a new Node project, which will contain the agent and client code: ```shell diff --git a/src/pages/docs/ai-transport/guides/anthropic/anthropic-human-in-the-loop.mdx b/src/pages/docs/ai-transport/guides/anthropic/anthropic-human-in-the-loop.mdx index c14bc31a42..5be5036d54 100644 --- a/src/pages/docs/ai-transport/guides/anthropic/anthropic-human-in-the-loop.mdx +++ b/src/pages/docs/ai-transport/guides/anthropic/anthropic-human-in-the-loop.mdx @@ -25,7 +25,7 @@ Useful links: - [Anthropic tool use guide](https://docs.anthropic.com/en/docs/build-with-claude/tool-use/overview) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the agent, client, and server code: +Create a new Node project, which will contain the agent, client, and server code: ```shell diff --git a/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-response.mdx b/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-response.mdx index 3005598a3b..387c5c97fc 100644 --- a/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-response.mdx +++ b/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-response.mdx @@ -42,7 +42,7 @@ Useful links: ### Agent setup -Create a new npm package for the agent code: +Create a new Node project for the agent code: ```shell @@ -109,7 +109,7 @@ export ANTHROPIC_API_KEY="your_api_key_here" ### Client setup -Create a new npm package for the client code, or use the same project as the agent if both are JavaScript: +Create a new Node project for the client code, or use the same project as the agent if both are JavaScript: ```shell diff --git a/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-token.mdx b/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-token.mdx index 56fa661b62..12e139f103 100644 --- a/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-token.mdx +++ b/src/pages/docs/ai-transport/guides/anthropic/anthropic-message-per-token.mdx @@ -42,7 +42,7 @@ Useful links: ### Agent setup -Create a new npm package for the agent code: +Create a new Node project for the agent code: ```shell @@ -109,7 +109,7 @@ export ANTHROPIC_API_KEY="your_api_key_here" ### Client setup -Create a new npm package for the client code, or use the same project as the agent if both are JavaScript: +Create a new Node project for the client code, or use the same project as the agent if both are JavaScript: ```shell diff --git a/src/pages/docs/ai-transport/guides/langgraph/lang-graph-message-per-response.mdx b/src/pages/docs/ai-transport/guides/langgraph/langgraph-message-per-response.mdx similarity index 98% rename from src/pages/docs/ai-transport/guides/langgraph/lang-graph-message-per-response.mdx rename to src/pages/docs/ai-transport/guides/langgraph/langgraph-message-per-response.mdx index 3fb7968ce4..4c27f5cc39 100644 --- a/src/pages/docs/ai-transport/guides/langgraph/lang-graph-message-per-response.mdx +++ b/src/pages/docs/ai-transport/guides/langgraph/langgraph-message-per-response.mdx @@ -3,8 +3,8 @@ title: "Guide: Stream LangGraph responses using the message-per-response pattern meta_description: "Stream tokens from LangGraph over Ably in realtime using message appends." meta_keywords: "AI, token streaming, LangGraph, LangChain, Anthropic, AI transport, Ably, realtime, message appends" redirect_from: - - /docs/guides/ai-transport/lang-graph-message-per-response - - /docs/guides/ai-transport/langgraph/lang-graph-message-per-response + - /docs/guides/ai-transport/langgraph-message-per-response + - /docs/guides/ai-transport/langgraph/langgraph-message-per-response --- This guide shows you how to stream AI responses from [LangGraph](https://docs.langchain.com/oss/javascript/langgraph/overview) over Ably using the [message-per-response pattern](/docs/ai-transport/token-streaming/message-per-response). Specifically, it appends each response token to a single Ably message, creating a complete AI response that grows incrementally while delivering tokens in realtime. @@ -26,7 +26,7 @@ Useful links: - [LangGraph documentation](https://docs.langchain.com/oss/javascript/langgraph/overview) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the publisher and subscriber code: +Create a new Node project, which will contain the publisher and subscriber code: ```shell diff --git a/src/pages/docs/ai-transport/guides/langgraph/lang-graph-message-per-token.mdx b/src/pages/docs/ai-transport/guides/langgraph/langgraph-message-per-token.mdx similarity index 99% rename from src/pages/docs/ai-transport/guides/langgraph/lang-graph-message-per-token.mdx rename to src/pages/docs/ai-transport/guides/langgraph/langgraph-message-per-token.mdx index 164d864505..27796b8ffa 100644 --- a/src/pages/docs/ai-transport/guides/langgraph/lang-graph-message-per-token.mdx +++ b/src/pages/docs/ai-transport/guides/langgraph/langgraph-message-per-token.mdx @@ -3,8 +3,8 @@ title: "Guide: Stream LangGraph responses using the message-per-token pattern" meta_description: "Stream tokens from LangGraph over Ably in realtime." meta_keywords: "AI, token streaming, LangGraph, LangChain, Anthropic, AI transport, Ably, realtime" redirect_from: - - /docs/guides/ai-transport/lang-graph-message-per-token - - /docs/guides/ai-transport/langgraph/lang-graph-message-per-token + - /docs/guides/ai-transport/langgraph-message-per-token + - /docs/guides/ai-transport/langgraph/langgraph-message-per-token --- This guide shows you how to stream AI responses from [LangGraph](https://docs.langchain.com/oss/javascript/langgraph/overview) over Ably using the [message-per-token pattern](/docs/ai-transport/token-streaming/message-per-token). Specifically, it implements the [explicit start/stop events approach](/docs/ai-transport/token-streaming/message-per-token#explicit-events), which publishes each response token as an individual message, along with explicit lifecycle events to signal when responses begin and end. diff --git a/src/pages/docs/ai-transport/guides/openai/openai-citations.mdx b/src/pages/docs/ai-transport/guides/openai/openai-citations.mdx index 9779f99e8b..795a0b4736 100644 --- a/src/pages/docs/ai-transport/guides/openai/openai-citations.mdx +++ b/src/pages/docs/ai-transport/guides/openai/openai-citations.mdx @@ -27,7 +27,7 @@ Useful links: - [OpenAI Web Search documentation](https://platform.openai.com/docs/guides/tools-web-search) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the publisher and subscriber code: +Create a new Node project, which will contain the publisher and subscriber code: ```shell diff --git a/src/pages/docs/ai-transport/guides/openai/openai-human-in-the-loop.mdx b/src/pages/docs/ai-transport/guides/openai/openai-human-in-the-loop.mdx index 51a3a49084..7e24d6c272 100644 --- a/src/pages/docs/ai-transport/guides/openai/openai-human-in-the-loop.mdx +++ b/src/pages/docs/ai-transport/guides/openai/openai-human-in-the-loop.mdx @@ -25,7 +25,7 @@ Useful links: - [OpenAI function calling guide](https://platform.openai.com/docs/guides/function-calling) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the agent, client, and server code: +Create a new Node project, which will contain the agent, client, and server code: ```shell diff --git a/src/pages/docs/ai-transport/guides/openai/openai-message-per-response.mdx b/src/pages/docs/ai-transport/guides/openai/openai-message-per-response.mdx index d35cdcd803..dcd17dd198 100644 --- a/src/pages/docs/ai-transport/guides/openai/openai-message-per-response.mdx +++ b/src/pages/docs/ai-transport/guides/openai/openai-message-per-response.mdx @@ -26,7 +26,7 @@ Useful links: - [OpenAI developer quickstart](https://platform.openai.com/docs/quickstart) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the publisher and subscriber code: +Create a new Node project, which will contain the publisher and subscriber code: ```shell diff --git a/src/pages/docs/ai-transport/guides/openai/openai-message-per-token.mdx b/src/pages/docs/ai-transport/guides/openai/openai-message-per-token.mdx index fbd352dc5c..b561ad8f3a 100644 --- a/src/pages/docs/ai-transport/guides/openai/openai-message-per-token.mdx +++ b/src/pages/docs/ai-transport/guides/openai/openai-message-per-token.mdx @@ -26,7 +26,7 @@ Useful links: - [OpenAI developer quickstart](https://platform.openai.com/docs/quickstart) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the publisher and subscriber code: +Create a new Node project, which will contain the publisher and subscriber code: ```shell diff --git a/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-response.mdx b/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-response.mdx index 2a549bd7ec..205b64fa82 100644 --- a/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-response.mdx +++ b/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-response.mdx @@ -27,7 +27,7 @@ Useful links: - [Vercel AI SDK documentation](https://ai-sdk.dev/docs) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the publisher and subscriber code: +Create a new Node project, which will contain the publisher and subscriber code: ```shell diff --git a/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-token.mdx b/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-token.mdx index 89fc558354..ddebb3ac7b 100644 --- a/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-token.mdx +++ b/src/pages/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-token.mdx @@ -27,7 +27,7 @@ Useful links: - [Vercel AI SDK documentation](https://ai-sdk.dev/docs) - [Ably JavaScript SDK getting started](/docs/getting-started/javascript) -Create a new NPM package, which will contain the publisher and subscriber code: +Create a new Node project, which will contain the publisher and subscriber code: ```shell diff --git a/src/pages/docs/ai-transport/index.mdx b/src/pages/docs/ai-transport/index.mdx index 083276f1ff..dfcde0ab47 100644 --- a/src/pages/docs/ai-transport/index.mdx +++ b/src/pages/docs/ai-transport/index.mdx @@ -107,13 +107,13 @@ Use the following guides to get started with LangGraph: title: 'Message-per-response', description: 'Stream LangGraph responses using message appends', image: 'icon-tech-javascript', - link: '/docs/ai-transport/guides/langgraph/lang-graph-message-per-response', + link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-response', }, { title: 'Message-per-token', description: 'Stream LangGraph responses using individual token messages', image: 'icon-tech-javascript', - link: '/docs/ai-transport/guides/langgraph/lang-graph-message-per-token', + link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-token', }, { title: 'Human-in-the-loop',