add tool annotations

kentcdodds · kentcdodds · commit cc647e704525 · 2025-09-11T14:12:37.000-06:00
diff --git a/epicshop/package-lock.json b/epicshop/package-lock.json
diff --git a/epicshop/package.json b/epicshop/package.json
@@ -1,9 +1,9 @@
 {
   "type": "module",
   "dependencies": {
-    "@epic-web/workshop-app": "^6.23.7",
-    "@epic-web/workshop-cli": "^6.23.7",
-    "@epic-web/workshop-utils": "^6.23.7",
+    "@epic-web/workshop-app": "^6.23.8",
+    "@epic-web/workshop-cli": "^6.23.8",
+    "@epic-web/workshop-utils": "^6.23.8",
     "chokidar": "^4.0.3",
     "enquirer": "^2.4.1",
     "execa": "^9.6.0",
diff --git a/exercises/01.advanced-tools/01.problem.annotations/package.json b/exercises/01.advanced-tools/01.problem.annotations/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/01.advanced-tools/01.solution.annotations/package.json b/exercises/01.advanced-tools/01.solution.annotations/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/01.advanced-tools/02.problem.structured/package.json b/exercises/01.advanced-tools/02.problem.structured/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/01.advanced-tools/02.solution.structured/package.json b/exercises/01.advanced-tools/02.solution.structured/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/02.elicitation/01.problem/package.json b/exercises/02.elicitation/01.problem/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/02.elicitation/01.solution/package.json b/exercises/02.elicitation/01.solution/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/03.sampling/01.problem.simple/package.json b/exercises/03.sampling/01.problem.simple/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/03.sampling/01.solution.simple/package.json b/exercises/03.sampling/01.solution.simple/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/03.sampling/02.problem.advanced/package.json b/exercises/03.sampling/02.problem.advanced/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/03.sampling/02.solution.advanced/package.json b/exercises/03.sampling/02.solution.advanced/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/04.long-running-tasks/01.problem.progress/package.json b/exercises/04.long-running-tasks/01.problem.progress/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/04.long-running-tasks/01.solution.progress/package.json b/exercises/04.long-running-tasks/01.solution.progress/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/04.long-running-tasks/02.problem.cancellation/package.json b/exercises/04.long-running-tasks/02.problem.cancellation/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/04.long-running-tasks/02.solution.cancellation/package.json b/exercises/04.long-running-tasks/02.solution.cancellation/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/05.changes/01.problem.list-changed/package.json b/exercises/05.changes/01.problem.list-changed/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/05.changes/01.solution.list-changed/package.json b/exercises/05.changes/01.solution.list-changed/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/05.changes/02.problem.resources-list-changed/package.json b/exercises/05.changes/02.problem.resources-list-changed/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/05.changes/02.problem.resources-list-changed/src/tools.ts b/exercises/05.changes/02.problem.resources-list-changed/src/tools.ts
@@ -497,6 +497,20 @@ export async function initializeTools(agent: EpicMeMCP) {
 	await updateTools()
 }
 
+type ToolAnnotations = {
+	// defaults to true, so only allow false
+	openWorldHint?: false
+} & (
+	| {
+			// when readOnlyHint is true, none of the other annotations can be changed
+			readOnlyHint: true
+	  }
+	| {
+			destructiveHint?: false // Only allow false (default is true)
+			idempotentHint?: true // Only allow true (default is false)
+	  }
+)
+
 function createText(text: unknown): CallToolResult['content'][number] {
 	if (typeof text === 'string') {
 		return { type: 'text', text }
diff --git a/exercises/05.changes/02.solution.resources-list-changed/package.json b/exercises/05.changes/02.solution.resources-list-changed/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/05.changes/02.solution.resources-list-changed/src/tools.ts b/exercises/05.changes/02.solution.resources-list-changed/src/tools.ts
@@ -497,6 +497,20 @@ export async function initializeTools(agent: EpicMeMCP) {
 	await updateTools()
 }
 
+type ToolAnnotations = {
+	// defaults to true, so only allow false
+	openWorldHint?: false
+} & (
+	| {
+			// when readOnlyHint is true, none of the other annotations can be changed
+			readOnlyHint: true
+	  }
+	| {
+			destructiveHint?: false // Only allow false (default is true)
+			idempotentHint?: true // Only allow true (default is false)
+	  }
+)
+
 function createText(text: unknown): CallToolResult['content'][number] {
 	if (typeof text === 'string') {
 		return { type: 'text', text }
diff --git a/exercises/05.changes/03.problem.subscriptions/package.json b/exercises/05.changes/03.problem.subscriptions/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/05.changes/03.problem.subscriptions/src/tools.ts b/exercises/05.changes/03.problem.subscriptions/src/tools.ts
@@ -497,6 +497,20 @@ export async function initializeTools(agent: EpicMeMCP) {
 	await updateTools()
 }
 
+type ToolAnnotations = {
+	// defaults to true, so only allow false
+	openWorldHint?: false
+} & (
+	| {
+			// when readOnlyHint is true, none of the other annotations can be changed
+			readOnlyHint: true
+	  }
+	| {
+			destructiveHint?: false // Only allow false (default is true)
+			idempotentHint?: true // Only allow true (default is false)
+	  }
+)
+
 function createText(text: unknown): CallToolResult['content'][number] {
 	if (typeof text === 'string') {
 		return { type: 'text', text }
diff --git a/exercises/05.changes/03.solution.subscriptions/package.json b/exercises/05.changes/03.solution.subscriptions/package.json
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@epic-web/invariant": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
diff --git a/exercises/05.changes/03.solution.subscriptions/src/tools.ts b/exercises/05.changes/03.solution.subscriptions/src/tools.ts
@@ -497,6 +497,20 @@ export async function initializeTools(agent: EpicMeMCP) {
 	await updateTools()
 }
 
+type ToolAnnotations = {
+	// defaults to true, so only allow false
+	openWorldHint?: false
+} & (
+	| {
+			// when readOnlyHint is true, none of the other annotations can be changed
+			readOnlyHint: true
+	  }
+	| {
+			destructiveHint?: false // Only allow false (default is true)
+			idempotentHint?: true // Only allow true (default is false)
+	  }
+)
+
 function createText(text: unknown): CallToolResult['content'][number] {
 	if (typeof text === 'string') {
 		return { type: 'text', text }
diff --git a/package-lock.json b/package-lock.json
