@jazzmind/busibox-app 3.0.18

package/dist/lib/agent/chat-middleware.js

@@ -0,0 +1,234 @@
+/**
+ * Chat API Middleware
+ *
+ * Error handling, authentication, and common utilities for chat API routes.
+ */
+import { NextResponse } from 'next/server';
+/**
+ * Standard error response builder
+ */
+export function errorResponse(message, status = 500, code, details) {
+    return NextResponse.json({
+        error: message,
+        code: code || `ERROR_${status}`,
+        details,
+    }, { status });
+}
+/**
+ * Success response builder
+ */
+export function successResponse(data, status = 200) {
+    return NextResponse.json(data, { status });
+}
+/**
+ * Error codes for chat API
+ */
+export const ChatErrorCodes = {
+    // Authentication errors (401)
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    INVALID_TOKEN: 'INVALID_TOKEN',
+    TOKEN_EXPIRED: 'TOKEN_EXPIRED',
+    // Authorization errors (403)
+    FORBIDDEN: 'FORBIDDEN',
+    NO_CONVERSATION_ACCESS: 'NO_CONVERSATION_ACCESS',
+    CONVERSATION_IS_PRIVATE: 'CONVERSATION_IS_PRIVATE',
+    // Not found errors (404)
+    CONVERSATION_NOT_FOUND: 'CONVERSATION_NOT_FOUND',
+    MESSAGE_NOT_FOUND: 'MESSAGE_NOT_FOUND',
+    ATTACHMENT_NOT_FOUND: 'ATTACHMENT_NOT_FOUND',
+    // Validation errors (400)
+    INVALID_INPUT: 'INVALID_INPUT',
+    MISSING_REQUIRED_FIELD: 'MISSING_REQUIRED_FIELD',
+    INVALID_FILE_TYPE: 'INVALID_FILE_TYPE',
+    FILE_TOO_LARGE: 'FILE_TOO_LARGE',
+    // Service errors (503)
+    SEARCH_UNAVAILABLE: 'SEARCH_UNAVAILABLE',
+    OPENAI_UNAVAILABLE: 'OPENAI_UNAVAILABLE',
+    MILVUS_UNAVAILABLE: 'MILVUS_UNAVAILABLE',
+    // Rate limiting (429)
+    RATE_LIMIT_EXCEEDED: 'RATE_LIMIT_EXCEEDED',
+    // Server errors (500)
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+};
+/**
+ * Validate required fields in request body
+ */
+export function validateRequired(body, requiredFields) {
+    const missing = requiredFields.filter(field => !body[field]);
+    if (missing.length > 0) {
+        return { valid: false, missing: missing };
+    }
+    return { valid: true };
+}
+/**
+ * Parse and validate JSON request body
+ */
+export async function parseRequestBody(request) {
+    try {
+        const body = await request.json();
+        return { success: true, data: body };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: errorResponse('Invalid JSON in request body', 400, ChatErrorCodes.INVALID_INPUT),
+        };
+    }
+}
+/**
+ * Extract user ID from request (from auth middleware)
+ *
+ * Assumes authentication middleware has already run and set user context.
+ */
+export function getUserId(request) {
+    // This will be populated by your existing auth middleware
+    // Adjust based on your authentication implementation
+    return request.headers.get('x-user-id') || null;
+}
+/**
+ * Ensure user is authenticated
+ */
+export function requireAuth(request) {
+    const userId = getUserId(request);
+    if (!userId) {
+        return {
+            authenticated: false,
+            error: errorResponse('Authentication required', 401, ChatErrorCodes.UNAUTHORIZED),
+        };
+    }
+    return { authenticated: true, userId };
+}
+/**
+ * Safe async handler wrapper for API routes
+ *
+ * Catches errors and returns proper error responses
+ */
+export function withErrorHandling(handler) {
+    return async (request, context) => {
+        try {
+            return await handler(request, context);
+        }
+        catch (error) {
+            console.error('Chat API error:', {
+                path: request.nextUrl.pathname,
+                method: request.method,
+                error: error.message,
+                stack: error.stack,
+            });
+            // Handle known error types
+            if (error.code === 'ECONNREFUSED') {
+                return errorResponse('Service temporarily unavailable', 503, ChatErrorCodes.SEARCH_UNAVAILABLE, { service: 'data' });
+            }
+            // Handle OpenAI errors
+            if (error.message?.includes('OpenAI')) {
+                return errorResponse('AI service temporarily unavailable', 503, ChatErrorCodes.OPENAI_UNAVAILABLE);
+            }
+            // Handle Milvus errors
+            if (error.message?.includes('Milvus') || error.message?.includes('vector')) {
+                return errorResponse('Search service temporarily unavailable', 503, ChatErrorCodes.MILVUS_UNAVAILABLE);
+            }
+            // Generic error
+            return errorResponse('An unexpected error occurred', 500, ChatErrorCodes.INTERNAL_ERROR, process.env.NODE_ENV === 'development' ? { message: error.message } : undefined);
+        }
+    };
+}
+/**
+ * Validate file upload
+ */
+export function validateFileUpload(file, options = {}) {
+    const { maxSizeMB = 25, allowedTypes } = options;
+    // Check file size
+    const maxSizeBytes = maxSizeMB * 1024 * 1024;
+    if (file.size > maxSizeBytes) {
+        return {
+            valid: false,
+            error: errorResponse(`File too large. Maximum size is ${maxSizeMB}MB`, 400, ChatErrorCodes.FILE_TOO_LARGE, { maxSizeMB, actualSizeMB: (file.size / 1024 / 1024).toFixed(2) }),
+        };
+    }
+    // Check file type
+    if (allowedTypes && !allowedTypes.includes(file.type)) {
+        return {
+            valid: false,
+            error: errorResponse('File type not supported', 400, ChatErrorCodes.INVALID_FILE_TYPE, { allowedTypes, actualType: file.type }),
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Pagination helper
+ */
+export function parsePagination(request) {
+    const searchParams = request.nextUrl.searchParams;
+    const page = Math.max(1, parseInt(searchParams.get('page') || '1'));
+    const limit = Math.min(100, Math.max(1, parseInt(searchParams.get('limit') || '20')));
+    const offset = (page - 1) * limit;
+    return { page, limit, offset };
+}
+/**
+ * Build paginated response
+ */
+export function paginatedResponse(data, total, page, limit) {
+    return {
+        data,
+        pagination: {
+            page,
+            limit,
+            total,
+            totalPages: Math.ceil(total / limit),
+            hasNext: page * limit < total,
+            hasPrev: page > 1,
+        },
+    };
+}
+/**
+ * Rate limiting helper (simple in-memory implementation)
+ *
+ * For production, use Redis or a proper rate limiting service
+ */
+const rateLimitStore = new Map();
+export function checkRateLimit(userId, options = {}) {
+    const { maxRequests = 100, windowMs = 60000 } = options; // 100 requests per minute by default
+    const now = Date.now();
+    const userLimit = rateLimitStore.get(userId);
+    // Clean up expired entries periodically
+    if (Math.random() < 0.01) {
+        for (const [key, value] of rateLimitStore.entries()) {
+            if (value.resetAt < now) {
+                rateLimitStore.delete(key);
+            }
+        }
+    }
+    if (!userLimit || userLimit.resetAt < now) {
+        // New window
+        rateLimitStore.set(userId, {
+            count: 1,
+            resetAt: now + windowMs,
+        });
+        return {
+            allowed: true,
+            remaining: maxRequests - 1,
+            resetAt: now + windowMs,
+        };
+    }
+    if (userLimit.count >= maxRequests) {
+        return {
+            allowed: false,
+            remaining: 0,
+            resetAt: userLimit.resetAt,
+            error: errorResponse('Rate limit exceeded. Please try again later.', 429, ChatErrorCodes.RATE_LIMIT_EXCEEDED, {
+                resetAt: new Date(userLimit.resetAt).toISOString(),
+                limit: maxRequests,
+                window: `${windowMs / 1000}s`,
+            }),
+        };
+    }
+    // Increment count
+    userLimit.count++;
+    rateLimitStore.set(userId, userLimit);
+    return {
+        allowed: true,
+        remaining: maxRequests - userLimit.count,
+        resetAt: userLimit.resetAt,
+    };
+}
+//# sourceMappingURL=chat-middleware.js.map

package/dist/lib/agent/chat-middleware.js.map

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

package/dist/lib/agent/chat-search.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Chat Search Service
+ *
+ * Integrates web search and document search for chat conversations.
+ * Provides unified interface for both search types with proper error handling.
+ *
+ * MIGRATION NOTE: Now uses search-api for web search instead of direct provider SDKs.
+ */
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    score?: number;
+    publishedDate?: string;
+    domain?: string;
+}
+export interface DocumentSearchResult {
+    id: string;
+    title: string;
+    snippet: string;
+    source: string;
+    url?: string;
+    score: number;
+    fileId?: string;
+    documentId?: string;
+    metadata?: Record<string, any>;
+}
+export interface WebSearchOptions {
+    maxResults?: number;
+    includeAnswer?: boolean;
+}
+export interface DocumentSearchOptions {
+    limit?: number;
+    offset?: number;
+    mode?: 'keyword' | 'semantic' | 'hybrid';
+    authorization?: string;
+    useReranker?: boolean;
+    rerankerModel?: 'qwen3-gpu' | 'baai-gpu' | 'baai-cpu' | 'none';
+}
+/**
+ * Search the web using search-api for chat
+ *
+ * @param query - Search query
+ * @param userId - User ID (for logging)
+ * @param options - Search options
+ * @returns Search results with citations
+ */
+export declare function searchWebForChat(query: string, userId: string, options?: WebSearchOptions): Promise<{
+    results: SearchResult[];
+    answer?: string;
+    provider: string;
+    error?: string;
+}>;
+/**
+ * Search user's document libraries
+ *
+ * @param query - Search query
+ * @param userId - User ID
+ * @param options - Search options
+ * @returns Document search results
+ */
+export declare function searchDocuments(query: string, userId: string, options?: DocumentSearchOptions): Promise<{
+    results: DocumentSearchResult[];
+    total?: number;
+    error?: string;
+}>;
+/**
+ * Format search results for AI context
+ *
+ * @param webResults - Web search results
+ * @param docResults - Document search results
+ * @returns Formatted context string for AI prompt
+ */
+export declare function formatSearchResultsForAI(webResults?: SearchResult[], docResults?: DocumentSearchResult[]): string;
+/**
+ * Format search results as citations for display
+ *
+ * @param webResults - Web search results
+ * @param docResults - Document search results
+ * @returns Array of citation objects
+ */
+export declare function formatSearchResultsAsCitations(webResults?: SearchResult[], docResults?: DocumentSearchResult[]): Array<{
+    type: 'web' | 'document';
+    title: string;
+    url: string;
+    snippet: string;
+    source?: string;
+}>;
+//# sourceMappingURL=chat-search.d.ts.map

package/dist/lib/agent/chat-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-search.d.ts","sourceRoot":"","sources":["../../../src/lib/agent/chat-search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;CAChE;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC;IACT,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAwCD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;IACT,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA4ED;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,CAAC,EAAE,YAAY,EAAE,EAC3B,UAAU,CAAC,EAAE,oBAAoB,EAAE,GAClC,MAAM,CA0BR;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,CAAC,EAAE,YAAY,EAAE,EAC3B,UAAU,CAAC,EAAE,oBAAoB,EAAE,GAClC,KAAK,CAAC;IACP,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAkCD"}

package/dist/lib/agent/chat-search.js

@@ -0,0 +1,203 @@
+/**
+ * Chat Search Service
+ *
+ * Integrates web search and document search for chat conversations.
+ * Provides unified interface for both search types with proper error handling.
+ *
+ * MIGRATION NOTE: Now uses search-api for web search instead of direct provider SDKs.
+ */
+// Search API configuration - use environment variables for deployment flexibility
+// Search API is deployed to milvus-lxc, colocated with Milvus for low-latency vector operations
+const SEARCH_API_HOST = process.env.SEARCH_API_HOST || process.env.SEARCH_API_IP || 'localhost';
+const SEARCH_API_PORT = process.env.SEARCH_API_PORT || '8003'; // Default to 8003 (search-api port on milvus-lxc)
+const SEARCH_API_URL = `http://${SEARCH_API_HOST}:${SEARCH_API_PORT}`;
+/**
+ * Search the web using search-api for chat
+ *
+ * @param query - Search query
+ * @param userId - User ID (for logging)
+ * @param options - Search options
+ * @returns Search results with citations
+ */
+export async function searchWebForChat(query, userId, options = {}) {
+    console.log(`[Chat Search] Starting web search for user ${userId}, query: "${query}"`);
+    try {
+        // Call search-api web search endpoint
+        const response = await fetch(`${SEARCH_API_URL}/web-search`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-User-Id': userId,
+            },
+            body: JSON.stringify({
+                query,
+                max_results: options.maxResults || 5,
+                include_answer: options.includeAnswer ?? true,
+            }),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({ detail: 'Unknown error' }));
+            throw new Error(errorData.detail || 'Web search failed');
+        }
+        const data = await response.json();
+        console.log(`[Chat Search] Search completed. Results: ${data.results.length}, Provider: ${data.provider}`);
+        return {
+            results: data.results,
+            answer: data.metadata?.answer,
+            provider: data.provider,
+        };
+    }
+    catch (error) {
+        console.error(`[Chat Search] Web search failed for user ${userId}:`, error);
+        return {
+            results: [],
+            provider: 'none',
+            error: error.message || 'Web search failed',
+        };
+    }
+}
+/**
+ * Search user's document libraries
+ *
+ * @param query - Search query
+ * @param userId - User ID
+ * @param options - Search options
+ * @returns Document search results
+ */
+export async function searchDocuments(query, userId, options = {}) {
+    try {
+        // Build headers - prefer JWT authorization, fall back to X-User-Id
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-User-Id': userId,
+        };
+        // Add Authorization header if provided (JWT passthrough for RLS)
+        if (options.authorization) {
+            headers['Authorization'] = options.authorization;
+        }
+        const response = await fetch(`${SEARCH_API_URL}/search`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                query,
+                mode: options.mode || 'hybrid',
+                limit: options.limit || 5,
+                offset: options.offset || 0,
+                rerank: options.useReranker !== false, // Default to true
+                reranker_model: options.rerankerModel || 'qwen3-gpu',
+                rerank_k: 100,
+                dense_weight: 0.7,
+                sparse_weight: 0.3,
+                // Return full chunk content for RAG (not just fragments)
+                // Larger fragment size ensures LLM gets enough context
+                highlight: {
+                    enabled: true,
+                    fragment_size: 2000, // Larger fragments for better RAG context
+                    num_fragments: 1, // Single comprehensive fragment per result
+                },
+                // Request full content if available
+                include_content: true,
+            }),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({ error: 'Unknown error' }));
+            throw new Error(errorData.detail || errorData.error || 'Document search failed');
+        }
+        const data = await response.json();
+        // Transform results to DocumentSearchResult format
+        const results = (data.results || []).map((r) => ({
+            id: r.id || r.chunk_id || '',
+            title: r.title || r.filename || 'Untitled',
+            snippet: r.text || r.content || r.snippet || '', // text is the chunk content from search API
+            source: r.source || r.library_name || 'Document Library',
+            url: r.url || `/documents/${r.file_id || r.document_id}`,
+            score: r.score || r.relevance_score || 0,
+            fileId: r.file_id,
+            documentId: r.document_id,
+            metadata: {
+                chunkId: r.chunk_id,
+                pageNumber: r.page_number,
+                highlighted: r.highlighted,
+                denseScore: r.dense_score,
+                sparseScore: r.sparse_score,
+                rerankScore: r.rerank_score,
+            },
+        }));
+        return {
+            results,
+            total: data.total,
+        };
+    }
+    catch (error) {
+        console.error(`[Chat Search] Document search failed for user ${userId}:`, error);
+        return {
+            results: [],
+            error: error.message || 'Document search failed',
+        };
+    }
+}
+/**
+ * Format search results for AI context
+ *
+ * @param webResults - Web search results
+ * @param docResults - Document search results
+ * @returns Formatted context string for AI prompt
+ */
+export function formatSearchResultsForAI(webResults, docResults) {
+    const parts = [];
+    if (webResults && webResults.length > 0) {
+        parts.push('Web Search Results:');
+        webResults.forEach((result, i) => {
+            parts.push(`${i + 1}. [${result.title}](${result.url})`);
+            parts.push(`   ${result.snippet}`);
+            if (result.publishedDate) {
+                parts.push(`   Published: ${result.publishedDate}`);
+            }
+        });
+    }
+    if (docResults && docResults.length > 0) {
+        parts.push('\nDocument Library Results:');
+        docResults.forEach((result, i) => {
+            parts.push(`${i + 1}. ${result.title} (${result.source})`);
+            parts.push(`   ${result.snippet}`);
+            if (result.url) {
+                parts.push(`   Source: ${result.url}`);
+            }
+        });
+    }
+    return parts.join('\n');
+}
+/**
+ * Format search results as citations for display
+ *
+ * @param webResults - Web search results
+ * @param docResults - Document search results
+ * @returns Array of citation objects
+ */
+export function formatSearchResultsAsCitations(webResults, docResults) {
+    const citations = [];
+    if (webResults) {
+        webResults.forEach((result) => {
+            citations.push({
+                type: 'web',
+                title: result.title,
+                url: result.url,
+                snippet: result.snippet,
+                source: result.domain,
+            });
+        });
+    }
+    if (docResults) {
+        docResults.forEach((result) => {
+            citations.push({
+                type: 'document',
+                title: result.title,
+                url: result.url || '#',
+                snippet: result.snippet,
+                source: result.source,
+            });
+        });
+    }
+    return citations;
+}
+//# sourceMappingURL=chat-search.js.map

package/dist/lib/agent/chat-search.js.map

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

package/dist/lib/agent/chat-sharing.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Conversation Sharing Service
+ *
+ * Handles sharing conversations with other users, including:
+ * - Creating and managing shares
+ * - Verifying permissions
+ * - Triggering insight extraction for shared users
+ *
+ * Uses agent-api HTTP client (no Prisma).
+ */
+export type ShareRole = 'viewer' | 'editor';
+export interface ShareConversationInput {
+    conversationId: string;
+    ownerId: string;
+    targetUserEmail: string;
+    role: ShareRole;
+}
+export interface ConversationShareInfo {
+    id: string;
+    userId: string;
+    userEmail: string;
+    role: ShareRole;
+    sharedBy: string;
+    sharedAt: Date;
+}
+/**
+ * Share a conversation with another user
+ *
+ * @param token - Agent-api access token
+ * @param input - Share input parameters
+ * @returns Created share record
+ * @throws Error if conversation not found, user is owner, conversation is private, or target user not found
+ */
+export declare function shareConversation(token: string, input: ShareConversationInput): Promise<ConversationShareInfo>;
+/**
+ * Unshare a conversation with a specific user
+ *
+ * @param token - Agent-api access token
+ * @param conversationId - Conversation ID
+ * @param userId - User ID to unshare with
+ * @param ownerId - Owner ID (for verification)
+ * @returns True if unshared successfully
+ * @throws Error if conversation not found, user is not owner, or share not found
+ */
+export declare function unshareConversation(token: string, conversationId: string, userId: string, ownerId: string): Promise<boolean>;
+/**
+ * Get all shares for a conversation
+ *
+ * @param token - Agent-api access token
+ * @param conversationId - Conversation ID
+ * @param userId - User ID (must be owner or shared user)
+ * @returns Array of share information
+ */
+export declare function getConversationShares(token: string, conversationId: string, userId: string): Promise<ConversationShareInfo[]>;
+/**
+ * Get rich access info for a conversation
+ *
+ * Wraps the canonical checkConversationAccess from chat-conversations.
+ *
+ * @param token - Agent-api access token
+ * @param conversationId - Conversation ID
+ * @param userId - User ID to check
+ * @returns Object with hasAccess, role, and isOwner flags
+ */
+export declare function getConversationAccessInfo(token: string, conversationId: string, userId: string): Promise<{
+    hasAccess: boolean;
+    role: 'owner' | 'editor' | 'viewer' | null;
+    isOwner: boolean;
+}>;
+//# sourceMappingURL=chat-sharing.d.ts.map

package/dist/lib/agent/chat-sharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-sharing.d.ts","sourceRoot":"","sources":["../../../src/lib/agent/chat-sharing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CA8ChC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAqBlC;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC3C,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAOD"}