@camstack/system 1.2.444 → 1.2.445

package/dist/builtins/calendars/calendars.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D1vECb_6.js");
+const require_dist = require("../../dist-DgOG8flk.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let zod = require("zod");
 //#region src/builtins/calendars/calendar-color.ts
@@ -32,70 +32,72 @@ function defaultCalendarColor(calendarId) {
 	return CALENDAR_COLOR_PALETTE[Math.abs(hash) % CALENDAR_COLOR_PALETTE.length];
 }
 //#endregion
+//#region src/builtins/calendars/record-kinds.ts
+/**
+* Record kinds owned by calendars (phase 4).
+*/
+/** Legacy collection / adoptsFrom target. */
+var CALENDARS_USER_PREFS_COLLECTION = "calendars:user-prefs";
+var CalendarUserPrefsBodySchema = zod.z.object({
+	calendars: require_dist.CalendarPreferencesSchema.shape.calendars,
+	updatedAt: zod.z.number()
+});
+var _calendarsRecordKinds = require_dist.defineRecordKinds({ "user-prefs": {
+	schema: CalendarUserPrefsBodySchema,
+	class: "config",
+	writeTrigger: "`setCalendarPreference` upserts the caller user row",
+	device: "none",
+	at: "none",
+	indexes: [{
+		name: "updated_at",
+		fields: ["updatedAt"]
+	}],
+	retention: { none: "a missing row reads as empty prefs (all visible, system colours)" },
+	adoptsFrom: CALENDARS_USER_PREFS_COLLECTION
+} });
+var calendarsRecordKinds = _calendarsRecordKinds;
+_calendarsRecordKinds["user-prefs"];
+//#endregion
 //#region src/builtins/calendars/calendar-prefs-store.ts
 /**
 * Per-user calendar UI preferences (colour override + visibility).
 *
-* One row per `userId`. The calendars builtin owns declare + read/write;
+* One row per `userId`. The calendars builtin owns read/write via records;
 * the browser never talks to `settingsStore` directly.
 */
-/**
-* @durable class=config owner=calendars
-*   write="`setCalendarPreference` upserts the caller's row"
-*   retention="none — a missing row reads as empty prefs (all visible,
-*     system colours). Losing the table silently resets every operator's
-*     colour/hide choices."
-*/
-var CALENDARS_USER_PREFS_COLLECTION = "calendars:user-prefs";
-var COLUMNS = [
-	{
-		name: "userId",
-		type: "TEXT",
-		primaryKey: true,
-		notNull: true
-	},
-	{
-		name: "calendars",
-		type: "JSON",
-		notNull: true
-	},
-	{
-		name: "updatedAt",
-		type: "INTEGER",
-		notNull: true
-	}
-];
 var StoredRowSchema = zod.z.object({
 	calendars: zod.z.record(zod.z.string(), zod.z.unknown()),
 	updatedAt: zod.z.number()
 });
-async function declareCalendarPrefsSchema(store) {
-	await store.declareCollection.mutate({
-		collection: CALENDARS_USER_PREFS_COLLECTION,
-		columns: COLUMNS
-	});
-}
-async function loadCalendarPreferences(store, userId) {
-	const raw = await store.get.query({
-		collection: CALENDARS_USER_PREFS_COLLECTION,
-		key: userId
-	});
-	if (raw === null || raw === void 0 || typeof raw !== "object") return { calendars: {} };
-	const parsed = StoredRowSchema.safeParse(raw);
-	if (!parsed.success) return { calendars: {} };
-	const prefs = require_dist.CalendarPreferencesSchema.safeParse({ calendars: parsed.data.calendars });
-	return prefs.success ? prefs.data : { calendars: {} };
-}
-async function saveCalendarPreferences(store, userId, prefs, nowMs) {
-	await store.set.mutate({
-		collection: CALENDARS_USER_PREFS_COLLECTION,
-		key: userId,
-		value: {
+var CalendarPrefsStore = class CalendarPrefsStore {
+	kind;
+	constructor(kind) {
+		this.kind = kind;
+	}
+	static of(records) {
+		return new CalendarPrefsStore(records.kind(calendarsRecordKinds["user-prefs"]));
+	}
+	async load(userId) {
+		const row = await this.kind.get(userId);
+		if (row === null) return { calendars: {} };
+		const parsed = StoredRowSchema.safeParse(row.data);
+		if (!parsed.success) return { calendars: {} };
+		const prefs = require_dist.CalendarPreferencesSchema.safeParse({ calendars: parsed.data.calendars });
+		return prefs.success ? prefs.data : { calendars: {} };
+	}
+	async save(userId, prefs, nowMs) {
+		const body = {
 			calendars: prefs.calendars,
 			updatedAt: nowMs
-		}
-	});
-}
+		};
+		const parsed = calendarsRecordKinds["user-prefs"].schema.safeParse(body);
+		if (!parsed.success) return;
+		await this.kind.put({
+			id: userId,
+			data: parsed.data
+		});
+	}
+};
 /**
 * Patch one calendar's preference entry. `color: null` clears the override;
 * omitting a field leaves it unchanged. An entry that becomes empty is dropped.
@@ -138,11 +140,15 @@ function withSystemColors(entry) {
 }
 var CalendarsAddon = class extends require_dist.BaseAddon {
 	id = "calendars";
-	prefsDeclared = false;
+	prefsStore = null;
 	constructor() {
 		super({});
 	}
 	async onInitialize() {
+		const records = this.ctx.records;
+		if (records === void 0) throw new Error("calendars needs ctx.records on the hub");
+		await records.declare(calendarsRecordKinds);
+		this.prefsStore = CalendarPrefsStore.of(records);
 		const provider = {
 			listCalendars: async () => this.listCalendars(),
 			listEvents: async (input) => this.listEvents(input),
@@ -159,10 +165,9 @@ var CalendarsAddon = class extends require_dist.BaseAddon {
 			provider
 		}];
 	}
-	async ensurePrefsSchema() {
-		if (this.prefsDeclared) return;
-		await declareCalendarPrefsSchema(this.ctx.api.settingsStore);
-		this.prefsDeclared = true;
+	prefs() {
+		if (this.prefsStore === null) throw new Error("calendars prefs store not initialized");
+		return this.prefsStore;
 	}
 	sources() {
 		return (this.capabilities?.getCollectionEntries("calendar-source") ?? []).map(([id, provider]) => ({
@@ -213,17 +218,15 @@ var CalendarsAddon = class extends require_dist.BaseAddon {
 		return out.toSorted((a, b) => a.startMs - b.startMs);
 	}
 	async getPreferences(caller) {
-		await this.ensurePrefsSchema();
-		return loadCalendarPreferences(this.ctx.api.settingsStore, caller.userId);
+		return this.prefs().load(caller.userId);
 	}
 	async setCalendarPreference(caller, patch) {
-		await this.ensurePrefsSchema();
-		const store = this.ctx.api.settingsStore;
-		const next = patchCalendarPreference(await loadCalendarPreferences(store, caller.userId), patch.calendarId, {
+		const store = this.prefs();
+		const next = patchCalendarPreference(await store.load(caller.userId), patch.calendarId, {
 			visible: patch.visible,
 			color: patch.color
 		});
-		await saveCalendarPreferences(store, caller.userId, next, Date.now());
+		await store.save(caller.userId, next, Date.now());
 		return next;
 	}
 };

package/dist/builtins/calendars/calendars.addon.mjs

@@ -1,4 +1,4 @@
-import { Fr as BaseAddon, _ as CalendarPreferencesSchema, _t as calendarsCapability } from "../../dist-DERK-gP5.mjs";
+import { Di as defineRecordKinds, Rr as BaseAddon, g as CalendarPreferencesSchema, xt as calendarsCapability } from "../../dist-BNunRyXT.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { z } from "zod";
 //#region src/builtins/calendars/calendar-color.ts
@@ -26,71 +26,65 @@ function defaultCalendarColor(calendarId) {
 	}
 	return CALENDAR_COLOR_PALETTE[Math.abs(hash) % CALENDAR_COLOR_PALETTE.length];
 }
+var _calendarsRecordKinds = defineRecordKinds({ "user-prefs": {
+	schema: z.object({
+		calendars: CalendarPreferencesSchema.shape.calendars,
+		updatedAt: z.number()
+	}),
+	class: "config",
+	writeTrigger: "`setCalendarPreference` upserts the caller user row",
+	device: "none",
+	at: "none",
+	indexes: [{
+		name: "updated_at",
+		fields: ["updatedAt"]
+	}],
+	retention: { none: "a missing row reads as empty prefs (all visible, system colours)" },
+	adoptsFrom: "calendars:user-prefs"
+} });
+var calendarsRecordKinds = _calendarsRecordKinds;
+_calendarsRecordKinds["user-prefs"];
 //#endregion
 //#region src/builtins/calendars/calendar-prefs-store.ts
 /**
 * Per-user calendar UI preferences (colour override + visibility).
 *
-* One row per `userId`. The calendars builtin owns declare + read/write;
+* One row per `userId`. The calendars builtin owns read/write via records;
 * the browser never talks to `settingsStore` directly.
 */
-/**
-* @durable class=config owner=calendars
-*   write="`setCalendarPreference` upserts the caller's row"
-*   retention="none — a missing row reads as empty prefs (all visible,
-*     system colours). Losing the table silently resets every operator's
-*     colour/hide choices."
-*/
-var CALENDARS_USER_PREFS_COLLECTION = "calendars:user-prefs";
-var COLUMNS = [
-	{
-		name: "userId",
-		type: "TEXT",
-		primaryKey: true,
-		notNull: true
-	},
-	{
-		name: "calendars",
-		type: "JSON",
-		notNull: true
-	},
-	{
-		name: "updatedAt",
-		type: "INTEGER",
-		notNull: true
-	}
-];
 var StoredRowSchema = z.object({
 	calendars: z.record(z.string(), z.unknown()),
 	updatedAt: z.number()
 });
-async function declareCalendarPrefsSchema(store) {
-	await store.declareCollection.mutate({
-		collection: CALENDARS_USER_PREFS_COLLECTION,
-		columns: COLUMNS
-	});
-}
-async function loadCalendarPreferences(store, userId) {
-	const raw = await store.get.query({
-		collection: CALENDARS_USER_PREFS_COLLECTION,
-		key: userId
-	});
-	if (raw === null || raw === void 0 || typeof raw !== "object") return { calendars: {} };
-	const parsed = StoredRowSchema.safeParse(raw);
-	if (!parsed.success) return { calendars: {} };
-	const prefs = CalendarPreferencesSchema.safeParse({ calendars: parsed.data.calendars });
-	return prefs.success ? prefs.data : { calendars: {} };
-}
-async function saveCalendarPreferences(store, userId, prefs, nowMs) {
-	await store.set.mutate({
-		collection: CALENDARS_USER_PREFS_COLLECTION,
-		key: userId,
-		value: {
+var CalendarPrefsStore = class CalendarPrefsStore {
+	kind;
+	constructor(kind) {
+		this.kind = kind;
+	}
+	static of(records) {
+		return new CalendarPrefsStore(records.kind(calendarsRecordKinds["user-prefs"]));
+	}
+	async load(userId) {
+		const row = await this.kind.get(userId);
+		if (row === null) return { calendars: {} };
+		const parsed = StoredRowSchema.safeParse(row.data);
+		if (!parsed.success) return { calendars: {} };
+		const prefs = CalendarPreferencesSchema.safeParse({ calendars: parsed.data.calendars });
+		return prefs.success ? prefs.data : { calendars: {} };
+	}
+	async save(userId, prefs, nowMs) {
+		const body = {
 			calendars: prefs.calendars,
 			updatedAt: nowMs
-		}
-	});
-}
+		};
+		const parsed = calendarsRecordKinds["user-prefs"].schema.safeParse(body);
+		if (!parsed.success) return;
+		await this.kind.put({
+			id: userId,
+			data: parsed.data
+		});
+	}
+};
 /**
 * Patch one calendar's preference entry. `color: null` clears the override;
 * omitting a field leaves it unchanged. An entry that becomes empty is dropped.
@@ -133,11 +127,15 @@ function withSystemColors(entry) {
 }
 var CalendarsAddon = class extends BaseAddon {
 	id = "calendars";
-	prefsDeclared = false;
+	prefsStore = null;
 	constructor() {
 		super({});
 	}
 	async onInitialize() {
+		const records = this.ctx.records;
+		if (records === void 0) throw new Error("calendars needs ctx.records on the hub");
+		await records.declare(calendarsRecordKinds);
+		this.prefsStore = CalendarPrefsStore.of(records);
 		const provider = {
 			listCalendars: async () => this.listCalendars(),
 			listEvents: async (input) => this.listEvents(input),
@@ -154,10 +152,9 @@ var CalendarsAddon = class extends BaseAddon {
 			provider
 		}];
 	}
-	async ensurePrefsSchema() {
-		if (this.prefsDeclared) return;
-		await declareCalendarPrefsSchema(this.ctx.api.settingsStore);
-		this.prefsDeclared = true;
+	prefs() {
+		if (this.prefsStore === null) throw new Error("calendars prefs store not initialized");
+		return this.prefsStore;
 	}
 	sources() {
 		return (this.capabilities?.getCollectionEntries("calendar-source") ?? []).map(([id, provider]) => ({
@@ -208,17 +205,15 @@ var CalendarsAddon = class extends BaseAddon {
 		return out.toSorted((a, b) => a.startMs - b.startMs);
 	}
 	async getPreferences(caller) {
-		await this.ensurePrefsSchema();
-		return loadCalendarPreferences(this.ctx.api.settingsStore, caller.userId);
+		return this.prefs().load(caller.userId);
 	}
 	async setCalendarPreference(caller, patch) {
-		await this.ensurePrefsSchema();
-		const store = this.ctx.api.settingsStore;
-		const next = patchCalendarPreference(await loadCalendarPreferences(store, caller.userId), patch.calendarId, {
+		const store = this.prefs();
+		const next = patchCalendarPreference(await store.load(caller.userId), patch.calendarId, {
 			visible: patch.visible,
 			color: patch.color
 		});
-		await saveCalendarPreferences(store, caller.userId, next, Date.now());
+		await store.save(caller.userId, next, Date.now());
 		return next;
 	}
 };

package/dist/builtins/calendars/record-kinds.d.ts

@@ -0,0 +1,18 @@
+/**
+* Record kinds owned by calendars (phase 4).
+*/
+import { CalendarPreferencesSchema, type DefinedRecordKind } from "@camstack/types";
+import { z } from "zod";
+/** Legacy collection / adoptsFrom target. */
+export declare const CALENDARS_USER_PREFS_COLLECTION = "calendars:user-prefs";
+export type CalendarUserPrefsBody = {
+	readonly calendars: z.infer<typeof CalendarPreferencesSchema.shape.calendars>;
+	readonly updatedAt: number;
+};
+export declare const CalendarUserPrefsBodySchema: z.ZodType<CalendarUserPrefsBody>;
+export type CalendarsRecordKindsMap = {
+	readonly "user-prefs": DefinedRecordKind<z.ZodType<CalendarUserPrefsBody>>;
+};
+export declare const calendarsRecordKinds: CalendarsRecordKindsMap;
+/** Narrow kind for `records.kind()`. */
+export declare const calendarUserPrefsRecordKind: DefinedRecordKind<z.ZodType<CalendarUserPrefsBody>>;

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

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D1vECb_6.js");
+const require_dist = require("../../dist-DgOG8flk.js");
 let zod = require("zod");
 let _camstack_types_node = require("@camstack/types/node");
 let node_path = require("node:path");

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

@@ -1,4 +1,4 @@
-import { $i as EventCategory, Ei as hydrateSchema, Fr as BaseAddon, Mt as declarationOwnerNodeId, Nr as DeviceType, Pr as errMsg, Sn as memoizePinnedFfmpeg, T as DERIVED_CAMERA_SILENCED_CAP_NAMES, Tn as motionCapability, U as MOTION_CLOSE_AFTER_MS, br as buildFfmpegArgs, cr as streamCatalogCapability, j as DeclaredDevices, jr as DeviceFeature, o as BaseDevice, tr as snapshotCapability, vt as cameraGridLayoutCapability, yi as createEvent } from "../../dist-DERK-gP5.mjs";
+import { Ci as createEvent, Cr as buildFfmpegArgs, En as memoizePinnedFfmpeg, Ir as DeviceType, It as declarationOwnerNodeId, K as MOTION_CLOSE_AFTER_MS, Lr as errMsg, Mi as hydrateSchema, Pr as DeviceFeature, Rr as BaseAddon, St as cameraGridLayoutCapability, ar as snapshotCapability, fr as streamCatalogCapability, j as DeclaredDevices, kn as motionCapability, la as EventCategory, o as BaseDevice, w as DERIVED_CAMERA_SILENCED_CAP_NAMES } from "../../dist-BNunRyXT.mjs";
 import { z } from "zod";
 import { FfmpegProcess } from "@camstack/types/node";
 import { join } from "node:path";

package/dist/builtins/cluster-agent/record-kinds.d.ts

@@ -0,0 +1,36 @@
+/**
+* Record kinds owned by cluster-agent (phase 4 — hub-main).
+*/
+import { type DefinedRecordKind } from "@camstack/types";
+import { z } from "zod";
+export declare const CLUSTER_NODE_HISTORY_COLLECTION = "cluster-node-history";
+export interface ClusterNodePackageEntryBody {
+	readonly name: string;
+	readonly version: string | null;
+}
+export interface ClusterNodeDescriptorBody {
+	readonly id: string;
+	readonly name: string;
+	readonly hostname: string;
+	readonly platform: string;
+	readonly arch: string;
+	readonly cpuModel: string | null;
+	readonly cpuCores: number;
+	readonly memoryMB: number;
+	readonly engines: readonly string[];
+	readonly isHub: boolean;
+	readonly localIps: readonly string[];
+	readonly addonIds: readonly string[];
+	readonly packages?: readonly ClusterNodePackageEntryBody[];
+}
+export interface ClusterNodeHistoryBody {
+	readonly descriptor: ClusterNodeDescriptorBody;
+}
+export declare const ClusterNodeDescriptorBodySchema: z.ZodType<ClusterNodeDescriptorBody>;
+export declare const ClusterNodeHistoryBodySchema: z.ZodType<ClusterNodeHistoryBody>;
+export type ClusterAgentRecordKindsMap = {
+	readonly "node-history": DefinedRecordKind<z.ZodType<ClusterNodeHistoryBody>>;
+};
+export declare const clusterAgentRecordKinds: ClusterAgentRecordKindsMap;
+/** Narrow kind for `records.kind()` — `IsolatedRecordKinds` string index is `| undefined`. */
+export declare const clusterNodeHistoryRecordKind: DefinedRecordKind<z.ZodType<ClusterNodeHistoryBody>>;

package/dist/builtins/composer/composer.addon.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D1vECb_6.js");
-const require_composition_sources = require("../../composition-sources-NAPZddic.js");
+const require_dist = require("../../dist-DgOG8flk.js");
+const require_composition_sources = require("../../composition-sources-D3fi9Xns.js");
 let zod = require("zod");
 //#region src/builtins/shared/device-state-changed.ts
 /** Structural narrowing helper for untrusted bus payloads. */

package/dist/builtins/composer/composer.addon.mjs

@@ -1,5 +1,5 @@
-import { $i as EventCategory, Ar as toExpressionValue, Cr as composedDeviceStableId, Dr as compositionSourceKey, Er as compositionSliceKey, Fr as BaseAddon, Gt as evaluateCompositionField, Jt as expressionContainsBuiltinCall, Mn as planComposition, Nr as DeviceType, Or as createStatefulExpressionMemory, Pr as errMsg, Sr as composedDeviceRef, St as compositionFieldKey, Tr as compositionItemFieldPath, j as DeclaredDevices, kr as disarmRoseMemory, o as BaseDevice, p as COMPOSED_ITEM_FIXED_FIELDS, pt as buildCapabilityLookup, r as ALL_CAPABILITY_DEFINITIONS, wr as compositionFeatureEnabled, xr as cloneStatefulExpressionMemory, xt as composerCapability, yi as createEvent, yr as COMPOSER_ADDON_ID } from "../../dist-DERK-gP5.mjs";
-import { n as normalizedNativeOwner } from "../../composition-sources-C3rKncIF.mjs";
+import { Ar as compositionSourceKey, Ci as createEvent, Dr as compositionFeatureEnabled, Er as composedDeviceStableId, Et as compositionFieldKey, In as planComposition, Ir as DeviceType, Lr as errMsg, Mr as disarmRoseMemory, Nr as toExpressionValue, Or as compositionItemFieldPath, Qt as expressionContainsBuiltinCall, Rr as BaseAddon, Sr as COMPOSER_ADDON_ID, Tr as composedDeviceRef, Tt as composerCapability, Yt as evaluateCompositionField, _t as buildCapabilityLookup, f as COMPOSED_ITEM_FIXED_FIELDS, j as DeclaredDevices, jr as createStatefulExpressionMemory, kr as compositionSliceKey, la as EventCategory, o as BaseDevice, r as ALL_CAPABILITY_DEFINITIONS, wr as cloneStatefulExpressionMemory } from "../../dist-BNunRyXT.mjs";
+import { n as normalizedNativeOwner } from "../../composition-sources-BMt5cFYb.mjs";
 import { z } from "zod";
 //#region src/builtins/shared/device-state-changed.ts
 /** Structural narrowing helper for untrusted bus payloads. */

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D1vECb_6.js");
+const require_dist = require("../../dist-DgOG8flk.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Fr as BaseAddon, _n as logDestinationCapability } from "../../dist-DERK-gP5.mjs";
+import { Rr as BaseAddon, xn as logDestinationCapability } from "../../dist-BNunRyXT.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/block-settings-store.d.ts

@@ -1,10 +1,13 @@
-import { type ConfigUISchema, type RawSecretMigrationReport, type SecretsAccess, type SettingsStoreClient } from "@camstack/types";
+import { type ConfigUISchema, type RawSecretMigrationReport, type SecretsAccess, type RecordKindHandle, type RecordsAccess, type SettingsStoreClient } from "@camstack/types";
+import { type CoreBlockSettingsBodySchema } from "./record-kinds.js";
+import type { z } from "zod";
+type CoreBlockSettingsBody = z.infer<typeof CoreBlockSettingsBodySchema>;
 /**
 * @durable class=config owner=core-blocks
 *   write="NOTHING since D880 - the values live in the block addon's `addon-settings` rows. Only the one-shot `migrateRawSecrets` reads it, then deletes each row."
 *   retention="legacy: every row is deleted by the verified operator migration; the declaration goes with it once every hub ran it."
 */
-export declare const CORE_BLOCK_SETTINGS_COLLECTION = "core-blocks:settings";
+export { CORE_BLOCK_SETTINGS_COLLECTION } from "./record-kinds.js";
 export declare const CORE_BLOCK_SETTINGS_COLUMNS: readonly [{
 	readonly name: "id";
 	readonly type: "TEXT";
@@ -20,6 +23,7 @@ export declare const CORE_BLOCK_SETTINGS_COLUMNS: readonly [{
 export type SecretsForOwner = (owner: string) => SecretsAccess | null;
 export interface BlockSettingsStoreDeps {
 	readonly store: SettingsStoreClient;
+	readonly legacySettings: RecordKindHandle<CoreBlockSettingsBody>;
 	readonly keychainFor: SecretsForOwner;
 	/** Told about keychain refs a write dropped but could not delete (they are now orphans). */
 	readonly onOrphaned?: (blockId: string, refs: readonly string[]) => void;
@@ -41,11 +45,11 @@ export interface BlockSecretsSubject {
 }
 export declare class BlockSettingsStore {
 	private readonly store;
+	private readonly legacySettings;
 	private readonly keychainFor;
 	private readonly onOrphaned;
 	constructor(deps: BlockSettingsStoreDeps);
-	/** Declares the LEGACY collection, so the migration can read it. */
-	static declare(store: SettingsStoreClient): Promise<void>;
+	static legacyKindOf(records: Pick<RecordsAccess, "kind">): RecordKindHandle<CoreBlockSettingsBody>;
 	private rows;
 	/**
 	* The block's stored values - markers, NOT resolved. For the admin form

package/dist/builtins/core-blocks/core-block-store.d.ts

@@ -1,4 +1,7 @@
-import type { ComposerUnreadableBlock, CompositionBlockInput, CompositionBlockPatch, CoreBlock, CoreBlockInput, IScopedLogger, SettingsStoreClient } from "@camstack/types";
+import type { ComposerUnreadableBlock, CompositionBlockInput, CompositionBlockPatch, CoreBlock, CoreBlockInput, IScopedLogger, RecordKindHandle, RecordsAccess } from "@camstack/types";
+import { type CoreBlockRowBodySchema } from "./record-kinds.js";
+import type { z } from "zod";
+type CoreBlockRowBody = z.infer<typeof CoreBlockRowBodySchema>;
 /**
 * A composition block as the store keeps it: always NAMED. A customization's
 * client input carries no name — the API derives it before the store sees it (D663).
@@ -6,18 +9,7 @@ import type { ComposerUnreadableBlock, CompositionBlockInput, CompositionBlockPa
 export interface NamedCompositionInput extends CompositionBlockInput {
 	readonly name: string;
 }
-/**
-* @durable class=config owner=core-blocks
-*   write="`create` and `update` persist the operator's block after it compiles;
-*     `setStatus` rewrites what the runner reported (status, `lastChangedAt`,
-*     `lastError`) — so a running block is written on every state change"
-*   retention="`delete` only, when the operator removes a block. Nothing ages out,
-*     and a row whose JSON stops validating is left on disk rather than repaired.
-*     The real loss path is a `declareCollection` REBUILD — a legacy (id, data)
-*     shape, or a new PK/UNIQUE/NOT-NULL-without-default column — which drops the
-*     table and takes the operator's source code with it."
-*/
-export declare const CORE_BLOCKS_COLLECTION = "core_blocks";
+export { CORE_BLOCKS_COLLECTION } from "./record-kinds.js";
 export declare const CORE_BLOCKS_COLUMNS: readonly [{
 	readonly name: "id";
 	readonly type: "TEXT";
@@ -55,7 +47,7 @@ export declare const CORE_BLOCKS_INDEXES: readonly [{
 */
 export declare const CORE_BLOCKS_LOAD_LIMIT = 1e3;
 export interface CoreBlockStoreDeps {
-	readonly store: SettingsStoreClient;
+	readonly blocks: RecordKindHandle<CoreBlockRowBody>;
 	readonly logger: IScopedLogger;
 	readonly now?: () => number;
 	readonly newId?: () => string;
@@ -64,7 +56,7 @@ export declare class CoreBlockStore {
 	private readonly byId;
 	/** Rows that exist but do not parse and may be compositions — held for the composer, never dropped (D49). */
 	private unreadable;
-	private readonly store;
+	private readonly blocks;
 	private readonly logger;
 	private readonly now;
 	private readonly newId;
@@ -72,7 +64,7 @@ export declare class CoreBlockStore {
 	/** Consecutive failed reads — the warn is once per run of them, not once per retry. */
 	private failedLoads;
 	constructor(deps: CoreBlockStoreDeps);
-	static declare(store: SettingsStoreClient): Promise<void>;
+	static of(records: Pick<RecordsAccess, "kind">, logger: IScopedLogger): CoreBlockStore;
 	/** True only after a `load()` that READ the table. The composer withdraws nothing otherwise (D49). */
 	isLoaded(): boolean;
 	/** Stored composition rows that do not parse, by id — the composer holds their devices. */