bots-go-framework / bots-fw / 29492005096

27%

push

github

feat(botplan): neutral message-plan model and capability descriptors

New botplan package: the platform-neutral layer-5 rendering seam (design
items F4 + F5) for the ToGethered cross-platform conversation model.

Types:
- Rich: lines of typed spans (text/bold/italic/code/link) plus list-item
  and quote line kinds — carries no HTML/markdown; each renderer emits its
  own dialect.
- ActionPrompt{Choices, LayoutRows} with Choice{Label, Token}; tokens are
  botstoken-encoded and validated <=64 bytes (Telegram callback_data ceiling).
- URLAction, LivePanel, ProactiveSpec (nil = reply), MediaRef.
- MessagePlan combining them with documented mutual-exclusion rules
  (Prompt+URLAction may coexist; LivePanel excludes Proactive) and Validate.
- Descriptor (F5): per-platform capability fact-sheet; every field cites a
  record in can-i-use/capability-map.json so descriptors can be CI-checked.
- Renderer interface Render(plan, target) -> []botmsg.MessageFromBot with
  RenderTarget and typed errors incl. ErrNoTemplateForPurpose,
  ErrTemplateMismatch, ErrInvalidPlan, ErrUnsupportedTarget.

Strictly additive; table/golden tests cover token-length validation,
plan invariants, Rich flattening and descriptor defaults.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LipBTY2YeDYJEWvmATgdDJ

79 of 79 new or added lines in 3 files covered. (100.0%)

1562 of 5768 relevant lines covered (27.08%)

0.32 hits per line