Skip to content

v0.3.3

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Jun 12:45
· 280 commits to main since this release
v0.3.3
3d6f971

Release Notes: BabeL-O v0.3.3

BabeL-O v0.3.3 is a TUI and session-workflow release. It promotes the Go TUI as the production interactive entrypoint, expands session switching and cross-session conversation flows, and refreshes the product documentation around the current user experience.

English

Overview

Starting with v0.3.3, the recommended interactive entrypoint is:

bbl go

The previous TypeScript TUI remains useful for development and protocol debugging, but release documentation now presents the Go TUI as the production terminal client. The Go TUI connects to Nexus, can auto-start a local Nexus service, and provides the main user-facing interface for sessions, permissions, tools, context, and collaboration.

Highlights

  1. Go TUI promoted as the production entrypoint

    • README quick-start and install flows now use bbl go.
    • bbl go --check reports the selected Go TUI binary path, Nexus health, and version compatibility.
    • The Go TUI local build path is standardized on clients/go-tui/bin/go-tui through make build.

  2. Session switching and conversation workflow

    • /session opens a panel-driven workflow for creating, selecting, and switching sessions.
    • Session panels render upward from the bottom so they stay visible above the prompt area.
    • Ctrl+P copies the current session id from the session panel.
    • Session-to-session messages remain typed collaboration context, not direct user instructions.

  3. TUI visual and interaction upgrades

    • Header, welcome panel, footer, input box, slash palette, context panel, and tool overlays received visual polish.
    • The input area now supports multi-line composition and Shift+Enter newline behavior on supported terminals.
    • The runtime activity line above the input reacts to agent state such as thinking, writing, tool activity, and permission requests.
    • Mouse selection, clipboard feedback, and wheel behavior were tightened to reduce display drift and accidental input pollution.

  4. Context and tool panels

    • /context now focuses on a full overlay view instead of competing with the input area.
    • Context diagnostics include visual budget information, compaction status, memory diagnostics, recovery signals, and working-set details.
    • Tool rows are normalized so Bash and other tools share the same compact ● tool visual language.

  5. Permission flow refinement

    • Session-level approval behavior was hardened so trusted-session choices can apply consistently inside the current session.
    • Recoverable conflict and cancellation paths now favor surfacing the ambiguity to the user instead of silently hard-cancelling the task.

  6. Documentation refresh

    • README and README.zh-CN were rewritten as product-facing guides.
    • A current product screenshot was added to the README.
    • Deep implementation sections such as the old architecture diagram were removed from the main README.

Installation

Install the latest release binary on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | bash
bbl go

Install this release explicitly:

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.3 bash
bbl go

Expected v0.3.3 release assets:

Quick Reference

bbl go                           # Start the production Go TUI
bbl go --check                   # Verify Go TUI install readiness
bbl run <prompt>                 # Run a one-shot prompt task
bbl sessions list                # List persisted sessions
bbl sessions inspect <sessionId> # Inspect one session
bbl tools audit                  # Review tool audit history

Verification

Before tagging this release, verify at minimum:

  • npm run typecheck
  • npm run format:check
  • npm run build
  • npm run test:go-tui
  • cd clients/go-tui && make build && ./bin/go-tui --version
  • bbl go --check --no-start-nexus against the intended local checkout
  • npm run build:binary
  • ./dist/bbl --help
  • ./dist/bbl go --check
  • installer smoke with BBL_INSTALL_DIR and BBL_VERSION=v0.3.3

简体中文

版本概述

从 v0.3.3 开始，推荐的正式交互入口是：

bbl go

之前的 TypeScript TUI 仍可用于开发调试与协议验证，但发布文档现在以 Go TUI 作为正式终端客户端。Go TUI 连接 Nexus，可在本地服务未启动时自动拉起 Nexus，并作为 session、权限、工具、context 与协作能力的主要用户界面。

主要更新

  1. Go TUI 成为正式交互入口

    • README 的快速开始与安装流程统一使用 bbl go。
    • bbl go --check 会报告实际选中的 Go TUI 二进制路径、Nexus 健康度与版本兼容状态。
    • Go TUI 本地构建路径统一为 clients/go-tui/bin/go-tui，通过 make build 生成。

  2. Session 切换与对话流

    • /session 现在以面板形式提供创建、选择、切换 session 的后续操作。
    • session 面板从底部向上展开，避免被输入区截断。
    • session 面板支持 Ctrl+P 复制当前 session id。
    • session-to-session 消息仍然是类型化协作上下文，不会被当作直接用户指令执行。

  3. TUI 视觉与交互升级

    • 顶栏、welcome 面板、底部提示、输入框、slash palette、context 面板和工具面板都进行了视觉规整。
    • 输入区支持多行显示，并在支持键盘增强的终端中支持 Shift+Enter 换行。
    • 输入框上方的运行状态动画会根据 thinking、writing、tool activity、permission request 等 agent 状态变化。
    • 鼠标选择、复制提示和滚轮行为被收紧，减少显示偏移与滚动字符误输入。

  4. Context 与工具面板

    • /context 现在更偏向完整 overlay 展示，不再需要为底部输入框预留空间。
    • context 诊断包含 budget 可视化、压缩状态、记忆诊断、恢复信号与 working set 信息。
    • 工具行样式统一，Bash 与其他工具都使用紧凑的 ● tool 视觉语言。

  5. 权限流程优化

    • session 级 approval 行为进一步加固，使当前 session 内的信任选择能稳定生效。
    • 冲突与取消类路径更倾向于反馈给用户确认，而不是直接 hard-cancel 当前任务。

  6. 文档刷新

    • README 与 README.zh-CN 已重写为面向用户的产品说明。
    • README 增加当前产品截图。
    • 主 README 移除了旧的 Architecture 等过重技术描述。

安装方式

macOS 或 Linux 安装最新发布二进制：

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | bash
bbl go

显式安装本版本：

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.3 bash
bbl go

v0.3.3 预期发布资产：

命令速查

bbl go                           # 启动正式 Go TUI
bbl go --check                   # 检查 Go TUI 安装可用性
bbl run <prompt>                 # 执行一次性 prompt 任务
bbl sessions list                # 列出持久化 session
bbl sessions inspect <sessionId> # 查看指定 session
bbl tools audit                  # 查看工具审计历史

验证命令

发布 tag 前至少验证：

  • npm run typecheck
  • npm run format:check
  • npm run build
  • npm run test:go-tui
  • cd clients/go-tui && make build && ./bin/go-tui --version
  • 对目标本地 checkout 执行 bbl go --check --no-start-nexus
  • npm run build:binary
  • ./dist/bbl --help
  • ./dist/bbl go --check
  • 使用 BBL_INSTALL_DIR 与 BBL_VERSION=v0.3.3 做安装器 smoke
Assets 10
Loading