deck-plugin-sdk 1.4.0 → 1.5.0

package/template/src/plugin.tsx

@@ -1,65 +1,65 @@
-// __NAME__ — a Deck plugin.
-//
-// The default export is the tab. A plugin can export more than that — a footer readout, a
-// settings panel, palette commands, a pane view — and `plugins/API.md` in the Deck repository
-// lists every slot. One export is enough to start.
-import { useState } from "react";
-import { Sparkles } from "lucide-react";
-import { configRead, configWrite } from "../shim/bridge.js";
-
-/** Where this plugin's own settings live. The `plugin-` prefix keeps them on this machine. */
-const CONFIG = "plugin-__ID__";
-
-export default function __COMPONENT__() {
-  const [note, setNote] = useState("");
-  const [saved, setSaved] = useState(false);
-
-  // Deck's config store, the same one its own modules use. Reading a key that has never been
-  // written resolves to an empty string rather than throwing.
-  const load = async () => {
-    const raw = await configRead(CONFIG).catch(() => "");
-    setNote(raw.trim() ? (JSON.parse(raw) as { note?: string }).note ?? "" : "");
-  };
-
-  const save = async () => {
-    await configWrite(CONFIG, JSON.stringify({ note }));
-    setSaved(true);
-    setTimeout(() => setSaved(false), 1500);
-  };
-
-  return (
-    <div className="flex h-full flex-col gap-4 p-6">
-      <header className="flex items-center gap-3">
-        <Sparkles size={18} style={{ color: "var(--accent)" }} />
-        <h1 className="text-base font-semibold text-text-primary">__NAME__</h1>
-      </header>
-
-      <p className="max-w-[60ch] text-sm text-text-secondary">
-        Edit <code className="rounded bg-elev px-1.5 py-0.5 text-text-primary">src/plugin.tsx</code>,
-        run <code className="rounded bg-elev px-1.5 py-0.5 text-text-primary">npm run dev</code>,
-        and Deck reloads the plugin as you save.
-      </p>
-
-      <div className="flex max-w-md items-center gap-2">
-        <input
-          value={note}
-          onChange={(e) => setNote(e.target.value)}
-          onFocus={() => void load()}
-          placeholder="Type something, then save it"
-          className="min-w-0 flex-1 rounded-lg border border-subtle bg-elev px-3 py-2 text-sm text-text-primary outline-none focus:border-accent"
-        />
-        <button
-          onClick={() => void save()}
-          className="shrink-0 rounded-lg border border-subtle bg-elev px-3 py-2 text-sm text-text-secondary hover:border-accent hover:text-text-primary"
-        >
-          {saved ? "Saved" : "Save"}
-        </button>
-      </div>
-
-      <p className="text-xs text-text-muted">
-        That writes to Deck's config store under <code>{CONFIG}</code>, which stays on this
-        machine.
-      </p>
-    </div>
-  );
-}
+// __NAME__ — a Deck plugin.
+//
+// The default export is the tab. A plugin can export more than that — a footer readout, a
+// settings panel, palette commands, a pane view — and `docs/guide/api.md` in the Deck repository
+// lists every slot. One export is enough to start.
+import { useState } from "react";
+import { Sparkles } from "lucide-react";
+import { configRead, configWrite } from "deck-plugin-sdk/bridge";
+
+/** This plugin's own settings. Deck keeps a plugin's configs in its own folder, so a plain name. */
+const CONFIG = "settings";
+
+export default function __COMPONENT__() {
+  const [note, setNote] = useState("");
+  const [saved, setSaved] = useState(false);
+
+  // Deck's config store, the same one its own modules use. Reading a key that has never been
+  // written resolves to an empty string rather than throwing.
+  const load = async () => {
+    const raw = await configRead(CONFIG).catch(() => "");
+    setNote(raw.trim() ? (JSON.parse(raw) as { note?: string }).note ?? "" : "");
+  };
+
+  const save = async () => {
+    await configWrite(CONFIG, JSON.stringify({ note }));
+    setSaved(true);
+    setTimeout(() => setSaved(false), 1500);
+  };
+
+  return (
+    <div className="flex h-full flex-col gap-4 p-6">
+      <header className="flex items-center gap-3">
+        <Sparkles size={18} style={{ color: "var(--accent)" }} />
+        <h1 className="text-base font-semibold text-text-primary">__NAME__</h1>
+      </header>
+
+      <p className="max-w-[60ch] text-sm text-text-secondary">
+        Edit <code className="rounded bg-elev px-1.5 py-0.5 text-text-primary">src/plugin.tsx</code>,
+        run <code className="rounded bg-elev px-1.5 py-0.5 text-text-primary">npm run dev</code>,
+        and Deck reloads the plugin as you save.
+      </p>
+
+      <div className="flex max-w-md items-center gap-2">
+        <input
+          value={note}
+          onChange={(e) => setNote(e.target.value)}
+          onFocus={() => void load()}
+          placeholder="Type something, then save it"
+          className="min-w-0 flex-1 rounded-lg border border-subtle bg-elev px-3 py-2 text-sm text-text-primary outline-none focus:border-accent"
+        />
+        <button
+          onClick={() => void save()}
+          className="shrink-0 rounded-lg border border-subtle bg-elev px-3 py-2 text-sm text-text-secondary hover:border-accent hover:text-text-primary"
+        >
+          {saved ? "Saved" : "Save"}
+        </button>
+      </div>
+
+      <p className="text-xs text-text-muted">
+        That writes to Deck's config store under <code>{CONFIG}</code>, which stays on this
+        machine.
+      </p>
+    </div>
+  );
+}

package/types/core/bridge.d.ts

@@ -8,12 +8,22 @@ export interface AppProc {
     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.
@@ -158,9 +168,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 +181,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 +220,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,7 +234,8 @@ 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[]>;
@@ -261,38 +250,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 +331,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 +340,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 +379,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 +397,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
@@ -473,8 +425,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 +482,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 +507,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 +522,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 +537,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 +546,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 +567,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 +582,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 +599,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;
@@ -808,7 +684,6 @@ 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

package/types/core/editorsession.d.ts

@@ -0,0 +1,50 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+export interface SessionTab {
+    /** Older sessions can also hold "graph" and "pr" tabs, from before git moved to the Git
+     *  plugin. The Editor skips them on restore. */
+    kind: "file" | "media" | "graph" | "pr";
+    path: string;
+    rel: string | null;
+    dirty?: string;
+}
+export interface WorkspaceSession {
+    tabs: SessionTab[];
+    activeId: string | null;
+    expanded: string[];
+    /** A typed-but-uncommitted message. Per root, because a message belongs to the repo it
+     *  describes. Only the active module is mounted, so without this a half-written message is
+     *  destroyed by switching to a terminal to check something — which is exactly when you switch. */
+    commitMsg?: string;
+    /** Collapsed Source Control rows: the two section headers, and folders in tree view. Per root
+     *  because the keys are paths in this repo. A Set on the way in and out; an array here because
+     *  that is what survives JSON. */
+    scmCollapsed?: string[];
+}
+/** A file to open, and optionally where in it to land. */
+export interface PendingFile {
+    path: string;
+    line?: number;
+}
+export declare function queueOpenFiles(files: (string | PendingFile)[], instance?: EditorInstance): void;
+/** Take everything queued for one editor, leaving its queue empty. */
+export declare function drainOpenFiles(instance?: EditorInstance): PendingFile[];
+/**
+ * Which editor is asking.
+ *
+ * There are two: the Editor tab, which opens whatever folder you point it at, and the one inside
+ * Terminals, which follows that workspace's cwd. They are separate windows onto different work,
+ * so their open folder and their UI prefs are stored per instance. Open TABS already separate on
+ * their own — loadSession is keyed by root, and the two rarely share one.
+ */
+export type EditorInstance = "tab" | "terminals";
+export declare function loadEditorRoot(instance: EditorInstance): string;
+export declare function saveEditorRoot(instance: EditorInstance, root: string): void;
+export interface GlobalUi {
+    mdMode: "edit" | "live" | "split" | "preview";
+    panel: "explorer" | "search" | "debug" | "scm";
+    sidebarW: number;
+}
+export declare function loadSession(root: string): WorkspaceSession | null;
+export declare function saveSession(root: string, s: WorkspaceSession): void;
+export declare function loadUi(instance: EditorInstance): Partial<GlobalUi>;
+export declare function saveUi(instance: EditorInstance, ui: GlobalUi): void;

package/types/core/fileview.d.ts

@@ -0,0 +1,35 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/** The view showing `path` in plugin `pluginId`'s pane view. */
+export declare const fileView: (pluginId: string, path: string) => string;
+/** A view id's own part, and the file it was opened on if any. */
+export declare function splitView(view: string): {
+    base: string;
+    file?: string;
+};
+/**
+ * What two views are compared by, so one file is one tab however its path was spelled: the file
+ * tree, a terminal link and Quick Open can each give the same file with other slashes or case
+ * (Windows paths are case-insensitive). The stored view keeps the path as given, for the title.
+ */
+export declare function viewKey(view: string): string;
+/** A path's extension, lowercased with its dot (".pdf"), or "" when it has none. */
+export declare const extOf: (path: string) => string;
+/** The last part of a path, for a tab's title. */
+export declare const fileName: (path: string) => string;
+/** Extensions as a plugin wrote them (".pdf", "PDF", "pdf"), as extOf returns them. */
+export declare const normaliseExts: (exts: unknown) => string[];
+/**
+ * Which loaded plugin opens which file types, from each plugin's `opens` export. Filled by the
+ * plugin loader (plugins.ts) on every load; here so that anything can ask without importing it.
+ */
+export declare const fileOpeners: {
+    id: string;
+    exts: string[];
+}[];
+/** The id of the plugin that opens `path` (by its extension), or undefined: the Editor's. */
+export declare function pluginForFile(path: string): string | undefined;
+/**
+ * Open `path` in the plugin that claims its type, as a tab of its own. False when no plugin does,
+ * so the caller opens it in the Editor as before. Every way Deck opens a file asks this first.
+ */
+export declare function openWithPlugin(path: string): boolean;

package/types/core/terminals.d.ts

@@ -300,6 +300,11 @@ export declare function moveWorkspace(id: string, toIndex: number): void;
  * Empty for a pane that has not spawned yet, which is the honest answer — there is nothing in it.
  */
 export declare function paneLines(id: string, max?: number): string[];
+/**
+ * Open a file in Deck the way its file tree does: in the plugin that opens its type (a .pdf in the
+ * PDF plugin), otherwise in this workspace's Editor, at `line` when given.
+ */
+export declare function openFile(path: string, line?: number): void;
 export declare function getInstance(id: string): Instance;
 /**
  * Wrap pasted text in bracketed-paste markers, so the receiving app can tell one paste from

package/types/modules/editor/DiffPeek.d.ts

@@ -0,0 +1,19 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import { type RefObject } from "react";
+import { monaco } from "../../core/monaco";
+import { type DirtyRange } from "./hunks";
+/**
+ * The peek, for the editor in `edRef` showing `path` with the gutter's `ranges`. Returns what to
+ * render (a portal into the overlay), or null while closed.
+ *
+ * `clean` is whether the editor holds what is on disk: the changes are git's, read from disk, so
+ * their line numbers only fit the buffer when it has no unsaved edits. Staging and reverting wait
+ * for a save otherwise. `readBase` gives the text a change is against: the index's copy of the
+ * file for a change in the working tree, HEAD's for a staged one.
+ */
+export declare function useDiffPeek(edRef: RefObject<monaco.editor.IStandaloneCodeEditor | null>, path: string, ranges: DirtyRange[] | undefined, opts: {
+    clean: boolean;
+    onStage: (r: DirtyRange) => Promise<void>;
+    onUnstage: (r: DirtyRange) => Promise<void>;
+    readBase: (staged: boolean) => Promise<string>;
+}): import("react").ReactPortal | null;

package/types/modules/editor/MonacoHosts.d.ts

@@ -1,8 +1,8 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import { monaco } from "../../core/monaco";
 import { type EditorSettings } from "../../core/editorsettings";
-import type { DirtyRange } from "./tree";
-declare function MonacoEditorInner({ path, rel, value, onChange, onSave, gotoLine, gotoCol, gotoNonce, highlight, dirty, settings, onEditor }: {
+import type { DirtyRange } from "./hunks";
+declare function MonacoEditorInner({ path, rel, value, onChange, onSave, gotoLine, gotoCol, gotoNonce, highlight, dirty, settings, onEditor, clean, onStageChange, onUnstageChange, onReadBase }: {
     path: string;
     rel?: string | null;
     value: string;
@@ -22,6 +22,13 @@ declare function MonacoEditorInner({ path, rel, value, onChange, onSave, gotoLin
     /** Hands the live editor out, and null on unmount. For a formatting toolbar, which has to
      *  dispatch into this instance rather than rewrite the string around it. */
     onEditor?: (e: monaco.editor.IStandaloneCodeEditor | null) => void;
+    /** The buffer matches the file on disk, which the gutter's changes were read from. */
+    clean?: boolean;
+    /** Stage or unstage one change from the gutter's peek (DiffPeek.tsx). */
+    onStageChange?: (r: DirtyRange) => Promise<void>;
+    onUnstageChange?: (r: DirtyRange) => Promise<void>;
+    /** The text the file's changes are against: the index's copy, or HEAD's for a staged change. */
+    onReadBase?: (staged: boolean) => Promise<string>;
 }): import("react").JSX.Element;
 /**
  * Monaco owns its buffer, so this component re-rendering achieves nothing on its own — yet it was
@@ -35,13 +42,19 @@ declare function MonacoEditorInner({ path, rel, value, onChange, onSave, gotoLin
  */
 export declare const MonacoEditor: import("react").MemoExoticComponent<typeof MonacoEditorInner>;
 export declare function applyLineChanges(original: monaco.editor.ITextModel, modified: monaco.editor.ITextModel, diffs: monaco.editor.ILineChange[]): string;
+type HunkRun = (change: monaco.editor.ILineChange, models: {
+    original: monaco.editor.ITextModel;
+    modified: monaco.editor.ITextModel;
+}) => void;
+/**
+ * Per-change buttons in a diff's gutter: stage (or unstage) one change, and, given `revert`, put
+ * one change back to the left side's text. Each change gets them at its first line.
+ */
 export interface HunkAction {
     label: string;
     unstage: boolean;
-    run: (change: monaco.editor.ILineChange, models: {
-        original: monaco.editor.ITextModel;
-        modified: monaco.editor.ITextModel;
-    }) => void;
+    run: HunkRun;
+    revert?: HunkRun;
 }
 /** A side of a diff: LEFT the old version, RIGHT the new — GitHub's names, which line comments use. */
 export type DiffSide = "LEFT" | "RIGHT";