@teamlearners/clawops 0.21.0 → 0.23.0

package/dist/agent/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkTRLJ6I3F_cjs = require('../chunk-TRLJ6I3F.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: chunkTRLJ6I3F_cjs.VERSION,
+    version: chunkNXMTLS2U_cjs.VERSION,
     runtime: `node/${process.versions.node}`,
     os: `${process.platform}/${os__default.default.arch()}`
   };
@@ -1274,13 +1274,22 @@ var CallSession = class {
       }
     }
   }
-  /** Transfer the call to another destination. */
+  /**
+   * Transfer the call to a phone number or SIP endpoint.
+   *
+   * 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. 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) {
       throw new Error("transfer not available");
     }
     return this._transferFn({
       to,
+      destinationType: options?.destinationType ?? "pstn",
       mode: options?.mode ?? "blind",
       afterTransfer: options?.afterTransfer ?? "terminate",
       holdMedia: options?.holdMedia ?? "ringback",
@@ -1764,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 ?? chunkTRLJ6I3F_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;
@@ -1778,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);
     }
@@ -1790,7 +1802,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   }
   static _validateGain(name, gain) {
     if (typeof gain !== "number" || !Number.isFinite(gain) || gain < 0) {
-      throw new chunkTRLJ6I3F_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;
   }
@@ -1804,7 +1816,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new chunkTRLJ6I3F_cjs.AgentError(
+        throw new chunkNXMTLS2U_cjs.AgentError(
           "tool(name, description, parameters, handler) requires all arguments."
         );
       }
@@ -1840,10 +1852,10 @@ var ClawOpsAgent = class _ClawOpsAgent {
   async connect() {
     if (this._controlWs) return;
     if (!this._apiKey) {
-      throw new chunkTRLJ6I3F_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 chunkTRLJ6I3F_cjs.AgentError(
+      throw new chunkNXMTLS2U_cjs.AgentError(
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
@@ -1867,7 +1879,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       } catch {
       }
     } catch (err) {
-      throw new chunkTRLJ6I3F_cjs.AgentConnectionError(
+      throw new chunkNXMTLS2U_cjs.AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
@@ -1906,6 +1918,8 @@ var ClawOpsAgent = class _ClawOpsAgent {
    *
    * @param options.machineDetection 자동응답기/음성사서함 감지(AMD).
    *   `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+   *   미지정 시 인스턴스 default(생성자의 `machineDetection`)를 따른다.
+   *   우선순위: 호출 인자 > 인스턴스 default > 비활성.
    */
   async call(to, options) {
     await this.connect();
@@ -1915,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",
@@ -1928,7 +1943,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     });
     if (resp.status !== 201) {
       const error = await resp.json();
-      throw new chunkTRLJ6I3F_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({
@@ -2361,11 +2376,12 @@ var SEND_DTMF = {
 };
 var TRANSFER_CALL = {
   name: "transfer_call",
-  description: "Transfer the current call to another phone number. Use for blind transfer (direct handoff) or warm transfer (with whisper message to the target).",
+  description: "Transfer the current call to another phone number or SIP endpoint. Use for blind transfer (direct handoff) or warm transfer (with whisper message to the target).",
   parameters: {
     type: "object",
     properties: {
-      to: { type: "string", description: "Phone number to transfer to" },
+      to: { type: "string", description: "Transfer destination. A phone number when destination_type is 'pstn', or a SIP URI (e.g. 'sip:user@host') when destination_type is 'sip'." },
+      destination_type: { type: "string", enum: ["pstn", "sip"], description: "pstn: dial a phone number via carrier (default). sip: connect directly to a SIP endpoint (no carrier/PSTN)." },
       mode: { type: "string", enum: ["blind", "warm"], description: "blind: direct transfer (default), warm: play whisper to target first" },
       after_transfer: { type: "string", enum: ["terminate", "return"], description: "terminate: end AI session (default), return: AI resumes after transfer ends" },
       whisper: { type: "string", description: "Message to speak to transfer target before connecting customer (warm mode only)" },
@@ -2455,6 +2471,7 @@ async function executeBuiltinTool(funcName, args, call) {
   if (funcName === "transfer_call") {
     try {
       call.transfer(args["to"], {
+        destinationType: args["destination_type"] ?? void 0,
         mode: args["mode"] ?? void 0,
         afterTransfer: args["after_transfer"] ?? void 0,
         whisper: args["whisper"] ?? void 0,