skybridge 0.0.0-dev.cb51733 → 0.0.0-dev.cb83b5b

package/dist/cli/build-steps.test.js

@@ -0,0 +1,72 @@
+// @vitest-environment node
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { getCommandSteps } from "./build-steps.js";
+function mkTmp(prefix = "skybridge-build-steps-") {
+    return mkdtempSync(path.join(tmpdir(), prefix));
+}
+describe("getCommandSteps", () => {
+    it("omits the vite build step when no views are registered", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src"), { recursive: true });
+        writeFileSync(path.join(root, "vite.config.ts"), `import { defineConfig } from "vite";
+import { skybridge } from "@skybridge/vite-plugin";
+export default defineConfig({ plugins: [skybridge()] });`);
+        writeFileSync(path.join(root, "tsconfig.json"), JSON.stringify({ compilerOptions: { strict: true } }));
+        const steps = await getCommandSteps(root);
+        const labels = steps.map((step) => step.label);
+        expect(labels).not.toContain("Building views");
+        expect(labels).toContain("Emitting manifest module");
+        expect(labels.at(-1)).toBe("Emitting Vercel build output");
+    });
+    it("includes the vite build step when views are present", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src", "views"), { recursive: true });
+        writeFileSync(path.join(root, "src", "views", "hello.tsx"), "export default function Hello() { return null; }\n");
+        writeFileSync(path.join(root, "vite.config.ts"), `import { defineConfig } from "vite";
+import { skybridge } from "@skybridge/vite-plugin";
+export default defineConfig({ plugins: [skybridge()] });`);
+        writeFileSync(path.join(root, "tsconfig.json"), JSON.stringify({ compilerOptions: { strict: true } }));
+        const steps = await getCommandSteps(root);
+        const labels = steps.map((step) => step.label);
+        expect(labels).toContain("Building views");
+    });
+    it("copies public/ to dist/assets/ when no views but public dir exists", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src"), { recursive: true });
+        mkdirSync(path.join(root, "public", ".well-known"), { recursive: true });
+        writeFileSync(path.join(root, "public", ".well-known", "openai-apps-challenge"), "challenge-token");
+        writeFileSync(path.join(root, "public", "logo.png"), "fake-png");
+        writeFileSync(path.join(root, "vite.config.ts"), `import { defineConfig } from "vite";
+import { skybridge } from "@skybridge/vite-plugin";
+export default defineConfig({ plugins: [skybridge()] });`);
+        writeFileSync(path.join(root, "tsconfig.json"), JSON.stringify({ compilerOptions: { strict: true } }));
+        const steps = await getCommandSteps(root);
+        const labels = steps.map((step) => step.label);
+        expect(labels).not.toContain("Building views");
+        expect(labels).toContain("Copying public assets");
+        mkdirSync(path.join(root, "dist"), { recursive: true });
+        const copyStep = steps.find((s) => s.label === "Copying public assets");
+        await copyStep?.run?.();
+        expect(readFileSync(path.join(root, "dist", "assets", ".well-known", "openai-apps-challenge"), "utf-8")).toBe("challenge-token");
+        expect(readFileSync(path.join(root, "dist", "assets", "logo.png"), "utf-8")).toBe("fake-png");
+    });
+    it("emits an empty manifest module when there are no views", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src"), { recursive: true });
+        writeFileSync(path.join(root, "vite.config.ts"), `import { defineConfig } from "vite";
+import { skybridge } from "@skybridge/vite-plugin";
+export default defineConfig({ plugins: [skybridge()] });`);
+        const steps = await getCommandSteps(root);
+        const emitManifest = steps.find((step) => step.label === "Emitting manifest module");
+        expect(emitManifest?.run).toBeDefined();
+        mkdirSync(path.join(root, "dist"), { recursive: true });
+        await emitManifest?.run?.();
+        const manifestOut = path.join(root, "dist", "vite-manifest.js");
+        expect(existsSync(manifestOut)).toBe(true);
+        expect(readFileSync(manifestOut, "utf-8")).toBe("export default {};\n");
+    });
+});
+//# sourceMappingURL=build-steps.test.js.map

package/dist/cli/build-steps.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-steps.test.js","sourceRoot":"","sources":["../../src/cli/build-steps.test.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,SAAS,KAAK,CAAC,MAAM,GAAG,wBAAwB;IAC9C,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EACjC;;yDAEmD,CACpD,CAAC;QACF,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CACtD,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAC5C,oDAAoD,CACrD,CAAC;QACF,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EACjC;;yDAEmD,CACpD,CAAC;QACF,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CACtD,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,uBAAuB,CAAC,EACjE,iBAAiB,CAClB,CAAC;QACF,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;QACjE,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EACjC;;yDAEmD,CACpD,CAAC;QACF,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CACtD,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAElD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,uBAAuB,CAAC,CAAC;QACxE,MAAM,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;QAExB,MAAM,CACJ,YAAY,CACV,IAAI,CAAC,IAAI,CACP,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,aAAa,EACb,uBAAuB,CACxB,EACD,OAAO,CACR,CACF,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1B,MAAM,CACJ,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CACrE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EACjC;;yDAEmD,CACpD,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,0BAA0B,CACpD,CAAC;QACF,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAExC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,YAAY,EAAE,GAAG,EAAE,EAAE,CAAC;QAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAChE,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["// @vitest-environment node\nimport {\n  existsSync,\n  mkdirSync,\n  mkdtempSync,\n  readFileSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\nimport { getCommandSteps } from \"./build-steps.js\";\n\nfunction mkTmp(prefix = \"skybridge-build-steps-\") {\n  return mkdtempSync(path.join(tmpdir(), prefix));\n}\n\ndescribe(\"getCommandSteps\", () => {\n  it(\"omits the vite build step when no views are registered\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"src\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"vite.config.ts\"),\n      `import { defineConfig } from \"vite\";\nimport { skybridge } from \"@skybridge/vite-plugin\";\nexport default defineConfig({ plugins: [skybridge()] });`,\n    );\n    writeFileSync(\n      path.join(root, \"tsconfig.json\"),\n      JSON.stringify({ compilerOptions: { strict: true } }),\n    );\n\n    const steps = await getCommandSteps(root);\n    const labels = steps.map((step) => step.label);\n\n    expect(labels).not.toContain(\"Building views\");\n    expect(labels).toContain(\"Emitting manifest module\");\n    expect(labels.at(-1)).toBe(\"Emitting Vercel build output\");\n  });\n\n  it(\"includes the vite build step when views are present\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"src\", \"views\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"src\", \"views\", \"hello.tsx\"),\n      \"export default function Hello() { return null; }\\n\",\n    );\n    writeFileSync(\n      path.join(root, \"vite.config.ts\"),\n      `import { defineConfig } from \"vite\";\nimport { skybridge } from \"@skybridge/vite-plugin\";\nexport default defineConfig({ plugins: [skybridge()] });`,\n    );\n    writeFileSync(\n      path.join(root, \"tsconfig.json\"),\n      JSON.stringify({ compilerOptions: { strict: true } }),\n    );\n\n    const steps = await getCommandSteps(root);\n    const labels = steps.map((step) => step.label);\n\n    expect(labels).toContain(\"Building views\");\n  });\n\n  it(\"copies public/ to dist/assets/ when no views but public dir exists\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"src\"), { recursive: true });\n    mkdirSync(path.join(root, \"public\", \".well-known\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"public\", \".well-known\", \"openai-apps-challenge\"),\n      \"challenge-token\",\n    );\n    writeFileSync(path.join(root, \"public\", \"logo.png\"), \"fake-png\");\n    writeFileSync(\n      path.join(root, \"vite.config.ts\"),\n      `import { defineConfig } from \"vite\";\nimport { skybridge } from \"@skybridge/vite-plugin\";\nexport default defineConfig({ plugins: [skybridge()] });`,\n    );\n    writeFileSync(\n      path.join(root, \"tsconfig.json\"),\n      JSON.stringify({ compilerOptions: { strict: true } }),\n    );\n\n    const steps = await getCommandSteps(root);\n    const labels = steps.map((step) => step.label);\n\n    expect(labels).not.toContain(\"Building views\");\n    expect(labels).toContain(\"Copying public assets\");\n\n    mkdirSync(path.join(root, \"dist\"), { recursive: true });\n    const copyStep = steps.find((s) => s.label === \"Copying public assets\");\n    await copyStep?.run?.();\n\n    expect(\n      readFileSync(\n        path.join(\n          root,\n          \"dist\",\n          \"assets\",\n          \".well-known\",\n          \"openai-apps-challenge\",\n        ),\n        \"utf-8\",\n      ),\n    ).toBe(\"challenge-token\");\n    expect(\n      readFileSync(path.join(root, \"dist\", \"assets\", \"logo.png\"), \"utf-8\"),\n    ).toBe(\"fake-png\");\n  });\n\n  it(\"emits an empty manifest module when there are no views\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"src\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"vite.config.ts\"),\n      `import { defineConfig } from \"vite\";\nimport { skybridge } from \"@skybridge/vite-plugin\";\nexport default defineConfig({ plugins: [skybridge()] });`,\n    );\n\n    const steps = await getCommandSteps(root);\n    const emitManifest = steps.find(\n      (step) => step.label === \"Emitting manifest module\",\n    );\n    expect(emitManifest?.run).toBeDefined();\n\n    mkdirSync(path.join(root, \"dist\"), { recursive: true });\n    await emitManifest?.run?.();\n\n    const manifestOut = path.join(root, \"dist\", \"vite-manifest.js\");\n    expect(existsSync(manifestOut)).toBe(true);\n    expect(readFileSync(manifestOut, \"utf-8\")).toBe(\"export default {};\\n\");\n  });\n});\n"]}

package/dist/cli/detect-port.d.ts

@@ -8,8 +8,8 @@ export declare function resolvePort(flagPort?: number): Promise<{
     envWarning: string;
 }>;
 /**
- * Returns the given port if available, otherwise lets the OS
- * pick a free port via `listen(0)`.
+ * Returns the first available port at or after `startPort`, incrementing
+ * by one until a free port is found or `MAX_PORT_INCREMENT` is reached.
  *
  * @param host - Bind address for the check. Pass `"localhost"` for
  *   services that bind to 127.0.0.1 (e.g. Vite HMR). Omit for

package/dist/cli/detect-port.js

@@ -1,5 +1,6 @@
 import net from "node:net";
 const DEFAULT_PORT = 3000;
+const MAX_PORT_INCREMENT = 100;
 export async function resolvePort(flagPort) {
     if (flagPort && flagPort > 1) {
         return { port: flagPort, fallback: false };
@@ -20,33 +21,20 @@ export async function resolvePort(flagPort) {
     return { port, fallback: port !== DEFAULT_PORT };
 }
 /**
- * Returns the given port if available, otherwise lets the OS
- * pick a free port via `listen(0)`.
+ * Returns the first available port at or after `startPort`, incrementing
+ * by one until a free port is found or `MAX_PORT_INCREMENT` is reached.
  *
  * @param host - Bind address for the check. Pass `"localhost"` for
  *   services that bind to 127.0.0.1 (e.g. Vite HMR). Omit for
  *   services that bind to all interfaces (e.g. the HTTP server).
  */
 export async function detectAvailablePort(startPort, host) {
-    const available = await isPortAvailable(startPort, host);
-    if (available) {
-        return startPort;
+    for (let port = startPort; port < startPort + MAX_PORT_INCREMENT; port++) {
+        if (await isPortAvailable(port, host)) {
+            return port;
+        }
     }
-    return new Promise((resolve, reject) => {
-        const server = net.createServer();
-        server.once("error", reject);
-        server.once("listening", () => {
-            const addr = server.address();
-            if (addr && typeof addr === "object") {
-                const { port } = addr;
-                server.close(() => resolve(port));
-            }
-            else {
-                server.close(() => reject(new Error("Failed to detect available port")));
-            }
-        });
-        server.listen(0, host);
-    });
+    throw new Error(`No available port found between ${startPort} and ${startPort + MAX_PORT_INCREMENT - 1}`);
 }
 function isPortAvailable(port, host) {
     return new Promise((resolve) => {

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,6 @@
+export interface SkybridgeConfig {
+    viewsDir?: string;
+    serverExternal?: string[];
+    publicDir?: string | false;
+}
+export declare function resolveSkybridgeConfig(root: string): Promise<SkybridgeConfig>;

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

@@ -0,0 +1,28 @@
+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;
+    const plugins = [];
+    const walk = (value) => {
+        if (Array.isArray(value)) {
+            value.forEach(walk);
+        }
+        else if (isPluginCandidate(value)) {
+            plugins.push(value);
+        }
+    };
+    walk(loaded?.config.plugins ?? []);
+    const api = plugins.find((p) => p.name === "skybridge")?.api;
+    const rawPublicDir = loaded?.config.publicDir;
+    const publicDir = rawPublicDir === false
+        ? false
+        : typeof rawPublicDir === "string"
+            ? rawPublicDir
+            : undefined;
+    return {
+        viewsDir: api?.viewsDir,
+        serverExternal: api?.serverExternal,
+        publicDir,
+    };
+}
+//# 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":"AAMA,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,MAAM,YAAY,GAAG,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC;IAC9C,MAAM,SAAS,GACb,YAAY,KAAK,KAAK;QACpB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,OAAO,YAAY,KAAK,QAAQ;YAChC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,SAAS,CAAC;IAClB,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,QAAQ;QACvB,cAAc,EAAE,GAAG,EAAE,cAAc;QACnC,SAAS;KACV,CAAC;AACJ,CAAC","sourcesContent":["export interface SkybridgeConfig {\n  viewsDir?: string;\n  serverExternal?: string[];\n  publicDir?: string | false;\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  const rawPublicDir = loaded?.config.publicDir;\n  const publicDir =\n    rawPublicDir === false\n      ? false\n      : typeof rawPublicDir === \"string\"\n        ? rawPublicDir\n        : undefined;\n  return {\n    viewsDir: api?.viewsDir,\n    serverExternal: api?.serverExternal,\n    publicDir,\n  };\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/telemetry.js

@@ -3,6 +3,7 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import ci from "ci-info";
 import { PostHog } from "posthog-node";
+import { agent } from "std-env";
 const POSTHOG_API_KEY = "phc_rQdkCYr0DO4NcZBQXZnUwsHAbau9zuNwKIpil9FQP6v";
 const POSTHOG_HOST = "https://us.i.posthog.com";
 const ENV_TELEMETRY_DISABLED = "SKYBRIDGE_TELEMETRY_DISABLED";
@@ -98,6 +99,7 @@ const hook = async ({ id: command, config: { version }, error, }) => {
         machineId: getMachineId(),
         sessionId: crypto.randomUUID(),
         isCI: ci.isCI,
+        agent,
         nodeVersion: process.version,
         platform: process.platform,
         outcome: error ? "failure" : "success",

package/dist/cli/telemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/cli/telemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Hook } from \"@oclif/core\";\nimport ci from \"ci-info\";\nimport { PostHog } from \"posthog-node\";\n\nconst POSTHOG_API_KEY = \"phc_rQdkCYr0DO4NcZBQXZnUwsHAbau9zuNwKIpil9FQP6v\";\nconst POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nconst ENV_TELEMETRY_DISABLED = \"SKYBRIDGE_TELEMETRY_DISABLED\";\nconst ENV_TELEMETRY_DEBUG = \"SKYBRIDGE_TELEMETRY_DEBUG\";\nconst ENV_DO_NOT_TRACK = \"DO_NOT_TRACK\";\n\nconst GLOBAL_CONFIG_DIR = join(homedir(), \".skybridge\");\nconst GLOBAL_CONFIG_FILE = join(GLOBAL_CONFIG_DIR, \"config.json\");\n\ninterface GlobalConfig {\n  machineId: string;\n  telemetry: {\n    enabled: boolean;\n  };\n}\n\ninterface TelemetryEvent {\n  version: string;\n  machineId: string;\n  sessionId: string;\n  isCI: boolean;\n  nodeVersion: string;\n  platform: NodeJS.Platform;\n  outcome: \"success\" | \"failure\";\n  error?: string;\n}\n\nlet posthogClient: PostHog | null = null;\n\nfunction getPostHogClient(): PostHog {\n  if (!posthogClient) {\n    posthogClient = new PostHog(POSTHOG_API_KEY, {\n      host: POSTHOG_HOST,\n      flushAt: 1,\n      flushInterval: 0,\n    });\n  }\n\n  return posthogClient;\n}\n\nfunction readJsonFile<T>(filePath: string): T | null {\n  try {\n    if (existsSync(filePath)) {\n      const content = readFileSync(filePath, \"utf-8\");\n      return JSON.parse(content) as T;\n    }\n  } catch {\n    // Ignore errors reading config\n  }\n  return null;\n}\n\nfunction writeJsonFile(filePath: string, data: unknown): void {\n  try {\n    const dir = join(filePath, \"..\");\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n    writeFileSync(filePath, JSON.stringify(data, null, 2), \"utf-8\");\n  } catch {\n    // Ignore errors writing config\n  }\n}\n\nfunction getGlobalConfig(): GlobalConfig {\n  const existing = readJsonFile<GlobalConfig>(GLOBAL_CONFIG_FILE);\n  if (existing?.machineId && existing?.telemetry !== undefined) {\n    return existing;\n  }\n\n  const config: GlobalConfig = {\n    machineId: existing?.machineId || crypto.randomUUID(),\n    telemetry: {\n      enabled: existing?.telemetry?.enabled ?? true,\n    },\n  };\n\n  writeJsonFile(GLOBAL_CONFIG_FILE, config);\n  return config;\n}\n\nexport function isEnabled(): boolean {\n  if (\n    process.env[ENV_TELEMETRY_DISABLED] === \"1\" ||\n    process.env[ENV_TELEMETRY_DISABLED]?.toLowerCase() === \"true\"\n  ) {\n    return false;\n  }\n\n  if (\n    process.env[ENV_DO_NOT_TRACK] === \"1\" ||\n    process.env[ENV_DO_NOT_TRACK]?.toLowerCase() === \"true\"\n  ) {\n    return false;\n  }\n\n  if (ci.isCI) {\n    return true;\n  }\n\n  const config = getGlobalConfig();\n  return config.telemetry.enabled;\n}\n\nexport function isDebugMode(): boolean {\n  return (\n    process.env[ENV_TELEMETRY_DEBUG] === \"1\" ||\n    process.env[ENV_TELEMETRY_DEBUG]?.toLowerCase() === \"true\"\n  );\n}\n\nexport function setEnabled(enabled: boolean): void {\n  const config = getGlobalConfig();\n  config.telemetry.enabled = enabled;\n  writeJsonFile(GLOBAL_CONFIG_FILE, config);\n}\n\nexport function getMachineId(): string {\n  if (ci.isCI) {\n    return ci.name ?? \"unknown-ci\";\n  }\n\n  return getGlobalConfig().machineId;\n}\n\nconst hook: Hook<\"finally\"> = async ({\n  id: command,\n  config: { version },\n  error,\n}) => {\n  if (!isEnabled()) {\n    return;\n  }\n\n  const event: TelemetryEvent = {\n    version,\n    machineId: getMachineId(),\n    sessionId: crypto.randomUUID(),\n    isCI: ci.isCI,\n    nodeVersion: process.version,\n    platform: process.platform,\n    outcome: error ? \"failure\" : \"success\",\n    error: error?.message,\n  };\n\n  if (isDebugMode()) {\n    console.error(\n      \"[Telemetry Debug] Would send event:\",\n      JSON.stringify(event, null, 2),\n    );\n    return;\n  }\n\n  try {\n    const client = getPostHogClient();\n    client.capture({\n      distinctId: event.machineId,\n      event: command,\n      properties: event,\n    });\n  } catch {\n    // Silently ignore telemetry errors - never block CLI operation\n  }\n};\n\nexport default hook;\n"]}
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/cli/telemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Hook } from \"@oclif/core\";\nimport ci from \"ci-info\";\nimport { PostHog } from \"posthog-node\";\nimport { agent } from \"std-env\";\n\nconst POSTHOG_API_KEY = \"phc_rQdkCYr0DO4NcZBQXZnUwsHAbau9zuNwKIpil9FQP6v\";\nconst POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nconst ENV_TELEMETRY_DISABLED = \"SKYBRIDGE_TELEMETRY_DISABLED\";\nconst ENV_TELEMETRY_DEBUG = \"SKYBRIDGE_TELEMETRY_DEBUG\";\nconst ENV_DO_NOT_TRACK = \"DO_NOT_TRACK\";\n\nconst GLOBAL_CONFIG_DIR = join(homedir(), \".skybridge\");\nconst GLOBAL_CONFIG_FILE = join(GLOBAL_CONFIG_DIR, \"config.json\");\n\ninterface GlobalConfig {\n  machineId: string;\n  telemetry: {\n    enabled: boolean;\n  };\n}\n\ninterface TelemetryEvent {\n  version: string;\n  machineId: string;\n  sessionId: string;\n  isCI: boolean;\n  agent?: string;\n  nodeVersion: string;\n  platform: NodeJS.Platform;\n  outcome: \"success\" | \"failure\";\n  error?: string;\n}\n\nlet posthogClient: PostHog | null = null;\n\nfunction getPostHogClient(): PostHog {\n  if (!posthogClient) {\n    posthogClient = new PostHog(POSTHOG_API_KEY, {\n      host: POSTHOG_HOST,\n      flushAt: 1,\n      flushInterval: 0,\n    });\n  }\n\n  return posthogClient;\n}\n\nfunction readJsonFile<T>(filePath: string): T | null {\n  try {\n    if (existsSync(filePath)) {\n      const content = readFileSync(filePath, \"utf-8\");\n      return JSON.parse(content) as T;\n    }\n  } catch {\n    // Ignore errors reading config\n  }\n  return null;\n}\n\nfunction writeJsonFile(filePath: string, data: unknown): void {\n  try {\n    const dir = join(filePath, \"..\");\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n    writeFileSync(filePath, JSON.stringify(data, null, 2), \"utf-8\");\n  } catch {\n    // Ignore errors writing config\n  }\n}\n\nfunction getGlobalConfig(): GlobalConfig {\n  const existing = readJsonFile<GlobalConfig>(GLOBAL_CONFIG_FILE);\n  if (existing?.machineId && existing?.telemetry !== undefined) {\n    return existing;\n  }\n\n  const config: GlobalConfig = {\n    machineId: existing?.machineId || crypto.randomUUID(),\n    telemetry: {\n      enabled: existing?.telemetry?.enabled ?? true,\n    },\n  };\n\n  writeJsonFile(GLOBAL_CONFIG_FILE, config);\n  return config;\n}\n\nexport function isEnabled(): boolean {\n  if (\n    process.env[ENV_TELEMETRY_DISABLED] === \"1\" ||\n    process.env[ENV_TELEMETRY_DISABLED]?.toLowerCase() === \"true\"\n  ) {\n    return false;\n  }\n\n  if (\n    process.env[ENV_DO_NOT_TRACK] === \"1\" ||\n    process.env[ENV_DO_NOT_TRACK]?.toLowerCase() === \"true\"\n  ) {\n    return false;\n  }\n\n  if (ci.isCI) {\n    return true;\n  }\n\n  const config = getGlobalConfig();\n  return config.telemetry.enabled;\n}\n\nexport function isDebugMode(): boolean {\n  return (\n    process.env[ENV_TELEMETRY_DEBUG] === \"1\" ||\n    process.env[ENV_TELEMETRY_DEBUG]?.toLowerCase() === \"true\"\n  );\n}\n\nexport function setEnabled(enabled: boolean): void {\n  const config = getGlobalConfig();\n  config.telemetry.enabled = enabled;\n  writeJsonFile(GLOBAL_CONFIG_FILE, config);\n}\n\nexport function getMachineId(): string {\n  if (ci.isCI) {\n    return ci.name ?? \"unknown-ci\";\n  }\n\n  return getGlobalConfig().machineId;\n}\n\nconst hook: Hook<\"finally\"> = async ({\n  id: command,\n  config: { version },\n  error,\n}) => {\n  if (!isEnabled()) {\n    return;\n  }\n\n  const event: TelemetryEvent = {\n    version,\n    machineId: getMachineId(),\n    sessionId: crypto.randomUUID(),\n    isCI: ci.isCI,\n    agent,\n    nodeVersion: process.version,\n    platform: process.platform,\n    outcome: error ? \"failure\" : \"success\",\n    error: error?.message,\n  };\n\n  if (isDebugMode()) {\n    console.error(\n      \"[Telemetry Debug] Would send event:\",\n      JSON.stringify(event, null, 2),\n    );\n    return;\n  }\n\n  try {\n    const client = getPostHogClient();\n    client.capture({\n      distinctId: event.machineId,\n      event: command,\n      properties: event,\n    });\n  } catch {\n    // Silently ignore telemetry errors - never block CLI operation\n  }\n};\n\nexport default hook;\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