@canonmsg/backend-contracts 0.2.3 → 0.2.4

package/dist/cjs/turnProtocol.js

@@ -1,11 +1,16 @@
 "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);
 }
@@ -43,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);
@@ -84,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/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,3 +1,5 @@
+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);
 }
@@ -35,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);
@@ -76,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.3",
+  "version": "0.2.4",
   "description": "Canon backend contract helpers shared by Functions and stream-service",
   "type": "module",
   "main": "dist/cjs/index.js",