godot-daedalus_backend 1.0.0

package/src/protocol/schema.ts

@@ -0,0 +1,486 @@
+import { z } from "zod";
+
+export const promptIdSchema = z.enum([
+	"godot.assistant",
+	"gdscript.reviewer",
+	"scene.architect",
+	"backend.helper"
+]);
+
+export const skillIdSchema = z.enum([
+	"godot.project_init",
+	"gdscript.review",
+	"scene.builder",
+	"file.creator",
+	"backend.helper"
+]);
+
+export const additionalContextItemSchema = z.object({
+	id: z.string().min(1).max(160),
+	kind: z.enum(["editor_selection", "scene", "node", "file", "folder", "script", "script_selection", "filesystem_selection"]),
+	title: z.string().min(1).max(200),
+	subtitle: z.string().max(400).optional(),
+	pinned: z.boolean().optional(),
+	source: z.enum(["editor", "manual"]),
+	resourcePath: z.string().max(500).optional(),
+	nodePath: z.string().max(500).optional(),
+	nodeType: z.string().max(160).optional(),
+	scriptPath: z.string().max(500).optional(),
+	summary: z.string().max(1200).optional(),
+	data: z.unknown().optional()
+});
+
+export const aiChatParamsSchema = z.object({
+	message: z.string(),
+	promptId: promptIdSchema.optional(),
+	skillId: skillIdSchema.optional(),
+	systemPrompt: z.string().optional(),
+	retryFromRequestId: z.string().min(1).optional(),
+	additionalContext: z.array(additionalContextItemSchema).max(32).optional(),
+	options: z.object({
+		temperature: z.number().min(0).max(2).optional(),
+		topP: z.number().min(0).max(1).optional(),
+		maxTokens: z.number().int().positive().optional(),
+		stop: z.union([z.string(), z.array(z.string())]).optional(),
+		responseFormat: z.union([z.literal("text"), z.literal("json")]).optional(),
+		stream: z.boolean().optional(),
+		toolBudget: z.enum(["simple", "normal", "codegen", "project_edit"]).optional(),
+		workflow: z.enum(["auto", "single", "multi_phase", "llm_planned"]).optional(),
+	}).optional()
+});
+
+const guideTextSchema = z.string().min(1).max(4000);
+const customMcpSecretRecordSchema = z.record(z.string().min(1).max(160), z.string().max(20000))
+	.refine((value: Record<string, string>): boolean => Object.keys(value).length <= 64, "Too many secret entries");
+const customMcpServerInputSchema = z.discriminatedUnion("transport", [
+	z.object({
+		name: z.string().min(1).max(80),
+		description: z.string().max(300).optional(),
+		transport: z.literal("stdio"),
+		enabled: z.boolean().optional(),
+		command: z.string().min(1).max(300),
+		args: z.array(z.string().max(1000)).max(64).optional(),
+		env: customMcpSecretRecordSchema.optional(),
+	}),
+	z.object({
+		name: z.string().min(1).max(80),
+		description: z.string().max(300).optional(),
+		transport: z.literal("http"),
+		enabled: z.boolean().optional(),
+		url: z.string().url().max(1000),
+		headers: customMcpSecretRecordSchema.optional(),
+	})
+]);
+
+export const clientRequestSchema = z.discriminatedUnion("method", [
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("ping"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("provider.configure"),
+		params: z.object({
+			provider: z.literal("deepseek"),
+			apiKey: z.string().min(1),
+			model: z.string().min(1).optional(),
+			baseUrl: z.string().min(1).optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("provider.config.get"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("provider.config.set"),
+		params: z.object({
+			provider: z.literal("deepseek"),
+			apiKey: z.string().optional(),
+			model: z.string().min(1).optional(),
+			baseUrl: z.string().min(1).optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("provider.config.clear"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("ai.chat"),
+		params: aiChatParamsSchema,
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("ai.next_step_hints"),
+		params: z.object({
+			sessionId: z.string().min(1).optional(),
+			anchorRequestId: z.string().min(1).optional(),
+			trigger: z.enum(["done", "paused"]).optional(),
+			maxHints: z.number().int().min(1).max(5).optional(),
+		}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("ai.cancel"),
+		params: z.object({
+			requestId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("prompt.list"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("skill.list"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("skill.activate"),
+		params: z.object({
+			skillId: skillIdSchema.nullable(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.reset"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.info"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.create"),
+		params: z.object({
+			title: z.string().min(1),
+			workspaceId: z.string().optional(),
+			skillId: skillIdSchema.optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.open"),
+		params: z.object({
+			sessionId: z.string().min(1),
+			limit: z.number().int().positive().max(500).optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.timeline"),
+		params: z.object({
+			sessionId: z.string().min(1).optional(),
+			beforeOffset: z.number().int().min(0),
+			limit: z.number().int().positive().max(500).optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.list"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.archive"),
+		params: z.object({
+			sessionId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.archived.list"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.archived.restore"),
+		params: z.object({
+			sessionId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.archived.delete"),
+		params: z.object({
+			sessionId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.save"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.delete"),
+		params: z.object({
+			sessionId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.rename"),
+		params: z.object({
+			sessionId: z.string().min(1),
+			title: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.compress"),
+		params: z.object({
+			keepRecent: z.number().int().min(2).max(50).optional(),
+		}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.summary"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.guide.add"),
+		params: z.object({
+			clientGuideId: z.string().min(1).max(128),
+			text: guideTextSchema,
+			anchorRequestId: z.string().min(1).optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.guide.update"),
+		params: z.object({
+			guideId: z.string().min(1),
+			text: guideTextSchema,
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("session.guide.delete"),
+		params: z.object({
+			guideId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.listTools"),
+		params: z.object({
+			serverId: z.string().optional(),
+		}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.callTool"),
+		params: z.object({
+			serverId: z.string().optional(),
+			name: z.string(),
+			args: z.record(z.string(), z.unknown()).optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.listResources"),
+		params: z.object({
+			serverId: z.string().optional(),
+		}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.readResource"),
+		params: z.object({
+			serverId: z.string().optional(),
+			uri: z.string(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.config.list"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.config.add"),
+		params: customMcpServerInputSchema,
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.config.remove"),
+		params: z.object({
+			serverId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("mcp.config.setEnabled"),
+		params: z.object({
+			serverId: z.string().min(1),
+			enabled: z.boolean(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("fileChange.create"),
+		params: z.object({
+			relativePath: z.string().min(1),
+			content: z.string(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("fileChange.overwrite"),
+		params: z.object({
+			relativePath: z.string().min(1),
+			content: z.string(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("fileChange.delete"),
+		params: z.object({
+			relativePath: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("approval.list"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("approval.mode.set"),
+		params: z.object({
+			mode: z.enum(["manual", "auto-safe", "read-only"]),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("approval.approve"),
+		params: z.object({
+			approvalId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("approval.reject"),
+		params: z.object({
+			approvalId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("environment.configure"),
+		params: z.object({
+			godotExecutablePath: z.string().min(1).optional(),
+			godotProjectPath: z.string().min(1).optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("editor.context.update"),
+		params: z.record(z.string(), z.unknown()),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("editor.tool.result"),
+		params: z.object({
+			callId: z.string().min(1),
+			ok: z.boolean(),
+			result: z.unknown().optional(),
+			error: z.string().optional(),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("workspace.list"),
+		params: z.object({}).optional(),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("workspace.select"),
+		params: z.object({
+			workspaceId: z.string().min(1),
+		}),
+	}),
+	z.object({
+		type: z.literal("request"),
+		id: z.string(),
+		method: z.literal("workspace.info"),
+		params: z.object({}).optional(),
+	})
+]);
+
+export const serverResponseSchema = z.discriminatedUnion("ok", [
+	z.object({
+		type: z.literal("response"),
+		id: z.string(),
+		ok: z.literal(true),
+		result: z.unknown(),
+	}),
+	z.object({
+		type: z.literal("response"),
+		id: z.string(),
+		ok: z.literal(false),
+		error: z.object({
+			code: z.string(),
+			message: z.string(),
+		}),
+	}),
+]);

package/src/protocol/types.ts

@@ -0,0 +1,77 @@
+import type { z } from "zod";
+import type { additionalContextItemSchema, aiChatParamsSchema, clientRequestSchema, promptIdSchema, skillIdSchema } from "./schema.js";
+
+export type AiChatParams = z.infer<typeof aiChatParamsSchema>;
+
+export type AdditionalContextItem = z.infer<typeof additionalContextItemSchema>;
+
+export type ClientRequest = z.infer<typeof clientRequestSchema>;
+
+export type PromptId = z.infer<typeof promptIdSchema>;
+
+export type SkillId = z.infer<typeof skillIdSchema>;
+
+export type ChatMessage = {
+	role: "system" | "user" | "assistant";
+	content: string;
+	requestId?: string | undefined;
+	createdAt?: string | undefined;
+	additionalContext?: AdditionalContextItem[] | undefined;
+};
+
+export type ServerResponse =
+	| {
+		type: "response";
+		id: string;
+		ok: true;
+		result: unknown;
+	}
+	| {
+		type: "response";
+		id: string;
+		ok: false;
+		error: {
+			code: string;
+			message: string;
+		};
+	};
+
+export type ServerEvent = {
+	type: "event";
+	id: string;
+	event:
+		| "ai.delta"
+		| "ai.done"
+		| "ai.paused"
+		| "ai.cancelled"
+		| "ai.thinking.delta"
+		| "ai.thinking.done"
+		| "tool.call"
+		| "tool.result"
+		| "tool.error"
+		| "tool.approval_required"
+		| "tool.approved"
+		| "tool.rejected"
+		| "guide.added"
+		| "guide.updated"
+		| "guide.deleted"
+		| "guide.applied"
+		| "editor.tool.requested"
+		| "mcp.config.updated"
+		| "workflow.started"
+		| "workflow.phase.started"
+		| "workflow.todo.updated"
+		| "workflow.phase.done"
+		| "workflow.done"
+		| "workflow.error";
+	data?: unknown;
+};
+
+export type ModelProfile = {
+	provider: "deepseek";
+	model: string;
+	contextWindowTokens: number;
+	maxOutputTokens: number;
+	defaultOutputReserveTokens: number;
+	safetyMarginTokens: number;
+};