@chanl-ai/sdk 2.0.1

package/dist/live/index.d.ts

@@ -0,0 +1,9 @@
+export { TypedEventEmitter } from './typed-emitter';
+export type { LiveOptions } from './types';
+export { LiveCall } from './live-call';
+export type { LiveCallEvents } from './live-call';
+export { LiveExecution } from './live-execution';
+export type { LiveExecutionEvents, ExecutionStepEvent } from './live-execution';
+export { LiveChat } from './live-chat';
+export type { LiveChatEvents, LiveChatSendOptions } from './live-chat';
+//# sourceMappingURL=index.d.ts.map

package/dist/live/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGhF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/live/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveChat = exports.LiveExecution = exports.LiveCall = exports.TypedEventEmitter = void 0;
+// Base
+var typed_emitter_1 = require("./typed-emitter");
+Object.defineProperty(exports, "TypedEventEmitter", { enumerable: true, get: function () { return typed_emitter_1.TypedEventEmitter; } });
+// LiveCall
+var live_call_1 = require("./live-call");
+Object.defineProperty(exports, "LiveCall", { enumerable: true, get: function () { return live_call_1.LiveCall; } });
+// LiveExecution
+var live_execution_1 = require("./live-execution");
+Object.defineProperty(exports, "LiveExecution", { enumerable: true, get: function () { return live_execution_1.LiveExecution; } });
+// LiveChat
+var live_chat_1 = require("./live-chat");
+Object.defineProperty(exports, "LiveChat", { enumerable: true, get: function () { return live_chat_1.LiveChat; } });
+//# sourceMappingURL=index.js.map

package/dist/live/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":";;;AAAA,OAAO;AACP,iDAAoD;AAA3C,kHAAA,iBAAiB,OAAA;AAK1B,WAAW;AACX,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAGjB,gBAAgB;AAChB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAGtB,WAAW;AACX,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA"}

package/dist/live/live-call.d.ts

@@ -0,0 +1,48 @@
+import { TypedEventEmitter } from './typed-emitter';
+import type { TranscriptSegment, LiveOptions } from './types';
+import type { ChanlSDK } from '../client';
+import type { Call, CallScorecardResult } from '../modules/calls';
+export type LiveCallEvents = {
+    'status': (status: string, call: Call) => void;
+    'transcript': (segment: TranscriptSegment) => void;
+    'ended': (summary: {
+        status: string;
+        duration: number;
+    }) => void;
+    'scorecard': (results: CallScorecardResult[]) => void;
+    'error': (error: Error) => void;
+    'timeout': () => void;
+};
+/**
+ * Live voice call monitor.
+ *
+ * Polls call status and transcript, emitting typed events as data arrives.
+ * Automatically fetches scorecard results when the call reaches a terminal state.
+ *
+ * @example
+ * ```typescript
+ * const live = await sdk.calls.start(wsId, { agentId, phone });
+ * live.on('status', (s) => console.log('Status:', s));
+ * live.on('transcript', (seg) => console.log(`${seg.speaker}: ${seg.text}`));
+ * live.on('ended', (sum) => console.log(`Done: ${sum.status}`));
+ * live.on('scorecard', (r) => console.log('Score:', r[0]?.overallScore));
+ * await live.completed;
+ * ```
+ */
+export declare class LiveCall extends TypedEventEmitter<LiveCallEvents> {
+    private sdk;
+    readonly callId: string;
+    /** Resolves when monitoring ends (terminal status, timeout, or stop). */
+    readonly completed: Promise<void>;
+    private _resolveCompleted;
+    private abortController;
+    private pollInterval;
+    private maxPolls;
+    constructor(sdk: ChanlSDK, callId: string, options?: LiveOptions);
+    /** Stop monitoring. The call itself continues in the background. */
+    stop(): void;
+    private poll;
+    private fetchScorecard;
+    private sleep;
+}
+//# sourceMappingURL=live-call.d.ts.map

package/dist/live/live-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-call.d.ts","sourceRoot":"","sources":["../../src/live/live-call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnD,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,OAAO,EAAO,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtE,WAAW,EAAG,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IACvD,OAAO,EAAO,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACrC,SAAS,EAAK,MAAM,IAAI,CAAC;CAC1B,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,SAAQ,iBAAiB,CAAC,cAAc,CAAC;IAW3D,OAAO,CAAC,GAAG;IAVb,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;gBAGf,GAAG,EAAE,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW;IAkBvB,oEAAoE;IACpE,IAAI,IAAI,IAAI;YAQE,IAAI;YAsEJ,cAAc;IAqB5B,OAAO,CAAC,KAAK;CAad"}

package/dist/live/live-call.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveCall = void 0;
+const typed_emitter_1 = require("./typed-emitter");
+const TERMINAL_CALL_STATUSES = new Set([
+    'ended', 'completed', 'failed', 'no-answer', 'busy', 'cancelled',
+]);
+/**
+ * Live voice call monitor.
+ *
+ * Polls call status and transcript, emitting typed events as data arrives.
+ * Automatically fetches scorecard results when the call reaches a terminal state.
+ *
+ * @example
+ * ```typescript
+ * const live = await sdk.calls.start(wsId, { agentId, phone });
+ * live.on('status', (s) => console.log('Status:', s));
+ * live.on('transcript', (seg) => console.log(`${seg.speaker}: ${seg.text}`));
+ * live.on('ended', (sum) => console.log(`Done: ${sum.status}`));
+ * live.on('scorecard', (r) => console.log('Score:', r[0]?.overallScore));
+ * await live.completed;
+ * ```
+ */
+class LiveCall extends typed_emitter_1.TypedEventEmitter {
+    constructor(sdk, callId, options) {
+        super();
+        this.sdk = sdk;
+        this.abortController = new AbortController();
+        this.callId = callId;
+        this.pollInterval = options?.pollInterval ?? 2000;
+        this.maxPolls = options?.maxPolls ?? 150;
+        this.completed = new Promise((resolve) => {
+            this._resolveCompleted = resolve;
+        });
+        if (options?.signal) {
+            options.signal.addEventListener('abort', () => this.abortController.abort(), { once: true });
+        }
+        void this.poll();
+    }
+    /** Stop monitoring. The call itself continues in the background. */
+    stop() {
+        this.abortController.abort();
+    }
+    // ---------------------------------------------------------------------------
+    // Internal polling
+    // ---------------------------------------------------------------------------
+    async poll() {
+        let seenSegmentCount = 0;
+        const startTime = Date.now();
+        try {
+            for (let i = 0; i < this.maxPolls; i++) {
+                if (this.abortController.signal.aborted)
+                    return;
+                // --- Call status ---
+                try {
+                    const callResponse = await this.sdk.calls.get(this.callId);
+                    if (callResponse.success && callResponse.data) {
+                        // Defensive: SDK may or may not have single-key-unwrapped the response
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const raw = callResponse.data;
+                        const call = raw.call || raw;
+                        const status = call.status || 'unknown';
+                        this.emit('status', status, call);
+                        if (TERMINAL_CALL_STATUSES.has(status)) {
+                            const duration = Math.floor((Date.now() - startTime) / 1000);
+                            this.emit('ended', { status, duration });
+                            await this.fetchScorecard();
+                            return;
+                        }
+                    }
+                }
+                catch (err) {
+                    this.emit('error', err instanceof Error ? err : new Error(String(err)));
+                }
+                // --- Transcript segments ---
+                try {
+                    const txResponse = await this.sdk.calls.getTranscript(this.callId);
+                    if (txResponse.success && txResponse.data) {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const raw = txResponse.data;
+                        const transcript = raw.transcript || raw;
+                        if (transcript?.segments && transcript.segments.length > seenSegmentCount) {
+                            const newSegs = transcript.segments.slice(seenSegmentCount);
+                            for (const seg of newSegs) {
+                                this.emit('transcript', {
+                                    speaker: seg.speaker,
+                                    text: seg.text,
+                                    start: seg.start,
+                                    end: seg.end,
+                                });
+                            }
+                            seenSegmentCount = transcript.segments.length;
+                        }
+                    }
+                }
+                catch {
+                    // Transcript not available yet — normal during early call stages
+                }
+                await this.sleep(this.pollInterval);
+            }
+            // Max polls exhausted
+            this.emit('timeout');
+        }
+        catch (err) {
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            this._resolveCompleted();
+        }
+    }
+    async fetchScorecard() {
+        for (let i = 0; i < 10; i++) {
+            if (this.abortController.signal.aborted)
+                return;
+            try {
+                const response = await this.sdk.calls.getScorecard(this.callId);
+                if (response.success && response.data) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const raw = response.data;
+                    const results = Array.isArray(raw) ? raw : raw.results || [];
+                    if (results.length > 0) {
+                        this.emit('scorecard', results);
+                        return;
+                    }
+                }
+            }
+            catch {
+                // Scorecard may not be ready yet
+            }
+            await this.sleep(2000);
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => {
+            const onAbort = () => {
+                clearTimeout(timeout);
+                resolve();
+            };
+            const timeout = setTimeout(() => {
+                this.abortController.signal.removeEventListener('abort', onAbort);
+                resolve();
+            }, ms);
+            this.abortController.signal.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+}
+exports.LiveCall = LiveCall;
+//# sourceMappingURL=live-call.js.map

package/dist/live/live-call.js.map

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

package/dist/live/live-chat.d.ts

@@ -0,0 +1,71 @@
+import { TypedEventEmitter } from './typed-emitter';
+import type { ChanlSDK } from '../client';
+import type { ChatSessionResponse, ChatMessageResponse } from '../modules/chat';
+export type LiveChatEvents = {
+    'message': (message: ChatMessageResponse) => void;
+    'delta': (text: string) => void;
+    'ended': () => void;
+    'error': (error: Error) => void;
+};
+export interface LiveChatSendOptions {
+    /** Enable streaming — text arrives via `delta` events / `onChunk` callback */
+    stream?: boolean;
+    /** Per-message callback for streaming text chunks */
+    onChunk?: (delta: string) => void;
+}
+/**
+ * Live chat session wrapper.
+ *
+ * Wraps an active chat session, emitting typed events for messages and
+ * session lifecycle. Unlike LiveCall/LiveExecution, this is not polling-based —
+ * events fire in response to explicit `send()` and `end()` calls.
+ *
+ * @example Non-streaming
+ * ```typescript
+ * const chat = await sdk.chat.session(wsId, agentId);
+ * const reply = await chat.send('Hello!');
+ * console.log(reply.message);
+ * await chat.end();
+ * ```
+ *
+ * @example Streaming with event listener
+ * ```typescript
+ * const chat = await sdk.chat.session(wsId, agentId);
+ * chat.on('delta', (text) => process.stdout.write(text));
+ * const reply = await chat.send('Hello!', { stream: true });
+ * await chat.end();
+ * ```
+ *
+ * @example Streaming with callback
+ * ```typescript
+ * const chat = await sdk.chat.session(wsId, agentId);
+ * const reply = await chat.send('Hello!', {
+ *   stream: true,
+ *   onChunk: (delta) => process.stdout.write(delta),
+ * });
+ * await chat.end();
+ * ```
+ */
+export declare class LiveChat extends TypedEventEmitter<LiveChatEvents> {
+    private sdk;
+    readonly sessionId: string;
+    readonly agentName: string | undefined;
+    constructor(sdk: ChanlSDK, sessionData: ChatSessionResponse);
+    /**
+     * Send a message and receive the agent's response.
+     *
+     * With `{ stream: true }`, text arrives incrementally via the `delta`
+     * event and optional `onChunk` callback. The returned promise resolves
+     * with the complete response after the stream finishes.
+     *
+     * Without streaming (default), waits for the full response including
+     * tool calls and usage metadata.
+     */
+    send(text: string, options?: LiveChatSendOptions): Promise<ChatMessageResponse>;
+    /**
+     * End the chat session. Emits an `ended` event.
+     */
+    end(): Promise<void>;
+    private sendStreaming;
+}
+//# sourceMappingURL=live-chat.d.ts.map

package/dist/live/live-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-chat.d.ts","sourceRoot":"","sources":["../../src/live/live-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD,OAAO,EAAI,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,EAAI,MAAM,IAAI,CAAC;IACtB,OAAO,EAAI,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,QAAS,SAAQ,iBAAiB,CAAC,cAAc,CAAC;IAK3D,OAAO,CAAC,GAAG;IAJb,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAG7B,GAAG,EAAE,QAAQ,EACrB,WAAW,EAAE,mBAAmB;IAOlC;;;;;;;;;OASG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiBrF;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YASZ,aAAa;CAmB5B"}

package/dist/live/live-chat.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveChat = void 0;
+const typed_emitter_1 = require("./typed-emitter");
+/**
+ * Live chat session wrapper.
+ *
+ * Wraps an active chat session, emitting typed events for messages and
+ * session lifecycle. Unlike LiveCall/LiveExecution, this is not polling-based —
+ * events fire in response to explicit `send()` and `end()` calls.
+ *
+ * @example Non-streaming
+ * ```typescript
+ * const chat = await sdk.chat.session(wsId, agentId);
+ * const reply = await chat.send('Hello!');
+ * console.log(reply.message);
+ * await chat.end();
+ * ```
+ *
+ * @example Streaming with event listener
+ * ```typescript
+ * const chat = await sdk.chat.session(wsId, agentId);
+ * chat.on('delta', (text) => process.stdout.write(text));
+ * const reply = await chat.send('Hello!', { stream: true });
+ * await chat.end();
+ * ```
+ *
+ * @example Streaming with callback
+ * ```typescript
+ * const chat = await sdk.chat.session(wsId, agentId);
+ * const reply = await chat.send('Hello!', {
+ *   stream: true,
+ *   onChunk: (delta) => process.stdout.write(delta),
+ * });
+ * await chat.end();
+ * ```
+ */
+class LiveChat extends typed_emitter_1.TypedEventEmitter {
+    constructor(sdk, sessionData) {
+        super();
+        this.sdk = sdk;
+        this.sessionId = sessionData.interactionId || sessionData.sessionId;
+        this.agentName = sessionData.agentName;
+    }
+    /**
+     * Send a message and receive the agent's response.
+     *
+     * With `{ stream: true }`, text arrives incrementally via the `delta`
+     * event and optional `onChunk` callback. The returned promise resolves
+     * with the complete response after the stream finishes.
+     *
+     * Without streaming (default), waits for the full response including
+     * tool calls and usage metadata.
+     */
+    async send(text, options) {
+        if (options?.stream) {
+            return this.sendStreaming(text, options);
+        }
+        const response = await this.sdk.chat.sendMessage(this.sessionId, text);
+        if (!response.success || !response.data) {
+            const error = new Error(response.message || 'Failed to send message');
+            this.emit('error', error);
+            throw error;
+        }
+        this.emit('message', response.data);
+        return response.data;
+    }
+    /**
+     * End the chat session. Emits an `ended` event.
+     */
+    async end() {
+        try {
+            await this.sdk.chat.endSession(this.sessionId);
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        this.emit('ended');
+    }
+    async sendStreaming(text, options) {
+        const response = await this.sdk.chat.streamMessage(this.sessionId, text, (delta) => {
+            this.emit('delta', delta);
+            options.onChunk?.(delta);
+        });
+        if (!response.success || !response.data) {
+            const error = new Error(response.message || 'Failed to send message');
+            this.emit('error', error);
+            throw error;
+        }
+        this.emit('message', response.data);
+        return response.data;
+    }
+}
+exports.LiveChat = LiveChat;
+//# sourceMappingURL=live-chat.js.map

package/dist/live/live-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-chat.js","sourceRoot":"","sources":["../../src/live/live-chat.ts"],"names":[],"mappings":";;;AAAA,mDAAoD;AAkBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAa,QAAS,SAAQ,iCAAiC;IAI7D,YACU,GAAa,EACrB,WAAgC;QAEhC,KAAK,EAAE,CAAC;QAHA,QAAG,GAAH,GAAG,CAAU;QAIrB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,aAAa,IAAI,WAAW,CAAC,SAAS,CAAC;QACpE,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;IACzC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAA6B;QACpD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEvE,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,wBAAwB,CAAC,CAAC;YACtE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG;QACP,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,OAA4B;QACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAChD,IAAI,CAAC,SAAS,EACd,IAAI,EACJ,CAAC,KAAa,EAAE,EAAE;YAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,wBAAwB,CAAC,CAAC;YACtE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAvED,4BAuEC"}

package/dist/live/live-execution.d.ts

@@ -0,0 +1,55 @@
+import { TypedEventEmitter } from './typed-emitter';
+import type { TranscriptSegment, LiveOptions } from './types';
+import type { ChanlSDK } from '../client';
+import type { ScenarioExecution } from '../modules/scenarios';
+import type { CallScorecardResult } from '../modules/calls';
+import type { ToolCall } from '../types/tool-calls';
+export type { ScenarioExecution };
+export interface ExecutionStepEvent {
+    index: number;
+    stepId: string;
+    status: string;
+    response: string | undefined;
+    toolCalls: ToolCall[];
+}
+export type LiveExecutionEvents = {
+    'status': (status: string, execution: ScenarioExecution) => void;
+    'step': (step: ExecutionStepEvent) => void;
+    'transcript': (segment: TranscriptSegment) => void;
+    'completed': (execution: ScenarioExecution) => void;
+    'scorecard': (results: CallScorecardResult[]) => void;
+    'error': (error: Error) => void;
+    'timeout': () => void;
+};
+/**
+ * Live scenario execution monitor.
+ *
+ * Polls execution status and emits typed events. For voice scenarios,
+ * also polls the associated call's transcript and scorecard.
+ *
+ * @example
+ * ```typescript
+ * const live = await sdk.scenarios.runLive(wsId, scenarioId, { agentId });
+ * live.on('step', (s) => console.log(`Step ${s.index}: ${s.status}`));
+ * live.on('transcript', (seg) => console.log(`${seg.speaker}: ${seg.text}`));
+ * live.on('completed', (exec) => console.log('Score:', exec.overallScore));
+ * await live.completed;
+ * ```
+ */
+export declare class LiveExecution extends TypedEventEmitter<LiveExecutionEvents> {
+    private sdk;
+    readonly executionId: string;
+    /** Resolves when monitoring ends (terminal status, timeout, or stop). */
+    readonly completed: Promise<void>;
+    private _resolveCompleted;
+    private abortController;
+    private pollInterval;
+    private maxPolls;
+    constructor(sdk: ChanlSDK, executionId: string, options?: LiveOptions);
+    /** Stop monitoring. The execution itself continues in the background. */
+    stop(): void;
+    private poll;
+    private fetchScorecard;
+    private sleep;
+}
+//# sourceMappingURL=live-execution.d.ts.map

package/dist/live/live-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-execution.d.ts","sourceRoot":"","sources":["../../src/live/live-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACrE,MAAM,EAAQ,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,WAAW,EAAG,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACrD,WAAW,EAAG,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IACvD,OAAO,EAAO,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACrC,SAAS,EAAK,MAAM,IAAI,CAAC;CAC1B,CAAC;AAMF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,SAAQ,iBAAiB,CAAC,mBAAmB,CAAC;IAWrE,OAAO,CAAC,GAAG;IAVb,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;gBAGf,GAAG,EAAE,QAAQ,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,WAAW;IAkBvB,yEAAyE;IACzE,IAAI,IAAI,IAAI;YAQE,IAAI;YAgGJ,cAAc;IAqB5B,OAAO,CAAC,KAAK;CAad"}

package/dist/live/live-execution.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveExecution = void 0;
+const typed_emitter_1 = require("./typed-emitter");
+const TERMINAL_EXECUTION_STATUSES = new Set([
+    'completed', 'failed', 'timeout', 'cancelled',
+]);
+/**
+ * Live scenario execution monitor.
+ *
+ * Polls execution status and emits typed events. For voice scenarios,
+ * also polls the associated call's transcript and scorecard.
+ *
+ * @example
+ * ```typescript
+ * const live = await sdk.scenarios.runLive(wsId, scenarioId, { agentId });
+ * live.on('step', (s) => console.log(`Step ${s.index}: ${s.status}`));
+ * live.on('transcript', (seg) => console.log(`${seg.speaker}: ${seg.text}`));
+ * live.on('completed', (exec) => console.log('Score:', exec.overallScore));
+ * await live.completed;
+ * ```
+ */
+class LiveExecution extends typed_emitter_1.TypedEventEmitter {
+    constructor(sdk, executionId, options) {
+        super();
+        this.sdk = sdk;
+        this.abortController = new AbortController();
+        this.executionId = executionId;
+        this.pollInterval = options?.pollInterval ?? 2000;
+        this.maxPolls = options?.maxPolls ?? 150;
+        this.completed = new Promise((resolve) => {
+            this._resolveCompleted = resolve;
+        });
+        if (options?.signal) {
+            options.signal.addEventListener('abort', () => this.abortController.abort(), { once: true });
+        }
+        void this.poll();
+    }
+    /** Stop monitoring. The execution itself continues in the background. */
+    stop() {
+        this.abortController.abort();
+    }
+    // ---------------------------------------------------------------------------
+    // Internal polling
+    // ---------------------------------------------------------------------------
+    async poll() {
+        let lastStepCount = 0;
+        let seenSegmentCount = 0;
+        let callId;
+        try {
+            for (let i = 0; i < this.maxPolls; i++) {
+                if (this.abortController.signal.aborted)
+                    return;
+                // --- Execution status ---
+                try {
+                    const response = await this.sdk.scenarios.getExecution(this.executionId);
+                    if (!response.success || !response.data)
+                        continue;
+                    const { execution } = response.data;
+                    const status = execution.status;
+                    const stepCount = execution.stepResults?.length ?? 0;
+                    // Discover call ID for voice scenarios
+                    if (!callId && execution.callDetails?.callId) {
+                        callId = execution.callDetails.callId;
+                    }
+                    this.emit('status', status, execution);
+                    // Emit new step results
+                    if (stepCount > lastStepCount && execution.stepResults) {
+                        const newSteps = execution.stepResults.slice(lastStepCount);
+                        for (let idx = 0; idx < newSteps.length; idx++) {
+                            const step = newSteps[idx];
+                            this.emit('step', {
+                                index: lastStepCount + idx,
+                                stepId: step.stepId,
+                                status: step.status,
+                                response: step.actualResponse,
+                                toolCalls: step.toolCalls ?? [],
+                            });
+                        }
+                        lastStepCount = stepCount;
+                    }
+                    // Terminal status
+                    if (TERMINAL_EXECUTION_STATUSES.has(status)) {
+                        this.emit('completed', execution);
+                        // Voice scenarios: fetch scorecard from the associated call
+                        if (callId) {
+                            await this.fetchScorecard(callId);
+                        }
+                        return;
+                    }
+                }
+                catch (err) {
+                    this.emit('error', err instanceof Error ? err : new Error(String(err)));
+                }
+                // --- Transcript (voice scenarios only) ---
+                if (callId) {
+                    try {
+                        const txResponse = await this.sdk.calls.getTranscript(callId);
+                        if (txResponse.success && txResponse.data) {
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            const raw = txResponse.data;
+                            const transcript = raw.transcript || raw;
+                            if (transcript?.segments && transcript.segments.length > seenSegmentCount) {
+                                const newSegs = transcript.segments.slice(seenSegmentCount);
+                                for (const seg of newSegs) {
+                                    this.emit('transcript', {
+                                        speaker: seg.speaker,
+                                        text: seg.text,
+                                        start: seg.start,
+                                        end: seg.end,
+                                    });
+                                }
+                                seenSegmentCount = transcript.segments.length;
+                            }
+                        }
+                    }
+                    catch {
+                        // Transcript not available yet — normal
+                    }
+                }
+                await this.sleep(this.pollInterval);
+            }
+            // Max polls exhausted
+            this.emit('timeout');
+        }
+        catch (err) {
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            this._resolveCompleted();
+        }
+    }
+    async fetchScorecard(callId) {
+        for (let i = 0; i < 10; i++) {
+            if (this.abortController.signal.aborted)
+                return;
+            try {
+                const response = await this.sdk.calls.getScorecard(callId);
+                if (response.success && response.data) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const raw = response.data;
+                    const results = Array.isArray(raw) ? raw : raw.results || [];
+                    if (results.length > 0) {
+                        this.emit('scorecard', results);
+                        return;
+                    }
+                }
+            }
+            catch {
+                // Scorecard may not be ready yet
+            }
+            await this.sleep(2000);
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => {
+            const onAbort = () => {
+                clearTimeout(timeout);
+                resolve();
+            };
+            const timeout = setTimeout(() => {
+                this.abortController.signal.removeEventListener('abort', onAbort);
+                resolve();
+            }, ms);
+            this.abortController.signal.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+}
+exports.LiveExecution = LiveExecution;
+//# sourceMappingURL=live-execution.js.map