hypha-debugger 0.1.4 → 0.1.6

package/dist/index.d.ts

@@ -21,7 +21,7 @@ export { getPageInfo, getConsoleLogs, installConsoleCapture } from "./services/i
 export { queryDom, clickElement, fillInput, scrollTo, getHtml, getComputedStyles, getElementBounds, } from "./services/dom.js";
 export { takeScreenshot } from "./services/screenshot.js";
 export { executeScript } from "./services/execute.js";
-export { navigate, goBack, goForward, reload } from "./services/navigate.js";
+export { navigate, goBack, goForward, reload, softReplace, installNavigationInterceptor } from "./services/navigate.js";
 export { getReactTree } from "./services/react.js";
 export { getBrowserState, clickElementByIndex, inputText, selectOption, scroll, removeHighlights, disposeController, } from "./services/page-controller.js";
 export { generateSkillMd } from "./services/skill.js";

package/dist/services/navigate.d.ts

@@ -1,6 +1,30 @@
 /**
- * Navigation service.
+ * Navigation service with auto-reconnect support.
+ *
+ * For agent-triggered reload() and same-origin navigate(), we use a "soft"
+ * approach: fetch the target HTML, inject the debugger <script> tag, then
+ * replace the document via document.write(). The injected script auto-starts
+ * from sessionStorage config, so the debugger reconnects with the same
+ * workspace and service ID. The agent's URL stays stable.
+ *
+ * For cross-origin navigate(), goBack(), and goForward(), we fall back to
+ * normal navigation. The debugger config is saved to sessionStorage so
+ * re-clicking the bookmarklet reconnects seamlessly.
  */
+/**
+ * Perform a soft page replacement: fetch HTML, inject debugger script,
+ * replace the document via document.write(). If the fetch or write fails,
+ * falls back to hard navigation.
+ */
+export declare function softReplace(url: string, pushState?: string): void;
+/**
+ * Install global listeners that intercept same-origin link clicks and
+ * form submissions, routing them through soft navigation so the debugger
+ * stays connected.
+ *
+ * Called once from HyphaDebugger.start().
+ */
+export declare function installNavigationInterceptor(): () => void;
 export declare function navigate(url: string): {
     success: boolean;
     message: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hypha-debugger",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Injectable debugger for web pages and AI agents, powered by Hypha RPC",
   "type": "module",
   "main": "dist/hypha-debugger.js",