@nomix-ai/nomix-harness 0.2.4 → 0.2.6

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

@@ -1,12 +1,11 @@
 /**
  * Models settings page store: one snapshot joining the configurable-provider
- * directory (`llm.providers`), the settings namespaces (`settings.describe`),
+ * directory (`llm.providers`), the settings namespaces (shared settings mirror),
  * and the referenced credentials (`credentials.describe`). The host stays the
  * single fact source — every mutation writes through the wire and the page
  * re-renders from the next describe, pushed or refetched.
  */
 import { createSnapshotStore } from '../../../../client-runtime/lib/client.js';
-import { getPath, hasPath, nodeAtPath, rehydrateSchema } from '../../../../client-schema-form/lib/index.js';
 /**
  * Any route key walks a dict schema to the same profile node, so the lookup
  * names one that cannot collide with a configured route.
@@ -38,22 +37,23 @@ export function deriveKeyRef(provider) {
  * the choices the page offers cannot drift from the ones the adapter accepts:
  * both come from the same `Config`.
  * @param namespace - the namespace view whose schema declares the profile shape.
+ * @param schema - settings schema operations.
  * @returns the protocol identifiers, or an empty list when the schema has none.
  */
-export function protocolChoices(namespace) {
+export function protocolChoices(namespace, schema) {
     if (namespace === undefined)
         return [];
-    const node = nodeAtPath(rehydrateSchema(namespace.schema), ['providers', PROBE_ROUTE, 'api']);
+    const node = schema.nodeAtPath(schema.rehydrate(namespace.schema), ['providers', PROBE_ROUTE, 'api']);
     const list = node;
     if (list?.type !== 'union' || list.list === undefined)
         return [];
     return list.list.map(entry => entry.value).filter((value) => typeof value === 'string');
 }
 /** The credential reference a resolved profile names (its `apiKeyEnv` field). */
-function apiKeyEnvOf(namespace, path) {
+function apiKeyEnvOf(namespace, path, schema) {
     if (namespace === undefined)
         return undefined;
-    const profile = getPath(namespace.value, path);
+    const profile = schema.getPath(namespace.value, path);
     if (typeof profile !== 'object' || profile === null)
         return undefined;
     const ref = profile.apiKeyEnv;
@@ -62,6 +62,8 @@ function apiKeyEnvOf(namespace, path) {
 /** The models settings page controller (one per settings surface). */
 export class ModelsSettingsStore {
     api;
+    schema;
+    describeFace;
     /** The snapshot the section renders from (uSES-safe store). */
     store = createSnapshotStore({
         status: 'idle', error: null, credentialError: null, writable: false, rows: [], namespaces: new Map(),
@@ -69,15 +71,20 @@ export class ModelsSettingsStore {
     /** Latest load wins; an older response never overwrites a newer one. */
     generation = 0;
     /**
-     * @param api - the wire face (settings/credentials/llm domains).
+     * @param api - the wire face (credentials/llm domains, and settings writes).
+     * @param describeFace - the shared mirror's describe face (namespace views and writability).
      */
-    constructor(api) {
+    constructor(api, schema, describeFace) {
         this.api = api;
+        this.schema = schema;
+        this.describeFace = describeFace;
     }
     /**
-     * Refresh the whole page snapshot: directory and namespaces in parallel,
-     * then one batched credential describe over every referenced ref. A
-     * failure keeps the last good rows and surfaces the error.
+     * Refresh the whole page snapshot: the provider directory and the mirror's
+     * settings answer in parallel, then one batched credential describe over
+     * every referenced ref. Provider failure or absence of an initial settings
+     * answer keeps the last good rows and surfaces an error; a failed settings
+     * refresh reuses the mirror's held view.
      * @returns nothing; the snapshot carries the outcome.
      */
     async load() {
@@ -87,17 +94,19 @@ export class ModelsSettingsStore {
         let writable;
         let views;
         try {
-            const [providersResponse, settingsResponse] = await Promise.all([
+            const [providersResponse] = await Promise.all([
                 this.api.llm.providers({}),
-                this.api.settings.describe({}),
+                this.describeFace.ensure(),
             ]);
             if (!providersResponse.result.ok)
                 throw new Error(providersResponse.result.error.message);
-            if (!settingsResponse.result.ok)
-                throw new Error(settingsResponse.result.error.message);
+            const mirrored = this.describeFace.getSnapshot();
+            if (mirrored.view === undefined) {
+                throw new Error(mirrored.error ?? 'settings are unavailable in this browser');
+            }
             providers = providersResponse.result.value.providers;
-            writable = settingsResponse.result.value.writable;
-            views = settingsResponse.result.value.namespaces;
+            writable = mirrored.view.writable;
+            views = mirrored.view.namespaces;
         }
         catch (error) {
             if (generation !== this.generation)
@@ -112,16 +121,16 @@ export class ModelsSettingsStore {
         const rows = providers.map((entry) => {
             const namespace = namespaces.get(entry.settingsNs);
             const configured = namespace !== undefined
-                && (entry.settingsPath.length === 0 || getPath(namespace.value, entry.settingsPath) !== undefined);
+                && (entry.settingsPath.length === 0 || this.schema.getPath(namespace.value, entry.settingsPath) !== undefined);
             const removable = namespace !== undefined
                 && entry.settingsPath.length > 0
-                && hasPath(namespace.user, entry.settingsPath)
-                && !hasPath(namespace.base, entry.settingsPath);
+                && this.schema.hasPath(namespace.user, entry.settingsPath)
+                && !this.schema.hasPath(namespace.base, entry.settingsPath);
             return {
                 entry,
                 configured,
                 removable,
-                apiKeyEnv: apiKeyEnvOf(namespace, entry.settingsPath),
+                apiKeyEnv: apiKeyEnvOf(namespace, entry.settingsPath, this.schema),
                 credential: undefined,
             };
         });

package/dist/kernel/client-ui-settings-models/lib/types/client/welcome-store.d.ts

@@ -1,36 +1,53 @@
-/** Welcome-notice state, durable when the browser may use Host settings. */
-import type { IApiClient } from '../../../../api-remotes/lib/client.js';
-import type { SnapshotStore } from '../../../../client-runtime/lib/client.js';
+/**
+ * Welcome-notice state derived from the welcome settings scope. The scope is
+ * the transport: a loopback browser follows the durable Host section, while a
+ * remote browser's memory-mode scope never answers and the acknowledgement
+ * stays process-local here.
+ */
+import type { SettingsScope, SnapshotStore } from '../../../../client-runtime/lib/client.js';
 /** State rendered by the welcome step. */
 export interface WelcomeNoticeState {
     status: 'idle' | 'loading' | 'ready' | 'saving' | 'error';
     acknowledged: boolean;
     error: string | null;
 }
+/** The welcome section as the notice reads it. */
+export type WelcomeSection = Record<string, unknown>;
+/**
+ * Accept any object section verbatim; a malformed durable value reads as an
+ * empty section, so the notice treats it as unacknowledged instead of leaving
+ * the scope stuck on its previous value.
+ * @param section - the wire section value.
+ * @returns the section object, or an empty one for non-object values.
+ */
+export declare function decodeWelcomeSection(section: unknown): WelcomeSection;
 /** Coordinates durable Host acknowledgement or a process-local remote fallback. */
 export declare class WelcomeNoticeStore {
-    private readonly api;
-    private readonly persistence;
+    private readonly scope;
     /** uSES-safe state source shared by the registered welcome step. */
     readonly store: SnapshotStore<WelcomeNoticeState>;
-    private generation;
+    private localAcknowledged;
+    private saving;
+    private following;
     /**
-     * @param api - settings wire face used for durable reads and writes.
-     * @param persistence - remote browsers use memory because settings is loopback-only.
+     * @param scope - the welcome settings namespace scope; its memory mode is
+     * what keeps a remote browser process-local.
+     */
+    constructor(scope: SettingsScope<WelcomeSection>);
+    /**
+     * Begin following the bound scope (idempotent) and publish its current answer.
+     * @returns settlement after the current answer is published.
      */
-    constructor(api: Pick<IApiClient, 'settings'>, persistence?: 'host' | 'memory');
-    /** Load the acknowledgement from Host settings or initialize process-local state. */
     load(): Promise<void>;
     /**
-     * Persist this copy version, or advance only this process for a remote browser.
-     * @returns true when the selected persistence mode accepted the acknowledgement.
+     * Persist this copy version, or advance only this process for a remote
+     * browser. Success is judged against the state the write left behind, so a
+     * refused or failed write reports false after its recovery read settles.
+     * @returns true when the selected persistence mode holds the acknowledgement.
      */
     acknowledge(): Promise<boolean>;
+    /** Stop following the scope. */
+    dispose(): void;
+    private derive;
 }
-/**
- * Refresh only after welcome state has left idle. A memory-mode load retains
- * acknowledgement so reconnect does not reopen a process-local notice.
- * @param controller - welcome state owner whose current status decides whether to load.
- */
-export declare function refreshWelcomeIfLoaded(controller: WelcomeNoticeStore): void;
 //# sourceMappingURL=welcome-store.d.ts.map

package/dist/kernel/client-ui-settings-models/lib/types/client/welcome-store.js

@@ -1,116 +1,123 @@
-/** Welcome-notice state, durable when the browser may use Host settings. */
+/**
+ * Welcome-notice state derived from the welcome settings scope. The scope is
+ * the transport: a loopback browser follows the durable Host section, while a
+ * remote browser's memory-mode scope never answers and the acknowledgement
+ * stays process-local here.
+ */
 import { createSnapshotStore } from '../../../../client-runtime/lib/client.js';
-import { WELCOME_NOTICE_ACK_FIELD, WELCOME_NOTICE_SETTINGS_NAMESPACE, WELCOME_NOTICE_VERSION, } from "../onboarding-copy.js";
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
+import { WELCOME_NOTICE_ACK_FIELD, WELCOME_NOTICE_VERSION, } from "../onboarding-copy.js";
+/**
+ * Accept any object section verbatim; a malformed durable value reads as an
+ * empty section, so the notice treats it as unacknowledged instead of leaving
+ * the scope stuck on its previous value.
+ * @param section - the wire section value.
+ * @returns the section object, or an empty one for non-object values.
+ */
+export function decodeWelcomeSection(section) {
+    return typeof section === 'object' && section !== null && !Array.isArray(section)
+        ? section
+        : {};
 }
-function acknowledgementOf(view) {
-    if (typeof view.value !== 'object' || view.value === null)
-        return undefined;
-    const value = view.value[WELCOME_NOTICE_ACK_FIELD];
-    return typeof value === 'string' ? value : undefined;
+/* v8 ignore next 3 -- closed-union default only defends future source widening */
+function assertNever(_value) {
+    throw new Error('unexpected welcome settings status');
 }
 /** Coordinates durable Host acknowledgement or a process-local remote fallback. */
 export class WelcomeNoticeStore {
-    api;
-    persistence;
+    scope;
     /** uSES-safe state source shared by the registered welcome step. */
     store = createSnapshotStore({
         status: 'idle', acknowledged: false, error: null,
     });
-    generation = 0;
+    localAcknowledged = false;
+    saving = false;
+    following;
     /**
-     * @param api - settings wire face used for durable reads and writes.
-     * @param persistence - remote browsers use memory because settings is loopback-only.
+     * @param scope - the welcome settings namespace scope; its memory mode is
+     * what keeps a remote browser process-local.
      */
-    constructor(api, persistence = 'host') {
-        this.api = api;
-        this.persistence = persistence;
+    constructor(scope) {
+        this.scope = scope;
     }
-    /** Load the acknowledgement from Host settings or initialize process-local state. */
-    async load() {
-        const generation = ++this.generation;
-        if (this.persistence === 'memory') {
-            this.store.update((state) => { state.status = 'ready'; state.error = null; });
-            return;
+    /**
+     * Begin following the bound scope (idempotent) and publish its current answer.
+     * @returns settlement after the current answer is published.
+     */
+    load() {
+        this.following ??= this.scope.subscribe(() => { this.derive(); });
+        this.derive();
+        return Promise.resolve();
+    }
+    /**
+     * Persist this copy version, or advance only this process for a remote
+     * browser. Success is judged against the state the write left behind, so a
+     * refused or failed write reports false after its recovery read settles.
+     * @returns true when the selected persistence mode holds the acknowledgement.
+     */
+    async acknowledge() {
+        if (this.scope.getSnapshot().mode === 'memory') {
+            this.localAcknowledged = true;
+            this.derive();
+            return true;
         }
-        this.store.update((state) => { state.status = 'loading'; state.error = null; });
+        this.saving = true;
+        this.store.update((state) => { state.status = 'saving'; state.error = null; });
         try {
-            const response = await this.api.settings.describe({});
-            if (!response.result.ok)
-                throw new Error(response.result.error.message);
-            const view = response.result.value.namespaces.find(candidate => candidate.ns === WELCOME_NOTICE_SETTINGS_NAMESPACE);
-            if (view === undefined)
-                throw new Error('welcome acknowledgement settings are unavailable');
-            if (generation !== this.generation)
-                return;
-            this.store.update((state) => {
-                state.status = 'ready';
-                state.acknowledged = acknowledgementOf(view) === WELCOME_NOTICE_VERSION;
-                state.error = null;
-            });
+            await this.scope.set(WELCOME_NOTICE_ACK_FIELD, WELCOME_NOTICE_VERSION);
         }
-        catch (error) {
-            if (generation !== this.generation)
-                return;
+        finally {
+            this.saving = false;
+        }
+        this.derive();
+        const { acknowledged } = this.store.getSnapshot();
+        if (!acknowledged) {
             this.store.update((state) => {
                 state.status = 'error';
-                state.acknowledged = false;
-                state.error = messageOf(error);
+                state.error = 'the acknowledgement did not persist';
             });
         }
+        return acknowledged;
     }
-    /**
-     * Persist this copy version, or advance only this process for a remote browser.
-     * @returns true when the selected persistence mode accepted the acknowledgement.
-     */
-    async acknowledge() {
-        const generation = ++this.generation;
-        if (this.persistence === 'memory') {
+    /** Stop following the scope. */
+    dispose() {
+        this.following?.();
+        this.following = undefined;
+    }
+    derive() {
+        if (this.saving)
+            return;
+        const scope = this.scope.getSnapshot();
+        if (scope.mode === 'memory') {
             this.store.update((state) => {
                 state.status = 'ready';
-                state.acknowledged = true;
+                state.acknowledged = this.localAcknowledged;
                 state.error = null;
             });
-            return true;
-        }
-        this.store.update((state) => { state.status = 'saving'; state.error = null; });
-        try {
-            const response = await this.api.settings.mutate({
-                ns: WELCOME_NOTICE_SETTINGS_NAMESPACE,
-                ops: [{ op: 'set', path: [WELCOME_NOTICE_ACK_FIELD], value: WELCOME_NOTICE_VERSION }],
-            });
-            if (!response.result.ok)
-                throw new Error(response.result.error.message);
-            if (generation === this.generation) {
-                this.store.update((state) => {
-                    state.status = 'ready';
-                    state.acknowledged = true;
-                    state.error = null;
-                });
-            }
-            return true;
+            return;
         }
-        catch (error) {
-            if (generation === this.generation) {
+        switch (scope.status) {
+            case 'loading':
+                this.store.update((state) => { state.status = 'loading'; state.error = null; });
+                return;
+            case 'unavailable':
                 this.store.update((state) => {
                     state.status = 'error';
                     state.acknowledged = false;
-                    state.error = messageOf(error);
+                    state.error = 'welcome acknowledgement settings are unavailable';
                 });
+                return;
+            case 'ready': {
+                const acknowledged = scope.value?.[WELCOME_NOTICE_ACK_FIELD] === WELCOME_NOTICE_VERSION;
+                this.store.update((state) => {
+                    state.status = 'ready';
+                    state.acknowledged = acknowledged;
+                    state.error = null;
+                });
+                return;
             }
-            return false;
+            /* v8 ignore next -- every current settings scope status is handled above */
+            default: return assertNever(scope.status);
         }
     }
 }
-/**
- * Refresh only after welcome state has left idle. A memory-mode load retains
- * acknowledgement so reconnect does not reopen a process-local notice.
- * @param controller - welcome state owner whose current status decides whether to load.
- */
-export function refreshWelcomeIfLoaded(controller) {
-    if (controller.store.getSnapshot().status === 'idle')
-        return;
-    void controller.load();
-}
 //# sourceMappingURL=welcome-store.js.map

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

@@ -2,7 +2,7 @@
  * Package-owned invariant companion for `@nomix-ai/nomix-client-ui-settings-models`.
  * @module @nomix-ai/nomix-client-ui-settings-models/invariant
  */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../cordis/lib/index.js';
 /** Cordis companion plugin name. */
 export declare const name = "client-ui-settings-models-invariant";
 /** Service required before the companion can reserve package ownership. */

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

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-client-ui-settings-models",
   "description": "Models settings and shared product-onboarding dialogs over existing settings and credential joins",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -50,24 +50,19 @@
     "@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-primitives": "workspace:^",
-    "@nomix-ai/nomix-client-ui-slots": "workspace:^",
-    "@nomix-ai/nomix-client-web-react": "workspace:^",
     "@nomix-ai/nomix-invariants": "workspace:^",
-    "react": "^18.2.0"
+    "@nomix-ai/nomix-client-locale": "workspace:^",
+    "@nomix-ai/nomix-client-ui-settings": "workspace:^"
   },
   "devDependencies": {
     "@nomix-ai/nomix-api-remotes": "workspace:^",
     "@nomix-ai/nomix-client-connection": "workspace:^",
     "@nomix-ai/nomix-client-locale": "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-primitives": "workspace:^",
     "@nomix-ai/nomix-client-ui-settings": "workspace:^",
     "@nomix-ai/nomix-client-ui-slots": "workspace:^",
-    "@nomix-ai/nomix-client-web-react": "workspace:^",
     "@nomix-ai/nomix-invariants": "workspace:^",
     "@types/react": "~18.3.1",
     "@nomix-ai/cordis": "workspace:^",

package/dist/kernel/client-ui-settings-plugin-inventory/lib/client.js

@@ -18,23 +18,23 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var PluginInventorySettingsTab_module_css_default = {
-			"section": "OqotSa_section",
+			"card": "OqotSa_card",
+			"cardContent": "OqotSa_cardContent",
+			"cardDetails": "OqotSa_cardDetails",
 			"cardTitle": "OqotSa_cardTitle",
+			"cardTrailing": "OqotSa_cardTrailing",
 			"cards": "OqotSa_cards",
+			"catalog": "OqotSa_catalog",
+			"catalogHeading": "OqotSa_catalogHeading",
+			"chevron": "OqotSa_chevron",
 			"configTag": "OqotSa_configTag",
-			"cardContent": "OqotSa_cardContent",
-			"cardDetails": "OqotSa_cardDetails",
 			"details": "OqotSa_details",
-			"statusDot": "OqotSa_statusDot",
-			"card": "OqotSa_card",
-			"catalog": "OqotSa_catalog",
 			"entryValue": "OqotSa_entryValue",
-			"chevron": "OqotSa_chevron",
-			"status": "OqotSa_status",
-			"search": "OqotSa_search",
-			"cardTrailing": "OqotSa_cardTrailing",
-			"catalogHeading": "OqotSa_catalogHeading",
 			"failure": "OqotSa_failure",
+			"search": "OqotSa_search",
+			"section": "OqotSa_section",
+			"status": "OqotSa_status",
+			"statusDot": "OqotSa_statusDot",
 			"visuallyHidden": "OqotSa_visuallyHidden"
 		};
 		//#endregion

package/dist/kernel/client-ui-settings-plugin-inventory/lib/types/invariant.d.ts

@@ -1,5 +1,5 @@
 /** Package-owned invariant companion. @module @nomix-ai/nomix-client-ui-settings-plugin-inventory/invariant */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../cordis/lib/index.js';
 /** Cordis companion plugin name. */
 export declare const name = "client-ui-settings-plugin-inventory-invariant";
 /** Service required before the companion can reserve package ownership. */

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

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-client-ui-settings-plugin-inventory",
   "description": "Read-only Cordis Loader inventory tab in Web Plugins settings",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -49,12 +49,9 @@
     "@nomix-ai/nomix-api-remotes": "workspace:^",
     "@nomix-ai/nomix-client-locale": "workspace:^",
     "@nomix-ai/nomix-client-runtime": "workspace:^",
-    "@nomix-ai/nomix-client-ui-primitives": "workspace:^",
     "@nomix-ai/nomix-client-ui-settings": "workspace:^",
-    "@nomix-ai/nomix-client-ui-slots": "workspace:^",
     "@nomix-ai/nomix-invariants": "workspace:^",
-    "@nomix-ai/cordis": "workspace:^",
-    "react": "^18.2.0"
+    "@nomix-ai/cordis": "workspace:^"
   },
   "devDependencies": {
     "@nomix-ai/nomix-api-remotes": "workspace:^",