---
summary: "Built-in alias rename — source-prefixed handles (`bti-*`, `t3-*`); adds T3/Oat and T3/Barley; fixes hyphenated-builtin env shadow."
breaking: false
---

# 0.4.13 — 2026-05-04

Source-prefixed alias rename across the built-in registry, plus two new T3 small-grains servers. Tool schemas refresh on next connect, so agents reading the current connect tool description pick up the new handles automatically. Operators with per-alias credential env vars (e.g. `BRAPI_CASSAVA_USERNAME`) need to rename to the new prefix (`BRAPI_BTI_CASSAVA_USERNAME`) — see Migration below.

## Added

- **`t3-oat` and `t3-barley` built-ins** — Triticeae Toolbox (T3) hosts three sibling Breedbase instances at `*.triticeaetoolbox.org`; only wheat shipped before. Live probes confirm anonymous reads return real data: T3/Oat advertises 2,564 studies / 59,780 germplasm / 288 variables, T3/Barley 1,574 / 63,859 / 208. Same Breedbase platform underneath, same CC-BY posture, same Morales et al. 2022 citation as the existing entries.

## Changed

- **Built-in aliases renamed to source-prefixed handles** so the hosting source is visible at the call site:

  | Before | After |
  |:-------|:------|
  | `cassava` | `bti-cassava` |
  | `sweetpotato` | `bti-sweetpotato` |
  | `wheat` | `t3-wheat` |
  | `breedbase` | `bti-breedbase-demo` |

  Tool input schema is unchanged (alias is still a free-form `z.string().regex(...)`), and the connect tool description lists current builtins dynamically — fresh agent sessions read the new handles and use them. Custom env-only aliases under the old short names (`cassava`, `sweetpotato`, `wheat`, `breedbase`) are now valid free-form names that resolve via `BRAPI_<ALIAS>_*` env vars only — they no longer shadow a built-in.

## Fixed

- **`discoverConfiguredAliases` reverse-maps env var keys against hyphenated builtins.** The regex extracted alias names from `BRAPI_<X>_BASE_URL` keys but couldn't tell whether an underscore in the captured group should map back to a hyphen, so an env var like `BRAPI_BTI_CASSAVA_BASE_URL` was reported as a separate `bti_cassava` alias instead of shadowing the built-in `bti-cassava`. Discovery now consults the registry's underscored-name map and uses the canonical hyphenated alias when one matches. `resolveConnectInput` was unaffected — it derives the env prefix from the alias the agent passed.

## Migration

Operators who attached per-alias credentials to a built-in via env vars need to rename:

| Old env var | New env var |
|:------------|:------------|
| `BRAPI_CASSAVA_*` | `BRAPI_BTI_CASSAVA_*` |
| `BRAPI_SWEETPOTATO_*` | `BRAPI_BTI_SWEETPOTATO_*` |
| `BRAPI_WHEAT_*` | `BRAPI_T3_WHEAT_*` |
| `BRAPI_BREEDBASE_*` | `BRAPI_BTI_BREEDBASE_DEMO_*` |

`BRAPI_BUILTIN_ALIASES_DISABLED` values follow the same rename. Hardcoded `alias: 'cassava'` (etc.) in agent system prompts or saved scripts also need updating to the new handles.

## Built-in registry snapshot

Six public BrAPI v2 servers now resolve out-of-the-box from `brapi_connect`. All ship CC-BY attribution metadata via the orientation envelope; live totals probed 2026-05-04:

| Alias | Upstream | Hosted by | Crop | Studies | Germplasm | Variables |
|:------|:---------|:----------|:-----|--------:|----------:|----------:|
| `bti-cassava` | [cassavabase.org](https://cassavabase.org/) | Boyce Thompson Institute | Cassava | 8,340 | 842,464 | 968 |
| `bti-sweetpotato` | [sweetpotatobase.org](https://sweetpotatobase.org/) | Boyce Thompson Institute | Sweet potato | 2,020 | 182,175 | 486 |
| `bti-breedbase-demo` | [breedbase.org](https://breedbase.org/) | Boyce Thompson Institute | _Demo_ | 26 | 880 | 572 |
| `t3-wheat` | [wheat.triticeaetoolbox.org](https://wheat.triticeaetoolbox.org/) | Triticeae Toolbox (T3) | Wheat | 9,006 | 87,740 | 11,296 |
| `t3-oat` | [oat.triticeaetoolbox.org](https://oat.triticeaetoolbox.org/) | Triticeae Toolbox (T3) | Oat | 2,564 | 59,780 | 288 |
| `t3-barley` | [barley.triticeaetoolbox.org](https://barley.triticeaetoolbox.org/) | Triticeae Toolbox (T3) | Barley | 1,574 | 63,859 | 208 |

Servers brapi.org/servers lists as no-auth that actually require login on every endpoint (`musabase.org`, `solgenomics.net`, `yambase.org`, `mgis5`, `gigwa-CIAT`) are intentionally absent. Citation: Morales et al. 2022, _"Breedbase: a digital ecosystem for modern plant breeding."_ G3 12(7): jkac078. [doi:10.1093/g3journal/jkac078](https://doi.org/10.1093/g3journal/jkac078).