import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'; /** * stdio 도구 묶음(toolset) — 붙는 순간 모델 컨텍스트에 실리는 도구 표면을 사용자가 고르게 한다. * * 도구 114개를 전부 노출하면 설명·스키마만 16만 자가 넘는다(2026-09-23 실측, 상품 묶음이 그 절반). * Cursor·ChatGPT 커넥터처럼 도구 목록을 통째로 싣는 클라이언트에서는 대화가 시작되기도 전에 컨텍스트가 줄어든다. * 그래서 기본은 문서·결제·알림톡만 켜고, 상품·커머스는 env `BOOTPAY_TOOLSETS` 로 켠다. * * 두 가지를 지킨다. * 1) 거르는 곳은 **등록 단계**다 (profiles.ts 와 같은 이유) — 목록에 있는데 호출만 막으면 모델이 없는 길을 두드린다. * 2) 모르는 묶음 이름은 기동 시점에 던진다 — 오타가 조용히 "도구 0개"나 "전수 노출"로 떨어지면 원인을 못 찾는다. * * @comment_by ehowlsla * @date: 2026-09-23 */ export declare const TOOLSET_NAMES: readonly ["docs", "payment", "alimtalk", "product", "commerce"]; export type ToolsetName = typeof TOOLSET_NAMES[number]; /** 아무것도 지정하지 않았을 때 켜지는 묶음. README 의 「알림톡 도구는 기본 노출」 약속을 지킨다 */ export declare const DEFAULT_TOOLSETS: readonly ToolsetName[]; export declare const TOOLSET_DESCRIPTIONS: Readonly>; /** * 도구가 속한 묶음. 둘 이상에 속하면 그중 하나만 켜져도 등록된다. * 어디에도 속하지 않는 도구는 null — 새 도구가 조용히 사라지지 않도록 항상 등록하고, * toolsets.test.ts 가 null 이 하나라도 있으면 깨진다(목록에 넣으라는 신호). */ export declare function toolsetsOf(name: string): ToolsetName[] | null; /** * env 를 묶음 목록으로 바꾼다. * * - `BOOTPAY_TOOLSETS=payment,product` — 쉼표 구분. `all` 은 전부. 이름이 하나도 없으면 기본값 * - docs 는 항상 들어간다(끄면 문서 도구 없이 결제 코드를 만들게 된다) * - `BOOTPAY_COMMERCE_ENABLED=true` 는 commerce 와 product 를 켠 것으로 본다 — 그 env 를 쓰던 사용자는 묶음 도입 전 * (전 도구 + commerce_*) 표면을 그대로 받는다. 쇼핑몰을 만들면 상품 등록 도구가 곧 필요해서 product 를 함께 켠다 */ export declare function resolveToolsets(env?: Record): ToolsetName[]; /** * 등록용 서버 표면을 묶음으로 감싼다. `server.tool` 만 가로채고 나머지는 원본에 흘려보낸다. * 실제 등록은 원본 서버에 쌓이므로 호출자는 원본으로 connect 한다. */ export declare function applyToolsets(server: McpServer, enabled: readonly ToolsetName[]): McpServer; /** * 꺼진 묶음이 무엇이고 어떻게 켜는지 모델이 사용자에게 말할 수 있게 한다. * 도구가 안 보인다고 모델이 기억으로 대신 답하는 것을 막는 자리다. */ export declare function registerListToolsetsTool(server: McpServer, enabled: readonly ToolsetName[]): void; //# sourceMappingURL=toolsets.d.ts.map