@superatomai/sdk-node 0.0.4 → 0.0.6

package/dist/index.d.mts

@@ -1,5 +1,56 @@
 import { z } from 'zod';
 
+/**
+ * Log levels in hierarchical order
+ * - errors: only error logs
+ * - warnings: warning + error logs
+ * - info: info + warning + error logs
+ * - verbose: all logs including debug
+ */
+type LogLevel = 'errors' | 'warnings' | 'info' | 'verbose';
+/**
+ * Logger class with environment-based log level support
+ */
+declare class Logger {
+    private currentLevel;
+    private currentLevelPriority;
+    constructor();
+    /**
+     * Check if a string is a valid log level
+     */
+    private isValidLogLevel;
+    /**
+     * Check if a message should be logged based on current log level
+     */
+    private shouldLog;
+    /**
+     * Get current log level
+     */
+    getLogLevel(): LogLevel;
+    /**
+     * Set log level programmatically
+     */
+    setLogLevel(level: LogLevel): void;
+    /**
+     * Log info message (shown for info and verbose levels)
+     */
+    info(...args: any[]): void;
+    /**
+     * Log error message (shown for all levels)
+     */
+    error(...args: any[]): void;
+    /**
+     * Log warning message (shown for warnings, info, and verbose levels)
+     */
+    warn(...args: any[]): void;
+    /**
+     * Log debug message (only shown for verbose level)
+     */
+    debug(...args: any[]): void;
+    file(...args: any[]): void;
+}
+declare const logger: Logger;
+
 declare const DSLRendererPropsSchema$1: z.ZodObject<{
     dsl: z.ZodObject<{
         id: z.ZodString;
@@ -326,6 +377,72 @@ declare const DSLRendererPropsSchema: z.ZodObject<{
 }>;
 type DSLRendererProps = z.infer<typeof DSLRendererPropsSchema>;
 
+declare const UserSchema: z.ZodObject<{
+    username: z.ZodString;
+    email: z.ZodOptional<z.ZodString>;
+    password: z.ZodString;
+    fullname: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    wsIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    username: string;
+    password: string;
+    email?: string | undefined;
+    fullname?: string | undefined;
+    role?: string | undefined;
+    wsIds?: string[] | undefined;
+}, {
+    username: string;
+    password: string;
+    email?: string | undefined;
+    fullname?: string | undefined;
+    role?: string | undefined;
+    wsIds?: string[] | undefined;
+}>;
+type User = z.infer<typeof UserSchema>;
+declare const UsersDataSchema: z.ZodObject<{
+    users: z.ZodArray<z.ZodObject<{
+        username: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+        password: z.ZodString;
+        fullname: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        wsIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }, {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    users: {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }[];
+}, {
+    users: {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }[];
+}>;
+type UsersData = z.infer<typeof UsersDataSchema>;
 declare const MessageSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     type: z.ZodString;
@@ -429,6 +546,7 @@ type IncomingMessage = z.infer<typeof IncomingMessageSchema>;
 type CollectionOperation = 'getMany' | 'getOne' | 'query' | 'mutation' | 'updateOne' | 'deleteOne' | 'createOne';
 type CollectionHandler<TParams = any, TResult = any> = (params: TParams) => Promise<TResult> | TResult;
 type LLMProvider = 'anthropic' | 'groq';
+
 interface SuperatomSDKConfig {
     url?: string;
     apiKey: string;
@@ -440,16 +558,9 @@ interface SuperatomSDKConfig {
     ANTHROPIC_API_KEY?: string;
     GROQ_API_KEY?: string;
     LLM_PROVIDERS?: LLMProvider[];
+    logLevel?: LogLevel;
 }
 
-interface User {
-    username: string;
-    password: string;
-    wsIds: string[];
-}
-interface UsersData {
-    users: User[];
-}
 /**
  * UserManager class to handle CRUD operations on users with file persistence
  * and in-memory caching. Changes are synced to file periodically.
@@ -503,6 +614,18 @@ declare class UserManager {
      * @returns The user if found, undefined otherwise
      */
     getUser(username: string): User | undefined;
+    /**
+     * Read a user by email
+     * @param email - Email to retrieve
+     * @returns The user if found, undefined otherwise
+     */
+    getUserByEmail(email: string): User | undefined;
+    /**
+     * Find user by username or email
+     * @param identifier - Username or email to search for
+     * @returns The user if found, undefined otherwise
+     */
+    getUserByUsernameOrEmail(identifier: string): User | undefined;
     /**
      * Read all users
      * @returns Array of all users
@@ -709,9 +832,19 @@ interface LLMOptions {
     apiKey?: string;
     partial?: (chunk: string) => void;
 }
+interface Tool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: string;
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
 declare class LLM {
     static text(messages: LLMMessages, options?: LLMOptions): Promise<string>;
     static stream<T = string>(messages: LLMMessages, options?: LLMOptions, json?: boolean): Promise<T extends string ? string : any>;
+    static streamWithTools(messages: LLMMessages, tools: Tool[], toolHandler: (toolName: string, toolInput: any) => Promise<any>, options?: LLMOptions, maxIterations?: number): Promise<string>;
     /**
      * Parse model string to extract provider and model name
      * @param modelString - Format: "provider/model-name" or just "model-name"
@@ -725,6 +858,7 @@ declare class LLM {
     private static _parseModel;
     private static _anthropicText;
     private static _anthropicStream;
+    private static _anthropicStreamWithTools;
     private static _groqText;
     private static _groqStream;
     /**
@@ -747,19 +881,26 @@ interface CapturedLog {
  * UILogCollector captures logs during user prompt processing
  * and sends them to runtime via ui_logs message with uiBlockId as the message id
  * Logs are sent in real-time for streaming effect in the UI
+ * Respects the global log level configuration
  */
 declare class UILogCollector {
     private logs;
     private uiBlockId;
     private clientId;
     private sendMessage;
+    private currentLogLevel;
     constructor(clientId: string, sendMessage: (message: Message) => void, uiBlockId?: string);
     /**
      * Check if logging is enabled (uiBlockId is provided)
      */
     isEnabled(): boolean;
+    /**
+     * Check if a message should be logged based on current log level
+     */
+    private shouldLog;
     /**
      * Add a log entry with timestamp and immediately send to runtime
+     * Only logs that pass the log level filter are captured and sent
      */
     private addLog;
     /**
@@ -820,13 +961,14 @@ interface Action {
 
 /**
  * UIBlock represents a single user and assistant message block in a thread
- * Contains user question, component metadata, component data, and available actions
+ * Contains user question, component metadata, component data, text response, and available actions
  */
 declare class UIBlock {
     private id;
     private userQuestion;
     private generatedComponentMetadata;
     private componentData;
+    private textResponse;
     private actions;
     private createdAt;
     /**
@@ -836,8 +978,9 @@ declare class UIBlock {
      * @param generatedComponentMetadata - Optional metadata about the generated component
      * @param actions - Optional array of available actions
      * @param id - Optional custom ID, generates UUID if not provided
+     * @param textResponse - Optional text response from LLM
      */
-    constructor(userQuestion: string, componentData?: Record<string, any>, generatedComponentMetadata?: Record<string, any>, actions?: Action[], id?: string);
+    constructor(userQuestion: string, componentData?: Record<string, any>, generatedComponentMetadata?: Record<string, any>, actions?: Action[], id?: string, textResponse?: string | null);
     /**
      * Get the UIBlock ID
      */
@@ -854,6 +997,7 @@ declare class UIBlock {
      * Get component metadata
      */
     getComponentMetadata(): Record<string, any>;
+    getTextResponse(): string;
     /**
      * Set or update component metadata
      */
@@ -882,6 +1026,10 @@ declare class UIBlock {
      * Set or update component data with size and row limits
      */
     setComponentData(data: Record<string, any>): void;
+    /**
+     * Set or update text response
+     */
+    setTextResponse(textResponse: string | null): void;
     /**
      * Get all actions (only if they are resolved, not if fetching)
      */
@@ -1241,4 +1389,4 @@ declare class SuperatomSDK {
     private storeComponents;
 }
 
-export { type Action, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CollectionHandler, type CollectionOperation, type IncomingMessage, LLM, type Message, SDK_VERSION, STORAGE_CONFIG, SuperatomSDK, type SuperatomSDKConfig, Thread, ThreadManager, UIBlock, UILogCollector, type User, UserManager, type UsersData };
+export { type Action, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CollectionHandler, type CollectionOperation, type IncomingMessage, LLM, type LogLevel, type Message, SDK_VERSION, STORAGE_CONFIG, SuperatomSDK, type SuperatomSDKConfig, Thread, ThreadManager, UIBlock, UILogCollector, type User, UserManager, type UsersData, logger };

package/dist/index.d.ts

@@ -1,5 +1,56 @@
 import { z } from 'zod';
 
+/**
+ * Log levels in hierarchical order
+ * - errors: only error logs
+ * - warnings: warning + error logs
+ * - info: info + warning + error logs
+ * - verbose: all logs including debug
+ */
+type LogLevel = 'errors' | 'warnings' | 'info' | 'verbose';
+/**
+ * Logger class with environment-based log level support
+ */
+declare class Logger {
+    private currentLevel;
+    private currentLevelPriority;
+    constructor();
+    /**
+     * Check if a string is a valid log level
+     */
+    private isValidLogLevel;
+    /**
+     * Check if a message should be logged based on current log level
+     */
+    private shouldLog;
+    /**
+     * Get current log level
+     */
+    getLogLevel(): LogLevel;
+    /**
+     * Set log level programmatically
+     */
+    setLogLevel(level: LogLevel): void;
+    /**
+     * Log info message (shown for info and verbose levels)
+     */
+    info(...args: any[]): void;
+    /**
+     * Log error message (shown for all levels)
+     */
+    error(...args: any[]): void;
+    /**
+     * Log warning message (shown for warnings, info, and verbose levels)
+     */
+    warn(...args: any[]): void;
+    /**
+     * Log debug message (only shown for verbose level)
+     */
+    debug(...args: any[]): void;
+    file(...args: any[]): void;
+}
+declare const logger: Logger;
+
 declare const DSLRendererPropsSchema$1: z.ZodObject<{
     dsl: z.ZodObject<{
         id: z.ZodString;
@@ -326,6 +377,72 @@ declare const DSLRendererPropsSchema: z.ZodObject<{
 }>;
 type DSLRendererProps = z.infer<typeof DSLRendererPropsSchema>;
 
+declare const UserSchema: z.ZodObject<{
+    username: z.ZodString;
+    email: z.ZodOptional<z.ZodString>;
+    password: z.ZodString;
+    fullname: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    wsIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    username: string;
+    password: string;
+    email?: string | undefined;
+    fullname?: string | undefined;
+    role?: string | undefined;
+    wsIds?: string[] | undefined;
+}, {
+    username: string;
+    password: string;
+    email?: string | undefined;
+    fullname?: string | undefined;
+    role?: string | undefined;
+    wsIds?: string[] | undefined;
+}>;
+type User = z.infer<typeof UserSchema>;
+declare const UsersDataSchema: z.ZodObject<{
+    users: z.ZodArray<z.ZodObject<{
+        username: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+        password: z.ZodString;
+        fullname: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        wsIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }, {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    users: {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }[];
+}, {
+    users: {
+        username: string;
+        password: string;
+        email?: string | undefined;
+        fullname?: string | undefined;
+        role?: string | undefined;
+        wsIds?: string[] | undefined;
+    }[];
+}>;
+type UsersData = z.infer<typeof UsersDataSchema>;
 declare const MessageSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     type: z.ZodString;
@@ -429,6 +546,7 @@ type IncomingMessage = z.infer<typeof IncomingMessageSchema>;
 type CollectionOperation = 'getMany' | 'getOne' | 'query' | 'mutation' | 'updateOne' | 'deleteOne' | 'createOne';
 type CollectionHandler<TParams = any, TResult = any> = (params: TParams) => Promise<TResult> | TResult;
 type LLMProvider = 'anthropic' | 'groq';
+
 interface SuperatomSDKConfig {
     url?: string;
     apiKey: string;
@@ -440,16 +558,9 @@ interface SuperatomSDKConfig {
     ANTHROPIC_API_KEY?: string;
     GROQ_API_KEY?: string;
     LLM_PROVIDERS?: LLMProvider[];
+    logLevel?: LogLevel;
 }
 
-interface User {
-    username: string;
-    password: string;
-    wsIds: string[];
-}
-interface UsersData {
-    users: User[];
-}
 /**
  * UserManager class to handle CRUD operations on users with file persistence
  * and in-memory caching. Changes are synced to file periodically.
@@ -503,6 +614,18 @@ declare class UserManager {
      * @returns The user if found, undefined otherwise
      */
     getUser(username: string): User | undefined;
+    /**
+     * Read a user by email
+     * @param email - Email to retrieve
+     * @returns The user if found, undefined otherwise
+     */
+    getUserByEmail(email: string): User | undefined;
+    /**
+     * Find user by username or email
+     * @param identifier - Username or email to search for
+     * @returns The user if found, undefined otherwise
+     */
+    getUserByUsernameOrEmail(identifier: string): User | undefined;
     /**
      * Read all users
      * @returns Array of all users
@@ -709,9 +832,19 @@ interface LLMOptions {
     apiKey?: string;
     partial?: (chunk: string) => void;
 }
+interface Tool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: string;
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
 declare class LLM {
     static text(messages: LLMMessages, options?: LLMOptions): Promise<string>;
     static stream<T = string>(messages: LLMMessages, options?: LLMOptions, json?: boolean): Promise<T extends string ? string : any>;
+    static streamWithTools(messages: LLMMessages, tools: Tool[], toolHandler: (toolName: string, toolInput: any) => Promise<any>, options?: LLMOptions, maxIterations?: number): Promise<string>;
     /**
      * Parse model string to extract provider and model name
      * @param modelString - Format: "provider/model-name" or just "model-name"
@@ -725,6 +858,7 @@ declare class LLM {
     private static _parseModel;
     private static _anthropicText;
     private static _anthropicStream;
+    private static _anthropicStreamWithTools;
     private static _groqText;
     private static _groqStream;
     /**
@@ -747,19 +881,26 @@ interface CapturedLog {
  * UILogCollector captures logs during user prompt processing
  * and sends them to runtime via ui_logs message with uiBlockId as the message id
  * Logs are sent in real-time for streaming effect in the UI
+ * Respects the global log level configuration
  */
 declare class UILogCollector {
     private logs;
     private uiBlockId;
     private clientId;
     private sendMessage;
+    private currentLogLevel;
     constructor(clientId: string, sendMessage: (message: Message) => void, uiBlockId?: string);
     /**
      * Check if logging is enabled (uiBlockId is provided)
      */
     isEnabled(): boolean;
+    /**
+     * Check if a message should be logged based on current log level
+     */
+    private shouldLog;
     /**
      * Add a log entry with timestamp and immediately send to runtime
+     * Only logs that pass the log level filter are captured and sent
      */
     private addLog;
     /**
@@ -820,13 +961,14 @@ interface Action {
 
 /**
  * UIBlock represents a single user and assistant message block in a thread
- * Contains user question, component metadata, component data, and available actions
+ * Contains user question, component metadata, component data, text response, and available actions
  */
 declare class UIBlock {
     private id;
     private userQuestion;
     private generatedComponentMetadata;
     private componentData;
+    private textResponse;
     private actions;
     private createdAt;
     /**
@@ -836,8 +978,9 @@ declare class UIBlock {
      * @param generatedComponentMetadata - Optional metadata about the generated component
      * @param actions - Optional array of available actions
      * @param id - Optional custom ID, generates UUID if not provided
+     * @param textResponse - Optional text response from LLM
      */
-    constructor(userQuestion: string, componentData?: Record<string, any>, generatedComponentMetadata?: Record<string, any>, actions?: Action[], id?: string);
+    constructor(userQuestion: string, componentData?: Record<string, any>, generatedComponentMetadata?: Record<string, any>, actions?: Action[], id?: string, textResponse?: string | null);
     /**
      * Get the UIBlock ID
      */
@@ -854,6 +997,7 @@ declare class UIBlock {
      * Get component metadata
      */
     getComponentMetadata(): Record<string, any>;
+    getTextResponse(): string;
     /**
      * Set or update component metadata
      */
@@ -882,6 +1026,10 @@ declare class UIBlock {
      * Set or update component data with size and row limits
      */
     setComponentData(data: Record<string, any>): void;
+    /**
+     * Set or update text response
+     */
+    setTextResponse(textResponse: string | null): void;
     /**
      * Get all actions (only if they are resolved, not if fetching)
      */
@@ -1241,4 +1389,4 @@ declare class SuperatomSDK {
     private storeComponents;
 }
 
-export { type Action, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CollectionHandler, type CollectionOperation, type IncomingMessage, LLM, type Message, SDK_VERSION, STORAGE_CONFIG, SuperatomSDK, type SuperatomSDKConfig, Thread, ThreadManager, UIBlock, UILogCollector, type User, UserManager, type UsersData };
+export { type Action, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CollectionHandler, type CollectionOperation, type IncomingMessage, LLM, type LogLevel, type Message, SDK_VERSION, STORAGE_CONFIG, SuperatomSDK, type SuperatomSDKConfig, Thread, ThreadManager, UIBlock, UILogCollector, type User, UserManager, type UsersData, logger };