Skip to content

Releases: SuTang-vain/BabeL-O

v0.4.2

Choose a tag to compare

@github-actions github-actions released this 24 Jul 03:41

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

  1. AskUserQuestion response delivery (critical fix)

    • The runtime now builds the provider-visible tool_result from finalOutput
      (which carries the user's answered selection) instead of result.output
      (the raw pending_question payload). Previously the model never saw the
      user's choice, making the entire question flow appear unresponsive.
  2. Question-response HTTP path hardening

    • The Zod schema for POST /v1/sessions/:id/questions/:toolUseId/response
      now accepts null / omitted selectedIndices and selectedLabels (Go nil
      slices marshal to JSON null), coercing them to empty arrays. A cancelled
      question no longer 400s the endpoint and leaves the runtime polling until
      its 180s deadline.
  3. 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,
      leaving waitForQuestionResponse to time out.
    • Esc now sends empty slices ([]int{}, []string{}) instead of Go nil,
      matching the Zod schema.
  4. 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.
  5. Custom provider config schema

    • ProviderConfig now includes the models field (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 go

Prerequisite: Node.js >= 22 on PATH.

Expected Release Assets

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 --version

After 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:9

Known 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
    use bbl go with any model that calls AskUserQuestion, upgrade from v0.4.1.

BabeL-O v0.4.2 发布说明

v0.4.2 是交互可靠性补丁版本。修复了 AskUserQuestion 用户选择无法回归模型的关键
bug,加固了问题响应 HTTP 路径的 schema 校验,并扩大了 watchdog 超时余量以避免交互
式问题被执行预算截断。

主要更新

  1. AskUserQuestion 响应传递(关键修复)

    • 运行时现在从 finalOutput(包含用户 answered 选择)而非 result.output
      (原始 pending_question 载荷)构建模型可见的 tool_result。此前模型永远
      看不到用户的选择,导致整个问题流程表现为无响应。
  2. 问题响应 HTTP 路径加固

    • POST /v1/sessions/:id/questions/:toolUseId/response 的 Zod schema 现在接受
      null / 省略的 selectedIndicesselectedLabels(Go nil slice 序列化为
      JSON null),将其转换为空数组。取消问题不再导致 400 错误并让运行时轮询到
      180s 超时。
  3. Go TUI Esc 取消修复

    • AskUserQuestion 弹窗中的 Esc 键现在返回 HTTP tea.Cmd 而非丢弃它。此前取消
      的 HTTP POST 永远不会触发,waitForQuestionResponse 会超时。
    • Esc 现在发送空 slice([]int{}, []string{})而非 Go nil,匹配 Zod schema。
  4. Watchdog 超时余量

    • Go TUI watchdog grace 从 60s 增加到 120s(watchdog 300s vs 问题等待 180s),
      避免模型在调用 AskUserQuestion 前的延迟消耗掉 grace 导致 watchdog 截断问题等待。
  5. 自定义供应商配置 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

Choose a tag to compare

@github-actions github-actions released this 06 Jul 07:57

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

  1. 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.
  2. 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.
  3. 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.
  4. Release hardening

    • Bash tool startup now falls back to /bin/bash when the user's login shell
      is incompatible with scripted execution.
    • Strategy guidance reduces accidental edits on preference-only, status, and
      meta-behavior prompts.

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 go

Prerequisite: Node.js >= 22 on PATH.

Expected Release Assets

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 --version

After 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:9

Known 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 启动问题。

主要更新

  1. 策略授权与同意治理

    • 运行时意图引导现在区分“工具可能有帮助”和“用户本轮已授权执行”。
    • 未授权的 WriteEdit、共享副作用 Bash、破坏性 Bash 会在执行前被阻止
      或进入显式确认。
    • 授权不匹配诊断已显示在 Go TUI 权限弹窗、CLI one-shot 结果、
      bbl inspect-session 和 trace 输出中。
  2. 软错误与超时连续性

    • recoverable runtime 状态会保留更清晰的当前 turn 上下文。
    • soft denial 与 timeout 路径提供更明确的 severity 和 resume guidance。
    • watchdog 诊断会提示 hard timeout 是否已经没有足够空间进行 soft extension。
  3. Skill 包质量与界面打磨

    • 扩展 Agent Skills 包资源覆盖和 matcher 质量检查。
    • Go TUI Skill 工作流继续限制在 list/show/validate 的有界界面。
    • 新增 Everforest Light Soft 主题和对应欢迎界面配色打磨。
  4. 发布稳定性

    • 当用户登录 shell 不适合脚本执行时,bash 工具会 fallback 到 /bin/bash
    • 策略引导减少了偏好选择、状态提问、meta 行为问题触发误编辑或过度确认的
      情况。

安装

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

Choose a tag to compare

@github-actions github-actions released this 03 Jul 07:07

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

  1. Agent Skills interoperability

    • BabeL-O can import and export external Agent Skills packages while preserving NormalizedSkill as 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.
  2. Go TUI Skill workflow

    • Added /skill family 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.
  3. Provider unavailable auto retry

    • Runtime now retries transient provider_unavailable and rate_limit failures 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) and timeout_error ... (2066) are classified as retryable provider availability failures.
  4. 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.

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 go

Prerequisite: Node.js >= 22 on PATH.

Expected Release Assets

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 --version

After 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:9

Known 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 上自动重试。

主要更新

  1. Agent Skills 生态互通

    • 支持导入/导出外部 Agent Skills 包,同时保留 NormalizedSkill 作为内部运行时形状。
    • 扩展 Skill 包校验、转换诊断、资源覆盖和 matcher 质量。
    • model-visible Skill 工具面仍保持有界、可审计、受权限约束。
  2. Go TUI Skill 工作流

    • 新增 /skill 系列交互,覆盖 list/show/validate。
    • Go TUI 增加 Skill overlay 和对应测试。
    • Skill 包转换与 session、permission、runtime 渲染路径保持边界清晰。
  3. 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 失败。
  4. 发布与文档整理

    • 用户文档继续迁移到 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

Choose a tag to compare

@github-actions github-actions released this 23 Jun 05:53

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

  1. 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.
  2. 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.
  3. Provider stream recovery

    • Silent provider streams are covered by a hard watchdog and activeAgeMs diagnostics.
    • 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.
  4. 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 go

Prerequisite: Node.js >= 22 on PATH.

Expected Release Assets

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 --version

After 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:9

Known 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 run remains available for one-shot automation; bbl go remains 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 流和模块耦合带来的维护风险。

主要更新

  1. 长会话上下文更稳

    • 自适应上下文窗口会在模型仍有余量时保留更多有效历史。
    • headroom-aware compact/snip 避免过早丢弃低占用工具结果。
    • provider 工具调用与工具结果在 replay/context assembly 中保持成对顺序。
    • workspace、provider、timeout、tool-result 失败后的恢复边界保留更完整。
  2. 上下文搜索与诊断增强

    • context search 支持 SQL/event filter 下推和 tokenized AND 匹配。
    • 长 session 排查时可获得更稳定的历史事件匹配结果。
    • context recent 默认排除 hook、usage、thinking 等内部噪声事件。
  3. provider 流恢复更清晰

    • 静默 provider stream 有 hard watchdog 和 activeAgeMs 诊断。
    • abort 信号会传递到 SSE reader,取消和超时能更干净地收口。
    • provider 文本 delta 会渐进输出,不再等整轮结束后统一释放。
  4. 模块治理收口

    • 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

Choose a tag to compare

@github-actions github-actions released this 15 Jun 13:19

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

  1. Cleaner Go TUI model configuration

    • /model progress messages now render as short-lived notices below the input box.
    • Model configuration notices no longer persist as status rows in the main transcript.
    • The local Go TUI build and regression tests cover loading, provider configured, saving model, and model saved notices.
  2. 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.
  3. 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.
  4. 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 go

Prerequisite: Node.js >= 22 on PATH.

Expected Release Assets

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 --version

After 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:9

Known 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 run remains available for one-shot automation; bbl go remains the production interactive TUI.

BabeL-O v0.3.8 发布说明

v0.3.8 是一次 Go TUI 细节优化与 runtime 权限稳定性版本。bbl go 继续作为正式交互入口;模型配置过程中的状态提示不再常驻主屏,同时 soft-deny 下的 provider 工具权限恢复路径更稳定。

主要更新

  1. 更干净的 Go TUI 模型配置体验

    • /model 过程提示改为输入框下方的短暂实时提示。
    • loading shared Nexus model configurationprovider configuredsaving modelmodel saved 不再写入主对话 transcript。
    • 本地 Go TUI 构建和回归测试已覆盖这些短提示。
  2. 上下文显示修复

    • Go TUI 主 context 显示优先使用模型声明的上下文窗口。
    • runtime effective ceiling 仍作为策略细节展示,避免 DeepSeek V4 Pro 这类大上下文模型被错误显示成较小窗口。
  3. provider 工具权限恢复更稳

    • soft-deny 下,provider 可以看到写入/执行工具,但实际执行仍经过权限 gate。
    • 用户拒绝权限后,runtime 会把拒绝和反馈作为可恢复工具结果返回给 provider,让模型调整方案,而不是直接终止本轮。
    • session 级批准规则会被复用,减少同一 session 内重复询问。
    • 工具风险会先基于解析后的输入计算,例如只读 Bash 命令可以保持 read 风险。
  4. 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

Choose a tag to compare

@github-actions github-actions released this 14 Jun 12:19

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

  1. Go TUI is the production interactive client

    • bbl go is now the documented and tested interactive entrypoint.
    • bbl run "<prompt>" remains available for one-shot automation and scripting.
    • The old bbl chat TypeScript TUI command is no longer registered.
  2. 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.
  3. Smaller, clearer distribution path

    • Production smoke now validates bbl go --check --no-start-nexus instead of the removed bbl chat --help.
    • Installer messages now use the requested release version dynamically.
    • README and development docs now describe bbl go as the real user-facing TUI path.
  4. Permission approval correctness

    • WebSocket permission responses now preserve scope, rule, and feedback fields 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 run path keeps a lightweight readline permission flow after TS TUI removal.

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 go

Prerequisite: Node.js >= 22 on PATH.

Expected Release Assets

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 --version

After 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:9

Known 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 成为唯一正式交互入口。

主要更新

  1. Go TUI 成为正式交互客户端

    • bbl go 是当前文档和测试覆盖的交互入口。
    • bbl run "<prompt>" 继续用于一次性自动化与脚本场景。
    • bbl chat TypeScript TUI 命令不再注册。
  2. 移除 TypeScript TUI 发布范围

    • 删除旧 TypeScript 终端 UI 文件及其专用测试。
    • 保留 bbl run、Nexus、配置、session、memory、安装检查仍需要的共享 CLI/runtime 代码。
    • 默认 CI 不再编译或运行已删除的 TS TUI 测试。
  3. 更轻、更清晰的分发路径

    • 生产 smoke 改为验证 bbl go --check --no-start-nexus,不再检查已移除的 bbl chat --help
    • 安装脚本文案使用当前请求安装的 release 版本。
    • README 与开发文档统一说明 bbl go 是真实用户侧 TUI 路径。
  4. 权限批准语义修复

    • WebSocket permission response 保留 Go TUI 发出的 scoperulefeedback 字段。
    • runtime 会把用户编辑过的 scope="rule" 批准作为当前 session 内规则,避免同一规则反复询问。
    • bbl run 在 TS TUI 移除后保留轻量 readline 权限询问流程。

安装

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

Choose a tag to compare

@github-actions github-actions released this 14 Jun 02:27

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

  1. Fixed portable bbl go launch on macOS

    • Fixed a v0.3.5 regression where bbl go --check passed but bbl go failed with spawn /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-tui source directory to exist under the installed app package.
  2. Hardened readiness checks

    • The Go TUI --version probe 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>/.

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 go

Prerequisite: Node.js >= 22 on PATH.

Expected Release Assets

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:check

After 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:9

Known 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.5 may still hit the old portable launch regression. Use v0.3.6 or latest.

BabeL-O v0.3.6 发布说明

v0.3.6 是针对 v0.3.5 轻量 portable 分发的一次小补丁版本。

主要更新

  1. 修复 macOS portable 安装后的 bbl go 启动问题

    • 修复 v0.3.5 中 bbl go --check 通过但 bbl gospawn /bin/sh ENOENT 的回归。
    • Go TUI launcher 启动预编译二进制时改用二进制所在目录作为工作目录。
    • portable 安装包不再依赖安装目录中存在 clients/go-tui 源码目录。
  2. 加强安装可用性检查

    • Go TUI --version 探针与真实启动路径使用一致的工作目录。
    • 当进程工作目录缺失时,错误提示会更明确。
    • 新增覆盖真实 portable 安装布局的回归测试。

安装

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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 17:32

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

  1. Lightweight portable distribution

    • Release assets now publish bbl-<platform>.tar.gz portable 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.sh prefers the portable package and only falls back to the legacy SEA + separate Go TUI path for older releases.
    • The installer writes a small bbl shim and runs a real end-to-end self-check with bbl go --check --no-start-nexus.
  2. Go TUI model configuration fixes

    • /model now 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.
  3. 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 /model and /context re-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.
  4. 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.

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 go

Prerequisite: 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

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:check

After 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-nexus

Known 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 | bash supports 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 粘贴、面板退出、鼠标滚轮输入和安装可靠性问题。

主要更新

  1. 轻量 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 自检。
  2. Go TUI 模型配置修复

    • /model 对 API-key provider 保留明确的粘贴 API key 步骤。
    • 已配置 provider 可以按 Enter 保留原 key,也可以粘贴新 key 替换。
    • API key 粘贴走单行 secret 字段,不再进入多行输入框,避免错乱、重复字符和吞字。
    • 保存前会清理空白/控制字符,界面只显示脱敏后的 key。
  3. 输入与面板稳定性

    • 鼠标滚轮不会再向输入框写入异常字符。
    • 高频鼠标事件在程序级节流,滚动和渲染更平滑。
    • /model/context 等面板返回后会重新归一化输入框高度,避免输入框异常放大。
    • Shift+Enter、多行粘贴、slash 面板和模型密钥字段的输入路径进一步隔离。
  4. 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

Choose a tag to compare

@github-actions github-actions released this 13 Jun 13:32

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 go

v0.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

  1. Memory management surface

    • /memory now 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.
  2. 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 / lineLimit and byteOffset / byteLimit ranges with clearer shownBytes / shownLines diagnostics.
    • Grep pathMatches supports multiple file globs and reports malformed boolean-string glob input as recoverable guidance.
  3. Generalized agent behavior routing

    • User intake routing now persists structured problemTarget and Turn Policy fields rather than dynamic natural-language guidance.
    • New user_intake_guidance events no longer persist natural-language guidance payloads; 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_claim keeps verified observations, code-confirmed causes, and hypotheses distinct.
  4. 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.
  5. 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 /model and /context transitions.
    • 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.
  6. Distribution and installer hardening

    • The release workflow publishes both standalone bbl-* binaries and matching go-tui-* binaries on the same tag.
    • scripts/install.sh validates 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 go directly 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 --version plus bbl go --check --no-start-nexus.

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.4 bash
bbl go

Expected v0.3.4 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

Release Verification

Before tagging this release, verify at minimum:

  • npm run typecheck
  • npm run format:check
  • npm run build
  • npm run build:binary
  • ./dist/bbl --version
  • ./dist/bbl go --check --no-start-nexus
  • npm run test:go-tui
  • cd clients/go-tui && make build && ./bin/go-tui --version
  • installer smoke with BBL_INSTALL_DIR and BBL_VERSION=v0.3.4 after the release assets are uploaded

简体中文

版本概述

正式交互入口仍然是:

bbl go

v0.3.4 重点修复长 session、面板切换、provider retry、context compact/replay、跨机器安装后的稳定性问题,并补齐用户可见的记忆管理入口。

主要更新

  1. 记忆管理面板

    • Go TUI 新增 /memory 运行时记忆状态面板。
    • 只读记忆搜索返回受限 hint;项目事实仍必须由 workspace evidence 验证。
    • 记忆候选默认是 review-only。
    • save-noteflush 和生命周期类操作必须显式确认,不会静默写入或重启。
  2. 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 / lineLimitbyteOffset / byteLimit,并输出更清晰的 shownBytes / shownLines 诊断。
    • Grep pathMatches 支持多个 file glob,并对 boolean-string glob 这类错误输入返回 recoverable guidance。
  3. 泛化 agent 行为路由

    • User intake routing 改为持久化结构化 problemTargetTurn Policy 字段,不再依赖动态自然语言 guidance。
    • 新写入的 user_intake_guidance 事件不再持久化自然语言 guidance payload;旧事件仍可兼容读取。
    • 自诊断与能力问答由结构化 policy 和静态证据规则治理,不再注入硬编码中英文提示片段。
    • evidenceMode=verify_before_claim 会要求区分 verified observations、code-confirmed causes 与 hypotheses。
  4. Timeout 与恢复稳定性

    • near-timeout / soft-timeout 事件在 provider replay 中会成为收敛约束,避免继续 broad discovery。
    • context compact/restore 的 retained segment 校验更强,并兼容旧 metadata。
    • terminal-wrapped path 会先被受限归一化,避免被换行截断,同时不合并普通 prose bullet。
  5. Go TUI 面板与交互稳定性

    • context、model、session、tool、memory overlay 都按输入框上方显示的设计修复截断问题。
    • /model/context 退出后的输入框高度和布局恢复路径进一步加固。
    • 工具行、Bash 显示、activity line、footer hint 和 slash overlay 做了统一修复。
    • 鼠标选择、滚轮输入、多行输入、复制提示继续作为正式 Go TUI 路径的一部分。
  6. 分发与安装加固

    • 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 --versionbbl go --check --no-start-nexus

安装方式

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 go

v0.3.4 预期发布资产:

命令速查

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 build:binary
  • ./dist/bbl --version
  • ./dist/bbl go --check --no-start-nexus
  • npm run test:go-tui
  • cd clients/go-tui && make build && ./bin/go-tui --version
  • release assets 上传后,用 BBL_INSTALL_DIRBBL_VERSION=v0.3.4 做 installer smoke

v0.3.3

Choose a tag to compare

@github-actions github-actions released this 12 Jun 12:45

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_DIRBBL_VERSION=v0.3.3 做安装器 smoke