@teamlearners/clawops 0.28.0 → 0.30.0

package/dist/index.d.cts

@@ -230,7 +230,7 @@ type AssignmentLink = z.infer<typeof AssignmentLinkSchema>;
 type AssignmentLinkCreateResponse = z.infer<typeof AssignmentLinkCreateResponseSchema>;
 type AssignmentLinkStatus = AssignmentLink['status'];
 
-type RequestOptions$1 = {
+type RequestOptions$2 = {
     extraHeaders?: Record<string, string>;
     extraQuery?: Record<string, unknown>;
     timeout?: number;
@@ -246,13 +246,13 @@ declare class AssignmentLinks extends APIResource {
         webhookUrl?: string;
         webhookMethod?: 'POST' | 'GET';
         note?: string;
-    }, options?: RequestOptions$1): Promise<AssignmentLinkCreateResponse>;
+    }, options?: RequestOptions$2): Promise<AssignmentLinkCreateResponse>;
     list(params?: {
         status?: AssignmentLinkStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions$1): Promise<Page<AssignmentLink>>;
-    retrieve(linkId: string, options?: RequestOptions$1): Promise<AssignmentLink>;
+    }, options?: RequestOptions$2): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions$2): Promise<AssignmentLink>;
     revoke(linkId: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -316,7 +316,7 @@ type BlockedChannel = BlockedRecipient['channel'];
 type BlockedRecipientStatus = 'active' | 'released' | 'all';
 type BlockedRecipientSource = 'api' | 'console' | 'import';
 
-type RequestOptions = {
+type RequestOptions$1 = {
     extraHeaders?: Record<string, string>;
     extraQuery?: Record<string, unknown>;
     timeout?: number;
@@ -345,7 +345,7 @@ declare class BlockedRecipients extends APIResource {
         source?: BlockedRecipientSource;
         sourceRef?: string;
         note?: string;
-    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
     /**
      * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
      * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
@@ -356,9 +356,9 @@ declare class BlockedRecipients extends APIResource {
         status?: BlockedRecipientStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions): Promise<Page<BlockedRecipient>>;
+    }, options?: RequestOptions$1): Promise<Page<BlockedRecipient>>;
     /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
-    retrieve(blockId: string, options?: RequestOptions): Promise<BlockedRecipient>;
+    retrieve(blockId: string, options?: RequestOptions$1): Promise<BlockedRecipient>;
     /**
      * 메모를 수정합니다.
      *
@@ -367,7 +367,7 @@ declare class BlockedRecipients extends APIResource {
      */
     update(blockId: string, params?: {
         note?: string | null;
-    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
     /**
      * 수신거부를 해제해 다시 발신할 수 있게 합니다.
      *
@@ -379,7 +379,7 @@ declare class BlockedRecipients extends APIResource {
      */
     release(blockId: string, params?: {
         note?: string;
-    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
 }
 
 declare const CallSchema: z.ZodObject<{
@@ -534,11 +534,48 @@ declare const CallControlResponseSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 type CallControlResponse = z.infer<typeof CallControlResponseSchema>;
 
+/**
+ * `agentId` 에이전트의 **이번 통화에만** 적용되는 컨텍스트.
+ *
+ * 에이전트 자체의 설정은 그대로 두고 이 통화만 다르게 행동시킬 때 사용한다.
+ * 같은 에이전트로 동시에 거는 다른 통화에는 영향이 없다.
+ */
+interface CallContextParam {
+    /** 이번 통화에서 수행할 실행 요구사항 (최대 4000자). */
+    instruction: string;
+    /** 요구사항에서 참조할 통화별 구조화 데이터 (최대 50개). */
+    variables?: Record<string, string | number | boolean>;
+}
+/**
+ * 발신 전화 생성 요청 파라미터.
+ *
+ * **4가지 모드** — `url`, `agentId`, `callFlowId` 는 서로 배타적이다.
+ *
+ * - **VoiceML 모드**: `url` 을 지정하면 VoiceML 로 통화를 제어한다.
+ * - **매니지드 에이전트 모드**: `agentId` 를 지정하면 콘솔에서 만든 AI 에이전트가
+ *   통화를 처리한다. `callContext` 로 이번 통화만의 지시를 덧붙일 수 있다.
+ * - **콜 플로우 모드**: `callFlowId` 를 지정하면 결정적 ARS 플로우가 진행한다.
+ *   `variables` 로 시작 변수를 넘긴다.
+ * - **Agent SDK 모드**: 셋 다 생략하면 From 번호에 연결된 Agent SDK 로 연결된다.
+ */
 interface CallCreateParams {
     to: string;
     from: string;
-    /** VoiceML 명령을 반환할 URL. */
+    /** VoiceML 명령을 반환할 URL. `agentId`·`callFlowId` 와 배타. */
     url?: string;
+    /** 콘솔에서 만든 매니지드 에이전트 ID. `url`·`callFlowId` 와 배타. */
+    agentId?: string;
+    /** `agentId` 에이전트의 이번 통화에만 적용되는 컨텍스트. */
+    callContext?: CallContextParam;
+    /** 콜 플로우(결정적 ARS) ID. `url`·`agentId` 와 배타. */
+    callFlowId?: string;
+    /**
+     * 콜 플로우 시작 변수. 멘트·URL·본문의 `{{이름}}` 이 이 값으로 치환된다.
+     * `callFlowId` 와 함께일 때만 쓸 수 있다(단독 지정 시 400).
+     * `caller`·`callee`·`recording_url`·`recording_duration`·`http_status` 는
+     * 통화 중 자동으로 채워지는 예약 변수라 지정할 수 없다.
+     */
+    variables?: Record<string, string | number | boolean>;
     statusCallback?: string;
     statusCallbackEvent?: string;
     /** 발신 타임아웃 (초). 기본값: 60. */
@@ -838,70 +875,156 @@ declare class Messages extends APIResource {
     }): Promise<Message>;
 }
 
+/**
+ * 착신 라우팅 모드.
+ *
+ * - `webhook`   : webhookUrl 의 VoiceML 이 처리.
+ * - `agent`     : agentId 의 매니지드 에이전트가 착신.
+ * - `callflow`  : callFlowId 의 콜 플로우(ARS)가 착신.
+ * - `forward`   : forwardTo(같은 계정 보유 번호)로 내부 착신전환.
+ * - `sip`       : sipEndpointId 의 라우트로 외부 PBX 다이얼.
+ * - `softphone` : sipCredentialId 의 등록 단말로 착신.
+ */
+declare const ROUTING_TYPES: readonly ["webhook", "sip", "softphone", "forward", "agent", "callflow"];
+type RoutingType = (typeof ROUTING_TYPES)[number];
 declare const PhoneNumberSchema: z.ZodObject<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;
-type PhoneNumber = z.infer<typeof PhoneNumberSchema>;
+/**
+ * 전화번호. `routingType` 은 알려진 값에 자동완성이 뜨지만, 서버가 새 라우팅을 추가해도
+ * 파싱이 깨지지 않도록 임의의 문자열을 허용한다.
+ */
+type PhoneNumber = Omit<z.infer<typeof PhoneNumberSchema>, 'routingType'> & {
+    routingType?: RoutingType | (string & {}) | null;
+};
 type NumberListItem = PhoneNumber;
 type NumberUpdateResponse = PhoneNumber;
 
 interface NumberCreateParams {
+    /** 수신 전화 처리용 Webhook URL. */
     webhookUrl?: string;
+    /** Webhook 호출 HTTP 메서드. */
+    webhookMethod?: 'POST' | 'GET';
+    /** Webhook 호출 시 덧붙일 헤더. 키는 'X-' 로 시작해야 한다. */
+    webhookHeaders?: Record<string, string>;
+    /** 수신(inbound) 통화 상태 통지 URL. */
+    statusCallback?: string;
+    /** 구독할 상태 이벤트(공백 구분). 미지정 시 'initiated ringing answered completed'. */
+    statusCallbackEvents?: string;
 }
 interface NumberUpdateParams {
-    webhookUrl?: string;
-    webhookMethod?: 'POST' | 'GET';
-    /** inbound 라우팅: webhook | sip | softphone. */
-    routingType?: 'webhook' | 'sip' | 'softphone';
-    /** routingType='sip' 일 때 라우팅할 SipEndpoint id. */
+    /** 착신 라우팅 모드. */
+    routingType?: RoutingType;
+    /** routingType='agent' 일 때 필수. 같은 계정의 에이전트 id. */
+    agentId?: string | null;
+    /** routingType='callflow' 일 때 필수. 같은 계정의 콜 플로우 id. */
+    callFlowId?: string | null;
+    /** routingType='forward' 일 때 필수. 같은 계정이 보유한 번호. */
+    forwardTo?: string | null;
+    /** routingType='sip' 일 때 필수. SipEndpoint id. */
     sipEndpointId?: string | null;
-    /** routingType='softphone' 일 때 착신할 등록 SIP credential(단말) id. */
+    /** routingType='softphone' 일 때 필수. 등록 단말의 SIP credential id. */
     sipCredentialId?: string | null;
+    /** 수신 전화 처리용 Webhook URL. */
+    webhookUrl?: string;
+    /** Webhook 호출 HTTP 메서드. */
+    webhookMethod?: 'POST' | 'GET';
+    /** Webhook 호출 시 덧붙일 헤더. */
+    webhookHeaders?: Record<string, string> | null;
+    /** routingType='agent' 에서 통화별 컨텍스트를 조회할 endpoint. */
+    callContextUrl?: string | null;
+    /** 수신(inbound) 통화 상태 통지 URL. */
+    statusCallback?: string | null;
+    /** 구독할 상태 이벤트(공백 구분). */
+    statusCallbackEvents?: string | null;
+    /** 이 번호의 통화 전사에 적용할 받아쓰기 사전 id. */
+    dictionaryId?: string | null;
 }
 
+interface RequestOptions {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+}
 declare class Numbers extends APIResource {
-    create(params?: {
-        webhookUrl?: string;
-    }, options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<PhoneNumber>;
-    list(options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<NumberListItem[]>;
-    update(number: string, params?: NumberUpdateParams, options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<NumberUpdateResponse>;
+    /**
+     * 번호를 발급합니다. 번호 풀에서 자동으로 배정되며 어떤 번호가 나올지는 지정할 수 없습니다.
+     *
+     * 발급 직후 번호는 `routingType: "webhook"` 이고 `webhookUrl` 이 비어 있어, 그대로 두면
+     * 걸려온 전화가 거절됩니다. 이어서 `update()` 로 착신 라우팅을 지정하세요.
+     */
+    create(params?: NumberCreateParams, options?: RequestOptions): Promise<PhoneNumber>;
+    /**
+     * 등록된 번호 목록을 조회합니다. 페이지네이션과 필터가 없으며 보유한 번호가 한 번에 전부
+     * 반환됩니다.
+     */
+    list(options?: RequestOptions): Promise<NumberListItem[]>;
+    /**
+     * 번호 설정을 수정합니다. 착신 라우팅(webhook/agent/callflow/forward/sip/softphone)과
+     * webhook, 상태 통지, 받아쓰기 사전을 변경할 수 있습니다. 보낸 필드만 반영되고 생략한
+     * 필드는 유지됩니다.
+     *
+     * 라우팅을 바꾸면 다른 라우팅 필드는 서버에서 자동으로 비워집니다. `agent` 에서
+     * `webhook` 으로 되돌리면 `agentId` 가 null 이 되므로, 다시 `agent` 로 돌아갈 때
+     * `agentId` 를 새로 지정해야 합니다.
+     */
+    update(number: string, params?: NumberUpdateParams, options?: RequestOptions): Promise<NumberUpdateResponse>;
+    /**
+     * 번호를 반납합니다. 번호는 풀로 복귀하며 되돌릴 수 없습니다. 같은 번호를 다시
+     * 발급받는다는 보장이 없습니다.
+     */
     delete(number: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -1337,4 +1460,4 @@ declare const PaginationMetaSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 type PaginationMeta = z.infer<typeof PaginationMetaSchema>;
 
-export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, type AssignmentLink, type AssignmentLinkAssignment, type AssignmentLinkCreateResponse, type AssignmentLinkStatus, AssignmentLinks, AuthenticationError, BadRequestError, type BlockedChannel, type BlockedRecipient, type BlockedRecipientSource, type BlockedRecipientStatus, BlockedRecipients, type Call, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, type RecordingDownload, Recordings, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };
+export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, type AssignmentLink, type AssignmentLinkAssignment, type AssignmentLinkCreateResponse, type AssignmentLinkStatus, AssignmentLinks, AuthenticationError, BadRequestError, type BlockedChannel, type BlockedRecipient, type BlockedRecipientSource, type BlockedRecipientStatus, BlockedRecipients, type Call, type CallContextParam, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, type RecordingDownload, Recordings, type RoutingType, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };

package/dist/index.d.ts

@@ -230,7 +230,7 @@ type AssignmentLink = z.infer<typeof AssignmentLinkSchema>;
 type AssignmentLinkCreateResponse = z.infer<typeof AssignmentLinkCreateResponseSchema>;
 type AssignmentLinkStatus = AssignmentLink['status'];
 
-type RequestOptions$1 = {
+type RequestOptions$2 = {
     extraHeaders?: Record<string, string>;
     extraQuery?: Record<string, unknown>;
     timeout?: number;
@@ -246,13 +246,13 @@ declare class AssignmentLinks extends APIResource {
         webhookUrl?: string;
         webhookMethod?: 'POST' | 'GET';
         note?: string;
-    }, options?: RequestOptions$1): Promise<AssignmentLinkCreateResponse>;
+    }, options?: RequestOptions$2): Promise<AssignmentLinkCreateResponse>;
     list(params?: {
         status?: AssignmentLinkStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions$1): Promise<Page<AssignmentLink>>;
-    retrieve(linkId: string, options?: RequestOptions$1): Promise<AssignmentLink>;
+    }, options?: RequestOptions$2): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions$2): Promise<AssignmentLink>;
     revoke(linkId: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -316,7 +316,7 @@ type BlockedChannel = BlockedRecipient['channel'];
 type BlockedRecipientStatus = 'active' | 'released' | 'all';
 type BlockedRecipientSource = 'api' | 'console' | 'import';
 
-type RequestOptions = {
+type RequestOptions$1 = {
     extraHeaders?: Record<string, string>;
     extraQuery?: Record<string, unknown>;
     timeout?: number;
@@ -345,7 +345,7 @@ declare class BlockedRecipients extends APIResource {
         source?: BlockedRecipientSource;
         sourceRef?: string;
         note?: string;
-    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
     /**
      * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
      * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
@@ -356,9 +356,9 @@ declare class BlockedRecipients extends APIResource {
         status?: BlockedRecipientStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions): Promise<Page<BlockedRecipient>>;
+    }, options?: RequestOptions$1): Promise<Page<BlockedRecipient>>;
     /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
-    retrieve(blockId: string, options?: RequestOptions): Promise<BlockedRecipient>;
+    retrieve(blockId: string, options?: RequestOptions$1): Promise<BlockedRecipient>;
     /**
      * 메모를 수정합니다.
      *
@@ -367,7 +367,7 @@ declare class BlockedRecipients extends APIResource {
      */
     update(blockId: string, params?: {
         note?: string | null;
-    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
     /**
      * 수신거부를 해제해 다시 발신할 수 있게 합니다.
      *
@@ -379,7 +379,7 @@ declare class BlockedRecipients extends APIResource {
      */
     release(blockId: string, params?: {
         note?: string;
-    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
 }
 
 declare const CallSchema: z.ZodObject<{
@@ -534,11 +534,48 @@ declare const CallControlResponseSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 type CallControlResponse = z.infer<typeof CallControlResponseSchema>;
 
+/**
+ * `agentId` 에이전트의 **이번 통화에만** 적용되는 컨텍스트.
+ *
+ * 에이전트 자체의 설정은 그대로 두고 이 통화만 다르게 행동시킬 때 사용한다.
+ * 같은 에이전트로 동시에 거는 다른 통화에는 영향이 없다.
+ */
+interface CallContextParam {
+    /** 이번 통화에서 수행할 실행 요구사항 (최대 4000자). */
+    instruction: string;
+    /** 요구사항에서 참조할 통화별 구조화 데이터 (최대 50개). */
+    variables?: Record<string, string | number | boolean>;
+}
+/**
+ * 발신 전화 생성 요청 파라미터.
+ *
+ * **4가지 모드** — `url`, `agentId`, `callFlowId` 는 서로 배타적이다.
+ *
+ * - **VoiceML 모드**: `url` 을 지정하면 VoiceML 로 통화를 제어한다.
+ * - **매니지드 에이전트 모드**: `agentId` 를 지정하면 콘솔에서 만든 AI 에이전트가
+ *   통화를 처리한다. `callContext` 로 이번 통화만의 지시를 덧붙일 수 있다.
+ * - **콜 플로우 모드**: `callFlowId` 를 지정하면 결정적 ARS 플로우가 진행한다.
+ *   `variables` 로 시작 변수를 넘긴다.
+ * - **Agent SDK 모드**: 셋 다 생략하면 From 번호에 연결된 Agent SDK 로 연결된다.
+ */
 interface CallCreateParams {
     to: string;
     from: string;
-    /** VoiceML 명령을 반환할 URL. */
+    /** VoiceML 명령을 반환할 URL. `agentId`·`callFlowId` 와 배타. */
     url?: string;
+    /** 콘솔에서 만든 매니지드 에이전트 ID. `url`·`callFlowId` 와 배타. */
+    agentId?: string;
+    /** `agentId` 에이전트의 이번 통화에만 적용되는 컨텍스트. */
+    callContext?: CallContextParam;
+    /** 콜 플로우(결정적 ARS) ID. `url`·`agentId` 와 배타. */
+    callFlowId?: string;
+    /**
+     * 콜 플로우 시작 변수. 멘트·URL·본문의 `{{이름}}` 이 이 값으로 치환된다.
+     * `callFlowId` 와 함께일 때만 쓸 수 있다(단독 지정 시 400).
+     * `caller`·`callee`·`recording_url`·`recording_duration`·`http_status` 는
+     * 통화 중 자동으로 채워지는 예약 변수라 지정할 수 없다.
+     */
+    variables?: Record<string, string | number | boolean>;
     statusCallback?: string;
     statusCallbackEvent?: string;
     /** 발신 타임아웃 (초). 기본값: 60. */
@@ -838,70 +875,156 @@ declare class Messages extends APIResource {
     }): Promise<Message>;
 }
 
+/**
+ * 착신 라우팅 모드.
+ *
+ * - `webhook`   : webhookUrl 의 VoiceML 이 처리.
+ * - `agent`     : agentId 의 매니지드 에이전트가 착신.
+ * - `callflow`  : callFlowId 의 콜 플로우(ARS)가 착신.
+ * - `forward`   : forwardTo(같은 계정 보유 번호)로 내부 착신전환.
+ * - `sip`       : sipEndpointId 의 라우트로 외부 PBX 다이얼.
+ * - `softphone` : sipCredentialId 의 등록 단말로 착신.
+ */
+declare const ROUTING_TYPES: readonly ["webhook", "sip", "softphone", "forward", "agent", "callflow"];
+type RoutingType = (typeof ROUTING_TYPES)[number];
 declare const PhoneNumberSchema: z.ZodObject<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;
-type PhoneNumber = z.infer<typeof PhoneNumberSchema>;
+/**
+ * 전화번호. `routingType` 은 알려진 값에 자동완성이 뜨지만, 서버가 새 라우팅을 추가해도
+ * 파싱이 깨지지 않도록 임의의 문자열을 허용한다.
+ */
+type PhoneNumber = Omit<z.infer<typeof PhoneNumberSchema>, 'routingType'> & {
+    routingType?: RoutingType | (string & {}) | null;
+};
 type NumberListItem = PhoneNumber;
 type NumberUpdateResponse = PhoneNumber;
 
 interface NumberCreateParams {
+    /** 수신 전화 처리용 Webhook URL. */
     webhookUrl?: string;
+    /** Webhook 호출 HTTP 메서드. */
+    webhookMethod?: 'POST' | 'GET';
+    /** Webhook 호출 시 덧붙일 헤더. 키는 'X-' 로 시작해야 한다. */
+    webhookHeaders?: Record<string, string>;
+    /** 수신(inbound) 통화 상태 통지 URL. */
+    statusCallback?: string;
+    /** 구독할 상태 이벤트(공백 구분). 미지정 시 'initiated ringing answered completed'. */
+    statusCallbackEvents?: string;
 }
 interface NumberUpdateParams {
-    webhookUrl?: string;
-    webhookMethod?: 'POST' | 'GET';
-    /** inbound 라우팅: webhook | sip | softphone. */
-    routingType?: 'webhook' | 'sip' | 'softphone';
-    /** routingType='sip' 일 때 라우팅할 SipEndpoint id. */
+    /** 착신 라우팅 모드. */
+    routingType?: RoutingType;
+    /** routingType='agent' 일 때 필수. 같은 계정의 에이전트 id. */
+    agentId?: string | null;
+    /** routingType='callflow' 일 때 필수. 같은 계정의 콜 플로우 id. */
+    callFlowId?: string | null;
+    /** routingType='forward' 일 때 필수. 같은 계정이 보유한 번호. */
+    forwardTo?: string | null;
+    /** routingType='sip' 일 때 필수. SipEndpoint id. */
     sipEndpointId?: string | null;
-    /** routingType='softphone' 일 때 착신할 등록 SIP credential(단말) id. */
+    /** routingType='softphone' 일 때 필수. 등록 단말의 SIP credential id. */
     sipCredentialId?: string | null;
+    /** 수신 전화 처리용 Webhook URL. */
+    webhookUrl?: string;
+    /** Webhook 호출 HTTP 메서드. */
+    webhookMethod?: 'POST' | 'GET';
+    /** Webhook 호출 시 덧붙일 헤더. */
+    webhookHeaders?: Record<string, string> | null;
+    /** routingType='agent' 에서 통화별 컨텍스트를 조회할 endpoint. */
+    callContextUrl?: string | null;
+    /** 수신(inbound) 통화 상태 통지 URL. */
+    statusCallback?: string | null;
+    /** 구독할 상태 이벤트(공백 구분). */
+    statusCallbackEvents?: string | null;
+    /** 이 번호의 통화 전사에 적용할 받아쓰기 사전 id. */
+    dictionaryId?: string | null;
 }
 
+interface RequestOptions {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+}
 declare class Numbers extends APIResource {
-    create(params?: {
-        webhookUrl?: string;
-    }, options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<PhoneNumber>;
-    list(options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<NumberListItem[]>;
-    update(number: string, params?: NumberUpdateParams, options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<NumberUpdateResponse>;
+    /**
+     * 번호를 발급합니다. 번호 풀에서 자동으로 배정되며 어떤 번호가 나올지는 지정할 수 없습니다.
+     *
+     * 발급 직후 번호는 `routingType: "webhook"` 이고 `webhookUrl` 이 비어 있어, 그대로 두면
+     * 걸려온 전화가 거절됩니다. 이어서 `update()` 로 착신 라우팅을 지정하세요.
+     */
+    create(params?: NumberCreateParams, options?: RequestOptions): Promise<PhoneNumber>;
+    /**
+     * 등록된 번호 목록을 조회합니다. 페이지네이션과 필터가 없으며 보유한 번호가 한 번에 전부
+     * 반환됩니다.
+     */
+    list(options?: RequestOptions): Promise<NumberListItem[]>;
+    /**
+     * 번호 설정을 수정합니다. 착신 라우팅(webhook/agent/callflow/forward/sip/softphone)과
+     * webhook, 상태 통지, 받아쓰기 사전을 변경할 수 있습니다. 보낸 필드만 반영되고 생략한
+     * 필드는 유지됩니다.
+     *
+     * 라우팅을 바꾸면 다른 라우팅 필드는 서버에서 자동으로 비워집니다. `agent` 에서
+     * `webhook` 으로 되돌리면 `agentId` 가 null 이 되므로, 다시 `agent` 로 돌아갈 때
+     * `agentId` 를 새로 지정해야 합니다.
+     */
+    update(number: string, params?: NumberUpdateParams, options?: RequestOptions): Promise<NumberUpdateResponse>;
+    /**
+     * 번호를 반납합니다. 번호는 풀로 복귀하며 되돌릴 수 없습니다. 같은 번호를 다시
+     * 발급받는다는 보장이 없습니다.
+     */
     delete(number: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -1337,4 +1460,4 @@ declare const PaginationMetaSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 type PaginationMeta = z.infer<typeof PaginationMetaSchema>;
 
-export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, type AssignmentLink, type AssignmentLinkAssignment, type AssignmentLinkCreateResponse, type AssignmentLinkStatus, AssignmentLinks, AuthenticationError, BadRequestError, type BlockedChannel, type BlockedRecipient, type BlockedRecipientSource, type BlockedRecipientStatus, BlockedRecipients, type Call, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, type RecordingDownload, Recordings, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };
+export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, type AssignmentLink, type AssignmentLinkAssignment, type AssignmentLinkCreateResponse, type AssignmentLinkStatus, AssignmentLinks, AuthenticationError, BadRequestError, type BlockedChannel, type BlockedRecipient, type BlockedRecipientSource, type BlockedRecipientStatus, BlockedRecipients, type Call, type CallContextParam, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, type RecordingDownload, Recordings, type RoutingType, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };