docs: batch sentence-case headings across high-Title-Case offenders

- pi.md: 9 H2 + 14 H3 (Package Dependencies, File Structure, Tool Pipeline, etc.)
- cli/hooks.md: 6 H2 (List All Hooks, Get Hook Information, etc.)
- plugins/message-presentation.md: 8 H2 (Producer Examples, Renderer Contract, etc.)
- plan/ui-channels.md: 7 H2 (Non Goals, Target Model, Refactor Steps, etc.)
- install/ansible.md: 6 H2 + 1 H3 (What You Get, Quick Start, etc.)

Mintlify anchor generation prefers sentence case for predictable URLs.
This commit is contained in:
Vincent Koc
2026-04-26 23:52:14 -07:00
parent 18b6c3bb61
commit d43bf6de0a
5 changed files with 51 additions and 51 deletions

View File

@@ -43,14 +43,14 @@ This makes core aware of native UI shapes, weakens plugin runtime laziness, and
- Unsupported presentation features auto-degrade to the best text representation.
- Delivery behavior such as pinning a sent message is generic delivery metadata, not presentation.
## Non Goals
## Non goals
- No backwards compatibility shim for `buildCrossContextComponents`.
- No public native escape hatches for `components`, `blocks`, `buttons`, or `card`.
- No core imports of channel-native UI libraries.
- No provider-specific SDK seams for bundled channels.
## Target Model
## Target model
Add a core-owned `presentation` field to `ReplyPayload`.
@@ -91,7 +91,7 @@ type MessagePresentationOption = {
The external agent and CLI schemas now use `presentation`; `interactive` remains an internal legacy parser/rendering helper for existing reply producers.
## Delivery Metadata
## Delivery metadata
Add a core-owned `delivery` field for send behavior that is not UI.
@@ -116,7 +116,7 @@ Semantics:
Current Telegram ACP topic binding should move from `channelData.telegram.pin = true` to `delivery.pin = true`.
## Runtime Capability Contract
## Runtime capability contract
Add presentation and delivery render hooks to the runtime outbound adapter, not the control-plane channel plugin.
@@ -165,7 +165,7 @@ Core behavior:
- If no renderer exists, convert presentation to text fallback.
- After successful send, call `pinDeliveredMessage` when `delivery.pin` is requested and supported.
## Channel Mapping
## Channel mapping
Discord:
@@ -212,7 +212,7 @@ Plain or limited channels:
- Convert presentation to text with conservative formatting.
## Refactor Steps
## Refactor steps
1. Reapply the Discord release fix that splits `ui-colors.ts` from Carbon-backed UI and removes `DiscordUiContainer` from `extensions/discord/src/channel.ts`.
2. Add `presentation` and `delivery` to `ReplyPayload`, outbound payload normalization, delivery summaries, and hook payloads.
@@ -245,7 +245,7 @@ Add or update:
- Discord entrypoint import-laziness regression covering Carbon.
- Delivery pin tests covering Telegram and generic fallback.
## Open Questions
## Open questions
- Should `delivery.pin` be implemented for Discord, Slack, MS Teams, and Feishu in the first pass, or only Telegram first?
- Should `delivery` eventually absorb existing fields such as `replyToId`, `replyToCurrent`, `silent`, and `audioAsVoice`, or stay focused on post-send behaviors?