Новый проект
hahhforest/pi-textbook
Онлайн-учебник и набор запускаемых checkpoint для пошаговой реализации coding agent на TypeScript: от протоколов и инструментов до Runtime и Eval.
- Stars
- ★ 1.3k ↗ +35 за 7 дней
- Forks
- ⑂ 78
- Язык
- TypeScript
- Статус
- В канале 1 янв. 1 г.
AI-разбор
Проект представляет собой учебник по пошаговой сборке Pi-style coding agent на TypeScript через 15 запускаемых checkpoint, объединённых одной цепочкой выполнения. Материал начинается с сообщений, протоколов и потоковой передачи событий, затем показывает адаптацию к Provider API, вызов инструментов и реализацию Agent Loop. Далее рассматриваются сохранение состояния, управление сессиями в виде дерева JSONL, восстановление контекста по бюджету токенов и структурированное сжатие истории. Финальные разделы посвящены ресурсам, расширениям, hooks, сборке Runtime и независимой оценке на новых fixture. Каждый этап включает текст учебника, реальный commit, целевые тесты и эксперимент с отказом; HTML-учебник находится в этом репозитории, а исполняемый код курса — в ветке другого репозитория. Проект является неофициальным общественным курсом и распространяется с раздельными условиями для кода, материалов и upstream-кода Pi.
Разработчики TypeScript, инженеры AI-agent и технические специалисты, которым нужен практический разбор внутренней архитектуры coding agent с запускаемым кодом, тестами, Git-историей и самостоятельными упражнениями.
Что внутри
- 15 последовательных checkpoint от базовых TypeScript-протоколов до полноценного Runtime и Eval
- Реализация EventStream, Message IR, ScriptedModel и адаптера между учебным протоколом и Provider API
- Контракты инструментов, Registry и executor для операций read, write, edit и bash в ограниченном workspace
- Состояние Agent, подписки, отмена, follow-up, повторный вход и хранение сессии как дерева JSONL
- Context Compaction с сохранением полной истории и восстановлением контекста в пределах бюджета токенов
- Система ресурсов и расширений с проверкой доверия, регистрацией инструментов и hooks, а также независимая оценка Runtime
Где применять
- Изучение архитектуры coding agent разработчиками, которые хотят пройти путь от протокола сообщений до рабочего цикла агента
- Практика TypeScript, потоковых событий, работы с Provider API и тестирования агентных компонентов на небольших изолированных этапах
- Создание учебных упражнений без готовых ответов с помощью checkpoint и practice для самостоятельной работы или занятий с наставником
- Разбор управления сессиями, контекстом, инструментами и расширениями перед проектированием собственного агентного Runtime
Темы