deck-plugin-sdk 0.15.1

package/types/core/bridge.d.ts

@@ -0,0 +1,670 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import type { AccentColor, BgPreset, Density, TermTheme } from "./theme";
+/** Open a URL in the default browser. */
+export declare const openExternal: (url: string) => Promise<void>;
+export interface AppProc {
+    name: string;
+    title: string;
+    path: string;
+}
+export declare const configRead: (name: string) => Promise<string>;
+export declare const configWrite: (name: string, json: string) => Promise<void>;
+export declare const getVaultRoot: () => Promise<string>;
+export declare const setVaultRoot: (path: string) => Promise<void>;
+/** 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;
+    soundOnFire: boolean;
+    playerPlacement: "fixed" | "floating";
+    accent: AccentColor;
+    bgPreset: BgPreset;
+    density: Density;
+    termTheme: TermTheme;
+    termFont: string;
+    termFontSize: number;
+    termScrollback: number;
+    wsSidebar: boolean;
+    termGpuRender: boolean;
+    wallpaper: string;
+    wallpaperDim: number;
+    wallpaperBlur: number;
+    wallpaperPanel: number;
+    /** Atlassian site host, for building a browse link when a cached ticket has no URL. */
+    jiraSite: string;
+    assistantVoice: string;
+    /** Silence spoken replies without losing the chosen voice. Toggled from the Ask console. */
+    assistantMuted: boolean;
+    userName: string;
+    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[];
+    httpMcpRevealSecrets: boolean;
+}
+export declare const DEFAULT_SETTINGS: Settings;
+/** Stop anything being spoken right now. */
+export declare function stopSpeaking(): void;
+export declare function speakWithVoice(text: string, opts?: {
+    rate?: number;
+    onend?: () => void;
+    onerror?: () => void;
+}): SpeechSynthesisUtterance | null;
+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>;
+/** Watch these exact paths for external changes; emits "fs-changed" with the path. [] stops. */
+export declare const watchFiles: (paths: 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;
+}
+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. Part of `deck`. */
+    core: 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;
+}
+export declare const memUsage: () => 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 {
+    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>;
+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>;
+export interface SetupCheck {
+    id: string;
+    ok: boolean;
+    detail: string;
+}
+export declare const setupChecks: () => Promise<SetupCheck[]>;
+/** 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>;
+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>;
+/** 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>;
+export declare const defaultDownloadDir: () => 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[]>;
+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 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>;
+export interface JiraItem {
+    key: string;
+    status: string;
+    title: string;
+    url?: string;
+    /** One sentence on what the ticket asks for — what the rail shows and a drag carries. */
+    summary?: string;
+    /** The full description as markdown, for the detail drawer. */
+    description?: string;
+    assignee?: string;
+    priority?: string;
+}
+export interface TicketCache {
+    tickets: JiraItem[];
+    fetched: number;
+}
+export declare const jiraCached: () => Promise<TicketCache | null>;
+export declare const jiraRefresh: () => Promise<TicketCache | null>;
+export interface CalItem {
+    /** Start as 24-hour HH:MM, or "" for an all-day event. */
+    time: string;
+    end?: string;
+    title: string;
+    /** Video-call join URL, when the event has one. */
+    link?: string;
+    location?: string;
+    attendees?: number;
+}
+export interface CalendarCache {
+    events: CalItem[];
+    fetched: number;
+}
+export declare const calendarCached: () => Promise<CalendarCache | null>;
+export declare const calendarRefresh: () => Promise<CalendarCache | null>;
+/** 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 FeedItem {
+    from: string;
+    /** Slack: the channel, or "DM". Mail has none. */
+    where?: string;
+    /** Slack's message body. */
+    text?: string;
+    /** Mail's subject and one-line gloss. */
+    subject?: string;
+    snippet?: string;
+    url?: string;
+    when?: string;
+    /** Slack only: "dm" or "mention". */
+    kind?: string;
+}
+export interface FeedCache {
+    items: FeedItem[];
+    fetched: number;
+}
+export declare const slackCached: () => Promise<FeedCache | null>;
+export declare const slackRefresh: () => Promise<FeedCache | null>;
+export declare const mailCached: () => Promise<FeedCache | null>;
+export declare const mailRefresh: () => Promise<FeedCache | null>;
+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 declare const askAssistant: (message: string, sessionId: string, resume: boolean, userName: string, jiraSite: string) => Promise<string>;
+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 declare const historyDelete: (index: number) => Promise<void>;
+export declare const historyClear: (module: string) => Promise<void>;
+export interface StartupProgram {
+    Name: string;
+    Path: string;
+    Args: string[];
+    Days: string[];
+    Start: string;
+    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;
+    path: string;
+    dir: boolean;
+    mtimeMs: number;
+}
+export interface GitStatusRow {
+    path: string;
+    rel: string;
+    letter: string;
+    staged: boolean;
+}
+export declare const fsList: (dir: string) => Promise<FsEntry[]>;
+/** `%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>;
+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>;
+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. */
+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>;
+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>;
+/** 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;
+    sha256: string;
+}
+/**
+ * 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>;
+export declare const fsCopy: (src: string, dstDir: string) => Promise<string>;
+export declare const fsReveal: (path: string) => Promise<void>;
+export declare const installClaudeHooks: () => Promise<void>;
+export declare const removeClaudeHooks: () => Promise<void>;
+export declare const notifyOs: (title: string, body: string) => Promise<void>;
+export declare const gitStatus: (dir: string) => Promise<GitStatusRow[]>;
+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>;
+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>>;
+export interface GitInfo {
+    branch: string;
+    has_remote: boolean;
+    ahead: number;
+    behind: number;
+}
+export declare const gitInfo: (dir: string) => Promise<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;
+    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 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;
+    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[]>;
+export interface CommitFile {
+    rel: string;
+    letter: string;
+    adds: number;
+    dels: number;
+}
+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;
+    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>;
+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") => 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>;
+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;
+    line: number;
+    text: string;
+}
+export interface SearchOpts {
+    caseSensitive: boolean;
+    isRegex: boolean;
+    wholeWord: boolean;
+    includes: string;
+    excludes: string;
+}
+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[];
+}
+export interface DbForeignKey {
+    table: string;
+    column: string;
+    refTable: string;
+    refColumn: string;
+}
+export interface DbSchema {
+    tables: DbTable[];
+    foreignKeys: DbForeignKey[];
+}
+/** Open a postgres:// or mysql:// connection. 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>;
+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][]>;