@ycodium-ai/plugin-api 0.2.3214 → 0.2.3220

package/README.md

@@ -56,7 +56,7 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 export default definePlugin({
   id: "my-plugin",
-  apiVersion: 21,
+  apiVersion: 23,
   activate: (ctx) => {
     ctx.log.info("hello");
 
@@ -239,12 +239,22 @@ shows up there without anyone registering it.
 
 ## THERE WILL BE COMPATIBILITY-BREAKING CHANGES
 
-The definition's `apiVersion` is a closed window: the host loads 21, and refuses every other
+The definition's `apiVersion` is a closed window: the host loads 23, and refuses every other
 value. Declare the version your plugin targets as a literal; do not read the host's
-`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 21. Plugins
+`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 23. Plugins
 targeting an older API are refused before activation; the message names the version the plugin
 declared and the one this Ycodium loads, and the plugin card offers an update. A plugin that
-declares a version newer than 21 is refused until Ycodium itself is updated, with no update button.
+declares a version newer than 23 is refused until Ycodium itself is updated, with no update button.
+
+API 23 adds two optional fields to each entry of `turnIntents` in the outputs of
+`ctx.threads.history` and `ctx.threads.execution.get`. `action` is
+`{ kind: "steer" | "interrupt", turnId, commandId, source?: "automatic" } | null` — what the
+intent did to a running turn. `deliveredTurnId` is `string | null` — the turn the intent landed
+in, once that is settled. No other public type changes.
+
+API 22 adds an optional `runtimeMaintenanceRoot` (string) to the output of
+`ctx.machineSettings.config.get` (`MachineSettingsConfigGetOutput`): the machine's runtime
+directory, the same value the host uses for runtime maintenance. No other public type changes.
 
 API 21 makes an incompatible change to `ConversationComposerApi.imageCompression`: `isHeicFile` is
 removed and `prepareForAttachment` is renamed to `prepareFileForAttachment`. Plugins using these
@@ -390,7 +400,7 @@ An empty page with a cursor still continues. All failures propagate unchanged, i
 `ThreadNotFoundError` when the thread is missing; use `isThreadNotFound(error)` to identify it.
 `ctx.communication.inbox.read` is gone; that port always rejected a plugin, because only the agent
 in the thread has its own inbox. Plugins targeting these earlier versions are refused on the current host;
-the minimum version is 21.
+the minimum version is 23.
 
 API 8 changed what the UI gets for a communication record. `ConversationCommunicationRecord`
 (from the conversation host's `useCommunicationRecord`) and `CommunicationViewExchange` carry `bodyState`, and their