@teamlearners/clawops 0.5.8 → 0.6.0

package/dist/agent/index.js

@@ -1,7 +1,8 @@
-import { DEFAULT_BASE_URL, AgentError, AgentConnectionError } from '../chunk-7S2OEBS6.js';
+import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-2B74QZZJ.js';
 import pino from 'pino';
 import * as fs from 'fs';
 import * as path from 'path';
+import os from 'os';
 
 // src/agent/audio.ts
 var _BIAS = 132;
@@ -972,6 +973,36 @@ var AudioRecorder = class {
     }
   }
 };
+var MAX_ERRORS = 20;
+var MAX_ERROR_MESSAGE_LENGTH = 200;
+function getSdkInfo() {
+  return {
+    name: "clawops-node",
+    version: VERSION,
+    runtime: `node/${process.versions.node}`,
+    os: `${process.platform}/${os.arch()}`
+  };
+}
+function createCallMetrics() {
+  return {
+    firstResponseMs: null,
+    turnCount: 0,
+    toolCallCount: 0,
+    toolErrorCount: 0,
+    bargeInCount: 0,
+    endReason: null,
+    errors: []
+  };
+}
+function addMetricError(metrics, err) {
+  metrics.toolErrorCount++;
+  if (metrics.errors.length < MAX_ERRORS) {
+    metrics.errors.push({
+      type: err.name || "Error",
+      message: (err.message || "").slice(0, MAX_ERROR_MESSAGE_LENGTH)
+    });
+  }
+}
 
 // src/agent/session.ts
 var CallSession = class {
@@ -997,6 +1028,8 @@ var CallSession = class {
   _handlers = /* @__PURE__ */ new Map();
   _endedPromise;
   _resolveEnded;
+  _metrics = createCallMetrics();
+  _firstResponseSent = false;
   constructor(options) {
     this.callId = options.callId;
     this.fromNumber = options.fromNumber;
@@ -1019,6 +1052,30 @@ var CallSession = class {
   get duration() {
     return (Date.now() - this.startTime.getTime()) / 1e3;
   }
+  get metrics() {
+    return this._metrics;
+  }
+  recordFirstResponse() {
+    if (!this._firstResponseSent) {
+      this._firstResponseSent = true;
+      this._metrics.firstResponseMs = Date.now() - this.startTime.getTime();
+    }
+  }
+  recordTurn() {
+    this._metrics.turnCount++;
+  }
+  recordToolCall() {
+    this._metrics.toolCallCount++;
+  }
+  recordToolError(err) {
+    addMetricError(this._metrics, err);
+  }
+  recordBargeIn() {
+    this._metrics.bargeInCount++;
+  }
+  recordEndReason(reason) {
+    this._metrics.endReason = reason;
+  }
   /** Bind transport functions (called internally by the agent). */
   _bindTransport(send, clear, hangup, sendDtmf, isConnected) {
     this._sendAudioFn = send;
@@ -1483,6 +1540,10 @@ var ClawOpsAgent = class {
     try {
       await this._controlWs.connect();
       await this._controlWs.waitConnected();
+      try {
+        this._controlWs.send({ event: "agent.hello", sdk: getSdkInfo() });
+      } catch {
+      }
     } catch (err) {
       throw new AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
@@ -1696,9 +1757,11 @@ var ClawOpsAgent = class {
         session._bindTransport(
           (audio) => {
             mediaWs.sendAudio(audio.toString("base64"));
+            session.recordFirstResponse();
           },
           () => {
             mediaWs.sendClear();
+            session.recordBargeIn();
           },
           async () => {
             await mediaWs.flush();
@@ -1749,10 +1812,22 @@ var ClawOpsAgent = class {
           await mediaWs.connect(mediaWsUrl, this._apiKey);
           this._log.info("Media stream started: %s", session.callId);
           await sessionHandler.start(session, sessionTools);
+          const telemetry = sessionHandler.getTelemetry?.() ?? null;
+          if (telemetry) {
+            telemetry.toolCount = sessionTools?.size ?? 0;
+            telemetry.mcpServerCount = this._mcpServers?.length ?? 0;
+            telemetry.builtinTools = this._builtinTools ? [...this._builtinTools].map((t) => t.toString()) : [];
+            telemetry.recordingEnabled = this._recording;
+            try {
+              this._controlWs.send({ event: "call.telemetry", callId: session.callId, telemetry });
+            } catch {
+            }
+          }
           await session.wait();
           await sessionHandler.stop();
         } catch (err) {
           this._log.error({ err }, "Call session error: %s", session.callId);
+          session.recordEndReason("error");
         } finally {
           if (mcpClients.length > 0) {
             sessionTools.clearMcpTools();
@@ -1764,6 +1839,13 @@ var ClawOpsAgent = class {
           if (recorder) {
             recorder.stop();
           }
+          if (!session.metrics.endReason) {
+            session.recordEndReason(session.status === "ended" ? "user_hangup" : "agent_hangup");
+          }
+          try {
+            this._controlWs?.send({ event: "call.metrics", callId: session.callId, metrics: session.metrics });
+          } catch {
+          }
           session._emit("call_end");
           session._markEnded();
           this._activeSessions.delete(session.callId);
@@ -1930,6 +2012,24 @@ var PipelineSession = class {
   setBuiltinTools(tools) {
     this._builtinTools = tools;
   }
+  getTelemetry() {
+    const llm = this._llm;
+    const stt = this._stt;
+    const tts = this._tts;
+    return {
+      sessionType: "pipeline",
+      llm: llm.provider && llm.model ? { provider: llm.provider, model: llm.model } : null,
+      stt: stt.provider && stt.model ? { provider: stt.provider, model: stt.model } : null,
+      tts: tts.provider && tts.model ? { provider: tts.provider, model: tts.model } : null,
+      voice: tts.voiceId ?? null,
+      language: this._language,
+      greetingEnabled: this._greeting,
+      recordingEnabled: !!this._recorder,
+      toolCount: this._tools?.size ?? 0,
+      mcpServerCount: 0,
+      builtinTools: []
+    };
+  }
   setLogger(logger) {
     this._log = logger;
     if ("setLogger" in this._stt && typeof this._stt.setLogger === "function") {
@@ -2076,6 +2176,7 @@ var PipelineSession = class {
         }
       }
       if (!this._tools) return;
+      this._callSession?.recordToolCall();
       const result = await this._tools.call(name, args);
       this._conversation.push({
         role: "assistant",
@@ -2107,6 +2208,9 @@ var PipelineSession = class {
       }
     } catch (err) {
       this._log.error({ err }, "Tool call failed: %s", name);
+      if (err instanceof Error) {
+        this._callSession?.recordToolError(err);
+      }
     }
   }
   async _synthesizeAndSend(text) {
@@ -2157,6 +2261,21 @@ var OpenAIRealtime = class {
   setBuiltinTools(tools) {
     this._builtinTools = tools;
   }
+  getTelemetry() {
+    return {
+      sessionType: "openai_realtime",
+      llm: { provider: "openai", model: this._model },
+      stt: null,
+      tts: null,
+      voice: this._voice,
+      language: this._language,
+      greetingEnabled: this._greeting,
+      recordingEnabled: !!this._recorder,
+      toolCount: this._tools?.size ?? 0,
+      mcpServerCount: 0,
+      builtinTools: []
+    };
+  }
   _ws = null;
   _call = null;
   _tools = null;
@@ -2444,9 +2563,13 @@ var OpenAIRealtime = class {
       let result;
       try {
         const args = JSON.parse(item["arguments"] ?? "{}");
+        this._call?.recordToolCall();
         result = await this._tools.call(funcName, args);
       } catch (err) {
         this._log.error({ err }, "Tool call failed: %s", funcName);
+        if (err instanceof Error) {
+          this._call?.recordToolError(err);
+        }
         result = `Error: ${err}`;
       }
       if (controller.signal.aborted) {
@@ -2595,6 +2718,21 @@ var GeminiRealtime = class {
   setLogger(logger) {
     this._log = logger;
   }
+  getTelemetry() {
+    return {
+      sessionType: "gemini_realtime",
+      llm: { provider: "gemini", model: this._model },
+      stt: null,
+      tts: null,
+      voice: this._voice,
+      language: this._language,
+      greetingEnabled: this._greeting,
+      recordingEnabled: !!this._recorder,
+      toolCount: this._tools?.size ?? 0,
+      mcpServerCount: 0,
+      builtinTools: []
+    };
+  }
   async start(callSession, tools) {
     this._call = callSession;
     if (tools) this._tools = tools;
@@ -2798,6 +2936,7 @@ var GeminiRealtime = class {
         continue;
       }
       try {
+        this._call?.recordToolCall();
         const result = await this._tools.call(name, args);
         const resultStr = typeof result === "string" ? result : JSON.stringify(result);
         this._log.info("Tool result: %s -> %s", name, resultStr.substring(0, 200));
@@ -2808,6 +2947,9 @@ var GeminiRealtime = class {
         });
       } catch (err) {
         this._log.error({ err }, "Tool call failed: %s", name);
+        if (err instanceof Error) {
+          this._call?.recordToolError(err);
+        }
         responses.push({
           id: fcId,
           name,
@@ -2829,6 +2971,12 @@ var GeminiRealtime = class {
 var DeepgramSTT = class {
   _options;
   _log = NOOP_LOGGER;
+  get provider() {
+    return "deepgram";
+  }
+  get model() {
+    return this._options.model ?? "nova-3";
+  }
   setLogger(logger) {
     this._log = logger;
   }
@@ -2950,6 +3098,15 @@ var DeepgramSTT = class {
 var ElevenLabsTTS = class {
   _options;
   _log = NOOP_LOGGER;
+  get provider() {
+    return "elevenlabs";
+  }
+  get model() {
+    return this._options.model ?? "eleven_flash_v2_5";
+  }
+  get voiceId() {
+    return this._options.voiceId ?? "EXAVITQu4vr4xnSDxMaL";
+  }
   setLogger(logger) {
     this._log = logger;
   }
@@ -3102,6 +3259,12 @@ var ElevenLabsTTS = class {
 // src/agent/pipeline/llm/openai-llm.ts
 var OpenAILLM = class {
   _options;
+  get provider() {
+    return "openai";
+  }
+  get model() {
+    return this._options.model;
+  }
   constructor(options = {}) {
     this._options = {
       model: "gpt-4o-mini",
@@ -3188,6 +3351,12 @@ var OpenAILLM = class {
 // src/agent/pipeline/llm/anthropic-llm.ts
 var AnthropicLLM = class {
   _options;
+  get provider() {
+    return "anthropic";
+  }
+  get model() {
+    return this._options.model;
+  }
   constructor(options = {}) {
     this._options = {
       model: "claude-sonnet-4-6",
@@ -3293,6 +3462,12 @@ var AnthropicLLM = class {
 // src/agent/pipeline/llm/gemini-llm.ts
 var GeminiLLM = class {
   _options;
+  get provider() {
+    return "gemini";
+  }
+  get model() {
+    return this._options.model;
+  }
   constructor(options = {}) {
     this._options = {
       model: "gemini-2.5-flash",
@@ -3377,6 +3552,12 @@ var GeminiLLM = class {
 // src/agent/pipeline/llm/openai-compat-llm.ts
 var OpenAICompatLLM = class {
   _options;
+  get provider() {
+    return "openai_compatible";
+  }
+  get model() {
+    return this._options.model;
+  }
   constructor(options) {
     this._options = options;
   }
@@ -3460,6 +3641,12 @@ var OpenAICompatLLM = class {
 // src/agent/pipeline/llm/ollama-llm.ts
 var OllamaLLM = class {
   _inner;
+  get provider() {
+    return "ollama";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     const baseUrl = options.baseUrl ?? process.env["OLLAMA_BASE_URL"] ?? "http://localhost:11434/v1";
     this._inner = new OpenAICompatLLM({
@@ -3478,6 +3665,12 @@ var OllamaLLM = class {
 // src/agent/pipeline/llm/mistral-llm.ts
 var MistralLLM = class {
   _inner;
+  get provider() {
+    return "mistral";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     this._inner = new OpenAICompatLLM({
       apiKey: options.apiKey ?? process.env["MISTRAL_API_KEY"],
@@ -3495,6 +3688,12 @@ var MistralLLM = class {
 // src/agent/pipeline/llm/groq-llm.ts
 var GroqLLM = class {
   _inner;
+  get provider() {
+    return "groq";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     this._inner = new OpenAICompatLLM({
       apiKey: options.apiKey ?? process.env["GROQ_API_KEY"],
@@ -3512,6 +3711,12 @@ var GroqLLM = class {
 // src/agent/pipeline/llm/perplexity-llm.ts
 var PerplexityLLM = class {
   _inner;
+  get provider() {
+    return "perplexity";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     this._inner = new OpenAICompatLLM({
       apiKey: options.apiKey ?? process.env["PERPLEXITY_API_KEY"],
@@ -3529,6 +3734,12 @@ var PerplexityLLM = class {
 // src/agent/pipeline/llm/together-llm.ts
 var TogetherLLM = class {
   _inner;
+  get provider() {
+    return "together";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     this._inner = new OpenAICompatLLM({
       apiKey: options.apiKey ?? process.env["TOGETHER_API_KEY"],
@@ -3546,6 +3757,12 @@ var TogetherLLM = class {
 // src/agent/pipeline/llm/fireworks-llm.ts
 var FireworksLLM = class {
   _inner;
+  get provider() {
+    return "fireworks";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     this._inner = new OpenAICompatLLM({
       apiKey: options.apiKey ?? process.env["FIREWORKS_API_KEY"],
@@ -3563,6 +3780,12 @@ var FireworksLLM = class {
 // src/agent/pipeline/llm/deepseek-llm.ts
 var DeepSeekLLM = class {
   _inner;
+  get provider() {
+    return "deepseek";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     this._inner = new OpenAICompatLLM({
       apiKey: options.apiKey ?? process.env["DEEPSEEK_API_KEY"],
@@ -3580,6 +3803,12 @@ var DeepSeekLLM = class {
 // src/agent/pipeline/llm/xai-llm.ts
 var XaiLLM = class {
   _inner;
+  get provider() {
+    return "xai";
+  }
+  get model() {
+    return this._inner.model;
+  }
   constructor(options = {}) {
     this._inner = new OpenAICompatLLM({
       apiKey: options.apiKey ?? process.env["XAI_API_KEY"],