@mrclrchtr/supi-extras 4.6.0 → 4.8.0

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 "./index.ts";

package/src/skill-shortcut.ts

@@ -1,123 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { fuzzyFilter } from "@earendil-works/pi-tui";
-
-/**
- * Extension: `$` as a shortcut prefix for skills.
- *
- * - `$agent-browser` expands to `/skill:agent-browser`
- * - Autocomplete triggers on `$` showing only skill names
- * - Works anywhere in the prompt (after space or at start)
- */
-
-const DELIMITERS = new Set([" ", "\t", "\n"]);
-
-/** Find the `$token` at the cursor, or null if not in one. */
-function extractDollarPrefix(textBeforeCursor: string): string | null {
-  // Walk backwards to find the start of the current token
-  for (let i = textBeforeCursor.length - 1; i >= 0; i--) {
-    const char = textBeforeCursor[i];
-    if (char && DELIMITERS.has(char)) {
-      // Hit a delimiter — the token starts at i+1
-      const token = textBeforeCursor.slice(i + 1);
-      return token.startsWith("$") ? token : null;
-    }
-  }
-  // Reached start of line
-  return textBeforeCursor.startsWith("$") ? textBeforeCursor : null;
-}
-
-// ── Extension entry point ─────────────────────────────────────────
-
-/**
- * Register `$skill-name` → `/skill:skill-name` expansion and autocomplete.
- *
- * ## Behavior gotchas
- *
- * - Installed skill names are snapshotted at `session_start` via
- *   `pi.getCommands()`; after adding or removing skills, use `/reload` or
- *   start a new session before testing expansion behavior.
- * - Outside `$...` tokens, autocomplete must delegate back to the current
- *   provider so built-in completion and file completion continue to work.
- *
- * ## Testing
- *
- * If behavior changes, test both:
- * - expansion inside `$...` tokens
- * - normal autocomplete everywhere else
- */
-export default function (pi: ExtensionAPI) {
-  let skillNames: string[] = [];
-  let skillCommands: { name: string; description?: string }[] = [];
-
-  pi.on("session_start", (_event, ctx) => {
-    const commands = pi.getCommands();
-    skillCommands = commands
-      .filter((c) => c.source === "skill")
-      .map((c) => ({
-        name: c.name.replace(/^skill:/, ""),
-        description: c.description,
-      }));
-    skillNames = skillCommands.map((c) => c.name);
-
-    // Stack skill autocomplete on top of the built-in provider.
-    // addAutocompleteProvider takes a wrapper callback: (current) => provider.
-    ctx.ui.addAutocompleteProvider((current) => ({
-      triggerCharacters: ["$"],
-      async getSuggestions(lines, cursorLine, cursorCol, options) {
-        const textBeforeCursor = (lines[cursorLine] || "").slice(0, cursorCol);
-        const dollarPrefix = extractDollarPrefix(textBeforeCursor);
-
-        if (!dollarPrefix || dollarPrefix.includes(" ")) {
-          return current.getSuggestions(lines, cursorLine, cursorCol, options);
-        }
-
-        const query = dollarPrefix.slice(1);
-        const items = skillCommands.map((c) => ({
-          name: c.name,
-          description: c.description,
-        }));
-        const filtered = fuzzyFilter(items, query, (i) => i.name).map((i) => ({
-          value: i.name,
-          label: i.name,
-          ...(i.description && { description: i.description }),
-        }));
-        return filtered.length
-          ? { items: filtered, prefix: dollarPrefix }
-          : current.getSuggestions(lines, cursorLine, cursorCol, options);
-      },
-      // biome-ignore lint/complexity/useMaxParams: AutocompleteProvider interface
-      applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
-        if (prefix.startsWith("$")) {
-          const line = lines[cursorLine] || "";
-          const before = line.slice(0, cursorCol - prefix.length);
-          const after = line.slice(cursorCol);
-          const newLine = `${before}$${item.value} ${after}`;
-          return {
-            lines: [...lines.slice(0, cursorLine), newLine, ...lines.slice(cursorLine + 1)],
-            cursorLine,
-            cursorCol: before.length + 1 + item.value.length + 1,
-          };
-        }
-        return current.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
-      },
-      shouldTriggerFileCompletion(lines, cursorLine, cursorCol) {
-        return current.shouldTriggerFileCompletion?.(lines, cursorLine, cursorCol) ?? true;
-      },
-    }));
-  });
-
-  // Transform $skill-name → /skill:skill-name before agent processing
-  pi.on("input", (event) => {
-    const text = event.text.trim();
-
-    // Find all $skill-name tokens and replace them
-    const transformed = text.replace(/(?:^|(?<=\s))\$([a-z0-9][-a-z0-9]*)/g, (_match, name) => {
-      return skillNames.includes(name) ? `/skill:${name}` : _match;
-    });
-
-    if (transformed !== text) {
-      return { action: "transform" as const, text: transformed };
-    }
-    return { action: "continue" as const };
-  });
-}