@emseepea/create-tool-server 0.0.2 → 0.0.4

package/README.md

@@ -1,22 +1,70 @@
 # `@emseepea/create-tool-server`
 
-Create a private, standalone Em See Pea project with one public, read-only
-tool. The package builds its starter from the maintained
-[first public tool example](https://github.com/emseepea/emseepea/tree/main/examples/basic-no-ui).
+This directory is both the maintained example and its public npm initializer.
 
-## Create the Project
+## Use This Template
 
-This initializer is queued for the next pre-alpha release and is not yet
-available from npm.
+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 -->
+
+## Your First Public Tool
+
+Choose this example when you want the smallest working server with one public,
+read-only tool and no web page.
+
+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
+
+- Model Context Protocol (MCP) `2026-07-28` over `POST /mcp`
+- one public, read-only tool with sample data
+- checks for tool input and output
+- local use on your computer only
+
+It does not include sign-in, saved sessions, live progress, changes to data, or
+production network setup.
+
+## Run
+
+From this directory:
+
 ```sh
-cd my-server
 npm install
-npm test
-npm run lint
+npm run build
 npm start
 ```
+
+The endpoint is `http://127.0.0.1:3000/mcp` and the health check is
+`http://127.0.0.1:3000/healthz`.
+
+## Check This Example
+
+[Ordinary tests](test/) live in `test/`.
+The [AI tool-choice and understanding test](eval/meaning.test.mjs) lives separately in `eval/`.
+The commands below run each suite independently.
+
+Run its build and MCP checks:
+
+```sh
+npm test
+```
+
+Check that Claude chooses the variety tool and understands its result:
+
+```sh
+npm run test:llm
+```
+
+If Claude is not already signed in, run `claude auth login` first.

package/{dist → 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

@@ -0,0 +1,20 @@
+import { toolSelectionTest } from "@emseepea/testing/semantic";
+
+toolSelectionTest("Pea variety details keep each concept distinct", {
+  server: new URL("../dist/server.js", import.meta.url),
+  question:
+    "For Highland Snap, give me its pea type, growth habit, days to maturity, and " +
+    "traits. Keep those concepts distinct.",
+  criticalFacts: [
+    "snap",
+    "climbing",
+    "70",
+    "edible pods",
+    "needs support"
+  ],
+  criteria:
+    "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/{dist → initializer-dist}/template/package.json

@@ -1,7 +1,7 @@
 {
   "name": "emseepea-starter",
   "version": "0.0.0",
-  "private": true,
+  "description": "Create an Em See Pea server with one public tool.",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -13,17 +13,18 @@
     "test:llm:built": "emseepea-test eval",
     "lint": "oxlint src test eval"
   },
-  "dependencies": {
-    "@emseepea/server": "0.1.0",
-    "zod": "4.4.3"
-  },
   "devDependencies": {
-    "@emseepea/testing": "0.2.1",
+    "@emseepea/testing": "0.2.2",
     "@types/node": "24.13.3",
     "typescript": "6.0.3",
     "oxlint": "1.80.0"
   },
   "engines": {
     "node": ">=22"
+  },
+  "private": true,
+  "dependencies": {
+    "@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/{dist → 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/{dist → 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,22 +1,37 @@
 {
   "name": "@emseepea/create-tool-server",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Create an Em See Pea server with one public tool.",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/emseepea/emseepea.git",
-    "directory": "packages/create-tool-server"
-  },
-  "homepage": "https://emseepea.github.io/emseepea/examples/",
-  "bugs": "https://github.com/emseepea/emseepea/issues",
-  "publishConfig": { "access": "public", "provenance": true, "tag": "next" },
   "type": "module",
-  "bin": { "create-tool-server": "./dist/create.mjs" },
-  "files": ["dist"],
+  "starterDependencies": ["@emseepea/server", "zod"],
   "scripts": {
-    "build": "node ../../scripts/build-initializer.mjs",
-    "prepack": "npm run build"
+    "build": "npm run build:example && npm run build:initializer",
+    "build:example": "tsc -p tsconfig.json",
+    "build:initializer": "node ../../scripts/build-initializer.mjs",
+    "start": "node dist/server.js",
+    "test": "npm run build && npm run test:built",
+    "test:built": "node --test test/*.test.mjs",
+    "test:llm": "npm run build && npm run test:llm:built",
+    "test:llm:built": "emseepea-test eval",
+    "lint": "oxlint src test eval",
+    "prepack": "npm run build:initializer"
+  },
+  "devDependencies": {
+    "@emseepea/server": "0.2.2",
+    "zod": "4.4.3",
+    "@emseepea/testing": "0.2.2",
+    "@types/node": "24.13.3",
+    "typescript": "6.0.3",
+    "oxlint": "1.80.0"
   },
-  "engines": { "node": ">=22" }
+  "engines": {
+    "node": ">=22"
+  },
+  "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 },
+  "bin": { "create-tool-server": "./initializer-dist/create.mjs" },
+  "files": ["initializer-dist"]
 }

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

@@ -1,21 +0,0 @@
-import { toolSelectionTest } from "@emseepea/testing/semantic";
-
-toolSelectionTest("Basic bean 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.",
-  criticalFacts: [
-    "Sample Highlands",
-    "Bourbon",
-    "natural",
-    "medium",
-    "berry",
-    "cocoa"
-  ],
-  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"],
-});

package/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;