Initial commit: LangChain evolution tutorial deck (132 slides)

- Cover, TOC, 5 dividers, 3 recap slides - 5 sections (chains, langgraph, deepagents, openswe, ecosystem) - design-system.js with theme tokens + 9 helper functions - research/: timeline + sources + per-tech notes - final-compile.js + merge.js for rebuild pipeline - output/: langchain-evolution.pptx (2.3 MB) + langchain-evolution.pdf (1.1 MB) + 7 sample previews
2026-06-22 11:29:03 +03:00
parent ed5b5c91bf
commit 75601988c2
220 changed files with 13069 additions and 3 deletions
@@ -0,0 +1,207 @@
+# Timeline: LangChain / LangGraph / Deep Agents / Open SWE / LangSmith
+
+Единый таймлайн релизов и ключевых изменений. Покрытие: только стабильные релизы ≥ 1.0.0 или те, что определили архитектуру сегодняшней экосистемы. Устаревшие API помечены явно.
+
+Дата отсчёта: 2026-06-22.
+
+---
+
+## 2022-10 — рождение LangChain
+
+- **2022-10**: Harrison Chase публикует первый коммит LangChain как open-source фреймворк для оркестрации LLM.
+- Источник: README `langchain-ai/langchain` упоминает Harrison Chase как основателя; широко подтверждено в CSDN-обзорах 0.1 (2024-01).
+
+---
+
+## 2023-10 — LangChain 0.0.x (пред-стабильная эпоха)
+
+- Линейка `0.0.x` (добралась до `0.0.354` к январю 2024). Нестабильное API, частые breaking changes, отсутствие semver-гарантий.
+- LangChain становится самым быстрорастущим OSS-проектом на GitHub.
+- **Важно для презентации:** все API из этой эпохи (LLMChain, ConversationChain, AgentExecutor из langchain.agents, старые RetrievalQA) — **DEPRECATED**, перенесены в `langchain-classic` начиная с v1.0.
+
+---
+
+## 2024-01-08 — LangChain 0.1.0 (первый стабильный minor)
+
+- **Дата релиза:** 8 января 2024.
+- **Главные изменения:**
+  - Разделение монолита на `langchain-core` (ядро, стабильный API) + `langchain` (оркестрация) + `langchain-community` (700+ интеграций).
+  - LCEL (LangChain Expression Language) — `Runnable`-протокол: `invoke / stream / batch / async`.
+  - Семантическое версионирование с этого момента.
+  - Тесная интеграция с LangSmith для трассировки.
+  - Одновременно анонсирован LangGraph как «One More Thing» — граф-рантайм с поддержкой циклов для агентов.
+- **Источники:** blog.langchain.com (пост `langchain-v0-1-0`), changelog.langchain.com (анонс января 2024).
+
+---
+
+## 2024-05 — LangChain 0.2
+
+- Стандартизация единого интерфейса вызова (`invoke`).
+- Миграционные скрипты: `langchain-cli migrate`.
+- Сложные агенты рекомендовано строить на LangGraph.
+- Удалены устаревшие entry points (`predict_messages` и подобные).
+- **Источник:** CSDN-обзор «LangChain从零到一:版本演进、架构设计与实战指南» (blog.csdn.net/2401_84815887), блогпост v0.1.
+
+---
+
+## 2024-09 — LangChain 0.3
+
+- Финальная версия перед 1.0 в линейке 0.x.
+- Полная миграция на Pydantic v2 во всех пакетах.
+- Удаление Python 3.8 из supported.
+- Чистка deprecations, подготовка к 1.0.
+- **Примечание:** точная дата не указана в официальных changelog как «релиз 0.3», известно из changelog-ленты `changelog.langchain.com/?date=2024-09-*` и обзоров; пометка в README как «streamlined surface area».
+
+---
+
+## 2024-08 — первые следы LangGraph 0.x как production-ready
+
+- LangGraph вышел из «One More Thing» в полноценный фреймворк.
+- Ключевые абстракции: `StateGraph`, `add_node`, `add_edge`, `add_conditional_edges`, checkpoint-ы, threads.
+- Документация подтверждает, что LangGraph — низкоуровневый оркестратор, LangChain — поверх.
+
+---
+
+## 2025-08-21 — Open SWE анонс (пред-1.0)
+
+- **Дата:** 21 августа 2025 (по дате публикации статьи LangChain, через InfoQ/腾讯云 репост).
+- **Что вышло:** Open SWE — open-source асинхронный кодинг-агент, работающий в облачных песочницах (Daytona).
+- **Архитектура:** Manager + Planner + Programmer + Reviewer.
+- **Запуск:** через GitHub Issues, Web UI.
+- **License:** MIT.
+- **Источник:** `blog.langchain.com/open-swe-an-open-source-framework-for-internal-coding-agents` (переработанный блог-пост от 17 марта 2026, изначальный анонс — август 2025, см. README GitHub `langchain-ai/open-swe` со ссылкой на анонс-пост).
+
+---
+
+## 2025-08 — Deep Agents 0.x (первая публичная версия)
+
+- Публичный дебют библиотеки `deepagents` от LangChain.
+- Вдохновлена Claude Code, Deep Research, Manus.
+- Архитектура: planning tool + filesystem backend + subagents на базе LangGraph.
+- **Источник:** README `langchain-ai/deepagents` упоминает «inspired by Claude Code»; CSDN DeepAgents-обзор от августа 2025; блогпост «Building Production-Ready Deep Agents with LangChain 1.0» (Medium).
+
+---
+
+## 2025-09 — Deep Agents CLI
+
+- Анонс DeepAgents CLI — pre-built кодинг-агент для терминала, аналог Claude Code/Cursor.
+- Установка: `curl -LsSf https://langch.in/dcode | bash`.
+- **Источник:** blog.langchain.com/introducing-deepagents-cli.
+
+---
+
+## 2025-09 — LangChain & LangGraph 1.0 alpha
+
+- **Дата:** конец сентября 2025 (пост Harrison Chase в X от 01.09.2025: `x.com/hwchase17/status/1962935384490565926`).
+- Alpha-релизы для сбора обратной связи.
+- **Источники:** blog.langchain.com/langchain-langchain-1-0-alpha-releases, форум forum.langchain.com/t/langchain-1-0-alpha-feedback-wanted/1436.
+
+---
+
+## 2025-10-20 — LangChain 1.0 GA
+
+- **Дата релиза:** 20-22 октября 2025 (changelog.langchain.com и blog.langchain.com указывают 22.10.2025, CSDN-обзоры и китайские источники — 20.10.2025).
+- **Что нового в 1.0:**
+  - **create_agent abstraction** — единая функция для создания агента поверх LangGraph-рантайма.
+  - **Middleware system** — fine-grained контроль на каждом шаге цикла агента. Built-in: human-in-the-loop, summarization, PII redaction. Custom middleware поддерживается.
+  - **Improved structured output** — интегрирован в основной цикл, без extra LLM-вызовов.
+  - **Standard content blocks** — провайдер-агностичная спецификация для выходов моделей (reasoning traces, citations, server-side tool calls).
+  - **Legacy → langchain-classic:** LLMChain, ConversationalRetrievalQAChain, RetrievalQAChain, AgentExecutor (legacy), старые chains. Доступны через отдельный пакет `@langchain/classic`.
+  - **Стабильность:** semver-обязательство — никаких breaking changes до 2.0.
+- **Покрытие звёздами:** на дату snapshot README `langchain-ai/langchain` — 140k stars.
+- **Источники:** changelog.langchain.com/announcements/langchain-1-0-now-generally-available, blog.langchain.com/langchain-langgraph-1dot0, Medium «Building Deep Agents with LangChain 1.0», Microsoft TechCommunity «LangChain v1 is now generally available».
+
+---
+
+## 2025-10-22 — LangGraph 1.0 GA
+
+- **Дата релиза:** 22 октября 2025.
+- **Что нового в 1.0:**
+  - **Durable state** — состояние графа персистится автоматически. При падении сервера посреди долгого диалога — восстановление ровно с точки остановки.
+  - **Built-in persistence** — сохранение/возобновление в любой точке без своей DB-логики. Multi-day approvals, background jobs.
+  - **Human-in-the-loop first-class API** — пауза для human review / modification / approval.
+  - **Graph-based execution model** — для смеси детерминированных и агентных компонентов.
+  - **Deprecation:** `langgraph.prebuilt` deprecated, функционал перенесён в `langchain.agents` (create_react_agent → create_agent).
+  - **API stability:** без breaking changes до 2.0.
+- **Звёзды на snapshot:** 35.4k stars.
+- **Источники:** changelog.langchain.com/announcements/langgraph-1-0-is-now-generally-available, blog.langchain.com/langchain-langgraph-1dot0.
+
+---
+
+## 2025-10 — Deep Agents 1.0 (синхронно с LangChain 1.0)
+
+- **Дата:** октябрь 2025 (синхронизировано с LangChain 1.0).
+- **Версия на PyPI (snapshot 2026-06):** `deepagents==0.6.11` (latest). То есть формально major 1.0 для deepagents-пакета **не зафиксирован** на дату snapshot — продолжает нумерацию 0.x.
+- **Что изменилось:** полная интеграция с LangChain 1.0 middleware-системой; `create_deep_agent` теперь принимает middleware как first-class параметр.
+- **Важно:** README явно говорит «inspired by Claude Code: identify what makes it general-purpose, push further».
+- **Источник:** README `langchain-ai/deepagents`, pypi.org/project/deepagents, Medium «Building Production-Ready Deep Agents with LangChain 1.0's Middleware Architecture».
+
+---
+
+## 2025-12 — Open SWE первый релиз
+
+- **Дата:** декабрь 2025 — формальная пометка в сторонних обзорах (LangChain Facebook, Agent Harness Engineering Survey).
+- **Версия:** стабильный репозиторий `langchain-ai/open-swe`, 971+ коммитов, 10k stars на snapshot 2026-06.
+- **Ключевая публикация блог-поста:** первоначальный анонс от августа 2025 (см. выше), переработанный пост от 2026-03-17.
+- **Текущая архитектура:** Manager/Planner/Programmer/Reviewer → переработано в единый `create_deep_agent` harness + subagents + middleware.
+- **Триггеры:** Slack, Linear, GitHub.
+- **Песочницы:** Modal, Daytona, Runloop, LangSmith.
+- **License:** MIT.
+- **Источник:** README `langchain-ai/open-swe`, blog.langchain.com/open-swe-an-open-source-framework-for-internal-coding-agents.
+
+---
+
+## 2026-01 — LangSmith v0.x (Self-Hosted)
+
+- **Дата:** январь 2026 — LangSmith Self-Hosted v0.9 (по changelog.langchain.com от 21.01.2025 — обратите внимание, эта конкретная пометка относится к январю 2025; точная дата следующего релиза — конец 2025 / начало 2026).
+- **Текущая стабильная версия Python SDK:** `langsmith==0.8.9` (latest на reference.langchain.com snapshot).
+- **Важно:** LangSmith SDK не следует semver 1.0+, продолжает развитие в 0.x с пометкой «Since v0.1». Это платформа (SaaS + self-hosted), а не open-source фреймворк, поэтому major 1.0 для неё не объявлен.
+- **Источники:** reference.langchain.com/python/langsmith/version, changelog.langchain.com (категория `cat_ZWTyLBFVqdtSq`), pypi.org/project/langsmith.
+
+---
+
+## 2026-Q1 — LangGraph 1.2.x
+
+- Текущая версия на PyPI snapshot 2026-06: `langgraph==1.2.6` (от 18.06.2026).
+- В 1.2 появились: fault tolerance (retries / timeouts / error handlers), улучшенные middleware, дополнительная стабилизация типов.
+- **Источники:** blog.langchain.com/fault-tolerance-in-langgraph (04.06.2026), GitHub Releases `langchain-ai/langgraph/releases/tag/1.2.6`.
+
+---
+
+## 2026-06 — текущее состояние
+
+- **langchain (Python):** latest stable ≈ 1.3.10 / 1.4.8 (по GitHub releases `langchain-ai/langchain/releases`, jun 2026).
+- **langchain-core:** latest stable 1.4.8 (от 18.06.2026).
+- **langgraph:** latest stable 1.2.6 (от 18.06.2026).
+- **deepagents:** latest stable 0.6.11 (от 18.06.2026) — major 1.0 пока не выпущен, продолжает нумерацию 0.x.
+- **open-swe:** active development, 971+ коммитов, без формальных релизов на PyPI (это приложение, не библиотека).
+- **langsmith:** Python SDK 0.8.9 (без 1.0).
+- **Источник:** GitHub Releases pages для каждого репозитория + PyPI version badges на README.
+
+---
+
+## Что НЕ стабильно / устарело (важно для презентации)
+
+| API | Статус | Замена |
+|---|---|---|
+| `langchain.chains.LLMChain` | DEPRECATED → `langchain-classic` | LCEL `prompt \| model \| parser` |
+| `langchain.chains.ConversationalRetrievalQAChain` | DEPRECATED → `langchain-classic` | LangGraph retrieval-graph |
+| `langchain.chains.RetrievalQAChain` | DEPRECATED → `langchain-classic` | LangGraph retrieval-graph |
+| `langchain.agents.AgentExecutor` (legacy) | DEPRECATED → `langchain-classic` | `langchain.agents.create_agent` (v1.0+) |
+| `langchain.agents.create_react_agent` | DEPRECATED → перенесён в `langchain-classic` | `langchain.agents.create_agent` |
+| `langgraph.prebuilt.create_react_agent` | DEPRECATED | `langchain.agents.create_agent` |
+| `langchain.llms.LLM` (legacy interface) | DEPRECATED | `init_chat_model` (v1.0+) |
+| `langchain.prompts.PromptTemplate` (старый) | DEPRECATED для некоторых use-cases | `ChatPromptTemplate` |
+
+**Источник:** @langchain/classic npm-описание, GitHub Issue `langchain-ai/langchain/issues/33933`, docs.langchain.com/oss/python/migrate/langchain-v1.
+
+---
+
+## TL;DR для презентации
+
+- **2024-01**: LangChain 0.1 — стабилизация монолита.
+- **2024-05**: LangChain 0.2 — унификация API.
+- **2025-08**: Deep Agents и Open SWE — агенты нового поколения.
+- **2025-10-20**: LangChain 1.0 — production-ready агенты.
+- **2025-10-22**: LangGraph 1.0 — durable execution API.
+- **2026**: итерации 1.2 / 1.3 / 1.4 в рамках стабильной ветки 1.x.