@genesislcap/ai-assistant 15.87.0 → 15.88.1

package/dist/dts/headless/index.d.ts

@@ -1,5 +1,5 @@
 export { describeInteraction } from './describe-interaction';
 export { headlessCurrentDebugLog, headlessDiagnosticEntries, headlessMetaSnapshot, } from './headless-debug';
 export { HeadlessSession } from './headless-session';
-export type { AutopilotLike, DescribedAction, DescribeInteractionInput, HeadlessActArgs, HeadlessActResult, HeadlessDebugOptions, HeadlessEvent, HeadlessEventBase, HeadlessEventType, HeadlessPersistence, HeadlessPersistenceBinding, HeadlessPersistenceHost, HeadlessReadRequest, HeadlessReadResult, HeadlessResult, HeadlessSendOptions, HeadlessSessionOptions, HeadlessState, HeadlessWaitRequest, HeadlessWaitResult, InteractionDescription, PendingSummary, } from './headless.types';
+export type { AutopilotLike, DescribedAction, DescribeInteractionInput, HeadlessActArgs, HeadlessActResult, HeadlessDebugOptions, HeadlessEvent, HeadlessEventBase, HeadlessEventType, HeadlessPersistence, HeadlessPersistenceBinding, HeadlessPersistenceHost, HeadlessReadRequest, HeadlessReadResult, HeadlessResult, HeadlessRestoreOutcome, HeadlessSendOptions, HeadlessSessionOptions, HeadlessState, HeadlessWaitRequest, HeadlessWaitResult, InteractionDescription, PendingSummary, } from './headless.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/headless/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/headless/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/headless/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/esm/headless/headless-persistence.js

@@ -86,6 +86,20 @@ class Binding {
             yield this.persister.flushDiagnostics();
         });
     }
+    restore() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.disposed)
+                return undefined;
+            // The persister loads into the store (`getStore`) and the driver, and seeds its own carry-forward
+            // cache, so its later saves keep what it brought back. Nothing is re-activated here.
+            const outcome = yield this.persister.restore();
+            if (this.disposed || !outcome)
+                return outcome;
+            // What the restore wrote to the driver, mirrored into the store it reads at save time.
+            this.syncAll();
+            return outcome;
+        });
+    }
     debugLog() {
         const { driver, options } = this;
         return lifetimeDebugLog({

package/dist/esm/headless/headless-session.js

@@ -74,6 +74,8 @@ export class HeadlessSession {
         this.lastProbe = {};
         this.lastAutopilot = '';
         this.disposed = false;
+        /** While a restore loads the history, which is not new activity. */
+        this.restoring = false;
         if (typeof driver.addInteractionInterceptor !== 'function') {
             throw new Error('HeadlessSession needs a driver that supports interaction interceptors (addInteractionInterceptor), and this one does not.');
         }
@@ -364,6 +366,27 @@ export class HeadlessSession {
             }
             : {})), { cost: sumUsage(this.history()), probe: this.readProbe(), lastSeq: this.seq });
     }
+    /**
+     * Restore the saved session for this key, as the browser's element does on mount (see
+     * `HeadlessPersistenceBinding.restore`). Call it before the first `send`. The restored history is
+     * the starting point, not news: it is not reported as `message` events or as a turn, and the
+     * event log and its cursors carry on from where they are. A no-op without `persistence`.
+     */
+    restore() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.persistence)
+                return undefined;
+            this.restoring = true;
+            try {
+                return yield this.persistence.restore();
+            }
+            finally {
+                this.restoring = false;
+                this.seen = this.history().length;
+                this.base = this.seen;
+            }
+        });
+    }
     /**
      * Save the session now: the snapshot, and the diagnostics appended since the last flush, rather
      * than at the next throttled save. A no-op without `persistence`.
@@ -537,7 +560,7 @@ export class HeadlessSession {
     }
     /** New messages in the driver's history: report what the person would see of them. */
     onHistory() {
-        if (this.disposed)
+        if (this.disposed || this.restoring)
             return;
         this.reportMessages();
         this.observe();

package/docs/genesis.md

@@ -862,7 +862,7 @@ everything reachable from its root ends up in every consumer's bundle — includ
 not Genesis apps. Keeping the bridge on its own entry point keeps it out of theirs; a test walks
 the root's import graph to hold that line.
 
-### Why `foundation-comms` is an optional peer at `workspace:^`
+### Why `foundation-comms` is an optional peer at `workspace:*`
 
 `foundation-comms` is a **peer dependency** so the bridge uses the app's own `Connect`. It is
 installed either way (`foundation-ui` depends on it); the peer is about which copy.
@@ -881,12 +881,18 @@ loudly when it is not.
 It is **optional** because only `./genesis` uses it: a host that never imports the bridge should
 not be asked to install comms.
 
-The range is a **caret, not `workspace:*`**. `workspace:*` publishes as an exact version, and an
-exact peer means any patch-level difference between the app's copy and this package's is an
-ERESOLVE at install time — a hard failure over a difference that cannot matter. `workspace:^`
-publishes as `^<version>`, which is what the requirement actually is.
-
-Two things are new here and were chosen rather than defaulted into: this is the first
-`workspace:^` in the monorepo, and the first internal package declared as a peer. Whatever lands
-here is what the next package copies, which is the reason the argument is written down rather
-than left in the `package.json` line.
+The range is **exact, `workspace:*`**, like every other internal dependency in the monorepo (the
+platform is released in lockstep). It was a caret (`workspace:^`) at first, to spare a host an
+ERESOLVE over a patch-level difference, but a caret broke the one thing the peer is for. A host
+that does not declare comms itself has the peer filled by npm with the **newest** release in
+range, while every other platform package pins comms exactly to the version it was released
+with. Those pins then miss the top-level copy, and npm nests a second copy under each of them: the
+two-copy install described above (GENC-1780).
+
+The cost of the exact pin is that a host on a different comms version gets an install-time peer
+conflict. That is the loud failure this section argues for, and the fix is to align the host's
+`@genesislcap` versions, which it needs anyway.
+
+This is the first internal package declared as a peer. Whatever lands here is what the next
+package copies, which is the reason the argument is written down rather than left in the
+`package.json` line.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.87.0",
+  "version": "15.88.1",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/dts/index.d.ts",
@@ -102,31 +102,31 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-comms": "15.87.0",
-    "@genesislcap/foundation-testing": "15.87.0",
-    "@genesislcap/genx": "15.87.0",
-    "@genesislcap/ts-builder": "15.87.0",
-    "@genesislcap/uvu-playwright-builder": "15.87.0",
-    "@genesislcap/vite-builder": "15.87.0",
-    "@genesislcap/webpack-builder": "15.87.0",
+    "@genesislcap/foundation-comms": "15.88.1",
+    "@genesislcap/foundation-testing": "15.88.1",
+    "@genesislcap/genx": "15.88.1",
+    "@genesislcap/ts-builder": "15.88.1",
+    "@genesislcap/uvu-playwright-builder": "15.88.1",
+    "@genesislcap/vite-builder": "15.88.1",
+    "@genesislcap/webpack-builder": "15.88.1",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.87.0",
-    "@genesislcap/foundation-logger": "15.87.0",
-    "@genesislcap/foundation-notifications": "15.87.0",
-    "@genesislcap/foundation-redux": "15.87.0",
-    "@genesislcap/foundation-ui": "15.87.0",
-    "@genesislcap/foundation-utils": "15.87.0",
-    "@genesislcap/rapid-design-system": "15.87.0",
-    "@genesislcap/web-core": "15.87.0",
+    "@genesislcap/foundation-ai": "15.88.1",
+    "@genesislcap/foundation-logger": "15.88.1",
+    "@genesislcap/foundation-notifications": "15.88.1",
+    "@genesislcap/foundation-redux": "15.88.1",
+    "@genesislcap/foundation-ui": "15.88.1",
+    "@genesislcap/foundation-utils": "15.88.1",
+    "@genesislcap/rapid-design-system": "15.88.1",
+    "@genesislcap/web-core": "15.88.1",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
   "peerDependencies": {
-    "@genesislcap/foundation-comms": "^15.87.0"
+    "@genesislcap/foundation-comms": "15.88.1"
   },
   "peerDependenciesMeta": {
     "@genesislcap/foundation-comms": {