@genesislcap/ai-assistant 15.19.6 → 15.20.0-alpha.3

package/dist/ai-assistant.api.json

@@ -2464,11 +2464,20 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#canCompact:member(1)",
-              "docComment": "/**\n * Whether `compact()` would compact something right now — a summarizable run of older turns exists behind a clean boundary. The UI gates its \"Compact\" affordance on this, so the button reflects the exact history `compact()` acts on (GENC-1351). Optional — only history-owning drivers implement it.\n */\n",
+              "docComment": "/**\n * Whether `compact()` would compact something right now. Convenience over {@link AiDriver.getCompactionPlan} — prefer the plan where the caller needs to say how much would be reclaimed. Optional — only history-owning drivers implement it.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "canCompact?(): "
+                  "text": "canCompact?(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Content",
@@ -2481,22 +2490,40 @@
               ],
               "isOptional": true,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "releaseTag": "Beta",
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "name": "canCompact"
             },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#compact:member(1)",
-              "docComment": "/**\n * Destructively compact older conversation turns into a single `compacted-summary` message (GENC-1351 §5.7), summarizing them via the default provider's one-shot `prompt()`. Atomic: history changes only on success. Resolves to the created summary message, or `null` when there is nothing worth compacting or the provider cannot summarize. Optional — only drivers that own history implement it.\n */\n",
+              "docComment": "/**\n * Destructively compact older conversation turns into a single `compacted-summary` message (GENC-1351 §5.7), summarizing them via the default provider's one-shot `prompt()`. Atomic: history changes only on success. Resolves to the created summary message, or `null` when there is nothing worth compacting or the provider cannot summarize. Optional — only drivers that own history implement it.\n *\n * Pass the same `options` used for {@link AiDriver.getCompactionPlan} so the action does exactly what the affordance advertised.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "compact?(): "
+                  "text": "compact?(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
@@ -2523,12 +2550,21 @@
               ],
               "isOptional": true,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 5
+                "startIndex": 3,
+                "endIndex": 7
               },
               "releaseTag": "Beta",
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "name": "compact"
             },
             {
@@ -2693,6 +2729,57 @@
               "parameters": [],
               "name": "getActiveProviderName"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getCompactionPlan:member(1)",
+              "docComment": "/**\n * What compacting right now would cost and reclaim, without running the summarizer (GENC-1567) — or `null` when there is no safe cut, or the projected reclaim is not worth the call.\n *\n * The single source of truth for every compaction affordance: the menu's enabled state, its tooltip, the context gate's banner copy, and the action itself all read this, so none of them can promise a reclaim the action does not deliver. Optional — only history-owning drivers implement it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getCompactionPlan?(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionProjection",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionProjection:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "getCompactionPlan"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getExternalDiagnostics:member(1)",
@@ -2735,6 +2822,39 @@
               "parameters": [],
               "name": "getExternalDiagnostics"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getHistoryForPersistence:member(1)",
+              "docComment": "/**\n * The history a host should PERSIST — {@link AiDriver.getRawHistory} with tool payloads the driver has already condensed out of the model's context replaced by the stubs it sent (GENC-1566). Optional: a driver that does not implement tool-context condensation has nothing to project, and a caller falls back to {@link AiDriver.getRawHistory}.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHistoryForPersistence?(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "getHistoryForPersistence"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getInteractionContext:member(1)",
@@ -3301,6 +3421,52 @@
                 }
               ],
               "name": "sendMessage"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#setContextGuard:member(1)",
+              "docComment": "/**\n * Set the mid-loop context guard (GENC-1567). `undefined` disables it.\n *\n * Carries a margin rather than an absolute threshold: the window belongs to whichever provider the next call resolves to, which the driver learns during the call and the host cannot know until afterwards. The host owns the policy; the driver applies it against the model actually being addressed. Optional — only drivers that own a tool loop implement it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setContextGuard?(policy?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ContextGuardPolicy",
+                  "canonicalReference": "@genesislcap/ai-assistant!ContextGuardPolicy:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "policy",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "setContextGuard"
             }
           ],
           "extendsTokenRanges": [
@@ -4250,7 +4416,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!ChatDriver:class",
-          "docComment": "/**\n * Plain TS class that drives a multi-turn chat conversation, including the tool-call loop. Owned by `FoundationAiAssistant` — created in `connectedCallback`, torn down in `disconnectedCallback`.\n *\n * Dispatches `'history-updated'` events on itself so the owning element can observe changes.\n *\n * @fires\n *\n * history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution, post-resolve external cost) with the full history snapshot. detail: `ReadonlyArray<ChatMessage>`\n *\n * @beta\n */\n",
+          "docComment": "",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4276,7 +4442,7 @@
             }
           ],
           "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "ChatDriver",
           "preserveMemberOrder": false,
@@ -4309,7 +4475,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4363,7 +4529,7 @@
                 "startIndex": 3,
                 "endIndex": 4
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4403,7 +4569,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4418,7 +4584,16 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "canCompact(): "
+                  "text": "canCompact(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Content",
@@ -4431,13 +4606,22 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
               "name": "canCompact"
@@ -4449,7 +4633,16 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "compact(): "
+                  "text": "compact(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
@@ -4476,13 +4669,22 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 5
+                "startIndex": 3,
+                "endIndex": 7
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
               "name": "compact"
@@ -4537,7 +4739,7 @@
                 "startIndex": 4,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4577,7 +4779,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4608,7 +4810,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4639,7 +4841,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4670,7 +4872,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4678,6 +4880,60 @@
               "isAbstract": false,
               "name": "getAgentReleaseRequested"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getCompactionPlan:member(1)",
+              "docComment": "/**\n * What compacting right now would cost and reclaim, without running the summarizer (GENC-1567) — or `null` when there is no safe cut, or the projected reclaim is not worth the call.\n *\n * The single source of truth for every compaction affordance: the menu's enabled state, its tooltip, the context gate's banner copy, and the action itself all read this, so none of them can promise a reclaim the action does not deliver. Optional — only history-owning drivers implement it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getCompactionPlan(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionProjection",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionProjection:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getCompactionPlan"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getExternalDiagnostics:member(1)",
@@ -4715,7 +4971,7 @@
                 "startIndex": 1,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4760,7 +5016,7 @@
                 "startIndex": 1,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4768,6 +5024,42 @@
               "isAbstract": false,
               "name": "getHistory"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistoryForPersistence:member(1)",
+              "docComment": "/**\n * The transcript as it should be **stored**: every tool payload the model has already stopped seeing replaced by the same stub it was sent (GENC-1566). Live history is untouched — this returns a copy.\n *\n * Condensation deliberately spares stored history, because the live transcript and the debug export both read it. A host writing that transcript to durable storage inherits the other half of that decision: it stores payloads the driver has already retired, on every autosave, for the life of the session. Measured on one small Create session — 58,187 chars, 7.4% of a 790 KB session object, across five payloads worth 14,434 tokens of context, written 86 times.\n *\n * Only already-collapsed payloads are touched, so this can never store a stub for something the model can still see, and it has no side effects (see `condenseForPersistence`, which is internal). A host that wants the unredacted transcript still calls {@link ChatDriver.getRawHistory}, and a diagnostics stream that keeps full payloads is unaffected — which is what makes the elision recoverable.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHistoryForPersistence(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getHistoryForPersistence"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getInteractionContext:member(1)",
@@ -4804,7 +5096,7 @@
                 "startIndex": 3,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4853,7 +5145,7 @@
                 "startIndex": 1,
                 "endIndex": 4
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4884,7 +5176,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4942,7 +5234,7 @@
                 "startIndex": 1,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5020,7 +5312,7 @@
                 "startIndex": 11,
                 "endIndex": 13
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5098,7 +5390,7 @@
                 "startIndex": 1,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5129,7 +5421,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5173,7 +5465,7 @@
                 "startIndex": 4,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5213,7 +5505,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5327,7 +5619,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5418,7 +5710,7 @@
                 "startIndex": 7,
                 "endIndex": 9
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5490,7 +5782,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5573,7 +5865,7 @@
                 "startIndex": 6,
                 "endIndex": 10
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5598,6 +5890,55 @@
               "isAbstract": false,
               "name": "sendMessage"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setContextGuard:member(1)",
+              "docComment": "/**\n * Set the mid-loop context guard. Its margin is deliberately far smaller than the reserve that blocks NEW turns: that reserve exists so an accepted turn can spend it, and a guard set at the same line would kill every turn that used the headroom it was given.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setContextGuard(policy?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ContextGuardPolicy",
+                  "canonicalReference": "@genesislcap/ai-assistant!ContextGuardPolicy:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "policy",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setContextGuard"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setHostInteractionRequester:member(1)",
@@ -5647,7 +5988,7 @@
                 "startIndex": 7,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5667,7 +6008,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setProviderHistoryTransform:member(1)",
-              "docComment": "/**\n * Optional transform applied to conversation history immediately before each LLM request. Cleared when `undefined`. Does not alter stored history.\n */\n",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5713,7 +6054,7 @@
                 "startIndex": 7,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -6190,28 +6531,54 @@
             },
             {
               "kind": "Content",
-              "text": "<"
-            },
-            {
-              "kind": "Reference",
-              "text": "ChatMessage",
-              "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatMessage",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
+          "releaseTag": "Beta",
+          "name": "ChatHistoryUpdatedEvent",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 7
+          }
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/ai-assistant!ContextReserveInput:type",
+          "docComment": "/**\n * Context headroom an agent reserves for itself, in tokens.\n *\n * A plain number, unlike the value-or-resolver shape `provider` / `temperature` / `resumable` use. The resolver form was drafted for it and removed before release: the gate is recomputed from a synchronous getter with no turn context to resolve against, so no path could ever have invoked one. Accepting a type-correct option that is guaranteed to do nothing is worse than not offering it — a warning after the fact still leaves the configuration inert.\n *\n * It can widen to a resolver later without breaking a caller, since every existing `number` stays valid.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ContextReserveInput = "
             },
             {
               "kind": "Content",
-              "text": ">>"
+              "text": "number"
             },
             {
               "kind": "Content",
               "text": ";"
             }
           ],
-          "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
+          "fileUrlPath": "src/config/config.ts",
           "releaseTag": "Beta",
-          "name": "ChatHistoryUpdatedEvent",
+          "name": "ContextReserveInput",
           "typeTokenRange": {
             "startIndex": 1,
-            "endIndex": 7
+            "endIndex": 2
           }
         },
         {
@@ -8149,7 +8516,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#compactable:member",
-              "docComment": "/**\n * Whether the menu's \"Compact\" action would do anything (GENC-1351 §5.7). Delegates to `driver.canCompact()` so the gate uses the exact same history `compact()` acts on — one source of truth. Also reads `messages`, purely to stay reactive as the conversation grows: the driver's history isn't a tracked observable, so the button keys its re-evaluation off the Redux mirror.\n */\n",
+              "docComment": "/**\n * Whether the menu's \"Compact\" action would do anything (GENC-1351 §5.7, GENC-1567). Delegates to the driver's plan so the gate uses the exact same history `compact()` acts on, judged against the same budget — one source of truth for both whether a cut is legal and whether it reclaims enough.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -8206,6 +8573,41 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#compactionPlan:member",
+              "docComment": "/**\n * What compacting right now would reclaim, or `null` when it would not be worth it (GENC-1567). Sized against {@link FoundationAiAssistant.contextBudget}, so the plan aims at this model's window rather than a fixed default.\n *\n * Reads `messages` to stay reactive as the conversation grows: the driver's history is not a tracked observable, so every consumer of this keys its re-evaluation off the Redux mirror.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get compactionPlan(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionProjection",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionProjection:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "compactionPlan",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#compactSession:member(1)",
@@ -8423,6 +8825,67 @@
               "isAbstract": false,
               "name": "connectedCallback"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextBudget:member",
+              "docComment": "/**\n * Context-headroom thresholds for the active model (GENC-1567) — the warning and block lines, plus the tail budget compaction aims at.\n *\n * The agent's own `contextReserve` is deliberately NOT folded in here. This is the AMBIENT budget, which protects any turn from any agent; a per-agent reserve is an additional, larger requirement checked when that agent takes ownership of a flow, where there is a turn context to resolve its function form against.\n *\n * Overhead is read off `messages` (the Redux mirror) rather than the driver's own history, which the compaction plan uses. That is safe rather than sloppy: `estimateSystemOverhead` only looks at messages BEFORE the first usage-bearing one, and the two lists agree completely that early — the drift between mirror and driver history is only ever at the tail.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextBudget(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ResolvedContextBudget",
+                  "canonicalReference": "@genesislcap/ai-assistant!~ResolvedContextBudget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextBudget",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGate:member",
+              "docComment": "/**\n * How close this conversation is to the model's context window (GENC-1567).\n *\n * **Derived, never latched** — the opposite of {@link FoundationAiAssistant.blocked}. A budget wall stays set because nothing the user does fixes it; this clears itself the moment the conversation shrinks, which is precisely what the user is being asked to do. The two must not be conflated: `blocked` is also deliberately preserved across `resetSession`, and a context gate obviously must not survive starting a new chat.\n *\n * **A flow in progress is never blocked, only warned.** Machine state lives outside the transcript, so a stateful flow is not desynced by compaction — but the summary can still drop detail the flow's own prompt leans on, and blocking mid-journey would strand the user between a flow they cannot finish and a compaction that is a poor idea right there. Letting the flow complete and gating on the way out is the lesser harm; the headroom reserve exists so this is rare rather than routine.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextGate(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "'ok' | 'warn' | 'blocked'"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextGate",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextLimit:member",
@@ -14772,11 +15235,20 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#canCompact:member(1)",
-              "docComment": "/**\n * Whether `compact()` would compact something right now — a summarizable run of older turns exists behind a clean boundary. The UI gates its \"Compact\" affordance on this, so the button reflects the exact history `compact()` acts on (GENC-1351). Optional — only history-owning drivers implement it.\n */\n",
+              "docComment": "/**\n * Whether `compact()` would compact something right now. Convenience over {@link AiDriver.getCompactionPlan} — prefer the plan where the caller needs to say how much would be reclaimed. Optional — only history-owning drivers implement it.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "canCompact(): "
+                  "text": "canCompact(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Content",
@@ -14789,13 +15261,22 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "releaseTag": "Beta",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
               "name": "canCompact"
@@ -14803,11 +15284,20 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#compact:member(1)",
-              "docComment": "/**\n * Destructively compact older conversation turns into a single `compacted-summary` message (GENC-1351 §5.7), summarizing them via the default provider's one-shot `prompt()`. Atomic: history changes only on success. Resolves to the created summary message, or `null` when there is nothing worth compacting or the provider cannot summarize. Optional — only drivers that own history implement it.\n */\n",
+              "docComment": "/**\n * Destructively compact older conversation turns into a single `compacted-summary` message (GENC-1351 §5.7), summarizing them via the default provider's one-shot `prompt()`. Atomic: history changes only on success. Resolves to the created summary message, or `null` when there is nothing worth compacting or the provider cannot summarize. Optional — only drivers that own history implement it.\n *\n * Pass the same `options` used for {@link AiDriver.getCompactionPlan} so the action does exactly what the affordance advertised.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "compact(): "
+                  "text": "compact(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
@@ -14834,13 +15324,22 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 5
+                "startIndex": 3,
+                "endIndex": 7
               },
               "releaseTag": "Beta",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
               "name": "compact"
@@ -15015,6 +15514,60 @@
               "isAbstract": false,
               "name": "getActiveProviderName"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getCompactionPlan:member(1)",
+              "docComment": "/**\n * What compacting right now would cost and reclaim, without running the summarizer (GENC-1567) — or `null` when there is no safe cut, or the projected reclaim is not worth the call.\n *\n * The single source of truth for every compaction affordance: the menu's enabled state, its tooltip, the context gate's banner copy, and the action itself all read this, so none of them can promise a reclaim the action does not deliver. Optional — only history-owning drivers implement it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getCompactionPlan(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionProjection",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionProjection:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getCompactionPlan"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getExternalDiagnostics:member(1)",
@@ -15060,6 +15613,42 @@
               "isAbstract": false,
               "name": "getExternalDiagnostics"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getHistoryForPersistence:member(1)",
+              "docComment": "/**\n * Delegates to the inner {@link ChatDriver} — condensation policies are registered there, so it is the only object that knows which payloads the model has stopped seeing (GENC-1566).\n *\n * **This forward is the whole feature, for any multi-agent host.** `AiDriver` declares `getHistoryForPersistence` optional, and `SessionPersister` calls it through `?.`, falling back to {@link OrchestratingDriver.getRawHistory}. This class does NOT extend `ChatDriver` — it wraps one — so without an explicit forward the optional call resolves to `undefined` and every host on an orchestrating driver silently keeps persisting the full payloads. Measured exactly that way on a Create run: 10 `context.condensed` events fired, and the session still stored the two largest `read_context` results at 26,907 and 23,060 chars. The method existed, the tests passed, and the feature did nothing.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHistoryForPersistence(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getHistoryForPersistence"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getInteractionContext:member(1)",
@@ -15657,6 +16246,55 @@
               "isAbstract": false,
               "name": "sendMessage"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#setContextGuard:member(1)",
+              "docComment": "/**\n * Set the mid-loop context guard (GENC-1567). `undefined` disables it.\n *\n * Carries a margin rather than an absolute threshold: the window belongs to whichever provider the next call resolves to, which the driver learns during the call and the host cannot know until afterwards. The host owns the policy; the driver applies it against the model actually being addressed. Optional — only drivers that own a tool loop implement it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setContextGuard(policy?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ContextGuardPolicy",
+                  "canonicalReference": "@genesislcap/ai-assistant!ContextGuardPolicy:interface"
+                },
+                {
+                  "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": "policy",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setContextGuard"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#setFlowOwner:member(1)",