@ai-matrx/chat 0.7.27 → 0.7.29

package/dist/messenger/agents/MessengerManageAgents.js

@@ -0,0 +1,109 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Plus, RotateCcw, UserMinus, X } from "lucide-react";
+import { AgentListDropdown } from "@ai-matrx/agents/catalog/react";
+import { MessengerAvatar } from "../MessengerAvatar.js";
+const ROW_BUTTON = "inline-flex h-8 shrink-0 items-center gap-1.5 rounded-md border border-border px-2.5 text-[13px] text-foreground hover:bg-accent disabled:opacity-50";
+function Row({ row, action }) {
+  return /* @__PURE__ */ jsxs("li", { className: "flex min-w-0 items-center gap-3 px-4 py-2.5", children: [
+    /* @__PURE__ */ jsx(MessengerAvatar, { name: row.name, avatar: row.avatar, size: "header" }),
+    /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+      /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [
+        /* @__PURE__ */ jsx("span", { className: "truncate text-[15px] text-foreground", children: row.name }),
+        row.seatLabel ? /* @__PURE__ */ jsx("span", { className: "shrink-0 rounded-full bg-muted px-2 py-0.5 text-[11px] text-muted-foreground", children: row.seatLabel }) : null
+      ] }),
+      row.description ? /* @__PURE__ */ jsx("span", { className: "truncate text-[13px] text-muted-foreground", children: row.description }) : null
+    ] }),
+    action
+  ] });
+}
+function MessengerManageAgents(props) {
+  const inList = props.rows.map((r) => r.agentId);
+  return /* @__PURE__ */ jsxs("div", { className: "flex h-full min-h-0 flex-col bg-background", "data-messenger-manage": true, children: [
+    /* @__PURE__ */ jsxs("header", { className: "flex h-14 shrink-0 items-center gap-2 border-b border-border bg-card px-4", children: [
+      /* @__PURE__ */ jsx("h2", { className: "min-w-0 flex-1 truncate text-[15px] font-semibold text-foreground", children: "Manage agents" }),
+      /* @__PURE__ */ jsx(
+        AgentListDropdown,
+        {
+          onSelect: props.onAdd,
+          excludeAgentIds: inList,
+          consumerId: "messenger-manage-agents",
+          triggerSlot: /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              className: "inline-flex h-8 items-center gap-1.5 rounded-md bg-primary px-3 text-[13px] font-medium text-primary-foreground hover:bg-primary/90",
+              children: [
+                /* @__PURE__ */ jsx(Plus, { className: "h-4 w-4" }),
+                "Add agent"
+              ]
+            }
+          )
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: props.onClose,
+          "aria-label": "Close",
+          className: "flex h-9 w-9 items-center justify-center rounded-full text-muted-foreground hover:bg-accent hover:text-foreground",
+          children: /* @__PURE__ */ jsx(X, { className: "h-5 w-5" })
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "min-h-0 flex-1 overflow-y-auto overflow-x-hidden", children: [
+      props.error ? /* @__PURE__ */ jsx("p", { className: "border-b border-border px-4 py-2 text-[13px] text-destructive", children: props.error }) : null,
+      /* @__PURE__ */ jsx("h3", { className: "px-4 pb-1 pt-4 text-[12px] font-medium text-muted-foreground", children: "In your list" }),
+      /* @__PURE__ */ jsxs("ul", { className: "flex flex-col", children: [
+        props.rows.length === 0 ? /* @__PURE__ */ jsx("li", { className: "px-4 py-3 text-[13px] text-muted-foreground", children: "No agents yet" }) : null,
+        props.rows.map((row) => /* @__PURE__ */ jsx(
+          Row,
+          {
+            row,
+            action: /* @__PURE__ */ jsxs(
+              "button",
+              {
+                type: "button",
+                className: ROW_BUTTON,
+                disabled: props.pending.has(row.agentId),
+                onClick: () => props.onRemove(row.agentId),
+                children: [
+                  /* @__PURE__ */ jsx(UserMinus, { className: "h-4 w-4" }),
+                  "Remove"
+                ]
+              }
+            )
+          },
+          row.agentId
+        ))
+      ] }),
+      props.removedStarters.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx("h3", { className: "px-4 pb-1 pt-5 text-[12px] font-medium text-muted-foreground", children: "Removed starters" }),
+        /* @__PURE__ */ jsx("ul", { className: "flex flex-col", children: props.removedStarters.map((row) => /* @__PURE__ */ jsx(
+          Row,
+          {
+            row,
+            action: /* @__PURE__ */ jsxs(
+              "button",
+              {
+                type: "button",
+                className: ROW_BUTTON,
+                disabled: props.pending.has(row.agentId),
+                onClick: () => props.onRestore(row.agentId),
+                children: [
+                  /* @__PURE__ */ jsx(RotateCcw, { className: "h-4 w-4" }),
+                  "Restore"
+                ]
+              }
+            )
+          },
+          row.agentId
+        )) })
+      ] }) : null
+    ] })
+  ] });
+}
+export {
+  MessengerManageAgents
+};

package/dist/messenger/agents/menus.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Every menu the agents messenger shows, as pure builders over plain inputs —
+ * each one about the item that was clicked. The source wires the actions; the
+ * shell draws the entries (right-click, "⋯" and the header title dropdown).
+ */
+import type { MessengerMenuEntry } from "../contract.js";
+import { type ThreadSummary } from "./roster.js";
+export interface TitleMenuInput {
+    /** Newest first — whatever pages are loaded. */
+    readonly threads: readonly ThreadSummary[];
+    /** The open thread; null = a new chat not yet saved. */
+    readonly currentConversationId: string | null;
+    readonly hasMore: boolean;
+    readonly loadingMore: boolean;
+    readonly pinnedIds: ReadonlySet<string>;
+    readonly now?: Date;
+}
+export interface TitleMenuActions {
+    readonly openThread: (conversationId: string) => void;
+    readonly newChat: () => void;
+    readonly loadMore: () => void;
+    readonly togglePin: (conversationId: string) => void;
+}
+/** The header title's dropdown: + New chat, every past thread (current checked), Show more, Pin/Unpin this thread. */
+export declare function buildTitleMenu(input: TitleMenuInput, actions: TitleMenuActions): MessengerMenuEntry[];
+export interface AgentRowMenuInput {
+    readonly pinned: boolean;
+    /** False for a seat with one fixed thread (the staff seat): no "New chat". */
+    readonly canNewChat: boolean;
+}
+export interface AgentRowMenuActions {
+    readonly newChat: () => void;
+    readonly togglePin: () => void;
+    readonly openAgent: () => void;
+    readonly editAgent: () => void;
+    readonly remove: () => void;
+    readonly copyLink: () => void;
+}
+/** An agent row's right-click / "⋯". */
+export declare function buildAgentRowMenu(input: AgentRowMenuInput, actions: AgentRowMenuActions): MessengerMenuEntry[];
+export interface ThreadMenuActions {
+    readonly open?: () => void;
+    readonly togglePin: () => void;
+    readonly rename: () => void;
+    readonly openInChat: () => void;
+    readonly copyLink: () => void;
+}
+/** A pinned thread row (with Open), or the header of an open thread (without). */
+export declare function buildThreadMenu(pinned: boolean, actions: ThreadMenuActions): MessengerMenuEntry[];

package/dist/messenger/agents/menus.js

@@ -0,0 +1,89 @@
+import {
+  Bot,
+  ChevronsDown,
+  Link2,
+  MessageSquareText,
+  MessagesSquare,
+  Pencil,
+  Pin,
+  PinOff,
+  Plus,
+  SquarePen,
+  UserMinus
+} from "lucide-react";
+import { relativeDate, threadTitle } from "./roster.js";
+function buildTitleMenu(input, actions) {
+  const { threads, currentConversationId, hasMore, loadingMore, pinnedIds, now } = input;
+  const entries = [
+    {
+      id: "new-chat",
+      label: "New chat",
+      icon: Plus,
+      checked: currentConversationId === null,
+      onSelect: actions.newChat
+    }
+  ];
+  if (threads.length > 0) entries.push({ id: "threads", separator: true });
+  for (const thread of threads) {
+    entries.push({
+      id: `thread:${thread.conversationId}`,
+      label: threadTitle(thread),
+      icon: pinnedIds.has(thread.conversationId) ? Pin : MessageSquareText,
+      detail: relativeDate(thread.updatedAt, now),
+      checked: thread.conversationId === currentConversationId,
+      onSelect: () => actions.openThread(thread.conversationId)
+    });
+  }
+  if (hasMore) {
+    entries.push({
+      id: "more",
+      label: loadingMore ? "Loading\u2026" : "Show more",
+      icon: ChevronsDown,
+      disabled: loadingMore,
+      keepOpen: true,
+      onSelect: actions.loadMore
+    });
+  }
+  if (currentConversationId !== null) {
+    const pinned = pinnedIds.has(currentConversationId);
+    entries.push(
+      { id: "pin-sep", separator: true },
+      {
+        id: pinned ? "unpin-thread" : "pin-thread",
+        label: pinned ? "Unpin this chat" : "Pin this chat",
+        icon: pinned ? PinOff : Pin,
+        onSelect: () => actions.togglePin(currentConversationId)
+      }
+    );
+  }
+  return entries;
+}
+function buildAgentRowMenu(input, actions) {
+  const entries = [];
+  if (input.canNewChat) entries.push({ id: "new-chat", label: "New chat", icon: SquarePen, onSelect: actions.newChat });
+  entries.push(
+    input.pinned ? { id: "unpin-agent", label: "Unpin agent", icon: PinOff, onSelect: actions.togglePin } : { id: "pin-agent", label: "Pin agent to top", icon: Pin, onSelect: actions.togglePin },
+    { id: "open-agent", label: "Open agent", icon: Bot, onSelect: actions.openAgent },
+    { id: "edit-agent", label: "Edit agent", icon: Pencil, onSelect: actions.editAgent },
+    { id: "copy-link", label: "Copy link", icon: Link2, onSelect: actions.copyLink },
+    { id: "remove-sep", separator: true },
+    { id: "remove", label: "Remove from list", icon: UserMinus, destructive: true, onSelect: actions.remove }
+  );
+  return entries;
+}
+function buildThreadMenu(pinned, actions) {
+  const entries = [];
+  if (actions.open) entries.push({ id: "open", label: "Open", icon: MessageSquareText, onSelect: actions.open });
+  entries.push(
+    pinned ? { id: "unpin-thread", label: "Unpin", icon: PinOff, onSelect: actions.togglePin } : { id: "pin-thread", label: "Pin this chat", icon: Pin, onSelect: actions.togglePin },
+    { id: "rename", label: "Rename", icon: Pencil, onSelect: actions.rename },
+    { id: "open-in-chat", label: "Open in chat", icon: MessagesSquare, onSelect: actions.openInChat },
+    { id: "copy-link", label: "Copy link", icon: Link2, onSelect: actions.copyLink }
+  );
+  return entries;
+}
+export {
+  buildAgentRowMenu,
+  buildThreadMenu,
+  buildTitleMenu
+};

package/dist/messenger/agents/roster-store.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The agents messenger's per-person state on the server — `platform.user_entity_state`.
+ *
+ * Read: the person's own rows, directly (RLS std_select), only those carrying
+ * `metadata.messenger`. Write: `platform.ues_merge_metadata`, the caller-scoped
+ * SECURITY DEFINER merge (top-level keys; a JSON null removes one). Nothing
+ * lives in browser storage.
+ */
+import { type AgentSeatState, type MessengerPersonState } from "./roster.js";
+export declare function readMessengerPersonState(): Promise<MessengerPersonState>;
+/** The whole `messenger` object for an agent (the merge is top-level, so it is always written whole). */
+export declare function writeAgentSeat(agentId: string, state: AgentSeatState | null): Promise<void>;
+export declare function writeThreadPin(conversationId: string, pin: {
+    agentId: string;
+    title: string | null;
+} | null): Promise<void>;

package/dist/messenger/agents/roster-store.js

@@ -0,0 +1,41 @@
+import { supabase } from "../../host/db.js";
+import { getUserId } from "../../host/identity.js";
+import {
+  EMPTY_PERSON_STATE,
+  MESSENGER_METADATA_KEY,
+  personStateFromRows
+} from "./roster.js";
+async function readMessengerPersonState() {
+  const userId = getUserId();
+  if (!userId) return EMPTY_PERSON_STATE;
+  const { data, error } = await supabase.schema("platform").from("user_entity_state").select("entity_type, entity_id, metadata").eq("user_id", userId).in("entity_type", ["agent", "conversation"]).not(`metadata->${MESSENGER_METADATA_KEY}`, "is", null);
+  if (error) throw new Error(error.message);
+  return personStateFromRows(data ?? []);
+}
+async function merge(entityType, entityId, value) {
+  const { error } = await supabase.schema("platform").rpc("ues_merge_metadata", {
+    p_entity_type: entityType,
+    p_entity_id: entityId,
+    p_patch: { [MESSENGER_METADATA_KEY]: value }
+  });
+  if (error) throw new Error(error.message);
+}
+function writeAgentSeat(agentId, state) {
+  if (state === null) return merge("agent", agentId, null);
+  const value = {};
+  if (state.in !== void 0) value.in = state.in;
+  if (state.pinned) value.pinned = true;
+  return merge("agent", agentId, Object.keys(value).length > 0 ? value : null);
+}
+function writeThreadPin(conversationId, pin) {
+  return merge(
+    "conversation",
+    conversationId,
+    pin === null ? null : { pinned: true, agentId: pin.agentId, title: pin.title }
+  );
+}
+export {
+  readMessengerPersonState,
+  writeAgentSeat,
+  writeThreadPin
+};

package/dist/messenger/agents/roster.d.ts

@@ -0,0 +1,114 @@
+/**
+ * THE AGENTS-YOU-KNOW ROSTER — pure rules, no React, no database.
+ *
+ * The roster is the starter seats, plus agents the person added, minus seats
+ * they removed. Per-person state is `platform.user_entity_state.metadata.messenger`:
+ *
+ *   entity_type "agent"        → { in: true | false, pinned?: true }
+ *                                 (in:false on a starter's agent = removed)
+ *   entity_type "conversation" → { pinned: true, agentId, title? }
+ *
+ * Everything here is deterministic over its inputs so the merge, the rows'
+ * order, the title dropdown and every menu are unit-tested without a store.
+ */
+/**
+ * THE STARTER SEATS — mandate keys, never agent ids: each resolves (through
+ * the mandate resolver) to whoever holds that job for this person right now.
+ * Order is the roster's order for agents with no threads yet.
+ */
+export declare const MESSENGER_STARTER_MANDATE_KEYS: readonly ["messenger.answer_anything", "chat.default_new_chat", "personal_staff.front_line"];
+export type MessengerStarterKey = (typeof MESSENGER_STARTER_MANDATE_KEYS)[number];
+/** The `metadata` key every messenger write lives under. */
+export declare const MESSENGER_METADATA_KEY = "messenger";
+export interface AgentSeatState {
+    /** true = added (or kept); false = a starter the person removed. Absent = default. */
+    readonly in?: boolean;
+    readonly pinned?: boolean;
+}
+export interface ThreadPinState {
+    readonly pinned: true;
+    readonly agentId: string;
+    /** The title when it was pinned — used only until the live title is loaded. */
+    readonly title?: string | null;
+}
+export interface MessengerPersonState {
+    readonly agents: ReadonlyMap<string, AgentSeatState>;
+    readonly threads: ReadonlyMap<string, ThreadPinState>;
+}
+export declare const EMPTY_PERSON_STATE: MessengerPersonState;
+/** A starter seat after the mandate resolver answered (agentId null = not resolved / no holder). */
+export interface ResolvedSeat {
+    readonly mandateKey: MessengerStarterKey;
+    readonly agentId: string | null;
+}
+export interface RosterAgent {
+    readonly agentId: string;
+    /** The seat this agent fills, when it is a starter. Turns go through that mandate. */
+    readonly mandateKey: MessengerStarterKey | null;
+    readonly pinned: boolean;
+}
+export interface RosterMerge {
+    /** Who is in the list, starters first (seat order), then added agents. */
+    readonly agents: readonly RosterAgent[];
+    /** Starters the person removed — Manage offers them back. */
+    readonly removedStarters: readonly ResolvedSeat[];
+}
+/** Parse one `user_entity_state` row's metadata into the messenger's state (tolerant of junk). */
+export declare function readMessengerMetadata(metadata: unknown): Record<string, unknown> | null;
+export interface UesRow {
+    readonly entity_type: string;
+    readonly entity_id: string;
+    readonly metadata: unknown;
+}
+/** Rows from `platform.user_entity_state` → the person's messenger state. */
+export declare function personStateFromRows(rows: readonly UesRow[]): MessengerPersonState;
+/** Starters (minus removed) + added agents. A seat whose holder is also added appears once, as the seat. */
+export declare function mergeRoster(seats: readonly ResolvedSeat[], state: MessengerPersonState): RosterMerge;
+export declare const AGENT_ROW_PREFIX = "agent:";
+export declare const THREAD_ROW_PREFIX = "thread:";
+export declare const agentRowId: (agentId: string) => string;
+export declare const threadRowId: (conversationId: string) => string;
+export type RowRef = {
+    kind: "agent";
+    agentId: string;
+} | {
+    kind: "thread";
+    conversationId: string;
+};
+export declare function parseRowId(id: string): RowRef | null;
+/** One thread as the list and the dropdown know it. */
+export interface ThreadSummary {
+    readonly conversationId: string;
+    readonly title: string | null;
+    readonly updatedAt: string;
+}
+export declare const UNTITLED_THREAD = "New chat";
+export declare const threadTitle: (t: {
+    title?: string | null;
+}) => string;
+export interface RowOrderInput {
+    readonly roster: readonly RosterAgent[];
+    /** Newest-first threads per agent (whatever page is loaded). */
+    readonly threadsByAgent: ReadonlyMap<string, readonly ThreadSummary[]>;
+    readonly pinnedThreads: ReadonlyMap<string, ThreadPinState>;
+}
+export type OrderedRow = {
+    kind: "thread";
+    conversationId: string;
+    agentId: string;
+    title: string;
+    updatedAt: string | null;
+} | {
+    kind: "agent";
+    agentId: string;
+    latest: ThreadSummary | null;
+    pinned: boolean;
+};
+/**
+ * Pinned threads first (newest activity first), then pinned agents, then every
+ * other agent by its latest thread (newest first); agents with no thread keep
+ * roster order at the end.
+ */
+export declare function orderRows({ roster, threadsByAgent, pinnedThreads }: RowOrderInput): OrderedRow[];
+/** "Just now", "5m", "3h", "Yesterday", "4d", then the short date. Pure; `now` injectable. */
+export declare function relativeDate(iso: string | null | undefined, now?: Date): string;

package/dist/messenger/agents/roster.js

@@ -0,0 +1,137 @@
+import { MANDATE_KEYS } from "@ai-matrx/agents/mandates";
+const MESSENGER_STARTER_MANDATE_KEYS = [
+  MANDATE_KEYS.messenger__answer_anything,
+  MANDATE_KEYS.chat__default_new_chat,
+  MANDATE_KEYS.personal_staff__front_line
+];
+const MESSENGER_METADATA_KEY = "messenger";
+const EMPTY_PERSON_STATE = { agents: /* @__PURE__ */ new Map(), threads: /* @__PURE__ */ new Map() };
+function readMessengerMetadata(metadata) {
+  if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return null;
+  const value = metadata[MESSENGER_METADATA_KEY];
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+function personStateFromRows(rows) {
+  const agents = /* @__PURE__ */ new Map();
+  const threads = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const m = readMessengerMetadata(row.metadata);
+    if (!m) continue;
+    if (row.entity_type === "agent") {
+      const state = {};
+      if (typeof m.in === "boolean") state.in = m.in;
+      if (m.pinned === true) state.pinned = true;
+      agents.set(row.entity_id, state);
+    } else if (row.entity_type === "conversation" && m.pinned === true && typeof m.agentId === "string") {
+      threads.set(row.entity_id, {
+        pinned: true,
+        agentId: m.agentId,
+        title: typeof m.title === "string" ? m.title : null
+      });
+    }
+  }
+  return { agents, threads };
+}
+function mergeRoster(seats, state) {
+  const agents = [];
+  const removedStarters = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const seat of seats) {
+    if (!seat.agentId || seen.has(seat.agentId)) continue;
+    const own = state.agents.get(seat.agentId);
+    if (own?.in === false) {
+      removedStarters.push(seat);
+      seen.add(seat.agentId);
+      continue;
+    }
+    seen.add(seat.agentId);
+    agents.push({ agentId: seat.agentId, mandateKey: seat.mandateKey, pinned: own?.pinned === true });
+  }
+  for (const [agentId, own] of state.agents) {
+    if (own.in !== true || seen.has(agentId)) continue;
+    seen.add(agentId);
+    agents.push({ agentId, mandateKey: null, pinned: own.pinned === true });
+  }
+  return { agents, removedStarters };
+}
+const AGENT_ROW_PREFIX = "agent:";
+const THREAD_ROW_PREFIX = "thread:";
+const agentRowId = (agentId) => `${AGENT_ROW_PREFIX}${agentId}`;
+const threadRowId = (conversationId) => `${THREAD_ROW_PREFIX}${conversationId}`;
+function parseRowId(id) {
+  if (id.startsWith(AGENT_ROW_PREFIX)) return { kind: "agent", agentId: id.slice(AGENT_ROW_PREFIX.length) };
+  if (id.startsWith(THREAD_ROW_PREFIX)) return { kind: "thread", conversationId: id.slice(THREAD_ROW_PREFIX.length) };
+  return null;
+}
+const UNTITLED_THREAD = "New chat";
+const threadTitle = (t) => t.title && t.title.trim() !== "" ? t.title : UNTITLED_THREAD;
+const time = (iso) => iso ? Date.parse(iso) || 0 : 0;
+function orderRows({ roster, threadsByAgent, pinnedThreads }) {
+  const findThread = (conversationId) => {
+    for (const list of threadsByAgent.values()) {
+      const hit = list.find((t) => t.conversationId === conversationId);
+      if (hit) return hit;
+    }
+    return null;
+  };
+  const threads = [...pinnedThreads].map(([conversationId, pin]) => {
+    const live = findThread(conversationId);
+    return {
+      kind: "thread",
+      conversationId,
+      agentId: pin.agentId,
+      title: threadTitle(live ?? { title: pin.title }),
+      updatedAt: live?.updatedAt ?? null
+    };
+  });
+  threads.sort((a, b) => time(b.updatedAt) - time(a.updatedAt));
+  const agents = roster.map((agent, index) => ({
+    index,
+    row: {
+      kind: "agent",
+      agentId: agent.agentId,
+      latest: threadsByAgent.get(agent.agentId)?.[0] ?? null,
+      pinned: agent.pinned
+    }
+  }));
+  agents.sort((a, b) => {
+    if (a.row.pinned !== b.row.pinned) return a.row.pinned ? -1 : 1;
+    const ta = time(a.row.latest?.updatedAt);
+    const tb = time(b.row.latest?.updatedAt);
+    if (ta !== tb) return tb - ta;
+    return a.index - b.index;
+  });
+  return [...threads, ...agents.map((a) => a.row)];
+}
+function relativeDate(iso, now = /* @__PURE__ */ new Date()) {
+  if (!iso) return "";
+  const at = new Date(iso);
+  if (Number.isNaN(at.getTime())) return "";
+  const minutes = Math.floor((now.getTime() - at.getTime()) / 6e4);
+  if (minutes < 1) return "Just now";
+  if (minutes < 60) return `${minutes}m`;
+  const startOfDay = (d) => new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();
+  const days = Math.round((startOfDay(now) - startOfDay(at)) / 864e5);
+  if (days <= 0) return `${Math.floor(minutes / 60)}h`;
+  if (days === 1) return "Yesterday";
+  if (days < 7) return `${days}d`;
+  return at.toLocaleDateString(void 0, { month: "short", day: "numeric", year: at.getFullYear() === now.getFullYear() ? void 0 : "2-digit" });
+}
+export {
+  AGENT_ROW_PREFIX,
+  EMPTY_PERSON_STATE,
+  MESSENGER_METADATA_KEY,
+  MESSENGER_STARTER_MANDATE_KEYS,
+  THREAD_ROW_PREFIX,
+  UNTITLED_THREAD,
+  agentRowId,
+  mergeRoster,
+  orderRows,
+  parseRowId,
+  personStateFromRows,
+  readMessengerMetadata,
+  relativeDate,
+  threadRowId,
+  threadTitle
+};

package/dist/messenger/contract.d.ts

@@ -41,6 +41,12 @@ export interface MessengerMenuAction {
     readonly onSelect: () => void;
     readonly destructive?: boolean;
     readonly disabled?: boolean;
+    /** Secondary text at the item's right edge (a thread's relative date). */
+    readonly detail?: string;
+    /** Marks the current choice in a list (the open thread in the title dropdown). */
+    readonly checked?: boolean;
+    /** Selecting it leaves the menu open ("Show more" paging the same list). */
+    readonly keepOpen?: boolean;
 }
 export interface MessengerMenuSeparator {
     readonly id: string;
@@ -130,7 +136,8 @@ export interface MessengerSource {
     readonly headerMenu?: (contact: MessengerContact) => readonly MessengerMenuEntry[];
     /**
      * A dropdown under the header title (past threads + "New chat" for an agent).
-     * Present: the title opens it. Absent: the title opens the details panel.
+     * Present with entries: the title opens it. Absent, or no entries for this
+     * contact: the title opens the details panel.
      */
     readonly titleMenu?: (contact: MessengerContact) => readonly MessengerMenuEntry[];
     readonly headerActions?: (contact: MessengerContact) => ReactNode;
@@ -140,6 +147,12 @@ export interface MessengerSource {
     readonly renderDetails?: (contact: MessengerContact) => ReactNode;
     /** What the thread area shows with no contact selected. */
     readonly renderEmpty?: () => ReactNode;
+    /**
+     * A source-owned screen for the thread area (the agents source's "Manage
+     * agents"). Non-null: it replaces the thread and its header until the source
+     * returns null again. Chrome stays the shell's; the screen is the source's.
+     */
+    readonly renderMain?: () => ReactNode | null;
 }
 /** The shell's search: case-insensitive over name, preview and `searchText`. */
 export declare function matchesQuery(contact: MessengerContact, query: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.27",
+  "version": "0.7.29",
   "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",
@@ -3275,6 +3275,16 @@
       "import": "./dist/messenger/MessengerShell.js",
       "default": "./dist/messenger/MessengerShell.js"
     },
+    "./messenger/agents/AgentsMessenger": {
+      "types": "./dist/messenger/agents/AgentsMessenger.d.ts",
+      "import": "./dist/messenger/agents/AgentsMessenger.js",
+      "default": "./dist/messenger/agents/AgentsMessenger.js"
+    },
+    "./messenger/agents/roster": {
+      "types": "./dist/messenger/agents/roster.d.ts",
+      "import": "./dist/messenger/agents/roster.js",
+      "default": "./dist/messenger/agents/roster.js"
+    },
     "./messenger/contract": {
       "types": "./dist/messenger/contract.d.ts",
       "import": "./dist/messenger/contract.js",
@@ -4706,18 +4716,18 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
-    "@ai-matrx/agents": "latest",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/diff": "latest",
+    "@ai-matrx/media": "latest",
     "@ai-matrx/messaging": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
@@ -4725,7 +4735,7 @@
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
     "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/media": "latest"
+    "@ai-matrx/agents": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4844,5 +4854,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": "da1cefa8706b65633e000a46c417e22d410d499f"
+  "gitHead": "4d71c2b833fcf4ddf381519c7ceda59cfa0174db"
 }