chat-flow-ardymalihi 1.0.2 → 3.0.0

package/dist/core/entities/ConversationSession.js

@@ -6,11 +6,17 @@ const interfaces_1 = require("../../interfaces");
 class ConversationSession {
     constructor(props) {
         this.sessionId = props.sessionId;
+        this.tenantId = props.tenantId;
+        this.configId = props.configId;
         this.mode = props.mode;
         this.agentPrompt = props.agentPrompt;
+        this.conversationMode = props.conversationMode ?? 'collaborative';
         this._messages = [];
         this._status = interfaces_1.SessionStatus.ACTIVE;
         this._metadata = {};
+        this._parameterCollectionState = null;
+        this._currentLanguage = null; // Will be auto-detected on first message
+        this.summary = null;
         this.createdAt = new Date();
         this.updatedAt = new Date();
     }
@@ -20,8 +26,11 @@ class ConversationSession {
         // For simplicity in this demo, we'll instantiate normally and override.
         const session = new ConversationSession({
             sessionId: data.sessionId,
+            tenantId: data.tenantId,
+            configId: data.configId,
             mode: data.mode,
-            agentPrompt: data.agentPrompt
+            agentPrompt: data.agentPrompt,
+            conversationMode: data.conversationMode ?? 'collaborative'
         });
         // Restore state
         // Assuming messages are stored as plain objects, we need to map them back to Message instances
@@ -33,6 +42,9 @@ class ConversationSession {
         }));
         session._status = data.status;
         session._metadata = data.metadata || {};
+        session._parameterCollectionState = data.parameterCollectionState || null;
+        session._currentLanguage = data.currentLanguage || null;
+        session.summary = data.summary || null;
         // @ts-ignore - writing to readonly for hydration
         session.createdAt = new Date(data.createdAt);
         session.updatedAt = new Date(data.updatedAt);
@@ -42,11 +54,17 @@ class ConversationSession {
     toSnapshot() {
         return {
             sessionId: this.sessionId,
+            tenantId: this.tenantId,
+            configId: this.configId,
             mode: this.mode,
             agentPrompt: this.agentPrompt,
+            conversationMode: this.conversationMode,
             messages: this._messages,
             status: this._status,
             metadata: this._metadata,
+            parameterCollectionState: this._parameterCollectionState,
+            currentLanguage: this._currentLanguage,
+            summary: this.summary,
             createdAt: this.createdAt,
             updatedAt: this.updatedAt
         };
@@ -78,6 +96,65 @@ class ConversationSession {
     getHistory() {
         return this._messages;
     }
+    // --- Parameter Collection Methods ---
+    /**
+     * Start collecting parameters for a detected intent
+     */
+    startParameterCollection(state) {
+        this._parameterCollectionState = state;
+        this.updatedAt = new Date();
+    }
+    /**
+     * Update parameter collection state with newly extracted parameters
+     */
+    updateParameterCollection(newParameters, stillMissing) {
+        if (!this._parameterCollectionState)
+            return;
+        this._parameterCollectionState.detectedParameters = {
+            ...this._parameterCollectionState.detectedParameters,
+            ...newParameters
+        };
+        this._parameterCollectionState.missingParameters = stillMissing;
+        this._parameterCollectionState.attemptCount++;
+        this.updatedAt = new Date();
+    }
+    /**
+     * Clear parameter collection state
+     */
+    clearParameterCollection() {
+        this._parameterCollectionState = null;
+        this.updatedAt = new Date();
+    }
+    /**
+     * Get current parameter collection state
+     */
+    getParameterCollectionState() {
+        return this._parameterCollectionState;
+    }
+    /**
+     * Check if currently collecting parameters
+     */
+    isCollectingParameters() {
+        return this._parameterCollectionState !== null;
+    }
+    // --- Language Management Methods ---
+    /**
+     * Get current conversation language
+     */
+    get currentLanguage() {
+        return this._currentLanguage;
+    }
+    /**
+     * Set conversation language
+     * @param languageCode ISO 639-1 language code (e.g., 'en', 'ar', 'fa')
+     */
+    setLanguage(languageCode) {
+        if (this._currentLanguage !== languageCode) {
+            console.log(`[ConversationSession] Language switched from '${this._currentLanguage || 'unknown'}' to '${languageCode}'`);
+        }
+        this._currentLanguage = languageCode;
+        this.updatedAt = new Date();
+    }
 }
 exports.ConversationSession = ConversationSession;
 //# sourceMappingURL=ConversationSession.js.map

package/dist/core/entities/ConversationSession.js.map

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

package/dist/core/entities/Message.d.ts

@@ -1,10 +1,13 @@
 import { Role, Message as IMessage, MessageProps } from '../../interfaces';
 export declare class Message implements IMessage {
+    readonly id: string;
     readonly role: Role;
     readonly content: string;
     readonly timestamp: Date;
-    readonly metadata: Record<string, any>;
-    constructor(props: MessageProps);
+    metadata: Record<string, any>;
+    constructor(props: MessageProps & {
+        id?: string;
+    });
     static user(content: string, metadata?: Record<string, any>): Message;
     static assistant(content: string, metadata?: Record<string, any>): Message;
 }

package/dist/core/entities/Message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../../src/core/entities/Message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI3E,qBAAa,OAAQ,YAAW,QAAQ;IACpC,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,SAAS,EAAE,IAAI,CAAC;IAChC,SAAgB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAElC,KAAK,EAAE,YAAY;IAO/B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO;IASrE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO;CAQ7E"}
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../../src/core/entities/Message.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE3E,qBAAa,OAAQ,YAAW,QAAQ;IACpC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAEzB,KAAK,EAAE,YAAY,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE;IAQjD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO;IASrE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO;CAQ7E"}

package/dist/core/entities/Message.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Message = void 0;
+const uuid_1 = require("uuid");
 const interfaces_1 = require("../../interfaces");
 class Message {
     constructor(props) {
+        this.id = props.id || (0, uuid_1.v4)();
         this.role = props.role;
         this.content = props.content;
         this.timestamp = props.timestamp;

package/dist/core/entities/Message.js.map

@@ -1 +1 @@
-{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../../src/core/entities/Message.ts"],"names":[],"mappings":";;;AAAA,iDAA2E;AAI3E,MAAa,OAAO;IAMhB,YAAY,KAAmB;QAC3B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,QAA8B;QACvD,OAAO,IAAI,OAAO,CAAC;YACf,IAAI,EAAE,iBAAI,CAAC,IAAI;YACf,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,OAAe,EAAE,QAA8B;QAC5D,OAAO,IAAI,OAAO,CAAC;YACf,IAAI,EAAE,iBAAI,CAAC,SAAS;YACpB,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;CACJ;AA9BD,0BA8BC"}
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../../src/core/entities/Message.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AACpC,iDAA2E;AAE3E,MAAa,OAAO;IAOhB,YAAY,KAAqC;QAC7C,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAA,SAAM,GAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,QAA8B;QACvD,OAAO,IAAI,OAAO,CAAC;YACf,IAAI,EAAE,iBAAI,CAAC,IAAI;YACf,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,OAAe,EAAE,QAA8B;QAC5D,OAAO,IAAI,OAAO,CAAC;YACf,IAAI,EAAE,iBAAI,CAAC,SAAS;YACpB,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;CACJ;AAhCD,0BAgCC"}

package/dist/core/utils/AudioStreamBuffer.d.ts

@@ -0,0 +1,33 @@
+import { Buffer } from 'buffer';
+/**
+ * Audio Stream Buffer
+ *
+ * Efficiently accumulates binary audio chunks from a WebSocket stream.
+ * Provides methods to append data and flush the buffer for processing (STT).
+ */
+export declare class AudioStreamBuffer {
+    private chunks;
+    private totalLength;
+    /**
+     * Append a binary chunk to the stream
+     */
+    append(chunk: Buffer): void;
+    /**
+     * Get current size of buffer in bytes
+     */
+    get size(): number;
+    /**
+     * Clear buffer
+     */
+    clear(): void;
+    /**
+     * Flush the buffer and return the concatenated audio data.
+     * Optionally clears the buffer after flushing.
+     */
+    flush(clear?: boolean): Buffer;
+    /**
+     * Output Base64 string (for legacy STT APIs that expect Base64)
+     */
+    toBase64(clear?: boolean): string;
+}
+//# sourceMappingURL=AudioStreamBuffer.d.ts.map

package/dist/core/utils/AudioStreamBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioStreamBuffer.d.ts","sourceRoot":"","sources":["../../../src/core/utils/AudioStreamBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAa;IAEhC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,KAAK,CAAC,KAAK,GAAE,OAAc,GAAG,MAAM;IAUpC;;OAEG;IACH,QAAQ,CAAC,KAAK,GAAE,OAAc,GAAG,MAAM;CAG1C"}

package/dist/core/utils/AudioStreamBuffer.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudioStreamBuffer = void 0;
+const buffer_1 = require("buffer");
+/**
+ * Audio Stream Buffer
+ *
+ * Efficiently accumulates binary audio chunks from a WebSocket stream.
+ * Provides methods to append data and flush the buffer for processing (STT).
+ */
+class AudioStreamBuffer {
+    constructor() {
+        this.chunks = [];
+        this.totalLength = 0;
+    }
+    /**
+     * Append a binary chunk to the stream
+     */
+    append(chunk) {
+        this.chunks.push(chunk);
+        this.totalLength += chunk.length;
+    }
+    /**
+     * Get current size of buffer in bytes
+     */
+    get size() {
+        return this.totalLength;
+    }
+    /**
+     * Clear buffer
+     */
+    clear() {
+        this.chunks = [];
+        this.totalLength = 0;
+    }
+    /**
+     * Flush the buffer and return the concatenated audio data.
+     * Optionally clears the buffer after flushing.
+     */
+    flush(clear = true) {
+        const result = buffer_1.Buffer.concat(this.chunks, this.totalLength);
+        if (clear) {
+            this.clear();
+        }
+        return result;
+    }
+    /**
+     * Output Base64 string (for legacy STT APIs that expect Base64)
+     */
+    toBase64(clear = true) {
+        return this.flush(clear).toString('base64');
+    }
+}
+exports.AudioStreamBuffer = AudioStreamBuffer;
+//# sourceMappingURL=AudioStreamBuffer.js.map

package/dist/core/utils/AudioStreamBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioStreamBuffer.js","sourceRoot":"","sources":["../../../src/core/utils/AudioStreamBuffer.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAEhC;;;;;GAKG;AACH,MAAa,iBAAiB;IAA9B;QACY,WAAM,GAAa,EAAE,CAAC;QACtB,gBAAW,GAAW,CAAC,CAAC;IA6CpC,CAAC;IA3CG;;OAEG;IACH,MAAM,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAiB,IAAI;QACvB,MAAM,MAAM,GAAG,eAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAE5D,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAiB,IAAI;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;CACJ;AA/CD,8CA+CC"}

package/dist/core/utils/AudioUtils.d.ts

@@ -0,0 +1,41 @@
+import { AudioFormatMetadata } from '../../interfaces';
+/**
+ * Audio Conversion Utilities
+ *
+ * Provides utilities for converting between different audio formats
+ * All conversions target LINEAR16 PCM at 16kHz mono for consistency
+ */
+export declare const TARGET_SAMPLE_RATE = 16000;
+export declare const TARGET_CHANNELS = 1;
+export declare const TARGET_BIT_DEPTH = 16;
+/**
+ * Convert incoming audio to target PCM format (16kHz, mono, 16-bit)
+ */
+export declare function convertToTargetFormat(audioData: Buffer, formatMetadata?: AudioFormatMetadata): Promise<Buffer>;
+/**
+ * Extract PCM from WAV file and resample if needed
+ */
+export declare function extractAndResampleWAV(wavData: Buffer, metadata: AudioFormatMetadata): Buffer;
+/**
+ * Convert MP3 to PCM
+ * For now, we'll use a simple approach - MP3 decoding without external deps
+ * In production, consider using a library like 'lamejs' or 'mp3-parser'
+ */
+export declare function convertMP3ToPCM(mp3Data: Buffer, metadata: AudioFormatMetadata): Buffer;
+/**
+ * Resample PCM audio to target sample rate
+ */
+export declare function resamplePCM(pcmData: Buffer, metadata: AudioFormatMetadata): Buffer;
+/**
+ * Read a sample from PCM data
+ */
+export declare function readSample(buffer: Buffer, sampleIndex: number, channels: number, bitDepth: number): number;
+/**
+ * Write a sample to PCM data
+ */
+export declare function writeSample(buffer: Buffer, sampleIndex: number, value: number, bitDepth: number): void;
+/**
+ * Create WAV file from raw PCM data
+ */
+export declare function wrapPCMInWAV(pcmData: Buffer): Buffer;
+//# sourceMappingURL=AudioUtils.d.ts.map

package/dist/core/utils/AudioUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioUtils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/AudioUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;GAKG;AAGH,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBpH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CA6B5F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAQtF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CA4ClF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqB1G;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQtG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiCpD"}

package/dist/core/utils/AudioUtils.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TARGET_BIT_DEPTH = exports.TARGET_CHANNELS = exports.TARGET_SAMPLE_RATE = void 0;
+exports.convertToTargetFormat = convertToTargetFormat;
+exports.extractAndResampleWAV = extractAndResampleWAV;
+exports.convertMP3ToPCM = convertMP3ToPCM;
+exports.resamplePCM = resamplePCM;
+exports.readSample = readSample;
+exports.writeSample = writeSample;
+exports.wrapPCMInWAV = wrapPCMInWAV;
+/**
+ * Audio Conversion Utilities
+ *
+ * Provides utilities for converting between different audio formats
+ * All conversions target LINEAR16 PCM at 16kHz mono for consistency
+ */
+// Target audio format for storage
+exports.TARGET_SAMPLE_RATE = 16000;
+exports.TARGET_CHANNELS = 1;
+exports.TARGET_BIT_DEPTH = 16;
+/**
+ * Convert incoming audio to target PCM format (16kHz, mono, 16-bit)
+ */
+async function convertToTargetFormat(audioData, formatMetadata) {
+    if (!formatMetadata) {
+        // Assume WAV format if no metadata provided (backward compatibility)
+        formatMetadata = { format: 'wav', sampleRate: 48000, channels: 1, bitDepth: 16 };
+    }
+    switch (formatMetadata.format) {
+        case 'wav':
+            return extractAndResampleWAV(audioData, formatMetadata);
+        case 'mp3':
+            return convertMP3ToPCM(audioData, formatMetadata);
+        case 'pcm':
+            return resamplePCM(audioData, formatMetadata);
+        default:
+            console.warn(`[AudioUtils] Unsupported format: ${formatMetadata.format}, storing as-is`);
+            return audioData;
+    }
+}
+/**
+ * Extract PCM from WAV file and resample if needed
+ */
+function extractAndResampleWAV(wavData, metadata) {
+    // WAV file structure:
+    // - RIFF header (12 bytes)
+    // - fmt chunk (24 bytes typically)
+    // - data chunk header (8 bytes)
+    // - PCM data
+    // Find 'data' chunk
+    const dataMarker = Buffer.from('data');
+    let dataStart = -1;
+    for (let i = 0; i < wavData.length - 4; i++) {
+        if (wavData.slice(i, i + 4).equals(dataMarker)) {
+            // Found 'data' marker, PCM starts 8 bytes after (4 for 'data', 4 for size)
+            dataStart = i + 8;
+            break;
+        }
+    }
+    if (dataStart === -1) {
+        console.warn('[AudioUtils] Could not find data chunk in WAV, using entire buffer');
+        dataStart = 44; // Standard WAV header size
+    }
+    // Extract raw PCM data
+    const pcmData = wavData.slice(dataStart);
+    // Resample if needed
+    return resamplePCM(pcmData, metadata);
+}
+/**
+ * Convert MP3 to PCM
+ * For now, we'll use a simple approach - MP3 decoding without external deps
+ * In production, consider using a library like 'lamejs' or 'mp3-parser'
+ */
+function convertMP3ToPCM(mp3Data, metadata) {
+    // MP3 decoding is complex. For now, we'll log a warning and pass through
+    // The user should ideally change the provider output to WAV format
+    console.warn('[AudioUtils] MP3 decoding not yet implemented. Audio may not concatenate properly.');
+    console.warn('[AudioUtils] Consider changing provider output format to WAV.');
+    // Return as-is for now - this will need proper MP3 decoder
+    return mp3Data;
+}
+/**
+ * Resample PCM audio to target sample rate
+ */
+function resamplePCM(pcmData, metadata) {
+    const sourceSampleRate = metadata.sampleRate || exports.TARGET_SAMPLE_RATE;
+    const sourceChannels = metadata.channels || exports.TARGET_CHANNELS;
+    const sourceBitDepth = metadata.bitDepth || exports.TARGET_BIT_DEPTH;
+    // If already in target format, return as-is
+    if (sourceSampleRate === exports.TARGET_SAMPLE_RATE &&
+        sourceChannels === exports.TARGET_CHANNELS &&
+        sourceBitDepth === exports.TARGET_BIT_DEPTH) {
+        return pcmData;
+    }
+    // Calculate bytes per sample
+    const sourceBytesPerSample = (sourceBitDepth / 8) * sourceChannels;
+    const targetBytesPerSample = (exports.TARGET_BIT_DEPTH / 8) * exports.TARGET_CHANNELS;
+    // Calculate number of samples
+    const sourceSampleCount = Math.floor(pcmData.length / sourceBytesPerSample);
+    const targetSampleCount = Math.floor((sourceSampleCount * exports.TARGET_SAMPLE_RATE) / sourceSampleRate);
+    // Create output buffer
+    const output = Buffer.alloc(targetSampleCount * targetBytesPerSample);
+    // Simple linear interpolation resampling
+    for (let i = 0; i < targetSampleCount; i++) {
+        const sourceIndex = (i * sourceSampleRate) / exports.TARGET_SAMPLE_RATE;
+        const sourceIndexFloor = Math.floor(sourceIndex);
+        const sourceIndexCeil = Math.ceil(sourceIndex);
+        const fraction = sourceIndex - sourceIndexFloor;
+        // Get samples (handle stereo to mono conversion if needed)
+        let sample1 = readSample(pcmData, sourceIndexFloor, sourceChannels, sourceBitDepth);
+        let sample2 = readSample(pcmData, sourceIndexCeil < sourceSampleCount ? sourceIndexCeil : sourceIndexFloor, sourceChannels, sourceBitDepth);
+        // Interpolate
+        const interpolated = Math.round(sample1 * (1 - fraction) + sample2 * fraction);
+        // Write sample
+        writeSample(output, i, interpolated, exports.TARGET_BIT_DEPTH);
+    }
+    return output;
+}
+/**
+ * Read a sample from PCM data
+ */
+function readSample(buffer, sampleIndex, channels, bitDepth) {
+    const bytesPerSample = (bitDepth / 8) * channels;
+    const offset = sampleIndex * bytesPerSample;
+    if (offset >= buffer.length) {
+        return 0;
+    }
+    // Read first channel (mono or left channel for stereo)
+    if (bitDepth === 16) {
+        return buffer.readInt16LE(offset);
+    }
+    else if (bitDepth === 8) {
+        return buffer.readInt8(offset) * 256; // Scale to 16-bit range
+    }
+    else if (bitDepth === 24) {
+        const byte1 = buffer.readUInt8(offset);
+        const byte2 = buffer.readUInt8(offset + 1);
+        const byte3 = buffer.readInt8(offset + 2);
+        return ((byte3 << 16) | (byte2 << 8) | byte1) >> 8; // Scale down to 16-bit
+    }
+    else {
+        return buffer.readInt16LE(offset);
+    }
+}
+/**
+ * Write a sample to PCM data
+ */
+function writeSample(buffer, sampleIndex, value, bitDepth) {
+    const offset = sampleIndex * (bitDepth / 8);
+    if (bitDepth === 16) {
+        // Clamp to 16-bit range
+        const clamped = Math.max(-32768, Math.min(32767, value));
+        buffer.writeInt16LE(clamped, offset);
+    }
+}
+/**
+ * Create WAV file from raw PCM data
+ */
+function wrapPCMInWAV(pcmData) {
+    const sampleRate = exports.TARGET_SAMPLE_RATE;
+    const channels = exports.TARGET_CHANNELS;
+    const bitDepth = exports.TARGET_BIT_DEPTH;
+    const byteRate = sampleRate * channels * (bitDepth / 8);
+    const blockAlign = channels * (bitDepth / 8);
+    const dataSize = pcmData.length;
+    const fileSize = 36 + dataSize;
+    // Create WAV header
+    const header = Buffer.alloc(44);
+    // RIFF chunk descriptor
+    header.write('RIFF', 0);
+    header.writeUInt32LE(fileSize, 4);
+    header.write('WAVE', 8);
+    // fmt sub-chunk
+    header.write('fmt ', 12);
+    header.writeUInt32LE(16, 16); // Subchunk1Size (16 for PCM)
+    header.writeUInt16LE(1, 20); // AudioFormat (1 for PCM)
+    header.writeUInt16LE(channels, 22);
+    header.writeUInt32LE(sampleRate, 24);
+    header.writeUInt32LE(byteRate, 28);
+    header.writeUInt16LE(blockAlign, 32);
+    header.writeUInt16LE(bitDepth, 34);
+    // data sub-chunk
+    header.write('data', 36);
+    header.writeUInt32LE(dataSize, 40);
+    // Concatenate header and PCM data
+    return Buffer.concat([header, pcmData]);
+}
+//# sourceMappingURL=AudioUtils.js.map

package/dist/core/utils/AudioUtils.js.map

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

package/dist/core/utils/LanguageDetector.d.ts

@@ -0,0 +1,52 @@
+import { ILLMAdapter } from '../../interfaces';
+/**
+ * Language Detection Utility
+ *
+ * Detects the language of user messages using LLM analysis.
+ * Returns ISO 639-1 language codes (e.g., 'en', 'ar', 'fa', 'es').
+ */
+export declare class LanguageDetector {
+    private llm;
+    private cache;
+    constructor(llm: ILLMAdapter);
+    /**
+     * Detect language from text
+     * @param text Text to analyze
+     * @param languageHints Optional array of preferred languages (e.g., from supportedLanguages config)
+     * @returns ISO 639-1 language code (e.g., 'en', 'ar', 'fa')
+     */
+    detectLanguage(text: string, languageHints?: string[]): Promise<string>;
+    /**
+     * Detect if text uses a specific character set (fast heuristic)
+     * This avoids expensive LLM calls when character set hasn't changed
+     * @param text Text to analyze
+     * @returns Character set type
+     */
+    detectCharacterSet(text: string): 'arabic' | 'persian' | 'cjk' | 'cyrillic' | 'latin';
+    /**
+     * Check if character set changed from previous language
+     * @param text Current text
+     * @param previousLanguage Previously detected language code
+     * @returns True if character set changed, suggesting language might have changed
+     */
+    hasCharacterSetChanged(text: string, previousLanguage: string | null): boolean;
+    /**
+     * Get expected character set for a language code
+     */
+    private getCharacterSetForLanguage;
+    /**
+     * Get language name from code
+     * @param code ISO 639-1 language code
+     * @returns Human-readable language name
+     */
+    getLanguageName(code: string): string;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+    /**
+     * Generate cache key from text
+     */
+    private getCacheKey;
+}
+//# sourceMappingURL=LanguageDetector.d.ts.map

package/dist/core/utils/LanguageDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanguageDetector.d.ts","sourceRoot":"","sources":["../../../src/core/utils/LanguageDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,gBAAgB;IAGb,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,KAAK,CAAkC;gBAE3B,GAAG,EAAE,WAAW;IAEpC;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA2D7E;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO;IAwBrF;;;;;OAKG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAS9E;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAclC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA2BrC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;CAItB"}