@frontmcp/plugins 0.4.1 → 0.5.1

package/src/codecall/utils/describe.utils.js

@@ -0,0 +1,531 @@
+"use strict";
+// file: libs/plugins/src/codecall/utils/describe.utils.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectToolIntent = detectToolIntent;
+exports.jsonSchemaToSignature = jsonSchemaToSignature;
+exports.jsonSchemaToNaturalLanguage = jsonSchemaToNaturalLanguage;
+exports.generateBasicExample = generateBasicExample;
+exports.hasPaginationParams = hasPaginationParams;
+exports.hasFilterParams = hasFilterParams;
+exports.getFilterProperties = getFilterProperties;
+exports.generatePaginationExample = generatePaginationExample;
+exports.generateFilterExample = generateFilterExample;
+exports.generateCreateExample = generateCreateExample;
+exports.generateGetExample = generateGetExample;
+exports.generateListExample = generateListExample;
+exports.generateUpdateExample = generateUpdateExample;
+exports.generateDeleteExample = generateDeleteExample;
+exports.generateSearchExample = generateSearchExample;
+exports.generateSmartExample = generateSmartExample;
+/**
+ * Patterns for detecting tool intent from the action verb.
+ * These patterns use the same synonym groups as the search service.
+ */
+const INTENT_PATTERNS = {
+    create: /^(create|add|new|insert|make|append|register|generate|produce|build|construct|provision|instantiate|define|compose|draft)/i,
+    delete: /^(delete|remove|destroy|drop|erase|clear|purge|discard|eliminate|unbind|unregister)/i,
+    get: /^(get|fetch|retrieve|read|obtain|load|pull|access|grab|receive)/i,
+    update: /^(update|edit|modify|change|patch|set|alter|revise|adjust|amend|correct|fix|refresh|sync|upgrade|downgrade)/i,
+    list: /^(list|all|index|enumerate|show|display|view|browse|scan|inventory)/i,
+    search: /^(search|find|query|lookup|locate|discover|explore|seek|match|filter)/i,
+};
+/**
+ * Detect the intent of a tool from its name.
+ * Extracts the action verb from tool names like "users:create" or "orders:list".
+ */
+function detectToolIntent(toolName, description) {
+    // Extract action verb from tool name (e.g., "users:create" -> "create")
+    const parts = toolName.split(':');
+    const actionPart = parts.length > 1 ? parts[parts.length - 1] : toolName;
+    // Check each intent pattern
+    for (const [intent, pattern] of Object.entries(INTENT_PATTERNS)) {
+        if (pattern.test(actionPart)) {
+            return intent;
+        }
+    }
+    // Fallback: check description for clues
+    if (description) {
+        const descLower = description.toLowerCase();
+        if (/creates?\s|adding\s|inserts?/i.test(descLower))
+            return 'create';
+        if (/deletes?\s|removes?\s|destroys?/i.test(descLower))
+            return 'delete';
+        if (/gets?\s|fetche?s?\s|retrieves?/i.test(descLower))
+            return 'get';
+        if (/updates?\s|modif(?:y|ies)\s|edits?/i.test(descLower))
+            return 'update';
+        if (/lists?\s|shows?\s|displays?/i.test(descLower))
+            return 'list';
+        if (/search(?:es)?\s|find(?:s)?\s|quer(?:y|ies)/i.test(descLower))
+            return 'search';
+    }
+    return 'unknown';
+}
+/**
+ * Generate a TypeScript-like function signature from a JSON Schema.
+ *
+ * @example
+ * Input: { type: 'object', properties: { id: { type: 'string' }, limit: { type: 'number' } }, required: ['id'] }
+ * Output: "(id: string, limit?: number) => unknown"
+ */
+function jsonSchemaToSignature(toolName, inputSchema, outputSchema) {
+    const inputPart = schemaToTypeString(inputSchema, 'input');
+    const outputPart = schemaToTypeString(outputSchema, 'output');
+    return `callTool('${toolName}', ${inputPart}) => Promise<${outputPart}>`;
+}
+/**
+ * Convert JSON Schema to a TypeScript-like type string.
+ */
+function schemaToTypeString(schema, context) {
+    if (!schema) {
+        return context === 'input' ? '{}' : 'unknown';
+    }
+    if (schema.type === 'object' && schema.properties) {
+        const props = [];
+        const required = new Set(schema.required || []);
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            if (typeof propSchema === 'boolean')
+                continue;
+            const isRequired = required.has(key);
+            const typeStr = getTypeString(propSchema);
+            props.push(`${key}${isRequired ? '' : '?'}: ${typeStr}`);
+        }
+        if (props.length === 0) {
+            return '{}';
+        }
+        return `{ ${props.join(', ')} }`;
+    }
+    return getTypeString(schema);
+}
+/**
+ * Get a simple type string for a schema.
+ */
+function getTypeString(schema) {
+    if (schema.enum) {
+        return schema.enum.map((v) => JSON.stringify(v)).join(' | ');
+    }
+    if (schema.type) {
+        if (Array.isArray(schema.type)) {
+            return schema.type.join(' | ');
+        }
+        switch (schema.type) {
+            case 'string':
+                return 'string';
+            case 'number':
+            case 'integer':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'null':
+                return 'null';
+            case 'array':
+                if (schema.items && typeof schema.items !== 'boolean') {
+                    return `${getTypeString(schema.items)}[]`;
+                }
+                return 'unknown[]';
+            case 'object':
+                if (schema.properties) {
+                    return schemaToTypeString(schema, 'input');
+                }
+                return 'Record<string, unknown>';
+            default:
+                return 'unknown';
+        }
+    }
+    if (schema.oneOf || schema.anyOf) {
+        // We've confirmed at least one is truthy, so use non-null assertion
+        const options = (schema.oneOf ?? schema.anyOf);
+        return options
+            .filter((s) => typeof s !== 'boolean')
+            .map((s) => getTypeString(s))
+            .join(' | ');
+    }
+    return 'unknown';
+}
+/**
+ * Generate a natural language summary of a schema.
+ */
+function jsonSchemaToNaturalLanguage(schema, direction) {
+    if (!schema) {
+        return direction === 'input' ? 'No input parameters' : 'Returns unspecified data';
+    }
+    if (schema.description) {
+        return schema.description;
+    }
+    if (schema.type === 'object' && schema.properties) {
+        const required = new Set(schema.required || []);
+        const props = Object.entries(schema.properties);
+        if (props.length === 0) {
+            return direction === 'input' ? 'No parameters required' : 'Returns an empty object';
+        }
+        const requiredProps = props.filter(([key]) => required.has(key));
+        const optionalProps = props.filter(([key]) => !required.has(key));
+        const parts = [];
+        if (requiredProps.length > 0) {
+            parts.push(`Required: ${requiredProps.map(([k]) => k).join(', ')}`);
+        }
+        if (optionalProps.length > 0) {
+            parts.push(`Optional: ${optionalProps.map(([k]) => k).join(', ')}`);
+        }
+        return parts.join('. ');
+    }
+    return direction === 'input' ? `Takes a ${schema.type || 'value'}` : `Returns a ${schema.type || 'value'}`;
+}
+/**
+ * Generate a basic usage example for a tool.
+ */
+function generateBasicExample(toolName, inputSchema) {
+    const params = generateSampleParams(inputSchema);
+    const paramsStr = params ? JSON.stringify(params, null, 2) : '{}';
+    return {
+        description: `Basic usage of ${toolName}`,
+        code: `const result = await callTool('${toolName}', ${paramsStr});
+return result;`,
+    };
+}
+/**
+ * Generate sample parameters from a schema.
+ */
+function generateSampleParams(schema) {
+    if (!schema || schema.type !== 'object' || !schema.properties) {
+        return null;
+    }
+    const params = {};
+    const required = new Set(schema.required || []);
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+        if (typeof propSchema === 'boolean')
+            continue;
+        // Only include required params and a couple optional ones for example
+        if (!required.has(key))
+            continue;
+        params[key] = getSampleValue(propSchema, key);
+    }
+    return Object.keys(params).length > 0 ? params : null;
+}
+/**
+ * Generate a sample value for a schema property.
+ */
+function getSampleValue(schema, key) {
+    if (schema.default !== undefined) {
+        return schema.default;
+    }
+    if (schema.enum && schema.enum.length > 0) {
+        return schema.enum[0];
+    }
+    if (schema.const !== undefined) {
+        return schema.const;
+    }
+    const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+    switch (type) {
+        case 'string':
+            // Generate contextual sample based on key name
+            if (key.toLowerCase().includes('id'))
+                return 'abc123';
+            if (key.toLowerCase().includes('email'))
+                return 'user@example.com';
+            if (key.toLowerCase().includes('name'))
+                return 'Example';
+            if (key.toLowerCase().includes('url'))
+                return 'https://example.com';
+            return 'string';
+        case 'number':
+        case 'integer':
+            if (key.toLowerCase().includes('limit'))
+                return 10;
+            if (key.toLowerCase().includes('offset'))
+                return 0;
+            if (key.toLowerCase().includes('page'))
+                return 1;
+            return 0;
+        case 'boolean':
+            return true;
+        case 'array':
+            return [];
+        case 'object':
+            return {};
+        default:
+            return null;
+    }
+}
+/**
+ * Check if a schema has pagination parameters.
+ */
+function hasPaginationParams(schema) {
+    if (!schema || schema.type !== 'object' || !schema.properties) {
+        return false;
+    }
+    const props = Object.keys(schema.properties);
+    return props.some((p) => ['limit', 'offset', 'page', 'pageSize', 'cursor'].includes(p.toLowerCase()));
+}
+/**
+ * Check if a schema has filter-like parameters.
+ */
+function hasFilterParams(schema) {
+    if (!schema || schema.type !== 'object' || !schema.properties) {
+        return false;
+    }
+    const props = Object.keys(schema.properties);
+    return props.some((p) => p.toLowerCase().includes('filter') ||
+        p.toLowerCase().includes('query') ||
+        p.toLowerCase().includes('search') ||
+        p.toLowerCase() === 'status' ||
+        p.toLowerCase() === 'type' ||
+        p.toLowerCase() === 'role');
+}
+/**
+ * Get filter-like property names from a schema.
+ */
+function getFilterProperties(schema) {
+    if (!schema || schema.type !== 'object' || !schema.properties) {
+        return [];
+    }
+    return Object.keys(schema.properties).filter((p) => p.toLowerCase().includes('filter') ||
+        p.toLowerCase().includes('query') ||
+        p.toLowerCase().includes('search') ||
+        p.toLowerCase() === 'status' ||
+        p.toLowerCase() === 'type' ||
+        p.toLowerCase() === 'role');
+}
+/**
+ * Generate a pagination example for a tool.
+ */
+function generatePaginationExample(toolName) {
+    return {
+        description: `Pagination example for ${toolName}`,
+        code: `// Fetch first page
+const page1 = await callTool('${toolName}', { limit: 10, offset: 0 });
+
+// Fetch second page
+const page2 = await callTool('${toolName}', { limit: 10, offset: 10 });
+
+// Combine results
+return [...page1.items, ...page2.items];`,
+    };
+}
+/**
+ * Generate a filter example for a tool.
+ */
+function generateFilterExample(toolName, filterProp) {
+    return {
+        description: `Filter by ${filterProp}`,
+        code: `const filtered = await callTool('${toolName}', { ${filterProp}: 'value' });
+return filtered.items || filtered;`,
+    };
+}
+// ==========================================
+// Intent-Specific Example Generators
+// ==========================================
+/**
+ * Extract entity name from tool name (e.g., "users:create" -> "user")
+ */
+function extractEntityName(toolName) {
+    const parts = toolName.split(':');
+    const entity = parts.length > 1 ? parts[0] : toolName;
+    // Singularize simple plurals
+    return entity.endsWith('s') && !entity.endsWith('ss') ? entity.slice(0, -1) : entity;
+}
+/**
+ * Generate a create example for a tool.
+ * Shows required parameters with contextual sample values.
+ */
+function generateCreateExample(toolName, inputSchema) {
+    const entity = extractEntityName(toolName);
+    const params = generateSampleParams(inputSchema);
+    const paramsStr = params ? JSON.stringify(params, null, 2) : '{ /* required fields */ }';
+    return {
+        description: `Create a new ${entity}`,
+        code: `const result = await callTool('${toolName}', ${paramsStr});
+return result;`,
+    };
+}
+/**
+ * Generate a get (retrieve single item) example for a tool.
+ */
+function generateGetExample(toolName, inputSchema) {
+    const entity = extractEntityName(toolName);
+    const idParam = findIdParameter(inputSchema);
+    if (idParam) {
+        return {
+            description: `Get ${entity} by ${idParam}`,
+            code: `const ${entity} = await callTool('${toolName}', { ${idParam}: 'abc123' });
+return ${entity};`,
+        };
+    }
+    // Fallback to basic example if no ID parameter found
+    const params = generateSampleParams(inputSchema);
+    const paramsStr = params ? JSON.stringify(params, null, 2) : '{}';
+    return {
+        description: `Get ${entity} details`,
+        code: `const ${entity} = await callTool('${toolName}', ${paramsStr});
+return ${entity};`,
+    };
+}
+/**
+ * Generate a list example for a tool.
+ */
+function generateListExample(toolName, inputSchema) {
+    const entity = extractEntityName(toolName);
+    return {
+        description: `List all ${entity}s`,
+        code: `const result = await callTool('${toolName}', {});
+return result.items || result;`,
+    };
+}
+/**
+ * Generate an update example for a tool.
+ */
+function generateUpdateExample(toolName, inputSchema) {
+    const entity = extractEntityName(toolName);
+    const idParam = findIdParameter(inputSchema);
+    // Generate sample update fields (excluding ID fields)
+    const updateFields = generateUpdateFields(inputSchema);
+    const fieldsStr = updateFields
+        ? JSON.stringify(updateFields, null, 2).replace(/\n/g, '\n  ')
+        : '{ /* fields to update */ }';
+    if (idParam) {
+        return {
+            description: `Update ${entity} by ${idParam}`,
+            code: `const updated = await callTool('${toolName}', {
+  ${idParam}: 'abc123',
+  ...${fieldsStr}
+});
+return updated;`,
+        };
+    }
+    return {
+        description: `Update ${entity}`,
+        code: `const updated = await callTool('${toolName}', ${fieldsStr});
+return updated;`,
+    };
+}
+/**
+ * Generate a delete example for a tool.
+ */
+function generateDeleteExample(toolName, inputSchema) {
+    const entity = extractEntityName(toolName);
+    const idParam = findIdParameter(inputSchema);
+    if (idParam) {
+        return {
+            description: `Delete ${entity} by ${idParam}`,
+            code: `const result = await callTool('${toolName}', { ${idParam}: 'abc123' });
+return result;`,
+        };
+    }
+    const params = generateSampleParams(inputSchema);
+    const paramsStr = params ? JSON.stringify(params, null, 2) : '{ /* identifier */ }';
+    return {
+        description: `Delete ${entity}`,
+        code: `const result = await callTool('${toolName}', ${paramsStr});
+return result;`,
+    };
+}
+/**
+ * Generate a search example for a tool.
+ */
+function generateSearchExample(toolName, inputSchema) {
+    const entity = extractEntityName(toolName);
+    const queryParam = findQueryParameter(inputSchema);
+    if (queryParam) {
+        return {
+            description: `Search for ${entity}s`,
+            code: `const results = await callTool('${toolName}', { ${queryParam}: 'search term' });
+return results.items || results;`,
+        };
+    }
+    return {
+        description: `Search for ${entity}s`,
+        code: `const results = await callTool('${toolName}', { query: 'search term' });
+return results.items || results;`,
+    };
+}
+/**
+ * Find an ID-like parameter in the schema.
+ */
+function findIdParameter(schema) {
+    if (!schema || schema.type !== 'object' || !schema.properties) {
+        return null;
+    }
+    const props = Object.keys(schema.properties);
+    const required = new Set(schema.required || []);
+    // Prioritize required ID fields
+    const idPatterns = ['id', 'Id', 'ID', '_id', 'uuid', 'key'];
+    for (const pattern of idPatterns) {
+        const found = props.find((p) => (p === pattern || p.endsWith(pattern)) && required.has(p));
+        if (found)
+            return found;
+    }
+    // Fall back to any ID-like field
+    for (const pattern of idPatterns) {
+        const found = props.find((p) => p === pattern || p.endsWith(pattern));
+        if (found)
+            return found;
+    }
+    return null;
+}
+/**
+ * Find a query-like parameter in the schema.
+ */
+function findQueryParameter(schema) {
+    if (!schema || schema.type !== 'object' || !schema.properties) {
+        return null;
+    }
+    const props = Object.keys(schema.properties);
+    const queryPatterns = ['query', 'search', 'q', 'term', 'keyword', 'filter'];
+    for (const pattern of queryPatterns) {
+        const found = props.find((p) => p.toLowerCase() === pattern || p.toLowerCase().includes(pattern));
+        if (found)
+            return found;
+    }
+    return null;
+}
+/**
+ * Generate sample update fields (excluding ID-like fields).
+ */
+function generateUpdateFields(schema) {
+    if (!schema || schema.type !== 'object' || !schema.properties) {
+        return null;
+    }
+    const fields = {};
+    const idPatterns = ['id', 'Id', 'ID', '_id', 'uuid', 'key'];
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+        if (typeof propSchema === 'boolean')
+            continue;
+        // Skip ID-like fields
+        const isIdField = idPatterns.some((p) => key === p || key.endsWith(p));
+        if (isIdField)
+            continue;
+        // Include a few non-ID fields for the update example
+        if (Object.keys(fields).length < 2) {
+            fields[key] = getSampleValue(propSchema, key);
+        }
+    }
+    return Object.keys(fields).length > 0 ? fields : null;
+}
+/**
+ * Smart example generator that uses intent detection.
+ * This is the main entry point for generating examples.
+ */
+function generateSmartExample(toolName, inputSchema, description) {
+    const intent = detectToolIntent(toolName, description);
+    switch (intent) {
+        case 'create':
+            return generateCreateExample(toolName, inputSchema);
+        case 'get':
+            return generateGetExample(toolName, inputSchema);
+        case 'list':
+            // For list tools, still use pagination example if available
+            return hasPaginationParams(inputSchema)
+                ? generatePaginationExample(toolName)
+                : generateListExample(toolName, inputSchema);
+        case 'update':
+            return generateUpdateExample(toolName, inputSchema);
+        case 'delete':
+            return generateDeleteExample(toolName, inputSchema);
+        case 'search':
+            return generateSearchExample(toolName, inputSchema);
+        default:
+            // Fallback to basic example for unknown intents
+            return generateBasicExample(toolName, inputSchema);
+    }
+}
+//# sourceMappingURL=describe.utils.js.map

package/src/codecall/utils/describe.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.utils.js","sourceRoot":"","sources":["../../../../src/codecall/utils/describe.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/plugins/src/codecall/utils/describe.utils.ts\n\nimport type { JSONSchema } from 'zod/v4/core';\n\n/** JSON Schema type from Zod v4 */\ntype JsonSchema = JSONSchema.JSONSchema;\n\n/**\n * Tool example for describe output\n */\nexport interface ToolUsageExample {\n  description: string;\n  code: string;\n}\n\n/**\n * Detected intent of a tool based on its name and description.\n */\nexport type ToolIntent = 'create' | 'list' | 'get' | 'update' | 'delete' | 'search' | 'action' | 'unknown';\n\n/**\n * Patterns for detecting tool intent from the action verb.\n * These patterns use the same synonym groups as the search service.\n */\nconst INTENT_PATTERNS: Record<Exclude<ToolIntent, 'action' | 'unknown'>, RegExp> = {\n  create:\n    /^(create|add|new|insert|make|append|register|generate|produce|build|construct|provision|instantiate|define|compose|draft)/i,\n  delete: /^(delete|remove|destroy|drop|erase|clear|purge|discard|eliminate|unbind|unregister)/i,\n  get: /^(get|fetch|retrieve|read|obtain|load|pull|access|grab|receive)/i,\n  update:\n    /^(update|edit|modify|change|patch|set|alter|revise|adjust|amend|correct|fix|refresh|sync|upgrade|downgrade)/i,\n  list: /^(list|all|index|enumerate|show|display|view|browse|scan|inventory)/i,\n  search: /^(search|find|query|lookup|locate|discover|explore|seek|match|filter)/i,\n};\n\n/**\n * Detect the intent of a tool from its name.\n * Extracts the action verb from tool names like \"users:create\" or \"orders:list\".\n */\nexport function detectToolIntent(toolName: string, description?: string): ToolIntent {\n  // Extract action verb from tool name (e.g., \"users:create\" -> \"create\")\n  const parts = toolName.split(':');\n  const actionPart = parts.length > 1 ? parts[parts.length - 1] : toolName;\n\n  // Check each intent pattern\n  for (const [intent, pattern] of Object.entries(INTENT_PATTERNS) as [ToolIntent, RegExp][]) {\n    if (pattern.test(actionPart)) {\n      return intent;\n    }\n  }\n\n  // Fallback: check description for clues\n  if (description) {\n    const descLower = description.toLowerCase();\n    if (/creates?\\s|adding\\s|inserts?/i.test(descLower)) return 'create';\n    if (/deletes?\\s|removes?\\s|destroys?/i.test(descLower)) return 'delete';\n    if (/gets?\\s|fetche?s?\\s|retrieves?/i.test(descLower)) return 'get';\n    if (/updates?\\s|modif(?:y|ies)\\s|edits?/i.test(descLower)) return 'update';\n    if (/lists?\\s|shows?\\s|displays?/i.test(descLower)) return 'list';\n    if (/search(?:es)?\\s|find(?:s)?\\s|quer(?:y|ies)/i.test(descLower)) return 'search';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Generate a TypeScript-like function signature from a JSON Schema.\n *\n * @example\n * Input: { type: 'object', properties: { id: { type: 'string' }, limit: { type: 'number' } }, required: ['id'] }\n * Output: \"(id: string, limit?: number) => unknown\"\n */\nexport function jsonSchemaToSignature(toolName: string, inputSchema?: JsonSchema, outputSchema?: JsonSchema): string {\n  const inputPart = schemaToTypeString(inputSchema, 'input');\n  const outputPart = schemaToTypeString(outputSchema, 'output');\n\n  return `callTool('${toolName}', ${inputPart}) => Promise<${outputPart}>`;\n}\n\n/**\n * Convert JSON Schema to a TypeScript-like type string.\n */\nfunction schemaToTypeString(schema: JsonSchema | undefined | null, context: 'input' | 'output'): string {\n  if (!schema) {\n    return context === 'input' ? '{}' : 'unknown';\n  }\n\n  if (schema.type === 'object' && schema.properties) {\n    const props: string[] = [];\n    const required = new Set(schema.required || []);\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      if (typeof propSchema === 'boolean') continue;\n\n      const isRequired = required.has(key);\n      const typeStr = getTypeString(propSchema);\n      props.push(`${key}${isRequired ? '' : '?'}: ${typeStr}`);\n    }\n\n    if (props.length === 0) {\n      return '{}';\n    }\n\n    return `{ ${props.join(', ')} }`;\n  }\n\n  return getTypeString(schema);\n}\n\n/**\n * Get a simple type string for a schema.\n */\nfunction getTypeString(schema: JsonSchema): string {\n  if (schema.enum) {\n    return schema.enum.map((v) => JSON.stringify(v)).join(' | ');\n  }\n\n  if (schema.type) {\n    if (Array.isArray(schema.type)) {\n      return schema.type.join(' | ');\n    }\n\n    switch (schema.type) {\n      case 'string':\n        return 'string';\n      case 'number':\n      case 'integer':\n        return 'number';\n      case 'boolean':\n        return 'boolean';\n      case 'null':\n        return 'null';\n      case 'array':\n        if (schema.items && typeof schema.items !== 'boolean') {\n          return `${getTypeString(schema.items as JsonSchema)}[]`;\n        }\n        return 'unknown[]';\n      case 'object':\n        if (schema.properties) {\n          return schemaToTypeString(schema, 'input');\n        }\n        return 'Record<string, unknown>';\n      default:\n        return 'unknown';\n    }\n  }\n\n  if (schema.oneOf || schema.anyOf) {\n    // We've confirmed at least one is truthy, so use non-null assertion\n    const options = (schema.oneOf ?? schema.anyOf)!;\n    return options\n      .filter((s): s is JsonSchema => typeof s !== 'boolean')\n      .map((s) => getTypeString(s))\n      .join(' | ');\n  }\n\n  return 'unknown';\n}\n\n/**\n * Generate a natural language summary of a schema.\n */\nexport function jsonSchemaToNaturalLanguage(\n  schema: JsonSchema | undefined | null,\n  direction: 'input' | 'output',\n): string {\n  if (!schema) {\n    return direction === 'input' ? 'No input parameters' : 'Returns unspecified data';\n  }\n\n  if (schema.description) {\n    return schema.description;\n  }\n\n  if (schema.type === 'object' && schema.properties) {\n    const required = new Set(schema.required || []);\n    const props = Object.entries(schema.properties);\n\n    if (props.length === 0) {\n      return direction === 'input' ? 'No parameters required' : 'Returns an empty object';\n    }\n\n    const requiredProps = props.filter(([key]) => required.has(key));\n    const optionalProps = props.filter(([key]) => !required.has(key));\n\n    const parts: string[] = [];\n\n    if (requiredProps.length > 0) {\n      parts.push(`Required: ${requiredProps.map(([k]) => k).join(', ')}`);\n    }\n\n    if (optionalProps.length > 0) {\n      parts.push(`Optional: ${optionalProps.map(([k]) => k).join(', ')}`);\n    }\n\n    return parts.join('. ');\n  }\n\n  return direction === 'input' ? `Takes a ${schema.type || 'value'}` : `Returns a ${schema.type || 'value'}`;\n}\n\n/**\n * Generate a basic usage example for a tool.\n */\nexport function generateBasicExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample {\n  const params = generateSampleParams(inputSchema);\n  const paramsStr = params ? JSON.stringify(params, null, 2) : '{}';\n\n  return {\n    description: `Basic usage of ${toolName}`,\n    code: `const result = await callTool('${toolName}', ${paramsStr});\nreturn result;`,\n  };\n}\n\n/**\n * Generate sample parameters from a schema.\n */\nfunction generateSampleParams(schema?: JsonSchema): Record<string, unknown> | null {\n  if (!schema || schema.type !== 'object' || !schema.properties) {\n    return null;\n  }\n\n  const params: Record<string, unknown> = {};\n  const required = new Set(schema.required || []);\n\n  for (const [key, propSchema] of Object.entries(schema.properties)) {\n    if (typeof propSchema === 'boolean') continue;\n\n    // Only include required params and a couple optional ones for example\n    if (!required.has(key)) continue;\n\n    params[key] = getSampleValue(propSchema, key);\n  }\n\n  return Object.keys(params).length > 0 ? params : null;\n}\n\n/**\n * Generate a sample value for a schema property.\n */\nfunction getSampleValue(schema: JsonSchema, key: string): unknown {\n  if (schema.default !== undefined) {\n    return schema.default;\n  }\n\n  if (schema.enum && schema.enum.length > 0) {\n    return schema.enum[0];\n  }\n\n  if (schema.const !== undefined) {\n    return schema.const;\n  }\n\n  const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;\n\n  switch (type) {\n    case 'string':\n      // Generate contextual sample based on key name\n      if (key.toLowerCase().includes('id')) return 'abc123';\n      if (key.toLowerCase().includes('email')) return 'user@example.com';\n      if (key.toLowerCase().includes('name')) return 'Example';\n      if (key.toLowerCase().includes('url')) return 'https://example.com';\n      return 'string';\n\n    case 'number':\n    case 'integer':\n      if (key.toLowerCase().includes('limit')) return 10;\n      if (key.toLowerCase().includes('offset')) return 0;\n      if (key.toLowerCase().includes('page')) return 1;\n      return 0;\n\n    case 'boolean':\n      return true;\n\n    case 'array':\n      return [];\n\n    case 'object':\n      return {};\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Check if a schema has pagination parameters.\n */\nexport function hasPaginationParams(schema?: JsonSchema): boolean {\n  if (!schema || schema.type !== 'object' || !schema.properties) {\n    return false;\n  }\n\n  const props = Object.keys(schema.properties);\n  return props.some((p) => ['limit', 'offset', 'page', 'pageSize', 'cursor'].includes(p.toLowerCase()));\n}\n\n/**\n * Check if a schema has filter-like parameters.\n */\nexport function hasFilterParams(schema?: JsonSchema): boolean {\n  if (!schema || schema.type !== 'object' || !schema.properties) {\n    return false;\n  }\n\n  const props = Object.keys(schema.properties);\n  return props.some(\n    (p) =>\n      p.toLowerCase().includes('filter') ||\n      p.toLowerCase().includes('query') ||\n      p.toLowerCase().includes('search') ||\n      p.toLowerCase() === 'status' ||\n      p.toLowerCase() === 'type' ||\n      p.toLowerCase() === 'role',\n  );\n}\n\n/**\n * Get filter-like property names from a schema.\n */\nexport function getFilterProperties(schema?: JsonSchema): string[] {\n  if (!schema || schema.type !== 'object' || !schema.properties) {\n    return [];\n  }\n\n  return Object.keys(schema.properties).filter(\n    (p) =>\n      p.toLowerCase().includes('filter') ||\n      p.toLowerCase().includes('query') ||\n      p.toLowerCase().includes('search') ||\n      p.toLowerCase() === 'status' ||\n      p.toLowerCase() === 'type' ||\n      p.toLowerCase() === 'role',\n  );\n}\n\n/**\n * Generate a pagination example for a tool.\n */\nexport function generatePaginationExample(toolName: string): ToolUsageExample {\n  return {\n    description: `Pagination example for ${toolName}`,\n    code: `// Fetch first page\nconst page1 = await callTool('${toolName}', { limit: 10, offset: 0 });\n\n// Fetch second page\nconst page2 = await callTool('${toolName}', { limit: 10, offset: 10 });\n\n// Combine results\nreturn [...page1.items, ...page2.items];`,\n  };\n}\n\n/**\n * Generate a filter example for a tool.\n */\nexport function generateFilterExample(toolName: string, filterProp: string): ToolUsageExample {\n  return {\n    description: `Filter by ${filterProp}`,\n    code: `const filtered = await callTool('${toolName}', { ${filterProp}: 'value' });\nreturn filtered.items || filtered;`,\n  };\n}\n\n// ==========================================\n// Intent-Specific Example Generators\n// ==========================================\n\n/**\n * Extract entity name from tool name (e.g., \"users:create\" -> \"user\")\n */\nfunction extractEntityName(toolName: string): string {\n  const parts = toolName.split(':');\n  const entity = parts.length > 1 ? parts[0] : toolName;\n  // Singularize simple plurals\n  return entity.endsWith('s') && !entity.endsWith('ss') ? entity.slice(0, -1) : entity;\n}\n\n/**\n * Generate a create example for a tool.\n * Shows required parameters with contextual sample values.\n */\nexport function generateCreateExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample {\n  const entity = extractEntityName(toolName);\n  const params = generateSampleParams(inputSchema);\n  const paramsStr = params ? JSON.stringify(params, null, 2) : '{ /* required fields */ }';\n\n  return {\n    description: `Create a new ${entity}`,\n    code: `const result = await callTool('${toolName}', ${paramsStr});\nreturn result;`,\n  };\n}\n\n/**\n * Generate a get (retrieve single item) example for a tool.\n */\nexport function generateGetExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample {\n  const entity = extractEntityName(toolName);\n  const idParam = findIdParameter(inputSchema);\n\n  if (idParam) {\n    return {\n      description: `Get ${entity} by ${idParam}`,\n      code: `const ${entity} = await callTool('${toolName}', { ${idParam}: 'abc123' });\nreturn ${entity};`,\n    };\n  }\n\n  // Fallback to basic example if no ID parameter found\n  const params = generateSampleParams(inputSchema);\n  const paramsStr = params ? JSON.stringify(params, null, 2) : '{}';\n\n  return {\n    description: `Get ${entity} details`,\n    code: `const ${entity} = await callTool('${toolName}', ${paramsStr});\nreturn ${entity};`,\n  };\n}\n\n/**\n * Generate a list example for a tool.\n */\nexport function generateListExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample {\n  const entity = extractEntityName(toolName);\n\n  return {\n    description: `List all ${entity}s`,\n    code: `const result = await callTool('${toolName}', {});\nreturn result.items || result;`,\n  };\n}\n\n/**\n * Generate an update example for a tool.\n */\nexport function generateUpdateExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample {\n  const entity = extractEntityName(toolName);\n  const idParam = findIdParameter(inputSchema);\n\n  // Generate sample update fields (excluding ID fields)\n  const updateFields = generateUpdateFields(inputSchema);\n  const fieldsStr = updateFields\n    ? JSON.stringify(updateFields, null, 2).replace(/\\n/g, '\\n  ')\n    : '{ /* fields to update */ }';\n\n  if (idParam) {\n    return {\n      description: `Update ${entity} by ${idParam}`,\n      code: `const updated = await callTool('${toolName}', {\n  ${idParam}: 'abc123',\n  ...${fieldsStr}\n});\nreturn updated;`,\n    };\n  }\n\n  return {\n    description: `Update ${entity}`,\n    code: `const updated = await callTool('${toolName}', ${fieldsStr});\nreturn updated;`,\n  };\n}\n\n/**\n * Generate a delete example for a tool.\n */\nexport function generateDeleteExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample {\n  const entity = extractEntityName(toolName);\n  const idParam = findIdParameter(inputSchema);\n\n  if (idParam) {\n    return {\n      description: `Delete ${entity} by ${idParam}`,\n      code: `const result = await callTool('${toolName}', { ${idParam}: 'abc123' });\nreturn result;`,\n    };\n  }\n\n  const params = generateSampleParams(inputSchema);\n  const paramsStr = params ? JSON.stringify(params, null, 2) : '{ /* identifier */ }';\n\n  return {\n    description: `Delete ${entity}`,\n    code: `const result = await callTool('${toolName}', ${paramsStr});\nreturn result;`,\n  };\n}\n\n/**\n * Generate a search example for a tool.\n */\nexport function generateSearchExample(toolName: string, inputSchema?: JsonSchema): ToolUsageExample {\n  const entity = extractEntityName(toolName);\n  const queryParam = findQueryParameter(inputSchema);\n\n  if (queryParam) {\n    return {\n      description: `Search for ${entity}s`,\n      code: `const results = await callTool('${toolName}', { ${queryParam}: 'search term' });\nreturn results.items || results;`,\n    };\n  }\n\n  return {\n    description: `Search for ${entity}s`,\n    code: `const results = await callTool('${toolName}', { query: 'search term' });\nreturn results.items || results;`,\n  };\n}\n\n/**\n * Find an ID-like parameter in the schema.\n */\nfunction findIdParameter(schema?: JsonSchema): string | null {\n  if (!schema || schema.type !== 'object' || !schema.properties) {\n    return null;\n  }\n\n  const props = Object.keys(schema.properties);\n  const required = new Set(schema.required || []);\n\n  // Prioritize required ID fields\n  const idPatterns = ['id', 'Id', 'ID', '_id', 'uuid', 'key'];\n  for (const pattern of idPatterns) {\n    const found = props.find((p) => (p === pattern || p.endsWith(pattern)) && required.has(p));\n    if (found) return found;\n  }\n\n  // Fall back to any ID-like field\n  for (const pattern of idPatterns) {\n    const found = props.find((p) => p === pattern || p.endsWith(pattern));\n    if (found) return found;\n  }\n\n  return null;\n}\n\n/**\n * Find a query-like parameter in the schema.\n */\nfunction findQueryParameter(schema?: JsonSchema): string | null {\n  if (!schema || schema.type !== 'object' || !schema.properties) {\n    return null;\n  }\n\n  const props = Object.keys(schema.properties);\n  const queryPatterns = ['query', 'search', 'q', 'term', 'keyword', 'filter'];\n\n  for (const pattern of queryPatterns) {\n    const found = props.find((p) => p.toLowerCase() === pattern || p.toLowerCase().includes(pattern));\n    if (found) return found;\n  }\n\n  return null;\n}\n\n/**\n * Generate sample update fields (excluding ID-like fields).\n */\nfunction generateUpdateFields(schema?: JsonSchema): Record<string, unknown> | null {\n  if (!schema || schema.type !== 'object' || !schema.properties) {\n    return null;\n  }\n\n  const fields: Record<string, unknown> = {};\n  const idPatterns = ['id', 'Id', 'ID', '_id', 'uuid', 'key'];\n\n  for (const [key, propSchema] of Object.entries(schema.properties)) {\n    if (typeof propSchema === 'boolean') continue;\n\n    // Skip ID-like fields\n    const isIdField = idPatterns.some((p) => key === p || key.endsWith(p));\n    if (isIdField) continue;\n\n    // Include a few non-ID fields for the update example\n    if (Object.keys(fields).length < 2) {\n      fields[key] = getSampleValue(propSchema, key);\n    }\n  }\n\n  return Object.keys(fields).length > 0 ? fields : null;\n}\n\n/**\n * Smart example generator that uses intent detection.\n * This is the main entry point for generating examples.\n */\nexport function generateSmartExample(\n  toolName: string,\n  inputSchema?: JsonSchema,\n  description?: string,\n): ToolUsageExample {\n  const intent = detectToolIntent(toolName, description);\n\n  switch (intent) {\n    case 'create':\n      return generateCreateExample(toolName, inputSchema);\n    case 'get':\n      return generateGetExample(toolName, inputSchema);\n    case 'list':\n      // For list tools, still use pagination example if available\n      return hasPaginationParams(inputSchema)\n        ? generatePaginationExample(toolName)\n        : generateListExample(toolName, inputSchema);\n    case 'update':\n      return generateUpdateExample(toolName, inputSchema);\n    case 'delete':\n      return generateDeleteExample(toolName, inputSchema);\n    case 'search':\n      return generateSearchExample(toolName, inputSchema);\n    default:\n      // Fallback to basic example for unknown intents\n      return generateBasicExample(toolName, inputSchema);\n  }\n}\n"]}

package/src/codecall/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './describe.utils';
+export * from './mcp-result';

package/src/codecall/utils/index.js

@@ -0,0 +1,7 @@
+"use strict";
+// file: libs/plugins/src/codecall/utils/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./describe.utils"), exports);
+tslib_1.__exportStar(require("./mcp-result"), exports);
+//# sourceMappingURL=index.js.map

package/src/codecall/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/codecall/utils/index.ts"],"names":[],"mappings":";AAAA,iDAAiD;;;AAEjD,2DAAiC;AACjC,uDAA6B","sourcesContent":["// file: libs/plugins/src/codecall/utils/index.ts\n\nexport * from './describe.utils';\nexport * from './mcp-result';\n"]}

package/src/codecall/utils/mcp-result.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Extract the actual result from a CallToolResult.
+ * MCP returns results wrapped in content array format.
+ */
+export declare function extractResultFromCallToolResult(mcpResult: CallToolResult): unknown;

package/src/codecall/utils/mcp-result.js

@@ -0,0 +1,36 @@
+"use strict";
+// file: libs/plugins/src/codecall/utils/mcp-result.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractResultFromCallToolResult = extractResultFromCallToolResult;
+/**
+ * Extract the actual result from a CallToolResult.
+ * MCP returns results wrapped in content array format.
+ */
+function extractResultFromCallToolResult(mcpResult) {
+    // MCP CallToolResult has { content: [...], isError?: boolean }
+    if (mcpResult.isError) {
+        // If it's an error, extract the error message from content
+        const errorContent = mcpResult.content?.[0];
+        if (errorContent && 'text' in errorContent) {
+            throw new Error(errorContent.text);
+        }
+        throw new Error('Tool execution failed');
+    }
+    // For successful results, try to extract the actual data
+    const content = mcpResult.content;
+    if (!content || content.length === 0) {
+        return undefined;
+    }
+    // If there's a single text content, try to parse as JSON
+    if (content.length === 1 && content[0].type === 'text') {
+        try {
+            return JSON.parse(content[0].text);
+        }
+        catch {
+            return content[0].text;
+        }
+    }
+    // Return the raw content for complex results
+    return content;
+}
+//# sourceMappingURL=mcp-result.js.map