07c52100f3
# PR Description ## Split toolkits This PR splits the `Microsoft`, `Google`, and `Search` toolkits into multiple toolkits each. * `Microsoft` --> `OutlookCalendar`, `OutlookMail`. * `Google` -----> `GoogleCalendar`, `GoogleContacts`, `GoogleDocs`, `GoogleDrive`, `Gmail`, `GoogleSheets` * `Search` -----> `GoogleFinance`, `GoogleFlights`, `GoogleHotels`, `GoogleJobs`, `GoogleMaps`, `GoogleNews`, `GoogleSearch`, `GoogleShopping`, `Walmart`, `Youtube` > The original monolithic toolkits (`Microsoft`, `Google`, `Search`) are not removed in this PR. The plan is to keep those toolkits around while we > 1. Stop documenting the toolkits, > 2. Stop displaying the toolkits in the dashboard, and > 3. Help customers migrate over to the new split toolkits. ## Rename toolkits This PR renames the following toolkits * `Web` ------------> `Firecrawl` * `CodeSandbox` ---> `E2B` > The `Web` and `CodeSandbox` toolkits are not removed in this PR. The plan is to keep them around while we > 1. Stop documenting the toolkits, > 2. Stop displaying the toolkits in the dashboard, and > 3. Help customers migrate over to the new renamed toolkits. ## Rename tools Since toolkit names were changed, this called for some tools to be renamed as well. * `GoogleSearch.SearchGoogle` ----------------> `GoogleSearch.Search` * `GoogleShopping.SearchShoppingProducts` ---> `GoogleShopping.SearchProducts` * `Walmart.SearchWalmartProducts` ------------> `Walmart.SearchProducts` * `Walmart.GetWalmartProductDetails` ---------> `Walmart.GetProductDetails` * `Youtube.SearchYoutubeVideos` --------------> `Youtube.SearchForVideos` ## Google File Picker Improvements to the Google File Picker experience were also added in this PR. The following tools will ALWAYS provide llm_instructions in their response to "let the end-user know that they have the option to select more files via the file picker url if they want to": * `GoogleDocs.SearchDocuments` * `GoogleDocs.SearchAndRetrieveDocuments` * `GoogleDrive.GetFileTreeStructure` The following tools will only provide the file picker URL if a 404 or 403 from the Google API: * `GoogleDocs.InsertTextAtEndOfDocument` * `GoogleDocs.GetDocumentById` * `GoogleSheets.GetSpreadsheet` * `GoogleSheets.WriteToCell` Also, a standalone `GoogleDrive.GenerateGoogleFilePickerUrl` tool exists. ## Other * The `SearchDocuments` and `SearchAndRetrieveDocuments` tools used to be organized within the Drive portion of the Google toolkit, but I moved these into the new GoogleDocs toolkit because they are specific to Docs. # Progress - [x] `OutlookCalendar` - [x] `OutlookMail` - [x] `GoogleFinance` - [x] `GoogleFlights` - [x] `GoogleHotels` - [x] `GoogleJobs` - [x] `GoogleMaps` - [x] `GoogleNews` - [x] `GoogleSearch` - [x] `GoogleShopping` - [x] `Walmart` - [x] `Youtube` - [x] `GoogleCalendar` - [x] `GoogleContacts` - [x] `GoogleDocs` - [x] `GoogleDrive` - [x] `Gmail` - [x] `GoogleSheets` - [x] `Firecrawl` - [x] `E2B` - [x] File picker # Discussion * Repeated code is a consequence of splitting toolkits that use the same provider. I am open to any ideas that would allow multiple toolkits to reference common code. Comment your ideas in this PR.
81 lines
3.2 KiB
Python
81 lines
3.2 KiB
Python
from typing import Annotated
|
|
|
|
from arcade_tdk import ToolContext, tool
|
|
from arcade_tdk.auth import Microsoft
|
|
|
|
from arcade_outlook_calendar._utils import (
|
|
create_timezone_request_config,
|
|
get_default_calendar_timezone,
|
|
prepare_meeting_body,
|
|
remove_timezone_offset,
|
|
validate_date_times,
|
|
validate_emails,
|
|
)
|
|
from arcade_outlook_calendar.client import get_client
|
|
from arcade_outlook_calendar.models import (
|
|
Attendee,
|
|
DateTimeTimeZone,
|
|
Event,
|
|
)
|
|
|
|
|
|
@tool(requires_auth=Microsoft(scopes=["MailboxSettings.Read", "Calendars.ReadWrite"]))
|
|
async def create_event(
|
|
context: ToolContext,
|
|
subject: Annotated[str, "The text of the event's subject (title) line."],
|
|
body: Annotated[str, "The body of the event"],
|
|
start_date_time: Annotated[
|
|
str,
|
|
"The datetime of the event's start, represented in "
|
|
"ISO 8601 format. Timezone offset is ignored. For example, 2025-04-25T13:00:00",
|
|
],
|
|
end_date_time: Annotated[
|
|
str,
|
|
"The datetime of the event's end, represented in "
|
|
"ISO 8601 format. Timezone offset is ignored. For example, 2025-04-25T13:30:00",
|
|
],
|
|
location: Annotated[str | None, "The location of the event"] = None,
|
|
attendee_emails: Annotated[
|
|
list[str] | None,
|
|
"The email addresses of the attendees of the event. "
|
|
"Must be valid email addresses e.g., username@domain.com.",
|
|
] = None,
|
|
is_online_meeting: Annotated[
|
|
bool, "Whether the event is an online meeting. Defaults to False"
|
|
] = False,
|
|
custom_meeting_url: Annotated[
|
|
str | None,
|
|
"The URL of the online meeting. If not provided and is_online_meeting is True, "
|
|
"then a url will be generated for you",
|
|
] = None,
|
|
) -> Annotated[dict, "A dictionary containing the created event details"]:
|
|
"""Create an event in the authenticated user's default calendar.
|
|
|
|
Ignores timezone offsets provided in the start_date_time and end_date_time parameters.
|
|
Instead, uses the user's default calendar timezone to filter events.
|
|
If the user has not set a timezone for their calendar, then the timezone will be UTC.
|
|
"""
|
|
# Validate & cleanse inputs
|
|
validate_emails(attendee_emails or [])
|
|
validate_date_times(start_date_time, end_date_time)
|
|
body, is_online_meeting = prepare_meeting_body(body, custom_meeting_url, is_online_meeting)
|
|
|
|
client = get_client(context.get_auth_token_or_empty())
|
|
|
|
time_zone = await get_default_calendar_timezone(client)
|
|
start_date_time = remove_timezone_offset(start_date_time)
|
|
end_date_time = remove_timezone_offset(end_date_time)
|
|
event = Event(
|
|
subject=subject,
|
|
body=body,
|
|
start=DateTimeTimeZone(date_time=start_date_time, time_zone=time_zone),
|
|
end=DateTimeTimeZone(date_time=end_date_time, time_zone=time_zone),
|
|
location=location or "",
|
|
attendees=[Attendee(address=attendee) for attendee in attendee_emails or []],
|
|
is_online_meeting=is_online_meeting,
|
|
).to_sdk()
|
|
request_config = create_timezone_request_config(time_zone)
|
|
|
|
response = await client.me.events.post(body=event, request_configuration=request_config)
|
|
|
|
return Event.from_sdk(response).to_dict() # type: ignore[arg-type]
|