feat: add claw backend adapter

tests/master-agent-chat-controls.test.ts

@@ -53,6 +53,9 @@ async function resetMasterAgentControls() {
   const project = state.projects.find((item) => item.id === "master-agent");
   assert.ok(project, "expected seeded master-agent project");
   delete project.agentControls;
+  state.userProjectAgentControls = state.userProjectAgentControls.filter(
+    (item) => item.projectId !== "master-agent",
+  );
   await writeState(state);
 }
 
@@ -110,6 +113,7 @@ test("master-agent 对话控制路由可读写并回显到项目详情", async (
       body: JSON.stringify({
         modelOverride: "gpt-5.4",
         reasoningEffortOverride: "medium",
+        backendOverride: "claw-runtime",
       }),
     }),
     { params: Promise.resolve({ projectId: "master-agent" }) },
@@ -121,12 +125,14 @@ test("master-agent 对话控制路由可读写并回显到项目详情", async (
     controls: {
       modelOverride?: string;
       reasoningEffortOverride?: string;
+      backendOverride?: string;
       updatedAt: string;
     } | null;
   };
   assert.equal(postPayload.ok, true);
   assert.equal(postPayload.controls?.modelOverride, "gpt-5.4");
   assert.equal(postPayload.controls?.reasoningEffortOverride, "medium");
+  assert.equal(postPayload.controls?.backendOverride, "claw-runtime");
 
   const getResponse = await getAgentControlsRoute(
     new NextRequest("http://127.0.0.1:3000/api/v1/projects/master-agent/agent-controls", {
@@ -142,12 +148,14 @@ test("master-agent 对话控制路由可读写并回显到项目详情", async (
     controls: {
       modelOverride?: string;
       reasoningEffortOverride?: string;
+      backendOverride?: string;
       updatedAt: string;
     } | null;
   };
   assert.equal(getPayload.ok, true);
   assert.equal(getPayload.controls?.modelOverride, "gpt-5.4");
   assert.equal(getPayload.controls?.reasoningEffortOverride, "medium");
+  assert.equal(getPayload.controls?.backendOverride, "claw-runtime");
 
   const projectResponse = await getProjectRoute(
     new NextRequest("http://127.0.0.1:3000/api/v1/projects/master-agent", {
@@ -163,12 +171,14 @@ test("master-agent 对话控制路由可读写并回显到项目详情", async (
     agentControls: {
       modelOverride?: string;
       reasoningEffortOverride?: string;
+      backendOverride?: string;
       updatedAt: string;
     } | null;
   };
   assert.equal(projectPayload.ok, true);
   assert.equal(projectPayload.agentControls?.modelOverride, "gpt-5.4");
   assert.equal(projectPayload.agentControls?.reasoningEffortOverride, "medium");
+  assert.equal(projectPayload.agentControls?.backendOverride, "claw-runtime");
 });
 
 test("master-agent 对话控制按当前账号隔离，不会串到其他用户", async () => {
@@ -873,6 +883,36 @@ test("POST /agent-controls rejects unknown-key payload and preserves controls",
   assert.equal(afterProject?.updatedAt, beforeUpdatedAt);
 });
 
+test("master-agent 对话控制 POST 会稳定拒绝非法 backendOverride", async () => {
+  await setup();
+
+  const session = await createAuthSession({
+    account: "17600003315",
+    role: "highest_admin",
+    displayName: "Boss 超级管理员",
+    loginMethod: "password",
+  });
+
+  const response = await postAgentControlsRoute(
+    new NextRequest("http://127.0.0.1:3000/api/v1/projects/master-agent/agent-controls", {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        cookie: `${AUTH_SESSION_COOKIE}=${session.sessionToken}`,
+      },
+      body: JSON.stringify({
+        backendOverride: "bad-backend",
+      }),
+    }),
+    { params: Promise.resolve({ projectId: "master-agent" }) },
+  );
+
+  assert.equal(response.status, 400);
+  const payload = (await response.json()) as { ok: boolean; message?: string };
+  assert.equal(payload.ok, false);
+  assert.equal(payload.message, "INVALID_BACKEND_OVERRIDE");
+});
+
 test("master-agent controls helper 不会写入普通项目", async () => {
   await setup();