@jazzmind/busibox-app 3.0.18

package/dist/lib/ai/openai.js

@@ -0,0 +1,290 @@
+/**
+ * LiteLLM Client Wrapper
+ *
+ * Centralized liteLLM API client with error handling and logging.
+ * All LLM operations go through liteLLM proxy.
+ */
+import OpenAI from 'openai';
+// Lazy initialization of liteLLM client
+function getLiteLLMClient() {
+    return new OpenAI({
+        apiKey: process.env.LITELLM_API_KEY || 'sk-litellm-master-key-change-me',
+        baseURL: process.env.LITELLM_BASE_URL || 'http://localhost:4000/v1',
+    });
+}
+/**
+ * Check if liteLLM is properly configured
+ */
+export function isOpenAIConfigured() {
+    // For backward compatibility, check if liteLLM is configured
+    return !!process.env.LITELLM_BASE_URL;
+}
+// Legacy export for backward compatibility (deprecated - use getLiteLLMClient instead)
+export const openai = {
+    chat: {
+        completions: {
+            create: async (...args) => {
+                const client = getLiteLLMClient();
+                return client.chat.completions.create(...args);
+            },
+        },
+    },
+    embeddings: {
+        create: async (...args) => {
+            const client = getLiteLLMClient();
+            return client.embeddings.create(...args);
+        },
+    },
+    moderations: {
+        create: async (...args) => {
+            const client = getLiteLLMClient();
+            return client.moderations.create(...args);
+        },
+    },
+};
+/**
+ * Generate a chat completion with streaming support
+ *
+ * @param messages - Array of chat messages
+ * @param options - Generation options
+ * @returns Stream or complete response based on stream flag
+ */
+export async function generateChatCompletion(messages, options = {}) {
+    if (!isOpenAIConfigured()) {
+        throw new Error('LiteLLM not configured');
+    }
+    const { model, temperature = 0.7, maxTokens = 2000, stream = false, tools, } = options;
+    const litellm = getLiteLLMClient();
+    // Get default model if not specified
+    let modelName = model;
+    if (!modelName) {
+        const { getModelName } = await import('../chat-server/models');
+        modelName = await getModelName();
+    }
+    return litellm.chat.completions.create({
+        model: modelName,
+        messages,
+        temperature,
+        max_tokens: maxTokens,
+        stream,
+        tools,
+    });
+}
+/**
+ * Generate a concise title for a conversation based on the first message
+ *
+ * @param firstUserMessage - The first message in the conversation
+ * @returns A short, descriptive title (max 50 chars)
+ */
+export async function generateConversationTitle(firstUserMessage) {
+    // Use liteLLM if available, otherwise fallback
+    const useLiteLLM = !!process.env.LITELLM_BASE_URL;
+    if (useLiteLLM) {
+        try {
+            const litellm = new OpenAI({
+                apiKey: process.env.LITELLM_API_KEY || 'sk-litellm-master-key-change-me',
+                baseURL: process.env.LITELLM_BASE_URL || 'http://localhost:4000/v1',
+            });
+            // Use "fast" model for title generation (as specified)
+            const modelName = 'fast';
+            const response = await litellm.chat.completions.create({
+                model: modelName,
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'Generate a concise, descriptive title (max 50 characters) for a conversation that starts with the following user message. Return only the title, no quotes or extra text.',
+                    },
+                    {
+                        role: 'user',
+                        content: firstUserMessage.substring(0, 500), // Limit input length
+                    },
+                ],
+                temperature: 0.5,
+                max_tokens: 20,
+            });
+            const title = response.choices[0]?.message?.content?.trim() || firstUserMessage.substring(0, 50);
+            return title.substring(0, 50).trim();
+        }
+        catch (error) {
+            console.error('Failed to generate title with liteLLM:', error);
+            // Fallback to simple truncation
+            return firstUserMessage.substring(0, 50).trim() + (firstUserMessage.length > 50 ? '...' : '');
+        }
+    }
+    // Fallback: Use first 50 chars of message
+    return firstUserMessage.substring(0, 50).trim() + (firstUserMessage.length > 50 ? '...' : '');
+}
+/**
+ * NOTE: Embedding generation has been moved to @/lib/embeddings/data-client
+ * which uses the local FastEmbed service (bge-large-en-v1.5, 1024 dimensions)
+ * instead of OpenAI/liteLLM embeddings.
+ */
+/**
+ * Extract insights from text (conversation or document)
+ *
+ * This function analyzes text and extracts key insights,
+ * learnings, or knowledge that can be stored for future retrieval.
+ *
+ * @param text - Text to analyze
+ * @returns Array of insight strings
+ */
+export async function extractInsightsFromText(text) {
+    if (!isOpenAIConfigured()) {
+        return [];
+    }
+    if (!text || text.trim().length === 0) {
+        return [];
+    }
+    try {
+        const litellm = getLiteLLMClient();
+        const { getModelName } = await import('../chat-server/models');
+        const modelName = await getModelName('analysis'); // Use analysis model for insight extraction
+        const response = await litellm.chat.completions.create({
+            model: modelName,
+            messages: [
+                {
+                    role: 'system',
+                    content: `You are an expert at extracting key insights from conversations. 
+          Analyze the conversation and extract 3-5 important insights, learnings, or pieces of knowledge.
+          Each insight should be:
+          - A complete, standalone statement (max 500 characters)
+          - Useful for future conversations
+          - Specific and actionable
+          - Focused on user preferences, context, or important information
+          
+          Return insights as a JSON object with an "insights" array of strings. Example:
+          {"insights": ["The user prefers Python for data analysis", "User is working on a machine learning project for image classification"]}`,
+                },
+                {
+                    role: 'user',
+                    content: `Extract insights from this conversation:\n\n${text}`,
+                },
+            ],
+            temperature: 0.3,
+            max_tokens: 1000,
+            response_format: { type: 'json_object' },
+        });
+        const content = response.choices[0]?.message?.content;
+        if (!content) {
+            return [];
+        }
+        const parsed = JSON.parse(content);
+        return Array.isArray(parsed.insights) ? parsed.insights : [];
+    }
+    catch (error) {
+        console.error('Failed to extract insights:', error);
+        return [];
+    }
+}
+/**
+ * Extract insights from conversation messages
+ *
+ * This function analyzes a conversation and extracts key insights,
+ * learnings, or knowledge that can be stored for future retrieval.
+ *
+ * @param messages - Array of conversation messages
+ * @returns Array of insight strings
+ */
+export async function extractConversationInsights(messages) {
+    if (!isOpenAIConfigured()) {
+        return [];
+    }
+    if (messages.length < 2) {
+        return []; // Need at least a question and answer
+    }
+    try {
+        const conversationText = messages
+            .map(m => `${m.role}: ${m.content}`)
+            .join('\n\n');
+        const litellm = getLiteLLMClient();
+        const { getModelName } = await import('../chat-server/models');
+        const modelName = await getModelName('analysis'); // Use analysis model for insight extraction
+        const response = await litellm.chat.completions.create({
+            model: modelName,
+            messages: [
+                {
+                    role: 'system',
+                    content: `You are an expert at extracting key insights from conversations. 
+          Analyze the conversation and extract 3-5 important insights, learnings, or pieces of knowledge.
+          Each insight should be:
+          - A complete, standalone statement
+          - Useful for future conversations
+          - Specific and actionable
+          
+          Return insights as a JSON array of strings. Example:
+          ["The user prefers Python for data analysis", "User is working on a machine learning project for image classification"]`,
+                },
+                {
+                    role: 'user',
+                    content: `Extract insights from this conversation:\n\n${conversationText}`,
+                },
+            ],
+            temperature: 0.3,
+            max_tokens: 500,
+            response_format: { type: 'json_object' },
+        });
+        const content = response.choices[0]?.message?.content;
+        if (!content) {
+            return [];
+        }
+        const parsed = JSON.parse(content);
+        return Array.isArray(parsed.insights) ? parsed.insights : [];
+    }
+    catch (error) {
+        console.error('Failed to extract insights:', error);
+        return [];
+    }
+}
+/**
+ * Moderate content for safety using OpenAI's moderation API
+ *
+ * @param text - Text to moderate
+ * @returns Moderation result
+ */
+export async function moderateContent(text) {
+    if (!isOpenAIConfigured()) {
+        return { flagged: false, categories: {} };
+    }
+    try {
+        const litellm = getLiteLLMClient();
+        const response = await litellm.moderations.create({
+            input: text,
+        });
+        return response.results[0];
+    }
+    catch (error) {
+        console.error('Content moderation failed:', error);
+        return { flagged: false, categories: {} };
+    }
+}
+/**
+ * Count tokens in text (approximate)
+ *
+ * Note: This is a rough estimate. For exact counts, use tiktoken library.
+ *
+ * @param text - Text to count tokens for
+ * @returns Approximate token count
+ */
+export function estimateTokenCount(text) {
+    // Rough estimate: ~4 characters per token
+    // This is approximate and varies by content
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Truncate text to fit within token limit
+ *
+ * @param text - Text to truncate
+ * @param maxTokens - Maximum number of tokens
+ * @returns Truncated text
+ */
+export function truncateToTokenLimit(text, maxTokens) {
+    const estimatedTokens = estimateTokenCount(text);
+    if (estimatedTokens <= maxTokens) {
+        return text;
+    }
+    // Approximate character limit (4 chars per token)
+    const maxChars = maxTokens * 4;
+    return text.substring(0, maxChars) + '...';
+}
+export default openai;
+//# sourceMappingURL=openai.js.map

package/dist/lib/ai/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/lib/ai/openai.ts"],"names":[],"mappings":"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"}

package/dist/lib/ai/tools.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @deprecated - we use agents for web search and document search now.
+ * AI Tools for LLM Function Calling
+ *
+ * Defines tools that the LLM can call during conversations
+ */
+import type { ChatCompletionTool } from 'openai/resources/chat/completions';
+/**
+ * Web Search Tool
+ * Allows the LLM to search the web for current information
+ */
+export declare const webSearchTool: ChatCompletionTool;
+/**
+ * Document Search Tool
+ * Allows the LLM to search through the user's document library for relevant information
+ */
+export declare const documentSearchTool: ChatCompletionTool;
+/**
+ * Execute web search tool
+ */
+export declare function executeWebSearch(query: string, userId: string, maxResults?: number): Promise<{
+    results: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+    }>;
+    error?: string;
+}>;
+/**
+ * Execute document search tool
+ *
+ * @param query - Search query
+ * @param userId - User ID
+ * @param limit - Max results (default 5)
+ * @param authorization - JWT Authorization header for RLS (optional)
+ */
+export declare function executeDocumentSearch(query: string, userId: string, limit?: number, authorization?: string): Promise<{
+    results: Array<{
+        id: string;
+        title: string;
+        snippet: string;
+        source: string;
+        url?: string;
+        score: number;
+    }>;
+    error?: string;
+}>;
+/**
+ * Get all available tools based on configuration
+ */
+export declare function getAvailableTools(options: {
+    webSearchEnabled?: boolean;
+    documentSearchEnabled?: boolean;
+}): Promise<ChatCompletionTool[]>;
+/**
+ * Execute a tool call
+ *
+ * @param toolName - Name of the tool to execute
+ * @param args - Tool arguments
+ * @param userId - User ID
+ * @param authorization - JWT Authorization header for RLS (optional)
+ */
+export declare function executeTool(toolName: string, args: any, userId: string, authorization?: string): Promise<any>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/lib/ai/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,kBAqB3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAqBhC,CAAC;AAEF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC;IACT,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAyBD;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAU,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IACT,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAgCD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAYhC;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,GAAG,CAAC,CAWd"}

package/dist/lib/ai/tools.js

@@ -0,0 +1,159 @@
+/**
+ * @deprecated - we use agents for web search and document search now.
+ * AI Tools for LLM Function Calling
+ *
+ * Defines tools that the LLM can call during conversations
+ */
+import { searchWebForChat, searchDocuments } from '../chat-server/search';
+/**
+ * Web Search Tool
+ * Allows the LLM to search the web for current information
+ */
+export const webSearchTool = {
+    type: 'function',
+    function: {
+        name: 'web_search',
+        description: 'Search the web for current information, news, or facts. Use this when you need up-to-date information that you don\'t have in your training data, or when the user asks about recent events, current news, or real-time information.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The search query. Be specific and include relevant keywords.',
+                },
+                maxResults: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default: 5)',
+                    default: 5,
+                },
+            },
+            required: ['query'],
+        },
+    },
+};
+/**
+ * Document Search Tool
+ * Allows the LLM to search through the user's document library for relevant information
+ */
+export const documentSearchTool = {
+    type: 'function',
+    function: {
+        name: 'search_documents',
+        description: 'Search through the user\'s document library for relevant information. Use this when you need to find information from documents the user has uploaded or stored in their library. This searches across all documents using semantic search with re-ranking for the most relevant results.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The search query. Be specific and include relevant keywords to find the most relevant document sections.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default: 5)',
+                    default: 5,
+                },
+            },
+            required: ['query'],
+        },
+    },
+};
+/**
+ * Execute web search tool
+ */
+export async function executeWebSearch(query, userId, maxResults = 5) {
+    try {
+        const result = await searchWebForChat(query, userId, { maxResults });
+        if (result.error) {
+            return {
+                results: [],
+                error: result.error,
+            };
+        }
+        return {
+            results: result.results.map(r => ({
+                title: r.title,
+                url: r.url,
+                snippet: r.snippet,
+            })),
+        };
+    }
+    catch (error) {
+        console.error('[Tool] Web search execution failed:', error);
+        return {
+            results: [],
+            error: error.message || 'Web search failed',
+        };
+    }
+}
+/**
+ * Execute document search tool
+ *
+ * @param query - Search query
+ * @param userId - User ID
+ * @param limit - Max results (default 5)
+ * @param authorization - JWT Authorization header for RLS (optional)
+ */
+export async function executeDocumentSearch(query, userId, limit = 5, authorization) {
+    try {
+        const result = await searchDocuments(query, userId, {
+            limit,
+            mode: 'hybrid',
+            authorization, // Pass JWT for RLS enforcement
+        });
+        if (result.error) {
+            return {
+                results: [],
+                error: result.error,
+            };
+        }
+        return {
+            results: result.results.map(r => ({
+                id: r.id,
+                title: r.title,
+                snippet: r.snippet,
+                source: r.source,
+                url: r.url,
+                score: r.score,
+            })),
+        };
+    }
+    catch (error) {
+        console.error('[Tool] Document search execution failed:', error);
+        return {
+            results: [],
+            error: error.message || 'Document search failed',
+        };
+    }
+}
+/**
+ * Get all available tools based on configuration
+ */
+export async function getAvailableTools(options) {
+    const tools = [];
+    if (options.webSearchEnabled) {
+        tools.push(webSearchTool);
+    }
+    if (options.documentSearchEnabled) {
+        tools.push(documentSearchTool);
+    }
+    return tools;
+}
+/**
+ * Execute a tool call
+ *
+ * @param toolName - Name of the tool to execute
+ * @param args - Tool arguments
+ * @param userId - User ID
+ * @param authorization - JWT Authorization header for RLS (optional)
+ */
+export async function executeTool(toolName, args, userId, authorization) {
+    switch (toolName) {
+        case 'web_search':
+            return executeWebSearch(args.query, userId, args.maxResults);
+        case 'search_documents':
+            return executeDocumentSearch(args.query, userId, args.limit, authorization);
+        default:
+            throw new Error(`Unknown tool: ${toolName}`);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/lib/ai/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/lib/ai/tools.ts"],"names":[],"mappings":"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"}

package/dist/lib/audit/client.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Audit Client for busibox-app
+ *
+ * Centralized audit logging client that writes to the authz service.
+ * All Busibox applications should use this client for audit logging.
+ *
+ * Usage:
+ * ```typescript
+ * import { logAuditEvent, logUserLogin } from 'busibox-app';
+ *
+ * await logAuditEvent({
+ *   actorId: 'user-123',
+ *   action: 'document.upload',
+ *   resourceType: 'document',
+ *   resourceId: 'doc-456',
+ *   details: { filename: 'report.pdf' },
+ * });
+ * ```
+ */
+export interface AuditEventParams {
+    /** User or system ID performing the action */
+    actorId: string;
+    /** Action being performed (e.g., 'user.login', 'document.upload') */
+    action: string;
+    /** Type of resource being acted upon (e.g., 'user', 'document', 'session') */
+    resourceType: string;
+    /** Optional ID of the specific resource */
+    resourceId?: string | null;
+    /** Optional additional details (will be stored as JSON) */
+    details?: Record<string, unknown>;
+}
+export interface AuditClientOptions {
+    /** User ID (for server-side token acquisition) */
+    userId?: string;
+    /** Custom token acquisition function */
+    getAuthzToken?: (userId: string, audience: string, scopes: string[]) => Promise<string>;
+    /** Override authz service URL */
+    authzUrl?: string;
+    /** Access token (JWT) for Zero Trust authentication */
+    accessToken?: string;
+}
+/**
+ * Write audit event to authz service
+ *
+ * @param event - Audit event parameters
+ * @param options - Client options (optional tokenManager for user context)
+ */
+export declare function logAuditEvent(event: AuditEventParams, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log a successful user login
+ */
+export declare function logUserLogin(userId: string, sessionId: string, options?: AuditClientOptions & {
+    method?: string;
+}): Promise<void>;
+/**
+ * Log a user logout
+ */
+export declare function logUserLogout(userId: string, sessionId: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log a failed login attempt
+ */
+export declare function logLoginFailed(email: string, reason: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log a password reset request
+ */
+export declare function logPasswordResetRequest(userId: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log a password reset completion
+ */
+export declare function logPasswordReset(userId: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log role assignment
+ */
+export declare function logRoleAssigned(actorId: string, targetUserId: string, roleId: string, roleName: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log role removal
+ */
+export declare function logRoleRemoved(actorId: string, targetUserId: string, roleId: string, roleName: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log user creation
+ */
+export declare function logUserCreated(actorId: string, targetUserId: string, email: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log user deletion
+ */
+export declare function logUserDeleted(actorId: string, targetUserId: string, email: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log user status change
+ */
+export declare function logUserStatusChanged(actorId: string, targetUserId: string, oldStatus: string, newStatus: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log document upload
+ */
+export declare function logDocumentUploaded(userId: string, documentId: string, filename: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log document deletion
+ */
+export declare function logDocumentDeleted(userId: string, documentId: string, filename: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log document access
+ */
+export declare function logDocumentAccessed(userId: string, documentId: string, filename: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log configuration change
+ */
+export declare function logConfigChanged(actorId: string, configKey: string, oldValue: unknown, newValue: unknown, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log API key generation
+ */
+export declare function logApiKeyGenerated(userId: string, keyId: string, keyName: string, options?: AuditClientOptions): Promise<void>;
+/**
+ * Log API key revocation
+ */
+export declare function logApiKeyRevoked(userId: string, keyId: string, keyName: string, options?: AuditClientOptions): Promise<void>;
+export declare function logAppRegistered(appId: string, appName: string, actorId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logAppUpdated(appId: string, appName: string, actorId: string, updates?: Record<string, unknown>, options?: AuditClientOptions): Promise<void>;
+export declare function logAppDeleted(appId: string, appName: string, actorId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logMagicLinkSent(email: string, userId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logMagicLinkUsed(userId: string, email: string, options?: AuditClientOptions): Promise<void>;
+export declare function logMagicLinkExpired(email: string, options?: AuditClientOptions): Promise<void>;
+export declare function logTotpCodeSent(email: string, userId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logTotpCodeUsed(userId: string, email: string, options?: AuditClientOptions): Promise<void>;
+export declare function logTotpCodeFailed(email: string, reason: string, options?: AuditClientOptions): Promise<void>;
+export declare function logPasskeyRegistered(userId: string, email: string, options?: AuditClientOptions): Promise<void>;
+export declare function logPasskeyRemoved(userId: string, passkeyId: string, passkeyName?: string, options?: AuditClientOptions): Promise<void>;
+export declare function logPasskeyLogin(userId: string, passkeyId: string, sessionId: string, ipAddress?: string, userAgent?: string, options?: AuditClientOptions): Promise<void>;
+export declare function logPasskeyLoginFailed(email: string, reason: string, ipAddress?: string, userAgent?: string, options?: AuditClientOptions): Promise<void>;
+export declare function logOAuthTokenGenerated(userId: string, clientId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logOAuthTokenValidated(userId: string, clientId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logOAuthTokenRejected(clientId: string, reason: string, options?: AuditClientOptions): Promise<void>;
+export declare function logRoleCreated(roleId: string, roleName: string, actorId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logRoleUpdated(roleId: string, roleName: string, actorId: string, updates?: Record<string, unknown>, options?: AuditClientOptions): Promise<void>;
+export declare function logRoleDeleted(roleId: string, roleName: string, actorId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logPermissionGranted(roleId: string, roleName: string, appId: string, appName: string, actorId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logPermissionRevoked(roleId: string, roleName: string, appId: string, appName: string, actorId: string, options?: AuditClientOptions): Promise<void>;
+export declare function logUserActivated(userId: string, email: string, actorId?: string, options?: AuditClientOptions): Promise<void>;
+export declare function logUserDeactivated(userId: string, email: string, actorId: string, options?: AuditClientOptions): Promise<void>;
+//# sourceMappingURL=client.d.ts.map