@emseepea/create-resources-and-prompts-server 0.0.0

package/README.md

@@ -0,0 +1,22 @@
+# `@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.
+
+```sh
+npm init @emseepea/resources-and-prompts-server@next -- my-server
+```
+
+```sh
+cd my-server
+npm install
+npm test
+npm run lint
+npm start
+```

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Windy Road Technology Pty. Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/create.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+import { cp, mkdir, mkdtemp, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+
+const [destination, ...extra] = process.argv.slice(2);
+if (extra.length > 0 || !destination || !/^[a-z0-9][a-z0-9._-]*$/.test(destination)) {
+  throw new Error("Provide one simple lowercase destination name, such as my-server");
+}
+
+const target = resolve(destination);
+if (basename(target) !== destination) throw new Error("The destination must not contain a path");
+const staging = await mkdtemp(join(dirname(target), ".emseepea-create-"));
+
+try {
+  await copyContents(new URL("./template/", import.meta.url), staging);
+  const manifestPath = resolve(staging, "package.json");
+  const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+  await writeFile(manifestPath, `${JSON.stringify({ ...manifest, name: destination }, null, 2)}\n`);
+  await mkdir(target);
+  try {
+    await copyContents(staging, target);
+  } catch (error) {
+    await rm(target, { recursive: true, force: true });
+    throw error;
+  }
+} catch (error) {
+  if (["EEXIST", "ENOTEMPTY"].includes(error.code)) {
+    throw new Error(`The destination already exists: ${destination}`);
+  }
+  throw error;
+} finally {
+  await rm(staging, { recursive: true, force: true });
+}
+
+async function copyContents(source, destination) {
+  for (const entry of await readdir(source)) {
+    const from = source instanceof URL ? new URL(entry, source) : join(source, entry);
+    await cp(from, join(destination, entry), { recursive: true, errorOnExist: true, force: false });
+  }
+}
+
+console.log(`Created ${destination}.`);
+console.log(`Next: cd ${destination}; npm install; npm test; npm start`);

package/dist/template/README.md

@@ -0,0 +1,44 @@
+# 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
+npm install
+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/template/eval/meaning.test.mjs

@@ -0,0 +1,25 @@
+import assert from "node:assert/strict";
+import { semanticTest } from "@emseepea/testing/semantic";
+
+semanticTest("Strength and extraction remain separate concepts", {
+  server: new URL("../dist/server.js", import.meta.url),
+  question:
+    "Does making coffee stronger necessarily mean that extraction is higher? " +
+    "Explain the distinction for a home brewer.",
+  criticalFacts: [
+    "concentration",
+    "extraction"
+  ],
+  criteria:
+    "The answer says stronger coffee does not necessarily mean higher extraction. " +
+    "It explains that strength is concentration while extraction is how much " +
+    "material left the grounds, and it does not describe the concepts as " +
+    "interchangeable.",
+  requiredPaths: ["resources/read:guide://coffee/getting-started","prompts/get:brew-guide"],
+  async exercise(client) {
+    const result1 = await client.readResource({"uri":"guide://coffee/getting-started"});
+    assert.ok(result1);
+    const result2 = await client.getPrompt({"name":"brew-guide","arguments":{"topic":"brew-ratio"}});
+    assert.ok(result2);
+  },
+});

package/dist/template/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "emseepea-starter",
+  "version": "0.0.0",
+  "private": true,
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "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"
+  },
+  "dependencies": {
+    "@emseepea/server": "0.0.4",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@emseepea/testing": "0.2.1",
+    "@types/node": "24.13.3",
+    "typescript": "6.0.3",
+    "oxlint": "1.80.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/dist/template/src/server.ts

@@ -0,0 +1,82 @@
+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());

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

@@ -0,0 +1,23 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { startMcpServer } from "@emseepea/testing";
+
+test("lists and reads the advertised resource and prompt", async (t) => {
+  const running = await startMcpServer(t, new URL("../dist/server.js", import.meta.url));
+  const client = await running.connect();
+
+  assert.deepEqual((await client.listResources()).resources.map(({ uri }) => uri), [
+    "guide://coffee/getting-started",
+  ]);
+  const resource = await client.readResource({ uri: "guide://coffee/getting-started" });
+  assert.match(resource.contents[0].text, /Strength is concentration/);
+  assert.match(resource.contents[0].text, /extraction is how much material left the grounds/);
+
+  assert.deepEqual((await client.listPrompts()).prompts.map(({ name }) => name), ["brew-guide"]);
+  const prompt = await client.getPrompt({
+    name: "brew-guide",
+    arguments: { topic: "brew-ratio" },
+  });
+  assert.match(prompt.messages[0].content.text, /Explain brew-ratio/);
+});

package/dist/template/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "target": "ES2023",
+    "types": ["node"],
+    "verbatimModuleSyntax": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@emseepea/create-resources-and-prompts-server",
+  "version": "0.0.0",
+  "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"
+  },
+  "homepage": "https://emseepea.github.io/emseepea/examples/",
+  "bugs": "https://github.com/emseepea/emseepea/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": false,
+    "tag": "next"
+  },
+  "type": "module",
+  "bin": {
+    "create-resources-and-prompts-server": "./dist/create.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  }
+}