@venturewild/workspace 0.3.7 → 0.4.0

package/server/src/bazaar/mcp-server.mjs

@@ -1,328 +1,328 @@
-// Bazaar MCP server — the tools the agent uses to "reach onto our shelf" (§3.7).
-//
-// Hand-rolled stdio JSON-RPC 2.0 (newline-delimited), so it needs NO new
-// dependency and stays in the project's wrap-don't-embed style (like the
-// stream-json parser in agent.mjs). `claude` spawns this per turn via --mcp-config
-// and exposes the tools as mcp__bazaar__<name>.
-//
-// It imports the SAME core.mjs the main server uses, so there is one source of
-// truth (state under ~/.wild-workspace/bazaar/) and no HTTP/port handshake. Tool
-// results are JSON envelopes: the AGENT reads them (incl. the absorbed know-how),
-// and the UI parses the same JSON to render rich bazaar cards.
-//
-// stdout carries ONLY JSON-RPC. Any diagnostics go to stderr.
-
-import readline from 'node:readline';
-import { createBazaar } from './core.mjs';
-
-const bazaar = createBazaar(); // baseDir from WILD_WORKSPACE_GLOBAL_DIR (set by parent)
-const PROTOCOL_VERSION = '2025-06-18';
-
-function send(msg) {
-  process.stdout.write(`${JSON.stringify(msg)}\n`);
-}
-function result(id, res) {
-  send({ jsonrpc: '2.0', id, result: res });
-}
-function errorReply(id, code, message) {
-  send({ jsonrpc: '2.0', id, error: { code, message } });
-}
-function textContent(obj) {
-  return { content: [{ type: 'text', text: JSON.stringify(obj) }] };
-}
-
-// --- tool definitions -----------------------------------------------------
-
-const TOOLS = [
-  {
-    name: 'search_shelf',
-    description:
-      "Search the bazaar shelf for a proven recipe that matches what the user wants to build. " +
-      "Call this FIRST when the user describes an outcome that plausibly matches a known build. " +
-      "Returns ranked matches with an outcome score (how often the recipe actually gets people a " +
-      "working result). Only surface a recipe to the user if there is a STRONG, clearly relevant match.",
-    inputSchema: {
-      type: 'object',
-      properties: {
-        need: { type: 'string', description: "Plain-language description of what the user wants." },
-      },
-      required: ['need'],
-    },
-  },
-  {
-    name: 'open_recipe',
-    description:
-      "Open a recipe to absorb the producer's know-how (the step-by-step way to build it their way). " +
-      "Call this after the user accepts a recipe, then build it one-shot following the know-how.",
-    inputSchema: {
-      type: 'object',
-      properties: { id: { type: 'string', description: 'The recipe id from search_shelf.' } },
-      required: ['id'],
-    },
-  },
-  {
-    name: 'launch_preview',
-    description:
-      "Point the user's live preview at the folder you built, so it opens on their screen. " +
-      "Call this right after writing the build files.",
-    inputSchema: {
-      type: 'object',
-      properties: {
-        dir: { type: 'string', description: 'The build folder (relative to the workspace), e.g. "candidate-matcher".' },
-        recipeId: { type: 'string', description: 'The recipe id this build came from (optional).' },
-      },
-      required: ['dir'],
-    },
-  },
-  {
-    name: 'record_use',
-    description:
-      "Record that the user built on a producer's recipe — this credits the producer and records the " +
-      "transaction (the three-way win). Call this once the build is done.",
-    inputSchema: {
-      type: 'object',
-      properties: {
-        recipeId: { type: 'string', description: 'The recipe id that was used.' },
-        summary: { type: 'string', description: 'One short line describing what you built for the user.' },
-      },
-      required: ['recipeId'],
-    },
-  },
-  {
-    name: 'publish_listing',
-    description:
-      "Package something the user built into a listing on the shelf, so other people's agents can " +
-      "build on it and the user earns when they do. Use when the user accepts your offer to package " +
-      "it, OR when the user explicitly asks to list/sell what they made.",
-    inputSchema: {
-      type: 'object',
-      properties: {
-        title: { type: 'string', description: 'A short title for the listing.' },
-        pitch: { type: 'string', description: 'One line that sells what it does.' },
-        summary: { type: 'string', description: 'A plain summary of what someone gets.' },
-        tags: { type: 'array', items: { type: 'string' }, description: 'Keywords others might search for.' },
-        knowHow: { type: 'string', description: "The how-to another agent would absorb to rebuild it." },
-        buildDir: { type: 'string', description: 'The folder the build lives in (optional).' },
-      },
-      required: ['title'],
-    },
-  },
-  {
-    name: 'draft_recipe',
-    description:
-      "Stage a recipe you EXTRACTED from the user's existing/past work for their REVIEW (does NOT " +
-      "publish). Use when self-seeding the shelf from past projects. The know-how MUST be " +
-      "GENERALIZED — the reusable method/architecture only, with NO client names, data, domains, " +
-      "keys, or secrets. Stage one draft per reusable pattern; the user reviews each and tells you " +
-      "which to publish.",
-    inputSchema: {
-      type: 'object',
-      properties: {
-        title: { type: 'string', description: 'A short title for the recipe.' },
-        pitch: { type: 'string', description: 'One line: what it lets someone build.' },
-        summary: { type: 'string', description: 'A plain summary of what someone gets.' },
-        tags: { type: 'array', items: { type: 'string' }, description: 'Keywords others might search for.' },
-        knowHow: { type: 'string', description: "The GENERALIZED how-to another agent would follow — no client specifics." },
-        sourceNote: { type: 'string', description: 'For the user to verify: what this was generalized from (e.g. "from 3 client landing pages") — no client names.' },
-      },
-      required: ['title', 'knowHow'],
-    },
-  },
-  {
-    name: 'publish_draft',
-    description:
-      "Publish a reviewed draft onto the shelf. Call ONLY after the user has explicitly approved that " +
-      "specific draft (by its id).",
-    inputSchema: {
-      type: 'object',
-      properties: { id: { type: 'string', description: 'The draft id from draft_recipe.' } },
-      required: ['id'],
-    },
-  },
-  {
-    name: 'publish_theme',
-    description:
-      "Publish a workspace THEME to the bazaar so others can discover and apply it (the user earns each " +
-      "time someone does). Use this when the user asks to share/list/sell a look they like, or after you " +
-      "made one they love. A theme is just colours (hex values) — pick a mode (light|dark), an accent, " +
-      "and the token colours that define the look. Give it a short title and a one-line pitch.",
-    inputSchema: {
-      type: 'object',
-      properties: {
-        title: { type: 'string', description: 'Short theme name, e.g. "Warm Sunset".' },
-        pitch: { type: 'string', description: 'One-line description of the vibe.' },
-        summary: { type: 'string', description: 'A slightly longer description (optional).' },
-        tags: { type: 'array', items: { type: 'string' }, description: 'e.g. ["dark","warm"].' },
-        mode: { type: 'string', enum: ['light', 'dark'], description: 'Base palette.' },
-        accent: { type: 'string', description: 'Primary accent, hex e.g. "#22d3ee".' },
-        bg: { type: 'string', description: 'page background, hex.' },
-        surface: { type: 'string', description: 'card face, hex.' },
-        text: { type: 'string', description: 'primary text, hex.' },
-        textMuted: { type: 'string', description: 'muted text, hex.' },
-        border: { type: 'string', description: 'borders, hex.' },
-        canvas1: { type: 'string', description: 'wallpaper stop 1, hex.' },
-        canvas2: { type: 'string', description: 'wallpaper stop 2, hex.' },
-        canvas3: { type: 'string', description: 'wallpaper stop 3, hex.' },
-      },
-      required: ['title'],
-    },
-  },
-];
-
-// --- tool dispatch --------------------------------------------------------
-
-function callTool(name, args = {}) {
-  switch (name) {
-    case 'search_shelf': {
-      const hits = bazaar.search(args.need || '');
-      return textContent({
-        kind: 'search',
-        need: args.need || '',
-        count: hits.length,
-        hits,
-        top: hits[0] || null,
-        guidance:
-          hits.length === 0
-            ? 'Nothing on the shelf is a strong match — build from scratch and do not mention the bazaar.'
-            : 'Surface the top match to the user only if it is clearly relevant (a strong, high-outcome match).',
-      });
-    }
-    case 'open_recipe': {
-      const r = bazaar.getRecipe(args.id);
-      if (!r) return { ...textContent({ kind: 'error', error: `no recipe "${args.id}"` }), isError: true };
-      return textContent({
-        kind: 'recipe',
-        card: bazaar.card(r),
-        knowHow: r.knowHow || '',
-        service: r.service || null,
-        note: 'Absorb this know-how and build it one-shot for the user.',
-      });
-    }
-    case 'launch_preview': {
-      const preview = bazaar.setPreview({ dir: args.dir, recipeId: args.recipeId || null });
-      return textContent({ kind: 'preview', url: '/preview/', dir: preview.dir, recipeId: preview.recipeId });
-    }
-    case 'record_use': {
-      const res = bazaar.recordUse({ recipeId: args.recipeId, summary: args.summary });
-      if (!res.ok) return { ...textContent({ kind: 'error', error: res.error }), isError: true };
-      // Backstop the preview: even if the agent forgot launch_preview, target the
-      // recipe's build dir so the preview still opens (review must-fix #3).
-      let preview = bazaar.getPreview();
-      if ((!preview || !preview.dir) && res.recipe?.buildDir) {
-        preview = bazaar.setPreview({ dir: res.recipe.buildDir, recipeId: res.recipe.id });
-      }
-      return textContent({
-        kind: 'three-way',
-        recipe: res.recipe,
-        threeWay: res.threeWay,
-        credit: res.credit,
-        service: res.service,
-        preview: preview?.dir ? { url: '/preview/', dir: preview.dir } : null,
-        simulated: true,
-      });
-    }
-    case 'publish_listing': {
-      const res = bazaar.publishListing({
-        title: args.title,
-        pitch: args.pitch,
-        summary: args.summary,
-        tags: args.tags || [],
-        knowHow: args.knowHow || '',
-        buildDir: args.buildDir || null,
-      });
-      return textContent({ kind: 'publish', listing: res.listing, earning: res.earning, simulated: true });
-    }
-    case 'draft_recipe': {
-      const draft = bazaar.stageDraft({
-        title: args.title,
-        pitch: args.pitch,
-        summary: args.summary,
-        tags: args.tags || [],
-        knowHow: args.knowHow || '',
-        sourceNote: args.sourceNote || '',
-      });
-      return textContent({ kind: 'draft', draft });
-    }
-    case 'publish_draft': {
-      const res = bazaar.publishDraft(args.id);
-      if (!res.ok) return { ...textContent({ kind: 'error', error: res.error }), isError: true };
-      return textContent({ kind: 'publish', listing: res.listing, earning: res.earning, simulated: true });
-    }
-    case 'publish_theme': {
-      const res = bazaar.publishTheme({
-        title: args.title,
-        pitch: args.pitch,
-        summary: args.summary,
-        tags: args.tags || [],
-        theme: {
-          mode: args.mode,
-          accent: args.accent,
-          bg: args.bg, surface: args.surface, text: args.text, textMuted: args.textMuted,
-          border: args.border, canvas1: args.canvas1, canvas2: args.canvas2, canvas3: args.canvas3,
-        },
-      });
-      return textContent({ kind: 'publish', listing: res.listing, earning: res.earning, simulated: true });
-    }
-    default:
-      return { ...textContent({ kind: 'error', error: `unknown tool ${name}` }), isError: true };
-  }
-}
-
-// --- JSON-RPC loop --------------------------------------------------------
-
-export function handleMessage(msg) {
-  if (!msg || msg.jsonrpc !== '2.0') return;
-  const { id, method, params } = msg;
-  const isNotification = id === undefined || id === null;
-
-  switch (method) {
-    case 'initialize':
-      return result(id, {
-        protocolVersion: params?.protocolVersion || PROTOCOL_VERSION,
-        capabilities: { tools: {} },
-        serverInfo: { name: 'bazaar', version: '1.0.0' },
-      });
-    case 'notifications/initialized':
-    case 'initialized':
-      return; // notification, no response
-    case 'ping':
-      return result(id, {});
-    case 'tools/list':
-      return result(id, { tools: TOOLS });
-    case 'tools/call': {
-      try {
-        const out = callTool(params?.name, params?.arguments || {});
-        return result(id, out);
-      } catch (e) {
-        return errorReply(id, -32603, `tool error: ${e?.message || e}`);
-      }
-    }
-    default:
-      if (!isNotification) errorReply(id, -32601, `method not found: ${method}`);
-      return;
-  }
-}
-
-// Only run the stdio loop when executed as the MCP process (not when imported by a test).
-const isDirectRun = process.argv[1] && process.argv[1].endsWith('mcp-server.mjs');
-if (isDirectRun) {
-  const rl = readline.createInterface({ input: process.stdin });
-  rl.on('line', (line) => {
-    const trimmed = line.trim();
-    if (!trimmed) return;
-    let msg;
-    try {
-      msg = JSON.parse(trimmed);
-    } catch {
-      return; // ignore non-JSON noise
-    }
-    try {
-      handleMessage(msg);
-    } catch (e) {
-      process.stderr.write(`bazaar mcp error: ${e?.message || e}\n`);
-    }
-  });
-  process.stderr.write('bazaar mcp server ready\n');
-}
-
-export { TOOLS, callTool };
+// Bazaar MCP server — the tools the agent uses to "reach onto our shelf" (§3.7).
+//
+// Hand-rolled stdio JSON-RPC 2.0 (newline-delimited), so it needs NO new
+// dependency and stays in the project's wrap-don't-embed style (like the
+// stream-json parser in agent.mjs). `claude` spawns this per turn via --mcp-config
+// and exposes the tools as mcp__bazaar__<name>.
+//
+// It imports the SAME core.mjs the main server uses, so there is one source of
+// truth (state under ~/.wild-workspace/bazaar/) and no HTTP/port handshake. Tool
+// results are JSON envelopes: the AGENT reads them (incl. the absorbed know-how),
+// and the UI parses the same JSON to render rich bazaar cards.
+//
+// stdout carries ONLY JSON-RPC. Any diagnostics go to stderr.
+
+import readline from 'node:readline';
+import { createBazaar } from './core.mjs';
+
+const bazaar = createBazaar(); // baseDir from WILD_WORKSPACE_GLOBAL_DIR (set by parent)
+const PROTOCOL_VERSION = '2025-06-18';
+
+function send(msg) {
+  process.stdout.write(`${JSON.stringify(msg)}\n`);
+}
+function result(id, res) {
+  send({ jsonrpc: '2.0', id, result: res });
+}
+function errorReply(id, code, message) {
+  send({ jsonrpc: '2.0', id, error: { code, message } });
+}
+function textContent(obj) {
+  return { content: [{ type: 'text', text: JSON.stringify(obj) }] };
+}
+
+// --- tool definitions -----------------------------------------------------
+
+const TOOLS = [
+  {
+    name: 'search_shelf',
+    description:
+      "Search the bazaar shelf for a proven recipe that matches what the user wants to build. " +
+      "Call this FIRST when the user describes an outcome that plausibly matches a known build. " +
+      "Returns ranked matches with an outcome score (how often the recipe actually gets people a " +
+      "working result). Only surface a recipe to the user if there is a STRONG, clearly relevant match.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        need: { type: 'string', description: "Plain-language description of what the user wants." },
+      },
+      required: ['need'],
+    },
+  },
+  {
+    name: 'open_recipe',
+    description:
+      "Open a recipe to absorb the producer's know-how (the step-by-step way to build it their way). " +
+      "Call this after the user accepts a recipe, then build it one-shot following the know-how.",
+    inputSchema: {
+      type: 'object',
+      properties: { id: { type: 'string', description: 'The recipe id from search_shelf.' } },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'launch_preview',
+    description:
+      "Point the user's live preview at the folder you built, so it opens on their screen. " +
+      "Call this right after writing the build files.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        dir: { type: 'string', description: 'The build folder (relative to the workspace), e.g. "candidate-matcher".' },
+        recipeId: { type: 'string', description: 'The recipe id this build came from (optional).' },
+      },
+      required: ['dir'],
+    },
+  },
+  {
+    name: 'record_use',
+    description:
+      "Record that the user built on a producer's recipe — this credits the producer and records the " +
+      "transaction (the three-way win). Call this once the build is done.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        recipeId: { type: 'string', description: 'The recipe id that was used.' },
+        summary: { type: 'string', description: 'One short line describing what you built for the user.' },
+      },
+      required: ['recipeId'],
+    },
+  },
+  {
+    name: 'publish_listing',
+    description:
+      "Package something the user built into a listing on the shelf, so other people's agents can " +
+      "build on it and the user earns when they do. Use when the user accepts your offer to package " +
+      "it, OR when the user explicitly asks to list/sell what they made.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title: { type: 'string', description: 'A short title for the listing.' },
+        pitch: { type: 'string', description: 'One line that sells what it does.' },
+        summary: { type: 'string', description: 'A plain summary of what someone gets.' },
+        tags: { type: 'array', items: { type: 'string' }, description: 'Keywords others might search for.' },
+        knowHow: { type: 'string', description: "The how-to another agent would absorb to rebuild it." },
+        buildDir: { type: 'string', description: 'The folder the build lives in (optional).' },
+      },
+      required: ['title'],
+    },
+  },
+  {
+    name: 'draft_recipe',
+    description:
+      "Stage a recipe you EXTRACTED from the user's existing/past work for their REVIEW (does NOT " +
+      "publish). Use when self-seeding the shelf from past projects. The know-how MUST be " +
+      "GENERALIZED — the reusable method/architecture only, with NO client names, data, domains, " +
+      "keys, or secrets. Stage one draft per reusable pattern; the user reviews each and tells you " +
+      "which to publish.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title: { type: 'string', description: 'A short title for the recipe.' },
+        pitch: { type: 'string', description: 'One line: what it lets someone build.' },
+        summary: { type: 'string', description: 'A plain summary of what someone gets.' },
+        tags: { type: 'array', items: { type: 'string' }, description: 'Keywords others might search for.' },
+        knowHow: { type: 'string', description: "The GENERALIZED how-to another agent would follow — no client specifics." },
+        sourceNote: { type: 'string', description: 'For the user to verify: what this was generalized from (e.g. "from 3 client landing pages") — no client names.' },
+      },
+      required: ['title', 'knowHow'],
+    },
+  },
+  {
+    name: 'publish_draft',
+    description:
+      "Publish a reviewed draft onto the shelf. Call ONLY after the user has explicitly approved that " +
+      "specific draft (by its id).",
+    inputSchema: {
+      type: 'object',
+      properties: { id: { type: 'string', description: 'The draft id from draft_recipe.' } },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'publish_theme',
+    description:
+      "Publish a workspace THEME to the bazaar so others can discover and apply it (the user earns each " +
+      "time someone does). Use this when the user asks to share/list/sell a look they like, or after you " +
+      "made one they love. A theme is just colours (hex values) — pick a mode (light|dark), an accent, " +
+      "and the token colours that define the look. Give it a short title and a one-line pitch.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title: { type: 'string', description: 'Short theme name, e.g. "Warm Sunset".' },
+        pitch: { type: 'string', description: 'One-line description of the vibe.' },
+        summary: { type: 'string', description: 'A slightly longer description (optional).' },
+        tags: { type: 'array', items: { type: 'string' }, description: 'e.g. ["dark","warm"].' },
+        mode: { type: 'string', enum: ['light', 'dark'], description: 'Base palette.' },
+        accent: { type: 'string', description: 'Primary accent, hex e.g. "#22d3ee".' },
+        bg: { type: 'string', description: 'page background, hex.' },
+        surface: { type: 'string', description: 'card face, hex.' },
+        text: { type: 'string', description: 'primary text, hex.' },
+        textMuted: { type: 'string', description: 'muted text, hex.' },
+        border: { type: 'string', description: 'borders, hex.' },
+        canvas1: { type: 'string', description: 'wallpaper stop 1, hex.' },
+        canvas2: { type: 'string', description: 'wallpaper stop 2, hex.' },
+        canvas3: { type: 'string', description: 'wallpaper stop 3, hex.' },
+      },
+      required: ['title'],
+    },
+  },
+];
+
+// --- tool dispatch --------------------------------------------------------
+
+function callTool(name, args = {}) {
+  switch (name) {
+    case 'search_shelf': {
+      const hits = bazaar.search(args.need || '');
+      return textContent({
+        kind: 'search',
+        need: args.need || '',
+        count: hits.length,
+        hits,
+        top: hits[0] || null,
+        guidance:
+          hits.length === 0
+            ? 'Nothing on the shelf is a strong match — build from scratch and do not mention the bazaar.'
+            : 'Surface the top match to the user only if it is clearly relevant (a strong, high-outcome match).',
+      });
+    }
+    case 'open_recipe': {
+      const r = bazaar.getRecipe(args.id);
+      if (!r) return { ...textContent({ kind: 'error', error: `no recipe "${args.id}"` }), isError: true };
+      return textContent({
+        kind: 'recipe',
+        card: bazaar.card(r),
+        knowHow: r.knowHow || '',
+        service: r.service || null,
+        note: 'Absorb this know-how and build it one-shot for the user.',
+      });
+    }
+    case 'launch_preview': {
+      const preview = bazaar.setPreview({ dir: args.dir, recipeId: args.recipeId || null });
+      return textContent({ kind: 'preview', url: '/preview/', dir: preview.dir, recipeId: preview.recipeId });
+    }
+    case 'record_use': {
+      const res = bazaar.recordUse({ recipeId: args.recipeId, summary: args.summary });
+      if (!res.ok) return { ...textContent({ kind: 'error', error: res.error }), isError: true };
+      // Backstop the preview: even if the agent forgot launch_preview, target the
+      // recipe's build dir so the preview still opens (review must-fix #3).
+      let preview = bazaar.getPreview();
+      if ((!preview || !preview.dir) && res.recipe?.buildDir) {
+        preview = bazaar.setPreview({ dir: res.recipe.buildDir, recipeId: res.recipe.id });
+      }
+      return textContent({
+        kind: 'three-way',
+        recipe: res.recipe,
+        threeWay: res.threeWay,
+        credit: res.credit,
+        service: res.service,
+        preview: preview?.dir ? { url: '/preview/', dir: preview.dir } : null,
+        simulated: true,
+      });
+    }
+    case 'publish_listing': {
+      const res = bazaar.publishListing({
+        title: args.title,
+        pitch: args.pitch,
+        summary: args.summary,
+        tags: args.tags || [],
+        knowHow: args.knowHow || '',
+        buildDir: args.buildDir || null,
+      });
+      return textContent({ kind: 'publish', listing: res.listing, earning: res.earning, simulated: true });
+    }
+    case 'draft_recipe': {
+      const draft = bazaar.stageDraft({
+        title: args.title,
+        pitch: args.pitch,
+        summary: args.summary,
+        tags: args.tags || [],
+        knowHow: args.knowHow || '',
+        sourceNote: args.sourceNote || '',
+      });
+      return textContent({ kind: 'draft', draft });
+    }
+    case 'publish_draft': {
+      const res = bazaar.publishDraft(args.id);
+      if (!res.ok) return { ...textContent({ kind: 'error', error: res.error }), isError: true };
+      return textContent({ kind: 'publish', listing: res.listing, earning: res.earning, simulated: true });
+    }
+    case 'publish_theme': {
+      const res = bazaar.publishTheme({
+        title: args.title,
+        pitch: args.pitch,
+        summary: args.summary,
+        tags: args.tags || [],
+        theme: {
+          mode: args.mode,
+          accent: args.accent,
+          bg: args.bg, surface: args.surface, text: args.text, textMuted: args.textMuted,
+          border: args.border, canvas1: args.canvas1, canvas2: args.canvas2, canvas3: args.canvas3,
+        },
+      });
+      return textContent({ kind: 'publish', listing: res.listing, earning: res.earning, simulated: true });
+    }
+    default:
+      return { ...textContent({ kind: 'error', error: `unknown tool ${name}` }), isError: true };
+  }
+}
+
+// --- JSON-RPC loop --------------------------------------------------------
+
+export function handleMessage(msg) {
+  if (!msg || msg.jsonrpc !== '2.0') return;
+  const { id, method, params } = msg;
+  const isNotification = id === undefined || id === null;
+
+  switch (method) {
+    case 'initialize':
+      return result(id, {
+        protocolVersion: params?.protocolVersion || PROTOCOL_VERSION,
+        capabilities: { tools: {} },
+        serverInfo: { name: 'bazaar', version: '1.0.0' },
+      });
+    case 'notifications/initialized':
+    case 'initialized':
+      return; // notification, no response
+    case 'ping':
+      return result(id, {});
+    case 'tools/list':
+      return result(id, { tools: TOOLS });
+    case 'tools/call': {
+      try {
+        const out = callTool(params?.name, params?.arguments || {});
+        return result(id, out);
+      } catch (e) {
+        return errorReply(id, -32603, `tool error: ${e?.message || e}`);
+      }
+    }
+    default:
+      if (!isNotification) errorReply(id, -32601, `method not found: ${method}`);
+      return;
+  }
+}
+
+// Only run the stdio loop when executed as the MCP process (not when imported by a test).
+const isDirectRun = process.argv[1] && process.argv[1].endsWith('mcp-server.mjs');
+if (isDirectRun) {
+  const rl = readline.createInterface({ input: process.stdin });
+  rl.on('line', (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+    let msg;
+    try {
+      msg = JSON.parse(trimmed);
+    } catch {
+      return; // ignore non-JSON noise
+    }
+    try {
+      handleMessage(msg);
+    } catch (e) {
+      process.stderr.write(`bazaar mcp error: ${e?.message || e}\n`);
+    }
+  });
+  process.stderr.write('bazaar mcp server ready\n');
+}
+
+export { TOOLS, callTool };