convoai 1.6.2 → 1.8.0

package/dist/src/commands/phone/_helpers.js

@@ -0,0 +1,133 @@
+// src/commands/phone/_helpers.ts
+import axios from 'axios';
+import { resolveConfig } from '../../config/manager.js';
+import { createClient } from '../../api/client.js';
+import { CallAPI } from '../../api/calls.js';
+import { NumberAPI } from '../../api/numbers.js';
+// ─── E.164 Validation ──────────────────────────────────────────────────────
+const E164_REGEX = /^\+[1-9]\d{1,14}$/;
+export function isE164(phone) {
+    return E164_REGEX.test(phone);
+}
+export function validateE164(phone) {
+    const trimmed = phone.trim();
+    if (!isE164(trimmed)) {
+        throw new Error(`Invalid phone number "${trimmed}". Use E.164 format: +15551234567`);
+    }
+    return trimmed;
+}
+// ─── Credential Check ──────────────────────────────────────────────────────
+function requireCredentials(config) {
+    const missing = [];
+    if (!config.app_id)
+        missing.push('app_id');
+    if (!config.customer_id)
+        missing.push('customer_id');
+    if (!config.customer_secret)
+        missing.push('customer_secret');
+    if (missing.length > 0) {
+        throw new Error(`Missing credentials: ${missing.join(', ')}. Run "convoai quickstart" to configure.`);
+    }
+}
+// ─── API Factories ─────────────────────────────────────────────────────────
+/** Create a project-scoped CallAPI (baseURL includes /projects/{appId}). */
+export function getCallAPI(profileName) {
+    const config = resolveConfig(profileName);
+    requireCredentials(config);
+    const client = createClient({
+        appId: config.app_id,
+        customerId: config.customer_id,
+        customerSecret: config.customer_secret,
+        baseUrl: config.base_url,
+        region: config.region,
+    });
+    return new CallAPI(client);
+}
+/** Create an account-scoped NumberAPI (baseURL does NOT include /projects/{appId}). */
+export function getNumberAPI(profileName) {
+    const config = resolveConfig(profileName);
+    requireCredentials(config);
+    const region = config.region ?? 'global';
+    let baseURL;
+    if (config.base_url) {
+        // Custom base URL: strip /projects/{appId} suffix if present, keep the base
+        baseURL = config.base_url.replace(/\/projects\/[^/]+\/?$/, '');
+    }
+    else {
+        const baseURLs = {
+            global: 'https://api.agora.io/api/conversational-ai-agent/v2',
+            cn: 'https://api.agora.io/cn/api/conversational-ai-agent/v2',
+        };
+        baseURL = baseURLs[region] ?? baseURLs.global;
+    }
+    const credentials = Buffer.from(`${config.customer_id}:${config.customer_secret}`).toString('base64');
+    const client = axios.create({
+        baseURL,
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Basic ${credentials}`,
+        },
+        timeout: 30_000,
+    });
+    return new NumberAPI(client);
+}
+/** Get resolved config. */
+export function getConfig(profileName) {
+    return resolveConfig(profileName);
+}
+// ─── Interactive Number Picker ─────────────────────────────────────────────
+export async function pickOutboundNumber(numbers) {
+    const outbound = numbers.filter(n => n.outbound);
+    if (outbound.length === 0) {
+        throw new Error('No outbound-capable numbers found. Import one with: convoai phone import');
+    }
+    if (outbound.length === 1)
+        return outbound[0];
+    const { default: inquirer } = await import('inquirer');
+    const { selected } = await inquirer.prompt([{
+            type: 'list',
+            name: 'selected',
+            message: 'From number:',
+            choices: outbound.map(n => ({
+                name: `${n.phone_number} (${n.label})`,
+                value: n.phone_number,
+            })),
+        }]);
+    return outbound.find(n => n.phone_number === selected);
+}
+// ─── Shared Call-Building Helpers ───────────────────────────────────────────
+/** Generate a unique channel name for phone calls. */
+export function buildChannelName() {
+    return `call-${Date.now().toString(36)}${Math.random().toString(36).slice(2, 6)}`;
+}
+/** Build a SendCallRequest from resolved parameters. */
+export function buildCallRequest(params) {
+    return {
+        name: `call-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+        sip: {
+            to_number: params.toNumber,
+            from_number: params.fromNumber,
+            rtc_uid: '1',
+            rtc_token: params.sipToken,
+        },
+        properties: {
+            channel: params.channelName,
+            token: params.agentToken,
+            agent_rtc_uid: '0',
+            remote_rtc_uids: ['1'],
+            idle_timeout: params.idleTimeout ?? 600,
+            llm: params.llm,
+            tts: params.tts,
+            asr: params.asr,
+        },
+    };
+}
+/** Build TTS config, optionally applying a voice profile override. */
+export function buildTTSConfig(baseTTS, voiceProfile) {
+    const tts = { ...baseTTS, params: { ...baseTTS.params } };
+    if (voiceProfile?.voice_id) {
+        tts.params = { ...tts.params, voice: voiceProfile.voice_id };
+    }
+    return tts;
+}
+//# sourceMappingURL=_helpers.js.map

package/dist/src/commands/phone/_helpers.js.map

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

package/dist/src/commands/phone/_modes/agent.d.ts

@@ -0,0 +1,22 @@
+import type { LLMConfig, TTSConfig, ASRConfig } from '../../../api/types.js';
+import type { CallConfig } from './free.js';
+export interface AgentCallParams {
+    toNumber: string;
+    fromNumber: string;
+    task: string;
+    taskLang: string;
+    llm: Partial<LLMConfig>;
+    tts: Partial<TTSConfig>;
+    asr: Partial<ASRConfig>;
+}
+export declare function buildAgentCallConfig(params: AgentCallParams): CallConfig;
+/** Interactive parameter collection for agent mode. */
+export declare function collectAgentParams(opts: {
+    to?: string;
+    task?: string;
+    taskLang?: string;
+}): Promise<{
+    toNumber: string;
+    task: string;
+    taskLang: string;
+}>;

package/dist/src/commands/phone/_modes/agent.js

@@ -0,0 +1,59 @@
+import { SUPPORTED_LANGUAGES } from './translate.js';
+export function buildAgentCallConfig(params) {
+    const agentPrompt = `You are an AI phone agent. Your task: ${params.task}\n\n` +
+        `Speak in ${params.taskLang}. Be polite and professional. ` +
+        `Introduce yourself, state your purpose clearly, and work toward completing the task. ` +
+        `If you successfully complete the task, confirm the details. ` +
+        `If the task cannot be completed, politely end the conversation.`;
+    return {
+        mode: 'agent',
+        toNumber: params.toNumber,
+        fromNumber: params.fromNumber,
+        llm: {
+            ...params.llm,
+            system_messages: [{ role: 'system', content: agentPrompt }],
+        },
+        tts: { ...params.tts },
+        asr: { ...params.asr, language: params.taskLang },
+        idleTimeout: 900,
+        label: `🤖 Agent → ${params.toNumber}`,
+    };
+}
+/** Interactive parameter collection for agent mode. */
+export async function collectAgentParams(opts) {
+    const { default: inquirer } = await import('inquirer');
+    const { validateE164 } = await import('../_helpers.js');
+    let task = opts.task;
+    if (!task) {
+        const ans = await inquirer.prompt([{
+                type: 'input',
+                name: 'task',
+                message: 'Describe the task:',
+                validate: (v) => v.trim().length > 0 || 'Task description is required',
+            }]);
+        task = ans.task;
+    }
+    let toNumber = opts.to;
+    if (!toNumber) {
+        const ans = await inquirer.prompt([{
+                type: 'input',
+                name: 'to',
+                message: 'Phone number to call (E.164):',
+                validate: (v) => /^\+[1-9]\d{1,14}$/.test(v.trim()) || 'Invalid E.164 format',
+            }]);
+        toNumber = ans.to;
+    }
+    toNumber = validateE164(toNumber);
+    let taskLang = opts.taskLang;
+    if (!taskLang) {
+        const ans = await inquirer.prompt([{
+                type: 'list',
+                name: 'lang',
+                message: 'Language to speak:',
+                choices: SUPPORTED_LANGUAGES,
+            }]);
+        taskLang = ans.lang;
+    }
+    return { toNumber, task: task, taskLang: taskLang };
+}
+//# sourceMappingURL=agent.js.map

package/dist/src/commands/phone/_modes/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../../src/commands/phone/_modes/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAYrD,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,MAAM,WAAW,GACf,yCAAyC,MAAM,CAAC,IAAI,MAAM;QAC1D,YAAY,MAAM,CAAC,QAAQ,gCAAgC;QAC3D,uFAAuF;QACvF,8DAA8D;QAC9D,iEAAiE,CAAC;IAEpE,OAAO;QACL,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,GAAG,EAAE;YACH,GAAG,MAAM,CAAC,GAAG;YACb,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;SAC5D;QACD,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE;QACtB,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;QACjD,WAAW,EAAE,GAAG;QAChB,KAAK,EAAE,cAAc,MAAM,CAAC,QAAQ,EAAE;KACvC,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAIxC;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAExD,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,oBAAoB;gBAC7B,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,8BAA8B;aAC/E,CAAC,CAAC,CAAC;QACJ,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;IACvB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,+BAA+B;gBACxC,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,sBAAsB;aACtF,CAAC,CAAC,CAAC;QACJ,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC;IACpB,CAAC;IACD,QAAQ,GAAG,YAAY,CAAC,QAAS,CAAC,CAAC;IAEnC,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC7B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,oBAAoB;gBAC7B,OAAO,EAAE,mBAAmB;aAC7B,CAAC,CAAC,CAAC;QACJ,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAK,EAAE,QAAQ,EAAE,QAAS,EAAE,CAAC;AACxD,CAAC"}

package/dist/src/commands/phone/_modes/free.d.ts

@@ -0,0 +1,29 @@
+import type { LLMConfig, TTSConfig, ASRConfig } from '../../../api/types.js';
+export interface CallConfig {
+    mode: 'free' | 'translate' | 'agent';
+    toNumber: string;
+    fromNumber: string;
+    llm: Record<string, unknown>;
+    tts: Record<string, unknown>;
+    asr: Record<string, unknown>;
+    idleTimeout: number;
+    label: string;
+}
+export interface FreeCallParams {
+    toNumber: string;
+    fromNumber: string;
+    task?: string;
+    llm: Partial<LLMConfig>;
+    tts: Partial<TTSConfig>;
+    asr: Partial<ASRConfig>;
+}
+export declare function buildFreeCallConfig(params: FreeCallParams): CallConfig;
+/** Interactive parameter collection for free call mode. */
+export declare function collectFreeParams(opts: {
+    to?: string;
+    from?: string;
+    task?: string;
+}): Promise<{
+    toNumber: string;
+    task?: string;
+}>;

package/dist/src/commands/phone/_modes/free.js

@@ -0,0 +1,44 @@
+const DEFAULT_PROMPT = 'You are a helpful voice assistant. Keep responses concise and conversational.';
+export function buildFreeCallConfig(params) {
+    const systemMessage = params.task || DEFAULT_PROMPT;
+    return {
+        mode: 'free',
+        toNumber: params.toNumber,
+        fromNumber: params.fromNumber,
+        llm: {
+            ...params.llm,
+            system_messages: [{ role: 'system', content: systemMessage }],
+        },
+        tts: { ...params.tts },
+        asr: { ...params.asr },
+        idleTimeout: 600,
+        label: `📱 Free Call → ${params.toNumber}`,
+    };
+}
+/** Interactive parameter collection for free call mode. */
+export async function collectFreeParams(opts) {
+    const { default: inquirer } = await import('inquirer');
+    const { validateE164 } = await import('../_helpers.js');
+    let toNumber = opts.to;
+    if (!toNumber) {
+        const ans = await inquirer.prompt([{
+                type: 'input',
+                name: 'to',
+                message: 'Phone number to call (E.164):',
+                validate: (v) => /^\+[1-9]\d{1,14}$/.test(v.trim()) || 'Invalid E.164 format',
+            }]);
+        toNumber = ans.to;
+    }
+    toNumber = validateE164(toNumber);
+    let task = opts.task;
+    if (task === undefined) {
+        const ans = await inquirer.prompt([{
+                type: 'input',
+                name: 'task',
+                message: 'Anything to tell the agent? (optional):',
+            }]);
+        task = ans.task || undefined;
+    }
+    return { toNumber, task }; // fromNumber resolved by caller
+}
+//# sourceMappingURL=free.js.map

package/dist/src/commands/phone/_modes/free.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"free.js","sourceRoot":"","sources":["../../../../../src/commands/phone/_modes/free.ts"],"names":[],"mappings":"AAsBA,MAAM,cAAc,GAAG,+EAA+E,CAAC;AAEvG,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC;IAEpD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,GAAG,EAAE;YACH,GAAG,MAAM,CAAC,GAAG;YACb,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;SAC9D;QACD,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE;QACtB,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE;QACtB,WAAW,EAAE,GAAG;QAChB,KAAK,EAAE,kBAAkB,MAAM,CAAC,QAAQ,EAAE;KAC3C,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAIvC;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAExD,IAAI,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;IACvB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,+BAA+B;gBACxC,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,sBAAsB;aACtF,CAAC,CAAC,CAAC;QACJ,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC;IACpB,CAAC;IACD,QAAQ,GAAG,YAAY,CAAC,QAAS,CAAC,CAAC;IAEnC,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACrB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAC,CAAC;QACJ,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,gCAAgC;AAC7D,CAAC"}

package/dist/src/commands/phone/_modes/translate.d.ts

@@ -0,0 +1,30 @@
+import type { LLMConfig, TTSConfig, ASRConfig } from '../../../api/types.js';
+import type { CallConfig } from './free.js';
+export declare const SUPPORTED_LANGUAGES: {
+    value: string;
+    name: string;
+}[];
+export interface TranslateCallParams {
+    toNumber: string;
+    fromNumber: string;
+    sourceLang: string;
+    targetLang: string;
+    llm: Partial<LLMConfig>;
+    tts: Partial<TTSConfig>;
+    asr: Partial<ASRConfig>;
+}
+/** Parse a "source:target" language pair string. */
+export declare function parseLanguagePair(pair: string): {
+    source: string;
+    target: string;
+};
+export declare function buildTranslateCallConfig(params: TranslateCallParams): CallConfig;
+/** Interactive parameter collection for translate mode. */
+export declare function collectTranslateParams(opts: {
+    to?: string;
+    lang?: string;
+}): Promise<{
+    toNumber: string;
+    sourceLang: string;
+    targetLang: string;
+}>;

package/dist/src/commands/phone/_modes/translate.js

@@ -0,0 +1,89 @@
+export const SUPPORTED_LANGUAGES = [
+    { value: 'zh', name: 'Chinese (中文)' },
+    { value: 'en', name: 'English' },
+    { value: 'ja', name: 'Japanese (日本語)' },
+    { value: 'ko', name: 'Korean (한국어)' },
+    { value: 'es', name: 'Spanish (Español)' },
+    { value: 'fr', name: 'French (Français)' },
+    { value: 'de', name: 'German (Deutsch)' },
+    { value: 'pt', name: 'Portuguese (Português)' },
+    { value: 'ru', name: 'Russian (Русский)' },
+    { value: 'ar', name: 'Arabic (العربية)' },
+    { value: 'hi', name: 'Hindi (हिन्दी)' },
+    { value: 'th', name: 'Thai (ไทย)' },
+    { value: 'vi', name: 'Vietnamese (Tiếng Việt)' },
+    { value: 'it', name: 'Italian (Italiano)' },
+    { value: 'tr', name: 'Turkish (Türkçe)' },
+    { value: 'id', name: 'Indonesian (Bahasa)' },
+];
+/** Parse a "source:target" language pair string. */
+export function parseLanguagePair(pair) {
+    const parts = pair.split(':');
+    if (parts.length !== 2 || !parts[0].trim() || !parts[1].trim()) {
+        throw new Error(`Invalid language pair "${pair}". Use format: zh:ja`);
+    }
+    return { source: parts[0].trim(), target: parts[1].trim() };
+}
+export function buildTranslateCallConfig(params) {
+    const translationPrompt = `You are a real-time voice translator. ` +
+        `The caller speaks ${params.sourceLang}. The person on the other end speaks ${params.targetLang}. ` +
+        `Translate everything the caller says into ${params.targetLang}, and everything the other person says into ${params.sourceLang}. ` +
+        `Translate naturally and conversationally. Do not add commentary, just translate. ` +
+        `Preserve tone and intent.`;
+    return {
+        mode: 'translate',
+        toNumber: params.toNumber,
+        fromNumber: params.fromNumber,
+        llm: {
+            ...params.llm,
+            system_messages: [{ role: 'system', content: translationPrompt }],
+        },
+        tts: { ...params.tts },
+        asr: { ...params.asr },
+        idleTimeout: 1800,
+        label: `🌐 Translate [${params.sourceLang} → ${params.targetLang}] → ${params.toNumber}`,
+    };
+}
+/** Interactive parameter collection for translate mode. */
+export async function collectTranslateParams(opts) {
+    const { default: inquirer } = await import('inquirer');
+    const { validateE164 } = await import('../_helpers.js');
+    let sourceLang;
+    let targetLang;
+    if (opts.lang) {
+        const parsed = parseLanguagePair(opts.lang);
+        sourceLang = parsed.source;
+        targetLang = parsed.target;
+    }
+    else {
+        const langAns = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'source',
+                message: 'Your language:',
+                choices: SUPPORTED_LANGUAGES,
+            },
+            {
+                type: 'list',
+                name: 'target',
+                message: 'Target language:',
+                choices: SUPPORTED_LANGUAGES,
+            },
+        ]);
+        sourceLang = langAns.source;
+        targetLang = langAns.target;
+    }
+    let toNumber = opts.to;
+    if (!toNumber) {
+        const ans = await inquirer.prompt([{
+                type: 'input',
+                name: 'to',
+                message: 'Phone number to call (E.164):',
+                validate: (v) => /^\+[1-9]\d{1,14}$/.test(v.trim()) || 'Invalid E.164 format',
+            }]);
+        toNumber = ans.to;
+    }
+    toNumber = validateE164(toNumber);
+    return { toNumber, sourceLang, targetLang };
+}
+//# sourceMappingURL=translate.js.map

package/dist/src/commands/phone/_modes/translate.js.map

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

package/dist/src/commands/phone/get.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPhoneGet(phone: Command): void;

package/dist/src/commands/phone/get.js

@@ -0,0 +1,34 @@
+import { getNumberAPI } from './_helpers.js';
+import { printKeyValue } from '../../ui/table.js';
+import { handleError } from '../../utils/errors.js';
+export function registerPhoneGet(phone) {
+    phone
+        .command('number <phone-number>')
+        .description('View phone number details')
+        .option('--profile <name>', 'Config profile')
+        .option('--json', 'JSON output')
+        .action(async (phoneNumber, opts) => {
+        try {
+            const api = getNumberAPI(opts.profile);
+            const num = await api.get(phoneNumber);
+            if (opts.json) {
+                console.log(JSON.stringify(num, null, 2));
+                return;
+            }
+            console.log('');
+            printKeyValue([
+                ['Phone', num.phone_number],
+                ['Label', num.label],
+                ['Provider', num.provider],
+                ['Outbound', num.outbound ? 'yes' : 'no'],
+                ['Inbound', num.inbound ? 'yes' : 'no'],
+                ['SIP', num.outbound_config ? `${num.outbound_config.address} (${num.outbound_config.transport})` : '-'],
+                ['Pipeline', num.associated_pipeline?.pipeline_name ?? '(none)'],
+            ]);
+        }
+        catch (error) {
+            handleError(error, { json: opts.json });
+        }
+    });
+}
+//# sourceMappingURL=get.js.map

package/dist/src/commands/phone/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../src/commands/phone/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,KAAK;SACF,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAEvC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1C,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,aAAa,CAAC;gBACZ,CAAC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC;gBAC3B,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC;gBACpB,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC;gBAC1B,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzC,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;gBACvC,CAAC,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,KAAK,GAAG,CAAC,eAAe,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBACxG,CAAC,UAAU,EAAE,GAAG,CAAC,mBAAmB,EAAE,aAAa,IAAI,QAAQ,CAAC;aACjE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/commands/phone/go.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPhoneGo(phone: Command): void;