@teamlearners/clawops 0.22.0 → 0.23.0

package/dist/agent/index.d.cts

@@ -251,7 +251,9 @@ declare class CallSession {
      *
      * 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', ... }`).
      */
     transfer(to: string, options?: {
         destinationType?: 'pstn' | 'sip';
@@ -465,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;
@@ -496,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;
     /**
@@ -529,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

@@ -251,7 +251,9 @@ declare class CallSession {
      *
      * 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', ... }`).
      */
     transfer(to: string, options?: {
         destinationType?: 'pstn' | 'sip';
@@ -465,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;
@@ -496,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;
     /**
@@ -529,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-5PLVSC2U.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';
@@ -1252,7 +1252,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) {
@@ -1744,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"] ?? "";
@@ -1758,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);
     }
@@ -1886,6 +1891,8 @@ var ClawOpsAgent = class _ClawOpsAgent {
    *
    * @param options.machineDetection 자동응답기/음성사서함 감지(AMD).
    *   `'Enable'`=감지 후 `AnsweredBy` 통보(통화 계속), `'Hangup'`=음성사서함 감지 시 자동 종료.
+   *   미지정 시 인스턴스 default(생성자의 `machineDetection`)를 따른다.
+   *   우선순위: 호출 인자 > 인스턴스 default > 비활성.
    */
   async call(to, options) {
     await this.connect();
@@ -1895,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",