@camstack/server 1.1.75 → 1.2.0

package/dist/agent/register-agent-cap-dispatch.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Extracted, testable helper for registering the agent-side cap-dispatch
+ * service with a Moleculer broker.
+ *
+ * The helper is separated from `agent-bootstrap.ts` so the wiring decision
+ * (undefined → no-op; defined → create service) can be exercised in a unit
+ * test independently of the full bootstrap lifecycle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentCapDispatch = registerAgentCapDispatch;
+const agent_cap_dispatch_service_js_1 = require("./agent-cap-dispatch-service.js");
+// ---------------------------------------------------------------------------
+// Exported helper
+// ---------------------------------------------------------------------------
+/**
+ * Registers the `$agent-cap-fwd` Moleculer service with `registrar` when
+ * `agentUdsRegistry` is defined; otherwise this is a no-op.
+ *
+ * Called from `agent-bootstrap.ts` after the UDS child registry starts
+ * successfully so the hub can route `agent-child-forward` cap calls to this
+ * agent's forked children.
+ *
+ * @param registrar          Moleculer broker (or compatible double in tests).
+ * @param agentUdsRegistry   The agent's `LocalChildRegistry`; pass `undefined`
+ *                           to skip registration (UDS failed to start).
+ * @param inProcessLookup    Optional resolver for caps hosted in the agent's own
+ *                           main process (core addons); forwarded to the service
+ *                           so hub-dispatched calls to those caps resolve instead
+ *                           of failing with "no provider".
+ * @param logger             Optional scoped logger forwarded to the service.
+ */
+function registerAgentCapDispatch(registrar, agentUdsRegistry, inProcessLookup, logger) {
+    if (agentUdsRegistry === undefined)
+        return;
+    registrar.createService((0, agent_cap_dispatch_service_js_1.createAgentCapDispatchService)(registrar.nodeID, agentUdsRegistry, inProcessLookup, logger));
+}

package/dist/api/trpc/generated-cap-routers.js

@@ -5385,13 +5385,6 @@ function createCapRouter_pipelineExecutor(getProvider, createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.getDefaultSteps(methodInput);
         }),
-        reprobeEngine: trpc_middleware_js_1.adminProcedure
-            .input(zod_1.z.object({ nodeId: zod_1.z.string().optional() }).optional())
-            .output(types_79.pipelineExecutorCapability.methods.reprobeEngine.output)
-            .mutation(async ({ input, ctx }) => {
-            const p = resolveProvider('pipeline-executor', input?.nodeId, () => getProvider(ctx), createRemoteProxy);
-            return p.reprobeEngine();
-        }),
         getEngineProvisioning: trpc_middleware_js_1.protectedProcedure
             .input(types_79.pipelineExecutorCapability.methods.getEngineProvisioning.input.loose())
             .output(types_79.pipelineExecutorCapability.methods.getEngineProvisioning.output)
@@ -5707,6 +5700,22 @@ function createCapRouter_pipelineOrchestrator(getProvider, _createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.unassignPipeline(input);
         }),
+        setPipelineDevicePin: trpc_middleware_js_1.adminProcedure
+            .input(types_80.pipelineOrchestratorCapability.methods.setPipelineDevicePin.input.loose())
+            .output(types_80.pipelineOrchestratorCapability.methods.setPipelineDevicePin.output)
+            .mutation(async ({ input, ctx }) => {
+            const p = requireCapProvider('pipeline-orchestrator', () => getProvider(ctx));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.setPipelineDevicePin(input);
+        }),
+        getPipelineDevicePin: trpc_middleware_js_1.protectedProcedure
+            .input(types_80.pipelineOrchestratorCapability.methods.getPipelineDevicePin.input.loose())
+            .output(types_80.pipelineOrchestratorCapability.methods.getPipelineDevicePin.output)
+            .query(async ({ input, ctx }) => {
+            const p = requireCapProvider('pipeline-orchestrator', () => getProvider(ctx));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getPipelineDevicePin(input);
+        }),
         rebalance: trpc_middleware_js_1.adminProcedure
             .input(zod_1.z.object({ nodeId: zod_1.z.string().optional() }).optional())
             .output(types_80.pipelineOrchestratorCapability.methods.rebalance.output)
@@ -5835,14 +5844,6 @@ function createCapRouter_pipelineOrchestrator(getProvider, _createRemoteProxy) {
             const p = requireCapProvider('pipeline-orchestrator', () => getProvider(ctx));
             return p.listAgentSettings();
         }),
-        setAgentAddonDefaults: trpc_middleware_js_1.adminProcedure
-            .input(types_80.pipelineOrchestratorCapability.methods.setAgentAddonDefaults.input.loose())
-            .output(types_80.pipelineOrchestratorCapability.methods.setAgentAddonDefaults.output)
-            .mutation(async ({ input, ctx }) => {
-            const p = requireCapProvider('pipeline-orchestrator', () => getProvider(ctx));
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
-            return p.setAgentAddonDefaults(input);
-        }),
         removeAgentSettings: trpc_middleware_js_1.adminProcedure
             .input(types_80.pipelineOrchestratorCapability.methods.removeAgentSettings.input.loose())
             .output(types_80.pipelineOrchestratorCapability.methods.removeAgentSettings.output)
@@ -5891,6 +5892,14 @@ function createCapRouter_pipelineOrchestrator(getProvider, _createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.setAgentInferenceDevices(input);
         }),
+        getNodeInferenceDevices: trpc_middleware_js_1.protectedProcedure
+            .input(types_80.pipelineOrchestratorCapability.methods.getNodeInferenceDevices.input.loose())
+            .output(types_80.pipelineOrchestratorCapability.methods.getNodeInferenceDevices.output)
+            .query(async ({ input, ctx }) => {
+            const p = requireCapProvider('pipeline-orchestrator', () => getProvider(ctx));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getNodeInferenceDevices(input);
+        }),
         resetNodePipelineDefaults: trpc_middleware_js_1.adminProcedure
             .input(types_80.pipelineOrchestratorCapability.methods.resetNodePipelineDefaults.input.loose())
             .output(types_80.pipelineOrchestratorCapability.methods.resetNodePipelineDefaults.output)

package/dist/core/agent/agent-registry.service.js

@@ -64,9 +64,10 @@ const AGENT_RECONCILE_RPC_TIMEOUT_MS = 8_000;
  *     from `hubPlacements`). The hub's deploy planner already SKIPS
  *     agent-only addons, so undeploying one is a reconcile asymmetry bug.
  *
- * The hub cannot consult `AddonInstaller.AGENT_PACKAGES` directly: it
- * derives from `@camstack/agent`, which is not installed in a hub image,
- * so that list is empty hub-side. Hence this explicit allowlist.
+ * The hub keeps this explicit allowlist rather than importing
+ * `AddonInstaller.AGENT_PACKAGES` (agent-role bootstrap plumbing) into the
+ * registry service — the reconcile only needs the agent-only addon names to
+ * skip them, so a small local set keeps the two concerns decoupled.
  */
 const AGENT_BOOTSTRAP_PACKAGES = new Set([
     '@camstack/system',

package/dist/core/server-update/server-update.service.js

@@ -53,8 +53,13 @@ exports.ServerUpdateService = void 0;
  */
 const path = __importStar(require("node:path"));
 const index_js_1 = require("../../server-root/index.js");
+const system_exec_npm_js_1 = require("./system-exec-npm.js");
 class ServerUpdateService extends index_js_1.RootUpdateService {
     constructor(options) {
+        const dataDir = path.resolve(options.dataDir ??
+            options.env?.['CAMSTACK_DATA'] ??
+            process.env['CAMSTACK_DATA'] ??
+            'camstack-data');
         super({
             spec: index_js_1.HUB_ROOT_SPEC,
             envNames: {
@@ -64,15 +69,19 @@ class ServerUpdateService extends index_js_1.RootUpdateService {
             },
             logger: options.logger,
             restartServer: options.restartServer,
-            dataDir: path.resolve(options.dataDir ??
-                options.env?.['CAMSTACK_DATA'] ??
-                process.env['CAMSTACK_DATA'] ??
-                'camstack-data'),
+            dataDir,
             // dist/core/server-update/ → ../../../package.json = the running copy's
             // package.json (workspace server/backend OR the active/baked closure).
             runningPackageJsonPath: options.runningPackageJsonPath ?? path.resolve(__dirname, '..', '..', '..', 'package.json'),
             workspaceProbeDir: __dirname,
-            execNpm: options.execNpm,
+            // Default to the runNpm-backed adapter so a host without system npm (a
+            // packaged desktop app with a bare bundled Node) can still stage a root
+            // update. `cacheDir` mirrors AddonInstaller's `<dataDir>/addons/.npm-bootstrap`.
+            execNpm: options.execNpm ??
+                (0, system_exec_npm_js_1.buildSystemExecNpm)({
+                    cacheDir: path.join(dataDir, 'addons', '.npm-bootstrap'),
+                    logger: options.logger,
+                }),
             env: options.env,
             now: options.now,
         });

package/dist/core/server-update/system-exec-npm.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSystemExecNpm = buildSystemExecNpm;
+/**
+ * `buildSystemExecNpm` — the runNpm-backed `execNpm` the shared
+ * `RootUpdateService` uses to shell out to npm when staging a root-package
+ * closure (`@camstack/server` — the single root package for every node role).
+ *
+ * The engine's built-in default is a raw `execFile('npm', ...)`: on a host with
+ * NO system npm on PATH — a packaged desktop app shipping a bare bundled Node —
+ * that dies with ENOENT and a root update can never stage. Routing through
+ * `@camstack/system`'s `runNpm` solves it uniformly: resolve a working npm
+ * (system → previously-bootstrapped copy under `cacheDir` → bootstrap from the
+ * registry) and run the SAME args with it. The `cacheDir` mirrors the value
+ * `AddonInstaller` uses for its own npm bootstrap (`<dataDir>/addons/.npm-bootstrap`)
+ * so both share one bootstrapped npm per host.
+ *
+ * `runNpmFn` is a module-level DI seam (defaults to the real `runNpm`) so the
+ * arg/cwd/timeout mapping is unit-testable without touching the network.
+ */
+const system_1 = require("@camstack/system");
+function buildSystemExecNpm(options, runNpmFn = system_1.runNpm) {
+    return async (args, opts) => {
+        const { stdout } = await runNpmFn(args, {
+            cacheDir: options.cacheDir,
+            registry: options.registry,
+            logger: options.logger,
+            ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+            timeout: opts.timeoutMs,
+        });
+        return { stdout };
+    };
+}

package/dist/launcher.js

@@ -236,6 +236,14 @@ function readBootstrapRequiredAddons(dataDir, bootstrapSchema) {
 }
 async function launch() {
     const dataDir = DATA_DIR;
+    // Node role (hub | agent) — resolved ONCE here. Dynamic import keeps the
+    // launcher's zero-static-@camstack/*-import invariant intact even though
+    // `node-role.ts` imports no @camstack/* itself. The role selects both the
+    // bootstrap package set (hub → all addons; agent → AGENT_PACKAGES) and,
+    // at the very end of launch(), which runtime entry is loaded.
+    const { resolveNodeRole } = await Promise.resolve().then(() => __importStar(require('./node-role.js')));
+    const role = resolveNodeRole(process.env);
+    console.log(`[launcher] Node role: ${role}`);
     // Addons live in a real `node_modules`-shaped dir so ESM `import` resolves
     // every @camstack/* (system + addon-*) from there via the standard
     // walk-up — NODE_PATH only covers CJS, which is why forked ESM addon
@@ -319,8 +327,13 @@ async function launch() {
     // would never get installed into data/addons, aborting boot with
     // "No addon provides required infrastructure capability storage-provider".
     // The server's own package.json is always readable next to this launcher.
-    const bootstrapRequired = readBootstrapRequiredAddons(dataDir, bootstrapSchema) ?? deriveBootstrapFromSelf();
-    console.log(`[launcher] bootstrap: ${bootstrapRequired.length} required package(s)`);
+    // Role-aware default bootstrap set: the hub installs every addon-* dep of
+    // its own package.json; the agent installs ONLY the agent bootstrap subset
+    // (AGENT_PACKAGES, derived from `camstack.agentBootstrapAddons`). A
+    // config.yaml `bootstrap.requiredAddons` override still wins for both roles.
+    const roleDefaultBootstrap = role === 'agent' ? AddonInstaller.AGENT_PACKAGES : deriveBootstrapFromSelf();
+    const bootstrapRequired = readBootstrapRequiredAddons(dataDir, bootstrapSchema) ?? roleDefaultBootstrap;
+    console.log(`[launcher] bootstrap (${role}): ${bootstrapRequired.length} required package(s)`);
     await installer.ensureRequiredPackages(bootstrapRequired);
     // Reconcile the install manifest with what is on disk. Addons baked
     // into the image are copied straight into addonsDir by the container
@@ -382,9 +395,19 @@ async function launch() {
         Module._initPaths();
         console.log(`[launcher] NODE_PATH extended with: ${extraNodePaths.join(sep)}`);
     }
-    // Now safe to load main.ts (which has static imports from @camstack/system)
-    console.log('[launcher] Starting server...');
-    await Promise.resolve().then(() => __importStar(require('./main')));
+    // Now safe to load the role's runtime entry (both have static imports from
+    // @camstack/system, resolved only after the framework dir + NODE_PATH setup
+    // above). The agent boots from THIS same @camstack/server closure — there is
+    // no separate agent root package.
+    if (role === 'agent') {
+        console.log('[launcher] Starting agent runtime...');
+        const { startAgent } = await Promise.resolve().then(() => __importStar(require('./agent/main.js')));
+        await startAgent();
+    }
+    else {
+        console.log('[launcher] Starting server...');
+        await Promise.resolve().then(() => __importStar(require('./main')));
+    }
 }
 // Signal handlers — forward to default exit so NestJS shutdown hooks
 // (Moleculer broker stopped() → kills spawned workers) run cleanly.

package/dist/node-role.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveNodeRole = resolveNodeRole;
+function resolveNodeRole(env) {
+    const raw = (env['CAMSTACK_ROLE'] ?? '').trim().toLowerCase();
+    if (raw === '' || raw === 'hub')
+        return 'hub';
+    if (raw === 'agent')
+        return 'agent';
+    throw new Error(`Invalid CAMSTACK_ROLE "${raw}" — expected "hub" or "agent"`);
+}

package/dist/server-root/index.js

@@ -73,7 +73,6 @@ var require_dist = __commonJS({
     }), mod), "__toCommonJS");
     var src_exports = {};
     __export2(src_exports, {
-      AGENT_ROOT_SPEC: /* @__PURE__ */ __name(() => AGENT_ROOT_SPEC, "AGENT_ROOT_SPEC"),
       CURRENT_DIRNAME: /* @__PURE__ */ __name(() => CURRENT_DIRNAME, "CURRENT_DIRNAME"),
       DEV_UPLOADS_DIRNAME: /* @__PURE__ */ __name(() => DEV_UPLOADS_DIRNAME, "DEV_UPLOADS_DIRNAME"),
       DEV_UPLOADS_KEEP_COUNT: /* @__PURE__ */ __name(() => DEV_UPLOADS_KEEP_COUNT, "DEV_UPLOADS_KEEP_COUNT"),
@@ -193,13 +192,6 @@ var require_dist = __commonJS({
         "launcher.js"
       ]
     };
-    var AGENT_ROOT_SPEC = {
-      packageName: "@camstack/agent",
-      entryRelPath: [
-        "dist",
-        "cli.js"
-      ]
-    };
     var fs2 = __toESM2(require("fs"));
     var path2 = __toESM2(require("path"));
     var SERVER_ROOT_DIRNAME = "server-root";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.1.75",
+  "version": "1.2.0",
   "private": false,
   "files": [
     "dist",
@@ -22,22 +22,34 @@
     "test": "vitest run --reporter verbose",
     "test:watch": "vitest"
   },
+  "camstack": {
+    "agentBootstrapAddons": [
+      "@camstack/addon-pipeline",
+      "@camstack/addon-decoder-nodeav",
+      "@camstack/addon-agent-ui"
+    ],
+    "agentOnlyBootstrapAddons": [
+      "@camstack/addon-agent-ui"
+    ]
+  },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.1.62",
-    "@camstack/addon-advanced-notifier": "1.1.30",
-    "@camstack/addon-auth": "1.1.15",
-    "@camstack/addon-decoder-nodeav": "1.1.18",
-    "@camstack/addon-notifiers": "1.1.30",
-    "@camstack/addon-pipeline": "1.1.70",
-    "@camstack/addon-pipeline-orchestrator": "1.1.59",
-    "@camstack/addon-post-analysis": "1.1.41",
-    "@camstack/sdk": "1.1.30",
-    "@camstack/shm-ring": "1.0.29",
-    "@camstack/system": "1.1.63",
-    "@camstack/types": "1.1.57",
-    "@camstack/ui-library": "1.1.45",
+    "@camstack/addon-admin-ui": "1.2.0",
+    "@camstack/addon-advanced-notifier": "1.2.0",
+    "@camstack/addon-agent-ui": "1.2.0",
+    "@camstack/addon-auth": "1.2.0",
+    "@camstack/addon-decoder-nodeav": "1.2.0",
+    "@camstack/addon-notifiers": "1.2.0",
+    "@camstack/addon-pipeline": "1.2.0",
+    "@camstack/addon-pipeline-orchestrator": "1.2.0",
+    "@camstack/addon-post-analysis": "1.2.0",
+    "@camstack/sdk": "1.2.0",
+    "@camstack/shm-ring": "1.1.0",
+    "@camstack/system": "1.2.0",
+    "@camstack/types": "1.2.0",
+    "@camstack/ui-library": "1.2.0",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
+    "@fastify/cors": "^11.2.0",
     "@fastify/multipart": "^10.0.0",
     "@fastify/static": "^9.1.3",
     "@trpc/client": "^11.16.0",
@@ -47,6 +59,7 @@
     "moleculer": "^0.15.0",
     "superjson": "^2.2.6",
     "tar": "7.5.16",
+    "undici": "^7.28.0",
     "ws": "^8.20.0",
     "zod": "^4.3.6"
   },