@evalops/maestro 0.10.18 → 0.10.21

package/dist/agent/scenario-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-source.js","sourceRoot":"","sources":["../../src/agent/scenario-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\n\nconst SCENARIO_SOURCE_MAX_BUFFER_BYTES = 64 * 1024 * 1024;\n\nexport interface ScenarioSourceExecFileOptions {\n\tencoding: \"utf8\";\n\tmaxBuffer: number;\n}\n\nexport type ScenarioSourceExecFile = (\n\tfile: string,\n\targs: string[],\n\toptions: ScenarioSourceExecFileOptions,\n) => Promise<{ stdout: string; stderr: string }>;\n\nexport interface ScenarioSourceReadOptions {\n\texecFile?: ScenarioSourceExecFile;\n\tfetch?: typeof fetch;\n}\n\nfunction isHttpScenarioSource(source: string): boolean {\n\treturn source.startsWith(\"http://\") || source.startsWith(\"https://\");\n}\n\nfunction isGcsScenarioSource(source: string): boolean {\n\treturn source.startsWith(\"gs://\");\n}\n\nexport function isRemoteScenarioSource(source: string): boolean {\n\treturn isHttpScenarioSource(source) || isGcsScenarioSource(source);\n}\n\nexport function scenarioSourceLabel(source: string): string {\n\tif (!isRemoteScenarioSource(source)) {\n\t\treturn source;\n\t}\n\ttry {\n\t\tconst url = new URL(source);\n\t\treturn `${url.protocol}//${url.host}${url.pathname}`;\n\t} catch {\n\t\treturn isGcsScenarioSource(source)\n\t\t\t? \"gs://scenario-fixture\"\n\t\t\t: \"remote-scenario-fixture\";\n\t}\n}\n\nexport function scenarioSourceBaseDir(source: string): string {\n\treturn isRemoteScenarioSource(source)\n\t\t? process.cwd()\n\t\t: dirname(resolve(source));\n}\n\nexport function readScenarioJsonSourceSync(source: string): unknown {\n\tif (isRemoteScenarioSource(source)) {\n\t\tthrow new Error(`Remote scenario source requires async loading: ${source}`);\n\t}\n\treturn JSON.parse(readFileSync(resolve(source), \"utf8\"));\n}\n\nfunction defaultExecFile(\n\tfile: string,\n\targs: string[],\n\toptions: ScenarioSourceExecFileOptions,\n): Promise<{ stdout: string; stderr: string }> {\n\treturn new Promise((resolvePromise, reject) => {\n\t\texecFile(file, args, options, (error, stdout, stderr) => {\n\t\t\tif (error) {\n\t\t\t\tObject.assign(error, { stdout, stderr });\n\t\t\t\treject(error);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tresolvePromise({ stdout, stderr });\n\t\t});\n\t});\n}\n\nfunction validateGcsScenarioSource(source: string): void {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(source);\n\t} catch (error) {\n\t\tthrow new Error(`Invalid GCS scenario source: ${source}`, {\n\t\t\tcause: error,\n\t\t});\n\t}\n\tif (\n\t\tparsed.protocol !== \"gs:\" ||\n\t\t!parsed.hostname ||\n\t\t!parsed.pathname ||\n\t\tparsed.pathname === \"/\"\n\t) {\n\t\tthrow new Error(\n\t\t\t`GCS scenario source must include a bucket and object path: ${source}`,\n\t\t);\n\t}\n}\n\nasync function readHttpScenarioSource(\n\tsource: string,\n\tfetchImpl: typeof fetch,\n): Promise<string> {\n\tconst label = scenarioSourceLabel(source);\n\tconst response = await fetchImpl(source, {\n\t\theaders: { Accept: \"application/json\" },\n\t});\n\tif (!response.ok) {\n\t\tconst status = [response.status, response.statusText]\n\t\t\t.filter(Boolean)\n\t\t\t.join(\" \");\n\t\tthrow new Error(`Failed to read scenario ${label}: HTTP ${status}`);\n\t}\n\treturn response.text();\n}\n\nasync function readGcsScenarioSource(\n\tsource: string,\n\texecFileImpl: ScenarioSourceExecFile,\n): Promise<string> {\n\tvalidateGcsScenarioSource(source);\n\ttry {\n\t\tconst { stdout } = await execFileImpl(\n\t\t\t\"gcloud\",\n\t\t\t[\"storage\", \"cat\", source],\n\t\t\t{ encoding: \"utf8\", maxBuffer: SCENARIO_SOURCE_MAX_BUFFER_BYTES },\n\t\t);\n\t\treturn stdout;\n\t} catch (error) {\n\t\tconst maybeError = error as NodeJS.ErrnoException & { stderr?: string };\n\t\tif (maybeError.code === \"ENOENT\") {\n\t\t\tthrow new Error(\n\t\t\t\t\"Reading gs:// scenario fixtures requires Google Cloud SDK (`gcloud`) on PATH, or use an HTTPS signed URL.\",\n\t\t\t\t{ cause: error },\n\t\t\t);\n\t\t}\n\t\tconst stderr = maybeError.stderr?.trim();\n\t\tthrow new Error(\n\t\t\t`Failed to read scenario ${source} with gcloud storage cat${stderr ? `: ${stderr}` : \"\"}`,\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\nexport async function readScenarioTextSource(\n\tsource: string,\n\toptions: ScenarioSourceReadOptions = {},\n): Promise<string> {\n\tif (isHttpScenarioSource(source)) {\n\t\tconst fetchImpl = options.fetch ?? globalThis.fetch;\n\t\tif (!fetchImpl) {\n\t\t\tthrow new Error(\n\t\t\t\t`Reading HTTP scenario fixtures requires fetch support: ${source}`,\n\t\t\t);\n\t\t}\n\t\treturn readHttpScenarioSource(source, fetchImpl);\n\t}\n\tif (isGcsScenarioSource(source)) {\n\t\treturn readGcsScenarioSource(source, options.execFile ?? defaultExecFile);\n\t}\n\treturn readFileSync(resolve(source), \"utf8\");\n}\n\nexport async function readScenarioJsonSource(\n\tsource: string,\n\toptions: ScenarioSourceReadOptions = {},\n): Promise<unknown> {\n\treturn JSON.parse(await readScenarioTextSource(source, options));\n}\n"]}

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

@@ -22,7 +22,7 @@ export declare const TOOL_CATEGORIES: {
     /** Read-only file system tools */
     readonly read: readonly ["read", "list", "find", "search", "parallel_ripgrep", "diff", "status"];
     /** File modification tools */
-    readonly write: readonly ["edit", "write", "notebook_edit"];
+    readonly write: readonly ["apply_patch", "edit", "write", "notebook_edit"];
     /** Shell execution */
     readonly shell: readonly ["bash", "background_tasks"];
     /** Web and external tools */

package/dist/agent/subagent-specs.js

@@ -28,7 +28,7 @@ export const TOOL_CATEGORIES = {
         "status",
     ],
     /** File modification tools */
-    write: ["edit", "write", "notebook_edit"],
+    write: ["apply_patch", "edit", "write", "notebook_edit"],
     /** Shell execution */
     shell: ["bash", "background_tasks"],
     /** Web and external tools */

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\";\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: [\"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\n\t// Denied tools take precedence\n\tif (spec.deniedTools?.includes(toolName)) {\n\t\treturn false;\n\t}\n\n\t// Check if in allowed list\n\treturn spec.allowedTools.includes(toolName);\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];\n\n\t// Remove denied tools\n\tif (spec.deniedTools) {\n\t\ttools = tools.filter((t) => !spec.deniedTools?.includes(t));\n\t}\n\n\treturn 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 = tool.name.toLowerCase().replace(/-/g, \"_\");\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 = typeStr.toLowerCase().trim();\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 *\n * Inspired by Amp's subagentSpec/subagentType system.\n */\n\nimport { createLogger } from \"../utils/logger.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\n\t// Denied tools take precedence\n\tif (spec.deniedTools?.includes(toolName)) {\n\t\treturn false;\n\t}\n\n\t// Check if in allowed list\n\treturn spec.allowedTools.includes(toolName);\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];\n\n\t// Remove denied tools\n\tif (spec.deniedTools) {\n\t\ttools = tools.filter((t) => !spec.deniedTools?.includes(t));\n\t}\n\n\treturn 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 = tool.name.toLowerCase().replace(/-/g, \"_\");\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 = typeStr.toLowerCase().trim();\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"]}

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

@@ -12,6 +12,8 @@ import type { SwarmConfig, SwarmEventHandler, SwarmState } from "./types.js";
 export declare class SwarmExecutor {
     private state;
     private processes;
+    private remoteA2ATasks;
+    private a2aRouteCursor;
     private eventHandlers;
     private abortController;
     constructor(config: SwarmConfig);
@@ -31,6 +33,7 @@ export declare class SwarmExecutor {
      * Cancel the swarm execution.
      */
     cancel(): void;
+    private cancelRemoteA2ATask;
     /**
      * Execute the swarm - runs all tasks with available teammates.
      */
@@ -43,11 +46,33 @@ export declare class SwarmExecutor {
      * Get the next task that can be executed (dependencies satisfied).
      */
     private getNextTask;
+    private skipTasksBlockedByFailedDependencies;
     /**
      * Spawn a subprocess agent for a teammate.
      */
     private buildTeammateEnv;
+    private resolveTaskDispatch;
+    private recordTaskDispatch;
+    private resolveParentMode;
+    private resolveParentModelProvider;
+    private resolveA2AConfig;
+    private resolveA2ATeammateRoute;
+    private resolvePlatformDiscoveredA2ATeammateRoute;
+    private a2aConfigForPlatformCandidate;
+    private selectA2APeerName;
+    private resolveA2ASkillId;
+    private resolveA2ATaskClass;
+    private teammateIndex;
+    private nextA2ARouteIndex;
+    private defaultA2ADiscoveryLimit;
     private spawnTeammate;
+    private spawnA2ATeammate;
+    private buildA2ASwarmMessageMetadata;
+    private waitForA2ASwarmTask;
+    private completeA2ATeammate;
+    private failA2ATeammate;
+    private recordA2ASwarmTaskStart;
+    private updateA2ASwarmTaskLedger;
     /**
      * Wait for any active task to complete.
      */

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;AAYH,OAAO,KAAK,EACX,WAAW,EAEX,iBAAiB,EACjB,UAAU,EAKV,MAAM,YAAY,CAAC;AAoEpB;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAwC;IACzD,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;IAaZ;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,MAAM,IAAI,IAAI;IA+Bd;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAoEpC;;OAEG;YACW,WAAW;IAyCzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;YACW,gBAAgB;YAmDhB,aAAa;IAqO3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAe5B;AAED;;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;AAkDH,OAAO,KAAK,EAEX,WAAW,EAEX,iBAAiB,EACjB,UAAU,EAKV,MAAM,YAAY,CAAC;AA4NpB;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,cAAc,CAAgD;IACtE,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;IAuBjC;;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;YAsDV,uBAAuB;YA6BvB,yCAAyC;YA8EzC,6BAA6B;IA2B3C,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;IAwF9B,OAAO,CAAC,4BAA4B;YA+CtB,mBAAmB;IA+BjC,OAAO,CAAC,mBAAmB;IA8D3B,OAAO,CAAC,eAAe;YAkDT,uBAAuB;YAsCvB,wBAAwB;IAoBtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAe5B;AAwCD;;GAEG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAMrB"}