@ai-matrx/chat 0.4.21 → 0.4.22

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @ai-matrx/chat
 
+## 0.4.22
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.4.21..npm/chat/v0.4.22 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.4.21 — Queued lines show their wait and their delivery
+
+- The waiting-messages strip shows how long each queued line has waited (a live 1 s timer), and
+  when the agent takes a line it flashes "Delivered · waited 12s" for 1.6 s before clearing.
+  New slice actions `deliverInboxItem` / `clearDeliveredInboxItem` and selector
+  `selectDeliveredInboxItems`; delivery still leaves the queue exactly like a removal, so
+  `selectInboxItemStatus` reads `null` on delivery as before. Ported from the browser extension.
+
 ## 0.4.21
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agents/components/inputs/smart-input/InboxQueueStrip.d.ts

@@ -20,6 +20,13 @@ import React from "react";
 interface InboxQueueStripProps {
     conversationId: string;
 }
+/** How long a delivered line keeps its "Delivered" moment before it clears (ms). */
+export declare const DELIVERED_LINGER_MS = 1600;
+/**
+ * How long a line has waited — kit's `compact` elapsed voice, floored to whole
+ * seconds and rounded DOWN so the 1 s ticker never shows time that has not passed.
+ */
+export declare function waitedLabel(fromIso: string, toMs: number): string;
 /**
  * Delivered collab notes are prefixed "[Collaboration note] Agent '<name>' …"
  * server-side; the queued text carries the same prefix. Pull the agent name

package/dist/agents/components/inputs/smart-input/InboxQueueStrip.js

@@ -1,8 +1,10 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import React, { useState } from "react";
+import React, { useEffect, useState } from "react";
+import { formatDurationSeconds } from "@ai-matrx/kit/format";
 import {
   ArrowUp,
+  Check,
   CircleHelp,
   Clock,
   Handshake,
@@ -19,7 +21,10 @@ import {
   TooltipContent,
   TooltipTrigger
 } from "@ai-matrx/design-system";
-import { selectInboxItems } from "../../../redux/execution-system/inbox/inbox.selectors.js";
+import {
+  selectDeliveredInboxItems,
+  selectInboxItems
+} from "../../../redux/execution-system/inbox/inbox.selectors.js";
 import { TERMINAL_RUNTIME_STATUSES } from "../../../runtime-reconnect/types.js";
 import { selectIsExecuting } from "../../../redux/execution-system/selectors/aggregate.selectors.js";
 import {
@@ -29,11 +34,27 @@ import {
   editInboxItem
 } from "../../../redux/execution-system/inbox/inbox.thunks.js";
 import {
+  clearDeliveredInboxItem,
   removeInboxItem
 } from "../../../redux/execution-system/inbox/inbox.slice.js";
 import { Button } from "@ai-matrx/design-system/controls";
 import { useConversationAbilities } from "../../../redux/execution-system/host-conversations/conversation-abilities.js";
 const queueActionClassName = "h-11 w-11 min-h-11 min-w-11 shrink-0 rounded p-0 text-muted-foreground hover:bg-muted hover:text-foreground lg:h-8 lg:w-8 lg:min-h-8 lg:min-w-8";
+const DELIVERED_LINGER_MS = 1600;
+function waitedLabel(fromIso, toMs) {
+  const seconds = Math.max(0, Math.floor((toMs - Date.parse(fromIso)) / 1e3));
+  return formatDurationSeconds(seconds, { style: "compact", round: "down" });
+}
+function useSecondTicker(active) {
+  const [now, setNow] = useState(() => Date.now());
+  useEffect(() => {
+    if (!active) return;
+    setNow(Date.now());
+    const id = setInterval(() => setNow(Date.now()), 1e3);
+    return () => clearInterval(id);
+  }, [active]);
+  return now;
+}
 function statusLabel(item, running) {
   if (item.status === "failed") return item.error ?? "Failed to send";
   if (item.status === "sending") return "Sending\u2026";
@@ -71,7 +92,22 @@ function InboxQueueStripBody({ conversationId }) {
     /* @__PURE__ */ new Set()
   );
   const visible = items.filter((i) => i.isVisibleToUser || isCollabNoteItem(i));
-  if (visible.length === 0) return null;
+  const delivered = useAppSelector(selectDeliveredInboxItems(conversationId));
+  const hasWaiting = visible.some(
+    (i) => (i.status === "pending" || i.status === "sending") && !isCollabNoteItem(i)
+  );
+  const now = useSecondTicker(hasWaiting);
+  useEffect(() => {
+    if (delivered.length === 0) return;
+    const timers = delivered.map(
+      (d) => setTimeout(
+        () => dispatch(clearDeliveredInboxItem({ conversationId, injectionId: d.injectionId })),
+        Math.max(0, DELIVERED_LINGER_MS - (Date.now() - Date.parse(d.deliveredAt)))
+      )
+    );
+    return () => timers.forEach(clearTimeout);
+  }, [delivered, conversationId, dispatch]);
+  if (visible.length === 0 && delivered.length === 0) return null;
   const isDeparting = (item) => !isCollabNoteItem(item) && (item.mode === "steer" || promotingIds.has(item.injectionId));
   const departing = visible.filter(isDeparting);
   const waiting = visible.filter((item) => !isDeparting(item));
@@ -142,13 +178,16 @@ function InboxQueueStripBody({ conversationId }) {
                   )
                 ] }),
                 /* @__PURE__ */ jsxs(Tooltip, { children: [
-                  /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsx(
+                  /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
                     "span",
                     {
                       tabIndex: 0,
                       role: "status",
                       className: `block truncate rounded-sm text-[11px] leading-4 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring lg:cursor-help ${failed ? "text-destructive" : "text-muted-foreground"}`,
-                      children: promoting ? "Sending\u2026" : statusLabel(item, running)
+                      children: [
+                        promoting ? "Sending\u2026" : statusLabel(item, running),
+                        (item.status === "pending" || item.status === "sending") && !collabNote ? ` \xB7 ${waitedLabel(item.queuedAt, now)}` : null
+                      ]
                     }
                   ) }),
                   /* @__PURE__ */ jsx(TooltipContent, { side: "top", className: "max-w-[20rem]", children: statusHelp })
@@ -262,6 +301,20 @@ function InboxQueueStripBody({ conversationId }) {
         )
       ] }, item.injectionId);
     }),
+    delivered.map((d) => /* @__PURE__ */ jsxs(
+      "div",
+      {
+        "data-inbox-delivered": "",
+        role: "status",
+        className: "flex min-w-0 items-center gap-2 rounded-lg border border-emerald-500/30 bg-emerald-500/[0.08] px-3 py-2 text-xs motion-safe:animate-out motion-safe:fade-out motion-safe:delay-1000 motion-safe:duration-500",
+        children: [
+          /* @__PURE__ */ jsx(Check, { className: "h-3.5 w-3.5 shrink-0 text-emerald-600 dark:text-emerald-400" }),
+          /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate text-foreground", children: d.text }),
+          /* @__PURE__ */ jsx("span", { className: "shrink-0 text-[11px] text-muted-foreground", children: `Delivered \xB7 waited ${waitedLabel(d.queuedAt, Date.parse(d.deliveredAt))}` })
+        ]
+      },
+      `delivered-${d.injectionId}`
+    )),
     /* @__PURE__ */ jsx(
       TextInputDialog,
       {
@@ -296,6 +349,8 @@ function InboxQueueStripBody({ conversationId }) {
   ] });
 }
 export {
+  DELIVERED_LINGER_MS,
   InboxQueueStrip,
-  parseCollabNoteAgent
+  parseCollabNoteAgent,
+  waitedLabel
 };

package/dist/agents/redux/execution-system/inbox/inbox.selectors.d.ts

@@ -2,7 +2,9 @@
  * conversationInbox selectors — queued-while-running message cards.
  */
 import type { ChatRootState } from "../../../../store/root-state.js";
-import type { ConversationInboxItem } from "./inbox.slice.js";
+import type { ConversationInboxItem, DeliveredInboxItem } from "./inbox.slice.js";
+/** Lines the agent just took, still showing their "Delivered" moment. Stable empty reference. */
+export declare const selectDeliveredInboxItems: (conversationId: string) => (state: ChatRootState) => DeliveredInboxItem[];
 /** All queued items for a conversation, FIFO. Stable empty reference. */
 export declare const selectInboxItems: (conversationId: string) => (state: ChatRootState) => ConversationInboxItem[];
 /** Count of items still waiting (sending + pending). Primitive — no memo needed. */

package/dist/agents/redux/execution-system/inbox/inbox.selectors.js

@@ -1,4 +1,6 @@
 const EMPTY_ITEMS = [];
+const EMPTY_DELIVERED = [];
+const selectDeliveredInboxItems = (conversationId) => (state) => state.conversationInbox?.deliveredByConversationId?.[conversationId] ?? EMPTY_DELIVERED;
 const selectInboxItems = (conversationId) => (state) => state.conversationInbox?.byConversationId[conversationId] ?? EMPTY_ITEMS;
 const selectInboxWaitingCount = (conversationId) => (state) => {
   const items = state.conversationInbox?.byConversationId[conversationId];
@@ -17,6 +19,7 @@ function isStrandablePersonLine(item) {
 }
 export {
   isStrandablePersonLine,
+  selectDeliveredInboxItems,
   selectInboxItemStatus,
   selectInboxItems,
   selectInboxWaitingCount

package/dist/agents/redux/execution-system/inbox/inbox.slice.d.ts

@@ -49,9 +49,20 @@ export interface ConversationInboxItem {
      */
     source?: string | null;
 }
+/** A queued line the agent just took — shown as "Delivered" for a moment, then cleared. */
+export interface DeliveredInboxItem {
+    injectionId: string;
+    text: string;
+    mode: InboxItemMode;
+    queuedAt: string;
+    /** ISO timestamp — when `injection_consumed` named it. */
+    deliveredAt: string;
+}
 export interface ConversationInboxState {
     /** FIFO per conversation — order mirrors server `enqueued_seq`. */
     byConversationId: Record<string, ConversationInboxItem[]>;
+    /** Items the stream just delivered, per conversation (the strip clears each after a beat). */
+    deliveredByConversationId?: Record<string, DeliveredInboxItem[]>;
 }
 export declare const addInboxItem: import("@reduxjs/toolkit").ActionCreatorWithPayload<ConversationInboxItem, "conversationInbox/addInboxItem">, confirmInboxItem: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     conversationId: string;
@@ -68,7 +79,14 @@ export declare const addInboxItem: import("@reduxjs/toolkit").ActionCreatorWithP
 }, "conversationInbox/setInboxItemText">, removeInboxItem: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     conversationId: string;
     injectionId: string;
-}, "conversationInbox/removeInboxItem">, hydrateInboxItems: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+}, "conversationInbox/removeInboxItem">, deliverInboxItem: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    conversationId: string;
+    injectionId: string;
+    deliveredAt?: string;
+}, "conversationInbox/deliverInboxItem">, clearDeliveredInboxItem: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    conversationId: string;
+    injectionId: string;
+}, "conversationInbox/clearDeliveredInboxItem">, hydrateInboxItems: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     conversationId: string;
     items: ConversationInboxItem[];
 }, "conversationInbox/hydrateInboxItems">;

package/dist/agents/redux/execution-system/inbox/inbox.slice.js

@@ -1,7 +1,8 @@
 import { createSlice } from "@reduxjs/toolkit";
 import { destroyInstance } from "../conversations/conversations.slice.js";
 const initialState = {
-  byConversationId: {}
+  byConversationId: {},
+  deliveredByConversationId: {}
 };
 function bucket(state, conversationId) {
   if (!state.byConversationId[conversationId]) {
@@ -64,6 +65,35 @@ const conversationInboxSlice = createSlice({
         (i) => i.injectionId !== injectionId
       );
     },
+    /**
+     * The stream delivered an item (`injection_consumed`): it leaves the queue
+     * exactly like `removeInboxItem` (so `selectInboxItemStatus` reads null — the
+     * delivery ack), and a visible person line is remembered as just delivered.
+     */
+    deliverInboxItem(state, action) {
+      const { conversationId, injectionId } = action.payload;
+      const items = state.byConversationId[conversationId];
+      const item = items?.find((i) => i.injectionId === injectionId);
+      if (!items || !item) return;
+      state.byConversationId[conversationId] = items.filter((i) => i.injectionId !== injectionId);
+      if (!item.isVisibleToUser || item.source === "agent_collab") return;
+      const delivered = state.deliveredByConversationId ??= {};
+      (delivered[conversationId] ??= []).push({
+        injectionId,
+        text: item.text,
+        mode: item.mode,
+        queuedAt: item.queuedAt,
+        deliveredAt: action.payload.deliveredAt ?? (/* @__PURE__ */ new Date()).toISOString()
+      });
+    },
+    /** The "Delivered" moment is over — drop it. */
+    clearDeliveredInboxItem(state, action) {
+      const list = state.deliveredByConversationId?.[action.payload.conversationId];
+      if (!list) return;
+      state.deliveredByConversationId[action.payload.conversationId] = list.filter(
+        (i) => i.injectionId !== action.payload.injectionId
+      );
+    },
     /**
      * Replace the pending set from a server list (`GET …/inbox?status=pending`)
      * — reopen-mid-run rehydration. Local `sending`/`failed` items are kept
@@ -80,6 +110,7 @@ const conversationInboxSlice = createSlice({
   extraReducers: (builder) => {
     builder.addCase(destroyInstance, (state, action) => {
       delete state.byConversationId[action.payload];
+      delete state.deliveredByConversationId?.[action.payload];
     });
   }
 });
@@ -89,13 +120,17 @@ const {
   failInboxItem,
   setInboxItemText,
   removeInboxItem,
+  deliverInboxItem,
+  clearDeliveredInboxItem,
   hydrateInboxItems
 } = conversationInboxSlice.actions;
 var inbox_slice_default = conversationInboxSlice.reducer;
 export {
   addInboxItem,
+  clearDeliveredInboxItem,
   confirmInboxItem,
   inbox_slice_default as default,
+  deliverInboxItem,
   failInboxItem,
   hydrateInboxItems,
   removeInboxItem,

package/dist/agents/redux/execution-system/thunks/process-stream.js

@@ -132,7 +132,7 @@ import {
   hasDisplayableMessageContent,
   refetchSingleMessage
 } from "../message-crud/refetch-single-message.thunk.js";
-import { removeInboxItem } from "../inbox/inbox.slice.js";
+import { deliverInboxItem } from "../inbox/inbox.slice.js";
 import {
   selectConversationMessages,
   selectMessageCount,
@@ -2034,7 +2034,7 @@ async function processStream({
             }
             for (const item of event.data.items ?? []) {
               dispatch(
-                removeInboxItem({
+                deliverInboxItem({
                   conversationId,
                   injectionId: item.injection_id
                 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.4.21",
+  "version": "0.4.22",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db; plus the kernel compatibility entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) until P28.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -227,17 +227,17 @@
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
     "@ai-matrx/alchemy": "latest",
-    "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/associations": "latest",
+    "@ai-matrx/browser-audio": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
-    "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/media": "latest",
+    "@ai-matrx/icons": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
@@ -245,7 +245,7 @@
     "@ai-matrx/rich-content": "latest",
     "@ai-matrx/rich-editor": "latest",
     "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/agents": "latest"
+    "@ai-matrx/media": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",