Function parseAgentFileTools

packages/config-yaml/src/markdown/agentFiles.ts:102–204

(toolsString?: string)

 * @returns Parsed tools configuration
 */
export function parseAgentFileTools(toolsString?: string): ParsedAgentTools {
  if (!toolsString?.trim()) {
    return { tools: [], mcpServers: [], allBuiltIn: false };
  }

  const tools: AgentToolReference[] = [];
  const mcpServerSet = new Set<string>();
  let allBuiltIn = false;

  const toolRefs = toolsString
    .split(",")
    .map((t) => t.trim())
    .filter(Boolean);

  for (const toolRef of toolRefs) {
    if (toolRef === "built_in") {
      // Special keyword for all built-in tools
      allBuiltIn = true;
    } else if (
      toolRef.startsWith("http://") ||
      toolRef.startsWith("https://")
    ) {
      // URL-based MCP tool reference: "https://mcp.url.com" or "https://mcp.url.com:tool_name"
      const protocolEndIndex = toolRef.indexOf("://") + 3;
      const lastColonIndex = toolRef.lastIndexOf(":");

      // Check if there's a colon after the protocol
      if (lastColonIndex > protocolEndIndex) {
        const afterLastColon = toolRef.substring(lastColonIndex + 1);

        // Check if it's a port number (only digits), empty string, or a tool name
        if (/^\d+(?:$|[/?#])/.test(afterLastColon)) {
          // It's a port number, treat the whole thing as the server
          const mcpServer = toolRef;
          tools.push({ mcpServer });
          mcpServerSet.add(mcpServer);
        } else if (
          afterLastColon === "" ||
          /^[a-zA-Z0-9_-]+$/.test(afterLastColon)
        ) {
          // It's a tool name (or empty string)
          // Reject references with whitespace to prevent silent misconfigurations
          if (/\s/.test(toolRef)) {
            throw new Error(
              `Invalid MCP tool reference "${toolRef}": colon-separated tool references cannot contain whitespace. ` +
                `Use format "https://server:tool_name" without spaces.`,
            );
          }

          const mcpServer = toolRef.substring(0, lastColonIndex);
          const toolName = afterLastColon;

          tools.push({ mcpServer, toolName });
          mcpServerSet.add(mcpServer);
        } else {
          throw new Error(
            `Invalid URL-based MCP tool reference "${toolRef}": the part after the last colon must be either a port number or a valid tool name (alphanumeric, underscores, hyphens).`,
          );