@teamlearners/clawops 0.28.0 → 0.29.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<{
@@ -838,70 +838,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 +1423,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 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<{
@@ -838,70 +838,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 +1423,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 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 };