@corva/ui 3.54.0-20 → 3.54.0-22

package/mcp-server/server.mjs

@@ -11,9 +11,10 @@ import { randomUUID } from 'crypto';
 import { Resource } from '@opentelemetry/resources';
 import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
 import { readFile } from 'fs/promises';
-import { join as join$1, dirname } from 'path';
+import { join as join$1, dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { z } from 'zod';
+import { readFileSync } from 'fs';
 
 const LOG_SYMBOLS = {
     success: '✓',
@@ -227,7 +228,7 @@ const validateDsn = (dsn) => {
 
 const MCP_SERVER_VERSION = '1.1.0';
 
-var version = "3.54.0-20";
+var version = "3.54.0-22";
 
 const CORVA_UI_VERSION = version;
 
@@ -268,16 +269,24 @@ const createMetricsClient = (meter) => {
         recordToolEmptyResult: toolName => {
             emptyResultCounter.add(1, { 'gen_ai.tool.name': toolName });
         },
-        recordSession: (clientName, clientVersion) => {
+        recordSession: (clientName, clientVersion, projectIdentity) => {
             sessionCounter.add(1, {
                 'mcp.client.name': clientName || UNKNOWN_CLIENT_ATTR,
                 'mcp.client.version': clientVersion || UNKNOWN_CLIENT_ATTR,
+                ...(projectIdentity?.appKey ? { 'corva.app.key': projectIdentity.appKey } : {}),
+                ...(projectIdentity?.packageName
+                    ? { 'corva.package.name': projectIdentity.packageName }
+                    : {}),
             });
         },
-        recordSessionEnd: (durationMs, toolCount, clientName, clientVersion) => {
+        recordSessionEnd: (durationMs, toolCount, clientName, clientVersion, projectIdentity) => {
             const attrs = {
                 'mcp.client.name': clientName || UNKNOWN_CLIENT_ATTR,
                 'mcp.client.version': clientVersion || UNKNOWN_CLIENT_ATTR,
+                ...(projectIdentity?.appKey ? { 'corva.app.key': projectIdentity.appKey } : {}),
+                ...(projectIdentity?.packageName
+                    ? { 'corva.package.name': projectIdentity.packageName }
+                    : {}),
             };
             sessionDuration.record(durationMs, attrs);
             sessionToolCount.record(toolCount, attrs);
@@ -375,6 +384,12 @@ const recordInitSpan = (tracer, attrs) => {
         if (attrs.networkTransport) {
             span.setAttribute('network.transport', attrs.networkTransport);
         }
+        if (attrs.appKey) {
+            span.setAttribute('corva.app.key', attrs.appKey);
+        }
+        if (attrs.packageName) {
+            span.setAttribute('corva.package.name', attrs.packageName);
+        }
     }
     finally {
         span.end();
@@ -94326,7 +94341,9 @@ const findSimilarComponents = (name, allComponents) => {
 const componentDocsToolName = 'get_component_docs';
 const componentDocsToolTitle = 'Get Component Docs';
 const componentDocsToolDescription = `Get detailed documentation for a specific @corva/ui component.
-Returns props, examples, description, and links.`;
+Returns props, examples, description, and links.
+
+Usage: get_component_docs({ name: "Button" })`;
 const componentDocsToolSchema = {
     name: z.string().describe("Component name (e.g., 'Button', 'Tooltip', 'DatePicker')"),
     category: z
@@ -94384,7 +94401,9 @@ const handleGetComponentDocs = (args) => {
 
 **Category:** ${component.category}
 **Import:** \`import { ${component.name} } from '${component.importPath}';\`
-${component.isExperimental ? '**Experimental** - Recently added component, fully functional and safe to use.\n' : ''}${component.isDeprecated ? '❌ **Deprecated**\n' : ''}
+${component.isExperimental
+        ? '**Experimental** - Recently added component, fully functional and safe to use.\n'
+        : ''}${component.isDeprecated ? '❌ **Deprecated**\n' : ''}
 
 ${component.description}
 
@@ -94404,7 +94423,9 @@ ${examplesSection}
 const hookDocsToolName = 'get_hook_docs';
 const hookDocsToolTitle = 'Get Hook Docs';
 const hookDocsToolDescription = `Get documentation for a @corva/ui hook.
-Returns parameters, return type, and usage examples.`;
+Returns parameters, return type, and usage examples.
+
+Usage: get_hook_docs({ name: "useSubscriptions" })`;
 const hookDocsToolSchema = {
     name: z.string().describe("Hook name (e.g., 'useSubscriptions', 'useOutsideClick')"),
 };
@@ -94440,7 +94461,9 @@ Returns color palette (dark/light), CSS variables, SCSS variables,
 SCSS functions/mixins, spacing, typography, transitions, z-index tokens, and usage examples.
 
 Available sections: palette, css-variables, scss-variables, scss-functions,
-scss-mixins, spacing, typography, transition, z-index, usage, all.`;
+scss-mixins, spacing, typography, transition, z-index, usage, all.
+
+Usage: get_theme_docs({ section: "palette" })`;
 const SECTIONS = [
     'palette',
     'css-variables',
@@ -94479,54 +94502,41 @@ const buildPaletteSection = (includeLight = false) => {
     }
     return text;
 };
-const buildCssVariablesSection = () => h2('CSS Variables') +
-    'All CSS custom properties available via theme data attributes ' +
-    '(`[data-corva-theme-dark]` / `[data-corva-theme-light]`).\n\n' +
-    formatCssVariables(theme.cssVariables);
-const buildScssVariablesSection = () => h2('SCSS Variables') +
-    'SCSS variables that map to CSS custom properties. ' +
-    "Import via `@import '@corva/ui/styles/common'`.\n\n" +
-    formatScssVariables(theme.scssVariables);
-const buildScssFunctionsSection = () => h2('SCSS Functions') +
-    'Available after importing `@corva/ui/styles/common`.\n\n' +
-    formatScssFunctions(theme.scssFunctions);
-const buildScssMixinsSection = () => h2('SCSS Mixins') +
-    'Available after importing `@corva/ui/styles/common`.\n\n' +
-    formatScssMixins(theme.scssMixins);
+const buildCssVariablesSection = () => `${h2('CSS Variables')}All CSS custom properties available via theme data attributes ` +
+    `(\`[data-corva-theme-dark]\` / \`[data-corva-theme-light]\`).\n\n${formatCssVariables(theme.cssVariables)}`;
+const buildScssVariablesSection = () => `${h2('SCSS Variables')}SCSS variables that map to CSS custom properties. ` +
+    `Import via \`@import '@corva/ui/styles/common'\`.\n\n${formatScssVariables(theme.scssVariables)}`;
+const buildScssFunctionsSection = () => `${h2('SCSS Functions')}Available after importing \`@corva/ui/styles/common\`.\n\n${formatScssFunctions(theme.scssFunctions)}`;
+const buildScssMixinsSection = () => `${h2('SCSS Mixins')}Available after importing \`@corva/ui/styles/common\`.\n\n${formatScssMixins(theme.scssMixins)}`;
 const buildSpacingSection = () => h2('Spacing') + formatSpacing(theme.spacing);
 const buildTypographySection = () => h2('Typography') + formatTypography(theme.typography);
 const buildZIndexSection = () => h2('Z-Index') + formatZIndex(theme.zIndex);
 const buildTransitionSection = () => h2('Transitions') + formatTransition(theme.transition);
 const buildUsageSection = () => {
     const sections = [
-        h2('Usage Guide') + '### 1. JSS (Material-UI makeStyles)\n' +
-            codeBlock("import { theme } from '@corva/ui/config';\n\n" +
-                "const primaryColor = theme.palette.primary.main; // '#03BCD4'\n" +
-                'const bgColor = theme.palette.background.b4;', 'tsx'),
-        '### 2. CSS Variables\n' +
-            codeBlock('.my-element {\n' +
-                '  color: var(--palette-primary-main);\n' +
-                '  background: var(--palette-background-b-4);\n' +
-                '}', 'css'),
-        '### 3. SCSS Variables\n' +
-            codeBlock("@import '@corva/ui/styles/common';\n\n" +
-                '.my-element {\n' +
-                '  color: $palette_primary_main;\n' +
-                '  background: $palette_b4;\n' +
-                '}', 'scss'),
-        '### 4. SCSS Functions\n' +
-            codeBlock('// Alpha transparency\n' +
-                'background: colorAlpha($palette_primary_main, 0.5);\n\n' +
-                '// Spacing (base unit: 8px)\n' +
-                'padding: spacing(2);       // 16px\n' +
-                'margin: spacing(1, 2);     // 8px 16px\n\n' +
-                '// Transitions\n' +
-                'transition: transition(opacity, transform);', 'scss'),
-        '### 5. SCSS Mixins\n' +
-            codeBlock('.scrollable-container {\n' +
-                '  --corvaui-background: var(--palette-background-b-4);\n' +
-                '  @include verticalFadePseudoElements(2);\n' +
-                '}', 'scss'),
+        `${h2('Usage Guide')}### 1. JSS (Material-UI makeStyles)\n${codeBlock("import { theme } from '@corva/ui/config';\n\n" +
+            "const primaryColor = theme.palette.primary.main; // '#03BCD4'\n" +
+            'const bgColor = theme.palette.background.b4;', 'tsx')}`,
+        `### 2. CSS Variables\n${codeBlock('.my-element {\n' +
+            '  color: var(--palette-primary-main);\n' +
+            '  background: var(--palette-background-b-4);\n' +
+            '}', 'css')}`,
+        `### 3. SCSS Variables\n${codeBlock("@import '@corva/ui/styles/common';\n\n" +
+            '.my-element {\n' +
+            '  color: $palette_primary_main;\n' +
+            '  background: $palette_b4;\n' +
+            '}', 'scss')}`,
+        `### 4. SCSS Functions\n${codeBlock('// Alpha transparency\n' +
+            'background: colorAlpha($palette_primary_main, 0.5);\n\n' +
+            '// Spacing (base unit: 8px)\n' +
+            'padding: spacing(2);       // 16px\n' +
+            'margin: spacing(1, 2);     // 8px 16px\n\n' +
+            '// Transitions\n' +
+            'transition: transition(opacity, transform);', 'scss')}`,
+        `### 5. SCSS Mixins\n${codeBlock('.scrollable-container {\n' +
+            '  --corvaui-background: var(--palette-background-b-4);\n' +
+            '  @include verticalFadePseudoElements(2);\n' +
+            '}', 'scss')}`,
     ];
     return sections.join('\n\n');
 };
@@ -94542,9 +94552,7 @@ const buildAllSection = () => {
     const availableSections = SECTIONS.filter(s => s !== 'all' && s !== 'variables')
         .map(s => `\`${s}\``)
         .join(', ');
-    const tokenSummary = h2('Token Summary') +
-        counts.map(c => `- ${c}`).join('\n') +
-        `\n\nUse \`get_theme_docs\` with a specific section for full details: ${availableSections}`;
+    const tokenSummary = `${h2('Token Summary') + counts.map(c => `- ${c}`).join('\n')}\n\nUse \`get_theme_docs\` with a specific section for full details: ${availableSections}`;
     return join(h1('@corva/ui Theme'), buildPaletteSection(false), tokenSummary, buildSpacingSection(), buildTypographySection(), buildTransitionSection(), buildZIndexSection(), buildUsageSection());
 };
 const handleGetThemeDocs = (args) => {
@@ -94594,7 +94602,9 @@ const handleGetThemeDocs = (args) => {
 const listToolName = 'list_corva_ui';
 const listToolTitle = 'List @corva/ui';
 const listToolDescription = `List all available items in @corva/ui by category.
-Useful to see what's available before searching.`;
+Useful to see what's available before searching.
+
+Usage: list_corva_ui({ type: "components-v2" })`;
 const listToolSchema = {
     type: z
         .enum([
@@ -94720,15 +94730,15 @@ const handleList = (args) => {
 const constantsDocsToolName = 'get_constants_docs';
 const constantsDocsToolTitle = 'Get Constants Docs';
 const constantsDocsToolDescription = `Get documentation for @corva/ui constants.
-Returns constant values, namespaces, and usage info.`;
+Returns constant values, namespaces, and usage info.
+
+Usage: get_constants_docs({ name: "ASSET_TYPES" })`;
 const constantsDocsToolSchema = {
-    namespace: z
-        .string()
-        .describe("Namespace (e.g., 'drillstring', 'alerts') or constant name (e.g., 'ASSET_TYPES')"),
+    name: z.string().describe("Namespace or constant name (e.g., 'drillstring', 'ASSET_TYPES')"),
 };
 const handleGetConstantsDocs = (args) => {
-    const { namespace } = args;
-    const namespaceLower = namespace.toLowerCase();
+    const { name } = args;
+    const namespaceLower = name.toLowerCase();
     // Find matching constants by namespace or name
     const matches = constants.filter(c => c.namespace?.toLowerCase() === namespaceLower ||
         c.name.toLowerCase() === namespaceLower ||
@@ -94747,7 +94757,7 @@ const handleGetConstantsDocs = (args) => {
                 'Metrics config may live in utility modules. Try search_corva_ui with type "util" and query "metrics".';
         }
         return {
-            response: createToolResponse(`No constants found for "${namespace}". ${suggestion}`),
+            response: createToolResponse(`No constants found for "${name}". ${suggestion}`),
             found: false,
             matchCount: 0,
         };
@@ -94780,8 +94790,8 @@ ${c.value !== '[namespace]' ? `**Value:** \`${JSON.stringify(c.value, null, 2)}\
         .map(c => `- **${c.name}**: ${c.description}\n  Import: \`${c.importPath}\``)
         .join('\n\n');
     const title = exactNamespaceMatches.length > 0
-        ? `Constants in "${namespace}" namespace`
-        : `Constants matching "${namespace}"`;
+        ? `Constants in "${name}" namespace`
+        : `Constants matching "${name}"`;
     return {
         response: createToolResponse(`# ${title}\n\n${displayMatches.length} constant(s) found:\n\n${formatted}`),
         found: true,
@@ -94792,7 +94802,9 @@ ${c.value !== '[namespace]' ? `**Value:** \`${JSON.stringify(c.value, null, 2)}\
 const clientDocsToolName = 'get_client_docs';
 const clientDocsToolTitle = 'Get Client Docs';
 const clientDocsToolDescription = `Get documentation for @corva/ui API clients.
-Returns methods, parameters, and API endpoints from Swagger documentation.`;
+Returns methods, parameters, and API endpoints from Swagger documentation.
+
+Usage: get_client_docs({ name: "corvaAPI" })`;
 const clientDocsToolSchema = {
     name: z.string().describe("Client name (e.g., 'corvaAPI', 'socketClient', 'corvaDataAPI')"),
     tag: z
@@ -94847,7 +94859,7 @@ const formatBytes = (bytes) => {
     return `${mb.toFixed(1)} MB`;
 };
 const formatConfigSource = (source) => source === 'local' ? 'Local file' : 'Remote endpoint';
-const handleGetDiagnostics = (stats, telemetry) => {
+const handleGetDiagnostics = (stats, telemetry, identity) => {
     const { heapUsed, heapTotal, rss } = process.memoryUsage();
     const uptimeMs = Date.now() - stats.startTime;
     let text = h1('MCP Server Diagnostics');
@@ -94880,11 +94892,82 @@ const handleGetDiagnostics = (stats, telemetry) => {
     else {
         text += `${bold('Status')}: Disabled\n`;
     }
+    text += h2('Project Identity');
+    text += `${bold('App key')}: ${identity?.appKey ?? 'N/A'}\n`;
+    text += `${bold('Package name')}: ${identity?.packageName ?? 'N/A'}\n`;
     return {
         response: createToolResponse(text),
     };
 };
 
+const readJsonField = (filePath, ...keys) => {
+    try {
+        let value = JSON.parse(readFileSync(filePath, 'utf-8'));
+        for (const key of keys) {
+            if (value && typeof value === 'object') {
+                value = value[key];
+            }
+            else {
+                return null;
+            }
+        }
+        return typeof value === 'string' && value ? value : null;
+    }
+    catch {
+        return null;
+    }
+};
+const findUpJsonField = (startDir, fileName, ...keys) => {
+    let dir = resolve(startDir);
+    for (;;) {
+        const value = readJsonField(join$1(dir, fileName), ...keys);
+        if (value) {
+            return value;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+};
+const getProjectIdentityAttrs = (identity) => {
+    const attrs = {};
+    if (identity?.appKey) {
+        attrs['corva.app.key'] = identity.appKey;
+    }
+    if (identity?.packageName) {
+        attrs['corva.package.name'] = identity.packageName;
+    }
+    return attrs;
+};
+const resolveProjectIdentity = async (server, logger) => {
+    const empty = { appKey: null, packageName: null };
+    try {
+        const capabilities = server.getClientCapabilities();
+        if (!capabilities?.roots) {
+            return empty;
+        }
+        const { roots } = await server.listRoots();
+        if (!roots.length) {
+            return empty;
+        }
+        const rootPath = fileURLToPath(roots[0].uri);
+        const appKey = findUpJsonField(rootPath, 'manifest.json', 'application', 'key');
+        const packageName = findUpJsonField(rootPath, 'package.json', 'name');
+        if (appKey) {
+            logger.info(`Consuming app: ${appKey}`);
+        }
+        if (packageName) {
+            logger.info(`Consuming package: ${packageName}`);
+        }
+        return { appKey, packageName };
+    }
+    catch {
+        return empty;
+    }
+};
+
 class CorvaUiMcpServer {
     server;
     mcpLogger;
@@ -94897,6 +94980,8 @@ class CorvaUiMcpServer {
     telemetryInitPromise = null;
     shutdownRequested = false;
     pendingInitData = null;
+    projectIdentity = null;
+    identityPromise = null;
     constructor() {
         const baseLogger = createLogger({ prefix: '[CorvaUI MCP]' });
         this.mcpLogger = createMcpNotificationLogger(baseLogger, () => this.isConnected ? this.server : null);
@@ -94929,7 +95014,16 @@ class CorvaUiMcpServer {
             if (clientInfo?.name) {
                 this.mcpLogger.info(`Client connected: ${clientInfo.name}${clientInfo.version ? ` v${clientInfo.version}` : ''}`);
             }
-            this.flushPendingInitData();
+            this.identityPromise = resolveProjectIdentity(this.server.server, this.mcpLogger)
+                .then(identity => {
+                this.projectIdentity = identity;
+            })
+                .catch(error => {
+                this.mcpLogger.error('Failed to resolve project identity', error);
+            })
+                .finally(() => {
+                this.flushPendingInitData();
+            });
         };
     }
     flushPendingInitData() {
@@ -94982,6 +95076,7 @@ class CorvaUiMcpServer {
                     extraAttrs: {
                         ...serializedResult.extraAttrs,
                         ...getSpanAttributes?.(result),
+                        ...getProjectIdentityAttrs(this.projectIdentity),
                     },
                 });
                 this.telemetry.metrics.recordToolInvocation(toolName, ms);
@@ -95013,7 +95108,10 @@ class CorvaUiMcpServer {
                     protocolVersion: MCP_PROTOCOL_VERSION,
                     networkTransport: MCP_NETWORK_TRANSPORT,
                     parentContext,
-                    extraAttrs: serializedError.extraAttrs,
+                    extraAttrs: {
+                        ...serializedError.extraAttrs,
+                        ...getProjectIdentityAttrs(this.projectIdentity),
+                    },
                 });
                 this.telemetry.metrics.recordToolInvocation(toolName, ms);
                 this.telemetry.metrics.recordToolError(toolName, serializedError.errorType);
@@ -95153,7 +95251,7 @@ class CorvaUiMcpServer {
         }, (extra) => {
             const parentContext = extractContextFromMeta(extra?._meta);
             try {
-                return this.executeToolWithObservability(diagnosticsToolName, {}, () => handleGetDiagnostics(this.getStats(), this.getTelemetryStatus()), () => 'ok', { parentContext });
+                return this.executeToolWithObservability(diagnosticsToolName, {}, () => handleGetDiagnostics(this.getStats(), this.getTelemetryStatus(), this.projectIdentity), () => 'ok', { parentContext });
             }
             catch (error) {
                 return createErrorResponse(`Error: ${error instanceof Error ? error.message : String(error)}`);
@@ -95188,10 +95286,13 @@ class CorvaUiMcpServer {
         if (this.telemetryInitPromise) {
             await withTimeout(this.telemetryInitPromise, TELEMETRY_INIT_TIMEOUT_MS);
         }
+        if (this.identityPromise) {
+            await withTimeout(this.identityPromise, TELEMETRY_INIT_TIMEOUT_MS);
+        }
         if (this.telemetry.isEnabled()) {
             const sessionDurationMs = Date.now() - this.startTime;
             const clientInfo = this.server.server.getClientVersion();
-            this.telemetry.metrics.recordSessionEnd(sessionDurationMs, this.requestCount, clientInfo?.name, clientInfo?.version);
+            this.telemetry.metrics.recordSessionEnd(sessionDurationMs, this.requestCount, clientInfo?.name, clientInfo?.version, this.projectIdentity);
         }
         if (this.transport) {
             await this.server.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corva/ui",
-  "version": "3.54.0-20",
+  "version": "3.54.0-22",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Shared components/utils for Corva ui projects",
   "keywords": [