@emseepea/create-html-ui-server 0.0.9 → 0.0.10

package/initializer-dist/template/package.json

@@ -26,7 +26,7 @@
   },
   "private": true,
   "dependencies": {
-    "@emseepea/server": "0.3.1",
+    "@emseepea/server": "0.3.2",
     "@emseepea/tailwind": "0.0.2"
   }
 }

package/initializer-dist/template/src/ui-shared.ts

@@ -1,24 +1,25 @@
 import { defineElicitationView, defineTool, type ElicitationView } from "@emseepea/server";
 import { z } from "zod";
 
-const peaTypeSchema = z.enum(["all", "shelling", "snap"]);
+const peaTypeSchema = z.enum(["all", "shelling", "snap"])
+  .describe("Pea type to include, or all pea types.");
 const inputSchema = z.strictObject({
-  title: z.string().trim().min(1).max(80),
+  title: z.string().trim().min(1).max(80).describe("Title for the planting-plan preview."),
   peaType: peaTypeSchema,
-  includeTips: z.boolean(),
+  includeTips: z.boolean().describe("Whether to include sample growing tips."),
 });
 const outputSchema = z.strictObject({
-  status: z.literal("preview-only"),
-  effectPerformed: z.literal(false),
-  title: z.string(),
-  matchingCount: z.number().int().nonnegative(),
+  status: z.literal("preview-only").describe("Confirms that this result is only a preview."),
+  effectPerformed: z.literal(false).describe("Confirms that nothing was sent, stored, or changed."),
+  title: z.string().describe("Title of the planting-plan preview."),
+  matchingCount: z.number().int().nonnegative().describe("Number of sample varieties matching the selected pea type."),
   varieties: z.array(z.strictObject({
-    name: z.string(),
-    growthHabit: z.enum(["bush", "climbing"]),
-    peaType: z.enum(["shelling", "snap"]),
-    tips: z.array(z.string()).optional(),
-  })),
-  notice: z.literal("No report was sent or stored."),
+    name: z.string().describe("Name of the sample pea variety."),
+    growthHabit: z.enum(["bush", "climbing"]).describe("Whether the variety grows as a bush or climbing vine."),
+    peaType: z.enum(["shelling", "snap"]).describe("Whether the variety is grown for shelled peas or edible pods."),
+    tips: z.array(z.string()).optional().describe("Sample growing tips when requested."),
+  })).describe("Sample pea varieties matching the selected pea type."),
+  notice: z.literal("No report was sent or stored.").describe("Reminder that the preview caused no external effect."),
 });
 
 const varieties = [

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

@@ -0,0 +1,26 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { startMcpServer } from "@emseepea/testing";
+
+test("describes every planting-plan tool property", 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), ["preview-planting-plan"]);
+  const input = listed.tools[0].inputSchema.properties;
+  const output = listed.tools[0].outputSchema.properties;
+  assert.equal(input.title.description, "Title for the planting-plan preview.");
+  assert.equal(input.peaType.description, "Pea type to include, or all pea types.");
+  assert.equal(input.includeTips.description, "Whether to include sample growing tips.");
+  assert.equal(output.status.description, "Confirms that this result is only a preview.");
+  assert.equal(output.effectPerformed.description, "Confirms that nothing was sent, stored, or changed.");
+  assert.equal(output.title.description, "Title of the planting-plan preview.");
+  assert.equal(output.matchingCount.description, "Number of sample varieties matching the selected pea type.");
+  assert.equal(output.varieties.description, "Sample pea varieties matching the selected pea type.");
+  assert.equal(output.varieties.items.properties.name.description, "Name of the sample pea variety.");
+  assert.equal(output.varieties.items.properties.growthHabit.description, "Whether the variety grows as a bush or climbing vine.");
+  assert.equal(output.varieties.items.properties.peaType.description, "Whether the variety is grown for shelled peas or edible pods.");
+  assert.equal(output.varieties.items.properties.tips.description, "Sample growing tips when requested.");
+  assert.equal(output.notice.description, "Reminder that the preview caused no external effect.");
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emseepea/create-html-ui-server",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Create an Em See Pea server with an accessible HTML form.",
   "license": "MIT",
   "type": "module",
@@ -18,7 +18,7 @@
     "prepack": "npm run build:initializer"
   },
   "devDependencies": {
-    "@emseepea/server": "0.3.1",
+    "@emseepea/server": "0.3.2",
     "@emseepea/tailwind": "0.0.2",
     "@emseepea/example-ui-shared": "0.0.0",
     "playwright": "1.62.1",