wattetheria 0.3.9 → 0.4.1

package/docker-compose.release.yml

@@ -115,7 +115,8 @@ services:
       WATTSWARM_UDP_ANNOUNCE_ADDR: ${WATTSWARM_UDP_ANNOUNCE_ADDR:-239.255.42.99}
       WATTSWARM_UDP_ANNOUNCE_PORT: ${WATTSWARM_UDP_ANNOUNCE_PORT:-37931}
       WATTSWARM_IROH_RELAY_URLS: ${WATTSWARM_IROH_RELAY_URLS:-https://relay.wattetheria.com}
-      WATTSWARM_IROH_PUBLISH_DIRECT_ADDRS: ${WATTSWARM_IROH_PUBLISH_DIRECT_ADDRS:-true}
+      WATTSWARM_IROH_BIND_ADDR: ${WATTSWARM_IROH_BIND_ADDR:-0.0.0.0:4002}
+      WATTSWARM_IROH_PUBLISH_DIRECT_ADDRS: ${WATTSWARM_IROH_PUBLISH_DIRECT_ADDRS:-false}
       WATTSWARM_IROH_DATA_PLANE_START_TIMEOUT_MS: ${WATTSWARM_IROH_DATA_PLANE_START_TIMEOUT_MS:-120000}
       WATTSWARM_PUBLIC_BOOTSTRAP_URLS: ${WATTSWARM_PUBLIC_BOOTSTRAP_URLS:-}
       WATTSWARM_PUBLIC_BOOTSTRAP_CONTACTS: ${WATTSWARM_PUBLIC_BOOTSTRAP_CONTACTS:-}
@@ -129,6 +130,7 @@ services:
       - "${WATTSWARM_UI_BIND_HOST:-127.0.0.1}:${WATTSWARM_UI_PORT:-7788}:7788"
       - "${WATTSWARM_SYNC_GRPC_BIND_HOST:-127.0.0.1}:${WATTSWARM_SYNC_GRPC_PORT:-7791}:7791"
       - "${WATTSWARM_P2P_HOST_PORT:-4001}:${WATTSWARM_P2P_PORT:-4001}"
+      - "${WATTSWARM_IROH_HOST_PORT:-4002}:4002/udp"
       - "${WATTSWARM_UDP_ANNOUNCE_HOST_PORT:-37931}:${WATTSWARM_UDP_ANNOUNCE_PORT:-37931}/udp"
     networks:
       - watt-internal

package/lib/cli.js

@@ -37,6 +37,7 @@ const NATIVE_ARCH_ALIASES = new Map([
 ]);
 const BANNER_COMMANDS = new Set([
   "help",
+  "setup",
   "install",
   "start",
   "up",
@@ -55,11 +56,13 @@ function printHelp() {
 
 Usage:
   npx wattetheria [command] [options]
+  npx wattetheria setup
   npx wattetheria install
 
 Commands:
   version     Show Wattetheria release version
   images      Show configured release images
+  setup       Install the local stack and finish first-time runtime/MCP setup
   install     Prepare deployment, pull images, and start the stack
   start       Start an existing deployment
   status      Show docker compose status
@@ -1025,8 +1028,67 @@ function printSummary(options) {
   console.log(`Deploy dir:   ${options.dir}`);
 }
 
-async function install(options) {
-  await ensureDockerAvailable({ interactive: true });
+function supervisionUrl(options) {
+  const envMap = readEnvFile(envFilePath(options));
+  const kernelHost = getEnvValue(envMap, "WATTETHERIA_CONTROL_PLANE_BIND_HOST", "127.0.0.1");
+  const kernelPort = getEnvValue(envMap, "WATTETHERIA_CONTROL_PLANE_PORT", "7777");
+  return `http://${kernelHost}:${kernelPort}/supervision`;
+}
+
+function mcpServerConfigSnippet(options) {
+  const args = ["wattetheria", "mcp-proxy"];
+  if (path.resolve(options.dir) !== path.resolve(DEFAULT_DEPLOY_DIR)) {
+    args.push("--dir", options.dir);
+  }
+  return JSON.stringify({
+    mcpServers: {
+      wattetheria: {
+        command: "npx",
+        args
+      }
+    }
+  }, null, 2);
+}
+
+function printSetupHint() {
+  console.log("");
+  console.log("To finish first-time setup, run:");
+  console.log("  npx wattetheria setup");
+}
+
+function printManualSetupChecklist(options) {
+  console.log("");
+  console.log("Finish setup:");
+  console.log("1. Open Supervision and configure the runtime:");
+  console.log(`   ${supervisionUrl(options)}`);
+  console.log("");
+  console.log("2. Add Wattetheria MCP to your agent runtime:");
+  console.log(mcpServerConfigSnippet(options));
+  console.log("");
+  console.log("3. Restart Wattetheria so runtime and MCP config take effect:");
+  console.log("   npx wattetheria restart");
+  console.log("");
+  console.log("4. Verify MCP access from the agent runtime:");
+  console.log("   - list Wattetheria MCP tools");
+  console.log("   - call one read-only Wattetheria MCP tool");
+}
+
+async function waitForEnter(message) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    await rl.question(message);
+  } finally {
+    rl.close();
+  }
+}
+
+async function install(options, behavior = {}) {
+  if (!behavior.dockerAlreadyChecked) {
+    await ensureDockerAvailable({ interactive: true });
+  }
   ensureDeploymentAssets(options);
   if (options.tag) {
     console.log(`Pinning release images to requested tag ${options.tag}.`);
@@ -1042,6 +1104,70 @@ async function install(options) {
     await runHealthChecks(options);
   }
   printSummary(options);
+  if (!behavior.suppressSetupHint) {
+    printSetupHint();
+  }
+}
+
+async function setup(options) {
+  console.log("Checking Docker runtime...");
+  const dockerStatus = getDockerStatus();
+  if (!dockerStatus.ready) {
+    throw new Error([
+      formatDockerStatusMessage(dockerStatus),
+      "",
+      "Install Docker, start it, then rerun:",
+      "  npx wattetheria setup"
+    ].join("\n"));
+  }
+  console.log("[ok] Docker runtime is ready.");
+
+  console.log("");
+  console.log("[1/5] Install Wattetheria");
+  const deployment = deploymentState(options.dir);
+  if (deployment.runnable) {
+    console.log("Deployment already initialized. Starting existing stack...");
+    await start(options);
+  } else {
+    await install(options, {
+      dockerAlreadyChecked: true,
+      suppressSetupHint: true
+    });
+  }
+
+  if (!isInteractiveTerminal()) {
+    printManualSetupChecklist(options);
+    return;
+  }
+
+  const url = supervisionUrl(options);
+  console.log("");
+  console.log("[2/5] Configure runtime");
+  console.log(`Open: ${url}`);
+  const opened = openUrl(url);
+  if (!opened) {
+    console.log("Open the URL above in your browser.");
+  }
+  await waitForEnter("After saving runtime config, press Enter to continue.");
+
+  console.log("");
+  console.log("[3/5] Install MCP in your agent runtime");
+  console.log(mcpServerConfigSnippet(options));
+  await waitForEnter("After saving MCP config, press Enter to continue.");
+
+  console.log("");
+  console.log("[4/5] Restart Wattetheria");
+  await restart(options);
+
+  console.log("");
+  console.log("[5/5] Verify MCP access");
+  console.log("From the agent runtime:");
+  console.log("- list Wattetheria MCP tools");
+  console.log("- call one read-only Wattetheria MCP tool");
+  await waitForEnter("After verifying MCP access, press Enter to finish.");
+
+  console.log("");
+  console.log("Setup complete.");
 }
 
 async function start(options) {
@@ -1681,6 +1807,9 @@ async function run(argv) {
     case "images":
       printImages(options);
       return;
+    case "setup":
+      await setup(options);
+      return;
     case "install":
       await install(options);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wattetheria",
-  "version": "0.3.9",
+  "version": "0.4.1",
   "description": "Wattetheria deployment CLI",
   "license": "AGPL-3.0-only",
   "type": "commonjs",