chore: import upstream snapshot with attribution

apps/sim/tools/google_vault/create_saved_query.ts

@@ -0,0 +1,146 @@
+import type { GoogleVaultCreateSavedQueryParams } from '@/tools/google_vault/types'
+import { enhanceGoogleVaultError } from '@/tools/google_vault/utils'
+import type { ToolConfig } from '@/tools/types'
+
+export const createSavedQueryTool: ToolConfig<GoogleVaultCreateSavedQueryParams> = {
+  id: 'google_vault_create_saved_query',
+  name: 'Vault Create Saved Query',
+  description: 'Save a reusable search query in a matter',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'google-vault',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'OAuth access token',
+    },
+    matterId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The matter ID (e.g., "12345678901234567890")',
+    },
+    displayName: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Name for the saved query',
+    },
+    corpus: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Data corpus to search (MAIL, DRIVE, GROUPS, HANGOUTS_CHAT, VOICE)',
+    },
+    accountEmails: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Comma-separated list of user emails to scope the query (e.g., "user1@example.com, user2@example.com")',
+    },
+    orgUnitId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Organization unit ID to scope the query (e.g., "id:03ph8a2z1enx5q0", alternative to emails)',
+    },
+    startTime: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Start time for date filtering (ISO 8601 format, e.g., "2024-01-01T00:00:00Z")',
+    },
+    endTime: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'End time for date filtering (ISO 8601 format, e.g., "2024-12-31T23:59:59Z")',
+    },
+    terms: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Search query terms (e.g., "from:sender@example.com subject:invoice")',
+    },
+  },
+
+  request: {
+    url: (params) =>
+      `https://vault.googleapis.com/v1/matters/${params.matterId.trim()}/savedQueries`,
+    method: 'POST',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => {
+      let emails: string[] = []
+      if (params.accountEmails) {
+        if (Array.isArray(params.accountEmails)) {
+          emails = params.accountEmails
+        } else if (typeof params.accountEmails === 'string') {
+          emails = params.accountEmails
+            .split(',')
+            .map((e) => e.trim())
+            .filter(Boolean)
+        }
+      }
+
+      const scope =
+        emails.length > 0
+          ? { accountInfo: { emails } }
+          : params.orgUnitId
+            ? { orgUnitInfo: { orgUnitId: params.orgUnitId } }
+            : {}
+
+      const method =
+        emails.length > 0
+          ? 'ACCOUNT'
+          : params.orgUnitId
+            ? 'ORG_UNIT'
+            : params.corpus === 'MAIL'
+              ? 'ENTIRE_ORG'
+              : undefined
+
+      if (!method) {
+        throw new Error(
+          `Account Emails or Org Unit ID is required to scope a ${params.corpus} saved query ` +
+            '(only MAIL queries can search the entire organization with no scope).'
+        )
+      }
+
+      return {
+        displayName: params.displayName,
+        query: {
+          corpus: params.corpus,
+          dataScope: 'ALL_DATA',
+          method,
+          terms: params.terms || undefined,
+          startTime: params.startTime || undefined,
+          endTime: params.endTime || undefined,
+          ...scope,
+        },
+      }
+    },
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+    if (!response.ok) {
+      const errorMessage = data.error?.message || 'Failed to create saved query'
+      throw new Error(enhanceGoogleVaultError(errorMessage))
+    }
+    return { success: true, output: { savedQuery: data } }
+  },
+
+  outputs: {
+    savedQuery: { type: 'json', description: 'Created saved query object' },
+  },
+}