ADK CLI v1.18.0-beta.5

Botpress ADK v1.18.0-beta.5

This release bundles the latest merged work across the ADK packages and CLI distribution pipeline.

Fixes

• fix: add support for rendering with jsx-runtime (#425)

Installation

• npm: bun add -g @botpress/adk-cli
• GitHub releases: download the matching binary from botpress/adk

ADK CLI v1.18.0-beta.4

v1.18.0-beta.3

Highlights

• Complete Dev Console redesign — topbar navigation, icon rail, command palette, global Dev/Prod environment switcher

• Full CLI-first tooling — new commands (adk check, adk status, adk logs, adk traces, adk workflows), JSON output, non-interactive mode

• Bot Secrets and environment-specific configuration variables

• Conversation lifecycle management — nudge and expiration support

• Custom component support for webchat via LLMz bridge

---

New CLI Commands & Flags

Command	Description
adk check	Offline project validation — catch config and schema errors before deploying
adk status	Project info: name, primitives, integrations (--format json for structured output)
adk logs [error|warning]	Query dev server logs, build output, and errors (--summary for condensed JSON)
adk traces [filters...]	Query trace spans for debugging conversations and workflows
adk workflows list	Discover available workflows
adk workflows inspect <name>	Get workflow input schema
adk workflows run <name> '<payload>'	Execute a workflow
adk chat --single "<message>"	Send a single message and exit (great for scripting and AI agents)
adk dev --non-interactive	Run dev server without interactive TTY (CI/agent-friendly)
adk init --format json	Non-interactive project creation with JSON input

• --format json added to adk status, adk logs, adk check, adk chat, adk traces, adk workflows for machine-readable output

• Centralized CLI logger with structured JSON support (#371)

• MCP tools deprecated as thin CLI pass-throughs — CLI commands are now the primary interface (#330)

Dev Console

Navigation overhaul:

• Sidebar replaced with compact topbar navigation with grouped views (Chat, Components, Test, Data, Observe, Config)

• Icon rail — always-visible vertical rail showing active group's sub-items

• Remembers last visited sub-view per group for quick navigation

• Agent Info moved to a modal — accessible from anywhere via ADK logo

⠀

Command Palette (⌘K):

• Recent pages, full page search, and quick commands

• Toggle theme, open bots in Botpress Cloud, copy Bot ID/Workspace ID

• Forward search queries to agent(0) copilot

• Production-aware — dev-only pages disabled in Prod mode

⠀

Global Environment Switcher (Dev ↔ Prod):

• Toggle via top-right badge or ⇧⌘E keyboard shortcut

• All views target the production agent when in Prod mode

• Dev-only views disabled with visual indicators; auto-redirect on dev-only pages

• Purple "Production Mode" pill as clear visual indicator

• Environment state synced with server, persists across reloads

⠀

New pages & views:

• Integration Hub — official Botpress integration hub component for browsing, configuring, and managing integrations

• RAG Search — redesigned with toolbar, KB filtering, and resizable split-pane layout

• Knowledge Base Finder — file drawer with search and document preview

• Files — Finder-style file browser with folder categories (All, KB, System, Webchat)

• Event Triggering — fire and replay integration events directly from the Triggers page

⠀

Visual polish:

• Warm Stone light theme for dark/light consistency

• Restyled toaster notifications

• resizable panel handles

• Skeleton shimmer loading states

• Motion transitions throughout

• Per-page error boundaries

⠀

Runtime

• Conversation lifecycle management — nudge and expiration support (#377)

• Custom component support — bridge CustomComponent with LLMz chat component system for webchat (#389, #367)

• Workflow notify — workflows can send events back to conversations via step.notify() (#349)

• action.asTool() — convert any Action to a Tool with a single method call (#295)

• Knowledge base .search() — KB instances own their search method directly (#299)

• Typed Eval class — replaces defineEval, supports multiple evals per file (#288)

• Streaming agent steps — real-time step execution streaming (#347)

• State mutation capture — trace state values and changes in agent steps (#281)

⠀

Bot Secrets & Environment Config

• Bot secrets fully wired through the ADK — configure secrets per environment (#392)

• Environment-specific configuration variables — set different config values for Dev vs Prod (#416)

• Build-time secret warnings now validate against the correct active environment (#409)

⠀

adk init Improvements

• File-based agent templates — choose from pre-built templates during init (#293)

• Auto-install ADK skills during project creation (#362)

• Inline comments in generated agent.config.ts and index.ts files (#284, #280)

• Non-interactive JSON mode for CI pipelines (#334)

• No longer reprompts for bot name when creating a new bot (#303)

• No longer requires interactive TTY (#316)

⠀

Integration Management

• Integration Hub component in Dev Console (#391)

• adk add now accepts integration IDs (#289)

• Consistent error messages for add/remove commands (#360)

• Chat integration auto-added to dependencies.json when using adk chat (#302)

• Fixed enabled-state mismatch false positives (#352)

• Correct app host for staging bot links (#353)

⠀

Agent-Friendliness (AI Coding Assistant Support)

• All major commands support --format json for structured output

• adk dev --non-interactive for headless operation

• adk chat --single for one-shot message testing

• MCP tools deprecated in favor of CLI commands

• CLI-first tooling documentation added to CLAUDE.md (#363)

⠀

Bug Fixes

• Preserve server-side plugin config during adk deploy (#415)

• step.request() now works with custom step names (#329)

• adk chat --single properly exits after receiving response (#318)

• project.cache.json parse error on first run (#319)

• Integration config migration warning now actionable in non-interactive mode (#317)

• Keep typing indicator alive during long operations (#305)

• Show error states when webchat/conversation handler missing (#331)

• Disable conversations from unsupported channels in emulator (#327)

• Don't mark website KB source as synced when 0 URLs discovered (#384)

• Clear stale component arrays on reload (#387)

• Unified adk dev stderr/stdout output streams (#324)

• adk status action count no longer confusing (#320)

• Allow patch-version compatibility between CLI and runtime (#275)

• agent.local.json used instead of agent.json to keep credentials out of git (#279)

⠀

Internal

• Shared analytics tracking across CLI and Dev Console (#297)

• Centralized CLI logger with JSON support (#371)

• Renamed internal server/process symbols for clarity (#385)

• Externalized esbuild in CLI bundle (#388)

• Removed unused CLI demo commands (#372)

⠀

Tooling

• chore: update integration hub version (#421)

Fixes

• fix: replace esbuild with Bun.build() for component bundling (#422)

Installation

• npm: bun add -g @botpress/adk-cli
• GitHub releases: download the matching binary from botpress/adk

ADK CLI v1.18.0-beta.3

see latest 1.18.0-beta.x release notes

ADK CLI v1.18.0-beta.2

see latest 1.18.0-beta.x release

ADK CLI v1.18.0-beta.1

see latest 1.18.0-beta.x release

ADK CLI v1.18.0-beta.0

see latest 1.18.0-beta.x release

ADK CLI v1.17.0

Botpress ADK v1.17.0

This release bundles the latest merged work across the ADK packages and CLI distribution pipeline.

Fixes

• fix: resolve all lint warnings (#210)
• fix(ui): make TraceControls toolbar scrollable on narrow screens (ADK-202) (#222)
• fix: ignore duplicate primitives from index.ts re-exports (ADK-219) (#224)
• fix: pass UI server port to copilot MCP tools (#227)
• fix: pin catalog dependency versions (#217)
• fix: emit error on poll timeout + show tool context in copilot (#229)
• fix/conversations-excessive-api-requests (#232)
• fix(ADK-203): populate workflow run dialog with schema-compatible input (#243)
• Fix Knowledge empty state copy and styling (#215)
• fix(cli): show models command in main help menu (#257)
• fix(ADK-275): default to profile matching agent.json API URL (#254)
• fix(runtime): type wildcard channel handler props as WildcardHandlerProps instead of never (#262)
• fix: api/config doesn't return the PAT for non localhost requests (#263)
• fix(ADK-233): rewrite FileWatcher tests with mocked fs for deterministic execution (#258)
• fix(ADK-286): auto-generate MCP config on init and document MCP tools in template (#272)

Features

• feat: stale span detection via SSE disconnect + rename OTLP to span-ingest (#221)
• feat(ui): allow JSON5/JS object syntax in action invocation input (ADK-215) (#226)
• feat(ui): auto-zoom + Ctrl+scroll zoom in linear trace mode (#223)
• feat: agent steps in emulator page (#225)
• feat(ui): polish agent steps — color-coded tools, markdown rendering, smart scroll (#231)
• feat: switch between steps and trace (#233)
• feat(ui): developer vs system trace spans (ADK-190) (#228)
• feat: move devId to agent.local.json (#237)
• feat(eval): support seeding state before eval conversation starts (ADK-235) (#244)
• feat: capture state values and changes in trace spans (ADK-251) (#247)
• feat(eval): support negative conversation testing with expectSilence (ADK-239) (#249)
• feat(runtime): explicit access to users, conversations, and workflows by ID (ADK-222) (#242)
• feat(ADK-216): add global --profile flag to all CLI subcommands (#241)
• feat(eval): support non-message triggers in evaluations (ADK-241) (#251)
• feat(ui): type-specific detail renderers + running state polish for agent steps (#235)
• feat(ADK-238): make LLM judge pass threshold configurable (#252)
• feat(eval): configurable judge model + adk models command (ADK-240) (#248)
• feat(eval): support workflow triggers in eval setup (ADK-236) (#256)
• feat(ADK-280): add Models page to browse available models in control panel (#269)
• feat(ADK-248): capture triggers in agent steps (#265)
• feat(ADK-237): support timing assertions in evals (#255)

Tooling

• chore: CI & DX cleanup — lint/format in CLAUDE.md, skip filewatcher tests, standardize on bun:test (#230)
• chore: update linter preferences (#238)
• chore: upgrade Botpress packages to latest (SDK v6, Zui v2) (#234)
• chore: upgrade bp deps (#245)
• chore: fix typing issues accross repo (#253)

Documentation

• docs: add adk run documentation and CLI help (#250)

Updates

• display events in agent steps (#239)
• Global command palette (⌘K) (#260)
• Remember selected items across sidebar navigation (#261)
• Settings page: split-pane layout matching Actions/Workflows (#270)
• Remove broken PostToolUse lint/format hooks (#271)

Installation

• npm: bun add -g @botpress/adk-cli
• GitHub releases: download the matching binary from botpress/adk

ADK CLI v1.16.7

Botpress ADK v1.16.7

This release bundles the latest merged work across the ADK packages and CLI distribution pipeline.

Updates

• No merged pull requests found since the previous release.

Installation

• npm: bun add -g @botpress/adk-cli
• GitHub releases: download the matching binary from botpress/adk

ADK CLI v1.16.6

Botpress ADK v1.16.6

This release bundles the latest merged work across the ADK packages and CLI distribution pipeline.

Updates

• Add --admin flag to squash-merge release PR command (#203)

Fixes

• fix: restore version display in Control Panel sidebar and CLI header (#205)
• fix: adk self-upgrade on windows (#206)

Installation

• npm: bun add -g @botpress/adk-cli
• GitHub releases: download the matching binary from botpress/adk

ADK CLI v1.16.5

Botpress ADK v1.16.5

This release bundles the latest merged work across the ADK packages and CLI distribution pipeline.

Fixes

• fix(ci): externalize @botpress/chat in compiled binary builds (#174)
• fix: validate variable names in config (#175)
• fix(ADK-174): resolve ADK version via require() instead of cwd probe (#181)
• fix(ADK-129): resolve integrations with underscores in names (#162)
• fix: pass dev server port to adk mcp (#186)
• Fix span parenting for autonomous tools and iterations (#187)
• fix(ADK-129): resolve integrations with underscores in names (#189)
• fix: adk link remains responsive on windows. (#184)
• fix: resizing terminal on windows (#196)
• fix: use custom GitHub PAT in release workflow (#198)

Features

• feat(ui): Supabase-style table editor with inline CRUD, filtering, and sync (#178)
• feat: improve types for workflow events in conversation handler (#180)
• feat(ci): replace release and publish pipeline (#179)

Updates

• added the webchat and traces and connected them (#177)
• toggle trace timeline (#192)
• Remove --no-open flag from adk dev (#193)
• New webchat conversation per boot (#197)
• Add code checkout step to release workflow (#201)