Merge pull request #36 from khawkins/title_annotation_spec

Updating spec to require title annotation

Author: khawkins

docs/2_salesforce-mobile-web-mcp-server.md

@@ -111,7 +111,7 @@ This ensures a frictionless, installation-free experience for developers and too
 
 _See [Tool Annotations](https://modelcontextprotocol.io/docs/concepts/tools#tool-annotations) in the Model Context Protocol User Guide_
 
-The following server tool annotations are applied based on tool type:
+All tools include a `title` annotation using the human-readable title specified in their respective tool suite documentation. The following additional server tool annotations are applied based on tool type:
 
 **Information-Only Tools (e.g., Native Capabilities):**
 

docs/3_mobile_native_capabilities.md

@@ -24,6 +24,8 @@ The Mobile Native Capabilities tool suite provides grounding context for creatin
 
 # MCP Server Tools
 
+Each tool's **Title** field is used as the `title` annotation in the MCP server implementation, providing human-readable display names for client interfaces.
+
 ## App Review
 
 **Name:** `sfmobile-web-app-review`  

docs/4_mobile_offline.md

@@ -327,6 +327,8 @@ The MCP server package includes:
 
 # MCP Server Tools
 
+Each tool's **Title** field is used as the `title` annotation in the MCP server implementation, providing human-readable display names for client interfaces.
+
 ## Tool 1: Mobile Offline Guidance
 
 **Name:** `sfmobile-web-offline-guidance`  

package-lock.json

@@ -34,6 +34,7 @@ const LINTER_CONFIG: Linter.Config = {
 
 export class OfflineAnalysisTool implements Tool {
   readonly name = 'Mobile Web Offline Analysis Tool';
+  readonly title = 'Salesforce Mobile Offline LWC Expert Static Analysis';
   readonly description =
     'Analyzes LWC components for mobile-specific issues and provides detailed recommendations for improvements. It can be leveraged to check if components are mobile-ready.';
   readonly toolId = 'sfmobile-web-offline-analysis';
@@ -55,7 +56,10 @@ export class OfflineAnalysisTool implements Tool {
         description: this.description,
         inputSchema: this.inputSchema.shape,
         outputSchema: this.outputSchema.shape,
-        annotations: annotations,
+        annotations: {
+          ...annotations,
+          title: this.title,
+        },
       },
       async (code: LwcCodeType) => {
         try {

packages/mobile-web/src/tools/mobile-offline/offline-analysis/tool.ts

@@ -21,6 +21,7 @@ const EMPTY_INPUT_SCHEMA = z.object({}).describe('No input required');
 
 export class OfflineGuidanceTool implements Tool {
   readonly name = 'Mobile Web Offline Guidance Tool';
+  readonly title = 'Salesforce Mobile Offline LWC Expert Instruction Delivery';
   readonly description =
     'Provides structured review instructions to detect and remediate Mobile Offline code violations in Lightning web components (LWCs) for Salesforce Mobile Apps.';
   readonly toolId = 'sfmobile-web-offline-guidance';
@@ -34,7 +35,10 @@ export class OfflineGuidanceTool implements Tool {
         description: this.description,
         inputSchema: this.inputSchema.shape,
         outputSchema: this.outputSchema.shape,
-        annotations: annotations,
+        annotations: {
+          ...annotations,
+          title: this.title,
+        },
       },
       async () => {
         try {

packages/mobile-web/src/tools/mobile-offline/offline-guidance/tool.ts

@@ -9,6 +9,7 @@ import { BaseTool } from '../baseTool.js';
 
 export class AppReviewTool extends BaseTool {
   readonly name = 'App Review Service';
+  readonly title = 'Salesforce Mobile App Review LWC Native Capability';
   public readonly toolId = 'sfmobile-web-app-review';
   public readonly description =
     'Provides expert grounding to implement a mobile app store review feature in a Salesforce Lightning web component (LWC).';

packages/mobile-web/src/tools/native-capabilities/appReview/tool.ts

@@ -9,6 +9,7 @@ import { BaseTool } from '../baseTool.js';
 
 export class ArSpaceCaptureTool extends BaseTool {
   readonly name = 'AR Space Capture';
+  readonly title = 'Salesforce Mobile AR Space Capture LWC Native Capability';
   public readonly toolId = 'sfmobile-web-ar-space-capture';
   public readonly description =
     'Provides expert grounding to implement an AR Space Capture feature in a Salesforce Lightning web component (LWC).';

packages/mobile-web/src/tools/native-capabilities/arSpaceCapture/tool.ts

@@ -9,6 +9,7 @@ import { BaseTool } from '../baseTool.js';
 
 export class BarcodeScannerTool extends BaseTool {
   readonly name = 'Barcode Scanner';
+  readonly title = 'Salesforce Mobile Barcode Scanner LWC Native Capability';
   public readonly toolId = 'sfmobile-web-barcode-scanner';
   public readonly description =
     'Provides expert grounding to implement a Barcode Scanner feature in a Salesforce Lightning web component (LWC).';

packages/mobile-web/src/tools/native-capabilities/barcodeScanner/tool.ts

@@ -16,6 +16,7 @@ import { Tool } from '../tool.js';
 export abstract class BaseTool implements Tool {
   public abstract readonly name: string;
   public abstract readonly description: string;
+  public abstract readonly title: string;
   protected abstract readonly typeDefinitionPath: string;
   public abstract readonly toolId: string;
   protected abstract readonly serviceDescription: string;
@@ -101,11 +102,17 @@ ${typeDefinitions}
   }
 
   public register(server: McpServer, annotations: ToolAnnotations): void {
+    // Add title annotation from the tool
+    const enhancedAnnotations = {
+      ...annotations,
+      title: this.title,
+    };
+
     server.tool(
       this.toolId,
       this.description,
       EmptySchema.shape,
-      annotations,
+      enhancedAnnotations,
       this.handleRequest.bind(this)
     );
   }