@corva/ui 3.62.0-4 → 3.62.0-6

package/mcp-server/server.mjs

@@ -11,10 +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, resolve } from 'path';
-import { fileURLToPath } from 'url';
+import { join as join$1, resolve, dirname } from 'path';
 import { z } from 'zod';
 import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
 
 const LOG_SYMBOLS = {
     success: '✓',
@@ -198,6 +198,7 @@ const createNoopMetricsClient = () => ({
     recordToolEmptyResult: () => { },
     recordPromptInvocation: () => { },
     recordPromptError: () => { },
+    recordFeedback: () => { },
     recordSession: () => { },
     recordSessionEnd: () => { },
 });
@@ -228,9 +229,9 @@ const validateDsn = (dsn) => {
     return url.href;
 };
 
-const MCP_SERVER_VERSION = '1.2.0';
+const MCP_SERVER_VERSION = '1.3.0';
 
-var version = "3.62.0-4";
+var version = "3.62.0-6";
 
 const CORVA_UI_VERSION = version;
 
@@ -250,6 +251,9 @@ const createMetricsClient = (meter) => {
     const promptErrorCounter = meter.createCounter('mcp.server.prompt.errors', {
         description: 'Number of prompt invocation errors',
     });
+    const feedbackCounter = meter.createCounter('mcp.server.feedback', {
+        description: 'Number of feedback submissions',
+    });
     const operationDuration = meter.createHistogram('mcp.server.operation.duration', {
         description: 'Duration of MCP operations (tool and prompt calls) in milliseconds',
         unit: 'ms',
@@ -287,6 +291,12 @@ const createMetricsClient = (meter) => {
         recordPromptError: (promptName, errorType) => {
             promptErrorCounter.add(1, { 'gen_ai.prompt.name': promptName, 'error.type': errorType });
         },
+        recordFeedback: (sentiment, category) => {
+            feedbackCounter.add(1, {
+                'corva.mcp.feedback.sentiment': sentiment,
+                ...(category ? { 'corva.mcp.feedback.category': category } : {}),
+            });
+        },
         recordSession: (clientName, clientVersion, projectIdentity) => {
             sessionCounter.add(1, {
                 'mcp.client.name': clientName || UNKNOWN_CLIENT_ATTR,
@@ -530,7 +540,7 @@ const createTracerTelemetryClient = (tracer, sessionId, metrics, providerShutdow
     };
 };
 
-const getLocalConfigPath = () => join$1(dirname(fileURLToPath(import.meta.url)), 'telemetry-config.local.json');
+const getLocalConfigPath = () => join$1(process.cwd(), 'mcp-server', 'telemetry-config.local.json');
 
 const validateLocalConfig = (data) => {
     if (!data || typeof data !== 'object') {
@@ -19340,6 +19350,8 @@ var clientsData = [
 			"acknowledge",
 			"classify",
 			"transition",
+			"escalate",
+			"deescalate",
 			"totals",
 			"details",
 			"alertworkflows",
@@ -19626,6 +19638,7 @@ var clientsData = [
 			"column_fields_list",
 			"flat",
 			"activity_code_mappings",
+			"metrics_definitions",
 			"countries",
 			"country_list",
 			"revoltchat",
@@ -21648,6 +21661,20 @@ var clientsData = [
 						required: false,
 						description: "Levels could be a string or a comma-delimited list of strings"
 					},
+					{
+						name: "sort",
+						"in": "query",
+						type: "string",
+						required: false,
+						description: "Column to sort by, one of [alert_at, last_alert_at, created_at, status, status_changed_at, level, occurrences, acknowledged, validated, alert_classification, name]. Unrecognized values fall back to the default sort (alert_at descending)."
+					},
+					{
+						name: "order",
+						"in": "query",
+						type: "string",
+						required: false,
+						description: "Sort direction, asc or desc. Applies only when sort is provided and defaults to asc; without sort, results are returned alert_at descending."
+					},
 					{
 						name: "serializer",
 						"in": "query",
@@ -21864,6 +21891,86 @@ var clientsData = [
 					}
 				}
 			},
+			{
+				path: "/v1/alerts/{alert_id}/escalate",
+				method: "POST",
+				summary: "Escalate alert to specific users",
+				tags: [
+					"Alerts"
+				],
+				parameters: [
+					{
+						name: "alert_id",
+						"in": "path",
+						type: "integer",
+						required: true,
+						description: "Alert ID"
+					}
+				],
+				requestBody: {
+					contentType: "application/json",
+					schema: "any",
+					required: true
+				},
+				responses: {
+					"200": {
+						description: "Alert with new active escalation",
+						schema: "any"
+					},
+					"401": {
+						description: "Authentication error",
+						schema: "any"
+					},
+					"403": {
+						description: "Authorization error",
+						schema: "any"
+					},
+					"404": {
+						description: "Not found error",
+						schema: "any"
+					},
+					"422": {
+						description: "Invalid request (empty user_ids, users outside company, or alert in terminal state)"
+					}
+				}
+			},
+			{
+				path: "/v1/alerts/{alert_id}/deescalate",
+				method: "POST",
+				summary: "Close active escalation on alert",
+				tags: [
+					"Alerts"
+				],
+				parameters: [
+					{
+						name: "alert_id",
+						"in": "path",
+						type: "integer",
+						required: true,
+						description: "Alert ID"
+					}
+				],
+				responses: {
+					"200": {
+						description: "Alert with escalation closed",
+						schema: "any"
+					},
+					"401": {
+						description: "Authentication error",
+						schema: "any"
+					},
+					"403": {
+						description: "Only the escalated user or an admin can de-escalate"
+					},
+					"404": {
+						description: "Not found error",
+						schema: "any"
+					},
+					"422": {
+						description: "Alert is not escalated"
+					}
+				}
+			},
 			{
 				path: "/v1/alerts/totals",
 				method: "GET",
@@ -22081,6 +22188,20 @@ var clientsData = [
 						type: "any",
 						required: false,
 						description: "Levels could be a string or a comma-delimited list of strings"
+					},
+					{
+						name: "sort",
+						"in": "query",
+						type: "string",
+						required: false,
+						description: "Column to sort by, one of [alert_at, last_alert_at, created_at, status, status_changed_at, level, occurrences, acknowledged, validated, alert_classification, name]. Unrecognized values fall back to the default sort (alert_at descending)."
+					},
+					{
+						name: "order",
+						"in": "query",
+						type: "string",
+						required: false,
+						description: "Sort direction, asc or desc. Applies only when sort is provided and defaults to asc; without sort, results are returned alert_at descending."
 					}
 				],
 				responses: {
@@ -49214,6 +49335,47 @@ var clientsData = [
 					}
 				}
 			},
+			{
+				path: "/v2/data_export_app/metrics_definitions",
+				method: "GET",
+				summary: "Get dynamic metric definitions for a company",
+				description: "Returns per-company dynamic metric metadata from the `corva#metrics.definitions`\nMongoDB collection. The FE uses this to render custom metrics (name, category,\nunit, ILT icon/color) without hardcoding them per company.\n\nNotes:\n- One entry per segment; only the **latest** document per segment is returned.\n- Backend-internal fields (`rules`, `restrict`, `description`) are stripped.\n- `usage_rules` is included as-is when present; FE matches wells by program name.\n- Metric **values** flow through the existing `/v2/data_export_app/flat` endpoint —\n  no separate fetch is required.\n",
+				tags: [
+					"Data Export App"
+				],
+				parameters: [
+					{
+						name: "company_id",
+						"in": "query",
+						type: "integer",
+						required: true,
+						description: "Company ID to fetch metric definitions for"
+					}
+				],
+				responses: {
+					"200": {
+						description: "Successful response with definitions(or empty array if none exist)",
+						schema: "MetricsDefinitionsList"
+					},
+					"400": {
+						description: "Bad request - company_id is required"
+					},
+					"401": {
+						description: "Authentication error",
+						schema: "AuthenticationError"
+					},
+					"403": {
+						description: "Forbidden - user has no access to wells in this company"
+					},
+					"404": {
+						description: "Not found error",
+						schema: "NotFoundError"
+					},
+					"503": {
+						description: "Service unavailable - upstream MongoDB error"
+					}
+				}
+			},
 			{
 				path: "/v2/country_list",
 				method: "GET",
@@ -50505,6 +50667,20 @@ var clientsData = [
 							required: false,
 							description: "Levels could be a string or a comma-delimited list of strings"
 						},
+						{
+							name: "sort",
+							"in": "query",
+							type: "string",
+							required: false,
+							description: "Column to sort by, one of [alert_at, last_alert_at, created_at, status, status_changed_at, level, occurrences, acknowledged, validated, alert_classification, name]. Unrecognized values fall back to the default sort (alert_at descending)."
+						},
+						{
+							name: "order",
+							"in": "query",
+							type: "string",
+							required: false,
+							description: "Sort direction, asc or desc. Applies only when sort is provided and defaults to asc; without sort, results are returned alert_at descending."
+						},
 						{
 							name: "serializer",
 							"in": "query",
@@ -50893,6 +51069,86 @@ var clientsData = [
 						}
 					}
 				},
+				{
+					path: "/v1/alerts/{alert_id}/deescalate",
+					method: "POST",
+					summary: "Close active escalation on alert",
+					tags: [
+						"Alerts"
+					],
+					parameters: [
+						{
+							name: "alert_id",
+							"in": "path",
+							type: "integer",
+							required: true,
+							description: "Alert ID"
+						}
+					],
+					responses: {
+						"200": {
+							description: "Alert with escalation closed",
+							schema: "any"
+						},
+						"401": {
+							description: "Authentication error",
+							schema: "any"
+						},
+						"403": {
+							description: "Only the escalated user or an admin can de-escalate"
+						},
+						"404": {
+							description: "Not found error",
+							schema: "any"
+						},
+						"422": {
+							description: "Alert is not escalated"
+						}
+					}
+				},
+				{
+					path: "/v1/alerts/{alert_id}/escalate",
+					method: "POST",
+					summary: "Escalate alert to specific users",
+					tags: [
+						"Alerts"
+					],
+					parameters: [
+						{
+							name: "alert_id",
+							"in": "path",
+							type: "integer",
+							required: true,
+							description: "Alert ID"
+						}
+					],
+					requestBody: {
+						contentType: "application/json",
+						schema: "any",
+						required: true
+					},
+					responses: {
+						"200": {
+							description: "Alert with new active escalation",
+							schema: "any"
+						},
+						"401": {
+							description: "Authentication error",
+							schema: "any"
+						},
+						"403": {
+							description: "Authorization error",
+							schema: "any"
+						},
+						"404": {
+							description: "Not found error",
+							schema: "any"
+						},
+						"422": {
+							description: "Invalid request (empty user_ids, users outside company, or alert in terminal state)"
+						}
+					}
+				},
 				{
 					path: "/v1/alerts/{alert_id}/likes",
 					method: "GET",
@@ -51482,6 +51738,20 @@ var clientsData = [
 							type: "any",
 							required: false,
 							description: "Levels could be a string or a comma-delimited list of strings"
+						},
+						{
+							name: "sort",
+							"in": "query",
+							type: "string",
+							required: false,
+							description: "Column to sort by, one of [alert_at, last_alert_at, created_at, status, status_changed_at, level, occurrences, acknowledged, validated, alert_classification, name]. Unrecognized values fall back to the default sort (alert_at descending)."
+						},
+						{
+							name: "order",
+							"in": "query",
+							type: "string",
+							required: false,
+							description: "Sort direction, asc or desc. Applies only when sort is provided and defaults to asc; without sort, results are returned alert_at descending."
 						}
 					],
 					responses: {
@@ -68361,6 +68631,47 @@ var clientsData = [
 							schema: "any"
 						}
 					}
+				},
+				{
+					path: "/v2/data_export_app/metrics_definitions",
+					method: "GET",
+					summary: "Get dynamic metric definitions for a company",
+					description: "Returns per-company dynamic metric metadata from the `corva#metrics.definitions`\nMongoDB collection. The FE uses this to render custom metrics (name, category,\nunit, ILT icon/color) without hardcoding them per company.\n\nNotes:\n- One entry per segment; only the **latest** document per segment is returned.\n- Backend-internal fields (`rules`, `restrict`, `description`) are stripped.\n- `usage_rules` is included as-is when present; FE matches wells by program name.\n- Metric **values** flow through the existing `/v2/data_export_app/flat` endpoint —\n  no separate fetch is required.\n",
+					tags: [
+						"Data Export App"
+					],
+					parameters: [
+						{
+							name: "company_id",
+							"in": "query",
+							type: "integer",
+							required: true,
+							description: "Company ID to fetch metric definitions for"
+						}
+					],
+					responses: {
+						"200": {
+							description: "Successful response with definitions(or empty array if none exist)",
+							schema: "MetricsDefinitionsList"
+						},
+						"400": {
+							description: "Bad request - company_id is required"
+						},
+						"401": {
+							description: "Authentication error",
+							schema: "AuthenticationError"
+						},
+						"403": {
+							description: "Forbidden - user has no access to wells in this company"
+						},
+						"404": {
+							description: "Not found error",
+							schema: "NotFoundError"
+						},
+						"503": {
+							description: "Service unavailable - upstream MongoDB error"
+						}
+					}
 				}
 			],
 			DatasetTypes: [
@@ -91657,6 +91968,8 @@ var entries = [
 			"acknowledge",
 			"classify",
 			"transition",
+			"escalate",
+			"deescalate",
 			"totals",
 			"details",
 			"alertworkflows",
@@ -91943,6 +92256,7 @@ var entries = [
 			"column_fields_list",
 			"flat",
 			"activity_code_mappings",
+			"metrics_definitions",
 			"countries",
 			"country_list",
 			"revoltchat",
@@ -91954,7 +92268,7 @@ var entries = [
 		],
 		category: "clients",
 		importPath: "@corva/ui/clients",
-		searchText: "corvaapi main api client for corva platform. provides methods for get, put, patch, post, delete requests. api http request fetch rest get post put delete patch abilitycheck v2 ability_check check_feature check_permission feed activities alerts v1 comments likes toggle definitions context trigger close check templates enable disable alertdefinitions alertgroups alert_groups alert_group_users alert_group_assets alert_group_configurations occurrences acknowledge classify transition totals details alertworkflows alert_workflows appreviews app_reviews approve decline assets favorites settings type_wells type_well reruns ancestor_ids resolve autocomplete programs clusters pads frac_fleets app_wells wells active_wells rigs active_well well_cache drillout_units frac fleets wirelines dashboardappannotations dashboard_app_annotations last_annotations dashboards users dashboard_apps bulk_create batch_update dashboard_folders dashboard_shares dashboard_folder_shares use clone use_template available_timezones well planning dashboards well_planning_dashboards data data_filters data_filters#2 files file sign preview download download_link url security groups assign_users copy_users wellview integration ingest bha frac_stage_design frac_stage_summary frac_stage_summary_calculated job_settings plugs .well-known jwks.json jwks messageproducer message_producer notifications acknowledge_all count unread security_policies companies permissions bulk_destroy grouped picklists items tasks user_token#1 user_token#2 user_token#3 user_token#4 sessions verification schemas export streaks identity_verifiers api_keys deactivate apps install packages upload app_categories categories featured types secrets appdatasets app_datasets mark_followable app_help_contents signed_url applogs app_logs events search apptypes app_types appsettingstemplates app_settings_templates share unshare copy publish appstreamtemplate app_stream_templates appstreamtemplateapp add_app update_app remove_app datasettypes dataset_types datset_types documents document_sections rig_templates aggregated_values rig aggregated values rig_template_categories rig_template_items tiers productsubscriptions product_subscriptions cancel deny platformsubscriptions platform_subscriptions resume provisioningsubscriptions provisioning_subscriptions app_streams purchasesubscriptions purchase_subscriptions subscriptionfeatures subscription_features wellcache corva blacklisteddatasets blacklisted_datasets app metrics app_metrics for_selected_apps appassets packagereviews package_reviews apppurchases app_purchases datasets filtered_by_apps appruns app_runs stop duplicate_check appstream idle_worker_stats create_backfill_stream force_resume batch_destroy update_edr_provider_connection_status appconnection app_connections update_package apperroralert app_error_alerts subscribe unsubscribe usage summaries workflows workflow_content_blocks workflow_apps workflowroles workflow_roles columnmappertemplates column_mapper_templates add_asset remove_asset columnmappertemplatechannels column_mapper_template_channels columnmappertemplaterules column_mapper_template_rules dashboard_workflows ungroup ungroup_all change_asset competitoranalysis competitor_analysis statistics company app_companies appstoretemplates app_store_templates appstoretemplatesections app_store_template_sections app_store_template_section appstorearticles app_store_articles remove_section signedurl audits dataset_audits permission_audits group_membership_audits provisioning_subscription_audits platform_subscription_audits purchase_subscription_audits event audit appusage usage_analytics app_usage usage_list view_date_list top_apps top_users total_usage_trend partialwellreruns partial_reruns list start_merging fail restart app_progress partialwellrerunappprogresses app_progresses searchsuggestions search_suggestions goals projects projectfolders project_folders projectfiles project_files registeredmodels registered_models appschedule app_schedules bulk_update_status package_audits apikey api_keys_management activate edrproviders edr_providers test_connection api_key_audits typewells padfracfleets pad_frac_fleets fracfleetcontracts frac_fleet_contracts interventionunits intervention_units interventionunitevents intervention_unit_events data export app data_export_app column_fields column_fields_list flat activity_code_mappings countries country_list revoltchat revolt_chat_sessions interventionunitreruns intervention_unit_reruns"
+		searchText: "corvaapi main api client for corva platform. provides methods for get, put, patch, post, delete requests. api http request fetch rest get post put delete patch abilitycheck v2 ability_check check_feature check_permission feed activities alerts v1 comments likes toggle definitions context trigger close check templates enable disable alertdefinitions alertgroups alert_groups alert_group_users alert_group_assets alert_group_configurations occurrences acknowledge classify transition escalate deescalate totals details alertworkflows alert_workflows appreviews app_reviews approve decline assets favorites settings type_wells type_well reruns ancestor_ids resolve autocomplete programs clusters pads frac_fleets app_wells wells active_wells rigs active_well well_cache drillout_units frac fleets wirelines dashboardappannotations dashboard_app_annotations last_annotations dashboards users dashboard_apps bulk_create batch_update dashboard_folders dashboard_shares dashboard_folder_shares use clone use_template available_timezones well planning dashboards well_planning_dashboards data data_filters data_filters#2 files file sign preview download download_link url security groups assign_users copy_users wellview integration ingest bha frac_stage_design frac_stage_summary frac_stage_summary_calculated job_settings plugs .well-known jwks.json jwks messageproducer message_producer notifications acknowledge_all count unread security_policies companies permissions bulk_destroy grouped picklists items tasks user_token#1 user_token#2 user_token#3 user_token#4 sessions verification schemas export streaks identity_verifiers api_keys deactivate apps install packages upload app_categories categories featured types secrets appdatasets app_datasets mark_followable app_help_contents signed_url applogs app_logs events search apptypes app_types appsettingstemplates app_settings_templates share unshare copy publish appstreamtemplate app_stream_templates appstreamtemplateapp add_app update_app remove_app datasettypes dataset_types datset_types documents document_sections rig_templates aggregated_values rig aggregated values rig_template_categories rig_template_items tiers productsubscriptions product_subscriptions cancel deny platformsubscriptions platform_subscriptions resume provisioningsubscriptions provisioning_subscriptions app_streams purchasesubscriptions purchase_subscriptions subscriptionfeatures subscription_features wellcache corva blacklisteddatasets blacklisted_datasets app metrics app_metrics for_selected_apps appassets packagereviews package_reviews apppurchases app_purchases datasets filtered_by_apps appruns app_runs stop duplicate_check appstream idle_worker_stats create_backfill_stream force_resume batch_destroy update_edr_provider_connection_status appconnection app_connections update_package apperroralert app_error_alerts subscribe unsubscribe usage summaries workflows workflow_content_blocks workflow_apps workflowroles workflow_roles columnmappertemplates column_mapper_templates add_asset remove_asset columnmappertemplatechannels column_mapper_template_channels columnmappertemplaterules column_mapper_template_rules dashboard_workflows ungroup ungroup_all change_asset competitoranalysis competitor_analysis statistics company app_companies appstoretemplates app_store_templates appstoretemplatesections app_store_template_sections app_store_template_section appstorearticles app_store_articles remove_section signedurl audits dataset_audits permission_audits group_membership_audits provisioning_subscription_audits platform_subscription_audits purchase_subscription_audits event audit appusage usage_analytics app_usage usage_list view_date_list top_apps top_users total_usage_trend partialwellreruns partial_reruns list start_merging fail restart app_progress partialwellrerunappprogresses app_progresses searchsuggestions search_suggestions goals projects projectfolders project_folders projectfiles project_files registeredmodels registered_models appschedule app_schedules bulk_update_status package_audits apikey api_keys_management activate edrproviders edr_providers test_connection api_key_audits typewells padfracfleets pad_frac_fleets fracfleetcontracts frac_fleet_contracts interventionunits intervention_units interventionunitevents intervention_unit_events data export app data_export_app column_fields column_fields_list flat activity_code_mappings metrics_definitions countries country_list revoltchat revolt_chat_sessions interventionunitreruns intervention_unit_reruns"
 	},
 	{
 		id: "client-corvaDataAPI",
@@ -100090,6 +100404,14 @@ const withTimeout = async (promise, ms) => {
     }
 };
 
+/**
+ * Core @corva/ui entity kinds shared by tool schemas so the vocabulary stays in sync.
+ * `search_corva_ui` (type filter) and `submit_feedback` (category) build their enums from this
+ * base, each adding its own extra members. `list_corva_ui` intentionally uses a separate
+ * plural/versioned representation (components-v1/v2, hooks, …) and is not derived from this list.
+ */
+const ENTITY_TYPES = ['component', 'hook', 'util', 'constant', 'client'];
+
 /**
  * Split camelCase or PascalCase string into words
  * e.g., "CustomGradient" -> ["custom", "gradient"]
@@ -100152,6 +100474,16 @@ const scoreMultiWordQuery = (entry, queryWords, weights) => {
     return score;
 };
 
+const SEARCH_TYPES = [
+    'all',
+    ...ENTITY_TYPES,
+    'permission',
+    'icon',
+    'hoc',
+    'type',
+    'testing',
+    'style',
+];
 const searchToolName = 'search_corva_ui';
 const searchToolTitle = 'Search @corva/ui';
 const searchToolDescription = `Search the @corva/ui component library by name, use case, or description.
@@ -100164,23 +100496,7 @@ Examples:
 When category is 'v2' or 'v1' and the requested version has no match, the response surfaces a labeled fallback block from the other version so a single search still discovers a candidate. The agent should still prefer V2 when both versions match.`;
 const searchToolSchema = {
     query: z.string().describe('Search query - component name, use case, or description'),
-    type: z
-        .enum([
-        'all',
-        'component',
-        'hook',
-        'util',
-        'constant',
-        'client',
-        'permission',
-        'icon',
-        'hoc',
-        'type',
-        'testing',
-        'style',
-    ])
-        .optional()
-        .describe('Filter by type (default: all)'),
+    type: z.enum(SEARCH_TYPES).optional().describe('Filter by type (default: all)'),
     category: z
         .enum(['all', 'v2', 'v1'])
         .optional()
@@ -101096,6 +101412,53 @@ const handleGetDiagnostics = (stats, telemetry, identity) => {
     };
 };
 
+const FEEDBACK_CATEGORIES = [...ENTITY_TYPES, 'theme', 'tool', 'docs', 'other'];
+const submitFeedbackToolName = 'submit_feedback';
+const submitFeedbackToolTitle = 'Submit Feedback';
+const submitFeedbackToolDescription = `Send feedback about @corva/ui or this MCP server so the maintainers can improve docs and coverage.
+Use this when the user says something like "send feedback that…", or proactively when you hit a docs/coverage gap (a missing component, a wrong or incomplete prop, a hook that lacks an example, a search that should have matched but didn't).
+
+Always infer sentiment and category from the feedback itself — do not leave them at the defaults. Reserve sentiment 'neutral' for genuinely factual/mixed feedback and category 'other' only when none of the specific categories fit.
+Set source to 'agent' when you are reporting a gap on your own initiative, or 'user' when relaying something the user said.
+Keep message specific and actionable; name the component/hook/util in target when the feedback is about a particular item.`;
+const submitFeedbackToolSchema = {
+    message: z.string().min(1).describe('The feedback text (required). Be specific and actionable.'),
+    sentiment: z
+        .enum(['positive', 'negative', 'neutral'])
+        .optional()
+        .describe("Tone of the feedback — classify it from the message; don't default to neutral unless the feedback is genuinely neutral/factual (default: neutral)"),
+    category: z
+        .enum(FEEDBACK_CATEGORIES)
+        .optional()
+        .describe("What the feedback is about — pick the most specific category; use 'other' only when none apply"),
+    target: z
+        .string()
+        .optional()
+        .describe('The specific component/hook/util/tool the feedback is about (e.g. "Button")'),
+    source: z
+        .enum(['user', 'agent'])
+        .optional()
+        .describe("Who originated the feedback: 'user' (relayed) or 'agent' (default: user)"),
+};
+const handleSubmitFeedback = (args) => {
+    const message = args.message?.trim() ?? '';
+    if (!message) {
+        throw new Error('Feedback message cannot be empty.');
+    }
+    const sentiment = args.sentiment ?? 'neutral';
+    const source = args.source ?? 'user';
+    const category = args.category?.trim() || undefined;
+    const target = args.target?.trim() || undefined;
+    return {
+        response: createToolResponse(`Thanks — your feedback was recorded. (${sentiment})\nThe @corva/ui team uses this to improve the library and its docs.`),
+        message,
+        sentiment,
+        category,
+        target,
+        source,
+    };
+};
+
 // This file is auto-generated by `yarn mcp:generate-prompts`. Do not edit by hand.
 // Source: ./figma-to-code.prompt.md
 const figmaToCodePromptTemplate = "You are translating a Figma design into React components that consume the `@corva/ui` components library. Follow the\norchestration below strictly and prefer evidence from the target repo over assumptions.\n\n## Inputs\n\nUser request: {{input}}\n\nExtract the Figma URL from the user request by matching `figma.com/design/…`, `figma.com/make/…`, or\n`figma.com/board/…`. Treat the remainder as instructions (target path, file to extend, naming, behavior notes).\n\n## Precedence\n\nWhen sources of truth disagree on file layout, styling, or naming, follow this order (highest wins):\n\n1. Explicit instructions in the user request (target path, file to extend, naming).\n2. Figma Code Connect mappings returned by `mcp__figma__get_design_context`.\n3. `@corva/ui` MCP docs (`get_component_docs`, `get_theme_docs`, icon search, etc.). These are authoritative for what\n   exists in the components library.\n4. `AGENTS.md` / `CLAUDE.md` in the target repo, looked up in this order and merged (earlier wins):\n   a. the target directory,\n   b. the nearest package root (walk up to the first `package.json`), which matters in monorepos,\n   c. the repo root.\n5. 1–2 neighboring components in the target directory (fallback when 4 is silent on an axis).\n6. The minimal default policy in Step 8 (fallback when 4 and 5 are both silent).\n\n## Step 1 — Acknowledge (before any tool call)\n\nPrint one short line to the user confirming what you parsed: the Figma URL, the extracted `nodeId` and `fileKey`, and\nthe target path if stated. This is the only user-facing text until after Step 4 completes, so make it specific enough\nthat the user knows the command fired.\n\n## Step 2 — Verify Figma MCP availability\n\nBefore any other work, confirm the Figma Dev Mode MCP is active by checking whether `mcp__figma__get_design_context`\nappears in your available tools.\n\nIf the tool is NOT available:\n\n- Tell the user: \"The Figma Dev Mode MCP is not enabled in this Claude Code session. Enable it via Figma Desktop →\n  Preferences → Enable Dev Mode MCP Server, then restart Claude Code and re-run `/figma_to_code`.\"\n- Stop immediately. Do not call any other tool, do not ask follow-up questions, and do not attempt to generate code\n  without the design context.\n\nIf the tool IS available, proceed to the next step.\n\n## Step 3 — Resolve missing inputs\n\nIf no Figma URL is present in the user request, ask the user for it. If the target path (or file to extend) is not\nspecified, ask before generating. Do not invent a location.\n\n## Step 4 — Gather design context\n\nCall `mcp__figma__get_design_context` with the Figma URL. Inspect the response for:\n\n- Code Connect snippets / imports / designer instructions (use verbatim when present).\n- Design tokens exposed as CSS variables.\n- Screenshot and annotations.\n- Asset URLs (images, icons) that imply specific primitives.\n\nIf Code Connect coverage is unclear, `mcp__figma__get_code_connect_map` is a verification fallback.\nDo **not** call `mcp__figma__get_code_connect_suggestions`. That tool is for authoring new mappings, not codegen.\n\nIf the first `get_design_context` call returns a sparse \"too large\" response listing sublayer IDs, drill into only the\nheader, one representative row, and one content panel — do NOT recursively walk every child. A targeted sample is\nsufficient to infer the pattern for the remaining rows.\n\n## Step 5 — Read target-repo conventions\n\nBefore generating, read `AGENTS.md` / `CLAUDE.md` at precedence level 4 if present (target dir → nearest package root →\nrepo root). These files define the repo's conventions: file layout, directory structure, styling approach\n(SCSS / MUI `sx` / styled-components / CSS modules), size limits, naming, imports. Extract and apply what's relevant to\nthe target directory.\n\nIf no `AGENTS.md` / `CLAUDE.md` exists at any level, fall through to Step 8 (neighboring components).\n\nMatch the repo's documented import / module syntax (`@import` vs `@use`, named vs default exports, relative vs aliased\npaths). Do not refactor or \"modernize\" the convention as a side quest. If the documented form produces a build or type\nerror, substitute a working equivalent and list the substitution under \"Implementation deviations\" in the Gap Report so\nthe convention file can be updated.\n\n## Step 6 — Detect project mode\n\nRead `./package.json`:\n\n- `\"name\": \"@corva/ui\"` ⇒ **authoring mode**. You are contributing a new primitive to the library itself. If Step 5\n  did not yield a concrete file-structure contract (target directory, file layout, export conventions), **stop and ask\n  the user** where to scaffold before proceeding. Authoring a primitive in the wrong shape is worse than pausing.\n- `@corva/ui` listed in `dependencies` / `devDependencies` ⇒ **consumer mode** (default). Import from `@corva/ui` entry\n  points; do not scaffold new primitives into the consumer repo.\n\n## Step 7 — Resolve @corva/ui primitives for each unmapped node\n\nPriority: **Reuse > Compose > Create**. Create a new primitive only in `@corva/ui` authoring mode (per Step 6) or when\nthe user explicitly asks. In consumer mode, always compose existing primitives — never scaffold new ones.\n\n**Search by capability, not by package name.** Before importing any third-party rendering or runtime package directly,\nsearch `@corva/ui` by capability terms drawn from the Figma node's visual and behavioral language — never let a vendor\nor library name be the decisive query. `@corva/ui` typically wraps third-party libraries (including but not limited to\ncharts, maps, code editors, virtualized lists, drag-and-drop, and rich text) behind a Corva shell whose name contains\nno library name, so queries like `highcharts` or `mapbox` return noise. Treat a Corva shell as the default hypothesis\nand disprove it with three capability search axes: (a) the user-facing widget shell (e.g. `chart container with zoom\nand pan`, `map viewport`); (b) its interaction control family (e.g. `axis dropdown`, `zoom button`,\n`chart type switch`); (c) any setup, provider, or config utility (e.g. `chart theme`, `map provider`). When a shell\nturns up, also pull in its companion controls instead of re-implementing toolbar UX. Each of the three axes must be\nqueried against both `category: 'v2'` and `category: 'v1'` — interaction-control families and shell wrappers (chart,\nmap, editor) often live only in V1, so a V2-only sweep can falsely conclude no Corva equivalent exists. A direct\nthird-party import is valid only if all three axes ran across both versions and returned no Corva equivalent — record\nthe import in the Gap Report's Implementation deviations and list the exact capability queries you ran for each\nversion, so the gap is auditable.\n\nBatch all unrelated primitive, icon, and theme lookups below into a single parallel tool call. Do not serialize them\nacross turns.\n\nFor every Figma subtree without a Code Connect hit:\n\n1. `mcp__corva-ui__search_corva_ui` with `{ query: '<descriptive term>', type: 'component', category: 'v2' }` to find\n   candidate components. `query` is required; `type: 'component'` is required because category-only filtering does not\n   exclude non-component entries. The tool surfaces a labeled V1 fallback block in the response when V2 has no match —\n   when that block appears (or the response is \"No results\"), retry the same query with `category: 'v1'` and treat any\n   hits there as candidates. Prefer V2 when both versions match; a capability is only a true gap once both V2 and V1\n   have been queried explicitly.\n2. `mcp__corva-ui__get_component_docs` for each chosen component, passing the same `category` (`'v1'` or `'v2'`) that\n   the search returned — names can collide across versions (e.g., `Autocomplete` exists in both). Use the returned\n   import statement and prop schema verbatim. Variant values must come from the prop schema (e.g., the canonical\n   union returned for `variant` or `size`); do not translate Figma variant labels (`\"Primary\"`, `\"Large\"`) by guessing.\n3. For icons: `mcp__corva-ui__search_corva_ui` with `{ query: '<icon description>', type: 'icon' }`. Import exactly the\n   export name returned — naming is inconsistent (e.g., `DownSmallIcon`, `Pin`, `AttentionCustomIcon`). Do not guess a\n   suffix. Use `mcp__corva-ui__list_corva_ui` with `{ type: 'icons' }` only to discover available icon sets (it lists\n   sets and counts, not individual exports).\n4. For colors / spacing / typography / z-index: `mcp__corva-ui__get_theme_docs` — always use canonical token names, and\n   never hard-code hex values. Express tokens through whichever mechanism the target repo's `AGENTS.md` or neighboring\n   components already use (SCSS mixin, MUI `theme.*` helper, CSS custom property, Tailwind class, etc.). Match what's\n   there rather than introducing a new style system.\n\n   When a third-party config (chart libraries, mapping libs, canvas/WebGL code) requires palette / typography /\n   semantic-color literals inline in JS/TS, do not paste Figma hex values. Source the values from `get_theme_docs`. If\n   `@corva/ui` exposes a documented JS/TS theme module, import from it and cite the path. If no JS export exists,\n   surface the role as an \"Unmapped token\" in the Gap Report — do not silently inline a hex. This rule does NOT apply\n   to chart geometry (tick intervals, axis domains, heights, spacing) — those are domain values, not tokens.\n5. For hooks, constants, and clients implied by the design (subscriptions, feature flags, API calls, etc.):\n   `mcp__corva-ui__get_hook_docs`, `mcp__corva-ui__get_constants_docs`, `mcp__corva-ui__get_client_docs`. For generic\n   utilities (formatters, converters, helpers): `mcp__corva-ui__search_corva_ui` with `{ query, type: 'util' }`, or\n   browse with `mcp__corva-ui__list_corva_ui({ type: 'utils' })`.\n\n## Step 8 — Fall back to neighboring components when conventions are silent\n\nIf `AGENTS.md` / `CLAUDE.md` didn't cover a given axis (styling, file layout, naming), read 1–2 neighboring components\nin the target directory and match what's already there. Do not introduce a new styling system on top of the repo's\nexisting one.\n\nIf neighbors are also inconclusive, use this minimal default policy:\n\n- **Tokens:** canonical names from `get_theme_docs`; never hard-code hex. In `.tsx`, prefer MUI `theme.*` helpers; in\n  style files, prefer CSS custom properties.\n- **Component size:** prefer small, focused components. Split by responsibility when a single component starts handling\n  multiple distinct concerns.\n- **Output files:** emit only what's needed to render the design. Do not generate documentation, example, or story\n  files unless the user explicitly asked.\n\n## Step 9 — Generate\n\n- Emit the component file(s) at the path specified in the user's instructions (or at the location `AGENTS.md` /\n  neighbors indicate).\n- Use Code Connect imports verbatim where provided.\n- Use the exact prop names, types, and `importPath` values returned by `get_component_docs`.\n- Do **not** invent @corva/ui primitives, props, icons, or tokens that the MCP tools did not surface.\n- Prefer semantic HTML first (`<button>`, `<nav>`, `<main>`, etc.); add ARIA only where native semantics are\n  insufficient, and do not strip roles or semantics that `@corva/ui` primitives already provide.\n- When modifying an existing page/component, preserve existing data flow, state, and non-visual behavior unless the\n  user explicitly asked to change them. Touch the UI layer only.\n- When a style value must vary per instance from data (per-row colors, per-segment widths, etc.), pass it via a CSS\n  custom property rather than writing inline `style={{ <styling-property>: value }}`. Pattern:\n  `<div style={{ '--phase-color': c, '--phase-flex': flex } as React.CSSProperties} />` paired with\n  `background: var(--phase-color)` in the SCSS module. If the target repo uses a different style system, follow that\n  system's typed dynamic-value mechanism instead.\n- Per-instance dynamic styling applies only to genuinely runtime values (user input, API data, layout measurement). A\n  finite design palette of phase / status / category colors is NOT a runtime value — map those to `get_theme_docs`\n  tokens or to a documented `@corva/ui` color export. If no token exists, surface them as Unmapped tokens in Step 10\n  rather than committing raw hex anywhere (mock data, SCSS extension files, JS constants).\n\nBefore concluding, run this pre-delivery self-check:\n\n- Every `@corva/ui` import statement came from `get_component_docs` output — none guessed.\n- Every icon export name matches what `search_corva_ui` returned — no invented suffixes.\n- No hard-coded hex, rgba, or raw px spacing that should resolve through `get_theme_docs` tokens.\n- Every prop name **and value** matches the schema from `get_component_docs`, not a Figma variant label.\n- For every third-party rendering / runtime library I imported (chart, map, code editor, virtualization, etc.), I ran\n  capability-based `@corva/ui` searches across all three axes (widget shell, interaction controls, setup / config\n  utility) AND across both `category: 'v2'` and `category: 'v1'`, and either used the Corva shell with its companion\n  control family or listed the import in Implementation deviations together with the exact capability queries I ran for\n  each version.\n- The final section of this response is `## Gap Report` with the four required subsections (Step 10).\n\n## Step 10 — Gap Report (final section of your response)\n\nYour final assistant response must end with a top-level `## Gap Report` section using the exact shape below. When a\nsubsection has nothing to report, write `_None._` — do not omit subsections.\n\n    ## Gap Report\n\n    ### Unmapped design nodes\n    - <node name / Figma id> — <why no @corva/ui primitive fit; suggested action>\n    - …or `_None._`\n\n    ### Unmapped tokens\n    - <token role e.g. \"axis label color\"> — <Figma value> — <closest @corva/ui token, or \"no equivalent\">\n    - …or `_None._`\n\n    ### Implementation deviations\n    - <departure from convention or design> — <reason> — <follow-up needed>\n    - e.g. raw chart-config literals, custom HTML where a primitive existed, third-party rendering lib (chart, map,\n      editor) imported directly after capability-based `@corva/ui` searches found no Corva shell — list the queries\n      attempted across both `category: 'v2'` and `category: 'v1'`, deferred a11y, etc.\n    - …or `_None._`\n\n    ### Ambiguous props or interactions\n    - <component / interaction> — <ambiguity> — <assumption made or question for the user>\n    - …or `_None._`\n\nBegin with Step 1 now.\n";
@@ -101117,9 +101480,9 @@ const figmaToCodePromptArgsSchema = {
         .optional()
         .describe('Full user request. Include the Figma URL and any target path / extra context. If omitted, the assistant will ask the user before generating.'),
 };
-const INPUT_FALLBACK = '(no input provided — ask the user for the Figma URL and target path/directory before generating)';
+const INPUT_FALLBACK$1 = '(no input provided — ask the user for the Figma URL and target path/directory before generating)';
 const handleFigmaToCode = (args) => {
-    const text = figmaToCodePromptTemplate.replace('{{input}}', args.input ?? INPUT_FALLBACK);
+    const text = figmaToCodePromptTemplate.replace('{{input}}', args.input ?? INPUT_FALLBACK$1);
     return {
         description: figmaToCodePromptDescription,
         messages: [
@@ -101131,6 +101494,44 @@ const handleFigmaToCode = (args) => {
     };
 };
 
+const feedbackPromptName = 'feedback';
+const feedbackPromptTitle = 'Send Feedback';
+const feedbackPromptDescription = `Send feedback about @corva/ui or this MCP server to the maintainers. Surfaces as /mcp__corva-ui__feedback.
+
+Argument:
+- input: Your feedback. Optionally add a sentiment (positive / negative / neutral) and which component, hook, or tool it is about. If omitted, the assistant will ask before sending.
+
+Why a single argument: Claude Code's MCP-prompt bridge splits positional string args by whitespace, so a multi-arg schema would swallow only the first token per arg. One freeform arg captures the whole message.`;
+const feedbackPromptArgsSchema = {
+    input: z
+        .string()
+        .optional()
+        .describe('Your feedback. Optionally mention the sentiment and which component/hook/tool it is about. If omitted, the assistant will ask before sending.'),
+};
+const INPUT_FALLBACK = '(no feedback provided — ask the user what feedback they would like to share before sending)';
+const handleFeedback = (args) => {
+    const feedback = args.input?.trim() || INPUT_FALLBACK;
+    const text = `The user wants to send feedback about @corva/ui (the shared component library) or this MCP server.
+
+User feedback: ${feedback}
+
+Do the following:
+1. If no feedback was provided above, ask the user what they would like to share and wait for their reply. Do not invent feedback.
+2. Infer a sentiment ('positive', 'negative', or 'neutral') from the feedback. If it is ambiguous, ask the user briefly or default to 'neutral'.
+3. If the feedback is about a specific item, set category (component, hook, util, constant, client, theme, tool, docs, or other) and target (e.g. the component or hook name).
+4. Call \`mcp__corva-ui__submit_feedback\` with the message and the fields above, and set \`source: "user"\` (this feedback is relayed from the user).
+5. Confirm to the user that the feedback was sent.`;
+    return {
+        description: feedbackPromptDescription,
+        messages: [
+            {
+                role: 'user',
+                content: { type: 'text', text },
+            },
+        ],
+    };
+};
+
 const readJsonField = (filePath, ...keys) => {
     try {
         let value = JSON.parse(readFileSync(filePath, 'utf-8'));
@@ -101560,6 +101961,40 @@ class CorvaUiMcpServer {
                 return createErrorResponse(`Error: ${error instanceof Error ? error.message : String(error)}`);
             }
         });
+        this.server.registerTool(submitFeedbackToolName, {
+            title: submitFeedbackToolTitle,
+            description: submitFeedbackToolDescription,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            inputSchema: submitFeedbackToolSchema,
+        }, (args, extra) => {
+            const parentContext = extractContextFromMeta(extra?._meta);
+            try {
+                return this.executeToolWithObservability(submitFeedbackToolName, args, () => {
+                    const result = handleSubmitFeedback(args);
+                    // Supplemental low-cardinality counter, in addition to the standard
+                    // tool-call span/metrics recorded by the wrapper. No-op when disabled.
+                    if (this.telemetry.isEnabled()) {
+                        this.telemetry.metrics.recordFeedback(result.sentiment, result.category);
+                    }
+                    return { ...result, isEmpty: false };
+                }, r => `feedback recorded (${r.sentiment})`, {
+                    parentContext,
+                    getSpanAttributes: r => ({
+                        // Indexed copy of the message so it is searchable/groupable in
+                        // Uptrace (the gen_ai.tool.call.arguments copy is unindexed).
+                        'corva.mcp.feedback.message': r.message,
+                        'corva.mcp.feedback.sentiment': r.sentiment,
+                        'corva.mcp.feedback.source': r.source,
+                        'corva.mcp.feedback.message_length': r.message.length,
+                        ...(r.category ? { 'corva.mcp.feedback.category': r.category } : {}),
+                        ...(r.target ? { 'corva.mcp.feedback.target': r.target } : {}),
+                    }),
+                });
+            }
+            catch (error) {
+                return createErrorResponse(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        });
     }
     setupPrompts() {
         this.server.registerPrompt(figmaToCodePromptName, {
@@ -101570,6 +102005,14 @@ class CorvaUiMcpServer {
             const parentContext = extractContextFromMeta(extra?._meta);
             return this.executePromptWithObservability(figmaToCodePromptName, args, () => handleFigmaToCode(args), { parentContext, requestId: extra?.requestId });
         });
+        this.server.registerPrompt(feedbackPromptName, {
+            title: feedbackPromptTitle,
+            description: feedbackPromptDescription,
+            argsSchema: feedbackPromptArgsSchema,
+        }, (args, extra) => {
+            const parentContext = extractContextFromMeta(extra?._meta);
+            return this.executePromptWithObservability(feedbackPromptName, args, () => handleFeedback(args), { parentContext, requestId: extra?.requestId });
+        });
     }
     async run() {
         const connectTimer = this.mcpLogger.time('transport-connect');