convoai 1.0.5 → 1.0.7

package/dist/src/commands/agent/start.js

@@ -202,7 +202,7 @@ export function registerAgentStart(program) {
                 ['Channel', channel],
                 ['Created', formatTimestamp(result.create_ts)],
             ]);
-            printHint(hintAfterStart(result.agent_id));
+            printHint(hintAfterStart(result.agent_id, channel));
         }
         catch (error) {
             handleError(error, { json: opts.json });

package/dist/src/commands/agent/start.js.map

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

package/dist/src/utils/errors.d.ts

@@ -3,7 +3,11 @@
  */
 export declare function formatApiError(error: unknown): string;
 /**
- * Format an error, print to stderr, and exit with code 1.
+ * Get repair hints for an error (for display after the error message).
+ */
+export declare function getErrorHints(error: unknown): string[];
+/**
+ * Format an error, print to stderr with hints, and exit with code 1.
  * In JSON mode, outputs a structured error object instead.
  */
 export declare function handleError(error: unknown, options?: {

package/dist/src/utils/errors.js

@@ -1,5 +1,127 @@
 import { AxiosError } from 'axios';
 import chalk from 'chalk';
+function diagnose(status, detail, code) {
+    const d = detail.toLowerCase();
+    // ── Network errors (no HTTP status) ────────────────────────────────────
+    if (!status) {
+        if (code === 'ECONNREFUSED' || code === 'ENOTFOUND') {
+            return {
+                message: `Cannot reach the Agora API (${code})`,
+                hints: [
+                    'Check your internet connection.',
+                    'If you are in China, make sure region is set to "cn": `convoai config set region cn`',
+                ],
+            };
+        }
+        if (code === 'ECONNABORTED' || d.includes('timeout')) {
+            return {
+                message: 'Request timed out',
+                hints: [
+                    'The Agora API is not responding. Try again in a moment.',
+                    'If you are in China, ensure region is "cn": `convoai config set region cn`',
+                    'Check your network connection.',
+                ],
+            };
+        }
+        return { message: `Network error: ${detail}`, hints: [] };
+    }
+    // ── 401 Unauthorized ───────────────────────────────────────────────────
+    if (status === 401) {
+        return {
+            message: 'Authentication failed (401)',
+            hints: [
+                'Your Customer ID or Customer Secret is incorrect.',
+                'Get them from your Agora/Shengwang console → Developer Toolkit → RESTful API.',
+                'Run `convoai config init` to reconfigure.',
+            ],
+        };
+    }
+    // ── 403 Forbidden ──────────────────────────────────────────────────────
+    if (status === 403) {
+        return {
+            message: 'Access forbidden (403)',
+            hints: [
+                'Your account may not have ConvoAI enabled.',
+                'Check that ConvoAI is activated in your Agora/Shengwang console.',
+                'Verify your App ID is correct: `convoai config show`',
+            ],
+        };
+    }
+    // ── 400 Bad Request — detailed diagnosis ───────────────────────────────
+    if (status === 400) {
+        if (d.includes('appid') || d.includes('allocate failed')) {
+            return {
+                message: 'Invalid App ID or region mismatch',
+                hints: [
+                    'Your App ID may not match the selected region.',
+                    'China projects → region must be "cn". Global projects → region must be "global".',
+                    'Check: `convoai config show`',
+                    'Fix: `convoai config set region cn` or `convoai config set region global`',
+                ],
+            };
+        }
+        if (d.includes('invalid literal') && d.includes('agent')) {
+            return {
+                message: 'Invalid agent RTC UID format',
+                hints: [
+                    'agent_rtc_uid must be a numeric string (e.g. "0" or "10001").',
+                    'Use --uid 0 for random assignment.',
+                ],
+            };
+        }
+        if (d.includes('edge failed') || d.includes('request failed')) {
+            return {
+                message: 'Agent failed to start — service provider error',
+                hints: [
+                    'Check your LLM, TTS, or ASR API keys are correct.',
+                    'For custom LLM: do NOT set vendor or style fields. Only use url, api_key, system_messages, params.',
+                    'Run `convoai config show` to review your configuration.',
+                    'Try `convoai agent start --channel test --dry-run` to inspect the request.',
+                ],
+            };
+        }
+        return {
+            message: `Bad request (400): ${detail}`,
+            hints: ['Run with --dry-run to inspect the request payload.'],
+        };
+    }
+    // ── 404 Not Found ──────────────────────────────────────────────────────
+    if (status === 404) {
+        if (d.includes('task not found') || d.includes('not found')) {
+            return {
+                message: 'Agent not found',
+                hints: [
+                    'The agent may have already stopped or the ID is incorrect.',
+                    'Run `convoai agent list --state all` to see all agents.',
+                ],
+            };
+        }
+        return { message: `Not found (404): ${detail}`, hints: [] };
+    }
+    // ── 429 Rate Limited ───────────────────────────────────────────────────
+    if (status === 429) {
+        return {
+            message: 'Rate limited (429)',
+            hints: [
+                'Too many requests. Wait a moment and try again.',
+                'The default limit is 20 concurrent agents per App ID.',
+            ],
+        };
+    }
+    // ── 5xx Server Error ───────────────────────────────────────────────────
+    if (status >= 500) {
+        return {
+            message: `Server error (${status}): ${detail}`,
+            hints: [
+                'The Agora ConvoAI service is experiencing issues.',
+                'Try again in a moment. If persistent, check https://status.agora.io',
+            ],
+        };
+    }
+    // ── Default ────────────────────────────────────────────────────────────
+    return { message: `API Error ${status}: ${detail}`, hints: [] };
+}
+// ─── Public API ─────────────────────────────────────────────────────────────
 /**
  * Extract a human-readable message from an API error.
  */
@@ -8,13 +130,8 @@ export function formatApiError(error) {
         const status = error.response?.status;
         const data = error.response?.data;
         const detail = data?.detail || data?.reason || error.message;
-        if (status) {
-            return `API Error ${status}: ${detail}`;
-        }
-        if (error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND') {
-            return `Network error: could not reach the API (${error.code})`;
-        }
-        return `Request failed: ${error.message}`;
+        const friendly = diagnose(status, detail, error.code);
+        return friendly.message;
     }
     if (error instanceof Error) {
         return error.message;
@@ -22,16 +139,44 @@ export function formatApiError(error) {
     return String(error);
 }
 /**
- * Format an error, print to stderr, and exit with code 1.
+ * Get repair hints for an error (for display after the error message).
+ */
+export function getErrorHints(error) {
+    if (error instanceof AxiosError) {
+        const status = error.response?.status;
+        const data = error.response?.data;
+        const detail = data?.detail || data?.reason || error.message;
+        return diagnose(status, detail, error.code).hints;
+    }
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        if (msg.includes('missing required credentials')) {
+            return ['Run `convoai config init` or `convoai auth login` to set up credentials.'];
+        }
+        if (msg.includes('app_certificate') || msg.includes('token generation')) {
+            return [
+                'RTC token generation requires an App Certificate.',
+                'Run `convoai config set app_certificate <your_certificate>` to configure.',
+            ];
+        }
+    }
+    return [];
+}
+/**
+ * Format an error, print to stderr with hints, and exit with code 1.
  * In JSON mode, outputs a structured error object instead.
  */
 export function handleError(error, options) {
     const message = formatApiError(error);
+    const hints = getErrorHints(error);
     if (options?.json) {
-        console.error(JSON.stringify({ error: message }, null, 2));
+        console.error(JSON.stringify({ error: message, hints }, null, 2));
     }
     else {
         console.error(`${chalk.red('\u2716')} ${message}`);
+        for (const hint of hints) {
+            console.error(`${chalk.dim('  → ')}${hint}`);
+        }
     }
     process.exit(1);
 }

package/dist/src/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAoC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;QAE7D,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,aAAa,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChE,OAAO,2CAA2C,KAAK,CAAC,IAAI,GAAG,CAAC;QAClE,CAAC;QACD,OAAO,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,OAA4B;IAE5B,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,MAAM,OAAO,CAAC;AAU1B,SAAS,QAAQ,CAAC,MAA0B,EAAE,MAAc,EAAE,IAAa;IACzE,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE/B,0EAA0E;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACpD,OAAO;gBACL,OAAO,EAAE,+BAA+B,IAAI,GAAG;gBAC/C,KAAK,EAAE;oBACL,iCAAiC;oBACjC,sFAAsF;iBACvF;aACF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,KAAK,cAAc,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE,mBAAmB;gBAC5B,KAAK,EAAE;oBACL,yDAAyD;oBACzD,4EAA4E;oBAC5E,gCAAgC;iBACjC;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,kBAAkB,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC5D,CAAC;IAED,0EAA0E;IAC1E,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,6BAA6B;YACtC,KAAK,EAAE;gBACL,mDAAmD;gBACnD,+EAA+E;gBAC/E,2CAA2C;aAC5C;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE;gBACL,4CAA4C;gBAC5C,kEAAkE;gBAClE,sDAAsD;aACvD;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,mCAAmC;gBAC5C,KAAK,EAAE;oBACL,gDAAgD;oBAChD,kFAAkF;oBAClF,8BAA8B;oBAC9B,2EAA2E;iBAC5E;aACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,8BAA8B;gBACvC,KAAK,EAAE;oBACL,+DAA+D;oBAC/D,oCAAoC;iBACrC;aACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC9D,OAAO;gBACL,OAAO,EAAE,gDAAgD;gBACzD,KAAK,EAAE;oBACL,mDAAmD;oBACnD,oGAAoG;oBACpG,yDAAyD;oBACzD,4EAA4E;iBAC7E;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,sBAAsB,MAAM,EAAE;YACvC,KAAK,EAAE,CAAC,oDAAoD,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,iBAAiB;gBAC1B,KAAK,EAAE;oBACL,4DAA4D;oBAC5D,yDAAyD;iBAC1D;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,oBAAoB,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,0EAA0E;IAC1E,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE;gBACL,iDAAiD;gBACjD,uDAAuD;aACxD;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,iBAAiB,MAAM,MAAM,MAAM,EAAE;YAC9C,KAAK,EAAE;gBACL,mDAAmD;gBACnD,qEAAqE;aACtE;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,OAAO,EAAE,OAAO,EAAE,aAAa,MAAM,KAAK,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAClE,CAAC;AAED,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAoC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;QAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAoC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;QAC7D,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;IACpD,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,0EAA0E,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxE,OAAO;gBACL,mDAAmD;gBACnD,2EAA2E;aAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,OAA4B;IAE5B,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/utils/hints.d.ts

@@ -1,6 +1,6 @@
 /** Display a truncated agent ID (first 12 characters). */
 export declare function shortId(id: string): string;
-export declare function hintAfterStart(agentId: string): string;
+export declare function hintAfterStart(agentId: string, channel?: string): string;
 export declare function hintAfterStop(): string;
 export declare function hintAfterLogin(): string;
 export declare function hintAfterList(): string;

package/dist/src/utils/hints.js

@@ -4,19 +4,24 @@ export function shortId(id) {
     return id.slice(0, 12);
 }
 // ─── Next-Step Hints ────────────────────────────────────────────────────────
-export function hintAfterStart(agentId) {
-    return `Run \`convoai agent status ${shortId(agentId)}\` to check status.`;
+export function hintAfterStart(agentId, channel) {
+    const lines = [];
+    lines.push(`Check status: convoai agent status ${agentId}`);
+    if (channel) {
+        lines.push(`Voice chat:   convoai agent join --channel ${channel}`);
+    }
+    return lines.join('\n      ');
 }
 export function hintAfterStop() {
-    return 'Run `convoai agent list` to see remaining agents.';
+    return 'Run convoai agent list to see remaining agents.';
 }
 export function hintAfterLogin() {
-    return 'Run `convoai agent start --channel <name>` to start your first agent.';
+    return 'Start a voice chat: convoai agent join --channel my-room';
 }
 export function hintAfterList() {
-    return 'Run `convoai agent status <id>` to inspect an agent.';
+    return 'Inspect: convoai agent status <id>  |  Voice chat: convoai agent join -c <channel>';
 }
 export function hintAfterHistory(agentId) {
-    return `Run \`convoai agent turns ${shortId(agentId)}\` to view turn-level latency.`;
+    return `View latency: convoai agent turns ${agentId}`;
 }
 //# sourceMappingURL=hints.js.map

package/dist/src/utils/hints.js.map

@@ -1 +1 @@
-{"version":3,"file":"hints.js","sourceRoot":"","sources":["../../../src/utils/hints.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,0DAA0D;AAC1D,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,8BAA8B,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,mDAAmD,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,uEAAuE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,sDAAsD,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,6BAA6B,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC;AACvF,CAAC"}
+{"version":3,"file":"hints.js","sourceRoot":"","sources":["../../../src/utils/hints.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,0DAA0D;AAC1D,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,OAAgB;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,8CAA8C,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,iDAAiD,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,0DAA0D,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,oFAAoF,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,qCAAqC,OAAO,EAAE,CAAC;AACxD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convoai",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "CLI for Agora ConvoAI Engine — start, manage, and monitor conversational AI agents",
   "type": "module",
   "bin": {