@genesislcap/ai-assistant 14.467.2 → 14.468.0-FUI-2555.2

package/dist/ai-assistant.d.ts

@@ -712,6 +712,40 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * sent to the model — stored `history` stays unchanged for UI and logging.
      */
     private providerHistoryTransform?;
+    /**
+     * Tool-declared condensation policies, keyed by tool-call id. Populated by
+     * `condenseWhen` (first-wins per call); read by `applyCondensation` before each
+     * provider call to collapse stale payloads from the model-bound history only.
+     * Accumulates across agents on a shared driver (a superseded read collapses no
+     * matter which agent made it) and is never cleared — it dies with the driver.
+     */
+    private readonly condensePolicies;
+    /**
+     * Monotonic model-call counter for the driver's whole lifetime — the age clock
+     * for `condenseWhen({ on: { kind: 'age' } })`. The per-`sendMessage` `iterations`
+     * loop counter resets to 0 every turn, so it can only measure age WITHIN a
+     * single turn; this never resets, so `age` counts model-calls since the result
+     * appeared across turn boundaries (each short turn still advances it ≥ 1).
+     * Bumped once per tool-loop iteration (provider call).
+     */
+    private modelCallSeq;
+    /**
+     * Monotonic turn counter — the `turnEnd` clock. Bumped once per `sendMessage`
+     * (a user turn; NOT per handoff continuation, which is the same request), never
+     * reset. `turnEnd` collapses a payload once `turnSeq` exceeds the turn it was
+     * created in.
+     */
+    private turnSeq;
+    /**
+     * Monotonic agent-activation counter — the `agentEnd` clock. Advances when the
+     * active flow ends: a swap to a different-named agent (`applyAgent`) OR an
+     * explicit `releaseAgent` / `completeSubAgent`. A stateful agent re-resolving
+     * the same name across turns keeps one activation. `agentEnd` fires for a
+     * payload once a LATER activation is current (`callActivation < currentActivation`)
+     * — so a re-run of a released agent gets a fresh activation and is NOT
+     * collapsed until IT ends.
+     */
+    private currentActivation;
     /** Stack of fold frames — grows when a fold opens, shrinks when it closes. */
     private foldStack;
     /** Consecutive fold open/close ops without a real tool call. Reset on real tool execution. */
@@ -1068,6 +1102,10 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * Centralised here so fold shortcut dispatch and the main tool loop use the
      * same context without duplication.
      *
+     * @param activeToolCallId - The id of the tool call this context belongs to, so
+     *   `condenseWhen` can register against the right call (it stamps the clocks
+     *   straight off the driver). Absent for dispatch paths with no addressable tool
+     *   call (e.g. the fold-close handler), where `condenseWhen` is a no-op.
      * @param traceCapture - Optional per-invocation slot. When provided, the trace
      *   from any sub-agent call is written here rather than to shared instance state,
      *   so parallel tool calls each capture their own trace independently.
@@ -1943,7 +1981,7 @@ declare type MetaEventImportance = 'high' | 'normal' | 'low';
  * Catalogue of meta event names. This is the documented surface — extend it as
  * new events are wired in (Tier 2/3 lifecycle, interaction, provider events).
  */
-declare type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'context.updated' | 'context.threshold-crossed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed';
+declare type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'context.updated' | 'context.threshold-crossed' | 'context.condensed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed';
 
 /**
  * Orchestrates multiple specialist agents. Sits between `FoundationAiAssistant`

package/dist/dts/components/chat-driver/chat-driver.d.ts

@@ -129,6 +129,40 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * sent to the model — stored `history` stays unchanged for UI and logging.
      */
     private providerHistoryTransform?;
+    /**
+     * Tool-declared condensation policies, keyed by tool-call id. Populated by
+     * `condenseWhen` (first-wins per call); read by `applyCondensation` before each
+     * provider call to collapse stale payloads from the model-bound history only.
+     * Accumulates across agents on a shared driver (a superseded read collapses no
+     * matter which agent made it) and is never cleared — it dies with the driver.
+     */
+    private readonly condensePolicies;
+    /**
+     * Monotonic model-call counter for the driver's whole lifetime — the age clock
+     * for `condenseWhen({ on: { kind: 'age' } })`. The per-`sendMessage` `iterations`
+     * loop counter resets to 0 every turn, so it can only measure age WITHIN a
+     * single turn; this never resets, so `age` counts model-calls since the result
+     * appeared across turn boundaries (each short turn still advances it ≥ 1).
+     * Bumped once per tool-loop iteration (provider call).
+     */
+    private modelCallSeq;
+    /**
+     * Monotonic turn counter — the `turnEnd` clock. Bumped once per `sendMessage`
+     * (a user turn; NOT per handoff continuation, which is the same request), never
+     * reset. `turnEnd` collapses a payload once `turnSeq` exceeds the turn it was
+     * created in.
+     */
+    private turnSeq;
+    /**
+     * Monotonic agent-activation counter — the `agentEnd` clock. Advances when the
+     * active flow ends: a swap to a different-named agent (`applyAgent`) OR an
+     * explicit `releaseAgent` / `completeSubAgent`. A stateful agent re-resolving
+     * the same name across turns keeps one activation. `agentEnd` fires for a
+     * payload once a LATER activation is current (`callActivation < currentActivation`)
+     * — so a re-run of a released agent gets a fresh activation and is NOT
+     * collapsed until IT ends.
+     */
+    private currentActivation;
     /** Stack of fold frames — grows when a fold opens, shrinks when it closes. */
     private foldStack;
     /** Consecutive fold open/close ops without a real tool call. Reset on real tool execution. */
@@ -485,6 +519,10 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * Centralised here so fold shortcut dispatch and the main tool loop use the
      * same context without duplication.
      *
+     * @param activeToolCallId - The id of the tool call this context belongs to, so
+     *   `condenseWhen` can register against the right call (it stamps the clocks
+     *   straight off the driver). Absent for dispatch paths with no addressable tool
+     *   call (e.g. the fold-close handler), where `condenseWhen` is a no-op.
      * @param traceCapture - Optional per-invocation slot. When provided, the trace
      *   from any sub-agent call is written here rather than to shared instance state,
      *   so parallel tool calls each capture their own trace independently.

package/dist/dts/components/chat-driver/chat-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"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"}

package/dist/dts/state/debug-event-log.d.ts

@@ -27,7 +27,7 @@
  * Catalogue of meta event names. This is the documented surface — extend it as
  * new events are wired in (Tier 2/3 lifecycle, interaction, provider events).
  */
-export type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'context.updated' | 'context.threshold-crossed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed';
+export type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'context.updated' | 'context.threshold-crossed' | 'context.condensed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed';
 /**
  * How much a reader should care about an event — lets a consumer (or an AI
  * agent) filter the timeline: skip `low` UI/bookkeeping noise, skim `normal`

package/dist/dts/state/debug-event-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug-event-log.d.ts","sourceRoot":"","sources":["../../../src/state/debug-event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAErB,qBAAqB,GACrB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,GAEjB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAEhB,eAAe,GACf,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GAEjB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GAEnB,uBAAuB,GACvB,sBAAsB,GAEtB,iBAAiB,GACjB,2BAA2B,GAE3B,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAgC5E,CAAC;AAEF,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,mBAAmB,CAAC;IAChC,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAmBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAyBN;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,yBAAyB,GACzB,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,CAAC;AAErB;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CA0BrF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAc7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
+{"version":3,"file":"debug-event-log.d.ts","sourceRoot":"","sources":["../../../src/state/debug-event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAErB,qBAAqB,GACrB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,GAEjB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAEhB,eAAe,GACf,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GAEjB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GAEnB,uBAAuB,GACvB,sBAAsB,GAEtB,iBAAiB,GACjB,2BAA2B,GAC3B,mBAAmB,GAEnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAiC5E,CAAC;AAEF,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,mBAAmB,CAAC;IAChC,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAmBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAyBN;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,yBAAyB,GACzB,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,CAAC;AAErB;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CA0BrF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAc7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/dts/utils/condense-history.d.ts

@@ -0,0 +1,115 @@
+import type { ChatMessage, CondensePolicy } from '@genesislcap/foundation-ai';
+/**
+ * Tool-context condensation: collapse stale tool payloads out of the history
+ * sent to the model, while leaving stored history untouched.
+ *
+ * The driver owns the registry (tool handlers populate it via `condenseWhen`)
+ * and the cadence (this runs before every provider call). This module owns the
+ * pure application: given the registry + the current loop iteration, produce a
+ * rewritten copy of the history with stale args/results replaced by stubs. Kept
+ * pure (no driver/session state, no logging) so it unit-tests in isolation —
+ * the one-time `context.condensed` signal is delivered via an `onCondensed`
+ * callback rather than reaching into the debug-event log directly.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Below this serialized size a tool payload isn't worth condensing — the stub
+ * would save little and cost a breadcrumb. A driver-level floor so the public
+ * `condenseWhen` API needs no per-policy threshold field.
+ */
+export declare const CONDENSE_MIN_CHARS = 1000;
+/** Key the collapsed args are stored under — a tool-call's args must stay a Record. */
+export declare const CONDENSED_ARGS_KEY = "condensed";
+/**
+ * A `condenseWhen` policy registered against a tool-call id, with its age clock
+ * and report-once flags. The driver holds these in a `Map<toolCallId, …>`;
+ * {@link applyCondensation} reads them and flips the `reported*` flags so the
+ * `context.condensed` signal fires once per payload, not once per provider call.
+ */
+export interface RegisteredCondensePolicy {
+    policy: CondensePolicy;
+    /**
+     * Monotonic model-call sequence (`modelCallSeq`) when `condenseWhen` was called
+     * — the origin of the age clock. Driver-lifetime and NOT reset per turn, so age
+     * is measured consistently across turn boundaries (the field name is historical;
+     * it is not the per-turn loop iteration).
+     */
+    iteration: number;
+    /** Turn (`sendMessage`) sequence when the call was made — the `turnEnd` clock. */
+    turn: number;
+    /** Agent-activation sequence when the call was made — the `agentEnd` clock. */
+    activation: number;
+    /** `context.condensed` already emitted for the args payload (fire-once). */
+    reportedArgs?: boolean;
+    /** `context.condensed` already emitted for the response payload (fire-once). */
+    reportedResponse?: boolean;
+}
+/**
+ * The driver's live state at the moment of a provider call — the clocks every
+ * trigger is evaluated against. Passed by the driver; kept as an interface so the
+ * transform stays a pure function of (history, policies, clocks).
+ */
+export interface CondenseContext {
+    /** Monotonic model-call sequence now — the `age` clock. */
+    modelCall: number;
+    /** Monotonic turn (`sendMessage`) sequence now — the `turnEnd` clock. */
+    turn: number;
+    /** Whether the agent activation that made a call has since ended — the `agentEnd` clock. */
+    activationEnded: (activation: number) => boolean;
+}
+/**
+ * Structured detail for a `context.condensed` meta-event. The index signature
+ * lets it satisfy `recordMetaEvent`'s `Record<string, unknown>` detail param
+ * while the named fields stay strictly typed.
+ */
+export interface CondensedEventDetail {
+    [key: string]: unknown;
+    /** Tool-loop iteration the collapsed call was made on. */
+    turn: number;
+    toolCallId: string;
+    tool: string;
+    target: 'args' | 'response';
+    /** Human-readable trigger, e.g. `superseded:Foo.tsx` or `age:3`. */
+    trigger: string;
+    /** Length of the replacement stub. */
+    stubLen: number;
+    /** Estimated input tokens saved this collapse (char/4 — no tokenizer in-stack). */
+    tokensSaved: number;
+}
+/**
+ * Collapse stale tool payloads (declared via `condenseWhen`) out of the
+ * model-bound history. Pure over the `history` array — it emits new message
+ * objects and never mutates the input messages (mirroring the agent-masking
+ * transform). It DOES, however, flip the `reported*` flag on the matching
+ * `policies` entry the first time a payload collapses — the report-once gate that
+ * keeps `onCondensed` firing once per (tool call, payload) even though the
+ * collapse itself re-runs before every provider call.
+ *
+ * Triggers (a policy may list several via `on: Trigger[]` — the FIRST to fire
+ * collapses the payload; all are monotonic, so the collapse never reverts):
+ * - `superseded` — among all registered calls sharing a `by` key, the LAST in
+ *   history order survives; every earlier one's targeted payload collapses. A
+ *   re-call with the same key becomes the new survivor and re-arms the rest.
+ * - `age` — the result is first visible one model-call after the call, so `turns`
+ *   is how many model-calls may see the full result before it collapses
+ *   (fires when `modelCall − callModelCall > turns`): `turns: 1` is seen once,
+ *   then collapses. The clock is monotonic across turns.
+ * - `turnEnd` — collapses once the turn (`sendMessage`) that made the call has
+ *   ended (fires when `turn > callTurn`): full for the rest of that request,
+ *   gone on every later one.
+ * - `agentEnd` — collapses once the agent activation that made the call has ended
+ *   (a swap to another agent, or `releaseAgent`/`completeSubAgent`): kept across
+ *   all of the agent's turns, dropped when its flow finishes.
+ *
+ * The tool-call/result envelope is never removed (providers reject orphaned
+ * calls/results) — only the args object or the result content is replaced.
+ *
+ * @param history - The to-model history copy to rewrite (not mutated).
+ * @param policies - The driver's registry, keyed by tool-call id. Its entries'
+ *   `reported*` flags are flipped as payloads first collapse.
+ * @param ctx - The driver's live clocks (model-call / turn / agent-activation).
+ * @param onCondensed - Invoked once per payload at its full→stub transition.
+ */
+export declare function applyCondensation(history: ChatMessage[], policies: Map<string, RegisteredCondensePolicy>, ctx: CondenseContext, onCondensed: (detail: CondensedEventDetail) => void): ChatMessage[];
+//# sourceMappingURL=condense-history.d.ts.map

package/dist/dts/utils/condense-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condense-history.d.ts","sourceRoot":"","sources":["../../../src/utils/condense-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAmB,MAAM,4BAA4B,CAAC;AAE/F;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAQ9C;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAClD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;CACrB;AA4CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAC/C,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,GAClD,WAAW,EAAE,CAoIf"}

package/dist/dts/utils/condense-history.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=condense-history.test.d.ts.map

package/dist/dts/utils/condense-history.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condense-history.test.d.ts","sourceRoot":"","sources":["../../../src/utils/condense-history.test.ts"],"names":[],"mappings":""}

package/dist/esm/components/chat-driver/chat-driver.js

@@ -3,6 +3,7 @@ import { isObservableAIProviderRegistry, MalformedFunctionCallError, } from '@ge
 import { agenticActivityBus } from '../../channel/ai-activity-bus';
 import { resolveChatProvider } from '../../config/validate-providers';
 import { clearSession, getMetaEvents, mergeMetaEvents, recordMetaEvent, recordTurnError, recordTurnRetry, } from '../../state/debug-event-log';
+import { applyCondensation } from '../../utils/condense-history';
 import { applyHistoryCap } from '../../utils/history-transform';
 import { logger } from '../../utils/logger';
 import { TOOL_FOLD_SYMBOL } from '../../utils/tool-fold';
@@ -75,6 +76,40 @@ export class ChatDriver extends EventTarget {
         /** Epoch ms when the current turn loop began — drives the `turn.end` duration. */
         this.turnStartedAt = 0;
         this.pendingInteractions = new Map();
+        /**
+         * Tool-declared condensation policies, keyed by tool-call id. Populated by
+         * `condenseWhen` (first-wins per call); read by `applyCondensation` before each
+         * provider call to collapse stale payloads from the model-bound history only.
+         * Accumulates across agents on a shared driver (a superseded read collapses no
+         * matter which agent made it) and is never cleared — it dies with the driver.
+         */
+        this.condensePolicies = new Map();
+        /**
+         * Monotonic model-call counter for the driver's whole lifetime — the age clock
+         * for `condenseWhen({ on: { kind: 'age' } })`. The per-`sendMessage` `iterations`
+         * loop counter resets to 0 every turn, so it can only measure age WITHIN a
+         * single turn; this never resets, so `age` counts model-calls since the result
+         * appeared across turn boundaries (each short turn still advances it ≥ 1).
+         * Bumped once per tool-loop iteration (provider call).
+         */
+        this.modelCallSeq = 0;
+        /**
+         * Monotonic turn counter — the `turnEnd` clock. Bumped once per `sendMessage`
+         * (a user turn; NOT per handoff continuation, which is the same request), never
+         * reset. `turnEnd` collapses a payload once `turnSeq` exceeds the turn it was
+         * created in.
+         */
+        this.turnSeq = 0;
+        /**
+         * Monotonic agent-activation counter — the `agentEnd` clock. Advances when the
+         * active flow ends: a swap to a different-named agent (`applyAgent`) OR an
+         * explicit `releaseAgent` / `completeSubAgent`. A stateful agent re-resolving
+         * the same name across turns keeps one activation. `agentEnd` fires for a
+         * payload once a LATER activation is current (`callActivation < currentActivation`)
+         * — so a re-run of a released agent gets a fresh activation and is NOT
+         * collapsed until IT ends.
+         */
+        this.currentActivation = 0;
         /** Stack of fold frames — grows when a fold opens, shrinks when it closes. */
         this.foldStack = [];
         /** Consecutive fold open/close ops without a real tool call. Reset on real tool execution. */
@@ -280,6 +315,12 @@ export class ChatDriver extends EventTarget {
      */
     applyAgent(config) {
         var _a, _b, _c;
+        // A real swap to a different agent begins a NEW activation — the prior agent's
+        // flow is over, so its `agentEnd`-tagged payloads become collapsible. Guarded
+        // on a name change so re-applying the same agent (e.g. a per-turn re-resolve)
+        // does not spuriously advance the clock and prematurely drop its payloads.
+        if (config.name !== this.activeAgentName)
+            this.currentActivation += 1;
         this.systemPrompt = config.systemPrompt;
         if (typeof config.toolDefinitions === 'function') {
             this.toolDefinitionsFactory = config.toolDefinitions;
@@ -873,6 +914,9 @@ export class ChatDriver extends EventTarget {
                 return { reason: 'done' };
             this.busy = true;
             this.beginTurn();
+            // A new user turn — advances the `turnEnd` clock (continuations after a
+            // handoff stay on the same turn; they go through `continueFromHistory`).
+            this.turnSeq += 1;
             this.subAgentCompletion = undefined;
             this.subAgentFailure = undefined;
             this.agentReleaseRequested = false;
@@ -918,11 +962,15 @@ export class ChatDriver extends EventTarget {
      * Centralised here so fold shortcut dispatch and the main tool loop use the
      * same context without duplication.
      *
+     * @param activeToolCallId - The id of the tool call this context belongs to, so
+     *   `condenseWhen` can register against the right call (it stamps the clocks
+     *   straight off the driver). Absent for dispatch paths with no addressable tool
+     *   call (e.g. the fold-close handler), where `condenseWhen` is a no-op.
      * @param traceCapture - Optional per-invocation slot. When provided, the trace
      *   from any sub-agent call is written here rather than to shared instance state,
      *   so parallel tool calls each capture their own trace independently.
      */
-    buildHandlerContext(traceCapture) {
+    buildHandlerContext(activeToolCallId, traceCapture) {
         return Object.assign(Object.assign({ requestInteraction: (componentName, data, options) => this.requestInteraction(componentName, data, options) }, (this.subAgentsMap.size > 0 && {
             requestSubAgent: (name, options) => this.invokeSubAgent(name, options).then(({ outcome, trace }) => {
                 if (traceCapture)
@@ -936,6 +984,9 @@ export class ChatDriver extends EventTarget {
                     return;
                 }
                 this.subAgentCompletion = { result };
+                // This activation's flow has ended — advance the clock so its
+                // `agentEnd` payloads collapse and a re-run starts a fresh activation.
+                this.currentActivation += 1;
             }, releaseAgent: () => {
                 var _a;
                 if (this.agentReleaseRequested) {
@@ -943,6 +994,42 @@ export class ChatDriver extends EventTarget {
                     return;
                 }
                 this.agentReleaseRequested = true;
+                // The stateful flow has wrapped up — advance the clock so its `agentEnd`
+                // payloads collapse and a re-run starts a fresh activation.
+                this.currentActivation += 1;
+            }, condenseWhen: (policy) => {
+                var _a, _b, _c;
+                // No addressable tool call (e.g. fold-close handler) — nothing to attach to.
+                if (!activeToolCallId)
+                    return;
+                if (!(policy === null || policy === void 0 ? void 0 : policy.args) && !(policy === null || policy === void 0 ? void 0 : policy.response)) {
+                    logger.warn(`ChatDriver(${(_a = this.activeAgentName) !== null && _a !== void 0 ? _a : 'unknown'}): condenseWhen called with neither args nor response — ignoring`);
+                    return;
+                }
+                const triggers = Array.isArray(policy.on) ? policy.on : [policy.on];
+                const validTrigger = (t) => (t === null || t === void 0 ? void 0 : t.kind) === 'superseded'
+                    ? typeof t.by === 'string' && t.by.length > 0
+                    : (t === null || t === void 0 ? void 0 : t.kind) === 'age'
+                        ? typeof t.turns === 'number' && t.turns >= 1
+                        : (t === null || t === void 0 ? void 0 : t.kind) === 'turnEnd' || (t === null || t === void 0 ? void 0 : t.kind) === 'agentEnd';
+                if (triggers.length === 0 || !triggers.every(validTrigger)) {
+                    logger.warn(`ChatDriver(${(_b = this.activeAgentName) !== null && _b !== void 0 ? _b : 'unknown'}): condenseWhen called with an invalid trigger — ignoring`);
+                    return;
+                }
+                // First-wins: a handler declares its policy once per call. A second
+                // declaration for the same tool call is a handler bug, not a refinement.
+                if (this.condensePolicies.has(activeToolCallId)) {
+                    logger.error(`ChatDriver(${(_c = this.activeAgentName) !== null && _c !== void 0 ? _c : 'unknown'}): condenseWhen called more than once for the same tool call — keeping the first policy, ignoring this one`);
+                    return;
+                }
+                // Stamp the three clocks NOW (read straight off the driver — the handler
+                // runs during the current model-call's tool batch).
+                this.condensePolicies.set(activeToolCallId, {
+                    policy,
+                    iteration: this.modelCallSeq,
+                    turn: this.turnSeq,
+                    activation: this.currentActivation,
+                });
             } });
     }
     /**
@@ -1251,7 +1338,7 @@ export class ChatDriver extends EventTarget {
         this.toolHandlers = newHandlers;
     }
     /** Open a fold: push a stack frame, swap the tool set, return the response message. */
-    openFold(foldName, fold, args) {
+    openFold(foldName, fold, args, activeToolCallId) {
         // Shortcut dispatch: model passed inner tool args directly, e.g.
         // trading_tools({ search_trades: { side: "BUY" } })
         for (const key of Object.keys(args)) {
@@ -1265,7 +1352,7 @@ export class ChatDriver extends EventTarget {
                 const innerArgs = typeof args[key] === 'object' && args[key] !== null
                     ? args[key]
                     : {};
-                return innerHandler(innerArgs, this.buildHandlerContext()).then((r) => typeof r === 'string' ? r : JSON.stringify(r));
+                return innerHandler(innerArgs, this.buildHandlerContext(activeToolCallId)).then((r) => typeof r === 'string' ? r : JSON.stringify(r));
             }
         }
         // Normal two-step open
@@ -1344,6 +1431,10 @@ export class ChatDriver extends EventTarget {
             let firstLlmCall = !!currentInput;
             while (iterations < this.maxToolIterations) {
                 iterations += 1;
+                // Monotonic across the driver's life — the age clock. Unlike `iterations`,
+                // it is NOT reset per turn and NOT decremented for folds, so `age` keeps
+                // counting model-calls once a turn ends. (See the `modelCallSeq` field.)
+                this.modelCallSeq += 1;
                 // A cancel (or dispose) that landed while the previous iteration's tool
                 // batch was running takes effect here — before issuing another LLM call.
                 // An abort during the call itself is handled by the catch below.
@@ -1412,9 +1503,19 @@ export class ChatDriver extends EventTarget {
                 const primer = [...((_b = this.primerHistory) !== null && _b !== void 0 ? _b : []), ...(transientPrimer !== null && transientPrimer !== void 0 ? transientPrimer : [])];
                 const baseHistory = firstLlmCall ? this.history.slice(0, -1) : this.history;
                 firstLlmCall = false;
+                // Collapse stale tool payloads this agent declared via `condenseWhen`, then
+                // pipe through any externally-set transform (e.g. multi-agent masking).
+                // Both run on a copy — stored history is untouched.
+                const condensedHistory = applyCondensation([...baseHistory], this.condensePolicies, {
+                    modelCall: this.modelCallSeq,
+                    turn: this.turnSeq,
+                    // A call's activation has ended once a later activation is current — a
+                    // swap or release/complete both advance the counter.
+                    activationEnded: (activation) => activation < this.currentActivation,
+                }, (detail) => recordMetaEvent(this.sessionKey, 'context.condensed', detail));
                 const historyForProvider = this.providerHistoryTransform
-                    ? this.providerHistoryTransform([...baseHistory])
-                    : baseHistory;
+                    ? this.providerHistoryTransform(condensedHistory)
+                    : condensedHistory;
                 const historyForCall = [...primer, ...historyForProvider];
                 const systemPrompt = malformedAttempts > 0
                     ? `${baseSystemPrompt !== null && baseSystemPrompt !== void 0 ? baseSystemPrompt : ''}\n\nIMPORTANT: Use only the structured function-call API to invoke tools. Do not write Python code or use Python-style syntax to call tools.`
@@ -1625,7 +1726,7 @@ export class ChatDriver extends EventTarget {
                                 });
                                 return;
                             }
-                            const content = yield this.openFold(tc.name, fold, tc.args);
+                            const content = yield this.openFold(tc.name, fold, tc.args, tc.id);
                             executedById.set(tc.id, { toolCallId: tc.id, content });
                             // Fold open/close does NOT count as a real iteration — decrement to compensate
                             iterations -= 1;
@@ -1736,7 +1837,7 @@ export class ChatDriver extends EventTarget {
                         // Real tool execution
                         try {
                             const traceCapture = {};
-                            const result = yield handler(tc.args, this.buildHandlerContext(traceCapture));
+                            const result = yield handler(tc.args, this.buildHandlerContext(tc.id, traceCapture));
                             const content = typeof result === 'string' ? result : JSON.stringify(result);
                             executedById.set(tc.id, {
                                 toolCallId: tc.id,