Skip to content

Docs - Specify the AI action contract and what a third surface must register #4331

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
agalin920 wants to merge 11 commits into
base: dev
Choose a base branch
from
+260 −2
Open

Docs - Specify the AI action contract and what a third surface must register #4331

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
c029581
Docs - Specify the AI action contract and what a third surface must r…
agalin920 Sep 15, 2026
6d99dbc
Docs - Rewrite the AI action contract for the MCP implementer
agalin920 Sep 15, 2026
58d2c46
Docs - Make the Studio AI mode-independent in the action contract
agalin920 Sep 15, 2026
553f43b
Docs - Replace the invented writable list with availableModes
agalin920 Sep 15, 2026
3cc7632
Docs - Stop sending mode to the MCP client
agalin920 Sep 15, 2026
1e31157
Docs - Send capabilities rather than the UI's available modes
agalin920 Sep 15, 2026
acda3fd
Docs - Carry fields on every source, not just the file text
agalin920 Sep 15, 2026
a2d908c
Docs - Stop sending path, and state the test each field has to pass
agalin920 Sep 15, 2026
2c1295b
Docs - Name the three actors instead of an ambiguous "you"
agalin920 Sep 15, 2026
92fc0c8
Docs - Say what the styling exclusion does and does not forbid
agalin920 Sep 15, 2026
8e2fb61
Docs - Route styling by what sources actually offers
agalin920 Sep 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,8 @@ useRegisterRef(key, handle, context?, options?)

Action types and routing live in `src/engine/{actionTypes.ts, handlers.ts, navigator.ts, queue.ts}`. Add new actions there rather than special-casing inside `AIDrawer.tsx`.

That engine is the _local dispatch_ layer. The **wire contract** — what the app sends the MCP client and what it may send back — is a separate, narrower thing: see [`docs/ai-action-contract.md`](docs/ai-action-contract.md). Read it before changing what the model may return, or before adding a refKey the model should be able to address.

## Testing with Cypress

Specs live in `cypress/e2e/<area>/<file>.spec.js`. Required setup: a `cypress.env.json` at the repo root with `{ "email", "password" }` plus the env vars consumed by the custom commands (`API_AUTH`, `COOKIE_NAME`, etc. — see `cypress.config.js`).
Expand Down
Loading
Loading