chat-flow-ardymalihi 1.0.2 → 3.0.0

package/dist/interfaces.js

@@ -1,7 +1,7 @@
 "use strict";
 // --- Enums & Common Types ---
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionStatus = exports.Role = void 0;
+exports.ConversationWebhookEvent = exports.SessionStatus = exports.Role = void 0;
 var Role;
 (function (Role) {
     Role["USER"] = "user";
@@ -15,4 +15,22 @@ var SessionStatus;
     SessionStatus["COMPLETED"] = "COMPLETED";
     SessionStatus["FAILED"] = "FAILED";
 })(SessionStatus || (exports.SessionStatus = SessionStatus = {}));
+// --- Webhook Events ---
+var ConversationWebhookEvent;
+(function (ConversationWebhookEvent) {
+    // Session Lifecycle
+    ConversationWebhookEvent["SESSION_STARTED"] = "conversation.session.started";
+    ConversationWebhookEvent["SESSION_ENDED"] = "conversation.session.ended";
+    // Message Events (both text and audio)
+    // Message Events (both text and audio)
+    ConversationWebhookEvent["MESSAGE_USER"] = "conversation.message.user";
+    ConversationWebhookEvent["MESSAGE_BOT"] = "conversation.message.bot";
+    // Intent & Workflow Events
+    ConversationWebhookEvent["INTENT_DETECTED"] = "conversation.intent.detected";
+    ConversationWebhookEvent["INTENT_FAILED"] = "conversation.intent.failed";
+    ConversationWebhookEvent["WORKFLOW_EXECUTED"] = "conversation.workflow.executed";
+    ConversationWebhookEvent["WORKFLOW_FAILED"] = "conversation.workflow.failed";
+    // Error Events
+    ConversationWebhookEvent["ERROR_OCCURRED"] = "conversation.error.occurred";
+})(ConversationWebhookEvent || (exports.ConversationWebhookEvent = ConversationWebhookEvent = {}));
 //# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";AAAA,+BAA+B;;;AAE/B,IAAY,IAIX;AAJD,WAAY,IAAI;IACZ,qBAAa,CAAA;IACb,+BAAuB,CAAA;IACvB,yBAAiB,CAAA;AACrB,CAAC,EAJW,IAAI,oBAAJ,IAAI,QAIf;AAED,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,kCAAiB,CAAA;IACjB,8DAA6C,CAAA;IAC7C,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;AACrB,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";AAAA,+BAA+B;;;AAE/B,IAAY,IAIX;AAJD,WAAY,IAAI;IACZ,qBAAa,CAAA;IACb,+BAAuB,CAAA;IACvB,yBAAiB,CAAA;AACrB,CAAC,EAJW,IAAI,oBAAJ,IAAI,QAIf;AAED,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,kCAAiB,CAAA;IACjB,8DAA6C,CAAA;IAC7C,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;AACrB,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AAqND,yBAAyB;AAEzB,IAAY,wBAkBX;AAlBD,WAAY,wBAAwB;IAChC,oBAAoB;IACpB,4EAAgD,CAAA;IAChD,wEAA4C,CAAA;IAE5C,uCAAuC;IACvC,uCAAuC;IACvC,sEAA0C,CAAA;IAC1C,oEAAwC,CAAA;IAExC,2BAA2B;IAC3B,4EAAgD,CAAA;IAChD,wEAA4C,CAAA;IAC5C,gFAAoD,CAAA;IACpD,4EAAgD,CAAA;IAEhD,eAAe;IACf,0EAA8C,CAAA;AAClD,CAAC,EAlBW,wBAAwB,wCAAxB,wBAAwB,QAkBnC"}

package/dist/orchestrator/Orchestrator.d.ts

@@ -1,18 +1,62 @@
 import { ConversationSession } from '../core/entities/ConversationSession';
 import { Message } from '../core/entities/Message';
-import { IRepository, ILLMAdapter, IIntentService, IWorkflowAdapter, IOrchestrator } from '../interfaces';
+import { IRepository, ILLMAdapter, IIntentService, IWorkflowAdapter, IOrchestrator, IVoiceAdapter, IWebhookService, IAudioStorage } from '../interfaces';
 import { ChatFlowConfig } from '../config';
 export declare class Orchestrator implements IOrchestrator {
     private repo;
     private llm;
     private intent;
     private workflow;
+    private webhookService;
+    private voiceAdapter?;
+    private audioStorage?;
     private readonly config;
-    constructor(repo: IRepository, llm: ILLMAdapter, intent: IIntentService, workflow: IWorkflowAdapter, config?: Partial<ChatFlowConfig>);
-    createSession(sessionId: string, mode: 'TEXT' | 'VOICE', agentPrompt: string): Promise<ConversationSession>;
-    handleMessage(sessionId: string, content: string): Promise<{
+    private languageDetector;
+    constructor(repo: IRepository, llm: ILLMAdapter, intent: IIntentService, workflow: IWorkflowAdapter, webhookService: IWebhookService, voiceAdapter?: IVoiceAdapter | undefined, audioStorage?: IAudioStorage | undefined, config?: Partial<ChatFlowConfig>);
+    createSession(sessionId: string, mode: 'TEXT' | 'VOICE', agentPrompt: string, tenantId?: string, configId?: string): Promise<ConversationSession>;
+    processMessage(sessionId: string, content: string, onIntermediateResponse?: (text: string) => Promise<void>): Promise<{
         messages: Message[];
         metadata?: any;
     }>;
+    /**
+     * Start parameter collection for a detected intent with missing parameters
+     */
+    private startParameterCollection;
+    /**
+     * Handle parameter collection from user response
+     */
+    private handleParameterCollection;
+    /**
+     * Generate a clarification question for missing parameters
+     */
+    private generateClarificationQuestion;
+    /**
+     * Extract parameters from user response
+     */
+    private extractParametersFromResponse;
+    /**
+     * Handle incoming voice message (audio input)
+     * Converts speech to text, processes the message, and optionally returns audio response
+     * @param sessionId Session identifier
+     * @param audioBase64 Base64-encoded audio data (WAV format recommended)
+     * @returns Transcript, messages, and optional audio response
+     */
+    /**
+     * Get voice response for any text
+     * Useful for converting assistant messages to speech
+     * @param text Text to convert to speech
+     * @returns Audio data as Uint8Array
+     */
+    getVoiceResponse(text: string): Promise<Uint8Array>;
+    /**
+     * Transcribe audio and record it to storage
+     */
+    transcribeAudio(sessionId: string, audioBase64: string): Promise<string>;
+    /**
+     * Synthesize audio and record it to storage
+     */
+    synthesizeResponse(sessionId: string, text: string): Promise<Uint8Array>;
+    completeSession(sessionId: string, recordingUrl?: string): Promise<ConversationSession>;
+    getSessionAudio(sessionId: string): Promise<Buffer | null>;
 }
 //# sourceMappingURL=Orchestrator.d.ts.map

package/dist/orchestrator/Orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/Orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EACH,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EAEhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,cAAc,EAAkB,MAAM,WAAW,CAAC;AAE3D,qBAAa,YAAa,YAAW,aAAa;IAI1C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IANpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAG5B,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,EAClC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAK9B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAW3G,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;CA6D5G"}
+{"version":3,"file":"Orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/Orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,EACH,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EAKhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,cAAc,EAAkB,MAAM,WAAW,CAAC;AAE3D,qBAAa,YAAa,YAAW,aAAa;IAK1C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,YAAY,CAAC;IAVzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,gBAAgB,CAAmB;gBAG/B,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,eAAe,EAC/B,YAAY,CAAC,EAAE,aAAa,YAAA,EAC5B,YAAY,CAAC,EAAE,aAAa,YAAA,EACpC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAM9B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8DjJ,cAAc,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzD,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAiVnD;;OAEG;YACW,wBAAwB;IAsCtC;;OAEG;YACW,yBAAyB;IAuIvC;;OAEG;YACW,6BAA6B;IAsC3C;;OAEG;YACW,6BAA6B;IA0C3C;;;;;;OAMG;IAGH;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IASzD;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe9E;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBxE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsEvF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAOnE"}