@ycodium-ai/plugin-api 0.2.3315 → 0.2.3335

package/README.md

@@ -56,7 +56,7 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 export default definePlugin({
   id: "my-plugin",
-  apiVersion: 34,
+  apiVersion: 35,
   activate: (ctx) => {
     ctx.log.info("hello");
 
@@ -262,12 +262,19 @@ shows up there without anyone registering it.
 
 ## THERE WILL BE COMPATIBILITY-BREAKING CHANGES
 
-The definition's `apiVersion` is a closed window: the host loads 34, and refuses every other
+The definition's `apiVersion` is a closed window: the host loads 35, 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 34. Plugins
+`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 35. 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 34 is refused until Ycodium itself is updated, with no update button.
+declares a version newer than 35 is refused until Ycodium itself is updated, with no update button.
+
+API 35 adds optional `turnQueuePauseSource` to the thread read through `threads.history`:
+`automatic-failure`, `manual` or `unknown` tells why a paused send queue is paused. The
+`recipientWarnings` returned by `communication.records.send` gain two codes,
+`recipient-queue-paused` and `recipient-queue-resumed`, and unknown future codes are dropped
+instead of failing the result. Older machines omit the new field and codes. No other public
+type changes.
 
 API 34 adds optional `turnSummaries` to `ConversationChatTimeline` and `ConversationRowsDeriveInput`,
 so older turns can show their working time. Turn summaries read through `threads.history` gain
@@ -531,7 +538,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 34.
+the minimum version is 35.
 
 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

@@ -1879,6 +1879,7 @@ export type ThreadsHistoryOutput = {
             readonly "updatedAt": string;
         }> | undefined;
         readonly "turnQueuePaused"?: boolean | undefined;
+        readonly "turnQueuePauseSource"?: "automatic-failure" | "manual" | "unknown" | undefined;
         readonly "acceptedInteractionRequestIds"?: ReadonlyArray<string> | undefined;
         readonly "titleRegeneration"?: Objects_14 | null | undefined;
         readonly "titleState"?: Objects_15 | null | undefined;
@@ -2542,7 +2543,7 @@ export type CommunicationRecordsSendOutput = {
         readonly "recordId": string;
         readonly "recordSequence": number | null;
         readonly "recipientWarnings"?: ReadonlyArray<{
-            readonly "code": "recipient-read-only" | "recipient-continued" | "recipient-not-running";
+            readonly "code": "recipient-read-only" | "recipient-continued" | "recipient-not-running" | "recipient-queue-paused" | "recipient-queue-resumed";
             readonly "detail": string;
             readonly "threadId"?: string;
         }>;
@@ -5249,6 +5250,7 @@ export type ThreadsHistoryEncodedOutput = {
             readonly "updatedAt": string;
         }> | undefined;
         readonly "turnQueuePaused"?: boolean | undefined;
+        readonly "turnQueuePauseSource"?: "automatic-failure" | "manual" | "unknown" | undefined;
         readonly "acceptedInteractionRequestIds"?: ReadonlyArray<string> | undefined;
         readonly "titleRegeneration"?: Objects_120 | null | undefined;
         readonly "titleState"?: Objects_121 | null | undefined;