@teamlearners/clawops 0.37.0 → 0.39.0

package/dist/{client-DKsEma11.d.cts → client-B_GblPxW.d.cts}

@@ -601,6 +601,14 @@ interface CallUpdateParams {
     status?: 'completed';
 }
 
+/**
+ * 화자 식별자. **2026-08 이후 전사는 `speaker_0`·`speaker_1`… 형식**이고, 전환 통화처럼
+ * 참여자가 셋 이상이면 그만큼 늘어난다. 그 이전 전사에는 `AGENT`·`CUSTOMER` 가 그대로
+ * 남아 있으므로 **두 형식을 모두 받아야 한다.** 화자와 역할의 연결은 보장되지 않는다.
+ */
+type TranscriptSpeaker = 'CUSTOMER' | 'AGENT' | (string & {});
+/** 전사 실패 단계. `trigger` 는 시스템 실패라 재요청할 수 있다. */
+type TranscriptStage = 'download' | 'runtime' | 'transcription' | 'trigger' | 'recover' | (string & {});
 /**
  * 통화 전사 상태. status 에 따라 채워지는 필드가 다름:
  * - "completed": callId, segmentCount, segments
@@ -613,69 +621,129 @@ declare const TranscriptStatusSchema: z.ZodObject<{
     callId: z.ZodOptional<z.ZodString>;
     segmentCount: z.ZodOptional<z.ZodNumber>;
     segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, z.ZodTypeAny, "passthrough">>, "many">>;
     startedAt: z.ZodOptional<z.ZodString>;
-    stage: z.ZodOptional<z.ZodNullable<z.ZodEnum<["download", "runtime", "trigger"]>>>;
+    /**
+     * ⛔ **실패 단계는 서버 코드가 만든다** — 전사 파이프라인이 `download`·`runtime`·
+     * `transcription`·`recover` 를 내보내고, 영구 실패는 예외 객체의 속성을 그대로 싣는다.
+     * 어휘가 열려 있어 스펙의 enum 조차 스냅샷일 뿐이다.
+     *
+     * ⚠️ 여기가 닫혀 있으면 **전사가 실패했을 때 그 이유를 물으면 던진다** — 고객이 가장
+     * 답을 필요로 하는 순간이다.
+     */
+    stage: z.ZodOptional<z.ZodNullable<z.ZodType<TranscriptStage, z.ZodTypeDef, TranscriptStage>>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     status: z.ZodEnum<["completed", "pending", "failed", "not_requested"]>;
     callId: z.ZodOptional<z.ZodString>;
     segmentCount: z.ZodOptional<z.ZodNumber>;
     segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, z.ZodTypeAny, "passthrough">>, "many">>;
     startedAt: z.ZodOptional<z.ZodString>;
-    stage: z.ZodOptional<z.ZodNullable<z.ZodEnum<["download", "runtime", "trigger"]>>>;
+    /**
+     * ⛔ **실패 단계는 서버 코드가 만든다** — 전사 파이프라인이 `download`·`runtime`·
+     * `transcription`·`recover` 를 내보내고, 영구 실패는 예외 객체의 속성을 그대로 싣는다.
+     * 어휘가 열려 있어 스펙의 enum 조차 스냅샷일 뿐이다.
+     *
+     * ⚠️ 여기가 닫혀 있으면 **전사가 실패했을 때 그 이유를 물으면 던진다** — 고객이 가장
+     * 답을 필요로 하는 순간이다.
+     */
+    stage: z.ZodOptional<z.ZodNullable<z.ZodType<TranscriptStage, z.ZodTypeDef, TranscriptStage>>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     status: z.ZodEnum<["completed", "pending", "failed", "not_requested"]>;
     callId: z.ZodOptional<z.ZodString>;
     segmentCount: z.ZodOptional<z.ZodNumber>;
     segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        speaker: z.ZodEnum<["CUSTOMER", "AGENT"]>;
+        /**
+         * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+         * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+         */
+        speaker: z.ZodType<TranscriptSpeaker>;
         start: z.ZodNumber;
         end: z.ZodNumber;
         text: z.ZodString;
     }, z.ZodTypeAny, "passthrough">>, "many">>;
     startedAt: z.ZodOptional<z.ZodString>;
-    stage: z.ZodOptional<z.ZodNullable<z.ZodEnum<["download", "runtime", "trigger"]>>>;
+    /**
+     * ⛔ **실패 단계는 서버 코드가 만든다** — 전사 파이프라인이 `download`·`runtime`·
+     * `transcription`·`recover` 를 내보내고, 영구 실패는 예외 객체의 속성을 그대로 싣는다.
+     * 어휘가 열려 있어 스펙의 enum 조차 스냅샷일 뿐이다.
+     *
+     * ⚠️ 여기가 닫혀 있으면 **전사가 실패했을 때 그 이유를 물으면 던진다** — 고객이 가장
+     * 답을 필요로 하는 순간이다.
+     */
+    stage: z.ZodOptional<z.ZodNullable<z.ZodType<TranscriptStage, z.ZodTypeDef, TranscriptStage>>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;
 type TranscriptStatus = z.infer<typeof TranscriptStatusSchema>;
@@ -974,6 +1042,81 @@ declare const KakaoTemplateSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.ZodTypeAny, "passthrough">>;
 type KakaoTemplate = z.infer<typeof KakaoTemplateSchema>;
+/**
+ * 브랜드 메시지 말풍선 유형. **이 값이 단가를 정한다** — 텍스트형이 가장 싸고
+ * 와이드리스트·캐러셀·커머스가 가장 비싸다.
+ *
+ * `MessageType` 과 같은 이유로 열어 둔 유니온이다.
+ */
+type BrandBubbleType = 'TEXT' | 'IMAGE' | 'WIDE' | 'WIDE_ITEM_LIST' | 'CAROUSEL_FEED' | 'COMMERCE' | 'CAROUSEL_COMMERCE' | (string & {});
+/**
+ * 브랜드 메시지 템플릿.
+ *
+ * ⭐ **알림톡과 달리 검수가 없다** — `status`·`dormant`·`sendable` 이 없는 이유이고,
+ * 목록에 있으면 곧 발송할 수 있다.
+ */
+declare const KakaoBrandTemplateSchema: z.ZodObject<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    chatBubbleType: z.ZodType<BrandBubbleType>;
+    /**
+     * 말풍선 본문.
+     *
+     * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+     * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+     */
+    content: z.ZodNullable<z.ZodString>;
+    /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+    header: z.ZodNullable<z.ZodString>;
+    /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    chatBubbleType: z.ZodType<BrandBubbleType>;
+    /**
+     * 말풍선 본문.
+     *
+     * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+     * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+     */
+    content: z.ZodNullable<z.ZodString>;
+    /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+    header: z.ZodNullable<z.ZodString>;
+    /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    chatBubbleType: z.ZodType<BrandBubbleType>;
+    /**
+     * 말풍선 본문.
+     *
+     * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+     * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+     */
+    content: z.ZodNullable<z.ZodString>;
+    /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+    header: z.ZodNullable<z.ZodString>;
+    /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+type KakaoBrandTemplate = z.infer<typeof KakaoBrandTemplateSchema>;
 /** 채널 업종 카테고리. **열린 집합이므로 코드에 하드코딩하지 말 것** — 이 응답이 정본이다. */
 declare const KakaoChannelCategorySchema: z.ZodObject<{
     /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
@@ -1145,6 +1288,13 @@ interface KakaoTemplateListParams {
     page?: number;
     pageSize?: number;
 }
+/** 브랜드 메시지 템플릿 목록. 알림톡과 같은 축(채널 필수)이다. */
+interface KakaoBrandTemplateListParams {
+    /** ClawOps 채널 리소스 ID. **필수다** — 없으면 `400` 이다. */
+    channelId: string;
+    page?: number;
+    pageSize?: number;
+}
 
 type RequestOptions$1 = {
     extraHeaders?: Record<string, string>;
@@ -1220,14 +1370,28 @@ declare class KakaoTemplates extends APIResource {
      */
     list(params: KakaoTemplateListParams, options?: RequestOptions$1): Promise<Page<KakaoTemplate>>;
 }
+declare class KakaoBrandTemplates extends APIResource {
+    /**
+     * 한 채널의 브랜드 메시지 템플릿 목록.
+     *
+     * 응답의 `data[].id` 를 발송의 `brand.templateId` 로, `data[].channelId` 를
+     * `brand.channelId` 로 쓴다. `variables` 의 모든 항목을 `brand.variables` 에 채워야 한다.
+     *
+     * ⭐ **알림톡과 달리 검수가 없어** `sendable` 같은 칸이 없다 — 목록에 있으면 곧 보낼 수 있다.
+     */
+    list(params: KakaoBrandTemplateListParams, options?: RequestOptions$1): Promise<Page<KakaoBrandTemplate>>;
+}
 /**
- * 카카오 알림톡 관련 리소스.
+ * 카카오 알림톡·브랜드 메시지 관련 리소스.
  *
- * 발송 자체는 `client.messages.create({ kakao: … })` 다 — 여기서 얻은 채널·템플릿 ID 를 그대로 쓴다.
+ * 발송 자체는 `client.messages.create({ kakao: … })` 또는 `({ brand: … })` 다 —
+ * 여기서 얻은 채널·템플릿 ID 를 그대로 쓴다.
  */
 declare class Kakao extends APIResource {
     get channels(): KakaoChannels;
     get templates(): KakaoTemplates;
+    /** 브랜드 메시지 템플릿. 알림톡 템플릿(`templates`)과 **다른 표**다. */
+    get brandTemplates(): KakaoBrandTemplates;
     /**
      * 채널 연결 시 지정할 업종 카테고리 목록.
      *
@@ -1240,14 +1404,36 @@ declare class Kakao extends APIResource {
     channelCategories(options?: RequestOptions$1): Promise<KakaoChannelCategoryList>;
 }
 
+/**
+ * 메시지 상태.
+ *
+ * ⚠️ 한때 여기 `'sending'` 이 있었는데 **서버가 한 번도 보낸 적 없는 값**이다 — 어휘를 손으로
+ *    관리하면 없는 값이 들어오고 있는 값이 빠진다. 그래서 이 유니온은 자동완성용이고,
+ *    검증은 하지 않는다.
+ */
+type MessageStatus = 'queued' | 'sent' | 'failed' | 'received' | (string & {});
+/**
+ * 메시지 유형. `KakaoChannelStatus` 와 같은 이유로 **열린 유니온**이다 — 서버가 어휘를
+ * 소유하므로 값이 하나 늘어도 조회는 살아 있어야 하고, 낡는 것은 자동완성뿐이다.
+ */
+type MessageType = 'sms' | 'lms' | 'mms'
+/** 카카오 알림톡. */
+ | 'ata'
+/** 카카오 브랜드 메시지. */
+ | 'bms' | (string & {});
 declare const MessageSchema: z.ZodObject<{
     messageId: z.ZodString;
-    status: z.ZodEnum<["queued", "sending", "sent", "failed", "received"]>;
+    status: z.ZodType<MessageStatus>;
     /**
-     * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
-     * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+     * `'ata'`(알림톡)·`'bms'`(브랜드 메시지)는 카카오로 나간다. `body` 에는 템플릿에 변수를
+     * 치환한 결과가 담기고, 버튼·아이템 리스트·강조 문구는 템플릿에 담긴 대로 발송되어
+     * 이 값에는 담기지 않는다.
+     *
+     * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 유형이 하나 늘면 닫힌
+     * enum 은 **목록을 통째로** 실패시킨다(`list()` 는 페이지를 한 번에 파싱한다). 실제로
+     * 두 번 그렇게 터졌다 — `'ata'` 가 나왔을 때, 그리고 `'bms'` 가 나왔을 때.
      */
-    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "ata"]>;
+    type: z.ZodType<MessageType>;
     to: z.ZodString;
     from: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1260,12 +1446,17 @@ declare const MessageSchema: z.ZodObject<{
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     messageId: z.ZodString;
-    status: z.ZodEnum<["queued", "sending", "sent", "failed", "received"]>;
+    status: z.ZodType<MessageStatus>;
     /**
-     * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
-     * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+     * `'ata'`(알림톡)·`'bms'`(브랜드 메시지)는 카카오로 나간다. `body` 에는 템플릿에 변수를
+     * 치환한 결과가 담기고, 버튼·아이템 리스트·강조 문구는 템플릿에 담긴 대로 발송되어
+     * 이 값에는 담기지 않는다.
+     *
+     * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 유형이 하나 늘면 닫힌
+     * enum 은 **목록을 통째로** 실패시킨다(`list()` 는 페이지를 한 번에 파싱한다). 실제로
+     * 두 번 그렇게 터졌다 — `'ata'` 가 나왔을 때, 그리고 `'bms'` 가 나왔을 때.
      */
-    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "ata"]>;
+    type: z.ZodType<MessageType>;
     to: z.ZodString;
     from: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1278,12 +1469,17 @@ declare const MessageSchema: z.ZodObject<{
     dateUpdated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     messageId: z.ZodString;
-    status: z.ZodEnum<["queued", "sending", "sent", "failed", "received"]>;
+    status: z.ZodType<MessageStatus>;
     /**
-     * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
-     * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+     * `'ata'`(알림톡)·`'bms'`(브랜드 메시지)는 카카오로 나간다. `body` 에는 템플릿에 변수를
+     * 치환한 결과가 담기고, 버튼·아이템 리스트·강조 문구는 템플릿에 담긴 대로 발송되어
+     * 이 값에는 담기지 않는다.
+     *
+     * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 유형이 하나 늘면 닫힌
+     * enum 은 **목록을 통째로** 실패시킨다(`list()` 는 페이지를 한 번에 파싱한다). 실제로
+     * 두 번 그렇게 터졌다 — `'ata'` 가 나왔을 때, 그리고 `'bms'` 가 나왔을 때.
      */
-    type: z.ZodEnum<["sms", "lms", "mms", "rcs", "ata"]>;
+    type: z.ZodType<MessageType>;
     to: z.ZodString;
     from: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1326,6 +1522,7 @@ interface TextMessageCreateParams extends MessageCreateBaseParams {
     /** MMS 첨부 (최대 3개). jpg·jpeg·png·bmp, 장당 300KB 이하. */
     mediaUrl?: string[];
     kakao?: never;
+    brand?: never;
     fallback?: never;
 }
 /** 알림톡 템플릿 지정. 구조(본문·버튼·아이템·강조)는 검수된 템플릿이 정하고, 요청은 값만 채운다. */
@@ -1364,6 +1561,7 @@ interface KakaoFallbackParams {
  */
 interface KakaoMessageCreateParams extends MessageCreateBaseParams {
     kakao: KakaoSendParams;
+    brand?: never;
     fallback?: KakaoFallbackParams;
     /** `kakao` 를 실으면 알림톡이다. 명시할 필요가 없고, 명시한다면 `'ata'` 뿐이다. */
     type?: 'ata';
@@ -1371,12 +1569,49 @@ interface KakaoMessageCreateParams extends MessageCreateBaseParams {
     subject?: never;
     mediaUrl?: never;
 }
+/** 브랜드 메시지 템플릿 지정. 구조(본문·버튼·이미지)는 등록한 템플릿이 정한다. */
+interface BrandSendParams {
+    /** `kakao.channels.list()` 의 `data[].id` (ClawOps 리소스 ID). */
+    channelId: string;
+    /**
+     * `kakao.brandTemplates.list()` 의 `data[].id` (ClawOps 리소스 ID).
+     */
+    templateId: string;
+    /**
+     * 템플릿 변수. 키는 `고객명` 과 `#{고객명}` 을 모두 받는다.
+     *
+     * 채워야 할 이름은 `kakao.brandTemplates.list()` 응답의 `variables` 가 알려준다.
+     */
+    variables?: Record<string, string>;
+}
+/**
+ * 카카오 브랜드 메시지 발송 파라미터.
+ *
+ * 채널을 **추가한 친구**에게 나가는 광고성 메시지다. 알림톡과 갈리는 점 둘:
+ *
+ * - **야간에 못 보낸다.** 20:50~08:00(KST)은 `422 kakao_brand_night_blocked` 다.
+ * - **대체발송이 없다.** `fallback` 을 실으면 `400 kakao_fallback_not_allowed` 라서
+ *   타입에서도 막는다.
+ *
+ * `(광고)` 표기와 수신거부 안내는 카카오가 붙이므로 본문에 넣지 않는다.
+ */
+interface BrandMessageCreateParams extends MessageCreateBaseParams {
+    brand: BrandSendParams;
+    /** `brand` 를 실으면 브랜드 메시지다. 명시할 필요가 없고, 명시한다면 `'bms'` 뿐이다. */
+    type?: 'bms';
+    body?: never;
+    subject?: never;
+    mediaUrl?: never;
+    kakao?: never;
+    fallback?: never;
+}
 /**
- * 발송 파라미터. 문자와 알림톡은 **서로 배타적**이다 — 서버 규칙이 그렇고, 섞으면 컴파일 에러다.
+ * 발송 파라미터. 문자·알림톡·브랜드 메시지는 **서로 배타적**이다 — 서버 규칙이 그렇고,
+ * 섞으면 컴파일 에러다.
  */
-type MessageCreateParams = TextMessageCreateParams | KakaoMessageCreateParams;
+type MessageCreateParams = TextMessageCreateParams | KakaoMessageCreateParams | BrandMessageCreateParams;
 interface MessageListParams {
-    type?: TextMessageType | 'ata';
+    type?: TextMessageType | 'ata' | 'bms';
     status?: 'queued' | 'sent' | 'failed' | 'received';
     /** 발신 또는 수신 번호. 하이픈 유무를 모두 매칭한다. */
     number?: string;
@@ -1386,10 +1621,10 @@ interface MessageListParams {
 
 declare class Messages extends APIResource {
     /**
-     * 문자(SMS/LMS/MMS) 또는 카카오 알림톡을 발송합니다.
+     * 문자(SMS/LMS/MMS) 또는 카카오 알림톡·브랜드 메시지를 발송합니다.
      *
-     * 둘은 배타적입니다 — `kakao` 를 실으면 알림톡이고, 이때 `body`·`subject`·`mediaUrl` 은
-     * 실을 수 없습니다(본문은 검수된 템플릿이 정합니다).
+     * 셋은 배타적입니다 — `kakao` 를 실으면 알림톡, `brand` 를 실으면 브랜드 메시지이고,
+     * 이때 `body`·`subject`·`mediaUrl` 은 실을 수 없습니다(본문은 템플릿이 정합니다).
      *
      * ```ts
      * // 문자
@@ -1402,6 +1637,14 @@ declare class Messages extends APIResource {
      *   kakao: { channelId, templateId, variables: { 고객명: '홍길동' } },
      *   fallback: { body: '주문이 접수되었습니다.' },
      * });
+     *
+     * // 브랜드 메시지 — 채널을 추가한 친구에게 나가는 광고성 메시지
+     * // ⚠️ 야간 제한과 대체발송 없음 — 제약은 `BrandMessageCreateParams` 참고.
+     * await client.messages.create({
+     *   to: '010…',
+     *   from: '070…',
+     *   brand: { channelId, templateId, variables: { 고객명: '홍길동' } },
+     * });
      * ```
      */
     create(params: MessageCreateParams, options?: {
@@ -1812,7 +2055,11 @@ declare class AccountContext {
  * 그렇게 보내므로 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 & {});
+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_brand_required' | 'kakao_brand_template_not_found'
+/** 광고성이라 20:50~08:00(KST)에는 접수되지 않는다. 하루 11시간 동안 나오므로 재시도 스케줄링이 이 분기에 달린다. */
+ | 'kakao_brand_night_blocked'
+/** 브랜드는 대체발송이 없다 — `fallback` 을 실으면 이 코드다. */
+ | 'kakao_fallback_not_allowed' | '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);
 }
@@ -2016,4 +2263,4 @@ declare class ClawOps extends APIClient {
     accounts(accountId: string): AccountContext;
 }
 
-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 };
+export { type KakaoTemplateListParams as $, APIClient as A, BadRequestError as B, type Call as C, type CallListParams as D, type CallUpdateParams as E, Calls as F, ClawOps as G, ClawOpsError as H, type ClawOpsErrorCode as I, type ClawOpsOptions as J, ConflictError as K, InternalServerError as L, Kakao as M, type KakaoBrandTemplate as N, type KakaoBrandTemplateListParams as O, KakaoBrandTemplates as P, type KakaoChannel as Q, type KakaoChannelCategory as R, type KakaoChannelCategoryList as S, type KakaoChannelConnectParams as T, type KakaoChannelListParams as U, type KakaoChannelStatus as V, KakaoChannels as W, type KakaoFallbackParams as X, type KakaoMessageCreateParams as Y, type KakaoSendParams as Z, type KakaoTemplate as _, type APIClientOptions as a, KakaoTemplates as a0, type KakaoTokenRequest as a1, type KakaoTokenRequestParams as a2, type Message as a3, type MessageCreateParams as a4, type MessageListParams as a5, Messages as a6, NotFoundError as a7, type NumberCreateParams as a8, type NumberListItem as a9, type NumberUpdateParams as aa, type NumberUpdateResponse as ab, Numbers as ac, Page as ad, PermissionDeniedError as ae, type PhoneNumber as af, RateLimitError as ag, type RecordingDownload as ah, Recordings as ai, type RoutingType as aj, ServiceUnavailableError as ak, type SipCredential as al, SipCredentials as am, type SipEndpoint as an, SipEndpoints as ao, SolapiBridgeError as ap, type TextMessageCreateParams as aq, UnprocessableEntityError as ar, type WebhookLog as as, WebhookLogs as at, WebhookVerificationError as au, Webhooks as av, 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 BrandBubbleType as u, type BrandMessageCreateParams as v, type BrandSendParams as w, type CallContextParam as x, type CallControlResponse as y, type CallCreateParams as z };