import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'; import { TokenManager } from '../auth/token-manager.js'; import { InternalApiClient } from '../client/internal-api.js'; import { CoreApiClient } from '../client/core-api.js'; import { StorageApiClient } from '../client/storage-api.js'; import type { LocalImageReader } from '../lib/image-source.js'; /** * 원격(Cloudflare Workers)에도 올릴 수 있는 도구만 모은 모듈. * * ⚠️ 이 파일의 import 그래프에는 node:fs / node:os / node:http / node:child_process 가 * 하나도 없어야 한다. 원격 진입점은 이 모듈만 import 하므로, 여기 그래프가 곧 Workers 번들이다. * 로컬 전용 도구(login·browser_*·set_token·switch_project·test_mall·generate_commerce_code)는 * tools/index.ts 쪽에만 있고 여기에서는 참조하지 않는다. * * 원격 제외 기준 * - login / set_token — 자격증명·토큰이 대화 컨텍스트와 호스팅 업체 로그에 남는다 * - browser_login / browser_select_project — 127.0.0.1 콜백 서버가 사용자 PC 가 아니라 서버에서 열린다 * - switch_project — 원격은 인가 시점에 프로젝트를 토큰에 고정한다(대화 중간 전환 사고 방지) * - list_projects / create_project / create_seller / update_seller — 그랜트에 묶인 프로젝트 밖을 드러내거나 만든다 * - 결제설정·키체인·위젯 쓰기 — 인가 서버가 발급하는 스코프가 project.product.read/write 뿐이라 * (OauthClient::SUPPORTED_SCOPES) 이 도구들을 정당화할 스코프가 아예 없다. 스코프가 생기기 전에는 제외한다. */ export type ToolProfile = 'stdio' | 'remote'; export interface AdminToolContext { tokenManager: TokenManager; internalApi: InternalApiClient; coreApi: CoreApiClient; storageApi: StorageApiClient; /** stdio 에서만 주입된다. 없으면 로컬 파일 경로 입력이 거부된다. */ readLocalFile?: LocalImageReader; } /** 원격 프로파일에 노출되는 도구 이름 — 프로파일 회귀 테스트의 기준값이기도 하다 */ export declare const REMOTE_TOOL_NAMES: readonly ["get_auth_status", "list_products", "get_product", "create_product", "update_product", "delete_product", "create_test_products", "list_categories", "create_category", "update_category", "delete_category", "reorder_categories", "list_subscription_settings", "list_delivery_shippings", "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", "update_content_block", "delete_content_block", "list_content_block_products", "list_content_templates", "create_content_template", "delete_content_template", "list_digital_codes", "register_digital_codes", "disable_digital_code"]; /** 원격에 절대 노출하지 않는 도구 — 새 도구를 추가할 때 여기 기준으로 다시 판단한다 */ export declare const REMOTE_EXCLUDED_TOOL_NAMES: readonly ["login", "set_token", "browser_login", "browser_select_project", "switch_project", "logout", "list_projects", "create_project", "create_seller", "update_seller", "search_sellers", "get_seller", "list_keychains", "create_keychain", "delete_keychain", "list_api_scopes", "get_payment_settings", "activate_payment_method", "set_sandbox_mode", "set_payment_mode", "update_payment_resource"]; /** * 상품 등록 트랙 도구 등록 — stdio·원격 양쪽에서 공통으로 쓴다. * stdio 는 여기에 더해 tools/index.ts 가 로컬 전용 도구를 추가로 등록한다. */ export declare function registerRemoteAdminTools(server: McpServer, ctx: AdminToolContext, profile?: ToolProfile): void; //# sourceMappingURL=remote-tools.d.ts.map