@canonmsg/agent-sdk 1.6.0 → 1.7.0

package/dist/canon-agent.js

@@ -1,4 +1,4 @@
-import { ApprovalManager, CanonClient, buildCanonGroupContext, createRuntimeStatePublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeInputOutcome, initRTDBAuth, rtdbRead, rtdbWrite, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, } from '@canonmsg/core';
+import { ApprovalManager, CanonClient, buildCanonGroupContext, createTurnOutputController, createRuntimeStatePublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeInputOutcome, initRTDBAuth, rtdbRead, rtdbWrite, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, } from '@canonmsg/core';
 import { randomUUID } from 'node:crypto';
 import { AuthManager } from './auth.js';
 import { Debouncer } from './debouncer.js';
@@ -1112,21 +1112,23 @@ export class CanonAgent {
                     : {}),
             })).catch(() => { });
         };
+        const turnOutput = createTurnOutputController({
+            turnId,
+            mode: 'snapshot',
+            writeSnapshot: (snapshot) => this.apiClient.setStreaming({
+                conversationId,
+                text: snapshot.text,
+                status: snapshot.status,
+                messageId: snapshot.messageId,
+                turnId: snapshot.turnId,
+            }),
+            clearSnapshot: () => this.apiClient.clearStreaming(conversationId),
+        });
         const setLiveState = async (state, text, streamingStatus) => {
             throwIfAborted();
             await writeTurn(state);
             if (streamingStatus) {
-                try {
-                    await this.apiClient.setStreaming({
-                        conversationId,
-                        text: text ?? '',
-                        status: streamingStatus,
-                        messageId: turnId,
-                    });
-                }
-                catch {
-                    // Non-critical
-                }
+                await turnOutput.setStatus(streamingStatus, text ?? '');
             }
         };
         // Show thinking indicator and keep it alive (5s client-side expiry)
@@ -1140,12 +1142,7 @@ export class CanonAgent {
         const thinkingKeepalive = setInterval(() => {
             this.apiClient.setTyping(conversationId, true, 'thinking').catch(() => { });
             if (turnState === 'thinking') {
-                this.apiClient.setStreaming({
-                    conversationId,
-                    text: 'Thinking...',
-                    status: 'thinking',
-                    messageId: turnId,
-                }).catch(() => { });
+                turnOutput.setStatus('thinking', 'Thinking...').catch(() => { });
             }
         }, 3500);
         try {
@@ -1331,7 +1328,7 @@ export class CanonAgent {
                 shouldPersistTurnState = true;
                 try {
                     try {
-                        await this.apiClient.clearStreaming(conversationId);
+                        await turnOutput.waitingInput();
                     }
                     catch { }
                     await writeTurn('waiting_input');
@@ -1408,7 +1405,7 @@ export class CanonAgent {
                     });
                     requestCreated = true;
                     try {
-                        await this.apiClient.clearStreaming(conversationId);
+                        await turnOutput.waitingInput();
                     }
                     catch { }
                     await writeTurn('waiting_input');
@@ -1586,13 +1583,34 @@ export class CanonAgent {
                     setStreaming: async (text) => {
                         await setLiveState('streaming', text, 'streaming');
                     },
+                    appendDelta: (delta) => {
+                        throwIfAborted();
+                        turnState = 'streaming';
+                        turnOutput.appendDelta(delta);
+                        void writeTurn('streaming');
+                    },
+                    appendBlock: (block) => {
+                        throwIfAborted();
+                        turnState = 'streaming';
+                        turnOutput.appendBlock(block);
+                        void writeTurn('streaming');
+                    },
+                    replaceSnapshot: async (text) => {
+                        await setLiveState('streaming', text, 'streaming');
+                    },
+                    flush: async () => {
+                        await turnOutput.flush();
+                    },
+                    clear: async () => {
+                        await turnOutput.clear();
+                    },
                     setTool: async (text) => {
                         await setLiveState('tool', text, 'tool');
                     },
                     setWaitingInput: async (text) => {
                         shouldPersistTurnState = true;
                         try {
-                            await this.apiClient.clearStreaming(conversationId);
+                            await turnOutput.waitingInput();
                         }
                         catch { }
                         await writeTurn('waiting_input');
@@ -1648,7 +1666,7 @@ export class CanonAgent {
             }
             catch { }
             try {
-                await this.apiClient.clearStreaming(conversationId);
+                await turnOutput.clear();
             }
             catch { }
             if (runtimeState && !shouldPersistTurnState) {

package/dist/types.d.ts

@@ -31,6 +31,11 @@ export interface TurnController {
     state: import('@canonmsg/core').TurnLifecycleState;
     setThinking: (text?: string) => Promise<void>;
     setStreaming: (text: string) => Promise<void>;
+    appendDelta: (delta: string) => void;
+    appendBlock: (block: string) => void;
+    replaceSnapshot: (text: string) => Promise<void>;
+    flush: () => Promise<void>;
+    clear: () => Promise<void>;
     setTool: (text: string) => Promise<void>;
     setWaitingInput: (text?: string) => Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Canon Agent SDK — build AI agents that participate in Canon conversations",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@canonmsg/core": "^0.22.0"
+    "@canonmsg/core": "^0.24.0"
   },
   "publishConfig": {
     "access": "public"