@ai-matrx/chat 0.6.5 → 0.7.0

package/dist/agents/components/conversation-history/AgentConversationList.js

@@ -0,0 +1,252 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { ChevronDown, ChevronRight, MessageSquare } from "lucide-react";
+import { Button } from "@ai-matrx/design-system/controls";
+import { ItemRow } from "../../../host/ui-slots.js";
+import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
+import { selectAgentById } from "../../redux/agent-definition/selectors.js";
+import { fetchAgentConversations } from "../../redux/conversation-list/conversation-list.thunks.js";
+import { makeSelectAgentConversations } from "../../redux/conversation-list/conversation-list.selectors.js";
+import { renameConversation } from "../../redux/conversation-list/conversation-row-actions.thunks.js";
+import { ConversationArchiveSection } from "./ConversationArchiveSection.js";
+import {
+  buildConversationMenu
+} from "../conversation-actions/conversationActionRegistry.js";
+function formatConversationDate(iso) {
+  if (!iso) return "";
+  const d = new Date(iso);
+  const now = /* @__PURE__ */ new Date();
+  const diffDays = Math.floor((now.getTime() - d.getTime()) / 864e5);
+  if (diffDays === 0)
+    return d.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+  if (diffDays === 1) return "Yesterday";
+  if (diffDays < 7) return `${diffDays}d ago`;
+  return d.toLocaleDateString([], { month: "short", day: "numeric" });
+}
+function groupConversationsByVersion(conversations) {
+  const map = /* @__PURE__ */ new Map();
+  for (const conv of conversations) {
+    const v = conv.agentVersionNumber ?? 0;
+    const group = map.get(v);
+    if (group) group.push(conv);
+    else map.set(v, [conv]);
+  }
+  return Array.from(map.entries()).sort(([a], [b]) => b - a).map(([versionNumber, convs]) => ({
+    versionNumber,
+    conversations: [...convs].sort(
+      (a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime()
+    )
+  }));
+}
+function agentRunHref(agentId, conversationId) {
+  return `/agents/go/${agentId}/run?conversationId=${conversationId}`;
+}
+function useAgentConversationList(agentId) {
+  const dispatch = useAppDispatch();
+  const agentName = useAppSelector(
+    (state) => agentId ? selectAgentById(state, agentId)?.name ?? null : null
+  );
+  const canonicalAgentId = useAppSelector((state) => {
+    if (!agentId) return null;
+    const agent = selectAgentById(state, agentId);
+    return agent?.parentAgentId ?? agent?.id ?? agentId;
+  });
+  const selectConversations = useMemo(
+    () => canonicalAgentId ? makeSelectAgentConversations(canonicalAgentId, null) : null,
+    [canonicalAgentId]
+  );
+  const entry = useAppSelector(
+    (state) => selectConversations ? selectConversations(state) : null
+  );
+  const status = entry?.status ?? "idle";
+  const conversations = entry?.conversations ?? EMPTY;
+  const archived = entry?.archived ?? EMPTY;
+  useEffect(() => {
+    if (canonicalAgentId && status === "idle") {
+      dispatch(
+        fetchAgentConversations({
+          agentId: canonicalAgentId,
+          versionFilter: null
+        })
+      );
+    }
+  }, [canonicalAgentId, status, dispatch]);
+  const versionGroups = useMemo(
+    () => groupConversationsByVersion(conversations),
+    [conversations]
+  );
+  const archivedGroups = useMemo(
+    () => groupConversationsByVersion(archived),
+    [archived]
+  );
+  return {
+    canonicalAgentId,
+    agentName,
+    status,
+    error: entry?.error ?? null,
+    fetchedAt: entry?.fetchedAt ?? null,
+    conversations,
+    archived,
+    versionGroups,
+    archivedGroups
+  };
+}
+const EMPTY = [];
+function ConversationListRow({
+  conv,
+  href,
+  sourceFeature,
+  active,
+  onOpen,
+  openInPlace,
+  linkRow = false,
+  size = "sm",
+  surfaceKey,
+  entity,
+  agent,
+  source,
+  isFavorite,
+  untitled = "Untitled",
+  kebabAriaLabel,
+  onMutationSuccess,
+  secondaryLabel,
+  leading,
+  trailing,
+  className
+}) {
+  const dispatch = useAppDispatch();
+  const title = conv.title?.trim() || untitled;
+  return /* @__PURE__ */ jsx(
+    ItemRow,
+    {
+      sourceFeature,
+      entity,
+      className,
+      size,
+      label: title,
+      secondaryLabel,
+      href: linkRow ? href : void 0,
+      active,
+      onOpen,
+      openInPlace,
+      leading,
+      kebabAriaLabel,
+      menu: () => buildConversationMenu({
+        conversationId: conv.conversationId,
+        title: conv.title,
+        isFavorite: isFavorite ?? conv.isFavorite ?? false,
+        isArchived: conv.status === "archived",
+        excludeFromKg: conv.excludeFromKg ?? false,
+        href,
+        ...surfaceKey ? { surfaceKey } : {},
+        ...agent ? { agent } : {},
+        ...source ? { source } : {},
+        ...onMutationSuccess ? { onMutationSuccess } : {},
+        dispatch
+      }),
+      rename: {
+        value: conv.title ?? "",
+        emptyFallback: untitled,
+        onCommit: async (next) => {
+          const result = await dispatch(
+            renameConversation({
+              conversationId: conv.conversationId,
+              title: next
+            })
+          );
+          if (renameConversation.fulfilled.match(result)) {
+            onMutationSuccess?.();
+          }
+        }
+      },
+      trailing
+    }
+  );
+}
+function VersionGroupRow({
+  group,
+  agentId,
+  selectedId,
+  onSelect,
+  defaultOpen,
+  sourceFeature
+}) {
+  const [open, setOpen] = useState(defaultOpen);
+  const hasActive = group.conversations.some(
+    (c) => c.conversationId === selectedId
+  );
+  return /* @__PURE__ */ jsxs("div", { children: [
+    /* @__PURE__ */ jsxs(
+      Button,
+      {
+        variant: "quiet",
+        pressed: hasActive,
+        icon: open ? /* @__PURE__ */ jsx(ChevronDown, {}) : /* @__PURE__ */ jsx(ChevronRight, {}),
+        onClick: () => setOpen((v) => !v),
+        className: "w-full",
+        children: [
+          /* @__PURE__ */ jsx("span", { className: "text-[11px] font-semibold text-muted-foreground uppercase tracking-wide flex-1 min-w-0 truncate", children: group.versionNumber ? `Version ${group.versionNumber}` : "Latest" }),
+          /* @__PURE__ */ jsx("span", { className: "text-[10px] text-muted-foreground/60 shrink-0 ml-1", children: group.conversations.length })
+        ]
+      }
+    ),
+    open && /* @__PURE__ */ jsx("div", { className: "pl-2", children: group.conversations.map((conv) => {
+      const date = formatConversationDate(conv.updatedAt);
+      return /* @__PURE__ */ jsx(
+        ConversationListRow,
+        {
+          conv,
+          href: agentRunHref(agentId, conv.conversationId),
+          sourceFeature,
+          active: conv.conversationId === selectedId,
+          onOpen: () => onSelect(conv.conversationId),
+          trailing: /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1 text-[10px] text-muted-foreground/70", children: [
+            /* @__PURE__ */ jsx(MessageSquare, { className: "w-2.5 h-2.5 shrink-0" }),
+            conv.messageCount,
+            date ? ` \xB7 ${date}` : ""
+          ] })
+        },
+        conv.conversationId
+      );
+    }) })
+  ] });
+}
+function AgentVersionGroupedList({
+  agentId,
+  list,
+  selectedId,
+  onSelect,
+  sourceFeature
+}) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    list.versionGroups.map((group, i) => /* @__PURE__ */ jsx(
+      VersionGroupRow,
+      {
+        group,
+        agentId,
+        selectedId,
+        onSelect,
+        defaultOpen: i === 0,
+        sourceFeature
+      },
+      group.versionNumber
+    )),
+    /* @__PURE__ */ jsx(
+      ConversationArchiveSection,
+      {
+        agentIds: [agentId],
+        onOpen: onSelect,
+        className: "mt-1"
+      }
+    )
+  ] });
+}
+export {
+  AgentVersionGroupedList,
+  ConversationListRow,
+  agentRunHref,
+  formatConversationDate,
+  groupConversationsByVersion,
+  useAgentConversationList
+};

package/dist/agents/components/conversation-history/ConversationArchiveSection.d.ts

@@ -0,0 +1,11 @@
+interface ConversationArchiveSectionProps {
+    /** `"consumer"` matches the comfortable /chat sidebar; `"dense"` the rest. */
+    variant?: "dense" | "consumer";
+    /** Only these agents' conversations (a per-agent list). Default: all of mine. */
+    agentIds?: string[];
+    /** Open a row (an archived conversation is readable). Omit = rows are not links. */
+    onOpen?: (conversationId: string) => void;
+    className?: string;
+}
+export declare function ConversationArchiveSection({ variant, agentIds, onOpen, className, }: ConversationArchiveSectionProps): import("react").JSX.Element;
+export default ConversationArchiveSection;

package/dist/agents/components/conversation-history/{ConversationTrashSection.js → ConversationArchiveSection.js}

@@ -1,36 +1,42 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useState } from "react";
-import { Loader2, Trash2, Undo2 } from "lucide-react";
+import { useCallback, useState } from "react";
+import { Archive, Loader2, Undo2 } from "lucide-react";
 import { cn } from "@ai-matrx/design-system";
 import { toast } from "../../../host/notify.js";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
 import {
-  fetchTrashedConversations,
+  fetchArchivedConversations,
   restoreConversation
 } from "../../redux/conversation-list/conversation-trash.thunks.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
 import { Button, DisclosureHeader } from "@ai-matrx/design-system/controls";
-function ConversationTrashSection({
+function ConversationArchiveSection({
   variant = "dense",
+  agentIds,
+  onOpen,
   className
 }) {
   const dispatch = useAppDispatch();
   const [open, setOpen] = useState(false);
   const [restoringId, setRestoringId] = useState(null);
-  const ids = useAppSelector(
+  const allIds = useAppSelector(
     (state) => state.conversationList.trashConversationIds
   );
   const bodies = useAppSelector(
     (state) => state.conversationList.trashByConversationId
   );
+  const ids = agentIds && agentIds.length > 0 ? allIds.filter((id) => {
+    const agentId = bodies[id]?.agentId;
+    return !!agentId && agentIds.includes(agentId);
+  }) : allIds;
   const status = useAppSelector((state) => state.conversationList.trashStatus);
   const error = useAppSelector((state) => state.conversationList.trashError);
-  useEffect(() => {
-    if (open && status === "idle") {
-      void dispatch(fetchTrashedConversations());
-    }
-  }, [open, status, dispatch]);
+  const toggle = () => {
+    const next = !open;
+    setOpen(next);
+    if (next) void dispatch(fetchArchivedConversations({ agentIds }));
+  };
   const handleRestore = useCallback(
     async (conversationId) => {
       setRestoringId(conversationId);
@@ -51,22 +57,22 @@ function ConversationTrashSection({
       {
         className: "w-full",
         open,
-        onClick: () => setOpen((v) => !v),
-        icon: /* @__PURE__ */ jsx(Trash2, {}),
-        title: "Trash",
+        onClick: toggle,
+        icon: /* @__PURE__ */ jsx(Archive, {}),
+        title: "Archived",
         end: open && status === "succeeded" ? ids.length : void 0
       }
     ),
-    open && /* @__PURE__ */ jsxs("div", { className: "pb-1", children: [
-      status === "loading" && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 px-3 py-2 text-[11px] text-muted-foreground", children: [
+    open && /* @__PURE__ */ jsxs("div", { className: "max-h-64 overflow-y-auto pb-1", children: [
+      status === "loading" && ids.length === 0 && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 px-3 py-2 text-[11px] text-muted-foreground", children: [
         /* @__PURE__ */ jsx(Loader2, { className: "h-3 w-3 animate-spin" }),
-        "Opening the trash\u2026"
+        "Opening\u2026"
       ] }),
       status === "failed" && /* @__PURE__ */ jsxs("p", { className: "px-3 py-2 text-[11px] text-destructive", children: [
-        error ?? "The trash could not be read.",
+        error ?? "Archived chats could not be read.",
         /* @__PURE__ */ jsx(ErrorAlchemyMenu, { error })
       ] }),
-      status === "succeeded" && ids.length === 0 && /* @__PURE__ */ jsx("p", { className: "px-3 py-2 text-[11px] text-muted-foreground", children: "Nothing deleted. Deleted conversations land here and can be restored." }),
+      status === "succeeded" && ids.length === 0 && /* @__PURE__ */ jsx("p", { className: "px-3 py-2 text-[11px] text-muted-foreground", children: "Nothing archived." }),
       ids.map((id) => {
         const conv = bodies[id];
         if (!conv) return null;
@@ -79,7 +85,19 @@ function ConversationTrashSection({
               dense ? "h-6" : "h-8"
             ),
             children: [
-              /* @__PURE__ */ jsx(
+              onOpen && !conv.deletedAt ? /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => onOpen(id),
+                  className: cn(
+                    "min-w-0 flex-1 truncate text-left text-muted-foreground hover:text-foreground",
+                    dense ? "text-[11px]" : "text-xs"
+                  ),
+                  title,
+                  children: title
+                }
+              ) : /* @__PURE__ */ jsx(
                 "span",
                 {
                   className: cn(
@@ -90,7 +108,7 @@ function ConversationTrashSection({
                   children: title
                 }
               ),
-              /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: restoringId === id ? /* @__PURE__ */ jsx(Loader2, { className: "animate-spin" }) : /* @__PURE__ */ jsx(Undo2, {}), onClick: () => void handleRestore(id), disabled: restoringId === id, "aria-label": `Restore ${title}`, className: "shrink-0", children: "Restore" })
+              /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: restoringId === id ? /* @__PURE__ */ jsx(Loader2, { className: "animate-spin" }) : /* @__PURE__ */ jsx(Undo2, {}), onClick: () => void handleRestore(id), disabled: restoringId === id, "aria-label": `Restore ${title}`, title: "Restore", className: "shrink-0" })
             ]
           },
           id
@@ -99,8 +117,8 @@ function ConversationTrashSection({
     ] })
   ] });
 }
-var ConversationTrashSection_default = ConversationTrashSection;
+var ConversationArchiveSection_default = ConversationArchiveSection;
 export {
-  ConversationTrashSection,
-  ConversationTrashSection_default as default
+  ConversationArchiveSection,
+  ConversationArchiveSection_default as default
 };

package/dist/agents/components/conversation-history/ConversationHistorySidebar.d.ts

@@ -97,20 +97,12 @@ export interface ConversationHistorySidebarProps {
     topSlot?: React.ReactNode;
     /** Extra header actions (shown next to grouping + search toggles). */
     headerActions?: React.ReactNode;
-    /**
-     * Consumer variant only: the heading over the list. Default "Filtered Chats"
-     * (the /chat sidebar, which really does filter by source). A surface that
-     * lists one agent's conversations names what the list IS instead.
-     */
-    historyLabel?: string;
     /** Controls whether the built-in search input is shown. Default: true. */
     showSearch?: boolean;
     /** Controls whether the grouping toggle is shown. Default: true (dense). */
     showGroupingToggle?: boolean;
-    /**
-     * Consumer variant only: start with the search field open + focused.
-     */
-    initialSearchOpen?: boolean;
+    /** Consumer variant only: put the caret in the search field on mount. */
+    autoFocusSearch?: boolean;
     /**
      * Consumer variant only: suppress the built-in inline search affordance
      * (when surrounding chrome already provides a search entry point).
@@ -124,6 +116,33 @@ export interface ConversationHistorySidebarProps {
      * list is not a conversation library.
      */
     serverSearch?: boolean;
+    /**
+     * Show only these conversations — a surface whose list is "what belongs to
+     * THIS thing" (a board's own conversations). `null`/omitted = no restriction;
+     * `[]` = an empty list with no read. The list reads again when the set
+     * changes. Pair with `serverSearch={false}`: the ranked search spans the
+     * person's whole library, so a restricted list filters what it holds.
+     */
+    onlyConversationIds?: string[] | null;
+    /**
+     * With `onlyConversationIds`: a row menu entry that takes the conversation OUT
+     * of the list (e.g. "Remove from this board") without touching the
+     * conversation itself. The host does the removal; the list then shrinks when
+     * the host passes the smaller set.
+     */
+    removeFromList?: {
+        label: string;
+        onRemove: (conv: ConversationListItem) => void;
+    };
+    /**
+     * A host that FREEZES and wakes this component (a board tile's Activity,
+     * which re-runs every effect on wake) sets this so a wake never re-reads the
+     * list: the mount fetch is skipped while the scope already holds a first page
+     * that was read for the same agents, source filter and lanes. A changed
+     * filter, Refresh, search and "load more" still read. Default false — the
+     * list refreshes each time it mounts.
+     */
+    keepLoaded?: boolean;
     className?: string;
     /** Extra classes for the built-in search input (dense). */
     searchInputClassName?: string;