refactor: replace browser-scoped client with browser routing cache

Route direct-to-VM browser requests through the shared client cache so the SDK no longer needs the generated browser session wrapper layer.

Made-with: Cursor

Author: rgarcia

examples/browser-scoped.ts

@@ -1,21 +1,23 @@
 /**
- * Browser-scoped client: call browser VM-routed browser APIs without repeating the
- * session id, and run `fetch`-style HTTP through the browser network stack.
- *
- * Run after `yarn build` so `dist/` matches sources, or import from `src/` via
- * ts-node with path aliases.
+ * Browser routing: keep the standard browser resource surface while routing
+ * allowlisted subresources and raw HTTP directly to the browser VM.
  */
 import Kernel from '@onkernel/sdk';
 
 async function main() {
-  const kernel = new Kernel();
+  const kernel = new Kernel({
+    browserRouting: {
+      enabled: true,
+      directToVMSubresources: ['computer'],
+    },
+  });
 
   const created = await kernel.browsers.create({});
-  const browser = kernel.forBrowser(created);
+  kernel.browserRouteCache.prime(created);
 
-  await browser.computer.clickMouse({ x: 10, y: 10 });
+  await kernel.browsers.computer.clickMouse(created.session_id, { x: 10, y: 10 });
 
-  const page = await browser.fetch('https://example.com', { method: 'GET' });
+  const page = await kernel.browsers.fetch(created.session_id, 'https://example.com', { method: 'GET' });
   console.log('status', page.status);
 
   await kernel.browsers.deleteByID(created.session_id);

package.json

@@ -23,7 +23,6 @@
     "prepublishOnly": "echo 'to publish, run yarn build && (cd dist; yarn publish)' && exit 1",
     "format": "./scripts/format",
     "prepare": "if ./scripts/utils/check-is-in-git-install.sh; then ./scripts/build && ./scripts/utils/git-swap.sh; fi",
-    "generate:browser-session": "ts-node -T scripts/generate-browser-session.ts",
     "tsn": "ts-node -r tsconfig-paths/register",
     "lint": "./scripts/lint",
     "fix": "./scripts/format"

scripts/build

@@ -6,9 +6,6 @@ cd "$(dirname "$0")/.."
 
 node scripts/utils/check-version.cjs
 
-./node_modules/.bin/ts-node -T scripts/generate-browser-session.ts
-./node_modules/.bin/prettier --write src/lib/generated/browser-session-bindings.ts >/dev/null
-
 # Build into dist and will publish the package from there,
 # so that src/resources/foo.ts becomes <package root>/resources/foo.js
 # This way importing from `"@onkernel/sdk/resources/foo"` works

scripts/generate-browser-session.ts

@@ -4,13 +4,6 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-echo "==> Regenerating browser session bindings"
-./node_modules/.bin/ts-node -T scripts/generate-browser-session.ts
-./node_modules/.bin/prettier --write src/lib/generated/browser-session-bindings.ts >/dev/null
-
-echo "==> Verifying generated browser session bindings are committed"
-git diff --exit-code -- src/lib/generated/browser-session-bindings.ts
-
 echo "==> Running eslint"
 ./node_modules/.bin/eslint .