package.json

{
  "name": "sandy-ui",
  "displayName": "Sandy UI",
  "description": "VSCode extension wrapping the sandy CLI — webview-hosted terminal, schema-driven settings, pre-flight approvals.",
  "version": "0.8.0",
  "publisher": "rappdw",
  "private": true,
  "repository": {
    "type": "git",
    "url": "https://github.com/rappdw/sandy-ui.git"
  },
  "license": "MIT",
  "engines": {
    "vscode": "^1.85.0"
  },
  "categories": [
    "Other"
  ],
  "main": "./out/extension.js",
  "extensionKind": [
    "workspace"
  ],
  "activationEvents": [
    "onStartupFinished"
  ],
  "contributes": {
    "commands": [
      {
        "command": "sandy.launch",
        "title": "Sandy: Launch (in webview tab)"
      },
      {
        "command": "sandy.walkthrough.open",
        "title": "Sandy: Get Started"
      },
      {
        "command": "sandy.walkthrough.ackPersistence",
        "title": "Sandy: Acknowledge persistence note"
      },
      {
        "command": "sandy.approval.test",
        "title": "Sandy: Test Approval Modal"
      },
      {
        "command": "sandy.settings.open",
        "title": "Sandy: Open Settings"
      },
      {
        "command": "sandy.state.refresh",
        "title": "Sandy: Refresh State",
        "icon": "$(refresh)"
      },
      {
        "command": "sandy.pruneOrphans",
        "title": "Sandy: Prune Orphaned Networks"
      },
      {
        "command": "sandy.statusbar.click",
        "title": "Sandy: Switch Session…"
      },
      {
        "command": "sandy.tree.launch",
        "title": "Launch sandy here"
      },
      {
        "command": "sandy.tree.openWorkspace",
        "title": "Open Workspace Folder…"
      },
      {
        "command": "sandy.tree.openWorkspaceNewWin",
        "title": "Open Workspace in New Window"
      },
      {
        "command": "sandy.tree.revealSandbox",
        "title": "Reveal Sandbox in File Manager"
      },
      {
        "command": "sandy.tree.copyWorkspacePath",
        "title": "Copy Workspace Path"
      },
      {
        "command": "sandy.tree.detach",
        "title": "Detach"
      },
      {
        "command": "sandy.tree.stop",
        "title": "Stop sandy"
      },
      {
        "command": "sandy.tree.removeLock",
        "title": "Remove Lock…"
      },
      {
        "command": "sandy.tree.deleteSandbox",
        "title": "Delete Sandbox…"
      },
      {
        "command": "sandy.synthkit.md2email",
        "title": "Synthkit: Convert to Email HTML (clipboard)"
      },
      {
        "command": "sandy.synthkit.md2doc",
        "title": "Synthkit: Convert to Word (.docx)"
      },
      {
        "command": "sandy.synthkit.md2pdf",
        "title": "Synthkit: Convert to PDF"
      }
    ],
    "menus": {
      "view/title": [
        {
          "command": "sandy.state.refresh",
          "when": "view == sandy.projects",
          "group": "navigation"
        }
      ],
      "view/item/context": [
        {
          "command": "sandy.tree.launch",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\./",
          "group": "1_run@1"
        },
        {
          "command": "sandy.tree.openWorkspace",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\./",
          "group": "2_open@1"
        },
        {
          "command": "sandy.tree.openWorkspaceNewWin",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\./",
          "group": "2_open@2"
        },
        {
          "command": "sandy.tree.revealSandbox",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\./",
          "group": "3_reveal@1"
        },
        {
          "command": "sandy.tree.copyWorkspacePath",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\./",
          "group": "3_reveal@2"
        },
        {
          "command": "sandy.tree.detach",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\.(running|locked)$/",
          "group": "5_session@1"
        },
        {
          "command": "sandy.tree.stop",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\.(running|locked)$/",
          "group": "5_session@2"
        },
        {
          "command": "sandy.tree.removeLock",
          "when": "view == sandy.projects && viewItem == sandbox.locked",
          "group": "8_unstick@1"
        },
        {
          "command": "sandy.tree.deleteSandbox",
          "when": "view == sandy.projects && viewItem =~ /^sandbox\\./",
          "group": "9_destructive@1"
        }
      ],
      "explorer/context": [
        {
          "command": "sandy.synthkit.md2email",
          "when": "resourceExtname == .md",
          "group": "synthkit@1"
        },
        {
          "command": "sandy.synthkit.md2doc",
          "when": "resourceExtname == .md",
          "group": "synthkit@2"
        },
        {
          "command": "sandy.synthkit.md2pdf",
          "when": "resourceExtname == .md",
          "group": "synthkit@3"
        }
      ],
      "editor/context": [
        {
          "command": "sandy.synthkit.md2email",
          "when": "resourceExtname == .md",
          "group": "synthkit@1"
        },
        {
          "command": "sandy.synthkit.md2doc",
          "when": "resourceExtname == .md",
          "group": "synthkit@2"
        },
        {
          "command": "sandy.synthkit.md2pdf",
          "when": "resourceExtname == .md",
          "group": "synthkit@3"
        }
      ],
      "editor/title/context": [
        {
          "command": "sandy.synthkit.md2email",
          "when": "resourceExtname == .md",
          "group": "synthkit@1"
        },
        {
          "command": "sandy.synthkit.md2doc",
          "when": "resourceExtname == .md",
          "group": "synthkit@2"
        },
        {
          "command": "sandy.synthkit.md2pdf",
          "when": "resourceExtname == .md",
          "group": "synthkit@3"
        }
      ]
    },
    "walkthroughs": [
      {
        "id": "sandy.gettingStarted",
        "title": "Get Started with Sandy",
        "description": "Run sandy in an isolated container, right in your editor.",
        "when": "true",
        "steps": [
          {
            "id": "checkSandy",
            "title": "Install sandy",
            "description": "Sandy is a CLI that runs your coding agent in an isolated Docker sandbox.",
            "media": {
              "markdown": "media/walkthrough/checkSandy.md"
            },
            "completionEvents": [
              "onContext:sandy.doctor.sandyOk"
            ]
          },
          {
            "id": "checkDocker",
            "title": "Start Docker",
            "description": "Sandy needs a running Docker-compatible runtime to build and launch its container.",
            "media": {
              "markdown": "media/walkthrough/checkDocker.md"
            },
            "completionEvents": [
              "onContext:sandy.doctor.dockerOk"
            ]
          },
          {
            "id": "firstLaunch",
            "title": "Launch your first session",
            "description": "Open sandy as an editor tab against the current workspace.",
            "media": {
              "markdown": "media/walkthrough/firstLaunch.md"
            },
            "completionEvents": [
              "onCommand:sandy.launch"
            ]
          },
          {
            "id": "persistence",
            "title": "Sessions persist — closing a tab doesn't stop them",
            "description": "The #1 surprise: closing the tab (or VSCode) detaches sandy, it doesn't stop it.",
            "media": {
              "markdown": "media/walkthrough/persistence.md"
            },
            "completionEvents": [
              "onContext:sandy.walkthrough.persistenceRead"
            ]
          },
          {
            "id": "settingsTour",
            "title": "Settings & the approval model",
            "description": "Schema-driven settings with Project/Global scope tabs and a verbatim pre-flight approval modal.",
            "media": {
              "markdown": "media/walkthrough/settingsTour.md"
            },
            "completionEvents": [
              "onCommand:sandy.settings.open"
            ]
          }
        ]
      }
    ],
    "viewsContainers": {
      "activitybar": [
        {
          "id": "sandy",
          "title": "Sandy",
          "icon": "media/icon.svg"
        }
      ]
    },
    "views": {
      "sandy": [
        {
          "id": "sandy.projects",
          "name": "Projects"
        }
      ]
    },
    "configuration": {
      "title": "Sandy",
      "properties": {
        "sandy.binaryPath": {
          "type": "string",
          "default": "",
          "description": "Absolute path to the sandy binary. Empty = auto-detect (PATH lookup, then common install locations: /opt/homebrew/bin, /usr/local/bin, ~/.local/bin, ~/bin). Set this if VSCode launched-from-Dock can't find sandy on its narrower PATH."
        },
        "sandy.launchCommand": {
          "type": "string",
          "default": "",
          "description": "Override the launch command. Empty = auto-detect (sandy → tmux → $SHELL). Example: \"tmux new-session -A -s sandy-spike\" or \"/bin/bash -l\". Setting this forces the legacy (non-daemon) lifecycle — it overrides sandy.persistSessions."
        },
        "sandy.launch.closeBottomPanel": {
          "type": "boolean",
          "default": true,
          "description": "On Sandy: Launch, close the bottom panel (Problems / Output / Terminal / Debug Console) to maximize editor space."
        },
        "sandy.launch.closeAuxiliaryBar": {
          "type": "boolean",
          "default": true,
          "description": "On Sandy: Launch, close the auxiliary side bar (where Chat / Copilot panel typically lives) to maximize editor space."
        },
        "sandy.launch.closeSidebar": {
          "type": "boolean",
          "default": false,
          "description": "On Sandy: Launch, close the primary side bar (Explorer / Search / SCM). Off by default since the file tree is usually wanted alongside sandy."
        },
        "sandy.terminal.scrollSensitivity": {
          "type": "number",
          "default": 2,
          "minimum": 0.1,
          "maximum": 10,
          "description": "Mouse-wheel / trackpad scroll speed in the Sandy terminal. Higher scrolls faster, lower gives finer control. Applies live — no reload needed."
        },
        "sandy.persistSessions": {
          "type": "boolean",
          "default": true,
          "description": "Use sandy's daemon mode (sandy >= 1.1.0) so sessions survive VSCode restarts: closing a tab or quitting VSCode detaches instead of stopping; stop explicitly via the tree/status-bar Stop action. Off = legacy lifecycle (closing the tab stops sandy). Ignored when the installed sandy lacks daemon support."
        },
        "sandy.longRunningSessionHours": {
          "type": "number",
          "default": 24,
          "minimum": 0,
          "description": "Threshold in hours for a once-per-window notification about long-running persisted sessions. 0 disables."
        },
        "sandy.restoreSessionsOnStartup": {
          "type": "boolean",
          "default": false,
          "description": "On opening a workspace, if it has a persisted sandy daemon session running on the host, automatically reopen the Sandy tab attached to it (the reverse of detach-on-quit). Off by default; requires sandy.persistSessions and sandy >= 1.1.0 daemon mode."
        },
        "sandy.terminal.mouseMode": {
          "type": "string",
          "enum": ["nativeSelection", "tmux"],
          "enumDescriptions": [
            "Drag selects text natively; wheel is forwarded to tmux; in-app mouse clicks are not delivered (hold ⌥ never needed).",
            "tmux owns the mouse: in-app clicks and pane interactions work; text selection requires ⌥ (Option) drag."
          ],
          "default": "nativeSelection",
          "description": "Applies live to running terminals."
        }
      }
    }
  },
  "scripts": {
    "compile": "npm run copy-xterm && npm run typecheck:webview && npm run build:webviews && tsc -p ./",
    "watch": "tsc -watch -p ./",
    "watch:webviews": "node scripts/build-webviews.js --watch",
    "copy-xterm": "node scripts/copy-xterm.js",
    "build:webviews": "node scripts/build-webviews.js",
    "typecheck:webview": "tsc --noEmit -p tsconfig.webview.json",
    "test": "vitest run",
    "test:watch": "vitest",
    "test:coverage": "vitest run --coverage",
    "test:integration": "npm run compile && npm run compile:integration && electron-rebuild -f -w node-pty && vscode-test",
    "compile:integration": "tsc -p tsconfig.integration.json",
    "vscode:prepublish": "npm run compile",
    "package-vsix": "vsce package",
    "install-vsix": "npm run package-vsix && code --install-extension \"$(ls -t *.vsix | head -1)\" --force",
    "release": "npm run package-vsix && bash scripts/release.sh"
  },
  "dependencies": {
    "node-pty": "^1.0.0"
  },
  "devDependencies": {
    "@electron/rebuild": "^4.2.0",
    "@types/mocha": "^10.0.10",
    "@types/node": "^20.19.43",
    "@types/vscode": "^1.85.0",
    "@vitest/coverage-v8": "^4.1.8",
    "@vscode/test-cli": "^0.0.15",
    "@vscode/test-electron": "^3.0.0",
    "@vscode/vsce": "^3.9.2",
    "@xterm/addon-fit": "^0.10.0",
    "@xterm/addon-web-links": "^0.11.0",
    "@xterm/xterm": "^5.5.0",
    "electron": "^41.10.2",
    "esbuild": "^0.28.1",
    "mocha": "^11.7.6",
    "typescript": "^5.4.0",
    "vitest": "^4.1.10"
  }
}