@slkiser/opencode-quota 5.0.3 → 6.0.0-beta.1

package/dist/tui/client.js

@@ -0,0 +1,229 @@
+/**
+ * The TUI's quota data: the server's last snapshot, kept in Solid signals so every surface
+ * redraws when it changes. It asks the server over the quota RPC (`snapshot` when a surface
+ * shows, `refresh` after a turn), applies every `changed` event, and asks again every minute
+ * in case an event was missed. Nothing reaches OpenCode until a surface shows or a turn ends.
+ *
+ * Answers can arrive out of order. The newest snapshot (highest `revision`) wins; a snapshot
+ * from another server (a new `serverId`: OpenCode restarted it) always wins, as its revisions
+ * start over, and from then on the old server's answers are ignored. What a snapshot says
+ * about one session comes from the latest call about it.
+ */
+import { createSignal } from "solid-js";
+import { sanitizeDisplayText } from "../lib/display-sanitize.js";
+import { QuotaRpc, } from "../rpc.js";
+const POLL_INTERVAL_MS = 60_000;
+const RPC_TIMEOUT_MS = 60_000;
+/**
+ * Each call names the TUI's folder, so the server uses that folder's settings, and gives up
+ * after a minute. The RPC client itself is made per call, never during setup.
+ */
+export function quotaCallOptions(host) {
+    const location = host.location ?? host.data.location?.default();
+    if (!location)
+        throw new Error("OpenCode gave the TUI no location");
+    return { location, signal: AbortSignal.timeout(RPC_TIMEOUT_MS) };
+}
+/** RPC calls reject with a plain `{ type, message }` object, not an Error. */
+export function rpcErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "object" && error !== null && "message" in error) {
+        return String(error.message);
+    }
+    return String(error);
+}
+/** The toast for a failed call: its reason, cleaned for the terminal. */
+export function errorToast(error, title = "OpenCode Quota") {
+    const message = sanitizeDisplayText(rpcErrorMessage(error));
+    return { variant: "error", title, message };
+}
+export function reportFailure(error) {
+    // OpenCode answers rpc.unavailable when no server plugin registered the quota RPC here.
+    const hint = typeof error === "object" &&
+        error !== null &&
+        "type" in error &&
+        error.type === "rpc.unavailable"
+        ? " (OpenCode Quota's server plugin is not loaded for this folder)"
+        : "";
+    console.warn(`[opencode-quota] failed to load quota: ${rpcErrorMessage(error)}${hint}`);
+}
+/**
+ * @param onSnapshot called with every snapshot the client takes (from any call or event), so
+ *   toasts can announce new reset notices.
+ */
+export function createQuotaClient(host, onSnapshot = () => { }) {
+    const [latest, setLatest] = createSignal();
+    const [sessions, setSessions] = createSignal({});
+    const [homeLine, setHomeLine] = createSignal("");
+    /** Sessions on screen, with how many surfaces show each. */
+    const watched = new Map();
+    /** Surfaces on screen without a session (the status line on Home). */
+    let globalWatchers = 0;
+    let homeWatchers = 0;
+    let running = false;
+    /** Numbers every call; a session's part is kept only from a later call than the last one. */
+    let calls = 0;
+    const sessionCalls = new Map();
+    /** Servers this client moved away from; their answers are ignored. */
+    const retiredServers = new Set();
+    /** Bumped when the TUI stops: answers to calls made before then are dropped. */
+    let mount = 0;
+    /** Snapshot calls on their way, by session ("" for none), with their call numbers. */
+    const loading = new Map();
+    /** The `changed` subscription while running, made with the first snapshot call. */
+    let events;
+    const rpc = () => host.client.rpc(QuotaRpc);
+    /** `call` numbers the request a session's part came from. */
+    function apply(snapshot, session) {
+        const { currentModelProviderIds, currentModelRowPrefixes, sessionTokens, ...shared } = snapshot;
+        if (retiredServers.has(shared.serverId))
+            return;
+        // An answer that left before a newer snapshot arrived must not undo it.
+        const current = latest();
+        if (current && current.serverId !== shared.serverId)
+            retiredServers.add(current.serverId);
+        if (!current || current.serverId !== shared.serverId || current.revision < shared.revision) {
+            setLatest(shared);
+        }
+        if (session && session.call > (sessionCalls.get(session.id) ?? 0)) {
+            sessionCalls.set(session.id, session.call);
+            setSessions((all) => ({
+                ...all,
+                [session.id]: {
+                    ...(currentModelProviderIds ? { currentModelProviderIds } : {}),
+                    ...(currentModelRowPrefixes ? { currentModelRowPrefixes } : {}),
+                    ...(sessionTokens ? { sessionTokens } : {}),
+                },
+            }));
+        }
+        onSnapshot(snapshot);
+    }
+    function subscribe() {
+        if (!running || events)
+            return;
+        events = new AbortController();
+        const signal = events.signal;
+        try {
+            rpc().events.on("changed", (event) => {
+                if (!signal.aborted)
+                    apply(event.data.snapshot);
+            }, { signal });
+        }
+        catch (error) {
+            // The poll still updates every minute.
+            reportFailure(error);
+        }
+    }
+    function load(sessionID) {
+        // The sidebar and the status line of one session ask together; one call answers both.
+        const key = sessionID ?? "";
+        if (loading.has(key))
+            return;
+        const call = ++calls;
+        const at = mount;
+        loading.set(key, call);
+        subscribe();
+        rpc()
+            .snapshot(sessionID ? { sessionID } : {}, quotaCallOptions(host))
+            .then((output) => {
+            if (at === mount)
+                apply(output.snapshot, sessionID ? { id: sessionID, call } : undefined);
+        })
+            .catch(reportFailure)
+            .finally(() => {
+            if (loading.get(key) === call)
+                loading.delete(key);
+        });
+    }
+    function loadHomeLine() {
+        const at = mount;
+        rpc()
+            .notices({}, quotaCallOptions(host))
+            .then((output) => {
+            if (at === mount)
+                setHomeLine(output.homeLine);
+        })
+            .catch(reportFailure);
+    }
+    function snapshot(sessionID) {
+        const shared = latest();
+        if (!shared)
+            return undefined;
+        const part = sessionID ? sessions()[sessionID] : undefined;
+        return part ? { ...shared, ...part } : shared;
+    }
+    function poll() {
+        if (globalWatchers > 0)
+            load();
+        for (const sessionID of watched.keys())
+            load(sessionID);
+        if (homeWatchers > 0)
+            loadHomeLine();
+    }
+    return {
+        snapshot,
+        homeLine,
+        watch(sessionID) {
+            if (!sessionID) {
+                globalWatchers += 1;
+                load();
+                return () => {
+                    globalWatchers -= 1;
+                };
+            }
+            watched.set(sessionID, (watched.get(sessionID) ?? 0) + 1);
+            load(sessionID);
+            return () => {
+                const count = (watched.get(sessionID) ?? 1) - 1;
+                if (count > 0)
+                    watched.set(sessionID, count);
+                else
+                    watched.delete(sessionID);
+            };
+        },
+        watchHome() {
+            homeWatchers += 1;
+            loadHomeLine();
+            return () => {
+                homeWatchers -= 1;
+            };
+        },
+        async refresh(reason, sessionID) {
+            try {
+                const input = sessionID ? { reason, sessionID } : { reason };
+                const call = ++calls;
+                const at = mount;
+                subscribe();
+                const output = await rpc().refresh(input, quotaCallOptions(host));
+                if (at !== mount)
+                    return undefined;
+                apply(output.snapshot, sessionID ? { id: sessionID, call } : undefined);
+                return snapshot(sessionID);
+            }
+            catch (error) {
+                reportFailure(error);
+                return undefined;
+            }
+        },
+        start() {
+            running = true;
+            // After a reconnect, the surfaces already on screen ask again at once.
+            poll();
+            const timer = setInterval(poll, POLL_INTERVAL_MS);
+            let stopped = false;
+            return () => {
+                if (stopped)
+                    return;
+                stopped = true;
+                running = false;
+                mount += 1;
+                loading.clear();
+                events?.abort();
+                events = undefined;
+                clearInterval(timer);
+            };
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/tui/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/tui/client.ts"],"names":[],"mappings":"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"}

package/dist/tui/display.d.ts

@@ -0,0 +1,127 @@
+/**
+ * File-backed settings for the TUI and its Settings lines. DisplaySettings also exposes the
+ * row selectors the existing renderers consume; these are derived from the tab sections.
+ */
+import type { Words } from "../core/types.js";
+import { type Settings } from "../settings/schema.js";
+import type { RowSettings, Surface } from "../view/select.js";
+import type { ColorRole } from "../view/text.js";
+/** Named colors follow OpenCode's theme; hex colors stay fixed; bar follows the row's level. */
+export declare const COLOR_NAMES: readonly ["text", "muted", "accent", "green", "yellow", "red", "blue"];
+export type ColorName = (typeof COLOR_NAMES)[number];
+export type ColorChoice = ColorName | "bar" | `#${string}`;
+export type DisplaySettings = Settings & RowSettings & {
+    thresholds: {
+        warningBelow: number;
+        lowBelow: number;
+    };
+    runsOut: Record<Surface, boolean>;
+};
+/** The theme color each role gets unless you change it. */
+export declare const THEME_COLORS: Record<ColorRole, ColorName | "bar">;
+/** The tab sections as the row settings the renderers use. */
+export declare function displaySettings(settings: Settings): DisplaySettings;
+/** The value at a field's path, for example "layout.barWidth". */
+export declare function valueAt(settings: unknown, path: string): FieldValue;
+/**
+ * A copy of the settings with `value` at `keys` (a key may hold a dot, like a row id);
+ * undefined removes the key, which puts a color back to the theme's or a row name back.
+ */
+export declare function setIn(settings: DisplaySettings, keys: readonly string[], value: unknown): DisplaySettings;
+export declare function defaultDisplaySettings(): DisplaySettings;
+/**
+ * The quota window's Settings pages. The tab bar shows Layout (the pages layout as "All places",
+ * which also holds the `words` lines, then sidebar, collapsed, statusLine and toast), Colors and
+ * Providers.
+ */
+export type SettingsTab = "sidebar" | "collapsed" | "statusLine" | "toast" | "colors" | "layout" | "providers";
+export declare function isSurfaceTab(tab: SettingsTab): tab is Surface;
+/** What a setting line holds; undefined only for a color that follows the theme, null for unset. */
+export type FieldValue = string | number | boolean | null | undefined;
+export type PresetName = "layout" | "toast" | "words" | "colors";
+/**
+ * One setting line: ‹ › step through `values`; a color line also takes a typed "#rrggbb", a
+ * line with a `placeholder` a typed number. Its `path` ("layout.barWidth") is also its id.
+ */
+export type Field = {
+    path: string;
+    tab: SettingsTab;
+    title: string;
+    initial: FieldValue;
+    values: readonly FieldValue[];
+    show: (value: FieldValue) => string;
+    /** What a stored value may hold besides `values` (typed by hand, or imported from v5). */
+    valid?: (value: unknown) => boolean;
+    /** The values ‹ › step through when some of `values` don't fit the other settings. */
+    choices?: (settings: DisplaySettings) => readonly FieldValue[];
+    /** A heading above the line, which starts a group. */
+    group?: string;
+    /** Short muted text after the value. */
+    note?: string;
+    /** The preset on top of the tab sets this line. */
+    preset?: PresetName;
+    color?: true;
+    /** A number you type ("a dollar amount"); nothing typed is null. */
+    placeholder?: string;
+    /** On the Providers tab: nested under this provider's tick, while it is ticked. */
+    provider?: string;
+};
+/** Every plain setting, in the order its tab shows it. */
+export declare const FIELDS: readonly Field[];
+/** A line that sets the lines marked with its name in one step. */
+export type Preset = {
+    tab: SettingsTab;
+    title: string;
+    /** What it sets, after "sets": the lines by their titles or their group's heading. */
+    drives: string;
+    /**
+     * The line it sits above, taking that line's heading; without one it is the page's first,
+     * under "Preset".
+     */
+    before?: string;
+    /** The values of each choice, by path. */
+    choices: Record<string, Record<string, FieldValue>>;
+};
+export declare const PRESETS: Record<PresetName, Preset>;
+/** The value `delta` steps from `current` in `values`, wrapping; an unknown one counts as the first. */
+export declare function stepIn<T>(values: readonly T[], current: T, delta: number): T;
+/** A typed number the server takes for the field ("$" allowed); null for nothing typed. */
+export declare function typedNumber(field: Field, text: string): FieldValue;
+/** A typed "#89b4fa" (the # is optional); nothing typed puts the theme's color back. */
+export declare function typedColor(settings: DisplaySettings, field: Field, text: string): DisplaySettings;
+/** The preset choice whose values all match the lines' values; undefined is "your own". */
+export declare function presetChoice(name: PresetName, value: (path: string) => unknown): string | undefined;
+/** ‹ or ›: the values of the previous or next choice after `current`; from "your own", the first. */
+export declare function presetValues(name: PresetName, current: string | undefined, delta: number): Readonly<Record<string, FieldValue>>;
+/**
+ * Your name for a row; nothing typed puts its own name back. A name equal to its own label
+ * stays, so it shows where `words.rowNames` "short" would show the window's short name.
+ */
+export declare function renameRow(settings: DisplaySettings, surface: "sidebar" | "toast", rowId: string, text: string): DisplaySettings;
+/**
+ * The tab's lines back to their defaults. A surface tab also puts that surface's order, hidden
+ * rows and switches back (and Collapsed and Status line the preferred windows); row names stay.
+ */
+export declare function resetTab(settings: DisplaySettings, tab: SettingsTab): DisplaySettings;
+/** Settings received through the RPC, with this window's draft on top. */
+export type DisplayStore = ReturnType<typeof createFileDisplay>;
+export declare function createFileDisplay(server: import("./server-settings.js").ServerSettings): {
+    server: {
+        saved: import("solid-js").Accessor<import("../settings/schema.js").ClientSettings | undefined>;
+        receive(next: import("../rpc.js").QuotaRpcSettingsOutput): void;
+        value: (key: string) => unknown;
+        set(key: string, next: unknown): void;
+        customOn: (id: string) => boolean;
+        switchCustom(id: string, on: boolean): void;
+        changedSinceReview: (id: string) => boolean;
+        dirty: () => boolean;
+        draftWords(): Partial<Words>;
+        load(): Promise<void>;
+        saveNow(key: string, next: unknown): Promise<void>;
+        save(): Promise<void>;
+        discard(): void;
+    };
+    shown: () => DisplaySettings;
+    edit(change: (settings: DisplaySettings) => DisplaySettings): void;
+};
+//# sourceMappingURL=display.d.ts.map

package/dist/tui/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/tui/display.ts"],"names":[],"mappings":"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"}