@sayren/store-sdk 0.30.13 → 0.30.14

package/dist/index.d.mts

@@ -166,8 +166,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
   DENIED: "DENIED";
-  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   ALLOW: "ALLOW";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -192,8 +192,8 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
     DENIED: "DENIED";
-    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     ALLOW: "ALLOW";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -425,6 +425,809 @@ type TokenSource = string | null | undefined | (() => string | null | undefined)
 type Query = Record<string, string | number | boolean | undefined>;
 export declare function buildQuery(query?: Query): string;
 //#endregion
+//#region src/schemas/ai.d.ts
+/**
+ * 상점 플랫폼 AI 채팅(이슈 #124) — 대화·메시지·실행과 실행 이벤트 스트림의 계약.
+ *
+ * 상점 플랫폼 전용이다(`@ConsoleOnly`, 공개 OpenAPI 문서 제외). 메시지를 보내면 api가 실행(run)을 만들어 202로 `streamId`를 돌려주고,
+ * 응답은 별도 중계(`streamUrl`, SSE)로 받는다. 실행은 브라우저와 무관하게 서버에서 끝까지 돈다 — 다시 열면 진행 중 실행의 스트림에
+ * 처음부터 다시 붙거나(보관 1시간) 확정된 메시지를 읽는다.
+ */
+/** 첨부 하나 — 업로드(`POST /v1/uploads`, 목적 `ai-attachment`)가 돌려준 공개 주소 */
+export declare const aiAttachmentSchema: z.ZodObject<{
+  url: z.ZodString;
+  name: z.ZodString;
+  mediaType: z.ZodString;
+}, z.core.$strip>;
+export type AiAttachment = z.infer<typeof aiAttachmentSchema>;
+export declare const AI_MESSAGE_MAX_CHARS = 8000;
+export declare const AI_MESSAGE_MAX_ATTACHMENTS = 5;
+/**
+ * 편집 미리보기에서 고른 요소(#65) — 미리보기 안 선택 스크립트가 만든 값이라 사이트 코드가 꾸밀 수 있다. api는 모델에 넘길 때 데이터로
+ * 감싼다. `source`는 그 컴포넌트를 **사용한** 위치다(작업 트리 상대 경로). React 개발 정보가 없으면 null이다
+ */
+export declare const aiPreviewSelectionSchema: z.ZodObject<{
+  component: z.ZodNullable<z.ZodString>;
+  source: z.ZodNullable<z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+  tag: z.ZodString;
+  text: z.ZodString;
+  pagePath: z.ZodString;
+}, z.core.$strip>;
+export type AiPreviewSelection = z.infer<typeof aiPreviewSelectionSchema>;
+/** 실행 상태 — 끝난 상태는 `DONE`·`FAILED`·`CANCELLED`다 */
+export declare const aiRunStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
+  CANCEL_REQUESTED: "CANCEL_REQUESTED";
+  QUEUED: "QUEUED";
+  RUNNING: "RUNNING";
+  DONE: "DONE";
+  CANCELLED: "CANCELLED";
+}>;
+export type AiRunStatus = z.infer<typeof aiRunStatusSchema>;
+export declare const AI_RUN_ACTIVE_STATUSES: readonly AiRunStatus[];
+/** 진행 중 실행의 스트림 접속 정보. `streamToken`은 이 스트림 하나만 읽는 단기 자격(Bearer)이다 */
+export declare const aiStreamAccessSchema: z.ZodObject<{
+  streamId: z.ZodString;
+  streamUrl: z.ZodString;
+  streamToken: z.ZodString;
+}, z.core.$strip>;
+export type AiStreamAccess = z.infer<typeof aiStreamAccessSchema>;
+export declare const aiRunSchema: z.ZodObject<{
+  id: z.ZodString;
+  status: z.ZodEnum<{
+    FAILED: "FAILED";
+    CANCEL_REQUESTED: "CANCEL_REQUESTED";
+    QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
+    DONE: "DONE";
+    CANCELLED: "CANCELLED";
+  }>;
+  errorCode: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+  finishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AiRun = z.infer<typeof aiRunSchema>;
+/**
+ * 화면에 그리는 메시지 조각. 모델 원문(tool_use 블록 등)은 api가 보관하고 화면에는 이 형태만 준다.
+ * - `text`: 글
+ * - `tool`: 도구 호출 한 번(이름은 사람이 읽는 라벨, 결과 요약·링크)
+ * - `choices`: 선택지 버튼(가장 최근 것만 누를 수 있다)
+ * - `attachment`: 사용자가 올린 첨부
+ * - `approval`: 승인 대기로 남은 쓰기
+ */
+export declare const aiMessagePartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"text">;
+  text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"tool">;
+  toolCallId: z.ZodString;
+  name: z.ZodString;
+  label: z.ZodString;
+  status: z.ZodEnum<{
+    error: "error";
+    unknown: "unknown";
+    ok: "ok";
+  }>;
+  summary: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"choices">;
+  question: z.ZodString;
+  options: z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"attachment">;
+  attachment: z.ZodObject<{
+    url: z.ZodString;
+    name: z.ZodString;
+    mediaType: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"approval">;
+  approvalId: z.ZodString;
+  title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"selection">;
+  selection: z.ZodObject<{
+    component: z.ZodNullable<z.ZodString>;
+    source: z.ZodNullable<z.ZodObject<{
+      path: z.ZodString;
+      line: z.ZodNumber;
+      column: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    tag: z.ZodString;
+    text: z.ZodString;
+    pagePath: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+export type AiMessagePart = z.infer<typeof aiMessagePartSchema>;
+export declare const aiMessageSchema: z.ZodObject<{
+  id: z.ZodString;
+  role: z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+  }>;
+  parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool">;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    label: z.ZodString;
+    status: z.ZodEnum<{
+      error: "error";
+      unknown: "unknown";
+      ok: "ok";
+    }>;
+    summary: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"choices">;
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attachment">;
+    attachment: z.ZodObject<{
+      url: z.ZodString;
+      name: z.ZodString;
+      mediaType: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"approval">;
+    approvalId: z.ZodString;
+    title: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"selection">;
+    selection: z.ZodObject<{
+      component: z.ZodNullable<z.ZodString>;
+      source: z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strip>>;
+      tag: z.ZodString;
+      text: z.ZodString;
+      pagePath: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>], "type">>;
+  runId: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type AiMessage = z.infer<typeof aiMessageSchema>;
+export declare const aiConversationSummarySchema: z.ZodObject<{
+  id: z.ZodString;
+  title: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type AiConversationSummary = z.infer<typeof aiConversationSummarySchema>;
+export declare const aiConversationSchema: z.ZodObject<{
+  id: z.ZodString;
+  title: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+  messages: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<{
+      user: "user";
+      assistant: "assistant";
+    }>;
+    parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"text">;
+      text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"tool">;
+      toolCallId: z.ZodString;
+      name: z.ZodString;
+      label: z.ZodString;
+      status: z.ZodEnum<{
+        error: "error";
+        unknown: "unknown";
+        ok: "ok";
+      }>;
+      summary: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"choices">;
+      question: z.ZodString;
+      options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+      }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"attachment">;
+      attachment: z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodString;
+        mediaType: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"approval">;
+      approvalId: z.ZodString;
+      title: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"selection">;
+      selection: z.ZodObject<{
+        component: z.ZodNullable<z.ZodString>;
+        source: z.ZodNullable<z.ZodObject<{
+          path: z.ZodString;
+          line: z.ZodNumber;
+          column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        tag: z.ZodString;
+        text: z.ZodString;
+        pagePath: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">>;
+    runId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+  activeRun: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+      FAILED: "FAILED";
+      CANCEL_REQUESTED: "CANCEL_REQUESTED";
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
+      DONE: "DONE";
+      CANCELLED: "CANCELLED";
+    }>;
+    errorCode: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    finishedAt: z.ZodNullable<z.ZodString>;
+    stream: z.ZodObject<{
+      streamId: z.ZodString;
+      streamUrl: z.ZodString;
+      streamToken: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>>;
+  lastRun: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+      FAILED: "FAILED";
+      CANCEL_REQUESTED: "CANCEL_REQUESTED";
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
+      DONE: "DONE";
+      CANCELLED: "CANCELLED";
+    }>;
+    errorCode: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    finishedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AiConversation = z.infer<typeof aiConversationSchema>;
+export declare const createAiConversationRequestSchema: z.ZodObject<{
+  draftId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateAiConversationRequest = z.infer<typeof createAiConversationRequestSchema>;
+export declare const createAiConversationResponseSchema: z.ZodObject<{
+  conversation: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>;
+  run: z.ZodNullable<z.ZodObject<{
+    streamId: z.ZodString;
+    streamUrl: z.ZodString;
+    streamToken: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateAiConversationResponse = z.infer<typeof createAiConversationResponseSchema>;
+export declare const sendAiMessageRequestSchema: z.ZodObject<{
+  text: z.ZodString;
+  attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    name: z.ZodString;
+    mediaType: z.ZodString;
+  }, z.core.$strip>>>;
+  choice: z.ZodOptional<z.ZodString>;
+  selection: z.ZodOptional<z.ZodObject<{
+    component: z.ZodNullable<z.ZodString>;
+    source: z.ZodNullable<z.ZodObject<{
+      path: z.ZodString;
+      line: z.ZodNumber;
+      column: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    tag: z.ZodString;
+    text: z.ZodString;
+    pagePath: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SendAiMessageRequest = z.input<typeof sendAiMessageRequestSchema>;
+export declare const sendAiMessageResponseSchema: z.ZodObject<{
+  streamId: z.ZodString;
+  streamUrl: z.ZodString;
+  streamToken: z.ZodString;
+  messageId: z.ZodString;
+}, z.core.$strip>;
+export type SendAiMessageResponse = z.infer<typeof sendAiMessageResponseSchema>;
+/**
+ * AI가 바꾸는 화면 영역 — 쓰기 도구가 시작되면 이벤트에 싣고, 패널이 그 화면으로 옮겨 반영된 데이터를 다시 읽는다(셀러가 AI가 하는 일을 같이 본다).
+ * 경로는 상점 플랫폼이 정한다(영역 → 라우트). `id`가 있으면 상세 화면이다
+ */
+export declare const aiFocusAreaSchema: z.ZodEnum<{
+  shipping: "shipping";
+  products: "products";
+  addresses: "addresses";
+  webhooks: "webhooks";
+  categories: "categories";
+  collections: "collections";
+  option_sets: "option_sets";
+  coupons: "coupons";
+  points: "points";
+  orders: "orders";
+  claims: "claims";
+  customers: "customers";
+  inquiries: "inquiries";
+  customer_inquiries: "customer_inquiries";
+  store_settings: "store_settings";
+  payments: "payments";
+  login: "login";
+  members: "members";
+  order_flows: "order_flows";
+  storefront: "storefront";
+}>;
+export type AiFocusArea = z.infer<typeof aiFocusAreaSchema>;
+export declare const aiFocusSchema: z.ZodObject<{
+  area: z.ZodEnum<{
+    shipping: "shipping";
+    products: "products";
+    addresses: "addresses";
+    webhooks: "webhooks";
+    categories: "categories";
+    collections: "collections";
+    option_sets: "option_sets";
+    coupons: "coupons";
+    points: "points";
+    orders: "orders";
+    claims: "claims";
+    customers: "customers";
+    inquiries: "inquiries";
+    customer_inquiries: "customer_inquiries";
+    store_settings: "store_settings";
+    payments: "payments";
+    login: "login";
+    members: "members";
+    order_flows: "order_flows";
+    storefront: "storefront";
+  }>;
+  id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AiFocus = z.infer<typeof aiFocusSchema>;
+/** 변경 기록 보관 기간 — 지나면 내용을 비우고 되돌릴 수 없다(410 `AI_RUN_CHANGES_EXPIRED`) */
+export declare const AI_RUN_FILE_CHANGES_RETENTION_DAYS = 7;
+/**
+ * 실행 하나의 변경 상태
+ * - `APPLIED`: 되돌릴 수 있다(진행 중 실행이 없을 때)
+ * - `INCOMPLETE`: 결과를 모르는 쓰기·이전 내용이 너무 큰 경로가 있다(되돌릴 수 없다)
+ * - `REVERTING`·`REVERTED`·`REVERT_UNKNOWN`(되돌리기 결과를 모름 — 다시 하지 않는다)·`EXPIRED`
+ */
+export declare const aiRunChangesStatusSchema: z.ZodEnum<{
+  EXPIRED: "EXPIRED";
+  APPLIED: "APPLIED";
+  INCOMPLETE: "INCOMPLETE";
+  REVERTING: "REVERTING";
+  REVERTED: "REVERTED";
+  REVERT_UNKNOWN: "REVERT_UNKNOWN";
+}>;
+export type AiRunChangesStatus = z.infer<typeof aiRunChangesStatusSchema>;
+export declare const aiFileChangeKindSchema: z.ZodEnum<{
+  created: "created";
+  modified: "modified";
+  deleted: "deleted";
+}>;
+export type AiFileChangeKind = z.infer<typeof aiFileChangeKindSchema>;
+export declare const aiRunChangesSchema: z.ZodObject<{
+  runId: z.ZodString;
+  status: z.ZodEnum<{
+    EXPIRED: "EXPIRED";
+    APPLIED: "APPLIED";
+    INCOMPLETE: "INCOMPLETE";
+    REVERTING: "REVERTING";
+    REVERTED: "REVERTED";
+    REVERT_UNKNOWN: "REVERT_UNKNOWN";
+  }>;
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    change: z.ZodEnum<{
+      created: "created";
+      modified: "modified";
+      deleted: "deleted";
+    }>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AiRunChanges = z.infer<typeof aiRunChangesSchema>;
+/** `GET /v1/ai/conversations/{id}/file-changes` — 대화의 실행별 변경(실행 만든 순) */
+export declare const aiConversationFileChangesSchema: z.ZodObject<{
+  runs: z.ZodArray<z.ZodObject<{
+    runId: z.ZodString;
+    status: z.ZodEnum<{
+      EXPIRED: "EXPIRED";
+      APPLIED: "APPLIED";
+      INCOMPLETE: "INCOMPLETE";
+      REVERTING: "REVERTING";
+      REVERTED: "REVERTED";
+      REVERT_UNKNOWN: "REVERT_UNKNOWN";
+    }>;
+    files: z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      change: z.ZodEnum<{
+        created: "created";
+        modified: "modified";
+        deleted: "deleted";
+      }>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AiConversationFileChanges = z.infer<typeof aiConversationFileChangesSchema>;
+/** `GET /v1/ai/runs/{runId}/file-changes` — 변경 보기. 텍스트가 아닌 파일·보관이 끝난 내용은 null이다(diff는 화면이 계산한다) */
+export declare const aiRunFileDiffSchema: z.ZodObject<{
+  runId: z.ZodString;
+  status: z.ZodEnum<{
+    EXPIRED: "EXPIRED";
+    APPLIED: "APPLIED";
+    INCOMPLETE: "INCOMPLETE";
+    REVERTING: "REVERTING";
+    REVERTED: "REVERTED";
+    REVERT_UNKNOWN: "REVERT_UNKNOWN";
+  }>;
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    change: z.ZodEnum<{
+      created: "created";
+      modified: "modified";
+      deleted: "deleted";
+    }>;
+    before: z.ZodNullable<z.ZodString>;
+    after: z.ZodNullable<z.ZodString>;
+    binary: z.ZodBoolean;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AiRunFileDiff = z.infer<typeof aiRunFileDiffSchema>;
+/**
+ * `POST /v1/ai/runs/{runId}/revert` — 실행이 바꾼 경로를 그 전 내용으로 한 번에 돌린다. 오류: 409 `AI_RUN_IN_PROGRESS`(대화에 진행 중 실행),
+ * 409 `AI_RUN_REVERT_CONFLICT`(`details.conflicts` — 그 뒤 바뀐 경로·결과를 모르는 쓰기), 409 `AI_RUN_ALREADY_REVERTED`,
+ * 410 `AI_RUN_CHANGES_EXPIRED`, 404 `AI_RUN_CHANGES_NOT_FOUND`, 502 `AI_RUN_REVERT_UNKNOWN`(결과를 모름 — 다시 하지 않는다)
+ */
+export declare const aiRunRevertResultSchema: z.ZodObject<{
+  runId: z.ZodString;
+  status: z.ZodLiteral<"REVERTED">;
+  paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type AiRunRevertResult = z.infer<typeof aiRunRevertResultSchema>;
+/** 409 `AI_RUN_REVERT_CONFLICT`의 `error.details` */
+export declare const aiRunRevertConflictDetailsSchema: z.ZodObject<{
+  conflicts: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    reason: z.ZodEnum<{
+      UNKNOWN: "UNKNOWN";
+      CHANGED: "CHANGED";
+    }>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AiRunRevertConflictDetails = z.infer<typeof aiRunRevertConflictDetailsSchema>;
+export declare const aiStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"delta">;
+  messageId: z.ZodString;
+  text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"tool_start">;
+  messageId: z.ZodString;
+  toolCallId: z.ZodString;
+  name: z.ZodString;
+  label: z.ZodString;
+  focus: z.ZodOptional<z.ZodObject<{
+    area: z.ZodEnum<{
+      shipping: "shipping";
+      products: "products";
+      addresses: "addresses";
+      webhooks: "webhooks";
+      categories: "categories";
+      collections: "collections";
+      option_sets: "option_sets";
+      coupons: "coupons";
+      points: "points";
+      orders: "orders";
+      claims: "claims";
+      customers: "customers";
+      inquiries: "inquiries";
+      customer_inquiries: "customer_inquiries";
+      store_settings: "store_settings";
+      payments: "payments";
+      login: "login";
+      members: "members";
+      order_flows: "order_flows";
+      storefront: "storefront";
+    }>;
+    id: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"tool_result">;
+  messageId: z.ZodString;
+  toolCallId: z.ZodString;
+  status: z.ZodEnum<{
+    error: "error";
+    unknown: "unknown";
+    ok: "ok";
+  }>;
+  summary: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"choices">;
+  messageId: z.ZodString;
+  question: z.ZodString;
+  options: z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"approval">;
+  messageId: z.ZodString;
+  approvalId: z.ZodString;
+  title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"message">;
+  message: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<{
+      user: "user";
+      assistant: "assistant";
+    }>;
+    parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      type: z.ZodLiteral<"text">;
+      text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"tool">;
+      toolCallId: z.ZodString;
+      name: z.ZodString;
+      label: z.ZodString;
+      status: z.ZodEnum<{
+        error: "error";
+        unknown: "unknown";
+        ok: "ok";
+      }>;
+      summary: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"choices">;
+      question: z.ZodString;
+      options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+      }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"attachment">;
+      attachment: z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodString;
+        mediaType: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"approval">;
+      approvalId: z.ZodString;
+      title: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      type: z.ZodLiteral<"selection">;
+      selection: z.ZodObject<{
+        component: z.ZodNullable<z.ZodString>;
+        source: z.ZodNullable<z.ZodObject<{
+          path: z.ZodString;
+          line: z.ZodNumber;
+          column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        tag: z.ZodString;
+        text: z.ZodString;
+        pagePath: z.ZodString;
+      }, z.core.$strip>;
+    }, z.core.$strip>], "type">>;
+    runId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"error">;
+  code: z.ZodString;
+  message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"done">;
+  status: z.ZodEnum<{
+    FAILED: "FAILED";
+    CANCEL_REQUESTED: "CANCEL_REQUESTED";
+    QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
+    DONE: "DONE";
+    CANCELLED: "CANCELLED";
+  }>;
+}, z.core.$strip>], "type">;
+export type AiStreamEvent = z.infer<typeof aiStreamEventSchema>;
+/** 중계에 쌓이는 이벤트 한 건 — 실행기 → 중계 `POST /internal/streams/{id}/events` */
+export declare const aiStreamRecordSchema: z.ZodObject<{
+  seq: z.ZodNumber;
+  event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"delta">;
+    messageId: z.ZodString;
+    text: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_start">;
+    messageId: z.ZodString;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    label: z.ZodString;
+    focus: z.ZodOptional<z.ZodObject<{
+      area: z.ZodEnum<{
+        shipping: "shipping";
+        products: "products";
+        addresses: "addresses";
+        webhooks: "webhooks";
+        categories: "categories";
+        collections: "collections";
+        option_sets: "option_sets";
+        coupons: "coupons";
+        points: "points";
+        orders: "orders";
+        claims: "claims";
+        customers: "customers";
+        inquiries: "inquiries";
+        customer_inquiries: "customer_inquiries";
+        store_settings: "store_settings";
+        payments: "payments";
+        login: "login";
+        members: "members";
+        order_flows: "order_flows";
+        storefront: "storefront";
+      }>;
+      id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    messageId: z.ZodString;
+    toolCallId: z.ZodString;
+    status: z.ZodEnum<{
+      error: "error";
+      unknown: "unknown";
+      ok: "ok";
+    }>;
+    summary: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"choices">;
+    messageId: z.ZodString;
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"approval">;
+    messageId: z.ZodString;
+    approvalId: z.ZodString;
+    title: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message">;
+    message: z.ZodObject<{
+      id: z.ZodString;
+      role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+      }>;
+      parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool">;
+        toolCallId: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        status: z.ZodEnum<{
+          error: "error";
+          unknown: "unknown";
+          ok: "ok";
+        }>;
+        summary: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"choices">;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+          label: z.ZodString;
+          value: z.ZodString;
+        }, z.core.$strip>>;
+      }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attachment">;
+        attachment: z.ZodObject<{
+          url: z.ZodString;
+          name: z.ZodString;
+          mediaType: z.ZodString;
+        }, z.core.$strip>;
+      }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"approval">;
+        approvalId: z.ZodString;
+        title: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"selection">;
+        selection: z.ZodObject<{
+          component: z.ZodNullable<z.ZodString>;
+          source: z.ZodNullable<z.ZodObject<{
+            path: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+          }, z.core.$strip>>;
+          tag: z.ZodString;
+          text: z.ZodString;
+          pagePath: z.ZodString;
+        }, z.core.$strip>;
+      }, z.core.$strip>], "type">>;
+      runId: z.ZodNullable<z.ZodString>;
+      createdAt: z.ZodString;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    code: z.ZodString;
+    message: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    status: z.ZodEnum<{
+      FAILED: "FAILED";
+      CANCEL_REQUESTED: "CANCEL_REQUESTED";
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
+      DONE: "DONE";
+      CANCELLED: "CANCELLED";
+    }>;
+  }, z.core.$strip>], "type">;
+}, z.core.$strip>;
+export type AiStreamRecord = z.infer<typeof aiStreamRecordSchema>;
+export declare const STORE_DRAFT_MAX_ATTACHMENTS = 5;
+/** 초안 첨부 하나의 최대 크기(바이트) */
+export declare const STORE_DRAFT_ATTACHMENT_MAX_BYTES: number;
+/** 연결하지 않은 초안을 지우기까지 */
+export declare const STORE_DRAFT_RETENTION_DAYS = 7;
+export declare const createStoreDraftRequestSchema: z.ZodObject<{
+  text: z.ZodString;
+  attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    filename: z.ZodString;
+    size: z.ZodNumber;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CreateStoreDraftRequest = z.input<typeof createStoreDraftRequestSchema>;
+export declare const createStoreDraftResponseSchema: z.ZodObject<{
+  draftId: z.ZodString;
+  uploads: z.ZodArray<z.ZodObject<{
+    uploadUrl: z.ZodString;
+    url: z.ZodString;
+  }, z.core.$strip>>;
+  continueUrl: z.ZodString;
+}, z.core.$strip>;
+export type CreateStoreDraftResponse = z.infer<typeof createStoreDraftResponseSchema>;
+export declare const storeDraftSchema: z.ZodObject<{
+  id: z.ZodString;
+  text: z.ZodString;
+  attachments: z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    name: z.ZodString;
+    mediaType: z.ZodString;
+  }, z.core.$strip>>;
+  createdAt: z.ZodString;
+  storeId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StoreDraft = z.infer<typeof storeDraftSchema>;
+/** 로그인 전 초안 미리보기(`GET /v1/public/store-drafts/{id}`) — 로그인 화면이 「저장한 설명」을 보인다. 첨부는 이름만 */
+export declare const storeDraftPreviewSchema: z.ZodObject<{
+  id: z.ZodString;
+  text: z.ZodString;
+  attachments: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    mediaType: z.ZodString;
+  }, z.core.$strip>>;
+  expiresAt: z.ZodString;
+  used: z.ZodBoolean;
+}, z.core.$strip>;
+export type StoreDraftPreview = z.infer<typeof storeDraftPreviewSchema>;
+//#endregion
 //#region src/schemas/analytics.d.ts
 export declare const analyticsRangeQuerySchema: z.ZodObject<{
   from: z.ZodString;
@@ -2144,7 +2947,7 @@ export declare function parseWebhookEvent(body: unknown): ParsedWebhookEvent;
 //#endregion
 //#region src/schemas/app-manifest.d.ts
 /**
- * 서드파티 앱 매니페스트 `sayren.app.json` (이슈 #22) — CLI(`sayren app`)·api(빌드 `VERIFY`·버전 판정·동의 화면 자료)·런타임이
+ * 서드파티 앱 매니페스트 `manifest.json` (이슈 #22) — CLI(`sayren app`)·api(빌드 `VERIFY`·버전 판정·동의 화면 자료)·런타임이
  * 같은 원천을 쓴다. 매니페스트는 정적 JSON이고 빌드 없이 읽는다.
  *
  * 기능 하나는 **capability** 하나다(`APP_CAPABILITIES`). capability는 매니페스트 조각·동의 문단·넓어짐 판정(재동의 조건)을 한 곳에 둔다.
@@ -3142,8 +3945,8 @@ export declare const appBuildSchema: z.ZodObject<{
   status: z.ZodEnum<{
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
-    RUNNING: "RUNNING";
     QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
     TIMED_OUT: "TIMED_OUT";
   }>;
   stages: z.ZodArray<z.ZodObject<{
@@ -3188,8 +3991,8 @@ export declare const appVersionSchema: z.ZodObject<{
     status: z.ZodEnum<{
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
-      RUNNING: "RUNNING";
       QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
       TIMED_OUT: "TIMED_OUT";
     }>;
     stages: z.ZodArray<z.ZodObject<{
@@ -3339,8 +4142,8 @@ export declare const appReleaseResultSchema: z.ZodObject<{
       status: z.ZodEnum<{
         FAILED: "FAILED";
         SUCCEEDED: "SUCCEEDED";
-        RUNNING: "RUNNING";
         QUEUED: "QUEUED";
+        RUNNING: "RUNNING";
         TIMED_OUT: "TIMED_OUT";
       }>;
       stages: z.ZodArray<z.ZodObject<{
@@ -3432,9 +4235,9 @@ export declare const appInvocationSchema: z.ZodObject<{
   kind: z.ZodEnum<{
     event: "event";
     flow: "flow";
+    tool: "tool";
     http: "http";
     schedule: "schedule";
-    tool: "tool";
   }>;
   eventType: z.ZodNullable<z.ZodString>;
   outcome: z.ZodEnum<{
@@ -11081,8 +11884,8 @@ export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequest
 export declare const storefrontCheckStatusSchema: z.ZodEnum<{
   FAILED: "FAILED";
   UNKNOWN: "UNKNOWN";
-  RUNNING: "RUNNING";
   QUEUED: "QUEUED";
+  RUNNING: "RUNNING";
   PASSED: "PASSED";
   TIMED_OUT: "TIMED_OUT";
 }>;
@@ -11095,8 +11898,8 @@ export declare const storefrontCheckSchema: z.ZodObject<{
   status: z.ZodEnum<{
     FAILED: "FAILED";
     UNKNOWN: "UNKNOWN";
-    RUNNING: "RUNNING";
     QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
     PASSED: "PASSED";
     TIMED_OUT: "TIMED_OUT";
   }>;
@@ -11180,8 +11983,8 @@ export type StorefrontVerifyReport = z.infer<typeof storefrontVerifyReportSchema
 export declare const storefrontBuildStatusSchema: z.ZodEnum<{
   FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
-  RUNNING: "RUNNING";
   QUEUED: "QUEUED";
+  RUNNING: "RUNNING";
   TIMED_OUT: "TIMED_OUT";
 }>;
 export type StorefrontBuildStatus = z.infer<typeof storefrontBuildStatusSchema>;
@@ -11248,8 +12051,8 @@ export declare const storefrontBuildSchema: z.ZodObject<{
   status: z.ZodEnum<{
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
-    RUNNING: "RUNNING";
     QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
     TIMED_OUT: "TIMED_OUT";
   }>;
   failureStage: z.ZodNullable<z.ZodString>;
@@ -11377,8 +12180,8 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
     status: z.ZodEnum<{
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
-      RUNNING: "RUNNING";
       QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
       TIMED_OUT: "TIMED_OUT";
     }>;
     failureStage: z.ZodNullable<z.ZodString>;
@@ -11574,11 +12377,13 @@ export type StorefrontSourceReplaced = z.infer<typeof storefrontSourceReplacedSc
  * - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
  * - `flow-attachment`: 주문 흐름 행동의 첨부(시안 등, 이슈 #115). 구매자에게 보이므로 정지 이미지와 PDF만 받는다.
+ * - `ai-attachment`: 상점 플랫폼 AI 채팅에 붙이는 자료(이슈 #124). 모델이 읽는 정지 이미지와 PDF만 받는다.
  */
 export declare const uploadPurposeSchema: z.ZodEnum<{
   "product-image": "product-image";
   description: "description";
   "flow-attachment": "flow-attachment";
+  "ai-attachment": "ai-attachment";
 }>;
 export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
 export interface UploadPurposeLimit {
@@ -11619,6 +12424,7 @@ export declare const uploadRequestSchema: z.ZodObject<{
     "product-image": "product-image";
     description: "description";
     "flow-attachment": "flow-attachment";
+    "ai-attachment": "ai-attachment";
   }>>;
   size: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -17411,6 +18217,151 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     remove: (locationId: string) => Promise<void>;
   };
+  /**
+   * 상점 플랫폼 AI 채팅 (이슈 #124) — 상점 플랫폼 전용(공개 문서 제외). 메시지는 202로 `streamId`를 돌려주고
+   * 응답은 `streamUrl`(SSE, Bearer `streamToken`)로 받는다. 실행은 브라우저와 무관하게 서버에서 끝까지 돈다.
+   */
+  ai: {
+    /** `GET /v1/ai/conversations` — 내 대화 목록(최근 순) */
+    listConversations: () => Promise<{
+      id: string;
+      title: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }[]>;
+    /** `POST /v1/ai/conversations` — 새 대화. `draftId`를 주면 그 초안을 첫 메시지로 실행을 시작한다 */
+    createConversation: (body?: CreateAiConversationRequest) => Promise<{
+      conversation: {
+        id: string;
+        title: string | null;
+        createdAt: string;
+        updatedAt: string;
+      };
+      run: {
+        streamId: string;
+        streamUrl: string;
+        streamToken: string;
+      } | null;
+    }>;
+    /** `GET /v1/ai/conversations/{id}` — 메시지와 진행 중 실행 */
+    getConversation: (conversationId: string) => Promise<{
+      id: string;
+      title: string | null;
+      createdAt: string;
+      updatedAt: string;
+      messages: {
+        id: string;
+        role: "user" | "assistant";
+        parts: ({
+          type: "text";
+          text: string;
+        } | {
+          type: "tool";
+          toolCallId: string;
+          name: string;
+          label: string;
+          status: "error" | "unknown" | "ok";
+          summary: string | null;
+        } | {
+          type: "choices";
+          question: string;
+          options: {
+            label: string;
+            value: string;
+          }[];
+        } | {
+          type: "attachment";
+          attachment: {
+            url: string;
+            name: string;
+            mediaType: string;
+          };
+        } | {
+          type: "approval";
+          approvalId: string;
+          title: string;
+        } | {
+          type: "selection";
+          selection: {
+            component: string | null;
+            source: {
+              path: string;
+              line: number;
+              column?: number | undefined;
+            } | null;
+            tag: string;
+            text: string;
+            pagePath: string;
+          };
+        })[];
+        runId: string | null;
+        createdAt: string;
+      }[];
+      activeRun: {
+        id: string;
+        status: "FAILED" | "CANCEL_REQUESTED" | "QUEUED" | "RUNNING" | "DONE" | "CANCELLED";
+        errorCode: string | null;
+        createdAt: string;
+        finishedAt: string | null;
+        stream: {
+          streamId: string;
+          streamUrl: string;
+          streamToken: string;
+        };
+      } | null;
+      lastRun: {
+        id: string;
+        status: "FAILED" | "CANCEL_REQUESTED" | "QUEUED" | "RUNNING" | "DONE" | "CANCELLED";
+        errorCode: string | null;
+        createdAt: string;
+        finishedAt: string | null;
+      } | null;
+    }>;
+    /** `POST /v1/ai/conversations/{id}/messages` (202) — 진행 중 실행이 있으면 409 `AI_RUN_IN_PROGRESS` */
+    sendMessage: (conversationId: string, body: SendAiMessageRequest) => Promise<{
+      streamId: string;
+      streamUrl: string;
+      streamToken: string;
+      messageId: string;
+    }>;
+    /** `POST /v1/ai/runs/{id}/cancel` (202) — 실행기가 다음 단계 전에 멈춘다 */
+    cancelRun: (runId: string) => Promise<{
+      id: string;
+      status: "FAILED" | "CANCEL_REQUESTED" | "QUEUED" | "RUNNING" | "DONE" | "CANCELLED";
+      errorCode: string | null;
+      createdAt: string;
+      finishedAt: string | null;
+    }>;
+    /** `GET /v1/ai/conversations/{id}/file-changes` — 실행별 스토어프론트 작업 트리 변경(#65) */
+    listFileChanges: (conversationId: string) => Promise<{
+      runs: {
+        runId: string;
+        status: "EXPIRED" | "APPLIED" | "INCOMPLETE" | "REVERTING" | "REVERTED" | "REVERT_UNKNOWN";
+        files: {
+          path: string;
+          change: "created" | "modified" | "deleted";
+        }[];
+      }[];
+    }>;
+    /** `GET /v1/ai/runs/{id}/file-changes` — 실행 하나의 변경 내용(이전·이후) */
+    getRunFileDiff: (runId: string) => Promise<{
+      runId: string;
+      status: "EXPIRED" | "APPLIED" | "INCOMPLETE" | "REVERTING" | "REVERTED" | "REVERT_UNKNOWN";
+      files: {
+        path: string;
+        change: "created" | "modified" | "deleted";
+        before: string | null;
+        after: string | null;
+        binary: boolean;
+      }[];
+    }>;
+    /** `POST /v1/ai/runs/{id}/revert` — 실행이 바꾼 파일을 한 번에 되돌린다(전부 아니면 전무) */
+    revertRun: (runId: string) => Promise<{
+      runId: string;
+      status: "REVERTED";
+      paths: string[];
+    }>;
+  };
   /**
    * 스토어프론트 호스팅 (이슈 #53) — 조회 `storefront:r`, 쓰기 `storefront:rw`(OWNER·ADMIN).
    * 쓰기 응답은 바뀐 사이트다. Cloudflare 반영은 커밋 뒤라 `provisioning.status`가 잠시 `PENDING`일 수 있다.
@@ -18199,7 +19150,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     runCheck: (body: RunStorefrontCheckRequest) => Promise<{
       checkId: string;
       check: string;
-      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "QUEUED" | "RUNNING" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -18213,7 +19164,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getCheck: (checkId: string) => Promise<{
       checkId: string;
       check: string;
-      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "QUEUED" | "RUNNING" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -18280,7 +19231,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string;
         versionId: string;
         versionNumber: number;
-        status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+        status: "FAILED" | "SUCCEEDED" | "QUEUED" | "RUNNING" | "TIMED_OUT";
         failureStage: string | null;
         errorCode: string | null;
         logTail: string | null;
@@ -18361,7 +19312,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       buildId: string;
       versionId: string;
       versionNumber: number;
-      status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+      status: "FAILED" | "SUCCEEDED" | "QUEUED" | "RUNNING" | "TIMED_OUT";
       failureStage: string | null;
       errorCode: string | null;
       logTail: string | null;
@@ -18439,7 +19390,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       buildId: string;
       versionId: string;
       versionNumber: number;
-      status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+      status: "FAILED" | "SUCCEEDED" | "QUEUED" | "RUNNING" | "TIMED_OUT";
       failureStage: string | null;
       errorCode: string | null;
       logTail: string | null;
@@ -18584,7 +19535,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         code: string;
         name: string;
       };
-      status: "ACTIVE" | "CANCELED" | "PAST_DUE" | "INCOMPLETE";
+      status: "ACTIVE" | "CANCELED" | "INCOMPLETE" | "PAST_DUE";
       interval: "MONTH" | null;
       cancelAtPeriodEnd: boolean;
       period: {
@@ -19501,6 +20452,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   category: "category";
   flow: "flow";
   analytics: "analytics";
+  storefront: "storefront";
   product: "product";
   order: "order";
   claim: "claim";
@@ -19513,7 +20465,6 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   customer: "customer";
   audit: "audit";
   promotion: "promotion";
-  storefront: "storefront";
 }>;
 /** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
 export declare function isStoreScope(scope: string): boolean;
@@ -19979,8 +20930,8 @@ export type ResponsePlanCode = PlanCode | (string & {});
 export declare const subscriptionStatusSchema: z.ZodEnum<{
   ACTIVE: "ACTIVE";
   CANCELED: "CANCELED";
-  PAST_DUE: "PAST_DUE";
   INCOMPLETE: "INCOMPLETE";
+  PAST_DUE: "PAST_DUE";
 }>;
 export type SubscriptionStatus = z.infer<typeof subscriptionStatusSchema>;
 export declare const subscriptionLimitsSchema: z.ZodObject<{
@@ -20030,8 +20981,8 @@ export declare const storeSubscriptionSchema: z.ZodObject<{
   status: z.ZodEnum<{
     ACTIVE: "ACTIVE";
     CANCELED: "CANCELED";
-    PAST_DUE: "PAST_DUE";
     INCOMPLETE: "INCOMPLETE";
+    PAST_DUE: "PAST_DUE";
   }>;
   interval: z.ZodNullable<z.ZodEnum<{
     MONTH: "MONTH";