@teamlearners/clawops 0.22.0 → 0.23.0

package/dist/agent/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkCJ2LJZDQ_cjs = require('../chunk-CJ2LJZDQ.cjs');
+var chunkNXMTLS2U_cjs = require('../chunk-NXMTLS2U.cjs');
 var pino = require('pino');
 var fs = require('fs');
 var path = require('path');
@@ -1079,7 +1079,7 @@ var MAX_ERROR_MESSAGE_LENGTH = 200;
 function getSdkInfo() {
   return {
     name: "clawops-node",
-    version: chunkCJ2LJZDQ_cjs.VERSION,
+    version: chunkNXMTLS2U_cjs.VERSION,
     runtime: `node/${process.versions.node}`,
     os: `${process.platform}/${os__default.default.arch()}`
   };
@@ -1279,7 +1279,9 @@ var CallSession = class {
    *
    * destinationType='pstn' (default): `to` is a phone number dialed via carrier.
    * destinationType='sip': `to` is a SIP URI (e.g. `sip:user@host`) connected
-   * directly to a SIP endpoint without going through the PSTN carrier.
+   * directly to a SIP endpoint without going through the PSTN carrier. Requires the
+   * account to have an active `sip_trunk` add-on; otherwise the transfer fails and
+   * the call continues with the AI (result `{ status: 'failed', ... }`).
    */
   async transfer(to, options) {
     if (!this._transferFn) {
@@ -1771,10 +1773,12 @@ var ClawOpsAgent = class _ClawOpsAgent {
   /** prewarm 세션이 실제 CallSession 에 attach 완료된 callId. attached 이후의 stop() 은 정상 종료 경로가 책임진다. */
   _prewarmAttached = /* @__PURE__ */ new Set();
   _prewarmEnabled;
+  /** 모든 발신에 적용되는 AMD default. call() 인자로 호출별 override 가능. */
+  _machineDetection;
   constructor(options) {
     this._apiKey = options.apiKey ?? process.env["CLAWOPS_API_KEY"] ?? "";
     this._accountId = options.accountId ?? process.env["CLAWOPS_ACCOUNT_ID"] ?? "";
-    this._baseUrl = options.baseUrl ?? chunkCJ2LJZDQ_cjs.DEFAULT_BASE_URL;
+    this._baseUrl = options.baseUrl ?? chunkNXMTLS2U_cjs.DEFAULT_BASE_URL;
     this._fromNumber = options.from;
     this._session = options.session;
     this._recording = options.recording ?? false;
@@ -1785,6 +1789,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     this._rxGain = _ClawOpsAgent._validateGain("rxGain", options.rxGain ?? 1);
     this._txGain = _ClawOpsAgent._validateGain("txGain", options.txGain ?? 1);
     this._prewarmEnabled = options.prewarmEnabled ?? true;
+    this._machineDetection = options.machineDetection;
     if (options.tracing) {
       setTracingConfig(options.tracing);
     }
@@ -1797,7 +1802,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   }
   static _validateGain(name, gain) {
     if (typeof gain !== "number" || !Number.isFinite(gain) || gain < 0) {
-      throw new chunkCJ2LJZDQ_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
+      throw new chunkNXMTLS2U_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
     }
     return gain;
   }
@@ -1811,7 +1816,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new chunkCJ2LJZDQ_cjs.AgentError(
+        throw new chunkNXMTLS2U_cjs.AgentError(
           "tool(name, description, parameters, handler) requires all arguments."
         );
       }
@@ -1847,10 +1852,10 @@ var ClawOpsAgent = class _ClawOpsAgent {
   async connect() {
     if (this._controlWs) return;
     if (!this._apiKey) {
-      throw new chunkCJ2LJZDQ_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
+      throw new chunkNXMTLS2U_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
     if (!this._accountId) {
-      throw new chunkCJ2LJZDQ_cjs.AgentError(
+      throw new chunkNXMTLS2U_cjs.AgentError(
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
@@ -1874,7 +1879,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       } catch {
       }
     } catch (err) {
-      throw new chunkCJ2LJZDQ_cjs.AgentConnectionError(
+      throw new chunkNXMTLS2U_cjs.AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
@@ -1913,6 +1918,8 @@ var ClawOpsAgent = class _ClawOpsAgent {
    *
    * @param options.machineDetection 자동응답기/음성사서함 감지(AMD).
    *   `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+   *   미지정 시 인스턴스 default(생성자의 `machineDetection`)를 따른다.
+   *   우선순위: 호출 인자 > 인스턴스 default > 비활성.
    */
   async call(to, options) {
     await this.connect();
@@ -1922,8 +1929,9 @@ var ClawOpsAgent = class _ClawOpsAgent {
       From: this._fromNumber,
       Timeout: options?.timeout ?? 60
     };
-    if (options?.machineDetection) {
-      body["MachineDetection"] = options.machineDetection;
+    const effectiveMd = options?.machineDetection ?? this._machineDetection;
+    if (effectiveMd) {
+      body["MachineDetection"] = effectiveMd;
     }
     const resp = await fetch(url, {
       method: "POST",
@@ -1935,7 +1943,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     });
     if (resp.status !== 201) {
       const error = await resp.json();
-      throw new chunkCJ2LJZDQ_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
+      throw new chunkNXMTLS2U_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
     }
     const data = await resp.json();
     const callSession = new CallSession({