@ycodium-ai/plugin-api 0.2.3506 → 0.2.3510

package/README.md

@@ -56,7 +56,7 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 export default definePlugin({
   id: "my-plugin",
-  apiVersion: 42,
+  apiVersion: 43,
   activate: (ctx) => {
     ctx.log.info("hello");
 
@@ -285,12 +285,40 @@ sessions continue using the streaming process interface.
 
 ## THERE WILL BE COMPATIBILITY-BREAKING CHANGES
 
-The definition's `apiVersion` is a closed window: the host loads 42, and refuses every other
+The definition's `apiVersion` is a closed window: the host loads 43, 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 42. Plugins
+`PLUGIN_API_VERSION` to make the declaration automatically match. The current API is 43. 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 42 is refused until Ycodium itself is updated, with no update button.
+declares a version newer than 43 is refused until Ycodium itself is updated, with no update button.
+
+API 43 adds work lines to the work base. A line is a named group of members with an optional lead and
+the work items placed on it; it may hang on one conversation (`threadId`; a conversation belongs to at
+most one line, archived lines included).
+
+- `ctx.work.lines` has `list`, `get`, `create`, `update`, `archive` and `restore`; `asPerson` carries
+  the four writes. Declare `work.line.create`, `work.line.update`, `work.line.archive` and
+  `work.line.restore` in `commands.dispatch`. Members change in batches through
+  `WorkLinesUpdateInput.addMemberIds` and `removeMemberIds`; `WorkLine.memberIds` is the whole group.
+- Optional item fields: `WorkItemsCreateInput.workLineId`, `WorkItemsUpdateInput.workLineId` (`null`
+  leaves the line) and `WorkItemsListInput.workLineIds` (`"none"` matches items on no line). Items
+  read back `workLineId`, and work history gains the `work-line` kind and a `workLine` field change.
+- The `work.start` guard input gains required `workLineId` and `workLineIdAfter` (the line before and
+  after the commit; `null` is no line), so a guard can judge the executor by line.
+- `MachineSettingsConfigGetOutput.environment.capabilities.workLines` says the machine supports lines;
+  older machines leave it out.
+
+API 43 also lets a turn wait for a free provider process instead of failing. When a machine already runs as
+many processes of one agent as its card allows, the next turn is queued (`blocked` with `provider-capacity`
+underneath) and starts by itself when a slot frees; the host may stop a long-idle session to make room.
+All additions are optional fields:
+
+- `ProvidersListOutput` items carry `concurrency` (`live`, `max`) for instances that keep a process ledger;
+  `MachineSettingsProvidersGetOutput` providers carry `maxProcesses`.
+- `ThreadsExecutionSummaryOutput.queue` entries carry `waitingForCapacity: true` for a turn queued for a
+  slot; its `continuation` is `queued`, not `blocked`, because the turn moves on by itself.
+- `ConversationQueueEntry.waitingForCapacity` and `ConversationQueueState.waitingForCapacity`
+  (`agentName`, `maxProcesses` or `null`) let a conversation UI say "waiting" instead of showing an error.
 
 API 42 removes what starting a thread no longer needs now that a thread always works in the folder
 itself. All three are breaking:
@@ -615,6 +643,8 @@ dispatch no longer accepts it. Scope is your own or imported threads, or project
 Read a thread's execution with `ctx.threads.execution.summary({ threadId, limit? })`: latest turn id and state,
 up to 20 unfinished intent ids with status, delivery certainty and queue position, a truncation flag,
 queue pause and pending interaction counts, and current continuation (`active`, `queued`, `blocked`, `paused`, `idle`).
+A turn waiting for a free provider process slot carries `waitingForCapacity: true` and reports `queued`, not `blocked`:
+it advances by itself once a slot frees.
 No message bodies or full intent snapshots are returned. Missing, deleted or archived threads reject.
 
 Control threads with `ctx.threads.turns.interrupt({ threadId, turnId?, requestId? })`,
@@ -668,7 +698,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 42.
+the minimum version is 43.
 
 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/conversation-queue.d.ts

@@ -53,6 +53,8 @@ export interface ConversationQueueEntry {
         readonly nativeModeName?: string | undefined;
     } | undefined;
     readonly failure?: string | undefined;
+    /** 这条在排队等 agent 的进程名额（实例开满了），不是出错也不需要处理；可以取消。 */
+    readonly waitingForCapacity?: boolean | undefined;
     /** cancel = 可取消；abandon = 可放弃；null = 两者都不给。 */
     readonly action: "cancel" | "abandon" | null;
 }
@@ -69,6 +71,14 @@ export interface ConversationQueueState {
     readonly reconciling: boolean;
     readonly deliveryUncertain: boolean;
     readonly blockedReason: string | null;
+    /**
+     * 队首在排队等进程名额：这台机器上这个 agent 同时跑的会话已经到上限，前面有人做完就轮到它。
+     * 不算 `blocked`；`maxProcesses` 是上限（不知道时为 null）。没有排队等名额的就是 null 或缺席。
+     */
+    readonly waitingForCapacity?: {
+        readonly agentName: string;
+        readonly maxProcesses: number | null;
+    } | null | undefined;
 }
 export interface ConversationQueueActions {
     onEdit(entry: ConversationQueueEntry, message: ConversationQueuedMessageEdit): Promise<void>;

package/dist/conversation-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-queue.d.ts","sourceRoot":"","sources":["../src/conversation-queue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation-queue.d.ts","sourceRoot":"","sources":["../src/conversation-queue.ts"],"names":[],"mappings":"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"}