@emseepea/create-api-backed-server 0.0.8 → 0.0.10

package/initializer-dist/template/package.json

@@ -25,7 +25,7 @@
   },
   "private": true,
   "dependencies": {
-    "@emseepea/server": "0.3.1",
+    "@emseepea/server": "0.3.3",
     "zod": "4.4.3"
   }
 }

package/initializer-dist/template/src/capabilities/tool.search-pea-taxa.ts

@@ -5,21 +5,25 @@ import { z } from "zod";
 export interface BackendExampleContext { readonly client: JsonHttpClient }
 
 const backendTaxon = z.object({
-  id: z.number().int().positive(),
-  name: z.string().min(1).max(200),
-  preferred_common_name: z.string().min(1).max(200).nullable().optional(),
-  rank: z.string().min(1).max(40),
-  observations_count: z.number().int().nonnegative(),
+  id: z.number().int().positive().describe("iNaturalist identifier for the taxon."),
+  name: z.string().min(1).max(200).describe("Scientific name of the taxon."),
+  preferred_common_name: z.string().min(1).max(200).nullable().optional()
+    .describe("Preferred common name when iNaturalist provides one."),
+  rank: z.string().min(1).max(40).describe("Taxonomic rank reported by iNaturalist."),
+  observations_count: z.number().int().nonnegative()
+    .describe("Recorded iNaturalist observations, not an estimate of the wild population."),
+});
+const inputSchema = z.object({
+  query: z.string().trim().min(2).max(80).describe("Pea name or other taxon search terms."),
 });
-const inputSchema = z.object({ query: z.string().trim().min(2).max(80) });
 const backendPayload = z.object({
-  total_results: z.number().int().nonnegative(),
-  results: z.array(backendTaxon).max(5),
+  total_results: z.number().int().nonnegative().describe("Total matching taxa reported by iNaturalist."),
+  results: z.array(backendTaxon).max(5).describe("Up to five matching taxa."),
 });
 const outputSchema = backendPayload.extend({
-  query: z.string().max(80),
-  source: z.literal("iNaturalist"),
-  source_url: z.literal("https://www.inaturalist.org"),
+  query: z.string().max(80).describe("Trimmed search terms sent to iNaturalist."),
+  source: z.literal("iNaturalist").describe("Data provider for these results."),
+  source_url: z.literal("https://www.inaturalist.org").describe("Website of the data provider."),
 });
 const backendInputSchema = z.object({
   pathname: z.literal("/v1/taxa"),
@@ -53,20 +57,6 @@ export default (({ client }) => defineMappedTool({
       source: "iNaturalist" as const,
       source_url: "https://www.inaturalist.org" as const,
     };
-    const lines = data.results.map((record) => [
-      record.preferred_common_name ?? "Common name not provided",
-      record.name,
-      `rank: ${record.rank}`,
-      `recorded observations: ${record.observations_count}`,
-    ].join("; "));
-    return {
-      text: [
-        `iNaturalist returned ${data.results.length} of ${data.total_results} matching taxa for “${data.query}”.`,
-        "observations_count is the number of recorded observations, not a population estimate.",
-        ...lines,
-        "Source: https://www.inaturalist.org",
-      ].join("\n"),
-      data,
-    };
+    return { data };
   },
 })) satisfies CapabilityModuleFactory<BackendExampleContext>;

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

@@ -25,6 +25,19 @@ test("the API-backed example checks and passes through selected iNaturalist valu
   try {
     const listed = await client.listTools();
     assert.deepEqual(listed.tools.map(({ name }) => name), ["search-pea-taxa"]);
+    const tool = listed.tools[0];
+    assert.equal(tool.inputSchema.properties.query.description, "Pea name or other taxon search terms.");
+    assert.equal(tool.outputSchema.properties.total_results.description, "Total matching taxa reported by iNaturalist.");
+    assert.equal(tool.outputSchema.properties.results.description, "Up to five matching taxa.");
+    const taxon = tool.outputSchema.properties.results.items.properties;
+    assert.equal(taxon.id.description, "iNaturalist identifier for the taxon.");
+    assert.equal(taxon.name.description, "Scientific name of the taxon.");
+    assert.equal(taxon.preferred_common_name.description, "Preferred common name when iNaturalist provides one.");
+    assert.equal(taxon.rank.description, "Taxonomic rank reported by iNaturalist.");
+    assert.equal(taxon.observations_count.description, "Recorded iNaturalist observations, not an estimate of the wild population.");
+    assert.equal(tool.outputSchema.properties.query.description, "Trimmed search terms sent to iNaturalist.");
+    assert.equal(tool.outputSchema.properties.source.description, "Data provider for these results.");
+    assert.equal(tool.outputSchema.properties.source_url.description, "Website of the data provider.");
 
     const invalidInput = await client.callTool({
       name: "search-pea-taxa",
@@ -44,7 +57,7 @@ test("the API-backed example checks and passes through selected iNaturalist valu
       source: "iNaturalist",
       source_url: "https://www.inaturalist.org",
     });
-    assert.match(result.content[0].text, /not a population estimate/);
+    assert.equal(result.content[0].text, JSON.stringify(result.structuredContent));
     assert.equal(requests[0].pathname, "/v1/taxa");
     assert.deepEqual(requests[0].searchParams, {
       q: "pea",
@@ -78,6 +91,7 @@ test("the API-backed example checks and passes through selected iNaturalist valu
       observations_count: 0,
     });
     assert.equal("private_note" in newProviderValue.structuredContent.results[0], false);
+    assert.equal(newProviderValue.content[0].text, JSON.stringify(newProviderValue.structuredContent));
 
     response = { total_results: 1, results: [{ id: "bad provider row" }] };
     const invalidProviderData = await client.callTool({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emseepea/create-api-backed-server",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Create an Em See Pea server backed by a public web API.",
   "license": "MIT",
   "type": "module",
@@ -18,7 +18,7 @@
     "prepack": "npm run build:initializer"
   },
   "devDependencies": {
-    "@emseepea/server": "0.3.1",
+    "@emseepea/server": "0.3.3",
     "zod": "4.4.3",
     "@emseepea/testing": "0.3.0",
     "@modelcontextprotocol/client": "2.0.0",