@yichus/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steven Klaiber-Noble
+
+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/README.md

@@ -0,0 +1,144 @@
+# @yichus/mcp
+
+MCP server that exposes the [Yichus](https://yich.us) calculators and the
+in-browser Bosatsu playground to any agent that speaks the Model Context
+Protocol.
+
+It bundles the local WebMCP relay and adds calculator discovery/opening tools.
+A connected agent works with the same page the user can see: source edits,
+compiler diagnostics, results, and program diagrams.
+
+## Install and connect
+
+Node 20 or newer. The relay does not need Java.
+
+```sh
+npm install -g @yichus/mcp
+```
+
+Configure your MCP client to launch this stdio server:
+
+```json
+{
+  "mcpServers": {
+    "yichus": {
+      "command": "npx",
+      "args": ["-y", "@yichus/mcp"]
+    }
+  }
+}
+```
+
+A global install can use `"command": "yichus-mcp"` instead of `npx`.
+
+To work on the relay from a checkout of this repository:
+
+```sh
+pnpm install
+pnpm run yichus-mcp:build
+node packages/yichus-mcp/dist/cli.js
+```
+
+Open the desired page with `?webmcp=1`. Keep it open, call
+`webmcp_list_sources`, and select the source id for that tab. Discover its
+schemas with `webmcp_list_tools`, then use `webmcp_call_tool` with `sourceId`,
+`name`, and `arguments`. The relay and browser must run on the same computer.
+For a local site, set `--base-url` to the origin you opened.
+
+A browser host with native WebMCP support can call page tools without this
+relay. See [connection instructions](https://yich.us/reference/agent.html).
+
+## Choose the tools for the page
+
+- **An editable Code & run example** on the website: call
+  `yichus_example_guide`, `yichus_examples_list`, and `yichus_example_read`.
+  Use `yichus_example_update` with exact file names and the read revision;
+  `yichus_example_run` compiles/runs or checks the program. Inspect
+  `yichus_example_feedback`. Once a calculator preview is ready,
+  `yichus_example_preview` changes its visible controls or clicks Why.
+  Pass the current source revision and preview id, so an old call cannot
+  act on a replacement preview. Read-only demo drawers report that limit.
+- **Calculator editor**, `editor.html`: `yichus_playground_get_sources`,
+  `yichus_playground_update_sources`, `yichus_playground_compile`,
+  `yichus_playground_get_output`, and `yichus_playground_reset`. Read sources
+  first and pass their revision as `expectedRevision` when updating. Output
+  feedback includes rendered text, controls, and runtime errors after loading.
+- **API workbench**, `api-mcp.html`: call `api_guide` first. Discover the
+  current `api_*` catalog for compilation, checks, organization lenses,
+  and evaluation. `api_abstraction_map`, `api_organize` with lens `stack`,
+  and `api_why` update the visible diagrams/evaluator. The `yichus_app_*`
+  tools open a generated app, exercise routes, inspect rows, and test
+  configured crash/restart behavior. The page links their reference.
+- **Standalone calculator**: `yichus_list_inputs`, `yichus_set_inputs`,
+  `yichus_list_outputs`, `yichus_explain_output`. These operate the running
+  calculator; use an editable source drawer or the editor to change code.
+- **Explorer and state-machine spec editors**: `yichus_autocomplete_*`
+  provides suggestions for the user to accept. The user then runs the page's
+  checker. These tools do not execute a check themselves. For a complete agent edit/run loop, use page edit/action/feedback below.
+- **Page feedback** on the source drawers, editor, Explorer, API workbench,
+  and spec demo: `yichus_page_feedback` reads visible text, source buffers,
+  statuses, and embedded-view titles. It links the agent instructions.
+  `yichus_page_edit` replaces a visible editor only when its full current text matches `expectedSource`; `yichus_page_action` activates a button by its listed id. Read feedback for asynchronous completion and diagnostics. It is text feedback, not a screenshot or a judgment of visual design.
+
+The static `yichus_list_calculators` tool lists curated demo URLs;
+`yichus_open_calculator` opens a chosen slug with the relay flag. The
+`playground` slug opens the standalone calculator editor.
+
+## Agent editing loop
+
+1. Read the instructions, source, inputs, and assumptions on the chosen tab.
+2. Make a specific change in the visible source using its current revision.
+   If that revision is stale, read the user's newer edit before proceeding.
+3. Compile and fix diagnostics. For an API example, rerun the appropriate
+   structural check and a behavior check.
+4. Inspect feedback from the current result. Change a calculator input and
+   inspect Why. Report tested inputs, actual results, and remaining limits.
+5. Save the edited sources before leaving the page. A successful compilation
+   and a few executions do not establish that every model assumption is sound.
+
+For autocomplete, call `yichus_autocomplete_wait_for_request`, then respond
+with `yichus_autocomplete_suggest` using the request's editor id and revision.
+The user accepts the ghost text with Tab or dismisses it with Escape.
+`yichus_autocomplete_list_editors`, `yichus_autocomplete_get_context`, and
+`yichus_autocomplete_dismiss` support inspection and cancellation.
+
+## CLI
+
+```text
+yichus-mcp [options]
+
+  --base-url     Yichus deployment to talk to (default: https://yich.us).
+                 Used as the relay --widget-origin and as the URL base for
+                 yichus_open_calculator.
+  --host         Bridge bind host (default: 127.0.0.1).
+  --port         Bridge WebSocket port (default: 9333, falls back to 9334+).
+  --label        Human label reported during relay discovery (default: "Yichus").
+  --workspace    Workspace name reported during relay discovery (default: "yichus").
+  --relay-id     Relay id reported during relay discovery (default: "yichus").
+  --help, -h     Show this help.
+```
+
+The workspace and relay id are an agreement with the pages: every Yichus
+page hints the relay widget workspace `yichus` and relay id `yichus`, and
+the widget refuses a relay whose discovery announcement differs from
+either. Change them only for a page built to hint the same values.
+
+For local development against a self-hosted Yichus build, point both the
+relay's allowed origin and the URL builder at your dev server:
+
+```bash
+node packages/yichus-mcp/dist/cli.js --base-url http://localhost:8000
+```
+
+## What this package does and does not do
+
+This package is a thin yichus-curated wrapper around
+`@mcp-b/webmcp-local-relay`. It does not fork or reimplement the relay;
+it constructs a `LocalRelayMcpServer` from the relay package and registers
+two extra static tools on it. The relay version is pinned exactly so an
+upstream rename of an internal field is a deliberate audit step rather
+than a silent breakage.
+
+For the underlying relay itself (its CLI flags, security model, and
+runtime compatibility), see the
+[`@mcp-b/webmcp-local-relay` README](https://www.npmjs.com/package/@mcp-b/webmcp-local-relay).

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,430 @@
+#!/usr/bin/env node
+
+// src/server.ts
+import { LocalRelayMcpServer } from "@mcp-b/webmcp-local-relay";
+import { z } from "zod";
+
+// src/calculators.ts
+var DEFAULT_BASE_URL = "https://yich.us";
+var CALCULATORS = [
+  {
+    slug: "event-budget",
+    title: "Event budget",
+    description: "Ticket income, event costs, and the amount left over. Change attendance or adapt the cost rules.",
+    path: "demos/simulation/event-budget.html"
+  },
+  {
+    slug: "rainwater",
+    title: "Rainwater tank",
+    description: "How much water does one rainfall event collect, and how much overflows the tank?",
+    path: "demos/simulation/rainwater.html"
+  },
+  {
+    slug: "battery-runtime",
+    title: "Battery runtime",
+    description: "Estimate runtime from a battery energy budget, a constant load, and a usable-capacity assumption.",
+    path: "demos/simulation/battery-runtime.html"
+  },
+  {
+    slug: "recipe-scale",
+    title: "Scale a recipe",
+    description: "Scale ingredient weights to a different number of servings. Replace the ingredients with your own.",
+    path: "demos/simulation/recipe-scale.html"
+  },
+  {
+    slug: "download-time",
+    title: "Download time",
+    description: "Convert file size and connection speed into transfer time, allowing for a chosen efficiency.",
+    path: "demos/simulation/download-time.html"
+  },
+  {
+    slug: "loan",
+    title: "Loan Calculator",
+    description: "Fixed monthly payment and total interest for a loan repaid in equal monthly installments.",
+    path: "demos/simulation/loan-calculator.html"
+  },
+  {
+    slug: "investment",
+    title: "Investment Growth Calculator",
+    description: "Compound growth of a recurring investment under configurable return assumptions.",
+    path: "demos/simulation/investment.html"
+  },
+  {
+    slug: "tax",
+    title: "Tax Calculator",
+    description: "Flat-rate example: subtract a deduction and apply one percentage. No tax brackets or jurisdiction-specific rules.",
+    path: "demos/simulation/tax-calculator.html"
+  },
+  {
+    slug: "carbon",
+    title: "Carbon Footprint Calculator",
+    description: "Illustrative annual CO2 totals from driving, flights, electricity, and gas, using fixed emission factors.",
+    path: "demos/simulation/carbon-footprint.html"
+  },
+  {
+    slug: "rate",
+    title: "Rate Calculator",
+    description: "Apply a basis-point rate to an amount, then subtract a percentage fee. Inspect both helper calculations in Why.",
+    path: "demos/simulation/rate-calculator.html"
+  },
+  {
+    slug: "compound-fold",
+    title: "CompoundFold",
+    description: "Compound a starting amount over several periods, increasing the rate by 0.1 percentage points each period.",
+    path: "demos/simulation/compound-fold.html"
+  },
+  {
+    slug: "closure-capture",
+    title: "ClosureCapture",
+    description: "Scale two amounts with the same input rate captured by a shared inner function.",
+    path: "demos/simulation/closure-capture.html"
+  },
+  {
+    slug: "lambda-factory",
+    title: "Fee pipeline",
+    description: "Apply processing, platform, and regulatory fees in sequence, with each helper capturing its chosen rate.",
+    path: "demos/simulation/lambda-factory-selector.html"
+  },
+  {
+    slug: "portfolio",
+    title: "Three growth rates",
+    description: "Split an amount into three equal parts and apply a chosen growth rate to each. This example does not estimate risk.",
+    path: "demos/simulation/portfolio-analysis.html"
+  },
+  {
+    slug: "strategy-portfolio",
+    title: "Choosing a growth multiplier",
+    description: "Choose between three illustrative growth multipliers. This is a branching example, not an investment-risk model.",
+    path: "demos/simulation/strategy-portfolio.html"
+  },
+  {
+    slug: "tiered-policy",
+    title: "Claim payout rules",
+    description: "A toy claim payout: choose an incident severity and policy tier, then inspect the adjustments and deduction.",
+    path: "demos/simulation/tiered-policy-engine.html"
+  },
+  {
+    slug: "what-if-path-switch",
+    title: "WhatIfPathSwitch",
+    description: 'Switches computation paths via assumption toggles ("what-if" branches).',
+    path: "demos/simulation/what-if-path-switch.html"
+  },
+  {
+    slug: "deadweight_loss",
+    title: "Deadweight Loss Calculator",
+    description: "Equilibrium, surplus, and deadweight loss of a per-unit tax on a linear market.",
+    path: "demos/simulation/deadweight-loss.html"
+  },
+  {
+    slug: "trend_projection",
+    title: "Vintage Forecasts",
+    description: "An illustrative series with synthetic forecast vintages. Compare compounding assumptions; these are model-generated values, not agency data.",
+    path: "demos/simulation/trend-projection.html"
+  },
+  {
+    slug: "carbon_abatement",
+    title: "Carbon Abatement Path",
+    description: "A rising marginal abatement cost path as a sampled curve, with derived cheapest-step and tranche-cost marks.",
+    path: "demos/simulation/carbon-abatement.html"
+  }
+];
+var PLAYGROUND = {
+  slug: "playground",
+  title: "Yichus Bosatsu Playground",
+  description: "In-browser editor for Bosatsu simulations with live compile and Why explainer.",
+  path: "editor.html"
+};
+function findCalculator(slug) {
+  if (slug === PLAYGROUND.slug) return PLAYGROUND;
+  return CALCULATORS.find((calc) => calc.slug === slug);
+}
+function listCalculators() {
+  return [...CALCULATORS, PLAYGROUND];
+}
+function calculatorUrl(calc, baseUrl = DEFAULT_BASE_URL) {
+  const base = new URL(baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`);
+  return new URL(calc.path, base).toString();
+}
+function withWebMcpFlag(rawUrl) {
+  const url = new URL(rawUrl);
+  url.searchParams.set("webmcp", "1");
+  return url.toString();
+}
+
+// src/openUrl.ts
+import { spawn } from "child_process";
+function openUrlInBrowser(rawUrl) {
+  const validated = new URL(rawUrl).href;
+  const platform = process.platform;
+  let command;
+  let args;
+  if (platform === "darwin") {
+    command = "open";
+    args = [validated];
+  } else if (platform === "win32") {
+    command = "powershell";
+    args = ["-NoProfile", "-NonInteractive", "-Command", `Start-Process '${validated.replace(/'/g, "''")}'`];
+  } else {
+    command = "xdg-open";
+    args = [validated];
+  }
+  spawn(command, args, { detached: true, stdio: "ignore" }).unref();
+  return { command, args };
+}
+
+// src/server.ts
+var PACKAGE_NAME = "yichus-mcp";
+var PACKAGE_VERSION = "0.1.0";
+function createYichusMcpServer(options = {}) {
+  const baseUrl = normalizeBaseUrl(options.baseUrl ?? "https://yich.us");
+  const bridgeOverrides = options.bridgeOverrides ?? {};
+  const server = new LocalRelayMcpServer({
+    serverName: PACKAGE_NAME,
+    serverVersion: PACKAGE_VERSION,
+    bridgeOptions: {
+      host: bridgeOverrides.host,
+      port: bridgeOverrides.port,
+      label: bridgeOverrides.label ?? "Yichus",
+      // The pair every page hints the widget (web/webmcp-autocomplete.js,
+      // the generated calculators); the widget rejects any other hello.
+      workspace: bridgeOverrides.workspace ?? "yichus",
+      relayId: bridgeOverrides.relayId ?? "yichus",
+      allowedOrigins: [baseUrl]
+    }
+  });
+  registerYichusTools(server, { baseUrl, disableOpener: options.disableOpener ?? false });
+  return server;
+}
+function asInternal(server) {
+  return server;
+}
+function registerYichusTools(server, ctx) {
+  const internal = asInternal(server);
+  registerStatic(internal, {
+    name: "yichus_list_calculators",
+    description: "List the curated Yichus calculator demos and the playground editor available on the configured Yichus origin. Returns a slug, title, description, and absolute URL for each.",
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    inputSchemaJson: { type: "object", properties: {}, additionalProperties: false },
+    inputSchemaZod: {},
+    handler: async () => {
+      const entries = listCalculators().map((calc) => ({
+        slug: calc.slug,
+        title: calc.title,
+        description: calc.description,
+        url: calculatorUrl(calc, ctx.baseUrl)
+      }));
+      const payload = { baseUrl: ctx.baseUrl, calculators: entries };
+      return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload
+      };
+    }
+  });
+  registerStatic(internal, {
+    name: "yichus_open_calculator",
+    description: "Open a curated Yichus calculator (or the playground) in the user's default browser with WebMCP enabled (?webmcp=1). After opening, the relay tools below will see the page's tools (yichus_list_inputs, yichus_set_inputs, yichus_list_outputs, yichus_explain_output for calculators; yichus_playground_* for the playground). Use yichus_list_calculators to discover slugs.",
+    annotations: { openWorldHint: true },
+    inputSchemaJson: {
+      type: "object",
+      properties: {
+        slug: {
+          type: "string",
+          description: 'Calculator slug from yichus_list_calculators (for example "loan", "investment", "tax", "playground").'
+        }
+      },
+      required: ["slug"],
+      additionalProperties: false
+    },
+    inputSchemaZod: { slug: z.string() },
+    handler: async (rawArgs) => {
+      const args = z.object({ slug: z.string() }).parse(rawArgs);
+      const calc = findCalculator(args.slug);
+      if (!calc) {
+        const known = listCalculators().map((c) => c.slug).join(", ");
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Unknown calculator slug "${args.slug}". Known slugs: ${known}.`
+            }
+          ],
+          isError: true
+        };
+      }
+      const url = withWebMcpFlag(calculatorUrl(calc, ctx.baseUrl));
+      let opener = null;
+      if (!ctx.disableOpener) {
+        opener = openUrlInBrowser(url);
+      }
+      const payload = {
+        calculator: {
+          slug: calc.slug,
+          title: calc.title,
+          description: calc.description
+        },
+        url,
+        opened: !ctx.disableOpener,
+        opener
+      };
+      return {
+        content: [
+          {
+            type: "text",
+            text: ctx.disableOpener ? `Would open ${calc.title} at ${url} (browser opener disabled).` : `Opening ${calc.title} at ${url}.`
+          }
+        ],
+        structuredContent: payload
+      };
+    }
+  });
+}
+function registerStatic(internal, spec) {
+  const config = {
+    description: spec.description,
+    inputSchema: spec.inputSchemaZod
+  };
+  if (spec.annotations && Object.keys(spec.annotations).length > 0) {
+    config.annotations = spec.annotations;
+  }
+  internal.mcpServer.registerTool(spec.name, config, spec.handler);
+  internal.staticToolData.set(spec.name, {
+    name: spec.name,
+    description: spec.description,
+    inputSchema: spec.inputSchemaJson,
+    ...spec.annotations && Object.keys(spec.annotations).length > 0 ? { annotations: spec.annotations } : {}
+  });
+}
+function normalizeBaseUrl(raw) {
+  return new URL(raw).origin;
+}
+
+// src/cli.ts
+function parseFlags(argv) {
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const next = () => {
+      const value = argv[i + 1];
+      if (value === void 0) {
+        throw new Error(`Missing value for ${arg}`);
+      }
+      i += 1;
+      return value;
+    };
+    switch (arg) {
+      case "--base-url":
+        flags.baseUrl = next();
+        break;
+      case "--host":
+        flags.host = next();
+        break;
+      case "--port": {
+        const value = next();
+        const parsed = Number.parseInt(value, 10);
+        if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+          throw new Error(`Invalid --port value: ${value}`);
+        }
+        flags.port = parsed;
+        break;
+      }
+      case "--label":
+        flags.label = next();
+        break;
+      case "--workspace":
+        flags.workspace = next();
+        break;
+      case "--relay-id":
+        flags.relayId = next();
+        break;
+      case "--help":
+      case "-h":
+        printHelp();
+        process.exit(0);
+      // eslint-disable-next-line no-fallthrough
+      default:
+        throw new Error(`Unknown flag: ${arg}`);
+    }
+  }
+  return flags;
+}
+function printHelp() {
+  process.stdout.write(`yichus-mcp [options]
+
+Yichus MCP server: bundles the WebMCP local relay with two extra static
+tools (yichus_list_calculators, yichus_open_calculator) so an MCP client
+can drive any deployed Yichus calculator end to end.
+
+Options:
+  --base-url     Yichus deployment to talk to (default: https://yich.us).
+                 Used as the relay --widget-origin and as the URL base for
+                 yichus_open_calculator.
+  --host         Bridge bind host (default: 127.0.0.1).
+  --port         Bridge WebSocket port (default: 9333, falls back to 9334+).
+  --label        Human label reported during relay discovery (default: "Yichus").
+  --workspace    Workspace name reported during relay discovery (default: "yichus").
+  --relay-id     Relay id reported during relay discovery (default: "yichus").
+                 Every Yichus page hints the widget workspace "yichus" and
+                 relay id "yichus" and the widget rejects a relay whose
+                 announcement differs, so change these only for a page
+                 built to hint the same values.
+  --help, -h     Show this help.
+
+Add to your MCP client config (Claude Desktop, Cursor, etc.):
+
+  {
+    "mcpServers": {
+      "yichus": {
+        "command": "npx",
+        "args": ["-y", "@yichus/mcp"]
+      }
+    }
+  }
+`);
+}
+async function main() {
+  let flags;
+  try {
+    flags = parseFlags(process.argv.slice(2));
+  } catch (err) {
+    process.stderr.write(`[yichus-mcp] ${err instanceof Error ? err.message : String(err)}
+`);
+    printHelp();
+    process.exit(2);
+  }
+  const server = createYichusMcpServer({
+    baseUrl: flags.baseUrl,
+    bridgeOverrides: {
+      host: flags.host,
+      port: flags.port,
+      label: flags.label,
+      workspace: flags.workspace,
+      relayId: flags.relayId
+    }
+  });
+  const shutdown = async () => {
+    try {
+      await server.stop();
+    } catch (err) {
+      process.stderr.write(
+        `[yichus-mcp] warn: shutdown error: ${err instanceof Error ? err.message : String(err)}
+`
+      );
+    }
+  };
+  process.on("SIGINT", () => {
+    void shutdown().then(() => process.exit(0));
+  });
+  process.on("SIGTERM", () => {
+    void shutdown().then(() => process.exit(0));
+  });
+  await server.start();
+  await server.startStdio();
+}
+main().catch((err) => {
+  process.stderr.write(
+    `[yichus-mcp] fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}
+`
+  );
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/calculators.ts","../src/openUrl.ts","../src/cli.ts"],"sourcesContent":["import { LocalRelayMcpServer } from '@mcp-b/webmcp-local-relay';\nimport { z } from 'zod';\nimport {\n  CALCULATORS,\n  PLAYGROUND,\n  calculatorUrl,\n  findCalculator,\n  listCalculators,\n  withWebMcpFlag,\n  type Calculator,\n} from './calculators.js';\nimport { openUrlInBrowser } from './openUrl.js';\n\nconst PACKAGE_NAME = 'yichus-mcp';\n// Bumped via packages/yichus-mcp/package.json. Kept inline so the bin works\n// without reading package.json from disk at startup.\nconst PACKAGE_VERSION = '0.1.0';\n\nexport interface YichusMcpServerOptions {\n  /**\n   * Origin of the deployed Yichus instance. The relay rejects browser\n   * connections from any other origin and `yichus_open_calculator` builds\n   * URLs against this base.\n   *\n   * @defaultValue `https://yich.us`\n   */\n  baseUrl?: string;\n\n  /**\n   * Override the WebMCP local-relay options that get passed straight through\n   * to the bundled `LocalRelayMcpServer`. Use this to change the bind port,\n   * label, workspace name, or relay id.\n   *\n   * The page-side embed (`web/webmcp-autocomplete.js`, `ensureRelayEmbed`,\n   * and the generated calculator pages) hints the widget a workspace and a\n   * relay id, and the widget refuses any relay whose discovery hello\n   * differs from either. Every shipped page hints `yichus` for both, so the\n   * defaults here are the one agreement; override both sides together.\n   */\n  bridgeOverrides?: {\n    host?: string;\n    port?: number;\n    label?: string;\n    workspace?: string;\n    relayId?: string;\n  };\n\n  /**\n   * If `true`, the `yichus_open_calculator` tool returns the URL it would\n   * have opened without actually launching a browser process. Used by tests\n   * and by anyone running the server in a headless environment.\n   *\n   * @defaultValue `false`\n   */\n  disableOpener?: boolean;\n}\n\n/**\n * Construct a fully-wired Yichus MCP server.\n *\n * The returned `LocalRelayMcpServer` already has every default WebMCP relay\n * tool plus the two yichus-curated tools (`yichus_list_calculators` and\n * `yichus_open_calculator`) registered. Call `start()` then `startStdio()`\n * (or `connect(transport)`) to bring it online.\n */\nexport function createYichusMcpServer(options: YichusMcpServerOptions = {}): LocalRelayMcpServer {\n  const baseUrl = normalizeBaseUrl(options.baseUrl ?? 'https://yich.us');\n  const bridgeOverrides = options.bridgeOverrides ?? {};\n\n  const server = new LocalRelayMcpServer({\n    serverName: PACKAGE_NAME,\n    serverVersion: PACKAGE_VERSION,\n    bridgeOptions: {\n      host: bridgeOverrides.host,\n      port: bridgeOverrides.port,\n      label: bridgeOverrides.label ?? 'Yichus',\n      // The pair every page hints the widget (web/webmcp-autocomplete.js,\n      // the generated calculators); the widget rejects any other hello.\n      workspace: bridgeOverrides.workspace ?? 'yichus',\n      relayId: bridgeOverrides.relayId ?? 'yichus',\n      allowedOrigins: [baseUrl],\n    },\n  });\n\n  registerYichusTools(server, { baseUrl, disableOpener: options.disableOpener ?? false });\n  return server;\n}\n\ninterface RelayInternals {\n  mcpServer: {\n    registerTool: (\n      name: string,\n      config: Record<string, unknown>,\n      handler: (args: unknown) => Promise<unknown> | unknown\n    ) => unknown;\n  };\n  staticToolData: Map<\n    string,\n    {\n      name: string;\n      description?: string;\n      inputSchema: object;\n      annotations?: object;\n    }\n  >;\n}\n\n/**\n * `@mcp-b/webmcp-local-relay@2.2.1` marks `mcpServer` and `staticToolData`\n * as TypeScript-private but the JavaScript fields are public. We pin the\n * relay version exactly so an upstream rename here is a deliberate audit\n * step rather than a silent breakage.\n */\nfunction asInternal(server: LocalRelayMcpServer): RelayInternals {\n  return server as unknown as RelayInternals;\n}\n\nfunction registerYichusTools(\n  server: LocalRelayMcpServer,\n  ctx: { baseUrl: string; disableOpener: boolean }\n): void {\n  const internal = asInternal(server);\n\n  registerStatic(internal, {\n    name: 'yichus_list_calculators',\n    description:\n      'List the curated Yichus calculator demos and the playground editor available on the configured Yichus origin. Returns a slug, title, description, and absolute URL for each.',\n    annotations: { readOnlyHint: true, idempotentHint: true },\n    inputSchemaJson: { type: 'object', properties: {}, additionalProperties: false },\n    inputSchemaZod: {} as z.ZodRawShape,\n    handler: async () => {\n      const entries = listCalculators().map((calc) => ({\n        slug: calc.slug,\n        title: calc.title,\n        description: calc.description,\n        url: calculatorUrl(calc, ctx.baseUrl),\n      }));\n      const payload = { baseUrl: ctx.baseUrl, calculators: entries };\n      return {\n        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],\n        structuredContent: payload,\n      };\n    },\n  });\n\n  registerStatic(internal, {\n    name: 'yichus_open_calculator',\n    description:\n      \"Open a curated Yichus calculator (or the playground) in the user's default browser with WebMCP enabled (?webmcp=1). After opening, the relay tools below will see the page's tools (yichus_list_inputs, yichus_set_inputs, yichus_list_outputs, yichus_explain_output for calculators; yichus_playground_* for the playground). Use yichus_list_calculators to discover slugs.\",\n    annotations: { openWorldHint: true },\n    inputSchemaJson: {\n      type: 'object',\n      properties: {\n        slug: {\n          type: 'string',\n          description:\n            'Calculator slug from yichus_list_calculators (for example \"loan\", \"investment\", \"tax\", \"playground\").',\n        },\n      },\n      required: ['slug'],\n      additionalProperties: false,\n    },\n    inputSchemaZod: { slug: z.string() },\n    handler: async (rawArgs) => {\n      const args = z.object({ slug: z.string() }).parse(rawArgs);\n      const calc: Calculator | undefined = findCalculator(args.slug);\n      if (!calc) {\n        const known = listCalculators().map((c) => c.slug).join(', ');\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Unknown calculator slug \"${args.slug}\". Known slugs: ${known}.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      const url = withWebMcpFlag(calculatorUrl(calc, ctx.baseUrl));\n      let opener: { command: string; args: string[] } | null = null;\n      if (!ctx.disableOpener) {\n        opener = openUrlInBrowser(url);\n      }\n      const payload = {\n        calculator: {\n          slug: calc.slug,\n          title: calc.title,\n          description: calc.description,\n        },\n        url,\n        opened: !ctx.disableOpener,\n        opener,\n      };\n      return {\n        content: [\n          {\n            type: 'text',\n            text: ctx.disableOpener\n              ? `Would open ${calc.title} at ${url} (browser opener disabled).`\n              : `Opening ${calc.title} at ${url}.`,\n          },\n        ],\n        structuredContent: payload,\n      };\n    },\n  });\n}\n\ninterface StaticToolSpec {\n  name: string;\n  description: string;\n  annotations?: Record<string, unknown>;\n  inputSchemaJson: object;\n  inputSchemaZod: z.ZodRawShape;\n  handler: (args: unknown) => Promise<unknown> | unknown;\n}\n\nfunction registerStatic(internal: RelayInternals, spec: StaticToolSpec): void {\n  const config: Record<string, unknown> = {\n    description: spec.description,\n    inputSchema: spec.inputSchemaZod,\n  };\n  if (spec.annotations && Object.keys(spec.annotations).length > 0) {\n    config.annotations = spec.annotations;\n  }\n  internal.mcpServer.registerTool(spec.name, config, spec.handler);\n  internal.staticToolData.set(spec.name, {\n    name: spec.name,\n    description: spec.description,\n    inputSchema: spec.inputSchemaJson,\n    ...(spec.annotations && Object.keys(spec.annotations).length > 0\n      ? { annotations: spec.annotations }\n      : {}),\n  });\n}\n\nfunction normalizeBaseUrl(raw: string): string {\n  // `URL` validates the input and re-serializes to the canonical form.\n  return new URL(raw).origin;\n}\n\nexport const _testing = {\n  CALCULATORS,\n  PLAYGROUND,\n  asInternal,\n};\n","/**\n * Curated catalogue of Yichus simulation demos.\n *\n * GENERATED from deploy/manifest.json by `yichus deploy --emit-calculators`.\n * Do not edit the CALCULATORS array by hand: the manifest row that deploys\n * a calculator is also its catalog entry, so the two cannot drift.\n */\n\nexport interface Calculator {\n  /** Stable short identifier used by `yichus_open_calculator`. */\n  readonly slug: string;\n  /** Human-readable title that matches the page `<title>`. */\n  readonly title: string;\n  /** One-line description suitable for an agent to choose between calculators. */\n  readonly description: string;\n  /** Path under the deploy base URL (no leading slash). */\n  readonly path: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://yich.us';\n\nexport const CALCULATORS: readonly Calculator[] = [\n  {\n    slug: 'event-budget',\n    title: 'Event budget',\n    description: 'Ticket income, event costs, and the amount left over. Change attendance or adapt the cost rules.',\n    path: 'demos/simulation/event-budget.html',\n  },\n  {\n    slug: 'rainwater',\n    title: 'Rainwater tank',\n    description: 'How much water does one rainfall event collect, and how much overflows the tank?',\n    path: 'demos/simulation/rainwater.html',\n  },\n  {\n    slug: 'battery-runtime',\n    title: 'Battery runtime',\n    description: 'Estimate runtime from a battery energy budget, a constant load, and a usable-capacity assumption.',\n    path: 'demos/simulation/battery-runtime.html',\n  },\n  {\n    slug: 'recipe-scale',\n    title: 'Scale a recipe',\n    description: 'Scale ingredient weights to a different number of servings. Replace the ingredients with your own.',\n    path: 'demos/simulation/recipe-scale.html',\n  },\n  {\n    slug: 'download-time',\n    title: 'Download time',\n    description: 'Convert file size and connection speed into transfer time, allowing for a chosen efficiency.',\n    path: 'demos/simulation/download-time.html',\n  },\n  {\n    slug: 'loan',\n    title: 'Loan Calculator',\n    description: 'Fixed monthly payment and total interest for a loan repaid in equal monthly installments.',\n    path: 'demos/simulation/loan-calculator.html',\n  },\n  {\n    slug: 'investment',\n    title: 'Investment Growth Calculator',\n    description: 'Compound growth of a recurring investment under configurable return assumptions.',\n    path: 'demos/simulation/investment.html',\n  },\n  {\n    slug: 'tax',\n    title: 'Tax Calculator',\n    description: 'Flat-rate example: subtract a deduction and apply one percentage. No tax brackets or jurisdiction-specific rules.',\n    path: 'demos/simulation/tax-calculator.html',\n  },\n  {\n    slug: 'carbon',\n    title: 'Carbon Footprint Calculator',\n    description: 'Illustrative annual CO2 totals from driving, flights, electricity, and gas, using fixed emission factors.',\n    path: 'demos/simulation/carbon-footprint.html',\n  },\n  {\n    slug: 'rate',\n    title: 'Rate Calculator',\n    description: 'Apply a basis-point rate to an amount, then subtract a percentage fee. Inspect both helper calculations in Why.',\n    path: 'demos/simulation/rate-calculator.html',\n  },\n  {\n    slug: 'compound-fold',\n    title: 'CompoundFold',\n    description: 'Compound a starting amount over several periods, increasing the rate by 0.1 percentage points each period.',\n    path: 'demos/simulation/compound-fold.html',\n  },\n  {\n    slug: 'closure-capture',\n    title: 'ClosureCapture',\n    description: 'Scale two amounts with the same input rate captured by a shared inner function.',\n    path: 'demos/simulation/closure-capture.html',\n  },\n  {\n    slug: 'lambda-factory',\n    title: 'Fee pipeline',\n    description: 'Apply processing, platform, and regulatory fees in sequence, with each helper capturing its chosen rate.',\n    path: 'demos/simulation/lambda-factory-selector.html',\n  },\n  {\n    slug: 'portfolio',\n    title: 'Three growth rates',\n    description: 'Split an amount into three equal parts and apply a chosen growth rate to each. This example does not estimate risk.',\n    path: 'demos/simulation/portfolio-analysis.html',\n  },\n  {\n    slug: 'strategy-portfolio',\n    title: 'Choosing a growth multiplier',\n    description: 'Choose between three illustrative growth multipliers. This is a branching example, not an investment-risk model.',\n    path: 'demos/simulation/strategy-portfolio.html',\n  },\n  {\n    slug: 'tiered-policy',\n    title: 'Claim payout rules',\n    description: 'A toy claim payout: choose an incident severity and policy tier, then inspect the adjustments and deduction.',\n    path: 'demos/simulation/tiered-policy-engine.html',\n  },\n  {\n    slug: 'what-if-path-switch',\n    title: 'WhatIfPathSwitch',\n    description: 'Switches computation paths via assumption toggles (\"what-if\" branches).',\n    path: 'demos/simulation/what-if-path-switch.html',\n  },\n  {\n    slug: 'deadweight_loss',\n    title: 'Deadweight Loss Calculator',\n    description: 'Equilibrium, surplus, and deadweight loss of a per-unit tax on a linear market.',\n    path: 'demos/simulation/deadweight-loss.html',\n  },\n  {\n    slug: 'trend_projection',\n    title: 'Vintage Forecasts',\n    description: 'An illustrative series with synthetic forecast vintages. Compare compounding assumptions; these are model-generated values, not agency data.',\n    path: 'demos/simulation/trend-projection.html',\n  },\n  {\n    slug: 'carbon_abatement',\n    title: 'Carbon Abatement Path',\n    description: 'A rising marginal abatement cost path as a sampled curve, with derived cheapest-step and tranche-cost marks.',\n    path: 'demos/simulation/carbon-abatement.html',\n  },\n] as const;\n\nexport const PLAYGROUND: Calculator = {\n  slug: 'playground',\n  title: 'Yichus Bosatsu Playground',\n  description: 'In-browser editor for Bosatsu simulations with live compile and Why explainer.',\n  path: 'editor.html',\n} as const;\n\n/** Look up a curated calculator by its slug, including the playground. */\nexport function findCalculator(slug: string): Calculator | undefined {\n  if (slug === PLAYGROUND.slug) return PLAYGROUND;\n  return CALCULATORS.find((calc) => calc.slug === slug);\n}\n\n/** Returns every entry exposed by `yichus_list_calculators`. */\nexport function listCalculators(): readonly Calculator[] {\n  return [...CALCULATORS, PLAYGROUND];\n}\n\n/** Build the full URL for a calculator at the given base. */\nexport function calculatorUrl(calc: Calculator, baseUrl = DEFAULT_BASE_URL): string {\n  const base = new URL(baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`);\n  return new URL(calc.path, base).toString();\n}\n\n/**\n * Force `?webmcp=1` on a URL so the page loads the WebMCP relay embed.\n *\n * Pages generated by `SimulationGenerator` and `web/editor.html` only inject\n * the relay embed when this flag (or `localStorage.yichus_webmcp = \"on\"`) is\n * present, so an agent that opens a calculator must set it.\n */\nexport function withWebMcpFlag(rawUrl: string): string {\n  const url = new URL(rawUrl);\n  url.searchParams.set('webmcp', '1');\n  return url.toString();\n}\n","import { spawn } from 'node:child_process';\n\n/**\n * Opens a URL in the user's default browser.\n *\n * Uses `URL.href` so shell metacharacters in the original string are escaped\n * before they reach the platform opener. Mirrors the approach the upstream\n * `webmcp-local-relay` `webmcp_open_page` tool uses.\n */\nexport function openUrlInBrowser(rawUrl: string): { command: string; args: string[] } {\n  const validated = new URL(rawUrl).href;\n  const platform = process.platform;\n\n  let command: string;\n  let args: string[];\n  if (platform === 'darwin') {\n    command = 'open';\n    args = [validated];\n  } else if (platform === 'win32') {\n    command = 'powershell';\n    args = ['-NoProfile', '-NonInteractive', '-Command', `Start-Process '${validated.replace(/'/g, \"''\")}'`];\n  } else {\n    command = 'xdg-open';\n    args = [validated];\n  }\n\n  spawn(command, args, { detached: true, stdio: 'ignore' }).unref();\n  return { command, args };\n}\n","#!/usr/bin/env node\nimport { createYichusMcpServer } from './server.js';\n\ninterface ParsedFlags {\n  baseUrl?: string;\n  port?: number;\n  host?: string;\n  label?: string;\n  workspace?: string;\n  relayId?: string;\n}\n\nfunction parseFlags(argv: string[]): ParsedFlags {\n  const flags: ParsedFlags = {};\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    const next = (): string => {\n      const value = argv[i + 1];\n      if (value === undefined) {\n        throw new Error(`Missing value for ${arg}`);\n      }\n      i += 1;\n      return value;\n    };\n    switch (arg) {\n      case '--base-url':\n        flags.baseUrl = next();\n        break;\n      case '--host':\n        flags.host = next();\n        break;\n      case '--port': {\n        const value = next();\n        const parsed = Number.parseInt(value, 10);\n        if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {\n          throw new Error(`Invalid --port value: ${value}`);\n        }\n        flags.port = parsed;\n        break;\n      }\n      case '--label':\n        flags.label = next();\n        break;\n      case '--workspace':\n        flags.workspace = next();\n        break;\n      case '--relay-id':\n        flags.relayId = next();\n        break;\n      case '--help':\n      case '-h':\n        printHelp();\n        process.exit(0);\n      // eslint-disable-next-line no-fallthrough\n      default:\n        throw new Error(`Unknown flag: ${arg}`);\n    }\n  }\n  return flags;\n}\n\nfunction printHelp(): void {\n  process.stdout.write(`yichus-mcp [options]\n\nYichus MCP server: bundles the WebMCP local relay with two extra static\ntools (yichus_list_calculators, yichus_open_calculator) so an MCP client\ncan drive any deployed Yichus calculator end to end.\n\nOptions:\n  --base-url     Yichus deployment to talk to (default: https://yich.us).\n                 Used as the relay --widget-origin and as the URL base for\n                 yichus_open_calculator.\n  --host         Bridge bind host (default: 127.0.0.1).\n  --port         Bridge WebSocket port (default: 9333, falls back to 9334+).\n  --label        Human label reported during relay discovery (default: \"Yichus\").\n  --workspace    Workspace name reported during relay discovery (default: \"yichus\").\n  --relay-id     Relay id reported during relay discovery (default: \"yichus\").\n                 Every Yichus page hints the widget workspace \"yichus\" and\n                 relay id \"yichus\" and the widget rejects a relay whose\n                 announcement differs, so change these only for a page\n                 built to hint the same values.\n  --help, -h     Show this help.\n\nAdd to your MCP client config (Claude Desktop, Cursor, etc.):\n\n  {\n    \"mcpServers\": {\n      \"yichus\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@yichus/mcp\"]\n      }\n    }\n  }\n`);\n}\n\nasync function main(): Promise<void> {\n  let flags: ParsedFlags;\n  try {\n    flags = parseFlags(process.argv.slice(2));\n  } catch (err) {\n    process.stderr.write(`[yichus-mcp] ${err instanceof Error ? err.message : String(err)}\\n`);\n    printHelp();\n    process.exit(2);\n  }\n\n  const server = createYichusMcpServer({\n    baseUrl: flags.baseUrl,\n    bridgeOverrides: {\n      host: flags.host,\n      port: flags.port,\n      label: flags.label,\n      workspace: flags.workspace,\n      relayId: flags.relayId,\n    },\n  });\n\n  const shutdown = async (): Promise<void> => {\n    try {\n      await server.stop();\n    } catch (err) {\n      process.stderr.write(\n        `[yichus-mcp] warn: shutdown error: ${err instanceof Error ? err.message : String(err)}\\n`\n      );\n    }\n  };\n  process.on('SIGINT', () => {\n    void shutdown().then(() => process.exit(0));\n  });\n  process.on('SIGTERM', () => {\n    void shutdown().then(() => process.exit(0));\n  });\n\n  await server.start();\n  await server.startStdio();\n}\n\nmain().catch((err) => {\n  process.stderr.write(\n    `[yichus-mcp] fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}\\n`\n  );\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+import { LocalRelayMcpServer } from '@mcp-b/webmcp-local-relay';
+
+/**
+ * Curated catalogue of Yichus simulation demos.
+ *
+ * GENERATED from deploy/manifest.json by `yichus deploy --emit-calculators`.
+ * Do not edit the CALCULATORS array by hand: the manifest row that deploys
+ * a calculator is also its catalog entry, so the two cannot drift.
+ */
+interface Calculator {
+    /** Stable short identifier used by `yichus_open_calculator`. */
+    readonly slug: string;
+    /** Human-readable title that matches the page `<title>`. */
+    readonly title: string;
+    /** One-line description suitable for an agent to choose between calculators. */
+    readonly description: string;
+    /** Path under the deploy base URL (no leading slash). */
+    readonly path: string;
+}
+declare const CALCULATORS: readonly Calculator[];
+declare const PLAYGROUND: Calculator;
+/** Look up a curated calculator by its slug, including the playground. */
+declare function findCalculator(slug: string): Calculator | undefined;
+/** Returns every entry exposed by `yichus_list_calculators`. */
+declare function listCalculators(): readonly Calculator[];
+/** Build the full URL for a calculator at the given base. */
+declare function calculatorUrl(calc: Calculator, baseUrl?: string): string;
+/**
+ * Force `?webmcp=1` on a URL so the page loads the WebMCP relay embed.
+ *
+ * Pages generated by `SimulationGenerator` and `web/editor.html` only inject
+ * the relay embed when this flag (or `localStorage.yichus_webmcp = "on"`) is
+ * present, so an agent that opens a calculator must set it.
+ */
+declare function withWebMcpFlag(rawUrl: string): string;
+
+interface YichusMcpServerOptions {
+    /**
+     * Origin of the deployed Yichus instance. The relay rejects browser
+     * connections from any other origin and `yichus_open_calculator` builds
+     * URLs against this base.
+     *
+     * @defaultValue `https://yich.us`
+     */
+    baseUrl?: string;
+    /**
+     * Override the WebMCP local-relay options that get passed straight through
+     * to the bundled `LocalRelayMcpServer`. Use this to change the bind port,
+     * label, workspace name, or relay id.
+     *
+     * The page-side embed (`web/webmcp-autocomplete.js`, `ensureRelayEmbed`,
+     * and the generated calculator pages) hints the widget a workspace and a
+     * relay id, and the widget refuses any relay whose discovery hello
+     * differs from either. Every shipped page hints `yichus` for both, so the
+     * defaults here are the one agreement; override both sides together.
+     */
+    bridgeOverrides?: {
+        host?: string;
+        port?: number;
+        label?: string;
+        workspace?: string;
+        relayId?: string;
+    };
+    /**
+     * If `true`, the `yichus_open_calculator` tool returns the URL it would
+     * have opened without actually launching a browser process. Used by tests
+     * and by anyone running the server in a headless environment.
+     *
+     * @defaultValue `false`
+     */
+    disableOpener?: boolean;
+}
+/**
+ * Construct a fully-wired Yichus MCP server.
+ *
+ * The returned `LocalRelayMcpServer` already has every default WebMCP relay
+ * tool plus the two yichus-curated tools (`yichus_list_calculators` and
+ * `yichus_open_calculator`) registered. Call `start()` then `startStdio()`
+ * (or `connect(transport)`) to bring it online.
+ */
+declare function createYichusMcpServer(options?: YichusMcpServerOptions): LocalRelayMcpServer;
+
+/**
+ * Opens a URL in the user's default browser.
+ *
+ * Uses `URL.href` so shell metacharacters in the original string are escaped
+ * before they reach the platform opener. Mirrors the approach the upstream
+ * `webmcp-local-relay` `webmcp_open_page` tool uses.
+ */
+declare function openUrlInBrowser(rawUrl: string): {
+    command: string;
+    args: string[];
+};
+
+export { CALCULATORS, type Calculator, PLAYGROUND, type YichusMcpServerOptions, calculatorUrl, createYichusMcpServer, findCalculator, listCalculators, openUrlInBrowser, withWebMcpFlag };

package/dist/index.js

@@ -0,0 +1,308 @@
+// src/server.ts
+import { LocalRelayMcpServer } from "@mcp-b/webmcp-local-relay";
+import { z } from "zod";
+
+// src/calculators.ts
+var DEFAULT_BASE_URL = "https://yich.us";
+var CALCULATORS = [
+  {
+    slug: "event-budget",
+    title: "Event budget",
+    description: "Ticket income, event costs, and the amount left over. Change attendance or adapt the cost rules.",
+    path: "demos/simulation/event-budget.html"
+  },
+  {
+    slug: "rainwater",
+    title: "Rainwater tank",
+    description: "How much water does one rainfall event collect, and how much overflows the tank?",
+    path: "demos/simulation/rainwater.html"
+  },
+  {
+    slug: "battery-runtime",
+    title: "Battery runtime",
+    description: "Estimate runtime from a battery energy budget, a constant load, and a usable-capacity assumption.",
+    path: "demos/simulation/battery-runtime.html"
+  },
+  {
+    slug: "recipe-scale",
+    title: "Scale a recipe",
+    description: "Scale ingredient weights to a different number of servings. Replace the ingredients with your own.",
+    path: "demos/simulation/recipe-scale.html"
+  },
+  {
+    slug: "download-time",
+    title: "Download time",
+    description: "Convert file size and connection speed into transfer time, allowing for a chosen efficiency.",
+    path: "demos/simulation/download-time.html"
+  },
+  {
+    slug: "loan",
+    title: "Loan Calculator",
+    description: "Fixed monthly payment and total interest for a loan repaid in equal monthly installments.",
+    path: "demos/simulation/loan-calculator.html"
+  },
+  {
+    slug: "investment",
+    title: "Investment Growth Calculator",
+    description: "Compound growth of a recurring investment under configurable return assumptions.",
+    path: "demos/simulation/investment.html"
+  },
+  {
+    slug: "tax",
+    title: "Tax Calculator",
+    description: "Flat-rate example: subtract a deduction and apply one percentage. No tax brackets or jurisdiction-specific rules.",
+    path: "demos/simulation/tax-calculator.html"
+  },
+  {
+    slug: "carbon",
+    title: "Carbon Footprint Calculator",
+    description: "Illustrative annual CO2 totals from driving, flights, electricity, and gas, using fixed emission factors.",
+    path: "demos/simulation/carbon-footprint.html"
+  },
+  {
+    slug: "rate",
+    title: "Rate Calculator",
+    description: "Apply a basis-point rate to an amount, then subtract a percentage fee. Inspect both helper calculations in Why.",
+    path: "demos/simulation/rate-calculator.html"
+  },
+  {
+    slug: "compound-fold",
+    title: "CompoundFold",
+    description: "Compound a starting amount over several periods, increasing the rate by 0.1 percentage points each period.",
+    path: "demos/simulation/compound-fold.html"
+  },
+  {
+    slug: "closure-capture",
+    title: "ClosureCapture",
+    description: "Scale two amounts with the same input rate captured by a shared inner function.",
+    path: "demos/simulation/closure-capture.html"
+  },
+  {
+    slug: "lambda-factory",
+    title: "Fee pipeline",
+    description: "Apply processing, platform, and regulatory fees in sequence, with each helper capturing its chosen rate.",
+    path: "demos/simulation/lambda-factory-selector.html"
+  },
+  {
+    slug: "portfolio",
+    title: "Three growth rates",
+    description: "Split an amount into three equal parts and apply a chosen growth rate to each. This example does not estimate risk.",
+    path: "demos/simulation/portfolio-analysis.html"
+  },
+  {
+    slug: "strategy-portfolio",
+    title: "Choosing a growth multiplier",
+    description: "Choose between three illustrative growth multipliers. This is a branching example, not an investment-risk model.",
+    path: "demos/simulation/strategy-portfolio.html"
+  },
+  {
+    slug: "tiered-policy",
+    title: "Claim payout rules",
+    description: "A toy claim payout: choose an incident severity and policy tier, then inspect the adjustments and deduction.",
+    path: "demos/simulation/tiered-policy-engine.html"
+  },
+  {
+    slug: "what-if-path-switch",
+    title: "WhatIfPathSwitch",
+    description: 'Switches computation paths via assumption toggles ("what-if" branches).',
+    path: "demos/simulation/what-if-path-switch.html"
+  },
+  {
+    slug: "deadweight_loss",
+    title: "Deadweight Loss Calculator",
+    description: "Equilibrium, surplus, and deadweight loss of a per-unit tax on a linear market.",
+    path: "demos/simulation/deadweight-loss.html"
+  },
+  {
+    slug: "trend_projection",
+    title: "Vintage Forecasts",
+    description: "An illustrative series with synthetic forecast vintages. Compare compounding assumptions; these are model-generated values, not agency data.",
+    path: "demos/simulation/trend-projection.html"
+  },
+  {
+    slug: "carbon_abatement",
+    title: "Carbon Abatement Path",
+    description: "A rising marginal abatement cost path as a sampled curve, with derived cheapest-step and tranche-cost marks.",
+    path: "demos/simulation/carbon-abatement.html"
+  }
+];
+var PLAYGROUND = {
+  slug: "playground",
+  title: "Yichus Bosatsu Playground",
+  description: "In-browser editor for Bosatsu simulations with live compile and Why explainer.",
+  path: "editor.html"
+};
+function findCalculator(slug) {
+  if (slug === PLAYGROUND.slug) return PLAYGROUND;
+  return CALCULATORS.find((calc) => calc.slug === slug);
+}
+function listCalculators() {
+  return [...CALCULATORS, PLAYGROUND];
+}
+function calculatorUrl(calc, baseUrl = DEFAULT_BASE_URL) {
+  const base = new URL(baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`);
+  return new URL(calc.path, base).toString();
+}
+function withWebMcpFlag(rawUrl) {
+  const url = new URL(rawUrl);
+  url.searchParams.set("webmcp", "1");
+  return url.toString();
+}
+
+// src/openUrl.ts
+import { spawn } from "child_process";
+function openUrlInBrowser(rawUrl) {
+  const validated = new URL(rawUrl).href;
+  const platform = process.platform;
+  let command;
+  let args;
+  if (platform === "darwin") {
+    command = "open";
+    args = [validated];
+  } else if (platform === "win32") {
+    command = "powershell";
+    args = ["-NoProfile", "-NonInteractive", "-Command", `Start-Process '${validated.replace(/'/g, "''")}'`];
+  } else {
+    command = "xdg-open";
+    args = [validated];
+  }
+  spawn(command, args, { detached: true, stdio: "ignore" }).unref();
+  return { command, args };
+}
+
+// src/server.ts
+var PACKAGE_NAME = "yichus-mcp";
+var PACKAGE_VERSION = "0.1.0";
+function createYichusMcpServer(options = {}) {
+  const baseUrl = normalizeBaseUrl(options.baseUrl ?? "https://yich.us");
+  const bridgeOverrides = options.bridgeOverrides ?? {};
+  const server = new LocalRelayMcpServer({
+    serverName: PACKAGE_NAME,
+    serverVersion: PACKAGE_VERSION,
+    bridgeOptions: {
+      host: bridgeOverrides.host,
+      port: bridgeOverrides.port,
+      label: bridgeOverrides.label ?? "Yichus",
+      // The pair every page hints the widget (web/webmcp-autocomplete.js,
+      // the generated calculators); the widget rejects any other hello.
+      workspace: bridgeOverrides.workspace ?? "yichus",
+      relayId: bridgeOverrides.relayId ?? "yichus",
+      allowedOrigins: [baseUrl]
+    }
+  });
+  registerYichusTools(server, { baseUrl, disableOpener: options.disableOpener ?? false });
+  return server;
+}
+function asInternal(server) {
+  return server;
+}
+function registerYichusTools(server, ctx) {
+  const internal = asInternal(server);
+  registerStatic(internal, {
+    name: "yichus_list_calculators",
+    description: "List the curated Yichus calculator demos and the playground editor available on the configured Yichus origin. Returns a slug, title, description, and absolute URL for each.",
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    inputSchemaJson: { type: "object", properties: {}, additionalProperties: false },
+    inputSchemaZod: {},
+    handler: async () => {
+      const entries = listCalculators().map((calc) => ({
+        slug: calc.slug,
+        title: calc.title,
+        description: calc.description,
+        url: calculatorUrl(calc, ctx.baseUrl)
+      }));
+      const payload = { baseUrl: ctx.baseUrl, calculators: entries };
+      return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload
+      };
+    }
+  });
+  registerStatic(internal, {
+    name: "yichus_open_calculator",
+    description: "Open a curated Yichus calculator (or the playground) in the user's default browser with WebMCP enabled (?webmcp=1). After opening, the relay tools below will see the page's tools (yichus_list_inputs, yichus_set_inputs, yichus_list_outputs, yichus_explain_output for calculators; yichus_playground_* for the playground). Use yichus_list_calculators to discover slugs.",
+    annotations: { openWorldHint: true },
+    inputSchemaJson: {
+      type: "object",
+      properties: {
+        slug: {
+          type: "string",
+          description: 'Calculator slug from yichus_list_calculators (for example "loan", "investment", "tax", "playground").'
+        }
+      },
+      required: ["slug"],
+      additionalProperties: false
+    },
+    inputSchemaZod: { slug: z.string() },
+    handler: async (rawArgs) => {
+      const args = z.object({ slug: z.string() }).parse(rawArgs);
+      const calc = findCalculator(args.slug);
+      if (!calc) {
+        const known = listCalculators().map((c) => c.slug).join(", ");
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Unknown calculator slug "${args.slug}". Known slugs: ${known}.`
+            }
+          ],
+          isError: true
+        };
+      }
+      const url = withWebMcpFlag(calculatorUrl(calc, ctx.baseUrl));
+      let opener = null;
+      if (!ctx.disableOpener) {
+        opener = openUrlInBrowser(url);
+      }
+      const payload = {
+        calculator: {
+          slug: calc.slug,
+          title: calc.title,
+          description: calc.description
+        },
+        url,
+        opened: !ctx.disableOpener,
+        opener
+      };
+      return {
+        content: [
+          {
+            type: "text",
+            text: ctx.disableOpener ? `Would open ${calc.title} at ${url} (browser opener disabled).` : `Opening ${calc.title} at ${url}.`
+          }
+        ],
+        structuredContent: payload
+      };
+    }
+  });
+}
+function registerStatic(internal, spec) {
+  const config = {
+    description: spec.description,
+    inputSchema: spec.inputSchemaZod
+  };
+  if (spec.annotations && Object.keys(spec.annotations).length > 0) {
+    config.annotations = spec.annotations;
+  }
+  internal.mcpServer.registerTool(spec.name, config, spec.handler);
+  internal.staticToolData.set(spec.name, {
+    name: spec.name,
+    description: spec.description,
+    inputSchema: spec.inputSchemaJson,
+    ...spec.annotations && Object.keys(spec.annotations).length > 0 ? { annotations: spec.annotations } : {}
+  });
+}
+function normalizeBaseUrl(raw) {
+  return new URL(raw).origin;
+}
+export {
+  CALCULATORS,
+  PLAYGROUND,
+  calculatorUrl,
+  createYichusMcpServer,
+  findCalculator,
+  listCalculators,
+  openUrlInBrowser,
+  withWebMcpFlag
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/calculators.ts","../src/openUrl.ts"],"sourcesContent":["import { LocalRelayMcpServer } from '@mcp-b/webmcp-local-relay';\nimport { z } from 'zod';\nimport {\n  CALCULATORS,\n  PLAYGROUND,\n  calculatorUrl,\n  findCalculator,\n  listCalculators,\n  withWebMcpFlag,\n  type Calculator,\n} from './calculators.js';\nimport { openUrlInBrowser } from './openUrl.js';\n\nconst PACKAGE_NAME = 'yichus-mcp';\n// Bumped via packages/yichus-mcp/package.json. Kept inline so the bin works\n// without reading package.json from disk at startup.\nconst PACKAGE_VERSION = '0.1.0';\n\nexport interface YichusMcpServerOptions {\n  /**\n   * Origin of the deployed Yichus instance. The relay rejects browser\n   * connections from any other origin and `yichus_open_calculator` builds\n   * URLs against this base.\n   *\n   * @defaultValue `https://yich.us`\n   */\n  baseUrl?: string;\n\n  /**\n   * Override the WebMCP local-relay options that get passed straight through\n   * to the bundled `LocalRelayMcpServer`. Use this to change the bind port,\n   * label, workspace name, or relay id.\n   *\n   * The page-side embed (`web/webmcp-autocomplete.js`, `ensureRelayEmbed`,\n   * and the generated calculator pages) hints the widget a workspace and a\n   * relay id, and the widget refuses any relay whose discovery hello\n   * differs from either. Every shipped page hints `yichus` for both, so the\n   * defaults here are the one agreement; override both sides together.\n   */\n  bridgeOverrides?: {\n    host?: string;\n    port?: number;\n    label?: string;\n    workspace?: string;\n    relayId?: string;\n  };\n\n  /**\n   * If `true`, the `yichus_open_calculator` tool returns the URL it would\n   * have opened without actually launching a browser process. Used by tests\n   * and by anyone running the server in a headless environment.\n   *\n   * @defaultValue `false`\n   */\n  disableOpener?: boolean;\n}\n\n/**\n * Construct a fully-wired Yichus MCP server.\n *\n * The returned `LocalRelayMcpServer` already has every default WebMCP relay\n * tool plus the two yichus-curated tools (`yichus_list_calculators` and\n * `yichus_open_calculator`) registered. Call `start()` then `startStdio()`\n * (or `connect(transport)`) to bring it online.\n */\nexport function createYichusMcpServer(options: YichusMcpServerOptions = {}): LocalRelayMcpServer {\n  const baseUrl = normalizeBaseUrl(options.baseUrl ?? 'https://yich.us');\n  const bridgeOverrides = options.bridgeOverrides ?? {};\n\n  const server = new LocalRelayMcpServer({\n    serverName: PACKAGE_NAME,\n    serverVersion: PACKAGE_VERSION,\n    bridgeOptions: {\n      host: bridgeOverrides.host,\n      port: bridgeOverrides.port,\n      label: bridgeOverrides.label ?? 'Yichus',\n      // The pair every page hints the widget (web/webmcp-autocomplete.js,\n      // the generated calculators); the widget rejects any other hello.\n      workspace: bridgeOverrides.workspace ?? 'yichus',\n      relayId: bridgeOverrides.relayId ?? 'yichus',\n      allowedOrigins: [baseUrl],\n    },\n  });\n\n  registerYichusTools(server, { baseUrl, disableOpener: options.disableOpener ?? false });\n  return server;\n}\n\ninterface RelayInternals {\n  mcpServer: {\n    registerTool: (\n      name: string,\n      config: Record<string, unknown>,\n      handler: (args: unknown) => Promise<unknown> | unknown\n    ) => unknown;\n  };\n  staticToolData: Map<\n    string,\n    {\n      name: string;\n      description?: string;\n      inputSchema: object;\n      annotations?: object;\n    }\n  >;\n}\n\n/**\n * `@mcp-b/webmcp-local-relay@2.2.1` marks `mcpServer` and `staticToolData`\n * as TypeScript-private but the JavaScript fields are public. We pin the\n * relay version exactly so an upstream rename here is a deliberate audit\n * step rather than a silent breakage.\n */\nfunction asInternal(server: LocalRelayMcpServer): RelayInternals {\n  return server as unknown as RelayInternals;\n}\n\nfunction registerYichusTools(\n  server: LocalRelayMcpServer,\n  ctx: { baseUrl: string; disableOpener: boolean }\n): void {\n  const internal = asInternal(server);\n\n  registerStatic(internal, {\n    name: 'yichus_list_calculators',\n    description:\n      'List the curated Yichus calculator demos and the playground editor available on the configured Yichus origin. Returns a slug, title, description, and absolute URL for each.',\n    annotations: { readOnlyHint: true, idempotentHint: true },\n    inputSchemaJson: { type: 'object', properties: {}, additionalProperties: false },\n    inputSchemaZod: {} as z.ZodRawShape,\n    handler: async () => {\n      const entries = listCalculators().map((calc) => ({\n        slug: calc.slug,\n        title: calc.title,\n        description: calc.description,\n        url: calculatorUrl(calc, ctx.baseUrl),\n      }));\n      const payload = { baseUrl: ctx.baseUrl, calculators: entries };\n      return {\n        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],\n        structuredContent: payload,\n      };\n    },\n  });\n\n  registerStatic(internal, {\n    name: 'yichus_open_calculator',\n    description:\n      \"Open a curated Yichus calculator (or the playground) in the user's default browser with WebMCP enabled (?webmcp=1). After opening, the relay tools below will see the page's tools (yichus_list_inputs, yichus_set_inputs, yichus_list_outputs, yichus_explain_output for calculators; yichus_playground_* for the playground). Use yichus_list_calculators to discover slugs.\",\n    annotations: { openWorldHint: true },\n    inputSchemaJson: {\n      type: 'object',\n      properties: {\n        slug: {\n          type: 'string',\n          description:\n            'Calculator slug from yichus_list_calculators (for example \"loan\", \"investment\", \"tax\", \"playground\").',\n        },\n      },\n      required: ['slug'],\n      additionalProperties: false,\n    },\n    inputSchemaZod: { slug: z.string() },\n    handler: async (rawArgs) => {\n      const args = z.object({ slug: z.string() }).parse(rawArgs);\n      const calc: Calculator | undefined = findCalculator(args.slug);\n      if (!calc) {\n        const known = listCalculators().map((c) => c.slug).join(', ');\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Unknown calculator slug \"${args.slug}\". Known slugs: ${known}.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      const url = withWebMcpFlag(calculatorUrl(calc, ctx.baseUrl));\n      let opener: { command: string; args: string[] } | null = null;\n      if (!ctx.disableOpener) {\n        opener = openUrlInBrowser(url);\n      }\n      const payload = {\n        calculator: {\n          slug: calc.slug,\n          title: calc.title,\n          description: calc.description,\n        },\n        url,\n        opened: !ctx.disableOpener,\n        opener,\n      };\n      return {\n        content: [\n          {\n            type: 'text',\n            text: ctx.disableOpener\n              ? `Would open ${calc.title} at ${url} (browser opener disabled).`\n              : `Opening ${calc.title} at ${url}.`,\n          },\n        ],\n        structuredContent: payload,\n      };\n    },\n  });\n}\n\ninterface StaticToolSpec {\n  name: string;\n  description: string;\n  annotations?: Record<string, unknown>;\n  inputSchemaJson: object;\n  inputSchemaZod: z.ZodRawShape;\n  handler: (args: unknown) => Promise<unknown> | unknown;\n}\n\nfunction registerStatic(internal: RelayInternals, spec: StaticToolSpec): void {\n  const config: Record<string, unknown> = {\n    description: spec.description,\n    inputSchema: spec.inputSchemaZod,\n  };\n  if (spec.annotations && Object.keys(spec.annotations).length > 0) {\n    config.annotations = spec.annotations;\n  }\n  internal.mcpServer.registerTool(spec.name, config, spec.handler);\n  internal.staticToolData.set(spec.name, {\n    name: spec.name,\n    description: spec.description,\n    inputSchema: spec.inputSchemaJson,\n    ...(spec.annotations && Object.keys(spec.annotations).length > 0\n      ? { annotations: spec.annotations }\n      : {}),\n  });\n}\n\nfunction normalizeBaseUrl(raw: string): string {\n  // `URL` validates the input and re-serializes to the canonical form.\n  return new URL(raw).origin;\n}\n\nexport const _testing = {\n  CALCULATORS,\n  PLAYGROUND,\n  asInternal,\n};\n","/**\n * Curated catalogue of Yichus simulation demos.\n *\n * GENERATED from deploy/manifest.json by `yichus deploy --emit-calculators`.\n * Do not edit the CALCULATORS array by hand: the manifest row that deploys\n * a calculator is also its catalog entry, so the two cannot drift.\n */\n\nexport interface Calculator {\n  /** Stable short identifier used by `yichus_open_calculator`. */\n  readonly slug: string;\n  /** Human-readable title that matches the page `<title>`. */\n  readonly title: string;\n  /** One-line description suitable for an agent to choose between calculators. */\n  readonly description: string;\n  /** Path under the deploy base URL (no leading slash). */\n  readonly path: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://yich.us';\n\nexport const CALCULATORS: readonly Calculator[] = [\n  {\n    slug: 'event-budget',\n    title: 'Event budget',\n    description: 'Ticket income, event costs, and the amount left over. Change attendance or adapt the cost rules.',\n    path: 'demos/simulation/event-budget.html',\n  },\n  {\n    slug: 'rainwater',\n    title: 'Rainwater tank',\n    description: 'How much water does one rainfall event collect, and how much overflows the tank?',\n    path: 'demos/simulation/rainwater.html',\n  },\n  {\n    slug: 'battery-runtime',\n    title: 'Battery runtime',\n    description: 'Estimate runtime from a battery energy budget, a constant load, and a usable-capacity assumption.',\n    path: 'demos/simulation/battery-runtime.html',\n  },\n  {\n    slug: 'recipe-scale',\n    title: 'Scale a recipe',\n    description: 'Scale ingredient weights to a different number of servings. Replace the ingredients with your own.',\n    path: 'demos/simulation/recipe-scale.html',\n  },\n  {\n    slug: 'download-time',\n    title: 'Download time',\n    description: 'Convert file size and connection speed into transfer time, allowing for a chosen efficiency.',\n    path: 'demos/simulation/download-time.html',\n  },\n  {\n    slug: 'loan',\n    title: 'Loan Calculator',\n    description: 'Fixed monthly payment and total interest for a loan repaid in equal monthly installments.',\n    path: 'demos/simulation/loan-calculator.html',\n  },\n  {\n    slug: 'investment',\n    title: 'Investment Growth Calculator',\n    description: 'Compound growth of a recurring investment under configurable return assumptions.',\n    path: 'demos/simulation/investment.html',\n  },\n  {\n    slug: 'tax',\n    title: 'Tax Calculator',\n    description: 'Flat-rate example: subtract a deduction and apply one percentage. No tax brackets or jurisdiction-specific rules.',\n    path: 'demos/simulation/tax-calculator.html',\n  },\n  {\n    slug: 'carbon',\n    title: 'Carbon Footprint Calculator',\n    description: 'Illustrative annual CO2 totals from driving, flights, electricity, and gas, using fixed emission factors.',\n    path: 'demos/simulation/carbon-footprint.html',\n  },\n  {\n    slug: 'rate',\n    title: 'Rate Calculator',\n    description: 'Apply a basis-point rate to an amount, then subtract a percentage fee. Inspect both helper calculations in Why.',\n    path: 'demos/simulation/rate-calculator.html',\n  },\n  {\n    slug: 'compound-fold',\n    title: 'CompoundFold',\n    description: 'Compound a starting amount over several periods, increasing the rate by 0.1 percentage points each period.',\n    path: 'demos/simulation/compound-fold.html',\n  },\n  {\n    slug: 'closure-capture',\n    title: 'ClosureCapture',\n    description: 'Scale two amounts with the same input rate captured by a shared inner function.',\n    path: 'demos/simulation/closure-capture.html',\n  },\n  {\n    slug: 'lambda-factory',\n    title: 'Fee pipeline',\n    description: 'Apply processing, platform, and regulatory fees in sequence, with each helper capturing its chosen rate.',\n    path: 'demos/simulation/lambda-factory-selector.html',\n  },\n  {\n    slug: 'portfolio',\n    title: 'Three growth rates',\n    description: 'Split an amount into three equal parts and apply a chosen growth rate to each. This example does not estimate risk.',\n    path: 'demos/simulation/portfolio-analysis.html',\n  },\n  {\n    slug: 'strategy-portfolio',\n    title: 'Choosing a growth multiplier',\n    description: 'Choose between three illustrative growth multipliers. This is a branching example, not an investment-risk model.',\n    path: 'demos/simulation/strategy-portfolio.html',\n  },\n  {\n    slug: 'tiered-policy',\n    title: 'Claim payout rules',\n    description: 'A toy claim payout: choose an incident severity and policy tier, then inspect the adjustments and deduction.',\n    path: 'demos/simulation/tiered-policy-engine.html',\n  },\n  {\n    slug: 'what-if-path-switch',\n    title: 'WhatIfPathSwitch',\n    description: 'Switches computation paths via assumption toggles (\"what-if\" branches).',\n    path: 'demos/simulation/what-if-path-switch.html',\n  },\n  {\n    slug: 'deadweight_loss',\n    title: 'Deadweight Loss Calculator',\n    description: 'Equilibrium, surplus, and deadweight loss of a per-unit tax on a linear market.',\n    path: 'demos/simulation/deadweight-loss.html',\n  },\n  {\n    slug: 'trend_projection',\n    title: 'Vintage Forecasts',\n    description: 'An illustrative series with synthetic forecast vintages. Compare compounding assumptions; these are model-generated values, not agency data.',\n    path: 'demos/simulation/trend-projection.html',\n  },\n  {\n    slug: 'carbon_abatement',\n    title: 'Carbon Abatement Path',\n    description: 'A rising marginal abatement cost path as a sampled curve, with derived cheapest-step and tranche-cost marks.',\n    path: 'demos/simulation/carbon-abatement.html',\n  },\n] as const;\n\nexport const PLAYGROUND: Calculator = {\n  slug: 'playground',\n  title: 'Yichus Bosatsu Playground',\n  description: 'In-browser editor for Bosatsu simulations with live compile and Why explainer.',\n  path: 'editor.html',\n} as const;\n\n/** Look up a curated calculator by its slug, including the playground. */\nexport function findCalculator(slug: string): Calculator | undefined {\n  if (slug === PLAYGROUND.slug) return PLAYGROUND;\n  return CALCULATORS.find((calc) => calc.slug === slug);\n}\n\n/** Returns every entry exposed by `yichus_list_calculators`. */\nexport function listCalculators(): readonly Calculator[] {\n  return [...CALCULATORS, PLAYGROUND];\n}\n\n/** Build the full URL for a calculator at the given base. */\nexport function calculatorUrl(calc: Calculator, baseUrl = DEFAULT_BASE_URL): string {\n  const base = new URL(baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`);\n  return new URL(calc.path, base).toString();\n}\n\n/**\n * Force `?webmcp=1` on a URL so the page loads the WebMCP relay embed.\n *\n * Pages generated by `SimulationGenerator` and `web/editor.html` only inject\n * the relay embed when this flag (or `localStorage.yichus_webmcp = \"on\"`) is\n * present, so an agent that opens a calculator must set it.\n */\nexport function withWebMcpFlag(rawUrl: string): string {\n  const url = new URL(rawUrl);\n  url.searchParams.set('webmcp', '1');\n  return url.toString();\n}\n","import { spawn } from 'node:child_process';\n\n/**\n * Opens a URL in the user's default browser.\n *\n * Uses `URL.href` so shell metacharacters in the original string are escaped\n * before they reach the platform opener. Mirrors the approach the upstream\n * `webmcp-local-relay` `webmcp_open_page` tool uses.\n */\nexport function openUrlInBrowser(rawUrl: string): { command: string; args: string[] } {\n  const validated = new URL(rawUrl).href;\n  const platform = process.platform;\n\n  let command: string;\n  let args: string[];\n  if (platform === 'darwin') {\n    command = 'open';\n    args = [validated];\n  } else if (platform === 'win32') {\n    command = 'powershell';\n    args = ['-NoProfile', '-NonInteractive', '-Command', `Start-Process '${validated.replace(/'/g, \"''\")}'`];\n  } else {\n    command = 'xdg-open';\n    args = [validated];\n  }\n\n  spawn(command, args, { detached: true, stdio: 'ignore' }).unref();\n  return { command, args };\n}\n"],"mappings":";AAAA,SAAS,2BAA2B;AACpC,SAAS,SAAS;;;ACkBlB,IAAM,mBAAmB;AAElB,IAAM,cAAqC;AAAA,EAChD;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AACF;AAEO,IAAM,aAAyB;AAAA,EACpC,MAAM;AAAA,EACN,OAAO;AAAA,EACP,aAAa;AAAA,EACb,MAAM;AACR;AAGO,SAAS,eAAe,MAAsC;AACnE,MAAI,SAAS,WAAW,KAAM,QAAO;AACrC,SAAO,YAAY,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI;AACtD;AAGO,SAAS,kBAAyC;AACvD,SAAO,CAAC,GAAG,aAAa,UAAU;AACpC;AAGO,SAAS,cAAc,MAAkB,UAAU,kBAA0B;AAClF,QAAM,OAAO,IAAI,IAAI,QAAQ,SAAS,GAAG,IAAI,UAAU,GAAG,OAAO,GAAG;AACpE,SAAO,IAAI,IAAI,KAAK,MAAM,IAAI,EAAE,SAAS;AAC3C;AASO,SAAS,eAAe,QAAwB;AACrD,QAAM,MAAM,IAAI,IAAI,MAAM;AAC1B,MAAI,aAAa,IAAI,UAAU,GAAG;AAClC,SAAO,IAAI,SAAS;AACtB;;;ACnLA,SAAS,aAAa;AASf,SAAS,iBAAiB,QAAqD;AACpF,QAAM,YAAY,IAAI,IAAI,MAAM,EAAE;AAClC,QAAM,WAAW,QAAQ;AAEzB,MAAI;AACJ,MAAI;AACJ,MAAI,aAAa,UAAU;AACzB,cAAU;AACV,WAAO,CAAC,SAAS;AAAA,EACnB,WAAW,aAAa,SAAS;AAC/B,cAAU;AACV,WAAO,CAAC,cAAc,mBAAmB,YAAY,kBAAkB,UAAU,QAAQ,MAAM,IAAI,CAAC,GAAG;AAAA,EACzG,OAAO;AACL,cAAU;AACV,WAAO,CAAC,SAAS;AAAA,EACnB;AAEA,QAAM,SAAS,MAAM,EAAE,UAAU,MAAM,OAAO,SAAS,CAAC,EAAE,MAAM;AAChE,SAAO,EAAE,SAAS,KAAK;AACzB;;;AFfA,IAAM,eAAe;AAGrB,IAAM,kBAAkB;AAiDjB,SAAS,sBAAsB,UAAkC,CAAC,GAAwB;AAC/F,QAAM,UAAU,iBAAiB,QAAQ,WAAW,iBAAiB;AACrE,QAAM,kBAAkB,QAAQ,mBAAmB,CAAC;AAEpD,QAAM,SAAS,IAAI,oBAAoB;AAAA,IACrC,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,eAAe;AAAA,MACb,MAAM,gBAAgB;AAAA,MACtB,MAAM,gBAAgB;AAAA,MACtB,OAAO,gBAAgB,SAAS;AAAA;AAAA;AAAA,MAGhC,WAAW,gBAAgB,aAAa;AAAA,MACxC,SAAS,gBAAgB,WAAW;AAAA,MACpC,gBAAgB,CAAC,OAAO;AAAA,IAC1B;AAAA,EACF,CAAC;AAED,sBAAoB,QAAQ,EAAE,SAAS,eAAe,QAAQ,iBAAiB,MAAM,CAAC;AACtF,SAAO;AACT;AA2BA,SAAS,WAAW,QAA6C;AAC/D,SAAO;AACT;AAEA,SAAS,oBACP,QACA,KACM;AACN,QAAM,WAAW,WAAW,MAAM;AAElC,iBAAe,UAAU;AAAA,IACvB,MAAM;AAAA,IACN,aACE;AAAA,IACF,aAAa,EAAE,cAAc,MAAM,gBAAgB,KAAK;AAAA,IACxD,iBAAiB,EAAE,MAAM,UAAU,YAAY,CAAC,GAAG,sBAAsB,MAAM;AAAA,IAC/E,gBAAgB,CAAC;AAAA,IACjB,SAAS,YAAY;AACnB,YAAM,UAAU,gBAAgB,EAAE,IAAI,CAAC,UAAU;AAAA,QAC/C,MAAM,KAAK;AAAA,QACX,OAAO,KAAK;AAAA,QACZ,aAAa,KAAK;AAAA,QAClB,KAAK,cAAc,MAAM,IAAI,OAAO;AAAA,MACtC,EAAE;AACF,YAAM,UAAU,EAAE,SAAS,IAAI,SAAS,aAAa,QAAQ;AAC7D,aAAO;AAAA,QACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,SAAS,MAAM,CAAC,EAAE,CAAC;AAAA,QAClE,mBAAmB;AAAA,MACrB;AAAA,IACF;AAAA,EACF,CAAC;AAED,iBAAe,UAAU;AAAA,IACvB,MAAM;AAAA,IACN,aACE;AAAA,IACF,aAAa,EAAE,eAAe,KAAK;AAAA,IACnC,iBAAiB;AAAA,MACf,MAAM;AAAA,MACN,YAAY;AAAA,QACV,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,aACE;AAAA,QACJ;AAAA,MACF;AAAA,MACA,UAAU,CAAC,MAAM;AAAA,MACjB,sBAAsB;AAAA,IACxB;AAAA,IACA,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE;AAAA,IACnC,SAAS,OAAO,YAAY;AAC1B,YAAM,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,OAAO;AACzD,YAAM,OAA+B,eAAe,KAAK,IAAI;AAC7D,UAAI,CAAC,MAAM;AACT,cAAM,QAAQ,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI;AAC5D,eAAO;AAAA,UACL,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,MAAM,4BAA4B,KAAK,IAAI,mBAAmB,KAAK;AAAA,YACrE;AAAA,UACF;AAAA,UACA,SAAS;AAAA,QACX;AAAA,MACF;AACA,YAAM,MAAM,eAAe,cAAc,MAAM,IAAI,OAAO,CAAC;AAC3D,UAAI,SAAqD;AACzD,UAAI,CAAC,IAAI,eAAe;AACtB,iBAAS,iBAAiB,GAAG;AAAA,MAC/B;AACA,YAAM,UAAU;AAAA,QACd,YAAY;AAAA,UACV,MAAM,KAAK;AAAA,UACX,OAAO,KAAK;AAAA,UACZ,aAAa,KAAK;AAAA,QACpB;AAAA,QACA;AAAA,QACA,QAAQ,CAAC,IAAI;AAAA,QACb;AAAA,MACF;AACA,aAAO;AAAA,QACL,SAAS;AAAA,UACP;AAAA,YACE,MAAM;AAAA,YACN,MAAM,IAAI,gBACN,cAAc,KAAK,KAAK,OAAO,GAAG,gCAClC,WAAW,KAAK,KAAK,OAAO,GAAG;AAAA,UACrC;AAAA,QACF;AAAA,QACA,mBAAmB;AAAA,MACrB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAWA,SAAS,eAAe,UAA0B,MAA4B;AAC5E,QAAM,SAAkC;AAAA,IACtC,aAAa,KAAK;AAAA,IAClB,aAAa,KAAK;AAAA,EACpB;AACA,MAAI,KAAK,eAAe,OAAO,KAAK,KAAK,WAAW,EAAE,SAAS,GAAG;AAChE,WAAO,cAAc,KAAK;AAAA,EAC5B;AACA,WAAS,UAAU,aAAa,KAAK,MAAM,QAAQ,KAAK,OAAO;AAC/D,WAAS,eAAe,IAAI,KAAK,MAAM;AAAA,IACrC,MAAM,KAAK;AAAA,IACX,aAAa,KAAK;AAAA,IAClB,aAAa,KAAK;AAAA,IAClB,GAAI,KAAK,eAAe,OAAO,KAAK,KAAK,WAAW,EAAE,SAAS,IAC3D,EAAE,aAAa,KAAK,YAAY,IAChC,CAAC;AAAA,EACP,CAAC;AACH;AAEA,SAAS,iBAAiB,KAAqB;AAE7C,SAAO,IAAI,IAAI,GAAG,EAAE;AACtB;","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@yichus/mcp",
+  "version": "0.1.0",
+  "description": "MCP server that exposes the Yichus calculators and playground over WebMCP",
+  "license": "MIT",
+  "homepage": "https://yich.us",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/snoble/yichus.git",
+    "directory": "packages/yichus-mcp"
+  },
+  "type": "module",
+  "bin": {
+    "yichus-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@mcp-b/webmcp-local-relay": "2.2.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "webmcp",
+    "yichus",
+    "calculator",
+    "bosatsu"
+  ]
+}