What
The internal system plugins and hooks use to put text into your input box (the "draft") has been extended.
- The
fillDraftAPI, used by plugins and hooks to populate the input box, now takes a mode:replace(the old default, replaces everything),append(adds text to the end of what's already there), orinsert(inserts text at your cursor position). - A companion
readDraftAPI (also exposed as the hook method$.prompt.read) lets a plugin read the current input box text and cursor position before deciding what to do. - Slash-command-triggered plugin actions of type
prompt.fill(defaulting toreplacemode) andprompt.suggestnow get the same default plugin-origin metadata thatcommand.runactions already had. - A new settings layer called
memorywas added alongside the existing managed/user/project/local layers, and the replace/append/insert modes are validated against an explicit list, with an error shown for invalid modes.
Why
This gives plugins finer control over how they interact with whatever you're already typing, instead of always overwriting it. A plugin can now add a suggestion after your text or insert something right where your cursor is, and it can check what's already in the box first.
Names in the bundleprompt.fillprompt.suggest
Documented inclaude-code/plugins/mods/reference
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Confirmed since
Anthropic's documentation has since written up prompt.suggest, on Draw in the interface with a mod.
* **Prompt suggestions**: `$.prompt.suggest` resolves with `isShown: false` and shows nothing, because the panel keeps the prompt box's dim suggestion text for Claude's own suggestions.plugins/mods/interface see the edit
Confirmed since
Anthropic's documentation has since written up prompt.fill, on Test a mod.
A stub for a mods API call returns an object with a `value` field, which holds what the call resolves to in your mod: `{ value: 7 }` makes `$.store.get` resolve to `7`. A stub for one of Claude Code's events, such as [`turn.step`](/docs/en…plugins/mods/test see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up prompt.fill, on Test a mod.