Bot Toolkit — DevOps skill for Claude Code

@primeradianthq/bot-toolkit

Reusable TypeScript core for building unattended Claude-powered chat agents.

`@primeradianthq/bot-toolkit` provides shared bot infrastructure: session storage, Claude session management, per-room workspaces, wakeups, logging, config/secrets loading, responder base classes, adapter base classes, attention tracking, task tracking, and native chat route primitives.

It does not bundle concrete Slack/Bolt or email transport adapters. Applications own their platform adapters and compose them with `BaseAdapter`, `BaseResponder`, and the toolkit's shared types.

Install

npm install @primeradianthq/bot-toolkit

For local validation before npm publication:

TARBALL=$(npm pack --silent)
npm install "./$TARBALL"

Requirements and Configuration

This package requires Node.js 20 or newer.

`loadConfig()` reads these optional environment variables:

• DATABASE_PATH: SQLite database path. Defaults to ./data/infrastructure/sessions.db.
• DATA_DIRECTORY: persistent data root for room directories and related files. Defaults to the grandparent directory of DATABASE_PATH.
• CONFIG_DIR: directory containing instance.json and secrets.json. Defaults to ~/etc/sen.
• CLAUDE_PA_DIR: application root passed through to Claude session setup.
• TZ: runtime timezone. Defaults to America/Los_Angeles.
• USE_AGENT_SDK: set to false to use CLI mode instead of Agent SDK mode.

Public Surface

import {
  BaseAdapter,
  BaseResponder,
  ClaudeSessionManagerSDK,
  ConversationOrchestrator,
  Logger,
  MessageSessionStore,
  SessionDatabase,
  getRoomDirectory,
  type BaseAdapterConfig,
  type IncomingMessage,
  type MessageOrchestrator,
  type Platform,
  type PlatformResponder,
  type SessionCallbacks,
  type WakeupPayload,
} from '@primeradianthq/bot-toolkit';

Platform Identifiers

The public `Platform` type is:

type Platform = 'slack' | 'native' | 'email';

These identifiers are u