deck-plugin-sdk 1.8.0 → 1.10.0

package/shim/terminals.js

@@ -1,97 +1,106 @@
-// GENERATED by sdk/gen-shim.mjs — do not edit.
-//
-// Deck's terminal panes. Resolved at USE time like the bridge: a plugin module is evaluated
-// during loadPlugins, and a reference copied out at import time would capture a half-built
-// object. The layout store is shared, not copied — a second one would not know about the panes
-// Deck already has open.
-import { pluginId } from "./scope.js";
-const t = () => {
-  const x = window.__deck?.forPlugin?.(pluginId)?.terminals ?? window.__deck?.terminals;
-  if (!x) throw new Error("window.__deck.terminals is missing — this plugin only runs inside Deck");
-  return x;
-};
-
-export const GROUP_COLORS = (...a) => t().GROUP_COLORS(...a);
-export const ZONE_BOARD = (...a) => t().ZONE_BOARD(...a);
-export const activeWorkspaceCwd = (...a) => t().activeWorkspaceCwd(...a);
-export const addTabToZone = (...a) => t().addTabToZone(...a);
-export const addToGroup = (...a) => t().addToGroup(...a);
-export const applyDtCommand = (...a) => t().applyDtCommand(...a);
-export const applyTerminalLook = (...a) => t().applyTerminalLook(...a);
-export const attach = (...a) => t().attach(...a);
-export const bracketPaste = (...a) => t().bracketPaste(...a);
-export const clearPane = (...a) => t().clearPane(...a);
-export const closeLeaf = (...a) => t().closeLeaf(...a);
-export const copyFrom = (...a) => t().copyFrom(...a);
-export const destroy = (...a) => t().destroy(...a);
-export const findLeaf = (...a) => t().findLeaf(...a);
-export const focusPane = (...a) => t().focusPane(...a);
-export const getInstance = (...a) => t().getInstance(...a);
-export const getLayout = (...a) => t().getLayout(...a);
-export const hasSelection = (...a) => t().hasSelection(...a);
-export const insertBeside = (...a) => t().insertBeside(...a);
-export const isPinned = (...a) => t().isPinned(...a);
-export const isWorkspaceActive = (...a) => t().isWorkspaceActive(...a);
-export const leafIds = (...a) => t().leafIds(...a);
-export const leaveGroup = (...a) => t().leaveGroup(...a);
-export const loadLayoutOnce = (...a) => t().loadLayoutOnce(...a);
-export const markAgentStarted = (...a) => t().markAgentStarted(...a);
-export const moveGroup = (...a) => t().moveGroup(...a);
-export const moveLeaf = (...a) => t().moveLeaf(...a);
-export const moveTabToZone = (...a) => t().moveTabToZone(...a);
-export const moveWorkspace = (...a) => t().moveWorkspace(...a);
-export const moveZone = (...a) => t().moveZone(...a);
-export const mutateLayout = (...a) => t().mutateLayout(...a);
-export const nextActiveAfterClose = (...a) => t().nextActiveAfterClose(...a);
-export const nextZoneSpot = (...a) => t().nextZoneSpot(...a);
-export const openActiveGroup = (...a) => t().openActiveGroup(...a);
-export const openFile = (...a) => t().openFile(...a);
-export const openInEditor = (...a) => t().openInEditor(...a);
-export const openTabInWorkspace = (...a) => t().openTabInWorkspace(...a);
-export const paneCwd = (...a) => t().paneCwd(...a);
-export const paneHasAgent = (...a) => t().paneHasAgent(...a);
-export const paneLabel = (...a) => t().paneLabel(...a);
-export const paneLines = (...a) => t().paneLines(...a);
-export const paneLocation = (...a) => t().paneLocation(...a);
-export const pasteInto = (...a) => t().pasteInto(...a);
-export const pasteText = (...a) => t().pasteText(...a);
-export const pasteTextInto = (...a) => t().pasteTextInto(...a);
-export const pruneGroups = (...a) => t().pruneGroups(...a);
-export const publishLayout = (...a) => t().publishLayout(...a);
-export const queueInput = (...a) => t().queueInput(...a);
-export const refit = (...a) => t().refit(...a);
-export const reorderTab = (...a) => t().reorderTab(...a);
-export const resetPaneModes = (...a) => t().resetPaneModes(...a);
-export const restartPane = (...a) => t().restartPane(...a);
-export const revealPane = (...a) => t().revealPane(...a);
-export const runsLines = (...a) => t().runsLines(...a);
-export const sendInput = (...a) => t().sendInput(...a);
-export const setGroup = (...a) => t().setGroup(...a);
-export const setLeafLabel = (...a) => t().setLeafLabel(...a);
-export const setLeafView = (...a) => t().setLeafView(...a);
-export const showActiveTab = (...a) => t().showActiveTab(...a);
-export const splitLeaf = (...a) => t().splitLeaf(...a);
-export const stopPaneAgent = (...a) => t().stopPaneAgent(...a);
-export const suspendWorkspace = (...a) => t().suspendWorkspace(...a);
-export const switchWorkspace = (...a) => t().switchWorkspace(...a);
-export const termKill = (...a) => t().termKill(...a);
-export const termList = (...a) => t().termList(...a);
-export const termResize = (...a) => t().termResize(...a);
-export const termScrollback = (...a) => t().termScrollback(...a);
-export const termSpawn = (...a) => t().termSpawn(...a);
-export const termSweepScrollback = (...a) => t().termSweepScrollback(...a);
-export const termWrite = (...a) => t().termWrite(...a);
-export const toggleGroupFold = (...a) => t().toggleGroupFold(...a);
-export const togglePin = (...a) => t().togglePin(...a);
-export const ungroup = (...a) => t().ungroup(...a);
-export const useAgentPanesVersion = (...a) => t().useAgentPanesVersion(...a);
-export const useLayout = (...a) => t().useLayout(...a);
-export const usePinnedPanes = (...a) => t().usePinnedPanes(...a);
-export const webglLimit = (...a) => t().webglLimit(...a);
-export const workspaceByCwd = (...a) => t().workspaceByCwd(...a);
-export const workspaceShellCount = (...a) => t().workspaceShellCount(...a);
-export const zoneAt = (...a) => t().zoneAt(...a);
-export const zoneBoardFull = (...a) => t().zoneBoardFull(...a);
-export const zoneOf = (...a) => t().zoneOf(...a);
-export const zoneToward = (...a) => t().zoneToward(...a);
-export const zones = (...a) => t().zones(...a);
+// GENERATED by sdk/gen-shim.mjs — do not edit.
+//
+// Deck's terminal panes. Resolved at USE time like the bridge: a plugin module is evaluated
+// during loadPlugins, and a reference copied out at import time would capture a half-built
+// object. The layout store is shared, not copied — a second one would not know about the panes
+// Deck already has open.
+import { pluginId } from "./scope.js";
+const t = () => {
+  const x = window.__deck?.forPlugin?.(pluginId)?.terminals ?? window.__deck?.terminals;
+  if (!x) throw new Error("window.__deck.terminals is missing — this plugin only runs inside Deck");
+  return x;
+};
+
+export const GROUP_COLORS = (...a) => t().GROUP_COLORS(...a);
+export const ZONE_BOARD = (...a) => t().ZONE_BOARD(...a);
+export const activeWorkspaceCwd = (...a) => t().activeWorkspaceCwd(...a);
+export const addTabToZone = (...a) => t().addTabToZone(...a);
+export const addToGroup = (...a) => t().addToGroup(...a);
+export const agentSessions = (...a) => t().agentSessions(...a);
+export const applyDtCommand = (...a) => t().applyDtCommand(...a);
+export const applyTerminalLook = (...a) => t().applyTerminalLook(...a);
+export const attach = (...a) => t().attach(...a);
+export const bracketPaste = (...a) => t().bracketPaste(...a);
+export const clearPane = (...a) => t().clearPane(...a);
+export const closeLeaf = (...a) => t().closeLeaf(...a);
+export const closePaneTab = (...a) => t().closePaneTab(...a);
+export const copyFrom = (...a) => t().copyFrom(...a);
+export const destroy = (...a) => t().destroy(...a);
+export const dockWindow = (...a) => t().dockWindow(...a);
+export const findLeaf = (...a) => t().findLeaf(...a);
+export const focusPane = (...a) => t().focusPane(...a);
+export const getInstance = (...a) => t().getInstance(...a);
+export const getLayout = (...a) => t().getLayout(...a);
+export const hasSelection = (...a) => t().hasSelection(...a);
+export const insertBeside = (...a) => t().insertBeside(...a);
+export const isPinned = (...a) => t().isPinned(...a);
+export const isWorkspaceActive = (...a) => t().isWorkspaceActive(...a);
+export const leafIds = (...a) => t().leafIds(...a);
+export const leaveGroup = (...a) => t().leaveGroup(...a);
+export const loadLayoutOnce = (...a) => t().loadLayoutOnce(...a);
+export const markAgentStarted = (...a) => t().markAgentStarted(...a);
+export const mergeWindow = (...a) => t().mergeWindow(...a);
+export const moveGroup = (...a) => t().moveGroup(...a);
+export const moveLeaf = (...a) => t().moveLeaf(...a);
+export const moveTabToZone = (...a) => t().moveTabToZone(...a);
+export const moveWorkspace = (...a) => t().moveWorkspace(...a);
+export const moveZone = (...a) => t().moveZone(...a);
+export const mutateLayout = (...a) => t().mutateLayout(...a);
+export const nextActiveAfterClose = (...a) => t().nextActiveAfterClose(...a);
+export const nextZoneSpot = (...a) => t().nextZoneSpot(...a);
+export const openActiveGroup = (...a) => t().openActiveGroup(...a);
+export const openFile = (...a) => t().openFile(...a);
+export const openInEditor = (...a) => t().openInEditor(...a);
+export const openTabInWorkspace = (...a) => t().openTabInWorkspace(...a);
+export const paneCwd = (...a) => t().paneCwd(...a);
+export const paneHasAgent = (...a) => t().paneHasAgent(...a);
+export const paneLabel = (...a) => t().paneLabel(...a);
+export const paneLines = (...a) => t().paneLines(...a);
+export const paneLocation = (...a) => t().paneLocation(...a);
+export const pasteInto = (...a) => t().pasteInto(...a);
+export const pasteText = (...a) => t().pasteText(...a);
+export const pasteTextInto = (...a) => t().pasteTextInto(...a);
+export const pruneGroups = (...a) => t().pruneGroups(...a);
+export const publishLayout = (...a) => t().publishLayout(...a);
+export const queueInput = (...a) => t().queueInput(...a);
+export const rebindTerminals = (...a) => t().rebindTerminals(...a);
+export const refit = (...a) => t().refit(...a);
+export const reopenTab = (...a) => t().reopenTab(...a);
+export const reorderTab = (...a) => t().reorderTab(...a);
+export const resetPaneModes = (...a) => t().resetPaneModes(...a);
+export const restartPane = (...a) => t().restartPane(...a);
+export const resumeCommand = (...a) => t().resumeCommand(...a);
+export const revealPane = (...a) => t().revealPane(...a);
+export const runningIn = (...a) => t().runningIn(...a);
+export const runsLines = (...a) => t().runsLines(...a);
+export const sendInput = (...a) => t().sendInput(...a);
+export const setGroup = (...a) => t().setGroup(...a);
+export const setLeafLabel = (...a) => t().setLeafLabel(...a);
+export const setLeafView = (...a) => t().setLeafView(...a);
+export const setTabWindow = (...a) => t().setTabWindow(...a);
+export const showActiveTab = (...a) => t().showActiveTab(...a);
+export const splitLeaf = (...a) => t().splitLeaf(...a);
+export const stopPaneAgent = (...a) => t().stopPaneAgent(...a);
+export const suspendWorkspace = (...a) => t().suspendWorkspace(...a);
+export const switchWorkspace = (...a) => t().switchWorkspace(...a);
+export const termKill = (...a) => t().termKill(...a);
+export const termList = (...a) => t().termList(...a);
+export const termResize = (...a) => t().termResize(...a);
+export const termScrollback = (...a) => t().termScrollback(...a);
+export const termSpawn = (...a) => t().termSpawn(...a);
+export const termSweepScrollback = (...a) => t().termSweepScrollback(...a);
+export const termWrite = (...a) => t().termWrite(...a);
+export const toggleGroupFold = (...a) => t().toggleGroupFold(...a);
+export const togglePin = (...a) => t().togglePin(...a);
+export const ungroup = (...a) => t().ungroup(...a);
+export const useAgentPanesVersion = (...a) => t().useAgentPanesVersion(...a);
+export const useLayout = (...a) => t().useLayout(...a);
+export const usePinnedPanes = (...a) => t().usePinnedPanes(...a);
+export const webglLimit = (...a) => t().webglLimit(...a);
+export const workspaceByCwd = (...a) => t().workspaceByCwd(...a);
+export const workspaceShellCount = (...a) => t().workspaceShellCount(...a);
+export const zoneAt = (...a) => t().zoneAt(...a);
+export const zoneBoardFull = (...a) => t().zoneBoardFull(...a);
+export const zoneOf = (...a) => t().zoneOf(...a);
+export const zoneToward = (...a) => t().zoneToward(...a);
+export const zones = (...a) => t().zones(...a);

package/template/plugin.json

@@ -1,10 +1,10 @@
-{
-  "id": "__ID__",
-  "name": "__NAME__",
-  "description": "One line on what this is for, shown under its name in Settings.",
-  "icon": "Sparkles",
-  "color": "#a78bfa",
-  "version": "0.1.0",
-  "minDeck": "1.8.0",
-  "permissions": []
-}
+{
+  "id": "__ID__",
+  "name": "__NAME__",
+  "description": "One line on what this is for, shown under its name in Settings.",
+  "icon": "Sparkles",
+  "color": "#a78bfa",
+  "version": "0.1.0",
+  "minDeck": "1.10.0",
+  "permissions": []
+}

package/types/components/ConfirmDialog.d.ts

@@ -14,9 +14,11 @@ export interface ConfirmState {
      *  which in a webview is an OS modal — it steals focus, hides the cursor, and cannot be
      *  styled or dismissed with Escape. */
     acknowledge?: boolean;
+    /** A "Don't ask again" box beside the buttons: called, after onConfirm, when it was ticked. */
+    onDontAsk?: () => void;
     onConfirm: () => void;
 }
 export declare function ConfirmDialog({ state, onClose }: {
     state: ConfirmState | null;
     onClose: () => void;
-}): import("react").ReactPortal;
+}): import("react").ReactNode;

package/types/components/ContextMenu.d.ts

@@ -43,4 +43,4 @@ export declare function ContextMenu({ x, y, items, alignRight, onClose, onReorde
     up?: boolean;
     /** Called with (draggedId, newIndexAmongDraggableRows) after a drag-sort. */
     onReorder?: (id: string, toIndex: number) => void;
-}): import("react").ReactPortal;
+}): import("react").ReactNode;

package/types/components/NamePrompt.d.ts

@@ -13,4 +13,4 @@ export interface NamePromptState {
 export declare function NamePrompt({ state, onClose }: {
     state: NamePromptState | null;
     onClose: () => void;
-}): import("react").JSX.Element;
+}): import("react").ReactNode;

package/types/components/dragrow.d.ts

@@ -10,8 +10,8 @@ export interface DropTarget {
     parentId: string | null;
     kind: string | null;
 }
-/** The row under a point, or null. Exported for the check. */
-export declare function rowAt(x: number, y: number): DropTarget | null;
+/** The row under a point of `doc` (the window the drag is in), or null. Exported for the check. */
+export declare function rowAt(x: number, y: number, doc?: Document): DropTarget | null;
 export interface DragState {
     /** Id of the row being dragged, or null when idle. */
     dragId: string | null;

package/types/components/ui.d.ts

@@ -33,8 +33,10 @@ export declare function GhostButton({ children, ...p }: React.ButtonHTMLAttribut
  * segmented controls sharing one animate the pill between them — pass a distinct id wherever a
  * screen draws more than one (a per-row control, say). The default keeps the single-control case
  * a one-liner.
+ *
+ * `fill`: as wide as its parent, the options sharing the room, so a column of them lines up.
  */
-export declare function Segmented<T extends string>({ value, onChange, options, layoutId, }: {
+export declare function Segmented<T extends string>({ value, onChange, options, layoutId, fill, }: {
     value: T;
     onChange: (v: T) => void;
     options: {
@@ -42,6 +44,7 @@ export declare function Segmented<T extends string>({ value, onChange, options,
         label: string;
     }[];
     layoutId?: string;
+    fill?: boolean;
 }): import("react").JSX.Element;
 /** Underlined tabs. `layoutId` behaves as in Segmented above. */
 export declare function Tabs<T extends string>({ value, onChange, options, layoutId, }: {

package/types/core/bridge.d.ts

@@ -13,9 +13,9 @@ export interface PhysRect {
 }
 /** Open `url` in the browser pane's own webview (created the first time) at `r`. A private one
  *  keeps no cookies, history or cache. */
-export declare const browserOpen: (pane: string, url: string, isPrivate: boolean, r: PhysRect) => Promise<void>;
+export declare const browserOpen: (pane: string, url: string, isPrivate: boolean, r: PhysRect, window?: string) => Promise<void>;
 /** Move the pane's webview, or hide it. */
-export declare const browserBounds: (pane: string, r: PhysRect, visible: boolean) => Promise<void>;
+export declare const browserBounds: (pane: string, r: PhysRect, visible: boolean, window?: string) => Promise<void>;
 export declare const browserNav: (pane: string, action: "back" | "forward" | "reload" | "go" | "focus", url?: string) => Promise<void>;
 /** The chords Rust takes from a focused page: `deck` moves the keyboard back to Deck, `page` does not. */
 export declare const browserSetKeys: (deck: string[], page: string[]) => Promise<void>;
@@ -37,7 +37,7 @@ export declare const browserNotificationClicked: (pane: string, id: number) => P
 /** Reload a page whose process hangs: that process is ended first. */
 export declare const browserReloadHung: (pane: string) => Promise<void>;
 /** The window fullscreen for a page that went fullscreen, or back as it was. */
-export declare const browserWindowFullscreen: (on: boolean) => Promise<void>;
+export declare const browserWindowFullscreen: (on: boolean, window?: string) => Promise<void>;
 /** Put a hidden pane's page to sleep, or wake it. */
 export declare const browserSleep: (pane: string, on: boolean) => Promise<void>;
 /** A JPEG of what the pane's webview shows. */
@@ -172,7 +172,7 @@ export declare const extensionRemove: (id: string) => Promise<void>;
 export declare const extensionPopup: (pane: string, id: string, page: string, right: number, top: number) => Promise<void>;
 export declare const extensionPopupClose: (pane: string) => Promise<void>;
 /** The sites agents may use in the browser without asking. */
-export declare const browserAgentConfig: (sites: string[]) => Promise<void>;
+export declare const browserAgentConfig: (sites: string[], any?: boolean) => Promise<void>;
 /** The user's answer to an agent's question about a site. */
 export declare const browserAgentAnswer: (id: number, site: string, allow: boolean, forGood: boolean) => Promise<void>;
 /** A DevTools protocol call on a browser pane's page, and its answer. */
@@ -208,6 +208,8 @@ export declare const browserDownload: (id: number, action: "pause" | "resume" |
 /** Find in the pane's page: start a search, step through its matches, or stop (clearing them). */
 export declare const browserFind: (pane: string, action: "start" | "next" | "prev" | "stop", term?: string, matchCase?: boolean) => Promise<void>;
 export declare const browserCapture: (pane: string) => Promise<ArrayBuffer>;
+/** Cut these boxes, each [x, y, w, h, corner radius] in physical px from the page's corner, out of a pane's page window, `w`×`h` its size; none gives it back whole. */
+export declare const browserCut: (pane: string, w: number, h: number, cuts: number[][]) => Promise<void>;
 export interface AppProc {
     name: string;
     title: string;
@@ -263,10 +265,56 @@ export interface Settings {
     tabWheelSwitch: boolean;
     /** When the tabs do not fit, every one but the open tab shrinks to its icon. */
     tabSqueeze?: boolean;
+    /** A title-bar tab's full width in px (120 to 320, 160 when unset): its width, or with tabSqueeze the most it narrows from. */
+    tabWidth?: number;
+    /**
+     * Where things that arrive from outside open (Settings → Where things open). A floating window
+     * leaves the main window's tab as it was; a tab takes its place, as before floating windows.
+     * - openLinksIn: a link another program opens with Deck as the default browser ("float" unset).
+     * - openAgentPagesIn: a page an agent opens ("float-background" unset).
+     * - openFilesIn: a file opened with Deck from Explorer that opens in a plugin or the browser
+     *   ("float" unset); one for the Editor goes to the Editor either way.
+     */
+    openLinksIn?: "float" | "float-background" | "tab";
+    openAgentPagesIn?: "float-background" | "tab";
+    openFilesIn?: "float" | "tab";
+    /**
+     * A file for the Editor opened with Deck from Explorer ("tab" unset: the project's Editor, in the
+     * main window brought forward). "float": an Editor of its own in a floating window, as a file
+     * Ctrl+clicked in a terminal can open.
+     */
+    openCodeFilesIn?: "tab" | "float";
+    /**
+     * More of the same, for what you open yourself but only look at (Settings → Where things open):
+     * - openTerminalLinksIn: an address Ctrl+clicked in a terminal, with browserTerminalLinks "deck"
+     *   ("float" unset: the "links" window).
+     * - openDocsIn: a Docs page opened from Settings ("float" unset; Settings stays open).
+     * - openCommitsIn: a commit opened from the Editor's blame ("float" unset).
+     * - agentTerminals: a terminal tab or project an agent makes ("background" unset: added without
+     *   switching to it, its shell started anyway so the agent can use it; "switch" goes to it).
+     */
+    openTerminalLinksIn?: "float" | "tab";
+    /**
+     * A file path Ctrl+clicked in a terminal ("tab" unset: the Editor's tab, or the tab its type
+     * opens in). "float": an Editor of its own in a floating window, the project's left where it is;
+     * a type that opens elsewhere (a .pdf) in the "links" window.
+     */
+    openTerminalFilesIn?: "tab" | "float";
+    /** The same, per extension (".md"), over `openTerminalFilesIn`. */
+    openTerminalFilesByExt?: Record<string, "tab" | "float">;
+    openDocsIn?: "float" | "tab";
+    openCommitsIn?: "float" | "tab";
+    agentTerminals?: "background" | "switch";
     /** Each project's own colour on the sidebar's collapsed rail. Off, they are all one grey. */
     projectColours?: boolean;
     /** Agents listed under their workspace in the sidebar: under every one (default), only the open one, or none. */
     sidebarAgents?: "all" | "open" | "off";
+    /**
+     * Closing a tab, a group's tabs or a terminal pane (or restarting or replacing one) asks first:
+     * only when something is running in it besides the shell ("running", unset), every time, or
+     * never ("Don't ask again" in the question sets this).
+     */
+    askBeforeClose?: "running" | "always" | "never";
     /** The workspace sidebar is a button in the title bar that opens it over the panes, rather than a column. */
     sidebarMenu?: boolean;
     /** Pane controls float over the pane's top-right corner on hover, instead of a header row. */
@@ -381,6 +429,11 @@ export interface Settings {
     /** Sleeping tabs: a browser tab out of sight this many minutes stops running until it is shown. */
     browserSleep: boolean;
     browserSleepAfter: number;
+    /**
+     * A page stays live under Deck's menus and cards, which are cut out of its window (unset: on).
+     * Off, a covered page is a blurred picture of itself, for a machine where the cut does not show.
+     */
+    browserLiveCovers?: boolean;
     /** Whether pages are asked for light or dark to match Deck's theme ("deck") or Windows'. */
     browserPageTheme?: "deck" | "windows";
     /** App links opened without asking, as "<site origin> <scheme>" ("https://zoom.us zoommtg"). */
@@ -389,6 +442,8 @@ export interface Settings {
     browserDefaultAsk?: boolean;
     /** Sites (by host) an agent may use in the browser without asking; localhost and files always. */
     browserAgentSites: string[];
+    /** Agents may use any site without being asked (signing in still asks). Off by default. */
+    browserAgentAnySite: boolean;
     /**
      * Where a file type opens, by extension (".pdf"): "editor", "browser" or "plugin:<id>". A type
      * not listed is Automatic (see `openerFor` in fileview.ts).
@@ -407,7 +462,12 @@ export declare const remoteSudoPassword: (host: string, password: string) => Pro
 /** Ask for the sudo password of `host` (SudoPasswordPrompt, mounted in App). True once it has
  *  been accepted, false if the prompt was cancelled. */
 export declare function askSudoPassword(host: string): Promise<boolean>;
-export declare const watchFiles: (paths: string[]) => Promise<void>;
+/**
+ * Watch `paths` for changes made outside Deck (`fs-changed` events, a path each). `owner` names
+ * the caller: each owner sets only its own list and the watcher follows every owner's together, so
+ * one caller cannot replace or end another's watch. An empty list takes the owner out.
+ */
+export declare const watchFiles: (paths: string[], owner?: string) => Promise<void>;
 /** RAM in bytes: Deck and its WebView2 children, plus every claude.exe. */
 export interface MemServer {
     id: string;

package/types/core/browser.d.ts

@@ -136,10 +136,22 @@ export declare const takeWaitingUrl: () => {
 } | undefined;
 /** A new browser tab, on `url` or on the start page. */
 export declare const newBrowserTab: (url?: string, isPrivate?: boolean) => boolean | void;
+/**
+ * A browser tab on `url` in a floating window, so the main window's view stays (Terminals'
+ * deck-open-float, core/floatwin.ts openInFloat): `name` the window that collects them ("links"
+ * from other programs, "agent" for an agent's pages), `beside` the window a pane is in.
+ */
+export declare function browserInFloat(url: string, where: {
+    name?: string;
+    beside?: string;
+    focus?: boolean;
+}, isPrivate?: boolean): void;
 /** Read once, before the first browser pane asks. */
 export declare const loadPanes: () => Promise<void>;
 /** The page a pane was on when Deck last closed. */
 export declare const savedPage: (pane: string) => string | undefined;
+/** The page a pane should open on, as a restarted Deck reopens one: a closed tab reopened. */
+export declare function seedPage(pane: string, url: string): void;
 /** How Ctrl+Shift+B shows or hides the bookmarks bar: set by the browser pane, which holds the settings. */
 export declare const setBarToggle: (f: () => void) => void;
 /** Bookmark the pane's page, as its star does: Ctrl+D, and the browser menu. */
@@ -217,6 +229,8 @@ export declare function noteTermOutput(pane: string, chunk: string): void;
 export declare function forgetTermPane(pane: string): void;
 /** Where a pane's page is on screen, in Deck's CSS pixels, while it shows one. */
 export declare const pageBox: (pane: string) => DOMRect | null;
+/** The Deck window a pane's page is drawn in: the main one, or a floating tab window's. */
+export declare const paneWindow: (pane: string) => Window;
 /** Close the pane's webview to give back its memory, keeping the tab and its address. */
 export declare function discardBrowserPane(pane: string): Promise<void>;
 export declare function trackBrowser(pane: string, el: HTMLElement, url: string): () => void;

package/types/core/fileview.d.ts

@@ -52,7 +52,7 @@ export declare const fileUrl: (path: string) => string;
  * Open `path` where its type opens (`openerFor`), as a tab of its own. False when that is the
  * Editor, which the caller opens it in. Every way Deck opens a file asks this first.
  */
-export declare function openByType(path: string, hint?: Opener): boolean;
+export declare function openByType(path: string, hint?: Opener, float?: string): boolean;
 /**
  * Everywhere `path` can open in Deck, for an Open with menu: the Editor, the browser (its types,
  * on this PC), and each plugin that opens its type, named for the menu.
@@ -65,4 +65,8 @@ export declare function openersFor(path: string): {
  * Open `path` in `to` whatever the Files tab says, for an Open with menu. False for the Editor,
  * which the caller opens it in (terminals' openInEditor).
  */
-export declare function openIn(path: string, to: Opener): boolean;
+/**
+ * `float`: in the floating window of that name (Terminals' deck-open-float) rather than as a tab
+ * of the main window, for a file another program handed Deck.
+ */
+export declare function openIn(path: string, to: Opener, float?: string): boolean;

package/types/core/notifications.d.ts

@@ -26,6 +26,8 @@ export interface Notif {
     key?: string;
     /** The workspace an agent notification is about: a click goes there. */
     wsId?: string;
+    /** The agent's pane: a click goes to it (its tab, and its window if that is a float), else wsId. */
+    pane?: string;
     /** Where a click on the card itself goes, when it is not about a workspace. */
     nav?: string;
     /** Who posted it, shown beside the time: a plugin's name. */