@teamlearners/clawops 0.8.0 → 0.11.0

package/dist/agent/index.d.cts

@@ -182,6 +182,9 @@ interface HangupFn {
 interface SendDtmfFn {
     (digit: string): Promise<void>;
 }
+interface TransferFn {
+    (params: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
 declare class CallSession {
     readonly callId: string;
     readonly fromNumber: string;
@@ -195,6 +198,7 @@ declare class CallSession {
     private _clearAudioFn;
     private _hangupFn;
     /** @internal */ _sendDtmfFn: SendDtmfFn | null;
+    /** @internal */ _transferFn: TransferFn | null;
     /** @internal */ _isTransportConnected: (() => boolean) | null;
     private _dtmfCollectorActive;
     private _dtmfResolvers;
@@ -242,6 +246,16 @@ declare class CallSession {
     }): Promise<string>;
     /** Send a sequence of DTMF digits. */
     sendDtmfSequence(digits: string): Promise<void>;
+    /** Transfer the call to another destination. */
+    transfer(to: string, options?: {
+        mode?: 'blind' | 'warm';
+        afterTransfer?: 'terminate' | 'return';
+        holdMedia?: string;
+        whisper?: string;
+        context?: Record<string, unknown>;
+        callerId?: string;
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
     /** Register an event handler. */
     on(event: string, handler: SessionEventHandler): void;
     /** Wait for the call to end. */
@@ -262,6 +276,8 @@ declare enum BuiltinTool {
     COLLECT_DTMF = "collect_dtmf",
     /** DTMF 전송 도구. ARS 탐색이나 내선번호 입력에 사용합니다. */
     SEND_DTMF = "send_dtmf",
+    /** 통화 전환 도구. 현재 통화를 다른 번호로 전환합니다. */
+    TRANSFER_CALL = "transfer_call",
     /** 모든 내장 도구를 활성화합니다. (기본값) */
     ALL = "all",
     /** 모든 내장 도구를 비활성화합니다. */
@@ -382,6 +398,11 @@ declare function resetTracingConfig(): void;
 
 type AgentEventType = 'call_start' | 'call_end' | 'call_failed' | 'transcript' | 'dtmf';
 type AgentEventHandler = (...args: any[]) => void | Promise<void>;
+/** Tool 실행 관련 설정. */
+interface ToolConfig {
+    /** Tool 실행 중 재생할 hold audio. true=기본 차임, string=wav 파일 경로, Buffer=raw ulaw. */
+    holdAudio?: boolean | string | Buffer;
+}
 interface ClawOpsAgentOptions {
     /** ClawOps API key. Falls back to CLAWOPS_API_KEY env var. */
     apiKey?: string;
@@ -407,6 +428,8 @@ interface ClawOpsAgentOptions {
     passiveDtmfDebounceMs?: number;
     /** Custom pino logger instance. If omitted, a default logger is created. */
     logger?: Logger;
+    /** Tool 실행 관련 설정. */
+    toolConfig?: ToolConfig;
 }
 declare class ClawOpsAgent {
     private _apiKey;
@@ -430,6 +453,7 @@ declare class ClawOpsAgent {
     private _log;
     private _pipelineLog;
     private _isPipelineSession;
+    private _holdAudioChunks;
     constructor(options: ClawOpsAgentOptions);
     /**
      * Register a function tool.
@@ -620,11 +644,14 @@ declare class PipelineSession implements Session {
     private _running;
     private _speaking;
     private _builtinTools;
+    private _holdAudioChunks;
     private _log;
     constructor(options: PipelineSessionOptions);
     setToolRegistry(registry: ToolRegistry): void;
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    /** Tool 실행 중 재생할 hold audio 청크를 설정한다. */
+    setHoldAudio(chunks: Buffer[]): void;
     getTelemetry(): SessionTelemetry;
     setLogger(logger: Logger): void;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
@@ -691,11 +718,14 @@ declare class OpenAIRealtime implements Session {
     private _pendingToolCalls;
     private _responseInProgress;
     private _onResponseDone;
+    private _holdAudioChunks;
     constructor(options?: OpenAIRealtimeOptions);
     /** Inject per-call ToolRegistry. */
     setToolRegistry(registry: ToolRegistry): void;
     /** Inject per-call AudioRecorder. */
     setRecorder(recorder: AudioRecorder): void;
+    /** Tool 실행 중 재생할 hold audio 청크를 설정한다. */
+    setHoldAudio(chunks: Buffer[]): void;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
     feedDtmf(digits: string): Promise<void>;
     feedAudio(audio: Buffer): void;
@@ -721,7 +751,7 @@ interface GeminiRealtimeOptions {
     apiKey?: string;
     /** System prompt / instructions for the AI. */
     systemPrompt?: string;
-    /** Model to use. Default: 'gemini-2.5-flash-native-audio-preview-12-2025' */
+    /** Model to use. Default: 'gemini-3.1-flash-live-preview' */
     model?: string;
     /** Voice name. Default: 'Kore' */
     voice?: string;
@@ -745,7 +775,10 @@ declare class GeminiRealtime implements Session {
     private _sentAudioChunks;
     private _audioRemainder;
     private _builtinTools;
-    private _toolCallInProgress;
+    private _pendingToolCall;
+    private _toolDrainTimer;
+    private _lastAudioTime;
+    private _holdAudioChunks;
     private _log;
     constructor(options?: GeminiRealtimeOptions);
     /** Inject per-call ToolRegistry. */
@@ -753,6 +786,8 @@ declare class GeminiRealtime implements Session {
     /** Inject per-call AudioRecorder. */
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    /** Tool 실행 중 재생할 hold audio 청크를 설정한다. */
+    setHoldAudio(chunks: Buffer[]): void;
     setLogger(logger: Logger): void;
     getTelemetry(): SessionTelemetry;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
@@ -763,6 +798,8 @@ declare class GeminiRealtime implements Session {
     private _handleMessage;
     private _handleAudioData;
     private _flushAudioRemainder;
+    private static readonly TOOL_DRAIN_TIMEOUT;
+    private _scheduleToolExecution;
     private _handleToolCall;
 }
 
@@ -1140,4 +1177,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, 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 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 };

package/dist/agent/index.d.ts

@@ -182,6 +182,9 @@ interface HangupFn {
 interface SendDtmfFn {
     (digit: string): Promise<void>;
 }
+interface TransferFn {
+    (params: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
 declare class CallSession {
     readonly callId: string;
     readonly fromNumber: string;
@@ -195,6 +198,7 @@ declare class CallSession {
     private _clearAudioFn;
     private _hangupFn;
     /** @internal */ _sendDtmfFn: SendDtmfFn | null;
+    /** @internal */ _transferFn: TransferFn | null;
     /** @internal */ _isTransportConnected: (() => boolean) | null;
     private _dtmfCollectorActive;
     private _dtmfResolvers;
@@ -242,6 +246,16 @@ declare class CallSession {
     }): Promise<string>;
     /** Send a sequence of DTMF digits. */
     sendDtmfSequence(digits: string): Promise<void>;
+    /** Transfer the call to another destination. */
+    transfer(to: string, options?: {
+        mode?: 'blind' | 'warm';
+        afterTransfer?: 'terminate' | 'return';
+        holdMedia?: string;
+        whisper?: string;
+        context?: Record<string, unknown>;
+        callerId?: string;
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
     /** Register an event handler. */
     on(event: string, handler: SessionEventHandler): void;
     /** Wait for the call to end. */
@@ -262,6 +276,8 @@ declare enum BuiltinTool {
     COLLECT_DTMF = "collect_dtmf",
     /** DTMF 전송 도구. ARS 탐색이나 내선번호 입력에 사용합니다. */
     SEND_DTMF = "send_dtmf",
+    /** 통화 전환 도구. 현재 통화를 다른 번호로 전환합니다. */
+    TRANSFER_CALL = "transfer_call",
     /** 모든 내장 도구를 활성화합니다. (기본값) */
     ALL = "all",
     /** 모든 내장 도구를 비활성화합니다. */
@@ -382,6 +398,11 @@ declare function resetTracingConfig(): void;
 
 type AgentEventType = 'call_start' | 'call_end' | 'call_failed' | 'transcript' | 'dtmf';
 type AgentEventHandler = (...args: any[]) => void | Promise<void>;
+/** Tool 실행 관련 설정. */
+interface ToolConfig {
+    /** Tool 실행 중 재생할 hold audio. true=기본 차임, string=wav 파일 경로, Buffer=raw ulaw. */
+    holdAudio?: boolean | string | Buffer;
+}
 interface ClawOpsAgentOptions {
     /** ClawOps API key. Falls back to CLAWOPS_API_KEY env var. */
     apiKey?: string;
@@ -407,6 +428,8 @@ interface ClawOpsAgentOptions {
     passiveDtmfDebounceMs?: number;
     /** Custom pino logger instance. If omitted, a default logger is created. */
     logger?: Logger;
+    /** Tool 실행 관련 설정. */
+    toolConfig?: ToolConfig;
 }
 declare class ClawOpsAgent {
     private _apiKey;
@@ -430,6 +453,7 @@ declare class ClawOpsAgent {
     private _log;
     private _pipelineLog;
     private _isPipelineSession;
+    private _holdAudioChunks;
     constructor(options: ClawOpsAgentOptions);
     /**
      * Register a function tool.
@@ -620,11 +644,14 @@ declare class PipelineSession implements Session {
     private _running;
     private _speaking;
     private _builtinTools;
+    private _holdAudioChunks;
     private _log;
     constructor(options: PipelineSessionOptions);
     setToolRegistry(registry: ToolRegistry): void;
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    /** Tool 실행 중 재생할 hold audio 청크를 설정한다. */
+    setHoldAudio(chunks: Buffer[]): void;
     getTelemetry(): SessionTelemetry;
     setLogger(logger: Logger): void;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
@@ -691,11 +718,14 @@ declare class OpenAIRealtime implements Session {
     private _pendingToolCalls;
     private _responseInProgress;
     private _onResponseDone;
+    private _holdAudioChunks;
     constructor(options?: OpenAIRealtimeOptions);
     /** Inject per-call ToolRegistry. */
     setToolRegistry(registry: ToolRegistry): void;
     /** Inject per-call AudioRecorder. */
     setRecorder(recorder: AudioRecorder): void;
+    /** Tool 실행 중 재생할 hold audio 청크를 설정한다. */
+    setHoldAudio(chunks: Buffer[]): void;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
     feedDtmf(digits: string): Promise<void>;
     feedAudio(audio: Buffer): void;
@@ -721,7 +751,7 @@ interface GeminiRealtimeOptions {
     apiKey?: string;
     /** System prompt / instructions for the AI. */
     systemPrompt?: string;
-    /** Model to use. Default: 'gemini-2.5-flash-native-audio-preview-12-2025' */
+    /** Model to use. Default: 'gemini-3.1-flash-live-preview' */
     model?: string;
     /** Voice name. Default: 'Kore' */
     voice?: string;
@@ -745,7 +775,10 @@ declare class GeminiRealtime implements Session {
     private _sentAudioChunks;
     private _audioRemainder;
     private _builtinTools;
-    private _toolCallInProgress;
+    private _pendingToolCall;
+    private _toolDrainTimer;
+    private _lastAudioTime;
+    private _holdAudioChunks;
     private _log;
     constructor(options?: GeminiRealtimeOptions);
     /** Inject per-call ToolRegistry. */
@@ -753,6 +786,8 @@ declare class GeminiRealtime implements Session {
     /** Inject per-call AudioRecorder. */
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    /** Tool 실행 중 재생할 hold audio 청크를 설정한다. */
+    setHoldAudio(chunks: Buffer[]): void;
     setLogger(logger: Logger): void;
     getTelemetry(): SessionTelemetry;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
@@ -763,6 +798,8 @@ declare class GeminiRealtime implements Session {
     private _handleMessage;
     private _handleAudioData;
     private _flushAudioRemainder;
+    private static readonly TOOL_DRAIN_TIMEOUT;
+    private _scheduleToolExecution;
     private _handleToolCall;
 }
 
@@ -1140,4 +1177,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, 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 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 };