@nomix-ai/nomix-harness 0.2.4 → 0.2.6

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

@@ -20,17 +20,17 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var fields_module_css_default = {
-			"reset": "Z-6aPG_reset",
+			"badge": "Z-6aPG_badge",
+			"badgeMuted": "Z-6aPG_badgeMuted",
 			"badges": "Z-6aPG_badges",
+			"field": "Z-6aPG_field",
 			"head": "Z-6aPG_head",
-			"label": "Z-6aPG_label",
-			"input": "Z-6aPG_input",
-			"invalid": "Z-6aPG_invalid",
 			"hint": "Z-6aPG_hint",
-			"field": "Z-6aPG_field",
+			"input": "Z-6aPG_input",
 			"inputInvalid": "Z-6aPG_inputInvalid",
-			"badgeMuted": "Z-6aPG_badgeMuted",
-			"badge": "Z-6aPG_badge"
+			"invalid": "Z-6aPG_invalid",
+			"label": "Z-6aPG_label",
+			"reset": "Z-6aPG_reset"
 		};
 		//#endregion
 		//#region lib/types/client/fields.js
@@ -162,21 +162,21 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var PluginCard_module_css_default = {
-			"pending": "g6_66q_pending",
-			"header": "g6_66q_header",
-			"description": "g6_66q_description",
 			"body": "g6_66q_body",
-			"footer": "g6_66q_footer",
 			"card": "g6_66q_card",
+			"cardOpen": "g6_66q_cardOpen",
+			"chevron": "g6_66q_chevron",
 			"chevronOpen": "g6_66q_chevronOpen",
+			"description": "g6_66q_description",
+			"discard": "g6_66q_discard",
 			"failed": "g6_66q_failed",
+			"footer": "g6_66q_footer",
 			"headText": "g6_66q_headText",
-			"discard": "g6_66q_discard",
-			"save": "g6_66q_save",
+			"header": "g6_66q_header",
 			"name": "g6_66q_name",
-			"cardOpen": "g6_66q_cardOpen",
-			"chevron": "g6_66q_chevron",
-			"readOnly": "g6_66q_readOnly"
+			"pending": "g6_66q_pending",
+			"readOnly": "g6_66q_readOnly",
+			"save": "g6_66q_save"
 		};
 		//#endregion
 		//#region lib/types/client/PluginCard.js
@@ -371,14 +371,14 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var PluginsSettingsSection_module_css_default = {
-			"heading": "Wo5A1q_heading",
+			"cards": "Wo5A1q_cards",
 			"empty": "Wo5A1q_empty",
-			"section": "Wo5A1q_section",
+			"heading": "Wo5A1q_heading",
+			"intro": "Wo5A1q_intro",
 			"panel": "Wo5A1q_panel",
-			"tabs": "Wo5A1q_tabs",
+			"section": "Wo5A1q_section",
 			"tab": "Wo5A1q_tab",
-			"intro": "Wo5A1q_intro",
-			"cards": "Wo5A1q_cards"
+			"tabs": "Wo5A1q_tabs"
 		};
 		//#endregion
 		//#region lib/types/client/ConfigurablePluginsTab.js
@@ -920,47 +920,28 @@ window.__ModuleLoader__.load({
 		* is never dispatched, so a plugin this deployment did not compose leaves no
 		* trace and does not count toward the empty line.
 		*/
-		/** Reads the served namespaces and pairs them with the cards that claim them. */
+		/** Derives the served namespaces from the shared describe mirror and pairs them with the cards that claim them. */
 		var ConfigurablePluginsTabController = class {
-			api;
+			describeFace;
 			entries;
 			store = (0, _nomix_ai_nomix_client_runtime_client.createSnapshotStore)({
 				loaded: false,
 				namespaces: []
 			});
-			/** Last Host answer; kept so a slot mutation republishes without a wire read. */
-			served = [];
-			loaded = false;
-			generation = 0;
 			disposed = false;
+			unsubscribe;
 			/**
-			* @param api - settings wire face.
+			* @param describeFace - the shared mirror's describe face; its refreshes
+			* (document commits, reconnects) are what keep the served set current.
 			* @param entries - reads the cards currently registered into the section's slot.
 			*/
-			constructor(api, entries) {
-				this.api = api;
+			constructor(describeFace, entries) {
+				this.describeFace = describeFace;
 				this.entries = entries;
-			}
-			/** Opaque read of {@link disposed}: control flow cannot narrow it across awaits. */
-			isDisposed() {
-				return this.disposed;
-			}
-			/**
-			* Re-read the served namespaces from the Host and republish.
-			* @returns settlement after the read, or immediately once disposed.
-			*/
-			async load() {
-				if (this.isDisposed()) return;
-				const generation = ++this.generation;
-				let response;
-				try {
-					response = await this.api.settings.describe({});
-				} catch (_settingsReadFailure) {
-					return;
-				}
-				if (this.isDisposed() || generation !== this.generation || !response.result.ok) return;
-				this.served = response.result.value.namespaces.map((view) => view.ns);
-				this.loaded = true;
+				this.unsubscribe = describeFace.subscribe(() => {
+					this.publish();
+				});
+				describeFace.ensure();
 				this.publish();
 			}
 			/** Republish after the slot ledger changed; a card registered late joins here. */
@@ -968,10 +949,10 @@ window.__ModuleLoader__.load({
 				if (this.disposed) return;
 				this.publish();
 			}
-			/** Stop publishing; an in-flight read settles without touching the store. */
+			/** Stop publishing and stop following the mirror. */
 			dispose() {
 				this.disposed = true;
-				this.generation += 1;
+				this.unsubscribe();
 			}
 			/**
 			* Build the face the tab's slot registration injects.
@@ -981,12 +962,15 @@ window.__ModuleLoader__.load({
 				return { hooks: { configurablePlugins: this.store } };
 			}
 			publish() {
-				const served = new Set(this.served);
+				if (this.disposed) return;
+				const mirrored = this.describeFace.getSnapshot();
+				const loaded = mirrored.view !== void 0;
+				const served = new Set(mirrored.view?.namespaces.map((view) => view.ns) ?? []);
 				const namespaces = this.entries().flatMap((entry) => entry.options.key !== void 0 && served.has(entry.options.key) ? [entry.options.key] : []);
 				const previous = this.store.getSnapshot();
-				if (previous.loaded === this.loaded && previous.namespaces.length === namespaces.length && previous.namespaces.every((ns, index) => ns === namespaces[index])) return;
+				if (previous.loaded === loaded && previous.namespaces.length === namespaces.length && previous.namespaces.every((ns, index) => ns === namespaces[index])) return;
 				this.store.set({
-					loaded: this.loaded,
+					loaded,
 					namespaces
 				});
 			}
@@ -1251,23 +1235,16 @@ window.__ModuleLoader__.load({
 			const bash = new BashCardController(ctx.settingsScope.bind({ namespace: SHELL_NS }));
 			const agentLoop = new AgentLoopCardController(ctx.settingsScope.bind({ namespace: AGENT_LOOP_NS }));
 			const webSearch = new WebSearchCardController(ctx.settingsScope.bind({ namespace: WEB_SEARCH_NS }), api);
-			ctx.effect(() => ctx.remote.$on("credentials/updated", (ref) => {
+			ctx.effect(() => ctx.remote.$on("credentials/reference-updated", (ref) => {
 				webSearch.refreshCredential(ref);
 			}), "ui-settings-plugins: credential invalidations");
-			const configurable = new ConfigurablePluginsTabController(api, () => ctx.slots.entries("settings.plugin.item"));
+			const configurable = new ConfigurablePluginsTabController(ctx.settingsScope.describe(), () => ctx.slots.entries("settings.plugin.item"));
 			ctx.effect(() => () => {
 				configurable.dispose();
 			}, "ui-settings-plugins: tab directory");
-			ctx.effect(() => ctx.remote.$on("settings/document-updated", () => {
-				configurable.load();
-			}), "ui-settings-plugins: served-namespace invalidations");
-			ctx.effect(() => ctx.on("connection/reset", () => {
-				configurable.load();
-			}), "ui-settings-plugins: served-namespace reconnect");
 			ctx.effect(() => ctx.slots.subscribe("settings.plugin.item", () => {
 				configurable.refresh();
 			}), "ui-settings-plugins: card ledger");
-			configurable.load();
 			let tabsVersion = -1;
 			let tabsRevision = -1;
 			let tabs = [];

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

@@ -37,17 +37,14 @@ export function apply(ctx) {
     // The credential a card reports is not part of any settings section, so its
     // scope publishes nothing when one is written. This is the only signal that
     // a key written on another surface reached the Host.
-    ctx.effect(() => ctx.remote.$on('credentials/updated', (ref) => { webSearch.refreshCredential(ref); }), 'ui-settings-plugins: credential invalidations');
-    // Which namespaces the Host serves is a registration fact the wire does not
-    // announce, so the directory re-reads on the two signals that can carry a
-    // changed composition: a settings document commit and a reconnect.
-    const configurable = new ConfigurablePluginsTabController(api, () => ctx.slots.entries('settings.plugin.item'));
+    ctx.effect(() => ctx.remote.$on('credentials/reference-updated', (ref) => { webSearch.refreshCredential(ref); }), 'ui-settings-plugins: credential invalidations');
+    // Which namespaces the Host serves comes from the shared describe mirror,
+    // whose owning plugin already refreshes it on document commits and
+    // reconnects — the tab only derives.
+    const configurable = new ConfigurablePluginsTabController(ctx.settingsScope.describe(), () => ctx.slots.entries('settings.plugin.item'));
     ctx.effect(() => () => { configurable.dispose(); }, 'ui-settings-plugins: tab directory');
-    ctx.effect(() => ctx.remote.$on('settings/document-updated', () => { void configurable.load(); }), 'ui-settings-plugins: served-namespace invalidations');
-    ctx.effect(() => ctx.on('connection/reset', () => { void configurable.load(); }), 'ui-settings-plugins: served-namespace reconnect');
     // A card registered after the first read joins the list without a wire call.
     ctx.effect(() => ctx.slots.subscribe('settings.plugin.item', () => { configurable.refresh(); }), 'ui-settings-plugins: card ledger');
-    void configurable.load();
     let tabsVersion = -1;
     let tabsRevision = -1;
     let tabs = [];

package/dist/kernel/client-ui-settings-plugins/lib/types/client/tab-store.d.ts

@@ -9,7 +9,7 @@
  * is never dispatched, so a plugin this deployment did not compose leaves no
  * trace and does not count toward the empty line.
  */
-import type { IApiClient } from '../../../../client-connection/lib/client.js';
+import type { SettingsDescribeFace } from '../../../../client-ui-settings/lib/client.js';
 import type { StoredEntry } from '../../../../client-ui-slots/lib/index.js';
 import { type SnapshotStore } from '../../../../client-runtime/lib/client.js';
 /** What the section renders. */
@@ -38,31 +38,22 @@ export interface ConfigurablePluginsTabFace {
         configurablePlugins: SnapshotStore<ConfigurablePluginsTabState>;
     };
 }
-/** Reads the served namespaces and pairs them with the cards that claim them. */
+/** Derives the served namespaces from the shared describe mirror and pairs them with the cards that claim them. */
 export declare class ConfigurablePluginsTabController {
-    private readonly api;
+    private readonly describeFace;
     private readonly entries;
     private readonly store;
-    /** Last Host answer; kept so a slot mutation republishes without a wire read. */
-    private served;
-    private loaded;
-    private generation;
     private disposed;
+    private readonly unsubscribe;
     /**
-     * @param api - settings wire face.
+     * @param describeFace - the shared mirror's describe face; its refreshes
+     * (document commits, reconnects) are what keep the served set current.
      * @param entries - reads the cards currently registered into the section's slot.
      */
-    constructor(api: Pick<IApiClient, 'settings'>, entries: () => readonly StoredEntry[]);
-    /** Opaque read of {@link disposed}: control flow cannot narrow it across awaits. */
-    private isDisposed;
-    /**
-     * Re-read the served namespaces from the Host and republish.
-     * @returns settlement after the read, or immediately once disposed.
-     */
-    load(): Promise<void>;
+    constructor(describeFace: SettingsDescribeFace, entries: () => readonly StoredEntry[]);
     /** Republish after the slot ledger changed; a card registered late joins here. */
     refresh(): void;
-    /** Stop publishing; an in-flight read settles without touching the store. */
+    /** Stop publishing and stop following the mirror. */
     dispose(): void;
     /**
      * Build the face the tab's slot registration injects.

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

@@ -10,49 +10,23 @@
  * trace and does not count toward the empty line.
  */
 import { createSnapshotStore } from '../../../../client-runtime/lib/client.js';
-/** Reads the served namespaces and pairs them with the cards that claim them. */
+/** Derives the served namespaces from the shared describe mirror and pairs them with the cards that claim them. */
 export class ConfigurablePluginsTabController {
-    api;
+    describeFace;
     entries;
     store = createSnapshotStore({ loaded: false, namespaces: [] });
-    /** Last Host answer; kept so a slot mutation republishes without a wire read. */
-    served = [];
-    loaded = false;
-    generation = 0;
     disposed = false;
+    unsubscribe;
     /**
-     * @param api - settings wire face.
+     * @param describeFace - the shared mirror's describe face; its refreshes
+     * (document commits, reconnects) are what keep the served set current.
      * @param entries - reads the cards currently registered into the section's slot.
      */
-    constructor(api, entries) {
-        this.api = api;
+    constructor(describeFace, entries) {
+        this.describeFace = describeFace;
         this.entries = entries;
-    }
-    /** Opaque read of {@link disposed}: control flow cannot narrow it across awaits. */
-    isDisposed() {
-        return this.disposed;
-    }
-    /**
-     * Re-read the served namespaces from the Host and republish.
-     * @returns settlement after the read, or immediately once disposed.
-     */
-    async load() {
-        if (this.isDisposed())
-            return;
-        const generation = ++this.generation;
-        let response;
-        try {
-            response = await this.api.settings.describe({});
-        }
-        catch (_settingsReadFailure) {
-            // The tab keeps the namespaces it last knew; the next invalidation
-            // or reconnect reads again.
-            return;
-        }
-        if (this.isDisposed() || generation !== this.generation || !response.result.ok)
-            return;
-        this.served = response.result.value.namespaces.map(view => view.ns);
-        this.loaded = true;
+        this.unsubscribe = describeFace.subscribe(() => { this.publish(); });
+        void describeFace.ensure();
         this.publish();
     }
     /** Republish after the slot ledger changed; a card registered late joins here. */
@@ -61,10 +35,10 @@ export class ConfigurablePluginsTabController {
             return;
         this.publish();
     }
-    /** Stop publishing; an in-flight read settles without touching the store. */
+    /** Stop publishing and stop following the mirror. */
     dispose() {
         this.disposed = true;
-        this.generation += 1;
+        this.unsubscribe();
     }
     /**
      * Build the face the tab's slot registration injects.
@@ -74,18 +48,22 @@ export class ConfigurablePluginsTabController {
         return { hooks: { configurablePlugins: this.store } };
     }
     publish() {
-        const served = new Set(this.served);
+        if (this.disposed)
+            return;
+        const mirrored = this.describeFace.getSnapshot();
+        const loaded = mirrored.view !== undefined;
+        const served = new Set(mirrored.view?.namespaces.map(view => view.ns) ?? []);
         const namespaces = this.entries().flatMap(entry => entry.options.key !== undefined && served.has(entry.options.key) ? [entry.options.key] : []);
         const previous = this.store.getSnapshot();
-        // Every settings-document commit re-reads, and most of them change nothing
-        // this section shows. An observable source must keep its snapshot
-        // reference until the fact moves, or each unrelated save re-renders the
-        // whole card list (packages/client/AGENTS.md reactive rule 5).
-        if (previous.loaded === this.loaded
+        // Every settings-document commit refreshes the mirror, and most commits
+        // change nothing this section shows. An observable source must keep its
+        // snapshot reference until the fact moves, or each unrelated save
+        // re-renders the whole card list (packages/client/AGENTS.md reactive rule 5).
+        if (previous.loaded === loaded
             && previous.namespaces.length === namespaces.length
             && previous.namespaces.every((ns, index) => ns === namespaces[index]))
             return;
-        this.store.set({ loaded: this.loaded, namespaces });
+        this.store.set({ loaded, namespaces });
     }
 }
 //# sourceMappingURL=tab-store.js.map

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

@@ -2,7 +2,7 @@
  * Package-owned invariant companion for `@nomix-ai/nomix-client-ui-settings-plugins`.
  * @module @nomix-ai/nomix-client-ui-settings-plugins/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-plugins-invariant";
 /** Service required before the companion can reserve package ownership. */

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

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-client-ui-settings-plugins",
   "description": "Plugins settings section with feature-owned tabs and configurable host-plane plugin cards",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -52,12 +52,8 @@
     "@nomix-ai/nomix-client-connection": "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-client-web-react": "workspace:^",
-    "@nomix-ai/nomix-invariants": "workspace:^",
-    "react": "^18.2.0"
+    "@nomix-ai/nomix-invariants": "workspace:^"
   },
   "devDependencies": {
     "@nomix-ai/cordis": "workspace:^",
@@ -69,7 +65,6 @@
     "@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",
     "react": "^18.2.0"

package/dist/kernel/client-ui-sidebar/lib/client.js

@@ -23,7 +23,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0nomix-css:/home/runner/work/nomix-harness/nomix-harness/packages/client/ui-sidebar/src/client/SidebarRoot.module.css.mjs
-		const css = ".hzacJG_root{--nomix-sidebar-inline-padding:12px;height:100%;padding:6px var(--nomix-sidebar-inline-padding);box-sizing:border-box;background:var(--dsw-specific-sidebar-fill);color:var(--dsw-alias-label-primary);--nomix-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--nomix-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);flex-direction:column;font-size:14px;display:flex}.hzacJG_root.hzacJG_collapsed{padding:18px 10px 6px}.hzacJG_root.hzacJG_quietBars{--nomix-scrollbar-thumb:transparent;--nomix-scrollbar-thumb-hover:transparent}.hzacJG_fading>*{opacity:0;transition:opacity .15s var(--ds-ease-in-out)}.hzacJG_wide{animation:hzacJG_wide-in .2s var(--ds-ease-in-out)}@keyframes hzacJG_wide-in{0%{opacity:0}}.hzacJG_railIn .hzacJG_iconButton,.hzacJG_railIn .hzacJG_newSession,.hzacJG_railIn .hzacJG_regionArea{animation:hzacJG_rail-in .15s var(--ds-ease-in-out) backwards}.hzacJG_railIn .hzacJG_footArea{animation:hzacJG_rail-fade-in .15s var(--ds-ease-in-out) backwards}@keyframes hzacJG_rail-in{0%{opacity:0;transform:translate(49px)}}@keyframes hzacJG_rail-fade-in{0%{opacity:0}}.hzacJG_logoRow{box-sizing:border-box;flex:none;justify-content:flex-end;align-items:center;gap:8px;height:60px;margin-bottom:8px;padding:8px 0 8px 4px;display:flex;overflow:hidden}.hzacJG_collapsed .hzacJG_logoRow{justify-content:flex-start;height:36px;margin-bottom:12px;padding:0}.hzacJG_brand{min-width:0;color:inherit;cursor:pointer;background:0 0;border:none;flex:1;align-items:center;padding:0;display:inline-flex;overflow:hidden}.hzacJG_iconButton{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-secondary);background:0 0;border:none;border-radius:50%;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.hzacJG_iconButton:hover{background:var(--dsw-alias-interactive-bg-hover)}.hzacJG_collapsed .hzacJG_iconButton{width:36px;height:36px}.hzacJG_collapsed .hzacJG_toggle .hzacJG_panelIcon{display:none}.hzacJG_collapsed .hzacJG_toggle:hover .hzacJG_panelIcon{display:inline}.hzacJG_collapsed .hzacJG_toggle:hover .hzacJG_railLogo{display:none}.hzacJG_collapsed .hzacJG_iconButton{color:var(--dsw-alias-label-primary)}.hzacJG_newSession{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-button-elevated-fill);height:38px;color:var(--dsw-alias-label-primary);cursor:pointer;border-radius:12px;flex:none;justify-content:center;align-items:center;gap:6px;margin:0 2px 8px;padding:8px 16px;font-size:14px;font-weight:500;line-height:22px;display:flex;overflow:hidden}.hzacJG_newSession:hover{background:var(--dsw-alias-button-floating-hover)}.hzacJG_collapsed .hzacJG_newSession{background:0 0;border-color:#0000;align-self:flex-start;gap:0;width:36px;height:36px;margin:0 0 12px;padding:0}.hzacJG_collapsed .hzacJG_newSession:hover{background:var(--dsw-alias-interactive-bg-hover)}.hzacJG_newSessionLabel{white-space:nowrap;max-width:200px;overflow:hidden}.hzacJG_collapsed .hzacJG_newSessionLabel{max-width:0}.hzacJG_regionArea{min-height:0;margin-left:-4px;margin-right:calc(-1 * var(--nomix-sidebar-inline-padding));flex-direction:column;flex:1;padding-left:4px;display:flex;overflow:hidden}.hzacJG_collapsed .hzacJG_regionArea{margin-left:0;margin-right:0;padding-left:0}.hzacJG_footArea{flex-direction:column;flex:none;display:flex}.hzacJG_settingsArea,.hzacJG_footerActions{flex:none;width:100%;min-width:0}.hzacJG_footerActions{display:flex}.hzacJG_collapsed .hzacJG_footArea{align-items:center}.hzacJG_collapsed .hzacJG_settingsArea,.hzacJG_collapsed .hzacJG_footerActions{justify-content:center;width:auto;display:flex}@media (prefers-reduced-motion:reduce){.hzacJG_wide,.hzacJG_fading>*,.hzacJG_railIn .hzacJG_iconButton,.hzacJG_railIn .hzacJG_newSession,.hzacJG_railIn .hzacJG_footArea,.hzacJG_railIn .hzacJG_regionArea{transition:none;animation:none}}";
+		const css = ".hzacJG_root{--nomix-sidebar-inline-padding:12px;height:100%;padding:6px var(--nomix-sidebar-inline-padding);box-sizing:border-box;background:var(--dsw-specific-sidebar-fill);color:var(--dsw-alias-label-primary);--nomix-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--nomix-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);flex-direction:column;font-size:14px;display:flex}.hzacJG_root.hzacJG_collapsed{padding:18px 10px 6px}.hzacJG_root.hzacJG_quietBars{--nomix-scrollbar-thumb:transparent;--nomix-scrollbar-thumb-hover:transparent}.hzacJG_fading>*{opacity:0;transition:opacity .15s var(--ds-ease-in-out)}.hzacJG_wide{animation:hzacJG_wide-in .2s var(--ds-ease-in-out)}@keyframes hzacJG_wide-in{0%{opacity:0}}.hzacJG_railIn .hzacJG_iconButton,.hzacJG_railIn .hzacJG_newSession,.hzacJG_railIn .hzacJG_regionArea{animation:hzacJG_rail-in .15s var(--ds-ease-in-out) backwards}.hzacJG_railIn .hzacJG_footArea{animation:hzacJG_rail-fade-in .15s var(--ds-ease-in-out) backwards}@keyframes hzacJG_rail-in{0%{opacity:0;transform:translate(49px)}}@keyframes hzacJG_rail-fade-in{0%{opacity:0}}.hzacJG_logoRow{box-sizing:border-box;flex:none;justify-content:flex-end;align-items:center;gap:8px;height:60px;margin-bottom:8px;padding:8px 0 8px 4px;display:flex;overflow:hidden}.hzacJG_collapsed .hzacJG_logoRow{justify-content:flex-start;height:36px;margin-bottom:12px;padding:0}.hzacJG_brand{min-width:0;color:inherit;cursor:pointer;background:0 0;border:none;flex:1;align-items:center;padding:0;display:inline-flex;overflow:hidden}.hzacJG_brandIdentity{align-items:center;gap:8px;min-width:0;height:24px;display:inline-flex}.hzacJG_brandMark{flex:none;justify-content:center;align-items:center;display:inline-flex}.hzacJG_brandName{letter-spacing:.04em;align-items:center;gap:6px;min-width:0;height:24px;font-size:18px;font-weight:600;line-height:24px;display:inline-flex}.hzacJG_fallbackBrandName{letter-spacing:0;white-space:nowrap;font-size:17px}.hzacJG_iconButton{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-secondary);background:0 0;border:none;border-radius:50%;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.hzacJG_iconButton:hover{background:var(--dsw-alias-interactive-bg-hover)}.hzacJG_collapsed .hzacJG_iconButton{width:36px;height:36px}.hzacJG_collapsed .hzacJG_toggle .hzacJG_panelIcon{display:none}.hzacJG_collapsed .hzacJG_toggle:hover .hzacJG_panelIcon{display:inline}.hzacJG_collapsed .hzacJG_toggle:hover .hzacJG_railMark{display:none}.hzacJG_railMark{justify-content:center;align-items:center;display:inline-flex}.hzacJG_collapsed .hzacJG_iconButton{color:var(--dsw-alias-label-primary)}.hzacJG_buildRevision{height:16px;color:var(--dsw-alias-label-primary-inverted);background:var(--dsw-alias-label-primary);font-family:var(--ds-font-family-code);border-radius:3px;align-items:center;padding:0 4px;font-size:8px;font-weight:500;line-height:16px;display:inline-flex}.hzacJG_newSession{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-button-elevated-fill);height:38px;color:var(--dsw-alias-label-primary);cursor:pointer;border-radius:12px;flex:none;justify-content:center;align-items:center;gap:6px;margin:0 2px 8px;padding:8px 16px;font-size:14px;font-weight:500;line-height:22px;display:flex;overflow:hidden}.hzacJG_newSession:hover{background:var(--dsw-alias-button-floating-hover)}.hzacJG_collapsed .hzacJG_newSession{background:0 0;border-color:#0000;align-self:flex-start;gap:0;width:36px;height:36px;margin:0 0 12px;padding:0}.hzacJG_collapsed .hzacJG_newSession:hover{background:var(--dsw-alias-interactive-bg-hover)}.hzacJG_newSessionLabel{white-space:nowrap;max-width:200px;overflow:hidden}.hzacJG_collapsed .hzacJG_newSessionLabel{max-width:0}.hzacJG_regionArea{min-height:0;margin-left:-4px;margin-right:calc(-1 * var(--nomix-sidebar-inline-padding));flex-direction:column;flex:1;padding-left:4px;display:flex;overflow:hidden}.hzacJG_collapsed .hzacJG_regionArea{margin-left:0;margin-right:0;padding-left:0}.hzacJG_footArea{flex-direction:column;flex:none;display:flex}.hzacJG_settingsArea,.hzacJG_footerActions{flex:none;width:100%;min-width:0}.hzacJG_footerActions{display:flex}.hzacJG_collapsed .hzacJG_footArea{align-items:center}.hzacJG_collapsed .hzacJG_settingsArea,.hzacJG_collapsed .hzacJG_footerActions{justify-content:center;width:auto;display:flex}@media (prefers-reduced-motion:reduce){.hzacJG_wide,.hzacJG_fading>*,.hzacJG_railIn .hzacJG_iconButton,.hzacJG_railIn .hzacJG_newSession,.hzacJG_railIn .hzacJG_footArea,.hzacJG_railIn .hzacJG_regionArea{transition:none;animation:none}}";
 		const tagId = "@nomix-ai/nomix-client-ui-sidebar/SidebarRoot.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -33,27 +33,32 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var SidebarRoot_module_css_default = {
-			"newSessionLabel": "hzacJG_newSessionLabel",
-			"rail-fade-in": "hzacJG_rail-fade-in",
+			"brand": "hzacJG_brand",
+			"brandIdentity": "hzacJG_brandIdentity",
+			"brandMark": "hzacJG_brandMark",
+			"brandName": "hzacJG_brandName",
+			"buildRevision": "hzacJG_buildRevision",
+			"collapsed": "hzacJG_collapsed",
+			"fading": "hzacJG_fading",
+			"fallbackBrandName": "hzacJG_fallbackBrandName",
 			"footArea": "hzacJG_footArea",
 			"footerActions": "hzacJG_footerActions",
+			"iconButton": "hzacJG_iconButton",
+			"logoRow": "hzacJG_logoRow",
+			"newSession": "hzacJG_newSession",
+			"newSessionLabel": "hzacJG_newSessionLabel",
 			"panelIcon": "hzacJG_panelIcon",
-			"railIn": "hzacJG_railIn",
-			"wide-in": "hzacJG_wide-in",
-			"brand": "hzacJG_brand",
-			"toggle": "hzacJG_toggle",
-			"railLogo": "hzacJG_railLogo",
-			"wide": "hzacJG_wide",
-			"collapsed": "hzacJG_collapsed",
 			"quietBars": "hzacJG_quietBars",
-			"newSession": "hzacJG_newSession",
+			"rail-fade-in": "hzacJG_rail-fade-in",
+			"rail-in": "hzacJG_rail-in",
+			"railIn": "hzacJG_railIn",
+			"railMark": "hzacJG_railMark",
 			"regionArea": "hzacJG_regionArea",
-			"iconButton": "hzacJG_iconButton",
-			"settingsArea": "hzacJG_settingsArea",
 			"root": "hzacJG_root",
-			"rail-in": "hzacJG_rail-in",
-			"fading": "hzacJG_fading",
-			"logoRow": "hzacJG_logoRow"
+			"settingsArea": "hzacJG_settingsArea",
+			"toggle": "hzacJG_toggle",
+			"wide": "hzacJG_wide",
+			"wide-in": "hzacJG_wide-in"
 		};
 		//#endregion
 		//#region lib/types/client/SidebarRoot.js
@@ -157,7 +162,23 @@ window.__ModuleLoader__.load({
 							onClick: () => {
 								startSession();
 							},
-							children: (0, react_jsx_runtime.jsx)(_nomix_ai_nomix_client_ui_primitives.BrandWordmark, {})
+							children: (0, react_jsx_runtime.jsxs)("span", {
+								className: SidebarRoot_module_css_default.brandIdentity,
+								"aria-hidden": "true",
+								children: [(0, react_jsx_runtime.jsx)("span", {
+									className: SidebarRoot_module_css_default.brandMark,
+									children: renderSlot("sidebar.brand.mark", { size: 24 }, { fallback: (0, react_jsx_runtime.jsx)(_nomix_ai_nomix_client_ui_primitives.NomixLogo, { size: 24 }) })
+								}), (0, react_jsx_runtime.jsx)("span", {
+									className: SidebarRoot_module_css_default.brandName,
+									children: renderSlot("sidebar.brand.name", {}, { fallback: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)("span", {
+										className: SidebarRoot_module_css_default.fallbackBrandName,
+										children: "NOMIX Local Build"
+									}), (0, react_jsx_runtime.jsx)("span", {
+										className: SidebarRoot_module_css_default.buildRevision,
+										children: "a47e02d"
+									})] }) })
+								})]
+							})
 						}), (0, react_jsx_runtime.jsx)(_nomix_ai_nomix_client_ui_primitives.Tooltip, {
 							label: collapsed ? t("toggle.open") : t("toggle.collapse"),
 							delayMs: 500,
@@ -168,9 +189,10 @@ window.__ModuleLoader__.load({
 								onClick: () => {
 									toggleSidebar();
 								},
-								children: [!wide && (0, react_jsx_runtime.jsx)(_nomix_ai_nomix_client_ui_primitives.NomixLogo, {
-									className: SidebarRoot_module_css_default.railLogo,
-									size: 24
+								children: [!wide && (0, react_jsx_runtime.jsx)("span", {
+									className: SidebarRoot_module_css_default.railMark,
+									"aria-hidden": "true",
+									children: renderSlot("sidebar.brand.mark", { size: 24 }, { fallback: (0, react_jsx_runtime.jsx)(_nomix_ai_nomix_client_ui_primitives.NomixLogo, { size: 24 }) })
 								}), (0, react_jsx_runtime.jsx)(_nomix_ai_nomix_client_ui_primitives.IconPanelLeftOutline16, {
 									className: SidebarRoot_module_css_default.panelIcon,
 									size: wide ? 16 : 18
@@ -266,6 +288,14 @@ window.__ModuleLoader__.load({
 				name: "sidebar",
 				locale: NS,
 				children: {
+					"sidebar.brand.mark": {
+						kind: "single",
+						scope: "root"
+					},
+					"sidebar.brand.name": {
+						kind: "single",
+						scope: "root"
+					},
 					"sidebar.workspaces": {
 						kind: "single",
 						scope: "root"

package/dist/kernel/client-ui-sidebar/lib/types/client/SidebarRoot.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * Sidebar shell: column geometry only. Collapse is a slide plus crossfade:
  * content freezes at its expanded width (inline style) and fades out in place
@@ -18,7 +18,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { useEffect, useRef, useState } from 'react';
 import clsx from 'clsx';
-import { BrandWordmark, NomixLogo, IconNewChatOutline16, IconPanelLeftOutline16, Tooltip, } from '../../../../client-ui-primitives/lib/index.js';
+import { IconNewChatOutline16, IconPanelLeftOutline16, NomixLogo, Tooltip, } from '../../../../client-ui-primitives/lib/index.js';
 import css from './SidebarRoot.module.css';
 /** Wide-content unmount delay; matches the 150ms wide-content fade-out. */
 const COLLAPSE_SETTLE_MS = 150;
@@ -108,7 +108,11 @@ export function SidebarRoot({ collapsed, width, startSession, toggleSidebar, t,
     return (_jsxs("div", { ref: column, className: clsx(css.root, !wide && css.collapsed, !wide && everWide.current && css.railIn, collapsed && wide && css.fading, !pointerInside && css.quietBars), style: wide ? { width: collapsed ? lastWideWidth.current : width } : undefined, onPointerEnter: () => {
             cancelLinger();
             setPointerInside(true);
-        }, onPointerLeave: () => { armLinger(); }, children: [_jsxs("div", { className: css.logoRow, children: [wide && (_jsx("button", { type: "button", className: clsx(css.brand, css.wide), "aria-label": t('session.new.label'), onClick: () => { startSession(); }, children: _jsx(BrandWordmark, {}) })), _jsx(Tooltip, { label: collapsed ? t('toggle.open') : t('toggle.collapse'), delayMs: 500, children: _jsxs("button", { type: "button", className: clsx(css.iconButton, css.toggle), "aria-label": collapsed ? t('toggle.open') : t('toggle.collapse'), onClick: () => { toggleSidebar(); }, children: [!wide && _jsx(NomixLogo, { className: css.railLogo, size: 24 }), _jsx(IconPanelLeftOutline16, { className: css.panelIcon, size: wide ? 16 : 18 })] }) })] }), _jsx(Tooltip, { label: t('session.new.label'), delayMs: 500, disabled: wide, children: _jsxs("button", { type: "button", className: css.newSession, "aria-label": t('session.new.label'), onClick: () => { startSession(); }, children: [_jsx(IconNewChatOutline16, { size: wide ? 14 : 18 }), wide && _jsx("span", { className: clsx(css.newSessionLabel, css.wide), children: t('session.new') })] }) }), _jsx("div", { className: css.regionArea, children: renderSlot('sidebar.workspaces', {
+        }, onPointerLeave: () => { armLinger(); }, children: [_jsxs("div", { className: css.logoRow, children: [wide && (_jsx("button", { type: "button", className: clsx(css.brand, css.wide), "aria-label": t('session.new.label'), onClick: () => { startSession(); }, children: _jsxs("span", { className: css.brandIdentity, "aria-hidden": "true", children: [_jsx("span", { className: css.brandMark, children: renderSlot('sidebar.brand.mark', { size: 24 }, { fallback: _jsx(NomixLogo, { size: 24 }) }) }), _jsx("span", { className: css.brandName, children: renderSlot('sidebar.brand.name', {}, {
+                                        fallback: (_jsxs(_Fragment, { children: [_jsx("span", { className: css.fallbackBrandName, children: "NOMIX Local Build" }), process.env.NOMIX_CLIENT_COMMIT_HASH
+                                                    ? _jsx("span", { className: css.buildRevision, children: process.env.NOMIX_CLIENT_COMMIT_HASH })
+                                                    : null] })),
+                                    }) })] }) })), _jsx(Tooltip, { label: collapsed ? t('toggle.open') : t('toggle.collapse'), delayMs: 500, children: _jsxs("button", { type: "button", className: clsx(css.iconButton, css.toggle), "aria-label": collapsed ? t('toggle.open') : t('toggle.collapse'), onClick: () => { toggleSidebar(); }, children: [!wide && (_jsx("span", { className: css.railMark, "aria-hidden": "true", children: renderSlot('sidebar.brand.mark', { size: 24 }, { fallback: _jsx(NomixLogo, { size: 24 }) }) })), _jsx(IconPanelLeftOutline16, { className: css.panelIcon, size: wide ? 16 : 18 })] }) })] }), _jsx(Tooltip, { label: t('session.new.label'), delayMs: 500, disabled: wide, children: _jsxs("button", { type: "button", className: css.newSession, "aria-label": t('session.new.label'), onClick: () => { startSession(); }, children: [_jsx(IconNewChatOutline16, { size: wide ? 14 : 18 }), wide && _jsx("span", { className: clsx(css.newSessionLabel, css.wide), children: t('session.new') })] }) }), _jsx("div", { className: css.regionArea, children: renderSlot('sidebar.workspaces', {
                     wide,
                     expandSidebar: () => { if (collapsed)
                         toggleSidebar(); },

package/dist/kernel/client-ui-sidebar/lib/types/client/contract/slots.d.ts

@@ -11,6 +11,25 @@ import type { PropsLocale, PropsRenderSlots, PropsRuntime } from '../../../../..
 import type { WorkspaceId } from '../../../../../client-runtime/lib/client.js';
 declare module '@nomix-ai/nomix-client-ui-slots' {
     interface SlotMap {
+        /**
+         * Brand mark rendered in the expanded brand row and collapsed rail.
+         * Declared by this package's `sidebar` entry; deployments may replace
+         * the shell's fish fallback without replacing the surrounding controls.
+         */
+        'sidebar.brand.mark': {
+            kind: 'single';
+            scope: 'root';
+            owner: SidebarBrandMarkOwnerProps;
+        };
+        /**
+         * Brand name rendered beside the expanded mark. Declared by this
+         * package's `sidebar` entry; the shell supplies a generic text fallback.
+         */
+        'sidebar.brand.name': {
+            kind: 'single';
+            scope: 'root';
+            owner: SidebarBrandNameOwnerProps;
+        };
         /**
          * The workspace/session browsing region: section header, search, the
          * grouped/flat session list, and every workspace dialog. Declared by this
@@ -43,6 +62,16 @@ declare module '@nomix-ai/nomix-client-ui-slots' {
         };
     }
 }
+/** Geometry supplied to the sidebar brand-mark occupant. */
+export interface SidebarBrandMarkOwnerProps {
+    /** Requested square edge in pixels. */
+    size: number;
+}
+/** Empty owner share for the sidebar brand-name occupant. */
+export interface SidebarBrandNameOwnerProps {
+    /** Marker field: the occupant owns its own content and width. */
+    children?: never;
+}
 /**
  * Owner share of the browser hole — the only facts crossing the shell/region
  * boundary. Business data and actions arrive through the region's own inject.
@@ -86,5 +115,5 @@ export type SidebarRootInjected = {
  * render shares, this package's injected callbacks, and the standard locale
  * seat. No store is registered.
  */
-export type SidebarRootComponentProps = PropsRuntime<'sidebar'> & PropsRenderSlots<'sidebar.workspaces' | 'sidebar.settings' | 'sidebar.footer.action'> & SidebarRootInjected & PropsLocale<'sidebar'>;
+export type SidebarRootComponentProps = PropsRuntime<'sidebar'> & PropsRenderSlots<'sidebar.brand.mark' | 'sidebar.brand.name' | 'sidebar.workspaces' | 'sidebar.settings' | 'sidebar.footer.action'> & SidebarRootInjected & PropsLocale<'sidebar'>;
 //# sourceMappingURL=slots.d.ts.map

package/dist/kernel/client-ui-sidebar/lib/types/client/index.d.ts

@@ -1,7 +1,7 @@
 /** Registers the sidebar shell into the layout-owned slot. */
 import type { ClientContext } from '../../../../client-runtime/lib/client.js';
 import { type SidebarKey } from './locales.ts';
-export type { SidebarFooterActionOwnerProps, SidebarRootComponentProps, SidebarRootInjected, SidebarSectionOwnerProps, SidebarSettingsOwnerProps, } from './contract/slots.ts';
+export type { SidebarBrandMarkOwnerProps, SidebarBrandNameOwnerProps, SidebarFooterActionOwnerProps, SidebarRootComponentProps, SidebarRootInjected, SidebarSectionOwnerProps, SidebarSettingsOwnerProps, } from './contract/slots.ts';
 export type { SidebarKey } from './locales.ts';
 declare module '@nomix-ai/nomix-client-ui-slots' {
     interface LocaleNamespaceMap {

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

@@ -22,6 +22,8 @@ export function apply(ctx) {
         // region (header, search, session list, workspace dialogs), ui-settings
         // registers the foot trigger + settings panel.
         children: {
+            'sidebar.brand.mark': { kind: 'single', scope: 'root' },
+            'sidebar.brand.name': { kind: 'single', scope: 'root' },
             'sidebar.workspaces': { kind: 'single', scope: 'root' },
             'sidebar.settings': { kind: 'single', scope: 'root' },
             'sidebar.footer.action': { kind: 'list', scope: 'root' },