@holochain/hc-spin 0.500.3 → 0.600.0-rc.0

package/dist/main/index.js

@@ -1,16 +1,4 @@
 "use strict";
-const electron = require("electron");
-const fs = require("fs");
-const path = require("path");
-const node_crypto = require("node:crypto");
-const commander = require("commander");
-const contextMenu = require("electron-context-menu");
-const split = require("split");
-const childProcess = require("child_process");
-const url = require("url");
-const utils = require("@electron-toolkit/utils");
-const net$1 = require("node:net");
-const os = require("node:os");
 const msgpack = require("@msgpack/msgpack");
 const require$$0$3 = require("events");
 const require$$1$1 = require("https");
@@ -19,10 +7,22 @@ const require$$3 = require("net");
 const require$$4 = require("tls");
 const require$$1 = require("crypto");
 const require$$0$2 = require("stream");
+const require$$7 = require("url");
 const require$$0 = require("zlib");
 const require$$0$1 = require("buffer");
+const fs = require("fs");
+const path = require("path");
 const require$$2 = require("os");
 const jsSha512 = require("js-sha512");
+const childProcess = require("child_process");
+const commander = require("commander");
+const electron = require("electron");
+const contextMenu = require("electron-context-menu");
+const net$1 = require("node:net");
+const os = require("node:os");
+const node_crypto = require("node:crypto");
+const split = require("split");
+const utils = require("@electron-toolkit/utils");
 function _interopNamespaceDefault(e) {
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
   if (e) {
@@ -40,229 +40,6 @@ function _interopNamespaceDefault(e) {
   return Object.freeze(n);
 }
 const childProcess__namespace = /* @__PURE__ */ _interopNamespaceDefault(childProcess);
-const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
-const POOL_SIZE_MULTIPLIER = 128;
-let pool, poolOffset;
-function fillPool(bytes) {
-  if (!pool || pool.length < bytes) {
-    pool = Buffer.allocUnsafe(bytes * POOL_SIZE_MULTIPLIER);
-    node_crypto.webcrypto.getRandomValues(pool);
-    poolOffset = 0;
-  } else if (poolOffset + bytes > pool.length) {
-    node_crypto.webcrypto.getRandomValues(pool);
-    poolOffset = 0;
-  }
-  poolOffset += bytes;
-}
-function nanoid(size = 21) {
-  fillPool(size -= 0);
-  let id = "";
-  for (let i = poolOffset - size; i < poolOffset; i++) {
-    id += urlAlphabet[pool[i] & 63];
-  }
-  return id;
-}
-async function createHappWindow(uiSource, appId, agentNum, appPort, appAuthToken, appDataRootDir) {
-  if (!appPort) throw new Error("App port not defined.");
-  const partition = `persist:${agentNum}:${appId}`;
-  if (uiSource.type === "path") {
-    const ses = electron.session.fromPartition(partition);
-    ses.protocol.handle("webhapp", async (request) => {
-      const uriWithoutProtocol = request.url.slice("webhapp://".length);
-      const filePathComponents = uriWithoutProtocol.split("/").slice(1);
-      const filePath = path.join(...filePathComponents);
-      return electron.net.fetch(url.pathToFileURL(path.join(uiSource.path, filePath)).toString());
-    });
-  }
-  let preloadScript = fs.readFileSync(path.join(__dirname, "../preload/index.js")).toString();
-  preloadScript += `
-electron.contextBridge.exposeInMainWorld("__HC_LAUNCHER_ENV__", {
-  APP_INTERFACE_PORT: ${appPort},
-  INSTALLED_APP_ID: "${appId}",
-  APP_INTERFACE_TOKEN: [${appAuthToken}],
-});
-    `;
-  const preloadPath = path.join(appDataRootDir, `preload-${agentNum}-${appId}.js`);
-  fs.writeFileSync(preloadPath, preloadScript);
-  let icon;
-  if (uiSource.type === "path") {
-    const iconPath = path.join(uiSource.path, "icon.png");
-    if (!fs.existsSync(iconPath) && agentNum === 1) {
-      console.warn(
-        "\n\n+++++ WARNING +++++\n[hc-spin] No icon.png found. It is recommended to put an icon.png file (1024x1024 pixel) in the root of your UI assets directory which can be used by the Holochain Launcher.\n+++++++++++++++++++\n\n"
-      );
-    }
-    icon = electron.nativeImage.createFromPath(iconPath);
-  } else {
-    try {
-      const iconResponse = await electron.net.fetch(`http://localhost:${uiSource.port}/icon.png`);
-      if (iconResponse.status === 404 && agentNum === 1) {
-        console.warn(
-          "\n\n+++++ WARNING +++++\n[hc-spin] No icon.png found. It is recommended to put an icon.png file (1024x1024 pixel) in the root of your UI assets directory which can be used by the Holochain Launcher.\n+++++++++++++++++++\n\n"
-        );
-      }
-      const buffer = await iconResponse.arrayBuffer();
-      icon = electron.nativeImage.createFromBuffer(Buffer.from(buffer));
-    } catch (e) {
-      console.error("Failed to get icon.png: ", e);
-    }
-  }
-  return new electron.BrowserWindow({
-    width: 1200,
-    height: 800,
-    show: false,
-    icon,
-    title: `Agent ${agentNum} - ${appId}`,
-    webPreferences: {
-      preload: preloadPath,
-      partition
-    }
-  });
-}
-async function loadHappWindow(happWindow, uiSource, happOrWebhappPath, agentNum, openDevtools) {
-  const [windowPositionX, windowPositionY] = happWindow.getPosition();
-  const windowPositionXMoved = windowPositionX + agentNum * 20;
-  const windowPositionYMoved = windowPositionY + agentNum * 20;
-  happWindow.setPosition(windowPositionXMoved, windowPositionYMoved);
-  happWindow.menuBarVisible = false;
-  setLinkOpenHandlers(happWindow);
-  happWindow.on("page-title-updated", (evt) => {
-    evt.preventDefault();
-  });
-  if (openDevtools) happWindow.webContents.openDevTools();
-  if (uiSource.type === "port") {
-    try {
-      await electron.net.fetch(`http://localhost:${uiSource.port}/index.html`);
-    } catch (e) {
-      console.error(`No index.html file found at http://localhost:${uiSource.port}/index.html`, e);
-      if (utils.is.dev && process.env["ELECTRON_RENDERER_URL"]) {
-        happWindow.loadURL(process.env["ELECTRON_RENDERER_URL"]);
-      } else {
-        happWindow.loadFile(path.join(__dirname, "../renderer/index.html"));
-      }
-      return;
-    }
-    await happWindow.loadURL(`http://localhost:${uiSource.port}`);
-  } else if (uiSource.type === "path") {
-    try {
-      await happWindow.loadURL(`webhapp://webhappwindow/index.html`);
-    } catch (e) {
-      console.error("[ERROR] Failed to fetch index.html");
-      if (utils.is.dev && process.env["ELECTRON_RENDERER_URL"]) {
-        happWindow.loadURL(process.env["ELECTRON_RENDERER_URL"]);
-      } else {
-        const notFoundPath = happOrWebhappPath.type === "webhapp" ? path.join(__dirname, "../renderer/indexNotFound1.html") : path.join(__dirname, "../renderer/indexNotFound2.html");
-        happWindow.loadFile(notFoundPath);
-      }
-      return;
-    }
-  } else {
-    throw new Error("Unsupported uiSource type: ", uiSource.type);
-  }
-  happWindow.show();
-}
-function setLinkOpenHandlers(browserWindow) {
-  browserWindow.webContents.on("will-navigate", (e) => {
-    if (e.url.startsWith("http://localhost") || e.url.startsWith("http://127.0.0.1")) {
-      return;
-    }
-    if (e.url.startsWith("http://") || e.url.startsWith("https://") || e.url.startsWith("mailto://")) {
-      e.preventDefault();
-      electron.shell.openExternal(e.url);
-    }
-  });
-  browserWindow.webContents.setWindowOpenHandler((details) => {
-    if (details.url.startsWith("http://") || details.url.startsWith("https://")) {
-      electron.shell.openExternal(details.url);
-    }
-    return { action: "deny" };
-  });
-}
-class Locked extends Error {
-  constructor(port) {
-    super(`${port} is locked`);
-  }
-}
-const lockedPorts = {
-  old: /* @__PURE__ */ new Set(),
-  young: /* @__PURE__ */ new Set()
-};
-const releaseOldLockedPortsIntervalMs = 1e3 * 15;
-let timeout;
-const getLocalHosts = () => {
-  const interfaces = os.networkInterfaces();
-  const results = /* @__PURE__ */ new Set([void 0, "0.0.0.0"]);
-  for (const _interface of Object.values(interfaces)) {
-    for (const config of _interface) {
-      results.add(config.address);
-    }
-  }
-  return results;
-};
-const checkAvailablePort = (options) => new Promise((resolve, reject) => {
-  const server = net$1.createServer();
-  server.unref();
-  server.on("error", reject);
-  server.listen(options, () => {
-    const { port } = server.address();
-    server.close(() => {
-      resolve(port);
-    });
-  });
-});
-const getAvailablePort = async (options, hosts) => {
-  if (options.host || options.port === 0) {
-    return checkAvailablePort(options);
-  }
-  for (const host of hosts) {
-    try {
-      await checkAvailablePort({ port: options.port, host });
-    } catch (error) {
-      if (!["EADDRNOTAVAIL", "EINVAL"].includes(error.code)) {
-        throw error;
-      }
-    }
-  }
-  return options.port;
-};
-const portCheckSequence = function* (ports) {
-  yield 0;
-};
-async function getPorts(options) {
-  let exclude = /* @__PURE__ */ new Set();
-  if (timeout === void 0) {
-    timeout = setTimeout(() => {
-      timeout = void 0;
-      lockedPorts.old = lockedPorts.young;
-      lockedPorts.young = /* @__PURE__ */ new Set();
-    }, releaseOldLockedPortsIntervalMs);
-    if (timeout.unref) {
-      timeout.unref();
-    }
-  }
-  const hosts = getLocalHosts();
-  for (const port of portCheckSequence()) {
-    try {
-      if (exclude.has(port)) {
-        continue;
-      }
-      let availablePort = await getAvailablePort({ ...options, port }, hosts);
-      while (lockedPorts.old.has(availablePort) || lockedPorts.young.has(availablePort)) {
-        if (port !== 0) {
-          throw new Locked(port);
-        }
-        availablePort = await getAvailablePort({ ...options, port }, hosts);
-      }
-      lockedPorts.young.add(availablePort);
-      return availablePort;
-    } catch (error) {
-      if (!["EADDRINUSE", "EACCES"].includes(error.code) && !(error instanceof Locked)) {
-        throw error;
-      }
-    }
-  }
-  throw new Error("No available ports found");
-}
 var CellType;
 (function(CellType2) {
   CellType2["Provisioned"] = "provisioned";
@@ -279,9 +56,6 @@ var AppStatusFilter;
 (function(AppStatusFilter2) {
   AppStatusFilter2["Enabled"] = "enabled";
   AppStatusFilter2["Disabled"] = "disabled";
-  AppStatusFilter2["Running"] = "running";
-  AppStatusFilter2["Stopped"] = "stopped";
-  AppStatusFilter2["Paused"] = "paused";
 })(AppStatusFilter || (AppStatusFilter = {}));
 const __HC_LAUNCHER_ENV__ = "__HC_LAUNCHER_ENV__";
 const __HC_ZOME_CALL_SIGNER__ = "__HC_ZOME_CALL_SIGNER__";
@@ -3099,7 +2873,7 @@ const net = require$$3;
 const tls = require$$4;
 const { randomBytes, createHash: createHash$1 } = require$$1;
 const { Duplex: Duplex$2, Readable } = require$$0$2;
-const { URL: URL$1 } = url;
+const { URL: URL$1 } = require$$7;
 const PerMessageDeflate$1 = permessageDeflate;
 const Receiver2 = receiver;
 const Sender2 = sender;
@@ -11617,7 +11391,7 @@ class AppWebsocket {
   cachedAppInfo;
   appInfoRequester;
   agentInfoRequester;
-  agentMetaInfoRequester;
+  peerMetaInfoRequester;
   callZomeRequester;
   provideMemproofRequester;
   enableAppRequester;
@@ -11639,7 +11413,7 @@ class AppWebsocket {
     this.cachedAppInfo = appInfo;
     this.appInfoRequester = AppWebsocket.requester(this.client, "app_info", this.defaultTimeout);
     this.agentInfoRequester = AppWebsocket.requester(this.client, "agent_info", this.defaultTimeout);
-    this.agentMetaInfoRequester = AppWebsocket.requester(this.client, "agent_meta_info", this.defaultTimeout);
+    this.peerMetaInfoRequester = AppWebsocket.requester(this.client, "peer_meta_info", this.defaultTimeout);
     this.callZomeRequester = AppWebsocket.requester(this.client, "call_zome", this.defaultTimeout, this.callZomeTransform);
     this.provideMemproofRequester = AppWebsocket.requester(this.client, "provide_memproofs", this.defaultTimeout);
     this.enableAppRequester = AppWebsocket.requester(this.client, "enable_app", this.defaultTimeout);
@@ -11711,14 +11485,14 @@ class AppWebsocket {
     return await this.agentInfoRequester(req, timeout2);
   }
   /**
-   * Request agent meta info for an agent by peer Url.
+   * Request peer meta info for a peer by Url.
    *
    * @param req - The peer Url of the agent and an optional array of DNA hashes
    * @param timeout - A timeout to override the default.
    * @returns The meta info stored for this peer URL.
    */
-  async agentMetaInfo(req, timeout2) {
-    return await this.agentMetaInfoRequester(req, timeout2);
+  async peerMetaInfo(req, timeout2) {
+    return await this.peerMetaInfoRequester(req, timeout2);
   }
   /**
    * Request network stats.
@@ -11985,12 +11759,12 @@ class WsClient extends Emittery {
   pendingRequests;
   index;
   authenticationToken;
-  constructor(socket, url2, options) {
+  constructor(socket, url, options) {
     super();
     this.registerMessageListener(socket);
     this.registerCloseListener(socket);
     this.socket = socket;
-    this.url = url2;
+    this.url = url;
     this.options = options;
     this.pendingRequests = {};
     this.index = 0;
@@ -12002,14 +11776,14 @@ class WsClient extends Emittery {
    * @param options - Options for the WsClient.
    * @returns An new instance of the WsClient.
    */
-  static connect(url2, options) {
+  static connect(url, options) {
     return new Promise((resolve, reject) => {
-      const socket = new IsoWebSocket(url2, options);
+      const socket = new IsoWebSocket(url, options);
       socket.addEventListener("error", (errorEvent) => {
-        reject(new HolochainError("ConnectionError", `could not connect to Holochain Conductor API at ${url2} - ${errorEvent.error}`));
+        reject(new HolochainError("ConnectionError", `could not connect to Holochain Conductor API at ${url} - ${errorEvent.error}`));
       });
       socket.addEventListener("open", (_) => {
-        const client = new WsClient(socket, url2, options);
+        const client = new WsClient(socket, url, options);
         resolve(client);
       }, { once: true });
     });
@@ -12155,12 +11929,12 @@ class WsClient extends Emittery {
       }
     }, { once: true });
   }
-  async reconnectWebsocket(url2, token) {
+  async reconnectWebsocket(url, token) {
     return new Promise((resolve, reject) => {
-      this.socket = new IsoWebSocket(url2, this.options);
+      this.socket = new IsoWebSocket(url, this.options);
       this.socket.addEventListener("error", (errorEvent) => {
         this.authenticationToken = void 0;
-        reject(new HolochainError("ConnectionError", `could not connect to Holochain Conductor API at ${url2} - ${errorEvent.message}`));
+        reject(new HolochainError("ConnectionError", `could not connect to Holochain Conductor API at ${url} - ${errorEvent.message}`));
       }, { once: true });
       const invalidTokenCloseListener = (closeEvent) => {
         this.authenticationToken = void 0;
@@ -12280,12 +12054,6 @@ class AdminWebsocket {
    * Generate a new agent pub key.
    */
   revokeAgentKey = this._requester("revoke_agent_key");
-  /**
-   * Register a DNA for later app installation.
-   *
-   * Stores the given DNA into the Holochain DNA database and returns the hash of it.
-   */
-  registerDna = this._requester("register_dna");
   /**
    * Get the DNA definition for the specified DNA hash.
    */
@@ -12327,9 +12095,9 @@ class AdminWebsocket {
    */
   addAgentInfo = this._requester("add_agent_info");
   /**
-   * Request agent meta info about an agent.
+   * Request peer meta info for a peer.
    */
-  agentMetaInfo = this._requester("agent_meta_info");
+  peerMetaInfo = this._requester("peer_meta_info");
   /**
    * Delete a disabled clone cell.
    */
@@ -12339,6 +12107,15 @@ class AdminWebsocket {
    * calls.
    */
   grantZomeCallCapability = this._requester("grant_zome_call_capability");
+  /**
+   * Revoke a zome call capability for an agent, which was previously granted
+   * using {@link AdminWebsocket.grantZomeCallCapability}.
+   */
+  revokeZomeCallCapability = this._requester("revoke_zome_call_capability");
+  /**
+   * List all capability grants for all cells.
+   */
+  listCapabilityGrants = this._requester("list_capability_grants");
   storageInfo = this._requester("storage_info");
   issueAppAuthenticationToken = this._requester("issue_app_authentication_token");
   dumpNetworkStats = this._requester("dump_network_stats");
@@ -12420,53 +12197,112 @@ var ChainOpType;
   ChainOpType2["RegisterAddLink"] = "RegisterAddLink";
   ChainOpType2["RegisterRemoveLink"] = "RegisterRemoveLink";
 })(ChainOpType || (ChainOpType = {}));
-function validateCliArgs(cliArgs, cliOpts, appDataRootDir) {
-  if (cliArgs.length !== 1) {
-    throw new Error(
-      `hc spin takes exactly one argument (the path to the .happ or .webhapp file) but got ${cliArgs.length} arguments: ${cliArgs}`
-    );
-  }
-  const happOrWebhappPath = cliArgs[0];
-  if (!happOrWebhappPath.endsWith(".happ") && !happOrWebhappPath.endsWith(".webhapp")) {
-    throw new Error(
-      `The path passed to hc spin must either be a .happ or a .webhapp file but got path '${happOrWebhappPath}'`
-    );
+class Locked extends Error {
+  constructor(port) {
+    super(`${port} is locked`);
   }
-  if (!fs.existsSync(happOrWebhappPath)) {
-    throw new Error(
-      `Path to .happ or .webhapp file passed as argument does not exist: ${happOrWebhappPath}`
-    );
+}
+const lockedPorts = {
+  old: /* @__PURE__ */ new Set(),
+  young: /* @__PURE__ */ new Set()
+};
+const releaseOldLockedPortsIntervalMs = 1e3 * 15;
+let timeout;
+const getLocalHosts = () => {
+  const interfaces = os.networkInterfaces();
+  const results = /* @__PURE__ */ new Set([void 0, "0.0.0.0"]);
+  for (const _interface of Object.values(interfaces)) {
+    for (const config of _interface) {
+      results.add(config.address);
+    }
   }
-  if (cliOpts.numAgents && typeof cliOpts.numAgents !== "number") {
-    throw new Error(
-      `The --num-agents (-n) option must be of type number but got: ${cliOpts.numAgents}`
-    );
+  return results;
+};
+const checkAvailablePort = (options) => new Promise((resolve, reject) => {
+  const server = net$1.createServer();
+  server.unref();
+  server.on("error", reject);
+  server.listen(options, () => {
+    const { port } = server.address();
+    server.close(() => {
+      resolve(port);
+    });
+  });
+});
+const getAvailablePort = async (options, hosts) => {
+  if (options.host || options.port === 0) {
+    return checkAvailablePort(options);
   }
-  const isHapp = happOrWebhappPath.endsWith(".happ");
-  if (isHapp && !cliOpts.uiPath && !cliOpts.uiPort) {
-    throw new Error(
-      "If you pass a .happ file as argument, you must also provide either the --ui-port or the --ui-path option pointing to the UI assets."
-    );
+  for (const host of hosts) {
+    try {
+      await checkAvailablePort({ port: options.port, host });
+    } catch (error) {
+      if (!["EADDRNOTAVAIL", "EINVAL"].includes(error.code)) {
+        throw error;
+      }
+    }
   }
-  if (cliOpts.uiPath && cliOpts.uiPort) {
-    throw new Error(
-      "Only one of --ui-port and --ui-path is allowed at the same time but got values for both."
-    );
+  return options.port;
+};
+const portCheckSequence = function* (ports) {
+  yield 0;
+};
+async function getPorts(options) {
+  let exclude = /* @__PURE__ */ new Set();
+  if (timeout === void 0) {
+    timeout = setTimeout(() => {
+      timeout = void 0;
+      lockedPorts.old = lockedPorts.young;
+      lockedPorts.young = /* @__PURE__ */ new Set();
+    }, releaseOldLockedPortsIntervalMs);
+    if (timeout.unref) {
+      timeout.unref();
+    }
   }
-  const appId = cliOpts.appId ? cliOpts.appId : path.parse(path.basename(cliArgs[0])).name;
-  const holochainPath = cliOpts.holochainPath;
-  const numAgents = cliOpts.numAgents ? cliOpts.numAgents : 2;
-  return {
-    appId,
-    holochainPath,
-    numAgents,
-    networkSeed: cliOpts.networkSeed,
-    uiSource: cliOpts.uiPath ? { type: "path", path: cliOpts.uiPath } : cliOpts.uiPort ? { type: "port", port: cliOpts.uiPort } : { type: "path", path: path.join(appDataRootDir, "apps", appId, "ui") },
-    singalingUrl: cliOpts.signalingUrl,
-    bootstrapUrl: cliOpts.bootstrapUrl,
-    happOrWebhappPath: isHapp ? { type: "happ", path: happOrWebhappPath } : { type: "webhapp", path: happOrWebhappPath },
-    openDevtools: cliOpts.openDevtools ? true : false
-  };
+  const hosts = getLocalHosts();
+  for (const port of portCheckSequence()) {
+    try {
+      if (exclude.has(port)) {
+        continue;
+      }
+      let availablePort = await getAvailablePort({ ...options, port }, hosts);
+      while (lockedPorts.old.has(availablePort) || lockedPorts.young.has(availablePort)) {
+        if (port !== 0) {
+          throw new Locked(port);
+        }
+        availablePort = await getAvailablePort({ ...options, port }, hosts);
+      }
+      lockedPorts.young.add(availablePort);
+      return availablePort;
+    } catch (error) {
+      if (!["EADDRINUSE", "EACCES"].includes(error.code) && !(error instanceof Locked)) {
+        throw error;
+      }
+    }
+  }
+  throw new Error("No available ports found");
+}
+const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+const POOL_SIZE_MULTIPLIER = 128;
+let pool, poolOffset;
+function fillPool(bytes) {
+  if (!pool || pool.length < bytes) {
+    pool = Buffer.allocUnsafe(bytes * POOL_SIZE_MULTIPLIER);
+    node_crypto.webcrypto.getRandomValues(pool);
+    poolOffset = 0;
+  } else if (poolOffset + bytes > pool.length) {
+    node_crypto.webcrypto.getRandomValues(pool);
+    poolOffset = 0;
+  }
+  poolOffset += bytes;
+}
+function nanoid(size = 21) {
+  fillPool(size -= 0);
+  let id = "";
+  for (let i = poolOffset - size; i < poolOffset; i++) {
+    id += urlAlphabet[pool[i] & 63];
+  }
+  return id;
 }
 const menu = electron.Menu.buildFromTemplate([
   {
@@ -12555,11 +12391,179 @@ const menu = electron.Menu.buildFromTemplate([
     ]
   }
 ]);
+function validateCliArgs(cliArgs, cliOpts, appDataRootDir) {
+  if (cliArgs.length !== 1) {
+    throw new Error(
+      `hc spin takes exactly one argument (the path to the .happ or .webhapp file) but got ${cliArgs.length} arguments: ${cliArgs}`
+    );
+  }
+  const happOrWebhappPath = cliArgs[0];
+  if (!happOrWebhappPath.endsWith(".happ") && !happOrWebhappPath.endsWith(".webhapp")) {
+    throw new Error(
+      `The path passed to hc spin must either be a .happ or a .webhapp file but got path '${happOrWebhappPath}'`
+    );
+  }
+  if (!fs.existsSync(happOrWebhappPath)) {
+    throw new Error(
+      `Path to .happ or .webhapp file passed as argument does not exist: ${happOrWebhappPath}`
+    );
+  }
+  if (cliOpts.numAgents !== void 0 && (typeof cliOpts.numAgents !== "number" || Number.isNaN(cliOpts.numAgents))) {
+    throw new Error(
+      `The --num-agents (-n) option must be of type number but got: ${cliOpts.numAgents}`
+    );
+  }
+  if (cliOpts.targetArcFactor !== void 0 && (typeof cliOpts.targetArcFactor !== "number" || Number.isNaN(cliOpts.targetArcFactor))) {
+    throw new Error(
+      `The --target-arc-factor (-t) option must be a valid number but got: ${cliOpts.targetArcFactor}`
+    );
+  }
+  const isHapp = happOrWebhappPath.endsWith(".happ");
+  if (isHapp && !cliOpts.uiPath && !cliOpts.uiPort) {
+    throw new Error(
+      "If you pass a .happ file as argument, you must also provide either the --ui-port or the --ui-path option pointing to the UI assets."
+    );
+  }
+  if (cliOpts.uiPath && cliOpts.uiPort) {
+    throw new Error(
+      "Only one of --ui-port and --ui-path is allowed at the same time but got values for both."
+    );
+  }
+  const appId = cliOpts.appId ? cliOpts.appId : path.parse(path.basename(cliArgs[0])).name;
+  const holochainPath = cliOpts.holochainPath;
+  const numAgents = cliOpts.numAgents ? cliOpts.numAgents : 2;
+  return {
+    appId,
+    holochainPath,
+    numAgents,
+    networkSeed: cliOpts.networkSeed,
+    targetArcFactor: cliOpts.targetArcFactor,
+    uiSource: cliOpts.uiPath ? { type: "path", path: cliOpts.uiPath } : cliOpts.uiPort ? { type: "port", port: cliOpts.uiPort } : { type: "path", path: path.join(appDataRootDir, "apps", appId, "ui") },
+    singalingUrl: cliOpts.signalingUrl,
+    bootstrapUrl: cliOpts.bootstrapUrl,
+    happOrWebhappPath: isHapp ? { type: "happ", path: happOrWebhappPath } : { type: "webhapp", path: happOrWebhappPath },
+    openDevtools: cliOpts.openDevtools ? true : false
+  };
+}
+async function createHappWindow(uiSource, appId, agentNum, appPort, appAuthToken, appDataRootDir) {
+  if (!appPort) throw new Error("App port not defined.");
+  const partition = `persist:${agentNum}:${appId}`;
+  if (uiSource.type === "path") {
+    const ses = electron.session.fromPartition(partition);
+    ses.protocol.handle("webhapp", async (request) => {
+      const uriWithoutProtocol = request.url.slice("webhapp://".length);
+      const filePathComponents = uriWithoutProtocol.split("/").slice(1);
+      const filePath = path.join(...filePathComponents);
+      return electron.net.fetch(require$$7.pathToFileURL(path.join(uiSource.path, filePath)).toString());
+    });
+  }
+  let preloadScript = fs.readFileSync(path.join(__dirname, "../preload/index.js")).toString();
+  preloadScript += `
+electron.contextBridge.exposeInMainWorld("__HC_LAUNCHER_ENV__", {
+  APP_INTERFACE_PORT: ${appPort},
+  INSTALLED_APP_ID: "${appId}",
+  APP_INTERFACE_TOKEN: [${appAuthToken}],
+});
+    `;
+  const preloadPath = path.join(appDataRootDir, `preload-${agentNum}-${appId}.js`);
+  fs.writeFileSync(preloadPath, preloadScript);
+  let icon;
+  if (uiSource.type === "path") {
+    const iconPath = path.join(uiSource.path, "icon.png");
+    if (!fs.existsSync(iconPath) && agentNum === 1) {
+      console.warn(
+        "\n\n+++++ WARNING +++++\n[hc-spin] No icon.png found. It is recommended to put an icon.png file (1024x1024 pixel) in the root of your UI assets directory which can be used by the Holochain Launcher.\n+++++++++++++++++++\n\n"
+      );
+    }
+    icon = electron.nativeImage.createFromPath(iconPath);
+  } else {
+    try {
+      const iconResponse = await electron.net.fetch(`http://localhost:${uiSource.port}/icon.png`);
+      if (iconResponse.status === 404 && agentNum === 1) {
+        console.warn(
+          "\n\n+++++ WARNING +++++\n[hc-spin] No icon.png found. It is recommended to put an icon.png file (1024x1024 pixel) in the root of your UI assets directory which can be used by the Holochain Launcher.\n+++++++++++++++++++\n\n"
+        );
+      }
+      const buffer = await iconResponse.arrayBuffer();
+      icon = electron.nativeImage.createFromBuffer(Buffer.from(buffer));
+    } catch (e) {
+      console.error("Failed to get icon.png: ", e);
+    }
+  }
+  return new electron.BrowserWindow({
+    width: 1200,
+    height: 800,
+    show: false,
+    icon,
+    title: `Agent ${agentNum} - ${appId}`,
+    webPreferences: {
+      preload: preloadPath,
+      partition
+    }
+  });
+}
+async function loadHappWindow(happWindow, uiSource, happOrWebhappPath, agentNum, openDevtools) {
+  const [windowPositionX, windowPositionY] = happWindow.getPosition();
+  const windowPositionXMoved = windowPositionX + agentNum * 20;
+  const windowPositionYMoved = windowPositionY + agentNum * 20;
+  happWindow.setPosition(windowPositionXMoved, windowPositionYMoved);
+  happWindow.menuBarVisible = false;
+  setLinkOpenHandlers(happWindow);
+  happWindow.on("page-title-updated", (evt) => {
+    evt.preventDefault();
+  });
+  if (openDevtools) happWindow.webContents.openDevTools();
+  if (uiSource.type === "port") {
+    try {
+      await electron.net.fetch(`http://localhost:${uiSource.port}/index.html`);
+    } catch (e) {
+      console.error(`No index.html file found at http://localhost:${uiSource.port}/index.html`, e);
+      if (utils.is.dev && process.env["ELECTRON_RENDERER_URL"]) {
+        happWindow.loadURL(process.env["ELECTRON_RENDERER_URL"]);
+      } else {
+        happWindow.loadFile(path.join(__dirname, "../renderer/index.html"));
+      }
+      return;
+    }
+    await happWindow.loadURL(`http://localhost:${uiSource.port}`);
+  } else if (uiSource.type === "path") {
+    try {
+      await happWindow.loadURL(`webhapp://webhappwindow/index.html`);
+    } catch (e) {
+      console.error("[ERROR] Failed to fetch index.html");
+      if (utils.is.dev && process.env["ELECTRON_RENDERER_URL"]) {
+        happWindow.loadURL(process.env["ELECTRON_RENDERER_URL"]);
+      } else {
+        const notFoundPath = happOrWebhappPath.type === "webhapp" ? path.join(__dirname, "../renderer/indexNotFound1.html") : path.join(__dirname, "../renderer/indexNotFound2.html");
+        happWindow.loadFile(notFoundPath);
+      }
+      return;
+    }
+  } else {
+    throw new Error(`Unsupported uiSource: ${JSON.stringify(uiSource)}`);
+  }
+  happWindow.show();
+}
+function setLinkOpenHandlers(browserWindow) {
+  browserWindow.webContents.on("will-navigate", (e) => {
+    if (e.url.startsWith("http://localhost") || e.url.startsWith("http://127.0.0.1")) {
+      return;
+    }
+    if (e.url.startsWith("http://") || e.url.startsWith("https://") || e.url.startsWith("mailto://")) {
+      e.preventDefault();
+      electron.shell.openExternal(e.url);
+    }
+  });
+  browserWindow.webContents.setWindowOpenHandler((details) => {
+    if (details.url.startsWith("http://") || details.url.startsWith("https://")) {
+      electron.shell.openExternal(details.url);
+    }
+    return { action: "deny" };
+  });
+}
 const rustUtils = require("@holochain/hc-spin-rust-utils");
-const cliPackageJsonPath = path.resolve(path.join(electron.app.getAppPath(), "../../package.json"));
-const cliPackageJson = require(cliPackageJsonPath);
 const cli = new commander.Command();
-cli.name("hc-spin").description("CLI to run Holochain apps during development.").version(`${cliPackageJson.version} (built for holochain ${cliPackageJson.holochainVersion})`).argument(
+cli.name("hc-spin").description("CLI to run Holochain apps during development.").version(`${"0.600.0-rc.0"} (built for holochain ${"0.6.0-rc.0"})`).argument(
   "<path>",
   "Path to .webhapp or .happ file to launch. If a .happ file is passed, either a UI path must be specified via --ui-path or a port pointing to a localhost server via --ui-port"
 ).option(
@@ -12572,7 +12576,12 @@ cli.name("hc-spin").description("CLI to run Holochain apps during development.")
   new commander.Option("-n, --num-agents <number>", "How many agents to spawn the app for.").argParser(
     parseInt
   )
-).option("--network-seed <string>", "Install the app with a specific network seed.").option("--ui-path <path>", "Path to the folder containing the index.html of the webhapp's UI.").option(
+).option("--network-seed <string>", "Install the app with a specific network seed.").addOption(
+  new commander.Option(
+    "-t, --target-arc-factor <number>",
+    "Set the target arc factor for all conductors. In normal operation, leave this as the default 1. For leacher/zero-arc nodes that do not contribute to gossip, set to 0."
+  ).argParser(parseInt)
+).option("--ui-path <path>", "Path to the folder containing the index.html of the webhapp's UI.").option(
   "--ui-port <number>",
   "Port pointing to a localhost dev server that serves your UI assets."
 ).option(
@@ -12677,7 +12686,7 @@ async function startLocalServices() {
     });
   });
 }
-async function spawnSandboxes(nAgents, happPath, bootStrapUrl, signalUrl, appId, networkSeed) {
+async function spawnSandboxes(nAgents, happPath, bootStrapUrl, signalUrl, appId, networkSeed, targetArcFactor) {
   const generateArgs = [
     "sandbox",
     "--piped",
@@ -12689,7 +12698,7 @@ async function spawnSandboxes(nAgents, happPath, bootStrapUrl, signalUrl, appId,
     "--run"
   ];
   let appPorts = "";
-  for (var i = 1; i <= nAgents; i++) {
+  for (let i = 1; i <= nAgents; i++) {
     const appPort = await getPorts();
     appPorts += `${appPort},`;
   }
@@ -12698,7 +12707,11 @@ async function spawnSandboxes(nAgents, happPath, bootStrapUrl, signalUrl, appId,
     generateArgs.push("--network-seed");
     generateArgs.push(networkSeed);
   }
-  generateArgs.push(happPath, "network", "--bootstrap", bootStrapUrl, "webrtc", signalUrl);
+  generateArgs.push(happPath, "network");
+  if (targetArcFactor !== void 0) {
+    generateArgs.push("--target-arc-factor", targetArcFactor.toString());
+  }
+  generateArgs.push("--bootstrap", bootStrapUrl, "webrtc", signalUrl);
   let readyConductors = 0;
   const portsInfo = {};
   const sandboxPaths = [];
@@ -12749,7 +12762,8 @@ electron.app.whenReady().then(async () => {
     CLI_OPTS.bootstrapUrl ? CLI_OPTS.bootstrapUrl : bootstrapUrl,
     CLI_OPTS.singalingUrl ? CLI_OPTS.singalingUrl : signalingUrl,
     CLI_OPTS.appId,
-    CLI_OPTS.networkSeed
+    CLI_OPTS.networkSeed,
+    CLI_OPTS.targetArcFactor
   );
   const lairUrls = [];
   sandboxPaths.forEach((sandbox) => {
@@ -12765,7 +12779,7 @@ electron.app.whenReady().then(async () => {
     }
   });
   SANDBOX_PROCESSES.push(sandboxHandle);
-  for (var i = 0; i < CLI_OPTS.numAgents; i++) {
+  for (let i = 0; i < CLI_OPTS.numAgents; i++) {
     const zomeCallSigner = await rustUtils.ZomeCallSigner.connect(lairUrls[i], "pass");
     const adminPort = portsInfo[i].admin_port;
     const adminWs = await AdminWebsocket.connect({