@serverkgg/bridge 0.1.10 → 0.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@serverkgg/bridge",
-	"version": "0.1.10",
+	"version": "0.1.12",
 	"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) {