@brxce/mcp-server 1.1.4 → 1.1.6

package/dist/tools/worknode-detail-tool.js

@@ -0,0 +1,227 @@
+import { z } from 'zod';
+import { getErrorMessage, isNotFoundError } from '../utils/error-utils.js';
+import { workspaceContext } from '../services/workspace-context.js';
+// Emoji mappings
+const NODE_TYPE_EMOJI = {
+    goal: '🎯',
+    project: '📁',
+    subproject: '📂',
+    task: '✅',
+    subtask: '☑️',
+    note: '📝',
+};
+const STATUS_EMOJI = {
+    backlog: '📥',
+    not_started: '⭕',
+    in_progress: '🔄',
+    completed: '✅',
+    pause: '⏸️',
+    archived: '📦',
+};
+const PRIORITY_EMOJI = {
+    critical: '🔥',
+    urgent: '⚡',
+    high: '🔴',
+    medium: '🟡',
+    low: '🟢',
+};
+/**
+ * Register WorkNode Detail tool
+ * Provides detailed view of a worknode including description and direct children summary
+ */
+export function registerWorknodeDetailTool(server, apiClient) {
+    server.registerTool('brxce_worknode_detail', {
+        description: `Get detailed WorkNode information including description and direct children summary.
+
+Use this when you need:
+- Full description/context of a worknode
+- Summary of immediate child tasks
+- Quick overview before starting work
+
+Returns: Full node details + children summary + status breakdown. For full subtree, use brxce_worknode_subtree.`,
+        inputSchema: {
+            nodeId: z.string().describe('The WorkNode ID (UUID or displayId like #123 or 123)'),
+            workspaceId: z.string().uuid().optional().describe('Workspace ID (required when using displayId format)'),
+        },
+    }, async (args) => {
+        const { nodeId, workspaceId: providedWorkspaceId } = args;
+        if (!nodeId) {
+            throw new Error('nodeId is required');
+        }
+        // Auto-resolve workspaceId from context if using displayId
+        const resolvedWorkspaceId = workspaceContext.resolveWorkspaceId(providedWorkspaceId, nodeId);
+        try {
+            // 1. Fetch single node with full description via read API
+            const readResponse = await apiClient.post('/mcp/worknodes/read', {
+                query: nodeId,
+                workspaceId: resolvedWorkspaceId,
+                limit: 1,
+            });
+            if (!readResponse.success || !readResponse.data?.nodes?.length) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to fetch worknode: ${readResponse.message || 'Node not found'}`,
+                        },
+                    ],
+                };
+            }
+            const node = readResponse.data.nodes[0];
+            // 2. Fetch children via subtree API
+            const queryParams = new URLSearchParams();
+            if (resolvedWorkspaceId) {
+                queryParams.append('workspaceId', resolvedWorkspaceId);
+            }
+            queryParams.append('maxDepth', '1');
+            queryParams.append('compact', 'true');
+            queryParams.append('limit', '100');
+            const queryString = queryParams.toString();
+            const encodedNodeId = encodeURIComponent(node.id); // Use resolved UUID
+            const subtreeUrl = `/mcp/worknodes/${encodedNodeId}/subtree${queryString ? `?${queryString}` : ''}`;
+            const subtreeResponse = await apiClient.get(subtreeUrl);
+            let children = [];
+            let stats = { byStatus: {}, byPriority: {} };
+            if (subtreeResponse.success && subtreeResponse.data) {
+                children = subtreeResponse.data.children || [];
+                stats = subtreeResponse.data.stats || { byStatus: {}, byPriority: {} };
+            }
+            // Build detailed Markdown response
+            const nodeDisplayId = node.displayId ?? node.id;
+            const typeEmoji = NODE_TYPE_EMOJI[node.nodeType] || '📄';
+            const statusEmoji = STATUS_EMOJI[node.status] || '❓';
+            const priorityEmoji = PRIORITY_EMOJI[node.priority] || '';
+            let resultText = `## ${typeEmoji} ${node.title} (#${nodeDisplayId})\n\n`;
+            // Status & Priority
+            resultText += `**Status:** ${statusEmoji} ${node.status}`;
+            if (priorityEmoji)
+                resultText += ` | **Priority:** ${priorityEmoji} ${node.priority}`;
+            if (node.progress > 0)
+                resultText += ` | **Progress:** ${node.progress}%`;
+            resultText += '\n\n';
+            // Dates
+            const dates = [];
+            if (node.dueDate) {
+                dates.push(`📅 Due: ${new Date(node.dueDate).toLocaleDateString()}`);
+            }
+            if (node.startDate) {
+                dates.push(`🗓️ Start: ${new Date(node.startDate).toLocaleDateString()}`);
+            }
+            if (dates.length > 0) {
+                resultText += dates.join(' | ') + '\n\n';
+            }
+            // Assignees
+            if (node.assignee && node.assignee.length > 0) {
+                const assigneeNames = node.assignee.map((a) => typeof a === 'string' ? a : (a.name || a.id));
+                resultText += `**Assignees:** 👤 ${assigneeNames.join(', ')}\n\n`;
+            }
+            // Tags
+            if (node.tags && node.tags.length > 0) {
+                const tagNames = node.tags.map((t) => typeof t === 'string' ? t : t.name);
+                resultText += `**Tags:** 🏷️ ${tagNames.join(', ')}\n\n`;
+            }
+            // Description
+            resultText += `### 📝 Description\n\n`;
+            if (node.description && node.description.trim()) {
+                resultText += node.description + '\n\n';
+            }
+            else {
+                resultText += '_No description_\n\n';
+            }
+            // Children Summary
+            resultText += `### 📊 하위 업무 요약\n\n`;
+            if (children.length === 0) {
+                resultText += '_하위 업무 없음_\n\n';
+            }
+            else {
+                // Status breakdown
+                const statusBreakdown = stats?.byStatus || {};
+                const inProgress = statusBreakdown['in_progress'] || 0;
+                const notStarted = statusBreakdown['not_started'] || 0;
+                const backlog = statusBreakdown['backlog'] || 0;
+                const completed = statusBreakdown['completed'] || 0;
+                const total = children.length;
+                resultText += `| 상태 | 개수 |\n`;
+                resultText += `|------|------|\n`;
+                if (inProgress > 0)
+                    resultText += `| 🔄 진행중 | ${inProgress} |\n`;
+                if (notStarted > 0)
+                    resultText += `| ⭕ 대기 | ${notStarted} |\n`;
+                if (backlog > 0)
+                    resultText += `| 📥 백로그 | ${backlog} |\n`;
+                if (completed > 0)
+                    resultText += `| ✅ 완료 | ${completed} |\n`;
+                resultText += `| **합계** | **${total}** |\n\n`;
+                // Progress bar
+                if (total > 0) {
+                    const completedRatio = completed / total;
+                    const progressBar = '█'.repeat(Math.floor(completedRatio * 10)) +
+                        '░'.repeat(10 - Math.floor(completedRatio * 10));
+                    resultText += `**진행률:** ${progressBar} ${Math.round(completedRatio * 100)}% (${completed}/${total})\n\n`;
+                }
+                // Direct children list (non-completed only)
+                const activeChildren = children.filter((c) => c.status !== 'completed' && c.status !== 'archived');
+                if (activeChildren.length > 0) {
+                    resultText += `### 📋 활성 하위 업무 (${activeChildren.length}개)\n\n`;
+                    activeChildren.slice(0, 10).forEach((child) => {
+                        const childDisplayId = child.displayId ?? child.id;
+                        const childTypeEmoji = NODE_TYPE_EMOJI[child.nodeType] || '📄';
+                        const childStatusEmoji = STATUS_EMOJI[child.status] || '';
+                        const childPriorityEmoji = PRIORITY_EMOJI[child.priority] || '';
+                        resultText += `- ${childTypeEmoji} **${child.title}** (#${childDisplayId}) ${childStatusEmoji} ${childPriorityEmoji}`;
+                        if (child.dueDate) {
+                            resultText += ` 📅 ${new Date(child.dueDate).toLocaleDateString()}`;
+                        }
+                        resultText += '\n';
+                    });
+                    if (activeChildren.length > 10) {
+                        resultText += `\n_... and ${activeChildren.length - 10} more_\n`;
+                    }
+                }
+            }
+            resultText += `\n---\n`;
+            if (resolvedWorkspaceId) {
+                resultText += `**Workspace ID:** \`${resolvedWorkspaceId}\`\n`;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'WorkNode not found',
+                                message: `WorkNode with ID ${nodeId} does not exist or you don't have access to it.`,
+                                nodeId,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to fetch worknode detail',
+                            message: getErrorMessage(error),
+                            nodeId,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=worknode-detail-tool.js.map

package/dist/tools/worknode-detail-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worknode-detail-tool.js","sourceRoot":"","sources":["../../src/tools/worknode-detail-tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/worknode-subtree-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worknode-subtree-tool.d.ts","sourceRoot":"","sources":["../../src/tools/worknode-subtree-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAqG3D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAyLlF"}
+{"version":3,"file":"worknode-subtree-tool.d.ts","sourceRoot":"","sources":["../../src/tools/worknode-subtree-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA+H3D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAyLlF"}

package/dist/tools/worknode-subtree-tool.js

@@ -46,7 +46,7 @@ function formatNodeLine(node, depth) {
     }
     if (node.dueDate) {
         const dueDate = new Date(node.dueDate);
-        metadata.push(`due: ${dueDate.toISOString().split('T')[0]}`);
+        metadata.push(`📅 ${dueDate.toISOString().split('T')[0]}`);
     }
     if (metadata.length > 0) {
         line += ` (${metadata.join(', ')})`;
@@ -54,15 +54,37 @@ function formatNodeLine(node, depth) {
     return line;
 }
 /**
- * Build tree structure from flat children array
+ * Build tree structure from flat children array using depth-based approach
  */
-function buildChildrenTree(children, parentId, depth) {
+function buildTreeByDepth(children, rootId) {
+    if (children.length === 0)
+        return '';
     let result = '';
-    const directChildren = children.filter(c => c.parentNodeId === parentId);
-    for (const child of directChildren) {
-        result += formatNodeLine(child, depth) + '\\n';
-        // Recursively add grandchildren
-        result += buildChildrenTree(children, child.id, depth + 1);
+    // Sort children by depth first, then by their order
+    const sortedChildren = [...children].sort((a, b) => {
+        const depthDiff = (a.depth ?? 0) - (b.depth ?? 0);
+        if (depthDiff !== 0)
+            return depthDiff;
+        return 0;
+    });
+    // Build tree recursively using parentNodeId
+    function buildSubtree(parentId, depth) {
+        let subtree = '';
+        const directChildren = sortedChildren.filter(c => c.parentNodeId === parentId);
+        for (const child of directChildren) {
+            subtree += formatNodeLine(child, depth) + '\n';
+            // Recursively add grandchildren
+            subtree += buildSubtree(child.id, depth + 1);
+        }
+        return subtree;
+    }
+    result = buildSubtree(rootId, 1);
+    // If no children found via parentNodeId, fallback to depth-based display
+    if (result === '' && sortedChildren.length > 0) {
+        for (const child of sortedChildren) {
+            const nodeDepth = child.depth ?? 1;
+            result += formatNodeLine(child, nodeDepth) + '\n';
+        }
     }
     return result;
 }
@@ -163,12 +185,12 @@ Returns: Markdown formatted tree with statistics. Dates in UTC.`,
                 resultText += `\\n`;
             }
             // Tree structure
-            resultText += `**Subtree Structure:**\\n\\n`;
+            resultText += `**Subtree Structure:**\n\n`;
             // Root node (depth 0)
-            resultText += formatNodeLine(node, 0) + '\\n';
-            // Children (recursively)
+            resultText += formatNodeLine(node, 0) + '\n';
+            // Children (recursively using depth-based tree building)
             if (children.length > 0) {
-                resultText += buildChildrenTree(children, node.id, 1);
+                resultText += buildTreeByDepth(children, node.id);
             }
             resultText += `\\n---\\n`;
             resultText += `**Note:** This subtree shows the node and all its descendants.\\n`;

package/dist/tools/worknode-subtree-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"worknode-subtree-tool.js","sourceRoot":"","sources":["../../src/tools/worknode-subtree-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worknode-subtree-tool.js","sourceRoot":"","sources":["../../src/tools/worknode-subtree-tool.ts"],"names":[],"mappings":"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"}

package/dist/utils/bot-scoped-server.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Bot-scoped MCP Server wrapper.
+ *
+ * Creates a proxy around McpServer that filters out tools
+ * not allowed for bot sessions during registration.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Wrap an McpServer to filter tool registrations for bot sessions.
+ * Non-allowed tools are silently skipped during registration.
+ */
+export declare function createBotScopedServer(server: McpServer): McpServer;
+//# sourceMappingURL=bot-scoped-server.d.ts.map

package/dist/utils/bot-scoped-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-scoped-server.d.ts","sourceRoot":"","sources":["../../src/utils/bot-scoped-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAiBlE"}

package/dist/utils/bot-scoped-server.js

@@ -0,0 +1,30 @@
+/**
+ * Bot-scoped MCP Server wrapper.
+ *
+ * Creates a proxy around McpServer that filters out tools
+ * not allowed for bot sessions during registration.
+ */
+import { isBotAllowedTool } from '../config/bot-tool-scope.js';
+/**
+ * Wrap an McpServer to filter tool registrations for bot sessions.
+ * Non-allowed tools are silently skipped during registration.
+ */
+export function createBotScopedServer(server) {
+    return new Proxy(server, {
+        get(target, prop, receiver) {
+            if (prop === 'tool' || prop === 'registerTool') {
+                const originalMethod = Reflect.get(target, prop, receiver);
+                return function (nameOrConfig, ...args) {
+                    const toolName = typeof nameOrConfig === 'string' ? nameOrConfig : nameOrConfig?.name;
+                    if (toolName && !isBotAllowedTool(toolName)) {
+                        // Skip registration for disallowed tools
+                        return;
+                    }
+                    return originalMethod.call(target, nameOrConfig, ...args);
+                };
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+//# sourceMappingURL=bot-scoped-server.js.map

package/dist/utils/bot-scoped-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-scoped-server.js","sourceRoot":"","sources":["../../src/utils/bot-scoped-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAa,CAAC;gBACvE,OAAO,UAAyB,YAAuC,EAAE,GAAG,IAAe;oBACzF,MAAM,QAAQ,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC;oBACtF,IAAI,QAAQ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5C,yCAAyC;wBACzC,OAAO;oBACT,CAAC;oBACD,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;gBAC5D,CAAC,CAAC;YACJ,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './error-utils.js';
+export * from './param-parser.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -1,2 +1,3 @@
 export * from './error-utils.js';
+export * from './param-parser.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/utils/param-parser.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MCP 파라미터 전처리 유틸리티
+ * Claude Code가 복잡한 타입을 문자열로 전송하는 경우 처리
+ */
+export type ParamType = 'array' | 'boolean' | 'object' | 'string' | 'number';
+export type ParamSchema<T extends Record<string, unknown>> = {
+    [K in keyof T]?: ParamType;
+};
+/**
+ * MCP 파라미터를 정규화합니다.
+ * Claude Code가 array, boolean, object 등을 문자열로 직렬화하여 전송하는 경우,
+ * 이를 원래 타입으로 파싱합니다.
+ *
+ * @param args - MCP 도구에서 받은 원본 파라미터
+ * @param schema - 각 파라미터의 예상 타입을 정의한 스키마
+ * @returns 정규화된 파라미터 객체
+ *
+ * @example
+ * const args = {
+ *   updates: '[{"nodeId": "123", "changes": {"status": "completed"}}]',
+ *   preview: 'true',
+ *   title: 'My Title'
+ * };
+ *
+ * const normalized = normalizeParams(args, {
+ *   updates: 'array',
+ *   preview: 'boolean',
+ *   title: 'string'
+ * });
+ *
+ * // Result:
+ * // {
+ * //   updates: [{ nodeId: '123', changes: { status: 'completed' } }],
+ * //   preview: true,
+ * //   title: 'My Title'
+ * // }
+ */
+export declare function normalizeParams<T extends Record<string, unknown>>(args: Record<string, unknown>, schema: ParamSchema<T>): T;
+/**
+ * 단일 값을 특정 타입으로 변환합니다.
+ *
+ * @param value - 변환할 값
+ * @param expectedType - 예상 타입
+ * @returns 변환된 값
+ */
+export declare function normalizeValue<T>(value: unknown, expectedType: ParamType): T;
+//# sourceMappingURL=param-parser.d.ts.map

package/dist/utils/param-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-parser.d.ts","sourceRoot":"","sources":["../../src/utils/param-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7E,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KAC1D,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,CAAC,CAgDH;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,GAAG,CAAC,CA0B5E"}

package/dist/utils/param-parser.js

@@ -0,0 +1,124 @@
+/**
+ * MCP 파라미터 전처리 유틸리티
+ * Claude Code가 복잡한 타입을 문자열로 전송하는 경우 처리
+ */
+/**
+ * MCP 파라미터를 정규화합니다.
+ * Claude Code가 array, boolean, object 등을 문자열로 직렬화하여 전송하는 경우,
+ * 이를 원래 타입으로 파싱합니다.
+ *
+ * @param args - MCP 도구에서 받은 원본 파라미터
+ * @param schema - 각 파라미터의 예상 타입을 정의한 스키마
+ * @returns 정규화된 파라미터 객체
+ *
+ * @example
+ * const args = {
+ *   updates: '[{"nodeId": "123", "changes": {"status": "completed"}}]',
+ *   preview: 'true',
+ *   title: 'My Title'
+ * };
+ *
+ * const normalized = normalizeParams(args, {
+ *   updates: 'array',
+ *   preview: 'boolean',
+ *   title: 'string'
+ * });
+ *
+ * // Result:
+ * // {
+ * //   updates: [{ nodeId: '123', changes: { status: 'completed' } }],
+ * //   preview: true,
+ * //   title: 'My Title'
+ * // }
+ */
+export function normalizeParams(args, schema) {
+    const result = {};
+    for (const [key, expectedType] of Object.entries(schema)) {
+        const value = args[key];
+        if (value === undefined)
+            continue;
+        if (typeof value === 'string' && expectedType !== 'string') {
+            try {
+                const parsed = JSON.parse(value);
+                if (expectedType === 'boolean') {
+                    result[key] = typeof parsed === 'boolean' ? parsed : Boolean(parsed);
+                }
+                else if (expectedType === 'number') {
+                    result[key] = typeof parsed === 'number' ? parsed : Number(parsed);
+                }
+                else if (expectedType === 'array') {
+                    result[key] = Array.isArray(parsed) ? parsed : [parsed];
+                }
+                else if (expectedType === 'object') {
+                    result[key] = typeof parsed === 'object' && parsed !== null ? parsed : value;
+                }
+                else {
+                    result[key] = parsed;
+                }
+            }
+            catch {
+                // JSON 파싱 실패 시 boolean과 number는 문자열에서 직접 변환 시도
+                if (expectedType === 'boolean') {
+                    result[key] = value === 'true';
+                }
+                else if (expectedType === 'number') {
+                    const num = Number(value);
+                    result[key] = isNaN(num) ? value : num;
+                }
+                else {
+                    // array나 object 타입인데 파싱 실패하면 원본 유지
+                    result[key] = value;
+                }
+            }
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    // 스키마에 정의되지 않은 필드도 복사
+    for (const [key, value] of Object.entries(args)) {
+        if (!(key in result)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * 단일 값을 특정 타입으로 변환합니다.
+ *
+ * @param value - 변환할 값
+ * @param expectedType - 예상 타입
+ * @returns 변환된 값
+ */
+export function normalizeValue(value, expectedType) {
+    if (typeof value === 'string' && expectedType !== 'string') {
+        try {
+            const parsed = JSON.parse(value);
+            if (expectedType === 'boolean') {
+                return (typeof parsed === 'boolean' ? parsed : Boolean(parsed));
+            }
+            else if (expectedType === 'number') {
+                return (typeof parsed === 'number' ? parsed : Number(parsed));
+            }
+            else if (expectedType === 'array') {
+                return (Array.isArray(parsed) ? parsed : [parsed]);
+            }
+            else if (expectedType === 'object') {
+                return (typeof parsed === 'object' && parsed !== null ? parsed : value);
+            }
+            return parsed;
+        }
+        catch {
+            if (expectedType === 'boolean') {
+                return (value === 'true');
+            }
+            else if (expectedType === 'number') {
+                const num = Number(value);
+                return (isNaN(num) ? value : num);
+            }
+            return value;
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=param-parser.js.map

package/dist/utils/param-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-parser.js","sourceRoot":"","sources":["../../src/utils/param-parser.ts"],"names":[],"mappings":"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"}