@teamlearners/clawops 0.35.0 → 0.36.0

package/dist/{client-CKaAfPlF.d.ts → client-DKsEma11.d.ts}

@@ -230,7 +230,7 @@ type AssignmentLink = z.infer<typeof AssignmentLinkSchema>;
 type AssignmentLinkCreateResponse = z.infer<typeof AssignmentLinkCreateResponseSchema>;
 type AssignmentLinkStatus = AssignmentLink['status'];
 
-type RequestOptions$2 = {
+type RequestOptions$3 = {
     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$2): Promise<AssignmentLinkCreateResponse>;
+    }, options?: RequestOptions$3): Promise<AssignmentLinkCreateResponse>;
     list(params?: {
         status?: AssignmentLinkStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions$2): Promise<Page<AssignmentLink>>;
-    retrieve(linkId: string, options?: RequestOptions$2): Promise<AssignmentLink>;
+    }, options?: RequestOptions$3): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions$3): 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$1 = {
+type RequestOptions$2 = {
     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$1): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$2): Promise<BlockedRecipient>;
     /**
      * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
      * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
@@ -356,9 +356,9 @@ declare class BlockedRecipients extends APIResource {
         status?: BlockedRecipientStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions$1): Promise<Page<BlockedRecipient>>;
+    }, options?: RequestOptions$2): Promise<Page<BlockedRecipient>>;
     /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
-    retrieve(blockId: string, options?: RequestOptions$1): Promise<BlockedRecipient>;
+    retrieve(blockId: string, options?: RequestOptions$2): Promise<BlockedRecipient>;
     /**
      * 메모를 수정합니다.
      *
@@ -367,7 +367,7 @@ declare class BlockedRecipients extends APIResource {
      */
     update(blockId: string, params?: {
         note?: string | null;
-    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$2): Promise<BlockedRecipient>;
     /**
      * 수신거부를 해제해 다시 발신할 수 있게 합니다.
      *
@@ -379,7 +379,7 @@ declare class BlockedRecipients extends APIResource {
      */
     release(blockId: string, params?: {
         note?: string;
-    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
+    }, options?: RequestOptions$2): Promise<BlockedRecipient>;
 }
 
 declare const CallSchema: z.ZodObject<{
@@ -797,10 +797,457 @@ declare class Calls extends APIResource {
     }): Promise<SummaryStatus>;
 }
 
+/**
+ * 채널 연결 상태. 서버가 어휘를 소유하므로 **열린 유니온**이다 — 목록에 없는 값도 그대로
+ * 실리고, 낡는 것은 자동완성뿐이다.
+ */
+type KakaoChannelStatus = 'connected' | 'needs_attention' | (string & {});
+/**
+ * 이 계정에 연결된 카카오 비즈니스 채널.
+ *
+ * ⚠️ `searchId` 는 채널 소유자가 카카오 비즈니스에서 바꿀 수 있다. **연동 키로 쓰지 말 것** —
+ * 키는 `id`(ClawOps 리소스 ID)다.
+ */
+declare const KakaoChannelSchema: z.ZodObject<{
+    /** ClawOps 채널 리소스 ID. 템플릿 조회와 알림톡 발송에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** 카카오 채널 검색용 ID. `@` 없는 형태로 저장된다. */
+    searchId: z.ZodString;
+    name: z.ZodString;
+    categoryCode: z.ZodString;
+    /**
+     * `connected` = 연결 완료. `needs_attention` = 연결 기록은 있으나 카카오 채널 상태를
+     * 확인하지 못한 상태다 — 실제로 끊겼을 수도, 일시적인 조회 실패일 수도 있다.
+     * `channels.retrieve()` 를 다시 부르면 재확인한다.
+     *
+     * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 상태가 하나 늘면
+     * 닫힌 enum 은 조회를 통째로 실패시킨다(알림톡 `'ata'` 가 정확히 그렇게 터졌다).
+     * 열린 유니온이면 자동완성만 낡고 조회는 계속 산다.
+     */
+    status: z.ZodType<KakaoChannelStatus>;
+    /** 담당자 휴대전화번호(마스킹). 원문은 저장하지 않는다. */
+    managerPhoneMasked: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    connectedAt: z.ZodString;
+    /** 카카오 채널 상태를 마지막으로 확인한 시각. null 이면 연결 이후 한 번도 확인하지 않았다. */
+    syncedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** ClawOps 채널 리소스 ID. 템플릿 조회와 알림톡 발송에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** 카카오 채널 검색용 ID. `@` 없는 형태로 저장된다. */
+    searchId: z.ZodString;
+    name: z.ZodString;
+    categoryCode: z.ZodString;
+    /**
+     * `connected` = 연결 완료. `needs_attention` = 연결 기록은 있으나 카카오 채널 상태를
+     * 확인하지 못한 상태다 — 실제로 끊겼을 수도, 일시적인 조회 실패일 수도 있다.
+     * `channels.retrieve()` 를 다시 부르면 재확인한다.
+     *
+     * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 상태가 하나 늘면
+     * 닫힌 enum 은 조회를 통째로 실패시킨다(알림톡 `'ata'` 가 정확히 그렇게 터졌다).
+     * 열린 유니온이면 자동완성만 낡고 조회는 계속 산다.
+     */
+    status: z.ZodType<KakaoChannelStatus>;
+    /** 담당자 휴대전화번호(마스킹). 원문은 저장하지 않는다. */
+    managerPhoneMasked: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    connectedAt: z.ZodString;
+    /** 카카오 채널 상태를 마지막으로 확인한 시각. null 이면 연결 이후 한 번도 확인하지 않았다. */
+    syncedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** ClawOps 채널 리소스 ID. 템플릿 조회와 알림톡 발송에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** 카카오 채널 검색용 ID. `@` 없는 형태로 저장된다. */
+    searchId: z.ZodString;
+    name: z.ZodString;
+    categoryCode: z.ZodString;
+    /**
+     * `connected` = 연결 완료. `needs_attention` = 연결 기록은 있으나 카카오 채널 상태를
+     * 확인하지 못한 상태다 — 실제로 끊겼을 수도, 일시적인 조회 실패일 수도 있다.
+     * `channels.retrieve()` 를 다시 부르면 재확인한다.
+     *
+     * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 상태가 하나 늘면
+     * 닫힌 enum 은 조회를 통째로 실패시킨다(알림톡 `'ata'` 가 정확히 그렇게 터졌다).
+     * 열린 유니온이면 자동완성만 낡고 조회는 계속 산다.
+     */
+    status: z.ZodType<KakaoChannelStatus>;
+    /** 담당자 휴대전화번호(마스킹). 원문은 저장하지 않는다. */
+    managerPhoneMasked: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    connectedAt: z.ZodString;
+    /** 카카오 채널 상태를 마지막으로 확인한 시각. null 이면 연결 이후 한 번도 확인하지 않았다. */
+    syncedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+type KakaoChannel = z.infer<typeof KakaoChannelSchema>;
+/**
+ * 알림톡 템플릿.
+ *
+ * 본문·버튼·아이템 리스트·강조 문구는 **카카오 검수를 받은 그대로** 발송된다. 발송 요청으로
+ * 바꿀 수 있는 것은 `variables` 값뿐이다.
+ */
+declare const KakaoTemplateSchema: z.ZodObject<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `kakao.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `kakao.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    /** 검수를 받은 템플릿 본문. `#{변수}` 자리는 발송 시 치환된다. */
+    content: z.ZodString;
+    /**
+     * 카카오 검수 상태(`APPROVED`·`REJECTED` 등). **카카오 쪽 열린 집합이라 문자열이다.**
+     * 발송 가능 여부 판정은 `sendable` 이 정본이다.
+     */
+    status: z.ZodString;
+    /** 휴면 템플릿. `true` 면 승인 상태여도 발송할 수 없다. */
+    dormant: z.ZodBoolean;
+    /** 지금 발송에 쓸 수 있으면 true. `status === 'APPROVED' && !dormant` 다. */
+    sendable: z.ZodBoolean;
+    /** `CHANNEL`(채널 소유) 또는 `GROUP`(기본 제공). */
+    assignType: z.ZodString;
+    messageType: z.ZodString;
+    emphasizeType: z.ZodString;
+    /**
+     * 발송 시 `kakao.variables` 에 모두 채워야 하는 변수 이름.
+     * 버튼 링크·강조 문구에 들어간 변수도 이 한 목록에 모인다.
+     */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `kakao.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `kakao.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    /** 검수를 받은 템플릿 본문. `#{변수}` 자리는 발송 시 치환된다. */
+    content: z.ZodString;
+    /**
+     * 카카오 검수 상태(`APPROVED`·`REJECTED` 등). **카카오 쪽 열린 집합이라 문자열이다.**
+     * 발송 가능 여부 판정은 `sendable` 이 정본이다.
+     */
+    status: z.ZodString;
+    /** 휴면 템플릿. `true` 면 승인 상태여도 발송할 수 없다. */
+    dormant: z.ZodBoolean;
+    /** 지금 발송에 쓸 수 있으면 true. `status === 'APPROVED' && !dormant` 다. */
+    sendable: z.ZodBoolean;
+    /** `CHANNEL`(채널 소유) 또는 `GROUP`(기본 제공). */
+    assignType: z.ZodString;
+    messageType: z.ZodString;
+    emphasizeType: z.ZodString;
+    /**
+     * 발송 시 `kakao.variables` 에 모두 채워야 하는 변수 이름.
+     * 버튼 링크·강조 문구에 들어간 변수도 이 한 목록에 모인다.
+     */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `kakao.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `kakao.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    /** 검수를 받은 템플릿 본문. `#{변수}` 자리는 발송 시 치환된다. */
+    content: z.ZodString;
+    /**
+     * 카카오 검수 상태(`APPROVED`·`REJECTED` 등). **카카오 쪽 열린 집합이라 문자열이다.**
+     * 발송 가능 여부 판정은 `sendable` 이 정본이다.
+     */
+    status: z.ZodString;
+    /** 휴면 템플릿. `true` 면 승인 상태여도 발송할 수 없다. */
+    dormant: z.ZodBoolean;
+    /** 지금 발송에 쓸 수 있으면 true. `status === 'APPROVED' && !dormant` 다. */
+    sendable: z.ZodBoolean;
+    /** `CHANNEL`(채널 소유) 또는 `GROUP`(기본 제공). */
+    assignType: z.ZodString;
+    messageType: z.ZodString;
+    emphasizeType: z.ZodString;
+    /**
+     * 발송 시 `kakao.variables` 에 모두 채워야 하는 변수 이름.
+     * 버튼 링크·강조 문구에 들어간 변수도 이 한 목록에 모인다.
+     */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+type KakaoTemplate = z.infer<typeof KakaoTemplateSchema>;
+/** 채널 업종 카테고리. **열린 집합이므로 코드에 하드코딩하지 말 것** — 이 응답이 정본이다. */
+declare const KakaoChannelCategorySchema: z.ZodObject<{
+    /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+    code: z.ZodString;
+    name: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+    code: z.ZodString;
+    name: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+    code: z.ZodString;
+    name: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+type KakaoChannelCategory = z.infer<typeof KakaoChannelCategorySchema>;
+declare const KakaoChannelCategoryListSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    meta: z.ZodObject<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    data: z.ZodArray<z.ZodObject<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    meta: z.ZodObject<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    data: z.ZodArray<z.ZodObject<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
+        code: z.ZodString;
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    meta: z.ZodObject<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** 이 목록을 공급자에서 실제로 받아 온 시각. */
+        fetchedAt: z.ZodString;
+        /** 서버 캐시에서 응답했는지. 캐시는 짧고 값이 바뀌면 자동으로 따라간다. */
+        cached: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">>;
+}, z.ZodTypeAny, "passthrough">>;
+type KakaoChannelCategoryList = z.infer<typeof KakaoChannelCategoryListSchema>;
+/**
+ * 인증번호 발송 요청 접수 결과.
+ *
+ * **응답에 인증번호는 없다.** 인증번호는 카카오 비즈니스에 등록된 담당자 휴대전화로만 가고,
+ * ClawOps 는 그 값을 받지도 저장하지도 않는다.
+ */
+declare const KakaoTokenRequestSchema: z.ZodObject<{
+    requested: z.ZodBoolean;
+    /** 정규화된 검색용 ID. `channels.connect()` 에 이 값을 그대로 보낸다. */
+    searchId: z.ZodString;
+    /** 인증번호가 발송된 번호(마스킹). */
+    phoneNumberMasked: z.ZodString;
+    /** 재요청까지 기다릴 시간(초). */
+    retryAfterSeconds: z.ZodNumber;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    requested: z.ZodBoolean;
+    /** 정규화된 검색용 ID. `channels.connect()` 에 이 값을 그대로 보낸다. */
+    searchId: z.ZodString;
+    /** 인증번호가 발송된 번호(마스킹). */
+    phoneNumberMasked: z.ZodString;
+    /** 재요청까지 기다릴 시간(초). */
+    retryAfterSeconds: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    requested: z.ZodBoolean;
+    /** 정규화된 검색용 ID. `channels.connect()` 에 이 값을 그대로 보낸다. */
+    searchId: z.ZodString;
+    /** 인증번호가 발송된 번호(마스킹). */
+    phoneNumberMasked: z.ZodString;
+    /** 재요청까지 기다릴 시간(초). */
+    retryAfterSeconds: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">>;
+type KakaoTokenRequest = z.infer<typeof KakaoTokenRequestSchema>;
+
+interface KakaoChannelListParams {
+    /** 미지정·`'all'` 은 전체. 그 밖의 값은 `400` 이다 — 오타가 조용히 전체 목록이 되지 않는다. */
+    status?: KakaoChannelStatus | 'all';
+    page?: number;
+    pageSize?: number;
+}
+interface KakaoTokenRequestParams {
+    /** 카카오 채널 검색용 ID. `@` 를 붙여 보내도 떼어내고 처리한다. */
+    searchId: string;
+    /**
+     * 인증번호를 받을 담당자 휴대전화번호. 하이픈·`+82` 형태 모두 허용된다.
+     * **카카오 비즈니스 채널에 관리자로 등록된 번호여야** 인증번호가 발송된다.
+     */
+    phoneNumber: string;
+}
+interface KakaoChannelConnectParams {
+    /** `channels.requestToken()` 이 돌려준 정규화된 값을 그대로 보낸다. */
+    searchId: string;
+    /** 인증번호를 받은 담당자 휴대전화번호. 앞 단계와 같은 번호여야 한다. */
+    phoneNumber: string;
+    /** `channelCategories()` 응답의 `code`. */
+    categoryCode: string;
+    /** 담당자 휴대전화로 받은 인증번호. 저장하지 않고 확인에만 쓴다. */
+    token: string;
+}
+interface KakaoTemplateListParams {
+    /** ClawOps 채널 리소스 ID. **필수다** — 없으면 `400` 이다. */
+    channelId: string;
+    page?: number;
+    pageSize?: number;
+}
+
+type RequestOptions$1 = {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+};
+/**
+ * 카카오 비즈니스 채널.
+ *
+ * 채널 연결은 두 단계다 — `requestToken()` 으로 담당자 휴대전화에 인증번호를 보내고,
+ * 받은 번호를 `connect()` 에 실어 완료한다. 서버는 그 사이 상태를 저장하지 않으므로
+ * `searchId` 와 `phoneNumber` 를 두 번 모두 보낸다.
+ */
+declare class KakaoChannels extends APIResource {
+    private get _path();
+    /**
+     * 연결된 채널 목록.
+     *
+     * **카카오 쪽 상태를 확인하지 않는다** — 저장된 연결 정보를 그대로 돌려주므로 빠르다.
+     * 실제 채널 상태까지 확인하려면 `retrieve()` 를 쓴다.
+     */
+    list(params?: KakaoChannelListParams, options?: RequestOptions$1): Promise<Page<KakaoChannel>>;
+    /**
+     * 채널 하나를 조회한다. **목록과 달리 카카오 쪽 상태를 실제로 확인하고 `status` 를 갱신한다.**
+     *
+     * `connect()` 가 타임아웃됐을 때 결과를 확정하는 경로이기도 하다 — 연결을 재호출하면 중복
+     * 등록을 시도하게 되지만 이 조회는 몇 번을 불러도 안전하다.
+     *
+     * 카카오 쪽 조회에 실패해도 `404` 가 아니다. 연결 기록은 유효하므로 `status` 가
+     * `needs_attention` 으로 온다.
+     */
+    retrieve(channelId: string, options?: RequestOptions$1): Promise<KakaoChannel>;
+    /**
+     * 채널 권한을 증명할 인증번호를 **담당자 휴대전화로 발송**해 달라고 요청한다. 연결의 첫 단계다.
+     *
+     * 응답에 인증번호는 없다(`202`). 받은 번호는 `connect()` 의 `token` 으로 보내며, 유효 시간이
+     * 있으므로 받은 뒤 바로 진행한다. 재요청이 잦으면 `429 KAKAO_RATE_LIMITED` 이고
+     * 응답의 `retryAfterSeconds` 만큼 기다린다.
+     */
+    requestToken(params: KakaoTokenRequestParams, options?: RequestOptions$1): Promise<KakaoTokenRequest>;
+    /**
+     * 인증번호로 채널 연결을 완료한다. **먼저 `requestToken()` 을 불러야 한다.**
+     *
+     * **멱등이다** — 이미 이 계정에 연결된 채널이면 인증번호를 소모하지 않고 기존 연결을 돌려준다.
+     * 다른 계정에 연결된 채널은 멱등이 아니라 충돌이라 `409 KAKAO_CHANNEL_ALREADY_LINKED` 다.
+     *
+     * ⚠️ **타임아웃되면 재호출하지 말 것.** 이미 연결에 성공했을 수 있어 중복 등록을 시도하게 된다.
+     * `list()` 나 `retrieve()` 로 실제 등록 여부를 확인한 뒤 결과를 확정한다.
+     *
+     * ⚠️ **실패해도 인증번호는 소모된다**(`422 KAKAO_TOKEN_INVALID`·`KAKAO_CHANNEL_REJECTED`).
+     * 원인을 해결한 뒤 `requestToken()` 부터 다시 시작해야 한다.
+     */
+    connect(params: KakaoChannelConnectParams, options?: RequestOptions$1): Promise<KakaoChannel>;
+    /**
+     * 채널 연동을 해제한다. 카카오톡 채널 자체는 지워지지 않고 ClawOps 와의 연동만 끊긴다.
+     *
+     * ⚠️ **되돌릴 수 없고, 그 채널에 등록된 알림톡 템플릿도 함께 삭제된다.** 템플릿은 카카오
+     * 검수를 다시 받아야 하므로 복구에 시간이 걸린다 — 호출 전에 사용자 확인을 받을 것.
+     *
+     * 해제 후에는 그 채널을 다시 연결할 수 있다(본인이든 다른 계정이든). `requestToken()` 부터
+     * 다시 시작하면 된다.
+     */
+    disconnect(channelId: string, options?: RequestOptions$1): Promise<KakaoChannel>;
+}
+/** 알림톡 템플릿(읽기 전용). 등록·검수는 콘솔에서 한다. */
+declare class KakaoTemplates extends APIResource {
+    /**
+     * 한 채널의 알림톡 템플릿 목록.
+     *
+     * 응답의 `data[].id` 를 발송의 `kakao.templateId` 로, `data[].channelId` 를
+     * `kakao.channelId` 로 쓴다. **`sendable: true` 인 템플릿만 발송할 수 있고**,
+     * `variables` 의 모든 항목을 발송 요청의 `kakao.variables` 에 채워야 한다.
+     */
+    list(params: KakaoTemplateListParams, options?: RequestOptions$1): Promise<Page<KakaoTemplate>>;
+}
+/**
+ * 카카오 알림톡 관련 리소스.
+ *
+ * 발송 자체는 `client.messages.create({ kakao: … })` 다 — 여기서 얻은 채널·템플릿 ID 를 그대로 쓴다.
+ */
+declare class Kakao extends APIResource {
+    get channels(): KakaoChannels;
+    get templates(): KakaoTemplates;
+    /**
+     * 채널 연결 시 지정할 업종 카테고리 목록.
+     *
+     * **값을 코드에 하드코딩하지 말 것** — 카카오/공급자 쪽에서 늘거나 바뀌는 열린 집합이고
+     * 이 응답이 그때그때의 정본이다. 응답의 `code` 를 `channels.connect()` 의 `categoryCode`
+     * 로 그대로 보낸다.
+     *
+     * 페이지네이션이 없어 `Page` 가 아니라 `{ data, meta }` 를 그대로 돌려준다.
+     */
+    channelCategories(options?: RequestOptions$1): Promise<KakaoChannelCategoryList>;
+}
+
 declare const MessageSchema: z.ZodObject<{
     messageId: z.ZodString;
     status: z.ZodEnum<["queued", "sending", "sent", "failed", "received"]>;
-    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "kakao"]>;
+    /**
+     * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
+     * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+     */
+    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "ata"]>;
     to: z.ZodString;
     from: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -814,7 +1261,11 @@ declare const MessageSchema: z.ZodObject<{
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     messageId: z.ZodString;
     status: z.ZodEnum<["queued", "sending", "sent", "failed", "received"]>;
-    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "kakao"]>;
+    /**
+     * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
+     * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+     */
+    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "ata"]>;
     to: z.ZodString;
     from: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -828,7 +1279,11 @@ declare const MessageSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     messageId: z.ZodString;
     status: z.ZodEnum<["queued", "sending", "sent", "failed", "received"]>;
-    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "kakao"]>;
+    /**
+     * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
+     * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+     */
+    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "ata"]>;
     to: z.ZodString;
     from: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -842,13 +1297,12 @@ declare const MessageSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 type Message = z.infer<typeof MessageSchema>;
 
-interface MessageCreateParams {
+/** 문자 타입. 발송·대체발송·목록 필터가 같은 어휘를 쓴다. */
+type TextMessageType = 'sms' | 'lms' | 'mms';
+/** 문자·알림톡 공통 필드. */
+interface MessageCreateBaseParams {
     to: string;
     from: string;
-    body: string;
-    type?: 'sms' | 'lms' | 'mms';
-    subject?: string;
-    mediaUrl?: string[];
     /**
      * 발송 멱등키. 같은 계정에서 같은 키로 다시 요청하면 발송하지 않고 1회차 결과를 돌려준다.
      * 재시도·재실행 경로가 있는 호출자만 채운다.
@@ -857,14 +1311,99 @@ interface MessageCreateParams {
      */
     idempotencyKey?: string;
 }
+/** SMS/LMS/MMS 발송 파라미터. */
+interface TextMessageCreateParams extends MessageCreateBaseParams {
+    body: string;
+    /**
+     * 생략하면 서버가 고른다 — `mediaUrl` 이 있으면 `mms`, `subject` 가 있거나 본문이
+     * EUC-KR 90byte(한글 45자)를 넘으면 `lms`, 그 외에는 `sms`.
+     *
+     * `'sms'` 로 명시한 본문이 90byte 를 넘으면 `400 body_too_long` 이다. 길이가 런타임에
+     * 정해지는 경우(템플릿 치환 등)에는 생략하는 편이 안전하다.
+     */
+    type?: TextMessageType;
+    subject?: string;
+    /** MMS 첨부 (최대 3개). jpg·jpeg·png·bmp, 장당 300KB 이하. */
+    mediaUrl?: string[];
+    kakao?: never;
+    fallback?: never;
+}
+/** 알림톡 템플릿 지정. 구조(본문·버튼·아이템·강조)는 검수된 템플릿이 정하고, 요청은 값만 채운다. */
+interface KakaoSendParams {
+    /** `kakao.channels.list()` 의 `data[].id` (ClawOps 리소스 ID). */
+    channelId: string;
+    /** `kakao.templates.list()` 의 `data[].id` (ClawOps 리소스 ID). */
+    templateId: string;
+    /**
+     * 템플릿 변수. 키는 `고객명` 과 `#{고객명}` 을 모두 받는다.
+     *
+     * 템플릿이 요구하는 변수가 빠지면 `400 kakao_variable_missing`, 템플릿에 없는 변수를 주면
+     * `400 kakao_variable_unknown` 이다. 버튼 링크·강조 문구에 들어간 변수도 같은 목록에 포함된다.
+     *
+     * 채워야 할 이름은 `kakao.templates.list()` 응답의 `variables` 가 알려준다.
+     */
+    variables?: Record<string, string>;
+}
+/** 알림톡이 발송 실패했을 때 대신 나갈 문자. */
+interface KakaoFallbackParams {
+    /** 생략하면 알림톡 본문(변수 치환 결과)을 그대로 문자로 보낸다. */
+    body?: string;
+    subject?: string;
+    /** 생략하면 본문 길이에 맞춰 서버가 고른다. */
+    type?: TextMessageType;
+    /** `true` 면 알림톡이 실패해도 문자를 보내지 않는다 — 실패가 그대로 실패로 남는다. */
+    disabled?: boolean;
+}
+/**
+ * 카카오 알림톡 발송 파라미터.
+ *
+ * **본문은 템플릿이 정한다.** `body`·`subject`·`mediaUrl` 은 실을 수 없고(서버가 400),
+ * 버튼·아이템 리스트·강조 문구는 카카오 검수를 받은 그대로 발송된다 — 요청으로 바꿀 수 없다.
+ *
+ * 대체발송된 문자는 **별도의 메시지 1건**으로 기록되고 문자 단가로 청구된다.
+ */
+interface KakaoMessageCreateParams extends MessageCreateBaseParams {
+    kakao: KakaoSendParams;
+    fallback?: KakaoFallbackParams;
+    /** `kakao` 를 실으면 알림톡이다. 명시할 필요가 없고, 명시한다면 `'ata'` 뿐이다. */
+    type?: 'ata';
+    body?: never;
+    subject?: never;
+    mediaUrl?: never;
+}
+/**
+ * 발송 파라미터. 문자와 알림톡은 **서로 배타적**이다 — 서버 규칙이 그렇고, 섞으면 컴파일 에러다.
+ */
+type MessageCreateParams = TextMessageCreateParams | KakaoMessageCreateParams;
 interface MessageListParams {
-    type?: 'sms' | 'lms' | 'mms';
-    status?: 'queued' | 'sending' | 'sent' | 'failed' | 'received';
+    type?: TextMessageType | 'ata';
+    status?: 'queued' | 'sent' | 'failed' | 'received';
+    /** 발신 또는 수신 번호. 하이픈 유무를 모두 매칭한다. */
+    number?: string;
     page?: number;
     pageSize?: number;
 }
 
 declare class Messages extends APIResource {
+    /**
+     * 문자(SMS/LMS/MMS) 또는 카카오 알림톡을 발송합니다.
+     *
+     * 둘은 배타적입니다 — `kakao` 를 실으면 알림톡이고, 이때 `body`·`subject`·`mediaUrl` 은
+     * 실을 수 없습니다(본문은 검수된 템플릿이 정합니다).
+     *
+     * ```ts
+     * // 문자
+     * await client.messages.create({ to: '010…', from: '070…', body: '안녕하세요' });
+     *
+     * // 알림톡 — 실패하면 fallback 문구가 문자로 대신 나갑니다(별도 1건으로 과금)
+     * await client.messages.create({
+     *   to: '010…',
+     *   from: '070…',
+     *   kakao: { channelId, templateId, variables: { 고객명: '홍길동' } },
+     *   fallback: { body: '주문이 접수되었습니다.' },
+     * });
+     * ```
+     */
     create(params: MessageCreateParams, options?: {
         extraHeaders?: Record<string, string>;
         extraQuery?: Record<string, unknown>;
@@ -1261,8 +1800,19 @@ declare class AccountContext {
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
     get blockedRecipients(): BlockedRecipients;
+    get kakao(): Kakao;
 }
 
+/**
+ * 서버가 에러 응답의 `code` 로 싣는 값.
+ *
+ * 문구가 아니라 **이 값으로 분기한다** — 한글 메시지는 바뀔 수 있다.
+ *
+ * ⚠️ 문자 도메인은 snake_case, 카카오 채널 도메인은 SCREAMING_CASE 다. 서버가 실제로
+ * 그렇게 보내므로 SDK 가 임의로 정규화하지 않는다. 열린 유니온이라 목록에 없는 코드도
+ * 그대로 실린다(자동완성만 돕는다).
+ */
+type ClawOpsErrorCode = 'invalid_phone' | 'invalid_type' | 'invalid_input' | 'from_not_registered' | 'body_too_long' | 'sms_no_subject' | 'sms_no_media' | 'lms_no_media' | 'too_many_media' | 'invalid_media_ext' | 'media_download_failed' | 'type_not_supported' | 'messaging_blocked' | 'recipient_blocked' | 'quota_exceeded' | 'override_quota_exceeded' | 'no_active_subscription' | 'kakao_required' | 'kakao_type_conflict' | 'kakao_body_not_allowed' | 'kakao_subject_not_allowed' | 'kakao_media_not_allowed' | 'kakao_channel_not_found' | 'kakao_template_not_found' | 'kakao_template_not_approved' | 'kakao_template_dormant' | 'kakao_variable_missing' | 'kakao_variable_unknown' | 'kakao_send_failed' | 'kakao_unavailable' | 'invalid_fallback_type' | 'KAKAO_TOKEN_INVALID' | 'KAKAO_CHANNEL_ALREADY_LINKED' | 'KAKAO_CHANNEL_REJECTED' | 'KAKAO_RATE_LIMITED' | 'KAKAO_PROVIDER_UNAVAILABLE' | 'VALIDATION' | 'NOT_FOUND' | (string & {});
 declare class ClawOpsError extends Error {
     constructor(message: string);
 }
@@ -1280,6 +1830,13 @@ declare class APIStatusError extends APIError {
     readonly status: number;
     readonly body: unknown;
     readonly headers: Headers | undefined;
+    /**
+     * 서버가 함께 보낸 기계 판독용 코드(`{ error, code }`). 없으면 undefined 다.
+     *
+     * 같은 상태 코드가 서로 다른 사유를 담는다 — 422 만 해도 수신거부(`recipient_blocked`)와
+     * 할당량 초과(`quota_exceeded`)가 갈리고, 한글 문구로 구분하면 문구가 바뀔 때 깨진다.
+     */
+    readonly code: ClawOpsErrorCode | undefined;
     constructor(message: string, response: {
         status: number;
         headers?: Headers;
@@ -1453,8 +2010,10 @@ declare class ClawOps extends APIClient {
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
     get blockedRecipients(): BlockedRecipients;
+    /** 카카오 채널·알림톡 템플릿. 발송은 `messages.create({ kakao: … })` 다. */
+    get kakao(): Kakao;
     get webhooks(): Webhooks;
     accounts(accountId: string): AccountContext;
 }
 
-export { SipCredentials as $, APIClient as A, BadRequestError as B, type Call as C, ClawOps as D, ClawOpsError as E, type ClawOpsOptions as F, ConflictError as G, type MessageCreateParams as H, InternalServerError as I, type MessageListParams as J, Messages as K, type NumberCreateParams as L, type Message as M, NotFoundError as N, type NumberListItem as O, type NumberUpdateParams as P, type NumberUpdateResponse as Q, Numbers as R, Page as S, PermissionDeniedError as T, type PhoneNumber as U, RateLimitError as V, type RecordingDownload as W, Recordings as X, type RoutingType as Y, ServiceUnavailableError as Z, type SipCredential as _, type APIClientOptions as a, type SipEndpoint as a0, SipEndpoints as a1, SolapiBridgeError as a2, UnprocessableEntityError as a3, type WebhookLog as a4, WebhookLogs as a5, WebhookVerificationError as a6, Webhooks as a7, APIConnectionError as b, APIError as c, APIResponseValidationError as d, APIStatusError as e, APITimeoutError as f, AccountContext as g, AgentConnectionError as h, AgentError as i, type AssignmentLink as j, type AssignmentLinkAssignment as k, type AssignmentLinkCreateResponse as l, type AssignmentLinkStatus as m, AssignmentLinks as n, AuthenticationError as o, type BlockedChannel as p, type BlockedRecipient as q, type BlockedRecipientSource as r, type BlockedRecipientStatus as s, BlockedRecipients as t, type CallContextParam as u, type CallControlResponse as v, type CallCreateParams as w, type CallListParams as x, type CallUpdateParams as y, Calls as z };
+export { type MessageListParams as $, APIClient as A, BadRequestError as B, type Call as C, ClawOps as D, ClawOpsError as E, type ClawOpsErrorCode as F, type ClawOpsOptions as G, ConflictError as H, InternalServerError as I, type KakaoChannel as J, Kakao as K, type KakaoChannelCategory as L, type KakaoChannelCategoryList as M, type KakaoChannelConnectParams as N, type KakaoChannelListParams as O, type KakaoChannelStatus as P, KakaoChannels as Q, type KakaoFallbackParams as R, type KakaoMessageCreateParams as S, type KakaoSendParams as T, type KakaoTemplate as U, type KakaoTemplateListParams as V, KakaoTemplates as W, type KakaoTokenRequest as X, type KakaoTokenRequestParams as Y, type Message as Z, type MessageCreateParams as _, type APIClientOptions as a, Messages as a0, NotFoundError as a1, type NumberCreateParams as a2, type NumberListItem as a3, type NumberUpdateParams as a4, type NumberUpdateResponse as a5, Numbers as a6, Page as a7, PermissionDeniedError as a8, type PhoneNumber as a9, RateLimitError as aa, type RecordingDownload as ab, Recordings as ac, type RoutingType as ad, ServiceUnavailableError as ae, type SipCredential as af, SipCredentials as ag, type SipEndpoint as ah, SipEndpoints as ai, SolapiBridgeError as aj, type TextMessageCreateParams as ak, UnprocessableEntityError as al, type WebhookLog as am, WebhookLogs as an, WebhookVerificationError as ao, Webhooks as ap, APIConnectionError as b, APIError as c, APIResponseValidationError as d, APIStatusError as e, APITimeoutError as f, AccountContext as g, AgentConnectionError as h, AgentError as i, type AssignmentLink as j, type AssignmentLinkAssignment as k, type AssignmentLinkCreateResponse as l, type AssignmentLinkStatus as m, AssignmentLinks as n, AuthenticationError as o, type BlockedChannel as p, type BlockedRecipient as q, type BlockedRecipientSource as r, type BlockedRecipientStatus as s, BlockedRecipients as t, type CallContextParam as u, type CallControlResponse as v, type CallCreateParams as w, type CallListParams as x, type CallUpdateParams as y, Calls as z };