deck-plugin-sdk 1.4.0 → 1.6.0

package/types/core/bridge.d.ts

@@ -1,19 +1,213 @@
 // 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) => Promise<void>;
+/** Move the pane's webview, or hide it. */
+export declare const browserBounds: (pane: string, r: PhysRect, visible: boolean) => 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>;
+/** 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. */
+export declare const browserPrivacy: (tracking: string, autofill: boolean) => 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[]) => 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>;
 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>;
-export declare const getVaultRoot: () => Promise<string>;
-export declare const setVaultRoot: (path: 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.
@@ -46,6 +240,19 @@ export interface Settings {
     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;
+    /** Each project's own colour on the sidebar's collapsed rail. Off, they are all one grey. */
+    projectColours?: 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;
@@ -106,7 +313,53 @@ export interface Settings {
      * 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";
+    /** 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[];
+}
+/** 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>;
@@ -158,9 +411,6 @@ export interface MemUsage {
 export declare const memUsage: (detail?: boolean) => Promise<MemUsage>;
 export declare const listApps: () => Promise<AppProc[]>;
 export declare const listInstalled: () => Promise<AppProc[]>;
-export declare const closeApp: (target: string) => Promise<string>;
-export declare const openApp: (path: string) => Promise<void>;
-export declare const powerAction: (action: string) => Promise<void>;
 export declare const runScriptNow: (command: string, args: string[], id?: string, name?: string) => Promise<void>;
 export declare const pickScript: () => Promise<string>;
 export interface ExecOut {
@@ -174,12 +424,6 @@ export interface ExecOut {
  * 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>;
-export declare const notesScope: (cwd: string) => Promise<string>;
-export declare const notesList: (scope: string) => Promise<string[]>;
-export declare const notesRead: (scope: string, name: string) => Promise<string>;
-export declare const notesWrite: (scope: string, name: string, text: string) => Promise<void>;
-export declare const notesDelete: (scope: string, name: string) => Promise<void>;
-export declare const notesRename: (scope: string, from: string, to: string) => Promise<void>;
 /** One header, one value. A list rather than a map: order matters, and repeats are legal. */
 export type HttpHeader = [string, string];
 export interface HttpSendRequest {
@@ -219,19 +463,6 @@ export declare const httpCancel: (id: string) => Promise<void>;
  * 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 interface DownloadItem {
-    id: string;
-    url: string;
-    title: string;
-    quality: string;
-    format?: string;
-    filePath?: string;
-    sizeBytes?: number;
-    status: "done" | "failed";
-    at: number;
-}
-export declare const readDownloads: () => Promise<string>;
-export declare const writeDownloads: (json: 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>;
@@ -246,10 +477,23 @@ export declare const pickImage: () => Promise<string>;
 export declare const setWallpaper: (src: string) => Promise<string>;
 export declare const clearWallpaper: () => Promise<void>;
 export declare const revealInFolder: (path: string) => Promise<void>;
-export declare const defaultDownloadDir: () => Promise<string>;
+/** 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 {
@@ -261,38 +505,7 @@ export interface TrackMeta {
     art_path: string;
 }
 export declare const readTrackMeta: (paths: string[]) => Promise<TrackMeta[]>;
-export interface MusicFolder {
-    id: string;
-    name: string;
-    path: string;
-}
-export interface MusicPlaylist {
-    id: string;
-    name: string;
-    tracks: string[];
-}
-export interface MusicLibrary {
-    folders: MusicFolder[];
-    favorites: string[];
-    playlists: MusicPlaylist[];
-}
-export declare const EMPTY_LIBRARY: MusicLibrary;
-export declare const readLibrary: () => Promise<MusicLibrary>;
-export declare const writeLibrary: (lib: MusicLibrary) => Promise<void>;
 export { convertFileSrc } from "@tauri-apps/api/core";
-export interface SongSuggestion {
-    id: string;
-    title: string;
-    artist: string;
-    why: string;
-}
-export interface MusicSuggestions {
-    generated_at: number;
-    songs: SongSuggestion[];
-}
-export declare const readMusicSuggestions: () => Promise<MusicSuggestions | null>;
-export declare const readMusicTaste: () => Promise<string>;
-export declare const writeMusicTaste: (text: string) => Promise<void>;
 /** 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. */
@@ -373,8 +586,6 @@ export interface HistoryEntry {
     timeOfDay?: string;
     delayMin?: number;
 }
-export declare const historyDelete: (index: number) => Promise<void>;
-export declare const historyClear: (module: string) => Promise<void>;
 export interface StartupProgram {
     Name: string;
     Path: string;
@@ -384,11 +595,8 @@ export interface StartupProgram {
     End: string;
     Enabled: boolean;
 }
-export declare const startupRead: () => Promise<string>;
-export declare const startupWrite: (json: string) => Promise<void>;
 export declare const pickExe: () => Promise<string>;
 export declare const readTermLayout: <T>() => Promise<T | null>;
-export declare const writeTermLayout: (layout: unknown) => Promise<void>;
 /** `mtimeMs` is epoch ms, 0 if unreadable — lets a caller tell a settled file from one still being written. */
 export interface FsEntry {
     name: string;
@@ -426,7 +634,8 @@ 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 — saving a response that is an image or a PDF, which a string would corrupt. */
+/** 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>;
@@ -443,12 +652,10 @@ export declare const fsCreateFile: (dir: string, name: string) => Promise<string
 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>;
-export declare const vaultResolve: (path: string) => Promise<string>;
-export declare const vaultRelativize: (path: string) => Promise<string>;
-export declare const vaultDataRead: (name: string) => Promise<string>;
-export declare const vaultDataWrite: (name: string, text: string) => Promise<void>;
 /** 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
@@ -459,6 +666,8 @@ export interface StartupMarks {
     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;
@@ -473,8 +682,6 @@ 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>;
-/** Copy a plugin folder into the plugins directory. Returns its id. Validates before writing. */
-export declare const installPlugin: (src: string) => Promise<string>;
 /** One file of a plugin, as the registry describes it. */
 export interface RemoteFile {
     url: string;
@@ -532,33 +739,19 @@ export declare const fsDelete: (path: string) => Promise<void>;
 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>;
-export declare const installClaudeHooks: () => Promise<void>;
 /**
- * Deck's MCP server, which lets an agent drive Deck's terminals and HTTP client.
- *
- * The server ships with Deck as a single bundled file, so there is nothing to clone or install.
- * Registering it adds one entry to ~/.claude.json — a file that belongs to Claude Code, so Deck
- * backs it up first, merges rather than replaces, and refuses outright if it cannot parse it.
- *
- * `claudeMcpStatus` is "missing", "current", or "stale" — stale meaning an entry exists but
- * points somewhere else, which is what a reinstall to a different folder leaves behind.
- */
-export declare const claudeMcpStatus: () => Promise<string>;
-export declare const claudeMcpEntry: () => Promise<string>;
-export declare const installClaudeMcp: () => Promise<string>;
-export declare const removeClaudeMcp: () => Promise<void>;
-/**
- * The same for any AI coding agent Deck knows: "claude", "codex", "gemini" or "cursor". Each keeps
- * its MCP servers somewhere else (see agentmcp.rs); the status is the same four answers, with
- * "no-node" when nothing could run the server whatever the config says.
+ * 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>;
-export declare const removeAgentMcp: (agent: string) => Promise<void>;
 /** 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>;
-export declare const removeAgentHooks: (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
@@ -571,8 +764,10 @@ export declare const installAgentSkills: (agent: string) => Promise<{
 }[]>;
 /** 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 removeClaudeHooks: () => Promise<void>;
 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[]>;
@@ -584,7 +779,6 @@ export interface BlameLine {
     uncommitted: boolean;
 }
 export declare const gitBlameLine: (dir: string, rel: string, line: number, contents: string) => Promise<BlameLine | null>;
-export declare const gitHeadFile: (dir: string, rel: string) => Promise<string>;
 /** 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>>;
@@ -600,10 +794,6 @@ export declare const gitPoll: (dir: string) => Promise<{
     rows: GitStatusRow[];
     info: GitInfo;
 }>;
-export declare const gitCommit: (dir: string, message: string) => Promise<string>;
-export declare const gitPush: (dir: string) => Promise<string>;
-export declare const gitPull: (dir: string) => Promise<string>;
-export declare const gitIndexFile: (dir: string, rel: string) => Promise<string>;
 export declare const gitFileDiff: (dir: string, rel: string) => Promise<string>;
 export interface ImportedPack {
     id: string;
@@ -613,9 +803,6 @@ export interface ImportedPack {
 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 gitStage: (dir: string, paths: string[]) => Promise<void>;
-export declare const gitStageContent: (dir: string, rel: string, content: string) => Promise<void>;
-export declare const gitUnstage: (dir: string, paths: string[]) => Promise<void>;
 export declare const gitDiscard: (dir: string, paths: string[]) => Promise<void>;
 export interface GraphCommit {
     hash: string;
@@ -637,14 +824,6 @@ export interface CommitFile {
     old?: string;
 }
 export declare const gitCommitFiles: (dir: string, hash: string) => Promise<CommitFile[]>;
-export declare const gitShowFile: (dir: string, rev: string, rel: string) => Promise<string>;
-export declare const gitPullRebase: (dir: string) => Promise<string>;
-export declare const gitFetch: (dir: string) => Promise<string>;
-export interface GitBranch {
-    name: string;
-    current: boolean;
-}
-export declare const gitBranches: (dir: string) => Promise<GitBranch[]>;
 export interface GitRef {
     kind: "local" | "remote" | "tag";
     name: string;
@@ -660,28 +839,6 @@ export declare const gitCheckoutNew: (dir: string, name: string) => Promise<stri
 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>;
-export declare const gitCommitAmend: (dir: string, message: string) => Promise<string>;
-export declare const gitUndoCommit: (dir: string) => Promise<string>;
-export declare const gitBranchAt: (dir: string, name: string, rev: string) => Promise<string>;
-export declare const gitRevert: (dir: string, rev: string) => Promise<string>;
-export declare const gitCherryPick: (dir: string, rev: string) => Promise<string>;
-export declare const gitResetTo: (dir: string, rev: string, mode: "soft" | "mixed" | "hard" | "keep") => Promise<string>;
-export declare const gitTag: (dir: string, name: string, rev: string, message?: string) => Promise<string>;
-export declare const gitMerge: (dir: string, rev: string, noFf?: boolean) => Promise<string>;
-/** Rebase the current branch onto `onto`; a conflict leaves it pending (gitPendingOp → "rebase"). */
-export declare const gitRebase: (dir: string, onto: string) => Promise<string>;
-/** HEAD's commit and branch ("" when detached) — what an undo returns to. */
-export declare const gitHead: (dir: string) => Promise<{
-    hash: string;
-    branch: string;
-}>;
-/** Merge `rev` into the current branch: a merge commit always, fast-forward when possible, or squashed into one commit. */
-export declare const gitMergeAs: (dir: string, rev: string, style: "no-ff" | "ff" | "squash") => Promise<string>;
-/** Finish a merge, rebase, revert or cherry-pick (what gitPendingOp reported) once its conflicts are staged. */
-export declare const gitContinueOp: (dir: string, op: string) => Promise<string>;
-/** Subjects of the commits on `head` that `base` lacks, oldest first. */
-export declare const gitRangeSubjects: (dir: string, base: string, head: string) => Promise<string[]>;
-export declare const gitRemoteUrl: (dir: string, name: 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). */
@@ -699,30 +856,6 @@ export declare const glabRun: (dir: string, args: string[]) => Promise<string>;
 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 declare const gitMergeBase: (dir: string, a: string, b: string) => Promise<string>;
-/** Fetch pull request N's head from `remote`, so its commits can be diffed here. `gitlab`: a merge request's. */
-export declare const gitFetchPr: (dir: string, remote: string, number: number, base: string, gitlab?: boolean) => Promise<string>;
-export declare const gitBranchRename: (dir: string, from: string, to: string) => Promise<string>;
-export declare const gitPendingOp: (dir: string) => Promise<string>;
-export declare const gitAbortOp: (dir: string, op: string) => Promise<string>;
-export declare const gitBranchDelete: (dir: string, name: string, force?: boolean) => Promise<string>;
-export declare const gitBranchDeleteRemote: (dir: string, remote: string, name: string) => Promise<string>;
-export declare const gitTagDelete: (dir: string, name: string) => Promise<string>;
-export declare const gitTagPush: (dir: string, remote: string, name: string) => Promise<string>;
-export declare const gitTagDeleteRemote: (dir: string, remote: string, name: string) => Promise<string>;
-export declare const gitPushBranch: (dir: string, remote: string, name: string) => Promise<string>;
-export declare const gitRemotes: (dir: string) => Promise<string[]>;
-export interface GitStash {
-    index: number;
-    message: string;
-}
-export declare const gitStash: (dir: string, kind?: "" | "untracked" | "staged", message?: string) => Promise<string>;
-export declare const gitStashShow: (dir: string, index: number) => Promise<string>;
-export declare const gitStashList: (dir: string) => Promise<GitStash[]>;
-export declare const gitStashApply: (dir: string, index?: number) => Promise<string>;
-export declare const gitStashPop: (dir: string, index?: number) => Promise<string>;
-export declare const gitStashDrop: (dir: string, index?: number) => Promise<string>;
-export declare const gitStashClear: (dir: string) => Promise<string>;
 export interface SearchHit {
     path: string;
     rel: string;
@@ -788,6 +921,8 @@ 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;
@@ -799,16 +934,19 @@ export interface DbSchema {
     tables: DbTable[];
     foreignKeys: DbForeignKey[];
 }
-/** Open a postgres:// or mysql:// connection. The handle outlives the calling component. */
+/** 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 ONE statement. `readOnly` wraps it in a read-only transaction the server enforces. */
-export declare const dbQuery: (handle: number, sql: string, readOnly: boolean) => Promise<DbQueryResult>;
+/**
+ * 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>;
-export declare const sshTunnelList: () => Promise<[number, number][]>;
 /**
  * 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