convoai 1.0.0

package/dist/src/presets/defaults.js

@@ -0,0 +1,195 @@
+// ─── Built-In Presets ───────────────────────────────────────────────────────
+export const PRESETS = {
+    'openai-gpt4o': {
+        description: 'OpenAI GPT-4o with Microsoft TTS and Deepgram ASR',
+        llm: 'OpenAI GPT-4o',
+        tts: 'Microsoft TTS',
+        asr: 'Deepgram',
+        properties: {
+            llm: {
+                vendor: 'openai',
+                model: 'gpt-4o',
+                style: 'openai',
+                system_messages: [
+                    {
+                        role: 'system',
+                        content: 'You are a helpful voice assistant. Keep responses concise and conversational.',
+                    },
+                ],
+                max_history: 20,
+                params: {
+                    temperature: 0.7,
+                    max_tokens: 512,
+                },
+            },
+            tts: {
+                vendor: 'microsoft',
+                params: {
+                    voice_name: 'en-US-AndrewMultilingualNeural',
+                    speed: 1.0,
+                },
+            },
+            asr: {
+                vendor: 'deepgram',
+                language: 'en-US',
+                params: {
+                    model: 'nova-2',
+                },
+            },
+        },
+    },
+    'openai-mini': {
+        description: 'OpenAI GPT-4o-mini with Microsoft TTS and Deepgram ASR',
+        llm: 'OpenAI GPT-4o-mini',
+        tts: 'Microsoft TTS',
+        asr: 'Deepgram',
+        properties: {
+            llm: {
+                vendor: 'openai',
+                model: 'gpt-4o-mini',
+                style: 'openai',
+                system_messages: [
+                    {
+                        role: 'system',
+                        content: 'You are a helpful voice assistant. Keep responses concise and conversational.',
+                    },
+                ],
+                max_history: 20,
+                params: {
+                    temperature: 0.7,
+                    max_tokens: 512,
+                },
+            },
+            tts: {
+                vendor: 'microsoft',
+                params: {
+                    voice_name: 'en-US-AndrewMultilingualNeural',
+                    speed: 1.0,
+                },
+            },
+            asr: {
+                vendor: 'deepgram',
+                language: 'en-US',
+                params: {
+                    model: 'nova-2',
+                },
+            },
+        },
+    },
+    'anthropic-claude': {
+        description: 'Anthropic Claude with Microsoft TTS and Deepgram ASR',
+        llm: 'Anthropic Claude',
+        tts: 'Microsoft TTS',
+        asr: 'Deepgram',
+        properties: {
+            llm: {
+                vendor: 'anthropic',
+                model: 'claude-sonnet-4-20250514',
+                style: 'anthropic',
+                system_messages: [
+                    {
+                        role: 'system',
+                        content: 'You are a helpful voice assistant. Keep responses concise and conversational.',
+                    },
+                ],
+                max_history: 20,
+                params: {
+                    temperature: 0.7,
+                    max_tokens: 512,
+                },
+            },
+            tts: {
+                vendor: 'microsoft',
+                params: {
+                    voice_name: 'en-US-AndrewMultilingualNeural',
+                    speed: 1.0,
+                },
+            },
+            asr: {
+                vendor: 'deepgram',
+                language: 'en-US',
+                params: {
+                    model: 'nova-2',
+                },
+            },
+        },
+    },
+    gemini: {
+        description: 'Google Gemini with Microsoft TTS and Deepgram ASR',
+        llm: 'Google Gemini',
+        tts: 'Microsoft TTS',
+        asr: 'Deepgram',
+        properties: {
+            llm: {
+                vendor: 'google',
+                model: 'gemini-2.0-flash',
+                style: 'gemini',
+                system_messages: [
+                    {
+                        role: 'system',
+                        content: 'You are a helpful voice assistant. Keep responses concise and conversational.',
+                    },
+                ],
+                max_history: 20,
+                params: {
+                    temperature: 0.7,
+                    max_tokens: 512,
+                },
+            },
+            tts: {
+                vendor: 'microsoft',
+                params: {
+                    voice_name: 'en-US-AndrewMultilingualNeural',
+                    speed: 1.0,
+                },
+            },
+            asr: {
+                vendor: 'deepgram',
+                language: 'en-US',
+                params: {
+                    model: 'nova-2',
+                },
+            },
+        },
+    },
+    'realtime-openai': {
+        description: 'OpenAI Realtime API (multimodal LLM mode)',
+        llm: 'OpenAI Realtime',
+        tts: 'Built-in (MLLM)',
+        asr: 'Built-in (MLLM)',
+        properties: {
+            llm: {
+                vendor: 'openai',
+                model: 'gpt-4o-realtime-preview',
+                style: 'openai',
+                input_modalities: ['text', 'audio'],
+                output_modalities: ['text', 'audio'],
+                system_messages: [
+                    {
+                        role: 'system',
+                        content: 'You are a helpful voice assistant. Keep responses concise and conversational.',
+                    },
+                ],
+            },
+            advanced_features: {
+                enable_mllm: true,
+            },
+        },
+    },
+};
+// ─── Public Helpers ─────────────────────────────────────────────────────────
+/** Look up a preset by name. Returns undefined if not found. */
+export function getPreset(name) {
+    return PRESETS[name]?.properties;
+}
+/** List all available presets with their metadata. */
+export function listPresets() {
+    return Object.entries(PRESETS).map(([name, info]) => ({
+        name,
+        description: info.description,
+        llm: info.llm,
+        tts: info.tts,
+        asr: info.asr,
+    }));
+}
+//# sourceMappingURL=defaults.js.map

package/dist/src/presets/defaults.js.map

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

package/dist/src/providers/catalog.d.ts

@@ -0,0 +1,103 @@
+export interface LLMProvider {
+    name: string;
+    value: string;
+    url: string;
+    defaultModel: string;
+    models: string[];
+    style?: 'anthropic' | 'gemini';
+    headers?: string;
+    urlHasKey?: boolean;
+    note?: string;
+}
+export declare const LLM_PROVIDERS: LLMProvider[];
+export interface TTSProvider {
+    name: string;
+    vendor: string;
+    requiresKey: boolean;
+    requiresRegion?: boolean;
+    defaultVoice?: string;
+    beta?: boolean;
+    note?: string;
+}
+export declare const TTS_PROVIDERS: TTSProvider[];
+export interface ASRProvider {
+    name: string;
+    vendor: string;
+    requiresKey: boolean;
+    beta?: boolean;
+    note?: string;
+}
+export declare const ASR_PROVIDERS: ASRProvider[];
+export declare const ASR_LANGUAGES: readonly [{
+    readonly name: "Chinese (中文)";
+    readonly value: "zh-CN";
+}, {
+    readonly name: "English (US)";
+    readonly value: "en-US";
+}, {
+    readonly name: "Japanese (日本語)";
+    readonly value: "ja-JP";
+}, {
+    readonly name: "Korean (한국어)";
+    readonly value: "ko-KR";
+}, {
+    readonly name: "French";
+    readonly value: "fr-FR";
+}, {
+    readonly name: "German";
+    readonly value: "de-DE";
+}, {
+    readonly name: "Spanish";
+    readonly value: "es-ES";
+}, {
+    readonly name: "Russian";
+    readonly value: "ru-RU";
+}, {
+    readonly name: "Hindi";
+    readonly value: "hi-IN";
+}, {
+    readonly name: "Arabic";
+    readonly value: "ar-SA";
+}, {
+    readonly name: "Portuguese";
+    readonly value: "pt-PT";
+}, {
+    readonly name: "Italian";
+    readonly value: "it-IT";
+}, {
+    readonly name: "Thai";
+    readonly value: "th-TH";
+}, {
+    readonly name: "Turkish";
+    readonly value: "tr-TR";
+}, {
+    readonly name: "Vietnamese";
+    readonly value: "vi-VN";
+}, {
+    readonly name: "Indonesian";
+    readonly value: "id-ID";
+}, {
+    readonly name: "Malay";
+    readonly value: "ms-MY";
+}, {
+    readonly name: "Dutch";
+    readonly value: "nl-NL";
+}, {
+    readonly name: "Filipino";
+    readonly value: "fil-PH";
+}, {
+    readonly name: "Chinese (Hong Kong)";
+    readonly value: "zh-HK";
+}, {
+    readonly name: "Chinese (Taiwan)";
+    readonly value: "zh-TW";
+}, {
+    readonly name: "English (India)";
+    readonly value: "en-IN";
+}, {
+    readonly name: "Persian";
+    readonly value: "fa-IR";
+}, {
+    readonly name: "Hebrew";
+    readonly value: "he-IL";
+}];

package/dist/src/providers/catalog.js

@@ -0,0 +1,247 @@
+// Provider catalog — single source of truth for all supported providers.
+export const LLM_PROVIDERS = [
+    {
+        name: 'Alibaba Qwen',
+        value: 'dashscope',
+        url: 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions',
+        defaultModel: 'qwen-plus',
+        models: ['qwen-plus', 'qwen-turbo', 'qwen-max', 'qwen-long'],
+        note: 'China-optimized, no proxy needed',
+    },
+    {
+        name: 'DeepSeek',
+        value: 'deepseek',
+        url: 'https://api.deepseek.com/v1/chat/completions',
+        defaultModel: 'deepseek-chat',
+        models: ['deepseek-chat', 'deepseek-reasoner'],
+        note: 'China-optimized, great price-performance',
+    },
+    {
+        name: 'OpenAI',
+        value: 'openai',
+        url: 'https://api.openai.com/v1/chat/completions',
+        defaultModel: 'gpt-4o-mini',
+        models: ['gpt-4o-mini', 'gpt-4o', 'gpt-4.1-mini', 'gpt-4.1'],
+        note: 'Requires proxy in China',
+    },
+    {
+        name: 'Groq',
+        value: 'groq',
+        url: 'https://api.groq.com/openai/v1/chat/completions',
+        defaultModel: 'llama-3.3-70b-versatile',
+        models: [
+            'llama-3.3-70b-versatile',
+            'llama-3.1-8b-instant',
+            'mixtral-8x7b-32768',
+        ],
+        note: 'Fast inference, free tier available',
+    },
+    {
+        name: 'Anthropic Claude',
+        value: 'anthropic',
+        url: 'https://api.anthropic.com/v1/messages',
+        defaultModel: 'claude-3-5-haiku-latest',
+        models: ['claude-3-5-haiku-latest', 'claude-sonnet-4-20250514'],
+        style: 'anthropic',
+        headers: '{"anthropic-version":"2023-06-01"}',
+    },
+    {
+        name: 'Google Gemini',
+        value: 'gemini',
+        url: 'https://generativelanguage.googleapis.com/v1beta/models/{model}:streamGenerateContent?alt=sse&key={api_key}',
+        defaultModel: 'gemini-2.0-flash',
+        models: ['gemini-2.0-flash', 'gemini-2.5-flash', 'gemini-2.5-pro'],
+        style: 'gemini',
+        urlHasKey: true,
+    },
+    {
+        name: 'Azure OpenAI',
+        value: 'azure',
+        url: '',
+        defaultModel: 'gpt-4o-mini',
+        models: ['gpt-4o-mini', 'gpt-4o'],
+        note: 'Enter your Azure endpoint URL',
+    },
+    {
+        name: 'Amazon Bedrock',
+        value: 'bedrock',
+        url: '',
+        defaultModel: '',
+        models: [],
+        note: 'Enter your Bedrock endpoint URL',
+    },
+    {
+        name: 'Dify',
+        value: 'dify',
+        url: '',
+        defaultModel: '',
+        models: [],
+        note: 'Enter your Dify endpoint URL',
+    },
+    {
+        name: 'Custom',
+        value: 'custom',
+        url: '',
+        defaultModel: '',
+        models: [],
+        note: 'Any service with OpenAI-compatible API',
+    },
+];
+export const TTS_PROVIDERS = [
+    {
+        name: 'ElevenLabs',
+        vendor: 'elevenlabs',
+        requiresKey: true,
+        note: 'High quality, multilingual',
+    },
+    {
+        name: 'Microsoft Azure',
+        vendor: 'microsoft',
+        requiresKey: true,
+        requiresRegion: true,
+        defaultVoice: 'en-US-AndrewMultilingualNeural',
+        note: 'Wide language support',
+    },
+    {
+        name: 'MiniMax',
+        vendor: 'minimax',
+        requiresKey: true,
+    },
+    {
+        name: 'OpenAI TTS',
+        vendor: 'openai',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Cartesia',
+        vendor: 'cartesia',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Hume AI',
+        vendor: 'humeai',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Rime',
+        vendor: 'rime',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Fish Audio',
+        vendor: 'fishaudio',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Google TTS',
+        vendor: 'google',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Amazon Polly',
+        vendor: 'amazon',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Murf',
+        vendor: 'murf',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Sarvam',
+        vendor: 'sarvam',
+        requiresKey: true,
+        beta: true,
+    },
+];
+export const ASR_PROVIDERS = [
+    {
+        name: 'ARES',
+        vendor: 'ares',
+        requiresKey: false,
+        note: 'Agora built-in, no extra API key needed',
+    },
+    {
+        name: 'Microsoft Azure',
+        vendor: 'microsoft',
+        requiresKey: true,
+    },
+    {
+        name: 'Deepgram',
+        vendor: 'deepgram',
+        requiresKey: true,
+    },
+    {
+        name: 'OpenAI Whisper',
+        vendor: 'openai',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Speechmatics',
+        vendor: 'speechmatics',
+        requiresKey: true,
+    },
+    {
+        name: 'AssemblyAI',
+        vendor: 'assemblyai',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Amazon Transcribe',
+        vendor: 'amazon',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Google STT',
+        vendor: 'google',
+        requiresKey: true,
+        beta: true,
+    },
+    {
+        name: 'Sarvam',
+        vendor: 'sarvam',
+        requiresKey: true,
+        beta: true,
+    },
+];
+// ---------------------------------------------------------------------------
+// ASR Languages (ARES supported)
+// ---------------------------------------------------------------------------
+export const ASR_LANGUAGES = [
+    { name: 'Chinese (\u4e2d\u6587)', value: 'zh-CN' },
+    { name: 'English (US)', value: 'en-US' },
+    { name: 'Japanese (\u65e5\u672c\u8a9e)', value: 'ja-JP' },
+    { name: 'Korean (\ud55c\uad6d\uc5b4)', value: 'ko-KR' },
+    { name: 'French', value: 'fr-FR' },
+    { name: 'German', value: 'de-DE' },
+    { name: 'Spanish', value: 'es-ES' },
+    { name: 'Russian', value: 'ru-RU' },
+    { name: 'Hindi', value: 'hi-IN' },
+    { name: 'Arabic', value: 'ar-SA' },
+    { name: 'Portuguese', value: 'pt-PT' },
+    { name: 'Italian', value: 'it-IT' },
+    { name: 'Thai', value: 'th-TH' },
+    { name: 'Turkish', value: 'tr-TR' },
+    { name: 'Vietnamese', value: 'vi-VN' },
+    { name: 'Indonesian', value: 'id-ID' },
+    { name: 'Malay', value: 'ms-MY' },
+    { name: 'Dutch', value: 'nl-NL' },
+    { name: 'Filipino', value: 'fil-PH' },
+    { name: 'Chinese (Hong Kong)', value: 'zh-HK' },
+    { name: 'Chinese (Taiwan)', value: 'zh-TW' },
+    { name: 'English (India)', value: 'en-IN' },
+    { name: 'Persian', value: 'fa-IR' },
+    { name: 'Hebrew', value: 'he-IL' },
+];
+//# sourceMappingURL=catalog.js.map

package/dist/src/providers/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/providers/catalog.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAkBzE,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,WAAW;QAClB,GAAG,EAAE,oEAAoE;QACzE,YAAY,EAAE,WAAW;QACzB,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,CAAC;QAC5D,IAAI,EAAE,kCAAkC;KACzC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,8CAA8C;QACnD,YAAY,EAAE,eAAe;QAC7B,MAAM,EAAE,CAAC,eAAe,EAAE,mBAAmB,CAAC;QAC9C,IAAI,EAAE,0CAA0C;KACjD;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,4CAA4C;QACjD,YAAY,EAAE,aAAa;QAC3B,MAAM,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,CAAC;QAC5D,IAAI,EAAE,yBAAyB;KAChC;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,iDAAiD;QACtD,YAAY,EAAE,yBAAyB;QACvC,MAAM,EAAE;YACN,yBAAyB;YACzB,sBAAsB;YACtB,oBAAoB;SACrB;QACD,IAAI,EAAE,qCAAqC;KAC5C;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,WAAW;QAClB,GAAG,EAAE,uCAAuC;QAC5C,YAAY,EAAE,yBAAyB;QACvC,MAAM,EAAE,CAAC,yBAAyB,EAAE,0BAA0B,CAAC;QAC/D,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,oCAAoC;KAC9C;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,6GAA6G;QAClH,YAAY,EAAE,kBAAkB;QAChC,MAAM,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,CAAC;QAClE,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,IAAI;KAChB;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,EAAE;QACP,YAAY,EAAE,aAAa;QAC3B,MAAM,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;QACjC,IAAI,EAAE,+BAA+B;KACtC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE;QACP,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,iCAAiC;KACxC;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,EAAE;QACP,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,8BAA8B;KACrC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,EAAE;QACP,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,wCAAwC;KAC/C;CACF,CAAC;AAgBF,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,4BAA4B;KACnC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,gCAAgC;QAC9C,IAAI,EAAE,uBAAuB;KAC9B;IACD;QACE,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;CACF,CAAC;AAcF,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C;QACE,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,KAAK;QAClB,IAAI,EAAE,yCAAyC;KAChD;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,cAAc;QACtB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,IAAI;KACX;CACF,CAAC;AAEF,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE;IAClD,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE;IACxC,EAAE,IAAI,EAAE,+BAA+B,EAAE,KAAK,EAAE,OAAO,EAAE;IACzD,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,OAAO,EAAE;IACvD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE;IACnC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE;IACnC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IACjC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE;IACtC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE;IACnC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;IAChC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE;IACnC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE;IACtC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE;IACtC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IACjC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IACjC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE;IACrC,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE;IAC/C,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE;IAC5C,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE;IAC3C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE;IACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;CAC1B,CAAC"}

package/dist/src/templates/manager.d.ts

@@ -0,0 +1,24 @@
+import type { AgentProperties } from '../api/types.js';
+export declare const SAFE_NAME_PATTERN: RegExp;
+export interface AgentTemplate {
+    name: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+    properties: Partial<AgentProperties>;
+}
+/**
+ * Returns the templates directory path and ensures it exists.
+ * Templates are stored at ~/.config/convoai/templates/
+ */
+export declare function getTemplatesDir(): string;
+/** List all saved templates, sorted by name. */
+export declare function listTemplates(): AgentTemplate[];
+/** Load a template by name. Returns null if not found or unreadable. */
+export declare function loadTemplate(name: string): AgentTemplate | null;
+/** Save a template to disk. Overwrites any existing file with the same name. */
+export declare function saveTemplate(template: AgentTemplate): void;
+/** Delete a template by name. Returns true if the file was deleted, false if it did not exist. */
+export declare function deleteTemplate(name: string): boolean;
+/** Check whether a template with the given name exists on disk. */
+export declare function templateExists(name: string): boolean;

package/dist/src/templates/manager.js

@@ -0,0 +1,77 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfigDir } from '../config/paths.js';
+// ─── Validation ─────────────────────────────────────────────────────────────
+export const SAFE_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+function validateTemplateName(name) {
+    if (!SAFE_NAME_PATTERN.test(name) || name.includes('..')) {
+        throw new Error(`Invalid template name "${name}". Use only letters, numbers, hyphens, and underscores.`);
+    }
+}
+// ─── Directory ──────────────────────────────────────────────────────────────
+const TEMPLATES_DIR_NAME = 'templates';
+/**
+ * Returns the templates directory path and ensures it exists.
+ * Templates are stored at ~/.config/convoai/templates/
+ */
+export function getTemplatesDir() {
+    const dir = join(getConfigDir(), TEMPLATES_DIR_NAME);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+// ─── CRUD Operations ────────────────────────────────────────────────────────
+/** List all saved templates, sorted by name. */
+export function listTemplates() {
+    const dir = getTemplatesDir();
+    const files = readdirSync(dir).filter((f) => f.endsWith('.json'));
+    const templates = [];
+    for (const file of files) {
+        try {
+            const raw = readFileSync(join(dir, file), 'utf-8');
+            const template = JSON.parse(raw);
+            templates.push(template);
+        }
+        catch {
+            // Skip malformed template files
+        }
+    }
+    return templates.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Load a template by name. Returns null if not found or unreadable. */
+export function loadTemplate(name) {
+    validateTemplateName(name);
+    const filePath = join(getTemplatesDir(), `${name}.json`);
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Save a template to disk. Overwrites any existing file with the same name. */
+export function saveTemplate(template) {
+    validateTemplateName(template.name);
+    const filePath = join(getTemplatesDir(), `${template.name}.json`);
+    writeFileSync(filePath, JSON.stringify(template, null, 2) + '\n', 'utf-8');
+}
+/** Delete a template by name. Returns true if the file was deleted, false if it did not exist. */
+export function deleteTemplate(name) {
+    validateTemplateName(name);
+    const filePath = join(getTemplatesDir(), `${name}.json`);
+    if (!existsSync(filePath)) {
+        return false;
+    }
+    unlinkSync(filePath);
+    return true;
+}
+/** Check whether a template with the given name exists on disk. */
+export function templateExists(name) {
+    validateTemplateName(name);
+    const filePath = join(getTemplatesDir(), `${name}.json`);
+    return existsSync(filePath);
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/templates/manager.js.map

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

package/dist/src/ui/colors.d.ts

@@ -0,0 +1,9 @@
+import type { AgentStatus } from '../api/types.js';
+/** Colorize an agent status string for terminal display. */
+export declare function colorStatus(status: AgentStatus): string;
+export declare function dim(text: string): string;
+export declare function bold(text: string): string;
+export declare function success(text: string): string;
+export declare function error(text: string): string;
+export declare function warn(text: string): string;
+export declare function info(text: string): string;