@xrkseek/harness-cli 0.0.5 → 0.0.7

package/node_modules/@xrkseek/session-projection/dist/index.js

@@ -0,0 +1,241 @@
+/**
+ * Session-projection seam: drive registry + dual type tables.
+ * No Cordis — Host Face (or any carrier) owns wiring; domains register pure units.
+ */
+function eraseDefinition(definition) {
+    const wire = definition.wire;
+    if (wire) {
+        return {
+            key: definition.key,
+            stateVersion: definition.stateVersion,
+            wired: true,
+            init: () => definition.init(),
+            apply: (state, event) => definition.apply(state, event),
+            view: (state) => wire.view(state),
+            parse: (value) => wire.parse(value),
+        };
+    }
+    return {
+        key: definition.key,
+        stateVersion: definition.stateVersion,
+        wired: false,
+        init: () => definition.init(),
+        apply: (state, event) => definition.apply(state, event),
+        view: () => {
+            throw new Error(`projection ${JSON.stringify(definition.key)} is host-only (no wire)`);
+        },
+        parse: () => {
+            throw new Error(`projection ${JSON.stringify(definition.key)} is host-only (no wire)`);
+        },
+    };
+}
+export function createSessionProjectionRegistry(options) {
+    const registrations = new Map();
+    const listeners = new Set();
+    const sidecars = new Map();
+    function buildCell(def, events) {
+        let state = def.init();
+        for (const event of events)
+            state = def.apply(state, event);
+        return {
+            state,
+            observedSeq: events.length === 0 ? -1 : events.length,
+        };
+    }
+    function cellFor(registration, sessionId) {
+        let cell = registration.cells.get(sessionId);
+        if (cell === undefined) {
+            cell = buildCell(registration.def, options.getEvents(sessionId));
+            registration.cells.set(sessionId, cell);
+        }
+        return cell;
+    }
+    return {
+        register(definition) {
+            if (!Number.isSafeInteger(definition.stateVersion) ||
+                definition.stateVersion < 0) {
+                throw new Error(`projection ${JSON.stringify(definition.key)} stateVersion must be a non-negative integer`);
+            }
+            const key = definition.key;
+            const existing = registrations.get(key);
+            if (existing === undefined) {
+                registrations.set(key, {
+                    def: eraseDefinition(definition),
+                    cells: new Map(),
+                    refs: 1,
+                });
+            }
+            else {
+                if (existing.def.stateVersion !== definition.stateVersion) {
+                    throw new Error(`projection key ${JSON.stringify(key)} already registered at stateVersion ${existing.def.stateVersion}; refusing ${definition.stateVersion}`);
+                }
+                existing.refs += 1;
+            }
+            let alive = true;
+            return () => {
+                if (!alive)
+                    return;
+                alive = false;
+                const live = registrations.get(key);
+                if (live === undefined)
+                    return;
+                live.refs -= 1;
+                if (live.refs === 0)
+                    registrations.delete(key);
+            };
+        },
+        onChanged(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        drive(sessionId, event, seq) {
+            for (const registration of registrations.values()) {
+                let cell = registration.cells.get(sessionId);
+                if (cell === undefined) {
+                    const all = options.getEvents(sessionId);
+                    const prefix = all.slice(0, seq - 1);
+                    cell = buildCell(registration.def, prefix);
+                    registration.cells.set(sessionId, cell);
+                }
+                const next = registration.def.apply(cell.state, event);
+                const changed = !Object.is(next, cell.state);
+                cell.state = next;
+                cell.observedSeq = seq;
+                if (changed && registration.def.wired && listeners.size > 0) {
+                    const value = registration.def.parse(registration.def.view(next));
+                    for (const listener of listeners) {
+                        listener(sessionId, registration.def.key, value, seq);
+                    }
+                }
+            }
+        },
+        snapshot(sessionId) {
+            const events = options.getEvents(sessionId);
+            const values = {};
+            for (const registration of registrations.values()) {
+                if (!registration.def.wired)
+                    continue;
+                const cell = cellFor(registration, sessionId);
+                values[registration.def.key] = registration.def.parse(registration.def.view(cell.state));
+            }
+            const extra = sidecars.get(sessionId);
+            if (extra) {
+                for (const [key, value] of extra)
+                    values[key] = value;
+            }
+            const asOfSeq = events.length === 0 ? -1 : events.length;
+            return { asOfSeq, values };
+        },
+        stateOf(sessionId, key) {
+            const registration = registrations.get(key);
+            if (registration === undefined)
+                return undefined;
+            return cellFor(registration, sessionId).state;
+        },
+        restoreFloor(checkpoint) {
+            let floor;
+            for (const registration of registrations.values()) {
+                const row = checkpoint[registration.def.key];
+                const need = row !== undefined && row.ver === registration.def.stateVersion
+                    ? Math.max(row.seq + 1, 0)
+                    : 0;
+                floor = floor === undefined ? need : Math.min(floor, need);
+            }
+            return floor === undefined ? undefined : Math.max(floor - 1, 0);
+        },
+        viewCheckpoint(checkpoint) {
+            const values = {};
+            for (const registration of registrations.values()) {
+                const def = registration.def;
+                if (!def.wired)
+                    continue;
+                const row = checkpoint[def.key];
+                if (row === undefined || row.ver !== def.stateVersion)
+                    continue;
+                try {
+                    values[def.key] = def.parse(def.view(row.val));
+                }
+                catch {
+                    // malformed row → omit key (cold consumer refolds)
+                }
+            }
+            return values;
+        },
+        restore(checkpoint, events, baseSeq) {
+            const endSeq = events.length === 0 ? baseSeq - 1 : baseSeq + events.length - 1;
+            const values = {};
+            const refreshed = {};
+            for (const registration of registrations.values()) {
+                const def = registration.def;
+                const row = checkpoint[def.key];
+                const usable = row !== undefined &&
+                    row.ver === def.stateVersion &&
+                    row.seq >= baseSeq - 1 &&
+                    row.seq <= endSeq;
+                if (!usable && baseSeq > 0) {
+                    throw new Error(`session projection ${JSON.stringify(def.key)} cannot restore from seq ${baseSeq}: ` +
+                        "its checkpoint row is missing, version-mismatched, or beyond the supplied log end; re-read from seq 0");
+                }
+                let state = usable ? row.val : def.init();
+                const from = usable ? row.seq : baseSeq - 1;
+                for (let i = 0; i < events.length; i++) {
+                    const seq = baseSeq + i;
+                    if (seq > from)
+                        state = def.apply(state, events[i]);
+                }
+                if (def.wired)
+                    values[def.key] = def.parse(def.view(state));
+                refreshed[def.key] = {
+                    ver: def.stateVersion,
+                    seq: endSeq,
+                    val: state,
+                };
+            }
+            return {
+                snapshot: { asOfSeq: endSeq, values },
+                checkpoint: refreshed,
+            };
+        },
+        checkpoint(sessionId) {
+            const rows = {};
+            for (const registration of registrations.values()) {
+                const cell = cellFor(registration, sessionId);
+                rows[registration.def.key] = {
+                    ver: registration.def.stateVersion,
+                    seq: cell.observedSeq,
+                    val: structuredClone(cell.state),
+                };
+            }
+            return rows;
+        },
+        keys() {
+            const extra = new Set();
+            for (const map of sidecars.values()) {
+                for (const k of map.keys())
+                    extra.add(k);
+            }
+            return [...new Set([...registrations.keys(), ...extra])];
+        },
+        setSidecar(sessionId, key, value, seq) {
+            let map = sidecars.get(sessionId);
+            if (value === undefined) {
+                map?.delete(key);
+                if (map && map.size === 0)
+                    sidecars.delete(sessionId);
+            }
+            else {
+                if (!map) {
+                    map = new Map();
+                    sidecars.set(sessionId, map);
+                }
+                map.set(key, value);
+            }
+            for (const listener of listeners) {
+                listener(sessionId, key, value ?? null, seq);
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/session-projection/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/session-projection/dist/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Merge-extensible projection type tables.
+ * Client carriers / stubs declare-merge {@link SessionProjectionMap}.
+ * Host fold packages declare-merge {@link SessionProjectionStateMap}.
+ *
+ * @module @xrkseek/session-projection/types
+ */
+/**
+ * Client-visible whole values (wire JSON). Rendering belongs to the slot /
+ * UI layer, never this seam.
+ */
+export interface SessionProjectionMap {
+}
+/**
+ * Host fold states. Every client-visible key also appears here; host-only
+ * keys appear only here. Values must be plain JSON if a cache is attached.
+ */
+export interface SessionProjectionStateMap {
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@xrkseek/session-projection/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,oBAAoB;CAAG;AAExC;;;GAGG;AACH,MAAM,WAAW,yBAAyB;CAAG"}

package/node_modules/@xrkseek/session-projection/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Merge-extensible projection type tables.
+ * Client carriers / stubs declare-merge {@link SessionProjectionMap}.
+ * Host fold packages declare-merge {@link SessionProjectionStateMap}.
+ *
+ * @module @xrkseek/session-projection/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@xrkseek/session-projection/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/node_modules/@xrkseek/session-projection/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@xrkseek/session-projection",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/protocol": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/session/session-projection"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/workspace/dist/skill-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-tools.d.ts","sourceRoot":"","sources":["../src/skill-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IACxD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAOA;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,kBAAkB,GAC1B,cAAc,EAAE,CAuClB"}
+{"version":3,"file":"skill-tools.d.ts","sourceRoot":"","sources":["../src/skill-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IACxD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAOA;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,kBAAkB,GAC1B,cAAc,EAAE,CAwClB"}

package/node_modules/@xrkseek/workspace/dist/skill-tools.js

@@ -43,6 +43,7 @@ export function createSkillTools(options) {
                 return { content: renderSkillContent(skill) };
             },
             presentCall: presentSkillCall,
+            isConcurrencySafe: () => true,
         },
     ];
 }

package/node_modules/@xrkseek/workspace/dist/skill-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-tools.js","sourceRoot":"","sources":["../src/skill-tools.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,SAAS,EACT,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,gBAAgB,CAAC,IAAsB;IAMrD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,cAAc,IAAI,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI,CAAC,IAAI;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAA2B;IAE3B,OAAO;QACL;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EACT,yLAAyL;YAC3L,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sDAAsD;qBACpE;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;YACD,KAAK,CAAC,OAAO,CAAC,IAAI;gBAChB,MAAM,IAAI,GAAG,MAAM,CAAE,IAA0B,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACnE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,OAAO;wBACL,OAAO,EAAE,8BAA8B,IAAI,GAAG;wBAC9C,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,MAAM,KAAK,GAAgC,MAAM,SAAS,CAAC;oBACzD,GAAG,OAAO;oBACV,IAAI;iBACL,CAAC,CAAC;gBACH,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO;wBACL,OAAO,EAAE,iBAAiB,IAAI,qCAAqC;wBACnE,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,CAAC;YACD,WAAW,EAAE,gBAAgB;SACa;KAC7C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"skill-tools.js","sourceRoot":"","sources":["../src/skill-tools.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,SAAS,EACT,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,gBAAgB,CAAC,IAAsB;IAMrD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,cAAc,IAAI,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI,CAAC,IAAI;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAA2B;IAE3B,OAAO;QACL;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EACT,yLAAyL;YAC3L,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sDAAsD;qBACpE;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;YACD,KAAK,CAAC,OAAO,CAAC,IAAI;gBAChB,MAAM,IAAI,GAAG,MAAM,CAAE,IAA0B,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACnE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,OAAO;wBACL,OAAO,EAAE,8BAA8B,IAAI,GAAG;wBAC9C,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,MAAM,KAAK,GAAgC,MAAM,SAAS,CAAC;oBACzD,GAAG,OAAO;oBACV,IAAI;iBACL,CAAC,CAAC;gBACH,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO;wBACL,OAAO,EAAE,iBAAiB,IAAI,qCAAqC;wBACnE,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,CAAC;YACD,WAAW,EAAE,gBAAgB;YAC7B,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;SACa;KAC7C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xrkseek/harness-cli",
-  "version": "0.0.5",
-  "description": "XRK-Harness CLI (run / serve / web). Product shell ships in product-web/.",
+  "version": "0.0.7",
+  "description": "XRK-Harness CLI (run / serve / web / plugin). Product shell ships in product-web/.",
   "type": "module",
   "exports": {
     ".": {
@@ -58,6 +58,7 @@
     "@xrkseek/server-host": "0.1.0",
     "@xrkseek/server-http": "0.1.0",
     "@xrkseek/server-loader": "0.1.0",
+    "@xrkseek/session-projection": "0.1.0",
     "@xrkseek/workspace": "0.1.0",
     "accepts": "2.0.0",
     "ajv": "8.20.0",
@@ -202,6 +203,7 @@
     "@xrkseek/server-host",
     "@xrkseek/server-http",
     "@xrkseek/server-loader",
+    "@xrkseek/session-projection",
     "@xrkseek/workspace",
     "accepts",
     "ajv",

package/product-web/boot.json

@@ -1,5 +1,5 @@
 {
-  "rev": "xrk-web-1787231267944",
+  "rev": "xrk-web-1787302088374",
   "entries": [
     {
       "id": "@xrkseek/client-connection",

package/product-web/plugins/@xrkseek/client-locale/client.js

@@ -884,11 +884,11 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var LanguageRow_module_css_default = {
-			"selector": "jLfXEq_selector",
-			"rowText": "jLfXEq_rowText",
 			"row": "jLfXEq_row",
 			"chevron": "jLfXEq_chevron",
-			"title": "jLfXEq_title"
+			"title": "jLfXEq_title",
+			"selector": "jLfXEq_selector",
+			"rowText": "jLfXEq_rowText"
 		};
 		//#endregion
 		//#region src/client/LanguageRow.tsx

package/product-web/plugins/@xrkseek/client-ui-agent-preset/client.js

@@ -168,8 +168,8 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var AgentPresetLabel_module_css_default = {
-			"icon": "hnfq1a_icon",
-			"label": "hnfq1a_label"
+			"label": "hnfq1a_label",
+			"icon": "hnfq1a_icon"
 		};
 		//#endregion
 		//#region src/client/AgentPresetLabel.tsx
@@ -267,12 +267,12 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var AgentPresetRow_module_css_default = {
-			"rowText": "LQ3tzG_rowText",
-			"row": "LQ3tzG_row",
 			"desc": "LQ3tzG_desc",
 			"selector": "LQ3tzG_selector",
+			"row": "LQ3tzG_row",
 			"title": "LQ3tzG_title",
-			"chevron": "LQ3tzG_chevron"
+			"chevron": "LQ3tzG_chevron",
+			"rowText": "LQ3tzG_rowText"
 		};
 		//#endregion
 		//#region src/client/AgentPresetRow.tsx
@@ -342,17 +342,17 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var AgentPresetSeat_module_css_default = {
-			"itemName": "MwdynW_itemName",
-			"seat-char-in": "MwdynW_seat-char-in",
 			"seat": "MwdynW_seat",
-			"seatIcon": "MwdynW_seatIcon",
 			"itemDesc": "MwdynW_itemDesc",
-			"introText": "MwdynW_introText",
+			"seat-char-in": "MwdynW_seat-char-in",
 			"introIcon": "MwdynW_introIcon",
-			"seat-icon-in": "MwdynW_seat-icon-in",
-			"introChar": "MwdynW_introChar",
+			"item": "MwdynW_item",
 			"chevron": "MwdynW_chevron",
-			"item": "MwdynW_item"
+			"seatIcon": "MwdynW_seatIcon",
+			"introChar": "MwdynW_introChar",
+			"itemName": "MwdynW_itemName",
+			"introText": "MwdynW_introText",
+			"seat-icon-in": "MwdynW_seat-icon-in"
 		};
 		//#endregion
 		//#region src/client/AgentPresetSeat.tsx
@@ -960,40 +960,40 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var AgentPresetSection_module_css_default = {
-			"cardName": "OFEzwG_cardName",
-			"badge": "OFEzwG_badge",
-			"iconButton": "OFEzwG_iconButton",
-			"cardActive": "OFEzwG_cardActive",
+			"group": "OFEzwG_group",
 			"viewerCode": "OFEzwG_viewerCode",
+			"cardActive": "OFEzwG_cardActive",
 			"field": "OFEzwG_field",
-			"cardId": "OFEzwG_cardId",
-			"fieldLabel": "OFEzwG_fieldLabel",
+			"deleteDialog": "OFEzwG_deleteDialog",
 			"cardDesc": "OFEzwG_cardDesc",
 			"secondaryButton": "OFEzwG_secondaryButton",
-			"creatorButton": "OFEzwG_creatorButton",
+			"intro": "OFEzwG_intro",
 			"iconDanger": "OFEzwG_iconDanger",
-			"inUse": "OFEzwG_inUse",
-			"revealedPathLabel": "OFEzwG_revealedPathLabel",
-			"dialogFields": "OFEzwG_dialogFields",
-			"groupHead": "OFEzwG_groupHead",
-			"card": "OFEzwG_card",
-			"dialog": "OFEzwG_dialog",
 			"cardHead": "OFEzwG_cardHead",
-			"cardBroken": "OFEzwG_cardBroken",
-			"cardBrokenReason": "OFEzwG_cardBrokenReason",
+			"cardName": "OFEzwG_cardName",
+			"iconButton": "OFEzwG_iconButton",
+			"groupHead": "OFEzwG_groupHead",
+			"deleteConfirm": "OFEzwG_deleteConfirm",
+			"section": "OFEzwG_section",
 			"cardMain": "OFEzwG_cardMain",
-			"intro": "OFEzwG_intro",
-			"group": "OFEzwG_group",
-			"revealedPath": "OFEzwG_revealedPath",
-			"deleteDialog": "OFEzwG_deleteDialog",
+			"fieldLabel": "OFEzwG_fieldLabel",
+			"cardFoot": "OFEzwG_cardFoot",
+			"card": "OFEzwG_card",
 			"error": "OFEzwG_error",
+			"revealedPathLabel": "OFEzwG_revealedPathLabel",
+			"cardId": "OFEzwG_cardId",
+			"input": "OFEzwG_input",
 			"title": "OFEzwG_title",
-			"cardFoot": "OFEzwG_cardFoot",
-			"section": "OFEzwG_section",
-			"deleteConfirm": "OFEzwG_deleteConfirm",
 			"brokenBadge": "OFEzwG_brokenBadge",
-			"input": "OFEzwG_input",
-			"cards": "OFEzwG_cards"
+			"cards": "OFEzwG_cards",
+			"dialog": "OFEzwG_dialog",
+			"inUse": "OFEzwG_inUse",
+			"badge": "OFEzwG_badge",
+			"revealedPath": "OFEzwG_revealedPath",
+			"cardBroken": "OFEzwG_cardBroken",
+			"cardBrokenReason": "OFEzwG_cardBrokenReason",
+			"dialogFields": "OFEzwG_dialogFields",
+			"creatorButton": "OFEzwG_creatorButton"
 		};
 		//#endregion
 		//#region src/client/AgentPresetSection.tsx

package/product-web/plugins/@xrkseek/client-ui-commands/client.js

@@ -855,18 +855,18 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var PopupSelectView_module_css_default = {
-			"search": "_7uhq5a_search",
-			"retry": "_7uhq5a_retry",
 			"label": "_7uhq5a_label",
 			"check": "_7uhq5a_check",
+			"rowActive": "_7uhq5a_rowActive",
+			"error": "_7uhq5a_error",
 			"row": "_7uhq5a_row",
-			"card": "_7uhq5a_card",
 			"viewport": "_7uhq5a_viewport",
 			"detail": "_7uhq5a_detail",
-			"error": "_7uhq5a_error",
-			"rowActive": "_7uhq5a_rowActive",
-			"errorText": "_7uhq5a_errorText",
-			"status": "_7uhq5a_status"
+			"retry": "_7uhq5a_retry",
+			"card": "_7uhq5a_card",
+			"status": "_7uhq5a_status",
+			"search": "_7uhq5a_search",
+			"errorText": "_7uhq5a_errorText"
 		};
 		//#endregion
 		//#region src/client/PopupSelectView.tsx