feat: add consequentialHint to ToolAnnotations

index.d.ts

@@ -81,6 +81,11 @@ namespace WebMCP {
          * @default false
          */
         untrustedContentHint?: boolean;
+        /**
+         * If `true`, indicates that executing the tool will result in consequential actions that are significant, real-world, or non-reversible, ex: booking a flight, transferring money.
+         * @default false
+         */
+        consequentialHint?: boolean;
     }
 
     /**

index.test-d.ts

@@ -141,3 +141,24 @@ test('rejects a callback that disagrees with its schema', () => {
         execute: (input: { query: number }) => input.query,
     });
 });
+
+test('supports tool annotations', () => {
+    void document.modelContext?.registerTool({
+        name: 'annotated-tool',
+        description: 'Defines all tool annotations.',
+        annotations: {
+            readOnlyHint: true,
+            untrustedContentHint: false,
+            consequentialHint: false,
+        },
+        execute: () => {},
+    });
+
+    expectTypeOf<WebMCP.ToolAnnotations>().toEqualTypeOf<{
+        readOnlyHint?: boolean;
+        untrustedContentHint?: boolean;
+        consequentialHint?: boolean;
+    }>();
+    expectTypeOf<WebMCP.ModelContextTool['annotations']>().toEqualTypeOf<WebMCP.ToolAnnotations | undefined>();
+    expectTypeOf<WebMCP.RegisteredTool['annotations']>().toEqualTypeOf<WebMCP.ToolAnnotations | undefined>();
+});