@camstack/system 1.1.35 → 1.1.37

package/dist/{dist-DlGZpWo8.mjs → dist-CU3lb_Ys.mjs}

@@ -1,5 +1,5 @@
 import { z } from "zod";
-//#region ../types/dist/sleep-Cc14_yxc.mjs
+//#region ../types/dist/sleep-DJaTV2D7.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -721,10 +721,6 @@ function hydrateField(field, values) {
 		};
 	}
 	const rawValue = storedValue !== void 0 ? storedValue : defaultValue !== void 0 ? defaultValue : null;
-	if (field.type === "password") return {
-		...field,
-		value: ""
-	};
 	const value = field.type === "textarea" && field.isJson && rawValue !== null && typeof rawValue === "object" ? JSON.stringify(rawValue, null, 2) : rawValue;
 	return {
 		...field,
@@ -2606,13 +2602,32 @@ function event(data) {
 function isDeviceConfigCap(def) {
 	return def?.deviceConfig !== void 0;
 }
-var StaticDirOutputSchema = z.object({ staticDir: z.string() });
-var VersionOutputSchema = z.object({ version: z.string() });
+var StaticDirOutputSchema$1 = z.object({ staticDir: z.string() });
+var VersionOutputSchema$1 = z.object({ version: z.string() });
 var adminUiCapability = {
 	name: "admin-ui",
 	scope: "system",
 	mode: "singleton",
 	internal: true,
+	methods: {
+		getStaticDir: method(z.void(), StaticDirOutputSchema$1),
+		getVersion: method(z.void(), VersionOutputSchema$1)
+	}
+};
+var StaticDirOutputSchema = z.object({ staticDir: z.string() });
+var VersionOutputSchema = z.object({ version: z.string() });
+/**
+* viewer-ui — serves the CamStack VIEWER web build (the Expo/React-Native
+* universal client's PWA export) from the hub, alongside admin-ui. Mirrors
+* `admin-ui` exactly: a singleton, server-internal cap exposing the static
+* dist directory + build version so `main.ts` can mount the SPA under a
+* dedicated prefix.
+*/
+var viewerUiCapability = {
+	name: "viewer-ui",
+	scope: "system",
+	mode: "singleton",
+	internal: true,
 	methods: {
 		getStaticDir: method(z.void(), StaticDirOutputSchema),
 		getVersion: method(z.void(), VersionOutputSchema)
@@ -7707,7 +7722,7 @@ var BoundingBoxSchema = z.object({
 	w: z.number(),
 	h: z.number()
 });
-var SpatialDetectionSchema = z.object({
+z.object({
 	class: z.string(),
 	originalClass: z.string(),
 	score: z.number(),
@@ -7912,11 +7927,6 @@ var PipelineSchemaSchema = z.object({
 	selectedEngine: PipelineEngineChoiceSchema,
 	slots: z.array(PipelineSlotSchemaSchema).readonly()
 });
-var DetectorOutputSchema = z.object({
-	detections: z.array(SpatialDetectionSchema).readonly(),
-	inferenceMs: z.number(),
-	modelId: z.string()
-});
 var EngineProvisioningSchema = z.object({
 	runtimeId: z.enum([
 		"onnx",
@@ -8082,23 +8092,23 @@ var pipelineExecutorCapability = {
 			auth: "admin"
 		}),
 		/**
-		* Reset ONE node's detection-pipeline to its factory defaults, forcing
-		* regeneration of the (now hardware-aware) default object-detection
-		* model. `nodeId` is the ROUTING key — the generated cap-router strips
-		* it (default `nodeIdMode: 'routing'`, same as `getSelectedEngine` /
-		* `getDefaultSteps`) and dispatches to that node, so the provider method
-		* runs ON the target node and receives no `nodeId`.
+		* Clear THIS node's executor-side PER-DEVICE settings stores (the
+		* per-camera step overrides the object-detection root reads via
+		* `applyDeviceOverridesToTree`). `nodeId` is the ROUTING key — the
+		* generated cap-router strips it (default `nodeIdMode: 'routing'`) and
+		* dispatches to that node, so the provider method runs ON the target
+		* node and receives no `nodeId`.
 		*
-		* Clears the node's persisted global pipeline seed (`pipelineSteps`) +
-		* legacy engine blob (`pipelineEngine`) and every device's per-camera
-		* step overrides, then re-seeds the hardware-aware default tree. Returns
-		* the regenerated object-detection model id (null when the default tree
-		* has no detector for this node's engine format) so the caller can
-		* verify the reset without a second round-trip.
+		* This is the slimmed executor leg of the orchestrator's
+		* `resetNodePipelineDefaults` flow (which owns the real reset: node
+		* addonDefaults pins + per-camera orchestrator overrides). The legacy
+		* `resetToDefault` — which reset a persisted global step-tree seed
+		* nothing in the live per-camera path read — was removed together with
+		* that seed.
 		*/
-		resetToDefault: method(z.object({ nodeId: z.string() }), z.object({
+		clearDeviceOverrides: method(z.object({ nodeId: z.string() }), z.object({
 			success: z.literal(true),
-			regeneratedModelId: z.string().nullable()
+			clearedDevices: z.number()
 		}), {
 			kind: "mutation",
 			auth: "admin"
@@ -8144,11 +8154,6 @@ var pipelineExecutorCapability = {
 			modelId: z.string(),
 			format: ModelFormatSchema$1
 		}), z.object({ success: z.literal(true) }), { kind: "mutation" }),
-		detect: method(z.object({
-			addonId: z.string(),
-			frame: FrameInputSchema,
-			config: z.record(z.string(), z.unknown()).optional()
-		}), DetectorOutputSchema),
 		/**
 		* Stateless single-frame execution. Callers (runner, benchmark) pass
 		* the complete `engine` + `steps` tree; the executor holds no state
@@ -11041,7 +11046,9 @@ var AddonPageDeclarationSchema$1 = z.object({
 	icon: z.string(),
 	path: z.string(),
 	remoteName: z.string(),
-	bundle: z.string()
+	bundle: z.string(),
+	section: z.string().optional(),
+	sectionLabel: z.string().optional()
 });
 var AddonPageInfoSchema = z.object({
 	addonId: z.string(),
@@ -11086,7 +11093,18 @@ var AddonPageDeclarationSchema = z.object({
 	* the static-file route can compute an mtime-based cache-buster URL
 	* without a separate filesystem stat.
 	*/
-	bundle: z.string()
+	bundle: z.string(),
+	/**
+	* Sidebar section this page docks into. Well-known ids: `'detection'`,
+	* `'cluster'`, `'administration'` — the page renders inside that group.
+	* Any OTHER string creates (or joins) a custom section rendered after
+	* the built-in groups; its label comes from `sectionLabel` (first
+	* declaration wins), falling back to the id. Absent → the legacy
+	* "Addon Pages" group.
+	*/
+	section: z.string().optional(),
+	/** Display label for a CUSTOM `section` id (ignored for well-known ids). */
+	sectionLabel: z.string().optional()
 });
 var addonPagesSourceCapability = {
 	name: "addon-pages-source",
@@ -11364,6 +11382,17 @@ var WidgetMetadataSchema = z.object({
 		deviceContext: z.boolean().default(false),
 		integrationContext: z.boolean().default(false)
 	}),
+	/**
+	* Loadable BEFORE authentication. The normal widget registry listing
+	* (`addon-widgets.listWidgets`) is auth-gated, so a pre-auth surface
+	* (the login page) cannot discover a widget through it. A widget that
+	* declares `preAuth: true` marks itself as safe to mount on a pre-auth
+	* screen — it is surfaced through the PUBLIC `auth.listLoginMethods`
+	* login-method contribution channel (see `login-method.cap.ts`) rather
+	* than the authenticated registry, and its bundle is served by the
+	* public `/api/addon-widgets/:addonId/*` static route. Defaults false.
+	*/
+	preAuth: z.boolean().optional().default(false),
 	/** Dashboard placement HINTS (operator can override per instance). */
 	defaultSize: WidgetSizeEnum.default("md"),
 	allowedSizes: z.array(WidgetSizeEnum).readonly().default([
@@ -11802,6 +11831,87 @@ var authProviderCapability = {
 	mount: { kind: "skip" }
 };
 /**
+* `login-method` — collection cap through which auth addons contribute
+* their pre-auth login surfaces to the login page. This is the SINGLE,
+* generic mechanism that supersedes the dead `auth.listProviders` reader:
+* every auth addon (OIDC, magic-link, WebAuthn/passkey) registers a
+* `login-method` provider and the PUBLIC `auth.listLoginMethods`
+* procedure aggregates them for the unauthenticated login page.
+*
+* A contribution is a discriminated union on `kind`:
+*
+*  - `redirect` — a declarative button. The login page renders a generic
+*    button that navigates to `startUrl` (an addon-owned HTTP route).
+*    Covers OIDC (`/addon/auth-oidc/<id>/start`) and magic-link with
+*    ZERO shell-side JS. A future SSO addon plugs in the same way — the
+*    login page needs NO change.
+*
+*  - `widget` — a Module-Federation widget the login page mounts (via
+*    `loadRemoteBundle`) for an in-page ceremony. Covers the passkey
+*    login ceremony, which must run `@simplewebauthn/browser` INSIDE the
+*    addon bundle. The referenced widget also declares `preAuth: true` in
+*    its `addon-widgets-source` catalog entry. `auth.listLoginMethods`
+*    stamps a public `bundleUrl` from `addonId` + `bundle`.
+*
+* Every contribution carries a `stage`:
+*  - `primary`        — shown on the first credentials screen (OIDC /
+*                       magic-link buttons; a future usernameless passkey).
+*  - `second-factor`  — shown AFTER the password leg, gated on the
+*                       returned `factors` (passkey-as-2FA today).
+*
+* `mount: skip` — the cap is read server-side by the core auth router
+* (`registry.getCollection('login-method')`), never mounted as its own
+* tRPC router.
+*/
+/** When a login method renders in the two-phase login flow. */
+var LoginStageEnum = z.enum(["primary", "second-factor"]);
+/**
+* A declarative redirect button — the login page navigates to `startUrl`.
+* OIDC and magic-link contribute this; a future SSO addon does too.
+*/
+var RedirectLoginMethodSchema = z.object({
+	kind: z.literal("redirect"),
+	/** Stable id within the login-method set (e.g. `auth-oidc/google`). */
+	id: z.string(),
+	/** Operator-facing button label. */
+	label: z.string(),
+	/** lucide-react icon name. */
+	icon: z.string().optional(),
+	/** Addon-owned HTTP route the button navigates to (GET). */
+	startUrl: z.string(),
+	stage: LoginStageEnum
+});
+/**
+* A Module-Federation widget the login page mounts for an in-page
+* ceremony. `bundle` + `addonId` let `auth.listLoginMethods` stamp a
+* public `bundleUrl`; `remote` is the MF descriptor `loadRemoteBundle`
+* consumes. No `bundleUrl` here — it is server-stamped on the public
+* output so the addon never encodes the static-route scheme.
+*/
+var WidgetLoginMethodSchema = z.object({
+	kind: z.literal("widget"),
+	/** Stable id within the login-method set (e.g. `auth-webauthn/passkey-login`). */
+	id: z.string(),
+	/** Owning addon id — drives the public bundle URL + the MF namespace. */
+	addonId: z.string(),
+	/** Bundle filename inside the addon's dist dir (`remoteEntry.js`). */
+	bundle: z.string(),
+	/** MF remote descriptor — `{ remoteName, exposedModule, componentKey }`. */
+	remote: WidgetRemoteSchema,
+	stage: LoginStageEnum
+});
+/** One login-method contribution — redirect button OR pre-auth widget. */
+var LoginMethodContributionSchema = z.discriminatedUnion("kind", [RedirectLoginMethodSchema, WidgetLoginMethodSchema]);
+var loginMethodCapability = {
+	name: "login-method",
+	scope: "system",
+	mode: "collection",
+	internal: true,
+	methods: { getLoginMethods: method(z.void(), z.array(LoginMethodContributionSchema).readonly()) },
+	/** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+	mount: { kind: "skip" }
+};
+/**
 * Orchestrator-side destination metadata. The orchestrator computes
 * `id = <addonId>:<subId>` from its provider lookup so consumers
 * (admin UI, restore flow) see one canonical key.
@@ -15034,7 +15144,12 @@ var AgentPipelineSettingsSchema = z.object({
 	detectWeight: z.number().positive().optional(),
 	/** Node is eligible to run the detection pipeline (decode + inference). */
 	detect: z.boolean().optional(),
-	/** Node is eligible to host decoder sessions. */
+	/**
+	* DEPRECATED AND IGNORED. Decode is always co-located with its frame
+	* consumer, so decode eligibility IS detect eligibility. Kept optional in
+	* the schema ONLY so persisted stores written before the removal still
+	* parse — no code reads it and no write path emits it.
+	*/
 	decode: z.boolean().optional(),
 	/** Node is eligible to run audio-analyzer sessions. */
 	audio: z.boolean().optional(),
@@ -15095,25 +15210,6 @@ var PipelineAssignmentSchema = z.object({
 	assignedAt: z.number()
 });
 /**
-* Decoder placement record. Symmetric to `PipelineAssignmentSchema` but for
-* the decoder-node placement domain (`balanceDecoder` decision: manual pin
-* → co-located with pipeline → capacity).
-*/
-var DecoderAssignmentSchema = z.object({
-	deviceId: z.number(),
-	/** Moleculer node id of the decoder provider currently responsible for this camera. */
-	decoderNodeId: z.string(),
-	/** True when the assignment was set manually via `assignDecoder`, false when chosen by the balancer. */
-	pinned: z.boolean(),
-	/** Why this assignment was made — useful for debugging the decoder balancer. */
-	reason: z.enum([
-		"manual",
-		"co-located",
-		"capacity",
-		"hardware-affinity"
-	])
-});
-/**
 * Per-agent load summary surfaced to the load balancer + dashboards.
 * Aggregated from each runner's `getLocalLoad` cap call.
 */
@@ -15400,21 +15496,6 @@ var pipelineOrchestratorCapability = {
 		* present. Defaults to `{ ownerNodeId: 'hub' }`.
 		*/
 		getIngestOwner: method(z.void(), IngestOwnerSchema),
-		/** Pin a device's decoder to a specific node. */
-		assignDecoder: method(z.object({
-			deviceId: z.number(),
-			nodeId: z.string()
-		}), z.void(), {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		/** Clear a device's decoder pin (revert to auto). */
-		unassignDecoder: method(z.object({ deviceId: z.number() }), z.void(), {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		/** Get every camera's decoder placement. */
-		getDecoderAssignments: method(z.void(), z.array(DecoderAssignmentSchema).readonly()),
 		/** Pin a device's audio analysis to a specific cluster node. */
 		assignAudio: method(z.object({
 			deviceId: z.number(),
@@ -15446,23 +15527,6 @@ var pipelineOrchestratorCapability = {
 			pinned: z.boolean(),
 			assignedAt: z.number()
 		}))),
-		/**
-		* Get one camera's decoder placement (computed if not yet pinned).
-		*
-		* ADVISORY today: reports the orchestrator's decoder preference only.
-		* Actual decode placement is broker-owned (local-node pin + frame-plane
-		* co-location guard). Reserved to become the binding source/decoder-owner
-		* control in the stream-LB epic (Phase 2).
-		*
-		* `pipelineNodeId` is the node already chosen to run inference for
-		* this camera. When provided, the balancer prefers co-location with
-		* it; omitted → falls back to the last known assignment in the
-		* `assignments` map and finally to 'hub'.
-		*/
-		getDecoderAssignment: method(z.object({
-			deviceId: z.number(),
-			pipelineNodeId: z.string().optional()
-		}), DecoderAssignmentSchema),
 		/** Read one agent's settings. Null when not yet seeded. */
 		getAgentSettings: method(z.object({ agentNodeId: z.string() }), AgentPipelineSettingsSchema.nullable()),
 		/** Enumerate every agent's settings (hub + remote runners). */
@@ -15532,14 +15596,15 @@ var pipelineOrchestratorCapability = {
 		* `enabledDecoderNodes`, `enabledAudioNodes`, `remoteSourcingNodes`).
 		* Each flag is optional in the patch: omit a flag to leave it unchanged,
 		* pass `null` to reset it to the node default (`hub` → capable, every
-		* other node → not). Detection/decode/audio eligibility is derived from
-		* these flags across the cluster; changing them re-derives the enabled
-		* sets and reconciles dispatch immediately.
+		* other node → not). Detection/audio eligibility is derived from these
+		* flags across the cluster; changing them re-derives the enabled sets
+		* and reconciles dispatch immediately. There is NO separate decode flag:
+		* decode is always co-located with its frame consumer, so decode
+		* eligibility IS detect eligibility.
 		*/
 		setAgentCapabilities: method(z.object({
 			agentNodeId: z.string(),
 			detect: z.boolean().nullable().optional(),
-			decode: z.boolean().nullable().optional(),
 			audio: z.boolean().nullable().optional(),
 			ingest: z.boolean().nullable().optional()
 		}), z.object({ success: z.literal(true) }), {
@@ -15562,6 +15627,34 @@ var pipelineOrchestratorCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Reset one node's pipeline to its hardware-aware defaults — the HONEST
+		* reset (replaces the executor's legacy `resetToDefault`, which cleared a
+		* dead persisted step-tree seed nothing in the live path read):
+		*   (a) strips every `modelId` pin from that node's
+		*       `agentSettings.addonDefaults` (cells revert to Auto — the node
+		*       resolves its own hardware-aware format default at runtime);
+		*   (b) clears per-camera step overrides scoped to that node
+		*       (`stepOverridesByAgent[node]` + the wholesale
+		*       `pipelineByAgent[node]` escape hatch);
+		*   (c) clears the executor-side per-device settings stores on that node
+		*       (`pipelineExecutor.clearDeviceOverrides`);
+		*   (d) hot-reloads every camera assigned to the node.
+		*
+		* Returns the EFFECTIVE post-reset object-detection model for the node
+		* (the executor's pure hardware-aware default) so the UI can report what
+		* will actually run — not a value that never reaches the live path.
+		*/
+		resetNodePipelineDefaults: method(z.object({ agentNodeId: z.string() }), z.object({
+			success: z.literal(true),
+			/** Hardware-aware default detection model now in effect on the node (null when unresolvable). */
+			effectiveModelId: z.string().nullable(),
+			/** Number of cameras whose node-scoped overrides were cleared. */
+			clearedCameraOverrides: z.number()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Read one camera's settings. Null when never touched (inherits agent defaults fully). */
 		getCameraSettings: method(z.object({ deviceId: z.number() }), CameraPipelineSettingsSchema.nullable()),
 		/** Set or clear the 3-state toggle for one (camera, addonId). Pass `enabled: null` to clear and revert to agent default. */
@@ -15654,6 +15747,151 @@ var pipelineOrchestratorCapability = {
 	}
 };
 /**
+* server-management — per-NODE singleton capability for a node's ROOT
+* package lifecycle (runtime-updatable node packages, phase 2: hub + docker
+* agents).
+*
+* Each node's root package (`@camstack/server` on the hub, `@camstack/agent`
+* on agents) carries the whole software stack in its npm dep tree, so ONE
+* version describes the node. Updates install into
+* `<dataDir>/server-root/versions/<v>/` and apply on restart via the baked
+* starter (probation boot + auto-rollback to N-1).
+*
+* Providers:
+*   - HUB: `ServerUpdateService` behind the `server-provided` mount
+*     (`buildServerProviders` in trpc.router.ts) — the default target for
+*     unpinned calls.
+*   - AGENT: `AgentUpdateService` registered by the agent bootstrap under
+*     the synthetic `agent-runtime` addonId and declared in the agent's
+*     `$hub.registerNode` manifest.
+*
+* Node routing: singleton caps get the codegen/runtime-builder `nodeId`
+* injection on every method — `input.nodeId` (or `nodePin(nodeId)` from the
+* SDK) routes the call to that node's provider via the standard remote
+* proxy (`createCapabilityProxy` → `$agent-cap-fwd` → the agent's
+* in-process provider lookup). No `nodeId` → the hub's own provider.
+*
+* Spec: docs/superpowers/specs/2026-07-12-runtime-updatable-node-packages-design.md
+*/
+/**
+* Where the running hub's code was loaded from:
+*  - `workspace` — dev checkout (tsx / workspace dist); the starter defers to
+*    plain resolution and runtime updates are refused.
+*  - `baked`     — the immutable image seed closure (no data-dir root active).
+*  - `data-root` — the runtime-updatable `<dataDir>/server-root` closure.
+*/
+var ServerBootModeSchema = z.enum([
+	"workspace",
+	"baked",
+	"data-root"
+]);
+/**
+* Update lifecycle state:
+*  - `idle` / `checking` / `staging` — steady / in-flight registry work.
+*  - `pending-restart` — a version is staged and the node has NOT yet
+*    restarted onto it (still running the OLD version).
+*  - `awaiting-confirmation` — the node HAS restarted onto the staged version
+*    (it is the active probation boot) and is waiting to confirm boot-health.
+*    Apply/rollback are refused in this state and the node must NOT be
+*    manually restarted, or the probation boot auto-rolls-back.
+*/
+var ServerUpdateStateSchema = z.enum([
+	"idle",
+	"checking",
+	"staging",
+	"pending-restart",
+	"awaiting-confirmation"
+]);
+var ServerRollbackInfoSchema = z.object({
+	/** The version that failed (or was manually rolled back). */
+	fromVersion: z.string(),
+	/** The version rolled back to; null = the baked seed. */
+	toVersion: z.string().nullable(),
+	atMs: z.number(),
+	reason: z.string()
+});
+var ServerPackageStatusSchema = z.object({
+	/** Root package name (`@camstack/server` on the hub). */
+	packageName: z.string(),
+	/** Version of the code the running process ACTUALLY loaded. */
+	runningVersion: z.string().nullable(),
+	/** Node.js runtime version the node's process runs on (`process.versions.node`). */
+	nodeRuntimeVersion: z.string().nullable(),
+	/** Active data-dir root version; null when booted from seed/workspace. */
+	activeVersion: z.string().nullable(),
+	/** N-1 version kept for rollback; null when no previous version exists. */
+	previousVersion: z.string().nullable(),
+	/** Version of the immutable baked seed closure (image fallback). */
+	seedVersion: z.string().nullable(),
+	/** Latest registry version from the most recent check (null = never checked). */
+	latestVersion: z.string().nullable(),
+	updateAvailable: z.boolean(),
+	bootMode: ServerBootModeSchema,
+	updateState: ServerUpdateStateSchema,
+	/** Version staged + awaiting its probation boot, when one is pending. */
+	pendingVersion: z.string().nullable(),
+	/** Set when the last freshly-activated version failed its boot health-check. */
+	rolledBack: ServerRollbackInfoSchema.nullable(),
+	/**
+	* True when `server-root/state.json` EXISTS but is unreadable/corrupt — the
+	* hub is running from the baked seed (or workspace) while installed data-dir
+	* versions are being IGNORED. Surfaced as a warning in the UI.
+	*/
+	stateFileCorrupt: z.boolean(),
+	lastCheckedAtMs: z.number().nullable()
+});
+var ServerUpdateCheckResultSchema = z.object({
+	packageName: z.string(),
+	runningVersion: z.string().nullable(),
+	latestVersion: z.string().nullable(),
+	updateAvailable: z.boolean(),
+	checkedAtMs: z.number(),
+	/** Non-null when the registry lookup failed (offline, bad registry, …). */
+	error: z.string().nullable()
+});
+var ServerUpdateActionResultSchema = z.object({
+	accepted: z.boolean(),
+	targetVersion: z.string().nullable(),
+	/** True when a graceful restart was scheduled to apply the change. */
+	restarting: z.boolean(),
+	message: z.string()
+});
+var serverManagementCapability = {
+	name: "server-management",
+	scope: "system",
+	mode: "singleton",
+	methods: {
+		getServerPackageStatus: method(z.void(), ServerPackageStatusSchema, { auth: "admin" }),
+		checkServerUpdate: method(z.void(), ServerUpdateCheckResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		applyServerUpdate: method(z.object({ 
+		/** Explicit target version; omitted = latest from the registry. */
+version: z.string().optional() }), ServerUpdateActionResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		rollbackServerUpdate: method(z.void(), ServerUpdateActionResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
+		* Plain process restart of the node's root process — no version change.
+		* The supervisor (docker restart policy / launchd / Electron main)
+		* relaunches and the starter loads the SAME active version. Refused while
+		* a stage is in flight or a version is already staged awaiting restart
+		* (use apply/rollback instead, so the pending version is not skipped).
+		*/
+		restartServer: method(z.void(), ServerUpdateActionResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		})
+	},
+	/** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+	mount: { kind: "server-provided" }
+};
+/**
 * Query filter for settings-store collections.
 */
 var QueryFilterSchema = z.object({
@@ -18519,6 +18757,16 @@ var TopologyCategorySchema = z.object({
 	healthy: z.number(),
 	addons: z.array(TopologyCategoryAddonSchema).readonly()
 });
+/**
+* The node's runtime-updatable ROOT package (`@camstack/server` on the hub,
+* `@camstack/agent` on agents) as reported by its `registerNode` manifest —
+* version visibility for the Server management surface. Nullable: offline
+* rows and pre-phase-2 nodes report none.
+*/
+var TopologyRootPackageSchema = z.object({
+	name: z.string(),
+	version: z.string()
+});
 var TopologyNodeSchema = z.object({
 	id: z.string(),
 	name: z.string(),
@@ -18542,7 +18790,8 @@ var TopologyNodeSchema = z.object({
 		status: z.string()
 	})).readonly(),
 	processes: z.array(TopologyProcessSchema).readonly(),
-	categories: z.array(TopologyCategorySchema).readonly()
+	categories: z.array(TopologyCategorySchema).readonly(),
+	rootPackage: TopologyRootPackageSchema.nullable()
 });
 var CapUsageEdgeSchema = z.object({
 	callerAddonId: z.string(),
@@ -20005,6 +20254,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	localNetworkCapability,
 	lockControlCapability,
 	logDestinationCapability,
+	loginMethodCapability,
 	mediaPlayerCapability,
 	meshNetworkCapability,
 	metricsProviderCapability,
@@ -20040,6 +20290,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	rebootCapability,
 	recordingCapability,
 	scriptRunnerCapability,
+	serverManagementCapability,
 	settingsStoreCapability,
 	smokeCapability,
 	smtpProviderCapability,
@@ -20064,6 +20315,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	valveCapability,
 	vibrationCapability,
 	videoclipsCapability,
+	viewerUiCapability,
 	waterHeaterCapability,
 	weatherCapability,
 	webrtcSessionCapability,
@@ -22120,6 +22372,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"loginMethod.getLoginMethods": {
+		capName: "login-method",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"mediaPlayer.next": {
 		capName: "media-player",
 		capScope: "device",
@@ -22750,23 +23008,23 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"pipelineExecutor.deleteModel": {
+	"pipelineExecutor.clearDeviceOverrides": {
 		capName: "pipeline-executor",
 		capScope: "system",
 		addonId: null,
 		access: "delete"
 	},
-	"pipelineExecutor.deleteTemplate": {
+	"pipelineExecutor.deleteModel": {
 		capName: "pipeline-executor",
 		capScope: "system",
 		addonId: null,
 		access: "delete"
 	},
-	"pipelineExecutor.detect": {
+	"pipelineExecutor.deleteTemplate": {
 		capName: "pipeline-executor",
 		capScope: "system",
 		addonId: null,
-		access: "view"
+		access: "delete"
 	},
 	"pipelineExecutor.downloadModel": {
 		capName: "pipeline-executor",
@@ -22912,12 +23170,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"pipelineExecutor.resetToDefault": {
-		capName: "pipeline-executor",
-		capScope: "system",
-		addonId: null,
-		access: "delete"
-	},
 	"pipelineExecutor.runAudioTest": {
 		capName: "pipeline-executor",
 		capScope: "system",
@@ -22978,12 +23230,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"pipelineOrchestrator.assignDecoder": {
-		capName: "pipeline-orchestrator",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"pipelineOrchestrator.assignPipeline": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -23062,18 +23308,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineOrchestrator.getDecoderAssignment": {
-		capName: "pipeline-orchestrator",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
-	"pipelineOrchestrator.getDecoderAssignments": {
-		capName: "pipeline-orchestrator",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
 	"pipelineOrchestrator.getGlobalMetrics": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -23122,6 +23356,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"pipelineOrchestrator.resetNodePipelineDefaults": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"pipelineOrchestrator.resolvePipeline": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -23194,12 +23434,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"pipelineOrchestrator.unassignDecoder": {
-		capName: "pipeline-orchestrator",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"pipelineOrchestrator.unassignPipeline": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -23506,6 +23740,36 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"serverManagement.applyServerUpdate": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"serverManagement.checkServerUpdate": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"serverManagement.getServerPackageStatus": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"serverManagement.restartServer": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"serverManagement.rollbackServerUpdate": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"settingsStore.count": {
 		capName: "settings-store",
 		capScope: "system",
@@ -24370,6 +24634,18 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"viewerUi.getStaticDir": {
+		capName: "viewer-ui",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"viewerUi.getVersion": {
+		capName: "viewer-ui",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"waterHeater.setAway": {
 		capName: "water-heater",
 		capScope: "device",