@teamlearners/clawops 0.16.5 → 0.16.6

package/dist/agent/index.d.cts

@@ -517,6 +517,64 @@ declare class ClawOpsAgent {
     private _startCallSession;
 }
 
+/**
+ * Control WebSocket for agent signaling (call.incoming, call.ended, etc.).
+ */
+
+interface ControlWsOptions {
+    baseUrl: string;
+    apiKey: string;
+    accountId: string;
+    /** Phone number to register on. */
+    number?: string;
+}
+/**
+ * Control event is a flat JSON object with an 'event' field.
+ * Example: { "event": "call.incoming", "callId": "xxx", "from": "070...", "mediaUrl": "wss://..." }
+ */
+interface ControlEvent {
+    event: string;
+    [key: string]: unknown;
+}
+type ControlEventHandler = (event: ControlEvent) => void | Promise<void>;
+/**
+ * Build the full control WebSocket URL from options.
+ * Matches Python SDK: /v1/accounts/{account_id}/agent/listen?number={number}
+ */
+declare function buildControlWsUrl(options: ControlWsOptions): string;
+declare class ControlWebSocket {
+    private readonly _options;
+    private _url;
+    private _ws;
+    private _handlers;
+    private _transferResolvers;
+    private _reconnectDelay;
+    private _closed;
+    private _connectedResolve;
+    private _connectedPromise;
+    private _log;
+    private _pingTimer;
+    setLogger(logger: Logger): void;
+    constructor(_options: ControlWsOptions);
+    /** Register an event handler for a specific event type. */
+    on(event: string, handler: ControlEventHandler): void;
+    /** Connect to the control WebSocket. */
+    connect(): Promise<void>;
+    /** Wait until the WebSocket is connected. */
+    waitConnected(): Promise<void>;
+    /** Request a call transfer and wait for the result. */
+    requestTransfer(callId: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Send a JSON message over the control WebSocket. */
+    send(message: Record<string, unknown>): void;
+    /** Close the WebSocket and stop reconnecting. */
+    close(): void;
+    private _doConnect;
+    private _dispatchEvent;
+    private _resetPingTimer;
+    private _clearPingTimer;
+    private _scheduleReconnect;
+}
+
 /**
  * Media WebSocket for streaming audio to/from the telephony platform.
  *
@@ -1202,4 +1260,4 @@ declare function createAgentLogger(userLogger?: Logger): Logger;
  */
 declare function createPipelineLogger(parent: Logger): Logger;
 
-export { type AgentEventType, AnthropicLLM, type AnthropicLLMOptions, AudioRecorder, BUILTIN_TOOL_NAMES, BuiltinTool, type CallDirection, CallSession, type CallStatus, ClawOpsAgent, type ClawOpsAgentOptions, type ConversationMessage, DECODE_TABLE, DeepSeekLLM, type DeepSeekLLMOptions, DeepgramSTT, type DeepgramSTTOptions, type DtmfEvent, ElevenLabsTTS, type ElevenLabsTTSOptions, FireworksLLM, type FireworksLLMOptions, type FunctionTool, GeminiLLM, type GeminiLLMOptions, GeminiRealtime, type GeminiRealtimeOptions, GroqLLM, type GroqLLMOptions, type LLM, type LLMChunk, MCPClient, type MCPServerConfig, type MCPServerHTTP, type MCPServerStdio, type MediaEvent, type MediaStartEvent, MediaWebSocket, MistralLLM, type MistralLLMOptions, OllamaLLM, type OllamaLLMOptions, OpenAICompatLLM, type OpenAICompatLLMOptions, OpenAILLM, type OpenAILLMOptions, OpenAIRealtime, type OpenAIRealtimeOptions, type OpenAIToolDefinition, PerplexityLLM, type PerplexityLLMOptions, PipelineSession, type PipelineSessionOptions, type STT, type Session, type SpeechEvent, type TTS, TogetherLLM, type TogetherLLMOptions, type ToolCallRequest, type ToolConfig, ToolRegistry, type TracingConfig, XaiLLM, type XaiLLMOptions, createAgentLogger, createPipelineLogger, executeBuiltinTool, functionTool, getBuiltinToolSchemas, getTracingConfig, isBuiltinTool, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };
+export { type AgentEventType, AnthropicLLM, type AnthropicLLMOptions, AudioRecorder, BUILTIN_TOOL_NAMES, BuiltinTool, type CallDirection, CallSession, type CallStatus, ClawOpsAgent, type ClawOpsAgentOptions, type ControlEvent, ControlWebSocket, type ControlWsOptions, type ConversationMessage, DECODE_TABLE, DeepSeekLLM, type DeepSeekLLMOptions, DeepgramSTT, type DeepgramSTTOptions, type DtmfEvent, ElevenLabsTTS, type ElevenLabsTTSOptions, FireworksLLM, type FireworksLLMOptions, type FunctionTool, GeminiLLM, type GeminiLLMOptions, GeminiRealtime, type GeminiRealtimeOptions, GroqLLM, type GroqLLMOptions, type LLM, type LLMChunk, MCPClient, type MCPServerConfig, type MCPServerHTTP, type MCPServerStdio, type MediaEvent, type MediaStartEvent, MediaWebSocket, MistralLLM, type MistralLLMOptions, OllamaLLM, type OllamaLLMOptions, OpenAICompatLLM, type OpenAICompatLLMOptions, OpenAILLM, type OpenAILLMOptions, OpenAIRealtime, type OpenAIRealtimeOptions, type OpenAIToolDefinition, PerplexityLLM, type PerplexityLLMOptions, PipelineSession, type PipelineSessionOptions, type STT, type Session, type SpeechEvent, type TTS, TogetherLLM, type TogetherLLMOptions, type ToolCallRequest, type ToolConfig, ToolRegistry, type TracingConfig, XaiLLM, type XaiLLMOptions, buildControlWsUrl, createAgentLogger, createPipelineLogger, executeBuiltinTool, functionTool, getBuiltinToolSchemas, getTracingConfig, isBuiltinTool, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };

package/dist/agent/index.d.ts

@@ -517,6 +517,64 @@ declare class ClawOpsAgent {
     private _startCallSession;
 }
 
+/**
+ * Control WebSocket for agent signaling (call.incoming, call.ended, etc.).
+ */
+
+interface ControlWsOptions {
+    baseUrl: string;
+    apiKey: string;
+    accountId: string;
+    /** Phone number to register on. */
+    number?: string;
+}
+/**
+ * Control event is a flat JSON object with an 'event' field.
+ * Example: { "event": "call.incoming", "callId": "xxx", "from": "070...", "mediaUrl": "wss://..." }
+ */
+interface ControlEvent {
+    event: string;
+    [key: string]: unknown;
+}
+type ControlEventHandler = (event: ControlEvent) => void | Promise<void>;
+/**
+ * Build the full control WebSocket URL from options.
+ * Matches Python SDK: /v1/accounts/{account_id}/agent/listen?number={number}
+ */
+declare function buildControlWsUrl(options: ControlWsOptions): string;
+declare class ControlWebSocket {
+    private readonly _options;
+    private _url;
+    private _ws;
+    private _handlers;
+    private _transferResolvers;
+    private _reconnectDelay;
+    private _closed;
+    private _connectedResolve;
+    private _connectedPromise;
+    private _log;
+    private _pingTimer;
+    setLogger(logger: Logger): void;
+    constructor(_options: ControlWsOptions);
+    /** Register an event handler for a specific event type. */
+    on(event: string, handler: ControlEventHandler): void;
+    /** Connect to the control WebSocket. */
+    connect(): Promise<void>;
+    /** Wait until the WebSocket is connected. */
+    waitConnected(): Promise<void>;
+    /** Request a call transfer and wait for the result. */
+    requestTransfer(callId: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Send a JSON message over the control WebSocket. */
+    send(message: Record<string, unknown>): void;
+    /** Close the WebSocket and stop reconnecting. */
+    close(): void;
+    private _doConnect;
+    private _dispatchEvent;
+    private _resetPingTimer;
+    private _clearPingTimer;
+    private _scheduleReconnect;
+}
+
 /**
  * Media WebSocket for streaming audio to/from the telephony platform.
  *
@@ -1202,4 +1260,4 @@ declare function createAgentLogger(userLogger?: Logger): Logger;
  */
 declare function createPipelineLogger(parent: Logger): Logger;
 
-export { type AgentEventType, AnthropicLLM, type AnthropicLLMOptions, AudioRecorder, BUILTIN_TOOL_NAMES, BuiltinTool, type CallDirection, CallSession, type CallStatus, ClawOpsAgent, type ClawOpsAgentOptions, type ConversationMessage, DECODE_TABLE, DeepSeekLLM, type DeepSeekLLMOptions, DeepgramSTT, type DeepgramSTTOptions, type DtmfEvent, ElevenLabsTTS, type ElevenLabsTTSOptions, FireworksLLM, type FireworksLLMOptions, type FunctionTool, GeminiLLM, type GeminiLLMOptions, GeminiRealtime, type GeminiRealtimeOptions, GroqLLM, type GroqLLMOptions, type LLM, type LLMChunk, MCPClient, type MCPServerConfig, type MCPServerHTTP, type MCPServerStdio, type MediaEvent, type MediaStartEvent, MediaWebSocket, MistralLLM, type MistralLLMOptions, OllamaLLM, type OllamaLLMOptions, OpenAICompatLLM, type OpenAICompatLLMOptions, OpenAILLM, type OpenAILLMOptions, OpenAIRealtime, type OpenAIRealtimeOptions, type OpenAIToolDefinition, PerplexityLLM, type PerplexityLLMOptions, PipelineSession, type PipelineSessionOptions, type STT, type Session, type SpeechEvent, type TTS, TogetherLLM, type TogetherLLMOptions, type ToolCallRequest, type ToolConfig, ToolRegistry, type TracingConfig, XaiLLM, type XaiLLMOptions, createAgentLogger, createPipelineLogger, executeBuiltinTool, functionTool, getBuiltinToolSchemas, getTracingConfig, isBuiltinTool, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };
+export { type AgentEventType, AnthropicLLM, type AnthropicLLMOptions, AudioRecorder, BUILTIN_TOOL_NAMES, BuiltinTool, type CallDirection, CallSession, type CallStatus, ClawOpsAgent, type ClawOpsAgentOptions, type ControlEvent, ControlWebSocket, type ControlWsOptions, type ConversationMessage, DECODE_TABLE, DeepSeekLLM, type DeepSeekLLMOptions, DeepgramSTT, type DeepgramSTTOptions, type DtmfEvent, ElevenLabsTTS, type ElevenLabsTTSOptions, FireworksLLM, type FireworksLLMOptions, type FunctionTool, GeminiLLM, type GeminiLLMOptions, GeminiRealtime, type GeminiRealtimeOptions, GroqLLM, type GroqLLMOptions, type LLM, type LLMChunk, MCPClient, type MCPServerConfig, type MCPServerHTTP, type MCPServerStdio, type MediaEvent, type MediaStartEvent, MediaWebSocket, MistralLLM, type MistralLLMOptions, OllamaLLM, type OllamaLLMOptions, OpenAICompatLLM, type OpenAICompatLLMOptions, OpenAILLM, type OpenAILLMOptions, OpenAIRealtime, type OpenAIRealtimeOptions, type OpenAIToolDefinition, PerplexityLLM, type PerplexityLLMOptions, PipelineSession, type PipelineSessionOptions, type STT, type Session, type SpeechEvent, type TTS, TogetherLLM, type TogetherLLMOptions, type ToolCallRequest, type ToolConfig, ToolRegistry, type TracingConfig, XaiLLM, type XaiLLMOptions, buildControlWsUrl, createAgentLogger, createPipelineLogger, executeBuiltinTool, functionTool, getBuiltinToolSchemas, getTracingConfig, isBuiltinTool, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };

package/dist/agent/index.js

@@ -1,4 +1,4 @@
-import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-BHGDB52N.js';
+import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-RYJF2N7K.js';
 import pino from 'pino';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -4254,6 +4254,6 @@ function mcpServerHTTP(options) {
   };
 }
 
-export { AnthropicLLM, AudioRecorder, BUILTIN_TOOL_NAMES, BuiltinTool, CallSession, ClawOpsAgent, DECODE_TABLE, DeepSeekLLM, DeepgramSTT, ElevenLabsTTS, FireworksLLM, GeminiLLM, GeminiRealtime, GroqLLM, MCPClient, MediaWebSocket, MistralLLM, OllamaLLM, OpenAICompatLLM, OpenAILLM, OpenAIRealtime, PerplexityLLM, PipelineSession, TogetherLLM, ToolRegistry, XaiLLM, createAgentLogger, createPipelineLogger, executeBuiltinTool, functionTool, getBuiltinToolSchemas, getTracingConfig, isBuiltinTool, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };
+export { AnthropicLLM, AudioRecorder, BUILTIN_TOOL_NAMES, BuiltinTool, CallSession, ClawOpsAgent, ControlWebSocket, DECODE_TABLE, DeepSeekLLM, DeepgramSTT, ElevenLabsTTS, FireworksLLM, GeminiLLM, GeminiRealtime, GroqLLM, MCPClient, MediaWebSocket, MistralLLM, OllamaLLM, OpenAICompatLLM, OpenAILLM, OpenAIRealtime, PerplexityLLM, PipelineSession, TogetherLLM, ToolRegistry, XaiLLM, buildControlWsUrl, createAgentLogger, createPipelineLogger, executeBuiltinTool, functionTool, getBuiltinToolSchemas, getTracingConfig, isBuiltinTool, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map