@teamlearners/clawops 0.5.8 → 0.8.0

package/README.md

@@ -128,6 +128,19 @@ const call = await client.calls.create({
 });
 console.log(call.callId);
 
+// AI Completion 모드 — AI가 직접 통화를 처리
+const aiCall = await client.calls.create({
+  to: '01012345678',
+  from: '07052358010',
+  ai: {
+    provider: 'openai',
+    model: 'gpt-realtime',
+    apiKey: process.env.OPENAI_API_KEY!,
+    voice: 'marin',
+    messages: [{ role: 'system', content: '당신은 예약 확인 AI입니다.' }],
+  },
+});
+
 // 통화 목록 조회 (페이지네이션)
 const page = await client.calls.list({ status: 'completed', page: 0, pageSize: 20 });
 for (const call of page) {

package/dist/agent/index.cjs

@@ -1,9 +1,10 @@
 'use strict';
 
-var chunk6IQN5RQD_cjs = require('../chunk-6IQN5RQD.cjs');
+var chunkR742GPVL_cjs = require('../chunk-R742GPVL.cjs');
 var pino = require('pino');
 var fs = require('fs');
 var path = require('path');
+var os = require('os');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -28,6 +29,7 @@ function _interopNamespace(e) {
 var pino__default = /*#__PURE__*/_interopDefault(pino);
 var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
 var path__namespace = /*#__PURE__*/_interopNamespace(path);
+var os__default = /*#__PURE__*/_interopDefault(os);
 
 // src/agent/audio.ts
 var _BIAS = 132;
@@ -998,6 +1000,36 @@ var AudioRecorder = class {
     }
   }
 };
+var MAX_ERRORS = 20;
+var MAX_ERROR_MESSAGE_LENGTH = 200;
+function getSdkInfo() {
+  return {
+    name: "clawops-node",
+    version: chunkR742GPVL_cjs.VERSION,
+    runtime: `node/${process.versions.node}`,
+    os: `${process.platform}/${os__default.default.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 {
@@ -1023,6 +1055,8 @@ var CallSession = class {
   _handlers = /* @__PURE__ */ new Map();
   _endedPromise;
   _resolveEnded;
+  _metrics = createCallMetrics();
+  _firstResponseSent = false;
   constructor(options) {
     this.callId = options.callId;
     this.fromNumber = options.fromNumber;
@@ -1045,6 +1079,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;
@@ -1426,7 +1484,7 @@ var ClawOpsAgent = class {
   constructor(options) {
     this._apiKey = options.apiKey ?? process.env["CLAWOPS_API_KEY"] ?? "";
     this._accountId = options.accountId ?? process.env["CLAWOPS_ACCOUNT_ID"] ?? "";
-    this._baseUrl = options.baseUrl ?? chunk6IQN5RQD_cjs.DEFAULT_BASE_URL;
+    this._baseUrl = options.baseUrl ?? chunkR742GPVL_cjs.DEFAULT_BASE_URL;
     this._fromNumber = options.from;
     this._session = options.session;
     this._recording = options.recording ?? false;
@@ -1451,7 +1509,7 @@ var ClawOpsAgent = class {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new chunk6IQN5RQD_cjs.AgentError(
+        throw new chunkR742GPVL_cjs.AgentError(
           "tool(name, description, parameters, handler) requires all arguments."
         );
       }
@@ -1487,10 +1545,10 @@ var ClawOpsAgent = class {
   async connect() {
     if (this._controlWs) return;
     if (!this._apiKey) {
-      throw new chunk6IQN5RQD_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
+      throw new chunkR742GPVL_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
     if (!this._accountId) {
-      throw new chunk6IQN5RQD_cjs.AgentError(
+      throw new chunkR742GPVL_cjs.AgentError(
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
@@ -1509,8 +1567,12 @@ 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 chunk6IQN5RQD_cjs.AgentConnectionError(
+      throw new chunkR742GPVL_cjs.AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
@@ -1561,7 +1623,7 @@ var ClawOpsAgent = class {
     });
     if (resp.status !== 201) {
       const error = await resp.json();
-      throw new chunk6IQN5RQD_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
+      throw new chunkR742GPVL_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
     }
     const data = await resp.json();
     const callSession = new CallSession({
@@ -1722,9 +1784,11 @@ var ClawOpsAgent = class {
         session._bindTransport(
           (audio) => {
             mediaWs.sendAudio(audio.toString("base64"));
+            session.recordFirstResponse();
           },
           () => {
             mediaWs.sendClear();
+            session.recordBargeIn();
           },
           async () => {
             await mediaWs.flush();
@@ -1775,10 +1839,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();
@@ -1790,6 +1866,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);
@@ -1956,6 +2039,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") {
@@ -2102,6 +2203,7 @@ var PipelineSession = class {
         }
       }
       if (!this._tools) return;
+      this._callSession?.recordToolCall();
       const result = await this._tools.call(name, args);
       this._conversation.push({
         role: "assistant",
@@ -2133,6 +2235,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) {
@@ -2183,6 +2288,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;
@@ -2470,9 +2590,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) {
@@ -2621,6 +2745,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;
@@ -2824,6 +2963,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));
@@ -2834,6 +2974,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,
@@ -2855,6 +2998,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;
   }
@@ -2976,6 +3125,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;
   }
@@ -3128,6 +3286,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",
@@ -3214,6 +3378,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",
@@ -3319,6 +3489,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",
@@ -3403,6 +3579,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;
   }
@@ -3486,6 +3668,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({
@@ -3504,6 +3692,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"],
@@ -3521,6 +3715,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"],
@@ -3538,6 +3738,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"],
@@ -3555,6 +3761,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"],
@@ -3572,6 +3784,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"],
@@ -3589,6 +3807,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"],
@@ -3606,6 +3830,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"],
@@ -3654,6 +3884,7 @@ exports.GeminiLLM = GeminiLLM;
 exports.GeminiRealtime = GeminiRealtime;
 exports.GroqLLM = GroqLLM;
 exports.MCPClient = MCPClient;
+exports.MediaWebSocket = MediaWebSocket;
 exports.MistralLLM = MistralLLM;
 exports.OllamaLLM = OllamaLLM;
 exports.OpenAICompatLLM = OpenAICompatLLM;