@teamlearners/clawops 0.5.8 → 0.6.0

package/dist/agent/index.d.cts

@@ -128,6 +128,36 @@ declare function mcpServerHTTP(options: {
     headers?: Record<string, string>;
 }): MCPServerHTTP;
 
+interface ProviderInfo {
+    provider: string;
+    model: string;
+}
+interface SessionTelemetry {
+    sessionType: string;
+    llm: ProviderInfo | null;
+    stt: ProviderInfo | null;
+    tts: ProviderInfo | null;
+    voice: string | null;
+    language: string;
+    greetingEnabled: boolean;
+    recordingEnabled: boolean;
+    toolCount: number;
+    mcpServerCount: number;
+    builtinTools: string[];
+}
+interface CallMetrics {
+    firstResponseMs: number | null;
+    turnCount: number;
+    toolCallCount: number;
+    toolErrorCount: number;
+    bargeInCount: number;
+    endReason: string | null;
+    errors: Array<{
+        type: string;
+        message: string;
+    }>;
+}
+
 /**
  * CallSession represents an active phone call and provides methods to
  * send audio, hang up, and listen for lifecycle events.
@@ -173,6 +203,8 @@ declare class CallSession {
     private _handlers;
     private _endedPromise;
     private _resolveEnded;
+    private _metrics;
+    private _firstResponseSent;
     constructor(options: {
         callId: string;
         fromNumber: string;
@@ -184,6 +216,13 @@ declare class CallSession {
     setLogger(logger: Logger): void;
     get status(): CallStatus;
     get duration(): number;
+    get metrics(): Readonly<CallMetrics>;
+    recordFirstResponse(): void;
+    recordTurn(): void;
+    recordToolCall(): void;
+    recordToolError(err: Error): void;
+    recordBargeIn(): void;
+    recordEndReason(reason: string): void;
     /** Bind transport functions (called internally by the agent). */
     _bindTransport(send: SendAudioFn, clear: ClearAudioFn, hangup: HangupFn, sendDtmf?: SendDtmfFn, isConnected?: () => boolean): void;
     /** Send PCM16 or ulaw audio to the caller. */
@@ -272,6 +311,8 @@ interface Session {
     stop(): Promise<void>;
     /** Set the logger instance for this session. */
     setLogger?(logger: Logger): void;
+    /** Return session telemetry for reporting. */
+    getTelemetry?(): SessionTelemetry | null;
 }
 /**
  * Speech-to-Text provider interface.
@@ -521,6 +562,7 @@ declare class PipelineSession implements Session {
     setToolRegistry(registry: ToolRegistry): void;
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    getTelemetry(): SessionTelemetry;
     setLogger(logger: Logger): void;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
     feedAudio(audio: Buffer): void;
@@ -575,6 +617,7 @@ declare class OpenAIRealtime implements Session {
     private _builtinTools;
     setLogger(logger: Logger): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    getTelemetry(): SessionTelemetry;
     private _ws;
     private _call;
     private _tools;
@@ -648,6 +691,7 @@ declare class GeminiRealtime implements Session {
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
     setLogger(logger: Logger): void;
+    getTelemetry(): SessionTelemetry;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
     feedAudio(audio: Buffer): void;
     feedDtmf(digits: string): Promise<void>;
@@ -686,6 +730,8 @@ interface DeepgramSTTOptions {
 declare class DeepgramSTT implements STT {
     private _options;
     private _log;
+    get provider(): string;
+    get model(): string;
     setLogger(logger: Logger): void;
     constructor(options?: DeepgramSTTOptions);
     transcribe(audioStream: AsyncIterable<Buffer>, options?: {
@@ -717,6 +763,9 @@ interface ElevenLabsTTSOptions {
 declare class ElevenLabsTTS implements TTS {
     private _options;
     private _log;
+    get provider(): string;
+    get model(): string;
+    get voiceId(): string;
     setLogger(logger: Logger): void;
     constructor(options?: ElevenLabsTTSOptions);
     synthesize(text: string | AsyncIterable<string>, options?: {
@@ -743,6 +792,8 @@ interface OpenAILLMOptions {
 }
 declare class OpenAILLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options?: OpenAILLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -767,6 +818,8 @@ interface AnthropicLLMOptions {
 }
 declare class AnthropicLLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options?: AnthropicLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -791,6 +844,8 @@ interface GeminiLLMOptions {
 }
 declare class GeminiLLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options?: GeminiLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -819,6 +874,8 @@ interface OpenAICompatLLMOptions {
 }
 declare class OpenAICompatLLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options: OpenAICompatLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -844,6 +901,8 @@ interface OllamaLLMOptions {
 }
 declare class OllamaLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: OllamaLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -860,6 +919,8 @@ interface MistralLLMOptions {
 }
 declare class MistralLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: MistralLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -876,6 +937,8 @@ interface GroqLLMOptions {
 }
 declare class GroqLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: GroqLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -892,6 +955,8 @@ interface PerplexityLLMOptions {
 }
 declare class PerplexityLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: PerplexityLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -908,6 +973,8 @@ interface TogetherLLMOptions {
 }
 declare class TogetherLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: TogetherLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -924,6 +991,8 @@ interface FireworksLLMOptions {
 }
 declare class FireworksLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: FireworksLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -940,6 +1009,8 @@ interface DeepSeekLLMOptions {
 }
 declare class DeepSeekLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: DeepSeekLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -956,6 +1027,8 @@ interface XaiLLMOptions {
 }
 declare class XaiLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: XaiLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;

package/dist/agent/index.d.ts

@@ -128,6 +128,36 @@ declare function mcpServerHTTP(options: {
     headers?: Record<string, string>;
 }): MCPServerHTTP;
 
+interface ProviderInfo {
+    provider: string;
+    model: string;
+}
+interface SessionTelemetry {
+    sessionType: string;
+    llm: ProviderInfo | null;
+    stt: ProviderInfo | null;
+    tts: ProviderInfo | null;
+    voice: string | null;
+    language: string;
+    greetingEnabled: boolean;
+    recordingEnabled: boolean;
+    toolCount: number;
+    mcpServerCount: number;
+    builtinTools: string[];
+}
+interface CallMetrics {
+    firstResponseMs: number | null;
+    turnCount: number;
+    toolCallCount: number;
+    toolErrorCount: number;
+    bargeInCount: number;
+    endReason: string | null;
+    errors: Array<{
+        type: string;
+        message: string;
+    }>;
+}
+
 /**
  * CallSession represents an active phone call and provides methods to
  * send audio, hang up, and listen for lifecycle events.
@@ -173,6 +203,8 @@ declare class CallSession {
     private _handlers;
     private _endedPromise;
     private _resolveEnded;
+    private _metrics;
+    private _firstResponseSent;
     constructor(options: {
         callId: string;
         fromNumber: string;
@@ -184,6 +216,13 @@ declare class CallSession {
     setLogger(logger: Logger): void;
     get status(): CallStatus;
     get duration(): number;
+    get metrics(): Readonly<CallMetrics>;
+    recordFirstResponse(): void;
+    recordTurn(): void;
+    recordToolCall(): void;
+    recordToolError(err: Error): void;
+    recordBargeIn(): void;
+    recordEndReason(reason: string): void;
     /** Bind transport functions (called internally by the agent). */
     _bindTransport(send: SendAudioFn, clear: ClearAudioFn, hangup: HangupFn, sendDtmf?: SendDtmfFn, isConnected?: () => boolean): void;
     /** Send PCM16 or ulaw audio to the caller. */
@@ -272,6 +311,8 @@ interface Session {
     stop(): Promise<void>;
     /** Set the logger instance for this session. */
     setLogger?(logger: Logger): void;
+    /** Return session telemetry for reporting. */
+    getTelemetry?(): SessionTelemetry | null;
 }
 /**
  * Speech-to-Text provider interface.
@@ -521,6 +562,7 @@ declare class PipelineSession implements Session {
     setToolRegistry(registry: ToolRegistry): void;
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    getTelemetry(): SessionTelemetry;
     setLogger(logger: Logger): void;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
     feedAudio(audio: Buffer): void;
@@ -575,6 +617,7 @@ declare class OpenAIRealtime implements Session {
     private _builtinTools;
     setLogger(logger: Logger): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
+    getTelemetry(): SessionTelemetry;
     private _ws;
     private _call;
     private _tools;
@@ -648,6 +691,7 @@ declare class GeminiRealtime implements Session {
     setRecorder(recorder: AudioRecorder): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
     setLogger(logger: Logger): void;
+    getTelemetry(): SessionTelemetry;
     start(callSession: CallSession, tools?: ToolRegistry): Promise<void>;
     feedAudio(audio: Buffer): void;
     feedDtmf(digits: string): Promise<void>;
@@ -686,6 +730,8 @@ interface DeepgramSTTOptions {
 declare class DeepgramSTT implements STT {
     private _options;
     private _log;
+    get provider(): string;
+    get model(): string;
     setLogger(logger: Logger): void;
     constructor(options?: DeepgramSTTOptions);
     transcribe(audioStream: AsyncIterable<Buffer>, options?: {
@@ -717,6 +763,9 @@ interface ElevenLabsTTSOptions {
 declare class ElevenLabsTTS implements TTS {
     private _options;
     private _log;
+    get provider(): string;
+    get model(): string;
+    get voiceId(): string;
     setLogger(logger: Logger): void;
     constructor(options?: ElevenLabsTTSOptions);
     synthesize(text: string | AsyncIterable<string>, options?: {
@@ -743,6 +792,8 @@ interface OpenAILLMOptions {
 }
 declare class OpenAILLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options?: OpenAILLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -767,6 +818,8 @@ interface AnthropicLLMOptions {
 }
 declare class AnthropicLLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options?: AnthropicLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -791,6 +844,8 @@ interface GeminiLLMOptions {
 }
 declare class GeminiLLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options?: GeminiLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -819,6 +874,8 @@ interface OpenAICompatLLMOptions {
 }
 declare class OpenAICompatLLM implements LLM {
     private _options;
+    get provider(): string;
+    get model(): string;
     constructor(options: OpenAICompatLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -844,6 +901,8 @@ interface OllamaLLMOptions {
 }
 declare class OllamaLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: OllamaLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -860,6 +919,8 @@ interface MistralLLMOptions {
 }
 declare class MistralLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: MistralLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -876,6 +937,8 @@ interface GroqLLMOptions {
 }
 declare class GroqLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: GroqLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -892,6 +955,8 @@ interface PerplexityLLMOptions {
 }
 declare class PerplexityLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: PerplexityLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -908,6 +973,8 @@ interface TogetherLLMOptions {
 }
 declare class TogetherLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: TogetherLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -924,6 +991,8 @@ interface FireworksLLMOptions {
 }
 declare class FireworksLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: FireworksLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -940,6 +1009,8 @@ interface DeepSeekLLMOptions {
 }
 declare class DeepSeekLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: DeepSeekLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;
@@ -956,6 +1027,8 @@ interface XaiLLMOptions {
 }
 declare class XaiLLM implements LLM {
     private _inner;
+    get provider(): string;
+    get model(): string;
     constructor(options?: XaiLLMOptions);
     generate(messages: ConversationMessage[], options?: {
         tools?: ToolRegistry;