chore: import upstream snapshot with attribution

apps/sim/tools/google_tasks/list.ts

@@ -0,0 +1,214 @@
+import type { GoogleTasksListParams, GoogleTasksListResponse } from '@/tools/google_tasks/types'
+import { TASKS_API_BASE } from '@/tools/google_tasks/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listTool: ToolConfig<GoogleTasksListParams, GoogleTasksListResponse> = {
+  id: 'google_tasks_list',
+  name: 'Google Tasks List Tasks',
+  description: 'List all tasks in a Google Tasks list',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'google-tasks',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'Google Tasks OAuth access token',
+    },
+    taskListId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Task list ID (defaults to primary task list "@default")',
+    },
+    maxResults: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Maximum number of tasks to return (default 20, max 100)',
+    },
+    pageToken: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Token for pagination',
+    },
+    showCompleted: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether to show completed tasks (default true)',
+    },
+    showDeleted: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether to show deleted tasks (default false)',
+    },
+    showHidden: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether to show hidden tasks (default false)',
+    },
+    dueMin: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Lower bound for due date filter (RFC 3339 timestamp)',
+    },
+    dueMax: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Upper bound for due date filter (RFC 3339 timestamp)',
+    },
+    completedMin: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Lower bound for task completion date (RFC 3339 timestamp)',
+    },
+    completedMax: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Upper bound for task completion date (RFC 3339 timestamp)',
+    },
+    updatedMin: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Lower bound for last modification time (RFC 3339 timestamp)',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const taskListId = params.taskListId || '@default'
+      const queryParams = new URLSearchParams()
+      if (params.maxResults) queryParams.set('maxResults', String(params.maxResults))
+      if (params.pageToken) queryParams.set('pageToken', params.pageToken)
+      if (params.showCompleted !== undefined)
+        queryParams.set('showCompleted', String(params.showCompleted))
+      if (params.showDeleted !== undefined)
+        queryParams.set('showDeleted', String(params.showDeleted))
+      if (params.showHidden !== undefined) queryParams.set('showHidden', String(params.showHidden))
+      if (params.dueMin) queryParams.set('dueMin', params.dueMin)
+      if (params.dueMax) queryParams.set('dueMax', params.dueMax)
+      if (params.completedMin) queryParams.set('completedMin', params.completedMin)
+      if (params.completedMax) queryParams.set('completedMax', params.completedMax)
+      if (params.updatedMin) queryParams.set('updatedMin', params.updatedMin)
+      const qs = queryParams.toString()
+      return `${TASKS_API_BASE}/lists/${encodeURIComponent(taskListId)}/tasks${qs ? `?${qs}` : ''}`
+    },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.error?.message ?? 'Failed to list tasks')
+    }
+
+    const items = data.items ?? []
+
+    return {
+      success: true,
+      output: {
+        tasks: items.map((item: Record<string, unknown>) => ({
+          id: (item.id as string) ?? null,
+          title: (item.title as string) ?? null,
+          notes: (item.notes as string) ?? null,
+          status: (item.status as string) ?? null,
+          due: (item.due as string) ?? null,
+          completed: (item.completed as string) ?? null,
+          updated: (item.updated as string) ?? null,
+          selfLink: (item.selfLink as string) ?? null,
+          webViewLink: (item.webViewLink as string) ?? null,
+          parent: (item.parent as string) ?? null,
+          position: (item.position as string) ?? null,
+          hidden: (item.hidden as boolean) ?? null,
+          deleted: (item.deleted as boolean) ?? null,
+          links: Array.isArray(item.links)
+            ? (item.links as Array<Record<string, string>>).map((link) => ({
+                type: link.type ?? '',
+                description: link.description ?? '',
+                link: link.link ?? '',
+              }))
+            : [],
+        })),
+        nextPageToken: data.nextPageToken ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    tasks: {
+      type: 'array',
+      description: 'List of tasks',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'string', description: 'Task identifier' },
+          title: { type: 'string', description: 'Title of the task' },
+          notes: { type: 'string', description: 'Notes/description for the task', optional: true },
+          status: {
+            type: 'string',
+            description: 'Task status: "needsAction" or "completed"',
+          },
+          due: { type: 'string', description: 'Due date (RFC 3339 timestamp)', optional: true },
+          completed: {
+            type: 'string',
+            description: 'Completion date (RFC 3339 timestamp)',
+            optional: true,
+          },
+          updated: { type: 'string', description: 'Last modification time (RFC 3339 timestamp)' },
+          selfLink: { type: 'string', description: 'URL pointing to this task' },
+          webViewLink: {
+            type: 'string',
+            description: 'Link to task in Google Tasks UI',
+            optional: true,
+          },
+          parent: { type: 'string', description: 'Parent task identifier', optional: true },
+          position: {
+            type: 'string',
+            description: 'Position among sibling tasks (string-based ordering)',
+          },
+          hidden: { type: 'boolean', description: 'Whether the task is hidden', optional: true },
+          deleted: { type: 'boolean', description: 'Whether the task is deleted', optional: true },
+          links: {
+            type: 'array',
+            description: 'Collection of links associated with the task',
+            optional: true,
+            items: {
+              type: 'object',
+              properties: {
+                type: {
+                  type: 'string',
+                  description: 'Link type (e.g., "email", "generic", "chat_message")',
+                },
+                description: { type: 'string', description: 'Link description' },
+                link: { type: 'string', description: 'The URL' },
+              },
+            },
+          },
+        },
+      },
+    },
+    nextPageToken: {
+      type: 'string',
+      description: 'Token for retrieving the next page of results',
+      optional: true,
+    },
+  },
+}