Tools filter

[torresmateo]

This adds a docstring to get_arcade_tools that documents and implements the tools parameter so not everything in a toolkit is included.

[EricGustin]

@Spartee the get_arcade_tools does not behave the way that I would expect (irrespective of this current PR).

tools = await get_arcade_tools(
    client, 
    toolkits=["github"], 
    tools=["Google.ListEmails"]
)
# Expected: All github tools + list emails tool
# Actual: All github tools (list emails tool is missing)

Seems to me that we are missing a call to client.tools.formatted.get. i.e.,

for tool in tools:
    tool_format = await client.tools.formatted.get(
        name=tool, 
        format="openai"
    )
    tool_formats.append(tool_format)

This is how langchain-arcade and crewai-arcade behave at least.

[torresmateo]

@EricGustin Hmm... from the code here I thought the second parameter was a "filter" for the toolkit. I will implement the same behavior as in the other packages for consistency. It's a better DX that way. Making this a draft until I push that!

[sdserranog]

This is from the docs, but I’m not sure if we want to change it to match how we do it in other packages.

[torresmateo]

@sdserranog I think we should update the docs to follow changes in this PR, as the API will be consistent with how langchain-arcade and crewai-arcade behave.

I don't know which order is best to approve these PRs though.

[torresmateo]

@sdserranog On this commit I addressed all of the comments from the other PR.

[sdserranog]

I'll go ahead and approve this since the core functionality is working well. We'll still need to clean up/fix the documentation, but we can handle that in a follow-up PR