@camstack/agent 1.1.18 → 1.1.20

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import { createRequire as __cr } from 'node:module'; const require = globalThis.require ?? __cr(import.meta.url);
 import {
   startAgent
-} from "./chunk-XEHYJVPH.mjs";
+} from "./chunk-BWAPSCEC.mjs";
 
 // src/cli.ts
 import { existsSync } from "fs";
@@ -86,6 +86,9 @@ Environment variables (override CLI args):
   CAMSTACK_DATA_DIR         Data directory path
   CAMSTACK_LOG_LEVEL        Log level
   CAMSTACK_CLUSTER_SECRET   Cluster secret
+  CAMSTACK_HUB_URL          Derived automatically from the hub address; set
+                            only to override the cross-node stream/recording
+                            pull host
 
 Examples:
   camstack-agent --hub 192.168.1.100

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CamStack Agent CLI — starts a remote agent node that connects to a hub.\n *\n * Usage:\n *   camstack-agent --hub 192.168.1.100\n *   camstack-agent --hub 192.168.1.100 --name gpu-box --data ./agent-data\n *   CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n */\nimport { existsSync } from 'node:fs'\nimport { Module as nodeModule } from 'node:module'\nimport * as os from 'node:os'\nimport * as path from 'node:path'\nimport { startAgent } from './agent-bootstrap.js'\n\n// `Module._initPaths()` re-derives the CJS search paths from a NODE_PATH set\n// after process start. It's a stable Node internal backing NODE_PATH support\n// but is absent from @types/node — declare it via merging (no cast).\ndeclare module 'node:module' {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace Module {\n    function _initPaths(): void\n  }\n}\n\ninterface CliArgs {\n  hub?: string\n  name?: string\n  data?: string\n  logLevel?: string\n  secret?: string\n  statusPort?: string\n  help?: boolean\n}\n\nfunction parseArgs(argv: readonly string[]): CliArgs {\n  const args: CliArgs = {}\n  for (let i = 2; i < argv.length; i++) {\n    const arg = argv[i]!\n    const next = argv[i + 1]\n    switch (arg) {\n      case '--hub':\n      case '-h':\n        if (arg === '-h' && !next?.match(/^[\\d.]+/)) {\n          args.help = true\n          break\n        }\n        args.hub = next\n        i++\n        break\n      case '--name':\n      case '-n':\n        args.name = next\n        i++\n        break\n      case '--data':\n      case '-d':\n        args.data = next\n        i++\n        break\n      case '--log-level':\n      case '-l':\n        args.logLevel = next\n        i++\n        break\n      case '--secret':\n      case '-s':\n        args.secret = next\n        i++\n        break\n      case '--status-port':\n      case '-p':\n        args.statusPort = next\n        i++\n        break\n      case '--help':\n        args.help = true\n        break\n      default:\n        if (!arg.startsWith('-') && !args.hub) {\n          args.hub = arg\n          break\n        }\n        console.error(`Unknown argument: ${arg}`)\n        args.help = true\n    }\n  }\n  return args\n}\n\nfunction printHelp(): void {\n  console.log(\n    `\ncamstack-agent — CamStack remote agent node\n\nUsage:\n  camstack-agent --hub <hub-address> [options]\n  camstack-agent <hub-address> [options]\n\nOptions:\n  --hub, -h <address>     Hub address (IP or hostname, e.g. 192.168.1.100)\n  --name, -n <name>       Node name (default: hostname)\n  --data, -d <path>       Data directory (default: ./camstack-data)\n  --log-level, -l <level> Log level: trace|debug|info|warn|error (default: info)\n  --secret, -s <secret>   Cluster secret (nodes must share the same secret)\n  --help                  Show this help\n\nEnvironment variables (override CLI args):\n  CAMSTACK_NODE_ID          Node identifier\n  CAMSTACK_HUB_ADDRESS      Hub address\n  CAMSTACK_DATA_DIR         Data directory path\n  CAMSTACK_LOG_LEVEL        Log level\n  CAMSTACK_CLUSTER_SECRET   Cluster secret\n\nExamples:\n  camstack-agent --hub 192.168.1.100\n  camstack-agent --hub 192.168.1.100 --name gpu-box --log-level debug\n  CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n`.trim(),\n  )\n}\n\nconst args = parseArgs(process.argv)\n\nif (args.help) {\n  printHelp()\n  process.exit(0)\n}\n\n// CLI args → env vars (env vars set externally take precedence via agent-config.ts)\nif (args.hub && !process.env['CAMSTACK_HUB_ADDRESS']) {\n  process.env['CAMSTACK_HUB_ADDRESS'] = args.hub\n}\nif (args.name && !process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = args.name\n}\nif (args.data && !process.env['CAMSTACK_DATA_DIR']) {\n  process.env['CAMSTACK_DATA_DIR'] = args.data\n}\nif (args.logLevel && !process.env['CAMSTACK_LOG_LEVEL']) {\n  process.env['CAMSTACK_LOG_LEVEL'] = args.logLevel\n}\nif (args.secret && !process.env['CAMSTACK_CLUSTER_SECRET']) {\n  process.env['CAMSTACK_CLUSTER_SECRET'] = args.secret\n}\nif (args.statusPort && !process.env['CAMSTACK_STATUS_PORT']) {\n  process.env['CAMSTACK_STATUS_PORT'] = args.statusPort\n}\n\n// Packaged-app framework resolution. In a self-contained build (e.g. the\n// Electron `.app`, where this CLI lives at `<root>/agent/dist/cli.js` and the\n// host-provided package closure at `<root>/node_modules`), addons installed\n// under the data dir cannot walk up to the framework's node_modules. Mirror the\n// Docker image's setup: point the addon-runner's resolver hook at the framework\n// (CAMSTACK_FRAMEWORK_DIR, for ESM imports) AND seed NODE_PATH (for CJS\n// `require`) so host externals (@camstack/shm-ring, sharp, node-av, …) resolve.\n// No-op in dev (workspace symlinks resolve the framework) and when an operator\n// or the Docker image has already set CAMSTACK_FRAMEWORK_DIR.\nif (!process.env['CAMSTACK_FRAMEWORK_DIR']) {\n  const scriptPath = process.argv[1]\n  if (scriptPath) {\n    const frameworkDir = path.resolve(path.dirname(scriptPath), '..', '..')\n    const frameworkModules = path.join(frameworkDir, 'node_modules')\n    // Sentinel: a host-provided native package present in the framework's\n    // node_modules confirms the self-contained layout (absent in dev).\n    if (existsSync(path.join(frameworkModules, '@camstack', 'shm-ring'))) {\n      process.env['CAMSTACK_FRAMEWORK_DIR'] = frameworkDir\n      const existingNodePath = process.env['NODE_PATH']\n      process.env['NODE_PATH'] = existingNodePath\n        ? `${frameworkModules}${path.delimiter}${existingNodePath}`\n        : frameworkModules\n      // Node reads NODE_PATH once at startup into the CJS module search paths;\n      // setting it now (post-start) only reaches CHILD processes that inherit\n      // it at spawn (the forked addon-runners). The agent's OWN main process —\n      // where bootCoreAddons imports the in-process infra builtins (storage /\n      // settings / metrics from @camstack/system) — must re-derive its search\n      // paths or those addons' host-dep requires (@camstack/types, …) fail with\n      // \"Cannot find module\" and the agent boots with NO infrastructure.\n      nodeModule._initPaths()\n      console.log(\n        `[Agent] Self-contained framework detected — CAMSTACK_FRAMEWORK_DIR=${frameworkDir}`,\n      )\n      // Also point the bootstrap installer at the bundled addons so a fresh\n      // (empty) data dir gets seeded with the agent's required packages\n      // (@camstack/system — platform-probe/storage/settings/metrics builtins —\n      // plus the bundled addons). Without this, bootCoreAddons finds no addon\n      // packages and the agent runs with NO infrastructure (no platform-probe →\n      // detection engine can't auto-pick the node's accelerator, no storage,\n      // etc.). Mirrors the Docker image's CAMSTACK_BUNDLED_ADDONS_DIR.\n      if (!process.env['CAMSTACK_BUNDLED_ADDONS_DIR']) {\n        const bundledAddons = path.join(frameworkDir, 'addons')\n        if (existsSync(bundledAddons)) {\n          process.env['CAMSTACK_BUNDLED_ADDONS_DIR'] = bundledAddons\n        }\n      }\n    }\n  }\n}\n\n// Default node name to hostname if not set\nif (!process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = os.hostname()\n}\n\n// Hub address is optional — agent starts in discovery mode without it.\n// The agent UI on :4444 lets the user configure the hub connection.\nif (!process.env['CAMSTACK_HUB_ADDRESS']) {\n  console.log('[Agent] No hub address specified — starting in discovery mode')\n  console.log('[Agent] Configure hub connection at http://localhost:4444')\n}\n\nstartAgent().catch((err: unknown) => {\n  console.error('[Agent] Fatal error:', err)\n  process.exit(1)\n})\n"],"mappings":"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","names":["args"]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CamStack Agent CLI — starts a remote agent node that connects to a hub.\n *\n * Usage:\n *   camstack-agent --hub 192.168.1.100\n *   camstack-agent --hub 192.168.1.100 --name gpu-box --data ./agent-data\n *   CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n */\nimport { existsSync } from 'node:fs'\nimport { Module as nodeModule } from 'node:module'\nimport * as os from 'node:os'\nimport * as path from 'node:path'\nimport { startAgent } from './agent-bootstrap.js'\n\n// `Module._initPaths()` re-derives the CJS search paths from a NODE_PATH set\n// after process start. It's a stable Node internal backing NODE_PATH support\n// but is absent from @types/node — declare it via merging (no cast).\ndeclare module 'node:module' {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace Module {\n    function _initPaths(): void\n  }\n}\n\ninterface CliArgs {\n  hub?: string\n  name?: string\n  data?: string\n  logLevel?: string\n  secret?: string\n  statusPort?: string\n  help?: boolean\n}\n\nfunction parseArgs(argv: readonly string[]): CliArgs {\n  const args: CliArgs = {}\n  for (let i = 2; i < argv.length; i++) {\n    const arg = argv[i]!\n    const next = argv[i + 1]\n    switch (arg) {\n      case '--hub':\n      case '-h':\n        if (arg === '-h' && !next?.match(/^[\\d.]+/)) {\n          args.help = true\n          break\n        }\n        args.hub = next\n        i++\n        break\n      case '--name':\n      case '-n':\n        args.name = next\n        i++\n        break\n      case '--data':\n      case '-d':\n        args.data = next\n        i++\n        break\n      case '--log-level':\n      case '-l':\n        args.logLevel = next\n        i++\n        break\n      case '--secret':\n      case '-s':\n        args.secret = next\n        i++\n        break\n      case '--status-port':\n      case '-p':\n        args.statusPort = next\n        i++\n        break\n      case '--help':\n        args.help = true\n        break\n      default:\n        if (!arg.startsWith('-') && !args.hub) {\n          args.hub = arg\n          break\n        }\n        console.error(`Unknown argument: ${arg}`)\n        args.help = true\n    }\n  }\n  return args\n}\n\nfunction printHelp(): void {\n  console.log(\n    `\ncamstack-agent — CamStack remote agent node\n\nUsage:\n  camstack-agent --hub <hub-address> [options]\n  camstack-agent <hub-address> [options]\n\nOptions:\n  --hub, -h <address>     Hub address (IP or hostname, e.g. 192.168.1.100)\n  --name, -n <name>       Node name (default: hostname)\n  --data, -d <path>       Data directory (default: ./camstack-data)\n  --log-level, -l <level> Log level: trace|debug|info|warn|error (default: info)\n  --secret, -s <secret>   Cluster secret (nodes must share the same secret)\n  --help                  Show this help\n\nEnvironment variables (override CLI args):\n  CAMSTACK_NODE_ID          Node identifier\n  CAMSTACK_HUB_ADDRESS      Hub address\n  CAMSTACK_DATA_DIR         Data directory path\n  CAMSTACK_LOG_LEVEL        Log level\n  CAMSTACK_CLUSTER_SECRET   Cluster secret\n  CAMSTACK_HUB_URL          Derived automatically from the hub address; set\n                            only to override the cross-node stream/recording\n                            pull host\n\nExamples:\n  camstack-agent --hub 192.168.1.100\n  camstack-agent --hub 192.168.1.100 --name gpu-box --log-level debug\n  CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n`.trim(),\n  )\n}\n\nconst args = parseArgs(process.argv)\n\nif (args.help) {\n  printHelp()\n  process.exit(0)\n}\n\n// CLI args → env vars (env vars set externally take precedence via agent-config.ts)\nif (args.hub && !process.env['CAMSTACK_HUB_ADDRESS']) {\n  process.env['CAMSTACK_HUB_ADDRESS'] = args.hub\n}\nif (args.name && !process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = args.name\n}\nif (args.data && !process.env['CAMSTACK_DATA_DIR']) {\n  process.env['CAMSTACK_DATA_DIR'] = args.data\n}\nif (args.logLevel && !process.env['CAMSTACK_LOG_LEVEL']) {\n  process.env['CAMSTACK_LOG_LEVEL'] = args.logLevel\n}\nif (args.secret && !process.env['CAMSTACK_CLUSTER_SECRET']) {\n  process.env['CAMSTACK_CLUSTER_SECRET'] = args.secret\n}\nif (args.statusPort && !process.env['CAMSTACK_STATUS_PORT']) {\n  process.env['CAMSTACK_STATUS_PORT'] = args.statusPort\n}\n\n// Packaged-app framework resolution. In a self-contained build (e.g. the\n// Electron `.app`, where this CLI lives at `<root>/agent/dist/cli.js` and the\n// host-provided package closure at `<root>/node_modules`), addons installed\n// under the data dir cannot walk up to the framework's node_modules. Mirror the\n// Docker image's setup: point the addon-runner's resolver hook at the framework\n// (CAMSTACK_FRAMEWORK_DIR, for ESM imports) AND seed NODE_PATH (for CJS\n// `require`) so host externals (@camstack/shm-ring, sharp, node-av, …) resolve.\n// No-op in dev (workspace symlinks resolve the framework) and when an operator\n// or the Docker image has already set CAMSTACK_FRAMEWORK_DIR.\nif (!process.env['CAMSTACK_FRAMEWORK_DIR']) {\n  const scriptPath = process.argv[1]\n  if (scriptPath) {\n    const frameworkDir = path.resolve(path.dirname(scriptPath), '..', '..')\n    const frameworkModules = path.join(frameworkDir, 'node_modules')\n    // Sentinel: a host-provided native package present in the framework's\n    // node_modules confirms the self-contained layout (absent in dev).\n    if (existsSync(path.join(frameworkModules, '@camstack', 'shm-ring'))) {\n      process.env['CAMSTACK_FRAMEWORK_DIR'] = frameworkDir\n      const existingNodePath = process.env['NODE_PATH']\n      process.env['NODE_PATH'] = existingNodePath\n        ? `${frameworkModules}${path.delimiter}${existingNodePath}`\n        : frameworkModules\n      // Node reads NODE_PATH once at startup into the CJS module search paths;\n      // setting it now (post-start) only reaches CHILD processes that inherit\n      // it at spawn (the forked addon-runners). The agent's OWN main process —\n      // where bootCoreAddons imports the in-process infra builtins (storage /\n      // settings / metrics from @camstack/system) — must re-derive its search\n      // paths or those addons' host-dep requires (@camstack/types, …) fail with\n      // \"Cannot find module\" and the agent boots with NO infrastructure.\n      nodeModule._initPaths()\n      console.log(\n        `[Agent] Self-contained framework detected — CAMSTACK_FRAMEWORK_DIR=${frameworkDir}`,\n      )\n      // Also point the bootstrap installer at the bundled addons so a fresh\n      // (empty) data dir gets seeded with the agent's required packages\n      // (@camstack/system — platform-probe/storage/settings/metrics builtins —\n      // plus the bundled addons). Without this, bootCoreAddons finds no addon\n      // packages and the agent runs with NO infrastructure (no platform-probe →\n      // detection engine can't auto-pick the node's accelerator, no storage,\n      // etc.). Mirrors the Docker image's CAMSTACK_BUNDLED_ADDONS_DIR.\n      if (!process.env['CAMSTACK_BUNDLED_ADDONS_DIR']) {\n        const bundledAddons = path.join(frameworkDir, 'addons')\n        if (existsSync(bundledAddons)) {\n          process.env['CAMSTACK_BUNDLED_ADDONS_DIR'] = bundledAddons\n        }\n      }\n    }\n  }\n}\n\n// Default node name to hostname if not set\nif (!process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = os.hostname()\n}\n\n// Hub address is optional — agent starts in discovery mode without it.\n// The agent UI on :4444 lets the user configure the hub connection.\nif (!process.env['CAMSTACK_HUB_ADDRESS']) {\n  console.log('[Agent] No hub address specified — starting in discovery mode')\n  console.log('[Agent] Configure hub connection at http://localhost:4444')\n}\n\nstartAgent().catch((err: unknown) => {\n  console.error('[Agent] Fatal error:', err)\n  process.exit(1)\n})\n"],"mappings":"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","names":["args"]}

package/dist/index.js

@@ -643,17 +643,108 @@ var path6 = __toESM(require("path"));
 var fs4 = __toESM(require("fs"));
 var path4 = __toESM(require("path"));
 var import_fastify = __toESM(require("fastify"));
-function resolveUiDistDir(dataDir) {
-  const candidates = [
-    path4.resolve(__dirname, "../../addon-agent-ui/dist"),
-    path4.join(dataDir, "addons", "@camstack", "addon-agent-ui", "dist"),
-    path4.join(dataDir, "agent-ui")
-  ];
-  for (const dir of candidates) {
-    if (fs4.existsSync(path4.join(dir, "index.html"))) return dir;
+
+// src/derive-hub-url.ts
+var HUB_API_PORT = 4443;
+function deriveHubUrlFromHubAddress(hubAddress) {
+  const trimmed = hubAddress.trim();
+  if (trimmed.length === 0) return void 0;
+  const afterAt = trimmed.includes("@") ? trimmed.split("@")[1] ?? "" : trimmed;
+  const authority = afterAt.split("/")[0] ?? "";
+  const host = extractHostFromAuthority(authority);
+  if (host === void 0) return void 0;
+  return `https://${host}:${HUB_API_PORT}`;
+}
+function deriveHubUrlForExport(hubUrlWasExplicit, hubAddress) {
+  if (hubUrlWasExplicit) return void 0;
+  if (hubAddress === void 0) return void 0;
+  return deriveHubUrlFromHubAddress(hubAddress);
+}
+function extractHostFromAuthority(authority) {
+  const value = authority.trim();
+  if (value.length === 0) return void 0;
+  if (value.startsWith("[")) {
+    const end = value.indexOf("]");
+    if (end > 0) return value.slice(0, end + 1);
+    return void 0;
+  }
+  const host = value.split(":")[0] ?? "";
+  return host.length > 0 ? host : void 0;
+}
+var HUB_NODE_ID = "hub";
+var IPV4_MAPPED_PREFIX = "::ffff:";
+var IPV4_DOTTED_QUAD = /^\d{1,3}(?:\.\d{1,3}){3}$/;
+function pickIpv4(ipList) {
+  if (!ipList) return null;
+  for (const ip of ipList) {
+    if (ip.includes(":")) continue;
+    if (ip.startsWith("127.")) continue;
+    return ip;
   }
   return null;
 }
+function normalizeObservedHost(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) return void 0;
+  if (trimmed.startsWith("[")) return trimmed;
+  if (trimmed.toLowerCase().startsWith(IPV4_MAPPED_PREFIX)) {
+    const mapped = trimmed.slice(IPV4_MAPPED_PREFIX.length);
+    if (IPV4_DOTTED_QUAD.test(mapped)) return mapped;
+  }
+  if (trimmed.includes(":")) return `[${trimmed}]`;
+  return trimmed;
+}
+function deriveHubUrlFromRegistry(nodes) {
+  const hub = nodes.find((node) => node.id === HUB_NODE_ID);
+  if (hub === void 0) return void 0;
+  const host = normalizeObservedHost(hub.udpAddress) ?? pickIpv4(hub.ipList) ?? hub.hostname;
+  if (host === void 0 || host.length === 0) return void 0;
+  return `https://${host}:${HUB_API_PORT}`;
+}
+
+// src/agent-http.ts
+function compareVersions(a, b) {
+  if (a === null && b === null) return 0;
+  if (a === null) return -1;
+  if (b === null) return 1;
+  const pa = a.split(".").map((s) => Number.parseInt(s, 10) || 0);
+  const pb = b.split(".").map((s) => Number.parseInt(s, 10) || 0);
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+function readUiDistCandidate(baseDir) {
+  const dir = path4.join(baseDir, "dist");
+  if (!fs4.existsSync(path4.join(dir, "index.html"))) return null;
+  let version = null;
+  try {
+    const parsed = JSON.parse(fs4.readFileSync(path4.join(baseDir, "package.json"), "utf-8"));
+    version = typeof parsed.version === "string" ? parsed.version : null;
+  } catch {
+    version = null;
+  }
+  return { dir, version };
+}
+function pickUiDist(installed, bundled) {
+  if (installed && bundled) {
+    return compareVersions(bundled.version, installed.version) > 0 ? bundled.dir : installed.dir;
+  }
+  return installed?.dir ?? bundled?.dir ?? null;
+}
+function resolveUiDistDir(dataDir, bundledAddonsDir, siblingDistDir = path4.resolve(__dirname, "../../addon-agent-ui/dist")) {
+  if (fs4.existsSync(path4.join(siblingDistDir, "index.html"))) return siblingDistDir;
+  const installed = readUiDistCandidate(path4.join(dataDir, "addons", "@camstack", "addon-agent-ui"));
+  const bundled = bundledAddonsDir ? readUiDistCandidate(path4.join(bundledAddonsDir, "addon-agent-ui")) : null;
+  const picked = pickUiDist(installed, bundled);
+  if (picked) return picked;
+  const legacy = path4.join(dataDir, "agent-ui");
+  if (fs4.existsSync(path4.join(legacy, "index.html"))) return legacy;
+  return null;
+}
 function readConfigFile(configPath) {
   if (!fs4.existsSync(configPath)) return {};
   try {
@@ -674,15 +765,6 @@ function getRegistryNodes(broker) {
     return [];
   }
 }
-function pickIpv4(ipList) {
-  if (!ipList) return null;
-  for (const ip of ipList) {
-    if (ip.includes(":")) continue;
-    if (ip.startsWith("127.")) continue;
-    return ip;
-  }
-  return null;
-}
 function resolveHubEndpoint(nodes) {
   const hub = nodes.find((n) => n.id === "hub");
   if (!hub) return null;
@@ -830,19 +912,26 @@ async function createAgentHttpServer(getBroker, config) {
     const nodes = getRegistryNodes(b);
     return mapDiscoveredNodes(nodes, b.nodeID);
   });
-  const uiDir = resolveUiDistDir(config.dataDir);
+  const uiDir = resolveUiDistDir(config.dataDir, process.env["CAMSTACK_BUNDLED_ADDONS_DIR"]);
   if (uiDir) {
     const fastifyStatic = await import("@fastify/static");
     await app.register(fastifyStatic.default, {
       root: uiDir,
       prefix: "/",
       wildcard: false,
-      decorateReply: false
+      // MUST stay true: the SPA-fallback below uses `reply.sendFile`, which
+      // only exists when the plugin decorates Reply. With `false` every
+      // fallback request 500'd with "reply.sendFile is not a function".
+      decorateReply: true
     });
     app.setNotFoundHandler(async (req, reply) => {
       if (req.url.startsWith("/api/") || req.url.startsWith("/health")) {
         return reply.status(404).send({ error: "Not found" });
       }
+      if (req.url.startsWith("/assets/")) {
+        console.warn(`[Agent] UI asset not found (stale index.html?): ${req.url}`);
+        return reply.status(404).send({ error: "Asset not found" });
+      }
       return reply.type("text/html").sendFile("index.html");
     });
     console.log(`[Agent] UI served from: ${uiDir}`);
@@ -1014,6 +1103,14 @@ var import_system4 = require("@camstack/system");
 var agentLogManager = new import_system4.LogManager(5e3);
 async function startAgent(configPath) {
   const config = loadAgentConfig(configPath);
+  const hubUrlWasExplicit = process.env["CAMSTACK_HUB_URL"] !== void 0;
+  const derivedHubUrl = deriveHubUrlForExport(hubUrlWasExplicit, config.hubAddress);
+  if (derivedHubUrl !== void 0) {
+    process.env["CAMSTACK_HUB_URL"] = derivedHubUrl;
+    console.log(
+      `[Agent] Derived CAMSTACK_HUB_URL=${derivedHubUrl} from hub address "${config.hubAddress}"`
+    );
+  }
   if (config.hubAddress) {
     console.log(
       `[Agent] Starting node "${config.nodeId}" (name="${config.name}") connecting to ${config.hubAddress}`
@@ -1060,6 +1157,13 @@ async function startAgent(configPath) {
     console.log(
       `[Agent] New config: hub=${fresh.hubAddress ?? "discovery"}, secret=${fresh.secret ? "yes" : "none"}`
     );
+    const freshHubUrl = deriveHubUrlForExport(hubUrlWasExplicit, fresh.hubAddress);
+    if (freshHubUrl !== void 0 && process.env["CAMSTACK_HUB_URL"] !== freshHubUrl) {
+      process.env["CAMSTACK_HUB_URL"] = freshHubUrl;
+      console.log(
+        `[Agent] Derived CAMSTACK_HUB_URL=${freshHubUrl} from hub address "${fresh.hubAddress}"`
+      );
+    }
     broker = (0, import_system3.createBroker)({
       nodeID: config.nodeId,
       mode: "agent",
@@ -1324,6 +1428,25 @@ async function startAgent(configPath) {
   (0, import_system3.registerEventBusService)(broker);
   broker.createService((0, import_system3.createHwAccelService)((0, import_system3.createKernelHwAccel)()));
   await broker.start();
+  let hubUrlFromRegistry;
+  const reconcileHubUrlFromRegistry = () => {
+    if (hubUrlWasExplicit) return;
+    const current = process.env["CAMSTACK_HUB_URL"];
+    if (current !== void 0 && current !== hubUrlFromRegistry) return;
+    const fromRegistry = deriveHubUrlFromRegistry(
+      getRegistryNodes(broker)
+    );
+    if (fromRegistry === void 0 || fromRegistry === current) return;
+    process.env["CAMSTACK_HUB_URL"] = fromRegistry;
+    hubUrlFromRegistry = fromRegistry;
+    console.log(`[Agent] Derived CAMSTACK_HUB_URL=${fromRegistry} from live hub connection`);
+  };
+  reconcileHubUrlFromRegistry();
+  broker.localBus.on("$node.connected", (data) => {
+    const node = data.node;
+    if (node?.id !== "hub") return;
+    reconcileHubUrlFromRegistry();
+  });
   let udsEventBridgeDispose = null;
   if (agentUdsRegistry !== void 0) {
     const agentBrokerEventBus = (0, import_system3.getBrokerEventBus)(broker);