@north-light/crouter 0.3.173 → 0.3.175

package/dist/commands/sys/panels/panel.d.ts

@@ -0,0 +1,45 @@
+export interface SetupPanel {
+    handleInput(data: string, matches?: (id: string, input: string) => boolean): boolean;
+    render(width: number, height: number): string[];
+    /** Short live state shown on this panel's settings-rail row. */
+    badge?(): string;
+}
+type ThemeFgRole = "border" | "accent" | "dim" | "success" | "warning" | "muted" | "mdLink" | "mdLinkUrl";
+export declare const theme: {
+    fg(role: ThemeFgRole, text: string): string;
+    /** A real filled selection band. `selectedBg` was previously an identity
+     *  function, which left the active tab and the active row with no background
+     *  at all — reverse video is the one background every terminal theme honours. */
+    bg(_role: "selectedBg", text: string): string;
+    bold(text: string): string;
+};
+export declare function wrapText(text: string, width: number): string[];
+export declare function renderRows(lines: string[], width: number): string[];
+export declare function padAnsi(text: string, width: number): string;
+export declare function rule(width: number): string;
+export declare function visibleRange(count: number, selected: number, capacity: number): {
+    start: number;
+    end: number;
+};
+/** A bordered box for an emphasised sub-region — an input field, a modal. Panel
+ *  bodies are not boxed: the page frame and rail divider already frame them. */
+export declare function framed(lines: string[], width: number): string[];
+export declare function fitTail(lines: string[], budget: number): string[];
+/** Rows the page frame spends on its own title, rules and footer. */
+export declare const PAGE_CHROME_ROWS = 4;
+/** Title row with right-aligned scope metadata, a rule under it, the body
+ *  padded to fill the viewport, a rule, and the footer pinned to the last row.
+ *  Every settings/setup screen goes through this so the footer never floats in
+ *  the middle of a half-empty terminal. */
+export declare function pageFrame(opts: {
+    width: number;
+    height: number;
+    title: string;
+    meta?: string;
+    body: string[];
+    footer: string;
+}): string[];
+/** Two columns joined by a vertical divider, each already wrapped to its own
+ *  width. Short columns pad; the taller one sets the height. */
+export declare function columns(left: string[], leftWidth: number, right: string[], rightWidth: number): string[];
+export {};

package/dist/commands/sys/panels/panel.js

@@ -0,0 +1,137 @@
+import { getMarkdownTheme, getSelectListTheme, getSettingsListTheme, } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+const ansiGreen = (text) => `\x1b[32m${text}\x1b[39m`;
+const ansiYellow = (text) => `\x1b[33m${text}\x1b[39m`;
+export const theme = {
+    fg(role, text) {
+        switch (role) {
+            case "border":
+                return getMarkdownTheme().hr(text);
+            case "accent":
+                return getMarkdownTheme().heading(text);
+            case "dim":
+                return getSettingsListTheme().description(text);
+            case "muted":
+                return getSelectListTheme().description(text);
+            case "mdLink":
+                return getMarkdownTheme().link(text);
+            case "mdLinkUrl":
+                return getMarkdownTheme().linkUrl(text);
+            case "success":
+                return ansiGreen(text);
+            case "warning":
+                return ansiYellow(text);
+        }
+    },
+    /** A real filled selection band. `selectedBg` was previously an identity
+     *  function, which left the active tab and the active row with no background
+     *  at all — reverse video is the one background every terminal theme honours. */
+    bg(_role, text) {
+        return `\x1b[7m${text}\x1b[27m`;
+    },
+    bold(text) {
+        return getMarkdownTheme().bold(text);
+    },
+};
+export function wrapText(text, width) {
+    const clean = text.trim();
+    if (clean === "")
+        return [""];
+    if (width <= 1)
+        return [truncateToWidth(clean, width)];
+    const lines = [];
+    let current = "";
+    for (const word of clean.split(/\s+/)) {
+        if (current === "") {
+            current = word;
+            continue;
+        }
+        const next = `${current} ${word}`;
+        if (truncateToWidth(next, width) === next)
+            current = next;
+        else {
+            lines.push(truncateToWidth(current, width));
+            current = word;
+        }
+    }
+    if (current !== "")
+        lines.push(truncateToWidth(current, width));
+    return lines.length > 0 ? lines : [""];
+}
+export function renderRows(lines, width) {
+    return lines.map((line) => truncateToWidth(line, width));
+}
+export function padAnsi(text, width) {
+    const used = visibleWidth(text);
+    return used >= width
+        ? truncateToWidth(text, width)
+        : `${text}${" ".repeat(width - used)}`;
+}
+export function rule(width) {
+    return theme.fg("border", "─".repeat(Math.max(0, width)));
+}
+export function visibleRange(count, selected, capacity) {
+    if (count <= 0)
+        return { start: 0, end: 0 };
+    const cap = Math.max(1, Math.min(capacity, count));
+    const start = Math.max(0, Math.min(selected - Math.floor(cap / 2), count - cap));
+    return { start, end: Math.min(count, start + cap) };
+}
+/** A bordered box for an emphasised sub-region — an input field, a modal. Panel
+ *  bodies are not boxed: the page frame and rail divider already frame them. */
+export function framed(lines, width) {
+    if (width < 4)
+        return lines.map((line) => truncateToWidth(line, width));
+    const innerWidth = width - 4;
+    const border = theme.fg("border", "│");
+    const top = theme.fg("border", `┌${"─".repeat(width - 2)}┐`);
+    const bottom = theme.fg("border", `└${"─".repeat(width - 2)}┘`);
+    return [
+        top,
+        ...lines.map((line) => `${border} ${padAnsi(truncateToWidth(line, innerWidth), innerWidth)} ${border}`),
+        bottom,
+    ];
+}
+export function fitTail(lines, budget) {
+    return budget >= lines.length ? lines : lines.slice(lines.length - budget);
+}
+// --- Page chrome shared by the settings shell and the setup wizard ----------
+/** Rows the page frame spends on its own title, rules and footer. */
+export const PAGE_CHROME_ROWS = 4;
+/** Title row with right-aligned scope metadata, a rule under it, the body
+ *  padded to fill the viewport, a rule, and the footer pinned to the last row.
+ *  Every settings/setup screen goes through this so the footer never floats in
+ *  the middle of a half-empty terminal. */
+export function pageFrame(opts) {
+    const { width, height, title, meta, body, footer } = opts;
+    const heading = theme.fg("accent", theme.bold(title));
+    const right = meta ? theme.fg("dim", meta) : "";
+    const gap = width - visibleWidth(heading) - visibleWidth(right);
+    const titleRow = right !== "" && gap >= 2
+        ? `${heading}${" ".repeat(gap)}${right}`
+        : truncateToWidth(heading, width);
+    const budget = Math.max(1, height - PAGE_CHROME_ROWS);
+    const filled = body.slice(0, budget);
+    while (filled.length < budget)
+        filled.push("");
+    return [
+        truncateToWidth(titleRow, width),
+        rule(width),
+        ...filled.map((line) => truncateToWidth(line, width)),
+        rule(width),
+        truncateToWidth(footer, width),
+    ];
+}
+/** Two columns joined by a vertical divider, each already wrapped to its own
+ *  width. Short columns pad; the taller one sets the height. */
+export function columns(left, leftWidth, right, rightWidth) {
+    const divider = theme.fg("border", "\u2502");
+    const rows = Math.max(left.length, right.length);
+    const out = [];
+    for (let index = 0; index < rows; index += 1) {
+        const leftCell = padAnsi(left[index] ?? "", leftWidth);
+        const rightCell = truncateToWidth(right[index] ?? "", rightWidth);
+        out.push(`${leftCell} ${divider} ${rightCell}`);
+    }
+    return out;
+}

package/dist/commands/sys/panels/plugins-panel.d.ts

@@ -0,0 +1,16 @@
+import type { SetupPackageId, SetupPackageManifestEntry } from "../setup-core.js";
+import { type SetupPanel } from "./panel.js";
+export declare class PluginsPanel implements SetupPanel {
+    private readonly manifest;
+    private readonly installedPackageIds;
+    private readonly onChange;
+    private readonly selectedPackageIds;
+    private index;
+    private expandedId;
+    constructor(manifest: SetupPackageManifestEntry[], installedPackageIds: Set<SetupPackageId>, onChange: () => void);
+    badge(): string;
+    get selected(): readonly SetupPackageManifestEntry[];
+    private current;
+    handleInput(data: string, matches?: (id: string, input: string) => boolean): boolean;
+    render(width: number): string[];
+}

package/dist/commands/sys/panels/plugins-panel.js

@@ -0,0 +1,80 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { theme, wrapText } from "./panel.js";
+export class PluginsPanel {
+    manifest;
+    installedPackageIds;
+    onChange;
+    selectedPackageIds = new Set();
+    index = 0;
+    expandedId = null;
+    constructor(manifest, installedPackageIds, onChange) {
+        this.manifest = manifest;
+        this.installedPackageIds = installedPackageIds;
+        this.onChange = onChange;
+        for (const entry of manifest)
+            this.selectedPackageIds.add(entry.id);
+    }
+    badge() {
+        const pending = this.manifest.filter((entry) => !this.installedPackageIds.has(entry.id)).length;
+        return pending === 0
+            ? `${this.manifest.length} \u2713`
+            : `${pending} pending`;
+    }
+    get selected() {
+        return this.manifest.filter((entry) => this.selectedPackageIds.has(entry.id));
+    }
+    current() {
+        return this.manifest[this.index];
+    }
+    handleInput(data, matches) {
+        if (matches === undefined)
+            return false;
+        if (matches("crtr.setup.list-down", data))
+            this.index =
+                this.manifest.length === 0
+                    ? 0
+                    : (this.index + 1) % this.manifest.length;
+        else if (matches("crtr.setup.list-up", data))
+            this.index =
+                this.manifest.length === 0
+                    ? 0
+                    : (this.index - 1 + this.manifest.length) % this.manifest.length;
+        else if (matches("crtr.setup.toggle", data)) {
+            const entry = this.current();
+            if (entry)
+                this.selectedPackageIds.has(entry.id)
+                    ? this.selectedPackageIds.delete(entry.id)
+                    : this.selectedPackageIds.add(entry.id);
+        }
+        else if (matches("crtr.setup.details", data)) {
+            const entry = this.current();
+            if (entry)
+                this.expandedId = this.expandedId === entry.id ? null : entry.id;
+        }
+        else
+            return false;
+        this.onChange();
+        return true;
+    }
+    render(width) {
+        const out = [
+            truncateToWidth(`${theme.fg("accent", theme.bold("Plugins"))}${theme.fg("dim", "  default ON")}`, width),
+        ];
+        for (const [index, entry] of this.manifest.entries()) {
+            const selected = index === this.index;
+            const checked = this.selectedPackageIds.has(entry.id)
+                ? theme.fg("success", "[x]")
+                : theme.fg("dim", "[ ]");
+            const marker = selected ? theme.fg("accent", "▶") : theme.fg("dim", " ");
+            const name = selected ? theme.fg("accent", entry.name) : entry.name;
+            const status = this.installedPackageIds.has(entry.id)
+                ? theme.fg("success", "✓ installed")
+                : theme.fg("warning", "not installed");
+            out.push(truncateToWidth(`${marker} ${checked} ${name} ${theme.fg("dim", "—")} ${theme.fg("muted", entry.shortDescription)} ${status}`, width));
+            if (this.expandedId === entry.id)
+                for (const line of wrapText(entry.longDescription, Math.max(1, width - 4)))
+                    out.push(truncateToWidth(theme.fg("dim", `    ${line}`), width));
+        }
+        return out;
+    }
+}

package/dist/commands/sys/panels/prefs-panel.d.ts

@@ -0,0 +1,21 @@
+import { type UserSettingGroup } from "../../../core/user-settings.js";
+import { type SetupPanel } from "./panel.js";
+/**
+ * One destination's worth of user-scope preference rows. The old single
+ * "Settings" tab listed every row flat with a permanent description under each,
+ * which cost two lines per setting and had no organising principle; each group
+ * now owns its own destination and only the selected row explains itself.
+ */
+export declare class PrefsPanel implements SetupPanel {
+    private readonly title;
+    private readonly subtitle;
+    private readonly onChange;
+    private readonly rows;
+    private index;
+    private notice;
+    constructor(group: UserSettingGroup, title: string, subtitle: string, onChange: () => void);
+    badge(): string;
+    handleInput(data: string, matches?: (id: string, input: string) => boolean): boolean;
+    private cycle;
+    render(width: number, height: number): string[];
+}

package/dist/commands/sys/panels/prefs-panel.js

@@ -0,0 +1,85 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { readConfig, updateConfig } from "../../../core/config.js";
+import { userSettingsInGroup, } from "../../../core/user-settings.js";
+import { padAnsi, theme, visibleRange, wrapText, } from "./panel.js";
+const LABEL_WIDTH = 26;
+/**
+ * One destination's worth of user-scope preference rows. The old single
+ * "Settings" tab listed every row flat with a permanent description under each,
+ * which cost two lines per setting and had no organising principle; each group
+ * now owns its own destination and only the selected row explains itself.
+ */
+export class PrefsPanel {
+    title;
+    subtitle;
+    onChange;
+    rows;
+    index = 0;
+    notice;
+    constructor(group, title, subtitle, onChange) {
+        this.title = title;
+        this.subtitle = subtitle;
+        this.onChange = onChange;
+        this.rows = userSettingsInGroup(group);
+    }
+    badge() {
+        return String(this.rows.length);
+    }
+    handleInput(data, matches) {
+        if (!matches || this.rows.length === 0)
+            return false;
+        if (matches("crtr.setup.list-down", data))
+            this.index = (this.index + 1) % this.rows.length;
+        else if (matches("crtr.setup.list-up", data))
+            this.index = (this.index - 1 + this.rows.length) % this.rows.length;
+        else if (matches("crtr.setup.toggle", data) ||
+            matches("crtr.setup.cell-next", data))
+            this.cycle(1);
+        else if (matches("crtr.setup.cell-previous", data))
+            this.cycle(-1);
+        else
+            return false;
+        this.onChange();
+        return true;
+    }
+    cycle(delta) {
+        const setting = this.rows[this.index];
+        const config = updateConfig("user", (current) => setting.cycle(current, delta));
+        this.notice = `Saved ${setting.key} = ${setting.format(config)}. ${setting.applies}`;
+    }
+    render(width, height) {
+        const config = readConfig("user");
+        // Header (2) + blank + description of the selected row + notice headroom.
+        const capacity = Math.max(1, height - 6);
+        const range = visibleRange(this.rows.length, this.index, capacity);
+        const out = [
+            truncateToWidth(theme.fg("accent", theme.bold(this.title)), width),
+            truncateToWidth(theme.fg("dim", this.subtitle), width),
+            "",
+        ];
+        for (let index = range.start; index < range.end; index += 1) {
+            const setting = this.rows[index];
+            const value = setting.format(config);
+            if (index === this.index) {
+                const row = `\u25b8 ${padAnsi(setting.label, LABEL_WIDTH)} ${value}`;
+                out.push(theme.bg("selectedBg", padAnsi(row, width)));
+            }
+            else
+                out.push(truncateToWidth(`  ${padAnsi(setting.label, LABEL_WIDTH)} ${theme.fg("success", value)}`, width));
+        }
+        if (range.start > 0 || range.end < this.rows.length)
+            out.push(truncateToWidth(theme.fg("dim", `  ${this.index + 1}/${this.rows.length}`), width));
+        const selected = this.rows[this.index];
+        if (selected) {
+            out.push("");
+            for (const line of wrapText(selected.description, Math.max(1, width - 2)))
+                out.push(truncateToWidth(theme.fg("dim", `  ${line}`), width));
+        }
+        if (this.notice) {
+            out.push("");
+            for (const line of wrapText(this.notice, width))
+                out.push(truncateToWidth(theme.fg("success", line), width));
+        }
+        return out;
+    }
+}

package/dist/commands/sys/panels/provider-panel.d.ts

@@ -0,0 +1,62 @@
+import { ModelRegistry, ModelRuntime } from "@earendil-works/pi-coding-agent";
+import { type TUI } from "@earendil-works/pi-tui";
+import { type SetupPanel } from "./panel.js";
+type AuthStatus = ReturnType<ModelRegistry["getProviderAuthStatus"]>;
+type ProviderAuthType = "oauth" | "api_key";
+type ProviderRow = {
+    providerId: string;
+    name: string;
+    managed: boolean;
+    authType: ProviderAuthType;
+    label?: string;
+    preferred?: boolean;
+    cooldownUntil?: number;
+    configured?: boolean;
+    source?: AuthStatus["source"];
+    sourceLabel?: string;
+    accountId?: string;
+};
+/** Curated setup-catalog view over pi's OAuth providers + the model registry. */
+export declare function buildProviderCatalog(runtime: ModelRuntime, registry: ModelRegistry): ProviderRow[];
+/** Classifies a `startLogin` failure into a user-facing status line. */
+export declare function classifyLoginFailure(error: unknown, aborted: boolean): string;
+export declare class ProviderPanel implements SetupPanel {
+    private readonly tui;
+    private readonly agentDir;
+    private readonly runtime;
+    private readonly registry;
+    private readonly renameInput;
+    private rows;
+    private selected;
+    private mode;
+    private notice;
+    private catalog;
+    private catalogIndex;
+    private loginProvider;
+    private loginFlow;
+    private mutationInFlight;
+    onChange?: () => void;
+    constructor(tui: TUI, agentDir: string, runtime: ModelRuntime, registry: ModelRegistry);
+    private notifyChange;
+    /** auth.json changed under us (a login landed, a provider was removed). pi 0.82
+     *  serves provider auth status from the runtime's SNAPSHOT rather than a live file
+     *  read, so the snapshot has to be re-taken before the roster can see the change.
+     *  `refresh()` is local-only here (the runtime is composed with model network access
+     *  off), so this is a credential re-list, not a catalog fetch. */
+    private reloadAfterAuthChange;
+    private reload;
+    private selectedRow;
+    private openBrowser;
+    private openCatalog;
+    private startLogin;
+    isNestedFlowActive(): boolean;
+    dispose(): void;
+    private runMutation;
+    private rename;
+    private remove;
+    private promote;
+    handleInput(data: string): boolean;
+    badge(): string;
+    render(width: number, height: number): string[];
+}
+export {};