@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/client-ui-permission-presets/lib/client.js

@@ -8,7 +8,6 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let _nomix_ai_nomix_client_ui_primitives = require("@nomix-ai/nomix-client-ui-primitives");
 		let _nomix_ai_nomix_client_runtime_client = require("@nomix-ai/nomix-client-runtime/client");
-		let _nomix_ai_nomix_client_schema_form = require("@nomix-ai/nomix-client-schema-form");
 		//#region lib/types/client/presentation.js
 		/** Machine value of the preset that requires an explicit GUI risk gate. */
 		const FULL_ACCESS_PRESET = "danger-full-access";
@@ -42,12 +41,12 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var PermissionRow_module_css_default = {
-			"selector": "aFndvW_selector",
-			"title": "aFndvW_title",
+			"chevron": "aFndvW_chevron",
+			"desc": "aFndvW_desc",
 			"row": "aFndvW_row",
 			"rowText": "aFndvW_rowText",
-			"desc": "aFndvW_desc",
-			"chevron": "aFndvW_chevron"
+			"selector": "aFndvW_selector",
+			"title": "aFndvW_title"
 		};
 		//#endregion
 		//#region lib/types/client/PermissionRow.js
@@ -193,21 +192,24 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/settings-store.js
 		/**
-		* Permission default-settings controller. The host descriptor supplies the
-		* current value and the dynamic preset enum; writes target only
-		* `defaultPreset` and carry the descriptor revision.
+		* Permission default-settings controller. The permission descriptor comes
+		* from the shared describe mirror (the dynamic preset enum lives in the
+		* namespace schema, which per-namespace scopes do not carry); writes target
+		* only `defaultPreset`, carry the descriptor revision, and fold their answer
+		* back into the mirror.
 		*/
 		/** Permission's settings namespace on the host wire. */
 		const PERMISSION_SETTINGS_NS = "permission";
 		/**
 		* Read the dynamic preset enum encoded by the host's `defaultPreset` schema.
 		* @param view - permission namespace descriptor.
+		* @param schema - settings schema operations.
 		* @returns current value and selectable options.
 		*/
-		function permissionDefaultOf(view) {
+		function permissionDefaultOf(view, schema) {
 			const value = view.value?.defaultPreset;
 			if (typeof value !== "string") throw new Error("permission settings has no defaultPreset value");
-			const node = (0, _nomix_ai_nomix_client_schema_form.nodeAtPath)((0, _nomix_ai_nomix_client_schema_form.rehydrateSchema)(view.schema), ["defaultPreset"]);
+			const node = schema.nodeAtPath(schema.rehydrate(view.schema), ["defaultPreset"]);
 			if (node === void 0) throw new Error("permission settings schema has no defaultPreset field");
 			const options = (node.type === "union" ? node.list ?? [] : [node]).flatMap((candidate) => {
 				const choice = candidate;
@@ -224,9 +226,11 @@ window.__ModuleLoader__.load({
 				options
 			};
 		}
-		/** Controller joining Settings reads, writes, and pushed invalidations. */
+		/** Controller deriving the row from the shared mirror and writing the default through it. */
 		var PermissionPresetSettingsController = class {
+			describeFace;
 			api;
+			schema;
 			/** Row snapshot consumed through a bound selector hook. */
 			store = (0, _nomix_ai_nomix_client_runtime_client.createSnapshotStore)({
 				status: "idle",
@@ -236,53 +240,48 @@ window.__ModuleLoader__.load({
 				options: [],
 				revision: 0
 			});
-			generation = 0;
-			view;
-			/** @param api - Settings wire face. */
-			constructor(api) {
+			following;
+			saving = false;
+			disposed = false;
+			/**
+			* @param describeFace - the shared mirror's read/fold face (descriptor and schema source).
+			* @param api - settings wire face for the `defaultPreset` write.
+			* @param schema - settings-owned schema operations.
+			*/
+			constructor(describeFace, api, schema) {
+				this.describeFace = describeFace;
 				this.api = api;
+				this.schema = schema;
 			}
 			/**
-			* Refresh the permission descriptor. Latest request wins.
-			* @returns nothing; {@link store} carries success or failure.
+			* Begin following the mirror (idempotent) and reflect its current answer.
+			* @returns settlement once the snapshot reflects the mirror.
 			*/
 			async load() {
-				const generation = ++this.generation;
+				if (this.disposed) return;
+				this.following ??= this.describeFace.subscribe(() => {
+					this.derive();
+				});
 				this.store.update((state) => {
 					state.status = "loading";
 					state.error = null;
 				});
-				try {
-					const response = await this.api.settings.describe({});
-					if (!response.result.ok) throw new Error(response.result.error.message);
-					if (generation !== this.generation) return;
-					const view = response.result.value.namespaces.find((entry) => entry.ns === PERMISSION_SETTINGS_NS);
-					if (view === void 0) {
-						this.view = void 0;
-						this.store.update((state) => {
-							state.status = "unavailable";
-							state.writable = false;
-							state.currentValue = "";
-							state.options = [];
-						});
-						return;
-					}
-					this.accept(view, response.result.value.writable);
-				} catch (error) {
-					if (generation !== this.generation) return;
-					this.fail(error);
-				}
+				await this.describeFace.ensure();
+				this.derive();
 			}
 			/**
 			* Persist one preset as the default for subsequently created sessions.
+			* A selection made while one is already saving is ignored — the row's
+			* control is disabled during the save, so this only drops programmatic
+			* double-submits rather than user intent.
 			* @param preset - advertised preset key.
 			* @returns nothing; {@link store} carries success or failure.
 			*/
 			async select(preset) {
-				const view = this.view;
 				const state = this.store.getSnapshot();
-				if (view === void 0 || !state.writable) return;
-				const generation = ++this.generation;
+				const view = this.describeFace.getSnapshot().view?.namespaces.find((entry) => entry.ns === PERMISSION_SETTINGS_NS);
+				if (view === void 0 || !state.writable || this.saving) return;
+				this.saving = true;
 				this.store.update((draft) => {
 					draft.status = "saving";
 					draft.error = null;
@@ -297,30 +296,62 @@ window.__ModuleLoader__.load({
 						}],
 						expectedRevision: view.revision
 					});
-					if (generation !== this.generation) return;
 					if (!response.result.ok) throw new Error(response.result.error.message);
-					this.accept(response.result.value, true);
+					this.saving = false;
+					if (this.disposed) return;
+					this.describeFace.acceptView(response.result.value);
 				} catch (error) {
-					if (generation !== this.generation) return;
+					this.saving = false;
+					if (this.disposed) return;
 					this.fail(error);
 				}
 			}
-			/** Stop in-flight responses from publishing after plugin disposal. */
+			/** Stop following the mirror; later publishes leave the snapshot alone. */
 			dispose() {
-				this.generation += 1;
-				this.view = void 0;
+				this.disposed = true;
+				this.following?.();
+				this.following = void 0;
 			}
-			accept(view, writable) {
-				const resolved = permissionDefaultOf(view);
-				this.view = view;
-				this.store.update((state) => {
-					state.status = "ready";
-					state.error = null;
-					state.writable = writable;
-					state.currentValue = resolved.currentValue;
-					state.options = resolved.options;
-					state.revision = view.revision;
-				});
+			derive() {
+				if (this.disposed || this.saving) return;
+				const mirrored = this.describeFace.getSnapshot();
+				if (mirrored.status === "unavailable") {
+					this.store.update((state) => {
+						state.status = "unavailable";
+						state.writable = false;
+						state.currentValue = "";
+						state.options = [];
+					});
+					return;
+				}
+				if (mirrored.view === void 0) {
+					if (mirrored.error !== null) this.fail(new Error(mirrored.error));
+					return;
+				}
+				const view = mirrored.view.namespaces.find((entry) => entry.ns === PERMISSION_SETTINGS_NS);
+				if (view === void 0) {
+					this.store.update((state) => {
+						state.status = "unavailable";
+						state.writable = false;
+						state.currentValue = "";
+						state.options = [];
+					});
+					return;
+				}
+				try {
+					const resolved = permissionDefaultOf(view, this.schema);
+					const { writable } = mirrored.view;
+					this.store.update((state) => {
+						state.status = "ready";
+						state.error = null;
+						state.writable = writable;
+						state.currentValue = resolved.currentValue;
+						state.options = resolved.options;
+						state.revision = view.revision;
+					});
+				} catch (error) {
+					this.fail(error);
+				}
 			}
 			fail(error) {
 				this.store.update((state) => {
@@ -329,14 +360,6 @@ window.__ModuleLoader__.load({
 				});
 			}
 		};
-		/**
-		* Refetch only after the row has opened once.
-		* @param controller - permission settings controller.
-		*/
-		function refreshPermissionIfLoaded(controller) {
-			if (controller.store.getSnapshot().status === "idle") return;
-			controller.load();
-		}
 		//#endregion
 		//#region lib/types/client/index.js
 		/** Required services (cordis fiber inject). */
@@ -346,7 +369,9 @@ window.__ModuleLoader__.load({
 			"slots",
 			"locale",
 			"connection",
-			"remote"
+			"remote",
+			"settingsScope",
+			"settingsSchema"
 		];
 		const ACCESS_NS = "permission.access";
 		/** Read one session's current permissions projection value (undefined = capability absent). */
@@ -401,7 +426,8 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "ui-permission: settings row dictionaries");
-			const controller = new PermissionPresetSettingsController(ctx.get("connection").api);
+			const connection = ctx.get("connection");
+			const controller = new PermissionPresetSettingsController(ctx.settingsScope.describe(), connection.api, ctx.settingsSchema);
 			const load = () => controller.load();
 			const select = (preset) => controller.select(preset);
 			const injected = () => ({
@@ -409,21 +435,9 @@ window.__ModuleLoader__.load({
 				load,
 				select
 			});
-			ctx.effect(() => {
-				const refresh = () => {
-					refreshPermissionIfLoaded(controller);
-				};
-				const disposers = [ctx.remote.$on("settings/document-updated", (ns) => {
-					if (ns !== "permission") return;
-					refresh();
-				}), ctx.on("connection/reset", () => {
-					refresh();
-				})];
-				return () => {
-					controller.dispose();
-					for (const dispose of disposers) dispose();
-				};
-			}, "ui-permission: settings invalidations");
+			ctx.effect(() => () => {
+				controller.dispose();
+			}, "ui-permission: settings row directory");
 			ctx.slots.inject("settings.general.item", () => ctx.slots.register({
 				name: "settings.general.item",
 				id: "permission",

package/dist/kernel/client-ui-permission-presets/lib/types/client/index.js

@@ -1,9 +1,9 @@
 import { PermissionRow } from "./PermissionRow.js";
 import { accessEn, accessZh, en, zh, } from "./locales.js";
 import { displayPermissionPreset, FULL_ACCESS_PRESET, } from "./presentation.js";
-import { PERMISSION_SETTINGS_NS, PermissionPresetSettingsController, refreshPermissionIfLoaded, } from "./settings-store.js";
+import { PermissionPresetSettingsController } from "./settings-store.js";
 /** Required services (cordis fiber inject). */
-export const inject = ['commandUi', 'sessions', 'slots', 'locale', 'connection', 'remote'];
+export const inject = ['commandUi', 'sessions', 'slots', 'locale', 'connection', 'remote', 'settingsScope', 'settingsSchema'];
 const ACCESS_NS = 'permission.access';
 /** Read one session's current permissions projection value (undefined = capability absent). */
 function selectOf(session) {
@@ -67,7 +67,9 @@ export function apply(ctx) {
     const sessionFor = (session) => sessions.binding(session.sessionId)?.session;
     ctx.effect(() => ctx.locale.register('settings.permission', { zh, en }), 'ui-permission: settings row dictionaries');
     const connection = ctx.get('connection');
-    const controller = new PermissionPresetSettingsController(connection.api);
+    // The row follows the shared describe mirror, whose owning plugin already
+    // refreshes it on document commits and reconnects.
+    const controller = new PermissionPresetSettingsController(ctx.settingsScope.describe(), connection.api, ctx.settingsSchema);
     const load = () => controller.load();
     const select = (preset) => controller.select(preset);
     const injected = () => ({
@@ -75,22 +77,7 @@ export function apply(ctx) {
         load,
         select,
     });
-    ctx.effect(() => {
-        const refresh = () => { refreshPermissionIfLoaded(controller); };
-        const disposers = [
-            ctx.remote.$on('settings/document-updated', (ns) => {
-                if (ns !== PERMISSION_SETTINGS_NS)
-                    return;
-                refresh();
-            }),
-            ctx.on('connection/reset', () => { refresh(); }),
-        ];
-        return () => {
-            controller.dispose();
-            for (const dispose of disposers)
-                dispose();
-        };
-    }, 'ui-permission: settings invalidations');
+    ctx.effect(() => () => { controller.dispose(); }, 'ui-permission: settings row directory');
     ctx.slots.inject('settings.general.item', () => ctx.slots.register({
         name: 'settings.general.item',
         id: 'permission',

package/dist/kernel/client-ui-permission-presets/lib/types/client/settings-store.d.ts

@@ -1,10 +1,13 @@
 /**
- * Permission default-settings controller. The host descriptor supplies the
- * current value and the dynamic preset enum; writes target only
- * `defaultPreset` and carry the descriptor revision.
+ * Permission default-settings controller. The permission descriptor comes
+ * from the shared describe mirror (the dynamic preset enum lives in the
+ * namespace schema, which per-namespace scopes do not carry); writes target
+ * only `defaultPreset`, carry the descriptor revision, and fold their answer
+ * back into the mirror.
  */
 import type { IApiClient, SettingsNamespaceView } from '../../../../api-remotes/lib/client.js';
 import { type SnapshotStore } from '../../../../client-runtime/lib/client.js';
+import type { SettingsDescribeFace, SettingsSchemaService } from '../../../../client-ui-settings/lib/client.js';
 /** Permission's settings namespace on the host wire. */
 export declare const PERMISSION_SETTINGS_NS = "permission";
 /** One selectable new-session default. */
@@ -26,40 +29,46 @@ export interface PermissionSettingsState {
 /**
  * Read the dynamic preset enum encoded by the host's `defaultPreset` schema.
  * @param view - permission namespace descriptor.
+ * @param schema - settings schema operations.
  * @returns current value and selectable options.
  */
-export declare function permissionDefaultOf(view: SettingsNamespaceView): {
+export declare function permissionDefaultOf(view: SettingsNamespaceView, schema: SettingsSchemaService): {
     currentValue: string;
     options: PermissionDefaultOption[];
 };
-/** Controller joining Settings reads, writes, and pushed invalidations. */
+/** Controller deriving the row from the shared mirror and writing the default through it. */
 export declare class PermissionPresetSettingsController {
+    private readonly describeFace;
     private readonly api;
+    private readonly schema;
     /** Row snapshot consumed through a bound selector hook. */
     readonly store: SnapshotStore<PermissionSettingsState>;
-    private generation;
-    private view;
-    /** @param api - Settings wire face. */
-    constructor(api: Pick<IApiClient, 'settings'>);
+    private following;
+    private saving;
+    private disposed;
     /**
-     * Refresh the permission descriptor. Latest request wins.
-     * @returns nothing; {@link store} carries success or failure.
+     * @param describeFace - the shared mirror's read/fold face (descriptor and schema source).
+     * @param api - settings wire face for the `defaultPreset` write.
+     * @param schema - settings-owned schema operations.
+     */
+    constructor(describeFace: SettingsDescribeFace, api: Pick<IApiClient, 'settings'>, schema: SettingsSchemaService);
+    /**
+     * Begin following the mirror (idempotent) and reflect its current answer.
+     * @returns settlement once the snapshot reflects the mirror.
      */
     load(): Promise<void>;
     /**
      * Persist one preset as the default for subsequently created sessions.
+     * A selection made while one is already saving is ignored — the row's
+     * control is disabled during the save, so this only drops programmatic
+     * double-submits rather than user intent.
      * @param preset - advertised preset key.
      * @returns nothing; {@link store} carries success or failure.
      */
     select(preset: string): Promise<void>;
-    /** Stop in-flight responses from publishing after plugin disposal. */
+    /** Stop following the mirror; later publishes leave the snapshot alone. */
     dispose(): void;
-    private accept;
+    private derive;
     private fail;
 }
-/**
- * Refetch only after the row has opened once.
- * @param controller - permission settings controller.
- */
-export declare function refreshPermissionIfLoaded(controller: PermissionPresetSettingsController): void;
 //# sourceMappingURL=settings-store.d.ts.map

package/dist/kernel/client-ui-permission-presets/lib/types/client/settings-store.js

@@ -1,23 +1,25 @@
 /**
- * Permission default-settings controller. The host descriptor supplies the
- * current value and the dynamic preset enum; writes target only
- * `defaultPreset` and carry the descriptor revision.
+ * Permission default-settings controller. The permission descriptor comes
+ * from the shared describe mirror (the dynamic preset enum lives in the
+ * namespace schema, which per-namespace scopes do not carry); writes target
+ * only `defaultPreset`, carry the descriptor revision, and fold their answer
+ * back into the mirror.
  */
 import { createSnapshotStore, } from '../../../../client-runtime/lib/client.js';
-import { nodeAtPath, rehydrateSchema, } from '../../../../client-schema-form/lib/index.js';
 import { displayPermissionPreset } from "./presentation.js";
 /** Permission's settings namespace on the host wire. */
 export const PERMISSION_SETTINGS_NS = 'permission';
 /**
  * Read the dynamic preset enum encoded by the host's `defaultPreset` schema.
  * @param view - permission namespace descriptor.
+ * @param schema - settings schema operations.
  * @returns current value and selectable options.
  */
-export function permissionDefaultOf(view) {
+export function permissionDefaultOf(view, schema) {
     const value = view.value?.defaultPreset;
     if (typeof value !== 'string')
         throw new Error('permission settings has no defaultPreset value');
-    const node = nodeAtPath(rehydrateSchema(view.schema), ['defaultPreset']);
+    const node = schema.nodeAtPath(schema.rehydrate(view.schema), ['defaultPreset']);
     if (node === undefined)
         throw new Error('permission settings schema has no defaultPreset field');
     const rawChoices = node.type === 'union'
@@ -40,9 +42,11 @@ export function permissionDefaultOf(view) {
     }
     return { currentValue: value, options };
 }
-/** Controller joining Settings reads, writes, and pushed invalidations. */
+/** Controller deriving the row from the shared mirror and writing the default through it. */
 export class PermissionPresetSettingsController {
+    describeFace;
     api;
+    schema;
     /** Row snapshot consumed through a bound selector hook. */
     store = createSnapshotStore({
         status: 'idle',
@@ -52,58 +56,49 @@ export class PermissionPresetSettingsController {
         options: [],
         revision: 0,
     });
-    generation = 0;
-    view;
-    /** @param api - Settings wire face. */
-    constructor(api) {
+    following;
+    saving = false;
+    disposed = false;
+    /**
+     * @param describeFace - the shared mirror's read/fold face (descriptor and schema source).
+     * @param api - settings wire face for the `defaultPreset` write.
+     * @param schema - settings-owned schema operations.
+     */
+    constructor(describeFace, api, schema) {
+        this.describeFace = describeFace;
         this.api = api;
+        this.schema = schema;
     }
     /**
-     * Refresh the permission descriptor. Latest request wins.
-     * @returns nothing; {@link store} carries success or failure.
+     * Begin following the mirror (idempotent) and reflect its current answer.
+     * @returns settlement once the snapshot reflects the mirror.
      */
     async load() {
-        const generation = ++this.generation;
+        if (this.disposed)
+            return;
+        this.following ??= this.describeFace.subscribe(() => { this.derive(); });
         this.store.update((state) => {
             state.status = 'loading';
             state.error = null;
         });
-        try {
-            const response = await this.api.settings.describe({});
-            if (!response.result.ok)
-                throw new Error(response.result.error.message);
-            if (generation !== this.generation)
-                return;
-            const view = response.result.value.namespaces.find(entry => entry.ns === PERMISSION_SETTINGS_NS);
-            if (view === undefined) {
-                this.view = undefined;
-                this.store.update((state) => {
-                    state.status = 'unavailable';
-                    state.writable = false;
-                    state.currentValue = '';
-                    state.options = [];
-                });
-                return;
-            }
-            this.accept(view, response.result.value.writable);
-        }
-        catch (error) {
-            if (generation !== this.generation)
-                return;
-            this.fail(error);
-        }
+        await this.describeFace.ensure();
+        this.derive();
     }
     /**
      * Persist one preset as the default for subsequently created sessions.
+     * A selection made while one is already saving is ignored — the row's
+     * control is disabled during the save, so this only drops programmatic
+     * double-submits rather than user intent.
      * @param preset - advertised preset key.
      * @returns nothing; {@link store} carries success or failure.
      */
     async select(preset) {
-        const view = this.view;
         const state = this.store.getSnapshot();
-        if (view === undefined || !state.writable)
+        const view = this.describeFace.getSnapshot().view?.namespaces
+            .find(entry => entry.ns === PERMISSION_SETTINGS_NS);
+        if (view === undefined || !state.writable || this.saving)
             return;
-        const generation = ++this.generation;
+        this.saving = true;
         this.store.update((draft) => {
             draft.status = 'saving';
             draft.error = null;
@@ -114,34 +109,75 @@ export class PermissionPresetSettingsController {
                 ops: [{ op: 'set', path: ['defaultPreset'], value: preset }],
                 expectedRevision: view.revision,
             });
-            if (generation !== this.generation)
-                return;
             if (!response.result.ok)
                 throw new Error(response.result.error.message);
-            this.accept(response.result.value, true);
+            this.saving = false;
+            if (this.disposed)
+                return;
+            // The mirror publish reaches this row's own subscription, so the fold
+            // is also what republishes the accepted value here.
+            this.describeFace.acceptView(response.result.value);
         }
         catch (error) {
-            if (generation !== this.generation)
+            this.saving = false;
+            if (this.disposed)
                 return;
             this.fail(error);
         }
     }
-    /** Stop in-flight responses from publishing after plugin disposal. */
+    /** Stop following the mirror; later publishes leave the snapshot alone. */
     dispose() {
-        this.generation += 1;
-        this.view = undefined;
+        this.disposed = true;
+        this.following?.();
+        this.following = undefined;
     }
-    accept(view, writable) {
-        const resolved = permissionDefaultOf(view);
-        this.view = view;
-        this.store.update((state) => {
-            state.status = 'ready';
-            state.error = null;
-            state.writable = writable;
-            state.currentValue = resolved.currentValue;
-            state.options = resolved.options;
-            state.revision = view.revision;
-        });
+    derive() {
+        if (this.disposed || this.saving)
+            return;
+        const mirrored = this.describeFace.getSnapshot();
+        if (mirrored.status === 'unavailable') {
+            // The terminal non-loopback state: settings RPCs are loopback-only, so
+            // the row hides itself exactly like an unserved namespace.
+            this.store.update((state) => {
+                state.status = 'unavailable';
+                state.writable = false;
+                state.currentValue = '';
+                state.options = [];
+            });
+            return;
+        }
+        if (mirrored.view === undefined) {
+            // A held failure with no answer is a failed row; without one the read
+            // is still in flight and the row keeps its loading state.
+            if (mirrored.error !== null)
+                this.fail(new Error(mirrored.error));
+            return;
+        }
+        const view = mirrored.view.namespaces.find(entry => entry.ns === PERMISSION_SETTINGS_NS);
+        if (view === undefined) {
+            this.store.update((state) => {
+                state.status = 'unavailable';
+                state.writable = false;
+                state.currentValue = '';
+                state.options = [];
+            });
+            return;
+        }
+        try {
+            const resolved = permissionDefaultOf(view, this.schema);
+            const { writable } = mirrored.view;
+            this.store.update((state) => {
+                state.status = 'ready';
+                state.error = null;
+                state.writable = writable;
+                state.currentValue = resolved.currentValue;
+                state.options = resolved.options;
+                state.revision = view.revision;
+            });
+        }
+        catch (error) {
+            this.fail(error);
+        }
     }
     fail(error) {
         this.store.update((state) => {
@@ -150,13 +186,4 @@ export class PermissionPresetSettingsController {
         });
     }
 }
-/**
- * Refetch only after the row has opened once.
- * @param controller - permission settings controller.
- */
-export function refreshPermissionIfLoaded(controller) {
-    if (controller.store.getSnapshot().status === 'idle')
-        return;
-    void controller.load();
-}
 //# sourceMappingURL=settings-store.js.map