@qelos/sdk 3.11.3 → 3.11.4

package/dist/ai.js

@@ -1,175 +1,115 @@
 import BaseSDK from './base-sdk';
+import ThreadsSDK from './ai/threads';
+import ChatSDK from './ai/chat';
+import RAGSDK from './ai/rag';
+/**
+ * Qelos AI SDK - Main SDK class with three sub-SDKs
+ *
+ * This class provides access to AI functionality through three sub-SDKs:
+ * - `threads`: Thread CRUD operations for managing conversation threads
+ * - `chat`: Chat completion operations (streaming and non-streaming)
+ * - `rag`: Vector storage management for Retrieval-Augmented Generation
+ *
+ * @example
+ * ```typescript
+ * const sdk = new QelosSDK({
+ *   appUrl: 'https://your-qelos-instance.com',
+ *   fetch: globalThis.fetch,
+ *   accessToken: 'your-token'
+ * });
+ *
+ * // Create a thread
+ * const thread = await sdk.ai.threads.create({ integration: 'id' });
+ *
+ * // Stream chat
+ * const stream = await sdk.ai.chat.stream('id', { messages: [...] });
+ * for await (const chunk of sdk.ai.chat.parseSSEStream(stream)) {
+ *   console.log(chunk);
+ * }
+ *
+ * // Upload RAG content
+ * await sdk.ai.rag.uploadContent('sourceId', { content: '...' });
+ * ```
+ */
+// Main AI SDK with sub-SDKs
 export default class QlAI extends BaseSDK {
-    relativePath = '/api/ai';
+    /**
+     * Threads sub-SDK for managing conversation threads
+     */
+    threads;
+    /**
+     * Chat sub-SDK for chat completion operations
+     */
+    chat;
+    /**
+     * RAG sub-SDK for vector storage management
+     */
+    rag;
+    /**
+     * Initialize the AI SDK with sub-SDKs
+     *
+     * @param options - SDK configuration options
+     */
     constructor(options) {
         super(options);
+        this.threads = new ThreadsSDK(options);
+        this.chat = new ChatSDK(options);
+        this.rag = new RAGSDK(options);
     }
-    // Thread CRUD Operations
+    // Legacy methods for backward compatibility
     /**
-     * Create a new thread
+     * @deprecated Use sdk.threads.create() instead
      */
     createThread(data) {
-        return this.callJsonApi(this.relativePath + '/threads', {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify(data)
-        });
+        return this.threads.create(data);
     }
     /**
-     * Get a specific thread by ID
+     * @deprecated Use sdk.threads.getOne() instead
      */
     getThread(threadId) {
-        return this.callJsonApi(`${this.relativePath}/threads/${threadId}${this.getQueryParams({})}`);
+        return this.threads.getOne(threadId);
     }
     /**
-     * List threads with optional filters
+     * @deprecated Use sdk.threads.list() instead
      */
     listThreads(options) {
-        const queryParams = this.getQueryParams(options);
-        return this.callJsonApi(`${this.relativePath}/threads${queryParams}`);
+        return this.threads.list(options);
     }
     /**
-     * Delete a thread
+     * @deprecated Use sdk.threads.delete() instead
      */
     deleteThread(threadId) {
-        return this.callJsonApi(`${this.relativePath}/threads/${threadId}${this.getQueryParams({})}`, {
-            method: 'DELETE'
-        });
+        return this.threads.delete(threadId);
     }
-    // Chat Completion Operations
     /**
-     * Create a chat completion without a thread
+     * @deprecated Use sdk.chat.chat() instead
      */
-    chat(integrationId, options) {
-        return this.callJsonApi(`${this.relativePath}/${integrationId}/chat-completion${this.getQueryParams({})}`, {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify(options)
-        });
+    chatCompletion(integrationId, options) {
+        return this.chat.chat(integrationId, options);
     }
     /**
-     * Create a chat completion with a thread
+     * @deprecated Use sdk.chat.chatInThread() instead
      */
-    chatInThread(integrationId, threadId, options) {
-        return this.callJsonApi(`${this.relativePath}/${integrationId}/chat-completion/${threadId}${this.getQueryParams({})}`, {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify(options)
-        });
+    chatCompletionInThread(integrationId, threadId, options) {
+        return this.chat.chatInThread(integrationId, threadId, options);
     }
     /**
-     * Create a streaming chat completion without a thread
-     * Returns a ReadableStream for Server-Sent Events
+     * @deprecated Use sdk.chat.stream() instead
      */
     async streamChat(integrationId, options) {
-        const response = await this.callApi(`${this.relativePath}/${integrationId}/chat-completion${this.getQueryParams({ stream: true })}`, {
-            method: 'POST',
-            headers: {
-                'content-type': 'application/json',
-                'accept': 'text/event-stream'
-            },
-            body: JSON.stringify({ ...options, stream: true })
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-        }
-        return response.body;
+        return this.chat.stream(integrationId, options);
     }
     /**
-     * Create a streaming chat completion with a thread
-     * Returns a ReadableStream for Server-Sent Events
+     * @deprecated Use sdk.chat.streamInThread() instead
      */
     async streamChatInThread(integrationId, threadId, options) {
-        const response = await this.callApi(`${this.relativePath}/${integrationId}/chat-completion/${threadId}${this.getQueryParams({ stream: true })}`, {
-            method: 'POST',
-            headers: {
-                'content-type': 'application/json',
-                'accept': 'text/event-stream'
-            },
-            body: JSON.stringify({ ...options, stream: true })
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-        }
-        return response.body;
+        return this.chat.streamInThread(integrationId, threadId, options);
     }
     /**
-     * Helper method to parse Server-Sent Events stream
+     * @deprecated Use sdk.chat.parseSSEStream() instead
      */
     parseSSEStream(stream) {
-        const processStream = async (onData) => {
-            const reader = stream.getReader();
-            const decoder = new TextDecoder();
-            let buffer = "";
-            try {
-                while (true) {
-                    const { done, value } = await reader.read();
-                    if (done)
-                        break;
-                    buffer += decoder.decode(value, { stream: true });
-                    let lines = buffer.split(/\r?\n/);
-                    buffer = lines.pop() || ""; // Keep incomplete line
-                    for (const line of lines) {
-                        if (line.startsWith('data: ')) {
-                            const data = line.slice(6);
-                            if (data === '[DONE]')
-                                return;
-                            try {
-                                const parsed = JSON.parse(data);
-                                const shouldContinue = onData(parsed);
-                                if (shouldContinue === false) {
-                                    return;
-                                }
-                            }
-                            catch (e) {
-                                // Skip invalid JSON
-                            }
-                        }
-                    }
-                }
-            }
-            finally {
-                reader.releaseLock();
-            }
-        };
-        const processor = {
-            async *[Symbol.asyncIterator]() {
-                const reader = stream.getReader();
-                const decoder = new TextDecoder();
-                let buffer = "";
-                try {
-                    while (true) {
-                        const { done, value } = await reader.read();
-                        if (done) {
-                            break;
-                        }
-                        buffer += decoder.decode(value, { stream: true });
-                        let lines = buffer.split(/\r?\n/);
-                        buffer = lines.pop() || ""; // Keep incomplete line
-                        for (const line of lines) {
-                            if (line.startsWith('data: ')) {
-                                const data = line.slice(6);
-                                if (data === '[DONE]') {
-                                    return;
-                                }
-                                try {
-                                    const parsed = JSON.parse(data);
-                                    yield parsed;
-                                }
-                                catch (e) {
-                                    //
-                                }
-                            }
-                        }
-                    }
-                }
-                finally {
-                    reader.releaseLock();
-                }
-            },
-            processManually: processStream
-        };
-        return processor;
+        return this.chat.parseSSEStream(stream);
     }
 }
 //# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,YAAY,CAAC;AACjC,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,OAAO,MAAM,WAAW,CAAC;AAChC,OAAO,MAAM,MAAM,UAAU,CAAC;AA8B9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,4BAA4B;AAC5B,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC;;OAEG;IACI,OAAO,CAAa;IAE3B;;OAEG;IACI,IAAI,CAAU;IAErB;;OAEG;IACI,GAAG,CAAS;IAEnB;;;;OAIG;IACH,YAAY,OAAwB;QAClC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,4CAA4C;IAE5C;;OAEG;IACH,YAAY,CAAC,IAA0B;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAQX;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,aAAqB,EACrB,OAA+B;QAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,sBAAsB,CACpB,aAAqB,EACrB,QAAgB,EAChB,OAA+B;QAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,aAAqB,EACrB,OAA+B;QAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,aAAqB,EACrB,QAAgB,EAChB,OAA+B;QAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAkC;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/examples/ai-sdk-usage.ts

@@ -0,0 +1,170 @@
+// Example usage of the new Qelos AI SDK with sub-SDKs
+
+import QelosSDK from '../src';
+// Alternatively, you can import specific sub-SDKs:
+// import { ThreadsSDK, ChatSDK, RAGSDK } from '../src/ai';
+
+// Initialize the SDK
+const sdk = new QelosSDK({
+  appUrl: 'https://your-qelos-instance.com',
+  fetch: globalThis.fetch || require('node-fetch'),
+  accessToken: 'your-access-token'
+});
+
+// ===== THREADS SUB-SDK =====
+async function threadExamples() {
+  // Create a new thread
+  const thread = await sdk.ai.threads.create({
+    integration: 'integration-id',
+    title: 'Customer Support Chat'
+  });
+  
+  // Get a specific thread
+  const retrievedThread = await sdk.ai.threads.getOne(thread._id!);
+  
+  // List threads with filters
+  const threads = await sdk.ai.threads.list({
+    integration: 'integration-id',
+    limit: 10,
+    page: 1
+  });
+  
+  // Delete a thread
+  await sdk.ai.threads.delete(thread._id!);
+}
+
+// ===== CHAT SUB-SDK =====
+async function chatExamples() {
+  const integrationId = 'your-integration-id';
+  const messages = [
+    { role: 'user', content: 'Hello, how can you help me?' }
+  ];
+  
+  // Non-streaming chat
+  const response = await sdk.ai.chat.chat(integrationId, {
+    messages,
+    model: 'gpt-4',
+    temperature: 0.7,
+    queryParams: { bypassAdmin: true } // Optional query params
+  });
+  
+  console.log(response.choices[0].message.content);
+  
+  // Streaming chat
+  const stream = await sdk.ai.chat.stream(integrationId, {
+    messages,
+    stream: true
+  });
+  
+  // Parse the SSE stream
+  const processor = sdk.ai.chat.parseSSEStream(stream);
+  for await (const chunk of processor) {
+    if (chunk.choices?.[0]?.delta?.content) {
+      console.log(chunk.choices[0].delta.content);
+    }
+  }
+  
+  // Chat in a thread
+  const threadId = 'thread-id';
+  const threadResponse = await sdk.ai.chat.chatInThread(integrationId, threadId, {
+    messages
+  });
+  
+  // Streaming chat in a thread
+  const threadStream = await sdk.ai.chat.streamInThread(integrationId, threadId, {
+    messages,
+    stream: true
+  });
+  
+  for await (const chunk of sdk.ai.chat.parseSSEStream(threadStream)) {
+    console.log(chunk);
+  }
+}
+
+// ===== RAG SUB-SDK =====
+async function ragExamples() {
+  const sourceId = 'your-ai-source-id';
+  
+  // Create vector storage
+  const storage = await sdk.ai.rag.createStorage(sourceId, {
+    integrationId: 'integration-id',
+    scope: 'thread', // 'thread' | 'user' | 'workspace' | 'tenant'
+    subjectId: 'thread-id', // Required for non-tenant scopes
+    expirationAfterDays: 30
+  });
+  
+  // Upload content to storage
+  const uploadResult = await sdk.ai.rag.uploadContent(sourceId, {
+    integrationId: 'integration-id',
+    content: 'This is the content to be indexed for RAG.',
+    fileName: 'document.txt',
+    metadata: { type: 'documentation', category: 'help' }
+  });
+  
+  // Upload JSON content
+  const jsonUpload = await sdk.ai.rag.uploadContent(sourceId, {
+    integrationId: 'integration-id',
+    content: { title: 'Product Info', description: '...' },
+    fileName: 'product-info.json'
+  });
+  
+  // Clear specific files
+  const clearResult = await sdk.ai.rag.clearStorage(sourceId, {
+    integrationId: 'integration-id',
+    fileIds: [uploadResult.fileId]
+  });
+  
+  // Clear all files (if no fileIds provided)
+  await sdk.ai.rag.clearStorage(sourceId, {
+    integrationId: 'integrationId'
+  });
+  
+  // Get vector stores (internal API - server-side only)
+  const stores = await sdk.ai.rag.getVectorStores({
+    scope: 'thread',
+    subjectId: 'thread-id'
+  });
+}
+
+// ===== COMBINED EXAMPLE =====
+async function combinedExample() {
+  // 1. Create a thread
+  const thread = await sdk.ai.threads.create({
+    integration: 'integration-id',
+    title: 'RAG-enabled Chat'
+  });
+  
+  // 2. Upload knowledge base content
+  await sdk.ai.rag.uploadContent('source-id', {
+    integrationId: 'integration-id',
+    content: 'Your knowledge base content here...',
+    fileName: 'knowledge-base.txt'
+  });
+  
+  // 3. Chat with RAG
+  const stream = await sdk.ai.chat.streamInThread(
+    'integration-id',
+    thread._id!,
+    {
+      messages: [
+        { role: 'user', content: 'What do you know about the topic?' }
+      ],
+      stream: true
+    }
+  );
+  
+  // 4. Process the response
+  for await (const chunk of sdk.ai.chat.parseSSEStream(stream)) {
+    if (chunk.choices?.[0]?.delta?.content) {
+      console.log(chunk.choices[0].delta.content);
+    }
+  }
+}
+
+// Export for reference
+export {
+  threadExamples,
+  chatExamples,
+  ragExamples,
+  combinedExample
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qelos/sdk",
-  "version": "3.11.3",
+  "version": "3.11.4",
   "description": "SDK for Qelos API",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/ai/chat.ts

@@ -0,0 +1,187 @@
+import BaseSDK from '../base-sdk';
+import { QelosSDKOptions } from '../types';
+import { 
+  IChatCompletionOptions, 
+  IChatCompletionResponse, 
+  ISSEStreamProcessor 
+} from '../ai';
+
+export default class ChatSDK extends BaseSDK {
+  private relativePath = '/api/ai';
+
+  constructor(options: QelosSDKOptions) {
+    super(options);
+  }
+
+  /**
+   * Create a chat completion without a thread
+   */
+  chat(
+    integrationId: string,
+    options: IChatCompletionOptions
+  ): Promise<IChatCompletionResponse> {
+    const queryParams = this.getQueryParams(options.queryParams || {});
+    return this.callJsonApi<IChatCompletionResponse>(`${this.relativePath}/${integrationId}/chat-completion${queryParams}`, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify(options)
+    });
+  }
+
+  /**
+   * Create a chat completion with a thread
+   */
+  chatInThread(
+    integrationId: string,
+    threadId: string,
+    options: IChatCompletionOptions
+  ): Promise<IChatCompletionResponse> {
+    const queryParams = this.getQueryParams(options.queryParams || {});
+    return this.callJsonApi<IChatCompletionResponse>(
+      `${this.relativePath}/${integrationId}/chat-completion/${threadId}${queryParams}`,
+      {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(options)
+      }
+    );
+  }
+
+  /**
+   * Create a streaming chat completion without a thread
+   * Returns a ReadableStream for Server-Sent Events
+   */
+  async stream(
+    integrationId: string,
+    options: IChatCompletionOptions
+  ): Promise<ReadableStream<Uint8Array>> {
+    const queryParams = this.getQueryParams({ ...options.queryParams, stream: true });
+    const response = await this.callApi(`${this.relativePath}/${integrationId}/chat-completion${queryParams}`, {
+      method: 'POST',
+      headers: { 
+        'content-type': 'application/json',
+        'accept': 'text/event-stream'
+      },
+      body: JSON.stringify({ ...options, stream: true })
+    });
+
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    return response.body!;
+  }
+
+  /**
+   * Create a streaming chat completion with a thread
+   * Returns a ReadableStream for Server-Sent Events
+   */
+  async streamInThread(
+    integrationId: string,
+    threadId: string,
+    options: IChatCompletionOptions
+  ): Promise<ReadableStream<Uint8Array>> {
+    const queryParams = this.getQueryParams({ ...options.queryParams, stream: true });
+    const response = await this.callApi(
+      `${this.relativePath}/${integrationId}/chat-completion/${threadId}${queryParams}`,
+      {
+        method: 'POST',
+        headers: { 
+          'content-type': 'application/json',
+          'accept': 'text/event-stream'
+        },
+        body: JSON.stringify({ ...options, stream: true })
+      }
+    );
+
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    return response.body!;
+  }
+
+  /**
+   * Helper method to parse Server-Sent Events stream
+   */
+  parseSSEStream(stream: ReadableStream<Uint8Array>): ISSEStreamProcessor {
+    const processStream = async (onData: (data: any) => void | boolean): Promise<void> => {
+      const reader = stream.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      
+      try {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+
+          buffer += decoder.decode(value, { stream: true });
+          let lines = buffer.split(/\r?\n/);
+          buffer = lines.pop() || ""; // Keep incomplete line
+
+          for (const line of lines) {
+            if (line.startsWith('data: ')) {
+              const data = line.slice(6);
+              if (data === '[DONE]') return;
+              
+              try {
+                const parsed = JSON.parse(data);
+                const shouldContinue = onData(parsed);
+                if (shouldContinue === false) {
+                  return;
+                }
+              } catch (e) {
+                // Skip invalid JSON
+              }
+            }
+          }
+        }
+      } finally {
+        reader.releaseLock();
+      }
+    };
+
+    const processor = {
+      async *[Symbol.asyncIterator]() {
+        const reader = stream.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";        
+        
+        try {
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+              break;
+            }
+
+            buffer += decoder.decode(value, { stream: true });
+            let lines = buffer.split(/\r?\n/);
+            buffer = lines.pop() || ""; // Keep incomplete line
+
+            for (const line of lines) {
+              if (line.startsWith('data: ')) {
+                const data = line.slice(6);
+                if (data === '[DONE]') {
+                  return;
+                }
+                
+                try {
+                  const parsed = JSON.parse(data);
+                  yield parsed;
+                } catch (e) {
+                  //
+                }
+              }
+            }
+          }
+        } finally {
+          reader.releaseLock();
+        }
+      },
+      
+      processManually: processStream
+    };
+    
+    return processor as ISSEStreamProcessor;
+  }
+}

package/src/ai/index.ts

@@ -0,0 +1,4 @@
+export { default as ThreadsSDK } from './threads';
+export { default as ChatSDK } from './chat';
+export { default as RAGSDK } from './rag';
+export * from './types';