@sayren/store-sdk 0.30.16 → 0.30.18

package/dist/server.d.mts

@@ -23,7 +23,7 @@ export declare class MemberDelegationError extends Error {
  * `customer:rw`가 필요하다. `uid`(셀러 자체 인증의 사용자 id) 또는 `email`로 지목하고, 처음 보는 사용자면 구매자를 만든다.
  */
 export declare function delegateMember(options: {
-  /** api 주소(예: `https://api.sayren.app`) */
+  /** api 주소(예: `https://api.sayren.io`) */
   baseUrl: string;
   accessToken: string;
   storeId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.30.16",
+  "version": "0.30.18",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/client.ts

@@ -284,6 +284,7 @@ import {
   savedOptionSetRequestSchema,
   savedOptionSetSchema,
 } from "./schemas/saved-option-set";
+import { starterStatusSchema } from "./schemas/starter";
 import {
   calendarDaySchema,
   calendarQuerySchema,
@@ -1860,6 +1861,8 @@ export function createStoreClient(options: StoreClientOptions) {
         storeHttp.request("POST", "/storefront/site/preview-link", storefrontPreviewLinkSchema, {
           body: createStorefrontPreviewLinkRequestSchema.parse(body),
         }),
+      /** `GET /v1/storefront/starter` — 쇼핑몰 만들기 진행 상태(서버 상태로 계산한 단계·셀러 항목, 공개 문서 제외) */
+      getStarterStatus: () => storeHttp.request("GET", "/storefront/starter", starterStatusSchema),
       /** `GET /v1/storefront/site/domains` — 주소 목록(기본 주소 + 내 도메인)과 DNS 안내 */
       listDomains: () =>
         storeHttp.request("GET", "/storefront/site/domains", storefrontSiteDomainsSchema),

package/src/member-delegation.ts

@@ -28,7 +28,7 @@ export class MemberDelegationError extends Error {
  * `customer:rw`가 필요하다. `uid`(셀러 자체 인증의 사용자 id) 또는 `email`로 지목하고, 처음 보는 사용자면 구매자를 만든다.
  */
 export async function delegateMember(options: {
-  /** api 주소(예: `https://api.sayren.app`) */
+  /** api 주소(예: `https://api.sayren.io`) */
   baseUrl: string;
   accessToken: string;
   storeId: string;

package/src/oauth.ts

@@ -30,7 +30,7 @@ export async function createPkcePair(): Promise<{ verifier: string; challenge: s
 }
 
 export interface AuthorizeUrlOptions {
-  /** authorize 엔드포인트 전체 주소(예: `https://accounts.sayren.app/api/auth/oauth2/authorize`) */
+  /** authorize 엔드포인트 전체 주소(예: `https://accounts.sayren.io/api/auth/oauth2/authorize`) */
   authorizeUrl: string;
   clientId: string;
   redirectUri: string;
@@ -59,6 +59,12 @@ export function buildAuthorizeUrl(options: AuthorizeUrlOptions): string {
   return url.toString();
 }
 
+/**
+ * 토큰 요청 상한 — 응답 없는 요청이 끝나지 않으면 refresh가 탭 간 잠금(`sayren.store.refresh`)을 쥔 채 멈추고, 그 잠금을 기다리는 모든 API 호출이
+ * 같이 멈춘다(2026-10-12 상점 만들기 버튼이 진행 표시로 굳었다). 넘으면 실패로 끝낸다
+ */
+export const TOKEN_REQUEST_TIMEOUT_MS = 15_000;
+
 async function tokenRequest(
   endpoint: string,
   form: Record<string, string>,
@@ -69,6 +75,10 @@ async function tokenRequest(
     method: "POST",
     headers: { "content-type": "application/x-www-form-urlencoded" },
     body: new URLSearchParams(form).toString(),
+    // AbortSignal.timeout이 없는 런타임은 제한 없이 보낸다
+    ...(typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function"
+      ? { signal: AbortSignal.timeout(TOKEN_REQUEST_TIMEOUT_MS) }
+      : {}),
   });
   const json: unknown = await response.json().catch(() => null);
   if (!response.ok) {

package/src/schemas/ai.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { storefrontSlugSchema } from "./storefront-hosting";
 
 /**
  * 상점 플랫폼 AI 채팅(이슈 #124) — 대화·메시지·실행과 실행 이벤트 스트림의 계약.
@@ -72,13 +73,85 @@ export const aiRunSchema = z.object({
 });
 export type AiRun = z.infer<typeof aiRunSchema>;
 
+/**
+ * AI가 지금 하는 일의 종류 — 도구 이름·operationId·파일 경로로 서버가 정한다(상점 만들기 진행 화면이 아이콘·문구를 고른다). 정하지 못한 도구는 없다
+ */
+export const aiActivitySchema = z.enum([
+  "status",
+  "brief",
+  "template",
+  "site",
+  "info",
+  "shipping",
+  "upload",
+  "design",
+  "category",
+  "product",
+  "files",
+  "code",
+  "check",
+  "verify",
+  "version",
+  "preview",
+]);
+export type AiActivity = z.infer<typeof aiActivitySchema>;
+
+/**
+ * 도구가 바꾼 파일 하나(2026-10-13, AI 상점 도우미 작업 공간의 수정 중인 코드) — 서버가 도구 입력으로 계산한다.
+ * `edit`는 바꾼 부분의 줄 비교, `write`는 새로 쓴 내용(이전 내용을 모르므로 모두 추가로 센다). `preview`는 바뀐 줄 앞부분 12줄까지다
+ */
+export const aiToolChangeSchema = z.object({
+  path: z.string().max(300),
+  mode: z.enum(["edit", "write"]),
+  added: z.number().int().min(0),
+  removed: z.number().int().min(0),
+  preview: z
+    .array(z.object({ kind: z.enum(["added", "removed"]), text: z.string().max(300) }))
+    .max(12),
+});
+export type AiToolChange = z.infer<typeof aiToolChangeSchema>;
+
+/**
+ * 에이전트 작업 단계(2026-10-13, AI 상점 도우미 작업 공간) — 에이전트가 패널 도구로 알린다.
+ * 상점·상품·배포 준비 → 쇼핑몰 구조 설계 → 개발 환경 준비(라이브러리·SDK) → 코드 수정 루프 → 완료
+ */
+export const AI_AGENT_PHASES = ["STORE", "STRUCTURE", "ENVIRONMENT", "BUILD", "DONE"] as const;
+export const aiAgentPhaseSchema = z.enum(AI_AGENT_PHASES);
+export type AiAgentPhase = z.infer<typeof aiAgentPhaseSchema>;
+
+/**
+ * AI 상점 도우미의 작업 메모 폴더(2026-10-14) — 회차마다 읽는 숨은 규칙(`rules.md`)과 디자인 계획(`design.md`). 셀러 화면(타임라인·코드 탭·변경 기록)에
+ * 보이지 않는다. 편집 Sandbox가 점(.)으로 시작하는 경로를 받지 않아 작업 트리의 `src` 아래에 둔다(앱이 import하지 않는 문서라 빌드에 들어가지 않는다)
+ */
+export const AI_AGENT_NOTES_DIR = "src/site/agent";
+
+/**
+ * 에이전트의 할 일 목록(2026-10-14, Claude Code TodoWrite와 같은 루프) — 에이전트가 패널 도구 `update_todos`로 목록 전체를 바꿔 쓴다.
+ * 작업 공간 왼쪽 패널이 마지막 목록을 체크리스트로 그린다. 진행중은 한 번에 하나다
+ */
+export const AI_TODO_STATUSES = ["pending", "in_progress", "completed"] as const;
+export const aiTodoSchema = z.object({
+  content: z.string().min(1).max(200),
+  status: z.enum(AI_TODO_STATUSES),
+});
+export type AiTodo = z.infer<typeof aiTodoSchema>;
+export const AI_TODOS_MAX = 30;
+
+export function isAiAgentNotesPath(path: string): boolean {
+  return path === AI_AGENT_NOTES_DIR || path.startsWith(`${AI_AGENT_NOTES_DIR}/`);
+}
+
 /**
  * 화면에 그리는 메시지 조각. 모델 원문(tool_use 블록 등)은 api가 보관하고 화면에는 이 형태만 준다.
  * - `text`: 글
  * - `tool`: 도구 호출 한 번(이름은 사람이 읽는 라벨, 결과 요약·링크)
  * - `choices`: 선택지 버튼(가장 최근 것만 누를 수 있다)
+ * - `business_form`: 사업자 정보 입력 폼(가장 최근 것만 제출할 수 있다, 건너뛸 수 있다)
  * - `attachment`: 사용자가 올린 첨부
  * - `approval`: 승인 대기로 남은 쓰기
+ * - `reasoning`: 모델의 생각 요약(2026-10-13, AI 상점 도우미 작업 공간이 도구 호출과 따로 표시한다)
+ * - `phase`: 에이전트가 알린 작업 단계(작업 공간의 단계 표시)
+ * - `todos`: 에이전트의 할 일 목록 전체(작업 공간의 체크리스트)
  */
 export const aiMessagePartSchema = z.discriminatedUnion("type", [
   z.object({ type: z.literal("text"), text: z.string() }),
@@ -89,6 +162,12 @@ export const aiMessagePartSchema = z.discriminatedUnion("type", [
     label: z.string(),
     status: z.enum(["ok", "error", "unknown"]),
     summary: z.string().nullable(),
+    /** 하는 일의 종류(`aiActivitySchema`, 정하지 못했거나 옛 메시지면 없다) */
+    activity: aiActivitySchema.optional(),
+    /** 도구 대상 — 파일 경로나 검색어(파일 도구만) */
+    target: z.string().max(300).optional(),
+    /** 바꾼 파일(파일 쓰기 도구만) */
+    changes: z.array(aiToolChangeSchema).max(10).optional(),
   }),
   z.object({
     type: z.literal("choices"),
@@ -98,11 +177,16 @@ export const aiMessagePartSchema = z.discriminatedUnion("type", [
       .min(1)
       .max(6),
   }),
+  z.object({ type: z.literal("business_form"), question: z.string() }),
   z.object({ type: z.literal("attachment"), attachment: aiAttachmentSchema }),
   /** 공개 뒤 승인이 필요한 쓰기를 승인 요청으로 남겼다(셀러가 승인함에서 결정한다) */
   z.object({ type: z.literal("approval"), approvalId: z.string(), title: z.string() }),
   /** 사용자가 미리보기에서 고른 요소(#65) */
   z.object({ type: z.literal("selection"), selection: aiPreviewSelectionSchema }),
+  z.object({ type: z.literal("reasoning"), text: z.string() }),
+  z.object({ type: z.literal("phase"), phase: aiAgentPhaseSchema }),
+  /** 에이전트의 할 일 목록 — 그 시점의 목록 전체다(가장 최근 것이 지금 목록) */
+  z.object({ type: z.literal("todos"), todos: z.array(aiTodoSchema).max(AI_TODOS_MAX) }),
 ]);
 export type AiMessagePart = z.infer<typeof aiMessagePartSchema>;
 
@@ -132,9 +216,38 @@ export const aiConversationSchema = aiConversationSummarySchema.extend({
 });
 export type AiConversation = z.infer<typeof aiConversationSchema>;
 
+/** 쇼핑몰 형태(#124, 2026-10-13) — 템플릿은 basic 하나이고 형태는 에이전트에게 주는 화면 구성 지시다 */
+export const STORE_SHOP_TYPES = [
+  "BASIC",
+  "INTERACTIVE",
+  "STORYTELLING",
+  "MOBILE",
+  "CATALOG",
+  "LOOKBOOK",
+] as const;
+export const storeShopTypeSchema = z.enum(STORE_SHOP_TYPES);
+export type StoreShopType = z.infer<typeof storeShopTypeSchema>;
+
+/**
+ * AI 상점 만들기 질문 화면의 답(#124, 2026-10-13) — 화면이 고정 질문으로 모은다. 초안과 함께 첫 메시지가 된다.
+ * 배송비는 묻지 않는다(설정하지 않으면 무료배송). `slug`는 바라는 주소이고 쓸 수 있는지는 에이전트가 사이트를 만들 때 확인한다
+ */
+export const storeSetupBriefSchema = z.object({
+  products: z.string().trim().min(1).max(500).describe("판매 상품"),
+  storeName: z.string().trim().min(1).max(50).describe("쇼핑몰 이름"),
+  audience: z.string().trim().min(1).max(300).describe("주요 고객"),
+  highlights: z.string().trim().max(500).describe("강조할 특징 (비우면 AI가 정한다)"),
+  shopType: storeShopTypeSchema.describe("쇼핑몰 형태"),
+  heroProduct: z.string().trim().max(500).describe("첫 화면에 크게 걸 상품 (비우면 AI가 정한다)"),
+  slug: storefrontSlugSchema.optional().describe("바라는 스토어프론트 주소"),
+});
+export type StoreSetupBrief = z.infer<typeof storeSetupBriefSchema>;
+
 export const createAiConversationRequestSchema = z.object({
   /** 웹사이트에서 남긴 초안(#124 M2) — 연결한 사용자만 쓴다. 주면 첫 메시지로 실행을 시작한다 */
   draftId: z.string().max(64).optional(),
+  /** 질문 화면의 답 — `draftId`와 함께만 쓴다. 초안 앞에 붙어 첫 메시지가 된다 */
+  brief: storeSetupBriefSchema.optional(),
 });
 export type CreateAiConversationRequest = z.infer<typeof createAiConversationRequestSchema>;
 
@@ -279,6 +392,16 @@ export type AiRunRevertConflictDetails = z.infer<typeof aiRunRevertConflictDetai
 export const aiStreamEventSchema = z.discriminatedUnion("type", [
   /** 글 조각(약 100ms 묶음). 같은 `messageId`의 `text`에 이어 붙인다 */
   z.object({ type: z.literal("delta"), messageId: z.string(), text: z.string() }),
+  /** 생각 요약 조각 — 같은 `messageId`의 생각에 이어 붙인다(글과 따로 표시한다) */
+  z.object({ type: z.literal("reasoning_delta"), messageId: z.string(), text: z.string() }),
+  /** 에이전트가 작업 단계를 알렸다 */
+  z.object({ type: z.literal("phase"), messageId: z.string(), phase: aiAgentPhaseSchema }),
+  /** 에이전트가 할 일 목록을 바꿔 썼다(목록 전체) */
+  z.object({
+    type: z.literal("todos"),
+    messageId: z.string(),
+    todos: z.array(aiTodoSchema).max(AI_TODOS_MAX),
+  }),
   z.object({
     type: z.literal("tool_start"),
     messageId: z.string(),
@@ -287,6 +410,10 @@ export const aiStreamEventSchema = z.discriminatedUnion("type", [
     label: z.string(),
     /** 쓰기 도구가 바꾸는 화면(읽기 도구는 없다) */
     focus: aiFocusSchema.optional(),
+    /** 하는 일의 종류(정하지 못한 도구는 없다) */
+    activity: aiActivitySchema.optional(),
+    target: z.string().max(300).optional(),
+    changes: z.array(aiToolChangeSchema).max(10).optional(),
   }),
   z.object({
     type: z.literal("tool_result"),
@@ -301,6 +428,8 @@ export const aiStreamEventSchema = z.discriminatedUnion("type", [
     question: z.string(),
     options: z.array(z.object({ label: z.string(), value: z.string() })),
   }),
+  /** 사업자 정보 입력 폼을 보였다 — 답은 다음 메시지로 온다 */
+  z.object({ type: z.literal("business_form"), messageId: z.string(), question: z.string() }),
   /** 공개 뒤 승인이 필요한 쓰기를 승인 요청으로 남겼다 */
   z.object({
     type: z.literal("approval"),

package/src/schemas/app-manifest.ts

@@ -170,6 +170,7 @@ export function scopesCoverEvent(scopes: readonly string[], event: AppEventType)
 const HOST_LABEL = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
 const TLD = /^(?:[a-z]{2,63}|xn--[a-z0-9-]{1,59})$/;
 export const APP_NETWORK_DENIED_SUFFIXES: readonly string[] = [
+  "sayren.io",
   "sayren.app",
   "sayren.co",
   "avarlabs.com",

package/src/schemas/apps.ts

@@ -544,7 +544,7 @@ export const appInvocationSchema = z.object({
 });
 export type AppInvocation = z.infer<typeof appInvocationSchema>;
 
-/** 앱 배포 키(developer.sayren.app 「키 발행」) — 값은 만들 때 한 번만 보인다 */
+/** 앱 배포 키(developer.sayren.io 「키 발행」) — 값은 만들 때 한 번만 보인다 */
 export const appDeployKeySchema = z.object({
   keyId: z.string(),
   name: z.string(),

package/src/schemas/storefront-hosting.ts

@@ -590,6 +590,7 @@ export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
  */
 export const STOREFRONT_PLATFORM_DOMAINS: readonly string[] = [
   "sayren.co",
+  "sayren.io",
   "sayren.app",
   "sayren.shop",
   "avarlabs.com",

package/src/session.ts

@@ -39,7 +39,7 @@ const REVOKE_TIMEOUT_MS = 5_000;
 const REFRESH_LOCK = STORE_SESSION_KEYS.refresh;
 
 /**
- * 인가 서버(Sayren 계정, accounts) 주소 — `https://accounts.sayren.app/api/auth/oauth2/{authorize,token,revoke}`.
+ * 인가 서버(Sayren 계정, accounts) 주소 — `https://accounts.sayren.io/api/auth/oauth2/{authorize,token,revoke}`.
  * `resource`를 주면 authorize·code 교환·refresh에 RFC 8707 `resource`를 싣는다(JWT access token의 `aud`).
  */
 export interface StoreAuthServer {