@teamlearners/clawops 0.21.0 → 0.23.0

package/dist/agent/index.d.cts

@@ -246,8 +246,17 @@ declare class CallSession {
     }): Promise<string>;
     /** Send a sequence of DTMF digits. */
     sendDtmfSequence(digits: string): Promise<void>;
-    /** 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', ... }`).
+     */
     transfer(to: string, options?: {
+        destinationType?: 'pstn' | 'sip';
         mode?: 'blind' | 'warm';
         afterTransfer?: 'terminate' | 'return';
         holdMedia?: string;
@@ -458,6 +467,13 @@ interface ClawOpsAgentOptions {
      * Python SDK 의 `prewarm_enabled` 과 mirror.
      */
     prewarmEnabled?: boolean;
+    /**
+     * 이 에이전트의 모든 발신에 적용되는 AMD(machineDetection) default.
+     * `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+     * `call(to, { machineDetection })` 로 호출별 override 가능.
+     * 우선순위: 호출 인자 > 인스턴스 default > 비활성. Python SDK 의 `machine_detection` 과 mirror.
+     */
+    machineDetection?: 'Enable' | 'Hangup';
 }
 declare class ClawOpsAgent {
     private _apiKey;
@@ -489,6 +505,8 @@ declare class ClawOpsAgent {
     /** prewarm 세션이 실제 CallSession 에 attach 완료된 callId. attached 이후의 stop() 은 정상 종료 경로가 책임진다. */
     private _prewarmAttached;
     private _prewarmEnabled;
+    /** 모든 발신에 적용되는 AMD default. call() 인자로 호출별 override 가능. */
+    private _machineDetection?;
     constructor(options: ClawOpsAgentOptions);
     private static _validateGain;
     /**
@@ -522,6 +540,8 @@ declare class ClawOpsAgent {
      *
      * @param options.machineDetection 자동응답기/음성사서함 감지(AMD).
      *   `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+     *   미지정 시 인스턴스 default(생성자의 `machineDetection`)를 따른다.
+     *   우선순위: 호출 인자 > 인스턴스 default > 비활성.
      */
     call(to: string, options?: {
         timeout?: number;

package/dist/agent/index.d.ts

@@ -246,8 +246,17 @@ declare class CallSession {
     }): Promise<string>;
     /** Send a sequence of DTMF digits. */
     sendDtmfSequence(digits: string): Promise<void>;
-    /** 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', ... }`).
+     */
     transfer(to: string, options?: {
+        destinationType?: 'pstn' | 'sip';
         mode?: 'blind' | 'warm';
         afterTransfer?: 'terminate' | 'return';
         holdMedia?: string;
@@ -458,6 +467,13 @@ interface ClawOpsAgentOptions {
      * Python SDK 의 `prewarm_enabled` 과 mirror.
      */
     prewarmEnabled?: boolean;
+    /**
+     * 이 에이전트의 모든 발신에 적용되는 AMD(machineDetection) default.
+     * `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+     * `call(to, { machineDetection })` 로 호출별 override 가능.
+     * 우선순위: 호출 인자 > 인스턴스 default > 비활성. Python SDK 의 `machine_detection` 과 mirror.
+     */
+    machineDetection?: 'Enable' | 'Hangup';
 }
 declare class ClawOpsAgent {
     private _apiKey;
@@ -489,6 +505,8 @@ declare class ClawOpsAgent {
     /** prewarm 세션이 실제 CallSession 에 attach 완료된 callId. attached 이후의 stop() 은 정상 종료 경로가 책임진다. */
     private _prewarmAttached;
     private _prewarmEnabled;
+    /** 모든 발신에 적용되는 AMD default. call() 인자로 호출별 override 가능. */
+    private _machineDetection?;
     constructor(options: ClawOpsAgentOptions);
     private static _validateGain;
     /**
@@ -522,6 +540,8 @@ declare class ClawOpsAgent {
      *
      * @param options.machineDetection 자동응답기/음성사서함 감지(AMD).
      *   `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+     *   미지정 시 인스턴스 default(생성자의 `machineDetection`)를 따른다.
+     *   우선순위: 호출 인자 > 인스턴스 default > 비활성.
      */
     call(to: string, options?: {
         timeout?: number;

package/dist/agent/index.js

@@ -1,4 +1,4 @@
-import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-MSQH3MCJ.js';
+import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-JU36ASTU.js';
 import pino from 'pino';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -1247,13 +1247,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",
@@ -1737,6 +1746,8 @@ 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"] ?? "";
@@ -1751,6 +1762,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);
     }
@@ -1879,6 +1891,8 @@ var ClawOpsAgent = class _ClawOpsAgent {
    *
    * @param options.machineDetection 자동응답기/음성사서함 감지(AMD).
    *   `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+   *   미지정 시 인스턴스 default(생성자의 `machineDetection`)를 따른다.
+   *   우선순위: 호출 인자 > 인스턴스 default > 비활성.
    */
   async call(to, options) {
     await this.connect();
@@ -1888,8 +1902,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",
@@ -2334,11 +2349,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)" },
@@ -2428,6 +2444,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,