npm - @sayren/store-sdk - Versions diffs - 0.30.13 → 0.30.15 - Mend

@sayren/store-sdk 0.30.13 → 0.30.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/dist/index.d.mts +1168 -197
package/dist/index.mjs +386 -11
package/package.json +1 -1
package/src/client.ts +59 -1
package/src/index.ts +1 -0
package/src/schemas/ai.ts +376 -0
package/src/schemas/app-manifest.ts +1 -1
package/src/schemas/apps.ts +1 -1
package/src/schemas/storefront-hosting.ts +30 -6
package/src/schemas/upload.ts +12 -1

package/dist/index.d.mts CHANGED Viewed

@@ -215,25 +215,25 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
 export declare const approvalStatusSchema: z.ZodEnum<{
-  PENDING: "PENDING";
   FAILED: "FAILED";
+  EXPIRED: "EXPIRED";
+  UNKNOWN: "UNKNOWN";
+  PENDING: "PENDING";
   SUCCEEDED: "SUCCEEDED";
   EXECUTING: "EXECUTING";
-  UNKNOWN: "UNKNOWN";
   REJECTED: "REJECTED";
-  EXPIRED: "EXPIRED";
 }>;
 export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
 export declare const approvalRequestSchema: z.ZodObject<{
   approvalId: z.ZodString;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     FAILED: "FAILED";
+    EXPIRED: "EXPIRED";
+    UNKNOWN: "UNKNOWN";
+    PENDING: "PENDING";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
-    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
-    EXPIRED: "EXPIRED";
   }>;
   operationId: z.ZodString;
   operationName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -291,13 +291,13 @@ export declare const approvalRequestSchema: z.ZodObject<{
 export type ApprovalRequest = z.infer<typeof approvalRequestSchema>;
 export declare const approvalListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodEnum<{
-    PENDING: "PENDING";
     FAILED: "FAILED";
+    EXPIRED: "EXPIRED";
+    UNKNOWN: "UNKNOWN";
+    PENDING: "PENDING";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
-    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
-    EXPIRED: "EXPIRED";
   }>>>>;
   cursor: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -310,13 +310,13 @@ export declare const approvalPageSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     approvalId: z.ZodString;
     status: z.ZodEnum<{
-      PENDING: "PENDING";
       FAILED: "FAILED";
+      EXPIRED: "EXPIRED";
+      UNKNOWN: "UNKNOWN";
+      PENDING: "PENDING";
       SUCCEEDED: "SUCCEEDED";
       EXECUTING: "EXECUTING";
-      UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
-      EXPIRED: "EXPIRED";
     }>;
     operationId: z.ZodString;
     operationName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -371,59 +371,862 @@ export declare const approvalPageSchema: z.ZodObject<{
     }, z.core.$strip>>;
     approvalUrl: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>>;
-  nextCursor: z.ZodNullable<z.ZodString>;
+  nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ApprovalPage = z.infer<typeof approvalPageSchema>;
+export declare const approvalDecisionRequestSchema: z.ZodObject<{
+  note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ApprovalDecisionRequest = z.infer<typeof approvalDecisionRequestSchema>;
+//#endregion
+//#region src/http.d.ts
+export declare class ApiError extends Error {
+  readonly status: number;
+  readonly code: string;
+  readonly traceId?: string | undefined;
+  readonly body?: unknown | undefined;
+  /** 엔벨로프 `$.error.details` — 에러 코드별 보조 데이터. 없으면 undefined */
+  readonly details?: Record<string, unknown> | undefined;
+  /** 엔벨로프 `$.error.docs` — 이 에러 코드를 설명하는 문서 URL. 매핑이 없으면 undefined */
+  readonly docs?: string | undefined;
+  constructor(status: number, code: string, message: string, traceId?: string | undefined, body?: unknown | undefined,
+  /** 엔벨로프 `$.error.details` — 에러 코드별 보조 데이터. 없으면 undefined */
+  details?: Record<string, unknown> | undefined,
+  /** 엔벨로프 `$.error.docs` — 이 에러 코드를 설명하는 문서 URL. 매핑이 없으면 undefined */
+  docs?: string | undefined);
+}
+/** 에이전트 쓰기가 승인 대기로 보류됐다(202) */
+export declare const APPROVAL_REQUIRED_CODE = "APPROVAL_REQUIRED";
+/** 같은 멱등키의 승인 요청이 이미 끝났다(200) — 결과는 승인 요청의 `status`·`result`다 */
+export declare const APPROVAL_ALREADY_DECIDED_CODE = "APPROVAL_ALREADY_DECIDED";
+/**
+ * 쓰기 요청이 실행되지 않고 승인 흐름에 걸렸다 (이슈 #36). 응답 `data`가 요청한 리소스가 아니라 승인 요청이라
+ * 성공 값으로 돌려주지 않는다 — 돌려주면 호출부가 승인 요청을 상품·주문으로 읽는다.
+ *
+ * - `code = APPROVAL_REQUIRED`(202): 에이전트의 고위험 쓰기가 보류됐다. 아직 아무것도 바뀌지 않았다.
+ *   셀러가 상점 플랫폼(`approval.approvalUrl`)에서 승인하면 서버가 원 요청을 실행한다. 같은 요청을 다시 보내지 말고
+ *   `approvalRequests.get(approvalId)`로 결과를 확인한다.
+ * - `code = APPROVAL_ALREADY_DECIDED`(200): 같은 멱등키로 보낸 요청의 승인이 이미 끝났다. `status`가
+ *   `SUCCEEDED`·`FAILED`·`UNKNOWN`이면 실행 결과(`approval.result`)를 보고, `REJECTED`·`EXPIRED`면 새 멱등키로 다시 요청한다.
+ */
+export declare class ApprovalPendingError extends Error {
+  readonly code: typeof APPROVAL_REQUIRED_CODE | typeof APPROVAL_ALREADY_DECIDED_CODE;
+  /** HTTP 상태 코드 (202·200) */
+  readonly httpStatus: number;
+  readonly approval: ApprovalRequest;
+  readonly approvalId: string;
+  /** 승인 요청 상태 */
+  readonly status: ApprovalStatus;
+  constructor(code: typeof APPROVAL_REQUIRED_CODE | typeof APPROVAL_ALREADY_DECIDED_CODE,
+  /** HTTP 상태 코드 (202·200) */
+  httpStatus: number, approval: ApprovalRequest, message: string);
+}
+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<{
+  QUEUED: "QUEUED";
+  RUNNING: "RUNNING";
+  CANCEL_REQUESTED: "CANCEL_REQUESTED";
+  DONE: "DONE";
+  FAILED: "FAILED";
+  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<{
+    QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
+    CANCEL_REQUESTED: "CANCEL_REQUESTED";
+    DONE: "DONE";
+    FAILED: "FAILED";
+    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<{
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
+      CANCEL_REQUESTED: "CANCEL_REQUESTED";
+      DONE: "DONE";
+      FAILED: "FAILED";
+      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<{
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
+      CANCEL_REQUESTED: "CANCEL_REQUESTED";
+      DONE: "DONE";
+      FAILED: "FAILED";
+      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<{
+  products: "products";
+  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";
+  shipping: "shipping";
+  addresses: "addresses";
+  payments: "payments";
+  login: "login";
+  members: "members";
+  order_flows: "order_flows";
+  webhooks: "webhooks";
+  storefront: "storefront";
+}>;
+export type AiFocusArea = z.infer<typeof aiFocusAreaSchema>;
+export declare const aiFocusSchema: z.ZodObject<{
+  area: z.ZodEnum<{
+    products: "products";
+    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";
+    shipping: "shipping";
+    addresses: "addresses";
+    payments: "payments";
+    login: "login";
+    members: "members";
+    order_flows: "order_flows";
+    webhooks: "webhooks";
+    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<{
+  APPLIED: "APPLIED";
+  INCOMPLETE: "INCOMPLETE";
+  REVERTING: "REVERTING";
+  REVERTED: "REVERTED";
+  REVERT_UNKNOWN: "REVERT_UNKNOWN";
+  EXPIRED: "EXPIRED";
+}>;
+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<{
+    APPLIED: "APPLIED";
+    INCOMPLETE: "INCOMPLETE";
+    REVERTING: "REVERTING";
+    REVERTED: "REVERTED";
+    REVERT_UNKNOWN: "REVERT_UNKNOWN";
+    EXPIRED: "EXPIRED";
+  }>;
+  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<{
+      APPLIED: "APPLIED";
+      INCOMPLETE: "INCOMPLETE";
+      REVERTING: "REVERTING";
+      REVERTED: "REVERTED";
+      REVERT_UNKNOWN: "REVERT_UNKNOWN";
+      EXPIRED: "EXPIRED";
+    }>;
+    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<{
+    APPLIED: "APPLIED";
+    INCOMPLETE: "INCOMPLETE";
+    REVERTING: "REVERTING";
+    REVERTED: "REVERTED";
+    REVERT_UNKNOWN: "REVERT_UNKNOWN";
+    EXPIRED: "EXPIRED";
+  }>;
+  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<{
+      CHANGED: "CHANGED";
+      UNKNOWN: "UNKNOWN";
+    }>;
+  }, 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<{
+      products: "products";
+      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";
+      shipping: "shipping";
+      addresses: "addresses";
+      payments: "payments";
+      login: "login";
+      members: "members";
+      order_flows: "order_flows";
+      webhooks: "webhooks";
+      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<{
+    QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
+    CANCEL_REQUESTED: "CANCEL_REQUESTED";
+    DONE: "DONE";
+    FAILED: "FAILED";
+    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<{
+        products: "products";
+        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";
+        shipping: "shipping";
+        addresses: "addresses";
+        payments: "payments";
+        login: "login";
+        members: "members";
+        order_flows: "order_flows";
+        webhooks: "webhooks";
+        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<{
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
+      CANCEL_REQUESTED: "CANCEL_REQUESTED";
+      DONE: "DONE";
+      FAILED: "FAILED";
+      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 ApprovalPage = z.infer<typeof approvalPageSchema>;
-export declare const approvalDecisionRequestSchema: z.ZodObject<{
-  note: z.ZodOptional<z.ZodString>;
+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 ApprovalDecisionRequest = z.infer<typeof approvalDecisionRequestSchema>;
-//#endregion
-//#region src/http.d.ts
-export declare class ApiError extends Error {
-  readonly status: number;
-  readonly code: string;
-  readonly traceId?: string | undefined;
-  readonly body?: unknown | undefined;
-  /** 엔벨로프 `$.error.details` — 에러 코드별 보조 데이터. 없으면 undefined */
-  readonly details?: Record<string, unknown> | undefined;
-  /** 엔벨로프 `$.error.docs` — 이 에러 코드를 설명하는 문서 URL. 매핑이 없으면 undefined */
-  readonly docs?: string | undefined;
-  constructor(status: number, code: string, message: string, traceId?: string | undefined, body?: unknown | undefined,
-  /** 엔벨로프 `$.error.details` — 에러 코드별 보조 데이터. 없으면 undefined */
-  details?: Record<string, unknown> | undefined,
-  /** 엔벨로프 `$.error.docs` — 이 에러 코드를 설명하는 문서 URL. 매핑이 없으면 undefined */
-  docs?: string | undefined);
-}
-/** 에이전트 쓰기가 승인 대기로 보류됐다(202) */
-export declare const APPROVAL_REQUIRED_CODE = "APPROVAL_REQUIRED";
-/** 같은 멱등키의 승인 요청이 이미 끝났다(200) — 결과는 승인 요청의 `status`·`result`다 */
-export declare const APPROVAL_ALREADY_DECIDED_CODE = "APPROVAL_ALREADY_DECIDED";
-/**
- * 쓰기 요청이 실행되지 않고 승인 흐름에 걸렸다 (이슈 #36). 응답 `data`가 요청한 리소스가 아니라 승인 요청이라
- * 성공 값으로 돌려주지 않는다 — 돌려주면 호출부가 승인 요청을 상품·주문으로 읽는다.
- *
- * - `code = APPROVAL_REQUIRED`(202): 에이전트의 고위험 쓰기가 보류됐다. 아직 아무것도 바뀌지 않았다.
- *   셀러가 상점 플랫폼(`approval.approvalUrl`)에서 승인하면 서버가 원 요청을 실행한다. 같은 요청을 다시 보내지 말고
- *   `approvalRequests.get(approvalId)`로 결과를 확인한다.
- * - `code = APPROVAL_ALREADY_DECIDED`(200): 같은 멱등키로 보낸 요청의 승인이 이미 끝났다. `status`가
- *   `SUCCEEDED`·`FAILED`·`UNKNOWN`이면 실행 결과(`approval.result`)를 보고, `REJECTED`·`EXPIRED`면 새 멱등키로 다시 요청한다.
- */
-export declare class ApprovalPendingError extends Error {
-  readonly code: typeof APPROVAL_REQUIRED_CODE | typeof APPROVAL_ALREADY_DECIDED_CODE;
-  /** HTTP 상태 코드 (202·200) */
-  readonly httpStatus: number;
-  readonly approval: ApprovalRequest;
-  readonly approvalId: string;
-  /** 승인 요청 상태 */
-  readonly status: ApprovalStatus;
-  constructor(code: typeof APPROVAL_REQUIRED_CODE | typeof APPROVAL_ALREADY_DECIDED_CODE,
-  /** HTTP 상태 코드 (202·200) */
-  httpStatus: number, approval: ApprovalRequest, message: string);
-}
-type TokenSource = string | null | undefined | (() => string | null | undefined);
-type Query = Record<string, string | number | boolean | undefined>;
-export declare function buildQuery(query?: Query): string;
+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<{
@@ -587,10 +1390,10 @@ export declare const analyticsProductsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
 export declare const analyticsChannelSchema: z.ZodEnum<{
+  UNKNOWN: "UNKNOWN";
   PAID: "PAID";
   DIRECT: "DIRECT";
   CAMPAIGN: "CAMPAIGN";
-  UNKNOWN: "UNKNOWN";
   ORGANIC_SEARCH: "ORGANIC_SEARCH";
   SOCIAL: "SOCIAL";
   EMAIL: "EMAIL";
@@ -621,10 +1424,10 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
 export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
 export declare const analyticsSourceRowSchema: z.ZodObject<{
   channel: z.ZodNullable<z.ZodEnum<{
+    UNKNOWN: "UNKNOWN";
     PAID: "PAID";
     DIRECT: "DIRECT";
     CAMPAIGN: "CAMPAIGN";
-    UNKNOWN: "UNKNOWN";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
     EMAIL: "EMAIL";
@@ -657,10 +1460,10 @@ export declare const analyticsSourcesSchema: z.ZodObject<{
   }>;
   rows: z.ZodArray<z.ZodObject<{
     channel: z.ZodNullable<z.ZodEnum<{
+      UNKNOWN: "UNKNOWN";
       PAID: "PAID";
       DIRECT: "DIRECT";
       CAMPAIGN: "CAMPAIGN";
-      UNKNOWN: "UNKNOWN";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
       EMAIL: "EMAIL";
@@ -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는 매니페스트 조각·동의 문단·넓어짐 판정(재동의 조건)을 한 곳에 둔다.
@@ -2866,10 +3669,10 @@ export declare const appInstallationRunSchema: z.ZodObject<{
   deliveryId: z.ZodString;
   eventType: z.ZodString;
   status: z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
-    FAILED: "FAILED";
   }>;
   errorCode: z.ZodNullable<z.ZodEnum<{
     TIMEOUT: "TIMEOUT";
@@ -2896,10 +3699,10 @@ export declare const appInstallationActivitySchema: z.ZodObject<{
     deliveryId: z.ZodString;
     eventType: z.ZodString;
     status: z.ZodEnum<{
+      FAILED: "FAILED";
       PENDING: "PENDING";
       PENDING_RETRY: "PENDING_RETRY";
       SUCCESS: "SUCCESS";
-      FAILED: "FAILED";
     }>;
     errorCode: z.ZodNullable<z.ZodEnum<{
       TIMEOUT: "TIMEOUT";
@@ -3140,10 +3943,10 @@ export type AppBuildStage = z.infer<typeof appBuildStageSchema>;
 export declare const appBuildSchema: z.ZodObject<{
   buildId: z.ZodString;
   status: z.ZodEnum<{
+    QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
-    RUNNING: "RUNNING";
-    QUEUED: "QUEUED";
     TIMED_OUT: "TIMED_OUT";
   }>;
   stages: z.ZodArray<z.ZodObject<{
@@ -3186,10 +3989,10 @@ export declare const appVersionSchema: z.ZodObject<{
   build: z.ZodNullable<z.ZodObject<{
     buildId: z.ZodString;
     status: z.ZodEnum<{
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
-      RUNNING: "RUNNING";
-      QUEUED: "QUEUED";
       TIMED_OUT: "TIMED_OUT";
     }>;
     stages: z.ZodArray<z.ZodObject<{
@@ -3337,10 +4140,10 @@ export declare const appReleaseResultSchema: z.ZodObject<{
     build: z.ZodNullable<z.ZodObject<{
       buildId: z.ZodString;
       status: z.ZodEnum<{
+        QUEUED: "QUEUED";
+        RUNNING: "RUNNING";
         FAILED: "FAILED";
         SUCCEEDED: "SUCCEEDED";
-        RUNNING: "RUNNING";
-        QUEUED: "QUEUED";
         TIMED_OUT: "TIMED_OUT";
       }>;
       stages: z.ZodArray<z.ZodObject<{
@@ -3430,11 +4233,11 @@ export declare const appInvocationSchema: z.ZodObject<{
   installationId: z.ZodString;
   versionNumber: z.ZodNullable<z.ZodNumber>;
   kind: z.ZodEnum<{
+    tool: "tool";
     event: "event";
     flow: "flow";
     http: "http";
     schedule: "schedule";
-    tool: "tool";
   }>;
   eventType: z.ZodNullable<z.ZodString>;
   outcome: z.ZodEnum<{
@@ -6231,10 +7034,10 @@ export declare const webhookSecretRotatedSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WebhookSecretRotated = z.infer<typeof webhookSecretRotatedSchema>;
 export declare const webhookDeliveryStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
   PENDING: "PENDING";
   PENDING_RETRY: "PENDING_RETRY";
   SUCCESS: "SUCCESS";
-  FAILED: "FAILED";
 }>;
 export type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>;
 export declare const webhookDeliveryErrorCodeSchema: z.ZodEnum<{
@@ -6304,10 +7107,10 @@ export declare const webhookDeliverySchema: z.ZodObject<{
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
-    FAILED: "FAILED";
   }>;
   responseStatusCode: z.ZodNullable<z.ZodNumber>;
   responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -6365,10 +7168,10 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
-    FAILED: "FAILED";
   }>;
   responseStatusCode: z.ZodNullable<z.ZodNumber>;
   responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -6409,10 +7212,10 @@ export type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>;
 /** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
 export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     PENDING_RETRY: "PENDING_RETRY";
     SUCCESS: "SUCCESS";
-    FAILED: "FAILED";
   }>>;
   eventType: z.ZodOptional<z.ZodEnum<{
     "ORDER.PAID": "ORDER.PAID";
@@ -7397,8 +8200,8 @@ export declare const pgEnvironmentSchema: z.ZodEnum<{
 }>;
 export type PgEnvironment = z.infer<typeof pgEnvironmentSchema>;
 export declare const pgVerificationResultSchema: z.ZodEnum<{
-  SUCCESS: "SUCCESS";
   FAILED: "FAILED";
+  SUCCESS: "SUCCESS";
 }>;
 export type PgVerificationResult = z.infer<typeof pgVerificationResultSchema>;
 /**
@@ -7547,8 +8350,8 @@ export declare const paymentCredentialSetSchema: z.ZodObject<{
   }, z.core.$strip>>;
   lastVerification: z.ZodNullable<z.ZodObject<{
     result: z.ZodEnum<{
-      SUCCESS: "SUCCESS";
       FAILED: "FAILED";
+      SUCCESS: "SUCCESS";
     }>;
     message: z.ZodNullable<z.ZodString>;
     checkedAt: z.ZodString;
@@ -7657,8 +8460,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
   }, z.core.$strip>>;
   lastVerification: z.ZodNullable<z.ZodObject<{
     result: z.ZodEnum<{
-      SUCCESS: "SUCCESS";
       FAILED: "FAILED";
+      SUCCESS: "SUCCESS";
     }>;
     message: z.ZodNullable<z.ZodString>;
     checkedAt: z.ZodString;
@@ -7694,8 +8497,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
       }, z.core.$strip>>;
       lastVerification: z.ZodNullable<z.ZodObject<{
         result: z.ZodEnum<{
-          SUCCESS: "SUCCESS";
           FAILED: "FAILED";
+          SUCCESS: "SUCCESS";
         }>;
         message: z.ZodNullable<z.ZodString>;
         checkedAt: z.ZodString;
@@ -7730,8 +8533,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
       }, z.core.$strip>>;
       lastVerification: z.ZodNullable<z.ZodObject<{
         result: z.ZodEnum<{
-          SUCCESS: "SUCCESS";
           FAILED: "FAILED";
+          SUCCESS: "SUCCESS";
         }>;
         message: z.ZodNullable<z.ZodString>;
         checkedAt: z.ZodString;
@@ -7823,8 +8626,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
     }, z.core.$strip>>;
     lastVerification: z.ZodNullable<z.ZodObject<{
       result: z.ZodEnum<{
-        SUCCESS: "SUCCESS";
         FAILED: "FAILED";
+        SUCCESS: "SUCCESS";
       }>;
       message: z.ZodNullable<z.ZodString>;
       checkedAt: z.ZodString;
@@ -7860,8 +8663,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
         }, z.core.$strip>>;
         lastVerification: z.ZodNullable<z.ZodObject<{
           result: z.ZodEnum<{
-            SUCCESS: "SUCCESS";
             FAILED: "FAILED";
+            SUCCESS: "SUCCESS";
           }>;
           message: z.ZodNullable<z.ZodString>;
           checkedAt: z.ZodString;
@@ -7896,8 +8699,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
         }, z.core.$strip>>;
         lastVerification: z.ZodNullable<z.ZodObject<{
           result: z.ZodEnum<{
-            SUCCESS: "SUCCESS";
             FAILED: "FAILED";
+            SUCCESS: "SUCCESS";
           }>;
           message: z.ZodNullable<z.ZodString>;
           checkedAt: z.ZodString;
@@ -7955,8 +8758,8 @@ export declare const paymentProviderVerificationSchema: z.ZodObject<{
     LIVE: "LIVE";
   }>;
   result: z.ZodEnum<{
-    SUCCESS: "SUCCESS";
     FAILED: "FAILED";
+    SUCCESS: "SUCCESS";
   }>;
   message: z.ZodNullable<z.ZodString>;
   checkedAt: z.ZodString;
@@ -8086,8 +8889,8 @@ export type SalesReport = z.infer<typeof salesReportSchema>;
  * - `FAILED`: 승인되지 않고 끝났다(거절·준비 장애·구매자 취소·만료)
  */
 export declare const paymentRecordStatusSchema: z.ZodEnum<{
-  PENDING: "PENDING";
   FAILED: "FAILED";
+  PENDING: "PENDING";
   APPROVED: "APPROVED";
   PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
   REFUNDED: "REFUNDED";
@@ -8134,8 +8937,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
   orderName: z.ZodString;
   customerName: z.ZodString;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     FAILED: "FAILED";
+    PENDING: "PENDING";
     APPROVED: "APPROVED";
     PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
     REFUNDED: "REFUNDED";
@@ -8182,8 +8985,8 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
     orderName: z.ZodString;
     customerName: z.ZodString;
     status: z.ZodEnum<{
-      PENDING: "PENDING";
       FAILED: "FAILED";
+      PENDING: "PENDING";
       APPROVED: "APPROVED";
       PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
       REFUNDED: "REFUNDED";
@@ -8275,8 +9078,8 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
   orderName: z.ZodString;
   customerName: z.ZodString;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     FAILED: "FAILED";
+    PENDING: "PENDING";
     APPROVED: "APPROVED";
     PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
     REFUNDED: "REFUNDED";
@@ -8890,8 +9693,8 @@ export declare const customInputRequestSchema: z.ZodObject<{
   key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   type: z.ZodOptional<z.ZodEnum<{
     number: "number";
-    date: "date";
     text: "text";
+    date: "date";
     select: "select";
     datetime: "datetime";
     image: "image";
@@ -9160,8 +9963,8 @@ export declare const optionModelRequestSchema: z.ZodObject<{
     key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodOptional<z.ZodEnum<{
       number: "number";
-      date: "date";
       text: "text";
+      date: "date";
       select: "select";
       datetime: "datetime";
       image: "image";
@@ -9334,8 +10137,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodOptional<z.ZodEnum<{
       number: "number";
-      date: "date";
       text: "text";
+      date: "date";
       select: "select";
       datetime: "datetime";
       image: "image";
@@ -9448,8 +10251,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodOptional<z.ZodEnum<{
       number: "number";
-      date: "date";
       text: "text";
+      date: "date";
       select: "select";
       datetime: "datetime";
       image: "image";
@@ -9681,8 +10484,8 @@ export declare const savedCustomInputRequestSchema: z.ZodObject<{
   key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   type: z.ZodOptional<z.ZodEnum<{
     number: "number";
-    date: "date";
     text: "text";
+    date: "date";
     select: "select";
     datetime: "datetime";
     image: "image";
@@ -9721,8 +10524,8 @@ export declare const savedOptionSetRequestSchema: z.ZodObject<{
     key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodOptional<z.ZodEnum<{
       number: "number";
-      date: "date";
       text: "text";
+      date: "date";
       select: "select";
       datetime: "datetime";
       image: "image";
@@ -10069,8 +10872,8 @@ export declare const invitationSchema: z.ZodObject<{
     STAFF: "STAFF";
   }>;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     EXPIRED: "EXPIRED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>;
@@ -10109,8 +10912,8 @@ export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSche
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 export declare const invitationListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
-    PENDING: "PENDING";
     EXPIRED: "EXPIRED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     CANCELED: "CANCELED";
   }>>;
@@ -10250,6 +11053,11 @@ export declare function isReservedStorefrontSlug(slug: string): boolean;
  * `test/storefront-hosting-parity.spec.ts`가 둘을 대조한다. 규칙을 바꾸면 두 곳을 같이 고친다.
  */
 export declare function storefrontEditPreviewLabelOf(siteId: string): string;
+/**
+ * 버전 미리보기 호스트 이름의 라벨 — 올라간 버전 하나를 보는 고유 주소(`sfs_ab12cd34`, 3 → `sfs-ab12cd34-v3-preview`). 편집 미리보기와 같은
+ * `-preview` 공간이라 슬러그가 될 수 없다. 복제본·대조는 `storefrontEditPreviewLabelOf`와 같다.
+ */
+export declare function storefrontVersionPreviewLabelOf(siteId: string, versionNumber: number): string;
 export declare const storefrontSlugSchema: z.ZodString;
 /** 바꾼 슬러그를 다른 사이트가 가져가지 못하게 막는 기간(일). 보류 동안 옛 주소는 새 주소로 301한다 */
 export declare const STOREFRONT_SLUG_HOLD_DAYS = 90;
@@ -10338,6 +11146,7 @@ export declare const storefrontVersionSchema: z.ZodObject<{
   createdByType: z.ZodString;
   createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
+  previewable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type StorefrontVersion = z.infer<typeof storefrontVersionSchema>;
 export declare const storefrontSiteStatusSchema: z.ZodEnum<{
@@ -10375,8 +11184,8 @@ export type StorefrontDomain = z.infer<typeof storefrontDomainSchema>;
  */
 export declare const storefrontProvisioningSchema: z.ZodObject<{
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     FAILED: "FAILED";
+    PENDING: "PENDING";
     SYNCED: "SYNCED";
   }>;
   lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -10460,11 +11269,12 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     createdByType: z.ZodString;
     createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
+    previewable: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
   provisioning: z.ZodObject<{
     status: z.ZodEnum<{
-      PENDING: "PENDING";
       FAILED: "FAILED";
+      PENDING: "PENDING";
       SYNCED: "SYNCED";
     }>;
     lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -10545,11 +11355,12 @@ export declare const storefrontHostingSchema: z.ZodObject<{
       createdByType: z.ZodString;
       createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       createdAt: z.ZodString;
+      previewable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     provisioning: z.ZodObject<{
       status: z.ZodEnum<{
-        PENDING: "PENDING";
         FAILED: "FAILED";
+        PENDING: "PENDING";
         SYNCED: "SYNCED";
       }>;
       lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -10596,10 +11407,10 @@ export declare const storefrontDeploymentStepSchema: z.ZodObject<{
     PUBLISH: "PUBLISH";
   }>;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
-    FAILED: "FAILED";
     RUNNING: "RUNNING";
     DONE: "DONE";
+    FAILED: "FAILED";
+    PENDING: "PENDING";
   }>;
   finishedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -10632,10 +11443,10 @@ export declare const storefrontDeploymentSchema: z.ZodObject<{
       PUBLISH: "PUBLISH";
     }>;
     status: z.ZodEnum<{
-      PENDING: "PENDING";
-      FAILED: "FAILED";
       RUNNING: "RUNNING";
       DONE: "DONE";
+      FAILED: "FAILED";
+      PENDING: "PENDING";
     }>;
     finishedAt: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>>;
@@ -10706,12 +11517,13 @@ export declare const storefrontSlugAvailabilityQuerySchema: z.ZodObject<{
   slug: z.ZodString;
 }, z.core.$strip>;
 /**
- * 오픈 준비 중 미리보기 링크 — 상점 플랫폼에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 링크는 5분 안에 한 번 열면
- * 그 브라우저에 12시간짜리 미리보기 쿠키가 생기고 오픈 준비 중인 사이트의 실제 화면을 본다. 링크를 남에게 넘기면 그 사람도
- * 볼 수 있으므로 공유하지 않는다.
+ * 버전 미리보기 링크 — 상점 플랫폼에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 버전마다 미리보기 전용 주소가 있고
+ * (오픈 준비 중이어도 실제 화면), 링크를 5분 안에 열면 그 브라우저에 그 주소 전용 12시간 쿠키가 생긴다. 사이트 주소는 오픈 전이면
+ * 누구에게나 「오픈 준비 중」이다. 미리보기 주소에 쿠키 없이 들어오면 상점 플랫폼 로그인과 OWNER·ADMIN 확인을 거친다.
  */
 export declare const createStorefrontPreviewLinkRequestSchema: z.ZodObject<{
   path: z.ZodOptional<z.ZodString>;
+  versionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CreateStorefrontPreviewLinkRequest = z.infer<typeof createStorefrontPreviewLinkRequestSchema>;
 export declare const storefrontPreviewLinkSchema: z.ZodObject<{
@@ -10754,8 +11566,8 @@ export declare function storefrontCustomHostnameProblem(hostname: string, hostin
 /** 소유 확인 TXT 레코드의 전체 이름 */
 export declare function storefrontDomainTxtNameOf(hostname: string): string;
 export declare const storefrontCustomDomainStatusSchema: z.ZodEnum<{
-  ACTIVE: "ACTIVE";
   FAILED: "FAILED";
+  ACTIVE: "ACTIVE";
   PENDING_DNS: "PENDING_DNS";
   PENDING_VALIDATION: "PENDING_VALIDATION";
 }>;
@@ -10781,8 +11593,8 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
     CUSTOM: "CUSTOM";
   }>;
   status: z.ZodEnum<{
-    ACTIVE: "ACTIVE";
     FAILED: "FAILED";
+    ACTIVE: "ACTIVE";
     PENDING_DNS: "PENDING_DNS";
     PENDING_VALIDATION: "PENDING_VALIDATION";
   }>;
@@ -10800,9 +11612,9 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
     }>;
   }, z.core.$strip>>;
   certificateStatus: z.ZodNullable<z.ZodEnum<{
+    FAILED: "FAILED";
     ACTIVE: "ACTIVE";
     PENDING: "PENDING";
-    FAILED: "FAILED";
   }>>;
   failureCode: z.ZodNullable<z.ZodString>;
   verifiedAt: z.ZodNullable<z.ZodString>;
@@ -10824,8 +11636,8 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
       CUSTOM: "CUSTOM";
     }>;
     status: z.ZodEnum<{
-      ACTIVE: "ACTIVE";
       FAILED: "FAILED";
+      ACTIVE: "ACTIVE";
       PENDING_DNS: "PENDING_DNS";
       PENDING_VALIDATION: "PENDING_VALIDATION";
     }>;
@@ -10843,9 +11655,9 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
       }>;
     }, z.core.$strip>>;
     certificateStatus: z.ZodNullable<z.ZodEnum<{
+      FAILED: "FAILED";
       ACTIVE: "ACTIVE";
       PENDING: "PENDING";
-      FAILED: "FAILED";
     }>>;
     failureCode: z.ZodNullable<z.ZodString>;
     verifiedAt: z.ZodNullable<z.ZodString>;
@@ -11079,10 +11891,10 @@ export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
 export declare const storefrontCheckStatusSchema: z.ZodEnum<{
+  QUEUED: "QUEUED";
+  RUNNING: "RUNNING";
   FAILED: "FAILED";
   UNKNOWN: "UNKNOWN";
-  RUNNING: "RUNNING";
-  QUEUED: "QUEUED";
   PASSED: "PASSED";
   TIMED_OUT: "TIMED_OUT";
 }>;
@@ -11093,10 +11905,10 @@ export declare const storefrontCheckSchema: z.ZodObject<{
   checkId: z.ZodString;
   check: z.ZodString;
   status: z.ZodEnum<{
+    QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
     FAILED: "FAILED";
     UNKNOWN: "UNKNOWN";
-    RUNNING: "RUNNING";
-    QUEUED: "QUEUED";
     PASSED: "PASSED";
     TIMED_OUT: "TIMED_OUT";
   }>;
@@ -11178,10 +11990,10 @@ export declare const storefrontVerifyReportSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StorefrontVerifyReport = z.infer<typeof storefrontVerifyReportSchema>;
 export declare const storefrontBuildStatusSchema: z.ZodEnum<{
+  QUEUED: "QUEUED";
+  RUNNING: "RUNNING";
   FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
-  RUNNING: "RUNNING";
-  QUEUED: "QUEUED";
   TIMED_OUT: "TIMED_OUT";
 }>;
 export type StorefrontBuildStatus = z.infer<typeof storefrontBuildStatusSchema>;
@@ -11246,10 +12058,10 @@ export declare const storefrontBuildSchema: z.ZodObject<{
   versionId: z.ZodString;
   versionNumber: z.ZodNumber;
   status: z.ZodEnum<{
+    QUEUED: "QUEUED";
+    RUNNING: "RUNNING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
-    RUNNING: "RUNNING";
-    QUEUED: "QUEUED";
     TIMED_OUT: "TIMED_OUT";
   }>;
   failureStage: z.ZodNullable<z.ZodString>;
@@ -11369,16 +12181,17 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
     createdByType: z.ZodString;
     createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
+    previewable: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>;
   build: z.ZodObject<{
     buildId: z.ZodString;
     versionId: z.ZodString;
     versionNumber: z.ZodNumber;
     status: z.ZodEnum<{
+      QUEUED: "QUEUED";
+      RUNNING: "RUNNING";
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
-      RUNNING: "RUNNING";
-      QUEUED: "QUEUED";
       TIMED_OUT: "TIMED_OUT";
     }>;
     failureStage: z.ZodNullable<z.ZodString>;
@@ -11472,7 +12285,7 @@ export type StorefrontVersionCreated = z.infer<typeof storefrontVersionCreatedSc
 export declare const createStorefrontEditPreviewLinkRequestSchema: z.ZodObject<{
   path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type CreateStorefrontEditPreviewLinkRequest = CreateStorefrontPreviewLinkRequest;
+export type CreateStorefrontEditPreviewLinkRequest = z.infer<typeof createStorefrontEditPreviewLinkRequestSchema>;
 /** 압축 파일 조각 하나의 최대 크기(바이트) */
 export declare const STOREFRONT_SOURCE_PART_BYTES: number;
 /** 내용 올리기 한 번의 최대 파일 수 */
@@ -11574,11 +12387,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 +12434,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>;
@@ -12523,7 +13339,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           value: true;
         } | {
           field: "bestSelling";
-          days: 30 | 7 | 90;
+          days: 7 | 30 | 90;
           top: number;
         } | {
           [x: string]: unknown;
@@ -12573,7 +13389,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 30 | 7 | 90;
+        days: 7 | 30 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -12616,7 +13432,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 30 | 7 | 90;
+        days: 7 | 30 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -12658,7 +13474,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 30 | 7 | 90;
+        days: 7 | 30 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -12721,7 +13537,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 30 | 7 | 90;
+        days: 7 | 30 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -12764,7 +13580,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 30 | 7 | 90;
+        days: 7 | 30 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -15309,7 +16125,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     sources: (params: AnalyticsSourcesParams) => Promise<{
       groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
       rows: {
-        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
+        channel: "UNKNOWN" | "PAID" | "DIRECT" | "CAMPAIGN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -15444,7 +16260,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         orderId: string | null;
         orderName: string;
         customerName: string;
-        status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
+        status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
         amount: number;
         refundedAmount: number;
         heldRefundAmount: number;
@@ -15470,7 +16286,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       orderId: string | null;
       orderName: string;
       customerName: string;
-      status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
+      status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
       amount: number;
       refundedAmount: number;
       heldRefundAmount: number;
@@ -15585,7 +16401,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           masked: string | null;
         }[];
         lastVerification: {
-          result: "SUCCESS" | "FAILED";
+          result: "FAILED" | "SUCCESS";
           message: string | null;
           checkedAt: string;
         } | null;
@@ -15610,7 +16426,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -15634,7 +16450,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -15695,7 +16511,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           masked: string | null;
         }[];
         lastVerification: {
-          result: "SUCCESS" | "FAILED";
+          result: "FAILED" | "SUCCESS";
           message: string | null;
           checkedAt: string;
         } | null;
@@ -15720,7 +16536,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -15744,7 +16560,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
               masked: string | null;
             }[];
             lastVerification: {
-              result: "SUCCESS" | "FAILED";
+              result: "FAILED" | "SUCCESS";
               message: string | null;
               checkedAt: string;
             } | null;
@@ -15810,7 +16626,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -15835,7 +16651,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -15859,7 +16675,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -15906,7 +16722,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -15931,7 +16747,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -15955,7 +16771,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -16012,7 +16828,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -16037,7 +16853,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -16061,7 +16877,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -16108,7 +16924,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -16133,7 +16949,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -16157,7 +16973,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -16213,7 +17029,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         masked: string | null;
       }[];
       lastVerification: {
-        result: "SUCCESS" | "FAILED";
+        result: "FAILED" | "SUCCESS";
         message: string | null;
         checkedAt: string;
       } | null;
@@ -16238,7 +17054,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -16262,7 +17078,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
             masked: string | null;
           }[];
           lastVerification: {
-            result: "SUCCESS" | "FAILED";
+            result: "FAILED" | "SUCCESS";
             message: string | null;
             checkedAt: string;
           } | null;
@@ -16290,7 +17106,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     verify: (provider: PgProvider, body?: VerifyPaymentProviderRequest) => Promise<{
       provider: "tosspayments" | "portone";
       environment: "TEST" | "LIVE";
-      result: "SUCCESS" | "FAILED";
+      result: "FAILED" | "SUCCESS";
       message: string | null;
       checkedAt: string;
     }>;
@@ -16734,7 +17550,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         runs: {
           deliveryId: string;
           eventType: string;
-          status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
+          status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
           errorCode: "TIMEOUT" | "CONNECTION_FAILED" | "BLOCKED_ADDRESS" | "NON_2XX" | "WEBHOOK_SUSPENDED" | "APP_ERROR" | "APP_LIMIT_EXCEEDED" | "APP_REJECTED" | "APP_UNCONFIGURED" | "APP_INACTIVE" | "APP_RUNNER_UNAVAILABLE" | null;
           attemptCount: number;
           createdAt: string;
@@ -16931,7 +17747,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       eventId: string;
       eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
       url: string;
-      status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
+      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -16958,7 +17774,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       eventId: string;
       eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
       url: string;
-      status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
+      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -16993,7 +17809,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       eventId: string;
       eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
       url: string;
-      status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
+      status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
@@ -17107,7 +17923,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+        status: "FAILED" | "EXPIRED" | "UNKNOWN" | "PENDING" | "SUCCEEDED" | "EXECUTING" | "REJECTED";
         operationId: string;
         method: string;
         path: string;
@@ -17159,7 +17975,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "FAILED" | "EXPIRED" | "UNKNOWN" | "PENDING" | "SUCCEEDED" | "EXECUTING" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -17213,7 +18029,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "FAILED" | "EXPIRED" | "UNKNOWN" | "PENDING" | "SUCCEEDED" | "EXECUTING" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -17263,7 +18079,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "FAILED" | "EXPIRED" | "UNKNOWN" | "PENDING" | "SUCCEEDED" | "EXECUTING" | "REJECTED";
       operationId: string;
       method: string;
       path: string;
@@ -17411,6 +18227,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: "QUEUED" | "RUNNING" | "CANCEL_REQUESTED" | "DONE" | "FAILED" | "CANCELLED";
+        errorCode: string | null;
+        createdAt: string;
+        finishedAt: string | null;
+        stream: {
+          streamId: string;
+          streamUrl: string;
+          streamToken: string;
+        };
+      } | null;
+      lastRun: {
+        id: string;
+        status: "QUEUED" | "RUNNING" | "CANCEL_REQUESTED" | "DONE" | "FAILED" | "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: "QUEUED" | "RUNNING" | "CANCEL_REQUESTED" | "DONE" | "FAILED" | "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: "APPLIED" | "INCOMPLETE" | "REVERTING" | "REVERTED" | "REVERT_UNKNOWN" | "EXPIRED";
+        files: {
+          path: string;
+          change: "created" | "modified" | "deleted";
+        }[];
+      }[];
+    }>;
+    /** `GET /v1/ai/runs/{id}/file-changes` — 실행 하나의 변경 내용(이전·이후) */
+    getRunFileDiff: (runId: string) => Promise<{
+      runId: string;
+      status: "APPLIED" | "INCOMPLETE" | "REVERTING" | "REVERTED" | "REVERT_UNKNOWN" | "EXPIRED";
+      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`일 수 있다.
@@ -17484,9 +18445,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
           createdByType: string;
           createdAt: string;
           createdVia?: string | null | undefined;
+          previewable?: boolean | undefined;
         } | null;
         provisioning: {
-          status: "PENDING" | "FAILED" | "SYNCED";
+          status: "FAILED" | "PENDING" | "SYNCED";
           lastErrorCode: string | null;
           syncedAt: string | null;
         };
@@ -17547,9 +18509,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       } | null;
       provisioning: {
-        status: "PENDING" | "FAILED" | "SYNCED";
+        status: "FAILED" | "PENDING" | "SYNCED";
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
@@ -17578,7 +18541,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       finishedAt: string | null;
       steps: {
         key: "SITE" | "UPLOAD" | "PUBLISH";
-        status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
+        status: "RUNNING" | "DONE" | "FAILED" | "PENDING";
         finishedAt: string | null;
       }[];
       log: {
@@ -17600,7 +18563,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       finishedAt: string | null;
       steps: {
         key: "SITE" | "UPLOAD" | "PUBLISH";
-        status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
+        status: "RUNNING" | "DONE" | "FAILED" | "PENDING";
         finishedAt: string | null;
       }[];
       log: {
@@ -17648,9 +18611,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       } | null;
       provisioning: {
-        status: "PENDING" | "FAILED" | "SYNCED";
+        status: "FAILED" | "PENDING" | "SYNCED";
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
@@ -17685,6 +18649,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       createdByType: string;
       createdAt: string;
       createdVia?: string | null | undefined;
+      previewable?: boolean | undefined;
     }[]>;
     /** `POST /v1/storefront/site/versions/{versionId}/publish` — 그 버전을 발행한다(이미 발행돼 있으면 그대로 200) */
     publish: (versionId: string, body?: PublishStorefrontVersionRequest) => Promise<{
@@ -17717,9 +18682,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       } | null;
       provisioning: {
-        status: "PENDING" | "FAILED" | "SYNCED";
+        status: "FAILED" | "PENDING" | "SYNCED";
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
@@ -17770,9 +18736,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       } | null;
       provisioning: {
-        status: "PENDING" | "FAILED" | "SYNCED";
+        status: "FAILED" | "PENDING" | "SYNCED";
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
@@ -17823,9 +18790,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       } | null;
       provisioning: {
-        status: "PENDING" | "FAILED" | "SYNCED";
+        status: "FAILED" | "PENDING" | "SYNCED";
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
@@ -17876,9 +18844,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       } | null;
       provisioning: {
-        status: "PENDING" | "FAILED" | "SYNCED";
+        status: "FAILED" | "PENDING" | "SYNCED";
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
@@ -17899,7 +18868,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | null | undefined;
     }>;
     /**
-     * `POST /v1/storefront/site/preview-link` — 오픈 준비 중인 사이트를 구성원이 볼 수 있는 5분짜리 링크.
+     * `POST /v1/storefront/site/preview-link` — 버전 미리보기 주소로 여는 5분짜리 링크(기본은 발행 버전, `versionId`로 다른 버전).
      * 상점 플랫폼에서 로그인한 OWNER·ADMIN만 받는다
      */
     createPreviewLink: (body?: CreateStorefrontPreviewLinkRequest) => Promise<{
@@ -17915,7 +18884,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         domainId: string;
         hostname: string;
         kind: "PLATFORM" | "CUSTOM";
-        status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+        status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
         isPrimary: boolean;
         dnsRecords: {
           type: "CNAME" | "TXT";
@@ -17923,7 +18892,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           value: string;
           purpose: "ROUTING" | "OWNERSHIP";
         }[];
-        certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+        certificateStatus: "FAILED" | "ACTIVE" | "PENDING" | null;
         failureCode: string | null;
         verifiedAt: string | null;
         activatedAt: string | null;
@@ -17939,7 +18908,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       domainId: string;
       hostname: string;
       kind: "PLATFORM" | "CUSTOM";
-      status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+      status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
       isPrimary: boolean;
       dnsRecords: {
         type: "CNAME" | "TXT";
@@ -17947,7 +18916,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: string;
         purpose: "ROUTING" | "OWNERSHIP";
       }[];
-      certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+      certificateStatus: "FAILED" | "ACTIVE" | "PENDING" | null;
       failureCode: string | null;
       verifiedAt: string | null;
       activatedAt: string | null;
@@ -17959,7 +18928,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       domainId: string;
       hostname: string;
       kind: "PLATFORM" | "CUSTOM";
-      status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+      status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
       isPrimary: boolean;
       dnsRecords: {
         type: "CNAME" | "TXT";
@@ -17967,7 +18936,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: string;
         purpose: "ROUTING" | "OWNERSHIP";
       }[];
-      certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+      certificateStatus: "FAILED" | "ACTIVE" | "PENDING" | null;
       failureCode: string | null;
       verifiedAt: string | null;
       activatedAt: string | null;
@@ -17983,7 +18952,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         domainId: string;
         hostname: string;
         kind: "PLATFORM" | "CUSTOM";
-        status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+        status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
         isPrimary: boolean;
         dnsRecords: {
           type: "CNAME" | "TXT";
@@ -17991,7 +18960,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           value: string;
           purpose: "ROUTING" | "OWNERSHIP";
         }[];
-        certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+        certificateStatus: "FAILED" | "ACTIVE" | "PENDING" | null;
         failureCode: string | null;
         verifiedAt: string | null;
         activatedAt: string | null;
@@ -18032,9 +19001,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       } | null;
       provisioning: {
-        status: "PENDING" | "FAILED" | "SYNCED";
+        status: "FAILED" | "PENDING" | "SYNCED";
         lastErrorCode: string | null;
         syncedAt: string | null;
       };
@@ -18199,7 +19169,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     runCheck: (body: RunStorefrontCheckRequest) => Promise<{
       checkId: string;
       check: string;
-      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "QUEUED" | "RUNNING" | "FAILED" | "UNKNOWN" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -18213,7 +19183,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getCheck: (checkId: string) => Promise<{
       checkId: string;
       check: string;
-      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "QUEUED" | "RUNNING" | "FAILED" | "UNKNOWN" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -18275,12 +19245,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        previewable?: boolean | undefined;
       };
       build: {
         buildId: string;
         versionId: string;
         versionNumber: number;
-        status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+        status: "QUEUED" | "RUNNING" | "FAILED" | "SUCCEEDED" | "TIMED_OUT";
         failureStage: string | null;
         errorCode: string | null;
         logTail: string | null;
@@ -18361,7 +19332,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       buildId: string;
       versionId: string;
       versionNumber: number;
-      status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+      status: "QUEUED" | "RUNNING" | "FAILED" | "SUCCEEDED" | "TIMED_OUT";
       failureStage: string | null;
       errorCode: string | null;
       logTail: string | null;
@@ -18439,7 +19410,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       buildId: string;
       versionId: string;
       versionNumber: number;
-      status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
+      status: "QUEUED" | "RUNNING" | "FAILED" | "SUCCEEDED" | "TIMED_OUT";
       failureStage: string | null;
       errorCode: string | null;
       logTail: string | null;
@@ -18584,7 +19555,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         code: string;
         name: string;
       };
-      status: "ACTIVE" | "CANCELED" | "PAST_DUE" | "INCOMPLETE";
+      status: "INCOMPLETE" | "ACTIVE" | "CANCELED" | "PAST_DUE";
       interval: "MONTH" | null;
       cancelAtPeriodEnd: boolean;
       period: {
@@ -18856,7 +19827,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -18874,7 +19845,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -18889,7 +19860,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      status: "EXPIRED" | "PENDING" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -19498,6 +20469,7 @@ export declare const STORE_SCOPE_RESOURCES: {
 };
 export type StoreScopeResource = keyof typeof STORE_SCOPE_RESOURCES;
 export declare const storeScopeResourceSchema: z.ZodEnum<{
+  storefront: "storefront";
   category: "category";
   flow: "flow";
   analytics: "analytics";
@@ -19513,7 +20485,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;
@@ -19977,10 +20948,10 @@ export declare const responsePlanCodeSchema: z.ZodUnion<readonly [z.ZodEnum<{
 }>, z.ZodString]>;
 export type ResponsePlanCode = PlanCode | (string & {});
 export declare const subscriptionStatusSchema: z.ZodEnum<{
+  INCOMPLETE: "INCOMPLETE";
   ACTIVE: "ACTIVE";
   CANCELED: "CANCELED";
   PAST_DUE: "PAST_DUE";
-  INCOMPLETE: "INCOMPLETE";
 }>;
 export type SubscriptionStatus = z.infer<typeof subscriptionStatusSchema>;
 export declare const subscriptionLimitsSchema: z.ZodObject<{
@@ -20028,10 +20999,10 @@ export declare const storeSubscriptionSchema: z.ZodObject<{
     name: z.ZodString;
   }, z.core.$strip>;
   status: z.ZodEnum<{
+    INCOMPLETE: "INCOMPLETE";
     ACTIVE: "ACTIVE";
     CANCELED: "CANCELED";
     PAST_DUE: "PAST_DUE";
-    INCOMPLETE: "INCOMPLETE";
   }>;
   interval: z.ZodNullable<z.ZodEnum<{
     MONTH: "MONTH";