@evalops/maestro 0.10.50 → 0.10.53

package/dist/agent/subagent-specs.d.ts

@@ -8,13 +8,14 @@
  * - coder: Full coding capabilities
  * - reviewer: Read-only with web access for reviewing code
  * - researcher: Web search and fetch focused
+ * - browser-qa: Browser-based product QA with screenshots and repro evidence
  *
  * Inspired by Amp's subagentSpec/subagentType system.
  */
 /**
  * Available subagent types.
  */
-export type SubagentType = "explorer" | "planner" | "coder" | "reviewer" | "researcher" | "minimal" | "custom";
+export type SubagentType = "explorer" | "planner" | "coder" | "reviewer" | "test-runner" | "researcher" | "browser-qa" | "minimal" | "custom";
 /**
  * Tool categories for easier specification.
  */
@@ -27,12 +28,14 @@ export declare const TOOL_CATEGORIES: {
     readonly shell: readonly ["bash", "background_tasks"];
     /** Web and external tools */
     readonly web: readonly ["websearch", "webfetch", "codesearch"];
+    /** Browser/product QA tools */
+    readonly browser: readonly ["agent_browser", "browser_open", "browser_snapshot", "browser_click", "browser_fill", "browser_type", "browser_screenshot", "browser_console", "browser_record", "read_page", "search_page", "find_on_page", "extract_links", "wait_for_selector", "click_element", "type_text", "scroll_page", "select_element", "navigate_to", "open_links_in_tabs", "highlight_element", "browser_operator", "mouse_action", "pointer_action", "keyboard_action", "extract_table_data", "capture_network", "capture_console_errors", "collect_diagnostics", "extract_document", "capture_screenshot", "native_click", "native_type", "native_press", "native_key_down", "native_key_up"];
     /** Interactive tools */
     readonly interactive: readonly ["ask_user", "todo"];
     /** GitHub tools */
     readonly github: readonly ["gh_pr", "gh_issue", "gh_repo"];
     /** Advanced tools */
-    readonly advanced: readonly ["oracle"];
+    readonly advanced: readonly ["oracle", "painter"];
 };
 /**
  * Subagent specification defining capabilities.

package/dist/agent/subagent-specs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-specs.d.ts","sourceRoot":"","sources":["../../src/agent/subagent-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,eAAe;IAC3B,kCAAkC;;IAUlC,8BAA8B;;IAE9B,sBAAsB;;IAEtB,6BAA6B;;IAE7B,wBAAwB;;IAExB,mBAAmB;;IAEnB,qBAAqB;;CAEZ,CAAC;AAeX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,CA6E7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,OAAO,CAeT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,MAAM,EAAE,CAgBV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChE,KAAK,EAAE,CAAC,EAAE,EACV,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,CAAC,EAAE,CAOL;AAOD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAMrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC,CAOD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAOd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAYlE"}
+{"version":3,"file":"subagent-specs.d.ts","sourceRoot":"","sources":["../../src/agent/subagent-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,GACV,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,QAAQ,CAAC;AAWZ;;GAEG;AACH,eAAO,MAAM,eAAe;IAC3B,kCAAkC;;IAUlC,8BAA8B;;IAE9B,sBAAsB;;IAEtB,6BAA6B;;IAE7B,+BAA+B;;IAuC/B,wBAAwB;;IAExB,mBAAmB;;IAEnB,qBAAqB;;CAEZ,CAAC;AAeX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,CAwG7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,OAAO,CAeT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,MAAM,EAAE,CAgBV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChE,KAAK,EAAE,CAAC,EAAE,EACV,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,CAAC,EAAE,CAOL;AAOD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC,CAOD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAOd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAYlE"}

package/dist/agent/subagent-specs.js

@@ -8,12 +8,22 @@
  * - coder: Full coding capabilities
  * - reviewer: Read-only with web access for reviewing code
  * - researcher: Web search and fetch focused
+ * - browser-qa: Browser-based product QA with screenshots and repro evidence
  *
  * Inspired by Amp's subagentSpec/subagentType system.
  */
+import { codexSubagentLaneForType } from "../codex/subagent-dispatch-table.js";
 import { createLogger } from "../utils/logger.js";
 import { normalizeToolNameForSafety } from "../utils/safety-normalization.js";
 const logger = createLogger("agent:subagent-specs");
+const CODEX_LANE_SUBAGENT_TYPES = {
+    "code-writer": "coder",
+    "code-review": "reviewer",
+    "test-runner": "test-runner",
+    "browser-qa": "browser-qa",
+    "repo-explorer": "explorer",
+    "release-shepherd": "coder",
+};
 /**
  * Tool categories for easier specification.
  */
@@ -34,12 +44,51 @@ export const TOOL_CATEGORIES = {
     shell: ["bash", "background_tasks"],
     /** Web and external tools */
     web: ["websearch", "webfetch", "codesearch"],
+    /** Browser/product QA tools */
+    browser: [
+        "agent_browser",
+        "browser_open",
+        "browser_snapshot",
+        "browser_click",
+        "browser_fill",
+        "browser_type",
+        "browser_screenshot",
+        "browser_console",
+        "browser_record",
+        "read_page",
+        "search_page",
+        "find_on_page",
+        "extract_links",
+        "wait_for_selector",
+        "click_element",
+        "type_text",
+        "scroll_page",
+        "select_element",
+        "navigate_to",
+        "open_links_in_tabs",
+        "highlight_element",
+        "browser_operator",
+        "mouse_action",
+        "pointer_action",
+        "keyboard_action",
+        "extract_table_data",
+        "capture_network",
+        "capture_console_errors",
+        "collect_diagnostics",
+        "extract_document",
+        "capture_screenshot",
+        "native_click",
+        "native_type",
+        "native_press",
+        "native_key_down",
+        "native_key_up",
+    ],
     /** Interactive tools */
     interactive: ["ask_user", "todo"],
     /** GitHub tools */
     github: ["gh_pr", "gh_issue", "gh_repo"],
     /** Advanced tools */
-    advanced: ["oracle"],
+    advanced: ["oracle", "painter"],
 };
 /**
  * Get all tool names from categories.
@@ -59,7 +108,7 @@ export const SUBAGENT_SPECS = {
         displayName: "Explorer",
         description: "Read-only codebase exploration - can search and read files",
         allowedTools: toolsFromCategories("read", "advanced"),
-        deniedTools: ["oracle"], // Explorers shouldn't invoke oracle
+        deniedTools: ["oracle", "painter"], // Explorers are read-only; no reasoning subagents or image generation
         allowMcp: false,
         allowToolbox: false,
         maxToolCallsPerTurn: 20,
@@ -92,6 +141,18 @@ export const SUBAGENT_SPECS = {
         maxToolCallsPerTurn: 15,
         requireConfirmation: false,
     },
+    "test-runner": {
+        displayName: "Test Runner",
+        description: "Test execution mode - can run checks and inspect results",
+        allowedTools: [
+            ...toolsFromCategories("read", "shell", "interactive"),
+            "webfetch",
+        ],
+        allowMcp: false,
+        allowToolbox: false,
+        maxToolCallsPerTurn: 20,
+        requireConfirmation: false,
+    },
     researcher: {
         displayName: "Researcher",
         description: "Research mode - focused on web search and analysis",
@@ -101,6 +162,20 @@ export const SUBAGENT_SPECS = {
         maxToolCallsPerTurn: 20,
         requireConfirmation: false,
     },
+    "browser-qa": {
+        displayName: "Browser QA",
+        description: "Product QA mode - explores web surfaces and captures repro evidence",
+        allowedTools: [
+            ...toolsFromCategories("read", "web", "browser"),
+            "bash",
+            "ask_user",
+            "todo",
+        ],
+        allowMcp: true,
+        allowToolbox: true,
+        maxToolCallsPerTurn: 25,
+        requireConfirmation: false,
+    },
     minimal: {
         displayName: "Minimal",
         description: "Minimal capabilities - only basic read operations",
@@ -189,20 +264,18 @@ export function setCurrentSubagentType(type) {
  */
 export function parseSubagentType(typeStr) {
     const normalized = normalizeToolNameForSafety(typeStr);
-    if (normalized in SUBAGENT_SPECS) {
-        return normalized;
+    const hyphenated = normalized.replace(/_/g, "-");
+    if (hyphenated in SUBAGENT_SPECS) {
+        return hyphenated;
     }
-    return null;
+    const lane = codexSubagentLaneForType(typeStr);
+    return lane ? (CODEX_LANE_SUBAGENT_TYPES[lane.laneId] ?? null) : null;
 }
 /**
  * Get subagent type from environment variable.
  */
 export function getSubagentTypeFromEnv() {
-    const envType = process.env.MAESTRO_SUBAGENT_TYPE?.toLowerCase();
-    if (envType && envType in SUBAGENT_SPECS) {
-        return envType;
-    }
-    return "coder";
+    return parseSubagentType(process.env.MAESTRO_SUBAGENT_TYPE ?? "") ?? "coder";
 }
 /**
  * Format subagent type for display.

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":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAE9E,MAAM,MAAM,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;AAgBpD,MAAM,yBAAyB,GAAiC;IAC/D,aAAa,EAAE,OAAO;IACtB,aAAa,EAAE,UAAU;IACzB,aAAa,EAAE,aAAa;IAC5B,YAAY,EAAE,YAAY;IAC1B,eAAe,EAAE,UAAU;IAC3B,kBAAkB,EAAE,OAAO;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,kCAAkC;IAClC,IAAI,EAAE;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,QAAQ;QACR,kBAAkB;QAClB,MAAM;QACN,QAAQ;KACR;IACD,8BAA8B;IAC9B,KAAK,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC;IACxD,sBAAsB;IACtB,KAAK,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACnC,6BAA6B;IAC7B,GAAG,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,CAAC;IAC5C,+BAA+B;IAC/B,OAAO,EAAE;QACR,eAAe;QACf,cAAc;QACd,kBAAkB;QAClB,eAAe;QACf,cAAc;QACd,cAAc;QACd,oBAAoB;QACpB,iBAAiB;QACjB,gBAAgB;QAChB,WAAW;QACX,aAAa;QACb,cAAc;QACd,eAAe;QACf,mBAAmB;QACnB,eAAe;QACf,WAAW;QACX,aAAa;QACb,gBAAgB;QAChB,aAAa;QACb,oBAAoB;QACpB,mBAAmB;QACnB,kBAAkB;QAClB,cAAc;QACd,gBAAgB;QAChB,iBAAiB;QACjB,oBAAoB;QACpB,iBAAiB;QACjB,wBAAwB;QACxB,qBAAqB;QACrB,kBAAkB;QAClB,oBAAoB;QACpB,cAAc;QACd,aAAa;QACb,cAAc;QACd,iBAAiB;QACjB,eAAe;KACf;IACD,wBAAwB;IACxB,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;IACjC,mBAAmB;IACnB,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC;IACxC,qBAAqB;IACrB,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;CACtB,CAAC;AAEX;;GAEG;AACH,SAAS,mBAAmB,CAC3B,GAAG,UAA4C;IAE/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5B,CAAC;AAwBD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAuC;IACjE,QAAQ,EAAE;QACT,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,4DAA4D;QACzE,YAAY,EAAE,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC;QACrD,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,sEAAsE;QAC1G,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,KAAK;KAC1B;IACD,OAAO,EAAE;QACR,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,iDAAiD;QAC9D,YAAY,EAAE,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC7D,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,KAAK;KAC1B;IACD,KAAK,EAAE;QACN,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,yDAAyD;QACtE,YAAY,EAAE,mBAAmB,CAChC,MAAM,EACN,OAAO,EACP,OAAO,EACP,aAAa,EACb,QAAQ,EACR,UAAU,CACV;QACD,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,IAAI;KACzB;IACD,QAAQ,EAAE;QACT,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,kDAAkD;QAC/D,YAAY,EAAE,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC;QACjE,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,KAAK;KAC1B;IACD,aAAa,EAAE;QACd,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,0DAA0D;QACvE,YAAY,EAAE;YACb,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC;YACtD,UAAU;SACV;QACD,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,KAAK;KAC1B;IACD,UAAU,EAAE;QACX,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,oDAAoD;QACjE,YAAY,EAAE,CAAC,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC;QACzE,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,KAAK;KAC1B;IACD,YAAY,EAAE;QACb,WAAW,EAAE,YAAY;QACzB,WAAW,EACV,qEAAqE;QACtE,YAAY,EAAE;YACb,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC;YAChD,MAAM;YACN,UAAU;YACV,MAAM;SACN;QACD,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,KAAK;KAC1B;IACD,OAAO,EAAE;QACR,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,mDAAmD;QAChE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QACxC,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,EAAE;QACvB,mBAAmB,EAAE,KAAK;KAC1B;IACD,MAAM,EAAE;QACP,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,iCAAiC;QAC9C,YAAY,EAAE,mBAAmB,CAChC,MAAM,EACN,OAAO,EACP,OAAO,EACP,aAAa,EACb,UAAU,CACV;QACD,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,IAAI;KACzB;CACD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IACjD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,QAAgB,EAChB,IAAkB,EAClB,UAAkC;IAElC,MAAM,IAAI,GAAG,UAAU;QACtB,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE;QAC5C,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACxB,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC;IAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAEvE,+BAA+B;IAC/B,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,OAAO,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,IAAkB,EAClB,UAAkC;IAElC,MAAM,IAAI,GAAG,UAAU;QACtB,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE;QAC5C,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAExB,IAAI,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAE9D,sBAAsB;IACtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,IAAI,GAAG,CAC1B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAChD,CAAC;QACF,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,KAAU,EACV,IAAkB,EAClB,UAAkC;IAElC,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEvD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,IAAI,mBAAmB,GAAiB,OAAO,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACrC,OAAO,mBAAmB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAkB;IACxD,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,mBAAmB,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAChD,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjD,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;QAClC,OAAO,UAA0B,CAAC;IACnC,CAAC;IACD,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACrC,OAAO,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACvD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,GAAG,IAAI,CAAC,WAAW,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IAIlC,OAAQ,MAAM,CAAC,OAAO,CAAC,cAAc,CAAoC,CAAC,GAAG,CAC5E,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAClB,IAAI;QACJ,IAAI;KACJ,CAAC,CACF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,QAAsB,EACtB,SAAgC;IAEhC,OAAO;QACN,GAAG,cAAc,CAAC,QAAQ,CAAC;QAC3B,GAAG,SAAS;QACZ,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,QAAQ;QAC9C,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,sBAAsB;KAC5D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAA2B;IACvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,IAAI,CAAC,mBAAmB,KAAK,SAAS,IAAI,IAAI,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC","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\", \"painter\"],\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\", \"painter\"], // Explorers are read-only; no reasoning subagents or image generation\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"}