@genesislcap/ai-assistant 15.15.1 → 15.15.2

package/dist/ai-assistant.api.json

@@ -10063,6 +10063,160 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#persistenceBroken:member",
+              "docComment": "/**\n * GENC-1511 — persistence has failed repeatedly and it is no longer saving. Drives a BLOCKING modal with a single Reload action: the whole failure class this ticket exists for is one the user cannot see, and a passive indicator is close to invisible (Will worked for 3h17m past the point his session stopped saving, with nothing on screen to tell him).\n *\n * Set only at a moment when reloading is SAFE — the persister gates it on the active agent being resumable, so we never advise a reload while an agent's in-flight work would be lost.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "persistenceBroken: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "persistenceBroken",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#persistenceBrokenChanged:member(1)",
+              "docComment": "/**\n * Showing and hiding the modal hangs off the PROPERTY, so `persistenceBroken` is the single entry point — for this element's own persister callback and for a host reporting a failure in a keyspace this element knows nothing about (Create's project payload, GENC-1511 §17).\n *\n * It has to be here rather than at the call site because of the `cancel` listener: `cancel` does not bubble, so it cannot be bound from the template, and a caller that shows the modal without attaching it gets a modal Escape closes — which defeats the whole point. Routing every path through one place makes a dismissible variant unreachable.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "persistenceBrokenChanged(_old: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", broken: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "_old",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "broken",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "persistenceBrokenChanged"
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#persistenceBrokenDetail:member",
+              "docComment": "/**\n * Optional second line, already composed. A STRING rather than the message-count fields it replaces: quantifying is caller-specific (\"N messages\", \"your last N changes\"), and keeping the template ignorant of what is being counted is what makes it reusable.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "persistenceBrokenDetail?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "persistenceBrokenDetail",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#persistenceBrokenMessage:member",
+              "docComment": "/**\n * Body copy for the modal; `undefined` uses the session-oriented default in the template. A host reporting a different keyspace overrides it — \"this session has stopped saving\" is simply untrue of a failed project write.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "persistenceBrokenMessage?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "persistenceBrokenMessage",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#persistenceChanged:member(1)",
@@ -10137,6 +10291,37 @@
               "isAbstract": false,
               "name": "persistenceChanged"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#persistenceModal:member",
+              "docComment": "/**\n * The modal itself, so it can be shown and made non-dismissible.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "persistenceModal?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Modal",
+                  "canonicalReference": "@genesislcap/rapid-design-system!Modal:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "persistenceModal",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#persistenceToggleable:member",
@@ -10462,6 +10647,37 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#reloadForPersistence:member(1)",
+              "docComment": "/**\n * The modal's only action. A reload re-reads the stored snapshot, which is plain data parsed from the server, so it also clears the serialisation fault that is the most likely cause.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "reloadForPersistence(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "reloadForPersistence"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#removeAttachment:member(1)",
@@ -10607,6 +10823,102 @@
               "isAbstract": false,
               "name": "removeCostSessionFromHistory"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#reportPersistenceBroken:member(1)",
+              "docComment": "/**\n * Tell the user their work is no longer being saved, and block until they reload (GENC-1511).\n *\n * Public because the assistant is not the only thing that persists. Its own persister covers `sessions/<key>`; a host may own other keyspaces whose failure is just as costly — Create's `projects/<id>.json` holds the entity model, handlers and VFS, i.e. the app itself — and had no way to reach this modal (§17 of the GENC-1511 plan).\n *\n * Both copy fields are optional and default to the session wording in the template, so the common case stays a bare call. Idempotent per source while already broken: re-reporting the same source refreshes its copy, and the property change only shows a modal that is not open.\n *\n * @param overrides - `message` replaces the body; `detail` adds/replaces the second line; `source` identifies the reporter so its own recovery withdraws only its own warning. Give each independent keyspace its own id — see `brokenSources` for what sharing one costs.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "reportPersistenceBroken(overrides?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        message?: string;\n        detail?: string;\n        source?: string;\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "overrides",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "reportPersistenceBroken"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#reportPersistenceRecovered:member(1)",
+              "docComment": "/**\n * Withdraw one reporter's warning — its save landed, or the host's own store recovered.\n *\n * Only `source`'s entry is removed, so a session recovery cannot cancel a host's still-live project failure (GENC-1511, caught in review; see `brokenSources`). The modal closes only once nothing is broken; while anything remains, the copy falls back to the newest survivor.\n *\n * @param source - must match the id the failure was reported under.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "reportPersistenceRecovered(source?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "source",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "reportPersistenceRecovered"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#requestBudgetRefresh:member(1)",
@@ -13164,6 +13476,61 @@
           },
           "implementsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistantTemplate:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "FoundationAiAssistantTemplate: (designSystemPrefix: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Reference",
+              "text": "ViewTemplate",
+              "canonicalReference": "@microsoft/fast-element!ViewTemplate:class"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "FoundationAiAssistant",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant:class"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            }
+          ],
+          "fileUrlPath": "src/main/main.template.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "designSystemPrefix",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "FoundationAiAssistantTemplate"
+        },
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager:class",

package/dist/ai-assistant.d.ts

@@ -3299,6 +3299,80 @@ export declare class FoundationAiAssistant extends GenesisElement {
     settingsModalTab: SettingsModalTab;
     /** Bound to the design-system modal via the template ref. */
     settingsModal?: Modal;
+    /**
+     * GENC-1511 — persistence has failed repeatedly and it is no longer saving. Drives a BLOCKING
+     * modal with a single Reload action: the whole failure class this ticket exists for is one the
+     * user cannot see, and a passive indicator is close to invisible (Will worked for 3h17m past
+     * the point his session stopped saving, with nothing on screen to tell him).
+     *
+     * Set only at a moment when reloading is SAFE — the persister gates it on the active agent
+     * being resumable, so we never advise a reload while an agent's in-flight work would be lost.
+     */
+    persistenceBroken: boolean;
+    /**
+     * Which reporters currently consider persistence broken, newest last, each with the copy it
+     * asked for. {@link FoundationAiAssistant.persistenceBroken} is DERIVED from this (`size > 0`) rather than being the
+     * source of truth.
+     *
+     * A plain boolean was wrong the moment there was more than one reporter, and review caught it:
+     * this element's own persister covers `sessions/<key>`, while a host reports its own keyspaces
+     * (Create's `projects/<id>.json`). With one flag, a SESSION save landing after its own broken
+     * episode called `reportPersistenceRecovered()` and closed the modal while the PROJECT store
+     * was still refusing writes — and because Create's own re-entry guard only clears on a
+     * successful project write, the warning could then never be raised again for the life of the
+     * page. The user carried on against a dead store with the warning cancelled by an unrelated
+     * subsystem: the exact failure this modal exists to prevent, on the keyspace that holds the app
+     * rather than the transcript.
+     *
+     * A `Map` and not a `Set` because the copy has to survive the same collision. The winner is the
+     * most recently reported still-broken source (insertion order, so it is deterministic), and when
+     * one recovers the copy falls back to whoever is left instead of reverting to the session
+     * default — which would otherwise state something untrue of the failure still in progress.
+     */
+    private readonly brokenSources;
+    /**
+     * Showing and hiding the modal hangs off the PROPERTY, so `persistenceBroken` is the single
+     * entry point — for this element's own persister callback and for a host reporting a failure in
+     * a keyspace this element knows nothing about (Create's project payload, GENC-1511 §17).
+     *
+     * It has to be here rather than at the call site because of the `cancel` listener: `cancel`
+     * does not bubble, so it cannot be bound from the template, and a caller that shows the modal
+     * without attaching it gets a modal Escape closes — which defeats the whole point. Routing
+     * every path through one place makes a dismissible variant unreachable.
+     */
+    persistenceBrokenChanged(_old: boolean, broken: boolean): void;
+    /** Swallows the native dialog's Escape route. Stored, not inline, so it can be removed again. */
+    private readonly onPersistenceModalCancel;
+    /** The node the guard above is bound to, so removal targets the same one it was added to. */
+    private persistenceEscapeGuardTarget?;
+    /**
+     * Make the modal survive Escape. Bound imperatively because `cancel` does not bubble.
+     *
+     * Attach/detach rather than fire-and-forget: a broken → recovered → broken cycle is reachable
+     * (that is what {@link FoundationAiAssistant.reportPersistenceRecovered} is for), and re-showing previously added a
+     * fresh anonymous closure each time, accumulating duplicate listeners on the dialog.
+     *
+     * A missing `mainElement` is LOGGED rather than ignored. `Dialog` declares it non-optional, so
+     * if it is ever absent the old optional-chain quietly produced an Escape-dismissible modal —
+     * failing open on the one property this modal must never lose.
+     */
+    private attachPersistenceEscapeGuard;
+    /** Remove the Escape guard, if one is bound. Safe to call when there is none. */
+    private detachPersistenceEscapeGuard;
+    /**
+     * Body copy for the modal; `undefined` uses the session-oriented default in the template. A
+     * host reporting a different keyspace overrides it — "this session has stopped saving" is
+     * simply untrue of a failed project write.
+     */
+    persistenceBrokenMessage?: string;
+    /**
+     * Optional second line, already composed. A STRING rather than the message-count fields it
+     * replaces: quantifying is caller-specific ("N messages", "your last N changes"), and keeping
+     * the template ignorant of what is being counted is what makes it reusable.
+     */
+    persistenceBrokenDetail?: string;
+    /** The modal itself, so it can be shown and made non-dismissible. */
+    persistenceModal?: Modal;
     /** Bound to the settings modal tab bar — used to resync selection after reopen. */
     settingsTabsEl?: SettingsModalTabsElement;
     /** Light-DOM nodes assigned to settings modal slots (via `slotted()` bindings). */
@@ -3900,6 +3974,61 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * a remounted element becomes the live source, not the torn-down creator (GENC-1351 §5.10 / #7).
      */
     private buildPersisterDeps;
+    /**
+     * Tell the user their work is no longer being saved, and block until they reload (GENC-1511).
+     *
+     * Public because the assistant is not the only thing that persists. Its own persister covers
+     * `sessions/<key>`; a host may own other keyspaces whose failure is just as costly — Create's
+     * `projects/<id>.json` holds the entity model, handlers and VFS, i.e. the app itself — and had
+     * no way to reach this modal (§17 of the GENC-1511 plan).
+     *
+     * Both copy fields are optional and default to the session wording in the template, so the
+     * common case stays a bare call. Idempotent per source while already broken: re-reporting the
+     * same source refreshes its copy, and the property change only shows a modal that is not open.
+     *
+     * @param overrides - `message` replaces the body; `detail` adds/replaces the second line;
+     *   `source` identifies the reporter so its own recovery withdraws only its own warning. Give
+     *   each independent keyspace its own id — see `brokenSources` for what sharing one costs.
+     */
+    reportPersistenceBroken(overrides?: {
+        message?: string;
+        detail?: string;
+        source?: string;
+    }): void;
+    /**
+     * Withdraw one reporter's warning — its save landed, or the host's own store recovered.
+     *
+     * Only `source`'s entry is removed, so a session recovery cannot cancel a host's still-live
+     * project failure (GENC-1511, caught in review; see `brokenSources`). The modal closes
+     * only once nothing is broken; while anything remains, the copy falls back to the newest
+     * survivor.
+     *
+     * @param source - must match the id the failure was reported under.
+     */
+    reportPersistenceRecovered(source?: string): void;
+    /**
+     * Recompute the derived flag and the displayed copy from `brokenSources`.
+     *
+     * Copy order is last-in-wins, which is both deterministic (`Map` iterates in insertion order)
+     * and the behaviour a reader expects — the most recent failure is the one described. Setting
+     * `persistenceBroken` last means the modal is only ever shown or closed once the copy backing
+     * it is already correct.
+     */
+    private syncPersistenceBrokenCopy;
+    /** This element's own persister said the session snapshot is not landing (GENC-1511). */
+    private onPersistenceBroken;
+    /**
+     * A session save landed after a broken episode — withdraw OUR warning only (GENC-1511).
+     *
+     * The explicit source is the whole point: a host's project store may still be failing, and
+     * before this was per-source a session recovery closed that modal too.
+     */
+    private onPersistenceRecovered;
+    /**
+     * The modal's only action. A reload re-reads the stored snapshot, which is plain data parsed
+     * from the server, so it also clears the serialisation fault that is the most likely cause.
+     */
+    reloadForPersistence(): void;
     /**
      * First-load persistence init for a freshly created store (GENC-1351). Restores
      * the user's remembered persistence-toggle choice — kept independently of the
@@ -3988,7 +4117,6 @@ export declare class FoundationAiAssistant extends GenesisElement {
     onComposerResizeEnd(e: PointerEvent): void;
 }
 
-/** @internal */
 export declare const FoundationAiAssistantTemplate: (designSystemPrefix: string) => ViewTemplate<FoundationAiAssistant>;
 
 /**

package/dist/chat-driver.cjs

@@ -3564,6 +3564,9 @@ var META_EVENT_IMPORTANCE = {
   "context.threshold-crossed": "high",
   "context.compacted": "high",
   "persistence.restore-orphan": "high",
+  // A save that did not land is silent data loss in progress: the transcript on screen
+  // is no longer backed by the store, and every later turn widens the gap. GENC-1511.
+  "persistence.save-failed": "high",
   "assistant.connected": "normal",
   "assistant.disconnected": "normal",
   "assistant.popout": "normal",