deck-plugin-sdk 1.2.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/components/ui.d.ts

@@ -23,7 +23,7 @@ export declare function TimeInput({ value, onChange, className, }: {
     onChange: (v: string) => void;
     className?: string;
 }): import("react").JSX.Element;
-export declare function Select(props: React.SelectHTMLAttributes<HTMLSelectElement>): import("react").JSX.Element;
+export declare function Select({ className, ...props }: React.SelectHTMLAttributes<HTMLSelectElement>): import("react").JSX.Element;
 export declare function PrimaryButton({ children, ...p }: React.ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
 export declare function GhostButton({ children, ...p }: React.ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
 /**

package/types/core/bridge.d.ts

@@ -1,6 +1,6 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import { type DebugTarget } from "./debugtargets";
-import type { AccentColor, BgPreset, Density, TermTheme } from "./theme";
+import type { Accent, Background, Density, Palette, TermCustom, TermTheme } from "./theme";
 /** Open a URL in the default browser. */
 export declare const openExternal: (url: string) => Promise<void>;
 export interface AppProc {
@@ -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.
@@ -44,12 +54,30 @@ export interface Settings {
     reduceMotion: boolean;
     /** The Servers list (hosts from ~/.ssh/config) under the workspace list. */
     serversList: boolean;
+    /** The mouse wheel over a tab bar switches tabs rather than scrolling the bar. */
+    tabWheelSwitch: boolean;
+    /** Install plugin and language updates at startup instead of only announcing them. */
+    pluginAutoUpdate: boolean;
     soundOnFire: boolean;
     playerPlacement: "fixed" | "floating";
-    accent: AccentColor;
-    bgPreset: BgPreset;
+    accent: Accent;
+    bgPreset: Background;
+    /** The colours of the "custom" background, each "#rrggbb". Kept when a preset is picked, so
+     *  going back to Custom finds them again. */
+    customTheme?: Partial<Palette>;
+    /** Custom palettes the user saved by name, shown as cards beside the presets. */
+    savedThemes?: {
+        id: string;
+        name: string;
+        palette: Partial<Palette>;
+    }[];
+    /** The saved theme the custom colours came from, which edits are written back to. */
+    savedThemeId?: string;
     density: Density;
+    uiZoom: number;
     termTheme: TermTheme;
+    /** The "custom" terminal theme's colours. Kept when another theme is picked. */
+    termCustom?: Partial<TermCustom>;
     termFont: string;
     termFontSize: number;
     termScrollback: number;
@@ -75,6 +103,12 @@ export interface Settings {
     drawerHidden: string[];
     /** Drawer tabs left-to-right. Ids missing from it keep their discovery order, after the rest. */
     drawerOrder: string[];
+    /** Which side of the footer each drawer tab and readout sits on, in order (core/footerlayout.ts).
+     *  Absent until something is moved: drawer tabs left, readouts right, in the orders above. */
+    footerLayout?: {
+        left: string[];
+        right: string[];
+    };
     httpMcpRevealSecrets: boolean;
     /**
      * What to call the user: shown to the others when sharing (a Canvas board's cursor and the
@@ -134,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 {
@@ -150,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 {
@@ -195,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>;
@@ -222,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[]>;
@@ -237,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. */
@@ -349,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;
@@ -360,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;
@@ -402,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>;
@@ -419,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
@@ -449,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;
@@ -508,23 +482,35 @@ 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.
+ * Deck's MCP server, which lets an agent drive Deck's terminals and HTTP client, registered with
+ * an AI coding agent: "claude", "codex", "gemini" or "cursor". The server ships with Deck as a
+ * single bundled file. Each agent keeps its MCP servers somewhere else (see agentmcp.rs), a file
+ * that belongs to that agent, so Deck backs it up first, merges rather than replaces, and refuses
+ * outright if it cannot parse it. The status is "missing", "current", "stale" (an entry pointing
+ * somewhere else, as a reinstall to another folder leaves) or "no-node" (nothing could run it).
+ */
+export declare const agentMcpStatus: (agent: string) => Promise<string>;
+export declare const installAgentMcp: (agent: string) => Promise<string>;
+/** Deck's hooks for an agent that has them ("claude", "codex"): what the Agents panel and the
+ *  agent notifications hear from. Merged into the agent's own settings, backed up first. */
+export declare const installAgentHooks: (agent: string) => Promise<void>;
+/**
+ * Deck's skills (how to use its MCP tools) for an agent that reads skills: "claude" or "codex".
+ * Each comes back with what happened to it: "installed", "updated", "current", "kept-yours" (a
+ * skill of that name that is not Deck's) or "kept-edited" (Deck's, changed since). Deck only
+ * replaces a skill folder it wrote and nobody has edited.
  */
-export declare const claudeMcpStatus: () => Promise<string>;
-export declare const claudeMcpEntry: () => Promise<string>;
-export declare const installClaudeMcp: () => Promise<string>;
-export declare const removeClaudeMcp: () => Promise<void>;
-export declare const removeClaudeHooks: () => Promise<void>;
+export declare const installAgentSkills: (agent: string) => Promise<{
+    skill: string;
+    outcome: string;
+}[]>;
+/** Which agent command-line tools are on PATH: any of claude, codex, gemini, cursor-agent, cursor. */
+export declare const agentClis: () => Promise<string[]>;
 export declare const notifyOs: (title: string, body: string) => Promise<void>;
+/** Run `git -C <dir> <args>`: its stdout, or what git said as the error. Never prompts for
+ *  credentials. What the Git plugin builds its operations on. */
+export declare const gitRun: (dir: string, args: string[]) => Promise<string>;
 export declare const gitStatus: (dir: string) => Promise<GitStatusRow[]>;
 /** The repos a folder holds: the one it is inside first, then any below it. Each a repo's top level. */
 export declare const gitRepos: (dir: string) => Promise<string[]>;
@@ -536,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>>;
@@ -552,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;
@@ -565,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;
@@ -589,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;
@@ -612,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). */
@@ -651,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;
@@ -760,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/editorsettings.d.ts

@@ -1,5 +1,11 @@
 // GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
 import type * as MonacoNS from "monaco-editor";
+/** What a language may set differently from the editor-wide value. Absent means "as everywhere". */
+export interface LanguageOverride {
+    tabSize?: number;
+    insertSpaces?: boolean;
+    formatOnSave?: boolean;
+}
 export interface EditorSettings {
     fontSize: number;
     fontFamily: string;
@@ -38,9 +44,32 @@ export interface EditorSettings {
     mouseWheelZoom: boolean;
     autoClosingBrackets: boolean;
     autoClosingQuotes: boolean;
+    /** When a file writes itself to disk. Off (the default) means only Ctrl+S saves. */
+    autoSave: "off" | "afterDelay" | "onFocusChange";
     autoSaveDelay: number;
     trimTrailingWhitespace: boolean;
     formatOnSave: boolean;
+    formatOnPaste: boolean;
+    /** Completion: popping up while typing, on a trigger character like ".", and what Enter does. */
+    quickSuggestions: boolean;
+    suggestOnTriggerCharacters: boolean;
+    acceptSuggestionOnEnter: "on" | "smart" | "off";
+    snippetSuggestions: "top" | "bottom" | "inline" | "none";
+    /** Renaming an HTML/JSX tag renames its closing tag as you type. */
+    linkedEditing: boolean;
+    /** Lines kept visible above and below the cursor when it moves near an edge. */
+    cursorSurroundingLines: number;
+    multiCursorModifier: "alt" | "ctrlCmd";
+    /** Copy or cut with nothing selected takes the whole line. */
+    emptySelectionClipboard: boolean;
+    /** The file tree: names or globs to hide (comma-separated), dotfiles, following the open file. */
+    treeHide: string;
+    treeShowDotfiles: boolean;
+    treeFollowActive: boolean;
+    /** The folders above what is in view stay pinned at the top of the tree while it scrolls. */
+    treeStickyScroll: boolean;
+    /** Per-language overrides, keyed by Monaco language id ("python", "typescript"). */
+    languageOverrides: Record<string, LanguageOverride>;
     formatLineLength: number;
     inlineErrors: boolean;
     inlineBlame: boolean;
@@ -66,4 +95,17 @@ export declare function getEditorSettings(): EditorSettings;
 /** For a store outside React that reacts to a setting (lsp.ts re-asks for inlay hints). */
 export declare function subscribeEditorSettings(cb: () => void): () => void;
 export declare function useEditorSettings(): EditorSettings;
+/** A language's own value for each overridable setting, else the editor-wide one. */
+export declare function forLanguage(s: EditorSettings, languageId: string | undefined): {
+    tabSize: number;
+    insertSpaces: boolean;
+    formatOnSave: boolean;
+};
+/** The model options for a file of `languageId`. */
+export declare function modelOptionsFor(s: EditorSettings, languageId: string | undefined): {
+    tabSize: number;
+    insertSpaces: boolean;
+};
+/** Whether the file tree shows an entry, under these settings (core/treehide.ts). */
+export declare const treeShows: (s: EditorSettings, name: string) => boolean;
 export declare function monacoOptionsFrom(s: EditorSettings): MonacoNS.editor.IEditorOptions;