@genesislcap/ai-assistant 15.32.1 → 15.33.1

package/dist/ai-assistant.api.json

@@ -11401,6 +11401,51 @@
               "isAbstract": false,
               "name": "getDebugLog"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#getLifetimeDebugLog:member(1)",
+              "docComment": "/**\n * The log to download (GENC-1351 §5.8). When the provider persists diagnostics, stitch the **whole lifetime** stream (every page load) rather than just the current page's in-memory view: flush the current delta first so it's included, then reassemble everything `loadDiagnostics` returns. Independent of \"remember chat\" — diagnostics are a forensic stream keyed on provider capability, not on whether the *chat* is remembered (like preferences). Falls back to the live current-page log when diagnostics isn't available or the fetch fails.\n *\n * The stored `meta-snapshot`s are replaced by a fresh one (`withFreshMetaSnapshot`) before reassembly. The persisted stream only re-appends that block when the near-static config signature changes (see `collectDiagnosticsDelta`), so on a session whose config never changes the newest STORED snapshot is the first one — its `context` half (session cost/usage, context tokens, live agent state) frozen seconds into the session, which is how a lifetime log came out reporting near-zero spend against a transcript full of priced messages.\n *\n * PUBLIC (GENC-1625) so a host can ship this exact document somewhere other than the user's downloads folder — Genesis Create writes it into its project export archive, where it is what a support engineer (increasingly, an agent) opens first. Public rather than copied: a host assembling its own would need `DEBUG_LOG_README`, a flush of the pending delta and a fresh `meta-snapshot`, and the moment there are two derivations one of them starts drifting — which for this log means silently understating spend, the bug `withFreshMetaSnapshot` exists to fix.\n *\n * Safe to call at any time: it never throws (a failed diagnostics load degrades to the current-page log) and it has no side effect on the chat beyond landing the delta the next throttled flush would have landed anyway.\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getLifetimeDebugLog(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "DebugLog",
+                  "canonicalReference": "@genesislcap/ai-assistant!DebugLog:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getLifetimeDebugLog"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#handleFileSelect:member(1)",
@@ -15538,7 +15583,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitDebugLog:member(1)",
-              "docComment": "/**\n * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send button next to Download. Reuses `buildDownloadLog`, so the submitted log is byte-identical to what Download saves (lifetime-stitched when the provider persists diagnostics). The assistant is vendor-agnostic: the callback owns the transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in `debugLogSubmitResult` so the button can flash 'Sent'/'Failed'; failures also go to the logger with the cause.\n */\n",
+              "docComment": "/**\n * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send button next to Download. Reuses `getLifetimeDebugLog`, so the submitted log is byte-identical to what Download saves (lifetime-stitched when the provider persists diagnostics). The assistant is vendor-agnostic: the callback owns the transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in `debugLogSubmitResult` so the button can flash 'Sent'/'Failed'; failures also go to the logger with the cause.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",

package/dist/ai-assistant.d.ts

@@ -4422,7 +4422,7 @@ export declare class FoundationAiAssistant extends GenesisElement {
     downloadDebugLog(): Promise<void>;
     /**
      * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send
-     * button next to Download. Reuses `buildDownloadLog`, so the submitted log is
+     * button next to Download. Reuses `getLifetimeDebugLog`, so the submitted log is
      * byte-identical to what Download saves (lifetime-stitched when the provider
      * persists diagnostics). The assistant is vendor-agnostic: the callback owns the
      * transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in
@@ -4492,8 +4492,21 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * `context` half (session cost/usage, context tokens, live agent state) frozen seconds
      * into the session, which is how a lifetime log came out reporting near-zero spend
      * against a transcript full of priced messages.
+     *
+     * PUBLIC (GENC-1625) so a host can ship this exact document somewhere other than the user's
+     * downloads folder — Genesis Create writes it into its project export archive, where it is what
+     * a support engineer (increasingly, an agent) opens first. Public rather than copied: a host
+     * assembling its own would need `DEBUG_LOG_README`, a flush of the pending delta and a fresh
+     * `meta-snapshot`, and the moment there are two derivations one of them starts drifting — which
+     * for this log means silently understating spend, the bug `withFreshMetaSnapshot` exists to fix.
+     *
+     * Safe to call at any time: it never throws (a failed diagnostics load degrades to the
+     * current-page log) and it has no side effect on the chat beyond landing the delta the next
+     * throttled flush would have landed anyway.
+     *
+     * @public
      */
-    private buildDownloadLog;
+    getLifetimeDebugLog(): Promise<DebugLog>;
     /**
      * The shared per-session `SessionPersister` that owns restore-core
      * save/restore/freeze (GENC-1351 §5.10). Created once per `stateKey` and shared by