import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'; /** * 도구 프로파일 — 같은 코드로 뜬 MCP 서버가 "누가 붙었느냐"에 따라 다른 도구 표면을 갖게 한다. * * 두 개뿐이다. * - `full` 기본값. 외부 개발자용 — 현행 REMOTE_TOOL_NAMES 전수, 정책 없음. * - `product-assistant` 내부 AI 상품등록용 — 상품 등록에 필요한 도구만, save_by 는 임시저장 고정. * * 두 가지를 지킨다. * * 1) 화이트리스트는 **등록 단계**에서 거른다. * 목록에는 보이면서 호출만 막으면 모델이 없는 길을 계속 두드리며 턴을 낭비한다. * 프로파일 밖 도구는 tools/list 에 아예 나타나지 않고, tools/call 은 "없는 도구"로 떨어진다. * * 2) 인자 정책은 **핸들러 앞에서** 확정한다. * 프롬프트는 지켜지지 않는다 — 모델은 save_by 를 발행으로 올리려 한다(2026-08-03 실측). * 도구가 실행되기 직전 이 계층이 마지막으로 값을 덮어쓴다. * * `full` 은 화이트리스트도 정책도 없으므로 프록시를 아예 만들지 않는다 — 외부 경로의 동작은 * 이 파일이 추가되기 전과 바이트 단위로 같다. * * @date: 2026-08-03 */ export type McpProfileName = 'full' | 'product-assistant'; export interface ToolArgumentPolicy { /** 모델이 뭘 보냈든 이 값으로 덮어쓴다 */ force?: Record; /** 모델이 안 보냈을 때만 채운다 — 모델의 명시적 선택은 존중한다 */ fallback?: Record; /** 도구 설명에 덧붙일 한 줄. 막힌 길을 미리 알려 턴 낭비를 막는다 */ note?: string; } export interface McpToolProfile { name: McpProfileName; /** 노출 도구 화이트리스트. null = 제한 없음(전수 노출) */ tools: readonly string[] | null; /** 도구 이름 → 인자 정책 */ policies: Readonly>; } /** * 내부 AI 상품등록이 쓰는 도구. * * 상품을 만들고(create/update), 고르게 하고(list/get), 사진을 올리고(upload), * 상세설명 블록을 채우는 데까지가 전부다. 삭제 계열(delete_product·delete_category· * delete_content_block), 대량 생성(create_test_products), 디지털 코드풀은 등록 시나리오에 * 필요 없으므로 빠진다 — 안 쓰는 것을 노출하는 것 자체가 리스크다. */ export declare const PRODUCT_ASSISTANT_TOOL_NAMES: readonly ["get_auth_status", "list_products", "get_product", "create_product", "update_product", "list_categories", "create_category", "list_delivery_shippings", "list_subscription_settings", "create_delivery_shipping", "create_subscription_setting", "list_delivery_shipping_bundles", "get_product_form_setting", "get_product_info_notice_forms", "upload_product_images", "list_content_blocks", "create_content_block", "list_content_templates"]; export declare const FULL_PROFILE: McpToolProfile; export declare const PRODUCT_ASSISTANT_PROFILE: McpToolProfile; export declare const MCP_PROFILES: Readonly>; /** * 프로파일 이름을 정의로 바꾼다. * * 모르는 이름은 조용히 `full` 로 떨어뜨리지 않고 던진다. 내부 인스턴스의 ENV 오타가 * "도구 전수 노출"로 이어지는 것이 이 계층에서 가장 나쁜 실패다 — 기동 시점에 터지는 편이 낫다. */ export declare function resolveProfile(profile?: McpProfileName | McpToolProfile | null): McpToolProfile; /** fallback → force 순으로 인자를 확정한다. force 가 항상 마지막에 이긴다. */ export declare function applyArgumentPolicy(params: unknown, policy: ToolArgumentPolicy): Record; /** * 등록용 서버 표면을 프로파일로 감싼다. * * 반환값은 `server.tool` 만 가로채는 프록시다. 나머지 메서드는 원본에 바인딩해 그대로 흘려보내므로 * (`Reflect.get(target, prop, target)`) SDK 내부의 private 필드 접근이 깨지지 않는다. * 실제 등록은 원본 서버에 쌓이니 호출자는 `connect()` 를 원본으로 하면 된다. */ export declare function applyToolProfile(server: McpServer, profile: McpToolProfile): McpServer; //# sourceMappingURL=profiles.d.ts.map