@camstack/system 1.2.259 → 1.2.260

package/dist/builtins/camera-grid/acquire-retry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Asking again for a source that has not republished yet.
+ *
+ * A camera provider re-announces its streams a moment after the hub comes up,
+ * and a grid opened inside that window used to fail outright:
+ *
+ * ```
+ * camera grid: could not acquire every source — releasing the ones already taken
+ *   {acquired=0 error="getStreamWithCodec: profile \"low\" source \"native:sub\"
+ *    not published for device 592"}
+ * ```
+ *
+ * Observed twice on the hub at 12:02 on 2026-09-18 and gone by the next attempt.
+ * It is the same shape as a WebRTC broker being rebuilt: the answer changes with
+ * TIME, and the consumer was deciding on the first ask.
+ *
+ * The retry is BOUNDED and it changes no verdict — a camera that really has no
+ * such profile still fails, with the provider's own error, after a wait that is
+ * reported. What it stops is a grid refusing to open for the first few seconds
+ * of every hub's life.
+ */
+export interface AcquireRetryDeps {
+    /** Wall-clock ceiling for the whole acquire, across every attempt. */
+    readonly budgetMs: number;
+    readonly now: () => number;
+    readonly sleep: () => Promise<void>;
+    /** Called before each retry with the ms spent so far — for the log line. */
+    readonly onRetry?: (waitedMs: number) => void;
+}
+export declare function acquireWithRetry<T>(attempt: () => Promise<T>, deps: AcquireRetryDeps): Promise<T>;

package/dist/builtins/camera-grid/index.js

@@ -209,6 +209,19 @@ var GridCameraDevice = class extends require_dist.BaseDevice {
 	}
 };
 //#endregion
+//#region src/builtins/camera-grid/acquire-retry.ts
+async function acquireWithRetry(attempt, deps) {
+	const startedAt = deps.now();
+	for (;;) try {
+		return await attempt();
+	} catch (error) {
+		const waited = deps.now() - startedAt;
+		if (waited >= deps.budgetMs) throw error;
+		deps.onRetry?.(waited);
+		await deps.sleep();
+	}
+}
+//#endregion
 //#region src/builtins/camera-grid/grid-instances.ts
 /**
 * The operator-written grid rows.
@@ -1701,6 +1714,13 @@ async function startGridChild(ctx, plan, sources, onEnded) {
 //#region src/builtins/camera-grid/addon.ts
 var INTEGRATION_NAME = "Camera Grids";
 var RECONCILE_MS = 6e4;
+/**
+* How long a source acquire may keep asking while a provider is still coming up.
+* Long enough to cover the republish window after a hub restart, short enough
+* that a genuinely missing profile fails while the operator is still looking.
+*/
+var SOURCE_ACQUIRE_BUDGET_MS = 8e3;
+var SOURCE_ACQUIRE_PAUSE_MS = 700;
 var DEFAULTS = {
 	cameraGrids: [],
 	cameraGridTombstones: []
@@ -2013,12 +2033,27 @@ var CameraGridAddon = class extends require_dist.BaseAddon {
 			deps: {
 				logger: this.ctx.logger,
 				acquireSource: async (sourceDeviceId) => {
-					const dial = gridSourceDial(await this.ctx.api.streamBroker.getStreamWithCodec.mutate({
+					const dial = gridSourceDial(await acquireWithRetry(() => this.ctx.api.streamBroker.getStreamWithCodec.mutate({
 						deviceId: sourceDeviceId,
 						video: "copy",
 						audio: "none",
 						profile,
 						tag: `camera-grid:${String(deviceId)}:${profile}`
+					}), {
+						budgetMs: SOURCE_ACQUIRE_BUDGET_MS,
+						now: () => Date.now(),
+						sleep: () => new Promise((resolve) => setTimeout(resolve, SOURCE_ACQUIRE_PAUSE_MS)),
+						onRetry: (waitedMs) => {
+							this.ctx.logger.info("camera grid: a source has not republished yet — asking again", {
+								tags: { deviceId },
+								meta: {
+									instanceId,
+									profile,
+									sourceDeviceId,
+									waitedMs
+								}
+							});
+						}
 					}));
 					this.ctx.logger.info("camera grid: source acquired", {
 						tags: { deviceId },

package/dist/builtins/camera-grid/index.mjs

@@ -204,6 +204,19 @@ var GridCameraDevice = class extends BaseDevice {
 	}
 };
 //#endregion
+//#region src/builtins/camera-grid/acquire-retry.ts
+async function acquireWithRetry(attempt, deps) {
+	const startedAt = deps.now();
+	for (;;) try {
+		return await attempt();
+	} catch (error) {
+		const waited = deps.now() - startedAt;
+		if (waited >= deps.budgetMs) throw error;
+		deps.onRetry?.(waited);
+		await deps.sleep();
+	}
+}
+//#endregion
 //#region src/builtins/camera-grid/grid-instances.ts
 /**
 * The operator-written grid rows.
@@ -1696,6 +1709,13 @@ async function startGridChild(ctx, plan, sources, onEnded) {
 //#region src/builtins/camera-grid/addon.ts
 var INTEGRATION_NAME = "Camera Grids";
 var RECONCILE_MS = 6e4;
+/**
+* How long a source acquire may keep asking while a provider is still coming up.
+* Long enough to cover the republish window after a hub restart, short enough
+* that a genuinely missing profile fails while the operator is still looking.
+*/
+var SOURCE_ACQUIRE_BUDGET_MS = 8e3;
+var SOURCE_ACQUIRE_PAUSE_MS = 700;
 var DEFAULTS = {
 	cameraGrids: [],
 	cameraGridTombstones: []
@@ -2008,12 +2028,27 @@ var CameraGridAddon = class extends BaseAddon {
 			deps: {
 				logger: this.ctx.logger,
 				acquireSource: async (sourceDeviceId) => {
-					const dial = gridSourceDial(await this.ctx.api.streamBroker.getStreamWithCodec.mutate({
+					const dial = gridSourceDial(await acquireWithRetry(() => this.ctx.api.streamBroker.getStreamWithCodec.mutate({
 						deviceId: sourceDeviceId,
 						video: "copy",
 						audio: "none",
 						profile,
 						tag: `camera-grid:${String(deviceId)}:${profile}`
+					}), {
+						budgetMs: SOURCE_ACQUIRE_BUDGET_MS,
+						now: () => Date.now(),
+						sleep: () => new Promise((resolve) => setTimeout(resolve, SOURCE_ACQUIRE_PAUSE_MS)),
+						onRetry: (waitedMs) => {
+							this.ctx.logger.info("camera grid: a source has not republished yet — asking again", {
+								tags: { deviceId },
+								meta: {
+									instanceId,
+									profile,
+									sourceDeviceId,
+									waitedMs
+								}
+							});
+						}
 					}));
 					this.ctx.logger.info("camera grid: source acquired", {
 						tags: { deviceId },

package/package.json

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