Skip to content

bcli 0.4.0 — Agent Interface Profile v0.1

Latest

Choose a tag to compare

@igor-ctrl igor-ctrl released this 18 May 12:11
· 5 commits to main since this release

The Agent Interface Profile (AIP) v0.1 lands: a small kernel of CLI primitives any agent runtime can drive deterministically, without parallel schemas or hand-written MCP tools.

  • bcli describe --format json projects the live Typer surface, registry, and profile as one canonical artifact.
  • Mutation result envelope (--result-out PATH / --result-fd N) on every write — failures are diagnosable side-channel, no stdout scraping.
  • Batch operation ledger — durable SQLite, survives SIGKILL. Three new commands: bcli batch state, bcli batch list, bcli batch rollback.
  • Exit code taxonomy (08) replaces "non-zero = error"; agents key off specific codes.
  • JSON on pipe by default — pipelines, redirects, CI all get machine-readable output without flag dance.
  • --idempotency-key on writes + per-step idempotency_key: in batch YAML — same-run replay protection.
  • bcli_mcp rewrote from 4 hand-written tools to 23 generated from bcli describe, including 5 new mutating verbs that return envelopes.
  • Skills layerbcli skill install projects saved queries and batch workflows as Claude Code slash commands; bcli skill init is an interactive wizard for per-user personalization. Entry-point group bcli.skill_init.role_templates lets downstream packages contribute role-tailored templates without forking bcli.

Breaking changes

Two intentional breaks (one-line migrations):

  • Policy refusals (read-only profile + missing --yes) now exit 8 (was 1).
  • MCP tool names match the CLI command path: querybcli_get, list_endpointsbcli_endpoint_list, etc. Migration table in docs/mcp-server.md.

Full changelog

See CHANGELOG.md for the full entry, including deferred-to-v0.5 items.