@ycodium-ai/plugin-api 0.2.3369 → 0.2.3377

package/README.md

@@ -56,7 +56,7 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 export default definePlugin({
   id: "my-plugin",
-  apiVersion: 35,
+  apiVersion: 36,
   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 35, and refuses every other
+The definition's `apiVersion` is a closed window: the host loads 36, 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 35. Plugins
+`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 36. 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 35 is refused until Ycodium itself is updated, with no update button.
+declares a version newer than 36 is refused until Ycodium itself is updated, with no update button.
+
+API 36 adds `ctx.threads.agents.history.get` and `page` for bounded, read-only agent transcripts.
+An executor can provide `sessions.openHistory`, whose source pages or follows a native transcript
+and closes its file observers. `page({ fromStart: true })` begins an export at the oldest record.
+Workflow members may report an optional `nativeSessionId`; without a readable transcript identity,
+their history is explicitly unsupported. These additions use the recorded agent key and the
+caller's thread scope; they do not start or resume an executor session.
 
 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
@@ -538,7 +545,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 35.
+the minimum version is 36.
 
 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

@@ -159,6 +159,12 @@ type Objects_27 = {
     readonly "turnId"?: string | undefined;
     readonly "order": number;
 };
+type Objects_28 = {
+    readonly "offset": number;
+    readonly "returned": number;
+    readonly "total": number;
+    readonly "nextOffset": number | null;
+};
 type Union_23 = {
     readonly "totalTokens": number;
     readonly "inputTokens"?: number | undefined;
@@ -168,12 +174,6 @@ type Union_23 = {
     readonly "toolUses"?: number | undefined;
     readonly "durationMs"?: number | undefined;
 } | undefined;
-type Objects_28 = {
-    readonly "offset": number;
-    readonly "returned": number;
-    readonly "total": number;
-    readonly "nextOffset": number | null;
-};
 type Union_24 = {
     readonly "kind": "thread";
     readonly "environmentId"?: string | undefined;
@@ -1986,6 +1986,59 @@ export type ThreadsResumeCommandGetOutput = {
     readonly "command": string | null;
     readonly "provider": string | null;
 };
+export type ThreadsAgentsHistoryPageInput = {
+    readonly "threadId": string;
+    readonly "agentKey": string;
+    readonly "before"?: string;
+    readonly "after"?: string;
+    readonly "limit"?: number;
+    readonly "textLimit"?: number;
+};
+export type ThreadsAgentsHistoryPageOutput = {
+    readonly "sourceEpoch": string;
+    readonly "status": "available" | "unsupported" | "unavailable";
+    readonly "reason"?: "unsupported-provider" | "provider-unavailable" | "native-session-unavailable" | "history-unavailable" | "agent-not-found";
+    readonly "items": ReadonlyArray<{
+        readonly "id": string;
+        readonly "kind": "message" | "tool_call" | "tool_result" | "record";
+        readonly "role"?: "user" | "assistant" | "system";
+        readonly "name"?: string;
+        readonly "toolCallId"?: string;
+        readonly "createdAt"?: string;
+        readonly "sourceTruncated"?: boolean;
+        readonly "text": string;
+        readonly "textWindow"?: Objects_28;
+        readonly "orderKey": string;
+        readonly "beforeCursor": string | null;
+        readonly "afterCursor": string | null;
+    }>;
+    readonly "olderCursor": string | null;
+    readonly "newerCursor": string | null;
+    readonly "liveCursor": Objects_17;
+};
+export type ThreadsAgentsHistoryGetInput = {
+    readonly "threadId": string;
+    readonly "agentKey": string;
+    readonly "cursor"?: string;
+    readonly "textLimit"?: number;
+    readonly "limit"?: number;
+};
+export type ThreadsAgentsHistoryGetOutput = {
+    readonly "status": "available" | "unsupported" | "unavailable";
+    readonly "reason"?: "unsupported-provider" | "provider-unavailable" | "native-session-unavailable" | "history-unavailable" | "agent-not-found";
+    readonly "items": ReadonlyArray<{
+        readonly "id": string;
+        readonly "kind": "message" | "tool_call" | "tool_result" | "record";
+        readonly "role"?: "user" | "assistant" | "system";
+        readonly "name"?: string;
+        readonly "toolCallId"?: string;
+        readonly "createdAt"?: string;
+        readonly "sourceTruncated"?: boolean;
+        readonly "text": string;
+        readonly "textWindow"?: Objects_28;
+    }>;
+    readonly "nextCursor": string | null;
+};
 export type ThreadsAgentsCountInput = {
     readonly "threadId": string;
 };
@@ -2011,6 +2064,7 @@ export type ThreadsAgentsListOutput = {
         readonly "updatedAt": string;
         readonly "agentThreadId"?: string | undefined;
         readonly "parentAgentKey"?: string | undefined;
+        readonly "nativeSessionId"?: string | undefined;
         readonly "role"?: string | undefined;
         readonly "model"?: string | undefined;
         readonly "effort"?: string | undefined;
@@ -2050,6 +2104,7 @@ export type ThreadsAgentsGetOutput = {
         readonly "updatedAt": string;
         readonly "agentThreadId"?: string | undefined;
         readonly "parentAgentKey"?: string | undefined;
+        readonly "nativeSessionId"?: string | undefined;
         readonly "role"?: string | undefined;
         readonly "model"?: string | undefined;
         readonly "effort"?: string | undefined;
@@ -5850,6 +5905,10 @@ export interface PluginDataPorts {
             readonly get: (input: ThreadsResumeCommandGetInput) => Promise<ThreadsResumeCommandGetOutput>;
         };
         readonly agents: {
+            readonly history: {
+                readonly page: (input: ThreadsAgentsHistoryPageInput) => Promise<ThreadsAgentsHistoryPageOutput>;
+                readonly get: (input: ThreadsAgentsHistoryGetInput) => Promise<ThreadsAgentsHistoryGetOutput>;
+            };
             readonly count: (input: ThreadsAgentsCountInput) => Promise<ThreadsAgentsCountOutput>;
             readonly list: (input: ThreadsAgentsListInput) => Promise<ThreadsAgentsListOutput>;
             readonly get: (input: ThreadsAgentsGetInput) => Promise<ThreadsAgentsGetOutput>;
@@ -6240,6 +6299,14 @@ export interface PluginUiDataReads {
         readonly input: ThreadsResumeCommandGetInput;
         readonly output: ThreadsResumeCommandGetOutput;
     };
+    readonly "threads.agents.history.page": {
+        readonly input: ThreadsAgentsHistoryPageInput;
+        readonly output: ThreadsAgentsHistoryPageOutput;
+    };
+    readonly "threads.agents.history.get": {
+        readonly input: ThreadsAgentsHistoryGetInput;
+        readonly output: ThreadsAgentsHistoryGetOutput;
+    };
     readonly "threads.agents.count": {
         readonly input: ThreadsAgentsCountInput;
         readonly output: ThreadsAgentsCountOutput;