fix(google-calendar): make list orderBy user-selectable, clarify update timeZone applies to start/end

Author: waleedlatif1

apps/sim/blocks/blocks/google_calendar.ts

@@ -278,6 +278,18 @@ Return ONLY the timestamp string - no explanations, no quotes, no extra text.`,
       placeholder: 'standup',
       condition: { field: 'operation', value: 'list' },
     },
+    {
+      id: 'orderBy',
+      title: 'Order By',
+      type: 'dropdown',
+      condition: { field: 'operation', value: 'list' },
+      mode: 'advanced',
+      options: [
+        { label: 'Start time', id: 'startTime' },
+        { label: 'Last updated', id: 'updated' },
+      ],
+      value: () => 'startTime',
+    },
     {
       id: 'pageToken',
       title: 'Page Token',
@@ -837,6 +849,7 @@ Return ONLY the timestamp string - no explanations, no quotes, no extra text.`,
     timeMin: { type: 'string', description: 'Start time filter' },
     timeMax: { type: 'string', description: 'End time filter' },
     q: { type: 'string', description: 'Free-text search query' },
+    orderBy: { type: 'string', description: 'Event ordering (startTime or updated)' },
     maxResults: { type: 'string', description: 'Maximum number of results' },
     pageToken: { type: 'string', description: 'Pagination token from a previous response' },
 

apps/sim/tools/google_calendar/list.ts

@@ -65,8 +65,9 @@ export const listTool: ToolConfig<GoogleCalendarListParams, GoogleCalendarListRe
     orderBy: {
       type: 'string',
       required: false,
-      visibility: 'hidden',
-      description: 'Order of events returned (startTime or updated). Defaults to startTime.',
+      visibility: 'user-or-llm',
+      description:
+        'Order of events: startTime (chronological, the default) or updated (last-modified). startTime is always valid here because singleEvents is set.',
     },
     showDeleted: {
       type: 'boolean',

apps/sim/tools/google_calendar/update.ts

@@ -83,7 +83,7 @@ export const updateTool: ToolConfig<GoogleCalendarUpdateParams, GoogleCalendarUp
       required: false,
       visibility: 'user-or-llm',
       description:
-        'IANA time zone (e.g., America/Los_Angeles). Used as-is when provided. For recurring events a time zone is required to expand the recurrence correctly; for one-off events it is only needed when the datetime omits a UTC offset.',
+        'IANA time zone (e.g., America/Los_Angeles) applied to the start/end times provided in this update. Provide a new start and/or end time to change the time zone; a time zone on its own is not applied. Required for recurring events to expand the recurrence correctly.',
     },
     attendees: {
       type: 'array',