package.json

{
  "name": "openhands-tab",
  "displayName": "OpenHands Tab",
  "publisher": "openhands",
  "icon": "media/icons/openhands-icon.png",
  "version": "0.9.0",
  "description": "A VS Code extension to interact with OpenHands agents in a dedicated sidebar chat view",
  "license": "MIT",
  "workspaces": [
    "packages/*"
  ],
  "repository": {
    "type": "git",
    "url": "https://github.com/enyst/OpenHands-Tab.git"
  },
  "engines": {
    "node": ">=22.12.0 <23",
    "vscode": "^1.104.0"
  },
  "categories": [
    "Other"
  ],
  "main": "./dist/extension.js",
  "activationEvents": [
    "onCommand:openhands.open",
    "onCommand:openhands.explainSelection",
    "onCommand:openhands.startNewConversation",
    "onCommand:openhands.configure",
    "onCommand:openhands.setApiKey",
    "onCommand:openhands.setOpenAiApiKey",
    "onCommand:openhands.setAnthropicApiKey",
    "onCommand:openhands.setOpenRouterApiKey",
    "onCommand:openhands.setLiteLlmApiKey",
    "onCommand:openhands.setGeminiLlmApiKey",
    "onCommand:openhands.setCloudApiKey",
    "onCommand:openhands.setRuntimeSessionApiKey",
    "onCommand:openhands.cloudLogin",
    "onCommand:openhands.cloudLogout",
    "onCommand:openhands.setGithubToken",
    "onCommand:openhands.setHalTtsApiKey",
    "onCommand:openhands.setCustomSecret1",
    "onCommand:openhands.setCustomSecret2",
    "onCommand:openhands.setCustomSecret3",
    "onCommand:openhands.reconnect",
    "onCommand:openhands.pauseCurrentRun",
    "onCommand:openhands.resumeCurrentRun",
    "onCommand:openhands.toggleVerboseOutput",
    "onView:openhands.agent"
  ],
  "contributes": {
    "commands": [
      {
        "command": "openhands.open",
        "title": "OpenHands: Open"
      },
      {
        "command": "openhands.explainSelection",
        "title": "OpenHands: Explain Selection"
      },
      {
        "command": "openhands.startNewConversation",
        "title": "OpenHands: Start New Conversation"
      },
      {
        "command": "openhands.configure",
        "title": "OpenHands: Configure"
      },
      {
        "command": "openhands.toggleVerboseOutput",
        "title": "OpenHands: Toggle Verbose Output"
      },
      {
        "command": "openhands.setApiKey",
        "title": "OpenHands: Set API Key"
      },
      {
        "command": "openhands.setOpenAiApiKey",
        "title": "OpenHands: Set OpenAI API Key"
      },
      {
        "command": "openhands.setAnthropicApiKey",
        "title": "OpenHands: Set Anthropic API Key"
      },
      {
        "command": "openhands.setOpenRouterApiKey",
        "title": "OpenHands: Set OpenRouter API Key"
      },
      {
        "command": "openhands.setLiteLlmApiKey",
        "title": "OpenHands: Set LiteLLM Proxy API Key"
      },
      {
        "command": "openhands.setGeminiLlmApiKey",
        "title": "OpenHands: Set Gemini API Key"
      },
      {
        "command": "openhands.setCloudApiKey",
        "title": "OpenHands: Set Cloud API Key"
      },
      {
        "command": "openhands.setRuntimeSessionApiKey",
        "title": "OpenHands: Set Runtime Session API Key"
      },
      {
        "command": "openhands.cloudLogin",
        "title": "OpenHands: Login to Remote Server (Device Flow)"
      },
      {
        "command": "openhands.cloudLogout",
        "title": "OpenHands: Logout of Remote Server"
      },
      {
        "command": "openhands.setGithubToken",
        "title": "OpenHands: Set GitHub Token"
      },
      {
        "command": "openhands.setHalTtsApiKey",
        "title": "OpenHands: Set HAL TTS API Key"
      },
      {
        "command": "openhands.setCustomSecret1",
        "title": "OpenHands: Set Custom Secret 1"
      },
      {
        "command": "openhands.setCustomSecret2",
        "title": "OpenHands: Set Custom Secret 2"
      },
      {
        "command": "openhands.setCustomSecret3",
        "title": "OpenHands: Set Custom Secret 3"
      },
      {
        "command": "openhands.reconnect",
        "title": "OpenHands: Reconnect"
      },
      {
        "command": "openhands.pauseCurrentRun",
        "title": "OpenHands: Pause Current Run"
      },
      {
        "command": "openhands.resumeCurrentRun",
        "title": "OpenHands: Resume Current Run"
      },
      {
        "command": "openhands._diagnostics",
        "title": "OpenHands: Diagnostics (Internal)"
      }
    ],
    "submenus": [
      {
        "id": "openhands.editorContext",
        "label": "OpenHands"
      }
    ],
    "menus": {
      "editor/context": [
        {
          "submenu": "openhands.editorContext",
          "when": "editorTextFocus && editorHasSelection",
          "group": "navigation@90"
        }
      ],
      "openhands.editorContext": [
        {
          "command": "openhands.explainSelection",
          "when": "editorTextFocus && editorHasSelection",
          "group": "1_explain"
        }
      ]
    },
    "configuration": [
      {
        "type": "object",
        "title": "OpenHands: LLM",
        "order": 1,
        "properties": {
          "openhands.llm.profileId": {
            "type": "string",
            "default": "",
            "scope": "machine",
            "order": 0,
            "markdownDescription": "LLM profile identifier (filename stem). OpenHands loads provider/model/baseUrl/tuning from `~/.openhands/llm-profiles/<profileId>.json`.\n\nTo manage profiles and API keys, use the **LLM Profiles** view inside the OpenHands sidebar."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: Oracle",
        "order": 2,
        "properties": {
          "openhands.oracle.profileId": {
            "type": "string",
            "default": "",
            "scope": "machine",
            "order": 0,
            "markdownDescription": "LLM profile identifier (filename stem) used by the `ask_oracle` tool.\n\nWhen unset, `ask_oracle` returns an instructive error and suggests configuring this setting."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: Agent",
        "order": 3,
        "properties": {
          "openhands.agent.enableSecurityAnalyzer": {
            "type": "boolean",
            "default": true,
            "order": 1,
            "markdownDescription": "Enable LLMSecurityAnalyzer for action inspection."
          },
          "openhands.agent.debug": {
            "type": "boolean",
            "default": false,
            "order": 2,
            "markdownDescription": "Enable local-mode debug events (e.g., llm_request/tool_call_raw)."
          },
          "openhands.agent.summarizeToolCalls": {
            "type": "boolean",
            "default": false,
            "order": 3,
            "markdownDescription": "Generate short `gemini-flash` summaries for tool calls (requires a Gemini API key)."
          },
          "openhands.devBridge.enabled": {
            "type": "boolean",
            "default": false,
            "order": 4,
            "markdownDescription": "Enable webview→extension debug logging bridge (Output channel + file in extension log path)."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: Logging",
        "order": 4,
        "properties": {
          "openhands.logging.verbosity": {
            "type": "string",
            "enum": [
              "minimal",
              "verbose"
            ],
            "default": "minimal",
            "scope": "machine",
            "order": 0,
            "markdownDescription": "Controls OpenHands Output channel verbosity.\n\n- `minimal` (default): suppress routine informational lines in Production.\n- `verbose`: print more logs and auto-show the Output channel.\n\nNote: enabling `openhands.agent.debug` or `openhands.devBridge.enabled` also turns on verbose-style logging."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: Confirmation",
        "order": 7,
        "properties": {
          "openhands.confirmation.policy": {
            "type": "string",
            "enum": [
              "never",
              "always",
              "risky"
            ],
            "default": "never",
            "order": 1,
            "markdownDescription": "Action confirmation policy: never ask, always ask, or ask for risky actions."
          },
          "openhands.confirmation.risky.threshold": {
            "type": "string",
            "enum": [
              "LOW",
              "MEDIUM",
              "HIGH"
            ],
            "default": "MEDIUM",
            "order": 2,
            "markdownDescription": "Risk threshold for ConfirmRisky policy. Actions at or above this require confirmation."
          },
          "openhands.confirmation.risky.confirmUnknown": {
            "type": "boolean",
            "default": true,
            "order": 3,
            "markdownDescription": "Whether actions with UNKNOWN risk require confirmation in risky mode."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: HAL",
        "order": 5,
        "properties": {
          "openhands.hal.enabled": {
            "type": "boolean",
            "default": false,
            "order": 1,
            "markdownDescription": "Enable the HAL high-risk confirmation flow."
          },
          "openhands.hal.mode": {
            "type": "string",
            "enum": [
              "bundled",
              "tts_only",
              "voice_confirm"
            ],
            "default": "tts_only",
            "order": 2,
            "markdownDescription": "HAL mode when enabled: `bundled` (E2E/CI), `tts_only` (TTS + buttons), `voice_confirm` (TTS + mic + Gemini)."
          },
          "openhands.hal.userName": {
            "type": "string",
            "default": "Engel",
            "order": 3,
            "markdownDescription": "User name used only in templated HAL script lines."
          },
          "openhands.hal.ttsApiKey": {
            "type": "string",
            "default": "",
            "order": 4,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your HAL TTS API key securely:**\n\n[🔑 Configure HAL TTS API Key](command:openhands.setHalTtsApiKey)\n\n_(Keys are stored in secure system keychain, not in settings.json. Used for HAL voice synthesis (backend currently ElevenLabs).)_"
          },
          "openhands.hal.voiceAId": {
            "type": "string",
            "default": "",
            "order": 5,
            "markdownDescription": "TTS voice ID for HAL (voice A). (For the ElevenLabs backend, this is an ElevenLabs voice ID.)"
          },
          "openhands.hal.voiceUserId": {
            "type": "string",
            "default": "",
            "order": 6,
            "markdownDescription": "TTS voice ID for the user (voice B, used in `tts_only` mode). (For the ElevenLabs backend, this is an ElevenLabs voice ID.)"
          },
          "openhands.hal.modelId": {
            "type": "string",
            "default": "",
            "order": 7,
            "markdownDescription": "Optional TTS model id (ElevenLabs example: `eleven_turbo_v2`)."
          },
          "openhands.hal.volume": {
            "type": "number",
            "default": 1,
            "order": 8,
            "minimum": 0,
            "maximum": 1,
            "markdownDescription": "Playback volume (0.0–1.0)."
          },
          "openhands.hal.cache": {
            "type": "boolean",
            "default": true,
            "order": 9,
            "markdownDescription": "Enable caching for generated HAL TTS audio."
          },
          "openhands.hal.llmProfileId": {
            "type": "string",
            "default": "gemini-flash-hal",
            "order": 10,
            "markdownDescription": "LLM profile id used for `voice_confirm` classification (expected Gemini provider)."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: Servers",
        "order": 6,
        "properties": {
          "openhands.serverUrl": {
            "type": "string",
            "default": "",
            "order": 1,
            "markdownDescription": "OpenHands agent-server base URL. Leave blank to run in local mode."
          },
          "openhands.servers": {
            "type": "array",
            "default": [],
            "order": 2,
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                }
              },
              "required": [
                "url"
              ]
            },
            "markdownDescription": "List of saved OpenHands server URLs with optional labels."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: Conversation",
        "order": 8,
        "properties": {
          "openhands.conversation.maxIterations": {
            "type": "number",
            "default": 50,
            "order": 1,
            "markdownDescription": "Default max iterations for new conversations (server default is 500)."
          },
          "openhands.conversation.storeRoot": {
            "type": "string",
            "default": "",
            "order": 2,
            "markdownDescription": "Optional directory for local-mode conversation history/events. Leave empty to use `~/.openhands/conversations-vscode/`."
          },
          "openhands.terminal.renderProgress": {
            "type": "boolean",
            "default": true,
            "order": 3,
            "markdownDescription": "Coalesce carriage-return (\\r) progress updates in the OpenHands terminal log (keeps only the last update per line)."
          }
        }
      },
      {
        "type": "object",
        "title": "OpenHands: Secrets",
        "order": 9,
        "properties": {
          "openhands.secrets.cloudApiKey": {
            "type": "string",
            "default": "",
            "order": 1,
            "editPresentation": "singlelineText",
            "markdownDescription": "**OpenHands Cloud API Key**\n\n[🔑 Configure Cloud API Key](command:openhands.setCloudApiKey)\n\n_(Stored in secure system keychain, not in settings.json.)_\n\nNotes:\n- This is your **Cloud API Key / SaaS user token** (Device Flow `access_token`).\n- Used to authenticate to the **SaaS/app-server** as `Authorization: Bearer ...`."
          },
          "openhands.secrets.runtimeSessionApiKey": {
            "type": "string",
            "default": "",
            "order": 2,
            "editPresentation": "singlelineText",
            "markdownDescription": "**Runtime session API key (nested agent-server)**\n\n[🔑 Configure Runtime Session API Key](command:openhands.setRuntimeSessionApiKey)\n\n_(Stored in secure system keychain, not in settings.json.)_\n\nNotes:\n- This is the runtime/sandbox `session_api_key`.\n- Used to authenticate to the **nested agent-server** as `X-Session-API-Key: ...` (and currently as WS `?session_api_key=...`)."
          },
          "openhands.secrets.githubToken": {
            "type": "string",
            "default": "",
            "order": 3,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your GitHub token securely:**\n\n[🔑 Configure GitHub Token](command:openhands.setGithubToken)\n\n_(Tokens are stored in secure system keychain, not in settings.json)_"
          },
          "openhands.secrets.openaiApiKey": {
            "type": "string",
            "default": "",
            "order": 4,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your OpenAI API key securely:**\n\n[🔑 Configure OpenAI API Key](command:openhands.setOpenAiApiKey)\n\n_(Keys are stored in secure system keychain, not in settings.json. Stored as `OPENAI_API_KEY`.)_"
          },
          "openhands.secrets.anthropicApiKey": {
            "type": "string",
            "default": "",
            "order": 5,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your Anthropic API key securely:**\n\n[🔑 Configure Anthropic API Key](command:openhands.setAnthropicApiKey)\n\n_(Keys are stored in secure system keychain, not in settings.json. Stored as `ANTHROPIC_API_KEY`.)_"
          },
          "openhands.secrets.openrouterApiKey": {
            "type": "string",
            "default": "",
            "order": 6,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your OpenRouter API key securely:**\n\n[🔑 Configure OpenRouter API Key](command:openhands.setOpenRouterApiKey)\n\n_(Keys are stored in secure system keychain, not in settings.json. Stored as `OPENROUTER_API_KEY`.)_"
          },
          "openhands.secrets.litellmApiKey": {
            "type": "string",
            "default": "",
            "order": 7,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your LiteLLM Proxy API key securely:**\n\n[🔑 Configure LiteLLM Proxy API Key](command:openhands.setLiteLlmApiKey)\n\n_(Keys are stored in secure system keychain, not in settings.json. Stored as `LITELLM_API_KEY`.)_"
          },
          "openhands.secrets.geminiLlmApiKey": {
            "type": "string",
            "default": "",
            "order": 8,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your Gemini API key securely:**\n\n[🔑 Configure Gemini API Key](command:openhands.setGeminiLlmApiKey)\n\n_(Keys are stored in secure system keychain, not in settings.json. Stored as `GEMINI_API_KEY`.)_"
          },
          "openhands.secrets.customSecret1": {
            "type": "string",
            "default": "",
            "order": 10,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your custom secret 1 securely:**\n\n[🔑 Configure Custom Secret 1](command:openhands.setCustomSecret1)\n\n_(Secrets are stored in secure system keychain, not in settings.json)_"
          },
          "openhands.secrets.customSecret2": {
            "type": "string",
            "default": "",
            "order": 11,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your custom secret 2 securely:**\n\n[🔑 Configure Custom Secret 2](command:openhands.setCustomSecret2)\n\n_(Secrets are stored in secure system keychain, not in settings.json)_"
          },
          "openhands.secrets.customSecret3": {
            "type": "string",
            "default": "",
            "order": 12,
            "editPresentation": "singlelineText",
            "markdownDescription": "**To set your custom secret 3 securely:**\n\n[🔑 Configure Custom Secret 3](command:openhands.setCustomSecret3)\n\n_(Secrets are stored in secure system keychain, not in settings.json)_"
          }
        }
      }
    ],
    "viewsContainers": {
      "activitybar": [
        {
          "id": "openhands",
          "title": "OpenHands",
          "icon": "media/icons/openhands-activitybar.svg"
        }
      ]
    },
    "views": {
      "openhands": [
        {
          "id": "openhands.agent",
          "name": "Agent",
          "type": "webview",
          "icon": "media/icons/openhands-activitybar.svg"
        }
      ]
    }
  },
  "scripts": {
    "build": "npm run build -w @smolpaws/agent-sdk && npm run compile",
    "build:tailwind": "tailwindcss -i ./src/webview-src/tailwind.css -o ./src/webview-src/tailwind.gen.css --minify",
    "compile": "node esbuild.extension.mjs && npm run build:tailwind && npm run build:webview",
    "watch": "tsc -w -p . & npx tailwindcss -i ./src/webview-src/tailwind.css -o ./src/webview-src/tailwind.gen.css --watch & node --watch esbuild.webview.mjs",
    "vscode:prepublish": "npm run build",
    "package": "node scripts/run-vsce-package.cjs --readme-path README.vscode.md",
    "e2e": "node -e \"require('fs').rmSync('tests/e2e/out', { recursive: true, force: true })\" && npm run compile && tsc -p tests/e2e/tsconfig.suite.json && tsc -p tsconfig.e2e.json && mocha tests/e2e/out/**/*.test.js",
    "e2e:agent-server": "node -e \"require('fs').rmSync('tests/e2e/out', { recursive: true, force: true })\" && npm run compile && tsc -p tests/e2e/tsconfig.suite.json && tsc -p tsconfig.e2e.json && mocha \"tests/e2e/out/agentServerRemote*.test.js\"",
    "test": "npm test -w @smolpaws/agent-sdk && vitest run --dir src",
    "test:watch": "vitest",
    "typecheck": "tsc -p . && tsc -p tsconfig.webview.json",
    "lint": "npm run lint -w @smolpaws/agent-sdk && eslint src tests && npm run lint:cycles && npm run lint:duplication",
    "lint:cycles": "node scripts/check-circular-deps.mjs",
    "lint:duplication": "node scripts/check-duplication.mjs",
    "lint:fix": "eslint . --fix",
    "build:webview": "node esbuild.webview.mjs",
    "agent-server": "bash scripts/start-agent-server.sh",
    "agent-server:prepare": "PREPARE=1 bash scripts/start-agent-server.sh",
    "dev:vscode": "bash scripts/dev-vscode.sh",
    "prepare": "husky"
  },
  "bundledDependencies": [
    "ws"
  ],
  "devDependencies": {
    "@tailwindcss/cli": "^4.1.18",
    "@testing-library/jest-dom": "^6.6.3",
    "@testing-library/react": "^16.0.1",
    "@testing-library/user-event": "^14.5.2",
    "@types/mocha": "^10.0.10",
    "@types/node": "^22.18.6",
    "@types/vscode": "^1.104.0",
    "@types/ws": "^8.18.1",
    "@typescript-eslint/eslint-plugin": "^8.44.1",
    "@typescript-eslint/parser": "^8.44.1",
    "@vitest/coverage-v8": "^3.2.4",
    "@vscode/test-electron": "^2.3.9",
    "@vscode/vsce": "^3.6.1",
    "esbuild": "^0.27.1",
    "eslint": "^9.36.0",
    "eslint-plugin-react-hooks": "^7.0.1",
    "husky": "^9.1.7",
    "jscpd": "^4.0.8",
    "jsdom": "^27.3.0",
    "lint-staged": "^16.2.7",
    "madge": "^8.0.0",
    "mocha": "^10.8.2",
    "playwright-core": "^1.58.0",
    "tailwindcss": "^4.1.18",
    "ts-node": "^10.9.2",
    "typescript": "^5.9.3",
    "vitest": "^3.2.4"
  },
  "dependencies": {
    "@smolpaws/agent-sdk": "workspace:*",
    "@types/react": "^19.1.15",
    "@types/react-dom": "^19.1.9",
    "@vscode/codicons": "^0.0.36",
    "react": "^19.0.0",
    "react-dom": "^19.0.0",
    "react-markdown": "^10.1.0",
    "remark-breaks": "^4.0.0",
    "remark-gfm": "^4.0.1",
    "ws": "^8.18.3"
  },
  "overrides": {
    "diff": "8.0.3"
  }
}