skybridge 0.0.0-dev.dc7c664 → 0.0.0-dev.dc90b1c

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" | "running" | "success";
+    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,26 @@
+import type { PushMessage } from "./use-messages.js";
+export declare const CRASH_MESSAGE = "\uD83D\uDCA5  Server crashed. Fix the error, then save a watched file to restart it.";
+export interface NodemonHandlers {
+    /** A raw chunk of server stdout, forwarded untouched. */
+    onStdout: (chunk: Buffer) => void;
+    /** A (filtered) chunk of server stderr. */
+    onStderr: (message: string) => void;
+    /** The server restarted because the listed files changed. */
+    onRestart: (files: string[]) => void;
+    /**
+     * The server exited with a non-zero code. nodemon does not restart it on its
+     * own: it waits for the next file change.
+     */
+    onCrash: () => void;
+}
+/**
+ * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a
+ * cleanup function that detaches the listeners and quits nodemon. Shared by the
+ * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.
+ */
+export declare function startNodemon(env: NodeJS.ProcessEnv, handlers: NodemonHandlers): () => void;
+/**
+ * Boot nodemon for the Ink dev UI. Returns whether the server is currently
+ * down after a crash, so the UI can stop advertising a URL nothing listens on.
+ */
+export declare function useNodemon(env: NodeJS.ProcessEnv, pushMessage: PushMessage): boolean;

package/dist/cli/use-nodemon.js

@@ -0,0 +1,106 @@
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { useEffect, useState } from "react";
+function loadNodemon() {
+    try {
+        return createRequire(import.meta.url)("nodemon");
+    }
+    catch {
+        throw new Error('skybridge dev needs the "nodemon" peer dependency. Install it with `npm install -D nodemon`.');
+    }
+}
+export const CRASH_MESSAGE = "💥  Server crashed. Fix the error, then save a watched file to restart it.";
+const SOURCEMAP_WARNING = /^Sourcemap for ".*" points to missing source files$/;
+/**
+ * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a
+ * cleanup function that detaches the listeners and quits nodemon. Shared by the
+ * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.
+ */
+export function startNodemon(env, handlers) {
+    const nodemon = loadNodemon();
+    const configFile = resolve(process.cwd(), "nodemon.json");
+    const config = existsSync(configFile)
+        ? {
+            configFile,
+        }
+        : {
+            watch: ["src"],
+            ext: "ts,json,md",
+            exec: "tsx src/index.ts",
+        };
+    nodemon({ ...config, env, stdout: false });
+    const handleStdoutData = (chunk) => {
+        handlers.onStdout(chunk);
+    };
+    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) {
+            handlers.onStderr(filtered);
+        }
+    };
+    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);
+        }
+    };
+    const reattachListeners = () => {
+        setupStdoutListener();
+        setupStderrListener();
+    };
+    nodemon.on("readable", reattachListeners);
+    nodemon.on("crash", () => {
+        handlers.onCrash();
+    });
+    nodemon.on("restart", (files) => {
+        handlers.onRestart(files);
+        reattachListeners();
+    });
+    return () => {
+        if (nodemon.stdout) {
+            nodemon.stdout.off("data", handleStdoutData);
+        }
+        if (nodemon.stderr) {
+            nodemon.stderr.off("data", handleStderrData);
+        }
+        nodemon.emit("quit");
+    };
+}
+/**
+ * Boot nodemon for the Ink dev UI. Returns whether the server is currently
+ * down after a crash, so the UI can stop advertising a URL nothing listens on.
+ */
+export function useNodemon(env, pushMessage) {
+    const [crashed, setCrashed] = useState(false);
+    useEffect(() => startNodemon(env, {
+        onStdout: (chunk) => {
+            const message = chunk.toString().trim();
+            if (message) {
+                pushMessage(message, "log");
+            }
+        },
+        onStderr: (message) => pushMessage(message, "error"),
+        onRestart: (files) => {
+            setCrashed(false);
+            pushMessage(`Server restarted due to file changes: ${files.join(", ")}`, "restart");
+        },
+        onCrash: () => setCrashed(true),
+    }), [env, pushMessage]);
+    return crashed;
+}
+//# 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 { createRequire } from \"node:module\";\nimport { resolve } from \"node:path\";\nimport { useEffect, useState } from \"react\";\nimport type { ExtendedNodemon } from \"./nodemon.d.ts\";\nimport type { PushMessage } from \"./use-messages.js\";\n\nfunction loadNodemon(): ExtendedNodemon {\n  try {\n    return createRequire(import.meta.url)(\"nodemon\") as ExtendedNodemon;\n  } catch {\n    throw new Error(\n      'skybridge dev needs the \"nodemon\" peer dependency. Install it with `npm install -D nodemon`.',\n    );\n  }\n}\n\nexport const CRASH_MESSAGE =\n  \"💥  Server crashed. Fix the error, then save a watched file to restart it.\";\n\nconst SOURCEMAP_WARNING = /^Sourcemap for \".*\" points to missing source files$/;\n\nexport interface NodemonHandlers {\n  /** A raw chunk of server stdout, forwarded untouched. */\n  onStdout: (chunk: Buffer) => void;\n  /** A (filtered) chunk of server stderr. */\n  onStderr: (message: string) => void;\n  /** The server restarted because the listed files changed. */\n  onRestart: (files: string[]) => void;\n  /**\n   * The server exited with a non-zero code. nodemon does not restart it on its\n   * own: it waits for the next file change.\n   */\n  onCrash: () => void;\n}\n\n/**\n * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a\n * cleanup function that detaches the listeners and quits nodemon. Shared by the\n * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.\n */\nexport function startNodemon(\n  env: NodeJS.ProcessEnv,\n  handlers: NodemonHandlers,\n): () => void {\n  const nodemon = loadNodemon();\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,md\",\n        exec: \"tsx src/index.ts\",\n      };\n\n  nodemon({ ...config, env, stdout: false });\n\n  const handleStdoutData = (chunk: Buffer) => {\n    handlers.onStdout(chunk);\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      handlers.onStderr(filtered);\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  const reattachListeners = () => {\n    setupStdoutListener();\n    setupStderrListener();\n  };\n\n  nodemon.on(\"readable\", reattachListeners);\n\n  nodemon.on(\"crash\", () => {\n    handlers.onCrash();\n  });\n\n  nodemon.on(\"restart\", (files: string[]) => {\n    handlers.onRestart(files);\n    reattachListeners();\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}\n\n/**\n * Boot nodemon for the Ink dev UI. Returns whether the server is currently\n * down after a crash, so the UI can stop advertising a URL nothing listens on.\n */\nexport function useNodemon(\n  env: NodeJS.ProcessEnv,\n  pushMessage: PushMessage,\n): boolean {\n  const [crashed, setCrashed] = useState(false);\n\n  useEffect(\n    () =>\n      startNodemon(env, {\n        onStdout: (chunk) => {\n          const message = chunk.toString().trim();\n          if (message) {\n            pushMessage(message, \"log\");\n          }\n        },\n        onStderr: (message) => pushMessage(message, \"error\"),\n        onRestart: (files) => {\n          setCrashed(false);\n          pushMessage(\n            `Server restarted due to file changes: ${files.join(\", \")}`,\n            \"restart\",\n          );\n        },\n        onCrash: () => setCrashed(true),\n      }),\n    [env, pushMessage],\n  );\n\n  return crashed;\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":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAe5C,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,UAAU,SAAS,CACvB,IAAmB,EACnB,WAAwB,EACxB,OAAgB,EAChB,SAAkB;IAElB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAChC,IAAI,KAAK,IAAI,IAAI,SAAS;QACxB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE;QACrD,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CACvB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,IAAI,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,IAAqB,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE;gBAClD,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YACH,WAAW,CAAC,GAAG,IAAI,aAAa,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE;YAClD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,OAAO;YACT,CAAC;YACD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO;gBACT,CAAC;gBACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;gBACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;YAC5B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,4BAA4B,EAAE;gBAC9D,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE;aACzC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,OAAO,CAAC,SAAS,EAAE,CAAC;gBAClB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAElD,qDAAqD;gBACrD,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACjC,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACnC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;oBAC/B,IAAI,SAAS,GAAG,SAAS,CAAC;oBAC1B,MAAM,SAAS,GAAa,EAAE,CAAC;oBAC/B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;wBACxC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACxC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;4BAC9B,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;wBACnC,CAAC;6BAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;4BACpC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;wBAC5C,CAAC;oBACH,CAAC;oBACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC/C,CAAC;oBACD,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,KAAK,IAAI,EAAE;YAClC,kEAAkE;YAClE,mEAAmE;YACnE,mEAAmE;YACnE,uCAAuC;YACvC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,qBAAqB,EAAE;wBACvD,MAAM,EAAE,MAAM;wBACd,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B,CAAC,CAAC;oBACH,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;wBACX,OAAO;oBACT,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,oEAAoE;gBACtE,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC;QAEF,qEAAqE;QACrE,sEAAsE;QACtE,oEAAoE;QACpE,sEAAsE;QACtE,8DAA8D;QAC9D,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,OAAO,CAAC,SAAS,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,MAAM,UAAU,EAAE,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,mEAAmE;gBACrE,CAAC;gBACD,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC;QAEF,0EAA0E;QAC1E,0EAA0E;QAC1E,wCAAwC;QACxC,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,gBAAgB,EAAE,CAAC;QAC1B,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;QAEf,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAE5C,OAAO,KAAK,CAAC;AACf,CAAC","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"]}

package/dist/cli/use-typescript-check.d.ts

@@ -0,0 +1,15 @@
+export type TsError = {
+    file: string;
+    line: number;
+    col: number;
+    code: string;
+    message: string;
+};
+/**
+ * Spawn `tsc --noEmit --watch` and report each completed check via `onErrors`
+ * (empty array when the check is clean). Returns a cleanup function that kills
+ * the watcher. Shared by the Ink-based dev UI (via {@link useTypeScriptCheck})
+ * and the `--plain` runner.
+ */
+export declare function startTypeScriptCheck(onErrors: (errors: Array<TsError>) => void): () => void;
+export declare function useTypeScriptCheck(): Array<TsError>;

package/dist/cli/use-typescript-check.js

@@ -0,0 +1,97 @@
+import { isAbsolute, relative } from "node:path";
+import spawn from "cross-spawn";
+import { useEffect, useState } from "react";
+// TypeScript nests from general to specific — the deepest line is the root cause.
+function extractBestMessage(message, continuationLines) {
+    if (!continuationLines.length) {
+        return message;
+    }
+    let maxIndent = 0;
+    for (const line of continuationLines) {
+        const indent = line.length - line.trimStart().length;
+        if (indent > maxIndent) {
+            maxIndent = indent;
+        }
+    }
+    const deepest = continuationLines
+        .filter((l) => l.length - l.trimStart().length === maxIndent)
+        .map((l) => l.trim())
+        .filter(Boolean)[0];
+    return deepest ?? message;
+}
+/**
+ * Spawn `tsc --noEmit --watch` and report each completed check via `onErrors`
+ * (empty array when the check is clean). Returns a cleanup function that kills
+ * the watcher. Shared by the Ink-based dev UI (via {@link useTypeScriptCheck})
+ * and the `--plain` runner.
+ */
+export function startTypeScriptCheck(onErrors) {
+    const tsProcess = spawn("npx tsc --noEmit --watch --pretty false", {
+        stdio: ["ignore", "pipe", "pipe"],
+        shell: true,
+    });
+    let outputBuffer = "";
+    let currentErrors = [];
+    let pendingError = null;
+    let continuationLines = [];
+    const flushPending = () => {
+        if (!pendingError) {
+            return;
+        }
+        pendingError.message = extractBestMessage(pendingError.message, continuationLines);
+        currentErrors.push(pendingError);
+        pendingError = null;
+        continuationLines = [];
+    };
+    const processOutput = (data) => {
+        outputBuffer += data.toString();
+        const lines = outputBuffer.split("\n");
+        outputBuffer = lines.pop() || "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            const errorMatch = trimmed.match(/^(.+?)\((\d+),(\d+)\):\s+error\s+(TS\d+)?\s*:?\s*(.+)$/);
+            if (errorMatch) {
+                flushPending();
+                const [, file, lineStr, colStr, code, message] = errorMatch;
+                if (file && lineStr && colStr && message) {
+                    let cleanFile = file.trim();
+                    if (isAbsolute(cleanFile)) {
+                        cleanFile = relative(process.cwd(), cleanFile);
+                    }
+                    pendingError = {
+                        file: cleanFile,
+                        line: Number.parseInt(lineStr, 10),
+                        col: Number.parseInt(colStr, 10),
+                        code: code ?? "",
+                        message: message.trim(),
+                    };
+                }
+                continue;
+            }
+            if (pendingError && line.startsWith(" ")) {
+                continuationLines.push(line);
+                continue;
+            }
+            if (trimmed.includes("Found") && trimmed.includes("error")) {
+                flushPending();
+                onErrors(trimmed.match(/Found 0 error/) ? [] : [...currentErrors]);
+                currentErrors = [];
+            }
+        }
+    };
+    if (tsProcess.stdout) {
+        tsProcess.stdout.on("data", processOutput);
+    }
+    if (tsProcess.stderr) {
+        tsProcess.stderr.on("data", processOutput);
+    }
+    return () => {
+        tsProcess.kill();
+    };
+}
+export function useTypeScriptCheck() {
+    const [tsErrors, setTsErrors] = useState([]);
+    useEffect(() => startTypeScriptCheck(setTsErrors), []);
+    return tsErrors;
+}
+//# sourceMappingURL=use-typescript-check.js.map

package/dist/cli/use-typescript-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-typescript-check.js","sourceRoot":"","sources":["../../src/cli/use-typescript-check.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute, relative } from \"node:path\";\nimport spawn from \"cross-spawn\";\nimport { useEffect, useState } from \"react\";\n\nexport type TsError = {\n  file: string;\n  line: number;\n  col: number;\n  code: string;\n  message: string;\n};\n\n// TypeScript nests from general to specific — the deepest line is the root cause.\nfunction extractBestMessage(\n  message: string,\n  continuationLines: Array<string>,\n): string {\n  if (!continuationLines.length) {\n    return message;\n  }\n  let maxIndent = 0;\n  for (const line of continuationLines) {\n    const indent = line.length - line.trimStart().length;\n    if (indent > maxIndent) {\n      maxIndent = indent;\n    }\n  }\n  const deepest = continuationLines\n    .filter((l) => l.length - l.trimStart().length === maxIndent)\n    .map((l) => l.trim())\n    .filter(Boolean)[0];\n  return deepest ?? message;\n}\n\n/**\n * Spawn `tsc --noEmit --watch` and report each completed check via `onErrors`\n * (empty array when the check is clean). Returns a cleanup function that kills\n * the watcher. Shared by the Ink-based dev UI (via {@link useTypeScriptCheck})\n * and the `--plain` runner.\n */\nexport function startTypeScriptCheck(\n  onErrors: (errors: Array<TsError>) => void,\n): () => void {\n  const tsProcess = spawn(\"npx tsc --noEmit --watch --pretty false\", {\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    shell: true,\n  });\n\n  let outputBuffer = \"\";\n  let currentErrors: Array<TsError> = [];\n  let pendingError: TsError | null = null;\n  let continuationLines: Array<string> = [];\n\n  const flushPending = () => {\n    if (!pendingError) {\n      return;\n    }\n    pendingError.message = extractBestMessage(\n      pendingError.message,\n      continuationLines,\n    );\n    currentErrors.push(pendingError);\n    pendingError = null;\n    continuationLines = [];\n  };\n\n  const processOutput = (data: Buffer) => {\n    outputBuffer += data.toString();\n    const lines = outputBuffer.split(\"\\n\");\n    outputBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n\n      const errorMatch = trimmed.match(\n        /^(.+?)\\((\\d+),(\\d+)\\):\\s+error\\s+(TS\\d+)?\\s*:?\\s*(.+)$/,\n      );\n      if (errorMatch) {\n        flushPending();\n        const [, file, lineStr, colStr, code, message] = errorMatch;\n        if (file && lineStr && colStr && message) {\n          let cleanFile = file.trim();\n          if (isAbsolute(cleanFile)) {\n            cleanFile = relative(process.cwd(), cleanFile);\n          }\n          pendingError = {\n            file: cleanFile,\n            line: Number.parseInt(lineStr, 10),\n            col: Number.parseInt(colStr, 10),\n            code: code ?? \"\",\n            message: message.trim(),\n          };\n        }\n        continue;\n      }\n\n      if (pendingError && line.startsWith(\" \")) {\n        continuationLines.push(line);\n        continue;\n      }\n\n      if (trimmed.includes(\"Found\") && trimmed.includes(\"error\")) {\n        flushPending();\n        onErrors(trimmed.match(/Found 0 error/) ? [] : [...currentErrors]);\n        currentErrors = [];\n      }\n    }\n  };\n\n  if (tsProcess.stdout) {\n    tsProcess.stdout.on(\"data\", processOutput);\n  }\n  if (tsProcess.stderr) {\n    tsProcess.stderr.on(\"data\", processOutput);\n  }\n\n  return () => {\n    tsProcess.kill();\n  };\n}\n\nexport function useTypeScriptCheck(): Array<TsError> {\n  const [tsErrors, setTsErrors] = useState<Array<TsError>>([]);\n\n  useEffect(() => startTypeScriptCheck(setTsErrors), []);\n\n  return tsErrors;\n}\n"]}

package/dist/commands/build.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "@oclif/core";
+export default class Build extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/build.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Command } from "@oclif/core";
+import { Box, render, Text } from "ink";
+import { useEffect } from "react";
+import { getCommandSteps } from "../cli/build-steps.js";
+import { Header } from "../cli/header.js";
+import { useExecuteSteps } from "../cli/use-execute-steps.js";
+export default class Build extends Command {
+    static description = "Build the views and MCP server";
+    static examples = ["skybridge build"];
+    async run() {
+        const commandSteps = await getCommandSteps().catch((e) => this.error(e instanceof Error ? e.message : String(e)));
+        const App = () => {
+            const { currentStep, status, error, execute } = useExecuteSteps(commandSteps);
+            useEffect(() => {
+                execute();
+            }, [execute]);
+            return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Header, { version: this.config.version, children: _jsx(Text, { color: "green", children: " \u2192 building for production\u2026" }) }), commandSteps.map((step, index) => {
+                        const isCurrent = index === currentStep && status === "running";
+                        const isCompleted = index < currentStep || status === "success";
+                        const isError = status === "error" && index === currentStep;
+                        return (_jsx(Box, { marginBottom: 0, children: _jsxs(Text, { color: isError ? "red" : isCompleted ? "green" : "grey", children: [isError ? "✗" : isCompleted ? "✓" : isCurrent ? "⟳" : "○", " ", step.label] }) }, step.label));
+                    }), status === "success" && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2713 Build completed successfully!" }) })), status === "error" && error && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "red", bold: true, children: "\u2717 Build failed" }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: error.split("\n").map((line) => (_jsx(Text, { color: "red", children: line }, line))) })] }))] }));
+        };
+        render(_jsx(App, {}), {
+            exitOnCtrlC: true,
+            patchConsole: false,
+        });
+    }
+}
+//# sourceMappingURL=build.js.map