@camstack/agent 1.0.8 → 1.1.1

package/dist/cli.mjs

@@ -2,10 +2,13 @@
 import { createRequire as __cr } from 'node:module'; const require = globalThis.require ?? __cr(import.meta.url);
 import {
   startAgent
-} from "./chunk-U6SD2QE6.mjs";
+} from "./chunk-EMAD7O4T.mjs";
 
 // src/cli.ts
+import { existsSync } from "fs";
+import { Module } from "module";
 import * as os from "os";
+import * as path from "path";
 function parseArgs(argv) {
   const args2 = {};
   for (let i = 2; i < argv.length; i++) {
@@ -114,6 +117,28 @@ if (args.secret && !process.env["CAMSTACK_CLUSTER_SECRET"]) {
 if (args.statusPort && !process.env["CAMSTACK_STATUS_PORT"]) {
   process.env["CAMSTACK_STATUS_PORT"] = args.statusPort;
 }
+if (!process.env["CAMSTACK_FRAMEWORK_DIR"]) {
+  const scriptPath = process.argv[1];
+  if (scriptPath) {
+    const frameworkDir = path.resolve(path.dirname(scriptPath), "..", "..");
+    const frameworkModules = path.join(frameworkDir, "node_modules");
+    if (existsSync(path.join(frameworkModules, "@camstack", "shm-ring"))) {
+      process.env["CAMSTACK_FRAMEWORK_DIR"] = frameworkDir;
+      const existingNodePath = process.env["NODE_PATH"];
+      process.env["NODE_PATH"] = existingNodePath ? `${frameworkModules}${path.delimiter}${existingNodePath}` : frameworkModules;
+      Module._initPaths();
+      console.log(
+        `[Agent] Self-contained framework detected \u2014 CAMSTACK_FRAMEWORK_DIR=${frameworkDir}`
+      );
+      if (!process.env["CAMSTACK_BUNDLED_ADDONS_DIR"]) {
+        const bundledAddons = path.join(frameworkDir, "addons");
+        if (existsSync(bundledAddons)) {
+          process.env["CAMSTACK_BUNDLED_ADDONS_DIR"] = bundledAddons;
+        }
+      }
+    }
+  }
+}
 if (!process.env["CAMSTACK_NODE_ID"]) {
   process.env["CAMSTACK_NODE_ID"] = os.hostname();
 }

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 * as os from 'node:os'\nimport { startAgent } from './agent-bootstrap.js'\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// 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":";;;;;;;AASA,YAAY,QAAQ;AAapB,SAAS,UAAU,MAAkC;AACnD,QAAMA,QAAgB,CAAC;AACvB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,OAAO,KAAK,IAAI,CAAC;AACvB,YAAQ,KAAK;AAAA,MACX,KAAK;AAAA,MACL,KAAK;AACH,YAAI,QAAQ,QAAQ,CAAC,MAAM,MAAM,SAAS,GAAG;AAC3C,UAAAA,MAAK,OAAO;AACZ;AAAA,QACF;AACA,QAAAA,MAAK,MAAM;AACX;AACA;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,QAAAA,MAAK,OAAO;AACZ;AACA;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,QAAAA,MAAK,OAAO;AACZ;AACA;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,QAAAA,MAAK,WAAW;AAChB;AACA;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,QAAAA,MAAK,SAAS;AACd;AACA;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,QAAAA,MAAK,aAAa;AAClB;AACA;AAAA,MACF,KAAK;AACH,QAAAA,MAAK,OAAO;AACZ;AAAA,MACF;AACE,YAAI,CAAC,IAAI,WAAW,GAAG,KAAK,CAACA,MAAK,KAAK;AACrC,UAAAA,MAAK,MAAM;AACX;AAAA,QACF;AACA,gBAAQ,MAAM,qBAAqB,GAAG,EAAE;AACxC,QAAAA,MAAK,OAAO;AAAA,IAChB;AAAA,EACF;AACA,SAAOA;AACT;AAEA,SAAS,YAAkB;AACzB,UAAQ;AAAA,IACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BF,KAAK;AAAA,EACL;AACF;AAEA,IAAM,OAAO,UAAU,QAAQ,IAAI;AAEnC,IAAI,KAAK,MAAM;AACb,YAAU;AACV,UAAQ,KAAK,CAAC;AAChB;AAGA,IAAI,KAAK,OAAO,CAAC,QAAQ,IAAI,sBAAsB,GAAG;AACpD,UAAQ,IAAI,sBAAsB,IAAI,KAAK;AAC7C;AACA,IAAI,KAAK,QAAQ,CAAC,QAAQ,IAAI,kBAAkB,GAAG;AACjD,UAAQ,IAAI,kBAAkB,IAAI,KAAK;AACzC;AACA,IAAI,KAAK,QAAQ,CAAC,QAAQ,IAAI,mBAAmB,GAAG;AAClD,UAAQ,IAAI,mBAAmB,IAAI,KAAK;AAC1C;AACA,IAAI,KAAK,YAAY,CAAC,QAAQ,IAAI,oBAAoB,GAAG;AACvD,UAAQ,IAAI,oBAAoB,IAAI,KAAK;AAC3C;AACA,IAAI,KAAK,UAAU,CAAC,QAAQ,IAAI,yBAAyB,GAAG;AAC1D,UAAQ,IAAI,yBAAyB,IAAI,KAAK;AAChD;AACA,IAAI,KAAK,cAAc,CAAC,QAAQ,IAAI,sBAAsB,GAAG;AAC3D,UAAQ,IAAI,sBAAsB,IAAI,KAAK;AAC7C;AAGA,IAAI,CAAC,QAAQ,IAAI,kBAAkB,GAAG;AACpC,UAAQ,IAAI,kBAAkB,IAAO,YAAS;AAChD;AAIA,IAAI,CAAC,QAAQ,IAAI,sBAAsB,GAAG;AACxC,UAAQ,IAAI,oEAA+D;AAC3E,UAAQ,IAAI,2DAA2D;AACzE;AAEA,WAAW,EAAE,MAAM,CAAC,QAAiB;AACnC,UAAQ,MAAM,wBAAwB,GAAG;AACzC,UAAQ,KAAK,CAAC;AAChB,CAAC;","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 } 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      Module._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.d.ts

@@ -75,6 +75,8 @@ interface AgentServiceDeps {
      * presenting a matching `clusterSecretHash`. (Cluster-secret gate.)
      */
     readonly expectedClusterSecretHash?: string;
+    /** Pull-install a published addon from npm/GHCR (wired by agent-bootstrap). */
+    readonly installFromNpm?: (packageName: string, version: string) => Promise<void>;
 }
 declare function createAgentService(deps: AgentServiceDeps): ServiceSchema;
 

package/dist/index.js

@@ -176,6 +176,37 @@ async function applyDeployedBundle(input) {
   return { addonDir: liveDir };
 }
 
+// src/fetch-bundle-from-hub.ts
+var import_node_crypto2 = require("crypto");
+var import_undici = require("undici");
+async function fetchBundleFromHub(opts) {
+  const authHeader = { Authorization: `Bearer ${opts.token}`, "accept-encoding": "identity" };
+  const res = opts.fetchImpl ? await opts.fetchImpl(opts.url, { headers: authHeader }) : await (0, import_undici.fetch)(opts.url, {
+    headers: authHeader,
+    dispatcher: new import_undici.Agent({ connect: { rejectUnauthorized: false } })
+  });
+  if (!res.ok) {
+    throw new Error(`bundle fetch failed: HTTP ${res.status}`);
+  }
+  const buffer = Buffer.from(await res.arrayBuffer());
+  if (buffer.length !== opts.bytes) {
+    throw new Error(`bundle bytes mismatch: expected ${opts.bytes}, got ${buffer.length}`);
+  }
+  const sha = (0, import_node_crypto2.createHash)("sha256").update(buffer).digest("hex");
+  if (sha !== opts.sha256) {
+    throw new Error(`bundle sha256 mismatch: expected ${opts.sha256}, got ${sha}`);
+  }
+  return buffer;
+}
+
+// src/apply-model-distribution.ts
+async function applyModelDistribution(seam, params) {
+  seam.mkdirp(seam.modelsDir);
+  const buffer = await seam.fetchBundle(params.source);
+  await seam.extract(buffer, seam.modelsDir);
+  return { success: true, modelId: params.modelId, format: params.format, path: seam.modelsDir };
+}
+
 // src/agent-service.ts
 var deploySwapLogger = {
   info: (msg) => console.log(`[Agent] ${msg}`),
@@ -209,6 +240,28 @@ async function withTimeout(p, ms, fallback) {
   }
 }
 var METRICS_SNAPSHOT_TIMEOUT_MS = 2e3;
+function resolveDeployAction(seam) {
+  return async (params) => {
+    const { addonId, source, bundle } = params;
+    if (source && (0, import_system.isAddonDeploySource)(source)) {
+      if (source.kind === "npm") {
+        await seam.installFromNpm(addonId, source.version);
+        return { success: true, addonId };
+      }
+      const buf2 = await seam.fetchBundle(source);
+      const { addonDir: addonDir2 } = await seam.applyBundle(buf2);
+      seam.onApplied(addonDir2);
+      return { success: true, addonId, path: addonDir2 };
+    }
+    if (bundle === void 0) {
+      throw new Error("$agent.deploy: no source descriptor and no legacy bundle provided");
+    }
+    const buf = typeof bundle === "string" ? Buffer.from(bundle, "base64") : bundle;
+    const { addonDir } = await seam.applyBundle(buf);
+    seam.onApplied(addonDir);
+    return { success: true, addonId, path: addonDir };
+  };
+}
 function readHubAddressFromConfig(configPath) {
   if (!configPath) return null;
   try {
@@ -381,8 +434,7 @@ function createAgentService(deps) {
       deploy: {
         handler: async (ctx) => {
           const { params } = ctx;
-          const { addonId, bundle } = params;
-          const bufferData = typeof bundle === "string" ? Buffer.from(bundle, "base64") : bundle;
+          const { addonId, source, bundle } = params;
           const { execFile } = await import("child_process");
           const { promisify } = await import("util");
           const execFileAsync = promisify(execFile);
@@ -400,17 +452,74 @@ function createAgentService(deps) {
               }
             }
           };
-          const { addonDir } = await applyDeployedBundle({
-            addonsDir: deps.addonsDir,
-            addonId,
-            bundle: bufferData,
-            extract,
-            logger: deploySwapLogger
-          });
-          for (const declId of readDeployedAddonIds(addonDir)) {
-            deps.loadedAddons.delete(declId);
-          }
-          return { success: true, addonId, path: addonDir };
+          const seam = {
+            installFromNpm: (pkg, v) => {
+              if (!deps.installFromNpm) {
+                throw new Error("npm deploy source unsupported on this agent");
+              }
+              return deps.installFromNpm(pkg, v);
+            },
+            applyBundle: (buf) => applyDeployedBundle({
+              addonsDir: deps.addonsDir,
+              addonId,
+              bundle: buf,
+              extract,
+              logger: deploySwapLogger
+            }),
+            fetchBundle: (s) => fetchBundleFromHub(s),
+            // Evict every addon DECLARATION id this package contributes
+            // from `loadedAddons` so the follow-up `$agent.reload` actually
+            // re-instantiates it. `loadDeployedAddons` skips any addon
+            // still present in `loadedAddons`; without this eviction a
+            // redeploy would leave the agent pinned to the pre-update
+            // version. The `deploy` param `addonId` is the PACKAGE name
+            // (used only as the on-disk dir), whereas `loadedAddons` is
+            // keyed by the addon DECLARATION id — they differ for scoped
+            // packages, so we read the extracted manifest to bridge them.
+            onApplied: (addonDir) => {
+              for (const declId of readDeployedAddonIds(addonDir)) {
+                deps.loadedAddons.delete(declId);
+              }
+            }
+          };
+          return resolveDeployAction(seam)({ addonId, source, bundle });
+        }
+      },
+      /**
+       * Pull a staged model tarball from the hub and untar it into this node's
+       * `<dataDir>/models` (Model Studio P2). Reuses the agent-pull machinery:
+       * `fetchBundleFromHub` verifies bytes + sha256 before extraction. The
+       * existing `isModelDownloaded` then reports the model present, so the
+       * detection-pipeline can load it locally.
+       */
+      distributeModel: {
+        handler: async (ctx) => {
+          const { params } = ctx;
+          const { execFile } = await import("child_process");
+          const { promisify } = await import("util");
+          const execFileAsync = promisify(execFile);
+          const modelsDir = path3.join(deps.dataDir, "models");
+          const seam = {
+            modelsDir,
+            fetchBundle: (s) => fetchBundleFromHub(s),
+            extract: async (tgz, destDir) => {
+              const tmp = path3.join(
+                destDir,
+                `.dist-${Date.now()}-${Math.random().toString(36).slice(2)}.tgz`
+              );
+              fs3.writeFileSync(tmp, tgz);
+              try {
+                await execFileAsync("tar", ["-xzf", tmp, "-C", destDir], { timeout: 6e4 });
+              } finally {
+                try {
+                  fs3.unlinkSync(tmp);
+                } catch {
+                }
+              }
+            },
+            mkdirp: (dir) => fs3.mkdirSync(dir, { recursive: true })
+          };
+          return applyModelDistribution(seam, params);
         }
       },
       /**
@@ -1082,7 +1191,10 @@ async function startAgent(configPath) {
       subtree.registerNode(params);
       triggerUpwardRegistration();
     },
-    expectedClusterSecretHash: config.secret ? (0, import_system3.hashClusterSecret)(config.secret) : void 0
+    expectedClusterSecretHash: config.secret ? (0, import_system3.hashClusterSecret)(config.secret) : void 0,
+    installFromNpm: async (pkg, version) => {
+      await installer.install(pkg, version);
+    }
   });
   broker.createService(agentServiceSchema);
   const agentTcpPort = (0, import_system3.deriveAgentListenPort)(broker.nodeID);