@canonmsg/agent-sdk 3.2.2 → 3.2.4

package/dist/canon-agent.js

@@ -910,9 +910,10 @@ export class CanonAgent {
     }
     async handleRuntimePrimitiveEvent(event) {
         // Requests only belong to this runtime once primitive handlers exist —
-        // leave them untouched otherwise (the legacy loop never read the key).
+        // defer otherwise: the request stays in RTDB AND unseen, so a handler
+        // registered via onPrimitive() after start still receives it.
         if (!this.hasRuntimePrimitiveSupport())
-            return { consume: false };
+            return { defer: true };
         const { conversationId, requestId, value } = event;
         const primitive = value.id;
         // Unknown primitives and unhandled ids fall through so the poller
@@ -935,10 +936,11 @@ export class CanonAgent {
         });
     }
     async handleRuntimeSignalEvent(event) {
-        // Signals only belong to this runtime once signal handlers exist — leave
-        // them untouched otherwise (the legacy loop never read the key).
+        // Signals only belong to this runtime once signal handlers exist — defer
+        // otherwise: the signal stays in RTDB AND unseen, so a handler registered
+        // via on('interrupt' | ...) after start still receives it.
         if (!this.hasRuntimeSignalSupport())
-            return { consume: false };
+            return { defer: true };
         const { conversationId, type: signal, updatedAt } = event;
         const handler = signal === 'new_session'
             ? this.newSessionHandler

package/dist/realtime.d.ts

@@ -19,6 +19,7 @@ export declare class RealtimeManager {
     /** Lower bound for catch-up in conversations with no in-memory cursor. */
     private readonly replaySyncStartedAt;
     private replayCatchupInFlight;
+    private hasConnectedOnce;
     private lastSseErrorKey;
     private lastSseErrorAt;
     private suppressedSseErrorCount;
@@ -33,6 +34,7 @@ export declare class RealtimeManager {
     private onConnected;
     private onDisconnected;
     constructor(apiKey: string, debouncer: Debouncer, agentId: string, streamUrl?: string, apiClient?: CanonClient);
+    private queueReplayCatchup;
     private hasSeenInboundMessage;
     private recordSeenInboundMessage;
     private pruneRecentInboundMessageIds;

package/dist/realtime.js

@@ -34,6 +34,7 @@ export class RealtimeManager {
     /** Lower bound for catch-up in conversations with no in-memory cursor. */
     replaySyncStartedAt = Date.now();
     replayCatchupInFlight = null;
+    hasConnectedOnce = false;
     lastSseErrorKey = null;
     lastSseErrorAt = 0;
     suppressedSseErrorCount = 0;
@@ -122,16 +123,19 @@ export class RealtimeManager {
                 },
                 onConnected: () => {
                     // Reset backoff is handled internally by CanonStream
+                    const shouldCatchUp = this.hasConnectedOnce;
+                    this.hasConnectedOnce = true;
                     this.onConnected?.();
+                    if (shouldCatchUp) {
+                        this.queueReplayCatchup();
+                    }
                 },
                 onDisconnected: () => {
                     this.onDisconnected?.();
                 },
                 onReplayExpired: (payload) => {
                     console.error(`[canon-sdk] SSE replay window expired${payload.lastAvailableId ? ` (oldest available event: ${payload.lastAvailableId})` : ''} — catching up over REST`);
-                    this.replayCatchupInFlight ??= this.runReplayCatchup().finally(() => {
-                        this.replayCatchupInFlight = null;
-                    });
+                    this.queueReplayCatchup();
                 },
                 onError: (err) => {
                     this.logSseError(err);
@@ -139,6 +143,11 @@ export class RealtimeManager {
             },
         });
     }
+    queueReplayCatchup() {
+        this.replayCatchupInFlight ??= this.runReplayCatchup().finally(() => {
+            this.replayCatchupInFlight = null;
+        });
+    }
     hasSeenInboundMessage(conversationId, messageId) {
         return this.recentInboundMessageIds.has(`${conversationId}:${messageId}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "3.2.2",
+  "version": "3.2.4",
   "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.4.1"
+    "@canonmsg/core": "^2.6.0"
   },
   "publishConfig": {
     "access": "public"