daiso 1.0.9 → 1.1.0

package/dist/cliHelpDefinitions.js

@@ -0,0 +1,369 @@
+/**
+ * CLI 도움말 정의
+ */
+export const COMMAND_LIST = [
+    'help',
+    'version',
+    'url',
+    'health',
+    'claude',
+    'get',
+    'products',
+    'product',
+    'stores',
+    'inventory',
+    'display-location',
+    'compare',
+    'places',
+    'cu-stores',
+    'cu-inventory',
+    'cgv-theaters',
+    'cgv-movies',
+    'cgv-timetable',
+    'lottecinema-theaters',
+    'lottecinema-movies',
+    'lottecinema-seats',
+    'megabox-theaters',
+    'megabox-movies',
+    'megabox-seats',
+    'lottemart-stores',
+    'lottemart-products',
+    'emart24-stores',
+    'emart24-products',
+    'emart24-inventory',
+    'gs25-stores',
+    'gs25-products',
+    'gs25-inventory',
+    'seveneleven-products',
+    'seveneleven-stores',
+    'seveneleven-inventory',
+    'seveneleven-popwords',
+    'seveneleven-catalog',
+];
+export const COMMAND_SUMMARY = {
+    help: '도움말 출력',
+    version: 'CLI 버전 출력',
+    url: 'MCP 엔드포인트 URL 출력',
+    health: '원격 서버 상태 확인',
+    claude: 'Claude Code MCP 등록 명령 출력/실행',
+    get: '임의 API 경로 GET 호출',
+    products: '다이소 제품 검색',
+    product: '다이소 제품 상세 조회',
+    stores: '다이소 매장 검색',
+    inventory: '다이소 재고 조회',
+    'display-location': '다이소 진열 위치 조회',
+    compare: '키 없는 통합 상품 가격 후보 비교',
+    places: '음식점/카페 등 주변 장소 검색',
+    'cu-stores': 'CU 매장 검색',
+    'cu-inventory': 'CU 재고 조회',
+    'cgv-theaters': 'CGV 극장 검색',
+    'cgv-movies': 'CGV 영화 검색',
+    'cgv-timetable': 'CGV 시간표 조회',
+    'lottecinema-theaters': '롯데시네마 주변 지점 조회',
+    'lottecinema-movies': '롯데시네마 영화/회차 조회',
+    'lottecinema-seats': '롯데시네마 잔여 좌석 조회',
+    'megabox-theaters': '메가박스 주변 지점 조회',
+    'megabox-movies': '메가박스 영화/회차 조회',
+    'megabox-seats': '메가박스 잔여 좌석 조회',
+    'lottemart-stores': '롯데마트 매장 검색',
+    'lottemart-products': '롯데마트 상품 검색',
+    'emart24-stores': '이마트24 매장 검색',
+    'emart24-products': '이마트24 상품 검색',
+    'emart24-inventory': '이마트24 재고 조회',
+    'gs25-stores': 'GS25 매장 검색',
+    'gs25-products': 'GS25 상품 검색',
+    'gs25-inventory': 'GS25 재고 조회',
+    'seveneleven-products': '세븐일레븐 상품 검색',
+    'seveneleven-stores': '세븐일레븐 매장 검색',
+    'seveneleven-inventory': '세븐일레븐 재고 조회',
+    'seveneleven-popwords': '세븐일레븐 인기 검색어 조회',
+    'seveneleven-catalog': '세븐일레븐 카탈로그 스냅샷 조회',
+};
+export const COMMAND_DETAIL = {
+    help: [
+        '명령: help',
+        '설명: 전체 도움말 또는 특정 명령 상세 도움말을 출력합니다.',
+        '사용법: daiso help [command]',
+        '예시: daiso help products',
+    ],
+    version: ['명령: version', '설명: 설치된 daiso CLI 버전을 출력합니다.', '사용법: daiso version'],
+    url: [
+        '명령: url',
+        '설명: MCP 엔드포인트 URL을 출력합니다.',
+        '사용법: daiso url',
+        '출력 예시: https://mcp.aka.page/mcp',
+    ],
+    health: [
+        '명령: health',
+        '설명: 서버 /health API를 호출해 상태를 확인합니다.',
+        '사용법: daiso health',
+        '출력: status, endpoint, checkedAt(JSON)',
+    ],
+    claude: [
+        '명령: claude',
+        '설명: Claude Code MCP 등록 명령을 출력하거나 실행합니다.',
+        '사용법: daiso claude [--exec]',
+        '옵션: --exec 실제 claude 명령 실행',
+        '예시: daiso claude --exec',
+    ],
+    get: [
+        '명령: get',
+        '설명: 임의 API 경로를 GET으로 호출합니다.',
+        '사용법: daiso get <path|url> [--queryKey value ...] [--json]',
+        '필수: <path|url>',
+        '옵션: --json 원본 JSON 출력',
+        '예시: daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056',
+    ],
+    products: [
+        '명령: products',
+        '설명: 다이소 제품 검색 API를 호출합니다.',
+        '사용법: daiso products <query> [--page N] [--pageSize N] [--json]',
+        '필수: <query>',
+        '옵션: --page, --pageSize, --json',
+        '예시: daiso products 수납박스 --page 1 --pageSize 30',
+    ],
+    product: [
+        '명령: product',
+        '설명: 다이소 제품 상세 API를 호출합니다.',
+        '사용법: daiso product <productId> [--json]',
+        '필수: <productId>',
+        '옵션: --json',
+        '예시: daiso product 1034604',
+    ],
+    stores: [
+        '명령: stores',
+        '설명: 다이소 매장 검색 API를 호출합니다.',
+        '사용법: daiso stores [keyword] [--sido 값] [--gugun 값] [--dong 값] [--limit N] [--json]',
+        '필수: keyword 또는 --sido',
+        '옵션: --keyword, --sido, --gugun, --dong, --limit, --json',
+        '예시: daiso stores 강남역',
+        '예시: daiso stores --sido 서울 --gugun 강남구',
+    ],
+    inventory: [
+        '명령: inventory',
+        '설명: 다이소 재고 API를 호출합니다.',
+        '사용법: daiso inventory <productId> [--keyword 값] [--lat 값] [--lng 값] [--page N] [--pageSize N] [--json]',
+        '필수: <productId>',
+        '옵션: --keyword, --lat, --lng, --page, --pageSize, --json',
+        '예시: daiso inventory 1034604 --keyword 강남역',
+    ],
+    'display-location': [
+        '명령: display-location',
+        '설명: 다이소 매장 내 상품 진열 위치 API를 호출합니다.',
+        '사용법: daiso display-location <productId> <storeCode> [--json]',
+        '필수: <productId>, <storeCode>',
+        '옵션: --json',
+        '예시: daiso display-location 1034604 04515',
+    ],
+    compare: [
+        '명령: compare',
+        '설명: 새 외부 키 없이 다이소, GS25, 세븐일레븐, 이마트24 상품 검색을 묶어 가격 후보를 비교합니다.',
+        '사용법: daiso compare <keyword> [--services daiso,gs25,seveneleven,emart24] [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --services, --limit, --json',
+        '예시: daiso compare 콜라 --limit 3',
+        '예시: daiso compare 컵라면 --services seveneleven,emart24 --json',
+    ],
+    places: [
+        '명령: places',
+        '설명: 네이버 지역 검색으로 음식점, 카페, 디저트 가게 등 주변 장소를 검색합니다.',
+        '사용법: daiso places <location> [--category cafe|restaurant|food|dessert|all] [--keyword 검색어] [--limit N] [--json]',
+        '필수: <location> 또는 --keyword',
+        '옵션: --category, --keyword, --limit, --start, --sort, --json',
+        '예시: daiso places 강남역 --category cafe --limit 5',
+        '예시: daiso places 성수동 --keyword 브런치 --limit 5',
+    ],
+    'cu-stores': [
+        '명령: cu-stores',
+        '설명: CU 매장 검색 API를 호출합니다.',
+        '사용법: daiso cu-stores [keyword] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --limit, --json',
+        '예시: daiso cu-stores 강남',
+        '예시: daiso cu-stores --lat 37.498 --lng 127.027 --limit 10',
+    ],
+    'cu-inventory': [
+        '명령: cu-inventory',
+        '설명: CU 재고 검색 API를 호출합니다.',
+        '사용법: daiso cu-inventory <keyword> [--storeKeyword 값] [--lat 값] [--lng 값] [--size N] [--offset N] [--json]',
+        '필수: <keyword>',
+        '옵션: --storeKeyword, --lat, --lng, --size, --offset, --searchSort, --storeLimit, --json',
+        '예시: daiso cu-inventory 과자',
+        '예시: daiso cu-inventory 컵라면 --storeKeyword 강남 --size 10',
+    ],
+    'cgv-theaters': [
+        '명령: cgv-theaters',
+        '설명: CGV 극장 검색 API를 호출합니다.',
+        '사용법: daiso cgv-theaters [keyword] [--regionCode 값] [--playDate YYYYMMDD] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --regionCode, --playDate, --lat, --lng, --limit, --json',
+        '예시: daiso cgv-theaters 강남 --limit 5',
+        '예시: daiso cgv-theaters --regionCode 01 --playDate 20260304',
+    ],
+    'cgv-movies': [
+        '명령: cgv-movies',
+        '설명: CGV 영화 검색 API를 호출합니다.',
+        '사용법: daiso cgv-movies [keyword] [--playDate YYYYMMDD] [--theaterCode 값] [--movieCode 값] [--lat 값] [--lng 값] [--json]',
+        '옵션: --keyword, --playDate, --theaterCode, --movieCode, --lat, --lng, --json',
+        '예시: daiso cgv-movies 강남 --playDate 20260304',
+        '예시: daiso cgv-movies --playDate 20260304 --theaterCode 0056',
+    ],
+    'cgv-timetable': [
+        '명령: cgv-timetable',
+        '설명: CGV 시간표 API를 호출합니다.',
+        '사용법: daiso cgv-timetable [keyword] [--playDate YYYYMMDD] [--theaterCode 값] [--movieCode 값] [--lat 값] [--lng 값] [--json]',
+        '옵션: --keyword, --playDate, --theaterCode, --movieCode, --lat, --lng, --json',
+        '예시: daiso cgv-timetable 강남 --playDate 20260304',
+        '예시: daiso cgv-timetable --playDate 20260304 --theaterCode 0056',
+    ],
+    'lottecinema-theaters': [
+        '명령: lottecinema-theaters',
+        '설명: 롯데시네마 주변 지점 API를 호출합니다.',
+        '사용법: daiso lottecinema-theaters [keyword] [--lat 값] [--lng 값] [--playDate YYYYMMDD] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --playDate, --limit, --json',
+        '예시: daiso lottecinema-theaters 잠실 --limit 5',
+        '예시: daiso lottecinema-theaters --keyword "안산 중앙역" --limit 5',
+    ],
+    'lottecinema-movies': [
+        '명령: lottecinema-movies',
+        '설명: 롯데시네마 영화/회차 API를 호출합니다.',
+        '사용법: daiso lottecinema-movies [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--lat 값] [--lng 값] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --lat, --lng, --json',
+        '예시: daiso lottecinema-movies 잠실 --playDate 20260310',
+        '예시: daiso lottecinema-movies --playDate 20260310 --keyword "안산 중앙역"',
+    ],
+    'lottecinema-seats': [
+        '명령: lottecinema-seats',
+        '설명: 롯데시네마 잔여 좌석 API를 호출합니다.',
+        '사용법: daiso lottecinema-seats [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --lat, --lng, --limit, --json',
+        '예시: daiso lottecinema-seats 잠실 --playDate 20260310 --movieId 23816',
+        '예시: daiso lottecinema-seats --playDate 20260310 --keyword "안산 중앙역" --movieId 23816',
+    ],
+    'megabox-theaters': [
+        '명령: megabox-theaters',
+        '설명: 메가박스 주변 지점 API를 호출합니다.',
+        '사용법: daiso megabox-theaters [keyword] [--lat 값] [--lng 값] [--playDate YYYYMMDD] [--areaCode 값] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --playDate, --areaCode, --limit, --json',
+        '예시: daiso megabox-theaters 강남 --limit 5',
+        '예시: daiso megabox-theaters --keyword "코엑스" --limit 5',
+    ],
+    'megabox-movies': [
+        '명령: megabox-movies',
+        '설명: 메가박스 영화/회차 API를 호출합니다.',
+        '사용법: daiso megabox-movies [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--areaCode 값] [--lat 값] [--lng 값] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --areaCode, --lat, --lng, --json',
+        '예시: daiso megabox-movies 강남 --playDate 20260310',
+        '예시: daiso megabox-movies --playDate 20260310 --keyword "코엑스"',
+    ],
+    'megabox-seats': [
+        '명령: megabox-seats',
+        '설명: 메가박스 잔여 좌석 API를 호출합니다.',
+        '사용법: daiso megabox-seats [keyword] [--playDate YYYYMMDD] [--theaterId 값] [--movieId 값] [--areaCode 값] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --playDate, --theaterId, --movieId, --keyword, --areaCode, --lat, --lng, --limit, --json',
+        '예시: daiso megabox-seats 강남 --playDate 20260310 --movieId 23816',
+        '예시: daiso megabox-seats --playDate 20260310 --keyword "코엑스" --movieId 23816',
+    ],
+    'lottemart-stores': [
+        '명령: lottemart-stores',
+        '설명: 롯데마트 계열 매장 검색 API를 호출합니다.',
+        '사용법: daiso lottemart-stores [keyword] [--area 값] [--brandVariant 값] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --area, --brandVariant, --lat, --lng, --limit, --json',
+        '예시: daiso lottemart-stores 잠실 --area 서울',
+        '예시: daiso lottemart-stores --area 경기 --brandVariant lottemart --limit 10',
+    ],
+    'lottemart-products': [
+        '명령: lottemart-products',
+        '설명: 롯데마트 매장 기준 상품 검색 API를 호출합니다.',
+        '사용법: daiso lottemart-products <keyword> [--storeCode 값 | --storeName 값] [--area 값] [--pageLimit N] [--json]',
+        '필수: <keyword>, --storeCode 또는 --storeName',
+        '옵션: --storeCode, --storeName, --area, --pageLimit, --json',
+        '예시: daiso lottemart-products 콜라 --storeName 강변점 --area 서울',
+        '예시: daiso lottemart-products 우유 --storeCode 2301 --pageLimit 2',
+    ],
+    'emart24-stores': [
+        '명령: emart24-stores',
+        '설명: 이마트24 매장 검색 API를 호출합니다.',
+        '사용법: daiso emart24-stores [keyword] [--area1 값] [--area2 값] [--lat 값] [--lng 값] [--service24h true|false] [--limit N] [--json]',
+        '옵션: --keyword, --area1, --area2, --lat, --lng, --service24h, --limit, --json',
+        '예시: daiso emart24-stores 강남',
+        '예시: daiso emart24-stores --area1 서울특별시 --area2 강남구 --service24h true',
+    ],
+    'emart24-products': [
+        '명령: emart24-products',
+        '설명: 이마트24 상품 검색 API를 호출합니다.',
+        '사용법: daiso emart24-products <keyword> [--page N] [--pageSize N] [--sortType 값] [--saleProductYn Y|N] [--json]',
+        '필수: <keyword>',
+        '옵션: --page, --pageSize, --sortType, --saleProductYn, --json',
+        '예시: daiso emart24-products 두바이',
+        '예시: daiso emart24-products 도시락 --page 2 --pageSize 20',
+    ],
+    'emart24-inventory': [
+        '명령: emart24-inventory',
+        '설명: 이마트24 매장별 재고 API를 호출합니다.',
+        '사용법: daiso emart24-inventory <pluCd> --bizNoArr 코드1,코드2 [--json]',
+        '필수: <pluCd>, --bizNoArr',
+        '옵션: --bizNoArr, --json',
+        '예시: daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015,23233',
+    ],
+    'gs25-stores': [
+        '명령: gs25-stores',
+        '설명: GS25 매장 검색 API를 호출합니다.',
+        '사용법: daiso gs25-stores [keyword] [--lat 값] [--lng 값] [--limit N] [--json]',
+        '옵션: --keyword, --lat, --lng, --serviceCode, --limit, --json',
+        '예시: daiso gs25-stores 강남',
+        '예시: daiso gs25-stores --lat 37.4982 --lng 127.0276 --limit 10',
+    ],
+    'gs25-products': [
+        '명령: gs25-products',
+        '설명: GS25 상품 키워드 검색 API를 호출합니다.',
+        '사용법: daiso gs25-products <keyword> [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --serviceCode, --limit, --json',
+        '예시: daiso gs25-products 오감자',
+    ],
+    'gs25-inventory': [
+        '명령: gs25-inventory',
+        '설명: GS25 재고 검색 API를 호출합니다.',
+        '사용법: daiso gs25-inventory <keyword> [--storeKeyword 값] [--lat 값] [--lng 값] [--storeLimit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --storeKeyword, --lat, --lng, --serviceCode, --storeLimit, --json',
+        '예시: daiso gs25-inventory 오감자 --storeKeyword 강남',
+    ],
+    'seveneleven-products': [
+        '명령: seveneleven-products',
+        '설명: 세븐일레븐 상품 검색 API를 호출합니다.',
+        '사용법: daiso seveneleven-products <query> [--page N] [--size N] [--sort 값] [--json]',
+        '필수: <query>',
+        '옵션: --page, --size, --sort, --json',
+        '예시: daiso seveneleven-products 삼각김밥 --size 20',
+    ],
+    'seveneleven-stores': [
+        '명령: seveneleven-stores',
+        '설명: 세븐일레븐 매장 검색 API를 호출합니다.',
+        '사용법: daiso seveneleven-stores <keyword> [--limit N] [--json]',
+        '필수: <keyword>',
+        '옵션: --limit, --json',
+        '예시: daiso seveneleven-stores 안산 중앙역 --limit 10',
+    ],
+    'seveneleven-inventory': [
+        '명령: seveneleven-inventory',
+        '설명: 세븐일레븐 재고 API를 호출합니다.',
+        '사용법: daiso seveneleven-inventory <keyword> [--storeKeyword 값] [--storeLimit N] [--page N] [--size N] [--json]',
+        '필수: <keyword>',
+        '옵션: --keyword, --storeKeyword, --storeLimit, --page, --size, --json',
+        '예시: daiso seveneleven-inventory 핫식스 --storeKeyword "안산 중앙역" --storeLimit 10',
+    ],
+    'seveneleven-popwords': [
+        '명령: seveneleven-popwords',
+        '설명: 세븐일레븐 인기 검색어 API를 호출합니다.',
+        '사용법: daiso seveneleven-popwords [--label 값] [--json]',
+        '옵션: --label, --json',
+        '예시: daiso seveneleven-popwords --label home',
+    ],
+    'seveneleven-catalog': [
+        '명령: seveneleven-catalog',
+        '설명: 세븐일레븐 카탈로그 스냅샷 API를 호출합니다.',
+        '사용법: daiso seveneleven-catalog [--includeIssues true|false] [--includeExhibition true|false] [--limit N] [--json]',
+        '옵션: --includeIssues, --includeExhibition, --limit, --json',
+        '예시: daiso seveneleven-catalog --includeIssues true --includeExhibition true --limit 10',
+    ],
+};

package/dist/cliInteractive.js

@@ -4,12 +4,12 @@
  * 좌표 입력 없이 서비스/매장/상품을 순차 선택해 재고를 확인합니다.
  */
 import { createInterface } from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
+import process from 'node:process';
 import { pickFromList } from './cliPicker.js';
 import { fetchEnvelope, fetchStoresWithKeywordFallback } from './cli/interactiveFetch.js';
-import { askMenu, askNextAction, askNonEmpty, askYesNo, printStoreDetail } from './cli/interactivePrompt.js';
+import { askMenu, askNextAction, askNonEmpty, askYesNo, printStoreDetail, } from './cli/interactivePrompt.js';
 import { parseLotteCinemaTheaters, printTheaterDetail, runCuItemSearch, runDaisoItemSearch, runLotteCinemaSearch, runOliveyoungItemSearch, } from './cli/interactiveItemSearch.js';
-import { buildDaisoStoreKeywordVariants, isRecord, parseDaisoProducts, parseStores, toText } from './utils/cliInteractiveHelpers.js';
+import { buildDaisoStoreKeywordVariants, isRecord, parseDaisoProducts, parseStores, toText, } from './utils/cliInteractiveHelpers.js';
 function isLocationToken(token) {
     return /(?:역|점|동|구|시|군|읍|면|로|길)$/.test(token);
 }
@@ -22,7 +22,10 @@ export function inferDaisoFreeTextIntent(input) {
     const locationIndex = tokens.findIndex(isLocationToken);
     if (locationIndex >= 0) {
         const storeKeyword = tokens[locationIndex];
-        const productQuery = tokens.filter((_, index) => index !== locationIndex).join(' ').trim() || input.trim();
+        const productQuery = tokens
+            .filter((_, index) => index !== locationIndex)
+            .join(' ')
+            .trim() || input.trim();
         return { productQuery, storeKeyword };
     }
     const storeKeyword = tokens[tokens.length - 1];
@@ -47,7 +50,7 @@ async function askServiceChoice(prompt, writeOut) {
     }
 }
 function createPrompt() {
-    const rl = createInterface({ input, output });
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
     return {
         ask: async (question) => {
             const answer = await rl.question(question);

package/dist/core/errors.js

@@ -11,6 +11,7 @@ const SERVICE_PREFIXES = [
     'megabox',
     'lottecinema',
     'cgv',
+    'dtryx',
     'oliveyoung',
 ];
 function normalizeService(value) {
@@ -49,7 +50,17 @@ function buildHint(retryable) {
 }
 export function toStandardErrorDiagnostics(code, message, options = {}) {
     const inferred = inferServiceAndOperation(code);
-    const retryable = isRetryable(code, options.status || options.upstreamStatus);
+    // 실제 Zyte 진단 문구만 설정 오류로 취급해 일반적인 접근 차단과 구분합니다.
+    const configurationError = [
+        'Zyte API 호출 실패: 403 Your account has been suspended.',
+        'Zyte API 호출 실패: 403 account suspended',
+        'ZYTE_API_KEY가 설정되지 않았습니다.',
+    ].some((diagnostic) => message.includes(diagnostic));
+    const gs25AuthenticationError = code === 'GS25_UPSTREAM_UNAVAILABLE' &&
+        message.includes('GS25 재고 서비스 인증을 사용할 수 없습니다.');
+    const retryable = !configurationError &&
+        !gs25AuthenticationError &&
+        isRetryable(code, options.status || options.upstreamStatus);
     return {
         code,
         message,
@@ -58,7 +69,11 @@ export function toStandardErrorDiagnostics(code, message, options = {}) {
         service: options.service || inferred.service,
         operation: options.operation || inferred.operation,
         upstreamStatus: options.upstreamStatus,
-        hint: buildHint(retryable),
+        hint: gs25AuthenticationError
+            ? '운영자는 GS25_API_KEY 설정을 확인하세요.'
+            : configurationError
+                ? '운영자는 ZYTE_API_KEY 설정과 Zyte 계정 상태를 확인하세요.'
+                : buildHint(retryable),
     };
 }
 export function getErrorMessage(error) {

package/dist/core/registry.js

@@ -3,7 +3,7 @@
  *
  * 서비스 프로바이더를 등록하고 MCP 서버에 도구를 연결합니다.
  */
-import { getErrorMessage, toStandardErrorDiagnostics } from './errors.js';
+import { getErrorMessage } from './errors.js';
 import { createToolOutputSchema } from './outputSchema.js';
 function parseJsonText(text) {
     try {
@@ -181,24 +181,22 @@ export class ServiceRegistry {
                 return {
                     isError: true,
                     content: [{ type: 'text', text: message }],
-                    structuredContent: {
-                        error: toStandardErrorDiagnostics('TOOL_EXECUTION_FAILED', message, {
-                            operation: tool.name,
-                        }),
-                    },
                 };
             }
-            const response = {
-                content: result.content.map((item) => ({
-                    type: item.type,
-                    text: item.text,
-                })),
-                structuredContent: buildStructuredContent(result),
-            };
+            const content = result.content.map((item) => ({
+                type: item.type,
+                text: item.text,
+            }));
             if (result.isError) {
-                response.isError = true;
+                return {
+                    isError: true,
+                    content,
+                };
             }
-            return response;
+            return {
+                content,
+                structuredContent: buildStructuredContent(result),
+            };
         });
     }
     /**

package/dist/durableObjects/dailyRateLimiter.js

@@ -0,0 +1,185 @@
+/**
+ * IP별 KST 일일 호출량을 저장하는 Durable Object
+ */
+import { RATE_LIMIT_SERVICES, RateLimitMetricsStore, StaleRateLimitEventDayError, } from './rateLimitMetricsStore.js';
+export const DAILY_RATE_LIMIT = 3000;
+const KST_OFFSET_MS = 9 * 60 * 60 * 1000;
+const COUNTER_KEY = 'counter';
+const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+// DurableObjectId.toString()이 반환하는 namespace-scoped 불투명 ID 형식입니다.
+const DURABLE_OBJECT_ID_PATTERN = /^[0-9a-f]{64}$/;
+const BLOCKED_EVENT_FIELDS = ['eventId', 'occurredAt', 'day', 'service', 'identityId'];
+export function toKstDay(nowMs) {
+    return new Date(nowMs + KST_OFFSET_MS).toISOString().slice(0, 10);
+}
+export function nextKstMidnightEpochSeconds(nowMs) {
+    const shifted = new Date(nowMs + KST_OFFSET_MS);
+    const nextMidnightUtcMs = Date.UTC(shifted.getUTCFullYear(), shifted.getUTCMonth(), shifted.getUTCDate() + 1) -
+        KST_OFFSET_MS;
+    return Math.floor(nextMidnightUtcMs / 1000);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isExactDate(value) {
+    if (typeof value !== 'string' || !DATE_PATTERN.test(value)) {
+        return false;
+    }
+    const timestamp = Date.parse(`${value}T00:00:00.000Z`);
+    return Number.isFinite(timestamp) && new Date(timestamp).toISOString().slice(0, 10) === value;
+}
+function isRateLimitService(value) {
+    return typeof value === 'string' && RATE_LIMIT_SERVICES.includes(value);
+}
+function isBlockedRateLimitEvent(value) {
+    if (!isRecord(value) ||
+        Object.keys(value).length !== BLOCKED_EVENT_FIELDS.length ||
+        !BLOCKED_EVENT_FIELDS.every((field) => Object.hasOwn(value, field))) {
+        return false;
+    }
+    const occurredAt = value.occurredAt;
+    return (typeof value.eventId === 'string' &&
+        UUID_PATTERN.test(value.eventId) &&
+        typeof occurredAt === 'number' &&
+        Number.isSafeInteger(occurredAt) &&
+        occurredAt >= 0 &&
+        Number.isFinite(new Date(occurredAt).getTime()) &&
+        Number.isFinite(new Date(occurredAt + KST_OFFSET_MS).getTime()) &&
+        isExactDate(value.day) &&
+        value.day === toKstDay(occurredAt) &&
+        isRateLimitService(value.service) &&
+        typeof value.identityId === 'string' &&
+        DURABLE_OBJECT_ID_PATTERN.test(value.identityId));
+}
+async function parseBlockedEvent(request) {
+    let value;
+    try {
+        value = await request.json();
+    }
+    catch {
+        return undefined;
+    }
+    if (!isBlockedRateLimitEvent(value)) {
+        return undefined;
+    }
+    // 검증한 필드만 새 객체로 만들어 원장에 전달합니다.
+    return {
+        eventId: value.eventId,
+        occurredAt: value.occurredAt,
+        day: value.day,
+        service: value.service,
+        identityId: value.identityId,
+    };
+}
+function hasStrictStatsParameters(searchParams) {
+    let fromCount = 0;
+    let toCount = 0;
+    let asOfCount = 0;
+    let serviceCount = 0;
+    for (const [key] of searchParams) {
+        if (key === 'from') {
+            fromCount += 1;
+        }
+        else if (key === 'to') {
+            toCount += 1;
+        }
+        else if (key === 'asOf') {
+            asOfCount += 1;
+        }
+        else if (key === 'service') {
+            serviceCount += 1;
+        }
+        else {
+            return false;
+        }
+    }
+    return fromCount === 1 && toCount === 1 && asOfCount === 1 && serviceCount <= 1;
+}
+function parseStatsInput(url) {
+    if (!hasStrictStatsParameters(url.searchParams)) {
+        return undefined;
+    }
+    const from = url.searchParams.get('from');
+    const to = url.searchParams.get('to');
+    const asOfDay = url.searchParams.get('asOf');
+    const service = url.searchParams.get('service');
+    if (!isExactDate(from) || !isExactDate(to) || !isExactDate(asOfDay) || from > to) {
+        return undefined;
+    }
+    if (service !== null && !isRateLimitService(service)) {
+        return undefined;
+    }
+    return service === null ? { from, to, asOfDay } : { from, to, asOfDay, service };
+}
+function errorResponse(message, status) {
+    return Response.json({ error: message }, { status });
+}
+export class DailyRateLimiter {
+    state;
+    metricsStore;
+    constructor(state) {
+        this.state = state;
+    }
+    async consume(nowMs = Date.now()) {
+        const day = toKstDay(nowMs);
+        const stored = await this.state.storage.get(COUNTER_KEY);
+        const currentCount = stored?.day === day ? stored.count : 0;
+        const allowed = currentCount < DAILY_RATE_LIMIT;
+        const count = allowed ? currentCount + 1 : currentCount;
+        if (allowed) {
+            await this.state.storage.put(COUNTER_KEY, { day, count });
+        }
+        return {
+            allowed,
+            count,
+            remaining: Math.max(0, DAILY_RATE_LIMIT - count),
+            resetAt: nextKstMidnightEpochSeconds(nowMs),
+            day,
+        };
+    }
+    async fetch(request) {
+        const url = new URL(request.url);
+        if (request.method === 'POST' && url.pathname === '/consume') {
+            return Response.json(await this.consume());
+        }
+        if (request.method === 'POST' && url.pathname === '/blocked-events') {
+            const event = await parseBlockedEvent(request);
+            if (!event) {
+                return errorResponse('차단 이벤트 형식이 올바르지 않습니다.', 400);
+            }
+            const store = this.getMetricsStore();
+            try {
+                await store.record(event);
+            }
+            catch (error) {
+                if (error instanceof StaleRateLimitEventDayError) {
+                    return errorResponse('차단 이벤트 날짜가 만료되었습니다.', 409);
+                }
+                throw error;
+            }
+            return new Response(null, { status: 204 });
+        }
+        if (request.method === 'GET' && url.pathname === '/stats') {
+            const input = parseStatsInput(url);
+            if (!input) {
+                return errorResponse('통계 조회 조건이 올바르지 않습니다.', 400);
+            }
+            if (input.asOfDay !== toKstDay(Date.now())) {
+                return errorResponse('통계 조회 기준 날짜가 만료되었습니다.', 409);
+            }
+            const store = this.getMetricsStore();
+            return Response.json(await store.query(input));
+        }
+        return errorResponse('요청한 작업을 찾을 수 없습니다.', 404);
+    }
+    async alarm() {
+        const store = this.getMetricsStore();
+        await store.cleanup();
+        await store.ensureAlarm();
+    }
+    getMetricsStore() {
+        this.metricsStore ??= new RateLimitMetricsStore(this.state);
+        return this.metricsStore;
+    }
+}