import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'; import { InternalApiClient } from '../client/internal-api.js'; /** internal-api `/category` 트리 노드 (Category::DataFormat#all_list_data) */ export interface CategoryNode { _id: string; name: string; parent_category_id?: string; status_display?: boolean; status_best?: boolean; filter_color?: number | null; filter_size?: number | null; children?: CategoryNode[]; } export interface FlatCategory { id: string; name: string; /** '상의 > 티셔츠 > 반팔' */ path: string; /** 1 = 대분류 */ depth: number; parent_category_id: string | null; status_display?: boolean; status_best?: boolean; child_count: number; /** 자기 자신을 제외한 모든 후손 수 */ descendant_count: number; } /** 카테고리 계층 최대 단계 — 모델 주석 기준 대/중/소/세 4단계 */ export declare const MAX_CATEGORY_DEPTH = 4; export declare const PATH_SEPARATOR_PATTERN: RegExp; /** * 응답 본문이 배열/`{data:[]}`/`{list:[]}` 중 무엇으로 와도 트리 배열을 꺼낸다. * render_json 은 전달한 객체를 그대로 본문으로 쓰지만, 호출부가 감싸는 형태가 바뀌어도 * 카테고리 도구 전체가 조용히 빈 목록을 반환하는 상황은 피한다. */ export declare function extractCategoryTree(payload: unknown): CategoryNode[]; export declare function countDescendants(node: CategoryNode): number; /** 트리를 '대 > 중 > 소' 경로 문자열이 붙은 평면 목록으로 변환 */ export declare function flattenCategoryTree(tree: CategoryNode[], parentPath?: string, depth?: number, parentId?: string | null): FlatCategory[]; /** '상의 > 티셔츠 > 반팔' → ['상의','티셔츠','반팔'] */ export declare function parseCategoryPath(path: string): string[]; export declare function findNodeById(tree: CategoryNode[], id: string): { node: CategoryNode; parentId: string | null; path: string; } | null; export declare function registerCategoryTools(server: McpServer, internalApi: InternalApiClient): void; //# sourceMappingURL=category.d.ts.map