@awak-app/simy-cli 0.7.41 → 0.7.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awak-app/simy-cli",
-  "version": "0.7.41",
+  "version": "0.7.42",
   "description": "Local SIMY executor for non-coding Local Tasks and Agentic Loop runs.",
   "type": "module",
   "bin": {

package/src/cli-contract.js

@@ -14,7 +14,7 @@ import {
 } from "./durable-local-task-steps-contract.js";
 import { buildExecutionCapabilityContract } from "./execution-capability-contract.js";
 
-export const CLI_VERSION = "0.7.41";
+export const CLI_VERSION = "0.7.42";
 export const CLI_API_CONTRACT_VERSION = 10;
 
 export function narrativeImageCapabilityMetadata() {

package/src/desktop-catalog-frames.js

@@ -1,20 +1,53 @@
 import { isDeepStrictEqual } from 'node:util';
 
-function updateRows(previous, incoming, full, unchanged = false) {
+const catalogScope = status => JSON.stringify([status.webOrigin, status.auth?.userId, status.auth?.state,
+  status.access?.organizationId, status.access?.revision, status.access?.state]);
+
+function updateRows(previous, incoming, full, { unchanged = false, immutableInput = false, copyOnWrite = false } = {}) {
   if (full || previous === null || previous.length !== incoming.length) {
-    const rows = structuredClone(incoming);
+    const rows = immutableInput ? incoming : structuredClone(incoming);
     return { rows, payload: { rows } };
   }
   if (unchanged) return { rows: previous, payload: { count: previous.length, changes: [] } };
   const changes = [];
+  let rows = previous;
   for (let index = 0; index < incoming.length; index++) {
     if (!isDeepStrictEqual(previous[index], incoming[index])) {
-      const row = structuredClone(incoming[index]);
-      previous[index] = row;
+      const row = immutableInput ? incoming[index] : structuredClone(incoming[index]);
+      if (!immutableInput) {
+        if (copyOnWrite && rows === previous) rows = previous.slice();
+        rows[index] = row;
+      }
       changes.push([index, row]);
     }
   }
-  return { rows: previous, payload: { count: previous.length, changes } };
+  return { rows: immutableInput ? incoming : rows, payload: { count: incoming.length, changes } };
+}
+
+// Detach mutable producer data once. Unchanged catalog rows may be shared only
+// between these owned read-only snapshots; changed rows get detached copies and
+// a new array. Older queued frames and durable writes must remain immutable.
+export function createDesktopStatusSnapshot() {
+  let rows = null, candidates = null, scope = null;
+  return status => {
+    const supervision = status?.sessionSupervision;
+    if (!Array.isArray(supervision?.sessions)) {
+      rows = candidates = scope = null;
+      return structuredClone(status);
+    }
+    const nextScope = catalogScope(status);
+    if (nextScope !== scope) { rows = candidates = null; scope = nextScope; }
+    const hasCandidates = Array.isArray(supervision.selectionCandidates);
+    const detached = structuredClone({ ...status, sessionSupervision: { ...supervision,
+      sessions: [], ...(hasCandidates ? { selectionCandidates: [] } : {}) } });
+    rows = updateRows(rows, supervision.sessions, false, { copyOnWrite: true }).rows;
+    detached.sessionSupervision.sessions = rows;
+    if (hasCandidates) {
+      candidates = updateRows(candidates, supervision.selectionCandidates, false, { copyOnWrite: true }).rows;
+      detached.sessionSupervision.selectionCandidates = candidates;
+    } else candidates = null;
+    return detached;
+  };
 }
 
 // One encoder per ordered output stream. Call only when a frame actually enters
@@ -30,11 +63,10 @@ export function createDesktopCatalogEncoder({ immutableInput = false } = {}) {
     }
     const status = frame.status;
     const incoming = status.sessionSupervision.sessions;
-    const identity = JSON.stringify([status.webOrigin, status.auth?.userId, status.auth?.state, status.access?.organizationId,
-      status.access?.revision, status.access?.state]);
+    const identity = catalogScope(status);
     const previous = revision++;
     const full = rows === null || scope !== identity || rows.length !== incoming.length;
-    const snapshot = updateRows(rows, incoming, full, immutableInput && sourceRows === incoming);
+    const snapshot = updateRows(rows, incoming, full, { immutableInput, unchanged: immutableInput && sourceRows === incoming });
     rows = snapshot.rows; sourceRows = incoming; scope = identity;
     const catalog = { version: 1, revision, scope, ...(full ? {} : { baseRevision: previous }), ...snapshot.payload };
     const { sessions, ...metadata } = status.sessionSupervision;
@@ -42,7 +74,8 @@ export function createDesktopCatalogEncoder({ immutableInput = false } = {}) {
     if (Array.isArray(metadata.selectionCandidates)) {
       // This is another complete directory, used by the conversation picker.
       // Do not silently retransmit it as supposedly small status metadata.
-      const snapshot = updateRows(candidates, metadata.selectionCandidates, full, immutableInput && sourceCandidates === metadata.selectionCandidates);
+      const snapshot = updateRows(candidates, metadata.selectionCandidates, full,
+        { immutableInput, unchanged: immutableInput && sourceCandidates === metadata.selectionCandidates });
       candidates = snapshot.rows; sourceCandidates = metadata.selectionCandidates; catalog.selectionCandidates = snapshot.payload;
       const { selectionCandidates, ...small } = metadata;
       supervision = small;

package/src/desktop-host.js

@@ -1,5 +1,5 @@
 import { createDesktopFrameWriter } from './desktop-frame-writer.js';
-import { createDesktopCatalogEncoder } from './desktop-catalog-frames.js';
+import { createDesktopCatalogEncoder, createDesktopStatusSnapshot } from './desktop-catalog-frames.js';
 import { boundedDiscovery } from './session-supervision/progressive-discovery.js';
 import { createCatalogRefreshPolicy } from './session-supervision/catalog-refresh.js';
 import { supervisedSession } from './session-supervision/discovery-window.js';
@@ -197,6 +197,7 @@ export async function startDesktopHost({ input = process.stdin, output = process
   // deltas later, after backpressure coalescing. Registries may mutate objects,
   // so the comparison snapshot must remain detached from producer references.
   let encodedStatus = null, lastStatus = null, lastStatusFrame = null, updateProgress = null;
+  const snapshotStatus = createDesktopStatusSnapshot();
   let projectCatalogFrame = status => status;
   let resolveFirstStatus;
   const firstStatus = new Promise(resolve => { resolveFirstStatus = resolve; });
@@ -206,6 +207,7 @@ export async function startDesktopHost({ input = process.stdin, output = process
   let acceptanceReadbackSequence = 0;
   let remoteHosts;
   const emitStatus = status => {
+    let catalogObservation;
     status = projectCatalogFrame(status);
     status = { ...status, windowUpdate: { version: 1, preservesWork: Boolean(ownerTransport), prepared: windowUpdatePrepared } };
     const updateSettings = updater?.snapshot?.() || {};
@@ -229,16 +231,20 @@ export async function startDesktopHost({ input = process.stdin, output = process
     if (preferenceScope && desktopAccessReady(status.access) && status.sessionSupervision?.sessions) {
       const catalogScope = preferenceScope;
       status = { ...status, sessionSupervision: { ...status.sessionSupervision, sessions: status.sessionSupervision.sessions.filter(row => controllerPreferences.get(catalogScope, row).deleted !== true).map(row => { const saved = controllerPreferences.get(catalogScope, row); return { ...row, controllerPreferences: saved, ...(saved.pinned === undefined ? {} : { listPinned: saved.pinned, listPinScopes: saved.pinScopes }), ...(saved.hidden === undefined ? {} : { localHidden: saved.hidden }) }; }) } };
-      const catalog = { observedAt: Date.now(), sessions: status.sessionSupervision.sessions, hosts: status.remoteHosts?.items || [], providerLinks };
-      void controllerPreferences.replaceCatalog(catalogScope, catalog).catch(() => {});
+      catalogObservation = { scope: catalogScope, observedAt: Date.now() };
     }
     if (updateProgress) status = { ...status, update: { ...status.update, ...updateProgress } };
     const { sampledAt, ...content } = status;
     if (!lastStatus || !isDeepStrictEqual(content, lastStatus)) {
       if (!catalogEncoder) encodedStatus = JSON.stringify(content).slice(1, -1);
-      lastStatus = structuredClone(content);
+      lastStatus = snapshotStatus(content);
     }
     const ownedStatus = { ...lastStatus, ...(sampledAt === undefined ? {} : { sampledAt }) };
+    if (catalogObservation) {
+      const catalog = { observedAt: catalogObservation.observedAt, sessions: ownedStatus.sessionSupervision.sessions,
+        hosts: ownedStatus.remoteHosts?.items || [], providerLinks: structuredClone(providerLinks) };
+      void controllerPreferences.replaceCatalog(catalogObservation.scope, catalog, { immutableInput: true }).catch(() => {});
+    }
     lastStatusFrame = ownedStatus;
     ownerTransport?.publishDesktop?.({ type: 'status', status: ownedStatus });
     const observation = sampledAt === undefined ? '' : `"sampledAt":${JSON.stringify(sampledAt)}${encodedStatus ? ',' : ''}`;

package/src/session-supervision/controller-store.js

@@ -41,11 +41,13 @@ export function createControllerStore(root) {
       await persist(scope, next); return result;
     });
   }
-  function replaceCatalog(scope, catalog) {
+  function replaceCatalog(scope, catalog, { immutableInput = false } = {}) {
     // Own the incoming snapshot immediately, but do not clone the previous
     // multi-MiB catalog just to replace it. Preference writes still serialize
     // on the same queue and commit only after their atomic write succeeds.
-    const snapshot = structuredClone(catalog);
+    // Only the desktop's detached read-only snapshots may be borrowed. Generic
+    // callers retain immediate mutation isolation, including while queued.
+    const snapshot = immutableInput ? catalog : structuredClone(catalog);
     return enqueue(async () => {
       const settings = { ...await load(scope) };
       delete settings.catalog;