@yaklabs-ai/plugin-sdk 0.15.1 → 0.15.2

package/README.md

@@ -13,7 +13,7 @@ it under the name your plugin code actually imports:
 ```json
 {
   "dependencies": {
-    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.15.1"
+    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.15.2"
   }
 }
 ```
@@ -62,7 +62,7 @@ Every tool the entrypoint registers is declared in the manifest too:
   "description": "Greets people by name.",
   "version": "0.1.0",
   "namespace": "widgets",
-  "compatibility": { "sdk": "^0.15.1" },
+  "compatibility": { "sdk": "^0.15.2" },
   "targets": {
     "kay": {
       "agent": {

package/THIRD-PARTY-INVENTORY.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@yaklabs-ai/plugin-sdk",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "target": "npm",
   "firstPartyLicense": "MIT",
   "bundled": [

package/dist/agent-conversation.d.ts

@@ -69,6 +69,41 @@ declare interface AgentConversationSourceNote {
     readonly rowKey: string;
 }
 
+/**
+ * Build the conversation source stream in canonical block order. Callers classify attempts and
+ * custom messages with their presentation policy; only this traversal establishes boundaries.
+ * Structural inputs keep the protocol independent of the renderer and transcript implementation.
+ */
+export declare function buildAgentConversationStream<TAttempt extends {
+    readonly id: string;
+}, TMessage extends {
+    readonly id: string;
+}, TRef>(blocks: readonly CanonicalBlock<TAttempt, TMessage>[], options: {
+    readonly rowKey: string;
+    readonly attempt: (attempt: TAttempt) => AgentConversationSourceItem<TRef> | undefined;
+    readonly message: (message: TMessage, blockId: string) => AgentConversationSourceItem<TRef> | undefined;
+    readonly text?: (block: TextBlock) => "note" | "neutral" | "boundary";
+    readonly owned?: ReadonlySet<string>;
+    readonly neutral?: (id: string, position: number) => void;
+}): readonly AgentConversationSourceItem<TRef>[];
+
+declare type CanonicalBlock<TAttempt, TMessage> = TextBlock | {
+    readonly kind: "work_episode";
+    readonly waves: readonly {
+        readonly attempts: readonly TAttempt[];
+    }[];
+} | {
+    readonly kind: "tool_surface";
+    readonly attempt: TAttempt;
+} | {
+    readonly kind: "custom_message";
+    readonly id: string;
+    readonly message: TMessage;
+} | {
+    readonly kind: "steer_message" | "unknown_activity";
+    readonly id: string;
+};
+
 export declare function groupAgentConversationStream<TRef>(stream: readonly AgentConversationSourceItem<TRef>[]): readonly AgentConversationRun<TRef>[];
 
 export declare function immediateFollowingAgentConversationWave<TAttempt extends {
@@ -90,4 +125,10 @@ export declare function receivedConversation(customType: string | undefined, det
 /** Terminal daemon-run outcomes shared by stored records and conversation results. */
 declare type RunSettlementOutcome = "completed" | "interrupted" | "cancelled" | "failed";
 
+declare type TextBlock = {
+    readonly kind: "narration" | "provisional_response" | "final_answer";
+    readonly id: string;
+    readonly text: string;
+};
+
 export { }

package/dist/agent-conversation.js

@@ -1,3 +1,71 @@
+// packages/plugin-protocol/dist/agent-conversation-stream.js
+function buildAgentConversationStream(blocks, options) {
+  const stream = [];
+  const barBoundaryId = `${options.rowKey}:bar`;
+  const ownedByBar = (id) => {
+    if (options.owned?.has(id) !== true)
+      return false;
+    const last = stream.at(-1);
+    if (last?.kind !== "boundary" || last.id !== barBoundaryId)
+      stream.push({ kind: "boundary", id: barBoundaryId, reason: "surface" });
+    return true;
+  };
+  const pushAttempt = (attempt) => {
+    if (ownedByBar(attempt.id))
+      return;
+    const item = options.attempt(attempt);
+    if (item !== void 0)
+      stream.push(item);
+  };
+  for (const block of blocks) {
+    switch (block.kind) {
+      case "narration":
+      case "provisional_response":
+      case "final_answer": {
+        if (ownedByBar(block.id))
+          break;
+        const kind = options.text?.(block) ?? (block.text.trim() === "" ? "neutral" : "boundary");
+        if (kind === "neutral")
+          options.neutral?.(block.id, stream.length - 0.5);
+        else if (kind === "note")
+          stream.push({ kind: "note", id: block.id, rowKey: options.rowKey });
+        else
+          stream.push({
+            kind: "boundary",
+            id: block.id,
+            reason: "assistant_text"
+          });
+        break;
+      }
+      case "work_episode":
+        for (const wave of block.waves)
+          for (const attempt of wave.attempts)
+            pushAttempt(attempt);
+        break;
+      case "tool_surface":
+        pushAttempt(block.attempt);
+        break;
+      case "custom_message": {
+        if (ownedByBar(block.message.id))
+          break;
+        const item = options.message(block.message, block.id);
+        if (item !== void 0)
+          stream.push(item);
+        else
+          options.neutral?.(block.message.id, stream.length - 0.5);
+        break;
+      }
+      case "steer_message":
+        stream.push({ kind: "boundary", id: block.id, reason: "user" });
+        break;
+      case "unknown_activity":
+        stream.push({ kind: "boundary", id: block.id, reason: "other" });
+        break;
+    }
+  }
+  return stream;
+}
+
 // packages/plugin-protocol/dist/agent-conversation.js
 function workId(work) {
   return work.kind === "activity" ? work.attemptId : work.id;
@@ -167,6 +235,7 @@ function subagentProvenanceOf(record) {
 export {
   admittedSendSessionId,
   admittedSpawnSessionId,
+  buildAgentConversationStream,
   groupAgentConversationStream,
   immediateFollowingAgentConversationWave,
   isFoldedAgentConversationRun,