@teamlearners/clawops 0.15.1 → 0.16.3

package/README.md

@@ -201,6 +201,25 @@ if (summary.status === 'completed') {
 }
 ```
 
+### 통화 녹음 (Recordings)
+
+콘솔에서 들리는 것과 동일한 서버측 MixMonitor 원본(WAV PCM 16bit mono 8kHz)을 다운로드합니다. SDK 측 mix.wav가 아닌 서버에서 합성된 파일이라 싱크/볼륨이 정상입니다.
+
+```typescript
+import { writeFile } from 'node:fs/promises';
+
+// callList 응답의 recordingUrl 필드로 녹음 유무 확인 가능
+const list = await client.calls.list({ pageSize: 10 });
+for (const call of list.data) {
+  if (!call.recordingUrl) continue; // failed/no-answer 등은 null
+  const rec = await client.recordings.download(call.callId);
+  await writeFile(rec.filename ?? `${call.callId}.wav`, Buffer.from(rec.data));
+  console.log(rec.contentType, rec.data.byteLength, 'bytes');
+}
+```
+
+녹음이 없는 통화(`recordingUrl: null`)에 호출하면 `NotFoundError(404)` 가 발생합니다.
+
 ### 전화번호 (Numbers)
 
 ```typescript

package/dist/agent/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkRMN74YKI_cjs = require('../chunk-RMN74YKI.cjs');
+var chunk4QQXMZ76_cjs = require('../chunk-4QQXMZ76.cjs');
 var pino = require('pino');
 var fs = require('fs');
 var path = require('path');
@@ -331,6 +331,27 @@ function ulawToPcm16(ulaw) {
   }
   return out;
 }
+function applyPcm16Gain(pcm, gain) {
+  if (!pcm.length) return Buffer.alloc(0);
+  if (gain === 1) return pcm;
+  if (!Number.isFinite(gain) || gain < 0) {
+    throw new Error("gain must be a finite number >= 0");
+  }
+  const nSamples = pcm.length >> 1;
+  const out = Buffer.alloc(nSamples * 2);
+  for (let i = 0; i < nSamples; i++) {
+    let value = Math.round(pcm.readInt16LE(i * 2) * gain);
+    if (value > 32767) value = 32767;
+    else if (value < -32768) value = -32768;
+    out.writeInt16LE(value, i * 2);
+  }
+  return out;
+}
+function applyUlawGain(ulaw, gain) {
+  if (!ulaw.length) return Buffer.alloc(0);
+  if (gain === 1) return ulaw;
+  return pcm16ToUlaw(applyPcm16Gain(ulawToPcm16(ulaw), gain));
+}
 function resamplePcm16(pcm, fromRate, toRate) {
   if (fromRate === toRate || !pcm.length) return pcm;
   const nSamples = pcm.length >> 1;
@@ -919,8 +940,9 @@ var AudioRecorder = class {
   _inWritten = 0;
   _outWritten = 0;
   _mixWritten = 0;
-  _startTime = 0;
   _started = false;
+  _baseTs = null;
+  _outCursor = 0;
   _log = NOOP_LOGGER;
   setLogger(logger) {
     this._log = logger;
@@ -937,17 +959,18 @@ var AudioRecorder = class {
     fs__namespace.writeSync(this._fdIn, header);
     fs__namespace.writeSync(this._fdOut, header);
     fs__namespace.writeSync(this._fdMix, header);
-    this._startTime = performance.now();
     this._started = true;
     this._log.info("Recording started: %s", this._dir);
   }
-  _expectedBytes() {
-    const elapsed = (performance.now() - this._startTime) / 1e3;
-    return Math.floor(elapsed * BYTES_PER_SECOND);
+  _timestampToBytes(mediaTsMs) {
+    if (this._baseTs === null) {
+      this._baseTs = mediaTsMs;
+    }
+    const target = Math.floor((mediaTsMs - this._baseTs) * BYTES_PER_SECOND / 1e3);
+    return Math.max(0, target - target % 2);
   }
-  _padSilence(fd, written) {
-    const expected = this._expectedBytes();
-    let gap = expected - written;
+  _padSilence(fd, written, target) {
+    let gap = target - written;
     if (gap <= 0) return 0;
     gap = gap - gap % 2;
     if (gap > 0) {
@@ -957,9 +980,12 @@ var AudioRecorder = class {
   }
   _writeToMix(data, trackPos) {
     if (this._fdMix === null) return;
+    data = data.subarray(0, data.length - data.length % 2);
+    if (data.length === 0) return;
     const filePos = 44 + trackPos;
     if (trackPos < this._mixWritten) {
-      const overlap = Math.min(data.length, this._mixWritten - trackPos);
+      let overlap = Math.min(data.length, this._mixWritten - trackPos);
+      overlap = overlap - overlap % 2;
       const existing = Buffer.alloc(overlap);
       fs__namespace.readSync(this._fdMix, existing, 0, overlap, filePos);
       const mixed = mixSamples(existing, data.subarray(0, overlap));
@@ -982,10 +1008,13 @@ var AudioRecorder = class {
       this._mixWritten += data.length;
     }
   }
-  writeInbound(pcm16_8k) {
+  writeInbound(pcm16_8k, mediaTsMs = 0) {
     if (!this._started || this._fdIn === null) return;
     try {
-      const gap = this._padSilence(this._fdIn, this._inWritten);
+      pcm16_8k = pcm16_8k.subarray(0, pcm16_8k.length - pcm16_8k.length % 2);
+      if (pcm16_8k.length === 0) return;
+      const target = this._timestampToBytes(mediaTsMs);
+      const gap = this._padSilence(this._fdIn, this._inWritten, target);
       this._inWritten += gap;
       const posBefore = this._inWritten;
       fs__namespace.writeSync(this._fdIn, pcm16_8k);
@@ -995,14 +1024,21 @@ var AudioRecorder = class {
       this._log.error({ err }, "Recording write error (inbound)");
     }
   }
-  writeOutbound(pcm16_8k) {
+  writeOutbound(pcm16_8k, mediaTsMs) {
     if (!this._started || this._fdOut === null) return;
     try {
-      const gap = this._padSilence(this._fdOut, this._outWritten);
+      pcm16_8k = pcm16_8k.subarray(0, pcm16_8k.length - pcm16_8k.length % 2);
+      if (pcm16_8k.length === 0) return;
+      let target = this._outCursor;
+      if (mediaTsMs !== void 0) {
+        target = Math.max(target, this._timestampToBytes(mediaTsMs));
+      }
+      const gap = this._padSilence(this._fdOut, this._outWritten, target);
       this._outWritten += gap;
       const posBefore = this._outWritten;
       fs__namespace.writeSync(this._fdOut, pcm16_8k);
       this._outWritten += pcm16_8k.length;
+      this._outCursor = this._outWritten;
       this._writeToMix(pcm16_8k, posBefore);
     } catch (err) {
       this._log.error({ err }, "Recording write error (outbound)");
@@ -1043,7 +1079,7 @@ var MAX_ERROR_MESSAGE_LENGTH = 200;
 function getSdkInfo() {
   return {
     name: "clawops-node",
-    version: chunkRMN74YKI_cjs.VERSION,
+    version: chunk4QQXMZ76_cjs.VERSION,
     runtime: `node/${process.versions.node}`,
     os: `${process.platform}/${os__default.default.arch()}`
   };
@@ -1698,7 +1734,7 @@ var ATTR_CALL_DIRECTION = "clawops.call.direction";
 var ATTR_AGENT_ID = "clawops.agent.id";
 
 // src/agent/agent.ts
-var ClawOpsAgent = class {
+var ClawOpsAgent = class _ClawOpsAgent {
   _apiKey;
   _accountId;
   _baseUrl;
@@ -1721,10 +1757,12 @@ var ClawOpsAgent = class {
   _pipelineLog;
   _isPipelineSession = false;
   _holdAudioChunks = null;
+  _rxGain;
+  _txGain;
   constructor(options) {
     this._apiKey = options.apiKey ?? process.env["CLAWOPS_API_KEY"] ?? "";
     this._accountId = options.accountId ?? process.env["CLAWOPS_ACCOUNT_ID"] ?? "";
-    this._baseUrl = options.baseUrl ?? chunkRMN74YKI_cjs.DEFAULT_BASE_URL;
+    this._baseUrl = options.baseUrl ?? chunk4QQXMZ76_cjs.DEFAULT_BASE_URL;
     this._fromNumber = options.from;
     this._session = options.session;
     this._recording = options.recording ?? false;
@@ -1732,6 +1770,8 @@ var ClawOpsAgent = class {
     this._mcpServers = options.mcpServers ?? [];
     this._builtinTools = resolveBuiltinTools(options.builtinTools ?? "all" /* ALL */);
     this._passiveDtmfDebounceMs = options.passiveDtmfDebounceMs ?? 500;
+    this._rxGain = _ClawOpsAgent._validateGain("rxGain", options.rxGain ?? 1);
+    this._txGain = _ClawOpsAgent._validateGain("txGain", options.txGain ?? 1);
     if (options.tracing) {
       setTracingConfig(options.tracing);
     }
@@ -1742,6 +1782,12 @@ var ClawOpsAgent = class {
       this._holdAudioChunks = loadHoldAudio(options.toolConfig.holdAudio);
     }
   }
+  static _validateGain(name, gain) {
+    if (typeof gain !== "number" || !Number.isFinite(gain) || gain < 0) {
+      throw new chunk4QQXMZ76_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
+    }
+    return gain;
+  }
   /**
    * Register a function tool.
    *
@@ -1752,7 +1798,7 @@ var ClawOpsAgent = class {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new chunkRMN74YKI_cjs.AgentError(
+        throw new chunk4QQXMZ76_cjs.AgentError(
           "tool(name, description, parameters, handler) requires all arguments."
         );
       }
@@ -1788,10 +1834,10 @@ var ClawOpsAgent = class {
   async connect() {
     if (this._controlWs) return;
     if (!this._apiKey) {
-      throw new chunkRMN74YKI_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
+      throw new chunk4QQXMZ76_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
     if (!this._accountId) {
-      throw new chunkRMN74YKI_cjs.AgentError(
+      throw new chunk4QQXMZ76_cjs.AgentError(
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
@@ -1815,7 +1861,7 @@ var ClawOpsAgent = class {
       } catch {
       }
     } catch (err) {
-      throw new chunkRMN74YKI_cjs.AgentConnectionError(
+      throw new chunk4QQXMZ76_cjs.AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
@@ -1866,7 +1912,7 @@ var ClawOpsAgent = class {
     });
     if (resp.status !== 201) {
       const error = await resp.json();
-      throw new chunkRMN74YKI_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
+      throw new chunk4QQXMZ76_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
     }
     const data = await resp.json();
     const callSession = new CallSession({
@@ -2024,9 +2070,14 @@ var ClawOpsAgent = class {
         }
         const mediaWs = new MediaWebSocket();
         mediaWs.setLogger(this._log);
+        let latestMediaTs = 0;
         session._bindTransport(
           (audio) => {
-            mediaWs.sendAudio(audio.toString("base64"));
+            const gained = applyUlawGain(audio, this._txGain);
+            if (recorder) {
+              recorder.writeOutbound(ulawToPcm16(gained), latestMediaTs);
+            }
+            mediaWs.sendAudio(gained.toString("base64"));
             session.recordFirstResponse();
           },
           () => {
@@ -2063,12 +2114,14 @@ var ClawOpsAgent = class {
           sessionHandler.setHoldAudio(this._holdAudioChunks);
         }
         this._callSessions.set(session.callId, sessionHandler);
-        mediaWs.onAudio((ulawAudio, _timestamp) => {
-          if (sessionHandler) {
-            sessionHandler.feedAudio(ulawAudio);
-          }
+        mediaWs.onAudio((ulawAudio, timestamp) => {
+          latestMediaTs = timestamp;
+          const gained = applyUlawGain(ulawAudio, this._rxGain);
           if (recorder) {
-            recorder.writeInbound(ulawToPcm16(ulawAudio));
+            recorder.writeInbound(ulawToPcm16(gained), timestamp);
+          }
+          if (sessionHandler) {
+            sessionHandler.feedAudio(gained, timestamp);
           }
         });
         mediaWs.onDtmf((digit) => {
@@ -2539,10 +2592,6 @@ var PipelineSession = class {
         sampleRate: this._sampleRate
       })) {
         if (!this._running || !this._speaking) break;
-        if (this._recorder) {
-          const pcm8k2 = this._sampleRate !== 8e3 ? resamplePcm16(audioChunk, this._sampleRate, 8e3) : audioChunk;
-          this._recorder.writeOutbound(pcm8k2);
-        }
         const pcm8k = resamplePcm16(audioChunk, this._sampleRate, 8e3);
         const ulaw = pcm16ToUlaw(pcm8k);
         for (let off = 0; off < ulaw.length; off += 160) {
@@ -2612,7 +2661,7 @@ var OpenAIRealtime = class {
   constructor(options = {}) {
     this._apiKey = options.apiKey ?? process.env["OPENAI_API_KEY"] ?? "";
     this._systemPrompt = options.systemPrompt ?? "";
-    this._model = options.model ?? "gpt-realtime-1.5";
+    this._model = options.model ?? "gpt-realtime-2";
     this._voice = options.voice ?? "marin";
     this._language = options.language ?? "ko";
     this._turnDetection = options.turnDetection !== void 0 ? options.turnDetection : { type: "semantic_vad", eagerness: "medium", interrupt_response: true };
@@ -2687,8 +2736,8 @@ var OpenAIRealtime = class {
     });
     this._send({ type: "response.create" });
   }
-  feedAudio(audio) {
-    this._latestMediaTs = Date.now();
+  feedAudio(audio, timestamp) {
+    this._latestMediaTs = timestamp ?? this._latestMediaTs;
     if (this._ws && this._ws.readyState === 1 && !this._closed) {
       this._send({
         type: "input_audio_buffer.append",
@@ -2799,7 +2848,7 @@ var OpenAIRealtime = class {
     if (this._playback === null) {
       this._playback = {
         itemId: msg["item_id"] || "",
-        startTs: this._latestMediaTs || Date.now(),
+        startTs: this._latestMediaTs,
         sentChunks: 0,
         generating: true,
         audioRemainder: Buffer.alloc(0)
@@ -2809,9 +2858,6 @@ var OpenAIRealtime = class {
     }
     const pb = this._playback;
     const ulaw = Buffer.from(msg["delta"], "base64");
-    if (this._recorder) {
-      this._recorder.writeOutbound(ulawToPcm16(ulaw));
-    }
     const combined = Buffer.concat([pb.audioRemainder, ulaw]);
     const chunkSize = 160;
     const fullEnd = Math.floor(combined.length / chunkSize) * chunkSize;
@@ -2835,7 +2881,7 @@ var OpenAIRealtime = class {
     if (pb === null) {
       return;
     }
-    const playedMs = Math.max(0, (this._latestMediaTs || Date.now()) - pb.startTs);
+    const playedMs = Math.max(0, this._latestMediaTs - pb.startTs);
     this._log.info(
       "[Interrupt] item=%s played=%dms total=%dms",
       pb.itemId,
@@ -3127,9 +3173,6 @@ var GeminiRealtime = class _GeminiRealtime {
   feedAudio(audio) {
     if (this._session && !this._closed) {
       const pcm8k = ulawToPcm16(audio);
-      if (this._recorder) {
-        this._recorder.writeInbound(pcm8k);
-      }
       const pcm16k = resamplePcm16(pcm8k, 8e3, 16e3);
       this._session.sendRealtimeInput({
         audio: {
@@ -3227,9 +3270,6 @@ var GeminiRealtime = class _GeminiRealtime {
   _handleAudioData(b64Data) {
     if (!this._call) return;
     const pcm24k = Buffer.from(b64Data, "base64");
-    if (this._recorder) {
-      this._recorder.writeOutbound(resamplePcm16(pcm24k, 24e3, 8e3));
-    }
     const pcm8k = resamplePcm16(pcm24k, 24e3, 8e3);
     const ulaw = pcm16ToUlaw(pcm8k);
     const combined = Buffer.concat([this._audioRemainder, ulaw]);