Add support for MCP hint annotations

Author: pimterry

src/cli/cli.ts

@@ -18,6 +18,12 @@ interface HtkOperation {
     description: string;
     category: string;
     inputSchema: any;
+    annotations?: {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
 }
 
 // NOTE: This logic is duplicated in src/index.ts — keep in sync.
@@ -401,7 +407,8 @@ function operationsToMcpTools(operations: HtkOperation[]): any[] {
         inputSchema: {
             type: 'object',
             properties: op.inputSchema?.properties ?? {},
-        }
+        },
+        ...(op.annotations && { annotations: op.annotations })
     }));
 }
 

src/ui-bridge.ts

@@ -12,6 +12,12 @@ export interface HtkOperation {
     category: string;
     inputSchema: object;
     outputSchema: object;
+    annotations?: {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
 }
 
 interface PendingRequest {