@genesislcap/ai-assistant 15.19.6-GENC-1566.2 → 15.20.0

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"
             },
             {
@@ -2695,30 +2731,30 @@
             },
             {
               "kind": "MethodSignature",
-              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getExternalDiagnostics:member(1)",
-              "docComment": "/**\n * Diagnostic-log entries harvested from resolved interactions (e.g. a server-side ChatDriver's collated debug log, returned on `InteractionResult.diagnostics`). The host folds these into its debug log. Optional for the same leaf/orchestrator reason as `getTurnSnapshots`. (GENC-1461 unified diagnostics.)\n */\n",
+              "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": "getExternalDiagnostics?(): "
+                  "text": "getCompactionPlan?(options?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ReadonlyArray",
-                  "canonicalReference": "!ReadonlyArray:interface"
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "<"
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "DiagnosticEntry",
-                  "canonicalReference": "@genesislcap/ai-assistant!DiagnosticEntry:interface"
+                  "text": "CompactionProjection",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionProjection:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": ">"
+                  "text": " | null"
                 },
                 {
                   "kind": "Content",
@@ -2727,31 +2763,49 @@
               ],
               "isOptional": true,
               "returnTypeTokenRange": {
-                "startIndex": 1,
+                "startIndex": 3,
                 "endIndex": 5
               },
               "releaseTag": "Beta",
               "overloadIndex": 1,
-              "parameters": [],
-              "name": "getExternalDiagnostics"
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "getCompactionPlan"
             },
             {
               "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",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getExternalDiagnostics:member(1)",
+              "docComment": "/**\n * Diagnostic-log entries harvested from resolved interactions (e.g. a server-side ChatDriver's collated debug log, returned on `InteractionResult.diagnostics`). The host folds these into its debug log. Optional for the same leaf/orchestrator reason as `getTurnSnapshots`. (GENC-1461 unified diagnostics.)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getHistoryForPersistence?(): "
+                  "text": "getExternalDiagnostics?(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "[]"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "DiagnosticEntry",
+                  "canonicalReference": "@genesislcap/ai-assistant!DiagnosticEntry:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
                 },
                 {
                   "kind": "Content",
@@ -2761,12 +2815,12 @@
               "isOptional": true,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 5
               },
               "releaseTag": "Beta",
               "overloadIndex": 1,
               "parameters": [],
-              "name": "getHistoryForPersistence"
+              "name": "getExternalDiagnostics"
             },
             {
               "kind": "MethodSignature",
@@ -3334,6 +3388,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": [
@@ -4283,7 +4383,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",
@@ -4309,7 +4409,7 @@
             }
           ],
           "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "ChatDriver",
           "preserveMemberOrder": false,
@@ -4342,7 +4442,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4396,7 +4496,7 @@
                 "startIndex": 3,
                 "endIndex": 4
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4436,7 +4536,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4451,7 +4551,16 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "canCompact(): "
+                  "text": "canCompact(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Content",
@@ -4464,13 +4573,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"
@@ -4482,7 +4600,16 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "compact(): "
+                  "text": "compact(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
@@ -4509,13 +4636,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"
@@ -4570,7 +4706,7 @@
                 "startIndex": 4,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4610,7 +4746,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4641,7 +4777,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4672,7 +4808,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4703,7 +4839,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4713,30 +4849,30 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getExternalDiagnostics:member(1)",
-              "docComment": "/**\n * The `turn` + `message` diagnostic-log entries harvested from resolved interactions' `InteractionResult.diagnostics` (e.g. a server-side ChatDriver's collated debug log). The host concatenates these into its own debug log so `downloadDebugLog`/the persisted diagnostics stream include external-engine logs; `event` entries are excluded here because they're merged into the session's meta-event registry instead (see `resolveInteraction`) and reach the log via `getMetaEvents`. Opaque, chronologically sorted by the host at assemble time. (GENC-1461.)\n */\n",
+              "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": "getExternalDiagnostics(): "
+                  "text": "getCompactionPlan(options?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ReadonlyArray",
-                  "canonicalReference": "!ReadonlyArray:interface"
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "<"
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "DiagnosticEntry",
-                  "canonicalReference": "@genesislcap/ai-assistant!DiagnosticEntry:interface"
+                  "text": "CompactionProjection",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionProjection:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": ">"
+                  "text": " | null"
                 },
                 {
                   "kind": "Content",
@@ -4745,25 +4881,34 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
+                "startIndex": 3,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getExternalDiagnostics"
+              "name": "getCompactionPlan"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistory:member(1)",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getExternalDiagnostics:member(1)",
+              "docComment": "/**\n * The `turn` + `message` diagnostic-log entries harvested from resolved interactions' `InteractionResult.diagnostics` (e.g. a server-side ChatDriver's collated debug log). The host concatenates these into its own debug log so `downloadDebugLog`/the persisted diagnostics stream include external-engine logs; `event` entries are excluded here because they're merged into the session's meta-event registry instead (see `resolveInteraction`) and reach the log via `getMetaEvents`. Opaque, chronologically sorted by the host at assemble time. (GENC-1461.)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getHistory(): "
+                  "text": "getExternalDiagnostics(): "
                 },
                 {
                   "kind": "Reference",
@@ -4776,8 +4921,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "DiagnosticEntry",
+                  "canonicalReference": "@genesislcap/ai-assistant!DiagnosticEntry:interface"
                 },
                 {
                   "kind": "Content",
@@ -4793,22 +4938,31 @@
                 "startIndex": 1,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getHistory"
+              "name": "getExternalDiagnostics"
             },
             {
               "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",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistory:member(1)",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getHistoryForPersistence(): "
+                  "text": "getHistory(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
                 },
                 {
                   "kind": "Reference",
@@ -4817,7 +4971,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "[]"
+                  "text": ">"
                 },
                 {
                   "kind": "Content",
@@ -4827,15 +4981,15 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getHistoryForPersistence"
+              "name": "getHistory"
             },
             {
               "kind": "Method",
@@ -4873,7 +5027,7 @@
                 "startIndex": 3,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4922,7 +5076,7 @@
                 "startIndex": 1,
                 "endIndex": 4
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -4953,7 +5107,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5011,7 +5165,7 @@
                 "startIndex": 1,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5089,7 +5243,7 @@
                 "startIndex": 11,
                 "endIndex": 13
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5167,7 +5321,7 @@
                 "startIndex": 1,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5198,7 +5352,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5242,7 +5396,7 @@
                 "startIndex": 4,
                 "endIndex": 5
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5282,7 +5436,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -5396,7 +5550,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5487,7 +5641,7 @@
                 "startIndex": 7,
                 "endIndex": 9
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5559,7 +5713,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5630,7 +5784,64 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ">"
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 6,
+                "endIndex": 10
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "userInput",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "attachments",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 5
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "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",
@@ -5639,33 +5850,25 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 6,
-                "endIndex": 10
+                "startIndex": 3,
+                "endIndex": 4
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "userInput",
+                  "parameterName": "policy",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
                   },
-                  "isOptional": false
-                },
-                {
-                  "parameterName": "attachments",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 3,
-                    "endIndex": 5
-                  },
                   "isOptional": true
                 }
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "sendMessage"
+              "name": "setContextGuard"
             },
             {
               "kind": "Method",
@@ -5716,7 +5919,7 @@
                 "startIndex": 7,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -5736,7 +5939,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",
@@ -5782,7 +5985,7 @@
                 "startIndex": 7,
                 "endIndex": 8
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -6283,6 +6486,32 @@
             "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": "number"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Beta",
+          "name": "ContextReserveInput",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!CostSessionModelEntry:interface",
@@ -8218,7 +8447,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",
@@ -8275,6 +8504,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)",
@@ -8492,6 +8756,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",
@@ -14841,11 +15166,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",
@@ -14858,13 +15192,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"
@@ -14872,11 +15215,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",
@@ -14903,13 +15255,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"
@@ -15086,30 +15447,30 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getExternalDiagnostics:member(1)",
-              "docComment": "/**\n * Delegates to the inner {@link ChatDriver} — interactions resolve there, so it holds the buffer.\n */\n",
+              "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": "getExternalDiagnostics(): "
+                  "text": "getCompactionPlan(options?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ReadonlyArray",
-                  "canonicalReference": "!ReadonlyArray:interface"
+                  "text": "CompactionPlanOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionPlanOptions:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "<"
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "DiagnosticEntry",
-                  "canonicalReference": "@genesislcap/ai-assistant!DiagnosticEntry:interface"
+                  "text": "CompactionProjection",
+                  "canonicalReference": "@genesislcap/ai-assistant!~CompactionProjection:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": ">"
+                  "text": " | null"
                 },
                 {
                   "kind": "Content",
@@ -15118,34 +15479,52 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
+                "startIndex": 3,
                 "endIndex": 5
               },
               "releaseTag": "Beta",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getExternalDiagnostics"
+              "name": "getCompactionPlan"
             },
             {
               "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",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getExternalDiagnostics:member(1)",
+              "docComment": "/**\n * Delegates to the inner {@link ChatDriver} — interactions resolve there, so it holds the buffer.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getHistoryForPersistence(): "
+                  "text": "getExternalDiagnostics(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "[]"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "DiagnosticEntry",
+                  "canonicalReference": "@genesislcap/ai-assistant!DiagnosticEntry:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
                 },
                 {
                   "kind": "Content",
@@ -15155,7 +15534,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 5
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -15163,7 +15542,7 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getHistoryForPersistence"
+              "name": "getExternalDiagnostics"
             },
             {
               "kind": "Method",
@@ -15762,6 +16141,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)",