deck-plugin-sdk 1.9.0 → 1.10.0

package/package.json

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

package/permissions.json

@@ -1,230 +1,231 @@
-{
-  "generated": "by sdk/gen-permissions.mjs from src/core/permissions.ts; do not edit",
-  "permissions": {
-    "files": "Read and change files anywhere on this PC",
-    "processes": "Run programs and commands",
-    "git": "Read and change git repositories, and push",
-    "network": "Connect to servers: web requests, SSH, databases and other Decks",
-    "terminals": "Use your terminals and the AI agents running in them",
-    "browser": "Control Deck's browser and the pages open in it",
-    "secrets": "Use your saved passwords, your Google account and sudo passwords",
-    "system": "Change this PC's apps, startup programs, wallpaper and running processes",
-    "deck": "Change Deck itself: its settings, backups, plugins and languages"
-  },
-  "bridge": {
-    "adblockConfig": "browser",
-    "adblockInfo": "browser",
-    "adblockRebuild": "browser",
-    "adblockUpdate": "browser",
-    "agentClis": "terminals",
-    "agentMcpStatus": "terminals",
-    "agentStop": "terminals",
-    "askSudoPassword": "secrets",
-    "backupExport": "deck",
-    "backupInspect": "deck",
-    "backupRestore": "deck",
-    "bookmarksBarMode": "browser",
-    "browserAgentAnswer": "browser",
-    "browserAgentConfig": "browser",
-    "browserAgentFillAnswer": "browser",
-    "browserBounds": "browser",
-    "browserCapture": "browser",
-    "browserCdp": "browser",
-    "browserClear": "browser",
-    "browserClose": "browser",
-    "browserDefaultRegister": "browser",
-    "browserDefaultStatus": "browser",
-    "browserDevtools": "browser",
-    "browserDownload": "browser",
-    "browserFind": "browser",
-    "browserHistoryCount": "browser",
-    "browserHistoryForgetRange": "browser",
-    "browserHistoryForgetUrl": "browser",
-    "browserHistoryList": "browser",
-    "browserHistoryRecent": "browser",
-    "browserHistorySuggest": "browser",
-    "browserHistoryVisit": "browser",
-    "browserMute": "browser",
-    "browserNav": "browser",
-    "browserNotificationClicked": "browser",
-    "browserOpen": "browser",
-    "browserOpenAppLink": "browser",
-    "browserPermissionAnswer": "browser",
-    "browserPermissions": "browser",
-    "browserPermissionSet": "browser",
-    "browserPrint": "browser",
-    "browserPrivacy": "browser",
-    "browserReloadHung": "browser",
-    "browserSetKeys": "browser",
-    "browserSite": "browser",
-    "browserSiteAnswer": "browser",
-    "browserSiteClear": "browser",
-    "browserSleep": "browser",
-    "browserWindowFullscreen": "browser",
-    "browserZoom": "browser",
-    "claudePlanLimits": "terminals",
-    "claudeUsage": "terminals",
-    "clearWallpaper": "system",
-    "convertFileSrc": "files",
-    "dbConnect": "network",
-    "dbDisconnect": "network",
-    "dbQuery": "network",
-    "dbSchema": "network",
-    "deleteIconPack": "deck",
-    "exec": "processes",
-    "extensionInstallFolder": "browser",
-    "extensionInstallStore": "browser",
-    "extensionPopup": "browser",
-    "extensionPopupClose": "browser",
-    "extensionReload": "browser",
-    "extensionRemove": "browser",
-    "extensionSetEnabled": "browser",
-    "extensionsList": "browser",
-    "fsCopy": "files",
-    "fsCreateDir": "files",
-    "fsCreateFile": "files",
-    "fsDelete": "files",
-    "fsDrives": "files",
-    "fsFiles": "files",
-    "fsFind": "files",
-    "fsHash": "files",
-    "fsList": "files",
-    "fsMove": "files",
-    "fsOpen": "files",
-    "fsRead": "files",
-    "fsReadBytes": "files",
-    "fsRename": "files",
-    "fsReplace": "files",
-    "fsReveal": "files",
-    "fsSaveUnique": "files",
-    "fsSearch": "files",
-    "fsSize": "files",
-    "fsThumbnail": "files",
-    "fsTrash": "files",
-    "fsWrite": "files",
-    "fsWriteBytes": "files",
-    "ghPrLineComment": "network",
-    "ghPrThreads": "network",
-    "ghRun": "processes",
-    "ghThreadReply": "network",
-    "ghThreadResolve": "network",
-    "gitAiCommitMsg": "git",
-    "gitBlameLine": "git",
-    "gitCheckout": "git",
-    "gitCheckoutDetach": "git",
-    "gitCheckoutNew": "git",
-    "gitCheckoutTrack": "git",
-    "gitCommitFiles": "git",
-    "gitDiscard": "git",
-    "gitFileBytes": "git",
-    "gitFileDiff": "git",
-    "gitInfo": "git",
-    "gitLogGraph": "git",
-    "gitPoll": "git",
-    "gitRangeFiles": "git",
-    "gitRefs": "git",
-    "gitRepos": "git",
-    "gitRun": "git",
-    "gitStatus": "git",
-    "glabApi": "network",
-    "glabRun": "processes",
-    "googleAccount": "secrets",
-    "googleSignIn": "secrets",
-    "googleSignOut": "secrets",
-    "googleToken": "secrets",
-    "httpCancel": "network",
-    "httpSend": "network",
-    "httpSendAs": "network",
-    "httpSendReply": "network",
-    "importIconPack": "deck",
-    "installAgentHooks": "terminals",
-    "installAgentMcp": "terminals",
-    "installAgentSkills": "terminals",
-    "installFromRegistry": "deck",
-    "launchFiles": "files",
-    "listApps": "system",
-    "listInstalled": "system",
-    "logLatest": "deck",
-    "mediaMeta": "files",
-    "memKill": "system",
-    "openFile": "files",
-    "openTestDeck": "deck",
-    "procKill": "processes",
-    "procStream": "processes",
-    "procWrite": "processes",
-    "readIconPackTheme": "deck",
-    "readTermLayout": "terminals",
-    "readTrackMeta": "files",
-    "remoteHome": "network",
-    "remoteStat": "network",
-    "remoteSudoPassword": "secrets",
-    "removeLanguage": "deck",
-    "restartApp": "deck",
-    "runScriptNow": "processes",
-    "sessionList": "terminals",
-    "setAutostart": "system",
-    "setDebugTargets": "processes",
-    "setWallpaper": "system",
-    "sshHosts": "network",
-    "sshTunnelClose": "network",
-    "sshTunnelOpen": "network",
-    "vaultChangePassword": "secrets",
-    "vaultConfig": "secrets",
-    "vaultCreate": "secrets",
-    "vaultDelete": "secrets",
-    "vaultExport": "secrets",
-    "vaultFill": "secrets",
-    "vaultFillNew": "secrets",
-    "vaultGenerate": "secrets",
-    "vaultImport": "secrets",
-    "vaultList": "secrets",
-    "vaultLock": "secrets",
-    "vaultMatches": "secrets",
-    "vaultNeverList": "secrets",
-    "vaultNeverRemove": "secrets",
-    "vaultOfferAnswer": "secrets",
-    "vaultSave": "secrets",
-    "vaultSecret": "secrets",
-    "vaultStatus": "secrets",
-    "vaultTotp": "secrets",
-    "vaultUnlock": "secrets",
-    "vpsRunsPull": "network",
-    "watchFiles": "files"
-  },
-  "modules": {
-    "terminals": "terminals",
-    "p2p": "network"
-  },
-  "free": [
-    "DEFAULT_SETTINGS",
-    "FOOTER_ITEMS",
-    "configDelete",
-    "configRead",
-    "configWrite",
-    "dataDir",
-    "deckReady",
-    "dirsDownload",
-    "footerOrder",
-    "fsHomeDir",
-    "getAutostart",
-    "isFullscreen",
-    "languagesDir",
-    "launchUrls",
-    "mediaSetNowPlaying",
-    "mediaSetPlayback",
-    "memUsage",
-    "notifyOs",
-    "openExternal",
-    "pickAnyFile",
-    "pickExe",
-    "pickFile",
-    "pickFolder",
-    "pickImage",
-    "pickSavePath",
-    "pickScript",
-    "pluginsDir",
-    "revealInFolder",
-    "startupMarks",
-    "toggleFullscreen"
-  ]
-}
+{
+  "generated": "by sdk/gen-permissions.mjs from src/core/permissions.ts; do not edit",
+  "permissions": {
+    "files": "Read and change files anywhere on this PC",
+    "processes": "Run programs and commands",
+    "git": "Read and change git repositories, and push",
+    "network": "Connect to servers: web requests, SSH, databases and other Decks",
+    "terminals": "Use your terminals and the AI agents running in them",
+    "browser": "Control Deck's browser and the pages open in it",
+    "secrets": "Use your saved passwords, your Google account and sudo passwords",
+    "system": "Change this PC's apps, startup programs, wallpaper and running processes",
+    "deck": "Change Deck itself: its settings, backups, plugins and languages"
+  },
+  "bridge": {
+    "adblockConfig": "browser",
+    "adblockInfo": "browser",
+    "adblockRebuild": "browser",
+    "adblockUpdate": "browser",
+    "agentClis": "terminals",
+    "agentMcpStatus": "terminals",
+    "agentStop": "terminals",
+    "askSudoPassword": "secrets",
+    "backupExport": "deck",
+    "backupInspect": "deck",
+    "backupRestore": "deck",
+    "bookmarksBarMode": "browser",
+    "browserAgentAnswer": "browser",
+    "browserAgentConfig": "browser",
+    "browserAgentFillAnswer": "browser",
+    "browserBounds": "browser",
+    "browserCapture": "browser",
+    "browserCdp": "browser",
+    "browserClear": "browser",
+    "browserClose": "browser",
+    "browserCut": "browser",
+    "browserDefaultRegister": "browser",
+    "browserDefaultStatus": "browser",
+    "browserDevtools": "browser",
+    "browserDownload": "browser",
+    "browserFind": "browser",
+    "browserHistoryCount": "browser",
+    "browserHistoryForgetRange": "browser",
+    "browserHistoryForgetUrl": "browser",
+    "browserHistoryList": "browser",
+    "browserHistoryRecent": "browser",
+    "browserHistorySuggest": "browser",
+    "browserHistoryVisit": "browser",
+    "browserMute": "browser",
+    "browserNav": "browser",
+    "browserNotificationClicked": "browser",
+    "browserOpen": "browser",
+    "browserOpenAppLink": "browser",
+    "browserPermissionAnswer": "browser",
+    "browserPermissions": "browser",
+    "browserPermissionSet": "browser",
+    "browserPrint": "browser",
+    "browserPrivacy": "browser",
+    "browserReloadHung": "browser",
+    "browserSetKeys": "browser",
+    "browserSite": "browser",
+    "browserSiteAnswer": "browser",
+    "browserSiteClear": "browser",
+    "browserSleep": "browser",
+    "browserWindowFullscreen": "browser",
+    "browserZoom": "browser",
+    "claudePlanLimits": "terminals",
+    "claudeUsage": "terminals",
+    "clearWallpaper": "system",
+    "convertFileSrc": "files",
+    "dbConnect": "network",
+    "dbDisconnect": "network",
+    "dbQuery": "network",
+    "dbSchema": "network",
+    "deleteIconPack": "deck",
+    "exec": "processes",
+    "extensionInstallFolder": "browser",
+    "extensionInstallStore": "browser",
+    "extensionPopup": "browser",
+    "extensionPopupClose": "browser",
+    "extensionReload": "browser",
+    "extensionRemove": "browser",
+    "extensionSetEnabled": "browser",
+    "extensionsList": "browser",
+    "fsCopy": "files",
+    "fsCreateDir": "files",
+    "fsCreateFile": "files",
+    "fsDelete": "files",
+    "fsDrives": "files",
+    "fsFiles": "files",
+    "fsFind": "files",
+    "fsHash": "files",
+    "fsList": "files",
+    "fsMove": "files",
+    "fsOpen": "files",
+    "fsRead": "files",
+    "fsReadBytes": "files",
+    "fsRename": "files",
+    "fsReplace": "files",
+    "fsReveal": "files",
+    "fsSaveUnique": "files",
+    "fsSearch": "files",
+    "fsSize": "files",
+    "fsThumbnail": "files",
+    "fsTrash": "files",
+    "fsWrite": "files",
+    "fsWriteBytes": "files",
+    "ghPrLineComment": "network",
+    "ghPrThreads": "network",
+    "ghRun": "processes",
+    "ghThreadReply": "network",
+    "ghThreadResolve": "network",
+    "gitAiCommitMsg": "git",
+    "gitBlameLine": "git",
+    "gitCheckout": "git",
+    "gitCheckoutDetach": "git",
+    "gitCheckoutNew": "git",
+    "gitCheckoutTrack": "git",
+    "gitCommitFiles": "git",
+    "gitDiscard": "git",
+    "gitFileBytes": "git",
+    "gitFileDiff": "git",
+    "gitInfo": "git",
+    "gitLogGraph": "git",
+    "gitPoll": "git",
+    "gitRangeFiles": "git",
+    "gitRefs": "git",
+    "gitRepos": "git",
+    "gitRun": "git",
+    "gitStatus": "git",
+    "glabApi": "network",
+    "glabRun": "processes",
+    "googleAccount": "secrets",
+    "googleSignIn": "secrets",
+    "googleSignOut": "secrets",
+    "googleToken": "secrets",
+    "httpCancel": "network",
+    "httpSend": "network",
+    "httpSendAs": "network",
+    "httpSendReply": "network",
+    "importIconPack": "deck",
+    "installAgentHooks": "terminals",
+    "installAgentMcp": "terminals",
+    "installAgentSkills": "terminals",
+    "installFromRegistry": "deck",
+    "launchFiles": "files",
+    "listApps": "system",
+    "listInstalled": "system",
+    "logLatest": "deck",
+    "mediaMeta": "files",
+    "memKill": "system",
+    "openFile": "files",
+    "openTestDeck": "deck",
+    "procKill": "processes",
+    "procStream": "processes",
+    "procWrite": "processes",
+    "readIconPackTheme": "deck",
+    "readTermLayout": "terminals",
+    "readTrackMeta": "files",
+    "remoteHome": "network",
+    "remoteStat": "network",
+    "remoteSudoPassword": "secrets",
+    "removeLanguage": "deck",
+    "restartApp": "deck",
+    "runScriptNow": "processes",
+    "sessionList": "terminals",
+    "setAutostart": "system",
+    "setDebugTargets": "processes",
+    "setWallpaper": "system",
+    "sshHosts": "network",
+    "sshTunnelClose": "network",
+    "sshTunnelOpen": "network",
+    "vaultChangePassword": "secrets",
+    "vaultConfig": "secrets",
+    "vaultCreate": "secrets",
+    "vaultDelete": "secrets",
+    "vaultExport": "secrets",
+    "vaultFill": "secrets",
+    "vaultFillNew": "secrets",
+    "vaultGenerate": "secrets",
+    "vaultImport": "secrets",
+    "vaultList": "secrets",
+    "vaultLock": "secrets",
+    "vaultMatches": "secrets",
+    "vaultNeverList": "secrets",
+    "vaultNeverRemove": "secrets",
+    "vaultOfferAnswer": "secrets",
+    "vaultSave": "secrets",
+    "vaultSecret": "secrets",
+    "vaultStatus": "secrets",
+    "vaultTotp": "secrets",
+    "vaultUnlock": "secrets",
+    "vpsRunsPull": "network",
+    "watchFiles": "files"
+  },
+  "modules": {
+    "terminals": "terminals",
+    "p2p": "network"
+  },
+  "free": [
+    "DEFAULT_SETTINGS",
+    "FOOTER_ITEMS",
+    "configDelete",
+    "configRead",
+    "configWrite",
+    "dataDir",
+    "deckReady",
+    "dirsDownload",
+    "footerOrder",
+    "fsHomeDir",
+    "getAutostart",
+    "isFullscreen",
+    "languagesDir",
+    "launchUrls",
+    "mediaSetNowPlaying",
+    "mediaSetPlayback",
+    "memUsage",
+    "notifyOs",
+    "openExternal",
+    "pickAnyFile",
+    "pickExe",
+    "pickFile",
+    "pickFolder",
+    "pickImage",
+    "pickSavePath",
+    "pickScript",
+    "pluginsDir",
+    "revealInFolder",
+    "startupMarks",
+    "toggleFullscreen"
+  ]
+}

package/shim/bridge.js

@@ -32,6 +32,7 @@ export const browserCapture = (...a) => b().browserCapture(...a);
 export const browserCdp = (...a) => b().browserCdp(...a);
 export const browserClear = (...a) => b().browserClear(...a);
 export const browserClose = (...a) => b().browserClose(...a);
+export const browserCut = (...a) => b().browserCut(...a);
 export const browserDefaultRegister = (...a) => b().browserDefaultRegister(...a);
 export const browserDefaultStatus = (...a) => b().browserDefaultStatus(...a);
 export const browserDevtools = (...a) => b().browserDevtools(...a);

package/shim/p2p.js

@@ -1,16 +1,16 @@
-// GENERATED by sdk/gen-shim.mjs — do not edit.
-//
-// Deck's live connections to other Decks. 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. One transport for every plugin, so a fix to it reaches all of them.
-import { pluginId } from "./scope.js";
-const t = () => {
-  const x = window.__deck?.forPlugin?.(pluginId)?.p2p ?? window.__deck?.p2p;
-  if (!x) throw new Error("window.__deck.p2p is missing — this plugin only runs inside Deck");
-  return x;
-};
-
-export const cleanCode = (...a) => t().cleanCode(...a);
-export const newCode = (...a) => t().newCode(...a);
-export const selfId = (...a) => t().selfId(...a);
-export const share = (...a) => t().share(...a);
+// GENERATED by sdk/gen-shim.mjs — do not edit.
+//
+// Deck's live connections to other Decks. 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. One transport for every plugin, so a fix to it reaches all of them.
+import { pluginId } from "./scope.js";
+const t = () => {
+  const x = window.__deck?.forPlugin?.(pluginId)?.p2p ?? window.__deck?.p2p;
+  if (!x) throw new Error("window.__deck.p2p is missing — this plugin only runs inside Deck");
+  return x;
+};
+
+export const cleanCode = (...a) => t().cleanCode(...a);
+export const newCode = (...a) => t().newCode(...a);
+export const selfId = (...a) => t().selfId(...a);
+export const share = (...a) => t().share(...a);

package/shim/terminals.js

@@ -16,14 +16,17 @@ 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);
@@ -62,10 +65,13 @@ 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);

package/template/plugin.json

@@ -5,6 +5,6 @@
   "icon": "Sparkles",
   "color": "#a78bfa",
   "version": "0.1.0",
-  "minDeck": "1.9.0",
+  "minDeck": "1.10.0",
   "permissions": []
 }

package/types/components/ConfirmDialog.d.ts

@@ -14,6 +14,8 @@ 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 }: {

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

@@ -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;
@@ -265,10 +267,54 @@ export interface Settings {
     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. */
@@ -383,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"). */
@@ -391,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).

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. */

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. */

package/types/core/p2p.d.ts

@@ -1,117 +1,117 @@
-// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
-/** What can travel: anything JSON can carry. */
-export type Json = string | number | boolean | null | Json[] | {
-    [k: string]: Json;
-};
-/** Whether someone may change what is shared, or only watch. */
-export type Mode = "edit" | "view";
-/** Who may change things: a default for everyone, and a choice per person that wins over it. */
-export interface Roles {
-    def: Mode;
-    per: Record<string, Mode>;
-}
-/** Why a share ended for a joiner: the host stopped, vanished, removed this Deck, turned it away,
- *  or speaks another version. */
-export type Gone = "ended" | "lost" | "removed" | "denied" | "version";
-export interface Person {
-    id: string;
-    name: string; /** Round trip in ms, once measured. */
-    ms?: number;
-}
-/** What a share's bar and dialogs show. Replaced, never mutated, so React sees a change. */
-export interface ShareView {
-    /** Who is in and connected: on the host, everyone let in; on a joiner, the host and the others. */
-    peers: Person[];
-    /** On the host: who is asking to be let in. */
-    knocking: Person[];
-    /** On a joiner: the host is there but has not let this Deck in yet. */
-    waiting: boolean;
-    /** On a joiner: no host heard from for a while (wrong code, or a network that blocks it). */
-    stuck: boolean;
-    gone: Gone | null;
-    hostName: string;
-    /** A passing line: someone on another version, or whatever the plugin `say`s. */
-    note: string;
-    roles: Roles;
-    /** Whether this Deck may change things. */
-    canEdit: boolean;
-}
-export interface ShareOptions {
-    /** What the share is for, e.g. "canvas-share". Decks only meet others using the same one. */
-    app: string;
-    /** The share code, which names the room (see newCode). */
-    code: string;
-    /** Optional extra secret, needed with the code to connect at all. Sharing works without one. */
-    password?: string;
-    /** The plugin's message channel, at most 12 bytes (Trystero's cap). Defaults to "msg". */
-    channel?: string;
-    /** Whether this Deck is the one sharing. */
-    host: boolean;
-    /** Shown to the others: in the host's knock, on cursors, in the list of who is here. */
-    name: string;
-    /** The plugin's own protocol version. Decks on different versions do not share. */
-    version: number;
-    /** The host's default for who may change things. Joiners may until the host says otherwise. */
-    mode?: Mode;
-}
-export interface ShareHandlers<T> {
-    /** A plugin message, only ever from someone let in (and the host). Check `mayEdit(peer)` before
-     *  applying a change: a view-only person's edits are to be dropped by every Deck. */
-    message: (msg: T, peer: string) => void;
-    /** On the host: someone was just let in. Send them what they need to start, e.g. the board. */
-    welcome?: (peer: string) => void;
-    /** Someone left or was removed: forget what was kept for them (a cursor). */
-    left?: (peer: string) => void;
-}
-export interface P2pShare<T> {
-    readonly host: boolean;
-    /** Send a plugin message to everyone let in, or to one of them. Sends nothing before this Deck is
-     *  let in. Settles once handed to the connection, so awaiting it paces the sender. */
-    send(msg: T, to?: string): Promise<void>;
-    /** Whether a peer may change things: the host always, anyone else by the roles. */
-    mayEdit(peer: string): boolean;
-    /** The host: let someone in, or turn them away. */
-    allow(peer: string): void;
-    deny(peer: string): void;
-    /** The host: remove someone who was let in. They cannot come back with the same Deck. */
-    kick(peer: string): void;
-    /** The host: everyone's default, and one person's own choice (`null` follows the default). */
-    setDefault(mode: Mode): void;
-    setPerson(peer: string, mode: Mode | null): void;
-    /** Show a passing line in the view for a few seconds. */
-    say(note: string): void;
-    /** Leave. With `announce` (the host ending on purpose) everyone is told first, so they end at
-     *  once rather than when the connection times out. Safe to call twice. */
-    close(announce?: boolean): Promise<void>;
-    /** For useSyncExternalStore. */
-    subscribe(fn: () => void): () => void;
-    getView(): ShareView;
-}
-/** The part of a Trystero room a share uses: a seam, so the check can run a share without a network. */
-export interface RoomLike {
-    /** This Deck's id in the room; Trystero's own is `selfId()`. */
-    selfId?: string;
-    makeAction(name: string, config: {
-        onMessage: (data: any, ctx: {
-            peerId: string;
-        }) => void;
-    }): {
-        send(data: any, options?: {
-            target?: string | string[];
-        }): Promise<void>;
-    };
-    ping(peer: string): Promise<number>;
-    leave(): Promise<void>;
-    getPeers(): Record<string, unknown>;
-    onPeerJoin: ((peer: string) => void) | null;
-    onPeerLeave: ((peer: string) => void) | null;
-}
-/** This Deck's id in every share: the one the others know it by. The same for the whole session,
- *  so someone let in who rejoins after a dropped connection is let straight back in. */
-export declare function selfId(): string;
-/** Start sharing (`host`), or ask to join someone's share. */
-export declare function share<T extends Json>(opts: ShareOptions, on: ShareHandlers<T>, room?: RoomLike): P2pShare<T>;
-/** A share code: 16 random characters in four groups, easy to read out or paste. */
-export declare function newCode(random?: (n: number) => Uint8Array): string;
-/** A pasted code, tidied: spaces dropped, case folded. Empty when it is not a code. */
-export declare function cleanCode(text: string): string;
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+/** What can travel: anything JSON can carry. */
+export type Json = string | number | boolean | null | Json[] | {
+    [k: string]: Json;
+};
+/** Whether someone may change what is shared, or only watch. */
+export type Mode = "edit" | "view";
+/** Who may change things: a default for everyone, and a choice per person that wins over it. */
+export interface Roles {
+    def: Mode;
+    per: Record<string, Mode>;
+}
+/** Why a share ended for a joiner: the host stopped, vanished, removed this Deck, turned it away,
+ *  or speaks another version. */
+export type Gone = "ended" | "lost" | "removed" | "denied" | "version";
+export interface Person {
+    id: string;
+    name: string; /** Round trip in ms, once measured. */
+    ms?: number;
+}
+/** What a share's bar and dialogs show. Replaced, never mutated, so React sees a change. */
+export interface ShareView {
+    /** Who is in and connected: on the host, everyone let in; on a joiner, the host and the others. */
+    peers: Person[];
+    /** On the host: who is asking to be let in. */
+    knocking: Person[];
+    /** On a joiner: the host is there but has not let this Deck in yet. */
+    waiting: boolean;
+    /** On a joiner: no host heard from for a while (wrong code, or a network that blocks it). */
+    stuck: boolean;
+    gone: Gone | null;
+    hostName: string;
+    /** A passing line: someone on another version, or whatever the plugin `say`s. */
+    note: string;
+    roles: Roles;
+    /** Whether this Deck may change things. */
+    canEdit: boolean;
+}
+export interface ShareOptions {
+    /** What the share is for, e.g. "canvas-share". Decks only meet others using the same one. */
+    app: string;
+    /** The share code, which names the room (see newCode). */
+    code: string;
+    /** Optional extra secret, needed with the code to connect at all. Sharing works without one. */
+    password?: string;
+    /** The plugin's message channel, at most 12 bytes (Trystero's cap). Defaults to "msg". */
+    channel?: string;
+    /** Whether this Deck is the one sharing. */
+    host: boolean;
+    /** Shown to the others: in the host's knock, on cursors, in the list of who is here. */
+    name: string;
+    /** The plugin's own protocol version. Decks on different versions do not share. */
+    version: number;
+    /** The host's default for who may change things. Joiners may until the host says otherwise. */
+    mode?: Mode;
+}
+export interface ShareHandlers<T> {
+    /** A plugin message, only ever from someone let in (and the host). Check `mayEdit(peer)` before
+     *  applying a change: a view-only person's edits are to be dropped by every Deck. */
+    message: (msg: T, peer: string) => void;
+    /** On the host: someone was just let in. Send them what they need to start, e.g. the board. */
+    welcome?: (peer: string) => void;
+    /** Someone left or was removed: forget what was kept for them (a cursor). */
+    left?: (peer: string) => void;
+}
+export interface P2pShare<T> {
+    readonly host: boolean;
+    /** Send a plugin message to everyone let in, or to one of them. Sends nothing before this Deck is
+     *  let in. Settles once handed to the connection, so awaiting it paces the sender. */
+    send(msg: T, to?: string): Promise<void>;
+    /** Whether a peer may change things: the host always, anyone else by the roles. */
+    mayEdit(peer: string): boolean;
+    /** The host: let someone in, or turn them away. */
+    allow(peer: string): void;
+    deny(peer: string): void;
+    /** The host: remove someone who was let in. They cannot come back with the same Deck. */
+    kick(peer: string): void;
+    /** The host: everyone's default, and one person's own choice (`null` follows the default). */
+    setDefault(mode: Mode): void;
+    setPerson(peer: string, mode: Mode | null): void;
+    /** Show a passing line in the view for a few seconds. */
+    say(note: string): void;
+    /** Leave. With `announce` (the host ending on purpose) everyone is told first, so they end at
+     *  once rather than when the connection times out. Safe to call twice. */
+    close(announce?: boolean): Promise<void>;
+    /** For useSyncExternalStore. */
+    subscribe(fn: () => void): () => void;
+    getView(): ShareView;
+}
+/** The part of a Trystero room a share uses: a seam, so the check can run a share without a network. */
+export interface RoomLike {
+    /** This Deck's id in the room; Trystero's own is `selfId()`. */
+    selfId?: string;
+    makeAction(name: string, config: {
+        onMessage: (data: any, ctx: {
+            peerId: string;
+        }) => void;
+    }): {
+        send(data: any, options?: {
+            target?: string | string[];
+        }): Promise<void>;
+    };
+    ping(peer: string): Promise<number>;
+    leave(): Promise<void>;
+    getPeers(): Record<string, unknown>;
+    onPeerJoin: ((peer: string) => void) | null;
+    onPeerLeave: ((peer: string) => void) | null;
+}
+/** This Deck's id in every share: the one the others know it by. The same for the whole session,
+ *  so someone let in who rejoins after a dropped connection is let straight back in. */
+export declare function selfId(): string;
+/** Start sharing (`host`), or ask to join someone's share. */
+export declare function share<T extends Json>(opts: ShareOptions, on: ShareHandlers<T>, room?: RoomLike): P2pShare<T>;
+/** A share code: 16 random characters in four groups, easy to read out or paste. */
+export declare function newCode(random?: (n: number) => Uint8Array): string;
+/** A pasted code, tidied: spaces dropped, case folded. Empty when it is not a code. */
+export declare function cleanCode(text: string): string;

package/types/core/settingsstore.d.ts

@@ -1,26 +1,26 @@
-// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
-import { type Settings } from "./bridge";
-/** Called by Settings after every write, so readers update without a reload. */
-export declare function publishSettings(s: Settings): void;
-/**
- * Write settings and apply everything that has to happen alongside the write.
- *
- * Settings' own persist() used to be the only path, so anything outside that module (the
- * command palette toggling relay, say) would have had to repeat five steps and would break
- * quietly when one of them changed. Settings still owns its local form state and calls this
- * for the shared half.
- */
-export declare function saveSettings(next: Settings): void;
-/** The zoom steps Ctrl+= and Ctrl+- move through, in percent, as a browser's do. */
-export declare const ZOOM_STEPS: number[];
-/**
- * Zoom the whole window: the webview's own zoom, the same as a browser's Ctrl+=, rather than CSS
- * `zoom`, which leaves xterm and Monaco measuring the mouse in unzoomed pixels.
- */
-export declare function applyZoom(pct: number | undefined): void;
-/** One step in or out from the current zoom, or back to 100% with dir 0. Saved like any setting. */
-export declare function stepZoom(dir: -1 | 0 | 1): void;
-/** Current settings for non-React callers (the palette's providers). */
-export declare const getSettings: () => Settings;
-export declare function userName(): Promise<string>;
-export declare function useSettings(): Settings;
+// GENERATED by sdk/gen-types.mjs from Deck's source — do not edit.
+import { type Settings } from "./bridge";
+/** Called by Settings after every write, so readers update without a reload. */
+export declare function publishSettings(s: Settings): void;
+/**
+ * Write settings and apply everything that has to happen alongside the write.
+ *
+ * Settings' own persist() used to be the only path, so anything outside that module (the
+ * command palette toggling relay, say) would have had to repeat five steps and would break
+ * quietly when one of them changed. Settings still owns its local form state and calls this
+ * for the shared half.
+ */
+export declare function saveSettings(next: Settings): void;
+/** The zoom steps Ctrl+= and Ctrl+- move through, in percent, as a browser's do. */
+export declare const ZOOM_STEPS: number[];
+/**
+ * Zoom the whole window: the webview's own zoom, the same as a browser's Ctrl+=, rather than CSS
+ * `zoom`, which leaves xterm and Monaco measuring the mouse in unzoomed pixels.
+ */
+export declare function applyZoom(pct: number | undefined): void;
+/** One step in or out from the current zoom, or back to 100% with dir 0. Saved like any setting. */
+export declare function stepZoom(dir: -1 | 0 | 1): void;
+/** Current settings for non-React callers (the palette's providers). */
+export declare const getSettings: () => Settings;
+export declare function userName(): Promise<string>;
+export declare function useSettings(): Settings;

package/types/core/shellpath.d.ts

@@ -20,9 +20,11 @@ export interface TermPath {
  * The shortest extent comes first, so a caller that only wants the unambiguous reading can take
  * the first candidate per `start` and never consult the filesystem.
  *
- * ponytail: one row at a time, so a path wrapped across two visual rows is missed, and a relative
- * path resolves against the cwd the pane SPAWNED with, so it is wrong after a `cd`. Absolute
- * paths — what Claude Code and most tools print — are unaffected by both.
+ * One line of text: a path wrapped over several rows is found once `joinRows` has put them back
+ * together.
+ *
+ * ponytail: a relative path resolves against the cwd the pane SPAWNED with, so it is wrong after a
+ * `cd`. Absolute paths — what Claude Code and most tools print — are unaffected.
  *
  * ponytail: only the END of a path can be recovered this way. A RELATIVE path whose first segment
  * contains a space ("My Docs\a.txt") is anchored at "Docs\a.txt", because the match can only
@@ -43,3 +45,41 @@ export declare function findPaths(row: string, cwd: string): TermPath[];
  * land on either.
  */
 export declare function chooseLinks(candidates: readonly TermPath[], exists: readonly boolean[]): TermPath[];
+/**
+ * A Windows path not found as printed, with a backslash put back that Markdown took out. Claude
+ * Code renders its output as Markdown, where `\.` and `\_` mean a plain dot and underscore, so
+ * "review-repo\.gitattributes" is shown as "review-repo.gitattributes". One reading per dot or
+ * underscore that follows a name character, each to be tried on disk.
+ */
+export declare function unescapedReadings(path: string): string[];
+/** A row of the screen: its text (trailing blanks kept), and whether xterm wrapped it onto the row before. */
+export interface Row {
+    text: string;
+    wrapped: boolean;
+}
+/**
+ * The line row `at` is part of, read back as one: rows xterm wrapped itself (a shell's long line),
+ * and rows a program broke where a path ran out of room. Claude Code wraps its own output, a hard
+ * line break with the rest indented under it, so xterm knows nothing of that wrap: a row and the
+ * next are taken as a path broken in two when the words either side of the break look like one
+ * (see `broken`), and they join without the break or the indent. `cells[i]` is where character `i`
+ * of the text is on screen: its row (an index into `rows`) and column. At most `reach` rows each way.
+ *
+ * A list of paths, one a row, joins too: only the filesystem can tell it from one path broken in
+ * two, which is why the terminal also offers the row on its own.
+ */
+export declare function joinRows(rows: readonly Row[], at: number, reach?: number): {
+    text: string;
+    cells: [number, number][];
+};
+/**
+ * Every path candidate on row `at`, also one wrapped over the rows around it. A join xterm made is
+ * certain, but one at a break (`broken`) is a guess: a path can end a row with the next row's words
+ * glued on, so the joined line (`joinRows`) is read cut at each such break as well, every span of
+ * it that holds row `at`. Starts are indices into `text`, ascending, ready for `chooseLinks`;
+ * `cells` says where each is on screen.
+ */
+export declare function rowPaths(rows: readonly Row[], at: number, cwd: string): {
+    cands: TermPath[];
+    cells: [number, number][];
+};

package/types/core/terminals.d.ts

@@ -51,6 +51,12 @@ export interface LayoutTab {
      * where it was).
      */
     window?: string;
+    /**
+     * Opened straight into a floating window by Deck (openInFloat: a link, a page an agent opened, a
+     * file Ctrl+clicked in a terminal), so closing that window closes it rather than docking it into
+     * the main window. Dropped the moment the tab is moved by hand: then it is one of yours.
+     */
+    transient?: true;
 }
 export interface LayoutWorkspace {
     id: string;
@@ -71,6 +77,8 @@ export interface FloatBounds {
     w: number;
     h: number;
     max?: boolean;
+    /** A window things are sent to by name (core/floatwin.ts openInFloat): "links", "agent". */
+    name?: string;
 }
 export interface Layout {
     workspaces: LayoutWorkspace[];
@@ -203,6 +211,15 @@ export declare function moveTabToZone(tabs: readonly LayoutTab[], tabId: string,
  * result is right even for a zone that is not the active one.
  */
 export declare function addTabToZone(tabs: readonly LayoutTab[], besideId: string, tab: LayoutTab): LayoutTab[];
+/**
+ * A closed tab put back in workspace `w` (core/closedtabs.ts): in front in the zone you are in,
+ * with new ids for the tab and its panes, since the old panes' shells and state are gone. Out of
+ * any group and any window it was in. Returns the workspace and each old pane's new id.
+ */
+export declare function reopenTab(w: LayoutWorkspace, tab: LayoutTab, fresh?: () => string): {
+    w: LayoutWorkspace;
+    ids: Record<string, string>;
+};
 /**
  * Make a workspace's active tab the one its zone shows.
  *
@@ -232,6 +249,13 @@ export declare function setTabWindow(w: LayoutWorkspace, tabId: string, win: str
  * since a window holds one project's tabs.
  */
 export declare function mergeWindow(l: Layout, from: string, into: string | null): Layout;
+/**
+ * Close floating window `id` into the main window: its tabs go back to their zones, each behind the
+ * tab its zone shows, so closing a window does not take you away from the tab you are on. With
+ * `discard` (its X, Alt+F4), the tabs Deck opened into it (`transient`) close instead; the caller
+ * destroys their panes.
+ */
+export declare function dockWindow(l: Layout, id: string, discard?: boolean): Layout;
 /** The first free spot on the top row, for a zone created without a position of its own. */
 export declare function nextZoneSpot(tabs: readonly LayoutTab[], cols?: number, rows?: number): {
     x: number;
@@ -316,7 +340,15 @@ export declare function moveLeaf(root: LayoutNode, srcId: string, targetId: stri
 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;
+/**
+ * `agent`: asked for over the control API (an agent), not from Deck's own palette. Then a new
+ * terminal tab or project is added without switching to it (Settings → Where things open,
+ * agentTerminals), its shell started at once (spawnUnseen): a pane starts its shell when it is
+ * first drawn, and the agent's next command goes to that shell.
+ */
+export declare function applyDtCommand(op: string, args: Record<string, unknown>, agent?: boolean): string | void;
+/** Close the pane `pane`: its whole tab when it is the tab's only pane, as an agent's page is. */
+export declare function closePaneTab(pane: string): void;
 interface Instance {
     term: Terminal;
     fit: FitAddon;
@@ -361,7 +393,7 @@ export declare function moveWorkspace(id: string, toIndex: number): void;
  * Registered per attach because resolving a relative path needs the pane's cwd, which is what
  * attach is given. The instance outlives its DOM, so the previous provider is disposed first
  * rather than stacking a second one on every re-attach. The matching itself lives in shellpath
- * (no xterm import), where it is exercised by shellpath.check.ts.
+ * (no xterm import), where it is exercised by shellpath.check.mjs.
  *
  * Only a path that actually exists is offered as a link. Matching the shape of a path is not the
  * same as having one: output wraps mid-path at the edge of a narrow pane, a relative path resolves
@@ -449,6 +481,27 @@ export declare function queueInput(paneId: string, text: string): void;
  * the user picked (the agent launcher) has to handle both.
  */
 export declare function sendInput(paneId: string, text: string): void;
+/** The command that resumes an agent's session, or undefined for a kind Deck cannot resume. */
+export declare const resumeCommand: (kind: string, session: string) => string;
+/**
+ * The agent session each of these panes holds, read fresh from the sweep's file (the map cached at
+ * startup misses an agent started since): for a closed tab to resume it when reopened. Read before
+ * the next sweep, which drops a pane gone from the layout.
+ */
+export declare function agentSessions(ids: string[]): Promise<Record<string, {
+    kind: string;
+    session: string;
+}>>;
+/**
+ * What is running in these panes besides their shells, for a close to ask about: the programs the
+ * sweep saw in each (state/term-procs), or "an agent" for one it has not listed yet. Only panes
+ * with a shell count; a view pane loses nothing by closing.
+ *
+ * ponytail: term-procs is up to 10s old (the sweep's interval), so a program started just before
+ * the close is missed. A term_busy command taking its own snapshot (pane_pids + sweep_procs) would
+ * not be.
+ */
+export declare function runningIn(ids: string[]): Promise<string[]>;
 /**
  * Size a pane's PTY, and every view of it, to the SMALLER of those views.
  *