channelkit 1.0.0

package/dist/channels/endpoint/index.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EndpointChannel = void 0;
+const crypto_1 = require("crypto");
+const base_1 = require("../base");
+class EndpointChannel extends base_1.Channel {
+    pendingResponses = new Map();
+    constructor(name, config) {
+        super(name, config);
+    }
+    get cfg() {
+        return this.config;
+    }
+    async connect() {
+        const method = (this.cfg.method || 'POST').toUpperCase();
+        const mode = this.cfg.response_mode || 'sync';
+        console.log(`[endpoint:${this.name}] Ready — ${method} /inbound/endpoint/${this.name} (${mode})`);
+    }
+    async disconnect() {
+        for (const [key, pending] of this.pendingResponses) {
+            clearTimeout(pending.timer);
+            pending.resolve({ text: 'Channel disconnected' });
+        }
+        this.pendingResponses.clear();
+    }
+    async send(to, response) {
+        const pending = this.pendingResponses.get(to);
+        if (pending) {
+            clearTimeout(pending.timer);
+            this.pendingResponses.delete(to);
+            pending.resolve(response);
+        }
+    }
+    /**
+     * Called by the inbound route handler.
+     * Creates a UnifiedMessage, emits it, and optionally returns a promise
+     * that resolves when the pipeline calls send() (sync mode).
+     */
+    handleRequest(body, query, headers, method) {
+        const requestId = (0, crypto_1.randomUUID)();
+        const fromId = `endpoint:${requestId}`;
+        // Build text from request
+        let text;
+        if (method === 'GET') {
+            text = query.text || JSON.stringify(query);
+        }
+        else {
+            text = typeof body === 'string' ? body : (body != null ? JSON.stringify(body) : undefined);
+        }
+        const message = {
+            id: requestId,
+            channel: 'endpoint',
+            from: fromId,
+            type: 'text',
+            text,
+            timestamp: Math.floor(Date.now() / 1000),
+            endpoint: {
+                body: method !== 'GET' ? body : undefined,
+                query,
+                headers,
+                method,
+            },
+        };
+        let waitForResponse;
+        if (this.cfg.response_mode === 'sync' || this.cfg.response_mode == null) {
+            const timeout = (this.cfg.response_timeout || 30) * 1000;
+            waitForResponse = new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    this.pendingResponses.delete(fromId);
+                    resolve({ text: 'Response timeout', _error: true });
+                }, timeout);
+                this.pendingResponses.set(fromId, { resolve, timer });
+            });
+        }
+        this.emitMessage(message);
+        return { message, waitForResponse };
+    }
+}
+exports.EndpointChannel = EndpointChannel;
+//# sourceMappingURL=index.js.map

package/dist/channels/endpoint/index.js.map

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

package/dist/channels/sms/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Twilio SMS Channel
+ *
+ * Inbound: polling (GET /Messages) or webhook (POST /inbound/twilio/<channel>)
+ * Outbound: Twilio REST API
+ */
+import { Channel } from '../base';
+import { TwilioSMSChannelConfig } from '../../config/types';
+import { WebhookResponse } from '../../core/types';
+export declare class TwilioSMSChannel extends Channel {
+    private client;
+    private pollTimer;
+    private lastPollTime;
+    private processedSids;
+    constructor(name: string, config: TwilioSMSChannelConfig);
+    private get cfg();
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(to: string, response: WebhookResponse): Promise<void>;
+    /**
+     * Handle inbound webhook from Twilio.
+     * Called by ApiServer when POST /inbound/twilio/<channelName> is hit.
+     */
+    handleInbound(payload: any): void;
+    /**
+     * Get the Twilio phone number SID (for webhook configuration)
+     */
+    getNumberSid(): Promise<string | null>;
+    /**
+     * Set the SMS webhook URL on this Twilio number
+     */
+    setWebhookUrl(url: string): Promise<void>;
+    private poll;
+    private apiToUnified;
+    private webhookToUnified;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/sms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/sms/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnE,qBAAa,gBAAiB,SAAQ,OAAO;IAC3C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,aAAa,CAA0B;gBAEnC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB;IAMxD,OAAO,KAAK,GAAG,GAEd;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAOjC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS5C;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAejC,IAAI;IAiClB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/channels/sms/index.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Twilio SMS Channel
+ *
+ * Inbound: polling (GET /Messages) or webhook (POST /inbound/twilio/<channel>)
+ * Outbound: Twilio REST API
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwilioSMSChannel = void 0;
+const twilio_1 = __importDefault(require("twilio"));
+const base_1 = require("../base");
+class TwilioSMSChannel extends base_1.Channel {
+    client;
+    pollTimer = null;
+    lastPollTime;
+    processedSids = new Set();
+    constructor(name, config) {
+        super(name, config);
+        this.client = (0, twilio_1.default)(config.account_sid, config.auth_token);
+        this.lastPollTime = new Date();
+    }
+    get cfg() {
+        return this.config;
+    }
+    async connect() {
+        // Verify the number exists
+        try {
+            const numbers = await this.client.incomingPhoneNumbers.list({ phoneNumber: this.cfg.number, limit: 1 });
+            if (numbers.length > 0) {
+                console.log(`✅ Twilio SMS connected: ${this.name} (${this.cfg.number})`);
+            }
+            else {
+                console.warn(`⚠️  Twilio number ${this.cfg.number} not found in account. SMS may not work.`);
+            }
+        }
+        catch (err) {
+            console.warn(`⚠️  Could not verify Twilio number: ${err.message}`);
+        }
+        if (this.cfg.poll_interval) {
+            const interval = this.cfg.poll_interval * 1000;
+            console.log(`  📱 Polling for inbound SMS every ${this.cfg.poll_interval}s`);
+            this.poll();
+            this.pollTimer = setInterval(() => this.poll(), interval);
+        }
+        else {
+            console.log(`  📱 Waiting for inbound SMS via webhook`);
+        }
+    }
+    async disconnect() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+    }
+    async send(to, response) {
+        if (!response.text)
+            return;
+        const msg = await this.client.messages.create({
+            body: response.text,
+            from: this.cfg.number,
+            to,
+        });
+        console.log(`[sms:${this.name}] Sent to ${to}: ${msg.sid}`);
+    }
+    /**
+     * Handle inbound webhook from Twilio.
+     * Called by ApiServer when POST /inbound/twilio/<channelName> is hit.
+     */
+    handleInbound(payload) {
+        const unified = this.webhookToUnified(payload);
+        if (unified) {
+            this.emitMessage(unified);
+        }
+    }
+    /**
+     * Get the Twilio phone number SID (for webhook configuration)
+     */
+    async getNumberSid() {
+        try {
+            const numbers = await this.client.incomingPhoneNumbers.list({ phoneNumber: this.cfg.number, limit: 1 });
+            return numbers.length > 0 ? numbers[0].sid : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Set the SMS webhook URL on this Twilio number
+     */
+    async setWebhookUrl(url) {
+        const sid = await this.getNumberSid();
+        if (!sid) {
+            console.error(`[sms:${this.name}] Cannot set webhook — number not found`);
+            return;
+        }
+        await this.client.incomingPhoneNumbers(sid).update({
+            smsUrl: url,
+            smsMethod: 'POST',
+        });
+        console.log(`  📱 Updated Twilio SMS webhook for ${this.cfg.number}`);
+    }
+    // --- Polling ---
+    async poll() {
+        try {
+            console.log(`[sms:${this.name}] Polling Twilio for inbound messages since ${this.lastPollTime.toISOString()}`);
+            const messages = await this.client.messages.list({
+                to: this.cfg.number,
+                dateSentAfter: this.lastPollTime,
+                limit: 20,
+            });
+            // Update poll time for next cycle
+            this.lastPollTime = new Date();
+            for (const msg of messages) {
+                if (this.processedSids.has(msg.sid))
+                    continue;
+                if (msg.direction !== 'inbound')
+                    continue;
+                this.processedSids.add(msg.sid);
+                // Keep set bounded
+                if (this.processedSids.size > 1000) {
+                    const arr = [...this.processedSids];
+                    this.processedSids = new Set(arr.slice(-500));
+                }
+                const unified = this.apiToUnified(msg);
+                if (unified)
+                    this.emitMessage(unified);
+            }
+        }
+        catch (err) {
+            console.error(`[sms:${this.name}] Poll error:`, err);
+        }
+    }
+    // --- Convert to UnifiedMessage ---
+    apiToUnified(msg) {
+        return {
+            id: msg.sid,
+            channel: 'sms',
+            from: msg.from,
+            type: 'text',
+            text: msg.body || '',
+            timestamp: Math.floor(new Date(msg.dateSent || msg.dateCreated).getTime() / 1000),
+            senderName: undefined,
+        };
+    }
+    webhookToUnified(payload) {
+        if (!payload.From || !payload.Body)
+            return null;
+        return {
+            id: payload.MessageSid || `twilio-${Date.now()}`,
+            channel: 'sms',
+            from: payload.From,
+            type: 'text',
+            text: payload.Body,
+            timestamp: Math.floor(Date.now() / 1000),
+            senderName: undefined,
+        };
+    }
+}
+exports.TwilioSMSChannel = TwilioSMSChannel;
+//# sourceMappingURL=index.js.map

package/dist/channels/sms/index.js.map

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

package/dist/channels/telegram/index.d.ts

@@ -0,0 +1,24 @@
+import { Channel } from '../base';
+import { TelegramChannelConfig, ServiceConfig } from '../../config/types';
+import { WebhookResponse } from '../../core/types';
+export declare class TelegramChannel extends Channel {
+    private bot;
+    private slashCommands;
+    private activeService;
+    constructor(name: string, config: TelegramChannelConfig);
+    private get token();
+    /**
+     * Register slash commands for multi-service mode.
+     * Called by ChannelKit after router is set up.
+     */
+    setSlashCommands(services: {
+        name: string;
+        config: ServiceConfig;
+    }[]): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendToChat(chatId: string, text: string): Promise<void>;
+    send(to: string, response: WebhookResponse): Promise<void>;
+    private toUnified;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/telegram/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAQnE,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO,CAAC,aAAa,CAAkC;gBAE3C,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB;IAIvD,OAAO,KAAK,KAAK,GAEhB;IAED;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,EAAE,GAAG,IAAI;IAUrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuHxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BhE,OAAO,CAAC,SAAS;CA0ClB"}

package/dist/channels/telegram/index.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramChannel = void 0;
+const grammy_1 = require("grammy");
+const base_1 = require("../base");
+class TelegramChannel extends base_1.Channel {
+    bot = null;
+    slashCommands = [];
+    // userId → active service webhook (for multi-service routing)
+    activeService = new Map();
+    constructor(name, config) {
+        super(name, config);
+    }
+    get token() {
+        return this.config.bot_token;
+    }
+    /**
+     * Register slash commands for multi-service mode.
+     * Called by ChannelKit after router is set up.
+     */
+    setSlashCommands(services) {
+        this.slashCommands = services
+            .filter(s => s.config.command)
+            .map(s => ({
+            command: s.config.command.replace(/^\//, ''),
+            serviceName: s.name,
+            webhook: s.config.webhook,
+        }));
+    }
+    async connect() {
+        this.bot = new grammy_1.Bot(this.token);
+        // Register slash commands with Telegram if we have any
+        if (this.slashCommands.length > 0) {
+            await this.bot.api.setMyCommands(this.slashCommands.map(sc => ({
+                command: sc.command,
+                description: sc.serviceName,
+            })));
+            console.log(`  📋 Registered ${this.slashCommands.length} slash command(s): ${this.slashCommands.map(sc => '/' + sc.command).join(', ')}`);
+        }
+        this.bot.on('message', async (ctx) => {
+            const text = ctx.message?.text || '';
+            // Check if it's a slash command for service switching
+            if (text.startsWith('/') && this.slashCommands.length > 0) {
+                const cmd = text.split(/[@\s]/)[0].slice(1).toLowerCase();
+                const match = this.slashCommands.find(sc => sc.command.toLowerCase() === cmd);
+                if (match) {
+                    const userId = ctx.message.from.id.toString();
+                    this.activeService.set(userId, match.webhook);
+                    ctx.reply(`✅ Switched to ${match.serviceName}. Send your messages now.`);
+                    console.log(`[telegram] User ${userId} switched to service: ${match.serviceName}`);
+                    return;
+                }
+                // /start command — show available services
+                if (cmd === 'start' && this.slashCommands.length > 0) {
+                    const lines = this.slashCommands.map(sc => `/${sc.command} — ${sc.serviceName}`);
+                    ctx.reply(`Available services:\n\n${lines.join('\n')}\n\nTap a command to get started.`);
+                    return;
+                }
+            }
+            const unified = this.toUnified(ctx);
+            if (!unified)
+                return;
+            // Download media for messages with media content
+            const mediaDownloadTypes = ['audio', 'image', 'video', 'document', 'sticker'];
+            if (mediaDownloadTypes.includes(unified.type)) {
+                try {
+                    let fileId;
+                    let mimetype;
+                    let filename;
+                    const msg = ctx.message;
+                    if (msg.voice) {
+                        fileId = msg.voice.file_id;
+                        mimetype = msg.voice.mime_type || 'audio/ogg';
+                    }
+                    else if (msg.audio) {
+                        fileId = msg.audio.file_id;
+                        mimetype = msg.audio.mime_type || 'audio/mpeg';
+                        filename = msg.audio.file_name || undefined;
+                    }
+                    else if (msg.photo && msg.photo.length > 0) {
+                        const largest = msg.photo[msg.photo.length - 1];
+                        fileId = largest.file_id;
+                        mimetype = 'image/jpeg';
+                    }
+                    else if (msg.document) {
+                        fileId = msg.document.file_id;
+                        mimetype = msg.document.mime_type || 'application/octet-stream';
+                        filename = msg.document.file_name || undefined;
+                    }
+                    else if (msg.video) {
+                        fileId = msg.video.file_id;
+                        mimetype = msg.video.mime_type || 'video/mp4';
+                        filename = msg.video.file_name || undefined;
+                    }
+                    else if (msg.video_note) {
+                        fileId = msg.video_note.file_id;
+                        mimetype = 'video/mp4';
+                    }
+                    else if (msg.sticker) {
+                        fileId = msg.sticker.file_id;
+                        mimetype = msg.sticker.is_animated ? 'application/x-tgsticker' :
+                            msg.sticker.is_video ? 'video/webm' : 'image/webp';
+                    }
+                    if (fileId) {
+                        const file = await ctx.api.getFile(fileId);
+                        const url = `https://api.telegram.org/file/bot${this.token}/${file.file_path}`;
+                        const res = await fetch(url);
+                        const buffer = Buffer.from(await res.arrayBuffer());
+                        console.log(`[telegram:${this.name}] Downloaded ${unified.type}: ${buffer.length} bytes, ${mimetype}`);
+                        unified.media = { buffer, mimetype, filename };
+                    }
+                }
+                catch (err) {
+                    console.error(`[telegram:${this.name}] Failed to download ${unified.type} media:`, err);
+                }
+            }
+            // In multi-service mode, attach the active webhook so router can use it
+            if (this.slashCommands.length > 0) {
+                const userId = ctx.message.from.id.toString();
+                const activeWebhook = this.activeService.get(userId);
+                if (activeWebhook) {
+                    unified._resolvedWebhook = activeWebhook;
+                }
+                else {
+                    // No active service — prompt user to pick one
+                    const lines = this.slashCommands.map(sc => `/${sc.command} — ${sc.serviceName}`);
+                    ctx.reply(`Please choose a service first:\n\n${lines.join('\n')}`);
+                    return;
+                }
+            }
+            this.emitMessage(unified);
+        });
+        // Log unhandled middleware errors
+        this.bot.catch((err) => {
+            console.error(`[telegram:${this.name}] Unhandled error:`, err.message || err);
+        });
+        // Start polling in background (don't await — it blocks)
+        this.bot.start({
+            onStart: (botInfo) => {
+                console.log(`✅ Telegram connected: ${this.name} (@${botInfo.username})`);
+            },
+        });
+    }
+    async disconnect() {
+        if (this.bot) {
+            await this.bot.stop();
+            this.bot = null;
+        }
+    }
+    async sendToChat(chatId, text) {
+        if (!this.bot)
+            return;
+        const id = parseInt(chatId, 10) || chatId;
+        await this.bot.api.sendMessage(id, text);
+    }
+    async send(to, response) {
+        if (!this.bot)
+            return;
+        const chatId = parseInt(to, 10) || to;
+        // Voice message from buffer (TTS output)
+        if (response.media?.buffer && response.media.mimetype?.includes('audio')) {
+            await this.bot.api.sendVoice(chatId, new grammy_1.InputFile(response.media.buffer, 'voice.ogg'));
+            return;
+        }
+        if (response.text) {
+            await this.bot.api.sendMessage(chatId, response.text);
+        }
+        if (response.media?.url) {
+            const mime = response.media.mimetype || '';
+            if (mime.startsWith('image')) {
+                await this.bot.api.sendPhoto(chatId, response.media.url);
+            }
+            else if (mime.startsWith('audio')) {
+                await this.bot.api.sendAudio(chatId, response.media.url);
+            }
+            else if (mime.startsWith('video')) {
+                await this.bot.api.sendVideo(chatId, response.media.url);
+            }
+            else {
+                await this.bot.api.sendDocument(chatId, response.media.url);
+            }
+        }
+    }
+    toUnified(ctx) {
+        const msg = ctx.message;
+        if (!msg)
+            return null;
+        const chatId = msg.chat.id.toString();
+        const from = msg.from;
+        const senderName = from
+            ? [from.first_name, from.last_name].filter(Boolean).join(' ')
+            : undefined;
+        const isGroup = msg.chat.type === 'group' || msg.chat.type === 'supergroup';
+        const text = msg.text ||
+            msg.caption ||
+            '';
+        let type = 'text';
+        if (msg.photo && msg.photo.length > 0)
+            type = 'image';
+        else if (msg.document)
+            type = 'document';
+        else if (msg.audio)
+            type = 'audio';
+        else if (msg.video)
+            type = 'video';
+        else if (msg.voice)
+            type = 'audio';
+        else if (msg.video_note)
+            type = 'video';
+        else if (msg.sticker)
+            type = 'sticker';
+        else if (msg.location)
+            type = 'location';
+        return {
+            id: msg.message_id.toString(),
+            channel: 'telegram',
+            from: chatId,
+            type,
+            text: text || undefined,
+            timestamp: msg.date,
+            replyTo: msg.reply_to_message?.message_id?.toString() || undefined,
+            senderName,
+            groupId: isGroup ? chatId : undefined,
+            groupName: isGroup
+                ? ('title' in msg.chat ? msg.chat.title : undefined)
+                : undefined,
+        };
+    }
+}
+exports.TelegramChannel = TelegramChannel;
+//# sourceMappingURL=index.js.map

package/dist/channels/telegram/index.js.map

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

package/dist/channels/voice/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Twilio Voice Channel
+ *
+ * Flow:
+ * 1. Incoming call → POST /inbound/voice/<channel>
+ * 2. ChannelKit returns TwiML: greeting + record
+ * 3. Recording done → POST /inbound/voice/<channel>/recording
+ * 4. ChannelKit: STT → webhook → TTS → respond to caller
+ * 5. Loop back to record (default) — webhook returns { endcall: true } to hang up
+ */
+import { Channel } from '../base';
+import { TwilioVoiceChannelConfig, VoiceServiceConfig } from '../../config/types';
+import { WebhookResponse } from '../../core/types';
+interface AudioCacheEntry {
+    buffer: Buffer;
+    mimetype: string;
+    createdAt: number;
+}
+export declare class TwilioVoiceChannel extends Channel {
+    private client;
+    private pendingCalls;
+    private publicUrl;
+    private audioCache;
+    statusMessage: string | null;
+    constructor(name: string, config: TwilioVoiceChannelConfig);
+    private get cfg();
+    setPublicUrl(url: string): void;
+    /**
+     * Store an audio buffer in cache and return its ID
+     */
+    storeAudio(buffer: Buffer, mimetype: string): string;
+    /**
+     * Retrieve and remove an audio buffer from cache
+     */
+    getAudio(id: string): AudioCacheEntry | undefined;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    /**
+     * Set the voice webhook URL on this Twilio number
+     */
+    setWebhookUrl(url: string): Promise<void>;
+    /**
+     * Handle incoming call — returns TwiML
+     */
+    handleIncomingCall(payload: any, voiceConfig?: VoiceServiceConfig): string;
+    /**
+     * Handle recording callback — downloads audio, emits as message
+     */
+    handleRecording(payload: any, voiceConfig?: VoiceServiceConfig): Promise<string>;
+    private callResponses;
+    /**
+     * Store a webhook response for an active call
+     */
+    setCallResponse(callSid: string, response: WebhookResponse): void;
+    /**
+     * Handle respond redirect — check if webhook response is ready
+     */
+    handleRespond(callSid: string, voiceConfig?: VoiceServiceConfig): string;
+    send(_to: string, response: WebhookResponse): Promise<void>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,wBAAwB,EAAiB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAUnE,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAmB,SAAQ,OAAO;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAA2C;IACtD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAE/B,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB;IAO1D,OAAO,KAAK,GAAG,GAEd;IAED,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQpD;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAM3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB/C;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAoC1E;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0EtF,OAAO,CAAC,aAAa,CAA2C;IAEhE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIjE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAiElE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlE"}