skybridge 0.0.0-dev.f76ccdc → 0.0.0-dev.f792261

package/dist/cli/tunnel.test.js

@@ -0,0 +1,190 @@
+import { EventEmitter } from "node:events";
+import { Readable } from "node:stream";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { parseStdoutLine, TunnelManager } from "./tunnel.js";
+describe("parseStdoutLine", () => {
+    it("returns a connected event when the forwarding line is seen", () => {
+        const result = parseStdoutLine("Forwarding: https://abc.tunnel.example -> http://localhost:3000");
+        expect(result).toEqual({
+            kind: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    it("strips a trailing slash from the forwarded URL", () => {
+        const result = parseStdoutLine("Forwarding: https://abc.tunnel.example/ -> http://localhost:3000");
+        expect(result).toEqual({
+            kind: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    it("returns a starting event for any other non-empty line", () => {
+        expect(parseStdoutLine("Opening tunnel...")).toEqual({
+            kind: "starting",
+            message: "Opening tunnel...",
+        });
+    });
+    it("returns null for empty lines", () => {
+        expect(parseStdoutLine("")).toBeNull();
+        expect(parseStdoutLine("   ")).toBeNull();
+    });
+});
+function makeFakeChild() {
+    const child = new EventEmitter();
+    child.stdout = new Readable({ read() { } });
+    child.stderr = new Readable({ read() { } });
+    child.kill = vi.fn(() => true);
+    return child;
+}
+describe("TunnelManager", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("starts idle", () => {
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => makeFakeChild(),
+        });
+        expect(manager.getState()).toEqual({ status: "idle" });
+    });
+    it("transitions idle -> starting -> connected as stdout reports progress", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        const states = [];
+        manager.on("state", (s) => states.push(s.status));
+        manager.start();
+        child.stdout.emit("data", Buffer.from("Opening tunnel...\n"));
+        child.stdout.emit("data", Buffer.from("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        expect(states).toEqual(["starting", "starting", "connected"]);
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    it("emits activity events for stdout lines after connect", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        const activity = [];
+        manager.on("activity", (a) => activity.push({ text: a.text, level: a.level }));
+        manager.start();
+        child.stdout.emit("data", Buffer.from("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        child.stdout.emit("data", Buffer.from("GET /widgets/foo\n"));
+        child.stderr.emit("data", Buffer.from("connection wobble\n"));
+        expect(activity).toEqual([
+            { text: "GET /widgets/foo", level: "log" },
+            { text: "connection wobble", level: "error" },
+        ]);
+    });
+    it("calling start twice does not spawn twice", () => {
+        const spawn = vi.fn(() => makeFakeChild());
+        const manager = new TunnelManager({ getPort: () => 3000, spawn });
+        manager.start();
+        manager.start();
+        expect(spawn).toHaveBeenCalledTimes(1);
+    });
+    it("transitions to error when the connection times out", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        vi.advanceTimersByTime(60_000);
+        expect(manager.getState().status).toBe("error");
+        expect(child.kill).toHaveBeenCalled();
+    });
+    it("preserves the timeout error message when the killed child later emits close", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        vi.advanceTimersByTime(60_000);
+        // The killed child emits a non-zero close after the timeout fired.
+        child.emit("close", 1);
+        expect(manager.getState()).toEqual({
+            status: "error",
+            message: "Tunnel connection timed out after one minute",
+        });
+    });
+    it("stop() kills the subprocess and goes idle", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        manager.stop();
+        expect(child.kill).toHaveBeenCalled();
+        expect(manager.getState()).toEqual({ status: "idle" });
+    });
+    it("subscribers get the current state on subscribe", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        child.stdout.emit("data", Buffer.from("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        let received;
+        const unsubscribe = manager.subscribe((s) => {
+            received = s;
+        });
+        expect(received).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+        unsubscribe();
+    });
+    it("ignores deferred close from a child that was replaced via stop()+start()", () => {
+        const childA = makeFakeChild();
+        const childB = makeFakeChild();
+        let spawnCount = 0;
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => (spawnCount++ === 0 ? childA : childB),
+        });
+        manager.start();
+        manager.stop();
+        manager.start();
+        childB.stdout.emit("data", Buffer.from("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+        // Stale close from childA arrives only now — must not clobber state.
+        childA.emit("close", null);
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    it("ignores deferred error from a child that was replaced via stop()+start()", () => {
+        const childA = makeFakeChild();
+        const childB = makeFakeChild();
+        let spawnCount = 0;
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => (spawnCount++ === 0 ? childA : childB),
+        });
+        manager.start();
+        manager.stop();
+        manager.start();
+        childB.stdout.emit("data", Buffer.from("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        childA.emit("error", new Error("late spawn failure"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+});
+//# sourceMappingURL=tunnel.test.js.map

package/dist/cli/tunnel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.test.js","sourceRoot":"","sources":["../../src/cli/tunnel.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { Readable } from \"node:stream\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { parseStdoutLine, TunnelManager, type TunnelState } from \"./tunnel.js\";\n\ndescribe(\"parseStdoutLine\", () => {\n  it(\"returns a connected event when the forwarding line is seen\", () => {\n    const result = parseStdoutLine(\n      \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\",\n    );\n    expect(result).toEqual({\n      kind: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"strips a trailing slash from the forwarded URL\", () => {\n    const result = parseStdoutLine(\n      \"Forwarding: https://abc.tunnel.example/ -> http://localhost:3000\",\n    );\n    expect(result).toEqual({\n      kind: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"returns a starting event for any other non-empty line\", () => {\n    expect(parseStdoutLine(\"Opening tunnel...\")).toEqual({\n      kind: \"starting\",\n      message: \"Opening tunnel...\",\n    });\n  });\n\n  it(\"returns null for empty lines\", () => {\n    expect(parseStdoutLine(\"\")).toBeNull();\n    expect(parseStdoutLine(\"   \")).toBeNull();\n  });\n});\n\ntype FakeChild = EventEmitter & {\n  stdout: Readable;\n  stderr: Readable;\n  kill: ReturnType<typeof vi.fn<() => boolean>>;\n};\n\nfunction makeFakeChild(): FakeChild {\n  const child = new EventEmitter() as FakeChild;\n  child.stdout = new Readable({ read() {} });\n  child.stderr = new Readable({ read() {} });\n  child.kill = vi.fn<() => boolean>(() => true);\n  return child;\n}\n\ndescribe(\"TunnelManager\", () => {\n  beforeEach(() => {\n    vi.useFakeTimers();\n  });\n  afterEach(() => {\n    vi.useRealTimers();\n  });\n\n  it(\"starts idle\", () => {\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => makeFakeChild(),\n    });\n    expect(manager.getState()).toEqual({ status: \"idle\" });\n  });\n\n  it(\"transitions idle -> starting -> connected as stdout reports progress\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    const states: string[] = [];\n    manager.on(\"state\", (s: TunnelState) => states.push(s.status));\n\n    manager.start();\n    child.stdout.emit(\"data\", Buffer.from(\"Opening tunnel...\\n\"));\n    child.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    expect(states).toEqual([\"starting\", \"starting\", \"connected\"]);\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"emits activity events for stdout lines after connect\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    const activity: Array<{ text: string; level: string }> = [];\n    manager.on(\"activity\", (a: { text: string; level: string }) =>\n      activity.push({ text: a.text, level: a.level }),\n    );\n\n    manager.start();\n    child.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n    child.stdout.emit(\"data\", Buffer.from(\"GET /widgets/foo\\n\"));\n    child.stderr.emit(\"data\", Buffer.from(\"connection wobble\\n\"));\n\n    expect(activity).toEqual([\n      { text: \"GET /widgets/foo\", level: \"log\" },\n      { text: \"connection wobble\", level: \"error\" },\n    ]);\n  });\n\n  it(\"calling start twice does not spawn twice\", () => {\n    const spawn = vi.fn(() => makeFakeChild());\n    const manager = new TunnelManager({ getPort: () => 3000, spawn });\n    manager.start();\n    manager.start();\n    expect(spawn).toHaveBeenCalledTimes(1);\n  });\n\n  it(\"transitions to error when the connection times out\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n\n    vi.advanceTimersByTime(60_000);\n\n    expect(manager.getState().status).toBe(\"error\");\n    expect(child.kill).toHaveBeenCalled();\n  });\n\n  it(\"preserves the timeout error message when the killed child later emits close\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n\n    vi.advanceTimersByTime(60_000);\n    // The killed child emits a non-zero close after the timeout fired.\n    child.emit(\"close\", 1);\n\n    expect(manager.getState()).toEqual({\n      status: \"error\",\n      message: \"Tunnel connection timed out after one minute\",\n    });\n  });\n\n  it(\"stop() kills the subprocess and goes idle\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n    manager.stop();\n    expect(child.kill).toHaveBeenCalled();\n    expect(manager.getState()).toEqual({ status: \"idle\" });\n  });\n\n  it(\"subscribers get the current state on subscribe\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n    child.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    let received: TunnelState | undefined;\n    const unsubscribe = manager.subscribe((s) => {\n      received = s;\n    });\n    expect(received).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n    unsubscribe();\n  });\n\n  it(\"ignores deferred close from a child that was replaced via stop()+start()\", () => {\n    const childA = makeFakeChild();\n    const childB = makeFakeChild();\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => (spawnCount++ === 0 ? childA : childB),\n    });\n\n    manager.start();\n    manager.stop();\n    manager.start();\n    childB.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n\n    // Stale close from childA arrives only now — must not clobber state.\n    childA.emit(\"close\", null);\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"ignores deferred error from a child that was replaced via stop()+start()\", () => {\n    const childA = makeFakeChild();\n    const childB = makeFakeChild();\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => (spawnCount++ === 0 ? childA : childB),\n    });\n\n    manager.start();\n    manager.stop();\n    manager.start();\n    childB.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    childA.emit(\"error\", new Error(\"late spawn failure\"));\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n});\n"]}

package/dist/cli/types.d.ts

@@ -0,0 +1,5 @@
+export type Message = {
+    id: string;
+    text: string;
+    type: "log" | "restart" | "error";
+};

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Message = {\n  id: string;\n  text: string;\n  type: \"log\" | \"restart\" | \"error\";\n};\n"]}

package/dist/cli/use-execute-steps.d.ts

@@ -0,0 +1,11 @@
+export interface CommandStep {
+    label: string;
+    command?: string;
+    run?: () => void | Promise<void>;
+}
+export declare const useExecuteSteps: (steps: CommandStep[]) => {
+    currentStep: number;
+    status: "error" | "success" | "running";
+    error: string | null;
+    execute: () => Promise<void>;
+};

package/dist/cli/use-execute-steps.js

@@ -0,0 +1,36 @@
+import { useCallback, useState } from "react";
+import { runCommand } from "./run-command.js";
+export const useExecuteSteps = (steps) => {
+    const [currentStep, setCurrentStep] = useState(0);
+    const [status, setStatus] = useState("running");
+    const [error, setError] = useState(null);
+    const execute = useCallback(async () => {
+        try {
+            for (let i = 0; i < steps.length; i++) {
+                const step = steps[i];
+                if (step) {
+                    setCurrentStep(i);
+                    if (step.run) {
+                        await step.run();
+                    }
+                    if (step.command) {
+                        await runCommand(step.command);
+                    }
+                }
+            }
+            setStatus("success");
+            setImmediate(() => {
+                process.exit(0);
+            });
+        }
+        catch (err) {
+            setStatus("error");
+            setError(err instanceof Error ? err.message : String(err));
+            setImmediate(() => {
+                process.exit(1);
+            });
+        }
+    }, [steps]);
+    return { currentStep, status, error, execute };
+};
+//# sourceMappingURL=use-execute-steps.js.map

package/dist/cli/use-execute-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-execute-steps.js","sourceRoot":"","sources":["../../src/cli/use-execute-steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAoB,EAAE,EAAE;IACtD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,SAAS,CACV,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,IAAI,CAAC;YACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,EAAE,CAAC;oBACT,cAAc,CAAC,CAAC,CAAC,CAAC;oBAClB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;wBACb,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;oBACnB,CAAC;oBACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjB,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC,CAAC","sourcesContent":["import { useCallback, useState } from \"react\";\nimport { runCommand } from \"./run-command.js\";\n\nexport interface CommandStep {\n  label: string;\n  command?: string;\n  run?: () => void | Promise<void>;\n}\n\nexport const useExecuteSteps = (steps: CommandStep[]) => {\n  const [currentStep, setCurrentStep] = useState<number>(0);\n  const [status, setStatus] = useState<\"running\" | \"success\" | \"error\">(\n    \"running\",\n  );\n  const [error, setError] = useState<string | null>(null);\n\n  const execute = useCallback(async () => {\n    try {\n      for (let i = 0; i < steps.length; i++) {\n        const step = steps[i];\n        if (step) {\n          setCurrentStep(i);\n          if (step.run) {\n            await step.run();\n          }\n          if (step.command) {\n            await runCommand(step.command);\n          }\n        }\n      }\n      setStatus(\"success\");\n      setImmediate(() => {\n        process.exit(0);\n      });\n    } catch (err) {\n      setStatus(\"error\");\n      setError(err instanceof Error ? err.message : String(err));\n      setImmediate(() => {\n        process.exit(1);\n      });\n    }\n  }, [steps]);\n\n  return { currentStep, status, error, execute };\n};\n"]}

package/dist/cli/use-messages.d.ts

@@ -0,0 +1,3 @@
+import type { Message } from "./types.js";
+export type PushMessage = (text: string, type: Message["type"]) => void;
+export declare function useMessages(): [Array<Message>, PushMessage];

package/dist/cli/use-messages.js

@@ -0,0 +1,11 @@
+import { randomUUID } from "node:crypto";
+import { useCallback, useState } from "react";
+const MAX_MESSAGES = 10;
+export function useMessages() {
+    const [messages, setMessages] = useState([]);
+    const push = useCallback((text, type) => {
+        setMessages((prev) => [...prev, { id: randomUUID(), text, type }].slice(-MAX_MESSAGES));
+    }, []);
+    return [messages, push];
+}
+//# sourceMappingURL=use-messages.js.map

package/dist/cli/use-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-messages.js","sourceRoot":"","sources":["../../src/cli/use-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,MAAM,YAAY,GAAG,EAAE,CAAC;AAIxB,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAiB,EAAE,CAAC,CAAC;IAE7D,MAAM,IAAI,GAAG,WAAW,CAAc,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACnD,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CACjE,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { useCallback, useState } from \"react\";\nimport type { Message } from \"./types.js\";\n\nconst MAX_MESSAGES = 10;\n\nexport type PushMessage = (text: string, type: Message[\"type\"]) => void;\n\nexport function useMessages(): [Array<Message>, PushMessage] {\n  const [messages, setMessages] = useState<Array<Message>>([]);\n\n  const push = useCallback<PushMessage>((text, type) => {\n    setMessages((prev) =>\n      [...prev, { id: randomUUID(), text, type }].slice(-MAX_MESSAGES),\n    );\n  }, []);\n\n  return [messages, push];\n}\n"]}

package/dist/cli/use-nodemon.d.ts

@@ -0,0 +1,2 @@
+import type { PushMessage } from "./use-messages.js";
+export declare function useNodemon(env: NodeJS.ProcessEnv, pushMessage: PushMessage): void;

package/dist/cli/use-nodemon.js

@@ -0,0 +1,73 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import nodemonOriginal from "nodemon";
+import { useEffect } from "react";
+const nodemon = nodemonOriginal;
+const SOURCEMAP_WARNING = /^Sourcemap for ".*" points to missing source files$/;
+export function useNodemon(env, pushMessage) {
+    useEffect(() => {
+        const configFile = resolve(process.cwd(), "nodemon.json");
+        const config = existsSync(configFile)
+            ? {
+                configFile,
+            }
+            : {
+                watch: ["src"],
+                ext: "ts,json",
+                exec: "tsx src/server.ts",
+            };
+        nodemon({ ...config, env, stdout: false });
+        const handleStdoutData = (chunk) => {
+            const message = chunk.toString().trim();
+            if (message) {
+                pushMessage(message, "log");
+            }
+        };
+        const handleStderrData = (chunk) => {
+            const message = chunk.toString().trim();
+            if (!message) {
+                return;
+            }
+            // Node's source-map warnings for third-party deps (superjson, @mcp/sdk, …) — not actionable.
+            const filtered = message
+                .split("\n")
+                .filter((line) => !SOURCEMAP_WARNING.test(line))
+                .join("\n");
+            if (filtered) {
+                pushMessage(filtered, "error");
+            }
+        };
+        const setupStdoutListener = () => {
+            if (nodemon.stdout) {
+                nodemon.stdout.off("data", handleStdoutData);
+                nodemon.stdout.on("data", handleStdoutData);
+            }
+        };
+        const setupStderrListener = () => {
+            if (nodemon.stderr) {
+                nodemon.stderr.off("data", handleStderrData);
+                nodemon.stderr.on("data", handleStderrData);
+            }
+        };
+        nodemon.on("readable", () => {
+            setupStdoutListener();
+            setupStderrListener();
+        });
+        nodemon.on("restart", (files) => {
+            const restartMessage = `Server restarted due to file changes: ${files.join(", ")}`;
+            pushMessage(restartMessage, "restart");
+            setupStdoutListener();
+            setupStderrListener();
+        });
+        return () => {
+            if (nodemon.stdout) {
+                nodemon.stdout.off("data", handleStdoutData);
+            }
+            if (nodemon.stderr) {
+                nodemon.stderr.off("data", handleStderrData);
+            }
+            nodemon.emit("quit");
+        };
+    }, [env, pushMessage]);
+}
+//# sourceMappingURL=use-nodemon.js.map

package/dist/cli/use-nodemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nodemon.js","sourceRoot":"","sources":["../../src/cli/use-nodemon.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport nodemonOriginal from \"nodemon\";\nimport { useEffect } from \"react\";\nimport type { ExtendedNodemon } from \"./nodemon.d.ts\";\nimport type { PushMessage } from \"./use-messages.js\";\n\nconst nodemon = nodemonOriginal as ExtendedNodemon;\n\nconst SOURCEMAP_WARNING = /^Sourcemap for \".*\" points to missing source files$/;\n\nexport function useNodemon(\n  env: NodeJS.ProcessEnv,\n  pushMessage: PushMessage,\n): void {\n  useEffect(() => {\n    const configFile = resolve(process.cwd(), \"nodemon.json\");\n\n    const config = existsSync(configFile)\n      ? {\n          configFile,\n        }\n      : {\n          watch: [\"src\"],\n          ext: \"ts,json\",\n          exec: \"tsx src/server.ts\",\n        };\n\n    nodemon({ ...config, env, stdout: false });\n\n    const handleStdoutData = (chunk: Buffer) => {\n      const message = chunk.toString().trim();\n      if (message) {\n        pushMessage(message, \"log\");\n      }\n    };\n\n    const handleStderrData = (chunk: Buffer) => {\n      const message = chunk.toString().trim();\n      if (!message) {\n        return;\n      }\n      // Node's source-map warnings for third-party deps (superjson, @mcp/sdk, …) — not actionable.\n      const filtered = message\n        .split(\"\\n\")\n        .filter((line) => !SOURCEMAP_WARNING.test(line))\n        .join(\"\\n\");\n      if (filtered) {\n        pushMessage(filtered, \"error\");\n      }\n    };\n\n    const setupStdoutListener = () => {\n      if (nodemon.stdout) {\n        nodemon.stdout.off(\"data\", handleStdoutData);\n        nodemon.stdout.on(\"data\", handleStdoutData);\n      }\n    };\n\n    const setupStderrListener = () => {\n      if (nodemon.stderr) {\n        nodemon.stderr.off(\"data\", handleStderrData);\n        nodemon.stderr.on(\"data\", handleStderrData);\n      }\n    };\n\n    nodemon.on(\"readable\", () => {\n      setupStdoutListener();\n      setupStderrListener();\n    });\n\n    nodemon.on(\"restart\", (files: string[]) => {\n      const restartMessage = `Server restarted due to file changes: ${files.join(\", \")}`;\n      pushMessage(restartMessage, \"restart\");\n      setupStdoutListener();\n      setupStderrListener();\n    });\n\n    return () => {\n      if (nodemon.stdout) {\n        nodemon.stdout.off(\"data\", handleStdoutData);\n      }\n      if (nodemon.stderr) {\n        nodemon.stderr.off(\"data\", handleStderrData);\n      }\n      nodemon.emit(\"quit\");\n    };\n  }, [env, pushMessage]);\n}\n"]}

package/dist/cli/use-open-browser.d.ts

@@ -0,0 +1 @@
+export declare function useOpenBrowser(port: number, enabled: boolean): void;

package/dist/cli/use-open-browser.js

@@ -0,0 +1,44 @@
+import net from "node:net";
+import open from "open";
+import { useEffect, useRef } from "react";
+const POLL_INTERVAL_MS = 200;
+const POLL_TIMEOUT_MS = 5_000;
+const isPortListening = (port) => new Promise((resolve) => {
+    const socket = net.createConnection({ port, host: "127.0.0.1" });
+    socket.once("connect", () => {
+        socket.end();
+        resolve(true);
+    });
+    socket.once("error", () => {
+        socket.destroy();
+        resolve(false);
+    });
+});
+export function useOpenBrowser(port, enabled) {
+    const opened = useRef(false);
+    useEffect(() => {
+        if (!enabled || opened.current) {
+            return;
+        }
+        let cancelled = false;
+        const deadline = Date.now() + POLL_TIMEOUT_MS;
+        const tick = async () => {
+            while (!cancelled && Date.now() < deadline) {
+                if (await isPortListening(port)) {
+                    if (cancelled || opened.current) {
+                        return;
+                    }
+                    opened.current = true;
+                    await open(`http://localhost:${port}/`).catch(() => { });
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+            }
+        };
+        void tick();
+        return () => {
+            cancelled = true;
+        };
+    }, [port, enabled]);
+}
+//# sourceMappingURL=use-open-browser.js.map

package/dist/cli/use-open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-open-browser.js","sourceRoot":"","sources":["../../src/cli/use-open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,MAAM,eAAe,GAAG,CAAC,IAAY,EAAoB,EAAE,CACzD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAgB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;QAE9C,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAC3C,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChC,IAAI,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;wBAChC,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;oBACtB,MAAM,IAAI,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACxD,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,IAAI,EAAE,CAAC;QAEZ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACtB,CAAC","sourcesContent":["import net from \"node:net\";\nimport open from \"open\";\nimport { useEffect, useRef } from \"react\";\n\nconst POLL_INTERVAL_MS = 200;\nconst POLL_TIMEOUT_MS = 5_000;\n\nconst isPortListening = (port: number): Promise<boolean> =>\n  new Promise((resolve) => {\n    const socket = net.createConnection({ port, host: \"127.0.0.1\" });\n    socket.once(\"connect\", () => {\n      socket.end();\n      resolve(true);\n    });\n    socket.once(\"error\", () => {\n      socket.destroy();\n      resolve(false);\n    });\n  });\n\nexport function useOpenBrowser(port: number, enabled: boolean): void {\n  const opened = useRef(false);\n\n  useEffect(() => {\n    if (!enabled || opened.current) {\n      return;\n    }\n\n    let cancelled = false;\n    const deadline = Date.now() + POLL_TIMEOUT_MS;\n\n    const tick = async () => {\n      while (!cancelled && Date.now() < deadline) {\n        if (await isPortListening(port)) {\n          if (cancelled || opened.current) {\n            return;\n          }\n          opened.current = true;\n          await open(`http://localhost:${port}/`).catch(() => {});\n          return;\n        }\n        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));\n      }\n    };\n\n    void tick();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [port, enabled]);\n}\n"]}

package/dist/cli/use-tunnel.d.ts

@@ -0,0 +1,14 @@
+import type { PushMessage } from "./use-messages.js";
+export type TunnelState = {
+    status: "idle";
+} | {
+    status: "starting";
+    message: string;
+} | {
+    status: "connected";
+    url: string;
+} | {
+    status: "error";
+    message: string;
+};
+export declare function useTunnel(port: number | null, pushMessage: PushMessage, verbose: boolean, autoStart: boolean): TunnelState;

package/dist/cli/use-tunnel.js

@@ -0,0 +1,131 @@
+import { useEffect, useState } from "react";
+const POST_RETRY_DELAY_MS = 250;
+export function useTunnel(port, pushMessage, verbose, autoStart) {
+    const [state, setState] = useState(port !== null && autoStart
+        ? { status: "starting", message: "Starting tunnel…" }
+        : { status: "idle" });
+    useEffect(() => {
+        if (port === null) {
+            return;
+        }
+        const baseUrl = `http://localhost:${port}`;
+        const controller = new AbortController();
+        let cancelled = false;
+        const pushLog = (text, type) => {
+            const time = new Date().toLocaleTimeString("en-US", {
+                hour: "numeric",
+                minute: "2-digit",
+                second: "2-digit",
+                hour12: true,
+            });
+            pushMessage(`${time} [tunnel] ${text}`, type);
+        };
+        const handleEvent = (event, data) => {
+            if (event === "state") {
+                const next = JSON.parse(data);
+                setState(next);
+                return;
+            }
+            if (event === "activity") {
+                if (!verbose) {
+                    return;
+                }
+                const activity = JSON.parse(data);
+                pushLog(activity.text, activity.level);
+            }
+        };
+        const consumeSse = async () => {
+            const res = await fetch(`${baseUrl}/__skybridge/tunnel/events`, {
+                signal: controller.signal,
+                headers: { Accept: "text/event-stream" },
+            });
+            if (!res.ok || !res.body) {
+                throw new Error(`SSE connection failed (${res.status})`);
+            }
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            while (!cancelled) {
+                const { value, done } = await reader.read();
+                if (done) {
+                    return;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                // SSE frames are separated by a blank line ("\n\n").
+                let sep = buffer.indexOf("\n\n");
+                while (sep !== -1) {
+                    const frame = buffer.slice(0, sep);
+                    buffer = buffer.slice(sep + 2);
+                    let eventName = "message";
+                    const dataLines = [];
+                    for (const rawLine of frame.split("\n")) {
+                        const line = rawLine.replace(/\r$/, "");
+                        if (line.startsWith("event:")) {
+                            eventName = line.slice(6).trim();
+                        }
+                        else if (line.startsWith("data:")) {
+                            dataLines.push(line.slice(5).trimStart());
+                        }
+                    }
+                    if (dataLines.length > 0) {
+                        handleEvent(eventName, dataLines.join("\n"));
+                    }
+                    sep = buffer.indexOf("\n\n");
+                }
+            }
+        };
+        const postUntilStarted = async () => {
+            // Retry indefinitely until POST lands once. Bounded by the effect
+            // lifetime via controller.abort() on unmount. Once the manager has
+            // been started, this returns and never POSTs again — a user-driven
+            // DELETE /tunnel won't be auto-undone.
+            while (!cancelled) {
+                try {
+                    const res = await fetch(`${baseUrl}/__skybridge/tunnel`, {
+                        method: "POST",
+                        signal: controller.signal,
+                    });
+                    if (res.ok) {
+                        return;
+                    }
+                }
+                catch {
+                    // dev server not up yet (or restarting under nodemon) — wait, retry
+                }
+                await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));
+            }
+        };
+        // Always observe the tunnel state so external triggers (curl, future
+        // devtools UI) update the cli UI. `autoStart` only decides whether we
+        // also POST /tunnel on mount. Reconnects indefinitely so we survive
+        // dev-server boot delay and nodemon restarts; the cli owns the actual
+        // subprocess so a temporarily-unreachable dev server is fine.
+        const observe = async () => {
+            while (!cancelled) {
+                try {
+                    await consumeSse();
+                }
+                catch {
+                    // network error or stream ended abnormally — fall through to retry
+                }
+                if (cancelled) {
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));
+            }
+        };
+        // observe() always runs — it owns the cli's view of tunnel state. POST is
+        // a fire-and-forget side-effect that nudges the manager into starting and
+        // retries until it lands at least once.
+        if (autoStart) {
+            void postUntilStarted();
+        }
+        void observe();
+        return () => {
+            cancelled = true;
+            controller.abort();
+        };
+    }, [port, pushMessage, verbose, autoStart]);
+    return state;
+}
+//# sourceMappingURL=use-tunnel.js.map

package/dist/cli/use-tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tunnel.js","sourceRoot":"","sources":["../../src/cli/use-tunnel.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { PushMessage } from \"./use-messages.js\";\n\nexport type TunnelState =\n  | { status: \"idle\" }\n  | { status: \"starting\"; message: string }\n  | { status: \"connected\"; url: string }\n  | { status: \"error\"; message: string };\n\ntype TunnelActivity = {\n  time: string;\n  text: string;\n  level: \"log\" | \"error\";\n};\n\nconst POST_RETRY_DELAY_MS = 250;\n\nexport function useTunnel(\n  port: number | null,\n  pushMessage: PushMessage,\n  verbose: boolean,\n  autoStart: boolean,\n): TunnelState {\n  const [state, setState] = useState<TunnelState>(\n    port !== null && autoStart\n      ? { status: \"starting\", message: \"Starting tunnel…\" }\n      : { status: \"idle\" },\n  );\n\n  useEffect(() => {\n    if (port === null) {\n      return;\n    }\n\n    const baseUrl = `http://localhost:${port}`;\n    const controller = new AbortController();\n    let cancelled = false;\n\n    const pushLog = (text: string, type: \"log\" | \"error\") => {\n      const time = new Date().toLocaleTimeString(\"en-US\", {\n        hour: \"numeric\",\n        minute: \"2-digit\",\n        second: \"2-digit\",\n        hour12: true,\n      });\n      pushMessage(`${time} [tunnel] ${text}`, type);\n    };\n\n    const handleEvent = (event: string, data: string) => {\n      if (event === \"state\") {\n        const next = JSON.parse(data) as TunnelState;\n        setState(next);\n        return;\n      }\n      if (event === \"activity\") {\n        if (!verbose) {\n          return;\n        }\n        const activity = JSON.parse(data) as TunnelActivity;\n        pushLog(activity.text, activity.level);\n      }\n    };\n\n    const consumeSse = async () => {\n      const res = await fetch(`${baseUrl}/__skybridge/tunnel/events`, {\n        signal: controller.signal,\n        headers: { Accept: \"text/event-stream\" },\n      });\n      if (!res.ok || !res.body) {\n        throw new Error(`SSE connection failed (${res.status})`);\n      }\n\n      const reader = res.body.getReader();\n      const decoder = new TextDecoder();\n      let buffer = \"\";\n\n      while (!cancelled) {\n        const { value, done } = await reader.read();\n        if (done) {\n          return;\n        }\n        buffer += decoder.decode(value, { stream: true });\n\n        // SSE frames are separated by a blank line (\"\\n\\n\").\n        let sep = buffer.indexOf(\"\\n\\n\");\n        while (sep !== -1) {\n          const frame = buffer.slice(0, sep);\n          buffer = buffer.slice(sep + 2);\n          let eventName = \"message\";\n          const dataLines: string[] = [];\n          for (const rawLine of frame.split(\"\\n\")) {\n            const line = rawLine.replace(/\\r$/, \"\");\n            if (line.startsWith(\"event:\")) {\n              eventName = line.slice(6).trim();\n            } else if (line.startsWith(\"data:\")) {\n              dataLines.push(line.slice(5).trimStart());\n            }\n          }\n          if (dataLines.length > 0) {\n            handleEvent(eventName, dataLines.join(\"\\n\"));\n          }\n          sep = buffer.indexOf(\"\\n\\n\");\n        }\n      }\n    };\n\n    const postUntilStarted = async () => {\n      // Retry indefinitely until POST lands once. Bounded by the effect\n      // lifetime via controller.abort() on unmount. Once the manager has\n      // been started, this returns and never POSTs again — a user-driven\n      // DELETE /tunnel won't be auto-undone.\n      while (!cancelled) {\n        try {\n          const res = await fetch(`${baseUrl}/__skybridge/tunnel`, {\n            method: \"POST\",\n            signal: controller.signal,\n          });\n          if (res.ok) {\n            return;\n          }\n        } catch {\n          // dev server not up yet (or restarting under nodemon) — wait, retry\n        }\n        await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));\n      }\n    };\n\n    // Always observe the tunnel state so external triggers (curl, future\n    // devtools UI) update the cli UI. `autoStart` only decides whether we\n    // also POST /tunnel on mount. Reconnects indefinitely so we survive\n    // dev-server boot delay and nodemon restarts; the cli owns the actual\n    // subprocess so a temporarily-unreachable dev server is fine.\n    const observe = async () => {\n      while (!cancelled) {\n        try {\n          await consumeSse();\n        } catch {\n          // network error or stream ended abnormally — fall through to retry\n        }\n        if (cancelled) {\n          return;\n        }\n        await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));\n      }\n    };\n\n    // observe() always runs — it owns the cli's view of tunnel state. POST is\n    // a fire-and-forget side-effect that nudges the manager into starting and\n    // retries until it lands at least once.\n    if (autoStart) {\n      void postUntilStarted();\n    }\n    void observe();\n\n    return () => {\n      cancelled = true;\n      controller.abort();\n    };\n  }, [port, pushMessage, verbose, autoStart]);\n\n  return state;\n}\n"]}