@camstack/system 1.2.91 → 1.2.93

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { $ as objectInputDeclaresAddonId, At as createEvent, B as isArrayOutputSchema, Bt as resolveCapMount, Dt as asJsonObject$1, G as kebabToCamel, H as isObjectInput, K as lifecycleJobSchema, Lt as parseJsonObject, Nt as expandCapMethods, Ot as asNumber, R as extractNestedAddonId, Rt as parseJsonUnknown$1, Tt as ReadinessTimeoutError, Ut as EventCategory$1, V as isCollectionArrayMethod, Vt as scopeKey, W as isVoidInput, X as looseSchema, Y as logLevelAtMost, at as scopesAllowDeviceCap, bt as DEVICE_STATUS_METHOD, d as METHOD_ACCESS_MAP, f as RUNTIME_DEFAULTS, gt as errMsg$1, it as scopesAllowAddon, jt as emitDownForOwnedCaps, kt as asString$1, nt as procedureAuthKey, t as ALL_CAPABILITY_DEFINITIONS, vt as DATAPLANE_SECRET_HEADER$1, wt as ReadinessRegistry, y as addonSettingsCapability, yt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, zt as readinessKey } from "./dist-DhrTd8LL.mjs";
+import { At as asString$1, Bt as readinessKey, Et as ReadinessTimeoutError, G as isVoidInput, H as isCollectionArrayMethod, Ht as scopeKey, K as kebabToCamel, Mt as emitDownForOwnedCaps, Ot as asJsonObject$1, Pt as expandCapMethods, Rt as parseJsonObject, Tt as ReadinessRegistry, U as isObjectInput, V as isArrayOutputSchema, Vt as resolveCapMount, Wt as EventCategory$1, X as logLevelAtMost, Z as looseSchema, _t as errMsg$1, at as scopesAllowAddon, bt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, d as METHOD_ACCESS_MAP, et as objectInputDeclaresAddonId, f as RUNTIME_DEFAULTS, jt as createEvent, kt as asNumber, ot as scopesAllowDeviceCap, q as lifecycleJobSchema, rt as procedureAuthKey, t as ALL_CAPABILITY_DEFINITIONS, xt as DEVICE_STATUS_METHOD, y as addonSettingsCapability, yt as DATAPLANE_SECRET_HEADER$1, z as extractNestedAddonId, zt as parseJsonUnknown$1 } from "./dist-F1XDQDE1.mjs";
 import { AlertCenterAddon } from "./builtins/alerts/alerts.addon.mjs";
 import "./builtins/alerts/index.mjs";
 import { t as formatLogLine } from "./formatter-B7qW8bPJ.mjs";
@@ -24,7 +24,7 @@ import { SystemConfigAddon } from "./builtins/system-config/system-config.addon.
 import "./builtins/system-config/index.mjs";
 import { WinstonDestination, WinstonLoggingAddon } from "./builtins/winston-logging/index.mjs";
 import { a as parseTokenizedUrl, c as collectModelFiles, d as downloadModel, f as ensureModel, h as isModelDownloaded, i as parseRangeHeader, l as deleteModelFromDisk, m as getModelFilePath, n as contentTypeFor, o as resolveFilePath, p as fetchJson, r as createAuthenticatedFileServer, s as ModelDownloadService, t as createFileDataPlaneHandler, u as downloadFile } from "./file-data-plane-CuE_hBli.mjs";
-import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as runNpm, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as resolveNpmInvocation, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as installManifestNativeDeps, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, wt as createAddonDataPlaneFacility, x as getCapUsageRegistry, xt as resolveAddonClass, y as CapUsageRegistry, yt as copyBundledNativeModules, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-fWzdEasI.mjs";
+import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as runNpm, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as resolveNpmInvocation, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as installManifestNativeDeps, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, wt as createAddonDataPlaneFacility, x as getCapUsageRegistry, xt as resolveAddonClass, y as CapUsageRegistry, yt as copyBundledNativeModules, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-D3hP9W8D.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-BWmQ5i-o.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-F__gp_VX.mjs";
 import { z } from "zod";
@@ -1173,6 +1173,11 @@ var LogManager = class {
 	subscribers = /* @__PURE__ */ new Map();
 	deviceNameLookup = null;
 	/**
+	* The bootstrap stdout sink, while one is attached. Detached — and its
+	* replay suppressed — when {@link STDOUT_DESTINATION_ADDON_ID} registers.
+	*/
+	bootstrapConsole = null;
+	/**
 	* `perAddonCapacity` bounds EACH addon's bucket, not the total — a chatty addon
 	* evicts only its own lines, so quiet addons keep their sparse history.
 	*
@@ -1274,13 +1279,34 @@ var LogManager = class {
 	setDestinationEnabledCheck(check) {
 		this.isDestinationEnabled = check ?? void 0;
 	}
+	/**
+	* Attach a minimal console sink that carries the boot log until the real
+	* `console-logging` builtin registers — see {@link STDOUT_DESTINATION_ADDON_ID}.
+	*
+	* Registered WITHOUT an `addonId` on purpose: the per-destination toggle
+	* could otherwise hide the one window an operator cannot read any other way
+	* (a hub that dies before pass 3 would emit nothing at all). It is detached
+	* the moment the stdout owner arrives, so stdout never carries two copies.
+	*
+	* Idempotent: a second call while one is attached is a no-op.
+	*/
+	attachBootstrapConsole(dest) {
+		if (this.bootstrapConsole !== null) return;
+		this.bootstrapConsole = dest;
+		this.destinations.push({ dest });
+	}
 	addDestination(dest, opts = {}) {
-		const replay = opts.replay ?? true;
+		const supersedesBootstrap = this.bootstrapConsole !== null && opts.addonId === "console-logging";
+		if (supersedesBootstrap && this.bootstrapConsole !== null) {
+			this.removeDestination(this.bootstrapConsole);
+			this.bootstrapConsole = null;
+		}
+		const replay = opts.replay ?? !supersedesBootstrap;
 		this.destinations.push(opts.addonId === void 0 ? { dest } : {
 			dest,
 			addonId: opts.addonId
 		});
-		if (replay) for (const entry of this.ringBuffer.query({})) try {
+		if (replay) for (const entry of [...this.ringBuffer.query({})].reverse()) try {
 			dest.write(entry);
 		} catch {}
 	}
@@ -93933,9 +93959,18 @@ function createStreamProbeBrokerService(deps) {
 */
 var HEALTH_MONITOR_TICK_MS = 3e4;
 var HEALTH_MONITOR_GRACE_PERIOD_MS = 5 * 6e4;
-/** Retry intervals after each failure (capped — never stops). */
+/**
+* Retry intervals after each failure (capped — never stops).
+*
+* The FIRST interval must not exceed {@link HEALTH_MONITOR_TICK_MS}: retries can
+* only fire on a tick, so anything larger just adds latency on top of a wait the
+* tick already imposes. It used to be 60 s, which meant an addon that failed to
+* load because the boot was still moving files around stayed down for 60–90 s
+* — a schedule that presumed a healthy hub (docs/design/boot-to-usable-camera.md,
+* item E). Pinned by `addon-health-monitor.spec.ts`.
+*/
 var HEALTH_MONITOR_RETRY_INTERVALS_MS = [
-	6e4,
+	3e4,
 	12e4,
 	3e5
 ];

package/dist/kernel/addon-health-monitor.d.ts

@@ -35,7 +35,16 @@ import { IEventBus, IScopedLogger } from '@camstack/types';
  */
 export declare const HEALTH_MONITOR_TICK_MS = 30000;
 export declare const HEALTH_MONITOR_GRACE_PERIOD_MS: number;
-/** Retry intervals after each failure (capped — never stops). */
+/**
+ * Retry intervals after each failure (capped — never stops).
+ *
+ * The FIRST interval must not exceed {@link HEALTH_MONITOR_TICK_MS}: retries can
+ * only fire on a tick, so anything larger just adds latency on top of a wait the
+ * tick already imposes. It used to be 60 s, which meant an addon that failed to
+ * load because the boot was still moving files around stayed down for 60–90 s
+ * — a schedule that presumed a healthy hub (docs/design/boot-to-usable-camera.md,
+ * item E). Pinned by `addon-health-monitor.spec.ts`.
+ */
 export declare const HEALTH_MONITOR_RETRY_INTERVALS_MS: readonly number[];
 export type AddonHealthPhase = 'pending' | 'healthy' | 'failed';
 export interface AddonHealthState {

package/dist/logging/log-manager.d.ts

@@ -14,6 +14,17 @@ export interface ILogDestination {
  * SAME orchestrator toggle as every other destination.
  */
 export declare const LOG_BUFFER_DESTINATION_ID = "log-buffer";
+/**
+ * The addon that OWNS stdout. Every other shipped destination writes somewhere
+ * else (winston is file-only, loki is remote), so this is the single id whose
+ * arrival means "the real console is up now".
+ *
+ * It exists because the console destination is a core builtin that boots after
+ * the whole runner plan: a measured hub boot produced no stdout for ~40 s and
+ * then flushed the backlog newest-first. {@link LogManager.attachBootstrapConsole}
+ * covers that window, and this constant is how the handover is recognised.
+ */
+export declare const STDOUT_DESTINATION_ADDON_ID = "console-logging";
 export declare class LogManager {
     private readonly ringBuffer;
     /**
@@ -34,6 +45,11 @@ export declare class LogManager {
     private isDestinationEnabled?;
     private readonly subscribers;
     private deviceNameLookup;
+    /**
+     * The bootstrap stdout sink, while one is attached. Detached — and its
+     * replay suppressed — when {@link STDOUT_DESTINATION_ADDON_ID} registers.
+     */
+    private bootstrapConsole;
     /**
      * `perAddonCapacity` bounds EACH addon's bucket, not the total — a chatty addon
      * evicts only its own lines, so quiet addons keep their sparse history.
@@ -78,6 +94,18 @@ export declare class LogManager {
     }): void;
     /** Set the per-destination enablement check (see {@link isDestinationEnabled}). */
     setDestinationEnabledCheck(check: ((addonId: string) => boolean) | null): void;
+    /**
+     * Attach a minimal console sink that carries the boot log until the real
+     * `console-logging` builtin registers — see {@link STDOUT_DESTINATION_ADDON_ID}.
+     *
+     * Registered WITHOUT an `addonId` on purpose: the per-destination toggle
+     * could otherwise hide the one window an operator cannot read any other way
+     * (a hub that dies before pass 3 would emit nothing at all). It is detached
+     * the moment the stdout owner arrives, so stdout never carries two copies.
+     *
+     * Idempotent: a second call while one is attached is a no-op.
+     */
+    attachBootstrapConsole(dest: ILogDestination): void;
     addDestination(dest: ILogDestination, opts?: {
         replay?: boolean;
         addonId?: string;

package/dist/{manifest-python-deps-C0zkl1Ae.js → manifest-python-deps-BZO_eMn-.js}

@@ -1678,13 +1678,7 @@ function createBrokerDeviceManagerApi(opts) {
 		});
 		return child;
 	};
-	const PROBE_RETRY_BACKOFF_MS = [
-		5 * 6e4,
-		15 * 6e4,
-		30 * 6e4,
-		60 * 6e4,
-		60 * 6e4
-	];
+	const PROBE_RETRY_BACKOFF_MS = _camstack_types_addon.BOOT_RECOVERY_BACKOFF_MS;
 	const probeRetryTimers = /* @__PURE__ */ new Map();
 	const cancelProbeRetry = (deviceId) => {
 		const timer = probeRetryTimers.get(deviceId);

package/dist/{manifest-python-deps-fWzdEasI.mjs → manifest-python-deps-D3hP9W8D.mjs}

@@ -10,7 +10,7 @@ import * as os from "node:os";
 import { tmpdir } from "node:os";
 import * as fs from "node:fs";
 import { createServer } from "node:http";
-import { DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, readNodePin, scopeKey, sleep, withCapInputDefaults } from "@camstack/types/addon";
+import { BOOT_RECOVERY_BACKOFF_MS, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, readNodePin, scopeKey, sleep, withCapInputDefaults } from "@camstack/types/addon";
 import { TRPCClientError, createTRPCClient } from "@trpc/client";
 import { connect, createServer as createServer$1 } from "node:net";
 //#region src/kernel/moleculer/addon-data-plane-facility.ts
@@ -1676,13 +1676,7 @@ function createBrokerDeviceManagerApi(opts) {
 		});
 		return child;
 	};
-	const PROBE_RETRY_BACKOFF_MS = [
-		5 * 6e4,
-		15 * 6e4,
-		30 * 6e4,
-		60 * 6e4,
-		60 * 6e4
-	];
+	const PROBE_RETRY_BACKOFF_MS = BOOT_RECOVERY_BACKOFF_MS;
 	const probeRetryTimers = /* @__PURE__ */ new Map();
 	const cancelProbeRetry = (deviceId) => {
 		const timer = probeRetryTimers.get(deviceId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.91",
+  "version": "1.2.93",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",