sylix 3.1.0 → 3.2.0

package/dist/index.d.ts

@@ -37,37 +37,95 @@ declare class Reason {
     process(payload: ReasonRequest): Promise<ReasonResponse>;
     private handleError;
 }
+/**
+ * Stream response wrapper with controller
+ */
+declare class Stream<T> implements AsyncIterable<T> {
+    private iterator;
+    controller: AbortController;
+    constructor(iterator: AsyncGenerator<T, void, unknown>, controller: AbortController);
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    /**
+     * Abort the stream
+     */
+    abort(): void;
+    /**
+     * Convert stream to array
+     */
+    toArray(): Promise<T[]>;
+    /**
+     * Get final message by accumulating all chunks
+     */
+    finalMessage(): Promise<string>;
+}
 /**
  * Charles chat completions namespace
  * Usage: sylix.charles.chat.completions.create()
+ *
+ * OpenAI-compatible API with streaming, abort controller, and tool calls
  */
 declare class CharlesChatCompletions {
     private client;
     constructor(client: SylixClient);
     /**
-     * Create a chat completion
-     * @param payload - Chat request parameters
-     * @returns Chat completion response
-     */
-    create(payload: CharlesChatRequest): Promise<ChatResponse>;
-    /**
-     * Create a streaming chat completion
+     * Create a chat completion (OpenAI-compatible)
+     *
      * @param payload - Chat request parameters
-     * @returns Async iterator of chat completion chunks
+     * @param options - Additional options (signal for abort)
+     * @returns Chat response or Stream if stream: true
      *
      * @example
      * ```typescript
-     * const stream = await sylix.charles.chat.completions.stream({
+     * // Non-streaming
+     * const response = await sylix.charles.chat.completions.create({
      *   model: 'charles-v3:latest',
      *   messages: [{ role: 'user', content: 'Hello!' }]
      * });
      *
+     * // Streaming (OpenAI-style)
+     * const stream = await sylix.charles.chat.completions.create({
+     *   model: 'charles-v3:latest',
+     *   messages: [{ role: 'user', content: 'Hello!' }],
+     *   stream: true
+     * });
      * for await (const chunk of stream) {
      *   process.stdout.write(chunk.choices[0]?.delta?.content || '');
      * }
+     *
+     * // With abort controller
+     * const stream = await sylix.charles.chat.completions.create({
+     *   model: 'charles-v3:latest',
+     *   messages: [...],
+     *   stream: true
+     * });
+     * setTimeout(() => stream.abort(), 5000); // Cancel after 5s
      * ```
      */
-    stream(payload: CharlesChatRequest): AsyncGenerator<ChatStreamChunk, void, unknown>;
+    create(payload: CharlesChatRequest & {
+        stream: true;
+    }, options?: {
+        signal?: AbortSignal;
+    }): Promise<Stream<ChatStreamChunk>>;
+    create(payload: CharlesChatRequest & {
+        stream?: false;
+    }, options?: {
+        signal?: AbortSignal;
+    }): Promise<ChatResponse>;
+    create(payload: CharlesChatRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<ChatResponse | Stream<ChatStreamChunk>>;
+    /**
+     * Non-streaming completion
+     */
+    private createNonStream;
+    /**
+     * Streaming completion with OpenAI-compatible interface
+     */
+    private createStream;
+    /**
+     * Parse Server-Sent Events stream
+     */
+    private parseSSE;
     private handleError;
 }
 /**

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -108,24 +108,70 @@ class Reason {
 }
 // ============================================================================
 // CHARLES v1 NAMESPACE (OpenAI-compatible)
-// Owned by Sylix © 2025
+// Owned by Sylix © 2026
 // ============================================================================
+/**
+ * Stream response wrapper with controller
+ */
+class Stream {
+    constructor(iterator, controller) {
+        this.iterator = iterator;
+        this.controller = controller;
+    }
+    [Symbol.asyncIterator]() {
+        return this.iterator;
+    }
+    /**
+     * Abort the stream
+     */
+    abort() {
+        this.controller.abort();
+    }
+    /**
+     * Convert stream to array
+     */
+    async toArray() {
+        const chunks = [];
+        for await (const chunk of this) {
+            chunks.push(chunk);
+        }
+        return chunks;
+    }
+    /**
+     * Get final message by accumulating all chunks
+     */
+    async finalMessage() {
+        let content = '';
+        for await (const chunk of this) {
+            const delta = chunk.choices?.[0]?.delta?.content;
+            if (delta)
+                content += delta;
+        }
+        return content;
+    }
+}
 /**
  * Charles chat completions namespace
  * Usage: sylix.charles.chat.completions.create()
+ *
+ * OpenAI-compatible API with streaming, abort controller, and tool calls
  */
 class CharlesChatCompletions {
     constructor(client) {
         this.client = client;
     }
+    async create(payload, options) {
+        if (payload.stream) {
+            return this.createStream(payload, options);
+        }
+        return this.createNonStream(payload, options);
+    }
     /**
-     * Create a chat completion
-     * @param payload - Chat request parameters
-     * @returns Chat completion response
+     * Non-streaming completion
      */
-    async create(payload) {
+    async createNonStream(payload, options) {
         try {
-            const response = await this.client.getClient().post("/charles/chat/completions", { ...payload, stream: false });
+            const response = await this.client.getClient().post("/charles/chat/completions", { ...payload, stream: false }, { signal: options?.signal });
             return response.data;
         }
         catch (error) {
@@ -133,25 +179,16 @@ class CharlesChatCompletions {
         }
     }
     /**
-     * Create a streaming chat completion
-     * @param payload - Chat request parameters
-     * @returns Async iterator of chat completion chunks
-     *
-     * @example
-     * ```typescript
-     * const stream = await sylix.charles.chat.completions.stream({
-     *   model: 'charles-v3:latest',
-     *   messages: [{ role: 'user', content: 'Hello!' }]
-     * });
-     *
-     * for await (const chunk of stream) {
-     *   process.stdout.write(chunk.choices[0]?.delta?.content || '');
-     * }
-     * ```
+     * Streaming completion with OpenAI-compatible interface
      */
-    async *stream(payload) {
+    async createStream(payload, options) {
+        const controller = new AbortController();
         const baseURL = this.client.getBaseURL();
         const apiKey = this.client.getApiKey();
+        // Link external signal to internal controller
+        if (options?.signal) {
+            options.signal.addEventListener('abort', () => controller.abort());
+        }
         const response = await fetch(`${baseURL}/charles/chat/completions`, {
             method: 'POST',
             headers: {
@@ -159,6 +196,7 @@ class CharlesChatCompletions {
                 'x-api-key': apiKey,
             },
             body: JSON.stringify({ ...payload, stream: true }),
+            signal: controller.signal,
         });
         if (!response.ok) {
             throw new SylixError('STREAM_ERROR', `Stream request failed: ${response.status} ${response.statusText}`);
@@ -166,11 +204,20 @@ class CharlesChatCompletions {
         if (!response.body) {
             throw new SylixError('STREAM_ERROR', 'No response body');
         }
-        const reader = response.body.getReader();
+        const iterator = this.parseSSE(response.body, controller);
+        return new Stream(iterator, controller);
+    }
+    /**
+     * Parse Server-Sent Events stream
+     */
+    async *parseSSE(body, controller) {
+        const reader = body.getReader();
         const decoder = new TextDecoder();
         let buffer = '';
         try {
             while (true) {
+                if (controller.signal.aborted)
+                    break;
                 const { done, value } = await reader.read();
                 if (done)
                     break;
@@ -184,6 +231,11 @@ class CharlesChatCompletions {
                     if (trimmed.startsWith('data: ')) {
                         try {
                             const json = JSON.parse(trimmed.slice(6));
+                            // Parse tool calls if present
+                            const choice = json.choices?.[0];
+                            if (choice?.delta && choice.delta.tool_calls) {
+                                // Tool calls are already parsed in the chunk
+                            }
                             yield json;
                         }
                         catch (e) {
@@ -198,6 +250,9 @@ class CharlesChatCompletions {
         }
     }
     handleError(error) {
+        if (error.name === 'AbortError') {
+            return new SylixError('ABORTED', 'Request was aborted');
+        }
         const message = error.response?.data?.error?.message || error.message || "Unknown error";
         const code = error.response?.data?.error?.code || error.code || "UNKNOWN_ERROR";
         return new SylixError(code, message, error.response?.data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sylix",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "The official Sylix AI SDK for TypeScript and JavaScript. Build intelligent applications with Charles v3 models featuring multi-model consensus, intelligent routing, vision understanding, deep reasoning, and OpenAI-compatible APIs. Enterprise-grade AI infrastructure for developers.",
   "type": "module",
   "main": "./dist/index.js",