@nordbyte/nordrelay 0.2.1

package/dist/bot-preferences.js

@@ -0,0 +1,146 @@
+import path from "node:path";
+import { readJsonFileWithBackup, writeJsonFileAtomic } from "./persistence.js";
+export class BotPreferencesStore {
+    persistPath;
+    contexts = new Map();
+    constructor(workspace) {
+        this.persistPath = path.join(workspace, ".nordrelay", "preferences.json");
+        this.load();
+    }
+    get(contextKey) {
+        return { ...(this.contexts.get(contextKey) ?? {}) };
+    }
+    update(contextKey, patch) {
+        const current = this.contexts.get(contextKey) ?? {};
+        const next = pruneEmptyPreferences({
+            ...current,
+            ...patch,
+        });
+        this.contexts.set(contextKey, next);
+        this.persist();
+        return { ...next };
+    }
+    clear(contextKey) {
+        this.contexts.delete(contextKey);
+        this.persist();
+    }
+    persist() {
+        const payload = {
+            version: 1,
+            contexts: Object.fromEntries(this.contexts.entries()),
+        };
+        writeJsonFileAtomic(this.persistPath, payload);
+    }
+    load() {
+        const result = readJsonFileWithBackup(this.persistPath);
+        if (!result.value?.contexts || typeof result.value.contexts !== "object") {
+            return;
+        }
+        for (const [contextKey, rawPreferences] of Object.entries(result.value.contexts)) {
+            const preferences = normalizePreferences(rawPreferences);
+            if (preferences) {
+                this.contexts.set(contextKey, preferences);
+            }
+        }
+    }
+}
+export function parseMirrorMode(value, fallback) {
+    const normalized = value?.trim().toLowerCase();
+    if (normalized === "off" || normalized === "status" || normalized === "final" || normalized === "full") {
+        return normalized;
+    }
+    return fallback;
+}
+export function parseNotifyMode(value, fallback) {
+    const normalized = value?.trim().toLowerCase();
+    if (normalized === "off" || normalized === "minimal" || normalized === "all") {
+        return normalized;
+    }
+    return fallback;
+}
+export function parseVoiceBackendPreference(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (normalized === "parakeet" ||
+        normalized === "faster-whisper" ||
+        normalized === "openai") {
+        return normalized;
+    }
+    return "auto";
+}
+export function parseQuietHours(value) {
+    if (!value) {
+        return null;
+    }
+    const match = value.trim().match(/^(\d{1,2})\s*-\s*(\d{1,2})$/);
+    if (!match) {
+        throw new Error("Quiet hours must use HH-HH format, e.g. 22-7");
+    }
+    const startHour = Number(match[1]);
+    const endHour = Number(match[2]);
+    if (!Number.isInteger(startHour) || !Number.isInteger(endHour) || startHour < 0 || startHour > 23 || endHour < 0 || endHour > 23) {
+        throw new Error("Quiet hours must use hours from 0 to 23");
+    }
+    return { startHour, endHour };
+}
+export function isQuietNow(quietHours, now = new Date()) {
+    if (!quietHours) {
+        return false;
+    }
+    const hour = now.getHours();
+    if (quietHours.startHour === quietHours.endHour) {
+        return true;
+    }
+    if (quietHours.startHour < quietHours.endHour) {
+        return hour >= quietHours.startHour && hour < quietHours.endHour;
+    }
+    return hour >= quietHours.startHour || hour < quietHours.endHour;
+}
+export function formatQuietHours(quietHours) {
+    if (!quietHours) {
+        return "off";
+    }
+    return `${quietHours.startHour.toString().padStart(2, "0")}-${quietHours.endHour.toString().padStart(2, "0")}`;
+}
+function normalizePreferences(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const candidate = value;
+    return pruneEmptyPreferences({
+        mirrorMode: isMirrorMode(candidate.mirrorMode) ? candidate.mirrorMode : undefined,
+        notifyMode: isNotifyMode(candidate.notifyMode) ? candidate.notifyMode : undefined,
+        quietHours: normalizeQuietHours(candidate.quietHours),
+        voiceBackend: isVoiceBackendPreference(candidate.voiceBackend) ? candidate.voiceBackend : undefined,
+        voiceLanguage: typeof candidate.voiceLanguage === "string" ? candidate.voiceLanguage : candidate.voiceLanguage === null ? null : undefined,
+        voiceTranscribeOnly: typeof candidate.voiceTranscribeOnly === "boolean" ? candidate.voiceTranscribeOnly : undefined,
+    });
+}
+function pruneEmptyPreferences(preferences) {
+    return Object.fromEntries(Object.entries(preferences).filter(([, value]) => value !== undefined));
+}
+function normalizeQuietHours(value) {
+    if (value === null) {
+        return null;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const candidate = value;
+    return Number.isInteger(candidate.startHour) &&
+        Number.isInteger(candidate.endHour) &&
+        candidate.startHour >= 0 &&
+        candidate.startHour <= 23 &&
+        candidate.endHour >= 0 &&
+        candidate.endHour <= 23
+        ? { startHour: candidate.startHour, endHour: candidate.endHour }
+        : undefined;
+}
+function isMirrorMode(value) {
+    return value === "off" || value === "status" || value === "final" || value === "full";
+}
+function isNotifyMode(value) {
+    return value === "off" || value === "minimal" || value === "all";
+}
+function isVoiceBackendPreference(value) {
+    return value === "auto" || value === "parakeet" || value === "faster-whisper" || value === "openai";
+}

package/dist/bot-ui.js

@@ -0,0 +1,161 @@
+import { escapeHTML } from "./format.js";
+/**
+ * Grouped command reference for /help.
+ */
+export function renderHelpMessage() {
+    const sections = [
+        {
+            title: "💬 Session",
+            commands: [
+                ["/new", "Start a new thread"],
+                ["/agent", "Select Codex or Pi"],
+                ["/session", "Current thread details"],
+                ["/sessions", "Browse & switch threads"],
+                ["/sync", "Sync active sessions from CLI state"],
+                ["/pinned", "Show pinned threads"],
+                ["/pin", "Pin current or given thread"],
+                ["/unpin", "Unpin current or given thread"],
+                ["/attach", "Bind a session to this topic"],
+                ["/handback", "Hand session back to CLI"],
+                ["/abort", "Cancel current operation"],
+                ["/stop", "Cancel current operation"],
+                ["/retry", "Resend the last prompt"],
+                ["/queue", "Show queued prompts with cancel buttons"],
+                ["/cancel", "Cancel a queued prompt"],
+                ["/clearqueue", "Clear queued prompts"],
+                ["/artifacts", "List or resend generated files"],
+                ["/workspaces", "List allowed workspaces"],
+            ],
+        },
+        {
+            title: "🤖 Model",
+            commands: [
+                ["/launch_profiles", "Select launch profile"],
+                ["/fast", "Toggle fast mode"],
+                ["/model", "View & change model"],
+                ["/reasoning", "Set reasoning effort"],
+                ["/mirror", "Control CLI mirroring"],
+                ["/notify", "Control completion notifications"],
+            ],
+        },
+        {
+            title: "🔐 Auth",
+            commands: [
+                ["/auth", "Check auth status"],
+                ["/login", "Start authentication"],
+                ["/logout", "Sign out"],
+            ],
+        },
+        {
+            title: "ℹ️ Utility",
+            commands: [
+                ["/start", "Welcome & status"],
+                ["/help", "This reference"],
+                ["/voice", "Voice transcription status"],
+                ["/status", "Connector runtime status"],
+                ["/health", "Connector health report"],
+                ["/version", "Connector version"],
+                ["/tasks", "Current turn progress"],
+                ["/activity", "Thread activity timeline"],
+            ],
+        },
+        {
+            title: "🛠️ Admin",
+            commands: [
+                ["/logs", "Show connector log tail"],
+                ["/diagnostics", "Connector diagnostics"],
+                ["/restart", "Restart connector"],
+                ["/update", "Pull, build, and restart"],
+            ],
+        },
+    ];
+    const htmlLines = [];
+    const plainLines = [];
+    for (const section of sections) {
+        htmlLines.push(`<b>${escapeHTML(section.title)}</b>`);
+        plainLines.push(section.title);
+        for (const [cmd, desc] of section.commands) {
+            htmlLines.push(`  ${cmd} — ${escapeHTML(desc)}`);
+            plainLines.push(`  ${cmd} — ${desc}`);
+        }
+        htmlLines.push("");
+        plainLines.push("");
+    }
+    while (htmlLines.at(-1) === "") {
+        htmlLines.pop();
+    }
+    while (plainLines.at(-1) === "") {
+        plainLines.pop();
+    }
+    return {
+        html: htmlLines.join("\n"),
+        plain: plainLines.join("\n"),
+    };
+}
+/**
+ * Short /start message for first-time users (no prior interaction in this context).
+ */
+export function renderWelcomeFirstTime(authWarning) {
+    const htmlLines = [
+        "<b>👋 NordRelay is ready.</b>",
+        "",
+        "Send a message to start chatting with the selected coding agent.",
+        "You can also send voice notes, photos, or documents.",
+        "",
+        "Type /help for all commands.",
+    ];
+    const plainLines = [
+        "👋 NordRelay is ready.",
+        "",
+        "Send a message to start chatting with the selected coding agent.",
+        "You can also send voice notes, photos, or documents.",
+        "",
+        "Type /help for all commands.",
+    ];
+    if (authWarning) {
+        htmlLines.push("", `⚠️ ${escapeHTML(authWarning)}`);
+        plainLines.push("", `⚠️ ${authWarning}`);
+    }
+    return { html: htmlLines.join("\n"), plain: plainLines.join("\n") };
+}
+/**
+ * Concise /start message for returning users with session info.
+ */
+export function renderWelcomeReturning(sessionHtml, sessionPlain, isTopicSession, authWarning) {
+    const label = isTopicSession
+        ? "NordRelay (topic session)"
+        : "NordRelay";
+    const htmlLines = [`<b>👋 ${escapeHTML(label)}</b>`, "", sessionHtml];
+    const plainLines = [`👋 ${label}`, "", sessionPlain];
+    if (authWarning) {
+        htmlLines.push("", `⚠️ ${escapeHTML(authWarning)}`);
+        plainLines.push("", `⚠️ ${authWarning}`);
+    }
+    return { html: htmlLines.join("\n"), plain: plainLines.join("\n") };
+}
+/**
+ * Format a session button label for /sessions list.
+ * Wider workspace name (12 chars), model tag, short thread snippet.
+ */
+export function formatSessionLabel(options) {
+    const prefix = options.isActive ? "✅" : options.isPinned ? "⭐" : "📁";
+    const workspaceName = trimLabel(getWorkspaceShortName(options.workspace), 12) || "(unknown)";
+    const title = trimLabel(options.title || "(untitled)", 20) || "(untitled)";
+    const time = options.relativeTime;
+    let label = `${prefix} ${workspaceName} · ${title} · ${time}`;
+    if (options.model) {
+        const shortModel = trimLabel(options.model, 10);
+        label += ` · ${shortModel}`;
+    }
+    return label;
+}
+function trimLabel(text, maxLength) {
+    const singleLine = text.replace(/\s+/g, " ").trim();
+    if (singleLine.length <= maxLength) {
+        return singleLine;
+    }
+    return `${singleLine.slice(0, maxLength - 1)}…`;
+}
+function getWorkspaceShortName(workspace) {
+    return workspace.split(/[\\/]/).filter(Boolean).pop() ?? workspace;
+}