hypha-debugger 0.1.0 → 0.1.2

package/dist/debugger.d.ts

@@ -11,8 +11,19 @@ export interface DebuggerConfig {
     service_name?: string;
     /** Show floating debug UI overlay. Default: true */
     show_ui?: boolean;
-    /** Service visibility. Default: "public" */
+    /** Service visibility. Overridden by require_token when not set explicitly. */
     visibility?: "public" | "protected" | "unlisted";
+    /**
+     * Whether remote callers must supply a JWT token. Default: true.
+     *
+     * true  → visibility "protected", a 24-hour token is generated and shown
+     *         in the instruction block. The URL alone is not enough.
+     *
+     * false → visibility "unlisted", a random 16-char hex suffix is appended
+     *         to the service ID so the URL itself is unguessable. No token is
+     *         needed — just keep the URL secret.
+     */
+    require_token?: boolean;
 }
 export interface DebugSession {
     /** Full service ID as registered with Hypha. */
@@ -31,12 +42,30 @@ export interface DebugSession {
 export declare class HyphaDebugger {
     private config;
     private overlay;
+    private cursor;
     private server;
     private serviceInfo;
     constructor(config: DebuggerConfig);
     start(): Promise<DebugSession>;
     destroy(): Promise<void>;
+    /**
+     * Generate token, build service URL, update overlay instructions, and
+     * return a DebugSession.
+     */
+    private updateSession;
+    /**
+     * Build a stable, predictable service URL.
+     * Strips the clientId prefix so the URL uses only the bare service name.
+     * Callers append ?_mode=last to resolve the most recent instance.
+     */
     private buildServiceUrl;
+    private getHyphaModule;
     private getConnectToServer;
+    private buildServiceDefinition;
+    private createGetSkillMd;
+    /** Build the instruction block for the overlay panel. */
+    private buildInstructionBlock;
+    /** Wrap a service function with logging and kwargs-to-positional-args support. */
+    private wrapFn;
     private summarizeArgs;
 }