chore: import upstream snapshot with attribution

apps/sim/tools/rds/delete.ts

@@ -0,0 +1,103 @@
+import type { RdsDeleteParams, RdsDeleteResponse } from '@/tools/rds/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const deleteTool: ToolConfig<RdsDeleteParams, RdsDeleteResponse> = {
+  id: 'rds_delete',
+  name: 'RDS Delete',
+  description: 'Delete data from an Amazon RDS table using the Data API',
+  version: '1.0',
+
+  params: {
+    region: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS region (e.g., us-east-1)',
+    },
+    accessKeyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS access key ID',
+    },
+    secretAccessKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS secret access key',
+    },
+    resourceArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)',
+    },
+    secretArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'ARN of the Secrets Manager secret containing DB credentials',
+    },
+    database: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Database name to connect to (e.g., mydb, production_db)',
+    },
+    table: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Table name to delete from',
+    },
+    conditions: {
+      type: 'object',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Conditions for the delete (e.g., {"id": 1})',
+    },
+  },
+
+  request: {
+    url: '/api/tools/rds/delete',
+    method: 'POST',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => ({
+      region: params.region,
+      accessKeyId: params.accessKeyId,
+      secretAccessKey: params.secretAccessKey,
+      resourceArn: params.resourceArn,
+      secretArn: params.secretArn,
+      ...(params.database && { database: params.database }),
+      table: params.table,
+      conditions: params.conditions,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.error || 'RDS delete failed')
+    }
+
+    return {
+      success: true,
+      output: {
+        message: data.message || 'Delete executed successfully',
+        rows: data.rows || [],
+        rowCount: data.rowCount || 0,
+      },
+      error: undefined,
+    }
+  },
+
+  outputs: {
+    message: { type: 'string', description: 'Operation status message' },
+    rows: { type: 'array', description: 'Array of deleted rows' },
+    rowCount: { type: 'number', description: 'Number of rows deleted' },
+  },
+}

apps/sim/tools/rds/execute.ts

@@ -0,0 +1,97 @@
+import type { RdsExecuteParams, RdsExecuteResponse } from '@/tools/rds/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const executeTool: ToolConfig<RdsExecuteParams, RdsExecuteResponse> = {
+  id: 'rds_execute',
+  name: 'RDS Execute',
+  description: 'Execute raw SQL on Amazon RDS using the Data API',
+  version: '1.0',
+
+  params: {
+    region: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS region (e.g., us-east-1)',
+    },
+    accessKeyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS access key ID',
+    },
+    secretAccessKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS secret access key',
+    },
+    resourceArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)',
+    },
+    secretArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'ARN of the Secrets Manager secret containing DB credentials',
+    },
+    database: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Database name to connect to (e.g., mydb, production_db)',
+    },
+    query: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'Raw SQL query to execute (e.g., CREATE TABLE users (id SERIAL PRIMARY KEY, name VARCHAR(255)))',
+    },
+  },
+
+  request: {
+    url: '/api/tools/rds/execute',
+    method: 'POST',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => ({
+      region: params.region,
+      accessKeyId: params.accessKeyId,
+      secretAccessKey: params.secretAccessKey,
+      resourceArn: params.resourceArn,
+      secretArn: params.secretArn,
+      ...(params.database && { database: params.database }),
+      query: params.query,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.error || 'RDS execute failed')
+    }
+
+    return {
+      success: true,
+      output: {
+        message: data.message || 'Query executed successfully',
+        rows: data.rows || [],
+        rowCount: data.rowCount || 0,
+      },
+      error: undefined,
+    }
+  },
+
+  outputs: {
+    message: { type: 'string', description: 'Operation status message' },
+    rows: { type: 'array', description: 'Array of rows returned or affected' },
+    rowCount: { type: 'number', description: 'Number of rows affected' },
+  },
+}

apps/sim/tools/rds/index.ts

@@ -0,0 +1,13 @@
+import { deleteTool } from './delete'
+import { executeTool } from './execute'
+import { insertTool } from './insert'
+import { introspectTool } from './introspect'
+import { queryTool } from './query'
+import { updateTool } from './update'
+
+export const rdsDeleteTool = deleteTool
+export const rdsExecuteTool = executeTool
+export const rdsInsertTool = insertTool
+export const rdsIntrospectTool = introspectTool
+export const rdsQueryTool = queryTool
+export const rdsUpdateTool = updateTool

apps/sim/tools/rds/insert.ts

@@ -0,0 +1,103 @@
+import type { RdsInsertParams, RdsInsertResponse } from '@/tools/rds/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const insertTool: ToolConfig<RdsInsertParams, RdsInsertResponse> = {
+  id: 'rds_insert',
+  name: 'RDS Insert',
+  description: 'Insert data into an Amazon RDS table using the Data API',
+  version: '1.0',
+
+  params: {
+    region: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS region (e.g., us-east-1)',
+    },
+    accessKeyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS access key ID',
+    },
+    secretAccessKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS secret access key',
+    },
+    resourceArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)',
+    },
+    secretArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'ARN of the Secrets Manager secret containing DB credentials',
+    },
+    database: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Database name to connect to (e.g., mydb, production_db)',
+    },
+    table: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Table name to insert into',
+    },
+    data: {
+      type: 'object',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Data to insert as key-value pairs',
+    },
+  },
+
+  request: {
+    url: '/api/tools/rds/insert',
+    method: 'POST',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => ({
+      region: params.region,
+      accessKeyId: params.accessKeyId,
+      secretAccessKey: params.secretAccessKey,
+      resourceArn: params.resourceArn,
+      secretArn: params.secretArn,
+      ...(params.database && { database: params.database }),
+      table: params.table,
+      data: params.data,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.error || 'RDS insert failed')
+    }
+
+    return {
+      success: true,
+      output: {
+        message: data.message || 'Insert executed successfully',
+        rows: data.rows || [],
+        rowCount: data.rowCount || 0,
+      },
+      error: undefined,
+    }
+  },
+
+  outputs: {
+    message: { type: 'string', description: 'Operation status message' },
+    rows: { type: 'array', description: 'Array of inserted rows' },
+    rowCount: { type: 'number', description: 'Number of rows inserted' },
+  },
+}

apps/sim/tools/rds/introspect.ts

@@ -0,0 +1,110 @@
+import type { RdsIntrospectParams, RdsIntrospectResponse } from '@/tools/rds/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const introspectTool: ToolConfig<RdsIntrospectParams, RdsIntrospectResponse> = {
+  id: 'rds_introspect',
+  name: 'RDS Introspect',
+  description:
+    'Introspect Amazon RDS Aurora database schema to retrieve table structures, columns, and relationships',
+  version: '1.0',
+
+  params: {
+    region: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS region (e.g., us-east-1)',
+    },
+    accessKeyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS access key ID',
+    },
+    secretAccessKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS secret access key',
+    },
+    resourceArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)',
+    },
+    secretArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'ARN of the Secrets Manager secret containing DB credentials',
+    },
+    database: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Database name to connect to (e.g., mydb, production_db)',
+    },
+    schema: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Schema to introspect (default: public for PostgreSQL, database name for MySQL)',
+    },
+    engine: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description:
+        'Database engine (aurora-postgresql or aurora-mysql). Auto-detected if not provided.',
+    },
+  },
+
+  request: {
+    url: '/api/tools/rds/introspect',
+    method: 'POST',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => ({
+      region: params.region,
+      accessKeyId: params.accessKeyId,
+      secretAccessKey: params.secretAccessKey,
+      resourceArn: params.resourceArn,
+      secretArn: params.secretArn,
+      ...(params.database && { database: params.database }),
+      ...(params.schema && { schema: params.schema }),
+      ...(params.engine && { engine: params.engine }),
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.error || 'RDS introspection failed')
+    }
+
+    return {
+      success: true,
+      output: {
+        message: data.message || 'Schema introspection completed successfully',
+        engine: data.engine || 'unknown',
+        tables: data.tables || [],
+        schemas: data.schemas || [],
+      },
+      error: undefined,
+    }
+  },
+
+  outputs: {
+    message: { type: 'string', description: 'Operation status message' },
+    engine: { type: 'string', description: 'Detected database engine type' },
+    tables: {
+      type: 'array',
+      description: 'Array of table schemas with columns, keys, and indexes',
+    },
+    schemas: { type: 'array', description: 'List of available schemas in the database' },
+  },
+}

apps/sim/tools/rds/query.ts

@@ -0,0 +1,96 @@
+import type { RdsQueryParams, RdsQueryResponse } from '@/tools/rds/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const queryTool: ToolConfig<RdsQueryParams, RdsQueryResponse> = {
+  id: 'rds_query',
+  name: 'RDS Query',
+  description: 'Execute a SELECT query on Amazon RDS using the Data API',
+  version: '1.0',
+
+  params: {
+    region: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS region (e.g., us-east-1)',
+    },
+    accessKeyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS access key ID',
+    },
+    secretAccessKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS secret access key',
+    },
+    resourceArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)',
+    },
+    secretArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'ARN of the Secrets Manager secret containing DB credentials',
+    },
+    database: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Database name to connect to (e.g., mydb, production_db)',
+    },
+    query: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'SQL SELECT query to execute (e.g., SELECT * FROM users WHERE status = :status)',
+    },
+  },
+
+  request: {
+    url: '/api/tools/rds/query',
+    method: 'POST',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => ({
+      region: params.region,
+      accessKeyId: params.accessKeyId,
+      secretAccessKey: params.secretAccessKey,
+      resourceArn: params.resourceArn,
+      secretArn: params.secretArn,
+      ...(params.database && { database: params.database }),
+      query: params.query,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.error || 'RDS query failed')
+    }
+
+    return {
+      success: true,
+      output: {
+        message: data.message || 'Query executed successfully',
+        rows: data.rows || [],
+        rowCount: data.rowCount || 0,
+      },
+      error: undefined,
+    }
+  },
+
+  outputs: {
+    message: { type: 'string', description: 'Operation status message' },
+    rows: { type: 'array', description: 'Array of rows returned from the query' },
+    rowCount: { type: 'number', description: 'Number of rows returned' },
+  },
+}

apps/sim/tools/rds/types.ts

@@ -0,0 +1,95 @@
+import type { ToolResponse } from '@/tools/types'
+
+export interface RdsConnectionConfig {
+  region: string
+  accessKeyId: string
+  secretAccessKey: string
+  resourceArn: string
+  secretArn: string
+  database?: string
+}
+
+export interface RdsQueryParams extends RdsConnectionConfig {
+  query: string
+}
+
+export interface RdsInsertParams extends RdsConnectionConfig {
+  table: string
+  data: Record<string, unknown>
+}
+
+export interface RdsUpdateParams extends RdsConnectionConfig {
+  table: string
+  data: Record<string, unknown>
+  conditions: Record<string, unknown>
+}
+
+export interface RdsDeleteParams extends RdsConnectionConfig {
+  table: string
+  conditions: Record<string, unknown>
+}
+
+export interface RdsExecuteParams extends RdsConnectionConfig {
+  query: string
+}
+
+export interface RdsIntrospectParams extends RdsConnectionConfig {
+  schema?: string
+  engine?: 'aurora-postgresql' | 'aurora-mysql'
+}
+
+interface RdsBaseResponse extends ToolResponse {
+  output: {
+    message: string
+    rows: unknown[]
+    rowCount: number
+  }
+  error?: string
+}
+
+export interface RdsQueryResponse extends RdsBaseResponse {}
+export interface RdsInsertResponse extends RdsBaseResponse {}
+export interface RdsUpdateResponse extends RdsBaseResponse {}
+export interface RdsDeleteResponse extends RdsBaseResponse {}
+export interface RdsExecuteResponse extends RdsBaseResponse {}
+export interface RdsResponse extends RdsBaseResponse {}
+
+interface RdsTableColumn {
+  name: string
+  type: string
+  nullable: boolean
+  default: string | null
+  isPrimaryKey: boolean
+  isForeignKey: boolean
+  references?: {
+    table: string
+    column: string
+  }
+}
+
+interface RdsTableSchema {
+  name: string
+  schema: string
+  columns: RdsTableColumn[]
+  primaryKey: string[]
+  foreignKeys: Array<{
+    column: string
+    referencesTable: string
+    referencesColumn: string
+  }>
+  indexes: Array<{
+    name: string
+    columns: string[]
+    unique: boolean
+  }>
+}
+
+export interface RdsIntrospectResponse extends ToolResponse {
+  output: {
+    message: string
+    engine: string
+    tables: RdsTableSchema[]
+    schemas: string[]
+  }
+  error?: string
+}

apps/sim/tools/rds/update.ts

@@ -0,0 +1,110 @@
+import type { RdsUpdateParams, RdsUpdateResponse } from '@/tools/rds/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const updateTool: ToolConfig<RdsUpdateParams, RdsUpdateResponse> = {
+  id: 'rds_update',
+  name: 'RDS Update',
+  description: 'Update data in an Amazon RDS table using the Data API',
+  version: '1.0',
+
+  params: {
+    region: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS region (e.g., us-east-1)',
+    },
+    accessKeyId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS access key ID',
+    },
+    secretAccessKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'AWS secret access key',
+    },
+    resourceArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)',
+    },
+    secretArn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'ARN of the Secrets Manager secret containing DB credentials',
+    },
+    database: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Database name to connect to (e.g., mydb, production_db)',
+    },
+    table: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Table name to update',
+    },
+    data: {
+      type: 'object',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Data to update as key-value pairs',
+    },
+    conditions: {
+      type: 'object',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Conditions for the update (e.g., {"id": 1})',
+    },
+  },
+
+  request: {
+    url: '/api/tools/rds/update',
+    method: 'POST',
+    headers: () => ({
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => ({
+      region: params.region,
+      accessKeyId: params.accessKeyId,
+      secretAccessKey: params.secretAccessKey,
+      resourceArn: params.resourceArn,
+      secretArn: params.secretArn,
+      ...(params.database && { database: params.database }),
+      table: params.table,
+      data: params.data,
+      conditions: params.conditions,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.error || 'RDS update failed')
+    }
+
+    return {
+      success: true,
+      output: {
+        message: data.message || 'Update executed successfully',
+        rows: data.rows || [],
+        rowCount: data.rowCount || 0,
+      },
+      error: undefined,
+    }
+  },
+
+  outputs: {
+    message: { type: 'string', description: 'Operation status message' },
+    rows: { type: 'array', description: 'Array of updated rows' },
+    rowCount: { type: 'number', description: 'Number of rows updated' },
+  },
+}