@emseepea/create-resources-and-prompts-server 0.0.1 → 0.0.3

package/README.md

@@ -1,22 +1,54 @@
 # `@emseepea/create-resources-and-prompts-server`
 
-Create a private, standalone Em See Pea project with resources and prompts.
-The package builds its starter from the maintained
-[resources and prompts example](https://github.com/emseepea/emseepea/tree/main/examples/resources-prompts).
-
-## Create the Project
-
-This initializer is queued for the next pre-alpha release and is not yet
-available from npm.
+This directory is both the maintained example and its public npm initializer.
 
 ```sh
 npm init @emseepea/resources-and-prompts-server@next -- my-server
 ```
 
+<!-- generated-project-readme -->
+
+## Resources and Prompts Example
+
+Choose this example when you want to give an assistant reusable reference
+content and guided starting questions, without adding another tool.
+
+It provides:
+
+- a fixed resource at one known address
+- a resource pattern for related content at predictable addresses
+- a reusable prompt with one checked argument
+- optional suggestions for the resource and prompt fields
+
+## Run
+
+From this directory:
+
 ```sh
-cd my-server
 npm install
-npm test
-npm run lint
+npm run build
 npm start
 ```
+
+The server listens on `http://127.0.0.1:3000/mcp` by default. Set `PORT` to
+choose another port.
+
+## Check This Example
+
+[Ordinary tests](test/) live in `test/`.
+The [AI understanding test](eval/meaning.test.mjs) lives separately in `eval/`.
+The commands below run each suite independently.
+
+Run its build and MCP resource and prompt checks:
+
+```sh
+npm test
+```
+
+Check that Claude keeps coffee strength and extraction distinct:
+
+```sh
+npm run test:llm
+```
+
+If Claude is not already signed in, run `claude auth login` first.

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 resources and prompts.",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -13,10 +13,6 @@
     "test:llm:built": "emseepea-test eval",
     "lint": "oxlint src test eval"
   },
-  "dependencies": {
-    "@emseepea/server": "0.0.4",
-    "zod": "4.4.3"
-  },
   "devDependencies": {
     "@emseepea/testing": "0.2.1",
     "@types/node": "24.13.3",
@@ -25,5 +21,10 @@
   },
   "engines": {
     "node": ">=22"
+  },
+  "private": true,
+  "dependencies": {
+    "@emseepea/server": "0.2.1",
+    "zod": "4.4.3"
   }
 }

package/initializer-dist/template/src/capabilities/prompt.brew-guide.ts

@@ -0,0 +1,24 @@
+import { definePrompt, type CapabilityModuleFactory } from "@emseepea/server";
+import { z } from "zod";
+
+const topics = ["brew-ratio", "grind-size", "water-temperature"];
+
+export default (() => definePrompt({
+  name: "brew-guide",
+  title: "Brew guide",
+  description: "Create a prompt for a sample brewing topic.",
+  argsSchema: z.object({ topic: z.string().min(1) }),
+  complete: {
+    topic: (value) => topics.filter((topic) => topic.startsWith(value)),
+  },
+  handler: ({ topic }) => ({
+    description: `Guide for ${topic}`,
+    messages: [{
+      role: "user",
+      content: {
+        type: "text",
+        text: `Explain ${topic} for a home brewer. Distinguish any commonly confused concepts.`,
+      },
+    }],
+  }),
+})) satisfies CapabilityModuleFactory;

package/initializer-dist/template/src/capabilities/resource.getting-started.ts

@@ -0,0 +1,18 @@
+import { defineResource, type CapabilityModuleFactory } from "@emseepea/server";
+
+const guideUri = "guide://coffee/getting-started";
+
+export default (() => defineResource({
+  name: "getting-started",
+  uri: guideUri,
+  title: "Coffee getting started",
+  description: "A sample guide exposed as an MCP resource.",
+  mimeType: "text/markdown",
+  handler: () => ({
+    contents: [{
+      uri: guideUri,
+      mimeType: "text/markdown",
+      text: "# Brew clearly\n\nStrength is concentration; extraction is how much material left the grounds. They are related, but not interchangeable.\n",
+    }],
+  }),
+})) satisfies CapabilityModuleFactory;

package/initializer-dist/template/src/capabilities/resource.method-guide.ts

@@ -0,0 +1,21 @@
+import { defineResourceTemplate, type CapabilityModuleFactory } from "@emseepea/server";
+
+const methods = ["aeropress", "espresso", "pour-over"];
+
+export default (() => defineResourceTemplate({
+  name: "method-guide",
+  uriTemplate: "guide://coffee/method/{method}",
+  title: "Coffee method guide",
+  description: "A sample guide selected by brewing method.",
+  mimeType: "text/markdown",
+  complete: {
+    method: (value) => methods.filter((method) => method.startsWith(value)),
+  },
+  handler: ({ uri, variables }) => ({
+    contents: [{
+      uri,
+      mimeType: "text/markdown",
+      text: `# ${String(variables.method)}\n`,
+    }],
+  }),
+})) satisfies CapabilityModuleFactory;

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

@@ -0,0 +1,21 @@
+import {
+  createEmseepea,
+  discoverCapabilities,
+  serveEmseepea,
+} from "@emseepea/server";
+
+const running = await serveEmseepea(createEmseepea({
+  name: "emseepea-resources-prompts",
+  version: "0.0.0",
+  ...await discoverCapabilities(new URL("./capabilities/", import.meta.url)),
+}), { port: Number.parseInt(process.env.PORT ?? "3000", 10) });
+
+console.log(`Em See Pea resources and prompts example listening at ${running.url}`);
+
+async function shutdown(): Promise<void> {
+  await running.close();
+  process.exitCode = 0;
+}
+
+process.once("SIGINT", () => void shutdown());
+process.once("SIGTERM", () => void shutdown());

package/package.json

@@ -1,22 +1,37 @@
 {
   "name": "@emseepea/create-resources-and-prompts-server",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Create an Em See Pea server with resources and prompts.",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/emseepea/emseepea.git",
-    "directory": "packages/create-resources-and-prompts-server"
+  "type": "module",
+  "starterDependencies": ["@emseepea/server", "zod"],
+  "scripts": {
+    "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.1",
+    "zod": "4.4.3",
+    "@emseepea/testing": "0.2.1",
+    "@types/node": "24.13.3",
+    "typescript": "6.0.3",
+    "oxlint": "1.80.0"
+  },
+  "engines": {
+    "node": ">=22"
   },
+  "repository": { "type": "git", "url": "git+https://github.com/emseepea/emseepea.git", "directory": "examples/resources-prompts" },
   "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-resources-and-prompts-server": "./dist/create.mjs" },
-  "files": ["dist"],
-  "scripts": {
-    "build": "node ../../scripts/build-initializer.mjs",
-    "prepack": "npm run build"
-  },
-  "engines": { "node": ">=22" }
+  "bin": { "create-resources-and-prompts-server": "./initializer-dist/create.mjs" },
+  "files": ["initializer-dist"]
 }

package/dist/template/src/server.ts

@@ -1,82 +0,0 @@
-import {
-  createEmseepea,
-  definePrompt,
-  defineResource,
-  defineResourceTemplate,
-  serveEmseepea,
-} from "@emseepea/server";
-import { z } from "zod";
-
-const guideUri = "guide://coffee/getting-started";
-const methods = ["aeropress", "espresso", "pour-over"];
-const topics = ["brew-ratio", "grind-size", "water-temperature"];
-
-const guide = defineResource({
-  name: "getting-started",
-  uri: guideUri,
-  title: "Coffee getting started",
-  description: "A sample guide exposed as an MCP resource.",
-  mimeType: "text/markdown",
-  handler: () => ({
-    contents: [{
-      uri: guideUri,
-      mimeType: "text/markdown",
-      text: "# Brew clearly\n\nStrength is concentration; extraction is how much material left the grounds. They are related, but not interchangeable.\n",
-    }],
-  }),
-});
-
-const methodGuide = defineResourceTemplate({
-  name: "method-guide",
-  uriTemplate: "guide://coffee/method/{method}",
-  title: "Coffee method guide",
-  description: "A sample guide selected by brewing method.",
-  mimeType: "text/markdown",
-  complete: {
-    method: (value) => methods.filter((method) => method.startsWith(value)),
-  },
-  handler: ({ uri, variables }) => ({
-    contents: [{
-      uri,
-      mimeType: "text/markdown",
-      text: `# ${String(variables.method)}\n`,
-    }],
-  }),
-});
-
-const brew = definePrompt({
-  name: "brew-guide",
-  title: "Brew guide",
-  description: "Create a prompt for a sample brewing topic.",
-  argsSchema: z.object({ topic: z.string().min(1) }),
-  complete: {
-    topic: (value) => topics.filter((topic) => topic.startsWith(value)),
-  },
-  handler: ({ topic }) => ({
-    description: `Guide for ${topic}`,
-    messages: [{
-      role: "user",
-      content: {
-        type: "text",
-        text: `Explain ${topic} for a home brewer. Distinguish any commonly confused concepts.`,
-      },
-    }],
-  }),
-});
-
-const running = await serveEmseepea(createEmseepea({
-  name: "emseepea-resources-prompts",
-  version: "0.0.0",
-  resources: [guide, methodGuide],
-  prompts: [brew],
-}), { port: Number.parseInt(process.env.PORT ?? "3000", 10) });
-
-console.log(`Em See Pea resources and prompts example listening at ${running.url}`);
-
-async function shutdown(): Promise<void> {
-  await running.close();
-  process.exitCode = 0;
-}
-
-process.once("SIGINT", () => void shutdown());
-process.once("SIGTERM", () => void shutdown());