@jobshimo/browser-link 0.41.0 → 0.42.0

package/README.md

@@ -59,10 +59,12 @@ The fastest path is the interactive UI — a full-screen [Ink](https://github.co
 browser-link
 ```
 
-That opens the welcome screen and then a setup menu to register with
-**Claude Code**, **OpenCode** or **GitHub Copilot CLI**, see the Chrome
-extension install steps, run a doctor diagnose, and manage per-tool
-permissions.
+That opens the welcome screen and then a status view: the running server,
+its ports, multi-agent, the instructions block per client, cdp-direct and
+updates, with the setup menu's entries and hotkeys right below it (Tab opens
+the full menu) to register with **Claude Code**, **OpenCode** or **GitHub
+Copilot CLI**, see the Chrome extension install steps, run a doctor
+diagnose, and manage per-tool permissions.
 
 Or drive it directly:
 
@@ -134,6 +136,12 @@ browser-link map import map.json            # restore it (merge by default, --re
   show "running X / installed Y", and the extension popup has a "Repair
   connection" button. See
   [Updating while a server is running](https://github.com/jobshimo/browser-link#updating-while-a-server-is-running).
+- **Admin panel**: the console's status view and the extension popup's
+  Admin section render the same server-built sections and labels (English
+  or Spanish). Every change that writes to disk shows a one-line preview and
+  waits for your confirmation; stopping or updating the server stays a
+  console command. See
+  [Admin panel](https://github.com/jobshimo/browser-link#admin-panel-console-and-popup).
 - **cdp-direct mode** (off by default): an extension-free transport gated
   behind `browser-link config set cdp-direct.enabled true` PLUS a
   time-boxed `browser-link cdp allow` grant — see

package/dist/admin/actions.d.ts

@@ -0,0 +1,57 @@
+import { type BrowserLinkConfig } from '../config.js';
+import { disableTools, enableTools } from '../commands/tools.js';
+import { disableAutoReelect, disableMultiAgent, enableAutoReelect, enableMultiAgent } from '../commands/multi-agent.js';
+import { setCdpDirectEnabled, setCdpDirectGrantTtl } from '../commands/config.js';
+import type { ClientId } from '../installers/index.js';
+import type { AdminActionResult } from '../messages.js';
+import { type AdminInput } from './descriptor.js';
+/**
+ * Admin actions (S2). The only way the popup changes server state, and a
+ * closed allowlist: an action id must name an actionable item of the state
+ * the server builds right now (so a tool outside the catalogue, a client
+ * that is not detected, or a readout can never be written), its value is
+ * checked against the item's kind and options, a disk write needs an
+ * explicit `confirm: true`, and the write itself goes through the SAME
+ * helper the CLI uses, never a new write path.
+ */
+export interface AdminActionRequest {
+    id: string;
+    value?: string | number | boolean;
+    confirm?: boolean;
+}
+/** The existing write helpers, injectable so tests can spy on each one. */
+export interface AdminHelpers {
+    saveConfig: (patch: Partial<BrowserLinkConfig>) => unknown;
+    enableTools: typeof enableTools;
+    disableTools: typeof disableTools;
+    enableMultiAgent: typeof enableMultiAgent;
+    disableMultiAgent: typeof disableMultiAgent;
+    enableAutoReelect: typeof enableAutoReelect;
+    disableAutoReelect: typeof disableAutoReelect;
+    setCdpDirectEnabled: typeof setCdpDirectEnabled;
+    setCdpDirectGrantTtl: typeof setCdpDirectGrantTtl;
+    installInstructionsFor: (client: ClientId) => {
+        ok: boolean;
+        message?: string;
+    };
+    uninstallInstructionsFor: (client: ClientId) => {
+        ok: boolean;
+        message?: string;
+    };
+    installFor: (client: ClientId) => {
+        installedClient: boolean;
+        message: string;
+    };
+}
+export declare const DEFAULT_ADMIN_HELPERS: AdminHelpers;
+export interface AdminActionDeps {
+    /** Fresh facts for the state; called before and after the action. */
+    input: () => Promise<AdminInput>;
+    /** `runDoctor` + `formatDoctor`, split into lines. Slow: runs only on the button. */
+    doctor: () => Promise<string[]>;
+    /** A forced update check, formatted into lines (network). */
+    checkUpdates: () => Promise<string[]>;
+    helpers?: Partial<AdminHelpers>;
+}
+/** Validate, confirm, apply. Never throws: every failure is `ok: false`. */
+export declare function applyAdminAction(req: AdminActionRequest, deps: AdminActionDeps): Promise<AdminActionResult>;

package/dist/admin/actions.js

@@ -0,0 +1,163 @@
+import { saveConfig } from '../config.js';
+import { disableTools, enableTools } from '../commands/tools.js';
+import { disableAutoReelect, disableMultiAgent, enableAutoReelect, enableMultiAgent, } from '../commands/multi-agent.js';
+import { setCdpDirectEnabled, setCdpDirectGrantTtl } from '../commands/config.js';
+import { installInstructionsFor, uninstallInstructionsFor } from '../commands/instructions.js';
+import { installFor } from '../commands/install.js';
+import { adminItems, adminLanguage, buildAdminState } from './descriptor.js';
+import { ADMIN_I18N } from './i18n.js';
+export const DEFAULT_ADMIN_HELPERS = {
+    saveConfig,
+    enableTools,
+    disableTools,
+    enableMultiAgent,
+    disableMultiAgent,
+    enableAutoReelect,
+    disableAutoReelect,
+    setCdpDirectEnabled,
+    setCdpDirectGrantTtl,
+    installInstructionsFor,
+    uninstallInstructionsFor,
+    installFor: (client) => installFor(client),
+};
+/** Toggles whose value is one config key written with `saveConfig`, exactly
+ * as the console does for the keys without a dedicated CLI helper. */
+const PLAIN_TOGGLES = [
+    'instructionsAutoRefresh',
+    'activityEnabled',
+    'activityRecordPayloads',
+];
+function isPlainToggle(id) {
+    return PLAIN_TOGGLES.includes(id);
+}
+class AdminRefusal extends Error {
+}
+function suffix(id, prefix) {
+    return id.startsWith(prefix) ? id.slice(prefix.length) : null;
+}
+function lines(text) {
+    return text === undefined || text.length === 0 ? [] : text.split('\n');
+}
+function checkValue(item, value) {
+    if (item.kind === 'toggle')
+        return typeof value === 'boolean';
+    if (item.kind === 'select') {
+        if (typeof value !== 'string' && typeof value !== 'number')
+            return false;
+        return (item.options ?? []).some((o) => o.value === String(value));
+    }
+    return true;
+}
+function preview(item, value, input) {
+    const t = ADMIN_I18N[adminLanguage(input.config)];
+    const tool = suffix(item.id, 'tools.');
+    if (tool !== null)
+        return value === true ? t.previewToolOn(tool) : t.previewToolOff(tool);
+    if (item.kind === 'toggle')
+        return t.previewToggle(item.label, value === true);
+    if (item.kind === 'select') {
+        const option = item.options?.find((o) => o.value === String(value));
+        return t.previewSelect(item.label, option?.label ?? String(value));
+    }
+    const displayName = (id) => input.instructions.find((s) => s.id === id)?.displayName ??
+        input.clients.find((c) => c.id === id)?.displayName ??
+        String(id);
+    const install = suffix(item.id, 'instructions.install.');
+    if (install !== null)
+        return t.previewInstall(displayName(install));
+    const uninstall = suffix(item.id, 'instructions.uninstall.');
+    if (uninstall !== null)
+        return t.previewUninstall(displayName(uninstall));
+    return t.previewRegister(displayName(suffix(item.id, 'client.register.')));
+}
+/** Runs the write for one validated, confirmed item. Returns output lines;
+ * throws an `AdminRefusal` (or the helper's own error) when it refused. */
+async function apply(item, value, input, deps, h) {
+    const language = adminLanguage(input.config);
+    const on = value === true;
+    const { id } = item;
+    if (id === 'doctor')
+        return deps.doctor();
+    if (id === 'updates.check')
+        return deps.checkUpdates();
+    if (id === 'language') {
+        h.saveConfig({ language: value === 'es' ? 'es' : 'en' });
+        return [];
+    }
+    const tool = suffix(id, 'tools.');
+    if (tool !== null) {
+        return lines(on ? h.enableTools([tool], language) : h.disableTools([tool], language));
+    }
+    if (id === 'multiAgent') {
+        return lines(on ? h.enableMultiAgent(language) : h.disableMultiAgent(language));
+    }
+    if (id === 'autoReelect') {
+        return lines(on ? h.enableAutoReelect(language) : h.disableAutoReelect(language));
+    }
+    if (isPlainToggle(id)) {
+        h.saveConfig({ [id]: on });
+        return [];
+    }
+    if (id === 'cdpDirectEnabled')
+        return lines(h.setCdpDirectEnabled(String(on), language));
+    if (id === 'cdpDirectGrantTtlMinutes') {
+        return lines(h.setCdpDirectGrantTtl(String(value), language));
+    }
+    const install = suffix(id, 'instructions.install.');
+    const uninstall = suffix(id, 'instructions.uninstall.');
+    if (install !== null || uninstall !== null) {
+        const report = install !== null
+            ? h.installInstructionsFor(install)
+            : h.uninstallInstructionsFor(uninstall);
+        if (!report.ok)
+            throw new AdminRefusal(report.message ?? id);
+        return lines(report.message);
+    }
+    const register = suffix(id, 'client.register.');
+    if (register !== null) {
+        const report = h.installFor(register);
+        if (!report.installedClient)
+            throw new AdminRefusal(report.message);
+        return lines(report.message);
+    }
+    // Reaching here means the descriptor offers an actionable item this
+    // module does not know: refuse rather than guess.
+    throw new AdminRefusal(ADMIN_I18N[language].unknownAction(id));
+}
+/** Validate, confirm, apply. Never throws: every failure is `ok: false`. */
+export async function applyAdminAction(req, deps) {
+    try {
+        const input = await deps.input();
+        const t = ADMIN_I18N[adminLanguage(input.config)];
+        const item = adminItems(buildAdminState(input)).find((i) => i.id === req.id);
+        if (!item)
+            return { ok: false, error: t.unknownAction(req.id) };
+        if (item.kind === 'readout' || item.kind === 'link') {
+            return { ok: false, error: t.notAnAction(item.id) };
+        }
+        if (!checkValue(item, req.value))
+            return { ok: false, error: t.invalidValue(item.id) };
+        if (item.writesDisk && req.confirm !== true) {
+            return {
+                ok: true,
+                applied: false,
+                needsConfirm: true,
+                preview: preview(item, req.value, input),
+            };
+        }
+        const helpers = { ...DEFAULT_ADMIN_HELPERS, ...deps.helpers };
+        const output = await apply(item, req.value, input, deps, helpers);
+        const state = buildAdminState(await deps.input());
+        return {
+            ok: true,
+            applied: true,
+            ...(item.requiresRestart ? { requiresRestart: true } : {}),
+            state,
+            ...(output.length > 0 ? { output } : {}),
+        };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/admin/actions.js.map

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

package/dist/admin/descriptor.d.ts

@@ -0,0 +1,65 @@
+import { type BrowserLinkConfig } from '../config.js';
+import type { ClientInstructionsStatus } from '../manual/status.js';
+import type { ClientId } from '../installers/index.js';
+import type { DoctorServerStatus } from '../commands/doctor.js';
+import type { Language } from '../commands/welcome.js';
+import type { AdminItem, AdminState } from '../messages.js';
+/**
+ * The admin descriptor (S1): one source of truth for what the console's
+ * status view and the popup's Admin section show. `buildAdminState` is pure:
+ * every fact arrives in `AdminInput`, gathered by `admin/sources.ts` in the
+ * primary (in process) or in the console (out of process, through the
+ * primary's `/version`). Every string is localised here.
+ *
+ * Process-ending operations (`stop`/free-port, self-update) are never
+ * actions: they would end the very primary that answers the popup, so they
+ * are readouts carrying the console command instead.
+ */
+export declare const REPO_URL = "https://github.com/jobshimo/browser-link";
+export declare const STOP_COMMAND = "browser-link stop";
+export declare const SELF_UPDATE_COMMAND = "npm install -g @jobshimo/browser-link@latest";
+export interface AdminClient {
+    id: ClientId;
+    displayName: string;
+    /** The client's config exists on this machine. */
+    installed: boolean;
+    /** browser-link is already registered in it. */
+    registered: boolean;
+}
+export interface AdminInput {
+    config: BrowserLinkConfig;
+    /** Epoch ms used for `generatedAt` and the uptime. */
+    now: number;
+    /** The version of the process building the state. */
+    version: string;
+    /** Running primary (from `/version` or in process) against the version on disk. */
+    server: DoctorServerStatus;
+    /** `null` when unknown: the console runs out of process. */
+    tabsConnected: number | null;
+    ports: {
+        ws: number;
+        ipc: number;
+    };
+    extension: {
+        path: string | null;
+        connectedVersion: string | null;
+    };
+    instructions: readonly ClientInstructionsStatus[];
+    clients: readonly AdminClient[];
+    cdpGrant: {
+        live: boolean;
+        remainingMs: number | null;
+    };
+    /** Cached update check; `null` when none ran yet. */
+    update: {
+        latest: string | null;
+        isNewer: boolean;
+    } | null;
+    toolNames: readonly string[];
+    downloadsDir: string;
+}
+export declare function adminLanguage(config: BrowserLinkConfig): Language;
+export declare function formatUptime(ms: number): string;
+export declare function buildAdminState(input: AdminInput): AdminState;
+/** Every item of a state, in display order. */
+export declare function adminItems(state: AdminState): AdminItem[];

package/dist/admin/descriptor.js

@@ -0,0 +1,205 @@
+import { DEFAULT_CDP_DIRECT_PORT, DEFAULT_GRANT_TTL_MINUTES, } from '../config.js';
+import { ADMIN_I18N } from './i18n.js';
+/**
+ * The admin descriptor (S1): one source of truth for what the console's
+ * status view and the popup's Admin section show. `buildAdminState` is pure:
+ * every fact arrives in `AdminInput`, gathered by `admin/sources.ts` in the
+ * primary (in process) or in the console (out of process, through the
+ * primary's `/version`). Every string is localised here.
+ *
+ * Process-ending operations (`stop`/free-port, self-update) are never
+ * actions: they would end the very primary that answers the popup, so they
+ * are readouts carrying the console command instead.
+ */
+export const REPO_URL = 'https://github.com/jobshimo/browser-link';
+export const STOP_COMMAND = 'browser-link stop';
+export const SELF_UPDATE_COMMAND = 'npm install -g @jobshimo/browser-link@latest';
+/** Common lifetimes for the cdp-direct grant select; `0` = never expires. */
+const GRANT_TTL_CHOICES = [15, 30, 60, 240, 1440, 0];
+export function adminLanguage(config) {
+    return config.language === 'es' ? 'es' : 'en';
+}
+function readout(id, label, value, extra = {}) {
+    return { id, kind: 'readout', label, value, writesDisk: false, ...extra };
+}
+function toggle(id, label, value, requiresRestart = false) {
+    return {
+        id,
+        kind: 'toggle',
+        label,
+        value,
+        writesDisk: true,
+        ...(requiresRestart ? { requiresRestart: true } : {}),
+    };
+}
+export function formatUptime(ms) {
+    const totalMinutes = Math.max(0, Math.floor(ms / 60_000));
+    const days = Math.floor(totalMinutes / 1440);
+    const hours = Math.floor((totalMinutes % 1440) / 60);
+    const minutes = totalMinutes % 60;
+    if (days > 0)
+        return `${days}d ${hours}h ${minutes}m`;
+    if (hours > 0)
+        return `${hours}h ${minutes}m`;
+    return `${minutes}m`;
+}
+function statusSection(input, t) {
+    const { server, config } = input;
+    const running = server.running;
+    const startedAt = running ? Date.parse(running.startedAt) : NaN;
+    const items = [
+        readout('status.server', t.server, running ? t.serverRunning(running.version) : t.serverNotRunning, running ? {} : { hint: t.serverNotRunningHint }),
+        readout('status.installed', t.installed, server.installed === null
+            ? t.unknown
+            : server.outdated
+                ? t.installedOutdated(server.installed)
+                : server.installed, server.outdated ? { hint: STOP_COMMAND } : {}),
+        readout('status.pid', t.pid, running ? running.pid : null),
+        readout('status.uptime', t.uptime, running && Number.isFinite(startedAt) ? formatUptime(input.now - startedAt) : null),
+        readout('status.tabs', t.tabs, input.tabsConnected, input.tabsConnected === null ? { hint: t.tabsUnknownHint } : {}),
+        readout('status.ports', t.ports, `WS ${input.ports.ws} · IPC ${input.ports.ipc}`),
+        readout('status.multiAgent', t.multiAgentStatus, config.multiAgent === false ? t.off : t.on),
+        readout('status.extension', t.extension, 
+        // Out of process the console cannot see the tabs, so it cannot know.
+        input.tabsConnected === null
+            ? t.unknown
+            : input.extension.connectedVersion === null
+                ? t.extensionNotConnected
+                : input.extension.connectedVersion === input.version
+                    ? t.extensionAligned(input.extension.connectedVersion)
+                    : t.extensionMismatch(input.extension.connectedVersion, input.version)),
+        ...input.instructions.map((s) => readout(`status.instructions.${s.id}`, t.instructionsFor(s.displayName), t.instructionsState(s.state))),
+        readout('status.cdpDirect', t.cdpDirect, config.cdpDirectEnabled !== true
+            ? t.off
+            : input.cdpGrant.live
+                ? t.cdpDirectGranted(input.cdpGrant.remainingMs === null
+                    ? null
+                    : Math.ceil(input.cdpGrant.remainingMs / 60_000))
+                : t.cdpDirectNoGrant),
+        readout('status.update', t.update, input.update === null || input.update.latest === null
+            ? t.unknown
+            : input.update.isNewer
+                ? t.updateAvailable(input.update.latest)
+                : t.upToDate, input.update?.isNewer === true ? { hint: SELF_UPDATE_COMMAND } : {}),
+        readout('status.activity', t.activity, config.activityEnabled === false ? t.off : t.on),
+    ];
+    return { id: 'status', title: t.sections.status, items };
+}
+function grantTtlOptions(current, t) {
+    const values = [...GRANT_TTL_CHOICES];
+    if (!values.includes(current))
+        values.unshift(current);
+    return values.map((n) => ({ value: String(n), label: n === 0 ? t.never : t.minutes(n) }));
+}
+function setupSection(input, t) {
+    const { config } = input;
+    const disabled = new Set(config.disabledTools ?? []);
+    const grantTtl = config.cdpDirectGrantTtlMinutes ?? DEFAULT_GRANT_TTL_MINUTES;
+    const items = [
+        {
+            id: 'language',
+            kind: 'select',
+            label: t.language,
+            value: adminLanguage(config),
+            options: [
+                { value: 'en', label: 'English' },
+                { value: 'es', label: 'Español' },
+            ],
+            writesDisk: true,
+        },
+        ...input.toolNames.map((name) => toggle(`tools.${name}`, t.tool(name), !disabled.has(name))),
+        toggle('multiAgent', t.multiAgent, config.multiAgent !== false, true),
+        toggle('autoReelect', t.autoReelect, config.autoReelect === true, true),
+        toggle('instructionsAutoRefresh', t.instructionsAutoRefresh, config.instructionsAutoRefresh !== false, true),
+        toggle('cdpDirectEnabled', t.cdpDirectEnabled, config.cdpDirectEnabled === true),
+        readout('cdpDirectPort', t.cdpDirectPort, config.cdpDirectPort ?? DEFAULT_CDP_DIRECT_PORT, {
+            hint: 'browser-link config set cdp-direct.port <port>',
+        }),
+        {
+            id: 'cdpDirectGrantTtlMinutes',
+            kind: 'select',
+            label: t.cdpDirectGrantTtl,
+            value: String(grantTtl),
+            options: grantTtlOptions(grantTtl, t),
+            writesDisk: true,
+        },
+        // Read once when the primary wires the trail, so a change needs a restart.
+        toggle('activityEnabled', t.activityEnabled, config.activityEnabled !== false, true),
+        toggle('activityRecordPayloads', t.activityRecordPayloads, config.activityRecordPayloads !== false, true),
+        readout('downloadsDir', t.downloadsDir, input.downloadsDir, {
+            hint: 'browser-link config set downloads.dir <absolute-path|default>',
+        }),
+        // These two keep their timestamped `settings.update` path (popup and
+        // `config set`), so the admin panel only shows them.
+        readout('idleTtl', t.idleTtl, config.idleTtlMinutes === undefined
+            ? t.popupDefault
+            : config.idleTtlMinutes === 0
+                ? t.never
+                : t.minutes(config.idleTtlMinutes), { hint: t.idleTtlHint }),
+        readout('flowRecording', t.flowRecording, config.flowRecordingEnabled === undefined
+            ? t.popupDefault
+            : config.flowRecordingEnabled
+                ? t.on
+                : t.off, { hint: t.flowRecordingHint }),
+    ];
+    return { id: 'setup', title: t.sections.setup, items };
+}
+function button(id, label, writesDisk, description) {
+    return { id, kind: 'button', label, writesDisk, ...(description ? { description } : {}) };
+}
+function diagnoseSection(input, t) {
+    const items = [
+        button('doctor', t.doctor, false),
+        button('updates.check', t.updatesCheck, false),
+    ];
+    for (const s of input.instructions) {
+        // A corrupt file is the CLI's business: the installers refuse to touch it.
+        if (s.state.kind === 'corrupt')
+            continue;
+        items.push(button(`instructions.install.${s.id}`, t.instructionsInstall(s.displayName), true));
+        if (s.state.kind === 'installed' || s.state.kind === 'installed-outdated') {
+            items.push(button(`instructions.uninstall.${s.id}`, t.instructionsUninstall(s.displayName), true));
+        }
+    }
+    for (const c of input.clients) {
+        if (!c.installed)
+            continue;
+        items.push(button(`client.register.${c.id}`, t.register(c.displayName), true, c.registered ? t.registered : t.notRegistered));
+    }
+    items.push(readout('stop', t.stop, STOP_COMMAND, { description: t.stopDescription }));
+    items.push(readout('selfUpdate', t.selfUpdate, SELF_UPDATE_COMMAND, {
+        description: t.selfUpdateDescription,
+    }));
+    return { id: 'diagnose', title: t.sections.diagnose, items };
+}
+function referenceSection(input, t) {
+    return {
+        id: 'reference',
+        title: t.sections.reference,
+        items: [
+            readout('about', t.about, t.aboutText),
+            { id: 'repo', kind: 'link', label: t.repo, value: REPO_URL, writesDisk: false },
+            readout('extension.path', t.extensionPath, input.extension.path ?? t.extensionNotFound),
+        ],
+    };
+}
+export function buildAdminState(input) {
+    const language = adminLanguage(input.config);
+    const t = ADMIN_I18N[language];
+    return {
+        version: 1,
+        generatedAt: new Date(input.now).toISOString(),
+        sections: [
+            statusSection(input, t),
+            setupSection(input, t),
+            diagnoseSection(input, t),
+            referenceSection(input, t),
+        ],
+        ui: { language, ...t.ui },
+    };
+}
+/** Every item of a state, in display order. */
+export function adminItems(state) {
+    return state.sections.flatMap((s) => s.items);
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/admin/descriptor.js.map

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

package/dist/admin/i18n.d.ts

@@ -0,0 +1,90 @@
+import type { Language } from '../commands/welcome.js';
+import type { InstructionsState } from '../agent-instructions/index.js';
+import type { AdminUiStrings } from '../messages.js';
+/**
+ * Every string the admin descriptor and actions send, for `en` and `es`.
+ * The server localises here so the popup renders the state dumbly; the
+ * console keeps its own per-screen tables for everything else.
+ */
+export interface AdminI18n {
+    ui: Omit<AdminUiStrings, 'language'>;
+    sections: {
+        status: string;
+        setup: string;
+        diagnose: string;
+        reference: string;
+    };
+    on: string;
+    off: string;
+    unknown: string;
+    server: string;
+    serverRunning: (version: string) => string;
+    serverNotRunning: string;
+    serverNotRunningHint: string;
+    installed: string;
+    installedOutdated: (installed: string) => string;
+    pid: string;
+    uptime: string;
+    tabs: string;
+    tabsUnknownHint: string;
+    ports: string;
+    multiAgentStatus: string;
+    extension: string;
+    extensionAligned: (version: string) => string;
+    extensionMismatch: (ext: string, server: string) => string;
+    extensionNotConnected: string;
+    instructionsFor: (client: string) => string;
+    instructionsState: (state: InstructionsState) => string;
+    cdpDirect: string;
+    cdpDirectGranted: (minutes: number | null) => string;
+    cdpDirectNoGrant: string;
+    update: string;
+    updateAvailable: (latest: string) => string;
+    upToDate: string;
+    activity: string;
+    language: string;
+    tool: (name: string) => string;
+    multiAgent: string;
+    autoReelect: string;
+    instructionsAutoRefresh: string;
+    cdpDirectEnabled: string;
+    cdpDirectPort: string;
+    cdpDirectGrantTtl: string;
+    minutes: (n: number) => string;
+    never: string;
+    activityEnabled: string;
+    activityRecordPayloads: string;
+    downloadsDir: string;
+    idleTtl: string;
+    idleTtlHint: string;
+    flowRecording: string;
+    flowRecordingHint: string;
+    popupDefault: string;
+    doctor: string;
+    updatesCheck: string;
+    instructionsInstall: (client: string) => string;
+    instructionsUninstall: (client: string) => string;
+    register: (client: string) => string;
+    registered: string;
+    notRegistered: string;
+    stop: string;
+    stopDescription: string;
+    selfUpdate: string;
+    selfUpdateDescription: string;
+    about: string;
+    aboutText: string;
+    repo: string;
+    extensionPath: string;
+    extensionNotFound: string;
+    unknownAction: (id: string) => string;
+    notAnAction: (id: string) => string;
+    invalidValue: (id: string) => string;
+    previewToolOn: (name: string) => string;
+    previewToolOff: (name: string) => string;
+    previewToggle: (label: string, on: boolean) => string;
+    previewSelect: (label: string, option: string) => string;
+    previewInstall: (client: string) => string;
+    previewUninstall: (client: string) => string;
+    previewRegister: (client: string) => string;
+}
+export declare const ADMIN_I18N: Record<Language, AdminI18n>;