Skip to content

v1.2.0 — standalone mode, Apache-2.0, and an honest tool surface

Latest

Choose a tag to compare

@t3ratech t3ratech released this 02 Sep 22:37

The bridge drives the browser you are already signed into. This release relicenses it, declares what every tool does to the world in the fields a client can read, and corrects counts that were overstated on every published listing.

Changed

  • Relicensed under Apache-2.0. Free to use, and now free to fork, redistribute and build on. The previous licence was source-available custom text that no detector recognised. NOTICE records what the grant does and does not cover: the T3rnel Browser extension is a separate proprietary product, and Apache-2.0 section 6 grants no trademark rights.
  • Every tool declares its behaviour. All 22 carry readOnlyHint, destructiveHint, idempotentHint and openWorldHint, stated honestly rather than flatteringly — session_click, session_press, session_evaluate, session_close_tab and session_record_replay are destructive, and session_snapshot is not read-only because it writes data-t3rnel-ref onto the elements it lists.
  • Every parameter is documented, with defaults, bounds, formats, patterns and examples where they exist.

Added

  • session_close_tab. The surface covered the whole browsing lifecycle except closing, so an agent could open tabs it had no way to tidy up. tabId is required: it is the only irreversible tool here, and the active tab is the one the user is looking at.

Fixed

  • session_evaluate had never worked in standalone mode. It read args.expression while its schema declares code, and validation rejects undeclared properties — so no caller could reach the value. Every standalone evaluation ran the literal string "undefined" and returned it.
  • session_wait ignored the timeout it was given, reading args.timeout against a schema declaring timeoutMs. Asking for thirty seconds silently got ten.
  • A snapshot ref could not drive the tools that consume it. Standalone emitted a bare eN while the extension emits and matches @eN, so an agent following the documentation got "Element not found" for a ref the snapshot had just produced. Both forms are now accepted.
  • The standalone tool count was overstated by eight. Every listing derived "22 tools" from the whole surface, but session_close_tab, both vault tools and the five recording tools refuse without the extension. The real figures are 14 standalone, 103 with the extension.
  • session_record_events advertised a page size of 500 while the recorder applies 100.

Install

npx -y @t3ratech/mcp-session-bridge