@invergent/agent-chat-react 2.11.4 → 2.13.0

package/dist/index.d.cts

@@ -357,6 +357,12 @@ interface AgentChatInboxItem {
     payload: Record<string, unknown>;
     actionRef: Record<string, unknown> | null;
     createdAt: string;
+    /**
+     * When the item stops being actionable, for the kinds that have a
+     * deadline — today only a question, which is answerable while its tool
+     * call is parked waiting. Null when nothing expires.
+     */
+    expiresAt?: string | null;
     updatedAt: string;
     readAt: string | null;
     respondedAt: string | null;
@@ -368,8 +374,17 @@ interface AgentChatInboxList {
     nextCursor: string | null;
 }
 interface AgentChatInboxListInput {
-    status?: AgentChatInboxStatus;
-    kind?: AgentChatInboxKind;
+    /**
+     * A history view needs several statuses at once (acknowledged,
+     * responded and expired), and expired items are invisible to any
+     * request that does not name them.
+     */
+    status?: AgentChatInboxStatus | AgentChatInboxStatus[];
+    /**
+     * Active and Updates are two lists over the same statuses, split by
+     * kind: what needs an answer, and what is only news.
+     */
+    kind?: AgentChatInboxKind | AgentChatInboxKind[];
     sessionId?: string;
     cursor?: string;
     limit?: number;
@@ -1248,6 +1263,14 @@ interface InboxUnreadCountState {
     hasLoaded: boolean;
     error: string | null;
 }
+/**
+ * How many pending inbox items the user has not opened.
+ *
+ * Re-derived from the list on every signal rather than adjusted in
+ * place: the stream carries "something changed", not a delta, so
+ * counting its nudges only ever pushed the badge up — it never came back
+ * down when the user read, answered or dismissed an item.
+ */
 declare function useInboxUnreadCount(adapter: AgentChatAdapter): InboxUnreadCountState;
 
 interface MissionDashboardProps {

package/dist/index.d.ts

@@ -357,6 +357,12 @@ interface AgentChatInboxItem {
     payload: Record<string, unknown>;
     actionRef: Record<string, unknown> | null;
     createdAt: string;
+    /**
+     * When the item stops being actionable, for the kinds that have a
+     * deadline — today only a question, which is answerable while its tool
+     * call is parked waiting. Null when nothing expires.
+     */
+    expiresAt?: string | null;
     updatedAt: string;
     readAt: string | null;
     respondedAt: string | null;
@@ -368,8 +374,17 @@ interface AgentChatInboxList {
     nextCursor: string | null;
 }
 interface AgentChatInboxListInput {
-    status?: AgentChatInboxStatus;
-    kind?: AgentChatInboxKind;
+    /**
+     * A history view needs several statuses at once (acknowledged,
+     * responded and expired), and expired items are invisible to any
+     * request that does not name them.
+     */
+    status?: AgentChatInboxStatus | AgentChatInboxStatus[];
+    /**
+     * Active and Updates are two lists over the same statuses, split by
+     * kind: what needs an answer, and what is only news.
+     */
+    kind?: AgentChatInboxKind | AgentChatInboxKind[];
     sessionId?: string;
     cursor?: string;
     limit?: number;
@@ -1248,6 +1263,14 @@ interface InboxUnreadCountState {
     hasLoaded: boolean;
     error: string | null;
 }
+/**
+ * How many pending inbox items the user has not opened.
+ *
+ * Re-derived from the list on every signal rather than adjusted in
+ * place: the stream carries "something changed", not a delta, so
+ * counting its nudges only ever pushed the badge up — it never came back
+ * down when the user read, answered or dismissed an item.
+ */
 declare function useInboxUnreadCount(adapter: AgentChatAdapter): InboxUnreadCountState;
 
 interface MissionDashboardProps {