@teamlearners/clawops 0.26.0 → 0.28.0

package/dist/index.d.cts

@@ -56,12 +56,30 @@ declare class APIClient {
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<T>;
+    _patch<T>(path: string, options: {
+        body?: Record<string, unknown> | null;
+        castTo: z.ZodType<T>;
+        extraHeaders?: Record<string, string>;
+        extraQuery?: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
     _getRaw(path: string, options?: {
         query?: Record<string, unknown> | null;
         extraHeaders?: Record<string, string>;
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<Response>;
+    /**
+     * 본문을 돌려주는 DELETE. 기존 `_delete` 는 void 라 응답을 버리는데, soft delete 처럼
+     * 삭제 결과 리소스를 그대로 반환하는 endpoint 가 있어서 따로 둔다.
+     */
+    _deleteWithResponse<T>(path: string, options: {
+        body?: Record<string, unknown> | null;
+        castTo: z.ZodType<T>;
+        extraHeaders?: Record<string, string>;
+        extraQuery?: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
     _delete(path: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -212,7 +230,7 @@ type AssignmentLink = z.infer<typeof AssignmentLinkSchema>;
 type AssignmentLinkCreateResponse = z.infer<typeof AssignmentLinkCreateResponseSchema>;
 type AssignmentLinkStatus = AssignmentLink['status'];
 
-type RequestOptions = {
+type RequestOptions$1 = {
     extraHeaders?: Record<string, string>;
     extraQuery?: Record<string, unknown>;
     timeout?: number;
@@ -228,19 +246,142 @@ declare class AssignmentLinks extends APIResource {
         webhookUrl?: string;
         webhookMethod?: 'POST' | 'GET';
         note?: string;
-    }, options?: RequestOptions): Promise<AssignmentLinkCreateResponse>;
+    }, options?: RequestOptions$1): Promise<AssignmentLinkCreateResponse>;
     list(params?: {
         status?: AssignmentLinkStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions): Promise<Page<AssignmentLink>>;
-    retrieve(linkId: string, options?: RequestOptions): Promise<AssignmentLink>;
+    }, options?: RequestOptions$1): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions$1): Promise<AssignmentLink>;
     revoke(linkId: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
     }): Promise<void>;
 }
 
+declare const BlockedRecipientSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+type BlockedRecipient = z.infer<typeof BlockedRecipientSchema>;
+type BlockedChannel = BlockedRecipient['channel'];
+type BlockedRecipientStatus = 'active' | 'released' | 'all';
+type BlockedRecipientSource = 'api' | 'console' | 'import';
+
+type RequestOptions = {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+};
+/**
+ * 수신거부(DNC) 명단 리소스.
+ *
+ * 등록된 번호는 이 계정의 **발신**(전화·문자)에서 제외됩니다. 착신은 막지 않습니다 —
+ * 그 번호에서 걸려오는 전화는 그대로 받습니다.
+ *
+ * 전화와 문자는 각각 따로 차단합니다. 같은 번호라도 채널마다 별개 항목이므로,
+ * 둘 다 막으려면 `channel` 을 바꿔 두 번 등록합니다.
+ */
+declare class BlockedRecipients extends APIResource {
+    /**
+     * 번호를 수신거부 명단에 등록합니다.
+     *
+     * 하이픈·`+82` 표기 모두 허용되며 국내 표기로 정규화되어 저장됩니다.
+     *
+     * **멱등입니다** — 이미 차단 중인 (번호, 채널)을 다시 등록해도 에러가 아니라 기존 항목을
+     * 돌려줍니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다.
+     */
+    create(params: {
+        number: string;
+        channel: BlockedChannel;
+        source?: BlockedRecipientSource;
+        sourceRef?: string;
+        note?: string;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
+     * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
+     */
+    list(params?: {
+        channel?: BlockedChannel;
+        number?: string;
+        status?: BlockedRecipientStatus;
+        page?: number;
+        pageSize?: number;
+    }, options?: RequestOptions): Promise<Page<BlockedRecipient>>;
+    /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
+    retrieve(blockId: string, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 메모를 수정합니다.
+     *
+     * 번호와 채널은 바꿀 수 없습니다 — 바꾸면 "누가 무엇을 언제 거부했는가"라는 증빙이
+     * 뒤틀립니다. 잘못 등록했다면 해제한 뒤 올바른 번호로 새로 등록하세요.
+     */
+    update(blockId: string, params?: {
+        note?: string | null;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 수신거부를 해제해 다시 발신할 수 있게 합니다.
+     *
+     * **항목은 삭제되지 않습니다.** `active` 가 false 가 되고 `unblockedAt` 이 기록될 뿐,
+     * 행은 이력으로 남습니다 — 언제 거부했고 언제 풀렸는지가 곧 증빙이기 때문입니다.
+     * 해제분은 `list({ status: 'released' })` 로 볼 수 있습니다.
+     *
+     * 이미 해제된 항목에 다시 호출해도 성공하며, 최초 해제 시각은 덮어쓰지 않습니다.
+     */
+    release(blockId: string, params?: {
+        note?: string;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+}
+
 declare const CallSchema: z.ZodObject<{
     callId: z.ZodString;
     /**
@@ -257,6 +398,33 @@ declare const CallSchema: z.ZodObject<{
     recordingUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** AMD(machineDetection) 결과 — AMD 켠 발신 통화에만 값 존재. */
     answeredBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["human", "machine", "unknown"]>>>;
+    /**
+     * 통화 종료 사유. status 가 왜 그렇게 끝났는지를 구분한다 — 특히 failed 는 결번·망 오류·
+     * 시스템 오류를 모두 포함하는 대분류라, 발신 리스트를 정제하려면 status 가 아니라 이 값을 본다.
+     *
+     * 재시도해도 소용없음: invalid_number(결번) / number_changed / incompatible_destination.
+     * 재시도 가치 있음: no_answer / user_busy / temporary_failure / switching_congestion /
+     * no_circuit_available / network_out_of_order / destination_out_of_order /
+     * recovery_on_timer_expire / resource_unavailable.
+     * 그 외: normal_clearing(정상 종료) / caller_canceled / call_rejected / protocol_error /
+     * unspecified / app_error·call_stuck(ClawOps 측 오류 — 재시도 권장) / unknown.
+     *
+     * enum 으로 좁히지 않는다 — 통신망이 새 cause 를 보내면 서버가 값을 넓히는데, 그때마다
+     * SDK 릴리즈를 기다려야 파싱되는 구조는 안 된다.
+     */
+    hangupCause: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 통신망 Q.850 cause code. 1·5·28=결번, 16=정상해제, 17=통화중, 19=무응답, 38=망장애. */
+    hangupCauseQ850: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료를 유발한 SIP 응답코드(404=없는 번호, 486=통화중, 500=망 오류 등).
+     * 국내 통신망은 실제 사유를 500 으로 감싸 보내기도 하므로 hangupCause 가 더 정확하다.
+     */
+    sipResponseCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료 책임 주체. carrier(통신망) / callee(수신자) / caller(발신자) /
+     * app·system(ClawOps 측 오류 — 수신자 번호를 정제 대상에 넣지 말고 재시도할 것).
+     */
+    hangupSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<["carrier", "callee", "caller", "app", "system"]>>>;
     accountId: z.ZodString;
     dateCreated: z.ZodString;
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -276,6 +444,33 @@ declare const CallSchema: z.ZodObject<{
     recordingUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** AMD(machineDetection) 결과 — AMD 켠 발신 통화에만 값 존재. */
     answeredBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["human", "machine", "unknown"]>>>;
+    /**
+     * 통화 종료 사유. status 가 왜 그렇게 끝났는지를 구분한다 — 특히 failed 는 결번·망 오류·
+     * 시스템 오류를 모두 포함하는 대분류라, 발신 리스트를 정제하려면 status 가 아니라 이 값을 본다.
+     *
+     * 재시도해도 소용없음: invalid_number(결번) / number_changed / incompatible_destination.
+     * 재시도 가치 있음: no_answer / user_busy / temporary_failure / switching_congestion /
+     * no_circuit_available / network_out_of_order / destination_out_of_order /
+     * recovery_on_timer_expire / resource_unavailable.
+     * 그 외: normal_clearing(정상 종료) / caller_canceled / call_rejected / protocol_error /
+     * unspecified / app_error·call_stuck(ClawOps 측 오류 — 재시도 권장) / unknown.
+     *
+     * enum 으로 좁히지 않는다 — 통신망이 새 cause 를 보내면 서버가 값을 넓히는데, 그때마다
+     * SDK 릴리즈를 기다려야 파싱되는 구조는 안 된다.
+     */
+    hangupCause: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 통신망 Q.850 cause code. 1·5·28=결번, 16=정상해제, 17=통화중, 19=무응답, 38=망장애. */
+    hangupCauseQ850: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료를 유발한 SIP 응답코드(404=없는 번호, 486=통화중, 500=망 오류 등).
+     * 국내 통신망은 실제 사유를 500 으로 감싸 보내기도 하므로 hangupCause 가 더 정확하다.
+     */
+    sipResponseCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료 책임 주체. carrier(통신망) / callee(수신자) / caller(발신자) /
+     * app·system(ClawOps 측 오류 — 수신자 번호를 정제 대상에 넣지 말고 재시도할 것).
+     */
+    hangupSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<["carrier", "callee", "caller", "app", "system"]>>>;
     accountId: z.ZodString;
     dateCreated: z.ZodString;
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -295,6 +490,33 @@ declare const CallSchema: z.ZodObject<{
     recordingUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** AMD(machineDetection) 결과 — AMD 켠 발신 통화에만 값 존재. */
     answeredBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["human", "machine", "unknown"]>>>;
+    /**
+     * 통화 종료 사유. status 가 왜 그렇게 끝났는지를 구분한다 — 특히 failed 는 결번·망 오류·
+     * 시스템 오류를 모두 포함하는 대분류라, 발신 리스트를 정제하려면 status 가 아니라 이 값을 본다.
+     *
+     * 재시도해도 소용없음: invalid_number(결번) / number_changed / incompatible_destination.
+     * 재시도 가치 있음: no_answer / user_busy / temporary_failure / switching_congestion /
+     * no_circuit_available / network_out_of_order / destination_out_of_order /
+     * recovery_on_timer_expire / resource_unavailable.
+     * 그 외: normal_clearing(정상 종료) / caller_canceled / call_rejected / protocol_error /
+     * unspecified / app_error·call_stuck(ClawOps 측 오류 — 재시도 권장) / unknown.
+     *
+     * enum 으로 좁히지 않는다 — 통신망이 새 cause 를 보내면 서버가 값을 넓히는데, 그때마다
+     * SDK 릴리즈를 기다려야 파싱되는 구조는 안 된다.
+     */
+    hangupCause: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 통신망 Q.850 cause code. 1·5·28=결번, 16=정상해제, 17=통화중, 19=무응답, 38=망장애. */
+    hangupCauseQ850: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료를 유발한 SIP 응답코드(404=없는 번호, 486=통화중, 500=망 오류 등).
+     * 국내 통신망은 실제 사유를 500 으로 감싸 보내기도 하므로 hangupCause 가 더 정확하다.
+     */
+    sipResponseCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료 책임 주체. carrier(통신망) / callee(수신자) / caller(발신자) /
+     * app·system(ClawOps 측 오류 — 수신자 번호를 정제 대상에 넣지 말고 재시도할 것).
+     */
+    hangupSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<["carrier", "callee", "caller", "app", "system"]>>>;
     accountId: z.ZodString;
     dateCreated: z.ZodString;
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -908,6 +1130,7 @@ declare class AccountContext {
     get recordings(): Recordings;
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
+    get blockedRecipients(): BlockedRecipients;
 }
 
 declare class ClawOpsError extends Error {
@@ -1092,6 +1315,7 @@ declare class ClawOps extends APIClient {
     get recordings(): Recordings;
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
+    get blockedRecipients(): BlockedRecipients;
     get webhooks(): Webhooks;
     accounts(accountId: string): AccountContext;
 }
@@ -1113,4 +1337,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 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, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };

package/dist/index.d.ts

@@ -56,12 +56,30 @@ declare class APIClient {
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<T>;
+    _patch<T>(path: string, options: {
+        body?: Record<string, unknown> | null;
+        castTo: z.ZodType<T>;
+        extraHeaders?: Record<string, string>;
+        extraQuery?: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
     _getRaw(path: string, options?: {
         query?: Record<string, unknown> | null;
         extraHeaders?: Record<string, string>;
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<Response>;
+    /**
+     * 본문을 돌려주는 DELETE. 기존 `_delete` 는 void 라 응답을 버리는데, soft delete 처럼
+     * 삭제 결과 리소스를 그대로 반환하는 endpoint 가 있어서 따로 둔다.
+     */
+    _deleteWithResponse<T>(path: string, options: {
+        body?: Record<string, unknown> | null;
+        castTo: z.ZodType<T>;
+        extraHeaders?: Record<string, string>;
+        extraQuery?: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
     _delete(path: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -212,7 +230,7 @@ type AssignmentLink = z.infer<typeof AssignmentLinkSchema>;
 type AssignmentLinkCreateResponse = z.infer<typeof AssignmentLinkCreateResponseSchema>;
 type AssignmentLinkStatus = AssignmentLink['status'];
 
-type RequestOptions = {
+type RequestOptions$1 = {
     extraHeaders?: Record<string, string>;
     extraQuery?: Record<string, unknown>;
     timeout?: number;
@@ -228,19 +246,142 @@ declare class AssignmentLinks extends APIResource {
         webhookUrl?: string;
         webhookMethod?: 'POST' | 'GET';
         note?: string;
-    }, options?: RequestOptions): Promise<AssignmentLinkCreateResponse>;
+    }, options?: RequestOptions$1): Promise<AssignmentLinkCreateResponse>;
     list(params?: {
         status?: AssignmentLinkStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions): Promise<Page<AssignmentLink>>;
-    retrieve(linkId: string, options?: RequestOptions): Promise<AssignmentLink>;
+    }, options?: RequestOptions$1): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions$1): Promise<AssignmentLink>;
     revoke(linkId: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
     }): Promise<void>;
 }
 
+declare const BlockedRecipientSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+type BlockedRecipient = z.infer<typeof BlockedRecipientSchema>;
+type BlockedChannel = BlockedRecipient['channel'];
+type BlockedRecipientStatus = 'active' | 'released' | 'all';
+type BlockedRecipientSource = 'api' | 'console' | 'import';
+
+type RequestOptions = {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+};
+/**
+ * 수신거부(DNC) 명단 리소스.
+ *
+ * 등록된 번호는 이 계정의 **발신**(전화·문자)에서 제외됩니다. 착신은 막지 않습니다 —
+ * 그 번호에서 걸려오는 전화는 그대로 받습니다.
+ *
+ * 전화와 문자는 각각 따로 차단합니다. 같은 번호라도 채널마다 별개 항목이므로,
+ * 둘 다 막으려면 `channel` 을 바꿔 두 번 등록합니다.
+ */
+declare class BlockedRecipients extends APIResource {
+    /**
+     * 번호를 수신거부 명단에 등록합니다.
+     *
+     * 하이픈·`+82` 표기 모두 허용되며 국내 표기로 정규화되어 저장됩니다.
+     *
+     * **멱등입니다** — 이미 차단 중인 (번호, 채널)을 다시 등록해도 에러가 아니라 기존 항목을
+     * 돌려줍니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다.
+     */
+    create(params: {
+        number: string;
+        channel: BlockedChannel;
+        source?: BlockedRecipientSource;
+        sourceRef?: string;
+        note?: string;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
+     * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
+     */
+    list(params?: {
+        channel?: BlockedChannel;
+        number?: string;
+        status?: BlockedRecipientStatus;
+        page?: number;
+        pageSize?: number;
+    }, options?: RequestOptions): Promise<Page<BlockedRecipient>>;
+    /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
+    retrieve(blockId: string, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 메모를 수정합니다.
+     *
+     * 번호와 채널은 바꿀 수 없습니다 — 바꾸면 "누가 무엇을 언제 거부했는가"라는 증빙이
+     * 뒤틀립니다. 잘못 등록했다면 해제한 뒤 올바른 번호로 새로 등록하세요.
+     */
+    update(blockId: string, params?: {
+        note?: string | null;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 수신거부를 해제해 다시 발신할 수 있게 합니다.
+     *
+     * **항목은 삭제되지 않습니다.** `active` 가 false 가 되고 `unblockedAt` 이 기록될 뿐,
+     * 행은 이력으로 남습니다 — 언제 거부했고 언제 풀렸는지가 곧 증빙이기 때문입니다.
+     * 해제분은 `list({ status: 'released' })` 로 볼 수 있습니다.
+     *
+     * 이미 해제된 항목에 다시 호출해도 성공하며, 최초 해제 시각은 덮어쓰지 않습니다.
+     */
+    release(blockId: string, params?: {
+        note?: string;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+}
+
 declare const CallSchema: z.ZodObject<{
     callId: z.ZodString;
     /**
@@ -257,6 +398,33 @@ declare const CallSchema: z.ZodObject<{
     recordingUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** AMD(machineDetection) 결과 — AMD 켠 발신 통화에만 값 존재. */
     answeredBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["human", "machine", "unknown"]>>>;
+    /**
+     * 통화 종료 사유. status 가 왜 그렇게 끝났는지를 구분한다 — 특히 failed 는 결번·망 오류·
+     * 시스템 오류를 모두 포함하는 대분류라, 발신 리스트를 정제하려면 status 가 아니라 이 값을 본다.
+     *
+     * 재시도해도 소용없음: invalid_number(결번) / number_changed / incompatible_destination.
+     * 재시도 가치 있음: no_answer / user_busy / temporary_failure / switching_congestion /
+     * no_circuit_available / network_out_of_order / destination_out_of_order /
+     * recovery_on_timer_expire / resource_unavailable.
+     * 그 외: normal_clearing(정상 종료) / caller_canceled / call_rejected / protocol_error /
+     * unspecified / app_error·call_stuck(ClawOps 측 오류 — 재시도 권장) / unknown.
+     *
+     * enum 으로 좁히지 않는다 — 통신망이 새 cause 를 보내면 서버가 값을 넓히는데, 그때마다
+     * SDK 릴리즈를 기다려야 파싱되는 구조는 안 된다.
+     */
+    hangupCause: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 통신망 Q.850 cause code. 1·5·28=결번, 16=정상해제, 17=통화중, 19=무응답, 38=망장애. */
+    hangupCauseQ850: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료를 유발한 SIP 응답코드(404=없는 번호, 486=통화중, 500=망 오류 등).
+     * 국내 통신망은 실제 사유를 500 으로 감싸 보내기도 하므로 hangupCause 가 더 정확하다.
+     */
+    sipResponseCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료 책임 주체. carrier(통신망) / callee(수신자) / caller(발신자) /
+     * app·system(ClawOps 측 오류 — 수신자 번호를 정제 대상에 넣지 말고 재시도할 것).
+     */
+    hangupSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<["carrier", "callee", "caller", "app", "system"]>>>;
     accountId: z.ZodString;
     dateCreated: z.ZodString;
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -276,6 +444,33 @@ declare const CallSchema: z.ZodObject<{
     recordingUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** AMD(machineDetection) 결과 — AMD 켠 발신 통화에만 값 존재. */
     answeredBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["human", "machine", "unknown"]>>>;
+    /**
+     * 통화 종료 사유. status 가 왜 그렇게 끝났는지를 구분한다 — 특히 failed 는 결번·망 오류·
+     * 시스템 오류를 모두 포함하는 대분류라, 발신 리스트를 정제하려면 status 가 아니라 이 값을 본다.
+     *
+     * 재시도해도 소용없음: invalid_number(결번) / number_changed / incompatible_destination.
+     * 재시도 가치 있음: no_answer / user_busy / temporary_failure / switching_congestion /
+     * no_circuit_available / network_out_of_order / destination_out_of_order /
+     * recovery_on_timer_expire / resource_unavailable.
+     * 그 외: normal_clearing(정상 종료) / caller_canceled / call_rejected / protocol_error /
+     * unspecified / app_error·call_stuck(ClawOps 측 오류 — 재시도 권장) / unknown.
+     *
+     * enum 으로 좁히지 않는다 — 통신망이 새 cause 를 보내면 서버가 값을 넓히는데, 그때마다
+     * SDK 릴리즈를 기다려야 파싱되는 구조는 안 된다.
+     */
+    hangupCause: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 통신망 Q.850 cause code. 1·5·28=결번, 16=정상해제, 17=통화중, 19=무응답, 38=망장애. */
+    hangupCauseQ850: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료를 유발한 SIP 응답코드(404=없는 번호, 486=통화중, 500=망 오류 등).
+     * 국내 통신망은 실제 사유를 500 으로 감싸 보내기도 하므로 hangupCause 가 더 정확하다.
+     */
+    sipResponseCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료 책임 주체. carrier(통신망) / callee(수신자) / caller(발신자) /
+     * app·system(ClawOps 측 오류 — 수신자 번호를 정제 대상에 넣지 말고 재시도할 것).
+     */
+    hangupSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<["carrier", "callee", "caller", "app", "system"]>>>;
     accountId: z.ZodString;
     dateCreated: z.ZodString;
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -295,6 +490,33 @@ declare const CallSchema: z.ZodObject<{
     recordingUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** AMD(machineDetection) 결과 — AMD 켠 발신 통화에만 값 존재. */
     answeredBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["human", "machine", "unknown"]>>>;
+    /**
+     * 통화 종료 사유. status 가 왜 그렇게 끝났는지를 구분한다 — 특히 failed 는 결번·망 오류·
+     * 시스템 오류를 모두 포함하는 대분류라, 발신 리스트를 정제하려면 status 가 아니라 이 값을 본다.
+     *
+     * 재시도해도 소용없음: invalid_number(결번) / number_changed / incompatible_destination.
+     * 재시도 가치 있음: no_answer / user_busy / temporary_failure / switching_congestion /
+     * no_circuit_available / network_out_of_order / destination_out_of_order /
+     * recovery_on_timer_expire / resource_unavailable.
+     * 그 외: normal_clearing(정상 종료) / caller_canceled / call_rejected / protocol_error /
+     * unspecified / app_error·call_stuck(ClawOps 측 오류 — 재시도 권장) / unknown.
+     *
+     * enum 으로 좁히지 않는다 — 통신망이 새 cause 를 보내면 서버가 값을 넓히는데, 그때마다
+     * SDK 릴리즈를 기다려야 파싱되는 구조는 안 된다.
+     */
+    hangupCause: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 통신망 Q.850 cause code. 1·5·28=결번, 16=정상해제, 17=통화중, 19=무응답, 38=망장애. */
+    hangupCauseQ850: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료를 유발한 SIP 응답코드(404=없는 번호, 486=통화중, 500=망 오류 등).
+     * 국내 통신망은 실제 사유를 500 으로 감싸 보내기도 하므로 hangupCause 가 더 정확하다.
+     */
+    sipResponseCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /**
+     * 종료 책임 주체. carrier(통신망) / callee(수신자) / caller(발신자) /
+     * app·system(ClawOps 측 오류 — 수신자 번호를 정제 대상에 넣지 말고 재시도할 것).
+     */
+    hangupSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<["carrier", "callee", "caller", "app", "system"]>>>;
     accountId: z.ZodString;
     dateCreated: z.ZodString;
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -908,6 +1130,7 @@ declare class AccountContext {
     get recordings(): Recordings;
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
+    get blockedRecipients(): BlockedRecipients;
 }
 
 declare class ClawOpsError extends Error {
@@ -1092,6 +1315,7 @@ declare class ClawOps extends APIClient {
     get recordings(): Recordings;
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
+    get blockedRecipients(): BlockedRecipients;
     get webhooks(): Webhooks;
     accounts(accountId: string): AccountContext;
 }
@@ -1113,4 +1337,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 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, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };