deck-plugin-sdk 1.10.2 → 1.11.0

package/types/core/bridge.d.ts

@@ -1,1084 +1,1167 @@
-// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
-import { type DebugTarget } from "./debugtargets";
-import type { Accent, Background, Density, Palette, TermCustom, TermTheme } from "./theme";
-import type { SearchEngine } from "./browserurl";
-/** Open a URL in the default browser. */
-export declare const openExternal: (url: string) => Promise<void>;
-/** A box in physical pixels, relative to the window: where a browser pane's webview goes. */
-export interface PhysRect {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
-/** Open `url` in the browser pane's own webview (created the first time) at `r`. A private one
- *  keeps no cookies, history or cache. */
-export declare const browserOpen: (pane: string, url: string, isPrivate: boolean, r: PhysRect, window?: string) => Promise<void>;
-/** Move the pane's webview, or hide it. */
-export declare const browserBounds: (pane: string, r: PhysRect, visible: boolean, window?: string) => Promise<void>;
-export declare const browserNav: (pane: string, action: "back" | "forward" | "reload" | "go" | "focus", url?: string) => Promise<void>;
-/** The chords Rust takes from a focused page: `deck` moves the keyboard back to Deck, `page` does not. */
-export declare const browserSetKeys: (deck: string[], page: string[]) => Promise<void>;
-export declare const browserClose: (pane: string) => Promise<void>;
-/** Answer a site's sign-in (user and password, or neither to cancel) or its certificate error (proceed). */
-export declare const browserSiteAnswer: (pane: string, id: number, a: {
-    user?: string;
-    password?: string;
-    proceed?: boolean;
-}) => Promise<void>;
-/** The page's print dialog, or its Save as dialog. */
-export declare const browserPrint: (pane: string, action: "print" | "save") => Promise<void>;
-/** Answer a site's request to send notifications (the pane's bar). */
-export declare const browserPermissionAnswer: (pane: string, id: number, allow: boolean) => Promise<void>;
-/** Open the app link (mailto:, zoommtg:) the pane asked for. */
-export declare const browserOpenAppLink: (pane: string, uri: string) => Promise<void>;
-/** A page's notification was clicked in Deck: the page hears of it. */
-export declare const browserNotificationClicked: (pane: string, id: number) => Promise<void>;
-/** Reload a page whose process hangs: that process is ended first. */
-export declare const browserReloadHung: (pane: string) => Promise<void>;
-/** The window fullscreen for a page that went fullscreen, or back as it was. */
-export declare const browserWindowFullscreen: (on: boolean, window?: string) => Promise<void>;
-/** Put a hidden pane's page to sleep, or wake it. */
-export declare const browserSleep: (pane: string, on: boolean) => Promise<void>;
-/** A JPEG of what the pane's webview shows. */
-/** The ad blocker on or off, and the sites it is off for. */
-export declare const adblockConfig: (enabled: boolean, off: string[], youtube: boolean) => Promise<void>;
-/** Whether the ad blocker is ready, how many rules it holds, and when its lists were downloaded. */
-export declare const adblockInfo: () => Promise<{
-    ready: boolean;
-    rules: number;
-    updated: number;
-}>;
-/** Rebuild the ad blocker from its lists and the user's own rules, after those changed. */
-export declare const adblockRebuild: () => Promise<void>;
-/** Download the ad blocker's lists again now. */
-export declare const adblockUpdate: () => Promise<void>;
-/** The browser's privacy settings, for every browser pane. */
-/** `scheme`: the light or dark mode pages are asked for (prefers-color-scheme); "auto" is Windows'. */
-export declare const browserPrivacy: (tracking: string, autofill: boolean, scheme: "light" | "dark" | "auto") => Promise<void>;
-/** Clear the browser's stored data of these kinds (cookies, cache, passwords, autofill) since `since`
- *  (seconds since 1970; 0 for all of it). */
-export declare const browserClear: (kinds: string[], since: number) => Promise<void>;
-/** The user's answer to an agent asking to be signed in on a page: the login to fill, or none. */
-export declare const browserAgentFillAnswer: (id: number, login: string | null) => Promise<void>;
-/** A saved login, without its secrets. */
-export interface VaultMeta {
-    id: string;
-    site: string;
-    username: string;
-    note: string;
-    totp: boolean;
-    created: number;
-    updated: number;
-    used: number;
-}
-/** A login to save: a password or 2FA key left out keeps the saved one; an empty 2FA key removes it. */
-export interface VaultEntryIn {
-    id?: string;
-    site: string;
-    username: string;
-    password?: string;
-    note?: string;
-    totp?: string;
-}
-export declare const vaultStatus: () => Promise<{
-    exists: boolean;
-    unlocked: boolean;
-}>;
-/** The minutes before the vault locks itself, and whether to offer saving a sign-in. */
-export declare const vaultConfig: (autolockMinutes: number, offer: boolean) => Promise<void>;
-export declare const vaultCreate: (password: string) => Promise<void>;
-export declare const vaultUnlock: (password: string) => Promise<void>;
-export declare const vaultLock: () => Promise<void>;
-export declare const vaultChangePassword: (old: string, next: string) => Promise<void>;
-export declare const vaultList: () => Promise<VaultMeta[]>;
-/** Add or update a login; its id. */
-export declare const vaultSave: (entry: VaultEntryIn) => Promise<string>;
-export declare const vaultDelete: (id: string) => Promise<void>;
-/** One login's password, to show or copy. */
-export declare const vaultSecret: (id: string) => Promise<string>;
-/** One login's 2FA code now, and the seconds it has left. */
-export declare const vaultTotp: (id: string) => Promise<{
-    code: string;
-    remaining: number;
-}>;
-export declare const vaultGenerate: (length: number, symbols: boolean) => Promise<string>;
-/** The sites never offered saving for. */
-export declare const vaultNeverList: () => Promise<string[]>;
-export declare const vaultNeverRemove: (site: string) => Promise<void>;
-/** The logins saved for the page a pane shows. */
-export declare const vaultMatches: (pane: string) => Promise<VaultMeta[]>;
-/** Fill a login into the pane's page ("ok", or "user" when the page asks for the username first). */
-export declare const vaultFill: (pane: string, id: string) => Promise<string>;
-/** Fill a new generated password into a sign-up page's password fields. */
-export declare const vaultFillNew: (pane: string, length: number, symbols: boolean) => Promise<void>;
-export declare const vaultOfferAnswer: (pane: string, answer: "save" | "never" | "dismiss") => Promise<void>;
-/** Logins from a password export (Chrome, Edge, Brave, Firefox, Bitwarden). */
-export declare const vaultImport: (path: string) => Promise<{
-    added: number;
-    updated: number;
-    skipped: number;
-}>;
-/** Every login to a plain-text CSV file, after the master password again; how many. */
-export declare const vaultExport: (path: string, password: string) => Promise<number>;
-/** A page in the history: its title, how often and when it was last visited (ms). */
-export interface HistoryPage {
-    url: string;
-    title: string;
-    count: number;
-    last: number;
-}
-/** One visit to a page. */
-export interface HistoryVisit {
-    url: string;
-    title: string;
-    at: number;
-}
-/** A visit to a web page; `counted` false is only its title arriving. Whether anything changed. */
-export declare const browserHistoryVisit: (url: string, title: string, counted: boolean) => Promise<boolean>;
-export declare const browserHistoryRecent: (limit: number) => Promise<HistoryPage[]>;
-/** Visits newest first, before `before` (ms), whose page matches every word of `q`. */
-export declare const browserHistoryList: (q: string, before: number | null, limit: number) => Promise<HistoryVisit[]>;
-/** The pages the address bar offers for `q`, best first. */
-export declare const browserHistorySuggest: (q: string, limit: number) => Promise<HistoryPage[]>;
-/** How many pages the history holds. */
-export declare const browserHistoryCount: () => Promise<number>;
-export declare const browserHistoryForgetUrl: (url: string) => Promise<void>;
-/** Forget the visits from `from` to `to` (ms); all of them when neither is given. */
-export declare const browserHistoryForgetRange: (from?: number, to?: number) => Promise<void>;
-/** An installed extension. `id` is WebView2's, which chrome-extension:// addresses use. */
-export interface BrowserExtension {
-    id: string;
-    name: string;
-    version: string;
-    enabled: boolean;
-    storeId?: string;
-    popup?: string;
-    options?: string;
-    icon?: string;
-    path: string;
-    inPlace: boolean;
-}
-export declare const extensionsList: () => Promise<BrowserExtension[]>;
-/** Install from the Chrome Web Store, by its link or the extension's id; its name. */
-export declare const extensionInstallStore: (link: string) => Promise<string>;
-/** Install an unpacked extension from a folder: copied in, or loaded where it is (`inPlace`, developer mode); its name. */
-export declare const extensionInstallFolder: (path: string, inPlace?: boolean) => Promise<string>;
-/** Load an extension again from its files (an unpacked one's edits); its name. */
-export declare const extensionReload: (id: string) => Promise<string>;
-export declare const extensionSetEnabled: (id: string, enabled: boolean) => Promise<void>;
-export declare const extensionRemove: (id: string) => Promise<void>;
-/** Show an extension's popup page for `pane`, its right edge at `right` and top at `top` (physical pixels). */
-export declare const extensionPopup: (pane: string, id: string, page: string, right: number, top: number) => Promise<void>;
-export declare const extensionPopupClose: (pane: string) => Promise<void>;
-/** The sites agents may use in the browser without asking. */
-export declare const browserAgentConfig: (sites: string[], any?: boolean) => Promise<void>;
-/** The user's answer to an agent's question about a site. */
-export declare const browserAgentAnswer: (id: number, site: string, allow: boolean, forGood: boolean) => Promise<void>;
-/** A DevTools protocol call on a browser pane's page, and its answer. */
-export declare const browserCdp: (pane: string, method: string, params?: unknown) => Promise<unknown>;
-/** Open a browser pane's developer tools. */
-export declare const browserDevtools: (pane: string) => Promise<void>;
-/** What the site in a browser pane keeps and has been allowed: its cookie count and permissions. */
-export declare const browserSite: (pane: string) => Promise<{
-    origin: string;
-    cookies: number;
-    permissions: {
-        origin: string;
-        kind: number;
-        state: number;
-    }[];
-}>;
-/** Delete the site's cookies, storage and cache. */
-export declare const browserSiteClear: (pane: string) => Promise<void>;
-/** Every site given or refused a permission. */
-export declare const browserPermissions: () => Promise<{
-    origin: string;
-    kind: number;
-    state: number;
-}[]>;
-/** Set a site's permission: 0 ask again, 1 allow, 2 block. */
-export declare const browserPermissionSet: (origin: string, kind: number, state: number) => Promise<void>;
-/** Mute or unmute a browser pane's page. */
-export declare const browserMute: (pane: string, muted: boolean) => Promise<void>;
-/** Set a browser pane's page zoom (1 = 100%). */
-export declare const browserZoom: (pane: string, factor: number) => Promise<void>;
-/** Pause, resume or cancel one of the browser's downloads. */
-export declare const browserDownload: (id: number, action: "pause" | "resume" | "cancel") => Promise<void>;
-/** Find in the pane's page: start a search, step through its matches, or stop (clearing them). */
-export declare const browserFind: (pane: string, action: "start" | "next" | "prev" | "stop", term?: string, matchCase?: boolean) => Promise<void>;
-export declare const browserCapture: (pane: string) => Promise<ArrayBuffer>;
-/** Cut these boxes, each [x, y, w, h, corner radius] in physical px from the page's corner, out of a pane's page window, `w`×`h` its size; none gives it back whole. */
-export declare const browserCut: (pane: string, w: number, h: number, cuts: number[][]) => Promise<void>;
-export interface AppProc {
-    name: string;
-    title: string;
-    path: string;
-}
-/** A config's JSON text, "" when it does not exist yet. The name is its path in Deck's config folder
- *  without `.json`, folders and all: `settings/settings`, `state/term-procs`. A plugin names its
- *  own configs plainly (`boards`), and they are kept in `data/<plugin id>/`; one of Deck's own it
- *  names in full. `config-changed` names configs the same way, a plugin's own as it names them. */
-export declare const configRead: (name: string) => Promise<string>;
-/** Raw bytes rather than a JSON argument: a 13.8MB pinboard parsed as JSON on Deck's UI thread
- *  held every other command up for 200ms per save (see config_write in config.rs). */
-/** The name is percent-encoded: it travels in a header, which is ASCII, and a name can be any text
- *  (a note's title). */
-export declare const configWrite: (name: string, json: string) => Promise<void>;
-/** Remove a config or plain file, in order with the writes before it. */
-export declare const configDelete: (name: string) => Promise<void>;
-/** A plugin's own folder in Deck's config folder, `<config dir>\data\<id>`, for listing or
- *  renaming the files it keeps there with the fs* calls. A plugin calls it with no argument: its
- *  shim knows which plugin it is. */
-export declare const dataDir: (plugin?: string) => Promise<string>;
-/** The optional readouts in the footer status strip. */
-/**
- * A footer readout's id.
- *
- * `string` rather than a closed union because plugins contribute readouts too, and their ids are
- * not known until a folder is read. The built-in ones are still listed in FOOTER_ITEMS below; a
- * plugin's are merged in at run time by `footerItems()`.
- */
-export type FooterItem = string;
-export declare const FOOTER_ITEMS: {
-    id: FooterItem;
-    label: string;
-    desc: string;
-}[];
-/**
- * Stored order, with any item the stored list predates appended in its declared position.
- *
- * `known` is passed in rather than read from FOOTER_ITEMS so the caller can include the loaded
- * plugins' readouts; without that a plugin's item would be filtered out as unrecognised.
- */
-export declare function footerOrder(stored: FooterItem[] | undefined, known?: string[]): FooterItem[];
-export interface Settings {
-    warningMode: "toast" | "window" | "none";
-    warnLeadMin: number;
-    autostart: boolean;
-    closeToTray: boolean;
-    startMinimized: boolean;
-    reduceMotion: boolean;
-    /** The Servers list (hosts from ~/.ssh/config) under the workspace list. */
-    serversList: boolean;
-    /** The mouse wheel over a tab bar switches tabs rather than scrolling the bar. */
-    tabWheelSwitch: boolean;
-    /** When the tabs do not fit, every one but the open tab shrinks to its icon. */
-    tabSqueeze?: boolean;
-    /** A title-bar tab's full width in px (120 to 320, 160 when unset): its width, or with tabSqueeze the most it narrows from. */
-    tabWidth?: number;
-    /**
-     * Where things that arrive from outside open (Settings → Where things open). A floating window
-     * leaves the main window's tab as it was; a tab takes its place, as before floating windows.
-     * - openLinksIn: a link another program opens with Deck as the default browser ("float" unset).
-     * - openAgentPagesIn: a page an agent opens ("float-background" unset).
-     * - openFilesIn: a file opened with Deck from Explorer that opens in a plugin or the browser
-     *   ("float" unset); one for the Editor goes to the Editor either way.
-     */
-    openLinksIn?: "float" | "float-background" | "tab";
-    openAgentPagesIn?: "float-background" | "tab";
-    openFilesIn?: "float" | "tab";
-    /**
-     * A file for the Editor opened with Deck from Explorer ("tab" unset: the project's Editor, in the
-     * main window brought forward). "float": an Editor of its own in a floating window, as a file
-     * Ctrl+clicked in a terminal can open.
-     */
-    openCodeFilesIn?: "tab" | "float";
-    /**
-     * More of the same, for what you open yourself but only look at (Settings → Where things open):
-     * - openTerminalLinksIn: an address Ctrl+clicked in a terminal, with browserTerminalLinks "deck"
-     *   ("float" unset: the "links" window).
-     * - openDocsIn: a Docs page opened from Settings ("float" unset; Settings stays open).
-     * - openCommitsIn: a commit opened from the Editor's blame ("float" unset).
-     * - agentTerminals: a terminal tab or project an agent makes ("background" unset: added without
-     *   switching to it, its shell started anyway so the agent can use it; "switch" goes to it).
-     */
-    openTerminalLinksIn?: "float" | "tab";
-    /**
-     * A file path Ctrl+clicked in a terminal ("tab" unset: the Editor's tab, or the tab its type
-     * opens in). "float": an Editor of its own in a floating window, the project's left where it is;
-     * a type that opens elsewhere (a .pdf) in the "links" window.
-     */
-    openTerminalFilesIn?: "tab" | "float";
-    /** The same, per extension (".md"), over `openTerminalFilesIn`. */
-    openTerminalFilesByExt?: Record<string, "tab" | "float">;
-    openDocsIn?: "float" | "tab";
-    openCommitsIn?: "float" | "tab";
-    agentTerminals?: "background" | "switch";
-    /** Each project's own colour on the sidebar's collapsed rail. Off, they are all one grey. */
-    projectColours?: boolean;
-    /** Agents listed under their workspace in the sidebar: under every one (default), only the open one, or none. */
-    sidebarAgents?: "all" | "open" | "off";
-    /**
-     * Closing a tab, a group's tabs or a terminal pane (or restarting or replacing one) asks first:
-     * only when something is running in it besides the shell ("running", unset), every time, or
-     * never ("Don't ask again" in the question sets this).
-     */
-    askBeforeClose?: "running" | "always" | "never";
-    /** The workspace sidebar is a button in the title bar that opens it over the panes, rather than a column. */
-    sidebarMenu?: boolean;
-    /** Pane controls float over the pane's top-right corner on hover, instead of a header row. */
-    floatingPaneControls: boolean;
-    /** Per notification kind, whether it shows as a card, in the bell, with a sound, and as a Windows
-     *  notification while Deck is not focused. A missing entry takes the default (notifications.ts). */
-    notifPrefs?: Partial<Record<"input" | "done" | "attention" | "activity" | "update" | "error" | "plugin", Partial<Record<"card" | "bell" | "sound" | "os", boolean>>>>;
-    /** No cards and no sound; everything still lands in the bell. */
-    doNotDisturb?: boolean;
-    /** Which corner on the right the notification cards stack in. */
-    notifPosition?: "bottom" | "top";
-    /** Install plugin and language updates at startup instead of only announcing them. */
-    pluginAutoUpdate: boolean;
-    soundOnFire: boolean;
-    playerPlacement: "fixed" | "floating";
-    accent: Accent;
-    bgPreset: Background;
-    /** The colours of the "custom" background, each "#rrggbb". Kept when a preset is picked, so
-     *  going back to Custom finds them again. */
-    customTheme?: Partial<Palette>;
-    /** Custom palettes the user saved by name, shown as cards beside the presets. */
-    savedThemes?: {
-        id: string;
-        name: string;
-        palette: Partial<Palette>;
-    }[];
-    /** The saved theme the custom colours came from, which edits are written back to. */
-    savedThemeId?: string;
-    density: Density;
-    uiZoom: number;
-    termTheme: TermTheme;
-    /** The "custom" terminal theme's colours. Kept when another theme is picked. */
-    termCustom?: Partial<TermCustom>;
-    termFont: string;
-    termFontSize: number;
-    termScrollback: number;
-    wsSidebar: boolean;
-    termGpuRender: boolean;
-    wallpaper: string;
-    wallpaperDim: number;
-    wallpaperBlur: number;
-    wallpaperPanel: number;
-    footerItems: Record<FooterItem, boolean>;
-    footerOrder: FooterItem[];
-    footerVisible: boolean;
-    /**
-     * Drawer tabs the user has switched off, by id ("console", "plugin:flutter", a pinned pane's
-     * uuid). A DENY list, not an allow list: the tabs are discovered at run time — a plugin panel
-     * appears when its plugin loads, a pinned pane when you pin it — so anything unlisted is on,
-     * and a newly added tab shows up rather than being invisible until someone enables it.
-     *
-     * A plugin's own `panelWhen` still applies on top of this: switching a tab on returns it to the
-     * plugin's rule rather than overriding it, so enabling Flutter does not put an empty tab in
-     * every non-Flutter project.
-     */
-    drawerHidden: string[];
-    /** Drawer tabs left-to-right. Ids missing from it keep their discovery order, after the rest. */
-    drawerOrder: string[];
-    /** Which side of the footer each drawer tab and readout sits on, in order (core/footerlayout.ts).
-     *  Absent until something is moved: drawer tabs left, readouts right, in the orders above. */
-    footerLayout?: {
-        left: string[];
-        right: string[];
-    };
-    httpMcpRevealSecrets: boolean;
-    /**
-     * What to call the user: shown to the others when sharing (a Canvas board's cursor and the
-     * host's "wants to join"). "" means work it out: the Google account's name when signed in,
-     * else the Windows account's (see `userName` in settingsstore.ts).
-     */
-    userName: string;
-    /** What a new browser pane opens: Deck's start page, the search engine's own page, or a URL
-     *  (a site, or a local .html file the user wrote). */
-    browserHome: "deck" | "search" | "url";
-    browserHomeUrl: string;
-    /** Where a search typed into the address bar or the start page goes. */
-    browserSearch: SearchEngine;
-    /** Which parts of Deck's start page show. */
-    browserHomeSections: {
-        clock: boolean;
-        search: boolean;
-        servers: boolean;
-        pins: boolean;
-        recent: boolean;
-    };
-    /** Behind the start page: a photo that changes each time it opens, one from a folder of the
-     *  user's own, or none (Deck's background). */
-    browserBackground: "photos" | "folder" | "none";
-    browserBackgroundFolder: string;
-    /** Where the bookmarks bar shows under a browser's toolbar: on every page, on the start page
-     *  only, or not at all (and only once something is on it). true and false are what it was saved
-     *  as before it had three; read it through bookmarksBarMode. */
-    browserBookmarksBar: "always" | "home" | "never" | boolean;
-    /** WebView2's tracking prevention for the browser: how many trackers it blocks. */
-    browserTracking: "none" | "basic" | "balanced" | "strict";
-    /** Whether the vault offers to save a sign-in, and the minutes it stays open unused. */
-    browserVaultOffer: boolean;
-    browserVaultLock: number;
-    /** Extensions pinned to the browser's toolbar, by WebView2's id, in order. */
-    browserPinnedExtensions: string[];
-    /** The Extensions page's developer mode: load unpacked folders in place, reload them, ids and folders shown. */
-    browserExtensionsDev: boolean;
-    /** Whether the browser fills in forms (addresses, names). */
-    browserAutofill: boolean;
-    /** The ad blocker (EasyList and EasyPrivacy), and the sites it is switched off for, by host. */
-    browserAdblock: boolean;
-    browserAdblockOff: string[];
-    /** Skip YouTube's video ads: click Skip when it shows, run an unskippable one to its end. */
-    browserYoutubeSkip: boolean;
-    /** Where Ctrl+click on a web address in a terminal opens it: a browser tab of Deck's, or the system's. */
-    browserTerminalLinks: "deck" | "system";
-    /** Sleeping tabs: a browser tab out of sight this many minutes stops running until it is shown. */
-    browserSleep: boolean;
-    browserSleepAfter: number;
-    /**
-     * A page stays live under Deck's menus and cards, which are cut out of its window (unset: on).
-     * Off, a covered page is a blurred picture of itself, for a machine where the cut does not show.
-     */
-    browserLiveCovers?: boolean;
-    /** Whether pages are asked for light or dark to match Deck's theme ("deck") or Windows'. */
-    browserPageTheme?: "deck" | "windows";
-    /** App links opened without asking, as "<site origin> <scheme>" ("https://zoom.us zoommtg"). */
-    browserAppLinks: string[];
-    /** The start page offers to make Deck the default browser while it is not. Off: "Don't ask again". */
-    browserDefaultAsk?: boolean;
-    /** Sites (by host) an agent may use in the browser without asking; localhost and files always. */
-    browserAgentSites: string[];
-    /** Agents may use any site without being asked (signing in still asks). Off by default. */
-    browserAgentAnySite: boolean;
-    /**
-     * Where a file type opens, by extension (".pdf"): "editor", "browser" or "plugin:<id>". A type
-     * not listed is Automatic (see `openerFor` in fileview.ts).
-     */
-    openWith?: Record<string, string>;
-}
-/** The bookmarks bar setting, older true/false values included. */
-export declare const bookmarksBarMode: (s: Settings) => "always" | "home" | "never";
-export declare const DEFAULT_SETTINGS: Settings;
-export declare const setAutostart: (on: boolean) => Promise<void>;
-export declare const getAutostart: () => Promise<boolean>;
-export declare const toggleFullscreen: () => Promise<boolean>;
-export declare const isFullscreen: () => Promise<boolean>;
-/** Check a sudo password on the server and hold it until Deck exits (never written anywhere). */
-export declare const remoteSudoPassword: (host: string, password: string) => Promise<void>;
-/** Ask for the sudo password of `host` (SudoPasswordPrompt, mounted in App). True once it has
- *  been accepted, false if the prompt was cancelled. */
-export declare function askSudoPassword(host: string): Promise<boolean>;
-/**
- * Watch `paths` for changes made outside Deck (`fs-changed` events, a path each). `owner` names
- * the caller: each owner sets only its own list and the watcher follows every owner's together, so
- * one caller cannot replace or end another's watch. An empty list takes the owner out.
- */
-export declare const watchFiles: (paths: string[], owner?: string) => Promise<void>;
-/** RAM in bytes: Deck and its WebView2 children, plus every claude.exe. */
-export interface MemServer {
-    id: string;
-    label: string;
-    mem: number;
-    pid: number;
-}
-/** One process behind the figures, largest first. Only filled when memUsage(true) asks. */
-export interface MemProc {
-    pid: number;
-    name: string;
-    cmd: string;
-    mem: number;
-    group: "deck" | "server" | "browser" | "agent" | "pane-agent" | "pane";
-    /** The language server's session id, or the terminal pane's id. */
-    owner: string;
-    /** An agent, or a process in a terminal pane that is not its shell: memKill may stop it. */
-    killable: boolean;
-}
-export interface MemUsage {
-    deck: number;
-    agents: number;
-    agent_count: number;
-    /** Percent of all cores. -1 on the first reading, before there is anything to difference. */
-    cpu: number;
-    cpu_agents: number;
-    /** Deck minus its language servers and the browser. Part of `deck`. */
-    core: number;
-    /** The browser's pages (its own WebView2 profile). Also part of `deck`. */
-    browser: number;
-    /** Browser panes with a live webview, each with its renderers' memory, largest first. */
-    browser_tabs: {
-        pane: string;
-        mem: number;
-    }[];
-    /** Running language servers, largest first. Also part of `deck`. */
-    servers: MemServer[];
-    /** Terminal panes. NOT part of `deck` — informational only. */
-    panes: number;
-    pane_count: number;
-    /** claude running inside a pane. Also not part of `deck`. */
-    pane_agents: number;
-    pane_agent_count: number;
-    procs: MemProc[];
-}
-/** `detail` also lists every process with its command line: for the open popover, not the poll. */
-export declare const memUsage: (detail?: boolean) => Promise<MemUsage>;
-/** Stop a process the memory popover lists, and what it started. Refused unless `killable`. An agent in a pane is asked to quit first: true when it did, false when it was killed. */
-export declare const memKill: (pid: number) => Promise<boolean>;
-/** Stop the claude or codex running in a terminal pane, as memKill does. */
-export declare const agentStop: (pane: string) => Promise<boolean>;
-export declare const listApps: () => Promise<AppProc[]>;
-export declare const listInstalled: () => Promise<AppProc[]>;
-export declare const runScriptNow: (command: string, args: string[], id?: string, name?: string) => Promise<void>;
-export declare const pickScript: () => Promise<string>;
-export interface ExecOut {
-    stdout: string;
-    stderr: string;
-    code: number;
-}
-/**
- * Run a command to completion and read its output. `runScriptNow` is fire-and-forget; this is
- * for when the output IS the point — asking a tool what it knows rather than telling it to do
- * something. A bare name goes through cmd.exe, so PATH and .bat shims (`flutter`, `npm`) work.
- */
-export declare const exec: (command: string, args?: string[], cwd?: string) => Promise<ExecOut>;
-/** One header, one value. A list rather than a map: order matters, and repeats are legal. */
-export type HttpHeader = [string, string];
-export interface HttpSendRequest {
-    method: string;
-    url: string;
-    headers?: HttpHeader[];
-    body?: string;
-}
-export interface HttpSendResult {
-    status: number;
-    status_text: string;
-    headers: HttpHeader[];
-    body: string;
-    /** Present only when the body is not valid UTF-8 — an image, a zip. `body` is lossy then. */
-    body_b64?: string;
-    size: number;
-    truncated: boolean;
-    elapsed_ms: number;
-}
-/**
- * Send one HTTP request and read the whole response.
- *
- * The `id` http.rs wants for cancellation is generated here: it exists so the HTTP module can
- * abort a send in flight, and a caller doing one GET should not have to invent one. A caller
- * that does need to cancel should use core/httpclient.ts, which owns that id.
- */
-export declare const httpSend: (req: HttpSendRequest) => Promise<HttpSendResult>;
-/**
- * The same send under an id the caller chose, so it can be cancelled with `httpCancel` while in
- * flight. `req` is the full shape http.rs takes; the Requests plugin builds it.
- */
-export declare const httpSendAs: <T = HttpSendResult>(id: string, req: object) => Promise<T>;
-/** Abort the send started under `id`. A no-op when it has already finished. */
-export declare const httpCancel: (id: string) => Promise<void>;
-/**
- * Answer an `http-send` event: a send the MCP asked for through sessions.rs, which waits on this
- * reply under `job`. The Requests plugin listens for the event and does the send.
- */
-export declare const httpSendReply: (job: string, body: string) => Promise<void>;
-export declare const pickFolder: () => Promise<string>;
-/** Native "save as" dialog. Returns "" when cancelled. */
-export declare const pickSavePath: (defaultName: string, ext: string) => Promise<string>;
-/** Native "open file" dialog. Returns "" when cancelled. */
-export declare const pickFile: (ext: string) => Promise<string>;
-/** Native "open file" dialog with no type filter, for choosing a file to upload: an endpoint may
- *  accept any extension, so a filter would only hide valid choices. "" when cancelled. */
-export declare const pickAnyFile: () => Promise<string>;
-/** Open dialog filtered to the image types a webview can display. */
-export declare const pickImage: () => Promise<string>;
-/** Copy a chosen image into the config dir; returns the path Deck will read it from. */
-export declare const setWallpaper: (src: string) => Promise<string>;
-export declare const clearWallpaper: () => Promise<void>;
-export declare const revealInFolder: (path: string) => Promise<void>;
-/** Deck's newest log file (`<config dir>\logs\deck-YYYY-MM-DD.log`), or the folder when empty. */
-export declare const logLatest: () => Promise<string>;
-export declare const openFile: (path: string) => Promise<void>;
-/** Files Deck was launched with — a double-click through Explorer's "Open with". */
-export declare const launchFiles: () => Promise<string[]>;
-/** Web addresses Deck was launched with: a link opened in another app, Deck being the default browser. */
-export declare const launchUrls: () => Promise<string[]>;
-export interface DefaultBrowserStatus {
-    registered: boolean;
-    isDefault: boolean;
-    name: string;
-}
-/** Whether Deck is offered as a browser in Windows, and whether links open with it. */
-export declare const browserDefaultStatus: () => Promise<DefaultBrowserStatus>;
-/** Register Deck as a browser for this user and open Windows' Default apps page at it: Windows
- *  keeps the choice itself to the user. */
-export declare const browserDefaultRegister: () => Promise<DefaultBrowserStatus>;
-export declare const mediaSetNowPlaying: (title: string, artist: string, artPath: string) => Promise<void>;
-export declare const mediaSetPlayback: (playing: boolean) => Promise<void>;
-export interface TrackMeta {
-    path: string;
-    title: string;
-    artist: string;
-    album: string;
-    duration: number;
-    art_path: string;
-}
-export declare const readTrackMeta: (paths: string[]) => Promise<TrackMeta[]>;
-export { convertFileSrc } from "@tauri-apps/api/core";
-/** Start a sign-in. Returns the consent URL to open in the browser. */
-export declare const googleSignIn: () => Promise<string>;
-/** A valid access token, refreshed if needed. Rejects when not connected. */
-export declare const googleToken: () => Promise<string>;
-/** The connected account, or null when not connected. */
-export interface GoogleAccount {
-    email: string;
-    name: string;
-    picture: string;
-}
-export declare const googleAccount: () => Promise<GoogleAccount | null>;
-export declare const googleSignOut: () => Promise<void>;
-export interface UsageBucket {
-    tokens: number;
-    cost: number;
-}
-export interface UsageSession extends UsageBucket {
-    remainingMinutes?: number | null;
-}
-export interface ClaudeUsage {
-    today?: UsageBucket;
-    week?: UsageBucket;
-    month?: UsageBucket;
-    session?: UsageSession | null;
-    error?: string;
-}
-export declare const claudeUsage: () => Promise<ClaudeUsage>;
-export interface PlanLimit {
-    kind: string;
-    group: string;
-    percent: number;
-    severity: string;
-    resets_at: string | null;
-    is_active: boolean;
-    scope?: {
-        model?: {
-            display_name?: string;
-        };
-    } | null;
-}
-export interface PlanLimits {
-    limits?: PlanLimit[];
-    error?: string;
-}
-export declare const claudePlanLimits: () => Promise<PlanLimits>;
-/** An agent pane as the session surface sees it. Status: working | idle | blocked. */
-export interface AgentSession {
-    pane_id: string;
-    agent: string;
-    status: string;
-    cwd: string;
-    title: string;
-}
-export declare const sessionList: () => Promise<AgentSession[]>;
-export interface ScriptJob {
-    id: string;
-    name: string;
-    command: string;
-    args: string[];
-    mode: "interval" | "atTime";
-    intervalMin: number;
-    days: string[];
-    timeOfDay: string;
-    everyWeeks: number;
-    startDate: string;
-    enabled: boolean;
-    lastRun: number;
-    target?: "local" | "vps";
-}
-export interface HistoryEntry {
-    module: string;
-    label: string;
-    payload: any;
-    firedAt: number;
-    mode?: "delay" | "atTime";
-    recurring?: boolean;
-    days?: string[];
-    timeOfDay?: string;
-    delayMin?: number;
-}
-export interface StartupProgram {
-    Name: string;
-    Path: string;
-    Args: string[];
-    Days: string[];
-    Start: string;
-    End: string;
-    Enabled: boolean;
-}
-export declare const pickExe: () => Promise<string>;
-export declare const readTermLayout: <T>() => Promise<T | null>;
-/** `mtimeMs` is epoch ms, 0 if unreadable — lets a caller tell a settled file from one still being written. */
-/** One entry of a folder. `size` is bytes (0 for a folder); `hidden` is Windows' hidden attribute,
- *  or a dot name on a server. */
-export interface FsEntry {
-    name: string;
-    path: string;
-    dir: boolean;
-    mtimeMs: number;
-    size: number;
-    hidden: boolean;
-}
-export interface GitStatusRow {
-    path: string;
-    rel: string;
-    letter: string;
-    staged: boolean;
-}
-/** One folder level, folders first. `all` includes the build folders (node_modules, target, .git…)
- *  that a code folder's tree leaves out. */
-export declare const fsList: (dir: string, all?: boolean) => Promise<FsEntry[]>;
-/** A drive of this PC (`C:\`): its label, kind, and size and free space in bytes (0 for a network drive or a disc). */
-export interface Drive {
-    path: string;
-    label: string;
-    kind: "fixed" | "removable" | "network" | "cd";
-    total: number;
-    free: number;
-}
-/** The drives Windows has. A one-off read, never for a poll. */
-export declare const fsDrives: () => Promise<Drive[]>;
-/** `%APPDATA%\Deck\plugins` (Deck-Dev in a debug build), created on first call. */
-export declare const pluginsDir: () => Promise<string>;
-/** `%APPDATA%\Deck\languages` (Deck-Dev in a debug build), created on first call. */
-export declare const languagesDir: () => Promise<string>;
-/** Delete a language definition's folder (by its folder name). The server and debugger it names stay installed. */
-export declare const removeLanguage: (folder: string) => Promise<void>;
-export declare const fsRead: (path: string) => Promise<string>;
-/** Raw bytes, for a file that is not text — fsRead decodes as UTF-8 and would corrupt it. */
-export declare const fsReadBytes: (path: string) => Promise<Uint8Array<ArrayBuffer>>;
-export declare const fsSize: (path: string) => Promise<number>;
-/** What is at a remote path. A missing one is `exists: false`, not an error. */
-export interface RemoteStat {
-    exists: boolean;
-    dir: boolean;
-    size: number;
-    mtimeMs: number;
-}
-export declare const remoteStat: (path: string) => Promise<RemoteStat>;
-/** The server's home folder as host:/home/user (host+sudo: when it runs as root). */
-export declare const remoteHome: (host: string, sudo: boolean) => Promise<string>;
-/** Host names from ~/.ssh/config, without patterns. */
-export declare const sshHosts: () => Promise<string[]>;
-export declare const fsWrite: (path: string, content: string) => Promise<void>;
-/** Raw bytes — a PDF, an image, a response — which a string would corrupt. Sent as the raw body,
- *  the path percent-encoded in a header; a remote path writes over SSH. */
-export declare const fsWriteBytes: (path: string, bytes: Uint8Array) => Promise<void>;
-/** Write bytes without ever clobbering: dedupes the name on collision, returns the path used. */
-export declare const fsSaveUnique: (saveTo: string, defaultName: string, bytes: Uint8Array) => Promise<string>;
-export declare const fsHomeDir: () => Promise<string>;
-/**
- * Move into a directory, creating it if missing. Returns the new full path.
- *
- * `onConflict` "rename" deduplicates to "name (1).ext" instead of failing — for an unattended
- * caller with nobody to answer an overwrite prompt. Omit it for the interactive case.
- */
-export declare const fsMove: (src: string, dstDir: string, onConflict?: "fail" | "rename") => Promise<string>;
-export declare const fsCreateFile: (dir: string, name: string) => Promise<string>;
-/** Open a path with its default application. */
-export declare const fsOpen: (path: string) => Promise<void>;
-/** The user's Downloads folder (home if there isn't one). */
-export declare const dirsDownload: () => Promise<string>;
-/** Relaunch Deck — the same binary, so a dev instance stays dev. Used by the plugin toggle. */
-export declare const restartApp: () => Promise<void>;
-/** Start a test Deck (`deck.exe --test`) beside this one, or bring the running one forward. */
-export declare const openTestDeck: () => Promise<void>;
-/** Fetch the VPS's Script Runner run log over SSH into the local run-log-vps config (vpsjobs.rs). */
-export declare const vpsRunsPull: () => Promise<void>;
-/** What Rust saw of this launch, as Unix ms: process creation and the setup() span. Null until
- *  setup() has finished, which is before any page script runs. */
-export interface StartupMarks {
-    process: number;
-    setupStart: number;
-    setupEnd: number;
-}
-export declare const startupMarks: () => Promise<StartupMarks | null>;
-/** The page has drawn: Rust shows the window, hidden until then so it never shows see-through. */
-export declare const deckReady: () => Promise<void>;
-/** What a backup file holds: the Deck that wrote it, when, and how many of each thing. */
-export interface BackupSummary {
-    deck: string;
-    created: string;
-    configs: number;
-    plugins: number;
-    languages: number;
-    notes: number;
-}
-/** Every config, plugin and language to one file, credentials left out (backup.rs). */
-export declare const backupExport: (path: string) => Promise<BackupSummary>;
-export declare const backupInspect: (path: string) => Promise<BackupSummary>;
-/** Writes the backup over this machine's copies. Deck should restart afterwards. */
-export declare const backupRestore: (path: string) => Promise<BackupSummary>;
-/** One file of a plugin, as the registry describes it. */
-export interface RemoteFile {
-    url: string;
-    sha256: string;
-    bytes?: number;
-}
-/**
- * Install a plugin or a language definition from the registry.
- *
- * `kind` decides where it lands and what it is allowed to contain: a plugin's three files in
- * `plugins/`, or a language.json and its snippets in `languages/`. Rust refuses anything else,
- * because the file names become paths.
- *
- * Every file's SHA-256 is checked before anything is written. It matters most for a plugin —
- * `plugin.js` runs with this bridge, so unverified bytes would be someone else's code running
- * here — but a corrupted language definition is worth refusing too. Nothing is written unless
- * every file checks out.
- *
- * Resolves to the installed id; both kinds load without a restart.
- */
-export declare const installFromRegistry: (kind: string, id: string, files: Record<string, RemoteFile>) => Promise<string>;
-/** One line of output from a `procStream` run. `stream` is "stdout" or "stderr". */
-export interface ProcLine {
-    id: string;
-    stream: string;
-    line: string;
-}
-/** How a `procStream` run ended. `cancelled` separates a `procKill` from a real failure. */
-export interface ProcResult {
-    id: string;
-    code: number;
-    cancelled: boolean;
-}
-/**
- * Run a program, emitting a `proc-line` event per output line, and resolve when it exits.
- *
- * `id` is the caller's handle — it tags every event and is what `procKill` takes, so concurrent
- * runs can be told apart. Listen with `listen<ProcLine>("proc-line", …)` and filter on it.
- *
- * `stdin: true` opens the child's input for `procWrite`, which is what turns this from "run a
- * command and read the output" into driving a long-lived tool that takes commands — a daemon
- * speaking one JSON object per line, or a program reading single keypresses.
- */
-export declare const procStream: (id: string, program: string, args: string[], cwd?: string, stdin?: boolean) => Promise<ProcResult>;
-/**
- * Write to a running `procStream`'s stdin. Only works when it was started with `stdin: true`.
- *
- * Raw — no newline is appended, since whether one terminates a message belongs to the protocol.
- */
-export declare const procWrite: (id: string, data: string) => Promise<void>;
-export declare const procKill: (id: string) => Promise<void>;
-export declare const fsCreateDir: (dir: string, name: string) => Promise<string>;
-export declare const fsRename: (path: string, newName: string) => Promise<string>;
-export declare const fsDelete: (path: string) => Promise<void>;
-/** Move to the Recycle Bin, so it can be restored (fsDelete removes for good). */
-export declare const fsTrash: (path: string) => Promise<void>;
-export declare const fsCopy: (src: string, dstDir: string) => Promise<string>;
-export declare const fsReveal: (path: string) => Promise<void>;
-/**
- * Deck's MCP server, which lets an agent drive Deck's terminals and HTTP client, registered with
- * an AI coding agent: "claude", "codex", "gemini" or "cursor". The server ships with Deck as a
- * single bundled file. Each agent keeps its MCP servers somewhere else (see agentmcp.rs), a file
- * that belongs to that agent, so Deck backs it up first, merges rather than replaces, and refuses
- * outright if it cannot parse it. The status is "missing", "current", "stale" (an entry pointing
- * somewhere else, as a reinstall to another folder leaves) or "no-node" (nothing could run it).
- */
-export declare const agentMcpStatus: (agent: string) => Promise<string>;
-export declare const installAgentMcp: (agent: string) => Promise<string>;
-/** Deck's hooks for an agent that has them ("claude", "codex"): what the Agents panel and the
- *  agent notifications hear from. Merged into the agent's own settings, backed up first. */
-export declare const installAgentHooks: (agent: string) => Promise<void>;
-/**
- * Deck's skills (how to use its MCP tools) for an agent that reads skills: "claude" or "codex".
- * Each comes back with what happened to it: "installed", "updated", "current", "kept-yours" (a
- * skill of that name that is not Deck's) or "kept-edited" (Deck's, changed since). Deck only
- * replaces a skill folder it wrote and nobody has edited.
- */
-export declare const installAgentSkills: (agent: string) => Promise<{
-    skill: string;
-    outcome: string;
-}[]>;
-/** Which agent command-line tools are on PATH: any of claude, codex, gemini, cursor-agent, cursor. */
-export declare const agentClis: () => Promise<string[]>;
-export declare const notifyOs: (title: string, body: string) => Promise<void>;
-/** Run `git -C <dir> <args>`: its stdout, or what git said as the error. Never prompts for
- *  credentials. What the Git plugin builds its operations on. */
-export declare const gitRun: (dir: string, args: string[]) => Promise<string>;
-export declare const gitStatus: (dir: string) => Promise<GitStatusRow[]>;
-/** The repos a folder holds: the one it is inside first, then any below it. Each a repo's top level. */
-export declare const gitRepos: (dir: string) => Promise<string[]>;
-export interface BlameLine {
-    hash: string;
-    author: string;
-    time: number;
-    summary: string;
-    uncommitted: boolean;
-}
-export declare const gitBlameLine: (dir: string, rel: string, line: number, contents: string) => Promise<BlameLine | null>;
-/** A blob's raw bytes. `rev` is "HEAD", or "" for the index. Empty = absent from that revision.
- *  For content the text commands would corrupt: an image, a font. */
-export declare const gitFileBytes: (dir: string, rev: string, rel: string) => Promise<Uint8Array<ArrayBuffer>>;
-export interface GitInfo {
-    branch: string;
-    has_remote: boolean;
-    ahead: number;
-    behind: number;
-}
-export declare const gitInfo: (dir: string) => Promise<GitInfo>;
-/** gitStatus and gitInfo in one `git status -b`: what the editor's poll asks for every 3s. */
-export declare const gitPoll: (dir: string) => Promise<{
-    rows: GitStatusRow[];
-    info: GitInfo;
-}>;
-export declare const gitFileDiff: (dir: string, rel: string) => Promise<string>;
-export interface ImportedPack {
-    id: string;
-    label: string;
-    theme_json: string;
-}
-export declare const importIconPack: (srcDir: string) => Promise<ImportedPack>;
-export declare const deleteIconPack: (id: string) => Promise<void>;
-export declare const readIconPackTheme: (path: string) => Promise<string>;
-export declare const gitDiscard: (dir: string, paths: string[]) => Promise<void>;
-export interface GraphCommit {
-    hash: string;
-    parents: string[];
-    author: string;
-    email: string;
-    date: string;
-    subject: string;
-    body: string;
-    refs: string[];
-}
-export declare const gitLogGraph: (dir: string, skip: number, rel?: string, refs?: string[]) => Promise<GraphCommit[]>;
-/** `old`: a rename's or copy's path before the commit, which its parent side is read from. */
-export interface CommitFile {
-    rel: string;
-    letter: string;
-    adds: number;
-    dels: number;
-    old?: string;
-}
-export declare const gitCommitFiles: (dir: string, hash: string) => Promise<CommitFile[]>;
-export interface GitRef {
-    kind: "local" | "remote" | "tag";
-    name: string;
-    current: boolean;
-    author: string;
-    hash: string;
-    summary: string;
-    time: number;
-}
-export declare const gitRefs: (dir: string) => Promise<GitRef[]>;
-export declare const gitCheckout: (dir: string, name: string) => Promise<string>;
-export declare const gitCheckoutNew: (dir: string, name: string) => Promise<string>;
-export declare const gitCheckoutTrack: (dir: string, remote: string) => Promise<string>;
-export declare const gitCheckoutDetach: (dir: string, rev: string) => Promise<string>;
-export declare const gitAiCommitMsg: (dir: string, command: string, args: string, model: string) => Promise<string>;
-/** The GitHub CLI, `gh pr …` or `gh repo view …` only. Rejects with "gh-missing" when gh is not installed. */
-export declare const ghRun: (dir: string, args: string[]) => Promise<string>;
-/** Pull request N's review threads, as GitHub's GraphQL JSON (parsed by prs.ts parseThreads). */
-export declare const ghPrThreads: (dir: string, number: number) => Promise<string>;
-/** Comment on one line of a PR's diff: side "RIGHT" is the new version, "LEFT" the old. */
-export declare const ghPrLineComment: (dir: string, number: number, commit: string, path: string, line: number, side: "LEFT" | "RIGHT", body: string) => Promise<string>;
-export declare const ghThreadReply: (dir: string, thread: string, body: string) => Promise<string>;
-export declare const ghThreadResolve: (dir: string, thread: string, resolve: boolean) => Promise<string>;
-/** The GitLab CLI, `glab mr …` only. Rejects with "glab-missing" when glab is not installed. */
-export declare const glabRun: (dir: string, args: string[]) => Promise<string>;
-/**
- * One GitLab REST request about this repo's merge requests (`projects/:id/merge_requests…` or
- * `user`). `fields` go as strings; `json` values must be objects or arrays.
- */
-export declare const glabApi: (dir: string, method: "GET" | "POST" | "PUT", path: string, fields?: [string, string][], json?: Record<string, object>) => Promise<string>;
-/** The files that differ between two revisions. */
-export declare const gitRangeFiles: (dir: string, from: string, to: string) => Promise<CommitFile[]>;
-export interface SearchHit {
-    path: string;
-    rel: string;
-    line: number;
-    text: string;
-}
-export interface SearchOpts {
-    caseSensitive: boolean;
-    isRegex: boolean;
-    wholeWord: boolean;
-    includes: string;
-    excludes: string;
-}
-/** Every file under `dir` (absolute paths), .gitignore respected — the editor's Ctrl+P. */
-export declare const fsFiles: (dir: string) => Promise<string[]>;
-/** One file `fsFind` found. `mtime` is milliseconds since the epoch. */
-export interface FoundFile {
-    path: string;
-    size: number;
-    mtime: number;
-}
-/**
- * Every file with one of `exts` (no dot) under `roots`, or under every fixed drive when roots is
- * null, skipping folders named in `excludeDirs` at any depth and files under `minSize` bytes.
- * A walk of whole drives takes on the order of a minute.
- */
-export declare const fsFind: (roots: string[] | null, exts: string[], excludeDirs: string[], minSize: number) => Promise<FoundFile[]>;
-/** Windows' own thumbnail of a file (what Explorer shows), as PNG bytes fitting `size` x `size`.
- *  Rejects when Windows has none for it. */
-/** What Windows knows about a photo or video (its Properties' Details tab). Absent fields are null. */
-export interface MediaMeta {
-    /** Date taken or recorded, ms since the epoch. */
-    taken: number | null;
-    width: number | null;
-    height: number | null;
-    camera: string | null;
-    lat: number | null;
-    lon: number | null;
-    duration_ms: number | null;
-}
-/** The properties of each path, in order; one that cannot be read comes back all null. */
-export declare const mediaMeta: (paths: string[]) => Promise<MediaMeta[]>;
-/** SHA-256 of each file's contents, in order; null for one that cannot be read. */
-export declare const fsHash: (paths: string[]) => Promise<(string | null)[]>;
-export declare const fsThumbnail: (path: string, size: number) => Promise<Uint8Array<ArrayBuffer>>;
-export declare const fsSearch: (dir: string, query: string, o: SearchOpts) => Promise<SearchHit[]>;
-export declare const fsReplace: (dir: string, query: string, replacement: string, o: SearchOpts, files?: string[], line?: number) => Promise<number>;
-export interface DbQueryResult {
-    columns: string[];
-    /** Cell values, already JSON: null, boolean, number, or a string for everything else. */
-    rows: unknown[][];
-    total: number;
-    truncated: boolean;
-    affected: number;
-}
-export interface DbColumn {
-    name: string;
-    type: string;
-    notNull: boolean;
-    pk: boolean;
-}
-export interface DbTable {
-    name: string;
-    kind: "table" | "view";
-    columns: DbColumn[];
-    /** The statement that created it, where the engine keeps one (SQLite). */
-    sql?: string;
-}
-export interface DbForeignKey {
-    table: string;
-    column: string;
-    refTable: string;
-    refColumn: string;
-}
-export interface DbSchema {
-    tables: DbTable[];
-    foreignKeys: DbForeignKey[];
-}
-/** Open a connection; the url's scheme picks the engine. The handle outlives the calling component. */
-export declare const dbConnect: (url: string) => Promise<number>;
-export declare const dbDisconnect: (handle: number) => Promise<void>;
-/**
- * Run a statement and return up to 1000 rows, after skipping the first `skip` (how a grid pages).
- * `readOnly` refuses writes, by the database itself (a read-only session on Postgres and MySQL,
- * query_only on SQLite).
- */
-export declare const dbQuery: (handle: number, sql: string, readOnly: boolean, skip?: number) => Promise<DbQueryResult>;
-export declare const dbSchema: (handle: number) => Promise<DbSchema>;
-/** Open a tunnel. `remote` is host:port as seen FROM `host`. Returns [id, local port]. */
-export declare const sshTunnelOpen: (host: string, remote: string) => Promise<[number, number]>;
-export declare const sshTunnelClose: (id: number) => Promise<void>;
-/**
- * Offer programs to the editor's debugger: a plugin that runs something debuggable (the Flutter
- * plugin's runs) publishes them here, and the Run and Debug panel lists them to attach to. Pass
- * the plugin's whole current list each time, under its own `source`; an empty list removes it.
- * See core/debugtargets.ts.
- */
-export declare const setDebugTargets: (source: string, targets: DebugTarget[]) => void;
-export type { DebugTarget } from "./debugtargets";
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import { type DebugTarget } from "./debugtargets";
+import type { Accent, Background, Density, Palette, TermCustom, TermTheme } from "./theme";
+import type { SearchEngine } from "./browserurl";
+/** Open a URL in the default browser. */
+export declare const openExternal: (url: string) => Promise<void>;
+/** A box in physical pixels, relative to the window: where a browser pane's webview goes. */
+export interface PhysRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Open `url` in the browser pane's own webview (created the first time) at `r`. A private one
+ *  keeps no cookies, history or cache. */
+export declare const browserOpen: (pane: string, url: string, isPrivate: boolean, r: PhysRect, window?: string) => Promise<void>;
+/** Move the pane's webview, or hide it. */
+export declare const browserBounds: (pane: string, r: PhysRect, visible: boolean, window?: string) => Promise<void>;
+export declare const browserNav: (pane: string, action: "back" | "forward" | "reload" | "go" | "focus", url?: string) => Promise<void>;
+/** The chords Rust takes from a focused page: `deck` moves the keyboard back to Deck, `page` does not. */
+export declare const browserSetKeys: (deck: string[], page: string[]) => Promise<void>;
+export declare const browserClose: (pane: string) => Promise<void>;
+/** Answer a site's sign-in (user and password, or neither to cancel) or its certificate error (proceed). */
+export declare const browserSiteAnswer: (pane: string, id: number, a: {
+    user?: string;
+    password?: string;
+    proceed?: boolean;
+}) => Promise<void>;
+/** The page's print dialog, or its Save as dialog. */
+export declare const browserPrint: (pane: string, action: "print" | "save") => Promise<void>;
+/** Answer a site's request to send notifications (the pane's bar). */
+export declare const browserPermissionAnswer: (pane: string, id: number, allow: boolean) => Promise<void>;
+/** Open the app link (mailto:, zoommtg:) the pane asked for. */
+export declare const browserOpenAppLink: (pane: string, uri: string) => Promise<void>;
+/** A page's notification was clicked in Deck: the page hears of it. */
+export declare const browserNotificationClicked: (pane: string, id: number) => Promise<void>;
+/** Reload a page whose process hangs: that process is ended first. */
+export declare const browserReloadHung: (pane: string) => Promise<void>;
+/** The window fullscreen for a page that went fullscreen, or back as it was. */
+export declare const browserWindowFullscreen: (on: boolean, window?: string) => Promise<void>;
+/** Put a hidden pane's page to sleep, or wake it. */
+export declare const browserSleep: (pane: string, on: boolean) => Promise<void>;
+/** A JPEG of what the pane's webview shows. */
+/** The ad blocker on or off, and the sites it is off for. */
+export declare const adblockConfig: (enabled: boolean, off: string[], youtube: boolean) => Promise<void>;
+/** Whether the ad blocker is ready, how many rules it holds, and when its lists were downloaded. */
+export declare const adblockInfo: () => Promise<{
+    ready: boolean;
+    rules: number;
+    updated: number;
+}>;
+/** Rebuild the ad blocker from its lists and the user's own rules, after those changed. */
+export declare const adblockRebuild: () => Promise<void>;
+/** Download the ad blocker's lists again now. */
+export declare const adblockUpdate: () => Promise<void>;
+/** The browser's privacy settings, for every browser pane. */
+/** `scheme`: the light or dark mode pages are asked for (prefers-color-scheme); "auto" is Windows'. */
+export declare const browserPrivacy: (tracking: string, autofill: boolean, scheme: "light" | "dark" | "auto") => Promise<void>;
+/** Clear the browser's stored data of these kinds (cookies, cache, passwords, autofill) since `since`
+ *  (seconds since 1970; 0 for all of it). */
+export declare const browserClear: (kinds: string[], since: number) => Promise<void>;
+/** The user's answer to an agent asking to be signed in on a page: the login to fill, or none. */
+export declare const browserAgentFillAnswer: (id: number, login: string | null) => Promise<void>;
+/** A saved login, without its secrets. */
+export interface VaultMeta {
+    id: string;
+    site: string;
+    username: string;
+    note: string;
+    totp: boolean;
+    created: number;
+    updated: number;
+    used: number;
+}
+/** A login to save: a password or 2FA key left out keeps the saved one; an empty 2FA key removes it. */
+export interface VaultEntryIn {
+    id?: string;
+    site: string;
+    username: string;
+    password?: string;
+    note?: string;
+    totp?: string;
+}
+export declare const vaultStatus: () => Promise<{
+    exists: boolean;
+    unlocked: boolean;
+}>;
+/** The minutes before the vault locks itself, and whether to offer saving a sign-in. */
+export declare const vaultConfig: (autolockMinutes: number, offer: boolean) => Promise<void>;
+export declare const vaultCreate: (password: string) => Promise<void>;
+export declare const vaultUnlock: (password: string) => Promise<void>;
+export declare const vaultLock: () => Promise<void>;
+export declare const vaultChangePassword: (old: string, next: string) => Promise<void>;
+export declare const vaultList: () => Promise<VaultMeta[]>;
+/** Add or update a login; its id. */
+export declare const vaultSave: (entry: VaultEntryIn) => Promise<string>;
+export declare const vaultDelete: (id: string) => Promise<void>;
+/** One login's password, to show or copy. */
+export declare const vaultSecret: (id: string) => Promise<string>;
+/** One login's 2FA code now, and the seconds it has left. */
+export declare const vaultTotp: (id: string) => Promise<{
+    code: string;
+    remaining: number;
+}>;
+export declare const vaultGenerate: (length: number, symbols: boolean) => Promise<string>;
+/** The sites never offered saving for. */
+export declare const vaultNeverList: () => Promise<string[]>;
+export declare const vaultNeverRemove: (site: string) => Promise<void>;
+/** The logins saved for the page a pane shows. */
+export declare const vaultMatches: (pane: string) => Promise<VaultMeta[]>;
+/** Fill a login into the pane's page ("ok", or "user" when the page asks for the username first). */
+export declare const vaultFill: (pane: string, id: string) => Promise<string>;
+/** Fill a new generated password into a sign-up page's password fields. */
+export declare const vaultFillNew: (pane: string, length: number, symbols: boolean) => Promise<void>;
+export declare const vaultOfferAnswer: (pane: string, answer: "save" | "never" | "dismiss") => Promise<void>;
+/** Logins from a password export (Chrome, Edge, Brave, Firefox, Bitwarden). */
+export declare const vaultImport: (path: string) => Promise<{
+    added: number;
+    updated: number;
+    skipped: number;
+}>;
+/** Every login to a plain-text CSV file, after the master password again; how many. */
+export declare const vaultExport: (path: string, password: string) => Promise<number>;
+/** A page in the history: its title, how often and when it was last visited (ms). */
+export interface HistoryPage {
+    url: string;
+    title: string;
+    count: number;
+    last: number;
+}
+/** One visit to a page. */
+export interface HistoryVisit {
+    url: string;
+    title: string;
+    at: number;
+}
+/** A visit to a web page; `counted` false is only its title arriving. Whether anything changed. */
+export declare const browserHistoryVisit: (url: string, title: string, counted: boolean) => Promise<boolean>;
+export declare const browserHistoryRecent: (limit: number) => Promise<HistoryPage[]>;
+/** Visits newest first, before `before` (ms), whose page matches every word of `q`. */
+export declare const browserHistoryList: (q: string, before: number | null, limit: number) => Promise<HistoryVisit[]>;
+/** The pages the address bar offers for `q`, best first. */
+export declare const browserHistorySuggest: (q: string, limit: number) => Promise<HistoryPage[]>;
+/** How many pages the history holds. */
+export declare const browserHistoryCount: () => Promise<number>;
+export declare const browserHistoryForgetUrl: (url: string) => Promise<void>;
+/** Forget the visits from `from` to `to` (ms); all of them when neither is given. */
+export declare const browserHistoryForgetRange: (from?: number, to?: number) => Promise<void>;
+/** An installed extension. `id` is WebView2's, which chrome-extension:// addresses use. */
+export interface BrowserExtension {
+    id: string;
+    name: string;
+    version: string;
+    enabled: boolean;
+    storeId?: string;
+    popup?: string;
+    options?: string;
+    icon?: string;
+    path: string;
+    inPlace: boolean;
+}
+export declare const extensionsList: () => Promise<BrowserExtension[]>;
+/** Install from the Chrome Web Store, by its link or the extension's id; its name. */
+export declare const extensionInstallStore: (link: string) => Promise<string>;
+/** Install an unpacked extension from a folder: copied in, or loaded where it is (`inPlace`, developer mode); its name. */
+export declare const extensionInstallFolder: (path: string, inPlace?: boolean) => Promise<string>;
+/** Load an extension again from its files (an unpacked one's edits); its name. */
+export declare const extensionReload: (id: string) => Promise<string>;
+export declare const extensionSetEnabled: (id: string, enabled: boolean) => Promise<void>;
+export declare const extensionRemove: (id: string) => Promise<void>;
+/** Show an extension's popup page for `pane`, its right edge at `right` and top at `top` (physical pixels). */
+export declare const extensionPopup: (pane: string, id: string, page: string, right: number, top: number) => Promise<void>;
+export declare const extensionPopupClose: (pane: string) => Promise<void>;
+/** The sites agents may use in the browser without asking. */
+export declare const browserAgentConfig: (sites: string[], any?: boolean) => Promise<void>;
+/** The user's answer to an agent's question about a site. */
+export declare const browserAgentAnswer: (id: number, site: string, allow: boolean, forGood: boolean) => Promise<void>;
+/** A DevTools protocol call on a browser pane's page, and its answer. */
+export declare const browserCdp: (pane: string, method: string, params?: unknown) => Promise<unknown>;
+/** Open a browser pane's developer tools. */
+export declare const browserDevtools: (pane: string) => Promise<void>;
+/** What the site in a browser pane keeps and has been allowed: its cookie count and permissions. */
+export declare const browserSite: (pane: string) => Promise<{
+    origin: string;
+    cookies: number;
+    permissions: {
+        origin: string;
+        kind: number;
+        state: number;
+    }[];
+}>;
+/** Delete the site's cookies, storage and cache. */
+export declare const browserSiteClear: (pane: string) => Promise<void>;
+/** Every site given or refused a permission. */
+export declare const browserPermissions: () => Promise<{
+    origin: string;
+    kind: number;
+    state: number;
+}[]>;
+/** Set a site's permission: 0 ask again, 1 allow, 2 block. */
+export declare const browserPermissionSet: (origin: string, kind: number, state: number) => Promise<void>;
+/** Mute or unmute a browser pane's page. */
+export declare const browserMute: (pane: string, muted: boolean) => Promise<void>;
+/** Set a browser pane's page zoom (1 = 100%). */
+export declare const browserZoom: (pane: string, factor: number) => Promise<void>;
+/** Pause, resume or cancel one of the browser's downloads. */
+export declare const browserDownload: (id: number, action: "pause" | "resume" | "cancel") => Promise<void>;
+/** Find in the pane's page: start a search, step through its matches, or stop (clearing them). */
+export declare const browserFind: (pane: string, action: "start" | "next" | "prev" | "stop", term?: string, matchCase?: boolean) => Promise<void>;
+export declare const browserCapture: (pane: string) => Promise<ArrayBuffer>;
+/** Cut these boxes, each [x, y, w, h, corner radius] in physical px from the page's corner, out of a pane's page window, `w`×`h` its size; none gives it back whole. */
+export declare const browserCut: (pane: string, w: number, h: number, cuts: number[][]) => Promise<void>;
+export interface AppProc {
+    name: string;
+    title: string;
+    path: string;
+}
+/** A config's JSON text, "" when it does not exist yet. The name is its path in Deck's config folder
+ *  without `.json`, folders and all: `settings/settings`, `state/term-procs`. A plugin names its
+ *  own configs plainly (`boards`), and they are kept in `data/<plugin id>/`; one of Deck's own it
+ *  names in full. `config-changed` names configs the same way, a plugin's own as it names them. */
+export declare const configRead: (name: string) => Promise<string>;
+/** Raw bytes rather than a JSON argument: a 13.8MB pinboard parsed as JSON on Deck's UI thread
+ *  held every other command up for 200ms per save (see config_write in config.rs). */
+/** The name is percent-encoded: it travels in a header, which is ASCII, and a name can be any text
+ *  (a note's title). */
+export declare const configWrite: (name: string, json: string) => Promise<void>;
+/** Remove a config or plain file, in order with the writes before it. */
+export declare const configDelete: (name: string) => Promise<void>;
+/** A plugin's own folder in Deck's config folder, `<config dir>\data\<id>`, for listing or
+ *  renaming the files it keeps there with the fs* calls. A plugin calls it with no argument: its
+ *  shim knows which plugin it is. */
+export declare const dataDir: (plugin?: string) => Promise<string>;
+/** The optional readouts in the footer status strip. */
+/**
+ * A footer readout's id.
+ *
+ * `string` rather than a closed union because plugins contribute readouts too, and their ids are
+ * not known until a folder is read. The built-in ones are still listed in FOOTER_ITEMS below; a
+ * plugin's are merged in at run time by `footerItems()`.
+ */
+export type FooterItem = string;
+export declare const FOOTER_ITEMS: {
+    id: FooterItem;
+    label: string;
+    desc: string;
+}[];
+/**
+ * Stored order, with any item the stored list predates appended in its declared position.
+ *
+ * `known` is passed in rather than read from FOOTER_ITEMS so the caller can include the loaded
+ * plugins' readouts; without that a plugin's item would be filtered out as unrecognised.
+ */
+export declare function footerOrder(stored: FooterItem[] | undefined, known?: string[]): FooterItem[];
+export interface Settings {
+    warningMode: "toast" | "window" | "none";
+    warnLeadMin: number;
+    autostart: boolean;
+    closeToTray: boolean;
+    startMinimized: boolean;
+    reduceMotion: boolean;
+    /** The Servers list (hosts from ~/.ssh/config) under the workspace list. */
+    serversList: boolean;
+    /** The mouse wheel over a tab bar switches tabs rather than scrolling the bar. */
+    tabWheelSwitch: boolean;
+    /** When the tabs do not fit, every one but the open tab shrinks to its icon. */
+    tabSqueeze?: boolean;
+    /** A title-bar tab's full width in px (120 to 320, 160 when unset): its width, or with tabSqueeze the most it narrows from. */
+    tabWidth?: number;
+    /**
+     * Where things that arrive from outside open (Settings → Where things open). A floating window
+     * leaves the main window's tab as it was; a tab takes its place, as before floating windows.
+     * - openLinksIn: a link another program opens with Deck as the default browser ("float" unset).
+     * - openAgentPagesIn: a page an agent opens ("float-background" unset).
+     * - openFilesIn: a file opened with Deck from Explorer that opens in a plugin or the browser
+     *   ("float" unset); one for the Editor goes to the Editor either way.
+     */
+    openLinksIn?: "float" | "float-background" | "tab";
+    openAgentPagesIn?: "float-background" | "tab";
+    openFilesIn?: "float" | "tab";
+    /**
+     * A file for the Editor opened with Deck from Explorer ("tab" unset: the project's Editor, in the
+     * main window brought forward). "float": an Editor of its own in a floating window, as a file
+     * Ctrl+clicked in a terminal can open.
+     */
+    openCodeFilesIn?: "tab" | "float";
+    /**
+     * More of the same, for what you open yourself but only look at (Settings → Where things open):
+     * - openTerminalLinksIn: an address Ctrl+clicked in a terminal, with browserTerminalLinks "deck"
+     *   ("float" unset: the "links" window).
+     * - openDocsIn: a Docs page opened from Settings ("float" unset; Settings stays open).
+     * - openCommitsIn: a commit opened from the Editor's blame ("float" unset).
+     * - agentTerminals: a terminal tab or project an agent makes ("background" unset: added without
+     *   switching to it, its shell started anyway so the agent can use it; "switch" goes to it).
+     */
+    openTerminalLinksIn?: "float" | "tab";
+    /**
+     * A file path Ctrl+clicked in a terminal ("tab" unset: the Editor's tab, or the tab its type
+     * opens in). "float": an Editor of its own in a floating window, the project's left where it is;
+     * a type that opens elsewhere (a .pdf) in the "links" window.
+     */
+    openTerminalFilesIn?: "tab" | "float";
+    /** The same, per extension (".md"), over `openTerminalFilesIn`. */
+    openTerminalFilesByExt?: Record<string, "tab" | "float">;
+    openDocsIn?: "float" | "tab";
+    openCommitsIn?: "float" | "tab";
+    agentTerminals?: "background" | "switch";
+    /** Each project's own colour on the sidebar's collapsed rail. Off, they are all one grey. */
+    projectColours?: boolean;
+    /** Agents listed under their workspace in the sidebar: under every one (default), only the open one, or none. */
+    sidebarAgents?: "all" | "open" | "off";
+    /**
+     * Closing a tab, a group's tabs or a terminal pane (or restarting or replacing one) asks first:
+     * only when something is running in it besides the shell ("running", unset), every time, or
+     * never ("Don't ask again" in the question sets this).
+     */
+    askBeforeClose?: "running" | "always" | "never";
+    /** The workspace sidebar is a button in the title bar that opens it over the panes, rather than a column. */
+    sidebarMenu?: boolean;
+    /** Pane controls float over the pane's top-right corner on hover, instead of a header row. */
+    floatingPaneControls: boolean;
+    /** Per notification kind, whether it shows as a card, in the bell, with a sound, and as a Windows
+     *  notification while Deck is not focused. A missing entry takes the default (notifications.ts). */
+    notifPrefs?: Partial<Record<"input" | "done" | "attention" | "activity" | "update" | "error" | "plugin", Partial<Record<"card" | "bell" | "sound" | "os", boolean>>>>;
+    /** No cards and no sound; everything still lands in the bell. */
+    doNotDisturb?: boolean;
+    /** Which corner on the right the notification cards stack in. */
+    notifPosition?: "bottom" | "top";
+    /** Install plugin and language updates at startup instead of only announcing them. */
+    pluginAutoUpdate: boolean;
+    /** Download a newer Deck in the background and install it when Deck quits or next starts. Read by Rust too (update.rs). */
+    autoUpdate: boolean;
+    soundOnFire: boolean;
+    playerPlacement: "fixed" | "floating";
+    accent: Accent;
+    bgPreset: Background;
+    /** The colours of the "custom" background, each "#rrggbb". Kept when a preset is picked, so
+     *  going back to Custom finds them again. */
+    customTheme?: Partial<Palette>;
+    /** Custom palettes the user saved by name, shown as cards beside the presets. */
+    savedThemes?: {
+        id: string;
+        name: string;
+        palette: Partial<Palette>;
+    }[];
+    /** The saved theme the custom colours came from, which edits are written back to. */
+    savedThemeId?: string;
+    density: Density;
+    uiZoom: number;
+    termTheme: TermTheme;
+    /** The "custom" terminal theme's colours. Kept when another theme is picked. */
+    termCustom?: Partial<TermCustom>;
+    termFont: string;
+    termFontSize: number;
+    termScrollback: number;
+    wsSidebar: boolean;
+    termGpuRender: boolean;
+    wallpaper: string;
+    wallpaperDim: number;
+    wallpaperBlur: number;
+    wallpaperPanel: number;
+    footerItems: Record<FooterItem, boolean>;
+    footerOrder: FooterItem[];
+    footerVisible: boolean;
+    /**
+     * Drawer tabs the user has switched off, by id ("console", "plugin:flutter", a pinned pane's
+     * uuid). A DENY list, not an allow list: the tabs are discovered at run time — a plugin panel
+     * appears when its plugin loads, a pinned pane when you pin it — so anything unlisted is on,
+     * and a newly added tab shows up rather than being invisible until someone enables it.
+     *
+     * A plugin's own `panelWhen` still applies on top of this: switching a tab on returns it to the
+     * plugin's rule rather than overriding it, so enabling Flutter does not put an empty tab in
+     * every non-Flutter project.
+     */
+    drawerHidden: string[];
+    /** Drawer tabs left-to-right. Ids missing from it keep their discovery order, after the rest. */
+    drawerOrder: string[];
+    /** Which side of the footer each drawer tab and readout sits on, in order (core/footerlayout.ts).
+     *  Absent until something is moved: drawer tabs left, readouts right, in the orders above. */
+    footerLayout?: {
+        left: string[];
+        right: string[];
+    };
+    httpMcpRevealSecrets: boolean;
+    /**
+     * What to call the user: shown to the others when sharing (a Canvas board's cursor and the
+     * host's "wants to join"). "" means work it out: the Google account's name when signed in,
+     * else the Windows account's (see `userName` in settingsstore.ts).
+     */
+    userName: string;
+    /** What a new browser pane opens: Deck's start page, the search engine's own page, or a URL
+     *  (a site, or a local .html file the user wrote). */
+    browserHome: "deck" | "search" | "url";
+    browserHomeUrl: string;
+    /** Where a search typed into the address bar or the start page goes. */
+    browserSearch: SearchEngine;
+    /** Which parts of Deck's start page show. */
+    browserHomeSections: {
+        clock: boolean;
+        search: boolean;
+        servers: boolean;
+        pins: boolean;
+        recent: boolean;
+    };
+    /** Behind the start page: a photo that changes each time it opens, one from a folder of the
+     *  user's own, or none (Deck's background). */
+    browserBackground: "photos" | "folder" | "none";
+    browserBackgroundFolder: string;
+    /** Where the bookmarks bar shows under a browser's toolbar: on every page, on the start page
+     *  only, or not at all (and only once something is on it). true and false are what it was saved
+     *  as before it had three; read it through bookmarksBarMode. */
+    browserBookmarksBar: "always" | "home" | "never" | boolean;
+    /** WebView2's tracking prevention for the browser: how many trackers it blocks. */
+    browserTracking: "none" | "basic" | "balanced" | "strict";
+    /** Whether the vault offers to save a sign-in, and the minutes it stays open unused. */
+    browserVaultOffer: boolean;
+    browserVaultLock: number;
+    /** Extensions pinned to the browser's toolbar, by WebView2's id, in order. */
+    browserPinnedExtensions: string[];
+    /** The Extensions page's developer mode: load unpacked folders in place, reload them, ids and folders shown. */
+    browserExtensionsDev: boolean;
+    /** Whether the browser fills in forms (addresses, names). */
+    browserAutofill: boolean;
+    /** The ad blocker (EasyList and EasyPrivacy), and the sites it is switched off for, by host. */
+    browserAdblock: boolean;
+    browserAdblockOff: string[];
+    /** Skip YouTube's video ads: click Skip when it shows, run an unskippable one to its end. */
+    browserYoutubeSkip: boolean;
+    /** Where Ctrl+click on a web address in a terminal opens it: a browser tab of Deck's, or the system's. */
+    browserTerminalLinks: "deck" | "system";
+    /** Sleeping tabs: a browser tab out of sight this many minutes stops running until it is shown. */
+    browserSleep: boolean;
+    browserSleepAfter: number;
+    /** Sites whose tabs are never put to sleep (a chat, a call), by host; a host covers its subdomains. */
+    browserNeverSleep: string[];
+    /** Tabs of a site allowed to send notifications are never put to sleep (unset: on). */
+    browserNotifyAwake: boolean;
+    /**
+     * A page stays live under Deck's menus and cards, which are cut out of its window (unset: on).
+     * Off, a covered page is a blurred picture of itself, for a machine where the cut does not show.
+     */
+    browserLiveCovers?: boolean;
+    /** Whether pages are asked for light or dark to match Deck's theme ("deck") or Windows'. */
+    browserPageTheme?: "deck" | "windows";
+    /** App links opened without asking, as "<site origin> <scheme>" ("https://zoom.us zoommtg"). */
+    browserAppLinks: string[];
+    /** The start page offers to make Deck the default browser while it is not. Off: "Don't ask again". */
+    browserDefaultAsk?: boolean;
+    /** Sites (by host) an agent may use in the browser without asking; localhost and files always. */
+    browserAgentSites: string[];
+    /** Agents may use any site without being asked (signing in still asks). Off by default. */
+    browserAgentAnySite: boolean;
+    /**
+     * Where a file type opens, by extension (".pdf"): "editor", "browser" or "plugin:<id>". A type
+     * not listed is Automatic (see `openerFor` in fileview.ts).
+     */
+    openWith?: Record<string, string>;
+}
+/** The bookmarks bar setting, older true/false values included. */
+export declare const bookmarksBarMode: (s: Settings) => "always" | "home" | "never";
+export declare const DEFAULT_SETTINGS: Settings;
+export declare const setAutostart: (on: boolean) => Promise<void>;
+export declare const getAutostart: () => Promise<boolean>;
+export declare const toggleFullscreen: () => Promise<boolean>;
+export declare const isFullscreen: () => Promise<boolean>;
+/** Check a sudo password on the server and hold it until Deck exits (never written anywhere). */
+export declare const remoteSudoPassword: (host: string, password: string) => Promise<void>;
+/** Ask for the sudo password of `host` (SudoPasswordPrompt, mounted in App). True once it has
+ *  been accepted, false if the prompt was cancelled. */
+export declare function askSudoPassword(host: string): Promise<boolean>;
+/**
+ * Watch `paths` for changes made outside Deck (`fs-changed` events, a path each). `owner` names
+ * the caller: each owner sets only its own list and the watcher follows every owner's together, so
+ * one caller cannot replace or end another's watch. An empty list takes the owner out.
+ */
+export declare const watchFiles: (paths: string[], owner?: string) => Promise<void>;
+/** RAM in bytes: Deck and its WebView2 children, plus every claude.exe. */
+export interface MemServer {
+    id: string;
+    label: string;
+    mem: number;
+    cpu: number;
+    pid: number;
+}
+/** One process behind the figures, largest first. Only filled when memUsage(true) asks. */
+export interface MemProc {
+    pid: number;
+    name: string;
+    cmd: string;
+    mem: number;
+    /** Its share of all cores since the reading before. */
+    cpu: number;
+    group: "deck" | "server" | "browser" | "agent" | "run" | "pane-agent" | "pane";
+    /** The language server's session id, the run's id, or the terminal pane's id. */
+    owner: string;
+    /** An agent, or a process in a terminal pane that is not its shell: memKill may stop it. */
+    killable: boolean;
+}
+export interface MemUsage {
+    deck: number;
+    agents: number;
+    agent_count: number;
+    /** Percent of all cores, everything below together. -1 on the first reading, before there is anything to difference. */
+    cpu: number;
+    /** The same split as the memory: the app and WebView2, language servers, the browser's pages,
+     *  programs tools ran, every agent (Deck's and those in panes), and the terminal panes. */
+    cpu_core: number;
+    cpu_servers: number;
+    cpu_browser: number;
+    cpu_runs: number;
+    cpu_agents: number;
+    cpu_panes: number;
+    /** Deck minus its language servers and the browser. Part of `deck`. */
+    core: number;
+    /** The browser's pages (its own WebView2 profile). Also part of `deck`. */
+    browser: number;
+    /** Browser panes with a live webview, each with its renderers' memory, largest first. */
+    browser_tabs: {
+        pane: string;
+        mem: number;
+    }[];
+    /** Running language servers, largest first. Also part of `deck`. */
+    servers: MemServer[];
+    /** Programs a tool ran through Deck (a Flutter app, a dev server, kubectl). NOT part of `deck`. */
+    runs: number;
+    run_count: number;
+    /** Terminal panes. NOT part of `deck` — informational only. */
+    panes: number;
+    pane_count: number;
+    /** claude running inside a pane. Also not part of `deck`. */
+    pane_agents: number;
+    pane_agent_count: number;
+    procs: MemProc[];
+}
+/** `detail` also lists every process with its command line: for the open popover, not the poll. */
+export declare const memUsage: (detail?: boolean) => Promise<MemUsage>;
+/** Stop a process the memory popover lists, and what it started. Refused unless `killable`. An agent in a pane is asked to quit first: true when it did, false when it was killed. */
+export declare const memKill: (pid: number) => Promise<boolean>;
+/** Stop the claude or codex running in a terminal pane, as memKill does. */
+export declare const agentStop: (pane: string) => Promise<boolean>;
+/** An output ("out") or input ("in") device. `volume` is 0 to 1. */
+export interface AudioDevice {
+    id: string;
+    name: string;
+    flow: "out" | "in";
+    /** The default for apps, and for calls. */
+    default: boolean;
+    default_comms: boolean;
+    volume: number;
+    muted: boolean;
+}
+/** An app with sound on the default output: its own volume (0 to 1) within the device's, and how loud it plays now. */
+export interface AudioSession {
+    pid: number;
+    name: string;
+    volume: number;
+    muted: boolean;
+    peak: number;
+}
+/** Every active output and input device. Cheap enough to poll. */
+export declare const audioDevices: () => Promise<AudioDevice[]>;
+export declare const audioSetVolume: (id: string, level: number) => Promise<void>;
+export declare const audioSetMute: (id: string, muted: boolean) => Promise<void>;
+/** Make a device the default for everything: apps and calls. */
+export declare const audioSetDefault: (id: string) => Promise<void>;
+/** How loud a device is playing or hearing right now, 0 to 1. */
+export declare const audioPeak: (id: string) => Promise<number>;
+/** The apps with sound on the default output; a program with several processes comes once per process. */
+export declare const audioSessions: () => Promise<AudioSession[]>;
+/** The icon of the program behind a session (its `pid`), as PNG bytes of `size` px. */
+export declare const audioIcon: (pid: number, size: number) => Promise<Uint8Array<ArrayBuffer>>;
+/** One app's volume and mute, by its process id. */
+export declare const audioSessionSet: (pid: number, level?: number, muted?: boolean) => Promise<void>;
+/** Hold a system-wide shortcut ("ctrl+shift+m") under `id`, heard in every app as a `global-shortcut` event `{ id, chord }`. Refused when another app holds the chord. */
+export declare const shortcutSet: (id: string, chord: string) => Promise<void>;
+/** Free the shortcut `id` holds. */
+export declare const shortcutClear: (id: string) => Promise<void>;
+export declare const listApps: () => Promise<AppProc[]>;
+export declare const listInstalled: () => Promise<AppProc[]>;
+export declare const runScriptNow: (command: string, args: string[], id?: string, name?: string) => Promise<void>;
+export declare const pickScript: () => Promise<string>;
+export interface ExecOut {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+/**
+ * Run a command to completion and read its output. `runScriptNow` is fire-and-forget; this is
+ * for when the output IS the point — asking a tool what it knows rather than telling it to do
+ * something. A bare name goes through cmd.exe, so PATH and .bat shims (`flutter`, `npm`) work.
+ */
+export declare const exec: (command: string, args?: string[], cwd?: string) => Promise<ExecOut>;
+/** One header, one value. A list rather than a map: order matters, and repeats are legal. */
+export type HttpHeader = [string, string];
+export interface HttpSendRequest {
+    method: string;
+    url: string;
+    headers?: HttpHeader[];
+    body?: string;
+}
+export interface HttpSendResult {
+    status: number;
+    status_text: string;
+    headers: HttpHeader[];
+    body: string;
+    /** Present only when the body is not valid UTF-8 — an image, a zip. `body` is lossy then. */
+    body_b64?: string;
+    size: number;
+    truncated: boolean;
+    elapsed_ms: number;
+}
+/**
+ * Send one HTTP request and read the whole response.
+ *
+ * The `id` http.rs wants for cancellation is generated here: it exists so the HTTP module can
+ * abort a send in flight, and a caller doing one GET should not have to invent one. A caller
+ * that does need to cancel should use core/httpclient.ts, which owns that id.
+ */
+export declare const httpSend: (req: HttpSendRequest) => Promise<HttpSendResult>;
+/**
+ * The same send under an id the caller chose, so it can be cancelled with `httpCancel` while in
+ * flight. `req` is the full shape http.rs takes; the Requests plugin builds it.
+ */
+export declare const httpSendAs: <T = HttpSendResult>(id: string, req: object) => Promise<T>;
+/** Abort the send started under `id`. A no-op when it has already finished. */
+export declare const httpCancel: (id: string) => Promise<void>;
+/**
+ * Answer an `http-send` event: a send the MCP asked for through sessions.rs, which waits on this
+ * reply under `job`. The Requests plugin listens for the event and does the send.
+ */
+export declare const httpSendReply: (job: string, body: string) => Promise<void>;
+export declare const pickFolder: () => Promise<string>;
+/** Native "save as" dialog. Returns "" when cancelled. */
+export declare const pickSavePath: (defaultName: string, ext: string) => Promise<string>;
+/** Native "open file" dialog. Returns "" when cancelled. */
+export declare const pickFile: (ext: string) => Promise<string>;
+/** Native "open file" dialog with no type filter, for choosing a file to upload: an endpoint may
+ *  accept any extension, so a filter would only hide valid choices. "" when cancelled. */
+export declare const pickAnyFile: () => Promise<string>;
+/** Open dialog filtered to the image types a webview can display. */
+export declare const pickImage: () => Promise<string>;
+/** Copy a chosen image into the config dir; returns the path Deck will read it from. */
+export declare const setWallpaper: (src: string) => Promise<string>;
+export declare const clearWallpaper: () => Promise<void>;
+export declare const revealInFolder: (path: string) => Promise<void>;
+/** Deck's newest log file (`<config dir>\logs\deck-YYYY-MM-DD.log`), or the folder when empty. */
+export declare const logLatest: () => Promise<string>;
+export declare const openFile: (path: string) => Promise<void>;
+/** Files Deck was launched with — a double-click through Explorer's "Open with". */
+export declare const launchFiles: () => Promise<string[]>;
+/** Web addresses Deck was launched with: a link opened in another app, Deck being the default browser. */
+export declare const launchUrls: () => Promise<string[]>;
+export interface DefaultBrowserStatus {
+    registered: boolean;
+    isDefault: boolean;
+    name: string;
+}
+/** Whether Deck is offered as a browser in Windows, and whether links open with it. */
+export declare const browserDefaultStatus: () => Promise<DefaultBrowserStatus>;
+/** Register Deck as a browser for this user and open Windows' Default apps page at it: Windows
+ *  keeps the choice itself to the user. */
+export declare const browserDefaultRegister: () => Promise<DefaultBrowserStatus>;
+export declare const mediaSetNowPlaying: (title: string, artist: string, artPath: string) => Promise<void>;
+export declare const mediaSetPlayback: (playing: boolean) => Promise<void>;
+export interface TrackMeta {
+    path: string;
+    title: string;
+    artist: string;
+    album: string;
+    duration: number;
+    art_path: string;
+}
+export declare const readTrackMeta: (paths: string[]) => Promise<TrackMeta[]>;
+export { convertFileSrc } from "@tauri-apps/api/core";
+/** Start a sign-in. Returns the consent URL to open in the browser. */
+export declare const googleSignIn: () => Promise<string>;
+/** A valid access token, refreshed if needed. Rejects when not connected. */
+export declare const googleToken: () => Promise<string>;
+/** The connected account, or null when not connected. */
+export interface GoogleAccount {
+    email: string;
+    name: string;
+    picture: string;
+}
+export declare const googleAccount: () => Promise<GoogleAccount | null>;
+export declare const googleSignOut: () => Promise<void>;
+export interface UsageBucket {
+    tokens: number;
+    cost: number;
+}
+export interface UsageSession extends UsageBucket {
+    remainingMinutes?: number | null;
+}
+export interface ClaudeUsage {
+    today?: UsageBucket;
+    week?: UsageBucket;
+    month?: UsageBucket;
+    session?: UsageSession | null;
+    error?: string;
+}
+export declare const claudeUsage: () => Promise<ClaudeUsage>;
+export interface PlanLimit {
+    kind: string;
+    group: string;
+    percent: number;
+    severity: string;
+    resets_at: string | null;
+    is_active: boolean;
+    scope?: {
+        model?: {
+            display_name?: string;
+        };
+    } | null;
+}
+export interface PlanLimits {
+    limits?: PlanLimit[];
+    error?: string;
+}
+export declare const claudePlanLimits: () => Promise<PlanLimits>;
+/** An agent pane as the session surface sees it. Status: working | idle | blocked. */
+export interface AgentSession {
+    pane_id: string;
+    agent: string;
+    status: string;
+    cwd: string;
+    title: string;
+}
+export declare const sessionList: () => Promise<AgentSession[]>;
+export interface ScriptJob {
+    id: string;
+    name: string;
+    command: string;
+    args: string[];
+    mode: "interval" | "atTime";
+    intervalMin: number;
+    days: string[];
+    timeOfDay: string;
+    everyWeeks: number;
+    startDate: string;
+    enabled: boolean;
+    lastRun: number;
+    target?: "local" | "vps";
+}
+export interface HistoryEntry {
+    module: string;
+    label: string;
+    payload: any;
+    firedAt: number;
+    mode?: "delay" | "atTime";
+    recurring?: boolean;
+    days?: string[];
+    timeOfDay?: string;
+    delayMin?: number;
+}
+export interface StartupProgram {
+    Name: string;
+    Path: string;
+    Args: string[];
+    Days: string[];
+    Start: string;
+    End: string;
+    Enabled: boolean;
+}
+export declare const pickExe: () => Promise<string>;
+export declare const readTermLayout: <T>() => Promise<T | null>;
+/** `mtimeMs` is epoch ms, 0 if unreadable — lets a caller tell a settled file from one still being written. */
+/** One entry of a folder. `size` is bytes (0 for a folder); `hidden` is Windows' hidden attribute,
+ *  or a dot name on a server. */
+export interface FsEntry {
+    name: string;
+    path: string;
+    dir: boolean;
+    mtimeMs: number;
+    size: number;
+    hidden: boolean;
+}
+export interface GitStatusRow {
+    path: string;
+    rel: string;
+    letter: string;
+    staged: boolean;
+}
+/** One folder level, folders first. `all` includes the build folders (node_modules, target, .git…)
+ *  that a code folder's tree leaves out. */
+export declare const fsList: (dir: string, all?: boolean) => Promise<FsEntry[]>;
+/** A drive of this PC (`C:\`): its label, kind, and size and free space in bytes (0 for a network drive or a disc). */
+export interface Drive {
+    path: string;
+    label: string;
+    kind: "fixed" | "removable" | "network" | "cd";
+    total: number;
+    free: number;
+}
+/** The drives Windows has. A one-off read, never for a poll. */
+export declare const fsDrives: () => Promise<Drive[]>;
+/**
+ * Windows' shell namespace, for what has no drive letter: a phone or camera on USB, which Explorer
+ * lists under This PC (shellfs.rs). A path is the item's parsing name; its parts are the device's
+ * object ids, so names come from the listing and from shellParents, never from the path.
+ */
+/** `total` and `free`: a device's storage and the space left on it, in bytes (0 when it does not say). */
+export interface ShellPlace {
+    name: string;
+    path: string;
+    total: number;
+    free: number;
+}
+/** Phones, cameras and other portable devices under This PC. */
+export declare const shellPlaces: () => Promise<ShellPlace[]>;
+/** A shell folder's items, the shape fsList gives (a device's sizes and times may be 0). */
+export declare const shellList: (path: string) => Promise<FsEntry[]>;
+/** The folders from the device down to `path`, with their names. */
+export declare const shellParents: (path: string) => Promise<ShellPlace[]>;
+/**
+ * Copy or move into `dest`, either side a shell path or this PC's, with Windows' own progress and
+ * its question when a name is taken. False when cancelled there.
+ */
+export declare const shellTransfer: (sources: string[], dest: string, move: boolean) => Promise<boolean>;
+/** Delete for good (a device has no Recycle Bin); ask before calling. */
+export declare const shellDelete: (paths: string[]) => Promise<boolean>;
+export declare const shellRename: (path: string, name: string) => Promise<boolean>;
+export declare const shellNewFolder: (dir: string, name: string) => Promise<boolean>;
+/** `%APPDATA%\Deck\plugins` (Deck-Dev in a debug build), created on first call. */
+export declare const pluginsDir: () => Promise<string>;
+/** `%APPDATA%\Deck\languages` (Deck-Dev in a debug build), created on first call. */
+export declare const languagesDir: () => Promise<string>;
+/** Delete a language definition's folder (by its folder name). The server and debugger it names stay installed. */
+export declare const removeLanguage: (folder: string) => Promise<void>;
+export declare const fsRead: (path: string) => Promise<string>;
+/** Raw bytes, for a file that is not text — fsRead decodes as UTF-8 and would corrupt it. */
+export declare const fsReadBytes: (path: string) => Promise<Uint8Array<ArrayBuffer>>;
+export declare const fsSize: (path: string) => Promise<number>;
+/** What is at a remote path. A missing one is `exists: false`, not an error. */
+export interface RemoteStat {
+    exists: boolean;
+    dir: boolean;
+    size: number;
+    mtimeMs: number;
+}
+export declare const remoteStat: (path: string) => Promise<RemoteStat>;
+/** The server's home folder as host:/home/user (host+sudo: when it runs as root). */
+export declare const remoteHome: (host: string, sudo: boolean) => Promise<string>;
+/** Host names from ~/.ssh/config, without patterns. */
+export declare const sshHosts: () => Promise<string[]>;
+export declare const fsWrite: (path: string, content: string) => Promise<void>;
+/** Raw bytes — a PDF, an image, a response — which a string would corrupt. Sent as the raw body,
+ *  the path percent-encoded in a header; a remote path writes over SSH. */
+export declare const fsWriteBytes: (path: string, bytes: Uint8Array) => Promise<void>;
+/** Write bytes without ever clobbering: dedupes the name on collision, returns the path used. */
+export declare const fsSaveUnique: (saveTo: string, defaultName: string, bytes: Uint8Array) => Promise<string>;
+export declare const fsHomeDir: () => Promise<string>;
+/**
+ * Move into a directory, creating it if missing. Returns the new full path.
+ *
+ * `onConflict` "rename" deduplicates to "name (1).ext" instead of failing — for an unattended
+ * caller with nobody to answer an overwrite prompt. Omit it for the interactive case.
+ */
+export declare const fsMove: (src: string, dstDir: string, onConflict?: "fail" | "rename") => Promise<string>;
+export declare const fsCreateFile: (dir: string, name: string) => Promise<string>;
+/** Open a path with its default application. */
+export declare const fsOpen: (path: string) => Promise<void>;
+/** The user's Downloads folder (home if there isn't one). */
+export declare const dirsDownload: () => Promise<string>;
+/** Relaunch Deck — the same binary, so a dev instance stays dev. Used by the plugin toggle. */
+export declare const restartApp: () => Promise<void>;
+/** Start a test Deck (`deck.exe --test`) beside this one, or bring the running one forward. */
+export declare const openTestDeck: () => Promise<void>;
+/** Fetch the VPS's Script Runner run log over SSH into the local run-log-vps config (vpsjobs.rs). */
+export declare const vpsRunsPull: () => Promise<void>;
+/** What Rust saw of this launch, as Unix ms: process creation and the setup() span. Null until
+ *  setup() has finished, which is before any page script runs. */
+export interface StartupMarks {
+    process: number;
+    setupStart: number;
+    setupEnd: number;
+}
+export declare const startupMarks: () => Promise<StartupMarks | null>;
+/** The page has drawn: Rust shows the window, hidden until then so it never shows see-through. */
+export declare const deckReady: () => Promise<void>;
+/** What a backup file holds: the Deck that wrote it, when, and how many of each thing. */
+export interface BackupSummary {
+    deck: string;
+    created: string;
+    configs: number;
+    plugins: number;
+    languages: number;
+    notes: number;
+}
+/** Every config, plugin and language to one file, credentials left out (backup.rs). */
+export declare const backupExport: (path: string) => Promise<BackupSummary>;
+export declare const backupInspect: (path: string) => Promise<BackupSummary>;
+/** Writes the backup over this machine's copies. Deck should restart afterwards. */
+export declare const backupRestore: (path: string) => Promise<BackupSummary>;
+/** One file of a plugin, as the registry describes it. */
+export interface RemoteFile {
+    url: string;
+    sha256: string;
+    bytes?: number;
+}
+/**
+ * Install a plugin or a language definition from the registry.
+ *
+ * `kind` decides where it lands and what it is allowed to contain: a plugin's three files in
+ * `plugins/`, or a language.json and its snippets in `languages/`. Rust refuses anything else,
+ * because the file names become paths.
+ *
+ * Every file's SHA-256 is checked before anything is written. It matters most for a plugin —
+ * `plugin.js` runs with this bridge, so unverified bytes would be someone else's code running
+ * here — but a corrupted language definition is worth refusing too. Nothing is written unless
+ * every file checks out.
+ *
+ * Resolves to the installed id; both kinds load without a restart.
+ */
+export declare const installFromRegistry: (kind: string, id: string, files: Record<string, RemoteFile>) => Promise<string>;
+/** One line of output from a `procStream` run. `stream` is "stdout" or "stderr". */
+export interface ProcLine {
+    id: string;
+    stream: string;
+    line: string;
+}
+/** How a `procStream` run ended. `cancelled` separates a `procKill` from a real failure. */
+export interface ProcResult {
+    id: string;
+    code: number;
+    cancelled: boolean;
+}
+/**
+ * Run a program, emitting a `proc-line` event per output line, and resolve when it exits.
+ *
+ * `id` is the caller's handle — it tags every event and is what `procKill` takes, so concurrent
+ * runs can be told apart. Listen with `listen<ProcLine>("proc-line", …)` and filter on it.
+ *
+ * `stdin: true` opens the child's input for `procWrite`, which is what turns this from "run a
+ * command and read the output" into driving a long-lived tool that takes commands — a daemon
+ * speaking one JSON object per line, or a program reading single keypresses.
+ */
+export declare const procStream: (id: string, program: string, args: string[], cwd?: string, stdin?: boolean) => Promise<ProcResult>;
+/**
+ * Write to a running `procStream`'s stdin. Only works when it was started with `stdin: true`.
+ *
+ * Raw — no newline is appended, since whether one terminates a message belongs to the protocol.
+ */
+export declare const procWrite: (id: string, data: string) => Promise<void>;
+export declare const procKill: (id: string) => Promise<void>;
+export declare const fsCreateDir: (dir: string, name: string) => Promise<string>;
+export declare const fsRename: (path: string, newName: string) => Promise<string>;
+export declare const fsDelete: (path: string) => Promise<void>;
+/** Move to the Recycle Bin, so it can be restored (fsDelete removes for good). */
+export declare const fsTrash: (path: string) => Promise<void>;
+export declare const fsCopy: (src: string, dstDir: string) => Promise<string>;
+export declare const fsReveal: (path: string) => Promise<void>;
+/**
+ * Deck's MCP server, which lets an agent drive Deck's terminals and HTTP client, registered with
+ * an AI coding agent: "claude", "codex", "gemini" or "cursor". The server ships with Deck as a
+ * single bundled file. Each agent keeps its MCP servers somewhere else (see agentmcp.rs), a file
+ * that belongs to that agent, so Deck backs it up first, merges rather than replaces, and refuses
+ * outright if it cannot parse it. The status is "missing", "current", "stale" (an entry pointing
+ * somewhere else, as a reinstall to another folder leaves) or "no-node" (nothing could run it).
+ */
+export declare const agentMcpStatus: (agent: string) => Promise<string>;
+export declare const installAgentMcp: (agent: string) => Promise<string>;
+/** Deck's hooks for an agent that has them ("claude", "codex"): what the Agents panel and the
+ *  agent notifications hear from. Merged into the agent's own settings, backed up first. */
+export declare const installAgentHooks: (agent: string) => Promise<void>;
+/**
+ * Deck's skills (how to use its MCP tools) for an agent that reads skills: "claude" or "codex".
+ * Each comes back with what happened to it: "installed", "updated", "current", "kept-yours" (a
+ * skill of that name that is not Deck's) or "kept-edited" (Deck's, changed since). Deck only
+ * replaces a skill folder it wrote and nobody has edited.
+ */
+export declare const installAgentSkills: (agent: string) => Promise<{
+    skill: string;
+    outcome: string;
+}[]>;
+/** Which agent command-line tools are on PATH: any of claude, codex, gemini, cursor-agent, cursor. */
+export declare const agentClis: () => Promise<string[]>;
+export declare const notifyOs: (title: string, body: string) => Promise<void>;
+/** Run `git -C <dir> <args>`: its stdout, or what git said as the error. Never prompts for
+ *  credentials. What the Git plugin builds its operations on. */
+export declare const gitRun: (dir: string, args: string[]) => Promise<string>;
+export declare const gitStatus: (dir: string) => Promise<GitStatusRow[]>;
+/** The repos a folder holds: the one it is inside first, then any below it. Each a repo's top level. */
+export declare const gitRepos: (dir: string) => Promise<string[]>;
+export interface BlameLine {
+    hash: string;
+    author: string;
+    time: number;
+    summary: string;
+    uncommitted: boolean;
+}
+export declare const gitBlameLine: (dir: string, rel: string, line: number, contents: string) => Promise<BlameLine | null>;
+/** A blob's raw bytes. `rev` is "HEAD", or "" for the index. Empty = absent from that revision.
+ *  For content the text commands would corrupt: an image, a font. */
+export declare const gitFileBytes: (dir: string, rev: string, rel: string) => Promise<Uint8Array<ArrayBuffer>>;
+export interface GitInfo {
+    branch: string;
+    has_remote: boolean;
+    ahead: number;
+    behind: number;
+}
+export declare const gitInfo: (dir: string) => Promise<GitInfo>;
+/** gitStatus and gitInfo in one `git status -b`: what the editor's poll asks for every 3s. */
+export declare const gitPoll: (dir: string) => Promise<{
+    rows: GitStatusRow[];
+    info: GitInfo;
+}>;
+export declare const gitFileDiff: (dir: string, rel: string) => Promise<string>;
+export interface ImportedPack {
+    id: string;
+    label: string;
+    theme_json: string;
+}
+export declare const importIconPack: (srcDir: string) => Promise<ImportedPack>;
+export declare const deleteIconPack: (id: string) => Promise<void>;
+export declare const readIconPackTheme: (path: string) => Promise<string>;
+export declare const gitDiscard: (dir: string, paths: string[]) => Promise<void>;
+export interface GraphCommit {
+    hash: string;
+    parents: string[];
+    author: string;
+    email: string;
+    date: string;
+    subject: string;
+    body: string;
+    refs: string[];
+}
+export declare const gitLogGraph: (dir: string, skip: number, rel?: string, refs?: string[]) => Promise<GraphCommit[]>;
+/** `old`: a rename's or copy's path before the commit, which its parent side is read from. */
+export interface CommitFile {
+    rel: string;
+    letter: string;
+    adds: number;
+    dels: number;
+    old?: string;
+}
+export declare const gitCommitFiles: (dir: string, hash: string) => Promise<CommitFile[]>;
+export interface GitRef {
+    kind: "local" | "remote" | "tag";
+    name: string;
+    current: boolean;
+    author: string;
+    hash: string;
+    summary: string;
+    time: number;
+}
+export declare const gitRefs: (dir: string) => Promise<GitRef[]>;
+export declare const gitCheckout: (dir: string, name: string) => Promise<string>;
+export declare const gitCheckoutNew: (dir: string, name: string) => Promise<string>;
+export declare const gitCheckoutTrack: (dir: string, remote: string) => Promise<string>;
+export declare const gitCheckoutDetach: (dir: string, rev: string) => Promise<string>;
+export declare const gitAiCommitMsg: (dir: string, command: string, args: string, model: string) => Promise<string>;
+/** The GitHub CLI, `gh pr …` or `gh repo view …` only. Rejects with "gh-missing" when gh is not installed. */
+export declare const ghRun: (dir: string, args: string[]) => Promise<string>;
+/** Pull request N's review threads, as GitHub's GraphQL JSON (parsed by prs.ts parseThreads). */
+export declare const ghPrThreads: (dir: string, number: number) => Promise<string>;
+/** Comment on one line of a PR's diff: side "RIGHT" is the new version, "LEFT" the old. */
+export declare const ghPrLineComment: (dir: string, number: number, commit: string, path: string, line: number, side: "LEFT" | "RIGHT", body: string) => Promise<string>;
+export declare const ghThreadReply: (dir: string, thread: string, body: string) => Promise<string>;
+export declare const ghThreadResolve: (dir: string, thread: string, resolve: boolean) => Promise<string>;
+/** The GitLab CLI, `glab mr …` only. Rejects with "glab-missing" when glab is not installed. */
+export declare const glabRun: (dir: string, args: string[]) => Promise<string>;
+/**
+ * One GitLab REST request about this repo's merge requests (`projects/:id/merge_requests…` or
+ * `user`). `fields` go as strings; `json` values must be objects or arrays.
+ */
+export declare const glabApi: (dir: string, method: "GET" | "POST" | "PUT", path: string, fields?: [string, string][], json?: Record<string, object>) => Promise<string>;
+/** The files that differ between two revisions. */
+export declare const gitRangeFiles: (dir: string, from: string, to: string) => Promise<CommitFile[]>;
+export interface SearchHit {
+    path: string;
+    rel: string;
+    line: number;
+    text: string;
+}
+export interface SearchOpts {
+    caseSensitive: boolean;
+    isRegex: boolean;
+    wholeWord: boolean;
+    includes: string;
+    excludes: string;
+}
+/** Every file under `dir` (absolute paths), .gitignore respected — the editor's Ctrl+P. */
+export declare const fsFiles: (dir: string) => Promise<string[]>;
+/** One file `fsFind` found. `mtime` is milliseconds since the epoch. */
+export interface FoundFile {
+    path: string;
+    size: number;
+    mtime: number;
+}
+/**
+ * Every file with one of `exts` (no dot) under `roots`, or under every fixed drive when roots is
+ * null, skipping folders named in `excludeDirs` at any depth and files under `minSize` bytes.
+ * A walk of whole drives takes on the order of a minute.
+ */
+export declare const fsFind: (roots: string[] | null, exts: string[], excludeDirs: string[], minSize: number) => Promise<FoundFile[]>;
+/** Windows' own thumbnail of a file (what Explorer shows), as PNG bytes fitting `size` x `size`.
+ *  Rejects when Windows has none for it. */
+/** What Windows knows about a photo or video (its Properties' Details tab). Absent fields are null. */
+export interface MediaMeta {
+    /** Date taken or recorded, ms since the epoch. */
+    taken: number | null;
+    width: number | null;
+    height: number | null;
+    camera: string | null;
+    lat: number | null;
+    lon: number | null;
+    duration_ms: number | null;
+}
+/** The properties of each path, in order; one that cannot be read comes back all null. */
+export declare const mediaMeta: (paths: string[]) => Promise<MediaMeta[]>;
+/** SHA-256 of each file's contents, in order; null for one that cannot be read. */
+export declare const fsHash: (paths: string[]) => Promise<(string | null)[]>;
+export declare const fsThumbnail: (path: string, size: number) => Promise<Uint8Array<ArrayBuffer>>;
+export declare const fsSearch: (dir: string, query: string, o: SearchOpts) => Promise<SearchHit[]>;
+export declare const fsReplace: (dir: string, query: string, replacement: string, o: SearchOpts, files?: string[], line?: number) => Promise<number>;
+export interface DbQueryResult {
+    columns: string[];
+    /** Cell values, already JSON: null, boolean, number, or a string for everything else. */
+    rows: unknown[][];
+    total: number;
+    truncated: boolean;
+    affected: number;
+}
+export interface DbColumn {
+    name: string;
+    type: string;
+    notNull: boolean;
+    pk: boolean;
+}
+export interface DbTable {
+    name: string;
+    kind: "table" | "view";
+    columns: DbColumn[];
+    /** The statement that created it, where the engine keeps one (SQLite). */
+    sql?: string;
+}
+export interface DbForeignKey {
+    table: string;
+    column: string;
+    refTable: string;
+    refColumn: string;
+}
+export interface DbSchema {
+    tables: DbTable[];
+    foreignKeys: DbForeignKey[];
+}
+/** Open a connection; the url's scheme picks the engine. The handle outlives the calling component. */
+export declare const dbConnect: (url: string) => Promise<number>;
+export declare const dbDisconnect: (handle: number) => Promise<void>;
+/**
+ * Run a statement and return up to 1000 rows, after skipping the first `skip` (how a grid pages).
+ * `readOnly` refuses writes, by the database itself (a read-only session on Postgres and MySQL,
+ * query_only on SQLite).
+ */
+export declare const dbQuery: (handle: number, sql: string, readOnly: boolean, skip?: number) => Promise<DbQueryResult>;
+export declare const dbSchema: (handle: number) => Promise<DbSchema>;
+/** Open a tunnel. `remote` is host:port as seen FROM `host`. Returns [id, local port]. */
+export declare const sshTunnelOpen: (host: string, remote: string) => Promise<[number, number]>;
+export declare const sshTunnelClose: (id: number) => Promise<void>;
+/**
+ * Offer programs to the editor's debugger: a plugin that runs something debuggable (the Flutter
+ * plugin's runs) publishes them here, and the Run and Debug panel lists them to attach to. Pass
+ * the plugin's whole current list each time, under its own `source`; an empty list removes it.
+ * See core/debugtargets.ts.
+ */
+export declare const setDebugTargets: (source: string, targets: DebugTarget[]) => void;
+export type { DebugTarget } from "./debugtargets";