bridge-agent 0.17.1 → 0.18.0

package/dist/bridge-mcp.cjs

@@ -1299,21 +1299,21 @@ var require_errors = __commonJS({
     function extendErrors({ gen, keyword, schemaValue, data, errsCount, it }) {
       if (errsCount === void 0)
         throw new Error("ajv implementation error");
-      const err5 = gen.name("err");
+      const err6 = gen.name("err");
       gen.forRange("i", errsCount, names_1.default.errors, (i) => {
-        gen.const(err5, (0, codegen_1._)`${names_1.default.vErrors}[${i}]`);
-        gen.if((0, codegen_1._)`${err5}.instancePath === undefined`, () => gen.assign((0, codegen_1._)`${err5}.instancePath`, (0, codegen_1.strConcat)(names_1.default.instancePath, it.errorPath)));
-        gen.assign((0, codegen_1._)`${err5}.schemaPath`, (0, codegen_1.str)`${it.errSchemaPath}/${keyword}`);
+        gen.const(err6, (0, codegen_1._)`${names_1.default.vErrors}[${i}]`);
+        gen.if((0, codegen_1._)`${err6}.instancePath === undefined`, () => gen.assign((0, codegen_1._)`${err6}.instancePath`, (0, codegen_1.strConcat)(names_1.default.instancePath, it.errorPath)));
+        gen.assign((0, codegen_1._)`${err6}.schemaPath`, (0, codegen_1.str)`${it.errSchemaPath}/${keyword}`);
         if (it.opts.verbose) {
-          gen.assign((0, codegen_1._)`${err5}.schema`, schemaValue);
-          gen.assign((0, codegen_1._)`${err5}.data`, data);
+          gen.assign((0, codegen_1._)`${err6}.schema`, schemaValue);
+          gen.assign((0, codegen_1._)`${err6}.data`, data);
         }
       });
     }
     exports2.extendErrors = extendErrors;
     function addError(gen, errObj) {
-      const err5 = gen.const("err", errObj);
-      gen.if((0, codegen_1._)`${names_1.default.vErrors} === null`, () => gen.assign(names_1.default.vErrors, (0, codegen_1._)`[${err5}]`), (0, codegen_1._)`${names_1.default.vErrors}.push(${err5})`);
+      const err6 = gen.const("err", errObj);
+      gen.if((0, codegen_1._)`${names_1.default.vErrors} === null`, () => gen.assign(names_1.default.vErrors, (0, codegen_1._)`[${err6}]`), (0, codegen_1._)`${names_1.default.vErrors}.push(${err6})`);
       gen.code((0, codegen_1._)`${names_1.default.errors}++`);
     }
     function returnErrors(it, errs) {
@@ -7541,8 +7541,8 @@ var ZodType = class {
         } : {
           issues: ctx.common.issues
         };
-      } catch (err5) {
-        if (err5?.message?.toLowerCase()?.includes("encountered")) {
+      } catch (err6) {
+        if (err6?.message?.toLowerCase()?.includes("encountered")) {
           this["~standard"].async = true;
         }
         ctx.common = {
@@ -21243,16 +21243,16 @@ var handleFetchError = (e) => new Response(null, {
   status: e instanceof Error && (e.name === "TimeoutError" || e.constructor.name === "TimeoutError") ? 504 : 500
 });
 var handleResponseError = (e, outgoing) => {
-  const err5 = e instanceof Error ? e : new Error("unknown error", { cause: e });
-  if (err5.code === "ERR_STREAM_PREMATURE_CLOSE") {
+  const err6 = e instanceof Error ? e : new Error("unknown error", { cause: e });
+  if (err6.code === "ERR_STREAM_PREMATURE_CLOSE") {
     console.info("The user aborted a request.");
   } else {
     console.error(e);
     if (!outgoing.headersSent) {
       outgoing.writeHead(500, { "Content-Type": "text/plain" });
     }
-    outgoing.end(`Error: ${err5.message}`);
-    outgoing.destroy(err5);
+    outgoing.end(`Error: ${err6.message}`);
+    outgoing.destroy(err6);
   }
 };
 var flushHeaders = (outgoing) => {
@@ -21309,8 +21309,8 @@ var responseViaResponseObject = async (res, outgoing, options = {}) => {
     if (options.errorHandler) {
       try {
         res = await res;
-      } catch (err5) {
-        const errRes = await options.errorHandler(err5);
+      } catch (err6) {
+        const errRes = await options.errorHandler(err6);
         if (!errRes) {
           return;
         }
@@ -22300,19 +22300,20 @@ async function request(ctx, method, url, body, opts) {
       throw new Error(message || `HTTP ${res.status}`);
     }
     return res.json();
-  } catch (err5) {
+  } catch (err6) {
     clearTimeout(timer);
-    if (err5 instanceof Error && err5.name === "AbortError") {
+    if (err6 instanceof Error && err6.name === "AbortError") {
       throw new Error(`Request timed out after ${timeoutMs}ms: ${method} ${url}`);
     }
-    throw err5;
+    throw err6;
   }
 }
 async function getProject(ctx) {
   return request(ctx, "GET", projectPath(ctx));
 }
 async function updateProject(ctx, description) {
-  return request(ctx, "PATCH", projectPath(ctx), { description });
+  const res = await request(ctx, "PATCH", projectPath(ctx), { description });
+  return res.project;
 }
 async function getTodos(ctx, scope) {
   const qs = scope === "active" ? "?scope=active" : "";
@@ -22392,9 +22393,12 @@ async function killAgent(ctx, agentId) {
 async function assignTask(ctx, todoId, agentId) {
   return request(ctx, "POST", projectPath(ctx, `/todos/${todoId}/assign`), { agentId });
 }
-async function getAgentOutput(ctx, agentId, lines) {
-  const qs = lines !== void 0 ? `?lines=${lines}` : "";
-  return request(ctx, "GET", projectPath(ctx, `/panels/${agentId}/output${qs}`));
+async function getAgentOutput(ctx, agentId, lines, cursor) {
+  const params = new URLSearchParams();
+  if (lines !== void 0) params.set("lines", String(lines));
+  if (cursor) params.set("cursor", cursor);
+  const qs = params.toString();
+  return request(ctx, "GET", projectPath(ctx, `/panels/${agentId}/output${qs ? `?${qs}` : ""}`));
 }
 async function sendAgentInput(ctx, agentId, text) {
   return request(ctx, "POST", workspacePath(ctx, `/agents/${agentId}/input`), { text });
@@ -22533,9 +22537,37 @@ function registerPlanTools(server, ctx) {
       return { content: [{ type: "text", text: JSON.stringify(data) }] };
     }
   );
+  server.tool(
+    "bridge_get_blueprint",
+    "Get the project blueprint \u2014 the architecture/conventions/features/decisions markdown doc for this project. Returns { blueprint, updatedAt }; updatedAt is null when the blueprint was never seeded.",
+    {},
+    async () => {
+      const project = await getProject(ctx);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ blueprint: project.description ?? "", updatedAt: project.blueprintUpdatedAt ?? null })
+        }]
+      };
+    }
+  );
+  server.tool(
+    "bridge_update_blueprint",
+    "Update the project blueprint markdown doc. Stored as the project description and immediately reflected in the Bridge UI. Returns { ok, blueprint, updatedAt }.",
+    { content: external_exports.string().describe("New blueprint content in Markdown") },
+    async ({ content }) => {
+      const project = await updateProject(ctx, content);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ ok: true, blueprint: project.description ?? "", updatedAt: project.blueprintUpdatedAt ?? null })
+        }]
+      };
+    }
+  );
   server.tool(
     "bridge_get_plan",
-    "Get the current plan / spec for this Bridge project. Returns the markdown content stored in the project description field.",
+    "DEPRECATED \u2014 use bridge_get_blueprint. Get the current plan / spec for this Bridge project (legacy { plan } response shape).",
     {},
     async () => {
       const project = await getProject(ctx);
@@ -22549,14 +22581,14 @@ function registerPlanTools(server, ctx) {
   );
   server.tool(
     "bridge_update_plan",
-    "Update the plan / spec for this Bridge project. The content will be stored as the project description and immediately reflected in the Bridge UI.",
+    "DEPRECATED \u2014 use bridge_update_blueprint. Update the plan / spec for this Bridge project (legacy response shape).",
     { content: external_exports.string().describe("New plan content in Markdown") },
     async ({ content }) => {
-      const result = await updateProject(ctx, content);
+      await updateProject(ctx, content);
       return {
         content: [{
           type: "text",
-          text: JSON.stringify(result)
+          text: JSON.stringify({ ok: true })
         }]
       };
     }
@@ -22672,65 +22704,84 @@ var EVENT_ROLES = [...AGENT_ROLES, "system"];
 // ../shared/dist/tool-registry.js
 var BRIDGE_TOOL_DOCS = {
   // Project / plan
-  bridge_get_project: "Project metadata: name, cwd, machineId",
-  bridge_get_plan: "Read project spec/description",
-  bridge_update_plan: "Update project spec/description",
-  bridge_get_project_history: "Past run history and failure patterns",
-  bridge_get_execution_status: "Run history with todo completion counts",
+  bridge_get_project: "Project metadata (name, cwd, machineId)",
+  bridge_get_blueprint: "Read project blueprint doc ({blueprint, updatedAt})",
+  bridge_update_blueprint: "Update project blueprint doc",
+  bridge_get_project_history: "Past runs + failure patterns",
+  bridge_get_execution_status: "Run history + todo completion counts",
   // Todos
-  bridge_get_todos: "List todos + session state for this project",
-  bridge_add_todo: "Create a new todo (title, todoType, dependsOn)",
-  bridge_update_todo: "Update a todo title or status",
-  bridge_cancel_run: "Cancel active run (use before restarting a stale plan)",
+  bridge_get_todos: "List todos + session state",
+  bridge_add_todo: "Create todo (title, todoType, dependsOn)",
+  bridge_update_todo: "Update todo title/status",
+  bridge_cancel_run: "Cancel active run (before restarting a stale plan)",
   // Panel management
-  bridge_list_agents: "All agents: role, status, inRun flag",
-  bridge_get_agent_status: "Single agent status check",
-  bridge_spawn_worker: "Spawn a new worker agent (agentKey, role)",
-  bridge_kill_agent: "Terminate a stuck or dead agent",
-  bridge_get_agent_output: "Read terminal output of any agent",
-  bridge_send_input: "Send text input to an agent PTY",
+  bridge_list_agents: "All agents: role, status, inRun",
+  bridge_get_agent_status: "Single agent status",
+  bridge_spawn_worker: "Spawn worker (agentKey, role)",
+  bridge_kill_agent: "Terminate stuck/dead agent",
+  bridge_get_agent_output: "Read agent terminal output (round-trip cursor = delta read)",
+  bridge_send_input: "Send text input to agent PTY",
   // Worker task lifecycle
-  bridge_get_my_task: "Get the task assigned to this agent",
+  bridge_get_my_task: "This agent's assigned task",
   bridge_complete_task: "Signal task completion",
-  bridge_fail_task: "Signal task failure with a specific reason",
-  bridge_get_todo_context: "Read todo output/error for a specific todo",
-  bridge_assign_task: "Assign a pending todo to a specific agent",
+  bridge_fail_task: "Signal failure with reason",
+  bridge_get_todo_context: "Read a todo's output/error",
+  bridge_assign_task: "Assign pending todo to an agent",
   // Workspace scope (Phase 6)
-  bridge_list_groups: "List all agent groups and their member agentIds",
-  bridge_get_group_status: "Get agents in a group with status and last output line",
-  bridge_dispatch_to_group: "Send a text message/command to every agent in a group",
-  bridge_list_workspace_projects: "List all workspace projects with name, cwd, active run count",
-  bridge_query_workspace: "Natural-language query about orchestration state",
-  bridge_list_active_runs: "All active orchestration runs across workspace projects",
-  bridge_peek_panel: "Read terminal output of any panel workspace-wide (no project boundary)",
-  bridge_status_panel: "Get status of any panel in the workspace regardless of project",
+  bridge_list_groups: "Groups + member agentIds",
+  bridge_get_group_status: "Group agents: status + last output line",
+  bridge_dispatch_to_group: "Send message to every agent in a group",
+  bridge_create_group: "Create group (name, optional color)",
+  bridge_update_group: "Rename/recolor a group",
+  bridge_delete_group: "Delete a group",
+  bridge_assign_agent_to_group: "Move agent into a group, or remove (groupId: null); orchestrators cannot join",
+  bridge_list_workspace_projects: "Workspace projects: name, cwd, active run count",
+  bridge_query_workspace: "Natural-language query of orchestration state",
+  bridge_list_active_runs: "Active runs across workspace projects",
+  bridge_peek_panel: "Read any panel output workspace-wide (cursor = delta read)",
+  bridge_status_panel: "Status of any panel workspace-wide",
   // Personas
-  bridge_get_persona: "Fetch a persona by id (name, systemPrompt, role, agentKey)",
-  bridge_list_personas: "List all personas visible to the caller (workspace + personal)",
-  bridge_create_persona: "Create a custom persona definition",
-  bridge_update_persona: "Update persona definition fields",
-  bridge_archive_persona: "Archive an outdated persona",
-  bridge_launch_persona: "Spawn a worker initialized with a specific persona",
-  bridge_apply_persona: "Apply persona configuration to an existing running worker",
+  bridge_get_persona: "Persona by id (name, systemPrompt, role, agentKey)",
+  bridge_list_personas: "Visible personas (workspace + personal)",
+  bridge_create_persona: "Create persona",
+  bridge_update_persona: "Update persona fields",
+  bridge_archive_persona: "Archive a persona",
+  bridge_launch_persona: "Spawn worker with a persona",
+  bridge_apply_persona: "Apply persona to a running worker",
+  // Group Schemas (reusable team templates)
+  bridge_list_group_schemas: "Reusable team/group schema templates",
+  bridge_create_group_schema: "Create group schema from current groups",
+  bridge_update_group_schema: "Update a group schema (name/slug/desc/color/groups/shared)",
+  bridge_apply_group_schema: "Spawn a schema's groups and agents",
+  // Agent Model Info
+  bridge_list_agent_models: "Available models for an agent key on a daemon",
   // Messaging
-  bridge_send_message: "Send direct message to peer agent conversation",
-  bridge_poll_messages: "Poll unread messages delivered to this agent",
+  bridge_send_message: "Direct message to a peer agent",
+  bridge_poll_messages: "Poll unread messages for this agent",
   // Role Prompts
-  bridge_list_role_prompts: "List available system role prompt templates",
-  bridge_get_role_prompt: "Fetch resolved system role prompt template",
-  bridge_update_role_prompt: "Update custom role prompt template",
-  bridge_delete_role_prompt: "Delete custom role prompt template",
+  bridge_list_role_prompts: "Role prompt templates",
+  bridge_get_role_prompt: "Fetch resolved role prompt",
+  bridge_update_role_prompt: "Update custom role prompt",
+  bridge_delete_role_prompt: "Delete custom role prompt",
   // Events & Memory
-  bridge_agent_is_idle: "Check if agent terminal PTY is idle and ready for command injection",
-  bridge_record_event: "Record an event, constraint, or blocker for orchestration memory",
-  bridge_get_project_events: "Fetch recorded project events filtered by tags or permanence",
-  bridge_get_project_memory: "Fetch durable permanent guardrails and architectural constraints",
-  bridge_update_todo_status: "Update todo status directly without modifying title"
+  bridge_agent_is_idle: "Is agent PTY idle (ready for injection)",
+  bridge_record_event: "Record event/constraint/blocker to orchestration memory",
+  bridge_get_project_events: "Project events filtered by tags/permanence",
+  bridge_get_project_memory: "Durable guardrails + constraints",
+  bridge_update_todo_status: "Update todo status only"
 };
 if (Object.keys(BRIDGE_TOOL_DOCS).length === 0) {
   throw new Error("BRIDGE_TOOL_DOCS registry is empty at module load \u2014 fail fast");
 }
 
+// ../shared/dist/blueprint.js
+var BLUEPRINT_H1_AREAS = ["Frontend", "Backend", "Other"];
+var BLUEPRINT_H2_ASPECTS = ["Architecture", "Conventions", "Features", "Decisions"];
+var BLUEPRINT_DOC_TEMPLATE = BLUEPRINT_H1_AREAS.map((area) => `# ${area}
+
+` + BLUEPRINT_H2_ASPECTS.map((aspect) => `## ${aspect}
+`).join("\n")).join("\n");
+
 // ../mcp-server/src/tools/orchestration.ts
 function ok(data) {
   return { content: [{ type: "text", text: JSON.stringify(data) }] };
@@ -22815,12 +22866,13 @@ function registerOrchestrationTools(server, ctx) {
   );
   server.tool(
     "bridge_get_agent_output",
-    "Read the last N lines of a panel's terminal output (ANSI codes stripped). Use this to check a dev server for errors, verify a build succeeded, or read a shell panel's result. Works on any agent type \u2014 dev servers, shells, AI agents.",
+    "Read the last N lines of a panel's terminal output (ANSI codes stripped). Returns { output, cursor, cursor_reset }. Round-trip the returned cursor on the next call to get only new output (delta) \u2014 omit it for a full tail. cursor_reset: true means the cursor went stale (buffer evicted or panel respawned) and a full tail was returned. Use this to check a dev server for errors, verify a build succeeded, or read a shell panel's result. Works on any agent type \u2014 dev servers, shells, AI agents.",
     {
       agentId: external_exports.string().describe("The agent ID to read"),
-      lines: external_exports.number().int().min(1).max(300).optional().describe("Trailing lines to return (default 50, max 300)")
+      lines: external_exports.number().int().min(1).max(300).optional().describe("Trailing lines for full-tail reads (default 50, max 300); delta reads return all new lines"),
+      cursor: external_exports.string().optional().describe("Opaque cursor from a previous response \u2014 pass it back to receive only new output since that read")
     },
-    ({ agentId, lines }) => safe(() => getAgentOutput(ctx, agentId, lines))
+    ({ agentId, lines, cursor }) => safe(() => getAgentOutput(ctx, agentId, lines, cursor))
   );
   server.tool(
     "bridge_send_input",
@@ -23000,12 +23052,19 @@ function registerWorkspaceTools(server, ctx) {
   );
   server.tool(
     "bridge_peek_panel",
-    "Read the last N lines of a panel's terminal output. Project-scoped contexts may only peek at their own project's panels (403 cross_project_block otherwise); workspace scope has no project boundary. Use this to check what a specific agent is doing.",
+    "Read the last N lines of a panel's terminal output. Project-scoped contexts may only peek at their own project's panels (403 cross_project_block otherwise); workspace scope has no project boundary. Use this to check what a specific agent is doing. Returns { output, cursor, cursor_reset } \u2014 round-trip the cursor on the next call to get only new output (delta); omit it for a full tail.",
     {
       agentId: external_exports.string().describe("The panel/agent ID to peek at"),
-      lines: external_exports.number().int().min(1).max(300).optional().describe("Trailing lines to return (default 50, max 300)")
+      lines: external_exports.number().int().min(1).max(300).optional().describe("Trailing lines for full-tail reads (default 50, max 300); delta reads return all new lines"),
+      cursor: external_exports.string().optional().describe("Opaque cursor from a previous response \u2014 pass it back to receive only new output since that read")
     },
-    ({ agentId, lines }) => safe2(() => request(ctx, "GET", workspacePath(ctx, `/agents/${agentId}/output${lines !== void 0 ? `?lines=${lines}` : ""}`)))
+    ({ agentId, lines, cursor }) => safe2(() => {
+      const params = new URLSearchParams();
+      if (lines !== void 0) params.set("lines", String(lines));
+      if (cursor) params.set("cursor", cursor);
+      const qs = params.toString();
+      return request(ctx, "GET", workspacePath(ctx, `/agents/${agentId}/output${qs ? `?${qs}` : ""}`));
+    })
   );
   server.tool(
     "bridge_status_panel",
@@ -23013,6 +23072,49 @@ function registerWorkspaceTools(server, ctx) {
     { agentId: external_exports.string().describe("The panel/agent ID to inspect") },
     ({ agentId }) => safe2(() => request(ctx, "GET", workspacePath(ctx, `/agents/${agentId}`)))
   );
+  server.tool(
+    "bridge_create_group",
+    "Create a new agent group in the current project with an optional color.",
+    {
+      name: external_exports.string().min(1).max(64).describe("Human-readable group name"),
+      color: external_exports.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe("Hex color e.g. #6366f1")
+    },
+    ({ name, color }) => safe2(() => {
+      if (!ctx.projectId) throw new Error("Project-scoped context required");
+      return request(ctx, "POST", workspacePath(ctx, `/projects/${ctx.projectId}/groups`), { name, color });
+    })
+  );
+  server.tool(
+    "bridge_update_group",
+    "Rename or recolor an existing agent group.",
+    {
+      groupId: external_exports.string().describe("The group ID to update"),
+      name: external_exports.string().min(1).max(64).optional().describe("New group name"),
+      color: external_exports.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe("New hex color e.g. #6366f1")
+    },
+    ({ groupId, name, color }) => safe2(() => {
+      if (!ctx.projectId) throw new Error("Project-scoped context required");
+      return request(ctx, "PATCH", workspacePath(ctx, `/projects/${ctx.projectId}/groups/${groupId}`), { name, color });
+    })
+  );
+  server.tool(
+    "bridge_assign_agent_to_group",
+    "Assign a running agent to a group (team), or remove it with groupId:null. Orchestrator panels cannot join groups. Project-scoped context required; the group must already exist (use bridge_create_group first).",
+    { agentId: external_exports.string().min(1), groupId: external_exports.string().nullable() },
+    ({ agentId, groupId }) => safe2(() => {
+      if (!ctx.projectId) throw new Error("Project-scoped context required");
+      return request(ctx, "PATCH", workspacePath(ctx, `/projects/${ctx.projectId}/agents/${agentId}/group`), { groupId });
+    })
+  );
+  server.tool(
+    "bridge_delete_group",
+    "Delete an agent group. Members are detached but keep running.",
+    { groupId: external_exports.string().describe("The group ID to delete") },
+    ({ groupId }) => safe2(() => {
+      if (!ctx.projectId) throw new Error("Project-scoped context required");
+      return request(ctx, "DELETE", workspacePath(ctx, `/projects/${ctx.projectId}/groups/${groupId}`));
+    })
+  );
 }
 
 // ../mcp-server/src/tools/personas.ts
@@ -23188,6 +23290,123 @@ function registerRolePromptTools(server, ctx) {
   );
 }
 
+// ../mcp-server/src/tools/group-schemas.ts
+function ok5(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+function err5(message) {
+  return { content: [{ type: "text", text: JSON.stringify({ ok: false, error: message }) }] };
+}
+async function safe5(fn) {
+  try {
+    return ok5(await fn());
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    if (e instanceof Error && (e.name === "TypeError" || e.name === "ReferenceError")) {
+      console.error("[mcp-bridge] unexpected error in group-schema tool handler", { name: e.name, message, stack: e.stack });
+    }
+    return err5(message);
+  }
+}
+function registerGroupSchemaTools(server, ctx) {
+  server.tool(
+    "bridge_list_group_schemas",
+    "List reusable team/group schema templates saved in this workspace. Returns name, slug, color, groupsJson payload, and metadata for each schema.",
+    {
+      scope: external_exports.enum(["personal", "workspace", "project"]).optional().describe("Scope filter"),
+      projectId: external_exports.string().optional().describe("Filter to a specific project"),
+      q: external_exports.string().optional().describe("Substring search on name")
+    },
+    ({ scope, projectId, q }) => safe5(() => {
+      let path = "/group-schemas";
+      const params = new URLSearchParams();
+      if (scope) params.set("scope", scope);
+      if (projectId) params.set("projectId", projectId);
+      if (q) params.set("q", q);
+      const qs = params.toString();
+      if (qs) path += "?" + qs;
+      return request(ctx, "GET", workspacePath(ctx, path));
+    })
+  );
+  server.tool(
+    "bridge_apply_group_schema",
+    "Apply a group schema template to spawn all its groups and agents in one call. Validates model availability against the target daemon. Returns created groups + agent IDs and any partial failures.",
+    {
+      schemaId: external_exports.string().describe("The group schema ID to apply"),
+      projectId: external_exports.string().describe("Target project ID"),
+      daemonId: external_exports.string().optional().describe("Target daemon ID (auto-resolves if omitted)"),
+      mode: external_exports.enum(["auto-suffix", "replace"]).optional().describe("Name collision mode: auto-suffix (default) appends -2, -3, etc; replace reaps existing teams first")
+    },
+    ({ schemaId, projectId, daemonId, mode }) => safe5(
+      () => request(
+        ctx,
+        "POST",
+        workspacePath(ctx, `/group-schemas/${schemaId}/apply`),
+        { projectId, daemonId, mode }
+      )
+    )
+  );
+  server.tool(
+    "bridge_create_group_schema",
+    "Create a reusable group schema template from the current project group setup. Serializes groups and agent slots into a template that can be applied later with bridge_apply_group_schema.",
+    {
+      name: external_exports.string().min(1).max(80).describe("Display name for the schema"),
+      slug: external_exports.string().regex(/^[a-z][a-z0-9_]{1,62}$/).describe("Unique slug (lowercase, starts with letter, a-z0-9_ only, 2-63 chars)"),
+      description: external_exports.string().max(200).optional().describe("Optional description"),
+      color: external_exports.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe("Hex colour for the schema card"),
+      groupsJson: external_exports.any().optional().describe("GroupSchemaPayload: { version:1, groups:[{name, color?, slots:[{agentKey, model?, role?, count, cmd?}]}] }"),
+      scope: external_exports.enum(["personal", "workspace", "project"]).optional().describe("Visibility scope (default: workspace)"),
+      projectId: external_exports.string().optional().describe("Project ID (required if scope=project)")
+    },
+    ({ name, slug, description, color, groupsJson, scope, projectId }) => safe5(
+      () => request(
+        ctx,
+        "POST",
+        workspacePath(ctx, "/group-schemas"),
+        { name, slug, description, color, groupsJson, scope, projectId }
+      )
+    )
+  );
+  server.tool(
+    "bridge_update_group_schema",
+    "Update an existing (non-archived) group schema template. Pass schemaId plus only the fields to change (name, slug, description, color, groupsJson, shared). Returns the updated schema.",
+    {
+      schemaId: external_exports.string().describe("The group schema ID to update"),
+      name: external_exports.string().min(1).max(80).optional().describe("New display name"),
+      slug: external_exports.string().regex(/^[a-z][a-z0-9_]{1,62}$/).optional().describe("New unique slug (lowercase, starts with letter, a-z0-9_, 2-63 chars)"),
+      description: external_exports.string().max(200).optional().describe("New description"),
+      color: external_exports.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe("New hex colour e.g. #6366f1"),
+      groupsJson: external_exports.any().optional().describe("Replacement GroupSchemaPayload: { version:1, groups:[{name, color?, slots:[{agentKey, model?, role?, count, cmd?}]}] }"),
+      shared: external_exports.boolean().optional().describe("Workspace-scope only: mark the schema shared across the workspace")
+    },
+    ({ schemaId, name, slug, description, color, groupsJson, shared }) => safe5(
+      () => request(
+        ctx,
+        "PATCH",
+        workspacePath(ctx, `/group-schemas/${schemaId}`),
+        { name, slug, description, color, groupsJson, shared }
+      )
+    )
+  );
+  server.tool(
+    "bridge_list_agent_models",
+    "List available models for an agent key on a target daemon. Validates model portability across machines; use before applying a group schema to verify required models exist.",
+    {
+      agentKey: external_exports.string().optional().describe("Filter by agent key (e.g. claude, kimi, qwen)"),
+      daemonId: external_exports.string().optional().describe("Filter by daemon ID")
+    },
+    ({ agentKey, daemonId }) => safe5(() => {
+      let path = "/agent-models";
+      const params = new URLSearchParams();
+      if (agentKey) params.set("agentKey", agentKey);
+      if (daemonId) params.set("daemonId", daemonId);
+      const qs = params.toString();
+      if (qs) path += "?" + qs;
+      return request(ctx, "GET", workspacePath(ctx, path));
+    })
+  );
+}
+
 // ../mcp-server/src/index.ts
 var sessions = /* @__PURE__ */ new Map();
 function buildMcpServer(ctx) {
@@ -23199,6 +23418,7 @@ function buildMcpServer(ctx) {
   registerWorkspaceTools(srv, ctx);
   registerPersonaTools(srv, ctx);
   registerRolePromptTools(srv, ctx);
+  registerGroupSchemaTools(srv, ctx);
   return srv;
 }
 async function parseBody(req) {
@@ -23303,8 +23523,8 @@ function startHttpServer() {
       const mcpServer = buildMcpServer(ctx);
       await mcpServer.connect(transport);
       await transport.handleRequest(req, res, body);
-    } catch (err5) {
-      console.error("[bridge-mcp] request error:", err5);
+    } catch (err6) {
+      console.error("[bridge-mcp] request error:", err6);
       if (!res.headersSent) {
         res.writeHead(500, { "Content-Type": "application/json" });
         res.end(JSON.stringify({ error: "Internal server error" }));
@@ -23339,8 +23559,8 @@ async function startStdioServer() {
 if (process.env["HTTP_MODE"] !== "false") {
   startHttpServer();
 } else {
-  startStdioServer().catch((err5) => {
-    console.error("[bridge-mcp] fatal:", err5);
+  startStdioServer().catch((err6) => {
+    console.error("[bridge-mcp] fatal:", err6);
     process.exit(1);
   });
 }