toolroll 0.9.53 → 0.9.55

package/dist/server/render-settings.d.ts

@@ -0,0 +1,147 @@
+import { type BrandIconId } from "../brand-icons.js";
+import { type BrowserPhoneCard, type BrowserSettingsGroup, type BrowserSettingsView, type BrowserUpdates } from "../browser-workspace.js";
+import { type Gap } from "../gaps.js";
+import { type LeadIdentity } from "../lead-identity.js";
+import { type ProviderConnection } from "../provider-connection.js";
+import { type QualityMode } from "../quality.js";
+import { type UnattendedPermissionMode } from "../scope.js";
+import { type Capability, type PushSubscription, type ResultScreenshots, type Store } from "../store.js";
+import { type TokenSource } from "../telegram.js";
+import { type Chrome, type Screen } from "./chrome.js";
+import { type Html } from "../html.js";
+/** What the lead's settings form shows beside the saved configuration: where keys come from (never the keys), the
+ * live model lists, and where saving goes back to. */
+export type LeadFormFacts = {
+    keyFacts: {
+        provider: string;
+        state: "environment" | "stored" | "none";
+        tail: string | null;
+    }[];
+    openrouterModels: string[] | null;
+    liveModels?: {
+        value: string;
+        label: string;
+    }[];
+    /** Unused: postForm writes the request's CSRF field (kept for callers). */
+    csrf: string;
+    returnTo: string;
+};
+/** Settings → Lead: one line for what runs the lead and one action; the full form, turning it off and stored keys under Advanced. */
+export declare function leadSettingsHtml(data: {
+    config: import("../store.js").ChatConfig | null;
+    facts: LeadFormFacts;
+    words: string | null;
+    signedIn: string | null;
+    command: string;
+    said: string | null;
+    saved?: boolean;
+    identity?: LeadIdentity;
+    about?: string[];
+    aboutSaved?: boolean;
+    promises?: {
+        id: number;
+        what: string;
+        when: string;
+        until: string;
+    }[];
+}): Html;
+/** The lead's full settings (Settings → Lead → Advanced): provider, model, limits and a direct API key. */
+export declare function leadConfigForm(current: import("../store.js").ChatConfig | null, data: LeadFormFacts): Html;
+export declare function capsPage(chrome: Chrome, caps: Capability[] | null, gaps: Gap[], repo: string, now?: Date): Screen;
+/** Whether the bot's saved delivery state reports a problem (no new check runs). */
+export declare function telegramTrouble(store: Store, bot: TokenSource | null): boolean;
+/** v98: how the bot's messages reach Toolroll, in words: pushed to the public address, or asked for. */
+export declare function telegramDeliveryWords(store: Store, bot: TokenSource | null): string | null;
+/** The projects this person can see, by name, and whether they muted each one's pings. */
+export declare function notificationProjects(store: Store, account: string): {
+    repo: string;
+    name: string;
+    muted: boolean;
+}[];
+export declare function settingsPage(chrome: Chrome, existing: TokenSource | null, hasEnv: boolean, csrf: string, problem: string | null, messaging?: {
+    channel: string | null;
+    implicit: boolean;
+    configured: string[];
+    legacyWarning?: string;
+} | null, push?: {
+    available: boolean;
+    devices: PushSubscription[];
+} | null, providerKeys?: {
+    provider: string;
+    envName: string;
+    set: boolean;
+    updatedAt: string | null;
+    ambient: boolean;
+    mode: "subscription" | "api-key";
+    subscriptionCapable: boolean;
+    connection?: ProviderConnection;
+}[] | null, digest?: {
+    everyMs: number | null;
+    lastSentAt: string | null;
+    held: number;
+} | null, permissionDefault?: {
+    mode: UnattendedPermissionMode;
+    updatedAt: string | null;
+    updatedBy: string | null;
+    canManage: boolean;
+} | null, qualityDefault?: {
+    mode: QualityMode;
+    updatedAt: string | null;
+    updatedBy: string | null;
+    canManage: boolean;
+} | null, email?: NonNullable<BrowserSettingsView["email"]> | null, telegramDelivery?: string | null, workers?: NonNullable<BrowserSettingsView["workers"]> | null, updates?: BrowserUpdates | null, firstResult?: string | null, chatNotices?: {
+    mode: "quiet" | "all";
+    digestAt: string | null;
+    screenshots?: ResultScreenshots;
+    projects?: {
+        repo: string;
+        name: string;
+        muted: boolean;
+    }[];
+} | null, telegramFailing?: boolean, phone?: BrowserPhoneCard | null): Screen;
+/** The phone setup for the server-rendered Settings page: the same choices as the React card. */
+export declare function phoneSetupHtml(phone: BrowserPhoneCard): Html;
+/** Every worker that is not retired: its capacity, and the tasks it holds now. */
+export declare function settingsWorkers(store: Store, now: Date): NonNullable<BrowserSettingsView["workers"]>;
+/** The page's workers section, for browsers without the app script. */
+export declare function workersCard(workers: NonNullable<BrowserSettingsView["workers"]> | null): Html;
+/** Settings → Updates, for browsers without the app script. */
+export declare function updatesCard(updates: BrowserUpdates | null): Html;
+/** Choices save the moment they change; without the script the Save
+ * button stays and the form works the same. */
+export declare const SETTINGS_AUTOSAVE_SCRIPT = "(function(){document.querySelectorAll('form[data-autosave]').forEach(function(form){form.classList.add('js-autosave');form.addEventListener('change',function(ev){var t=ev.target;if(t&&(t.type==='radio'||t.tagName==='SELECT')){if(form.requestSubmit)form.requestSubmit();else form.submit();}});});})();";
+/** The newest release, remembered for a while so the page stays quick. */
+export declare let latestSeen: {
+    at: number;
+    value: {
+        version: string;
+    } | {
+        problem: string;
+    };
+} | null;
+export declare function latestReleaseFor(latest: (() => Promise<{
+    version: string;
+}>) | undefined): Promise<{
+    version: string;
+} | {
+    problem: string;
+}>;
+/** Settings destinations under short headings: an icon and a name each, and a chat app's logo and state. */
+export declare function settingsTiles(groups: BrowserSettingsGroup[]): Html;
+/** Each destination once, in order: a group's heading, then its [href, label, icon] tiles. */
+export declare const SETTINGS_GROUPS: [string, [string, string, Html][]][];
+export declare const SETTINGS_TILE_ICONS: Map<string, Html>;
+export declare const CHAT_APP_TILES: Record<string, BrandIconId>;
+/**
+ * The settings groups, with each chat app's state from what the server already holds: not set up,
+ * connected, or getting alerts (only when that service was chosen, or is the only one).
+ * A Telegram bot whose saved delivery state reports a problem says so instead. With no config folder
+ * the state is unknown, so the tiles carry none.
+ */
+export declare function settingsGroups(messaging: {
+    channel: string | null;
+    implicit: boolean;
+    configured: string[];
+} | null, telegramFailing?: boolean): BrowserSettingsGroup[];
+/** Light, dark or the device's choice, one tap each. Per browser (a cookie). */
+export declare function appearanceCard(csrf: string): Html;