@avallon-labs/sdk 0.0.0-0ca09b5e

package/dist/index.d.ts

@@ -0,0 +1,957 @@
+import * as swr_mutation from 'swr/mutation';
+import { SWRMutationConfiguration } from 'swr/mutation';
+import * as swr__internal from 'swr/_internal';
+import * as swr from 'swr';
+import { Key, SWRConfiguration, Arguments } from 'swr';
+
+/**
+ * Custom fetch wrapper for Orval-generated client.
+ * Handles auth (API key or Bearer token) and base URL configuration.
+ * Throws AvallonError on non-2xx responses for clean SWR error handling.
+ */
+type AvallonConfig = {
+    baseUrl?: string;
+    apiKey?: string;
+    /**
+     * Token provider - can be sync or async.
+     * Async allows the application to check expiry and refresh before returning.
+     */
+    getAccessToken?: () => string | null | Promise<string | null>;
+};
+/** Configure the SDK at runtime */
+declare function configure(newConfig: Partial<AvallonConfig>): void;
+/** Get current config */
+declare function getConfig(): AvallonConfig;
+/** Authenticated fetch - adds API key or Bearer token */
+declare function customFetch<T>(url: string, options: RequestInit): Promise<T>;
+/** Unauthenticated fetch - for auth flow endpoints (sign-in, sign-up, etc.) */
+declare function customFetchNoAuth<T>(url: string, options: RequestInit): Promise<T>;
+/** Orval uses this to type the `error` field in SWR hooks as AvallonError */
+type ErrorType<E> = AvallonError;
+/** Typed error class for API errors. Thrown by customFetch on non-2xx responses. */
+declare class AvallonError extends Error {
+    readonly status: number;
+    readonly body: {
+        data?: unknown;
+        message?: string;
+    };
+    constructor(status: number, body: {
+        data?: unknown;
+        message?: string;
+    });
+    /** Validation errors (400) have field-level details */
+    get errors(): Array<{
+        field: string;
+        message: string;
+    }> | undefined;
+    isValidationError(): boolean;
+    isUnauthorized(): boolean;
+    isNotFound(): boolean;
+}
+
+/**
+ * PKCE Utilities
+ *
+ * Cryptographic helpers for OAuth PKCE flow. Platform-agnostic -
+ * works in both Node.js and browsers via Web Crypto API.
+ *
+ * These utilities can't be generated from OpenAPI - they're
+ * client-side crypto that complements the generated auth endpoints.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   generateCodeVerifier,
+ *   generateCodeChallenge,
+ *   getV1AuthOauthUrl,
+ *   postV1AuthOauthExchange,
+ * } from "@avallon-labs/sdk";
+ *
+ * // 1. Generate PKCE pair
+ * const verifier = generateCodeVerifier();
+ * const challenge = await generateCodeChallenge(verifier);
+ *
+ * // 2. Get OAuth URL (store verifier for after redirect)
+ * sessionStorage.setItem("oauth_verifier", verifier);
+ * const { data } = await getV1AuthOauthUrl({
+ *   provider: "google",
+ *   redirect_uri: "https://app.example.com/callback",
+ *   code_challenge: challenge,
+ *   code_challenge_method: "s256",
+ * });
+ * window.location.href = data.data.url;
+ *
+ * // 3. After redirect, exchange code for tokens
+ * const verifier = sessionStorage.getItem("oauth_verifier");
+ * const tokens = await postV1AuthOauthExchange({
+ *   code: urlParams.get("code"),
+ *   code_verifier: verifier,
+ * });
+ * ```
+ */
+/** Generate a cryptographically random code verifier (43-128 chars) */
+declare function generateCodeVerifier(length?: number): string;
+/** Generate S256 code challenge from verifier */
+declare function generateCodeChallenge(verifier: string): Promise<string>;
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type AgentBackgroundSounds = (typeof AgentBackgroundSounds)[keyof typeof AgentBackgroundSounds];
+declare const AgentBackgroundSounds: {
+    readonly enabled: "enabled";
+    readonly disabled: "disabled";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type AgentDirection = (typeof AgentDirection)[keyof typeof AgentDirection];
+declare const AgentDirection: {
+    readonly INBOUND: "INBOUND";
+    readonly OUTBOUND: "OUTBOUND";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type AgentLanguage = (typeof AgentLanguage)[keyof typeof AgentLanguage];
+declare const AgentLanguage: {
+    readonly "en-US": "en-US";
+    readonly "de-DE": "de-DE";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type AgentLlmModel = (typeof AgentLlmModel)[keyof typeof AgentLlmModel];
+declare const AgentLlmModel: {
+    readonly GPT41: "GPT4.1";
+    readonly "AZURE-GPT4o": "AZURE-GPT4o";
+    readonly "AZURE-GPT41": "AZURE-GPT4.1";
+    readonly "GPT-5": "GPT-5";
+    readonly "GPT-5-low": "GPT-5-low";
+    readonly "GPT-5-high": "GPT-5-high";
+    readonly "GPT-51-chat-latest": "GPT-5.1-chat-latest";
+    readonly "GPT-51-no-reasoning": "GPT-5.1-no-reasoning";
+    readonly "GEMINI-15-flash": "GEMINI-1.5-flash";
+    readonly "GEMINI-25-flash": "GEMINI-2.5-flash";
+    readonly "GEMINI-25-flash-lite": "GEMINI-2.5-flash-lite";
+    readonly "GEMINI-3-flash": "GEMINI-3-flash";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type AgentSttModel = (typeof AgentSttModel)[keyof typeof AgentSttModel];
+declare const AgentSttModel: {
+    readonly "DEEPGRAM-NOVA-2-GENERAL": "DEEPGRAM-NOVA-2-GENERAL";
+    readonly "DEEPGRAM-NOVA-3-GENERAL": "DEEPGRAM-NOVA-3-GENERAL";
+    readonly "AWS-TRANSCRIBE": "AWS-TRANSCRIBE";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type AgentTtsModel = (typeof AgentTtsModel)[keyof typeof AgentTtsModel];
+declare const AgentTtsModel: {
+    readonly eleven_flash_v2_5: "eleven_flash_v2_5";
+    readonly eleven_turbo_v2_5: "eleven_turbo_v2_5";
+    readonly "sonic-multilingual": "sonic-multilingual";
+    readonly "sonic-3": "sonic-3";
+    readonly chirp_3: "chirp_3";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type AgentTtsProvider = (typeof AgentTtsProvider)[keyof typeof AgentTtsProvider];
+declare const AgentTtsProvider: {
+    readonly elevenlabs: "elevenlabs";
+    readonly cartesia: "cartesia";
+    readonly google: "google";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+interface Agent {
+    id: string;
+    tenant_id: string;
+    agent_name: string;
+    direction: AgentDirection;
+    llm_model: AgentLlmModel;
+    tts_provider: AgentTtsProvider;
+    tts_model: AgentTtsModel;
+    language: AgentLanguage;
+    tts_voice_id: string;
+    stt_model: AgentSttModel;
+    transfer_phone_number: string | null;
+    background_sounds: AgentBackgroundSounds;
+    created_at: string;
+    updated_at: string;
+    phone_number: string | null;
+    dial_pad: boolean;
+    end_call: boolean;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+interface AgentList {
+    agents: Agent[];
+    /**
+     * Total number of agents
+     * @minimum -9007199254740991
+     * @maximum 9007199254740991
+     */
+    total: number;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+interface ApiKey {
+    /** Unique identifier for the API key */
+    id: string;
+    /** Human-readable name for the API key */
+    name: string;
+    /** First 12 characters of the key (e.g. ak_live_abc1) */
+    key_prefix: string;
+    /** Last usage timestamp, if ever used */
+    last_used_at?: string;
+    /** Expiration date, if set */
+    expires_at?: string;
+    /** Revocation timestamp, if revoked */
+    revoked_at?: string;
+    /** Creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+interface ApiKeyCreated {
+    /** Unique identifier for the API key */
+    id: string;
+    /** Human-readable name for the API key */
+    name: string;
+    /** First 12 characters of the key (e.g. ak_live_abc1) */
+    key_prefix: string;
+    /** Expiration date, if set */
+    expires_at?: string;
+    /** Creation timestamp */
+    created_at: string;
+    /** The full API key — only returned once at creation */
+    api_key: string;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+interface ApiKeyList {
+    data: ApiKey[];
+    /** Total number of keys returned */
+    count: number;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+interface AuthTokens {
+    access_token: string;
+    refresh_token: string;
+    expires_at: string;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+interface ConfirmationResponse {
+    /** Confirmation message */
+    message: string;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * Call direction the agent handles
+ */
+type CreateAgentBodyDirection = (typeof CreateAgentBodyDirection)[keyof typeof CreateAgentBodyDirection];
+declare const CreateAgentBodyDirection: {
+    readonly OUTBOUND: "OUTBOUND";
+    readonly INBOUND: "INBOUND";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * Language for the agent
+ */
+type CreateAgentBodyLanguage = (typeof CreateAgentBodyLanguage)[keyof typeof CreateAgentBodyLanguage];
+declare const CreateAgentBodyLanguage: {
+    readonly "en-US": "en-US";
+    readonly "de-DE": "de-DE";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * LLM model for conversation
+ */
+type CreateAgentBodyLlmModel = (typeof CreateAgentBodyLlmModel)[keyof typeof CreateAgentBodyLlmModel];
+declare const CreateAgentBodyLlmModel: {
+    readonly GPT41: "GPT4.1";
+    readonly "AZURE-GPT4o": "AZURE-GPT4o";
+    readonly "AZURE-GPT41": "AZURE-GPT4.1";
+    readonly "GPT-5": "GPT-5";
+    readonly "GPT-5-low": "GPT-5-low";
+    readonly "GPT-5-high": "GPT-5-high";
+    readonly "GPT-51-chat-latest": "GPT-5.1-chat-latest";
+    readonly "GPT-51-no-reasoning": "GPT-5.1-no-reasoning";
+    readonly "GEMINI-15-flash": "GEMINI-1.5-flash";
+    readonly "GEMINI-25-flash": "GEMINI-2.5-flash";
+    readonly "GEMINI-25-flash-lite": "GEMINI-2.5-flash-lite";
+    readonly "GEMINI-3-flash": "GEMINI-3-flash";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * Speech-to-text model
+ */
+type CreateAgentBodySttModel = (typeof CreateAgentBodySttModel)[keyof typeof CreateAgentBodySttModel];
+declare const CreateAgentBodySttModel: {
+    readonly "DEEPGRAM-NOVA-2-GENERAL": "DEEPGRAM-NOVA-2-GENERAL";
+    readonly "DEEPGRAM-NOVA-3-GENERAL": "DEEPGRAM-NOVA-3-GENERAL";
+    readonly "AWS-TRANSCRIBE": "AWS-TRANSCRIBE";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * Text-to-speech model
+ */
+type CreateAgentBodyTtsModel = (typeof CreateAgentBodyTtsModel)[keyof typeof CreateAgentBodyTtsModel];
+declare const CreateAgentBodyTtsModel: {
+    readonly eleven_flash_v2_5: "eleven_flash_v2_5";
+    readonly eleven_turbo_v2_5: "eleven_turbo_v2_5";
+    readonly "sonic-multilingual": "sonic-multilingual";
+    readonly "sonic-3": "sonic-3";
+    readonly chirp_3: "chirp_3";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * Text-to-speech provider
+ */
+type CreateAgentBodyTtsProvider = (typeof CreateAgentBodyTtsProvider)[keyof typeof CreateAgentBodyTtsProvider];
+declare const CreateAgentBodyTtsProvider: {
+    readonly elevenlabs: "elevenlabs";
+    readonly cartesia: "cartesia";
+    readonly google: "google";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+type CreateAgentBody = {
+    /**
+     * Name for the agent
+     * @minLength 1
+     */
+    agent_name: string;
+    /** Call direction the agent handles */
+    direction: CreateAgentBodyDirection;
+    /** LLM model for conversation */
+    llm_model: CreateAgentBodyLlmModel;
+    /** Text-to-speech provider */
+    tts_provider: CreateAgentBodyTtsProvider;
+    /** Text-to-speech model */
+    tts_model: CreateAgentBodyTtsModel;
+    /** Voice ID from the TTS provider */
+    tts_voice_id: "Achernar" | "Achird" | "v3V1d2rk6528UrLKRuy8" | "5c42302c-194b-4d0c-ba1a-8cb485c84ab9" | "e8e5fffb-252c-436d-b842-8879b84445b6" | "f786b574-daa5-4673-aa0c-cbe3e8534c02" | "8d8ce8c9-44a4-46c4-b10f-9a927b99a853" | "5ee9feff-1265-424a-9d7f-8e4d431a12c7" | "b9de4a89-2257-424b-94c2-db18ba68c81a";
+    /** Speech-to-text model */
+    stt_model: CreateAgentBodySttModel;
+    /** Phone number to transfer calls to */
+    transfer_phone_number: string | null;
+    /** ID of phone number to assign to agent */
+    phone_number_id?: string;
+    /** Language for the agent */
+    language: CreateAgentBodyLanguage;
+    /** Whether the agent supports DTMF dial pad input */
+    dial_pad?: boolean;
+    /** Whether the agent can end the call */
+    end_call?: boolean;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+interface CreateAgentResponse {
+    agent: Agent;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+/**
+ * Target environment for the key
+ */
+type CreateApiKeyBodyEnvironment = (typeof CreateApiKeyBodyEnvironment)[keyof typeof CreateApiKeyBodyEnvironment];
+declare const CreateApiKeyBodyEnvironment: {
+    readonly test: "test";
+    readonly live: "live";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+type CreateApiKeyBody = {
+    /**
+     * Human-readable name for the API key
+     * @minLength 1
+     * @maxLength 100
+     */
+    name: string;
+    /** Optional expiration date (ISO 8601) */
+    expires_at?: string;
+    /** Target environment for the key */
+    environment?: CreateApiKeyBodyEnvironment;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+interface EmptyResponse {
+    [key: string]: unknown;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type ErrorResponseData = {
+    [key: string]: unknown;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+interface ErrorResponse {
+    data: ErrorResponseData;
+    /** Human-readable error message */
+    message: string;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+interface GetAgentResponse {
+    agent: Agent;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type GetV1AuthOauthUrlCodeChallengeMethod = (typeof GetV1AuthOauthUrlCodeChallengeMethod)[keyof typeof GetV1AuthOauthUrlCodeChallengeMethod];
+declare const GetV1AuthOauthUrlCodeChallengeMethod: {
+    readonly plain: "plain";
+    readonly s256: "s256";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type GetV1AuthOauthUrlProvider = (typeof GetV1AuthOauthUrlProvider)[keyof typeof GetV1AuthOauthUrlProvider];
+declare const GetV1AuthOauthUrlProvider: {
+    readonly google: "google";
+    readonly microsoft: "microsoft";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+type GetV1AuthOauthUrlParams = {
+    provider: GetV1AuthOauthUrlProvider;
+    redirect_uri: string;
+    code_challenge_method: GetV1AuthOauthUrlCodeChallengeMethod;
+    /**
+     * @minLength 1
+     */
+    code_challenge: string;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type ListAgentsParams = {
+    /**
+     * Filter by exact agent name
+     */
+    agent_name?: string;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type ListApiKeysIncludeRevoked = (typeof ListApiKeysIncludeRevoked)[keyof typeof ListApiKeysIncludeRevoked];
+declare const ListApiKeysIncludeRevoked: {
+    readonly true: "true";
+    readonly false: "false";
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+
+type ListApiKeysParams = {
+    /**
+     * Include revoked keys in the response
+     */
+    include_revoked?: ListApiKeysIncludeRevoked;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+interface OAuthUrl {
+    url: string;
+}
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type PostV1AuthRefreshTokenBody = {
+    access_token: string;
+    refresh_token: string;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type PostV1AuthSignInBody = {
+    type: "password";
+    email: string;
+    password: string;
+} | {
+    type: "oauth";
+    code: string;
+    verifier: string;
+} | {
+    type: "email_otp";
+    /** @pattern ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ */
+    email: string;
+    /** @minLength 1 */
+    token: string;
+};
+
+/**
+ * Generated by orval v8.1.0 🍺
+ * Do not edit manually.
+ * Avallon API
+ * OpenAPI spec version: 1.0.0
+ */
+type PostV1AuthSignUpBody = {
+    /** @pattern ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ */
+    email: string;
+    password: string;
+};
+
+type SecondParameter$2<T extends (...args: never) => unknown> = Parameters<T>[1];
+/**
+ * List all agents for your tenant.
+
+**Filtering:**
+
+Filter agents by name using the `agent_name` query parameter (exact match).
+
+**Response:**
+
+Returns an array of all agents with their configurations and a total count.
+ * @summary List agents
+ */
+declare const getListAgentsUrl: (params?: ListAgentsParams) => string;
+declare const listAgents: (params?: ListAgentsParams, options?: RequestInit) => Promise<AgentList>;
+declare const getListAgentsKey: (params?: ListAgentsParams) => readonly ["/v1/agents", ...ListAgentsParams[]];
+type ListAgentsQueryResult = NonNullable<Awaited<ReturnType<typeof listAgents>>>;
+/**
+ * @summary List agents
+ */
+declare const useListAgents: <TError = ErrorType<ErrorResponse>>(params?: ListAgentsParams, options?: {
+    swr?: SWRConfiguration<Awaited<ReturnType<typeof listAgents>>, TError> & {
+        swrKey?: Key;
+        enabled?: boolean;
+    };
+    request?: SecondParameter$2<typeof customFetch>;
+}) => {
+    data: AgentList | undefined;
+    error: TError | undefined;
+    mutate: swr.KeyedMutator<AgentList>;
+    isValidating: boolean;
+    isLoading: swr__internal.IsLoadingResponse<Data, Config>;
+    swrKey: string | false | readonly [any, ...unknown[]] | Record<any, any> | (() => swr.Arguments);
+};
+/**
+ * Create a new voice agent with the specified configuration.
+
+**Required fields:**
+
+All fields in the request body are required except `phone_number_id` and `transfer_phone_number`.
+
+**Response:**
+
+Returns the created agent with its ID and configuration.
+ * @summary Create agent
+ */
+declare const getCreateAgentUrl: () => string;
+declare const createAgent: (createAgentBody: CreateAgentBody, options?: RequestInit) => Promise<CreateAgentResponse>;
+declare const getCreateAgentMutationFetcher: (options?: SecondParameter$2<typeof customFetch>) => (_: Key, { arg }: {
+    arg: CreateAgentBody;
+}) => Promise<CreateAgentResponse>;
+declare const getCreateAgentMutationKey: () => readonly ["/v1/agents"];
+type CreateAgentMutationResult = NonNullable<Awaited<ReturnType<typeof createAgent>>>;
+/**
+ * @summary Create agent
+ */
+declare const useCreateAgent: <TError = ErrorType<ErrorResponse>>(options?: {
+    swr?: SWRMutationConfiguration<Awaited<ReturnType<typeof createAgent>>, TError, Key, CreateAgentBody, Awaited<ReturnType<typeof createAgent>>> & {
+        swrKey?: string;
+    };
+    request?: SecondParameter$2<typeof customFetch>;
+}) => {
+    isMutating: boolean;
+    trigger: swr_mutation.TriggerWithArgs<CreateAgentResponse, TError, string | readonly ["/v1/agents"], CreateAgentBody>;
+    reset: () => void;
+    data: CreateAgentResponse | undefined;
+    error: TError | undefined;
+    swrKey: string | readonly ["/v1/agents"];
+};
+/**
+ * Retrieve a single agent by ID.
+ * @summary Get agent
+ */
+declare const getGetAgentUrl: (id: string) => string;
+declare const getAgent: (id: string, options?: RequestInit) => Promise<GetAgentResponse>;
+declare const getGetAgentKey: (id: string) => readonly [`/v1/agents/${string}`];
+type GetAgentQueryResult = NonNullable<Awaited<ReturnType<typeof getAgent>>>;
+/**
+ * @summary Get agent
+ */
+declare const useGetAgent: <TError = ErrorType<ErrorResponse>>(id: string, options?: {
+    swr?: SWRConfiguration<Awaited<ReturnType<typeof getAgent>>, TError> & {
+        swrKey?: Key;
+        enabled?: boolean;
+    };
+    request?: SecondParameter$2<typeof customFetch>;
+}) => {
+    data: GetAgentResponse | undefined;
+    error: TError | undefined;
+    mutate: swr.KeyedMutator<GetAgentResponse>;
+    isValidating: boolean;
+    isLoading: swr__internal.IsLoadingResponse<Data, Config>;
+    swrKey: string | false | readonly [any, ...unknown[]] | Record<any, any> | (() => swr.Arguments);
+};
+
+type SecondParameter$1<T extends (...args: never) => unknown> = Parameters<T>[1];
+/**
+ * List all API keys for your tenant.
+
+By default, revoked keys are excluded. Set `include_revoked=true` to include them.
+
+**Note:** The full API key value is never returned — only the key prefix is shown.
+ * @summary List API keys
+ */
+declare const getListApiKeysUrl: (params?: ListApiKeysParams) => string;
+declare const listApiKeys: (params?: ListApiKeysParams, options?: RequestInit) => Promise<ApiKeyList>;
+declare const getListApiKeysKey: (params?: ListApiKeysParams) => readonly ["/platform/api-keys", ...ListApiKeysParams[]];
+type ListApiKeysQueryResult = NonNullable<Awaited<ReturnType<typeof listApiKeys>>>;
+/**
+ * @summary List API keys
+ */
+declare const useListApiKeys: <TError = ErrorType<ErrorResponse>>(params?: ListApiKeysParams, options?: {
+    swr?: SWRConfiguration<Awaited<ReturnType<typeof listApiKeys>>, TError> & {
+        swrKey?: Key;
+        enabled?: boolean;
+    };
+    request?: SecondParameter$1<typeof customFetch>;
+}) => {
+    data: ApiKeyList | undefined;
+    error: TError | undefined;
+    mutate: swr.KeyedMutator<ApiKeyList>;
+    isValidating: boolean;
+    isLoading: swr__internal.IsLoadingResponse<Data, Config>;
+    swrKey: string | false | readonly [any, ...unknown[]] | Record<any, any> | (() => Arguments);
+};
+/**
+ * Create a new API key for authenticating with the Avallon API.
+
+**Important:** The full API key is only returned once in the response. Store it securely — it cannot be retrieved again.
+
+Keys are scoped to an environment (`test` or `live`) and optionally accept an expiration date.
+ * @summary Create an API key
+ */
+declare const getCreateApiKeyUrl: () => string;
+declare const createApiKey: (createApiKeyBody: CreateApiKeyBody, options?: RequestInit) => Promise<ApiKeyCreated>;
+declare const getCreateApiKeyMutationFetcher: (options?: SecondParameter$1<typeof customFetch>) => (_: Key, { arg }: {
+    arg: CreateApiKeyBody;
+}) => Promise<ApiKeyCreated>;
+declare const getCreateApiKeyMutationKey: () => readonly ["/platform/api-keys"];
+type CreateApiKeyMutationResult = NonNullable<Awaited<ReturnType<typeof createApiKey>>>;
+/**
+ * @summary Create an API key
+ */
+declare const useCreateApiKey: <TError = ErrorType<ErrorResponse>>(options?: {
+    swr?: SWRMutationConfiguration<Awaited<ReturnType<typeof createApiKey>>, TError, Key, CreateApiKeyBody, Awaited<ReturnType<typeof createApiKey>>> & {
+        swrKey?: string;
+    };
+    request?: SecondParameter$1<typeof customFetch>;
+}) => {
+    isMutating: boolean;
+    trigger: swr_mutation.TriggerWithArgs<ApiKeyCreated, TError, string | readonly ["/platform/api-keys"], CreateApiKeyBody>;
+    reset: () => void;
+    data: ApiKeyCreated | undefined;
+    error: TError | undefined;
+    swrKey: string | readonly ["/platform/api-keys"];
+};
+/**
+ * Revoke an existing API key. Once revoked, the key can no longer be used for authentication.
+
+This operation is irreversible — revoked keys cannot be re-enabled. Create a new key if needed.
+
+Returns 409 if the key is already revoked, 404 if the key does not exist.
+ * @summary Revoke an API key
+ */
+declare const getRevokeApiKeyUrl: (id: string) => string;
+declare const revokeApiKey: (id: string, options?: RequestInit) => Promise<ConfirmationResponse>;
+declare const getRevokeApiKeyMutationFetcher: (id: string, options?: SecondParameter$1<typeof customFetch>) => (_: Key, __: {
+    arg: Arguments;
+}) => Promise<ConfirmationResponse>;
+declare const getRevokeApiKeyMutationKey: (id: string) => readonly [`/platform/api-keys/${string}/revoke`];
+type RevokeApiKeyMutationResult = NonNullable<Awaited<ReturnType<typeof revokeApiKey>>>;
+/**
+ * @summary Revoke an API key
+ */
+declare const useRevokeApiKey: <TError = ErrorType<ErrorResponse>>(id: string, options?: {
+    swr?: SWRMutationConfiguration<Awaited<ReturnType<typeof revokeApiKey>>, TError, Key, Arguments, Awaited<ReturnType<typeof revokeApiKey>>> & {
+        swrKey?: string;
+    };
+    request?: SecondParameter$1<typeof customFetch>;
+}) => {
+    isMutating: boolean;
+    trigger: swr_mutation.TriggerWithOptionsArgs<ConfirmationResponse, TError, string | readonly [`/platform/api-keys/${string}/revoke`], Arguments>;
+    reset: () => void;
+    data: ConfirmationResponse | undefined;
+    error: TError | undefined;
+    swrKey: string | readonly [`/platform/api-keys/${string}/revoke`];
+};
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+declare const getPostV1AuthSignUpUrl: () => string;
+declare const postV1AuthSignUp: (postV1AuthSignUpBody: PostV1AuthSignUpBody, options?: RequestInit) => Promise<EmptyResponse>;
+declare const getPostV1AuthSignUpMutationFetcher: (options?: SecondParameter<typeof customFetchNoAuth>) => (_: Key, { arg }: {
+    arg: PostV1AuthSignUpBody;
+}) => Promise<EmptyResponse>;
+declare const getPostV1AuthSignUpMutationKey: () => readonly ["/v1/auth/sign-up"];
+type PostV1AuthSignUpMutationResult = NonNullable<Awaited<ReturnType<typeof postV1AuthSignUp>>>;
+declare const usePostV1AuthSignUp: <TError = ErrorType<ErrorResponse>>(options?: {
+    swr?: SWRMutationConfiguration<Awaited<ReturnType<typeof postV1AuthSignUp>>, TError, Key, PostV1AuthSignUpBody, Awaited<ReturnType<typeof postV1AuthSignUp>>> & {
+        swrKey?: string;
+    };
+    request?: SecondParameter<typeof customFetchNoAuth>;
+}) => {
+    isMutating: boolean;
+    trigger: swr_mutation.TriggerWithArgs<EmptyResponse, TError, string | readonly ["/v1/auth/sign-up"], PostV1AuthSignUpBody>;
+    reset: () => void;
+    data: EmptyResponse | undefined;
+    error: TError | undefined;
+    swrKey: string | readonly ["/v1/auth/sign-up"];
+};
+declare const getPostV1AuthSignInUrl: () => string;
+declare const postV1AuthSignIn: (postV1AuthSignInBody: PostV1AuthSignInBody, options?: RequestInit) => Promise<AuthTokens>;
+declare const getPostV1AuthSignInMutationFetcher: (options?: SecondParameter<typeof customFetchNoAuth>) => (_: Key, { arg }: {
+    arg: PostV1AuthSignInBody;
+}) => Promise<AuthTokens>;
+declare const getPostV1AuthSignInMutationKey: () => readonly ["/v1/auth/sign-in"];
+type PostV1AuthSignInMutationResult = NonNullable<Awaited<ReturnType<typeof postV1AuthSignIn>>>;
+declare const usePostV1AuthSignIn: <TError = ErrorType<ErrorResponse>>(options?: {
+    swr?: SWRMutationConfiguration<Awaited<ReturnType<typeof postV1AuthSignIn>>, TError, Key, PostV1AuthSignInBody, Awaited<ReturnType<typeof postV1AuthSignIn>>> & {
+        swrKey?: string;
+    };
+    request?: SecondParameter<typeof customFetchNoAuth>;
+}) => {
+    isMutating: boolean;
+    trigger: swr_mutation.TriggerWithArgs<AuthTokens, TError, string | readonly ["/v1/auth/sign-in"], PostV1AuthSignInBody>;
+    reset: () => void;
+    data: AuthTokens | undefined;
+    error: TError | undefined;
+    swrKey: string | readonly ["/v1/auth/sign-in"];
+};
+declare const getPostV1AuthRefreshTokenUrl: () => string;
+declare const postV1AuthRefreshToken: (postV1AuthRefreshTokenBody: PostV1AuthRefreshTokenBody, options?: RequestInit) => Promise<AuthTokens>;
+declare const getPostV1AuthRefreshTokenMutationFetcher: (options?: SecondParameter<typeof customFetchNoAuth>) => (_: Key, { arg }: {
+    arg: PostV1AuthRefreshTokenBody;
+}) => Promise<AuthTokens>;
+declare const getPostV1AuthRefreshTokenMutationKey: () => readonly ["/v1/auth/refresh-token"];
+type PostV1AuthRefreshTokenMutationResult = NonNullable<Awaited<ReturnType<typeof postV1AuthRefreshToken>>>;
+declare const usePostV1AuthRefreshToken: <TError = ErrorType<ErrorResponse>>(options?: {
+    swr?: SWRMutationConfiguration<Awaited<ReturnType<typeof postV1AuthRefreshToken>>, TError, Key, PostV1AuthRefreshTokenBody, Awaited<ReturnType<typeof postV1AuthRefreshToken>>> & {
+        swrKey?: string;
+    };
+    request?: SecondParameter<typeof customFetchNoAuth>;
+}) => {
+    isMutating: boolean;
+    trigger: swr_mutation.TriggerWithArgs<AuthTokens, TError, string | readonly ["/v1/auth/refresh-token"], PostV1AuthRefreshTokenBody>;
+    reset: () => void;
+    data: AuthTokens | undefined;
+    error: TError | undefined;
+    swrKey: string | readonly ["/v1/auth/refresh-token"];
+};
+declare const getGetV1AuthOauthUrlUrl: (params: GetV1AuthOauthUrlParams) => string;
+declare const getV1AuthOauthUrl: (params: GetV1AuthOauthUrlParams, options?: RequestInit) => Promise<OAuthUrl>;
+declare const getGetV1AuthOauthUrlKey: (params: GetV1AuthOauthUrlParams) => readonly ["/v1/auth/oauth-url", ...GetV1AuthOauthUrlParams[]];
+type GetV1AuthOauthUrlQueryResult = NonNullable<Awaited<ReturnType<typeof getV1AuthOauthUrl>>>;
+declare const useGetV1AuthOauthUrl: <TError = ErrorType<ErrorResponse>>(params: GetV1AuthOauthUrlParams, options?: {
+    swr?: SWRConfiguration<Awaited<ReturnType<typeof getV1AuthOauthUrl>>, TError> & {
+        swrKey?: Key;
+        enabled?: boolean;
+    };
+    request?: SecondParameter<typeof customFetchNoAuth>;
+}) => {
+    data: OAuthUrl | undefined;
+    error: TError | undefined;
+    mutate: swr.KeyedMutator<OAuthUrl>;
+    isValidating: boolean;
+    isLoading: swr__internal.IsLoadingResponse<Data, Config>;
+    swrKey: string | false | readonly [any, ...unknown[]] | Record<any, any> | (() => swr.Arguments);
+};
+
+export { type Agent, AgentBackgroundSounds, AgentDirection, AgentLanguage, type AgentList, AgentLlmModel, AgentSttModel, AgentTtsModel, AgentTtsProvider, type ApiKey, type ApiKeyCreated, type ApiKeyList, type AuthTokens, type AvallonConfig, AvallonError, type ConfirmationResponse, type CreateAgentBody, CreateAgentBodyDirection, CreateAgentBodyLanguage, CreateAgentBodyLlmModel, CreateAgentBodySttModel, CreateAgentBodyTtsModel, CreateAgentBodyTtsProvider, type CreateAgentMutationResult, type CreateAgentResponse, type CreateApiKeyBody, CreateApiKeyBodyEnvironment, type CreateApiKeyMutationResult, type EmptyResponse, type ErrorResponse, type ErrorResponseData, type GetAgentQueryResult, type GetAgentResponse, GetV1AuthOauthUrlCodeChallengeMethod, type GetV1AuthOauthUrlParams, GetV1AuthOauthUrlProvider, type GetV1AuthOauthUrlQueryResult, type ListAgentsParams, type ListAgentsQueryResult, ListApiKeysIncludeRevoked, type ListApiKeysParams, type ListApiKeysQueryResult, type OAuthUrl, type PostV1AuthRefreshTokenBody, type PostV1AuthRefreshTokenMutationResult, type PostV1AuthSignInBody, type PostV1AuthSignInMutationResult, type PostV1AuthSignUpBody, type PostV1AuthSignUpMutationResult, type RevokeApiKeyMutationResult, configure, createAgent, createApiKey, generateCodeChallenge, generateCodeVerifier, getAgent, getConfig, getCreateAgentMutationFetcher, getCreateAgentMutationKey, getCreateAgentUrl, getCreateApiKeyMutationFetcher, getCreateApiKeyMutationKey, getCreateApiKeyUrl, getGetAgentKey, getGetAgentUrl, getGetV1AuthOauthUrlKey, getGetV1AuthOauthUrlUrl, getListAgentsKey, getListAgentsUrl, getListApiKeysKey, getListApiKeysUrl, getPostV1AuthRefreshTokenMutationFetcher, getPostV1AuthRefreshTokenMutationKey, getPostV1AuthRefreshTokenUrl, getPostV1AuthSignInMutationFetcher, getPostV1AuthSignInMutationKey, getPostV1AuthSignInUrl, getPostV1AuthSignUpMutationFetcher, getPostV1AuthSignUpMutationKey, getPostV1AuthSignUpUrl, getRevokeApiKeyMutationFetcher, getRevokeApiKeyMutationKey, getRevokeApiKeyUrl, getV1AuthOauthUrl, listAgents, listApiKeys, postV1AuthRefreshToken, postV1AuthSignIn, postV1AuthSignUp, revokeApiKey, useCreateAgent, useCreateApiKey, useGetAgent, useGetV1AuthOauthUrl, useListAgents, useListApiKeys, usePostV1AuthRefreshToken, usePostV1AuthSignIn, usePostV1AuthSignUp, useRevokeApiKey };