Description
Chat Superpower Invocation brings installed prompts, skills, agents, and Power-Up Playbooks into the message composer. Users browse a live catalog by Superpower type, select an invokable item, see its identity as a composer pill, and dispatch the turn with the chosen Superpower attached. Invocation tokens can also be entered through the composer’s command grammar, while empty states point users to Marketplace rather than presenting fabricated catalog entries.
The picker consumes a live catalog through an injected bridge and retains type metadata in a dedicated shared subpath. At send time, the selected item resolves by its durable row identifier, preventing renamed catalog entries from dispatching the wrong behavior. The composer owns invocation state, so the selection remains tied to the turn rather than to a static shell slot.
Selling Points
- Lets users apply specialized reusable behavior without leaving the conversation where the work is happening.
- Supports multiple Superpower families in one discoverable picker rather than requiring users to memorize invocation syntax.
- Reads the installed catalog live, keeping Chat aligned with Marketplace additions and removals.
- Resolves selected behavior by durable identity at dispatch, protecting users from title changes or ambiguous names.
- Turns an empty catalog into a clear acquisition path through Marketplace instead of a dead-end message.
User Story
A founder opens Chat, browses the Agent category, selects a research agent installed from Marketplace, and asks it to compare three competitors. The selected Superpower appears as a pill before send. Later they choose a Power-Up Playbook for a recurring launch workflow without creating a separate automation.
Extension Surface
This feature is pluggable because the catalog is populated by installable Superpowers rather than a fixed UI list. packages/parts/src/composer/ChatSuperpowerCatalogBridge.tsx injects live catalog access, and packages/parts/src/composer/superpower-catalog-context.tsx defines the formal consumer contract. External developers can create and distribute supported Superpower types through their platform surfaces.
Capabilities & Limits
- Browses live installed Superpowers by type and attaches one to a conversation turn.
- Supports invocation pills, token derivation, durable identifier resolution, and Marketplace acquisition paths.
- Keeps invocation state scoped to the composer and current dispatch.
- Limit: only installed, invokable Superpowers appear; authoring, validation, distribution, and execution internals belong to other features outside this lane.
Implementation Map
packages/parts/src/composer/superpower-picker/SuperpowerPickerPopover.tsxpackages/parts/src/composer/ChatSuperpowerCatalogBridge.tsxpackages/parts/src/composer/use-composer-superpowers.tspackages/parts/src/composer/superpower-catalog-context.tsx