@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/client-ui-settings/lib/types/client/settings-scope.d.ts

@@ -1,35 +1,50 @@
 /**
  * Host transport for the settings-namespace scope contract. The contract types
  * live in `nomix-client-runtime` (the common dependency of every feature that
- * owns a preference); this file owns the wire behavior and the invalidation
- * subscription, both of which are Settings-surface concerns.
+ * owns a preference); this file owns the per-namespace derivation over the
+ * shared {@link SettingsDescribeMirror} and the serialized write path, both of
+ * which are Settings-surface concerns. Reads never touch the wire here: the
+ * mirror is the one `settings.describe` reader, and every scope is a selector
+ * over its snapshot.
  */
 import { Service } from '../../../../cordis/lib/index.js';
 import type { Context } from '../../../../cordis/lib/index.js';
 import type { IApiClient } from '../../../../api-remotes/lib/client.js';
 import { type SettingsScope, type SettingsScopeSnapshot, type SettingsScopeSpec } from '../../../../client-runtime/lib/client.js';
+import type { SettingsSchemaService } from './schema.ts';
+import { SettingsDescribeMirror, type SettingsDescribeFace } from './settings-mirror.ts';
 type SettingsFace = Pick<IApiClient, 'settings'>;
 /**
- * Serializes one namespace's Host reads and writes behind a snapshot store.
- * Reads never block plugin activation; writes carry the latest known
- * namespace revision and teardown waits for the operation already crossing
- * the wire.
+ * One namespace's derived view over the shared describe mirror, plus that
+ * namespace's serialized Host writes. Writes carry the latest known namespace
+ * revision, fold their answers back into the mirror, and teardown waits for
+ * the operation already crossing the wire.
  */
 export declare class SettingsScopeController<T> implements SettingsScope<T> {
     private readonly api;
     private readonly spec;
+    private readonly mirror;
     private readonly persistence;
+    private readonly schema;
     private readonly store;
     private tail;
-    private readGeneration;
     private writeGeneration;
     private disposed;
+    private readonly unsubscribe;
     /**
-     * @param api - settings wire face.
+     * Revision answered by a superseded write still ahead of the mirror: the
+     * mirror only folds the LATEST settlement in, so a queued successor takes
+     * its fence from here first.
+     */
+    private pendingRevision;
+    /**
+     * @param api - settings wire face (writes only; reads ride the mirror).
      * @param spec - namespace identity and optional narrowing decoder.
+     * @param mirror - the shared describe mirror this scope derives from.
      * @param persistence - remote browsers remain process-local because settings RPCs are loopback-only.
+     * @param schema - settings-owned schema operations.
      */
-    constructor(api: SettingsFace, spec: SettingsScopeSpec<T>, persistence?: 'host' | 'memory');
+    constructor(api: SettingsFace, spec: SettingsScopeSpec<T>, mirror: SettingsDescribeMirror, persistence: 'host' | 'memory', schema: SettingsSchemaService);
     /** @returns the current sync snapshot (stable reference until the next change). */
     getSnapshot(): SettingsScopeSnapshot<T>;
     /**
@@ -38,11 +53,6 @@ export declare class SettingsScopeController<T> implements SettingsScope<T> {
      * @returns the disposer removing this listener.
      */
     subscribe(listener: () => void): () => void;
-    /**
-     * Queue a Host refresh; a newer read or user write suppresses stale publication.
-     * @returns settlement after the queued read completes or is skipped.
-     */
-    load(): Promise<void>;
     /**
      * Queue one field write; see {@link SettingsScope.set} for the ordering,
      * revision, and recovery contract.
@@ -59,14 +69,16 @@ export declare class SettingsScopeController<T> implements SettingsScope<T> {
      */
     unset(field: string): Promise<void>;
     private write;
+    /** Reload Host state for the latest failed write; superseded failures leave recovery to it. */
+    private recover;
     /**
-     * Stop queued operations and wait for the current wire call to settle.
+     * Stop queued operations, stop deriving, and wait for the current wire call
+     * to settle.
      * @returns settlement after the controller reaches quiescence.
      */
     dispose(): Promise<void>;
     private enqueue;
-    private read;
-    private accept;
+    private derive;
     private decode;
 }
 declare module '@nomix-ai/cordis' {
@@ -82,17 +94,32 @@ declare module '@nomix-ai/cordis' {
  * (`packages/client/tsdown.client.ts`).
  */
 export declare class SettingsScopeBinder extends Service {
+    private readonly mirror;
+    private readonly schema;
     /**
      * @param ctx - the providing plugin's context.
+     * @param config - the shared describe mirror every bound scope derives from,
+     * plus the settings-owned schema operations.
+     */
+    constructor(ctx: Context, config: {
+        mirror: SettingsDescribeMirror;
+        schema: SettingsSchemaService;
+    });
+    /**
+     * The shared mirror's read/fold face for cross-namespace surfaces (schema
+     * introspection, the served-namespace directory). Per-namespace consumers
+     * use {@link bind}; both derive from the same snapshot, so they can never
+     * disagree about the document.
+     * @returns the describe face over the shared mirror.
      */
-    constructor(ctx: Context);
+    describe(): SettingsDescribeFace;
     /**
-     * Bind one namespace scope to settings and connection invalidations on the
-     * CALLER's plugin lifecycle — the service proxy binds `this.ctx` to the
-     * caller at call time, so the scope's disposer belongs to the calling fiber.
-     * Listeners exist before the initial background read starts, so activation
-     * never blocks on the settings transport. The caller injects `connection`
-     * for the transport and `remote` for the forwarded settings invalidation.
+     * Bind one namespace scope on the CALLER's plugin lifecycle — the service
+     * proxy binds `this.ctx` to the caller at call time, so the scope's disposer
+     * belongs to the calling fiber. The scope derives from the shared mirror
+     * (whose invalidation subscriptions live with the providing plugin), so
+     * binding adds no wire read of its own and activation never blocks on the
+     * settings transport.
      * @param spec - domain-owned namespace contract.
      * @returns the bound scope consumed by the domain's services and rows.
      */

package/dist/kernel/client-ui-settings/lib/types/client/settings-scope.js

@@ -1,36 +1,50 @@
 /**
  * Host transport for the settings-namespace scope contract. The contract types
  * live in `nomix-client-runtime` (the common dependency of every feature that
- * owns a preference); this file owns the wire behavior and the invalidation
- * subscription, both of which are Settings-surface concerns.
+ * owns a preference); this file owns the per-namespace derivation over the
+ * shared {@link SettingsDescribeMirror} and the serialized write path, both of
+ * which are Settings-surface concerns. Reads never touch the wire here: the
+ * mirror is the one `settings.describe` reader, and every scope is a selector
+ * over its snapshot.
  */
 import { Service } from '../../../../cordis/lib/index.js';
-import { rehydrateSchema, validateDraft } from '../../../../client-schema-form/lib/index.js';
 import { createSnapshotStore, } from '../../../../client-runtime/lib/client.js';
 /**
- * Serializes one namespace's Host reads and writes behind a snapshot store.
- * Reads never block plugin activation; writes carry the latest known
- * namespace revision and teardown waits for the operation already crossing
- * the wire.
+ * One namespace's derived view over the shared describe mirror, plus that
+ * namespace's serialized Host writes. Writes carry the latest known namespace
+ * revision, fold their answers back into the mirror, and teardown waits for
+ * the operation already crossing the wire.
  */
 export class SettingsScopeController {
     api;
     spec;
+    mirror;
     persistence;
+    schema;
     store;
     tail = Promise.resolve();
-    readGeneration = 0;
     writeGeneration = 0;
     disposed = false;
+    unsubscribe;
     /**
-     * @param api - settings wire face.
+     * Revision answered by a superseded write still ahead of the mirror: the
+     * mirror only folds the LATEST settlement in, so a queued successor takes
+     * its fence from here first.
+     */
+    pendingRevision;
+    /**
+     * @param api - settings wire face (writes only; reads ride the mirror).
      * @param spec - namespace identity and optional narrowing decoder.
+     * @param mirror - the shared describe mirror this scope derives from.
      * @param persistence - remote browsers remain process-local because settings RPCs are loopback-only.
+     * @param schema - settings-owned schema operations.
      */
-    constructor(api, spec, persistence = 'host') {
+    constructor(api, spec, mirror, persistence, schema) {
         this.api = api;
         this.spec = spec;
+        this.mirror = mirror;
         this.persistence = persistence;
+        this.schema = schema;
         this.store = createSnapshotStore({
             status: persistence === 'host' ? 'loading' : 'unavailable',
             value: undefined,
@@ -40,6 +54,10 @@ export class SettingsScopeController {
             writable: false,
             mode: persistence,
         });
+        if (persistence === 'host') {
+            this.unsubscribe = mirror.subscribe(() => { this.derive(); });
+            this.derive();
+        }
     }
     /** @returns the current sync snapshot (stable reference until the next change). */
     getSnapshot() {
@@ -53,14 +71,6 @@ export class SettingsScopeController {
     subscribe(listener) {
         return this.store.subscribe(listener);
     }
-    /**
-     * Queue a Host refresh; a newer read or user write suppresses stale publication.
-     * @returns settlement after the queued read completes or is skipped.
-     */
-    load() {
-        const generation = ++this.readGeneration;
-        return this.enqueue(() => this.read(generation));
-    }
     /**
      * Queue one field write; see {@link SettingsScope.set} for the ordering,
      * revision, and recovery contract.
@@ -81,10 +91,9 @@ export class SettingsScopeController {
         return this.write({ op: 'unset', path: [field] });
     }
     write(op) {
-        this.readGeneration += 1;
         const generation = ++this.writeGeneration;
         return this.enqueue(async () => {
-            const revision = this.getSnapshot().revision;
+            const revision = this.pendingRevision ?? this.getSnapshot().revision;
             let response;
             try {
                 response = await this.api.settings.mutate({
@@ -94,26 +103,40 @@ export class SettingsScopeController {
                 });
             }
             catch (_settingsWriteFailure) {
-                if (!this.disposed && generation === this.writeGeneration)
-                    await this.read(++this.readGeneration);
+                await this.recover(generation);
                 return;
             }
             if (!response.result.ok) {
-                if (!this.disposed && generation === this.writeGeneration)
-                    await this.read(++this.readGeneration);
+                await this.recover(generation);
                 return;
             }
-            this.accept(response.result.value, generation === this.writeGeneration);
+            if (this.disposed)
+                return;
+            if (generation === this.writeGeneration) {
+                this.pendingRevision = undefined;
+                this.mirror.acceptView(response.result.value);
+            }
+            else {
+                this.pendingRevision = response.result.value.revision;
+            }
         });
     }
+    /** Reload Host state for the latest failed write; superseded failures leave recovery to it. */
+    async recover(generation) {
+        if (this.disposed || generation !== this.writeGeneration)
+            return;
+        this.pendingRevision = undefined;
+        await this.mirror.load();
+    }
     /**
-     * Stop queued operations and wait for the current wire call to settle.
+     * Stop queued operations, stop deriving, and wait for the current wire call
+     * to settle.
      * @returns settlement after the controller reaches quiescence.
      */
     async dispose() {
         this.disposed = true;
-        this.readGeneration += 1;
         this.writeGeneration += 1;
+        this.unsubscribe?.();
         await this.tail;
     }
     enqueue(operation) {
@@ -129,38 +152,27 @@ export class SettingsScopeController {
         this.tail = task.catch(() => { });
         return task;
     }
-    async read(generation) {
-        let response;
-        try {
-            response = await this.api.settings.describe({});
-        }
-        catch (_settingsReadFailure) {
+    derive() {
+        if (this.disposed)
             return;
-        }
-        if (!response.result.ok || this.disposed)
+        const mirrored = this.mirror.getSnapshot();
+        if (mirrored.view === undefined)
             return;
-        const { namespaces, writable } = response.result.value;
-        const view = namespaces.find(candidate => candidate.ns === this.spec.namespace);
-        const publish = generation === this.readGeneration;
+        const { writable } = mirrored.view;
+        const view = mirrored.view.namespaces.find(candidate => candidate.ns === this.spec.namespace);
         if (view === undefined) {
-            if (publish) {
-                this.store.update((draft) => {
-                    draft.status = 'unavailable';
-                    draft.writable = writable;
-                });
-            }
+            this.store.update((draft) => {
+                draft.status = 'unavailable';
+                draft.writable = writable;
+            });
             return;
         }
-        this.accept(view, publish, writable);
-    }
-    accept(view, publish, writable) {
-        const decoded = publish ? this.decode(view) : undefined;
+        const decoded = this.decode(view);
         this.store.update((draft) => {
             draft.revision = view.revision;
             draft.base = view.base;
             draft.user = view.user;
-            if (writable !== undefined)
-                draft.writable = writable;
+            draft.writable = writable;
             if (decoded === undefined)
                 return;
             draft.status = 'ready';
@@ -176,7 +188,7 @@ export class SettingsScopeController {
             return undefined;
         let failure;
         try {
-            failure = validateDraft(rehydrateSchema(view.schema), view.value);
+            failure = this.schema.validate(this.schema.rehydrate(view.schema), view.value);
         }
         catch (_malformedSchemaEnvelope) {
             // A schema envelope this client cannot rehydrate vouches for no section;
@@ -194,40 +206,45 @@ export class SettingsScopeController {
  * (`packages/client/tsdown.client.ts`).
  */
 export class SettingsScopeBinder extends Service {
+    mirror;
+    schema;
     /**
      * @param ctx - the providing plugin's context.
+     * @param config - the shared describe mirror every bound scope derives from,
+     * plus the settings-owned schema operations.
      */
-    constructor(ctx) {
+    constructor(ctx, config) {
         super(ctx, 'settingsScope');
+        this.mirror = config.mirror;
+        this.schema = config.schema;
+    }
+    /**
+     * The shared mirror's read/fold face for cross-namespace surfaces (schema
+     * introspection, the served-namespace directory). Per-namespace consumers
+     * use {@link bind}; both derive from the same snapshot, so they can never
+     * disagree about the document.
+     * @returns the describe face over the shared mirror.
+     */
+    describe() {
+        return this.mirror;
     }
     /**
-     * Bind one namespace scope to settings and connection invalidations on the
-     * CALLER's plugin lifecycle — the service proxy binds `this.ctx` to the
-     * caller at call time, so the scope's disposer belongs to the calling fiber.
-     * Listeners exist before the initial background read starts, so activation
-     * never blocks on the settings transport. The caller injects `connection`
-     * for the transport and `remote` for the forwarded settings invalidation.
+     * Bind one namespace scope on the CALLER's plugin lifecycle — the service
+     * proxy binds `this.ctx` to the caller at call time, so the scope's disposer
+     * belongs to the calling fiber. The scope derives from the shared mirror
+     * (whose invalidation subscriptions live with the providing plugin), so
+     * binding adds no wire read of its own and activation never blocks on the
+     * settings transport.
      * @param spec - domain-owned namespace contract.
      * @returns the bound scope consumed by the domain's services and rows.
      */
     bind(spec) {
         const ctx = this.ctx;
         const connection = ctx.get('connection');
-        const controller = new SettingsScopeController(connection.api, spec, connection.isLoopback ? 'host' : 'memory');
+        const controller = new SettingsScopeController(connection.api, spec, this.mirror, connection.isLoopback ? 'host' : 'memory', this.schema);
         ctx.effect(() => {
-            const refresh = (namespace) => {
-                if (namespace !== undefined && namespace !== spec.namespace)
-                    return;
-                void controller.load();
-            };
-            const disposers = [
-                ctx.get('remote').$on('settings/document-updated', refresh),
-                ctx.on('connection/reset', () => { refresh(); }),
-            ];
-            void controller.load();
+            void this.mirror.ensure();
             return async () => {
-                for (const dispose of disposers)
-                    dispose();
                 await controller.dispose();
             };
         }, `ui-settings: ${spec.namespace} settings scope`);

package/dist/kernel/client-ui-settings/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-client-ui-settings",
   "description": "Settings domain base plugin: the settings-namespace scope service and the canonical settings slot-type contract",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -44,28 +44,28 @@
     "watch": "tsdown --watch"
   },
   "license": "MIT",
+  "dependencies": {
+    "@nomix-ai/schemastery": "workspace:^"
+  },
   "peerDependencies": {
     "@nomix-ai/cordis": "workspace:^",
     "@nomix-ai/nomix-api-remotes": "workspace:^",
     "@nomix-ai/nomix-client-connection": "workspace:^",
     "@nomix-ai/nomix-client-runtime": "workspace:^",
-    "@nomix-ai/nomix-client-schema-form": "workspace:^",
-    "@nomix-ai/nomix-client-ui-slots": "workspace:^",
     "@nomix-ai/nomix-invariants": "workspace:^",
-    "@nomix-ai/nomix-settings": "workspace:^",
-    "react": "^18.2.0"
+    "@nomix-ai/nomix-settings": "workspace:^"
   },
   "devDependencies": {
     "@nomix-ai/cordis": "workspace:^",
     "@nomix-ai/nomix-api-remotes": "workspace:^",
     "@nomix-ai/nomix-client-runtime": "workspace:^",
-    "@nomix-ai/nomix-client-schema-form": "workspace:^",
     "@nomix-ai/nomix-client-test-runtime": "workspace:^",
     "@nomix-ai/nomix-client-ui-slots": "workspace:^",
     "@nomix-ai/nomix-invariants": "workspace:^",
     "@nomix-ai/nomix-settings": "workspace:^",
     "@types/react": "~18.3.1",
-    "react": "^18.2.0"
+    "react": "^18.2.0",
+    "@nomix-ai/nomix-client-connection": "workspace:^"
   },
   "files": [
     "lib/index.js",

package/dist/kernel/client-ui-settings-general/lib/client.js

@@ -5,7 +5,6 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let _nomix_ai_nomix_client_ui_slots = require("@nomix-ai/nomix-client-ui-slots");
-		let _nomix_ai_nomix_client_web_react = require("@nomix-ai/nomix-client-web-react");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
 		let _nomix_ai_nomix_client_ui_primitives = require("@nomix-ai/nomix-client-ui-primitives");
@@ -36,25 +35,25 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var SettingsRoot_module_css_default = {
-			"navList": "zCBVeW_navList",
-			"navLabel": "zCBVeW_navLabel",
-			"options": "zCBVeW_options",
+			"actions": "zCBVeW_actions",
+			"active": "zCBVeW_active",
+			"close": "zCBVeW_close",
 			"content": "zCBVeW_content",
-			"panel": "zCBVeW_panel",
+			"header": "zCBVeW_header",
+			"hiddenLabel": "zCBVeW_hiddenLabel",
+			"mask": "zCBVeW_mask",
 			"nav": "zCBVeW_nav",
-			"overlay": "zCBVeW_overlay",
 			"navCell": "zCBVeW_navCell",
 			"navIcon": "zCBVeW_navIcon",
+			"navLabel": "zCBVeW_navLabel",
+			"navList": "zCBVeW_navList",
 			"navTitle": "zCBVeW_navTitle",
-			"hiddenLabel": "zCBVeW_hiddenLabel",
-			"mask": "zCBVeW_mask",
-			"header": "zCBVeW_header",
-			"close": "zCBVeW_close",
-			"actions": "zCBVeW_actions",
+			"options": "zCBVeW_options",
+			"overlay": "zCBVeW_overlay",
+			"panel": "zCBVeW_panel",
 			"rail": "zCBVeW_rail",
-			"triggerLabel": "zCBVeW_triggerLabel",
-			"active": "zCBVeW_active",
-			"trigger": "zCBVeW_trigger"
+			"trigger": "zCBVeW_trigger",
+			"triggerLabel": "zCBVeW_triggerLabel"
 		};
 		//#endregion
 		//#region lib/types/client/SettingsRoot.js
@@ -311,8 +310,8 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var SettingsDocumentAction_module_css_default = {
-			"error": "N_Pcma_error",
-			"action": "N_Pcma_action"
+			"action": "N_Pcma_action",
+			"error": "N_Pcma_error"
 		};
 		//#endregion
 		//#region lib/types/client/SettingsDocumentAction.js
@@ -351,53 +350,40 @@ window.__ModuleLoader__.load({
 		function messageOf(error) {
 			return error instanceof Error ? error.message : String(error);
 		}
-		/** Loads local-document availability and invokes the pathless Host-owned open operation. */
+		/** Derives local-document availability from the shared mirror and invokes the pathless Host-owned open operation. */
 		var SettingsDocumentStore = class {
 			api;
+			describeFace;
 			/** uSES-safe state source shared by the registered header action. */
 			store = (0, _nomix_ai_nomix_client_runtime_client.createSnapshotStore)({
 				status: "idle",
 				opening: false,
 				error: null
 			});
-			generation = 0;
+			following;
 			/**
-			* @param api - loopback settings wire face that reports and opens the provider document.
+			* @param api - loopback settings wire face that opens the provider document.
+			* @param describeFace - the shared mirror's describe face (`hasDocument` source).
 			*/
-			constructor(api) {
+			constructor(api, describeFace) {
 				this.api = api;
+				this.describeFace = describeFace;
 			}
 			/**
-			* Load whether the current provider owns a local document.
-			* @returns after the latest metadata response updates the store.
+			* Begin following the mirror (idempotent) and reflect whether the current
+			* provider owns a local document.
+			* @returns settlement once the snapshot reflects the mirror.
 			*/
 			async load() {
-				const generation = ++this.generation;
+				this.following ??= this.describeFace.subscribe(() => {
+					this.derive();
+				});
 				this.store.update((state) => {
 					state.status = "loading";
 					state.error = null;
 				});
-				try {
-					const { result } = await this.api.settings.describe({});
-					if (generation !== this.generation) return;
-					if (!result.ok) {
-						this.store.update((state) => {
-							state.status = "unavailable";
-							state.error = result.error.message;
-						});
-						return;
-					}
-					this.store.update((state) => {
-						state.status = result.value.hasDocument ? "ready" : "unavailable";
-						state.error = null;
-					});
-				} catch (error) {
-					if (generation !== this.generation) return;
-					this.store.update((state) => {
-						state.status = "unavailable";
-						state.error = messageOf(error);
-					});
-				}
+				await this.describeFace.ensure();
+				this.derive();
 			}
 			/**
 			* Open the loaded document once; concurrent gestures collapse behind the in-flight action.
@@ -423,15 +409,27 @@ window.__ModuleLoader__.load({
 					});
 				}
 			}
+			/** Stop following the mirror. */
+			dispose() {
+				this.following?.();
+				this.following = void 0;
+			}
+			derive() {
+				const mirrored = this.describeFace.getSnapshot();
+				if (mirrored.view === void 0) {
+					if (mirrored.error !== null) this.store.update((state) => {
+						state.status = "unavailable";
+						state.error = mirrored.error;
+					});
+					return;
+				}
+				const { hasDocument } = mirrored.view;
+				this.store.update((state) => {
+					state.status = hasDocument ? "ready" : "unavailable";
+					state.error = null;
+				});
+			}
 		};
-		/**
-		* Refresh document availability after reconnect only when a surface has already requested it.
-		* @param controller - optional loopback document state owner.
-		*/
-		function refreshDocumentIfLoaded(controller) {
-			if (controller === void 0 || controller.store.getSnapshot().status === "idle") return;
-			controller.load();
-		}
 		//#endregion
 		//#region lib/types/client/locales.js
 		/** Shell chrome and General-nav dictionaries; feature rows own their copy. */
@@ -465,7 +463,8 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"slots",
 			"locale",
-			"connection"
+			"connection",
+			"settingsScope"
 		];
 		/**
 		* Register the `settings` dictionaries, the chrome content, and the General
@@ -479,17 +478,14 @@ window.__ModuleLoader__.load({
 			}), "ui-settings-general: dictionaries");
 			const t = ctx.locale.bind(NS);
 			const connection = ctx.get("connection");
-			const documentController = connection.isLoopback ? new SettingsDocumentStore(connection.api) : void 0;
-			const documentInjected = documentController === void 0 ? void 0 : (() => {
-				const useSnapshot = (0, _nomix_ai_nomix_client_web_react.bindSnapshotSelector)(documentController.store);
-				return () => ({
-					controller: documentController,
-					useSnapshot
-				});
-			})();
-			ctx.effect(() => ctx.on("connection/reset", () => {
-				refreshDocumentIfLoaded(documentController);
-			}), "ui-settings-general: metadata invalidations");
+			const documentController = connection.isLoopback ? new SettingsDocumentStore(connection.api, ctx.settingsScope.describe()) : void 0;
+			const documentInjected = documentController === void 0 ? void 0 : () => ({
+				controller: documentController,
+				hooks: { snapshot: documentController.store }
+			});
+			ctx.effect(() => () => {
+				documentController?.dispose();
+			}, "ui-settings-general: document action directory");
 			let rowsVersion = -1;
 			let rowsRevision = -1;
 			let rows = [];