@canonmsg/backend-contracts 0.2.2 → 0.2.4

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;
     }

package/dist/cjs/turnProtocol.js

@@ -1,14 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.WAITING_INPUT_STALE_THRESHOLD_MS = exports.ACTIVE_TURN_STALE_THRESHOLD_MS = void 0;
 exports.normalizeTurnMetadata = normalizeTurnMetadata;
 exports.isTurnOpen = isTurnOpen;
+exports.getTurnStateStaleThresholdMs = getTurnStateStaleThresholdMs;
+exports.isTurnStateStale = isTurnStateStale;
 exports.resolveTurnMessageSemantics = resolveTurnMessageSemantics;
 exports.shouldPromoteConversationMessage = shouldPromoteConversationMessage;
 exports.shouldTriggerAgentTurn = shouldTriggerAgentTurn;
 exports.normalizeRuntimeTurnState = normalizeRuntimeTurnState;
+exports.ACTIVE_TURN_STALE_THRESHOLD_MS = 30 * 60 * 1000;
+exports.WAITING_INPUT_STALE_THRESHOLD_MS = 12 * 60 * 60 * 1000;
 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;
@@ -33,9 +48,33 @@ function normalizeTurnMetadata(metadata) {
 function isTurnOpen(turnState) {
     if (!turnState)
         return false;
-    return turnState.state !== 'idle'
+    const open = turnState.state !== 'idle'
         && turnState.state !== 'completed'
         && turnState.state !== 'interrupted';
+    if (!open)
+        return false;
+    return !isTurnStateStale(turnState);
+}
+function getTurnStateStaleThresholdMs(state) {
+    return state === 'waiting_input'
+        ? exports.WAITING_INPUT_STALE_THRESHOLD_MS
+        : exports.ACTIVE_TURN_STALE_THRESHOLD_MS;
+}
+function isTurnStateStale(turnState) {
+    if (!turnState)
+        return false;
+    if (turnState.state !== 'thinking'
+        && turnState.state !== 'streaming'
+        && turnState.state !== 'tool'
+        && turnState.state !== 'waiting_input') {
+        return false;
+    }
+    const updatedAt = turnState.turnUpdatedAt
+        ?? turnState.updatedAt
+        ?? turnState.openedAt;
+    if (updatedAt == null)
+        return false;
+    return Date.now() - updatedAt >= getTurnStateStaleThresholdMs(turnState.state);
 }
 function resolveTurnMessageSemantics(input) {
     const turnMetadata = normalizeTurnMetadata(input.metadata);
@@ -48,6 +87,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) {
@@ -71,7 +113,12 @@ function normalizeRuntimeTurnState(value) {
         || value.state === 'waiting_input'
         || value.state === 'completed'
         || value.state === 'interrupted') {
-        return { state: value.state };
+        return {
+            state: value.state,
+            ...(typeof value.openedAt === 'number' ? { openedAt: value.openedAt } : {}),
+            ...(typeof value.updatedAt === 'number' ? { updatedAt: value.updatedAt } : {}),
+            ...(typeof value.turnUpdatedAt === 'number' ? { turnUpdatedAt: value.turnUpdatedAt } : {}),
+        };
     }
     return null;
 }

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;

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;
     }

package/dist/turnProtocol.d.ts

@@ -8,9 +8,16 @@ export interface TurnMetadata {
 }
 export interface TurnStateLike {
     state: TurnLifecycleState;
+    openedAt?: number;
+    updatedAt?: number;
+    turnUpdatedAt?: number | null;
 }
+export declare const ACTIVE_TURN_STALE_THRESHOLD_MS: number;
+export declare const WAITING_INPUT_STALE_THRESHOLD_MS: number;
 export declare function normalizeTurnMetadata(metadata: unknown): TurnMetadata | null;
 export declare function isTurnOpen(turnState: TurnStateLike | null | undefined): boolean;
+export declare function getTurnStateStaleThresholdMs(state: TurnLifecycleState): number;
+export declare function isTurnStateStale(turnState: TurnStateLike | null | undefined): boolean;
 export declare function resolveTurnMessageSemantics(input: {
     senderType: SenderType;
     metadata?: unknown;

package/dist/turnProtocol.js

@@ -1,6 +1,18 @@
+export const ACTIVE_TURN_STALE_THRESHOLD_MS = 30 * 60 * 1000;
+export const WAITING_INPUT_STALE_THRESHOLD_MS = 12 * 60 * 60 * 1000;
 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;
@@ -25,9 +37,33 @@ export function normalizeTurnMetadata(metadata) {
 export function isTurnOpen(turnState) {
     if (!turnState)
         return false;
-    return turnState.state !== 'idle'
+    const open = turnState.state !== 'idle'
         && turnState.state !== 'completed'
         && turnState.state !== 'interrupted';
+    if (!open)
+        return false;
+    return !isTurnStateStale(turnState);
+}
+export function getTurnStateStaleThresholdMs(state) {
+    return state === 'waiting_input'
+        ? WAITING_INPUT_STALE_THRESHOLD_MS
+        : ACTIVE_TURN_STALE_THRESHOLD_MS;
+}
+export function isTurnStateStale(turnState) {
+    if (!turnState)
+        return false;
+    if (turnState.state !== 'thinking'
+        && turnState.state !== 'streaming'
+        && turnState.state !== 'tool'
+        && turnState.state !== 'waiting_input') {
+        return false;
+    }
+    const updatedAt = turnState.turnUpdatedAt
+        ?? turnState.updatedAt
+        ?? turnState.openedAt;
+    if (updatedAt == null)
+        return false;
+    return Date.now() - updatedAt >= getTurnStateStaleThresholdMs(turnState.state);
 }
 export function resolveTurnMessageSemantics(input) {
     const turnMetadata = normalizeTurnMetadata(input.metadata);
@@ -40,6 +76,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) {
@@ -63,7 +102,12 @@ export function normalizeRuntimeTurnState(value) {
         || value.state === 'waiting_input'
         || value.state === 'completed'
         || value.state === 'interrupted') {
-        return { state: value.state };
+        return {
+            state: value.state,
+            ...(typeof value.openedAt === 'number' ? { openedAt: value.openedAt } : {}),
+            ...(typeof value.updatedAt === 'number' ? { updatedAt: value.updatedAt } : {}),
+            ...(typeof value.turnUpdatedAt === 'number' ? { turnUpdatedAt: value.turnUpdatedAt } : {}),
+        };
     }
     return null;
 }

package/package.json

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