@evalops/maestro 0.10.50 → 0.10.51

package/dist/agent/subagent-specs.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-specs.js","sourceRoot":"","sources":["../../src/agent/subagent-specs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subagent Tool Specifications\n *\n * Defines different subagent types and what tools they have access to.\n * This enables fine-grained control over capabilities for different agent contexts:\n * - explorer: Read-only exploration of codebase\n * - planner: Can read and use todo, but no file modifications\n * - coder: Full coding capabilities\n * - reviewer: Read-only with web access for reviewing code\n * - researcher: Web search and fetch focused\n *\n * Inspired by Amp's subagentSpec/subagentType system.\n */\n\nimport { createLogger } from \"../utils/logger.js\";\nimport { normalizeToolNameForSafety } from \"../utils/safety-normalization.js\";\n\nconst logger = createLogger(\"agent:subagent-specs\");\n\n/**\n * Available subagent types.\n */\nexport type SubagentType =\n\t| \"explorer\"\n\t| \"planner\"\n\t| \"coder\"\n\t| \"reviewer\"\n\t| \"researcher\"\n\t| \"minimal\"\n\t| \"custom\";\n\n/**\n * Tool categories for easier specification.\n */\nexport const TOOL_CATEGORIES = {\n\t/** Read-only file system tools */\n\tread: [\n\t\t\"read\",\n\t\t\"list\",\n\t\t\"find\",\n\t\t\"search\",\n\t\t\"parallel_ripgrep\",\n\t\t\"diff\",\n\t\t\"status\",\n\t],\n\t/** File modification tools */\n\twrite: [\"apply_patch\", \"edit\", \"write\", \"notebook_edit\"],\n\t/** Shell execution */\n\tshell: [\"bash\", \"background_tasks\"],\n\t/** Web and external tools */\n\tweb: [\"websearch\", \"webfetch\", \"codesearch\"],\n\t/** Interactive tools */\n\tinteractive: [\"ask_user\", \"todo\"],\n\t/** GitHub tools */\n\tgithub: [\"gh_pr\", \"gh_issue\", \"gh_repo\"],\n\t/** Advanced tools */\n\tadvanced: [\"oracle\"],\n} as const;\n\n/**\n * Get all tool names from categories.\n */\nfunction toolsFromCategories(\n\t...categories: (keyof typeof TOOL_CATEGORIES)[]\n): string[] {\n\tconst tools: string[] = [];\n\tfor (const cat of categories) {\n\t\ttools.push(...TOOL_CATEGORIES[cat]);\n\t}\n\treturn [...new Set(tools)];\n}\n\n/**\n * Subagent specification defining capabilities.\n */\nexport interface SubagentSpec {\n\t/** Display name */\n\tdisplayName: string;\n\t/** Description of what this subagent is for */\n\tdescription: string;\n\t/** Tools that are allowed (whitelist) */\n\tallowedTools: string[];\n\t/** Tools that are explicitly denied (takes precedence) */\n\tdeniedTools?: string[];\n\t/** Whether MCP servers can provide additional tools */\n\tallowMcp: boolean;\n\t/** Whether toolbox tools are allowed */\n\tallowToolbox: boolean;\n\t/** Maximum number of tool calls per turn */\n\tmaxToolCallsPerTurn?: number;\n\t/** Whether dangerous operations require extra confirmation */\n\trequireConfirmation?: boolean;\n}\n\n/**\n * Default subagent specifications.\n */\nexport const SUBAGENT_SPECS: Record<SubagentType, SubagentSpec> = {\n\texplorer: {\n\t\tdisplayName: \"Explorer\",\n\t\tdescription: \"Read-only codebase exploration - can search and read files\",\n\t\tallowedTools: toolsFromCategories(\"read\", \"advanced\"),\n\t\tdeniedTools: [\"oracle\"], // Explorers shouldn't invoke oracle\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 20,\n\t\trequireConfirmation: false,\n\t},\n\tplanner: {\n\t\tdisplayName: \"Planner\",\n\t\tdescription: \"Planning mode - can read files and manage todos\",\n\t\tallowedTools: [...toolsFromCategories(\"read\", \"interactive\")],\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 15,\n\t\trequireConfirmation: false,\n\t},\n\tcoder: {\n\t\tdisplayName: \"Coder\",\n\t\tdescription: \"Full coding capabilities - can read, write, and execute\",\n\t\tallowedTools: toolsFromCategories(\n\t\t\t\"read\",\n\t\t\t\"write\",\n\t\t\t\"shell\",\n\t\t\t\"interactive\",\n\t\t\t\"github\",\n\t\t\t\"advanced\",\n\t\t),\n\t\tallowMcp: true,\n\t\tallowToolbox: true,\n\t\tmaxToolCallsPerTurn: 30,\n\t\trequireConfirmation: true,\n\t},\n\treviewer: {\n\t\tdisplayName: \"Reviewer\",\n\t\tdescription: \"Code review mode - can read files and search web\",\n\t\tallowedTools: [...toolsFromCategories(\"read\", \"web\"), \"ask_user\"],\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 15,\n\t\trequireConfirmation: false,\n\t},\n\tresearcher: {\n\t\tdisplayName: \"Researcher\",\n\t\tdescription: \"Research mode - focused on web search and analysis\",\n\t\tallowedTools: [...toolsFromCategories(\"web\", \"read\"), \"ask_user\", \"todo\"],\n\t\tallowMcp: true,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 20,\n\t\trequireConfirmation: false,\n\t},\n\tminimal: {\n\t\tdisplayName: \"Minimal\",\n\t\tdescription: \"Minimal capabilities - only basic read operations\",\n\t\tallowedTools: [\"read\", \"list\", \"search\"],\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 10,\n\t\trequireConfirmation: false,\n\t},\n\tcustom: {\n\t\tdisplayName: \"Custom\",\n\t\tdescription: \"User-defined tool specification\",\n\t\tallowedTools: toolsFromCategories(\n\t\t\t\"read\",\n\t\t\t\"write\",\n\t\t\t\"shell\",\n\t\t\t\"interactive\",\n\t\t\t\"advanced\",\n\t\t),\n\t\tallowMcp: true,\n\t\tallowToolbox: true,\n\t\trequireConfirmation: true,\n\t},\n};\n\n/**\n * Get specification for a subagent type.\n */\nexport function getSubagentSpec(type: SubagentType): SubagentSpec {\n\treturn SUBAGENT_SPECS[type];\n}\n\n/**\n * Check if a tool is allowed for a subagent type.\n */\nexport function isToolAllowed(\n\ttoolName: string,\n\ttype: SubagentType,\n\tcustomSpec?: Partial<SubagentSpec>,\n): boolean {\n\tconst spec = customSpec\n\t\t? { ...SUBAGENT_SPECS[type], ...customSpec }\n\t\t: SUBAGENT_SPECS[type];\n\tconst normalizedToolName = normalizeToolNameForSafety(toolName);\n\tconst deniedTools = spec.deniedTools?.map(normalizeToolNameForSafety) ?? [];\n\tconst allowedTools = spec.allowedTools.map(normalizeToolNameForSafety);\n\n\t// Denied tools take precedence\n\tif (deniedTools.includes(normalizedToolName)) {\n\t\treturn false;\n\t}\n\n\t// Check if in allowed list\n\treturn allowedTools.includes(normalizedToolName);\n}\n\n/**\n * Get the list of allowed tools for a subagent type.\n */\nexport function getAllowedTools(\n\ttype: SubagentType,\n\tcustomSpec?: Partial<SubagentSpec>,\n): string[] {\n\tconst spec = customSpec\n\t\t? { ...SUBAGENT_SPECS[type], ...customSpec }\n\t\t: SUBAGENT_SPECS[type];\n\n\tlet tools = spec.allowedTools.map(normalizeToolNameForSafety);\n\n\t// Remove denied tools\n\tif (spec.deniedTools) {\n\t\tconst deniedTools = new Set(\n\t\t\tspec.deniedTools.map(normalizeToolNameForSafety),\n\t\t);\n\t\ttools = tools.filter((t) => !deniedTools.has(t));\n\t}\n\n\treturn [...new Set(tools)];\n}\n\n/**\n * Filter a list of tools based on subagent spec.\n */\nexport function filterToolsForSubagent<T extends { name: string }>(\n\ttools: T[],\n\ttype: SubagentType,\n\tcustomSpec?: Partial<SubagentSpec>,\n): T[] {\n\tconst allowedTools = getAllowedTools(type, customSpec);\n\n\treturn tools.filter((tool) => {\n\t\tconst toolName = normalizeToolNameForSafety(tool.name);\n\t\treturn allowedTools.includes(toolName);\n\t});\n}\n\n/**\n * Current subagent type for the session.\n */\nlet currentSubagentType: SubagentType = \"coder\";\n\n/**\n * Get the current subagent type.\n */\nexport function getCurrentSubagentType(): SubagentType {\n\treturn currentSubagentType;\n}\n\n/**\n * Set the current subagent type.\n */\nexport function setCurrentSubagentType(type: SubagentType): void {\n\tlogger.info(\"Setting subagent type\", { type });\n\tcurrentSubagentType = type;\n}\n\n/**\n * Parse subagent type from string.\n */\nexport function parseSubagentType(typeStr: string): SubagentType | null {\n\tconst normalized = normalizeToolNameForSafety(typeStr);\n\tif (normalized in SUBAGENT_SPECS) {\n\t\treturn normalized as SubagentType;\n\t}\n\treturn null;\n}\n\n/**\n * Get subagent type from environment variable.\n */\nexport function getSubagentTypeFromEnv(): SubagentType {\n\tconst envType = process.env.MAESTRO_SUBAGENT_TYPE?.toLowerCase();\n\tif (envType && envType in SUBAGENT_SPECS) {\n\t\treturn envType as SubagentType;\n\t}\n\treturn \"coder\";\n}\n\n/**\n * Format subagent type for display.\n */\nexport function formatSubagentDisplay(type: SubagentType): string {\n\tconst spec = getSubagentSpec(type);\n\treturn `${spec.displayName} - ${spec.description}`;\n}\n\n/**\n * Get all available subagent types with their specs.\n */\nexport function getAllSubagentTypes(): Array<{\n\ttype: SubagentType;\n\tspec: SubagentSpec;\n}> {\n\treturn (Object.entries(SUBAGENT_SPECS) as [SubagentType, SubagentSpec][]).map(\n\t\t([type, spec]) => ({\n\t\t\ttype,\n\t\t\tspec,\n\t\t}),\n\t);\n}\n\n/**\n * Create a custom subagent spec by merging with a base type.\n */\nexport function createCustomSpec(\n\tbaseType: SubagentType,\n\toverrides: Partial<SubagentSpec>,\n): SubagentSpec {\n\treturn {\n\t\t...SUBAGENT_SPECS[baseType],\n\t\t...overrides,\n\t\tdisplayName: overrides.displayName ?? \"Custom\",\n\t\tdescription: overrides.description ?? \"Custom configuration\",\n\t};\n}\n\n/**\n * Validate a subagent spec.\n */\nexport function validateSpec(spec: Partial<SubagentSpec>): string[] {\n\tconst errors: string[] = [];\n\n\tif (spec.allowedTools && spec.allowedTools.length === 0) {\n\t\terrors.push(\"allowedTools cannot be empty\");\n\t}\n\n\tif (spec.maxToolCallsPerTurn !== undefined && spec.maxToolCallsPerTurn < 1) {\n\t\terrors.push(\"maxToolCallsPerTurn must be at least 1\");\n\t}\n\n\treturn errors;\n}\n"]}
+{"version":3,"file":"subagent-specs.js","sourceRoot":"","sources":["../../src/agent/subagent-specs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subagent Tool Specifications\n *\n * Defines different subagent types and what tools they have access to.\n * This enables fine-grained control over capabilities for different agent contexts:\n * - explorer: Read-only exploration of codebase\n * - planner: Can read and use todo, but no file modifications\n * - coder: Full coding capabilities\n * - reviewer: Read-only with web access for reviewing code\n * - researcher: Web search and fetch focused\n * - browser-qa: Browser-based product QA with screenshots and repro evidence\n *\n * Inspired by Amp's subagentSpec/subagentType system.\n */\n\nimport { codexSubagentLaneForType } from \"../codex/subagent-dispatch-table.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { normalizeToolNameForSafety } from \"../utils/safety-normalization.js\";\n\nconst logger = createLogger(\"agent:subagent-specs\");\n\n/**\n * Available subagent types.\n */\nexport type SubagentType =\n\t| \"explorer\"\n\t| \"planner\"\n\t| \"coder\"\n\t| \"reviewer\"\n\t| \"test-runner\"\n\t| \"researcher\"\n\t| \"browser-qa\"\n\t| \"minimal\"\n\t| \"custom\";\n\nconst CODEX_LANE_SUBAGENT_TYPES: Record<string, SubagentType> = {\n\t\"code-writer\": \"coder\",\n\t\"code-review\": \"reviewer\",\n\t\"test-runner\": \"test-runner\",\n\t\"browser-qa\": \"browser-qa\",\n\t\"repo-explorer\": \"explorer\",\n\t\"release-shepherd\": \"coder\",\n};\n\n/**\n * Tool categories for easier specification.\n */\nexport const TOOL_CATEGORIES = {\n\t/** Read-only file system tools */\n\tread: [\n\t\t\"read\",\n\t\t\"list\",\n\t\t\"find\",\n\t\t\"search\",\n\t\t\"parallel_ripgrep\",\n\t\t\"diff\",\n\t\t\"status\",\n\t],\n\t/** File modification tools */\n\twrite: [\"apply_patch\", \"edit\", \"write\", \"notebook_edit\"],\n\t/** Shell execution */\n\tshell: [\"bash\", \"background_tasks\"],\n\t/** Web and external tools */\n\tweb: [\"websearch\", \"webfetch\", \"codesearch\"],\n\t/** Browser/product QA tools */\n\tbrowser: [\n\t\t\"agent_browser\",\n\t\t\"browser_open\",\n\t\t\"browser_snapshot\",\n\t\t\"browser_click\",\n\t\t\"browser_fill\",\n\t\t\"browser_type\",\n\t\t\"browser_screenshot\",\n\t\t\"browser_console\",\n\t\t\"browser_record\",\n\t\t\"read_page\",\n\t\t\"search_page\",\n\t\t\"find_on_page\",\n\t\t\"extract_links\",\n\t\t\"wait_for_selector\",\n\t\t\"click_element\",\n\t\t\"type_text\",\n\t\t\"scroll_page\",\n\t\t\"select_element\",\n\t\t\"navigate_to\",\n\t\t\"open_links_in_tabs\",\n\t\t\"highlight_element\",\n\t\t\"browser_operator\",\n\t\t\"mouse_action\",\n\t\t\"pointer_action\",\n\t\t\"keyboard_action\",\n\t\t\"extract_table_data\",\n\t\t\"capture_network\",\n\t\t\"capture_console_errors\",\n\t\t\"collect_diagnostics\",\n\t\t\"extract_document\",\n\t\t\"capture_screenshot\",\n\t\t\"native_click\",\n\t\t\"native_type\",\n\t\t\"native_press\",\n\t\t\"native_key_down\",\n\t\t\"native_key_up\",\n\t],\n\t/** Interactive tools */\n\tinteractive: [\"ask_user\", \"todo\"],\n\t/** GitHub tools */\n\tgithub: [\"gh_pr\", \"gh_issue\", \"gh_repo\"],\n\t/** Advanced tools */\n\tadvanced: [\"oracle\"],\n} as const;\n\n/**\n * Get all tool names from categories.\n */\nfunction toolsFromCategories(\n\t...categories: (keyof typeof TOOL_CATEGORIES)[]\n): string[] {\n\tconst tools: string[] = [];\n\tfor (const cat of categories) {\n\t\ttools.push(...TOOL_CATEGORIES[cat]);\n\t}\n\treturn [...new Set(tools)];\n}\n\n/**\n * Subagent specification defining capabilities.\n */\nexport interface SubagentSpec {\n\t/** Display name */\n\tdisplayName: string;\n\t/** Description of what this subagent is for */\n\tdescription: string;\n\t/** Tools that are allowed (whitelist) */\n\tallowedTools: string[];\n\t/** Tools that are explicitly denied (takes precedence) */\n\tdeniedTools?: string[];\n\t/** Whether MCP servers can provide additional tools */\n\tallowMcp: boolean;\n\t/** Whether toolbox tools are allowed */\n\tallowToolbox: boolean;\n\t/** Maximum number of tool calls per turn */\n\tmaxToolCallsPerTurn?: number;\n\t/** Whether dangerous operations require extra confirmation */\n\trequireConfirmation?: boolean;\n}\n\n/**\n * Default subagent specifications.\n */\nexport const SUBAGENT_SPECS: Record<SubagentType, SubagentSpec> = {\n\texplorer: {\n\t\tdisplayName: \"Explorer\",\n\t\tdescription: \"Read-only codebase exploration - can search and read files\",\n\t\tallowedTools: toolsFromCategories(\"read\", \"advanced\"),\n\t\tdeniedTools: [\"oracle\"], // Explorers shouldn't invoke oracle\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 20,\n\t\trequireConfirmation: false,\n\t},\n\tplanner: {\n\t\tdisplayName: \"Planner\",\n\t\tdescription: \"Planning mode - can read files and manage todos\",\n\t\tallowedTools: [...toolsFromCategories(\"read\", \"interactive\")],\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 15,\n\t\trequireConfirmation: false,\n\t},\n\tcoder: {\n\t\tdisplayName: \"Coder\",\n\t\tdescription: \"Full coding capabilities - can read, write, and execute\",\n\t\tallowedTools: toolsFromCategories(\n\t\t\t\"read\",\n\t\t\t\"write\",\n\t\t\t\"shell\",\n\t\t\t\"interactive\",\n\t\t\t\"github\",\n\t\t\t\"advanced\",\n\t\t),\n\t\tallowMcp: true,\n\t\tallowToolbox: true,\n\t\tmaxToolCallsPerTurn: 30,\n\t\trequireConfirmation: true,\n\t},\n\treviewer: {\n\t\tdisplayName: \"Reviewer\",\n\t\tdescription: \"Code review mode - can read files and search web\",\n\t\tallowedTools: [...toolsFromCategories(\"read\", \"web\"), \"ask_user\"],\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 15,\n\t\trequireConfirmation: false,\n\t},\n\t\"test-runner\": {\n\t\tdisplayName: \"Test Runner\",\n\t\tdescription: \"Test execution mode - can run checks and inspect results\",\n\t\tallowedTools: [\n\t\t\t...toolsFromCategories(\"read\", \"shell\", \"interactive\"),\n\t\t\t\"webfetch\",\n\t\t],\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 20,\n\t\trequireConfirmation: false,\n\t},\n\tresearcher: {\n\t\tdisplayName: \"Researcher\",\n\t\tdescription: \"Research mode - focused on web search and analysis\",\n\t\tallowedTools: [...toolsFromCategories(\"web\", \"read\"), \"ask_user\", \"todo\"],\n\t\tallowMcp: true,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 20,\n\t\trequireConfirmation: false,\n\t},\n\t\"browser-qa\": {\n\t\tdisplayName: \"Browser QA\",\n\t\tdescription:\n\t\t\t\"Product QA mode - explores web surfaces and captures repro evidence\",\n\t\tallowedTools: [\n\t\t\t...toolsFromCategories(\"read\", \"web\", \"browser\"),\n\t\t\t\"bash\",\n\t\t\t\"ask_user\",\n\t\t\t\"todo\",\n\t\t],\n\t\tallowMcp: true,\n\t\tallowToolbox: true,\n\t\tmaxToolCallsPerTurn: 25,\n\t\trequireConfirmation: false,\n\t},\n\tminimal: {\n\t\tdisplayName: \"Minimal\",\n\t\tdescription: \"Minimal capabilities - only basic read operations\",\n\t\tallowedTools: [\"read\", \"list\", \"search\"],\n\t\tallowMcp: false,\n\t\tallowToolbox: false,\n\t\tmaxToolCallsPerTurn: 10,\n\t\trequireConfirmation: false,\n\t},\n\tcustom: {\n\t\tdisplayName: \"Custom\",\n\t\tdescription: \"User-defined tool specification\",\n\t\tallowedTools: toolsFromCategories(\n\t\t\t\"read\",\n\t\t\t\"write\",\n\t\t\t\"shell\",\n\t\t\t\"interactive\",\n\t\t\t\"advanced\",\n\t\t),\n\t\tallowMcp: true,\n\t\tallowToolbox: true,\n\t\trequireConfirmation: true,\n\t},\n};\n\n/**\n * Get specification for a subagent type.\n */\nexport function getSubagentSpec(type: SubagentType): SubagentSpec {\n\treturn SUBAGENT_SPECS[type];\n}\n\n/**\n * Check if a tool is allowed for a subagent type.\n */\nexport function isToolAllowed(\n\ttoolName: string,\n\ttype: SubagentType,\n\tcustomSpec?: Partial<SubagentSpec>,\n): boolean {\n\tconst spec = customSpec\n\t\t? { ...SUBAGENT_SPECS[type], ...customSpec }\n\t\t: SUBAGENT_SPECS[type];\n\tconst normalizedToolName = normalizeToolNameForSafety(toolName);\n\tconst deniedTools = spec.deniedTools?.map(normalizeToolNameForSafety) ?? [];\n\tconst allowedTools = spec.allowedTools.map(normalizeToolNameForSafety);\n\n\t// Denied tools take precedence\n\tif (deniedTools.includes(normalizedToolName)) {\n\t\treturn false;\n\t}\n\n\t// Check if in allowed list\n\treturn allowedTools.includes(normalizedToolName);\n}\n\n/**\n * Get the list of allowed tools for a subagent type.\n */\nexport function getAllowedTools(\n\ttype: SubagentType,\n\tcustomSpec?: Partial<SubagentSpec>,\n): string[] {\n\tconst spec = customSpec\n\t\t? { ...SUBAGENT_SPECS[type], ...customSpec }\n\t\t: SUBAGENT_SPECS[type];\n\n\tlet tools = spec.allowedTools.map(normalizeToolNameForSafety);\n\n\t// Remove denied tools\n\tif (spec.deniedTools) {\n\t\tconst deniedTools = new Set(\n\t\t\tspec.deniedTools.map(normalizeToolNameForSafety),\n\t\t);\n\t\ttools = tools.filter((t) => !deniedTools.has(t));\n\t}\n\n\treturn [...new Set(tools)];\n}\n\n/**\n * Filter a list of tools based on subagent spec.\n */\nexport function filterToolsForSubagent<T extends { name: string }>(\n\ttools: T[],\n\ttype: SubagentType,\n\tcustomSpec?: Partial<SubagentSpec>,\n): T[] {\n\tconst allowedTools = getAllowedTools(type, customSpec);\n\n\treturn tools.filter((tool) => {\n\t\tconst toolName = normalizeToolNameForSafety(tool.name);\n\t\treturn allowedTools.includes(toolName);\n\t});\n}\n\n/**\n * Current subagent type for the session.\n */\nlet currentSubagentType: SubagentType = \"coder\";\n\n/**\n * Get the current subagent type.\n */\nexport function getCurrentSubagentType(): SubagentType {\n\treturn currentSubagentType;\n}\n\n/**\n * Set the current subagent type.\n */\nexport function setCurrentSubagentType(type: SubagentType): void {\n\tlogger.info(\"Setting subagent type\", { type });\n\tcurrentSubagentType = type;\n}\n\n/**\n * Parse subagent type from string.\n */\nexport function parseSubagentType(typeStr: string): SubagentType | null {\n\tconst normalized = normalizeToolNameForSafety(typeStr);\n\tconst hyphenated = normalized.replace(/_/g, \"-\");\n\tif (hyphenated in SUBAGENT_SPECS) {\n\t\treturn hyphenated as SubagentType;\n\t}\n\tconst lane = codexSubagentLaneForType(typeStr);\n\treturn lane ? (CODEX_LANE_SUBAGENT_TYPES[lane.laneId] ?? null) : null;\n}\n\n/**\n * Get subagent type from environment variable.\n */\nexport function getSubagentTypeFromEnv(): SubagentType {\n\treturn parseSubagentType(process.env.MAESTRO_SUBAGENT_TYPE ?? \"\") ?? \"coder\";\n}\n\n/**\n * Format subagent type for display.\n */\nexport function formatSubagentDisplay(type: SubagentType): string {\n\tconst spec = getSubagentSpec(type);\n\treturn `${spec.displayName} - ${spec.description}`;\n}\n\n/**\n * Get all available subagent types with their specs.\n */\nexport function getAllSubagentTypes(): Array<{\n\ttype: SubagentType;\n\tspec: SubagentSpec;\n}> {\n\treturn (Object.entries(SUBAGENT_SPECS) as [SubagentType, SubagentSpec][]).map(\n\t\t([type, spec]) => ({\n\t\t\ttype,\n\t\t\tspec,\n\t\t}),\n\t);\n}\n\n/**\n * Create a custom subagent spec by merging with a base type.\n */\nexport function createCustomSpec(\n\tbaseType: SubagentType,\n\toverrides: Partial<SubagentSpec>,\n): SubagentSpec {\n\treturn {\n\t\t...SUBAGENT_SPECS[baseType],\n\t\t...overrides,\n\t\tdisplayName: overrides.displayName ?? \"Custom\",\n\t\tdescription: overrides.description ?? \"Custom configuration\",\n\t};\n}\n\n/**\n * Validate a subagent spec.\n */\nexport function validateSpec(spec: Partial<SubagentSpec>): string[] {\n\tconst errors: string[] = [];\n\n\tif (spec.allowedTools && spec.allowedTools.length === 0) {\n\t\terrors.push(\"allowedTools cannot be empty\");\n\t}\n\n\tif (spec.maxToolCallsPerTurn !== undefined && spec.maxToolCallsPerTurn < 1) {\n\t\terrors.push(\"maxToolCallsPerTurn must be at least 1\");\n\t}\n\n\treturn errors;\n}\n"]}

package/dist/agent/swarm/coverage-gate.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Swarm coverage gate
+ *
+ * Pre-dispatch check that refuses to start a swarm until its validation
+ * contract is fully covered: every assertion claimed by exactly one feature,
+ * no duplicate claims, and no claim referencing an unknown assertion.
+ *
+ * The gate is opt-in: a swarm configured without a validation contract passes
+ * unconditionally, preserving existing behavior. When a contract is present,
+ * the orchestrator must supply feature claims that cover it (see
+ * ./orchestrator-prompt.ts).
+ */
+import { type CoverageReport, type FeatureClaim, type ValidationContract } from "../validation-contract.js";
+export interface SwarmCoverageGateInput {
+    /** Mission validation contract; when absent the gate passes unconditionally. */
+    validationContract?: ValidationContract;
+    /** Feature claims to evaluate against the contract. */
+    featureClaims?: FeatureClaim[];
+}
+export interface SwarmCoverageGateResult {
+    /** True when there is no contract to gate, or coverage is complete. */
+    ok: boolean;
+    /** Coverage report, present only when a contract was evaluated. */
+    report?: CoverageReport;
+    /** Actionable failure message, present only when ok is false. */
+    message?: string;
+}
+/**
+ * Render an actionable, single-string explanation of why coverage failed.
+ */
+export declare function formatCoverageGateFailure(report: CoverageReport): string;
+/**
+ * Evaluate the coverage gate for a swarm. Passes unconditionally when no
+ * validation contract is configured.
+ */
+export declare function evaluateSwarmCoverageGate(input: SwarmCoverageGateInput): SwarmCoverageGateResult;
+//# sourceMappingURL=coverage-gate.d.ts.map

package/dist/agent/swarm/coverage-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-gate.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/coverage-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAEvB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,sBAAsB;IACtC,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,uDAAuD;IACvD,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACvC,uEAAuE;IACvE,EAAE,EAAE,OAAO,CAAC;IACZ,mEAAmE;IACnE,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAuBxE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,sBAAsB,GAC3B,uBAAuB,CAUzB"}

package/dist/agent/swarm/coverage-gate.js

@@ -0,0 +1,48 @@
+/**
+ * Swarm coverage gate
+ *
+ * Pre-dispatch check that refuses to start a swarm until its validation
+ * contract is fully covered: every assertion claimed by exactly one feature,
+ * no duplicate claims, and no claim referencing an unknown assertion.
+ *
+ * The gate is opt-in: a swarm configured without a validation contract passes
+ * unconditionally, preserving existing behavior. When a contract is present,
+ * the orchestrator must supply feature claims that cover it (see
+ * ./orchestrator-prompt.ts).
+ */
+import { checkCoverage, } from "../validation-contract.js";
+/**
+ * Render an actionable, single-string explanation of why coverage failed.
+ */
+export function formatCoverageGateFailure(report) {
+    const parts = [
+        "Swarm refused to start: the validation contract is not fully covered.",
+    ];
+    if (report.orphans.length > 0) {
+        parts.push(`Unclaimed assertions (no feature fulfills them): ${report.orphans.join(", ")}.`);
+    }
+    if (report.duplicates.length > 0) {
+        parts.push(`Assertions claimed more than once or duplicated in the contract: ${report.duplicates.join(", ")}.`);
+    }
+    if (report.unknownAssertions.length > 0) {
+        parts.push(`Features reference assertions absent from the contract: ${report.unknownAssertions.join(", ")}.`);
+    }
+    parts.push("Every assertion must be claimed by exactly one feature before work begins.");
+    return parts.join(" ");
+}
+/**
+ * Evaluate the coverage gate for a swarm. Passes unconditionally when no
+ * validation contract is configured.
+ */
+export function evaluateSwarmCoverageGate(input) {
+    const { validationContract, featureClaims } = input;
+    if (!validationContract) {
+        return { ok: true };
+    }
+    const report = checkCoverage(validationContract, featureClaims ?? []);
+    if (report.ok) {
+        return { ok: true, report };
+    }
+    return { ok: false, report, message: formatCoverageGateFailure(report) };
+}
+//# sourceMappingURL=coverage-gate.js.map

package/dist/agent/swarm/coverage-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-gate.js","sourceRoot":"","sources":["../../../src/agent/swarm/coverage-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAIN,aAAa,GACb,MAAM,2BAA2B,CAAC;AAkBnC;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC/D,MAAM,KAAK,GAAa;QACvB,uEAAuE;KACvE,CAAC;IACF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CACT,oDAAoD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAChF,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACT,oEAAoE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACnG,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CACT,2DAA2D,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjG,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CACT,4EAA4E,CAC5E,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACxC,KAA6B;IAE7B,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACpD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,kBAAkB,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC;IACtE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1E,CAAC","sourcesContent":["/**\n * Swarm coverage gate\n *\n * Pre-dispatch check that refuses to start a swarm until its validation\n * contract is fully covered: every assertion claimed by exactly one feature,\n * no duplicate claims, and no claim referencing an unknown assertion.\n *\n * The gate is opt-in: a swarm configured without a validation contract passes\n * unconditionally, preserving existing behavior. When a contract is present,\n * the orchestrator must supply feature claims that cover it (see\n * ./orchestrator-prompt.ts).\n */\n\nimport {\n\ttype CoverageReport,\n\ttype FeatureClaim,\n\ttype ValidationContract,\n\tcheckCoverage,\n} from \"../validation-contract.js\";\n\nexport interface SwarmCoverageGateInput {\n\t/** Mission validation contract; when absent the gate passes unconditionally. */\n\tvalidationContract?: ValidationContract;\n\t/** Feature claims to evaluate against the contract. */\n\tfeatureClaims?: FeatureClaim[];\n}\n\nexport interface SwarmCoverageGateResult {\n\t/** True when there is no contract to gate, or coverage is complete. */\n\tok: boolean;\n\t/** Coverage report, present only when a contract was evaluated. */\n\treport?: CoverageReport;\n\t/** Actionable failure message, present only when ok is false. */\n\tmessage?: string;\n}\n\n/**\n * Render an actionable, single-string explanation of why coverage failed.\n */\nexport function formatCoverageGateFailure(report: CoverageReport): string {\n\tconst parts: string[] = [\n\t\t\"Swarm refused to start: the validation contract is not fully covered.\",\n\t];\n\tif (report.orphans.length > 0) {\n\t\tparts.push(\n\t\t\t`Unclaimed assertions (no feature fulfills them): ${report.orphans.join(\", \")}.`,\n\t\t);\n\t}\n\tif (report.duplicates.length > 0) {\n\t\tparts.push(\n\t\t\t`Assertions claimed more than once or duplicated in the contract: ${report.duplicates.join(\", \")}.`,\n\t\t);\n\t}\n\tif (report.unknownAssertions.length > 0) {\n\t\tparts.push(\n\t\t\t`Features reference assertions absent from the contract: ${report.unknownAssertions.join(\", \")}.`,\n\t\t);\n\t}\n\tparts.push(\n\t\t\"Every assertion must be claimed by exactly one feature before work begins.\",\n\t);\n\treturn parts.join(\" \");\n}\n\n/**\n * Evaluate the coverage gate for a swarm. Passes unconditionally when no\n * validation contract is configured.\n */\nexport function evaluateSwarmCoverageGate(\n\tinput: SwarmCoverageGateInput,\n): SwarmCoverageGateResult {\n\tconst { validationContract, featureClaims } = input;\n\tif (!validationContract) {\n\t\treturn { ok: true };\n\t}\n\tconst report = checkCoverage(validationContract, featureClaims ?? []);\n\tif (report.ok) {\n\t\treturn { ok: true, report };\n\t}\n\treturn { ok: false, report, message: formatCoverageGateFailure(report) };\n}\n"]}

package/dist/agent/swarm/executor.d.ts

@@ -63,6 +63,7 @@ export declare class SwarmExecutor {
     private selectA2APeerName;
     private resolveA2ASkillId;
     private resolveA2ATaskClass;
+    private resolveA2ARole;
     private teammateIndex;
     private nextA2ARouteIndex;
     private defaultA2ADiscoveryLimit;

package/dist/agent/swarm/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyDH,OAAO,KAAK,EAEX,WAAW,EAEX,iBAAiB,EACjB,UAAU,EAKV,MAAM,YAAY,CAAC;AAwVpB;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,cAAc,CAAgD;IACtE,OAAO,CAAC,oBAAoB,CACjB;IACX,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,eAAe,CAAkB;gBAE7B,MAAM,EAAE,WAAW;IAwC/B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAK/C;;OAEG;IACH,OAAO,CAAC,IAAI;IAmBZ;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,MAAM,IAAI,IAAI;YAoCA,mBAAmB;IAmCjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAsEpC;;OAEG;YACW,WAAW;IAyCzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,oCAAoC;IA6B5C;;OAEG;YACW,gBAAgB;IA8D9B,OAAO,CAAC,mBAAmB;IA2C3B,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,gBAAgB;YAyDV,uBAAuB;YAgCvB,yCAAyC;YAqFzC,6BAA6B;IAwC3C,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,wBAAwB;YAQlB,aAAa;YAqSb,gBAAgB;IAmM9B,OAAO,CAAC,4BAA4B;IAmDpC,OAAO,CAAC,4BAA4B;YA2DtB,mBAAmB;IA+BjC,OAAO,CAAC,mBAAmB;IA8D3B,OAAO,CAAC,eAAe;YAuDT,uBAAuB;YAwCvB,wBAAwB;IAsBtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAe5B;AA4CD;;GAEG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAMrB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/agent/swarm/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmEH,OAAO,KAAK,EAEX,WAAW,EAEX,iBAAiB,EACjB,UAAU,EAKV,MAAM,YAAY,CAAC;AA6WpB;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,cAAc,CAAgD;IACtE,OAAO,CAAC,oBAAoB,CACjB;IACX,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,eAAe,CAAkB;gBAE7B,MAAM,EAAE,WAAW;IAwC/B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAK/C;;OAEG;IACH,OAAO,CAAC,IAAI;IAmBZ;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,MAAM,IAAI,IAAI;YAoCA,mBAAmB;IAmCjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IA+FpC;;OAEG;YACW,WAAW;IAyCzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,oCAAoC;IA6B5C;;OAEG;YACW,gBAAgB;IAgE9B,OAAO,CAAC,mBAAmB;IAgD3B,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,gBAAgB;YAyDV,uBAAuB;YAgCvB,yCAAyC;YAqFzC,6BAA6B;IAwC3C,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,wBAAwB;YAQlB,aAAa;YAwVb,gBAAgB;IAmM9B,OAAO,CAAC,4BAA4B;IAmDpC,OAAO,CAAC,4BAA4B;YAuEtB,mBAAmB;IA+BjC,OAAO,CAAC,mBAAmB;IA8D3B,OAAO,CAAC,eAAe;YAuDT,uBAAuB;YAyCvB,wBAAwB;IAsBtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAe5B;AA4CD;;GAEG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/agent/swarm/executor.js

@@ -11,7 +11,7 @@ import { unlinkSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { formatDelegation } from "@evalops/contracts";
-import { codexSubagentTypeA2ASkillID } from "../../codex/subagent-dispatch-table.js";
+import { codexSubagentSkillToken, codexSubagentTypeA2ASkillID, } from "../../codex/subagent-dispatch-table.js";
 import { buildEvalOpsDelegationEnvironment, issueEvalOpsDelegationToken, } from "../../oauth/index.js";
 import { rankA2ACapabilityPeers } from "../../platform/a2a-capability-market.js";
 import { buildA2AUserMessage, cancelA2ATask, getA2ATask, normalizeA2ABaseUrl, resolveA2AServiceConfig, sendA2AMessage, } from "../../platform/a2a-client.js";
@@ -23,8 +23,13 @@ import { getEnvValue, trimString } from "../../platform/client.js";
 import { recordA2ADelegationTelemetry as recordA2ADelegationTelemetryEvent, recordSubagentDispatch, } from "../../telemetry.js";
 import { createLogger } from "../../utils/logger.js";
 import { sanitizeWithStaticMask } from "../../utils/secret-redactor.js";
+import { detectMissionSessionRole } from "../mission-artifacts.js";
 import { parseMode, resolveSubagentDispatch, } from "../modes.js";
+import { applySpecialistProfileToPrompt, resolveSpecialistProfile, } from "../specialist-profiles.js";
+import { parseSubagentType } from "../subagent-specs.js";
+import { evaluateSwarmCoverageGate } from "./coverage-gate.js";
 import { publishSwarmRuntimeEvent } from "./runtime-events.js";
+import { buildSwarmValidationDirective } from "./validation-directive.js";
 const logger = createLogger("agent:swarm:executor");
 /** Default timeout per task (5 minutes) */
 const DEFAULT_TASK_TIMEOUT_MS = 5 * 60 * 1000;
@@ -41,6 +46,7 @@ const A2A_SKILL_PRIMARY_TASK_CLASSES = new Map([
     ["maestro.subagent.code-writer", "code.implementation"],
     ["maestro.subagent.code-review", "code.review"],
     ["maestro.subagent.test-runner", "test.execution"],
+    ["maestro.subagent.browser-qa", "product.qa"],
     ["maestro.subagent.repo-explorer", "repo.inspect"],
     ["maestro.subagent.release-shepherd", "release.follow-through"],
 ]);
@@ -57,10 +63,18 @@ const SWARM_SUBAGENT_TASK_CLASSES = new Map([
     ["test", "test.execution"],
     ["ci", "test.execution"],
     ["ci-monitor", "test.execution"],
+    ["test-runner", "test.execution"],
+    ["browser-qa", "product.qa"],
+    ["browser", "product.qa"],
+    ["dogfood", "product.qa"],
+    ["product-qa", "product.qa"],
+    ["e2e-qa", "browser.e2e"],
+    ["ux-qa", "ux.repro"],
     ["planner", "agent.delegation"],
     ["minimal", "agent.delegation"],
     ["custom", "agent.delegation"],
 ]);
+const A2A_SUBAGENT_TASK_CLASS_OVERRIDES = new Set(["e2e-qa", "ux-qa"]);
 /** Teammate name prefixes for friendly identification */
 const TEAMMATE_NAMES = [
     "Alpha",
@@ -141,6 +155,13 @@ function cloneConfig(config) {
             }
             : undefined,
         tasks: config.tasks.map(cloneTask),
+        validationContract: config.validationContract
+            ? structuredClone(config.validationContract)
+            : undefined,
+        featureClaims: config.featureClaims?.map((claim) => ({
+            ...claim,
+            fulfills: [...claim.fulfills],
+        })),
     };
 }
 function cloneState(state) {
@@ -280,6 +301,9 @@ function buildDispatchEnv(dispatch, reasoningEffortOverride, runtimeSelection) {
     }
     return env;
 }
+function resolveMissionRoleForTeammate() {
+    return detectMissionSessionRole() === "validator" ? "validator" : "worker";
+}
 /**
  * SwarmExecutor manages a swarm of parallel agent instances.
  */
@@ -421,6 +445,30 @@ export class SwarmExecutor {
      * Execute the swarm - runs all tasks with available teammates.
      */
     async execute() {
+        // Pre-dispatch coverage gate: refuse to start when a validation contract
+        // is configured but its assertions are not fully covered by feature
+        // claims. No-ops when no contract is configured.
+        const coverage = evaluateSwarmCoverageGate({
+            validationContract: this.state.config.validationContract,
+            featureClaims: this.state.config.featureClaims,
+        });
+        if (!coverage.ok) {
+            const error = coverage.message ?? "Swarm coverage gate failed";
+            this.state.status = "failed";
+            this.state.error = error;
+            this.state.completedAt = Date.now();
+            this.emit({
+                type: "swarm_fail",
+                swarmId: this.state.id,
+                error,
+            });
+            this.emit({
+                type: "swarm_complete",
+                swarmId: this.state.id,
+                state: cloneState(this.state),
+            });
+            return cloneState(this.state);
+        }
         this.state.status = "running";
         this.emit({
             type: "swarm_start",
@@ -554,9 +602,11 @@ export class SwarmExecutor {
     async buildTeammateEnv(teammate, task, dispatch, runtimeSelection) {
         const baseEnv = {
             ...process.env,
+            MAESTRO_MISSION_WORKER: "1",
             MAESTRO_SWARM_MODE: "1",
             MAESTRO_SWARM_ID: this.state.id,
             MAESTRO_TEAMMATE_ID: teammate.id,
+            MAESTRO_MISSION_ROLE: resolveMissionRoleForTeammate(),
             ...buildDispatchEnv(dispatch, this.state.config.reasoningEffort, runtimeSelection),
         };
         try {
@@ -591,7 +641,11 @@ export class SwarmExecutor {
     }
     resolveTaskDispatch(task, teammate, options = {}) {
         const startedAt = Date.now();
-        const subagentType = task.subagentType ?? this.state.config.subagentType;
+        const requestedSubagentType = task.subagentType ?? this.state.config.subagentType;
+        if (!requestedSubagentType) {
+            return null;
+        }
+        const subagentType = parseSubagentType(requestedSubagentType);
         if (!subagentType) {
             return null;
         }
@@ -706,7 +760,7 @@ export class SwarmExecutor {
             config: peer.config,
             skillId,
             taskClass: this.resolveA2ATaskClass(task, options, skillId),
-            role: options.role ?? task.subagentType,
+            role: this.resolveA2ARole(task, options),
             tasksPath: options.tasksPath,
             peerEndpointHash: hashA2AEndpointUrlForTelemetry(peer.config.baseUrl),
             source: "registry",
@@ -769,7 +823,7 @@ export class SwarmExecutor {
             config,
             skillId: selectedSkillId,
             taskClass: this.resolveA2ATaskClass(task, options, selectedSkillId),
-            role: options.role ?? task.subagentType,
+            role: this.resolveA2ARole(task, options),
             tasksPath: options.tasksPath,
             peerAgentId: candidate.agent.id,
             peerEndpointHash: endpointHash,
@@ -829,20 +883,44 @@ export class SwarmExecutor {
         return peer?.entry.skills?.[0]?.id;
     }
     resolveA2ATaskClass(task, options, skillId) {
+        const explicitSkill = trimString(task.a2aSkillId) ?? trimString(options.skillId);
+        const requestedSubagentType = trimString(task.subagentType ?? this.state.config.subagentType);
+        const normalizedRequestedSubagentType = codexSubagentSkillToken(requestedSubagentType);
+        const parsedSubagentType = requestedSubagentType
+            ? parseSubagentType(requestedSubagentType)
+            : undefined;
+        const subagentType = parsedSubagentType ?? normalizedRequestedSubagentType;
+        const mappedSubagentTaskClass = normalizedRequestedSubagentType
+            ? (SWARM_SUBAGENT_TASK_CLASSES.get(normalizedRequestedSubagentType) ??
+                (parsedSubagentType
+                    ? SWARM_SUBAGENT_TASK_CLASSES.get(parsedSubagentType)
+                    : undefined))
+            : undefined;
+        if (mappedSubagentTaskClass &&
+            normalizedRequestedSubagentType &&
+            A2A_SUBAGENT_TASK_CLASS_OVERRIDES.has(normalizedRequestedSubagentType)) {
+            return mappedSubagentTaskClass;
+        }
         const mappedSkillTaskClass = skillId
             ? A2A_SKILL_PRIMARY_TASK_CLASSES.get(skillId)
             : undefined;
         if (mappedSkillTaskClass) {
             return mappedSkillTaskClass;
         }
-        if (skillId &&
-            (trimString(task.a2aSkillId) || trimString(options.skillId))) {
+        if (skillId && explicitSkill) {
             return undefined;
         }
-        const subagentType = trimString(task.subagentType ?? this.state.config.subagentType);
-        return ((subagentType
-            ? SWARM_SUBAGENT_TASK_CLASSES.get(subagentType)
-            : undefined) ?? subagentType);
+        return mappedSubagentTaskClass ?? subagentType ?? requestedSubagentType;
+    }
+    resolveA2ARole(task, options) {
+        const configuredRole = trimString(options.role);
+        if (configuredRole) {
+            return parseSubagentType(configuredRole) ?? configuredRole;
+        }
+        const requestedSubagentType = trimString(task.subagentType ?? this.state.config.subagentType);
+        return requestedSubagentType
+            ? (parseSubagentType(requestedSubagentType) ?? requestedSubagentType)
+            : undefined;
     }
     teammateIndex(teammate) {
         const index = this.state.teammates.findIndex((item) => item.id === teammate.id);
@@ -858,18 +936,64 @@ export class SwarmExecutor {
     }
     async spawnTeammate(teammate, task) {
         const tmpFile = join(tmpdir(), `${this.state.id}-${toSafeTaskTempBasename(task.id)}`);
+        const specialistProfile = task.specialistProfile
+            ? resolveSpecialistProfile(task.specialistProfile, this.state.config.cwd)
+            : null;
+        if (task.specialistProfile && !specialistProfile) {
+            throw new Error(`specialist profile not found or invalid: ${task.specialistProfile}`);
+        }
         const delegationPrompt = {
             goal: `Complete swarm task ${task.id} as teammate "${teammate.name}".`,
             context: `You are teammate "${teammate.name}" in swarm ${this.state.id}, working from plan file ${this.state.config.planFile}.`,
-            task: task.prompt,
+            task: applySpecialistProfileToPrompt(task.prompt, specialistProfile),
             evidence: task.files?.length
                 ? task.files.map((file) => `Relevant file: ${file}`)
                 : [],
-            validation: "Make the requested changes directly, add or update focused tests when behavior changes, and run the relevant verification before finishing.",
+            validation: buildSwarmValidationDirective(task.mocksAllowed),
             stoppingCondition: "Stop when the assigned task is complete and report what changed, what you verified, and any blockers. Do not broaden into unrelated tasks.",
         };
         const prompt = formatDelegation(delegationPrompt);
+        const requestedSubagentType = task.subagentType ?? this.state.config.subagentType;
         writeFileSync(tmpFile, prompt);
+        if (requestedSubagentType && !parseSubagentType(requestedSubagentType)) {
+            try {
+                unlinkSync(tmpFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            const error = `Invalid subagent type: ${requestedSubagentType}`;
+            this.state.activeTasks.delete(task.id);
+            this.state.failedTasks.add(task.id);
+            if (!this.state.config.continueOnFailure) {
+                this.state.status = "failed";
+            }
+            teammate.status = "failed";
+            teammate.error = error;
+            teammate.completedAt = Date.now();
+            teammate.currentTask = undefined;
+            this.emit({
+                type: "task_fail",
+                swarmId: this.state.id,
+                teammateId: teammate.id,
+                taskId: task.id,
+                error,
+            });
+            this.emit({
+                type: "teammate_complete",
+                swarmId: this.state.id,
+                teammate,
+            });
+            if (this.state.status === "running" &&
+                (this.state.pendingTasks.length > 0 ||
+                    this.state.activeTasks.size > 0) &&
+                this.state.config.continueOnFailure) {
+                teammate.status = "pending";
+                teammate.error = undefined;
+                teammate.completedAt = undefined;
+            }
+            return;
+        }
         const a2aConfig = this.resolveA2AConfig();
         if (a2aConfig) {
             void this.spawnA2ATeammate(teammate, task, prompt, tmpFile, a2aConfig);
@@ -1153,7 +1277,7 @@ export class SwarmExecutor {
                 route,
                 taskId: sent.task.id,
             });
-            await this.recordA2ASwarmTaskStart(route, task, sent.task, {
+            await this.recordA2ASwarmTaskStart(route, task, sent.task, prompt, {
                 messageId,
                 contextId,
             });
@@ -1273,6 +1397,7 @@ export class SwarmExecutor {
         });
     }
     buildA2ASwarmMessageMetadata(teammate, task, route) {
+        const missionRole = resolveMissionRoleForTeammate();
         const currentDelegationId = `${this.state.id}:${task.id}`;
         const contextId = `maestro-swarm:${this.state.id}:${task.id}`;
         const lineage = {
@@ -1292,6 +1417,8 @@ export class SwarmExecutor {
                 cwd: this.state.config.cwd,
                 taskId: task.id,
                 swarmId: this.state.id,
+                missionRole,
+                env: { MAESTRO_MISSION_ROLE: missionRole },
             }
             : undefined;
         const peerControl = {
@@ -1303,6 +1430,11 @@ export class SwarmExecutor {
             controlModes: ["followup", "steer", "interrupt", "cancel"],
             evidenceRequired: ["status", "artifact", "task", "workGraph"],
         };
+        const validationPolicy = {
+            schema: "evalops.maestro.swarm-validation-policy.v1",
+            mocksAllowed: task.mocksAllowed === true,
+            mode: task.mocksAllowed === true ? "mocks-allowed" : "real-integrations",
+        };
         return {
             requestKind: "maestro-swarm-task",
             transport: "a2a",
@@ -1311,6 +1443,8 @@ export class SwarmExecutor {
             teammateId: teammate.id,
             teammateName: teammate.name,
             taskId: task.id,
+            missionRole,
+            validation: validationPolicy,
             ...(route.skillId ? { a2aSkillId: route.skillId } : {}),
             ...(task.files?.length ? { files: task.files } : {}),
             swarm: lineage,
@@ -1319,8 +1453,10 @@ export class SwarmExecutor {
                 transport: "a2a",
                 peer: route.name,
                 peerControl,
+                validation: validationPolicy,
             },
             "evalops.peerControl": peerControl,
+            "evalops.validation": validationPolicy,
             ...(subagentRequest
                 ? { "evalops.subagentRequest": subagentRequest }
                 : {}),
@@ -1445,14 +1581,14 @@ export class SwarmExecutor {
             teammate.a2a = undefined;
         }
     }
-    async recordA2ASwarmTaskStart(route, task, remoteTask, ids) {
+    async recordA2ASwarmTaskStart(route, task, remoteTask, delegatedPrompt, ids) {
         try {
             await recordA2ATaskStart({
                 path: route.tasksPath,
                 peer: route.name,
                 peerDisplayName: route.displayName,
                 task: remoteTask,
-                text: task.prompt,
+                text: delegatedPrompt,
                 messageId: ids.messageId,
                 contextId: remoteTask.contextId ?? ids.contextId,
                 kind: "delegation",