@sinch/functions-runtime 0.1.0-beta.28 → 0.2.1-beta

package/dist/index.d.ts

@@ -136,8 +136,18 @@ export interface RunMenuAction extends BaseAction {
 	enableDice?: boolean;
 	custom?: string;
 }
+/** Connect to AI agent via SIP action */
+export interface ConnectAgentAction extends BaseAction {
+	name: "connectSip";
+	destination: {
+		endpoint: string;
+	};
+	cli?: string;
+	maxDuration?: number;
+	suppressCallbacks?: boolean;
+}
 /** Union type for all SVAML actions */
-export type SvamletAction = HangupAction | ContinueAction | ConnectPstnAction | ConnectSipAction | ConnectMxpAction | ConnectConfAction | ParkAction | RunMenuAction;
+export type SvamletAction = HangupAction | ContinueAction | ConnectPstnAction | ConnectSipAction | ConnectMxpAction | ConnectConfAction | ParkAction | RunMenuAction | ConnectAgentAction;
 /** Menu option definition */
 export interface MenuOption {
 	dtmf: string;
@@ -367,6 +377,26 @@ export declare const MenuTemplates: {
 	 */
 	readonly numericInput: (prompt: string, digits?: number) => MenuStructure;
 };
+declare enum AgentProvider {
+	ElevenLabs = "elevenlabs"
+}
+/**
+ * Options for connecting to an AI agent
+ */
+export interface ConnectAgentOptions {
+	/** Optional caller ID to display */
+	cli?: string;
+	/** Maximum call duration in seconds */
+	maxDuration?: number;
+	/** Suppress subsequent callbacks */
+	suppressCallbacks?: boolean;
+	/** Custom headers to send to the agent */
+	customHeaders?: Record<string, string>;
+	/** Call ID for tracking */
+	callId?: string;
+	/** Caller ID for personalization */
+	callerId?: string;
+}
 export interface RecordingOptions {
 	/** URL to send the recording to */
 	destinationUrl?: string;
@@ -564,6 +594,22 @@ export declare class IceSvamlBuilder extends BaseSvamlBuilder<IceSvamlBuilder> {
 	 * @param options - Park options
 	 */
 	park(holdPrompt?: string, options?: ParkOptions): this;
+	/**
+	 * Connect to an AI voice agent
+	 *
+	 * @param provider - The AI agent provider (e.g., AgentProvider.ElevenLabs)
+	 * @param agentId - The agent ID to connect to
+	 * @param options - Connection options
+	 *
+	 * @example
+	 * ```typescript
+	 * return new IceSvamlBuilder()
+	 *   .say('Connecting you to our AI assistant.')
+	 *   .connectAgent(AgentProvider.ElevenLabs, 'agent_123')
+	 *   .build();
+	 * ```
+	 */
+	connectAgent(provider: AgentProvider, agentId: string, options?: ConnectAgentOptions): this;
 }
 /**
  * ACE (Answered Call Event) SVAML Builder
@@ -631,6 +677,25 @@ export declare class PieSvamlBuilder extends BaseSvamlBuilder<PieSvamlBuilder> {
 	 * @param options - Park options
 	 */
 	park(holdPrompt?: string, options?: ParkOptions): this;
+	/**
+	 * Connect to an AI voice agent
+	 *
+	 * @param provider - The AI agent provider (e.g., AgentProvider.ElevenLabs)
+	 * @param agentId - The agent ID to connect to
+	 * @param options - Connection options
+	 *
+	 * @example
+	 * ```typescript
+	 * // Transfer to AI agent based on menu selection
+	 * if (event.menuResult?.value === 'ai') {
+	 *   return new PieSvamlBuilder()
+	 *     .say('Connecting you to our AI assistant.')
+	 *     .connectAgent(AgentProvider.ElevenLabs, 'agent_123')
+	 *     .build();
+	 * }
+	 * ```
+	 */
+	connectAgent(provider: AgentProvider, agentId: string, options?: ConnectAgentOptions): this;
 }
 /**
  * Create a new ICE SVAML builder
@@ -1283,28 +1348,49 @@ export declare function createCacheClient(_projectId?: string, _functionName?: s
 /**
  * Tunnel Client for Sinch Functions
  *
- * Connects to the Sinch Functions API via WebSocket to receive
- * incoming voice callbacks during local development.
+ * Connects to the Sinch tunnel gateway via WebSocket to receive
+ * incoming voice and conversation callbacks during local development.
+ *
+ * Features:
+ * - Voice webhook auto-configuration
+ * - Conversation webhook auto-configuration with cleanup
+ * - ElevenLabs auto-configuration (when enabled)
+ * - Stale webhook cleanup on connect
+ * - Webhook cleanup on disconnect
  */
 export declare class TunnelClient {
 	private ws;
 	private tunnelUrl;
+	private tunnelId;
 	private isConnected;
 	private reconnectAttempts;
 	private maxReconnectAttempts;
 	private reconnectDelay;
 	private heartbeatInterval;
 	private localPort;
+	private webhookConfig;
+	private welcomeResolver;
 	constructor(localPort?: number);
+	private getTunnelGatewayUrl;
+	private generateTunnelId;
 	connect(): Promise<void>;
 	private handleMessage;
+	private handleWelcomeMessage;
 	private handleRequest;
 	private sendPong;
 	private startHeartbeat;
 	private stopHeartbeat;
-	private displayTestPhoneNumbers;
+	/**
+	 * Configure all webhooks (Voice, Conversation, ElevenLabs)
+	 */
+	private configureWebhooks;
+	/**
+	 * Cleanup webhooks on disconnect
+	 */
+	private cleanupWebhooks;
+	private configureVoiceWebhooks;
 	private scheduleReconnect;
-	disconnect(): void;
+	disconnect(): Promise<void>;
 	getTunnelUrl(): string | null;
 	getIsConnected(): boolean;
 }