wixzel-voice-mcp 0.4.0

package/dist/schemas.js

@@ -0,0 +1,122 @@
+/**
+ * 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 const id = z.string().min(1).describe('The record id, e.g. "6a96a3ead6e886d42462dd3e".');
+export const pagination = {
+    limit: z.number().int().min(1).max(100).optional().describe('Page size, 1–100. Default 20.'),
+    starting_after: z
+        .string()
+        .optional()
+        .describe('Cursor from a previous response\'s next_cursor. Fetches the page after it.'),
+    ending_before: z
+        .string()
+        .optional()
+        .describe('Cursor from a previous response. Fetches the page before it. Not with starting_after.'),
+};
+export const isoDate = z
+    .string()
+    .describe('ISO 8601 timestamp, UTC, e.g. "2026-09-01T12:00:00.000Z".');
+export const e164 = z
+    .string()
+    .min(3)
+    .describe('Phone number in E.164 form, e.g. "+14155551234".');
+const providerModel = z
+    .string()
+    // The model half may itself contain slashes: OpenRouter ids are
+    // vendor-qualified, so `openrouter/anthropic/claude-sonnet-4.5` is the
+    // openrouter provider and the model `anthropic/claude-sonnet-4.5`. Only the
+    // FIRST slash separates the two. This mirrors ProviderModelSchema in
+    // @wixzel/schemas; a stricter copy here rejects valid models before the
+    // request ever reaches the API, which is worse than no validation at all.
+    .regex(/^[a-z0-9_-]+\/[a-zA-Z0-9._-]+(?:\/[a-zA-Z0-9._-]+)*$/, 'must be "provider/model", e.g. deepgram/nova-3 or openrouter/anthropic/claude-sonnet-4.5')
+    .describe('"provider/model", e.g. "deepgram/nova-3" or "openrouter/anthropic/claude-sonnet-4.5". Call list_engines for what is available and priced.');
+export const sttConfig = z.object({
+    model: providerModel,
+    language: z.string().optional().describe('BCP-47 tag, or "multi" for automatic detection. Default en-US.'),
+    endpointing_ms: z
+        .number()
+        .int()
+        .min(50)
+        .max(3000)
+        .optional()
+        .describe('Silence before a turn is considered finished. Lower is snappier and more prone to cutting people off.'),
+});
+export const llmConfig = z.object({
+    model: providerModel,
+    temperature: z.number().min(0).max(2).optional(),
+    max_tokens: z
+        .number()
+        .int()
+        .min(1)
+        .max(4096)
+        .optional()
+        .describe('Caps reply length. Long replies cost the caller waiting time as well as money.'),
+});
+export const ttsConfig = z.object({
+    model: providerModel,
+    voice: z.string().optional().describe('Provider voice id, e.g. an ElevenLabs voice id.'),
+    stability: z.number().min(0).max(1).optional(),
+    similarity_boost: z.number().min(0).max(1).optional(),
+    speed: z.number().min(0.5).max(2).optional(),
+});
+export const realtimeConfig = z.object({
+    model: providerModel.describe('A realtime model, e.g. "google/gemini-live-2.5-flash".'),
+    voice: z.string().optional().describe('Provider voice name, e.g. "Charon".'),
+    language: z.string().optional().describe('Default "auto".'),
+});
+export const turnTaking = z.object({
+    interrupt_sensitivity: z
+        .enum(['low', 'normal', 'high'])
+        .optional()
+        .describe('How readily the agent stops talking when the caller speaks. Default normal.'),
+    silence_wait_ms: z.number().int().min(100).max(5000).optional(),
+});
+export const voiceConfig = z
+    .object({
+    stt: sttConfig.optional(),
+    llm: llmConfig.optional(),
+    tts: ttsConfig.optional(),
+    realtime: realtimeConfig.optional(),
+    turn_taking: turnTaking.optional(),
+})
+    .describe('Either a COMPOSED pipeline {stt, llm, tts} (all three required together) or a single REALTIME model {realtime}. Never both. Use list_engines to pick models that are available right now.');
+export const scopes = [
+    '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 const scope = z.enum(scopes);
+export const arbitraryFields = z
+    .record(z.string(), z.unknown())
+    .optional()
+    .describe('Arbitrary key/value data.');
+export const idempotencyKey = z
+    .string()
+    .max(255)
+    .optional()
+    .describe('Idempotency-Key for safe retries. Generated automatically when omitted. Reuse the SAME value when retrying the SAME logical request; never reuse it for a different one.');
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { WixzelClient, type WixzelClientOptions } from './client.js';
+export declare const SERVER_NAME = "wixzel-voice";
+export declare const SERVER_VERSION = "0.4.0";
+export interface CreateServerOptions {
+    /** An already-constructed client, or the options to build one. */
+    client: WixzelClient | WixzelClientOptions;
+}
+/**
+ * Build an MCP server bound to one Wixzel Voice API key. Cheap enough to
+ * construct per request in HTTP mode, where the key arrives with each call.
+ */
+export declare function createServer(opts: CreateServerOptions): McpServer;
+export { WixzelClient, WixzelApiError } from './client.js';
+export { allTools } from './tools/index.js';
+export { GUIDE } from './guide.js';

package/dist/server.js

@@ -0,0 +1,58 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { WixzelClient } from './client.js';
+import { GUIDE } from './guide.js';
+import { registerPrompts } from './prompts.js';
+import { toolsFor } from './tools/index.js';
+import { consoleUrl } from './site.js';
+import { registerTools } from './tooling.js';
+import { VERSION } from './version.js';
+export const SERVER_NAME = 'wixzel-voice';
+export const SERVER_VERSION = VERSION;
+/**
+ * Build an MCP server bound to one Wixzel Voice API key. Cheap enough to
+ * construct per request in HTTP mode, where the key arrives with each call.
+ */
+export function createServer(opts) {
+    const client = opts.client instanceof WixzelClient ? opts.client : new WixzelClient(opts.client);
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+        title: 'Wixzel Voice',
+        websiteUrl: consoleUrl(),
+        // Shown by clients that render a connector icon (claude.ai does).
+        icons: [
+            { src: `${consoleUrl()}/icon-192.png`, mimeType: 'image/png', sizes: ['192x192'] },
+            { src: `${consoleUrl()}/icon-512.png`, mimeType: 'image/png', sizes: ['512x512'] },
+        ],
+    }, {
+        instructions: GUIDE,
+        capabilities: { tools: {}, prompts: {}, resources: {} },
+    });
+    registerTools(server, client, toolsFor());
+    registerPrompts(server);
+    server.registerResource('guide', 'wixzel://guide', {
+        title: 'Wixzel Voice operating guide',
+        description: 'How the pieces fit together, the order to set them up in, and which tools spend money.',
+        mimeType: 'text/markdown',
+    }, async (uri) => ({
+        contents: [{ uri: uri.href, mimeType: 'text/markdown', text: GUIDE }],
+    }));
+    server.registerResource('connection', 'wixzel://connection', {
+        title: 'Current connection',
+        description: 'Which API base URL this server talks to and whether the key is live or test. Never includes the key.',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'application/json',
+                text: JSON.stringify({ base_url: client.baseUrl, key_mode: client.keyMode, tools: toolsFor().length }, null, 2),
+            },
+        ],
+    }));
+    return server;
+}
+export { WixzelClient, WixzelApiError } from './client.js';
+export { allTools } from './tools/index.js';
+export { GUIDE } from './guide.js';
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/site.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Where this server's console is, and which edition it serves.
+ *
+ * The hosted server and the npm package both talk to voice.wixzel.com, which is
+ * the default. A self-hosted install runs this same process against the buyer's
+ * own API: WIXZEL_CONSOLE_URL points every link at the buyer's console, and
+ * WIXZEL_EDITION=selfhost keeps the guide from sending an agent to buy credit
+ * that does not exist there.
+ */
+export declare const DEFAULT_CONSOLE_URL = "https://voice.wixzel.com";
+export declare function consoleUrl(env?: NodeJS.ProcessEnv): string;
+export declare function isSelfHosted(env?: NodeJS.ProcessEnv): boolean;

package/dist/site.js

@@ -0,0 +1,17 @@
+/**
+ * Where this server's console is, and which edition it serves.
+ *
+ * The hosted server and the npm package both talk to voice.wixzel.com, which is
+ * the default. A self-hosted install runs this same process against the buyer's
+ * own API: WIXZEL_CONSOLE_URL points every link at the buyer's console, and
+ * WIXZEL_EDITION=selfhost keeps the guide from sending an agent to buy credit
+ * that does not exist there.
+ */
+export const DEFAULT_CONSOLE_URL = 'https://voice.wixzel.com';
+export function consoleUrl(env = process.env) {
+    return (env.WIXZEL_CONSOLE_URL || DEFAULT_CONSOLE_URL).replace(/\/+$/, '');
+}
+export function isSelfHosted(env = process.env) {
+    return String(env.WIXZEL_EDITION ?? '').trim().toLowerCase() === 'selfhost';
+}
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAE9D,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC3D,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,mBAAmB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC;AAChF,CAAC"}

package/dist/tooling.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The glue between a tool definition and the MCP server: result formatting,
+ * error translation, and the annotation presets that tell a client which
+ * tools are safe to call without asking.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import type { ZodRawShape } from 'zod/v4';
+import { type WixzelClient } from './client.js';
+export interface ToolDef<Shape extends ZodRawShape = ZodRawShape> {
+    name: string;
+    title: string;
+    description: string;
+    input: Shape;
+    /**
+     * The API operation this tool wraps, as `METHOD /v1/path/{id}`. Never used
+     * at runtime; the spec-coverage test compares it to the OpenAPI document so
+     * an endpoint added to the API cannot go unwrapped, and a tool cannot claim
+     * an endpoint that does not exist.
+     */
+    endpoint: string;
+    annotations: ToolAnnotations;
+    /** The API scope the key must hold. Surfaced in errors when the key lacks it. */
+    scope?: string;
+    handler: (client: WixzelClient, args: ShapeArgs<Shape>) => Promise<unknown>;
+}
+type ShapeArgs<Shape extends ZodRawShape> = {
+    [K in keyof Shape]: Shape[K] extends {
+        _output: infer O;
+    } ? O : unknown;
+};
+/** Presets. Every tool picks exactly one. */
+export declare const annotate: {
+    /** Reads a record or a list. Safe to call freely. */
+    read: ToolAnnotations;
+    /** Creates or updates a record on the account. Reversible. */
+    write: ToolAnnotations;
+    /** Same as write, and calling it twice is the same as once. */
+    writeIdempotent: ToolAnnotations;
+    /** Deletes or revokes. Not reversible. */
+    destructive: ToolAnnotations;
+    /** Spends credit or makes a phone ring in the real world. */
+    spend: ToolAnnotations;
+    /** Sends traffic to a third party (a carrier) without spending. */
+    probe: ToolAnnotations;
+};
+export declare function defineTool<Shape extends ZodRawShape>(def: ToolDef<Shape>): ToolDef<Shape>;
+export declare function registerTools(server: McpServer, client: WixzelClient, tools: ToolDef<any>[]): void;
+export declare function ok(data: unknown): CallToolResult;
+export declare function fail(error: unknown, tool?: ToolDef<any>): CallToolResult;
+/**
+ * Turn a failure into something an agent can act on: the machine-readable code
+ * first (the docs say to match on it, not the message), then the human
+ * message, then what to do about it.
+ */
+export declare function describeError(error: unknown, tool?: ToolDef<any>): string;
+/** Drop keys whose value is undefined so PATCH bodies only carry what was sent. */
+export declare function compact<T extends Record<string, unknown>>(obj: T): Partial<T>;
+export {};

package/dist/tooling.js

@@ -0,0 +1,129 @@
+/**
+ * The glue between a tool definition and the MCP server: result formatting,
+ * error translation, and the annotation presets that tell a client which
+ * tools are safe to call without asking.
+ */
+import { consoleUrl } from './site.js';
+import { WixzelApiError } from './client.js';
+/** Presets. Every tool picks exactly one. */
+export const annotate = {
+    /** Reads a record or a list. Safe to call freely. */
+    read: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    /** Creates or updates a record on the account. Reversible. */
+    write: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    /** Same as write, and calling it twice is the same as once. */
+    writeIdempotent: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    /** Deletes or revokes. Not reversible. */
+    destructive: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    /** Spends credit or makes a phone ring in the real world. */
+    spend: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    /** Sends traffic to a third party (a carrier) without spending. */
+    probe: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+};
+export function defineTool(def) {
+    return def;
+}
+export function registerTools(server, client, tools) {
+    for (const tool of tools) {
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description: tool.scope ? `${tool.description}\n\nRequires scope \`${tool.scope}\`.` : tool.description,
+            inputSchema: tool.input,
+            annotations: tool.annotations,
+        }, async (args) => {
+            try {
+                const result = await tool.handler(client, args);
+                return ok(result);
+            }
+            catch (error) {
+                return fail(error, tool);
+            }
+        });
+    }
+}
+export function ok(data) {
+    const text = data === null || data === undefined
+        ? 'Done.'
+        : typeof data === 'string'
+            ? data
+            : JSON.stringify(data, null, 2);
+    return { content: [{ type: 'text', text }] };
+}
+export function fail(error, tool) {
+    return { isError: true, content: [{ type: 'text', text: describeError(error, tool) }] };
+}
+/**
+ * Turn a failure into something an agent can act on: the machine-readable code
+ * first (the docs say to match on it, not the message), then the human
+ * message, then what to do about it.
+ */
+export function describeError(error, tool) {
+    if (error instanceof WixzelApiError) {
+        const lines = [
+            `Wixzel Voice API error ${error.status} (${error.type} / ${error.code}): ${error.message}`,
+        ];
+        if (error.param)
+            lines.push(`Parameter: ${error.param}`);
+        if (error.requestId)
+            lines.push(`request_id: ${error.requestId}`);
+        const hint = hintFor(error, tool);
+        if (hint)
+            lines.push(`Hint: ${hint}`);
+        return lines.join('\n');
+    }
+    if (error instanceof Error) {
+        if (error.name === 'TimeoutError' || error.name === 'AbortError') {
+            return `The request to the Wixzel Voice API timed out. ${tool?.annotations.idempotentHint ? 'It is safe to retry.' : 'If this tool spends money, retry with the same idempotency_key so it is not repeated.'}`;
+        }
+        return `Request failed: ${error.message}`;
+    }
+    return `Request failed: ${String(error)}`;
+}
+function hintFor(error, tool) {
+    switch (error.code) {
+        case 'insufficient_credits':
+            return `The account balance cannot cover this. ${error.balanceHeader ? `Current balance: ${error.balanceHeader}. ` : ''}Add credit with create_topup (returns a checkout URL for a human to pay) or in the dashboard at ${consoleUrl()}.`;
+        case 'insufficient_scope':
+        case 'permission_denied':
+            return `The API key does not hold ${tool?.scope ? `the \`${tool.scope}\` scope` : 'the scope this endpoint needs'}. Keys are scoped with no wildcard; create one with that scope in Dashboard → API keys, then restart this MCP server with it.`;
+        case 'scope_escalation':
+            return 'A key cannot grant scopes it does not itself hold. Drop the extra scopes, or create the key from the dashboard.';
+        case 'unsupported_model':
+            return 'Call list_engines and pick a model from what it returns. The message above lists what is available for that component.';
+        case 'idempotency_key_reuse':
+            return 'That idempotency_key was already used with a different body. Use a fresh key for a new request.';
+        case 'idempotency_key_in_flight':
+            return 'The original request is still running. Wait a moment and retry with the same idempotency_key; do not start a second one.';
+        case 'rate_limit_exceeded':
+            return `Rate limited (10 req/s, burst 20). Nothing was charged. Wait ${error.retryAfterSeconds ?? 1}s and retry.`;
+        case 'invalid_cursor':
+        case 'conflicting_cursors':
+            return 'Pass exactly one cursor, copied verbatim from a previous response\'s next_cursor.';
+        default:
+            break;
+    }
+    switch (error.type) {
+        case 'authentication_error':
+            return 'The API key is missing, malformed, revoked or expired. Set WIXZEL_API_KEY to a valid wv_live_ or wv_test_ key.';
+        case 'permission_error':
+            return `The API key does not hold ${tool?.scope ? `the \`${tool.scope}\` scope` : 'the scope this endpoint needs'}. Create a key with it in Dashboard → API keys.`;
+        case 'not_found_error':
+            return 'No such record on this account. A record owned by another account also returns 404. List the resource to find the right id.';
+        case 'conflict_error':
+            return 'The request conflicts with the record\'s current state. Fetch it and look at its status before retrying.';
+        case 'api_error':
+            return 'Something failed on the Wixzel side. Quote the request_id if reporting it. Retry once after a short wait.';
+        default:
+            return null;
+    }
+}
+/** Drop keys whose value is undefined so PATCH bodies only carry what was sent. */
+export function compact(obj) {
+    const out = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=tooling.js.map

package/dist/tooling.js.map

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

package/dist/tools/agents.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod/v4';
+import { id } from '../schemas.js';
+export declare const agentTools: (import("../tooling.js").ToolDef<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    starting_after: z.ZodOptional<z.ZodString>;
+    ending_before: z.ZodOptional<z.ZodString>;
+}> | import("../tooling.js").ToolDef<{
+    id: z.ZodString;
+}> | import("../tooling.js").ToolDef<{
+    name: z.ZodString;
+    system_prompt: z.ZodString;
+    opening_message: z.ZodString;
+    voice: 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>;
+    language: z.ZodOptional<z.ZodString>;
+    knowledge_base_id: z.ZodOptional<z.ZodString>;
+    outbound_phone_number_id: z.ZodOptional<z.ZodString>;
+    appointment_booking_enabled: z.ZodOptional<z.ZodBoolean>;
+}> | import("../tooling.js").ToolDef<{
+    id: z.ZodString;
+    to: z.ZodString;
+    from_number_id: z.ZodOptional<z.ZodString>;
+    phrase: z.ZodOptional<z.ZodString>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+}> | import("../tooling.js").ToolDef<{
+    id: typeof id;
+} & {
+    name: z.ZodOptional<z.ZodString>;
+    system_prompt: z.ZodOptional<z.ZodString>;
+    opening_message: z.ZodOptional<z.ZodString>;
+    voice: z.ZodOptional<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>>;
+    language: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    knowledge_base_id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    outbound_phone_number_id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    appointment_booking_enabled: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+}>)[];

package/dist/tools/agents.js

@@ -0,0 +1,105 @@
+import { z } from 'zod/v4';
+import { annotate, compact, defineTool } from '../tooling.js';
+import { e164, id, idempotencyKey, pagination, voiceConfig } from '../schemas.js';
+const agentFields = {
+    name: z.string().min(1).describe('A label for your own reference, e.g. "Support line".'),
+    system_prompt: z
+        .string()
+        .min(1)
+        .describe('The agent\'s instructions. This is a spoken conversation, so keep it short, concrete, and free of markdown.'),
+    opening_message: z
+        .string()
+        .min(1)
+        .describe('Spoken as soon as the call connects. Supports {{name}} style merge fields from the lead. Required: an agent without one answers in silence.'),
+    voice: voiceConfig,
+    language: z.string().optional().describe('BCP-47 tag for the conversation, e.g. "en-US" or "hi-IN".'),
+    knowledge_base_id: z.string().optional().describe('A knowledge base the agent can draw on. See list_knowledge_bases.'),
+    outbound_phone_number_id: z
+        .string()
+        .optional()
+        .describe('Default caller id for outbound calls placed with this agent. See list_phone_numbers.'),
+    appointment_booking_enabled: z
+        .boolean()
+        .optional()
+        .describe('Let the agent book appointments during a call.'),
+};
+export const agentTools = [
+    defineTool({
+        name: 'list_agents',
+        endpoint: 'GET /v1/agents',
+        title: 'List agents',
+        description: 'List the voice agents on this account. Cursor-paginated: pass next_cursor as starting_after for the next page.',
+        input: { ...pagination },
+        annotations: annotate.read,
+        scope: 'agents:read',
+        handler: (client, args) => client.get('/v1/agents', args),
+    }),
+    defineTool({
+        name: 'get_agent',
+        endpoint: 'GET /v1/agents/{id}',
+        title: 'Retrieve an agent',
+        description: 'Fetch one agent by id, including its full voice configuration and prompt.',
+        input: { id },
+        annotations: annotate.read,
+        scope: 'agents:read',
+        handler: (client, { id }) => client.get(`/v1/agents/${encodeURIComponent(id)}`),
+    }),
+    defineTool({
+        name: 'create_agent',
+        endpoint: 'POST /v1/agents',
+        title: 'Create an agent',
+        description: 'Create a voice agent. Pick models with list_engines first: an unavailable or mistyped model is rejected with unsupported_model. ' +
+            'voice is either a composed pipeline {stt, llm, tts} or a single {realtime} model, never both.',
+        input: agentFields,
+        annotations: annotate.write,
+        scope: 'agents:write',
+        handler: (client, args) => client.post('/v1/agents', compact(args)),
+    }),
+    defineTool({
+        name: 'test_call_agent',
+        endpoint: 'POST /v1/agents/{id}/test-call',
+        title: 'Place a test call',
+        description: 'Ring a number and have the agent speak one phrase, then hang up. A probe, not a conversation: it answers ' +
+            '"is the trunk configured and does this agent sound right" in seconds. For a real conversation use place_call. ' +
+            'THIS RINGS A REAL PHONE AND SPENDS REAL CREDIT — the meter runs on a test call exactly as on any other, so ' +
+            'confirm the number with the user first. Human transfer is not offered during a test call, so this cannot check ' +
+            'that a transfer destination answers. Needs calls:write.',
+        input: {
+            id,
+            to: e164.describe('Destination in E.164 form, e.g. "+14155551234". A real phone will ring.'),
+            from_number_id: z.string().optional().describe("Defaults to the agent's own outbound number. See list_phone_numbers."),
+            phrase: z.string().optional().describe("What to say. Defaults to the agent's opening message, which is usually what you want to hear."),
+            idempotency_key: idempotencyKey,
+        },
+        annotations: annotate.spend,
+        scope: 'calls:write',
+        handler: (client, { id, idempotency_key, ...body }) => client.post(`/v1/agents/${encodeURIComponent(id)}/test-call`, compact(body), { idempotencyKey: idempotency_key, idempotent: true }),
+    }),
+    defineTool({
+        name: 'update_agent',
+        endpoint: 'PATCH /v1/agents/{id}',
+        title: 'Update an agent',
+        description: 'Change an agent. Only the fields you send are changed; omit the rest. Sending voice replaces the whole voice object.',
+        input: {
+            id,
+            ...Object.fromEntries(Object.entries(agentFields).map(([k, v]) => [k, v.optional()])),
+        },
+        annotations: annotate.write,
+        scope: 'agents:write',
+        handler: (client, { id, ...rest }) => client.patch(`/v1/agents/${encodeURIComponent(id)}`, compact(rest)),
+    }),
+    defineTool({
+        name: 'delete_agent',
+        endpoint: 'DELETE /v1/agents/{id}',
+        title: 'Delete an agent',
+        description: 'Permanently delete an agent. Phone numbers and campaigns pointing at it stop working. Not reversible.',
+        input: { id },
+        annotations: annotate.destructive,
+        scope: 'agents:write',
+        handler: async (client, { id }) => {
+            await client.delete(`/v1/agents/${encodeURIComponent(id)}`);
+            return { deleted: true, id };
+        },
+    }),
+];
+//# sourceMappingURL=agents.js.map