webmux 0.28.0 → 0.29.0

package/backend/dist/server.js

@@ -10999,9 +10999,45 @@ var EnabledResponseSchema = exports_external.object({
   ok: exports_external.literal(true),
   enabled: exports_external.boolean()
 });
-var AgentKindSchema = exports_external.enum(["claude", "codex"]);
-var CreateWorktreeAgentSelectionSchema = exports_external.enum(["claude", "codex", "both"]);
+var BuiltInAgentIdSchema = exports_external.enum(["claude", "codex"]);
+var AgentIdSchema = exports_external.string().trim().min(1);
 var WorktreeCreateModeSchema = exports_external.enum(["new", "existing"]);
+var AgentCapabilitiesSchema = exports_external.object({
+  terminal: exports_external.literal(true),
+  inAppChat: exports_external.boolean(),
+  conversationHistory: exports_external.boolean(),
+  interrupt: exports_external.boolean(),
+  resume: exports_external.boolean()
+});
+var AgentSummarySchema = exports_external.object({
+  id: AgentIdSchema,
+  label: exports_external.string(),
+  kind: exports_external.enum(["builtin", "custom"]),
+  capabilities: AgentCapabilitiesSchema
+});
+var AgentDetailsSchema = exports_external.object({
+  id: AgentIdSchema,
+  label: exports_external.string(),
+  kind: exports_external.enum(["builtin", "custom"]),
+  capabilities: AgentCapabilitiesSchema,
+  startCommand: exports_external.string().nullable(),
+  resumeCommand: exports_external.string().nullable()
+});
+var AgentListResponseSchema = exports_external.object({
+  agents: exports_external.array(AgentDetailsSchema)
+});
+var UpsertCustomAgentRequestSchema = exports_external.object({
+  label: exports_external.string().trim().min(1),
+  startCommand: exports_external.string().trim().min(1),
+  resumeCommand: exports_external.string().trim().optional()
+});
+var AgentResponseSchema = exports_external.object({
+  agent: AgentDetailsSchema
+});
+var ValidateCustomAgentResponseSchema = exports_external.object({
+  normalizedId: AgentIdSchema,
+  warnings: exports_external.array(exports_external.string())
+});
 var WorktreeCreationPhaseSchema = exports_external.enum([
   "creating_worktree",
   "preparing_runtime",
@@ -11027,7 +11063,8 @@ var CreateWorktreeRequestSchema = exports_external.object({
   branch: exports_external.string().optional(),
   baseBranch: exports_external.string().optional(),
   profile: exports_external.string().optional(),
-  agent: CreateWorktreeAgentSelectionSchema.optional(),
+  agent: AgentIdSchema.optional(),
+  agents: exports_external.array(AgentIdSchema).min(1).optional(),
   prompt: exports_external.string().optional(),
   envOverrides: exports_external.record(exports_external.string()).optional(),
   createLinearTicket: exports_external.literal(true).optional(),
@@ -11158,7 +11195,8 @@ var ProjectWorktreeSnapshotSchema = exports_external.object({
   dir: exports_external.string(),
   archived: exports_external.boolean(),
   profile: exports_external.string().nullable(),
-  agentName: AgentKindSchema.nullable(),
+  agentName: AgentIdSchema.nullable(),
+  agentLabel: exports_external.string().nullable(),
   mux: exports_external.boolean(),
   dirty: exports_external.boolean(),
   unpushed: exports_external.boolean(),
@@ -11203,7 +11241,8 @@ var AgentsUiWorktreeSummarySchema = exports_external.object({
   path: exports_external.string(),
   archived: exports_external.boolean(),
   profile: exports_external.string().nullable(),
-  agentName: AgentKindSchema.nullable(),
+  agentName: AgentIdSchema.nullable(),
+  agentLabel: exports_external.string().nullable(),
   mux: exports_external.boolean(),
   status: exports_external.string(),
   dirty: exports_external.boolean(),
@@ -11295,7 +11334,9 @@ var AppConfigSchema = exports_external.object({
   name: exports_external.string(),
   services: exports_external.array(ServiceConfigSchema),
   profiles: exports_external.array(ProfileConfigSchema),
+  agents: exports_external.array(AgentSummarySchema),
   defaultProfileName: exports_external.string(),
+  defaultAgentId: BuiltInAgentIdSchema,
   autoName: exports_external.boolean(),
   linearCreateTicketOption: exports_external.boolean(),
   startupEnvs: exports_external.record(exports_external.union([exports_external.string(), exports_external.boolean()])),
@@ -11314,6 +11355,9 @@ var WorktreeNameParamsSchema = exports_external.object({
 var NotificationIdParamsSchema = exports_external.object({
   id: NumberLikePathParamSchema
 });
+var AgentIdParamsSchema = exports_external.object({
+  id: AgentIdSchema
+});
 var RunIdParamsSchema = exports_external.object({
   runId: NumberLikePathParamSchema
 });
@@ -11325,6 +11369,11 @@ var apiPaths = {
   fetchAvailableBranches: "/api/branches",
   fetchBaseBranches: "/api/base-branches",
   fetchProject: "/api/project",
+  fetchAgents: "/api/agents",
+  createAgent: "/api/agents",
+  updateAgent: "/api/agents/:id",
+  deleteAgent: "/api/agents/:id",
+  validateAgent: "/api/agents/validate",
   attachAgentsWorktreeConversation: "/api/agents/worktrees/:name/attach",
   fetchAgentsWorktreeConversationHistory: "/api/agents/worktrees/:name/history",
   sendAgentsWorktreeConversationMessage: "/api/agents/worktrees/:name/messages",
@@ -11389,6 +11438,60 @@ var apiContract = c.router({
       502: ErrorResponseSchema
     }
   },
+  fetchAgents: {
+    method: "GET",
+    path: apiPaths.fetchAgents,
+    responses: {
+      200: AgentListResponseSchema,
+      500: ErrorResponseSchema
+    }
+  },
+  createAgent: {
+    method: "POST",
+    path: apiPaths.createAgent,
+    body: UpsertCustomAgentRequestSchema,
+    responses: {
+      200: AgentResponseSchema,
+      400: ErrorResponseSchema,
+      409: ErrorResponseSchema,
+      500: ErrorResponseSchema
+    }
+  },
+  updateAgent: {
+    method: "PUT",
+    path: apiPaths.updateAgent,
+    pathParams: AgentIdParamsSchema,
+    body: UpsertCustomAgentRequestSchema,
+    responses: {
+      200: AgentResponseSchema,
+      400: ErrorResponseSchema,
+      404: ErrorResponseSchema,
+      409: ErrorResponseSchema,
+      500: ErrorResponseSchema
+    }
+  },
+  deleteAgent: {
+    method: "DELETE",
+    path: apiPaths.deleteAgent,
+    pathParams: AgentIdParamsSchema,
+    body: c.noBody(),
+    responses: {
+      200: OkResponseSchema,
+      400: ErrorResponseSchema,
+      404: ErrorResponseSchema,
+      500: ErrorResponseSchema
+    }
+  },
+  validateAgent: {
+    method: "POST",
+    path: apiPaths.validateAgent,
+    body: UpsertCustomAgentRequestSchema,
+    responses: {
+      200: ValidateCustomAgentResponseSchema,
+      400: ErrorResponseSchema,
+      500: ErrorResponseSchema
+    }
+  },
   attachAgentsWorktreeConversation: {
     method: "POST",
     path: apiPaths.attachAgentsWorktreeConversation,
@@ -12691,6 +12794,7 @@ var DEFAULT_CONFIG = {
       panes: clonePanes(DEFAULT_PANES)
     }
   },
+  agents: {},
   services: [],
   startupEnvs: {},
   integrations: {
@@ -12808,6 +12912,38 @@ function parseProfiles(raw, includeDefaultProfile) {
   }
   return profiles;
 }
+function cloneAgentConfig(agent) {
+  return { ...agent };
+}
+function cloneAgents(agents) {
+  return Object.fromEntries(Object.entries(agents).map(([id, agent]) => [id, cloneAgentConfig(agent)]));
+}
+function parseCustomAgent(raw) {
+  if (!isRecord3(raw))
+    return null;
+  if (typeof raw.label !== "string" || !raw.label.trim())
+    return null;
+  if (typeof raw.startCommand !== "string" || !raw.startCommand.trim())
+    return null;
+  return {
+    label: raw.label.trim(),
+    startCommand: raw.startCommand.trim(),
+    ...typeof raw.resumeCommand === "string" && raw.resumeCommand.trim() ? { resumeCommand: raw.resumeCommand.trim() } : {}
+  };
+}
+function parseCustomAgents(raw) {
+  if (!isRecord3(raw))
+    return {};
+  return Object.entries(raw).reduce((acc, [id, value]) => {
+    if (!id.trim())
+      return acc;
+    const parsed = parseCustomAgent(value);
+    if (parsed) {
+      acc[id.trim()] = parsed;
+    }
+    return acc;
+  }, {});
+}
 function parseServices(raw) {
   if (!Array.isArray(raw))
     return [];
@@ -12900,6 +13036,7 @@ function parseProjectConfig(parsed) {
       autoPull: isRecord3(parsed.workspace) ? parseAutoPull(parsed.workspace.autoPull) : DEFAULT_CONFIG.workspace.autoPull
     },
     profiles: parseProfiles(parsed.profiles, true),
+    agents: {},
     services: parseServices(parsed.services),
     startupEnvs: parseStartupEnvs(parsed.startupEnvs),
     integrations: {
@@ -12967,20 +13104,21 @@ function loadLocalProjectConfigOverlay(root) {
   try {
     const text = readLocalConfigFile(root).trim();
     if (!text) {
-      return { worktreeRoot: null, profiles: {}, lifecycleHooks: {}, linear: null, github: null, autoPull: null };
+      return { worktreeRoot: null, profiles: {}, agents: {}, lifecycleHooks: {}, linear: null, github: null, autoPull: null };
     }
     const parsed = parseConfigDocument(text);
     const ws = isRecord3(parsed.workspace) ? parsed.workspace : null;
     return {
       worktreeRoot: ws && typeof ws.worktreeRoot === "string" ? ws.worktreeRoot : null,
       profiles: parseProfiles(parsed.profiles, false),
+      agents: parseCustomAgents(parsed.agents),
       lifecycleHooks: parseLifecycleHooks(parsed.lifecycleHooks),
       linear: parseLocalLinearOverlay(parsed),
       github: parseLocalGitHubOverlay(parsed),
       autoPull: parseLocalAutoPullOverlay(parsed)
     };
   } catch {
-    return { worktreeRoot: null, profiles: {}, lifecycleHooks: {}, linear: null, github: null, autoPull: null };
+    return { worktreeRoot: null, profiles: {}, agents: {}, lifecycleHooks: {}, linear: null, github: null, autoPull: null };
   }
 }
 function mergeHookCommand(projectCommand, localCommand) {
@@ -13040,12 +13178,15 @@ function loadConfig(dir, options = {}) {
       ...cloneProfiles(projectConfig.profiles),
       ...cloneProfiles(localOverlay.profiles)
     },
+    agents: {
+      ...cloneAgents(projectConfig.agents),
+      ...cloneAgents(localOverlay.agents)
+    },
     lifecycleHooks: mergeLifecycleHooks(projectConfig.lifecycleHooks, localOverlay.lifecycleHooks),
     integrations
   };
 }
-async function persistLocalLinearConfig(dir, changes) {
-  const root = projectRoot(dir);
+function readLocalConfigDocument(root) {
   const localPath = join2(root, ".webmux.local.yaml");
   let existing = {};
   try {
@@ -13053,6 +13194,11 @@ async function persistLocalLinearConfig(dir, changes) {
     if (text)
       existing = parseConfigDocument(text);
   } catch {}
+  return { localPath, existing };
+}
+async function persistLocalLinearConfig(dir, changes) {
+  const root = projectRoot(dir);
+  const { localPath, existing } = readLocalConfigDocument(root);
   const integrations = isRecord3(existing.integrations) ? { ...existing.integrations } : {};
   const linear = isRecord3(integrations.linear) ? { ...integrations.linear } : {};
   Object.assign(linear, changes);
@@ -13062,13 +13208,7 @@ async function persistLocalLinearConfig(dir, changes) {
 }
 async function persistLocalGitHubConfig(dir, changes) {
   const root = projectRoot(dir);
-  const localPath = join2(root, ".webmux.local.yaml");
-  let existing = {};
-  try {
-    const text = readFileSync(localPath, "utf8").trim();
-    if (text)
-      existing = parseConfigDocument(text);
-  } catch {}
+  const { localPath, existing } = readLocalConfigDocument(root);
   const integrations = isRecord3(existing.integrations) ? { ...existing.integrations } : {};
   const github = isRecord3(integrations.github) ? { ...integrations.github } : {};
   Object.assign(github, changes);
@@ -13076,6 +13216,33 @@ async function persistLocalGitHubConfig(dir, changes) {
   existing.integrations = integrations;
   await Bun.write(localPath, $stringify(existing));
 }
+async function persistLocalCustomAgent(dir, agentId, agent) {
+  const root = projectRoot(dir);
+  const { localPath, existing } = readLocalConfigDocument(root);
+  const agents = isRecord3(existing.agents) ? { ...existing.agents } : {};
+  agents[agentId] = {
+    label: agent.label,
+    startCommand: agent.startCommand,
+    ...agent.resumeCommand ? { resumeCommand: agent.resumeCommand } : {}
+  };
+  existing.agents = agents;
+  await Bun.write(localPath, $stringify(existing));
+}
+async function removeLocalCustomAgent(dir, agentId) {
+  const root = projectRoot(dir);
+  const { localPath, existing } = readLocalConfigDocument(root);
+  if (!isRecord3(existing.agents) || !(agentId in existing.agents)) {
+    return;
+  }
+  const agents = { ...existing.agents };
+  delete agents[agentId];
+  if (Object.keys(agents).length === 0) {
+    delete existing.agents;
+  } else {
+    existing.agents = agents;
+  }
+  await Bun.write(localPath, $stringify(existing));
+}
 function expandTemplate(template, env) {
   return template.replace(/\$\{(\w+)\}/g, (_, key) => env[key] ?? "");
 }
@@ -13208,6 +13375,182 @@ function pruneArchivedWorktreeState(input) {
   return createArchiveState(input.state.entries.filter((entry) => validPaths.has(normalizeArchivePath(entry.path))));
 }
 
+// backend/src/services/agent-chat-service.ts
+function resolveAgentChatSupport(input) {
+  if (!input.agentId) {
+    return {
+      ok: false,
+      error: "This worktree has no agent configured",
+      status: 409
+    };
+  }
+  if (!input.agent) {
+    return {
+      ok: false,
+      error: `Unknown agent: ${input.agentId}`,
+      status: 404
+    };
+  }
+  const agentLabel = input.agentLabel ?? input.agent.label;
+  if (!input.agent.capabilities.inAppChat || !input.agent.capabilities.conversationHistory) {
+    return {
+      ok: false,
+      error: `${agentLabel} does not support in-app chat`,
+      status: 409
+    };
+  }
+  if (input.action === "interrupt" && !input.agent.capabilities.interrupt) {
+    return {
+      ok: false,
+      error: `${agentLabel} cannot be interrupted from the dashboard`,
+      status: 409
+    };
+  }
+  if (input.agent.kind === "builtin") {
+    return {
+      ok: true,
+      data: {
+        provider: input.agent.implementation.agent,
+        submitDelayMs: input.agent.implementation.agent === "codex" ? 200 : 0
+      }
+    };
+  }
+  return {
+    ok: false,
+    error: `Dashboard chat is not available for ${agentLabel}`,
+    status: 409
+  };
+}
+
+// backend/src/services/agent-registry.ts
+var BUILTIN_AGENT_DEFINITIONS = [
+  {
+    id: "claude",
+    label: "Claude",
+    kind: "builtin",
+    capabilities: {
+      terminal: true,
+      inAppChat: true,
+      conversationHistory: true,
+      interrupt: true,
+      resume: true
+    },
+    implementation: {
+      type: "builtin",
+      agent: "claude"
+    }
+  },
+  {
+    id: "codex",
+    label: "Codex",
+    kind: "builtin",
+    capabilities: {
+      terminal: true,
+      inAppChat: true,
+      conversationHistory: true,
+      interrupt: true,
+      resume: true
+    },
+    implementation: {
+      type: "builtin",
+      agent: "codex"
+    }
+  }
+];
+function cloneCapabilities(capabilities) {
+  return { ...capabilities };
+}
+function isBuiltInAgentId(agentId) {
+  return BUILTIN_AGENT_DEFINITIONS.some((agent) => agent.id === agentId);
+}
+function normalizeCustomAgentId(label) {
+  const normalized = label.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return normalized || "agent";
+}
+function cloneDefinition(definition) {
+  if (definition.kind === "builtin") {
+    return {
+      ...definition,
+      capabilities: cloneCapabilities(definition.capabilities),
+      implementation: { ...definition.implementation }
+    };
+  }
+  return {
+    ...definition,
+    capabilities: cloneCapabilities(definition.capabilities),
+    implementation: {
+      type: "custom",
+      config: { ...definition.implementation.config }
+    }
+  };
+}
+function buildCustomAgentDefinition(id, config) {
+  return {
+    id,
+    label: config.label,
+    kind: "custom",
+    capabilities: {
+      terminal: true,
+      inAppChat: false,
+      conversationHistory: false,
+      interrupt: false,
+      resume: config.resumeCommand !== undefined
+    },
+    implementation: {
+      type: "custom",
+      config: { ...config }
+    }
+  };
+}
+function listAgentDefinitions(config) {
+  const builtInIds = new Set(BUILTIN_AGENT_DEFINITIONS.map((agent) => agent.id));
+  const customDefinitions = Object.entries(config.agents).filter(([id]) => !builtInIds.has(id)).sort(([leftId, left], [rightId, right]) => {
+    const labelCompare = left.label.localeCompare(right.label);
+    return labelCompare !== 0 ? labelCompare : leftId.localeCompare(rightId);
+  }).map(([id, agent]) => buildCustomAgentDefinition(id, agent));
+  return [
+    ...BUILTIN_AGENT_DEFINITIONS.map((definition) => cloneDefinition(definition)),
+    ...customDefinitions
+  ];
+}
+function getAgentDefinition(config, agentId) {
+  const definition = listAgentDefinitions(config).find((agent) => agent.id === agentId);
+  return definition ?? null;
+}
+function listAgentSummaries(config) {
+  return listAgentDefinitions(config).map((agent) => ({
+    id: agent.id,
+    label: agent.label,
+    kind: agent.kind,
+    capabilities: cloneCapabilities(agent.capabilities)
+  }));
+}
+function listAgentDetails(config) {
+  return listAgentDefinitions(config).map((agent) => ({
+    id: agent.id,
+    label: agent.label,
+    kind: agent.kind,
+    capabilities: cloneCapabilities(agent.capabilities),
+    startCommand: agent.kind === "custom" ? agent.implementation.config.startCommand : null,
+    resumeCommand: agent.kind === "custom" ? agent.implementation.config.resumeCommand ?? null : null
+  }));
+}
+
+// backend/src/services/agent-validation-service.ts
+function validateCustomAgentInput(input) {
+  const warnings = [];
+  if (!input.startCommand.includes("${PROMPT}") && !input.startCommand.includes("${SYSTEM_PROMPT}")) {
+    warnings.push("Start command does not reference ${PROMPT} or ${SYSTEM_PROMPT}; initial prompts will not be passed automatically");
+  }
+  if (!input.resumeCommand?.trim()) {
+    warnings.push("Resume command is not configured; reopening the worktree will restart the agent");
+  }
+  return {
+    normalizedId: normalizeCustomAgentId(input.label),
+    warnings
+  };
+}
+
 // backend/src/services/linear-service.ts
 var ASSIGNED_ISSUES_QUERY = `
   query AssignedIssues {
@@ -14184,6 +14527,14 @@ function allocateServicePorts(existingMetas, services) {
 
 // backend/src/services/agent-service.ts
 var DOCKER_PATH_FALLBACK = "/root/.local/bin:/usr/local/bin:/root/.bun/bin:/root/.cargo/bin";
+var CUSTOM_AGENT_TEMPLATE_VARS = {
+  PROMPT: "WEBMUX_AGENT_PROMPT",
+  SYSTEM_PROMPT: "WEBMUX_AGENT_SYSTEM_PROMPT",
+  WORKTREE_PATH: "WEBMUX_AGENT_WORKTREE_PATH",
+  REPO_PATH: "WEBMUX_AGENT_REPO_PATH",
+  BRANCH: "WEBMUX_AGENT_BRANCH",
+  PROFILE: "WEBMUX_AGENT_PROFILE"
+};
 function quoteShell(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
@@ -14193,7 +14544,7 @@ function buildRuntimeBootstrap(runtimeEnvPath) {
 function buildDockerRuntimeBootstrap(runtimeEnvPath) {
   return `${buildRuntimeBootstrap(runtimeEnvPath)}; export PATH="$PATH:${DOCKER_PATH_FALLBACK}"`;
 }
-function buildAgentInvocation(input) {
+function buildBuiltInAgentInvocation(input) {
   if (input.agent === "codex") {
     const yoloFlag2 = input.yolo ? " --yolo" : "";
     if (input.launchMode === "resume") {
@@ -14215,6 +14566,47 @@ function buildAgentInvocation(input) {
   }
   return `claude${yoloFlag}${promptSuffix}`;
 }
+function renderCustomCommandTemplate(template) {
+  return template.replaceAll("${PROMPT}", `$${CUSTOM_AGENT_TEMPLATE_VARS.PROMPT}`).replaceAll("${SYSTEM_PROMPT}", `$${CUSTOM_AGENT_TEMPLATE_VARS.SYSTEM_PROMPT}`).replaceAll("${WORKTREE_PATH}", `$${CUSTOM_AGENT_TEMPLATE_VARS.WORKTREE_PATH}`).replaceAll("${REPO_PATH}", `$${CUSTOM_AGENT_TEMPLATE_VARS.REPO_PATH}`).replaceAll("${BRANCH}", `$${CUSTOM_AGENT_TEMPLATE_VARS.BRANCH}`).replaceAll("${PROFILE}", `$${CUSTOM_AGENT_TEMPLATE_VARS.PROFILE}`);
+}
+function buildCustomAgentExports(input) {
+  const envEntries = [
+    [CUSTOM_AGENT_TEMPLATE_VARS.PROMPT, input.prompt ?? ""],
+    [CUSTOM_AGENT_TEMPLATE_VARS.SYSTEM_PROMPT, input.systemPrompt ?? ""],
+    [CUSTOM_AGENT_TEMPLATE_VARS.WORKTREE_PATH, input.worktreePath],
+    [CUSTOM_AGENT_TEMPLATE_VARS.REPO_PATH, input.repoRoot],
+    [CUSTOM_AGENT_TEMPLATE_VARS.BRANCH, input.branch],
+    [CUSTOM_AGENT_TEMPLATE_VARS.PROFILE, input.profileName]
+  ];
+  return envEntries.map(([key, value]) => `export ${key}=${quoteShell(value)}`).join("; ");
+}
+function buildCustomAgentInvocation(input) {
+  const template = input.launchMode === "resume" && input.agent.implementation.config.resumeCommand ? input.agent.implementation.config.resumeCommand : input.agent.implementation.config.startCommand;
+  const exports = buildCustomAgentExports(input);
+  const renderedCommand = renderCustomCommandTemplate(template);
+  return `${exports}; ${renderedCommand}`;
+}
+function buildAgentInvocation(input) {
+  if (input.agent.kind === "builtin") {
+    return buildBuiltInAgentInvocation({
+      agent: input.agent.implementation.agent,
+      yolo: input.yolo,
+      systemPrompt: input.systemPrompt,
+      prompt: input.prompt,
+      launchMode: input.launchMode
+    });
+  }
+  return buildCustomAgentInvocation({
+    agent: input.agent,
+    systemPrompt: input.systemPrompt,
+    prompt: input.prompt,
+    worktreePath: input.worktreePath,
+    repoRoot: input.repoRoot,
+    branch: input.branch,
+    profileName: input.profileName,
+    launchMode: input.launchMode
+  });
+}
 function buildAgentCommand(input, bootstrap = buildRuntimeBootstrap) {
   return `${bootstrap(input.runtimeEnvPath)}; ${buildAgentInvocation(input)}`;
 }
@@ -14807,14 +15199,15 @@ function buildRuntimeControlBaseUrl(controlBaseUrl, runtime) {
 function prefixAgentBranch(agent, branch) {
   return `${agent}-${branch}`;
 }
-function buildCreateWorktreeTargets(branch, agentSelection) {
-  if (agentSelection === "both") {
-    return [
-      { branch: prefixAgentBranch("claude", branch), agent: "claude" },
-      { branch: prefixAgentBranch("codex", branch), agent: "codex" }
-    ];
+function buildCreateWorktreeTargets(branch, agentIds) {
+  if (agentIds.length <= 1) {
+    const agent = agentIds[0];
+    return agent ? [{ branch, agent }] : [];
   }
-  return [{ branch, agent: agentSelection }];
+  return agentIds.map((agent) => ({
+    branch: prefixAgentBranch(agent, branch),
+    agent
+  }));
 }
 
 class LifecycleError extends Error {
@@ -14832,12 +15225,12 @@ class LifecycleService {
   }
   async createWorktrees(input) {
     const mode = input.mode ?? "new";
-    const agentSelection = input.agent ?? this.deps.config.workspace.defaultAgent;
-    if (agentSelection === "both" && mode === "existing") {
-      throw new LifecycleError("Creating both agents is only supported for new worktrees", 400);
+    const agentIds = this.resolveSelectedAgents(input);
+    if (agentIds.length > 1 && mode === "existing") {
+      throw new LifecycleError("Creating multiple agents is only supported for new worktrees", 400);
     }
     const branch = await this.resolveBranch(input.branch, input.prompt, mode);
-    const targets = buildCreateWorktreeTargets(branch, agentSelection);
+    const targets = buildCreateWorktreeTargets(branch, agentIds);
     const createdBranches = [];
     try {
       for (const target of targets) {
@@ -14864,28 +15257,30 @@ class LifecycleService {
   async createWorktree(input) {
     const mode = input.mode ?? "new";
     const branch = await this.resolveBranch(input.branch, input.prompt, mode);
-    const agent = this.resolveAgent(input.agent);
+    const agent = this.resolveAgentDefinition(input.agent);
     return await this.createResolvedWorktree({
       ...input,
       mode,
       branch,
-      agent
+      agent: agent.id
     });
   }
   async openWorktree(branch) {
     try {
       const resolved = await this.resolveExistingWorktree(branch);
-      const launchMode = resolved.meta ? "resume" : "fresh";
       const initialized = resolved.meta ? await this.refreshManagedArtifacts(resolved) : await this.initializeUnmanagedWorktree(resolved);
-      const { profile } = this.resolveProfile(initialized.meta.profile);
+      const { profileName, profile } = this.resolveProfile(initialized.meta.profile);
+      const agent = this.resolveAgentDefinition(initialized.meta.agent);
+      const launchMode = resolved.meta && agent.capabilities.resume ? "resume" : "fresh";
       await ensureAgentRuntimeArtifacts({
         gitDir: initialized.paths.gitDir,
         worktreePath: resolved.entry.path
       });
       await this.materializeRuntimeSession({
         branch,
+        profileName,
         profile,
-        agent: initialized.meta.agent,
+        agent,
         initialized,
         worktreePath: resolved.entry.path,
         launchMode
@@ -15019,14 +15414,22 @@ class LifecycleService {
       profile
     };
   }
-  resolveAgent(agent) {
-    if (!agent)
-      return this.deps.config.workspace.defaultAgent;
-    if (agent !== "claude" && agent !== "codex") {
-      throw new LifecycleError(`Unknown agent: ${agent}`, 400);
+  resolveAgentDefinition(agentId) {
+    const resolvedAgentId = agentId ?? this.deps.config.workspace.defaultAgent;
+    const agent = getAgentDefinition(this.deps.config, resolvedAgentId);
+    if (!agent) {
+      throw new LifecycleError(`Unknown agent: ${resolvedAgentId}`, 400);
     }
     return agent;
   }
+  resolveSelectedAgents(input) {
+    const selectedAgents = input.agents && input.agents.length > 0 ? input.agents : [input.agent ?? this.deps.config.workspace.defaultAgent];
+    const dedupedAgentIds = [...new Set(selectedAgents.map((agent) => agent.trim()).filter((agent) => agent.length > 0))];
+    if (dedupedAgentIds.length === 0) {
+      throw new LifecycleError("At least one agent must be selected", 400);
+    }
+    return dedupedAgentIds.map((agentId) => this.resolveAgentDefinition(agentId).id);
+  }
   async buildStartupEnvValues(envOverrides) {
     const startupEnvValues = Object.fromEntries(Object.entries(this.deps.config.startupEnvs).map(([key, value]) => [key, stringifyStartupEnvValue(value)]));
     for (const [key, value] of Object.entries(envOverrides ?? {})) {
@@ -15148,6 +15551,7 @@ class LifecycleService {
       });
       ensureSessionLayout(this.deps.tmux, this.buildSessionLayout({
         branch: input.branch,
+        profileName: input.profileName,
         profile: input.profile,
         agent: input.agent,
         initialized: input.initialized,
@@ -15160,6 +15564,7 @@ class LifecycleService {
     }
     ensureSessionLayout(this.deps.tmux, this.buildSessionLayout({
       branch: input.branch,
+      profileName: input.profileName,
       profile: input.profile,
       agent: input.agent,
       initialized: input.initialized,
@@ -15178,6 +15583,10 @@ class LifecycleService {
         agent: buildDockerAgentPaneCommand({
           agent: input.agent,
           runtimeEnvPath: input.initialized.paths.runtimeEnvPath,
+          repoRoot: this.deps.projectRoot,
+          worktreePath: input.worktreePath,
+          branch: input.branch,
+          profileName: input.profileName,
           yolo: input.profile.yolo === true,
           systemPrompt,
           prompt: input.launchMode === "fresh" ? input.prompt : undefined,
@@ -15188,6 +15597,10 @@ class LifecycleService {
         agent: buildAgentPaneCommand({
           agent: input.agent,
           runtimeEnvPath: input.initialized.paths.runtimeEnvPath,
+          repoRoot: this.deps.projectRoot,
+          worktreePath: input.worktreePath,
+          branch: input.branch,
+          profileName: input.profileName,
           yolo: input.profile.yolo === true,
           systemPrompt,
           prompt: input.launchMode === "fresh" ? input.prompt : undefined,
@@ -15312,6 +15725,7 @@ class LifecycleService {
     const baseBranch = input.mode === "new" ? requestedBaseBranch || this.deps.config.workspace.mainBranch : undefined;
     const branchAvailability = this.resolveBranchAvailability(input.branch, input.mode);
     const { profileName, profile } = this.resolveProfile(input.profile);
+    const agent = this.resolveAgentDefinition(input.agent);
     const worktreePath = this.resolveWorktreePath(input.branch);
     const createProgressBase = {
       branch: input.branch,
@@ -15336,7 +15750,7 @@ class LifecycleService {
         ...baseBranch ? { baseBranch } : {},
         ...branchAvailability.startPoint ? { startPoint: branchAvailability.startPoint } : {},
         profile: profileName,
-        agent: input.agent,
+        agent: agent.id,
         runtime: profile.runtime,
         startupEnvValues: await this.buildStartupEnvValues(input.envOverrides),
         allocatedPorts: await this.allocatePorts(),
@@ -15376,8 +15790,9 @@ class LifecycleService {
       });
       await this.materializeRuntimeSession({
         branch: input.branch,
+        profileName,
         profile,
-        agent: input.agent,
+        agent,
         initialized,
         worktreePath,
         prompt: input.prompt,
@@ -16114,7 +16529,7 @@ function mapCreationSnapshot(creating) {
     phase: creating.phase
   } : null;
 }
-function mapWorktreeSnapshot(state, now, creating, isArchived, findLinearIssue) {
+function mapWorktreeSnapshot(state, now, creating, isArchived, findLinearIssue, findAgentLabel) {
   return {
     branch: state.branch,
     ...state.baseBranch ? { baseBranch: state.baseBranch } : {},
@@ -16123,6 +16538,7 @@ function mapWorktreeSnapshot(state, now, creating, isArchived, findLinearIssue)
     archived: isArchived(state.path),
     profile: state.profile,
     agentName: state.agentName,
+    agentLabel: findAgentLabel ? findAgentLabel(state.agentName) : state.agentName,
     mux: state.session.exists,
     dirty: state.git.dirty,
     unpushed: state.git.aheadCount > 0,
@@ -16135,7 +16551,7 @@ function mapWorktreeSnapshot(state, now, creating, isArchived, findLinearIssue)
     creation: mapCreationSnapshot(creating)
   };
 }
-function mapCreatingWorktreeSnapshot(creating, isArchived, findLinearIssue) {
+function mapCreatingWorktreeSnapshot(creating, isArchived, findLinearIssue, findAgentLabel) {
   return {
     branch: creating.branch,
     ...creating.baseBranch ? { baseBranch: creating.baseBranch } : {},
@@ -16144,6 +16560,7 @@ function mapCreatingWorktreeSnapshot(creating, isArchived, findLinearIssue) {
     archived: isArchived(creating.path),
     profile: creating.profile,
     agentName: creating.agentName,
+    agentLabel: findAgentLabel ? findAgentLabel(creating.agentName) : creating.agentName,
     mux: false,
     dirty: false,
     unpushed: false,
@@ -16163,10 +16580,10 @@ function buildWorktreeSnapshots(input) {
   const creatingByBranch = new Map(creatingWorktrees.map((worktree) => [worktree.branch, worktree]));
   const runtimeWorktrees = input.runtime.listWorktrees();
   const runtimeBranches = new Set(runtimeWorktrees.map((worktree) => worktree.branch));
-  const worktrees = runtimeWorktrees.map((state) => mapWorktreeSnapshot(state, now, creatingByBranch.get(state.branch) ?? null, isArchived, input.findLinearIssue));
+  const worktrees = runtimeWorktrees.map((state) => mapWorktreeSnapshot(state, now, creatingByBranch.get(state.branch) ?? null, isArchived, input.findLinearIssue, input.findAgentLabel));
   for (const creating of creatingWorktrees) {
     if (!runtimeBranches.has(creating.branch)) {
-      worktrees.push(mapCreatingWorktreeSnapshot(creating, isArchived, input.findLinearIssue));
+      worktrees.push(mapCreatingWorktreeSnapshot(creating, isArchived, input.findLinearIssue, input.findAgentLabel));
     }
   }
   worktrees.sort((left, right) => left.branch.localeCompare(right.branch));
@@ -16195,6 +16612,7 @@ function buildAgentsUiWorktreeSummary(worktree, conversation) {
     archived: worktree.archived,
     profile: worktree.profile,
     agentName: worktree.agentName,
+    agentLabel: worktree.agentLabel,
     mux: worktree.mux,
     status: worktree.status,
     dirty: worktree.dirty,
@@ -16947,7 +17365,7 @@ class BunPortProbe {
 // backend/src/services/auto-name-service.ts
 var MAX_BRANCH_LENGTH = 40;
 var DEFAULT_AUTO_NAME_MODEL = "claude-haiku-4-5-20251001";
-var AUTO_NAME_TIMEOUT_MS = 1e4;
+var AUTO_NAME_TIMEOUT_MS = 15000;
 var DEFAULT_SYSTEM_PROMPT = [
   "Generate a concise git branch name from the task description.",
   "Return only the branch name.",
@@ -17668,7 +18086,6 @@ function createWebmuxRuntime(options = {}) {
 // backend/src/server.ts
 var PORT = parseInt(Bun.env.PORT || "5111", 10);
 var STATIC_DIR = Bun.env.WEBMUX_STATIC_DIR || "";
-var CODEX_TMUX_PROMPT_SUBMIT_DELAY_MS = 200;
 var runtime = createWebmuxRuntime({
   port: PORT,
   projectDir: Bun.env.WEBMUX_PROJECT_DIR || process.cwd()
@@ -17741,7 +18158,9 @@ function getFrontendConfig() {
       name,
       ...profile.systemPrompt ? { systemPrompt: profile.systemPrompt } : {}
     })),
+    agents: listAgentSummaries(config),
     defaultProfileName,
+    defaultAgentId: config.workspace.defaultAgent,
     autoName: config.autoName !== null,
     linearCreateTicketOption: config.integrations.linear.enabled && config.integrations.linear.createTicketOption,
     startupEnvs: config.startupEnvs,
@@ -17941,6 +18360,11 @@ async function readProjectSnapshot() {
         url: match.url,
         state: match.state
       } : null;
+    },
+    findAgentLabel: (agentId) => {
+      if (!agentId)
+        return null;
+      return getAgentDefinition(config, agentId)?.label ?? agentId;
     }
   });
 }
@@ -17971,12 +18395,24 @@ async function resolveAgentsWorktree(branch) {
     worktree
   };
 }
+function resolveWorktreeAgentChatSupport(worktree, action) {
+  return resolveAgentChatSupport({
+    agentId: worktree.agentName,
+    agentLabel: worktree.agentLabel,
+    agent: worktree.agentName ? getAgentDefinition(config, worktree.agentName) : null,
+    action
+  });
+}
 async function apiAttachAgentsWorktree(branch) {
   touchDashboardActivity();
   const resolved = await resolveAgentsWorktree(branch);
   if (!resolved.ok)
     return resolved.response;
-  const result = resolved.worktree.agentName === "claude" ? await claudeConversationService.attachWorktreeConversation(resolved.worktree) : await worktreeConversationService.attachWorktreeConversation(resolved.worktree);
+  const chatSupport = resolveWorktreeAgentChatSupport(resolved.worktree, "chat");
+  if (!chatSupport.ok) {
+    return errorResponse(chatSupport.error, chatSupport.status);
+  }
+  const result = chatSupport.data.provider === "claude" ? await claudeConversationService.attachWorktreeConversation(resolved.worktree) : await worktreeConversationService.attachWorktreeConversation(resolved.worktree);
   return result.ok ? jsonResponse(result.data) : errorResponse(result.error, result.status);
 }
 async function apiGetAgentsWorktreeHistory(branch) {
@@ -17984,7 +18420,11 @@ async function apiGetAgentsWorktreeHistory(branch) {
   const resolved = await resolveAgentsWorktree(branch);
   if (!resolved.ok)
     return resolved.response;
-  const result = resolved.worktree.agentName === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
+  const chatSupport = resolveWorktreeAgentChatSupport(resolved.worktree, "chat");
+  if (!chatSupport.ok) {
+    return errorResponse(chatSupport.error, chatSupport.status);
+  }
+  const result = chatSupport.data.provider === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
   return result.ok ? jsonResponse(result.data) : errorResponse(result.error, result.status);
 }
 async function apiSendAgentsWorktreeMessage(branch, req) {
@@ -17998,14 +18438,18 @@ async function apiSendAgentsWorktreeMessage(branch, req) {
   if (!resolved.worktree.mux) {
     return errorResponse("Open this worktree in the main dashboard before sending messages here", 409);
   }
-  const conversationResult = resolved.worktree.agentName === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
+  const chatSupport = resolveWorktreeAgentChatSupport(resolved.worktree, "chat");
+  if (!chatSupport.ok) {
+    return errorResponse(chatSupport.error, chatSupport.status);
+  }
+  const conversationResult = chatSupport.data.provider === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
   if (!conversationResult.ok) {
     return errorResponse(conversationResult.error, conversationResult.status);
   }
   const terminalWorktree = await resolveAgentsTerminalWorktree(branch);
   if (!terminalWorktree.ok)
     return terminalWorktree.response;
-  const sendResult = await sendPrompt(terminalWorktree.data.worktreeId, terminalWorktree.data.attachTarget, parsed.data.text, 0, undefined, resolved.worktree.agentName === "codex" ? CODEX_TMUX_PROMPT_SUBMIT_DELAY_MS : 0);
+  const sendResult = await sendPrompt(terminalWorktree.data.worktreeId, terminalWorktree.data.attachTarget, parsed.data.text, 0, undefined, chatSupport.data.submitDelayMs);
   if (!sendResult.ok) {
     return errorResponse(sendResult.error, 503);
   }
@@ -18023,7 +18467,11 @@ async function apiInterruptAgentsWorktree(branch) {
   if (!resolved.worktree.mux) {
     return errorResponse("Open this worktree in the main dashboard before interrupting it here", 409);
   }
-  const conversationResult = resolved.worktree.agentName === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
+  const chatSupport = resolveWorktreeAgentChatSupport(resolved.worktree, "interrupt");
+  if (!chatSupport.ok) {
+    return errorResponse(chatSupport.error, chatSupport.status);
+  }
+  const conversationResult = chatSupport.data.provider === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
   if (!conversationResult.ok) {
     return errorResponse(conversationResult.error, conversationResult.status);
   }
@@ -18048,7 +18496,14 @@ async function loadAgentsConversationSnapshot(branch) {
       message: await readErrorMessage(resolved.response)
     };
   }
-  const result = resolved.worktree.agentName === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
+  const chatSupport = resolveWorktreeAgentChatSupport(resolved.worktree, "chat");
+  if (!chatSupport.ok) {
+    return {
+      ok: false,
+      message: chatSupport.error
+    };
+  }
+  const result = chatSupport.data.provider === "claude" ? await claudeConversationService.readWorktreeConversation(resolved.worktree) : await worktreeConversationService.readWorktreeConversation(resolved.worktree);
   return result.ok ? { ok: true, data: result.data } : { ok: false, message: result.error };
 }
 async function readErrorMessage(response) {
@@ -18167,10 +18622,11 @@ async function apiCreateWorktree(req) {
   const prompt = body.prompt?.trim() ? body.prompt.trim() : undefined;
   const profile = body.profile;
   const agent = body.agent;
+  const agents = body.agents;
   const createLinearTicket = body.createLinearTicket === true;
   const linearTitle = body.linearTitle?.trim() ? body.linearTitle.trim() : undefined;
   const mode = body.mode;
-  const agentSelection = agent ?? config.workspace.defaultAgent;
+  const selectedAgents = agents ? agents : agent ? [agent] : [config.workspace.defaultAgent];
   if (baseBranch && !isValidBranchName(baseBranch)) {
     return errorResponse("Invalid base branch name", 400);
   }
@@ -18211,7 +18667,7 @@ async function apiCreateWorktree(req) {
     log.info(`[linear] created ticket ${linearResult.data.identifier} branch=${linearResult.data.branchName} title="${linearResult.data.title.slice(0, 80)}"`);
   }
   if (resolvedBranch) {
-    const targetBranches = buildCreateWorktreeTargets(resolvedBranch, agentSelection).map((target) => target.branch);
+    const targetBranches = buildCreateWorktreeTargets(resolvedBranch, selectedAgents).map((target) => target.branch);
     for (const targetBranch of targetBranches) {
       ensureBranchNotBusy(targetBranch);
     }
@@ -18219,14 +18675,14 @@ async function apiCreateWorktree(req) {
       return errorResponse("Base branch must differ from branch name", 400);
     }
   }
-  log.info(`[worktree:add] mode=${mode ?? "new"}${resolvedBranch ? ` branch=${resolvedBranch}` : ""}${baseBranch ? ` base=${baseBranch}` : ""}${profile ? ` profile=${profile}` : ""} agent=${agentSelection}${createLinearTicket ? " linearTicket=true" : ""}${prompt ? ` prompt="${prompt.slice(0, 80)}"` : ""}`);
+  log.info(`[worktree:add] mode=${mode ?? "new"}${resolvedBranch ? ` branch=${resolvedBranch}` : ""}${baseBranch ? ` base=${baseBranch}` : ""}${profile ? ` profile=${profile}` : ""} agents=${selectedAgents.join(",")}${createLinearTicket ? " linearTicket=true" : ""}${prompt ? ` prompt="${prompt.slice(0, 80)}"` : ""}`);
   const result = await lifecycleService.createWorktrees({
     mode,
     branch: resolvedBranch,
     baseBranch,
     prompt,
     profile,
-    agent: agentSelection,
+    ...agents && agents.length > 0 ? { agents } : { agent },
     envOverrides
   });
   log.debug(`[worktree:add] done branches=${result.branches.join(",")}`);
@@ -18290,6 +18746,72 @@ async function apiMergeWorktree(name) {
   log.debug(`[worktree:merge] done name=${name}`);
   return jsonResponse({ ok: true });
 }
+async function apiListAgents() {
+  return jsonResponse({ agents: listAgentDetails(config) });
+}
+async function apiValidateAgent(req) {
+  const parsed = await parseJsonBody(req, UpsertCustomAgentRequestSchema);
+  if (!parsed.ok)
+    return parsed.response;
+  return jsonResponse(validateCustomAgentInput(parsed.data));
+}
+async function apiCreateAgent(req) {
+  const parsed = await parseJsonBody(req, UpsertCustomAgentRequestSchema);
+  if (!parsed.ok)
+    return parsed.response;
+  const body = parsed.data;
+  const agentId = normalizeCustomAgentId(body.label);
+  if (isBuiltInAgentId(agentId) || config.agents[agentId]) {
+    return errorResponse(`Agent already exists: ${agentId}`, 409);
+  }
+  const agentConfig = {
+    label: body.label,
+    startCommand: body.startCommand,
+    ...body.resumeCommand?.trim() ? { resumeCommand: body.resumeCommand.trim() } : {}
+  };
+  await persistLocalCustomAgent(PROJECT_DIR, agentId, agentConfig);
+  config.agents[agentId] = agentConfig;
+  const agent = listAgentDetails(config).find((entry) => entry.id === agentId);
+  if (!agent) {
+    return errorResponse(`Created agent could not be loaded: ${agentId}`, 500);
+  }
+  return jsonResponse({ agent });
+}
+async function apiUpdateAgent(agentId, req) {
+  if (isBuiltInAgentId(agentId)) {
+    return errorResponse(`Built-in agent cannot be edited: ${agentId}`, 400);
+  }
+  if (!config.agents[agentId]) {
+    return errorResponse(`Unknown agent: ${agentId}`, 404);
+  }
+  const parsed = await parseJsonBody(req, UpsertCustomAgentRequestSchema);
+  if (!parsed.ok)
+    return parsed.response;
+  const body = parsed.data;
+  const agentConfig = {
+    label: body.label,
+    startCommand: body.startCommand,
+    ...body.resumeCommand?.trim() ? { resumeCommand: body.resumeCommand.trim() } : {}
+  };
+  await persistLocalCustomAgent(PROJECT_DIR, agentId, agentConfig);
+  config.agents[agentId] = agentConfig;
+  const agent = listAgentDetails(config).find((entry) => entry.id === agentId);
+  if (!agent) {
+    return errorResponse(`Updated agent could not be loaded: ${agentId}`, 500);
+  }
+  return jsonResponse({ agent });
+}
+async function apiDeleteAgent(agentId) {
+  if (isBuiltInAgentId(agentId)) {
+    return errorResponse(`Built-in agent cannot be deleted: ${agentId}`, 400);
+  }
+  if (!config.agents[agentId]) {
+    return errorResponse(`Unknown agent: ${agentId}`, 404);
+  }
+  await removeLocalCustomAgent(PROJECT_DIR, agentId);
+  delete config.agents[agentId];
+  return jsonResponse({ ok: true });
+}
 async function apiSetLinearAutoCreate(req) {
   const parsed = await parseJsonBody(req, ToggleEnabledRequestSchema);
   if (!parsed.ok)
@@ -18465,6 +18987,22 @@ function parseNotificationIdParam(params) {
     data: parsed.data.id
   };
 }
+function parseAgentIdParam(params) {
+  const parsed = parseParams(params, AgentIdParamsSchema);
+  if (!parsed.ok)
+    return parsed;
+  const agentId = parsed.data.id.trim();
+  if (!agentId) {
+    return {
+      ok: false,
+      response: errorResponse("Invalid agent id", 400)
+    };
+  }
+  return {
+    ok: true,
+    data: agentId
+  };
+}
 Bun.serve({
   port: PORT,
   idleTimeout: 255,
@@ -18491,6 +19029,27 @@ Bun.serve({
     [apiPaths.fetchProject]: {
       GET: () => catching("GET /api/project", () => apiGetProject())
     },
+    [apiPaths.fetchAgents]: {
+      GET: () => catching("GET /api/agents", () => apiListAgents()),
+      POST: (req) => catching("POST /api/agents", () => apiCreateAgent(req))
+    },
+    [apiPaths.validateAgent]: {
+      POST: (req) => catching("POST /api/agents/validate", () => apiValidateAgent(req))
+    },
+    [apiPaths.updateAgent]: {
+      PUT: (req) => {
+        const parsed = parseAgentIdParam(req.params);
+        if (!parsed.ok)
+          return parsed.response;
+        return catching("PUT /api/agents/:id", () => apiUpdateAgent(parsed.data, req));
+      },
+      DELETE: (req) => {
+        const parsed = parseAgentIdParam(req.params);
+        if (!parsed.ok)
+          return parsed.response;
+        return catching("DELETE /api/agents/:id", () => apiDeleteAgent(parsed.data));
+      }
+    },
     [apiPaths.attachAgentsWorktreeConversation]: {
       POST: (req) => {
         const parsed = parseWorktreeNameParam(req.params);