@ai-matrx/chat 0.7.14 → 0.7.16

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-matrx/chat
 
+## 0.7.16
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.7.15..npm/chat/v0.7.16 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.7.15
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.7.14..npm/chat/v0.7.15 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.7.14
 ### Unreleased
 ### An answer never paints header-first (spend register item 32, cold-load CLS at 1280/1440/1920)

package/dist/agents/components/messages-display/AgentConversationDisplay.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useConversationAbilities } from "../../redux/execution-system/host-conversations/conversation-abilities.js";
-import { useEffect, useMemo, useRef, useState } from "react";
+import { Fragment, useEffect, useMemo, useRef, useState } from "react";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
 import { loadConversation } from "../../redux/execution-system/thunks/load-conversation.thunk.js";
 import { StaleDataNotice } from "../../../host/ui-slots.js";
@@ -48,6 +48,8 @@ import { FollowUpSuggestions } from "./conversation-tools/FollowUpSuggestions.js
 import { groupMessageIds, groupsToRender } from "./conversation-tools/pinned-filter.js";
 import { loadFullConversationHistory } from "../../conversation-export/load-full-history.js";
 import { useMessageListInteractions } from "./conversation-tools/useMessageListInteractions.js";
+import { useTranscriptLayout } from "../shared/transcript-layout.js";
+import { timeGroupLabel, timeGroupStarts } from "./time-groups.js";
 import { Button } from "@ai-matrx/design-system/controls";
 function AgentConversationDisplay({
   conversationId,
@@ -132,6 +134,17 @@ function AgentConversationDisplay({
     pinnedOnly,
     pinned: pinnedIds
   });
+  const { timestamps } = useTranscriptLayout();
+  const groupTimes = useMemo(() => {
+    if (timestamps !== "grouped") return null;
+    const at = new Map(messages.map((m) => [m.id, Date.parse(m.createdAt)]));
+    const timed = visibleGroups.map((g) => {
+      const first = groupMessageIds(g).map((id) => at.get(id)).find((t) => t !== void 0 && Number.isFinite(t));
+      return { key: g.key, atMs: first ?? null };
+    });
+    const starts = timeGroupStarts(timed);
+    return new Map(timed.filter((t) => starts.has(t.key) && t.atMs !== null).map((t) => [t.key, t.atMs]));
+  }, [timestamps, messages, visibleGroups]);
   let latestAssistantKey;
   for (let i = displayGroups.length - 1; i >= 0; i--) {
     if (displayGroups[i].kind === "assistant") {
@@ -392,9 +405,19 @@ function AgentConversationDisplay({
             "aria-label": "Conversation",
             className: `${spacingClass} p-2 scrollbar-hide ${bottomPinned ? "min-h-full flex flex-col justify-end" : ""}`,
             children: [
-              visibleGroups.map(
-                (group, index) => wrapGroup(group, index, renderGroupBody(group))
-              ),
+              visibleGroups.map((group, index) => {
+                const at = groupTimes?.get(group.key);
+                if (at === void 0) return wrapGroup(group, index, renderGroupBody(group));
+                const label = timeGroupLabel(at);
+                return /* @__PURE__ */ jsxs(Fragment, { children: [
+                  /* @__PURE__ */ jsxs("div", { "data-time-group": "", className: "pt-2 text-center text-[11px] leading-[14px] text-muted-foreground", role: "separator", "aria-label": `${label.day} ${label.time}`, children: [
+                    /* @__PURE__ */ jsx("span", { className: "font-semibold", children: label.day }),
+                    " ",
+                    label.time
+                  ] }),
+                  wrapGroup(group, index, renderGroupBody(group))
+                ] }, group.key);
+              }),
               pinnedOnly && visibleGroups.length === 0 && /* @__PURE__ */ jsxs("div", { className: "py-10 text-center text-sm text-muted-foreground", children: [
                 "Nothing pinned in this conversation.",
                 " ",

package/dist/agents/components/messages-display/time-groups.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Messages' time grouping (the transcript layout's `timestamps: "grouped"`): a centred line over the
+ * first message and over any message that follows an hour's quiet — "Today 9:41 AM",
+ * "Yesterday 4:02 PM", "Monday 9:41 AM" within the week, "Oct 6, 2026 at 9:41 AM" before it.
+ */
+/** Quiet this long between two messages starts a new time group (Messages: about an hour). */
+export declare const TIME_GROUP_GAP_MS: number;
+/** The keys of the groups that open a time group: the first, and each after `gapMs` of quiet. */
+export declare function timeGroupStarts(groups: ReadonlyArray<{
+    key: string;
+    atMs: number | null;
+}>, gapMs?: number): Set<string>;
+/** The line's two parts, Messages' way: the day (drawn bold) and the time. */
+export declare function timeGroupLabel(atMs: number, nowMs?: number, locale?: string): {
+    day: string;
+    time: string;
+};

package/dist/agents/components/messages-display/time-groups.js

@@ -0,0 +1,29 @@
+const TIME_GROUP_GAP_MS = 60 * 6e4;
+function timeGroupStarts(groups, gapMs = TIME_GROUP_GAP_MS) {
+  const starts = /* @__PURE__ */ new Set();
+  let last = null;
+  for (const g of groups) {
+    if (g.atMs === null) continue;
+    if (last === null || g.atMs - last >= gapMs) starts.add(g.key);
+    last = g.atMs;
+  }
+  return starts;
+}
+const startOfDay = (ms) => {
+  const d = new Date(ms);
+  d.setHours(0, 0, 0, 0);
+  return d.getTime();
+};
+function timeGroupLabel(atMs, nowMs = Date.now(), locale) {
+  const time = new Date(atMs).toLocaleTimeString(locale, { hour: "numeric", minute: "2-digit" });
+  const days = Math.round((startOfDay(nowMs) - startOfDay(atMs)) / 864e5);
+  if (days <= 0) return { day: "Today", time };
+  if (days === 1) return { day: "Yesterday", time };
+  if (days < 7) return { day: new Date(atMs).toLocaleDateString(locale, { weekday: "long" }), time };
+  return { day: new Date(atMs).toLocaleDateString(locale, { month: "short", day: "numeric", year: "numeric" }), time: `at ${time}` };
+}
+export {
+  TIME_GROUP_GAP_MS,
+  timeGroupLabel,
+  timeGroupStarts
+};

package/dist/agents/components/shared/transcript-layout.d.ts

@@ -22,6 +22,12 @@ export interface TranscriptLayout {
     align?: "center" | "start";
     userMessage?: "card" | "compact" | "bubble";
     answerActions?: "shown" | "latest" | "hover";
+    /**
+     * When each message was sent: `hover` (the web chat: the time at the end of an answer's action
+     * row, shown on hover) or `grouped` (Messages, Xcode's coding assistant: a centred "Today 9:41 AM"
+     * line over the first message and over any that follow an hour's quiet).
+     */
+    timestamps?: "hover" | "grouped";
 }
 export declare const DEFAULT_TRANSCRIPT_LAYOUT: Required<TranscriptLayout>;
 export declare function resolveTranscriptLayout(layout?: TranscriptLayout): Required<TranscriptLayout>;

package/dist/agents/components/shared/transcript-layout.js

@@ -7,7 +7,8 @@ const DEFAULT_TRANSCRIPT_LAYOUT = {
   width: "reading",
   align: "center",
   userMessage: "compact",
-  answerActions: "hover"
+  answerActions: "hover",
+  timestamps: "hover"
 };
 const TranscriptLayoutContext = createContext(DEFAULT_TRANSCRIPT_LAYOUT);
 function resolveTranscriptLayout(layout) {
@@ -19,10 +20,10 @@ function transcriptColumnClass(layout) {
   return ASSISTANT_MESSAGE_COLUMN_CLASS;
 }
 function TranscriptLayoutProvider(props) {
-  const { width, align, userMessage, answerActions } = resolveTranscriptLayout(props.layout);
+  const { width, align, userMessage, answerActions, timestamps } = resolveTranscriptLayout(props.layout);
   const value = useMemo(
-    () => ({ width, align, userMessage, answerActions }),
-    [width, align, userMessage, answerActions]
+    () => ({ width, align, userMessage, answerActions, timestamps }),
+    [width, align, userMessage, answerActions, timestamps]
   );
   return createElement(TranscriptLayoutContext.Provider, { value }, props.children);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.14",
+  "version": "0.7.16",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as explicit per-module subpaths @ai-matrx/chat/<domain>/<module> (no wildcards: scripts/public-modules.json) over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -4682,15 +4682,16 @@
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
     "@ai-matrx/alchemy": "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/associations": "latest",
-    "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/kit": "latest",
+    "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
@@ -4698,8 +4699,7 @@
     "@ai-matrx/rich-content": "latest",
     "@ai-matrx/rich-editor": "latest",
     "@ai-matrx/diff": "latest",
-    "@ai-matrx/canvas": "latest",
-    "@ai-matrx/media": "latest"
+    "@ai-matrx/content-ir-react": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4818,5 +4818,5 @@
     "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test",
     "check:public-surface": "node ./scripts/sync-public-surface.mjs --check && node ./scripts/sync-public-surface.mjs --self-test"
   },
-  "gitHead": "0e5372354ec84ed85b1779e1d99b6922a20f1798"
+  "gitHead": "6158809f49ab5fe092f5dc6c56c60898eb0f92a6"
 }