@meshagent/meshagent-tailwind 0.38.2 → 0.38.3

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.38.3]
+- Breaking: TypeScript container image summaries now use `references`/`preferredRef` and metadata fields (timestamps/media type), and `inspectImage` returns manifests/layers/content size; `tags`/`size` are removed.
+- `getUsage` now supports filters for users, room, provider, model, and usage type.
+- Room connection and errors improved: `RoomServerException` now carries `statusCode` and `retryable`, and `RoomClient` can route OAuth/secret requests via handler options.
+- React hooks add robust connection retry/backoff, new authorization helpers, and optional secret/OAuth handlers; document connection now supports schema/initial JSON and improved cleanup.
+- New Livekit support (client + protocol channel) and room participant hook; hosted toolkits are now shared per room to avoid duplicate starts.
+- Breaking: `meshagent-react` no longer exports the legacy chat and file-upload modules.
+- Tailwind chat UI is rebuilt with multi-thread support, new thread creation via agent tools, and file attachment utilities, with new exports for thread and conversation helpers.
+
 ## [0.38.2]
 - Stability
 

package/dist/cjs/Chat.d.ts

@@ -1,7 +1,15 @@
-import { RoomClient, Participant } from "@meshagent/meshagent";
+import type { ReactElement } from "react";
+import { Participant, RoomClient } from "@meshagent/meshagent";
 export interface ChatProps {
     room: RoomClient;
-    path: string;
+    path?: string;
     participants?: Participant[];
+    agentName?: string;
+    toolkit?: string;
+    tool?: string;
+    centerComposer?: boolean;
+    emptyStateTitle?: string;
+    emptyStateDescription?: string;
+    onThreadResolved?: (path: string | null, displayName: string | null) => void;
 }
-export declare function Chat({ room, path, participants }: ChatProps): import("react/jsx-runtime").JSX.Element;
+export declare function Chat({ room, path, participants, agentName, toolkit, tool, centerComposer, emptyStateTitle, emptyStateDescription, onThreadResolved, }: ChatProps): ReactElement;

package/dist/cjs/Chat.js

@@ -23,55 +23,193 @@ __export(Chat_exports, {
 module.exports = __toCommonJS(Chat_exports);
 var import_jsx_runtime = require("react/jsx-runtime");
 var import_react = require("react");
+var import_meshagent = require("@meshagent/meshagent");
 var import_meshagent_react = require("@meshagent/meshagent-react");
-var import_ChatThread = require("./ChatThread");
+var import_lucide_react = require("lucide-react");
 var import_ChatInput = require("./ChatInput");
-var import_ChatTypingIndicator = require("./ChatTypingIndicator");
-var import_ui_toolkit = require("./tools/ui-toolkit");
+var import_ChatThread = require("./ChatThread");
+var import_button = require("./components/ui/button");
 var import_sonner = require("./components/ui/sonner");
+var import_file_attachment = require("./file-attachment");
+var import_chat_hooks = require("./chat-hooks");
+class NewThreadCancelledError extends Error {
+  constructor() {
+    super("new thread creation cancelled");
+    this.name = "NewThreadCancelledError";
+  }
+}
+function normalizeThreadPath(path) {
+  const normalizedPath = path?.trim();
+  return normalizedPath ? normalizedPath : null;
+}
 function getParticipantName(participant) {
-  const name = participant?.getAttribute("name");
-  return typeof name === "string" ? name : "";
+  const name = participant.getAttribute("name");
+  return typeof name === "string" ? name.trim() : "";
+}
+function displayParticipantName(name) {
+  const normalizedName = name?.trim();
+  if (!normalizedName) {
+    return "agent";
+  }
+  return normalizedName.split("@")[0]?.trim() || normalizedName;
+}
+function isAgentParticipant(participant) {
+  return participant.role === "agent" || participant.getAttribute("supports_agent_messages") === true;
+}
+function findTargetAgent(room, agentName) {
+  const normalizedAgentName = agentName?.trim();
+  for (const participant of room.messaging.remoteParticipants) {
+    if (!isAgentParticipant(participant)) {
+      continue;
+    }
+    if (normalizedAgentName && getParticipantName(participant) !== normalizedAgentName) {
+      continue;
+    }
+    return participant;
+  }
+  return null;
+}
+function ensureOperationActive(operationId, activeOperationRef) {
+  if (activeOperationRef.current !== operationId) {
+    throw new NewThreadCancelledError();
+  }
+}
+function delay(milliseconds) {
+  return new Promise((resolve) => {
+    window.setTimeout(resolve, milliseconds);
+  });
 }
-function Chat({ room, path, participants }) {
+async function waitForTargetAgent(params) {
+  const { room, agentName, operationId, activeOperationRef } = params;
+  while (true) {
+    ensureOperationActive(operationId, activeOperationRef);
+    const targetAgent = findTargetAgent(room, agentName);
+    if (targetAgent) {
+      return targetAgent;
+    }
+    await delay(250);
+  }
+}
+async function waitForToolkitAvailable(params) {
   const {
+    room,
+    participantId,
+    toolkit,
+    operationId,
+    activeOperationRef
+  } = params;
+  while (true) {
+    ensureOperationActive(operationId, activeOperationRef);
+    try {
+      const toolkits = await room.agents.listToolkits({ participantId, timeout: 1e3 });
+      if (toolkits.some((toolkitDescription) => toolkitDescription.name === toolkit)) {
+        return;
+      }
+    } catch {
+    }
+    await delay(250);
+  }
+}
+function getStringField(record, key) {
+  const value = record[key];
+  return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function parseThreadToolResult(toolkit, tool, content) {
+  const path = getStringField(content.json, "path");
+  if (!path) {
+    throw new Error(`${toolkit}.${tool} response missing path`);
+  }
+  return {
+    path,
+    displayName: getStringField(content.json, "name")
+  };
+}
+function describeError(error) {
+  if (error instanceof Error && error.message.trim() !== "") {
+    return error.message;
+  }
+  return `${error}`;
+}
+function EmptyState({
+  title,
+  description
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "mx-auto flex max-w-2xl flex-col items-center justify-center px-6 py-20 text-center", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { className: "text-4xl font-semibold tracking-tight text-foreground sm:text-5xl", children: title }),
+    description?.trim() ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "mt-3 max-w-xl text-sm leading-6 text-muted-foreground sm:text-base", children: description }) : null
+  ] });
+}
+function ErrorBanner({ message }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "mx-auto w-full max-w-[912px] whitespace-pre-wrap rounded-3xl border border-destructive/30 bg-destructive/5 px-6 py-5 text-sm text-destructive", children: message });
+}
+function ResolvedChatView({
+  room,
+  path,
+  participants,
+  agentName,
+  emptyStateTitle,
+  emptyStateDescription,
+  showNewThreadButton = false,
+  onStartNewThread
+}) {
+  const {
+    document,
     messages,
     sendMessage,
     selectAttachments,
     attachments,
     setAttachments,
-    schemaFileExists,
+    onlineParticipants,
+    localParticipantName,
     cancelRequest
-  } = (0, import_meshagent_react.useChat)({ room, path, participants });
-  const { thinking } = (0, import_meshagent_react.useRoomIndicators)({ room, path });
-  const toolkits = (0, import_react.useMemo)(() => [
-    new import_ui_toolkit.UIToolkit()
-  ], []);
-  (0, import_meshagent_react.useClientToolkits)({ room, toolkits, public: false });
-  const onTextChange = (0, import_react.useCallback)((_) => {
-    const removeParticipant = room.messaging.remoteParticipants;
-    for (const part of removeParticipant) {
+  } = (0, import_chat_hooks.useChatThread)({ room, path, participants, agentName });
+  const { typing, thinking } = (0, import_meshagent_react.useRoomIndicators)({ room, path });
+  const threadStatus = (0, import_chat_hooks.useThreadStatus)({ room, path, agentName });
+  const [showCompletedToolCalls, setShowCompletedToolCalls] = (0, import_react.useState)(false);
+  const onTextChange = (0, import_react.useCallback)(() => {
+    for (const participant of onlineParticipants) {
       room.messaging.sendMessage({
-        to: part,
+        to: participant,
         type: "typing",
         message: { path }
       });
     }
-  }, [room, path]);
-  const localParticipantName = getParticipantName(room?.localParticipant);
-  if (schemaFileExists === false) {
-    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "flex flex-col flex-1 min-h-0 gap-2 p-4", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "text-red-500", children: 'No AI agent found in this room. Run `meshagent chatbot join --room [room-name] --agent-name "Chat Agent" --name "Chat Friend"` and try again.' }) });
-  }
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex flex-col flex-1 min-h-0 gap-2 p-0", children: [
+  }, [onlineParticipants, path, room]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex min-h-0 flex-1 flex-col", children: [
+    showNewThreadButton && onStartNewThread ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "px-4 pt-3", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "mx-auto flex w-full max-w-[912px] justify-end", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+      import_button.Button,
+      {
+        type: "button",
+        variant: "outline",
+        size: "sm",
+        className: "rounded-full shadow-xs",
+        onClick: onStartNewThread,
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_lucide_react.Plus, { className: "mr-2 h-4 w-4" }),
+          "New thread"
+        ]
+      }
+    ) }) }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
       import_ChatThread.ChatThread,
       {
         room,
+        path,
         messages,
-        localParticipantName
+        isLoading: document === null,
+        localParticipantName,
+        showCompletedToolCalls,
+        onShowCompletedToolCallsChanged: setShowCompletedToolCalls,
+        typing,
+        thinking,
+        threadStatusText: threadStatus.text,
+        threadStatusStartedAt: threadStatus.startedAt,
+        threadStatusMode: threadStatus.mode,
+        onCancelRequest: cancelRequest,
+        emptyStateTitle,
+        emptyStateDescription
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ChatTypingIndicator.ChatTypingIndicator, { room, path }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
       import_ChatInput.ChatInput,
       {
@@ -79,11 +217,220 @@ function Chat({ room, path, participants }) {
         attachments,
         onFilesSelected: selectAttachments,
         setAttachments,
-        onTextChange,
-        onCancelRequest: cancelRequest,
-        showCancelButton: thinking
+        onTextChange
       }
-    ),
+    )
+  ] });
+}
+function Chat({
+  room,
+  path,
+  participants,
+  agentName,
+  toolkit = "chat",
+  tool = "new_thread",
+  centerComposer = true,
+  emptyStateTitle,
+  emptyStateDescription,
+  onThreadResolved
+}) {
+  const [internalThreadPath, setInternalThreadPath] = (0, import_react.useState)(null);
+  const [newThreadDraft, setNewThreadDraft] = (0, import_react.useState)("");
+  const [newThreadAttachments, setNewThreadAttachments] = (0, import_react.useState)([]);
+  const [newThreadError, setNewThreadError] = (0, import_react.useState)(null);
+  const [creatingNewThread, setCreatingNewThread] = (0, import_react.useState)(false);
+  const [waitingForAgent, setWaitingForAgent] = (0, import_react.useState)(false);
+  const activeOperationRef = (0, import_react.useRef)(0);
+  const controlledPath = (0, import_react.useMemo)(() => normalizeThreadPath(path), [path]);
+  const managesOwnThread = controlledPath === null;
+  const activePath = controlledPath ?? internalThreadPath;
+  (0, import_react.useEffect)(() => {
+    return () => {
+      activeOperationRef.current += 1;
+    };
+  }, []);
+  (0, import_react.useEffect)(() => {
+    if (controlledPath !== null) {
+      setInternalThreadPath(null);
+    }
+  }, [controlledPath]);
+  (0, import_react.useEffect)(() => {
+    activeOperationRef.current += 1;
+    setInternalThreadPath(null);
+    setNewThreadDraft("");
+    setNewThreadAttachments([]);
+    setNewThreadError(null);
+    setCreatingNewThread(false);
+    setWaitingForAgent(false);
+  }, [agentName, managesOwnThread, room]);
+  const selectNewThreadAttachments = (0, import_react.useCallback)((files) => {
+    const nextAttachments = files.map((file) => new import_file_attachment.MeshagentFileUpload(
+      room,
+      `uploaded-files/${file.name}`,
+      (0, import_file_attachment.fileToAsyncIterable)(file),
+      file.size
+    ));
+    setNewThreadAttachments((currentAttachments) => [...currentAttachments, ...nextAttachments]);
+  }, [room]);
+  const cancelPendingNewThread = (0, import_react.useCallback)(() => {
+    activeOperationRef.current += 1;
+    setCreatingNewThread(false);
+    setWaitingForAgent(false);
+    setNewThreadError(null);
+  }, []);
+  const openNewThreadComposer = (0, import_react.useCallback)(() => {
+    activeOperationRef.current += 1;
+    setInternalThreadPath(null);
+    setNewThreadDraft("");
+    setNewThreadAttachments([]);
+    setNewThreadError(null);
+    setCreatingNewThread(false);
+    setWaitingForAgent(false);
+  }, []);
+  const handleCreateThread = (0, import_react.useCallback)(async () => {
+    const text = newThreadDraft.trim();
+    const hasDraft = text !== "" || newThreadAttachments.length > 0;
+    if (!hasDraft || creatingNewThread || waitingForAgent) {
+      return;
+    }
+    const operationId = activeOperationRef.current + 1;
+    activeOperationRef.current = operationId;
+    const initialTargetAgent = findTargetAgent(room, agentName);
+    setWaitingForAgent(initialTargetAgent === null);
+    setCreatingNewThread(initialTargetAgent !== null);
+    setNewThreadError(null);
+    try {
+      const targetAgent = initialTargetAgent ?? await waitForTargetAgent({
+        room,
+        agentName,
+        operationId,
+        activeOperationRef
+      });
+      ensureOperationActive(operationId, activeOperationRef);
+      if (initialTargetAgent === null) {
+        setWaitingForAgent(false);
+        setCreatingNewThread(true);
+      }
+      await waitForToolkitAvailable({
+        room,
+        participantId: targetAgent.id,
+        toolkit,
+        operationId,
+        activeOperationRef
+      });
+      ensureOperationActive(operationId, activeOperationRef);
+      const response = await room.agents.invokeTool({
+        toolkit,
+        tool,
+        arguments: {
+          message: {
+            text,
+            attachments: newThreadAttachments.map((attachment) => ({ path: attachment.path }))
+          }
+        }
+      });
+      ensureOperationActive(operationId, activeOperationRef);
+      if (!(response instanceof import_meshagent.JsonContent)) {
+        throw new Error(`${toolkit}.${tool} returned non-JSON content`);
+      }
+      const result = parseThreadToolResult(toolkit, tool, response);
+      if (controlledPath === null) {
+        setInternalThreadPath(result.path);
+      }
+      setNewThreadDraft("");
+      setNewThreadAttachments([]);
+      setNewThreadError(null);
+      setCreatingNewThread(false);
+      setWaitingForAgent(false);
+      onThreadResolved?.(result.path, result.displayName);
+    } catch (error) {
+      if (error instanceof NewThreadCancelledError) {
+        return;
+      }
+      setCreatingNewThread(false);
+      setWaitingForAgent(false);
+      setNewThreadError(describeError(error));
+    }
+  }, [
+    agentName,
+    controlledPath,
+    creatingNewThread,
+    newThreadAttachments,
+    newThreadDraft,
+    onThreadResolved,
+    room,
+    toolkit,
+    tool,
+    waitingForAgent
+  ]);
+  (0, import_react.useEffect)(() => {
+    if (!managesOwnThread) {
+      return;
+    }
+    const handleKeyDown = (event) => {
+      if (!(event.ctrlKey || event.metaKey) || event.key.toLowerCase() !== "n") {
+        return;
+      }
+      event.preventDefault();
+      openNewThreadComposer();
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [managesOwnThread, openNewThreadComposer]);
+  const targetAgentLabel = (0, import_react.useMemo)(() => {
+    const knownAgentName = agentName?.trim();
+    if (knownAgentName) {
+      return displayParticipantName(knownAgentName);
+    }
+    const targetAgent = findTargetAgent(room);
+    return displayParticipantName(targetAgent ? getParticipantName(targetAgent) : null);
+  }, [agentName, room]);
+  const pendingStatusText = waitingForAgent ? `Waiting for ${targetAgentLabel} to be ready.` : creatingNewThread ? `Starting a thread with ${targetAgentLabel}.` : null;
+  const composer = /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_ChatInput.ChatInput,
+    {
+      onSubmit: handleCreateThread,
+      attachments: newThreadAttachments,
+      onFilesSelected: selectNewThreadAttachments,
+      setAttachments: setNewThreadAttachments,
+      value: newThreadDraft,
+      onValueChange: setNewThreadDraft,
+      clearOnSubmit: false,
+      showCancelButton: creatingNewThread || waitingForAgent,
+      onCancelRequest: cancelPendingNewThread,
+      disabled: creatingNewThread || waitingForAgent,
+      placeholder: agentName?.trim() ? `Type a message or @${displayParticipantName(agentName)}` : "Type a message"
+    }
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex min-h-0 flex-1 flex-col", children: [
+    activePath ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      ResolvedChatView,
+      {
+        room,
+        path: activePath,
+        participants,
+        agentName,
+        emptyStateTitle,
+        emptyStateDescription,
+        showNewThreadButton: managesOwnThread,
+        onStartNewThread: openNewThreadComposer
+      },
+      activePath
+    ) : centerComposer ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "flex min-h-0 flex-1 items-center justify-center px-4 py-6", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "w-full max-w-[912px] space-y-5", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "space-y-2 text-center", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { className: "text-4xl font-semibold tracking-tight text-foreground sm:text-5xl", children: "Start a new thread" }),
+        pendingStatusText ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "text-sm text-muted-foreground sm:text-base", children: pendingStatusText }) : null
+      ] }),
+      composer,
+      newThreadError ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ErrorBanner, { message: newThreadError }) : null
+    ] }) }) : /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex min-h-0 flex-1 flex-col", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "flex-1", children: emptyStateTitle ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(EmptyState, { title: emptyStateTitle, description: emptyStateDescription }) : null }),
+      pendingStatusText ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "px-4 pb-2", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "mx-auto w-full max-w-[912px] text-sm text-muted-foreground", children: pendingStatusText }) }) : null,
+      newThreadError ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "px-4 pb-2", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ErrorBanner, { message: newThreadError }) }) : null,
+      composer
+    ] }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sonner.Toaster, {})
   ] });
 }

package/dist/cjs/ChatBotView.d.ts

@@ -0,0 +1,29 @@
+import type { ReactElement } from "react";
+import { Participant, RoomClient } from "@meshagent/meshagent";
+import { ChatThreadDisplayMode } from "./conversation-descriptor";
+export { ChatThreadDisplayMode, chatDocumentPath, resolvedThreadListPath, } from "./conversation-descriptor";
+export interface ChatBotViewProps {
+    room: RoomClient;
+    path?: string;
+    documentPath?: string;
+    participants?: Participant[];
+    agentName?: string;
+    threadDisplayMode?: ChatThreadDisplayMode;
+    threadDir?: string;
+    threadListPath?: string;
+    toolkit?: string;
+    tool?: string;
+    centerComposer?: boolean;
+    emptyStateTitle?: string;
+    emptyStateDescription?: string;
+    selectedThreadPath?: string | null;
+    selectedThreadDisplayName?: string | null;
+    onSelectedThreadPathChanged?: (path: string | null) => void;
+    onSelectedThreadResolved?: (path: string | null, displayName: string | null) => void;
+    onThreadResolved?: (path: string | null, displayName: string | null) => void;
+    newThreadResetVersion?: number;
+    showThreadList?: boolean;
+    threadListWidth?: number;
+    threadListCollapsedHeight?: number;
+}
+export declare function ChatBotView({ room, path, documentPath, participants, agentName, threadDisplayMode, threadDir, threadListPath, toolkit, tool, centerComposer, emptyStateTitle, emptyStateDescription, selectedThreadPath, onSelectedThreadPathChanged, onSelectedThreadResolved, onThreadResolved, newThreadResetVersion, showThreadList, threadListWidth, threadListCollapsedHeight, }: ChatBotViewProps): ReactElement;