@camstack/system 1.2.118 → 1.2.120

package/dist/kernel/isolated-builtin-phase.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Isolated builtins are not one spawn wave.
+ *
+ * Snapshot (D123) persists behind `settings-store`, so it must boot AFTER
+ * the in-process door. sqlite-settings IS the engine behind that door: spawn
+ * it in the consumer wave and every in-process builtin initialises against a
+ * missing store — the D44 empty-read failure, just with a fork in the way.
+ *
+ * `infra` = provides a capability in {@link INFRA_CAPABILITIES} → spawn
+ * BEFORE in-process builtins. `consumer` = everything else → spawn AFTER.
+ */
+export interface CapabilityName {
+    readonly name: string;
+}
+export type IsolatedBuiltinPhase = 'infra' | 'consumer';
+export declare function isolatedBuiltinPhase(capabilities: readonly CapabilityName[]): IsolatedBuiltinPhase;
+export interface IsolatedBuiltinWaves {
+    readonly infra: readonly string[];
+    readonly consumers: readonly string[];
+}
+export declare function partitionIsolatedBuiltinIds(ids: readonly string[], capabilitiesOf: (id: string) => readonly CapabilityName[]): IsolatedBuiltinWaves;
+export interface WaitUntilReadyOptions {
+    readonly timeoutMs: number;
+    readonly intervalMs: number;
+    readonly what: string;
+}
+/**
+ * Spawn of an infra isolate returns when the child process exists, not when
+ * its UDS handshake has put the engine in the parent's `getCollection`.
+ * In-process builtins that read the door before that handshake throw D44
+ * ("nothing behind it") and are skipped for the rest of the boot.
+ */
+export declare function waitUntilReady(isReady: () => boolean, options: WaitUntilReadyOptions): Promise<void>;

package/dist/kernel/settings-door-view.d.ts

@@ -0,0 +1,7 @@
+import { ISettingsStoreProvider } from '@camstack/types';
+import { AddonSettingsView } from './config-manager.js';
+export interface DoorSectionAccess {
+    getSection(section: string): Record<string, unknown>;
+    setSection(section: string, patch: Record<string, unknown>): void | Promise<void>;
+}
+export declare function createDoorSettingsView(addonId: string, door: ISettingsStoreProvider, sections: DoorSectionAccess): AddonSettingsView;

package/dist/{manifest-python-deps-CwBbX4Ut.js → manifest-python-deps-76dZLxD0.js}

@@ -1850,6 +1850,10 @@ function callDeviceManager(api, method, input) {
 }
 function createBrokerDeviceManagerApi(opts) {
 	const { api, addonId, nodeId, eventBus, registry } = opts;
+	const deviceSliceSource = (0, _camstack_types_addon.createEventBusSliceSource)({
+		eventBus,
+		api
+	});
 	let selfApi;
 	const deviceRebuildFactories = /* @__PURE__ */ new Map();
 	const buildContext = (stableId, id, parentDeviceId = null, initialRuntimeState = {}, persistedConfig = {}, deviceMeta = null) => {
@@ -1894,7 +1898,7 @@ function createBrokerDeviceManagerApi(opts) {
 				metadata: null
 			},
 			fetchDevice: async (deviceId) => {
-				return (0, _camstack_types_addon.createDeviceProxy)(api, await api.deviceManager.getBindings.query({ deviceId }));
+				return (0, _camstack_types_addon.createDeviceProxy)(api, await api.deviceManager.getBindings.query({ deviceId }), { stateSource: deviceSliceSource });
 			},
 			get devices() {
 				return selfApi;
@@ -7743,6 +7747,10 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 	const api = (0, _trpc_client.createTRPCClient)({ links });
 	const scopedLogger = options?.createLogger?.(addonId) ?? (runtime.mode === "broker" ? createRemoteLogger(runtime.broker, addonId) : createUdsLogger(runtime.client, addonId, nodeId));
 	const scopedEventBus = runtime.mode === "broker" ? createBrokerEventBus(runtime.broker, addonId) : createUdsEventBus(runtime.client, addonId);
+	const deviceSliceSource = (0, _camstack_types_addon.createEventBusSliceSource)({
+		eventBus: scopedEventBus,
+		api
+	});
 	const workerDisposerChain = new _camstack_types_addon.DisposerChain({ onError: (err, index) => {
 		scopedLogger.error(`Disposer #${index} threw during teardown`, { meta: { error: err instanceof Error ? err.message : String(err) } });
 	} });
@@ -7994,10 +8002,10 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		fetchDevice: async (deviceId) => {
 			const cached = bindingCache.get(deviceId);
-			if (cached) return (0, _camstack_types_addon.createDeviceProxy)(api, cached);
+			if (cached) return (0, _camstack_types_addon.createDeviceProxy)(api, cached, { stateSource: deviceSliceSource });
 			const binding = await api.deviceManager.getBindings.query({ deviceId });
 			bindingCache.set(deviceId, binding);
-			return (0, _camstack_types_addon.createDeviceProxy)(api, binding);
+			return (0, _camstack_types_addon.createDeviceProxy)(api, binding, { stateSource: deviceSliceSource });
 		},
 		useCapability(capName, scope = { type: "global" }) {
 			return getOrCreateHandle(capName, scope, Number.POSITIVE_INFINITY);

package/dist/{manifest-python-deps-SGdbr9D5.mjs → manifest-python-deps-DZSNlHjU.mjs}

@@ -12,7 +12,7 @@ import * as fs from "node:fs";
 import { createServer } from "node:http";
 import * as v8 from "node:v8";
 import * as vm from "node:vm";
-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 { BOOT_RECOVERY_BACKOFF_MS, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, createEventBusSliceSource, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, readNodePin, scopeKey, sleep, withCapInputDefaults } from "@camstack/types/addon";
 import { connect, createServer as createServer$1 } from "node:net";
 import { TRPCClientError, createTRPCClient } from "@trpc/client";
 //#region src/kernel/heap-watch.ts
@@ -1846,6 +1846,10 @@ function callDeviceManager(api, method, input) {
 }
 function createBrokerDeviceManagerApi(opts) {
 	const { api, addonId, nodeId, eventBus, registry } = opts;
+	const deviceSliceSource = createEventBusSliceSource({
+		eventBus,
+		api
+	});
 	let selfApi;
 	const deviceRebuildFactories = /* @__PURE__ */ new Map();
 	const buildContext = (stableId, id, parentDeviceId = null, initialRuntimeState = {}, persistedConfig = {}, deviceMeta = null) => {
@@ -1890,7 +1894,7 @@ function createBrokerDeviceManagerApi(opts) {
 				metadata: null
 			},
 			fetchDevice: async (deviceId) => {
-				return createDeviceProxy(api, await api.deviceManager.getBindings.query({ deviceId }));
+				return createDeviceProxy(api, await api.deviceManager.getBindings.query({ deviceId }), { stateSource: deviceSliceSource });
 			},
 			get devices() {
 				return selfApi;
@@ -7739,6 +7743,10 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 	const api = createTRPCClient({ links });
 	const scopedLogger = options?.createLogger?.(addonId) ?? (runtime.mode === "broker" ? createRemoteLogger(runtime.broker, addonId) : createUdsLogger(runtime.client, addonId, nodeId));
 	const scopedEventBus = runtime.mode === "broker" ? createBrokerEventBus(runtime.broker, addonId) : createUdsEventBus(runtime.client, addonId);
+	const deviceSliceSource = createEventBusSliceSource({
+		eventBus: scopedEventBus,
+		api
+	});
 	const workerDisposerChain = new DisposerChain({ onError: (err, index) => {
 		scopedLogger.error(`Disposer #${index} threw during teardown`, { meta: { error: err instanceof Error ? err.message : String(err) } });
 	} });
@@ -7990,10 +7998,10 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		fetchDevice: async (deviceId) => {
 			const cached = bindingCache.get(deviceId);
-			if (cached) return createDeviceProxy(api, cached);
+			if (cached) return createDeviceProxy(api, cached, { stateSource: deviceSliceSource });
 			const binding = await api.deviceManager.getBindings.query({ deviceId });
 			bindingCache.set(deviceId, binding);
-			return createDeviceProxy(api, binding);
+			return createDeviceProxy(api, binding, { stateSource: deviceSliceSource });
 		},
 		useCapability(capName, scope = { type: "global" }) {
 			return getOrCreateHandle(capName, scope, Number.POSITIVE_INFINITY);

package/dist/{retired-settings-keys-DHRXLMPn.js → retired-settings-keys-DlIuGG4o.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-C2_1HCpW.js");
+const require_dist = require("./dist-CX9qXYC4.js");
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/dist/{retired-settings-keys-Czd76yLZ.mjs → retired-settings-keys-Dt0-obcq.mjs}

@@ -1,4 +1,4 @@
-import { kt as asJsonObject } from "./dist-DCTpBXm4.mjs";
+import { kt as asJsonObject } from "./dist-DNbsZxNv.mjs";
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.118",
+  "version": "1.2.120",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",
@@ -53,7 +53,11 @@
         "category": "system",
         "name": "SQLite Settings",
         "entry": "./dist/builtins/sqlite-storage/sqlite-settings.addon.js",
-        "description": "The relational ENGINE behind the data door (SQLite WAL). Registers `data-store-provider`, an internal collection cap; the public `settings-store` door is owned by `storage-orchestrator`, which dispatches here. Callers never reach this addon directly — that is what makes the engine replaceable. It ALSO registers `vector-store` (sqlite-vec) from the same database file and the same open handle.",
+        "description": "The relational ENGINE behind the data door (SQLite WAL). Registers `data-store-provider`, an internal collection cap; the public `settings-store` door is owned by `storage-orchestrator`, which dispatches here. Callers never reach this addon directly — that is what makes the engine replaceable. It ALSO registers `vector-store` (sqlite-vec) from the same database file and the same open handle. Runs in its OWN process (`execution.isolate`) — `better-sqlite3` `Statement.run` does not belong on the event loop that serves the API ([D181]).",
+        "execution": {
+          "isolate": true,
+          "heapProfile": "heavy"
+        },
         "capabilities": [
           {
             "name": "data-store-provider"