@emseepea/create-api-backed-server 0.0.0 → 0.0.2

package/dist/template/package.json

@@ -14,7 +14,7 @@
     "lint": "oxlint src test eval test-support"
   },
   "dependencies": {
-    "@emseepea/server": "0.0.4",
+    "@emseepea/server": "0.1.0",
     "zod": "4.4.3"
   },
   "devDependencies": {

package/dist/template/src/app.ts

@@ -1,157 +1,11 @@
-import { createEmseepea, defineMappedTool } from "@emseepea/server";
+import { createEmseepea, discoverCapabilities } from "@emseepea/server";
 import type { JsonHttpClient } from "@emseepea/server/http";
-import { z } from "zod";
-
-const publicRoast = z.enum(["light", "medium-light", "medium", "medium-dark", "dark"]);
-const brewmarkRoast = z.enum(["LIGHT", "MEDIUM_LIGHT", "MEDIUM", "MEDIUM_DARK", "DARK"]);
-const publicToBrewmarkRoast = {
-  light: "LIGHT",
-  "medium-light": "MEDIUM_LIGHT",
-  medium: "MEDIUM",
-  "medium-dark": "MEDIUM_DARK",
-  dark: "DARK",
-} as const;
-const brewmarkToPublicRoast = {
-  LIGHT: "light",
-  MEDIUM_LIGHT: "medium-light",
-  MEDIUM: "medium",
-  MEDIUM_DARK: "medium-dark",
-  DARK: "dark",
-} as const;
-
-const searchInput = z.object({
-  query: z.string().trim().min(2).max(80),
-  roast: publicRoast.optional(),
-});
-const coffee = z.object({
-  name: z.string().max(200),
-  roaster: z.string().max(200),
-  origin: z.string().max(200).nullable(),
-  roast: publicRoast,
-  processingMethod: z.string().max(100).nullable(),
-  flavourNotes: z.string().max(500).nullable(),
-  acidityLevel: z.number().int().min(1).max(5).nullable(),
-  bodyLevel: z.number().int().min(1).max(5).nullable(),
-});
-const searchReport = z.object({
-  query: z.string().max(80),
-  roastFilter: publicRoast.nullable(),
-  returnedCount: z.number().int().min(0).max(5),
-  moreMatchesAvailable: z.boolean(),
-  ratingScale: z.object({
-    acidity: z.literal("1 = low acidity; 5 = high acidity"),
-    body: z.literal("1 = light body; 5 = full body"),
-  }),
-  coffees: z.array(coffee).max(5),
-  source: z.literal("BrewMark"),
-  sourceUrl: z.literal("https://brewmark.io"),
-});
-
-const backendCommand = z.object({
-  pathname: z.literal("/api/coffees"),
-  searchParams: z.object({
-    q: z.string().min(2).max(80),
-    roastLevel: brewmarkRoast.optional(),
-    sort: z.literal("alpha"),
-    limit: z.literal("5"),
-  }),
-});
-const backendCoffee = z.object({
-  name: z.string().max(200),
-  roasterName: z.string().max(200),
-  roastLevel: brewmarkRoast,
-  origin: z.string().max(200).nullable(),
-  processingMethod: z.string().max(100).nullable(),
-  flavorProfile: z.string().max(500).nullable(),
-  acidityLevel: z.number().int().min(1).max(5).nullable(),
-  bodyLevel: z.number().int().min(1).max(5).nullable(),
-});
-const backendPayload = z.object({
-  data: z.array(backendCoffee).max(5),
-  cursor: z.string().max(2_048).nullable(),
-  hasMore: z.boolean(),
-});
-const backendResult = z.object({
-  request: backendCommand,
-  payload: backendPayload,
-});
-
-export function createBackendExample(client: JsonHttpClient): ReturnType<typeof createEmseepea> {
-  const searchCoffeeCatalog = defineMappedTool({
-    name: "search-coffee-catalog",
-    access: "public",
-    description: "Search BrewMark's public coffee catalogue and explain its acidity and body ratings.",
-    inputSchema: searchInput,
-    outputSchema: searchReport,
-    backendInputSchema: backendCommand,
-    backendOutputSchema: backendResult,
-    mapInput: ({ query, roast }) => ({
-      pathname: "/api/coffees" as const,
-      searchParams: {
-        q: query,
-        ...(roast ? { roastLevel: publicToBrewmarkRoast[roast] } : {}),
-        sort: "alpha" as const,
-        limit: "5" as const,
-      },
-    }),
-    async adapter(request, { signal, deadlineMs }) {
-      return {
-        request,
-        payload: await client.get({ ...request, signal, deadlineMs }),
-      };
-    },
-    mapOutput: ({ request, payload }) => {
-      const coffees = payload.data.map((record) => ({
-        name: record.name,
-        roaster: record.roasterName,
-        origin: record.origin,
-        roast: brewmarkToPublicRoast[record.roastLevel],
-        processingMethod: record.processingMethod,
-        flavourNotes: record.flavorProfile,
-        acidityLevel: record.acidityLevel,
-        bodyLevel: record.bodyLevel,
-      }));
-      const roastFilter = request.searchParams.roastLevel
-        ? brewmarkToPublicRoast[request.searchParams.roastLevel]
-        : null;
-      const data = {
-        query: request.searchParams.q,
-        roastFilter,
-        returnedCount: coffees.length,
-        moreMatchesAvailable: payload.hasMore,
-        ratingScale: {
-          acidity: "1 = low acidity; 5 = high acidity" as const,
-          body: "1 = light body; 5 = full body" as const,
-        },
-        coffees,
-        source: "BrewMark" as const,
-        sourceUrl: "https://brewmark.io" as const,
-      };
-      const lines = coffees.map((record) => [
-        `${record.name} by ${record.roaster}`,
-        `origin: ${record.origin ?? "not provided"}`,
-        `roast: ${record.roast}`,
-        `acidity: ${record.acidityLevel ?? "not provided"}`,
-        `body: ${record.bodyLevel ?? "not provided"}`,
-      ].join("; "));
-      return {
-        text: [
-          `BrewMark returned ${coffees.length} coffee${coffees.length === 1 ? "" : "s"} for “${data.query}”.`,
-          `More matches available: ${data.moreMatchesAvailable ? "yes" : "no"}.`,
-          "Acidity: 1 = low acidity; 5 = high acidity.",
-          "Body: 1 = light body; 5 = full body.",
-          ...lines,
-          "Source: https://brewmark.io",
-        ].join("\n"),
-        data,
-      };
-    },
-  });
 
+export async function createBackendExample(client: JsonHttpClient): Promise<ReturnType<typeof createEmseepea>> {
   return createEmseepea({
     name: "emseepea-backend-no-ui",
     version: "0.0.0",
     instructions: "Use search-coffee-catalog to search BrewMark's public coffee catalogue.",
-    tools: [searchCoffeeCatalog],
+    ...await discoverCapabilities(new URL("./capabilities/", import.meta.url), { client }),
   });
 }

package/dist/template/src/capabilities/tool.search-coffee-catalog.ts

@@ -0,0 +1,112 @@
+import { defineMappedTool, type CapabilityModuleFactory } from "@emseepea/server";
+import type { JsonHttpClient } from "@emseepea/server/http";
+import { z } from "zod";
+
+export interface BackendExampleContext { readonly client: JsonHttpClient }
+
+const publicRoast = z.enum(["light", "medium-light", "medium", "medium-dark", "dark"]);
+const brewmarkRoast = z.enum(["LIGHT", "MEDIUM_LIGHT", "MEDIUM", "MEDIUM_DARK", "DARK"]);
+const publicToBrewmarkRoast = {
+  light: "LIGHT", "medium-light": "MEDIUM_LIGHT", medium: "MEDIUM",
+  "medium-dark": "MEDIUM_DARK", dark: "DARK",
+} as const;
+const brewmarkToPublicRoast = {
+  LIGHT: "light", MEDIUM_LIGHT: "medium-light", MEDIUM: "medium",
+  MEDIUM_DARK: "medium-dark", DARK: "dark",
+} as const;
+const searchInput = z.object({ query: z.string().trim().min(2).max(80), roast: publicRoast.optional() });
+const coffee = z.object({
+  name: z.string().max(200), roaster: z.string().max(200), origin: z.string().max(200).nullable(),
+  roast: publicRoast, processingMethod: z.string().max(100).nullable(),
+  flavourNotes: z.string().max(500).nullable(), acidityLevel: z.number().int().min(1).max(5).nullable(),
+  bodyLevel: z.number().int().min(1).max(5).nullable(),
+});
+const searchReport = z.object({
+  query: z.string().max(80), roastFilter: publicRoast.nullable(), returnedCount: z.number().int().min(0).max(5),
+  moreMatchesAvailable: z.boolean(),
+  ratingScale: z.object({
+    acidity: z.literal("1 = low acidity; 5 = high acidity"),
+    body: z.literal("1 = light body; 5 = full body"),
+  }),
+  coffees: z.array(coffee).max(5), source: z.literal("BrewMark"), sourceUrl: z.literal("https://brewmark.io"),
+});
+const backendCommand = z.object({
+  pathname: z.literal("/api/coffees"),
+  searchParams: z.object({
+    q: z.string().min(2).max(80), roastLevel: brewmarkRoast.optional(),
+    sort: z.literal("alpha"), limit: z.literal("5"),
+  }),
+});
+const backendCoffee = z.object({
+  name: z.string().max(200), roasterName: z.string().max(200), roastLevel: brewmarkRoast,
+  origin: z.string().max(200).nullable(), processingMethod: z.string().max(100).nullable(),
+  flavorProfile: z.string().max(500).nullable(), acidityLevel: z.number().int().min(1).max(5).nullable(),
+  bodyLevel: z.number().int().min(1).max(5).nullable(),
+});
+const backendPayload = z.object({
+  data: z.array(backendCoffee).max(5), cursor: z.string().max(2_048).nullable(), hasMore: z.boolean(),
+});
+const backendResult = z.object({ request: backendCommand, payload: backendPayload });
+
+export default (({ client }) => defineMappedTool({
+  name: "search-coffee-catalog",
+  access: "public",
+  description: "Search BrewMark's public coffee catalogue and explain its acidity and body ratings.",
+  inputSchema: searchInput,
+  outputSchema: searchReport,
+  backendInputSchema: backendCommand,
+  backendOutputSchema: backendResult,
+  mapInput: ({ query, roast }) => ({
+    pathname: "/api/coffees" as const,
+    searchParams: {
+      q: query,
+      ...(roast ? { roastLevel: publicToBrewmarkRoast[roast] } : {}),
+      sort: "alpha" as const,
+      limit: "5" as const,
+    },
+  }),
+  async adapter(request, { signal, deadlineMs }) {
+    return { request, payload: await client.get({ ...request, signal, deadlineMs }) };
+  },
+  mapOutput: ({ request, payload }) => {
+    const coffees = payload.data.map((record) => ({
+      name: record.name, roaster: record.roasterName, origin: record.origin,
+      roast: brewmarkToPublicRoast[record.roastLevel], processingMethod: record.processingMethod,
+      flavourNotes: record.flavorProfile, acidityLevel: record.acidityLevel, bodyLevel: record.bodyLevel,
+    }));
+    const roastFilter = request.searchParams.roastLevel
+      ? brewmarkToPublicRoast[request.searchParams.roastLevel]
+      : null;
+    const data = {
+      query: request.searchParams.q,
+      roastFilter,
+      returnedCount: coffees.length,
+      moreMatchesAvailable: payload.hasMore,
+      ratingScale: {
+        acidity: "1 = low acidity; 5 = high acidity" as const,
+        body: "1 = light body; 5 = full body" as const,
+      },
+      coffees,
+      source: "BrewMark" as const,
+      sourceUrl: "https://brewmark.io" as const,
+    };
+    const lines = coffees.map((record) => [
+      `${record.name} by ${record.roaster}`,
+      `origin: ${record.origin ?? "not provided"}`,
+      `roast: ${record.roast}`,
+      `acidity: ${record.acidityLevel ?? "not provided"}`,
+      `body: ${record.bodyLevel ?? "not provided"}`,
+    ].join("; "));
+    return {
+      text: [
+        `BrewMark returned ${coffees.length} coffee${coffees.length === 1 ? "" : "s"} for “${data.query}”.`,
+        `More matches available: ${data.moreMatchesAvailable ? "yes" : "no"}.`,
+        "Acidity: 1 = low acidity; 5 = high acidity.",
+        "Body: 1 = light body; 5 = full body.",
+        ...lines,
+        "Source: https://brewmark.io",
+      ].join("\n"),
+      data,
+    };
+  },
+})) satisfies CapabilityModuleFactory<BackendExampleContext>;

package/dist/template/src/server.ts

@@ -7,7 +7,7 @@ const client = createJsonHttpClient({
   maxResponseBytes: 128 * 1024,
 });
 const running = await serveEmseepea(
-  createBackendExample(client),
+  await createBackendExample(client),
   { port: Number.parseInt(process.env.PORT ?? "3000", 10) },
 );
 

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

@@ -8,7 +8,7 @@ import { brewmarkFixture } from "../test-support/brewmark-fixture.mjs";
 test("the backend example maps, checks, and explains BrewMark data", async () => {
   const requests = [];
   let response = brewmarkFixture;
-  const app = createBackendExample({
+  const app = await createBackendExample({
     async get(options) {
       requests.push(options);
       if (response instanceof Error) throw response;

package/dist/template/test-support/llm-server.mjs

@@ -3,7 +3,7 @@ import { serveEmseepea } from "@emseepea/server";
 import { createBackendExample } from "../dist/app.js";
 import { brewmarkFixture } from "./brewmark-fixture.mjs";
 
-const app = createBackendExample({
+const app = await createBackendExample({
   async get({ pathname, searchParams }) {
     assert.equal(pathname, "/api/coffees");
     const { q, ...options } = searchParams;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emseepea/create-api-backed-server",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "description": "Create an Em See Pea server backed by a public web API.",
   "license": "MIT",
   "repository": {
@@ -10,19 +10,13 @@
   },
   "homepage": "https://emseepea.github.io/emseepea/examples/",
   "bugs": "https://github.com/emseepea/emseepea/issues",
-  "publishConfig": {
-    "access": "public",
-    "provenance": false,
-    "tag": "next"
-  },
+  "publishConfig": { "access": "public", "provenance": true, "tag": "next" },
   "type": "module",
-  "bin": {
-    "create-api-backed-server": "./dist/create.mjs"
+  "bin": { "create-api-backed-server": "./dist/create.mjs" },
+  "files": ["dist"],
+  "scripts": {
+    "build": "node ../../scripts/build-initializer.mjs",
+    "prepack": "npm run build"
   },
-  "files": [
-    "dist"
-  ],
-  "engines": {
-    "node": ">=22"
-  }
+  "engines": { "node": ">=22" }
 }