skybridge 0.0.0-dev.dc576c4 → 0.0.0-dev.dc90b1c

package/dist/cli/detect-port.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect-port.js","sourceRoot":"","sources":["../../src/cli/detect-port.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAiB;IACjD,IAAI,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAChC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO;YACL,IAAI,EAAE,MAAM,mBAAmB,CAAC,YAAY,CAAC;YAC7C,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,iBAAiB,MAAM,+BAA+B;SACnE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,IAAa;IAEb,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;gBACtB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAChB,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CACrD,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAa;IAClD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import net from \"node:net\";\n\nconst DEFAULT_PORT = 3000;\n\nexport async function resolvePort(flagPort?: number) {\n  if (flagPort && flagPort > 1) {\n    return { port: flagPort, fallback: false };\n  }\n\n  const rawEnv = process.env.PORT;\n  if (rawEnv) {\n    const parsed = Number(rawEnv);\n    if (Number.isInteger(parsed) && parsed > 0) {\n      return { port: parsed, fallback: false };\n    }\n    return {\n      port: await detectAvailablePort(DEFAULT_PORT),\n      fallback: false,\n      envWarning: `Invalid PORT=\"${rawEnv}\", ignoring and using default`,\n    };\n  }\n\n  const port = await detectAvailablePort(DEFAULT_PORT);\n  return { port, fallback: port !== DEFAULT_PORT };\n}\n\n/**\n * Returns the given port if available, otherwise lets the OS\n * pick a free port via `listen(0)`.\n *\n * @param host - Bind address for the check. Pass `\"localhost\"` for\n *   services that bind to 127.0.0.1 (e.g. Vite HMR). Omit for\n *   services that bind to all interfaces (e.g. the HTTP server).\n */\nexport async function detectAvailablePort(\n  startPort: number,\n  host?: string,\n): Promise<number> {\n  const available = await isPortAvailable(startPort, host);\n  if (available) {\n    return startPort;\n  }\n\n  return new Promise((resolve, reject) => {\n    const server = net.createServer();\n\n    server.once(\"error\", reject);\n    server.once(\"listening\", () => {\n      const addr = server.address();\n      if (addr && typeof addr === \"object\") {\n        const { port } = addr;\n        server.close(() => resolve(port));\n      } else {\n        server.close(() =>\n          reject(new Error(\"Failed to detect available port\")),\n        );\n      }\n    });\n\n    server.listen(0, host);\n  });\n}\n\nfunction isPortAvailable(port: number, host?: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const server = net.createServer();\n\n    server.once(\"error\", () => resolve(false));\n    server.once(\"listening\", () => {\n      server.close(() => resolve(true));\n    });\n\n    server.listen(port, host);\n  });\n}\n"]}
+{"version":3,"file":"detect-port.js","sourceRoot":"","sources":["../../src/cli/detect-port.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAiB;IACjD,IAAI,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAChC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO;YACL,IAAI,EAAE,MAAM,mBAAmB,CAAC,YAAY,CAAC;YAC7C,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,iBAAiB,MAAM,+BAA+B;SACnE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,IAAa;IAEb,KAAK,IAAI,IAAI,GAAG,SAAS,EAAE,IAAI,GAAG,SAAS,GAAG,kBAAkB,EAAE,IAAI,EAAE,EAAE,CAAC;QACzE,IAAI,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,mCAAmC,SAAS,QAAQ,SAAS,GAAG,kBAAkB,GAAG,CAAC,EAAE,CACzF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAa;IAClD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import net from \"node:net\";\n\nconst DEFAULT_PORT = 3000;\nconst MAX_PORT_INCREMENT = 100;\n\nexport async function resolvePort(flagPort?: number) {\n  if (flagPort && flagPort > 1) {\n    return { port: flagPort, fallback: false };\n  }\n\n  const rawEnv = process.env.PORT;\n  if (rawEnv) {\n    const parsed = Number(rawEnv);\n    if (Number.isInteger(parsed) && parsed > 0) {\n      return { port: parsed, fallback: false };\n    }\n    return {\n      port: await detectAvailablePort(DEFAULT_PORT),\n      fallback: false,\n      envWarning: `Invalid PORT=\"${rawEnv}\", ignoring and using default`,\n    };\n  }\n\n  const port = await detectAvailablePort(DEFAULT_PORT);\n  return { port, fallback: port !== DEFAULT_PORT };\n}\n\n/**\n * Returns the first available port at or after `startPort`, incrementing\n * by one until a free port is found or `MAX_PORT_INCREMENT` is reached.\n *\n * @param host - Bind address for the check. Pass `\"localhost\"` for\n *   services that bind to 127.0.0.1 (e.g. Vite HMR). Omit for\n *   services that bind to all interfaces (e.g. the HTTP server).\n */\nexport async function detectAvailablePort(\n  startPort: number,\n  host?: string,\n): Promise<number> {\n  for (let port = startPort; port < startPort + MAX_PORT_INCREMENT; port++) {\n    if (await isPortAvailable(port, host)) {\n      return port;\n    }\n  }\n  throw new Error(\n    `No available port found between ${startPort} and ${startPort + MAX_PORT_INCREMENT - 1}`,\n  );\n}\n\nfunction isPortAvailable(port: number, host?: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const server = net.createServer();\n\n    server.once(\"error\", () => resolve(false));\n    server.once(\"listening\", () => {\n      server.close(() => resolve(true));\n    });\n\n    server.listen(port, host);\n  });\n}\n"]}

package/dist/cli/header.d.ts

@@ -1,4 +1,4 @@
 export declare const Header: ({ version, children, }: {
     version: string;
     children?: React.ReactNode;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => import("react").JSX.Element;

package/dist/cli/resolve-skybridge-config.d.ts

@@ -0,0 +1,5 @@
+export interface SkybridgeConfig {
+    viewsDir?: string;
+    serverExternal?: string[];
+}
+export declare function resolveSkybridgeConfig(root: string): Promise<SkybridgeConfig>;

package/dist/cli/{resolve-views-dir.js → resolve-skybridge-config.js}

@@ -1,4 +1,4 @@
-export async function resolveViewsDir(root) {
+export async function resolveSkybridgeConfig(root) {
     const { loadConfigFromFile } = await import("vite");
     const loaded = await loadConfigFromFile({ command: "build", mode: "production" }, undefined, root);
     const isPluginCandidate = (value) => typeof value === "object" && value !== null;
@@ -12,6 +12,7 @@ export async function resolveViewsDir(root) {
         }
     };
     walk(loaded?.config.plugins ?? []);
-    return plugins.find((p) => p.name === "skybridge")?.api?.viewsDir;
+    const api = plugins.find((p) => p.name === "skybridge")?.api;
+    return { viewsDir: api?.viewsDir, serverExternal: api?.serverExternal };
 }
-//# sourceMappingURL=resolve-views-dir.js.map
+//# sourceMappingURL=resolve-skybridge-config.js.map

package/dist/cli/resolve-skybridge-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-skybridge-config.js","sourceRoot":"","sources":["../../src/cli/resolve-skybridge-config.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAY;IAEZ,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EACxC,SAAS,EACT,IAAI,CACL,CAAC;IAEF,MAAM,iBAAiB,GAAG,CACxB,KAAc,EACqC,EAAE,CACrD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;IAE9C,MAAM,OAAO,GAAoD,EAAE,CAAC;IACpE,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE;QAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,GAAG,CAAC;IAC7D,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;AAC1E,CAAC","sourcesContent":["export interface SkybridgeConfig {\n  viewsDir?: string;\n  serverExternal?: string[];\n}\n\nexport async function resolveSkybridgeConfig(\n  root: string,\n): Promise<SkybridgeConfig> {\n  const { loadConfigFromFile } = await import(\"vite\");\n  const loaded = await loadConfigFromFile(\n    { command: \"build\", mode: \"production\" },\n    undefined,\n    root,\n  );\n\n  const isPluginCandidate = (\n    value: unknown,\n  ): value is { name?: string; api?: SkybridgeConfig } =>\n    typeof value === \"object\" && value !== null;\n\n  const plugins: Array<{ name?: string; api?: SkybridgeConfig }> = [];\n  const walk = (value: unknown) => {\n    if (Array.isArray(value)) {\n      value.forEach(walk);\n    } else if (isPluginCandidate(value)) {\n      plugins.push(value);\n    }\n  };\n  walk(loaded?.config.plugins ?? []);\n  const api = plugins.find((p) => p.name === \"skybridge\")?.api;\n  return { viewsDir: api?.viewsDir, serverExternal: api?.serverExternal };\n}\n"]}

package/dist/cli/run-plain.d.ts

@@ -0,0 +1,18 @@
+import type { TunnelManager } from "./tunnel.js";
+export interface RunPlainOptions {
+    env: NodeJS.ProcessEnv;
+    port: number;
+    fallback: boolean;
+    version: string;
+    tunnel: boolean;
+    tunnelManager: TunnelManager;
+}
+/**
+ * Run `skybridge dev` without the Ink UI. The server's stdout is forwarded
+ * verbatim to the real stdout so it can be piped through a formatter
+ * (`skybridge dev --plain | bunyan`); everything else (banner, URLs, tunnel
+ * state, TypeScript errors, restarts) is written to stderr.
+ *
+ * Returns a cleanup function that tears down nodemon and the tsc watcher.
+ */
+export declare function runPlain(options: RunPlainOptions): () => void;

package/dist/cli/run-plain.js

@@ -0,0 +1,90 @@
+import { CRASH_MESSAGE, startNodemon } from "./use-nodemon.js";
+import { startTypeScriptCheck } from "./use-typescript-check.js";
+// Banner/URLs/diagnostics go to stderr so a downstream pipe (e.g.
+// `skybridge dev --plain | bunyan`) only ever sees the server's own stdout.
+function info(message) {
+    process.stderr.write(`${message}\n`);
+}
+function describeTunnel(state, port) {
+    switch (state.status) {
+        case "starting":
+            return `🌍  ${state.message}`;
+        case "connected":
+            return `🌍  Exposed on ${state.url}/mcp\n→  Test with an LLM on Playground: ${state.url}/try`;
+        case "error":
+            return `🌍  Cannot open tunnel: ${state.message}\n→  Try manually: npx alpic tunnel --port ${port}`;
+        default:
+            return "";
+    }
+}
+/**
+ * Run `skybridge dev` without the Ink UI. The server's stdout is forwarded
+ * verbatim to the real stdout so it can be piped through a formatter
+ * (`skybridge dev --plain | bunyan`); everything else (banner, URLs, tunnel
+ * state, TypeScript errors, restarts) is written to stderr.
+ *
+ * Returns a cleanup function that tears down nodemon and the tsc watcher.
+ */
+export function runPlain(options) {
+    const { env, port, fallback, version, tunnel, tunnelManager } = options;
+    // If the downstream formatter (e.g. `| bunyan`) exits, the next write raises
+    // EPIPE. Swallow it so a closed pipe doesn't crash the dev server.
+    const ignoreEpipe = (err) => {
+        if (err.code !== "EPIPE") {
+            throw err;
+        }
+    };
+    process.stdout.on("error", ignoreEpipe);
+    process.stderr.on("error", ignoreEpipe);
+    info(`⛰  Skybridge v${version}`);
+    info(fallback
+        ? `🏠  3000 in use, running on http://localhost:${port}/mcp`
+        : `🏠  Running on http://localhost:${port}/mcp`);
+    info(`→  Test locally with DevTools: http://localhost:${port}/`);
+    if (!tunnel) {
+        info("🌍  Get a public URL and LLM Playground access with --tunnel.");
+    }
+    const stopNodemon = startNodemon(env, {
+        onStdout: (chunk) => process.stdout.write(chunk),
+        onStderr: (message) => info(message),
+        onRestart: (files) => info(`✓  Server restarted due to file changes: ${files.join(", ")}`),
+        onCrash: () => info(CRASH_MESSAGE),
+    });
+    let lastTsErrorKey = "";
+    const stopTypeScriptCheck = startTypeScriptCheck((errors) => {
+        // tsc re-emits on every save; only print when the error set actually changes.
+        const key = errors
+            .map((e) => `${e.file}:${e.line}:${e.col}:${e.message}`)
+            .join("|");
+        if (key === lastTsErrorKey) {
+            return;
+        }
+        lastTsErrorKey = key;
+        if (errors.length === 0) {
+            return;
+        }
+        info("⚠️  TypeScript errors found:");
+        for (const error of errors) {
+            info(`  ${error.file}(${error.line},${error.col}): ${error.message}`);
+        }
+    });
+    const unsubscribeTunnel = tunnel
+        ? tunnelManager.subscribe((state) => {
+            const message = describeTunnel(state, port);
+            if (message) {
+                info(message);
+            }
+        })
+        : () => { };
+    if (tunnel) {
+        tunnelManager.start();
+    }
+    return () => {
+        unsubscribeTunnel();
+        stopNodemon();
+        stopTypeScriptCheck();
+        process.stdout.off("error", ignoreEpipe);
+        process.stderr.off("error", ignoreEpipe);
+    };
+}
+//# sourceMappingURL=run-plain.js.map

package/dist/cli/run-plain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-plain.js","sourceRoot":"","sources":["../../src/cli/run-plain.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TunnelManager, TunnelState } from \"./tunnel.js\";\nimport { CRASH_MESSAGE, startNodemon } from \"./use-nodemon.js\";\nimport { startTypeScriptCheck, type TsError } from \"./use-typescript-check.js\";\n\nexport interface RunPlainOptions {\n  env: NodeJS.ProcessEnv;\n  port: number;\n  fallback: boolean;\n  version: string;\n  tunnel: boolean;\n  tunnelManager: TunnelManager;\n}\n\n// Banner/URLs/diagnostics go to stderr so a downstream pipe (e.g.\n// `skybridge dev --plain | bunyan`) only ever sees the server's own stdout.\nfunction info(message: string): void {\n  process.stderr.write(`${message}\\n`);\n}\n\nfunction describeTunnel(state: TunnelState, port: number): string {\n  switch (state.status) {\n    case \"starting\":\n      return `🌍  ${state.message}`;\n    case \"connected\":\n      return `🌍  Exposed on ${state.url}/mcp\\n→  Test with an LLM on Playground: ${state.url}/try`;\n    case \"error\":\n      return `🌍  Cannot open tunnel: ${state.message}\\n→  Try manually: npx alpic tunnel --port ${port}`;\n    default:\n      return \"\";\n  }\n}\n\n/**\n * Run `skybridge dev` without the Ink UI. The server's stdout is forwarded\n * verbatim to the real stdout so it can be piped through a formatter\n * (`skybridge dev --plain | bunyan`); everything else (banner, URLs, tunnel\n * state, TypeScript errors, restarts) is written to stderr.\n *\n * Returns a cleanup function that tears down nodemon and the tsc watcher.\n */\nexport function runPlain(options: RunPlainOptions): () => void {\n  const { env, port, fallback, version, tunnel, tunnelManager } = options;\n\n  // If the downstream formatter (e.g. `| bunyan`) exits, the next write raises\n  // EPIPE. Swallow it so a closed pipe doesn't crash the dev server.\n  const ignoreEpipe = (err: NodeJS.ErrnoException) => {\n    if (err.code !== \"EPIPE\") {\n      throw err;\n    }\n  };\n  process.stdout.on(\"error\", ignoreEpipe);\n  process.stderr.on(\"error\", ignoreEpipe);\n\n  info(`⛰  Skybridge v${version}`);\n  info(\n    fallback\n      ? `🏠  3000 in use, running on http://localhost:${port}/mcp`\n      : `🏠  Running on http://localhost:${port}/mcp`,\n  );\n  info(`→  Test locally with DevTools: http://localhost:${port}/`);\n  if (!tunnel) {\n    info(\"🌍  Get a public URL and LLM Playground access with --tunnel.\");\n  }\n\n  const stopNodemon = startNodemon(env, {\n    onStdout: (chunk) => process.stdout.write(chunk),\n    onStderr: (message) => info(message),\n    onRestart: (files) =>\n      info(`✓  Server restarted due to file changes: ${files.join(\", \")}`),\n    onCrash: () => info(CRASH_MESSAGE),\n  });\n\n  let lastTsErrorKey = \"\";\n  const stopTypeScriptCheck = startTypeScriptCheck((errors: Array<TsError>) => {\n    // tsc re-emits on every save; only print when the error set actually changes.\n    const key = errors\n      .map((e) => `${e.file}:${e.line}:${e.col}:${e.message}`)\n      .join(\"|\");\n    if (key === lastTsErrorKey) {\n      return;\n    }\n    lastTsErrorKey = key;\n    if (errors.length === 0) {\n      return;\n    }\n    info(\"⚠️  TypeScript errors found:\");\n    for (const error of errors) {\n      info(`  ${error.file}(${error.line},${error.col}): ${error.message}`);\n    }\n  });\n\n  const unsubscribeTunnel = tunnel\n    ? tunnelManager.subscribe((state) => {\n        const message = describeTunnel(state, port);\n        if (message) {\n          info(message);\n        }\n      })\n    : () => {};\n\n  if (tunnel) {\n    tunnelManager.start();\n  }\n\n  return () => {\n    unsubscribeTunnel();\n    stopNodemon();\n    stopTypeScriptCheck();\n    process.stdout.off(\"error\", ignoreEpipe);\n    process.stderr.off(\"error\", ignoreEpipe);\n  };\n}\n"]}

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

@@ -5,7 +5,7 @@ export interface CommandStep {
 }
 export declare const useExecuteSteps: (steps: CommandStep[]) => {
     currentStep: number;
-    status: "error" | "success" | "running";
+    status: "error" | "running" | "success";
     error: string | null;
     execute: () => Promise<void>;
 };

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

@@ -1,2 +1,26 @@
 import type { PushMessage } from "./use-messages.js";
-export declare function useNodemon(env: NodeJS.ProcessEnv, pushMessage: PushMessage): void;
+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

@@ -1,73 +1,106 @@
 import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
 import { resolve } from "node:path";
-import nodemonOriginal from "nodemon";
-import { useEffect } from "react";
-const nodemon = nodemonOriginal;
+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) {
-    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 [crashed, setCrashed] = useState(false);
+    useEffect(() => startNodemon(env, {
+        onStdout: (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]);
+        },
+        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

@@ -1 +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"]}
+{"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-typescript-check.d.ts

@@ -1,9 +1,15 @@
-type TsError = {
+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>;
-export {};

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

@@ -1,6 +1,6 @@
 import { isAbsolute, relative } from "node:path";
 import spawn from "cross-spawn";
-import { useEffect, useRef, useState } from "react";
+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) {
@@ -19,76 +19,79 @@ function extractBestMessage(message, continuationLines) {
         .filter(Boolean)[0];
     return deepest ?? message;
 }
-export function useTypeScriptCheck() {
-    const tsProcessRef = useRef(null);
-    const [tsErrors, setTsErrors] = useState([]);
-    useEffect(() => {
-        const tsProcess = spawn("npx", ["tsc", "--noEmit", "--watch", "--pretty", "false"], {
-            stdio: ["ignore", "pipe", "pipe"],
-            shell: true,
-        });
-        tsProcessRef.current = tsProcess;
-        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(),
-                        };
+/**
+ * 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);
                     }
-                    continue;
-                }
-                if (pendingError && line.startsWith(" ")) {
-                    continuationLines.push(line);
-                    continue;
-                }
-                if (trimmed.includes("Found") && trimmed.includes("error")) {
-                    flushPending();
-                    setTsErrors(trimmed.match(/Found 0 error/) ? [] : [...currentErrors]);
-                    currentErrors = [];
+                    pendingError = {
+                        file: cleanFile,
+                        line: Number.parseInt(lineStr, 10),
+                        col: Number.parseInt(colStr, 10),
+                        code: code ?? "",
+                        message: message.trim(),
+                    };
                 }
+                continue;
             }
-        };
-        if (tsProcess.stdout) {
-            tsProcess.stdout.on("data", processOutput);
-        }
-        if (tsProcess.stderr) {
-            tsProcess.stderr.on("data", processOutput);
-        }
-        return () => {
-            if (tsProcessRef.current) {
-                tsProcessRef.current.kill();
+            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