@ycodium-ai/plugin-api 0.2.3566 → 0.2.3576

package/README.md

@@ -56,7 +56,7 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 export default definePlugin({
   id: "my-plugin",
-  apiVersion: 46,
+  apiVersion: 47,
   activate: (ctx) => {
     ctx.log.info("hello");
 
@@ -285,12 +285,16 @@ sessions continue using the streaming process interface.
 
 ## THERE WILL BE COMPATIBILITY-BREAKING CHANGES
 
-The definition's `apiVersion` is a closed window: the host loads 46, and refuses every other
+The definition's `apiVersion` is a closed window: the host loads 47, 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 46. Plugins
+`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 47. 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 46 is refused until Ycodium itself is updated, with no update button.
+declares a version newer than 47 is refused until Ycodium itself is updated, with no update button.
+
+API 47 adds one field: thread runtime reads (`threads.list` rows and their `runtime` part, `threads.get`) carry an
+optional `backgroundMonitorCount`, the number of background monitor loops still alive in the session. It is a
+read-time value; absent and 0 both mean none. Everything is additive.
 
 API 46 adds the plugin-visible side of the team page: views a plugin draws on it, a read of one work line's
 history, and a conversation view for pending requests. Everything is additive.
@@ -779,7 +783,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 46.
+the minimum version is 47.
 
 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

@@ -1602,6 +1602,7 @@ type Objects_146 = {
     readonly "hasActionableProposedPlan": boolean;
     readonly "status"?: "needs-approval" | "needs-input" | "plan-ready" | "running" | "failed" | "background" | "stopped" | "idle" | undefined;
     readonly "backgroundLiveness"?: "working" | "monitoring" | null | undefined;
+    readonly "backgroundMonitorCount"?: number | undefined;
     readonly "planProgress"?: Union_65;
 };
 type Union_7 = Objects_18 | null;
@@ -1662,6 +1663,7 @@ type Objects_9 = {
     };
     readonly "runtime"?: {
         readonly "backgroundLiveness"?: "working" | "monitoring" | null | undefined;
+        readonly "backgroundMonitorCount"?: number | undefined;
         readonly "planProgress"?: Union_15;
     };
 };
@@ -1714,6 +1716,7 @@ type Objects_26 = {
     readonly "hasActionableProposedPlan": boolean;
     readonly "status"?: "needs-approval" | "needs-input" | "plan-ready" | "running" | "failed" | "background" | "stopped" | "idle" | undefined;
     readonly "backgroundLiveness"?: "working" | "monitoring" | null | undefined;
+    readonly "backgroundMonitorCount"?: number | undefined;
     readonly "planProgress"?: Union_15;
 };
 type Objects_8 = {
@@ -1995,6 +1998,7 @@ export type ThreadsListSubscribeOutput = {
         readonly "status": "needs-approval" | "needs-input" | "plan-ready" | "running" | "failed" | "background" | "stopped" | "idle";
         readonly "runtime"?: {
             readonly "backgroundLiveness"?: "working" | "monitoring" | null | undefined;
+            readonly "backgroundMonitorCount"?: number | undefined;
             readonly "planProgress"?: Union_15;
         };
     }>;
@@ -5802,6 +5806,7 @@ export type ThreadsListEncodedOutput = {
         };
         readonly "runtime"?: {
             readonly "backgroundLiveness"?: "working" | "monitoring" | null | undefined;
+            readonly "backgroundMonitorCount"?: number | undefined;
             readonly "planProgress"?: Union_65;
         };
     }>;