wixzel-voice-mcp 0.4.0

package/dist/http.js

@@ -0,0 +1,281 @@
+/**
+ * Streamable HTTP mode: the hosted server at mcp.voice.wixzel.com, and the
+ * same thing on a laptop with `--http`.
+ *
+ * Stateless by design. Every request carries its own `Authorization: Bearer`,
+ * which is a Wixzel Voice API key — either pasted by a developer into
+ * `claude mcp add --header`, or issued by the API's OAuth server after the
+ * user consented in the console. Either way this process builds a fresh MCP
+ * server bound to that key, answers the request, and forgets it. Nothing here
+ * can mix two users up, because nothing here remembers anyone.
+ *
+ * The OAuth half lives in the API (api/oauth/index.ts there). This side only
+ * has to say where it is: RFC 9728 protected-resource metadata, and a 401 that
+ * points at it, are what make claude.ai's "add custom connector" flow work.
+ */
+import { createHash } from 'node:crypto';
+import { createServer as createNodeServer } from 'node:http';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { DEFAULT_BASE_URL } from './client.js';
+import { scopes } from './schemas.js';
+import { createServer, SERVER_VERSION } from './server.js';
+import { consoleUrl, DEFAULT_CONSOLE_URL } from './site.js';
+const LOOPBACK = new Set(['localhost', '127.0.0.1', '[::1]', '::1']);
+/**
+ * The hosted server's names. It was mcp.phone.wixzel.com from 8 to 29 September
+ * 2026, and that name keeps serving so connectors added then keep working. An
+ * MCP client refuses protected-resource metadata whose resource is on another
+ * origin than the URL it connected to (the TypeScript SDK's
+ * checkResourceAllowed), so each name has to be advertised as itself.
+ */
+const HOSTED_MCP_HOSTS = ['mcp.voice.wixzel.com', 'mcp.phone.wixzel.com'];
+/** The other names of the host in publicUrl, if it is the hosted server; none otherwise. */
+export function hostAliases(publicUrl) {
+    const host = new URL(publicUrl).host.toLowerCase();
+    return HOSTED_MCP_HOSTS.includes(host) ? HOSTED_MCP_HOSTS.filter((h) => h !== host) : [];
+}
+/**
+ * The resource a request addressed: publicUrl, or the same URL on the alias
+ * host it arrived on (nginx passes the client's Host through). Any other Host
+ * gets publicUrl, so a forged header can only pick between our own names.
+ */
+export function resourceFor(publicUrl, aliases, hostHeader) {
+    const host = (hostHeader ?? '').trim().toLowerCase();
+    if (!host || !aliases.includes(host))
+        return publicUrl;
+    const url = new URL(publicUrl);
+    url.host = host;
+    return url.href.replace(/\/+$/, '');
+}
+function isLoopbackUrl(url) {
+    try {
+        return LOOPBACK.has(new URL(url).hostname);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Environment → options, with the one guard that matters: a fallback key on a
+ * host anyone can reach would hand that key's account to every anonymous
+ * caller. Refuse to start rather than trust the operator noticed.
+ */
+export function resolveHttpOptions(env, cliPort) {
+    const port = cliPort ?? (Number(env.MCP_PORT) || 3939);
+    const bind = env.MCP_BIND || '127.0.0.1';
+    const publicUrl = (env.MCP_PUBLIC_URL || `http://localhost:${port}/mcp`).replace(/\/+$/, '');
+    const fallbackKey = env.WIXZEL_API_KEY || undefined;
+    if (fallbackKey && !isLoopbackUrl(publicUrl)) {
+        throw new Error(`WIXZEL_API_KEY is set but MCP_PUBLIC_URL (${publicUrl}) is not a loopback address. ` +
+            'A fallback key on a public host would be handed to every anonymous caller. Unset one of them.');
+    }
+    return {
+        port,
+        bind,
+        publicUrl,
+        hostAliases: hostAliases(publicUrl),
+        apiBaseUrl: (env.WIXZEL_API_BASE_URL || DEFAULT_BASE_URL).replace(/\/+$/, ''),
+        consoleUrl: consoleUrl(env),
+        apiVersion: env.WIXZEL_API_VERSION || undefined,
+        fallbackKey,
+    };
+}
+const PROBE_OK_MS = 60_000;
+const PROBE_REJECTED_MS = 10_000;
+export class TokenProbe {
+    apiBaseUrl;
+    fetchImpl;
+    cache = new Map();
+    constructor(apiBaseUrl, fetchImpl) {
+        this.apiBaseUrl = apiBaseUrl;
+        this.fetchImpl = fetchImpl;
+    }
+    async check(apiKey) {
+        const id = createHash('sha256').update(apiKey).digest('hex');
+        const hit = this.cache.get(id);
+        if (hit && hit.until > Date.now())
+            return hit.verdict;
+        let verdict;
+        try {
+            const res = await this.fetchImpl(`${this.apiBaseUrl}/v1/engines`, {
+                headers: { Authorization: `Bearer ${apiKey}`, Accept: 'application/json' },
+                signal: AbortSignal.timeout(5_000),
+            });
+            verdict = res.status === 401 ? 'rejected' : res.status < 500 ? 'ok' : 'unknown';
+        }
+        catch {
+            verdict = 'unknown';
+        }
+        if (verdict !== 'unknown') {
+            this.cache.set(id, { verdict, until: Date.now() + (verdict === 'ok' ? PROBE_OK_MS : PROBE_REJECTED_MS) });
+        }
+        if (this.cache.size > 10_000)
+            this.cache.clear();
+        return verdict;
+    }
+}
+// ─── The handler ────────────────────────────────────────────────────────────
+function bearerFrom(req) {
+    const header = req.headers.authorization;
+    if (!header)
+        return undefined;
+    const match = /^Bearer\s+(.+)$/i.exec(header);
+    return match?.[1]?.trim() || undefined;
+}
+/** No cookies exist on this host, so a wildcard is safe and browser-based MCP clients need it. */
+function cors(res) {
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Authorization, Content-Type, Accept, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID');
+    res.setHeader('Access-Control-Expose-Headers', 'WWW-Authenticate, Mcp-Session-Id, Mcp-Protocol-Version');
+    res.setHeader('Access-Control-Max-Age', '86400');
+}
+function json(res, status, body, headers = {}) {
+    res.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-store', ...headers });
+    res.end(JSON.stringify(body));
+}
+export function protectedResourceMetadata(opts, resource = opts.publicUrl) {
+    return {
+        resource,
+        authorization_servers: [opts.apiBaseUrl],
+        bearer_methods_supported: ['header'],
+        scopes_supported: [...scopes],
+        resource_name: 'Wixzel Voice',
+        resource_documentation: 'https://docs.voice.wixzel.com/mcp-server',
+    };
+}
+/** RFC 9728 §3: the well-known path carries the resource's own path as a suffix. */
+export function resourceMetadataUrl(publicUrl) {
+    const url = new URL(publicUrl);
+    const suffix = url.pathname === '/' ? '' : url.pathname;
+    return `${url.origin}/.well-known/oauth-protected-resource${suffix}`;
+}
+export function createHttpHandler(opts) {
+    const fetchImpl = opts.fetch ?? globalThis.fetch;
+    const probe = new TokenProbe(opts.apiBaseUrl, fetchImpl);
+    const log = opts.log ?? ((line) => process.stderr.write(`${line}\n`));
+    const metadataPaths = new Set(['/.well-known/oauth-protected-resource', new URL(resourceMetadataUrl(opts.publicUrl)).pathname]);
+    const mcpPath = new URL(opts.publicUrl).pathname === '/' ? '/mcp' : new URL(opts.publicUrl).pathname;
+    const aliases = (opts.hostAliases ?? hostAliases(opts.publicUrl)).map((h) => h.toLowerCase());
+    const challenge = (resource, error) => `Bearer realm="wixzel-voice-mcp", resource_metadata="${resourceMetadataUrl(resource)}"` +
+        (error ? `, error="${error}"` : '');
+    return async (req, res) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        const resource = resourceFor(opts.publicUrl, aliases, req.headers.host);
+        cors(res);
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (url.pathname === '/healthz') {
+            return json(res, 200, { ok: true, name: 'wixzel-voice-mcp', version: SERVER_VERSION });
+        }
+        // People do open the bare host in a browser, and connector UIs that
+        // want an icon parse this page for one. A sentence and a few links.
+        if (url.pathname === '/' && (req.method === 'GET' || req.method === 'HEAD')) {
+            res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'public, max-age=3600' });
+            res.end(LANDING_HTML(mcpPath, opts.publicUrl, (opts.consoleUrl ?? consoleUrl()).replace(/\/+$/, '')));
+            return;
+        }
+        if (metadataPaths.has(url.pathname)) {
+            // Varies by Host now that one process answers for two names.
+            return json(res, 200, protectedResourceMetadata(opts, resource), { 'cache-control': 'public, max-age=300', vary: 'Host' });
+        }
+        if (url.pathname !== mcpPath) {
+            return json(res, 404, { error: 'not_found', message: `MCP is served at ${mcpPath}` });
+        }
+        const presented = bearerFrom(req);
+        const apiKey = presented ?? opts.fallbackKey;
+        if (!apiKey) {
+            return json(res, 401, {
+                error: 'unauthorized',
+                message: 'Send a Wixzel Voice API key as "Authorization: Bearer wv_live_…", or connect through OAuth.',
+            }, { 'www-authenticate': challenge(resource) });
+        }
+        if (presented && (await probe.check(presented)) === 'rejected') {
+            return json(res, 401, {
+                error: 'invalid_token',
+                message: 'That API key is invalid, revoked or expired. Reconnect to obtain a new one.',
+            }, { 'www-authenticate': challenge(resource, 'invalid_token') });
+        }
+        const clientOptions = {
+            apiKey,
+            baseUrl: opts.apiBaseUrl,
+            apiVersion: opts.apiVersion,
+            fetch: fetchImpl,
+        };
+        const server = createServer({ client: clientOptions });
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+        // The transport decides most 4xx answers itself and says why only
+        // through this hook; without it a client's "couldn't load tools" is
+        // a status code and nothing else in the logs.
+        transport.onerror = (error) => log(`wixzel-voice-mcp: transport: ${error.message}`);
+        server.server.onerror = (error) => log(`wixzel-voice-mcp: server: ${error.message}`);
+        res.on('finish', () => {
+            if (res.statusCode >= 400) {
+                const h = req.headers;
+                log(`wixzel-voice-mcp: ${res.statusCode} ${req.method} ${url.pathname}` +
+                    ` accept=${JSON.stringify(h.accept ?? null)} content-type=${JSON.stringify(h['content-type'] ?? null)}` +
+                    ` length=${h['content-length'] ?? '?'} protocol=${h['mcp-protocol-version'] ?? '-'} session=${h['mcp-session-id'] ? 'yes' : 'no'}` +
+                    ` ua=${JSON.stringify(h['user-agent'] ?? null)}`);
+            }
+        });
+        res.on('close', () => {
+            void transport.close();
+            void server.close();
+        });
+        try {
+            await server.connect(transport);
+            await transport.handleRequest(req, res);
+        }
+        catch (error) {
+            log(`wixzel-voice-mcp: request failed: ${error.message}`);
+            if (!res.headersSent)
+                json(res, 500, { error: 'internal_error' });
+        }
+    };
+}
+const LANDING_HTML = (mcpPath, publicUrl, consoleBase) => {
+    // Our product pages only on our own server. A self-hosted install links
+    // its own console and the public docs, and nothing that sells.
+    const product = consoleBase === DEFAULT_CONSOLE_URL
+        ? ` · <a href="${DEFAULT_CONSOLE_URL}/solutions/ai-agents-mcp">What you can build</a> · <a href="${DEFAULT_CONSOLE_URL}">Wixzel Voice</a>`
+        : '';
+    return `<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><title>Wixzel Voice MCP server</title>
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<meta name="description" content="Connect Claude, ChatGPT, Cursor or any other MCP client to Wixzel Voice and build AI agents that place and answer real phone calls.">
+<link rel="icon" href="/favicon.ico"><link rel="icon" type="image/png" sizes="192x192" href="/icon-192.png">
+<link rel="apple-touch-icon" href="/apple-touch-icon.png">
+<style>body{margin:0;min-height:100vh;display:grid;place-items:center;background:#0d0d0d;color:#e8e8e8;font:15px/1.5 system-ui,sans-serif}main{max-width:32rem;padding:2rem}code{background:#1a1a1a;padding:.15em .4em;border-radius:.3em}a{color:#a0d425}</style>
+</head><body><main>
+<img src="/icon-192.png" alt="" width="48" height="48">
+<h1>Wixzel Voice MCP server</h1>
+<p>Connect Claude, ChatGPT, Cursor or any other MCP client to Wixzel Voice and build AI agents that place and answer real phone calls.</p>
+<p>This host speaks the Model Context Protocol at <code>${mcpPath}</code>. Add it as a connector in claude.ai or Claude Desktop, or run <code>claude mcp add --transport http wixzel-voice ${publicUrl}</code>.</p>
+<p><a href="https://docs.voice.wixzel.com/mcp-server">Documentation</a> · <a href="${consoleBase}/connect">Connect your account</a>${product}</p>
+</main></body></html>
+`;
+};
+export async function startHttp(opts) {
+    const handler = createHttpHandler(opts);
+    const server = createNodeServer((req, res) => {
+        void handler(req, res);
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(opts.port, opts.bind, () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    const port = typeof address === 'object' && address ? address.port : opts.port;
+    return {
+        server,
+        port,
+        close: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * wixzel-voice-mcp
+ *
+ *   wixzel-voice-mcp                 stdio transport, key from WIXZEL_API_KEY
+ *   wixzel-voice-mcp --http [port]   Streamable HTTP on /mcp; each request's
+ *                                    Authorization: Bearer is the API key
+ *
+ * Environment:
+ *   WIXZEL_API_KEY        wv_live_… or wv_test_… (required for stdio; a local-only fallback for --http)
+ *   WIXZEL_API_BASE_URL   default https://api.voice.wixzel.com
+ *   WIXZEL_API_VERSION    optional Wixzel-Version date pin
+ *   MCP_PORT              --http port (default 3939)
+ *   MCP_BIND              --http interface (default 127.0.0.1)
+ *   MCP_PUBLIC_URL        the URL clients use, e.g. https://mcp.voice.wixzel.com/mcp
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * wixzel-voice-mcp
+ *
+ *   wixzel-voice-mcp                 stdio transport, key from WIXZEL_API_KEY
+ *   wixzel-voice-mcp --http [port]   Streamable HTTP on /mcp; each request's
+ *                                    Authorization: Bearer is the API key
+ *
+ * Environment:
+ *   WIXZEL_API_KEY        wv_live_… or wv_test_… (required for stdio; a local-only fallback for --http)
+ *   WIXZEL_API_BASE_URL   default https://api.voice.wixzel.com
+ *   WIXZEL_API_VERSION    optional Wixzel-Version date pin
+ *   MCP_PORT              --http port (default 3939)
+ *   MCP_BIND              --http interface (default 127.0.0.1)
+ *   MCP_PUBLIC_URL        the URL clients use, e.g. https://mcp.voice.wixzel.com/mcp
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { DEFAULT_BASE_URL } from './client.js';
+import { resolveHttpOptions, startHttp } from './http.js';
+import { createServer, SERVER_VERSION } from './server.js';
+import { consoleUrl } from './site.js';
+const HELP = `wixzel-voice-mcp ${SERVER_VERSION}
+
+Usage:
+  wixzel-voice-mcp                Run over stdio (for Claude Code, Claude Desktop, Cursor…)
+  wixzel-voice-mcp --http [port]  Run a Streamable HTTP server (default http://127.0.0.1:3939/mcp)
+  wixzel-voice-mcp --help
+
+Environment:
+  WIXZEL_API_KEY       Your API key. Required for stdio. For --http it is only accepted on a loopback MCP_PUBLIC_URL.
+  WIXZEL_API_BASE_URL  Defaults to ${DEFAULT_BASE_URL}
+  WIXZEL_API_VERSION   Optional Wixzel-Version date pin, e.g. 2026-09-01
+  MCP_PORT, MCP_BIND, MCP_PUBLIC_URL   --http settings; see README
+`;
+async function runStdio() {
+    const apiKey = process.env.WIXZEL_API_KEY;
+    if (!apiKey) {
+        process.stderr.write('wixzel-voice-mcp: WIXZEL_API_KEY is not set.\n' +
+            `Create a key at ${consoleUrl()}/connect and pass it as an environment variable.\n`);
+        process.exit(1);
+    }
+    const server = createServer({
+        client: {
+            apiKey,
+            baseUrl: process.env.WIXZEL_API_BASE_URL || undefined,
+            apiVersion: process.env.WIXZEL_API_VERSION || undefined,
+        },
+    });
+    await server.connect(new StdioServerTransport());
+    // stdout is the protocol channel; everything human goes to stderr.
+    process.stderr.write(`wixzel-voice-mcp ${SERVER_VERSION} ready on stdio (${apiKey.slice(0, 8)}…)\n`);
+}
+async function runHttp(cliPort) {
+    const opts = resolveHttpOptions(process.env, cliPort);
+    const running = await startHttp(opts);
+    process.stderr.write(`wixzel-voice-mcp ${SERVER_VERSION} listening on http://${opts.bind}:${running.port}${new URL(opts.publicUrl).pathname}` +
+        ` as ${opts.publicUrl}` +
+        (opts.fallbackKey ? ' (WIXZEL_API_KEY fallback, loopback only)' : ' (bearer or OAuth required)') +
+        '\n');
+    const shutdown = () => {
+        void running.close().then(() => process.exit(0));
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        process.stdout.write(`${SERVER_VERSION}\n`);
+        return;
+    }
+    const httpIndex = args.indexOf('--http');
+    if (httpIndex !== -1) {
+        const explicit = args[httpIndex + 1];
+        await runHttp(explicit && /^\d+$/.test(explicit) ? Number(explicit) : undefined);
+        return;
+    }
+    await runStdio();
+}
+main().catch((error) => {
+    process.stderr.write(`wixzel-voice-mcp: ${error.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Prompts are the slash-command surface: in Claude Code they appear as
+ * /mcp__wixzel-voice__<name>. Each one is a worked procedure, phrased as a
+ * request the user would make.
+ */
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts.js

@@ -0,0 +1,83 @@
+import { z } from 'zod/v4';
+import { GUIDE } from './guide.js';
+/**
+ * Prompts are the slash-command surface: in Claude Code they appear as
+ * /mcp__wixzel-voice__<name>. Each one is a worked procedure, phrased as a
+ * request the user would make.
+ */
+export function registerPrompts(server) {
+    server.registerPrompt('quickstart', {
+        title: 'Set up Wixzel Voice from nothing',
+        description: 'Walk through connecting a carrier, registering a number, building an agent and placing a first call, checking in with the user at each step that costs money or needs their credentials.',
+        argsSchema: {
+            goal: z
+                .string()
+                .optional()
+                .describe('What the agent should do on calls, e.g. "confirm dental appointments". Optional.'),
+        },
+    }, ({ goal }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${GUIDE}\n\n---\n\n` +
+                        `Set up my Wixzel Voice account so an agent can make calls${goal ? ` to ${goal}` : ''}. ` +
+                        'Start by checking what already exists (list_sip_trunks, list_phone_numbers, list_agents, get_balance) so nothing is duplicated. ' +
+                        'Then follow the setup order in the guide. Ask me for carrier credentials rather than inventing them, ' +
+                        'and stop to confirm before anything that spends money or dials a phone. ' +
+                        'At the end, tell me exactly what was created (with ids) and what I still have to do at my carrier.',
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('diagnose_call', {
+        title: 'Diagnose a failed or odd call',
+        description: 'Pull the call record, its usage events, the trunk status and recent SIP logs, and explain what happened and what to change.',
+        argsSchema: {
+            call_id: z.string().describe('The call id from list_calls or place_call.'),
+        },
+    }, ({ call_id }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Diagnose Wixzel Voice call ${call_id}. ` +
+                        'Fetch it with get_call and read status, failure_code, failure_reason, errors and transfers. ' +
+                        'Pull list_usage_events with its session_id to see what was billed. ' +
+                        'If it did not connect, find the phone number and trunk it used (list_phone_numbers, get_sip_trunk), run check_sip_trunk_status and get_sip_trunk_logs, ' +
+                        'and read the transcript if there is one. ' +
+                        'Report: what happened in one paragraph, the evidence (quote codes and log lines), and the concrete fix, ' +
+                        'distinguishing carrier-side configuration (allowlisting platform_ip, origination URI, credentials) from agent configuration. ' +
+                        'Do not place any new calls while diagnosing.',
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('spend_report', {
+        title: 'Explain recent spend',
+        description: 'Summarise what the account spent over a period, by component and by call, in plain dollars.',
+        argsSchema: {
+            period: z
+                .string()
+                .optional()
+                .describe('Human phrase such as "this month", "last 7 days", or an ISO date range. Defaults to this month.'),
+        },
+    }, ({ period }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Explain my Wixzel Voice spend for ${period ?? 'this month'}. ` +
+                        'Use get_usage_summary for the totals by component and model, get_balance for what is left, and list_calls (with started_after/started_before) to find the most expensive calls, ' +
+                        'then list_usage_events by session_id for the top two or three. ' +
+                        'Convert micro-USD to dollars (1,000,000 = $1.00). Present a short table by component, the top calls with duration and cost, and one or two suggestions for reducing cost, ' +
+                        'such as a cheaper model from list_engines or a lower max_tokens.',
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC7C,MAAM,CAAC,cAAc,CACjB,YAAY,EACZ;QACI,KAAK,EAAE,kCAAkC;QACzC,WAAW,EACP,0LAA0L;QAC9L,UAAU,EAAE;YACR,IAAI,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kFAAkF,CAAC;SACpG;KACJ,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACN;gBACI,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EACA,GAAG,KAAK,aAAa;wBACrB,4DAA4D,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI;wBACzF,kIAAkI;wBAClI,uGAAuG;wBACvG,0EAA0E;wBAC1E,oGAAoG;iBAC3G;aACJ;SACJ;KACJ,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,cAAc,CACjB,eAAe,EACf;QACI,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,6HAA6H;QAC1I,UAAU,EAAE;YACR,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;SAC7E;KACJ,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACN;gBACI,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EACA,8BAA8B,OAAO,IAAI;wBACzC,8FAA8F;wBAC9F,qEAAqE;wBACrE,yJAAyJ;wBACzJ,2CAA2C;wBAC3C,0GAA0G;wBAC1G,+HAA+H;wBAC/H,8CAA8C;iBACrD;aACJ;SACJ;KACJ,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,cAAc,CACjB,cAAc,EACd;QACI,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,6FAA6F;QAC1G,UAAU,EAAE;YACR,MAAM,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iGAAiG,CAAC;SACnH;KACJ,EACD,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACb,QAAQ,EAAE;YACN;gBACI,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EACA,qCAAqC,MAAM,IAAI,YAAY,IAAI;wBAC/D,kLAAkL;wBAClL,iEAAiE;wBACjE,4KAA4K;wBAC5K,kEAAkE;iBACzE;aACJ;SACJ;KACJ,CAAC,CACL,CAAC;AACN,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,105 @@
+/**
+ * zod shapes shared across tools. Kept loose on purpose where the API already
+ * gives a better error than a client could — the mutually-exclusive voice
+ * rule, for instance, is enforced server-side with a message that names the
+ * block to delete.
+ */
+import { z } from 'zod/v4';
+export declare const id: z.ZodString;
+export declare const pagination: {
+    limit: z.ZodOptional<z.ZodNumber>;
+    starting_after: z.ZodOptional<z.ZodString>;
+    ending_before: z.ZodOptional<z.ZodString>;
+};
+export declare const isoDate: z.ZodString;
+export declare const e164: z.ZodString;
+export declare const sttConfig: z.ZodObject<{
+    model: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    endpointing_ms: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const llmConfig: z.ZodObject<{
+    model: z.ZodString;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ttsConfig: z.ZodObject<{
+    model: z.ZodString;
+    voice: z.ZodOptional<z.ZodString>;
+    stability: z.ZodOptional<z.ZodNumber>;
+    similarity_boost: z.ZodOptional<z.ZodNumber>;
+    speed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const realtimeConfig: z.ZodObject<{
+    model: z.ZodString;
+    voice: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const turnTaking: z.ZodObject<{
+    interrupt_sensitivity: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        high: "high";
+    }>>;
+    silence_wait_ms: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const voiceConfig: z.ZodObject<{
+    stt: z.ZodOptional<z.ZodObject<{
+        model: z.ZodString;
+        language: z.ZodOptional<z.ZodString>;
+        endpointing_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    llm: z.ZodOptional<z.ZodObject<{
+        model: z.ZodString;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    tts: z.ZodOptional<z.ZodObject<{
+        model: z.ZodString;
+        voice: z.ZodOptional<z.ZodString>;
+        stability: z.ZodOptional<z.ZodNumber>;
+        similarity_boost: z.ZodOptional<z.ZodNumber>;
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    realtime: z.ZodOptional<z.ZodObject<{
+        model: z.ZodString;
+        voice: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    turn_taking: z.ZodOptional<z.ZodObject<{
+        interrupt_sensitivity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            normal: "normal";
+            high: "high";
+        }>>;
+        silence_wait_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const scopes: readonly ["agents:read", "agents:write", "calls:read", "calls:write", "leads:read", "leads:write", "campaigns:read", "campaigns:write", "knowledge_bases:read", "knowledge_bases:write", "phone_numbers:read", "phone_numbers:write", "sip_trunks:read", "sip_trunks:write", "appointments:read", "appointments:write", "webhooks:read", "webhooks:write", "api_keys:read", "api_keys:write", "usage:read", "billing:read", "billing:write"];
+export declare const scope: z.ZodEnum<{
+    "agents:read": "agents:read";
+    "agents:write": "agents:write";
+    "calls:read": "calls:read";
+    "calls:write": "calls:write";
+    "leads:read": "leads:read";
+    "leads:write": "leads:write";
+    "campaigns:read": "campaigns:read";
+    "campaigns:write": "campaigns:write";
+    "knowledge_bases:read": "knowledge_bases:read";
+    "knowledge_bases:write": "knowledge_bases:write";
+    "phone_numbers:read": "phone_numbers:read";
+    "phone_numbers:write": "phone_numbers:write";
+    "sip_trunks:read": "sip_trunks:read";
+    "sip_trunks:write": "sip_trunks:write";
+    "appointments:read": "appointments:read";
+    "appointments:write": "appointments:write";
+    "webhooks:read": "webhooks:read";
+    "webhooks:write": "webhooks:write";
+    "api_keys:read": "api_keys:read";
+    "api_keys:write": "api_keys:write";
+    "usage:read": "usage:read";
+    "billing:read": "billing:read";
+    "billing:write": "billing:write";
+}>;
+export declare const arbitraryFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+export declare const idempotencyKey: z.ZodOptional<z.ZodString>;