@ycodium-ai/plugin-api 0.2.3238 → 0.2.3244

package/README.md

@@ -56,7 +56,7 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 export default definePlugin({
   id: "my-plugin",
-  apiVersion: 25,
+  apiVersion: 27,
   activate: (ctx) => {
     ctx.log.info("hello");
 
@@ -247,19 +247,27 @@ shows up there without anyone registering it.
 
 ## THERE WILL BE COMPATIBILITY-BREAKING CHANGES
 
-The definition's `apiVersion` is a closed window: the host loads 25, and refuses every other
+The definition's `apiVersion` is a closed window: the host loads 27, 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 25. Plugins
+`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 27. 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 25 is refused until Ycodium itself is updated, with no update button.
-
-API 24 adds the value `"allowExplicitBreakaway"` to `PluginProcessSpawnInput.jobPolicy` (in the
-`ctx.process` spawn input, `@ycodium-ai/plugin-api/process-socket`). Windows only: the process still
-runs inside the host's Job, but a child that explicitly requests breakaway may leave it; other
-children are still collected when the host stops. Meant for a hub that has to leave one program
-(such as an emulator) running; the first-party devices plugin uses it. `"strict"` stays the default.
-No other public type changes.
+declares a version newer than 27 is refused until Ycodium itself is updated, with no update button.
+
+API 27 adds optional fields to the output of `ctx.skills.list`. Each skill may carry `origin`,
+its source layer: a wiki page with its page id and revision, a repository with its root index
+and root folder name, settings, builtin, or a plugin with its entryId. The result may carry
+`shadowed`: skills hidden by a higher-priority skill of the same name, each with its own origin
+and the layer that won. `repoReadByCli` is set true when this CLI reads the
+repository's skills itself, so the host does not list that layer.
+Older machines omit these fields. No other public type changes.
+
+API 26 adds an optional `memoryInjection` boolean to the output of `ctx.projects.toolkits.get`;
+older machines omit it. It adds `ctx.projects.memoryInjection.set`, but only a person or the local
+CLI may set it: every plugin call is refused, and there is no `invocation.asPerson` route. The
+executor card's `capabilities` gains an optional `discoversRepoSkills`, set true when the CLI
+discovers the repository's `.agents/skills` itself, so the host does not hand those skills over
+again; absence means false. No other public type changes.
 
 API 25 adds the optional primitive `PluginIcon` to the components lent by the plugin UI host. Its
 props type, `PluginIconProps`, is exported from `@ycodium-ai/plugin-api/ui` and has the shape
@@ -268,6 +276,13 @@ decorative, scales with the font size, and renders nothing for unknown names. Th
 plugin uses it for platform icons in bot card headers in chat bridge settings. No other public
 type changes.
 
+API 24 adds the value `"allowExplicitBreakaway"` to `PluginProcessSpawnInput.jobPolicy` (in the
+`ctx.process` spawn input, `@ycodium-ai/plugin-api/process-socket`). Windows only: the process still
+runs inside the host's Job, but a child that explicitly requests breakaway may leave it; other
+children are still collected when the host stops. Meant for a hub that has to leave one program
+(such as an emulator) running; the first-party devices plugin uses it. `"strict"` stays the default.
+No other public type changes.
+
 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
@@ -422,7 +437,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 25.
+the minimum version is 27.
 
 API 8 changed what the UI gets for a communication record. `ConversationCommunicationRecord`
 (from the conversation host's `useCommunicationRecord`) and `CommunicationViewExchange` carry `bodyState`, and their