@mrclrchtr/supi-web 4.7.0 → 4.8.0

package/node_modules/@mrclrchtr/supi-core/src/report.ts

@@ -1,121 +0,0 @@
-import type { Theme } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-
-/** Minimal theme surface required by the shared report helpers. */
-export type ReportTheme = Pick<Theme, "fg">;
-
-/** Color keys accepted by the report helpers. */
-export type ReportColor = Parameters<Theme["fg"]>[0];
-
-/** Options for rendering a themed key/value report row. */
-export interface KeyValueLineOptions {
-  /** The label shown on the left. */
-  label: string;
-  /** The value shown on the right. */
-  value: string;
-  /** Theme used for color formatting. */
-  theme: ReportTheme;
-  /** Maximum rendered width. */
-  width: number;
-  /** Left indentation in spaces. */
-  indent?: number;
-  /** Theme color applied to the label. Defaults to `"text"`. */
-  labelColor?: ReportColor;
-  /** Theme color applied to the value. Defaults to `"dim"`. */
-  valueColor?: ReportColor;
-  /** Separator placed between label and value. Defaults to `": "`. */
-  separator?: string;
-}
-
-/** Options for rendering a preview-overflow hint. */
-export interface OverflowHintOptions {
-  /** Optional follow-up hint such as `run /supi-context full`. */
-  hint?: string | null;
-  /** Left indentation in spaces. Defaults to `2`. */
-  indent?: number;
-}
-
-/** Ensure a report width never drops below the minimum readable width. */
-export function clampReportWidth(width: number, minWidth = 24): number {
-  return Math.max(minWidth, width);
-}
-
-/** Render a top-level report title line with theme color and truncation. */
-export function formatReportTitle(
-  title: string,
-  theme: ReportTheme,
-  width: number,
-  color: ReportColor = "accent",
-): string {
-  return truncateToWidth(theme.fg(color, title), width);
-}
-
-/**
- * Render a section header with optional dimmed metadata.
- *
- * Example: `Usage by category  42.3k tokens`
- */
-export function formatSectionHeader(
-  title: string,
-  meta: string | null,
-  theme: ReportTheme,
-  width: number,
-): string {
-  const left = theme.fg("text", title);
-  const content = meta ? `${left}${theme.fg("dim", `  ${meta}`)}` : left;
-  return truncateToWidth(content, width);
-}
-
-/** Render a single dimmed report line with optional left indentation. */
-export function formatDimLine(text: string, theme: ReportTheme, width: number, indent = 0): string {
-  const safeIndent = Math.max(0, indent);
-  return truncateToWidth(`${" ".repeat(safeIndent)}${theme.fg("dim", text)}`, width);
-}
-
-/** Render a dimmed preview-overflow hint such as `… and 3 more — run /foo full`. */
-export function formatOverflowHint(
-  hiddenCount: number,
-  theme: ReportTheme,
-  width: number,
-  options: OverflowHintOptions = {},
-): string {
-  const { hint = null, indent = 2 } = options;
-  const suffix = hint ? ` — ${hint}` : "";
-  return formatDimLine(`… and ${hiddenCount} more${suffix}`, theme, width, indent);
-}
-
-/** Render a single themed `label: value` row with truncation. */
-export function formatKeyValueLine(options: KeyValueLineOptions): string {
-  const {
-    label,
-    value,
-    theme,
-    width,
-    indent = 2,
-    labelColor = "text",
-    valueColor = "dim",
-    separator = ": ",
-  } = options;
-  const safeIndent = Math.max(0, indent);
-
-  return truncateToWidth(
-    `${" ".repeat(safeIndent)}${theme.fg(labelColor, label)}${separator}${theme.fg(valueColor, value)}`,
-    width,
-  );
-}
-
-/**
- * Wrap a report text block to the available width and optionally prefix each line.
- *
- * This is useful for wrapped bullets or explanatory notes that should align
- * under an existing report indent.
- */
-export function wrapReportText(
-  text: string,
-  width: number,
-  options: { indent?: string } = {},
-): string[] {
-  const indent = options.indent ?? "";
-  const wrapped = wrapTextWithAnsi(text, Math.max(1, width - indent.length));
-  return indent ? wrapped.map((line) => `${indent}${line}`) : wrapped;
-}

package/node_modules/@mrclrchtr/supi-core/src/session-utils.ts

@@ -1,71 +0,0 @@
-// Generic session-file tree-walking utilities.
-
-import type { FileEntry, SessionEntry } from "@earendil-works/pi-coding-agent";
-
-/**
- * Minimal pi API surface needed to track the current session display name reactively.
- * Accept `ExtensionAPI` or any object satisfying this shape.
- */
-export interface SessionNameTrackerHost {
-  on(event: string, handler: (...args: unknown[]) => unknown): void;
-  getSessionName(): string | undefined;
-}
-
-/**
- * Create a reactive session-name tracker that stays consistent across
- * session starts, renames, and shutdowns without polling.
- *
- * Subscribes to `session_start` (initial name), `session_info_changed`
- * (renames via `/name`, `pi.setSessionName()`, or RPC), and
- * `session_shutdown` (reset to `undefined`).
- *
- * @returns a zero-arg getter that always returns the current session name
- *
- * @example
- * ```ts
- * const getSessionName = createSessionNameTracker(pi);
- * // …later, during tool execute or spinner rendering:
- * const name = getSessionName();
- * ```
- */
-export function createSessionNameTracker(pi: SessionNameTrackerHost): () => string | undefined {
-  let name: string | undefined;
-
-  pi.on("session_start", () => {
-    name = pi.getSessionName();
-  });
-  pi.on("session_info_changed", (event) => {
-    name = (event as { name?: string }).name;
-  });
-  pi.on("session_shutdown", () => {
-    name = undefined;
-  });
-
-  return () => name;
-}
-
-/**
- * Resolve the active branch path using PI's append-only tree semantics.
- *
- * The active branch is the path from the **last entry** (current leaf)
- * back to the root via `parentId`. This follows PI's tree structure where
- * entries are append-only and the last entry in the file is always the
- * current leaf of the active branch.
- */
-export function getActiveBranchEntries(entries: FileEntry[]): SessionEntry[] {
-  const sessionEntries = entries.filter((e): e is SessionEntry => e.type !== "session");
-  const byId = new Map(sessionEntries.map((entry) => [entry.id, entry]));
-  const leaf = sessionEntries.at(-1);
-  if (!leaf) return [];
-
-  const path: SessionEntry[] = [];
-  const visited = new Set<string>();
-  let current: SessionEntry | undefined = leaf;
-  while (current) {
-    if (visited.has(current.id)) break;
-    visited.add(current.id);
-    path.unshift(current);
-    current = current.parentId ? byId.get(current.parentId) : undefined;
-  }
-  return path;
-}

package/node_modules/@mrclrchtr/supi-core/src/session.ts

@@ -1,8 +0,0 @@
-// supi-core session domain — session utilities and registries.
-
-export { createRegistry, createSessionStateRegistry } from "./registry-utils.ts";
-export type { SessionNameTrackerHost } from "./session-utils.ts";
-export {
-  createSessionNameTracker,
-  getActiveBranchEntries,
-} from "./session-utils.ts";

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();
-  }
-}

package/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts

@@ -1,102 +0,0 @@
-// Action menu component for SuPi settings rows.
-//
-// Builds context-sensitive action menus for scoped settings rows: concrete
-// value choices, Inherit from global, Use default, and Reset to default.
-
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Container, type SelectItem, SelectList, Text } from "@earendil-works/pi-tui";
-import type { SettingsScope } from "./settings-registry.ts";
-import type { ScopedFieldValue, SettingsField } from "./settings-schema.ts";
-
-/** Theme accessor type matching the TUI custom() theme parameter. */
-export type ThemeAccessor = Parameters<Parameters<ExtensionContext["ui"]["custom"]>[0]>[1];
-
-/** One selectable action in the row action menu. */
-export interface ActionMenuItem {
-  value: string;
-  label: string;
-}
-
-/**
- * Build the action menu for a settings row given its field state and scope.
- *
- * Menu items include concrete value choices (for cycling fields), edit actions
- * (for free-input fields), and scope-aware Inherit/Reset-to-default actions.
- */
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: 5-way branch on field kind + 3-way on scope/source is the natural discriminator for per-kind row actions
-export function buildActionMenu(field: ScopedFieldValue, scope: SettingsScope): ActionMenuItem[] {
-  const menu: ActionMenuItem[] = [];
-
-  if (field.field.kind === "custom") {
-    if (field.field.submenu) menu.push({ value: "edit", label: "Edit…" });
-  } else {
-    const choices = getConcreteChoices(field.field);
-    if (choices.length > 0) {
-      for (const choice of choices) menu.push({ value: `set:${choice}`, label: choice });
-    } else if (field.field.kind === "number") menu.push({ value: "edit", label: "Edit value…" });
-    else if (field.field.kind === "string") menu.push({ value: "edit", label: "Edit value…" });
-    else if (field.field.kind === "stringList") menu.push({ value: "edit", label: "Edit values…" });
-    else if (field.field.kind === "modelPicker")
-      menu.push({ value: "edit", label: "Choose model…" });
-  }
-
-  if (scope === "project") {
-    if (field.source === "project") {
-      const label = field.inheritanceSource === "global" ? "Inherit from global" : "Use default";
-      menu.push({ value: "inherit", label });
-    }
-  } else if (field.source === "global") {
-    menu.push({ value: "resetToDefault", label: "Reset to default" });
-  }
-
-  return menu;
-}
-
-/**
- * Return the concrete string choices for a field that supports Space cycling.
- * Returns an empty array for fields that use free-text input or submenus.
- */
-export function getConcreteChoices(field: SettingsField): string[] {
-  switch (field.kind) {
-    case "boolean":
-      return ["on", "off"];
-    case "enum":
-      return field.values;
-    case "number":
-      return field.values ?? [];
-    default:
-      return [];
-  }
-}
-
-/**
- * Create a pi-tui SelectList-backed action menu component.
- */
-export function createActionMenuComponent(
-  menu: ActionMenuItem[],
-  done: (action?: string) => void,
-  theme: ThemeAccessor,
-) {
-  const items: SelectItem[] = menu.map((m) => ({ value: m.value, label: m.label }));
-  const container = new Container();
-  container.addChild(new Text(theme.fg("accent", "  Actions"), 1, 0));
-  const selectList = new SelectList(items, Math.min(items.length + 2, 15), {
-    selectedPrefix: (t) => theme.fg("accent", t),
-    selectedText: (t) => theme.fg("accent", t),
-    description: (t) => theme.fg("muted", t),
-    scrollInfo: (t) => theme.fg("dim", t),
-    noMatch: (t) => theme.fg("warning", t),
-  });
-  selectList.onSelect = (item) => done(item.value);
-  selectList.onCancel = () => done();
-  container.addChild(selectList);
-  container.addChild(new Text(theme.fg("dim", "  ↑↓ navigate • enter select • esc cancel"), 1, 0));
-  return {
-    render: (width: number) => container.render(width),
-    invalidate: () => container.invalidate(),
-    handleInput: (data: string) => {
-      selectList.handleInput(data);
-      return true;
-    },
-  };
-}

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

@@ -1,15 +0,0 @@
-// /supi-settings command registration.
-//
-// Thin wrapper that registers the command and delegates to openSettingsOverlay.
-
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { openSettingsOverlay } from "./settings-ui.ts";
-
-export function registerSettingsCommand(pi: ExtensionAPI): void {
-  pi.registerCommand("supi-settings", {
-    description: "Manage SuPi extension settings",
-    handler: async (_args, ctx) => {
-      openSettingsOverlay(pi, ctx);
-    },
-  });
-}