deck-plugin-sdk 1.9.0 → 1.10.1

package/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "deck-plugin-sdk",
-  "version": "1.9.0",
-  "description": "Build a plugin for Deck, outside the Deck repository.",
-  "type": "module",
-  "license": "MIT",
-  "bin": {
-    "deck-plugin": "bin/deck-plugin.mjs"
-  },
-  "exports": {
-    "./build": "./build-plugin.mjs",
-    "./*": {
-      "types": "./shim/*.d.ts",
-      "default": "./shim/*.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "bin",
-    "shim",
-    "types",
-    "template",
-    "build-plugin.mjs",
-    "packages.mjs",
-    "README.md",
-    "permissions.json",
-    "publish.mjs",
-    "validate.mjs"
-  ],
-  "dependencies": {
-    "esbuild": "^0.28.0"
-  },
-  "peerDependencies": {
-    "@types/react": "^19.0.0",
-    "framer-motion": "^13.0.0",
-    "lucide-react": "^1.0.0",
-    "monaco-editor": "^0.56.0",
-    "react": "^19.0.0",
-    "typescript": "^5.0.0"
-  },
-  "peerDependenciesMeta": {
-    "framer-motion": {
-      "optional": true
-    },
-    "monaco-editor": {
-      "optional": true
-    },
-    "typescript": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "keywords": [
-    "deck",
-    "plugin",
-    "sdk"
-  ]
-}
+{
+  "name": "deck-plugin-sdk",
+  "version": "1.10.1",
+  "description": "Build a plugin for Deck, outside the Deck repository.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "deck-plugin": "bin/deck-plugin.mjs"
+  },
+  "exports": {
+    "./build": "./build-plugin.mjs",
+    "./*": {
+      "types": "./shim/*.d.ts",
+      "default": "./shim/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin",
+    "shim",
+    "types",
+    "template",
+    "build-plugin.mjs",
+    "packages.mjs",
+    "README.md",
+    "permissions.json",
+    "publish.mjs",
+    "validate.mjs"
+  ],
+  "dependencies": {
+    "esbuild": "^0.28.0"
+  },
+  "peerDependencies": {
+    "@types/react": "^19.0.0",
+    "framer-motion": "^13.0.0",
+    "lucide-react": "^1.0.0",
+    "monaco-editor": "^0.56.0",
+    "react": "^19.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "framer-motion": {
+      "optional": true
+    },
+    "monaco-editor": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "deck",
+    "plugin",
+    "sdk"
+  ]
+}

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

@@ -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.9.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.1",
+  "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. */
@@ -221,4 +233,5 @@ export declare const pageBox: (pane: string) => DOMRect | null;
 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 picturePages(on: boolean): 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. */

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