@jobshimo/browser-link 0.4.1 → 0.5.1

package/dist/tools/server-instructions.js

@@ -1,54 +1,54 @@
 /** Usage protocol pushed to the MCP client on `initialize`. Plain string,
  * intentionally kept short. Edit here when the protocol changes. */
-export const SERVER_INSTRUCTIONS = `browser-link bridges Claude Code to the Chrome tabs the user has
-explicitly connected through the companion extension, and ships a
-persistent UI map backed by a local SQLite DB. The data dir resolves
-per-OS via env-paths (\$XDG_DATA_HOME/browser-link on Linux,
-~/Library/Application Support/browser-link on macOS, %APPDATA%/browser-link
-on Windows). Override with \$BROWSER_LINK_DATA_DIR. The map is private
-and per-machine; never persisted in any repo.
-
-## When operating on a tab
-
-1. Before doing anything on a tab whose URL you don't already know,
-   call \`browser.map.recall\` with { origin } (and optionally url) to load
-   selectors, flows and gotchas previously learned for that app.
-2. If recall returns entries with \`failed_at\` more recent than
-   \`verified_at\`, treat them as suspect: re-verify (snapshot / evaluate)
-   before reusing, or replace them.
-3. After every interaction that used a map entry, call
-   \`browser.map.record_use\` with { entry_id, ok }. ok=true updates
-   verified_at; ok=false updates failed_at. Keep the map honest.
-4. After a non-trivial flow that worked end-to-end, persist it with
-   \`browser.map.save\`. Three \`kind\` values:
-   - selector: { selector, evidence? } — a CSS selector tied to a purpose.
-   - flow: { steps: [...] } — an ordered list of actions to reach an outcome.
-   - gotcha: { body } — free-form note about something non-obvious.
-   Use \`url_pattern\` = pathname (exact). Promote to glob only if you have
-   evidence of a parametric route. Provide \`purpose\` as a stable, reusable
-   label ("open task detail dialog", not "open IB0311 detail").
-5. Never save selectors or flows you have not just successfully executed.
-6. Never store domain data (IDs, user names, dates, etc.). The map captures
-   UI structure only.
-
-## Identifying the app
-
-- \`origin\` = scheme://host:port of the tab.
-- \`app_key\` distinguishes apps that share an origin over time. On first
-  save you may omit it; it will be derived from the page title (slugified).
-  Use \`browser.map.rename_app\` if that initial guess is poor.
-
-## When something is wrong
-
-- A selector from recall fails → record_use({ok:false}), learn the new
-  one, save it (upsert on purpose).
-- A whole app got refactored → \`browser.map.forget\` the app_id and let
-  the map repopulate as you learn the new structure.
-- A tool call fails with "Tab not connected: tab_X" → call
-  \`browser.events\` to see whether the bridge changed primary (the
-  Chrome tab probably got a new tab_id after a reconnect). Look for a
-  \`tab-renamed\` event with previous=tab_X and resume on the current id.
-
-The map is a cache of navigation, not a substitute for \`browser.snapshot\`.
+export const SERVER_INSTRUCTIONS = `browser-link bridges Claude Code to the Chrome tabs the user has
+explicitly connected through the companion extension, and ships a
+persistent UI map backed by a local SQLite DB. The data dir resolves
+per-OS via env-paths (\$XDG_DATA_HOME/browser-link on Linux,
+~/Library/Application Support/browser-link on macOS, %APPDATA%/browser-link
+on Windows). Override with \$BROWSER_LINK_DATA_DIR. The map is private
+and per-machine; never persisted in any repo.
+
+## When operating on a tab
+
+1. Before doing anything on a tab whose URL you don't already know,
+   call \`browser.map.recall\` with { origin } (and optionally url) to load
+   selectors, flows and gotchas previously learned for that app.
+2. If recall returns entries with \`failed_at\` more recent than
+   \`verified_at\`, treat them as suspect: re-verify (snapshot / evaluate)
+   before reusing, or replace them.
+3. After every interaction that used a map entry, call
+   \`browser.map.record_use\` with { entry_id, ok }. ok=true updates
+   verified_at; ok=false updates failed_at. Keep the map honest.
+4. After a non-trivial flow that worked end-to-end, persist it with
+   \`browser.map.save\`. Three \`kind\` values:
+   - selector: { selector, evidence? } — a CSS selector tied to a purpose.
+   - flow: { steps: [...] } — an ordered list of actions to reach an outcome.
+   - gotcha: { body } — free-form note about something non-obvious.
+   Use \`url_pattern\` = pathname (exact). Promote to glob only if you have
+   evidence of a parametric route. Provide \`purpose\` as a stable, reusable
+   label ("open task detail dialog", not "open IB0311 detail").
+5. Never save selectors or flows you have not just successfully executed.
+6. Never store domain data (IDs, user names, dates, etc.). The map captures
+   UI structure only.
+
+## Identifying the app
+
+- \`origin\` = scheme://host:port of the tab.
+- \`app_key\` distinguishes apps that share an origin over time. On first
+  save you may omit it; it will be derived from the page title (slugified).
+  Use \`browser.map.rename_app\` if that initial guess is poor.
+
+## When something is wrong
+
+- A selector from recall fails → record_use({ok:false}), learn the new
+  one, save it (upsert on purpose).
+- A whole app got refactored → \`browser.map.forget\` the app_id and let
+  the map repopulate as you learn the new structure.
+- A tool call fails with "Tab not connected: tab_X" → call
+  \`browser.events\` to see whether the bridge changed primary (the
+  Chrome tab probably got a new tab_id after a reconnect). Look for a
+  \`tab-renamed\` event with previous=tab_X and resume on the current id.
+
+The map is a cache of navigation, not a substitute for \`browser.snapshot\`.
 The live snapshot is always the source of truth.`;
 //# sourceMappingURL=server-instructions.js.map

package/package.json

@@ -1,70 +1,70 @@
-{
-  "name": "@jobshimo/browser-link",
-  "version": "0.4.1",
-  "description": "MCP server that bridges Claude Code, OpenCode, GitHub Copilot CLI and other MCP clients to a Chrome tab. Per-tool permissions, multi-agent mode (multiple MCP clients sharing one bridge), persistent UI map across sessions.",
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "claude",
-    "claude-code",
-    "opencode",
-    "github-copilot",
-    "copilot-cli",
-    "chrome",
-    "browser-automation",
-    "ai-tools",
-    "permissions"
-  ],
-  "homepage": "https://github.com/jobshimo/browser-link#readme",
-  "bugs": {
-    "url": "https://github.com/jobshimo/browser-link/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/jobshimo/browser-link.git",
-    "directory": "packages/server"
-  },
-  "license": "MIT",
-  "author": "Martín Miguel Bernal",
-  "type": "module",
-  "main": "./dist/index.js",
-  "bin": {
-    "browser-link": "./dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/cli.ts",
-    "try": "tsx src/cli.ts",
-    "start": "node dist/cli.js",
-    "typecheck": "tsc --noEmit",
-    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run clean && npm run build && node ./scripts/prepare-publish.mjs"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "better-sqlite3": "^11.5.0",
-    "env-paths": "^3.0.0",
-    "ink": "^5.2.1",
-    "react": "^18.3.1",
-    "ws": "^8.18.0"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.11",
-    "@types/node": "^22.0.0",
-    "@types/react": "^18.3.28",
-    "@types/ws": "^8.5.13",
-    "tsx": "^4.19.0",
-    "typescript": "^5.6.0",
-    "vitest": "^3.1.4"
-  }
-}
+{
+  "name": "@jobshimo/browser-link",
+  "version": "0.5.1",
+  "description": "MCP server that bridges Claude Code, OpenCode, GitHub Copilot CLI and other MCP clients to a Chrome tab. Per-tool permissions, multi-agent mode (multiple MCP clients sharing one bridge), persistent UI map across sessions.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "opencode",
+    "github-copilot",
+    "copilot-cli",
+    "chrome",
+    "browser-automation",
+    "ai-tools",
+    "permissions"
+  ],
+  "homepage": "https://github.com/jobshimo/browser-link#readme",
+  "bugs": {
+    "url": "https://github.com/jobshimo/browser-link/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jobshimo/browser-link.git",
+    "directory": "packages/server"
+  },
+  "license": "MIT",
+  "author": "Martín Miguel Bernal",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "browser-link": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/cli.ts",
+    "try": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run clean && npm run build && node ./scripts/prepare-publish.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^12.9.0",
+    "env-paths": "^3.0.0",
+    "ink": "^7.0.2",
+    "react": "^19.2.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.0",
+    "@types/ws": "^8.5.13",
+    "tsx": "^4.19.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  }
+}