@indemn/cli 1.6.0 → 1.7.1

package/dist/sdk/voice.d.ts

@@ -0,0 +1,147 @@
+import type { IndemnClient } from './client.js';
+export interface VoiceSettingsInput {
+    provider: string;
+    voice_id: string;
+    name: string;
+    gender: string;
+    language: string;
+    countryCode: string;
+    model?: string;
+    settings?: {
+        speed?: number;
+    };
+    public_owner_id?: string;
+}
+interface PhoneConfig {
+    _id?: string;
+    phoneNumber?: string;
+    friendlyName?: string;
+    modelSettings?: Record<string, unknown>;
+    is_active?: boolean;
+    [key: string]: unknown;
+}
+/** A number offered for sale (Twilio's record, as voice-service returns it). */
+export interface AvailableNumber {
+    phoneNumber?: string;
+    friendlyName?: string;
+    locality?: string;
+    region?: string;
+    postalCode?: string;
+    isoCountry?: string;
+    capabilities?: Record<string, boolean>;
+    [key: string]: unknown;
+}
+/** +E.164 from what a person typed: "(331) 204-4919" or "331 204 4919" in the US/Canada, or "+44 20 ...". */
+export declare function toE164(input: string, country?: string): string;
+/**
+ * Voices, voice models, phone numbers and voice previews of agents.
+ * Several copilot voice routes do not check that the agent belongs to the
+ * caller's org, so every agent-level call here checks that first.
+ */
+export declare class VoiceSDK {
+    private client;
+    /**
+     * Numbers this session detached, by org and number, with their saved details. copilot's
+     * owned-numbers list can come back empty (its cached org id does not match the query), and a
+     * number just detached from an agent of the org is owned: re-attaching it never buys.
+     */
+    private detached;
+    constructor(client: IndemnClient);
+    private assertAgent;
+    /** Voices of a TTS provider (cartesia default, or elevenlabs), filterable. */
+    listVoices(opts?: {
+        provider?: string;
+        language?: string;
+        gender?: string;
+        q?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        data?: unknown[];
+        has_more?: boolean;
+        next_page?: unknown;
+    }>;
+    /** Allowed filter values (languages, genders, accents) of a provider. */
+    voiceFilters(provider: string): Promise<unknown>;
+    /**
+     * Speech sample of a voice (audio bytes). The platform only speaks Cartesia voices; for ElevenLabs the
+     * voice's own preview recording is used, as in the dashboard (it cannot say custom text).
+     */
+    playVoice(voiceId: string, text?: string, speed?: number, opts?: {
+        provider?: string;
+        name?: string;
+        language?: string;
+    }): Promise<{
+        contentType: string;
+        data: Buffer;
+    }>;
+    /** Speech-to-text or text-to-speech provider and model catalog. */
+    voiceModels(kind: 'stt' | 'tts'): Promise<unknown[]>;
+    /** Phone numbers attached to an agent, with their voice settings. */
+    agentNumbers(agentId: string): Promise<PhoneConfig[]>;
+    /** The agent's voice settings. Voice settings live on its phone number, so an agent without one has none. */
+    getAgentVoice(agentId: string): Promise<Record<string, unknown>>;
+    /**
+     * Set the text-to-speech voice of an agent. voice-service replaces the saved voice settings whole, so a
+     * speed that is not given keeps the saved one (the dashboard always sends it).
+     */
+    setAgentVoice(agentId: string, input: VoiceSettingsInput & Record<string, unknown>): Promise<unknown>;
+    /** Set the speech-to-text transcriber (provider, model, language, key terms) of an agent, as the dashboard does. */
+    setAgentTranscriber(agentId: string, stt: {
+        provider: string;
+        model: string;
+        language: string;
+        keyterms?: string[];
+    }): Promise<unknown>;
+    /** Numbers the org owns (is_active: attached to some agent). */
+    orgNumbers(): Promise<PhoneConfig[]>;
+    /**
+     * Attach a number the org already owns. Never buys one: copilot would buy a
+     * Twilio number for an unknown number, which costs money, so unknown numbers
+     * are refused here. Re-attaching resets the number's voice settings.
+     */
+    attachNumber(agentId: string, phoneNumber: string, type?: string): Promise<unknown>;
+    /**
+     * Numbers available to buy, as the dashboard's "Pick a new phone number" lists them (Twilio through
+     * voice-service). Free: nothing is bought. `contains` narrows to numbers containing those digits.
+     */
+    searchNumbers(opts?: {
+        areaCode?: string;
+        contains?: string;
+        country?: string;
+        tollFree?: boolean;
+        limit?: number;
+    }): Promise<AvailableNumber[]>;
+    /** The agent's phone number with its location and a summary of its voice settings. */
+    numberDetails(agentId: string): Promise<Record<string, unknown>>;
+    /**
+     * Buy a number and attach it to a voice agent, as the dashboard's "Pick a new phone number" does:
+     * copilot buys it from Twilio through voice-service. The org pays for it every month and it cannot be
+     * undone from here, so callers must have a person's confirmation of this exact number. The number is
+     * looked up again first so the purchase uses Twilio's current record.
+     */
+    buyNumber(agentId: string, number: string, opts?: {
+        country?: string;
+        tollFree?: boolean;
+    }): Promise<{
+        phone_number: string;
+        name?: string;
+        locality?: string;
+        region?: string;
+        agent: string;
+    }>;
+    /** Detach a number from an agent; the org keeps owning it. */
+    detachNumber(agentId: string, phoneNumber: string): Promise<unknown>;
+    /**
+     * A test voice call in the browser: a LiveKit room joined with the same
+     * attributes as the dashboard's web call, always marked as a test.
+     */
+    voicePreview(agentId: string): Promise<{
+        server_url: string;
+        room_name: string;
+        token: string;
+        join_url: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=voice.d.ts.map

package/dist/sdk/voice.d.ts.map

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

package/dist/sdk/voice.js

@@ -0,0 +1,236 @@
+import { randomBytes } from 'node:crypto';
+import { AgentsSDK } from './agents.js';
+import { CliError, EXIT } from '../core/runtime.js';
+const SEARCH_COUNTRIES = ['US', 'CA', 'GB', 'AU'];
+/** +E.164 from what a person typed: "(331) 204-4919" or "331 204 4919" in the US/Canada, or "+44 20 ...". */
+export function toE164(input, country = 'US') {
+    const digits = input.replace(/\D/g, '');
+    if (input.trim().startsWith('+'))
+        return `+${digits}`;
+    if ((country === 'US' || country === 'CA') && digits.length === 10)
+        return `+1${digits}`;
+    return `+${digits}`;
+}
+/** A Twilio-shaped call id, as the dashboard's web call sends it. */
+function callSid() {
+    return 'CA' + randomBytes(16).toString('hex').toUpperCase();
+}
+/**
+ * Voices, voice models, phone numbers and voice previews of agents.
+ * Several copilot voice routes do not check that the agent belongs to the
+ * caller's org, so every agent-level call here checks that first.
+ */
+export class VoiceSDK {
+    client;
+    /**
+     * Numbers this session detached, by org and number, with their saved details. copilot's
+     * owned-numbers list can come back empty (its cached org id does not match the query), and a
+     * number just detached from an agent of the org is owned: re-attaching it never buys.
+     */
+    detached = new Map();
+    constructor(client) {
+        this.client = client;
+    }
+    async assertAgent(agentId) {
+        const agent = await new AgentsSDK(this.client).getAgent(agentId).catch(() => undefined);
+        if (!agent)
+            throw new CliError(`Agent ${agentId} is not in the organization this command acts on.`);
+    }
+    /** Voices of a TTS provider (cartesia default, or elevenlabs), filterable. */
+    listVoices(opts = {}) {
+        const q = { provider: opts.provider ?? 'cartesia', limit: String(opts.limit ?? 50) };
+        if (opts.language)
+            q.language = opts.language;
+        if (opts.gender)
+            q.gender = opts.gender;
+        if (opts.q)
+            q.q = opts.q;
+        if (opts.cursor)
+            q.starting_after = opts.cursor;
+        return this.client.copilotGet('/voices', q);
+    }
+    /** Allowed filter values (languages, genders, accents) of a provider. */
+    voiceFilters(provider) {
+        return this.client.copilotGet(`/voices/settings/${provider}`, { service: 'tts' });
+    }
+    /**
+     * Speech sample of a voice (audio bytes). The platform only speaks Cartesia voices; for ElevenLabs the
+     * voice's own preview recording is used, as in the dashboard (it cannot say custom text).
+     */
+    async playVoice(voiceId, text, speed, opts = {}) {
+        if (opts.provider === 'elevenlabs') {
+            const found = await this.listVoices({ provider: 'elevenlabs', q: opts.name ?? voiceId, limit: 50 });
+            const url = found.data?.find((v) => v.voice_id === voiceId)?.preview_url;
+            if (!url)
+                throw new CliError(`No preview recording found for ElevenLabs voice ${opts.name ?? voiceId}.`);
+            const res = await fetch(url);
+            if (!res.ok)
+                throw new CliError(`Could not download the preview of ${opts.name ?? voiceId} (${res.status}).`);
+            return { contentType: res.headers.get('content-type') ?? 'audio/mpeg', data: Buffer.from(await res.arrayBuffer()) };
+        }
+        return this.client.copilotBinary('POST', '/voices/play', { voice_id: voiceId, ...(text ? { text } : {}), ...(speed ? { speed } : {}), ...(opts.language ? { language: opts.language } : {}) });
+    }
+    /** Speech-to-text or text-to-speech provider and model catalog. */
+    voiceModels(kind) {
+        return this.client.copilotGet('/organization/:org_id/ai-studio/voice-models', { kind });
+    }
+    /** Phone numbers attached to an agent, with their voice settings. */
+    async agentNumbers(agentId) {
+        await this.assertAgent(agentId);
+        return this.client.copilotGet(`/organization/:org_id/ai-studio/bots/${agentId}/configurations/voice/numbers`);
+    }
+    /** The agent's voice settings. Voice settings live on its phone number, so an agent without one has none. */
+    async getAgentVoice(agentId) {
+        const numbers = await this.agentNumbers(agentId);
+        if (!numbers.length)
+            throw new CliError(`Agent ${agentId} has no phone number, so it has no voice settings yet. Attach one with \`indemn agents numbers attach\`.`, EXIT.NEEDS_INPUT);
+        return (numbers[0].modelSettings ?? {});
+    }
+    /**
+     * Set the text-to-speech voice of an agent. voice-service replaces the saved voice settings whole, so a
+     * speed that is not given keeps the saved one (the dashboard always sends it).
+     */
+    async setAgentVoice(agentId, input) {
+        const current = await this.getAgentVoice(agentId); // fails clearly when there is no number
+        const body = { ...input, countryCode: input.countryCode.toLowerCase(), settings: { ...(current.tts?.settings ?? {}), ...(input.settings ?? {}) } };
+        return this.client.copilotPost(`/organization/:org_id/ai-studio/bots/${agentId}/voices`, body);
+    }
+    /** Set the speech-to-text transcriber (provider, model, language, key terms) of an agent, as the dashboard does. */
+    async setAgentTranscriber(agentId, stt) {
+        await this.getAgentVoice(agentId); // fails clearly when there is no number
+        const keyterms = (stt.keyterms ?? []).map((k) => k.trim()).filter(Boolean);
+        if (keyterms.length > 50 || keyterms.some((k) => k.length > 100))
+            throw new CliError('Up to 50 key terms of at most 100 characters each.', EXIT.NEEDS_INPUT);
+        return this.client.copilotPost(`/organization/:org_id/ai-studio/bots/${agentId}/voices`, {
+            stt: { provider: stt.provider, model: stt.model, language: stt.language, config: { keyterm: keyterms } },
+        });
+    }
+    /** Numbers the org owns (is_active: attached to some agent). */
+    orgNumbers() {
+        return this.client.copilotGet('/organization/:org_id/voice/configurations/numbers');
+    }
+    /**
+     * Attach a number the org already owns. Never buys one: copilot would buy a
+     * Twilio number for an unknown number, which costs money, so unknown numbers
+     * are refused here. Re-attaching resets the number's voice settings.
+     */
+    async attachNumber(agentId, phoneNumber, type = 'local') {
+        const agent = await new AgentsSDK(this.client).getAgent(agentId).catch(() => undefined);
+        if (!agent)
+            throw new CliError(`Agent ${agentId} is not in the organization this command acts on.`);
+        const channels = (agent.channels ?? []).map((c) => String(typeof c === 'string' ? c : c.type ?? '').toUpperCase());
+        if (!channels.includes('VOICE'))
+            throw new CliError(`"${agent.name}" does not answer the phone (no VOICE channel), so a number would not reach it.`);
+        const existing = await this.agentNumbers(agentId);
+        if (existing.length)
+            throw new CliError(`"${agent.name}" already has ${existing[0].phoneNumber}. Detach it first; an agent has one number.`);
+        const key = `${await this.client.currentOrgId()}:${phoneNumber}`;
+        const owned = (await this.orgNumbers()).find((n) => n.phoneNumber === phoneNumber) ?? this.detached.get(key);
+        if (!owned) {
+            throw new CliError(`${phoneNumber} is not a number this org owns. Buying numbers is not available from the CLI; buy it in the dashboard first.`);
+        }
+        if (owned.is_active)
+            throw new CliError(`${phoneNumber} is already attached to an agent. Detach it there first.`);
+        // copilot overwrites the number's details with what it is sent: send the saved ones back.
+        const result = await this.client.copilotPost(`/organization/:org_id/ai-studio/bots/${agentId}/configurations/voice/numbers`, {
+            type: typeof owned.type === 'string' ? owned.type : type, phoneNumber,
+            ...(owned.friendlyName ? { friendlyName: owned.friendlyName } : {}),
+            ...(owned.additionalDetails ? { payload: owned.additionalDetails } : {}),
+        });
+        this.detached.delete(key);
+        return result;
+    }
+    /**
+     * Numbers available to buy, as the dashboard's "Pick a new phone number" lists them (Twilio through
+     * voice-service). Free: nothing is bought. `contains` narrows to numbers containing those digits.
+     */
+    async searchNumbers(opts = {}) {
+        const country = (opts.country ?? 'US').toUpperCase();
+        if (!SEARCH_COUNTRIES.includes(country))
+            throw new CliError(`Numbers can be searched in ${SEARCH_COUNTRIES.join(', ')}.`, EXIT.NEEDS_INPUT);
+        const limit = Math.min(Math.max(opts.limit ?? 5, 1), 20);
+        const q = { countryCode: country, limit: String(limit) };
+        if (opts.areaCode)
+            q.areaCode = opts.areaCode.replace(/\D/g, '').slice(0, 3);
+        if (opts.contains)
+            q.pattern = opts.contains.replace(/\D/g, '');
+        const rows = await this.client.copilotGet(`/organization/:org_id/voice/configurations/numbers/${opts.tollFree ? 'toll-free' : 'local'}`, q);
+        return (rows ?? []).slice(0, limit);
+    }
+    /** The agent's phone number with its location and a summary of its voice settings. */
+    async numberDetails(agentId) {
+        const [num] = await this.agentNumbers(agentId);
+        if (!num)
+            throw new CliError(`Agent ${agentId} has no phone number. Find one with \`indemn agents numbers search\`.`, EXIT.NEEDS_INPUT);
+        const d = (num.additionalDetails ?? {});
+        const m = (num.modelSettings ?? {});
+        return {
+            phone_number: num.phoneNumber, name: num.friendlyName, type: num.type, country: num.isoCountry ?? d.isoCountry,
+            locality: d.locality, region: d.region, test_number: Boolean(num.isTestNumber),
+            voice: m.tts ? { provider: m.tts.provider, name: m.tts.name, speed: m.tts.settings?.speed } : undefined,
+            transcriber: m.stt ? { provider: m.stt.provider, model: m.stt.model, language: m.stt.language } : undefined,
+        };
+    }
+    /**
+     * Buy a number and attach it to a voice agent, as the dashboard's "Pick a new phone number" does:
+     * copilot buys it from Twilio through voice-service. The org pays for it every month and it cannot be
+     * undone from here, so callers must have a person's confirmation of this exact number. The number is
+     * looked up again first so the purchase uses Twilio's current record.
+     */
+    async buyNumber(agentId, number, opts = {}) {
+        const country = (opts.country ?? 'US').toUpperCase();
+        const phoneNumber = toE164(number, country);
+        const agent = await new AgentsSDK(this.client).getAgent(agentId).catch(() => undefined);
+        if (!agent)
+            throw new CliError(`Agent ${agentId} is not in the organization this command acts on.`);
+        const channels = (agent.channels ?? []).map((c) => String(typeof c === 'string' ? c : c.type ?? '').toUpperCase());
+        if (!channels.includes('VOICE'))
+            throw new CliError(`"${agent.name}" does not answer the phone (no VOICE channel), so a number would not reach it. Nothing was bought.`);
+        const existing = await this.agentNumbers(agentId);
+        if (existing.length)
+            throw new CliError(`"${agent.name}" already has ${existing[0].phoneNumber}. Nothing was bought.`);
+        if ((await this.orgNumbers()).some((o) => o.phoneNumber === phoneNumber)) {
+            throw new CliError(`The org already owns ${phoneNumber}; attach it with \`indemn agents numbers attach\` instead of buying it. Nothing was bought.`);
+        }
+        const digits = phoneNumber.replace(/\D/g, '');
+        const offered = await this.searchNumbers({ country, tollFree: opts.tollFree, contains: digits.slice(-7), limit: 20,
+            ...((country === 'US' || country === 'CA') && !opts.tollFree ? { areaCode: digits.slice(1, 4) } : {}) });
+        const pick = offered.find((o) => o.phoneNumber === phoneNumber);
+        if (!pick)
+            throw new CliError(`${phoneNumber} is no longer available. Search again with \`indemn agents numbers search\`. Nothing was bought.`);
+        await this.client.copilotPost(`/organization/:org_id/ai-studio/bots/${agentId}/configurations/voice/numbers`, {
+            type: opts.tollFree ? 'toll-free' : 'local', friendlyName: pick.friendlyName ?? phoneNumber, phoneNumber, payload: pick,
+        });
+        return { phone_number: phoneNumber, name: pick.friendlyName, locality: pick.locality, region: pick.region, agent: agent.name };
+    }
+    /** Detach a number from an agent; the org keeps owning it. */
+    async detachNumber(agentId, phoneNumber) {
+        const attached = await this.agentNumbers(agentId);
+        const number = attached.find((n) => n.phoneNumber === phoneNumber);
+        if (!number)
+            throw new CliError(`${phoneNumber} is not attached to agent ${agentId}.`);
+        const result = await this.client.copilotRequestRaw('DELETE', `/organization/:org_id/ai-studio/bots/${agentId}/configurations/voice/numbers`, { phoneNumber });
+        // Kept so it can be attached to another agent (moved), whatever the owned-numbers list says.
+        this.detached.set(`${await this.client.currentOrgId()}:${phoneNumber}`, { ...number, is_active: false });
+        return result;
+    }
+    /**
+     * A test voice call in the browser: a LiveKit room joined with the same
+     * attributes as the dashboard's web call, always marked as a test.
+     */
+    async voicePreview(agentId) {
+        // The call service finds the agent by its phone number: without one the agent never joins the room.
+        const numbers = await this.agentNumbers(agentId);
+        if (!numbers.length)
+            throw new CliError(`Agent ${agentId} has no phone number, so it cannot take a test call. Attach one with \`indemn agents numbers attach\`.`, EXIT.NEEDS_INPUT);
+        const res = await this.client.copilotPost('/livekit/token', {
+            bot_id: agentId,
+            user_attributes: { 'sip.twilio.callSid': callSid(), isTestMode: 'true', ...(numbers[0].phoneNumber ? { 'sip.trunkPhoneNumber': numbers[0].phoneNumber } : {}) },
+        });
+        const join = new URL('https://meet.livekit.io/custom');
+        join.searchParams.set('liveKitUrl', res.server_url);
+        join.searchParams.set('token', res.token);
+        return { ...res, join_url: join.toString() };
+    }
+}
+//# sourceMappingURL=voice.js.map

package/dist/sdk/voice.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indemn/cli",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "CLI, MCP server, and plugin for managing Indemn AI agents",
   "type": "module",
   "main": "./dist/sdk/index.js",
@@ -12,7 +12,8 @@
     "postbuild": "cp -r src/report/assets dist/report/assets",
     "dev": "tsx --watch src/cli/index.ts",
     "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "check:skills": "node scripts/check-skills.mjs"
   },
   "keywords": [
     "ai-agents",
@@ -28,13 +29,14 @@
     "url": "git+https://github.com/indemn-ai/indemn-cli.git"
   },
   "dependencies": {
+    "@firebase/app": "^0.13.2",
+    "@firebase/auth": "^1.10.8",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@react-pdf/renderer": "^4.3.2",
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "conf": "^13.1.0",
-    "firebase": "^11.6.0",
     "ora": "^8.2.0",
     "react": "^19.2.4",
     "socket.io-client": "^4.8.3",
@@ -43,8 +45,23 @@
   "devDependencies": {
     "@types/node": "^22.15.0",
     "@types/react": "^19.2.14",
+    "socket.io": "^4.8.3",
     "tsx": "^4.19.0",
     "typescript": "^5.9.3",
-    "vitest": "^3.1.0"
+    "vitest": "^5.0.0",
+    "ws": "8.21.0"
+  },
+  "overrides": {
+    "@hono/node-server": "2.0.11",
+    "body-parser": "2.3.0",
+    "fast-uri": "3.1.8",
+    "hono": "^4.13.5",
+    "ip-address": "10.7.2",
+    "qs": "6.16.0",
+    "websocket-driver": "0.7.5",
+    "ws": "8.21.0",
+    "vite": "7.3.6",
+    "esbuild": "0.28.1",
+    "postcss": "8.5.23"
   }
 }

package/scripts/check-skills.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Checks every skill against the Agent Skills guidelines the reference
+// validator does not enforce: SKILL.md under 500 lines, a description
+// saying when to use the skill, and a name matching its folder.
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const root = new URL('../skills/', import.meta.url).pathname;
+let failed = false;
+for (const dir of readdirSync(root, { withFileTypes: true }).filter((d) => d.isDirectory())) {
+  const text = readFileSync(join(root, dir.name, 'SKILL.md'), 'utf8');
+  const lines = text.split('\n').length;
+  const front = /^---\n([\s\S]*?)\n---/.exec(text)?.[1] ?? '';
+  const name = /^name:\s*(.+)$/m.exec(front)?.[1]?.trim();
+  const description = /^description:\s*(.+)$/m.exec(front)?.[1]?.trim() ?? '';
+  const problems = [];
+  if (lines > 500) problems.push(`SKILL.md has ${lines} lines (max 500); move detail into references/`);
+  if (name !== dir.name) problems.push(`name "${name}" does not match folder "${dir.name}"`);
+  if (!/\buse (when|for)\b/i.test(description)) problems.push('description should say when to use the skill ("Use when ...")');
+  if (description.length > 1024) problems.push('description is over 1024 characters');
+  console.log(`${problems.length ? 'FAIL' : 'ok  '} ${dir.name} (${lines} lines)`);
+  for (const p of problems) console.log(`     - ${p}`);
+  if (problems.length) failed = true;
+}
+process.exit(failed ? 1 : 0);