chore: import upstream snapshot with attribution

apps/sim/tools/athena/list_table_metadata.ts

@@ -0,0 +1,157 @@
+import type {
+  AthenaListTableMetadataParams,
+  AthenaListTableMetadataResponse,
+} from '@/tools/athena/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listTableMetadataTool: ToolConfig<
+  AthenaListTableMetadataParams,
+  AthenaListTableMetadataResponse
+> = {
+  id: 'athena_list_table_metadata',
+  name: 'Athena List Table Metadata',
+  description: 'List tables and their column/partition metadata for an Athena database',
+  version: '1.0.0',
+
+  params: {
+    awsRegion: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS region (e.g., us-east-1)',
+    },
+    awsAccessKeyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS access key ID',
+    },
+    awsSecretAccessKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS secret access key',
+    },
+    catalogName: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Data catalog name (e.g., AwsDataCatalog)',
+    },
+    databaseName: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Database name to list tables from',
+    },
+    expression: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Regex filter that pattern-matches table names',
+    },
+    workGroup: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Workgroup for which the metadata is being fetched (required for IAM Identity Center enabled catalogs)',
+    },
+    maxResults: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Maximum number of results (1-50)',
+    },
+    nextToken: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Pagination token from a previous request',
+    },
+  },
+
+  request: {
+    url: '/api/tools/athena/list-table-metadata',
+    method: 'POST',
+    headers: () => ({ 'Content-Type': 'application/json' }),
+    body: (params) => ({
+      region: params.awsRegion,
+      accessKeyId: params.awsAccessKeyId,
+      secretAccessKey: params.awsSecretAccessKey,
+      catalogName: params.catalogName,
+      databaseName: params.databaseName,
+      ...(params.expression && { expression: params.expression }),
+      ...(params.workGroup && { workGroup: params.workGroup }),
+      ...(params.maxResults !== undefined && { maxResults: params.maxResults }),
+      ...(params.nextToken && { nextToken: params.nextToken }),
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+    if (!response.ok) {
+      throw new Error(data.error || 'Failed to list Athena table metadata')
+    }
+    return {
+      success: true,
+      output: {
+        tables: data.output.tables ?? [],
+        nextToken: data.output.nextToken ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    tables: {
+      type: 'array',
+      description: 'Table metadata (name, type, columns, partition keys)',
+      items: {
+        type: 'object',
+        properties: {
+          name: { type: 'string', description: 'Table name' },
+          tableType: { type: 'string', description: 'Table type', optional: true },
+          createTime: {
+            type: 'number',
+            description: 'Table creation time (Unix epoch ms)',
+            optional: true,
+          },
+          lastAccessTime: {
+            type: 'number',
+            description: 'Table last access time (Unix epoch ms)',
+            optional: true,
+          },
+          columns: {
+            type: 'array',
+            description: 'Column definitions',
+            items: {
+              type: 'object',
+              properties: {
+                name: { type: 'string', description: 'Column name' },
+                type: { type: 'string', description: 'Column data type', optional: true },
+                comment: { type: 'string', description: 'Column comment', optional: true },
+              },
+            },
+          },
+          partitionKeys: {
+            type: 'array',
+            description: 'Partition key definitions',
+            items: {
+              type: 'object',
+              properties: {
+                name: { type: 'string', description: 'Partition key name' },
+                type: { type: 'string', description: 'Partition key data type', optional: true },
+                comment: { type: 'string', description: 'Partition key comment', optional: true },
+              },
+            },
+          },
+        },
+      },
+    },
+    nextToken: {
+      type: 'string',
+      description: 'Pagination token for next page',
+      optional: true,
+    },
+  },
+}