b6b4cd0a4c
### Overview Major restructuring from monolithic `arcade-ai` package to modular library architecture with standardized uv-based dependency management.  ### New Package Structure - **`arcade-tdk`** - Lightweight toolkit development kit (core decorators, auth) - **`arcade-core`** - Core execution engine and catalog functionality - **`arcade-serve`** - FastAPI/MCP server components - **`arcade-ai`** - Meta package that includes CLI functionality. Optionally include evals via the `evals` extra. Optionally include all packages via the `all` extra. ### Key Benefits - **Lighter Dependencies**: Toolkits now depend only on `arcade-tdk` (~2 deps) vs full `arcade-ai` (~30+ deps) - **Faster Builds**: uv provides 10-100x faster dependency resolution and installation - **Better Modularity**: Clear separation of concerns, consumers import only what they need - **Standard Tooling**: Eliminates custom poetry scripts, uses standard Python packaging ### Migration Impact - All 20 toolkits converted from poetry → uv with `arcade-tdk` dependencies plus `arcade-ai[evals]` and `arcade-serve` dev dependencies. When developing locally, devs should install toolkits via `make install-local`. - Modern Python 3.10+ type hints throughout - Standardized build system with hatchling backend - Enhanced Makefile with robust toolkit management commands - Removed `arcade dev` CLI command - Reduce the number of files created by `arcade new` and add an option to not generate a tests and evals folder. This foundation enables faster development cycles and cleaner dependency chains for the growing toolkit ecosystem. ### Todo After this PR is merged - [ ] Post-merge workflow(s) (release & publish containers, etc) - [ ] Release order plan. @EricGustin suggests releasing in the following order: 1. `arcade-core` version 0.1.0 2. `arcade-serve` version 0.1.0 and `arcade-tdk` version 0.1.0 3. `arcade-ai` version 2.0.0 4. Patch release for all toolkits (all changes in toolkits are internal refactors) - [ ] [Update docs](https://github.com/ArcadeAI/docs/pull/318) --------- Co-authored-by: Eric Gustin <eric@arcade.dev> Co-authored-by: Eric Gustin <34000337+EricGustin@users.noreply.github.com>
94 lines
3.3 KiB
Python
94 lines
3.3 KiB
Python
from typing import Annotated
|
|
|
|
from arcade_tdk import ToolContext, tool
|
|
from arcade_tdk.auth import Microsoft
|
|
from msgraph.generated.users.item.send_mail.send_mail_post_request_body import (
|
|
SendMailPostRequestBody,
|
|
)
|
|
|
|
from arcade_microsoft.client import get_client
|
|
from arcade_microsoft.outlook_mail._utils import send_reply_email
|
|
from arcade_microsoft.outlook_mail.enums import ReplyType
|
|
from arcade_microsoft.outlook_mail.message import Message, Recipient
|
|
|
|
|
|
@tool(requires_auth=Microsoft(scopes=["Mail.Send"]))
|
|
async def create_and_send_email(
|
|
context: ToolContext,
|
|
subject: Annotated[str, "The subject of the email to create"],
|
|
body: Annotated[str, "The body of the email to create"],
|
|
to_recipients: Annotated[
|
|
list[str], "The email addresses that will be the recipients of the email"
|
|
],
|
|
cc_recipients: Annotated[
|
|
list[str] | None, "The email addresses that will be the CC recipients of the email."
|
|
] = None,
|
|
bcc_recipients: Annotated[
|
|
list[str] | None,
|
|
"The email addresses that will be the BCC recipients of the email.",
|
|
] = None,
|
|
) -> Annotated[dict, "A dictionary containing the created email details"]:
|
|
"""Create and immediately send a new email in Outlook to the specified recipients"""
|
|
client = get_client(context.get_auth_token_or_empty())
|
|
message = Message(
|
|
subject=subject,
|
|
body=body,
|
|
to_recipients=[Recipient(email_address=email) for email in to_recipients],
|
|
cc_recipients=[Recipient(email_address=email) for email in cc_recipients or []],
|
|
bcc_recipients=[Recipient(email_address=email) for email in bcc_recipients or []],
|
|
).to_sdk()
|
|
|
|
send_mail_request_body = SendMailPostRequestBody(
|
|
message=message,
|
|
save_to_sent_items=True,
|
|
)
|
|
|
|
await client.me.send_mail.post(send_mail_request_body)
|
|
|
|
return {
|
|
"success": True,
|
|
"message": "Email sent successfully",
|
|
}
|
|
|
|
|
|
@tool(requires_auth=Microsoft(scopes=["Mail.Send"]))
|
|
async def send_draft_email(
|
|
context: ToolContext,
|
|
message_id: Annotated[str, "The ID of the draft email to send"],
|
|
) -> Annotated[dict, "A dictionary containing the sent email details"]:
|
|
"""Send an existing draft email in Outlook
|
|
|
|
This tool can send any un-sent email:
|
|
- draft
|
|
- reply-draft
|
|
- reply-all draft
|
|
- forward draft
|
|
"""
|
|
client = get_client(context.get_auth_token_or_empty())
|
|
|
|
await client.me.messages.by_message_id(message_id).send.post()
|
|
|
|
return {
|
|
"success": True,
|
|
"message": "Email sent successfully",
|
|
}
|
|
|
|
|
|
@tool(requires_auth=Microsoft(scopes=["Mail.Send"]))
|
|
async def reply_to_email(
|
|
context: ToolContext,
|
|
message_id: Annotated[str, "The ID of the email to reply to"],
|
|
body: Annotated[str, "The body of the reply to the email"],
|
|
reply_type: Annotated[
|
|
ReplyType,
|
|
f"Specify {ReplyType.REPLY} to reply only to the sender or "
|
|
f"{ReplyType.REPLY_ALL} to reply to all recipients. "
|
|
f"Defaults to {ReplyType.REPLY}.",
|
|
] = ReplyType.REPLY,
|
|
) -> Annotated[dict, "A dictionary containing the sent email details"]:
|
|
"""Reply to an existing email in Outlook.
|
|
|
|
Use this tool to reply to the sender or all recipients of the email.
|
|
Specify the reply_type to determine the scope of the reply.
|
|
"""
|
|
return await send_reply_email(context, message_id, body, reply_type)
|