mirror of
https://github.com/getpaseo/paseo.git
synced 2026-11-09 18:04:55 +00:00
Mohamed Boudra
b10647cae3
A pill could insert text but left the cursor elsewhere, so the user had to click the composer before typing. Plugins can address any agent's composer, and an author cannot know where the user is, so focus() owns revealing the agent as well as focusing it. A running agent's composer holds one pending request and navigates to the agent, completing when an input that can take the keyboard attaches. Drafts and the New workspace composer have nothing to navigate to and must not pull the user back, so they reject when off screen.
Composer controls
Install this directory as a plugin and open the agent, draft, or New workspace composer. Four controls appear beside the model and thinking controls.
| Control | Component | What it does |
|---|---|---|
| Context length | Select |
Saves composer-controls.contextLength in the agent's metadata. |
| Needs review | Toggle |
Sets or clears composer-controls.needsReview in the agent's metadata. |
| Plan first | Toggle |
Sets the provider option plan_mode with composer.setOptions; enabled for Codex only. |
| Insert checklist | Action |
Inserts a task list at the cursor through composer.insertText. |
Each component calls useComposer() and uses the same commands in every composer. Paseo draws the
controls inline when the composer has room and as rows in the composer's overflow sheet when it
does not, including on a phone.
Reaching a composer from outside it
Two more contributions use a composer without sitting in one. Both name the agent instead of reading the composer they are mounted in, and neither needs the agent's tab to be open.
| Contribution | What it does |
|---|---|
| Composer tools (Explorer panel) | useComposers({ focused: true }) inserts the checklist into the focused agent's prompt. |
| Mark for review (Command Center) | composers({ agentId }) sets the same needsReview metadata as the toggle, for the agent you selected. |
client/controls.tsx holds the four composer components, client/panel.tsx the panel, and index.client.tsx registers everything.