Local Playground

package.json

@@ -19,7 +19,8 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "dev": "bun run ./src/index.ts dev --port 3000",
-    "build": "bun run typecheck && bun build ./src/index.ts --outdir ./dist --target node",
+    "build": "bun run typecheck && bun build --minify ./src/index.ts --outdir ./dist --target node && bun run build:ui",
+    "build:ui": "bun run typecheck && cd ./src/playground && bun run build && cp -r ./dist ../../dist/playground",
     "prepublishOnly": "bun run build",
     "build-binary": "bun run typecheck && bun build ./src/index.ts --compile --outfile make-agent",
     "lint": "prettier --check '{src,tests}/**/*.{js,ts}' && eslint . --ignore-pattern dist/",
@@ -34,16 +35,18 @@
   "license": "MIT",
   "devDependencies": {
     "@types/bun": "latest",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
     "@types/inquirer": "^9.0.7",
     "@types/localtunnel": "^2.0.4",
     "@types/node": "^22.7.2",
     "@types/open": "^6.2.1",
     "@typescript-eslint/eslint-plugin": "^8.15.0",
-    "ajv": "^8.17.1",
-    "ajv-draft-04": "^1.0.0",
     "eslint": "^9.15.0",
     "eslint-plugin-import": "^2.31.0",
-    "prettier": "^3.3.3"
+    "prettier": "^3.3.3",
+    "ajv": "^8.17.1",
+    "ajv-draft-04": "^1.0.0"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"
@@ -52,13 +55,16 @@
     "@apidevtools/swagger-parser": "^10.1.0",
     "borsh": "^0.7.0",
     "commander": "^12.1.0",
+    "cors": "^2.8.5",
     "dotenv": "^16.4.5",
-    "hono": "^4.5.11",
+    "express": "^4.21.2",
     "inquirer": "^12.0.0",
+    "is-port-reachable": "^4.0.0",
     "js-sha256": "^0.11.0",
     "localtunnel": "^2.0.2",
     "near-api-js": "^4.0.3",
-    "open": "^10.1.0",
-    "vercel-url": "^0.2.1"
+    "near-ca": "^0.8.1",
+    "near-safe": "^0.9.6",
+    "open": "^10.1.0"
   }
 }

src/commands/dev-deprecated.ts

@@ -0,0 +1,30 @@
+import { Command } from "commander";
+
+import { TunnelService } from "../services/tunnel";
+import { detectPort } from "../utils/port-detector";
+
+export const devDeprecatedCommand = new Command()
+  .name("dev-deprecated")
+  .description("Make your AI agent discoverable and register the plugin")
+  .option("-p, --port <number>", "Local port to expose", parseInt)
+  .option("-s, --serveo", "Use Serveo instead of Localtunnel", false)
+  .option("-t, --testnet", "Use Testnet instead of Mainnet", false)
+  .action(async (options) => {
+    let port = options.port;
+    if (!port) {
+      port = await detectPort();
+      if (!port) {
+        console.error(
+          "Unable to detect the port automatically. Please specify a port using the -p or --port option.",
+        );
+        process.exit(1);
+      }
+      console.log(`Detected port: ${port}`);
+    }
+    const tunnelService = new TunnelService({
+      port,
+      useServeo: options.serveo,
+      useTestnet: options.testnet,
+    });
+    await tunnelService.start();
+  });

src/commands/dev.ts

@@ -1,30 +1,128 @@
 import { Command } from "commander";
+import dotenv from "dotenv";
+import isPortReachable from "is-port-reachable";
 
-import { TunnelService } from "../services/tunnel";
+import { startApiServer } from "../services/proxy";
+import { getDeployedUrl } from "../utils/deployed-url";
+import { validateEnv } from "../utils/env";
+import { validateAndParseOpenApiSpec } from "../utils/openapi";
 import { detectPort } from "../utils/port-detector";
+import { getHostname, getSpecUrl } from "../utils/url-utils";
+
+dotenv.config();
+validateEnv();
+
+interface ApiConfig {
+  key: string;
+  url: string;
+  serverPort: number;
+}
+
+interface ValidationResult {
+  pluginId: string;
+  accountId: string;
+  spec: unknown;
+}
+
+const DEFAULT_PORTS = {
+  SERVER: 3010,
+} as const;
+
+async function findAvailablePort(startPort: number): Promise<number> {
+  let port = startPort;
+  while (await isPortReachable(port, { host: "localhost" })) {
+    port++;
+  }
+  return port;
+}
+
+const API_CONFIG: ApiConfig = {
+  key: process.env.BITTE_API_KEY!,
+  url: process.env.BITTE_API_URL!,
+  serverPort: DEFAULT_PORTS.SERVER,
+};
+
+async function fetchAndValidateSpec(url: string): Promise<ValidationResult> {
+  const pluginId = getHostname(url);
+  const specUrl = getSpecUrl(url);
+
+  const validation = await validateAndParseOpenApiSpec(specUrl);
+  const { isValid, accountId } = validation;
+
+  const specContent = await fetch(specUrl).then((res) => res.text());
+  let spec = JSON.parse(specContent);
+
+  if (!isValid) {
+    spec = {
+      ...spec,
+      servers: [{ url }],
+      "x-mb": {
+        ...spec["x-mb"],
+        "account-id": accountId || "anon",
+      },
+    };
+  }
+
+  return {
+    pluginId,
+    accountId: accountId || "anon",
+    spec,
+  };
+}
+
+async function setupPorts(options: {
+  port?: string;
+}): Promise<{ port: number; serverPort: number }> {
+  let port = parseInt(options.port || "") || 0;
+
+  if (port === 0) {
+    const detectedPort = await detectPort();
+    if (detectedPort) {
+      port = detectedPort;
+    } else {
+      port = await findAvailablePort(3000);
+    }
+  }
+
+  const serverPort = await findAvailablePort(DEFAULT_PORTS.SERVER);
+
+  return { port, serverPort };
+}
 
 export const devCommand = new Command()
   .name("dev")
-  .description("Make your AI agent discoverable and register the plugin")
-  .option("-p, --port <number>", "Local port to expose", parseInt)
-  .option("-s, --serveo", "Use Serveo instead of Localtunnel", false)
+  .description("Start a local playground for your AI agent")
+  .option("-p, --port <port>", "Port to run playground on", "3000")
   .option("-t, --testnet", "Use Testnet instead of Mainnet", false)
   .action(async (options) => {
-    let port = options.port;
-    if (!port) {
-      port = await detectPort();
-      if (!port) {
-        console.error(
-          "Unable to detect the port automatically. Please specify a port using the -p or --port option.",
+    try {
+      const { port, serverPort } = await setupPorts(options);
+
+      API_CONFIG.serverPort = serverPort;
+      const server = await startApiServer(API_CONFIG);
+
+      const deployedUrl = getDeployedUrl(port);
+      if (!deployedUrl) {
+        throw new Error("Deployed URL could not be determined.");
+      }
+
+      try {
+        console.log(
+          "[Dev] Fetching and validating OpenAPI spec from:",
+          deployedUrl,
         );
-        process.exit(1);
+        await fetchAndValidateSpec(deployedUrl);
+        console.log("[Dev] OpenAPI spec validation successful");
+      } catch (error) {
+        console.error("[Dev] Error validating OpenAPI spec:", error);
+        throw error;
       }
-      console.log(`Detected port: ${port}`);
+
+      process.on("SIGINT", async () => {
+        server.close();
+        process.exit(0);
+      });
+    } catch (error) {
+      process.exit(1);
     }
-    const tunnelService = new TunnelService({
-      port,
-      useServeo: options.serveo,
-      useTestnet: options.testnet,
-    });
-    await tunnelService.start();
   });

src/index.ts

@@ -7,6 +7,7 @@ import { contractCommand } from "./commands/contract";
 import { deleteCommand } from "./commands/delete";
 import { deployCommand } from "./commands/deploy";
 import { devCommand } from "./commands/dev";
+import { devDeprecatedCommand } from "./commands/dev-deprecated";
 import { registerCommand } from "./commands/register";
 import { updateCommand } from "./commands/update";
 import { verifyCommand } from "./commands/verify";
@@ -25,6 +26,7 @@ program
   .addCommand(registerCommand)
   .addCommand(updateCommand)
   .addCommand(deleteCommand)
-  .addCommand(verifyCommand);
+  .addCommand(verifyCommand)
+  .addCommand(devDeprecatedCommand);
 
 program.parse();

src/playground/.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

src/playground/README.md

@@ -0,0 +1,50 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type aware lint rules:
+
+- Configure the top-level `parserOptions` property like this:
+
+```js
+export default tseslint.config({
+  languageOptions: {
+    // other options...
+    parserOptions: {
+      project: ['./tsconfig.node.json', './tsconfig.app.json'],
+      tsconfigRootDir: import.meta.dirname,
+    },
+  },
+})
+```
+
+- Replace `tseslint.configs.recommended` to `tseslint.configs.recommendedTypeChecked` or `tseslint.configs.strictTypeChecked`
+- Optionally add `...tseslint.configs.stylisticTypeChecked`
+- Install [eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react) and update the config:
+
+```js
+// eslint.config.js
+import react from 'eslint-plugin-react'
+
+export default tseslint.config({
+  // Set the react version
+  settings: { react: { version: '18.3' } },
+  plugins: {
+    // Add the react plugin
+    react,
+  },
+  rules: {
+    // other rules...
+    // Enable its recommended rules
+    ...react.configs.recommended.rules,
+    ...react.configs['jsx-runtime'].rules,
+  },
+})
+```

src/playground/eslint.config.js

@@ -0,0 +1,28 @@
+import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  { ignores: ["dist"] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ["**/*.{ts,tsx}"],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      "react-hooks": reactHooks,
+      "react-refresh": reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      "react-refresh/only-export-components": [
+        "warn",
+        { allowConstantExport: true },
+      ],
+    },
+  },
+);

src/playground/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Vite + React + TS</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>