@genesislcap/ai-assistant 15.19.0 → 15.19.1

package/src/components/activity-halo/activity-halo.ts

@@ -1,106 +0,0 @@
-import { attr, customElement, GenesisElement, html, observable } from '@genesislcap/web-core';
-import { agenticActivityBus } from '../../channel/ai-activity-bus';
-
-const DEFAULT_MIN_SHOW_TIME = 600;
-
-/**
- * Wrapper component that shows an `<ai-halo-overlay>` when the AI assistant
- * is executing one of the declared tool names.
- *
- * @example
- * ```html
- * <ai-activity-halo tools="search_trades">
- *   <trades-grid></trades-grid>
- * </ai-activity-halo>
- * ```
- *
- * @beta
- */
-@customElement({
-  name: 'ai-activity-halo',
-  template: html`
-    <div class="wrapper">
-      <slot></slot>
-      <ai-halo-overlay aria-hidden="true" ?active="${(x) => x.haloActive}"></ai-halo-overlay>
-    </div>
-  `,
-  styles: `
-    :host {
-      display: contents;
-    }
-    .wrapper {
-      position: relative;
-      overflow: hidden;
-      border-radius: inherit;
-      height: 100%;
-      width: 100%;
-    }
-  `,
-})
-export class AiActivityHalo extends GenesisElement {
-  /** Comma-separated list of tool names this element reacts to. */
-  @attr tools: string = '';
-
-  /** Minimum time in ms the halo stays visible after activation. */
-  @attr({ attribute: 'min-show-time', converter: { fromView: Number, toView: String } })
-  minShowTime: number = DEFAULT_MIN_SHOW_TIME;
-
-  /** @internal */
-  @observable haloActive: boolean = false;
-
-  private unsubBus?: () => void;
-  private hideTimeout?: ReturnType<typeof setTimeout>;
-  private startTime: number = 0;
-
-  connectedCallback() {
-    super.connectedCallback();
-    const unsubStart = agenticActivityBus.subscribe('halo-start', ({ toolNames }) => {
-      const myTools = this.tools
-        .split(',')
-        .map((t) => t.trim())
-        .filter(Boolean);
-      if (myTools.length === 0 || toolNames.some((name) => myTools.includes(name))) {
-        this.activate();
-      }
-    });
-    const unsubStop = agenticActivityBus.subscribe('halo-stop', () => {
-      this.scheduleDeactivate();
-    });
-    this.unsubBus = () => {
-      unsubStart();
-      unsubStop();
-    };
-  }
-
-  disconnectedCallback() {
-    super.disconnectedCallback();
-    this.unsubBus?.();
-    this.unsubBus = undefined;
-    if (this.hideTimeout !== undefined) {
-      clearTimeout(this.hideTimeout);
-      this.hideTimeout = undefined;
-    }
-  }
-
-  private activate() {
-    if (this.hideTimeout !== undefined) {
-      clearTimeout(this.hideTimeout);
-      this.hideTimeout = undefined;
-    }
-    this.startTime = Date.now();
-    this.haloActive = true;
-  }
-
-  private scheduleDeactivate() {
-    const elapsed = Date.now() - this.startTime;
-    const remaining = this.minShowTime - elapsed;
-    if (remaining <= 0) {
-      this.haloActive = false;
-    } else {
-      this.hideTimeout = setTimeout(() => {
-        this.haloActive = false;
-        this.hideTimeout = undefined;
-      }, remaining);
-    }
-  }
-}

package/src/components/agent-picker/agent-picker.constants.ts

@@ -1,2 +0,0 @@
-/** Sentinel value representing "Auto" where a menu row needs a string value. */
-export const AGENT_PICKER_AUTO_VALUE = '__auto__';

package/src/components/agent-picker/agent-picker.styles.ts

@@ -1,24 +0,0 @@
-import { css } from '@genesislcap/web-core';
-import { menuItemStyles } from '../../styles/menu';
-
-export const styles = css`
-  :host {
-    display: block;
-  }
-
-  :host([hidden]) {
-    display: none;
-  }
-
-  /* The picker owns the ROWS only. The panel around them — surface, border,
-     shadow, position, open/close animation — is the assistant's, so the agent
-     menu and the session menu are the same object with different contents.
-     See the composer-menu rules in main.styles.ts. */
-  .menu {
-    display: flex;
-    flex-direction: column;
-    gap: 1px;
-  }
-
-  ${menuItemStyles}
-`;

package/src/components/agent-picker/agent-picker.template.ts

@@ -1,54 +0,0 @@
-import { html, repeat, ViewTemplate } from '@genesislcap/web-core';
-import type { AgentConfig } from '../../config/config';
-import type { AgentPicker } from './agent-picker';
-
-const AUTO_LABEL = 'Auto';
-const AUTO_HINT = 'Let the assistant route each message to the right agent.';
-
-/**
- * One selectable row. `menuitemradio` rather than `menuitem` because the choice
- * is single-select and sticky — a screen reader should announce which agent is
- * currently pinned, not just that a row is actionable.
- */
-const agentRowTemplate = html<AgentConfig, AgentPicker>`
-  <button
-    class="menu-item"
-    role="menuitemradio"
-    type="button"
-    aria-checked="${(a, c) => (c.parent.pinnedAgentName === a.name ? 'true' : 'false')}"
-    style="${(a, c) => c.parent.markStyleFor(a)}"
-    @click="${(a, c) => c.parent.selectAgent(a.name)}"
-  >
-    <span class="menu-item-mark" aria-hidden="true"></span>
-    <span class="menu-item-body">
-      <span class="menu-item-name">${(a) => a.name}</span>
-      ${(a) =>
-        a.manualSelection?.hint
-          ? html<AgentConfig>`
-              <span class="menu-item-hint">${(x) => x.manualSelection!.hint}</span>
-            `
-          : null}
-    </span>
-  </button>
-`;
-
-/** @internal */
-export const AgentPickerTemplate = (): ViewTemplate<AgentPicker> => html<AgentPicker>`
-  <div class="menu" role="menu" aria-label="Active agent" part="menu">
-    <button
-      class="menu-item menu-item-auto"
-      role="menuitemradio"
-      type="button"
-      aria-checked="${(x) => (x.pinnedAgentName === null ? 'true' : 'false')}"
-      @click="${(x) => x.selectAgent(null)}"
-    >
-      <span class="menu-item-mark" aria-hidden="true"></span>
-      <span class="menu-item-body">
-        <span class="menu-item-name">${() => AUTO_LABEL}</span>
-        <span class="menu-item-hint">${() => AUTO_HINT}</span>
-      </span>
-    </button>
-    <div class="menu-separator" role="separator"></div>
-    ${repeat((x) => x.selectableAgents, agentRowTemplate)}
-  </div>
-`;

package/src/components/agent-picker/agent-picker.ts

@@ -1,99 +0,0 @@
-import { customElement, GenesisElement, observable, volatile } from '@genesislcap/web-core';
-import type { AgentConfig } from '../../config/config';
-import type { AgentPickerMode } from '../../main/main.types';
-import { pinColourAt } from '../../styles/ai-colours';
-import { AGENT_PICKER_AUTO_VALUE } from './agent-picker.constants';
-import { styles } from './agent-picker.styles';
-import { AgentPickerTemplate } from './agent-picker.template';
-
-export { AGENT_PICKER_AUTO_VALUE };
-
-/**
- * The agent menu shown from the composer's agent button.
- *
- * Renders `Auto` plus each top-level agent with `manualSelection.enabled`, one
- * row apiece, tinted with the same pin colour the composer button shows once
- * that agent is pinned. Sub-agents and non-selectable specialists are excluded.
- * Hidden when fewer than two agents are configured or none are manually
- * selectable.
- *
- * The rows are all this element owns. The panel around them — surface, border,
- * position, open/close animation — belongs to the assistant, which renders this
- * menu and the session (⋮) menu into the same container so the two match.
- *
- * @fires agent-pinned - Fired when the user changes selection with the
- *   agent name or `null` for Auto. detail: `string | null`
- *
- * @beta
- */
-@customElement({
-  name: 'foundation-ai-agent-picker',
-  template: AgentPickerTemplate(),
-  styles,
-})
-export class AgentPicker extends GenesisElement {
-  /**
-   * Picker variant, sourced from the assistant's `chatConfig.picker.mode`.
-   * `'disabled'` hides the picker; every other value renders the same menu —
-   * `'select'` and `'segmented-control'` are retained so existing configuration
-   * stays valid, but no longer select between two layouts.
-   */
-  @observable mode: AgentPickerMode = 'disabled';
-  /** Top-level agents passed to the assistant. */
-  @observable agents: AgentConfig[] = [];
-  /** Currently pinned agent name, or `null` for Auto. */
-  @observable pinnedAgentName: string | null = null;
-  /** When true, rows show a neutral dot instead of the per-agent brand tint. */
-  @observable disablePinColours: boolean = false;
-
-  /** Top-level agents that opted in to manual selection. */
-  @volatile
-  get selectableAgents(): AgentConfig[] {
-    return (this.agents ?? []).filter((a) => a.manualSelection?.enabled);
-  }
-
-  /** Whether the picker should render at all. */
-  @volatile
-  get visible(): boolean {
-    if (this.mode === 'disabled') return false;
-    if ((this.agents?.length ?? 0) <= 1) return false;
-    if (this.selectableAgents.length === 0) return false;
-    return true;
-  }
-
-  /**
-   * Inline `--menu-item-mark` for one row, or `''` to leave the dot neutral.
-   *
-   * Indexed against the FULL agents array rather than `selectableAgents` so a
-   * row's tint matches what the composer button shows when that agent is
-   * pinned — the assistant resolves its pin colour the same way, and the two
-   * disagreeing is exactly the bug this shares `pinColourAt` to avoid.
-   */
-  markStyleFor(agent: AgentConfig): string {
-    if (this.disablePinColours) return '';
-    const colour = pinColourAt(this.agents?.findIndex((a) => a.name === agent.name) ?? -1);
-    return colour ? `--menu-item-mark: ${colour}` : '';
-  }
-
-  selectAgent(name: string | null): void {
-    this.pinnedAgentName = name;
-    // Always emit — the host closes the menu on click even when the selection
-    // didn't change.
-    this.$emit('agent-pinned', name);
-  }
-
-  /**
-   * Maps a value using {@link AGENT_PICKER_AUTO_VALUE} for Auto back to the
-   * `string | null` form {@link AgentPicker.selectAgent} expects. Retained for
-   * hosts driving the picker from a value rather than a name.
-   */
-  selectByValue(value: string): void {
-    this.selectAgent(value === AGENT_PICKER_AUTO_VALUE ? null : value);
-  }
-
-  /** Current pinned agent name as a bindable value. */
-  @volatile
-  get currentValue(): string {
-    return this.pinnedAgentName ?? AGENT_PICKER_AUTO_VALUE;
-  }
-}

package/src/components/agent-picker/index.ts

@@ -1 +0,0 @@
-export * from './agent-picker';

package/src/components/ai-driver/ai-driver.ts

@@ -1,166 +0,0 @@
-import type {
-  ChatAttachment,
-  ChatDriverResult,
-  ChatMessage,
-  ChatToolDefinition,
-} from '@genesislcap/foundation-ai';
-import type { AgentConfig } from '../../config/config';
-import type { DiagnosticEntry } from '../../state/persistence/diagnostics';
-import type { InteractionContext } from '../../types/interaction-context';
-import type { TurnSnapshot } from '../chat-driver/chat-driver';
-
-/** @internal */
-export interface AllAgentSummary {
-  name: string;
-  description: string;
-  tools: ChatToolDefinition[];
-}
-
-/**
- * Common interface implemented by both `ChatDriver` (single-agent) and
- * `OrchestratingDriver` (multi-agent). `FoundationAiAssistant` depends only
- * on this interface — the concrete class is chosen at startup based on how
- * many agents are configured.
- *
- * Extends `EventTarget` so consumers can subscribe to `history-updated` events
- * without knowing the concrete implementation.
- *
- * @beta
- */
-export interface AiDriver extends EventTarget {
-  /**
-   * Send a user message and run the tool loop to completion.
-   */
-  sendMessage(input: string, attachments?: ChatAttachment[]): Promise<ChatDriverResult>;
-
-  /**
-   * Continue the tool loop from the current history without appending a new
-   * user message. Used by `OrchestratingDriver` on agent handoffs — the
-   * handoff context is already in history; `transientPrimer` is injected as
-   * an invisible one-shot message for this call only.
-   */
-  continueFromHistory(transientPrimer?: ChatMessage[]): Promise<ChatDriverResult>;
-
-  /**
-   * Resolve a pending blocking interaction with the given result.
-   */
-  resolveInteraction(interactionId: string, result: unknown): void;
-  /**
-   * Record external spend against an interaction that has ALREADY resolved.
-   *
-   * For widgets that resolve early — so the assistant stops waiting — and then keep doing paid work
-   * on the user's behalf. Reports a positive DELTA; repeated calls sum. Returns false when the
-   * spend was NOT recorded — the value was not a positive finite amount, or the message is no
-   * longer in history.
-   *
-   * @beta
-   */
-  recordExternalCost?(interactionId: string, costUsd: number): boolean;
-
-  /**
-   * The live {@link InteractionContext} for a pending interaction (GENC-1390), or
-   * `undefined` if the interaction is resolved/evicted or the driver owns no
-   * interactions. Pierced by `AiChatInteractionWrapper` to build the widget's
-   * `interaction` descriptor. Optional — only interaction-owning drivers implement it.
-   */
-  getInteractionContext?(interactionId: string): InteractionContext | undefined;
-
-  /**
-   * Seed the driver's message history (called on state restore / pop-in).
-   */
-  loadHistory(messages: ChatMessage[]): void;
-
-  /**
-   * Prime per-agent restored state for a session being rehydrated. Each entry
-   * (keyed by agent name) is handed to that agent's `onActivate`/`init` as
-   * `ctx.restored` on its next activation, then consumed. Optional — only
-   * multi-agent drivers that own agent activation implement it.
-   */
-  primeRestoredAgentState?(snapshots: Record<string, unknown>): void;
-
-  /**
-   * Return the full, unredacted conversation history.
-   */
-  getRawHistory?(): readonly ChatMessage[];
-
-  /**
-   * The live `AgentConfig` currently active in the driver — the instance whose
-   * `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live
-   * state. Prefer this over looking the agent up in the host's `agents` array,
-   * which may mint fresh, never-activated configs. Optional — only drivers that
-   * retain the active config implement it.
-   */
-  getActiveAgent?(): AgentConfig | undefined;
-
-  /**
-   * 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.
-   */
-  compact?(): Promise<ChatMessage | null>;
-
-  /**
-   * 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.
-   */
-  canCompact?(): boolean;
-
-  /**
-   * Returns true if the driver is currently processing a request.
-   */
-  isBusy(): boolean;
-
-  /**
-   * Get query suggestions from the AI.
-   */
-  getSuggestions(
-    history: ChatMessage[],
-    prompt: string,
-    count: number,
-    allAgentInfo?: AllAgentSummary[],
-  ): Promise<string[]>;
-
-  /**
-   * Per-LLM-call snapshots — what the model saw each turn (prompt, tools,
-   * agent state). Used by the host's debug-log exporter. Optional because the
-   * interface is implemented by both leaf and orchestrating drivers; the
-   * orchestrator just delegates to its inner `ChatDriver`.
-   */
-  getTurnSnapshots?(): ReadonlyArray<TurnSnapshot>;
-
-  /**
-   * 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.)
-   */
-  getExternalDiagnostics?(): ReadonlyArray<DiagnosticEntry>;
-
-  /**
-   * Name of the AI provider used on the most recent turn. Falls back to the
-   * registry's default name when no turn has run yet.
-   *
-   * @beta
-   */
-  getActiveProviderName(): string;
-
-  /**
-   * Tear down the driver, aborting any in-flight provider request. Called by
-   * the host when it swaps in a replacement driver. Optional because not every
-   * implementation needs teardown; the host invokes it when present.
-   */
-  dispose?(): void | Promise<void>;
-
-  /**
-   * Stop the current turn in response to a user "stop" action. Aborts the
-   * in-flight provider request; a tool already executing runs to completion and
-   * the loop stops at the next boundary. The driver stays usable afterwards.
-   * Optional; the host wires the stop button to it when present.
-   */
-  cancel?(): void;
-}

package/src/components/ai-driver/index.ts

@@ -1 +0,0 @@
-export type { AiDriver } from './ai-driver';

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

@@ -1,194 +0,0 @@
-import { css } from '@genesislcap/web-core';
-
-export const styles = css`
-  :host {
-    position: fixed;
-    inset: 0;
-    pointer-events: none;
-    z-index: 9999;
-    overflow: visible;
-  }
-
-  :host([hidden]) {
-    display: none;
-  }
-
-  .bubble {
-    position: absolute;
-    width: 62px;
-    height: 62px;
-    border-radius: 50%;
-    cursor: grab;
-    pointer-events: all;
-    overflow: visible;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    user-select: none;
-    transition:
-      transform 0.25s cubic-bezier(0.34, 1.56, 0.64, 1),
-      box-shadow 0.25s ease;
-    background: linear-gradient(135deg, #0e1628 0%, #192340 100%);
-    box-shadow: 0 4px 20px rgb(0 0 0 / 45%);
-    border: 2px solid rgb(255 255 255 / 15%);
-    color: white;
-  }
-
-  .bubble img {
-    width: 62px;
-    height: 62px;
-    border-radius: 50%;
-    object-fit: cover;
-    pointer-events: none;
-    box-shadow: 0 4px 20px rgb(0 0 0 / 45%);
-    border: 2px solid rgb(255 255 255 / 15%);
-  }
-
-  .bubble svg {
-    pointer-events: none;
-  }
-
-  .bubble:hover,
-  .bubble.hovered {
-    transform: scale(1.18);
-  }
-
-  .bubble:hover img,
-  .bubble.hovered img {
-    box-shadow:
-      0 6px 32px rgb(0 100 255 / 55%),
-      0 0 0 3px rgb(0 120 255 / 35%);
-  }
-
-  .bubble:active {
-    cursor: grabbing;
-  }
-
-  .tooltip {
-    position: absolute;
-    bottom: calc(100% + 10px);
-    background: linear-gradient(135deg, #0078ff 0%, #0050d0 100%);
-    color: #fff;
-    font-size: 0.78em;
-    font-weight: 600;
-    letter-spacing: 0.03em;
-    white-space: nowrap;
-    padding: 5px 10px;
-    border-radius: 8px;
-    box-shadow: 0 4px 14px rgb(0 120 255 / 45%);
-    pointer-events: none;
-    opacity: 0%;
-    translate: 0 4px;
-    transition:
-      opacity 0.18s ease,
-      translate 0.18s ease;
-  }
-
-  .tooltip::after {
-    content: '';
-    position: absolute;
-    top: 100%;
-    left: var(--arrow-left, 50%);
-    transform: translateX(-50%);
-    border: 5px solid transparent;
-    border-top-color: #0050d0;
-  }
-
-  .bubble:hover .tooltip,
-  .bubble.hovered .tooltip {
-    opacity: 100%;
-    translate: 0 0;
-  }
-
-  .pulse-ring {
-    position: absolute;
-    width: 62px;
-    height: 62px;
-    border-radius: 50%;
-    border: 2px solid rgb(0 120 255 / 50%);
-    animation: pulse 2.5s ease-out infinite;
-    pointer-events: none;
-  }
-
-  @keyframes pulse {
-    0% {
-      transform: scale(1);
-      opacity: 70%;
-    }
-
-    70% {
-      transform: scale(1.5);
-      opacity: 0%;
-    }
-
-    100% {
-      transform: scale(1.5);
-      opacity: 0%;
-    }
-  }
-
-  .dialog {
-    position: absolute;
-    box-sizing: border-box;
-    width: 400px;
-    height: 520px;
-    min-width: 300px;
-    min-height: 300px;
-    max-width: 50vw;
-    max-height: calc(100vh - 40px);
-    background: var(--neutral-layer-1);
-    border-radius: 14px;
-    box-shadow:
-      0 12px 50px rgb(0 0 0 / 55%),
-      0 0 0 1px rgb(255 255 255 / 6%);
-    pointer-events: all;
-    display: flex;
-    flex-direction: column;
-    overflow: hidden;
-    resize: both;
-    border: 1px solid var(--neutral-stroke-rest);
-    animation: dialog-in 0.25s cubic-bezier(0.34, 1.56, 0.64, 1);
-  }
-
-  @keyframes dialog-in {
-    from {
-      opacity: 0%;
-      transform: scale(0.85) translateY(12px);
-    }
-
-    to {
-      opacity: 100%;
-      transform: scale(1) translateY(0);
-    }
-  }
-
-  @keyframes dialog-out {
-    from {
-      opacity: 100%;
-      transform: scale(1) translateY(0);
-    }
-
-    to {
-      opacity: 0%;
-      transform: scale(0.85) translateY(12px);
-    }
-  }
-
-  .dialog.closing {
-    animation: dialog-out 0.2s cubic-bezier(0.4, 0, 0.6, 1) forwards;
-  }
-
-  .dialog-content {
-    flex: 1;
-    overflow: hidden;
-    display: flex;
-    min-height: 0;
-  }
-
-  .dialog-content ::slotted(*) {
-    display: flex;
-    flex: 1;
-    width: 100%;
-    min-height: 0;
-  }
-`;