@sayren/mcp 0.4.0 → 0.5.1

package/dist/index.mjs

@@ -19,13 +19,17 @@ const METHODS = [
 	"DELETE"
 ];
 /**
-* 돈이 나가는 쓰기 — 되돌릴 수 없으므로 에이전트에게 열지 않는다. 콘솔에서 사람이 한다.
-* 목록은 operationId(`{Controller}_{method}`)로 고정한다.
+* 서버가 정책(`x-agent-policy`)을 싣지 않는 옛 api에만 쓰는 폴백 — 환불로 이어지는 쓰기를 막는다.
+* 새 api는 문서의 정책이 원천이고 이 목록은 보지 않는다(승인 흐름으로 부를 수 있다).
 */
-const BLOCKED_OPERATIONS = {
+const LEGACY_BLOCKED_OPERATIONS = {
 	OrdersController_cancelBySeller: "셀러 직권취소는 PG 환불로 이어져 되돌릴 수 없다. 셀러 콘솔에서 처리한다",
 	ClaimsController_approve: "클레임 승인은 환불로 이어져 되돌릴 수 없다. 셀러 콘솔에서 처리한다"
 };
+/** 문서가 에이전트 정책을 싣는 api인가 — 하나라도 있으면 서버가 정책을 강제한다 */
+function servesAgentPolicy(document) {
+	return Object.values(document.paths ?? {}).some((item) => Object.values(item).some((operation) => operation?.["x-agent-policy"] !== void 0));
+}
 /**
 * 문서에서 에이전트가 쓸 수 있는 오퍼레이션만 고른다.
 * - `/v1/oauth2/*`: 토큰 발급 표면이다. PAT로 부를 일이 없다
@@ -34,6 +38,7 @@ const BLOCKED_OPERATIONS = {
 */
 function buildOperationIndex(document) {
 	const operations = [];
+	const serverPolicy = servesAgentPolicy(document);
 	for (const [path, item] of Object.entries(document.paths ?? {})) {
 		if (!path.startsWith("/v1/") || path.startsWith("/v1/oauth2/")) continue;
 		for (const method of METHODS) {
@@ -41,6 +46,7 @@ function buildOperationIndex(document) {
 			if (!raw?.operationId) continue;
 			const scopes = raw["x-required-scopes"] ?? [];
 			if (scopes.length === 0 || raw["x-console-only"]) continue;
+			const policy = raw["x-agent-policy"];
 			operations.push({
 				operationId: raw.operationId,
 				method,
@@ -49,7 +55,11 @@ function buildOperationIndex(document) {
 				summary: raw.summary ?? raw.operationId,
 				scopes,
 				deprecated: raw.deprecated === true,
-				blocked: BLOCKED_OPERATIONS[raw.operationId],
+				blocked: serverPolicy ? policy?.decision === "DENIED" ? policy.reason : void 0 : LEGACY_BLOCKED_OPERATIONS[raw.operationId],
+				approval: policy?.decision === "APPROVAL_REQUIRED" ? {
+					reason: policy.reason,
+					...policy.condition ? { condition: policy.condition } : {}
+				} : void 0,
 				raw
 			});
 		}
@@ -63,7 +73,8 @@ function formatOperationIndex(operations) {
 		const flags = [
 			op.scopes.join(","),
 			op.deprecated ? "deprecated" : "",
-			op.blocked ? "호출 불가" : ""
+			op.blocked ? "호출 불가" : "",
+			op.approval ? op.approval.condition ? "조건부 승인 필요" : "승인 필요" : ""
 		].filter(Boolean);
 		const lines = byTag[op.tag] ?? [];
 		lines.push(`${op.operationId} · ${op.method} ${op.path} · ${op.summary} [${flags.join(" · ")}]`);
@@ -102,6 +113,10 @@ function describeOperation(op, document) {
 		requiredScopes: op.scopes,
 		deprecated: op.deprecated || void 0,
 		blocked: op.blocked,
+		approval: op.approval ? {
+			...op.approval,
+			note: "부르면 서버가 실행하지 않고 승인 대기(202)로 둔다. 셀러가 콘솔에서 승인하면 서버가 그대로 실행한다. `dryRun: true`로 먼저 영향을 확인한다"
+		} : void 0,
 		tool: op.blocked ? void 0 : op.method === "GET" ? "call_api_read" : "call_api_write",
 		pathParams: parameters.filter((p) => p.in === "path").map((p) => p.name),
 		query: parameters.filter((p) => p.in === "query").map((p) => ({
@@ -127,14 +142,14 @@ function buildPath(template, params) {
 	const used = /* @__PURE__ */ new Set();
 	const path = template.replace(/\{([^}]+)\}/g, (_match, name) => {
 		const value = params[name];
-		if (value === void 0 || value === "") throw new Error(`경로 값이 없어요: ${name}`);
+		if (value === void 0 || value === "") throw new Error(`경로 값이 없습니다: ${name}`);
 		const text$1 = String(value);
-		if (text$1 === "." || text$1 === ".." || !SAFE_SEGMENT.test(text$1)) throw new Error(`쓸 수 없는 경로 값이에요: ${name}`);
+		if (text$1 === "." || text$1 === ".." || !SAFE_SEGMENT.test(text$1)) throw new Error(`쓸 수 없는 경로 값입니다: ${name}`);
 		used.add(name);
 		return encodeURIComponent(text$1);
 	});
 	const extra = Object.keys(params).filter((name) => !used.has(name));
-	if (extra.length) throw new Error(`경로에 없는 값이에요: ${extra.join(", ")}`);
+	if (extra.length) throw new Error(`경로에 없는 값입니다: ${extra.join(", ")}`);
 	return path;
 }
 /**
@@ -148,7 +163,7 @@ function truncateData(data, maxChars) {
 		while (kept > 0 && JSON.stringify(rebuild(items.slice(0, kept))).length > maxChars) kept = Math.floor(kept / 2);
 		return {
 			data: rebuild(items.slice(0, kept)),
-			truncated: `목록 ${items.length}개 중 ${kept}개만 실었어요. size·page로 나눠 조회하세요`
+			truncated: `목록 ${items.length}개 중 ${kept}개만 실었습니다. size·page로 나눠 조회하십시오`
 		};
 	};
 	if (Array.isArray(data)) return shrink(data, (kept) => kept);
@@ -160,7 +175,110 @@ function truncateData(data, maxChars) {
 	const text$1 = JSON.stringify(data);
 	return {
 		data: `${text$1.slice(0, maxChars)}…`,
-		truncated: `응답 ${text$1.length}자 중 ${maxChars}자만 실었어요`
+		truncated: `응답 ${text$1.length}자 중 ${maxChars}자만 실었습니다`
+	};
+}
+/** 같은 멱등키의 승인이 끝났을 때 상태별 안내 — 에이전트가 다음에 할 일 */
+const DECIDED_GUIDE = {
+	SUCCEEDED: {
+		message: "이 멱등키의 요청은 셀러가 승인해서 이미 실행됐습니다. 다시 실행하지 않았습니다",
+		nextSteps: ["실행 결과는 `result`다. 같은 요청을 다시 보내지 않는다"]
+	},
+	FAILED: {
+		message: "이 멱등키의 요청은 승인 뒤 실행했지만 실패했습니다",
+		nextSteps: ["`result.error`로 원인을 사용자에게 알린다", "고쳐서 다시 하려면 새 멱등키로 요청한다(같은 키는 이 결과만 돌려준다)"]
+	},
+	UNKNOWN: {
+		message: "이 멱등키의 요청은 승인 뒤 실행 결과를 확인하지 못했습니다. 이미 실행됐을 수 있습니다",
+		nextSteps: ["다시 보내지 않는다. 대상 리소스를 조회해 바뀌었는지 확인하고 사용자에게 알린다", "셀러에게 콘솔의 감사 로그에서 실행 여부를 확인해 달라고 전한다"]
+	},
+	REJECTED: {
+		message: "이 멱등키의 요청은 셀러가 거절했습니다. 아무것도 바뀌지 않았습니다",
+		nextSteps: ["거절 사유(`decisionNote`)를 전한다. 사용자가 원하면 새 멱등키로 다시 요청한다"]
+	},
+	EXPIRED: {
+		message: "이 멱등키의 요청은 승인 기한(24시간)이 지났습니다. 아무것도 바뀌지 않았습니다",
+		nextSteps: ["사용자가 원하면 새 멱등키로 다시 요청한다"]
+	}
+};
+/**
+* 쓰기 결과를 에이전트가 읽을 형태로 바꾼다. 승인 대기(202 `APPROVAL_REQUIRED`)는 성공이 아니다 — 아직 아무것도
+* 바뀌지 않았다는 것과 셀러에게 전할 링크, 상태를 확인할 도구를 함께 준다. 같은 멱등키의 승인이 이미 끝났으면
+* (200 `APPROVAL_ALREADY_DECIDED`) `data.status`로 결과와 다음 할 일을 알린다. 에이전트 정책 거부(403)는 다시 시도하지
+* 않게 알린다. 다른 202(비동기 접수)는 승인 대기가 아니다 — `meta.code`로만 가른다.
+*/
+function describeWriteResult(result) {
+	if (result.ok && result.code === "APPROVAL_ALREADY_DECIDED") {
+		const approval = result.data ?? {};
+		const guide = DECIDED_GUIDE[approval.status ?? ""] ?? DECIDED_GUIDE.EXPIRED;
+		return {
+			isError: approval.status !== "SUCCEEDED",
+			body: {
+				status: `APPROVAL_${approval.status ?? "DECIDED"}`,
+				applied: approval.status === "SUCCEEDED" ? true : approval.status === "UNKNOWN" ? "unknown" : false,
+				message: guide?.message,
+				approvalId: approval.approvalId,
+				result: approval.result,
+				decisionNote: approval.decisionNote ?? void 0,
+				nextSteps: guide?.nextSteps
+			}
+		};
+	}
+	if (result.ok && result.code === "APPROVAL_REQUIRED") {
+		const pending = result.data ?? {};
+		if (pending.status === "EXECUTING") return {
+			isError: false,
+			body: {
+				status: "APPROVAL_EXECUTING",
+				applied: "unknown",
+				message: "셀러가 승인해서 서버가 이 요청을 실행하고 있습니다",
+				approvalId: pending.approvalId,
+				nextSteps: ["같은 요청을 다시 보내지 않는다. 결과는 `get_approval_request`로 확인한다"]
+			}
+		};
+		return {
+			isError: false,
+			body: {
+				status: "APPROVAL_PENDING",
+				applied: false,
+				message: "승인 대기 중입니다. 아직 아무것도 바뀌지 않았습니다. 셀러가 콘솔에서 승인하면 서버가 이 요청을 그대로 실행합니다",
+				approvalId: pending.approvalId,
+				reason: pending.reason,
+				expiresAt: pending.expiresAt,
+				approvalUrl: pending.approvalUrl ?? void 0,
+				preview: pending.preview,
+				nextSteps: [pending.approvalUrl ? `사용자에게 승인 화면 링크를 전한다: ${pending.approvalUrl}` : "사용자에게 셀러 콘솔 › 설정 › 승인 요청에서 승인해 달라고 전한다", "같은 요청을 다시 보내지 않는다. 결과는 `get_approval_request`로 확인한다"]
+			}
+		};
+	}
+	if (result.ok && result.code === "DRY_RUN") return {
+		isError: false,
+		body: {
+			status: "DRY_RUN",
+			applied: false,
+			message: "실행하지 않았습니다. 서버의 판정과 영향 미리보기입니다",
+			...result.data
+		}
+	};
+	if (!result.ok) {
+		if (result.error?.code === "AGENT_OPERATION_DENIED") return {
+			isError: true,
+			body: {
+				...result,
+				nextSteps: ["에이전트는 이 작업을 할 수 없다. 다시 시도하지 말고 셀러에게 콘솔에서 직접 하도록 안내한다"]
+			}
+		};
+		return {
+			isError: true,
+			body: { ...result }
+		};
+	}
+	return {
+		isError: false,
+		body: {
+			status: result.status,
+			data: result.data
+		}
 	};
 }
 
@@ -196,7 +314,7 @@ var AdminApi = class {
 			redirect: "error",
 			signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
 		});
-		if (!response.ok) throw new Error(`API 문서를 읽지 못했어요 (HTTP ${response.status})`);
+		if (!response.ok) throw new Error(`API 문서를 읽지 못했습니다 (HTTP ${response.status})`);
 		const document = await response.json();
 		this.spec = {
 			document,
@@ -208,7 +326,7 @@ var AdminApi = class {
 	async find(operationId) {
 		const { document, operations } = await this.load();
 		const op = operations.find((candidate) => candidate.operationId === operationId);
-		if (!op) throw new Error(`쓸 수 있는 오퍼레이션이 아니에요: ${operationId}. list_operations의 operationId를 쓰세요`);
+		if (!op) throw new Error(`쓸 수 있는 오퍼레이션이 아닙니다: ${operationId}. list_operations의 operationId를 쓰십시오`);
 		return {
 			document,
 			op
@@ -223,6 +341,7 @@ var AdminApi = class {
 		};
 		if (input.body !== void 0) headers["content-type"] = "application/json";
 		if (input.idempotencyKey) headers["idempotency-key"] = input.idempotencyKey;
+		if (input.dryRun) headers["x-sayren-dry-run"] = "1";
 		const response = await this.fetchImpl(url, {
 			method: input.method,
 			headers,
@@ -238,6 +357,7 @@ var AdminApi = class {
 		return response.ok ? {
 			ok: true,
 			status: response.status,
+			...payload?.meta?.code ? { code: payload.meta.code } : {},
 			data: payload?.data ?? payload
 		} : {
 			ok: false,
@@ -252,7 +372,7 @@ var AdminApi = class {
 const DEFAULT_API_ORIGIN = "https://api.sayren.app";
 function loadConfig(env = process.env) {
 	const token = env.SAYREN_TOKEN?.trim();
-	if (!token) throw new Error("SAYREN_TOKEN이 없어요. 셀러 콘솔 개발자 공간 › API 토큰에서 발급한 토큰을 MCP 설정의 env에 넣어주세요");
+	if (!token) throw new Error("SAYREN_TOKEN이 없습니다. 셀러 콘솔 개발자 공간 › API 토큰에서 발급한 토큰을 MCP 설정의 env에 넣어주십시오");
 	const origin = (env.SAYREN_API_ORIGIN ?? DEFAULT_API_ORIGIN).replace(/\/+$/, "");
 	return {
 		apiOrigin: origin,
@@ -270,7 +390,7 @@ async function callApi(url, init = {}) {
 	const body = await response.json().catch(() => null);
 	if (!response.ok) {
 		const code = body?.error?.code ?? String(response.status);
-		const message = body?.error?.message ?? "요청이 실패했어요";
+		const message = body?.error?.message ?? "요청이 실패했습니다";
 		throw new Error(`${code}: ${message}`);
 	}
 	return body?.data ?? body;
@@ -292,7 +412,7 @@ async function fetchStoreContext(config$1) {
 	const payment = paymentSettings ? {
 		connectedProviders: connected.map((p) => p.provider),
 		sandboxOnly: connected.length === 0 || connected.every((p) => p.sandboxMode)
-	} : { unavailable: "결제 설정은 셀러 콘솔 OWNER만 볼 수 있어 이 토큰으로는 확인하지 못했어요" };
+	} : { unavailable: "결제 설정은 셀러 콘솔 OWNER만 볼 수 있어 이 토큰으로는 확인하지 못했습니다" };
 	return {
 		storeId: store.storeId,
 		storeCode: store.storeCode,
@@ -399,12 +519,12 @@ function resolveSpec(name, spec, meta, options) {
 	if (options.link && name.startsWith("@sayren/")) return "workspace:*";
 	if (spec === "catalog:" || spec === "catalog:default") {
 		const version$1 = meta.catalog[name];
-		if (!version$1) throw new Error(`catalog에 ${name} 버전이 없어요`);
+		if (!version$1) throw new Error(`catalog에 ${name} 버전이 없습니다`);
 		return version$1;
 	}
 	if (spec.startsWith("workspace:")) {
 		const version$1 = meta.versions[name];
-		if (!version$1) throw new Error(`${name}의 배포 버전을 모르겠어요`);
+		if (!version$1) throw new Error(`${name}의 배포 버전을 모르겠습니다`);
 		return `^${version$1}`;
 	}
 	return spec;
@@ -478,7 +598,7 @@ function resolveRoot() {
 	for (const candidate of CANDIDATES) try {
 		if (statSync(candidate).isDirectory()) return candidate;
 	} catch {}
-	throw new Error("스토어프론트 템플릿을 찾지 못했어요");
+	throw new Error("스토어프론트 템플릿을 찾지 못했습니다");
 }
 const TEMPLATE_ROOT = resolveRoot();
 function walk(dir, acc) {
@@ -503,7 +623,7 @@ function listTemplateFiles() {
 */
 function readTemplateFile(path, options = {}) {
 	const normalized = path.replace(/^\.?\//, "");
-	if (!listTemplateFiles().includes(normalized)) throw new Error(`템플릿에 없는 파일이에요: ${path}`);
+	if (!listTemplateFiles().includes(normalized)) throw new Error(`템플릿에 없는 파일입니다: ${path}`);
 	let file = join(TEMPLATE_ROOT, normalized);
 	if (normalized.endsWith(".gitignore") && !existsSync(file)) file = file.replace(/\.gitignore$/, BUNDLED_GITIGNORE);
 	const raw = readFileSync(file, "utf8");
@@ -802,7 +922,7 @@ function buildReport(files) {
 		},
 		results,
 		findings: reported,
-		message: findings.length ? `규칙 ${RULES.length}개 중 ${violated}개를 어겼어요(위반 ${findings.length}건). 아래 findings의 fix대로 고친 뒤 다시 검사해주세요` : `규칙 ${RULES.length}개를 모두 지켰어요. 정적 검사가 잡지 못하는 것이 있으니 직접 띄워 결제까지 한 번 해보세요`,
+		message: findings.length ? `규칙 ${RULES.length}개 중 ${violated}개를 어겼습니다(위반 ${findings.length}건). 아래 findings의 fix대로 고친 뒤 다시 검사해주십시오` : `규칙 ${RULES.length}개를 모두 지켰습니다. 정적 검사가 잡지 못하는 것이 있으니 직접 띄워 결제까지 한 번 해보십시오`,
 		nextSteps: nextSteps(reported)
 	};
 }
@@ -875,7 +995,7 @@ async function runCreate(argv) {
 	}
 	const target = resolve(args.dir);
 	if (existsSync(target) && readdirSync(target).length > 0 && !args.force) {
-		console.error(`폴더가 비어 있지 않아요: ${target} (--force로 덮어쓸 수 있어요)`);
+		console.error(`폴더가 비어 있지 않습니다: ${target} (--force로 덮어쓸 수 있습니다)`);
 		return 1;
 	}
 	const name = args.name ?? basename(target);
@@ -895,7 +1015,7 @@ async function runCreate(argv) {
 		const env = `SAYREN_API_URL=${store.storefrontApiBaseUrl}\nSAYREN_STORE_CODE=${store.storeCode}\n`;
 		writeFileSync(join(target, ".env"), env);
 		console.log(`.env 작성 — ${store.name} (${store.storeCode})`);
-	} else console.log("SAYREN_TOKEN이 없어 .env는 비워 뒀어요. SAYREN_API_URL과 SAYREN_STORE_CODE를 넣어주세요");
+	} else console.log("SAYREN_TOKEN이 없어 .env는 비워 뒀습니다. SAYREN_API_URL과 SAYREN_STORE_CODE를 넣어주십시오");
 	const startedAt = Date.now();
 	const report$1 = buildReport(await collectSources(target));
 	const durationMs = Date.now() - startedAt;
@@ -906,7 +1026,7 @@ async function runCreate(argv) {
 	}
 	console.log(`\n다음:\n  cd ${args.dir}\n  pnpm install\n  pnpm dev`);
 	console.log(`
-디자인을 고친 뒤에는 MCP 도구 \`verify_storefront\`로 다시 검사해주세요. 결제·구매자 인증·방문 분석 규칙 ${report$1.summary.rules}개를 보고, 어긴 항목마다 고칠 자리와 수정 방법·예시 코드를 알려 줘요.\n결제까지 해 보려면 셀러 콘솔 설정 › 결제에서 결제 도메인에 이 쇼핑몰 주소를 등록해주세요(테스트 결제는 localhost가 항상 허용돼요).`);
+디자인을 고친 뒤에는 MCP 도구 \`verify_storefront\`로 다시 검사해주십시오. 결제·구매자 인증·방문 분석 규칙 ${report$1.summary.rules}개를 보고, 어긴 항목마다 고칠 자리와 수정 방법·예시 코드를 알려 줍니다.\n결제까지 해 보려면 셀러 콘솔 설정 › 결제에서 결제 도메인에 이 쇼핑몰 주소를 등록해주십시오(테스트 결제는 localhost가 항상 허용됩니다).`);
 	if (config$1) await new Telemetry(config$1).reportVerify("create", report$1, durationMs);
 	return 0;
 }
@@ -1067,8 +1187,21 @@ async function invoke(expected, input) {
 		path: buildPath(op.path, input.pathParams ?? {}),
 		query: input.query,
 		body: input.body,
-		idempotencyKey: input.idempotencyKey
+		idempotencyKey: input.idempotencyKey,
+		dryRun: expected === "write" && input.dryRun === true
 	});
+	if (expected === "write") {
+		const described = describeWriteResult(result);
+		if (described.isError) return {
+			...text(described.body),
+			isError: true
+		};
+		const { data: data$1, truncated: truncated$1 } = truncateData(described.body, MAX_RESPONSE_CHARS);
+		return text(truncated$1 ? {
+			...data$1,
+			truncated: truncated$1
+		} : data$1);
+	}
 	if (!result.ok) return {
 		...text(result),
 		isError: true
@@ -1095,13 +1228,14 @@ server.registerTool("call_api_read", {
 }, async (input) => invoke("read", input));
 server.registerTool("call_api_write", {
 	title: "관리 API 변경",
-	description: `POST·PUT·PATCH·DELETE 오퍼레이션을 부른다. 스토어 데이터가 실제로 바뀐다. 사용자가 요청한 변경만 한다. \`describe_operation\`에서 \`idempotencyKey: true\`인 오퍼레이션은 키를 새로 만들어 넣고, 재시도할 때는 같은 키를 쓴다. 환불로 이어지는 오퍼레이션(직권취소·클레임 승인)은 막혀 있다. ${UNTRUSTED_NOTE}`,
+	description: `POST·PUT·PATCH·DELETE 오퍼레이션을 부른다. 스토어 데이터가 실제로 바뀐다. 사용자가 요청한 변경만 한다. \`describe_operation\`에서 \`idempotencyKey: true\`인 오퍼레이션은 키를 새로 만들어 넣고, 재시도할 때는 같은 키를 쓴다. 바꾸기 전에 \`dryRun: true\`로 먼저 불러 대상·변경 전후·금액 영향과 승인 필요 여부를 사용자에게 보여 준다(서버가 실행하지 않는다). 환불·가격·할인처럼 승인이 필요한 쓰기는 서버가 승인 대기(\`APPROVAL_PENDING\`)로 두고, 셀러가 콘솔에서 승인하면 서버가 실행한다 — 결과 링크를 사용자에게 전하고 \`get_approval_request\`로 상태를 확인한다. 결제 설정·토큰 발급처럼 에이전트에게 거부된 작업은 다시 시도하지 않는다. ${UNTRUSTED_NOTE}`,
 	inputSchema: {
 		operationId: z.string().describe("`list_operations`가 준 operationId (GET 제외)"),
 		pathParams: pathParamsInput,
 		query: queryInput,
 		body: z.unknown().optional().describe("요청 본문(JSON). `describe_operation`의 body 스키마를 따른다"),
-		idempotencyKey: z.string().max(255).optional().describe("멱등키. 재시도에는 같은 값을 쓴다")
+		idempotencyKey: z.string().max(255).optional().describe("멱등키. 재시도에는 같은 값을 쓴다"),
+		dryRun: z.boolean().optional().describe("true면 실행하지 않고 서버의 판정(ALLOW·APPROVAL_REQUIRED·DENIED)과 영향 미리보기만 받는다")
 	},
 	annotations: {
 		readOnlyHint: false,
@@ -1110,6 +1244,29 @@ server.registerTool("call_api_write", {
 		openWorldHint: false
 	}
 }, async (input) => invoke("write", input));
+server.registerTool("get_approval_request", {
+	title: "승인 요청 상태",
+	description: "`call_api_write`가 승인 대기(`APPROVAL_PENDING`)로 돌려준 요청의 상태를 본다. `PENDING`은 아직 대기, `EXECUTING`은 승인 뒤 실행 중, `SUCCEEDED`·`FAILED`는 서버가 실행한 결과(`result`), `UNKNOWN`은 실행 결과를 확인하지 못함(이미 실행됐을 수 있으니 다시 보내지 말고 대상을 조회해 확인한다), `REJECTED`는 거절, `EXPIRED`는 기한(24시간) 지남이다. 승인은 셀러가 콘솔에서 한다 — 이 도구로 승인할 수 없다.",
+	inputSchema: { approvalId: z.string().describe("승인 대기 응답의 approvalId") },
+	annotations: {
+		readOnlyHint: true,
+		openWorldHint: false
+	}
+}, async ({ approvalId }) => {
+	const result = await adminApi.call({
+		method: "GET",
+		path: buildPath("/v1/approval-requests/{approvalId}", { approvalId })
+	});
+	if (!result.ok) return {
+		...text(result),
+		isError: true
+	};
+	const { data, truncated } = truncateData(result.data, MAX_RESPONSE_CHARS);
+	return text({
+		data,
+		...truncated ? { truncated } : {}
+	});
+});
 server.registerTool("verify_storefront", {
 	title: "생성 결과 검증",
 	description: "만들어진 프로젝트를 규칙과 대조한다. 결제가 조용히 실패하는 실수(브라우저 번들의 process.env, 클릭 시점 팝업 선오픈 누락, 결제 복귀 화면의 결과 확인 누락, 결과 확인 중 상태 조회 누락, 확정 배송비 미반영, 브라우저에 노출된 구매자 토큰 등)를 잡는다. 위반마다 고칠 자리(`file`·`line`)와 원인(`cause`)·수정 방법(`fix`)·예시 코드(`example`)·문서(`docUrl`)를 함께 준다. 규칙별 통과·위반은 `results`에 있다. 화면을 만든 뒤와 디자인을 고친 뒤에 부른다.",
@@ -1119,7 +1276,7 @@ server.registerTool("verify_storefront", {
 	const files = await collectSources(projectDir);
 	if (!files.length) return text({
 		ok: false,
-		message: `소스를 찾지 못했어요: ${projectDir}`,
+		message: `소스를 찾지 못했습니다: ${projectDir}`,
 		nextSteps: ["`projectDir`이 프로젝트 루트(package.json이 있는 폴더)의 절대 경로인지 확인한다.", "템플릿을 아직 받지 않았으면 `list_template_files`·`get_template_file`로 먼저 만든다."]
 	});
 	const report$1 = buildReport(files);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/mcp",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "type": "module",
   "bin": {
     "sayren-mcp": "./dist/index.mjs"
@@ -12,8 +12,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.22.0",
     "zod": "^4.6.5",
-    "@sayren/store-sdk": "^0.13.0",
-    "@sayren/storefront-sdk": "^0.11.0"
+    "@sayren/store-sdk": "^0.14.1",
+    "@sayren/storefront-sdk": "^0.11.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",

package/template/.template-meta.json

@@ -7,8 +7,8 @@
     "zod": "^4.6.5"
   },
   "versions": {
-    "@sayren/store-sdk": "0.13.0",
-    "@sayren/storefront-sdk": "0.11.0",
+    "@sayren/store-sdk": "0.14.1",
+    "@sayren/storefront-sdk": "0.11.1",
     "@sayren/ui": "0.1.0"
   }
 }

package/template/src/lib/config.server.ts

@@ -18,6 +18,6 @@ export function resolveStoreCode(): string {
   const fromHost = storeCodeFromHost(getRequestHeader("host"));
   if (fromHost) return fromHost;
   throw new Error(
-    "스토어 코드를 알 수 없어요. SAYREN_STORE_CODE 환경변수를 설정하거나 서브도메인으로 서비스해주세요",
+    "스토어 코드를 알 수 없습니다. SAYREN_STORE_CODE 환경변수를 설정하거나 서브도메인으로 서비스해주십시오",
   );
 }

package/template/src/routes/__root.tsx

@@ -67,14 +67,14 @@ function Root() {
 function RootError({ error }: ErrorComponentProps) {
   return (
     <ErrorView
-      title="문제가 생겼어요"
+      title="문제가 생겼습니다"
       detail={error instanceof Error ? error.message : undefined}
     />
   );
 }
 
 function NotFound() {
-  return <ErrorView title="찾을 수 없어요" />;
+  return <ErrorView title="찾을 수 없습니다" />;
 }
 
 function ErrorView({ title, detail }: { title: string; detail?: string }) {

package/template/src/routes/account.tsx

@@ -53,7 +53,7 @@ const changeConsents = createServerFn({ method: "POST" })
   .validator(consentInput)
   .handler(async ({ data }) => {
     const accessToken = readToken();
-    if (!accessToken) return { error: "다시 로그인해 주세요" };
+    if (!accessToken) return { error: "다시 로그인해 주십시오" };
     try {
       await apiFor({ accessToken }).member.updateConsents({
         ...(data.reconsent ? { terms: true as const, privacy: true as const } : {}),
@@ -73,7 +73,7 @@ const startLink = createServerFn({ method: "POST" })
   .validator(providerInput)
   .handler(async ({ data }) => {
     const accessToken = readToken();
-    if (!accessToken) return { url: null, error: "다시 로그인해 주세요" };
+    if (!accessToken) return { url: null, error: "다시 로그인해 주십시오" };
     const origin = new URL(getRequestUrl()).origin;
     try {
       const started = await authFor().linkIdp(accessToken, data.provider, {
@@ -95,7 +95,7 @@ const unlink = createServerFn({ method: "POST" })
   .validator(providerInput)
   .handler(async ({ data }) => {
     const accessToken = readToken();
-    if (!accessToken) return { error: "다시 로그인해 주세요" };
+    if (!accessToken) return { error: "다시 로그인해 주십시오" };
     try {
       await authFor().unlinkIdp(accessToken, data.provider);
       return { error: null };
@@ -105,18 +105,18 @@ const unlink = createServerFn({ method: "POST" })
   });
 
 const ERROR_MESSAGE: Record<string, string> = {
-  IDENTITY_IN_USE: "이 계정은 이미 다른 회원에 연결돼 있어요",
+  IDENTITY_IN_USE: "이 계정은 이미 다른 회원에 연결돼 있습니다",
   PROVIDER_ALREADY_LINKED:
-    "같은 서비스의 다른 계정이 이미 연결돼 있어요. 해제한 뒤 다시 연결해 주세요",
-  LAST_LOGIN_METHOD: "마지막 로그인 수단은 해제할 수 없어요. 다른 계정을 먼저 연결해 주세요",
-  access_denied: "연결을 취소했어요",
-  state_mismatch: "연결 요청이 만료됐어요. 다시 시도해 주세요",
+    "같은 서비스의 다른 계정이 이미 연결돼 있습니다. 해제한 뒤 다시 연결해 주십시오",
+  LAST_LOGIN_METHOD: "마지막 로그인 수단은 해제할 수 없습니다. 다른 계정을 먼저 연결해 주십시오",
+  access_denied: "연결을 취소했습니다",
+  state_mismatch: "연결 요청이 만료됐습니다. 다시 시도해 주십시오",
 };
 
 function accountErrorMessage(error: unknown): string {
   if (error instanceof ApiError)
-    return ERROR_MESSAGE[error.code] ?? "처리하지 못했어요. 잠시 후 다시 시도해 주세요";
-  return "처리하지 못했어요. 잠시 후 다시 시도해 주세요";
+    return ERROR_MESSAGE[error.code] ?? "처리하지 못했습니다. 잠시 후 다시 시도해 주십시오";
+  return "처리하지 못했습니다. 잠시 후 다시 시도해 주십시오";
 }
 
 export const Route = createFileRoute("/account")({
@@ -135,7 +135,7 @@ function Account() {
   const error =
     actionError ??
     (callbackError
-      ? (ERROR_MESSAGE[callbackError] ?? "연결하지 못했어요. 다시 시도해 주세요")
+      ? (ERROR_MESSAGE[callbackError] ?? "연결하지 못했습니다. 다시 시도해 주십시오")
       : null);
 
   const changeConsent = (data: { reconsent?: boolean; marketing?: boolean }) => {
@@ -187,7 +187,7 @@ function Account() {
         <h2 className="font-bold text-lg">로그인 수단</h2>
         {linked ? (
           <p className="rounded-md bg-chip px-3 py-2 text-sm">
-            {PROVIDER_NAME[linked]} 계정을 연결했어요
+            {PROVIDER_NAME[linked]} 계정을 연결했습니다
           </p>
         ) : null}
         <form onSubmit={submit}>
@@ -240,7 +240,7 @@ function Account() {
         </form>
         {error ? <p className="text-point text-sm">{error}</p> : null}
         <p className="text-muted text-xs">
-          연결한 계정으로도 같은 회원으로 로그인해요. 마지막 로그인 수단은 해제할 수 없어요.
+          연결한 계정으로도 같은 회원으로 로그인합니다. 마지막 로그인 수단은 해제할 수 없습니다.
         </p>
       </section>
 
@@ -252,7 +252,7 @@ function Account() {
               <span className="font-medium">이용약관 · 개인정보 수집이용</span>
               <span className="text-muted text-xs">
                 {consents.reconsentRequired
-                  ? "약관이 개정됐어요. 다시 동의해 주세요"
+                  ? "약관이 개정됐습니다. 다시 동의해 주십시오"
                   : `동의 완료 · v${consents.terms.agreedVersion ?? "-"}`}
               </span>
               {/* 스토어가 약관 주소를 정했으면 열어 볼 수 있게 한다 */}

package/template/src/routes/cart.tsx

@@ -73,7 +73,7 @@ function CartPage() {
   if (!cart.items.length) {
     return (
       <div className="space-y-4 py-16 text-center">
-        <p className="text-muted">장바구니가 비었어요</p>
+        <p className="text-muted">장바구니가 비었습니다</p>
         <Link to="/products" className="inline-block rounded-md bg-ink px-5 py-3 text-white">
           상품 보러 가기
         </Link>
@@ -107,7 +107,7 @@ function CartPage() {
               ) : null}
               {!item.purchasable ? (
                 <span className="text-point text-xs">
-                  {item.unpurchasableReason === "SOLD_OUT" ? "품절이에요" : "지금은 살 수 없어요"}
+                  {item.unpurchasableReason === "SOLD_OUT" ? "품절입니다" : "지금은 살 수 없습니다"}
                 </span>
               ) : null}
               <div className="flex items-center gap-3 pt-1">
@@ -171,7 +171,7 @@ function CartPage() {
         {loginRequired ? (
           <div className="flex w-full flex-col gap-2 md:w-64">
             <p className="text-center text-muted text-xs">
-              이 스토어는 회원만 주문할 수 있어요. 담은 상품은 로그인하면 그대로 이어져요
+              이 스토어는 회원만 주문할 수 있습니다. 담은 상품은 로그인하면 그대로 이어집니다
             </p>
             <Link
               to="/login"

package/template/src/routes/checkout.complete.tsx

@@ -34,11 +34,11 @@ function CheckoutComplete() {
   return (
     <div className="space-y-6 py-10 text-center">
       <div className="space-y-2">
-        <h1 className="font-bold text-2xl">주문을 완료했어요</h1>
+        <h1 className="font-bold text-2xl">주문을 완료했습니다</h1>
         {orderId ? (
           <p className="text-muted text-sm">주문번호 {orderId}</p>
         ) : (
-          <p className="text-muted text-sm">주문 내역에서 주문을 확인해주세요</p>
+          <p className="text-muted text-sm">주문 내역에서 주문을 확인해주십시오</p>
         )}
       </div>
 

package/template/src/routes/checkout.index.tsx

@@ -64,7 +64,10 @@ const quoteDelivery = createServerFn({ method: "POST" })
       const quote = await api.checkout.quoteDelivery(data.checkoutId, { zipCode: data.zipCode });
       return { quote, error: null };
     } catch {
-      return { quote: null, error: "배송비를 확인하지 못했어요. 우편번호를 다시 확인해주세요." };
+      return {
+        quote: null,
+        error: "배송비를 확인하지 못했습니다. 우편번호를 다시 확인해주십시오.",
+      };
     }
   });
 
@@ -125,20 +128,21 @@ const startPayment = createServerFn({ method: "POST" })
   });
 
 function startErrorMessage(error: unknown): string {
-  if (!(error instanceof ApiError)) return "결제를 시작하지 못했어요. 잠시 후 다시 시도해주세요.";
+  if (!(error instanceof ApiError))
+    return "결제를 시작하지 못했습니다. 잠시 후 다시 시도해주십시오.";
   switch (error.code) {
     case "PAYMENT_OPTION_UNAVAILABLE":
-      return "지금 쓸 수 없는 결제수단이에요. 다른 결제수단을 골라주세요.";
+      return "지금 쓸 수 없는 결제수단입니다. 다른 결제수단을 골라주십시오.";
     case "PAYMENT_PROVIDER_UNAVAILABLE":
-      return "결제창을 준비하지 못했어요. 다른 결제수단으로 시도해주세요.";
+      return "결제창을 준비하지 못했습니다. 다른 결제수단으로 시도해주십시오.";
     case "PAYMENT_NOT_CONFIGURED":
-      return "결제 수단을 준비하고 있어요. 잠시 후 다시 시도해주세요.";
+      return "결제 수단을 준비하고 있습니다. 잠시 후 다시 시도해주십시오.";
     case "CASH_RECEIPT_NOT_AVAILABLE":
-      return "현금영수증은 계좌이체·가상계좌 결제에서만 신청할 수 있어요.";
+      return "현금영수증은 계좌이체·가상계좌 결제에서만 신청할 수 있습니다.";
     case "RETURN_URL_NOT_ALLOWED":
-      return "이 쇼핑몰 주소에서는 결제할 수 없어요. 셀러 콘솔 설정 › 결제에서 결제 도메인을 확인해주세요.";
+      return "이 쇼핑몰 주소에서는 결제할 수 없습니다. 셀러 콘솔 설정 › 결제에서 결제 도메인을 확인해주십시오.";
     default:
-      return "결제를 시작하지 못했어요. 입력한 내용을 확인하고 다시 시도해주세요.";
+      return "결제를 시작하지 못했습니다. 입력한 내용을 확인하고 다시 시도해주십시오.";
   }
 }
 
@@ -210,10 +214,10 @@ function Checkout() {
     }
     setNotice(
       result.status === "CANCELED"
-        ? "결제를 취소했어요. 다른 결제수단으로 다시 시도해주세요."
+        ? "결제를 취소했습니다. 다른 결제수단으로 다시 시도해주십시오."
         : result.status === "FAILED"
           ? result.message
-          : "결제 결과를 확인하지 못했어요. 주문 내역을 확인해주세요.",
+          : "결제 결과를 확인하지 못했습니다. 주문 내역을 확인해주십시오.",
     );
   };
 
@@ -221,7 +225,7 @@ function Checkout() {
     event.preventDefault();
     const option = options.find((item) => paymentOptionKey(item) === selected);
     if (!option) {
-      setNotice("결제수단을 골라주세요.");
+      setNotice("결제수단을 골라주십시오.");
       return;
     }
     const form = new FormData(event.currentTarget);
@@ -233,7 +237,7 @@ function Checkout() {
         identityNumber: field("cashReceiptNumber"),
       });
       if (!parsed.success) {
-        setNotice(parsed.error.issues[0]?.message ?? "현금영수증 번호를 확인해주세요.");
+        setNotice(parsed.error.issues[0]?.message ?? "현금영수증 번호를 확인해주십시오.");
         return;
       }
       cashReceipt = parsed.data;
@@ -275,7 +279,7 @@ function Checkout() {
       })
       .catch(() => {
         paymentWindow.close();
-        setNotice("결제를 시작하지 못했어요. 잠시 후 다시 시도해주세요.");
+        setNotice("결제를 시작하지 못했습니다. 잠시 후 다시 시도해주십시오.");
       })
       .finally(() => setSubmitting(false));
   };
@@ -293,7 +297,7 @@ function Checkout() {
             placeholder="04524"
             required
             onBlur={handleZipBlur}
-            hint="입력하면 지역 추가 배송비까지 반영한 배송비를 보여 줘요"
+            hint="입력하면 지역 추가 배송비까지 반영한 배송비를 보여 줍니다"
           />
           <Field label="주소" name="address1" required />
           <Field label="상세 주소" name="address2" />
@@ -310,7 +314,7 @@ function Checkout() {
               name="orderPassword"
               type="password"
               required
-              hint="주문 내역을 찾을 때 쓸 6자 이상 비밀번호예요"
+              hint="주문 내역을 찾을 때 쓸 6자 이상 비밀번호입니다"
             />
           </section>
         )}
@@ -318,7 +322,7 @@ function Checkout() {
         <fieldset className="space-y-2">
           <legend className="mb-3 font-bold text-lg">결제수단</legend>
           {options.length === 0 ? (
-            <p className="text-muted text-sm">지금 결제할 수 있는 결제수단이 없어요.</p>
+            <p className="text-muted text-sm">지금 결제할 수 있는 결제수단이 없습니다.</p>
           ) : (
             <div className="grid grid-cols-2 gap-2">
               {options.map((option) => {
@@ -438,7 +442,7 @@ function Checkout() {
         ))}
         {checkout.testPayment ? (
           <p className="rounded-md bg-chip px-3 py-2 text-xs">
-            테스트 결제예요. 실제로 돈이 오가지 않아요.
+            테스트 결제입니다. 실제로 돈이 오가지 않습니다.
           </p>
         ) : null}
         {notice ? <p className="rounded-md bg-chip px-3 py-2 text-sm">{notice}</p> : null}
@@ -451,10 +455,10 @@ function Checkout() {
 function deliveryNotes(delivery: CheckoutDelivery): string[] {
   const notes: string[] = [];
   if (delivery.bundleCount >= 2) {
-    notes.push(`배송 묶음 ${delivery.bundleCount}건 — 묶음마다 배송비가 붙어요.`);
+    notes.push(`배송 묶음 ${delivery.bundleCount}건 — 묶음마다 배송비가 붙습니다.`);
   }
-  if (delivery.freeByThreshold) notes.push("무료배송 기준 금액을 넘겨 기본 배송비가 빠졌어요.");
-  if (delivery.zipCode === null) notes.push("배송지를 입력하면 배송비가 확정돼요.");
+  if (delivery.freeByThreshold) notes.push("무료배송 기준 금액을 넘겨 기본 배송비가 빠졌습니다.");
+  if (delivery.zipCode === null) notes.push("배송지를 입력하면 배송비가 확정됩니다.");
   return notes;
 }
 

package/template/src/routes/checkout.return.tsx

@@ -107,17 +107,17 @@ function PaymentReturn() {
     <div className="mx-auto max-w-md space-y-6 py-16 text-center">
       {view.kind === "working" || view.kind === "processing" ? (
         <>
-          <h1 className="font-bold text-2xl">결제를 확인하고 있어요</h1>
+          <h1 className="font-bold text-2xl">결제를 확인하고 있습니다</h1>
           <p className="text-muted text-sm">
             {view.kind === "processing"
-              ? "결제사에서 결과를 확인하는 중이에요. 이 화면을 닫지 말고 잠시만 기다려주세요."
-              : "잠시만 기다려주세요."}
+              ? "결제사에서 결과를 확인하는 중입니다. 이 화면을 닫지 말고 잠시만 기다려주십시오."
+              : "잠시만 기다려주십시오."}
           </p>
         </>
       ) : view.kind === "failed" ? (
         <>
           <h1 className="font-bold text-2xl">
-            {view.canceled ? "결제를 취소했어요" : "결제하지 못했어요"}
+            {view.canceled ? "결제를 취소했습니다" : "결제하지 못했습니다"}
           </h1>
           {view.canceled ? null : <p className="text-muted text-sm">{view.message}</p>}
           <div className="flex justify-center gap-2">
@@ -128,10 +128,10 @@ function PaymentReturn() {
         </>
       ) : (
         <>
-          <h1 className="font-bold text-2xl">결제 결과를 확인하지 못했어요</h1>
+          <h1 className="font-bold text-2xl">결제 결과를 확인하지 못했습니다</h1>
           <p className="text-muted text-sm">
-            결제를 마쳤다면 잠시 뒤 주문 내역에 나타나요. 다시 결제하기 전에 주문 내역을 먼저
-            확인해주세요.
+            결제를 마쳤다면 잠시 뒤 주문 내역에 나타납니다. 다시 결제하기 전에 주문 내역을 먼저
+            확인해주십시오.
           </p>
           <Link to="/orders" className="inline-block rounded-md border border-ink px-5 py-3">
             주문 내역

package/template/src/routes/index.tsx

@@ -48,7 +48,7 @@ function Home() {
       ) : null}
 
       <ProductSection listId="home:recommend" title="추천 상품" products={recommended} />
-      <ProductSection listId="home:latest" title="새로 들어왔어요" products={latest} />
+      <ProductSection listId="home:latest" title="새로 들어온 상품" products={latest} />
     </div>
   );
 }

package/template/src/routes/login.tsx

@@ -74,18 +74,18 @@ const passwordLogin = createServerFn({ method: "POST" })
 
 function loginErrorMessage(error: unknown): string {
   if (error instanceof ApiError) {
-    if (error.code === "INVALID_CREDENTIALS") return "이메일이나 비밀번호가 맞지 않아요";
-    if (error.code === "PASSWORD_LOGIN_DISABLED") return "이 스토어는 소셜 로그인만 받아요";
+    if (error.code === "INVALID_CREDENTIALS") return "이메일이나 비밀번호가 맞지 않습니다";
+    if (error.code === "PASSWORD_LOGIN_DISABLED") return "이 스토어는 소셜 로그인만 받습니다";
     if (error.code === "ACCOUNT_LOCKED")
-      return "로그인을 여러 번 실패해 잠시 잠겼어요. 10분 뒤에 다시 시도해 주세요";
-    if (error.status === 400) return "이메일과 비밀번호를 확인해 주세요";
+      return "로그인을 여러 번 실패해 잠시 잠겼습니다. 10분 뒤에 다시 시도해 주십시오";
+    if (error.status === 400) return "이메일과 비밀번호를 확인해 주십시오";
   }
-  return "로그인하지 못했어요. 잠시 후 다시 시도해 주세요";
+  return "로그인하지 못했습니다. 잠시 후 다시 시도해 주십시오";
 }
 
 const CALLBACK_ERRORS: Record<string, string> = {
-  access_denied: "로그인을 취소했어요",
-  state_mismatch: "로그인 요청이 만료됐어요. 다시 시도해 주세요",
+  access_denied: "로그인을 취소했습니다",
+  state_mismatch: "로그인 요청이 만료됐습니다. 다시 시도해 주십시오",
 };
 
 export const Route = createFileRoute("/login")({
@@ -105,7 +105,7 @@ function Login() {
   const error =
     actionError ??
     (callbackError
-      ? (CALLBACK_ERRORS[callbackError] ?? "로그인하지 못했어요. 다시 시도해 주세요")
+      ? (CALLBACK_ERRORS[callbackError] ?? "로그인하지 못했습니다. 다시 시도해 주십시오")
       : null);
 
   const submitSocial = (event: React.FormEvent<HTMLFormElement>) => {
@@ -195,7 +195,7 @@ function Login() {
       ) : null}
       {error ? <p className="text-point text-sm">{error}</p> : null}
       {social.length ? (
-        <p className="text-center text-muted text-xs">처음 소셜 로그인하면 가입이 함께 돼요</p>
+        <p className="text-center text-muted text-xs">처음 소셜 로그인하면 가입이 함께 됩니다</p>
       ) : null}
     </div>
   );

package/template/src/routes/orders.$orderId.tsx

@@ -62,18 +62,18 @@ const createClaim = createServerFn({ method: "POST" })
   });
 
 function claimErrorMessage(error: unknown): string {
-  if (!(error instanceof ApiError)) return "접수하지 못했어요. 잠시 후 다시 시도해주세요.";
+  if (!(error instanceof ApiError)) return "접수하지 못했습니다. 잠시 후 다시 시도해주십시오.";
   switch (error.code) {
     case "INVALID_QUANTITY":
-      return "남은 수량보다 많이 신청했어요. 수량을 확인해주세요.";
+      return "남은 수량보다 많이 신청했습니다. 수량을 확인해주십시오.";
     case "CLAIM_IN_PROGRESS":
-      return "이미 진행 중인 신청이 있어요.";
+      return "이미 진행 중인 신청이 있습니다.";
     case "INVALID_STATUS":
-      return "지금은 신청할 수 없는 상태예요. 주문 상태를 확인해주세요.";
+      return "지금은 신청할 수 없는 상태입니다. 주문 상태를 확인해주십시오.";
     case "PERIOD_EXPIRED":
-      return "반품·교환 가능 기간이 지났어요.";
+      return "반품·교환 가능 기간이 지났습니다.";
     default:
-      return error.message || "접수하지 못했어요. 잠시 후 다시 시도해주세요.";
+      return error.message || "접수하지 못했습니다. 잠시 후 다시 시도해주십시오.";
   }
 }
 
@@ -147,7 +147,7 @@ function OrderDetail() {
 
       {result ? (
         <div className="space-y-1 rounded-md bg-chip p-4 text-sm">
-          <p className="font-semibold">신청이 접수됐어요 (수량 {result.quantity}개)</p>
+          <p className="font-semibold">신청이 접수됐습니다 (수량 {result.quantity}개)</p>
           {/* 상품 금액 환불은 수량 비율이고, 반품 배송비는 이미 빠져 있다. 배송비 환불은 따로 온다 */}
           {result.expectedRefundAmount === null ? null : (
             <p className="text-muted">
@@ -271,9 +271,9 @@ function ClaimForm({
   const quantity = Number(quantityText);
   const quantityError =
     quantityText.trim() === "" || !Number.isInteger(quantity)
-      ? "수량을 입력해주세요."
+      ? "수량을 입력해주십시오."
       : quantity < 1 || quantity > item.activeQuantity
-        ? `수량은 1개 이상 ${item.activeQuantity}개 이하로 입력해주세요.`
+        ? `수량은 1개 이상 ${item.activeQuantity}개 이하로 입력해주십시오.`
         : null;
   return (
     <form

package/template/src/routes/orders.index.tsx

@@ -20,7 +20,7 @@ function Orders() {
   const orders = Route.useLoaderData();
 
   if (!orders.contents.length) {
-    return <p className="py-16 text-center text-muted">아직 주문이 없어요</p>;
+    return <p className="py-16 text-center text-muted">아직 주문이 없습니다</p>;
   }
 
   return (

package/template/src/routes/products.$productId.tsx

@@ -107,7 +107,7 @@ function ProductDetail() {
             setError(null);
             addToCart({ data: { productId: product.productId, optionId, quantity } })
               .then(() => navigate({ to: "/cart" }))
-              .catch(() => setError("장바구니에 담지 못했어요. 다시 시도해주세요"))
+              .catch(() => setError("장바구니에 담지 못했습니다. 다시 시도해주십시오"))
               .finally(() => setSubmitting(false));
           }}
         >

package/template/src/routes/products.index.tsx

@@ -71,7 +71,7 @@ function Products() {
           type="search"
           name="keyword"
           defaultValue={applied.keyword ?? ""}
-          placeholder="상품을 검색해요"
+          placeholder="상품 검색"
           className="h-11 flex-1 rounded-md border border-line px-3"
         />
         {applied.categoryId ? (
@@ -104,7 +104,7 @@ function Products() {
       </div>
 
       {page.contents.length === 0 ? (
-        <p className="py-16 text-center text-muted">조건에 맞는 상품이 없어요</p>
+        <p className="py-16 text-center text-muted">조건에 맞는 상품이 없습니다</p>
       ) : (
         <div className="grid grid-cols-2 gap-4 md:grid-cols-4">
           {page.contents.map((product) => (