@docyrus/ui-pro-ai-assistant 0.0.1

package/src/lib/class-utils.ts

@@ -0,0 +1,40 @@
+/**
+ * CSS class utility functions for assistant dialog/container styling
+ */
+
+interface DialogClassOptions {
+  isExpanded: boolean;
+  isDocked: boolean;
+}
+
+interface ContainerClassOptions {
+  isExpanded: boolean;
+  isDocked: boolean;
+}
+
+/**
+ * Returns the appropriate className for the dialog based on its state
+ * Handles expanded, docked, and default states
+ */
+export function getDialogClassName({ isExpanded, isDocked }: DialogClassOptions): string {
+  const baseClass = 'p-0 border-0 max-w-none bg-transparent transition-all duration-300 ease-out';
+
+  if (isExpanded) {
+    return `${baseClass} w-screen h-screen fixed inset-0 translate-x-0 translate-y-0`;
+  } else if (isDocked) {
+    return `${baseClass} w-[700px] h-screen fixed top-0 left-0 translate-x-0 translate-y-0`;
+  } else {
+    return `${baseClass} w-[80vw] h-[95vh] min-w-[80vw] max-w-none max-h-none fixed top-1/2 left-1/2 translate-x-[-50%] translate-y-[-50%]`;
+  }
+}
+
+/**
+ * Returns the appropriate className for the container based on its state
+ * Handles rounded corners and overflow for different display modes
+ */
+export function getContainerClassName({ isExpanded, isDocked }: ContainerClassOptions): string {
+  const baseClass = 'relative flex h-full bg-background text-foreground w-full shadow-xl border border-border';
+
+  // Keep overflow-hidden for main container to maintain chat scrolling
+  return `${baseClass} overflow-hidden ${isExpanded || isDocked ? 'rounded-none' : 'rounded-2xl'}`;
+}

package/src/lib/index.ts

@@ -0,0 +1,7 @@
+export { useApiClient } from './api-client';
+export type { ApiResponse } from './api-client';
+export { AssistantProvider, useAssistantConfig } from './assistant-config';
+export type { AssistantConfig, AssistantProviderProps, AssistantUser } from './assistant-config';
+export { getContainerClassName, getDialogClassName } from './class-utils';
+export { processMessagesData } from './message-utils';
+export type { ProcessedMessage } from './message-utils';

package/src/lib/message-utils.ts

@@ -0,0 +1,131 @@
+/**
+ * Message processing utilities for AI SDK format conversion
+ */
+
+interface RawMessage {
+  id?: string;
+  body_json?: string | object;
+  body_text?: string;
+  body?: string;
+  role?: 'user' | 'assistant';
+  sender_name?: string;
+  tool_calls?: ToolCall[];
+  created_on: string | Date;
+}
+
+interface ToolCall {
+  id: string;
+  type?: string;
+  function?: {
+    name?: string;
+    arguments?: string | object;
+  };
+}
+
+interface MessagePart {
+  type: string;
+  text?: string;
+  toolCallId?: string;
+  toolName?: string;
+  args?: object;
+}
+
+export interface ProcessedMessage {
+  id: string;
+  role: 'user' | 'assistant';
+  content: string;
+  parts: MessagePart[];
+}
+
+/**
+ * Processes raw message data from the API into AI SDK message format
+ * Handles various message formats including tool calls and parts structure
+ */
+export function processMessagesData(rawData: RawMessage[]): ProcessedMessage[] {
+  // Sort messages by created_on in ascending order
+  const sortedData = [...rawData].sort((a, b) => {
+    const dateA = new Date(a.created_on).getTime();
+    const dateB = new Date(b.created_on).getTime();
+
+    return dateA - dateB;
+  });
+
+  // Convert to AI SDK message format
+  return sortedData
+    .map((messageData: RawMessage, index: number) => {
+      if (messageData.body_json || messageData.tool_calls) {
+        let messageContent = messageData.body_json;
+
+        // If body_json is a string, parse it
+        if (typeof messageContent === 'string') {
+          try {
+            messageContent = JSON.parse(messageContent);
+          } catch (parseError) {
+            console.error('Error parsing message body_json:', parseError);
+            messageContent = { type: 'text', text: messageContent };
+          }
+        }
+
+        // Use role field directly from the API or infer from sender
+        const role: 'user' | 'assistant' = messageData.role || (messageData.sender_name === 'Assistant' ? 'assistant' : 'user');
+        const content = messageData.body_text || messageData.body || '';
+        let parts: MessagePart[] = [];
+
+        // Handle message with parts structure
+        const contentObj = messageContent as { parts?: MessagePart[]; type?: string; toolCalls?: ToolCall[] };
+
+        if (contentObj && contentObj.parts && Array.isArray(contentObj.parts)) {
+          ({ parts } = contentObj);
+        } else if (contentObj && contentObj.type === 'toolCalls' && contentObj.toolCalls) {
+          // Handle tool calls format from your backend
+          parts = [
+            {
+              type: 'text',
+              text: content
+            },
+            ...contentObj.toolCalls.map((tc: ToolCall) => ({
+              type: 'tool-call',
+              toolCallId: tc.id,
+              toolName: tc.function?.name || tc.type,
+              args: tc.function?.arguments ? typeof tc.function.arguments === 'string' ? JSON.parse(tc.function.arguments) : tc.function.arguments : {}
+            }))
+          ];
+        } else if (Array.isArray(messageContent)) {
+          // Direct content array (fallback)
+          parts = messageContent as MessagePart[];
+        } else if (content) {
+          // Simple text message
+          parts = [{ type: 'text', text: content }];
+        }
+
+        // Also handle tool_calls array at message level (legacy format)
+        if (messageData.tool_calls && Array.isArray(messageData.tool_calls)) {
+          // Add tool calls to parts if not already present
+          const toolCallParts = messageData.tool_calls.map((tc: ToolCall) => ({
+            type: 'tool-call',
+            toolCallId: tc.id,
+            toolName: tc.function?.name || tc.type,
+            args: tc.function?.arguments ? typeof tc.function.arguments === 'string' ? JSON.parse(tc.function.arguments) : tc.function.arguments : {}
+          }));
+
+          // If parts only has text, add tool calls
+          if (parts.length === 1 && parts[0].type === 'text') {
+            parts = [...parts, ...toolCallParts];
+          } else if (parts.length === 0) {
+            parts = [{ type: 'text', text: content }, ...toolCallParts];
+          }
+        }
+
+        // UIMessage format for AI SDK v5
+        return {
+          id: messageData.id || `msg-${index}`,
+          role,
+          content, // Add content field for easy access
+          parts
+        };
+      }
+
+      return null;
+    })
+    .filter((msg): msg is ProcessedMessage => msg !== null);
+}

package/src/tools/tools-schema.json

@@ -0,0 +1,512 @@
+[
+  {
+    "name": "getDataSourceList",
+    "description": "Gets the list of available data sources",
+    "userMessage": "Getting data source list...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    }
+  },
+  {
+    "name": "getDataSourceMetadata",
+    "description": "Gets the metadata and columns of a data source by ID",
+    "userMessage": "Getting data source metadata...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["data_source_id"],
+      "additionalProperties": false,
+      "properties": {
+        "data_source_id": {
+          "type": "string",
+          "description": "The ID of the data source to get metadata for"
+        }
+      }
+    }
+  },
+  {
+    "name": "queryDatabase",
+    "description": "Runs an SQL query in database and returns the result set",
+    "userMessage": "Executing SQL query...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["sql_query"],
+      "additionalProperties": false,
+      "properties": {
+        "sql_query": {
+          "type": "string",
+          "description": "The SQL query to execute"
+        }
+      }
+    }
+  },
+  {
+    "name": "readDataFromDataSource",
+    "description": "Reads data from a specific data source with filtering, sorting, and pagination options",
+    "userMessage": "Reading data from data source...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["dataSourceId"],
+      "additionalProperties": false,
+      "properties": {
+        "dataSourceId": {
+          "type": "string",
+          "description": "The ID of the data source to read from"
+        },
+        "recordId": {
+          "type": "string",
+          "description": "Specific record ID to fetch"
+        },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columns to select"
+        },
+        "filters": {
+          "type": "object",
+          "description": "Filter conditions for the query"
+        },
+        "filterKeyword": {
+          "type": "string",
+          "description": "Keyword to filter by"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum number of records to return"
+        },
+        "offset": {
+          "type": "number",
+          "description": "Number of records to skip"
+        },
+        "orderBy": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "field": {
+                "type": "string"
+              },
+              "direction": {
+                "type": "string",
+                "enum": ["asc", "desc"]
+              }
+            }
+          },
+          "description": "Sort criteria"
+        },
+        "fullCount": {
+          "type": "boolean",
+          "description": "Whether to return full count of records"
+        }
+      }
+    }
+  },
+  {
+    "name": "showDataTable",
+    "description": "Shows data in a data table to the user",
+    "userMessage": "Displaying data table...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["title", "columns", "data"],
+      "additionalProperties": false,
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Title of the data table"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the data table"
+        },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columns of the data table"
+        },
+        "data": {
+          "type": "string",
+          "description": "JSON string of data array"
+        },
+        "additionalComments": {
+          "type": "string",
+          "description": "Additional comments to be shown to the user"
+        }
+      }
+    }
+  },
+  {
+    "name": "showCreateRecordForm",
+    "description": "Opens a form to create a new record",
+    "userMessage": "Opening create record form...",
+    "requestsUserInput": true,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["dataSourceId"],
+      "additionalProperties": false,
+      "properties": {
+        "dataSourceId": {
+          "type": "string",
+          "description": "ID value of the database table to use as a data source"
+        },
+        "defaultValues": {
+          "type": "string",
+          "description": "JSON string of default values. Keys are slugs of data source columns"
+        }
+      }
+    }
+  },
+  {
+    "name": "showRecordDetailsForm",
+    "description": "Opens a form to view a record",
+    "userMessage": "Opening record details form...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["dataSourceId", "recordId"],
+      "additionalProperties": false,
+      "properties": {
+        "dataSourceId": {
+          "type": "string",
+          "description": "ID value of the database table to use as a data source"
+        },
+        "recordId": {
+          "type": "string",
+          "description": "ID value of the record to view"
+        }
+      }
+    }
+  },
+  {
+    "name": "showChart",
+    "description": "Shows a chart to the user",
+    "userMessage": "Displaying chart...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["dataSourceId", "title", "chartType", "categoryColumns", "valueColumn", "aggregateFunction"],
+      "additionalProperties": false,
+      "properties": {
+        "dataSourceId": {
+          "type": "string",
+          "description": "ID value of the database table to use as a data source"
+        },
+        "title": {
+          "type": "string",
+          "description": "Title of the chart"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the chart"
+        },
+        "chartType": {
+          "type": "string",
+          "enum": ["bar", "pie", "line"],
+          "description": "Type of the chart"
+        },
+        "categoryColumns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columns to use as category in chart drawing"
+        },
+        "valueColumn": {
+          "type": "string",
+          "description": "Column name to use as value in chart drawing"
+        },
+        "aggregateFunction": {
+          "type": "string",
+          "enum": ["COUNT", "MIN", "MAX", "AVG", "SUM"],
+          "description": "Name of the aggregate function"
+        },
+        "additionalComments": {
+          "type": "string",
+          "description": "Additional comments to be shown to the user"
+        }
+      }
+    }
+  },
+  {
+    "name": "showImage",
+    "description": "Shows an image to the user",
+    "userMessage": "Displaying image...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["imageUrl"],
+      "additionalProperties": false,
+      "properties": {
+        "imageUrl": {
+          "type": "string",
+          "description": "URL of the image to show"
+        },
+        "additionalComments": {
+          "type": "string",
+          "description": "Additional comments to be shown to the user"
+        }
+      }
+    }
+  },
+  {
+    "name": "drawChart",
+    "description": "Generates JSON configuration of charting library to draw a chart",
+    "userMessage": "Generating chart configuration...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["chart_type", "category_columns", "value_column", "aggregate_function", "data_source_id"],
+      "additionalProperties": false,
+      "properties": {
+        "chart_type": {
+          "type": "string",
+          "enum": ["bar", "pie", "line"],
+          "description": "Type of chart to generate"
+        },
+        "category_columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columns to use as categories"
+        },
+        "value_column": {
+          "type": "string",
+          "description": "Column to use for values"
+        },
+        "aggregate_function": {
+          "type": "string",
+          "enum": ["COUNT", "MIN", "MAX", "AVG", "SUM"],
+          "description": "Aggregation function to apply"
+        },
+        "data_source_id": {
+          "type": "string",
+          "description": "ID of the data source to use"
+        }
+      }
+    }
+  },
+  {
+    "name": "getWeatherInfo",
+    "description": "Fetches the current weather information for a given city",
+    "userMessage": "Getting weather information...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["city"],
+      "additionalProperties": false,
+      "properties": {
+        "city": {
+          "type": "string",
+          "description": "Name of the city to get weather information for"
+        }
+      }
+    }
+  },
+  {
+    "name": "readDocumentAtURL",
+    "description": "Fetches a document from the given URL and extracts text content as markdown",
+    "userMessage": "Reading document from URL...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["url"],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL of the document to read"
+        }
+      }
+    }
+  },
+  {
+    "name": "readDOCX",
+    "description": "Fetches a DOCX file from the given URL and extracts text content as markdown",
+    "userMessage": "Reading DOCX file...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["url"],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL of the DOCX file to read"
+        }
+      }
+    }
+  },
+  {
+    "name": "readPDF",
+    "description": "Fetches a PDF file from the given URL and extracts text content, file info and metadata",
+    "userMessage": "Reading PDF file...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["url"],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL of the PDF file to read"
+        }
+      }
+    }
+  },
+  {
+    "name": "readWebPage",
+    "description": "Fetches a web page from the given URL and extracts text content in markdown format along with metatags in YAML format",
+    "userMessage": "Reading web page content...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["url"],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL of the web page to read"
+        }
+      }
+    }
+  },
+  {
+    "name": "searchKnowledgeBase",
+    "description": "Searches the knowledge base for relevant documents using vector search",
+    "userMessage": "Searching knowledge base...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["query"],
+      "additionalProperties": false,
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Search query to find relevant documents"
+        }
+      }
+    }
+  },
+  {
+    "name": "requestApproval",
+    "description": "Ask the end user to approve/deny a specific action",
+    "userMessage": "Requesting approval for: {{action}}",
+    "requestsUserInput": true,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["action"],
+      "additionalProperties": false,
+      "properties": {
+        "action": {
+          "type": "string",
+          "description": "Short name of the action that needs approval"
+        },
+        "details": {
+          "type": "string",
+          "description": "Optional extra info shown to user"
+        }
+      }
+    }
+  },
+  {
+    "name": "searchWeb",
+    "description": "Fetches data from duckduckgo search engine for a given query",
+    "userMessage": "Searching the web...",
+    "requestsUserInput": false,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["query"],
+      "additionalProperties": false,
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Search query"
+        },
+        "region": {
+          "type": "string",
+          "description": "Region code for search results"
+        }
+      }
+    }
+  },
+  {
+    "name": "previewCode",
+    "description": "Previews code to the user in a code viewer and runs the code in a sandboxed environment",
+    "icon": "fal code",
+    "userMessage": "Previewing code...",
+    "requestsUserInput": false,
+    "work": true,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["title", "code"],
+      "additionalProperties": false,
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "A title for the code snippet"
+        },
+        "code": {
+          "type": "string",
+          "description": "The code to preview and run"
+        }
+      }
+    }
+  },
+  {
+    "name": "generateImage",
+    "description": "Generates an image based on the given prompt",
+    "icon": "fal image",
+    "userMessage": "Generating image...",
+    "requestsUserInput": false,
+    "work": true,
+    "parameters": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "required": ["title", "src"],
+      "additionalProperties": false,
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "A title for the image"
+        },
+        "src": {
+          "type": "string",
+          "description": "The image URL"
+        }
+      }
+    }
+  }
+]