getpatter 0.6.5 → 0.6.7

package/dist/index.d.ts

@@ -909,6 +909,9 @@ interface CallMetrics {
     readonly stt_model?: string;
     readonly tts_model?: string;
     readonly llm_model?: string;
+    /** Terminal error code when the call ended abnormally (a lowercased ErrorCode
+     * value or "other"); empty/absent for a clean call. Never the message. */
+    readonly error_code?: string;
 }
 /** Programmatic control surface for a live call (transfer, hangup, DTMF). */
 interface CallControl {
@@ -949,6 +952,7 @@ declare class CallMetricsAccumulator {
     readonly ttsModel: string;
     readonly realtimeModel: string;
     private readonly _pricing;
+    private _errorCode;
     private readonly _callStart;
     private readonly _turns;
     private _turnStart;
@@ -1259,6 +1263,12 @@ declare class CallMetricsAccumulator {
     recordLlmUsage(provider: string, model: string, inputTokens: number, outputTokens: number, cacheReadTokens?: number, cacheWriteTokens?: number): void;
     /** Finalize the call: flush any in-flight turn, compute aggregates, and return `CallMetrics`. */
     endCall(): CallMetrics;
+    /**
+     * Record the call's terminal error as a coarse, anonymous code. Stores the
+     * PatterError `.code` lowercased; maps common timeout/connection errors; falls
+     * back to "other". Never stores the message. Last write wins.
+     */
+    recordError(err: unknown): void;
     /** Return the cost breakdown for the call so far without ending it. */
     getCostSoFar(): CostBreakdown;
     /**
@@ -2266,6 +2276,17 @@ interface LLMStreamOptions {
      * config) no ``user`` field is sent — fully backward compatible.
      */
     callId?: string;
+    /**
+     * Caller / callee for this turn (the same values the stream handler builds
+     * into ``callCtx.caller`` / ``callCtx.callee``). Threaded purely so a
+     * session-aware provider with a ``sessionKeyFactory`` can derive a per-caller
+     * memory scope from the NON-REVERSIBLE caller hash. Additive and optional:
+     * providers that read only ``signal`` / ``callId`` ignore them, and the raw
+     * ``caller`` is never logged. Mirrors the Python loop threading
+     * ``caller`` / ``callee`` into the provider's ``stream``.
+     */
+    caller?: string;
+    callee?: string;
 }
 interface LLMProvider {
     stream(messages: Array<Record<string, unknown>>, tools?: Array<Record<string, unknown>> | null, opts?: LLMStreamOptions): AsyncGenerator<LLMChunk, void, unknown>;
@@ -2819,6 +2840,18 @@ interface LocalOptions {
      * used via ``phone.agent({ engine: new OpenAIRealtime({ apiKey }) })``.
      */
     readonly openaiKey?: string;
+    /**
+     * Anonymous usage telemetry (opt-out, **on by default**). Lets the Patter
+     * maintainers see coarse, anonymous usage (engines/providers/carriers, OS,
+     * SDK version) — never PII or call content. Fire-and-forget and fail-safe.
+     *
+     * - omitted / ``true``: enabled (unless disabled by ``PATTER_TELEMETRY_DISABLED=1``,
+     *   ``DO_NOT_TRACK=1``, or a CI/test environment).
+     * - ``false``: opt out in code.
+     *
+     * Inspect-without-send with ``PATTER_TELEMETRY_DEBUG=1``. See the telemetry docs.
+     */
+    readonly telemetry?: boolean;
 }
 /** Internal shape of a guardrail (matches `Guardrail` class from `public-api.ts`). */
 interface Guardrail {
@@ -2936,6 +2969,28 @@ interface BackgroundAudioPlayer$1 {
  *    (see ``Patter.agent()`` for the resolution).
  * 3. Otherwise, the AgentOptions default is used.
  */
+/**
+ * Per-call context handed to a ``sessionKeyFactory`` (see
+ * {@link OpenAICompatibleLLMOptions.sessionKeyFactory}).
+ *
+ * A session-aware LLM provider (e.g. the Hermes preset) can derive its
+ * memory-scope header value per call from this — most usefully from
+ * {@link SessionContext.callerHash}, a stable non-reversible hash of the
+ * caller, so one phone number maps to one durable memory namespace across calls
+ * WITHOUT the raw number ever being emitted or logged.
+ *
+ * All fields are optional: ``callId`` / ``caller`` / ``callee`` are present when
+ * the call provides them; ``callerHash`` is {@link hashCaller} of ``caller``
+ * (``undefined`` when there is no caller). The raw ``caller`` is carried here
+ * only so a factory CAN re-derive its own scope — it must never be put on the
+ * wire or logged beyond what already exists. Mirrors Python ``SessionContext``.
+ */
+interface SessionContext {
+    readonly callId?: string;
+    readonly caller?: string;
+    readonly callee?: string;
+    readonly callerHash?: string;
+}
 /** Configuration for a local-mode voice AI agent (passed to `phone.agent({...})`). */
 interface AgentOptions {
     readonly systemPrompt: string;
@@ -2971,6 +3026,26 @@ interface AgentOptions {
      * Mirrors Python ``llm_error_message`` on ``Patter.agent()`` / ``Agent``.
      */
     readonly llmErrorMessage?: string;
+    /**
+     * Opt-in short filler spoken when an LLM turn is SLOW (e.g. an agent runtime
+     * running tools / memory) and no audio has reached the carrier yet — DISTINCT
+     * from ``llmErrorMessage`` (which fires on an ERROR; this fires on SLOWNESS).
+     * When set to a non-empty string and the turn has produced NO audio after
+     * ``longTurnMessageAfterS`` seconds, the SDK synthesizes this line ONCE
+     * through the normal TTS turn lifecycle (subject to barge-in) to fill the
+     * gap. It never fires once real audio has started this turn, and never
+     * double-speaks. ``undefined`` (default) keeps today's behaviour: nothing is
+     * spoken while a slow turn runs. Pipeline mode only. Mirrors Python
+     * ``long_turn_message`` on ``Patter.agent()`` / ``Agent``.
+     */
+    readonly longTurnMessage?: string;
+    /**
+     * Seconds to wait after the turn begins speaking before the
+     * ``longTurnMessage`` filler fires (only consulted when ``longTurnMessage``
+     * is set and no audio has reached the carrier yet). Default ``4.0``. Mirrors
+     * Python ``long_turn_message_after_s``.
+     */
+    readonly longTurnMessageAfterS?: number;
     /** Tool definitions — ``Tool`` class instances from ``getpatter``. */
     readonly tools?: ReadonlyArray<Tool>;
     /**
@@ -3890,6 +3965,14 @@ declare class Patter {
      * ``Cannot use both tunnel: true and webhookUrl``.
      */
     private tunnelOwnsWebhookUrl;
+    /**
+     * Anonymous usage telemetry (opt-out, default ON). Separate from
+     * ``./observability`` (user-facing OTel). Fire-and-forget and fail-safe — it
+     * can never block or break a call. See ``./telemetry``.
+     */
+    private readonly telemetry;
+    private readonly telemetrySeenEngines;
+    private readonly telemetrySeenAgentShapes;
     /**
      * Pre-rendered first-message TTS audio per outbound call_id. Populated
      * by :meth:`call` when ``agent.prewarmFirstMessage`` is true; consumed
@@ -4964,6 +5047,7 @@ declare class PatterTool {
     private readonly maxDurationSec;
     private readonly recording;
     private started;
+    private hermesTelemetryEmitted;
     /** Cached in-progress (or completed) start promise so concurrent execute()
      *  callers all await the same boot sequence instead of each racing into
      *  phone.serve(). Reset to null on failure so callers can retry after a
@@ -6997,7 +7081,7 @@ interface OpenAILLMOptions {
  * const llm = new openai.LLM({ apiKey: "sk-...", model: "gpt-4o-mini", temperature: 0.4 });
  * ```
  */
-declare class LLM$7 extends OpenAILLMProvider {
+declare class LLM$8 extends OpenAILLMProvider {
     static readonly providerKey = "openai";
     constructor(opts?: OpenAILLMOptions);
 }
@@ -7108,7 +7192,7 @@ interface AnthropicLLMOptions {
  * const llm = new anthropic.LLM({ promptCaching: false });           // opt out of caching
  * ```
  */
-declare class LLM$6 extends AnthropicLLMProvider {
+declare class LLM$7 extends AnthropicLLMProvider {
     static readonly providerKey = "anthropic";
     constructor(opts?: AnthropicLLMOptions);
 }
@@ -7216,7 +7300,7 @@ interface GroqLLMOptions {
  * const llm = new groq.LLM({ apiKey: "gsk_...", model: "llama-3.3-70b-versatile" });
  * ```
  */
-declare class LLM$5 extends GroqLLMProvider {
+declare class LLM$6 extends GroqLLMProvider {
     static readonly providerKey = "groq";
     constructor(opts?: GroqLLMOptions);
 }
@@ -7361,7 +7445,7 @@ interface CerebrasLLMOptions {
  * const llm = new cerebras.LLM({ apiKey: "csk-...", model: "llama3.1-8b" });
  * ```
  */
-declare class LLM$4 extends CerebrasLLMProvider {
+declare class LLM$5 extends CerebrasLLMProvider {
     static readonly providerKey = "cerebras";
     constructor(opts?: CerebrasLLMOptions);
 }
@@ -7443,7 +7527,7 @@ interface GoogleLLMOptions {
  * const llm = new google.LLM({ apiKey: "AIza...", model: "gemini-2.5-flash" });
  * ```
  */
-declare class LLM$3 extends GoogleLLMProvider {
+declare class LLM$4 extends GoogleLLMProvider {
     static readonly providerKey = "google";
     constructor(opts?: GoogleLLMOptions);
 }
@@ -7494,6 +7578,20 @@ declare class LLM$3 extends GoogleLLMProvider {
  * ``Bearer EMPTY`` placeholder breaks some gateways).
  */
 
+/**
+ * Stable, non-reversible 16-char hash of a caller for session scoping.
+ *
+ * Used to derive a per-caller memory namespace (e.g. an agent runtime's session
+ * key) WITHOUT ever exposing the raw phone number — the call site keys cross-
+ * call memory off the hash, never the number itself. Returns the first 16 hex
+ * chars of the SHA-256 digest of the UTF-8 ``caller`` string, or ``undefined``
+ * when ``caller`` is undefined / empty. The 16-char (64-bit) truncation is
+ * plenty for namespacing while keeping the emitted header value compact; it is
+ * NOT a security primitive (a phone number has too little entropy to make the
+ * digest a secret) — its only job is to keep the raw number off the wire / out
+ * of logs. Mirrors Python ``hash_caller``.
+ */
+declare function hashCaller(caller?: string): string | undefined;
 /** Constructor options for {@link OpenAICompatibleLLMProvider}. */
 interface OpenAICompatibleLLMOptions {
     /**
@@ -7558,6 +7656,28 @@ interface OpenAICompatibleLLMOptions {
      * scope — NEVER logged. ``undefined`` (default) means the header is omitted.
      */
     sessionKey?: string;
+    /**
+     * Optional callback that derives the ``sessionKeyHeader`` VALUE per call from
+     * a {@link SessionContext} (carrying ``callId`` / ``caller`` / ``callee`` /
+     * ``callerHash``). When set it takes PRECEDENCE over the static ``sessionKey``:
+     * at request-build time the factory is called and its return value is emitted
+     * in ``sessionKeyHeader``. A falsy return (``undefined`` / ``''``) omits the
+     * header for that call. The static ``sessionKey`` remains the simple fallback
+     * used when no factory is configured. The returned value is a credential-grade
+     * memory scope and is NEVER logged. Mirrors Python ``session_key_factory``.
+     */
+    sessionKeyFactory?: (ctx: SessionContext) => string | undefined;
+    /**
+     * Convenience selector for a built-in per-call key derivation (requires
+     * ``sessionKeyHeader``). Set to ``'caller_hash'`` to derive the session key
+     * per call as ``` `patter-caller-${ctx.callerHash}` ``` (a stable,
+     * non-reversible hash of the caller — never the raw number), enabling
+     * per-caller cross-call memory on any runtime that scopes memory by header.
+     * ``undefined`` (default) uses the static ``sessionKey`` path. Ignored when
+     * ``sessionKeyFactory`` is given explicitly. Same semantics as the Hermes
+     * preset's selector; mirrors Python ``session_key_from``.
+     */
+    sessionKeyFrom?: 'caller_hash';
     /** Sampling temperature [0, 2]. */
     temperature?: number;
     /** Max tokens in the assistant response (sent as ``max_completion_tokens``). */
@@ -7603,6 +7723,7 @@ declare class OpenAICompatibleLLMProvider implements LLMProvider {
     private readonly sessionIdPrefix?;
     private readonly sessionKeyHeader?;
     private readonly sessionKey?;
+    private readonly sessionKeyFactory?;
     private readonly temperature?;
     private readonly maxTokens?;
     private readonly responseFormat?;
@@ -7627,6 +7748,14 @@ declare class OpenAICompatibleLLMProvider implements LLMProvider {
      * ``sessionKey`` is a credential-grade memory scope and is never logged.
      */
     private buildHeaders;
+    /**
+     * Resolve the ``sessionKeyHeader`` VALUE for this call. When a
+     * ``sessionKeyFactory`` is configured it is called with a
+     * {@link SessionContext} (the raw ``caller`` plus its non-reversible
+     * {@link hashCaller}) and its return value wins — a falsy return omits the
+     * header. Otherwise the static ``sessionKey`` is used. Never logged.
+     */
+    private resolveSessionKey;
     /**
      * Pre-call DNS / TLS warmup for the configured endpoint. Best-effort:
      * 5 s timeout, all exceptions swallowed at debug level. The ``Authorization``
@@ -7658,10 +7787,74 @@ declare class OpenAICompatibleLLMProvider implements LLMProvider {
  * });
  * ```
  */
-declare class LLM$2 extends OpenAICompatibleLLMProvider {
+declare class LLM$3 extends OpenAICompatibleLLMProvider {
     static readonly providerKey = "openai_compatible";
 }
 
+/**
+ * Custom LLM — point Patter's pipeline at ANY OpenAI-compatible endpoint.
+ *
+ * The industry-standard "Custom LLM" pattern (the same concept ElevenLabs
+ * Agents, Retell, and Vapi expose under that name): Patter owns the phone leg
+ * — carrier, STT, turn-taking, barge-in, TTS — and POSTs each conversation
+ * turn to YOUR ``/chat/completions`` endpoint. That endpoint can be:
+ *
+ * - an **agent runtime** (Hermes, OpenClaw — prefer the dedicated presets in
+ *   ``llm/hermes`` / ``llm/openclaw``, thin subclasses of this same engine
+ *   with the right defaults baked in),
+ * - a **local inference gateway** (Ollama, vLLM, LM Studio — keyless OK),
+ * - or **your own service** that speaks the OpenAI Chat Completions protocol
+ *   (SSE streaming, optional tool calls).
+ *
+ * ``CustomLLM`` is the canonical name for the generic engine
+ * ({@link OpenAICompatibleLLMProvider}): same streaming loop, same barge-in
+ * cancellation, same opt-in session continuity (per-call ``user`` field,
+ * per-call session-id header, and a static or factory-derived memory-scope
+ * header).
+ *
+ * @example
+ * ```ts
+ * import { CustomLLM } from "getpatter";
+ *
+ * // Your own agent service (any OpenAI-compatible /chat/completions):
+ * const llm = new CustomLLM({
+ *   baseUrl: "http://127.0.0.1:9000/v1",
+ *   model: "my-agent",
+ *   apiKeyEnv: "MY_AGENT_KEY",
+ *   timeout: 120,                  // agent runtimes run tools before replying
+ * });
+ *
+ * // Keyless local gateway (Ollama / vLLM / LM Studio):
+ * const llm = new CustomLLM({ baseUrl: "http://127.0.0.1:11434/v1", model: "llama3.1" });
+ *
+ * // Per-call session continuity + per-caller long-term memory, on a runtime
+ * // that scopes sessions/memory by header:
+ * const llm = new CustomLLM({
+ *   baseUrl: "http://127.0.0.1:9000/v1",
+ *   model: "my-agent",
+ *   sessionIdHeader: "X-My-Session-Id",   // value = `${prefix}${callId}`
+ *   sessionIdPrefix: "patter-call-",
+ *   sessionKeyHeader: "X-My-Memory-Key",
+ *   sessionKeyFrom: "caller_hash",        // patter-caller-<hash>
+ * });
+ * ```
+ */
+
+/** Constructor options for the generic Custom LLM provider. */
+type CustomLLMOptions = OpenAICompatibleLLMOptions;
+/**
+ * Generic "Custom LLM" provider for any OpenAI-compatible endpoint.
+ *
+ * All constructor options are inherited from
+ * {@link OpenAICompatibleLLMOptions} (``baseUrl`` and ``model`` are
+ * required). The Hermes / OpenClaw presets are subclasses of the same engine
+ * — use them when they exist; use this for everything else.
+ */
+declare class LLM$2 extends OpenAICompatibleLLMProvider {
+    /** Stable pricing/dashboard key — read by stream-handler/metrics. */
+    static readonly providerKey: string;
+}
+
 /**
  * Hermes agent-runtime LLM preset for Patter's pipeline mode.
  *
@@ -7690,11 +7883,28 @@ interface HermesLLMOptions {
     /** Per-request timeout in seconds. Default ``120``. */
     timeout?: number;
     /**
-     * Long-term memory scope. When set, emits ``X-Hermes-Session-Key`` so Hermes
-     * scopes durable memory to this value across calls. ``undefined`` (default)
-     * means the header is not sent. Credential-grade — never logged.
+     * Static long-term memory scope. When set, emits ``X-Hermes-Session-Key`` so
+     * Hermes scopes durable memory to this value across calls. ``undefined``
+     * (default) means the header is not sent. Credential-grade — never logged.
      */
     sessionKey?: string;
+    /**
+     * Convenience selector for a built-in per-call key derivation. Set to
+     * ``'caller_hash'`` to derive the session key per call as
+     * ``` `patter-caller-${ctx.callerHash}` ``` (a stable, non-reversible hash of
+     * the caller — never the raw number), enabling per-caller cross-call memory.
+     * ``undefined`` (default) uses the static ``sessionKey`` path. Ignored when
+     * ``sessionKeyFactory`` is given explicitly. Mirrors Python
+     * ``session_key_from``.
+     */
+    sessionKeyFrom?: 'caller_hash';
+    /**
+     * Custom callback deriving the ``X-Hermes-Session-Key`` value per call from a
+     * {@link SessionContext}. Takes precedence over both ``sessionKey`` and
+     * ``sessionKeyFrom``. A falsy return omits the header for that call.
+     * Credential-grade — never logged. Mirrors Python ``session_key_factory``.
+     */
+    sessionKeyFactory?: (ctx: SessionContext) => string | undefined;
     /** Extra headers merged after the SDK ``User-Agent``. */
     extraHeaders?: Record<string, string>;
     /** Sampling temperature [0, 2]. */
@@ -9207,4 +9417,17 @@ interface CallEvent {
     readonly direction?: string;
 }
 
-export { type AgentOptions, type AgentState, AllProvidersFailedError, type AnthropicConversion, LLM$6 as AnthropicLLM, type AnthropicLLMOptions, type AnthropicMessage, AssemblyAIEncoding, AssemblyAIModel, STT$1 as AssemblyAISTT, type AssemblyAISTTOptions, type AudioConfig, type AudioSource, AuthenticationError, type BackgroundAudioOptions, BackgroundAudioPlayer, type EvaluateContext as BargeInEvaluateContext, type BargeInStrategy, BuiltinAudioClip, type BuiltinAudioClipName, type BuiltinPcmSource, type CallControl, type CallEvent, type CallEventHandler, type CallMetrics, CallMetricsAccumulator, type CallOutcome, type CallRecord, type CallResult, type CarrierKind, type CartesiaEncoding, STT$3 as CartesiaSTT, type CartesiaSTTOptions, TTS$3 as CartesiaTTS, CartesiaTTSModel, type CartesiaTTSOptions, CartesiaTTSVoiceMode, LLM$4 as CerebrasLLM, type CerebrasLLMOptions, ChatContext, type ChatMessage, type ChatRole, CloudflareTunnel, type ConsultConfig, type ConversationStateSnapshot, type CostBreakdown, DEFAULT_MIN_SENTENCE_LEN, DEFAULT_PRICING, DTMF_EVENTS, DeepFilterNetFilter, type DeepFilterNetOptions, DeepgramModel, STT$6 as DeepgramSTT, type DeepgramSTTOptions, DefaultToolExecutor, type DefaultToolExecutorOptions, type DefineToolInput, type DtmfEvent, ConvAI as ElevenLabsConvAI, ElevenLabsConvAIAdapter, type ConvAIOptions as ElevenLabsConvAIOptions, ElevenLabsModel, ElevenLabsOutputFormat, ElevenLabsTTS as ElevenLabsRestTTS, TTS$6 as ElevenLabsTTS, type ElevenLabsTTSOptions, type ElevenLabsWebSocketOptions, TTS$5 as ElevenLabsWebSocketTTS, type EouTrigger, ErrorCode, EventBus, FallbackLLMProvider, type FallbackLLMProviderOptions, type FilePcmSource, GEMINI_DEFAULT_INPUT_SR, GEMINI_DEFAULT_OUTPUT_SR, GeminiLiveAdapter, type GeminiLiveEventHandler, LLM$3 as GoogleLLM, type GoogleLLMOptions, LLM$5 as GroqLLM, type GroqLLMOptions, Guardrail$1 as Guardrail, type GuardrailOptions, LLM$1 as HermesLLM, type HermesLLMOptions, type HookContext, IVRActivity, type IVRActivityOptions, type IVRToolDefinition, type IncomingMessage, type InitTracingOptions, TTS as InworldTTS, type InworldTTSOptions, type JobCallback, KrispFrameDuration, KrispSampleRate, KrispVivaFilter, type KrispVivaFilterOptions, type LLMChunk, LLMLoop, type LLMProvider, LMNTAudioFormat, LMNTModel, LMNTSampleRate, TTS$1 as LMNTTTS, type LMNTTTSOptions, type LatencyBreakdown, type LocalCallOptions, type LocalConfig, type LocalOptions, type Logger, type LoopCallback, type MessageHandler, MetricsStore, MinWordsStrategy, type MinWordsStrategyOptions, type ModelPricing, Ngrok, type OpenAICompatibleConsult, LLM$2 as OpenAICompatibleLLM, type OpenAICompatibleLLMOptions, OpenAICompatibleLLMProvider, LLM$7 as OpenAILLM, type OpenAILLMOptions, OpenAILLMProvider, type OpenAIMessage, Realtime as OpenAIRealtime, Realtime2 as OpenAIRealtime2, OpenAIRealtime2Adapter, type Realtime2Options as OpenAIRealtime2Options, OpenAIRealtimeAdapter, OpenAIRealtimeAudioFormat, OpenAIRealtimeModel, type RealtimeOptions as OpenAIRealtimeOptions, OpenAIRealtimeVADType, TTS$4 as OpenAITTS, type OpenAITTSOptions, STT$4 as OpenAITranscribeSTT, type OpenAITranscribeSTTOptions, OpenAITranscriptionModel, OpenAIVoice, LLM as OpenClawLLM, type OpenClawLLMOptions, PRICING_LAST_UPDATED, PRICING_VERSION, type ParamSpec, PartialStreamError, Patter, PatterConfigError, PatterConnectionError, PatterError, type PatterEventType, PatterTool, type PatterToolExecuteArgs, type PatterToolOptions, type PatterToolResult, PcmCarry, PipelineHookExecutor, type PipelineHooks, type PipelineMessageHandler, Carrier as Plivo, PlivoAdapter, type PlivoCarrierOptions, type InitiateCallOptions as PlivoInitiateCallOptions, type InitiateCallResult as PlivoInitiateCallResult, PricingUnit, type PricingUnitValue, type ProviderPricing, ProvisionError, RateLimitError, type RawPcmSource, type RealtimeConfig, type RealtimeTurnDetection, RemoteMessageHandler, RimeAudioFormat, RimeModel, TTS$2 as RimeTTS, type RimeTTSOptions, SPAN_BARGEIN, SPAN_CALL, SPAN_ENDPOINT, SPAN_LLM, SPAN_STT, SPAN_TOOL, SPAN_TTS, type SSEEvent, type STTConfig, type ScheduleHandle, SentenceChunker, type ServeOptions, type SilenceCallback, type SileroSampleRate, SileroVAD, type SileroVADOptions, STT$2 as SonioxSTT, type SonioxSTTOptions$1 as SonioxSTTOptions, type Span, type SpeechEventCallback, SpeechEvents, SpeechmaticsAudioEncoding, SpeechmaticsOperatingPoint, STT as SpeechmaticsSTT, type SpeechmaticsSTTOptions, SpeechmaticsSampleRate, SpeechmaticsServerMessage, TurnDetectionMode as SpeechmaticsTurnDetectionMode, StatefulResampler, type StatefulResamplerOptions, Static as StaticTunnel, type TTSConfig, Carrier$1 as Telnyx, TelnyxAdapter, type TelnyxCarrierOptions, type ConfigureNumberOptions as TelnyxConfigureNumberOptions, type EndCallOptions as TelnyxEndCallOptions, type InitiateCallOptions$1 as TelnyxInitiateCallOptions, type InitiateCallResult$1 as TelnyxInitiateCallResult, type ProvisionNumberOptions as TelnyxProvisionNumberOptions, type ProvisionNumberResult as TelnyxProvisionNumberResult, TelnyxSTT, TelnyxSTTInputFormat, TelnyxSTTSampleRate, type Transcript as TelnyxSTTTranscript, TelnyxTTS, TelnyxTTSSampleRate, TelnyxTTSVoice, type TelnyxTranscriptionEngine, TestSession, TfidfLoopDetector, type TfidfLoopDetectorOptions, Tool, type ToolDefinition, type ToolExecutor, type ToolHandler, type ToolOptions, type TunnelHandle, type TurnMetrics, Carrier$2 as Twilio, TwilioAdapter, type TwilioAdapterOptions, type TwilioCarrierOptions, type ConfigureNumberOptions$1 as TwilioConfigureNumberOptions, type InitiateCallOptions$2 as TwilioInitiateCallOptions, type InitiateCallResult$2 as TwilioInitiateCallResult, type ProvisionNumberOptions$1 as TwilioProvisionNumberOptions, type ProvisionNumberResult$1 as TwilioProvisionNumberResult, ULTRAVOX_DEFAULT_API_BASE, ULTRAVOX_DEFAULT_SR, type UltravoxEventHandler, UltravoxRealtimeAdapter, type UserState, STT$5 as WhisperSTT, type WhisperSTTOptions, assemblyai, builtinClipPath, calculateRealtimeCost, calculateSttCost, calculateTelephonyCost, calculateTtsCost, callsToCsv, callsToJson, cartesia, createResampler16kTo8k, createResampler24kTo16k, createResampler24kTo8k, createResampler8kTo16k, deepgram, defineTool, elevenlabs, evaluateStrategies as evaluateBargeInStrategies, filterEmoji, filterForTTS, filterMarkdown, formatDtmf, geminiLive, getLogger, guardrail, initTracing, isRemoteUrl, isTracingEnabled, isWebSocketUrl, lmnt, makeAuthMiddleware, mergePricing, mixPcm, mountApi, mountDashboard, mulawToPcm16, notifyDashboard, openaiTts, openclawConsult, openclawPostCallNotifier, pcm16ToMulaw, resample16kTo8k, resample24kTo16k, resample8kTo16k, resamplePcm, resetStrategies as resetBargeInStrategies, rime, scheduleCron, scheduleInterval, scheduleOnce, selectSoundFromList, setLogger, soniox, speechmatics, startSpan, startTunnel, tool, ultravox, whisper };
+declare const hermes: Readonly<{
+    LLM: typeof LLM$1;
+}>;
+declare const openclaw: Readonly<{
+    LLM: typeof LLM;
+}>;
+declare const openaiCompatible: Readonly<{
+    LLM: typeof LLM$3;
+}>;
+declare const custom: Readonly<{
+    LLM: typeof LLM$2;
+}>;
+
+export { type AgentOptions, type AgentState, AllProvidersFailedError, type AnthropicConversion, LLM$7 as AnthropicLLM, type AnthropicLLMOptions, type AnthropicMessage, AssemblyAIEncoding, AssemblyAIModel, STT$1 as AssemblyAISTT, type AssemblyAISTTOptions, type AudioConfig, type AudioSource, AuthenticationError, type BackgroundAudioOptions, BackgroundAudioPlayer, type EvaluateContext as BargeInEvaluateContext, type BargeInStrategy, BuiltinAudioClip, type BuiltinAudioClipName, type BuiltinPcmSource, type CallControl, type CallEvent, type CallEventHandler, type CallMetrics, CallMetricsAccumulator, type CallOutcome, type CallRecord, type CallResult, type CarrierKind, type CartesiaEncoding, STT$3 as CartesiaSTT, type CartesiaSTTOptions, TTS$3 as CartesiaTTS, CartesiaTTSModel, type CartesiaTTSOptions, CartesiaTTSVoiceMode, LLM$5 as CerebrasLLM, type CerebrasLLMOptions, ChatContext, type ChatMessage, type ChatRole, CloudflareTunnel, type ConsultConfig, type ConversationStateSnapshot, type CostBreakdown, LLM$2 as CustomLLM, type CustomLLMOptions, DEFAULT_MIN_SENTENCE_LEN, DEFAULT_PRICING, DTMF_EVENTS, DeepFilterNetFilter, type DeepFilterNetOptions, DeepgramModel, STT$6 as DeepgramSTT, type DeepgramSTTOptions, DefaultToolExecutor, type DefaultToolExecutorOptions, type DefineToolInput, type DtmfEvent, ConvAI as ElevenLabsConvAI, ElevenLabsConvAIAdapter, type ConvAIOptions as ElevenLabsConvAIOptions, ElevenLabsModel, ElevenLabsOutputFormat, ElevenLabsTTS as ElevenLabsRestTTS, TTS$6 as ElevenLabsTTS, type ElevenLabsTTSOptions, type ElevenLabsWebSocketOptions, TTS$5 as ElevenLabsWebSocketTTS, type EouTrigger, ErrorCode, EventBus, FallbackLLMProvider, type FallbackLLMProviderOptions, type FilePcmSource, GEMINI_DEFAULT_INPUT_SR, GEMINI_DEFAULT_OUTPUT_SR, GeminiLiveAdapter, type GeminiLiveEventHandler, LLM$4 as GoogleLLM, type GoogleLLMOptions, LLM$6 as GroqLLM, type GroqLLMOptions, Guardrail$1 as Guardrail, type GuardrailOptions, LLM$1 as HermesLLM, type HermesLLMOptions, type HookContext, IVRActivity, type IVRActivityOptions, type IVRToolDefinition, type IncomingMessage, type InitTracingOptions, TTS as InworldTTS, type InworldTTSOptions, type JobCallback, KrispFrameDuration, KrispSampleRate, KrispVivaFilter, type KrispVivaFilterOptions, type LLMChunk, LLMLoop, type LLMProvider, LMNTAudioFormat, LMNTModel, LMNTSampleRate, TTS$1 as LMNTTTS, type LMNTTTSOptions, type LatencyBreakdown, type LocalCallOptions, type LocalConfig, type LocalOptions, type Logger, type LoopCallback, type MessageHandler, MetricsStore, MinWordsStrategy, type MinWordsStrategyOptions, type ModelPricing, Ngrok, type OpenAICompatibleConsult, LLM$3 as OpenAICompatibleLLM, type OpenAICompatibleLLMOptions, OpenAICompatibleLLMProvider, LLM$8 as OpenAILLM, type OpenAILLMOptions, OpenAILLMProvider, type OpenAIMessage, Realtime as OpenAIRealtime, Realtime2 as OpenAIRealtime2, OpenAIRealtime2Adapter, type Realtime2Options as OpenAIRealtime2Options, OpenAIRealtimeAdapter, OpenAIRealtimeAudioFormat, OpenAIRealtimeModel, type RealtimeOptions as OpenAIRealtimeOptions, OpenAIRealtimeVADType, TTS$4 as OpenAITTS, type OpenAITTSOptions, STT$4 as OpenAITranscribeSTT, type OpenAITranscribeSTTOptions, OpenAITranscriptionModel, OpenAIVoice, LLM as OpenClawLLM, type OpenClawLLMOptions, PRICING_LAST_UPDATED, PRICING_VERSION, type ParamSpec, PartialStreamError, Patter, PatterConfigError, PatterConnectionError, PatterError, type PatterEventType, PatterTool, type PatterToolExecuteArgs, type PatterToolOptions, type PatterToolResult, PcmCarry, PipelineHookExecutor, type PipelineHooks, type PipelineMessageHandler, Carrier as Plivo, PlivoAdapter, type PlivoCarrierOptions, type InitiateCallOptions as PlivoInitiateCallOptions, type InitiateCallResult as PlivoInitiateCallResult, PricingUnit, type PricingUnitValue, type ProviderPricing, ProvisionError, RateLimitError, type RawPcmSource, type RealtimeConfig, type RealtimeTurnDetection, RemoteMessageHandler, RimeAudioFormat, RimeModel, TTS$2 as RimeTTS, type RimeTTSOptions, SPAN_BARGEIN, SPAN_CALL, SPAN_ENDPOINT, SPAN_LLM, SPAN_STT, SPAN_TOOL, SPAN_TTS, type SSEEvent, type STTConfig, type ScheduleHandle, SentenceChunker, type ServeOptions, type SessionContext, type SilenceCallback, type SileroSampleRate, SileroVAD, type SileroVADOptions, STT$2 as SonioxSTT, type SonioxSTTOptions$1 as SonioxSTTOptions, type Span, type SpeechEventCallback, SpeechEvents, SpeechmaticsAudioEncoding, SpeechmaticsOperatingPoint, STT as SpeechmaticsSTT, type SpeechmaticsSTTOptions, SpeechmaticsSampleRate, SpeechmaticsServerMessage, TurnDetectionMode as SpeechmaticsTurnDetectionMode, StatefulResampler, type StatefulResamplerOptions, Static as StaticTunnel, type TTSConfig, Carrier$1 as Telnyx, TelnyxAdapter, type TelnyxCarrierOptions, type ConfigureNumberOptions as TelnyxConfigureNumberOptions, type EndCallOptions as TelnyxEndCallOptions, type InitiateCallOptions$1 as TelnyxInitiateCallOptions, type InitiateCallResult$1 as TelnyxInitiateCallResult, type ProvisionNumberOptions as TelnyxProvisionNumberOptions, type ProvisionNumberResult as TelnyxProvisionNumberResult, TelnyxSTT, TelnyxSTTInputFormat, TelnyxSTTSampleRate, type Transcript as TelnyxSTTTranscript, TelnyxTTS, TelnyxTTSSampleRate, TelnyxTTSVoice, type TelnyxTranscriptionEngine, TestSession, TfidfLoopDetector, type TfidfLoopDetectorOptions, Tool, type ToolDefinition, type ToolExecutor, type ToolHandler, type ToolOptions, type TunnelHandle, type TurnMetrics, Carrier$2 as Twilio, TwilioAdapter, type TwilioAdapterOptions, type TwilioCarrierOptions, type ConfigureNumberOptions$1 as TwilioConfigureNumberOptions, type InitiateCallOptions$2 as TwilioInitiateCallOptions, type InitiateCallResult$2 as TwilioInitiateCallResult, type ProvisionNumberOptions$1 as TwilioProvisionNumberOptions, type ProvisionNumberResult$1 as TwilioProvisionNumberResult, ULTRAVOX_DEFAULT_API_BASE, ULTRAVOX_DEFAULT_SR, type UltravoxEventHandler, UltravoxRealtimeAdapter, type UserState, STT$5 as WhisperSTT, type WhisperSTTOptions, assemblyai, builtinClipPath, calculateRealtimeCost, calculateSttCost, calculateTelephonyCost, calculateTtsCost, callsToCsv, callsToJson, cartesia, createResampler16kTo8k, createResampler24kTo16k, createResampler24kTo8k, createResampler8kTo16k, custom, deepgram, defineTool, elevenlabs, evaluateStrategies as evaluateBargeInStrategies, filterEmoji, filterForTTS, filterMarkdown, formatDtmf, geminiLive, getLogger, guardrail, hashCaller, hermes, initTracing, isRemoteUrl, isTracingEnabled, isWebSocketUrl, lmnt, makeAuthMiddleware, mergePricing, mixPcm, mountApi, mountDashboard, mulawToPcm16, notifyDashboard, openaiCompatible, openaiTts, openclaw, openclawConsult, openclawPostCallNotifier, pcm16ToMulaw, resample16kTo8k, resample24kTo16k, resample8kTo16k, resamplePcm, resetStrategies as resetBargeInStrategies, rime, scheduleCron, scheduleInterval, scheduleOnce, selectSoundFromList, setLogger, soniox, speechmatics, startSpan, startTunnel, tool, ultravox, whisper };