@mrclrchtr/supi-debug 4.7.0 → 4.9.0

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

@@ -1,141 +0,0 @@
-// Submenu helpers for SuPi settings.
-//
-// Reusable pi-tui submenu components shared across the settings overlay
-// and available to extensions for custom settings controls.
-
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import {
-  Container,
-  Input,
-  Key,
-  matchesKey,
-  type SelectItem,
-  SelectList,
-  Text,
-} from "@earendil-works/pi-tui";
-import { getSelectableModels } from "../model-selection.ts";
-import type { ModelPickerField } from "./settings-schema.ts";
-
-/**
- * Creates a pi-tui Input-backed submenu component with enter-to-confirm
- * and escape-to-cancel handling.
- */
-export function createInputSubmenu(
-  currentValue: string,
-  label: string,
-  done: (selectedValue?: string) => void,
-): {
-  render: (width: number) => string[];
-  invalidate: () => void;
-  handleInput: (data: string) => boolean;
-} {
-  const input = new Input();
-  input.setValue(currentValue);
-
-  return {
-    render: (_width: number) => {
-      const lines = [`  ${label}`];
-      lines.push(...input.render(_width));
-      lines.push("  enter confirm • esc cancel");
-      return lines;
-    },
-    invalidate: () => {
-      input.invalidate();
-    },
-    handleInput: (data: string) => {
-      if (matchesKey(data, Key.escape)) {
-        done();
-        return true;
-      }
-      if (matchesKey(data, Key.enter)) {
-        done(input.getValue());
-        return true;
-      }
-      input.handleInput(data);
-      return true;
-    },
-  };
-}
-
-/**
- * Creates a model picker submenu backed by the scoped model set.
- *
- * The built-in `disabled` choice remains enabled by default. Callers can add
- * host-owned static choices or omit `disabled` through the field options.
- */
-export function createModelPickerSubmenu(
-  currentValue: string,
-  done: (selectedValue?: string) => void,
-  ctx?: ExtensionContext,
-  options: Pick<ModelPickerField, "includeDisabled" | "staticOptions"> = {},
-): {
-  render: (width: number) => string[];
-  invalidate: () => void;
-  handleInput: (data: string) => boolean;
-} {
-  const items = buildModelItems(ctx, options);
-  const initialIndex = Math.max(
-    0,
-    items.findIndex((item) => item.value === currentValue),
-  );
-
-  const container = new Container();
-  container.addChild(new Text("  Select model", 1, 0));
-  container.addChild(new Text("", 1, 0));
-
-  const selectList = new SelectList(items, Math.min(items.length, 15), {
-    selectedPrefix: (t) => `› ${t}`,
-    selectedText: (t) => t,
-    description: (t) => t,
-    scrollInfo: (t) => t,
-    noMatch: (t) => t,
-  });
-  if (initialIndex >= 0) selectList.setSelectedIndex(initialIndex);
-  selectList.onSelect = (item) => done(item.value);
-  selectList.onCancel = () => done();
-
-  container.addChild(selectList);
-  container.addChild(new Text("  ↑↓ 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;
-    },
-  };
-}
-
-/** Build static choices followed by the selectable scoped models. */
-function buildModelItems(
-  ctx: ExtensionContext | undefined,
-  options: Pick<ModelPickerField, "includeDisabled" | "staticOptions">,
-): SelectItem[] {
-  const items: SelectItem[] = [];
-  const seen = new Set<string>();
-  for (const option of options.staticOptions ?? []) {
-    if (seen.has(option.value)) continue;
-    items.push({ ...option });
-    seen.add(option.value);
-  }
-
-  if (options.includeDisabled !== false && !seen.has("disabled")) {
-    items.push({ value: "disabled", label: "disabled", description: "No model selected" });
-    seen.add("disabled");
-  }
-
-  if (!ctx) return items;
-  const models = getSelectableModels(ctx);
-  for (const model of models) {
-    if (seen.has(model.canonicalId)) continue;
-    const suffix = model.isCurrent ? "  [current]" : "";
-    items.push({
-      value: model.canonicalId,
-      label: `${model.canonicalId}${suffix}`,
-      description: model.label !== model.canonicalId ? model.label : undefined,
-    });
-    seen.add(model.canonicalId);
-  }
-  return items;
-}

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

@@ -1,118 +0,0 @@
-// Declarative settings overlay for SuPi extensions.
-//
-// Thin orchestration layer that collects settings contributions and opens the
-// scoped settings list inside a pi-tui custom component overlay.
-
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Container, Key, matchesKey, Text } from "@earendil-works/pi-tui";
-import { ScopedSettingsList } from "./scoped-settings-list.ts";
-import type { SettingsCollectionDiagnostic, SettingsScope } from "./settings-registry.ts";
-import {
-  createSettingsContributionCollector,
-  SUPI_SETTINGS_COLLECT_EVENT,
-} from "./settings-registry.ts";
-
-// Re-export submenu helpers
-export { createInputSubmenu, createModelPickerSubmenu } from "./settings-submenus.ts";
-
-// ── Overlay ────────────────────────────────────────────────────────────────
-
-interface OverlayStatus {
-  kind: "warning" | "error";
-  message: string;
-}
-
-interface OverlayState {
-  scope: SettingsScope;
-  cwd: string;
-  status?: OverlayStatus;
-}
-
-function getScopeLabel(scope: SettingsScope): string {
-  return scope === "project" ? "Project" : "Global";
-}
-
-function collectSettingsSections(pi: ExtensionAPI) {
-  const collector = createSettingsContributionCollector();
-  pi.events.emit(SUPI_SETTINGS_COLLECT_EVENT, collector);
-  return collector.result();
-}
-
-function latestStatus(diagnostics: SettingsCollectionDiagnostic[]): OverlayStatus | undefined {
-  const latest = diagnostics.at(-1);
-  return latest ? { kind: latest.kind, message: latest.message } : undefined;
-}
-
-export function openSettingsOverlay(pi: ExtensionAPI, ctx: ExtensionContext): void {
-  const collection = collectSettingsSections(pi);
-  if (collection.sections.length === 0) {
-    ctx.ui.notify("No settings registered by SuPi extensions", "info");
-    return;
-  }
-
-  void ctx.ui.custom<void>((tui, theme, _kb, done) => {
-    const state: OverlayState = {
-      scope: "project",
-      cwd: ctx.cwd,
-      status: latestStatus(collection.diagnostics),
-    };
-
-    const container = new Container();
-    const scopedList = new ScopedSettingsList(
-      collection.sections,
-      state.scope,
-      state.cwd,
-      ctx,
-      theme,
-      tui,
-      done,
-      (message) => {
-        state.status = { kind: "error", message };
-        rebuildOverlay();
-        tui.requestRender();
-      },
-    );
-    scopedList.enableSearch();
-
-    const rebuildOverlay = () => {
-      container.clear();
-      const scopeLabel = getScopeLabel(state.scope);
-      const otherScope = state.scope === "project" ? "Global" : "Project";
-      container.addChild(
-        new Text(
-          `${theme.fg("accent", theme.bold("SuPi Settings"))}  ${theme.fg("text", `Scope: ${scopeLabel}`)} ${theme.fg("dim", `(tab → ${otherScope})`)}`,
-          0,
-          0,
-        ),
-      );
-      if (state.status) {
-        container.addChild(new Text(theme.fg(state.status.kind, state.status.message), 0, 0));
-      }
-    };
-
-    rebuildOverlay();
-
-    const component = {
-      render: (width: number) => [...container.render(width), ...scopedList.render(width)],
-      invalidate: () => {
-        container.invalidate();
-        scopedList.invalidate();
-      },
-      handleInput: (data: string) => {
-        if (matchesKey(data, Key.tab)) {
-          state.scope = state.scope === "project" ? "global" : "project";
-          state.status = undefined;
-          scopedList.reload(state.scope, state.cwd, ctx);
-          rebuildOverlay();
-          tui.requestRender();
-          return true;
-        }
-        scopedList.handleInput(data);
-        tui.requestRender();
-        return true;
-      },
-    };
-
-    return component;
-  });
-}

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

@@ -1,3 +0,0 @@
-// supi-core settings-ui domain — settings TUI components (imports pi-tui at runtime, heavy).
-export { createInputSubmenu, createModelPickerSubmenu } from "./settings/settings-submenus.ts";
-export { openSettingsOverlay } from "./settings/settings-ui.ts";

package/node_modules/@mrclrchtr/supi-core/src/tool-framework.ts

@@ -1,192 +0,0 @@
-// Shared tool framework for SuPi extensions.
-//
-// Provides a standard ToolSpec→PromptSurface→registerTool pipeline so
-// individual packages do not duplicate spec interfaces, guidance derivation,
-// registration loops, or common TypeBox parameter schemas.
-
-import type {
-  AgentToolResult,
-  AgentToolUpdateCallback,
-  ExtensionAPI,
-  ExtensionCommandContext,
-  ExtensionContext,
-} from "@earendil-works/pi-coding-agent";
-import { type TSchema, Type } from "typebox";
-import { ProgressWidget, type WidgetProgress } from "./progress-widget.ts";
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-/** Minimum contract for a SuPi tool definition. */
-export interface SuiPiToolSpec {
-  name: string;
-  label: string;
-  description: string;
-  promptSnippet: string;
-  promptGuidelines: string[];
-  parameters: TSchema;
-}
-
-/** Derived prompt surface — what pi flattens into the system prompt. */
-export interface SuiPiToolPromptSurface {
-  description: string;
-  promptSnippet: string;
-  promptGuidelines: string[];
-}
-
-// ---------------------------------------------------------------------------
-// Guidance derivation
-// ---------------------------------------------------------------------------
-
-/**
- * Static derivation: copies spec fields into a prompt surface.
- *
- * Packages that need dynamic guidance (e.g. server-coverage injection) should
- * build their own surfaces, optionally starting from the output of this helper.
- */
-export function derivePromptSurface(spec: SuiPiToolSpec): SuiPiToolPromptSurface {
-  return {
-    description: spec.description,
-    promptSnippet: spec.promptSnippet,
-    promptGuidelines: [...spec.promptGuidelines],
-  };
-}
-
-// Re-export prompt-surface types (implemented in config/prompt-surface.ts)
-export {
-  notifyToolPromptSurfaceDiagnostics,
-  type ResolveToolPromptSurfaceOptions,
-  type ResolveToolPromptSurfaceResult,
-  resolveToolPromptSurface,
-  type ToolPromptSurfaceDiagnostic,
-  type ToolPromptSurfaceDiagnosticCode,
-} from "./config/prompt-surface.ts";
-
-// ---------------------------------------------------------------------------
-// Registration
-// ---------------------------------------------------------------------------
-
-// biome-ignore lint/complexity/useMaxParams: matches pi ToolDefinition.execute signature
-export type ToolExecuteFn = (
-  toolCallId: string,
-  params: unknown,
-  signal: AbortSignal | undefined,
-  onUpdate: AgentToolUpdateCallback<Record<string, unknown>> | undefined,
-  ctx: ExtensionContext,
-) => Promise<AgentToolResult<Record<string, unknown>>>;
-
-/**
- * Register a set of tools from specs + pre-derived surfaces.
- *
- * `createExecute` receives the spec and returns a pi-compatible execute
- * function.  This keeps execute-logic package-local while the framework owns
- * the declarative surface and registration boilerplate.
- */
-export function registerSuiPiTools(
-  pi: ExtensionAPI,
-  specs: readonly SuiPiToolSpec[],
-  surfaces: Record<string, SuiPiToolPromptSurface>,
-  createExecute: (spec: SuiPiToolSpec) => ToolExecuteFn,
-): void {
-  for (const spec of specs) {
-    const surface = surfaces[spec.name];
-    pi.registerTool({
-      name: spec.name,
-      label: spec.label,
-      description: surface?.description ?? spec.description,
-      promptSnippet: surface?.promptSnippet ?? spec.promptSnippet,
-      promptGuidelines: surface?.promptGuidelines ?? [...spec.promptGuidelines],
-      parameters: spec.parameters,
-      execute: createExecute(spec),
-    });
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Shared parameter builders
-// ---------------------------------------------------------------------------
-
-/** File path (relative or absolute). */
-export const FileParam = Type.String({ description: "File path (relative or absolute)" });
-
-/** 1-based line number. */
-export const LineParam = Type.Number({ description: "1-based line number", minimum: 1 });
-
-/** 1-based character column (UTF-16). */
-export const CharacterParam = Type.Number({
-  description: "1-based column number (UTF-16)",
-  minimum: 1,
-});
-
-/** Symbol name for discovery-based resolution. */
-export const SymbolParam = Type.String({
-  description: "Symbol name for discovery-based resolution",
-});
-
-/** Maximum results to return. */
-export const MaxResultsParam = Type.Number({ description: "Maximum results to return" });
-
-// ---------------------------------------------------------------------------
-// Progress widget runner
-// ---------------------------------------------------------------------------
-
-/**
- * Run an async operation with a live TUI progress widget.
- *
- * Automatically manages:
- * - The {@link ProgressWidget} lifecycle
- * - `supi:working:start` / `supi:working:end` events for tab-spinner integration
- * - Abort signal handling
- * - Error catching (returns `null` on failure)
- *
- * Falls back to running without a widget when `ctx.hasUI` is false.
- *
- * @param pi - The extension API (for event emission).
- * @param ctx - The command context (for UI access and hasUI check).
- * @param title - The progress widget title.
- * @param runner - Async function that receives (signal, onProgress).
- * @returns The runner result, or `null` on cancel/error.
- */
-export async function runWithProgressWidget<T>(
-  pi: ExtensionAPI,
-  ctx: ExtensionCommandContext,
-  title: string,
-  runner: (signal: AbortSignal, onProgress: (p: WidgetProgress) => void) => Promise<T>,
-): Promise<T | null> {
-  if (!ctx.hasUI) {
-    // No UI — run without progress widget but still emit working events
-    pi.events.emit("supi:working:start", { source: "supi-core" });
-    try {
-      return await runner(new AbortController().signal, () => {});
-    } catch {
-      return null;
-    } finally {
-      pi.events.emit("supi:working:end", { source: "supi-core" });
-    }
-  }
-
-  return ctx.ui.custom<T | null>((tui, theme, _kb, done) => {
-    const widget = new ProgressWidget(tui, theme, title);
-    let finished = false;
-
-    const finish = (result: T | null) => {
-      if (finished) return;
-      finished = true;
-      pi.events.emit("supi:working:end", { source: "supi-core" });
-      widget.dispose();
-      done(result);
-    };
-
-    widget.onAbort = () => {
-      // Widget handles abort signal; runner resolves with cancel/error.
-    };
-
-    pi.events.emit("supi:working:start", { source: "supi-core" });
-    runner(widget.signal, (progress) => widget.updateProgress(progress))
-      .then((result) => finish(result))
-      .catch(() => finish(null));
-
-    return widget;
-  });
-}

package/src/api.ts

@@ -1 +0,0 @@
-export { default } from "./debug.ts";

package/src/index.ts

@@ -1 +0,0 @@
-export { default } from "./debug.ts";