@teamlearners/clawops 0.20.2 → 0.22.0

package/README.md

@@ -280,6 +280,19 @@ const numbers = await client.numbers.list();
 // 웹훅 URL 변경
 await client.numbers.update('07012340001', { webhookUrl: 'https://my-app.com/webhook' });
 
+// 인바운드 소프트폰 착신으로 라우팅 변경 (sip_trunk 부가서비스 + 등록 단말 필요)
+// 1) 등록된 SIP 단말(credential) 목록에서 id 조회
+const creds = await client.sipCredentials.list({ status: 'active' });
+// 2) 그 id 로 라우팅 설정
+await client.numbers.update('07012340001', {
+  routingType: 'softphone',
+  sipCredentialId: creds[0].id,
+});
+
+// (sip 라우팅의 경우) SIP 엔드포인트 id 조회
+const endpoints = await client.sipEndpoints.list({ status: 'active' });
+await client.numbers.update('07012340001', { routingType: 'sip', sipEndpointId: endpoints[0].id });
+
 // 번호 해제
 await client.numbers.delete('07012340001');
 ```

package/dist/agent/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkVFSF6CKS_cjs = require('../chunk-VFSF6CKS.cjs');
+var chunkCJ2LJZDQ_cjs = require('../chunk-CJ2LJZDQ.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: chunkVFSF6CKS_cjs.VERSION,
+    version: chunkCJ2LJZDQ_cjs.VERSION,
     runtime: `node/${process.versions.node}`,
     os: `${process.platform}/${os__default.default.arch()}`
   };
@@ -1274,13 +1274,20 @@ 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.
+   */
   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",
@@ -1767,7 +1774,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 ?? chunkVFSF6CKS_cjs.DEFAULT_BASE_URL;
+    this._baseUrl = options.baseUrl ?? chunkCJ2LJZDQ_cjs.DEFAULT_BASE_URL;
     this._fromNumber = options.from;
     this._session = options.session;
     this._recording = options.recording ?? false;
@@ -1790,7 +1797,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   }
   static _validateGain(name, gain) {
     if (typeof gain !== "number" || !Number.isFinite(gain) || gain < 0) {
-      throw new chunkVFSF6CKS_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
+      throw new chunkCJ2LJZDQ_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
     }
     return gain;
   }
@@ -1804,7 +1811,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new chunkVFSF6CKS_cjs.AgentError(
+        throw new chunkCJ2LJZDQ_cjs.AgentError(
           "tool(name, description, parameters, handler) requires all arguments."
         );
       }
@@ -1840,10 +1847,10 @@ var ClawOpsAgent = class _ClawOpsAgent {
   async connect() {
     if (this._controlWs) return;
     if (!this._apiKey) {
-      throw new chunkVFSF6CKS_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
+      throw new chunkCJ2LJZDQ_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
     if (!this._accountId) {
-      throw new chunkVFSF6CKS_cjs.AgentError(
+      throw new chunkCJ2LJZDQ_cjs.AgentError(
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
@@ -1867,7 +1874,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       } catch {
       }
     } catch (err) {
-      throw new chunkVFSF6CKS_cjs.AgentConnectionError(
+      throw new chunkCJ2LJZDQ_cjs.AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
@@ -1928,7 +1935,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     });
     if (resp.status !== 201) {
       const error = await resp.json();
-      throw new chunkVFSF6CKS_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
+      throw new chunkCJ2LJZDQ_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
     }
     const data = await resp.json();
     const callSession = new CallSession({
@@ -2361,11 +2368,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 +2463,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,