deck-plugin-sdk 0.19.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deck-plugin-sdk",
-  "version": "0.19.0",
+  "version": "0.22.0",
   "description": "Build a plugin for Deck, outside the Deck repository.",
   "type": "module",
   "license": "MIT",

package/shim/bridge.js

@@ -9,9 +9,9 @@ const b = () => {
   return x;
 };
 
-export const askAssistant = (...a) => b().askAssistant(...a);
-export const calendarCached = (...a) => b().calendarCached(...a);
-export const calendarRefresh = (...a) => b().calendarRefresh(...a);
+export const backupExport = (...a) => b().backupExport(...a);
+export const backupInspect = (...a) => b().backupInspect(...a);
+export const backupRestore = (...a) => b().backupRestore(...a);
 export const claudeMcpEntry = (...a) => b().claudeMcpEntry(...a);
 export const claudeMcpStatus = (...a) => b().claudeMcpStatus(...a);
 export const claudePlanLimits = (...a) => b().claudePlanLimits(...a);
@@ -34,6 +34,9 @@ export const fsCopy = (...a) => b().fsCopy(...a);
 export const fsCreateDir = (...a) => b().fsCreateDir(...a);
 export const fsCreateFile = (...a) => b().fsCreateFile(...a);
 export const fsDelete = (...a) => b().fsDelete(...a);
+export const fsFiles = (...a) => b().fsFiles(...a);
+export const fsFind = (...a) => b().fsFind(...a);
+export const fsHash = (...a) => b().fsHash(...a);
 export const fsHomeDir = (...a) => b().fsHomeDir(...a);
 export const fsList = (...a) => b().fsList(...a);
 export const fsMove = (...a) => b().fsMove(...a);
@@ -46,6 +49,8 @@ export const fsReveal = (...a) => b().fsReveal(...a);
 export const fsSaveUnique = (...a) => b().fsSaveUnique(...a);
 export const fsSearch = (...a) => b().fsSearch(...a);
 export const fsSize = (...a) => b().fsSize(...a);
+export const fsThumbnail = (...a) => b().fsThumbnail(...a);
+export const fsTrash = (...a) => b().fsTrash(...a);
 export const fsWrite = (...a) => b().fsWrite(...a);
 export const fsWriteBytes = (...a) => b().fsWriteBytes(...a);
 export const getAutostart = (...a) => b().getAutostart(...a);
@@ -132,14 +137,11 @@ export const installClaudeMcp = (...a) => b().installClaudeMcp(...a);
 export const installFromRegistry = (...a) => b().installFromRegistry(...a);
 export const installPlugin = (...a) => b().installPlugin(...a);
 export const isFullscreen = (...a) => b().isFullscreen(...a);
-export const jiraCached = (...a) => b().jiraCached(...a);
-export const jiraRefresh = (...a) => b().jiraRefresh(...a);
 export const languagesDir = (...a) => b().languagesDir(...a);
 export const launchFiles = (...a) => b().launchFiles(...a);
 export const listApps = (...a) => b().listApps(...a);
 export const listInstalled = (...a) => b().listInstalled(...a);
-export const mailCached = (...a) => b().mailCached(...a);
-export const mailRefresh = (...a) => b().mailRefresh(...a);
+export const mediaMeta = (...a) => b().mediaMeta(...a);
 export const mediaSetNowPlaying = (...a) => b().mediaSetNowPlaying(...a);
 export const mediaSetPlayback = (...a) => b().mediaSetPlayback(...a);
 export const memUsage = (...a) => b().memUsage(...a);
@@ -174,28 +176,27 @@ export const readTermLayout = (...a) => b().readTermLayout(...a);
 export const readTrackMeta = (...a) => b().readTrackMeta(...a);
 export const removeClaudeHooks = (...a) => b().removeClaudeHooks(...a);
 export const removeClaudeMcp = (...a) => b().removeClaudeMcp(...a);
+export const removeLanguage = (...a) => b().removeLanguage(...a);
 export const restartApp = (...a) => b().restartApp(...a);
 export const revealInFolder = (...a) => b().revealInFolder(...a);
 export const runScriptNow = (...a) => b().runScriptNow(...a);
 export const sessionList = (...a) => b().sessionList(...a);
 export const setAutostart = (...a) => b().setAutostart(...a);
+export const setDebugTargets = (...a) => b().setDebugTargets(...a);
 export const setVaultRoot = (...a) => b().setVaultRoot(...a);
 export const setWallpaper = (...a) => b().setWallpaper(...a);
-export const setupChecks = (...a) => b().setupChecks(...a);
-export const slackCached = (...a) => b().slackCached(...a);
-export const slackRefresh = (...a) => b().slackRefresh(...a);
-export const speakWithVoice = (...a) => b().speakWithVoice(...a);
 export const sshTunnelClose = (...a) => b().sshTunnelClose(...a);
 export const sshTunnelList = (...a) => b().sshTunnelList(...a);
 export const sshTunnelOpen = (...a) => b().sshTunnelOpen(...a);
+export const startupMarks = (...a) => b().startupMarks(...a);
 export const startupRead = (...a) => b().startupRead(...a);
 export const startupWrite = (...a) => b().startupWrite(...a);
-export const stopSpeaking = (...a) => b().stopSpeaking(...a);
 export const toggleFullscreen = (...a) => b().toggleFullscreen(...a);
 export const vaultDataRead = (...a) => b().vaultDataRead(...a);
 export const vaultDataWrite = (...a) => b().vaultDataWrite(...a);
 export const vaultRelativize = (...a) => b().vaultRelativize(...a);
 export const vaultResolve = (...a) => b().vaultResolve(...a);
+export const vpsRunsPull = (...a) => b().vpsRunsPull(...a);
 export const watchFiles = (...a) => b().watchFiles(...a);
 export const writeDownloads = (...a) => b().writeDownloads(...a);
 export const writeLibrary = (...a) => b().writeLibrary(...a);

package/types/components/ConfirmDialog.d.ts

@@ -19,4 +19,4 @@ export interface ConfirmState {
 export declare function ConfirmDialog({ state, onClose }: {
     state: ConfirmState | null;
     onClose: () => void;
-}): import("react").JSX.Element;
+}): import("react").ReactPortal;

package/types/core/bridge.d.ts

@@ -1,4 +1,5 @@
 // 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";
 /** Open a URL in the default browser. */
 export declare const openExternal: (url: string) => Promise<void>;
@@ -56,12 +57,6 @@ export interface Settings {
     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;
@@ -81,13 +76,6 @@ export interface Settings {
     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>;
@@ -101,6 +89,16 @@ export interface MemServer {
     mem: number;
     pid: number;
 }
+/** One process behind the figures, largest first. Only filled when memUsage(true) asks. */
+export interface MemProc {
+    pid: number;
+    name: string;
+    cmd: string;
+    mem: number;
+    group: "deck" | "server" | "agent" | "pane-agent" | "pane";
+    /** The language server's session id, or the terminal pane's id. */
+    owner: string;
+}
 export interface MemUsage {
     deck: number;
     agents: number;
@@ -118,8 +116,10 @@ export interface MemUsage {
     /** claude running inside a pane. Also not part of `deck`. */
     pane_agents: number;
     pane_agent_count: number;
+    procs: MemProc[];
 }
-export declare const memUsage: () => Promise<MemUsage>;
+/** `detail` also lists every process with its command line: for the open popover, not the poll. */
+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>;
@@ -144,12 +144,6 @@ 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 {
@@ -251,40 +245,6 @@ export interface MusicSuggestions {
 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. */
@@ -297,28 +257,6 @@ export interface GoogleAccount {
 }
 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;
@@ -361,7 +299,6 @@ export interface AgentSession {
     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;
@@ -422,6 +359,8 @@ export declare const fsList: (dir: string) => Promise<FsEntry[]>;
 export declare const pluginsDir: () => Promise<string>;
 /** `%APPDATA%\Deck\languages` (Deck-Dev in a debug build), created on first call. */
 export declare const languagesDir: () => Promise<string>;
+/** Delete a language definition's folder (by its folder name). The server and debugger it names stay installed. */
+export declare const removeLanguage: (folder: string) => Promise<void>;
 export declare const fsRead: (path: string) => Promise<string>;
 /** Raw bytes, for a file that is not text — fsRead decodes as UTF-8 and would corrupt it. */
 export declare const fsReadBytes: (path: string) => Promise<Uint8Array<ArrayBuffer>>;
@@ -450,6 +389,30 @@ 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>;
+/** Fetch the VPS's Script Runner run log over SSH into the local run-log-vps config (vpsjobs.rs). */
+export declare const vpsRunsPull: () => Promise<void>;
+/** What Rust saw of this launch, as Unix ms: process creation and the setup() span. Null until
+ *  setup() has finished, which is before any page script runs. */
+export interface StartupMarks {
+    process: number;
+    setupStart: number;
+    setupEnd: number;
+}
+export declare const startupMarks: () => Promise<StartupMarks | null>;
+/** What a backup file holds: the Deck that wrote it, when, and how many of each thing. */
+export interface BackupSummary {
+    deck: string;
+    created: string;
+    configs: number;
+    plugins: number;
+    languages: number;
+    notes: number;
+}
+/** Every config, plugin and language to one file, credentials left out (backup.rs). */
+export declare const backupExport: (path: string) => Promise<BackupSummary>;
+export declare const backupInspect: (path: string) => Promise<BackupSummary>;
+/** Writes the backup over this machine's copies. Deck should restart afterwards. */
+export declare const backupRestore: (path: string) => Promise<BackupSummary>;
 /** 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. */
@@ -505,6 +468,8 @@ export declare const procKill: (id: string) => Promise<void>;
 export declare const fsCreateDir: (dir: string, name: string) => Promise<string>;
 export declare const fsRename: (path: string, newName: string) => Promise<string>;
 export declare const fsDelete: (path: string) => Promise<void>;
+/** Move to the Recycle Bin, so it can be restored (fsDelete removes for good). */
+export declare const fsTrash: (path: string) => Promise<void>;
 export declare const fsCopy: (src: string, dstDir: string) => Promise<string>;
 export declare const fsReveal: (path: string) => Promise<void>;
 export declare const installClaudeHooks: () => Promise<void>;
@@ -579,11 +544,13 @@ export interface GraphCommit {
     refs: string[];
 }
 export declare const gitLogGraph: (dir: string, skip: number, rel?: string, refs?: string[]) => Promise<GraphCommit[]>;
+/** `old`: a rename's or copy's path before the commit, which its parent side is read from. */
 export interface CommitFile {
     rel: string;
     letter: string;
     adds: number;
     dels: number;
+    old?: string;
 }
 export declare const gitCommitFiles: (dir: string, hash: string) => Promise<CommitFile[]>;
 export declare const gitShowFile: (dir: string, rev: string, rel: string) => Promise<string>;
@@ -685,6 +652,38 @@ export interface SearchOpts {
     includes: string;
     excludes: string;
 }
+/** Every file under `dir` (absolute paths), .gitignore respected — the editor's Ctrl+P. */
+export declare const fsFiles: (dir: string) => Promise<string[]>;
+/** One file `fsFind` found. `mtime` is milliseconds since the epoch. */
+export interface FoundFile {
+    path: string;
+    size: number;
+    mtime: number;
+}
+/**
+ * Every file with one of `exts` (no dot) under `roots`, or under every fixed drive when roots is
+ * null, skipping folders named in `excludeDirs` at any depth and files under `minSize` bytes.
+ * A walk of whole drives takes on the order of a minute.
+ */
+export declare const fsFind: (roots: string[] | null, exts: string[], excludeDirs: string[], minSize: number) => Promise<FoundFile[]>;
+/** Windows' own thumbnail of a file (what Explorer shows), as PNG bytes fitting `size` x `size`.
+ *  Rejects when Windows has none for it. */
+/** What Windows knows about a photo or video (its Properties' Details tab). Absent fields are null. */
+export interface MediaMeta {
+    /** Date taken or recorded, ms since the epoch. */
+    taken: number | null;
+    width: number | null;
+    height: number | null;
+    camera: string | null;
+    lat: number | null;
+    lon: number | null;
+    duration_ms: number | null;
+}
+/** The properties of each path, in order; one that cannot be read comes back all null. */
+export declare const mediaMeta: (paths: string[]) => Promise<MediaMeta[]>;
+/** SHA-256 of each file's contents, in order; null for one that cannot be read. */
+export declare const fsHash: (paths: string[]) => Promise<(string | null)[]>;
+export declare const fsThumbnail: (path: string, size: number) => Promise<Uint8Array<ArrayBuffer>>;
 export declare const fsSearch: (dir: string, query: string, o: SearchOpts) => Promise<SearchHit[]>;
 export declare const fsReplace: (dir: string, query: string, replacement: string, o: SearchOpts, files?: string[], line?: number) => Promise<number>;
 export interface DbQueryResult {
@@ -726,3 +725,11 @@ export declare const dbSchema: (handle: number) => Promise<DbSchema>;
 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
+ * the plugin's whole current list each time, under its own `source`; an empty list removes it.
+ * See core/debugtargets.ts.
+ */
+export declare const setDebugTargets: (source: string, targets: DebugTarget[]) => void;
+export type { DebugTarget } from "./debugtargets";

package/types/core/debugtargets.d.ts

@@ -0,0 +1,38 @@
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+export interface DebugTarget {
+    /** Unique within its source. */
+    id: string;
+    /** What the panel shows: "Attach to netapp (Windows)". */
+    name: string;
+    /** The language whose debug adapter runs it (its language.json `debug` block). */
+    languageId: string;
+    request: "attach" | "launch";
+    /** The adapter's attach or launch arguments, e.g. `{ vmServiceUri }`. */
+    args: Record<string, unknown>;
+    /** Where the program's source is: the adapter's working directory. */
+    cwd: string;
+    /**
+     * The adapter to use when the language's definition names none (a language.json without a
+     * `debug` block). The publisher knows what it runs; Deck does not hardcode any language.
+     */
+    adapter?: {
+        strategy: string;
+        command?: string;
+        module?: string;
+        args?: string[];
+    };
+}
+/**
+ * A language's launch template with the editor's variables filled in, the names VS Code uses in
+ * launch.json: `${file}`, `${fileDirname}`, `${fileBasename}`, `${workspaceFolder}`. Every string
+ * in the template, at any depth; anything else is kept as it is. An unknown variable is left in
+ * place, so a typo shows in what the adapter is sent rather than silently becoming empty.
+ */
+export declare function fillLaunch(template: unknown, vars: {
+    file: string;
+    workspaceFolder: string;
+}): unknown;
+/** Replace one source's targets (an empty list removes them). */
+export declare function setTargets(source: string, targets: DebugTarget[]): void;
+export declare const getTargets: () => DebugTarget[];
+export declare const subscribeTargets: (fn: () => void) => () => void;

package/types/core/editorsettings.d.ts

@@ -17,6 +17,8 @@ export interface EditorSettings {
     indentGuides: boolean;
     bracketPairColorization: boolean;
     stickyScroll: boolean;
+    /** Greyed-out types and parameter names the language server suggests, drawn inline. */
+    inlayHints: "all" | "types" | "parameters" | "off";
     /**
      * Markdown: float the formatting bar over the selection instead of pinning it above the note.
      *
@@ -61,5 +63,7 @@ export declare const GRAPH_FONT_SIZES: number[];
 export declare const DEFAULT_EDITOR_SETTINGS: EditorSettings;
 export declare function updateEditorSettings(patch: Partial<EditorSettings>): void;
 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;
 export declare function monacoOptionsFrom(s: EditorSettings): MonacoNS.editor.IEditorOptions;

package/types/core/monaco.d.ts

@@ -26,6 +26,8 @@ export declare function addSemanticColors(rules: TokenColor[]): void;
  * built-in one rather than silently losing to it.
  */
 export declare function registerExtension(ext: string, languageId: string): void;
+/** Give up every extension a language claimed: its definition was removed. */
+export declare function forgetExtensions(languageId: string): void;
 /**
  * Map a filename to a Monaco language id.
  *

package/types/core/settingsstore.d.ts

@@ -13,7 +13,4 @@ export declare function publishSettings(s: Settings): void;
 export declare function saveSettings(next: Settings): void;
 /** Current settings for non-React callers (the palette's providers). */
 export declare const getSettings: () => Settings;
-/** The OS account name — the home directory's last segment. "" if it can't be read. */
-export declare function osAccountName(): Promise<string>;
-export declare function userName(): Promise<string>;
 export declare function useSettings(): Settings;

package/types/core/terminals.d.ts

@@ -225,7 +225,9 @@ export declare function moveLeaf(root: LayoutNode, srcId: string, targetId: stri
  * caller wants to type into the pane it just made. Pair it with queueInput: the pane has no PTY
  * until it is attached to a sized element, so anything written before then is dropped.
  */
-export declare function openTabInWorkspace(wsId: string, title: string): string | null;
+export declare function openTabInWorkspace(wsId: string, title: string, opts?: {
+    besideActive?: boolean;
+}): string | null;
 export declare function applyDtCommand(op: string, args: Record<string, unknown>): string | void;
 interface Instance {
     term: Terminal;