@canonmsg/agent-sdk 3.2.5 → 3.3.1

package/dist/canon-agent.js

@@ -1,5 +1,5 @@
-import { ApprovalManager, CanonClient, ControlChannelPoller, buildCanonTurnContextV2, buildCanonGroupContext, buildParticipationHistorySnapshot, createTurnOutputController, createRuntimeStatePublisher, createTypingStatusPublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeCardOutcome, buildRuntimeInputOutcome, initRTDBAuth, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, renderCanonHostInboundContent, } from '@canonmsg/core';
-import { randomUUID } from 'node:crypto';
+import { ApprovalManager, CanonClient, ControlChannelPoller, buildCanonTurnContextV2, buildCanonGroupContext, buildParticipationHistorySnapshot, createTurnOutputController, createRuntimeStatePublisher, createTypingStatusPublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeCardOutcome, buildRuntimeInputOutcome, initRTDBAuth, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, renderCanonHostInboundContent, sendMessageWithRetry, } from '@canonmsg/core';
+import { createHash, randomUUID } from 'node:crypto';
 import { AuthManager } from './auth.js';
 import { Debouncer } from './debouncer.js';
 import { buildRuntimeCardCreateArgs } from './runtime-card.js';
@@ -12,6 +12,7 @@ const RUNTIME_PRIMITIVE_DEDUPE_MAX = 1_000;
 const DEFAULT_RUNTIME_INPUT_TIMEOUT_MS = 5 * 60_000;
 const RUNTIME_INPUT_POLL_MS = 1_000;
 const RUNTIME_INPUT_ID_PATTERN = /^[A-Za-z0-9_.:-]{1,160}$/;
+const SDK_MESSAGE_ID_READABLE_MAX = 120;
 const SDK_RUNTIME_CAPABILITIES = {
     supportsInterrupt: false,
     supportsInputInterrupt: false,
@@ -32,8 +33,8 @@ const DEFAULT_SDK_RUNTIME_DESCRIPTOR = {
             responder: 'agent_owner',
             result: 'action_or_values',
             maxTimeoutMs: 30 * 60_000,
-            blockKinds: ['summary', 'metricGrid', 'chart', 'table', 'list', 'callout', 'actions'],
-            actionFieldTypes: ['text', 'textarea', 'select', 'multiSelect', 'boolean'],
+            blockKinds: ['summary', 'metricGrid', 'chart', 'table', 'list', 'callout', 'actions', 'mediaPreview', 'details'],
+            actionFieldTypes: ['text', 'textarea', 'select', 'multiSelect', 'boolean', 'date', 'number', 'currency', 'searchSelect', 'lineItems'],
             native: true,
         },
     },
@@ -167,6 +168,19 @@ function safeRuntimeCardId(value) {
         ? normalized
         : `card_${randomUUID()}`;
 }
+function buildSdkMessageId(parts) {
+    const raw = parts
+        .map((part) => part == null ? '' : String(part))
+        .filter(Boolean)
+        .join(':');
+    const hash = createHash('sha256').update(raw || 'sdk-message').digest('hex').slice(0, 16);
+    const readable = (raw || 'sdk-message')
+        .replace(/[^A-Za-z0-9_.:-]+/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^[:_.-]+|[:_.-]+$/g, '')
+        .slice(0, SDK_MESSAGE_ID_READABLE_MAX);
+    return `${readable || 'sdk-message'}:${hash}`;
+}
 function isRuntimePrimitiveId(value) {
     return value === 'runtime.status'
         || value === 'runtime.reasoning.set'
@@ -1101,6 +1115,7 @@ export class CanonAgent {
         const turnOpenedAt = Date.now();
         let turnState = 'thinking';
         let shouldPersistTurnState = false;
+        let durableMessageSequence = 0;
         const agentId = this.agentId;
         const runtimeState = this.createRuntimeStatePublisher();
         const queueDepth = () => this.sessionManager?.getQueueDepth(conversationId) ?? 0;
@@ -1208,7 +1223,7 @@ export class CanonAgent {
                 throwIfAborted();
                 const sendOptions = withActiveSelfContext(options);
                 const turnTrail = turnOutput.getFinalTrail();
-                const result = await this.apiClient.sendMessage(conversationId, text, {
+                const result = await sendDurableMessage(text, {
                     ...sendOptions,
                     metadata: {
                         ...(sendOptions.metadata ?? {}),
@@ -1216,7 +1231,7 @@ export class CanonAgent {
                         turnSemantics: 'turn_complete',
                         ...(turnTrail.length > 0 ? { turnTrail } : {}),
                     },
-                });
+                }, ['sdk', 'final', conversationId, turnId]);
                 await sleep(FINAL_MESSAGE_HANDOFF_MS);
                 try {
                     await this.typingSignals.clear(conversationId);
@@ -1266,6 +1281,16 @@ export class CanonAgent {
                     return base;
                 return activeSelfContextId ? { ...base, selfContextId: activeSelfContextId } : base;
             };
+            const sendDurableMessage = (text, options, fallbackMessageIdParts) => {
+                const messageId = options?.messageId
+                    ?? buildSdkMessageId([...fallbackMessageIdParts, durableMessageSequence += 1]);
+                return sendMessageWithRetry(this.apiClient, conversationId, text, {
+                    ...(options ?? {}),
+                    messageId,
+                }, {
+                    sleep: (ms) => sleepWithAbort(ms, abortController.signal),
+                });
+            };
             // Build agent context (fallback to minimal if not yet received)
             const agent = this.agentContext ?? {
                 agentId: this.agentId,
@@ -1549,14 +1574,14 @@ export class CanonAgent {
                         kind: request.kind,
                         reason: result.status,
                     });
-                    await this.apiClient.sendMessage(conversationId, outcome.text, {
+                    await sendDurableMessage(outcome.text, {
                         metadata: {
                             ...outcome.metadata,
                             turnId: request.turnId ?? turnId,
                             turnSemantics: 'control',
                             replyBehavior: 'suppress_auto_reply',
                         },
-                    });
+                    }, ['sdk', 'runtime-input-outcome', conversationId, request.turnId ?? turnId, inputId, result.status]);
                     throwIfAborted();
                     shouldPersistTurnState = false;
                     try {
@@ -1725,14 +1750,14 @@ export class CanonAgent {
                     const outcome = buildRuntimeCardOutcome(cardId, resolutionStatus, {
                         reason: resolutionStatus,
                     });
-                    await this.apiClient.sendMessage(conversationId, outcome.text, {
+                    await sendDurableMessage(outcome.text, {
                         metadata: {
                             ...outcome.metadata,
                             turnId: request.turnId ?? turnId,
                             turnSemantics: 'control',
                             replyBehavior: 'suppress_auto_reply',
                         },
-                    });
+                    }, ['sdk', 'runtime-card-outcome', conversationId, request.turnId ?? turnId, cardId, resolutionStatus]);
                     throwIfAborted();
                     shouldPersistTurnState = false;
                     try {
@@ -1754,14 +1779,14 @@ export class CanonAgent {
                     if (abortController.signal.aborted || isAbortLikeError(error)) {
                         if (shouldSendInterruptedOutcome) {
                             const outcome = buildRuntimeCardOutcome(cardId, 'cancelled', { reason: 'interrupted' });
-                            await this.apiClient.sendMessage(conversationId, outcome.text, {
+                            await sendDurableMessage(outcome.text, {
                                 metadata: {
                                     ...outcome.metadata,
                                     turnId: request.turnId ?? turnId,
                                     turnSemantics: 'control',
                                     replyBehavior: 'suppress_auto_reply',
                                 },
-                            }).catch(() => { });
+                            }, ['sdk', 'runtime-card-outcome', conversationId, request.turnId ?? turnId, cardId, 'interrupted']).catch(() => { });
                         }
                         throw error;
                     }
@@ -1886,6 +1911,18 @@ export class CanonAgent {
                         turnOutput.appendBlock(block);
                         void writeTurn('streaming');
                     },
+                    appendTextSegmentDelta: (id, delta) => {
+                        throwIfAborted();
+                        turnState = 'streaming';
+                        turnOutput.appendTextSegmentDelta(id, delta);
+                        void writeTurn('streaming');
+                    },
+                    replaceTextSegmentSnapshot: (id, text) => {
+                        throwIfAborted();
+                        turnState = 'streaming';
+                        turnOutput.replaceTextSegmentSnapshot(id, text);
+                        void writeTurn('streaming');
+                    },
                     addBlock: async (block) => {
                         throwIfAborted();
                         return turnOutput.addBlock(block);
@@ -1933,13 +1970,13 @@ export class CanonAgent {
                         }
                         catch { }
                         if (text) {
-                            await this.apiClient.sendMessage(conversationId, text, {
+                            await sendDurableMessage(text, {
                                 metadata: {
                                     turnId,
                                     turnSemantics: 'control',
                                     replyBehavior: 'suppress_auto_reply',
                                 },
-                            });
+                            }, ['sdk', 'waiting-input-note', conversationId, turnId]);
                         }
                     },
                 },

package/dist/types.d.ts

@@ -33,6 +33,8 @@ export interface TurnController {
     setStreaming: (text: string) => Promise<void>;
     appendDelta: (delta: string) => void;
     appendBlock: (block: string) => void;
+    appendTextSegmentDelta: (id: string, delta: string) => void;
+    replaceTextSegmentSnapshot: (id: string, text: string) => void;
     addBlock: (block: TurnOutputBlockInput) => Promise<TurnOutputBlock>;
     updateBlock: (id: string, patch: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence'>>) => Promise<TurnOutputBlock | null>;
     completeBlock: (id: string, patch?: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence' | 'status'>>) => Promise<TurnOutputBlock | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "3.2.5",
+  "version": "3.3.1",
   "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": "^2.6.2"
+    "@canonmsg/core": "^2.8.1"
   },
   "publishConfig": {
     "access": "public"