hypha-debugger 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -11,10 +11,25 @@
  * Programmatic usage:
  *   import { startDebugger } from 'hypha-debugger';
  *   const session = await startDebugger({ server_url: 'https://hypha.aicell.io' });
+ *
+ * Library usage (import individual functions):
+ *   import { getPageInfo, clickElement, wrapFn, PageController } from 'hypha-debugger';
  */
 export { HyphaDebugger } from "./debugger.js";
 export type { DebuggerConfig, DebugSession } from "./debugger.js";
+export { getPageInfo, getConsoleLogs, installConsoleCapture } from "./services/info.js";
+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 { getReactTree } from "./services/react.js";
+export { getBrowserState, clickElementByIndex, inputText, selectOption, scroll, removeHighlights, disposeController, } from "./services/page-controller.js";
+export { generateSkillMd } from "./services/skill.js";
+export { wrapFn } from "./utils/wrap-fn.js";
+export { AICursor } from "./ui/cursor.js";
+export { PageController } from "./page-controller/index.js";
 export type { PageInfo } from "./utils/env.js";
+export type { FlatDomTree, DomNode, TextDomNode, ElementDomNode, InteractiveElementDomNode, } from "./page-controller/types.js";
 import { type DebuggerConfig, type DebugSession } from "./debugger.js";
 /**
  * Start the Hypha debugger. Connects to a Hypha server and registers

package/dist/services/navigate.d.ts

@@ -1,5 +1,15 @@
 /**
- * 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.
  */
 export declare function navigate(url: string): {
     success: boolean;

package/dist/utils/wrap-fn.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Wrap a function with correct, unminified parameter names for hypha-rpc.
+ *
+ * In production builds, Babel/Terser minifies parameter names (e.g. 'code' → 'e').
+ * hypha-rpc's getParamNames() parses Function.toString() to map kwargs to
+ * positional args. With minified names, kwargs like {code: '...'} can't be
+ * mapped and args are silently dropped.
+ *
+ * This helper uses new Function() to create a wrapper whose parameter names
+ * are taken from the function's __schema__ property, so hypha-rpc always sees
+ * the real parameter names regardless of minification.
+ */
+export declare function wrapFn(fn: any): any;

package/package.json

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