@squadbase/connectors 0.0.12 → 0.0.14

package/dist/index.js

@@ -1,8 +1,12 @@
 import {
   ParameterDefinition,
   parameters,
-  parameters2
-} from "./chunk-E5AVUXWJ.js";
+  parameters2,
+  parameters3,
+  parameters4,
+  parameters5,
+  parameters6
+} from "./chunk-4K4NERCT.js";
 
 // src/connector-setup.ts
 var ConnectorSetup = class {
@@ -226,7 +230,7 @@ Follow these steps to set up the Snowflake connection.
 });
 
 // src/connectors/snowflake/parameters.ts
-var parameters3 = {
+var parameters7 = {
   account: new ParameterDefinition({
     slug: "account",
     name: "Snowflake Account",
@@ -285,6 +289,19 @@ var parameters3 = {
 
 // src/connectors/snowflake/tools/execute-query.ts
 import { z } from "zod";
+
+// src/connectors/snowflake/utils.ts
+import crypto from "crypto";
+function decryptPrivateKey(pem, passphrase) {
+  if (!passphrase) return pem;
+  return crypto.createPrivateKey({
+    key: pem,
+    format: "pem",
+    passphrase
+  }).export({ type: "pkcs8", format: "pem" });
+}
+
+// src/connectors/snowflake/tools/execute-query.ts
 var MAX_ROWS = 500;
 var QUERY_TIMEOUT_MS = 6e4;
 var inputSchema = z.object({
@@ -329,23 +346,23 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
     try {
       const snowflake = (await import("snowflake-sdk")).default;
       snowflake.configure({ logLevel: "ERROR" });
-      const account = parameters3.account.getValue(connection);
-      const user = parameters3.user.getValue(connection);
-      const role = parameters3.role.getValue(connection);
-      const warehouse = parameters3.warehouse.getValue(connection);
-      const privateKeyBase64 = parameters3.privateKeyBase64.getValue(connection);
-      const privateKey = Buffer.from(privateKeyBase64, "base64").toString(
+      const account = parameters7.account.getValue(connection);
+      const user = parameters7.user.getValue(connection);
+      const role = parameters7.role.getValue(connection);
+      const warehouse = parameters7.warehouse.getValue(connection);
+      const privateKeyBase64 = parameters7.privateKeyBase64.getValue(connection);
+      const privateKeyPem = Buffer.from(privateKeyBase64, "base64").toString(
         "utf-8"
       );
-      const privateKeyPass = parameters3.privateKeyPassphrase.tryGetValue(connection);
+      const privateKeyPass = parameters7.privateKeyPassphrase.tryGetValue(connection);
+      const privateKey = decryptPrivateKey(privateKeyPem, privateKeyPass ?? void 0);
       const conn = snowflake.createConnection({
         account,
         username: user,
         role,
         warehouse,
         authenticator: "SNOWFLAKE_JWT",
-        privateKey,
-        ...privateKeyPass ? { privateKeyPass } : {}
+        privateKey
       });
       await new Promise((resolve, reject) => {
         conn.connect((err) => {
@@ -402,7 +419,7 @@ var snowflakeConnector = new ConnectorPlugin({
   name: "Snowflake",
   description: "Connect to Snowflake for cloud data warehousing and analytics.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6oyVtAcP3pMlXaOrts9unk/b7a9dc25d15c388b66e983041b855447/snowflake.svg",
-  parameters: parameters3,
+  parameters: parameters7,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   setup: snowflakeSetup,
   systemPrompt: `## Snowflake SQL Notes
@@ -418,19 +435,19 @@ var snowflakeConnector = new ConnectorPlugin({
     try {
       const snowflake = (await import("snowflake-sdk")).default;
       snowflake.configure({ logLevel: "ERROR" });
-      const privateKey = Buffer.from(
-        params[parameters3.privateKeyBase64.slug],
+      const privateKeyPem = Buffer.from(
+        params[parameters7.privateKeyBase64.slug],
         "base64"
       ).toString("utf-8");
-      const privateKeyPass = params[parameters3.privateKeyPassphrase.slug] || void 0;
+      const privateKeyPass = params[parameters7.privateKeyPassphrase.slug] || void 0;
+      const privateKey = decryptPrivateKey(privateKeyPem, privateKeyPass);
       const conn = snowflake.createConnection({
-        account: params[parameters3.account.slug],
-        username: params[parameters3.user.slug],
-        role: params[parameters3.role.slug],
-        warehouse: params[parameters3.warehouse.slug],
+        account: params[parameters7.account.slug],
+        username: params[parameters7.user.slug],
+        role: params[parameters7.role.slug],
+        warehouse: params[parameters7.warehouse.slug],
         authenticator: "SNOWFLAKE_JWT",
-        privateKey,
-        ...privateKeyPass ? { privateKeyPass } : {}
+        privateKey
       });
       await new Promise((resolve, reject) => {
         conn.connect((err) => {
@@ -459,19 +476,19 @@ var snowflakeConnector = new ConnectorPlugin({
     const resolvedSql = replaceLiteralParams(sql, namedParams);
     const snowflake = (await import("snowflake-sdk")).default;
     snowflake.configure({ logLevel: "ERROR" });
-    const privateKey = Buffer.from(
-      params[parameters3.privateKeyBase64.slug],
+    const privateKeyPem = Buffer.from(
+      params[parameters7.privateKeyBase64.slug],
       "base64"
     ).toString("utf-8");
-    const privateKeyPass = params[parameters3.privateKeyPassphrase.slug] || void 0;
+    const privateKeyPass = params[parameters7.privateKeyPassphrase.slug] || void 0;
+    const privateKey = decryptPrivateKey(privateKeyPem, privateKeyPass);
     const conn = snowflake.createConnection({
-      account: params[parameters3.account.slug],
-      username: params[parameters3.user.slug],
-      role: params[parameters3.role.slug],
-      warehouse: params[parameters3.warehouse.slug],
+      account: params[parameters7.account.slug],
+      username: params[parameters7.user.slug],
+      role: params[parameters7.role.slug],
+      warehouse: params[parameters7.warehouse.slug],
       authenticator: "SNOWFLAKE_JWT",
-      privateKey,
-      ...privateKeyPass ? { privateKeyPass } : {}
+      privateKey
     });
     await new Promise((resolve, reject) => {
       conn.connect((err) => {
@@ -498,7 +515,7 @@ var snowflakeConnector = new ConnectorPlugin({
 });
 
 // src/connectors/snowflake-pat/parameters.ts
-var parameters4 = {
+var parameters8 = {
   account: new ParameterDefinition({
     slug: "account",
     name: "Snowflake Account",
@@ -592,11 +609,11 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
     try {
       const snowflake = (await import("snowflake-sdk")).default;
       snowflake.configure({ logLevel: "ERROR" });
-      const account = parameters4.account.getValue(connection);
-      const user = parameters4.user.getValue(connection);
-      const role = parameters4.role.getValue(connection);
-      const warehouse = parameters4.warehouse.getValue(connection);
-      const password = parameters4.pat.getValue(connection);
+      const account = parameters8.account.getValue(connection);
+      const user = parameters8.user.getValue(connection);
+      const role = parameters8.role.getValue(connection);
+      const warehouse = parameters8.warehouse.getValue(connection);
+      const password = parameters8.pat.getValue(connection);
       const conn = snowflake.createConnection({
         account,
         username: user,
@@ -659,7 +676,7 @@ var snowflakePatConnector = new ConnectorPlugin({
   name: "Snowflake (PAT)",
   description: "Connect to Snowflake using a Personal Access Token (PAT).",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6oyVtAcP3pMlXaOrts9unk/b7a9dc25d15c388b66e983041b855447/snowflake.svg",
-  parameters: parameters4,
+  parameters: parameters8,
   releaseFlag: { dev1: true, dev2: false, prod: false },
   setup: snowflakeSetup,
   systemPrompt: `## Snowflake SQL Notes
@@ -676,11 +693,11 @@ var snowflakePatConnector = new ConnectorPlugin({
       const snowflake = (await import("snowflake-sdk")).default;
       snowflake.configure({ logLevel: "ERROR" });
       const conn = snowflake.createConnection({
-        account: params[parameters4.account.slug],
-        username: params[parameters4.user.slug],
-        role: params[parameters4.role.slug],
-        warehouse: params[parameters4.warehouse.slug],
-        password: params[parameters4.pat.slug]
+        account: params[parameters8.account.slug],
+        username: params[parameters8.user.slug],
+        role: params[parameters8.role.slug],
+        warehouse: params[parameters8.warehouse.slug],
+        password: params[parameters8.pat.slug]
       });
       await new Promise((resolve, reject) => {
         conn.connect((err) => {
@@ -715,11 +732,11 @@ var snowflakePatConnector = new ConnectorPlugin({
     const snowflake = (await import("snowflake-sdk")).default;
     snowflake.configure({ logLevel: "ERROR" });
     const conn = snowflake.createConnection({
-      account: params[parameters4.account.slug],
-      username: params[parameters4.user.slug],
-      role: params[parameters4.role.slug],
-      warehouse: params[parameters4.warehouse.slug],
-      password: params[parameters4.pat.slug]
+      account: params[parameters8.account.slug],
+      username: params[parameters8.user.slug],
+      role: params[parameters8.role.slug],
+      warehouse: params[parameters8.warehouse.slug],
+      password: params[parameters8.pat.slug]
     });
     await new Promise((resolve, reject) => {
       conn.connect((err) => {
@@ -751,7 +768,7 @@ var snowflakePatConnector = new ConnectorPlugin({
 });
 
 // src/connectors/postgresql/parameters.ts
-var parameters5 = {
+var parameters9 = {
   connectionUrl: new ParameterDefinition({
     slug: "connection-url",
     name: "PostgreSQL Connection URL",
@@ -808,7 +825,7 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
     let connectionUrl;
     try {
       const { Pool } = await import("pg");
-      connectionUrl = parameters5.connectionUrl.getValue(connection);
+      connectionUrl = parameters9.connectionUrl.getValue(connection);
       const pool = new Pool({
         connectionString: connectionUrl,
         ssl: { rejectUnauthorized: false },
@@ -846,7 +863,7 @@ var postgresqlConnector = new ConnectorPlugin({
   name: "PostgreSQL",
   description: "Connect to PostgreSQL databases for relational data storage and querying.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/42AHi2uqteUn65MyqdN6V7/a0f68f12af6aac96bbcda5980f43de07/elephant.png",
-  parameters: parameters5,
+  parameters: parameters9,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## PostgreSQL SQL Notes
 - Schema exploration:
@@ -857,7 +874,7 @@ var postgresqlConnector = new ConnectorPlugin({
   async checkConnection(params, _config) {
     const { Pool } = await import("pg");
     const pool = new Pool({
-      connectionString: params[parameters5.connectionUrl.slug],
+      connectionString: params[parameters9.connectionUrl.slug],
       ssl: { rejectUnauthorized: false },
       connectionTimeoutMillis: 1e4
     });
@@ -874,7 +891,7 @@ var postgresqlConnector = new ConnectorPlugin({
     const { Pool } = await import("pg");
     const { text, values } = buildPositionalParams(sql, namedParams);
     const pool = new Pool({
-      connectionString: params[parameters5.connectionUrl.slug],
+      connectionString: params[parameters9.connectionUrl.slug],
       ssl: { rejectUnauthorized: false },
       connectionTimeoutMillis: 1e4,
       statement_timeout: 6e4
@@ -889,7 +906,7 @@ var postgresqlConnector = new ConnectorPlugin({
 });
 
 // src/connectors/mysql/parameters.ts
-var parameters6 = {
+var parameters10 = {
   connectionUrl: new ParameterDefinition({
     slug: "connection-url",
     name: "MySQL Connection URL",
@@ -946,7 +963,7 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
     let connectionUrl;
     try {
       const mysql = await import("mysql2/promise");
-      connectionUrl = parameters6.connectionUrl.getValue(connection);
+      connectionUrl = parameters10.connectionUrl.getValue(connection);
       const pool = mysql.createPool({
         uri: connectionUrl,
         connectTimeout: CONNECT_TIMEOUT_MS2
@@ -986,7 +1003,7 @@ var mysqlConnector = new ConnectorPlugin({
   name: "MySQL",
   description: "Connect to MySQL databases for relational data storage and querying.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6ghPFeGgl7uBs5NHH1a4L/512c9433beec5b595caa41f04921c1f9/logo-mysql-170x115.png",
-  parameters: parameters6,
+  parameters: parameters10,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## MySQL SQL Notes
 - Schema exploration:
@@ -997,7 +1014,7 @@ var mysqlConnector = new ConnectorPlugin({
   async checkConnection(params, _config) {
     const mysql = await import("mysql2/promise");
     const pool = mysql.createPool({
-      uri: params[parameters6.connectionUrl.slug],
+      uri: params[parameters10.connectionUrl.slug],
       connectTimeout: 1e4
     });
     try {
@@ -1013,7 +1030,7 @@ var mysqlConnector = new ConnectorPlugin({
     const mysql = await import("mysql2/promise");
     const { text, values } = buildQuestionmarkParams(sql, namedParams);
     const pool = mysql.createPool({
-      uri: params[parameters6.connectionUrl.slug],
+      uri: params[parameters10.connectionUrl.slug],
       connectTimeout: 1e4
     });
     try {
@@ -1034,7 +1051,7 @@ var mysqlConnector = new ConnectorPlugin({
 import { z as z5 } from "zod";
 
 // src/connectors/bigquery/parameters.ts
-var parameters7 = {
+var parameters11 = {
   serviceAccountKeyJsonBase64: new ParameterDefinition({
     slug: "service-account-key-json-base64",
     name: "Google Cloud Service Account JSON",
@@ -1091,7 +1108,7 @@ var listProjectsTool = new ConnectorTool({
       };
     }
     try {
-      const serviceAccountJsonBase64 = parameters7.serviceAccountKeyJsonBase64.getValue(connection);
+      const serviceAccountJsonBase64 = parameters11.serviceAccountKeyJsonBase64.getValue(connection);
       const credentials = JSON.parse(
         Buffer.from(serviceAccountJsonBase64, "base64").toString("utf-8")
       );
@@ -1129,14 +1146,16 @@ var bigquerySetup = new ConnectorSetup({
 1. \`${listProjectsToolName}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001\u30B5\u30FC\u30D3\u30B9\u30A2\u30AB\u30A6\u30F3\u30C8\u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGCP\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
 2. \`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
    - \`parameterSlug\`: \`"project-id"\`
-   - \`options\`: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3002\u5404 option \u306E \`label\` \u306F \`\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D (id: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID)\` \u306E\u5F62\u5F0F\u3001\`value\` \u306F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID
+   - \`options\`: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7 + \u30D1\u30D6\u30EA\u30C3\u30AF\u30C7\u30FC\u30BF\u306E\u56FA\u5B9A\u9078\u629E\u80A2\u3002\u5404 option \u306E \`label\` \u306F \`\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D (id: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID)\` \u306E\u5F62\u5F0F\u3001\`value\` \u306F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID\u3002**\u672B\u5C3E\u306B\u5FC5\u305A** \`{ value: "bigquery-public-data", label: "Public Data (id: bigquery-public-data)" }\` \u3092\u8FFD\u52A0\u3059\u308B\u3053\u3068
 3. \u30E6\u30FC\u30B6\u30FC\u304C\u9078\u629E\u3057\u305F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E \`label\` \u304C\u30E1\u30C3\u30BB\u30FC\u30B8\u3068\u3057\u3066\u5C4A\u304F\u306E\u3067\u3001\u30B9\u30C6\u30C3\u30D72\u306B\u9032\u3080
 
 #### \u30B9\u30C6\u30C3\u30D72: \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u9078\u629E
-1. \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` \u3092\u5B9F\u884C\u3057\u3066\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
-2. \u7D50\u679C\u306B\u5FDC\u3058\u3066\u5206\u5C90:
-   - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C2\u3064\u4EE5\u4E0A**: \`askUserQuestion\`\uFF08multiSelect: true\uFF09\u3067\u30E6\u30FC\u30B6\u30FC\u306B\u63D0\u793A\u3057\u3001\u4F7F\u7528\u3059\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u3092\u9078\u629E\u3055\u305B\u308B
-   - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C1\u3064\u3060\u3051**: askUserQuestion \u306F\u4F7F\u308F\u305A\u81EA\u52D5\u63A1\u7528\u3002\u300C\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8 X \u3092\u81EA\u52D5\u9078\u629E\u3057\u307E\u3057\u305F\u300D\u30681\u6587\u3060\u3051\u66F8\u304F
+- **\`bigquery-public-data\` \u304C\u9078\u629E\u3055\u308C\u305F\u5834\u5408**: \`INFORMATION_SCHEMA.SCHEMATA\` \u306F\u5B9F\u884C\u3057\u306A\u3044\u3002\`askUserQuestion\`\uFF08allowFreeText: true, options \u306A\u3057\uFF09\u3067\u30E6\u30FC\u30B6\u30FC\u306B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u540D\u3092\u76F4\u63A5\u5165\u529B\u3055\u305B\u308B
+- **\u305D\u308C\u4EE5\u5916\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8**:
+  1. \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` \u3092\u5B9F\u884C\u3057\u3066\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
+  2. \u7D50\u679C\u306B\u5FDC\u3058\u3066\u5206\u5C90:
+     - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C2\u3064\u4EE5\u4E0A**: \`askUserQuestion\`\uFF08multiSelect: true\uFF09\u3067\u30E6\u30FC\u30B6\u30FC\u306B\u63D0\u793A\u3057\u3001\u4F7F\u7528\u3059\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u3092\u9078\u629E\u3055\u305B\u308B
+     - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C1\u3064\u3060\u3051**: askUserQuestion \u306F\u4F7F\u308F\u305A\u81EA\u52D5\u63A1\u7528\u3002\u300C\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8 X \u3092\u81EA\u52D5\u9078\u629E\u3057\u307E\u3057\u305F\u300D\u30681\u6587\u3060\u3051\u66F8\u304F
 
 #### \u30B9\u30C6\u30C3\u30D73: \u30C6\u30FC\u30D6\u30EB\u9078\u629E
 3. \u9078\u629E\u3055\u308C\u305F\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306B\u5BFE\u3057\u3066 \`SELECT table_name FROM \\\`{project}.{dataset}.INFORMATION_SCHEMA.TABLES\\\`\` \u3092\u5B9F\u884C\u3057\u3066\u30C6\u30FC\u30D6\u30EB\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B\uFF08\u8907\u6570\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306E\u5834\u5408\u306F UNION ALL \u3067\u4E00\u62EC\u53D6\u5F97\uFF09
@@ -1166,14 +1185,16 @@ Follow these steps to set up the BigQuery connection.
 1. Call \`${listProjectsToolName}\` to get the list of GCP projects accessible with the service account credentials
 2. Call \`updateConnectionParameters\`:
    - \`parameterSlug\`: \`"project-id"\`
-   - \`options\`: The project list. Each option's \`label\` should be \`Project Name (id: project-id)\`, \`value\` should be the project ID
+   - \`options\`: The project list + a fixed public data option. Each option's \`label\` should be \`Project Name (id: project-id)\`, \`value\` should be the project ID. **Always append** \`{ value: "bigquery-public-data", label: "Public Data (id: bigquery-public-data)" }\` at the end
 3. The \`label\` of the user's selected project will arrive as a message. Proceed to Step 2
 
 #### Step 2: Dataset Selection
-1. Run \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` to get the list of datasets
-2. Branch based on results:
-   - **2 or more datasets**: Present them to the user via \`askUserQuestion\` (multiSelect: true) and let them select which datasets to use
-   - **Exactly 1 dataset**: Do NOT call askUserQuestion. Auto-select it. Just write "Auto-selected dataset X" in one sentence
+- **If \`bigquery-public-data\` was selected**: Do NOT run \`INFORMATION_SCHEMA.SCHEMATA\`. Use \`askUserQuestion\` (allowFreeText: true, no options) to ask the user to type the dataset name directly
+- **Otherwise**:
+  1. Run \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` to get the list of datasets
+  2. Branch based on results:
+     - **2 or more datasets**: Present them to the user via \`askUserQuestion\` (multiSelect: true) and let them select which datasets to use
+     - **Exactly 1 dataset**: Do NOT call askUserQuestion. Auto-select it. Just write "Auto-selected dataset X" in one sentence
 
 #### Step 3: Table Selection
 3. For the selected dataset(s), run \`SELECT table_name FROM \\\`{project}.{dataset}.INFORMATION_SCHEMA.TABLES\\\`\` to get the table list (use UNION ALL for multiple datasets)
@@ -1239,8 +1260,8 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
     );
     try {
       const { BigQuery } = await import("@google-cloud/bigquery");
-      const projectId = parameters7.projectId.getValue(connection);
-      const serviceAccountJsonBase64 = parameters7.serviceAccountKeyJsonBase64.getValue(connection);
+      const projectId = parameters11.projectId.getValue(connection);
+      const serviceAccountJsonBase64 = parameters11.serviceAccountKeyJsonBase64.getValue(connection);
       const credentials = JSON.parse(
         Buffer.from(serviceAccountJsonBase64, "base64").toString("utf-8")
       );
@@ -1270,7 +1291,7 @@ var bigqueryConnector = new ConnectorPlugin({
   name: "BigQuery",
   description: "Connect to Google BigQuery for data warehouse and analytics.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6nlehQyOmdbktG5hOYkYMr/6ca559140d5ddc7dadc5eac88858a563/bigquery.svg",
-  parameters: parameters7,
+  parameters: parameters11,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   setup: bigquerySetup,
   systemPrompt: `## BigQuery SQL Notes
@@ -1284,10 +1305,10 @@ var bigqueryConnector = new ConnectorPlugin({
   async checkConnection(params, _config) {
     const { BigQuery } = await import("@google-cloud/bigquery");
     const credentials = JSON.parse(
-      Buffer.from(params[parameters7.serviceAccountKeyJsonBase64.slug], "base64").toString("utf-8")
+      Buffer.from(params[parameters11.serviceAccountKeyJsonBase64.slug], "base64").toString("utf-8")
     );
     const bq = new BigQuery({
-      projectId: params[parameters7.projectId.slug],
+      projectId: params[parameters11.projectId.slug],
       credentials
     });
     try {
@@ -1302,10 +1323,10 @@ var bigqueryConnector = new ConnectorPlugin({
     const { BigQuery } = await import("@google-cloud/bigquery");
     const resolvedSql = replaceLiteralParams(sql, namedParams);
     const credentials = JSON.parse(
-      Buffer.from(params[parameters7.serviceAccountKeyJsonBase64.slug], "base64").toString("utf-8")
+      Buffer.from(params[parameters11.serviceAccountKeyJsonBase64.slug], "base64").toString("utf-8")
     );
     const bq = new BigQuery({
-      projectId: params[parameters7.projectId.slug],
+      projectId: params[parameters11.projectId.slug],
       credentials
     });
     const [job] = await bq.createQueryJob({ query: resolvedSql });
@@ -1434,14 +1455,16 @@ var bigquerySetup2 = new ConnectorSetup({
 1. \`${listProjectsToolName2}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001OAuth\u3067\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGCP\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
 2. \`updateConnectionParameters\` \u3092\u547C\u3073\u51FA\u3059:
    - \`parameterSlug\`: \`"project-id"\`
-   - \`options\`: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3002\u5404 option \u306E \`label\` \u306F \`\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D (id: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID)\` \u306E\u5F62\u5F0F\u3001\`value\` \u306F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID
+   - \`options\`: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7 + \u30D1\u30D6\u30EA\u30C3\u30AF\u30C7\u30FC\u30BF\u306E\u56FA\u5B9A\u9078\u629E\u80A2\u3002\u5404 option \u306E \`label\` \u306F \`\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u540D (id: \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID)\` \u306E\u5F62\u5F0F\u3001\`value\` \u306F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8ID\u3002**\u672B\u5C3E\u306B\u5FC5\u305A** \`{ value: "bigquery-public-data", label: "Public Data (id: bigquery-public-data)" }\` \u3092\u8FFD\u52A0\u3059\u308B\u3053\u3068
 3. \u30E6\u30FC\u30B6\u30FC\u304C\u9078\u629E\u3057\u305F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E \`label\` \u304C\u30E1\u30C3\u30BB\u30FC\u30B8\u3068\u3057\u3066\u5C4A\u304F\u306E\u3067\u3001\u30B9\u30C6\u30C3\u30D72\u306B\u9032\u3080
 
 #### \u30B9\u30C6\u30C3\u30D72: \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u9078\u629E
-1. \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` \u3092\u5B9F\u884C\u3057\u3066\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
-2. \u7D50\u679C\u306B\u5FDC\u3058\u3066\u5206\u5C90:
-   - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C2\u3064\u4EE5\u4E0A**: \`askUserQuestion\`\uFF08multiSelect: true\uFF09\u3067\u30E6\u30FC\u30B6\u30FC\u306B\u63D0\u793A\u3057\u3001\u4F7F\u7528\u3059\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u3092\u9078\u629E\u3055\u305B\u308B
-   - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C1\u3064\u3060\u3051**: askUserQuestion \u306F\u4F7F\u308F\u305A\u81EA\u52D5\u63A1\u7528\u3002\u300C\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8 X \u3092\u81EA\u52D5\u9078\u629E\u3057\u307E\u3057\u305F\u300D\u30681\u6587\u3060\u3051\u66F8\u304F
+- **\`bigquery-public-data\` \u304C\u9078\u629E\u3055\u308C\u305F\u5834\u5408**: \`INFORMATION_SCHEMA.SCHEMATA\` \u306F\u5B9F\u884C\u3057\u306A\u3044\u3002\`askUserQuestion\`\uFF08allowFreeText: true, options \u306A\u3057\uFF09\u3067\u30E6\u30FC\u30B6\u30FC\u306B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u540D\u3092\u76F4\u63A5\u5165\u529B\u3055\u305B\u308B
+- **\u305D\u308C\u4EE5\u5916\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8**:
+  1. \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` \u3092\u5B9F\u884C\u3057\u3066\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
+  2. \u7D50\u679C\u306B\u5FDC\u3058\u3066\u5206\u5C90:
+     - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C2\u3064\u4EE5\u4E0A**: \`askUserQuestion\`\uFF08multiSelect: true\uFF09\u3067\u30E6\u30FC\u30B6\u30FC\u306B\u63D0\u793A\u3057\u3001\u4F7F\u7528\u3059\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u3092\u9078\u629E\u3055\u305B\u308B
+     - **\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u304C1\u3064\u3060\u3051**: askUserQuestion \u306F\u4F7F\u308F\u305A\u81EA\u52D5\u63A1\u7528\u3002\u300C\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8 X \u3092\u81EA\u52D5\u9078\u629E\u3057\u307E\u3057\u305F\u300D\u30681\u6587\u3060\u3051\u66F8\u304F
 
 #### \u30B9\u30C6\u30C3\u30D73: \u30C6\u30FC\u30D6\u30EB\u9078\u629E
 3. \u9078\u629E\u3055\u308C\u305F\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306B\u5BFE\u3057\u3066 \`SELECT table_name FROM \\\`{project}.{dataset}.INFORMATION_SCHEMA.TABLES\\\`\` \u3092\u5B9F\u884C\u3057\u3066\u30C6\u30FC\u30D6\u30EB\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B\uFF08\u8907\u6570\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306E\u5834\u5408\u306F UNION ALL \u3067\u4E00\u62EC\u53D6\u5F97\uFF09
@@ -1471,14 +1494,16 @@ Follow these steps to set up the BigQuery connection.
 1. Call \`${listProjectsToolName2}\` to get the list of GCP projects accessible with the OAuth credentials
 2. Call \`updateConnectionParameters\`:
    - \`parameterSlug\`: \`"project-id"\`
-   - \`options\`: The project list. Each option's \`label\` should be \`Project Name (id: project-id)\`, \`value\` should be the project ID
+   - \`options\`: The project list + a fixed public data option. Each option's \`label\` should be \`Project Name (id: project-id)\`, \`value\` should be the project ID. **Always append** \`{ value: "bigquery-public-data", label: "Public Data (id: bigquery-public-data)" }\` at the end
 3. The \`label\` of the user's selected project will arrive as a message. Proceed to Step 2
 
 #### Step 2: Dataset Selection
-1. Run \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` to get the list of datasets
-2. Branch based on results:
-   - **2 or more datasets**: Present them to the user via \`askUserQuestion\` (multiSelect: true) and let them select which datasets to use
-   - **Exactly 1 dataset**: Do NOT call askUserQuestion. Auto-select it. Just write "Auto-selected dataset X" in one sentence
+- **If \`bigquery-public-data\` was selected**: Do NOT run \`INFORMATION_SCHEMA.SCHEMATA\`. Use \`askUserQuestion\` (allowFreeText: true, no options) to ask the user to type the dataset name directly
+- **Otherwise**:
+  1. Run \`SELECT schema_name FROM INFORMATION_SCHEMA.SCHEMATA\` to get the list of datasets
+  2. Branch based on results:
+     - **2 or more datasets**: Present them to the user via \`askUserQuestion\` (multiSelect: true) and let them select which datasets to use
+     - **Exactly 1 dataset**: Do NOT call askUserQuestion. Auto-select it. Just write "Auto-selected dataset X" in one sentence
 
 #### Step 3: Table Selection
 3. For the selected dataset(s), run \`SELECT table_name FROM \\\`{project}.{dataset}.INFORMATION_SCHEMA.TABLES\\\`\` to get the table list (use UNION ALL for multiple datasets)
@@ -1501,7 +1526,7 @@ Follow these steps to set up the BigQuery connection.
 });
 
 // src/connectors/bigquery-oauth/parameters.ts
-var parameters8 = {
+var parameters12 = {
   projectId: new ParameterDefinition({
     slug: "project-id",
     name: "Google Cloud Project ID",
@@ -1595,7 +1620,7 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
         error: `Connection ${connectionId} not found`
       };
     }
-    const gcpProjectId = parameters8.projectId.getValue(connection);
+    const gcpProjectId = parameters12.projectId.getValue(connection);
     console.log(
       `[connector-query] bigquery-oauth/${connection.name}: ${sql}`
     );
@@ -1662,7 +1687,7 @@ var bigqueryOauthConnector = new ConnectorPlugin({
   name: "BigQuery (OAuth)",
   description: "Connect to Google BigQuery for data warehouse and analytics using OAuth.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6nlehQyOmdbktG5hOYkYMr/6ca559140d5ddc7dadc5eac88858a563/bigquery.svg",
-  parameters: parameters8,
+  parameters: parameters12,
   releaseFlag: { dev1: true, dev2: false, prod: false },
   setup: bigquerySetup2,
   proxyPolicy: {
@@ -1681,7 +1706,7 @@ var bigqueryOauthConnector = new ConnectorPlugin({
   tools: tools6,
   async checkConnection(params, config) {
     const { proxyFetch } = config;
-    const projectId = params[parameters8.projectId.slug];
+    const projectId = params[parameters12.projectId.slug];
     const url = `https://bigquery.googleapis.com/bigquery/v2/projects/${projectId}/queries`;
     try {
       const res = await proxyFetch(url, {
@@ -1700,7 +1725,7 @@ var bigqueryOauthConnector = new ConnectorPlugin({
   },
   async query(params, sql, namedParams, context) {
     const { proxyFetch } = context;
-    const projectId = params[parameters8.projectId.slug];
+    const projectId = params[parameters12.projectId.slug];
     const resolvedSql = replaceLiteralParams(sql, namedParams);
     const url = `https://bigquery.googleapis.com/bigquery/v2/projects/${projectId}/queries`;
     const res = await proxyFetch(url, {
@@ -1718,7 +1743,7 @@ var bigqueryOauthConnector = new ConnectorPlugin({
 });
 
 // src/connectors/aws-athena/parameters.ts
-var parameters9 = {
+var parameters13 = {
   awsAccessKeyId: new ParameterDefinition({
     slug: "aws-access-key-id",
     name: "AWS Access Key ID",
@@ -1815,8 +1840,8 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
         GetQueryExecutionCommand,
         GetQueryResultsCommand
       } = await import("@aws-sdk/client-athena");
-      const workgroup = parameters9.workgroup.tryGetValue(connection);
-      const outputLocation = parameters9.outputLocation.tryGetValue(connection);
+      const workgroup = parameters13.workgroup.tryGetValue(connection);
+      const outputLocation = parameters13.outputLocation.tryGetValue(connection);
       if (!workgroup && !outputLocation) {
         return {
           success: false,
@@ -1824,10 +1849,10 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
         };
       }
       const client = new AthenaClient({
-        region: parameters9.awsRegion.getValue(connection),
+        region: parameters13.awsRegion.getValue(connection),
         credentials: {
-          accessKeyId: parameters9.awsAccessKeyId.getValue(connection),
-          secretAccessKey: parameters9.awsSecretAccessKey.getValue(connection)
+          accessKeyId: parameters13.awsAccessKeyId.getValue(connection),
+          secretAccessKey: parameters13.awsSecretAccessKey.getValue(connection)
         }
       });
       const startParams = { QueryString: sql };
@@ -1891,7 +1916,7 @@ var awsAthenaConnector = new ConnectorPlugin({
   name: "AWS Athena",
   description: "Connect to AWS Athena for serverless SQL queries on S3 data.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/5x0vIHtUHfJJMZUv4RFOYZ/5059bac389f0169542f39cdb4b387d2c/Athena.svg",
-  parameters: parameters9,
+  parameters: parameters13,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## AWS Athena SQL Notes
 - Uses Presto/Trino based SQL syntax
@@ -1909,8 +1934,8 @@ var awsAthenaConnector = new ConnectorPlugin({
         StartQueryExecutionCommand,
         GetQueryExecutionCommand
       } = await import("@aws-sdk/client-athena");
-      const workgroup = params[parameters9.workgroup.slug];
-      const outputLocation = params[parameters9.outputLocation.slug];
+      const workgroup = params[parameters13.workgroup.slug];
+      const outputLocation = params[parameters13.outputLocation.slug];
       if (!workgroup && !outputLocation) {
         return {
           success: false,
@@ -1918,10 +1943,10 @@ var awsAthenaConnector = new ConnectorPlugin({
         };
       }
       const client = new AthenaClient({
-        region: params[parameters9.awsRegion.slug],
+        region: params[parameters13.awsRegion.slug],
         credentials: {
-          accessKeyId: params[parameters9.awsAccessKeyId.slug],
-          secretAccessKey: params[parameters9.awsSecretAccessKey.slug]
+          accessKeyId: params[parameters13.awsAccessKeyId.slug],
+          secretAccessKey: params[parameters13.awsSecretAccessKey.slug]
         }
       });
       const startParams = { QueryString: "SELECT 1" };
@@ -1966,16 +1991,16 @@ var awsAthenaConnector = new ConnectorPlugin({
       GetQueryResultsCommand
     } = await import("@aws-sdk/client-athena");
     const resolvedSql = replaceLiteralParams(sql, namedParams);
-    const workgroup = params[parameters9.workgroup.slug];
-    const outputLocation = params[parameters9.outputLocation.slug];
+    const workgroup = params[parameters13.workgroup.slug];
+    const outputLocation = params[parameters13.outputLocation.slug];
     if (!workgroup && !outputLocation) {
       throw new Error("Either workgroup or output-location is required");
     }
     const client = new AthenaClient({
-      region: params[parameters9.awsRegion.slug],
+      region: params[parameters13.awsRegion.slug],
       credentials: {
-        accessKeyId: params[parameters9.awsAccessKeyId.slug],
-        secretAccessKey: params[parameters9.awsSecretAccessKey.slug]
+        accessKeyId: params[parameters13.awsAccessKeyId.slug],
+        secretAccessKey: params[parameters13.awsSecretAccessKey.slug]
       }
     });
     const startParams = { QueryString: resolvedSql };
@@ -2020,7 +2045,7 @@ var awsAthenaConnector = new ConnectorPlugin({
 });
 
 // src/connectors/redshift/parameters.ts
-var parameters10 = {
+var parameters14 = {
   awsAccessKeyId: new ParameterDefinition({
     slug: "aws-access-key-id",
     name: "AWS Access Key ID",
@@ -2146,14 +2171,14 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
         DescribeStatementCommand,
         GetStatementResultCommand
       } = await import("@aws-sdk/client-redshift-data");
-      const awsAccessKeyId = parameters10.awsAccessKeyId.getValue(connection);
-      const awsSecretAccessKey = parameters10.awsSecretAccessKey.getValue(connection);
-      const awsRegion = parameters10.awsRegion.getValue(connection);
-      const database = parameters10.database.getValue(connection);
-      const clusterIdentifier = parameters10.clusterIdentifier.tryGetValue(connection);
-      const workgroupName = parameters10.workgroupName.tryGetValue(connection);
-      const secretArn = parameters10.secretArn.tryGetValue(connection);
-      const dbUser = parameters10.dbUser.tryGetValue(connection);
+      const awsAccessKeyId = parameters14.awsAccessKeyId.getValue(connection);
+      const awsSecretAccessKey = parameters14.awsSecretAccessKey.getValue(connection);
+      const awsRegion = parameters14.awsRegion.getValue(connection);
+      const database = parameters14.database.getValue(connection);
+      const clusterIdentifier = parameters14.clusterIdentifier.tryGetValue(connection);
+      const workgroupName = parameters14.workgroupName.tryGetValue(connection);
+      const secretArn = parameters14.secretArn.tryGetValue(connection);
+      const dbUser = parameters14.dbUser.tryGetValue(connection);
       if (!clusterIdentifier && !workgroupName) {
         return {
           success: false,
@@ -2224,7 +2249,7 @@ var redshiftConnector = new ConnectorPlugin({
   name: "Redshift",
   description: "Connect to Amazon Redshift for data warehouse analytics.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/AEwW2psmrnZ7htTVsgA9t/a637e31707c5d760be73ce1d8ec75580/aws-redshift-logo.svg",
-  parameters: parameters10,
+  parameters: parameters14,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## Redshift SQL Notes
 - Uses PostgreSQL based SQL syntax
@@ -2242,10 +2267,10 @@ var redshiftConnector = new ConnectorPlugin({
         ExecuteStatementCommand,
         DescribeStatementCommand
       } = await import("@aws-sdk/client-redshift-data");
-      const clusterIdentifier = params[parameters10.clusterIdentifier.slug];
-      const workgroupName = params[parameters10.workgroupName.slug];
-      const secretArn = params[parameters10.secretArn.slug];
-      const dbUser = params[parameters10.dbUser.slug];
+      const clusterIdentifier = params[parameters14.clusterIdentifier.slug];
+      const workgroupName = params[parameters14.workgroupName.slug];
+      const secretArn = params[parameters14.secretArn.slug];
+      const dbUser = params[parameters14.dbUser.slug];
       if (!clusterIdentifier && !workgroupName) {
         return {
           success: false,
@@ -2253,15 +2278,15 @@ var redshiftConnector = new ConnectorPlugin({
         };
       }
       const client = new RedshiftDataClient({
-        region: params[parameters10.awsRegion.slug],
+        region: params[parameters14.awsRegion.slug],
         credentials: {
-          accessKeyId: params[parameters10.awsAccessKeyId.slug],
-          secretAccessKey: params[parameters10.awsSecretAccessKey.slug]
+          accessKeyId: params[parameters14.awsAccessKeyId.slug],
+          secretAccessKey: params[parameters14.awsSecretAccessKey.slug]
         }
       });
       const { Id: statementId } = await client.send(
         new ExecuteStatementCommand({
-          Database: params[parameters10.database.slug],
+          Database: params[parameters14.database.slug],
           Sql: "SELECT 1",
           ...clusterIdentifier && { ClusterIdentifier: clusterIdentifier },
           ...workgroupName && { WorkgroupName: workgroupName },
@@ -2302,23 +2327,23 @@ var redshiftConnector = new ConnectorPlugin({
       GetStatementResultCommand
     } = await import("@aws-sdk/client-redshift-data");
     const resolvedSql = replaceLiteralParams(sql, namedParams);
-    const clusterIdentifier = params[parameters10.clusterIdentifier.slug];
-    const workgroupName = params[parameters10.workgroupName.slug];
-    const secretArn = params[parameters10.secretArn.slug];
-    const dbUser = params[parameters10.dbUser.slug];
+    const clusterIdentifier = params[parameters14.clusterIdentifier.slug];
+    const workgroupName = params[parameters14.workgroupName.slug];
+    const secretArn = params[parameters14.secretArn.slug];
+    const dbUser = params[parameters14.dbUser.slug];
     if (!clusterIdentifier && !workgroupName) {
       throw new Error("Either cluster-identifier or workgroup-name is required");
     }
     const client = new RedshiftDataClient({
-      region: params[parameters10.awsRegion.slug],
+      region: params[parameters14.awsRegion.slug],
       credentials: {
-        accessKeyId: params[parameters10.awsAccessKeyId.slug],
-        secretAccessKey: params[parameters10.awsSecretAccessKey.slug]
+        accessKeyId: params[parameters14.awsAccessKeyId.slug],
+        secretAccessKey: params[parameters14.awsSecretAccessKey.slug]
       }
     });
     const { Id: statementId } = await client.send(
       new ExecuteStatementCommand({
-        Database: params[parameters10.database.slug],
+        Database: params[parameters14.database.slug],
         Sql: resolvedSql,
         ...clusterIdentifier && { ClusterIdentifier: clusterIdentifier },
         ...workgroupName && { WorkgroupName: workgroupName },
@@ -2356,7 +2381,7 @@ var redshiftConnector = new ConnectorPlugin({
 });
 
 // src/connectors/databricks/parameters.ts
-var parameters11 = {
+var parameters15 = {
   host: new ParameterDefinition({
     slug: "host",
     name: "Databricks Workspace Host",
@@ -2428,9 +2453,9 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
     );
     try {
       const { DBSQLClient } = await import("@databricks/sql");
-      const host = parameters11.host.getValue(connection);
-      const token = parameters11.token.getValue(connection);
-      const httpPath = parameters11.httpPath.getValue(connection);
+      const host = parameters15.host.getValue(connection);
+      const token = parameters15.token.getValue(connection);
+      const httpPath = parameters15.httpPath.getValue(connection);
       const client = new DBSQLClient();
       await client.connect({ host, path: httpPath, token });
       let session;
@@ -2471,7 +2496,7 @@ var databricksConnector = new ConnectorPlugin({
   name: "Databricks",
   description: "Connect to Databricks for data lakehouse and SQL analytics.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6QgcrfpQOKg18P7DdgKerd/af55bf0d871339049824dd167b97a29f/databricks-icon.svg",
-  parameters: parameters11,
+  parameters: parameters15,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## Databricks SQL Notes
 - Uses Spark SQL / Databricks SQL syntax
@@ -2486,9 +2511,9 @@ var databricksConnector = new ConnectorPlugin({
     const { DBSQLClient } = await import("@databricks/sql");
     const client = new DBSQLClient();
     await client.connect({
-      host: params[parameters11.host.slug],
-      path: params[parameters11.httpPath.slug],
-      token: params[parameters11.token.slug]
+      host: params[parameters15.host.slug],
+      path: params[parameters15.httpPath.slug],
+      token: params[parameters15.token.slug]
     });
     let session;
     let operation;
@@ -2515,9 +2540,9 @@ var databricksConnector = new ConnectorPlugin({
     const resolvedSql = replaceLiteralParams(sql, namedParams);
     const client = new DBSQLClient();
     await client.connect({
-      host: params[parameters11.host.slug],
-      path: params[parameters11.httpPath.slug],
-      token: params[parameters11.token.slug]
+      host: params[parameters15.host.slug],
+      path: params[parameters15.httpPath.slug],
+      token: params[parameters15.token.slug]
     });
     let session;
     let operation;
@@ -2539,28 +2564,6 @@ var databricksConnector = new ConnectorPlugin({
   }
 });
 
-// src/connectors/airtable/parameters.ts
-var parameters12 = {
-  baseId: new ParameterDefinition({
-    slug: "base-id",
-    name: "Airtable Base ID",
-    description: "The Airtable Base ID (e.g., appXXXXXXXXXXXXXX).",
-    envVarBaseKey: "AIRTABLE_BASE_ID",
-    type: "text",
-    secret: false,
-    required: true
-  }),
-  apiKey: new ParameterDefinition({
-    slug: "api-key",
-    name: "Airtable API Key",
-    description: "The Airtable API key or Personal Access Token for authentication. Required scopes: schema.bases:read, data.records:read.",
-    envVarBaseKey: "AIRTABLE_API_KEY",
-    type: "text",
-    secret: true,
-    required: true
-  })
-};
-
 // src/connectors/airtable/tools/request.ts
 import { z as z12 } from "zod";
 var BASE_URL = "https://api.airtable.com/v0/";
@@ -2597,8 +2600,8 @@ Authentication is handled automatically using the API Key.
     }
     console.log(`[connector-request] airtable/${connection.name}: ${method} ${path}`);
     try {
-      const apiKey = parameters12.apiKey.getValue(connection);
-      const baseId = parameters12.baseId.getValue(connection);
+      const apiKey = parameters.apiKey.getValue(connection);
+      const baseId = parameters.baseId.getValue(connection);
       const resolvedPath = path.replace(/\{baseId\}/g, baseId);
       const url = `${BASE_URL}${resolvedPath}`;
       const controller = new AbortController();
@@ -2640,7 +2643,7 @@ var airtableConnector = new ConnectorPlugin({
   name: "Airtable",
   description: "Connect to Airtable for spreadsheet-database hybrid data management.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/19JUphfOZjyjTK6Zg4NGCf/8c56227b088cada52d3a2d9385a3be97/airtable.svg",
-  parameters: parameters12,
+  parameters,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## Airtable API
 - Call the Airtable REST API using the authenticated request tool
@@ -2659,32 +2662,39 @@ var airtableConnector = new ConnectorPlugin({
 - Body: { "records": [{ "fields": { "Name": "value", ... } }] }
 
 ### Pagination
-- If the response contains an offset, fetch the next page by appending ?offset={offset} to the next request`,
+- If the response contains an offset, fetch the next page by appending ?offset={offset} to the next request
+
+## Airtable SDK (TypeScript handler)
+Non-SQL connectors like Airtable can also be used via the SDK in TypeScript handlers:
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/airtable";
+
+const airtable = connection("<connectionId>");
+
+// Authenticated fetch (returns standard Response)
+const res = await airtable.request("meta/bases/{baseId}/tables");
+const data = await res.json();
+
+// Convenience methods
+const { tables } = await airtable.listTables();
+const { records, offset } = await airtable.listRecords("Tasks", {
+  filterByFormula: '{Status} = "Done"',
+  fields: ["Name", "Status"],
+  maxRecords: 100,
+  sort: [{ field: "Name", direction: "asc" }],
+});
+const record = await airtable.getRecord("Tasks", "recXXXXXX");
+await airtable.createRecords("Tasks", [
+  { fields: { Name: "New task", Status: "Todo" } },
+]);
+await airtable.updateRecords("Tasks", [
+  { id: "recXXXXXX", fields: { Status: "Done" } },
+]);
+\`\`\``,
   tools: tools10
 });
 
-// src/connectors/google-analytics/parameters.ts
-var parameters13 = {
-  serviceAccountKeyJsonBase64: new ParameterDefinition({
-    slug: "service-account-key-json-base64",
-    name: "Google Cloud Service Account JSON",
-    description: "The service account JSON key used to authenticate with Google Cloud Platform. Ensure that the service account has the necessary permissions to access Google Analytics.",
-    envVarBaseKey: "GA_SERVICE_ACCOUNT_JSON_BASE64",
-    type: "base64EncodedJson",
-    secret: true,
-    required: true
-  }),
-  propertyId: new ParameterDefinition({
-    slug: "property-id",
-    name: "Google Analytics Property ID",
-    description: "The Google Analytics 4 property ID (e.g., 123456789).",
-    envVarBaseKey: "GA_PROPERTY_ID",
-    type: "text",
-    secret: false,
-    required: true
-  })
-};
-
 // src/connectors/google-analytics/tools/request.ts
 import { z as z13 } from "zod";
 var BASE_URL2 = "https://analyticsdata.googleapis.com/v1beta/";
@@ -2722,8 +2732,8 @@ Authentication is handled automatically using a service account.
     console.log(`[connector-request] google-analytics/${connection.name}: ${method} ${path}`);
     try {
       const { GoogleAuth } = await import("google-auth-library");
-      const keyJsonBase64 = parameters13.serviceAccountKeyJsonBase64.getValue(connection);
-      const propertyId = parameters13.propertyId.getValue(connection);
+      const keyJsonBase64 = parameters2.serviceAccountKeyJsonBase64.getValue(connection);
+      const propertyId = parameters2.propertyId.getValue(connection);
       const credentials = JSON.parse(
         Buffer.from(keyJsonBase64, "base64").toString("utf-8")
       );
@@ -2776,7 +2786,7 @@ var googleAnalyticsConnector = new ConnectorPlugin({
   name: "Google Analytics",
   description: "Connect to Google Analytics for web analytics and reporting.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/7fs0ipzxuD9mACDzBATtxX/3c53ed90d15c96483e4f78cb29dab5e9/google-analytics.svg",
-  parameters: parameters13,
+  parameters: parameters2,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## Google Analytics Data API
 - Call the GA4 Data API using the authenticated request tool
@@ -2805,7 +2815,36 @@ averageSessionDuration, conversions, totalRevenue
 
 ### Date Specification
 - Absolute: "2024-01-01"
-- Relative: "today", "yesterday", "7daysAgo", "30daysAgo"`,
+- Relative: "today", "yesterday", "7daysAgo", "30daysAgo"
+
+## Google Analytics SDK (TypeScript handler)
+Non-SQL connectors like Google Analytics can also be used via the SDK in TypeScript handlers:
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/google-analytics";
+
+const ga = connection("<connectionId>");
+
+// Authenticated fetch (returns standard Response)
+const res = await ga.request("properties/{propertyId}:runReport", {
+  method: "POST",
+  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
+});
+const data = await res.json();
+
+// Convenience methods
+const { rows, rowCount } = await ga.runReport({
+  dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
+  dimensions: [{ name: "date" }],
+  metrics: [{ name: "activeUsers" }, { name: "sessions" }],
+  limit: 100,
+});
+const metadata = await ga.getMetadata();
+const realtime = await ga.runRealtimeReport({
+  metrics: [{ name: "activeUsers" }],
+  dimensions: [{ name: "country" }],
+});
+\`\`\``,
   tools: tools11
 });
 
@@ -2843,9 +2882,9 @@ Authentication is handled automatically using username and password.`,
     }
     console.log(`[connector-request] kintone/${connection.name}: ${method} ${path}`);
     try {
-      const baseUrl = parameters.baseUrl.getValue(connection);
-      const username = parameters.username.getValue(connection);
-      const password = parameters.password.getValue(connection);
+      const baseUrl = parameters3.baseUrl.getValue(connection);
+      const username = parameters3.username.getValue(connection);
+      const password = parameters3.password.getValue(connection);
       const authToken = Buffer.from(`${username}:${password}`).toString("base64");
       const url = `${baseUrl.replace(/\/+$/, "")}/k/v1/${path}`;
       const controller = new AbortController();
@@ -2889,7 +2928,7 @@ var kintoneConnector = new ConnectorPlugin({
   name: "kintone",
   description: "Connect to kintone for business application data retrieval and analytics.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/76nPGMJFZkMFE3UQNo2JFy/e71dc5f5d5cec1306ce0e17aafbfd9f0/kintone.png",
-  parameters,
+  parameters: parameters3,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## kintone REST API
 - Call the kintone REST API using the authenticated request tool
@@ -2945,37 +2984,6 @@ const { apps } = await kintone.listApps();
   tools: tools12
 });
 
-// src/connectors/wix-store/parameters.ts
-var parameters14 = {
-  accountId: new ParameterDefinition({
-    slug: "account-id",
-    name: "Account ID",
-    description: "Account ID",
-    envVarBaseKey: "WIX_ACCOUNT_ID",
-    type: "text",
-    secret: false,
-    required: true
-  }),
-  siteId: new ParameterDefinition({
-    slug: "site-id",
-    name: "Site ID",
-    description: "Site ID for Wix Store Project",
-    envVarBaseKey: "WIX_SITE_ID",
-    type: "text",
-    secret: false,
-    required: true
-  }),
-  apiKey: new ParameterDefinition({
-    slug: "api-key",
-    name: "API Key",
-    description: "API Key to access the Wix store project",
-    envVarBaseKey: "WIX_API_KEY",
-    type: "text",
-    secret: true,
-    required: true
-  })
-};
-
 // src/connectors/wix-store/tools/request.ts
 import { z as z15 } from "zod";
 var BASE_URL3 = "https://www.wixapis.com/";
@@ -3011,8 +3019,8 @@ Authentication is handled automatically using the API Key and Site ID.`,
     }
     console.log(`[connector-request] wix-store/${connection.name}: ${method} ${path}`);
     try {
-      const apiKey = parameters14.apiKey.getValue(connection);
-      const siteId = parameters14.siteId.getValue(connection);
+      const apiKey = parameters4.apiKey.getValue(connection);
+      const siteId = parameters4.siteId.getValue(connection);
       const url = `${BASE_URL3}${path}`;
       const controller = new AbortController();
       const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS6);
@@ -3054,12 +3062,14 @@ var wixStoreConnector = new ConnectorPlugin({
   name: "Wix Store",
   description: "Connect to Wix Store.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/YyFxclQFzROIYpFam6vRK/e7e75d3feac49a1cc5e433c147216d23/Wix_logo_black.svg",
-  parameters: parameters14,
+  parameters: parameters4,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## Wix Store API
 - Call the Wix Store REST API using the authenticated request tool
 - Authentication (API Key, Site ID) is automatically configured
 - Wix API uses POST for query endpoints as well
+- Wix uses WQL (Wix Query Language) for filters
+- Max 100 items per page
 
 ### List Products
 - POST stores/v1/products/query
@@ -3069,55 +3079,46 @@ var wixStoreConnector = new ConnectorPlugin({
 - POST stores/v1/products/query
 - Body: { "query": { "filter": { "name": { "$contains": "keyword" } }, "paging": { "limit": 50 } } }
 
-### List Orders
-- POST stores/v2/orders/query
-- Body: { "query": { "paging": { "limit": 50 } } }
+### Search Orders (eCommerce Orders V1)
+- POST ecom/v1/orders/search
+- Body: { "search": { "cursorPaging": { "limit": 50 } } }
+- Uses cursor-based pagination (cursorPaging, not paging)
+- Response includes pagingMetadata.cursors.next for pagination
 
 ### List Collections (Categories)
 - POST stores/v1/collections/query
-- Body: { "query": { "paging": { "limit": 50 } } }`,
-  tools: tools13
+- Body: { "query": { "paging": { "limit": 50 } } }
+
+### List Inventory Items
+- POST stores/v2/inventoryItems/query
+- Body: { "query": { "paging": { "limit": 50 } } }
+
+## Wix Store SDK (TypeScript handler)
+Non-SQL connectors like Wix Store can also be used via the SDK in TypeScript handlers:
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/wix-store";
+
+const wix = connection("<connectionId>");
+
+// Authenticated fetch (returns standard Response)
+const res = await wix.request("/stores/v1/products/query", {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({ query: { paging: { limit: 10 } } }),
 });
+const data = await res.json();
 
-// src/connectors/dbt/parameters.ts
-var parameters15 = {
-  host: new ParameterDefinition({
-    slug: "host",
-    name: "dbt Cloud Host",
-    description: "The dbt Cloud host URL (e.g., cloud.getdbt.com).",
-    envVarBaseKey: "DBT_HOST",
-    type: "text",
-    secret: false,
-    required: true
-  }),
-  accountId: new ParameterDefinition({
-    slug: "account-id",
-    name: "dbt Account ID",
-    description: "The dbt Cloud account ID.",
-    envVarBaseKey: "DBT_ACCOUNT_ID",
-    type: "text",
-    secret: false,
-    required: true
-  }),
-  prodEnvId: new ParameterDefinition({
-    slug: "prod-env-id",
-    name: "dbt Production Environment ID",
-    description: "The dbt Cloud production environment ID.",
-    envVarBaseKey: "DBT_PROD_ENV_ID",
-    type: "text",
-    secret: false,
-    required: true
-  }),
-  token: new ParameterDefinition({
-    slug: "token",
-    name: "dbt API Token",
-    description: "The API token for authenticating with dbt Cloud.",
-    envVarBaseKey: "DBT_TOKEN",
-    type: "text",
-    secret: true,
-    required: true
-  })
-};
+// Convenience methods
+const { products, totalResults } = await wix.queryProducts({ paging: { limit: 50 } });
+const { product } = await wix.getProduct("product-id");
+const { orders, pagingMetadata } = await wix.queryOrders({ cursorPaging: { limit: 50 } });
+const { order } = await wix.getOrder("order-id");
+const { inventoryItems } = await wix.queryInventory({ paging: { limit: 50 } });
+const { collections } = await wix.queryCollections({ paging: { limit: 50 } });
+\`\`\``,
+  tools: tools13
+});
 
 // src/connectors/dbt/tools/request.ts
 import { z as z16 } from "zod";
@@ -3157,9 +3158,9 @@ Authentication is handled automatically using the API token.
     }
     console.log(`[connector-request] dbt/${connection.name}: GraphQL query`);
     try {
-      const host = parameters15.host.getValue(connection);
-      const token = parameters15.token.getValue(connection);
-      const environmentId = parameters15.prodEnvId.getValue(connection);
+      const host = parameters5.host.getValue(connection);
+      const token = parameters5.token.getValue(connection);
+      const environmentId = parameters5.prodEnvId.getValue(connection);
       const resolvedVariables = variables ? JSON.parse(
         JSON.stringify(variables).replace(/\{environmentId\}/g, environmentId)
       ) : void 0;
@@ -3209,7 +3210,7 @@ var dbtConnector = new ConnectorPlugin({
   name: "dbt",
   description: "Connect to dbt Cloud for data transformation and analytics engineering.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/4iT6ncXtdtHdkXexU0WgfZ/0367a38d245f2568eab5eb511f9ee692/dbt.png",
-  parameters: parameters15,
+  parameters: parameters5,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   systemPrompt: `## dbt Cloud Discovery API (GraphQL)
 - Call the dbt Cloud Discovery API using the authenticated request tool
@@ -3261,7 +3262,36 @@ query:
 
 ### Lineage (Dependencies)
 - Traverse relationships using ancestors / children fields
-- Get ancestors { uniqueId name } or children { uniqueId name } within node`,
+- Get ancestors { uniqueId name } or children { uniqueId name } within node
+
+## dbt SDK (TypeScript handler)
+Non-SQL connectors like dbt can also be used via the SDK in TypeScript handlers:
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/dbt";
+
+const dbt = connection("<connectionId>");
+
+// Authenticated fetch (returns standard Response)
+const res = await dbt.request("/graphql", {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({ query: "{ ... }", variables: {} }),
+});
+const data = await res.json();
+
+// Convenience methods
+const result = await dbt.query(\`
+  query($environmentId: BigInt!) {
+    environment(id: $environmentId) { applied { models(first: 10) { edges { node { name } } } } }
+  }
+\`);
+const models = await dbt.getModels({ limit: 100 });
+const model = await dbt.getModelByUniqueId("model.project.my_model");
+const sources = await dbt.getSources({ limit: 100 });
+const tests = await dbt.getTests({ limit: 100 });
+const metrics = await dbt.getMetrics({ limit: 100 });
+\`\`\``,
   tools: tools14
 });
 
@@ -3412,7 +3442,7 @@ var openaiConnector = new ConnectorPlugin({
   name: "OpenAI",
   description: "Connect to OpenAI for AI model inference, embeddings, and image generation.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/53XJtCgUlW10x6i1X8xpxM/0bfd634069f1d74241296543cb20427a/openai.svg",
-  parameters: parameters2,
+  parameters: parameters6,
   releaseFlag: { dev1: true, dev2: false, prod: false },
   systemPrompt: `## OpenAI SDK (TypeScript handler)
 Use the OpenAI connector via the SDK in TypeScript handlers: