@canonmsg/backend-contracts 0.2.1 → 0.2.3

package/dist/cjs/contactRequest.js

@@ -57,6 +57,11 @@ function serializeContactRequest(requestId, data) {
         requesterName: typeof data.requesterName === 'string' ? data.requesterName : 'Unknown',
         requesterAvatarUrl: typeof data.requesterAvatarUrl === 'string' ? data.requesterAvatarUrl : null,
         targetId: data.targetId,
+        targetName: typeof data.targetName === 'string' ? data.targetName : null,
+        targetAvatarUrl: typeof data.targetAvatarUrl === 'string' ? data.targetAvatarUrl : null,
+        targetUserType: data.targetUserType === 'human' || data.targetUserType === 'ai_agent'
+            ? data.targetUserType
+            : null,
         approverId: data.approverId,
         message: typeof data.message === 'string' ? data.message : null,
         status: normalizeStatus(data.status),
@@ -68,5 +73,8 @@ function serializeContactRequest(requestId, data) {
     if (groupContext) {
         payload.groupContext = groupContext;
     }
+    if (typeof data.targetOwnerId === 'string' && data.targetOwnerId.length > 0) {
+        payload.targetOwnerId = data.targetOwnerId;
+    }
     return payload;
 }

package/dist/cjs/message.js

@@ -34,6 +34,7 @@ function normalizeAgentClientType(value) {
     if (value === 'claude-code'
         || value === 'openclaw'
         || value === 'codex'
+        || value === 'hermes'
         || value === 'generic') {
         return value;
     }
@@ -122,9 +123,6 @@ function serializeStoredMessage(input) {
     if (typeof input.senderName === 'string') {
         result.senderName = input.senderName;
     }
-    if (data.workSession !== undefined && data.workSession !== null) {
-        result.workSession = data.workSession;
-    }
     if (isRecord(data.metadata)) {
         result.metadata = data.metadata;
     }

package/dist/cjs/turnProtocol.js

@@ -9,6 +9,16 @@ exports.normalizeRuntimeTurnState = normalizeRuntimeTurnState;
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function isHiddenRuntimeCardMetadata(metadata) {
+    if (!isRecord(metadata) || typeof metadata.type !== 'string')
+        return false;
+    return metadata.type === 'approval_reply'
+        || metadata.type === 'approval_outcome'
+        || metadata.type === 'question_reply'
+        || metadata.type === 'plan_approval_reply'
+        || metadata.type === 'runtime_input_reply'
+        || metadata.type === 'runtime_input_outcome';
+}
 function normalizeTurnMetadata(metadata) {
     if (!isRecord(metadata))
         return null;
@@ -48,6 +58,9 @@ function resolveTurnMessageSemantics(input) {
     return isTurnOpen(input.senderTurnState) ? 'progress' : 'turn_complete';
 }
 function shouldPromoteConversationMessage(input) {
+    if (isHiddenRuntimeCardMetadata(input.metadata)) {
+        return false;
+    }
     return resolveTurnMessageSemantics(input) !== 'progress';
 }
 function shouldTriggerAgentTurn(input) {

package/dist/contactRequest.d.ts

@@ -5,6 +5,10 @@ export interface SerializedContactRequest {
     requesterName: string;
     requesterAvatarUrl: string | null;
     targetId: string;
+    targetName: string | null;
+    targetAvatarUrl: string | null;
+    targetUserType: 'human' | 'ai_agent' | null;
+    targetOwnerId?: string | null;
     approverId: string;
     message: string | null;
     status: SerializedContactRequestStatus;

package/dist/contactRequest.js

@@ -54,6 +54,11 @@ export function serializeContactRequest(requestId, data) {
         requesterName: typeof data.requesterName === 'string' ? data.requesterName : 'Unknown',
         requesterAvatarUrl: typeof data.requesterAvatarUrl === 'string' ? data.requesterAvatarUrl : null,
         targetId: data.targetId,
+        targetName: typeof data.targetName === 'string' ? data.targetName : null,
+        targetAvatarUrl: typeof data.targetAvatarUrl === 'string' ? data.targetAvatarUrl : null,
+        targetUserType: data.targetUserType === 'human' || data.targetUserType === 'ai_agent'
+            ? data.targetUserType
+            : null,
         approverId: data.approverId,
         message: typeof data.message === 'string' ? data.message : null,
         status: normalizeStatus(data.status),
@@ -65,5 +70,8 @@ export function serializeContactRequest(requestId, data) {
     if (groupContext) {
         payload.groupContext = groupContext;
     }
+    if (typeof data.targetOwnerId === 'string' && data.targetOwnerId.length > 0) {
+        payload.targetOwnerId = data.targetOwnerId;
+    }
     return payload;
 }

package/dist/message.d.ts

@@ -1,6 +1,6 @@
 import { MediaAttachment } from './media.js';
 export type SerializedSenderType = 'human' | 'ai_agent';
-export type SerializedAgentClientType = 'claude-code' | 'openclaw' | 'codex' | 'generic';
+export type SerializedAgentClientType = 'claude-code' | 'openclaw' | 'codex' | 'hermes' | 'generic';
 export type SerializedContentType = 'text' | 'image' | 'audio' | 'file' | 'contact_card';
 export interface ForwardedFrom {
     sourceConversationId: string;
@@ -34,7 +34,6 @@ export interface SerializedMessage {
     forwardedFrom?: ForwardedFrom;
     status: 'sent' | 'read';
     createdAt: string;
-    workSession?: unknown;
     metadata?: Record<string, unknown>;
     contactCard?: SerializedContactCard;
 }

package/dist/message.js

@@ -31,6 +31,7 @@ function normalizeAgentClientType(value) {
     if (value === 'claude-code'
         || value === 'openclaw'
         || value === 'codex'
+        || value === 'hermes'
         || value === 'generic') {
         return value;
     }
@@ -119,9 +120,6 @@ export function serializeStoredMessage(input) {
     if (typeof input.senderName === 'string') {
         result.senderName = input.senderName;
     }
-    if (data.workSession !== undefined && data.workSession !== null) {
-        result.workSession = data.workSession;
-    }
     if (isRecord(data.metadata)) {
         result.metadata = data.metadata;
     }

package/dist/turnProtocol.js

@@ -1,6 +1,16 @@
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function isHiddenRuntimeCardMetadata(metadata) {
+    if (!isRecord(metadata) || typeof metadata.type !== 'string')
+        return false;
+    return metadata.type === 'approval_reply'
+        || metadata.type === 'approval_outcome'
+        || metadata.type === 'question_reply'
+        || metadata.type === 'plan_approval_reply'
+        || metadata.type === 'runtime_input_reply'
+        || metadata.type === 'runtime_input_outcome';
+}
 export function normalizeTurnMetadata(metadata) {
     if (!isRecord(metadata))
         return null;
@@ -40,6 +50,9 @@ export function resolveTurnMessageSemantics(input) {
     return isTurnOpen(input.senderTurnState) ? 'progress' : 'turn_complete';
 }
 export function shouldPromoteConversationMessage(input) {
+    if (isHiddenRuntimeCardMetadata(input.metadata)) {
+        return false;
+    }
     return resolveTurnMessageSemantics(input) !== 'progress';
 }
 export function shouldTriggerAgentTurn(input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/backend-contracts",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Canon backend contract helpers shared by Functions and stream-service",
   "type": "module",
   "main": "dist/cjs/index.js",