@chanl/sdk 2.0.1

package/dist/errors/index.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * Custom Error Classes for @chanl-ai/sdk
+ *
+ * TDD Phase: RED - These errors define the error handling contract
+ *
+ * Design Principles:
+ * - Error transparency: Include code, message, and context for debugging
+ * - HTTP status awareness: Map API response codes to specific error types
+ * - Serializable details: Allow JSON serialization for logging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = exports.NetworkError = exports.ServerError = exports.RateLimitError = exports.ConflictError = exports.AuthorizationError = exports.AuthenticationError = exports.ValidationError = exports.NotFoundError = exports.ChanlError = void 0;
+exports.isChanlError = isChanlError;
+exports.isNotFoundError = isNotFoundError;
+exports.isValidationError = isValidationError;
+exports.isAuthenticationError = isAuthenticationError;
+exports.createErrorFromResponse = createErrorFromResponse;
+/**
+ * Base error class for all Chanl SDK errors
+ */
+class ChanlError extends Error {
+    constructor(message, options = {}) {
+        super(message);
+        this.name = 'ChanlError';
+        this.code = options.code ?? 'CHANL_ERROR';
+        // Only assign optional properties when defined (exactOptionalPropertyTypes)
+        if (options.statusCode !== undefined) {
+            this.statusCode = options.statusCode;
+        }
+        if (options.details !== undefined) {
+            this.details = options.details;
+        }
+        if (options.cause !== undefined) {
+            this.cause = options.cause;
+        }
+        if (options.requestId !== undefined) {
+            this.requestId = options.requestId;
+        }
+        // Maintains proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert error to JSON for logging/serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+            details: this.details,
+            requestId: this.requestId,
+            stack: this.stack,
+        };
+    }
+}
+exports.ChanlError = ChanlError;
+/**
+ * Error thrown when a requested resource is not found (404)
+ */
+class NotFoundError extends ChanlError {
+    constructor(resourceType, resourceId, options = {}) {
+        const details = {
+            resourceType,
+            resourceId,
+            ...options.details,
+        };
+        super(`${resourceType} with ID '${resourceId}' not found`, {
+            code: 'NOT_FOUND',
+            statusCode: 404,
+            details,
+            requestId: options.requestId,
+        });
+        this.name = 'NotFoundError';
+        this.resourceType = resourceType;
+        this.resourceId = resourceId;
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Error thrown when input validation fails (400)
+ */
+class ValidationError extends ChanlError {
+    constructor(message, options = {}) {
+        const details = {
+            ...options.details,
+        };
+        if (options.fieldErrors !== undefined) {
+            details['fieldErrors'] = options.fieldErrors;
+        }
+        super(message, {
+            code: 'VALIDATION_ERROR',
+            statusCode: 400,
+            details,
+            requestId: options.requestId,
+        });
+        this.name = 'ValidationError';
+        if (options.fieldErrors !== undefined) {
+            this.fieldErrors = options.fieldErrors;
+        }
+    }
+    /**
+     * Get validation errors for a specific field
+     */
+    getFieldErrors(field) {
+        return this.fieldErrors?.[field] ?? [];
+    }
+    /**
+     * Check if a specific field has validation errors
+     */
+    hasFieldError(field) {
+        return (this.fieldErrors?.[field]?.length ?? 0) > 0;
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown when authentication fails (401)
+ */
+class AuthenticationError extends ChanlError {
+    constructor(message = 'Authentication required', options = {}) {
+        super(message, {
+            code: 'AUTHENTICATION_ERROR',
+            statusCode: 401,
+            details: options.details,
+            requestId: options.requestId,
+        });
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Error thrown when authorization fails (403)
+ */
+class AuthorizationError extends ChanlError {
+    constructor(message = 'Permission denied', options = {}) {
+        const details = {
+            ...options.details,
+        };
+        if (options.action !== undefined) {
+            details['action'] = options.action;
+        }
+        if (options.resource !== undefined) {
+            details['resource'] = options.resource;
+        }
+        super(message, {
+            code: 'AUTHORIZATION_ERROR',
+            statusCode: 403,
+            details,
+            requestId: options.requestId,
+        });
+        this.name = 'AuthorizationError';
+        if (options.action !== undefined) {
+            this.action = options.action;
+        }
+        if (options.resource !== undefined) {
+            this.resource = options.resource;
+        }
+    }
+}
+exports.AuthorizationError = AuthorizationError;
+/**
+ * Error thrown when there's a conflict (409)
+ */
+class ConflictError extends ChanlError {
+    constructor(message, options = {}) {
+        const details = {
+            ...options.details,
+        };
+        if (options.conflictingResource !== undefined) {
+            details['conflictingResource'] = options.conflictingResource;
+        }
+        super(message, {
+            code: 'CONFLICT_ERROR',
+            statusCode: 409,
+            details,
+            requestId: options.requestId,
+        });
+        this.name = 'ConflictError';
+        if (options.conflictingResource !== undefined) {
+            this.conflictingResource = options.conflictingResource;
+        }
+    }
+}
+exports.ConflictError = ConflictError;
+/**
+ * Error thrown when rate limit is exceeded (429)
+ */
+class RateLimitError extends ChanlError {
+    constructor(message = 'Rate limit exceeded', options = {}) {
+        const details = {
+            ...options.details,
+        };
+        if (options.retryAfter !== undefined) {
+            details['retryAfter'] = options.retryAfter;
+        }
+        super(message, {
+            code: 'RATE_LIMIT_ERROR',
+            statusCode: 429,
+            details,
+            requestId: options.requestId,
+        });
+        this.name = 'RateLimitError';
+        if (options.retryAfter !== undefined) {
+            this.retryAfter = options.retryAfter;
+        }
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Error thrown when API server fails (5xx)
+ */
+class ServerError extends ChanlError {
+    constructor(message = 'Internal server error', options = {}) {
+        super(message, {
+            code: 'SERVER_ERROR',
+            statusCode: options.statusCode ?? 500,
+            details: options.details,
+            requestId: options.requestId,
+        });
+        this.name = 'ServerError';
+    }
+}
+exports.ServerError = ServerError;
+/**
+ * Error thrown for network/connection issues
+ */
+class NetworkError extends ChanlError {
+    constructor(message = 'Network error', options = {}) {
+        super(message, {
+            code: 'NETWORK_ERROR',
+            cause: options.cause,
+            details: options.details,
+        });
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Error thrown when request times out
+ */
+class TimeoutError extends ChanlError {
+    constructor(message = 'Request timeout', options = {}) {
+        const details = {
+            ...options.details,
+        };
+        if (options.timeoutMs !== undefined) {
+            details['timeoutMs'] = options.timeoutMs;
+        }
+        super(message, {
+            code: 'TIMEOUT_ERROR',
+            details,
+            requestId: options.requestId,
+        });
+        this.name = 'TimeoutError';
+        if (options.timeoutMs !== undefined) {
+            this.timeoutMs = options.timeoutMs;
+        }
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Type guard to check if error is a ChanlError
+ */
+function isChanlError(error) {
+    return error instanceof ChanlError;
+}
+/**
+ * Type guard to check if error is a NotFoundError
+ */
+function isNotFoundError(error) {
+    return error instanceof NotFoundError;
+}
+/**
+ * Type guard to check if error is a ValidationError
+ */
+function isValidationError(error) {
+    return error instanceof ValidationError;
+}
+/**
+ * Type guard to check if error is an AuthenticationError
+ */
+function isAuthenticationError(error) {
+    return error instanceof AuthenticationError;
+}
+/**
+ * Factory function to create appropriate error from API response
+ */
+function createErrorFromResponse(statusCode, message, options = {}) {
+    switch (statusCode) {
+        case 400:
+            return new ValidationError(message, options);
+        case 401:
+            return new AuthenticationError(message, options);
+        case 403:
+            return new AuthorizationError(message, options);
+        case 404:
+            // For 404, we need resourceType and resourceId which aren't in options
+            // Return a generic ChanlError instead
+            return new ChanlError(message, {
+                code: 'NOT_FOUND',
+                statusCode: 404,
+                details: options.details,
+                requestId: options.requestId,
+            });
+        case 409:
+            return new ConflictError(message, options);
+        case 429:
+            return new RateLimitError(message, options);
+        default:
+            if (statusCode >= 500) {
+                return new ServerError(message, { statusCode, ...options });
+            }
+            return new ChanlError(message, { statusCode, ...options });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+export { ChanlSDK } from './client';
+export { ChanlConfig, ChanlAuthConfig } from './types/config';
+export { AudioModule } from './modules/audio';
+export { TranscriptModule } from './modules/transcript';
+export { ScorecardModule } from './modules/scorecard';
+export { WorkspaceModule } from './modules/workspace';
+export { AlertModule } from './modules/alerts';
+export { AuthModule } from './modules/auth';
+export { HealthModule } from './modules/health';
+export { PromptsModule } from './modules/prompts';
+export { ToolsModule } from './modules/tools';
+export { ToolsetsModule } from './modules/toolsets';
+export { ScenariosModule } from './modules/scenarios';
+export { AgentsModule } from './modules/agents';
+export { PersonasModule } from './modules/personas';
+export { CallsModule } from './modules/calls';
+export { McpModule } from './modules/mcp';
+export { KnowledgeModule } from './modules/knowledge';
+export { MemoryModule } from './modules/memory';
+export { ChatModule } from './modules/chat';
+export * from './types/api';
+export * from './modules/prompts';
+export * from './modules/scenarios';
+export * from './modules/calls';
+export * from './modules/personas';
+export * from './modules/agents';
+export * from './modules/scorecard';
+export * from './types/tools';
+export * from './types/tool-calls';
+export * from './types/toolsets';
+export * from './modules/mcp';
+export * from './modules/knowledge';
+export * from './types/memory';
+export * from './modules/chat';
+export * from './live';
+export * from './errors';
+export * from './adapters/openai';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAG9B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatModule = exports.MemoryModule = exports.KnowledgeModule = exports.McpModule = exports.CallsModule = exports.PersonasModule = exports.AgentsModule = exports.ScenariosModule = exports.ToolsetsModule = exports.ToolsModule = exports.PromptsModule = exports.HealthModule = exports.AuthModule = exports.AlertModule = exports.WorkspaceModule = exports.ScorecardModule = exports.TranscriptModule = exports.AudioModule = exports.ChanlSDK = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "ChanlSDK", { enumerable: true, get: function () { return client_1.ChanlSDK; } });
+var audio_1 = require("./modules/audio");
+Object.defineProperty(exports, "AudioModule", { enumerable: true, get: function () { return audio_1.AudioModule; } });
+var transcript_1 = require("./modules/transcript");
+Object.defineProperty(exports, "TranscriptModule", { enumerable: true, get: function () { return transcript_1.TranscriptModule; } });
+var scorecard_1 = require("./modules/scorecard");
+Object.defineProperty(exports, "ScorecardModule", { enumerable: true, get: function () { return scorecard_1.ScorecardModule; } });
+var workspace_1 = require("./modules/workspace");
+Object.defineProperty(exports, "WorkspaceModule", { enumerable: true, get: function () { return workspace_1.WorkspaceModule; } });
+var alerts_1 = require("./modules/alerts");
+Object.defineProperty(exports, "AlertModule", { enumerable: true, get: function () { return alerts_1.AlertModule; } });
+var auth_1 = require("./modules/auth");
+Object.defineProperty(exports, "AuthModule", { enumerable: true, get: function () { return auth_1.AuthModule; } });
+var health_1 = require("./modules/health");
+Object.defineProperty(exports, "HealthModule", { enumerable: true, get: function () { return health_1.HealthModule; } });
+var prompts_1 = require("./modules/prompts");
+Object.defineProperty(exports, "PromptsModule", { enumerable: true, get: function () { return prompts_1.PromptsModule; } });
+var tools_1 = require("./modules/tools");
+Object.defineProperty(exports, "ToolsModule", { enumerable: true, get: function () { return tools_1.ToolsModule; } });
+var toolsets_1 = require("./modules/toolsets");
+Object.defineProperty(exports, "ToolsetsModule", { enumerable: true, get: function () { return toolsets_1.ToolsetsModule; } });
+var scenarios_1 = require("./modules/scenarios");
+Object.defineProperty(exports, "ScenariosModule", { enumerable: true, get: function () { return scenarios_1.ScenariosModule; } });
+var agents_1 = require("./modules/agents");
+Object.defineProperty(exports, "AgentsModule", { enumerable: true, get: function () { return agents_1.AgentsModule; } });
+var personas_1 = require("./modules/personas");
+Object.defineProperty(exports, "PersonasModule", { enumerable: true, get: function () { return personas_1.PersonasModule; } });
+var calls_1 = require("./modules/calls");
+Object.defineProperty(exports, "CallsModule", { enumerable: true, get: function () { return calls_1.CallsModule; } });
+var mcp_1 = require("./modules/mcp");
+Object.defineProperty(exports, "McpModule", { enumerable: true, get: function () { return mcp_1.McpModule; } });
+var knowledge_1 = require("./modules/knowledge");
+Object.defineProperty(exports, "KnowledgeModule", { enumerable: true, get: function () { return knowledge_1.KnowledgeModule; } });
+var memory_1 = require("./modules/memory");
+Object.defineProperty(exports, "MemoryModule", { enumerable: true, get: function () { return memory_1.MemoryModule; } });
+var chat_1 = require("./modules/chat");
+Object.defineProperty(exports, "ChatModule", { enumerable: true, get: function () { return chat_1.ChatModule; } });
+// Re-export all types from modules
+__exportStar(require("./types/api"), exports);
+__exportStar(require("./modules/prompts"), exports);
+__exportStar(require("./modules/scenarios"), exports);
+__exportStar(require("./modules/calls"), exports);
+__exportStar(require("./modules/personas"), exports);
+__exportStar(require("./modules/agents"), exports);
+__exportStar(require("./modules/scorecard"), exports); // Export tool types
+__exportStar(require("./types/tools"), exports);
+// Export tool call types (shared across chat, scenarios, calls)
+__exportStar(require("./types/tool-calls"), exports);
+// Export toolset types
+__exportStar(require("./types/toolsets"), exports); // Export MCP types
+__exportStar(require("./modules/mcp"), exports); // Export Knowledge types
+__exportStar(require("./modules/knowledge"), exports); // Export Memory types
+__exportStar(require("./types/memory"), exports); // Export Chat types
+__exportStar(require("./modules/chat"), exports); // Export live monitoring classes
+__exportStar(require("./live"), exports); // Export error classes
+__exportStar(require("./errors"), exports); // Export OpenAI adapter
+__exportStar(require("./adapters/openai"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAoC;AAA3B,kGAAA,QAAQ,OAAA;AAEjB,yCAA8C;AAArC,oGAAA,WAAW,OAAA;AACpB,mDAAwD;AAA/C,8GAAA,gBAAgB,OAAA;AACzB,iDAAsD;AAA7C,4GAAA,eAAe,OAAA;AACxB,iDAAsD;AAA7C,4GAAA,eAAe,OAAA;AACxB,2CAA+C;AAAtC,qGAAA,WAAW,OAAA;AACpB,uCAA4C;AAAnC,kGAAA,UAAU,OAAA;AACnB,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AACrB,6CAAkD;AAAzC,wGAAA,aAAa,OAAA;AACtB,yCAA8C;AAArC,oGAAA,WAAW,OAAA;AACpB,+CAAoD;AAA3C,0GAAA,cAAc,OAAA;AACvB,iDAAsD;AAA7C,4GAAA,eAAe,OAAA;AACxB,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AACrB,+CAAoD;AAA3C,0GAAA,cAAc,OAAA;AACvB,yCAA8C;AAArC,oGAAA,WAAW,OAAA;AACpB,qCAA0C;AAAjC,gGAAA,SAAS,OAAA;AAClB,iDAAsD;AAA7C,4GAAA,eAAe,OAAA;AACxB,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AACrB,uCAA4C;AAAnC,kGAAA,UAAU,OAAA;AAEnB,mCAAmC;AACnC,8CAA4B;AAC5B,oDAAkC;AAClC,sDAAoC;AACpC,kDAAgC;AAChC,qDAAmC;AACnC,mDAAiC;AACjC,sDAAoC,CAAA,oBAAoB;AACxD,gDAA8B;AAE9B,gEAAgE;AAChE,qDAAmC;AAEnC,uBAAuB;AACvB,mDAAiC,CAAA,mBAAmB;AACpD,gDAA8B,CAAA,yBAAyB;AACvD,sDAAoC,CAAA,sBAAsB;AAC1D,iDAA+B,CAAA,oBAAoB;AACnD,iDAA+B,CAAA,iCAAiC;AAChE,yCAAuB,CAAA,uBAAuB;AAC9C,2CAAyB,CAAA,wBAAwB;AACjD,oDAAkC"}

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"}