用途：在 TypeScript 中构建 LangChain.js v1 与 LangGraph.js 应用，先选定一条实现路径再编码，保持主干精简，只加载该路径所需的参考文件。
主要能力：支持用 langchain 的 createAgent 与 Zod 类型工具构建工具调用助手；用文档加载器、切分器、嵌入、向量库与检索器搭建 RAG；用 @langchain/langgraph 的 StateGraph 编写显式状态、路由、扇出/扇入或中断；通过 withStructuredOutput、responseFormat、toolStrategy、providerStrategy 添加结构化输出；向 UI/API 流式返回 token、事件或图更新并处理取消；用 checkpointer、store 或 thread_id 记忆持久化状态；通过 @langchain/mcp-adapters 接入 MCP 服务器工具；组合 supervisor/router/handoff 多智能体或知识域智能体。
使用方式：编码前检查 package.json、运行时（Node.js 20+、TypeScript 5+）、已安装版本与提供商环境变量；可运行 scripts/check-langchain-versions.sh 做只读版本报告，用 scripts/scaffold-createagent-app.sh 生成最小 createAgent 应用。按路径加载 references 下对应文档，如 agents、rag、langgraph、providers、ops 等。
适用场景：工具调用助手、两步或智能体式 RAG、原生 LangGraph 图、结构化输出、流式 UI/API、人在回路、MCP 集成、记忆持久化、多智能体编排。
限制：仅适用于 TypeScript；Python LangChain/LangGraph 不适用；简单单提供商聊天调用应直接用提供商 SDK；运行时为 mcp-use MCPAgent 或 Effect 时应改用其他技能。生产环境不应依赖内存型 checkpointer、store、向量库或缓存；不要假设各提供商功能一致，需先验证模型、工具、结构化输出与流式支持。版本与定价等细节以官方资料为准。