@mrclrchtr/supi-code-intelligence 4.6.0 → 4.8.0

package/node_modules/@mrclrchtr/supi-core/src/context/context-messages.ts

@@ -1,119 +0,0 @@
-// Shared context-message utilities for SuPi extensions.
-//
-// Provides a generic prune-and-reorder pattern for extensions that inject
-// managed context messages (via `before_agent_start` with a `customType` and
-// `contextToken`) and maintain them via the `context` event.
-
-/**
- * Minimal message shape needed for context-message operations.
- * Extensions cast their event.messages entries to this type.
- */
-export type ContextMessageLike = {
-  role?: string;
-  customType?: string;
-  content?: unknown;
-  details?: unknown;
-};
-
-/**
- * Extract the `contextToken` string from a message's `details` object.
- * Returns `null` when the token is absent or not a string.
- */
-export function getContextToken(details: unknown): string | null {
-  if (!details || typeof details !== "object") return null;
-  const token = (details as { contextToken?: unknown }).contextToken;
-  return typeof token === "string" ? token : null;
-}
-
-/**
- * Find the index of the last message with `role: "user"`.
- * Returns `-1` when no user message exists.
- */
-export function findLastUserMessageIndex<T extends ContextMessageLike>(messages: T[]): number {
-  for (let index = messages.length - 1; index >= 0; index--) {
-    if (messages[index]?.role === "user") return index;
-  }
-  return -1;
-}
-
-/**
- * Filter stale context messages and reorder the active one before the last user message.
- *
- * - Removes all messages matching `customType` whose token differs from `activeToken`.
- * - When `activeToken` is `null`, removes **all** messages of that `customType`.
- * - If the active context message is after the last user message, moves it before.
- *
- * Returns the modified array, or the original reference when no changes were needed.
- */
-export function pruneAndReorderContextMessages<T extends ContextMessageLike>(
-  messages: T[],
-  customType: string,
-  activeToken: string | null,
-): T[] {
-  // Remove stale messages of the target customType
-  const filtered = messages.filter((message) => {
-    if (message.customType !== customType) return true;
-    if (!activeToken) return false;
-    return getContextToken(message.details) === activeToken;
-  });
-
-  if (!activeToken) return filtered;
-
-  // Find the active context message
-  const contextIndex = filtered.findIndex(
-    (message) =>
-      message.customType === customType && getContextToken(message.details) === activeToken,
-  );
-  if (contextIndex === -1) return filtered;
-
-  // Find the last user message
-  const userIndex = findLastUserMessageIndex(filtered);
-  if (userIndex === -1 || contextIndex < userIndex) return filtered;
-
-  // Move context message before last user message
-  const next = [...filtered];
-  const [contextMessage] = next.splice(contextIndex, 1);
-  if (!contextMessage) return filtered;
-  next.splice(userIndex, 0, contextMessage);
-  return next;
-}
-
-/**
- * Restore the raw prompt content on a context message that was swapped for display text.
- *
- * Extensions using `registerMessageRenderer` store their LLM-facing content in
- * `details.promptContent` and put a human-readable summary in `content`. This function
- * reverses the swap so the model sees the original prompt content.
- *
- * Returns the original array reference when no change is needed.
- */
-export function restorePromptContent<T extends ContextMessageLike>(
-  messages: T[],
-  customType: string,
-  activeToken: string | null,
-): T[] {
-  if (!activeToken) return messages;
-
-  const index = messages.findIndex(
-    (message) =>
-      message.customType === customType && getContextToken(message.details) === activeToken,
-  );
-  if (index === -1) return messages;
-
-  const promptContent = getPromptContent(messages[index]?.details);
-  if (!promptContent || messages[index]?.content === promptContent) return messages;
-
-  const next = [...messages];
-  next[index] = { ...next[index], content: promptContent };
-  return next;
-}
-
-/**
- * Extract the `promptContent` string from a message's `details` object.
- * Returns `null` when absent or not a string.
- */
-export function getPromptContent(details: unknown): string | null {
-  if (!details || typeof details !== "object") return null;
-  const promptContent = (details as { promptContent?: unknown }).promptContent;
-  return typeof promptContent === "string" ? promptContent : null;
-}

package/node_modules/@mrclrchtr/supi-core/src/progress-widget.ts

@@ -1,189 +0,0 @@
-// Generic progress widget for SuPi long-running operations.
-//
-// Provides a TUI-based progress display with animated loader, turn counts,
-// tool usage, and activity descriptions.
-
-import type { Theme } from "@earendil-works/pi-coding-agent";
-import { CancellableLoader, Container, Text } from "@earendil-works/pi-tui";
-
-// ── Types ──────────────────────────────────────────────────────────────────
-
-/** What the reviewer is currently doing and on what. */
-export interface CurrentFocus {
-  /** Display label for the active tool (e.g. "Reading", "Searching", "Finding"). */
-  label: string;
-  /** Context detail (e.g. file path, search pattern, directory). */
-  detail: string;
-}
-
-/** Progress state for widget display, compatible with child-session updates. */
-export interface WidgetProgress {
-  /** Number of agent turns completed. */
-  turns: number;
-  /** Number of tool executions started. */
-  toolUses: number;
-  /** Token usage stats, if available. */
-  tokens?: {
-    input: number;
-    output: number;
-    total: number;
-    cacheRead?: number;
-    cacheWrite?: number;
-  };
-  /** Per-tool execution counts keyed by short display label (e.g. "diffs", "reads", "greps"). */
-  toolCounts?: Record<string, number>;
-  /** Number of distinct files inspected so far (via read_snapshot_diff / read_snapshot_file). */
-  filesInspected?: number;
-  /** Total files in the review snapshot. */
-  filesTotal?: number;
-  /** Current tool + context for the progress narrative line. */
-  currentFocus?: CurrentFocus;
-  /** Elapsed time in milliseconds since the operation started. */
-  elapsedMs?: number;
-}
-
-// ── Widget ─────────────────────────────────────────────────────────────────
-
-/**
- * TUI progress widget for long-running operations.
- *
- * Two-line layout: top line shows the narrative (current focus + file progress),
- * bottom line shows stats (tokens, elapsed time, turns, tool counts).
- */
-export class ProgressWidget extends Container {
-  private message: string;
-  private progress: WidgetProgress = { turns: 0, toolUses: 0 };
-  private loader: CancellableLoader;
-  private tui: { requestRender(): void };
-  private theme: Theme;
-
-  constructor(tui: { requestRender(): void }, theme: Theme, message: string) {
-    super();
-    this.tui = tui;
-    this.theme = theme;
-    this.message = message;
-    this.loader = new CancellableLoader(
-      tui as ConstructorParameters<typeof CancellableLoader>[0],
-      (text: string) => theme.fg("accent", text),
-      (text: string) => theme.fg("muted", text),
-      message,
-    );
-
-    this.renderContent();
-  }
-
-  /** AbortSignal that fires when the user presses Escape. */
-  get signal(): AbortSignal {
-    return this.loader.signal;
-  }
-
-  /** Callback invoked when the user presses Escape. */
-  set onAbort(fn: (() => void) | undefined) {
-    this.loader.onAbort = fn;
-  }
-
-  /** Delegate keyboard input to the loader. */
-  handleInput(data: string): void {
-    this.loader.handleInput(data);
-  }
-
-  /** Update progress state and request a re-render. */
-  updateProgress(progress: WidgetProgress): void {
-    this.progress = progress;
-    this.renderContent();
-    this.tui.requestRender();
-  }
-
-  /** Clean up the widget. */
-  dispose(): void {
-    this.loader.dispose();
-  }
-
-  private renderContent(): void {
-    this.clear();
-    this.renderTopLine();
-    this.renderBottomLine();
-  }
-
-  private renderTopLine(): void {
-    const topParts: string[] = [];
-
-    if (this.progress.currentFocus) {
-      const { label, detail } = this.progress.currentFocus;
-      topParts.push(detail ? `${label}: ${detail}` : label);
-    }
-
-    if (this.progress.filesTotal && this.progress.filesTotal > 0) {
-      const inspected = this.progress.filesInspected ?? 0;
-      topParts.push(`${inspected}/${this.progress.filesTotal} files`);
-    }
-
-    const loaderMessage =
-      topParts.length > 0 ? `${this.message} · ${topParts.join(" · ")}` : this.message;
-    this.loader.setMessage(loaderMessage);
-    this.addChild(this.loader);
-  }
-
-  private renderBottomLine(): void {
-    const stats: string[] = [];
-
-    this.appendTokenStats(stats);
-
-    if (this.progress.elapsedMs !== undefined && this.progress.elapsedMs >= 1000) {
-      stats.push(formatElapsed(this.progress.elapsedMs));
-    }
-
-    if (this.progress.turns > 0) {
-      stats.push(`⟳ ${this.progress.turns}`);
-    }
-
-    if (this.progress.toolCounts) {
-      const parts = Object.entries(this.progress.toolCounts)
-        .filter(([, count]) => count > 0)
-        .sort(([, a], [, b]) => b - a)
-        .map(([label, count]) => `${count} ${label}`);
-      if (parts.length > 0) stats.push(parts.join(" · "));
-    }
-
-    if (stats.length > 0) {
-      this.addChild(new Text(this.theme.fg("dim", `  ${stats.join(" · ")}`), 1, 0));
-    }
-  }
-
-  private appendTokenStats(stats: string[]): void {
-    const tokens = this.progress.tokens;
-    if (!tokens) return;
-
-    stats.push(`↑ ${formatTokens(tokens.input)}`);
-    if (tokens.cacheRead !== undefined && tokens.cacheRead > 0) {
-      stats.push(`↲ ${formatTokens(tokens.cacheRead)}`);
-    }
-    if (tokens.cacheWrite !== undefined && tokens.cacheWrite > 0) {
-      stats.push(`↱ ${formatTokens(tokens.cacheWrite)}`);
-    }
-    stats.push(`↓ ${formatTokens(tokens.output)}`);
-  }
-}
-
-// ── Helpers ────────────────────────────────────────────────────────────────
-
-export function formatTokens(count: number): string {
-  if (count >= 1_000_000) return `${(count / 1_000_000).toFixed(1)}M`;
-  if (count >= 1_000) return `${(count / 1_000).toFixed(1)}k`;
-  return String(count);
-}
-
-export function formatElapsed(ms: number): string {
-  const totalSec = Math.floor(ms / 1000);
-  const hours = Math.floor(totalSec / 3600);
-  const minutes = Math.floor((totalSec % 3600) / 60);
-  const seconds = totalSec % 60;
-
-  if (hours > 0) {
-    return `${hours}h ${minutes}m ${seconds}s`;
-  }
-  if (minutes > 0) {
-    return `${minutes}m ${seconds}s`;
-  }
-  return `${seconds}s`;
-}

package/node_modules/@mrclrchtr/supi-core/src/settings/scoped-settings-list.ts

@@ -1,373 +0,0 @@
-// Scoped settings list component for SuPi settings overlay.
-//
-// Replaces pi-tui's generic SettingsList with a source-aware list that
-// renders source badges, dispatches Enter / Space / action-menu semantics,
-// and delegates custom-field submenus.
-
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Input, Key, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
-import type { ThemeAccessor } from "./settings-action-menu.ts";
-import {
-  buildActionMenu,
-  createActionMenuComponent,
-  getConcreteChoices,
-} from "./settings-action-menu.ts";
-import type { SettingsScope, SettingsSection } from "./settings-registry.ts";
-import type { ScopedFieldValue, SettingsFieldAction } from "./settings-schema.ts";
-import { createInputSubmenu, createModelPickerSubmenu } from "./settings-submenus.ts";
-
-// ═══════════════════════════════════════════════════════════════════════════
-// Scoped settings list
-// ═══════════════════════════════════════════════════════════════════════════
-
-interface ScopedRow {
-  flatId: string;
-  sectionLabel: string;
-  field: ScopedFieldValue;
-}
-
-interface SubmenuState {
-  component: {
-    render: (w: number) => string[];
-    invalidate?: () => void;
-    handleInput?: (data: string) => void;
-  };
-  onDone: () => void;
-}
-
-export class ScopedSettingsList {
-  private sections: SettingsSection[];
-  private scope: SettingsScope;
-  private cwd: string;
-  private ctx: ExtensionContext | undefined;
-  private theme: ThemeAccessor;
-  private tui: { requestRender: () => void };
-  private onCancel: () => void;
-  private onError?: (message: string) => void;
-  private rows: ScopedRow[] = [];
-  private selectedIndex = 0;
-  private submenu: SubmenuState | null = null;
-  private searchInput?: Input;
-  private searchQuery = "";
-  private cachedWidth?: number;
-  private cachedLines?: string[];
-
-  // biome-ignore lint/complexity/useMaxParams: component constructor needs all dependencies upfront for immutable wiring
-  constructor(
-    sections: SettingsSection[],
-    scope: SettingsScope,
-    cwd: string,
-    ctx: ExtensionContext | undefined,
-    theme: ThemeAccessor,
-    tui: { requestRender: () => void },
-    onCancel: () => void,
-    onError?: (message: string) => void,
-  ) {
-    this.sections = sections;
-    this.scope = scope;
-    this.cwd = cwd;
-    this.ctx = ctx;
-    this.theme = theme;
-    this.tui = tui;
-    this.onCancel = onCancel;
-    this.onError = onError;
-    this.rebuildRows();
-  }
-
-  reload(scope: SettingsScope, cwd: string, ctx?: ExtensionContext): void {
-    this.scope = scope;
-    this.cwd = cwd;
-    this.ctx = ctx;
-    this.rebuildRows();
-    this.selectedIndex = Math.min(this.selectedIndex, Math.max(0, this.rows.length - 1));
-    this.invalidate();
-  }
-
-  invalidate(): void {
-    this.cachedWidth = undefined;
-    this.cachedLines = undefined;
-  }
-
-  render(width: number): string[] {
-    if (this.cachedLines && this.cachedWidth === width) return this.cachedLines;
-    if (this.submenu) {
-      this.cachedWidth = width;
-      this.cachedLines = this.submenu.component.render(width);
-      return this.cachedLines;
-    }
-    this.cachedWidth = width;
-    this.cachedLines = this.renderList(width);
-    return this.cachedLines;
-  }
-
-  private renderList(width: number): string[] {
-    const lines: string[] = [];
-    if (this.searchInput) {
-      lines.push(...this.searchInput.render(width));
-      lines.push("");
-    }
-    const displayRows = this.filteredRows();
-    if (displayRows.length === 0) {
-      lines.push(
-        this.theme.fg(
-          "dim",
-          this.searchQuery ? "  No matching settings" : "  No settings available",
-        ),
-      );
-      lines.push("");
-      lines.push(this.renderHint(width));
-      return lines;
-    }
-    const maxVisible = Math.min(displayRows.length + 2, 20);
-    const start = Math.max(
-      0,
-      Math.min(this.selectedIndex - Math.floor(maxVisible / 2), displayRows.length - maxVisible),
-    );
-    const end = Math.min(start + maxVisible, displayRows.length);
-    for (let i = start; i < end; i++) {
-      const row = displayRows[i];
-      if (!row) continue;
-      const isSelected = i === this.selectedIndex;
-      const prefix = isSelected ? "› " : "  ";
-      const section = this.theme.fg("dim", `${row.sectionLabel}: `);
-      const label = isSelected
-        ? this.theme.fg("accent", row.field.field.label)
-        : this.theme.fg("text", row.field.field.label);
-      lines.push(truncateToWidth(`${prefix}${section}${label}  ${row.field.displayValue}`, width));
-    }
-    if (start > 0 || end < displayRows.length) {
-      lines.push(this.theme.fg("dim", `  (${this.selectedIndex + 1}/${displayRows.length})`));
-    }
-    lines.push("");
-    lines.push(this.renderHint(width));
-    return lines;
-  }
-
-  private renderHint(_width: number): string {
-    const hints = [];
-    if (this.searchInput) hints.push("Type to search");
-    hints.push("Enter actions", "Space cycle", "Esc close");
-    return this.theme.fg("dim", hints.join(" · "));
-  }
-
-  handleInput(data: string): void {
-    if (this.submenu) {
-      this.submenu.component.handleInput?.(data);
-      this.invalidate();
-      this.tui.requestRender();
-      return;
-    }
-    if (matchesKey(data, Key.escape)) {
-      this.onCancel();
-      return;
-    }
-    if (matchesKey(data, Key.up)) {
-      this.moveSelection(-1);
-      return;
-    }
-    if (matchesKey(data, Key.down)) {
-      this.moveSelection(1);
-      return;
-    }
-    if (matchesKey(data, Key.enter)) {
-      this.activateSelected();
-      return;
-    }
-    if (data === " ") {
-      this.cycleSelected();
-      return;
-    }
-    if (this.searchInput) {
-      const sanitized = data.replace(/ /g, "");
-      if (sanitized) {
-        this.searchInput.handleInput(sanitized);
-        this.searchQuery = this.searchInput.getValue();
-        this.selectedIndex = 0;
-        this.invalidate();
-        this.tui.requestRender();
-      }
-    }
-  }
-
-  private moveSelection(delta: number): void {
-    const rows = this.filteredRows();
-    if (rows.length === 0) return;
-    this.selectedIndex =
-      delta < 0
-        ? this.selectedIndex <= 0
-          ? rows.length - 1
-          : this.selectedIndex - 1
-        : this.selectedIndex >= rows.length - 1
-          ? 0
-          : this.selectedIndex + 1;
-    this.invalidate();
-    this.tui.requestRender();
-  }
-
-  enableSearch(): void {
-    if (!this.searchInput) this.searchInput = new Input();
-  }
-
-  private rebuildRows(): void {
-    const rows: ScopedRow[] = [];
-    for (const section of this.sections) {
-      for (const value of section.loadValues(this.scope, this.cwd, this.ctx)) {
-        rows.push({
-          flatId: `${section.id}.${value.field.key}`,
-          sectionLabel: section.label,
-          field: value,
-        });
-      }
-    }
-    this.rows = rows;
-  }
-
-  private filteredRows(): ScopedRow[] {
-    if (!this.searchQuery) return this.rows;
-    const q = this.searchQuery.toLowerCase();
-    return this.rows.filter(
-      (r) =>
-        r.field.field.label.toLowerCase().includes(q) ||
-        r.field.field.key.toLowerCase().includes(q) ||
-        r.field.displayValue.toLowerCase().includes(q),
-    );
-  }
-
-  private activateSelected(): void {
-    const rows = this.filteredRows();
-    const row = rows[this.selectedIndex];
-    if (!row) return;
-
-    const menu = buildActionMenu(row.field, this.scope);
-    if (menu.length === 0) return;
-    this.submenu = {
-      component: createActionMenuComponent(menu, this.doneAction(row), this.theme),
-      onDone: () => {
-        this.submenu = null;
-        this.invalidate();
-        this.tui.requestRender();
-      },
-    };
-    this.invalidate();
-    this.tui.requestRender();
-  }
-
-  private doneAction(row: ScopedRow): (action?: string) => void {
-    return (action) => {
-      this.submenu = null;
-      if (!action) {
-        this.invalidate();
-        this.tui.requestRender();
-        return;
-      }
-      if (action === "inherit") {
-        this.dispatchAction(row.flatId, { kind: "inherit" });
-      } else if (action === "resetToDefault") {
-        this.dispatchAction(row.flatId, { kind: "resetToDefault" });
-      } else if (action === "edit") {
-        this.openFreeInputSubmenu(row);
-      } else if (action.startsWith("set:")) {
-        this.dispatchAction(row.flatId, { kind: "set", value: action.slice(4) });
-      }
-      this.invalidate();
-      this.tui.requestRender();
-    };
-  }
-
-  private cycleSelected(): void {
-    const rows = this.filteredRows();
-    const row = rows[this.selectedIndex];
-    if (!row) return;
-    const choices = getConcreteChoices(row.field.field);
-    if (choices.length === 0) return;
-    const idx = choices.indexOf(row.field.editValue);
-    const next = choices[idx < 0 ? 0 : (idx + 1) % choices.length] ?? choices[0];
-    if (next) this.dispatchAction(row.flatId, { kind: "set", value: next });
-  }
-
-  private openFreeInputSubmenu(row: ScopedRow): void {
-    const cleanValue = row.field.editValue;
-    if (row.field.field.kind === "custom" && row.field.field.submenu) {
-      const comp = row.field.field.submenu(
-        cleanValue,
-        (selectedValue) => {
-          this.submenu = null;
-          if (selectedValue !== undefined) {
-            this.dispatchAction(row.flatId, { kind: "set", value: selectedValue });
-          } else {
-            this.reload(this.scope, this.cwd, this.ctx);
-          }
-          this.invalidate();
-          this.tui.requestRender();
-        },
-        this.scope,
-        this.cwd,
-        this.ctx,
-      );
-      this.submenu = {
-        component: comp,
-        onDone: () => {
-          this.submenu = null;
-          this.reload(this.scope, this.cwd, this.ctx);
-          this.invalidate();
-          this.tui.requestRender();
-        },
-      };
-    } else if (row.field.field.kind === "modelPicker") {
-      this.submenu = {
-        component: createModelPickerSubmenu(
-          cleanValue,
-          (v) => {
-            this.submenu = null;
-            if (v !== undefined) this.dispatchAction(row.flatId, { kind: "set", value: v });
-            this.invalidate();
-            this.tui.requestRender();
-          },
-          this.ctx,
-          row.field.field,
-        ),
-        onDone: () => {
-          this.submenu = null;
-          this.invalidate();
-          this.tui.requestRender();
-        },
-      };
-    } else {
-      const label =
-        row.field.field.kind === "stringList"
-          ? "Enter values (comma-separated):"
-          : `Enter ${row.field.field.label.toLowerCase()}:`;
-      this.submenu = {
-        component: createInputSubmenu(cleanValue, label, (v) => {
-          this.submenu = null;
-          if (v !== undefined) this.dispatchAction(row.flatId, { kind: "set", value: v });
-          this.invalidate();
-          this.tui.requestRender();
-        }),
-        onDone: () => {
-          this.submenu = null;
-          this.invalidate();
-          this.tui.requestRender();
-        },
-      };
-    }
-    this.invalidate();
-    this.tui.requestRender();
-  }
-
-  private dispatchAction(flatId: string, action: SettingsFieldAction): void {
-    const dotIndex = flatId.indexOf(".");
-    if (dotIndex === -1) return;
-    const sectionId = flatId.slice(0, dotIndex);
-    const fieldKey = flatId.slice(dotIndex + 1);
-    const section = this.sections.find((s) => s.id === sectionId);
-    if (!section) return;
-    try {
-      section.handleAction(this.scope, this.cwd, fieldKey, action, this.ctx);
-    } catch (err) {
-      this.onError?.(err instanceof Error ? err.message : String(err));
-    }
-    this.reload(this.scope, this.cwd, this.ctx);
-    this.tui.requestRender();
-  }
-}