Пакет может доставлять программы: инструменты командной строки, которые собираются при установке, или сервер, с которым говорит ваш агент. Эта страница объявляет и то и другое, собирает их в собственной папке пакета и объясняет, почему сервер закрепляет точную версию инструментов, которые обслуживает.
Агент размечает слот пакета через `vibe init package`, кладёт внутрь крейт, добавляет таблицу `[[binary]]` с именем инструмента и папкой крейта и ставит пакет в проект из собственного [реестра](../glossary/index.xml#registry) проекта. Он выполняет `vibe bin build`: команда спрашивает согласия и делает release-сборку внутри собственного workspace пакета. Затем он выполняет `vibe bin exec`: команда разрешает инструмент через [лок-файл](../glossary/index.xml#lock-file) проекта до артефакта ровно той версии, что установлена, и запускает его. Потребители получают то же: установка пакета материализует его исходник, сборка при первом использовании производит инструмент рядом с ним, и артефакт никогда не попадает в [отпечаток](../glossary/index.xml#fingerprint) пакета.
Пакет — это проект, который сделали устанавливаемым, поэтому он может нести произвольный код в корне рядом с `vibevm/vibespecs/`: Cargo-workspace, крейты, тесты. Поставляемое дерево — исходник минус результаты сборки; `target/`, `node_modules/` и всё из `.vibeignore` никуда не едут. Потребители получают исходник и собирают его сами, и потому идентичность остаётся свойством того, что закоммитил автор.
Пакет с кодом держит собственный [манифест](../glossary/index.xml#manifest) workspace, а потребитель, который сам Rust-проект, исключает дерево зависимостей из своего workspace, чтобы две сборки никогда не столкнулись.
Каждый инструмент — одна запись `[[binary]]`: `name`, уникальное в пакете, и `crate`, папка внутри поставляемого дерева с `Cargo.toml`. `vibe bin list` показывает, что объявляют установленные пакеты, `vibe bin build` собирает названные инструменты или все, `vibe bin path` печатает расположение артефакта, а `vibe bin exec <name> -- <args>` запускает его через лок-файл. Сборка выполняет скрипты сборки пакета, поэтому в первый раз она спрашивает согласия, как установка.
`name` уникально внутри пакета и должно быть защищено от столкновений между пакетами, что бесплатно даёт префикс [семейства](../glossary/index.xml#family). `crate` называет папку внутри поставляемого дерева с Cargo-пакетом, чей бинарник называется ровно `name`.
Пакет вида `mcp` доставляет сервер, с которым говорит агент: одну или несколько таблиц `[[mcp_server]]`, каждая называет бинарник, который его обслуживает, и его аргументы. Сервер собирается как любой бинарник и регистрируется в конфигурациях агентов командой `vibe mcp install` рядом с собственным сервером vibe. Собранный, он работает без vibe: агент запускает артефакт напрямую.
Сервер, который обслуживает тулчейн другого пакета, например ворота языковой дисциплины, обязан требовать этот пакет точным пином, `=X.Y.Z`. Движки за инструментами агента и ворота, которые запускает потребитель, должны разрешаться в один набор версий: один движок, одна истина, и обеспечивает это резолвер, а не протокол.
Вид обещает сервер: манифест `mcp` без таблицы `[[mcp_server]]` отвергается. Сервер — один из собственных бинарников пакета, поэтому `binary` обязан назвать `[[binary]]` того же манифеста, а его доставка, согласие и устаревание следуют механике бинарников. В `args` единственная подстановка — `{project_root}`, разрешаемая при регистрации; неизвестный токен отвергается.
Пакет может выполнить скрипт при установке. `[hooks]` называет базовый путь без расширения, а пакет поставляет `<base>.sh`, `<base>.ps1` или оба; раннер выбирает подходящий хосту. `pre-install` выполняется, как только папка пакета готова, и до того, как vibe ею воспользуется; `post-install` выполняется после того, как установка стала долговечной, с записанным локом и перегенерированными стартовыми файлами. Рабочая папка — собственная папка пакета в дереве зависимостей, а окружение называет группу, имя, версию, вид и папку пакета и который из двух моментов сейчас. Правки [хука](../glossary/index.xml#hook) в файлах, которыми владеет vibe, эфемерны: переустановка или обновление восстанавливает эти байты и выполняет хук снова.
Артефакт инструмента принадлежит ровно той версии, что установлена; после обновления старому артефакту не доверяют, и следующий `vibe bin exec` сначала собирает новую версию.
Для сборки нужны собственные источники пакетов языка, для Rust — crates.io, если они не вендорены; офлайн-сборка говорит об этом, а не притворяется.
Таблица `[[mcp_server]]` законна только в пакетах вида `mcp`; пакет `tool` поставляет бинарники, но не серверы.
`.vibeignore` в корне пакета добавляет глобы к списку результатов сборки, которые никогда не попадают в поставляемое дерево.