@teamlearners/clawops 0.31.0 → 0.32.1

package/README.md

@@ -480,7 +480,7 @@ const client = new ClawOps({
 
 | 언어 | 패키지 | 저장소 |
 |------|--------|--------|
-| Python | [`clawops`](https://pypi.org/project/clawops/) | [clawops-python](https://github.com/learners-superpumped/clawops-python) |
+| Python | [`clawops`](https://pypi.org/project/clawops/) | [sdk-python](https://github.com/clawopshq/sdk-python) |
 
 ## 요구사항
 

package/dist/agent/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKHEU4DKD_cjs = require('../chunk-KHEU4DKD.cjs');
+var chunk6ABL54D2_cjs = require('../chunk-6ABL54D2.cjs');
 var chunkQD2ZY4UP_cjs = require('../chunk-QD2ZY4UP.cjs');
 var fs = require('fs');
 var path = require('path');
@@ -728,7 +728,7 @@ var MAX_ERROR_MESSAGE_LENGTH = 200;
 function getSdkInfo() {
   return {
     name: "clawops-node",
-    version: chunkKHEU4DKD_cjs.VERSION,
+    version: chunk6ABL54D2_cjs.VERSION,
     runtime: `node/${process.versions.node}`,
     os: `${process.platform}/${os__default.default.arch()}`
   };
@@ -765,6 +765,7 @@ var CallSession = class {
   metadata;
   _status;
   _endedStatus = null;
+  _endedDuration = null;
   _sendAudioFn = null;
   _clearAudioFn = null;
   _hangupFn = null;
@@ -824,9 +825,22 @@ var CallSession = class {
   get endedStatus() {
     return this._endedStatus;
   }
+  /**
+   * 서버가 확정한 통화 시간(초). 통화가 끝나기 전에는 `null`.
+   *
+   * ⚠️ `duration` 과 다르다 — 그쪽은 SDK 가 로컬 시계로 재는 **경과 시간**이라 통화 중에도
+   * 읽히고, 세션이 붙기 전후의 오차를 포함한다. 기록·정산에 쓸 값은 이쪽이다.
+   */
+  get endedDuration() {
+    return this._endedDuration;
+  }
   get duration() {
     return (Date.now() - this.startTime.getTime()) / 1e3;
   }
+  /** @internal 서버가 통보한 통화 시간을 확정한다. */
+  _setEndedDuration(seconds) {
+    this._endedDuration = seconds;
+  }
   get metrics() {
     return this._metrics;
   }
@@ -1416,6 +1430,7 @@ var ATTR_CALL_DIRECTION = "clawops.call.direction";
 var ATTR_AGENT_ID = "clawops.agent.id";
 
 // src/agent/agent.ts
+var TERMINAL_FRAME_GRACE_MS = 2e3;
 var ClawOpsAgent = class _ClawOpsAgent {
   _apiKey;
   _accountId;
@@ -1429,6 +1444,8 @@ var ClawOpsAgent = class _ClawOpsAgent {
   _recording;
   _recordingPath;
   _activeSessions = /* @__PURE__ */ new Map();
+  /** 미디어 정리를 마친 통화가 서버 종료 프레임을 기다리는 자리. callId → resolve. */
+  _terminalWaiters = /* @__PURE__ */ new Map();
   _builtinTools;
   _passiveDtmfDebounceMs;
   _passiveDtmfBuffer = [];
@@ -1451,7 +1468,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   constructor(options) {
     this._apiKey = options.apiKey ?? process.env["CLAWOPS_API_KEY"] ?? "";
     this._accountId = options.accountId ?? process.env["CLAWOPS_ACCOUNT_ID"] ?? "";
-    this._baseUrl = options.baseUrl ?? chunkKHEU4DKD_cjs.DEFAULT_BASE_URL;
+    this._baseUrl = options.baseUrl ?? chunk6ABL54D2_cjs.DEFAULT_BASE_URL;
     this._fromNumber = options.from;
     this._session = options.session;
     this._recording = options.recording ?? false;
@@ -1475,7 +1492,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   }
   static _validateGain(name, gain) {
     if (typeof gain !== "number" || !Number.isFinite(gain) || gain < 0) {
-      throw new chunkKHEU4DKD_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
+      throw new chunk6ABL54D2_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
     }
     return gain;
   }
@@ -1489,7 +1506,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new chunkKHEU4DKD_cjs.AgentError(
+        throw new chunk6ABL54D2_cjs.AgentError(
           "tool(name, description, parameters, handler) requires all arguments."
         );
       }
@@ -1525,10 +1542,10 @@ var ClawOpsAgent = class _ClawOpsAgent {
   async connect() {
     if (this._controlWs) return;
     if (!this._apiKey) {
-      throw new chunkKHEU4DKD_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
+      throw new chunk6ABL54D2_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
     if (!this._accountId) {
-      throw new chunkKHEU4DKD_cjs.AgentError(
+      throw new chunk6ABL54D2_cjs.AgentError(
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
@@ -1552,7 +1569,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       } catch {
       }
     } catch (err) {
-      throw new chunkKHEU4DKD_cjs.AgentConnectionError(
+      throw new chunk6ABL54D2_cjs.AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
@@ -1578,6 +1595,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       this._controlWs.close();
       this._controlWs = null;
     }
+    for (const wake of [...this._terminalWaiters.values()]) wake();
     for (const session of this._activeSessions.values()) {
       session._markEnded();
     }
@@ -1616,7 +1634,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     });
     if (resp.status !== 201) {
       const error = await resp.json();
-      throw new chunkKHEU4DKD_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
+      throw new chunk6ABL54D2_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
     }
     const data = await resp.json();
     const callSession = new CallSession({
@@ -1665,12 +1683,43 @@ var ClawOpsAgent = class _ClawOpsAgent {
       this._safeStartCallSession(session, mediaUrl, callId);
     }
   }
+  /**
+   * 서버 종료 프레임을 짧게 기다린다. 미디어 정리 직후에만 부른다.
+   *
+   * 왜 기다리나: `call_end` 는 인바운드 사용자가 통화 결과를 받는 **유일한 통로**인데, 서버는
+   * 미디어 WS 를 먼저 닫고 자원 정리를 마친 뒤에야 control 종료 프레임을 보낸다. 안 기다리면
+   * 그 핸들러 안에서 `endedDuration` 은 영영 null 이다.
+   *
+   * 상한을 다 쓰는 경우는 제어 연결이 죽어 프레임이 아예 안 오는 때뿐이다 — 그 프레임은
+   * 예전부터 늘 오던 것이고(이번에 바뀐 건 내용뿐), 정상 경로에서는 밀리초 안에 풀린다.
+   */
+  async _awaitServerTerminal(session) {
+    if (session.endedDuration !== null) return;
+    await new Promise((resolve) => {
+      const done = () => {
+        clearTimeout(timer);
+        this._terminalWaiters.delete(session.callId);
+        resolve();
+      };
+      const timer = setTimeout(() => {
+        this._log.debug(
+          "\uC11C\uBC84 \uC885\uB8CC \uD504\uB808\uC784\uC774 %dms \uC548\uC5D0 \uC624\uC9C0 \uC54A\uC558\uB2E4 \u2014 endedDuration \uC5C6\uC774 \uC9C4\uD589: %s",
+          TERMINAL_FRAME_GRACE_MS,
+          session.callId
+        );
+        done();
+      }, TERMINAL_FRAME_GRACE_MS);
+      this._terminalWaiters.set(session.callId, done);
+    });
+  }
   _handleEnded(event) {
     const callId = event["callId"];
     const status = event["status"] || "completed";
+    const endedDuration = event["duration"];
     const session = this._activeSessions.get(callId);
     if (session) {
       this._log.info("Call ended (server): %s (status=%s)", callId, status);
+      if (typeof endedDuration === "number") session._setEndedDuration(endedDuration);
       if (status !== "completed") {
         this._log.info("Outbound call not connected: %s (%s)", callId, status);
         session._emit("call_failed", status);
@@ -1678,6 +1727,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       session._markEnded(status);
       this._activeSessions.delete(callId);
     }
+    this._terminalWaiters.get(callId)?.();
     void this._cleanupPrewarm(callId);
   }
   /**
@@ -2032,6 +2082,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
             this._controlWs?.send({ event: "call.metrics", callId: session.callId, metrics: session.metrics });
           } catch {
           }
+          await this._awaitServerTerminal(session);
           session._emit("call_end");
           session._markEnded();
           this._activeSessions.delete(session.callId);