@genesislcap/ai-assistant 15.19.0 → 15.19.1

package/src/components/chat-bubble/chat-bubble.template.ts

@@ -1,67 +0,0 @@
-import { html, ref, repeat, slotted, ViewTemplate, when } from '@genesislcap/web-core';
-import type { AiChatBubble } from './chat-bubble';
-
-const genesisIconTemplate = html`
-  <svg
-    viewBox="-4 0 30 26"
-    fill="none"
-    xmlns="http://www.w3.org/2000/svg"
-    style="width:60%;height:60%"
-  >
-    <path
-      d="M18.7702 23.0437C18.7702 22.4675 18.8526 21.8089 19.0995 21.3149C19.3465 20.7386 19.6758 20.2447 20.0874 19.833C20.4991 19.4214 20.993 19.0921 21.5693 18.8451C22.1456 18.5982 22.7219 18.5158 23.2981 18.5158H25.9326V11.6828H19.1819V14.3172C19.1819 15.5521 18.6879 16.7047 17.8647 17.5279C17.0414 18.3512 15.8888 18.8451 14.7363 18.9275H6.7507V6.99025H16.4651V0.157227H3.54C2.63442 0.157227 1.72884 0.568855 1.07023 1.22746C0.411628 1.88606 0 2.79165 0 3.77955V22.2205C0 23.1261 0.411628 24.0316 1.07023 24.7726C1.72884 25.4312 2.63442 25.8428 3.54 25.8428H18.7702V23.0437Z"
-      fill="currentColor"
-    />
-  </svg>
-`;
-
-export const AiChatBubbleTemplate = (): ViewTemplate<AiChatBubble> => {
-  return html<AiChatBubble>`
-    ${when(
-      (x) => !x.dialogOpen,
-      html<AiChatBubble>`
-        <div
-          class="bubble ${(x) => (x.hovered ? 'hovered' : '')}"
-          style="${(x) => `translate: ${x.bubbleLeft}px ${x.bubbleTop}px`}"
-          ${ref('bubbleEl')}
-          @mousedown="${(x, c) => x.onBubbleMouseDown(c.event as MouseEvent)}"
-          @mouseenter="${(x) => x.onBubbleMouseEnter()}"
-          @mouseleave="${(x) => x.onBubbleMouseLeave()}"
-        >
-          ${when(
-            (x) => !!x.imageSrc,
-            html<AiChatBubble>`
-              <img src="${(x) => x.imageSrc}" alt="AI" draggable="false" />
-            `,
-          )}
-          ${when((x) => !x.imageSrc, genesisIconTemplate)}
-          <div class="pulse-ring"></div>
-          <div class="tooltip" style="${(x) => x.tooltipStyle}" ${ref('tooltipEl')}>
-            ${(x) => x.title}
-          </div>
-        </div>
-      `,
-    )}
-    ${repeat(
-      // Pass the component instance as the sole array item so inner bindings
-      // can use x directly. recycle: false ensures a fresh element on every
-      // open, preventing stale .closing class or animationend listeners from
-      // a previous close persisting on the reused view.
-      (x) => (x.dialogOpen ? [x] : []),
-      html<AiChatBubble>`
-        <div
-          class="dialog"
-          style="${(x) =>
-            `translate: ${x.dialogLeft}px ${x.dialogTop}px; width: ${x.dialogWidth}px; height: ${x.dialogHeight}px`}"
-          @chat-header-mousedown="${(x, c) => x.onDialogHeaderMouseDown(c.event as CustomEvent)}"
-          ${ref('dialogEl')}
-        >
-          <div class="dialog-content">
-            <slot name="dialog-content" ${slotted('dialogContent')}></slot>
-          </div>
-        </div>
-      `,
-      { recycle: false },
-    )}
-  `;
-};

package/src/components/chat-bubble/chat-bubble.ts

@@ -1,436 +0,0 @@
-import { attr, customElement, GenesisElement, html, observable } from '@genesislcap/web-core';
-import { agenticActivityBus } from '../../channel/ai-activity-bus';
-import { styles } from './chat-bubble.styles';
-import { AiChatBubbleTemplate } from './chat-bubble.template';
-
-/** Default dimensions of the dialog panel */
-const DIALOG_DEFAULT_WIDTH = 400;
-const DIALOG_DEFAULT_HEIGHT = 520;
-
-/** Initial position: bubble starts this far from the right/bottom viewport edges */
-const BUBBLE_INITIAL_RIGHT_OFFSET = 90;
-
-/** Initial position: dialog starts this far from the right/bottom viewport edges */
-const DIALOG_INITIAL_RIGHT_OFFSET = 440;
-const DIALOG_INITIAL_BOTTOM_OFFSET = 570;
-
-/** Minimum distance the dialog is allowed from any viewport edge */
-const VIEWPORT_EDGE_MARGIN = 20;
-
-/** Minimum pointer movement (px) to classify an interaction as a drag rather than a click */
-const DRAG_THRESHOLD = 4;
-
-/** Keeps the bubble fully inside the viewport when dragged (accounts for bubble size + border) */
-const BUBBLE_DRAG_MARGIN = 64;
-
-/** Horizontal offset between bubble center and dialog left edge when toggling open/close */
-const DIALOG_BUBBLE_HORIZONTAL_OFFSET = 340;
-
-/** How far above the bubble the dialog opens */
-const DIALOG_OPEN_TOP_OFFSET = 470;
-
-/** How far below the dialog top the bubble snaps when closing via the X button */
-const BUBBLE_SNAP_BOTTOM_OFFSET = 458;
-
-/** Fallback tooltip width used before the element has been measured in the DOM */
-const TOOLTIP_FALLBACK_WIDTH = 155;
-
-/**
- * Floating chat bubble component that provides a draggable orb and dialog panel
- * for embedding an AI assistant without a full-page layout.
- *
- * @remarks
- * This component is optional — apps can use `foundation-ai-assistant` directly
- * in a layout panel instead, depending on their AI interaction flow.
- *
- * @beta
- */
-@customElement({
-  name: 'foundation-ai-chat-bubble',
-  template: html`
-    ${() => AiChatBubbleTemplate()}
-  `,
-  styles,
-})
-export class AiChatBubble extends GenesisElement {
-  @attr({ attribute: 'title' }) title: string = 'AI Assistant';
-  @attr({ attribute: 'image-src' }) imageSrc?: string;
-  @attr({ attribute: 'design-system-prefix' }) designSystemPrefix: string = 'rapid';
-
-  /** @internal */
-  @observable dialogContent: HTMLElement[] = [];
-  /** @internal */
-  @observable tooltipMeasuredWidth: number = 0;
-  /** Current left position of the bubble orb (px from viewport left). @internal */
-  @observable bubbleLeft: number = 0;
-  /** Current top position of the bubble orb (px from viewport top). @internal */
-  @observable bubbleTop: number = 0;
-  /** Current left position of the dialog panel (px from viewport left). @internal */
-  @observable dialogLeft: number = 0;
-  /** Current top position of the dialog panel (px from viewport top). @internal */
-  @observable dialogTop: number = 0;
-  /** Current rendered width of the dialog panel (px). @internal */
-  @observable dialogWidth: number = DIALOG_DEFAULT_WIDTH;
-  /** Current rendered height of the dialog panel (px). @internal */
-  @observable dialogHeight: number = DIALOG_DEFAULT_HEIGHT;
-  /** Whether the dialog panel is currently open. @internal */
-  @observable dialogOpen: boolean = false;
-  /** Whether the bubble orb is currently hovered. @internal */
-  @observable hovered: boolean = false;
-
-  /** @internal */
-  bubbleEl?: HTMLElement;
-  /** @internal */
-  tooltipEl?: HTMLElement;
-  /** @internal */
-  dialogEl?: HTMLElement;
-
-  private unsubBus?: () => void;
-  private injectedCloseBtn?: Element;
-  private resizeObserver?: ResizeObserver;
-  private dragging: boolean = false;
-  private dragTarget: 'bubble' | 'dialog' | null = null;
-  private startMouseX: number = 0;
-  private startMouseY: number = 0;
-  private startElemLeft: number = 0;
-  private startElemTop: number = 0;
-  private hasDragged: boolean = false;
-  private latestMouseX: number = 0;
-  private latestMouseY: number = 0;
-  private rafHandle?: number;
-  private closeAbort?: AbortController;
-
-  connectedCallback() {
-    super.connectedCallback();
-    this.bubbleLeft = window.innerWidth - BUBBLE_INITIAL_RIGHT_OFFSET;
-    this.bubbleTop = window.innerHeight - 100;
-    this.dialogLeft = Math.max(
-      VIEWPORT_EDGE_MARGIN,
-      window.innerWidth - DIALOG_INITIAL_RIGHT_OFFSET,
-    );
-    this.dialogTop = Math.max(
-      VIEWPORT_EDGE_MARGIN,
-      window.innerHeight - DIALOG_INITIAL_BOTTOM_OFFSET,
-    );
-    document.addEventListener('mousemove', this.onDocMouseMove);
-    document.addEventListener('mouseup', this.onDocMouseUp);
-    const unsubPopout = agenticActivityBus.subscribe('chat-popout', () => {
-      this.startCloseDialog();
-      this.hidden = true;
-    });
-    const unsubPopin = agenticActivityBus.subscribe('chat-popin', () => {
-      this.cancelClose();
-      this.hidden = false;
-      this.dialogOpen = true;
-    });
-    this.unsubBus = () => {
-      unsubPopout();
-      unsubPopin();
-    };
-    // Measure tooltip width once after first render. The bubble is visible on connect
-    // (dialogOpen starts false), so the element is in the DOM by the time rAF fires.
-    // This value persists through open/close cycles — no re-measurement needed unless
-    // the title attribute changes.
-    requestAnimationFrame(() => {
-      if (this.tooltipEl) this.tooltipMeasuredWidth = this.tooltipEl.offsetWidth;
-    });
-  }
-
-  onBubbleMouseEnter() {
-    this.hovered = true;
-    // Ensure we have a real measured width even on first-ever hover.
-    // The ref may not be available yet during connectedCallback's first rAF.
-    if (!this.tooltipMeasuredWidth) {
-      requestAnimationFrame(() => {
-        if (this.tooltipEl) this.tooltipMeasuredWidth = this.tooltipEl.offsetWidth;
-      });
-    }
-  }
-
-  onBubbleMouseLeave() {
-    this.hovered = false;
-  }
-
-  disconnectedCallback() {
-    super.disconnectedCallback();
-    document.removeEventListener('mousemove', this.onDocMouseMove);
-    document.removeEventListener('mouseup', this.onDocMouseUp);
-    this.unsubBus?.();
-    this.unsubBus = undefined;
-    this.injectedCloseBtn?.removeEventListener('click', this.onCloseBtnClick);
-    this.injectedCloseBtn?.remove();
-    this.injectedCloseBtn = undefined;
-    this.resizeObserver?.disconnect();
-    this.resizeObserver = undefined;
-    if (this.rafHandle !== undefined) {
-      cancelAnimationFrame(this.rafHandle);
-      this.rafHandle = undefined;
-    }
-    this.closeAbort?.abort();
-    this.closeAbort = undefined;
-  }
-
-  dialogOpenChanged(_: boolean, next: boolean) {
-    if (next) {
-      // Ensure we never observe a stale element from a prior open.
-      this.resizeObserver?.disconnect();
-      this.resizeObserver = undefined;
-      requestAnimationFrame(() => {
-        const el = this.dialogEl;
-        if (!el || !el.isConnected) return;
-
-        // Immediately sync actual size on open. This prevents cases where a stale
-        // ResizeObserver entry (or a not-yet-laid-out element) would temporarily
-        // drive the observables to 0 and shrink the dialog.
-        const w = el.offsetWidth;
-        const h = el.offsetHeight;
-        if (w > 0) this.dialogWidth = w;
-        if (h > 0) this.dialogHeight = h;
-
-        this.resizeObserver = new ResizeObserver((entries) => {
-          const entry = entries[0];
-          if (!entry) return;
-          const borderBox = (entry as ResizeObserverEntry).borderBoxSize?.[0] as
-            | { inlineSize: number; blockSize: number }
-            | undefined;
-          const nextW = Math.round(borderBox?.inlineSize ?? entry.contentRect.width);
-          const nextH = Math.round(borderBox?.blockSize ?? entry.contentRect.height);
-          if (nextW > 0) this.dialogWidth = nextW;
-          if (nextH > 0) this.dialogHeight = nextH;
-        });
-        this.resizeObserver.observe(el);
-      });
-    } else {
-      this.resizeObserver?.disconnect();
-      this.resizeObserver = undefined;
-    }
-  }
-
-  dialogContentChanged(_: HTMLElement[], next: HTMLElement[]) {
-    if (!next?.length || this.injectedCloseBtn) return;
-    for (const el of next) {
-      const assistant =
-        el.tagName.toLowerCase() === 'foundation-ai-assistant'
-          ? el
-          : el.shadowRoot?.querySelector('foundation-ai-assistant');
-      if (assistant) {
-        this.injectCloseButton(assistant);
-        break;
-      }
-    }
-  }
-
-  private injectCloseButton(assistant: Element) {
-    const prefix = this.designSystemPrefix;
-    const btn = document.createElement(`${prefix}-button`);
-    btn.setAttribute('slot', 'header-actions-extra');
-    btn.setAttribute('appearance', 'stealth');
-    btn.setAttribute('title', 'Close');
-    const icon = document.createElement(`${prefix}-icon`);
-    icon.setAttribute('name', 'times');
-    btn.appendChild(icon);
-    btn.addEventListener('click', this.onCloseBtnClick);
-    assistant.appendChild(btn);
-    this.injectedCloseBtn = btn;
-  }
-
-  onBubbleMouseDown(e: MouseEvent) {
-    e.preventDefault();
-    this.dragging = true;
-    this.dragTarget = 'bubble';
-    this.startMouseX = e.clientX;
-    this.startMouseY = e.clientY;
-    this.latestMouseX = e.clientX;
-    this.latestMouseY = e.clientY;
-    this.startElemLeft = this.bubbleLeft;
-    this.startElemTop = this.bubbleTop;
-    this.hasDragged = false;
-  }
-
-  onDialogHeaderMouseDown(e: CustomEvent<{ clientX: number; clientY: number }>) {
-    // Sync actual rendered size before dragging — the browser's CSS resize handle
-    // updates the element's size but our observables may not have caught up yet.
-    if (this.dialogEl) {
-      this.dialogWidth = this.dialogEl.offsetWidth;
-      this.dialogHeight = this.dialogEl.offsetHeight;
-    }
-    this.dragging = true;
-    this.dragTarget = 'dialog';
-    this.startMouseX = e.detail.clientX;
-    this.startMouseY = e.detail.clientY;
-    this.latestMouseX = e.detail.clientX;
-    this.latestMouseY = e.detail.clientY;
-    this.startElemLeft = this.dialogLeft;
-    this.startElemTop = this.dialogTop;
-    this.hasDragged = false;
-  }
-
-  private readonly onCloseBtnClick = () => this.onCloseDialog();
-
-  // Cancels an in-flight close animation and restores the dialog to its open state.
-  // Needed for the chat-popin case: startCloseDialog() may have been called (adding
-  // .closing and an animationend listener) but the host was hidden before the animation
-  // finished. When the host reappears via chat-popin, we cancel the pending close so
-  // the dialog stays open rather than disappearing once animationend eventually fires.
-  private cancelClose() {
-    this.closeAbort?.abort();
-    this.closeAbort = undefined;
-    this.dialogEl?.classList.remove('closing');
-  }
-
-  // Plays the closing animation before removing the dialog from the DOM.
-  // dialogOpen must stay true while the animation runs — setting it to false
-  // immediately would cause the repeat directive to remove the element before
-  // the animation has a chance to play. We only set dialogOpen = false inside
-  // the animationend callback, at which point FAST removes the element cleanly.
-  // If the user prefers reduced motion we skip the animation and close immediately.
-  private startCloseDialog() {
-    const reducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
-    if (!this.dialogEl || reducedMotion) {
-      this.dialogOpen = false;
-      return;
-    }
-    this.closeAbort = new AbortController();
-    this.dialogEl.classList.add('closing');
-    this.dialogEl.addEventListener(
-      'animationend',
-      () => {
-        this.dialogOpen = false;
-      },
-      {
-        once: true,
-        signal: this.closeAbort.signal,
-      },
-    );
-  }
-
-  // Capture the latest pointer coords and schedule one rAF per display frame.
-  // Pointer events can fire far faster than the display refreshes (up to 1000Hz on
-  // gaming mice), so we only store the coords here and let applyDragFrame do the
-  // actual work. If a frame is already scheduled we just overwrite the coords —
-  // the pending frame will pick up the freshest values when it runs.
-  private onDocMouseMove = (e: MouseEvent) => {
-    if (!this.dragging) return;
-    this.latestMouseX = e.clientX;
-    this.latestMouseY = e.clientY;
-    if (this.rafHandle === undefined) {
-      this.rafHandle = requestAnimationFrame(this.applyDragFrame);
-    }
-  };
-
-  // Runs once per display frame during a drag. Writes the new position directly to
-  // the element's style.translate rather than updating FAST observables, which keeps
-  // the compositor thread doing the work instead of triggering FAST's reactivity
-  // pipeline on every frame. This means the element's visual position is temporarily
-  // ahead of the observables — they are only synced back on mouseup (see onDocMouseUp).
-  // Note: style.translate is an independent CSS property and does not conflict with
-  // the transform used for the bubble's hover scale or the dialog's open animation.
-  private applyDragFrame = () => {
-    this.rafHandle = undefined;
-    const dx = this.latestMouseX - this.startMouseX;
-    const dy = this.latestMouseY - this.startMouseY;
-    if (Math.abs(dx) > DRAG_THRESHOLD || Math.abs(dy) > DRAG_THRESHOLD) this.hasDragged = true;
-    if (this.dragTarget === 'bubble') {
-      const left = Math.max(
-        0,
-        Math.min(window.innerWidth - BUBBLE_DRAG_MARGIN, this.startElemLeft + dx),
-      );
-      const top = Math.max(
-        0,
-        Math.min(window.innerHeight - BUBBLE_DRAG_MARGIN, this.startElemTop + dy),
-      );
-      if (this.bubbleEl) this.bubbleEl.style.translate = `${left}px ${top}px`;
-    } else if (this.dragTarget === 'dialog') {
-      const left = Math.max(
-        0,
-        Math.min(window.innerWidth - DIALOG_DEFAULT_WIDTH, this.startElemLeft + dx),
-      );
-      const top = Math.max(0, Math.min(window.innerHeight - 100, this.startElemTop + dy));
-      if (this.dialogEl) this.dialogEl.style.translate = `${left}px ${top}px`;
-    }
-  };
-
-  // Commits the final drag position back to the FAST observables, bringing them back
-  // in sync with what the user sees. This triggers a single FAST re-render which writes
-  // the same value already on the element — no visible jump. Any pending rAF is
-  // cancelled first; its work is redundant since we recompute from latestMouseX/Y here.
-  private onDocMouseUp = () => {
-    if (this.rafHandle !== undefined) {
-      cancelAnimationFrame(this.rafHandle);
-      this.rafHandle = undefined;
-    }
-    if (this.dragging) {
-      const dx = this.latestMouseX - this.startMouseX;
-      const dy = this.latestMouseY - this.startMouseY;
-      if (this.dragTarget === 'bubble') {
-        this.bubbleLeft = Math.max(
-          0,
-          Math.min(window.innerWidth - BUBBLE_DRAG_MARGIN, this.startElemLeft + dx),
-        );
-        this.bubbleTop = Math.max(
-          0,
-          Math.min(window.innerHeight - BUBBLE_DRAG_MARGIN, this.startElemTop + dy),
-        );
-        if (!this.hasDragged) {
-          if (this.dialogOpen) {
-            this.startCloseDialog();
-          } else {
-            this.dialogLeft = Math.max(
-              VIEWPORT_EDGE_MARGIN,
-              this.bubbleLeft - DIALOG_BUBBLE_HORIZONTAL_OFFSET,
-            );
-            this.dialogTop = Math.max(
-              VIEWPORT_EDGE_MARGIN,
-              this.bubbleTop - DIALOG_OPEN_TOP_OFFSET,
-            );
-            this.dialogOpen = true;
-          }
-        }
-      } else if (this.dragTarget === 'dialog') {
-        this.dialogLeft = Math.max(
-          0,
-          Math.min(window.innerWidth - DIALOG_DEFAULT_WIDTH, this.startElemLeft + dx),
-        );
-        this.dialogTop = Math.max(0, Math.min(window.innerHeight - 100, this.startElemTop + dy));
-      }
-    }
-    this.dragging = false;
-    this.dragTarget = null;
-  };
-
-  onPopout() {
-    this.startCloseDialog();
-  }
-
-  onCloseDialog() {
-    // Snap the bubble orb to the bottom-right of wherever the dialog currently is,
-    // so it reappears near where the user last positioned the window.
-    this.bubbleLeft = Math.max(
-      0,
-      Math.min(
-        window.innerWidth - BUBBLE_DRAG_MARGIN,
-        this.dialogLeft + DIALOG_BUBBLE_HORIZONTAL_OFFSET,
-      ),
-    );
-    this.bubbleTop = Math.max(
-      0,
-      Math.min(window.innerHeight - BUBBLE_DRAG_MARGIN, this.dialogTop + BUBBLE_SNAP_BOTTOM_OFFSET),
-    );
-    this.startCloseDialog();
-  }
-
-  get tooltipStyle(): string {
-    const tooltipWidth = this.tooltipMeasuredWidth || TOOLTIP_FALLBACK_WIDTH;
-    const bubbleWidth = 62; // Fixed in CSS
-    const margin = 8;
-    const naturalLeft = (bubbleWidth - tooltipWidth) / 2;
-    const vpLeft = this.bubbleLeft + naturalLeft;
-    const vpRight = vpLeft + tooltipWidth;
-    let shift = 0;
-    if (vpLeft < margin) shift = margin - vpLeft;
-    else if (vpRight > window.innerWidth - margin) shift = window.innerWidth - margin - vpRight;
-    const tooltipLeft = naturalLeft + shift;
-    const arrowLeft = bubbleWidth / 2 - tooltipLeft;
-    return `left: ${tooltipLeft}px; --arrow-left: ${arrowLeft}px`;
-  }
-}

package/src/components/chat-bubble/index.ts

@@ -1 +0,0 @@
-export * from './chat-bubble';

package/src/components/chat-driver/align-event-globals.ts

@@ -1,23 +0,0 @@
-/**
- * Test-only side effect: align the global `EventTarget` with jsdom's before any
- * module that `extends EventTarget` is evaluated.
- *
- * The node test runner's jsdom setup installs `globalThis.CustomEvent` from
- * jsdom but leaves `globalThis.EventTarget` as Node's native class. A class that
- * `extends EventTarget` (e.g. {@link ChatDriver}) then inherits Node's native
- * `dispatchEvent`, which rejects the jsdom `CustomEvent` instances it is handed
- * ("The 'event' argument must be an instance of Event. Received an instance of
- * CustomEvent"). Pointing `EventTarget` at jsdom's keeps the whole event family
- * in one realm.
- *
- * No-op in a real browser, where `window.EventTarget === globalThis.EventTarget`
- * already. Import this BEFORE importing anything that subclasses `EventTarget`.
- */
-const jsdomWindow = (globalThis as { window?: { EventTarget?: typeof EventTarget } }).window;
-if (jsdomWindow?.EventTarget && globalThis.EventTarget !== jsdomWindow.EventTarget) {
-  Object.defineProperty(globalThis, 'EventTarget', {
-    value: jsdomWindow.EventTarget,
-    configurable: true,
-    writable: true,
-  });
-}

package/src/components/chat-driver/chat-driver.compact.test.ts

@@ -1,131 +0,0 @@
-import type { AIProviderRegistry, ChatMessage } from '@genesislcap/foundation-ai';
-import { assert, createLogicSuite } from '@genesislcap/foundation-testing';
-// Side-effect import — MUST come before `./chat-driver` so the driver subclasses
-// jsdom's EventTarget rather than Node's native one (CustomEvent dispatch then
-// works). Mirrors `chat-driver.test.ts`.
-import './align-event-globals';
-import { ChatDriver } from './chat-driver';
-
-// GENC-1351 §5.7 — driver-level compaction: the atomic, destructive replace.
-// A minimal fake registry stands in for a provider, so no network is involved.
-
-const asMsg = (o: Record<string, unknown>): ChatMessage => o as unknown as ChatMessage;
-
-/** A registry whose default provider summarizes via `prompt` (undefined = unsupported). */
-function registryWith(prompt: ((m: string) => Promise<string>) | undefined): AIProviderRegistry {
-  const provider = { prompt, getStatus: async () => ({ model: 'test-model' }) };
-  return { default: () => provider } as unknown as AIProviderRegistry;
-}
-
-/** 10 messages alternating user/assistant (user at even indices); last carries usage. */
-function tenTurnHistory(): ChatMessage[] {
-  return Array.from({ length: 10 }, (_, i) =>
-    asMsg({
-      role: i % 2 === 0 ? 'user' : 'assistant',
-      content: `m${i}`,
-      timestamp: `2026-01-01T00:00:${String(i).padStart(2, '0')}.000Z`,
-      ...(i === 9 ? { inputTokens: 1234 } : {}),
-    }),
-  );
-}
-
-const Suite = createLogicSuite('chat-driver-compact');
-
-Suite('compact() destructively replaces older turns with one head summary + metadata', async () => {
-  const driver = new ChatDriver(registryWith(async () => 'THE SUMMARY'));
-  driver.loadHistory(tenTurnHistory());
-  const before = driver.getHistory().length;
-
-  const summary = await driver.compact();
-  assert.ok(summary, 'returns the created summary message');
-  assert.is(summary!.role, 'compacted-summary');
-  assert.is(summary!.content, 'THE SUMMARY');
-  assert.is(summary!.compaction?.tokensBefore, 1234, 'captures pre-compaction input tokens');
-  assert.is(summary!.compaction?.model, 'test-model', 'records the summarizing model');
-
-  const after = driver.getHistory();
-  assert.ok(after.length < before, 'history shrank (destructive)');
-  assert.is(after[0].role, 'compacted-summary', 'summary sits at the head');
-  assert.is(
-    after[0].timestamp,
-    '2026-01-01T00:00:00.000Z',
-    'summary inherits the covered region start → sorts to the head in time-ordered views',
-  );
-  assert.is(after[0].compaction?.compactedCount, before - (after.length - 1));
-  assert.ok(
-    after.slice(1).every((m) => m.role !== 'compacted-summary'),
-    'exactly one summary — no marker chain',
-  );
-});
-
-Suite('compact() is atomic on failure — no splice, surfaces a "sorry" message', async () => {
-  const driver = new ChatDriver(
-    registryWith(async () => {
-      throw new Error('network');
-    }),
-  );
-  const original = tenTurnHistory();
-  driver.loadHistory(original);
-
-  const result = await driver.compact();
-  assert.is(result, null, 'returns null on failure');
-  const after = driver.getHistory();
-  assert.ok(
-    after.every((m) => m.role !== 'compacted-summary'),
-    'nothing compacted',
-  );
-  // The covered turns are untouched (atomic); only a brief apology is appended so
-  // the user knows it failed (GENC-1351 follow-up — surfaced like a turn error).
-  assert.is(after.length, original.length + 1, 'only an apology appended');
-  assert.is(after[after.length - 1].role, 'assistant');
-  assert.ok(/sorry/i.test(after[after.length - 1].content), 'apology is an agent message');
-});
-
-Suite('compact() rolls a prior summary into a single fresh one', async () => {
-  const driver = new ChatDriver(registryWith(async () => 'COMBINED'));
-  driver.loadHistory([
-    asMsg({ role: 'compacted-summary', content: 'old', compaction: { compactedCount: 5 } }),
-    ...tenTurnHistory(),
-  ]);
-  const summary = await driver.compact();
-  assert.ok(summary);
-  const after = driver.getHistory();
-  assert.is(
-    after.filter((m) => m.role === 'compacted-summary').length,
-    1,
-    'still exactly one summary after re-compaction',
-  );
-  assert.is(after[0].content, 'COMBINED');
-});
-
-Suite('compact() no-ops when there is nothing worth compacting', async () => {
-  const driver = new ChatDriver(registryWith(async () => 'unused'));
-  driver.loadHistory([
-    asMsg({ role: 'user', content: 'hi' }),
-    asMsg({ role: 'assistant', content: 'yo' }),
-  ]);
-  assert.is(await driver.compact(), null);
-  assert.is(driver.getHistory().length, 2, 'short history untouched');
-});
-
-Suite('compact() no-ops when the default provider cannot summarize', async () => {
-  const driver = new ChatDriver(registryWith(undefined));
-  driver.loadHistory(tenTurnHistory());
-  assert.is(await driver.compact(), null);
-  assert.is(driver.getHistory().length, 10, 'history untouched without prompt support');
-});
-
-Suite("canCompact reflects compact()-would-act, keyed on the driver's own history", () => {
-  const rich = new ChatDriver(registryWith(async () => 'x'));
-  rich.loadHistory(tenTurnHistory());
-  assert.is(rich.canCompact(), true, 'enough history → gate open');
-
-  const thin = new ChatDriver(registryWith(async () => 'x'));
-  thin.loadHistory([
-    asMsg({ role: 'user', content: 'hi' }),
-    asMsg({ role: 'assistant', content: 'yo' }),
-  ]);
-  assert.is(thin.canCompact(), false, 'too short → gate closed (same source compact() uses)');
-});
-
-Suite.run();