@ycodium-ai/plugin-api 0.2.3598 → 0.2.3614

package/README.md

@@ -56,7 +56,7 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 export default definePlugin({
   id: "my-plugin",
-  apiVersion: 48,
+  apiVersion: 49,
   activate: (ctx) => {
     ctx.log.info("hello");
 
@@ -285,12 +285,24 @@ sessions continue using the streaming process interface.
 
 ## THERE WILL BE COMPATIBILITY-BREAKING CHANGES
 
-The definition's `apiVersion` is a closed window: the host loads 48, and refuses every other
+The definition's `apiVersion` is a closed window: the host loads 49, 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 48. Plugins
+`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 49. 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 48 is refused until Ycodium itself is updated, with no update button.
+declares a version newer than 49 is refused until Ycodium itself is updated, with no update button.
+
+API 49 adds an unknown-outcome flag on executor task events and machine browser page controls:
+
+- An executor's `task.updated` event may carry optional `outcomeUnknown: true`: the executor cannot
+  learn how that agent ended and `idle` only says the turn is over. Clients show it as "status unknown"
+  rather than completed.
+- The machine browser's page state (`threads.browser.state.get` and the `threads.browser.control.take` /
+  `release` results) carries optional `colorScheme` and `fillsPanel`. Human page input (`threads.browser.input`)
+  accepts `back`, `forward`, `setColorScheme`, and an optional `ignoreCache` on `reload`. The machine
+  capabilities in `machineSettings.config.get` gain an optional `browserPageOperations`.
+
+Everything in API 49 is additive.
 
 API 48 adds member mentions in the conversation composer and a member id on threads:
 
@@ -804,7 +816,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 48.
+the minimum version is 49.
 
 API 8 changed what the UI gets for a communication record. `ConversationCommunicationRecord`
 (from the conversation host's `useCommunicationRecord`) and `CommunicationViewExchange` carry `bodyState`, and their

package/dist/dataPorts.gen.d.ts

@@ -73,6 +73,8 @@ type Objects_6 = {
         readonly "width": number;
         readonly "height": number;
     };
+    readonly "colorScheme"?: "system" | "light" | "dark" | undefined;
+    readonly "fillsPanel"?: boolean | undefined;
 };
 type Arrays_ = ReadonlyArray<"summary" | "runtime">;
 type Objects_7 = {
@@ -1919,6 +1921,14 @@ export type ThreadsBrowserInputInput = {
     readonly "viewerId": string;
     readonly "input": {
         readonly "_tag": "reload";
+        readonly "ignoreCache"?: boolean;
+    } | {
+        readonly "_tag": "back";
+    } | {
+        readonly "_tag": "forward";
+    } | {
+        readonly "_tag": "setColorScheme";
+        readonly "colorScheme": "system" | "light" | "dark";
     } | {
         readonly "_tag": "pointer";
         readonly "x": number;
@@ -3465,6 +3475,7 @@ export type MachineSettingsConfigGetOutput = {
             readonly "agentActivityPublishing"?: boolean;
             readonly "noiseIk"?: boolean;
             readonly "browserArtifactDelivery"?: boolean;
+            readonly "browserPageOperations"?: boolean;
             readonly "browserRuntime"?: boolean;
             readonly "pluginNotifications"?: boolean;
             readonly "pluginPurge"?: boolean;
@@ -6329,6 +6340,7 @@ export type MachineSettingsConfigGetEncodedOutput = {
             readonly "agentActivityPublishing"?: boolean;
             readonly "noiseIk"?: boolean;
             readonly "browserArtifactDelivery"?: boolean;
+            readonly "browserPageOperations"?: boolean;
             readonly "browserRuntime"?: boolean;
             readonly "pluginNotifications"?: boolean;
             readonly "pluginPurge"?: boolean;