godot-daedalus_backend 1.0.0 → 1.0.1

package/README.md

@@ -37,6 +37,8 @@ npm install godot-daedalus_backend
 
 ## Run The WebSocket Backend
 
+After installing the package, start it through the published bin command:
+
 ```powershell
 $env:PORT = "8080"
 godot-daedalus-backend
@@ -44,6 +46,31 @@ godot-daedalus-backend
 
 The Godot plugin connects to this backend over WebSocket. Provider configuration, including the DeepSeek API key, is normally saved from the plugin settings UI.
 
+If the package is installed locally in another project, use npm exec or the local `.bin` command:
+
+```powershell
+npm exec godot-daedalus-backend
+.\node_modules\.bin\godot-daedalus-backend.cmd
+```
+
+Do not use `npm run dev` from the consuming Godot project unless that project's own `package.json` defines a `dev` script. `npm run dev` is only a source-repository development command.
+
+To add a convenient script in the consuming project:
+
+```json
+{
+  "scripts": {
+    "daedalus": "godot-daedalus-backend"
+  }
+}
+```
+
+Then run:
+
+```powershell
+npm run daedalus
+```
+
 ## Run The Godot MCP Server
 
 The standalone Godot MCP server requires a Godot project path:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godot-daedalus_backend",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "TypeScript backend for the Godot Daedalus editor assistant plugin.",
   "main": "./src/main.ts",
   "bin": {

package/src/protocol/schema.ts

@@ -79,6 +79,12 @@ export const clientRequestSchema = z.discriminatedUnion("method", [
 		method: z.literal("ping"),
 		params: z.object({}).optional(),
 	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("backend.health"),
+		params: z.object({}).optional(),
+	}),
 	z.object({
 		type: z.literal("request"),
 		id: z.string(),

package/src/server/request-dispatcher.ts

@@ -12,6 +12,7 @@ export type RequestHandler = (
 
 export const REQUEST_HANDLER_METHODS: readonly ClientRequest["method"][] = [
 	"ping",
+	"backend.health",
 	"provider.configure",
 	"provider.config.get",
 	"provider.config.set",

package/src/server/websocket-server.ts

@@ -1991,6 +1991,20 @@ async function handleRequest(socket: WebSocket, request: ClientRequest, session:
 			});
 			break;
 
+		case "backend.health":
+			sendJson(socket, {
+				type: "response",
+				id: request.id,
+				ok: true,
+				result: {
+					name: "godot-daedalus-backend",
+					version: "1.0.1",
+					pid: process.pid,
+					mode: process.env.NODE_ENV === "development" || process.env.npm_lifecycle_event === "dev" ? "development" : "runtime"
+				}
+			});
+			break;
+
 		case "provider.configure":
 			session.deepseekApiKey = request.params.apiKey;
 			session.deepseekModel = request.params.model;
@@ -3899,6 +3913,10 @@ async function handleRequest(socket: WebSocket, request: ClientRequest, session:
 export function createServer(port: number, mcpHost: McpHost): WebSocketServer {
 	const server: WebSocketServer = new WebSocketServer({ port });
 
+	server.on("headers", (headers: string[]): void => {
+		headers.push("X-Godot-Daedalus: websocket");
+	});
+
 	server.on("connection", (socket: WebSocket, request): void => {
 		const session: ClientSession = createClientSession(getDefaultWorkspace());
 		const remoteAddress: string = request.socket.remoteAddress ?? "unknown";