@serverkgg/bridge 0.1.10 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@serverkgg/bridge",
-	"version": "0.1.10",
+	"version": "0.1.11",
 	"description": "Serverk game bridge and driver runtime, wire protocol, manifest schema, and maintainer CLI",
 	"homepage": "https://serverk.gg",
 	"license": "SEE LICENSE IN LICENSE.md",

package/src/bot/botCauses.test.ts

@@ -25,6 +25,26 @@ const CASES: readonly {
 		line: "GrammyError: Call to 'getMe' failed! (401: Unauthorized)",
 		cause: BridgeCrashCause.TokenInvalid,
 	},
+	{
+		line: "TelegramError: 401: Unauthorized",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: 'error: [polling_error] {"code":"ETELEGRAM","message":"ETELEGRAM: 401 Unauthorized"}',
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "TelegramApiError: 401: Unauthorized",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "DiscordAPIError[0]: 401: Unauthorized",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "httpx.HTTPStatusError: Client error '401 Unauthorized' for url 'https://api.telegram.org/bot***/getMe'",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
 	{
 		line: "telegram.error.InvalidToken: The token `123:abc` was rejected by the server.",
 		cause: BridgeCrashCause.TokenInvalid,
@@ -101,6 +121,18 @@ const CASES: readonly {
 		line: "discord.errors.PrivilegedIntentsRequired: Shard ID None is requesting privileged intents that have not been explicitly enabled in the developer portal.",
 		cause: BridgeCrashCause.IntentsDisallowed,
 	},
+	{
+		line: "Error: Disallowed intents specified",
+		cause: BridgeCrashCause.IntentsDisallowed,
+	},
+	{
+		line: "GatewayError: Disallowed intents specified. Make sure any privileged intents you're trying to access have been enabled in the developer portal.",
+		cause: BridgeCrashCause.IntentsDisallowed,
+	},
+	{
+		line: "hikari.errors.GatewayServerClosedConnectionError: Server closed connection with code 4014 (Disallowed intent(s))",
+		cause: BridgeCrashCause.IntentsDisallowed,
+	},
 	{
 		line: "telegram.error.Conflict: Conflict: terminated by other getUpdates request; make sure that only one bot instance is running",
 		cause: BridgeCrashCause.TokenInUse,
@@ -109,6 +141,22 @@ const CASES: readonly {
 		line: "GrammyError: Call to 'getUpdates' failed! (409: Conflict: terminated by other getUpdates request; make sure that only one bot instance is running)",
 		cause: BridgeCrashCause.TokenInUse,
 	},
+	{
+		line: "TelegramError: 409: Conflict: terminated by other getUpdates request; make sure that only one bot instance is running",
+		cause: BridgeCrashCause.TokenInUse,
+	},
+	{
+		line: 'error: [polling_error] {"code":"ETELEGRAM","message":"ETELEGRAM: 409 Conflict: terminated by other getUpdates request; make sure that only one bot instance is running"}',
+		cause: BridgeCrashCause.TokenInUse,
+	},
+	{
+		line: "TelegramApiError: 409: Conflict: terminated by other getUpdates request; make sure that only one bot instance is running",
+		cause: BridgeCrashCause.TokenInUse,
+	},
+	{
+		line: "TelegramError: 409: Conflict: terminated by setWebhook request",
+		cause: BridgeCrashCause.TokenInUse,
+	},
 	{
 		line: "GrammyError: Call to 'getUpdates' failed! (409: Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first)",
 		cause: BridgeCrashCause.WebhookActive,
@@ -145,6 +193,10 @@ const CASES: readonly {
 		line: "ERROR:    [Errno 98] error while attempting to bind on address ('0.0.0.0', 8080): address already in use",
 		cause: BridgeCrashCause.PortBusy,
 	},
+	{
+		line: "OSError: [Errno 48] Address already in use",
+		cause: BridgeCrashCause.PortBusy,
+	},
 	{
 		line: "Error: Cannot find module 'discord.js'",
 		cause: BridgeCrashCause.MissingDependency,
@@ -221,6 +273,14 @@ const CASES: readonly {
 		line: "error code: 1015",
 		cause: BridgeCrashCause.RateLimited,
 	},
+	{
+		line: "Error 1015: You are being rate limited",
+		cause: BridgeCrashCause.RateLimited,
+	},
+	{
+		line: '"message": "You are being rate limited.",',
+		cause: BridgeCrashCause.RateLimited,
+	},
 	{
 		line: "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory",
 		cause: BridgeCrashCause.OutOfMemory,
@@ -401,6 +461,27 @@ describe("BOT_CRASH_EVIDENCE", () => {
 		expect(ring.crash(recordOf())).toBe(BridgeCrashCause.Unknown);
 	});
 
+	for (const line of [
+		"AxiosError: Request failed with status code 401",
+		"AxiosError: Request failed with status code 409",
+		"requests.exceptions.HTTPError: 401 Client Error: Unauthorized for url: https://api.spotify.com/v1/me",
+		"requests.exceptions.HTTPError: 409 Client Error: Conflict for url: https://api.github.com/repos/owner/repo/merges",
+		"aiohttp.client_exceptions.ClientResponseError: 401, message='Unauthorized', url='https://api.spotify.com/v1/me'",
+		"httpx.HTTPStatusError: Client error '401 Unauthorized' for url 'https://api.spotify.com/v1/me'",
+		"httpx.HTTPStatusError: Client error '409 Conflict' for url 'https://api.github.com/repos/owner/repo/merges'",
+		"urllib.error.HTTPError: HTTP Error 401: Unauthorized",
+		"urllib.error.HTTPError: HTTP Error 409: Conflict",
+		"openai.AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-proj-****. You can find your API key at https://platform.openai.com/account/api-keys.', 'type': 'invalid_request_error', 'param': None, 'code': 'invalid_api_key'}}",
+	]) {
+		it(`leaves a refusal from an API other than the bot's platform unexplained from "${line}"`, () => {
+			const { ring, print } = botRing();
+
+			print(line);
+
+			expect(ring.crash(recordOf())).toBe(BridgeCrashCause.Unknown);
+		});
+	}
+
 	it("calls exit 137 out of memory only when the record carries the flag", () => {
 		const unflagged = botRing();
 

package/src/bot/botCauses.ts

@@ -4,7 +4,7 @@ import { BridgeEventName } from "../protocol";
 export const BOT_CRASH_EVIDENCE: readonly BridgeEventPattern[] = [
 	{
 		match:
-			/\[TokenInvalid\]|An invalid token was provided|LoginFailure: Improper token|\b401:? Unauthorized\b|\bInvalidToken\b|TelegramUnauthorizedError|\bACCESS_TOKEN_(?:INVALID|EXPIRED)\b/,
+			/\[TokenInvalid\]|An invalid token was provided|LoginFailure: Improper token|(?:Telegram|ETELEGRAM|Call to '|\/bot[^/\s]*\/|DiscordAPIError\[).*\b401:? Unauthorized\b|\b401:? Unauthorized\b.*(?:Telegram|ETELEGRAM|\/bot[^/\s]*\/)|\bInvalidToken\b|TelegramUnauthorizedError|\bACCESS_TOKEN_(?:INVALID|EXPIRED)\b/,
 		emit: BridgeEventName.TokenInvalid,
 	},
 	{
@@ -19,7 +19,7 @@ export const BOT_CRASH_EVIDENCE: readonly BridgeEventPattern[] = [
 	},
 	{
 		match:
-			/Used disallowed intents|\[DisallowedIntents\]|Privileged intent provided is not enabled or whitelisted|PrivilegedIntentsRequired|close code:? 4014\b/,
+			/Used disallowed intents|\[DisallowedIntents\]|Privileged intent provided is not enabled or whitelisted|PrivilegedIntentsRequired|Disallowed intents specified|Server closed connection with code 4014\b|close code:? 4014\b/,
 		emit: BridgeEventName.IntentsDisallowed,
 	},
 	{
@@ -27,7 +27,8 @@ export const BOT_CRASH_EVIDENCE: readonly BridgeEventPattern[] = [
 		emit: BridgeEventName.WebhookActive,
 	},
 	{
-		match: /terminated by other getUpdates request|\b409:? Conflict\b/,
+		match:
+			/terminated by other getUpdates request|(?:Telegram|ETELEGRAM|Call to '|\/bot[^/\s]*\/).*\b409:? Conflict\b|\b409:? Conflict\b.*(?:Telegram|ETELEGRAM|\/bot[^/\s]*\/)/,
 		emit: BridgeEventName.TokenInUse,
 	},
 	{
@@ -71,6 +72,6 @@ export const BOT_CRASH_EVIDENCE: readonly BridgeEventPattern[] = [
 	{
 		match:
 			/FATAL ERROR: (?:Reached heap limit|Ineffective mark-compacts near heap limit) Allocation failed - JavaScript heap out of memory|^MemoryError\b/,
-		emit: BridgeEventName.ServerCrashed,
+		emit: BridgeEventName.OutOfMemory,
 	},
 ];

package/src/bot/detect/botInspectWarning.ts

@@ -15,4 +15,5 @@ export enum BotInspectWarning {
 	ManifestDisagrees = "manifest-disagrees",
 	ManifestInvalid = "manifest-invalid",
 	ReservedEnvKey = "reserved-env-key",
+	WebPort = "web-port",
 }

package/src/bot/detect/corpus/anonymousx1025-anonxmusic.json

@@ -27,7 +27,8 @@
 		".python-version": "3.13\n",
 		"Procfile": "worker: bash start\n",
 		"pyproject.toml": "[project]\nname = \"anonxmusic\"\nversion = \"3.0.3\"\ndescription = \"Telegram Group Calls Streaming bot with some useful features.\"\nreadme = \".github/README.md\"\nrequires-python = \">=3.10\"\n\ndependencies = [\n    \"aiohttp~=3.14.3\",\n    \"kurigram>=2.2.25\",\n    \"ntgcalls==3.0.0rc1\",\n    \"pillow~=12.3.0\",\n    \"psutil~=7.2.2\",\n    \"py-tgcalls==3.0.0rc1\",\n    \"py-yt-search~=0.8.0\",\n    \"pymongo>=4.17.0\",\n    \"pytgcrypto>=1.2.12\",\n    \"python-dotenv~=1.2.3\",\n    \"yt-dlp[default]>=2026.8.19\",\n]\n",
-		"requirements.txt": "aiohttp~=3.14.3\nkurigram>=2.2.25\nntgcalls==3.0.0rc1\npillow~=12.3.0\npsutil~=7.2.2\npy-tgcalls==3.0.0rc1\npy-yt-search~=0.8.0\npymongo>=4.17.0\npytgcrypto>=1.2.12\npython-dotenv~=1.2.3\nyt-dlp[default]>=2026.8.19\n"
+		"requirements.txt": "aiohttp~=3.14.3\nkurigram>=2.2.25\nntgcalls==3.0.0rc1\npillow~=12.3.0\npsutil~=7.2.2\npy-tgcalls==3.0.0rc1\npy-yt-search~=0.8.0\npymongo>=4.17.0\npytgcrypto>=1.2.12\npython-dotenv~=1.2.3\nyt-dlp[default]>=2026.8.19\n",
+		"sample.env": "# from my.telegram.org/apps\nAPI_ID=\nAPI_HASH=\n\n# from @BotFather on telegram\nBOT_TOKEN=\nLOGGER_ID=\n\n# mongo url from cloud.mongodb.com\nMONGO_URL=\n\nOWNER_ID=\n\n# pyrogram session from @StringFatherBot on telegram\nSESSION=\n"
 	},
 	"expected": {
 		"runtime": "python",
@@ -39,7 +40,7 @@
 		"start": "bash start",
 		"nodeVersion": null,
 		"pythonVersion": "3.13",
-		"tokenKey": null,
+		"tokenKey": "BOT_TOKEN",
 		"warnings": []
 	}
 }

package/src/bot/detect/corpus/bot-base-telegram-bot-template.json

@@ -30,6 +30,8 @@
 		"nodeVersion": "20",
 		"pythonVersion": null,
 		"tokenKey": "BOT_TOKEN",
-		"warnings": []
+		"warnings": [
+			"web-port"
+		]
 	}
 }

package/src/bot/detect/corpus/nezdemkovski-telegram-bot-boilerplate.json

@@ -35,6 +35,8 @@
 		"nodeVersion": null,
 		"pythonVersion": null,
 		"tokenKey": "BOT_TOKEN",
-		"warnings": []
+		"warnings": [
+			"web-port"
+		]
 	}
 }

package/src/bot/detect/corpus/serverk-discord-node.json

@@ -1,13 +1,14 @@
 {
 	"source": {
-		"url": "https://github.com/serverkgg/bot-node/tree/main/templates/discord-node",
+		"url": "https://github.com/serverkgg/bot-template-discord-node",
 		"branch": "main",
-		"commit": "3f9f6c033824857a9ffd849421fc5ecff31500d7",
+		"commit": "0c950227f6c2ab97b610080f2e9c9f60ff8c6069",
 		"stars": null
 	},
 	"files": [
 		".env.example",
 		".gitignore",
+		"AGENTS.md",
 		"LICENSE",
 		"README.md",
 		"index.js",

package/src/bot/detect/corpus/serverk-discord-python.json

@@ -1,13 +1,14 @@
 {
 	"source": {
-		"url": "https://github.com/serverkgg/bot-python/tree/main/templates/discord-python",
+		"url": "https://github.com/serverkgg/bot-template-discord-python",
 		"branch": "main",
-		"commit": "0a623a9dc114e31f0f2a5011e1f0471b2c047df3",
+		"commit": "e520ae1dfb07bb1e8a1eba73c5651a3ad3d39ad1",
 		"stars": null
 	},
 	"files": [
 		".env.example",
 		".gitignore",
+		"AGENTS.md",
 		"LICENSE",
 		"README.md",
 		"main.py",

package/src/bot/detect/corpus/serverk-telegram-node.json

@@ -1,13 +1,14 @@
 {
 	"source": {
-		"url": "https://github.com/serverkgg/bot-node/tree/main/templates/telegram-node",
+		"url": "https://github.com/serverkgg/bot-template-telegram-node",
 		"branch": "main",
-		"commit": "3f9f6c033824857a9ffd849421fc5ecff31500d7",
+		"commit": "49a55385c7336551dbb50b6ebc99a4e18743418f",
 		"stars": null
 	},
 	"files": [
 		".env.example",
 		".gitignore",
+		"AGENTS.md",
 		"LICENSE",
 		"README.md",
 		"index.js",

package/src/bot/detect/corpus/serverk-telegram-python.json

@@ -1,13 +1,14 @@
 {
 	"source": {
-		"url": "https://github.com/serverkgg/bot-python/tree/main/templates/telegram-python",
+		"url": "https://github.com/serverkgg/bot-template-telegram-python",
 		"branch": "main",
-		"commit": "0a623a9dc114e31f0f2a5011e1f0471b2c047df3",
+		"commit": "342e61c43f02f469c572f43cd3ed1e95ba85a130",
 		"stars": null
 	},
 	"files": [
 		".env.example",
 		".gitignore",
+		"AGENTS.md",
 		"LICENSE",
 		"README.md",
 		"main.py",

package/src/bot/detect/detect.test.ts

@@ -51,6 +51,16 @@ const TELEGRAM_PYTHON = {
 	".env.example": "TELEGRAM_TOKEN=\n",
 };
 
+const NPM_INSTALLED_PACKAGE = `${JSON.stringify(
+	{
+		dependencies: {
+			"discord.js": "^14.27.0",
+		},
+	},
+	null,
+	2,
+)}\n`;
+
 describe("detect on the templates", () => {
 	it("reads the discord.js template end to end", () => {
 		expect(
@@ -371,6 +381,89 @@ describe("detect on the templates", () => {
 		expect(project(TELEGRAM_PYTHON).pythonVersion).toBeNull();
 	});
 
+	const NODE_VERSION_CASES: readonly {
+		first: string;
+		second: string;
+		files: Record<string, string>;
+		version: string;
+	}[] = [
+		{
+			first: "engines.node",
+			second: ".nvmrc",
+			files: {
+				"package.json": JSON.stringify({
+					...JSON.parse(DISCORD_NODE["package.json"]),
+					engines: {
+						node: ">=18",
+					},
+				}),
+				".nvmrc": "v20.11.1\n",
+			},
+			version: "18",
+		},
+		{
+			first: ".nvmrc",
+			second: ".node-version",
+			files: {
+				".nvmrc": "v22.11.0\n",
+				".node-version": "20.11.1\n",
+			},
+			version: "22",
+		},
+		{
+			first: ".node-version",
+			second: ".tool-versions",
+			files: {
+				".node-version": "20.11.1\n",
+				".tool-versions": "nodejs 22.3.0\n",
+			},
+			version: "20",
+		},
+	];
+
+	for (const item of NODE_VERSION_CASES) {
+		it(`reads the Node version from ${item.first} before ${item.second}`, () => {
+			const result = project({
+				...DISCORD_NODE,
+				...item.files,
+			});
+
+			expect(result.nodeVersion).toBe(item.version);
+		});
+	}
+
+	it("reads the Python version from runtime.txt before the Pipfile's python_version", () => {
+		const result = project({
+			Pipfile:
+				'[[source]]\nurl = "https://pypi.org/simple"\nverify_ssl = true\nname = "pypi"\n\n[packages]\n"discord.py" = "*"\n\n[dev-packages]\n\n[requires]\npython_version = "3.10"\n',
+			"runtime.txt": "python-3.11.9\n",
+			"bot.py": "import discord\n",
+		});
+
+		expect(result.packageManager).toBe(BotPackageManager.Pipenv);
+		expect(result.pythonVersion).toBe("3.11");
+	});
+
+	it("installs with yarn when only engines.yarn names a manager and no lockfile ships", () => {
+		const result = project({
+			...DISCORD_NODE,
+			"package.json": JSON.stringify({
+				...JSON.parse(DISCORD_NODE["package.json"]),
+				engines: {
+					node: ">=18",
+					yarn: ">=1.22",
+				},
+			}),
+		});
+
+		expect(result.packageManager).toBe(BotPackageManager.Yarn);
+		expect(result.install).toEqual({
+			command: "corepack yarn install",
+			source: "package.json",
+		});
+		expect(result.warnings).toContain(BotInspectWarning.NoLockfile);
+	});
+
 	it("installs from the Python lockfiles, honouring uv and warning about the rest", () => {
 		const locked = (lockfile: string) => {
 			return project(
@@ -484,6 +577,107 @@ describe("detect start commands", () => {
 		});
 	});
 
+	const NODE_START_CASES: readonly {
+		file: string;
+		beside: string[];
+	}[] = [
+		{
+			file: "index.js",
+			beside: [
+				"src/index.js",
+				"bot.js",
+				"src/bot.js",
+				"index.ts",
+			],
+		},
+		{
+			file: "src/index.js",
+			beside: [
+				"bot.js",
+				"src/bot.js",
+				"index.ts",
+			],
+		},
+		{
+			file: "bot.js",
+			beside: [
+				"src/bot.js",
+				"index.ts",
+			],
+		},
+		{
+			file: "src/bot.js",
+			beside: [
+				"index.ts",
+			],
+		},
+		{
+			file: "index.ts",
+			beside: [],
+		},
+	];
+
+	for (const item of NODE_START_CASES) {
+		it(`starts ${item.file} when package.json names no start script and no main, ahead of [${item.beside.join(", ")}]`, () => {
+			const result = project(
+				{
+					"package.json": NPM_INSTALLED_PACKAGE,
+					[item.file]: "",
+				},
+				item.beside,
+			);
+
+			expect(result.start).toEqual({
+				command: `node ${item.file}`,
+				source: item.file,
+			});
+			expect(result.warnings).toEqual([
+				BotInspectWarning.NoLockfile,
+			]);
+		});
+	}
+
+	const PYTHON_START_CASES: readonly {
+		file: string;
+		beside: string[];
+	}[] = [
+		{
+			file: "app.py",
+			beside: [
+				"src/main.py",
+				"src/bot.py",
+			],
+		},
+		{
+			file: "src/main.py",
+			beside: [
+				"src/bot.py",
+			],
+		},
+		{
+			file: "src/bot.py",
+			beside: [],
+		},
+	];
+
+	for (const item of PYTHON_START_CASES) {
+		it(`starts ${item.file} when no main.py or bot.py exists, ahead of [${item.beside.join(", ")}]`, () => {
+			const result = project(
+				{
+					"requirements.txt": "python-telegram-bot==21.11.1\n",
+					[item.file]: "",
+				},
+				item.beside,
+			);
+
+			expect(result.start).toEqual({
+				command: `python ${item.file}`,
+				source: item.file,
+			});
+			expect(result.warnings).toEqual([]);
+		});
+	}
+
 	it("starts the one Python package that has a __main__ module when no start file exists", () => {
 		expect(
 			project(
@@ -700,6 +894,68 @@ describe("detect warnings", () => {
 		]);
 		expect(loud.warnings).toContain(BotInspectWarning.ReservedEnvKey);
 	});
+
+	it("warns that a node bot reading PORT needs the web address, and keeps PORT among the variables", () => {
+		const result = project({
+			...DISCORD_NODE,
+			"index.js": "const token = process.env.DISCORD_TOKEN;\napp.listen(process.env.PORT);\n",
+		});
+
+		expect(result.env.map((entry) => entry.key)).toEqual([
+			"DISCORD_TOKEN",
+			"PORT",
+		]);
+		expect(result.warnings).toContain(BotInspectWarning.WebPort);
+	});
+
+	it("warns that a python bot whose example file lists a webhook needs the web address", () => {
+		const result = project({
+			...TELEGRAM_PYTHON,
+			".env.example": "TELEGRAM_TOKEN=\nWEBHOOK_URL=\n",
+		});
+
+		expect(result.env.map((entry) => entry.key)).toEqual([
+			"TELEGRAM_TOKEN",
+			"WEBHOOK_URL",
+		]);
+		expect(result.warnings).toContain(BotInspectWarning.WebPort);
+	});
+
+	it("reads a webhook key on a discord bot as an outgoing log webhook, and on a telegram bot as one it receives", () => {
+		const discord = project({
+			...DISCORD_NODE,
+			".env.example": "DISCORD_TOKEN=\nLOG_WEBHOOK_URL=\n",
+		});
+
+		expect(discord.platform).toBe(BotPlatform.Discord);
+		expect(discord.env.map((entry) => entry.key)).toEqual([
+			"DISCORD_TOKEN",
+			"LOG_WEBHOOK_URL",
+		]);
+		expect(discord.warnings).not.toContain(BotInspectWarning.WebPort);
+
+		const telegram = project({
+			...TELEGRAM_PYTHON,
+			".env.example": "TELEGRAM_TOKEN=\nLOG_WEBHOOK_URL=\n",
+		});
+
+		expect(telegram.platform).toBe(BotPlatform.Telegram);
+		expect(telegram.warnings).toContain(BotInspectWarning.WebPort);
+	});
+
+	it("keeps quiet about the web address for a bot that reads neither PORT nor a webhook", () => {
+		const result = project({
+			...DISCORD_NODE,
+			"index.js": "const token = process.env.DISCORD_TOKEN;\nconst port = process.env.SERVER_PORT;\n",
+		});
+
+		expect(result.env.map((entry) => entry.key)).toEqual([
+			"DISCORD_TOKEN",
+			"SERVER_PORT",
+		]);
+		expect(result.warnings).not.toContain(BotInspectWarning.WebPort);
+		expect(project(TELEGRAM_PYTHON).warnings).not.toContain(BotInspectWarning.WebPort);
+	});
 });
 
 describe("detect with serverk.json", () => {
@@ -733,6 +989,32 @@ describe("detect with serverk.json", () => {
 		expect(result.warnings).toContain(BotInspectWarning.ManifestDisagrees);
 	});
 
+	it("says when the file names a runtime the code is not written in", () => {
+		const disagrees = project({
+			...TELEGRAM_PYTHON,
+			"serverk.json": JSON.stringify({
+				runtime: "node",
+			}),
+		});
+
+		expect(disagrees.runtime).toBe(BotRuntime.Node);
+		expect(disagrees.warnings).toEqual([
+			BotInspectWarning.NoStart,
+			BotInspectWarning.NoManifest,
+			BotInspectWarning.ManifestDisagrees,
+		]);
+
+		const agrees = project({
+			...TELEGRAM_PYTHON,
+			"serverk.json": JSON.stringify({
+				runtime: "python",
+			}),
+		});
+
+		expect(agrees.runtime).toBe(BotRuntime.Python);
+		expect(agrees.warnings).toEqual([]);
+	});
+
 	it("installs with the file's own install command over the lockfile's", () => {
 		const result = project({
 			...DISCORD_NODE,
@@ -847,6 +1129,9 @@ describe("detect env suggestions", () => {
 		{
 			file: ".env.dist",
 		},
+		{
+			file: "sample.env",
+		},
 	];
 
 	for (const item of CASES) {

package/src/bot/detect/detect.ts

@@ -2,15 +2,16 @@ import type { BotFramework } from "./botFramework";
 import { BOT_FRAMEWORKS, type BotFrameworkSpec, botFrameworkSpec } from "./botFrameworks";
 import { BotInspectWarning } from "./botInspectWarning";
 import { BotPackageManager } from "./botPackageManager";
-import type { BotPlatform } from "./botPlatform";
+import { BotPlatform } from "./botPlatform";
 import { BOT_RUNTIME_PACKAGES, BotRuntime } from "./botRuntime";
 import { BOT_TOKEN_KEYS, platformOfKey } from "./botToken";
+import { nodeLtsMajorOf } from "./detectedVersion";
 import type { DetectEntry, DetectedCommand, DetectedEnvKey, DetectInput, DetectResult } from "./detectResult";
 import { DETECT_TABLE, type DetectVersionFile } from "./detectTable";
 import { ENV_EXAMPLE_FILES, ENV_FILE, isSecretEnvFile, parseEnvExample } from "./envExample";
 import { isEnvKey } from "./envKey";
 import { isNodeSource, isPythonSource, scanEnvKeys } from "./envScan";
-import { BOT_PROTECTED_KEYS, BOT_PROVIDED_KEYS, isReservedBotKey } from "./keys";
+import { BOT_PROTECTED_KEYS, BOT_PROVIDED_KEYS, isReservedBotKey, PORT } from "./keys";
 import { isSensitiveKey } from "./sensitiveKey";
 import { parseServerkJson, SERVERK_JSON, type ServerkJson } from "./serverkJson";
 
@@ -79,6 +80,8 @@ const TOKEN_KEY = /TOKEN/i;
 
 const BOT_KEY = /BOT/i;
 
+const WEBHOOK_KEY = /WEBHOOK/i;
+
 const NODE_IMPORT = /(?:\brequire\s*\(\s*|\bfrom\s+|\bimport\s*\(\s*|\bimport\s+)(["'])([^"'\n]+)\1/g;
 
 const PYTHON_IMPORT = /^[ \t]*(?:from[ \t]+([A-Za-z_]\w*)|import[ \t]+([A-Za-z_]\w*))/gm;
@@ -192,14 +195,16 @@ const START_FILES: readonly string[] = [
 ];
 
 const FIXED_FILES: readonly string[] = [
-	DETECT_TABLE.node.manifest,
-	REQUIREMENTS_FILE,
-	PYPROJECT_FILE,
-	DETECT_TABLE.procfile.file,
-	SERVERK_JSON,
-	...ENV_EXAMPLE_FILES,
-	...DETECT_TABLE.node.versionFiles.map((entry) => entry.file),
-	...DETECT_TABLE.python.versionFiles.map((entry) => entry.file),
+	...new Set([
+		DETECT_TABLE.node.manifest,
+		REQUIREMENTS_FILE,
+		PYPROJECT_FILE,
+		DETECT_TABLE.procfile.file,
+		SERVERK_JSON,
+		...ENV_EXAMPLE_FILES,
+		...DETECT_TABLE.node.versionFiles.map((entry) => entry.file),
+		...DETECT_TABLE.python.versionFiles.map((entry) => entry.file),
+	]),
 ];
 
 const sourceRank = (path: string) => {
@@ -587,7 +592,11 @@ const nodeBuildOf = (packageJson: PackageJson | null, manager: string): Detected
 	};
 };
 
-const versionFromFile = (text: string, spec: DetectVersionFile): string | null => {
+const versionFromFile = (
+	text: string,
+	spec: DetectVersionFile,
+	aliasOf: (value: string) => string | null,
+): string | null => {
 	for (const raw of text.split("\n")) {
 		let line = raw.trim();
 
@@ -623,7 +632,7 @@ const versionFromFile = (text: string, spec: DetectVersionFile): string | null =
 			line = line.slice(spec.prefix.length);
 		}
 
-		return VERSION_NUMBER.exec(line)?.[1] ?? null;
+		return VERSION_NUMBER.exec(line)?.[1] ?? aliasOf(line);
 	}
 
 	return null;
@@ -633,6 +642,7 @@ const versionFromFiles = (
 	specs: readonly DetectVersionFile[],
 	read: (path: string) => string | null,
 	parts: number,
+	aliasOf: (value: string) => string | null = () => null,
 ): string | null => {
 	for (const spec of specs) {
 		const text = read(spec.file);
@@ -641,7 +651,7 @@ const versionFromFiles = (
 			continue;
 		}
 
-		const version = versionFromFile(text, spec);
+		const version = versionFromFile(text, spec, aliasOf);
 
 		if (version !== null) {
 			return version.split(".").slice(0, parts).join(".");
@@ -731,7 +741,7 @@ const nodeRequirementOf = (
 		}
 	}
 
-	const version = versionFromFiles(DETECT_TABLE.node.versionFiles, read, 1);
+	const version = versionFromFiles(DETECT_TABLE.node.versionFiles, read, 1, nodeLtsMajorOf);
 
 	return version === null
 		? null
@@ -845,6 +855,19 @@ const committedWarnings = (paths: ReadonlySet<string>, warnings: Set<BotInspectW
 	}
 };
 
+const webPortWarning = (
+	platform: BotPlatform | null,
+	env: readonly DetectedEnvKey[],
+	warnings: Set<BotInspectWarning>,
+) => {
+	const keys = env.map((entry) => entry.key);
+	const webhook = platform !== BotPlatform.Discord && keys.some((key) => WEBHOOK_KEY.test(key));
+
+	if (keys.includes(PORT) || webhook) {
+		warnings.add(BotInspectWarning.WebPort);
+	}
+};
+
 interface EnvCollector {
 	add(key: string, source: string, sensitive: boolean | null, example: string | null): void;
 	entries: DetectedEnvKey[];
@@ -1165,6 +1188,8 @@ export const detect = (input: DetectInput): DetectResult => {
 	);
 	const platform = platformOf(serverk, framework, candidates, keyPlatforms, warnings);
 
+	webPortWarning(platform, env.entries, warnings);
+
 	return {
 		runtime,
 		package: runtime ? BOT_RUNTIME_PACKAGES[runtime] : null,

package/src/bot/detect/detectTable.ts

@@ -230,6 +230,10 @@ export const DETECT_TABLE: DetectTable = {
 				file: ".tool-versions",
 				tool: "nodejs",
 			},
+			{
+				file: ".tool-versions",
+				tool: "node",
+			},
 		],
 		defaultVersion: "24",
 	},

package/src/bot/detect/detectedVersion.test.ts

@@ -0,0 +1,160 @@
+import { describe, expect, it } from "bun:test";
+import { BotInspectWarning } from "./botInspectWarning";
+import { BotRuntime } from "./botRuntime";
+import { detect } from "./detect";
+import { nodeLtsMajorOf } from "./detectedVersion";
+import { DETECT_TABLE } from "./detectTable";
+
+const DISCORD_NODE = {
+	"package.json": JSON.stringify({
+		name: "discord-bot",
+		main: "index.js",
+		dependencies: {
+			"discord.js": "^14.27.0",
+		},
+	}),
+	"index.js": 'import { Client } from "discord.js";\nawait client.login(process.env.DISCORD_TOKEN);\n',
+};
+
+const resultOf = (files: Record<string, string>) => {
+	const contents = {
+		...DISCORD_NODE,
+		...files,
+	};
+
+	return detect({
+		files: Object.keys(contents).map((path) => ({
+			path,
+		})),
+		contents,
+	});
+};
+
+const LTS_CASES: readonly {
+	alias: string;
+	major: string | null;
+}[] = [
+	{
+		alias: "lts/iron",
+		major: "20",
+	},
+	{
+		alias: "LTS/Hydrogen",
+		major: "18",
+	},
+	{
+		alias: "lts/jod",
+		major: "22",
+	},
+	{
+		alias: "lts-krypton",
+		major: "24",
+	},
+	{
+		alias: " lts/argon ",
+		major: "4",
+	},
+	{
+		alias: "lts/*",
+		major: null,
+	},
+	{
+		alias: "lts/-1",
+		major: null,
+	},
+	{
+		alias: "lts",
+		major: null,
+	},
+	{
+		alias: "lts/unknown",
+		major: null,
+	},
+	{
+		alias: "lts/constructor",
+		major: null,
+	},
+	{
+		alias: "node",
+		major: null,
+	},
+];
+
+describe("nodeLtsMajorOf", () => {
+	for (const item of LTS_CASES) {
+		it(`reads ${item.alias} as ${item.major ?? "no fixed major"}`, () => {
+			expect(nodeLtsMajorOf(item.alias)).toBe(item.major);
+		});
+	}
+});
+
+describe("detect", () => {
+	it("reads the Node major an .nvmrc names by its LTS codename", () => {
+		expect(
+			resultOf({
+				".nvmrc": "lts/iron\n",
+			}).nodeVersion,
+		).toBe("20");
+		expect(
+			resultOf({
+				".nvmrc": "LTS/Hydrogen\n",
+			}).nodeVersion,
+		).toBe("18");
+		expect(
+			resultOf({
+				".nvmrc": "lts/*\n",
+			}).nodeVersion,
+		).toBeNull();
+	});
+
+	it("warns when an LTS codename names a major the image does not run", () => {
+		const result = resultOf({
+			".nvmrc": "lts/hydrogen\n",
+		});
+
+		expect(DETECT_TABLE.node.defaultVersion).not.toBe("18");
+		expect(result.warnings).toContain(BotInspectWarning.NodeVersionUnmet);
+	});
+
+	it("reads the Node version from .tool-versions under mise's node and asdf's nodejs", () => {
+		expect(
+			resultOf({
+				".tool-versions": "node 20.11.0\n",
+			}).nodeVersion,
+		).toBe("20");
+		expect(
+			resultOf({
+				".tool-versions": "nodejs 20.11.0\n",
+			}).nodeVersion,
+		).toBe("20");
+		expect(
+			resultOf({
+				".tool-versions": "python 3.12.1\nnode lts/jod\n",
+			}).nodeVersion,
+		).toBe("22");
+	});
+
+	it("leaves the Python version untouched by a Node LTS codename", () => {
+		const result = detect({
+			files: [
+				{
+					path: "requirements.txt",
+				},
+				{
+					path: "main.py",
+				},
+				{
+					path: ".python-version",
+				},
+			],
+			contents: {
+				"requirements.txt": "python-telegram-bot==21.11.1\n",
+				"main.py": "from telegram.ext import Application\n",
+				".python-version": "lts/iron\n",
+			},
+		});
+
+		expect(result.runtime).toBe(BotRuntime.Python);
+		expect(result.pythonVersion).toBeNull();
+	});
+});

package/src/bot/detect/detectedVersion.ts

@@ -1,5 +1,60 @@
 export const DETECTED_VERSION_PATTERN = /^\d+(?:\.\d+)?$/;
 
+const NODE_LTS_MAJORS: ReadonlyMap<string, string> = new Map([
+	[
+		"argon",
+		"4",
+	],
+	[
+		"boron",
+		"6",
+	],
+	[
+		"carbon",
+		"8",
+	],
+	[
+		"dubnium",
+		"10",
+	],
+	[
+		"erbium",
+		"12",
+	],
+	[
+		"fermium",
+		"14",
+	],
+	[
+		"gallium",
+		"16",
+	],
+	[
+		"hydrogen",
+		"18",
+	],
+	[
+		"iron",
+		"20",
+	],
+	[
+		"jod",
+		"22",
+	],
+	[
+		"krypton",
+		"24",
+	],
+]);
+
+const NODE_LTS_ALIAS = /^lts[/-]([a-z]+)$/i;
+
 export const isDetectedVersion = (value: string | null): value is string => {
 	return value !== null && DETECTED_VERSION_PATTERN.test(value);
 };
+
+export const nodeLtsMajorOf = (alias: string): string | null => {
+	const codename = NODE_LTS_ALIAS.exec(alias.trim())?.[1];
+
+	return codename === undefined ? null : (NODE_LTS_MAJORS.get(codename.toLowerCase()) ?? null);
+};

package/src/bot/detect/envExample.test.ts

@@ -69,6 +69,10 @@ describe("isSecretEnvFile", () => {
 			name: ".env.dist",
 			secret: false,
 		},
+		{
+			name: "sample.env",
+			secret: false,
+		},
 		{
 			name: ".env.defaults",
 			secret: false,

package/src/bot/detect/envExample.ts

@@ -7,6 +7,7 @@ export const ENV_EXAMPLE_FILES: readonly string[] = [
 	".env-example",
 	".env-sample",
 	".env.dist",
+	"sample.env",
 ];
 
 const ENV_TEMPLATE_FILES: ReadonlySet<string> = new Set([

package/src/bot/detect/envScan.test.ts

@@ -33,6 +33,116 @@ describe("scanEnvKeys", () => {
 		]);
 	});
 
+	it("finds a Bun.env property read", () => {
+		expect(scanEnvKeys("src/index.ts", "const token = Bun.env.DISCORD_TOKEN;")).toEqual([
+			"DISCORD_TOKEN",
+		]);
+	});
+
+	it("finds a Bun.env bracket read", () => {
+		expect(scanEnvKeys("src/index.ts", 'const guildId = Bun.env["GUILD_ID"] ?? "";')).toEqual([
+			"GUILD_ID",
+		]);
+	});
+
+	it("finds names destructured from Bun.env", () => {
+		expect(scanEnvKeys("src/config.ts", "const { DISCORD_TOKEN, CLIENT_ID } = Bun.env;")).toEqual([
+			"DISCORD_TOKEN",
+			"CLIENT_ID",
+		]);
+	});
+
+	it("finds environs reads, bare and typed", () => {
+		expect(
+			scanEnvKeys(
+				"tgbot/config.py",
+				[
+					"from environs import Env",
+					"",
+					"env = Env()",
+					"env.read_env(path)",
+					'BOT_TOKEN = env.str("BOT_TOKEN")',
+					'ADMIN_ID = env.int("ADMIN_ID")',
+					'admin_ids = env.list("ADMINS", subcast=int)',
+					'use_redis = env.bool("USE_REDIS")',
+					'rate = env.float("RATE_LIMIT", 1.5)',
+					'webhook = env.url("WEBHOOK_URL")',
+					'extra = env.json("EXTRA_OPTIONS")',
+					"SECRET_KEY = env('SECRET_KEY')",
+				].join("\n"),
+			),
+		).toEqual([
+			"BOT_TOKEN",
+			"ADMIN_ID",
+			"ADMINS",
+			"USE_REDIS",
+			"RATE_LIMIT",
+			"WEBHOOK_URL",
+			"EXTRA_OPTIONS",
+			"SECRET_KEY",
+		]);
+	});
+
+	it("finds python-decouple reads", () => {
+		expect(
+			scanEnvKeys(
+				"bot/settings.py",
+				[
+					"import decouple",
+					"from decouple import config",
+					"",
+					'TOKEN = config("TOKEN")',
+					'ADMIN_ID = config("ADMIN_ID", cast=int)',
+					'DEBUG = decouple.config("DEBUG", default=False, cast=bool)',
+				].join("\n"),
+			),
+		).toEqual([
+			"TOKEN",
+			"ADMIN_ID",
+			"DEBUG",
+		]);
+	});
+
+	it("orders names by where the file reads them across os and environs", () => {
+		expect(
+			scanEnvKeys(
+				"bot/config.py",
+				[
+					"import os",
+					"from environs import Env",
+					"",
+					"env = Env()",
+					'BOT_TOKEN = env.str("BOT_TOKEN")',
+					'REDIS_URL = os.getenv("REDIS_URL")',
+					'ADMIN_ID = env.int("ADMIN_ID")',
+				].join("\n"),
+			),
+		).toEqual([
+			"BOT_TOKEN",
+			"REDIS_URL",
+			"ADMIN_ID",
+		]);
+	});
+
+	it("reads no key from calls that only look like environs or decouple", () => {
+		expect(
+			scanEnvKeys(
+				"bot/main.py",
+				[
+					"env = {}",
+					'env["x"] = 1',
+					'value = env["x"]',
+					'logger.config("level")',
+					'logger.config("LEVEL")',
+					'config("level")',
+					'self.env.str("NOPE")',
+					'client.getenv("NOPE")',
+					'cfg.environ.get("NOPE")',
+				].join("\n"),
+			),
+		).toEqual([]);
+	});
+
 	it("reads nothing from files that are not code", () => {
 		expect(scanEnvKeys("README.md", "process.env.A")).toEqual([]);
 	});

package/src/bot/detect/envScan.ts

@@ -13,12 +13,14 @@ export const PYTHON_SOURCE_EXTENSIONS: readonly string[] = [
 
 const NAME = "([A-Za-z_][A-Za-z0-9_]*)";
 
+const UPPER_NAME = "([A-Z_][A-Z0-9_]*)";
+
 const NODE_PATTERNS: readonly RegExp[] = [
-	new RegExp(`\\bprocess\\.env\\.${NAME}`, "g"),
-	new RegExp(`\\bprocess\\.env\\[\\s*["'\`]${NAME}["'\`]\\s*\\]`, "g"),
+	new RegExp(`\\b(?:process|Bun)\\.env\\.${NAME}`, "g"),
+	new RegExp(`\\b(?:process|Bun)\\.env\\[\\s*["'\`]${NAME}["'\`]\\s*\\]`, "g"),
 ];
 
-const NODE_DESTRUCTURE = /\{([^{}]{1,2000})\}\s*=\s*process\.env\b/g;
+const NODE_DESTRUCTURE = /\{([^{}]{1,2000})\}\s*=\s*(?:process|Bun)\.env\b/g;
 
 const DESTRUCTURED_NAME = /^\s*([A-Za-z_][A-Za-z0-9_]*)/;
 
@@ -26,6 +28,8 @@ const PYTHON_PATTERNS: readonly RegExp[] = [
 	new RegExp(`(?<![\\w.])(?:os\\.)?environ\\[\\s*["']${NAME}["']\\s*\\]`, "g"),
 	new RegExp(`(?<![\\w.])(?:os\\.)?environ\\.get\\(\\s*["']${NAME}["']`, "g"),
 	new RegExp(`(?<![\\w.])(?:os\\.)?getenv\\(\\s*["']${NAME}["']`, "g"),
+	new RegExp(`(?<![\\w.])env(?:\\.\\w+)?\\(\\s*["']${UPPER_NAME}["']`, "g"),
+	new RegExp(`(?<![\\w.])(?:decouple\\.)?config\\(\\s*["']${UPPER_NAME}["']`, "g"),
 ];
 
 interface Found {

package/src/protocol/bridgeCrash.ts

@@ -34,7 +34,7 @@ export interface BridgeCrashEvidence {
 
 export const BRIDGE_CRASH_EVIDENCE: readonly BridgeCrashEvidence[] = [
 	{
-		name: BridgeEventName.ServerCrashed,
+		name: BridgeEventName.OutOfMemory,
 		cause: BridgeCrashCause.OutOfMemory,
 	},
 	{
@@ -101,6 +101,10 @@ export const BRIDGE_CRASH_EVIDENCE: readonly BridgeCrashEvidence[] = [
 		name: BridgeEventName.RateLimited,
 		cause: BridgeCrashCause.RateLimited,
 	},
+	{
+		name: BridgeEventName.ServerCrashed,
+		cause: BridgeCrashCause.Unknown,
+	},
 ];
 
 const BRIDGE_CRASH_EVIDENCE_NAMES: ReadonlySet<string> = new Set(BRIDGE_CRASH_EVIDENCE.map((entry) => entry.name));

package/src/protocol/bridgeEvents.ts

@@ -23,6 +23,7 @@ export enum BridgeEventName {
 	ModpackInstalled = "ModpackInstalled",
 	ModpackRemoved = "ModpackRemoved",
 	ModpackSelected = "ModpackSelected",
+	OutOfMemory = "OutOfMemory",
 	PlayerAdvanced = "PlayerAdvanced",
 	PlayerBanned = "PlayerBanned",
 	PlayerChanged = "PlayerChanged",

package/src/runtime/bridgeEvents.test.ts

@@ -291,7 +291,7 @@ describe("the crash record the ring builds", () => {
 			detail: "class file version 65",
 		});
 
-		ring.emit(BridgeEventName.ServerCrashed, {
+		ring.emit(BridgeEventName.OutOfMemory, {
 			error: "java.lang.OutOfMemoryError",
 		});
 
@@ -303,6 +303,57 @@ describe("the crash record the ring builds", () => {
 		});
 	});
 
+	it("ends a lone fatal crash line as unknown, in one record that carries the last line", () => {
+		const ring = idleRing();
+
+		ring.emit(BridgeEventName.ServerCrashed);
+
+		ring.crash(
+			crashRecord({
+				exitCode: 139,
+				lastLine: "Segmentation fault (core dumped)",
+			}),
+		);
+
+		expect(ring.drain(0).events).toEqual([
+			{
+				seq: 1,
+				event: BridgeEventName.ServerCrashed,
+				payload: {
+					cause: "unknown",
+					phase: "running",
+					exitCode: "139",
+					restarting: "no",
+					looping: "no",
+					restarts: "0",
+					uptimeSeconds: "12",
+					lastLine: "Segmentation fault (core dumped)",
+				},
+			},
+		]);
+	});
+
+	it("names a corrupt world over the fatal crash line of the same run", () => {
+		const ring = idleRing();
+
+		ring.emit(BridgeEventName.WorldCorrupt);
+		ring.emit(BridgeEventName.ServerCrashed);
+
+		ring.crash(
+			crashRecord({
+				lastLine: "Aborted (core dumped)",
+			}),
+		);
+
+		const crashed = ring.drain(0).events;
+
+		expect(crashed).toHaveLength(1);
+		expect(crashed.at(0)?.payload).toMatchObject({
+			cause: "world-corrupt",
+		});
+		expect(crashed.at(0)?.payload).not.toHaveProperty("lastLine");
+	});
+
 	it("never lets the evidence overwrite the record keys", () => {
 		const ring = idleRing();