Releases: SuTang-vain/BabeL-O
Release list
v0.4.2
Release Notes: BabeL-O v0.4.2
v0.4.2 is an interaction reliability patch. It fixes a critical bug where
AskUserQuestion responses never reached the model, hardens the question-response
HTTP path against schema rejection, and widens the watchdog timeout headroom so
interactive questions are not starved by the execution budget.
What Changed
-
AskUserQuestion response delivery (critical fix)
- The runtime now builds the provider-visible
tool_resultfromfinalOutput
(which carries the user'sansweredselection) instead ofresult.output
(the rawpending_questionpayload). Previously the model never saw the
user's choice, making the entire question flow appear unresponsive.
- The runtime now builds the provider-visible
-
Question-response HTTP path hardening
- The Zod schema for
POST /v1/sessions/:id/questions/:toolUseId/response
now acceptsnull/ omittedselectedIndicesandselectedLabels(Go nil
slices marshal to JSONnull), coercing them to empty arrays. A cancelled
question no longer 400s the endpoint and leaves the runtime polling until
its 180s deadline.
- The Zod schema for
-
Go TUI Esc-cancel fix
- The Esc key in the AskUserQuestion overlay now returns the HTTP
tea.Cmd
instead of discarding it. Previously the cancel HTTP POST never fired,
leavingwaitForQuestionResponseto time out. - Esc now sends empty slices (
[]int{},[]string{}) instead of Gonil,
matching the Zod schema.
- The Esc key in the AskUserQuestion overlay now returns the HTTP
-
Watchdog timeout headroom
- The Go TUI watchdog grace increased from 60s to 120s (watchdog 300s vs
question wait 180s), preventing the race where the model's pre-question
latency consumes the grace and the watchdog aborts the question wait.
- The Go TUI watchdog grace increased from 60s to 120s (watchdog 300s vs
-
Custom provider config schema
ProviderConfignow includes themodelsfield (array of{ id, name }),
fixing the TypeScript build when the custom provider wizard saves models.
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.4.2 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run typecheck -- --pretty false
npm run format:check
npm run deps:audit
npm test
npm run build:smoke
cd clients/go-tui && go test ./... && make build && ./bin/go-tui --versionAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.4.2 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexus --url http://127.0.0.1:9Known Notes
- v0.4.2 keeps the lightweight portable package strategy: the package uses the
user's system Node.js >= 22 and bundles the matching Go TUI binary. - The AskUserQuestion fix is the primary reason for this patch release. If you
usebbl gowith any model that callsAskUserQuestion, upgrade from v0.4.1.
BabeL-O v0.4.2 发布说明
v0.4.2 是交互可靠性补丁版本。修复了 AskUserQuestion 用户选择无法回归模型的关键
bug,加固了问题响应 HTTP 路径的 schema 校验,并扩大了 watchdog 超时余量以避免交互
式问题被执行预算截断。
主要更新
-
AskUserQuestion 响应传递(关键修复)
- 运行时现在从
finalOutput(包含用户answered选择)而非result.output
(原始pending_question载荷)构建模型可见的tool_result。此前模型永远
看不到用户的选择,导致整个问题流程表现为无响应。
- 运行时现在从
-
问题响应 HTTP 路径加固
POST /v1/sessions/:id/questions/:toolUseId/response的 Zod schema 现在接受
null/ 省略的selectedIndices和selectedLabels(Go nil slice 序列化为
JSONnull),将其转换为空数组。取消问题不再导致 400 错误并让运行时轮询到
180s 超时。
-
Go TUI Esc 取消修复
- AskUserQuestion 弹窗中的 Esc 键现在返回 HTTP
tea.Cmd而非丢弃它。此前取消
的 HTTP POST 永远不会触发,waitForQuestionResponse会超时。 - Esc 现在发送空 slice(
[]int{},[]string{})而非 Gonil,匹配 Zod schema。
- AskUserQuestion 弹窗中的 Esc 键现在返回 HTTP
-
Watchdog 超时余量
- Go TUI watchdog grace 从 60s 增加到 120s(watchdog 300s vs 问题等待 180s),
避免模型在调用 AskUserQuestion 前的延迟消耗掉 grace 导致 watchdog 截断问题等待。
- Go TUI watchdog grace 从 60s 增加到 120s(watchdog 300s vs 问题等待 180s),
-
自定义供应商配置 schema
ProviderConfig新增models字段({ id, name }数组),修复自定义供应商
向导保存模型时的 TypeScript 构建错误。
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.4.2 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
v0.4.1
Release Notes: BabeL-O v0.4.1
v0.4.1 is a runtime governance and release hardening patch. It adds explicit
authorization and consent gates for tool execution, improves soft-error
continuity, expands Skill package quality coverage, and fixes bash startup on
systems whose login shell is not compatible with the tool runner.
What Changed
-
Strategy authorization and consent governance
- Runtime intent guidance now separates "a tool could help" from "the user
authorized execution in this turn." - Unauthorized
Write,Edit, shared-side-effect Bash, and destructive Bash
calls are blocked or routed to explicit confirmation before execution. - Authorization mismatch diagnostics are visible in Go TUI permission
dialogs, CLI one-shot outcomes,bbl inspect-session, and trace output.
- Runtime intent guidance now separates "a tool could help" from "the user
-
Soft-error and timeout continuity
- Recoverable runtime states now preserve clearer in-flight turn context.
- Soft denial and timeout paths expose better severity and resume guidance.
- Watchdog diagnostics now warn when a hard timeout leaves no practical room
for soft extension cycles.
-
Skill package quality and UI polish
- Agent Skills package resource coverage and matcher quality checks were
expanded. - The Go TUI Skill workflow remains bounded to list/show/validate surfaces.
- Added the Everforest Light Soft theme and matching welcome palette polish.
- Agent Skills package resource coverage and matcher quality checks were
-
Release hardening
- Bash tool startup now falls back to
/bin/bashwhen the user's login shell
is incompatible with scripted execution. - Strategy guidance reduces accidental edits on preference-only, status, and
meta-behavior prompts.
- Bash tool startup now falls back to
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.4.1 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run typecheck -- --pretty false
npm run format:check
npm run docs:check
npm run deps:audit
npm test
npm run build:smoke
cd clients/go-tui && go test ./... && make build && ./bin/go-tui --versionAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.4.1 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexus --url http://127.0.0.1:9Known Notes
- v0.4.1 keeps the lightweight portable package strategy: the package uses the
user's system Node.js >= 22 and bundles the matching Go TUI binary. - Authorization mismatch denials are recoverable runtime feedback, not provider
failures. - Phase 5 replay/evaluation for the strategy authorization plan remains a
follow-up validation track.
BabeL-O v0.4.1 发布说明
v0.4.1 是运行时治理与发布稳定性补丁版本。它新增工具执行授权/同意边界,
改善软错误连续性,扩展 Skill 包质量覆盖,并修复用户登录 shell 与工具执行不
兼容时的 bash 启动问题。
主要更新
-
策略授权与同意治理
- 运行时意图引导现在区分“工具可能有帮助”和“用户本轮已授权执行”。
- 未授权的
Write、Edit、共享副作用 Bash、破坏性 Bash 会在执行前被阻止
或进入显式确认。 - 授权不匹配诊断已显示在 Go TUI 权限弹窗、CLI one-shot 结果、
bbl inspect-session和 trace 输出中。
-
软错误与超时连续性
- recoverable runtime 状态会保留更清晰的当前 turn 上下文。
- soft denial 与 timeout 路径提供更明确的 severity 和 resume guidance。
- watchdog 诊断会提示 hard timeout 是否已经没有足够空间进行 soft extension。
-
Skill 包质量与界面打磨
- 扩展 Agent Skills 包资源覆盖和 matcher 质量检查。
- Go TUI Skill 工作流继续限制在 list/show/validate 的有界界面。
- 新增 Everforest Light Soft 主题和对应欢迎界面配色打磨。
-
发布稳定性
- 当用户登录 shell 不适合脚本执行时,bash 工具会 fallback 到
/bin/bash。 - 策略引导减少了偏好选择、状态提问、meta 行为问题触发误编辑或过度确认的
情况。
- 当用户登录 shell 不适合脚本执行时,bash 工具会 fallback 到
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.4.1 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
v0.4.0
Release Notes: BabeL-O v0.4.0
v0.4.0 is a skills ecosystem, Go TUI workflow, and provider reliability release. It keeps bbl go as the production interactive entrypoint while adding Agent Skills interoperability, richer Skill management surfaces, safer provider auto-retry behavior, and broader release documentation.
What Changed
-
Agent Skills interoperability
- BabeL-O can import and export external Agent Skills packages while preserving
NormalizedSkillas the internal runtime shape. - Skill package validation, conversion diagnostics, resource coverage, and matcher quality were expanded.
- The model-visible Skill tool surface remains bounded and permission-aware.
- BabeL-O can import and export external Agent Skills packages while preserving
-
Go TUI Skill workflow
- Added
/skillfamily UI coverage for listing, showing, and validating skills. - The Go TUI gained Skill overlays and tests for the new interaction flow.
- Existing session, permission, and runtime rendering paths remain separate from Skill package conversion.
- Added
-
Provider unavailable auto retry
- Runtime now retries transient
provider_unavailableandrate_limitfailures on the same provider/model. - Default policy is 10 retries with 30 seconds between attempts, with saved config and env overrides.
- Retry lifecycle events are visible in Go TUI, CLI stderr, session inspection, and runtime metrics.
- MiniMax transient availability signals such as
unknown error, 999 (1000)andtimeout_error ... (2066)are classified as retryable provider availability failures.
- Runtime now retries transient
-
Release and documentation polish
- User-facing docs moved toward the
docs/guides/structure. - Nexus proposals/reference indexes were refreshed for the closed Skill and provider retry work.
- Release validation continues to cover docs, formatting, typecheck, runtime tests, and Go TUI checks.
- User-facing docs moved toward the
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.4.0 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run typecheck -- --pretty false
npm run format:check
npm run docs:check
npm run deps:audit
npm test
npm run build:smoke
cd clients/go-tui && go test ./... && make build && ./bin/go-tui --versionAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.4.0 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexus --url http://127.0.0.1:9Known Notes
- v0.4.0 keeps the lightweight portable package strategy: the package uses the user's system Node.js >= 22 and bundles the matching Go TUI binary.
- Provider auto retry never silently switches provider, model, profile, base URL, credentials, or tool visibility.
- Skill package interoperability is intentionally normalized through BabeL-O's internal Skill IR before runtime exposure.
BabeL-O v0.4.0 发布说明
v0.4.0 聚焦 Skill 生态互通、Go TUI Skill 工作流和 provider 可靠性。bbl go 继续作为正式交互入口;本版本新增 Agent Skills 包导入/导出能力,补齐 Skill 管理界面,并让 transient provider 故障可以在同 provider/model 上自动重试。
主要更新
-
Agent Skills 生态互通
- 支持导入/导出外部 Agent Skills 包,同时保留
NormalizedSkill作为内部运行时形状。 - 扩展 Skill 包校验、转换诊断、资源覆盖和 matcher 质量。
- model-visible Skill 工具面仍保持有界、可审计、受权限约束。
- 支持导入/导出外部 Agent Skills 包,同时保留
-
Go TUI Skill 工作流
- 新增
/skill系列交互,覆盖 list/show/validate。 - Go TUI 增加 Skill overlay 和对应测试。
- Skill 包转换与 session、permission、runtime 渲染路径保持边界清晰。
- 新增
-
Provider unavailable 自动重试
- runtime 会对 transient
provider_unavailable/rate_limit在同 provider/model 上自动 retry。 - 默认策略为最多 10 次、每次间隔 30 秒,并支持 saved config 与环境变量覆盖。
- retry lifecycle 会显示在 Go TUI、CLI stderr、inspect-session 和 runtime metrics 中。
- MiniMax
unknown error, 999 (1000)、timeout_error ... (2066)等 transient 信号会归类为可重试 provider availability 失败。
- runtime 会对 transient
-
发布与文档整理
- 用户文档继续迁移到
docs/guides/。 - Nexus proposal/reference 索引同步 Skill 与 provider retry 闭环。
- release 验证继续覆盖 docs、format、typecheck、runtime tests 和 Go TUI checks。
- 用户文档继续迁移到
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.4.0 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
v0.3.9
Release Notes: BabeL-O v0.3.9
v0.3.9 is a context reliability, streaming, and module-governance release. It keeps bbl go as the production interactive entrypoint while making long-session context assembly more resilient, provider streams easier to cancel or diagnose, and the runtime/Nexus codebase safer to evolve.
What Changed
-
More reliable long-session context
- Adaptive context-window selection now preserves useful history when the model still has headroom.
- Headroom-aware compactors avoid dropping low-usage tool results too early.
- Provider tool-call and tool-result pairs stay ordered across replay and context assembly.
- Recovery-boundary sessions retain more relevant context after workspace, provider, timeout, or tool-result failures.
-
Context search and diagnostics
- Context search now supports SQL/event-filter pushdown and tokenized AND matching.
- Search diagnostics report stronger matching behavior for long-running session investigations.
- Context recent surfaces default away from internal hook, usage, and thinking events.
-
Provider stream recovery
- Silent provider streams are covered by a hard watchdog and
activeAgeMsdiagnostics. - Abort signals propagate through provider SSE readers, so cancelled or timed-out streams settle cleanly.
- Progressive streaming now emits provider text deltas as they arrive instead of buffering the whole provider turn.
- Silent provider streams are covered by a hard watchdog and
-
Runtime and Nexus module governance
- Nexus routing, storage repositories, runtime pipeline helpers, and provider-loop helpers were split into smaller modules.
- CI now includes blocking layer-direction and coupling gates.
- Release validation includes the expanded coupling audit surface.
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.9 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run format:check
npm run typecheck -- --pretty false
npm run deps:audit
npm test
npm run build:smoke
cd clients/go-tui && go test ./... && make build && ./bin/go-tui --versionAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.3.9 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexus --url http://127.0.0.1:9Known Notes
- v0.3.9 keeps the lightweight portable package strategy: the package uses the user's system Node.js >= 22 and bundles the matching Go TUI binary.
bbl runremains available for one-shot automation;bbl goremains the production interactive TUI.- The context and stream-recovery changes are intentionally conservative: they improve continuity and diagnostics without changing the public CLI contract.
BabeL-O v0.3.9 发布说明
v0.3.9 聚焦长会话上下文可靠性、provider 流式恢复和模块治理。bbl go 继续作为正式交互入口;本版本重点降低长任务中上下文丢失、工具对顺序错乱、静默 provider 流和模块耦合带来的维护风险。
主要更新
-
长会话上下文更稳
- 自适应上下文窗口会在模型仍有余量时保留更多有效历史。
- headroom-aware compact/snip 避免过早丢弃低占用工具结果。
- provider 工具调用与工具结果在 replay/context assembly 中保持成对顺序。
- workspace、provider、timeout、tool-result 失败后的恢复边界保留更完整。
-
上下文搜索与诊断增强
- context search 支持 SQL/event filter 下推和 tokenized AND 匹配。
- 长 session 排查时可获得更稳定的历史事件匹配结果。
- context recent 默认排除 hook、usage、thinking 等内部噪声事件。
-
provider 流恢复更清晰
- 静默 provider stream 有 hard watchdog 和
activeAgeMs诊断。 - abort 信号会传递到 SSE reader,取消和超时能更干净地收口。
- provider 文本 delta 会渐进输出,不再等整轮结束后统一释放。
- 静默 provider stream 有 hard watchdog 和
-
模块治理收口
- Nexus router、storage repository、runtime pipeline 和 provider-loop helper 进一步拆分。
- CI 增加 layer-direction 与 coupling gate。
- release 验证覆盖更完整的 coupling audit。
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.9 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
v0.3.8
Release Notes: BabeL-O v0.3.8
v0.3.8 is a Go TUI polish and runtime permission-stability release. It keeps bbl go as the production interactive entrypoint, removes noisy model-configuration status rows from the chat transcript, and hardens provider tool permission recovery under soft-deny mode.
What Changed
-
Cleaner Go TUI model configuration
/modelprogress messages now render as short-lived notices below the input box.- Model configuration notices no longer persist as
statusrows in the main transcript. - The local Go TUI build and regression tests cover loading, provider configured, saving model, and model saved notices.
-
Context display correctness
- The Go TUI now prefers the declared model context window for the primary context label.
- Effective runtime ceilings still appear as policy detail, so large-context models such as DeepSeek V4 Pro show their 1M context window without hiding the usable effective ceiling.
-
Recoverable permission flow for provider tools
- Soft-deny mode exposes write and execute tools to provider requests while keeping the existing permission gate.
- User denials are returned to the provider as recoverable tool results with optional feedback, allowing the model to adjust instead of ending the turn immediately.
- Session-scoped approved rules are reused for provider tool calls, reducing repeated approval prompts inside the same session.
- Effective tool risk is computed from the parsed input before policy and permission checks, so read-only Bash input can stay read-risk.
-
Prompt and tool-boundary governance
- Current-state verification is generalized beyond memory checks to provider, model, tool, config, session, workspace, git state, tests/build, MCP, remote runner, and service state.
- WebSearch instructions now explicitly define it as a public external information locator and prohibit sending private code, logs, credentials, or secrets.
- Long-term memory capability text is more structured and keeps memory hits as background hints rather than workspace facts.
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.8 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run format:check
npm run typecheck -- --pretty false
npm run deps:audit
npm test
npm run build:smoke
cd clients/go-tui && go test ./... && make build && ./bin/go-tui --versionAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.3.8 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexus --url http://127.0.0.1:9Known Notes
- v0.3.8 keeps the lightweight portable package strategy: the package uses the user's system Node.js >= 22 and bundles the matching Go TUI binary.
bbl runremains available for one-shot automation;bbl goremains the production interactive TUI.
BabeL-O v0.3.8 发布说明
v0.3.8 是一次 Go TUI 细节优化与 runtime 权限稳定性版本。bbl go 继续作为正式交互入口;模型配置过程中的状态提示不再常驻主屏,同时 soft-deny 下的 provider 工具权限恢复路径更稳定。
主要更新
-
更干净的 Go TUI 模型配置体验
/model过程提示改为输入框下方的短暂实时提示。loading shared Nexus model configuration、provider configured、saving model、model saved不再写入主对话 transcript。- 本地 Go TUI 构建和回归测试已覆盖这些短提示。
-
上下文显示修复
- Go TUI 主 context 显示优先使用模型声明的上下文窗口。
- runtime effective ceiling 仍作为策略细节展示,避免 DeepSeek V4 Pro 这类大上下文模型被错误显示成较小窗口。
-
provider 工具权限恢复更稳
- soft-deny 下,provider 可以看到写入/执行工具,但实际执行仍经过权限 gate。
- 用户拒绝权限后,runtime 会把拒绝和反馈作为可恢复工具结果返回给 provider,让模型调整方案,而不是直接终止本轮。
- session 级批准规则会被复用,减少同一 session 内重复询问。
- 工具风险会先基于解析后的输入计算,例如只读 Bash 命令可以保持 read 风险。
-
Prompt 与工具边界治理
- current-state verification 从 memory 扩展到 provider、model、tool、config、session、workspace、git、tests/build、MCP、remote runner 和 service 等状态检查。
- WebSearch 被明确限定为公共外部信息定位工具,不用于私有代码、日志、凭证或 secrets。
- 长期记忆 capability 文案更结构化,并强调 memory hit 只是背景提示,不是工作区事实。
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.8 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
v0.3.7
Release Notes: BabeL-O v0.3.7
v0.3.7 is a distribution and TUI consolidation release. It removes the old TypeScript interactive TUI from the release package and makes the native Go TUI the single production interactive entrypoint.
What Changed
-
Go TUI is the production interactive client
bbl gois now the documented and tested interactive entrypoint.bbl run "<prompt>"remains available for one-shot automation and scripting.- The old
bbl chatTypeScript TUI command is no longer registered.
-
TypeScript TUI removed from release scope
- Removed the legacy TypeScript terminal UI files and their dedicated tests.
- Kept shared CLI/runtime code that is still used by
bbl run, Nexus, configuration, sessions, memory, and install checks. - Default CI no longer compiles or runs deleted TS TUI tests.
-
Smaller, clearer distribution path
- Production smoke now validates
bbl go --check --no-start-nexusinstead of the removedbbl chat --help. - Installer messages now use the requested release version dynamically.
- README and development docs now describe
bbl goas the real user-facing TUI path.
- Production smoke now validates
-
Permission approval correctness
- WebSocket permission responses now preserve
scope,rule, andfeedbackfields from the Go TUI. - Runtime session approvals now treat user-edited
scope="rule"approvals as session rules for the active session, so the same approved rule does not repeatedly ask within one session. - The one-shot
bbl runpath keeps a lightweight readline permission flow after TS TUI removal.
- WebSocket permission responses now preserve
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.7 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run typecheck -- --pretty false
npm run format:check
npm run deps:audit
npm test
npm run build:smoke
cd clients/go-tui && go test ./... && make build && ./bin/go-tui --versionAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.3.7 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexus --url http://127.0.0.1:9Known Notes
- v0.3.7 keeps the lightweight portable package strategy: the package uses the user's system Node.js >= 22 and bundles the matching Go TUI binary.
- The TypeScript runtime and Nexus server remain; only the old TypeScript interactive TUI surface was removed from the release path.
BabeL-O v0.3.7 发布说明
v0.3.7 是一次分发与 TUI 收口版本。旧 TypeScript 交互 TUI 已从发布包中移除,原生 Go TUI 成为唯一正式交互入口。
主要更新
-
Go TUI 成为正式交互客户端
bbl go是当前文档和测试覆盖的交互入口。bbl run "<prompt>"继续用于一次性自动化与脚本场景。- 旧
bbl chatTypeScript TUI 命令不再注册。
-
移除 TypeScript TUI 发布范围
- 删除旧 TypeScript 终端 UI 文件及其专用测试。
- 保留
bbl run、Nexus、配置、session、memory、安装检查仍需要的共享 CLI/runtime 代码。 - 默认 CI 不再编译或运行已删除的 TS TUI 测试。
-
更轻、更清晰的分发路径
- 生产 smoke 改为验证
bbl go --check --no-start-nexus,不再检查已移除的bbl chat --help。 - 安装脚本文案使用当前请求安装的 release 版本。
- README 与开发文档统一说明
bbl go是真实用户侧 TUI 路径。
- 生产 smoke 改为验证
-
权限批准语义修复
- WebSocket permission response 保留 Go TUI 发出的
scope、rule、feedback字段。 - runtime 会把用户编辑过的
scope="rule"批准作为当前 session 内规则,避免同一规则反复询问。 bbl run在 TS TUI 移除后保留轻量 readline 权限询问流程。
- WebSocket permission response 保留 Go TUI 发出的
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.7 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
v0.3.6
Release Notes: BabeL-O v0.3.6
BabeL-O v0.3.6 is a focused patch release for the lightweight portable distribution introduced in v0.3.5.
What Changed
-
Fixed portable
bbl golaunch on macOS- Fixed a v0.3.5 regression where
bbl go --checkpassed butbbl gofailed withspawn /bin/sh ENOENT. - The Go TUI launcher now starts bundled binaries from the binary directory instead of the optional source checkout directory.
- Portable installs no longer require a
clients/go-tuisource directory to exist under the installed app package.
- Fixed a v0.3.5 regression where
-
Hardened readiness checks
- The Go TUI
--versionprobe now uses the same launch working directory as the real binary path. - Spawn errors now surface a clearer message when the process working directory is missing.
- Regression coverage now simulates the real portable layout under
~/.local/share/babel-o/app/vX.Y.Z-<platform>/.
- The Go TUI
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.6 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run build
cd clients/go-tui && make build && ./bin/go-tui --version
cd ../..
npx tsx --test --test-concurrency=1 test/go-command.test.ts test/install-script.test.ts
npm run typecheck -- --pretty false
npm run format:checkAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.3.6 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexus --url http://127.0.0.1:9Known Notes
- v0.3.6 keeps the v0.3.5 lightweight package strategy: the portable package uses the user's system Node.js >= 22 and bundles the matching Go TUI binary.
- Users pinned to
BBL_VERSION=v0.3.5may still hit the old portable launch regression. Usev0.3.6or latest.
BabeL-O v0.3.6 发布说明
v0.3.6 是针对 v0.3.5 轻量 portable 分发的一次小补丁版本。
主要更新
-
修复 macOS portable 安装后的
bbl go启动问题- 修复 v0.3.5 中
bbl go --check通过但bbl go报spawn /bin/sh ENOENT的回归。 - Go TUI launcher 启动预编译二进制时改用二进制所在目录作为工作目录。
- portable 安装包不再依赖安装目录中存在
clients/go-tui源码目录。
- 修复 v0.3.5 中
-
加强安装可用性检查
- Go TUI
--version探针与真实启动路径使用一致的工作目录。 - 当进程工作目录缺失时,错误提示会更明确。
- 新增覆盖真实 portable 安装布局的回归测试。
- Go TUI
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.6 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
已知说明
- v0.3.6 延续 v0.3.5 的轻量分发策略:portable 包复用系统 Node.js >= 22,并内置匹配平台的 Go TUI。
- 固定安装
BBL_VERSION=v0.3.5的用户仍可能遇到旧的 portable 启动回归,请改用v0.3.6或 latest。
v0.3.5
Release Notes: BabeL-O v0.3.5
BabeL-O v0.3.5 is a lightweight distribution and Go TUI stability release. It keeps bbl go as the official interactive entrypoint, replaces the primary release package with a much smaller portable bundle, and hardens the model configuration flow after user reports around API key paste, panel transitions, mouse wheel input, and install reliability.
What Changed
-
Lightweight portable distribution
- Release assets now publish
bbl-<platform>.tar.gzportable packages as the primary install artifacts. - The portable package contains the compiled Nexus CLI/runtime, production
node_modules, the normal Node wrapper, and the matching Go TUI binary. - The package uses the user's system Node.js >= 22 instead of shipping a large Node SEA executable.
install.shprefers the portable package and only falls back to the legacy SEA + separate Go TUI path for older releases.- The installer writes a small
bblshim and runs a real end-to-end self-check withbbl go --check --no-start-nexus.
- Release assets now publish
-
Go TUI model configuration fixes
/modelnow keeps an explicit API-key entry step for API-key providers, including already configured providers where the user may keep the existing key or paste a replacement.- API-key paste is handled as a single-line secret field instead of the multi-line composer, preventing pasted keys from being split, duplicated, or mixed with prompt text.
- API keys are sanitized before saving and masked in the UI.
- Empty API-key submission preserves an existing configured credential instead of overwriting it with an empty value.
-
Input and panel stability
- Mouse wheel events are routed to viewport/panel scrolling and no longer type stray characters into text entry fields.
- High-frequency mouse motion and wheel events are throttled at the program level for smoother terminal rendering.
- Returning from
/modeland/contextre-normalizes the composer height so the input box does not remain oversized after closing a panel. - Shift+Enter and paste paths remain separated from slash panels and model credential fields.
-
Release workflow hardening
- GitHub Actions now builds portable packages for macOS arm64, macOS x64, and Linux x64.
- Standalone
go-tui-*assets are still published for debugging and compatibility. - The portable builder excludes old generated release archives from
dist/so repeated local builds do not recursively inflate package size.
- Standalone
Install
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.5 bash
bbl goPrerequisite: Node.js >= 22 on PATH.
Windows is source-build first in v0.3.5 while the lightweight portable installer targets macOS and Linux.
Expected Release Assets
- macOS Apple Silicon: bbl-darwin-arm64.tar.gz
- macOS Intel: bbl-darwin-x64.tar.gz
- Linux x64: bbl-linux-x64.tar.gz
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
Verification
Before publishing the tag, maintainers should run:
npm run build
cd clients/go-tui && make build && ./bin/go-tui --version
cd ../..
npm run build:portable
npx tsx --test --test-concurrency=1 test/install-script.test.ts test/go-command.test.ts test/config-endpoints.test.ts
npm run typecheck -- --pretty false
npm run format:checkAfter release assets are uploaded, smoke-test the public installer:
tmp="$(mktemp -d)"
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | \
BBL_VERSION=v0.3.5 BBL_INSTALL_DIR="$tmp/bin" HOME="$tmp/home" bash
"$tmp/bin/bbl" --version
"$tmp/bin/bbl" go --check --no-start-nexusKnown Notes
- The v0.3.5 portable package intentionally requires Node.js >= 22. This is the tradeoff that removes the much larger Node SEA executable from the primary distribution path.
curl | bashsupports macOS and Linux. Windows remains source-build first for this release while the portable packaging path is stabilized.- The longer-term packaging target is still a Go launcher, but v0.3.5 is the practical smaller package that can ship immediately.
BabeL-O v0.3.5 发布说明
v0.3.5 是一次轻量分发与 Go TUI 稳定性版本。正式交互入口仍是 bbl go,本版本将主发布包切换为更小的 portable bundle,并重点修复模型配置、API key 粘贴、面板退出、鼠标滚轮输入和安装可靠性问题。
主要更新
-
轻量 portable 分发
- 主发布资产改为
bbl-<platform>.tar.gz。 - 包内包含编译后的 Nexus CLI/runtime、生产依赖、普通 Node wrapper 和匹配平台的 Go TUI。
- 复用用户系统中的 Node.js >= 22,不再把大体积 Node SEA 可执行文件作为主分发路径。
install.sh优先安装 portable 包,旧版 SEA + 独立 Go TUI 只作为 v0.3.4 及更早版本的兼容 fallback。- 安装结束会执行真实的
bbl go --check --no-start-nexus自检。
- 主发布资产改为
-
Go TUI 模型配置修复
/model对 API-key provider 保留明确的粘贴 API key 步骤。- 已配置 provider 可以按 Enter 保留原 key,也可以粘贴新 key 替换。
- API key 粘贴走单行 secret 字段,不再进入多行输入框,避免错乱、重复字符和吞字。
- 保存前会清理空白/控制字符,界面只显示脱敏后的 key。
-
输入与面板稳定性
- 鼠标滚轮不会再向输入框写入异常字符。
- 高频鼠标事件在程序级节流,滚动和渲染更平滑。
- 从
/model、/context等面板返回后会重新归一化输入框高度,避免输入框异常放大。 - Shift+Enter、多行粘贴、slash 面板和模型密钥字段的输入路径进一步隔离。
-
Release 工作流加固
- CI 会构建 macOS arm64、macOS x64、Linux x64 的 portable 包。
- 独立
go-tui-*资产继续发布,便于调试和兼容。 - portable builder 会排除旧的
dist/bbl-*.tar.gz,避免本地反复构建导致包体积递归膨胀。
安装
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.5 bash
bbl go前提条件:PATH 中有 Node.js >= 22。
Windows 在 v0.3.5 中建议先从源码构建;轻量 portable 安装链路优先覆盖 macOS 和 Linux。
v0.3.4
Release Notes: BabeL-O v0.3.4
BabeL-O v0.3.4 is a runtime stability and distribution-readiness release. It keeps the Go TUI as the production interactive entrypoint, adds a user-facing memory management surface, and hardens long-session recovery, session replay, tool evidence, context compaction, and installer self-checks.
English
Overview
Use the production Go TUI entrypoint:
bbl gov0.3.4 focuses on making that path more dependable after long sessions, panel transitions, provider retries, compact/replay cycles, and fresh installations on another machine.
Highlights
-
Memory management surface
/memorynow exposes runtime-owned memory status in the Go TUI.- Read-only memory search returns bounded hints and keeps project facts non-authoritative until workspace evidence confirms them.
- Memory candidates are review-only by default.
save-note,flush, and lifecycle-style actions require explicit approval and never run silently.
-
Session replay and evidence governance
- SQLite event ordering now preserves append order for same-timestamp events.
- Provider replay repairs completed-before-started tool pairs and rejects invalid OpenAI-compatible orphan tool results before sending a provider request.
- Read evidence caching is coverage-aware, so partial file reads are no longer reused as full-file evidence.
- Read now supports explicit
lineOffset/lineLimitandbyteOffset/byteLimitranges with clearershownBytes/shownLinesdiagnostics. - Grep
pathMatchessupports multiple file globs and reports malformed boolean-string glob input as recoverable guidance.
-
Generalized agent behavior routing
- User intake routing now persists structured
problemTargetandTurn Policyfields rather than dynamic natural-language guidance. - New
user_intake_guidanceevents no longer persist natural-languageguidancepayloads; old events remain readable for compatibility. - Self-diagnosis and capability answers are governed through structured policy and static evidence rules instead of hardcoded Chinese/English prompt snippets.
evidenceMode=verify_before_claimkeeps verified observations, code-confirmed causes, and hypotheses distinct.
- User intake routing now persists structured
-
Timeout and recovery stability
- Near-timeout and soft-timeout events replay as convergence constraints so the model can summarize, narrow, or do one bounded final check instead of continuing broad discovery.
- Context compact/restore metadata has stronger retained-segment validation and legacy compatibility.
- Wrapped terminal paths such as split markdown filenames are normalized before path extraction without merging ordinary prose bullets.
-
Go TUI polish and panel stability
- Context, model, session, tool, and memory overlays are designed to render above the prompt area and avoid truncation.
- Prompt height and panel exit paths were tightened after
/modeland/contexttransitions. - Tool rows, Bash display, activity lines, footer hints, and slash-command overlays received consistency fixes.
- Mouse selection, wheel input, multi-line input, and clipboard feedback remain part of the stabilized Go TUI path.
-
Distribution and installer hardening
- The release workflow publishes both standalone
bbl-*binaries and matchinggo-tui-*binaries on the same tag. scripts/install.shvalidates release assets before installing them and treats missing Go TUI assets as an install failure by default.- On macOS, the installer installs a shell launcher that routes
bbl godirectly to the installed Go TUI and avoids the known Node SEA spawn path for the TUI. - The installer runs an end-to-end self-check after installation: Go TUI
--versionplusbbl go --check --no-start-nexus.
- The release workflow publishes both standalone
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 goInstall this release explicitly:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.4 bash
bbl goExpected v0.3.4 release assets:
- macOS Apple Silicon: bbl-darwin-arm64
- macOS Intel: bbl-darwin-x64
- Linux x64: bbl-linux-x64
- Windows x64: bbl-windows-x64.exe
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
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 historyRelease Verification
Before tagging this release, verify at minimum:
npm run typechecknpm run format:checknpm run buildnpm run build:binary./dist/bbl --version./dist/bbl go --check --no-start-nexusnpm run test:go-tuicd clients/go-tui && make build && ./bin/go-tui --version- installer smoke with
BBL_INSTALL_DIRandBBL_VERSION=v0.3.4after the release assets are uploaded
简体中文
版本概述
正式交互入口仍然是:
bbl gov0.3.4 重点修复长 session、面板切换、provider retry、context compact/replay、跨机器安装后的稳定性问题,并补齐用户可见的记忆管理入口。
主要更新
-
记忆管理面板
- Go TUI 新增
/memory运行时记忆状态面板。 - 只读记忆搜索返回受限 hint;项目事实仍必须由 workspace evidence 验证。
- 记忆候选默认是 review-only。
save-note、flush和生命周期类操作必须显式确认,不会静默写入或重启。
- Go TUI 新增
-
Session replay 与证据治理
- SQLite event ordering 使用 append order 处理同时间戳事件。
- provider replay 可修复 completed-before-started tool pair,并在发送 OpenAI-compatible 请求前拒绝 orphan tool result。
- Read cache 改为 coverage-aware,partial file read 不再被复用为 full-file evidence。
- Read 支持
lineOffset/lineLimit与byteOffset/byteLimit,并输出更清晰的shownBytes/shownLines诊断。 - Grep
pathMatches支持多个 file glob,并对 boolean-string glob 这类错误输入返回 recoverable guidance。
-
泛化 agent 行为路由
- User intake routing 改为持久化结构化
problemTarget与Turn Policy字段,不再依赖动态自然语言 guidance。 - 新写入的
user_intake_guidance事件不再持久化自然语言guidancepayload;旧事件仍可兼容读取。 - 自诊断与能力问答由结构化 policy 和静态证据规则治理,不再注入硬编码中英文提示片段。
evidenceMode=verify_before_claim会要求区分 verified observations、code-confirmed causes 与 hypotheses。
- User intake routing 改为持久化结构化
-
Timeout 与恢复稳定性
- near-timeout / soft-timeout 事件在 provider replay 中会成为收敛约束,避免继续 broad discovery。
- context compact/restore 的 retained segment 校验更强,并兼容旧 metadata。
- terminal-wrapped path 会先被受限归一化,避免被换行截断,同时不合并普通 prose bullet。
-
Go TUI 面板与交互稳定性
- context、model、session、tool、memory overlay 都按输入框上方显示的设计修复截断问题。
/model与/context退出后的输入框高度和布局恢复路径进一步加固。- 工具行、Bash 显示、activity line、footer hint 和 slash overlay 做了统一修复。
- 鼠标选择、滚轮输入、多行输入、复制提示继续作为正式 Go TUI 路径的一部分。
-
分发与安装加固
- release workflow 会在同一个 tag 上传
bbl-*与匹配的go-tui-*资产。 scripts/install.sh会先验证 release asset,默认把缺失 Go TUI 资产视为安装失败。- macOS 安装器会生成 shell launcher,让
bbl go直接走已安装的 Go TUI,避开 Node SEA 启动 TUI 的已知风险路径。 - 安装结束会运行端到端自检:Go TUI
--version与bbl go --check --no-start-nexus。
- release workflow 会在同一个 tag 上传
安装方式
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.4 bash
bbl gov0.3.4 预期发布资产:
- macOS Apple Silicon: bbl-darwin-arm64
- macOS Intel: bbl-darwin-x64
- Linux x64: bbl-linux-x64
- Windows x64: bbl-windows-x64.exe
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
命令速查
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 typechecknpm run format:checknpm run buildnpm run build:binary./dist/bbl --version./dist/bbl go --check --no-start-nexusnpm run test:go-tuicd clients/go-tui && make build && ./bin/go-tui --version- release assets 上传后,用
BBL_INSTALL_DIR与BBL_VERSION=v0.3.4做 installer smoke
v0.3.3
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 goThe 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
-
Go TUI promoted as the production entrypoint
- README quick-start and install flows now use
bbl go. bbl go --checkreports 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-tuithroughmake build.
- README quick-start and install flows now use
-
Session switching and conversation workflow
/sessionopens 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+Pcopies the current session id from the session panel.- Session-to-session messages remain typed collaboration context, not direct user instructions.
-
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.
-
Context and tool panels
/contextnow 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
● toolvisual language.
-
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.
-
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 goInstall this release explicitly:
curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.3 bash
bbl goExpected v0.3.3 release assets:
- macOS Apple Silicon: bbl-darwin-arm64
- macOS Intel: bbl-darwin-x64
- Linux x64: bbl-linux-x64
- Windows x64: bbl-windows-x64.exe
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
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 historyVerification
Before tagging this release, verify at minimum:
npm run typechecknpm run format:checknpm run buildnpm run test:go-tuicd clients/go-tui && make build && ./bin/go-tui --versionbbl go --check --no-start-nexusagainst the intended local checkoutnpm run build:binary./dist/bbl --help./dist/bbl go --check- installer smoke with
BBL_INSTALL_DIRandBBL_VERSION=v0.3.3
简体中文
版本概述
从 v0.3.3 开始,推荐的正式交互入口是:
bbl go之前的 TypeScript TUI 仍可用于开发调试与协议验证,但发布文档现在以 Go TUI 作为正式终端客户端。Go TUI 连接 Nexus,可在本地服务未启动时自动拉起 Nexus,并作为 session、权限、工具、context 与协作能力的主要用户界面。
主要更新
-
Go TUI 成为正式交互入口
- README 的快速开始与安装流程统一使用
bbl go。 bbl go --check会报告实际选中的 Go TUI 二进制路径、Nexus 健康度与版本兼容状态。- Go TUI 本地构建路径统一为
clients/go-tui/bin/go-tui,通过make build生成。
- README 的快速开始与安装流程统一使用
-
Session 切换与对话流
/session现在以面板形式提供创建、选择、切换 session 的后续操作。- session 面板从底部向上展开,避免被输入区截断。
- session 面板支持
Ctrl+P复制当前 session id。 - session-to-session 消息仍然是类型化协作上下文,不会被当作直接用户指令执行。
-
TUI 视觉与交互升级
- 顶栏、welcome 面板、底部提示、输入框、slash palette、context 面板和工具面板都进行了视觉规整。
- 输入区支持多行显示,并在支持键盘增强的终端中支持 Shift+Enter 换行。
- 输入框上方的运行状态动画会根据 thinking、writing、tool activity、permission request 等 agent 状态变化。
- 鼠标选择、复制提示和滚轮行为被收紧,减少显示偏移与滚动字符误输入。
-
Context 与工具面板
/context现在更偏向完整 overlay 展示,不再需要为底部输入框预留空间。- context 诊断包含 budget 可视化、压缩状态、记忆诊断、恢复信号与 working set 信息。
- 工具行样式统一,Bash 与其他工具都使用紧凑的
● tool视觉语言。
-
权限流程优化
- session 级 approval 行为进一步加固,使当前 session 内的信任选择能稳定生效。
- 冲突与取消类路径更倾向于反馈给用户确认,而不是直接 hard-cancel 当前任务。
-
文档刷新
- 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 gov0.3.3 预期发布资产:
- macOS Apple Silicon: bbl-darwin-arm64
- macOS Intel: bbl-darwin-x64
- Linux x64: bbl-linux-x64
- Windows x64: bbl-windows-x64.exe
- Go TUI macOS Apple Silicon: go-tui-darwin-arm64
- Go TUI macOS Intel: go-tui-darwin-x64
- Go TUI Linux x64: go-tui-linux-x64
- Go TUI Windows x64: go-tui-windows-x64.exe
命令速查
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 typechecknpm run format:checknpm run buildnpm run test:go-tuicd 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