accessflow-mcp-server 2.1.0 → 2.1.1-beta.1

package/dist/tools/index.js

@@ -1,20 +1,93 @@
 import { createToolRegistry } from './toolRegistry.js';
 import { withCredentialCheck } from '../utils/middleware.js';
 import { logger } from '../services/loggerService.js';
-export const registerTools = (server, apiService) => {
-    const toolRegistry = createToolRegistry(apiService);
-    for (const [toolName, tool] of Object.entries(toolRegistry)) {
-        try {
+import { createGetMostUrgentIssues } from './getMostUrgentIssues.js';
+import { createGetIssueRemediation } from './getIssueRemediation.js';
+import { createResolveIssue } from './resolveIssue.js';
+/**
+ * Creates a dynamic tool that creates an ApiService per-request from session data
+ */
+function createDynamicTool(factory, config) {
+    // Get the base tool definition using a temporary ApiService
+    // We only use this to get the tool schema (name, description, parameters)
+    const tempApiService = config.createApiService({
+        apiKey: 'temp',
+        domain: 'temp',
+    });
+    const baseTool = factory(tempApiService);
+    return {
+        name: baseTool.name,
+        description: baseTool.description || '',
+        parameters: baseTool.parameters || {},
+        execute: async (args, context) => {
+            // Create ApiService from session data for this request
+            const session = context.session;
+            if (!session?.apiKey || !session?.domain) {
+                logger.error({ session }, 'Session data not available or incomplete');
+                throw new Error('Session data not available or incomplete');
+            }
+            logger.debug({ domain: session.domain }, 'Creating ApiService from session for tool execution');
+            // Create the actual ApiService with real credentials
+            const apiService = config.createApiService(session);
+            const tool = factory(apiService);
+            // Execute with credentials check
             const wrappedTool = withCredentialCheck(apiService.domain, apiService.apiKey, tool);
-            server.addTool(wrappedTool);
+            if (!wrappedTool.execute) {
+                throw new Error('Tool execute function not available');
+            }
+            return wrappedTool.execute(args, context);
+        },
+    };
+}
+export const registerTools = (server, config) => {
+    if (config.mode === 'stdio') {
+        // stdio mode: Use pre-created ApiService
+        const toolRegistry = createToolRegistry(config.apiService);
+        for (const [toolName, tool] of Object.entries(toolRegistry)) {
+            try {
+                const wrappedTool = withCredentialCheck(config.apiService.domain, config.apiService.apiKey, tool);
+                server.addTool(wrappedTool);
+            }
+            catch (error) {
+                logger.error({
+                    toolName,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    stack: error instanceof Error ? error.stack : undefined,
+                }, 'Failed to register tool');
+            }
         }
-        catch (error) {
-            logger.error({
-                toolName,
-                error: error instanceof Error ? error.message : 'Unknown error',
-                stack: error instanceof Error ? error.stack : undefined,
-            }, 'Failed to register tool');
-            continue;
+    }
+    else {
+        // HTTP mode: Create ApiService per-request from session
+        // Get tool factories (already imported at the top)
+        const toolFactories = [
+            {
+                name: 'get_most_urgent_issues',
+                factory: createGetMostUrgentIssues,
+            },
+            {
+                name: 'get_issue_remediation',
+                factory: createGetIssueRemediation,
+            },
+            {
+                name: 'resolve_issue',
+                factory: createResolveIssue,
+            },
+        ];
+        // Register each tool with dynamic execute wrapper
+        for (const { name, factory } of toolFactories) {
+            try {
+                const dynamicTool = createDynamicTool(factory, config);
+                server.addTool(dynamicTool);
+                logger.info({ toolName: name }, 'Registered HTTP mode tool');
+            }
+            catch (error) {
+                logger.error({
+                    toolName: name,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    stack: error instanceof Error ? error.stack : undefined,
+                }, 'Failed to register HTTP mode tool');
+            }
         }
     }
 };

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAe,EAAE,UAAsB,EAAE,EAAE;IACvE,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAEpD,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,mBAAmB,CACrC,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,MAAM,EACjB,IAAI,CACL,CAAC;YACF,MAAM,CAAC,OAAO,CAAC,WAAwC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV;gBACE,QAAQ;gBACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxD,EACD,yBAAyB,CAC1B,CAAC;YAEF,SAAS;QACX,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAYvD;;GAEG;AACH,SAAS,iBAAiB,CACxB,OAAmD,EACnD,MAAyD;IAEzD,4DAA4D;IAC5D,0EAA0E;IAC1E,MAAM,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAC7C,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzC,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;QACvC,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAK,EAAU;QAC9C,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,OAAY,EAAE,EAAE;YAC7C,uDAAuD;YACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAsB,CAAC;YAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBACzC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,0CAA0C,CAAC,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,CAAC,KAAK,CACV,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAC1B,qDAAqD,CACtD,CAAC;YAEF,qDAAqD;YACrD,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;YAEjC,iCAAiC;YACjC,MAAM,WAAW,GAAG,mBAAmB,CACrC,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,MAAM,EACjB,IAAI,CACL,CAAC;YAEF,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACzD,CAAC;YAED,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAe,EACf,MAA8B,EAC9B,EAAE;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,yCAAyC;QACzC,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE3D,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,mBAAmB,CACrC,MAAM,CAAC,UAAU,CAAC,MAAM,EACxB,MAAM,CAAC,UAAU,CAAC,MAAM,EACxB,IAAI,CACL,CAAC;gBACF,MAAM,CAAC,OAAO,CAAC,WAAwC,CAAC,CAAC;YAC3D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CACV;oBACE,QAAQ;oBACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;oBAC/D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;iBACxD,EACD,yBAAyB,CAC1B,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,wDAAwD;QACxD,mDAAmD;QACnD,MAAM,aAAa,GAAG;YACpB;gBACE,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,yBAAyB;aACnC;YACD;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,yBAAyB;aACnC;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,kBAAkB;aAC5B;SACF,CAAC;QAEF,kDAAkD;QAClD,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,aAAa,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACvD,MAAM,CAAC,OAAO,CAAC,WAAwC,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,2BAA2B,CAAC,CAAC;YAC/D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CACV;oBACE,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;oBAC/D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;iBACxD,EACD,mCAAmC,CACpC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/resolveIssue.d.ts

@@ -3,11 +3,7 @@ import { z } from 'zod';
 import { ApiService } from '../services/apiService.js';
 declare const parameters: z.ZodObject<{
     issueDisplayName: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    issueDisplayName: string;
-}, {
-    issueDisplayName: string;
-}>;
+}, z.core.$strip>;
 /**
  * Creates the resolveIssue tool for FastMCP
  */

package/dist/tools/resolveIssue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveIssue.d.ts","sourceRoot":"","sources":["../../src/tools/resolveIssue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAY,MAAM,2BAA2B,CAAC;AAGjE,QAAA,MAAM,UAAU;;;;;;EAOd,CAAC;AAUH;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,UAAU,KACrB,IAAI,CAAC,GAAG,EAAE,OAAO,UAAU,CA2E7B,CAAC"}
+{"version":3,"file":"resolveIssue.d.ts","sourceRoot":"","sources":["../../src/tools/resolveIssue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAY,MAAM,2BAA2B,CAAC;AAGjE,QAAA,MAAM,UAAU;;iBAOd,CAAC;AAUH;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,UAAU,KACrB,IAAI,CAAC,GAAG,EAAE,OAAO,UAAU,CAkG7B,CAAC"}

package/dist/tools/resolveIssue.js

@@ -18,14 +18,26 @@ export const createResolveIssue = (apiService) => {
         execute: async (args, context) => {
             const typedArgs = parameters.parse(args);
             try {
+                logger.info({
+                    domain: apiService.domain,
+                    issueDisplayName: typedArgs.issueDisplayName,
+                }, 'resolveIssue started');
                 const result = await resolveIssueInAccessFlow(apiService, typedArgs.issueDisplayName);
                 if (!result) {
+                    logger.info({
+                        domain: apiService.domain,
+                        issueDisplayName: typedArgs.issueDisplayName,
+                    }, 'resolveIssue: issue not found');
                     return `**Issue Not Found**
 
 No accessibility issue found with display name: ${typedArgs.issueDisplayName}
 
 Please verify the issue display name and try again.`;
                 }
+                logger.info({
+                    domain: apiService.domain,
+                    issueDisplayName: typedArgs.issueDisplayName,
+                }, 'resolveIssue completed');
                 return `**Issue Resolved Successfully**
 
 The accessibility issue "${typedArgs.issueDisplayName}" has been marked as resolved in accessFlow.

package/dist/tools/resolveIssue.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveIssue.js","sourceRoot":"","sources":["../../src/tools/resolveIssue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,CACP,uFAAuF,CACxF;CACJ,CAAC,CAAC;AAUH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,UAAsB,EACQ,EAAE;IAChC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,2EAA2E;QAC7E,UAAU;QACV,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,OAAqB,EAAE,EAAE;YACtD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEzC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,UAAU,EACV,SAAS,CAAC,gBAAgB,CAC3B,CAAC;gBAEF,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;;kDAEiC,SAAS,CAAC,gBAAgB;;oDAExB,CAAC;gBAC7C,CAAC;gBAED,OAAO;;2BAEY,SAAS,CAAC,gBAAgB;;8EAEyB,CAAC;YACzE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,YAAoB,CAAC;gBACzB,IAAI,YAAY,GAAW,EAAE,CAAC;gBAE9B,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;oBAC9B,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;oBAC7B,YAAY,GAAG,YAAY,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC;oBAEnE,MAAM,CAAC,KAAK,CACV;wBACE,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;wBAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;qBAC7B,EACD,2BAA2B,CAC5B,CAAC;gBACJ,CAAC;qBAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;oBAClC,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;oBAC7B,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAE3D,MAAM,CAAC,KAAK,CACV;wBACE,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;wBAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;qBACnB,EACD,uBAAuB,CACxB,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,YAAY,GAAG,wBAAwB,CAAC;oBAExC,MAAM,CAAC,KAAK,CACV;wBACE,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;wBAC5C,KAAK;qBACN,EACD,+BAA+B,CAChC,CAAC;gBACJ,CAAC;gBAED,MAAM,IAAI,KAAK,CACb,4BAA4B,YAAY,IAAI,YAAY,6HAA6H,CACtL,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,KAAK,UAAU,wBAAwB,CACrC,UAAsB,EACtB,gBAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACjE,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"resolveIssue.js","sourceRoot":"","sources":["../../src/tools/resolveIssue.ts"],"names":[],"mappings":"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"}

package/dist/tools/submitFeedback.d.ts

@@ -0,0 +1,17 @@
+import type { Tool } from 'fastmcp';
+import { z } from 'zod';
+import { ApiService } from '../services/apiService.js';
+declare const parameters: z.ZodObject<{
+    feedbackRating: z.ZodOptional<z.ZodEnum<{
+        very_helpful: "very_helpful";
+        partially_helpful: "partially_helpful";
+        not_helpful: "not_helpful";
+    }>>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Creates the submitFeedback tool for FastMCP
+ */
+export declare const createSubmitFeedback: (apiService: ApiService) => Tool<any, typeof parameters>;
+export {};
+//# sourceMappingURL=submitFeedback.d.ts.map

package/dist/tools/submitFeedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submitFeedback.d.ts","sourceRoot":"","sources":["../../src/tools/submitFeedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAY,MAAM,2BAA2B,CAAC;AAIjE,QAAA,MAAM,UAAU;;;;;;;iBAQd,CAAC;AAIH;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,KACrB,IAAI,CAAC,GAAG,EAAE,OAAO,UAAU,CAsF7B,CAAC"}

package/dist/tools/submitFeedback.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { ApiService, ApiError } from '../services/apiService.js';
+import { logger } from '../services/loggerService.js';
+import { FeedbackRating } from '../services/apiSchemas.js';
+const parameters = z.object({
+    feedbackRating: FeedbackRating.optional().describe('Rating of the response helpfulness: very_helpful, partially_helpful, or not_helpful'),
+    suggestion: z
+        .string()
+        .optional()
+        .describe('Optional suggestion for improvement'),
+});
+/**
+ * Creates the submitFeedback tool for FastMCP
+ */
+export const createSubmitFeedback = (apiService) => {
+    return {
+        name: 'submitFeedback',
+        description: 'Submit user feedback for MCP responses. Use this after receiving any MCP tool response to provide feedback on its helpfulness. Feedback is optional and helps improve the MCP experience.',
+        parameters,
+        execute: async (args, context) => {
+            const typedArgs = parameters.parse(args);
+            if (!typedArgs.feedbackRating && !typedArgs.suggestion) {
+                throw new Error('Please provide either a feedback rating or a suggestion.');
+            }
+            try {
+                logger.info({
+                    domain: apiService.domain,
+                    feedbackRating: typedArgs.feedbackRating,
+                    hasSuggestion: !!typedArgs.suggestion,
+                }, 'submitFeedback started');
+                // Validate and submit feedback
+                const response = await apiService.submitFeedback(typedArgs.feedbackRating, typedArgs.suggestion);
+                logger.info({
+                    domain: apiService.domain,
+                    success: response.success,
+                }, 'submitFeedback completed');
+                return JSON.stringify({
+                    success: true,
+                    message: 'Thank you for your feedback! Your input helps us improve the MCP experience.',
+                    feedbackRating: typedArgs.feedbackRating,
+                    ...(typedArgs.suggestion && { suggestion: typedArgs.suggestion }),
+                }, null, 2);
+            }
+            catch (error) {
+                let errorMessage;
+                let errorDetails = '';
+                if (error instanceof ApiError) {
+                    errorMessage = error.message;
+                    errorDetails = ` Status: ${error.statusCode} ${error.statusText}.`;
+                    logger.error({
+                        message: error.message,
+                        statusCode: error.statusCode,
+                        statusText: error.statusText,
+                    }, 'Error in submitFeedback');
+                }
+                else if (error instanceof Error) {
+                    errorMessage = error.message;
+                    errorDetails = error.stack ? ` Stack: ${error.stack}` : '';
+                    logger.error({
+                        message: error.message,
+                        stack: error.stack,
+                    }, 'Error in submitFeedback');
+                }
+                else {
+                    errorMessage = 'Unknown error occurred';
+                    logger.error({ error }, 'Unknown error in submitFeedback');
+                }
+                throw new Error(`Failed to submit feedback: ${errorMessage}.${errorDetails} This may be due to a network issue or server error.`);
+            }
+        },
+    };
+};
+//# sourceMappingURL=submitFeedback.js.map

package/dist/tools/submitFeedback.js.map

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

package/dist/tools/toolRegistry.d.ts

@@ -1,19 +1,24 @@
 import type { ApiService } from '../services/apiService.js';
 export declare const createToolRegistry: (apiService: ApiService) => {
-    get_most_urgent_issues: import("fastmcp").Tool<any, import("zod").ZodObject<{}, import("zod").UnknownKeysParam, import("zod").ZodTypeAny, {}, {}>>;
+    get_most_urgent_issues: import("fastmcp").Tool<any, import("zod").ZodObject<{
+        auditSource: import("zod").ZodDefault<import("zod").ZodEnum<{
+            PLATFORM: "PLATFORM";
+            SDK: "SDK";
+        }>>;
+        branch: import("zod").ZodOptional<import("zod").ZodString>;
+        commitId: import("zod").ZodOptional<import("zod").ZodString>;
+        repo: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
     get_issue_remediation: import("fastmcp").Tool<any, import("zod").ZodObject<{
+        auditSource: import("zod").ZodDefault<import("zod").ZodEnum<{
+            PLATFORM: "PLATFORM";
+            SDK: "SDK";
+        }>>;
+        commitId: import("zod").ZodOptional<import("zod").ZodString>;
         issueDisplayName: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        issueDisplayName: string;
-    }, {
-        issueDisplayName: string;
-    }>>;
+    }, import("zod/v4/core").$strip>>;
     resolve_issue: import("fastmcp").Tool<any, import("zod").ZodObject<{
         issueDisplayName: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        issueDisplayName: string;
-    }, {
-        issueDisplayName: string;
-    }>>;
+    }, import("zod/v4/core").$strip>>;
 };
 //# sourceMappingURL=toolRegistry.d.ts.map

package/dist/tools/toolRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../src/tools/toolRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,eAAO,MAAM,kBAAkB,GAAI,YAAY,UAAU;;;;;;;;;;;;;;;;CAIvD,CAAC"}
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../src/tools/toolRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,eAAO,MAAM,kBAAkB,GAAI,YAAY,UAAU;;;;;;;;;;;;;;;;;;;;;CAIvD,CAAC"}

package/dist/types/issues.d.ts

@@ -2,7 +2,7 @@
  * Output type definitions for formatted responses
  * (Input types are inferred from Zod schemas in apiSchemas.ts)
  */
-export type { Severity, WCAGLevelType as WCAGLevel, ApiIssue, ApiUrgentIssuesResponse, ApiIssueRemediation, } from '../services/apiSchemas.js';
+export type { Severity, WCAGLevelType as WCAGLevel, ApiIssue, ApiAuditIssue, ApiSdkIssueContext, AuditSourceType, ApiUrgentIssuesResponse, ApiIssueRemediation, } from '../services/apiSchemas.js';
 /**
  * Formatted issue for display (output type - created by our code)
  */
@@ -14,6 +14,12 @@ export interface FormattedIssue {
     criteria: string;
     siteOccurrences: number;
     pageOccurrences: number;
+    sdkContext?: {
+        filePath: string | null;
+        lineNumber: number | null;
+        componentName: string | null;
+        snippet: string | null;
+    } | null;
 }
 /**
  * Response structure for urgent issues (output type - created by our code)

package/dist/types/issues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/types/issues.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,QAAQ,EACR,aAAa,IAAI,SAAS,EAC1B,QAAQ,EACR,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH"}
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/types/issues.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,QAAQ,EACR,aAAa,IAAI,SAAS,EAC1B,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,IAAI,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH"}

package/dist/types/remediation.d.ts

@@ -2,5 +2,5 @@
  * Type definitions for issue remediation
  * (All types are inferred from Zod schemas in apiSchemas.ts)
  */
-export type { ApiIssueRemediation, ApiRule, } from '../services/apiSchemas.js';
+export type { ApiIssueRemediation, ApiAuditIssueRemediation, ApiSdkIssueContext, AuditSourceType, ApiRule, } from '../services/apiSchemas.js';
 //# sourceMappingURL=remediation.d.ts.map

package/dist/types/remediation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/types/remediation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,mBAAmB,EACnB,OAAO,GACR,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/types/remediation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,OAAO,GACR,MAAM,2BAA2B,CAAC"}

package/dist/utils/remediation.d.ts

@@ -1,7 +1,7 @@
 /**
  * Utility functions for formatting remediation responses
  */
-import type { ApiIssueRemediation } from '../types/remediation.js';
+import type { ApiAuditIssueRemediation } from '../types/remediation.js';
 /**
  * Extracts date from various formats
  */
@@ -13,7 +13,9 @@ export declare function extractDate(date?: {
  */
 export declare function extractCodeBlocks(htmlResolution: string): string[];
 /**
- * Formats the remediation response as markdown
+ * Formats the remediation response as markdown.
+ * When the issue carries sdkContext, a code-location section is prepended
+ * so the developer can find the finding in their editor immediately.
  */
-export declare function formatRemediationResponse(issue: ApiIssueRemediation): string;
+export declare function formatRemediationResponse(issue: ApiAuditIssueRemediation): string;
 //# sourceMappingURL=remediation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/utils/remediation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAclE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAsG5E"}
+{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/utils/remediation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAW,MAAM,yBAAyB,CAAC;AAEjF;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAclE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAoHjF"}

package/dist/utils/remediation.js

@@ -33,7 +33,9 @@ export function extractCodeBlocks(htmlResolution) {
     });
 }
 /**
- * Formats the remediation response as markdown
+ * Formats the remediation response as markdown.
+ * When the issue carries sdkContext, a code-location section is prepended
+ * so the developer can find the finding in their editor immediately.
  */
 export function formatRemediationResponse(issue) {
     const { rule } = issue;
@@ -45,17 +47,30 @@ export function formatRemediationResponse(issue) {
     const severity = issue.severity?.toUpperCase() || 'Unknown';
     const criteria = issue.criteria || 'Unknown';
     const wcagLink = rule?.issueWCAGLink || '';
-    // 3. Code-level fix suggestions
+    // 3. SDK code-location context (only present for SDK audits)
+    let sdkSection = '';
+    const sdk = issue.sdkContext;
+    if (sdk && (sdk.filePath || sdk.componentName || sdk.lineNumber !== null)) {
+        sdkSection = '\n## Code Location\n\n';
+        if (sdk.filePath) {
+            sdkSection += `- **File:** \`${sdk.filePath}\`${sdk.lineNumber !== null ? `:${sdk.lineNumber}` : ''}\n`;
+        }
+        if (sdk.componentName) {
+            sdkSection += `- **Component:** \`${sdk.componentName}\`\n`;
+        }
+        if (sdk.snippet) {
+            sdkSection += `\n**Relevant code:**\n\`\`\`\n${sdk.snippet}\n\`\`\`\n`;
+        }
+    }
+    // 4. Code-level fix suggestions
     let codeFix = '\n## Code-Level Fix\n\n';
     if (rule) {
         codeFix += rule.shortDescription
             ? `**Solution:** ${rule.shortDescription}\n\n`
             : '';
-        // Show the current problematic code
         if (issue.HTML) {
             codeFix += '**Current code:**\n```html\n' + issue.HTML + '\n```\n\n';
         }
-        // Extract code examples from the HTML resolution if available
         if (rule.issueResolution) {
             const codeBlocks = extractCodeBlocks(rule.issueResolution);
             if (codeBlocks.length > 0) {
@@ -64,7 +79,6 @@ export function formatRemediationResponse(issue) {
                 });
             }
         }
-        // Add suggested fix details if available
         if (rule.suggestedFix && rule.suggestedFix.length > 0) {
             codeFix += '**Quick Fix Suggestions:**\n';
             rule.suggestedFix.forEach((fix, index) => {
@@ -82,7 +96,7 @@ export function formatRemediationResponse(issue) {
     else {
         codeFix += 'No specific rule found for this issue.\n\n';
     }
-    // 4. Links back to remediation panel
+    // 5. Additional resources
     const issueDate = extractDate(issue.date ||
         issue.modified);
     const confidence = issue.confidence ?? 0;
@@ -90,7 +104,7 @@ export function formatRemediationResponse(issue) {
     const siteOccurrences = issue.siteOccurrences ?? 0;
     const webpath = issue.webpage?.webpath || 'N/A';
     const webpages = issue.webpages || [];
-    const selector = issue.selector || 'N/A';
+    const selector = issue.selector || sdk?.filePath || 'N/A';
     const remediationLinks = `
 ## 📚 Additional Resources
 
@@ -113,7 +127,7 @@ ${selector !== 'N/A' ? `- **The Selector for the issue is: ${selector}.` : ''}
 - **Severity:** ${severity}
 - **WCAG Level:** ${wcagLevel}
 - **Criteria:** ${criteria}
-
+${sdkSection}
 ${codeFix}
 
 ${remediationLinks}

package/dist/utils/remediation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "accessflow-mcp-server",
-  "version": "2.1.0",
+  "version": "2.1.1-beta.1",
   "type": "module",
   "description": "AccessFlow MCP Server for accessibility issue remediation",
   "main": "./dist/index.js",
@@ -13,7 +13,8 @@
     }
   },
   "bin": {
-    "accessflow-mcp-server": "./dist/index.js"
+    "accessflow-mcp-server": "./dist/index.js",
+    "accessflow-mcp-http": "./dist/http-server.js"
   },
   "files": [
     "dist",
@@ -21,12 +22,14 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "scripts": {
     "dev": "tsx src/index.ts",
-    "build": "tsc && rm -rf dist/data && cp -r src/data dist/data 2>/dev/null || true && rm -rf dist/**/__tests__ dist/**/*.test.js dist/**/*.test.d.ts dist/**/*.test.js.map dist/**/*.test.d.ts.map 2>/dev/null || true && chmod +x dist/index.js",
+    "dev:http": "tsx src/http-server.ts",
+    "build": "bash scripts/build.sh",
     "start": "node dist/index.js",
+    "start:http": "node dist/http-server.js",
     "prepublishOnly": "npm run build",
     "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,md}\"",
     "test": "vitest run",
@@ -48,6 +51,7 @@
     "@typescript-eslint/eslint-plugin": "^8.46.4",
     "@typescript-eslint/parser": "^8.46.4",
     "@vitest/coverage-v8": "^2.1.8",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "pino-pretty": "^13.1.2",