@emseepea/create-tool-server 0.0.3 → 0.0.4

package/README.md

@@ -2,8 +2,17 @@
 
 This directory is both the maintained example and its public npm initializer.
 
+## Use This Template
+
+Use this template for the smallest server with one public, read-only tool and
+no external service, sign-in, web page, progress stream, or shared storage.
+Choose the [API-backed server](../api-backed-server/README.md) when the tool
+must call a public web service. [Compare all eight templates](https://emseepea.github.io/emseepea/examples/).
+
+## Create a Project
+
 ```sh
-npm init @emseepea/tool-server@next -- my-server
+npm init @emseepea/tool-server -- my-server
 ```
 
 <!-- generated-project-readme -->
@@ -13,8 +22,8 @@ npm init @emseepea/tool-server@next -- my-server
 Choose this example when you want the smallest working server with one public,
 read-only tool and no web page.
 
-The `get-bean-details` tool returns useful details about one sample coffee. Em
-See Pea checks the question and result before returning them through the public
+The `get-pea-variety` tool returns useful details about one sample pea variety. Em
+See Pea checks the input and result before returning them through the public
 `@emseepea/server` API.
 
 ## What This Example Includes
@@ -52,7 +61,7 @@ Run its build and MCP checks:
 npm test
 ```
 
-Check that Claude chooses the details tool and understands its result:
+Check that Claude chooses the variety tool and understands its result:
 
 ```sh
 npm run test:llm

package/initializer-dist/template/README.md

@@ -3,8 +3,8 @@
 Choose this example when you want the smallest working server with one public,
 read-only tool and no web page.
 
-The `get-bean-details` tool returns useful details about one sample coffee. Em
-See Pea checks the question and result before returning them through the public
+The `get-pea-variety` tool returns useful details about one sample pea variety. Em
+See Pea checks the input and result before returning them through the public
 `@emseepea/server` API.
 
 ## What This Example Includes
@@ -42,7 +42,7 @@ Run its build and MCP checks:
 npm test
 ```
 
-Check that Claude chooses the details tool and understands its result:
+Check that Claude chooses the variety tool and understands its result:
 
 ```sh
 npm run test:llm

package/initializer-dist/template/eval/meaning.test.mjs

@@ -1,21 +1,20 @@
 import { toolSelectionTest } from "@emseepea/testing/semantic";
 
-toolSelectionTest("Basic bean details keep each concept distinct", {
+toolSelectionTest("Pea variety details keep each concept distinct", {
   server: new URL("../dist/server.js", import.meta.url),
   question:
-    "For Highland Bloom, give me its origin, variety, processing method, roast, and " +
-    "tasting notes. Keep those concepts distinct.",
+    "For Highland Snap, give me its pea type, growth habit, days to maturity, and " +
+    "traits. Keep those concepts distinct.",
   criticalFacts: [
-    "Sample Highlands",
-    "Bourbon",
-    "natural",
-    "medium",
-    "berry",
-    "cocoa"
+    "snap",
+    "climbing",
+    "70",
+    "edible pods",
+    "needs support"
   ],
   criteria:
-    "The answer says Highland Bloom is a medium-roast, naturally processed Bourbon " +
-    "from Sample Highlands with berry and cocoa tasting notes. It does not confuse " +
-    "origin, variety, process, roast, or tasting notes.",
-  expectedTools: ["get-bean-details"],
+    "The answer says Highland Snap is a snap pea with a climbing growth habit, " +
+    "matures in 70 days, has edible pods, and needs support. It does not confuse " +
+    "pea type, growth habit, maturity time, or traits.",
+  expectedTools: ["get-pea-variety"],
 });

package/initializer-dist/template/package.json

@@ -14,7 +14,7 @@
     "lint": "oxlint src test eval"
   },
   "devDependencies": {
-    "@emseepea/testing": "0.2.1",
+    "@emseepea/testing": "0.2.2",
     "@types/node": "24.13.3",
     "typescript": "6.0.3",
     "oxlint": "1.80.0"
@@ -24,7 +24,7 @@
   },
   "private": true,
   "dependencies": {
-    "@emseepea/server": "0.2.1",
+    "@emseepea/server": "0.2.2",
     "zod": "4.4.3"
   }
 }

package/initializer-dist/template/src/capabilities/tool.get-pea-variety.ts

@@ -0,0 +1,44 @@
+import { defineTool, type CapabilityModuleFactory } from "@emseepea/server";
+import { z } from "zod";
+
+const varietyNames = ["Harbour Gem", "Highland Snap"] as const;
+const peaVarietySchema = z.object({
+  name: z.enum(varietyNames),
+  peaType: z.enum(["shelling", "snap"]),
+  growthHabit: z.enum(["bush", "climbing"]),
+  daysToMaturity: z.number().int().positive(),
+  traits: z.array(z.string()),
+});
+const varieties: Record<(typeof varietyNames)[number], z.input<typeof peaVarietySchema>> = {
+  "Harbour Gem": {
+    name: "Harbour Gem",
+    peaType: "shelling",
+    growthHabit: "bush",
+    daysToMaturity: 62,
+    traits: ["compact", "sweet peas"],
+  },
+  "Highland Snap": {
+    name: "Highland Snap",
+    peaType: "snap",
+    growthHabit: "climbing",
+    daysToMaturity: 70,
+    traits: ["edible pods", "needs support"],
+  },
+};
+
+export default (() => defineTool({
+  name: "get-pea-variety",
+  access: "public",
+  title: "Pea Variety Details",
+  description: "Get the type, growth habit, maturity time, and traits of a sample pea variety.",
+  inputSchema: z.object({ name: z.enum(varietyNames) }),
+  outputSchema: peaVarietySchema,
+  handler: ({ name }) => {
+    const data = varieties[name];
+    return {
+      text: `${data.name} is a ${data.peaType} pea with a ${data.growthHabit} habit. ` +
+        `It matures in ${data.daysToMaturity} days and is known for ${data.traits.join(" and ")}.`,
+      data,
+    };
+  },
+})) satisfies CapabilityModuleFactory;

package/initializer-dist/template/src/server.ts

@@ -1,9 +1,9 @@
 import { createEmseepea, discoverCapabilities, serveEmseepea } from "@emseepea/server";
 
 const handler = createEmseepea({
-  name: "emseepea-basic-no-ui",
+  name: "emseepea-tool-server",
   version: "0.0.0",
-  instructions: "Use get-bean-details for information about a sample coffee bean.",
+  instructions: "Use get-pea-variety for information about a sample pea variety.",
   ...await discoverCapabilities(new URL("./capabilities/", import.meta.url)),
 });
 

package/initializer-dist/template/test/server.test.mjs

@@ -3,24 +3,23 @@ import test from "node:test";
 
 import { startMcpServer } from "@emseepea/testing";
 
-test("advertises and returns understandable bean details", async (t) => {
+test("advertises and returns understandable pea variety details", async (t) => {
   const running = await startMcpServer(t, new URL("../dist/server.js", import.meta.url));
   const client = await running.connect();
 
   const listed = await client.listTools();
-  assert.deepEqual(listed.tools.map(({ name }) => name), ["get-bean-details"]);
+  assert.deepEqual(listed.tools.map(({ name }) => name), ["get-pea-variety"]);
 
   const result = await client.callTool({
-    name: "get-bean-details",
-    arguments: { name: "Highland Bloom" },
+    name: "get-pea-variety",
+    arguments: { name: "Highland Snap" },
   });
   assert.equal(result.isError, false);
   assert.deepEqual(result.structuredContent, {
-    name: "Highland Bloom",
-    origin: "Sample Highlands",
-    variety: "Bourbon",
-    process: "natural",
-    roast: "medium",
-    tastingNotes: ["berry", "cocoa"],
+    name: "Highland Snap",
+    peaType: "snap",
+    growthHabit: "climbing",
+    daysToMaturity: 70,
+    traits: ["edible pods", "needs support"],
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emseepea/create-tool-server",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Create an Em See Pea server with one public tool.",
   "license": "MIT",
   "type": "module",
@@ -18,9 +18,9 @@
     "prepack": "npm run build:initializer"
   },
   "devDependencies": {
-    "@emseepea/server": "0.2.1",
+    "@emseepea/server": "0.2.2",
     "zod": "4.4.3",
-    "@emseepea/testing": "0.2.1",
+    "@emseepea/testing": "0.2.2",
     "@types/node": "24.13.3",
     "typescript": "6.0.3",
     "oxlint": "1.80.0"
@@ -28,10 +28,10 @@
   "engines": {
     "node": ">=22"
   },
-  "repository": { "type": "git", "url": "git+https://github.com/emseepea/emseepea.git", "directory": "examples/basic-no-ui" },
+  "repository": { "type": "git", "url": "git+https://github.com/emseepea/emseepea.git", "directory": "examples/tool-server" },
   "homepage": "https://emseepea.github.io/emseepea/examples/",
   "bugs": "https://github.com/emseepea/emseepea/issues",
-  "publishConfig": { "access": "public", "provenance": true, "tag": "next" },
+  "publishConfig": { "access": "public", "provenance": true },
   "bin": { "create-tool-server": "./initializer-dist/create.mjs" },
   "files": ["initializer-dist"]
 }

package/initializer-dist/template/src/capabilities/tool.get-bean-details.ts

@@ -1,47 +0,0 @@
-import { defineTool, type CapabilityModuleFactory } from "@emseepea/server";
-import { z } from "zod";
-
-const beanNames = ["Harbour Dawn", "Highland Bloom"] as const;
-const beanDetailsSchema = z.object({
-  name: z.enum(beanNames),
-  origin: z.string(),
-  variety: z.string(),
-  process: z.string(),
-  roast: z.enum(["light", "medium", "dark"]),
-  tastingNotes: z.array(z.string()),
-});
-const beans: Record<(typeof beanNames)[number], z.input<typeof beanDetailsSchema>> = {
-  "Harbour Dawn": {
-    name: "Harbour Dawn",
-    origin: "Sample Coast",
-    variety: "Caturra",
-    process: "washed",
-    roast: "light",
-    tastingNotes: ["citrus", "honey"],
-  },
-  "Highland Bloom": {
-    name: "Highland Bloom",
-    origin: "Sample Highlands",
-    variety: "Bourbon",
-    process: "natural",
-    roast: "medium",
-    tastingNotes: ["berry", "cocoa"],
-  },
-};
-
-export default (() => defineTool({
-  name: "get-bean-details",
-  access: "public",
-  title: "Coffee Bean Details",
-  description: "Get origin, processing, roast, and tasting details for a sample coffee bean.",
-  inputSchema: z.object({ name: z.enum(beanNames) }),
-  outputSchema: beanDetailsSchema,
-  handler: ({ name }) => {
-    const data = beans[name];
-    return {
-      text: `${data.name} is a ${data.roast} ${data.process} ${data.variety} from ` +
-        `${data.origin}, with notes of ${data.tastingNotes.join(" and ")}.`,
-      data,
-    };
-  },
-})) satisfies CapabilityModuleFactory;