Files
gbrain/src
Garry TanandClaude Opus 4.7 41d6ae536f v0.41: subagent hardening — Bug 1 + Bug 3 + Approach C composable prompt
Three independent fixes to src/core/minions/handlers/subagent.ts. Each is
covered by its own test set; bundled in one commit because they touch
overlapping lines of subagent.ts (cleaner than 3 hunk-split commits).

Bug 1 — rate-lease default 8 → 32 + `unlimited` sentinel
  src/core/minions/handlers/subagent.ts:61
  Pre-v0.41 the default cap of 8 starved 10-concurrency batches on
  upstreams with no provider-side rate limit (Azure/Bedrock/self-hosted).
  New resolveLeaseCap() bumps default to 32, accepts `unlimited`/`none`
  as POSITIVE_INFINITY sentinel, throws on NaN/negative/zero with a
  paste-ready hint. Codex pass-1 #7 caught the original `=0`/`NaN`-uncapped
  semantics as dangerous (universal convention is "0 means disabled").
  Pinned by test/rate-leases-uncapped.test.ts (15 cases).

Bug 3 — strip `provider:` prefix at Anthropic SDK call site
  src/core/minions/handlers/subagent.ts:439, ~:895
  `gbrain agent run --model anthropic:claude-sonnet-4-6` pre-fix sent
  the qualified string straight to client.messages.create which Anthropic
  rejects with "model not found." New stripProviderPrefix() applies at
  the one SDK call site; `model` stays qualified everywhere else
  (persistence, recipe lookup, capability gate). Pinned by 4 new
  test/subagent-handler.test.ts cases.

Approach C — composable system prompt renderer w/ per-tool usage_hint
  src/core/minions/system-prompt.ts (NEW)
  src/core/minions/types.ts (ToolDef.usage_hint + SubagentHandlerData.system_no_tool_preamble)
  src/core/minions/tools/brain-allowlist.ts (BRAIN_TOOL_USAGE_HINTS)
  src/core/minions/handlers/subagent.ts (wiring)
  Bug 4 absorbed: pre-v0.41 DEFAULT_SYSTEM was one generic line that gave
  the model no guidance on WHICH tool to reach for. The field-report case
  was a `shell` tool sitting unused because nothing told the model to
  reach for it. New deterministic renderer splices a tool-usage preamble
  listing each tool's name + usage_hint; closing paragraph names
  shell/bash explicitly + tells the model brain tools write to the DB
  (not local files). Determinism preserved for Anthropic prompt-cache
  marker stability. Pinned by 13 cases in test/system-prompt.test.ts
  (determinism, opt-out, plugin tools, cache safety).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-24 00:32:18 -07:00
..