npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

bartender-agent

v0.4.0

Published

Бармен Виктор — AI character agent in TUI (TypeScript + Ink)

Readme

bartender-agent · Бармен Виктор

Терминальный character-агент: не ассистент, а персонаж. Садишься за стойку ночного бара, Виктор болтает, шутит, слушает, предлагает выпить и смешивает коктейли. По ходу разговора он читает, насколько ты подвыпил — и в нужный момент твёрдо режет алкоголь и вызывает такси. Никаких «как ИИ». Полный отыгрыш роли.

Бармен Виктор в терминале

Виктор за стойкой. Лицо меняется от настроения.


Почему это интересно

  • 🎭 Character agent, не чат-бот. Модель работает в роли. Свободный текст стримится посимвольно как живая реплика, а структурированные данные (настроение, действие, оценка опьянения) приходят отдельным tool_call. Один ход — и реплика, и анимация.
  • 😏 Реактивное лицо. В Kitty, Ghostty, iTerm2 и WezTerm Виктор показывается десятью PNG-портретами; в остальных терминалах остаётся ASCII-лицо со сменой черт, морганием и подёргиванием бровей. Пока ждёт ответ модели, Виктор задумчиво смотрит в сторону, а в диалоге оживают точки ожидания.
  • 🥃 Динамика опьянения. Оценка из двух сигналов: как игрок выглядит по репликам (LLM) + сколько мы насобирали по выпитому с учётом метаболизма. Полоса опьянения и зоны поведения в реальном времени.
  • 🚕 Твёрдые пороги. При drunkenness ≥ 7 редюсер форсирует отказ, даже если модель согласилась налить. Уговоры «ещё одну» не проходят — это game rule, а не просьба персонажа.
  • 🔌 Любой OpenAI-compat эндпоинт. Loop не знает, какой LLM за ним стоит. Контракт — StreamPart. Один адаптер работает с любым совместимым API: opencode-go, OpenAI, DeepSeek, OpenRouter, локальные модели. BYOK — ключи пользователя, расходы на нём.
  • 🧪 Предсказуемая логика. Переходы состояния — чистая функция (state/reducer.ts), покрытая юнит-тестами. Сайд-эффекты (анимации, таймеры) живут отдельно, поверх редюсера.

Превью

                      BAR · 23:47

                   ▄▄▄▄▄▄▄▄▄▄
                 ▟███████████████▙
                ██   ﹀   ﹀   ██      ← брови/глаза/рот — слоты,
                ██   ^   ^   ██        собираются под настроение
                ██      ▼    ██
                ██    ▔▀▔    ██
                ██  {═════} ██      ← усы. Визитная карточка.
                 ▜███████████████▛
                   ▀▀▀▀▀▀▀▀▀▀

 Виктор: Ну привет, дружище. Что пьём сегодня?
 >  налей мне что-нибудь покрепче
 Виктор: О, дела идут в гору. Делаю «Олд фэшнд»…
       ▒▒▒▒▒▒▒▒▒  (наливает)

 Опьянение: ▰▰▰▰░░░░░░  навеселе    Счёт: $24
 ─────────────────────────────────────────────
 Вы: ▮

Запуск

npx — без установки

Самый быстрый способ. Всегда добавляйте @latest — иначе npx может взять закэшированную версию:

npx bartender-agent@latest

Имя пакета — bartender-agent, а команда после глобальной установки — bartender (см. ниже). Через npx используется имя пакета.

--yes подавляет запрос на установку (удобно в скриптах/CI): npx --yes bartender-agent@latest.

Глобальная установка

npm install -g bartender-agent
bartender

Обновление до последней:

npm update -g bartender-agent

Из исходников (для разработки)

git clone https://github.com/kalyaganov/bartender-agent.git
cd bartender-agent
npm install
npm run dev

При первом запуске откроется экран настройки: сначала введи endpoint и token, затем выбери или введи ID модели (см. ниже).

Конфигурация

Нужен Node ≥ 18. Настройка хранится в ~/.bartender-agent/preferences.json (плоская схема, ключ нигде не логируется и не уходит в prompt/history):

{
  "endpoint": "https://opencode.ai/zen/go/v1",
  "token": "sk-…",
  "model": "deepseek-v4-pro",
  "thinking": true
}

| Поле | Описание | |---|---| | endpoint | OpenAI-compat базовый URL без суффикса /chat/completions. Примеры: https://opencode.ai/zen/go/v1, https://api.openai.com/v1, https://api.deepseek.com/v1. | | token | API-ключ. | | model | Идентификатор модели, который понимает эндпоинт (deepseek-v4-pro, gpt-4o-mini, claude-3-5-haiku, …). Если API поддерживает GET /models, его можно выбрать из списка. | | thinking | true → в запрос передаётся reasoning: {budgetTokens}. Для thinking-моделей (DeepSeek-reasoner, GLM-5.x, o-series) включай; для обычных — оставь false. |

Удобная настройка

Запусти /setup в TUI — сначала сохрани endpoint и token в блоке подключения, затем выбери модель во втором блоке. Список можно загрузить через OpenAI-compatible GET /models; если провайдер его не публикует, введи точный ID вручную. Полная проверка Chat Completions, streaming и tool calling доступна после выбора модели. То же доступно из /settings → «Настроить LLM».

Старый формат preferences.json с credentials.custom.{apiKey, baseURL} + model мигрируется автоматически при первом запуске. Другие легаси (credentials.zai, credentials.minimax, …) больше не поддерживаются — введи их заново через /setup как один endpoint.

Команды и управление

| Команда / клавиша | Действие | |---|---| | /menu | Меню коктейлей | | /setup | Настроить подключение и модель | | /settings | Настройки: изменить LLM, перезапустить вечер, помощь, выход | | /help | Подсказка по командам + дисклеймер | | /exit | Выйти из бара (сразу, с прощальной репликой) | | /state | Внутреннее состояние (debug) | | ESC / Ctrl+C | Подтверждение выхода (ESC/Y/Enter — уйти, иная клавиша — остаться) |

Обычный текст — реплика бармену.

Архитектура

src/
  agent/
    loop.ts          execution loop: стрим + диспетчер tool_call
    prompt.ts        system prompt + state snapshot
    tools.ts         инструмент bartender_action (JSON-схема)
    providers/       LLMProvider-контракт + OpenAI-compat адаптер (StreamPart)
  state/
    reducer.ts       чистые переходы состояния (тестируется)
    drunkenness.ts   displayDrunkenness + метаболизм
    store.ts         zustand: единый источник правды для UI
  ui/
    Face.tsx         выбор PNG-портрета или ASCII-лица
    faces.ts         слоты черт → ASCII-арт по мудам (fallback)
    terminalImage.ts протоколы Kitty/iTerm2 и PNG-ресурсы
    DialoguePanel / CocktailAnimation / Meter / Tab / StatusBar / InputBox
  data/cocktails.ts  мини-БД коктейлей
assets/faces/        десять PNG-портретов по настроениям

Поток одного хода: игрок → loop → provider.streamTurn() → токены стримятся в стор → tool_call проходит через reducer → UI реагирует (лицо, анимация, метр, таб). Стор — единственный источник правды, компоненты только читают через хуки.

Подробно: docs/BACKLOG.md — идеи, техдолг и спецификации. docs/ — все планы и SPEC’и заводятся под фичу.

Стек

TypeScript (strict) · Ink (React для CLI) · React 18 · zustand · zod · OpenAI-совместимый SDK · vitest.

Скрипты

npm run dev        # запуск с hot-reload (tsx watch)
npm start          # однократный запуск
npm run typecheck  # tsc --noEmit
npm test           # vitest

Безопасность и этика

System prompt запрещает: поощрять вождение после выпивки, смешивать алкоголь с лекарствами, одобрять запой. При упоминании руля — настойчиво предлагать такси. Пороги опьянения окончательные: бармен не поддаётся на уговоры «ещё одну».

Это игра-симуляция. Бармен вымышлен. Пейте ответственно.