@genesislcap/ai-assistant 15.34.1 → 15.35.1-GENC-1632.1

package/dist/ai-assistant.api.json

@@ -3447,6 +3447,65 @@
               ],
               "name": "getCompactionPlan"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getCondensePoliciesForPersistence:member(1)",
+              "docComment": "/**\n * The `condenseWhen` policies that have NOT fired yet, for the tool calls in `messages` — the transcript being persisted — in a clock-independent form a later {@link AiDriver.restoreCondensePolicies} can re-register (GENC-1632). The companion of {@link AiDriver.getHistoryForPersistence}: that stores already-collapsed payloads as stubs; this keeps the not-yet-collapsed ones collapsible across a reload, where they would otherwise ride every provider call for the rest of the session. Optional, like its companion — a driver without condensation has none.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getCondensePoliciesForPersistence?(messages: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PersistedCondensePolicy",
+                  "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "messages",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "getCondensePoliciesForPersistence"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getContextReserve:member(1)",
@@ -4070,6 +4129,51 @@
               ],
               "name": "resolveInteraction"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#restoreCondensePolicies:member(1)",
+              "docComment": "/**\n * Re-register policies from {@link AiDriver.getCondensePoliciesForPersistence} against a restored transcript (GENC-1632). Call after {@link AiDriver.loadHistory}: entries whose tool call is not in the loaded history are dropped. Tolerates `undefined` and malformed entries (an older or damaged snapshot), which are ignored.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreCondensePolicies?(entries: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly unknown[] | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "entries",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "restoreCondensePolicies"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#sendMessage:member(1)",
@@ -5798,6 +5902,68 @@
               "isAbstract": false,
               "name": "getCompactionPlan"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getCondensePoliciesForPersistence:member(1)",
+              "docComment": "/**\n * The `condenseWhen` policies that have not fired yet, for the calls in `messages`, in the clock-independent form {@link ChatDriver.restoreCondensePolicies} re-registers. See {@link AiDriver.getCondensePoliciesForPersistence}.\n *\n * The other half of {@link ChatDriver.getHistoryForPersistence} (GENC-1632). That stores the payloads the model has already stopped seeing as their stubs; this stores the policies for the ones it has NOT stopped seeing yet, so a reload does not strand them at full size for the rest of the session. Only entries whose call is in `messages` — the transcript actually being written — are returned, so a frozen (non-resumable) or compacted save carries no policy for a call it does not contain.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getCondensePoliciesForPersistence(messages: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PersistedCondensePolicy",
+                  "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "messages",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getCondensePoliciesForPersistence"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getExternalDiagnostics:member(1)",
@@ -6804,6 +6970,54 @@
               "isAbstract": false,
               "name": "resolveInteraction"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#restoreCondensePolicies:member(1)",
+              "docComment": "/**\n * Re-register policies saved by {@link ChatDriver.getCondensePoliciesForPersistence} against the restored transcript. See {@link AiDriver.restoreCondensePolicies}.\n *\n * Call AFTER {@link ChatDriver.loadHistory} has seeded the restored transcript: an entry is re-registered only if its tool call is in the driver's history, so one whose call the restorable-boundary trim cut away (an orphaned trailing `tool_use`) is dropped rather than resurrected against nothing.\n *\n * First-wins still holds per call: an entry is skipped if a policy is already registered for its tool call — a restore never overrides what a live handler declared. `superseded` needs no special handling — survivors are resolved from HISTORY order on every pass, so a restored entry and a later call on the same `by` key resolve exactly as two live ones would.\n *\n * Clocks are rebased so each trigger is exactly as far from firing as it was at save time (see `rebaseRestoredCondensePolicy`), with one deferral. An entry owned by the activation that was live at save time, whose agent is not the one installed right now — the normal case on a fresh page, where nothing is installed yet — is parked in `condenseAwaitingReactivation` and stamped by the next `installAgent`: with that agent's resumed activation if it is the same agent, or left behind (so it reads as ended, which it has) if a different agent took over.\n *\n * A host with no agent to re-activate (a bare driver built from a static config) loses nothing by this: the entry's owner (`undefined`) matches the installed agent (`undefined`), so it is stamped live straight away and ends when the driver's single activation does — on `releaseAgent` / `completeSubAgent`, exactly as a policy registered live would.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreCondensePolicies(entries: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly unknown[] | undefined"
+                },
+                {
+                  "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": "entries",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "restoreCondensePolicies"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#sendMessage:member(1)",
@@ -17894,6 +18108,68 @@
               "isAbstract": false,
               "name": "getCompactionPlan"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getCondensePoliciesForPersistence:member(1)",
+              "docComment": "/**\n * Delegates to the inner {@link ChatDriver}, which owns the condensation registry and clocks (GENC-1632). The forward matters for the same reason as `getHistoryForPersistence` above: the persister reaches it through `?.`, so a missing forward would compile, pass the ChatDriver tests, and do nothing for every orchestrated host — which is every host with an agents array.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getCondensePoliciesForPersistence(messages: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PersistedCondensePolicy",
+                  "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "messages",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getCondensePoliciesForPersistence"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getContextReserve:member(1)",
@@ -18556,6 +18832,54 @@
               "isAbstract": false,
               "name": "resolveInteraction"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#restoreCondensePolicies:member(1)",
+              "docComment": "/**\n * Delegates to the inner {@link ChatDriver} (GENC-1632). The deferred activation stamp it performs is taken by the inner driver's `installAgent`, which this driver's own `installAgent` always reaches, so nothing extra is needed here.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreCondensePolicies(entries: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly unknown[] | undefined"
+                },
+                {
+                  "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": "entries",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "restoreCondensePolicies"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#sendMessage:member(1)",
@@ -18823,6 +19147,133 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy:interface",
+          "docComment": "/**\n * A `condenseWhen` policy that had NOT fired when the session was saved, in the shape it is persisted in (GENC-1632).\n *\n * The clocks are stored as **elapsed counts, never raw values**, and that is the whole design. All four driver clocks restart at 0 on a page reload, so a raw stamp means nothing to the driver that reads it back, and it is wrong in whichever direction the arithmetic happens to fall. A phase epoch of 1 restored against a fresh driver's 0 needs TWO `endPhase()` calls to fire, so the Planning-phase document it guards is never shed at the end of Planning; an activation stamp that lands below the fresh driver's clock reads as \"a later activation began\" — the `agentEnd` trigger — and collapses the payload on the first provider call after the reload, mid-phase. \"How far each clock had moved past the call when it was saved\" survives any reset, because it is re-applied relative to whatever the new driver's clocks happen to read.\n *\n * Only unfired entries are persisted: a fired one has already been rendered into the stored transcript as the stub the model was sent (GENC-1566), so there is nothing left for it to do.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface PersistedCondensePolicy "
+            }
+          ],
+          "fileUrlPath": "src/utils/condense-history.ts",
+          "releaseTag": "Public",
+          "name": "PersistedCondensePolicy",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy#agent:member",
+              "docComment": "/**\n * Name of the agent whose activation made the call; absent on a driver with no installed agent.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "agent?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "agent",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy#elapsed:member",
+              "docComment": "/**\n * How far each clock had advanced past the call's stamp at save time. `0` means \"still the current one\": the call's turn / activation / phase was the live one when the session was saved. A positive count means that boundary had already passed, so the trigger keyed on it fires on the first provider call after restore (it would have fired on the next call anyway; it only had not been latched because no call had happened since).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "elapsed: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        modelCalls: number;\n        turns: number;\n        activations: number;\n        phases: number;\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "elapsed",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy#policy:member",
+              "docComment": "/**\n * The policy exactly as the tool declared it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "policy: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CondensePolicy",
+                  "canonicalReference": "@genesislcap/foundation-ai!CondensePolicy:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "policy",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy#toolCallId:member",
+              "docComment": "/**\n * The tool call the policy is registered against.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "toolCallId: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "toolCallId",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!PersistedSession:interface",
@@ -18951,6 +19402,38 @@
                 "endIndex": 3
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!PersistedSession#condensePolicies:member",
+              "docComment": "/**\n * `condenseWhen` policies that had not fired yet when the session was saved, for tool calls in {@link PersistedSession.messages} (GENC-1632). Handed back to the driver on restore so those payloads still collapse when their trigger fires, instead of riding every provider call for the rest of the resumed session at full size. Payloads that HAD already collapsed need no entry: `messages` already stores them as the stubs the model was sent (GENC-1566).\n *\n * Optional and additive, so the schema `version` is unchanged: a snapshot written before this field existed restores exactly as it always did (nothing to re-register), and a reader that predates it ignores it. Omitted rather than written empty when there is nothing to carry.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "condensePolicies?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PersistedCondensePolicy",
+                  "canonicalReference": "@genesislcap/ai-assistant!PersistedCondensePolicy:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "condensePolicies",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!PersistedSession#contextLimit:member",