@teamlearners/clawops 0.37.0 → 0.38.0

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

@@ -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>;
@@ -1240,14 +1308,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 +1350,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 +1373,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>>;

package/dist/index.cjs

@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var chunkLLPMUDNE_cjs = require('./chunk-LLPMUDNE.cjs');
 var chunkIYSPOOKH_cjs = require('./chunk-IYSPOOKH.cjs');
-var chunkEYI3ULDU_cjs = require('./chunk-EYI3ULDU.cjs');
+var chunkNXCYAYFT_cjs = require('./chunk-NXCYAYFT.cjs');
 var zod = require('zod');
 var crypto = require('crypto');
 
@@ -43,7 +43,7 @@ var APIClient = class {
       Authorization: `Bearer ${this._apiKey}`,
       "Content-Type": "application/json",
       Accept: "application/json",
-      "User-Agent": `claw-ops-node/${chunkEYI3ULDU_cjs.VERSION}`,
+      "User-Agent": `claw-ops-node/${chunkNXCYAYFT_cjs.VERSION}`,
       ...this._defaultHeaders
     };
     if (extra) Object.assign(headers, extra);
@@ -490,7 +490,11 @@ var CallControlResponseSchema = zod.z.object({
   status: zod.z.string()
 }).passthrough();
 var TranscriptSegmentSchema = zod.z.object({
-  speaker: zod.z.enum(["CUSTOMER", "AGENT"]),
+  /**
+   * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+   * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+   */
+  speaker: zod.z.string(),
   start: zod.z.number(),
   end: zod.z.number(),
   text: zod.z.string()
@@ -501,7 +505,15 @@ var TranscriptStatusSchema = zod.z.object({
   segmentCount: zod.z.number().optional(),
   segments: zod.z.array(TranscriptSegmentSchema).optional(),
   startedAt: zod.z.string().optional(),
-  stage: zod.z.enum(["download", "runtime", "trigger"]).nullable().optional(),
+  /**
+   * ⛔ **실패 단계는 서버 코드가 만든다** — 전사 파이프라인이 `download`·`runtime`·
+   * `transcription`·`recover` 를 내보내고, 영구 실패는 예외 객체의 속성을 그대로 싣는다.
+   * 어휘가 열려 있어 스펙의 enum 조차 스냅샷일 뿐이다.
+   *
+   * ⚠️ 여기가 닫혀 있으면 **전사가 실패했을 때 그 이유를 물으면 던진다** — 고객이 가장
+   * 답을 필요로 하는 순간이다.
+   */
+  stage: zod.z.string().nullable().optional(),
   error: zod.z.string().nullable().optional()
 }).passthrough();
 var TranscriptRequestAcceptedSchema = zod.z.object({
@@ -849,12 +861,17 @@ var Kakao = class extends APIResource {
 };
 var MessageSchema = zod.z.object({
   messageId: zod.z.string(),
-  status: zod.z.enum(["queued", "sending", "sent", "failed", "received"]),
+  status: zod.z.string(),
   /**
-   * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
-   * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+   * `'ata'`(알림톡)·`'bms'`(브랜드 메시지)는 카카오로 나간다. `body` 에는 템플릿에 변수를
+   * 치환한 결과가 담기고, 버튼·아이템 리스트·강조 문구는 템플릿에 담긴 대로 발송되어
+   * 이 값에는 담기지 않는다.
+   *
+   * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 유형이 하나 늘면 닫힌
+   * enum 은 **목록을 통째로** 실패시킨다(`list()` 는 페이지를 한 번에 파싱한다). 실제로
+   * 두 번 그렇게 터졌다 — `'ata'` 가 나왔을 때, 그리고 `'bms'` 가 나왔을 때.
    */
-  type: zod.z.enum(["sms", "lms", "mms", "rcs", "ata"]),
+  type: zod.z.string(),
   to: zod.z.string(),
   from: zod.z.string(),
   body: zod.z.string().nullable().optional(),
@@ -1384,7 +1401,7 @@ Object.defineProperty(exports, "UnprocessableEntityError", {
 });
 Object.defineProperty(exports, "VERSION", {
   enumerable: true,
-  get: function () { return chunkEYI3ULDU_cjs.VERSION; }
+  get: function () { return chunkNXCYAYFT_cjs.VERSION; }
 });
 exports.APIClient = APIClient;
 exports.AccountContext = AccountContext;