@ycodium-ai/plugin-api 0.2.2972 → 0.2.2974

package/README.md

@@ -272,6 +272,20 @@ your plugin's install, so you only see receipts for commands your plugin dispatc
 `threadId` may be left out for them; commands on an existing thread still need `threadId` and
 thread ownership. Both are optional additions, so the API version was not bumped.
 
+Added within API 4, for a plugin that draws its own settings in the `settings.section` seat. None
+of these bumped the API version.
+
+- `presentation: "hidden"` on `ctx.settingsCard`: clients stop drawing the card's form. Keep the
+  field declarations: a `kind: "proxy"` field is how the host knows which proxy you use, and
+  `password` fields and columns are how it knows which positions are secrets.
+- `clearSecrets` in the options of `ctx.settings.write`: paths whose stored password is removed.
+  The host drops the key at each path from the config it writes, whatever you put there. A path
+  listed in both `secrets` and `clearSecrets` rejects the write.
+- `bridge.ui.QRCodeSvg` and `bridge.ui.ProxyChoiceSelect`, typed by `QRCodeSvgProps` and
+  `ProxyChoiceSelectProps` in `@ycodium-ai/plugin-api/ui`. The proxy select draws the options you
+  pass it; get them from `ctx.proxies.list()` in a command of your own. An older host does not
+  have them, so check that they exist before rendering.
+
 ### API 3
 
 API 3 deletes the host's old usage path and fixes the executor contract that the built-in agents