@meetsmore-oss/use-ai-client 1.14.1 → 1.15.0

package/dist/index.d.ts

@@ -324,6 +324,18 @@ interface UseAIConfig {
     /** The WebSocket URL of the UseAI server */
     serverUrl: string;
 }
+/**
+ * Toggles for optional chat UI features. Each feature defaults to enabled
+ * when its flag is omitted, so set a flag to false to opt out of that feature.
+ */
+interface EnabledFeatures {
+    /**
+     * The "save as slash command" UI (hover save button + inline save editor)
+     * on user messages. Saved-command autocomplete via "/" is unaffected.
+     * @default true
+     */
+    slashCommands?: boolean;
+}
 
 /**
  * Handler for AG-UI events from the server.
@@ -1584,6 +1596,13 @@ interface UseAIProviderProps extends UseAIConfig {
      * Defaults to LocalStorageCommandRepository if not provided.
      */
     commandRepository?: CommandRepository;
+    /**
+     * Opt-out toggles for optional chat UI features. Each feature defaults to
+     * enabled, so only set a flag to false to hide it. For example, set
+     * `{ slashCommands: false }` to hide the "save as slash command" UI while
+     * keeping "/" autocomplete for existing saved commands.
+     */
+    enabledFeatures?: EnabledFeatures;
     /**
      * Whether to render the built-in chat UI (floating button + panel).
      * Set to false when using the `<UseAIChat>` component to control chat placement.
@@ -1695,7 +1714,7 @@ interface UseAIProviderProps extends UseAIConfig {
  * }
  * ```
  */
-declare function UseAIProvider({ serverUrl, children, systemPrompt, CustomButton, CustomChat, chatRepository, forwardedPropsProvider, fileUploadConfig: fileUploadConfigProp, commandRepository, renderChat, theme: customTheme, strings: customStrings, visibleAgentIds, onOpenChange, submitMode, }: UseAIProviderProps): react_jsx_runtime.JSX.Element;
+declare function UseAIProvider({ serverUrl, children, systemPrompt, CustomButton, CustomChat, chatRepository, forwardedPropsProvider, fileUploadConfig: fileUploadConfigProp, commandRepository, enabledFeatures, renderChat, theme: customTheme, strings: customStrings, visibleAgentIds, onOpenChange, submitMode, }: UseAIProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access the UseAI context.
  * When used outside a UseAIProvider, returns a no-op context and logs a warning.
@@ -1744,6 +1763,13 @@ interface UseAIChatPanelProps {
     fileProcessing?: FileProcessingState | null;
     commands?: SavedCommand[];
     onSaveCommand?: (name: string, text: string) => Promise<string>;
+    /**
+     * Opt-out toggles for optional chat UI features. Each feature defaults to
+     * enabled when omitted. `slashCommands` controls the "save as slash command"
+     * UI (hover save button + inline editor); saved-command autocomplete is
+     * unaffected.
+     */
+    enabledFeatures?: EnabledFeatures;
     onRenameCommand?: (id: string, newName: string) => Promise<void>;
     onDeleteCommand?: (id: string) => Promise<void>;
     /** Optional close button to render in header (for floating mode) */
@@ -1786,7 +1812,7 @@ interface UseAIChatPanelProps {
  * Chat panel content - fills its container.
  * Use directly for embedded mode, or wrap with UseAIFloatingChatWrapper for floating mode.
  */
-declare function UseAIChatPanel({ onSendMessage, onAbort, messages, loading, connected, streamingText, streamingReasoning, currentChatId, onNewChat, onLoadChat, onDeleteChat, onListChats, onGetChat, suggestions, availableAgents, defaultAgent, selectedAgent, onAgentChange, fileUploadConfig, fileProcessing, commands, onSaveCommand, onRenameCommand, onDeleteCommand, closeButton, executingTool, feedbackEnabled, onFeedback, pendingApprovals, onApproveToolCall, onRejectToolCall, submitMode, }: UseAIChatPanelProps): react_jsx_runtime.JSX.Element;
+declare function UseAIChatPanel({ onSendMessage, onAbort, messages, loading, connected, streamingText, streamingReasoning, currentChatId, onNewChat, onLoadChat, onDeleteChat, onListChats, onGetChat, suggestions, availableAgents, defaultAgent, selectedAgent, onAgentChange, fileUploadConfig, fileProcessing, commands, onSaveCommand, enabledFeatures, onRenameCommand, onDeleteCommand, closeButton, executingTool, feedbackEnabled, onFeedback, pendingApprovals, onApproveToolCall, onRejectToolCall, submitMode, }: UseAIChatPanelProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Props for the floating chat wrapper.
@@ -2612,4 +2638,4 @@ interface UseDropdownStateOptions {
  */
 declare function useDropdownState(options?: UseDropdownStateOptions): UseDropdownStateReturn;
 
-export { type AgentContextValue, type Chat, type ChatContextValue, type ChatMetadata, type ChatPanelProps, type ChatRepository, CloseButton, type CommandContextValue, type CommandRepository, type CreateChatOptions, type CreateCommandOptions, DEFAULT_MAX_FILE_SIZE, type DefinedTool, type DropZoneProps, EmbedFileUploadBackend, type ExecutingToolDisplay, type FileAttachment, type FileProcessingState, type FileProcessingStatus, type FileTransformer, type FileTransformerContext, type FileTransformerMap, type FileUploadBackend, type FileUploadConfig, type FloatingButtonProps, type InlineSaveProps, type ListChatsOptions, type ListCommandsOptions, LocalStorageChatRepository, LocalStorageCommandRepository, type Message, type PendingToolApproval, type PersistedContentPart, type PersistedFileContent, type PersistedFileMetadata, type PersistedMessage, type PersistedMessageContent, type PersistedTextContent, type ProcessAttachmentsConfig, type PromptsContextValue, type RegisterToolsOptions, type SavedCommand, type SendMessageOptions, type SubmitMode, type ToolExecutionContext, type ToolOptions, type ToolRegistryContextValue, type ToolsDefinition, type TriggerWorkflowOptions, UseAIChat, UseAIChatPanel, type UseAIChatPanelProps, type UseAIChatPanelStrings, type UseAIChatPanelTheme, type UseAIChatProps, UseAIClient, type UseAIConfig, type UseAIContextValue, UseAIFloatingButton, UseAIFloatingChatWrapper, type UseAIOptions, UseAIProvider, type UseAIProviderProps, type UseAIResult, type UseAIStrings, type UseAITheme, type UseAIWorkflowResult, type UseAgentSelectionOptions, type UseAgentSelectionReturn, type UseChatManagementOptions, type UseChatManagementReturn, type UseCommandManagementOptions, type UseCommandManagementReturn, type UseDropdownStateOptions, type UseDropdownStateReturn, type UseFeedbackOptions, type UseFeedbackReturn, type UseFileUploadOptions, type UseFileUploadReturn, type UseMessageQueueOptions, type UseMessageQueueReturn, type UsePromptStateOptions, type UsePromptStateReturn, type UseServerEventsOptions, type UseServerEventsReturn, type UseSlashCommandsOptions, type UseSlashCommandsReturn, type UseToolSystemOptions, type UseToolSystemReturn, type WorkflowProgress, clearTransformationCache, convertToolsToDefinitions, defaultStrings, defaultTheme, defineTool, executeDefinedTool, findTransformerPattern, generateChatId, generateCommandId, generateMessageId, matchesMimeType, processAttachments, useAI, useAIContext, useAIWorkflow, useAgentSelection, useChatManagement, useCommandManagement, useDropdownState, useFeedback, useFileUpload, useMessageQueue, usePromptState, useServerEvents, useSlashCommands, useStableTools, useStrings, useTheme, useToolSystem, validateCommandName };
+export { type AgentContextValue, type Chat, type ChatContextValue, type ChatMetadata, type ChatPanelProps, type ChatRepository, CloseButton, type CommandContextValue, type CommandRepository, type CreateChatOptions, type CreateCommandOptions, DEFAULT_MAX_FILE_SIZE, type DefinedTool, type DropZoneProps, EmbedFileUploadBackend, type EnabledFeatures, type ExecutingToolDisplay, type FileAttachment, type FileProcessingState, type FileProcessingStatus, type FileTransformer, type FileTransformerContext, type FileTransformerMap, type FileUploadBackend, type FileUploadConfig, type FloatingButtonProps, type InlineSaveProps, type ListChatsOptions, type ListCommandsOptions, LocalStorageChatRepository, LocalStorageCommandRepository, type Message, type PendingToolApproval, type PersistedContentPart, type PersistedFileContent, type PersistedFileMetadata, type PersistedMessage, type PersistedMessageContent, type PersistedTextContent, type ProcessAttachmentsConfig, type PromptsContextValue, type RegisterToolsOptions, type SavedCommand, type SendMessageOptions, type SubmitMode, type ToolExecutionContext, type ToolOptions, type ToolRegistryContextValue, type ToolsDefinition, type TriggerWorkflowOptions, UseAIChat, UseAIChatPanel, type UseAIChatPanelProps, type UseAIChatPanelStrings, type UseAIChatPanelTheme, type UseAIChatProps, UseAIClient, type UseAIConfig, type UseAIContextValue, UseAIFloatingButton, UseAIFloatingChatWrapper, type UseAIOptions, UseAIProvider, type UseAIProviderProps, type UseAIResult, type UseAIStrings, type UseAITheme, type UseAIWorkflowResult, type UseAgentSelectionOptions, type UseAgentSelectionReturn, type UseChatManagementOptions, type UseChatManagementReturn, type UseCommandManagementOptions, type UseCommandManagementReturn, type UseDropdownStateOptions, type UseDropdownStateReturn, type UseFeedbackOptions, type UseFeedbackReturn, type UseFileUploadOptions, type UseFileUploadReturn, type UseMessageQueueOptions, type UseMessageQueueReturn, type UsePromptStateOptions, type UsePromptStateReturn, type UseServerEventsOptions, type UseServerEventsReturn, type UseSlashCommandsOptions, type UseSlashCommandsReturn, type UseToolSystemOptions, type UseToolSystemReturn, type WorkflowProgress, clearTransformationCache, convertToolsToDefinitions, defaultStrings, defaultTheme, defineTool, executeDefinedTool, findTransformerPattern, generateChatId, generateCommandId, generateMessageId, matchesMimeType, processAttachments, useAI, useAIContext, useAIWorkflow, useAgentSelection, useChatManagement, useCommandManagement, useDropdownState, useFeedback, useFileUpload, useMessageQueue, usePromptState, useServerEvents, useSlashCommands, useStableTools, useStrings, useTheme, useToolSystem, validateCommandName };

package/dist/index.js

@@ -374,6 +374,12 @@ function shouldSubmitOnEnter(e, mode) {
   return e.metaKey || e.ctrlKey;
 }
 
+// src/types.ts
+import { EventType, ErrorCode, TOOL_APPROVAL_REQUEST } from "@meetsmore-oss/use-ai-core";
+var DEFAULT_ENABLED_FEATURES = {
+  slashCommands: true
+};
+
 // src/components/MarkdownContent.tsx
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
@@ -2189,6 +2195,7 @@ function UseAIChatPanel({
   fileProcessing,
   commands = [],
   onSaveCommand,
+  enabledFeatures,
   onRenameCommand,
   onDeleteCommand,
   closeButton,
@@ -2202,6 +2209,8 @@ function UseAIChatPanel({
 }) {
   const strings = useStrings();
   const theme = useTheme();
+  const features = { ...DEFAULT_ENABLED_FEATURES, ...enabledFeatures };
+  const slashCommandsEnabled = features.slashCommands;
   const displayMessages = mergeAssistantMessagesForDisplay(messages);
   const [input, setInput] = useState6("");
   const chatHistoryDropdown = useDropdownState();
@@ -2776,7 +2785,7 @@ function UseAIChatPanel({
                             maxWidth: "80%"
                           },
                           children: [
-                            message.role === "user" && hoveredMessageId === message.id && onSaveCommand && !slashCommands.isSavingCommand(message.id) && /* @__PURE__ */ jsx12(
+                            message.role === "user" && slashCommandsEnabled && hoveredMessageId === message.id && onSaveCommand && !slashCommands.isSavingCommand(message.id) && /* @__PURE__ */ jsx12(
                               "button",
                               {
                                 "data-testid": "save-command-button",
@@ -3380,6 +3389,7 @@ function UseAIChat({ floating = false, submitMode }) {
     fileProcessing: ctx.fileProcessing,
     commands: ctx.commands.list,
     onSaveCommand: ctx.commands.save,
+    enabledFeatures: ctx.enabledFeatures,
     onRenameCommand: ctx.commands.rename,
     onDeleteCommand: ctx.commands.delete,
     executingTool: ctx.tools.executing,
@@ -3411,7 +3421,7 @@ function UseAIChat({ floating = false, submitMode }) {
 
 // src/client.ts
 import { io } from "socket.io-client";
-import { EventType } from "@meetsmore-oss/use-ai-core";
+import { EventType as EventType2 } from "@meetsmore-oss/use-ai-core";
 import { v4 as uuidv42 } from "uuid";
 var UseAIClient = class {
   /**
@@ -3517,7 +3527,7 @@ var UseAIClient = class {
     });
   }
   handleEvent(event) {
-    if (event.type === EventType.RUN_STARTED) {
+    if (event.type === EventType2.RUN_STARTED) {
       this._currentAssistantMessage = {
         id: uuidv42(),
         role: "assistant",
@@ -3529,31 +3539,31 @@ var UseAIClient = class {
       this._currentReasoningBlockText = "";
       this._currentMessageContent = "";
     }
-    if (event.type === EventType.TEXT_MESSAGE_START) {
+    if (event.type === EventType2.TEXT_MESSAGE_START) {
       const e = event;
       this._currentMessageId = e.messageId;
       this._currentMessageContent = "";
-    } else if (event.type === EventType.TEXT_MESSAGE_CONTENT) {
+    } else if (event.type === EventType2.TEXT_MESSAGE_CONTENT) {
       const e = event;
       this._currentMessageContent += e.delta;
-    } else if (event.type === EventType.TEXT_MESSAGE_END) {
+    } else if (event.type === EventType2.TEXT_MESSAGE_END) {
       if (this._currentAssistantMessage) {
         this._currentAssistantMessage.content = this._currentMessageContent;
       }
       this._currentMessageId = null;
-    } else if (event.type === EventType.TOOL_CALL_START) {
+    } else if (event.type === EventType2.TOOL_CALL_START) {
       const e = event;
       this.currentToolCalls.set(e.toolCallId, {
         name: e.toolCallName,
         args: ""
       });
-    } else if (event.type === EventType.TOOL_CALL_ARGS) {
+    } else if (event.type === EventType2.TOOL_CALL_ARGS) {
       const e = event;
       const toolCall = this.currentToolCalls.get(e.toolCallId);
       if (toolCall) {
         toolCall.args += e.delta;
       }
-    } else if (event.type === EventType.TOOL_CALL_END) {
+    } else if (event.type === EventType2.TOOL_CALL_END) {
       const e = event;
       const toolCall = this.currentToolCalls.get(e.toolCallId);
       if (toolCall) {
@@ -3566,17 +3576,17 @@ var UseAIClient = class {
           }
         });
       }
-    } else if (event.type === EventType.REASONING_MESSAGE_START) {
+    } else if (event.type === EventType2.REASONING_MESSAGE_START) {
       this._currentReasoningBlockText = "";
-    } else if (event.type === EventType.REASONING_MESSAGE_CONTENT) {
+    } else if (event.type === EventType2.REASONING_MESSAGE_CONTENT) {
       const e = event;
       this._currentReasoningBlockText += e.delta;
-    } else if (event.type === EventType.REASONING_MESSAGE_END) {
+    } else if (event.type === EventType2.REASONING_MESSAGE_END) {
       this._currentReasoningBlocks.push({
         text: this._currentReasoningBlockText
       });
       this._currentReasoningBlockText = "";
-    } else if (event.type === EventType.REASONING_ENCRYPTED_VALUE) {
+    } else if (event.type === EventType2.REASONING_ENCRYPTED_VALUE) {
       const e = event;
       if (e.subtype === "message" && this._currentReasoningBlocks.length > 0) {
         const lastBlock = this._currentReasoningBlocks[this._currentReasoningBlocks.length - 1];
@@ -3587,7 +3597,7 @@ var UseAIClient = class {
           tc.encryptedValue = e.encryptedValue;
         }
       }
-    } else if (event.type === EventType.TOOL_CALL_RESULT) {
+    } else if (event.type === EventType2.TOOL_CALL_RESULT) {
       const e = event;
       const alreadyTracked = this._pendingToolResults.some(
         (r) => "toolCallId" in r && r.toolCallId === e.toolCallId
@@ -3600,7 +3610,7 @@ var UseAIClient = class {
           toolCallId: e.toolCallId
         });
       }
-    } else if (event.type === EventType.STEP_FINISHED) {
+    } else if (event.type === EventType2.STEP_FINISHED) {
       if (this._currentAssistantToolCalls.length > 0 && this._currentAssistantMessage) {
         const reasoningParts = this._currentReasoningBlocks.length > 0 ? [...this._currentReasoningBlocks] : void 0;
         const assistantMsg = {
@@ -3618,10 +3628,10 @@ var UseAIClient = class {
         this._currentReasoningBlocks = [];
         this._currentMessageContent = "";
       }
-    } else if (event.type === EventType.RUN_FINISHED) {
+    } else if (event.type === EventType2.RUN_FINISHED) {
       this.finalizeRun({ aborted: false });
     }
-    if (event.type === EventType.RUN_FINISHED || event.type === EventType.RUN_ERROR) {
+    if (event.type === EventType2.RUN_FINISHED || event.type === EventType2.RUN_ERROR) {
       this._currentRunId = null;
     }
     this.eventHandlers.forEach((handler) => handler(event));
@@ -3914,7 +3924,7 @@ var UseAIClient = class {
    */
   onTextMessage(handler) {
     return this.onEvent("text-message-handler", (event) => {
-      if (event.type === EventType.TEXT_MESSAGE_END && this._currentMessageContent) {
+      if (event.type === EventType2.TEXT_MESSAGE_END && this._currentMessageContent) {
         handler(this._currentMessageContent);
       }
     });
@@ -3928,7 +3938,7 @@ var UseAIClient = class {
    */
   onToolCall(handler) {
     return this.onEvent("tool-call-handler", (event) => {
-      if (event.type === EventType.TOOL_CALL_END) {
+      if (event.type === EventType2.TOOL_CALL_END) {
         const e = event;
         const toolCall = this.currentToolCalls.get(e.toolCallId);
         if (toolCall) {
@@ -5381,11 +5391,6 @@ function useFeedback({
 
 // src/hooks/useServerEvents.ts
 import { useState as useState13, useCallback as useCallback11, useRef as useRef10 } from "react";
-
-// src/types.ts
-import { EventType as EventType2, ErrorCode, TOOL_APPROVAL_REQUEST } from "@meetsmore-oss/use-ai-core";
-
-// src/hooks/useServerEvents.ts
 function useServerEvents({
   toolSystem,
   saveAIResponse,
@@ -5439,21 +5444,21 @@ function useServerEvents({
   const handleServerEvent = useCallback11(async (client, event) => {
     const ts = toolSystemRef.current;
     const strs = stringsRef.current;
-    if (event.type === EventType2.RUN_STARTED) {
+    if (event.type === EventType.RUN_STARTED) {
       messageCountAtRunStartRef.current = client.messages.length;
       runIdAtRunStartRef.current = client.currentRunId ?? void 0;
       hasTextFromPriorStepRef.current = false;
       setStreamingReasoning("");
-    } else if (event.type === EventType2.REASONING_MESSAGE_START) {
+    } else if (event.type === EventType.REASONING_MESSAGE_START) {
       setStreamingReasoning((prev) => prev ? prev + "\n\n" : prev);
-    } else if (event.type === EventType2.REASONING_MESSAGE_CONTENT) {
+    } else if (event.type === EventType.REASONING_MESSAGE_CONTENT) {
       const reasoningEvent = event;
       setStreamingReasoning((prev) => prev + reasoningEvent.delta);
-    } else if (event.type === EventType2.TEXT_MESSAGE_START) {
+    } else if (event.type === EventType.TEXT_MESSAGE_START) {
       if (hasTextFromPriorStepRef.current) {
         setStreamingText((prev) => prev + "\n\n");
       }
-    } else if (event.type === EventType2.TOOL_CALL_START) {
+    } else if (event.type === EventType.TOOL_CALL_START) {
       const e = event;
       const tool = ts.aggregatedToolsRef.current[e.toolCallName];
       const title = e.annotations?.title ?? tool?._options?.annotations?.title ?? null;
@@ -5462,7 +5467,7 @@ function useServerEvents({
         executingToolFallbackRef.current = fallbacks[Math.floor(Math.random() * fallbacks.length)];
       }
       setExecutingTool({ toolCallId: e.toolCallId, title });
-    } else if (event.type === EventType2.TOOL_CALL_END) {
+    } else if (event.type === EventType.TOOL_CALL_END) {
       const toolCallEnd = event;
       const toolCallId = toolCallEnd.toolCallId;
       setExecutingTool((prev) => prev?.toolCallId === toolCallId ? null : prev);
@@ -5487,16 +5492,16 @@ function useServerEvents({
     } else if (event.type === TOOL_APPROVAL_REQUEST) {
       const e = event;
       ts.handleApprovalRequest(e);
-    } else if (event.type === EventType2.TEXT_MESSAGE_CONTENT) {
+    } else if (event.type === EventType.TEXT_MESSAGE_CONTENT) {
       const contentEvent = event;
       hasTextFromPriorStepRef.current = true;
       setStreamingText((prev) => prev + contentEvent.delta);
-    } else if (event.type === EventType2.TEXT_MESSAGE_END) {
-    } else if (event.type === EventType2.RUN_FINISHED) {
+    } else if (event.type === EventType.TEXT_MESSAGE_END) {
+    } else if (event.type === EventType.RUN_FINISHED) {
       const finishedEvent = event;
       await persistFinalResponse(client, { aborted: false, traceId: finishedEvent.runId });
       resetRunUiState();
-    } else if (event.type === EventType2.RUN_ERROR) {
+    } else if (event.type === EventType.RUN_ERROR) {
       const errorEvent = event;
       const errorCode = errorEvent.message;
       if (errorCode === ErrorCode.ABORTED) {
@@ -5697,6 +5702,7 @@ function UseAIProvider({
   forwardedPropsProvider,
   fileUploadConfig: fileUploadConfigProp,
   commandRepository,
+  enabledFeatures,
   renderChat = true,
   theme: customTheme,
   strings: customStrings,
@@ -5949,6 +5955,7 @@ function UseAIProvider({
       rename: renameCommand,
       delete: deleteCommand
     },
+    enabledFeatures,
     ui: {
       isOpen: isChatOpen,
       setOpen: handleSetChatOpen
@@ -5992,6 +5999,7 @@ function UseAIProvider({
     fileProcessing: fileProcessingState,
     commands,
     onSaveCommand: saveCommand,
+    enabledFeatures,
     onRenameCommand: renameCommand,
     onDeleteCommand: deleteCommand,
     executingTool: serverEvents.executingTool,
@@ -6225,7 +6233,7 @@ function useAI(options = {}) {
   }, [enabled, client]);
   const handleAGUIEvent = useCallback14(async (event) => {
     switch (event.type) {
-      case EventType2.TEXT_MESSAGE_END: {
+      case EventType.TEXT_MESSAGE_END: {
         const content = client?.currentMessageContent;
         if (content) {
           setResponse(content);
@@ -6233,7 +6241,7 @@ function useAI(options = {}) {
         }
         break;
       }
-      case EventType2.RUN_ERROR: {
+      case EventType.RUN_ERROR: {
         const errorEvent = event;
         const error2 = new Error(errorEvent.message);
         setError(error2);