skybridge 0.0.0-dev.e1b8fe1 → 0.0.0-dev.e1ca873

package/dist/commands/start.js

@@ -0,0 +1,55 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { Command, Flags } from "@oclif/core";
+import { resolvePort } from "../cli/detect-port.js";
+import { runCommand } from "../cli/run-command.js";
+export default class Start extends Command {
+    static description = "Start production server";
+    static examples = ["skybridge start"];
+    static flags = {
+        port: Flags.integer({
+            char: "p",
+            description: "Port to run the server on",
+            min: 1,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Start);
+        const { port, fallback, envWarning } = await resolvePort(flags.port);
+        if (envWarning) {
+            this.warn(envWarning);
+        }
+        console.clear();
+        // `dist/index.js` is the natural entry (the user's `await app.run()`
+        // binds the port). Prefer `dist/__entry.js` when present because it
+        // primes the Vite manifest first — without it, hashed asset URLs in
+        // views won't resolve.
+        const entryPath = resolve(process.cwd(), "dist/__entry.js");
+        const fallbackPath = resolve(process.cwd(), "dist/index.js");
+        const indexPath = existsSync(entryPath) ? entryPath : fallbackPath;
+        if (!existsSync(indexPath)) {
+            console.error("❌ Error: No build output found");
+            console.error("");
+            console.error("Please build your project first:");
+            console.error("  skybridge build");
+            console.error("");
+            process.exit(1);
+        }
+        console.log(`\x1b[36m\x1b[1m⛰ Skybridge\x1b[0m \x1b[36mv${this.config.version}\x1b[0m`);
+        if (fallback) {
+            console.log(`\x1b[33m3000 in use, running on\x1b[0m \x1b[32mhttp://localhost:${port}/mcp\x1b[0m`);
+        }
+        else {
+            console.log(`Running on \x1b[32mhttp://localhost:${port}/mcp\x1b[0m`);
+        }
+        await runCommand(`node ${indexPath}`, {
+            stdio: ["ignore", "inherit", "inherit"],
+            env: {
+                ...process.env,
+                NODE_ENV: "production",
+                __PORT: String(port),
+            },
+        });
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAU,WAAW,GAAG,yBAAyB,CAAC;IACxD,MAAM,CAAU,QAAQ,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/C,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,2BAA2B;YACxC,GAAG,EAAE,CAAC;SACP,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhB,qEAAqE;QACrE,oEAAoE;QACpE,oEAAoE;QACpE,uBAAuB;QACvB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;QAEnE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAChD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CACT,8CAA8C,IAAI,CAAC,MAAM,CAAC,OAAO,SAAS,CAC3E,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CACT,mEAAmE,IAAI,aAAa,CACrF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,aAAa,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,UAAU,CAAC,QAAQ,SAAS,EAAE,EAAE;YACpC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;YACvC,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;aACrB;SACF,CAAC,CAAC;IACL,CAAC","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { Command, Flags } from \"@oclif/core\";\nimport { resolvePort } from \"../cli/detect-port.js\";\nimport { runCommand } from \"../cli/run-command.js\";\n\nexport default class Start extends Command {\n  static override description = \"Start production server\";\n  static override examples = [\"skybridge start\"];\n  static override flags = {\n    port: Flags.integer({\n      char: \"p\",\n      description: \"Port to run the server on\",\n      min: 1,\n    }),\n  };\n\n  public async run(): Promise<void> {\n    const { flags } = await this.parse(Start);\n    const { port, fallback, envWarning } = await resolvePort(flags.port);\n    if (envWarning) {\n      this.warn(envWarning);\n    }\n\n    console.clear();\n\n    // `dist/index.js` is the natural entry (the user's `await app.run()`\n    // binds the port). Prefer `dist/__entry.js` when present because it\n    // primes the Vite manifest first — without it, hashed asset URLs in\n    // views won't resolve.\n    const entryPath = resolve(process.cwd(), \"dist/__entry.js\");\n    const fallbackPath = resolve(process.cwd(), \"dist/index.js\");\n    const indexPath = existsSync(entryPath) ? entryPath : fallbackPath;\n\n    if (!existsSync(indexPath)) {\n      console.error(\"❌ Error: No build output found\");\n      console.error(\"\");\n      console.error(\"Please build your project first:\");\n      console.error(\"  skybridge build\");\n      console.error(\"\");\n      process.exit(1);\n    }\n\n    console.log(\n      `\\x1b[36m\\x1b[1m⛰ Skybridge\\x1b[0m \\x1b[36mv${this.config.version}\\x1b[0m`,\n    );\n    if (fallback) {\n      console.log(\n        `\\x1b[33m3000 in use, running on\\x1b[0m \\x1b[32mhttp://localhost:${port}/mcp\\x1b[0m`,\n      );\n    } else {\n      console.log(`Running on \\x1b[32mhttp://localhost:${port}/mcp\\x1b[0m`);\n    }\n\n    await runCommand(`node ${indexPath}`, {\n      stdio: [\"ignore\", \"inherit\", \"inherit\"],\n      env: {\n        ...process.env,\n        NODE_ENV: \"production\",\n        __PORT: String(port),\n      },\n    });\n  }\n}\n"]}

package/dist/commands/telemetry/disable.d.ts

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

package/dist/commands/telemetry/disable.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Command } from "@oclif/core";
+import { Box, render, Text } from "ink";
+import { setEnabled } from "../../cli/telemetry.js";
+export default class TelemetryDisable extends Command {
+    static description = "Disable Skybridge telemetry on this machine";
+    async run() {
+        await this.parse(TelemetryDisable);
+        setEnabled(false);
+        const App = () => (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: "\u2713" }), _jsx(Text, { children: " Telemetry has been " }), _jsx(Text, { color: "yellow", bold: true, children: "disabled" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Config saved to ~/.skybridge/config.json" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Skybridge never collects Personally Identifiable Information (PII). If you'd like to help us improve Skybridge by allowing anonymous CLI usage data, please reenable telemetry with: skybridge telemetry enable" }) })] }));
+        render(_jsx(App, {}));
+    }
+}
+//# sourceMappingURL=disable.js.map

package/dist/commands/telemetry/disable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../../src/commands/telemetry/disable.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,OAAO;IACnD,MAAM,CAAU,WAAW,GAAG,6CAA6C,CAAC;IAErE,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACnC,UAAU,CAAC,KAAK,CAAC,CAAC;QAElB,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAChB,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,OAAO,EAAE,CAAC,aACpC,MAAC,GAAG,eACF,KAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,uBAAS,EAC7B,KAAC,IAAI,uCAA4B,EACjC,KAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,EAAC,IAAI,+BAElB,IACH,EACN,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,yDAAgD,GAC9D,EACN,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,gOAKX,GACH,IACF,CACP,CAAC;QAEF,MAAM,CAAC,KAAC,GAAG,KAAG,CAAC,CAAC;IAClB,CAAC","sourcesContent":["import { Command } from \"@oclif/core\";\nimport { Box, render, Text } from \"ink\";\nimport { setEnabled } from \"../../cli/telemetry.js\";\n\nexport default class TelemetryDisable extends Command {\n  static override description = \"Disable Skybridge telemetry on this machine\";\n\n  public async run(): Promise<void> {\n    await this.parse(TelemetryDisable);\n    setEnabled(false);\n\n    const App = () => (\n      <Box flexDirection=\"column\" padding={1}>\n        <Box>\n          <Text color=\"yellow\">✓</Text>\n          <Text> Telemetry has been </Text>\n          <Text color=\"yellow\" bold>\n            disabled\n          </Text>\n        </Box>\n        <Box marginTop={1}>\n          <Text color=\"gray\">Config saved to ~/.skybridge/config.json</Text>\n        </Box>\n        <Box marginTop={1}>\n          <Text color=\"gray\">\n            Skybridge never collects Personally Identifiable Information (PII).\n            If you'd like to help us improve Skybridge by allowing anonymous CLI\n            usage data, please reenable telemetry with: skybridge telemetry\n            enable\n          </Text>\n        </Box>\n      </Box>\n    );\n\n    render(<App />);\n  }\n}\n"]}

package/dist/commands/telemetry/enable.d.ts

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

package/dist/commands/telemetry/enable.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Command } from "@oclif/core";
+import { Box, render, Text } from "ink";
+import { setEnabled } from "../../cli/telemetry.js";
+export default class TelemetryEnable extends Command {
+    static description = "Enable Skybridge telemetry on this machine";
+    async run() {
+        await this.parse(TelemetryEnable);
+        setEnabled(true);
+        const App = () => (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: "green", children: "\u2713" }), _jsx(Text, { children: " Telemetry has been " }), _jsx(Text, { color: "green", bold: true, children: "enabled" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Config saved to ~/.skybridge/config.json" }) })] }));
+        render(_jsx(App, {}));
+    }
+}
+//# sourceMappingURL=enable.js.map

package/dist/commands/telemetry/enable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.js","sourceRoot":"","sources":["../../../src/commands/telemetry/enable.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,MAAM,CAAU,WAAW,GAAG,4CAA4C,CAAC;IAEpE,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAClC,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAChB,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,OAAO,EAAE,CAAC,aACpC,MAAC,GAAG,eACF,KAAC,IAAI,IAAC,KAAK,EAAC,OAAO,uBAAS,EAC5B,KAAC,IAAI,uCAA4B,EACjC,KAAC,IAAI,IAAC,KAAK,EAAC,OAAO,EAAC,IAAI,8BAEjB,IACH,EACN,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,yDAAgD,GAC9D,IACF,CACP,CAAC;QAEF,MAAM,CAAC,KAAC,GAAG,KAAG,CAAC,CAAC;IAClB,CAAC","sourcesContent":["import { Command } from \"@oclif/core\";\nimport { Box, render, Text } from \"ink\";\nimport { setEnabled } from \"../../cli/telemetry.js\";\n\nexport default class TelemetryEnable extends Command {\n  static override description = \"Enable Skybridge telemetry on this machine\";\n\n  public async run(): Promise<void> {\n    await this.parse(TelemetryEnable);\n    setEnabled(true);\n\n    const App = () => (\n      <Box flexDirection=\"column\" padding={1}>\n        <Box>\n          <Text color=\"green\">✓</Text>\n          <Text> Telemetry has been </Text>\n          <Text color=\"green\" bold>\n            enabled\n          </Text>\n        </Box>\n        <Box marginTop={1}>\n          <Text color=\"gray\">Config saved to ~/.skybridge/config.json</Text>\n        </Box>\n      </Box>\n    );\n\n    render(<App />);\n  }\n}\n"]}

package/dist/commands/telemetry/status.d.ts

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

package/dist/commands/telemetry/status.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Command } from "@oclif/core";
+import { Box, render, Text } from "ink";
+import { getMachineId, isEnabled } from "../../cli/telemetry.js";
+export default class TelemetryStatus extends Command {
+    static description = "Get Skybridge current telemetry settings for this machine";
+    async run() {
+        await this.parse(TelemetryStatus);
+        const enabled = isEnabled();
+        const App = () => (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, underline: true, children: "Skybridge Telemetry" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { children: "Status: " }), enabled ? (_jsx(Text, { color: "green", bold: true, children: "Enabled" })) : (_jsx(Text, { color: "yellow", bold: true, children: "Disabled" }))] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "gray", children: "Machine ID: " }), _jsx(Text, { children: getMachineId() })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "gray", children: "To opt out, run: skybridge telemetry disable" }), _jsx(Text, { color: "gray", children: "Or set: SKYBRIDGE_TELEMETRY_DISABLED=1" }), _jsx(Text, { color: "gray", children: "Debug mode: SKYBRIDGE_TELEMETRY_DEBUG=1" })] })] }));
+        render(_jsx(App, {}));
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/telemetry/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/telemetry/status.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,MAAM,CAAU,WAAW,GACzB,2DAA2D,CAAC;IAEvD,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;QAE5B,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAChB,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,OAAO,EAAE,CAAC,aACpC,KAAC,IAAI,IAAC,IAAI,QAAC,SAAS,0CAEb,EAEP,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACvC,MAAC,GAAG,eACF,KAAC,IAAI,2BAAgB,EACpB,OAAO,CAAC,CAAC,CAAC,CACT,KAAC,IAAI,IAAC,KAAK,EAAC,OAAO,EAAC,IAAI,8BAEjB,CACR,CAAC,CAAC,CAAC,CACF,KAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,EAAC,IAAI,+BAElB,CACR,IACG,EAEN,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,aACf,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,6BAAoB,EACtC,KAAC,IAAI,cAAE,YAAY,EAAE,GAAQ,IACzB,IACF,EAEN,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACvC,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,6DAAoD,EACtE,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,uDAA8C,EAChE,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,wDAA+C,IAC7D,IACF,CACP,CAAC;QAEF,MAAM,CAAC,KAAC,GAAG,KAAG,CAAC,CAAC;IAClB,CAAC","sourcesContent":["import { Command } from \"@oclif/core\";\nimport { Box, render, Text } from \"ink\";\nimport { getMachineId, isEnabled } from \"../../cli/telemetry.js\";\n\nexport default class TelemetryStatus extends Command {\n  static override description =\n    \"Get Skybridge current telemetry settings for this machine\";\n\n  public async run(): Promise<void> {\n    await this.parse(TelemetryStatus);\n    const enabled = isEnabled();\n\n    const App = () => (\n      <Box flexDirection=\"column\" padding={1}>\n        <Text bold underline>\n          Skybridge Telemetry\n        </Text>\n\n        <Box marginTop={1} flexDirection=\"column\">\n          <Box>\n            <Text>Status: </Text>\n            {enabled ? (\n              <Text color=\"green\" bold>\n                Enabled\n              </Text>\n            ) : (\n              <Text color=\"yellow\" bold>\n                Disabled\n              </Text>\n            )}\n          </Box>\n\n          <Box marginTop={1}>\n            <Text color=\"gray\">Machine ID: </Text>\n            <Text>{getMachineId()}</Text>\n          </Box>\n        </Box>\n\n        <Box marginTop={1} flexDirection=\"column\">\n          <Text color=\"gray\">To opt out, run: skybridge telemetry disable</Text>\n          <Text color=\"gray\">Or set: SKYBRIDGE_TELEMETRY_DISABLED=1</Text>\n          <Text color=\"gray\">Debug mode: SKYBRIDGE_TELEMETRY_DEBUG=1</Text>\n        </Box>\n      </Box>\n    );\n\n    render(<App />);\n  }\n}\n"]}

package/dist/context-warnings.d.ts

@@ -0,0 +1,5 @@
+export declare const TOOL_OUTPUT_WARNING_TOKENS = 5000;
+export declare const VIEW_STATE_WARNING_TOKENS = 20000;
+export declare function estimateContextTokens(value: unknown): number;
+export declare function warnOnLargeToolOutput(result: unknown, toolName: string): void;
+export declare function warnOnLargeViewState(value: unknown, source: string): void;

package/dist/context-warnings.js

@@ -0,0 +1,31 @@
+export const TOOL_OUTPUT_WARNING_TOKENS = 5_000;
+export const VIEW_STATE_WARNING_TOKENS = 20_000;
+export function estimateContextTokens(value) {
+    try {
+        const serialized = JSON.stringify(value);
+        if (!serialized) {
+            return 0;
+        }
+        return Math.ceil(new TextEncoder().encode(serialized).length / 4);
+    }
+    catch {
+        return 0;
+    }
+}
+export function warnOnLargeToolOutput(result, toolName) {
+    if (!result || typeof result !== "object" || Array.isArray(result)) {
+        return;
+    }
+    const { _meta, ...modelVisibleResult } = result;
+    const tokenCount = estimateContextTokens(modelVisibleResult);
+    if (tokenCount >= TOOL_OUTPUT_WARNING_TOKENS) {
+        console.warn(`[skybridge] Tool "${toolName}" returned ${tokenCount} estimated model-visible tokens; this reaches the ${TOOL_OUTPUT_WARNING_TOKENS}-token warning threshold and may overload model context. Content and structured content are included in this estimate.`);
+    }
+}
+export function warnOnLargeViewState(value, source) {
+    const tokenCount = estimateContextTokens(value);
+    if (tokenCount >= VIEW_STATE_WARNING_TOKENS) {
+        console.warn(`[skybridge] ${source} is persisting ${tokenCount} estimated tokens in model-visible view state; this reaches the ${VIEW_STATE_WARNING_TOKENS}-token warning threshold and may overload model context. Persisted view state and data-llm context are included in this estimate.`);
+    }
+}
+//# sourceMappingURL=context-warnings.js.map

package/dist/context-warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-warnings.js","sourceRoot":"","sources":["../src/context-warnings.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,QAAgB;IACrE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO;IACT,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,GAAG,MAAiC,CAAC;IAC3E,MAAM,UAAU,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IAC7D,IAAI,UAAU,IAAI,0BAA0B,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CACV,qBAAqB,QAAQ,cAAc,UAAU,qDAAqD,0BAA0B,wHAAwH,CAC7P,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,MAAc;IACjE,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,UAAU,IAAI,yBAAyB,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CACV,eAAe,MAAM,kBAAkB,UAAU,mEAAmE,yBAAyB,mIAAmI,CACjR,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["export const TOOL_OUTPUT_WARNING_TOKENS = 5_000;\nexport const VIEW_STATE_WARNING_TOKENS = 20_000;\n\nexport function estimateContextTokens(value: unknown): number {\n  try {\n    const serialized = JSON.stringify(value);\n    if (!serialized) {\n      return 0;\n    }\n    return Math.ceil(new TextEncoder().encode(serialized).length / 4);\n  } catch {\n    return 0;\n  }\n}\n\nexport function warnOnLargeToolOutput(result: unknown, toolName: string): void {\n  if (!result || typeof result !== \"object\" || Array.isArray(result)) {\n    return;\n  }\n  const { _meta, ...modelVisibleResult } = result as Record<string, unknown>;\n  const tokenCount = estimateContextTokens(modelVisibleResult);\n  if (tokenCount >= TOOL_OUTPUT_WARNING_TOKENS) {\n    console.warn(\n      `[skybridge] Tool \"${toolName}\" returned ${tokenCount} estimated model-visible tokens; this reaches the ${TOOL_OUTPUT_WARNING_TOKENS}-token warning threshold and may overload model context. Content and structured content are included in this estimate.`,\n    );\n  }\n}\n\nexport function warnOnLargeViewState(value: unknown, source: string): void {\n  const tokenCount = estimateContextTokens(value);\n  if (tokenCount >= VIEW_STATE_WARNING_TOKENS) {\n    console.warn(\n      `[skybridge] ${source} is persisting ${tokenCount} estimated tokens in model-visible view state; this reaches the ${VIEW_STATE_WARNING_TOKENS}-token warning threshold and may overload model context. Persisted view state and data-llm context are included in this estimate.`,\n    );\n  }\n}\n"]}

package/dist/context-warnings.test.js

@@ -0,0 +1,28 @@
+import { describe, expect, it, vi } from "vitest";
+import { estimateContextTokens, TOOL_OUTPUT_WARNING_TOKENS, warnOnLargeToolOutput, } from "./context-warnings.js";
+describe("context warnings", () => {
+    it("estimates UTF-8 bytes and returns zero for no content", () => {
+        expect(estimateContextTokens("é")).toBe(1);
+        expect(estimateContextTokens(undefined)).toBe(0);
+    });
+    it("warns when model-visible tool output reaches the threshold", () => {
+        const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        warnOnLargeToolOutput({
+            content: [
+                {
+                    type: "text",
+                    text: "x".repeat(TOOL_OUTPUT_WARNING_TOKENS * 4),
+                },
+            ],
+        }, "large-output");
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('Tool "large-output" returned'));
+        warnSpy.mockRestore();
+    });
+    it("does not warn for large metadata", () => {
+        const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        warnOnLargeToolOutput({ content: [], _meta: { private: "x".repeat(100_000) } }, "large-meta");
+        expect(warnSpy).not.toHaveBeenCalled();
+        warnSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=context-warnings.test.js.map

package/dist/context-warnings.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-warnings.test.js","sourceRoot":"","sources":["../src/context-warnings.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEvE,qBAAqB,CACnB;YACE,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,0BAA0B,GAAG,CAAC,CAAC;iBACjD;aACF;SACF,EACD,cAAc,CACf,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAClC,MAAM,CAAC,gBAAgB,CAAC,8BAA8B,CAAC,CACxD,CAAC;QACF,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEvE,qBAAqB,CACnB,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EACxD,YAAY,CACb,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACvC,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it, vi } from \"vitest\";\nimport {\n  estimateContextTokens,\n  TOOL_OUTPUT_WARNING_TOKENS,\n  warnOnLargeToolOutput,\n} from \"./context-warnings.js\";\n\ndescribe(\"context warnings\", () => {\n  it(\"estimates UTF-8 bytes and returns zero for no content\", () => {\n    expect(estimateContextTokens(\"é\")).toBe(1);\n    expect(estimateContextTokens(undefined)).toBe(0);\n  });\n\n  it(\"warns when model-visible tool output reaches the threshold\", () => {\n    const warnSpy = vi.spyOn(console, \"warn\").mockImplementation(() => {});\n\n    warnOnLargeToolOutput(\n      {\n        content: [\n          {\n            type: \"text\",\n            text: \"x\".repeat(TOOL_OUTPUT_WARNING_TOKENS * 4),\n          },\n        ],\n      },\n      \"large-output\",\n    );\n\n    expect(warnSpy).toHaveBeenCalledWith(\n      expect.stringContaining('Tool \"large-output\" returned'),\n    );\n    warnSpy.mockRestore();\n  });\n\n  it(\"does not warn for large metadata\", () => {\n    const warnSpy = vi.spyOn(console, \"warn\").mockImplementation(() => {});\n\n    warnOnLargeToolOutput(\n      { content: [], _meta: { private: \"x\".repeat(100_000) } },\n      \"large-meta\",\n    );\n\n    expect(warnSpy).not.toHaveBeenCalled();\n    warnSpy.mockRestore();\n  });\n});\n"]}

package/dist/server/app.d.ts

@@ -0,0 +1,194 @@
+import type { Implementation, Server as SdkServer, ServerOptions } from "@modelcontextprotocol/server";
+import type { ErrorRequestHandler, Express, RequestHandler } from "express";
+import type { OAuthConfig, OAuthProvider } from "./auth/index.js";
+import type { ExtraClaims } from "./auth.js";
+import { type JsonOptions, McpServer, type McpServerTypes, type ToolDef } from "./server.js";
+/**
+ * The `handler` field of {@link SkybridgeConfig}: builds the app's MCP
+ * surface. Runs again for **every incoming request**, on a fresh
+ * {@link McpServer}, so keep it to registration: pools, clients and any other
+ * one-time work belong in `setup`, whose result is the second argument. It
+ * must **return** the chained server so `typeof app` carries the registered
+ * tool types.
+ *
+ * @typeParam TConfig - What `setup` resolved to, passed as the second argument.
+ */
+export type SkybridgeHandler<TTools extends Record<string, ToolDef>, TConfig, TAuthExtra extends ExtraClaims> = (server: McpServer<Record<never, ToolDef>, TAuthExtra>, config: TConfig) => McpServer<TTools, TAuthExtra>;
+/**
+ * What the `oauth` field accepts: an {@link OAuthConfig}, a provider
+ * (`oauth: auth0Provider(...)`), or a function of the `setup` result returning
+ * either. Providers and functions resolve once, at {@link Skybridge.run} or on
+ * the first request, never at module import. Anything asynchronous belongs in
+ * a provider's `resolve`.
+ */
+export type SkybridgeOAuthInput<TConfig, TExtra extends ExtraClaims> = OAuthConfig<TExtra> | OAuthProvider<TExtra> | ((config: TConfig) => OAuthConfig<TExtra> | OAuthProvider<TExtra>);
+/**
+ * Everything a Skybridge app needs in one bag: the MCP implementation info
+ * (`name`, `version`, …), the SDK's {@link ServerOptions} (`capabilities`,
+ * `instructions`, …), the Express and skills options, and the app's behavior
+ * (`setup`, `oauth`, `handler`).
+ *
+ * All type parameters are inferred from the value: the config from `setup`,
+ * the auth claims from `oauth`, and the tool registry from the server
+ * `handler` returns.
+ */
+export type SkybridgeConfig<TTools extends Record<string, ToolDef> = Record<never, ToolDef>, TConfig = undefined, TAuthExtra extends ExtraClaims = ExtraClaims> = Implementation & ServerOptions & {
+    /** Options for the built-in `express.json()` middleware, e.g. `{ limit: "10mb" }`. */
+    json?: JsonOptions;
+    /**
+     * @experimental Serve Agent Skills from `src/skills` over MCP (SEP-2640).
+     * API may change.
+     */
+    skills?: boolean;
+    /**
+     * Loads whatever the app needs up front (remote config, secrets, datasets,
+     * …). Runs **once** — at {@link Skybridge.run} or on the first request,
+     * never at module import — and its awaited return value is passed to an
+     * `oauth` function and to `handler` as the second argument.
+     */
+    setup?: () => TConfig;
+    /**
+     * Resource-server OAuth. When set, mounts the well-known metadata routes
+     * and bearer auth on `/mcp`, and the verifier's claims type
+     * `extra.http.authInfo.extra` in tool handlers.
+     */
+    oauth?: SkybridgeOAuthInput<Awaited<TConfig>, TAuthExtra>;
+    /** Registers the MCP surface, per request. See {@link SkybridgeHandler}. */
+    handler: SkybridgeHandler<TTools, Awaited<TConfig>, TAuthExtra>;
+};
+/**
+ * A Skybridge app: the HTTP surface (Express, OAuth metadata, the `/mcp`
+ * route) plus a handler that builds the MCP server for each request.
+ *
+ * The handler runs for every request, so tools, resources, prompts and views
+ * are always registered on the instance that serves the request. Anything in
+ * the handler body other than registration therefore runs per request too.
+ * Anything asynchronous the app needs (remote config, secrets, …) goes in
+ * `setup`, which runs once and feeds the handler's second argument.
+ *
+ * @example
+ * ```ts
+ * export const app = new Skybridge({
+ *   name: "my-app",
+ *   version: "1.0.0",
+ *   setup: async () => loadConfig(),
+ *   oauth: (config) => descopeProvider({ url: config.mcpServerUrl }),
+ *   handler: (server, config) =>
+ *     server.registerTool(
+ *       {
+ *         name: "search",
+ *         inputSchema: { query: z.string() },
+ *         view: { component: "search" },
+ *       },
+ *       async ({ query }) => ({ content: `Results for ${query}` }),
+ *     ),
+ * });
+ *
+ * export type AppType = typeof app;
+ * ```
+ *
+ * @see https://docs.skybridge.tech/api-reference/mcp-server
+ */
+export declare class Skybridge<TTools extends Record<string, ToolDef> = Record<never, ToolDef>, TConfig = undefined, TAuthExtra extends ExtraClaims = ExtraClaims> {
+    readonly $types: McpServerTypes<TTools>;
+    private readonly serverInfo;
+    private readonly serverOptions;
+    private readonly skills?;
+    private oauthEnabled;
+    private readonly handler;
+    private readonly setup?;
+    private readonly oauthInput?;
+    private config?;
+    private readonly expressApp;
+    private readonly errorMiddleware;
+    private readonly monitoringEntry;
+    private resolveResourceMetadataUrl?;
+    private readyPromise?;
+    private slowHandlerWarned;
+    constructor({ name, title, version, description, icons, websiteUrl, json, skills, setup, oauth, handler, ...serverOptions }: SkybridgeConfig<TTools, TConfig, TAuthExtra>);
+    /**
+     * Resolve `setup` and `oauth`, then wire OAuth onto the Express app. Runs
+     * once; every entry point that needs a built server awaits it, and a failed
+     * attempt is retried on the next call.
+     *
+     * @internal
+     */
+    ready(): Promise<void>;
+    /**
+     * The underlying Express app. Use this to extend the HTTP server with
+     * custom routes, middleware, or settings — e.g.
+     * `app.express.get("/health", ...)`.
+     *
+     * `express.json()` is pre-applied — tune it via the `json` config field,
+     * e.g. `new Skybridge({ name, version, json: { limit: "10mb" }, handler })`.
+     * Register your handlers before `run()`; after `run()`, dev-mode middleware,
+     * the `/mcp` route, and the default error handler are appended in that order.
+     *
+     * Note: Alpic Cloud only routes traffic to `/mcp` — custom routes work
+     * locally and on self-hosted deployments.
+     */
+    get express(): Express;
+    /**
+     * Build a fresh server for one stateless HTTP request, as
+     * `createMcpHandler`'s factory contract requires: the handler runs again so
+     * the SDK's handler closures belong to the instance whose protocol era it
+     * stamps. Sharing one instance's handler maps instead would bind them to an
+     * instance that is never marked, pinning every request to the 2025 codec and
+     * letting concurrent callers overwrite each other's negotiated version.
+     *
+     * Awaits `setup` and the `oauth` input on first use.
+     */
+    createServerInstance(): Promise<SdkServer>;
+    /**
+     * Connect a Skybridge app to an MCP transport. Use this when you're
+     * embedding Skybridge in a host that already manages its own transport
+     * (e.g. stdio for desktop apps); for HTTP, prefer {@link Skybridge.run}
+     * which sets the transport up for you.
+     */
+    connect(transport: Parameters<SdkServer["connect"]>[0]): Promise<void>;
+    /**
+     * Register Express middleware on the underlying app. Mirrors `app.use` —
+     * pass handlers directly or a path-prefixed handler list. Register before
+     * {@link Skybridge.run}; ordering matches Express.
+     *
+     * Note: Alpic Cloud only routes traffic to `/mcp`. Custom paths work
+     * locally and on self-hosted deployments.
+     */
+    use(...handlers: RequestHandler[]): this;
+    use(path: string, ...handlers: RequestHandler[]): this;
+    /**
+     * Register Express error-handling middleware to run after the built-in
+     * `/mcp` route (or your custom route). Use this to log or transform errors
+     * thrown by tool handlers before the default error handler responds.
+     *
+     * @example
+     * ```ts
+     * app.useOnError((err, _req, _res, next) => {
+     *   logger.error(err);
+     *   next(err);
+     * });
+     * ```
+     */
+    useOnError(...handlers: ErrorRequestHandler[]): this;
+    useOnError(path: string, ...handlers: ErrorRequestHandler[]): this;
+    /**
+     * Start the HTTP server. Listens on `process.env.__PORT` (default `3000`),
+     * mounts the `/mcp` route, and applies any custom Express middleware
+     * registered via {@link Skybridge.use} / {@link Skybridge.useOnError}.
+     *
+     * On Cloudflare Workers / workerd, returns an object exposing `fetch` so
+     * the runtime can bridge incoming requests to the Node HTTP server. On
+     * Vercel (`VERCEL === "1"`), returns the Express app directly so the
+     * serverless function entry can call it as a `(req, res)` handler. On
+     * Node, returns `undefined` once listening. When the process was spawned
+     * with an IPC channel, the bound port is reported to the parent as
+     * `{ type: "skybridge:listening", port }`, the readiness signal test runners
+     * wait on instead of polling.
+     */
+    run(): Promise<{
+        fetch: (...args: unknown[]) => unknown;
+    } | Express | undefined>;
+    private buildServer;
+    private middlewareEntries;
+    private instrumentHandlers;
+}